@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,64 @@
1
+ export type FilterColumn = {
2
+ readonly id: string;
3
+ readonly type: "text";
4
+ } | {
5
+ readonly id: string;
6
+ readonly type: "number";
7
+ } | {
8
+ readonly id: string;
9
+ readonly type: "date";
10
+ } | {
11
+ readonly id: string;
12
+ readonly type: "enum";
13
+ readonly options: readonly string[];
14
+ };
15
+ export type FilterNode = {
16
+ readonly kind: "and";
17
+ readonly children: readonly FilterNode[];
18
+ } | {
19
+ readonly kind: "or";
20
+ readonly children: readonly FilterNode[];
21
+ } | {
22
+ readonly kind: "not";
23
+ readonly child: FilterNode;
24
+ } | {
25
+ readonly kind: "empty";
26
+ readonly column: string;
27
+ } | {
28
+ readonly kind: "text";
29
+ readonly column: string;
30
+ readonly operator: "eq" | "contains" | "startsWith" | "endsWith";
31
+ readonly value: string;
32
+ readonly caseSensitive: boolean;
33
+ } | {
34
+ readonly kind: "number";
35
+ readonly column: string;
36
+ readonly operator: "eq" | "lt" | "lte" | "gt" | "gte";
37
+ readonly value: number;
38
+ } | {
39
+ readonly kind: "number";
40
+ readonly column: string;
41
+ readonly operator: "between";
42
+ readonly min: number;
43
+ readonly max: number;
44
+ } | {
45
+ readonly kind: "date";
46
+ readonly column: string;
47
+ readonly operator: "eq" | "lt" | "lte" | "gt" | "gte";
48
+ readonly value: number;
49
+ } | {
50
+ readonly kind: "date";
51
+ readonly column: string;
52
+ readonly operator: "between";
53
+ readonly min: number;
54
+ readonly max: number;
55
+ } | {
56
+ readonly kind: "enum";
57
+ readonly column: string;
58
+ readonly operator: "in";
59
+ readonly values: readonly string[];
60
+ };
61
+ /** Copy and validate the complete AST against the available filter columns before using it. */
62
+ export declare function parseFilter(value: unknown, columns: readonly FilterColumn[]): FilterNode;
63
+ export declare function serializeFilter(filter: FilterNode, columns: readonly FilterColumn[]): string;
64
+ export declare function deserializeFilter(serialized: string, columns: readonly FilterColumn[]): FilterNode;
package/dist/filter.js ADDED
@@ -0,0 +1,132 @@
1
+ //#region src/filter.ts
2
+ function e(e) {
3
+ return typeof e == "object" && !!e && !Array.isArray(e);
4
+ }
5
+ function t(e, t) {
6
+ throw Error(`Invalid filter at ${e}: ${t}`);
7
+ }
8
+ function n(e, n, r) {
9
+ for (let i of Object.keys(e)) n.includes(i) || t(r, `unknown field ${i}`);
10
+ }
11
+ function r(e, n, r) {
12
+ return typeof e != "number" || !Number.isFinite(e) ? t(n, "expected a finite number") : r && Math.abs(e) > 864e13 ? t(n, "timestamp is outside the supported epoch-millisecond range") : e === 0 ? 0 : e;
13
+ }
14
+ function i(i, a) {
15
+ let o = /* @__PURE__ */ new Map();
16
+ for (let e of a) {
17
+ if (typeof e.id != "string" || !e.id.trim() || o.has(e.id)) throw Error(`Invalid or duplicate filter column: ${e.id}`);
18
+ if (e.type === "enum") {
19
+ if (!Array.isArray(e.options)) throw Error(`Invalid enum options for filter column: ${e.id}`);
20
+ for (let t of e.options) if (typeof t != "string") throw Error(`Invalid enum options for filter column: ${e.id}`);
21
+ }
22
+ o.set(e.id, e);
23
+ }
24
+ let s = 0;
25
+ function c(i, a, l) {
26
+ if (++s > 4096 || l >= 64) return t(a, "filter exceeds 4096 nodes or 64 levels");
27
+ if (!e(i)) return t(a, "expected a node object");
28
+ let u = i.kind;
29
+ if (u === "and" || u === "or") return n(i, ["kind", "children"], a), Array.isArray(i.children) ? i.children.length > 4096 ? t(a, "filter exceeds 4096 nodes") : Object.freeze({
30
+ kind: u,
31
+ children: Object.freeze(Array.from(i.children, (e, t) => c(e, `${a}.children[${t}]`, l + 1)))
32
+ }) : t(a, "group children must be an array");
33
+ if (u === "not") return n(i, ["kind", "child"], a), Object.freeze({
34
+ kind: u,
35
+ child: c(i.child, `${a}.child`, l + 1)
36
+ });
37
+ if (typeof i.column != "string" || !o.has(i.column)) return t(a, "unknown or missing column");
38
+ let d = i.column;
39
+ if (u === "empty") return n(i, ["kind", "column"], a), Object.freeze({
40
+ kind: u,
41
+ column: d
42
+ });
43
+ if (u !== o.get(d)?.type) return t(a, `node type does not match column ${d}`);
44
+ let f = i.operator;
45
+ if (u === "text") return n(i, [
46
+ "kind",
47
+ "column",
48
+ "operator",
49
+ "value",
50
+ "caseSensitive"
51
+ ], a), f !== "eq" && f !== "contains" && f !== "startsWith" && f !== "endsWith" ? t(a, "unsupported text operator") : typeof i.value == "string" ? i.caseSensitive !== void 0 && typeof i.caseSensitive != "boolean" ? t(a, "caseSensitive must be boolean") : Object.freeze({
52
+ kind: u,
53
+ column: d,
54
+ operator: f,
55
+ value: i.value,
56
+ caseSensitive: i.caseSensitive ?? !1
57
+ }) : t(a, "text value must be a string");
58
+ if (u === "number" || u === "date") {
59
+ if (f === "between") {
60
+ n(i, [
61
+ "kind",
62
+ "column",
63
+ "operator",
64
+ "min",
65
+ "max"
66
+ ], a);
67
+ let e = r(i.min, `${a}.min`, u === "date"), o = r(i.max, `${a}.max`, u === "date");
68
+ return e > o ? t(a, "range minimum exceeds maximum") : Object.freeze({
69
+ kind: u,
70
+ column: d,
71
+ operator: f,
72
+ min: e,
73
+ max: o
74
+ });
75
+ }
76
+ return n(i, [
77
+ "kind",
78
+ "column",
79
+ "operator",
80
+ "value"
81
+ ], a), f !== "eq" && f !== "lt" && f !== "lte" && f !== "gt" && f !== "gte" ? t(a, "unsupported numeric/date operator") : Object.freeze({
82
+ kind: u,
83
+ column: d,
84
+ operator: f,
85
+ value: r(i.value, `${a}.value`, u === "date")
86
+ });
87
+ }
88
+ if (u === "enum") {
89
+ n(i, [
90
+ "kind",
91
+ "column",
92
+ "operator",
93
+ "values"
94
+ ], a);
95
+ let e = o.get(d);
96
+ if (f !== "in" || !Array.isArray(i.values) || e?.type !== "enum") return t(a, "enum requires an in operator and values array");
97
+ let r = new Set(e.options), s = [];
98
+ for (let e of i.values) {
99
+ if (typeof e != "string" || !r.has(e)) return t(a, "unknown enum option");
100
+ s.includes(e) || s.push(e);
101
+ }
102
+ return Object.freeze({
103
+ kind: u,
104
+ column: d,
105
+ operator: f,
106
+ values: Object.freeze(s)
107
+ });
108
+ }
109
+ return t(a, "unknown node kind");
110
+ }
111
+ return c(i, "$", 0);
112
+ }
113
+ function a(e, t) {
114
+ let n = JSON.stringify({
115
+ version: 1,
116
+ filter: i(e, t)
117
+ });
118
+ if (n.length > 262144) throw Error("Serialized filter exceeds 262144 characters");
119
+ return n;
120
+ }
121
+ function o(r, a) {
122
+ if (r.length > 262144) throw Error("Serialized filter exceeds 262144 characters");
123
+ let o;
124
+ try {
125
+ o = JSON.parse(r);
126
+ } catch {
127
+ throw Error("Invalid filter JSON");
128
+ }
129
+ return e(o) ? (n(o, ["version", "filter"], "$"), o.version === 1 ? i(o.filter, a) : t("$", "unsupported filter version")) : t("$", "expected versioned envelope");
130
+ }
131
+ //#endregion
132
+ export { o as deserializeFilter, i as parseFilter, a as serializeFilter };
@@ -0,0 +1,37 @@
1
+ import type { ColumnAggregate, ColumnValue } from "./columns.ts";
2
+ export interface GroupAggregateColumn<Row extends object> {
3
+ readonly id: string;
4
+ readonly aggregate: ColumnAggregate;
5
+ readonly getValue: (row: Row) => ColumnValue;
6
+ }
7
+ export interface GroupAggregateValue {
8
+ readonly column: string;
9
+ readonly value: number | null;
10
+ }
11
+ export interface ClientRowGroup<Row extends object> {
12
+ readonly id: string;
13
+ readonly value: ColumnValue;
14
+ readonly rows: readonly Row[];
15
+ /** Full matching leaf count. Equals rows.length for client groups. */
16
+ readonly count: number;
17
+ readonly aggregates: readonly GroupAggregateValue[];
18
+ }
19
+ export interface ServerRowGroup {
20
+ readonly value: ColumnValue;
21
+ readonly rowIds: readonly string[];
22
+ readonly count: number;
23
+ readonly aggregates: readonly GroupAggregateValue[];
24
+ }
25
+ export interface ClientGroupingOptions<Row extends object> {
26
+ readonly column: string;
27
+ readonly getValue: (row: Row) => ColumnValue;
28
+ readonly aggregates?: readonly GroupAggregateColumn<Row>[];
29
+ }
30
+ /** Group a complete accepted client view in first-seen order and calculate leaf aggregates. */
31
+ export declare function groupClientRows<Row extends object>(rows: readonly Row[], options: ClientGroupingOptions<Row>): readonly ClientRowGroup<Row>[];
32
+ /** Validate delegated groups against one accepted server page without recomputing full-query totals locally. */
33
+ export declare function normalizeServerGroups<Row extends object>(rows: readonly Row[], groups: unknown, options: {
34
+ readonly column: string;
35
+ readonly aggregateColumns: readonly string[];
36
+ readonly getRowId: (row: Row) => string;
37
+ }): readonly ClientRowGroup<Row>[];
@@ -0,0 +1,126 @@
1
+ //#region src/grouping.ts
2
+ function e(e, t) {
3
+ if (e === null || typeof e == "string" || typeof e == "boolean" || typeof e == "number" && Number.isFinite(e)) return e;
4
+ throw Error(`${t} must be a string, finite number, boolean, or null`);
5
+ }
6
+ function t(e) {
7
+ return e === null ? "null" : `${typeof e}:${JSON.stringify(e)}`;
8
+ }
9
+ function n(t, n) {
10
+ let r = 0, i = 0, a = Infinity, o = -Infinity;
11
+ for (let s = 0; s < t.length; s++) {
12
+ let c = e(n.getValue(t[s]), `Aggregate ${n.id} row ${s}`);
13
+ if (c !== null && (r++, n.aggregate !== "count")) {
14
+ if (typeof c != "number") throw Error(`Aggregate ${n.id} ${n.aggregate} requires numeric values`);
15
+ i += c, a = Math.min(a, c), o = Math.max(o, c);
16
+ }
17
+ }
18
+ let s = n.aggregate === "count" ? r : r === 0 ? null : n.aggregate === "sum" ? i : n.aggregate === "average" ? i / r : n.aggregate === "min" ? a : o;
19
+ return Object.freeze({
20
+ column: n.id,
21
+ value: s
22
+ });
23
+ }
24
+ function r(r, i) {
25
+ if (!Array.isArray(r)) throw Error("Grouped rows must be an array");
26
+ if (typeof i.column != "string" || !i.column.trim()) throw Error("Grouping column must be a nonempty string");
27
+ if (typeof i.getValue != "function") throw Error("Grouping requires a value accessor");
28
+ let a = i.aggregates ?? [], o = /* @__PURE__ */ new Set();
29
+ for (let e of a) {
30
+ if (!e || typeof e != "object" || typeof e.id != "string" || !e.id.trim() || o.has(e.id)) throw Error("Aggregate columns require unique nonempty IDs");
31
+ if (e.aggregate !== "sum" && e.aggregate !== "average" && e.aggregate !== "min" && e.aggregate !== "max" && e.aggregate !== "count") throw Error(`Aggregate ${e.id} has an invalid operation`);
32
+ if (typeof e.getValue != "function") throw Error(`Aggregate ${e.id} requires a value accessor`);
33
+ o.add(e.id);
34
+ }
35
+ let s = /* @__PURE__ */ new Map();
36
+ for (let t = 0; t < r.length; t++) {
37
+ if (!Object.hasOwn(r, t) || typeof r[t] != "object" || r[t] === null) throw Error(`Grouped row ${t} must be an object`);
38
+ let n = r[t], a = e(i.getValue(n), `Grouping value at row ${t}`), o = s.get(a);
39
+ o ? o.push(n) : s.set(a, [n]);
40
+ }
41
+ return Object.freeze([...s].map(([e, r]) => {
42
+ let o = Object.freeze([...r]);
43
+ return Object.freeze({
44
+ id: `group:${i.column}:${t(e)}`,
45
+ value: e,
46
+ rows: o,
47
+ count: o.length,
48
+ aggregates: Object.freeze(a.map((e) => n(o, e)))
49
+ });
50
+ }));
51
+ }
52
+ function i(e) {
53
+ return typeof e == "object" && !!e && !Array.isArray(e);
54
+ }
55
+ function a(n, r, a) {
56
+ let s = o(n);
57
+ if (!Array.isArray(r)) throw Error("Server grouping requires a groups array");
58
+ let c = r, l = /* @__PURE__ */ new Set();
59
+ for (let e of a.aggregateColumns) {
60
+ if (typeof e != "string" || !e.trim() || l.has(e)) throw Error("Server aggregate columns must be unique nonempty IDs");
61
+ l.add(e);
62
+ }
63
+ let u = /* @__PURE__ */ new Map(), d = [];
64
+ for (let e = 0; e < s.length; e++) {
65
+ let t = s[e], n = a.getRowId(t);
66
+ if (typeof n != "string" || !n.trim() || u.has(n)) throw Error(`Server grouped row ${e} has an invalid or duplicate ID`);
67
+ u.set(n, t), d.push(n);
68
+ }
69
+ let f = /* @__PURE__ */ new Set(), p = /* @__PURE__ */ new Set(), m = [], h = [];
70
+ for (let n = 0; n < c.length; n++) {
71
+ let r = c[n];
72
+ if (!Object.hasOwn(c, n) || !i(r)) throw Error(`Server group ${n} must be an object`);
73
+ let o = r;
74
+ for (let e of Object.keys(o)) if (e !== "value" && e !== "rowIds" && e !== "count" && e !== "aggregates") throw Error(`Server group ${n} has unknown field ${e}`);
75
+ for (let e of [
76
+ "value",
77
+ "rowIds",
78
+ "count",
79
+ "aggregates"
80
+ ]) if (!Object.hasOwn(o, e)) throw Error(`Server group ${n} is missing ${e}`);
81
+ let s = e(o.value, `Server group ${n} value`), d = `group:${a.column}:${t(s)}`;
82
+ if (p.has(d)) throw Error(`Duplicate server group value at index ${n}`);
83
+ if (p.add(d), !Array.isArray(o.rowIds) || o.rowIds.length === 0) throw Error(`Server group ${n} rowIds must be a nonempty array`);
84
+ let g = o.rowIds, _ = [];
85
+ for (let e of g) {
86
+ if (typeof e != "string" || !e.trim() || f.has(e)) throw Error(`Server group ${n} has an invalid or duplicate row ID`);
87
+ let t = u.get(e);
88
+ if (!t) throw Error(`Server group ${n} references an unavailable page row: ${e}`);
89
+ f.add(e), m.push(e), _.push(t);
90
+ }
91
+ if (typeof o.count != "number" || !Number.isSafeInteger(o.count) || o.count < _.length) throw Error(`Server group ${n} count must cover its accepted page rows`);
92
+ if (!Array.isArray(o.aggregates)) throw Error(`Server group ${n} aggregates must be an array`);
93
+ let v = o.aggregates, y = [], b = /* @__PURE__ */ new Set();
94
+ for (let e = 0; e < v.length; e++) {
95
+ let t = v[e];
96
+ if (!i(t) || Object.keys(t).some((e) => e !== "column" && e !== "value") || !Object.hasOwn(t, "column") || !Object.hasOwn(t, "value")) throw Error(`Server group ${n} aggregate ${e} is invalid`);
97
+ if (typeof t.column != "string" || !l.has(t.column) || b.has(t.column)) throw Error(`Server group ${n} has an unknown or duplicate aggregate column`);
98
+ if (t.value !== null && (typeof t.value != "number" || !Number.isFinite(t.value))) throw Error(`Server group ${n} aggregate ${t.column} must be finite or null`);
99
+ b.add(t.column), y.push(Object.freeze({
100
+ column: t.column,
101
+ value: t.value
102
+ }));
103
+ }
104
+ if (b.size !== l.size) throw Error(`Server group ${n} must provide every configured aggregate`);
105
+ h.push(Object.freeze({
106
+ id: d,
107
+ value: s,
108
+ rows: Object.freeze(_),
109
+ count: o.count,
110
+ aggregates: Object.freeze(y)
111
+ }));
112
+ }
113
+ if (m.length !== d.length || m.some((e, t) => e !== d[t])) throw Error("Server groups must cover every accepted page row once in server order");
114
+ return Object.freeze(h);
115
+ }
116
+ function o(e) {
117
+ if (!Array.isArray(e)) throw Error("Server grouped rows must be an array");
118
+ let t = [];
119
+ for (let n = 0; n < e.length; n++) {
120
+ if (!Object.hasOwn(e, n) || typeof e[n] != "object" || e[n] === null) throw Error(`Server grouped row ${n} must be an object`);
121
+ t.push(e[n]);
122
+ }
123
+ return Object.freeze(t);
124
+ }
125
+ //#endregion
126
+ export { r as groupClientRows, a as normalizeServerGroups };
@@ -0,0 +1,7 @@
1
+ export * from "./core.ts";
2
+ export { DataTable } from "./DataTable.tsx";
3
+ export type { DataTableProps, DataTableResult, DataTableInitialState, DataTableSelectionOptions, DataTableGroupingOptions, DataTableHierarchyOptions, DataTableExportFormat, DataTableExportOptions, DataTableCellCommitRequest, DataTableAction, DataTableActionContext, DataTableMobileLayoutOptions, DataTableVariant, DataTableDensity, DataTableSearchOptions, DataTableFilterBarOptions, ClientDataTableProps, ServerDataTableProps } from "./DataTable.tsx";
4
+ export { FilterBar } from "./FilterBar.tsx";
5
+ export type { FilterBarProps, FilterDateEditor, FilterDateEditorProps } from "./FilterBar.tsx";
6
+ export { QueryBuilder } from "./QueryBuilder.tsx";
7
+ export type { QueryBuilderProps } from "./QueryBuilder.tsx";
package/dist/index.js ADDED
@@ -0,0 +1,31 @@
1
+ import { assessServerPage as e, getPageRange as t, paginateClientRows as n, parsePagination as r, resetPagination as i, resizePagination as a, resolvePagination as o } from "./pagination.js";
2
+ import { createTableRequests as s } from "./requests.js";
3
+ import { deserializeFilter as c, parseFilter as l, serializeFilter as u } from "./filter.js";
4
+ import { appendQueryChild as d, defaultQueryRule as f, moveQueryNode as p, queryBuilderFilterColumns as m, queryNodeAt as h, removeQueryNode as g, replaceQueryNode as _, toggleQueryNegation as v } from "./query-builder-state.js";
5
+ import { appendFilterCondition as y, listFilterConditions as b, removeFilterColumnConditions as x, removeFilterCondition as S, replaceFilterCondition as C } from "./filter-bar-state.js";
6
+ import { compileFilter as w, filterClientRows as T } from "./filter-client.js";
7
+ import { parseSorting as E, sortClientRows as D } from "./sorting.js";
8
+ import { countClientFacets as O } from "./facets.js";
9
+ import { formatSearchQuery as k, parseSearchQuery as A, searchClientRows as j } from "./search.js";
10
+ import { createDebouncedSearch as M } from "./search-controller.js";
11
+ import { createClientView as N } from "./client-view.js";
12
+ import { changeClientViewState as P, parseClientViewState as F } from "./client-state.js";
13
+ import { deserializeState as I, parseTableState as L, serializeState as R } from "./table-state.js";
14
+ import { changeTableState as z } from "./table-state-changes.js";
15
+ import { canMoveColumn as B, moveColumn as V, orderColumnStates as H, placeColumn as U } from "./column-layout.js";
16
+ import { createTableSelection as W } from "./selection.js";
17
+ import { createClientExport as G } from "./export.js";
18
+ import { selectClientRows as K } from "./selection-client.js";
19
+ import { createServerExport as q } from "./server-export.js";
20
+ import { createCellEdit as J } from "./cell-edit.js";
21
+ import { defineColumns as Y } from "./columns.js";
22
+ import { createRowIdentity as X } from "./row-identity.js";
23
+ import { groupClientRows as Z, normalizeServerGroups as Q } from "./grouping.js";
24
+ import { createRowHierarchy as $ } from "./row-hierarchy.js";
25
+ import { createTableUrlState as ee } from "./url-state.js";
26
+ import { createSavedViews as te } from "./saved-views.js";
27
+ import { englishTableMessages as ne, resolveTableMessages as re } from "./messages.js";
28
+ import { FilterBar as ie } from "./FilterBar.js";
29
+ import { DataTable as ae } from "./DataTable.js";
30
+ import { QueryBuilder as oe } from "./QueryBuilder.js";
31
+ export { ae as DataTable, ie as FilterBar, oe as QueryBuilder, y as appendFilterCondition, d as appendQueryChild, e as assessServerPage, B as canMoveColumn, P as changeClientViewState, z as changeTableState, w as compileFilter, O as countClientFacets, J as createCellEdit, G as createClientExport, N as createClientView, M as createDebouncedSearch, $ as createRowHierarchy, X as createRowIdentity, te as createSavedViews, q as createServerExport, s as createTableRequests, W as createTableSelection, ee as createTableUrlState, f as defaultQueryRule, Y as defineColumns, c as deserializeFilter, I as deserializeState, ne as englishTableMessages, T as filterClientRows, k as formatSearchQuery, t as getPageRange, Z as groupClientRows, b as listFilterConditions, V as moveColumn, p as moveQueryNode, Q as normalizeServerGroups, H as orderColumnStates, n as paginateClientRows, F as parseClientViewState, l as parseFilter, r as parsePagination, A as parseSearchQuery, E as parseSorting, L as parseTableState, U as placeColumn, m as queryBuilderFilterColumns, h as queryNodeAt, x as removeFilterColumnConditions, S as removeFilterCondition, g as removeQueryNode, C as replaceFilterCondition, _ as replaceQueryNode, i as resetPagination, a as resizePagination, o as resolvePagination, re as resolveTableMessages, j as searchClientRows, K as selectClientRows, u as serializeFilter, R as serializeState, D as sortClientRows, v as toggleQueryNegation };
@@ -0,0 +1,115 @@
1
+ export declare const englishTableMessages: Readonly<{
2
+ loading: "Loading";
3
+ refreshing: "Refreshing, showing existing results";
4
+ noResults: "No results";
5
+ retry: "Retry";
6
+ retryFailed: "Retry failed. Try again.";
7
+ serverError: "Something went wrong";
8
+ searchTable: "Search {caption}";
9
+ searchMatchMode: "Search match mode";
10
+ searchRanked: "Smart";
11
+ searchExact: "Exact";
12
+ tableShortcuts: "Tables";
13
+ tableControls: "{caption} table controls";
14
+ resultCountOne: "{count} result";
15
+ resultCount: "{count} results";
16
+ previousResults: "Previous results";
17
+ clearFilters: "Clear filters";
18
+ clearSearchAndFilters: "Clear search and filters";
19
+ selectAll: "Select all matching";
20
+ selectPage: "Select this page";
21
+ selectRow: "Select row {id}";
22
+ clearSelection: "Clear selection";
23
+ selectionActions: "Selection actions";
24
+ selectedCount: "{count} selected";
25
+ cardView: "{caption}, card view";
26
+ rowActions: "Actions for row {id}";
27
+ sort: "Sort";
28
+ sortColumn: "Sort by {column}";
29
+ sortedAscending: "ascending";
30
+ sortedDescending: "descending";
31
+ notSorted: "not sorted";
32
+ sortPriority: "priority {position} of {count}";
33
+ export: "Export";
34
+ exportCSV: "Export CSV";
35
+ exportJSON: "Export JSON";
36
+ preparingExport: "Preparing export";
37
+ exportFailed: "Export failed";
38
+ retryExport: "Retry export";
39
+ downloadLastExport: "Download last export";
40
+ filters: "Filters";
41
+ filterAdd: "+ Filter";
42
+ filterColumns: "Filter columns";
43
+ filterSearchColumns: "Search filter columns";
44
+ filterEdit: "Edit filter";
45
+ filterRemove: "Remove filter";
46
+ filterApply: "Apply filter";
47
+ filterOperator: "Operator";
48
+ filterValue: "Value";
49
+ filterMinimum: "Minimum";
50
+ filterMaximum: "Maximum";
51
+ filterDate: "Date";
52
+ filterStartDate: "Start date";
53
+ filterEndDate: "End date";
54
+ filterValues: "Values";
55
+ filterCaseSensitive: "Case sensitive";
56
+ filterNegated: "Exclude matches";
57
+ filterInheritedNegation: "This condition is also inside an excluded group.";
58
+ filterInvalid: "Enter a valid filter value.";
59
+ filterEquals: "is";
60
+ filterContains: "contains";
61
+ filterStartsWith: "starts with";
62
+ filterEndsWith: "ends with";
63
+ filterLessThan: "is less than";
64
+ filterAtMost: "is at most";
65
+ filterGreaterThan: "is greater than";
66
+ filterAtLeast: "is at least";
67
+ filterBetween: "is between";
68
+ filterIsEmpty: "is empty";
69
+ filterIsAnyOf: "is any of";
70
+ filterSummary: "{column} {operator} {value}";
71
+ filterNot: "Not: {filter}";
72
+ filterInheritedNot: "Excluded group: {filter}";
73
+ queryBuilder: "Query builder";
74
+ queryGroup: "Query group";
75
+ queryRule: "Query rule";
76
+ queryMatch: "Match";
77
+ queryMatchAll: "All rules";
78
+ queryMatchAny: "Any rule";
79
+ queryColumn: "Column";
80
+ queryAddRule: "Add rule";
81
+ queryAddGroup: "Add group";
82
+ queryNegate: "Exclude";
83
+ queryRemoveNegation: "Include";
84
+ queryRemove: "Remove";
85
+ queryMoveBefore: "Move before";
86
+ queryMoveAfter: "Move after";
87
+ queryChanged: "Query updated";
88
+ groupMissing: "No value";
89
+ loadingChildren: "Loading children";
90
+ columns: "Columns";
91
+ showColumn: "Show column";
92
+ moveColumnStart: "Move toward start";
93
+ moveColumnEnd: "Move toward end";
94
+ pinColumn: "Pin column";
95
+ pinNone: "Not pinned";
96
+ pinStart: "Pin to start";
97
+ pinEnd: "Pin to end";
98
+ autoFitColumn: "Auto-fit width";
99
+ resetColumnWidth: "Reset width";
100
+ reorderColumn: "Drag to reorder {column}";
101
+ resizeColumn: "Resize {column}";
102
+ columnWidthPixels: "{width} pixels";
103
+ editCell: "Edit {column} for row {id}";
104
+ cellValueRequired: "A value is required";
105
+ cellValueInvalid: "Enter a valid value";
106
+ noValue: "No value";
107
+ cellUpdateFailed: "Cell update failed";
108
+ cellUpdateFailedDescription: "The committed value was restored and your draft was retained.";
109
+ cellConflict: "This value changed on the server to {value}. Review your draft or press Escape to discard it.";
110
+ expand: "Expand";
111
+ collapse: "Collapse";
112
+ }>;
113
+ export type TableMessages = Readonly<Record<keyof typeof englishTableMessages, string>>;
114
+ /** Layer provider overrides over the table package's tree-shakeable English defaults. */
115
+ export declare function resolveTableMessages(messages: Partial<TableMessages>): TableMessages;
@@ -0,0 +1,121 @@
1
+ //#region src/messages.ts
2
+ var e = Object.freeze({
3
+ loading: "Loading",
4
+ refreshing: "Refreshing, showing existing results",
5
+ noResults: "No results",
6
+ retry: "Retry",
7
+ retryFailed: "Retry failed. Try again.",
8
+ serverError: "Something went wrong",
9
+ searchTable: "Search {caption}",
10
+ searchMatchMode: "Search match mode",
11
+ searchRanked: "Smart",
12
+ searchExact: "Exact",
13
+ tableShortcuts: "Tables",
14
+ tableControls: "{caption} table controls",
15
+ resultCountOne: "{count} result",
16
+ resultCount: "{count} results",
17
+ previousResults: "Previous results",
18
+ clearFilters: "Clear filters",
19
+ clearSearchAndFilters: "Clear search and filters",
20
+ selectAll: "Select all matching",
21
+ selectPage: "Select this page",
22
+ selectRow: "Select row {id}",
23
+ clearSelection: "Clear selection",
24
+ selectionActions: "Selection actions",
25
+ selectedCount: "{count} selected",
26
+ cardView: "{caption}, card view",
27
+ rowActions: "Actions for row {id}",
28
+ sort: "Sort",
29
+ sortColumn: "Sort by {column}",
30
+ sortedAscending: "ascending",
31
+ sortedDescending: "descending",
32
+ notSorted: "not sorted",
33
+ sortPriority: "priority {position} of {count}",
34
+ export: "Export",
35
+ exportCSV: "Export CSV",
36
+ exportJSON: "Export JSON",
37
+ preparingExport: "Preparing export",
38
+ exportFailed: "Export failed",
39
+ retryExport: "Retry export",
40
+ downloadLastExport: "Download last export",
41
+ filters: "Filters",
42
+ filterAdd: "+ Filter",
43
+ filterColumns: "Filter columns",
44
+ filterSearchColumns: "Search filter columns",
45
+ filterEdit: "Edit filter",
46
+ filterRemove: "Remove filter",
47
+ filterApply: "Apply filter",
48
+ filterOperator: "Operator",
49
+ filterValue: "Value",
50
+ filterMinimum: "Minimum",
51
+ filterMaximum: "Maximum",
52
+ filterDate: "Date",
53
+ filterStartDate: "Start date",
54
+ filterEndDate: "End date",
55
+ filterValues: "Values",
56
+ filterCaseSensitive: "Case sensitive",
57
+ filterNegated: "Exclude matches",
58
+ filterInheritedNegation: "This condition is also inside an excluded group.",
59
+ filterInvalid: "Enter a valid filter value.",
60
+ filterEquals: "is",
61
+ filterContains: "contains",
62
+ filterStartsWith: "starts with",
63
+ filterEndsWith: "ends with",
64
+ filterLessThan: "is less than",
65
+ filterAtMost: "is at most",
66
+ filterGreaterThan: "is greater than",
67
+ filterAtLeast: "is at least",
68
+ filterBetween: "is between",
69
+ filterIsEmpty: "is empty",
70
+ filterIsAnyOf: "is any of",
71
+ filterSummary: "{column} {operator} {value}",
72
+ filterNot: "Not: {filter}",
73
+ filterInheritedNot: "Excluded group: {filter}",
74
+ queryBuilder: "Query builder",
75
+ queryGroup: "Query group",
76
+ queryRule: "Query rule",
77
+ queryMatch: "Match",
78
+ queryMatchAll: "All rules",
79
+ queryMatchAny: "Any rule",
80
+ queryColumn: "Column",
81
+ queryAddRule: "Add rule",
82
+ queryAddGroup: "Add group",
83
+ queryNegate: "Exclude",
84
+ queryRemoveNegation: "Include",
85
+ queryRemove: "Remove",
86
+ queryMoveBefore: "Move before",
87
+ queryMoveAfter: "Move after",
88
+ queryChanged: "Query updated",
89
+ groupMissing: "No value",
90
+ loadingChildren: "Loading children",
91
+ columns: "Columns",
92
+ showColumn: "Show column",
93
+ moveColumnStart: "Move toward start",
94
+ moveColumnEnd: "Move toward end",
95
+ pinColumn: "Pin column",
96
+ pinNone: "Not pinned",
97
+ pinStart: "Pin to start",
98
+ pinEnd: "Pin to end",
99
+ autoFitColumn: "Auto-fit width",
100
+ resetColumnWidth: "Reset width",
101
+ reorderColumn: "Drag to reorder {column}",
102
+ resizeColumn: "Resize {column}",
103
+ columnWidthPixels: "{width} pixels",
104
+ editCell: "Edit {column} for row {id}",
105
+ cellValueRequired: "A value is required",
106
+ cellValueInvalid: "Enter a valid value",
107
+ noValue: "No value",
108
+ cellUpdateFailed: "Cell update failed",
109
+ cellUpdateFailedDescription: "The committed value was restored and your draft was retained.",
110
+ cellConflict: "This value changed on the server to {value}. Review your draft or press Escape to discard it.",
111
+ expand: "Expand",
112
+ collapse: "Collapse"
113
+ });
114
+ function t(t) {
115
+ return Object.freeze({
116
+ ...e,
117
+ ...t
118
+ });
119
+ }
120
+ //#endregion
121
+ export { e as englishTableMessages, t as resolveTableMessages };
@@ -0,0 +1,36 @@
1
+ export interface PageState {
2
+ readonly pageIndex: number;
3
+ readonly pageSize: number;
4
+ }
5
+ export type TablePagination = false | PageState;
6
+ export interface PageRange extends PageState {
7
+ readonly pageCount: number;
8
+ readonly start: number;
9
+ readonly end: number;
10
+ }
11
+ export interface PageResult<Row> {
12
+ readonly rows: readonly Row[];
13
+ readonly total: number;
14
+ }
15
+ export type ServerPageAssessment<Row> = {
16
+ readonly kind: "accepted";
17
+ readonly pagination: TablePagination;
18
+ readonly result: PageResult<Row>;
19
+ } | {
20
+ readonly kind: "refetch";
21
+ readonly pagination: PageState;
22
+ readonly total: number;
23
+ };
24
+ export declare function parsePagination(value: unknown): TablePagination;
25
+ export declare function resolvePagination(mode: "client" | "server", value?: TablePagination): TablePagination;
26
+ /** Filter and sort changes reset the requested page, not accepted rows. */
27
+ export declare function resetPagination(value: TablePagination): TablePagination;
28
+ export declare function resizePagination(value: PageState, pageSize: number): PageState;
29
+ /** Clamp before multiplying so even extreme valid requested indices cannot overflow the offset. */
30
+ export declare function getPageRange(value: PageState, total: number): PageRange;
31
+ /** Call after transforming the complete client dataset, never on an individual server page. */
32
+ export declare function paginateClientRows<Row>(rows: readonly Row[], value?: TablePagination): PageResult<Row> & {
33
+ readonly pagination: TablePagination;
34
+ };
35
+ /** Validate a single response; never fetch, concatenate pages, or publish an invalid result. */
36
+ export declare function assessServerPage<Row>(value: TablePagination, result: PageResult<Row>): ServerPageAssessment<Row>;