@declarion/react 0.59.2 → 0.61.1

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-BnmWukxk.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-0WBj7wT6.js";
 //#region src/components/pages/list/cardProjection.ts
 var n = 4, r = 2, i = 2, a = [
 	"screen_card",

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/components/primitives/Fields.d.ts

@@ -3,8 +3,10 @@ export type FieldLabelProps = {
     children?: ReactNode;
     required?: boolean;
     hint?: string;
+    htmlFor?: string;
+    id?: string;
 };
-export declare const FieldLabel: ({ children, required, hint }: FieldLabelProps) => import("react").JSX.Element;
+export declare const FieldLabel: ({ children, required, hint, htmlFor, id }: FieldLabelProps) => import("react").JSX.Element;
 export type TextInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "prefix"> & {
     value?: string | null;
     onChange?: (v: string) => void;

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

@@ -1,4 +1,4 @@
-import { $ as e, M as t, N as n, R as r, nt as i, rt as a } from "./useText-BFDCTUSo.js";
+import { $ as e, M as t, N as n, R as r, nt as i, rt as a } from "./useText-BsedsJ-J.js";
 import { n as o } from "./safe-url-oSJw5pzO.js";
 //#region src/api/data.ts
 function s(e, t) {
@@ -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`, {