@declarion/react 0.57.0 → 0.59.2

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 {};

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

@@ -16,7 +16,6 @@ interface ListCardRowProps {
     /** The active saved view's columns, which the card projection may follow. */
     savedViewColumns: string[] | undefined;
     refs: ListResponse<RowData>["$refs"];
-    locale: string;
     renderers: Map<string, CellRenderer>;
     rowActions: {
         code: string;
@@ -36,5 +35,5 @@ interface ListCardRowProps {
     /** TanStack Virtual's measure ref, so a card sizes itself. */
     measureElement: (node: Element | null) => void;
 }
-export declare function ListCardRow({ row, rowIndex, entity, screen, entityCode, entities, savedViewColumns, refs, locale, renderers, rowActions, tabNavigate, interaction, hasSoftDelete, zebra, hasBatchActions, hasDetailTarget, rowKey, measureElement, }: ListCardRowProps): import("react").JSX.Element;
+export declare function ListCardRow({ row, rowIndex, entity, screen, entityCode, entities, savedViewColumns, refs, renderers, rowActions, tabNavigate, interaction, hasSoftDelete, zebra, hasBatchActions, hasDetailTarget, rowKey, measureElement, }: ListCardRowProps): import("react").JSX.Element;
 export {};

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

@@ -13,7 +13,6 @@ interface ListCardsBodyProps {
     entities: Record<string, Entity> | undefined;
     savedViewColumns: string[] | undefined;
     refs: ListResponse<RowData>["$refs"];
-    locale: string;
     renderers: Map<string, ReturnType<typeof resolveCellRenderer>>;
     rowActions: {
         code: string;

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

@@ -12,7 +12,7 @@ export interface ListFloatbarProps {
         code: string;
         action: Action;
     }[];
-    /** Server-emitted action_layout from screen (highest precedence per plan §3.9). */
+    /** Server-emitted action_layout from screen (highest precedence). */
     screenActionLayout?: ResolvedActionLayoutNode[];
     /** Server-emitted action_layout from entity. Used when screen has none. */
     entityActionLayout?: ResolvedActionLayoutNode[];
@@ -23,7 +23,7 @@ export interface ListFloatbarProps {
     screen?: Screen;
     onClear: () => void;
     onActionSuccess: () => void;
-    /** Dispatch surface threaded into ResponsiveActionBar (plan §8 Task 10). */
+    /** Dispatch surface threaded into ResponsiveActionBar. */
     widgetContext: WidgetContext;
 }
 export declare function ListFloatbar({ selectedIds, floatbarActions, screenActionLayout, entityActionLayout, data, rowKey, entityCode, entity, screen, onClear, onActionSuccess, widgetContext, }: ListFloatbarProps): import("react").JSX.Element | null;

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

@@ -12,7 +12,7 @@ export interface ListHeaderProps {
         code: string;
         action: Action;
     }[];
-    /** Server-emitted action_layout from screen (highest precedence per plan §3.9). */
+    /** Server-emitted action_layout from screen (highest precedence). */
     screenActionLayout?: ResolvedActionLayoutNode[];
     /** Server-emitted action_layout from entity. Used when screen has none. */
     entityActionLayout?: ResolvedActionLayoutNode[];
@@ -20,7 +20,7 @@ export interface ListHeaderProps {
     data: Record<string, unknown>[];
     rowKey: (row: Record<string, unknown>) => string;
     onActionSuccess: () => void;
-    /** Dispatch surface threaded into ResponsiveActionBar (plan §8 Task 10). */
+    /** Dispatch surface threaded into ResponsiveActionBar. */
     widgetContext: WidgetContext;
 }
 export declare function ListHeader({ title, description, toolbarActions, screenActionLayout, entityActionLayout, selectedIds, data, rowKey, onActionSuccess, widgetContext, }: ListHeaderProps): import("react").JSX.Element | null;

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

@@ -1,10 +1,9 @@
 import type { ReactNode } from "react";
 import { type Action, type Entity, type Screen } from "../../../types/schema.d.ts";
-/** The sentence a failed load shows: the server's own, then the two members
- *  saying WHICH value it is about - without them the reader is told something
- *  went wrong and not what to change. Never the machine code, which is already
- *  in the console and the audit. */
-export declare function listLoadErrorDescription(error: unknown): string;
+import { type TextFn } from "../../../hooks/useText.d.ts";
+/** The failure's title, then the field and the value it is about, so the reader
+ *  knows what to change. The field reads by its declared label, never its code. */
+export declare function listLoadErrorDescription(t: TextFn, errorTitle: TextFn, entity: Entity, error: unknown): string;
 interface ListNoRowsProps {
     isLoading: boolean;
     /** The load has been running long enough to be worth saying so. */

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

@@ -1,3 +1,4 @@
+import { type ViewItem } from "../../list/ViewSwitcher.d.ts";
 import type { FilterNode } from "../../../lib/filters.d.ts";
 import { type Entity, type Schema, type Screen } from "../../../types/schema.d.ts";
 import type { ListColumnLayout } from "./useListColumnLayout";
@@ -12,7 +13,6 @@ interface ListToolbarProps {
     schema: Schema | undefined;
     screenCode: string;
     screenName: string;
-    locale: string;
     isPhone: boolean;
     /** Cards mode has no column headers, so sorting moves into a menu here. */
     isCardsPresentation: boolean;
@@ -30,6 +30,7 @@ interface ListToolbarProps {
     searchValue: string;
     onSearchChange: (value: string) => void;
     onSaveView: () => void;
+    onDeleteView: (view: ViewItem) => void;
     page: number;
     perPage: number;
     includeDeleted: boolean;
@@ -41,5 +42,5 @@ interface ListToolbarProps {
     /** The screen is current - useScreenIsLive. */
     isLive: boolean;
 }
-export declare function ListToolbar({ screen, entity, entityCode, schema, screenCode, screenName, locale, isPhone, isCardsPresentation, sort, columns, views, query, selection, filters, searchValue, onSearchChange, onSaveView, page, perPage, includeDeleted, canViewDeleted, onToggleDeleted, realtime, isLive, }: ListToolbarProps): import("react").JSX.Element;
+export declare function ListToolbar({ screen, entity, entityCode, schema, screenCode, screenName, isPhone, isCardsPresentation, sort, columns, views, query, selection, filters, searchValue, onSearchChange, onSaveView, onDeleteView, page, perPage, includeDeleted, canViewDeleted, onToggleDeleted, realtime, isLive, }: ListToolbarProps): import("react").JSX.Element;
 export {};

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

@@ -0,0 +1,10 @@
+interface ListUrlBannerProps {
+    filterError: string | null;
+    unresolvedViewId: string | null;
+    onClearFilters: () => void;
+    onClearView: () => void;
+}
+/** A URL the list could not honour. The malformed filter is reported first: it
+ *  is the one the caller can act on without knowing anything about views. */
+export declare function ListUrlBanner({ filterError, unresolvedViewId, onClearFilters, onClearView, }: ListUrlBannerProps): import("react").JSX.Element | null;
+export {};

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

@@ -4,7 +4,7 @@ export interface RowActionsCellProps {
     rowId: string;
     /** detail_screen for row-click navigation. The component reads
      *  screen.action_layout via cast to ResolvedActionLayoutNode[] (server emits
-     *  the resolved wire shape per plan §8 even though the raw Screen TS type
+     *  the resolved wire shape even though the raw Screen TS type
      *  declares ActionLayoutNode[] for authoring). */
     screen: {
         detail_screen?: string;
@@ -30,7 +30,5 @@ export interface RowActionsCellProps {
     /** Opens the Quick peek drawer for the row (used by both the __peek menu
      *  item and the hover eye button). */
     onPeek: (row: Record<string, unknown>) => void;
-    /** Active UI locale, forwarded into the row-scoped WidgetContext. */
-    locale: string;
 }
-export declare function RowActionsCell({ row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, peekAllowed, hasDetailTarget, onPeek, locale, }: RowActionsCellProps): import("react").JSX.Element;
+export declare function RowActionsCell({ row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, peekAllowed, hasDetailTarget, onPeek, }: RowActionsCellProps): import("react").JSX.Element;

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

@@ -20,10 +20,9 @@ export interface RowContextMenuProps {
         icon?: string;
         search?: string;
     }) => void;
-    locale: string;
     peekAllowed: boolean;
     hasDetailTarget: boolean;
     onPeek: (row: Record<string, unknown>) => void;
     onClose: () => void;
 }
-export declare function RowContextMenu({ x, y, row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, locale, peekAllowed, hasDetailTarget, onPeek, onClose, }: RowContextMenuProps): import("react").JSX.Element | null;
+export declare function RowContextMenu({ x, y, row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, peekAllowed, hasDetailTarget, onPeek, onClose, }: RowContextMenuProps): import("react").JSX.Element | null;

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

@@ -3,6 +3,7 @@ import type { ListColumnDef } from "./table-features";
 import { type Refs } from "../../fields/cells/registry.d.ts";
 import type { Action, Entity, Screen } from "../../../types/schema.d.ts";
 import type { RowData } from "../../../types/api.d.ts";
+import type { TextFn } from "../../../lib/language.d.ts";
 type SchemaMaps = {
     entities?: Record<string, Entity>;
     screens?: Record<string, Screen>;
@@ -28,7 +29,7 @@ export interface BuildListColumnsArgs {
     /** True when the entity has a detail route; drives __open availability in the
      *  row menu (composite-PK entities have no detail page). */
     hasDetailTarget: boolean;
-    userLocale: string;
+    t: TextFn;
     tabNavigate: (href: string, opts?: {
         title?: string;
         icon?: string;

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

@@ -1,5 +1,6 @@
 import type { Entity, Screen, ScreenFilterSpecialValues } from "../../../types/schema.d.ts";
 import type { FilterFieldMeta } from "../../filters/FilterDrawer.d.ts";
+import type { TextFn } from "../../../lib/language.d.ts";
 /**
  * Build FilterFieldMeta array from screen + entity for the FilterDrawer.
  *
@@ -18,7 +19,7 @@ import type { FilterFieldMeta } from "../../filters/FilterDrawer.d.ts";
  * every entity field otherwise. That is a UI affordance, not an access control:
  * the server applies no screen scoping to caller filters.
  */
-export declare function buildFilterFieldMeta(screen: (Pick<Screen, "filters"> & {
+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[];

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

@@ -0,0 +1,38 @@
+import type { FilterNode } from "../../../lib/filters.d.ts";
+import type { 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
+ *  different sign-in is a different caller with a different default. */
+export declare function defaultViewClearedKey(screenCode: string, tenantId?: string, userId?: string): string;
+interface ActiveViewInput {
+    screenCode: string;
+    screen: Screen | undefined;
+    searchParams: URLSearchParams;
+    setSearchParams: (next: URLSearchParams, options?: {
+        replace?: boolean;
+    }) => void;
+    userId: string | undefined;
+    tenantId: string | undefined;
+    filterError: boolean;
+}
+export interface ViewDefaults {
+    filters: FilterNode[];
+    columns: string[];
+    sort: string | undefined;
+}
+export interface ActiveView {
+    all: ViewItem[];
+    activeId: string | null;
+    active: ViewItem | undefined;
+    defaults: ViewDefaults;
+    clearedKey: string;
+    clearActiveView: () => void;
+    retryViews: () => void;
+    isUnresolved: boolean;
+    isHeld: boolean;
+}
+/** 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 {};

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

@@ -5,18 +5,19 @@ interface ListColumnLayoutInput {
     screen: Screen | undefined;
     searchParams: URLSearchParams;
     setSearchParams: (next: URLSearchParams) => void;
+    defaultColumns: string[];
 }
 /** Which columns a list shows, in what order, and how wide. */
 export interface ListColumnLayout {
-    /** The ordered visible set, from `?columns` or the screen/view default. */
+    /** The ordered visible set, from `?columns` or the active view / screen. */
     visible: string[];
     /** Live widths during a drag; the device store is the durable backing. */
     sizing: ColumnSizingState;
     setSizing: (updater: ColumnSizingState | ((prev: ColumnSizingState) => ColumnSizingState)) => void;
-    /** Apply a new ordered visible set - the one path for toggle, reorder and
-     *  show-all. */
+    /** The one path for toggle, reorder and show-all. Choosing exactly the
+     *  default set writes no parameter, so it IS returning to the view. */
     apply: (next: string[]) => void;
-    /** Back to the screen or view default: drop `?columns`. Widths untouched. */
+    /** Back to the view's columns, else the screen's. Widths untouched. */
     clear: () => void;
     /** Drag-free reorder: swap one column a slot up or down. */
     move: (col: string, dir: "up" | "down") => void;
@@ -33,5 +34,5 @@ export interface ListColumnLayout {
  * the server and never part of a saved view - which is why the two live in
  * different places and why a resize says so the first time.
  */
-export declare function useListColumnLayout({ screenCode, screen, searchParams, setSearchParams, }: ListColumnLayoutInput): ListColumnLayout;
+export declare function useListColumnLayout({ screenCode, screen, searchParams, setSearchParams, defaultColumns, }: ListColumnLayoutInput): ListColumnLayout;
 export {};

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

@@ -14,9 +14,10 @@ interface ListQueryInput {
     sortForRequest: string | undefined;
     debouncedSearch: string;
     filters: FilterNode[];
-    /** A malformed `?filters=` bookmark: the list loads unfiltered and the screen
-     *  shows the error rather than sending something the backend refuses. */
-    filterError: boolean;
+    /** The effective query depends on a view not known yet: nothing is sent,
+     *  and nothing is reported as loaded. */
+    isHeld: boolean;
+    retryHeld: () => void;
     includeDeleted: boolean;
     expand: string[] | undefined;
     select: string[] | undefined;
@@ -24,7 +25,6 @@ interface ListQueryInput {
      *  to size its pager; a screen that loads one window and shows what it loaded
      *  would pay a request per load for a number nothing renders. */
     runCountQuery: boolean;
-    /** The canonical form of the URL, so a change resets the stale-loading clock. */
     urlKey: string;
 }
 /** One view over the rows a list screen shows, whichever source produced them. */

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

@@ -3,14 +3,14 @@ import { type SortCol, type SortNulls } from "../../../lib/sort.d.ts";
 interface ListSortInput {
     searchParams: URLSearchParams;
     setSearchParams: (next: URLSearchParams) => void;
-    /** The screen's declared `sort_default`, used when the URL carries none. */
-    screenSortDefault: string | undefined;
+    defaultSort: string | undefined;
     /** Commits the URL to the tab store in the same interaction, before React
      *  Router schedules the navigation. */
     commitScreenTabSearch: (search: string) => void;
 }
 /** How a list is ordered, and every gesture that changes it. */
 export interface ListSortState {
+    value: string;
     /** The parser-filtered columns, which the header and the saved-view path read. */
     cols: SortCol[];
     /** Per-column NULLs placement, which TanStack's `{id, desc}` cannot model. */
@@ -21,7 +21,8 @@ export interface ListSortState {
     forRequest: string | undefined;
     /** The same order in TanStack's own shape. */
     tableSorting: SortingState;
-    /** The one writer of the URL `sort` param. */
+    /** The one writer of the URL `sort` param. An order equal to the default
+     *  writes nothing; a cleared one writes `sort=`, which is no order. */
     write: (cols: SortCol[]) => void;
     /** Replace the whole sort with one column, as a plain header click does. */
     applyColumn: (field: string, dir: "asc" | "desc", nulls: SortNulls | undefined) => void;
@@ -41,5 +42,5 @@ export interface ListSortState {
  * Router schedules the navigation - that is what closes the mount-effect race
  * for the header, the menu and the mobile sort sheet alike.
  */
-export declare function useListSort({ searchParams, setSearchParams, screenSortDefault, commitScreenTabSearch, }: ListSortInput): ListSortState;
+export declare function useListSort({ searchParams, setSearchParams, defaultSort, commitScreenTabSearch, }: ListSortInput): ListSortState;
 export {};

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

@@ -1,6 +1,7 @@
-import type { FilterNode } from "../../../lib/filters.d.ts";
+import { type FilterNode } from "../../../lib/filters.d.ts";
 import { 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;
@@ -10,28 +11,37 @@ interface ListViewsInput {
     }) => void;
     userId: string | undefined;
     tenantId: string | undefined;
-    /** A malformed `?filters=` bookmark. A visible recoverable state must not be
-     *  replaced by a personal default view before the user can see it. */
-    filterError: boolean;
-    /** The live layout, compared against the saved one to decide dirtiness and
+    /** The screen's views and which one is active, resolved above the hooks that
+     *  derive the layout from it. */
+    all: ViewItem[];
+    activeId: string | null;
+    active: ViewItem | undefined;
+    clearedKey: string;
+    /** The EFFECTIVE layout - the view's own values unless the URL overrides
+     *  them. Compared against the saved one for the unsaved-change marker, and
      *  written into a save. */
     filters: FilterNode[];
     visibleColumns: string[];
-    sort: string | undefined;
+    sort: string;
 }
 /** Which saved view a list screen is showing, and every way that changes. */
 export interface ListViews {
     all: ViewItem[];
     activeId: string | null;
     active: ViewItem | undefined;
+    clearedKey: string;
     /** True when the live layout differs from what the active view saved. */
     isDirty: boolean;
     /** Open a view, or clear to no view. Also the reset gesture: open the same
      *  view again. */
     apply: (view: ViewItem) => void;
+    /** Drop every override and go back to what the active view holds. */
+    discard: () => void;
     saveAsNew: (name: string) => Promise<void>;
     overwriteActive: () => Promise<void>;
+    deleteView: (view: ViewItem) => Promise<void>;
     isSaving: boolean;
+    isDeleting: boolean;
 }
 /**
  * The saved views a list screen offers.
@@ -39,8 +49,8 @@ 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, filterError, filters, visibleColumns, sort, }: ListViewsInput): ListViews;
+export declare function useListViews({ screenCode, screen, 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(active: ViewItem | undefined): string | null;
+export declare function overwritableViewName(t: TextFn, active: ViewItem | undefined): string | null;
 export {};

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

@@ -24,7 +24,6 @@ export interface UseRowMenuArgs {
         icon?: string;
         search?: string;
     }) => void;
-    locale: string;
     /** Peek availability for THIS surface (screen quick_peek enabled + not phone).
      *  Drives __peek suppression and the openPeek client verb. */
     peekAllowed: boolean;
@@ -41,7 +40,7 @@ export interface RowMenu {
     runRowAction: ActionRunHandler;
     widgetContext: WidgetContext;
     /** True when a __peek leaf survives resolution + suppression - the single
-     *  source of truth for whether the hover eye button renders (Invariant 7). */
+     *  source of truth for whether the hover eye button renders. */
     hasPeek: boolean;
 }
-export declare function useRowMenu({ row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, locale, peekAllowed, hasDetailTarget, onPeek, }: UseRowMenuArgs): RowMenu;
+export declare function useRowMenu({ row, rowId, screen, fullScreen, entity, entityCode, rowActions, tabNavigate, peekAllowed, hasDetailTarget, onPeek, }: UseRowMenuArgs): RowMenu;

package/dist-lib/components/pages/profile/Profile.d.ts

@@ -2,3 +2,6 @@ export declare function Profile(): import("react").JSX.Element;
 export declare function ProfileParamsBlock({ userId }: {
     userId: string;
 }): import("react").JSX.Element;
+export declare function ProfileLanguageRow({ userId }: {
+    userId: string;
+}): import("react").JSX.Element;

package/dist-lib/components/params/ParamsBlock.d.ts

@@ -1,17 +1,5 @@
 import { type ReactNode } from "react";
-/**
- * ParamsBlock is the GENERIC, reusable parameter-editing block attached to a
- * carrier row (a user's Profile, a tenant, or a business entity row). It is
- * declaration-driven: it renders exactly the parameters whose `scopes:` include
- * the carrier's scope, and nothing when that attachable set is empty (so an
- * unrelated entity gets no block - the platform's anti-pollution rule).
- *
- * The single dangerous trap it defends: `$params` is a FULL-SET write. The
- * current override set is ALWAYS sourced from the carrier's PK-detail response
- * (`$params`); a missing `$params` key is a HARD ERROR here, never treated as an
- * empty set (which would delete every override). Every save/reset composes the
- * complete new set client-side and writes it through `<carrier>.__update`.
- */
+/** Renders the parameters whose `scopes:` include the carrier's scope, and nothing when none do. */
 export interface ParamsBlockProps {
     /** Carrier entity code (the write target, e.g. "profile", "my_tenant"). */
     carrierEntityCode: string;

package/dist-lib/components/params/param-editors.d.ts

@@ -1,18 +1,14 @@
 import type { ResolvedParam } from "../../types/api.d.ts";
+import { type TextFn } from "../../lib/language.d.ts";
+export declare function paramSourceName(t: TextFn, source: ResolvedParam["source"]): string;
 export declare function ErrorLine({ text }: {
     text: string;
 }): import("react").JSX.Element;
-/** Compact one-line preview: scalars inline; json/structure as a summary chip. */
 export declare function ValuePreview({ type, value, structure }: {
     type: string;
     value: unknown;
     structure?: string;
 }): import("react").JSX.Element;
-/**
- * EditParamDialog renders the typed editor for one parameter and calls onSave
- * with the parsed, typed value (throwing invalid input inline before onSave).
- * The caller composes the full `$params` set and performs the write.
- */
 export declare function EditParamDialog({ param, current, error, onCancel, onSave }: {
     param: ResolvedParam;
     current: unknown;
@@ -20,9 +16,5 @@ export declare function EditParamDialog({ param, current, error, onCancel, onSav
     onCancel: () => void;
     onSave: (value: unknown) => Promise<void> | void;
 }): import("react").JSX.Element;
-/**
- * paramTenantEditable reports whether a param is editable at TENANT scope:
- * empty scopes AND non-server category, OR scopes explicitly admits `tenant`
- * (the server-category waiver case, e.g. mailer_backend). Others are read-only.
- */
+/** No `scopes:` admits tenant for a non-server category; a server category needs `tenant` listed. */
 export declare function paramTenantEditable(param: ResolvedParam): boolean;

package/dist-lib/components/primitives/ClassifiedFieldLocked.d.ts

@@ -3,8 +3,7 @@ interface ClassifiedFieldLockedProps {
     tier: string;
     tierDef?: ClassificationTierDef;
     requiredPermission?: string;
-    locale?: string;
     variant?: "value" | "input";
 }
-export declare function ClassifiedFieldLocked({ tier, tierDef, requiredPermission, locale, variant, }: ClassifiedFieldLockedProps): import("react").JSX.Element;
+export declare function ClassifiedFieldLocked({ tier, tierDef, requiredPermission, variant, }: ClassifiedFieldLockedProps): import("react").JSX.Element;
 export {};

package/dist-lib/components/shared/DynamicIcon.d.ts

@@ -8,9 +8,9 @@ interface DynamicIconProps {
 /**
  * Resolve and render a DSL `icon:` name. Subscribes to the icon registry via
  * useSyncExternalStore so a late or replaced registry (identity switch
- * re-fetch) re-renders every mounted icon (plan §5).
+ * re-fetch) re-renders every mounted icon.
  *
- * Precedence (plan §1):
+ * Precedence:
  *   1. registry entry for `name` (svg | url | lucide) - consumer-declared DATA
  *   2. built-in glyph `Icon[name]` (the bundled ~119)
  *   3. literal `lucide:<name>` prefix - lazy Lucide

package/dist-lib/components/shared/LoadingSkeleton.d.ts

@@ -1,3 +1,4 @@
+export declare const SHIMMER_KEYFRAMES = "@keyframes declarion-shimmer{from{background-position:200% 0}to{background-position:-200% 0}}";
 export declare function TableSkeleton({ rows, cols }: {
     rows?: number;
     cols?: number;

package/dist-lib/components/shared/LucideIcon.d.ts

@@ -10,7 +10,7 @@ interface LucideIconProps {
  * Render a Lucide glyph by name, loading both the import map and the icon's
  * chunk lazily on first use (lucide-react stays out of the eager bundle). An
  * unknown Lucide name falls back to the built-in `folder` glyph - the same miss
- * behaviour as the rest of the resolver (plan §6).
+ * behaviour as the rest of the resolver.
  */
 export declare function LucideIcon({ name, size, className, style }: LucideIconProps): import("react").JSX.Element | null;
 export {};

package/dist-lib/components/shared/useOwnRefresh.d.ts

@@ -1,7 +1,7 @@
 /**
  * Whether the refresh THIS control started is still running. A control driven
  * by its query's flag reports somebody else's work and sits disabled exactly
- * when a person reaches for it. docs/architecture.md.
+ * when a person reaches for it.
  */
 export declare function useOwnRefresh(refetch: () => unknown): {
     refreshing: boolean;