feat: troncature annoncee et lecture par fenetres des tableurs #153

- BUG-090 (#153 A8) : render_sheets() expose total_rows/total_cols,
  max_rows/max_cols et truncated ; la visionneuse affiche un bandeau
  « Feuille tronquée » (i18n FR/EN) au lieu de couper en silence, et la
  ligne d'en-têtes devient sticky (top:auto sur les numéros de ligne).
- #153 A9 : GET /api/file/{vault}/xlsx/sheet?sheet&offset&limit sert une
  fenêtre de 1 à 1000 lignes avec les vraies coordonnées A1, has_more de
  pagination et valeurs calculées A12 ; 404 feuille inconnue, 415 non-xlsx.
- Tests : TestXlsxTruncationNotice (4) + TestXlsxSheetWindow (11) avec
  contre-preuves, xlsx-viewer.test.mjs 14/14, E2E 7/7 (fixture
  sample-xlsx-large.xlsx 520 lignes), suite 1417 passed / 6 skipped,
  ruff/mypy 0, i18n parity.

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <[email protected]>

docs/GUIDES/RECHERCHE_PDF_EXCALIDRAW.md

@@ -171,13 +171,36 @@ curl -X PUT "http://localhost:2020/api/file/Recettes/xlsx/save?path=budget.xlsx"
 - Deux sauvegardes simultanées sur le même fichier : la seconde reçoit
   **409** `conflict` au lieu d'écraser la première.
 
+### Feuilles volumineuses et lecture par fenêtres
+
+Le rendu est plafonné à **500 lignes × 40 colonnes** par feuille. Quand
+une feuille dépasse ce plafond, un bandeau **« Feuille tronquée »**
+l'annonce explicitement (par exemple « 500 lignes affichées sur 520 »)
+au lieu de présenter une table courte comme complète — le classeur,
+lui, n'est jamais modifié. La ligne d'en-têtes de colonnes reste
+visible pendant le défilement vertical.
+
+Côté API, `GET /api/file/{vault}/xlsx/sheet` sert une feuille **par
+fenêtres de lignes**, y compris au-delà du plafond d'affichage — les
+coordonnées A1 renvoyées sont celles de la feuille réelle :
+
+```bash
+curl "http://localhost:2020/api/file/Recettes/xlsx/sheet?path=budget.xlsx&sheet=Budget&offset=500&limit=200"
+```
+
+- `offset` : première ligne renvoyée (0-based) ; `limit` : nombre de
+  lignes (1 à 1 000 par requête).
+- La réponse porte `total_rows`, `truncated` et `has_more` pour paginer.
+- Erreurs : **404** si la feuille n'existe pas, **415** si le fichier
+  n'est pas un `.xlsx`.
+
 ### Limites
 
-- Le rendu est plafonné à **500 lignes × 40 colonnes** par feuille, sans
-  pagination : au-delà, le contenu n'est pas affiché (et non éditable).
+- L'affichage intégré reste plafonné à **500 lignes × 40 colonnes** par
+  feuille (le défilement automatique au-delà est en préparation) ; les
+  lignes cachées restent accessibles via l'endpoint ci-dessus.
 - Styles, formats de nombre, cellules fusionnées et volets figés ne sont pas
-  rendus ; le contenu des tableurs n'est pas non plus indexé pour la
-  recherche (contrairement aux PDF).
+  rendus.
 - Formats non gérés : `.xls`, `.xlsm` (macros), `.ods`.
 
 ---