@declarion/react 0.39.0 → 0.40.0

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

@@ -64,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.