@declarion/react 0.65.1 → 0.66.0

package/dist-lib/types/schema.js

@@ -0,0 +1,173 @@
+import { OrderedMap as e } from "./ordmap.js";
+import { coerceDisplayString as t } from "../lib/display-value.js";
+import { formatOffsetTimestamp as n } from "../lib/timestamp.js";
+//#region src/types/schema.ts
+var r = "none", i = "$display";
+function a(e, r, a) {
+	if (!r) return;
+	let o = r[i];
+	if (typeof o == "string" && o !== "") return o;
+	let s = a?.display?.display_field;
+	if (!s) return;
+	let c = r[s];
+	if (c == null) return;
+	let l = a?.fields?.get(s);
+	if (l?.type === "timestamp" && typeof c == "string" && c !== "") return n(c);
+	let u = l?.values;
+	if (u && (typeof c == "string" || typeof c == "number")) {
+		let t = u.find((e) => e.code === String(c));
+		if (t) {
+			let n = e(t.name);
+			if (n) return n;
+		}
+	}
+	return typeof c == "object" && !Array.isArray(c) ? e(c) || void 0 : t(c);
+}
+function o(e, n, r, i) {
+	if (!r) return i;
+	let a = n[r];
+	return a == null ? i : typeof a == "object" && !Array.isArray(a) ? e(a) || i : t(a);
+}
+function s(e) {
+	let t = e.replace(/\/+$/, "").split("/").map((e) => e.startsWith(":") ? "[^/]+" : e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+	return RegExp("^" + t.join("/") + "$");
+}
+function c(e) {
+	let t = (() => {
+		try {
+			return decodeURIComponent(e);
+		} catch {
+			return e;
+		}
+	})().split("-")[0];
+	return t.length > 8 ? t.slice(0, 8) : t;
+}
+function l(e, t, n, r) {
+	if (!n) return;
+	let i = t.replace(/\/+$/, "") || "/", a;
+	for (let t of Object.values(n)) {
+		if (!t.route || !s(t.route).test(i)) continue;
+		let n = t.route.includes("/:"), o = e(t.display?.name);
+		if (!o && !n && r && t.entity && (o = e(r[t.entity]?.display?.name_plural)), !o && n && r && t.entity) {
+			let n = e(r[t.entity]?.display?.name);
+			if (n) {
+				let e = i.slice(i.lastIndexOf("/") + 1);
+				o = e ? `${n} ${c(e)}` : n;
+			}
+		}
+		if (!o) continue;
+		let l = {
+			title: o,
+			icon: t.display?.icon,
+			exact: !n
+		};
+		if (!n) return l;
+		a ??= l;
+	}
+	return a;
+}
+function u(e, t, n, r) {
+	let i = e(t.display?.name);
+	if (i) return i;
+	if (t.type === "ref" && t.ref?.entity && r) {
+		let n = r[t.ref.entity];
+		if (n) {
+			let t = e(n.display?.name);
+			if (t) return t;
+		}
+	}
+	return n;
+}
+function d(e) {
+	if (e != null) return typeof e == "string" ? { entity: e } : e;
+}
+function f(e) {
+	return { $special: e };
+}
+function p(e) {
+	if (typeof e != "object" || !e || Array.isArray(e)) return null;
+	let t = Object.keys(e), n = e.$special;
+	return t.length === 1 && typeof n == "string" ? n : null;
+}
+function m(e, t) {
+	let n = e ?? [];
+	if (!t) return n;
+	switch (t.mode ?? "append") {
+		case "replace": return t.values ?? [];
+		case "clear": return [];
+		default: return [...n, ...t.values ?? []];
+	}
+}
+function h(e) {
+	let t = e.name, n = e.display ? {
+		...e.display,
+		name: e.display.name ?? t
+	} : { name: t };
+	return {
+		type: e.type,
+		display: n,
+		values: e.values,
+		ref: e.ref,
+		structure: e.structure
+	};
+}
+function g(e, t) {
+	return !e || e.readonly ? !1 : e.mutations?.[t] ?? !0;
+}
+function _(e) {
+	return !e?.disable_defaults?.includes("__new");
+}
+function v(e) {
+	if (e.primary_key && e.primary_key.length > 0) return e.primary_key;
+	for (let [t, n] of e.fields) if (n.primary) return [t];
+	return ["id"];
+}
+function y(e, n) {
+	let r = v(e), i = {};
+	for (let e of r) i[e] = t(n[e]);
+	return i;
+}
+function b(e) {
+	return e.length === 1 ? e[0] : JSON.stringify(e);
+}
+function x(e) {
+	return b(Object.values(e));
+}
+function S(e, t) {
+	return b(v(e).map((e) => t[e] ?? ""));
+}
+function C(e, t) {
+	let n = v(e);
+	if (n.length === 1) return { [n[0]]: t };
+}
+function w(e, t) {
+	if (t <= 1) return [e];
+	try {
+		let n = JSON.parse(e);
+		if (Array.isArray(n) && n.length === t && n.every((e) => typeof e == "string")) return n;
+	} catch {
+		return null;
+	}
+	return null;
+}
+function T(e, t, n) {
+	if (e?.detail_screen === "none") return null;
+	let r = e?.detail_screen ?? t?.detail_screen;
+	return r ? n?.[r]?.route ?? null : null;
+}
+function E(e, t, n, r) {
+	if (!t) return null;
+	let i = T(e, n, r);
+	return i ? i.replace(":id", encodeURIComponent(t)) : null;
+}
+function D(e, t, n, r) {
+	return !t || v(t).some((e) => !r[e]) ? null : E(e, S(t, r), t, n);
+}
+function O(e, t, n, r) {
+	return t ? D(e, t, n, y(t, r)) : null;
+}
+function k(e) {
+	return v(e).length > 1;
+}
+//#endregion
+export { r as DETAIL_SCREEN_NONE, i as DISPLAY_KEY, e as OrderedMap, E as buildDetailHrefFromId, D as buildEntityDetailHref, O as buildRowDetailHref, m as effectiveSpecialValues, _ as entityAllowsCreateRoute, g as entityAllowsMutation, y as extractPkValues, u as fieldDisplayName, a as getDisplayValue, v as getPrimaryKeyFields, k as isCompositePk, d as normalizeRefConfig, b as pkValuePartsToId, w as pkValuesFromId, S as pkValuesToDetailId, x as pkValuesToId, h as propertyToField, T as resolveDetailRoute, o as resolveRefRecordLabel, l as screenTitleForPath, C as singlePkValues, f as specialValueMarker, p as specialValueMarkerCode };

package/dist-lib/{useResponsiveMode-DIR1bZfo.d.ts → useResponsiveMode-DmrpMbZX.d.ts}

@@ -243,18 +243,19 @@ interface RefConfig {
    *  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);
- *  `label` is the localized display string. Mirrors engine.FilterSpecialValue. */
-interface FilterSpecialValue {
+/** One declared special value ({code, label}), offered in the list filter and in
+ *  the create and edit forms of its field. `code` is the value the choice
+ *  stands for (a literal or a supported token); the server resolves it on
+ *  write. `label` is the localized display string. Mirrors engine.SpecialValue. */
+interface SpecialValue {
   code: string;
   label: LocalizedString;
 }
-/** Per-screen override of a field's filter_special_values, keyed in
- *  Screen.filter_special_values by the filter field code. */
-interface ScreenFilterSpecialValues {
+/** Per-screen override of a field's special_values, keyed in
+ *  Screen.special_values by the filter field code. */
+interface ScreenSpecialValues {
   mode?: "append" | "replace" | "clear";
-  values?: FilterSpecialValue[];
+  values?: SpecialValue[];
 }
 interface UnitConfig {
   storage: string;
@@ -282,6 +283,12 @@ interface EntityField {
   required?: boolean;
   primary?: boolean;
   auto?: boolean;
+  generate?: {
+    strategy: "record_locator" | "sequence";
+    length?: number;
+    prefix?: string;
+    width?: number;
+  };
   readonly?: boolean;
   source?: string;
   timezone?: string;
@@ -323,10 +330,10 @@ interface EntityField {
   enum?: string;
   files?: FileFieldDef;
   ref?: RefConfig;
-  /** Filter-only declared options (e.g. "Myself" -> $user.id) surfaced in this
-   *  field's filter control. Inert everywhere else. A screen MAY override these
-   *  per-screen via Screen.filter_special_values. */
-  filter_special_values?: FilterSpecialValue[];
+  /** Declared special values (e.g. "Myself" -> $user.id) offered in this field's
+   *  list filter and in its create and edit forms. A screen MAY override these
+   *  for its filters only, via Screen.special_values. */
+  special_values?: SpecialValue[];
   structure?: string;
   array?: boolean;
   copyable?: boolean;
@@ -571,6 +578,7 @@ interface Entity {
    *  routes a singleton entity's detail screen at the screen's declared
    *  `route:` without a `:id` segment, and skips list-route registration. */
   singleton?: boolean;
+  notes?: boolean;
   /** Carrier scope its `$params` writes land under (e.g. my_tenant -> "tenant",
    *  profile -> "user"). Absent = writes land under the entity's own code. Used
    *  by ParamsBlock to compute the attachable parameter set. */
@@ -860,10 +868,10 @@ interface Screen {
   list_resizable?: boolean;
   detail_screen?: string;
   fixed_filters?: Record<string, unknown>;
-  /** Per-screen override of field-level filter_special_values, keyed by filter
+  /** Per-screen override of field-level special_values, keyed by filter
    *  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>;
+   *  just this screen. Mirrors engine.Screen.SpecialValues. */
+  special_values?: Record<string, ScreenSpecialValues>;
   /** 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
@@ -1178,6 +1186,8 @@ interface Action {
    * actionRequiresSelection in lib/actions.ts.
    */
   requires_selection?: boolean;
+  timeout_ms?: number;
+  invoke?: string;
 }
 interface LanguageDef {
   code: string;
@@ -1374,6 +1384,7 @@ interface AuthUser {
   tenant?: Tenant;
   /** Populated only when the request is acting under an impersonation session. */
   impersonation?: ImpersonationInfo;
+  access_expires_at?: string;
   created_at: string;
   updated_at: string;
 }
@@ -1617,6 +1628,23 @@ interface EnrichedRow extends RowData {
   $units?: Units;
   $evidence?: EvidenceVerdict;
 }
+interface AggregateParams {
+  aggregate: string[];
+  group_by?: string;
+  filters?: FilterNode[];
+  search?: string;
+  screen?: string;
+  include_deleted?: boolean;
+}
+/** One group of an aggregate read. `group` is present only with `group_by`; null is the empty value. Sums are exact decimal text. */
+interface AggregateGroup {
+  group?: string | null;
+  count?: number;
+  sum?: Record<string, string>;
+}
+interface AggregateResponse {
+  aggregates: AggregateGroup[];
+}
 //#endregion
 //#region src/api/data.d.ts
 /** What a single-record read asks the server to compute beside the row. */
@@ -1783,4 +1811,4 @@ type ForcedViewport = "auto" | ViewportCategory;
 declare function ResponsiveModeProvider({ children, breakpoints, viewportOverride, viewport: declaredViewport }: ResponsiveModeProviderProps): import("react").JSX.Element;
 declare function useResponsiveMode(): ResponsiveMode;
 //#endregion
-export { EntityField as $, ListParams as A, pickLocalized as At, TenantEnv as B, hasOrGroups as Bt, CURSOR_LANGUAGE_CHANGED as C, pkValuesToDetailId as Ct, EnrichedRow as D, TextFn as Dt, DataResponse as E, MANDATORY_LANGUAGE as Et, PublicParam as F, FilterURLState as Ft, V2PropertyInstance as G, FileFieldDisplay as Gt, V2ListResponse as H, parseFiltersFromURL as Ht, PublicParamsResponse as I, FilterValueResolver as It, Action as J, HydratedFile as Jt, V2StatusInstance as K, FileFieldMode as Kt, Refs as L, NO_VALUE_OPS as Lt, LoginResponse as M, textWithNodes as Mt, ParamLookup as N, FilterNode as Nt, ImpersonationInfo as O, TextVars as Ot, PropertyValue as P, FilterOp as Pt, Entity as Q, StatusInfo as R, OP_LABELS as Rt, BrandingIdentity as S, pkValuesFromId as St, CheckSetupResponse as T, resolveDetailRoute as Tt, V2Meta as U, setFiltersInURL as Ut, V2ListParams as V, parseFilterURLState as Vt, V2ParamInstance as W, FileFieldDef as Wt, ChildRelation as X, UploadedFile as Xt, AreaDef as Y, UploadProgress as Yt, ClassificationTierDef as Z, OrderedMap as Zt, executeAction as _, buildRowDetailHref as _t, ResponsiveMode as a, NavNode as at, ApiErrorBody as b, getPrimaryKeyFields as bt, resolveViewportCategory as c, PropertyDef as ct, ActionExecuteResponse as d, Screen as dt, EnumDef as et, ActionItemError as f, StatusDef as ft, deleteObject as g, buildEntityDetailHref as gt, buildActionBody as h, buildDetailHrefFromId as ht, ResponsiveBreakpoints as i, LocalizedString as it, ListResponse as j, pluralText as jt, ListMeta as k, makeTextFn as kt, ActionBatchError as l, RefConfig as lt, GetEntityOptions as m, StructureDef as mt, useResponsiveMode as n, FilterSpecialValue as nt, ResponsiveViewport as o, ParameterDef as ot, ActionItemSkip as p, StatusGroupDef as pt, isCursorStaleError as q, FileFieldValue as qt, DEFAULT_RESPONSIVE_BREAKPOINTS as r, LanguageDef as rt, ViewportCategory as s, PkValues as st, ResponsiveModeProvider as t, FieldAccessInfo as tt, ActionExecuteRequest as u, Schema as ut, restoreObject as v, extractPkValues as vt, CURSOR_SEMANTICS_MISMATCH as w, pkValuesToId as wt, AuthUser as x, pkValuePartsToId as xt, ApiError as y, fieldDisplayName as yt, Tenant as z, countActiveFilters as zt };
+export { ChildRelation as $, UploadedFile as $t, EnrichedRow as A, TextFn as At, Refs as B, NO_VALUE_OPS as Bt, ApiErrorBody as C, getPrimaryKeyFields as Ct, CURSOR_SEMANTICS_MISMATCH as D, pkValuesToId as Dt, CURSOR_LANGUAGE_CHANGED as E, pkValuesToDetailId as Et, LoginResponse as F, textWithNodes as Ft, V2ListResponse as G, parseFiltersFromURL as Gt, Tenant as H, countActiveFilters as Ht, ParamLookup as I, FilterNode as It, V2PropertyInstance as J, FileFieldDisplay as Jt, V2Meta as K, setFiltersInURL as Kt, PropertyValue as L, FilterOp as Lt, ListMeta as M, makeTextFn as Mt, ListParams as N, pickLocalized as Nt, CheckSetupResponse as O, resolveDetailRoute as Ot, ListResponse as P, pluralText as Pt, AreaDef as Q, UploadProgress as Qt, PublicParam as R, FilterURLState as Rt, ApiError as S, fieldDisplayName as St, BrandingIdentity as T, pkValuesFromId as Tt, TenantEnv as U, hasOrGroups as Ut, StatusInfo as V, OP_LABELS as Vt, V2ListParams as W, parseFilterURLState as Wt, isCursorStaleError as X, FileFieldValue as Xt, V2StatusInstance as Y, FileFieldMode as Yt, Action as Z, HydratedFile as Zt, executeAction as _, StructureDef as _t, ResponsiveMode as a, LanguageDef as at, AggregateParams as b, buildRowDetailHref as bt, resolveViewportCategory as c, ParameterDef as ct, ActionExecuteResponse as d, RefConfig as dt, OrderedMap as en, ClassificationTierDef as et, ActionItemError as f, Schema as ft, deleteObject as g, StatusGroupDef as gt, buildActionBody as h, StatusDef as ht, ResponsiveBreakpoints as i, FieldAccessInfo as it, ImpersonationInfo as j, TextVars as jt, DataResponse as k, MANDATORY_LANGUAGE as kt, ActionBatchError as l, PkValues as lt, GetEntityOptions as m, SpecialValue as mt, useResponsiveMode as n, EntityField as nt, ResponsiveViewport as o, LocalizedString as ot, ActionItemSkip as p, Screen as pt, V2ParamInstance as q, FileFieldDef as qt, DEFAULT_RESPONSIVE_BREAKPOINTS as r, EnumDef as rt, ViewportCategory as s, NavNode as st, ResponsiveModeProvider as t, Entity as tt, ActionExecuteRequest as u, PropertyDef as ut, restoreObject as v, buildDetailHrefFromId as vt, AuthUser as w, pkValuePartsToId as wt, AggregateResponse as x, extractPkValues as xt, AggregateGroup as y, buildEntityDetailHref as yt, PublicParamsResponse as z, FilterValueResolver as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@declarion/react",
-  "version": "0.65.1",
+  "version": "0.66.0",
   "private": false,
   "license": "MIT",
   "description": "React SDK for Declarion, the schema-driven business apps platform.",
@@ -58,13 +58,14 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@monaco-editor/react": "^4.7.0",
-    "@tanstack/react-query": "^5.104.1",
-    "@tanstack/react-table": "^9.2.6",
-    "@tanstack/react-virtual": "^3.14.13",
+    "@tanstack/react-query": "^5.104.2",
+    "@tanstack/react-table": "^9.3.1",
+    "@tanstack/react-virtual": "^3.14.19",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "date-fns": "^4.4.0",
-    "lucide-react": "^1.52.0",
+    "libphonenumber-js": "1.13.15",
+    "lucide-react": "^1.56.0",
     "mdast-util-to-string": "^4.0.0",
     "monaco-editor": "^0.57.0",
     "react-markdown": "^10.1.0",
@@ -87,12 +88,12 @@
     "@testing-library/dom": "^10.4.2",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
-    "@testing-library/user-event": "^14.6.7",
+    "@testing-library/user-event": "^14.6.8",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitejs/plugin-react": "^6.1.2",
-    "@vitest/coverage-v8": "^5.0.3",
+    "@vitest/coverage-v8": "^5.0.4",
     "axe-core": "^4.14.0",
     "eslint": "^10.12.0",
     "eslint-plugin-react-hooks": "^7.1.1",
@@ -100,13 +101,13 @@
     "publint": "^0.3.25",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
-    "rolldown": "^1.2.12",
-    "rolldown-plugin-dts": "^0.28.6",
+    "rolldown": "^1.2.13",
+    "rolldown-plugin-dts": "^0.28.8",
     "tailwindcss": "^4.3.3",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "typescript-eslint": "^8.71.1",
-    "vite": "^8.3.2",
-    "vitest": "^5.0.3"
+    "typescript-eslint": "^8.71.2",
+    "vite": "^8.3.4",
+    "vitest": "^5.0.4"
   },
   "scripts": {
     "dev": "vite",