@declarion/react 0.61.1 → 0.63.0

package/dist-lib/screen-back-Cs4kzeqD.js

@@ -0,0 +1,44 @@
+import { N as e, P as t } from "./PropertyGridEditor-BTjscqfz.js";
+//#region src/lib/screen-back.ts
+function n(e) {
+	return e ? e.startsWith("?") ? e.slice(1) : e : "";
+}
+function r(e) {
+	if (e) return e.startsWith("?") ? e : `?${e}`;
+}
+function i(r, i, a) {
+	if (!t(r.pathname) || e(r.pathname) || r.pathname === i) return;
+	let o = n(r.search), s = { pathname: r.pathname };
+	return o && (s.search = o), r.hash && (s.hash = r.hash), a?.id && (s.tabId = a.id), a?.title && (s.title = a.title), a?.icon && (s.icon = a.icon), a?.screen && (s.screen = a.screen), s;
+}
+function a(e, n) {
+	return n ? {
+		hasOriginBack: !1,
+		allowFallbackBack: !0
+	} : e === null ? {
+		hasOriginBack: !1,
+		allowFallbackBack: !1
+	} : e && t(e.pathname) ? {
+		hasOriginBack: !0,
+		allowFallbackBack: !0
+	} : {
+		hasOriginBack: !1,
+		allowFallbackBack: !0
+	};
+}
+function o(e, n, r) {
+	if (r || !e || !t(e.pathname)) return null;
+	let i = (e.tabId ? n.find((t) => t.id === e.tabId) : void 0) ?? n.find((t) => t.pathname === e.pathname);
+	return {
+		kind: i ? "live" : "reopen",
+		tabId: i?.id,
+		pathname: e.pathname,
+		search: e.search,
+		hash: e.hash,
+		title: e.title,
+		icon: e.icon,
+		screen: e.screen
+	};
+}
+//#endregion
+export { r as a, n as i, o as n, a as r, i as t };

package/dist-lib/testing.d.ts

@@ -1,12 +1,8 @@
-import { type ReactElement, type ReactNode } from "react";
-import { type RenderResult } from "@testing-library/react";
+import { Dt as TextFn, E as DataResponse, L as Refs, d as ActionExecuteResponse, it as LocalizedString, j as ListResponse, k as ListMeta, o as ResponsiveViewport, u as ActionExecuteRequest, ut as Schema } from "./useResponsiveMode-DIR1bZfo.js";
+import { ReactElement, ReactNode } from "react";
 import { QueryClient } from "@tanstack/react-query";
-import { type ResponsiveViewport } from "./hooks/useResponsiveMode.d.ts";
-import { type ActionExecuteRequest, type ActionExecuteResponse } from "./api/data.d.ts";
-import type { Schema } from "./types/schema.d.ts";
-import type { DataResponse, ListMeta, ListResponse, Refs } from "./types/api.d.ts";
-import { type TextFn } from "./lib/language.d.ts";
-import type { LocalizedString } from "./types/schema.d.ts";
+import { RenderResult } from "@testing-library/react";
+//#region src/testing.d.ts
 /** A single action's stubbed outcome: the action's RESULT payload (what
  *  executeDeclarionAction unwraps from response.result), or a function of the
  *  dispatched body returning it. The harness always wraps it in a success
@@ -20,54 +16,54 @@ export type ActionResult = ((body: ActionExecuteRequest) => unknown) | Record<st
 /** One entity's list fixture, or the failure its query returns. */
 export type EntityDataEntry = Record<string, unknown>[] | EntityDataFixture | ListResponse | Error;
 export interface EntityDataFixture {
-    rows: Record<string, unknown>[];
-    meta?: Partial<ListMeta>;
-    refs?: Refs;
+  rows: Record<string, unknown>[];
+  meta?: Partial<ListMeta>;
+  refs?: Refs;
 }
 export interface RenderWithDeclarionOptions {
-    /** Seeded into the schema query cache so useSchema resolves warm. Build with schemaFixture. */
-    schema?: Schema;
-    /** entity -> rows, { rows, meta }, or an entityDataFixture() ListResponse.
-     *  An Error entry makes the query FAIL; a FUNCTION entry is called with the
-     *  request, so a filtered query can answer differently from an unfiltered one. */
-    entityData?: Record<string, EntityDataEntry | ((params: Record<string, unknown>) => EntityDataEntry)>;
-    /** entity -> { [id]: row | Error }; resolves useObject. Error entries let tests model 404/403 without network. */
-    entityItems?: Record<string, Record<string, Record<string, unknown> | Error>>;
-    /** entity -> { [id]: DataResponse | Error }; resolves useObject when a test needs envelope metadata like `$refs`. */
-    entityItemResponses?: Record<string, Record<string, DataResponse | Error>>;
-    /** action code -> result | (body) => result; resolves executeAction (and create/update/delete/restore). */
-    actionResults?: Record<string, ActionResult>;
-    /** Initial path for the memory router (e.g. "/replay/abc/compare"). Default "/". */
-    route?: string;
-    /**
-     * The screen code the rendered component is standing in for, as the router would
-     * mount it. Custom screens read their own declaration through `useCurrentScreen()` -
-     * `<PageHeader />` takes its title and description from it - so a harness that does
-     * not supply it renders a screen with no name, which is not what production does.
-     * Pass the same code the schema declares.
-     */
-    screenCode?: string;
-    /** Optional responsive viewport seam for component tests that assert phone/tablet behavior. */
-    viewport?: ResponsiveViewport;
-    /** Called with every list request before it resolves. A screen decides what
-     *  to ASK for - which columns, which sort, whether to expand refs - and that
-     *  is invisible in the rendered output. */
-    onListRequest?: (entity: string, params: Record<string, unknown>) => void;
-    /** Mounts the screen inside an embed context, as the white-label iframe does:
-     *  the embed query string the host passes. Absent means the in-app render. */
-    embedQuery?: string;
+  /** Seeded into the schema query cache so useSchema resolves warm. Build with schemaFixture. */
+  schema?: Schema;
+  /** entity -> rows, { rows, meta }, or an entityDataFixture() ListResponse.
+   *  An Error entry makes the query FAIL; a FUNCTION entry is called with the
+   *  request, so a filtered query can answer differently from an unfiltered one. */
+  entityData?: Record<string, EntityDataEntry | ((params: Record<string, unknown>) => EntityDataEntry)>;
+  /** entity -> { [id]: row | Error }; resolves useObject. Error entries let tests model 404/403 without network. */
+  entityItems?: Record<string, Record<string, Record<string, unknown> | Error>>;
+  /** entity -> { [id]: DataResponse | Error }; resolves useObject when a test needs envelope metadata like `$refs`. */
+  entityItemResponses?: Record<string, Record<string, DataResponse | Error>>;
+  /** action code -> result | (body) => result; resolves executeAction (and create/update/delete/restore). */
+  actionResults?: Record<string, ActionResult>;
+  /** Initial path for the memory router (e.g. "/replay/abc/compare"). Default "/". */
+  route?: string;
+  /**
+   * The screen code the rendered component is standing in for, as the router would
+   * mount it. Custom screens read their own declaration through `useCurrentScreen()` -
+   * `<PageHeader />` takes its title and description from it - so a harness that does
+   * not supply it renders a screen with no name, which is not what production does.
+   * Pass the same code the schema declares.
+   */
+  screenCode?: string;
+  /** Optional responsive viewport seam for component tests that assert phone/tablet behavior. */
+  viewport?: ResponsiveViewport;
+  /** Called with every list request before it resolves. A screen decides what
+   *  to ASK for - which columns, which sort, whether to expand refs - and that
+   *  is invisible in the rendered output. */
+  onListRequest?: (entity: string, params: Record<string, unknown>) => void;
+  /** Mounts the screen inside an embed context, as the white-label iframe does:
+   *  the embed query string the host passes. Absent means the in-app render. */
+  embedQuery?: string;
 }
 export interface RenderWithDeclarionResult extends RenderResult {
-    /** The live QueryClient, for advanced cache assertions or manual refetch. */
-    queryClient: QueryClient;
-    /** Where the screen has navigated to, as `pathname + search + hash`. The
-     *  alternative is stubbing the navigate hook, which asserts that the screen
-     *  CALLED something rather than that the user arrived. */
-    location: () => string;
+  /** The live QueryClient, for advanced cache assertions or manual refetch. */
+  queryClient: QueryClient;
+  /** Where the screen has navigated to, as `pathname + search + hash`. The
+   *  alternative is stubbing the navigate hook, which asserts that the screen
+   *  CALLED something rather than that the user arrived. */
+  location: () => string;
 }
 export declare function textFixture(language?: string, messages?: Record<string, LocalizedString>): TextFn;
 export declare function languageWrapper(language?: string, messages?: Record<string, LocalizedString>): ({ children }: {
-    children: ReactNode;
+  children: ReactNode;
 }) => import("react").JSX.Element;
 /** Build a valid Schema from a partial - fills the required empty maps so a
  *  consumer only declares the entities/screens its test needs. */
@@ -86,7 +82,7 @@ export declare function actionResults(map: Record<string, ActionResult>): Record
  * result with a `status` field is never mistaken for an envelope.
  */
 export declare function actionEnvelope(env: Partial<ActionExecuteResponse> & {
-    status: string;
+  status: string;
 }): ActionResult;
 /** Clear every harness seam + the seeded auth state. Auto-registered as an
  *  afterEach when the test runner exposes one (vitest/jest globals); exported
@@ -99,12 +95,12 @@ export declare function cleanupDeclarion(): void;
  */
 export declare function renderWithDeclarion(ui: ReactElement, opts?: RenderWithDeclarionOptions): RenderWithDeclarionResult;
 export interface PreviewHarnessProps extends RenderWithDeclarionOptions {
-    children: ReactNode;
-    /** Default true: seeds an admin user so useSchema's auth gate opens and the
-     *  screen renders authenticated. Set false to render a pre-login screen
-     *  (SignIn / SignUp / Forgot / Reset / TwoFA / AuthShell) in its logged-out
-     *  state, where useSchema stays disabled (no fetch) as in production. */
-    authenticated?: boolean;
+  children: ReactNode;
+  /** Default true: seeds an admin user so useSchema's auth gate opens and the
+   *  screen renders authenticated. Set false to render a pre-login screen
+   *  (SignIn / SignUp / Forgot / Reset / TwoFA / AuthShell) in its logged-out
+   *  state, where useSchema stays disabled (no fetch) as in production. */
+  authenticated?: boolean;
 }
 /**
  * Component form of {@link renderWithDeclarion} for live previews / stories /
@@ -116,3 +112,4 @@ export interface PreviewHarnessProps extends RenderWithDeclarionOptions {
  * once per mount (useState initializer) so a static snapshot is deterministic.
  */
 export declare function PreviewHarness({ children, authenticated, ...opts }: PreviewHarnessProps): ReactElement;
+//#endregion

package/dist-lib/testing.js

@@ -1,18 +1,17 @@
-import { hn as e, r as t, t as n } from "./useCurrentScreen-0WBj7wT6.js";
-import { E as r, p as i, s as a } from "./useText-BsedsJ-J.js";
-import { _ as o, c as s, g as c, v as l } from "./failure-BUxXuP4c.js";
+import { At as e, It as t, Yt as n, _t as r, bt as i, ct as a, gt as o, t as s, vt as c } from "./useCurrentScreen--UovgvRj.js";
+import { t as l } from "./ActionRunner-DAxgnKB3.js";
 import { useState as u } from "react";
-import { MemoryRouter as d, useLocation as f } from "react-router";
-import { QueryClient as p, QueryClientProvider as m } from "@tanstack/react-query";
-import { Toaster as h } from "sonner";
-import { jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { QueryClient as d, QueryClientProvider as f } from "@tanstack/react-query";
+import { jsx as p, jsxs as m } from "react/jsx-runtime";
+import { MemoryRouter as h, useLocation as g } from "react-router";
+import { Toaster as _ } from "sonner";
 import { render as v } from "@testing-library/react";
 //#region src/testing.tsx
-function y(e = "en", t) {
-	return a(t, e, "en");
+function y(t = "en", n) {
+	return e(n, t, "en");
 }
 function b(e = "en", t) {
-	let n = new p({ defaultOptions: { queries: { retry: !1 } } });
+	let n = new d({ defaultOptions: { queries: { retry: !1 } } });
 	return n.setQueryData(["schema", !1], x({
 		language: e,
 		messages: t
@@ -20,7 +19,7 @@ function b(e = "en", t) {
 		language: e,
 		messages: t
 	})), function({ children: e }) {
-		return /* @__PURE__ */ g(m, {
+		return /* @__PURE__ */ p(f, {
 			client: n,
 			children: e
 		});
@@ -76,7 +75,7 @@ function E(e) {
 	};
 }
 function D({ into: e }) {
-	let t = f();
+	let t = g();
 	return e.current = `${t.pathname}${t.search}${t.hash}`, null;
 }
 function O() {
@@ -85,7 +84,7 @@ function O() {
 		code: "test",
 		name: "Test",
 		role: "admin"
-	}, t = {
+	}, n = {
 		id: "test-user",
 		email: "test@example.com",
 		display_name: "Test User",
@@ -96,7 +95,7 @@ function O() {
 		created_at: "2026-01-01T00:00:00Z",
 		updated_at: "2026-01-01T00:00:00Z"
 	};
-	i.getState().setUser(t, e);
+	t.getState().setUser(n, e);
 }
 function k(e) {
 	if (e === void 0) return { rows: [] };
@@ -113,7 +112,7 @@ function k(e) {
 }
 function A(e) {
 	let t = e.entityData ?? {};
-	l((n, r) => {
+	c((n, r) => {
 		let i = r;
 		e.onListRequest?.(n, i);
 		let a = t[n], o = typeof a == "function" ? a(i) : a;
@@ -138,76 +137,76 @@ function A(e) {
 			...s.refs === void 0 ? {} : { $refs: s.refs }
 		};
 	});
-	let n = e.entityItems ?? {}, r = e.entityItemResponses ?? {};
-	o((e, t) => {
-		let i = typeof t == "string" ? t : s(t), a = r[e]?.[i];
-		if (a instanceof Error) throw a;
-		if (a !== void 0) return a;
-		let o = n[e]?.[i];
+	let n = e.entityItems ?? {}, i = e.entityItemResponses ?? {};
+	r((e, t) => {
+		let r = typeof t == "string" ? t : a(t), o = i[e]?.[r];
 		if (o instanceof Error) throw o;
-		return { data: o };
+		if (o !== void 0) return o;
+		let s = n[e]?.[r];
+		if (s instanceof Error) throw s;
+		return { data: s };
 	});
-	let i = e.actionResults ?? {};
-	c(async (e, t) => {
-		if (!(e in i)) throw Error(`renderWithDeclarion: no action result registered for "${e}" (seed it via actionResults)`);
-		let n = i[e];
+	let s = e.actionResults ?? {};
+	o(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 E(typeof n == "function" ? await n(t) : n);
 	});
 }
 function j() {
-	l(null), o(null), c(null), i.setState({
+	c(null), r(null), o(null), t.setState({
 		user: null,
 		isAuthenticated: !1,
 		activeTenant: null,
 		tenants: []
 	});
 }
-function M(i, a = {}) {
-	let o = new p({ defaultOptions: { queries: {
+function M(e, t = {}) {
+	let r = new d({ defaultOptions: { queries: {
 		retry: !1,
 		gcTime: Infinity
 	} } });
-	O(), o.setQueryData(["schema", !0], a.schema ?? x()), A(a);
-	let s = a.screenCode ? /* @__PURE__ */ g(n, {
-		code: a.screenCode,
-		children: i
-	}) : i, c = { current: a.route ?? "/" }, l = /* @__PURE__ */ _(m, {
-		client: o,
-		children: [/* @__PURE__ */ _(d, {
-			initialEntries: [a.route ?? "/"],
-			children: [/* @__PURE__ */ g(D, { into: c }), /* @__PURE__ */ g(t, { children: s })]
-		}), /* @__PURE__ */ g(h, {})]
-	}), u = a.embedQuery ? /* @__PURE__ */ g(r, {
-		query: a.embedQuery,
-		children: l
-	}) : l, f = v(a.viewport ? /* @__PURE__ */ g(e, {
-		viewportOverride: a.viewport,
+	O(), r.setQueryData(["schema", !0], t.schema ?? x()), A(t);
+	let a = t.screenCode ? /* @__PURE__ */ p(s, {
+		code: t.screenCode,
+		children: e
+	}) : e, o = { current: t.route ?? "/" }, c = /* @__PURE__ */ m(f, {
+		client: r,
+		children: [/* @__PURE__ */ m(h, {
+			initialEntries: [t.route ?? "/"],
+			children: [/* @__PURE__ */ p(D, { into: o }), /* @__PURE__ */ p(l, { children: a })]
+		}), /* @__PURE__ */ p(_, {})]
+	}), u = t.embedQuery ? /* @__PURE__ */ p(n, {
+		query: t.embedQuery,
+		children: c
+	}) : c, g = v(t.viewport ? /* @__PURE__ */ p(i, {
+		viewportOverride: t.viewport,
 		children: u
 	}) : u);
-	return Object.assign(f, {
-		queryClient: o,
-		location: () => c.current
+	return Object.assign(g, {
+		queryClient: r,
+		location: () => o.current
 	});
 }
 function N({ children: e, authenticated: n = !0, ...r }) {
-	let [a] = u(() => {
-		let e = new p({ defaultOptions: { queries: {
+	let [i] = u(() => {
+		let e = new d({ defaultOptions: { queries: {
 			retry: !1,
 			gcTime: Infinity
 		} } });
-		return n ? (O(), e.setQueryData(["schema", !0], r.schema ?? x())) : i.setState({
+		return n ? (O(), e.setQueryData(["schema", !0], r.schema ?? x())) : t.setState({
 			user: null,
 			isAuthenticated: !1,
 			activeTenant: null,
 			tenants: []
 		}), A(r), e;
 	});
-	return /* @__PURE__ */ _(m, {
-		client: a,
-		children: [/* @__PURE__ */ g(d, {
+	return /* @__PURE__ */ m(f, {
+		client: i,
+		children: [/* @__PURE__ */ p(h, {
 			initialEntries: [r.route ?? "/"],
-			children: /* @__PURE__ */ g(t, { children: e })
-		}), /* @__PURE__ */ g(h, {})]
+			children: /* @__PURE__ */ p(l, { children: e })
+		}), /* @__PURE__ */ p(_, {})]
 	});
 }
 typeof afterEach == "function" && afterEach(() => j());