@declarion/react 0.57.0 → 0.59.0

package/dist-lib/components/actions/ResponsiveActionBar.d.ts

@@ -2,10 +2,10 @@
  * ResponsiveActionBar - placement-agnostic action toolbar.
  *
  * Consumes a resolved + RBAC-pruned ResolvedActionLayoutNode[] from the server
- * (plan §8) and renders it as an inline bar with overflow "More" dropdown
+ * and renders it as an inline bar with overflow "More" dropdown
  * (kind="detail"/"toolbar") or as a single kebab "⋮" (kind="row").
  *
- * Measurement algorithm (plan §9):
+ * Measurement algorithm:
  *   1. Off-screen layer renders every leaf + group trigger invisibly.
  *   2. ResizeObserver tracks container width.
  *   3. On layout or container-width change, greedy-fill in position-ascending
@@ -14,7 +14,7 @@
  *   4. visibility:hidden until first measurement completes (avoids FOUC).
  *      16ms timeout fallback in case ResizeObserver fires late.
  *
- * Selection-state performance (plan §9 "Selection-state performance"):
+ * Selection-state performance:
  *   kind="toolbar" pre-resolves and pre-measures BOTH static (no selection)
  *   and bulk (selection > 0) variants at initial mount. The rowSelection toggle
  *   swaps which variant renders WITHOUT re-measuring.
@@ -25,6 +25,7 @@
  */
 import type { Action, Entity, Screen } from "../../types/schema.d.ts";
 import type { ResolvedActionLayoutNode, ResolvedActionLeaf } from "../../lib/actions.d.ts";
+import { type TextFn } from "../../hooks/useText.d.ts";
 /**
  * Action-trigger callback. Returns a promise when the caller dispatches an
  * awaitable action (direct-run via ActionRunner); the bar awaits it so the
@@ -48,12 +49,12 @@ export interface TabMeta {
 }
 /**
  * Minimal dispatch surface assembled by SmartListPage/DetailLayout and passed
- * to ResponsiveActionBar. Phase 1 only consumes what `href` dispatch needs
- * plus the seat for the Phase 2 widget registry mount.
+ * to ResponsiveActionBar. It carries what `href` dispatch needs plus the seat
+ * for a future widget registry mount.
  *
  * Reason: defining the full WidgetContext now would freeze a surface before
- * the widget registry has a real consumer. Phase 1 ships exactly the fields
- * the href dispatch reads; Phase 2 will extend without breaking callers.
+ * the widget registry has a real consumer. It holds exactly the fields the
+ * href dispatch reads and extends without breaking callers.
  */
 export interface WidgetContext {
     /** Resolved entity for the current page; widget code reads schema metadata. */
@@ -68,8 +69,8 @@ export interface WidgetContext {
     selectedRows: Record<string, unknown>[];
     /** PK values of the currently selected rows, in selection order. */
     selectedIds: string[];
-    /** Active UI locale (e.g. "en", "ru"). */
-    locale: string;
+    /** Reads declared words in the reader's language; `t.language` formats values. */
+    t: TextFn;
     /** Opens or switches to a tab in the SDK shell. */
     tabNavigate: (url: string, meta?: TabMeta) => void;
     /** Invokes a server action and returns its response envelope. */
@@ -85,7 +86,7 @@ export interface WidgetContext {
 }
 /**
  * Telemetry payload emitted on every action click. Stays scalar by design -
- * no Action reference or i18n strings (plan §8 last paragraph).
+ * no Action reference or i18n strings.
  *
  * Reason: display.name may carry tenant-customized strings with PII; the
  * payload feeds analytics pipelines and MUST NOT leak them.
@@ -160,8 +161,9 @@ export interface ResponsiveActionBarProps {
     /** aria-label for the toolbar root. Defaults to "Actions". */
     ariaLabel?: string;
     /**
-     * Dispatch surface for client-side action modes (`href` today, `widget` in
-     * Phase 2). When omitted, every action falls through to `onRun`.
+     * Dispatch surface for client-side action modes (`href` today, `widget` once
+     * the widget registry exists). When omitted, every action falls through to
+     * `onRun`.
      *
      * Reason: keeps the bar usable from contexts that have no router or schema
      * runtime (test fixtures, storybook) while letting production callers wire
@@ -169,7 +171,7 @@ export interface ResponsiveActionBarProps {
      */
     widgetContext?: WidgetContext;
     /**
-     * Telemetry sink fired on every action click (plan §8). Payload stays
+     * Telemetry sink fired on every action click. Payload stays
      * scalar - no Action reference or i18n strings.
      *
      * Reason: feeds analytics without leaking tenant-customized labels.
@@ -180,7 +182,7 @@ export interface RowMenuContentProps {
     /**
      * Row-stated + nav-suppressed layout. BOTH triggers pass the identical shape:
      * the kebab (anchored) and the right-click menu (at the cursor) compose the
-     * same leaves so their menus are structurally identical (Invariant 1).
+     * same leaves so their menus are structurally identical.
      */
     layout: ResolvedActionLayoutNode[];
     entityActions: Record<string, Action> | undefined;
@@ -201,8 +203,7 @@ export interface RowMenuContentProps {
 }
 /**
  * RowMenuContent is the ONE renderer of Row Menu body content, shared by the
- * kebab and the right-click menu (plan 2026-07-19-unified-row-menu, Invariant
- * 1). It partitions destructive-last, draws a divider after the leading
+ * kebab and the right-click menu. It partitions destructive-last, draws a divider after the leading
  * navigation run (__peek / __open), and renders every leaf through the same
  * DropdownLeafItem / DropdownGroupSection path used everywhere else - so the two
  * triggers cannot structurally diverge. It renders no chrome and owns no

package/dist-lib/components/agents/AgentChatPanel.d.ts

@@ -1,13 +1,3 @@
-export interface AgentChatPanelProps {
-    open: boolean;
-    onClose: () => void;
-    /** Reserved for conversation context; the current action does not persist it. */
-    context?: string;
-    title?: string;
-    /** A question typed somewhere else - the command palette - to send once
-     *  the panel opens. The palette promises "Press Enter to ask"; without
-     *  this it opened the panel and threw the question away. */
-    askOnOpen?: string;
-}
-export declare function AgentChatPanel({ open, onClose, context, title, askOnOpen }: AgentChatPanelProps): import("react").JSX.Element | null;
-export declare function proposalFallback(code: string): string;
+import type { AgentChatPanelProps } from "./AgentChatPanel.impl";
+export type { AgentChatPanelProps } from "./AgentChatPanel.impl";
+export declare function AgentChatPanel(props: AgentChatPanelProps): import("react").JSX.Element | null;

package/dist-lib/components/agents/AgentChatPanel.impl.d.ts

@@ -0,0 +1,14 @@
+import { type TextFn } from "../../lib/language.d.ts";
+export interface AgentChatPanelProps {
+    open: boolean;
+    onClose: () => void;
+    /** Reserved for conversation context; the current action does not persist it. */
+    context?: string;
+    title?: string;
+    /** A question typed somewhere else - the command palette - to send once
+     *  the panel opens. The palette promises "Press Enter to ask"; without
+     *  this it opened the panel and threw the question away. */
+    askOnOpen?: string;
+}
+export declare function AgentChatPanel({ open, onClose, context, title, askOnOpen }: AgentChatPanelProps): import("react").JSX.Element | null;
+export declare function proposalFallback(t: TextFn, code: string): string;

package/dist-lib/components/agents/AgentPicker.d.ts

@@ -3,7 +3,6 @@ export interface AgentPickerProps {
     agents: AvailableAgent[];
     selectedId?: string;
     onSelect: (id: string) => void;
-    locale: string;
     label: string;
 }
-export declare function AgentPicker({ agents, selectedId, onSelect, locale, label }: AgentPickerProps): import("react").JSX.Element | null;
+export declare function AgentPicker({ agents, selectedId, onSelect, label }: AgentPickerProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,7 @@
+import type { ReactNode, Ref } from "react";
+export interface PageShellProps {
+    header: ReactNode;
+    children: ReactNode;
+    scrollRef?: Ref<HTMLDivElement>;
+}
+export declare function PageShell({ header, children, scrollRef }: PageShellProps): import("react").JSX.Element;

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

@@ -1,7 +1,6 @@
 import type { ReactNode } from "react";
 interface RecordHeaderProps {
     icon?: ReactNode;
-    avatarName?: string;
     title: string;
     recordId?: string;
     description?: string;
@@ -14,5 +13,5 @@ interface RecordHeaderProps {
     identityControls?: ReactNode;
     showTitle?: boolean;
 }
-export declare function RecordHeader({ icon, avatarName, title, recordId, description, highlights, mode, dirty, showBack, onBack, right, identityControls, showTitle, }: RecordHeaderProps): import("react").JSX.Element;
+export declare function RecordHeader({ icon, title, recordId, description, highlights, mode, dirty, showBack, onBack, right, identityControls, showTitle, }: RecordHeaderProps): import("react").JSX.Element;
 export {};

package/dist-lib/components/detail-layout/DetailAuditStrip.d.ts

@@ -7,7 +7,6 @@ interface DetailAuditStripProps {
     record: Record<string, unknown>;
     refs?: Refs;
     schema: Schema;
-    locale: string;
 }
-export declare function DetailAuditStrip({ screen, entity, entityCode, record, refs, schema, locale, }: DetailAuditStripProps): import("react").JSX.Element | null;
+export declare function DetailAuditStrip({ screen, entity, entityCode, record, refs, schema, }: DetailAuditStripProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/detail-layout/DetailHighlights.d.ts

@@ -9,7 +9,6 @@ interface DetailHighlightsProps {
     refs?: Refs;
     objectStatuses?: StatusInfo[];
     schema: Schema;
-    locale: string;
 }
-export declare function DetailHighlights({ screen, entity, entityCode, record, refs, objectStatuses, schema, locale, }: DetailHighlightsProps): import("react").JSX.Element | null;
+export declare function DetailHighlights({ screen, entity, entityCode, record, refs, objectStatuses, schema, }: DetailHighlightsProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/detail-layout/blockMeta.d.ts

@@ -1,4 +1,5 @@
 import type { LayoutNode } from "../../types/schema.d.ts";
 import type { LayoutContext } from "./LayoutRenderer";
-export declare function resolveBlockLabel(node: LayoutNode, ctx: LayoutContext): string;
+import type { TextFn } from "../../lib/language.d.ts";
+export declare function resolveBlockLabel(node: LayoutNode, ctx: LayoutContext, t: TextFn): string;
 export declare function resolveBlockIcon(node: LayoutNode, ctx: LayoutContext): string | undefined;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function BoolField({ value, mode, onChange, fieldId, labelId }: FieldRendererProps): import("react").JSX.Element;
+export declare function BoolField({ value, onChange, fieldId, labelId }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function EnumField({ field, value, mode, onChange, fieldId, labelId }: FieldRendererProps): import("react").JSX.Element;
+export declare function EnumField({ field, value, mode, onChange, fieldId, labelId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function IntArrayField({ field, fieldName, value, mode, onChange, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function IntArrayField({ field, fieldName, value, mode, onChange, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -0,0 +1,2 @@
+import type { FieldRendererProps } from "./index";
+export declare function MultilangArrayField(props: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function MultilangField({ field, fieldName, value, mode, onChange, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function MultilangField({ field, fieldName, value, mode, onChange, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function MultilangTextField({ field, fieldName, value, mode, onChange, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function MultilangTextField({ field, fieldName, value, mode, onChange, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function NumberField({ field, fieldName, value, mode, onChange, record, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function NumberField({ field, fieldName, value, mode, onChange, record, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function PasswordField({ field, fieldName, value, mode, onChange, record, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function PasswordField({ field, fieldName, value, mode, onChange, record, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -42,4 +42,4 @@ export interface RefComboboxProps {
  * 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;
+export declare function RefCombobox({ ref: refConfig, value, onChange, refs, displayFieldOverride, id, labelId, ariaLabel, required, placeholder: placeholderOverride, specialValues, }: RefComboboxProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function SecretField({ field, fieldName, value, mode, onChange, record, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function SecretField({ field, fieldName, value, mode, onChange, record, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function StringArrayField({ field, fieldName, value, mode, onChange, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function StringArrayField({ field, fieldName, value, mode, onChange, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

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

@@ -1,2 +1,2 @@
 import type { FieldRendererProps } from "./index";
-export declare function TimestampField({ field, fieldName, value, mode, onChange, fieldId }: FieldRendererProps): import("react").JSX.Element;
+export declare function TimestampField({ field, fieldName, value, mode, onChange, fieldId, t }: FieldRendererProps): import("react").JSX.Element;

package/dist-lib/components/fields/cells/registry.d.ts

@@ -12,9 +12,10 @@ export interface CellResolveCtx {
     entities?: Record<string, Entity>;
     screens?: Record<string, Screen>;
     refs?: Refs | (() => Refs | undefined);
-    locale: string;
+    t: TextFn;
     detailScreen?: string;
 }
 export type CellFactory = (ctx: CellResolveCtx) => CellRenderer;
+import type { TextFn } from "../../../lib/language.d.ts";
 export declare const REGISTRY_WIDGETS: readonly string[];
 export declare function resolveCellRenderer(ctx: CellResolveCtx): CellRenderer;

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

@@ -1,6 +1,7 @@
 import type { EntityField, Entity, Screen } from "../../types/schema.d.ts";
 import { type FieldType } from "../../types/fieldType.d.ts";
 import type { Refs } from "../../types/api.d.ts";
+import type { TextFn } from "../../lib/language.d.ts";
 export type { Refs };
 export interface FieldRendererProps {
     field: EntityField;
@@ -19,7 +20,7 @@ export interface FieldRendererProps {
     entity?: Entity;
     entities?: Record<string, Entity>;
     screens?: Record<string, Screen>;
-    locale: string;
+    t: TextFn;
     detailScreen?: string;
 }
 type FieldRenderer = React.ComponentType<FieldRendererProps>;

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

@@ -0,0 +1,2 @@
+export type LangMap = Record<string, string>;
+export declare function parseLangMap(value: unknown): LangMap;

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

@@ -0,0 +1,2 @@
+export declare const SECRET_SENTINEL = "[SET]";
+export declare function holdsSecret(value: unknown): boolean;

package/dist-lib/components/file-widgets/UnknownFileWidget.d.ts

@@ -0,0 +1,3 @@
+export declare function UnknownFileWidget({ widgetCode }: {
+    widgetCode: string;
+}): import("react").JSX.Element;

package/dist-lib/components/file-widgets/UploadFailureText.d.ts

@@ -0,0 +1,4 @@
+import type { UploadFailure } from "./upload";
+export declare function UploadFailureText({ failure }: {
+    failure: UploadFailure;
+}): import("react").JSX.Element;

package/dist-lib/components/file-widgets/helpers.d.ts

@@ -4,7 +4,7 @@ export interface FocalPoint {
     x: number;
     y: number;
 }
-export declare function resolveFileAltText(file: HydratedFile | null, alt: string | undefined, fallback: string): string;
+export declare function resolveFileAltText(file: HydratedFile | null, alt: string | undefined, fallback: string, language: string, deploymentLanguage: string): string;
 export declare function canPreviewFile(file: HydratedFile): boolean;
 export declare function previewFileURL(file: HydratedFile): string | undefined;
 export declare function downloadFileURL(file: HydratedFile): string | undefined;

package/dist-lib/components/file-widgets/host.d.ts

@@ -2,13 +2,14 @@ import type { ReactNode } from "react";
 import type { Entity, Screen } from "../../types/schema.d.ts";
 import type { FileFieldDef, FileFieldValue } from "../../types/files.d.ts";
 import type { Refs } from "../fields/index.d.ts";
+import type { TextFn } from "../../lib/language.d.ts";
 export declare function getEntityFileField(entity: Pick<Entity, "files">, fieldName: string): FileFieldDef | undefined;
 export declare function getFileFieldValue(record: Record<string, unknown>, fieldName: string): FileFieldValue;
 export declare function getSchemaFieldValue(entity: Pick<Entity, "fields" | "files">, record: Record<string, unknown>, fieldName: string): unknown;
 export declare function serializeSchemaFieldValue(entity: Pick<Entity, "fields" | "files">, fieldName: string, value: unknown): unknown;
-export declare function resolveSchemaFieldLabel(entity: Pick<Entity, "fields" | "files">, fieldName: string, entities?: Record<string, Entity>): string;
+export declare function resolveSchemaFieldLabel(t: TextFn, entity: Pick<Entity, "fields" | "files">, fieldName: string, entities?: Record<string, Entity>): string;
 export declare function renderSchemaField(props: {
-    entity: Pick<Entity, "fields" | "files">;
+    entity: Pick<Entity, "fields" | "files"> & Partial<Pick<Entity, "display">>;
     entityCode?: string;
     fieldName: string;
     record: Record<string, unknown>;
@@ -19,7 +20,7 @@ export declare function renderSchemaField(props: {
     surface?: "list" | "detail";
     entities?: Record<string, Entity>;
     screens?: Record<string, Screen>;
-    locale: string;
+    t: TextFn;
     fieldId?: string;
     labelId?: string;
     structure?: string;

package/dist-lib/components/file-widgets/types.d.ts

@@ -9,6 +9,7 @@ export interface FileWidgetProps {
     onChange?: (next: FileFieldValue) => void;
     disabled?: boolean;
     alt?: string;
+    recordTitle?: string;
     uploadFieldCode?: string;
     uploadSlotCode?: string;
     fieldId?: string;

package/dist-lib/components/file-widgets/upload.d.ts

@@ -1,3 +1,4 @@
+import type { TextFn } from "../../lib/language.d.ts";
 import type { UploadProgress, UploadedFile } from "./types";
 export interface UploadOptions {
     file: File;
@@ -17,14 +18,28 @@ export declare class UploadError extends Error {
     /** A declared member of this error's type, read the one way. */
     ext<T = unknown>(member: string): T | undefined;
 }
+export interface UploadFailure {
+    code: string;
+    message: string;
+    detail?: string;
+}
+export declare function uploadFailure(t: TextFn, errorTitle: TextFn, err: unknown): UploadFailure;
 export interface UploadEnvelope {
     status: string;
     result: UploadedFile;
 }
 export declare function uploadFile(opts: UploadOptions): Promise<UploadedFile>;
 export declare function discardFile(fileId: string): Promise<void>;
-export declare function validateClientSide(file: File, accepts: string[] | undefined, maxBytes: number | undefined): {
-    code: string;
+export type UploadCheck = {
+    code: "file.too_large";
+    message: string;
+    size: number;
+    max: number;
+} | {
+    code: "file.field_violation";
     message: string;
-} | null;
+    type: string;
+};
+export declare function validateClientSide(file: File, accepts: string[] | undefined, maxBytes: number | undefined): UploadCheck | null;
+export declare function uploadCheckFailure(t: TextFn, errorTitle: TextFn, check: UploadCheck): UploadFailure;
 export declare function formatBytes(n: number): string;

package/dist-lib/components/filters/filter-op-label.d.ts

@@ -0,0 +1,3 @@
+import { type FilterOp } from "../../lib/filters.d.ts";
+import type { TextFn } from "../../lib/language.d.ts";
+export declare function filterOpLabel(t: TextFn, op: FilterOp): string;

package/dist-lib/components/layout/ImpersonationBanner.d.ts

@@ -1,6 +1,6 @@
 /**
  * Sticky top-of-viewport banner shown for the entire duration of an
- * impersonation session (principle 8: "UI signals impersonation loudly").
+ * impersonation session: the UI signals impersonation loudly.
  * Never dismissable. Real user, target identity, expiry countdown, and
  * an explicit "End session" button are always visible.
  *

package/dist-lib/components/layout/ImpersonationFrame.d.ts

@@ -1,6 +1,6 @@
 /**
  * Fixed 4px viewport overlay frame that surrounds every route. Visible
- * for the duration of an impersonation session (principle 8). The
+ * for the duration of an impersonation session. The
  * pointer-events:none guarantees the frame never blocks clicks.
  *
  * Color comes from --impersonation-accent (amber by default). When

package/dist-lib/components/layout/Layout.d.ts

@@ -1,5 +1,6 @@
 import { useTabStore } from "../../stores/tabs.d.ts";
 import { type NavNode, type Screen } from "../../types/schema.d.ts";
 import type { Crumb } from "../chrome/Breadcrumbs.d.ts";
+import type { TextFn } from "../../lib/language.d.ts";
 export declare function Layout(): import("react").JSX.Element | null;
-export declare function buildCrumbs(nodes: NavNode[], screens: Record<string, Screen>, pathname: string, tabs: ReturnType<typeof useTabStore.getState>["tabs"], activeTabId: string | null, topLevelNavigate: (to: string) => void): Crumb[];
+export declare function buildCrumbs(t: TextFn, nodes: NavNode[], screens: Record<string, Screen>, pathname: string, tabs: ReturnType<typeof useTabStore.getState>["tabs"], activeTabId: string | null, topLevelNavigate: (to: string) => void): Crumb[];

package/dist-lib/components/layout/Sidebar.d.ts

@@ -1,4 +1,5 @@
 import { type NavNode } from "../../types/schema.d.ts";
+import type { TextFn } from "../../lib/language.d.ts";
 export interface SidebarProps {
     activeArea: string;
 }
@@ -7,5 +8,5 @@ interface SidebarSection {
     title: string;
     items: NavNode[];
 }
-export declare function buildSections(nodes: NavNode[], activeArea: string): SidebarSection[];
+export declare function buildSections(t: TextFn, nodes: NavNode[], activeArea: string): SidebarSection[];
 export {};

package/dist-lib/components/layout/TenantChip.d.ts

@@ -9,7 +9,7 @@ export interface TenantChipProps {
      * When true, the chip is disabled with a tooltip explaining why.
      * Used during impersonation: cross-tenant targeting at start is
      * supported, but mid-session tenant switching is undefined and
-     * locked (plan §"Cross-tenant impersonation").
+     * locked.
      */
     locked?: boolean;
     lockedReason?: string;

package/dist-lib/components/list/ViewSwitcher.d.ts

@@ -16,7 +16,9 @@ interface ViewSwitcherProps {
     onSelect: (view: ViewItem) => void;
     onSave?: () => void;
     onSaveAs?: () => void;
-    onSetDefault?: (viewId: string) => void;
+    onDiscard?: () => void;
+    onDelete?: (view: ViewItem) => void;
+    deletePending?: boolean;
 }
-export declare function ViewSwitcher({ views, activeViewId, isDirty, onSelect, onSave, onSaveAs, }: ViewSwitcherProps): import("react").JSX.Element;
+export declare function ViewSwitcher({ views, activeViewId, isDirty, onSelect, onSave, onSaveAs, onDiscard, onDelete, deletePending, }: ViewSwitcherProps): import("react").JSX.Element;
 export {};

package/dist-lib/components/pages/DocumentsMenu.d.ts

@@ -6,7 +6,6 @@ export interface DocumentsMenuProps {
     objectIds?: string[];
     viewState?: ListViewState;
     selectedIds?: string[];
-    locale?: string;
     /** Static system-template capability from the schema projection
      *  (`entity.documents`). Absent/both-falsy means no SYSTEM template
      *  applies for this caller/tenant/entity - the button still renders if
@@ -16,7 +15,7 @@ export interface DocumentsMenuProps {
      *  `document_template` is present & readable in `schema.entities`). Gates
      *  the lazy `document.templates.available` visibility probe so a
      *  template-less, non-manager caller - the default - makes ZERO extra
-     *  network calls - Business Case 6. */
+     *  network calls. */
     canManageTemplates?: boolean;
 }
 export declare function DocumentsMenu({ entityCode, scope, objectIds, viewState, selectedIds, capability, canManageTemplates, }: DocumentsMenuProps): import("react").JSX.Element | null;

package/dist-lib/components/pages/ExportMenu.d.ts

@@ -17,13 +17,11 @@ export interface ExportMenuProps {
     totalRows?: number;
     /** Per-page size of the current view (for the Current page label). */
     pageSize?: number;
-    /** Caller's UI locale (e.g. "en"). Server falls back to ui_language when omitted. */
-    locale?: string;
+    /** The language the file is written in: the window's, so the CSV reads as the screen does. */
+    language?: string;
     /** Optional placement override for the popover. */
     align?: "start" | "end";
-    /** When true, render only as a single MenuItem suitable for embedding inside
-     *  the existing selection menu (replaces the placeholder at :2007-2015).
-     *  Defaults to a full Btn + Dropdown toolbar item. */
+    /** A single MenuItem for embedding in a selection menu, instead of the toolbar Btn + Dropdown. */
     variant?: "toolbar" | "selection-menu-item";
     /** Optional click-handler ran before scope dispatch — e.g. to close a
      *  parent menu so the export popover doesn't stack underneath. */

package/dist-lib/components/pages/RecordDocumentsPanel.d.ts

@@ -16,8 +16,7 @@ interface RecordDocumentsPanelProps {
      *  template-less, non-manager caller - the default - makes ZERO
      *  document.object_links calls per record view. The rare orphaned-attachment
      *  case (a template was removed but its current-attached docs remain) then
-     *  surfaces only to managers on the record and to everyone via My Documents,
-     *  which is the right trade for the stakeholder's "no gratuitous cost" bar. */
+     *  surfaces only to managers on the record and to everyone via My Documents. */
     canManageTemplates?: boolean;
 }
 interface RecordDocument {

package/dist-lib/components/pages/auth/AuthShell.d.ts

@@ -2,21 +2,8 @@ import { type ReactNode } from "react";
 import { Icon } from "../../primitives/Icons.d.ts";
 export type AuthShellProps = {
     children: ReactNode;
-    /**
-     * Tenant slug used to compose the workspace pill. The pill renders
-     * `<tenantSlug>.<branding.identity.workspace_domain>` only when both pieces
-     * are set; otherwise it is hidden. Callers are not required to
-     * provide a slug — the auth shell fails closed (no pill) rather
-     * than display a placeholder host.
-     *
-     * Currently unwired in v1: no SDK caller passes this prop because
-     * frontend tenant-from-host resolution does not exist yet (see
-     * `docs/gotchas.md` "Tenant Resolution" — the deferred multi-tenant-
-     * via-host work). When that lands, callers will source the slug from
-     * `window.location.hostname` (or an equivalent middleware-supplied
-     * context) and thread it through. Until then the pill stays hidden;
-     * the prop is kept so the contract is in place for the follow-up.
-     */
+    /** With `branding.identity.workspace_domain`, shows the `<tenantSlug>.<domain>` pill. No SDK caller
+     *  passes it until tenant-from-host resolution exists. */
     tenantSlug?: string;
     tagline?: string;
     subTagline?: string;
@@ -25,21 +12,7 @@ export type AuthShellProps = {
     /** Optional override for the wordmark / app name shown in topbar + brand panel. */
     brandName?: string;
 };
-/**
- * The `Build …` half of the deploy-identity pill.
- *
- *   - release build: `<tag>+<short-revision>`, e.g. "1.4.2+a9b2c0d"
- *   - dev build: VERSION is itself an abbreviation of the SAME commit (the
- *     Makefile falls back to `git rev-parse --short HEAD` when there is no
- *     tag), so a `+<short-rev>` suffix would print one commit twice.
- *
- * The two strings abbreviate that commit to DIFFERENT lengths - git sizes
- * `--short` per repository (8 chars in this one) while the pill truncates the
- * revision to 7 - so they are compared on their common prefix. Comparing them
- * for equality reads as correct and never fires: it shipped the pill
- * "Build 01385f9a+01385f9", the same commit rendered twice.
- *
- * Exported for tests.
- */
+/** `<tag>+<short-revision>`, or the version alone when a dev build's VERSION already abbreviates the
+ *  same commit. git and the pill abbreviate to different lengths, so they compare on the common prefix. */
 export declare function formatBuildLabel(version?: string, revision?: string): string;
 export declare function AuthShell({ children, tenantSlug, tagline, subTagline, version, badges, brandName, }: AuthShellProps): import("react").JSX.Element;

package/dist-lib/components/pages/exportRequest.d.ts

@@ -1,6 +1,6 @@
 import type { FilterNode } from "../../lib/filters.d.ts";
-/** ExportQuery mirrors the Go ExportQuery struct (server/handlers/data_export.go).
- *  Field order matches; semantics match parseListParams 1:1. */
+/** ExportQuery is the list-query body the export endpoint accepts. Its
+ *  semantics match the server's list URL parameters 1:1. */
 export interface ExportQuery {
     screen?: string;
     filters?: FilterNode[];
@@ -20,7 +20,7 @@ export interface ExportRequest {
     query: ExportQuery;
     columns: string[];
     selection?: Array<Record<string, string>>;
-    locale?: string;
+    language?: string;
     /** v1 wire defaults: `header_style="label"`, `ref_mode="display"`. v2 will
      *  add `code` / `stable_key`. Omitted = server defaults. */
     header_style?: "label";
@@ -45,8 +45,6 @@ export interface ListViewState {
     page?: number;
     perPage?: number;
 }
-/** Locale resolver hook input — typically a string from the SDK ctx
- *  (e.g. `useLocale()`); empty/undefined defers to the server default. */
 export interface ExportIntent {
     scope: ExportScope;
     /** All visible columns in display order. _select / _actions are stripped
@@ -55,7 +53,7 @@ export interface ExportIntent {
     /** PK objects of the currently-selected rows. Non-empty only for
      *  `selected_rows` scope. */
     selectedRowPKs?: Array<Record<string, string>>;
-    locale?: string;
+    language?: string;
     filename?: string;
 }
 /** buildListQuery returns the canonical list-query JSON shape from the

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

@@ -0,0 +1,8 @@
+import type { ViewItem } from "../../list/ViewSwitcher.d.ts";
+interface DeleteViewDialogProps {
+    view: ViewItem | null;
+    onCancel: () => void;
+    onConfirm: (view: ViewItem) => void;
+}
+export declare function DeleteViewDialog({ view, onCancel, onConfirm }: DeleteViewDialogProps): import("react").JSX.Element;
+export {};