@declarion/react 0.54.0 → 0.54.1

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

@@ -5,14 +5,6 @@
  */
 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>;
@@ -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";
+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/{peekDraftStore-CbHFwz_F.js → peekDraftStore-lm9ViVLA.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-aHx9HH1m.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`;