@aiquants/spreadsheet 0.13.1 → 0.15.0

package/src/grid/GridBody.tsx

@@ -69,7 +69,8 @@ import { type CfIndex, type CfMemo, createCfMemo, resolvePaintedFormat } from ".
 import { isReadOnlyCell, lazyCellText, resolveCellAlign, resolveCellAttributes, type SpreadsheetDataAdapter } from "../model/dataAdapter.ts"
 import { isVisiblyInvalid } from "../model/dataValidation.ts"
 import type { SpreadsheetLocale } from "../model/labels.ts"
-import { SCROLLBAR_WIDTH, type ViewStore } from "../model/viewStore.ts"
+import type { ViewStore } from "../model/viewStore.ts"
+import { SPREADSHEET_SCROLLBAR_SIZE_PX } from "../view.ts"
 import { CellView, type RenderCellContext } from "./CellView.tsx"
 
 /** Inline style of a cell (React camelCase keys). / セルのインライン style (React の camelCase キー)。 */
@@ -354,12 +355,12 @@ type GridBodyProps = {
      */
     locale: SpreadsheetLocale
     /**
-     * The resolved engine chrome strings (the 7 VirtualScrollLabels keys: scroll arrows,
+     * The resolved engine chrome strings (every VirtualScrollLabels key, e.g. scroll arrows,
      * scroll-to-edge pills, "No items"), forwarded to VirtualGrid's `labels`. MUST be value-stable:
-     * its identity may change only when one of the 7 strings changes, otherwise every shell render
+     * its identity may change only when one of the strings changes, otherwise every shell render
      * pierces the memo boundary.
-     * 解決済みエンジンクローム文言 (VirtualScrollLabels の 7 キー: スクロール矢印・端スクロールピル・
-     * "No items")。VirtualGrid の `labels` へ素通し。値安定であること (7 文字列のどれかが変わった時だけ
+     * 解決済みエンジンクローム文言 (VirtualScrollLabels の全キー: スクロール矢印・端スクロールピル・
+     * "No items" など)。VirtualGrid の `labels` へ素通し。値安定であること (文字列のどれかが変わった時だけ
      * identity が変わる — さもなくば shell 再レンダー毎に memo 境界を貫通)。
      */
     scrollLabels: VirtualScrollLabels
@@ -430,7 +431,7 @@ const GridBodyInner = ({
     // (マウスドラッグは選択エンジンの所有)
     const behaviorOptions = useMemo(() => ({ enableKeyboardNavigation: false, pointerDragInputs: ["pen", "touch"] as const, resetOnGetItemHeightChange: true, resetOnGetColWidthChange: true, defaultColWidth: defaultColumnWidth }), [defaultColumnWidth])
     // タップサークル素通し (v0.10 §2.1): 未指定は undefined キー同乗 = エンジン宣言の不在信号
-    const scrollBarOptions = useMemo(() => ({ width: SCROLLBAR_WIDTH, tapScrollCircleOptions }), [tapScrollCircleOptions])
+    const scrollBarOptions = useMemo(() => ({ width: SPREADSHEET_SCROLLBAR_SIZE_PX, tapScrollCircleOptions }), [tapScrollCircleOptions])
     // 表示値書式の掛け金 (getCellProps が書き、同じセルの children が直後に消費 — 番兵は届かない座標)
     const displayLatchRef = useRef<DisplayLatch>({ row: -1, col: -1, value: undefined })
     /**

package/src/header/ColumnHeader.tsx

@@ -40,7 +40,8 @@ import { type ReactNode, type RefObject, useCallback, useLayoutEffect, useSyncEx
 import { type AxisModel, visibleIndicesInRange } from "../model/axisModel.ts"
 import type { CellRange } from "../model/cellCoord.ts"
 import { frozenWidthOf, trailingWidthOf } from "../model/frozenPartition.ts"
-import { SCROLLBAR_WIDTH, type ViewStore } from "../model/viewStore.ts"
+import type { ViewStore } from "../model/viewStore.ts"
+import { SPREADSHEET_SCROLLBAR_SIZE_PX } from "../view.ts"
 import { columnIndexToName } from "./columnName.ts"
 import { buildResizeStrips, buildTrailingResizeStrips } from "./resizeStrips.ts"
 
@@ -195,10 +196,13 @@ export const ColumnHeader = ({ viewStore, colAxis, frozenCols, frozenTrailingCol
                         ),
                     )}
                     {/* T_eff > 0 の inline right = 登記 calc() 形 #4 (ADR-19 例外レジスタ — 等価:
-                        SCROLLBAR_WIDTH + W_T_vis の CSS 衣装。W_T_vis = min(W_T, max(0, 100% −
-                        SCROLLBAR_WIDTH − W_F)) — 100% の再解決がブラウザ自身の heal チャネル。
+                        SPREADSHEET_SCROLLBAR_SIZE_PX + W_T_vis の CSS 衣装。W_T_vis = min(W_T, max(0, 100% −
+                        SPREADSHEET_SCROLLBAR_SIZE_PX − W_F)) — 100% の再解決がブラウザ自身の heal チャネル。
                         軸モデル値のみ補間しハンドルは読まない。T = 0 は inline right 不在 = v0.8 恒等) */}
-                    <div className="aqsp-col-header-scroll" data-aqsp-col-header-scroll="" style={{ left: frozenWidth, right: effectiveTrailingCols > 0 ? `calc(${SCROLLBAR_WIDTH}px + min(${trailingWidth}px, max(0px, 100% - ${SCROLLBAR_WIDTH + frozenWidth}px)))` : undefined }}>
+                    <div
+                        className="aqsp-col-header-scroll"
+                        data-aqsp-col-header-scroll=""
+                        style={{ left: frozenWidth, right: effectiveTrailingCols > 0 ? `calc(${SPREADSHEET_SCROLLBAR_SIZE_PX}px + min(${trailingWidth}px, max(0px, 100% - ${SPREADSHEET_SCROLLBAR_SIZE_PX + frozenWidth}px)))` : undefined }}>
                         {track}
                         {/* ヘッダー分割線セグメント (§2.4 — 存在 = 実効件数駆動の render 双子、可視 =
                             repaintColHeaders の等値抑制 display heal、幾何 = クリップ任せの静的値。
@@ -210,10 +214,10 @@ export const ColumnHeader = ({ viewStore, colAxis, frozenCols, frozenTrailingCol
                     {effectiveTrailingCols > 0 ? (
                         /* 末尾クリップ (§4.12): inline left = 登記 calc() 形 #3 (ADR-19 例外レジスタ —
                            等価: クリップ left = extent − W_T_vis の CSS 衣装。max() は leading 被覆
-                           画素を隠すだけでアンカーを動かさない)。right = SCROLLBAR_WIDTH (帯右端の
+                           画素を隠すだけでアンカーを動かさない)。right = SPREADSHEET_SCROLLBAR_SIZE_PX (帯右端の
                            縦バー帯ぶん)。クリップ箱の描画特性は scroll クリップと同一のため同クラスを
                            再利用 (フックは data-aqsp-col-header-trailing) */
-                        <div className="aqsp-col-header-scroll" data-aqsp-col-header-trailing="" style={{ left: `max(${frozenWidth}px, calc(100% - ${trailingWidth + SCROLLBAR_WIDTH}px))`, right: SCROLLBAR_WIDTH }}>
+                        <div className="aqsp-col-header-scroll" data-aqsp-col-header-trailing="" style={{ left: `max(${frozenWidth}px, calc(100% - ${trailingWidth + SPREADSHEET_SCROLLBAR_SIZE_PX}px))`, right: SPREADSHEET_SCROLLBAR_SIZE_PX }}>
                             {/* 右詰めインナー (width = W_T の木寸法箱): overlap ではクリップが左縁を隠し、
                                 右アンカーが帯の遠端整列を保つ (エンジン末尾クリップの右詰めインナー同文) */}
                             <div style={{ position: "absolute", top: 0, height: "100%", right: 0, width: trailingWidth }}>

package/src/header/RowHeader.tsx

@@ -26,7 +26,8 @@ import { type ReactNode, type RefObject, useCallback, useLayoutEffect, useSyncEx
 import { type AxisModel, visibleIndicesInRange } from "../model/axisModel.ts"
 import type { CellRange } from "../model/cellCoord.ts"
 import { frozenHeightOf, trailingHeightOf } from "../model/frozenPartition.ts"
-import { SCROLLBAR_WIDTH, type ViewStore } from "../model/viewStore.ts"
+import type { ViewStore } from "../model/viewStore.ts"
+import { SPREADSHEET_SCROLLBAR_SIZE_PX } from "../view.ts"
 import { buildResizeStrips, buildTrailingResizeStrips } from "./resizeStrips.ts"
 
 type RowHeaderProps = {
@@ -145,9 +146,9 @@ export const RowHeader = ({ viewStore, rowAxis, handleRef, bandRef, selectionRan
     )
 
     // margin-bottom はグリッド内在の横バー帯ぶんの切り上げ — CSS は TS 定数を読めないため
-    // インライン指定 (SCROLLBAR_WIDTH の単一 SSOT — SelectionOverlay の right / bottom と同方式)
+    // インライン指定 (SPREADSHEET_SCROLLBAR_SIZE_PX の単一 SSOT — SelectionOverlay の right / bottom と同方式)
     return (
-        <div ref={mergedBandRef} className="aqsp-row-header" aria-hidden="true" data-aqsp-row-header="" style={{ marginBottom: SCROLLBAR_WIDTH }}>
+        <div ref={mergedBandRef} className="aqsp-row-header" aria-hidden="true" data-aqsp-row-header="" style={{ marginBottom: SPREADSHEET_SCROLLBAR_SIZE_PX }}>
             {/* track transform は repaintHeaders (命令パス) の専有物 — React は書かない (§6.8-2 (b))。
                 v0.6: R > 0 はスクロール track を静的クリップ (top = H_F) で包み、凍結ラベルを帯直下の
                 静的 subtree に置く (ColumnHeader の 2 帯を転置)。v0.9: T > 0 は末尾静的サブツリー

package/src/model/labels.ts

@@ -2,14 +2,14 @@
  * @fileoverview UI label vocabulary (v0.8 §1.6 / §4.1.17) — the ONE label bag of the package, now
  * per UI chrome locale ("en" default, "ja" second). The v0.7 `sinkAriaLabel` / `rootAriaLabel`
  * props are folded into it (clean cut-over: no alias props remain), joined by the popover strings
- * of the rich-cell UI and by the seven engine chrome strings of `@aiquants/virtualscroll`
- * (scroll arrows, scroll-to-edge pills, "No items"), which are REUSED from
- * `VIRTUAL_SCROLL_LABEL_CATALOGS` and never re-typed here. Pure, React-free.
+ * of the rich-cell UI and by the engine chrome strings of `@aiquants/virtualscroll` (every key of
+ * `VIRTUAL_SCROLL_LABEL_KEYS`, e.g. scroll arrows, scroll-to-edge pills, "No items"), which are
+ * REUSED from `VIRTUAL_SCROLL_LABEL_CATALOGS` and never re-typed here. Pure, React-free.
  *
  * Contract (each clause is pinned by labels.spec.ts):
  * - `SpreadsheetLocale` is the engine's locale set (`VirtualScrollLocale`); it is the UI chrome
  *   language and a different axis from `formats.locale` (BCP-47 value formatting).
- * - `SpreadsheetLabels` is the closed 28-key set (7 engine keys + 21 own keys);
+ * - `SpreadsheetLabels` is the closed key set (every engine key + the 21 own keys);
  *   `SPREADSHEET_LABEL_CATALOGS` supplies a frozen catalog per locale. Count-aware keys are typed
  *   `string | ((n: number) => string)`.
  * - `resolveLabels(locale, overrides)` is the single fold point: the locale is resolved by
@@ -21,7 +21,7 @@
  * - `assertLabels`: every non-count own key is a non-blank string, a count key is a non-blank
  *   string or a function, and `sinkAriaLabel` MUST mention "Escape" (WCAG 2.1.2 escape-method
  *   advisement, spec 00 §10-4) — otherwise a RangeError, thrown at mount by the root.
- * - `pickEngineLabels(labels)` hands the 7 engine keys to the embedded VirtualGrid.
+ * - `pickEngineLabels(labels)` hands every engine key (`VIRTUAL_SCROLL_LABEL_KEYS`) to the embedded VirtualGrid.
  * - `resolveLabel(labels, key, n)` is the single read point: a function-valued label receives `n`
  *   (omitting `n` for a function value is a RangeError — never a silent 0), a string is returned
  *   as-is (`n` ignored, so a consumer may override a count key with a plain string).
@@ -29,11 +29,11 @@
  * UI ラベル語彙 (v0.8 §1.6 / §4.1.17) — パッケージ唯一のラベル集合で、UI クロームロケール別
  * ("en" が既定、"ja" が第 2 ロケール)。v0.7 の `sinkAriaLabel` / `rootAriaLabel` prop を畳み込み
  * (クリーンカットオーバー: 別名 prop は残さない)、リッチセル UI のポップオーバー文言と
- * `@aiquants/virtualscroll` の 7 つのエンジンクローム文言 (スクロール矢印、端スクロールピル、
- * "No items") を加える。エンジン文言は `VIRTUAL_SCROLL_LABEL_CATALOGS` を再利用し、ここでは再記述
- * しない。純関数・React 非依存。
+ * `@aiquants/virtualscroll` のエンジンクローム文言 (`VIRTUAL_SCROLL_LABEL_KEYS` の全キー — スクロール
+ * 矢印、端スクロールピル、"No items" など) を加える。エンジン文言は `VIRTUAL_SCROLL_LABEL_CATALOGS` を
+ * 再利用し、ここでは再記述しない。純関数・React 非依存。
  * 契約: `SpreadsheetLocale` はエンジンのロケール集合 (UI クローム言語で、値書式の `formats.locale`
- * とは別軸)。`SpreadsheetLabels` は閉じた 28 キー (エンジン 7 + 固有 21)、`SPREADSHEET_LABEL_CATALOGS`
+ * とは別軸)。`SpreadsheetLabels` は閉じたキー集合 (エンジンキー全件 + 固有 21)、`SPREADSHEET_LABEL_CATALOGS`
  * はロケール別の凍結カタログ、件数キーは `string | ((n: number) => string)`。`resolveLabels` が唯一の
  * 畳込み点 (ロケールは `resolveVirtualScrollLocale` で解決 — undefined は "en"、未知は RangeError。
  * override 未指定はカタログを identity で返却。それ以外は override を素の object (プロトタイプが
@@ -41,7 +41,7 @@
  * `resolveVirtualScrollLabels` で解決、固有キーは undefined でない override を採用し、`assertLabels`
  * 検証の後に凍結)。`assertLabels` は固有キーの非空白文字列性 (件数キーは関数も可) と
  * `sinkAriaLabel` の "Escape" 告知 (spec 00 §10-4) を検証し、違反はマウント時 RangeError。
- * `pickEngineLabels` は埋込み VirtualGrid へ渡すエンジン 7 キーの抽出。`resolveLabel` が唯一の
+ * `pickEngineLabels` は埋込み VirtualGrid へ渡すエンジンキー全件の抽出。`resolveLabel` が唯一の
  * 読み出し点 (関数値は n 必須 — 省略は RangeError、文字列はそのまま)。
  */
 
@@ -59,10 +59,11 @@ import { resolveVirtualScrollLabels, resolveVirtualScrollLocale, VIRTUAL_SCROLL_
 export type SpreadsheetLocale = VirtualScrollLocale
 
 /**
- * The closed label vocabulary: the 7 engine chrome keys of `@aiquants/virtualscroll` plus the 21
- * own keys of the spreadsheet. Every key has a value in each SPREADSHEET_LABEL_CATALOGS entry;
+ * The closed label vocabulary: every engine chrome key of `@aiquants/virtualscroll`
+ * (VIRTUAL_SCROLL_LABEL_KEYS) plus the 21 own keys of the spreadsheet. Every key has a value in
+ * each SPREADSHEET_LABEL_CATALOGS entry;
  * consumers override any subset through the `labels` prop (SpreadsheetLabelOverrides).
- * 閉じたラベル語彙: `@aiquants/virtualscroll` のエンジンクローム 7 キーとスプレッドシート固有の 21 キー。
+ * 閉じたラベル語彙: `@aiquants/virtualscroll` のエンジンクロームキー全件 (VIRTUAL_SCROLL_LABEL_KEYS) とスプレッドシート固有の 21 キー。
  * 全キーが SPREADSHEET_LABEL_CATALOGS の各ロケールに値を持ち、消費者は `labels` prop で任意の部分集合を上書き。
  */
 export type SpreadsheetLabels = VirtualScrollLabels & {
@@ -148,11 +149,11 @@ const OWN_LABEL_KEYS = [
 ] as const satisfies readonly (keyof SpreadsheetLabels)[]
 
 /**
- * Every label key: the 7 engine keys (VIRTUAL_SCROLL_LABEL_KEYS, in engine order) followed by the
+ * Every label key: every engine key (VIRTUAL_SCROLL_LABEL_KEYS, in engine order) followed by the
  * 21 own keys — the closed key set that overrides are validated against, and the census list for
  * docs / tests. Compile-time proofs below that it covers EVERY SpreadsheetLabels key and that the
  * own keys never shadow an engine key.
- * 全ラベルキー: エンジン 7 キー (VIRTUAL_SCROLL_LABEL_KEYS、エンジン順) に固有 21 キーを続けたもの —
+ * 全ラベルキー: エンジンキー全件 (VIRTUAL_SCROLL_LABEL_KEYS、エンジン順) に固有 21 キーを続けたもの —
  * override 検証の閉じたキー集合で docs / テストの census 表。直下で全キー網羅と、固有キーが
  * エンジンキーを覆い隠さないことを型水準で証明。
  */
@@ -268,13 +269,13 @@ export const describeLabelValue = (value: unknown): string => {
 const isCountLabelKey = (key: (typeof OWN_LABEL_KEYS)[number]): key is "commentCount" | "listMore" => key === "commentCount" || key === "listMore"
 
 /**
- * Mount-time check of a resolved label bag's own keys (the 7 engine keys are validated by
+ * Mount-time check of a resolved label bag's own keys (the engine keys are validated by
  * `resolveVirtualScrollLabels`): `sinkAriaLabel` must be a string that mentions "Escape"
  * (case-sensitive — the WCAG 2.1.2 escape-method advisement of spec 00 §10-4); every other
  * non-count own key must be a string with non-whitespace content; `commentCount` / `listMore` must
  * be such a string or a function. Anything else is a consumer configuration error ⇒ RangeError
  * naming the key (fail-fast, never silently repaired).
- * 解決済みラベル集合の固有キーのマウント時検証 (エンジン 7 キーは `resolveVirtualScrollLabels` が検証):
+ * 解決済みラベル集合の固有キーのマウント時検証 (エンジンキーは `resolveVirtualScrollLabels` が検証):
  * `sinkAriaLabel` は "Escape" を含む文字列 (大文字小文字を区別 — spec 00 §10-4 の WCAG 2.1.2 脱出告知)、
  * その他の件数以外の固有キーは空白以外を含む文字列、`commentCount` / `listMore` はその文字列か関数で
  * あること。それ以外は消費者の設定誤りとしてキー名入りの RangeError (fail-fast、黙って修復しない)。
@@ -403,13 +404,13 @@ export const resolveLabels = (locale: SpreadsheetLocale | undefined, overrides:
 }
 
 /**
- * Extracts the 7 engine chrome keys of a resolved label bag as a new frozen VirtualScrollLabels
- * object — the `labels` handed to the embedded VirtualGrid.
- * 解決済みラベル集合からエンジンクローム 7 キーを新しい凍結 VirtualScrollLabels object として抽出 —
- * 埋込み VirtualGrid へ渡す `labels`。
+ * Extracts every engine chrome key (VIRTUAL_SCROLL_LABEL_KEYS) of a resolved label bag as a new
+ * frozen VirtualScrollLabels object — the `labels` handed to the embedded VirtualGrid.
+ * 解決済みラベル集合からエンジンクロームキー全件 (VIRTUAL_SCROLL_LABEL_KEYS) を新しい凍結
+ * VirtualScrollLabels object として抽出 — 埋込み VirtualGrid へ渡す `labels`。
  *
  * @param labels - The resolved label bag / 解決済みラベル集合
- * @returns A new frozen object holding exactly the 7 engine keys / エンジン 7 キーだけを持つ新しい凍結 object
+ * @returns A new frozen object holding exactly the engine keys / エンジンキーだけを持つ新しい凍結 object
  */
 export const pickEngineLabels = (labels: SpreadsheetLabels): VirtualScrollLabels => {
     const engine: { -readonly [K in keyof VirtualScrollLabels]?: VirtualScrollLabels[K] } = {}

package/src/model/viewStore.ts

@@ -40,7 +40,7 @@ export type ViewStore = {
     setRowRange: (start: number, end: number) => void
     /** Rendering column range from onRangeChange (overscan-inclusive; ColumnHeader source — row-symmetric §7-5). / onRangeChange 由来の描画列レンジ (行側 setRowRange の完全対称)。 */
     setColRange: (start: number, end: number) => void
-    /** Bumped by resizeColumn to re-render the column header (cells re-slice via the grid's own width epoch). / 列幅変更 (resizeColumn) の列ヘッダー再レンダー通知 (セル再スライスはグリッド側の幅エポックが担う)。 */
+    /** Bumped by resizeColumn to re-render the column header (cells re-slice when the grid's column-width tree revision changes). / 列幅変更 (resizeColumn) の列ヘッダー再レンダー通知 (セル再スライスはグリッド側の列幅木の版数が担う)。 */
     bumpColVersion: () => void
     /** Bumped by resizeRow to re-place row labels. / 行ジオメトリ変更のヘッダー再配置通知。 */
     bumpRowGeometry: () => void
@@ -59,9 +59,6 @@ export type ViewStore = {
     subscribeCoalesced: (listener: () => void) => () => void
 }
 
-/** Vertical scrollbar width in px (SSOT — §6.9-3; also the grid's horizontal bar height). / 縦バー幅 px (SSOT — 横バー高も同値)。 */
-export const SCROLLBAR_WIDTH = 12
-
 /** Creates a view store instance. / viewStore インスタンスを構築。 */
 export const createViewStore = (): ViewStore => {
     let state: ViewState = { vy: 0, rowStart: 0, rowEnd: 0, colStart: 0, colEnd: 0, colVersion: 0, rowGeomVersion: 0, editVersion: 0 }

package/src/overlay/SelectionOverlay.tsx

@@ -93,9 +93,9 @@ import { isWholeCols, isWholeRows } from "../model/cellAnnotations.ts"
 import { type CellCoord, type CellRange, makeRange } from "../model/cellCoord.ts"
 import { type EditPaint, IDLE_EDIT_PAINT } from "../model/cellPaint.ts"
 import { type AxisForwardCtx, colToViewportX, frozenHeightOf, frozenWidthOf, rowToViewportY, trailingHeightOf, trailingWidthOf } from "../model/frozenPartition.ts"
-import { SCROLLBAR_WIDTH } from "../model/viewStore.ts"
 import type { PopoverAnchorState } from "../popover/usePopovers.ts"
 import type { SelectionState } from "../selection/selectionState.ts"
+import { SPREADSHEET_SCROLLBAR_SIZE_PX } from "../view.ts"
 
 /** Viewport-space rect (private — distinct from the logical-space LogicalRect). / ビューポート矩形 (非公開)。 */
 type ViewportRect = { top: number; left: number; width: number; height: number }
@@ -1862,10 +1862,10 @@ export const SelectionOverlay = ({
     const legacyAttr = (key: string): Record<string, string> => (key === "mm" ? { "data-aqsp-overlay-main": "" } : key === "fm" ? { "data-aqsp-overlay-frozen": "" } : key === "sm" ? { "data-aqsp-overlay-scroll": "" } : {})
 
     return (
-        // 右 / 下オフセットは JSX インライン (CSS は TS 定数を読めない — SSOT は SCROLLBAR_WIDTH
+        // 右 / 下オフセットは JSX インライン (CSS は TS 定数を読めない — SSOT は SPREADSHEET_SCROLLBAR_SIZE_PX
         // 1 本 §6.7.2-1)。下は v0.4 で追加: 横バー帯がグリッド内在化し、オーバーレイはセル
         // ビューポート (バー帯を除く) だけを覆う
-        <div ref={overlayRef} className="aqsp-overlay" data-aqsp-overlay="" style={{ right: SCROLLBAR_WIDTH, bottom: SCROLLBAR_WIDTH }}>
+        <div ref={overlayRef} className="aqsp-overlay" data-aqsp-overlay="" style={{ right: SPREADSHEET_SCROLLBAR_SIZE_PX, bottom: SPREADSHEET_SCROLLBAR_SIZE_PX }}>
             {quadrants.map(({ xk, yk, key, style }) => {
                 const refs = quadRefs[key]
                 return (

package/src/popover/placement.ts

@@ -21,7 +21,7 @@
  */
 
 import { type CellCoord, coordEquals } from "../model/cellCoord.ts"
-import { SCROLLBAR_WIDTH } from "../model/viewStore.ts"
+import { SPREADSHEET_SCROLLBAR_SIZE_PX } from "../view.ts"
 
 /** A rectangle in the popover layer's coordinate space (logical viewport px). / ポップオーバー層座標系 (論理 viewport px) の矩形。 */
 export type PopoverRect = { top: number; left: number; width: number; height: number }
@@ -50,7 +50,7 @@ export const NOTE_TIP_LEAVE_GRACE_MS = 150
  * 使用可能幅 = body − スクロールバー帯。body だけで決まるため、層はフレームの高さを読む**前**に
  * これを書く (狭いフレームは行数が増える — 別の幅で測ると高さを過小評価する)。
  */
-export const popoverWidth = (bodyRect: PopoverBodySize): number => Math.max(0, Math.min(POPOVER_MAX_WIDTH, bodyRect.width - SCROLLBAR_WIDTH - POPOVER_MARGIN))
+export const popoverWidth = (bodyRect: PopoverBodySize): number => Math.max(0, Math.min(POPOVER_MAX_WIDTH, bodyRect.width - SPREADSHEET_SCROLLBAR_SIZE_PX - POPOVER_MARGIN))
 
 /**
  * Places a popover of `measuredHeight` (measured at `popoverWidth(bodyRect)`) next to
@@ -73,8 +73,8 @@ export const popoverWidth = (bodyRect: PopoverBodySize): number => Math.max(0, M
  */
 export const placePopover = (anchorRect: PopoverRect, measuredHeight: number, bodyRect: PopoverBodySize): PopoverRect => {
     // 使用可能領域 = body − スクロールバー帯 (両軸)
-    const usableWidth = bodyRect.width - SCROLLBAR_WIDTH
-    const usableHeight = bodyRect.height - SCROLLBAR_WIDTH
+    const usableWidth = bodyRect.width - SPREADSHEET_SCROLLBAR_SIZE_PX
+    const usableHeight = bodyRect.height - SPREADSHEET_SCROLLBAR_SIZE_PX
     // 幅は body から (層が計測前に書いた値と同じ源)、高さは実測をマージン込みの使用可能高で上限 (負にしない)
     const width = popoverWidth(bodyRect)
     const height = Math.max(0, Math.min(measuredHeight, usableHeight - POPOVER_MARGIN))

package/src/styles/spreadsheet.css

@@ -119,7 +119,7 @@
   grid-row: 2;
   position: relative;
   overflow: hidden;
-  /* 下端の横バー帯ぶんの margin-bottom は RowHeader.tsx が SCROLLBAR_WIDTH からインライン
+  /* 下端の横バー帯ぶんの margin-bottom は RowHeader.tsx が SPREADSHEET_SCROLLBAR_SIZE_PX (src/view.ts) からインライン
      指定する (TS 定数の単一 SSOT — SelectionOverlay の right / bottom と同方式) */
   border-right: 1px solid #d1d5db;
   background: #f3f4f6;

package/src/tsv.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview The TSV codec the grid copies and pastes with (Excel's real behaviour: one trailing line terminator
+ * dropped, empty text read as one empty cell, ragged rows padded with "", only fields holding a tab or a line break
+ * quoted), React-free, so a host reads or writes a grid's text before the grid itself is loaded — a
+ * server-rendered placeholder table, a lazily imported grid. Published as `@aiquants/spreadsheet/tsv`, which loads
+ * none of the grid; the barrel exports the same two functions.
+ *
+ * グリッドがコピーと貼り付けに使う TSV の符号化 (Excel の実際の振る舞い: 末尾の改行 1 つを除く・空の文字は空のセル 1 つ・
+ * 不揃いの行は "" で埋める・引用符で囲むのはタブか改行を含む値だけ) を React を読まずに渡すモジュール。ホストがグリッドを
+ * 読み込む前に (サーバーで描く代わりの表、遅延で読み込むグリッド) グリッドの文字を読み書きできる。グリッドを読み込まない
+ * `@aiquants/spreadsheet/tsv` として公開し、barrel も同じ 2 つの関数を公開する。
+ */
+export { parseTsv, serializeTsv } from "./clipboard/tsv.ts"

package/src/view.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview The grid's fixed view geometry and its zoom rules, React-free, so a host can size a box for the grid and
+ * drive the zoom from its own controls with exactly the numbers the grid itself uses. Published as
+ * `@aiquants/spreadsheet/view`, which loads none of the grid.
+ *
+ * グリッドの固定の寸法と拡大率の規則 (React を読まない)。ホストがグリッドの箱の大きさを決め、自前の操作部品から拡大率を
+ * 動かすときに、グリッド自身と同じ数を使えるようにするモジュール。グリッドを読み込まない `@aiquants/spreadsheet/view` として
+ * 公開する。
+ */
+
+/** The height of the column-header band in CSS px (`--aqsp-col-header-height` in the stylesheet). 列見出しの帯の高さ (CSS px。スタイルシートの `--aqsp-col-header-height`)。 */
+export const SPREADSHEET_COLUMN_HEADER_HEIGHT_PX = 24
+
+/** The width of the row-header band in CSS px (`--aqsp-row-header-width` in the stylesheet). 行見出しの帯の幅 (CSS px。スタイルシートの `--aqsp-row-header-width`)。 */
+export const SPREADSHEET_ROW_HEADER_WIDTH_PX = 64
+
+/**
+ * The thickness of each scroll bar the grid always reserves, in CSS px: the vertical bar's width and the horizontal
+ * bar's height, both reserved whether or not the grid scrolls.
+ * グリッドが常に取っておくスクロールバーの太さ (CSS px)。縦のバーの幅と横のバーの高さで、スクロールしなくても両方を取る。
+ */
+export const SPREADSHEET_SCROLLBAR_SIZE_PX = 12
+
+/** The smallest package zoom. パッケージの拡大率の下限。 */
+export const SPREADSHEET_ZOOM_MIN = 0.25
+
+/** The largest package zoom. パッケージの拡大率の上限。 */
+export const SPREADSHEET_ZOOM_MAX = 4
+
+/**
+ * Clamps a zoom into [SPREADSHEET_ZOOM_MIN, SPREADSHEET_ZOOM_MAX] without quantizing it, so a host may set any value
+ * such as 1.25; the gestures quantize their own arithmetic before they request a zoom. A non-finite value (NaN or
+ * ±Infinity) fails fast: Math.min and Math.max would pass NaN through every division by the zoom and defeat the grid's
+ * same-value bail.
+ * 拡大率を [下限, 上限] へ切る処理。量子化しないため、ホストは 1.25 などどの値でも置ける (操作は求める前に自分の計算で刻む)。
+ * 有限でない値 (NaN・±Infinity) はすぐに投げる (Math.min と Math.max は NaN を素通しし、拡大率で割る所をすべて汚し、同じ値なら
+ * 何もしないグリッドの判定も効かなくなるため)。
+ *
+ * @param value - The requested zoom. 求める拡大率。
+ * @returns The clamped zoom. 切った拡大率。
+ * @throws {RangeError} When the value is not finite. 有限でない場合。
+ */
+export const clampSpreadsheetZoom = (value: number): number => {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`[spreadsheet] zoom must be a finite number (got ${value})`)
+    }
+    return Math.min(SPREADSHEET_ZOOM_MAX, Math.max(SPREADSHEET_ZOOM_MIN, value))
+}
+
+/**
+ * The 0.1-grid step of the zoom gestures (Alt+Wheel and Ctrl+Alt+= / -), unclamped and free of float drift. From an
+ * off-grid value (the 0.25 bound or a host's 1.25) the step lands on the nearest detent in the travel direction (0.25
+ * goes to 0.3 up and 0.2 down); rounding would skip a detent (0.25 to 0.4). Clamp the result with clampSpreadsheetZoom.
+ * 拡大縮小の操作 (Alt+ホイールと Ctrl+Alt+= / -) の 0.1 刻み (範囲で切らず、浮動小数のずれを持ち込まない)。刻みの外の値
+ * (下限の 0.25 やホストの 1.25) からは、進む向きの最寄りの刻みへ着く (0.25 から上は 0.3、下は 0.2)。丸めると刻みを飛ばす
+ * (0.25 から 0.4) ため使わない。結果は clampSpreadsheetZoom で切る。
+ *
+ * @param value - The current zoom. 今の拡大率。
+ * @param direction - 1 to zoom in, -1 to zoom out. 拡大は 1、縮小は -1。
+ * @returns The next detent in that direction. その向きの次の刻み。
+ */
+export const stepSpreadsheetZoom = (value: number, direction: 1 | -1): number => (direction > 0 ? (Math.floor(value * 10 + 1e-6) + 1) / 10 : (Math.ceil(value * 10 - 1e-6) - 1) / 10)