@declarion/react 0.54.0 → 0.56.0

package/dist-lib/lib/action-dispatch.d.ts

@@ -1,5 +1,5 @@
-import { type UIActionContext } from "./ui-actions";
-import type { UIStep } from "../types/schema";
+import { type UIActionContext } from "./ui-actions.d.ts";
+import type { UIStep } from "../types/schema.d.ts";
 export declare function dispatchAction(code: string, action: {
     ui_steps?: UIStep[];
     handler?: string;

package/dist-lib/lib/actions.d.ts

@@ -1,4 +1,4 @@
-import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema";
+import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema.d.ts";
 /**
  * Row-menu navigation platform-default action codes. The server injects them
  * into every entity and (for explicit action_layout trees) prepends them so the

package/dist-lib/lib/brand-tokens.d.ts

@@ -1,4 +1,4 @@
-import type { BrandingTheme } from "../types/api";
+import type { BrandingTheme } from "../types/api.d.ts";
 /** The two color schemes, and the order their rules are emitted in. */
 export declare const COLOR_SCHEMES: readonly ["light", "dark"];
 export type BrandColorScheme = (typeof COLOR_SCHEMES)[number];

package/dist-lib/lib/branding.d.ts

@@ -1,4 +1,4 @@
-import type { BrandingChrome, BrandingIdentity, BrandingTheme, PublicBranding, PublicParam, PublicParamsResponse } from "../types/api";
+import type { BrandingChrome, BrandingIdentity, BrandingTheme, PublicBranding, PublicParam, PublicParamsResponse } from "../types/api.d.ts";
 export declare const BRANDING_PARAM_CODE = "branding";
 export declare function paramsToRecord(list: PublicParam[] | undefined): Record<string, unknown>;
 export declare function publicParamValue(publicParams: PublicParamsResponse | undefined, code: string): unknown;

package/dist-lib/lib/child-config.d.ts

@@ -1,4 +1,4 @@
-import type { ChildDisplayMode, ChildQuickAdd, ChildRelation, CardsConfig, Entity, LayoutNode, LocalizedString, TimelineConfig } from "../types/schema";
+import type { ChildDisplayMode, ChildQuickAdd, ChildRelation, CardsConfig, Entity, LayoutNode, LocalizedString, TimelineConfig } from "../types/schema.d.ts";
 export interface ResolvedChildConfig {
     entity: string;
     foreign_key: string | string[];

package/dist-lib/lib/children-validation.d.ts

@@ -1,5 +1,5 @@
-import type { Entity, Schema } from "../types/schema";
-import type { PendingChildRow } from "../components/detail-layout/LayoutRenderer";
+import type { Entity, Schema } from "../types/schema.d.ts";
+import type { PendingChildRow } from "../components/detail-layout/LayoutRenderer.d.ts";
 export declare function findMissingRequiredFields(entity: Entity, formData: Record<string, unknown>, isNew: boolean): string[];
 export declare function findInvalidEmailFields(entity: Entity, formData: Record<string, unknown>): string[];
 export declare function validatePendingChildren(pendingChildren: Record<string, PendingChildRow[]> | undefined, schema: Schema | undefined): Record<string, Record<string, string[]>>;

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

@@ -1,4 +1,4 @@
-import type { Schema } from "../types/schema";
+import type { Schema } from "../types/schema.d.ts";
 /**
  * Heuristic used by DocumentsMenu mount sites to decide whether the caller
  * can manage TENANT document templates: the `document_template` entity is

package/dist-lib/lib/evidence-verdict.d.ts

@@ -1,4 +1,4 @@
-import type { PillTone } from "../components/primitives/Pill";
+import type { PillTone } from "../components/primitives/Pill.d.ts";
 export declare const EVIDENCE_VERDICT: {
     readonly verified: "verified";
     readonly unverified: "unverified";

package/dist-lib/lib/mass-edit.d.ts

@@ -1,4 +1,4 @@
-import type { Entity, EntityField, PropertyDef, StatusGroupDef } from "../types/schema";
+import type { Entity, EntityField, PropertyDef, StatusGroupDef } from "../types/schema.d.ts";
 /** Target kinds mirror engine.MassEditTargetKind in Go. */
 export type MassEditTargetKind = "field" | "status" | "property";
 /** Metadata a property-grid row needs to render a target + editable value cell. */

package/dist-lib/lib/messages.d.ts

@@ -1,5 +1,5 @@
-import { type LocalizedString } from "../types/schema";
-import type { PublicParam } from "../types/api";
+import { type LocalizedString } from "../types/schema.d.ts";
+import type { PublicParam } from "../types/api.d.ts";
 export declare const DEFAULT_LOCALE = "en";
 /**
  * A catalogue of localized strings keyed by code. The platform ships two and

package/dist-lib/lib/realtime-query-keys.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Every list-shaped cache the SDK ships. 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[];
+/**
+ * The entity code backing RecordDocumentsPanel's realtime flip, declared once
+ * so the "generated_document" ↔ RECORD_DOCUMENTS_KEY link is a single fact.
+ */
+export declare const GENERATED_DOCUMENT_ENTITY = "generated_document";
+export declare function isListCacheKey(key: readonly unknown[]): boolean;
+export declare function isRefetchOnlyListKey(key: readonly unknown[]): boolean;
+/** A list, count or detail cache: the queries whose rows ARE an entity's rows. */
+export declare function isEntityRowsKey(key: readonly unknown[]): boolean;
+/**
+ * The entity whose frames keep this cache fresh, or null when realtime does not
+ * keep it - the one list of realtime-backed caches.
+ */
+export declare function entityOfRealtimeQueryKey(key: readonly unknown[]): string | null;
+export declare function isRealtimeBackedQueryKey(key: readonly unknown[]): boolean;

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

@@ -4,15 +4,7 @@
  * "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[];
+import type { ListParams } from "../types/api.d.ts";
 /** One row a frame named, plus whether every frame naming it said `created`. */
 export interface ChangedRow {
     pk: Record<string, string>;
@@ -40,4 +32,3 @@ export declare function reconcileListCaches(queryClient: QueryClient, entity: st
  * 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/lib/realtime-resync.d.ts

@@ -0,0 +1,23 @@
+import { type QueryClient, type QueryKey } from "@tanstack/react-query";
+import { type ResyncScope } from "../stores/realtime.d.ts";
+export interface ResyncRequest {
+    scope: ResyncScope;
+    /** The fixed keys of a `keys` scope. */
+    keys?: readonly QueryKey[];
+    standing?: boolean;
+    jitter?: boolean;
+    carriedMarks?: ReadonlyMap<string, number>;
+}
+/**
+ * Opens a resync over the keys the request names, taking the current fetch
+ * generation. An `all` request folds into an `all` resync not yet issued: that
+ * one re-reads everything already, and a fold moves its generation forward so
+ * nothing fetched before the newer cause satisfies it.
+ */
+export declare function openResync(queryClient: QueryClient, request: ResyncRequest): void;
+/**
+ * Mounts the engine for this client for as long as the caller is mounted -
+ * outside any SSE connection, so a token refresh, a tab hide or a reconnect
+ * leaves every obligation where it was.
+ */
+export declare function useResyncEngine(queryClient: QueryClient): void;

package/dist-lib/lib/rich-text.d.ts

@@ -1,4 +1,4 @@
-import type { HydratedFile } from "../types/files";
+import type { HydratedFile } from "../types/files.d.ts";
 export interface RichTextValue {
     markdown: string;
     files: Record<string, HydratedFile>;

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

@@ -1,3 +1,3 @@
-import type { Schema } from "../types/schema";
+import type { Schema } from "../types/schema.d.ts";
 export declare function schemaDefaultRoute(schema: Schema | undefined): string | null;
 export declare function accessibleRedirectPath(requestedPath: string, schema: Schema | undefined): string;

package/dist-lib/lib/screen-back.d.ts

@@ -1,4 +1,4 @@
-import { type ReturnTarget, type TabItem } from "../stores/tabs";
+import { type ReturnTarget, type TabItem } from "../stores/tabs.d.ts";
 /** Drop a leading `?` so a search string matches the canonical `TabItem.search`
  *  / `ReturnTarget.search` form (stored WITHOUT `?`). Empty in -> empty out. */
 export declare function stripLeadingQuestion(search: string | undefined | null): string;

package/dist-lib/lib/size-value.d.ts

@@ -1,4 +1,4 @@
-import type { SizeValue } from "../types/schema";
+import type { SizeValue } from "../types/schema.d.ts";
 export type ParsedSizeValue = {
     kind: "weight";
     value: number;

package/dist-lib/lib/toast.d.ts

@@ -1,5 +1,5 @@
-import { type ToastType } from "../components/shared/toast/DeclarionToast";
-export type { ToastType, ToastAction } from "../components/shared/toast/DeclarionToast";
+import { type ToastType } from "../components/shared/toast/DeclarionToast.d.ts";
+export type { ToastType, ToastAction } from "../components/shared/toast/DeclarionToast.d.ts";
 /** Per-call toast options. Severity sets the defaults; these override them. */
 export interface ToastOptions {
     /** Auto-dismiss after this many ms. 0 = sticky. Defaults to the variant's. */

package/dist-lib/lib/ui-actions.d.ts

@@ -1,4 +1,4 @@
-import type { UIStep } from "../types/schema";
+import type { UIStep } from "../types/schema.d.ts";
 export interface UIActionContext {
     row?: Record<string, unknown>;
     params?: Record<string, unknown>;

package/dist-lib/lib/variants.d.ts

@@ -1,5 +1,5 @@
 import { type FilterRecord } from "./filter-evaluator";
-import type { Entity, Screen } from "../types/schema";
+import type { Entity, Screen } from "../types/schema.d.ts";
 export declare function resolveEntityVariantCode(entity: Entity, record: FilterRecord): string | undefined;
 export declare function variantActionCodesForRecord(entity: Entity | undefined, record: FilterRecord): ReadonlySet<string> | undefined;
 export declare function commonVariantActionCodes(entity: Entity | undefined, records: readonly FilterRecord[]): ReadonlySet<string> | undefined;

package/dist-lib/{peekDraftStore-CbHFwz_F.js → peekDraftStore-5wQ7lq_V.js}

@@ -1,5 +1,5 @@
 import { s as e } from "./DynamicIcon-DW5krHuX.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-DVTXCj_K.js";
+import { Lr as t, Mr as n, Vr as r, en as i, hr as a, i as o, kr as s, nr as c } from "./useCurrentScreen-CzwzQpoW.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: s, scope: g, objectIds: v = [], viewState: b, selectedIds: w = [], capability: T, canManageTemplates: E = !1 }) {
+function b({ entityCode: a, 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 ?? [],
+		queryKey: [y, a],
+		queryFn: async () => (await i("document.templates.available", { entity: a })).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;
@@ -50,10 +50,10 @@ function b({ entityCode: s, scope: g, objectIds: v = [], viewState: b, selectedI
 		return [];
 	}
 	function H(e, t, n) {
-		let r = x(e), o = a(e.name) || e.code;
+		let r = x(e), a = c(e.name) || e.code;
 		A(!1), D({
 			action: r,
-			title: o,
+			title: a,
 			execute: (r) => {
 				let a = {
 					template_code: e.code,
@@ -67,8 +67,8 @@ function b({ entityCode: s, scope: g, objectIds: v = [], viewState: b, selectedI
 			}
 		});
 	}
-	let { isPhone: U } = t();
-	return z ? /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(n, {
+	let { isPhone: U } = n();
+	return z ? /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(r, {
 		ref: O,
 		kind: "ghost",
 		size: "sm",
@@ -78,36 +78,36 @@ function b({ entityCode: s, scope: g, objectIds: v = [], viewState: b, selectedI
 		"aria-label": "Generate",
 		title: "Generate",
 		children: U ? null : "Generate"
-	}), /* @__PURE__ */ h(r, {
+	}), /* @__PURE__ */ h(t, {
 		open: k,
 		anchor: O.current,
 		onClose: () => A(!1),
 		align: "end",
 		width: 300,
 		children: [
-			I && /* @__PURE__ */ m(c, {
+			I && /* @__PURE__ */ m(s, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.loader, { size: 12 }),
 				children: "Loading templates..."
 			}),
-			F && /* @__PURE__ */ m(c, {
+			F && /* @__PURE__ */ m(s, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.warning, { size: 12 }),
 				children: F instanceof Error ? F.message : String(F)
 			}),
-			!I && !F && L.length === 0 && /* @__PURE__ */ m(c, {
+			!I && !F && L.length === 0 && /* @__PURE__ */ m(s, {
 				disabled: !0,
 				icon: /* @__PURE__ */ m(e.file, { size: 12 }),
 				children: "No document templates"
 			}),
 			!I && !F && L.map((t) => {
 				let n = V(t);
-				return n.length === 0 ? null : S(t).flatMap((r) => n.map((n) => r.available ? /* @__PURE__ */ m(c, {
+				return n.length === 0 ? null : S(t).flatMap((r) => n.map((n) => r.available ? /* @__PURE__ */ m(s, {
 					icon: /* @__PURE__ */ m(e.file, { size: 12 }),
 					onClick: () => H(t, n, r.format),
-					title: a(t.description),
+					title: c(t.description),
 					children: C(t, n, r.format)
-				}, `${t.source}:${t.code}:${n.kind}:${r.format}`) : /* @__PURE__ */ h(c, {
+				}, `${t.source}:${t.code}:${n.kind}:${r.format}`) : /* @__PURE__ */ h(s, {
 					disabled: !0,
 					icon: /* @__PURE__ */ m(e.file, { size: 12 }),
 					title: r.disabled_reason,
@@ -122,7 +122,7 @@ function b({ entityCode: s, scope: g, objectIds: v = [], viewState: b, selectedI
 	})] }) : null;
 }
 function x(e) {
-	let t = new s((e.params ?? []).map((e) => ({
+	let t = new a((e.params ?? []).map((e) => ({
 		...e,
 		name: e.name ?? ""
 	})));
@@ -143,7 +143,7 @@ function S(e) {
 	}));
 }
 function C(e, t, n) {
-	let r = a(e.name) || e.code, i = n ? ` (${n.toUpperCase()})` : "";
+	let r = c(e.name) || e.code, i = n ? ` (${n.toUpperCase()})` : "";
 	switch (t.kind) {
 		case "one": return `${r}${i}`;
 		case "selected": return `${r}${i} - selected rows`;