@aiquants/spreadsheet 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1583,6 +1583,33 @@ export declare type SpreadsheetProps = {
      * 位置に依らず常時可視で、可視化の縦成分は no-op。飛行中の変更は全ドラッグを取り消す。
      */
     frozenRows?: number;
+    /**
+     * Freezes the LAST N columns at the right edge (v0.9 — the VirtualGrid frozenTrailingCols
+     * pass-through; LIVE prop, default 0). Validation SSOT is the engine's fail-fast contract
+     * (integer in [0, 128] — RangeError otherwise; the count clamp is leading-wins:
+     * effectiveTrailing = min(T, colCount − effectiveLeading)). Trailing columns stay visible at
+     * any horizontal scroll — with ONE registered exception: when the leading + trailing extent
+     * exceeds the viewport, occluded trailing cells cannot be scrolled into view and keyboard
+     * focus paints no visible frame (ADR-19-1). scrollToCell / ensure-visible treat a trailing
+     * target as a horizontal no-op. A mid-flight change cancels every in-flight drag without
+     * restore (the frozenColumns cancel seam).
+     * 末尾 N 列の右端凍結 (v0.9 — VirtualGrid frozenTrailingCols の素通し。ライブ prop、既定 0)。
+     * 検証 SSOT はエンジンの fail-fast 契約 ([0, 128] 整数、それ以外 RangeError。件数クランプは
+     * leading 勝ち: min(T, colCount − effectiveLeading))。末尾列は任意の横スクロールで可視 —
+     * ただし leading + trailing の extent が viewport を超える overlap では遮蔽された末尾セルを
+     * スクロールで可視化できず、キーボードフォーカスは可視フレームを描かない (ADR-19-1 の登記済み
+     * 帰結)。scrollToCell / ensure-visible は末尾ターゲットを横 no-op として扱う。飛行中の変更は
+     * 全ドラッグを復元なしで取り消す (frozenColumns と同じシーム)。
+     */
+    frozenTrailingColumns?: number;
+    /**
+     * Freezes the LAST N rows at the bottom (v0.9 — the VirtualGrid frozenTrailingRows
+     * pass-through; LIVE prop, default 0 — the row twin of frozenTrailingColumns, same engine
+     * fail-fast contract and cancel seam). The typical use is a pinned totals row.
+     * 末尾 N 行の下端凍結 (v0.9 — frozenTrailingRows の素通し。ライブ prop、既定 0 —
+     * frozenTrailingColumns の行双子。エンジン契約・取消シームは同文)。典型は固定合計行。
+     */
+    frozenTrailingRows?: 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).

package/dist/index.d.ts

@@ -1583,6 +1583,33 @@ export declare type SpreadsheetProps = {
      * 位置に依らず常時可視で、可視化の縦成分は no-op。飛行中の変更は全ドラッグを取り消す。
      */
     frozenRows?: number;
+    /**
+     * Freezes the LAST N columns at the right edge (v0.9 — the VirtualGrid frozenTrailingCols
+     * pass-through; LIVE prop, default 0). Validation SSOT is the engine's fail-fast contract
+     * (integer in [0, 128] — RangeError otherwise; the count clamp is leading-wins:
+     * effectiveTrailing = min(T, colCount − effectiveLeading)). Trailing columns stay visible at
+     * any horizontal scroll — with ONE registered exception: when the leading + trailing extent
+     * exceeds the viewport, occluded trailing cells cannot be scrolled into view and keyboard
+     * focus paints no visible frame (ADR-19-1). scrollToCell / ensure-visible treat a trailing
+     * target as a horizontal no-op. A mid-flight change cancels every in-flight drag without
+     * restore (the frozenColumns cancel seam).
+     * 末尾 N 列の右端凍結 (v0.9 — VirtualGrid frozenTrailingCols の素通し。ライブ prop、既定 0)。
+     * 検証 SSOT はエンジンの fail-fast 契約 ([0, 128] 整数、それ以外 RangeError。件数クランプは
+     * leading 勝ち: min(T, colCount − effectiveLeading))。末尾列は任意の横スクロールで可視 —
+     * ただし leading + trailing の extent が viewport を超える overlap では遮蔽された末尾セルを
+     * スクロールで可視化できず、キーボードフォーカスは可視フレームを描かない (ADR-19-1 の登記済み
+     * 帰結)。scrollToCell / ensure-visible は末尾ターゲットを横 no-op として扱う。飛行中の変更は
+     * 全ドラッグを復元なしで取り消す (frozenColumns と同じシーム)。
+     */
+    frozenTrailingColumns?: number;
+    /**
+     * Freezes the LAST N rows at the bottom (v0.9 — the VirtualGrid frozenTrailingRows
+     * pass-through; LIVE prop, default 0 — the row twin of frozenTrailingColumns, same engine
+     * fail-fast contract and cancel seam). The typical use is a pinned totals row.
+     * 末尾 N 行の下端凍結 (v0.9 — frozenTrailingRows の素通し。ライブ prop、既定 0 —
+     * frozenTrailingColumns の行双子。エンジン契約・取消シームは同文)。典型は固定合計行。
+     */
+    frozenTrailingRows?: 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).