@declarion/react 0.52.0 → 0.53.0

package/dist-lib/lib/document-templates.d.ts

@@ -6,7 +6,7 @@ import type { Schema } from "../types/schema";
  * `document_template` appears only when the caller can read it). Gates the
  * lazy `document.templates.available` tenant-template visibility probe
  * (Business Case 6, plan 2026-07-08-document-generation-hardening) so a
- * caller who cannot manage templates never fires it - the Haia default.
+ * caller who cannot manage templates never fires it, which is the default.
  * One shared predicate so SmartDetailPage and SmartListPage agree.
  */
 export declare function canManageDocumentTemplates(schema: Schema | undefined): boolean;

package/dist-lib/lib/realtime-reconcile.d.ts

@@ -0,0 +1,43 @@
+/**
+ * What a change frame does to the list caches of one entity. The outcome table
+ * it applies, and why the client decides nothing itself, is docs/realtime.md
+ * "Frontend Invalidation".
+ */
+import type { QueryClient } from "@tanstack/react-query";
+import type { ListParams } from "../types/api";
+/**
+ * Every list-shaped cache the SDK ships, stated once and read by the reconciler
+ * and its tests alike. The REFETCH-ONLY kind is the cursor list, whose cold
+ * tables a key does not prune. docs/realtime.md.
+ */
+export declare const NARROWED_LIST_CACHE_KEYS: readonly ["entity-data", "entity-data-all"];
+export declare const REFETCH_ONLY_LIST_CACHE_KEYS: readonly ["entity-data-cursor"];
+export declare const LIST_CACHE_KEYS: readonly string[];
+/** One row a frame named, plus whether every frame naming it said `created`. */
+export interface ChangedRow {
+    pk: Record<string, string>;
+    /**
+     * True when nothing but a creation named this row in this window - the one
+     * absence the client may read as certain. docs/realtime.md.
+     */
+    createdOnly: boolean;
+}
+/**
+ * Reconciles every cached list of one entity, resolving once each query it
+ * touched claims no freshness it lacks - never waiting for a refetch to
+ * COMPLETE. Returns whether the entity's count must be re-read.
+ */
+export declare function reconcileListCaches(queryClient: QueryClient, entity: string, rows: ChangedRow[], signal?: AbortSignal): Promise<boolean>;
+/**
+ * The screen's own query with the changed keys added as a membership test and
+ * only the WINDOWING inputs removed. Every other input stays, including the
+ * ones that decide what the screen may show at all: dropping the fixed filters
+ * or the search returns rows the screen excludes, and dropping the projection
+ * gives the replaced row a different field set from its neighbours and strips
+ * the very sort fields the comparison reads.
+ *
+ * The read states the size it needs - the key count - so it is by construction
+ * inside the deployment's own page ceiling and cannot be clamped.
+ */
+export declare function narrowedParams(params: ListParams, rows: ChangedRow[]): ListParams;
+export declare function isListCacheKey(key: readonly unknown[]): boolean;

package/dist-lib/{peekDraftStore-D3sowXga.js → peekDraftStore-1pIajluX.js}

@@ -1,5 +1,5 @@
 import { s as e } from "./DynamicIcon-DW5krHuX.js";
-import { Bn as t, Dn as n, bt as r, cr as i, er as a, fr as o, i as s, rr as c } from "./useCurrentScreen-74x5yJNb.js";
+import { Dr as t, Ir as n, Mr as r, Yt as i, Zn as a, i as o, ur as s, wr as c } from "./useCurrentScreen-BdnZq8vZ.js";
 import { useMemo as l, useRef as u, useState as d } from "react";
 import { useQuery as f } from "@tanstack/react-query";
 import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
@@ -21,10 +21,10 @@ function v(e, t) {
 //#endregion
 //#region src/components/pages/DocumentsMenu.tsx
 var y = "document-templates-available";
-function b({ entityCode: t, scope: g, objectIds: v = [], viewState: b, selectedIds: w = [], capability: T, canManageTemplates: E = !1 }) {
-	let { run: D } = s(), O = u(null), [k, A] = d(!1), j = g === "detail" ? !!T?.generate_one : !!T?.generate_many, M = E && !j, { data: N, isLoading: P, error: F } = f({
-		queryKey: [y, t],
-		queryFn: async () => (await r("document.templates.available", { entity: t })).result?.templates ?? [],
+function b({ entityCode: s, scope: g, objectIds: v = [], viewState: b, selectedIds: w = [], capability: T, canManageTemplates: E = !1 }) {
+	let { run: D } = o(), O = u(null), [k, A] = d(!1), j = g === "detail" ? !!T?.generate_one : !!T?.generate_many, M = E && !j, { data: N, isLoading: P, error: F } = f({
+		queryKey: [y, s],
+		queryFn: async () => (await i("document.templates.available", { entity: s })).result?.templates ?? [],
 		enabled: k || M,
 		staleTime: 6e4
 	}), I = P, L = l(() => (N ?? []).filter((e) => g === "detail" ? e.input_mode === "one" || e.input_mode === "global" : e.input_mode === "many" || e.input_mode === "global"), [g, N]), R = M && L.length > 0, z = j || R;
@@ -49,26 +49,26 @@ function b({ entityCode: t, scope: g, objectIds: v = [], viewState: b, selectedI
 		}
 		return [];
 	}
-	function H(e, t, i) {
-		let a = x(e), o = n(e.name) || e.code;
+	function H(e, t, n) {
+		let r = x(e), o = a(e.name) || e.code;
 		A(!1), D({
-			action: a,
+			action: r,
 			title: o,
-			execute: (n) => {
+			execute: (r) => {
 				let a = {
 					template_code: e.code,
 					template_source: e.source,
-					output_format: i
+					output_format: n
 				};
-				return Object.keys(n).length > 0 && (a.params = n), "objectIds" in t && (a.object_ids = t.objectIds), "query" in t && (a.query = {
+				return Object.keys(r).length > 0 && (a.params = r), "objectIds" in t && (a.object_ids = t.objectIds), "query" in t && (a.query = {
 					scope: "current_view",
 					query: t.query
-				}), r("document.generate", a);
+				}), i("document.generate", a);
 			}
 		});
 	}
-	let { isPhone: U } = c();
-	return z ? /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(o, {
+	let { isPhone: U } = t();
+	return z ? /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(n, {
 		ref: O,
 		kind: "ghost",
 		size: "sm",
@@ -78,51 +78,51 @@ function b({ entityCode: t, scope: g, objectIds: v = [], viewState: b, selectedI
 		"aria-label": "Generate",
 		title: "Generate",
 		children: U ? null : "Generate"
-	}), /* @__PURE__ */ h(i, {
+	}), /* @__PURE__ */ h(r, {
 		open: k,
 		anchor: O.current,
 		onClose: () => A(!1),
 		align: "end",
 		width: 300,
 		children: [
-			I && /* @__PURE__ */ m(a, {
+			I && /* @__PURE__ */ m(c, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.loader, { size: 12 }),
 				children: "Loading templates..."
 			}),
-			F && /* @__PURE__ */ m(a, {
+			F && /* @__PURE__ */ m(c, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.warning, { size: 12 }),
 				children: F instanceof Error ? F.message : String(F)
 			}),
-			!I && !F && L.length === 0 && /* @__PURE__ */ m(a, {
+			!I && !F && L.length === 0 && /* @__PURE__ */ m(c, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.file, { size: 12 }),
 				children: "No document templates"
 			}),
 			!I && !F && L.map((t) => {
-				let r = V(t);
-				return r.length === 0 ? null : S(t).flatMap((i) => r.map((r) => i.available ? /* @__PURE__ */ m(a, {
+				let n = V(t);
+				return n.length === 0 ? null : S(t).flatMap((r) => n.map((n) => r.available ? /* @__PURE__ */ m(c, {
 					icon: /* @__PURE__ */ m(e.file, { size: 12 }),
-					onClick: () => H(t, r, i.format),
-					title: n(t.description),
-					children: C(t, r, i.format)
-				}, `${t.source}:${t.code}:${r.kind}:${i.format}`) : /* @__PURE__ */ h(a, {
+					onClick: () => H(t, n, r.format),
+					title: a(t.description),
+					children: C(t, n, r.format)
+				}, `${t.source}:${t.code}:${n.kind}:${r.format}`) : /* @__PURE__ */ h(c, {
 					disabled: !0,
 					icon: /* @__PURE__ */ m(e.file, { size: 12 }),
-					title: i.disabled_reason,
+					title: r.disabled_reason,
 					children: [
-						C(t, r, i.format),
+						C(t, n, r.format),
 						" - ",
-						i.disabled_reason || "Unavailable"
+						r.disabled_reason || "Unavailable"
 					]
-				}, `${t.source}:${t.code}:${r.kind}:${i.format}:disabled`)));
+				}, `${t.source}:${t.code}:${n.kind}:${r.format}:disabled`)));
 			})
 		]
 	})] }) : null;
 }
 function x(e) {
-	let n = new t((e.params ?? []).map((e) => ({
+	let t = new s((e.params ?? []).map((e) => ({
 		...e,
 		name: e.name ?? ""
 	})));
@@ -133,7 +133,7 @@ function x(e) {
 			icon: "file",
 			description: e.description
 		},
-		resolved_params: n
+		resolved_params: t
 	};
 }
 function S(e) {
@@ -142,13 +142,13 @@ function S(e) {
 		available: !0
 	}));
 }
-function C(e, t, r) {
-	let i = n(e.name) || e.code, a = r ? ` (${r.toUpperCase()})` : "";
+function C(e, t, n) {
+	let r = a(e.name) || e.code, i = n ? ` (${n.toUpperCase()})` : "";
 	switch (t.kind) {
-		case "one": return `${i}${a}`;
-		case "selected": return `${i}${a} - selected rows`;
-		case "current_view": return `${i}${a} - current view`;
-		case "global": return `${i}${a}`;
+		case "one": return `${r}${i}`;
+		case "selected": return `${r}${i} - selected rows`;
+		case "current_view": return `${r}${i} - current view`;
+		case "global": return `${r}${i}`;
 	}
 }
 //#endregion