@declarion/react 0.23.0 → 0.25.0

package/dist-lib/{DraggableChildrenTable-CzbVcMu7.js → DraggableChildrenTable-ByuH27zv.js}

@@ -1,5 +1,5 @@
 import { s as e } from "./DynamicIcon-DCRdxxZ7.js";
-import { Dn as t, gn as n, m as r, nr as i, p as a, tr as o } from "./ActionRunner-C2A73D9b.js";
+import { ar as t, jn as n, m as r, or as i, p as a, yn as o } from "./ActionRunner-eixtbT5K.js";
 import { n as s, r as c, t as l } from "./dataTableStyles-vwD1mVOP.js";
 import { useCallback as u, useMemo as d, useRef as f } from "react";
 import { jsx as p, jsxs as m } from "react/jsx-runtime";
@@ -7,65 +7,65 @@ import { DndContext as h, PointerSensor as g, closestCenter as _, useSensor as v
 import { SortableContext as b, useSortable as x, verticalListSortingStrategy as S } from "@dnd-kit/sortable";
 import { CSS as C } from "@dnd-kit/utilities";
 //#region src/components/detail-layout/DraggableChildrenTable.tsx
-function w({ config: t, childEntity: r, schema: a, rows: o, onChange: l, validationErrors: x, refs: C }) {
+function w({ config: t, childEntity: n, schema: r, rows: a, onChange: l, validationErrors: x, refs: C }) {
 	let w = f(null), E = t.position_field, D = t.columns, O = y(v(g, { activationConstraint: { distance: 5 } })), k = new Set(Array.isArray(t.foreign_key) ? t.foreign_key : [t.foreign_key]), A = D.filter((e) => {
 		if (k.has(e) || e === E) return !1;
-		let t = r.fields.get(e);
+		let t = n.fields.get(e);
 		return !(!t || t.auto || t.primary || t.source);
 	}), j = new Set(D.filter((e) => {
 		if (e === E) return !0;
-		let t = r.fields.get(e);
+		let t = n.fields.get(e);
 		return t && (t.auto || t.primary || t.source);
-	})), M = D.filter((e) => e !== E), N = d(() => o.filter((e) => !e._deleted).map((e) => e._key), [o]), P = u((e, t, n) => {
-		l(o.map((r) => r._key === e ? {
+	})), M = D.filter((e) => e !== E), N = d(() => a.filter((e) => !e._deleted).map((e) => e._key), [a]), P = u((e, t, n) => {
+		l(a.map((r) => r._key === e ? {
 			...r,
 			[t]: n,
 			_dirty: !0
 		} : r));
-	}, [o, l]), F = u(() => {
-		let e = o.filter((e) => !e._deleted).reduce((e, t) => {
+	}, [a, l]), F = u(() => {
+		let e = a.filter((e) => !e._deleted).reduce((e, t) => {
 			let n = typeof t[E] == "number" ? t[E] : -1;
 			return Math.max(e, n);
-		}, -1), n = {
+		}, -1), r = {
 			_key: crypto.randomUUID(),
 			_dirty: !0,
 			[E]: e + 1
 		}, i = t.quick_add?.defaults ?? {};
 		for (let e of A) {
-			let t = r.fields.get(e);
-			t && (i[e] === void 0 ? t.default === void 0 ? t.type === "bool" && (n[e] = !1) : n[e] = t.default : n[e] = i[e]);
+			let t = n.fields.get(e);
+			t && (i[e] === void 0 ? t.default === void 0 ? t.type === "bool" && (r[e] = !1) : r[e] = t.default : r[e] = i[e]);
 		}
-		l([...o, n]);
+		l([...a, r]);
 	}, [
-		o,
+		a,
 		l,
 		A,
-		r,
+		n,
 		t.quick_add?.defaults,
 		E
 	]), I = u((e) => {
-		l(o.map((t) => t._key === e ? {
+		l(a.map((t) => t._key === e ? {
 			...t,
 			_deleted: !0
 		} : t));
-	}, [o, l]), L = u((e) => {
-		l(o.map((t) => t._key === e ? {
+	}, [a, l]), L = u((e) => {
+		l(a.map((t) => t._key === e ? {
 			...t,
 			_deleted: !1
 		} : t));
-	}, [o, l]), R = u((e) => {
+	}, [a, l]), R = u((e) => {
 		let { active: t, over: n } = e;
 		if (!n || t.id === n.id) return;
-		let r = o.filter((e) => !e._deleted), i = o.filter((e) => e._deleted), a = r.findIndex((e) => e._key === String(t.id)), s = r.findIndex((e) => e._key === String(n.id));
-		if (a === -1 || s === -1) return;
-		let c = [...r], [u] = c.splice(a, 1);
+		let r = a.filter((e) => !e._deleted), i = a.filter((e) => e._deleted), o = r.findIndex((e) => e._key === String(t.id)), s = r.findIndex((e) => e._key === String(n.id));
+		if (o === -1 || s === -1) return;
+		let c = [...r], [u] = c.splice(o, 1);
 		c.splice(s, 0, u), l([...c.map((e, t) => ({
 			...e,
 			[E]: t,
 			_dirty: e[E] === t ? e._dirty : !0
 		})), ...i]);
 	}, [
-		o,
+		a,
 		l,
 		E
 	]), z = u((e) => {
@@ -118,10 +118,10 @@ function w({ config: t, childEntity: r, schema: a, rows: o, onChange: l, validat
 						padding: "0 4px"
 					} }),
 					M.map((e) => {
-						let t = r.fields.get(e);
+						let t = n.fields.get(e);
 						return /* @__PURE__ */ p("th", {
 							style: B,
-							children: t ? n(t, e, a.entities) : e
+							children: t ? o(t, e, r.entities) : e
 						}, e);
 					}),
 					/* @__PURE__ */ p("th", { style: {
@@ -131,12 +131,12 @@ function w({ config: t, childEntity: r, schema: a, rows: o, onChange: l, validat
 				] }) }), /* @__PURE__ */ p(b, {
 					items: N,
 					strategy: S,
-					children: /* @__PURE__ */ p("tbody", { children: o.map((e) => /* @__PURE__ */ p(T, {
+					children: /* @__PURE__ */ p("tbody", { children: a.map((e) => /* @__PURE__ */ p(T, {
 						row: e,
 						columns: M,
 						editableColumns: A,
 						displayOnlyColumns: j,
-						childEntity: r,
+						childEntity: n,
 						validationErrors: x,
 						refs: C,
 						onCellChange: P,
@@ -157,9 +157,9 @@ function w({ config: t, childEntity: r, schema: a, rows: o, onChange: l, validat
 		})
 	})] });
 }
-function T({ row: n, columns: i, editableColumns: s, displayOnlyColumns: c, childEntity: u, validationErrors: d, refs: f, onCellChange: h, onDelete: g, onUndoDelete: _ }) {
-	let v = a(), y = !!n._deleted, b = d?.[n._key], { attributes: S, listeners: w, setNodeRef: T, transform: E, transition: D, isDragging: O } = x({
-		id: n._key,
+function T({ row: i, columns: o, editableColumns: s, displayOnlyColumns: c, childEntity: u, validationErrors: d, refs: f, onCellChange: h, onDelete: g, onUndoDelete: _ }) {
+	let v = a(), y = !!i._deleted, b = d?.[i._key], { attributes: S, listeners: w, setNodeRef: T, transform: E, transition: D, isDragging: O } = x({
+		id: i._key,
 		disabled: y
 	}), k = {
 		transform: C.Translate.toString(E),
@@ -200,22 +200,22 @@ function T({ row: n, columns: i, editableColumns: s, displayOnlyColumns: c, chil
 					children: /* @__PURE__ */ p(e.grid, { size: 14 })
 				})
 			}),
-			i.map((e) => {
-				let i = u.fields.get(e), a = b?.includes(e), o = c.has(e), l = s.includes(e);
+			o.map((e) => {
+				let t = u.fields.get(e), a = b?.includes(e), o = c.has(e), l = s.includes(e);
 				return y || o || !l ? /* @__PURE__ */ p("td", {
 					style: {
 						...A,
 						textDecoration: y ? "line-through" : "none"
 					},
-					children: i ? r({
-						field: i,
+					children: t ? r({
+						field: t,
 						fieldName: e,
-						value: n[e],
+						value: i[e],
 						mode: "display",
-						record: n,
+						record: i,
 						refs: f,
 						locale: v
-					}) : t(n[e])
+					}) : n(i[e])
 				}, e) : /* @__PURE__ */ p("td", {
 					style: {
 						...j,
@@ -224,16 +224,16 @@ function T({ row: n, columns: i, editableColumns: s, displayOnlyColumns: c, chil
 						borderRadius: a ? 4 : 0
 					},
 					title: a ? `${e} is required` : void 0,
-					children: i ? r({
-						field: i,
+					children: t ? r({
+						field: t,
 						fieldName: e,
-						value: n[e],
+						value: i[e],
 						mode: "edit",
-						onChange: (t) => h(n._key, e, t),
-						record: n,
+						onChange: (t) => h(i._key, e, t),
+						record: i,
 						refs: f,
 						locale: v
-					}) : t(n[e])
+					}) : n(i[e])
 				}, e);
 			}),
 			/* @__PURE__ */ p("td", {
@@ -242,15 +242,15 @@ function T({ row: n, columns: i, editableColumns: s, displayOnlyColumns: c, chil
 					borderBottom: "1px solid var(--divider)",
 					verticalAlign: "middle"
 				},
-				children: y ? /* @__PURE__ */ p(o, {
+				children: y ? /* @__PURE__ */ p(t, {
 					size: 24,
 					icon: /* @__PURE__ */ p(e.refresh, { size: 12 }),
-					onClick: () => _(n._key),
+					onClick: () => _(i._key),
 					title: "Undo delete"
-				}) : /* @__PURE__ */ p(o, {
+				}) : /* @__PURE__ */ p(t, {
 					size: 24,
 					icon: /* @__PURE__ */ p(e.trash, { size: 12 }),
-					onClick: () => g(n._key),
+					onClick: () => g(i._key),
 					title: "Delete row"
 				})
 			})

package/dist-lib/{Grid-8k-ysclX.js → Grid-hWuSXZWA.js}

@@ -1,4 +1,4 @@
-import { D as e, E as t, F as n, I as r, L as i, M as a, R as o, j as s, k as c, z as l } from "./ActionRunner-C2A73D9b.js";
+import { D as e, E as t, F as n, I as r, L as i, M as a, R as o, j as s, k as c, z as l } from "./ActionRunner-eixtbT5K.js";
 import { useCallback as u, useEffect as d, useMemo as f, useRef as p, useState as m } from "react";
 import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
 import { DndContext as v, PointerSensor as y, closestCenter as b, useSensor as x, useSensors as ee } from "@dnd-kit/core";

package/dist-lib/{MarkdownRenderer--n1GTrwy.js → MarkdownRenderer-x-5sbiRs.js}

@@ -1,4 +1,4 @@
-import { U as e } from "./ActionRunner-C2A73D9b.js";
+import { U as e } from "./ActionRunner-eixtbT5K.js";
 import { jsx as t, jsxs as n } from "react/jsx-runtime";
 import r, { defaultUrlTransform as i } from "react-markdown";
 import a from "remark-breaks";

package/dist-lib/components/fields/RefCombobox.d.ts

@@ -0,0 +1,45 @@
+import type { RefConfig, FilterSpecialValue } from "../../types/schema";
+import type { Refs } from "../../types/api";
+export interface RefComboboxProps {
+    /** Structured ref configuration (entity, optional lookup field, display). */
+    ref: RefConfig | undefined;
+    /** Current stored ref target value (the `ref.field` value, or target PK). */
+    value: unknown;
+    onChange: (value: string | null) => void;
+    /**
+     * Server-embedded `$refs` enrichment map, keyed by the stored ref value.
+     * Used to label the current selection when it is outside the loaded page.
+     */
+    refs?: Refs;
+    /** FieldDisplay-level display override (`field.display.ref_display_field`). */
+    displayFieldOverride?: string;
+    id?: string;
+    labelId?: string;
+    /** Accessible name when there is no associated <label> (e.g. the filter editor). */
+    ariaLabel?: string;
+    required?: boolean;
+    placeholder?: string;
+    /** Filter-only declared options (e.g. "Myself" -> $user.id) rendered as a
+     *  "Special values" group above the relation results. Selecting one stores its
+     *  `code` verbatim (a `$user.*` token is NOT resolved locally). Filter use only. */
+    specialValues?: FilterSpecialValue[];
+}
+/**
+ * RefCombobox is the ONE relation picker shared by every surface that selects a
+ * referenced record: SmartDetailPage create/edit ref fields, the list filter
+ * value editor, ActionDialog `type: ref` params, and inline-edit table ref
+ * cells. It loads a bounded page of accessible referenced rows through the
+ * normal data API (so RBAC/ABAC/tenant scoping all apply) and labels them via
+ * the canonical ref-label resolver.
+ *
+ * It stores the RESOLVED ref target value: `ref.field` when declared, otherwise
+ * the target entity's primary-key object id. (The legacy per-surface code stored
+ * the PK unconditionally and ignored `ref.field`.)
+ *
+ * Typed search hits the SERVER (debounced 300ms, via the `?search=` API over the
+ * entity's search fields), so a record past the bounded first page is findable;
+ * the `Select` primitive runs in server mode (`onSearchChange`) and renders the
+ * returned options without re-filtering them client-side. An empty search loads
+ * the default sorted page.
+ */
+export declare function RefCombobox({ ref: refConfig, value, onChange, refs, displayFieldOverride, id, labelId, ariaLabel, required, placeholder, specialValues, }: RefComboboxProps): import("react").JSX.Element;

package/dist-lib/components/filters/FilterChips.d.ts

@@ -1,10 +1,14 @@
-import { type FilterNode } from "../../lib/filters";
+import { type FilterNode, type FilterValueResolver } from "../../lib/filters";
 interface FilterChipsProps {
     filters: FilterNode[];
     onRemove: (field: string) => void;
     onClearAll: () => void;
     onChipClick?: () => void;
     fieldLabel?: (field: string) => string;
+    /** Humanizes each chip VALUE (special -> label, enum/status -> label, ref ->
+     *  record label, with a skeleton while a ref label loads). Absent -> raw
+     *  values, so FilterChips stays usable standalone / in tests. */
+    resolveValue?: FilterValueResolver;
 }
-export declare function FilterChips({ filters, onRemove, onClearAll, onChipClick, fieldLabel, }: FilterChipsProps): import("react").JSX.Element | null;
+export declare function FilterChips({ filters, onRemove, onClearAll, onChipClick, fieldLabel, resolveValue, }: FilterChipsProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/filters/FilterDrawer.d.ts

@@ -1,4 +1,6 @@
 import { type FilterNode, type FilterOp } from "../../lib/filters";
+import type { RefConfig, FilterSpecialValue } from "../../types/schema";
+import type { Refs } from "../../types/api";
 export interface FilterFieldMeta {
     code: string;
     label: string;
@@ -9,6 +11,8 @@ export interface FilterFieldMeta {
         label: string;
         color?: string;
     }[];
+    ref?: RefConfig;
+    specialValues?: FilterSpecialValue[];
 }
 interface FilterDrawerProps {
     open: boolean;
@@ -16,6 +20,13 @@ interface FilterDrawerProps {
     filters: FilterNode[];
     onApply: (filters: FilterNode[]) => void;
     availableFields: FilterFieldMeta[];
+    /** Screen `default_filters`: field codes pre-seeded as empty-valued rows when
+     *  the panel opens with no active filters. Never pre-applies a value. */
+    defaultFilters?: string[];
+    /** Shared resolved-ref map (from the list page's filter-value resolver),
+     *  passed to each ref editor's RefCombobox so it labels the selected value
+     *  from this cache instead of firing its own per-value hydration fetch. */
+    refs?: Refs;
 }
-export declare function FilterDrawer({ open, onClose, filters, onApply, availableFields, }: FilterDrawerProps): import("react").JSX.Element | null;
+export declare function FilterDrawer({ open, onClose, filters, onApply, availableFields, defaultFilters, refs, }: FilterDrawerProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/pages/list/filter-meta.d.ts

@@ -1,9 +1,10 @@
-import type { Entity } from "../../../types/schema";
+import type { Entity, ScreenFilterSpecialValues } from "../../../types/schema";
 import type { FilterFieldMeta } from "../../../components/filters/FilterDrawer";
 import type { FilterOp } from "../../../lib/filters";
 /** Build FilterFieldMeta array from screen + entity for the FilterDrawer. */
 export declare function buildFilterFieldMeta(screen: {
     filters?: string[];
+    filter_special_values?: Record<string, ScreenFilterSpecialValues>;
 } | undefined, entity: Pick<Entity, "fields" | "status_groups" | "properties"> | undefined, entities?: Record<string, Entity>): FilterFieldMeta[];
 /** Map field type to available filter operators. */
 export declare function fieldTypeToOperators(type: string): FilterOp[];

package/dist-lib/components/pages/list/use-filter-value-labels.d.ts

@@ -0,0 +1,24 @@
+import { type FilterNode, type FilterValueResolver } from "../../../lib/filters";
+import type { Entity } from "../../../types/schema";
+import type { FilterFieldMeta } from "../../../components/filters/FilterDrawer";
+import type { Refs } from "../../../types/api";
+/**
+ * useFilterValueLabels - the single source of human labels for stored filter
+ * values, shared by the chip strip and the filter drawer's RefCombobox.
+ *
+ * Per value it resolves, in order: a declared special value (code -> label,
+ * synchronous), an enum/$status code (code -> label from the field's options,
+ * synchronous), a ref (value -> referenced record label, from the list `$refs`
+ * or a batched fetch), else a plain literal (rendered raw). Refs absent from
+ * `$refs` are fetched in ONE `in` query per referenced entity through the
+ * normal read API; identical queries dedupe in the query cache, so switching a
+ * view or reopening the drawer does not re-fetch a label already in hand.
+ *
+ * Returns `labelFor` (consumed by the chip strip) and a `Refs`-shaped map of
+ * resolved records (passed to the drawer's RefCombobox via its `refs` prop, so
+ * the combobox reuses this cache instead of its own per-value hydration).
+ */
+export declare function useFilterValueLabels(meta: FilterFieldMeta[], filters: FilterNode[], listRefs: Refs | undefined, entities: Record<string, Entity> | undefined): {
+    labelFor: FilterValueResolver;
+    refs: Refs;
+};

package/dist-lib/components/primitives/Fields.d.ts

@@ -27,14 +27,24 @@ export declare function TextArea({ value, onChange, placeholder, rows, fill, id,
 export type SelectOption = {
     value: string;
     label: ReactNode;
+    heading?: boolean;
+    divider?: boolean;
 };
 export type SelectProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "value" | "onChange"> & {
     value?: string;
     options: SelectOption[];
     onChange: (v: string) => void;
     placeholder?: string;
+    /**
+     * Server-search mode. When set, the typed query is reported here (instead of
+     * filtering the options client-side) so the parent can fetch matching
+     * options from the server; the dropdown renders the given `options` as-is.
+     * The search input is always shown in this mode. Absent -> client-side
+     * filtering over `options`, as before.
+     */
+    onSearchChange?: (query: string) => void;
 };
-export declare function Select({ value, options, onChange, placeholder, ...rest }: SelectProps): import("react").JSX.Element;
+export declare function Select({ value, options, onChange, placeholder, onSearchChange, ...rest }: SelectProps): import("react").JSX.Element;
 export type DateInputProps = {
     value?: string | null;
     onChange?: (v: string) => void;

package/dist-lib/hooks/useCursorEntityData.d.ts

@@ -55,3 +55,11 @@ export declare function useCursorEntityData(entity: string | undefined, params:
         reset: boolean;
     }, unknown>, Error>>;
 };
+/**
+ * CursorEntityDataResult is the public return contract of useCursorEntityData -
+ * the digested infinite-list shape (accumulated `rows`, `hasMore` +
+ * `fetchNextPage` for scroll, the first-window `total`/`countUnknown`, and the
+ * react-query status flags). Named (not inferred) so SDK consumers have a stable
+ * type to annotate against. Derived from the hook so it never drifts.
+ */
+export type CursorEntityDataResult = ReturnType<typeof useCursorEntityData>;

package/dist-lib/index.d.ts

@@ -17,6 +17,8 @@ export { useEntity } from "./hooks/useEntity";
 export { useScreen } from "./hooks/useScreen";
 export { useAuth } from "./hooks/useAuth";
 export { useEntityData, useEntityCount } from "./hooks/useEntityData";
+export { useCursorEntityData } from "./hooks/useCursorEntityData";
+export type { CursorEntityDataParams, CursorEntityDataResult, } from "./hooks/useCursorEntityData";
 export { useAllEntityData } from "./hooks/useAllEntityData";
 export { useEntityItem } from "./hooks/useEntityItem";
 export { useCreateEntity, useUpdateEntity, useDeleteEntity } from "./hooks/useMutations";