@marktiderman/genesis-core 1.11.0 → 1.13.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 (80) hide show
  1. package/README.md +34 -0
  2. package/dist/chunk-3B4IFDMK.js +117 -0
  3. package/dist/chunk-3B4IFDMK.js.map +1 -0
  4. package/dist/chunk-7FVTGKTX.js +8 -0
  5. package/dist/chunk-7FVTGKTX.js.map +1 -0
  6. package/dist/chunk-AUVKRXRC.js +81 -0
  7. package/dist/chunk-AUVKRXRC.js.map +1 -0
  8. package/dist/chunk-FARKPY6R.js +66 -0
  9. package/dist/chunk-FARKPY6R.js.map +1 -0
  10. package/dist/{chunk-OSPLIKSH.js → chunk-GEF5W2LO.js} +19 -9
  11. package/dist/chunk-GEF5W2LO.js.map +1 -0
  12. package/dist/{chunk-NMFABW4Y.js → chunk-JKZ2FVWK.js} +5 -5
  13. package/dist/{chunk-NMFABW4Y.js.map → chunk-JKZ2FVWK.js.map} +1 -1
  14. package/dist/{chunk-RCAP3Q4T.js → chunk-OYIUIW7C.js} +3 -2
  15. package/dist/chunk-OYIUIW7C.js.map +1 -0
  16. package/dist/{chunk-S2ZXUNXB.js → chunk-REYTMXAA.js} +3 -3
  17. package/dist/{chunk-S2ZXUNXB.js.map → chunk-REYTMXAA.js.map} +1 -1
  18. package/dist/{chunk-BGTXN2E6.js → chunk-RF6YVWHX.js} +4 -4
  19. package/dist/{chunk-BGTXN2E6.js.map → chunk-RF6YVWHX.js.map} +1 -1
  20. package/dist/{chunk-ALOP5MZM.js → chunk-TCL27Q5W.js} +171 -59
  21. package/dist/chunk-TCL27Q5W.js.map +1 -0
  22. package/dist/{chunk-NZPJI7FC.js → chunk-UGGMJUFQ.js} +45 -13
  23. package/dist/chunk-UGGMJUFQ.js.map +1 -0
  24. package/dist/{chunk-KXVHDK3Q.js → chunk-UV3ROHQA.js} +27 -5
  25. package/dist/chunk-UV3ROHQA.js.map +1 -0
  26. package/dist/chunk-YDDPFSQ6.js +35 -0
  27. package/dist/chunk-YDDPFSQ6.js.map +1 -0
  28. package/dist/csv.d.ts +41 -0
  29. package/dist/csv.js +77 -0
  30. package/dist/csv.js.map +1 -0
  31. package/dist/dates.js +1 -115
  32. package/dist/dates.js.map +1 -1
  33. package/dist/hooks/index.d.ts +7 -43
  34. package/dist/hooks/index.js +14 -12
  35. package/dist/hooks/live-cache.d.ts +15 -0
  36. package/dist/hooks/live-cache.js +3 -0
  37. package/dist/hooks/live-cache.js.map +1 -0
  38. package/dist/hooks/mutation-mode.d.ts +2 -2
  39. package/dist/hooks/mutation-mode.js +2 -2
  40. package/dist/hooks/related-keys.d.ts +2 -2
  41. package/dist/hooks/use-capabilities.d.ts +1 -1
  42. package/dist/hooks/use-infinite-resource.d.ts +18 -2
  43. package/dist/hooks/use-infinite-resource.js +4 -3
  44. package/dist/hooks/use-live.d.ts +15 -3
  45. package/dist/hooks/use-live.js +2 -1
  46. package/dist/hooks/use-one.d.ts +2 -2
  47. package/dist/hooks/use-one.js +4 -3
  48. package/dist/hooks/use-resource-form.d.ts +9 -2
  49. package/dist/hooks/use-resource-form.js +7 -6
  50. package/dist/hooks/use-resource.d.ts +2 -2
  51. package/dist/hooks/use-resource.js +5 -4
  52. package/dist/hooks/use-write.d.ts +2 -2
  53. package/dist/index.d.ts +13 -6
  54. package/dist/index.js +19 -15
  55. package/dist/provider/index.d.ts +17 -6
  56. package/dist/provider/index.js +2 -2
  57. package/dist/resource/index.d.ts +86 -0
  58. package/dist/resource/index.js +85 -0
  59. package/dist/resource/index.js.map +1 -0
  60. package/dist/resource-view/index.d.ts +285 -0
  61. package/dist/resource-view/index.js +320 -0
  62. package/dist/resource-view/index.js.map +1 -0
  63. package/dist/schema/index.d.ts +4 -4
  64. package/dist/schema/index.js +1 -0
  65. package/dist/testing/index.d.ts +3 -3
  66. package/dist/{types-B9DDfvWa.d.ts → types-CXhqXPN1.d.ts} +21 -4
  67. package/dist/{types-C7FJtFXV.d.ts → types-o8j7g6O6.d.ts} +38 -1
  68. package/dist/urls.d.ts +18 -0
  69. package/dist/urls.js +3 -0
  70. package/dist/urls.js.map +1 -0
  71. package/dist/viewer-scope-0dR-_o0f.d.ts +76 -0
  72. package/dist/{write-outcome-B2fE29yZ.d.ts → write-outcome-CFnpciUI.d.ts} +1 -1
  73. package/package.json +17 -1
  74. package/dist/chunk-5ORRAXIV.js +0 -30
  75. package/dist/chunk-5ORRAXIV.js.map +0 -1
  76. package/dist/chunk-ALOP5MZM.js.map +0 -1
  77. package/dist/chunk-KXVHDK3Q.js.map +0 -1
  78. package/dist/chunk-NZPJI7FC.js.map +0 -1
  79. package/dist/chunk-OSPLIKSH.js.map +0 -1
  80. package/dist/chunk-RCAP3Q4T.js.map +0 -1
@@ -0,0 +1,320 @@
1
+ import { keyFields } from '../chunk-KV2HW4G4.js';
2
+ import { isSafeUrl } from '../chunk-YDDPFSQ6.js';
3
+ import { titleCase } from '../chunk-RYEXWQFD.js';
4
+
5
+ // src/resource-view/define-view.ts
6
+ var ViewDefinitionError = class extends Error {
7
+ problems;
8
+ constructor(resource, problems) {
9
+ super(`defineView(${resource}): ${problems.join("; ")}`);
10
+ this.name = "ViewDefinitionError";
11
+ this.problems = problems;
12
+ }
13
+ };
14
+ function deriveDisplay(field) {
15
+ if (field.references) return "relation";
16
+ switch (field.widget) {
17
+ case "url":
18
+ return "url";
19
+ case "email":
20
+ return "email";
21
+ case "image":
22
+ return "image";
23
+ case "textarea":
24
+ return "longText";
25
+ case "date":
26
+ return "date";
27
+ }
28
+ if (field.enumValues?.length) return "badge";
29
+ switch (field.type) {
30
+ case "boolean":
31
+ return "boolean";
32
+ case "number":
33
+ return "number";
34
+ case "json":
35
+ return "json";
36
+ case "relation":
37
+ return "relation";
38
+ case "datetime":
39
+ return /^date$/i.test(field.dbType ?? "") ? "date" : "datetime";
40
+ }
41
+ return "text";
42
+ }
43
+ var SAME_OR_IRREGULAR = {
44
+ series: "series",
45
+ species: "species",
46
+ movies: "movie",
47
+ cookies: "cookie",
48
+ ties: "tie",
49
+ pies: "pie",
50
+ people: "person"
51
+ };
52
+ function singular(word) {
53
+ const last = word.split(" ").pop();
54
+ const head = word.slice(0, word.length - last.length);
55
+ const lower = last.toLowerCase();
56
+ const one = (s) => head + s;
57
+ if (SAME_OR_IRREGULAR[lower]) return one(SAME_OR_IRREGULAR[lower]);
58
+ if (/[^aeiou]ies$/.test(lower)) return one(`${last.slice(0, -3)}y`);
59
+ if (/(?:s|x|z|ch|sh)es$/.test(lower)) return one(last.slice(0, -2));
60
+ if (/(?:ss|us|is)$/.test(lower) || !lower.endsWith("s")) return word;
61
+ return one(last.slice(0, -1));
62
+ }
63
+ var RESERVED_ACTIONS = /* @__PURE__ */ new Set(["create", "update", "delete"]);
64
+ var own = (record, key) => record && Object.hasOwn(record, key) ? record[key] : void 0;
65
+ function defineView(contract, definition = {}) {
66
+ const facts = contract;
67
+ const fields = contract.fields;
68
+ const byName = new Map(fields.map((f) => [f.name, f]));
69
+ const keys = new Set(keyFields(contract));
70
+ const scope = new Set(definition.scope ?? []);
71
+ const viewFields = Object.freeze(
72
+ Object.fromEntries(Object.entries(definition.fields ?? {}).map(([k, v]) => [k, Object.freeze({ ...v })]))
73
+ );
74
+ const columnLists = Object.freeze(
75
+ Object.fromEntries(
76
+ Object.entries(definition.columns ?? {}).map(([k, list]) => [
77
+ k,
78
+ Object.freeze((list ?? []).map((c) => typeof c === "string" ? c : Object.freeze({ ...c })))
79
+ ])
80
+ )
81
+ );
82
+ const formItems = Object.freeze(
83
+ (definition.form ?? []).map((item) => typeof item === "string" ? item : Object.freeze({ ...item, fields: Object.freeze([...item.fields]) }))
84
+ );
85
+ const presets = Object.freeze(
86
+ Object.fromEntries(
87
+ Object.entries(definition.presets ?? {}).map(([k, p]) => [k, Object.freeze({ ...p, ...p.filter ? { filter: Object.freeze({ ...p.filter }) } : {} })])
88
+ )
89
+ );
90
+ const actionList = Object.freeze(
91
+ (Array.isArray(definition.actions) ? definition.actions : []).map((a) => a && typeof a === "object" ? Object.freeze({ ...a }) : a)
92
+ );
93
+ const problems = [];
94
+ const known = (name, where) => {
95
+ if (!byName.has(name)) problems.push(`${where} names "${name}", which isn't a field`);
96
+ };
97
+ for (const name of Object.keys(viewFields)) known(name, "fields");
98
+ for (const [preset, list] of Object.entries(columnLists)) {
99
+ const seen = /* @__PURE__ */ new Set();
100
+ for (const column of list ?? []) {
101
+ const key = typeof column === "string" ? column : column.key;
102
+ if (typeof column === "string") known(column, `columns.${preset}`);
103
+ else if (byName.has(column.key)) problems.push(`columns.${preset}: computed "${column.key}" clashes with a field`);
104
+ if (seen.has(key)) problems.push(`columns.${preset} lists "${key}" twice`);
105
+ seen.add(key);
106
+ }
107
+ }
108
+ const formSeen = /* @__PURE__ */ new Set();
109
+ for (const item of formItems) {
110
+ for (const name of typeof item === "string" ? [item] : item.fields) {
111
+ known(name, "form");
112
+ if (formSeen.has(name)) problems.push(`form lists "${name}" twice`);
113
+ formSeen.add(name);
114
+ }
115
+ }
116
+ for (const name of scope) known(name, "scope");
117
+ if (definition.groupBy) known(definition.groupBy, "groupBy");
118
+ if (definition.orderBy) known(definition.orderBy.field, "orderBy");
119
+ for (const [name, preset] of Object.entries(presets)) {
120
+ if (preset.columns && preset.columns !== "default" && !own(columnLists, preset.columns)) {
121
+ problems.push(`presets.${name} uses columns "${preset.columns}", which isn't defined`);
122
+ }
123
+ for (const field of Object.keys(preset.filter ?? {})) known(field, `presets.${name}.filter`);
124
+ }
125
+ if (facts.labelField) known(facts.labelField, "the contract's labelField");
126
+ const actionSeen = /* @__PURE__ */ new Set();
127
+ if (definition.actions !== void 0 && !Array.isArray(definition.actions)) problems.push("actions isn't a list");
128
+ actionList.forEach((action, i) => {
129
+ const where = `actions[${i}]`;
130
+ if (!action || typeof action !== "object") {
131
+ problems.push(`${where} isn't an action`);
132
+ return;
133
+ }
134
+ if (typeof action.name !== "string" || !action.name.trim()) problems.push(`${where} has no name`);
135
+ else if (RESERVED_ACTIONS.has(action.name)) problems.push(`${where} is named "${action.name}", which is reserved for the view's own ${action.name}`);
136
+ else if (actionSeen.has(action.name)) problems.push(`actions lists "${action.name}" twice`);
137
+ else actionSeen.add(action.name);
138
+ if (typeof action.label !== "string" || !action.label.trim()) problems.push(`${where} has no label`);
139
+ if (action.confirm !== void 0 && typeof action.confirm !== "string") problems.push(`${where}.confirm isn't text`);
140
+ if (action.description !== void 0 && typeof action.description !== "string") {
141
+ problems.push(`${where}.description isn't text`);
142
+ }
143
+ if (action.can !== void 0 && typeof action.can !== "function") problems.push(`${where}.can isn't a function`);
144
+ });
145
+ if (problems.length) throw new ViewDefinitionError(contract.name, problems);
146
+ const copy = definition.copy ?? {};
147
+ const base = contract.name.split(".").pop() ?? contract.name;
148
+ const noun = copy.noun ?? facts.noun ?? singular(base.replace(/_/g, " "));
149
+ const nounPlural = copy.nounPlural ?? facts.nounPlural ?? (copy.noun || facts.noun ? `${noun}s` : base.replace(/_/g, " "));
150
+ const title = copy.title ?? facts.label ?? titleCase(nounPlural);
151
+ const labelField = facts.labelField ?? fields.find((f) => /^(name|title|label|full_name|display_name)$/.test(f.name))?.name;
152
+ const label = (name) => own(viewFields, name)?.label ?? byName.get(name)?.label ?? titleCase(name);
153
+ const display = (name) => {
154
+ const field = byName.get(name);
155
+ return own(viewFields, name)?.display ?? (field ? deriveDisplay(field) : "text");
156
+ };
157
+ const readable = (name) => byName.get(name)?.permissions?.read !== false;
158
+ const readOnly = (field) => Boolean(
159
+ field.generated || field.readOnly || field.references || field.permissions?.update === false || own(viewFields, field.name)?.readOnly
160
+ );
161
+ const quiet = (f) => keys.has(f.name) || scope.has(f.name) || Boolean(f.sensitive) || Boolean(f.references);
162
+ const defaultColumns = own(columnLists, "default") ?? fields.filter((f) => !quiet(f)).map((f) => f.name);
163
+ const presetNames = Object.freeze(["default", ...Object.keys(columnLists).filter((p) => p !== "default")]);
164
+ const resolvedColumns = /* @__PURE__ */ new Map();
165
+ const columns = (preset = "default") => {
166
+ const cached = resolvedColumns.get(preset);
167
+ if (cached) return cached;
168
+ const list = preset === "default" ? defaultColumns : own(columnLists, preset);
169
+ if (!list) throw new ViewDefinitionError(contract.name, [`no column preset "${preset}"`]);
170
+ const out = Object.freeze(
171
+ list.filter((column) => typeof column !== "string" || readable(column)).map((column) => {
172
+ if (typeof column !== "string") {
173
+ return Object.freeze({ key: column.key, label: column.label, display: column.display ?? "text", value: column.value });
174
+ }
175
+ const v = own(viewFields, column);
176
+ return Object.freeze({
177
+ key: column,
178
+ label: label(column),
179
+ display: display(column),
180
+ field: byName.get(column),
181
+ value: (row) => row[column],
182
+ ...v?.tones ? { tones: v.tones } : {},
183
+ ...v?.when ? { when: v.when } : {},
184
+ ...v?.timeZone ? { timeZone: v.timeZone } : {}
185
+ });
186
+ })
187
+ );
188
+ resolvedColumns.set(preset, out);
189
+ return out;
190
+ };
191
+ const placed = definition.form ? formItems.flatMap(
192
+ (item) => typeof item === "string" ? [{ name: item, section: null, sectionTitle: null }] : item.fields.map((name) => ({ name, section: item.section, sectionTitle: item.title ?? titleCase(item.section) }))
193
+ ) : fields.filter((f) => !readOnly(f) && (!quiet(f) || keys.has(f.name) && !f.hasDefault && !f.sensitive) && f.type !== "json" && !f.array).map((f) => ({ name: f.name, section: null, sectionTitle: null }));
194
+ const serverKey = (f, mode) => keys.has(f.name) && (mode === "edit" || Boolean(f.hasDefault));
195
+ const resolvedForms = /* @__PURE__ */ new Map();
196
+ const form = (mode) => {
197
+ const cached = resolvedForms.get(mode);
198
+ if (cached) return cached;
199
+ const out = Object.freeze(placed.filter(({ name }) => !scope.has(name) && readable(name) && !serverKey(byName.get(name), mode)).map(({ name, section, sectionTitle }) => {
200
+ const field = byName.get(name);
201
+ const v = own(viewFields, name);
202
+ const locked = readOnly(field);
203
+ return Object.freeze({
204
+ field,
205
+ label: label(name),
206
+ display: display(name),
207
+ required: !locked && !field.nullable && !field.optional && (mode === "edit" || !field.hasDefault),
208
+ readOnly: locked,
209
+ section,
210
+ sectionTitle,
211
+ ...v?.max !== void 0 ? { max: v.max } : {},
212
+ ...v?.visible ? { visible: v.visible } : {}
213
+ });
214
+ }));
215
+ resolvedForms.set(mode, out);
216
+ return out;
217
+ };
218
+ const writable = (mode) => Object.freeze(form(mode).filter((f) => !f.readOnly).map((f) => f.field.name));
219
+ const guards = definition.can ?? {};
220
+ function can(action, row) {
221
+ if (action === "create") return guards.create?.() ?? true;
222
+ const guard = guards[action];
223
+ return guard && row ? guard(row) : true;
224
+ }
225
+ const actionGuards = new Map(actionList.map((a) => [a.name, a.can]));
226
+ const resolvedActions = Object.freeze(
227
+ actionList.map(
228
+ (a) => Object.freeze({
229
+ name: a.name,
230
+ label: a.label,
231
+ ...a.confirm !== void 0 ? { confirm: a.confirm } : {},
232
+ ...a.description !== void 0 ? { description: a.description } : {}
233
+ })
234
+ )
235
+ );
236
+ function canAction(name, row) {
237
+ if (!actionGuards.has(name)) throw new ViewDefinitionError(contract.name, [`no action "${name}"`]);
238
+ return actionGuards.get(name)?.(row) ?? true;
239
+ }
240
+ const summary = (row) => {
241
+ if (definition.summary) return definition.summary(row);
242
+ const value = labelField ? row[labelField] : void 0;
243
+ return { title: value === null || value === void 0 || value === "" ? titleCase(noun) : String(value) };
244
+ };
245
+ return Object.freeze({
246
+ contract,
247
+ definition: Object.freeze({
248
+ ...definition,
249
+ fields: viewFields,
250
+ columns: columnLists,
251
+ presets,
252
+ ...definition.form ? { form: formItems } : {},
253
+ ...definition.scope ? { scope: Object.freeze([...definition.scope]) } : {},
254
+ ...definition.actions ? { actions: actionList } : {}
255
+ }),
256
+ resource: contract.name,
257
+ noun,
258
+ nounPlural,
259
+ title,
260
+ labelField,
261
+ presets: presetNames,
262
+ field: (name) => byName.get(name),
263
+ label,
264
+ display,
265
+ columns,
266
+ form,
267
+ writable,
268
+ can,
269
+ actions: () => resolvedActions,
270
+ canAction,
271
+ summary
272
+ });
273
+ }
274
+
275
+ // src/resource-view/picture.ts
276
+ var segmenter;
277
+ var LETTER = /^\p{L}/u;
278
+ function firstLetter(word) {
279
+ if (segmenter === void 0) {
280
+ segmenter = typeof Intl !== "undefined" && typeof Intl.Segmenter === "function" ? new Intl.Segmenter(void 0, { granularity: "grapheme" }) : null;
281
+ }
282
+ const parts = segmenter ? Array.from(segmenter.segment(word), (s) => s.segment) : Array.from(word);
283
+ return parts.find((part) => LETTER.test(part)) ?? "";
284
+ }
285
+ function initialsOf(name) {
286
+ const letters = (name ?? "").trim().split(/\s+/).map(firstLetter).filter(Boolean);
287
+ if (letters.length === 0) return "";
288
+ const pair = letters.length === 1 ? [letters[0]] : [letters[0], letters[letters.length - 1]];
289
+ return pair.map((l) => l.toUpperCase().length === l.length ? l.toUpperCase() : l).join("");
290
+ }
291
+ function rowPicture(summary) {
292
+ const image = summary.image;
293
+ if (!image) return null;
294
+ const initials = initialsOf(image.name);
295
+ if (isSafeUrl(image.src)) return { kind: "image", src: image.src.trim(), alt: image.alt ?? "", fallback: initials };
296
+ return initials ? { kind: "initials", text: initials } : null;
297
+ }
298
+
299
+ // src/resource-view/scope.ts
300
+ var camel = (key) => key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase());
301
+ function scopeValues(view, scope) {
302
+ const out = {};
303
+ const missing = [];
304
+ for (const key of view.definition.scope ?? []) {
305
+ const value = scope && Object.hasOwn(scope, key) ? scope[key] : scope?.[camel(key)];
306
+ if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") out[key] = value;
307
+ else missing.push(key);
308
+ }
309
+ if (missing.length && process.env.NODE_ENV !== "production") {
310
+ throw new ViewDefinitionError(
311
+ view.resource,
312
+ missing.map((key) => `scope "${key}" has no single value in ViewerScope's scope`)
313
+ );
314
+ }
315
+ return Object.freeze(out);
316
+ }
317
+
318
+ export { ViewDefinitionError, defineView, deriveDisplay, initialsOf, rowPicture, scopeValues };
319
+ //# sourceMappingURL=index.js.map
320
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/resource-view/define-view.ts","../../src/resource-view/picture.ts","../../src/resource-view/scope.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["// defineView: a contract plus what it means to people, checked once and frozen (the same rule as\n// genesis-sites' defineSection). Everything a renderer needs is resolved here, so web, native and\n// the extension draw the same labels, columns and form.\n\nimport { keyFields } from \"../schema/keys\";\nimport type { DataRow, FieldSchema, ResourceContract } from \"../schema/types\";\nimport { titleCase } from \"../utils\";\nimport type {\n Allowed,\n ComputedColumn,\n DisplayHint,\n ResolvedColumn,\n ResolvedFormField,\n ResolvedViewAction,\n ResourceView,\n RowOf,\n RowSummary,\n ViewDefinition,\n} from \"./types\";\n\n// Facts a contract may carry from `@genesis` comments. Read loosely so a contract emitted before\n// they existed still works.\ntype FieldFacts = FieldSchema & { readonly readOnly?: boolean; readonly sensitive?: boolean };\ntype ContractFacts = ResourceContract & {\n readonly label?: string;\n readonly labelField?: string;\n readonly noun?: string;\n readonly nounPlural?: string;\n};\n\n/** A view that names a field, preset or section its contract doesn't have. */\nexport class ViewDefinitionError extends Error {\n readonly problems: readonly string[];\n constructor(resource: string, problems: readonly string[]) {\n super(`defineView(${resource}): ${problems.join(\"; \")}`);\n this.name = \"ViewDefinitionError\";\n this.problems = problems;\n }\n}\n\n/** The display a field gets when the view doesn't name one. */\nexport function deriveDisplay(field: FieldSchema): DisplayHint {\n if (field.references) return \"relation\";\n switch (field.widget) {\n case \"url\":\n return \"url\";\n case \"email\":\n return \"email\";\n case \"image\":\n return \"image\";\n case \"textarea\":\n return \"longText\";\n case \"date\":\n return \"date\";\n }\n if (field.enumValues?.length) return \"badge\";\n switch (field.type) {\n case \"boolean\":\n return \"boolean\";\n case \"number\":\n return \"number\";\n case \"json\":\n return \"json\";\n case \"relation\":\n return \"relation\";\n case \"datetime\":\n return /^date$/i.test(field.dbType ?? \"\") ? \"date\" : \"datetime\";\n }\n return \"text\";\n}\n\n// Plurals whose singular the rules below would get wrong.\nconst SAME_OR_IRREGULAR: Readonly<Record<string, string>> = {\n series: \"series\",\n species: \"species\",\n movies: \"movie\",\n cookies: \"cookie\",\n ties: \"tie\",\n pies: \"pie\",\n people: \"person\",\n};\n\n/** A table name's singular, for the default noun. A wrong guess is fixed with `@genesis {\"noun\"}`. */\nexport function singular(word: string): string {\n const last = word.split(\" \").pop()!;\n const head = word.slice(0, word.length - last.length);\n const lower = last.toLowerCase();\n const one = (s: string) => head + s;\n if (SAME_OR_IRREGULAR[lower]) return one(SAME_OR_IRREGULAR[lower]!);\n if (/[^aeiou]ies$/.test(lower)) return one(`${last.slice(0, -3)}y`);\n // statuses, addresses, boxes, matches, wishes, quizzes\n if (/(?:s|x|z|ch|sh)es$/.test(lower)) return one(last.slice(0, -2));\n if (/(?:ss|us|is)$/.test(lower) || !lower.endsWith(\"s\")) return word;\n return one(last.slice(0, -1));\n}\n\n// The view's own operations (`view.can`): an action can't take their names.\nconst RESERVED_ACTIONS: ReadonlySet<string> = new Set([\"create\", \"update\", \"delete\"]);\n\nconst own = <V>(record: Readonly<Record<string, V>> | undefined, key: string): V | undefined =>\n record && Object.hasOwn(record, key) ? record[key] : undefined;\n\n/**\n * Describe what a resource means to people. The result is frozen and platform-neutral:\n *\n * ```ts\n * export const brandsView = defineView(contracts[\"public.brands\"], {\n * fields: { status: { display: \"badge\", tones: { active: \"success\" } } },\n * columns: { default: [\"name\", \"status\", \"created_at\"], compact: [\"name\"] },\n * can: { delete: (row) => (row.is_default ? \"The default brand stays.\" : true) },\n * actions: [{ name: \"archive\", label: \"Archive\", can: (row) => (row.is_default ? \"The default brand stays.\" : true) }],\n * });\n * ```\n *\n * Throws {@link ViewDefinitionError} when it names something the contract doesn't have, so a\n * renamed column fails at start-up, not as a blank cell.\n */\nexport function defineView<C extends ResourceContract, Row extends DataRow = RowOf<C>>(\n contract: C,\n definition: ViewDefinition<C, Row> = {},\n): ResourceView<C, Row> {\n const facts = contract as ContractFacts;\n const fields = contract.fields as readonly FieldFacts[];\n const byName = new Map(fields.map((f) => [f.name, f]));\n const keys = new Set(keyFields(contract));\n const scope = new Set<string>(definition.scope ?? []);\n // Copied and frozen, so changing the objects passed in can't change the view afterwards.\n const viewFields = Object.freeze(\n Object.fromEntries(Object.entries(definition.fields ?? {}).map(([k, v]) => [k, Object.freeze({ ...(v as object) })])),\n ) as Readonly<Record<string, NonNullable<ViewDefinition<C, Row>[\"fields\"]>[never]>>;\n const columnLists = Object.freeze(\n Object.fromEntries(\n Object.entries(definition.columns ?? {}).map(([k, list]) => [\n k,\n Object.freeze((list ?? []).map((c) => (typeof c === \"string\" ? c : Object.freeze({ ...c })))),\n ]),\n ),\n ) as Readonly<Record<string, readonly (string | ComputedColumn<Row>)[] | undefined>>;\n const formItems = Object.freeze(\n (definition.form ?? []).map((item) => (typeof item === \"string\" ? item : Object.freeze({ ...item, fields: Object.freeze([...item.fields]) }))),\n );\n const presets = Object.freeze(\n Object.fromEntries(\n Object.entries(definition.presets ?? {}).map(([k, p]) => [k, Object.freeze({ ...p, ...(p.filter ? { filter: Object.freeze({ ...p.filter }) } : {}) })]),\n ),\n ) as NonNullable<ViewDefinition<C, Row>[\"presets\"]>;\n const actionList = Object.freeze(\n (Array.isArray(definition.actions) ? definition.actions : []).map((a) => (a && typeof a === \"object\" ? Object.freeze({ ...a }) : a)),\n );\n\n // ── Check every name once ────────────────────────────────────────────\n const problems: string[] = [];\n const known = (name: string, where: string) => {\n if (!byName.has(name)) problems.push(`${where} names \"${name}\", which isn't a field`);\n };\n for (const name of Object.keys(viewFields)) known(name, \"fields\");\n for (const [preset, list] of Object.entries(columnLists)) {\n const seen = new Set<string>();\n for (const column of list ?? []) {\n const key = typeof column === \"string\" ? column : column.key;\n if (typeof column === \"string\") known(column, `columns.${preset}`);\n else if (byName.has(column.key)) problems.push(`columns.${preset}: computed \"${column.key}\" clashes with a field`);\n if (seen.has(key)) problems.push(`columns.${preset} lists \"${key}\" twice`);\n seen.add(key);\n }\n }\n const formSeen = new Set<string>();\n for (const item of formItems) {\n for (const name of typeof item === \"string\" ? [item] : item.fields) {\n known(name, \"form\");\n if (formSeen.has(name)) problems.push(`form lists \"${name}\" twice`);\n formSeen.add(name);\n }\n }\n for (const name of scope) known(name, \"scope\");\n if (definition.groupBy) known(definition.groupBy, \"groupBy\");\n if (definition.orderBy) known(definition.orderBy.field, \"orderBy\");\n for (const [name, preset] of Object.entries(presets)) {\n if (preset.columns && preset.columns !== \"default\" && !own(columnLists, preset.columns)) {\n problems.push(`presets.${name} uses columns \"${preset.columns}\", which isn't defined`);\n }\n for (const field of Object.keys(preset.filter ?? {})) known(field, `presets.${name}.filter`);\n }\n if (facts.labelField) known(facts.labelField, \"the contract's labelField\");\n const actionSeen = new Set<string>();\n if (definition.actions !== undefined && !Array.isArray(definition.actions)) problems.push(\"actions isn't a list\");\n actionList.forEach((action, i) => {\n const where = `actions[${i}]`;\n if (!action || typeof action !== \"object\") {\n problems.push(`${where} isn't an action`);\n return;\n }\n if (typeof action.name !== \"string\" || !action.name.trim()) problems.push(`${where} has no name`);\n else if (RESERVED_ACTIONS.has(action.name)) problems.push(`${where} is named \"${action.name}\", which is reserved for the view's own ${action.name}`);\n else if (actionSeen.has(action.name)) problems.push(`actions lists \"${action.name}\" twice`);\n else actionSeen.add(action.name);\n if (typeof action.label !== \"string\" || !action.label.trim()) problems.push(`${where} has no label`);\n if (action.confirm !== undefined && typeof action.confirm !== \"string\") problems.push(`${where}.confirm isn't text`);\n if (action.description !== undefined && typeof action.description !== \"string\") {\n problems.push(`${where}.description isn't text`);\n }\n if (action.can !== undefined && typeof action.can !== \"function\") problems.push(`${where}.can isn't a function`);\n });\n if (problems.length) throw new ViewDefinitionError(contract.name, problems);\n\n // ── Words ────────────────────────────────────────────────────────────\n const copy = definition.copy ?? {};\n const base = contract.name.split(\".\").pop() ?? contract.name;\n const noun = copy.noun ?? facts.noun ?? singular(base.replace(/_/g, \" \"));\n const nounPlural = copy.nounPlural ?? facts.nounPlural ?? (copy.noun || facts.noun ? `${noun}s` : base.replace(/_/g, \" \"));\n const title = copy.title ?? facts.label ?? titleCase(nounPlural);\n const labelField = facts.labelField ?? fields.find((f) => /^(name|title|label|full_name|display_name)$/.test(f.name))?.name;\n\n const label = (name: string): string => own(viewFields, name)?.label ?? byName.get(name)?.label ?? titleCase(name);\n const display = (name: string): DisplayHint => {\n const field = byName.get(name);\n return own(viewFields, name)?.display ?? (field ? deriveDisplay(field) : \"text\");\n };\n // A field the provider says this user can't read is left out everywhere, even when listed.\n const readable = (name: string) => byName.get(name)?.permissions?.read !== false;\n // A link stays read-only until there's a picker, so no one sends a hand-typed id. A screen\n // fills a required one on create (its `filter`).\n const readOnly = (field: FieldFacts) =>\n Boolean(\n field.generated ||\n field.readOnly ||\n field.references ||\n field.permissions?.update === false ||\n own(viewFields, field.name)?.readOnly,\n );\n // Left out of defaults (a view still lists them on purpose): the key, scope (tenant) columns,\n // sensitive values, and links, which need a picker rather than a raw id.\n const quiet = (f: FieldFacts) => keys.has(f.name) || scope.has(f.name) || Boolean(f.sensitive) || Boolean(f.references);\n\n // ── Columns ──────────────────────────────────────────────────────────\n const defaultColumns: readonly (string | ComputedColumn<Row>)[] =\n own(columnLists, \"default\") ?? fields.filter((f) => !quiet(f)).map((f) => f.name);\n const presetNames = Object.freeze([\"default\", ...Object.keys(columnLists).filter((p) => p !== \"default\")]);\n const resolvedColumns = new Map<string, readonly ResolvedColumn<Row>[]>();\n const columns = (preset = \"default\"): readonly ResolvedColumn<Row>[] => {\n const cached = resolvedColumns.get(preset);\n if (cached) return cached;\n const list = preset === \"default\" ? defaultColumns : own(columnLists, preset);\n if (!list) throw new ViewDefinitionError(contract.name, [`no column preset \"${preset}\"`]);\n const out = Object.freeze(\n list.filter((column) => typeof column !== \"string\" || readable(column)).map((column): ResolvedColumn<Row> => {\n if (typeof column !== \"string\") {\n return Object.freeze({ key: column.key, label: column.label, display: column.display ?? \"text\", value: column.value });\n }\n const v = own(viewFields, column);\n return Object.freeze({\n key: column,\n label: label(column),\n display: display(column),\n field: byName.get(column)!,\n value: (row: Row) => row[column],\n ...(v?.tones ? { tones: v.tones } : {}),\n ...(v?.when ? { when: v.when } : {}),\n ...(v?.timeZone ? { timeZone: v.timeZone } : {}),\n });\n }),\n );\n resolvedColumns.set(preset, out);\n return out;\n };\n\n // ── Form ─────────────────────────────────────────────────────────────\n type Placed = { name: string; section: string | null; sectionTitle: string | null };\n const placed: readonly Placed[] = definition.form\n ? formItems.flatMap((item): Placed[] =>\n typeof item === \"string\"\n ? [{ name: item, section: null, sectionTitle: null }]\n : item.fields.map((name) => ({ name, section: item.section, sectionTitle: item.title ?? titleCase(item.section) })),\n )\n : fields\n // JSON needs an editor of its own, so it is never in a derived form.\n // A key the person types (a code, a slug) stays; one the server fills doesn't.\n .filter((f) => !readOnly(f) && (!quiet(f) || (keys.has(f.name) && !f.hasDefault && !f.sensitive)) && f.type !== \"json\" && !f.array)\n .map((f): Placed => ({ name: f.name, section: null, sectionTitle: null }));\n // A key the server fills (a default) is never sent on create; no key is sent on edit.\n const serverKey = (f: FieldFacts, mode: \"create\" | \"edit\") => keys.has(f.name) && (mode === \"edit\" || Boolean(f.hasDefault));\n const resolvedForms = new Map<string, readonly ResolvedFormField[]>();\n const form = (mode: \"create\" | \"edit\"): readonly ResolvedFormField[] => {\n const cached = resolvedForms.get(mode);\n if (cached) return cached;\n const out = Object.freeze(placed\n .filter(({ name }) => !scope.has(name) && readable(name) && !serverKey(byName.get(name)!, mode))\n .map(({ name, section, sectionTitle }) => {\n const field = byName.get(name)!;\n const v = own(viewFields, name);\n const locked = readOnly(field);\n return Object.freeze({\n field,\n label: label(name),\n display: display(name),\n required: !locked && !field.nullable && !field.optional && (mode === \"edit\" || !field.hasDefault),\n readOnly: locked,\n section,\n sectionTitle,\n ...(v?.max !== undefined ? { max: v.max } : {}),\n ...(v?.visible ? { visible: v.visible } : {}),\n });\n }));\n resolvedForms.set(mode, out);\n return out;\n };\n const writable = (mode: \"create\" | \"edit\") => Object.freeze(form(mode).filter((f) => !f.readOnly).map((f) => f.field.name));\n\n // ── Guards and summary ───────────────────────────────────────────────\n const guards = definition.can ?? {};\n function can(action: \"create\" | \"update\" | \"delete\", row?: Row): Allowed {\n if (action === \"create\") return guards.create?.() ?? true;\n const guard = guards[action];\n return guard && row ? guard(row) : true;\n }\n const actionGuards = new Map(actionList.map((a) => [a.name, a.can]));\n const resolvedActions: readonly ResolvedViewAction[] = Object.freeze(\n actionList.map((a) =>\n Object.freeze({\n name: a.name,\n label: a.label,\n ...(a.confirm !== undefined ? { confirm: a.confirm } : {}),\n ...(a.description !== undefined ? { description: a.description } : {}),\n }),\n ),\n );\n function canAction(name: string, row: Row): Allowed {\n if (!actionGuards.has(name)) throw new ViewDefinitionError(contract.name, [`no action \"${name}\"`]);\n return actionGuards.get(name)?.(row) ?? true;\n }\n const summary = (row: Row): RowSummary => {\n if (definition.summary) return definition.summary(row);\n const value = labelField ? row[labelField] : undefined;\n return { title: value === null || value === undefined || value === \"\" ? titleCase(noun) : String(value) };\n };\n\n return Object.freeze({\n contract,\n definition: Object.freeze({\n ...definition,\n fields: viewFields,\n columns: columnLists,\n presets,\n ...(definition.form ? { form: formItems } : {}),\n ...(definition.scope ? { scope: Object.freeze([...definition.scope]) } : {}),\n ...(definition.actions ? { actions: actionList } : {}),\n }) as Readonly<ViewDefinition<C, Row>>,\n resource: contract.name,\n noun,\n nounPlural,\n title,\n labelField,\n presets: presetNames,\n field: (name: string) => byName.get(name),\n label,\n display,\n columns,\n form,\n writable,\n can: can as ResourceView<C, Row>[\"can\"],\n actions: () => resolvedActions,\n canAction,\n summary,\n });\n}\n","// rowPicture: what to draw for a row's picture (docs/RESOURCE-VIEW.md, \"summary\"). Pure, so web,\n// native and the extension draw the same image or initials, behind the same URL check.\n\nimport { isSafeUrl } from \"../urls\";\nimport type { RowPicture, RowSummary } from \"./types\";\n\nlet segmenter: Intl.Segmenter | null | undefined;\n\n// The first letter of a word, as a whole character: \"é\" keeps its accent, \"李\" is a letter, and\n// punctuation, digits and emoji never count.\nconst LETTER = /^\\p{L}/u;\nfunction firstLetter(word: string): string {\n if (segmenter === undefined) {\n segmenter = typeof Intl !== \"undefined\" && typeof Intl.Segmenter === \"function\" ? new Intl.Segmenter(undefined, { granularity: \"grapheme\" }) : null;\n }\n const parts = segmenter ? Array.from(segmenter.segment(word), (s) => s.segment) : Array.from(word);\n return parts.find((part) => LETTER.test(part)) ?? \"\";\n}\n\n/**\n * First and last initial of a name, from letters only: \"Ada Lovelace\" → \"AL\", \"Ana-María López\"\n * → \"AL\", \"李 小龙\" → \"李小\", \"Cher\" → \"C\". Empty when the name has no letters (\" \", \"🎉🎉\").\n */\nexport function initialsOf(name: string | undefined): string {\n const letters = (name ?? \"\").trim().split(/\\s+/).map(firstLetter).filter(Boolean);\n if (letters.length === 0) return \"\";\n const pair = letters.length === 1 ? [letters[0]!] : [letters[0]!, letters[letters.length - 1]!];\n // One character each: \"ß\" stays \"ß\" rather than becoming \"SS\".\n return pair.map((l) => (l.toUpperCase().length === l.length ? l.toUpperCase() : l)).join(\"\");\n}\n\n/**\n * What to draw for a summary's picture:\n *\n * ```ts\n * rowPicture({ title: \"Ada\", image: { src: \"https://…/ada.png\", name: \"Ada Lovelace\" } });\n * // { kind: \"image\", src: \"https://…/ada.png\", alt: \"\", fallback: \"AL\" }\n * rowPicture({ title: \"Ada\", image: { src: \"javascript:x\", name: \"Ada Lovelace\" } });\n * // { kind: \"initials\", text: \"AL\" }\n * ```\n *\n * `null` when the summary has no `image`, or neither a safe `src` nor a `name` with letters.\n */\nexport function rowPicture(summary: RowSummary): RowPicture | null {\n const image = summary.image;\n if (!image) return null;\n const initials = initialsOf(image.name);\n if (isSafeUrl(image.src)) return { kind: \"image\", src: image.src.trim(), alt: image.alt ?? \"\", fallback: initials };\n return initials ? { kind: \"initials\", text: initials } : null;\n}\n","// scopeValues: a view's scope keys, read from ViewerScope's `scope`, as a screen's `filter`.\n\nimport type { ResourceScope } from \"../hooks/viewer-scope\";\nimport { ViewDefinitionError } from \"./define-view\";\nimport type { ResourceView } from \"./types\";\n\ntype ScopeValue = string | number | boolean | null;\n\nconst camel = (key: string) => key.replace(/_([a-z0-9])/g, (_, c: string) => c.toUpperCase());\n\n/**\n * The view's declared scope keys with their values from the viewer's scope, ready to pass as a\n * screen's `filter`: `scope: [\"practice_id\"]` reads `scope.practice_id`, then `scope.practiceId`.\n *\n * ```tsx\n * <ResourceView view={brandsView} filter={scopeValues(brandsView, useViewerScope().scope)} />\n * ```\n *\n * In development a declared key with no single value (missing, `undefined`, or a list) throws\n * {@link ViewDefinitionError}, so a screen mounted outside its scope fails loudly. In production\n * it is left out; row-level security still decides what the viewer reads.\n */\nexport function scopeValues(\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- any contract\n view: Pick<ResourceView<any, any>, \"resource\" | \"definition\">,\n scope: ResourceScope | null | undefined,\n): Readonly<Record<string, ScopeValue>> {\n const out: Record<string, ScopeValue> = {};\n const missing: string[] = [];\n for (const key of (view.definition.scope ?? []) as readonly string[]) {\n const value = scope && Object.hasOwn(scope, key) ? scope[key] : scope?.[camel(key)];\n if (value === null || typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") out[key] = value;\n else missing.push(key);\n }\n if (missing.length && process.env.NODE_ENV !== \"production\") {\n throw new ViewDefinitionError(\n view.resource,\n missing.map((key) => `scope \"${key}\" has no single value in ViewerScope's scope`),\n );\n }\n return Object.freeze(out);\n}\n"]}
@@ -1,7 +1,7 @@
1
- import { e as ResourceContract, D as DataRow } from '../types-C7FJtFXV.js';
2
- export { A as AuditEntry, F as FieldPermissions, a as FieldReference, b as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, S as StorageType, V as VersionField } from '../types-C7FJtFXV.js';
3
- import { a as Identifier } from '../types-B9DDfvWa.js';
4
- export { D as DataWriteError, a as DataWriteErrorOptions, W as WriteOutcome, i as isDataWriteError } from '../write-outcome-B2fE29yZ.js';
1
+ import { e as ResourceContract, D as DataRow } from '../types-o8j7g6O6.js';
2
+ export { A as AuditEntry, a as FieldPermissions, b as FieldReference, F as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, j as RowOf, S as StorageType, V as VersionField, k as defineResource } from '../types-o8j7g6O6.js';
3
+ import { a as Identifier } from '../types-CXhqXPN1.js';
4
+ export { D as DataWriteError, a as DataWriteErrorOptions, W as WriteOutcome, i as isDataWriteError } from '../write-outcome-CFnpciUI.js';
5
5
  export { D as DataReadError, a as DataReadErrorOptions, R as ReadOutcome, i as isDataReadError, r as readFailureMessage } from '../read-outcome-BnboMYOV.js';
6
6
  export { FieldType as WidgetHint } from '../form-types.js';
7
7
 
@@ -1,3 +1,4 @@
1
+ export { defineResource } from '../chunk-7FVTGKTX.js';
1
2
  export { decodeRecordKey, encodeRecordKey, keyFields } from '../chunk-KV2HW4G4.js';
2
3
  export { DataReadError, isDataReadError, readFailureMessage } from '../chunk-HUNGCTRA.js';
3
4
  export { DataWriteError, isDataWriteError } from '../chunk-LG6TUBVM.js';
@@ -1,6 +1,6 @@
1
- import { D as DataProvider, a as Identifier } from '../types-B9DDfvWa.js';
2
- import { D as DataWriteError } from '../write-outcome-B2fE29yZ.js';
3
- import '../types-C7FJtFXV.js';
1
+ import { D as DataProvider, a as Identifier } from '../types-CXhqXPN1.js';
2
+ import { D as DataWriteError } from '../write-outcome-CFnpciUI.js';
3
+ import '../types-o8j7g6O6.js';
4
4
  import '../form-types.js';
5
5
 
6
6
  /** The shared fixture logins, the same ids `genesis_testing.user_id()` uses. */
@@ -1,4 +1,4 @@
1
- import { A as AuditEntry, g as ResourceSchema, h as ResourceSummary, P as ProviderCapabilities, R as RecordComment } from './types-C7FJtFXV.js';
1
+ import { A as AuditEntry, g as ResourceSchema, h as ResourceSummary, P as ProviderCapabilities, R as RecordComment } from './types-o8j7g6O6.js';
2
2
 
3
3
  /** Record identifier — supports both string UUIDs and numeric auto-increment IDs. */
4
4
  type Identifier = string | number;
@@ -55,6 +55,12 @@ interface NullFilter {
55
55
  operator: "is_null" | "is_not_null";
56
56
  }
57
57
  type FilterParam = ScalarFilter | ArrayFilter | RangeFilter | NullFilter;
58
+ /**
59
+ * How a list's total is counted: `exact` counts every matching row (slow on
60
+ * large tables), `estimated` and `planned` ask the database's statistics
61
+ * (fast, approximate), `none` skips the count (`total` is -1).
62
+ */
63
+ type CountMode = "exact" | "estimated" | "planned" | "none";
58
64
  /** Parameters for `getList`. */
59
65
  interface ListParams {
60
66
  pagination?: PaginationParam;
@@ -72,20 +78,31 @@ interface ListParams {
72
78
  query: string;
73
79
  fields: string[];
74
80
  };
81
+ /** How to count `total`; wins over the resource's own setting. Providers that can't choose count exactly. */
82
+ count?: CountMode;
75
83
  }
76
84
  /** Result of `getList`. */
77
85
  interface ListResult<T> {
78
86
  data: T[];
79
87
  /**
80
- * Rows matching the filters and search. In cursor mode a provider may
81
- * count only on the first page (`cursor: null`) and return `-1` after it.
88
+ * Rows matching the filters and search. `-1` means not counted: in cursor
89
+ * mode after the first page, or with `count: "none"`. A pager must treat -1
90
+ * as unknown (no last page number) and stop on a short page instead.
82
91
  */
83
92
  total: number;
93
+ /** True when `total` is the database's estimate (`estimated` or `planned`), so a screen says "about". */
94
+ totalIsEstimate?: boolean;
84
95
  /**
85
96
  * Cursor mode only: the cursor for the next page, or `null` when this is
86
97
  * the last one. Absent when the provider paged by offset.
87
98
  */
88
99
  nextCursor?: string | null;
100
+ /**
101
+ * Cursor mode only: the cursor for the page before this one, or `null` on
102
+ * the first page. Lets an infinite list drop pages from the front (TanStack
103
+ * Query's `maxPages`) and load them again when scrolled back.
104
+ */
105
+ prevCursor?: string | null;
89
106
  }
90
107
  /** Parameters for `getOne`. */
91
108
  interface GetOneParams {
@@ -347,4 +364,4 @@ interface DataProvider {
347
364
  invalidates?(event: WriteEvent): InvalidationKey[];
348
365
  }
349
366
 
350
- export type { ArrayFilter as A, BaseRecord as B, CreateParams as C, DataProvider as D, FilterParam as F, GetManyParams as G, HistoryParams as H, InvalidationKey as I, ListParams as L, NullFilter as N, PaginationParam as P, RangeFilter as R, ScalarFilter as S, UpdateParams as U, WriteEvent as W, Identifier as a, BulkChange as b, BulkResult as c, CreateResult as d, DeleteParams as e, DeleteResult as f, GetManyResult as g, GetOneParams as h, GetOneResult as i, ImportParams as j, ListResult as k, ResourceChangeEvent as l, RowFailure as m, SortParam as n, SubscribeParams as o, UpdateResult as p };
367
+ export type { ArrayFilter as A, BaseRecord as B, CountMode as C, DataProvider as D, FilterParam as F, GetManyParams as G, HistoryParams as H, InvalidationKey as I, ListParams as L, NullFilter as N, PaginationParam as P, RangeFilter as R, SortParam as S, UpdateParams as U, WriteEvent as W, Identifier as a, BulkChange as b, BulkResult as c, CreateParams as d, CreateResult as e, DeleteParams as f, DeleteResult as g, GetManyResult as h, GetOneParams as i, GetOneResult as j, ImportParams as k, ListResult as l, ResourceChangeEvent as m, RowFailure as n, ScalarFilter as o, SubscribeParams as p, UpdateResult as q };
@@ -65,6 +65,17 @@ interface FieldSchema {
65
65
  readonly references?: FieldReference;
66
66
  /** The current user's rights on this field, when a provider reports them. */
67
67
  readonly permissions?: FieldPermissions;
68
+ /**
69
+ * The server owns this field (a status it derives, a total, an audit stamp): clients never write
70
+ * it, so a UI shows it read-only. Declared once (`@genesis {"readonly": true}`); the database's
71
+ * own guards still enforce it.
72
+ */
73
+ readonly readOnly?: boolean;
74
+ /**
75
+ * The value is sensitive (a note for staff, a health detail): a UI leaves it out of lists, exports
76
+ * and previews unless a screen asks for it. Hiding it from a user is the database's job.
77
+ */
78
+ readonly sensitive?: boolean;
68
79
  }
69
80
  /**
70
81
  * One declaration of a resource: its fields and its identity.
@@ -89,9 +100,35 @@ interface ResourceContract<Row extends DataRow = DataRow> {
89
100
  readonly fields: readonly FieldSchema[];
90
101
  /** Optional doc string. */
91
102
  readonly description?: string;
103
+ /** Human label, e.g. "Clients". */
104
+ readonly label?: string;
105
+ /** The field that best names a row to a person (a name or title), for links and pickers. */
106
+ readonly labelField?: string;
107
+ /** What one row is called in sentences ("brand"), and several ("brands") when not `noun` + "s". */
108
+ readonly noun?: string;
109
+ readonly nounPlural?: string;
92
110
  /** Phantom marker so `Row` is inferable from a contract. */
93
111
  readonly __row?: Row;
94
112
  }
113
+ /** The row type a contract describes (its phantom `__row`), or `DataRow` when it carries none. */
114
+ type RowOf<C> = C extends {
115
+ readonly __row?: infer R;
116
+ } ? (unknown extends R ? DataRow : NonNullable<R>) : DataRow;
117
+ /**
118
+ * Declares a resource contract for a row type, keeping the literal contract (field names, key,
119
+ * labelField) and attaching the row type so views can read it with `RowOf`. `labelField` must be
120
+ * one of the row's fields.
121
+ *
122
+ * ```ts
123
+ * export const publicBrands = defineResource<PublicBrandsRow>()({ name: "public.brands", key: "id", fields: [...] });
124
+ * type Row = RowOf<typeof publicBrands>; // PublicBrandsRow
125
+ * ```
126
+ */
127
+ declare function defineResource<Row extends DataRow>(): <const C extends ResourceContract<Row> & {
128
+ readonly labelField?: keyof Row & string;
129
+ }>(contract: C) => C & {
130
+ readonly __row?: Row;
131
+ };
95
132
  /** What the current user may do with a whole resource. */
96
133
  interface ResourceAccess {
97
134
  readonly read: boolean;
@@ -291,4 +328,4 @@ interface AuditEntry {
291
328
  readonly after: DataRow | null;
292
329
  }
293
330
 
294
- export type { AuditEntry as A, DataRow as D, FieldPermissions as F, ProviderCapabilities as P, RecordComment as R, StorageType as S, VersionField as V, FieldReference as a, FieldSchema as b, FilterOperator as c, ResourceAccess as d, ResourceContract as e, ResourceRelation as f, ResourceSchema as g, ResourceSummary as h, RowAction as i };
331
+ export { type AuditEntry as A, type DataRow as D, type FieldSchema as F, type ProviderCapabilities as P, type RecordComment as R, type StorageType as S, type VersionField as V, type FieldPermissions as a, type FieldReference as b, type FilterOperator as c, type ResourceAccess as d, type ResourceContract as e, type ResourceRelation as f, type ResourceSchema as g, type ResourceSummary as h, type RowAction as i, type RowOf as j, defineResource as k };
package/dist/urls.d.ts ADDED
@@ -0,0 +1,18 @@
1
+ /**
2
+ * True when `url` is safe to put in an `href`: an absolute http(s), mailto or
3
+ * tel URL, a root-relative path (`/lessons/1`) or a fragment (`#notes`).
4
+ *
5
+ * Rejects `javascript:`, `data:`, `vbscript:` and every other scheme, as well
6
+ * as protocol-relative `//host` URLs and anything containing whitespace or
7
+ * control characters (browsers strip those, which is how `java\tscript:`
8
+ * slips past naive checks).
9
+ */
10
+ declare function isSafeUrl(url: unknown): url is string;
11
+ /**
12
+ * Turn what a person typed into the link field into a safe href, or `null`.
13
+ * `example.com/page` becomes `https://example.com/page`; an email address
14
+ * becomes a `mailto:` link.
15
+ */
16
+ declare function normalizeLinkUrl(input: string): string | null;
17
+
18
+ export { isSafeUrl, normalizeLinkUrl };
package/dist/urls.js ADDED
@@ -0,0 +1,3 @@
1
+ export { isSafeUrl, normalizeLinkUrl } from './chunk-YDDPFSQ6.js';
2
+ //# sourceMappingURL=urls.js.map
3
+ //# sourceMappingURL=urls.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"urls.js"}