@declarion/react 0.65.0 → 0.66.0

package/dist-lib/index.d.ts

@@ -1,6 +1,6 @@
 import { i as DynamicIcon, n as IconName, r as IconProps, t as Icon } from "./Icons-Dzl-AkD_.js";
 import { i as setIconRegistry, n as getIcon, t as IconDef } from "./icon-registry-CUT4eF63.js";
-import { $ as EntityField, A as ListParams, At as pickLocalized, B as TenantEnv, Bt as hasOrGroups, C as CURSOR_LANGUAGE_CHANGED, Ct as pkValuesToDetailId, D as EnrichedRow, Dt as TextFn, E as DataResponse, Et as MANDATORY_LANGUAGE, F as PublicParam, Ft as FilterURLState, G as V2PropertyInstance, Gt as FileFieldDisplay, H as V2ListResponse, Ht as parseFiltersFromURL, I as PublicParamsResponse, It as FilterValueResolver, J as Action, Jt as HydratedFile, K as V2StatusInstance, Kt as FileFieldMode, L as Refs, Lt as NO_VALUE_OPS, M as LoginResponse, Mt as textWithNodes, N as ParamLookup, Nt as FilterNode, O as ImpersonationInfo, Ot as TextVars, P as PropertyValue, Pt as FilterOp, Q as Entity, R as StatusInfo, Rt as OP_LABELS, S as BrandingIdentity, St as pkValuesFromId, T as CheckSetupResponse, Tt as resolveDetailRoute, U as V2Meta, Ut as setFiltersInURL, V as V2ListParams, Vt as parseFilterURLState, W as V2ParamInstance, Wt as FileFieldDef, X as ChildRelation, Xt as UploadedFile, Y as AreaDef, Yt as UploadProgress, Z as ClassificationTierDef, Zt as OrderedMap, _ as executeAction$1, _t as buildRowDetailHref, a as ResponsiveMode, at as NavNode, b as ApiErrorBody, bt as getPrimaryKeyFields, c as resolveViewportCategory, ct as PropertyDef, d as ActionExecuteResponse, dt as Screen, et as EnumDef, f as ActionItemError, ft as StatusDef, g as deleteObject, gt as buildEntityDetailHref, h as buildActionBody, ht as buildDetailHrefFromId, i as ResponsiveBreakpoints, it as LocalizedString, j as ListResponse, jt as pluralText, k as ListMeta, kt as makeTextFn, l as ActionBatchError, lt as RefConfig, m as GetEntityOptions, mt as StructureDef, n as useResponsiveMode, nt as FilterSpecialValue, o as ResponsiveViewport, ot as ParameterDef, p as ActionItemSkip, pt as StatusGroupDef, q as isCursorStaleError, qt as FileFieldValue, r as DEFAULT_RESPONSIVE_BREAKPOINTS, rt as LanguageDef, s as ViewportCategory, st as PkValues, t as ResponsiveModeProvider, tt as FieldAccessInfo, u as ActionExecuteRequest, ut as Schema, v as restoreObject, vt as extractPkValues, w as CURSOR_SEMANTICS_MISMATCH, wt as pkValuesToId, x as AuthUser, xt as pkValuePartsToId, y as ApiError, yt as fieldDisplayName, z as Tenant, zt as countActiveFilters } from "./useResponsiveMode-DIR1bZfo.js";
+import { $ as ChildRelation, $t as UploadedFile, A as EnrichedRow, At as TextFn, B as Refs, Bt as NO_VALUE_OPS, C as ApiErrorBody, Ct as getPrimaryKeyFields, D as CURSOR_SEMANTICS_MISMATCH, Dt as pkValuesToId, E as CURSOR_LANGUAGE_CHANGED, Et as pkValuesToDetailId, F as LoginResponse, Ft as textWithNodes, G as V2ListResponse, Gt as parseFiltersFromURL, H as Tenant, Ht as countActiveFilters, I as ParamLookup, It as FilterNode, J as V2PropertyInstance, Jt as FileFieldDisplay, K as V2Meta, Kt as setFiltersInURL, L as PropertyValue, Lt as FilterOp, M as ListMeta, Mt as makeTextFn, N as ListParams, Nt as pickLocalized, O as CheckSetupResponse, Ot as resolveDetailRoute, P as ListResponse, Pt as pluralText, Q as AreaDef, Qt as UploadProgress, R as PublicParam, Rt as FilterURLState, S as ApiError, St as fieldDisplayName, T as BrandingIdentity, Tt as pkValuesFromId, U as TenantEnv, Ut as hasOrGroups, V as StatusInfo, Vt as OP_LABELS, W as V2ListParams, Wt as parseFilterURLState, X as isCursorStaleError, Xt as FileFieldValue, Y as V2StatusInstance, Yt as FileFieldMode, Z as Action, Zt as HydratedFile, _ as executeAction$1, _t as StructureDef, a as ResponsiveMode, at as LanguageDef, b as AggregateParams, bt as buildRowDetailHref, c as resolveViewportCategory, ct as ParameterDef, d as ActionExecuteResponse, dt as RefConfig, en as OrderedMap, et as ClassificationTierDef, f as ActionItemError, ft as Schema, g as deleteObject, gt as StatusGroupDef, h as buildActionBody, ht as StatusDef, i as ResponsiveBreakpoints, it as FieldAccessInfo, j as ImpersonationInfo, jt as TextVars, k as DataResponse, kt as MANDATORY_LANGUAGE, l as ActionBatchError, lt as PkValues, m as GetEntityOptions, mt as SpecialValue, n as useResponsiveMode, nt as EntityField, o as ResponsiveViewport, ot as LocalizedString, p as ActionItemSkip, pt as Screen, q as V2ParamInstance, qt as FileFieldDef, r as DEFAULT_RESPONSIVE_BREAKPOINTS, rt as EnumDef, s as ViewportCategory, st as NavNode, t as ResponsiveModeProvider, tt as Entity, u as ActionExecuteRequest, ut as PropertyDef, v as restoreObject, vt as buildDetailHrefFromId, w as AuthUser, wt as pkValuePartsToId, x as AggregateResponse, xt as extractPkValues, y as AggregateGroup, yt as buildEntityDetailHref, z as PublicParamsResponse, zt as FilterValueResolver } from "./useResponsiveMode-DmrpMbZX.js";
 import { ButtonHTMLAttributes, CSSProperties, ComponentType, InputHTMLAttributes, MouseEvent, ReactNode, RefObject } from "react";
 import { QueryClient, QueryKey, UseQueryResult } from "@tanstack/react-query";
 import { useLocation, useNavigate, useParams, useSearchParams } from "react-router";
@@ -199,7 +199,16 @@ export declare class Batch {
 }
 //#endregion
 //#region src/hooks/useSchema.d.ts
-export declare function useSchema(): import("@tanstack/react-query").UseQueryResult<Schema, Error>;
+/**
+ * The schema of the current session. One answer serves every reader; an answer that
+ * describes another caller is never returned. Requested before the caller last changed,
+ * it is refetched once; requested after, the session is re-read once, and only then is it a failure.
+ */
+export declare function useSchema(): {
+  data: Schema | undefined;
+  isError: boolean;
+  refetch: () => Promise<unknown>;
+};
 //#endregion
 //#region src/hooks/useEntity.d.ts
 export declare function useEntity(entityCode: string | undefined): Entity | undefined;
@@ -273,15 +282,6 @@ export declare function useAuth(): {
  * the live query exactly. See hooks/usePageStateRuntime.ts.
  */
 export declare function entityDataQueryKey(entity: string | undefined, params: ListParams): QueryKey;
-/**
- * useEntityData fetches one page-window of entity rows.
- *
- * Decoupled-count contract:
- * this hook issues the WINDOW request only - `count: "window"`, so the
- * server returns the page of rows and never blocks on a COUNT(*). The total
- * is fetched separately by `useEntityCount`; the table renders rows the
- * moment this query resolves, independent of count latency.
- */
 export declare function useEntityData(entity: string | undefined, params: ListParams, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<ListResponse<Record<string, unknown>>, Error>;
 /**
  * useEntityCount fetches the total row count for a list view in a SEPARATE
@@ -299,6 +299,9 @@ export declare function useEntityData(entity: string | undefined, params: ListPa
  */
 export declare function useEntityCount(entity: string | undefined, params: ListParams, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<ListResponse<Record<string, unknown>>, Error>;
 //#endregion
+//#region src/hooks/useAggregate.d.ts
+export declare function useAggregate(entity: string | undefined, params: AggregateParams, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<AggregateResponse, Error>;
+//#endregion
 //#region src/hooks/useCursorEntityData.d.ts
 /**
  * The stable JSON segment of the cursor list's query key (the view-defining
@@ -513,6 +516,7 @@ export declare function useDebounce<T>(value: T, delay: number): T;
 export declare function usePublicParams(): import("@tanstack/react-query").UseQueryResult<PublicParamsResponse, Error>;
 export declare function useResolvedParam(code: string, options?: {
   enabled?: boolean;
+  isSessionProbe?: boolean;
 }): import("@tanstack/react-query").UseQueryResult<ParamLookup, Error>;
 export declare function useEffectiveParam<T = unknown>(code: string): {
   value: T | undefined;
@@ -1030,7 +1034,7 @@ interface FilterFieldMeta {
     color?: string;
   }[];
   ref?: RefConfig;
-  specialValues?: FilterSpecialValue[];
+  specialValues?: SpecialValue[];
 }
 interface FilterDrawerProps {
   open: boolean;
@@ -1310,10 +1314,11 @@ interface RefComboboxProps {
   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[];
+  /** Declared special values (e.g. "Myself" -> $user.id) rendered as a
+   *  "Special values" group above the relation results. Selecting one reports its
+   *  `code` verbatim (a `$user.*` token is NOT resolved locally); a form turns it
+   *  into the write marker, the list filter stores it as the filter value. */
+  specialValues?: SpecialValue[];
 }
 /**
  * RefCombobox is the ONE relation picker shared by every surface that selects a
@@ -1547,6 +1552,25 @@ type SectionCardProps = {
 };
 export declare function SectionCard({ title, subtitle, right, badge, count, children, footer, collapsible, defaultOpen, icon, emphasis, headingLevel, padding }: SectionCardProps): import("react").JSX.Element;
 //#endregion
+//#region src/components/primitives/StatTile.d.ts
+type StatTileTone = "neutral" | "good" | "warn" | "bad" | "accent";
+type StatTileProps = {
+  label: ReactNode;
+  value: ReactNode;
+  unit?: ReactNode;
+  tone?: StatTileTone;
+  delta?: {
+    text: ReactNode;
+    tone?: StatTileTone;
+  };
+  note?: ReactNode;
+  footer?: ReactNode;
+  loading?: boolean;
+  error?: ReactNode;
+  href?: string;
+};
+export declare function StatTile({ label, value, unit, tone, delta, note, footer, loading, error, href }: StatTileProps): import("react").JSX.Element;
+//#endregion
 //#region src/components/primitives/RecordIdBadge.d.ts
 type RecordIdBadgeProps = {
   value: string;
@@ -1982,9 +2006,7 @@ interface TenantChipProps {
 interface EnvTone {
   fg: string;
   bg: string;
-  border?: string;
-  darkFg?: string;
-  darkBg?: string;
+  border: string;
 }
 export declare function envTone(env?: TenantEnv): EnvTone;
 export declare function TenantChip({ tenant, tenants, onSwitch, busy, compact, locked, lockedReason }: TenantChipProps): import("react").JSX.Element;
@@ -2513,4 +2535,4 @@ export declare function isFieldSoDProtected(schema: Schema | undefined, entity:
  */
 export declare function fieldAccessInfo(entity: Entity | undefined, fieldName: string): FieldAccessInfo | undefined;
 //#endregion
-export { type Action, ActionBatchError, type ActionExecuteRequest, type ActionExecuteResponse, type ActionItemError, type ActionItemSkip, type ActionListPage, type AgentChatPanelProps, type AgentContentBlock, type AgentConversation, type AgentConversationDrawerProps, type AgentConversationStatus, type AgentElicitFormProps, type AgentInvocationKind, type AgentInvocationStatus, type AgentMessage, type AgentPickerProps, type AgentRole, type AgentToolInvocation, type AgentTurn, type AgentTurnState, type AgentTurnStatus, type ApiError, App as Declarion, type ApprovalScope, type AuthShellProps, type AuthUser, type AvailableAgent, type AvatarProps, type BatchOp, type BatchOpResult, type BatchResponse, type BoolToggleProps, type BrandGlyphProps, type BreadcrumbsProps, type BtnKind, type BtnProps, type BtnSize, CURSOR_LANGUAGE_CHANGED, CURSOR_SEMANTICS_MISMATCH, type CanonicalLocation, type ChangePasswordDialogProps, type CheckProps, type CheckSetupResponse, type ChildRelation, type ChipProps, type ClassificationTierDef, type CommandAction, type CommandActionType, type CommandPaletteProps, type CropperOptions, type CropperResult, type Crumb, type CurrentScreen, type CursorActionDataResult, type CursorEntityDataParams, type CursorEntityDataResult, type CustomScreenProps, DEFAULT_RESPONSIVE_BREAKPOINTS, type DataResponse, type DateInputProps, type DraftEntry, type DropdownProps, DynamicIcon, type EnrichedRow, type Entity, type EntityField, type EnumDef, type FieldAccessInfo, type FieldLabelProps, type FileDraftScopeApi, type FileFieldDef, type FileFieldDisplay, type FileFieldMode, type FileWidget, type FileWidgetProps, type FilterNode, type FilterOp, type FilterRecord, type FilterRecordField, type FilterRecordFields, type FilterURLState, type HoverCardAlign, type HoverCardProps, type HydratedFile, Icon, type IconBtnProps, type IconDef, type IconName, type IconProps, type ImageCropper, type InfoTooltipProps, type InlineEditCellProps, type InlineEditKind, type InlineEditTrigger, type JsonFieldProps, type LanguageDef, type LayoutWidget, type LayoutWidgetProps, type ListMeta, type ListParams, type ListResponse, type LiveObjectResult, type LocalizedString, type LoginResponse, MANDATORY_LANGUAGE, MULTIPLE_VALUES, type MassEditTarget, type MassEditTargetKind, type MenuItemProps, type MultiSelectProps, NO_VALUE_OPS, type NavNode, OP_LABELS, type ObjectActionBarProps, type ObjectActionBarSlot, type ObjectActionSelection, OrderedMap, type PageStateSetter, type ParameterDef, type PasswordInputProps, type PatchMap, type PillProps, type PillSize, type PillTone, type PkValues, type PropertyDef, type PropertyValue, type PublicParam, type QEFieldProps, type QuickEditCellProps, type QuickPeekFieldSpec, type QuickPeekProps, type RailAreaItem, type RailProps, type RecordIdBadgeProps, type RefComboboxProps, type RefFieldItem, type RefFieldProps, type RefreshControlProps, type Refs, type ResponsiveBreakpoints, type ResponsiveMode, ResponsiveModeProvider, type ResponsiveViewport, type ReturnTarget, type RowFieldProps, type RowHelpers, type RunActionOptions, type Schema, type Screen, type ScreenBack, type ScrollAnchor, type ScrollableVirtualizer, type SectionBadge, type SectionCardProps, type SectionEmphasis, type SelectOption, type SelectProps, type SidebarProps, type StatusDef, type StatusGroupDef, type StatusInfo, type StructureDef, type TabItem, type TabStripProps, type TagsInputProps, type Tenant, type TenantChipProps, type TextAreaProps, type TextFn, type TextInputProps, type TextVars, type TooltipProps, type TopBarProps, type UploadCheck, type UploadProgress, type UploadedFile, type UseObjectActionsResult, type UseScreenBackOptions, type UseScreenTabOptions, type V2ListParams, type V2ListResponse, type V2Meta, type V2ParamInstance, type V2PropertyInstance, type V2StatusInstance, type ViewFieldProps, type ViewportCategory, buildActionBody, buildDetailHrefFromId, buildEntityDetailHref, buildRowDetailHref, countActiveFilters, deleteObject, executeAction$1 as executeAction, extractPkValues, fieldDisplayName, getIcon, getPrimaryKeyFields, hasOrGroups, isCursorStaleError, makeTextFn, parseFilterURLState, parseFiltersFromURL, pickLocalized, pkValuePartsToId, pkValuesFromId, pkValuesToDetailId, pkValuesToId, pluralText, resolveDetailRoute, resolveViewportCategory, restoreObject, setFiltersInURL, setIconRegistry, textWithNodes, useLocation, useNavigate, useParams, useResponsiveMode, useSearchParams };
+export { type Action, ActionBatchError, type ActionExecuteRequest, type ActionExecuteResponse, type ActionItemError, type ActionItemSkip, type ActionListPage, type AgentChatPanelProps, type AgentContentBlock, type AgentConversation, type AgentConversationDrawerProps, type AgentConversationStatus, type AgentElicitFormProps, type AgentInvocationKind, type AgentInvocationStatus, type AgentMessage, type AgentPickerProps, type AgentRole, type AgentToolInvocation, type AgentTurn, type AgentTurnState, type AgentTurnStatus, type AggregateGroup, type AggregateParams, type AggregateResponse, type ApiError, App as Declarion, type ApprovalScope, type AuthShellProps, type AuthUser, type AvailableAgent, type AvatarProps, type BatchOp, type BatchOpResult, type BatchResponse, type BoolToggleProps, type BrandGlyphProps, type BreadcrumbsProps, type BtnKind, type BtnProps, type BtnSize, CURSOR_LANGUAGE_CHANGED, CURSOR_SEMANTICS_MISMATCH, type CanonicalLocation, type ChangePasswordDialogProps, type CheckProps, type CheckSetupResponse, type ChildRelation, type ChipProps, type ClassificationTierDef, type CommandAction, type CommandActionType, type CommandPaletteProps, type CropperOptions, type CropperResult, type Crumb, type CurrentScreen, type CursorActionDataResult, type CursorEntityDataParams, type CursorEntityDataResult, type CustomScreenProps, DEFAULT_RESPONSIVE_BREAKPOINTS, type DataResponse, type DateInputProps, type DraftEntry, type DropdownProps, DynamicIcon, type EnrichedRow, type Entity, type EntityField, type EnumDef, type FieldAccessInfo, type FieldLabelProps, type FileDraftScopeApi, type FileFieldDef, type FileFieldDisplay, type FileFieldMode, type FileWidget, type FileWidgetProps, type FilterNode, type FilterOp, type FilterRecord, type FilterRecordField, type FilterRecordFields, type FilterURLState, type HoverCardAlign, type HoverCardProps, type HydratedFile, Icon, type IconBtnProps, type IconDef, type IconName, type IconProps, type ImageCropper, type InfoTooltipProps, type InlineEditCellProps, type InlineEditKind, type InlineEditTrigger, type JsonFieldProps, type LanguageDef, type LayoutWidget, type LayoutWidgetProps, type ListMeta, type ListParams, type ListResponse, type LiveObjectResult, type LocalizedString, type LoginResponse, MANDATORY_LANGUAGE, MULTIPLE_VALUES, type MassEditTarget, type MassEditTargetKind, type MenuItemProps, type MultiSelectProps, NO_VALUE_OPS, type NavNode, OP_LABELS, type ObjectActionBarProps, type ObjectActionBarSlot, type ObjectActionSelection, OrderedMap, type PageStateSetter, type ParameterDef, type PasswordInputProps, type PatchMap, type PillProps, type PillSize, type PillTone, type PkValues, type PropertyDef, type PropertyValue, type PublicParam, type QEFieldProps, type QuickEditCellProps, type QuickPeekFieldSpec, type QuickPeekProps, type RailAreaItem, type RailProps, type RecordIdBadgeProps, type RefComboboxProps, type RefFieldItem, type RefFieldProps, type RefreshControlProps, type Refs, type ResponsiveBreakpoints, type ResponsiveMode, ResponsiveModeProvider, type ResponsiveViewport, type ReturnTarget, type RowFieldProps, type RowHelpers, type RunActionOptions, type Schema, type Screen, type ScreenBack, type ScrollAnchor, type ScrollableVirtualizer, type SectionBadge, type SectionCardProps, type SectionEmphasis, type SelectOption, type SelectProps, type SidebarProps, type StatTileProps, type StatTileTone, type StatusDef, type StatusGroupDef, type StatusInfo, type StructureDef, type TabItem, type TabStripProps, type TagsInputProps, type Tenant, type TenantChipProps, type TextAreaProps, type TextFn, type TextInputProps, type TextVars, type TooltipProps, type TopBarProps, type UploadCheck, type UploadProgress, type UploadedFile, type UseObjectActionsResult, type UseScreenBackOptions, type UseScreenTabOptions, type V2ListParams, type V2ListResponse, type V2Meta, type V2ParamInstance, type V2PropertyInstance, type V2StatusInstance, type ViewFieldProps, type ViewportCategory, buildActionBody, buildDetailHrefFromId, buildEntityDetailHref, buildRowDetailHref, countActiveFilters, deleteObject, executeAction$1 as executeAction, extractPkValues, fieldDisplayName, getIcon, getPrimaryKeyFields, hasOrGroups, isCursorStaleError, makeTextFn, parseFilterURLState, parseFiltersFromURL, pickLocalized, pkValuePartsToId, pkValuesFromId, pkValuesToDetailId, pkValuesToId, pluralText, resolveDetailRoute, resolveViewportCategory, restoreObject, setFiltersInURL, setIconRegistry, textWithNodes, useLocation, useNavigate, useParams, useResponsiveMode, useSearchParams };