@declarion/react 0.32.0 → 0.34.0

package/dist-lib/testing.js

@@ -1,4 +1,4 @@
-import { Nn as e, dt as t, lt as n, mt as r, nt as i, t as a, ut as o } from "./ActionRunner-CaSrGpBi.js";
+import { In as e, _t as t, at as n, ft as r, mt as i, pt as a, t as o } from "./ActionRunner-UGGvGypS.js";
 import { useState as s } from "react";
 import { MemoryRouter as c } from "react-router-dom";
 import { QueryClient as l, QueryClientProvider as u } from "@tanstack/react-query";
@@ -59,7 +59,7 @@ function x() {
 		code: "test",
 		name: "Test",
 		role: "admin"
-	}, t = {
+	}, n = {
 		id: "test-user",
 		email: "test@example.com",
 		display_name: "Test User",
@@ -70,7 +70,7 @@ function x() {
 		created_at: "2026-01-01T00:00:00Z",
 		updated_at: "2026-01-01T00:00:00Z"
 	};
-	r.getState().setUser(t, e);
+	t.getState().setUser(n, e);
 }
 function S(e) {
 	if (e === void 0) return { rows: [] };
@@ -86,10 +86,10 @@ function S(e) {
 	return e;
 }
 function C(e) {
-	let r = e.entityData ?? {};
-	t((e, t) => {
-		let n = r[e], i = S(n), a = i.meta?.per_page ?? 50, o = i.meta?.total ?? i.rows.length;
-		return t.count === "only" ? {
+	let t = e.entityData ?? {};
+	i((e, n) => {
+		let r = t[e], i = S(r), a = i.meta?.per_page ?? 50, o = i.meta?.total ?? i.rows.length;
+		return n.count === "only" ? {
 			data: [],
 			meta: {
 				page: 1,
@@ -108,24 +108,24 @@ function C(e) {
 			...i.refs === void 0 ? {} : { $refs: i.refs }
 		};
 	});
-	let a = e.entityItems ?? {}, s = e.entityItemResponses ?? {};
-	o((e, t) => {
-		let n = typeof t == "string" ? t : i(t), r = s[e]?.[n];
-		if (r instanceof Error) throw r;
-		if (r !== void 0) return r;
-		let o = a[e]?.[n];
-		if (o instanceof Error) throw o;
-		return { data: o };
+	let o = e.entityItems ?? {}, s = e.entityItemResponses ?? {};
+	a((e, t) => {
+		let r = typeof t == "string" ? t : n(t), i = s[e]?.[r];
+		if (i instanceof Error) throw i;
+		if (i !== void 0) return i;
+		let a = o[e]?.[r];
+		if (a instanceof Error) throw a;
+		return { data: a };
 	});
 	let c = e.actionResults ?? {};
-	n(async (e, t) => {
+	r(async (e, t) => {
 		if (!(e in c)) throw Error(`renderWithDeclarion: no action result registered for "${e}" (seed it via actionResults)`);
 		let n = c[e];
 		return b(typeof n == "function" ? await n(t) : n);
 	});
 }
 function w() {
-	t(null), o(null), n(null), r.setState({
+	i(null), a(null), r(null), t.setState({
 		user: null,
 		isAuthenticated: !1,
 		activeTenant: null,
@@ -142,32 +142,32 @@ function T(t, n = {}) {
 		client: r,
 		children: [/* @__PURE__ */ f(c, {
 			initialEntries: [n.route ?? "/"],
-			children: /* @__PURE__ */ f(a, { children: t })
+			children: /* @__PURE__ */ f(o, { children: t })
 		}), /* @__PURE__ */ f(d, {})]
-	}), o = m(n.viewport ? /* @__PURE__ */ f(e, {
+	}), a = m(n.viewport ? /* @__PURE__ */ f(e, {
 		viewportOverride: n.viewport,
 		children: i
 	}) : i);
-	return Object.assign(o, { queryClient: r });
+	return Object.assign(a, { queryClient: r });
 }
-function E({ children: e, authenticated: t = !0, ...n }) {
+function E({ children: e, authenticated: n = !0, ...r }) {
 	let [i] = s(() => {
 		let e = new l({ defaultOptions: { queries: {
 			retry: !1,
 			gcTime: Infinity
 		} } });
-		return t ? (x(), e.setQueryData(["schema", !0], n.schema ?? h())) : r.setState({
+		return n ? (x(), e.setQueryData(["schema", !0], r.schema ?? h())) : t.setState({
 			user: null,
 			isAuthenticated: !1,
 			activeTenant: null,
 			tenants: []
-		}), C(n), e;
+		}), C(r), e;
 	});
 	return /* @__PURE__ */ p(u, {
 		client: i,
 		children: [/* @__PURE__ */ f(c, {
-			initialEntries: [n.route ?? "/"],
-			children: /* @__PURE__ */ f(a, { children: e })
+			initialEntries: [r.route ?? "/"],
+			children: /* @__PURE__ */ f(o, { children: e })
 		}), /* @__PURE__ */ f(d, {})]
 	});
 }

package/dist-lib/types/api.d.ts

@@ -182,6 +182,7 @@ export interface BrandingThemeColors {
     accent_hover?: string;
     accent_soft?: string;
     primary?: string;
+    primary_hover?: string;
     sidebar?: string;
     rail?: string;
     surface?: string;
@@ -191,14 +192,6 @@ export interface BrandingThemeColors {
     text_muted?: string;
     border?: string;
 }
-export interface BrandingThemeTypography {
-    font_display?: string;
-    body?: number;
-    page_title?: number;
-    table_cell?: number;
-    control?: number;
-    caption?: number;
-}
 export interface BrandingTheme {
     css_url?: string;
     font_sans?: string;
@@ -206,7 +199,6 @@ export interface BrandingTheme {
     radius?: string;
     density?: string;
     colors?: BrandingThemeColors;
-    typography?: BrandingThemeTypography;
 }
 export interface BrandingSurfaceFlags {
     show_title?: boolean;

package/dist-lib/types/schema.d.ts

@@ -29,7 +29,7 @@ export declare function getDisplayValue(row: Record<string, unknown> | null | un
         display_field?: string;
     };
 } | null | undefined): string | undefined;
-export declare function resolveRefRecordLabel(record: Record<string, unknown>, displayField: string | undefined, fallback: string): string;
+export declare function resolveRefRecordLabel(record: Record<string, unknown>, displayKey: string | undefined, fallback: string): string;
 export declare function screenTitleForPath(pathname: string, screens: Record<string, Screen> | undefined, entities?: Record<string, Entity>): {
     title: string;
     icon?: string;
@@ -413,6 +413,22 @@ export interface Entity {
      * list UI on this. See docs/plans/2026-06-20-cross-store-list-cursor-pagination.md.
      */
     list_pagination?: "offset" | "cursor";
+    /**
+     * Static, per-caller document-generation capability computed from the
+     * SYSTEM document template registry at schema projection (registry-only,
+     * no DB read, no ETag impact - system templates are boot-static and are
+     * covered by the schema fingerprint). Absent (or both flags falsy) means
+     * no system template applies for this caller/tenant/entity - the
+     * frontend's Generate affordance renders nothing UNLESS a tenant-uploaded
+     * template is found via the lazy `document.templates.available` runtime
+     * probe (tenant templates are runtime data and are never baked into the
+     * schema). `generate_one` gates the detail-scope toolbar; `generate_many`
+     * gates the list-scope toolbar. See docs/document-generation.md.
+     */
+    documents?: {
+        generate_one?: boolean;
+        generate_many?: boolean;
+    };
 }
 export interface ExportConfig {
     enabled?: boolean;

package/dist-lib/{useProperties-D74hyWIa.js → useProperties-CgRhBh0k.js}

@@ -1,5 +1,5 @@
-import { J as e, Ot as t, R as n, Yt as r, gn as i, kt as a, on as o, rt as s } from "./ActionRunner-CaSrGpBi.js";
-import { vt as c } from "./registry-KQyyL5Gt.js";
+import { Mt as e, Qt as t, V as n, Z as r, jt as i, ln as a, ot as o, yn as s } from "./ActionRunner-UGGvGypS.js";
+import { vt as c } from "./registry-DnPK3Msj.js";
 import { useEffect as l, useMemo as u } from "react";
 import { useSearchParams as d } from "react-router-dom";
 import { useInfiniteQuery as f, useMutation as p, useQueryClient as m } from "@tanstack/react-query";
@@ -47,33 +47,33 @@ var b = class {
 		this.entity = e, this.refs = t ?? new v();
 	}
 	async get(e) {
-		let n = new URLSearchParams(typeof e == "string" ? { id: e } : e);
-		return _((await t(`/api/data/${this.entity}?${n.toString()}`)).data);
+		let t = new URLSearchParams(typeof e == "string" ? { id: e } : e);
+		return _((await i(`/api/data/${this.entity}?${t.toString()}`)).data);
 	}
 	async list(e = {}) {
-		let n, i = !1;
+		let n, r = !1;
 		try {
-			n = await t(y(this.entity, e));
+			n = await i(y(this.entity, e));
 		} catch (a) {
-			if (e.after && r(a)) {
-				let { after: r, ...a } = e;
-				n = await t(y(this.entity, a)), i = !0;
+			if (e.after && t(a)) {
+				let { after: t, ...a } = e;
+				n = await i(y(this.entity, a)), r = !0;
 			} else throw a;
 		}
 		return this.refs.merge(n.$refs), {
 			data: n.data.map((e) => _(e)),
 			meta: n.meta,
 			$refs: this.refs.all(),
-			reset: i
+			reset: r
 		};
 	}
 	async create(e) {
 		return (await this.createMany([e]))[0];
 	}
-	async createMany(e) {
-		if (e.length === 0) return [];
-		let t = await a("system.batch", {
-			actions: e.map((e) => ({
+	async createMany(t) {
+		if (t.length === 0) return [];
+		let n = await e("system.batch", {
+			actions: t.map((e) => ({
 				action: `${this.entity}.__create`,
 				params: {
 					entity: this.entity,
@@ -82,7 +82,7 @@ var b = class {
 			})),
 			atomic: !0
 		});
-		return x(t, `${this.entity}.__create`), t.results.map((e) => _(S(e)));
+		return x(n, `${this.entity}.__create`), n.results.map((e) => _(S(e)));
 	}
 	async update(e, t) {
 		return (await this.updateMany([{
@@ -90,10 +90,10 @@ var b = class {
 			...t
 		}]))[0];
 	}
-	async updateMany(e) {
-		if (e.length === 0) return [];
-		let t = await a("system.batch", {
-			actions: e.map(({ id: e, ...t }) => ({
+	async updateMany(t) {
+		if (t.length === 0) return [];
+		let n = await e("system.batch", {
+			actions: t.map(({ id: e, ...t }) => ({
 				action: `${this.entity}.__update`,
 				params: {
 					object_ids: [e],
@@ -103,13 +103,13 @@ var b = class {
 			})),
 			atomic: !0
 		});
-		return x(t, `${this.entity}.__update`), t.results.map((e) => _(S(e)));
+		return x(n, `${this.entity}.__update`), n.results.map((e) => _(S(e)));
 	}
 	async delete(e) {
 		await this.deleteMany([e]);
 	}
 	async deleteMany(e) {
-		return e.length === 0 ? { count: 0 } : { count: (await s(`${this.entity}.__delete`, {
+		return e.length === 0 ? { count: 0 } : { count: (await o(`${this.entity}.__delete`, {
 			object_ids: e,
 			entity: this.entity
 		})).object_count ?? e.length };
@@ -118,7 +118,7 @@ var b = class {
 		await this.restoreMany([e]);
 	}
 	async restoreMany(e) {
-		return e.length === 0 ? { count: 0 } : { count: (await s(`${this.entity}.__restore`, {
+		return e.length === 0 ? { count: 0 } : { count: (await o(`${this.entity}.__restore`, {
 			object_ids: e,
 			entity: this.entity
 		})).object_count ?? e.length };
@@ -126,20 +126,20 @@ var b = class {
 	async upsert(e, t) {
 		return (await this.upsertMany([e], t))[0];
 	}
-	async upsertMany(e, t) {
-		if (e.length === 0) return [];
-		let n = await a("system.batch", {
-			actions: e.map((e) => ({
+	async upsertMany(t, n) {
+		if (t.length === 0) return [];
+		let r = await e("system.batch", {
+			actions: t.map((e) => ({
 				action: `${this.entity}.__upsert`,
 				params: {
 					entity: this.entity,
 					fields: e,
-					unique_by: t
+					unique_by: n
 				}
 			})),
 			atomic: !0
 		});
-		return x(n, `${this.entity}.__upsert`), n.results.map((e) => _(C(e)));
+		return x(r, `${this.entity}.__upsert`), r.results.map((e) => _(C(e)));
 	}
 };
 function x(e, t) {
@@ -232,40 +232,40 @@ function O(e, t, n) {
 }
 //#endregion
 //#region src/hooks/useTabSearchMirror.ts
-function k(t) {
-	let n = e(), [r] = d();
+function k(e) {
+	let t = r(), [n] = d();
 	l(() => {
-		if (!t || n.enabled) return;
-		let e = c.getState(), i = e.findTabByPathname(t);
-		i && e.updateTabSearch(i.id, r.toString());
+		if (!e || t.enabled) return;
+		let r = c.getState(), i = r.findTabByPathname(e);
+		i && r.updateTabSearch(i.id, n.toString());
 	}, [
-		r,
-		t,
-		n.enabled
+		n,
+		e,
+		t.enabled
 	]);
 }
 //#endregion
 //#region src/hooks/useRegisterScreenTab.ts
-function A(t, n, r, i) {
-	let a = e();
+function A(e, t, n, i) {
+	let a = r();
 	l(() => {
-		!t || a.enabled || c.getState().openTab({
-			pathname: t,
+		!e || a.enabled || c.getState().openTab({
+			pathname: e,
 			search: i,
-			title: n,
-			icon: r,
+			title: t,
+			icon: n,
 			closable: !0
 		});
 	}, [
+		e,
 		t,
 		n,
-		r,
 		a.enabled
 	]);
 }
 function j(e, t, n) {
-	let r = e?.route, i = t ? o(e?.display?.name) || o(t.display.name_plural) : "", a = e?.display?.icon || t?.display.icon;
-	A(t ? r : void 0, i, a, n);
+	let r = e?.route, i = t ? a(e?.display?.name) || a(t.display.name_plural) : "", o = e?.display?.icon || t?.display.icon;
+	A(t ? r : void 0, i, o, n);
 }
 //#endregion
 //#region src/lib/filters.ts
@@ -332,14 +332,14 @@ function z(e, t) {
 	if (!e.field || !e.op) return "";
 	let n = N[e.op] || e.op;
 	if (M.has(e.op)) return `${n}`;
-	let r = e.field, a = (e) => {
+	let r = e.field, i = (e) => {
 		if (t) {
 			let n = t(r, e);
 			return n.label != null && (n.status === "special" || n.status === "resolved") ? n.label : n.raw;
 		}
-		return i(e);
+		return s(e);
 	};
-	return `${n} ${Array.isArray(e.value) ? e.value.map(a).join(", ") : a(e.value)}`;
+	return `${n} ${Array.isArray(e.value) ? e.value.map(i).join(", ") : i(e.value)}`;
 }
 function B(e, t) {
 	return {
@@ -379,12 +379,12 @@ async function H(e, t, n, r, i) {
 		status_code: r
 	};
 	i != null && (a.note = i);
-	let o = (await s(`${e}.__update`, {
+	let s = (await o(`${e}.__update`, {
 		object_ids: [t],
 		entity: e,
 		fields: { $statuses: [a] }
 	})).result?.rows?.[0]?.$statuses ?? [];
-	return o.find((e) => e.group_code === n) ?? o[0];
+	return s.find((e) => e.group_code === n) ?? s[0];
 }
 //#endregion
 //#region src/hooks/useObjectStatus.ts
@@ -403,7 +403,7 @@ function U(e, t) {
 //#endregion
 //#region src/api/properties.ts
 async function W(e, t, n, r) {
-	let i = (await s(`${e}.__update`, {
+	let i = (await o(`${e}.__update`, {
 		object_ids: [t],
 		entity: e,
 		fields: { $properties: [{
@@ -414,7 +414,7 @@ async function W(e, t, n, r) {
 	return i.find((e) => e.property_code === n) ?? i[0];
 }
 async function G(e, t, n) {
-	await s(`${e}.__update`, {
+	await o(`${e}.__update`, {
 		object_ids: [t],
 		entity: e,
 		fields: { $properties: [{

package/dist-lib/{value-BfXXl5EE.js → value-GmL5BVFm.js}

@@ -1,4 +1,4 @@
-import { Ft as e, It as t, zt as n } from "./ActionRunner-CaSrGpBi.js";
+import { Ht as e, Rt as t, zt as n } from "./ActionRunner-UGGvGypS.js";
 import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
 //#region src/components/file-widgets/helpers.ts
 var s = ["thumb_200", "thumb_300"];
@@ -113,17 +113,17 @@ function T(e, t) {
 function E(e) {
 	return `${e}${e.includes("?") ? "&" : "?"}disposition=attachment`;
 }
-async function D(n, r) {
-	let i = await e(), a = await fetch(n, T(i, r));
+async function D(e, r) {
+	let i = await t(), a = await fetch(e, T(i, r));
 	if (a.status !== 401) return a;
-	t();
-	let o = await e();
-	return fetch(n, T(o, r));
-}
-async function O(e, t, r) {
-	if (!n()) throw Error("resolveEmbedFileSrc called outside embed token mode");
-	let i = await D(C(e, t), r);
-	if (i.status === 202 && typeof t == "object") throw new w(e, t.derivation);
+	n();
+	let o = await t();
+	return fetch(e, T(o, r));
+}
+async function O(t, n, r) {
+	if (!e()) throw Error("resolveEmbedFileSrc called outside embed token mode");
+	let i = await D(C(t, n), r);
+	if (i.status === 202 && typeof n == "object") throw new w(t, n.derivation);
 	if (!i.ok) throw Error(`embed file url request failed: ${i.status} ${i.statusText}`);
 	let a = await i.json();
 	if (!S(a)) throw Error("embed file url response is malformed");
@@ -132,7 +132,7 @@ async function O(e, t, r) {
 		kind: "direct"
 	};
 	if (!a.url.startsWith("/api/files/")) throw Error(`embed file proxy: refusing non-files-route URL ${JSON.stringify(a.url)}`);
-	let o = await D(t === "download" ? E(a.url) : a.url, r);
+	let o = await D(n === "download" ? E(a.url) : a.url, r);
 	if (!o.ok) throw Error(`embed file proxy fetch failed: ${o.status} ${o.statusText}`);
 	let s = await o.blob();
 	return {
@@ -148,23 +148,23 @@ function k(e) {
 function A(e) {
 	return e.startsWith("derivation:") ? { derivation: e.slice(11) } : e === "download" ? "download" : "preview";
 }
-function j(e, t, r) {
-	let a = k(t), [s, c] = o(() => n() ? void 0 : r);
+function j(t, n, r) {
+	let a = k(n), [s, c] = o(() => e() ? void 0 : r);
 	return i(() => {
-		n() || c(r);
+		e() || c(r);
 	}, [r]), i(() => {
-		if (!n()) return;
-		if (!e) {
+		if (!e()) return;
+		if (!t) {
 			c(void 0);
 			return;
 		}
-		let t = null, r = !1, i = new AbortController();
-		return c(void 0), O(e, A(a), i.signal).then((e) => {
+		let n = null, r = !1, i = new AbortController();
+		return c(void 0), O(t, A(a), i.signal).then((e) => {
 			if (r) {
 				e.kind === "blob" && URL.revokeObjectURL(e.url);
 				return;
 			}
-			e.kind === "blob" && (t = e.url), c(e.url);
+			e.kind === "blob" && (n = e.url), c(e.url);
 		}).catch((e) => {
 			if (!r) {
 				if (e instanceof w) {
@@ -174,22 +174,22 @@ function j(e, t, r) {
 				e instanceof DOMException && e.name === "AbortError" || (console.error("[declarion-embed] file src resolution failed:", e), c(void 0));
 			}
 		}), () => {
-			r = !0, i.abort(), t && URL.revokeObjectURL(t);
+			r = !0, i.abort(), n && URL.revokeObjectURL(n);
 		};
-	}, [e, a]), s;
+	}, [t, a]), s;
 }
 function M() {
-	let e = a([]);
+	let t = a([]);
 	return i(() => () => {
-		for (let t of e.current) URL.revokeObjectURL(t);
-		e.current = [];
-	}, []), { open: r((t, r, i) => {
-		if (!n()) {
+		for (let e of t.current) URL.revokeObjectURL(e);
+		t.current = [];
+	}, []), { open: r((n, r, i) => {
+		if (!e()) {
 			i && window.open(i, "_blank", "noopener");
 			return;
 		}
-		t && O(t, r).then((t) => {
-			t.kind === "blob" && e.current.push(t.url), window.open(t.url, "_blank", "noopener");
+		n && O(n, r).then((e) => {
+			e.kind === "blob" && t.current.push(e.url), window.open(e.url, "_blank", "noopener");
 		}).catch((e) => {
 			e instanceof w || console.error("[declarion-embed] file open failed:", e);
 		});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",