@gemologic/sheen-table 0.1.0-rc.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.
Files changed (106) hide show
  1. package/LICENSE +19 -0
  2. package/README.md +19 -0
  3. package/dist/DataTable.d.ts +159 -0
  4. package/dist/DataTable.js +2724 -0
  5. package/dist/DataTableToolbar.d.ts +28 -0
  6. package/dist/DataTableToolbar.js +132 -0
  7. package/dist/FilterBar.d.ts +24 -0
  8. package/dist/FilterBar.js +681 -0
  9. package/dist/QueryBuilder.d.ts +11 -0
  10. package/dist/QueryBuilder.js +693 -0
  11. package/dist/cell-edit.d.ts +50 -0
  12. package/dist/cell-edit.js +178 -0
  13. package/dist/client-state.d.ts +28 -0
  14. package/dist/client-state.js +57 -0
  15. package/dist/client-view.d.ts +31 -0
  16. package/dist/client-view.js +30 -0
  17. package/dist/column-layout.d.ts +10 -0
  18. package/dist/column-layout.js +34 -0
  19. package/dist/columns.d.ts +108 -0
  20. package/dist/columns.js +217 -0
  21. package/dist/core.d.ts +54 -0
  22. package/dist/core.js +28 -0
  23. package/dist/export.d.ts +14 -0
  24. package/dist/export.js +27 -0
  25. package/dist/facets.d.ts +15 -0
  26. package/dist/facets.js +41 -0
  27. package/dist/filter-bar-state.d.ts +22 -0
  28. package/dist/filter-bar-state.js +128 -0
  29. package/dist/filter-client.d.ts +9 -0
  30. package/dist/filter-client.js +69 -0
  31. package/dist/filter.d.ts +64 -0
  32. package/dist/filter.js +132 -0
  33. package/dist/grouping.d.ts +37 -0
  34. package/dist/grouping.js +126 -0
  35. package/dist/index.d.ts +7 -0
  36. package/dist/index.js +31 -0
  37. package/dist/messages.d.ts +115 -0
  38. package/dist/messages.js +121 -0
  39. package/dist/pagination.d.ts +36 -0
  40. package/dist/pagination.js +102 -0
  41. package/dist/query-builder-state.d.ts +28 -0
  42. package/dist/query-builder-state.js +128 -0
  43. package/dist/requests.d.ts +26 -0
  44. package/dist/requests.js +106 -0
  45. package/dist/row-hierarchy.d.ts +32 -0
  46. package/dist/row-hierarchy.js +170 -0
  47. package/dist/row-identity.d.ts +11 -0
  48. package/dist/row-identity.js +36 -0
  49. package/dist/saved-views.d.ts +52 -0
  50. package/dist/saved-views.js +153 -0
  51. package/dist/search-controller.d.ts +22 -0
  52. package/dist/search-controller.js +75 -0
  53. package/dist/search.d.ts +28 -0
  54. package/dist/search.js +111 -0
  55. package/dist/selection-client.d.ts +9 -0
  56. package/dist/selection-client.js +14 -0
  57. package/dist/selection.d.ts +25 -0
  58. package/dist/selection.js +60 -0
  59. package/dist/server-export.d.ts +27 -0
  60. package/dist/server-export.js +105 -0
  61. package/dist/sorting.d.ts +17 -0
  62. package/dist/sorting.js +58 -0
  63. package/dist/table-state-changes.d.ts +27 -0
  64. package/dist/table-state-changes.js +67 -0
  65. package/dist/table-state.d.ts +20 -0
  66. package/dist/table-state.js +77 -0
  67. package/dist/text-normalization.d.ts +2 -0
  68. package/dist/text-normalization.js +12 -0
  69. package/dist/url-state.d.ts +39 -0
  70. package/dist/url-state.js +75 -0
  71. package/package.json +66 -0
  72. package/src/DataTable.tsx +2322 -0
  73. package/src/DataTableToolbar.tsx +69 -0
  74. package/src/FilterBar.tsx +396 -0
  75. package/src/QueryBuilder.tsx +274 -0
  76. package/src/cell-edit.ts +187 -0
  77. package/src/client-state.ts +52 -0
  78. package/src/client-view.ts +61 -0
  79. package/src/column-layout.ts +47 -0
  80. package/src/columns.ts +271 -0
  81. package/src/core.ts +54 -0
  82. package/src/export.ts +39 -0
  83. package/src/facets.ts +46 -0
  84. package/src/filter-bar-state.ts +118 -0
  85. package/src/filter-client.ts +79 -0
  86. package/src/filter.ts +113 -0
  87. package/src/grouping.ts +185 -0
  88. package/src/index.ts +7 -0
  89. package/src/messages.ts +29 -0
  90. package/src/pagination.ts +81 -0
  91. package/src/query-builder-state.ts +105 -0
  92. package/src/requests.ts +85 -0
  93. package/src/row-hierarchy.ts +280 -0
  94. package/src/row-identity.ts +39 -0
  95. package/src/saved-views.ts +143 -0
  96. package/src/search-controller.ts +61 -0
  97. package/src/search.ts +137 -0
  98. package/src/selection-client.ts +23 -0
  99. package/src/selection.ts +62 -0
  100. package/src/server-export.ts +89 -0
  101. package/src/sorting.ts +63 -0
  102. package/src/styles.css +197 -0
  103. package/src/table-state-changes.ts +51 -0
  104. package/src/table-state.ts +72 -0
  105. package/src/text-normalization.ts +14 -0
  106. package/src/url-state.ts +62 -0
@@ -0,0 +1,52 @@
1
+ import type { TableState, TableStateSchema } from "./table-state.ts";
2
+ export interface SavedViewRecord {
3
+ readonly id: string;
4
+ readonly name: string;
5
+ readonly state: string;
6
+ }
7
+ export interface SavedViewSave {
8
+ readonly id: string | null;
9
+ readonly name: string;
10
+ readonly state: string;
11
+ }
12
+ export interface SavedViewsAdapter {
13
+ readonly list: (signal: AbortSignal) => Promise<readonly SavedViewRecord[]>;
14
+ readonly save: (view: SavedViewSave, signal: AbortSignal) => Promise<SavedViewRecord>;
15
+ readonly delete: (id: string, signal: AbortSignal) => Promise<void>;
16
+ }
17
+ export type SavedViewOperation = {
18
+ readonly kind: "list";
19
+ } | {
20
+ readonly kind: "save";
21
+ readonly view: SavedViewSave;
22
+ } | {
23
+ readonly kind: "delete";
24
+ readonly id: string;
25
+ };
26
+ export interface SavedViewsSnapshot {
27
+ readonly accepted: readonly SavedViewRecord[] | null;
28
+ readonly pending: SavedViewOperation | null;
29
+ readonly failed: SavedViewOperation | null;
30
+ readonly error: unknown;
31
+ }
32
+ export type SavedViewOutcome = "accepted" | "failed" | "superseded" | "disposed";
33
+ export type SavedViewRestore = {
34
+ readonly kind: "accepted";
35
+ readonly state: TableState;
36
+ } | {
37
+ readonly kind: "missing";
38
+ } | {
39
+ readonly kind: "invalid";
40
+ readonly error: unknown;
41
+ };
42
+ /** Async saved-view ownership. Persistence and authorization stay in the app adapter. */
43
+ export declare function createSavedViews(adapter: SavedViewsAdapter, schema: TableStateSchema): {
44
+ getSnapshot: () => SavedViewsSnapshot;
45
+ list: () => Promise<SavedViewOutcome>;
46
+ save: (name: string, state: TableState, id?: string | null) => Promise<SavedViewOutcome>;
47
+ delete: (id: string) => Promise<SavedViewOutcome>;
48
+ restore: (id: string) => SavedViewRestore;
49
+ retry: () => Promise<SavedViewOutcome>;
50
+ clear: () => void;
51
+ dispose(): void;
52
+ };
@@ -0,0 +1,153 @@
1
+ import { deserializeState as e, serializeState as t } from "./table-state.js";
2
+ //#region src/saved-views.ts
3
+ function n(e, t) {
4
+ if (typeof e != "string" || !e || e.trim() !== e) throw Error(`${t} must be a nonempty trimmed string`);
5
+ return e;
6
+ }
7
+ function r(e, t) {
8
+ if (typeof e != "object" || !e || Array.isArray(e)) throw Error(`${t} must be an object`);
9
+ let r = Object.keys(e);
10
+ if (r.length !== 3 || !r.includes("id") || !r.includes("name") || !r.includes("state")) throw Error(`${t} must contain exactly id, name, and state`);
11
+ let i = n(e.id, `${t}.id`), a = n(e.name, `${t}.name`);
12
+ if (typeof e.state != "string" || !e.state) throw Error(`${t}.state must be a nonempty serialized string`);
13
+ return Object.freeze({
14
+ id: i,
15
+ name: a,
16
+ state: e.state
17
+ });
18
+ }
19
+ function i(e) {
20
+ if (!Array.isArray(e)) throw Error("Saved view list must be an array");
21
+ let t = [], n = /* @__PURE__ */ new Set(), i = 0;
22
+ for (let a of e) {
23
+ let e = r(a, `views[${i}]`);
24
+ if (n.has(e.id)) throw Error(`views[${i}] duplicates ID ${e.id}`);
25
+ n.add(e.id), t.push(e), i++;
26
+ }
27
+ return Object.freeze(t);
28
+ }
29
+ function a(e) {
30
+ return e.kind === "save" ? Object.freeze({
31
+ kind: "save",
32
+ view: Object.freeze({ ...e.view })
33
+ }) : Object.freeze({ ...e });
34
+ }
35
+ function o(o, s) {
36
+ let c = Object.freeze({
37
+ accepted: null,
38
+ pending: null,
39
+ failed: null,
40
+ error: null
41
+ }), l = 0n, u, d = !1, f = !1;
42
+ async function p(t) {
43
+ if (d) return "disposed";
44
+ if (f) return "superseded";
45
+ let n = a(t), p = ++l, m = u;
46
+ if (u = void 0, m?.abort(), d) return "disposed";
47
+ if (p !== l) return "superseded";
48
+ let h = new AbortController();
49
+ u = h, c = Object.freeze({
50
+ ...c,
51
+ pending: n,
52
+ failed: null,
53
+ error: null
54
+ });
55
+ try {
56
+ if (n.kind === "list") {
57
+ let e = i(await o.list(h.signal));
58
+ return d ? "disposed" : p === l ? (c = Object.freeze({
59
+ accepted: e,
60
+ pending: null,
61
+ failed: null,
62
+ error: null
63
+ }), "accepted") : "superseded";
64
+ }
65
+ if (n.kind === "save") {
66
+ let t = r(await o.save(n.view, h.signal), "saved view");
67
+ if (d) return "disposed";
68
+ if (p !== l) return "superseded";
69
+ if (n.view.id !== null && n.view.id !== t.id) throw Error("Saved view adapter changed the requested ID");
70
+ e(t.state, s);
71
+ let i = c.accepted ?? [], a = i.findIndex((e) => e.id === t.id) < 0 ? [...i, t] : i.map((e) => e.id === t.id ? t : e);
72
+ return c = Object.freeze({
73
+ accepted: Object.freeze(a),
74
+ pending: null,
75
+ failed: null,
76
+ error: null
77
+ }), "accepted";
78
+ }
79
+ return await o.delete(n.id, h.signal), d ? "disposed" : p === l ? (c = Object.freeze({
80
+ accepted: c.accepted ? Object.freeze(c.accepted.filter((e) => e.id !== n.id)) : null,
81
+ pending: null,
82
+ failed: null,
83
+ error: null
84
+ }), "accepted") : "superseded";
85
+ } catch (e) {
86
+ return d ? "disposed" : p === l ? (c = Object.freeze({
87
+ ...c,
88
+ pending: null,
89
+ failed: n,
90
+ error: e
91
+ }), "failed") : "superseded";
92
+ } finally {
93
+ p === l && (u = void 0);
94
+ }
95
+ }
96
+ function m(e, r, i = null) {
97
+ return p({
98
+ kind: "save",
99
+ view: Object.freeze({
100
+ id: i === null ? null : n(i, "Saved view ID"),
101
+ name: n(e, "Saved view name"),
102
+ state: t(r, s)
103
+ })
104
+ });
105
+ }
106
+ function h(t) {
107
+ try {
108
+ let r = n(t, "Saved view ID"), i = c.accepted?.find((e) => e.id === r);
109
+ return Object.freeze(i ? {
110
+ kind: "accepted",
111
+ state: e(i.state, s)
112
+ } : { kind: "missing" });
113
+ } catch (e) {
114
+ return Object.freeze({
115
+ kind: "invalid",
116
+ error: e
117
+ });
118
+ }
119
+ }
120
+ function g() {
121
+ if (f) return;
122
+ f = !0, l++;
123
+ let e = u;
124
+ u = void 0, c = Object.freeze({
125
+ accepted: null,
126
+ pending: null,
127
+ failed: null,
128
+ error: null
129
+ });
130
+ try {
131
+ e?.abort();
132
+ } finally {
133
+ f = !1;
134
+ }
135
+ }
136
+ return {
137
+ getSnapshot: () => c,
138
+ list: () => p({ kind: "list" }),
139
+ save: m,
140
+ delete: (e) => p({
141
+ kind: "delete",
142
+ id: n(e, "Saved view ID")
143
+ }),
144
+ restore: h,
145
+ retry: () => c.failed ? p(c.failed) : Promise.resolve(d ? "disposed" : "failed"),
146
+ clear: g,
147
+ dispose() {
148
+ d = !0, g();
149
+ }
150
+ };
151
+ }
152
+ //#endregion
153
+ export { o as createSavedViews };
@@ -0,0 +1,22 @@
1
+ export interface SearchSnapshot<Result> {
2
+ readonly accepted: {
3
+ readonly query: string;
4
+ readonly result: Result;
5
+ } | null;
6
+ readonly requested: string | null;
7
+ readonly pending: boolean;
8
+ readonly error: unknown;
9
+ }
10
+ export type SearchOutcome = "accepted" | "failed" | "superseded" | "cleared" | "disposed";
11
+ export interface InitialSearchResult<Result> {
12
+ readonly query: string;
13
+ readonly result: Result;
14
+ }
15
+ /** Owns trailing scheduling, not a data cache. Evaluate against the current complete client dataset. */
16
+ export declare function createDebouncedSearch<Result>(evaluate: (query: string) => Result, delay?: number, initial?: InitialSearchResult<Result>): {
17
+ getSnapshot: () => SearchSnapshot<Result>;
18
+ request: (query: string) => Promise<SearchOutcome>;
19
+ retry: () => Promise<SearchOutcome>;
20
+ clear: () => void;
21
+ dispose: () => void;
22
+ };
@@ -0,0 +1,75 @@
1
+ //#region src/search-controller.ts
2
+ function e(e, t = 120, n) {
3
+ if (!Number.isSafeInteger(t) || t < 0 || t > 2147483647) throw Error("Search delay must be a nonnegative timer-safe integer");
4
+ if (n && typeof n.query != "string") throw Error("Initial search query must be a string");
5
+ let r = {
6
+ accepted: n ? {
7
+ query: n.query,
8
+ result: n.result
9
+ } : null,
10
+ requested: null,
11
+ pending: !1,
12
+ error: null
13
+ }, i = 0n, a = !1, o;
14
+ function s(e) {
15
+ i++;
16
+ let t = o;
17
+ o = void 0, t && (clearTimeout(t.timer), t.finish(e));
18
+ }
19
+ function c(n) {
20
+ if (a) return Promise.resolve("disposed");
21
+ s("superseded");
22
+ let c = i;
23
+ return r = {
24
+ ...r,
25
+ requested: n,
26
+ pending: !0,
27
+ error: null
28
+ }, new Promise((s) => {
29
+ o = {
30
+ timer: setTimeout(() => {
31
+ try {
32
+ let t = e(n);
33
+ if (c !== i || a) return;
34
+ r = {
35
+ accepted: {
36
+ query: n,
37
+ result: t
38
+ },
39
+ requested: null,
40
+ pending: !1,
41
+ error: null
42
+ }, o = void 0, s("accepted");
43
+ } catch (e) {
44
+ if (c !== i || a) return;
45
+ r = {
46
+ ...r,
47
+ pending: !1,
48
+ error: e
49
+ }, o = void 0, s("failed");
50
+ }
51
+ }, t),
52
+ finish: s
53
+ };
54
+ });
55
+ }
56
+ function l() {
57
+ s(a ? "disposed" : "cleared"), r = {
58
+ accepted: null,
59
+ requested: null,
60
+ pending: !1,
61
+ error: null
62
+ };
63
+ }
64
+ return {
65
+ getSnapshot: () => r,
66
+ request: c,
67
+ retry: () => r.requested === null ? Promise.resolve(a ? "disposed" : "failed") : c(r.requested),
68
+ clear: l,
69
+ dispose: () => {
70
+ a = !0, l();
71
+ }
72
+ };
73
+ }
74
+ //#endregion
75
+ export { e as createDebouncedSearch };
@@ -0,0 +1,28 @@
1
+ export interface SearchEvaluation<Row> {
2
+ readonly locale: string;
3
+ readonly columns: readonly string[];
4
+ readonly getValue: (row: Row, column: string) => unknown;
5
+ /** Enables the portable leading-apostrophe literal-phrase syntax. */
6
+ readonly exactMatch?: boolean;
7
+ }
8
+ export interface SearchMatch<Row> {
9
+ readonly row: Row;
10
+ /** Lower is better. Equal ranks preserve source order. */
11
+ readonly rank: number;
12
+ }
13
+ export type SearchMode = "ranked" | "exact";
14
+ export interface SearchQuery {
15
+ readonly mode: SearchMode;
16
+ readonly value: string;
17
+ }
18
+ /**
19
+ * Parse DataTable's serializable search syntax. A leading apostrophe selects a
20
+ * literal contiguous phrase; two leading apostrophes escape a literal apostrophe.
21
+ */
22
+ export declare function parseSearchQuery(query: string, exactMatch?: boolean): SearchQuery;
23
+ /** Encode a match mode without adding a second field to persisted TableState. */
24
+ export declare function formatSearchQuery(value: string, mode: SearchMode): string;
25
+ /** AND ranked query terms across configured columns, or one literal phrase within a single column when enabled. */
26
+ export declare function searchClientRows<Row>(rows: readonly Row[], query: string, options: SearchEvaluation<Row>): readonly SearchMatch<Row>[];
27
+ /** Package-internal row-only path avoids allocating public match records for an inactive query. */
28
+ export declare function searchClientRowValues<Row>(rows: readonly Row[], query: string, options: SearchEvaluation<Row>): readonly Row[];
package/dist/search.js ADDED
@@ -0,0 +1,111 @@
1
+ import { createTextNormalizer as e } from "./text-normalization.js";
2
+ //#region src/search.ts
3
+ function t(e, t) {
4
+ if (e === t) return 0;
5
+ if (e.startsWith(t)) return 1;
6
+ if (e.includes(t)) return 2;
7
+ let n = 0;
8
+ for (let r of t) {
9
+ let t = e.indexOf(r, n);
10
+ if (t < 0) return null;
11
+ n = t + r.length;
12
+ }
13
+ return 3;
14
+ }
15
+ function n(e, t = !1) {
16
+ let n = e.trim();
17
+ return !t || !n.startsWith("'") ? Object.freeze({
18
+ mode: "ranked",
19
+ value: n
20
+ }) : n.startsWith("''") ? Object.freeze({
21
+ mode: "ranked",
22
+ value: n.slice(1)
23
+ }) : Object.freeze({
24
+ mode: "exact",
25
+ value: n.slice(1).trim()
26
+ });
27
+ }
28
+ function r(e, t) {
29
+ let n = e.trim();
30
+ return t === "exact" || n.startsWith("'") ? `'${n}` : n;
31
+ }
32
+ function i(t, r) {
33
+ let i = Intl.getCanonicalLocales(r.locale)[0];
34
+ if (!i) throw Error("Search requires an explicit locale");
35
+ let a = [...r.columns];
36
+ if (a.some((e) => typeof e != "string" || !e.trim()) || new Set(a).size !== a.length) throw Error("Search columns must be unique nonempty IDs");
37
+ let o = e(i), s = n(t, r.exactMatch ?? !1), c = o(s.value), l = s.mode === "exact" ? c ? [c] : [] : [...new Set(c.split(/\s+/u).filter(Boolean))];
38
+ return Object.freeze({
39
+ columns: Object.freeze(a),
40
+ mode: s.mode,
41
+ terms: Object.freeze(l),
42
+ normalize: o
43
+ });
44
+ }
45
+ function a(e, n, r) {
46
+ let i = n.terms.length === 1 ? n.terms[0] : void 0, a = [];
47
+ for (let o = 0; o < e.length; o++) {
48
+ let s = e[o];
49
+ if (s === void 0) throw Error(`Missing search row at index ${o}`);
50
+ if (i !== void 0) {
51
+ let e = null;
52
+ for (let a of n.columns) {
53
+ let o = r.getValue(s, a), c = typeof o == "string" ? n.normalize(o) : typeof o == "number" && Number.isFinite(o) ? String(o) : null;
54
+ if (c === null) continue;
55
+ let l = n.mode === "exact" ? c.includes(i) ? 0 : null : t(c, i);
56
+ if (l !== null && (e === null || l < e) && (e = l), e === 0) break;
57
+ }
58
+ e !== null && a.push({
59
+ row: s,
60
+ rank: e,
61
+ index: o
62
+ });
63
+ continue;
64
+ }
65
+ let c = Array.from({ length: n.terms.length }, () => null);
66
+ for (let e of n.columns) {
67
+ let i = r.getValue(s, e), a = typeof i == "string" ? n.normalize(i) : typeof i == "number" && Number.isFinite(i) ? String(i) : null;
68
+ if (a === null) continue;
69
+ let o = !0;
70
+ for (let e = 0; e < n.terms.length; e++) {
71
+ let r = c[e] ?? null;
72
+ if (r === 0) continue;
73
+ let i = n.terms[e];
74
+ if (i === void 0) continue;
75
+ let s = t(a, i);
76
+ s !== null && (r === null || s < r) && (c[e] = s), c[e] !== 0 && (o = !1);
77
+ }
78
+ if (o) break;
79
+ }
80
+ let l = 0, u = !1;
81
+ for (let e of c) {
82
+ if (e === null) {
83
+ u = !0;
84
+ break;
85
+ }
86
+ l += e;
87
+ }
88
+ u || a.push({
89
+ row: s,
90
+ rank: l,
91
+ index: o
92
+ });
93
+ }
94
+ return a.sort((e, t) => e.rank - t.rank || e.index - t.index), a;
95
+ }
96
+ function o(e, t, n) {
97
+ let r = i(t, n);
98
+ return r.terms.length === 0 ? e.map((e) => ({
99
+ row: e,
100
+ rank: 0
101
+ })) : a(e, r, n).map(({ row: e, rank: t }) => ({
102
+ row: e,
103
+ rank: t
104
+ }));
105
+ }
106
+ function s(e, t, n) {
107
+ let r = i(t, n);
108
+ return r.terms.length === 0 ? e : a(e, r, n).map((e) => e.row);
109
+ }
110
+ //#endregion
111
+ export { r as formatSearchQuery, n as parseSearchQuery, s as searchClientRowValues, o as searchClientRows };
@@ -0,0 +1,9 @@
1
+ import type { FilterEvaluation } from "./filter-client.ts";
2
+ import type { FilterColumn } from "./filter.ts";
3
+ import type { BulkSelection } from "./selection.ts";
4
+ export interface ClientSelectionOptions<Row> extends FilterEvaluation<Row> {
5
+ readonly filterColumns: readonly FilterColumn[];
6
+ readonly getRowId: (row: Row) => string;
7
+ }
8
+ /** Resolve a captured selection against a complete client view, preserving its order and row identity. */
9
+ export declare function selectClientRows<Row>(rows: readonly Row[], selection: BulkSelection, options: ClientSelectionOptions<Row>): readonly Row[];
@@ -0,0 +1,14 @@
1
+ import { compileFilter as e } from "./filter-client.js";
2
+ //#region src/selection-client.ts
3
+ function t(t, n, r) {
4
+ let i = new Set(n.kind === "ids" ? n.ids : n.excluded);
5
+ for (let e of i) if (typeof e != "string" || !e.trim()) throw Error("Invalid selection ID");
6
+ let a = n.kind === "query" ? e(n.filter, r.filterColumns, r) : void 0, o = /* @__PURE__ */ new Set();
7
+ return t.filter((e) => {
8
+ let t = r.getRowId(e);
9
+ if (typeof t != "string" || !t.trim() || o.has(t)) throw Error("Client row IDs must be unique nonempty strings");
10
+ return o.add(t), n.kind === "ids" ? i.has(t) : !i.has(t) && !!a?.(e);
11
+ });
12
+ }
13
+ //#endregion
14
+ export { t as selectClientRows };
@@ -0,0 +1,25 @@
1
+ import type { FilterColumn, FilterNode } from "./filter.ts";
2
+ export type BulkSelection = {
3
+ readonly kind: "ids";
4
+ readonly ids: readonly string[];
5
+ } | {
6
+ readonly kind: "query";
7
+ readonly filter: FilterNode;
8
+ readonly excluded: readonly string[];
9
+ };
10
+ /** Owns selection IDs only. The app owns authorization, matching rows, and bulk execution. */
11
+ export declare function createTableSelection(initialFilter: FilterNode, columns: readonly FilterColumn[]): {
12
+ /** Supply only IDs from the accepted matching page/view, not pending-query placeholders. */
13
+ setLoadedIds(ids: readonly string[]): void;
14
+ setSelected: (id: string, selected: boolean) => void;
15
+ selectLoaded(selected?: boolean): void;
16
+ selectRange(anchor: string, target: string, selected?: boolean): void;
17
+ selectAllMatching(): void;
18
+ isSelected(id: string): boolean;
19
+ getPayload(): BulkSelection;
20
+ /** Filter changes clear selection and loaded-row eligibility. Reapplying identical state does not. */
21
+ setFilter(value: FilterNode): void;
22
+ clear: () => void;
23
+ /** Clear both payload and eligibility when an account/permission boundary changes. */
24
+ reset(): void;
25
+ };
@@ -0,0 +1,60 @@
1
+ import { parseFilter as e } from "./filter.js";
2
+ //#region src/selection.ts
3
+ function t(e) {
4
+ let t = /* @__PURE__ */ new Set();
5
+ for (let n of e) {
6
+ if (typeof n != "string" || !n.trim() || t.has(n)) throw Error("Loaded selection IDs must be unique nonempty strings");
7
+ t.add(n);
8
+ }
9
+ return t;
10
+ }
11
+ function n(n, r) {
12
+ let i = e(n, r), a = JSON.stringify(i), o = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), l = !1;
13
+ function u() {
14
+ s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), l = !1;
15
+ }
16
+ function d(e, t) {
17
+ if (!o.has(e)) throw Error(`Selection changes require a loaded matching row: ${e}`);
18
+ l ? t ? c.delete(e) : c.add(e) : t ? s.add(e) : s.delete(e);
19
+ }
20
+ return {
21
+ setLoadedIds(e) {
22
+ o = t(e);
23
+ },
24
+ setSelected: d,
25
+ selectLoaded(e = !0) {
26
+ for (let t of o) d(t, e);
27
+ },
28
+ selectRange(e, t, n = !0) {
29
+ if (!o.has(e) || !o.has(t)) throw Error("Selection range endpoints must belong to the loaded matching view");
30
+ let r = [...o], i = r.indexOf(e), a = r.indexOf(t);
31
+ for (let e of r.slice(Math.min(i, a), Math.max(i, a) + 1)) d(e, n);
32
+ },
33
+ selectAllMatching() {
34
+ s = /* @__PURE__ */ new Set(), c = /* @__PURE__ */ new Set(), l = !0;
35
+ },
36
+ isSelected(e) {
37
+ return l ? o.has(e) && !c.has(e) : s.has(e);
38
+ },
39
+ getPayload() {
40
+ return Object.freeze(l ? {
41
+ kind: "query",
42
+ filter: i,
43
+ excluded: Object.freeze([...c])
44
+ } : {
45
+ kind: "ids",
46
+ ids: Object.freeze([...s])
47
+ });
48
+ },
49
+ setFilter(t) {
50
+ let n = e(t, r), s = JSON.stringify(n);
51
+ s !== a && (u(), o = /* @__PURE__ */ new Set()), i = n, a = s;
52
+ },
53
+ clear: u,
54
+ reset() {
55
+ u(), o = /* @__PURE__ */ new Set();
56
+ }
57
+ };
58
+ }
59
+ //#endregion
60
+ export { n as createTableSelection };
@@ -0,0 +1,27 @@
1
+ import type { BulkSelection } from "./selection.ts";
2
+ import type { TableState, TableStateSchema } from "./table-state.ts";
3
+ export interface TableExportRequest {
4
+ readonly format: "csv" | "json";
5
+ readonly state: TableState;
6
+ /** null exports the whole matching view; explicit empty IDs export zero rows. */
7
+ readonly selection: BulkSelection | null;
8
+ }
9
+ export interface ServerExportSnapshot<Artifact> {
10
+ readonly accepted: {
11
+ readonly request: TableExportRequest;
12
+ readonly artifact: Artifact;
13
+ } | null;
14
+ readonly requested: TableExportRequest | null;
15
+ readonly pending: boolean;
16
+ readonly error: unknown;
17
+ }
18
+ export type ServerExportOutcome = "accepted" | "failed" | "busy" | "unavailable" | "canceled" | "disposed";
19
+ /** App callback creates the artifact; only the accepted result should be offered for download. */
20
+ export declare function createServerExport<Artifact>(schema: TableStateSchema, onExport?: (request: TableExportRequest, signal: AbortSignal) => Promise<Artifact>): {
21
+ available: boolean;
22
+ getSnapshot: () => ServerExportSnapshot<Artifact>;
23
+ request: (value: TableExportRequest) => Promise<ServerExportOutcome>;
24
+ retry: () => Promise<ServerExportOutcome>;
25
+ clear: () => void;
26
+ dispose(): void;
27
+ };
@@ -0,0 +1,105 @@
1
+ import { parseFilter as e } from "./filter.js";
2
+ import { parseTableState as t } from "./table-state.js";
3
+ //#region src/server-export.ts
4
+ function n(n, r) {
5
+ if (n.format !== "csv" && n.format !== "json") throw Error("Unsupported table export format");
6
+ let i = t(n.state, r), a = null;
7
+ if (n.selection !== null) {
8
+ let t = n.selection;
9
+ if (t.kind !== "ids" && t.kind !== "query") throw Error("Invalid export selection kind");
10
+ let i = t.kind === "ids" ? t.ids : t.excluded;
11
+ if (!Array.isArray(i)) throw Error("Export selection IDs must be an array");
12
+ let o = /* @__PURE__ */ new Set();
13
+ for (let e of i) {
14
+ if (typeof e != "string" || !e.trim() || o.has(e)) throw Error("Export selection IDs must be unique nonempty strings");
15
+ o.add(e);
16
+ }
17
+ a = t.kind === "ids" ? Object.freeze({
18
+ kind: "ids",
19
+ ids: Object.freeze([...o])
20
+ }) : Object.freeze({
21
+ kind: "query",
22
+ filter: e(t.filter, r.filterColumns),
23
+ excluded: Object.freeze([...o])
24
+ });
25
+ }
26
+ return Object.freeze({
27
+ format: n.format,
28
+ state: i,
29
+ selection: a
30
+ });
31
+ }
32
+ function r(e, t) {
33
+ let r = {
34
+ accepted: null,
35
+ requested: null,
36
+ pending: !1,
37
+ error: null
38
+ }, i = 0n, a, o = !1, s = !1;
39
+ async function c(c) {
40
+ if (o) return "disposed";
41
+ if (!t) return "unavailable";
42
+ if (s) return "canceled";
43
+ if (r.pending) return "busy";
44
+ let l = ++i, u = new AbortController();
45
+ a = u, r = {
46
+ ...r,
47
+ requested: null,
48
+ pending: !0,
49
+ error: null
50
+ };
51
+ try {
52
+ let a = n(c, e);
53
+ r = {
54
+ ...r,
55
+ requested: a
56
+ };
57
+ let s = await t(a, u.signal);
58
+ return o ? "disposed" : l === i ? (r = {
59
+ accepted: {
60
+ request: a,
61
+ artifact: s
62
+ },
63
+ requested: null,
64
+ pending: !1,
65
+ error: null
66
+ }, "accepted") : "canceled";
67
+ } catch (e) {
68
+ return o ? "disposed" : l === i ? (r = {
69
+ ...r,
70
+ pending: !1,
71
+ error: e
72
+ }, "failed") : "canceled";
73
+ } finally {
74
+ l === i && (a = void 0);
75
+ }
76
+ }
77
+ function l() {
78
+ if (s) return;
79
+ s = !0, i++;
80
+ let e = a;
81
+ a = void 0, r = {
82
+ accepted: null,
83
+ requested: null,
84
+ pending: !1,
85
+ error: null
86
+ };
87
+ try {
88
+ e?.abort();
89
+ } finally {
90
+ s = !1;
91
+ }
92
+ }
93
+ return {
94
+ available: t !== void 0,
95
+ getSnapshot: () => r,
96
+ request: c,
97
+ retry: () => r.requested ? c(r.requested) : Promise.resolve(o ? "disposed" : t ? "failed" : "unavailable"),
98
+ clear: l,
99
+ dispose() {
100
+ o = !0, l();
101
+ }
102
+ };
103
+ }
104
+ //#endregion
105
+ export { r as createServerExport };