@declarion/react 0.38.5 → 0.40.0

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

@@ -1,4 +1,17 @@
 import type { Action, ActionCondition, Entity, LocalizedString, Schema } from "../types/schema";
+/**
+ * Row-menu navigation platform-default action codes. The server injects them
+ * into every entity and (for explicit action_layout trees) prepends them so the
+ * Row Menu leads with navigation. `__peek` opens the Quick peek drawer (mode-less
+ * client verb); `__open` navigates to the record's detail page (href). Shared by
+ * the dispatcher, the nav-divider renderer, and client-side suppression (drop
+ * `__peek` where peek is unavailable, `__open` where the entity has no detail
+ * route). Kept as named constants because these codes are read in 3+ places.
+ */
+export declare const PEEK_ACTION_CODE = "__peek";
+export declare const OPEN_ACTION_CODE = "__open";
+/** True when the code is one of the leading row-menu navigation defaults. */
+export declare function isNavDefaultCode(code: string): boolean;
 /**
  * rowDetailId builds the detail-route id for a row - the value an href's
  * `${id}` placeholder and a detail screen's `:id` segment receive - addressing
@@ -22,9 +35,10 @@ export declare function actionConditionFieldValue(row: Record<string, unknown>,
 export declare function withActionConditionFields<T extends Record<string, unknown>>(row: T): T;
 /**
  * Returns actions from an entity whose visibility array contains the given
- * placement. Canonical values: detail | list_row | list_toolbar | app_menu |
- * nav_create | command_palette. Schema validator rejects unknown values at
- * load time so we don't need runtime alias handling here.
+ * placement. Canonical values (the 9 the Go validator accepts): detail |
+ * detail_toolbar | list_row | list_toolbar | list_floatbar | quick_peek |
+ * app_menu | nav_create | command_palette. Schema validator rejects unknown
+ * values at load time so we don't need runtime alias handling here.
  */
 export declare function getActionsByVisibility(actions: Record<string, Action> | undefined, visibility: string): Array<{
     code: string;
@@ -50,6 +64,33 @@ 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"):
+ *   - 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
+ * 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;
+/**
+ * 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
+ * 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).
  * Precedence: disabled-reason > description > name.

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

@@ -0,0 +1,11 @@
+import type { PillTone } from "../components/primitives/Pill";
+export declare const EVIDENCE_VERDICT: {
+    readonly verified: "verified";
+    readonly unverified: "unverified";
+    readonly tampered: "tampered";
+    readonly erased: "erased";
+    readonly indeterminate: "indeterminate";
+    readonly outsideCoverage: "outside_coverage";
+};
+export declare function verdictLabel(verdict: string): string;
+export declare function verdictTone(verdict: string): PillTone;

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

@@ -0,0 +1,14 @@
+/** Window to wait for a second click before committing to the single-click
+ *  (peek) action. Comfortably inside the OS double-click interval so real
+ *  double-clicks are caught, short enough that the peek does not feel laggy. */
+export declare const ROW_DOUBLE_CLICK_MS = 250;
+/** A deferred single click awaiting a possible second click. */
+export type RowClickPending = {
+    rowId: string;
+} | null;
+/**
+ * Classify a click on `rowId` given the pending deferred-click state:
+ * "double" when the same row already has an undelivered deferred click (this is
+ * its second click), otherwise "single".
+ */
+export declare function classifyRowClick(pending: RowClickPending, rowId: string): "single" | "double";