@aiquants/spreadsheet 0.10.0 → 0.11.0

package/dist/index.d.cts

@@ -1678,6 +1678,43 @@ export declare type SpreadsheetProps = {
      * 宣言の不在信号 (エンジン既定) で、本パッケージでの値フォールバックなし。
      */
     tapScrollCircleOptions?: ScrollBarTapCircleOptions;
+    /**
+     * Row-axis overscan pass-through (the VirtualGrid `overscanRows` knob; LIVE prop): rows
+     * rendered beyond each vertical viewport edge. This slack is the only thing absorbing the
+     * engine's one-frame rendering-window lag during fast scrolling (the blank-band remedy —
+     * the slack in px is overscan × row height per edge). Undefined ⇒ the engine default (3).
+     * The engine clamps invalid values silently, so THIS surface owns the fail-fast: a
+     * non-integer or negative value throws a RangeError at render. Cost multiplies with the
+     * column axis (bounded by the engine cell cap).
+     * 行軸 overscan の素通し (VirtualGrid `overscanRows`。ライブ prop): 縦 viewport 端の外側へ
+     * 描画する行数。高速スクロール時の描画窓 1 フレーム遅れを吸収する唯一の余裕 (白帯対策 —
+     * 余裕 px は片端あたり overscan × 行高)。undefined はエンジン既定 (3)。エンジンは不正値を
+     * 無言クランプするため fail-fast は本層所有 — 非整数・負値は render 時 RangeError。費用は
+     * 列軸との積で増幅 (エンジンのセル上限で有界)。
+     */
+    overscanRows?: number;
+    /**
+     * Column-axis overscan pass-through (the VirtualGrid `overscanCols` knob; LIVE prop) — the
+     * column twin of `overscanRows`, same validation contract (non-negative integer or
+     * RangeError; undefined ⇒ engine default 3).
+     * 列軸 overscan の素通し (VirtualGrid `overscanCols`。ライブ prop) — `overscanRows` の
+     * 列双子。検証契約は同文 (非負整数、それ以外 RangeError。undefined ⇒ エンジン既定 3)。
+     */
+    overscanCols?: number;
+    /**
+     * Background layer rendered behind the scroll-band rows, inside the engine content element
+     * (the VirtualGrid `background` pass-through; LIVE prop). VIEWPORT-PINNED: the engine
+     * translates only its row wrapper, so this layer does NOT follow the scroll offset —
+     * periodic row ruling placed here slides against the real rows while scrolling. Suited to
+     * a static texture that reads as "content still arriving" in the overscan-exhausted band,
+     * not to row-aligned gridlines.
+     * スクロール帯行の背後・エンジンコンテンツ要素内に描画する背景レイヤー (VirtualGrid
+     * `background` の素通し。ライブ prop)。viewport 固定: エンジンが translate するのは行
+     * ラッパーだけで、この層はスクロール量に追従しない — 周期的な行罫線を置くとスクロール中に
+     * 実際の行へ対して滑る。overscan が尽きた帯で「まだ到着中」と読める静的テクスチャ向きで、
+     * 行整合の罫線には不向き。
+     */
+    background?: ReactNode;
     /**
      * 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).

package/dist/index.d.ts

@@ -1678,6 +1678,43 @@ export declare type SpreadsheetProps = {
      * 宣言の不在信号 (エンジン既定) で、本パッケージでの値フォールバックなし。
      */
     tapScrollCircleOptions?: ScrollBarTapCircleOptions;
+    /**
+     * Row-axis overscan pass-through (the VirtualGrid `overscanRows` knob; LIVE prop): rows
+     * rendered beyond each vertical viewport edge. This slack is the only thing absorbing the
+     * engine's one-frame rendering-window lag during fast scrolling (the blank-band remedy —
+     * the slack in px is overscan × row height per edge). Undefined ⇒ the engine default (3).
+     * The engine clamps invalid values silently, so THIS surface owns the fail-fast: a
+     * non-integer or negative value throws a RangeError at render. Cost multiplies with the
+     * column axis (bounded by the engine cell cap).
+     * 行軸 overscan の素通し (VirtualGrid `overscanRows`。ライブ prop): 縦 viewport 端の外側へ
+     * 描画する行数。高速スクロール時の描画窓 1 フレーム遅れを吸収する唯一の余裕 (白帯対策 —
+     * 余裕 px は片端あたり overscan × 行高)。undefined はエンジン既定 (3)。エンジンは不正値を
+     * 無言クランプするため fail-fast は本層所有 — 非整数・負値は render 時 RangeError。費用は
+     * 列軸との積で増幅 (エンジンのセル上限で有界)。
+     */
+    overscanRows?: number;
+    /**
+     * Column-axis overscan pass-through (the VirtualGrid `overscanCols` knob; LIVE prop) — the
+     * column twin of `overscanRows`, same validation contract (non-negative integer or
+     * RangeError; undefined ⇒ engine default 3).
+     * 列軸 overscan の素通し (VirtualGrid `overscanCols`。ライブ prop) — `overscanRows` の
+     * 列双子。検証契約は同文 (非負整数、それ以外 RangeError。undefined ⇒ エンジン既定 3)。
+     */
+    overscanCols?: number;
+    /**
+     * Background layer rendered behind the scroll-band rows, inside the engine content element
+     * (the VirtualGrid `background` pass-through; LIVE prop). VIEWPORT-PINNED: the engine
+     * translates only its row wrapper, so this layer does NOT follow the scroll offset —
+     * periodic row ruling placed here slides against the real rows while scrolling. Suited to
+     * a static texture that reads as "content still arriving" in the overscan-exhausted band,
+     * not to row-aligned gridlines.
+     * スクロール帯行の背後・エンジンコンテンツ要素内に描画する背景レイヤー (VirtualGrid
+     * `background` の素通し。ライブ prop)。viewport 固定: エンジンが translate するのは行
+     * ラッパーだけで、この層はスクロール量に追従しない — 周期的な行罫線を置くとスクロール中に
+     * 実際の行へ対して滑る。overscan が尽きた帯で「まだ到着中」と読める静的テクスチャ向きで、
+     * 行整合の罫線には不向き。
+     */
+    background?: ReactNode;
     /**
      * 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).