@aiquants/spreadsheet 0.19.0 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1895,6 +1895,23 @@ export declare type SpreadsheetProps = {
1895
1895
  * 宣言の不在信号 (エンジン既定) で、本パッケージでの値フォールバックなし。
1896
1896
  */
1897
1897
  tapScrollCircleOptions?: ScrollBarTapCircleOptions;
1898
+ /**
1899
+ * Which controls of the grid's two scrollbars respond to the pointer (LIVE prop): whether the bars draw their arrow
1900
+ * buttons, and whether dragging the thumb and pressing the track scroll ({@link SpreadsheetScrollBarControls} — each
1901
+ * member reaches both bars alike; an absent member, or an absent prop, keeps the engine's default `true`). The grid
1902
+ * reads the three members by value, so an inline object literal is fine: a render with equal values redraws nothing
1903
+ * below the grid's memo boundary, and keys outside the three are not read. The bar width and the bars' pointer-only
1904
+ * declaration stay the grid's own. A host turns all three off under a coarse pointer, where a finger drags the cells
1905
+ * instead. A prop that is not an object, or a member that is neither `true`, `false` nor absent (a JS host's `null`,
1906
+ * `0` or `""`, which the engine would read as off), throws a RangeError at render.
1907
+ * グリッドの 2 本のスクロールバーの部品のうちポインタに応えるもの (ライブ prop)。バーが矢印ボタンを描くか、つまみのドラッグと
1908
+ * トラックの押下がスクロールするか ({@link SpreadsheetScrollBarControls} — どの項目も両バーへ同じく届き、無い項目も prop の
1909
+ * 省略もエンジンの既定 `true` のまま)。グリッドは 3 項目を値で読むので、インラインの object literal でよい (値の等しい描画は
1910
+ * グリッドの memo 境界より下を描き直さず、3 項目の外のキーは読まない)。バーの幅とバーのポインタ専用の宣言はグリッド自身のもの。
1911
+ * 粗いポインタ (指がセルをドラッグする) では、ホストが 3 つとも切る想定。オブジェクトでない prop と、`true`・`false`・無しの
1912
+ * どれでもない項目 (JS のホストの `null`・`0`・`""`。エンジンは切ったと読む) は、描画で RangeError を投げる。
1913
+ */
1914
+ scrollBarControls?: SpreadsheetScrollBarControls;
1898
1915
  /**
1899
1916
  * Row-axis overscan pass-through (the VirtualGrid `overscanRows` knob; LIVE prop): rows
1900
1917
  * rendered beyond each vertical viewport edge. This slack is the only thing absorbing the
@@ -2389,6 +2406,29 @@ export declare type SpreadsheetProps = {
2389
2406
  className?: string;
2390
2407
  };
2391
2408
 
2409
+ /**
2410
+ * Which controls of the grid's two scrollbars respond to the pointer (`SpreadsheetProps["scrollBarControls"]`): the
2411
+ * members of the engine's `scrollBarOptions` a host may set. It is declared as an explicit structural type for the same
2412
+ * api-extractor reason as `ScrollToCellOptions`; the type parity guard of scrollBarControlsPassthrough.spec.tsx pins it to
2413
+ * the engine's members both ways and key for key under tsc. Every member reaches the vertical and the horizontal bar
2414
+ * alike, and an absent member keeps the engine's default (`true`). The bars stay pointer-only either way (the grid
2415
+ * scrolls by keyboard itself), which is what lets a host leave the arrows out — under a coarse pointer, for instance,
2416
+ * where a finger drags the cells and the bar only shows the position.
2417
+ * グリッドの 2 本のスクロールバーの部品のうちポインタに応えるもの (`SpreadsheetProps["scrollBarControls"]`)。エンジンの
2418
+ * `scrollBarOptions` のうちホストが決めてよい項目。`ScrollToCellOptions` と同じ api-extractor の訳で明示構造型とし、
2419
+ * scrollBarControlsPassthrough.spec.tsx の型パリティガードがエンジンの項目と双方向・キーごとの一致を tsc で固定する。どの項目も
2420
+ * 縦と横のバーへ同じく届き、無い項目はエンジンの既定 (`true`) のまま。バーはどちらでもポインタ専用 (キーボードのスクロールは
2421
+ * グリッド自身が持つ) で、それがホストに矢印を外させる根拠 (例えば粗いポインタ。指はセルをドラッグし、バーは位置を見せるだけ)。
2422
+ */
2423
+ export declare type SpreadsheetScrollBarControls = {
2424
+ /** Whether the bars draw their arrow buttons; without them the track runs the bar's whole length. / バーが矢印ボタンを描くか (描かなければトラックがバーの長さを全て取る)。 */
2425
+ readonly showArrowButtons?: boolean;
2426
+ /** Whether dragging the thumb scrolls. / つまみのドラッグでスクロールするか。 */
2427
+ readonly enableThumbDrag?: boolean;
2428
+ /** Whether pressing the track scrolls there. / トラックの押下でそこへスクロールするか。 */
2429
+ readonly enableTrackClick?: boolean;
2430
+ };
2431
+
2392
2432
  /**
2393
2433
  * Test-only seam props (NOT part of the public v0.1.0 contract — §8.2 counter injection).
2394
2434
  * テスト専用シーム props (公開 v0.1.0 契約外 — §8.2 カウンタ注入)。
package/dist/index.d.ts CHANGED
@@ -1895,6 +1895,23 @@ export declare type SpreadsheetProps = {
1895
1895
  * 宣言の不在信号 (エンジン既定) で、本パッケージでの値フォールバックなし。
1896
1896
  */
1897
1897
  tapScrollCircleOptions?: ScrollBarTapCircleOptions;
1898
+ /**
1899
+ * Which controls of the grid's two scrollbars respond to the pointer (LIVE prop): whether the bars draw their arrow
1900
+ * buttons, and whether dragging the thumb and pressing the track scroll ({@link SpreadsheetScrollBarControls} — each
1901
+ * member reaches both bars alike; an absent member, or an absent prop, keeps the engine's default `true`). The grid
1902
+ * reads the three members by value, so an inline object literal is fine: a render with equal values redraws nothing
1903
+ * below the grid's memo boundary, and keys outside the three are not read. The bar width and the bars' pointer-only
1904
+ * declaration stay the grid's own. A host turns all three off under a coarse pointer, where a finger drags the cells
1905
+ * instead. A prop that is not an object, or a member that is neither `true`, `false` nor absent (a JS host's `null`,
1906
+ * `0` or `""`, which the engine would read as off), throws a RangeError at render.
1907
+ * グリッドの 2 本のスクロールバーの部品のうちポインタに応えるもの (ライブ prop)。バーが矢印ボタンを描くか、つまみのドラッグと
1908
+ * トラックの押下がスクロールするか ({@link SpreadsheetScrollBarControls} — どの項目も両バーへ同じく届き、無い項目も prop の
1909
+ * 省略もエンジンの既定 `true` のまま)。グリッドは 3 項目を値で読むので、インラインの object literal でよい (値の等しい描画は
1910
+ * グリッドの memo 境界より下を描き直さず、3 項目の外のキーは読まない)。バーの幅とバーのポインタ専用の宣言はグリッド自身のもの。
1911
+ * 粗いポインタ (指がセルをドラッグする) では、ホストが 3 つとも切る想定。オブジェクトでない prop と、`true`・`false`・無しの
1912
+ * どれでもない項目 (JS のホストの `null`・`0`・`""`。エンジンは切ったと読む) は、描画で RangeError を投げる。
1913
+ */
1914
+ scrollBarControls?: SpreadsheetScrollBarControls;
1898
1915
  /**
1899
1916
  * Row-axis overscan pass-through (the VirtualGrid `overscanRows` knob; LIVE prop): rows
1900
1917
  * rendered beyond each vertical viewport edge. This slack is the only thing absorbing the
@@ -2389,6 +2406,29 @@ export declare type SpreadsheetProps = {
2389
2406
  className?: string;
2390
2407
  };
2391
2408
 
2409
+ /**
2410
+ * Which controls of the grid's two scrollbars respond to the pointer (`SpreadsheetProps["scrollBarControls"]`): the
2411
+ * members of the engine's `scrollBarOptions` a host may set. It is declared as an explicit structural type for the same
2412
+ * api-extractor reason as `ScrollToCellOptions`; the type parity guard of scrollBarControlsPassthrough.spec.tsx pins it to
2413
+ * the engine's members both ways and key for key under tsc. Every member reaches the vertical and the horizontal bar
2414
+ * alike, and an absent member keeps the engine's default (`true`). The bars stay pointer-only either way (the grid
2415
+ * scrolls by keyboard itself), which is what lets a host leave the arrows out — under a coarse pointer, for instance,
2416
+ * where a finger drags the cells and the bar only shows the position.
2417
+ * グリッドの 2 本のスクロールバーの部品のうちポインタに応えるもの (`SpreadsheetProps["scrollBarControls"]`)。エンジンの
2418
+ * `scrollBarOptions` のうちホストが決めてよい項目。`ScrollToCellOptions` と同じ api-extractor の訳で明示構造型とし、
2419
+ * scrollBarControlsPassthrough.spec.tsx の型パリティガードがエンジンの項目と双方向・キーごとの一致を tsc で固定する。どの項目も
2420
+ * 縦と横のバーへ同じく届き、無い項目はエンジンの既定 (`true`) のまま。バーはどちらでもポインタ専用 (キーボードのスクロールは
2421
+ * グリッド自身が持つ) で、それがホストに矢印を外させる根拠 (例えば粗いポインタ。指はセルをドラッグし、バーは位置を見せるだけ)。
2422
+ */
2423
+ export declare type SpreadsheetScrollBarControls = {
2424
+ /** Whether the bars draw their arrow buttons; without them the track runs the bar's whole length. / バーが矢印ボタンを描くか (描かなければトラックがバーの長さを全て取る)。 */
2425
+ readonly showArrowButtons?: boolean;
2426
+ /** Whether dragging the thumb scrolls. / つまみのドラッグでスクロールするか。 */
2427
+ readonly enableThumbDrag?: boolean;
2428
+ /** Whether pressing the track scrolls there. / トラックの押下でそこへスクロールするか。 */
2429
+ readonly enableTrackClick?: boolean;
2430
+ };
2431
+
2392
2432
  /**
2393
2433
  * Test-only seam props (NOT part of the public v0.1.0 contract — §8.2 counter injection).
2394
2434
  * テスト専用シーム props (公開 v0.1.0 契約外 — §8.2 カウンタ注入)。