@declarion/react 0.56.0 → 0.59.0

package/dist-lib/lib/action-dispatch.d.ts

@@ -1,6 +1,7 @@
 import { type UIActionContext } from "./ui-actions.d.ts";
 import type { UIStep } from "../types/schema.d.ts";
-export declare function dispatchAction(code: string, action: {
+import type { TextFn } from "./language.d.ts";
+export declare function dispatchAction(errorTitle: TextFn, code: string, action: {
     ui_steps?: UIStep[];
     handler?: string;
     entity?: string;

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

@@ -1,4 +1,5 @@
 import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema.d.ts";
+import type { TextFn } from "./language.d.ts";
 /**
  * Row-menu navigation platform-default action codes. The server injects them
  * into every entity and (for explicit action_layout trees) prepends them so the
@@ -64,35 +65,27 @@ export declare function filterUnavailableMutationActions(actions: Array<{
  * Checks if an action has parameters that need user input.
  */
 export declare function actionHasParams(action: Action): boolean;
-/**
- * Default confirmation copy for a destructive action that declares none. A
- * LocalizedString like every user-facing string in the platform, resolved
- * against the caller's locale by `actionConfirmMessage`. A consumer's own
- * `confirmation` (also localized) overrides it.
- */
-export declare const DEFAULT_DESTRUCTIVE_CONFIRM: LocalizedString;
 /**
  * The confirmation message to show before running an action, or null when no
  * confirm step is needed. This is the SINGLE source of confirm semantics, read
  * by every dispatch surface (the ActionRunner and ActionButton) so they cannot
- * drift (see docs/ui-internals.md "Action dialogs and dispatch"):
+ * drift:
  *   - a declared `confirmation` wins (works on any action, destructive or not);
  *   - else a `destructive` action gets the default danger warning;
  *   - else null (no confirm).
- * Both the declared text and the default are localized and resolved against
- * `locale`. `destructive` is a semantic class (danger colour + trailing
+ * Both the declared text and the default are declared words, read through `t`. `destructive` is a semantic class (danger colour + trailing
  * placement + the server impersonation gate + agent HITL); the confirm is one
  * of its effects, and `confirmation` only tunes the TEXT - not a second gate.
  */
-export declare function actionConfirmMessage(action: Action | undefined, locale: string): string | null;
+export declare function actionConfirmMessage(t: TextFn, action: Action | undefined): string | null;
 /**
  * True when the action must show a confirm step (destructive OR a declared
- * confirmation). Locale-independent - it is a presence check, so the runner can
+ * confirmation). Language-independent - it is a presence check, so the runner can
  * decide whether to open the dialog without resolving the text.
  */
 export declare function actionNeedsConfirm(action: Action | undefined): boolean;
 /**
- * Tooltip text for an action control (plan 2026-07-02-action-display-description).
+ * Tooltip text for an action control.
  * Precedence: disabled-reason > description > name.
  *
  * A labeled control already shows the name, so its tooltip is the description
@@ -101,7 +94,7 @@ export declare function actionNeedsConfirm(action: Action | undefined): boolean;
  * on its own line, then the description. Absent description falls back to the
  * name.
  */
-export declare function actionTooltip(action: Action | undefined, name: string, isDisabled: boolean, reason: string | null | undefined, 
+export declare function actionTooltip(t: TextFn, action: Action | undefined, name: string, isDisabled: boolean, reason: string | null | undefined, 
 /**
  * True when the button is rendering WITHOUT its label right now - either
  * because the author declared `display.icon_only`, or because the row ran out
@@ -115,7 +108,7 @@ labelHidden?: boolean): string;
 export declare function fullActionCode(entityCode: string | undefined, actionCode: string): string;
 /**
  * Checks if an action is an association navigation action.
- * Reason: per new wire format (unified-toolbar plan §1-§2), dispatch mode is
+ * Reason: in the wire format, dispatch mode is
  * encoded by which dispatch field is set; the `association` field is the mode.
  */
 export declare function isAssociationAction(action: Action): boolean;
@@ -132,7 +125,7 @@ export declare function findListScreenForEntity(schema: Schema | undefined, enti
  * Enabled defaults true from server; client sets false when enabled_if fails.
  * Reason carries the localized tooltip text when Enabled is false.
  *
- * Wire format (plan §8): {"kind":"action","code":"approve","enabled":true,"reason":null}
+ * Wire format: {"kind":"action","code":"approve","enabled":true,"reason":null}
  */
 export interface ResolvedActionLeaf {
     kind: "action";
@@ -144,7 +137,7 @@ export interface ResolvedActionLeaf {
  * Resolved group node. Kind discriminator "group".
  * Items is always non-empty after pruning (empty groups are dropped).
  *
- * Wire format (plan §8): {"kind":"group","name":{...},"icon":"...","items":[...]}
+ * Wire format: {"kind":"group","name":{...},"icon":"...","items":[...]}
  */
 export interface ResolvedActionGroup {
     kind: "group";
@@ -159,7 +152,7 @@ export interface ResolvedActionGroup {
 export type ResolvedActionLayoutNode = ResolvedActionLeaf | ResolvedActionGroup;
 /**
  * applyRowState walks an RBAC-pruned ResolvedActionLayoutNode[] and applies
- * per-row visible_if / enabled_if evaluation (plan §4, §5).
+ * per-row visible_if / enabled_if evaluation.
  *
  * Drop conditions:
  * - visible_if conditions not satisfied by row -> leaf dropped
@@ -178,34 +171,18 @@ export type ResolvedActionLayoutNode = ResolvedActionLeaf | ResolvedActionGroup;
  * @param rowSelection  All selected rows for bulk context (list_toolbar bulk mode).
  *                      Pass empty array for non-bulk contexts.
  */
-export declare function applyRowState(layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, row: Record<string, unknown>, rowSelection: Record<string, unknown>[], allowedActionCodes?: ReadonlySet<string>): ResolvedActionLayoutNode[];
-/**
- * Composes a flat ResolvedActionLayoutNode[] from an entity's actions map,
- * filtered to those that include the given slot in their visibility array,
- * sorted by position ascending (ties broken by declaration order).
- *
- * This is the fallback used when neither screen.action_layout nor
- * entity.action_layout is present (plan §3: "runtime MUST compose a flat
- * layout from all actions matching the slot's visibility[], sorted by
- * position ascending").
- *
- * All leaves are emitted with enabled=true; client applies visible_if /
- * enabled_if via applyRowState.
- *
- * @param actions  Entity-level actions map from the (already RBAC-pruned) schema.
- * @param slot     Placement slot code (e.g. "detail", "list_row", "list_toolbar").
- */
+export declare function applyRowState(t: TextFn, layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, row: Record<string, unknown>, rowSelection: Record<string, unknown>[], allowedActionCodes?: ReadonlySet<string>): ResolvedActionLayoutNode[];
 /**
  * Filters a server-emitted ResolvedActionLayoutNode tree to a single slot,
  * preserving group structure. Drops leaves whose action's visibility[] does
  * not include the slot. Drops groups whose entire item list pruned out
- * (plan §5 empty-group auto-hide). Additional filters via `opts`:
+ * (empty-group auto-hide). Additional filters via `opts`:
  *
  *  - opts.bulkRequired: when set, gates list_toolbar leaves whose effective
  *    "bulk-required" semantic matches the request. The old wire-format flag
- *    `bulk_selection_required` was removed in unified-toolbar Phase 1 (the
- *    server now derives this from `handler.invoke`); until Task 38 replaces
- *    this code path the caller passes a predicate that decides per action.
+ *    `bulk_selection_required` was removed (the server now derives this
+ *    from `handler.invoke`), so the caller passes a predicate that decides
+ *    per action.
  *    Reason: keep the slot+bulk filtering surface intact while removing the
  *    field; the call sites supply the legacy predicate.
  *  - opts.excludeIf: drop leaves where the predicate returns true. Common
@@ -237,9 +214,6 @@ export declare function resolveActionLayoutForSlot(screenActionLayout: ResolvedA
  * does not derive) we fall back to the historical proxy: slot membership in
  * `list_floatbar`. Absent MUST NOT be read as false, or every handler action
  * would silently read as page-level against an older server.
- *
- * See docs/architecture.md "List Toolbar Selection Model" and plan
- * 2026-06-22-toolbar-action-slots-and-id-arity.md.
  */
 export declare function actionRequiresSelection(action: Action): boolean;
 /**
@@ -263,4 +237,18 @@ export declare function actionInFloatbarSlot(action: Action): boolean;
  * are selected.
  */
 export declare function disableLeavesWhere(layout: ResolvedActionLayoutNode[], entityActions: Record<string, Action> | undefined, globalActions: Record<string, Action> | undefined, predicate: (action: Action) => boolean, reason: string): ResolvedActionLayoutNode[];
+/**
+ * Composes a flat ResolvedActionLayoutNode[] from an entity's actions map,
+ * filtered to those that include the given slot in their visibility array,
+ * sorted by position ascending (ties broken by action code).
+ *
+ * This is the fallback used when neither screen.action_layout nor
+ * entity.action_layout is present.
+ *
+ * All leaves are emitted with enabled=true; client applies visible_if /
+ * enabled_if via applyRowState.
+ *
+ * @param actions  Entity-level actions map from the (already RBAC-pruned) schema.
+ * @param slot     Placement slot code (e.g. "detail", "list_row", "list_toolbar").
+ */
 export declare function defaultFlatForSlot(actions: Record<string, Action> | undefined, slot: string): ResolvedActionLayoutNode[];

package/dist-lib/lib/anchor.d.ts

@@ -1,10 +1,9 @@
 /**
  * The anchor expression, TypeScript side.
  *
- * One grammar for "a moment relative to now", shared with the server
- * (golang/internal/engine/anchor.go + duration.go). The language boundary is
- * the only reason there are two implementations; nothing else may declare a
- * third.
+ * One grammar for "a moment relative to now", shared with the server. The
+ * language boundary is the only reason there are two implementations; nothing
+ * else may declare a third.
  *
  *   now            the current instant
  *   now+3w         three weeks ahead

package/dist-lib/lib/decimal-text.d.ts

@@ -0,0 +1 @@
+export declare function formatDecimalText(value: string, formatter: Intl.NumberFormat): string;

package/dist-lib/lib/document-templates.d.ts

@@ -4,8 +4,7 @@ import type { Schema } from "../types/schema.d.ts";
  * can manage TENANT document templates: the `document_template` entity is
  * present in the projected schema (schema.entities is already RBAC-pruned -
  * `document_template` appears only when the caller can read it). Gates the
- * lazy `document.templates.available` tenant-template visibility probe
- * (Business Case 6, plan 2026-07-08-document-generation-hardening) so a
+ * lazy `document.templates.available` tenant-template visibility probe so a
  * caller who cannot manage templates never fires it, which is the default.
  * One shared predicate so SmartDetailPage and SmartListPage agree.
  */

package/dist-lib/lib/download.d.ts

@@ -1,3 +1,4 @@
+import type { TextFn } from "./language.d.ts";
 export declare class DownloadError extends Error {
     readonly code?: string | undefined;
     constructor(message: string, code?: string | undefined);
@@ -17,4 +18,4 @@ export declare function isMissingArtifactError(err: unknown): boolean;
  * 403, etc.) surfaces as a thrown DownloadError instead of silently
  * navigating the browser to an error page.
  */
-export declare function downloadFile(url: string, filename?: string): Promise<void>;
+export declare function downloadFile(errorTitle: TextFn, url: string, filename?: string): Promise<void>;

package/dist-lib/lib/evidence-verdict.d.ts

@@ -1,4 +1,5 @@
 import type { PillTone } from "../components/primitives/Pill.d.ts";
+import type { TextFn } from "./language.d.ts";
 export declare const EVIDENCE_VERDICT: {
     readonly verified: "verified";
     readonly unverified: "unverified";
@@ -6,5 +7,5 @@ export declare const EVIDENCE_VERDICT: {
     readonly indeterminate: "indeterminate";
     readonly outsideCoverage: "outside_coverage";
 };
-export declare function verdictLabel(verdict: string): string;
+export declare function verdictLabel(t: TextFn, verdict: string): string;
 export declare function verdictTone(verdict: string): PillTone;

package/dist-lib/lib/failure.d.ts

@@ -0,0 +1,2 @@
+import type { TextFn } from "./language";
+export declare function failureTitle(errorTitle: TextFn, err: unknown): string;

package/dist-lib/lib/field-classification.d.ts

@@ -3,14 +3,14 @@ import type { Entity, FieldAccessInfo, ClassificationTierDef, Schema } from "../
  * isFieldReadable returns true when the caller can see the field's
  * value. Non-classified fields are always readable (no entry in
  * field_access). Classified fields are readable when field_access
- * marks read="granted". Plan §B9.
+ * marks read="granted".
  */
 export declare function isFieldReadable(entity: Entity | undefined, fieldName: string): boolean;
 /**
  * isFieldWritable returns true when the caller can submit a new value
  * for the field. Form components disable input + show a lock badge
  * when this returns false. Non-classified fields are always writable
- * (gating happens via entity-level RBAC at the HTTP layer). Plan §B9.
+ * (gating happens via entity-level RBAC at the HTTP layer).
  */
 export declare function isFieldWritable(entity: Entity | undefined, fieldName: string): boolean;
 /**
@@ -24,7 +24,7 @@ export declare function fieldClassification(entity: Entity | undefined, fieldNam
  * fieldRequiredPermission returns the exact grant string an
  * administrator must add to a role to unlock the field for the
  * current caller. Returns undefined when the field is readable +
- * writable (no hint needed). Plan §B9 — operator hand-off surface.
+ * writable (no hint needed).
  */
 export declare function fieldRequiredPermission(entity: Entity | undefined, fieldName: string): string | undefined;
 /**

package/dist-lib/lib/filters.d.ts

@@ -39,16 +39,32 @@ export declare const NO_VALUE_OPS: Set<FilterOp>;
 export declare const MULTI_VALUE_OPS: Set<FilterOp>;
 /** Human-friendly display names for operators. */
 export declare const OP_LABELS: Record<FilterOp, string>;
+export type FilterURLErrorCode = "filter.url_not_json" | "filter.url_not_tree";
+export declare class FilterURLError extends Error {
+    readonly code: FilterURLErrorCode;
+    constructor(code: FilterURLErrorCode, message: string);
+}
 export interface FilterURLState {
     filters: FilterNode[];
     error: string | null;
+    errorCode: FilterURLErrorCode | null;
 }
 /** Parse filters from URL search params (JSON `filters` param). */
 export declare function parseFilterURLState(searchParams: URLSearchParams): FilterURLState;
 /** Parse the final tree and reject malformed URL state instead of treating it as no filter. */
 export declare function parseFiltersFromURL(searchParams: URLSearchParams): FilterNode[];
-/** Write filters to URL search params. */
-export declare function setFiltersInURL(filters: FilterNode[], searchParams: URLSearchParams): void;
+/** True when two filter trees say the same thing. */
+export declare function filtersEqual(a: FilterNode[], b: FilterNode[]): boolean;
+/**
+ * Write filters to URL search params.
+ *
+ * The parameter is present only while the tree differs from `defaults` - what
+ * this list resolves to with no `filters` in the URL, which is the active
+ * view's tree on a list screen and nothing anywhere else. So an empty tree is
+ * an OVERRIDE where a view supplies conditions (`filters=[]`, no conditions)
+ * and an absence where nothing does.
+ */
+export declare function setFiltersInURL(filters: FilterNode[], searchParams: URLSearchParams, defaults?: FilterNode[]): void;
 /**
  * Convert FilterNode array to API query params.
  * Uses the JSON `filters` param for the API request.

package/dist-lib/lib/format-count.d.ts

@@ -1,6 +1,6 @@
 /**
  * Row-count formatting for list views. Display precision MUST match data
- * accuracy (docs/plans/2026-05-18-declarative-row-count.md, Principle 3):
+ * accuracy:
  *
  *   - an exact count renders to the unit with thousands separators
  *     (3,613,711) - it is known precisely;
@@ -13,7 +13,8 @@
  */
 /**
  * formatEstimatedCount renders a coarse estimate: a `~` prefix, ~2
- * significant figures, and a magnitude suffix (K/M/B).
+ * significant figures, and the magnitude suffix of Intl compact notation in
+ * `language` (K/M/B in English, "mil"/"M" in Spanish, "тыс."/"млн" in Russian).
  *
  *   3_613_711 -> "~3.6M"
  *     850_000 -> "~850K"
@@ -25,16 +26,16 @@
  * the leading digit is single); 12_000 -> 12K (no decimal because 2 leading
  * digits already give 2 sig figs).
  */
-export declare function formatEstimatedCount(total: number): string;
+export declare function formatEstimatedCount(total: number, language?: string): string;
 /**
- * formatExactCount renders an exact count to the unit with locale thousands
- * separators: 3613711 -> "3,613,711".
+ * formatExactCount renders an exact count to the unit with the thousands
+ * separators of `language`: 3613711 -> "3,613,711" in English.
  */
-export declare function formatExactCount(total: number): string;
+export declare function formatExactCount(total: number, language?: string): string;
 /**
  * formatCount picks the rendering by the count strategy actually used to
  * produce `total` (the server's `meta.count_mode`), NOT the entity schema:
  * a forced exact count must render exact even on a `count: estimated`
  * entity.
  */
-export declare function formatCount(total: number, mode: "exact" | "estimated"): string;
+export declare function formatCount(total: number, mode: "exact" | "estimated", language?: string): string;

package/dist-lib/lib/language.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from "react";
+import type { LocalizedString } from "../types/schema.d.ts";
+export declare const MANDATORY_LANGUAGE = "en";
+export declare const LANGUAGE_PARAMETER = "ui_language";
+export declare function pickLocalizedEntry(ls: LocalizedString | null | undefined, language: string, deploymentLanguage: string): [code: string, value: string] | undefined;
+export declare function pickLocalized(ls: LocalizedString | null | undefined, language: string, deploymentLanguage: string): string | undefined;
+export type TextVars = Record<string, string | number>;
+export interface TextFn {
+    (code: string, fallback: string, vars?: TextVars): string;
+    (value: LocalizedString | null | undefined): string;
+    readonly language: string;
+    readonly deploymentLanguage: string;
+}
+export declare function makeTextFn(messages: Record<string, LocalizedString> | undefined, language: string, deploymentLanguage: string): TextFn;
+export declare function pluralText(t: TextFn, code: string, count: number, english: {
+    one: string;
+    other: string;
+}, more?: TextVars): string;
+export declare function textWithNodes(text: string, nodes: Record<string, ReactNode>): ReactNode[];

package/dist-lib/lib/mass-edit.d.ts

@@ -1,4 +1,5 @@
 import type { Entity, EntityField, PropertyDef, StatusGroupDef } from "../types/schema.d.ts";
+import type { TextFn } from "./language.d.ts";
 /** Target kinds mirror engine.MassEditTargetKind in Go. */
 export type MassEditTargetKind = "field" | "status" | "property";
 /** Metadata a property-grid row needs to render a target + editable value cell. */
@@ -28,4 +29,4 @@ export declare function parseTargetFilter(raw: string | undefined): string[];
  * - entities without generic update globally hide every target (UI mirrors
  *   the server gate; the dispatcher still enforces permissions).
  */
-export declare function buildMassEditTargets(entity: Entity | undefined, whitelistRaw?: string | string[]): MassEditTarget[];
+export declare function buildMassEditTargets(t: TextFn, entity: Entity | undefined, whitelistRaw?: string | string[]): MassEditTarget[];

package/dist-lib/lib/realtime-query-keys.d.ts

@@ -1,6 +1,6 @@
 /**
  * Every list-shaped cache the SDK ships. The REFETCH-ONLY kind is the cursor
- * list, whose cold tables a key does not prune. docs/realtime.md.
+ * list, whose cold tables a key does not prune.
  */
 export declare const NARROWED_LIST_CACHE_KEYS: readonly ["entity-data", "entity-data-all"];
 export declare const REFETCH_ONLY_LIST_CACHE_KEYS: readonly ["entity-data-cursor"];

package/dist-lib/lib/realtime-reconcile.d.ts

@@ -1,7 +1,6 @@
 /**
- * What a change frame does to the list caches of one entity. The outcome table
- * it applies, and why the client decides nothing itself, is docs/realtime.md
- * "Frontend Invalidation".
+ * What a change frame does to the list caches of one entity: the client applies
+ * a fixed outcome table and decides nothing itself.
  */
 import type { QueryClient } from "@tanstack/react-query";
 import type { ListParams } from "../types/api.d.ts";
@@ -10,7 +9,7 @@ export interface ChangedRow {
     pk: Record<string, string>;
     /**
      * True when nothing but a creation named this row in this window - the one
-     * absence the client may read as certain. docs/realtime.md.
+     * absence the client may read as certain.
      */
     createdOnly: boolean;
 }

package/dist-lib/lib/screen-back.d.ts

@@ -17,7 +17,7 @@ export interface CaptureLocation {
  * `current` to `destinationPathname`. Returns `undefined` (no capture) when:
  *   - the current path is not a same-origin in-app route,
  *   - the current path is an excluded (auth) route,
- *   - the destination shares the current PATHNAME (self guard, Invariant 7) -
+ *   - the destination shares the current PATHNAME (self guard) -
  *     a same-screen, different-query link must not self-stamp a Back.
  *
  * `originTab` supplies metadata (id/title/icon/screen) for switching to or
@@ -61,11 +61,9 @@ export interface ResolvedBack {
  * SWITCH vs REOPEN; the destination URL is always the CAPTURED snapshot. Embed
  * yields `null` (Back is fallback-only in embed; no tab ops).
  *
- * Divergence from the plan's Invariant 5 (reasoned): the plan preferred the
- * live tab's CURRENT search over the captured one, premised on every origin
- * screen mirroring its URL into the tab store. That premise is false for custom
- * screens (Compare, dashboards) with no per-page mirror, so preferring live
- * search loses URL-encoded state (Business Case 3). The captured `returnTo` is
+ * The captured `returnTo` wins over the live tab's CURRENT search. Custom
+ * screens (Compare, dashboards) do not mirror their URL into the tab store, so
+ * the live search would lose URL-encoded state. The captured `returnTo` is
  * exact at drill time ("where I came from"), so it is the single source of
  * truth for the destination URL - no per-screen search mirror needed.
  */

package/dist-lib/lib/sort.d.ts

@@ -8,7 +8,7 @@ export interface SortCol {
 /**
  * Parse a sort expression string into a list of SortCol entries.
  *
- * Tolerant per plan §5.2:
+ * Tolerant:
  *   - empty/null/undefined → []
  *   - missing direction defaults to "asc"
  *   - missing nulls segment is left undefined (system default applies server-side)
@@ -17,12 +17,12 @@ export interface SortCol {
  */
 export declare function parseSort(s: string | null | undefined): SortCol[];
 /**
- * Filter a raw sort URL string so $property.* segments (deferred per plan §2)
+ * Filter a raw sort URL string so $property.* segments (not yet sortable)
  * don't reach the backend's strict parser. EVERY OTHER token passes through
  * unchanged - including malformed grammar like `:nulls_middle` or extra
  * colons - so the backend can return a typed ValidationError and the SDK
- * surfaces the error to the user. Plan §14 strict-parse contract requires
- * that grammar violations are NOT silently rewritten on the client.
+ * surfaces the error to the user. Grammar violations are NOT silently
+ * rewritten on the client.
  */
 export declare function stripUnsupportedSortSegments(s: string | null | undefined): string | undefined;
 /**
@@ -31,12 +31,12 @@ export declare function stripUnsupportedSortSegments(s: string | null | undefine
  */
 export declare function serializeSort(cols: SortCol[]): string;
 /**
- * Server-enforced cap (plan §3 Decision 4, §4.2). Mirrored on the client so
+ * Server-enforced cap. Mirrored on the client so
  * we never POST a sort the server will reject with HTTP 400.
  */
 export declare const MAX_SORT_COLS = 5;
 /**
- * Shift-click on a column header (plan §7.1).
+ * Shift-click on a column header.
  *
  *   - field already in `prev`  → remove it (toggle off).
  *   - field not in `prev`      → append { field, dir: "asc" } to the tail.
@@ -54,10 +54,10 @@ export declare const MAX_SORT_COLS = 5;
  */
 export declare function applyShiftClickSort(prev: SortCol[], field: string): SortCol[];
 /**
- * "Add to multi-sort" menu action (plan §7.2). Adds `col` to the sort tail
+ * "Add to multi-sort" menu action. Adds `col` to the sort tail
  * with the caller-chosen `dir` + `nulls`. Dedupes: if `col.field` is already
  * present in `prev`, the earlier occurrence is removed and the new one
- * appended at the tail (server rejects duplicate fields, plan §4.2).
+ * appended at the tail (server rejects duplicate fields).
  *
  * Refuses to grow past {@link MAX_SORT_COLS}: when appending would exceed
  * the cap AND the field is not already present, returns `prev` unchanged.
@@ -66,7 +66,7 @@ export declare function applyShiftClickSort(prev: SortCol[], field: string): Sor
  */
 export declare function applyAppendSort(prev: SortCol[], col: SortCol): SortCol[];
 /**
- * "Clear sort on this column" menu action (plan §7.2). Removes the one
+ * "Clear sort on this column" menu action. Removes the one
  * entry matching `field` from `prev`; returns `prev` unchanged if absent.
  */
 export declare function removeSortField(prev: SortCol[], field: string): SortCol[];

package/dist-lib/lib/timestamp.d.ts

@@ -6,8 +6,6 @@
  * ui-actions `${now}`, TimestampField submit, quick-add defaults, status
  * history `set_at`. The offset makes the instant unambiguous for passthrough
  * fields and is stripped by the backend for fields with configured timezone.
- *
- * See docs/gotchas.md#timezone--unit-conversions.
  */
 export declare function formatWireDateTime(date?: Date): string;
 /**
@@ -25,12 +23,12 @@ export declare function formatWireDateTime(date?: Date): string;
  * Single source of the offset-resolution algorithm; callers (`formatOffsetTimestamp`
  * here, `TimestampField`'s display formatter) differ ONLY in the Intl options.
  */
-export declare function formatInOffsetZone(raw: string, options: Intl.DateTimeFormatOptions, locale?: string): string;
+export declare function formatInOffsetZone(raw: string, options: Intl.DateTimeFormatOptions, language?: string): string;
 /**
  * Format an offset-aware timestamp for display WITHOUT browser-local
  * conversion.
  *
- * `DD-MM-YYYY HH:mm`, the same in every locale. Deliberately NOT
+ * `DD-MM-YYYY HH:mm`, the same in every language. Deliberately NOT
  * `dateStyle: "medium"`: that renders "Aug 15, 2026" for one reader and
  * "15 авг. 2026 г." for another, so two people reading the same screen cannot
  * quote the same date to each other.
@@ -39,8 +37,8 @@ export declare function formatOffsetTimestamp(raw: string): string;
 /**
  * Relative-or-absolute timestamp formatting for the time_ago cell renderer.
  *
- * Returns a short relative phrase ("5 minutes ago", "2 days ago") when the
- * timestamp is within the last 30 days, and an ISO date ("2026-01-15") when
+ * Returns a short relative phrase in `language` ("5 minutes ago", "hace 2 días")
+ * when the timestamp is within 30 days of `now`, and an ISO date ("2026-01-15") when
  * older. Linear / Stripe / Datadog convention — avoids the "1y 4mo 12d ago"
  * eyesore for stable historical data.
  *
@@ -49,7 +47,7 @@ export declare function formatOffsetTimestamp(raw: string): string;
  *
  * Bare or unparseable input falls back to the raw string for both fields.
  */
-export declare function formatRelativeOrAbsolute(raw: string | Date | null | undefined, now?: Date): {
+export declare function formatRelativeOrAbsolute(language: string, raw: string | Date | null | undefined, now?: Date): {
     text: string;
     absolute: string;
 };

package/dist-lib/lib/ui-actions.d.ts

@@ -1,10 +1,11 @@
+import type { TextFn } from "./language.d.ts";
 import type { UIStep } from "../types/schema.d.ts";
 export interface UIActionContext {
     row?: Record<string, unknown>;
     params?: Record<string, unknown>;
 }
 export declare function interpolate(template: string, ctx: UIActionContext): unknown;
-export declare function executeUISteps(steps: UIStep[], ctx: UIActionContext): Promise<void>;
+export declare function executeUISteps(errorTitle: TextFn, steps: UIStep[], ctx: UIActionContext): Promise<void>;
 export declare function isUIAction(action: {
     ui_steps?: UIStep[];
     handler?: string;