@declarion/react 0.44.0 → 0.47.0

package/dist-lib/testing.js

@@ -1,4 +1,4 @@
-import { Dt as e, Et as t, Ot as n, er as r, jt as i, r as a, t as o, yt as s } from "./useCurrentScreen-CpQjVmrT.js";
+import { Dt as e, Et as t, Ot as n, jt as r, r as i, t as a, tr as o, yt as s } from "./useCurrentScreen-ow4r-nWa.js";
 import { useState as c } from "react";
 import { MemoryRouter as l } from "react-router";
 import { QueryClient as u, QueryClientProvider as d } from "@tanstack/react-query";
@@ -70,7 +70,7 @@ function S() {
 		created_at: "2026-01-01T00:00:00Z",
 		updated_at: "2026-01-01T00:00:00Z"
 	};
-	i.getState().setUser(t, e);
+	r.getState().setUser(t, e);
 }
 function C(e) {
 	if (e === void 0) return { rows: [] };
@@ -125,7 +125,7 @@ function w(r) {
 	});
 }
 function T() {
-	n(null), e(null), t(null), i.setState({
+	n(null), e(null), t(null), r.setState({
 		user: null,
 		isAuthenticated: !1,
 		activeTenant: null,
@@ -138,28 +138,28 @@ function E(e, t = {}) {
 		gcTime: Infinity
 	} } });
 	S(), n.setQueryData(["schema", !0], t.schema ?? g()), w(t);
-	let i = t.screenCode ? /* @__PURE__ */ p(o, {
+	let r = t.screenCode ? /* @__PURE__ */ p(a, {
 		code: t.screenCode,
 		children: e
 	}) : e, s = /* @__PURE__ */ m(d, {
 		client: n,
 		children: [/* @__PURE__ */ p(l, {
 			initialEntries: [t.route ?? "/"],
-			children: /* @__PURE__ */ p(a, { children: i })
+			children: /* @__PURE__ */ p(i, { children: r })
 		}), /* @__PURE__ */ p(f, {})]
-	}), c = h(t.viewport ? /* @__PURE__ */ p(r, {
+	}), c = h(t.viewport ? /* @__PURE__ */ p(o, {
 		viewportOverride: t.viewport,
 		children: s
 	}) : s);
 	return Object.assign(c, { queryClient: n });
 }
 function D({ children: e, authenticated: t = !0, ...n }) {
-	let [r] = c(() => {
+	let [a] = c(() => {
 		let e = new u({ defaultOptions: { queries: {
 			retry: !1,
 			gcTime: Infinity
 		} } });
-		return t ? (S(), e.setQueryData(["schema", !0], n.schema ?? g())) : i.setState({
+		return t ? (S(), e.setQueryData(["schema", !0], n.schema ?? g())) : r.setState({
 			user: null,
 			isAuthenticated: !1,
 			activeTenant: null,
@@ -167,10 +167,10 @@ function D({ children: e, authenticated: t = !0, ...n }) {
 		}), w(n), e;
 	});
 	return /* @__PURE__ */ m(d, {
-		client: r,
+		client: a,
 		children: [/* @__PURE__ */ p(l, {
 			initialEntries: [n.route ?? "/"],
-			children: /* @__PURE__ */ p(a, { children: e })
+			children: /* @__PURE__ */ p(i, { children: e })
 		}), /* @__PURE__ */ p(f, {})]
 	});
 }

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

@@ -1,5 +1,6 @@
 import type { AccentDef, LocalizedString } from "./schema";
 import type { HydratedFile } from "./files";
+import type { FilterNode } from "../lib/filters";
 export interface ListMeta {
     /**
      * Total matching rows. Present only when the request asked for a count
@@ -390,7 +391,7 @@ export interface ListParams {
     sort?: string;
     search?: string;
     /** JSON filter nodes (recursive AND/OR tree). */
-    filters?: FilterNodeParam[];
+    filters?: FilterNode[];
     include_deleted?: boolean;
     expand?: string[];
     screen?: string;
@@ -414,14 +415,6 @@ export interface ListParams {
      */
     count?: "window" | "only" | "with" | "exact";
 }
-/** Minimal filter node type for API params (matches backend FilterNode). */
-export interface FilterNodeParam {
-    field?: string;
-    op?: string;
-    value?: unknown;
-    or?: FilterNodeParam[][];
-    and?: FilterNodeParam[];
-}
 /** Cursor-based pagination metadata returned by v2 List. */
 export interface V2Meta {
     total: number;
@@ -492,7 +485,7 @@ export interface V2ListParams {
     expand?: string[];
     sort?: string;
     search?: string;
-    filters?: FilterNodeParam[];
+    filters?: FilterNode[];
     limit?: number;
     after?: string;
     include_deleted?: boolean;

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

@@ -1,6 +1,7 @@
 import { OrderedMap } from "./ordmap";
 import type { FileFieldDef } from "./files";
 import type { IconDef } from "../stores/icon-registry";
+import type { FilterNode } from "../lib/filters";
 export { OrderedMap };
 export type { IconDef };
 export type LocalizedString = Record<string, string>;
@@ -55,15 +56,6 @@ export declare function fieldDisplayName(field: EntityField, fieldName: string,
 export interface RefDisplay {
     field: string;
 }
-/** A single declarative filter condition ({field, op, value}). Shared by
- *  ViewDefinition.filters (screen views) and RefConfig.options_filter (ref
- *  dropdown option narrowing); mirrors engine.ViewFilter. Structurally a subset
- *  of the wire FilterNodeParam, so it can feed a list query's `filters`. */
-export interface FilterCondition {
-    field: string;
-    op: string;
-    value?: unknown;
-}
 export interface RefConfig {
     entity: string;
     field?: string;
@@ -71,9 +63,10 @@ export interface RefConfig {
     fields?: string[];
     /** Narrows the option set offered by this ref's entity-select dropdown (edit
      *  combobox or action-param picker) to rows matching these conditions - e.g.
-     *  only `is_active = true`. Read-side only (not a write/security boundary);
-     *  mirrors engine RefConfig.OptionsFilter. */
-    options_filter?: FilterCondition[];
+     *  only `is_active = true`. Read-side only (not a write/security boundary).
+     *  The shared filter tree, so a declared narrowing takes the same shapes a
+     *  list query's `filters` takes. */
+    options_filter?: FilterNode[];
 }
 /** One declared filter-only option ({code, label}). `code` is stored into the
  *  filter when chosen (a literal or a `$user.*` token resolved server-side);
@@ -318,6 +311,11 @@ export interface EntityMutations {
     delete?: boolean;
     restore?: boolean;
 }
+export interface EntityVariant {
+    name?: string;
+    when?: FilterNode[];
+    actions?: string[];
+}
 /** A set of CRUD op flags, each present or absent. The YAML-decoded shape of
  *  an entity's `public` opt-out block (deny-by-default authorization, plan
  *  2026-06-17). A flag being true means that op is open to ALL authenticated
@@ -368,6 +366,17 @@ export interface Entity {
     properties?: Record<string, PropertyDef>;
     search_fields?: string[];
     actions?: Record<string, Action>;
+    variants?: OrderedMap<EntityVariant>;
+    /**
+     * Platform-default action codes the engine must NOT inject for this entity
+     * (`__new`, `__edit`, `__create`, ...). Declared in the entity's YAML.
+     *
+     * A disabled `__new` closes the CREATE ROUTE too, not only the toolbar
+     * button: `<list>/new` is the detail route with the literal id `new`, so
+     * without this the form the removed button pointed at still rendered for
+     * anyone who typed the address or kept a bookmark.
+     */
+    disable_defaults?: string[];
     handlers?: Record<string, HandlerDef>;
     associations?: Record<string, AssociationDef>;
     files?: OrderedMap<FileFieldDef>;
@@ -475,6 +484,7 @@ export interface ExportConfig {
     enabled?: boolean;
 }
 export declare function entityAllowsMutation(entity: Pick<Entity, "readonly" | "mutations"> | undefined, op: EntityMutationOp): boolean;
+export declare function entityAllowsCreateRoute(entity: Pick<Entity, "disable_defaults"> | undefined): boolean;
 export declare function getPrimaryKeyFields(entity: Entity): string[];
 export type PkValues = Record<string, string>;
 export declare function extractPkValues(entity: Entity, record: Record<string, unknown>): PkValues;
@@ -536,6 +546,7 @@ export interface WidgetNode {
 export interface LayoutField {
     name: string;
     actions?: Action[];
+    structure?: string;
 }
 export interface LayoutNode {
     row?: RowConfig;
@@ -614,6 +625,20 @@ export interface ScreenResponsiveViewport {
     detail?: ResponsiveDetailBranch;
 }
 export type ScreenResponsive = Partial<Record<ViewportKey, ScreenResponsiveViewport>>;
+export interface ScreenVariant {
+    name?: string;
+    when?: FilterNode[];
+    items?: LayoutNode[];
+    sidebar?: LayoutNode[];
+    sidebar_width?: string;
+    highlights?: string[];
+    audit?: AuditConfig;
+    actions?: string[];
+    row_actions?: string[];
+    action_layout?: ActionLayoutNode[];
+    card?: CardSpec;
+    quick_peek?: QuickPeekConfig;
+}
 export interface Screen {
     type: "list" | "detail" | "custom" | "record_list";
     entity?: string;
@@ -647,6 +672,7 @@ export interface Screen {
     sort_default?: string;
     actions?: string[];
     row_actions?: string[];
+    variants?: OrderedMap<ScreenVariant>;
     items?: LayoutNode[];
     sidebar?: LayoutNode[];
     sidebar_width?: string;
@@ -661,7 +687,19 @@ export interface Screen {
      *  field code. Append/replace/clear the entity field's declared values for
      *  just this screen. Mirrors engine.Screen.FilterSpecialValues. */
     filter_special_values?: Record<string, ScreenFilterSpecialValues>;
+    /** Per-field operator lists, keyed by filter field code, published by the
+     *  server from the ONE vocabulary the query builder enforces
+     *  (engine.OperatorsByFieldType, plus the $status / $property sets). The
+     *  filter drawer renders exactly these; it keeps no table of its own,
+     *  because a client-side guess had already diverged - array, multilang,
+     *  json and bytes fields were offered two operators the builder rejects
+     *  and denied `contains`, the one that works. */
+    filter_operators?: Record<string, string[]>;
     views?: ViewDefinition[];
+    /** Code of the view this list OPENS on. A starting point, never a bound: the
+     *  switcher still offers every other view and the unfiltered "All", and a
+     *  viewer's own default view wins over it. */
+    default_view?: string;
     /** Action slot promotion for list screens (rule-of-2). UI honors first 2.
      *  Note: primary_record_actions (detail header) was removed in Task 5 of plan
      *  2026-04-21-action-toolbar-priority-overflow. Use action_layout instead. */
@@ -720,7 +758,7 @@ export interface ViewDefinition {
     name: LocalizedString;
     description?: LocalizedString;
     icon?: string;
-    filters?: FilterCondition[];
+    filters?: FilterNode[];
     columns?: string[];
     sort?: string;
 }