@aiquants/spreadsheet 0.17.0 → 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,42 @@
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
+
5
41
  ## 0.17.0 (2026-10-27)
6
42
 
7
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
package/README.md CHANGED
@@ -367,9 +367,11 @@ Row autofit restores the default row height (cells render single-line clipped).
367
367
  > **Autofit measures with the cells' base font.** Text measurement composes its font from the **body pane's** computed
368
368
  > style (style / weight / size / family — the cells' parent, so the fit works whether `headings` shows the bands or not);
369
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. If your
371
- > CSS gives the cells a different base font than their pane, autofit will mismeasure — set fonts on the root, which the
372
- > pane, the cells and the header bands all inherit (the shipped stylesheets do).
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).
373
375
 
374
376
  `enableResizeUI={false}` removes the strips **and the unhide markers** — a consumer with hidden tracks then has no
375
377
  in-package restore affordance (only the imperative API). The imperative `resizeRow` / `resizeColumn` calls bypass every UI
@@ -611,6 +613,13 @@ the freeze divider `#858e9d` 3.31 / 3.0, the unhide markers at full opacity 4.7
611
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
612
614
  surface and shadow).
613
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
+
614
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
615
624
  formula; the three pairs below 7:1 before v0.16 were re-solved by changing lightness only (the hue stays):
616
625
 
@@ -740,8 +749,8 @@ track, and paging moves by exact viewport-height pixel geometry, so page landing
740
749
  | Home / End (+Ctrl) | First/last visible column / visible grid corner | Native | Native | — |
741
750
  | Shift+Home / Shift+End | Extend to the first / last visible column | Native | Native | — |
742
751
  | Ctrl+Shift+Home / End | Extend to the first / last visible grid corner | Native | Native | — |
743
- | PageUp / PageDown | Page move (one viewport height, exact) | Commit + page move | Commit + page move | — |
744
- | 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 | — |
745
754
  | Ctrl+Space / Shift+Space | Select whole columns / rows of **every** selected range (anchor/active stay) | Native | Native | — |
746
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 | — |
747
756
  | F4 | — | Cycle the `$` anchor of the reference under the caret (`A1` → `$A$1` → `A$1` → `$A1`) | Same | — |
@@ -898,7 +907,7 @@ The grid's own UI chrome ships in English (`"en"`, the default) and Japanese (`"
898
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". |
899
908
  | `enableResizeUI` | `boolean` | Default `true`. `false` removes resize strips **and unhide markers** — hidden tracks then have no in-package restore path (imperative API only). |
900
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. |
901
- | `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. See *Fitting a box to the grid*. |
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*. |
902
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). |
903
912
  | `enableFillHandle` | `boolean` | Default `true`. Fill writes through `applyEdits` — disable for read-only adapters. |
904
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). |
@@ -1014,7 +1023,11 @@ ref.current?.autoFitColumns(Array.from({ length: colCount }, (_, col) => col))
1014
1023
  host's box, the page) by the least amount that shows the cell — block and inline "nearest", honouring their
1015
1024
  `scroll-padding` (give a scroller with a sticky bar a matching `scroll-padding`). The reveal goes through a hidden
1016
1025
  marker under the root (`data-aqsp-reveal`), clipped to the root's box, so no container inside the grid moves; a
1017
- pointer selection does not scroll (the pressed cell is on screen).
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.
1018
1031
 
1019
1032
  The demo's `/fit` route is the reference wiring.
1020
1033