@aiquants/spreadsheet 0.17.2 → 0.18.0

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,78 @@
2
2
 
3
3
  All notable changes to `@aiquants/spreadsheet` are documented here.
4
4
 
5
+ ## 0.18.0 (2026-10-28)
6
+
7
+ ### Added
8
+
9
+ - **A frame around a range of cells (`frame`).** `frame?: CellRange` draws a line of `--aqsp-frame-width` (2px by
10
+ default) in `--aqsp-frame-color` (default `#1f2937`, the ink of the text) just inside the outer edges of the range's
11
+ cells. It scrolls with the cells and the zoom scales it like their lines: it is part of the table's picture, not a
12
+ mark the reader looks for, so unlike the active cell's frame and the freeze divider it does not undo the zoom. The
13
+ part of the range inside the grid is framed and nothing is drawn when that part is empty; a range whose bounds are
14
+ not non-negative integers with each start at most its end throws a RangeError. Each pane frames only the tracks it
15
+ paints and leaves open (`data-aqsp-frame-open`) a side the range continues past — into another pane, or scrolled
16
+ more than a screen away — so frozen panes join into one frame without a seam, and the sides run on through the gap a
17
+ short table leaves above trailing frozen rows. The frame sits over the freeze dividers and the highlight bands and
18
+ under the active cell's frame: where a divider meets it, no notch, and the focus indicator is never covered (WCAG
19
+ 2.4.11–2.4.13). The root carries `data-aqsp-framed` while a frame is set. The colour stays far above 3:1 on every
20
+ surface it meets (14.68:1 on the white surface, 13.34:1 on the header row's and the bands' `#f3f4f6` — WCAG 1.4.11).
21
+ - **Demo**: `/fit` gains a frame switch, a pins switch (a frozen header row, footer row and first column, so the frame
22
+ meets the freeze dividers) and a switch for the row and column highlight bands.
23
+
24
+ ### Changed
25
+
26
+ - **A framed grid keeps its cell chrome inside the frame.** The far segments of a highlight band end at the overlay
27
+ quadrant's clip, and the freeze dividers span the quadrant, so in a box larger than the table both ran on past the
28
+ last cell. While a frame is set, every quadrant leads with a band clip capped at the cells the layer paints, which
29
+ holds the band groups (their geometry is unchanged); the dividers stop at the same cells, and the clip marquee's far
30
+ headroom ends there, so the ants stay inside the frame on every side. The caps are CSS relative to the quadrant
31
+ (`min(100%, …)`, `max(0px, calc(100% - …))`) computed from the track sizes alone, and the frame's open sides follow
32
+ the quadrant's own size, so a resize that changes no rendered track — which repaints nothing — keeps all of them
33
+ right. Without a frame the overlay's DOM and writes are those of 0.17.3.
34
+
35
+ ### Verification
36
+
37
+ - **公開面**: 0.17.3 と同じ 143 export (`frame` は公開済みの型 `CellRange` を受ける prop)。
38
+ - **DOM 属性**: `data-aqsp-framed` (根)・`data-aqsp-frame` (象限ごとの外枠)・`data-aqsp-frame-open` (外枠の開いた辺)・
39
+ `data-aqsp-band-clip` (枠のある象限の帯の切り抜き) の 4 種を追加 — リテラル census は 87 種 (dataset 直書きの同値抑止
40
+ 署名キー 4 種を加えた総数は 91。分冊 05 §10・分冊 00 §3.2)。
41
+ - **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **99 ファイル 4,281 テスト** 全緑 —
42
+ 0.17.3 出荷時の 98 ファイル 4,253 に v0.18 進行分 +28 (新規 `frame` 24、`SelectionOverlay` +3 (帯の切り抜き・枠の無い
43
+ 象限・マーキーの余白)、0.17.3 節の出荷時凍結ピンで `hxCensus` +1。`designTokens` は外枠の色と面の 3 対を加えて件数は
44
+ 同じ)。`tsc --noEmit` / biome 0。E2E は `frame` 8 テスト (新規 — 倍率 1・1.5・0.75 の外周、固定のある表の継ぎ目と
45
+ 分割線との交わり、表より大きい箱で分割線と帯が外枠の外へ出ないこと、スクロール、焦点の印が上、切り替えの解除) を
46
+ 加えた全 26 ファイル 296 テスト全緑 (2.9 分)。変異: 床が外枠を数えない・詰めの同値抑止を外す・余白へ詰めた辺を
47
+ 開かない・分割線の端を詰めない・帯を切り抜きへ入れない・切り抜きを先頭へ動かさない・マーキーの下の余白が層の端まで、
48
+ の単体の 7 つと、外枠を分割線の下へ・選んだセルの枠の上へ、の E2E の 2 つがどれも赤。分割線の端を px で書く初めの形は、
49
+ 描く行と列の変わらない箱の拡大で空きに分割線が残ることを E2E で見つけて CSS の相対の値へ直した。
50
+
51
+ ## 0.17.3 (2026-10-27)
52
+
53
+ ### Changed
54
+
55
+ - **The freeze divider keeps its thickness on screen at every zoom.** The zoom wrapper scaled the divider with the
56
+ grid, so a 2px divider was 1.68 px at 84 % and 0.5 px at 25 %; on a screen with one device pixel per CSS pixel a
57
+ half-pixel line paints at half strength, about 1.7:1 against the white surface instead of 3.31:1. Where CSS
58
+ `round()` is supported, the width is now `--aqsp-divider-width` divided by the zoom, rounded up to a whole pixel of
59
+ the wrapper's coordinates: the browser paints a box on whole pixels there (Chromium snaps both edges), so an exact
60
+ quotient would paint as its floor or its ceiling depending on where the line sits (measured: 1.1 to 2.2 px at
61
+ 110 %). A 2px divider is now 2 px to under 2 px plus the zoom on screen (2 px at 25 %, 2.5 px at 125 %, 4 px at
62
+ 400 %), as Excel's and Sheets' dividers keep one thickness at every zoom; at low zooms it covers more of the scroll
63
+ band's edge cells (8 logical px at 25 %). A browser without `round()` keeps the logical width, which the zoom
64
+ scales, and `--aqsp-divider-width: 0px` still removes the line.
65
+
66
+ ### Verification
67
+
68
+ - **公開面・DOM 属性**: 0.17.2 と同じ (公開面 143 export、`data-aqsp-*` のリテラル census 83 種)。
69
+ - **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **98 ファイル 4,253 テスト** 全緑 —
70
+ 0.17.2 出荷時の 98 ファイル 4,252 に v0.17.3 進行分 +1 (0.17.2 節の出荷時凍結ピンで `hxCensus` +1。分割線の CSS の
71
+ 文字列ピン (`trailingFreeze`) は `@supports` の規則を加えて件数は同じ)。`tsc --noEmit` / biome 0。E2E は
72
+ `trailing-freeze` +1 (キーで辿る倍率の全部の段で、胴体と見出しの縦と横の分割線が見た目 2 px 以上の最小の整数の px、
73
+ 25 % で中央の画素が分割線の色そのもの、`--aqsp-divider-width: 3px` も倍率で割られる) を加えた全 25 ファイル 288 テスト。
74
+ 変更が届く 4 ファイル (`trailing-freeze`・`styles`・`frozen-columns`・`frozen-rows`) は 74 件全緑。0.17.2 の論理 px に
75
+ 戻す変異は倍率 0.84 の見た目 1.68 px で、割るだけで切り上げない変異は太さ 2.375 px (整数でない) で赤。
76
+
5
77
  ## 0.17.2 (2026-10-27)
6
78
 
7
79
  ### Fixed
package/README.md CHANGED
@@ -21,7 +21,12 @@ deep-reach proof route.
21
21
  - 🧊 **Frozen columns & rows** (v0.5 / v0.6): `frozenColumns` pins the first N columns as a static left band and `frozenRows` pins the first N rows as a static top band — two-band headers, a Cartesian-product 4-quadrant clipped selection overlay, partition-aware hit-testing and ensure-visible on both axes, all riding the engine's anchor-free frozen bands
22
22
  - 📌 **Trailing freeze & strong freeze dividers** (v0.9): `frozenTrailingColumns` / `frozenTrailingRows` pin the **last** N columns / rows (a fixed totals row is the canonical use) as static right / bottom bands over the **same data** (count-based, Glide-style — no extra-row API), with three-band headers,
23
23
  a {main, frozen, scroll, trailing}² clipped selection overlay, three-way partitioned hit-testing / ensure-visible, near-edge resize strips with pinned-right semantics, and band-side unhide markers; **every** freeze boundary (leading and trailing, both axes) draws a strong Excel / Sheets-style
24
- divider over the scroll band's edge pixels — 2px `#858e9d` by default (3:1 against the surface and the header band), consumer-tunable through the CSS variables `--aqsp-divider-color` / `--aqsp-divider-width` (no prop), `pointer-events: none` — see "Trailing freeze and the freeze divider"
24
+ divider over the scroll band's edge pixels — 2px `#858e9d` by default (3:1 against the surface and the header band, held on screen at every zoom), consumer-tunable through the CSS variables `--aqsp-divider-color` / `--aqsp-divider-width` (no prop), `pointer-events: none` — see "Trailing freeze and the freeze divider"
25
+ - 🖼️ **A frame around a range** (v0.18 — ADR-34): `frame` (a `CellRange`) draws a line just inside the outer edges of
26
+ the range's cells, in `--aqsp-frame-color` (`#1f2937` by default, far above 3:1 on every surface) at
27
+ `--aqsp-frame-width` (`2px`), scrolling with the cells and scaled by the zoom like their lines; frozen panes join into
28
+ one seamless frame, and while it is set the highlight bands, the freeze dividers and the clip marquee stay inside it —
29
+ see "Framing a range"
25
30
  - 🔒 **Read-only cells as a capability** (v0.10 — ADR-27..31): one optional adapter predicate `isCellReadOnly(row, col)` locks cells — no edit session can open on them (all six entries, the touch on-screen-keyboard invitation included), an open session's commit is live re-checked,
26
31
  and every write whose target set touches a read-only cell (Delete / paste / cut both walls / fill with diagonal L-legs decomposed / format / self-calc / annotations) refuses the **whole operation** before the adapter is reached (Excel-style, no per-cell skip); painted cells carry
27
32
  `aria-readonly="true"` + `data-aqsp-readonly` (style it yourself — no package CSS), refusals speak through the single sealed `onReadOnlyRejected` (+ opt-in `formatReadOnlyAnnouncement`), and copying or viewing notes / comments / links stays legal (content-aware chords,
@@ -422,7 +427,7 @@ two CSS custom properties — the only consumer surface (there is no prop):
422
427
  | Variable | Default | Meaning |
423
428
  | :--- | :--- | :--- |
424
429
  | `--aqsp-divider-color` | `#858e9d` (3:1 against the surface and the header band: the divider is a mark, not decoration) | Divider colour |
425
- | `--aqsp-divider-width` | `2px` (Sheets strength) | Divider thickness |
430
+ | `--aqsp-divider-width` | `2px` (Sheets strength) | Divider thickness on screen, at every zoom |
426
431
 
427
432
  ```css
428
433
  /* consumer stylesheet — any scope that contains the grid root */
@@ -434,8 +439,12 @@ two CSS custom properties — the only consumer surface (there is no prop):
434
439
 
435
440
  - Setting `--aqsp-divider-width: 0px` is the escape hatch: the per-quadrant fill-fragment seams at each freeze boundary
436
441
  re-appear (they are normally absorbed by the divider), and the forced-colors rule paints nothing either — intended.
437
- - The divider scales in **logical px** with the package zoom (at z = 0.25 a 2px divider renders 0.5 visual px —
438
- registered deviation).
442
+ - The divider keeps its thickness **on screen** at every package zoom, as Excel's and Sheets' dividers do. The zoom
443
+ wrapper scales it, so its width is `--aqsp-divider-width` divided by the zoom, rounded up to a whole pixel: the
444
+ browser paints a box on whole pixels of the wrapper's coordinates (Chromium snaps both edges), so an exact quotient
445
+ would paint as its floor or its ceiling depending on where the line sits (measured: 1.1 to 2.2 px at 110 %). A 2px
446
+ divider is 2 px to under 2 px plus the zoom on screen (2 px at 25 %, 2.5 px at 125 %, 4 px at 400 %). A browser
447
+ without CSS `round()` keeps the logical width, which the zoom scales.
439
448
  - The divider is **inert**: a drag on the bar starts a header selection; the resize strip sits immediately adjacent on
440
449
  the band side of the line (freeze-by-drag stays out of scope). Under forced colors the divider paints `CanvasText`.
441
450
  - Under full overlap (middle band collapsed) no divider renders at all — there are no scroll pixels to overlay — and the
@@ -582,6 +591,7 @@ mode uses system colours only). `src/styles/designTokens.spec.ts` pins all of th
582
591
  | `--aqsp-reference-fill` | `rgb(22 163 74 / 0.08)` | Formula-reference rectangle fill |
583
592
  | `--aqsp-fill-preview` | `#16a24a` | Fill-handle preview border |
584
593
  | `--aqsp-divider-color` | `#858e9d` | Freeze dividers (with `--aqsp-divider-width`, default `2px`) |
594
+ | `--aqsp-frame-color` | `#1f2937` | The range frame of the `frame` prop (with `--aqsp-frame-width`, default `2px`) |
585
595
  | `--aqsp-popover-shadow` | `0 1px 2px rgb(0 0 0 / 0.08), 0 8px 24px rgb(0 0 0 / 0.14)` | Popover shadow (a whole `box-shadow` value) |
586
596
  | `--aqsp-note-tip-surface` | `#fffbeb` | Note tip background |
587
597
  | `--aqsp-note-tip-border` | `#f59e0b` | Note tip frame (decorative: the tip is identified by its surface and shadow) |
@@ -605,15 +615,16 @@ mode uses system colours only). `src/styles/designTokens.spec.ts` pins all of th
605
615
 
606
616
  The highlight bands resolve their aliases on the overlay element, where the `highlightColors` prop writes the public
607
617
  `--aqsp-band-*` names inline (so the prop wins over a host's value, and a host's value wins over the default);
608
- `--aqsp-divider-width` (default `2px`) sets the freeze dividers' thickness. The stylesheet declares no public `--aqsp-*`
618
+ `--aqsp-divider-width` (default `2px`) sets the freeze dividers' thickness on screen at every zoom, and `--aqsp-frame-width` (default
619
+ `2px`) the range frame's thickness at 100 % (the zoom scales the frame like the cells' lines). The stylesheet declares no public `--aqsp-*`
609
620
  name itself.
610
621
 
611
622
  **Non-text contrast (WCAG 1.4.11, 3:1).** The marks that carry meaning reach 3:1 against the default surface and the
612
623
  header-row surface: accent 5.17 / 4.7, the selection outline 3.97 (over the surface),
613
624
  the note marker 7.56 / 6.87, the comment marker `#eb6406` 3.3 / 3.0,
614
625
  danger 4.83 / 4.39, the reference and fill-preview green `#16a24a` 3.33 / 3.03,
615
- the freeze divider `#858e9d` 3.31 / 3.0, the unhide markers at full opacity 4.7 on the header band, and the popover
616
- 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
626
+ the freeze divider `#858e9d` 3.31 / 3.0, the range frame `#1f2937` 14.68 / 13.34 (and 13.34 on the header band), the
627
+ unhide markers at full opacity 4.7 on the header band, and the popover 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
617
628
  surface and shadow).
618
629
 
619
630
  **Focus appearance (WCAG 2.4.13).** The active cell's frame is at least 3 CSS px of `--aqsp-accent` inside the cell at
@@ -911,6 +922,7 @@ The grid's own UI chrome ships in English (`"en"`, the default) and Japanese (`"
911
922
  | `enableResizeUI` | `boolean` | Default `true`. `false` removes resize strips **and unhide markers** — hidden tracks then have no in-package restore path (imperative API only). |
912
923
  | `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. |
913
924
  | `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*. |
925
+ | `frame` | `CellRange` | v0.18 — draws a frame around a range of cells: a line of `--aqsp-frame-width` (2px by default) in `--aqsp-frame-color` (default `#1f2937`) just inside the outer edges of the range's cells, scrolling with them and scaled by the zoom like their lines. The part of the range inside the grid is framed; bounds that are not non-negative integers with each start at most its end throw a RangeError. Each pane frames the part it paints and leaves open a side the range continues past (`data-aqsp-frame-open`), so frozen panes join into one frame. The frame sits over the freeze dividers and the bands and under the active cell's frame; while it is set the bands, the dividers and the marquee's far headroom stop at the last painted cell, and the root carries `data-aqsp-framed`. See *Framing a range*. LIVE prop. |
914
926
  | `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). |
915
927
  | `enableFillHandle` | `boolean` | Default `true`. Fill writes through `applyEdits` — disable for read-only adapters. |
916
928
  | `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). |
@@ -1037,6 +1049,41 @@ ref.current?.autoFitColumns(Array.from({ length: colCount }, (_, col) => col))
1037
1049
 
1038
1050
  The demo's `/fit` route is the reference wiring.
1039
1051
 
1052
+ ## Framing a range (v0.18)
1053
+
1054
+ `frame` draws a frame around a range of cells — Excel's outside border, or the `frame` of an HTML table — as a line of
1055
+ `--aqsp-frame-width` (2px by default) in `--aqsp-frame-color` (default `#1f2937`), just inside the outer edges of the
1056
+ range's cells:
1057
+
1058
+ ```tsx
1059
+ // The used range of a document's table (rows × cols), not the spare rows and columns an editor adds
1060
+ <Spreadsheet adapter={adapter} frame={{ startRow: 0, startCol: 0, endRow: rows - 1, endCol: cols - 1 }} ... />
1061
+ ```
1062
+
1063
+ - **Where it draws.** Inside the range's outer cells (border-box), over their outer pixels and their own grid lines,
1064
+ never over the bands or the scroll bars. It scrolls with the cells, and the zoom scales it like the cells' lines: it
1065
+ is part of the table's picture, so unlike the active cell's frame and the freeze divider it does not undo the zoom.
1066
+ - **The range.** Bounds are non-negative integers with each start at most its end (`makeRange`'s shape); anything else
1067
+ throws a RangeError. The part of the range inside the grid is framed, and nothing when that part is empty, so a host
1068
+ whose range briefly outgrows a shrinking grid sees the frame cut to the grid, not an error.
1069
+ - **Frozen panes and scrolling.** Every pane frames only the tracks it paints and leaves open a side the range continues
1070
+ past — into another pane, or scrolled more than a screen away — so the panes join into one frame without a seam; a
1071
+ side scrolled out of view is simply not there, as with Excel's borders. Trailing frozen rows and columns stay at the
1072
+ viewport's end, and the sides run on through the gap a short table leaves before them. `data-aqsp-frame-open` names
1073
+ a node's open sides.
1074
+ - **Stacking.** The frame sits over the freeze dividers and the highlight bands, so a divider meets it without a notch,
1075
+ and under the active cell's frame, so the focus indicator is never covered (WCAG 2.4.11–2.4.13).
1076
+ - **The cell chrome stays inside.** While a frame is set, the highlight bands, the freeze dividers and the clip
1077
+ marquee's far headroom stop at the last painted cell instead of running on to the viewport's edge (a box wider or
1078
+ taller than the table). The caps are CSS relative to each overlay quadrant, computed from the track sizes alone, so a
1079
+ resize that changes no rendered track keeps them right without a repaint.
1080
+ - **Hooks.** The root carries `data-aqsp-framed` while a frame is set; the nodes are `[data-aqsp-frame]` (one per
1081
+ overlay quadrant) and `[data-aqsp-band-clip]` (the bands' clip). Without `frame` the overlay's DOM and writes are those
1082
+ of 0.17.3.
1083
+
1084
+ The demo's `/fit` route has a frame switch, with pins (a frozen header row, footer row and first column) and the row
1085
+ and column bands to see it meet the dividers and the bands.
1086
+
1040
1087
  ## View geometry and zoom rules (`@aiquants/spreadsheet/view`)
1041
1088
 
1042
1089
  `@aiquants/spreadsheet/view` publishes the grid's fixed geometry, its defaults and its zoom ladder without loading the grid
@@ -1204,7 +1251,8 @@ The `/utils` demo route exercises the v0.1 toolkit live; the `/styles` route dri
1204
1251
  | Self-calc | Writes canonical decimals (exponent-form inputs keep exponent form), flips `TRUE` / `FALSE` case-insensitively, leaves custom checkbox labels alone, treats an `=`-prefixed text as text unless `getCellFormula` is declared, and wraps compound formulas (`=(A1)/100+(B1)/100` × 100 ⇒ `=((A1)/100+(B1)/100)*100`) instead of peeling | The reference extension peels greedily | The greedy regex produces the broken `=A1)/100+(B1` |
1205
1252
  | Excel / Word HTML without a table | `mso-` paragraphs (Word / Outlook) paste as text, not as an unreadable Excel clip | — | No table reader can read them; ADR-14 forbids trying another reader |
1206
1253
  | Freeze divider interactivity | The divider is inert (`pointer-events: none`): a drag on the bar starts a header selection; the resize strip sits immediately adjacent on the band side of the line | In Sheets this exact visual is the freeze drag handle | Excel behaviour (static thin line) in Sheets clothing — freeze-by-drag would be its own freeze-UI feature, out of scope |
1207
- | Freeze divider under zoom | Logical px — scales with the package zoom (z = 0.25 renders a 2px divider at 0.5 visual px) | Excel / Sheets dividers are UI chrome, unaffected by sheet zoom | One coordinate space for all chrome; a zoom-compensating width var is a recorded future path, not added for this alone |
1254
+ | Freeze divider under zoom | At least `--aqsp-divider-width` on screen at every zoom, and less than one zoomed pixel more (a 2px divider: 2 px at 25 %, 2.5 px at 125 %, 4 px at 400 %) | Excel / Sheets dividers keep one thickness at every sheet zoom | The browser paints a box on whole pixels of the zoom wrapper's coordinates, so the divider takes the thinnest whole-pixel width that is not thinner than the variable on screen; an exact quotient would paint as its floor or its ceiling by position. At low zooms the line covers a larger share of the scroll band's edge cells (8 logical px at 25 %) |
1255
+ | Range frame under zoom | `frame`'s line scales with the zoom like the cells' own lines (a 2px frame is 1.42 px at 71 % and 0.5 px at 25 %) | An outside border keeps its screen thickness at every sheet zoom | The frame is part of the table's picture: a table shown at its printed size keeps its frame-to-cell proportion, while the marks a reader looks for (the active cell's frame, the freeze divider) keep their thickness on screen |
1208
1256
  | `--aqsp-divider-width: 0px` | Escape hatch: per-quadrant fill-fragment seams re-appear at every freeze boundary, and forced-colors paints nothing | — | The divider is what absorbs those seams; removing it re-exposes the pre-v0.9 artefact — intended |
1209
1257
  | Occluded trailing cells (overlap) | When leading + trailing extent exceeds the viewport, occluded trailing cells cannot be scrolled into view and keyboard focus draws no visible frame; the count clamp gives leading the count space | Excel refuses to freeze past the viewport | Count-based trailing freeze is LIVE and viewport-independent; the degenerate state is registered, not guarded |
1210
1258
  | Overlap divider collapse | With the middle band fully collapsed no divider renders, and the leading / trailing fill fragments butt directly (seam re-exposed) | — | Divider pixels live only on scroll-band pixels (structural placement rule); a collapsed middle band has none |
@@ -1233,7 +1281,7 @@ covers the `?lang=ja` path and the live switch; every other E2E spec runs the En
1233
1281
  | `/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 |
1234
1282
  | `/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) |
1235
1283
  | `/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 |
1236
- | `/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 |
1284
+ | `/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; v0.18 adds the frame switch (`data-demo-fit-frame` — every cell framed), the pins switch (`data-demo-fit-pins` — a frozen header row, footer row and first column) and the bands switch (`data-demo-fit-bands`), read from real pixels by `tests/e2e/frame.spec.ts` |
1237
1285
  | `/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 |
1238
1286
  | `/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 |
1239
1287
  | `/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) |