@declarion/react 0.19.0 → 0.23.0

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

@@ -1,4 +1,17 @@
-import type { Action, ActionCondition, LocalizedString, Schema } from "../types/schema";
+import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema";
+/**
+ * rowDetailId builds the detail-route id for a row - the value an href's
+ * `${id}` placeholder and a detail screen's `:id` segment receive - addressing
+ * it by the entity's REAL primary key (any single field or a composite key), so
+ * an entity whose PK is not named `id` (e.g. `schedule.code`) resolves correctly
+ * instead of emitting an empty `${id}`. Falls back to a raw `id` lookup only
+ * when no entity is in scope (defensive; an href dispatch always has one) or the
+ * row has no resolvable PK yet (an optimistic placeholder).
+ *
+ * Single source of truth for row -> detail-id, shared by ResponsiveActionBar
+ * (action_layout dispatch) and ActionButton (flat href dispatch).
+ */
+export declare function rowDetailId(row: Record<string, unknown> | undefined, entity: Entity | undefined): string;
 /**
  * Evaluates action conditions against row data.
  * Returns true if the action is available (all conditions pass).

package/dist-lib/testing.d.ts

@@ -1,4 +1,4 @@
-import { type ReactElement } from "react";
+import { type ReactElement, type ReactNode } from "react";
 import { type RenderResult } from "@testing-library/react";
 import { QueryClient } from "@tanstack/react-query";
 import { type ActionExecuteRequest, type ActionExecuteResponse } from "./api/data";
@@ -64,3 +64,21 @@ export declare function cleanupDeclarion(): void;
  * live queryClient.
  */
 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;
+}
+/**
+ * Component form of {@link renderWithDeclarion} for live previews / stories /
+ * Storybook: wraps `children` in the SDK's real providers (QueryClient +
+ * MemoryRouter + ActionRunnerProvider + the Sonner outlet) and seeds the same
+ * read/action seams from props, so an SDK screen renders against fixtures with
+ * no network. Unlike renderWithDeclarion (which calls testing-library's render),
+ * this returns an element you compose directly. Providers + seeds are created
+ * once per mount (useState initializer) so a static snapshot is deterministic.
+ */
+export declare function PreviewHarness({ children, authenticated, ...opts }: PreviewHarnessProps): ReactElement;

package/dist-lib/testing.js

@@ -1,11 +1,12 @@
-import { Pt as e, ct as t, lt as n, t as r, tt as i, ut as a } from "./ActionRunner-F1HBBKyQ.js";
-import { MemoryRouter as o } from "react-router-dom";
-import { QueryClient as s, QueryClientProvider as c } from "@tanstack/react-query";
-import { Toaster as l } from "sonner";
-import { jsx as u, jsxs as d } from "react/jsx-runtime";
-import { render as f } from "@testing-library/react";
+import { Pt as e, ct as t, lt as n, t as r, tt as i, ut as a } from "./ActionRunner-C2A73D9b.js";
+import { useState as o } from "react";
+import { MemoryRouter as s } from "react-router-dom";
+import { QueryClient as c, QueryClientProvider as l } from "@tanstack/react-query";
+import { Toaster as u } from "sonner";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
+import { render as p } from "@testing-library/react";
 //#region src/testing.tsx
-function p(e = {}) {
+function m(e = {}) {
 	return {
 		languages: [],
 		structures: {},
@@ -18,7 +19,7 @@ function p(e = {}) {
 		...e
 	};
 }
-function m(e, t = {}, n) {
+function h(e, t = {}, n) {
 	return {
 		data: e,
 		meta: {
@@ -32,27 +33,27 @@ function m(e, t = {}, n) {
 		...n === void 0 ? {} : { $refs: n }
 	};
 }
-function h(e) {
+function g(e) {
 	return e;
 }
-var g = Symbol("declarion.testing.actionEnvelope");
-function _(e) {
+var _ = Symbol("declarion.testing.actionEnvelope");
+function v(e) {
 	return {
 		...e,
-		[g]: !0
+		[_]: !0
 	};
 }
-function v(e) {
-	if (e && typeof e == "object" && e[g]) {
+function y(e) {
+	if (e && typeof e == "object" && e[_]) {
 		let t = { ...e };
-		return delete t[g], t;
+		return delete t[_], t;
 	}
 	return {
 		status: "success",
 		result: e
 	};
 }
-function y() {
+function b() {
 	let t = {
 		id: "test-tenant",
 		code: "test",
@@ -71,7 +72,7 @@ function y() {
 	};
 	e.getState().setUser(n, t);
 }
-function b(e) {
+function x(e) {
 	if (e === void 0) return { rows: [] };
 	if (Array.isArray(e)) return { rows: e };
 	if (Array.isArray(e.data)) {
@@ -84,10 +85,10 @@ function b(e) {
 	}
 	return e;
 }
-function x(e) {
+function S(e) {
 	let r = e.entityData ?? {};
 	a((e, t) => {
-		let n = r[e], i = b(n), a = i.meta?.per_page ?? 50, o = i.meta?.total ?? i.rows.length;
+		let n = r[e], i = x(n), a = i.meta?.per_page ?? 50, o = i.meta?.total ?? i.rows.length;
 		return t.count === "only" ? {
 			data: [],
 			meta: {
@@ -116,10 +117,10 @@ function x(e) {
 	t(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 v(typeof n == "function" ? await n(t) : n);
+		return y(typeof n == "function" ? await n(t) : n);
 	});
 }
-function S() {
+function C() {
 	a(null), n(null), t(null), e.setState({
 		user: null,
 		isAuthenticated: !1,
@@ -127,21 +128,42 @@ function S() {
 		tenants: []
 	});
 }
-function C(e, t = {}) {
-	let n = new s({ defaultOptions: { queries: {
+function w(e, t = {}) {
+	let n = new c({ defaultOptions: { queries: {
 		retry: !1,
 		gcTime: Infinity
 	} } });
-	y(), n.setQueryData(["schema", !0], t.schema ?? p()), x(t);
-	let i = f(/* @__PURE__ */ d(c, {
+	b(), n.setQueryData(["schema", !0], t.schema ?? m()), S(t);
+	let i = p(/* @__PURE__ */ f(l, {
 		client: n,
-		children: [/* @__PURE__ */ u(o, {
+		children: [/* @__PURE__ */ d(s, {
 			initialEntries: [t.route ?? "/"],
-			children: /* @__PURE__ */ u(r, { children: e })
-		}), /* @__PURE__ */ u(l, {})]
+			children: /* @__PURE__ */ d(r, { children: e })
+		}), /* @__PURE__ */ d(u, {})]
 	}));
 	return Object.assign(i, { queryClient: n });
 }
-typeof afterEach == "function" && afterEach(() => S());
+function T({ children: t, authenticated: n = !0, ...i }) {
+	let [a] = o(() => {
+		let t = new c({ defaultOptions: { queries: {
+			retry: !1,
+			gcTime: Infinity
+		} } });
+		return n ? (b(), t.setQueryData(["schema", !0], i.schema ?? m())) : e.setState({
+			user: null,
+			isAuthenticated: !1,
+			activeTenant: null,
+			tenants: []
+		}), S(i), t;
+	});
+	return /* @__PURE__ */ f(l, {
+		client: a,
+		children: [/* @__PURE__ */ d(s, {
+			initialEntries: [i.route ?? "/"],
+			children: /* @__PURE__ */ d(r, { children: t })
+		}), /* @__PURE__ */ d(u, {})]
+	});
+}
+typeof afterEach == "function" && afterEach(() => C());
 //#endregion
-export { _ as actionEnvelope, h as actionResults, S as cleanupDeclarion, m as entityDataFixture, C as renderWithDeclarion, p as schemaFixture };
+export { T as PreviewHarness, v as actionEnvelope, g as actionResults, C as cleanupDeclarion, h as entityDataFixture, w as renderWithDeclarion, m as schemaFixture };

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

@@ -384,6 +384,7 @@ export declare function extractPkValues(entity: Entity, record: Record<string, u
 export declare function pkValuePartsToId(values: string[]): string;
 export declare function pkValuesToId(pkValues: PkValues): string;
 export declare function pkValuesToDetailId(entity: Entity, pkValues: PkValues): string;
+export declare function singlePkValues(entity: Entity, value: string): PkValues | undefined;
 export declare function pkValuesFromId(id: string, expectedCount: number): string[] | null;
 export declare function resolveDetailRoute(list: Pick<Screen, "detail_screen"> | undefined, entity: Pick<Entity, "detail_screen"> | undefined, allScreens: Record<string, {
     route?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.19.0",
+  "version": "0.23.0",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",
@@ -41,9 +41,9 @@
     "access": "public"
   },
   "peerDependencies": {
+    "@testing-library/react": "^16.3.0",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@testing-library/react": "^16.3.0"
+    "react-dom": "^19.0.0"
   },
   "peerDependenciesMeta": {
     "@testing-library/react": {
@@ -68,11 +68,11 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.4.0",
-    "lucide-react": "^1.18.0",
+    "lucide-react": "^1.21.0",
     "mdast-util-to-string": "^4.0.0",
     "monaco-editor": "^0.55.1",
     "react-markdown": "^10.1.0",
-    "react-router-dom": "^7.17.0",
+    "react-router-dom": "^7.18.0",
     "react-textarea-autosize": "^8.5.9",
     "recharts": "^3.8.1",
     "remark-breaks": "^4.0.0",
@@ -107,7 +107,7 @@
     "tailwindcss": "^4.3.1",
     "tsc-alias": "^1.8.17",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.1",
+    "typescript-eslint": "^8.62.0",
     "vite": "^8.0.16",
     "vitest": "^4.1.9"
   },