@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/CHANGELOG.md +43 -1
- package/README.md +12 -7
- package/dist/index.cjs +8 -8
- package/dist/index.d.cts +40 -0
- package/dist/index.d.ts +40 -0
- package/dist/index.js +3498 -3478
- package/dist/styles/spreadsheet.standalone.css +1 -1
- package/package.json +6 -6
- package/src/Spreadsheet.tsx +95 -12
- package/src/grid/GridBody.tsx +32 -3
- package/src/index.ts +1 -1
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 カウンタ注入)。
|