@react-x11/components 0.2.0 → 0.3.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/internal/heights.d.ts +33 -1
- package/dist/internal/heights.d.ts.map +1 -1
- package/dist/internal/heights.js +72 -11
- package/dist/internal/heights.js.map +1 -1
- package/dist/internal/scroll.d.ts +73 -0
- package/dist/internal/scroll.d.ts.map +1 -0
- package/dist/internal/scroll.js +264 -0
- package/dist/internal/scroll.js.map +1 -0
- package/dist/internal/timers.d.ts +8 -0
- package/dist/internal/timers.d.ts.map +1 -1
- package/dist/internal/timers.js +10 -0
- package/dist/internal/timers.js.map +1 -1
- package/dist/internal/window.d.ts +161 -0
- package/dist/internal/window.d.ts.map +1 -0
- package/dist/internal/window.js +417 -0
- package/dist/internal/window.js.map +1 -0
- package/dist/table/index.d.ts +73 -2
- package/dist/table/index.d.ts.map +1 -1
- package/dist/table/index.js +468 -178
- package/dist/table/index.js.map +1 -1
- package/dist/tree/index.d.ts +65 -5
- package/dist/tree/index.d.ts.map +1 -1
- package/dist/tree/index.js +494 -202
- package/dist/tree/index.js.map +1 -1
- package/package.json +1 -1
- package/src/internal/heights.ts +73 -11
- package/src/internal/scroll.ts +344 -0
- package/src/internal/timers.ts +13 -0
- package/src/internal/window.ts +570 -0
- package/src/table/index.ts +666 -194
- package/src/tree/index.ts +730 -263
package/dist/table/index.d.ts
CHANGED
|
@@ -5,6 +5,28 @@ import type { Host } from './hx.js';
|
|
|
5
5
|
import type { TableCellState, TableColumn, TableHeaderCellState, TableRow, TableRowId, TableRowState, TableSort } from './rows.js';
|
|
6
6
|
export type { ResolvedWidths, TableCellState, TableColumn, TableHeaderCellState, TableRow, TableRowId, TableRowState, TableSort, } from './rows.js';
|
|
7
7
|
export { MIN_COLUMN, UNSIZED_MIN, columnValue, defaultCompare, orderRows, resolveGetId, resolveWidths, } from './rows.js';
|
|
8
|
+
/**
|
|
9
|
+
* What `renderScrollHint` is told: where the viewport is, while a fast
|
|
10
|
+
* scroll is still being caught up with. The top row itself is included so a
|
|
11
|
+
* hint can show what is *at* this position — a date, a group, a name — the
|
|
12
|
+
* way a photo library's scrubber shows the month.
|
|
13
|
+
*/
|
|
14
|
+
export interface TableScrollHintState<Row = any> {
|
|
15
|
+
/** The first row in view, in display order. */
|
|
16
|
+
row: TableRow<Row>;
|
|
17
|
+
/** Its position, 1-based — "row `from` of `count`". */
|
|
18
|
+
from: number;
|
|
19
|
+
/** The last row in view, 1-based. */
|
|
20
|
+
to: number;
|
|
21
|
+
/** How many rows the table has. */
|
|
22
|
+
count: number;
|
|
23
|
+
/** How many of the rows in view are still placeholders. */
|
|
24
|
+
pending: number;
|
|
25
|
+
/** When the viewport first stopped being whole, epoch ms — what the
|
|
26
|
+
* show-delay was measured against. `Date.now() - since` is how long the
|
|
27
|
+
* user has been looking at unresolved content. */
|
|
28
|
+
since: number;
|
|
29
|
+
}
|
|
8
30
|
/** The selection that just changed, alongside the whole set. `id`/`row` name
|
|
9
31
|
* the row the gesture landed on; a select-all has no single row to name. */
|
|
10
32
|
export interface TableSelectChange<Row> {
|
|
@@ -78,14 +100,25 @@ interface TableBaseProps<Row> extends Omit<BoxProps, 'style' | 'children' | 'ref
|
|
|
78
100
|
*/
|
|
79
101
|
rowHeight?: number;
|
|
80
102
|
/** What an unmeasured row is assumed — and floored — at, while measuring.
|
|
81
|
-
* Default 24. The scrollbar is this guess for every row not yet seen
|
|
82
|
-
*
|
|
103
|
+
* Default 24. The scrollbar is this guess for every row not yet seen; it
|
|
104
|
+
* converges as you scroll, and once enough rows have been measured the
|
|
105
|
+
* guess itself is re-learnt from their mean, so the scrollbar lands near
|
|
106
|
+
* the truth without visiting the whole list. */
|
|
83
107
|
estimatedRowHeight?: number;
|
|
84
108
|
/** Build only the rows on screen. `'auto'` (the default) turns it on past
|
|
85
109
|
* 200 rows. */
|
|
86
110
|
virtual?: boolean | 'auto';
|
|
87
111
|
/** Rows built either side of the viewport. */
|
|
88
112
|
overscan?: number;
|
|
113
|
+
/**
|
|
114
|
+
* Rows built *beyond* the overscan while the table sits idle, per side.
|
|
115
|
+
* Default 40. The pane blits a scroll before React can run, so the only
|
|
116
|
+
* scroll with no blank frame is one that lands on rows already built —
|
|
117
|
+
* this band is that, grown in small steps while nobody is scrolling, and
|
|
118
|
+
* kept behind the viewport so a reversal lands on rows still mounted.
|
|
119
|
+
* `0` turns the band off: the slice is exactly viewport-plus-overscan.
|
|
120
|
+
*/
|
|
121
|
+
prefetch?: number;
|
|
89
122
|
/**
|
|
90
123
|
* Everything inside the row box, given what would have been there.
|
|
91
124
|
*
|
|
@@ -97,6 +130,44 @@ interface TableBaseProps<Row> extends Omit<BoxProps, 'style' | 'children' | 'ref
|
|
|
97
130
|
/** The body's content when the rows resolve empty. Nothing by default —
|
|
98
131
|
* the header still shows. */
|
|
99
132
|
renderEmpty?: () => ReactNode;
|
|
133
|
+
/**
|
|
134
|
+
* The fast-scroll overlay. Shown only while a scroll has outrun the rows
|
|
135
|
+
* far enough that placeholders cover a meaningful part of the viewport —
|
|
136
|
+
* a scroll the table absorbs within a frame never shows it — and hidden
|
|
137
|
+
* the moment the view is whole again. The default is a pill reading
|
|
138
|
+
* "2,345 / 100,000"; return something else to replace it (the state
|
|
139
|
+
* carries the top row, so a hint can show a date or a name instead of a
|
|
140
|
+
* number), or null for no overlay at all.
|
|
141
|
+
*/
|
|
142
|
+
renderScrollHint?: (state: TableScrollHintState<Row>) => ReactNode;
|
|
143
|
+
/**
|
|
144
|
+
* How long the viewport must have been showing unresolved content before
|
|
145
|
+
* the overlay appears, in milliseconds. Default 250: a catch-up the next
|
|
146
|
+
* few frames absorb is never announced. `0` shows it the moment a
|
|
147
|
+
* catch-up engages.
|
|
148
|
+
*/
|
|
149
|
+
scrollHintDelay?: number;
|
|
150
|
+
/**
|
|
151
|
+
* Tuning for the catch-up pacing — how a scroll that outruns the built
|
|
152
|
+
* rows is absorbed. All optional, all in rows:
|
|
153
|
+
*
|
|
154
|
+
* - `threshold` (default 16): more rows than this entering the window in
|
|
155
|
+
* one render is a flood, and floods build skeletons first. Raise it
|
|
156
|
+
* past the window size to never show skeletons; `0` skeletons every
|
|
157
|
+
* scroll.
|
|
158
|
+
* - `burst` (default 24): full rows built per render while the scroll is
|
|
159
|
+
* still moving.
|
|
160
|
+
* - `settle` (default 48): the same once it has stopped.
|
|
161
|
+
*
|
|
162
|
+
* The defaults follow the measured cost of a default-shape row (about
|
|
163
|
+
* twice a skeleton, warm); tables with heavy `render` seams may want
|
|
164
|
+
* smaller budgets, and cheap tables may raise the threshold instead.
|
|
165
|
+
*/
|
|
166
|
+
catchup?: {
|
|
167
|
+
threshold?: number;
|
|
168
|
+
burst?: number;
|
|
169
|
+
settle?: number;
|
|
170
|
+
};
|
|
100
171
|
styles?: TableStyles<Row>;
|
|
101
172
|
style?: StyleProp;
|
|
102
173
|
/** Whether the table is a tab stop. Default true; `false` for a table
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/table/index.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/table/index.ts"],"names":[],"mappings":"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"}
|