@aiquants/spreadsheet 0.8.0

package/src/Spreadsheet.tsx

@@ -0,0 +1,2313 @@
+/**
+ * @fileoverview Spreadsheet root: wiring only (§6.9). Owns the view store, the grid-handle
+ * scroll/range relays (onScroll / onRangeChange — the v0.3 applyHx seam is retired, hx is
+ * VirtualGrid-owned since v0.4), the setSelection wrapper (Object.is bail / selectionRef sync
+ * write / onSelectionChange / announcement evaluation / rearm point (c)), the imperative
+ * repaint paths (headers / column track / overlay) and the shared
+ * focus/rearm/moveActive/ensureCellVisible helpers; all logic lives in the layers below.
+ *
+ * Spreadsheet 統合ルート。結線のみ (§6.9)。viewStore・グリッドハンドル発のスクロール / レンジ
+ * 中継 (onScroll / onRangeChange — v0.3 の applyHx シームは退役、hx は v0.4 から VirtualGrid の
+ * 所有)・setSelection ラッパー (5 段)・命令再描画パス・共有ヘルパを所有し、ロジックは下位層に置く。
+ *
+ * Phase 3 まで結線済み: 選択エンジン + キーボード + オーバーレイ + live region + WCAG 脱出に
+ * 加え、編集セッション (useCellEditor) とクリップボード (useClipboard — 装填クリップ所有) を
+ * ref 間接シームで接続する。
+ *
+ * v0.8 (plan §4.2.13 — hook order per design v5): axis models → view store → zoom → 6
+ * autoscrollers (the 6th serves the reference drag) → selection engine → header machines ×2 →
+ * header resize → fill handle → point drag (usePointDrag) → the composite drag surface
+ * (isDraggingAny / abortDragAny / dragModeAny incl. "point") → cell editor → clipboard →
+ * popovers → commands → keyboard. The root owns the transaction counter and the single write
+ * funnel `commitEdits(edits, rejection, sheet?) → number | null`, the prop-time validations
+ * (labels Escape advisement, shortcuts, colour slots, band palette, CF-without-format), the
+ * conditional-format index / memo per (adapter, rules identity, renderVersion), the highlight
+ * state (controlled / uncontrolled), the pointing ref edges (editor → engine / headers / point
+ * drag / body / corner / zoom dead space), and the ref edges between commands / popovers /
+ * clipboard / keyboard (executeCommandRef / openPopoverRef / hideNoteTipRef / pasteRef /
+ * pendingPasteOptionsRef / popover anchors).
+ *
+ * v0.8 (計画 §4.2.13 — フック順は設計 v5): 軸モデル → viewStore → ズーム → オートスクローラー
+ * 6 台 (6 台目は参照ドラッグ用) → 選択エンジン → ヘッダー機械 ×2 → ヘッダーリサイズ → fill →
+ * 参照ドラッグ (usePointDrag) → 合成ドラッグ面 (isDraggingAny / abortDragAny / "point" 込みの
+ * dragModeAny) → エディタ → クリップボード → ポップオーバー → コマンド → キーボード。root は
+ * transaction 採番と単一書込漏斗 `commitEdits(edits, rejection, sheet?) → number | null`、prop 時
+ * 検証 (labels の Escape 告知 / shortcuts / 色スロット / 帯パレット / CF 単独宣言)、
+ * (adapter, 規則 identity, renderVersion) 毎の CF 索引 / memo、強調状態 (制御 / 非制御)、
+ * ポインティングの ref 辺 (editor → engine / ヘッダー / 参照ドラッグ / body / コーナー / ズーム死空間)、
+ * コマンド / ポップオーバー / クリップボード / キーボード間の ref 辺 (executeCommandRef /
+ * openPopoverRef / hideNoteTipRef / pasteRef / pendingPasteOptionsRef / ポップオーバーアンカー) を所有する。
+ */
+
+import type { VirtualGridHandle, VirtualGridRange } from "@aiquants/virtualscroll"
+import type { ProfilerOnRenderCallback } from "react"
+import { forwardRef, type ReactNode, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react"
+import type { PasteOptions } from "./clipboard/pasteSpecial.ts"
+import { type ClipInfo, type PasteOutcome, type PasteSheet, useClipboard } from "./clipboard/useClipboard.ts"
+import { type BorderPreset, type CommandRunner, useCommands } from "./commands/useCommands.ts"
+import { type SinkSnapshot, useCellEditor } from "./editor/useCellEditor.ts"
+import type { RenderCellContext } from "./grid/CellView.tsx"
+import { GridBody } from "./grid/GridBody.tsx"
+import { ColumnHeader } from "./header/ColumnHeader.tsx"
+import { columnIndexToName } from "./header/columnName.ts"
+import { RowHeader } from "./header/RowHeader.tsx"
+import { useHeaderResize } from "./header/useHeaderResize.ts"
+import { useHeaderSelection } from "./header/useHeaderSelection.ts"
+import { createEnsureCellVisible } from "./keyboard/ensureCellVisible.ts"
+import { type ShortcutOverrides, type SpreadsheetCommand, validateShortcuts } from "./keyboard/shortcuts.ts"
+import { type CommandDispatch, type MoveActiveInput, useGridKeyboard } from "./keyboard/useGridKeyboard.ts"
+import { useAxisModel } from "./model/axisModel.ts"
+import { type CellCommentInput, normalizeAdapterHyperlink } from "./model/cellAnnotations.ts"
+import { type CellCoord, type CellRange, clampCoord, makeRange, rangeSize, type SpreadsheetOperation } from "./model/cellCoord.ts"
+import { type CellBorder, type CellFormat, type CellFormatPatch, formatCellValue } from "./model/cellFormat.ts"
+import { type EditPaint, IDLE_EDIT_PAINT, normalizeColor, resolveEditPaint } from "./model/cellPaint.ts"
+import { buildCfIndex, type CfIndex, type CfMemo, createCfMemo, resolvePaintedFormat } from "./model/conditionalFormat.ts"
+import { type CellEdit, type EditContext, type EditRejection, type EditSource, lazyCellText, resolveCellAlign, type SpreadsheetDataAdapter } from "./model/dataAdapter.ts"
+import { type DataValidationRule, type ValidationVerdict, validateCellText } from "./model/dataValidation.ts"
+import type { ReferenceAxis } from "./model/formulaRefs.ts"
+import { colToViewportX, rowToViewportY } from "./model/frozenPartition.ts"
+import { resolveLabels, type SpreadsheetLabelOverrides } from "./model/labels.ts"
+import { createViewStore, type ViewStore } from "./model/viewStore.ts"
+import { DEFAULT_HIGHLIGHT_COLORS, type DragFrameMode, type HighlightColors, type HighlightState, type ResizeGuide, SelectionOverlay } from "./overlay/SelectionOverlay.tsx"
+import { useFillHandle } from "./overlay/useFillHandle.ts"
+import { PopoverLayer } from "./popover/PopoverLayer.tsx"
+import { type PopoverAnchorState, type PopoverContext, type PopoverController, type PopoverKind, type PopoverOpenOptions, type PopoverOverrides, usePopovers } from "./popover/usePopovers.ts"
+import { reduceActiveCycle, reduceSelectionExtend, reduceSelectionPress, type SelectionState, selectionStateEquals } from "./selection/selectionState.ts"
+import { useAutoScroller } from "./selection/useAutoScroller.ts"
+import { type PointDragOwner, usePointDrag } from "./selection/usePointDrag.ts"
+import { useSelectionEngine } from "./selection/useSelectionEngine.ts"
+
+export type { SelectionState } from "./selection/selectionState.ts"
+
+/**
+ * Options for the programmatic {@link SpreadsheetHandle.scrollToCell} jump — the render-surface
+ * pass-through of the engine's cell-targeted scroll (alignX uses start/end/center, alignY uses
+ * top/bottom/center; a frozen column/row target is a no-op on that axis). Selection is NOT
+ * changed — this is a pure viewport jump.
+ * 命令的セルジャンプ ({@link SpreadsheetHandle.scrollToCell}) のオプション (エンジンのセル狙い
+ * スクロールの素通し)。alignX は start / end / center、alignY は top / bottom / center。凍結列 /
+ * 行狙いは当該軸で no-op。選択は変えない純粋な viewport ジャンプ。
+ * 明示構造型で宣言する (api-extractor は NonNullable<Parameters<...>> 派生を d.ts ロールアップ
+ * できず build が落ちる) — エンジン型との双方向一致は Spreadsheet.spec.tsx の型パリティガードが
+ * tsc で機械封印する (ズレたら型検査が即赤)。
+ */
+export type ScrollToCellOptions = { alignY?: "top" | "bottom" | "center"; alignX?: "start" | "end" | "center"; offsetX?: number; offsetY?: number }
+
+/** Imperative surface (§6.9-8). / 命令 API (§6.9-8)。 */
+export type SpreadsheetHandle = {
+    /** Row-height pair seam (§6.9-8). / 行高変更の対シーム。 */
+    resizeRow: (row: number, heightPx: number) => void
+    /** Column-width resize (§6.9-8). / 列幅変更。 */
+    resizeColumn: (col: number, widthPx: number) => void
+    /**
+     * Programmatic viewport jump to a cell (delegates to the engine's scrollToCell — the
+     * floor-and-pin jump API). Selection is unchanged; the deep grid stays reachable at any
+     * scale (10^9 px). No-op when the grid is unmounted; an out-of-range coordinate is clamped
+     * to the grid edge by the engine (a frozen-axis target is a no-op on that axis).
+     * セルへの命令的 viewport ジャンプ (エンジン scrollToCell へ委譲 — floor + アンカー張りの
+     * ジャンプ API)。選択は不変で、どの尺度 (10^9 px) でも深部到達性を保つ。グリッド未マウント時は
+     * no-op、軸域外の座標はエンジンがグリッド端へクランプ (凍結軸狙いは当該軸で no-op)。
+     */
+    scrollToCell: (cell: CellCoord, options?: ScrollToCellOptions) => void
+    /** Focuses the sink (`preventScroll` honoured) and re-arms the idle waiting protocol when no session is open (v0.8 §1.10). / シンクへフォーカス (preventScroll 尊重) + 非編集なら再武装 (v0.8 §1.10)。 */
+    focus: (options?: { preventScroll?: boolean }) => void
+    /** Runs a command exactly as its chord would (v0.8 §1.10); false = unavailable / gate or adapter rejection / commit-gate refusal. / コマンドをチョードと同じ経路で実行 (false = 不可 / 拒否)。 */
+    executeCommand: (command: SpreadsheetCommand) => boolean
+    /** Applies a format patch to every selected cell (source "format"); RangeError when getCellFormat is undeclared. / 選択全レンジへ書式パッチ (source "format")。getCellFormat 未宣言は RangeError。 */
+    applyFormat: (patch: CellFormatPatch) => boolean
+    /** Border preset over the selection (default border thin / BORDER_DEFAULT_COLOR). / 選択への罫線プリセット。 */
+    setBorders: (preset: BorderPreset, border?: CellBorder) => boolean
+    /** Writes the ACTIVE cell's hyperlink (normalised; null clears; source "annotate"). / active セルのリンク書込 (正規化、null で消去)。 */
+    setHyperlink: (url: string | null) => boolean
+    /** Writes the ACTIVE cell's note (null clears; source "annotate"). / active セルのノート書込。 */
+    setNote: (text: string | null) => boolean
+    /** Appends a comment to the ACTIVE cell's thread (existing ids kept + the id-less input, one `comments` patch). / active セルのスレッドへ 1 件追加 (既存 id 保持)。 */
+    addComment: (input: CellCommentInput) => boolean
+    /** Sets (or clears) the validation rule of every selected cell (source "annotate"). / 選択全セルの検証規則の設定 / 消去。 */
+    setValidation: (rule: DataValidationRule | null) => boolean
+    /** Menu-path paste (`navigator.clipboard.read`): "applied" = the adapter was called, "empty" = nothing written, "rejected" = refused (always when onClipboardUnavailable fired). / メニュー経路の貼り付け。 */
+    paste: (options: PasteOptions) => Promise<PasteOutcome>
+    /** The confirmed selection (imperative read). / 確定選択の命令読み。 */
+    getSelection: () => SelectionState
+    /** The adapter's BASE format of a cell (toolbar state) — the getCellFormat capability branch. / セルの base 書式 (getCellFormat の能力分岐)。 */
+    getBaseFormat: (cell: CellCoord) => CellFormat | undefined
+    /** base ⊕ conditional formats of a cell (the paint the user sees). / base ⊕ 条件付き書式 (描画される書式)。 */
+    getPaintedFormat: (cell: CellCoord) => CellFormat | undefined
+    /** Opens the in-place editor on the active cell WITHOUT the virtual-keyboard invitation. / active セルの編集開始 (仮想キーボード招待は上げない)。 */
+    startEdit: (mode: "edit" | "replace") => void
+    /** Opens a popover on the active cell; RangeError when `popovers[kind] === false` or the capability is undeclared. / active セルへポップオーバーを開く (無効 kind は RangeError)。 */
+    openPopover: (kind: PopoverKind) => void
+}
+
+/** Public props (v0.1.0 contract — §6.9). / 公開 props (v0.1.0 契約 — §6.9)。 */
+export type SpreadsheetProps = {
+    /**
+     * Identity-stable contract: replacing the adapter object means "sheet switch" and re-slices
+     * every visible cell. Do NOT recreate it per render.
+     * identity 安定契約 — 差し替えは「シート切替」(全再スライス)。毎レンダー生成は禁止。
+     */
+    adapter: SpreadsheetDataAdapter
+    defaultRowHeight?: number
+    /** Default column width (also the grid's Fenwick baseValue — behaviorOptions.defaultColWidth §7-8). Per-column widths are set via resizeColumn (the v0.3 initialColumnWidth eager initializer is retired). / 既定列幅 (グリッドの Fenwick baseValue も兼ねる §7-8)。列別幅は resizeColumn で設定 (v0.3 の initialColumnWidth eager 初期化は廃止)。 */
+    defaultColumnWidth?: number
+    /**
+     * Freezes the first N columns at the left edge (v0.5 — the VirtualGrid frozenLeadingCols
+     * pass-through; LIVE prop). Validation is the engine's fail-fast contract (integer in
+     * [0, 128] — RangeError otherwise; values beyond colCount freeze every column). Frozen
+     * columns stay visible at any horizontal scroll; scrollToCell / keyboard ensure-visible
+     * treat them as always-visible (horizontal no-op). A mid-flight change cancels every
+     * in-flight drag gesture without restore (R2 fix — press-time anchors belong to the OLD
+     * coordinate partition; mixing them with fresh post-change hit tests can commit fill
+     * writes into cells the user never targeted). Selection and the editing session survive.
+     * 先頭 N 列の左端凍結 (v0.5 — VirtualGrid frozenLeadingCols の素通し。ライブ prop)。検証は
+     * エンジンの fail-fast 契約 ([0, 128] 整数、colCount 超過は全列凍結)。凍結列は横スクロール
+     * 位置に依らず常時可視で、scrollToCell / キーボード可視化の横成分は no-op。飛行中の変更は
+     * 全ドラッグジェスチャを復元なしで取り消す (R2 是正 — 押下時アンカーは旧パーティション
+     * 座標系。変更後の鮮度ヒットテストと混ざると狙っていないセルへの fill 確定になる)。選択と
+     * 編集セッションは保持。
+     */
+    frozenColumns?: number
+    /**
+     * Freezes the first N rows at the top (v0.6 — the VirtualGrid frozenLeadingRows pass-through;
+     * LIVE prop). Same engine fail-fast contract ([0, 128] integer; > rowCount freezes all).
+     * Frozen rows stay visible at any vertical scroll; scrollToCell / ensure-visible treat them
+     * as always-visible (vertical no-op). A mid-flight change cancels every in-flight drag.
+     * 先頭 N 行の上端凍結 (v0.6 — VirtualGrid frozenLeadingRows の素通し。ライブ prop)。エンジンの
+     * fail-fast 契約 ([0, 128] 整数、rowCount 超過は全行凍結) は列と同文。凍結行は縦スクロール
+     * 位置に依らず常時可視で、可視化の縦成分は no-op。飛行中の変更は全ドラッグを取り消す。
+     */
+    frozenRows?: number
+    /**
+     * Identity-stable contract (same as adapter): an inline arrow here defeats the CellView memo
+     * and turns every host re-render into a full visible re-slice (~800 cells at 16k columns).
+     * identity 安定契約 — インライン関数は memo を無効化し毎レンダー全再スライスになる。
+     */
+    renderCell?: (ctx: RenderCellContext) => ReactNode
+    /**
+     * Fires on every confirmed SelectionState change (press replace, extend confirm, cycling,
+     * paste replace, Ctrl+A, ...). Never during a drag (state frozen — one fire at pointerup),
+     * with ONE documented in-drag firing point: the header subtract reservation converts to a
+     * real press on the first movement, firing the deferred press replace mid-drag (total fire
+     * count matches v0.1 — conversion 1 + up 1). Never for the initial A1 mount. Independent
+     * of the live region's 200ms debounce (firing point: the §6.9-1 setSelection wrapper).
+     * 確定 SelectionState が変わるたびに発火。ドラッグ中と初期マウントでは発火しない。明文の
+     * ドラッグ中発火点が 1 つ: ヘッダー減算予約の実 press 変換 (初動 move) は遅延 press 置換を
+     * ドラッグ中に発火する (発火総数は v0.1 と同一 — 変換 1 + up 1)。
+     */
+    onSelectionChange?: (selection: SelectionState) => void
+    /** Consumer context menu (§6.4.3-4 / §6.6.1 Shift+F10); keyboard origin carries the active cell viewport rect. / consumer コンテキストメニュー。 */
+    onCellContextMenu?: (cell: CellCoord, origin: { kind: "pointer"; event: MouseEvent } | { kind: "keyboard"; cellRect: { top: number; left: number; width: number; height: number } }) => void
+    /** Undo request relay (history lives in the consumer — ADR-6). / Undo 要求の中継。 */
+    onUndoRequest?: () => void
+    /** Redo request relay. / Redo 要求の中継。 */
+    onRedoRequest?: () => void
+    /** Multi-range copy notice: copy/cut acts on the tail range only and fires this (documented deviation — Excel rejects non-aligned multi-range copy; aligned concat-copy is unsupported). / 複数レンジコピー通知 (末尾レンジのみ実行 + 通知の明示逸脱)。 */
+    onCopyMultiRange?: () => void
+    /** Rejection notice with reason: "limit" = maxOperationCells exceeded (ADR-12; resize row fan-out gates at maxOperationCells / 10 and autofit at / 4 — §13 design returns), "bounds" = cut-move clipped at the grid edge (§6.5.4-4) OR a row resize that would push the axis-wide hidden-row total past 1,000 (§5.4(b)). 3-arg from v0.1.0 (adding later is breaking). / 拒否理由つき通知 ("bounds" は cut-move の格子端クリップと行非表示軸総数ゲートの 2 系統)。 */
+    onOperationRejected?: (op: SpreadsheetOperation, cellCount: number, reason: "limit" | "bounds") => void
+    /**
+     * Edit rejection notice — fires once per rejected applyEdits with the thrown error and the
+     * {@link EditRejection} context: which write path was refused (edit / paste / fill / delete —
+     * a cut-move is the Ctrl+V gesture and reports "paste", the same name onOperationRejected
+     * uses for it) and, for an in-cell commit, whether the editing session is KEPT (in-grid commit —
+     * it stays open with the typed value and focus; Escape cancels, or the value can be fixed)
+     * or DISCARDED (grid-exit focusout — the grid closes it as this rejection completes: once
+     * the callback returns the typed value is gone and the sink re-armed WITHOUT moving focus,
+     * which stays wherever the focusout left it — on the element the user chose, or still on the
+     * hidden input after a window blur). Consumers should word their notice from that context; telling the user to
+     * "press Escape" after a discarded session is wrong (an idle Escape hands focus out of the
+     * grid — WCAG 2.1.2).
+     * 編集拒否通知 — 拒否された applyEdits ごとに 1 回、throw されたエラーと
+     * {@link EditRejection} 文脈 (拒否経路 edit / paste / fill / delete — cut-move は Ctrl+V の
+     * ジェスチャで onOperationRejected と同じ "paste" — と、セル内確定なら
+     * セッションが**維持** (グリッド内確定 — 入力値とフォーカスごと開いたまま。Escape で取消 /
+     * 修正可) か**破棄** (グリッド外 focusout — この拒否の完了と同時にグリッドが閉じる:
+     * コールバックが返った時点で入力値は消え、シンクはフォーカスを動かさずに再武装 — フォーカスは
+     * focusout が残した場所 (ユーザーが選んだ要素、ウィンドウ blur なら隠し入力のまま) にある) か)
+     * を届ける。消費者は文脈に沿って文言を組む — 破棄済みで「Escape を押せ」は誤案内 (待機中の
+     * Escape は WCAG 2.1.2 のフォーカス脱出)。
+     */
+    onEditRejected?: (error: unknown, rejection: EditRejection) => void
+    /** Change notice for out-of-package writes (undo / collaboration); each increment repaints visible cells (§6.9-2). / パッケージ外経路のデータ変更通知。 */
+    dataVersion?: number
+    /** Operation cell-count ceiling, default 100,000 (ADR-12). / 操作セル数上限。 */
+    maxOperationCells?: number
+    /**
+     * §11 opt-out (default true): false suppresses the fill-handle node AND inerts its
+     * machine. Fill is a WRITE operation (applyEdits) — read-only adapters opt out to avoid
+     * the onEditRejected UX on every fill attempt.
+     * §11 の opt-out (既定 true)。false はハンドルノードごと非表示 + 機械不活性。fill は書込系
+     * (applyEdits) — 読み取り専用 adapter は毎回の onEditRejected UX を避けるため false にする。
+     */
+    enableFillHandle?: boolean
+    /**
+     * §11 opt-out (default true): false suppresses the resize strip / unhide marker DOM
+     * entirely (track children, not resident nodes) and inerts the band listeners. NOTE:
+     * false also removes the unhide markers — a consumer with hidden tracks loses the
+     * in-package restore affordance (imperative resize API only).
+     * §11 の opt-out (既定 true)。false はストリップ / マーカーの DOM 生成ごと抑止 + 帯リスナー
+     * 不活性。注意: unhide マーカーも消える — 非表示トラックを持つ consumer はパッケージ内の
+     * 復元手段を失う (命令 API のみ)。
+     */
+    enableResizeUI?: boolean
+    /**
+     * AT announcement text for the active cell; omit for silence (no built-in strings). `text`
+     * is the RAW canonical getCellText; `displayText` is what a sighted user sees (the
+     * getCellFormat-formatted string — equals `text` when the cell has no format), so AT can
+     * hear "87.0%" for a cell whose raw value is "0.87".
+     * AT 向け読み上げ文言 (省略で無音)。`text` は素の正準 getCellText、`displayText` は目視と同じ
+     * 表示文字列 (getCellFormat 整形後 — 書式なしセルでは text と同値)。素値 "0.87" の表示
+     * "87.0%" をそのまま読み上げられる。
+     */
+    formatCellAnnouncement?: (ctx: { row: number; col: number; text: string; displayText: string; columnName: string }) => string
+    /** AT announcement for the selection extent ("A1 to C3, 3 rows 3 cols"); omit for silence. / AT 向け選択範囲読み上げ。 */
+    formatSelectionAnnouncement?: (ctx: { range: CellRange; anchor: CellCoord; active: CellCoord; rangeRowCount: number; rangeColCount: number; rangeCount: number }) => string
+    /**
+     * Opt-in AT feedback for commands (v0.8 §1.9): `state` is the toggle's post-state, `null`
+     * for non-toggle commands; the text goes to the live region like the other announcements.
+     * コマンドの AT 通知 (opt-in、v0.8 §1.9)。`state` はトグル後状態 (非トグルは null)。live region へ。
+     */
+    formatCommandAnnouncement?: (ctx: { command: SpreadsheetCommand; state: boolean | null }) => string
+    /**
+     * UI label vocabulary (v0.8 §1.6) — folds the former `sinkAriaLabel` / `rootAriaLabel` props
+     * (clean cut-over). An omitted or explicitly `undefined` key keeps the English default. The
+     * resolved `sinkAriaLabel` MUST mention "Escape" (WCAG 2.1.2 escape advisement, §10-4) — a
+     * RangeError is thrown during render otherwise.
+     * UI ラベル語彙 (v0.8 §1.6) — 旧 sinkAriaLabel / rootAriaLabel prop を畳込み (クリーンカットオーバー)。
+     * 省略 / 明示 undefined は英語既定。解決後の sinkAriaLabel は "Escape" を含むこと (違反は render 中
+     * RangeError — §10-4)。
+     */
+    labels?: SpreadsheetLabelOverrides
+    /**
+     * Rebindable command chords (v0.8 §1.9 / ADR-17): an array REPLACES that command's default
+     * list, `null` unbinds it. Validated at prop time — a non-canonical chord, a modifier-less
+     * chord, a single string, an override of a non-rebindable row (`pasteSpecial`), a clash with
+     * a non-rebindable built-in row in the command's column, or one chord bound to two commands
+     * throws a RangeError during render (`clampZoom` precedent). Consulted through a ref.
+     * 再バインド可能なコマンドチョード (v0.8 §1.9 / ADR-17)。配列は既定一覧の置換、null は未束縛。
+     * prop 時検証 (非正準 / 修飾なし / 単一 string / 非再バインド行の上書き / 列内予約行との一致 /
+     * 二重束縛は render 中 RangeError)。ref 経由で参照。
+     */
+    shortcuts?: ShortcutOverrides
+    /**
+     * Custom colour slots for `fillColorCustom1..5` / `fontColorCustom1..5`: each axis is exactly
+     * 5 `#rrggbb` strings (a different length or a non-hex entry throws a RangeError at prop
+     * time); an omitted axis uses DEFAULT_CUSTOM_COLORS.
+     * 塗り / 文字色のカスタム 5 スロット (各軸ちょうど 5 本の `#rrggbb` — 本数違い / 非 hex は prop 時
+     * RangeError。省略軸は DEFAULT_CUSTOM_COLORS)。
+     */
+    colors?: { readonly fill?: readonly string[]; readonly font?: readonly string[] }
+    /**
+     * Host currency / locale for `formatCurrency` and for bare currency symbols in pasted HTML;
+     * undeclared ⇒ the `formatCurrency` row passes through and bare symbols are not recovered.
+     * `formatCurrency` と貼り付け HTML の裸通貨記号復元に使う通貨 / locale。未宣言なら `formatCurrency`
+     * 行は素通しで、裸記号は復元しない。
+     */
+    formats?: { readonly currency: string; readonly locale?: string }
+    /**
+     * Highlight bands of the selection (v0.8 §2.4): controlled value — the same two-phase
+     * contract as `zoom`. Default (both props omitted) is all off ⇒ zero band nodes (v0.7 DOM
+     * identity). Repainted imperatively on change.
+     * 選択の強調帯 (v0.8 §2.4) の制御値 (zoom と同型の二相契約)。両 prop 省略時は全 off = 帯ノード 0
+     * (v0.7 DOM 恒等)。変更は命令再描画。
+     */
+    highlight?: HighlightState
+    /** Initial highlight state for the uncontrolled mode. / 非制御モードの初期強調状態。 */
+    defaultHighlight?: HighlightState
+    /** Fires when a highlight toggle command requests a new state (a controlled consumer applies it). / 強調トグルコマンドの変更要求通知 (制御 consumer が反映)。 */
+    onHighlightChange?: (highlight: HighlightState) => void
+    /**
+     * Band colours + opacity — identity-stable; written to `--aqsp-band-row / -column /
+     * -intersection / -opacity` on the overlay in a layout effect. Each colour must parse
+     * (`normalizeColor`) and `opacity` must be a finite number in [0, 1] — RangeError at prop time
+     * otherwise. Undeclared ⇒ nothing is written while every band is off (the overlay's style
+     * attribute stays byte-identical to v0.7) and DEFAULT_HIGHLIGHT_COLORS (`#0084FF` / `#42FF4F` /
+     * `#E1FF00` / 0.2) is written once a band turns on.
+     * 帯の色 3 種 + 不透明度 (identity 安定、layout effect で `--aqsp-band-*` へ)。解釈不能な色 /
+     * [0, 1] 外の不透明度は prop 時 RangeError。未宣言なら全 off の間は何も書かず (overlay の style は
+     * v0.7 と byte 同一)、帯が on になった時点で DEFAULT_HIGHLIGHT_COLORS を書く。
+     */
+    highlightColors?: HighlightColors
+    /** Per-kind popover opt-out (v0.8 §1.8): `false` ⇒ that kind's commands pass through and `openPopover(kind)` throws a RangeError. / kind 別ポップオーバー opt-out (false は素通し + openPopover は RangeError)。 */
+    popovers?: PopoverOverrides
+    /** Replaces the default popover components (receives the kind-discriminated context). / 既定ポップオーバーの差替え (kind 判別文脈を受ける)。 */
+    renderPopover?: (ctx: PopoverContext) => ReactNode
+    /** Clip state notice: armed (`foreign: false`), discarded (`null`), or a cut kept across a sheet switch (`foreign: true`). / クリップ状態通知 (武装 / 破棄 / シート切替を跨いだ cut は foreign)。 */
+    onClipChange?: (clip: ClipInfo | null) => void
+    /** Hyperlink navigation seam (Alt+Enter, the link popover's Open button, and Ctrl / Meta+click on a link cell — spec 08 §11 D-53) — undeclared ⇒ no navigation, no Open button, no pointer gesture. / ハイパーリンク遷移シーム (Alt+Enter / Open ボタン / リンクセルへの Ctrl / Meta+クリック — 分冊 08 §11 D-53)。未宣言 = 遷移なし・Open ボタンなし・ポインタジェスチャなし。 */
+    onHyperlinkOpen?: (url: string, cell: CellCoord) => void
+    /** Strict validation rejection notice (v0.8 §1.9) — the commit never reaches the adapter; the message popover shows the rejection. / strict 検証拒否の通知 (commit はアダプタへ届かず、message ポップオーバーが拒否を示す)。 */
+    onValidationRejected?: (ctx: { cell: CellCoord; rule: DataValidationRule; text: string; message: string }) => void
+    /** Ctrl+Alt+V request with the active cell's viewport rect (visual px, keyboard-origin shape of onCellContextMenu); undeclared ⇒ `paste({ mode: "formats" })`. / Ctrl+Alt+V の要求通知 (未宣言なら書式のみ貼り付け)。 */
+    onPasteSpecialRequest?: (origin: { kind: "keyboard"; cellRect: { top: number; left: number; width: number; height: number } }) => void
+    /** Menu-path clipboard refusal channel; whenever it fires `paste()` resolves "rejected". / メニュー経路の拒否通知 (発火時 `paste()` は必ず "rejected")。 */
+    onClipboardUnavailable?: (cause: "insecure-origin" | "permission-denied" | "empty" | "unreadable") => void
+    /** Clock seam for `insertDate` / `insertTime` (declared default: Date.now). / insertDate / insertTime の時計シーム (宣言済み既定 Date.now)。 */
+    now?: () => number
+    /**
+     * Package-level zoom (v0.3): controlled value, clamped to [0.25, 4]. The grid scales
+     * visually (transform) while ALL logic stays in logical px; both scrollbars compensate
+     * ancestor scale natively. Omit for the uncontrolled mode (defaultZoom + gestures).
+     * パッケージズーム (v0.3)。制御値 ([0.25, 4] clamp)。視覚は transform スケール、論理は
+     * 論理 px のまま (両スクロールバーは祖先スケール補正内蔵)。省略時は非制御 (defaultZoom +
+     * ジェスチャ)。
+     */
+    zoom?: number
+    /** Initial zoom for the uncontrolled mode (default 1). / 非制御時の初期ズーム (既定 1)。 */
+    defaultZoom?: number
+    /**
+     * Fires when a zoom gesture (Alt+Wheel / Ctrl+Alt+= / Ctrl+Alt++ / Ctrl+Alt+- / Ctrl+Alt+0) requests a
+     * new zoom — in the controlled mode the consumer applies it (the gesture alone does not
+     * change the view). All four keys match on the PRODUCED character (event.key) regardless
+     * of Shift, so layouts that need Shift to type them work as-is (JIS `=` = Shift+`-`,
+     * US `+` = Shift+`=`, AZERTY `0` = Shift+`à`); mismatching shifted characters (US `_`, `)`)
+     * pass through. Chords carrying the AltGraph modifier state are never claimed (defense in
+     * depth: evergreen browsers deliver real AltGr characters WITHOUT ctrl+alt, so typing e.g.
+     * Latvian AltGr+F `=` never hits this handler; the guard shields legacy AltGr-emulation
+     * shapes only). Gestures are IGNORED while any drag is in
+     * flight (press-time rect caches would skew); a controlled consumer changing `zoom`
+     * mid-drag inherits that skew. Ctrl+Wheel is deliberately NOT bound (the browser owns it).
+     * ズームジェスチャ (Alt+ホイール / Ctrl+Alt+= / + / − / 0 — 4 キーとも Shift 非依存で生成
+     * 文字 event.key を信頼、AltGraph 修飾状態つきは非請求の多層防御 — 実 AltGr 印字は
+     * 修飾なしで届き本ガード非依存) の変更要求通知 — 制御モードでは
+     * consumer が反映する (ジェスチャ単独では変わらない)。飛行中ドラッグの間は要求を無視
+     * (押下時 rect キャッシュが歪むため。制御 consumer がドラッグ中に zoom prop を変えた場合は
+     * 同じ歪みを負う)。Ctrl+ホイールは意図的に非束縛 (ブラウザ所有)。
+     */
+    onZoomChange?: (zoom: number) => void
+    testId?: string
+    className?: string
+}
+
+/** Zoom clamp bounds (v0.3) — the 0.1 gesture grid lives in stepZoom's ×10 integer arithmetic. / ズームの clamp 境界 (v0.3) — ジェスチャの 0.1 グリッドは stepZoom の ×10 整数算術側。 */
+const ZOOM_MIN = 0.25
+const ZOOM_MAX = 4
+
+/**
+ * Pure clamp — NO quantization (a 0.25 bound is not 0.1-quantizable; consumers may set any
+ * value like 1.25). Gestures quantize their own arithmetic before requesting. Non-finite
+ * input (NaN / ±Infinity) fail-fasts: Math.min/max would propagate NaN through every ÷z
+ * boundary and defeat the same-value gesture bail (unsuppressed onZoomChange(NaN) spam).
+ * 純 clamp — 量子化しない (境界 0.25 は 0.1 量子化不能。consumer は 1.25 等の任意値を設定
+ * できる)。量子化はジェスチャ側が要求前に自分の加算へ適用する。非有限値 (NaN / ±Infinity) は
+ * fail-fast — Math.min/max は NaN を素通しし、全 ÷z 境界の汚染と同値バウンド無効化 (NaN 同士は
+ * 不一致) による onZoomChange(NaN) 連射を招くため。
+ */
+const clampZoom = (value: number): number => {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`[spreadsheet] zoom must be a finite number (got ${value})`)
+    }
+    return Math.min(ZOOM_MAX, Math.max(ZOOM_MIN, value))
+}
+
+/**
+ * 0.1-grid gesture step (float-drift-free). From an off-grid value (the 0.25 clamp bound or
+ * a controlled 1.25) the step lands on the NEAREST detent in the travel direction (0.25 →
+ * 0.3 / 0.2) — round-based arithmetic skipped a detent (0.25 → 0.4).
+ * ジェスチャの 0.1 グリッド刻み (float ドリフト遮断)。グリッド外の値 (clamp 境界 0.25 や制御
+ * 1.25) からは進行方向の最寄りデテントへ着地 (0.25 → 0.3 / 0.2) — 丸め方式はデテントを飛ばす
+ * (0.25 → 0.4) ため採らない。
+ */
+const stepZoom = (value: number, direction: 1 | -1): number => (direction > 0 ? (Math.floor(value * 10 + 1e-6) + 1) / 10 : (Math.ceil(value * 10 - 1e-6) - 1) / 10)
+
+/**
+ * Test-only seam props (NOT part of the public v0.1.0 contract — §8.2 counter injection).
+ * テスト専用シーム props (公開 v0.1.0 契約外 — §8.2 カウンタ注入)。
+ */
+type SpreadsheetTestProps = {
+    /** Test-only CellView re-render counter; never passed in production. / テスト専用カウンタ。 */
+    __onCellRender?: ProfilerOnRenderCallback
+}
+
+const DEFAULT_ROW_HEIGHT = 24
+const DEFAULT_COLUMN_WIDTH = 100
+const DEFAULT_MAX_OPERATION_CELLS = 100_000
+/** Live region debounce in ms (§6.9-9). / live region デバウンス (ms)。 */
+const ANNOUNCE_DEBOUNCE_MS = 200
+/** Default custom colour slots (v0.8 §1.9) for `fillColorCustom1..5` / `fontColorCustom1..5`. / カスタム色 5 スロットの既定 (v0.8 §1.9)。 */
+export const DEFAULT_CUSTOM_COLORS: readonly string[] = Object.freeze(["#FF0000", "#00FF00", "#0000FF", "#FFFF00", "#FF00FF"])
+/** Custom colour slot count per axis. / 軸ごとのカスタム色スロット数。 */
+const CUSTOM_COLOR_SLOTS = 5
+/** Strict `#rrggbb` spelling accepted for a custom colour slot. / カスタム色スロットの `#rrggbb` 綴り。 */
+const HEX_COLOR_RE = /^#[0-9A-Fa-f]{6}$/
+/** All-off highlight state (the default ⇒ zero band nodes). / 全 off の強調状態 (既定 = 帯ノード 0)。 */
+const DEFAULT_HIGHLIGHT: HighlightState = Object.freeze({ row: false, column: false, intersection: false })
+/** The shared accepting verdict of the root's validation gate. / 検証ゲートの共有 ok 判定。 */
+const OK_VERDICT: ValidationVerdict = Object.freeze({ ok: true })
+
+/**
+ * Resolves one custom colour axis: undefined ⇒ DEFAULT_CUSTOM_COLORS; otherwise exactly 5
+ * `#rrggbb` strings (fail-fast RangeError — no silent substitution of a bad slot).
+ * カスタム色 1 軸の解決: undefined は既定、それ以外はちょうど 5 本の `#rrggbb` (不正は RangeError)。
+ */
+const resolveColorSlots = (axis: "fill" | "font", slots: readonly string[] | undefined): readonly string[] => {
+    if (slots === undefined) {
+        return DEFAULT_CUSTOM_COLORS
+    }
+    // 本数はちょうど 5 (不足 / 超過は consumer の設定誤り)
+    if (slots.length !== CUSTOM_COLOR_SLOTS) {
+        throw new RangeError(`[spreadsheet] colors.${axis} must contain exactly ${CUSTOM_COLOR_SLOTS} colours (got ${slots.length})`)
+    }
+    // 各スロットは #rrggbb の綴りだけ (コマンドはこの綴りをそのまま書く)
+    for (const slot of slots) {
+        if (typeof slot !== "string" || !HEX_COLOR_RE.test(slot)) {
+            throw new RangeError(`[spreadsheet] colors.${axis} entries must be #rrggbb strings (got ${JSON.stringify(slot)})`)
+        }
+    }
+    return slots
+}
+
+/**
+ * Validates the band palette at prop time: every colour must parse and the opacity must be a
+ * finite number in [0, 1]. Returns the same object (identity kept for the overlay's effect).
+ * 帯パレットの prop 時検証: 色 3 種は解釈可能、不透明度は [0, 1] の有限数。同一 object を返す。
+ */
+const validateHighlightColors = (colors: HighlightColors): HighlightColors => {
+    for (const key of ["row", "column", "intersection"] as const) {
+        if (normalizeColor(colors[key]) === null) {
+            throw new RangeError(`[spreadsheet] highlightColors.${key} is not a colour (got ${JSON.stringify(colors[key])})`)
+        }
+    }
+    if (!(Number.isFinite(colors.opacity) && colors.opacity >= 0 && colors.opacity <= 1)) {
+        throw new RangeError(`[spreadsheet] highlightColors.opacity must be a number in [0, 1] (got ${colors.opacity})`)
+    }
+    return colors
+}
+
+/**
+ * The palette handed to the overlay: the declared (validated) palette whenever the consumer set
+ * `highlightColors`; DEFAULT_HIGHLIGHT_COLORS while any band is on without a declaration; undefined
+ * (no `--aqsp-band-*` write — the overlay's style attribute stays the v0.7 one) when nothing is
+ * declared and every band is off. Explicit branches, no `??`.
+ * overlay へ渡すパレット: consumer が `highlightColors` を宣言していればその検証済みパレット、未宣言でも
+ * 帯が 1 つでも on なら DEFAULT_HIGHLIGHT_COLORS、未宣言 + 全 off は undefined (`--aqsp-band-*` を書かず
+ * overlay の style は v0.7 のまま)。明示分岐で `??` は書かない。
+ */
+const resolveOverlayPalette = (declared: HighlightColors | undefined, highlight: HighlightState): HighlightColors | undefined => {
+    // 宣言済みパレットは強調状態に依らず overlay へ (prop 時検証済み・identity 安定)
+    if (declared !== undefined) {
+        return declared
+    }
+    // 未宣言: 帯が 1 つでも on なら既定パレット、全 off は書込なし (v0.7 DOM 恒等)
+    if (highlight.row || highlight.column || highlight.intersection) {
+        return DEFAULT_HIGHLIGHT_COLORS
+    }
+    return undefined
+}
+
+/**
+ * A paste commit MUST carry its sheet context (ADR-16) — a missing one is a wiring bug of the
+ * caller, refused before anything is allocated.
+ * 貼り付け commit はシート文脈必須 (ADR-16) — 欠落は呼び手の結線バグで、採番前に拒否する。
+ */
+const requirePasteSheet = (sheet: PasteSheet | undefined): PasteSheet => {
+    if (sheet === undefined) {
+        throw new RangeError("[spreadsheet] commitEdits: a paste commit requires its sheet context (sameSheet / conditionalFormats)")
+    }
+    return sheet
+}
+
+/** Initial A1 selection. / 初期 A1 選択。 */
+const INITIAL_SELECTION: SelectionState = {
+    ranges: [makeRange({ row: 0, col: 0 }, { row: 0, col: 0 })],
+    anchor: { row: 0, col: 0 },
+    active: { row: 0, col: 0 },
+}
+
+/**
+ * The spreadsheet root component (wiring only).
+ * スプレッドシート統合ルート (結線のみ)。
+ */
+export const Spreadsheet = forwardRef<SpreadsheetHandle, SpreadsheetProps & SpreadsheetTestProps>(function Spreadsheet(
+    {
+        adapter,
+        defaultRowHeight = DEFAULT_ROW_HEIGHT,
+        defaultColumnWidth = DEFAULT_COLUMN_WIDTH,
+        frozenColumns = 0,
+        frozenRows = 0,
+        renderCell,
+        onSelectionChange,
+        onCellContextMenu,
+        onUndoRequest,
+        onRedoRequest,
+        onCopyMultiRange,
+        onOperationRejected,
+        onEditRejected,
+        dataVersion,
+        maxOperationCells = DEFAULT_MAX_OPERATION_CELLS,
+        enableFillHandle = true,
+        enableResizeUI = true,
+        formatCellAnnouncement,
+        formatSelectionAnnouncement,
+        formatCommandAnnouncement,
+        labels,
+        shortcuts,
+        colors,
+        formats,
+        highlight,
+        defaultHighlight,
+        onHighlightChange,
+        highlightColors,
+        popovers: popoversProp,
+        renderPopover,
+        onClipChange,
+        onHyperlinkOpen,
+        onValidationRejected,
+        onPasteSpecialRequest,
+        onClipboardUnavailable,
+        now = Date.now,
+        zoom,
+        defaultZoom,
+        onZoomChange,
+        testId,
+        className,
+        __onCellRender,
+    }: SpreadsheetProps & SpreadsheetTestProps,
+    ref,
+): ReactNode {
+    // §6.9-1: フックは常に呼び、空グリッドはレンダー分岐でのみ返す (indexAt fail-fast の前提)
+    const rowAxis = useAxisModel(adapter.rowCount, defaultRowHeight)
+    const colAxis = useAxisModel(adapter.colCount, defaultColumnWidth)
+
+    // viewStore は遅延初期化 (useRef(createViewStore()) は毎レンダーでストアを作って捨てる)
+    const viewStoreRef = useRef<ViewStore | null>(null)
+    if (viewStoreRef.current === null) {
+        viewStoreRef.current = createViewStore()
+    }
+    const viewStore = viewStoreRef.current
+
+    // ---- prop 時検証 (v0.8 §4.2.13 — clampZoom と同じく render 中に RangeError を投げる) ----
+    // ラベルの畳込み: resolveLabels が Escape 告知 (§10-4) を検証する (RC22)
+    const resolvedLabels = useMemo(() => resolveLabels(labels), [labels])
+    // コマンド表: validateShortcuts の 5 条件 (+ 未知キー) は consumer の設定誤り — render 中に表面化
+    const commandTable = useMemo(() => validateShortcuts(shortcuts), [shortcuts])
+    // カスタム色スロット (各軸ちょうど 5 本の #rrggbb)
+    const resolvedColors = useMemo(() => ({ fill: resolveColorSlots("fill", colors === undefined ? undefined : colors.fill), font: resolveColorSlots("font", colors === undefined ? undefined : colors.font) }), [colors])
+    // 帯パレットの prop 時検証 (identity 安定): 宣言時だけ検証し、未宣言は undefined のまま — overlay へ渡す
+    // パレットは強調状態が決まってから resolveOverlayPalette で導出する
+    const declaredHighlightColors = useMemo(() => (highlightColors === undefined ? undefined : validateHighlightColors(highlightColors)), [highlightColors])
+    // 条件付き書式は getCellFormat の上に載る能力 (design v4 §2.3): 単独宣言は塗る先が無い結線誤り
+    if (adapter.getConditionalFormats !== undefined && adapter.getCellFormat === undefined) {
+        throw new RangeError("[spreadsheet] getConditionalFormats requires getCellFormat")
+    }
+
+    // ---- renderVersion (editVersion 購読 + dataVersion) と CF 索引 / memo (v0.8 §2.1) ----
+    // GridBody と同じ合流購読 (rAF 合流) — 親が先に描画するため、子のスライスが読む .current は常に新
+    const getEditSnapshot = useCallback(() => viewStore.get().editVersion, [viewStore])
+    const subscribeEdit = useCallback((listener: () => void) => viewStore.subscribeCoalesced(listener), [viewStore])
+    const editVersion = useSyncExternalStore(subscribeEdit, getEditSnapshot, getEditSnapshot)
+    const renderVersion = editVersion + (dataVersion === undefined ? 0 : dataVersion)
+    // 規則配列は identity 安定契約 (変更は dataVersion で公開) — 能力分岐で null、?? は書かない
+    const cfRules = adapter.getConditionalFormats === undefined ? null : adapter.getConditionalFormats()
+    // (adapter, 規則 identity, renderVersion) 毎に索引 1 回構築 (O(1)、バケットは遅延) + memo 新規
+    const cfState = useMemo(() => {
+        // adapter / renderVersion は memo キーとしてだけ参照する (同じ規則配列でもシート切替 / 編集で極値・数式 memo は捨てる)
+        void adapter
+        void renderVersion
+        return { index: cfRules === null ? null : buildCfIndex(cfRules), memo: createCfMemo() }
+    }, [adapter, cfRules, renderVersion])
+    // GridBody / エディタ / autofit が .current で鮮度読みする ref (レンダー時代入 — paramsRef と同じ規律)
+    const cfIndexRef = useRef<CfIndex | null>(cfState.index)
+    cfIndexRef.current = cfState.index
+    const cfMemoRef = useRef<CfMemo>(cfState.memo)
+    cfMemoRef.current = cfState.memo
+    /** base ⊕ CF of a cell through the single seam (getCellFormat capability branch is the caller's). / セルの base ⊕ CF (単一シーム — getCellFormat の能力分岐は呼び手)。 */
+    const paintedFormatOf = useCallback((row: number, col: number, readText: () => string): CellFormat | undefined => resolvePaintedFormat(adapter, cfIndexRef.current, cfMemoRef.current, row, col, readText), [adapter])
+
+    const rootRef = useRef<HTMLDivElement | null>(null)
+    // ---- ズーム (v0.3): 制御 (zoom prop) / 非制御 (内部 state) の標準二相。実効値は常に clamp ----
+    const [internalZoom, setInternalZoom] = useState(() => clampZoom(defaultZoom ?? 1))
+    const zoomValue = clampZoom(zoom ?? internalZoom)
+    const zoomRef = useRef(zoomValue)
+    zoomRef.current = zoomValue
+    // ジェスチャ連打はレンダーフラッシュ前に複数イベントが届く — zoomRef (レンダー同期 = 実効値)
+    // だけを基点にすると 2 発目が古い値から刻んで段飛ばし + 同値 onZoomChange の二重発火になる。
+    // 要求済み値を先行追跡し、レンダーで実効値へ再同期する (制御モードで親が要求を拒否しても
+    // 次レンダーで実値へ復帰)。機械側の ÷z / ×z は実効値 zoomRef のみを読む — 混用しない
+    const requestedZoomRef = useRef(zoomValue)
+    requestedZoomRef.current = zoomValue
+    /** Drag-flight probe indirection (filled after the machines mount). / 飛行中ドラッグ照会の間接 ref (機械構築後に充填)。 */
+    const isDraggingAnyRef = useRef<(() => boolean) | null>(null)
+    const onZoomChangeRef = useRef(onZoomChange)
+    onZoomChangeRef.current = onZoomChange
+    const zoomControlledRef = useRef(zoom !== undefined)
+    zoomControlledRef.current = zoom !== undefined
+    /** Applies a gesture's zoom request (controlled mode only notifies). / ジェスチャのズーム要求適用 (制御モードは通知のみ)。 */
+    const requestZoom = useCallback((next: number) => {
+        const clamped = clampZoom(next)
+        if (clamped === requestedZoomRef.current) {
+            return
+        }
+        requestedZoomRef.current = clamped
+        if (!zoomControlledRef.current) {
+            setInternalZoom(clamped)
+        }
+        onZoomChangeRef.current?.(clamped)
+    }, [])
+    // ズームジェスチャ (v0.3): Alt+ホイールと Ctrl+Alt+= / + / − / 0。Ctrl+ホイールはブラウザ所有の
+    // ため意図的に非束縛。wheel は React 合成でなく native 非 passive で張る (preventDefault 必須)。
+    // 空グリッド分岐の div は rootRef を持たない — 空 → 非空遷移で deps が変わり実 DOM が揃った後に
+    // 再結線する (キーボード hook の enabled 規律と同型。これ無しでは空マウント時の null bail が
+    // 恒久固定され、ジェスチャが永久に死ぬ — R2(E) blocking)
+    const isEmpty = adapter.rowCount === 0 || adapter.colCount === 0
+    const zoomGestureEnabled = !isEmpty
+    useEffect(() => {
+        const root = rootRef.current
+        if (!zoomGestureEnabled || root === null) {
+            return
+        }
+        const onWheel = (event: WheelEvent) => {
+            // 外側 (document / window の capture 段はここより先に走る) が請求済みのイベントは
+            // 尊重して素通し — シンクキーマップの defaultPrevented 規律の対称
+            if (event.defaultPrevented) {
+                return
+            }
+            if (!event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) {
+                return
+            }
+            // 縦成分ゼロ (チルトホイール / 横パン) はズーム意図でない — 消費せず素通しし、
+            // 横スクロールをブラウザへ返す (0 を負方向に丸めるとズームアウト誤発動 + 横パン窃取)
+            if (event.deltaY === 0) {
+                return
+            }
+            // 認識した Alt+ホイールは preventDefault + stopPropagation で完全請求する。役割は
+            // 別々: 「スクロール余地面での恒久死」(R8(E) blocking) を防ぐのは capture 段配置
+            // (バブル段だとペインが先に preventDefault し尊重ガードが自ペインを外部請求と誤認)、
+            // stopPropagation はその上でペイン (Ctrl のみ免除・defaultPrevented 非考慮の wheel
+            // 消費) と 3 本の wheel ブリッジへ後続配送させない唯一の防壁 — 落とすとズームは
+            // 効くが**スクロールも同時に走る二重実行**へ退行する ([M156])
+            event.preventDefault()
+            event.stopPropagation()
+            // 飛行中ドラッグの押下時 gBCR キャッシュは倍率変更で歪む — ドラッグ中は要求ごと無視
+            // (請求は維持 — スクロールへも流さない)
+            if (isDraggingAnyRef.current?.()) {
+                return
+            }
+            requestZoom(stepZoom(requestedZoomRef.current, event.deltaY < 0 ? 1 : -1))
+        }
+        const onKeyDown = (event: KeyboardEvent) => {
+            // 外側請求済みは素通し (wheel 側と同じ規律 — ホストの capture ショートカットと二重発火しない)
+            if (event.defaultPrevented) {
+                return
+            }
+            if (!(event.ctrlKey && event.altKey) || event.metaKey) {
+                return
+            }
+            // AltGraph 状態つきの ctrl+alt は文字入力側へ譲る**多層防御** — evergreen ブラウザ
+            // (Chromium 68+ / Firefox 63+) は AltGr と Ctrl/Alt を相互排他にするため実 AltGr
+            // 印字は修飾なしで届き本ガードに依存しない (R3(I) がエンジン一次資料で確定)。守るのは
+            // レガシー AltGr エミュレーション形状 (旧 Firefox / 合成イベント / 非準拠組込ホスト)
+            // のみ — その形状ではラトビア語 (`=` = AltGr+F のみ) 等でズーム請求が入力を奪い得る。
+            // 挙動コストゼロ (リテラル Ctrl+Alt 和音は AltGraph を持たない) のため維持
+            //  ([M176] は現実形状で等価変異 — ⚠️ 登記、台帳 Phase I)
+            if (event.getModifierState("AltGraph")) {
+                return
+            }
+            // ズームキー以外は素通し。認識したジェスチャは常に消費し、飛行中ドラッグは効果のみ
+            // 無視 (wheel 側と同じ preventDefault → ガードの順序)。Shift は見ない — 4 キーとも
+            // event.key (生成文字) だけを信頼する: JIS は Shift+`-` でしか `=` を打てず、AZERTY は
+            // Shift+`à` でしか `0` を打てない (Shift を拒否するとメイン行のズームイン / リセットが
+            // 恒久到達不能)。US の Shift+`=` は `+` を生みブラウザ同様ズームイン、US の Shift+`-`
+            // (`_`) や Shift+`0` (`)`) は不一致で素通し — 生成文字と AltGraph 判定の組がレイアウト
+            // 差を吸収する。帰結として非 AltGr の束縛は配列依存 (例: 独配列の Shift+0 = "=" は
+            // ズームイン) — 配列非依存の和音が必要なホストは event.code で先に請求すること。
+            // 素通しした和音は ctrl+alt 印字形状の遅延開始 (useGridKeyboard §6.6.2-4) により実文字が到着
+            // しない限り編集セッションを開かない
+            const next = event.key === "=" || event.key === "+" ? stepZoom(requestedZoomRef.current, 1) : event.key === "-" ? stepZoom(requestedZoomRef.current, -1) : event.key === "0" ? 1 : null
+            if (next === null) {
+                return
+            }
+            // 認識したズームキーは preventDefault + stopPropagation で完全請求する。R6(E)
+            // blocking (当時のシンク AltGr 印字規則が keydown 即 startEdit で空置換セッションを
+            // 開いた実欠陥) の主遮断だった capture 配置 + シンク側 defaultPrevented ガードは、
+            // v0.3.3 の ctrl+alt 印字形状の遅延開始 (useGridKeyboard §3.11) が破壊の観測面そのものを消した
+            // ため現在は**多層防御** — bubble 退行しても保留フラグが立つだけで実害に至らない
+            // ([M151] は等価変異化で ⚠️ 降格 — 台帳 Phase I / R2(I) 注)。stopPropagation は
+            // ガードを持たないリスナーへの予備ベルト (単独撤去は green 生存)
+            event.preventDefault()
+            event.stopPropagation()
+            if (isDraggingAnyRef.current?.()) {
+                return
+            }
+            requestZoom(next)
+        }
+        // 両リスナーとも capture 段 — wheel はペイン / ブリッジ (バブル段の消費者) より、keydown は
+        // シンク (target 段) の印字規則より先に走らないと請求が間に合わない
+        root.addEventListener("wheel", onWheel, { passive: false, capture: true })
+        root.addEventListener("keydown", onKeyDown, true)
+        return () => {
+            root.removeEventListener("wheel", onWheel, { capture: true })
+            root.removeEventListener("keydown", onKeyDown, true)
+        }
+    }, [requestZoom, zoomGestureEnabled])
+    const bodyRef = useRef<HTMLDivElement | null>(null)
+    const handleRef = useRef<VirtualGridHandle | null>(null)
+    const sinkRef = useRef<HTMLTextAreaElement | null>(null)
+    const rowTrackRef = useRef<HTMLDivElement | null>(null)
+    const windowOriginYRef = useRef(0)
+    const colTrackRef = useRef<HTMLDivElement | null>(null)
+    const windowOriginXRef = useRef(0)
+    const liveRegionRef = useRef<HTMLDivElement | null>(null)
+
+    // ---- 選択状態 (React state + 命令読み ref — §6.9-1) ----
+    const [selection, setSelectionState] = useState<SelectionState>(INITIAL_SELECTION)
+    const selectionRef = useRef(selection)
+    const getSelection = useCallback(() => selectionRef.current, [])
+
+    // ---- 強調帯 (v0.8 §2.4): 制御 (highlight prop) / 非制御 (内部 state) の zoom と同型の二相。?? は書かず明示分岐 ----
+    const [internalHighlight, setInternalHighlight] = useState<HighlightState>(() => (defaultHighlight === undefined ? DEFAULT_HIGHLIGHT : defaultHighlight))
+    const highlightValue = highlight !== undefined ? highlight : internalHighlight
+    /** Live highlight state read by the overlay at repaint and by the command runner (render-time assignment). / overlay の repaint とコマンド実行が読む強調状態 (レンダー時代入)。 */
+    const highlightRef = useRef<HighlightState>(highlightValue)
+    highlightRef.current = highlightValue
+    // overlay へ渡すパレット (v0.7 DOM 恒等): 宣言済み or 帯が 1 つでも on のときだけ — 未宣言 + 全 off では
+    // undefined で overlay は --aqsp-band-* を書かない (overlay の layout effect が唯一の書き手)
+    const overlayHighlightColors = resolveOverlayPalette(declaredHighlightColors, highlightValue)
+    const highlightControlledRef = useRef(highlight !== undefined)
+    highlightControlledRef.current = highlight !== undefined
+    const onHighlightChangeRef = useRef(onHighlightChange)
+    onHighlightChangeRef.current = onHighlightChange
+    /** Applies a toggle command's highlight request (controlled mode only notifies — the repaint follows the resolved value). / 強調トグルの要求適用 (制御モードは通知のみ — repaint は解決値に追随)。 */
+    const requestHighlight = useCallback((next: HighlightState) => {
+        if (!highlightControlledRef.current) {
+            setInternalHighlight(next)
+        }
+        onHighlightChangeRef.current?.(next)
+    }, [])
+
+    // ---- 命令再描画の間接 ref (構築循環切り — §6.9-7) ----
+    const repaintOverlayRef = useRef<(() => void) | null>(null)
+    // 配送モードは v0.8 で "point" (参照ドラッグ) を含む — overlay の DragFrameMode と同じ語彙
+    const dragFrameRef = useRef<((range: CellRange | null, mode: DragFrameMode) => void) | null>(null)
+    /** Editor seam: ref indirection filled later by Phase 3's useCellEditor return (§6.9-1-(5)). / Phase 3 の useCellEditor 戻り値を後から格納する ref 間接。 */
+    const isEditingRef = useRef<(() => boolean) | null>(null)
+    // ---- v0.8 のポインティング ref 辺 (§4.2.13 表): editor が書き、engine / header / point-drag / GridBody が読む ----
+    const getPointingRef = useRef<() => boolean>(() => false)
+    const insertReferenceRef = useRef<(target: CellCoord | CellRange, axis: ReferenceAxis) => void>(() => {})
+    const captureSinkRef = useRef<() => SinkSnapshot | null>(() => null)
+    const restoreSinkRef = useRef<(snapshot: SinkSnapshot) => void>(() => {})
+    /** Live pointing predicate (identity-stable — evaluated on the sink at call time, never cached). / 生きたポインティング述語 (identity 安定 — 呼び出し時にシンクを評価、キャッシュしない)。 */
+    const isPointing = useCallback(() => getPointingRef.current(), [])
+    /** Pointing seams for the header machines (identity-stable ref indirections). / ヘッダー機械向けのポインティングシーム (ref 間接)。 */
+    const pointingSeams = useMemo(() => ({ getPointing: () => getPointingRef.current(), insertReference: (target: CellCoord | CellRange, axis: ReferenceAxis) => insertReferenceRef.current(target, axis) }), [])
+    /** Edit paint channel (editor writes, overlay reads for the sink line box / vertical alignment). / エディタ塗りのチャネル (editor が書き overlay が読む)。 */
+    const editPaintRef = useRef<EditPaint>(IDLE_EDIT_PAINT)
+    /** Ctrl+Shift+V arming (keyboard writes, clipboard reads + clears). / Ctrl+Shift+V の武装 (keyboard が書き clipboard が読んで消す)。 */
+    const pendingPasteOptionsRef = useRef<PasteOptions | null>(null)
+    /** Popover anchor cells (popovers write, overlay places the nodes). / ポップオーバーアンカー (popovers が書き overlay が配置)。 */
+    const popoverAnchorsRef = useRef<PopoverAnchorState>({ interactive: null, tip: null })
+    const interactiveAnchorRef = useRef<HTMLDivElement | null>(null)
+    const tipAnchorRef = useRef<HTMLDivElement | null>(null)
+    // ---- コマンド / ポップオーバー / クリップボードの ref 辺 (各フック構築後にレンダー時代入) ----
+    const openPopoverRef = useRef<(kind: PopoverKind, options?: PopoverOpenOptions) => void>(() => {})
+    const hideNoteTipRef = useRef<() => boolean>(() => false)
+    /** Popover controller read by effects / the editor's validation gate without re-wiring (render-time assignment after usePopovers). / effect と検証ゲートが再結線なしに読むコントローラ (usePopovers 後にレンダー時代入)。 */
+    const popoversRef = useRef<PopoverController | null>(null)
+    /**
+     * Closes the `message` popover only when it is showing a strict-rejection notice (returns
+     * true when one was closed — the Escape chain, cancelEdit and a session start consume it,
+     * 分冊 08 §4.3). The passive inputMessage popover always returns false: its lifecycle is
+     * owned by the active-cell effect alone (Excel keeps the input message while the cell
+     * stays selected, editing included).
+     * strict 拒否を表示中の message ポップオーバーだけを閉じる (閉じたら true — Escape チェーン /
+     * cancelEdit / セッション開始が消費する。分冊 08 §4.3)。受動の inputMessage は常に false —
+     * その生存は active セル効果だけが決める (Excel は編集中も含め選択中ずっと入力メッセージを出す)。
+     */
+    const closeRejectedMessage = useCallback((): boolean => {
+        const controller = popoversRef.current
+        if (controller === null || controller.isOpen() !== "message") {
+            return false
+        }
+        const ctx = controller.context
+        // 受動 inputMessage を巻き込まない — stale になり得るのは拒否告知だけ (Excel は拒否ダイアログを持ち越さない)
+        if (ctx === null || ctx.kind !== "message" || !ctx.current.rejected) {
+            return false
+        }
+        controller.close()
+        return true
+    }, [])
+    const executeCommandRef = useRef<(command: SpreadsheetCommand) => boolean>(() => false)
+    const isCommandAvailableRef = useRef<(command: SpreadsheetCommand) => boolean>(() => false)
+    const commandsRef = useRef<CommandRunner | null>(null)
+    const pasteRef = useRef<(options: PasteOptions) => Promise<PasteOutcome>>(() => Promise.resolve("rejected"))
+
+    /** Stable indirection for repaintOverlay (owner: Spreadsheet §6.9-7). / repaint の安定間接。 */
+    const repaintOverlay = useCallback(() => {
+        repaintOverlayRef.current?.()
+    }, [])
+
+    // ---- 共有ヘルパ (所有点はここ 1 箇所 — §6.9-7) ----
+
+    /** Focus recovery only (never re-arms — §6.7.1 rule); `preventScroll` honoured for the popover return path. / フォーカス回収のみ (rearm は内包しない)。preventScroll はポップオーバー復帰経路が使う。 */
+    const focusSink = useCallback((options?: { preventScroll?: boolean }) => {
+        sinkRef.current?.focus(options)
+    }, [])
+
+    // ---- WCAG 2.1.2 脱出の旗 (§10-4): Escape の root.focus() だけが root に留まれる内部移動 ----
+    const escapeHandOffRef = useRef(false)
+    /** Flagged Escape hand-off to the root group — the one in-root focus move onRootFocus lets rest on the root. / 旗つきの Escape 脱出 (onRootFocus が root 滞在を許す唯一の内部移動)。 */
+    const handOffFocusToRoot = useCallback(() => {
+        const root = rootRef.current
+        if (root === null) {
+            return
+        }
+        // focus() は focusin を同期配送する — 旗は onRootFocus の実行中だけ立つ
+        escapeHandOffRef.current = true
+        try {
+            root.focus()
+        } finally {
+            escapeHandOffRef.current = false
+        }
+    }, [])
+
+    /** Re-arms the idle sink waiting protocol (ADR-3): value=" " + setSelectionRange(0, 1) — focus-neutral, so it never steals focus back after an out-of-grid focusout. / 待機プロトコルの再アーム (フォーカス中立 — グリッド外 focusout 後にフォーカスを奪い返さない)。 */
+    const rearmSink = useCallback(() => {
+        const sink = sinkRef.current
+        if (sink !== null) {
+            // 武装プロトコル (ADR-3): value " " を全選択。setSelectionRange はフォーカスを動かさない
+            // ため、グリッド外 focusout 後の再武装 (入力残留の掃除) でもユーザーが選んだ外部要素から
+            // フォーカスを奪わない (select() はブラウザによりフォーカスを伴う)
+            sink.value = " "
+            sink.setSelectionRange(0, 1)
+        }
+    }, [])
+
+    /**
+     * Repaints ONLY the row-header track residual transform. Callers: onScroll, resizeRow, and
+     * RowHeader's layout effect. vy comes from the grid handle (the truth — §7-4; the v0.6 −H_F
+     * frozen-band term makes this the exact twin of repaintColHeaders).
+     * 行 track の残差 transform のみを書く命令再描画。vy はグリッドハンドル (§7-4 の真実) から読む
+     * (v0.6 の −H_F 凍結帯項で repaintColHeaders の完全双子)。
+     */
+    const repaintHeaders = useCallback(() => {
+        const track = rowTrackRef.current
+        if (track !== null) {
+            // v0.6: 凍結行帯の −H_F 項 (repaintColHeaders の −W_F と対称)。vy はハンドル読みへ統一
+            // (列側の hx と同じ真実 §7-4 — 従来の viewStore.get().vy 読みは廃止)
+            const vy = Math.max(0, handleRef.current?.getScrollPosition().y ?? 0)
+            const frozenHeight = handleRef.current?.getFrozenSize().height ?? 0
+            track.style.transform = `translateY(${windowOriginYRef.current - vy - frozenHeight}px)`
+        }
+    }, [])
+
+    /**
+     * Repaints ONLY the column-header track residual transform (§7-5 — the row repaintHeaders
+     * twin; the v0.3 --aqsp-hx CSS variable is retired). hx comes from the grid handle (the
+     * truth — §7-4). Callers: onScroll, resize tails, and ColumnHeader's layout effect.
+     * 列 track の残差 transform のみを書く命令再描画 (§7-5 — 行 repaintHeaders の双子。v0.3 の
+     * --aqsp-hx CSS 変数は退役)。hx はグリッドハンドル (§7-4 の真実) から読む。
+     */
+    const repaintColHeaders = useCallback(() => {
+        const track = colTrackRef.current
+        if (track !== null) {
+            const hx = Math.max(0, handleRef.current?.getScrollPosition().x ?? 0)
+            // 凍結クリップ内では原点が W_F へシフトする (v0.5 計画 §3-2 — エンジン §8-b の
+            // −W_F 項のヘッダー同文。F = 0 は W_F = 0 で従来式と恒等)
+            const frozenWidth = handleRef.current?.getFrozenSize().width ?? 0
+            track.style.transform = `translateX(${windowOriginXRef.current - hx - frozenWidth}px)`
+        }
+    }, [])
+
+    // ensureCellVisible: §6.6.3 の自前 nearest (1 回構築して keyboard / Shift+F10 へ配布 — §6.9-7)。
+    // 軸 identity が変わったら作り直す (クロージャが旧軸を掴む stale を防ぐ)
+    const ensureCellVisibleRef = useRef<((cell: CellCoord) => void) | null>(null)
+    const ensureDepsRef = useRef<{ rowAxis: typeof rowAxis; colAxis: typeof colAxis } | null>(null)
+    if (ensureCellVisibleRef.current === null || ensureDepsRef.current?.rowAxis !== rowAxis || ensureDepsRef.current?.colAxis !== colAxis) {
+        ensureDepsRef.current = { rowAxis, colAxis }
+        ensureCellVisibleRef.current = createEnsureCellVisible({ handleRef, rowAxis, colAxis })
+    }
+    const ensureCellVisible = useCallback((cell: CellCoord) => {
+        ensureCellVisibleRef.current?.(cell)
+    }, [])
+
+    // ---- 読み上げ (live region — §6.9-9) ----
+    const announceTimerRef = useRef<number | null>(null)
+    const announceRafRef = useRef<number | null>(null)
+    const announce = useCallback((text: string) => {
+        if (announceTimerRef.current !== null) {
+            window.clearTimeout(announceTimerRef.current)
+        }
+        // 飛行中の「セット段 rAF」も取り消す — 取り残すと直前テキストが 1 フレーム内の再告知に
+        // 競り勝ち、離脱済みセルが読み上げられてから正しい告知が来る (stale 競合)
+        if (announceRafRef.current !== null) {
+            cancelAnimationFrame(announceRafRef.current)
+            announceRafRef.current = null
+        }
+        announceTimerRef.current = window.setTimeout(() => {
+            announceTimerRef.current = null
+            const node = liveRegionRef.current
+            if (node === null) {
+                return
+            }
+            // 同一文字列の再告知に備え「クリア → 次フレームでセット」で変更検知を強制する (§6.9-9)
+            node.textContent = ""
+            announceRafRef.current = requestAnimationFrame(() => {
+                announceRafRef.current = null
+                node.textContent = text
+            })
+        }, ANNOUNCE_DEBOUNCE_MS)
+    }, [])
+    // アンマウント時にデバウンスタイマと rAF を回収する (残置は他コンポーネントと違い自然無害だが、
+    // 本パッケージは全タイマ / rAF を回収する規律で統一している)
+    useEffect(
+        () => () => {
+            if (announceTimerRef.current !== null) {
+                window.clearTimeout(announceTimerRef.current)
+            }
+            if (announceRafRef.current !== null) {
+                cancelAnimationFrame(announceRafRef.current)
+            }
+        },
+        [],
+    )
+
+    /** The 3-tier announcement rule (§6.9-9, evaluated top-down). / 3 段機械判定 (上から順)。 */
+    const evaluateAnnouncement = useCallback(
+        (prev: SelectionState, next: SelectionState) => {
+            if (formatCellAnnouncement === undefined && formatSelectionAnnouncement === undefined) {
+                return
+            }
+            const range = next.ranges[next.ranges.length - 1]
+            const size = rangeSize(range)
+            const isSingleCell = next.ranges.length === 1 && size.rows === 1 && size.cols === 1
+            const prevRange = prev.ranges[prev.ranges.length - 1]
+            const shapeChanged = prev.ranges.length !== next.ranges.length || prevRange.startRow !== range.startRow || prevRange.startCol !== range.startCol || prevRange.endRow !== range.endRow || prevRange.endCol !== range.endCol
+            const announceCell = () => {
+                if (formatCellAnnouncement !== undefined) {
+                    const a = next.active
+                    const raw = adapter.getCellText(a.row, a.col)
+                    // displayText は目視と同一の整形後文字列 (塗り書式 = base ⊕ CF — getCellFormat 未宣言は raw と同値)
+                    const painted = adapter.getCellFormat === undefined ? undefined : paintedFormatOf(a.row, a.col, () => raw)
+                    announce(formatCellAnnouncement({ row: a.row, col: a.col, text: raw, displayText: formatCellValue(raw, painted === undefined ? undefined : painted.value), columnName: columnIndexToName(a.col) }))
+                }
+            }
+            // (1) 単一 1×1 レンジ → セル読み上げ (素のクリック / 矢印移動)
+            if (isSingleCell) {
+                announceCell()
+                return
+            }
+            // (2) レンジ形状・本数が変わった → 選択読み上げ
+            if (shapeChanged) {
+                if (formatSelectionAnnouncement !== undefined) {
+                    announce(
+                        formatSelectionAnnouncement({
+                            range,
+                            anchor: next.anchor,
+                            active: next.active,
+                            rangeRowCount: size.rows,
+                            rangeColCount: size.cols,
+                            rangeCount: next.ranges.length,
+                        }),
+                    )
+                }
+                return
+            }
+            // (3) レンジ不変で active だけ動いた (巡回) → セル読み上げ (selection 側に振ると同一文言で
+            // aria-live が無音になり、SR の中核データ入力ループが壊れる — §6.9-9)
+            announceCell()
+        },
+        [adapter, formatCellAnnouncement, formatSelectionAnnouncement, announce, paintedFormatOf],
+    )
+
+    /**
+     * The §6.9-1 setSelection wrapper — the ONLY write path for every producer (engine /
+     * keyboard / headers / clipboard). 5 ordered steps.
+     * setSelection ラッパー (§6.9-1) — 全書き込み経路の唯一の入口。5 段の順序処理。
+     */
+    const setSelection = useCallback(
+        (next: SelectionState) => {
+            const prev = selectionRef.current
+            // (1) 等価 bail — Object.is は reducer の identity 保存契約の高速経路、構造等価は
+            // 構築系 state (Ctrl+A / コーナー / ヘッダー合成) の等価再発火を抑える (どちらも
+            // 「確定 SelectionState の変化ごとに 1 回だけ発火する」onSelectionChange 契約の実装)
+            if (Object.is(next, prev) || selectionStateEquals(next, prev)) {
+                return
+            }
+            // (2) selectionRef を setState より先に同期で書く (同一 tick 内の連続 reducer 適用の stale 防止)
+            selectionRef.current = next
+            // (3) setState
+            setSelectionState(next)
+            // (4) onSelectionChange を同期発火し、読み上げ 3 段判定もここで評価 (prev は (2) 前の退避値)
+            onSelectionChange?.(next)
+            evaluateAnnouncement(prev, next)
+            // (5) 編集セッション外なら rearm (ADR-3 の rearm 点 (c) の実行点はここ 1 箇所)
+            if (!(isEditingRef.current?.() ?? false)) {
+                rearmSink()
+            }
+        },
+        [onSelectionChange, evaluateAnnouncement, rearmSink],
+    )
+
+    /** moveActive (§6.6.2-3): discriminated union to reducer to ensureCellVisible; owned by Spreadsheet (§6.9-7). / 判別 union → reducer → ensureCellVisible の順に適用。 */
+    const moveActive = useCallback(
+        (input: MoveActiveInput) => {
+            const state = selectionRef.current
+            if (input.mode === "cycle") {
+                const next = reduceActiveCycle(state, input.direction)
+                setSelection(next)
+                ensureCellVisible(next.active)
+                return
+            }
+            const cell = clampCoord(input.cell, rowAxis.count, colAxis.count)
+            if (input.mode === "extend") {
+                setSelection(reduceSelectionExtend(state, cell))
+                // ensure-visible は伸長端 (§6.6.2-3)
+                ensureCellVisible(cell)
+                return
+            }
+            setSelection(reduceSelectionPress(state, cell, { extend: false, append: false }))
+            ensureCellVisible(cell)
+        },
+        [setSelection, ensureCellVisible, rowAxis, colAxis],
+    )
+
+    // ---- Phase 3 シーム (実体は useCellEditor / useClipboard — 構築循環は ref 間接で切る §6.9-1) ----
+    const isEditing = useCallback(() => isEditingRef.current?.() ?? false, [])
+    const requestCommitRef = useRef<(() => boolean) | null>(null)
+    const requestCommit = useCallback(() => requestCommitRef.current?.() ?? true, [])
+    const startEditRef = useRef<((mode: "edit" | "replace", caretIndex?: number) => void) | null>(null)
+    const startEdit = useCallback(
+        (mode: "edit" | "replace", caretIndex?: number) => {
+            const wasEditing = isEditingRef.current?.() ?? false
+            startEditRef.current?.(mode, caretIndex)
+            // セッションが実際に開いたときだけ stale な strict 拒否告知を畳む (分冊 08 §4.3): 前回 commit の
+            // 拒否は新しい下書きに当てはまらない。bail (ドラッグ中 / 既存セッション / シンク不在) では閉じない
+            if (!wasEditing && (isEditingRef.current?.() ?? false)) {
+                closeRejectedMessage()
+            }
+        },
+        [closeRejectedMessage],
+    )
+    /** The sole dblclick → editing(edit) channel (§6.4.3-7 / §6.7.1). The PER-CELL ED-1 gate (caret-from-point only when that cell's display === raw text) lives on the ENGINE param (caretFromPointEnabled(cell) — single judgment point), so caretIndex forwards untouched here. / dblclick → editing(edit) 開始の唯一チャネル。**セル単位**の ED-1 ゲート (そのセルの表示 === 素値のときだけキャレット計算) はエンジン param 側の単一判定点 (caretFromPointEnabled(cell)) — ここでは素通し。 */
+    // ---- 仮想キーボード招待 (v0.7 UX 追補 R7): シンクの inputmode はこのフラグの純粋な描画 ----
+    //      "text" = 招待中 / "none" = 非招待。招待はポインタでエディタを開いたとき (dblclick) だけ立ち、
+    //      フォーカスがグリッド外へ出るか、セッション外の touch / ペン押下で下ろす。Enter / Tab の確定では
+    //      下ろさない (キーボード無し端末の「入力 → Enter → 入力」で OSK を消さない)。キーボード / IME の
+    //      利用者には属性は常に "none" で一度も変わらない。セッションを持つ変換の途中で属性が変わる経路は
+    //      存在しない — 立てるのは押下ゲートが変換を確定した後の dblclick、下ろすのはセッション外の
+    //      touch / ペン押下とグリッド脱出 (blur が変換を先に確定する — E2E で実証) だけ。唯一の例外は
+    //      ドラッグ飛行中に始まった変換 (startEdit が isDragging で bail しセッションを持たない) だが、
+    //      その変換は input 到着ごとに待機シンクの自己修復 (rearmSink) が既に捨てており、守るものが無い
+    //      (Chromium は inputmode 変更を text-input-state 変更として通知し、Windows TSF は
+    //      OnTextInputTypeChanged で進行中の変換を強制終了する: 未編集 → IME 1 文字 → Enter が
+    //      落ちた利用者報告の根因 — セッション基準の切替は compositionstart の中で属性を変えていた)
+    const [virtualKeyboard, setVirtualKeyboard] = useState(false)
+    const onRequestEdit = useCallback(
+        (_cell: CellCoord, caretIndex?: number) => {
+            // ポインタで開くエディタだけが仮想キーボードを招待する (キーボード無し端末で開ける唯一の経路)。
+            // 変換は進行中でない (dblclick 押下面が先に requestCommit 済み) — 属性変更は安全
+            setVirtualKeyboard(true)
+            startEdit("edit", caretIndex)
+        },
+        [startEdit],
+    )
+    const getClipRef = useRef<(() => ClipInfo | null) | null>(null)
+    const getClip = useCallback(() => getClipRef.current?.() ?? null, [])
+    const discardClipRef = useRef<(() => void) | null>(null)
+    const discardClip = useCallback(() => {
+        discardClipRef.current?.()
+    }, [])
+    const discardClipOnCommitRef = useRef<((source: EditSource) => void) | null>(null)
+    const discardClipOnCommit = useCallback((source: EditSource) => {
+        discardClipOnCommitRef.current?.(source)
+    }, [])
+    /** Sheet-switch relay into the clipboard hook (copy discarded, cut kept as foreign). / シート切替のクリップ中継 (copy 破棄、cut は foreign で保持)。 */
+    const onAdapterSwitchRef = useRef<() => void>(() => {})
+
+    /** Transaction counter (v0.8 §4.2.13 / §1.3): one strictly increasing id per applyEdits call of THIS grid instance (a rejected call consumes its id too — an id the adapter has seen is never reused) — the consumer's undo groups by it. / トランザクション採番 (v0.8 §4.2.13 / §1.3): このグリッド実体の applyEdits 呼び出し 1 回につき厳密増加の id 1 つ (拒否された呼び出しも id を消費 — アダプタが見た id は再利用しない) — consumer の Undo はこれで束ねる。 */
+    const transactionRef = useRef(0)
+    /**
+     * The single write funnel (§6.9-2 / ADR-16): `commitEdits(edits, rejection, sheet?) → number | null`.
+     * A paste commit MUST carry `sheet` (RangeError otherwise — a wiring bug). An EMPTY transaction
+     * (no edits and no conditional formats to carry) never reaches the adapter (no id, no bumpEdit,
+     * no clip discard) and returns null. Otherwise the transaction id is allocated, the EditContext is
+     * derived from the caller-declared rejection (the paste arm carries sameSheet / conditionalFormats)
+     * and applyEdits runs ONCE: success bumps the edit version, runs the source-aware commit discard
+     * (format / annotate keep the clip, the clipboard's own paste keeps it, everything else discards)
+     * and returns the id; a throw emits onEditRejected with the rejection context and returns null.
+     * 単一書込漏斗 (§6.9-2 / ADR-16): `commitEdits(edits, rejection, sheet?) → number | null`。paste の
+     * commit は sheet 必須 (欠落は結線バグ = RangeError)。空トランザクション (edits なし・運ぶ規則なし) は
+     * アダプタへ届けず null (採番 / bumpEdit / クリップ破棄なし)。それ以外は採番し、拒否文脈から EditContext を
+     * 導出 (paste 枝は sameSheet / conditionalFormats) して applyEdits を 1 回: 成功 → bumpEdit + source を
+     * 見た commit 破棄 (format / annotate と自 paste は温存) + id、throw → onEditRejected + null。
+     */
+    const commitEdits = useCallback(
+        (edits: readonly CellEdit[], rejection: EditRejection, sheet?: PasteSheet): number | null => {
+            let context: EditContext
+            if (rejection.source === "paste") {
+                // シート文脈は空 edits より先に検証する (結線バグは実行内容に依らず即時表面化)
+                const pasteSheet = requirePasteSheet(sheet)
+                // CF だけを運ぶ paste は空 edits でも 1 トランザクション (RC9 — 規則も無ければ不達)
+                if (edits.length === 0 && pasteSheet.conditionalFormats.length === 0) {
+                    return null
+                }
+                // 採番はアダプタ呼び出しの前 (拒否されても id は消費 — 厳密増加、applyEdits 1 回 1 id)
+                transactionRef.current += 1
+                context = { transaction: transactionRef.current, source: "paste", sameSheet: pasteSheet.sameSheet, conditionalFormats: pasteSheet.conditionalFormats }
+            } else {
+                // 空トランザクションはアダプタへ届けない (採番なし・bumpEdit なし・クリップ破棄なし)
+                if (edits.length === 0) {
+                    return null
+                }
+                transactionRef.current += 1
+                context = { transaction: transactionRef.current, source: rejection.source }
+            }
+            try {
+                adapter.applyEdits(edits, context)
+            } catch (error) {
+                // 拒否文脈 (経路 + セッションの行方) は呼び手が事前宣言する — ラッパーは中継だけ (SSOT)
+                onEditRejected?.(error, rejection)
+                return null
+            }
+            viewStore.bumpEdit()
+            // applyEdits 系はクリップの破棄条件 (§6.5.4-4) — source を渡し、書式 / 注釈の commit は
+            // アンツを保つ (Excel の Ctrl+B と同じ)。自 paste の温存判定はクリップフック側が担う
+            discardClipOnCommit(rejection.source)
+            return context.transaction
+        },
+        [adapter, viewStore, onEditRejected, discardClipOnCommit],
+    )
+    /** The clipboard's paste seam: ONE transaction with its sheet context (ADR-16). / クリップボードの paste シーム (シート文脈つき 1 トランザクション)。 */
+    const commitPaste = useCallback((edits: readonly CellEdit[], sheet: PasteSheet): number | null => commitEdits(edits, { source: "paste" }, sheet), [commitEdits])
+
+    // ---- VirtualGrid コールバック (§6.9-6 — v0.4 で 2 軸化) ----
+
+    /** Mirrors vy into the store and repaints imperative surfaces on either axis (§7-4). / vy 写像 + 両軸の命令再描画。 */
+    const onScroll = useCallback(
+        (position: { x: number; y: number }) => {
+            viewStore.setVy(position.y)
+            // 両 track と overlay の残差更新は onScroll から ref 直接呼び (React 不介在)。
+            // 横成分もここへ届く — v0.3 の applyHx rAF 合流は退役 (グリッドが hx を所有し、
+            // 通知はホイール / パン / バー / キーボードの全経路で 1 本化された)
+            repaintHeaders()
+            repaintColHeaders()
+            repaintOverlay()
+        },
+        [viewStore, repaintHeaders, repaintColHeaders, repaintOverlay],
+    )
+
+    /** Feeds the RENDERING 2D ranges into the store (§6.9-6 / §7-5). / 描画 2D レンジのストア供給。 */
+    const lastDeliveredRangeRef = useRef({ rowStart: -1, rowEnd: -1, colStart: -1, colEnd: -1 })
+    const onRangeChange = useCallback(
+        (range: VirtualGridRange) => {
+            viewStore.setRowRange(range.renderingRowStart, range.renderingRowEnd)
+            // 列レンジは ColumnHeader の再レンダー源 (§7-5 — 行側 setRowRange → RowHeader の完全対称)
+            viewStore.setColRange(range.renderingColStart, range.renderingColEnd)
+            // repaint は実レンジ変化時のみ (グリッドは毎スクロールフレーム配送する — 無差別
+            // repaint は onScroll の同期 repaint と重なり 1 フレーム 2 描画になる)。マウント時の
+            // A1 アクティブ枠を描くのはこの中継経路 (グリッドの rAF 遅延 throttled callback から届く
+            // 初回の onScroll / onRangeChange) — SelectionOverlay 自身のマウント effect は viewport
+            // 未計測 ({0,0} / range null。グリッドの viewport 計測は layout effect の setState で
+            // 1 レンダー遅れる) のまま走り何も描かず、selection layout effect も初回マウントでは
+            // ref 未登録の no-op (post-B F2 実測: 初回フレームの唯一の所有者は本中継)
+            const last = lastDeliveredRangeRef.current
+            if (last.rowStart !== range.renderingRowStart || last.rowEnd !== range.renderingRowEnd || last.colStart !== range.renderingColStart || last.colEnd !== range.renderingColEnd) {
+                lastDeliveredRangeRef.current = { rowStart: range.renderingRowStart, rowEnd: range.renderingRowEnd, colStart: range.renderingColStart, colEnd: range.renderingColEnd }
+                repaintOverlay()
+            }
+        },
+        [viewStore, repaintOverlay],
+    )
+
+    // ---- ドラッグ矩形 writer (エンジン → overlay の常設ノードへ) ----
+    // mode reader ref (§3.2 — isAnyDraggingRef 同型のレンダー時代入): 全書き手 (エンジン /
+    // ヘッダー機械 / オートスクローラー tick) がこの単一リレーを通るため、構築時固定 writer の
+    // オートスクローラー経由でも正しい減算モードが overlay へ届く (per-call ラップ不要)
+    const engineDragModeRef = useRef<() => DragFrameMode>(() => "add")
+    const onDragFrame = useCallback((range: CellRange | null) => {
+        dragFrameRef.current?.(range, engineDragModeRef.current())
+    }, [])
+    /** Keyboard-pointing reference-rect writer (分冊 04 §3.20): stamps the FIXED "point" mode — the composite reader reports "point" only while the reference DRAG is in flight, but the keyboard paints without any drag. / キーボードポインティングの参照矩形 writer (分冊 04 §3.20): 固定 "point" モードで刻む — 合成 reader が "point" を返すのは参照ドラッグ飛行中だけで、キーボードはドラッグなしで描くため。 */
+    const onPointFrame = useCallback((range: CellRange | null) => {
+        dragFrameRef.current?.(range, "point")
+    }, [])
+
+    // ---- fill プレビュー / リサイズガイドラインの writer リレー (§7.2 / §8.2 — positioner は
+    //      overlay 所有。fill 機械と軸別 2 スクローラーの全書き手がこの単一リレーを通る) ----
+    const fillFrameRef = useRef<((range: CellRange | null) => void) | null>(null)
+    const onFillFrame = useCallback((range: CellRange | null) => {
+        fillFrameRef.current?.(range)
+    }, [])
+    const resizeGuideFrameRef = useRef<((guide: ResizeGuide | null) => void) | null>(null)
+    const writeResizeGuide = useCallback((guide: ResizeGuide | null) => {
+        resizeGuideFrameRef.current?.(guide)
+    }, [])
+    /** Fill-handle node registration (overlay renders it, useFillHandle wires it). / fill ハンドルノードの登録 (overlay が描画し useFillHandle が結線)。 */
+    const fillHandleNodeRef = useRef<HTMLDivElement | null>(null)
+
+    /**
+     * Batch resize seam (§7.2): per-index tree/virtualscroll updates in a loop, then bump /
+     * repaint ONCE at the tail (the per-index imperative API would run a synchronous repaint
+     * per call — 1M calls = repaint hell). Row entries still run updateItemSize per call
+     * (virtualscroll's viewport compensation is per-call by design — budget row (f) prices
+     * this residual); the row tail repaints BOTH headers and overlay (the v0.1 resizeRow pair).
+     * バッチリサイズシーム (§7.2)。per-index の木 / virtualscroll 更新をループし bump / repaint
+     * は末尾 1 回 (per-index 命令 API の同期 repaint 地獄の遮断)。行の updateItemSize は
+     * per-call (virtualscroll の補償スクロールが per-call 設計 — 予算行 (f) がこの付帯コストを
+     * 見積もる)。行軸末尾は repaintHeaders + repaintOverlay の対 (v0.1 resizeRow と同じ)。
+     */
+    const resizeTracks = useCallback(
+        (axis: "row" | "col", entries: readonly { index: number; size: number }[]) => {
+            if (entries.length === 0) {
+                return
+            }
+            const handle = handleRef.current
+            if (axis === "col") {
+                for (const entry of entries) {
+                    // 対呼び出し (§3.8): colAxis (SSOT) を先に更新し、グリッドの幅木へ通知する。
+                    // 丸めは一度だけ — 両者へ同一値を渡す (食い違うと幅 self-heal が巻き戻す)
+                    const size = Math.round(entry.size)
+                    colAxis.resize(entry.index, size)
+                    handle?.updateColSize(entry.index, size)
+                }
+                // hx 再クランプと可視セルの再配置はグリッド内部 (総幅同期 + 幅エポック) が担う —
+                // ここでの明示 reclamp は退役。ヘッダーの再レンダーは colVersion、残差は末尾 repaint
+                viewStore.bumpColVersion()
+                repaintColHeaders()
+                repaintOverlay()
+                return
+            }
+            for (const entry of entries) {
+                // 丸めは一度だけ — rowAxis とグリッド内部木へ同一値を渡す (v0.1 resizeRow と同じ)
+                const size = Math.round(entry.size)
+                rowAxis.resize(entry.index, size)
+                handle?.updateRowSize(entry.index, size)
+            }
+            viewStore.bumpRowGeometry()
+            repaintHeaders()
+            repaintOverlay()
+        },
+        [rowAxis, colAxis, viewStore, repaintColHeaders, repaintHeaders, repaintOverlay],
+    )
+
+    /** Pointer contextmenu relay to onCellContextMenu (§6.4.3-4 sole channel). / pointer 起点の横流し。 */
+    const onContextMenuSelect = useCallback(
+        (cell: CellCoord, event: MouseEvent) => {
+            onCellContextMenu?.(cell, { kind: "pointer", event })
+        },
+        [onCellContextMenu],
+    )
+
+    // ---- オートスクローラー 3 種 (セル both / 列ヘッダー x / 行ヘッダー y — §6.4.4 / §6.8) ----
+    const cellAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame, axis: "both", zoomRef })
+    const colHeaderRef = useRef<HTMLDivElement | null>(null)
+    const rowHeaderRef = useRef<HTMLDivElement | null>(null)
+    const colAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame, axis: "x", zoomRef })
+    const rowAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame, axis: "y", zoomRef })
+    // fill 専用の軸別 2 インスタンス (§8.2 — writer も axis も構築時固定。v0.3 のボックス方式では
+    // fill 機械が武装時に両方を start する — 軸選択・反転なし。既存 3 台と合わせ計 5 台、全て
+    // 構築時固定の単一規約)
+    const fillXAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame: onFillFrame, axis: "x", zoomRef })
+    const fillYAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame: onFillFrame, axis: "y", zoomRef })
+    // 6 台目 (v0.8 §4.2.13 表 3 行目): 参照ドラッグ (usePointDrag) 専用の両軸スクローラー — writer は
+    // 同じドラッグ矩形リレー (合成モードが "point" を刻む)
+    const pointAutoScroller = useAutoScroller({ handleRef, rowAxis, colAxis, bodyRef, onDragFrame, axis: "both", zoomRef })
+    /** The reference-drag owner, consulted by the engine BEFORE its commit gate (render-time assignment after usePointDrag). / 参照ドラッグ所有者 (engine が commit ゲートより先に諮る — usePointDrag 後にレンダー時代入)。 */
+    const pointDragRef = useRef<PointDragOwner | null>(null)
+
+    // 空グリッドは §6.9-1 の空分岐で実 DOM を描かない — 結線フックは enabled=false で眠らせ、
+    // 非空遷移の再レンダーで再結線する (ref identity 不変のため deps だけでは再実行されない)。
+    // isEmpty 本体はズームジェスチャ effect と共有するため上方で単一定義
+
+    // 合成ドラッグ判定の ref 間接 (エンジン構築時にはヘッダー機械が未構築 — 構築循環切り)
+    const isAnyDraggingRef = useRef<() => boolean>(() => false)
+    const isAnyDragging = useCallback(() => isAnyDraggingRef.current(), [])
+
+    // ---- 選択エンジン (§6.4.3) ----
+    const engine = useSelectionEngine({
+        zoomRef,
+        enabled: !isEmpty,
+        rowAxis,
+        colAxis,
+        handleRef,
+        bodyRef,
+        isEditing,
+        requestCommit,
+        getSelection,
+        setSelection,
+        focusSink,
+        onDragFrame,
+        onContextMenuSelect,
+        onRequestEdit,
+        // ED-1 の採用条件 (c): 「そのセルの」表示テキスト === 素の正準文字列のときだけキャレット
+        // 計算 (§6)。renderCell (カスタム DOM) は全セル無効。getCellFormat 在りでもセル単位に判定
+        // し、表示が素値と一致するセル (text 型・ラベル・書式なし列) はクリック位置キャレットを
+        // 保つ — 乖離するセル (¥1,234 の offset を 1234 に適用できない) だけ末尾 (v0.1 挙動) へ。
+        // 判定は dblclick 毎に O(1) (該当セル 1 個の整形比較のみ)。
+        caretFromPointEnabled: (cell) => {
+            if (renderCell !== undefined) {
+                return false
+            }
+            // 数式セル (getCellFormula 宣言 + 数式あり) はエディタが数式ソースを開く — 表示値の offset は
+            // 数式文字列へ写像できないので末尾 (v0.8 §4.2.13)
+            if (adapter.getCellFormula !== undefined && adapter.getCellFormula(cell.row, cell.col) !== undefined) {
+                return false
+            }
+            if (adapter.getCellFormat === undefined) {
+                return true
+            }
+            const raw = adapter.getCellText(cell.row, cell.col)
+            return formatCellValue(raw, adapter.getCellFormat(cell.row, cell.col)?.value) === raw
+        },
+        isAnyDragging,
+        autoScroller: cellAutoScroller,
+        repaintOverlay,
+        // v0.8 (§4.2.8): 参照ドラッグ所有者を commit ゲートより先に諮り、ポインティング中の dblclick は編集を開かない
+        pointDragRef,
+        getPointing: isPointing,
+        // v0.8 リンク開通 (分冊 08 §11 D-53): onHyperlinkOpen とリンク側面の両宣言時だけ能力を渡す
+        // (どちらか欠けたら param ごと不在 = エンジンの押下経路は恒等)。リンク無しセルは消費しない
+        // (append / 減算ジェスチャへ返す)。側面は毎回オブジェクト経由で読む (getBaseFormat と同型 —
+        // this 依存のアダプタ実装を壊さない)。生 URL は信頼境界 (ADR-10) で正規化 — 許可外スキームは
+        // リンク無し扱いでホストへ渡さない
+        openHyperlinkAt:
+            onHyperlinkOpen === undefined || adapter.getCellHyperlink === undefined
+                ? undefined
+                : (cell) => {
+                      const url = adapter.getCellHyperlink === undefined ? undefined : normalizeAdapterHyperlink(adapter.getCellHyperlink(cell.row, cell.col))
+                      if (url === undefined) {
+                          return false
+                      }
+                      onHyperlinkOpen(url, cell)
+                      return true
+                  },
+    })
+
+    // ---- ヘッダー選択 (§6.8 — 列 / 行の転置共通機械) ----
+    const colHeaderMachine = useHeaderSelection({
+        zoomRef,
+        enabled: !isEmpty,
+        axis: "col",
+        headerRef: colHeaderRef,
+        mainAxis: colAxis,
+        crossCount: adapter.rowCount,
+        handleRef,
+        isEditing,
+        requestCommit,
+        getSelection,
+        setSelection,
+        focusSink,
+        onDragFrame,
+        autoScroller: colAutoScroller,
+        repaintOverlay,
+        // v0.8 (§4.2.9): ポインティング中の帯押下は全列参照 (A:A) の挿入
+        pointing: pointingSeams,
+    })
+    const rowHeaderMachine = useHeaderSelection({
+        zoomRef,
+        enabled: !isEmpty,
+        axis: "row",
+        headerRef: rowHeaderRef,
+        mainAxis: rowAxis,
+        crossCount: adapter.colCount,
+        handleRef,
+        isEditing,
+        requestCommit,
+        getSelection,
+        setSelection,
+        focusSink,
+        onDragFrame,
+        autoScroller: rowAutoScroller,
+        repaintOverlay,
+        // v0.8 (§4.2.9): ポインティング中の帯押下は全行参照 (1:1) の挿入
+        pointing: pointingSeams,
+    })
+
+    // ---- リサイズ / unhide 機械 (§7 PT-1) + fill 機械 (§8 PT-2) ----
+    const headerResizeMachine = useHeaderResize({
+        zoomRef,
+        enabled: !isEmpty && enableResizeUI,
+        colBandRef: colHeaderRef,
+        rowBandRef: rowHeaderRef,
+        colAxis,
+        rowAxis,
+        viewStore,
+        handleRef,
+        isEditing,
+        requestCommit,
+        focusSink,
+        getSelection,
+        adapter,
+        // autofit の採用条件 = renderCell 未指定 (カスタム DOM は measureText 計測を保証できない §10)
+        autofitEnabled: renderCell === undefined,
+        defaultRowHeight,
+        defaultColumnWidth,
+        maxOperationCells,
+        onOperationRejected,
+        resizeTracks,
+        writeResizeGuide,
+        repaintOverlay,
+        // v0.8 (§4.2.10): ポインティング中のストリップ押下は consume (挿入なし・確定なし)
+        isPointing,
+    })
+    const fillMachine = useFillHandle({
+        zoomRef,
+        enabled: !isEmpty && enableFillHandle,
+        handleNodeRef: fillHandleNodeRef,
+        bodyRef,
+        rowAxis,
+        colAxis,
+        handleRef,
+        getSelection,
+        setSelection,
+        focusSink,
+        adapter,
+        commitEdits,
+        maxOperationCells,
+        onOperationRejected,
+        writeFillPreview: onFillFrame,
+        repaintOverlay,
+        xAutoScroller: fillXAutoScroller,
+        yAutoScroller: fillYAutoScroller,
+    })
+    // ---- 参照ドラッグ (v0.8 §4.1.18 — 独立所有者、§4.2.13 表 7 行目) ----
+    const pointDrag = usePointDrag({
+        zoomRef,
+        enabled: !isEmpty,
+        bodyRef,
+        handleRef,
+        rowAxis,
+        colAxis,
+        // editor のシームは ref 間接 (editor は後で構築される — 構築循環切り)
+        getPointing: isPointing,
+        insertReference: pointingSeams.insertReference,
+        captureSink: () => captureSinkRef.current(),
+        restoreSink: (snapshot) => restoreSinkRef.current(snapshot),
+        focusSink,
+        autoScroller: pointAutoScroller,
+        onDragFrame,
+    })
+    pointDragRef.current = pointDrag
+
+    // Escape 優先順 (§6.6.1) は全ドラッグに効く — 6 機械の合成面 (§7.4: リサイズ / fill / 参照ドラッグ飛行中は
+    // キーボード全キー consume (Escape 除く)・contextmenu 凍結・clipboard 凍結が自動成立)
+    const isDraggingAny = useCallback(
+        () => engine.isDragging() || colHeaderMachine.isDragging() || rowHeaderMachine.isDragging() || headerResizeMachine.isDragging() || fillMachine.isDragging() || pointDrag.isDragging(),
+        [engine, colHeaderMachine, rowHeaderMachine, headerResizeMachine, fillMachine, pointDrag],
+    )
+    // ズームジェスチャのドラッグ中無効化 (v0.3) が構築循環なしで読めるよう間接 ref へ充填
+    isDraggingAnyRef.current = isDraggingAny
+    // エンジンの contextmenu 凍結ゲートへ合成面を配線 (レンダー時代入 — paramsRef と同じ規律)
+    isAnyDraggingRef.current = isDraggingAny
+    // 配送モードの reader をリレーへ配線 (§3.2 — レンダー時代入): 参照ドラッグ飛行中は "point"、それ以外は
+    // セル機械の add / subtract (ヘッダーは常に "add")。§4.2.13 表 8 行目の合成 dragModeAny
+    engineDragModeRef.current = () => (pointDrag.isDragging() ? "point" : engine.getDragMode())
+    const abortDragAny = useCallback(() => {
+        engine.abortDrag()
+        colHeaderMachine.abortDrag()
+        rowHeaderMachine.abortDrag()
+        headerResizeMachine.abortDrag()
+        fillMachine.abortDrag()
+        // 参照ドラッグの中断はトークンをドラッグ前へ戻すだけ (セッション継続 — §4.2.7 の Escape 規律)
+        pointDrag.abortDrag()
+    }, [engine, colHeaderMachine, rowHeaderMachine, headerResizeMachine, fillMachine, pointDrag])
+
+    // ---- 編集セッション (§6.7.1) + クリップボード (§6.5.4) — シームの実体 ----
+    const getActive = useCallback(() => selectionRef.current.active, [])
+    /**
+     * The validation gate (v0.8 §4.2.6 / 分冊 08 §4.2), shared by the editor's changed commit and
+     * the editing-column `fillSelection` (which runs it per target cell): no rule / non-strict ⇒
+     * ok (the cell keeps its invalid mark); only a strict rejection stops the commit and reports
+     * through `onValidationRejected` + the `message` popover (`rejected`).
+     * 検証ゲート (v0.8 §4.2.6 / 分冊 08 §4.2) — エディタの変更ある確定と編集列 fillSelection (対象セル毎)
+     * が共有。規則なし / 非 strict は受理 (セルは不正表示のまま)、strict の拒否だけが commit を止めて
+     * onValidationRejected + message ポップオーバー (rejected) を出す。
+     */
+    const validateCommit = useCallback(
+        (cell: CellCoord, text: string): ValidationVerdict => {
+            const rule = adapter.getCellValidation === undefined ? undefined : adapter.getCellValidation(cell.row, cell.col)
+            if (rule === undefined) {
+                return OK_VERDICT
+            }
+            const evaluateFormula = adapter.evaluateFormula
+            const verdict = validateCellText(rule, text, evaluateFormula === undefined ? undefined : (formula) => evaluateFormula(formula, cell))
+            if (verdict.ok || rule.strict !== true) {
+                return OK_VERDICT
+            }
+            onValidationRejected?.({ cell, rule, text, message: verdict.message })
+            // message kind が有効なときだけ拒否メッセージを載せる (無効 kind の open は RangeError)
+            if (popoversRef.current?.isKindEnabled("message")) {
+                openPopoverRef.current("message", { message: verdict.message, rejected: true })
+            }
+            return verdict
+        },
+        [adapter, onValidationRejected],
+    )
+    const editor = useCellEditor({
+        enabled: !isEmpty,
+        sinkRef,
+        rootRef,
+        adapter,
+        commitEdits,
+        getActive,
+        ensureCellVisible,
+        focusSink,
+        rearmSink,
+        discardClip,
+        isDragging: isAnyDragging,
+        // Excel 同様、編集中もセルの水平揃えを保つ (数値セルは右揃えのまま編集)。getCellFormat 未宣言は
+        // null = v0.1 恒等 (textarea の text-align を触らない)。宣言時は塗り書式 (base ⊕ CF) で判定し
+        // text は遅延 1 回読み (v0.8 §4.2.13)
+        resolveEditAlign: (cell) => {
+            if (adapter.getCellFormat === undefined) {
+                return null
+            }
+            const readText = lazyCellText(adapter, cell.row, cell.col)
+            return resolveCellAlign(paintedFormatOf(cell.row, cell.col, readText), readText)
+        },
+        // エディタ塗り (v0.8 §2.3): 塗り書式の文字装飾をシンクへ、行箱 / 垂直揃えは editPaintRef 経由で overlay へ
+        resolveEditPaint: (cell) => (adapter.getCellFormat === undefined ? null : resolveEditPaint(paintedFormatOf(cell.row, cell.col, lazyCellText(adapter, cell.row, cell.col)))),
+        editPaintRef,
+        repaintOverlay,
+        // 検証ゲート (v0.8 §4.2.6) — 編集列 fillSelection と共有する root の useCallback
+        validateCommit,
+    })
+    // レンダー時代入でシームを実体へ接続 (paramsRef と同じ規律 — 構築循環切りの ref 間接)
+    isEditingRef.current = editor.isEditing
+    requestCommitRef.current = editor.requestCommit
+    startEditRef.current = editor.startEdit
+    getPointingRef.current = editor.getPointing
+    insertReferenceRef.current = editor.insertReference
+    captureSinkRef.current = editor.captureSink
+    restoreSinkRef.current = editor.restoreSink
+
+    /**
+     * Session cancel + the dismissal of a stale strict-rejection notice (分冊 08 §4.3): the
+     * rejection belongs to the abandoned commit attempt, so a cancel that ends (or discards)
+     * the session also closes its `message` popover — Excel dismisses the rejection dialog
+     * together with the edit. The passive inputMessage is untouched (closeRejectedMessage).
+     * セッション取消 + stale な strict 拒否告知の消灯 (分冊 08 §4.3)。拒否は放棄した commit 試行の
+     * もの — セッションを終える (捨てる) 取消はその message ポップオーバーも閉じる (Excel は編集
+     * ごと拒否ダイアログを畳む)。受動 inputMessage には触れない (closeRejectedMessage)。
+     */
+    const cancelEdit = useCallback(() => {
+        editor.cancelEdit()
+        closeRejectedMessage()
+    }, [editor.cancelEdit, closeRejectedMessage])
+
+    const clipboard = useClipboard({
+        enabled: !isEmpty,
+        sinkRef,
+        adapter,
+        isEditing,
+        getSelection,
+        setSelection,
+        commitPaste,
+        maxOperationCells,
+        onOperationRejected,
+        onCopyMultiRange,
+        repaintOverlay,
+        isDragging: isAnyDragging,
+        // v0.8 (§4.2.5): 寸法シーム (貼り付け寸法は gateResizeEntries を通り resizeTracks へ)、Ctrl+Shift+V の
+        // 武装 ref、通貨宣言、クリップ / 拒否 / 跨ぎ cut 元側の通知
+        resize: { rowAxis, colAxis, resizeTracks },
+        pendingPasteOptionsRef,
+        formats,
+        onClipChange,
+        onClipboardUnavailable,
+        onEditRejected,
+    })
+    getClipRef.current = clipboard.getClip
+    discardClipRef.current = clipboard.discardClip
+    discardClipOnCommitRef.current = clipboard.discardClipOnCommit
+    onAdapterSwitchRef.current = clipboard.onAdapterSwitch
+    pasteRef.current = clipboard.paste
+
+    // ---- ポップオーバー層 (v0.8 §4.1.15 / ADR-15) ----
+    const popovers = usePopovers({
+        enabled: !isEmpty,
+        adapter,
+        popovers: popoversProp,
+        sinkRef,
+        bodyRef,
+        handleRef,
+        rowAxis,
+        colAxis,
+        zoomRef,
+        getActive,
+        isEditing,
+        requestCommit,
+        focusSink,
+        rearmSink,
+        isDraggingAny,
+        commitEdits,
+        labels: resolvedLabels,
+        onHyperlinkOpen,
+        anchors: popoverAnchorsRef,
+        repaintOverlay,
+    })
+    popoversRef.current = popovers
+    openPopoverRef.current = popovers.open
+    hideNoteTipRef.current = popovers.hideTip
+
+    // ---- コマンド実行 (v0.8 §4.1.13 / ADR-17) ----
+    /** The active cell's viewport rect in visual px — the keyboard-origin cellRect recipe (onCellContextMenu twin) for onPasteSpecialRequest. / active セルの視覚 px 矩形 (keyboard 起点 cellRect のレシピ — onCellContextMenu と同式)。 */
+    const keyboardCellRect = useCallback(() => {
+        const active = selectionRef.current.active
+        // 画面外座標へメニューを出さない (§6.6.1) — 可視化してからハンドルの同期読み (§7-4)
+        ensureCellVisible(active)
+        const handle = handleRef.current
+        const position = handle === null ? { x: 0, y: 0 } : handle.getScrollPosition()
+        const frozen = handle === null ? { rows: 0, cols: 0 } : handle.getFrozenSize()
+        // 両軸とも番兵クランプ (detached の {-1, -1} を座標へ流さない)、ズーム境界で視覚 px へ
+        const z = zoomRef.current
+        return {
+            top: rowToViewportY(rowAxis, active.row, Math.max(0, position.y), frozen.rows) * z,
+            left: colToViewportX(colAxis, active.col, Math.max(0, position.x), frozen.cols) * z,
+            width: colAxis.sizeOf(active.col) * z,
+            height: rowAxis.sizeOf(active.row) * z,
+        }
+    }, [rowAxis, colAxis, ensureCellVisible])
+    const commands = useCommands({
+        adapter,
+        getSelection,
+        commitEdits,
+        getActive,
+        isEditing,
+        requestCommit,
+        cancelEdit,
+        getSessionText: editor.getSessionText,
+        validateCommit,
+        insertAtCaret: editor.insertAtCaret,
+        refreshEditPaint: editor.refreshPaint,
+        maxOperationCells,
+        onOperationRejected,
+        colors: resolvedColors,
+        formats,
+        getHighlight: () => highlightRef.current,
+        setHighlight: requestHighlight,
+        popovers: popoversProp,
+        openPopover: (kind) => openPopoverRef.current(kind),
+        onHyperlinkOpen,
+        onPasteSpecialRequest,
+        paste: (options) => pasteRef.current(options),
+        rowAxis,
+        colAxis,
+        resizeTracks,
+        defaultRowHeight,
+        defaultColumnWidth,
+        now,
+        announce,
+        formatCommandAnnouncement,
+        keyboardCellRect,
+    })
+    commandsRef.current = commands
+    executeCommandRef.current = commands.executeCommand
+    isCommandAvailableRef.current = commands.isCommandAvailable
+    /** Keyboard command dispatch (one declaration per table identity; execute / isAvailable through the refs). / キーボードのコマンド配送 (表 identity 毎に 1 宣言、実行は ref 経由)。 */
+    const commandDispatch = useMemo((): CommandDispatch => ({ table: commandTable, execute: (command) => executeCommandRef.current(command), isAvailable: (command) => isCommandAvailableRef.current(command) }), [commandTable])
+
+    // Undo / Redo の発火はクリップの破棄条件 (§6.5.4-4 — 巻き戻し後の古い指紋で move を成立させない。copy アンツも Excel 同様消灯)
+    const handleUndoRequest = useCallback(() => {
+        discardClip()
+        onUndoRequest?.()
+    }, [discardClip, onUndoRequest])
+    const handleRedoRequest = useCallback(() => {
+        discardClip()
+        onRedoRequest?.()
+    }, [discardClip, onRedoRequest])
+
+    // ---- キーボード (§6.6) ----
+    useGridKeyboard({
+        zoomRef,
+        enabled: !isEmpty,
+        sinkRef,
+        rootRef,
+        handOffFocusToRoot,
+        getSelection,
+        setSelection,
+        moveActive,
+        ensureCellVisible,
+        isEditing,
+        requestCommit,
+        startEdit,
+        commitEdits,
+        maxOperationCells,
+        onOperationRejected,
+        getClip,
+        discardClip,
+        isDragging: isDraggingAny,
+        abortDrag: abortDragAny,
+        // 能力はキーごとに paramsRef 経由で読まれる — adapter identity 切替 (シート切替) の
+        // 再レンダーで自然に追随する (§2.1)
+        findDataEdge: adapter.findDataEdge,
+        getEditingMode: editor.getEditingMode,
+        cancelEdit,
+        onUndoRequest: handleUndoRequest,
+        onRedoRequest: handleRedoRequest,
+        onCellContextMenu,
+        rowAxis,
+        colAxis,
+        handleRef,
+        rearmSink,
+        // v0.8 (§4.2.7): コマンド表、編集列のポインティング行、Delete の hyperlink 消去、Escape step 0、Ctrl+Shift+V
+        commands: commandDispatch,
+        pointing: editor,
+        adapter,
+        hideNoteTip: () => hideNoteTipRef.current(),
+        // Escape チェーン step 1 (分冊 08 §4.3): strict 拒否 message の消灯 (受動 inputMessage は対象外)
+        closeRejectedMessage,
+        pendingPasteOptionsRef,
+        // ポインティング行の参照矩形 (分冊 04 §3.20): 固定 "point" モードの writer リレー
+        onPointFrame,
+    })
+
+    // ---- 入力メッセージ (root 方針): active セルが変わるたび、前のメッセージを畳んで新セルの inputMessage を出す ----
+    const activeRow = selection.active.row
+    const activeCol = selection.active.col
+    useLayoutEffect(() => {
+        const controller = popoversRef.current
+        if (controller === null) {
+            return
+        }
+        // tip ↔ シンクの説明結合は「ホバーセルが active の間」の不変条件 (ADR-15) — active 変化のたびに再評価する
+        // (tip の載るセルから離れれば外し、tip の載るセルへ乗れば結ぶ。message 能力とは独立)
+        controller.syncTipAriaDescribedBy()
+        if (!controller.isKindEnabled("message")) {
+            return
+        }
+        // 前セルの message (入力メッセージ / strict 拒否) は閉じる — エディタ kind は触らない
+        if (controller.isOpen() === "message") {
+            controller.close()
+        }
+        // 新 active セルに inputMessage があれば載せる (無ければ open は no-op)
+        controller.open("message")
+    }, [activeRow, activeCol])
+
+    // 強調状態の変化 (制御 / 非制御どちらも解決値) は overlay の命令再描画 (帯は repaint 時にだけ読まれる)
+    useLayoutEffect(() => {
+        repaintOverlay()
+    }, [repaintOverlay, highlightValue.row, highlightValue.column, highlightValue.intersection])
+
+    // ---- シンクの直クリックガード (idle の armed 選択保護 — §4.2 ADR-4。所有は SelectionOverlay) ----
+    const onSinkMouseDown = useCallback(
+        (event: MouseEvent) => {
+            if (!(isEditingRef.current?.() ?? false)) {
+                event.preventDefault()
+                focusSink()
+                rearmSink()
+            }
+        },
+        [focusSink, rearmSink],
+    )
+
+    // ---- WCAG 2.1.2 再進入 (§10-4): React onFocus (focusin バブリング) + relatedTarget 規則 ----
+    const onRootFocus = useCallback(
+        (event: React.FocusEvent<HTMLDivElement>) => {
+            const root = rootRef.current
+            const related = event.relatedTarget
+            // relatedTarget が root 内 (シンク含む) の内部移動。**シンク**を離れて root 自身に着地した
+            // フォーカスは、Escape の脱出 (旗つき — handOffFocusToRoot) 以外は押下既定動作が逃がした迷子
+            // (touch・ペンのタップは OSK 回避で素通し / 押下ゲートが見ない chord 遷移の取りこぼし) —
+            // シンクへ戻す (再武装しない: 編集セッションの値を守る)。シンクはキーボードでは root へ焦点を
+            // 渡さない (Tab は巡回として消費、Escape は旗つき) ため、旗なしのシンク → root は常に迷子。
+            // 他の root 内要素からの着地 (スクロールバー矢印ボタンや renderCell のフォーカス要素からの
+            // Shift+Tab 後方巡回) は休止点として root に留める — 戻すと後方 Tab がグリッド内で巡回に
+            // 消費され、後方脱出が Escape 経由でしかできなくなる (R3 / R4 是正 — フォーカス不変条件)
+            if (root !== null && related instanceof Node && root.contains(related)) {
+                if (event.target === root && related === sinkRef.current && !escapeHandOffRef.current) {
+                    focusSink()
+                }
+                return
+            }
+            // 編集セッション生存中は再武装しない — requestCommit の composition 経路 (blur →
+            // focusSink) は relatedTarget=null の focusin をここへ届け、rearm すると commit 失敗で
+            // 維持したはずの編集値を " " で上書き破壊する (suppressFocusoutCommit と対の窓)
+            if (isEditingRef.current?.() ?? false) {
+                return
+            }
+            // 外部からの Tab / Shift+Tab 進入・プログラム focus → シンクへ回収 + 再武装
+            focusSink()
+            rearmSink()
+        },
+        [focusSink, rearmSink],
+    )
+
+    // ---- グリッド脱出 (root の focusout バブリング) で仮想キーボードの招待を下ろす ----
+    /** Withdraws the virtual-keyboard invitation when focus really leaves the grid (in-root moves and the editor's composition-confirming internal blur are not exits). / 本当にグリッド外へ出る focusout で招待を下ろす (root 内移動と composition 確定の内部 blur は脱出でない)。 */
+    const onRootBlur = useCallback(
+        (event: React.FocusEvent<HTMLDivElement>) => {
+            const root = rootRef.current
+            const related = event.relatedTarget
+            if (root !== null && related instanceof Node && root.contains(related)) {
+                return
+            }
+            // requestCommit の composition 確定 blur (relatedTarget null) は直後に focusSink で戻る内部往復 —
+            // 招待を下ろすと変換中に別セルを押した利用者の OSK が消える
+            if (editor.isFocusoutSuppressed()) {
+                return
+            }
+            setVirtualKeyboard(false)
+        },
+        [editor],
+    )
+
+    // ---- 中ボタンリリースの抑止 (R3 / R4 是正): Linux Chromium の PRIMARY selection 貼り付けは中ボタン
+    //      **リリース**の既定動作。押下面の preventDefault でフォーカスがシンクに留まるため、リリースを
+    //      止めないとシンクへ paste が届き、選択中の " " (または直近の PRIMARY 文字列) がアクティブセル /
+    //      選択範囲へ静かに書き込まれる (実ブラウザ実証: pointerup の preventDefault で貼り付けは止まる)。
+    //      武装は 1 回限りの window capture (グリッド外リリースも止める)、pointercancel で解除 ----
+    const middleReleaseRef = useRef<{ up: (event: PointerEvent) => void; cancel: (event: PointerEvent) => void } | null>(null)
+    /** Disarms the middle-release canceller (idempotent). / 中ボタンリリース抑止の解除 (冪等)。 */
+    const disarmMiddleRelease = useCallback(() => {
+        const armed = middleReleaseRef.current
+        if (armed === null) {
+            return
+        }
+        middleReleaseRef.current = null
+        window.removeEventListener("pointerup", armed.up, true)
+        window.removeEventListener("pointercancel", armed.cancel, true)
+    }, [])
+    /** Arms the one-shot middle-release canceller: the next pointerup of any button disarms it, a middle one is also cancelled. / 中ボタンリリース抑止の武装 (次の pointerup で解除、中ボタンなら既定動作も止める)。 */
+    const armMiddleRelease = useCallback(() => {
+        if (middleReleaseRef.current !== null) {
+            return
+        }
+        const up = (event: PointerEvent) => {
+            // mouse のリリースだけが解除 / 抑止の対象 — 中ボタン保持中の touch タップ (別ポインタ) で
+            // 解除すると本物の中ボタンリリースが素通りし PRIMARY 貼り付けの穴が再開する (R5 是正)
+            if (event.pointerType !== "mouse") {
+                return
+            }
+            disarmMiddleRelease()
+            if (event.button === 1) {
+                event.preventDefault()
+            }
+        }
+        const cancel = (event: PointerEvent) => {
+            if (event.pointerType === "mouse") {
+                disarmMiddleRelease()
+            }
+        }
+        middleReleaseRef.current = { up, cancel }
+        window.addEventListener("pointerup", up, true)
+        window.addEventListener("pointercancel", cancel, true)
+    }, [disarmMiddleRelease])
+    useEffect(() => disarmMiddleRelease, [disarmMiddleRelease])
+
+    // ---- root capture のポインタ監視 (R3 / R4 是正): 中ボタン押下でリリース抑止を武装し、chord 遷移
+    //      (主ボタン保持中の 2 本目の押下 / 解放) の既定動作を止める。chord 遷移は pointerdown / pointerup
+    //      でなく **pointermove** (buttons の変化) で届くため押下面のゲートには見えない — 止めないと compat
+    //      mousedown がフォーカスを root や矢印ボタンへ逃がし、compat mouseup が PRIMARY 貼り付けを
+    //      シンクへ届ける (実ブラウザ実証)。主ボタン先行解放後の実 pointerup (中ボタン) は武装済みの
+    //      抑止が止める ----
+    useEffect(() => {
+        const root = rootRef.current
+        if (isEmpty || root === null) {
+            return
+        }
+        // 直近に観測した mouse の buttons (chord 遷移 = 同じポインタの buttons が move で変わること)
+        let lastButtons = 0
+        const onPointerDown = (event: PointerEvent) => {
+            if (event.pointerType !== "mouse") {
+                // touch / ペンの押下 = スクロール意図: 仮想キーボードの招待を下ろす (タップでシンクへ焦点が
+                // 戻っても OSK を出さない — 招待中でなければ同値 setState で無再描画)。**セッション中は
+                // 下ろさない** (R8 是正): 生き残る変換は必ずセッションの中にある (ドラッグ飛行中に始まった
+                // 変換だけがセッションを持たず、それは待機シンクの自己修復が捨てる) ため、この 1 条件で
+                // 「変換中に属性が変わらない」が成立する (グリッド脱出の解除は blur が変換を先に確定してから届く)。
+                // 編集中の touch 押下はキャレット配置 / スクロールで、OSK で入力中の利用者から
+                // キーボードを奪わない — 解除はセッション終了後の次の touch 押下
+                if (!(isEditingRef.current?.() ?? false)) {
+                    setVirtualKeyboard(false)
+                }
+                return
+            }
+            lastButtons = event.buttons
+            if (event.button !== 1) {
+                return
+            }
+            // 編集中のエディタ (シンク) への中クリックは textarea の PRIMARY 貼り付け (プラットフォーム慣習)
+            if (event.target === sinkRef.current && (isEditingRef.current?.() ?? false)) {
+                return
+            }
+            armMiddleRelease()
+        }
+        const onPointerUp = (event: PointerEvent) => {
+            if (event.pointerType === "mouse") {
+                lastButtons = event.buttons
+            }
+        }
+        const onPointerMove = (event: PointerEvent) => {
+            if (event.pointerType !== "mouse" || event.buttons === lastButtons) {
+                return
+            }
+            const gained = event.buttons & ~lastButtons
+            lastButtons = event.buttons
+            // chord 遷移の既定動作を止める (フォーカス移動 / PRIMARY 貼り付け)。各機械の own move 処理は
+            // 素通し (preventDefault は伝播を止めない — 主ボタンの chord 解放はそこで確定する)
+            event.preventDefault()
+            if ((gained & 4) !== 0) {
+                armMiddleRelease()
+            }
+        }
+        root.addEventListener("pointerdown", onPointerDown, true)
+        root.addEventListener("pointerup", onPointerUp, true)
+        root.addEventListener("pointermove", onPointerMove, true)
+        return () => {
+            root.removeEventListener("pointerdown", onPointerDown, true)
+            root.removeEventListener("pointerup", onPointerUp, true)
+            root.removeEventListener("pointermove", onPointerMove, true)
+        }
+    }, [isEmpty, armMiddleRelease])
+
+    // ---- 未所有面の最終ゲート (§6.8-3 の第 8 サイト — R3 / R4 是正) ----
+    /** Dead-space press gate on the zoom wrapper's OWN pixels (e.g. the strip under the row-header band): cancel the focus move, commit gate, focus recovery. Owned surfaces keep their own gates — this one never covers for them. / ズームラッパー自身のピクセル (行ヘッダー帯下の余白等) の押下ゲート。所有面の肩代わりはしない。 */
+    const onZoomPointerDown = useCallback(
+        (event: React.PointerEvent<HTMLDivElement>) => {
+            // ラッパー自身が標的の押下だけを受け持つ (所有面 — セル / ヘッダー / コーナー / バー帯 / fill /
+            // リサイズ / シンク — の押下は各面のゲートの責務。defaultPrevented で肩代わりすると各面の
+            // 欠落が本ゲートに隠れて検出不能になる — R4 是正)。touch / ペンは素通し (OSK は仮想キーボード
+            // 招待フラグが扱う — touch / ペンの押下は root capture の監視が招待を下ろす。迷子は onRootFocus が回収する)
+            if (event.target !== event.currentTarget || event.pointerType !== "mouse") {
+                return
+            }
+            // 止めないと mousedown 既定が root group へフォーカスを移しキーボードが全滅する (コーナーと同型)
+            event.preventDefault()
+            if (event.button !== 0) {
+                return
+            }
+            // 参照ポインティング中 (v0.8 §4.2.13): 死空間押下は consume してシンクへ焦点を戻すだけ (確定も挿入もしない)
+            if (isPointing()) {
+                focusSink()
+                return
+            }
+            // 編集中の requestCommit ゲート (§6.8-3): 死空間もフォーカス不動で focusout が発火しない
+            if (isEditing() && !requestCommit()) {
+                focusSink()
+                return
+            }
+            focusSink()
+        },
+        [focusSink, isEditing, requestCommit, isPointing],
+    )
+
+    // ---- マウント武装 + 初期 rowRange 種付け (空→非空「エッジ」限定 — Phase 1 実装レビュー R3 の
+    //      correctness 実欠陥ゲート。deps は rowAxis 再構築でも発火するため、エッジ判定 ref で
+    //      「非空のまま軸だけ変わった」ケースの再種付け (深部スクロール中の rowRange 巻き戻し) を防ぐ) ----
+    const seededRef = useRef(false)
+    useLayoutEffect(() => {
+        if (isEmpty) {
+            seededRef.current = false
+            return
+        }
+        if (seededRef.current) {
+            return
+        }
+        seededRef.current = true
+        // フォーカス中立の武装 — マウントでページのフォーカスを奪わない (v0.7 まで select() の副作用で
+        // Blink / WebKit がシンクを自動フォーカスしていた。キーボード進入は Tab / クリックの再進入経路)
+        rearmSink()
+        // 初期 rowRange の種付け: onRangeChange の初回配送は rAF ×2 遅れる。getRange() は
+        // 「pull かつ 1 レンダー古い」、getViewportSize() も初回計測前は {0, 0} (未計測初期値。
+        // -1 番兵は getScrollPosition の detached 系のみ — 実測) のため、
+        // root の clientHeight をマウント時 1 回だけ layout read して可視域を種付けする
+        // (§6.7.2-3 の gBCR 禁止規律はホットパス対象 — マウント 1 回は対象外。ヘッダー帯ぶんの
+        // わずかな過剰被覆は無害で、直後の onRangeChange 初回配送が正す)
+        // ズーム下では root clientHeight は視覚 px — 論理 px へ ÷z (v0.3。z=1 は従来どおり)
+        const seedHeight = (rootRef.current?.clientHeight ?? 0) / zoomRef.current
+        if (seedHeight > 0 && rowAxis.totalSize() > 0) {
+            viewStore.setRowRange(0, rowAxis.indexAt(Math.min(seedHeight - 1, rowAxis.totalSize() - 1)))
+        }
+        // 列レンジも対称に種付け (§7-5 — ColumnHeader の初回可視化。行ヘッダー帯ぶんの過剰被覆は
+        // 行側と同じく無害で、onRangeChange の初回配送が正す)
+        const seedWidth = (rootRef.current?.clientWidth ?? 0) / zoomRef.current
+        if (seedWidth > 0 && colAxis.totalSize() > 0) {
+            viewStore.setColRange(0, colAxis.indexAt(Math.min(seedWidth - 1, colAxis.totalSize() - 1)))
+        }
+    }, [isEmpty, rearmSink, viewStore, rowAxis, colAxis])
+
+    // ---- シート切替 (adapter identity 変化 — §6.2.3) は選択を初期 A1 へリセットする ----
+    // 旧グリッド座標のレンジは新軸で out-of-bounds になり得て、repaintOverlay の sizeOf が
+    // 例外を投げる (Fenwick は範囲外 index で fail-fast) — クランプでなくシート切替の意味論
+    // どおり全リセット (Excel のシート切替と同じく選択は持ち越さない)
+    const prevAdapterRef = useRef(adapter)
+    useLayoutEffect(() => {
+        if (prevAdapterRef.current !== adapter) {
+            prevAdapterRef.current = adapter
+            // 飛行中ドラッグは復元なしで取り消す (各機械の dragBeforeRef は旧シート座標 — 復元経路
+            // (Escape / lostpointercapture) から新軸へ範囲外選択が漏れるのを断つ)
+            engine.cancelDrag()
+            colHeaderMachine.cancelDrag()
+            rowHeaderMachine.cancelDrag()
+            headerResizeMachine.cancelDrag()
+            fillMachine.cancelDrag()
+            // 参照ドラッグ (v0.8 usePointDrag) も同列で取り消す (spec 05 D-21 の是正): capture 解放 +
+            // 参照矩形消灯 + 両軸スクローラー停止。シンク断面は復元しない (直後の cancelEdit がセッション
+            // ごと捨てる)。放置すると旧軸座標の rAF / スクローラー tick が新シートへ insertReference し、
+            // capture と合成ドラッグ面 (キー全 consume・clipboard 凍結) は次の pointerup まで残る
+            pointDrag.cancelDrag()
+            // 編集セッションも復元なしで終了 (値破棄 — Excel のシート切替と同じくエディタを持ち
+            // 越さない)。commit しない: 旧 adapter は既に props から消えており、放置すると次の
+            // commit が新シートの同座標へ誤書込する (縮小シートでは範囲外 throw で固着、空シート
+            // では sink ごと消えた宙吊りセッションが rearm を恒久抑止する)
+            editor.cancelEdit()
+            // ポップオーバーとアンカーも畳む (v0.8): 旧シート座標のアンカーを新軸の repaint に持ち越さない
+            // (範囲外 index は Fenwick が fail-fast する) — 以降の破棄 / repaint より前
+            popoversRef.current?.hideTip()
+            popoversRef.current?.close()
+            // hx の新列軸への再クランプは v0.4 からグリッド内部 (総幅と木の恒常同期) が担う —
+            // 明示 reclamp は退役 (狭いシートへの切替でもグリッドが同コミットで自己回復する)
+            if (isEmpty) {
+                // 空アダプタへの切替はラッパーを通さず直接リセット — 0 行グリッドに A1 は存在せず、
+                // 通知 (onSelectionChange) も読み上げ (getCellText) も rearm も流してはならない
+                selectionRef.current = INITIAL_SELECTION
+                setSelectionState(INITIAL_SELECTION)
+            } else {
+                setSelection(INITIAL_SELECTION)
+            }
+            // クリップはシート切替の意味論 (v0.8 §4.2.5): copy は破棄、cut は foreign として保持し
+            // 切替先の paste を跨ぎ move にする (マーキーは foreign で非表示 — 旧シート座標を新軸で
+            // 描かない)。選択リセットの後に置く**防御的順序** (R5(H) 実測注記): 現配線では
+            // repaintOverlayRef が passive effect 代入のため、この layout effect 中の同期 repaint は
+            // 旧クロージャ (旧軸) で走り、旧選択が範囲外になる事故は起こり得ない。ref 代入を layout
+            // effect 化する将来変更でこの順序が実防壁になるため維持する
+            onAdapterSwitchRef.current()
+        }
+    }, [adapter, isEmpty, setSelection, engine, colHeaderMachine, rowHeaderMachine, headerResizeMachine, fillMachine, pointDrag, viewStore, editor.cancelEdit])
+
+    // ---- 凍結列数の変化 (v0.5 ライブ prop) は飛行中ジェスチャを復元なしで取り消す ----
+    // 押下時の grab オフセット / アンカーは旧パーティション座標系で確立済み — 変更後の鮮度
+    // ヒットテスト (新座標系) と混ざると、ユーザーが狙っていないセルへ fill が確定し得る
+    // (R2 実測: F 0 → 6 の途中変更で縦 1 セル fill が凍結列 4 セルへ誤書込)。シート切替シームと
+    // 同じ stale 座標遮断だが、座標系は同一グリッドのため選択と編集セッションは保持する
+    const prevFrozenColsRef = useRef(frozenColumns)
+    const prevFrozenRowsRef = useRef(frozenRows)
+    useLayoutEffect(() => {
+        // 列 / 行いずれの凍結変更も飛行中ドラッグを復元なしで取り消す (R2 是正の縦拡張 —
+        // 押下時アンカーは旧パーティション座標系。混成ヒットで誤 fill 確定を防ぐ)
+        if (prevFrozenColsRef.current !== frozenColumns || prevFrozenRowsRef.current !== frozenRows) {
+            prevFrozenColsRef.current = frozenColumns
+            prevFrozenRowsRef.current = frozenRows
+            engine.cancelDrag()
+            colHeaderMachine.cancelDrag()
+            rowHeaderMachine.cancelDrag()
+            headerResizeMachine.cancelDrag()
+            fillMachine.cancelDrag()
+            // 参照ドラッグも同列 (spec 05 D-21 の是正): 押下時 bodyRect / 原点セルは旧パーティション座標系。
+            // 取消 = capture 解放 + 矩形消灯 + スクローラー停止だけ — セッションと最後のトークンは保つ
+            // (cancelDrag は abortDrag と違いシンク断面を復元しない)
+            pointDrag.cancelDrag()
+        }
+    }, [frozenColumns, frozenRows, engine, colHeaderMachine, rowHeaderMachine, headerResizeMachine, fillMachine, pointDrag])
+
+    // ---- dataVersion (外部書込通知 §6.9-2 (b) — Undo / 協調編集) もクリップの破棄条件 ----
+    // adapter 外で値が書き戻ると cut 時行列のまま照合が通り、古い指紋の move が外部値を "" で
+    // clear する実データ喪失になる (グリッド内 Undo の中継破棄と同じ根拠を外部チャネルへ対称化)
+    const prevDataVersionRef = useRef(dataVersion)
+    useLayoutEffect(() => {
+        if (prevDataVersionRef.current !== dataVersion) {
+            prevDataVersionRef.current = dataVersion
+            discardClip()
+        }
+    }, [dataVersion, discardClip])
+
+    // 確定 SelectionState の変更で overlay を React 経路からも再描画 (§6.7.2-3 (a))
+    useLayoutEffect(() => {
+        repaintOverlay()
+    }, [repaintOverlay, selection])
+
+    // ---- SpreadsheetHandle (§6.9-8) ----
+    /** The command runner behind the handle's write methods (filled at render — null only before the first render completes). / handle の書込メソッドが使うコマンド実行器 (レンダー時充填)。 */
+    const requireCommands = useCallback((): CommandRunner => {
+        const runner = commandsRef.current
+        if (runner === null) {
+            throw new RangeError("[spreadsheet] the command runner is not mounted")
+        }
+        return runner
+    }, [])
+    useImperativeHandle(
+        ref,
+        () => ({
+            resizeRow: (row: number, heightPx: number) => {
+                // 丸めは一度だけ — rowAxis とグリッド内部木へ同一値を渡す (食い違うと高さ照合が巻き戻す)
+                const size = Math.round(heightPx)
+                rowAxis.resize(row, size)
+                handleRef.current?.updateRowSize(row, size)
+                viewStore.bumpRowGeometry()
+                // ウィンドウ原点より上をリサイズした場合、この同期 repaint は旧 windowOriginY 基準
+                // (新原点は rAF → RowHeader 再レンダー → layout effect で 1 フレーム後に確定 —
+                // §6.8-2 の順序契約の設計内猶予。自己修復するため実害なし)
+                repaintHeaders()
+                repaintOverlay()
+            },
+            resizeColumn: (col: number, widthPx: number) => {
+                // 対呼び出し (§3.8): colAxis (SSOT) を先に更新し、グリッドの幅木へ通知する。
+                // 丸めは一度だけ — 両者へ同一値を渡す (食い違うと幅 self-heal が巻き戻す)
+                const size = Math.round(widthPx)
+                colAxis.resize(col, size)
+                handleRef.current?.updateColSize(col, size)
+                // ヘッダー再レンダーは colVersion (購読 2)、セル再配置と hx 再クランプはグリッドの
+                // 幅エポック + 総幅同期が担う。残差 transform は同期 repaint
+                viewStore.bumpColVersion()
+                repaintColHeaders()
+                repaintOverlay()
+            },
+            scrollToCell: (cell: CellCoord, options?: ScrollToCellOptions) => {
+                // エンジンのセル狙いジャンプへ素通し (§7-4 の真実。選択は変えない — 純 viewport 移動)。
+                // 深部 (10^9 px) でも量子化アンカー + 残差 transform で到達する
+                handleRef.current?.scrollToCell(cell.row, cell.col, options)
+            },
+            focus: (options?: { preventScroll?: boolean }) => {
+                // フォーカス回収 + 非編集なら再武装 (編集セッションの値は守る — §1.10)
+                focusSink(options)
+                if (!isEditing()) {
+                    rearmSink()
+                }
+            },
+            // コマンド / 書式 / 注釈の書込はコマンド実行器 (useCommands) の同じ経路 (ref 経由 — handle は安定)
+            executeCommand: (command: SpreadsheetCommand) => executeCommandRef.current(command),
+            applyFormat: (patch: CellFormatPatch) => requireCommands().applyFormat(patch),
+            setBorders: (preset: BorderPreset, border?: CellBorder) => requireCommands().setBorders(preset, border),
+            setHyperlink: (url: string | null) => requireCommands().setHyperlink(url),
+            setNote: (text: string | null) => requireCommands().setNote(text),
+            addComment: (input: CellCommentInput) => requireCommands().addComment(input),
+            setValidation: (rule: DataValidationRule | null) => requireCommands().setValidation(rule),
+            paste: (options: PasteOptions) => pasteRef.current(options),
+            getSelection: () => selectionRef.current,
+            // base = アダプタ書式 (能力分岐)、painted = base ⊕ CF (単一シーム resolvePaintedFormat)
+            getBaseFormat: (cell: CellCoord) => (adapter.getCellFormat === undefined ? undefined : adapter.getCellFormat(cell.row, cell.col)),
+            getPaintedFormat: (cell: CellCoord) => (adapter.getCellFormat === undefined ? undefined : paintedFormatOf(cell.row, cell.col, lazyCellText(adapter, cell.row, cell.col))),
+            // 命令的な編集開始は仮想キーボードを招待しない (ポインタ起点の onRequestEdit だけが招待する)
+            startEdit: (mode: "edit" | "replace") => {
+                startEdit(mode)
+            },
+            openPopover: (kind: PopoverKind) => {
+                openPopoverRef.current(kind)
+            },
+        }),
+        [rowAxis, colAxis, viewStore, repaintColHeaders, repaintHeaders, repaintOverlay, focusSink, isEditing, rearmSink, adapter, paintedFormatOf, startEdit, requireCommands],
+    )
+
+    // ---- 空グリッド分岐 (§6.9-1: フックの後・結線の前) ----
+    if (isEmpty) {
+        return <div className={className ? `aqsp-root ${className}` : "aqsp-root"} data-aqsp-empty="" data-testid={testId} />
+    }
+
+    // live region は読み上げ prop のどれか 1 つでも宣言されたときだけ描く (コマンド通知も同じ領域へ)
+    const hasAnnouncement = formatCellAnnouncement !== undefined || formatSelectionAnnouncement !== undefined || formatCommandAnnouncement !== undefined
+
+    return (
+        // biome-ignore lint/a11y/useSemanticElements: fieldset はフォーム意味論であり不適。role="group" は Escape 脱出の着地点に現在地名を与えるための選択 (§6.9-7 / §10-4)
+        // biome-ignore lint/a11y/noNoninteractiveTabindex: tabIndex=0 は WCAG 2.1.2 の脱出着地点 + グリッド再進入口 (§10-4) — 意図的な tab stop
+        <div ref={rootRef} className={className ? `aqsp-root ${className}` : "aqsp-root"} role="group" aria-label={resolvedLabels.rootAriaLabel} tabIndex={0} onFocus={onRootFocus} onBlur={onRootBlur} data-aqsp-root="" data-testid={testId}>
+            {/* ズームラッパー (v0.3): 視覚は transform スケール、内側レイアウトは 100%/z の論理 px —
+                virtualscroll の実測 (ResizeObserver / clientHeight) は論理値のまま。z=1 は無スタイル
+                (v0.2 と byte 同一の DOM 幾何 — 既存全ゲートの不変性) */}
+            <div className="aqsp-zoom" data-aqsp-zoom={zoomValue} onPointerDown={onZoomPointerDown} style={zoomValue === 1 ? undefined : { width: `${100 / zoomValue}%`, height: `${100 / zoomValue}%`, transform: `scale(${zoomValue})` }}>
+                <div
+                    className="aqsp-corner"
+                    aria-hidden="true"
+                    data-aqsp-corner=""
+                    onPointerDown={(event) => {
+                        // mouse 限定 (§6.4.1 の表ヘッダー「mouse のみ」— エンジン / ヘッダー機械と同一ゲート)
+                        if (event.pointerType !== "mouse") {
+                            return
+                        }
+                        // 非主ボタンも既定のフォーカス移動だけは止める (全押下面共通 — R2 是正)
+                        event.preventDefault()
+                        if (event.button !== 0) {
+                            return
+                        }
+                        // 参照ポインティング中 (v0.8 §4.2.13): コーナー押下は consume + シンクへ焦点 (全選択も確定もしない)
+                        if (isPointing()) {
+                            focusSink()
+                            return
+                        }
+                        // 編集中の requestCommit ゲート (§6.8-3 — コーナーもフォーカス不動で focusout 不発)
+                        if (isEditing() && !requestCommit()) {
+                            focusSink()
+                            return
+                        }
+                        focusSink()
+                        // コーナーの全セル選択は単一構築 state の setSelection 1 回 (過渡状態なし)。active = A1
+                        setSelection({
+                            ranges: [makeRange({ row: 0, col: 0 }, { row: adapter.rowCount - 1, col: adapter.colCount - 1 })],
+                            anchor: { row: 0, col: 0 },
+                            active: { row: 0, col: 0 },
+                        })
+                    }}
+                />
+                <ColumnHeader
+                    viewStore={viewStore}
+                    colAxis={colAxis}
+                    frozenCols={frozenColumns}
+                    handleRef={handleRef}
+                    bandRef={colHeaderRef}
+                    colTrackRef={colTrackRef}
+                    windowOriginXRef={windowOriginXRef}
+                    repaintColHeaders={repaintColHeaders}
+                    selectionRanges={selection.ranges}
+                    enableResizeUI={enableResizeUI}
+                />
+                <RowHeader
+                    viewStore={viewStore}
+                    rowAxis={rowAxis}
+                    handleRef={handleRef}
+                    bandRef={rowHeaderRef}
+                    selectionRanges={selection.ranges}
+                    rowTrackRef={rowTrackRef}
+                    windowOriginYRef={windowOriginYRef}
+                    repaintHeaders={repaintHeaders}
+                    enableResizeUI={enableResizeUI}
+                    frozenRows={frozenRows}
+                />
+                <div className="aqsp-body-stack" data-aqsp-body-stack="">
+                    <GridBody
+                        adapter={adapter}
+                        rowAxis={rowAxis}
+                        colAxis={colAxis}
+                        viewStore={viewStore}
+                        handleRef={handleRef}
+                        bodyRef={bodyRef}
+                        dataVersion={dataVersion}
+                        defaultColumnWidth={defaultColumnWidth}
+                        frozenColumns={frozenColumns}
+                        frozenRows={frozenRows}
+                        renderCell={renderCell}
+                        onScroll={onScroll}
+                        onRangeChange={onRangeChange}
+                        focusSink={focusSink}
+                        isEditing={isEditing}
+                        requestCommit={requestCommit}
+                        testId={testId ? `${testId}-vs` : undefined}
+                        __onCellRender={__onCellRender}
+                        cfIndexRef={cfIndexRef}
+                        cfMemoRef={cfMemoRef}
+                        isPointing={isPointing}
+                    />
+                    <SelectionOverlay
+                        rowAxis={rowAxis}
+                        colAxis={colAxis}
+                        handleRef={handleRef}
+                        sinkRef={sinkRef}
+                        getSelection={getSelection}
+                        editing={editor.editing}
+                        virtualKeyboard={virtualKeyboard}
+                        repaintRef={repaintOverlayRef}
+                        dragFrameRef={dragFrameRef}
+                        getClip={getClip}
+                        getIsDraggingAny={isDraggingAny}
+                        getIsFillDragging={fillMachine.isDragging}
+                        fillFrameRef={fillFrameRef}
+                        resizeGuideFrameRef={resizeGuideFrameRef}
+                        fillHandleNodeRef={fillHandleNodeRef}
+                        enableFillHandle={enableFillHandle}
+                        frozenCols={frozenColumns}
+                        frozenRows={frozenRows}
+                        sinkAriaLabel={resolvedLabels.sinkAriaLabel}
+                        onSinkMouseDown={onSinkMouseDown}
+                        editPaintRef={editPaintRef}
+                        highlightRef={highlightRef}
+                        highlightColors={overlayHighlightColors}
+                        popoverAnchors={popoverAnchorsRef}
+                        interactiveAnchorRef={interactiveAnchorRef}
+                        tipAnchorRef={tipAnchorRef}
+                    />
+                    {/* ポップオーバー層 (ADR-15): overlay の直後の兄弟 (CSS の前提順)。層は導出規則が true のときだけ DOM を持つ */}
+                    {popovers.layerEnabled ? <PopoverLayer controller={popovers} labels={resolvedLabels} renderPopover={renderPopover} interactiveAnchorRef={interactiveAnchorRef} tipAnchorRef={tipAnchorRef} /> : null}
+                </div>
+                {hasAnnouncement ? <div ref={liveRegionRef} className="aqsp-live-region" aria-live="polite" data-aqsp-live-region="" /> : null}
+            </div>
+        </div>
+    )
+})