@aiquants/spreadsheet 0.17.1 → 0.17.2

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,47 @@
2
2
 
3
3
  All notable changes to `@aiquants/spreadsheet` are documented here.
4
4
 
5
+ ## 0.17.2 (2026-10-27)
6
+
7
+ ### Fixed
8
+
9
+ - **A press into a grid without focus no longer scrolls the page back to the previous active cell.** A press moved the
10
+ focus to the hidden input before it moved the selection, while the input still sat on the previous active cell, and
11
+ the browser scrolled the page to it: in a grid taller than its page (a box that shows every row), the first press on
12
+ a row below the window's top sent the page back to A1. Every press (cells, headings, the corner, resize strips, the
13
+ fill handle, scroll-bar bands, a reference while pointing) now focuses without scrolling, since the pressed point is
14
+ on screen; focus that reaches the root from a touch tap does too, while a keyboard entry (`:focus-visible`) still
15
+ scrolls the page to the active cell.
16
+ - **PageUp and PageDown measure the part of the grid the reader sees with the browser's own hit test.** 0.17.1 cut the
17
+ viewport by the clipping boxes it found walking the DOM's ancestors, which miscounted in common pages: an `html`
18
+ with `overflow-x: hidden` (its overflow belongs to the viewport, yet its box moves as the page scrolls) shortened the
19
+ move or sent it to the last row; a modal dialog, a popover or full screen (the top layer, which no ancestor clips), a
20
+ fixed or absolutely positioned grid (clipped only along its containing blocks) and a shadow tree were cut by boxes
21
+ that do not clip them, or not by the ones that do. The seen part is now found by hit testing down the middle of the
22
+ body pane (samples, then the edges bisected to 1 px), so every clip, the top layer, shadow trees and anything painted
23
+ over the grid count as drawn. While no part of the body is seen, a page move goes a screenful of the window, and a
24
+ move shorter than the row it starts on still goes one visible row (inside a row taller than the viewport, PageDown
25
+ stayed on that row since 0.2).
26
+ - **`onContentSizeChange` counts the bands in a box smaller than the bands.** 0.17.1 read the bands as the zoom
27
+ wrapper's inner size less the body pane's, which in a box smaller than the bands (a host that starts its box at 0 × 0)
28
+ is the box's size, so the first report missed the bands until the body resized. The bands are now read from the
29
+ corner, which fills their crossing whatever the box's size or the page's direction.
30
+ - **Autofit measures each font with its own letter and word spacing.** 0.17.1 copied the body pane's computed spacing
31
+ to every font, but a reader's override is usually written in em (WCAG 1.4.12's `0.12em` / `0.16em`), so a cell drawn
32
+ at another size was measured with the wrong spacing and a fitted column cut its text. Each measured font now reads
33
+ the spacing a hidden sample inside the body pane computes for it.
34
+
35
+ ### Verification
36
+
37
+ - **公開面・DOM 属性**: 0.17.1 と同じ (公開面 143 export、`data-aqsp-*` のリテラル census 83 種)。
38
+ - **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **98 ファイル 4,252 テスト** 全緑 —
39
+ 0.17.1 出荷時の 98 ファイル 4,246 に v0.17.2 進行分 +6 (`hostFit` +5、0.17.1 節の出荷時凍結ピンで `hxCensus` +1)。
40
+ `tsc --noEmit` / biome 0。E2E は `host-fit` +2 (焦点の無い表の途中のセルの押下でページが跳び戻らない、根の要素が
41
+ `overflow-x: hidden` でもページ送りが窓の 1 画面) を加えた全 25 ファイル 287 テスト。押下のスクロールを戻す変異は 493 px
42
+ から 0 px への跳び戻りで、ページ送りを 0.17.1 の祖先のたどりに戻す変異は「49 行目のはずが 28 行目」で赤。全数実行
43
+ (load average 11〜12) は 286 passed / 1 failed で、落ちたのは `styles` の 1 本 (Ctrl+B の直後に computed を 1 回だけ読む
44
+ 競合。単独では 3 回とも合格)。操作の直後に 1 回だけ読む 15 か所を `expect.poll` に直し、`styles` の 41 件は全緑。
45
+
5
46
  ## 0.17.1 (2026-10-27)
6
47
 
7
48
  ### Fixed
package/README.md CHANGED
@@ -367,9 +367,10 @@ 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. 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
370
+ > pt × 4/3, `fontFamily`) overrides those parts per cell, bucketed so `ctx.font` is assigned once per distinct font.
371
+ > Each bucket's letter and word spacing go to the canvas too (a canvas does not inherit CSS spacing), read from a hidden
372
+ > sample inside the pane that takes the bucket's font, so a reader's text-spacing override (WCAG 1.4.12, usually in em)
373
+ > widens the fit of every font size instead of cutting the widest text. If your CSS gives the cells a different base
373
374
  > font or spacing than their pane, autofit will mismeasure — set them on the root, which the pane, the cells and the
374
375
  > header bands all inherit (the shipped stylesheets do).
375
376
 
@@ -490,7 +491,9 @@ keyboard input — this is what makes IME composition, clipboard events, and 16M
490
491
  - Keyboard reachability is complete for the keymap below: every listed operation works without a pointer, and `Escape` from
491
492
  the grid root returns focus to the page tab order (WCAG 2.1.2 — no keyboard trap). The grid never takes focus on mount
492
493
  (the hidden input is armed focus-neutrally — WCAG 3.2.1 / 2.4.3): keyboard entry is the page tab order (Tab / Shift+Tab)
493
- or a click, and re-entry always lands on the hidden input. Resizing has keyboard commands of its own (Alt+Shift+Arrow,
494
+ or a click, and re-entry always lands on the hidden input. A press focuses it without scrolling the page (the pressed
495
+ point is on screen, and the input still sits on the previous active cell until the press moves the selection), and so
496
+ does focus a touch tap sends to the root; a keyboard entry (`:focus-visible`) scrolls the page to the active cell. Resizing has keyboard commands of its own (Alt+Shift+Arrow,
494
497
  Alt+Shift+= — see "Resizing from the keyboard"), and filling has `fillDown` / `fillRight` / `fillSelection` (Ctrl+D / Ctrl+R /
495
498
  Ctrl+Enter).
496
499
  - The hidden input's `inputmode` is a **virtual-keyboard invitation**, not a mirror of the editing session — and not an idle
@@ -749,7 +752,7 @@ track, and paging moves by exact viewport-height pixel geometry, so page landing
749
752
  | Home / End (+Ctrl) | First/last visible column / visible grid corner | Native | Native | — |
750
753
  | Shift+Home / Shift+End | Extend to the first / last visible column | Native | Native | — |
751
754
  | Ctrl+Shift+Home / End | Extend to the first / last visible grid corner | 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 | — |
755
+ | PageUp / PageDown | Page move by one screenful, exact: the grid's viewport cut to the part of it the reader sees (see *Fitting a box to the grid*) | Commit + page move | Commit + page move | — |
753
756
  | Shift+PageUp / PageDown | Extend by one screenful | Native | Native | — |
754
757
  | Ctrl+Space / Shift+Space | Select whole columns / rows of **every** selected range (anchor/active stay) | Native | Native | — |
755
758
  | 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 | — |
@@ -907,7 +910,7 @@ The grid's own UI chrome ships in English (`"en"`, the default) and Japanese (`"
907
910
  | `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". |
908
911
  | `enableResizeUI` | `boolean` | Default `true`. `false` removes resize strips **and unhide markers** — hidden tracks then have no in-package restore path (imperative API only). |
909
912
  | `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*. |
913
+ | `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) and in a box smaller than them; 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*. |
911
914
  | `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). |
912
915
  | `enableFillHandle` | `boolean` | Default `true`. Fill writes through `applyEdits` — disable for read-only adapters. |
913
916
  | `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). |
@@ -1026,8 +1029,11 @@ ref.current?.autoFitColumns(Array.from({ length: colCount }, (_, col) => col))
1026
1029
  pointer selection does not scroll (the pressed cell is on screen). The reveal lands at once (`behavior: "instant"`),
1027
1030
  whatever the page's `scroll-behavior`, so a held arrow key does not leave the page behind.
1028
1031
  - **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.
1032
+ body the reader sees — a box that shows every row holds every row in the grid's own viewport, which would page from
1033
+ any row to the first or the last. The seen part comes from the browser's own hit test down the middle of the body,
1034
+ so every clip (scroll containers, the window, an `html` whose overflow belongs to the viewport), the top layer (a
1035
+ modal dialog, a popover, full screen), shadow trees and anything painted over the grid count as drawn. While no part
1036
+ of the body is seen, a page move goes a screenful of the window; a move shorter than its starting row goes one row.
1031
1037
 
1032
1038
  The demo's `/fit` route is the reference wiring.
1033
1039