@declarion/react 0.52.0 → 0.54.0

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

@@ -3,7 +3,27 @@ interface RealtimeState {
     degradedEntities: ReadonlySet<string>;
     /** Mark one entity as auto-degraded. Idempotent. */
     markDegraded: (entityCode: string) => void;
+    /** Realtime is delivering everything again; forget every degraded entity. */
+    clearDegraded: () => void;
+    /**
+     * True while a presented resume position's replay has not landed. The rows
+     * keep rendering; what is not true is that they are up to date.
+     */
+    replayPending: boolean;
+    setReplayPending: (pending: boolean) => void;
+    /**
+     * True while a row re-read was turned away for budget. The rows keep
+     * rendering, but only a refresh the person asks for will renew them.
+     */
+    readRefused: boolean;
+    setReadRefused: (refused: boolean) => void;
 }
 export declare const useRealtimeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<RealtimeState>>;
 export declare function isEntityLive(realtimeFlag: boolean | undefined, degradedEntities: ReadonlySet<string>, entityCode: string): boolean;
+/**
+ * Whether a screen showing this entity is CURRENT - a different question from
+ * isEntityLive, which answers whether the relay delivers at all. The rows keep
+ * rendering throughout; this is what says they may be behind. docs/realtime.md.
+ */
+export declare function useScreenIsLive(realtimeFlag: boolean | undefined, entityCode: string): boolean;
 export {};

package/dist-lib/testing.js

@@ -1,4 +1,4 @@
-import { Dt as e, Et as t, Ot as n, ft as r, jt as i, nr as a, r as o, t as s, yt as c } from "./useCurrentScreen-74x5yJNb.js";
+import { Er as e, Jt as t, Vt as n, nn as r, on as i, r as a, rn as o, t as s, tn as c } from "./useCurrentScreen-DVTXCj_K.js";
 import { useState as l } from "react";
 import { MemoryRouter as u, useLocation as d } from "react-router";
 import { QueryClient as f, QueryClientProvider as p } from "@tanstack/react-query";
@@ -89,15 +89,15 @@ function E(e) {
 	}
 	return e;
 }
-function D(r) {
-	let i = r.entityData ?? {};
-	n((e, t) => {
-		let n = t;
-		r.onListRequest?.(e, n);
-		let a = i[e], o = typeof a == "function" ? a(n) : a;
+function D(e) {
+	let n = e.entityData ?? {};
+	o((t, r) => {
+		let i = r;
+		e.onListRequest?.(t, i);
+		let a = n[t], o = typeof a == "function" ? a(i) : a;
 		if (o instanceof Error) throw o;
 		let s = E(o), c = s.meta?.per_page ?? 50, l = s.meta?.total ?? s.rows.length;
-		return t.count === "only" ? {
+		return r.count === "only" ? {
 			data: [],
 			meta: {
 				page: 1,
@@ -116,54 +116,54 @@ function D(r) {
 			...s.refs === void 0 ? {} : { $refs: s.refs }
 		};
 	});
-	let a = r.entityItems ?? {}, o = r.entityItemResponses ?? {};
-	e((e, t) => {
-		let n = typeof t == "string" ? t : c(t), r = o[e]?.[n];
-		if (r instanceof Error) throw r;
-		if (r !== void 0) return r;
-		let i = a[e]?.[n];
-		if (i instanceof Error) throw i;
-		return { data: i };
+	let i = e.entityItems ?? {}, a = e.entityItemResponses ?? {};
+	r((e, n) => {
+		let r = typeof n == "string" ? n : t(n), o = a[e]?.[r];
+		if (o instanceof Error) throw o;
+		if (o !== void 0) return o;
+		let s = i[e]?.[r];
+		if (s instanceof Error) throw s;
+		return { data: s };
 	});
-	let s = r.actionResults ?? {};
-	t(async (e, t) => {
+	let s = e.actionResults ?? {};
+	c(async (e, t) => {
 		if (!(e in s)) throw Error(`renderWithDeclarion: no action result registered for "${e}" (seed it via actionResults)`);
 		let n = s[e];
 		return C(typeof n == "function" ? await n(t) : n);
 	});
 }
 function O() {
-	n(null), e(null), t(null), i.setState({
+	o(null), r(null), c(null), i.setState({
 		user: null,
 		isAuthenticated: !1,
 		activeTenant: null,
 		tenants: []
 	});
 }
-function k(e, t = {}) {
-	let n = new f({ defaultOptions: { queries: {
+function k(t, r = {}) {
+	let i = new f({ defaultOptions: { queries: {
 		retry: !1,
 		gcTime: Infinity
 	} } });
-	T(), n.setQueryData(["schema", !0], t.schema ?? v()), D(t);
-	let i = t.screenCode ? /* @__PURE__ */ h(s, {
-		code: t.screenCode,
-		children: e
-	}) : e, c = { current: t.route ?? "/" }, l = /* @__PURE__ */ g(p, {
-		client: n,
+	T(), i.setQueryData(["schema", !0], r.schema ?? v()), D(r);
+	let o = r.screenCode ? /* @__PURE__ */ h(s, {
+		code: r.screenCode,
+		children: t
+	}) : t, c = { current: r.route ?? "/" }, l = /* @__PURE__ */ g(p, {
+		client: i,
 		children: [/* @__PURE__ */ g(u, {
-			initialEntries: [t.route ?? "/"],
-			children: [/* @__PURE__ */ h(w, { into: c }), /* @__PURE__ */ h(o, { children: i })]
+			initialEntries: [r.route ?? "/"],
+			children: [/* @__PURE__ */ h(w, { into: c }), /* @__PURE__ */ h(a, { children: o })]
 		}), /* @__PURE__ */ h(m, {})]
-	}), d = t.embedQuery ? /* @__PURE__ */ h(r, {
-		query: t.embedQuery,
+	}), d = r.embedQuery ? /* @__PURE__ */ h(n, {
+		query: r.embedQuery,
 		children: l
-	}) : l, y = _(t.viewport ? /* @__PURE__ */ h(a, {
-		viewportOverride: t.viewport,
+	}) : l, y = _(r.viewport ? /* @__PURE__ */ h(e, {
+		viewportOverride: r.viewport,
 		children: d
 	}) : d);
 	return Object.assign(y, {
-		queryClient: n,
+		queryClient: i,
 		location: () => c.current
 	});
 }
@@ -184,7 +184,7 @@ function A({ children: e, authenticated: t = !0, ...n }) {
 		client: r,
 		children: [/* @__PURE__ */ h(u, {
 			initialEntries: [n.route ?? "/"],
-			children: /* @__PURE__ */ h(o, { children: e })
+			children: /* @__PURE__ */ h(a, { children: e })
 		}), /* @__PURE__ */ h(m, {})]
 	});
 }

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

@@ -1,4 +1,4 @@
-import type { AccentDef, LocalizedString } from "./schema";
+import type { AccentDef, EntityField, LocalizedString } from "./schema";
 import type { HydratedFile } from "./files";
 import type { FilterNode } from "../lib/filters";
 export interface ListMeta {
@@ -398,7 +398,7 @@ export interface ParamLookup {
 /**
  * One entry of the bulk `GET /api/params` response (and per-code resolution).
  * Carries the declaration facets the admin UIs need to compute attachment,
- * render structure editors, and render choice selects, so the bulk endpoint is
+ * render structure editors, and render member selects, so the bulk endpoint is
  * self-sufficient without a second schema fetch.
  */
 export interface ResolvedParam {
@@ -413,8 +413,12 @@ export interface ResolvedParam {
     scopes?: string[];
     /** Structure code when `type === "structure"`. */
     structure?: string;
-    /** Closed value set for a choices-constrained string param. */
-    choices?: string[];
+    /** Members of a closed type - `enum`, or an enum-backed `string_array`.
+     *  Carried whole rather than as bare codes so the editor can show a name. */
+    values?: EntityField["values"];
+    /** Shared enum this parameter names, when it names one rather than listing
+     *  its members inline. Present for display; `values` is what to render. */
+    enum?: string;
 }
 export interface ParamOverride {
     param_code: string;

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

@@ -301,6 +301,12 @@ export interface ParameterDef {
     category?: string;
     /** Override scopes accepted on writes. Subset of: env, tenant, role, user, object. Empty = all. */
     scopes?: string[];
+    /** Members of a closed type - `enum`, or an enum-backed `string_array`. Resolved
+     *  at load whether declared inline or by naming a shared enum, so this is the set
+     *  the platform enforces. Same shape a field's members have. */
+    values?: EntityField["values"];
+    /** The shared enum this parameter names, when it names one. `values` is what to render. */
+    enum?: string;
 }
 export interface AssociationDisplay {
     name?: LocalizedString;