@aiquants/spreadsheet 0.17.3 → 0.18.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 +82 -0
- package/README.md +48 -4
- package/dist/index.cjs +8 -8
- package/dist/index.d.cts +17 -0
- package/dist/index.d.ts +17 -0
- package/dist/index.js +4130 -4004
- package/dist/styles/spreadsheet.css +1 -1
- package/dist/styles/spreadsheet.standalone.css +1 -1
- package/package.json +1 -1
- package/src/Spreadsheet.tsx +57 -2
- package/src/overlay/SelectionOverlay.tsx +627 -24
- package/src/styles/spreadsheet.css +48 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,88 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to `@aiquants/spreadsheet` are documented here.
|
|
4
4
|
|
|
5
|
+
## 0.18.1 (2026-10-28)
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
|
|
9
|
+
- **A range scrolled out under a frozen row leaves no piece of its frame behind.** A pane placed an open near side (one
|
|
10
|
+
the range continues past, into the frozen pane before it) at the quadrant's start and sized a closed far side from
|
|
11
|
+
there, so once the range's far edge scrolled above the quadrant's start the size came out negative. CSS drops a
|
|
12
|
+
negative size and the frame kept its last one: under a frozen header row, the rows of a framed range left a U-shaped
|
|
13
|
+
stub of the frame below the header until their edge passed a whole screen. An open near side now sits at the
|
|
14
|
+
margin's edge, a screen before the quadrant's start, where its missing line is out of view, so a closed far side's
|
|
15
|
+
size is never negative and the frame ends where the range does, outside the quadrant too.
|
|
16
|
+
- **A frame that starts past the cells' far edge stays out of view in a right-to-left page.** With its near side beyond
|
|
17
|
+
the quadrant's far edge and its far side open, the frame is over-constrained (`left`, `right: 0` and an auto width
|
|
18
|
+
that would be negative), and CSS drops `left` when the containing block is right-to-left: in a `dir="rtl"` page the
|
|
19
|
+
frame's left line showed at the quadrant's right edge. The overlay quadrants now keep a left-to-right direction —
|
|
20
|
+
their marks are all placed in physical px — so `right` is the value dropped and the frame stays outside its quadrant.
|
|
21
|
+
The text sink sits outside the quadrants and keeps the page's direction.
|
|
22
|
+
|
|
23
|
+
### Changed
|
|
24
|
+
|
|
25
|
+
- **A repaint that moves no frame allocates nothing for it.** The range cut to the grid is resolved again only when the
|
|
26
|
+
range or the grid's counts change, each quadrant resolves its frame into spans it keeps, and the CSS is built only for
|
|
27
|
+
an axis whose span changed; the quadrants' cell extents are kept as CSS strings, rebuilt with the split cache only.
|
|
28
|
+
- **Demo**: `/fit` gains a range select for the frame — every cell, or `D1:F4`, the first four rows of the last three
|
|
29
|
+
columns, which scrolls out under the frozen header row and, in a narrow box, starts past the cells' far edge.
|
|
30
|
+
|
|
31
|
+
### Verification
|
|
32
|
+
|
|
33
|
+
- **公開面**: 0.18.0 と同じ 143 export。DOM 属性も 0.18.0 と同じ。
|
|
34
|
+
- **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **99 ファイル 4,285 テスト** 全緑 — 0.18.0 出荷時の
|
|
35
|
+
99 ファイル 4,281 に v0.18.1 進行分 +4 (`frame` +3 — 凍結の行の下へ外れた範囲の軸の解き方・その範囲が古い箱を残さない
|
|
36
|
+
スクロール・象限の左から右の向きの CSS 契約、0.18.0 節の出荷時凍結ピンで `hxCensus` +1)。`tsc --noEmit` / biome 0。
|
|
37
|
+
E2E は `frame` +2 (見出しの行の下へ外れた範囲・右から左のページ) を加えた全 26 ファイル 298 テスト全緑 (2.7 分)。変異:
|
|
38
|
+
開いた近い辺を象限の端 (0) に置く元の形で単体 3 件と E2E の見出しの行の下の 1 件、象限の `direction: ltr` を外す形で E2E の
|
|
39
|
+
右から左のページの 1 件がどれも赤。
|
|
40
|
+
|
|
41
|
+
## 0.18.0 (2026-10-28)
|
|
42
|
+
|
|
43
|
+
### Added
|
|
44
|
+
|
|
45
|
+
- **A frame around a range of cells (`frame`).** `frame?: CellRange` draws a line of `--aqsp-frame-width` (2px by
|
|
46
|
+
default) in `--aqsp-frame-color` (default `#1f2937`, the ink of the text) just inside the outer edges of the range's
|
|
47
|
+
cells. It scrolls with the cells and the zoom scales it like their lines: it is part of the table's picture, not a
|
|
48
|
+
mark the reader looks for, so unlike the active cell's frame and the freeze divider it does not undo the zoom. The
|
|
49
|
+
part of the range inside the grid is framed and nothing is drawn when that part is empty; a range whose bounds are
|
|
50
|
+
not non-negative integers with each start at most its end throws a RangeError. Each pane frames only the tracks it
|
|
51
|
+
paints and leaves open (`data-aqsp-frame-open`) a side the range continues past — into another pane, or scrolled
|
|
52
|
+
more than a screen away — so frozen panes join into one frame without a seam, and the sides run on through the gap a
|
|
53
|
+
short table leaves above trailing frozen rows. The frame sits over the freeze dividers and the highlight bands and
|
|
54
|
+
under the active cell's frame: where a divider meets it, no notch, and the focus indicator is never covered (WCAG
|
|
55
|
+
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
|
|
56
|
+
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).
|
|
57
|
+
- **Demo**: `/fit` gains a frame switch, a pins switch (a frozen header row, footer row and first column, so the frame
|
|
58
|
+
meets the freeze dividers) and a switch for the row and column highlight bands.
|
|
59
|
+
|
|
60
|
+
### Changed
|
|
61
|
+
|
|
62
|
+
- **A framed grid keeps its cell chrome inside the frame.** The far segments of a highlight band end at the overlay
|
|
63
|
+
quadrant's clip, and the freeze dividers span the quadrant, so in a box larger than the table both ran on past the
|
|
64
|
+
last cell. While a frame is set, every quadrant leads with a band clip capped at the cells the layer paints, which
|
|
65
|
+
holds the band groups (their geometry is unchanged); the dividers stop at the same cells, and the clip marquee's far
|
|
66
|
+
headroom ends there, so the ants stay inside the frame on every side. The caps are CSS relative to the quadrant
|
|
67
|
+
(`min(100%, …)`, `max(0px, calc(100% - …))`) computed from the track sizes alone, and the frame's open sides follow
|
|
68
|
+
the quadrant's own size, so a resize that changes no rendered track — which repaints nothing — keeps all of them
|
|
69
|
+
right. Without a frame the overlay's DOM and writes are those of 0.17.3.
|
|
70
|
+
|
|
71
|
+
### Verification
|
|
72
|
+
|
|
73
|
+
- **公開面**: 0.17.3 と同じ 143 export (`frame` は公開済みの型 `CellRange` を受ける prop)。
|
|
74
|
+
- **DOM 属性**: `data-aqsp-framed` (根)・`data-aqsp-frame` (象限ごとの外枠)・`data-aqsp-frame-open` (外枠の開いた辺)・
|
|
75
|
+
`data-aqsp-band-clip` (枠のある象限の帯の切り抜き) の 4 種を追加 — リテラル census は 87 種 (dataset 直書きの同値抑止
|
|
76
|
+
署名キー 4 種を加えた総数は 91。分冊 05 §10・分冊 00 §3.2)。
|
|
77
|
+
- **検証 — 走行台帳 (census の錨は本未リリース節)**: 単体 / 統合 **99 ファイル 4,281 テスト** 全緑 —
|
|
78
|
+
0.17.3 出荷時の 98 ファイル 4,253 に v0.18 進行分 +28 (新規 `frame` 24、`SelectionOverlay` +3 (帯の切り抜き・枠の無い
|
|
79
|
+
象限・マーキーの余白)、0.17.3 節の出荷時凍結ピンで `hxCensus` +1。`designTokens` は外枠の色と面の 3 対を加えて件数は
|
|
80
|
+
同じ)。`tsc --noEmit` / biome 0。E2E は `frame` 8 テスト (新規 — 倍率 1・1.5・0.75 の外周、固定のある表の継ぎ目と
|
|
81
|
+
分割線との交わり、表より大きい箱で分割線と帯が外枠の外へ出ないこと、スクロール、焦点の印が上、切り替えの解除) を
|
|
82
|
+
加えた全 26 ファイル 296 テスト全緑 (2.9 分)。変異: 床が外枠を数えない・詰めの同値抑止を外す・余白へ詰めた辺を
|
|
83
|
+
開かない・分割線の端を詰めない・帯を切り抜きへ入れない・切り抜きを先頭へ動かさない・マーキーの下の余白が層の端まで、
|
|
84
|
+
の単体の 7 つと、外枠を分割線の下へ・選んだセルの枠の上へ、の E2E の 2 つがどれも赤。分割線の端を px で書く初めの形は、
|
|
85
|
+
描く行と列の変わらない箱の拡大で空きに分割線が残ることを E2E で見つけて CSS の相対の値へ直した。
|
|
86
|
+
|
|
5
87
|
## 0.17.3 (2026-10-27)
|
|
6
88
|
|
|
7
89
|
### Changed
|
package/README.md
CHANGED
|
@@ -22,6 +22,11 @@ deep-reach proof route.
|
|
|
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
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,
|
|
@@ -586,6 +591,7 @@ mode uses system colours only). `src/styles/designTokens.spec.ts` pins all of th
|
|
|
586
591
|
| `--aqsp-reference-fill` | `rgb(22 163 74 / 0.08)` | Formula-reference rectangle fill |
|
|
587
592
|
| `--aqsp-fill-preview` | `#16a24a` | Fill-handle preview border |
|
|
588
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`) |
|
|
589
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) |
|
|
590
596
|
| `--aqsp-note-tip-surface` | `#fffbeb` | Note tip background |
|
|
591
597
|
| `--aqsp-note-tip-border` | `#f59e0b` | Note tip frame (decorative: the tip is identified by its surface and shadow) |
|
|
@@ -609,15 +615,16 @@ mode uses system colours only). `src/styles/designTokens.spec.ts` pins all of th
|
|
|
609
615
|
|
|
610
616
|
The highlight bands resolve their aliases on the overlay element, where the `highlightColors` prop writes the public
|
|
611
617
|
`--aqsp-band-*` names inline (so the prop wins over a host's value, and a host's value wins over the default);
|
|
612
|
-
`--aqsp-divider-width` (default `2px`) sets the freeze dividers' thickness on screen at every zoom
|
|
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-*`
|
|
613
620
|
name itself.
|
|
614
621
|
|
|
615
622
|
**Non-text contrast (WCAG 1.4.11, 3:1).** The marks that carry meaning reach 3:1 against the default surface and the
|
|
616
623
|
header-row surface: accent 5.17 / 4.7, the selection outline 3.97 (over the surface),
|
|
617
624
|
the note marker 7.56 / 6.87, the comment marker `#eb6406` 3.3 / 3.0,
|
|
618
625
|
danger 4.83 / 4.39, the reference and fill-preview green `#16a24a` 3.33 / 3.03,
|
|
619
|
-
the freeze divider `#858e9d` 3.31 / 3.0, the
|
|
620
|
-
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
|
|
621
628
|
surface and shadow).
|
|
622
629
|
|
|
623
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
|
|
@@ -915,6 +922,7 @@ The grid's own UI chrome ships in English (`"en"`, the default) and Japanese (`"
|
|
|
915
922
|
| `enableResizeUI` | `boolean` | Default `true`. `false` removes resize strips **and unhide markers** — hidden tracks then have no in-package restore path (imperative API only). |
|
|
916
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. |
|
|
917
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. |
|
|
918
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). |
|
|
919
927
|
| `enableFillHandle` | `boolean` | Default `true`. Fill writes through `applyEdits` — disable for read-only adapters. |
|
|
920
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). |
|
|
@@ -1041,6 +1049,41 @@ ref.current?.autoFitColumns(Array.from({ length: colCount }, (_, col) => col))
|
|
|
1041
1049
|
|
|
1042
1050
|
The demo's `/fit` route is the reference wiring.
|
|
1043
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 and a range select (every cell, or `D1:F4`), with pins (a frozen header
|
|
1085
|
+
row, footer row and first column) and the row and column bands to see it meet the dividers and the bands.
|
|
1086
|
+
|
|
1044
1087
|
## View geometry and zoom rules (`@aiquants/spreadsheet/view`)
|
|
1045
1088
|
|
|
1046
1089
|
`@aiquants/spreadsheet/view` publishes the grid's fixed geometry, its defaults and its zoom ladder without loading the grid
|
|
@@ -1209,6 +1252,7 @@ The `/utils` demo route exercises the v0.1 toolkit live; the `/styles` route dri
|
|
|
1209
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 |
|
|
1210
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 |
|
|
1211
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 |
|
|
1212
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 |
|
|
1213
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 |
|
|
1214
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 |
|
|
@@ -1237,7 +1281,7 @@ covers the `?lang=ja` path and the live switch; every other E2E spec runs the En
|
|
|
1237
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 |
|
|
1238
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) |
|
|
1239
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 |
|
|
1240
|
-
| `/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`) with its range select (`data-demo-fit-frame-range` — every cell, or `D1:F4`, which scrolls out under the frozen header row and, in a narrow box, starts past the cells' far edge), 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` |
|
|
1241
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 |
|
|
1242
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 |
|
|
1243
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) |
|