@aiquants/spreadsheet 0.16.1 → 0.17.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,95 @@
2
2
 
3
3
  All notable changes to `@aiquants/spreadsheet` are documented here.
4
4
 
5
+ ## 0.17.1 (2026-10-27)
6
+
7
+ ### Fixed
8
+
9
+ - **`onContentSizeChange` reports what the grid draws in every layout.** A grid with no rows or no columns draws no
10
+ cells, bands or scroll bars and now reports 0 × 0; it reported nothing before, so a host kept the size of the table it
11
+ showed last. A grid without a layout box (under a `display: none` ancestor) reads its bands as 0, so it no longer
12
+ reports then and reports again once it has a box, as it now does when a host's stylesheet changes a band's size
13
+ without a render (the body pane is observed for both). In a right-to-left grid the row numbers sit to the right of
14
+ the cells, where the body's left offset does not count them, so the width came out one band short; the bands are now
15
+ the zoom wrapper's inner size less the body's, which counts them on either side.
16
+ - **PageUp and PageDown move by the part of the grid the page shows.** A grid taller than its scroll container (a box
17
+ that shows every row) holds every row in its own viewport, so a page move went from any row to the first or the last.
18
+ The travel is now the grid's viewport cut to the part of the body pane that the clipping boxes outside the grid and
19
+ the window show, so a page move goes one screenful, as it does in a grid that scrolls itself.
20
+ - **The reveal after a keyboard move lands at once** (`behavior: "instant"`). A host page with `scroll-behavior: smooth`
21
+ animated every reveal, so a held arrow key left the page behind the active cell.
22
+ - **The active cell's frame is at least 3 CSS px on screen at every zoom** (WCAG 2.4.13). The 2 px frame lived inside
23
+ the zoom wrapper and shrank with it (1.5 px at 75 %, 0.5 px at 25 %); its width is now 3 px divided by the zoom,
24
+ rounded up to a whole pixel, since browsers floor a border's width to whole pixels (divided alone, it came out 2.52 px
25
+ at 84 % and 1.68 px at 168 %). On screen that is 3 px to under 3 px plus the zoom. Its area inside a W × H cell, at
26
+ least 6 (W + H) − 36, is at least that of a 2 px perimeter around the cell, 4 (W + H) + 16, whenever W + H ≥ 26 — a
27
+ default 100 × 24 cell down to the 25 % zoom (25 × 6 px on screen).
28
+ - **Autofit measures with the cells' letter and word spacing**, a reader's text-spacing override included (WCAG 1.4.12).
29
+ A canvas does not inherit CSS spacing, so a fitted column cut off its widest text once the spacing was widened.
30
+
31
+ ### Verification
32
+
33
+ - **公開面・DOM 属性**: 0.17.0 と同じ (公開面 143 export、`data-aqsp-*` のリテラル census 83 種)。内部の変数
34
+ `--_aqsp-zoom` (ズームの包みの倍率。既定 1 を `.aqsp-zoom` が宣言し、倍率が 1 でないときは部品がインラインで書く) を追加。
35
+ - **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **98 ファイル 4,246 テスト** 全緑 —
36
+ 0.17.0 出荷時の 98 ファイル 4,231 に v0.17.1 進行分 +15 (`hostFit` +12、`useGridKeyboard` +2、0.17.0 節の出荷時凍結ピンで
37
+ `hxCensus` +1)。`tsc --noEmit` / biome 0。E2E は `host-fit` +4 (PageDown / PageUp の 1 画面、右から左の大きさ、キーで辿る
38
+ 倍率の全部の段の枠の太さ、文字の間隔のある自動調整) を加えた全 25 ファイル 285 テストを全数実行で確かめた (枠の 1 件は、
39
+ 倍率で割るだけの太さ (整数の px へ切り捨て) に戻すと倍率 0.84 の 2.52 px で落ちることも確かめた)。
40
+
41
+ ## 0.17.0 (2026-10-27)
42
+
43
+ A host can now fit the grid's box to its content: hide the column letters and row numbers, read the content size, fit
44
+ every column over all its rows, and keep the active cell on screen when the grid is taller than its scroll container.
45
+
46
+ ### Added
47
+
48
+ - **`headings`** (prop, true by default) shows the column letters, the row numbers and the corner (Excel's "headings";
49
+ not `headerRows`). False draws none of the three and collapses their grid tracks to 0, so the cells start at the
50
+ grid's top-left corner. The gestures that live only on them go with them (header presses, the corner's select-all,
51
+ the resize strips and unhide markers), and their keyboard twins stay (Ctrl+Space, Shift+Space, Ctrl+A,
52
+ Alt+Shift+Arrow, Alt+Shift+=). The bands are `aria-hidden`, so assistive technology meets the same grid. The root
53
+ carries `data-aqsp-headings-hidden` while they are hidden, and switching the prop wires the header machines to the
54
+ new bands.
55
+ - **`onContentSizeChange(size)`** (prop) receives the size of the grid's content (`SpreadsheetContentSize`): the bands,
56
+ every track and the two scroll bars the grid always reserves, all scaled by the zoom (the scroll bars live inside the
57
+ zoom wrapper, so they scale too). It is called after the first layout and after every change of a track's size, the
58
+ row or column count, the default sizes, the zoom or `headings`, never with an unchanged size. A host sizes the grid's
59
+ box to its content with it.
60
+ - **`SpreadsheetHandle.autoFitColumns(columns)`** fits the listed columns to the widest text of all their rows (header
61
+ rows included), as Alt+Shift+= fits the active column over the rows in view: the same painted fonts, 9 px padding and
62
+ 10,000 px bound. It refuses through `onOperationRejected("resize", cells, "limit")` when the cells to measure exceed
63
+ `maxOperationCells`, keeps a hidden or empty column's width, and throws a `RangeError` for a column that is not a
64
+ whole number below the column count.
65
+
66
+ ### Changed
67
+
68
+ - **A keyboard move keeps the active cell on screen outside the grid too.** After the grid lands the cell in its own
69
+ viewport, the scroll containers outside the grid (a host's box, the page) scroll by the least amount that shows the
70
+ cell (block and inline "nearest", their `scroll-padding` honoured). A grid taller or wider than its scroll container
71
+ (a box that shows every row, a grid half outside the window) kept the active cell off-screen before, since the grid
72
+ saw it inside its own viewport (WCAG 2.4.11 / 2.4.12). The reveal goes through a hidden marker under the root
73
+ (`data-aqsp-reveal`), clipped to the root's box, so no container inside the grid moves.
74
+ - **Autofit measures with the cells' base font, read from the body pane**, instead of the column-letter band's. Both
75
+ inherit the root's font, so the widths do not change, and the keyboard fit and `autoFitColumns` now work without the
76
+ bands.
77
+
78
+ ### Demo
79
+
80
+ - **`/fit`** shows a host that fits the grid's box to `onContentSizeChange`: the grid shows every row and the page
81
+ scrolls instead, with the headings switch, the zoom, the all-rows fit and the content-size readout.
82
+
83
+ ### Verification
84
+
85
+ - **公開面**: 公開面は `index.ts` の値 44 + 型 99 = 143 export (型 `SpreadsheetContentSize` を追加)。
86
+ - **DOM 属性**: `data-aqsp-headings-hidden` (根) と `data-aqsp-reveal` (ページの追従の印) の 2 種を追加 — リテラル census は
87
+ 83 種 (dataset 直書きの同値抑止署名キー 4 種を加えた総数は 87。分冊 05 §10・分冊 00 §3.2)。
88
+ - **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **98 ファイル 4,231 テスト** 全緑 —
89
+ 0.16.1 出荷時の 97 ファイル 4,208 に v0.17 進行分 +23 (`hostFit` +20 新規、`toolPages` +2、0.16.1 節の出荷時凍結ピンで
90
+ `hxCensus` +1)。`tsc --noEmit` / biome 0。E2E は `host-fit` 10 テスト (新規) を加えた全 25 ファイル 281 テストを
91
+ 全数実行で確かめた。負荷の中で 1 回落ちた `styles` の 1 本 (書式のツールバーの直後に computed を 1 回だけ読む競合。単独では 3 回とも
92
+ 合格) は、書式と罫線の直後の 6 つの読みを `expect.poll` に直した。
93
+
5
94
  ## 0.16.1 (2026-10-27)
6
95
 
7
96
  ### Added
package/README.md CHANGED
@@ -364,11 +364,14 @@ to `"¥203,428"`, not to the raw `"203428"`, which used to left-clip the most s
364
364
  Row autofit restores the default row height (cells render single-line clipped). Autofit is disabled entirely when
365
365
  `renderCell` is set — custom cell DOM cannot be measured.
366
366
 
367
- > **Autofit measures with the header's font as its base.** Text measurement composes its font from the **header band's**
368
- > computed style (style / weight / size / family); since v0.8 the cell's **painted** format (bold / italic from the base format
369
- > and width-relevant conditional formats, `fontSize` in pt × 4/3, `fontFamily`) overrides those parts per cell, bucketed so
370
- > `ctx.font` is assigned once per distinct font. If your CSS gives body cells a different base font than the headers, autofit
371
- > will mismeasure — keep cell and header base fonts identical (the shipped stylesheets do).
367
+ > **Autofit measures with the cells' base font.** Text measurement composes its font from the **body pane's** computed
368
+ > style (style / weight / size / family — the cells' parent, so the fit works whether `headings` shows the bands or not);
369
+ > the cell's **painted** format (bold / italic from the base format and width-relevant conditional formats, `fontSize` in
370
+ > pt × 4/3, `fontFamily`) overrides those parts per cell, bucketed so `ctx.font` is assigned once per distinct font. The
371
+ > pane's letter and word spacing go to the canvas too (a canvas does not inherit CSS spacing), so a reader's text-spacing
372
+ > override (WCAG 1.4.12) widens the fit instead of cutting the widest text. If your CSS gives the cells a different base
373
+ > font or spacing than their pane, autofit will mismeasure — set them on the root, which the pane, the cells and the
374
+ > header bands all inherit (the shipped stylesheets do).
372
375
 
373
376
  `enableResizeUI={false}` removes the strips **and the unhide markers** — a consumer with hidden tracks then has no
374
377
  in-package restore affordance (only the imperative API). The imperative `resizeRow` / `resizeColumn` calls bypass every UI
@@ -610,6 +613,13 @@ the freeze divider `#858e9d` 3.31 / 3.0, the unhide markers at full opacity 4.7
610
613
  input border `#8b95a4` 3.03. Grid lines, band edges, popover frames and the note tip's frame are decorative (the tip is identified by its
611
614
  surface and shadow).
612
615
 
616
+ **Focus appearance (WCAG 2.4.13).** The active cell's frame is at least 3 CSS px of `--aqsp-accent` inside the cell at
617
+ every zoom: the zoom wrapper scales it, so its width is 3 px divided by the zoom, rounded up to a whole pixel (browsers
618
+ floor a border's width to whole pixels) — 3 px to under 3 px plus the zoom on screen. Its area in a W × H cell on screen,
619
+ at least 6 (W + H) − 36, is at least that of a 2 px perimeter around the cell, 4 (W + H) + 16, whenever W + H ≥ 26 — a
620
+ default 100 × 24 cell down to the 25 % zoom (25 × 6 px) — and the accent changes those pixels from the surface at
621
+ 5.17:1. A browser without CSS `round()` drops the width and draws the initial 3 px, which the zoom scales.
622
+
613
623
  **Contrast (WCAG 1.4.6, 7:1).** Every text / background pair of the light defaults is at least 7:1, measured with the WCAG 2
614
624
  formula; the three pairs below 7:1 before v0.16 were re-solved by changing lightness only (the hue stays):
615
625
 
@@ -739,8 +749,8 @@ track, and paging moves by exact viewport-height pixel geometry, so page landing
739
749
  | Home / End (+Ctrl) | First/last visible column / visible grid corner | Native | Native | — |
740
750
  | Shift+Home / Shift+End | Extend to the first / last visible column | Native | Native | — |
741
751
  | Ctrl+Shift+Home / End | Extend to the first / last visible grid corner | Native | Native | — |
742
- | PageUp / PageDown | Page move (one viewport height, exact) | Commit + page move | Commit + page move | — |
743
- | Shift+PageUp / PageDown | Extend by one viewport height | Native | Native | — |
752
+ | PageUp / PageDown | Page move by one screenful, exact: the grid's viewport cut to the part of it the page shows (see *Fitting a box to the grid*) | Commit + page move | Commit + page move | — |
753
+ | Shift+PageUp / PageDown | Extend by one screenful | Native | Native | — |
744
754
  | Ctrl+Space / Shift+Space | Select whole columns / rows of **every** selected range (anchor/active stay) | Native | Native | — |
745
755
  | F2 | Start editing (edit) | Toggle the pointing arm — a session opens disarmed (Excel Edit mode: the first Arrow moves the caret), typing a trigger arms it, F2 is Excel's Edit ⇄ Enter (formula session with `getCellFormula`; otherwise native) | Toggle the pointing arm | — |
746
756
  | F4 | — | Cycle the `$` anchor of the reference under the caret (`A1` → `$A$1` → `A$1` → `$A1`) | Same | — |
@@ -896,6 +906,8 @@ The grid's own UI chrome ships in English (`"en"`, the default) and Japanese (`"
896
906
  | `renderCell` | `(ctx: RenderCellContext) => ReactNode` — `RenderCellContext = { row; col; text; displayText }` (exported) | Custom cell rendering. **Must be identity-stable** (`useCallback`) — an inline arrow defeats the cell memo and re-renders every visible cell each pass. **Per-cell opt-out** (v0.12 — ADR-32): return `undefined` and that one cell falls back to the package default rendering, value-format engine included (only `undefined` opts out — `null`, `false` and any other ReactNode are custom output, i.e. an empty custom cell). `ctx.text` is the raw canonical string; `ctx.displayText` is the value-format display — the exact string the default rendering, announcements, the HTML clipboard and autofit share, so a custom cell that renders it can never drift from what gets copied. Autofit stays a whole-grid no-op while `renderCell` is set. |
897
907
  | `maxOperationCells` | `number` | Bulk-operation ceiling (default 100,000). Row fan-out resize gates at 1/10 of it and autofit at 1/4 — see "Operation limits". |
898
908
  | `enableResizeUI` | `boolean` | Default `true`. `false` removes resize strips **and unhide markers** — hidden tracks then have no in-package restore path (imperative API only). |
909
+ | `headings` | `boolean` | v0.17 — default `true`: shows the column letters, the row numbers and the corner (Excel's "headings"; not `headerRows`). `false` draws none of the three and collapses their grid tracks to 0, so the cells start at the grid's top-left corner; the gestures that live only on them go with them (header presses, the corner's select-all, the resize strips and unhide markers) and their keyboard twins stay (Ctrl+Space, Shift+Space, Ctrl+A, Alt+Shift+Arrow, Alt+Shift+=). The bands are `aria-hidden`, so assistive technology meets the same grid. The root carries `data-aqsp-headings-hidden` while they are hidden. LIVE prop. |
910
+ | `onContentSizeChange` | `(size: SpreadsheetContentSize) => void` | v0.17 — receives the size of the grid's content in CSS px: the bands (when shown), every column and row at its current size and the two scroll bars the grid always reserves, all scaled by the zoom (the scroll bars live inside the zoom wrapper, so they scale too). Called after the first layout and after every change of it — a track's size (a resize, an autofit, a hide or unhide, the imperative `resizeRow` / `resizeColumn`), the row or column count, the default sizes, the zoom or `headings` — never with an unchanged size. The bands count on whichever side of the cells they sit (a right-to-left grid too); a grid with no rows or no columns draws nothing and reports 0 × 0; a grid without a layout box (under a `display: none` ancestor) reports once it has one. See *Fitting a box to the grid*. |
899
911
  | `zoom` / `defaultZoom` / `onZoomChange` | `number` / `number` / `(zoom: number) => void` | Package zoom (v0.3): visual transform scale, logic stays in logical px. Controlled (`zoom`) or uncontrolled (`defaultZoom`, default 1). Gestures — Alt+Wheel and Ctrl+Alt+`=` / `+` / `-` / `0` (reset; the four keys match the produced character, Shift-agnostic; AltGraph-state chords are never claimed — legacy-shape defense in depth, see Keymap notes) — request via `onZoomChange`; Ctrl+Wheel is deliberately unbound (the browser owns it). Clamped to [`SPREADSHEET_ZOOM_MIN`, `SPREADSHEET_ZOOM_MAX`] (0.25–4, `clampSpreadsheetZoom` of `@aiquants/spreadsheet/view`); a non-finite value (NaN / ±Infinity) throws a `RangeError` (fail-fast — no silent substitution). |
900
912
  | `enableFillHandle` | `boolean` | Default `true`. Fill writes through `applyEdits` — disable for read-only adapters. |
901
913
  | `onSelectionChange` | `(selection: SelectionState) => void` | Fires on confirmed changes only — never on mount, and never mid-drag with one documented exception: the header subtract reservation converts to a real press on the first movement that both really changes the pointer coordinates and lands on a different header index (in-index jitter and synthetic same-position moves keep the reservation), firing the deferred press replace mid-drag (total fire count matches v0.1). |
@@ -982,6 +994,43 @@ that fails to parse `"unreadable"` — each fires `onClipboardUnavailable` and r
982
994
  called; `"empty"` means nothing was written (an own payload whose identity was suppressed, every cell skipped, a mode without cell
983
995
  aspects such as `columnWidths` — sizes may still have been applied).
984
996
 
997
+ ## Fitting a box to the grid (v0.17)
998
+
999
+ A host that shows a whole table — a document, a report — sizes the grid's box to the grid's content instead of giving
1000
+ the grid a fixed box:
1001
+
1002
+ ```tsx
1003
+ const [size, setSize] = useState<SpreadsheetContentSize | null>(null)
1004
+ const box = size === null ? undefined : { width: `min(${Math.ceil(size.width)}px, 100%)`, height: `${Math.ceil(size.height) + 1}px` }
1005
+ // <div style={box}><Spreadsheet ref={ref} headings={false} onContentSizeChange={setSize} ... /></div>
1006
+ ref.current?.autoFitColumns(Array.from({ length: colCount }, (_, col) => col))
1007
+ ```
1008
+
1009
+ - **`onContentSizeChange`** reports the size that shows every column and row without scrolling (see the props table).
1010
+ Round the height up and keep a pixel of slack: if a rounding leaves the rows a fraction taller than the box, the row
1011
+ list becomes scrollable and the grid takes vertical finger swipes for itself (`touch-action: none`), so a box taller
1012
+ than the window would trap a touch reader. A box that shows every row lets a vertical wheel and a vertical swipe over
1013
+ the grid scroll the page instead.
1014
+ - **`autoFitColumns(columns)`** fits the listed columns to the widest text of **all** their rows (header rows
1015
+ included) — Alt+Shift+= fits the active column over the rows in view — with the same painted fonts, 9 px padding and
1016
+ 10,000 px bound. A hidden or empty column keeps its width; more measured cells than `maxOperationCells` are refused
1017
+ through `onOperationRejected("resize", cells, "limit")` (false), and a column that is not a whole number below the
1018
+ column count is a `RangeError`. It returns false while `renderCell` is set (custom cell DOM cannot be measured) and
1019
+ works whatever `enableResizeUI` and `headings` say. Measure after `document.fonts.ready` when the page uses web fonts.
1020
+ - **`headings={false}`** drops the column letters, the row numbers and the corner (see the props table).
1021
+ - **Keyboard moves keep the active cell on screen.** A grid taller or wider than its scroll container sees the active
1022
+ cell inside its own viewport, so after landing the cell there the grid also scrolls the containers outside it (the
1023
+ host's box, the page) by the least amount that shows the cell — block and inline "nearest", honouring their
1024
+ `scroll-padding` (give a scroller with a sticky bar a matching `scroll-padding`). The reveal goes through a hidden
1025
+ marker under the root (`data-aqsp-reveal`), clipped to the root's box, so no container inside the grid moves; a
1026
+ pointer selection does not scroll (the pressed cell is on screen). The reveal lands at once (`behavior: "instant"`),
1027
+ whatever the page's `scroll-behavior`, so a held arrow key does not leave the page behind.
1028
+ - **Page moves go by a screenful of the page.** PageUp / PageDown travel the grid's viewport cut to the part of the
1029
+ body that the clipping boxes outside the grid and the window show — a box that shows every row holds every row in
1030
+ the grid's own viewport, which would page from any row to the first or the last.
1031
+
1032
+ The demo's `/fit` route is the reference wiring.
1033
+
985
1034
  ## View geometry and zoom rules (`@aiquants/spreadsheet/view`)
986
1035
 
987
1036
  `@aiquants/spreadsheet/view` publishes the grid's fixed geometry, its defaults and its zoom ladder without loading the grid
@@ -1058,7 +1107,7 @@ importers with the exact same Excel-compatible semantics the grid uses. `enumera
1058
1107
  `onOperationRejected` op), and `EditRejection` (the `onEditRejected` context — see "Editing, Undo, and rejection") are exported for
1059
1108
  consumer-side annotations.
1060
1109
 
1061
- v0.8 adds the rich-cell engines as public pure functions (all React-free; `src/index.ts` exports 44 values and 98 types in total — every named type an exported declaration reaches is exported too, so nothing has to be extracted with `Awaited<ReturnType<>>` / `Extract<>`; `src/index.spec.ts` pins it):
1110
+ v0.8 adds the rich-cell engines as public pure functions (all React-free; `src/index.ts` exports 44 values and 99 types in total — every named type an exported declaration reaches is exported too, so nothing has to be extracted with `Awaited<ReturnType<>>` / `Extract<>`; `src/index.spec.ts` pins it):
1062
1111
 
1063
1112
  - **Clip payload** — `serializeClipPayload(payload)` / `parseClipPayload(json)` (the lossless wire format `{ v: 1, rows, cols, clipId, formats, validations, cells, colWidths?, rowHeights?, wholeRows, wholeCols, conditionalFormats }`; the parser is total and returns `null` on ANY malformed input, the serializer validates the same way and throws a `RangeError`),
1064
1113
  `detectClipSource(flavours, channel)` (`"aqsp" | "sheets" | "excel" | "html" | "tsv" | "none"` — the ADR-14 detection over `{ types, getData }`), and the types `ClipPayload` / `ClipCell` / `ClipComment` / `ClipSource` / `ClipInfo` / `ClipFlavours` / `ClipChannel` (the `detectClipSource` parameter types).
@@ -1178,6 +1227,7 @@ covers the `?lang=ja` path and the live switch; every other E2E spec runs the En
1178
1227
  | `/styles` | The v0.8 rich cells (`tests/e2e/styles.spec.ts`): a 300 × 26 sheet whose store declares all eight capabilities (a mini formula evaluator for `=A1+B1` / `SUM` / `AVERAGE` feeds `evaluateFormula` and the computed `getCellText`, `getCellFormula` returns the source), a patch-applying store with per-transaction inverse-patch Undo (a cross-sheet cut-move folds into one entry) and consumer-minted comment ids, a format toolbar driven by `handle.executeCommand` (every button keeps focus in the grid), colour pickers, border / number-format presets, link / note / comment / validation / conditional-format editors, a Paste Special menu opened by `onPasteSpecialRequest` (Excel accelerators — modes `A`ll / `F`ormulas / `V`alues / `T` formats / `C`omments and notes / `N` validation / `X` all except borders / `W`idths / `R` conditional formats, operations `O` none / `D` add / `S` subtract / `M` multiply / `I` divide, flags `B` skip blanks / `E` transpose / `J` inject formats → `handle.paste`), highlight-band settings, a shortcut rebinding table with reserved-chord warnings, a clip-info chip (`onClipChange`), a Sheet A / B toggle for cross-sheet paste and cut-move, and Excel / Sheets fixture buttons that write real interop HTML to the clipboard — and, since v0.9, the trailing freeze live by default: `frozenTrailingRows={1}` / `frozenTrailingColumns={1}` alongside the leading 1×1 (this nine-quadrant state is the ambient every `/styles` budget number is certified on) pin the sheet's grand-total row (the last row's `SUM` / `AVERAGE`, bold at the base font) to the bottom edge, with a `data-demo-trailing` checkbox to release it |
1179
1228
  | `/huge` | The v0.4 deep-reach proof: 1,000,000 × 10,000,000 on a pure functional adapter — Ctrl+→ (and End) reach the rightmost column 9,999,999 and Ctrl+↓ the last row 999,999 in one press (uniform-block Excel semantics, unified with the `/` route; ±1px cell placement), a "deep jump" button (`scrollToCell` to the interior column 5,000,000 ≈ 5 億 px, past the 2^25 wall), zoom ×4 holds ±1 logical px — plus runtime freeze toggles (0 ↔ 3 frozen rows above 0 ↔ 3 frozen columns), a context menu (right-click / Shift+F10) that opens at static frozen-cell coordinates even mid-deep-scroll, and the drag-freshness and performance-budget E2E gates — plus the v0.9 trailing-freeze controls consumed by `tests/e2e/trailing-freeze.spec.ts`: trailing freeze toggles for 0 ↔ 2 last rows / columns (`data-demo-trailing-row-toggle` / `data-demo-trailing-col-toggle` — deliberately not the leading toggles' 0 ↔ 3), a row-axis deep jump to the last scroll row `rowCount − T − 1` (`data-demo-deep-jump-row`, reading the live toggle), and an overlap toggle (`data-demo-overlap-toggle` — 16 / 16 frozen rows and 8 / 8 frozen columns exceed the default E2E viewport on both axes) |
1180
1229
  | `/tune` | Sizing knobs (`defaultRowHeight` / `defaultColumnWidth` / banded per-column widths via the imperative `resizeColumn` mount effect), hide / unhide (drag a boundary to 0, marker drag / dblclick restore, single-column dblclick autofit), a deliberately low LIVE `maxOperationCells` staging every rejection class (limit, row fan-out ÷10, autofit ÷4, bounds via the multi-cell corner recipe), live `enableResizeUI` / `enableFillHandle` opt-outs, an empty-grid staging toggle (rowCount 0 adapter swap), a data-reset button, and the zoom card (v0.3) — the controlled-mode reference wiring (`zoom` + `onZoomChange`, 50–200% select plus every zoom gesture) and the fixture for the zoom E2E gates |
1230
+ | `/fit` | v0.17 — a host that fits the grid's box to `onContentSizeChange` (`tests/e2e/host-fit.spec.ts`): a read-only 60 × 6 table in the page's flow whose box shows every row so the page scrolls instead, with the headings switch (`data-demo-fit-headings`), the zoom (`data-demo-fit-zoom`), the all-rows fit through `autoFitColumns` (`data-demo-fit-autofit`) and the content-size readout (`data-demo-fit-size`); arrow keys keep the active cell in the window |
1181
1231
  | `/a11y` | Locale-aware custom `formatCellAnnouncement` / `formatSelectionAnnouncement` (English by default, Japanese under `?lang=ja`) mirrored into visible readouts, per-locale overridden accessible names (Escape advisement kept), the WCAG 2.1.2 escape route |
1182
1232
  | `/readonly` | The v0.10 read-only cells (`tests/e2e/readonly.spec.ts`): a 200 × 10 sheet whose adapter declares `isCellReadOnly` (one locked COLUMN plus scattered locked cells for mixed selections) alongside note / comment / link / validation reads — the whole-operation refusals live (edit entries, Delete, paste, cut, fill incl. the diagonal legs, annotation chords on empty cells), the content-aware viewers (the locked column carries a comment thread, a note and a hyperlink; their chords open viewer-mode popovers with the commit affordance disabled), a host-side tint on `[data-aqsp-readonly]` (the package ships no CSS), a refusal toast worded per `ReadOnlyRejection` (the three `editSession` fates told apart, the two-producer cut wording), and an `onPasteResolved` two-line log that sits beside the refusal toast so a read-only-refused paste shows BOTH callbacks |
1183
1233
  | `/utils` | The exported pure functions live: TSV round-trip, paste-expansion rules, column-name converter (incl. its fail-fast `RangeError`), range algebra, and a clipboard inspector card (discloses the raw text/html payload, textContent-rendered) |