@declarion/react 0.59.0 → 0.60.0

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

@@ -4,7 +4,11 @@ import type { ExportRequest } from "../components/pages/exportRequest.d.ts";
 export declare function listEntities(entity: string, params?: ListParams, options?: {
     signal?: AbortSignal;
 }): Promise<ListResponse>;
-export declare function getEntity(entity: string, pkValues: PkValues | string): Promise<DataResponse>;
+/** What a single-record read asks the server to compute beside the row. */
+export interface GetEntityOptions {
+    expand?: readonly "evidence"[];
+}
+export declare function getEntity(entity: string, pkValues: PkValues | string, options?: GetEntityOptions): Promise<DataResponse>;
 export declare function createEntity(entity: string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function updateEntity(entity: string, pkValues: PkValues | string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function deleteObject(entity: string, pkValues: PkValues | string): Promise<void>;

package/dist-lib/{cardProjection-Bkl2SSYz.js → cardProjection-nveYLvHR.js}

@@ -1,4 +1,4 @@
-import { h as e, yn as t } from "./useCurrentScreen-BL5NZFCw.js";
+import { h as e, kn as t } from "./useCurrentScreen-BPq7HMF1.js";
 //#region src/components/pages/list/cardProjection.ts
 var n = 4, r = 2, i = 2, a = [
 	"screen_card",

package/dist-lib/components/chrome/headerActionZone.d.ts

@@ -0,0 +1,27 @@
+import type { CSSProperties } from "react";
+/**
+ * The room the action zone demands before it will share a line with whatever
+ * came before it. One call to action plus its menu - below that the bar shows a
+ * lone menu trigger, which is not worth a line of its own.
+ *
+ * Measured, not chosen: at 402px the meta items that wrap past the title leave
+ * ~190px on their line. A 240px demand refused it and took a THIRD line, so a
+ * phone spent one row on a record-id prefix and an info icon with a gap beside
+ * them. At 180 the actions finish that row instead - which is what a reader
+ * expects when they can see the space.
+ */
+export declare const ACTION_ZONE_MIN_WIDTH = 180;
+/**
+ * The action zone of every header row, per the UI SDK guide's "Header
+ * composition". It is one item of a WRAPPING row that asks for a minimum and
+ * pushes itself to the trailing edge: room left after the identity items means
+ * it finishes that line, no room means it takes the next one, and
+ * `margin-left: auto` keeps it right on either. Being one item, it can never
+ * split half-left and half-right.
+ *
+ * It grows into whatever the line has left. Content-sized, the zone handed the
+ * action bar its own minimum as the width to measure - so a line with 1600px
+ * free still showed two buttons. The buttons stay flush to the trailing edge
+ * inside a zone that is as wide as the space actually is.
+ */
+export declare const headerActionZoneStyle: CSSProperties;

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

@@ -22,4 +22,4 @@ import type { TextFn } from "../../../lib/language.d.ts";
 export declare function buildFilterFieldMeta(t: TextFn, screen: (Pick<Screen, "filters"> & {
     filter_special_values?: Record<string, ScreenFilterSpecialValues>;
     filter_operators?: Record<string, string[]>;
-}) | undefined, entity: Pick<Entity, "fields" | "status_groups" | "properties"> | undefined, entities?: Record<string, Entity>): FilterFieldMeta[];
+}) | undefined, entity: Pick<Entity, "fields" | "status_groups" | "properties" | "field_access"> | undefined, entities?: Record<string, Entity>): FilterFieldMeta[];

package/dist-lib/components/pages/list/useActiveView.d.ts

@@ -1,5 +1,5 @@
 import type { FilterNode } from "../../../lib/filters.d.ts";
-import type { Screen } from "../../../types/schema.d.ts";
+import type { Entity, Screen } from "../../../types/schema.d.ts";
 import type { ViewItem } from "../../list/ViewSwitcher.d.ts";
 export declare function baseViewSearchParams(current: URLSearchParams): URLSearchParams;
 /** Scoped to who is asking as well as to the screen: a tenant switch or a
@@ -8,6 +8,7 @@ export declare function defaultViewClearedKey(screenCode: string, tenantId?: str
 interface ActiveViewInput {
     screenCode: string;
     screen: Screen | undefined;
+    entity: Entity | undefined;
     searchParams: URLSearchParams;
     setSearchParams: (next: URLSearchParams, options?: {
         replace?: boolean;
@@ -21,6 +22,12 @@ export interface ViewDefaults {
     columns: string[];
     sort: string | undefined;
 }
+/** The query a view (or none) states, less any field the caller may not read,
+ *  which the server would refuse; an emptied sort falls back to `sort_default`. */
+export declare function viewQuery(entity: Entity | undefined, view: ViewItem | undefined, screen: Screen | undefined): {
+    filters: FilterNode[];
+    sort: string | undefined;
+};
 export interface ActiveView {
     all: ViewItem[];
     activeId: string | null;
@@ -34,5 +41,5 @@ export interface ActiveView {
 }
 /** Resolves the list's active view from the `view` URL parameter. It runs above
  *  the filter, column and sort hooks because each of them falls back to it. */
-export declare function useActiveView({ screenCode, screen, searchParams, setSearchParams, userId, tenantId, filterError, }: ActiveViewInput): ActiveView;
+export declare function useActiveView({ screenCode, screen, entity, searchParams, setSearchParams, userId, tenantId, filterError, }: ActiveViewInput): ActiveView;
 export {};

package/dist-lib/components/pages/list/useListViews.d.ts

@@ -1,10 +1,11 @@
 import { type FilterNode } from "../../../lib/filters.d.ts";
-import { type Screen } from "../../../types/schema.d.ts";
+import { type Entity, type Screen } from "../../../types/schema.d.ts";
 import type { ViewItem } from "../../list/ViewSwitcher.d.ts";
 import type { TextFn } from "../../../lib/language.d.ts";
 interface ListViewsInput {
     screenCode: string;
     screen: Screen | undefined;
+    entity: Entity | undefined;
     searchParams: URLSearchParams;
     setSearchParams: (next: URLSearchParams, options?: {
         replace?: boolean;
@@ -49,7 +50,7 @@ export interface ListViews {
  * A view owns the LOGICAL layout - filters, columns, sort - and nothing else.
  * Column widths are per device and never travel in one.
  */
-export declare function useListViews({ screenCode, screen, searchParams, setSearchParams, userId, tenantId, all, activeId, active, clearedKey, filters, visibleColumns, sort, }: ListViewsInput): ListViews;
+export declare function useListViews({ screenCode, screen, entity, searchParams, setSearchParams, userId, tenantId, all, activeId, active, clearedKey, filters, visibleColumns, sort, }: ListViewsInput): ListViews;
 /** The name a save dialog offers to overwrite, or null when the active view is
  *  not the caller's to overwrite. */
 export declare function overwritableViewName(t: TextFn, active: ViewItem | undefined): string | null;

package/dist-lib/{failure-v-uGSpbX.js → failure-BT54OLHy.js}

@@ -13,15 +13,15 @@ async function c(e, n = {}, r = {}) {
 	}
 	return t(s(e, n), { signal: r.signal });
 }
-async function l(e, n) {
+async function l(e, n, r = {}) {
 	if (C) {
 		let t = C(e, n);
 		if (t !== void 0) return t;
 	}
-	let r = new URLSearchParams();
-	if (typeof n == "string") r.set("id", n);
-	else for (let [e, t] of Object.entries(n)) r.set(e, t);
-	return t(`/api/data/${e}?${r.toString()}`);
+	let i = new URLSearchParams();
+	if (typeof n == "string") i.set("id", n);
+	else for (let [e, t] of Object.entries(n)) i.set(e, t);
+	return r.expand?.length && i.set("expand", r.expand.join(",")), t(`/api/data/${e}?${i.toString()}`);
 }
 async function u(e, t) {
 	return { data: ((await E(`${e}.__create`, {