@qontinui/ui-bridge-native 0.1.5 → 0.2.0

package/dist/{types-Bcj7ji97.d.mts → types-DAfCeWXc.d.mts}

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, l as NativeFindRequest, m as NativeFindResponse, j as NativeElementState } from './types-BPNuYxDx.mjs';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-Oz13YLZq.mjs';
 
 /**
  * UI Bridge Native Control Types
@@ -72,6 +72,22 @@ interface WaitResult {
     /** Error message if failed */
     error?: string;
 }
+/**
+ * Action event emitted after executeAction completes (success or failure).
+ */
+interface NativeActionEvent {
+    elementId: string;
+    action: string;
+    params?: unknown;
+    success: boolean;
+    error?: string;
+    /** ms since epoch when the executor finished the action */
+    timestamp: number;
+    /** request id propagated from ControlActionRequest, if any */
+    requestId?: string;
+    durationMs: number;
+}
+type NativeActionListener = (event: NativeActionEvent) => void;
 /**
  * Native action executor interface
  */
@@ -92,6 +108,8 @@ interface NativeActionExecutor {
      * Wait for element conditions
      */
     waitForElement(elementId: string, options: WaitOptions): Promise<WaitResult>;
+    /** Subscribe to action events. Returns an unsubscribe function. */
+    onActionExecuted(listener: NativeActionListener): () => void;
 }
 /**
  * Page navigation request
@@ -132,6 +150,8 @@ interface TypeActionParams {
     delay?: number;
     /** Clear existing text first */
     clearFirst?: boolean;
+    /** Alias for `clearFirst` matching the runner UI Bridge convention. */
+    clear?: boolean;
 }
 /**
  * Scroll action params
@@ -174,4 +194,4 @@ interface PressActionParams {
     duration?: number;
 }
 
-export type { ActionExecutionOptions as A, ControlActionRequest as C, NativeActionExecutor as N, PressActionParams as P, ScrollActionParams as S, TypeActionParams as T, WaitResult as W, ControlActionResponse as a, ComponentActionRequest as b, ComponentActionResponse as c, SwipeActionParams as d, PageNavigationResponse as e, PageNavigateRequest as f };
+export type { ActionExecutionOptions as A, ControlActionRequest as C, NativeActionExecutor as N, PressActionParams as P, ScrollActionParams as S, TypeActionParams as T, WaitResult as W, ControlActionResponse as a, ComponentActionRequest as b, ComponentActionResponse as c, SwipeActionParams as d, PageNavigationResponse as e, NativeActionListener as f, NativeActionEvent as g, PageNavigateRequest as h };

package/dist/{types-BPNuYxDx.d.mts → types-Oz13YLZq.d.mts}

@@ -306,7 +306,101 @@ interface NativeBridgeSnapshot {
     currentRoute?: string | null;
     /** Current route segments (if a RouteProvider is configured) */
     segments?: string[];
+    /** Modal/sheet/drawer context (populated when a modalDetector enricher is registered) */
+    modalStack?: NativeSnapshotModalContext;
+    /** Toast/snackbar context (populated when a toastCapture enricher is registered) */
+    toasts?: NativeSnapshotToastContext;
+    /** Undo/redo context (populated when an undoTracker enricher is registered) */
+    undoRedo?: NativeSnapshotUndoContext;
 }
+/** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
+interface NativeModalInfo {
+    id: string;
+    title?: string;
+    type: 'modal' | 'sheet' | 'drawer' | 'popover' | 'alertdialog' | 'dialog';
+    /** Whether the modal blocks interaction with the underlying UI */
+    blocking: boolean;
+    /** Whether it can be dismissed by the user (backdrop tap, swipe, esc, etc.) */
+    dismissible: boolean;
+    detectedAt: number;
+}
+/**
+ * Modal context attached to a snapshot. Field names match the web SDK's
+ * `SnapshotModalContext` so external agents can write transport-agnostic checks
+ * like `snapshot.modalStack?.hasBlockingModal`.
+ */
+interface NativeSnapshotModalContext {
+    modals: NativeModalInfo[];
+    topModal?: NativeModalInfo;
+    hasBlockingModal: boolean;
+    count: number;
+}
+/** A captured toast/snackbar */
+interface NativeCapturedToast {
+    id: string;
+    message: string;
+    level: 'info' | 'success' | 'warning' | 'error' | 'loading' | 'unknown';
+    appearedAt: number;
+    dismissedAt?: number;
+    visible: boolean;
+    /** Total duration in ms (lifetime so far if still visible, total if dismissed) */
+    durationMs: number;
+}
+/** Toast context attached to a snapshot */
+interface NativeSnapshotToastContext {
+    /** Toasts currently on screen */
+    active: NativeCapturedToast[];
+    /** Recently-dismissed toasts retained by the capture buffer (most recent first) */
+    recent: NativeCapturedToast[];
+    /** Total number of toasts ever captured by this tracker */
+    totalCaptured: number;
+}
+/**
+ * Undo/redo context attached to a snapshot. Mirrors the web SDK's
+ * `SnapshotUndoContext` minus DOM-only fields — RN has no `document.execCommand`
+ * or selectors, so the native variant relies entirely on developer declaration.
+ */
+interface NativeSnapshotUndoContext {
+    /** Whether undo appears to be available */
+    canUndo: boolean;
+    /** Whether redo appears to be available */
+    canRedo: boolean;
+    /** Description of what undo would reverse */
+    undoDescription?: string;
+    /** Description of what redo would restore */
+    redoDescription?: string;
+    /** Undo stack depth (if known) */
+    undoDepth?: number;
+    /** Redo stack depth (if known) */
+    redoDepth?: number;
+    /** Human-readable summary for AI */
+    summary: string;
+}
+/**
+ * Canonical enricher slot. Each tracker exposes a `getSnapshot*Context()` method
+ * that the registry calls during `createSnapshot`. NavigationTracker is intentionally
+ * NOT here — route info already flows through `currentRoute` / `segments`.
+ */
+interface NativeSnapshotEnrichers {
+    modalDetector?: {
+        getSnapshotModalContext(): NativeSnapshotModalContext;
+    };
+    toastCapture?: {
+        getSnapshotToastContext(): NativeSnapshotToastContext;
+    };
+    undoTracker?: {
+        getSnapshotUndoContext(): NativeSnapshotUndoContext;
+    };
+}
+/**
+ * Pluggable snapshot enricher: receives base context and returns extra fields
+ * that get `Object.assign`ed onto the snapshot. Used for ad-hoc/custom trackers
+ * (e.g. runner sidebar tabs) without growing the canonical enricher set.
+ */
+type NativeSnapshotEnricher = (ctx: {
+    elements: RegisteredNativeElement[];
+    currentRoute: string | null;
+}) => Record<string, unknown>;
 /**
  * UI Bridge Native feature flags
  */
@@ -380,4 +474,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeComponentAction as f, NativeCustomAction as g, NativeElementIdentifier as h, NativeElementRef as i, NativeElementState as j, NativeElementType as k, NativeFindRequest as l, NativeFindResponse as m, NativeLayout as n, NativeStandardAction as o, NativeUIBridgeConfig as p, NativeUIBridgeFeatures as q, RegisteredNativeElement as r, Workflow as s, WorkflowStep as t, WorkflowStepType as u };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, WorkflowStep as E, WorkflowStepType as F, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeSnapshotEnricher as q, NativeSnapshotEnrichers as r, NativeSnapshotModalContext as s, NativeSnapshotToastContext as t, NativeSnapshotUndoContext as u, NativeStandardAction as v, NativeUIBridgeConfig as w, NativeUIBridgeFeatures as x, RegisteredNativeElement as y, Workflow as z };

package/dist/{types-BPNuYxDx.d.ts → types-Oz13YLZq.d.ts}

@@ -306,7 +306,101 @@ interface NativeBridgeSnapshot {
     currentRoute?: string | null;
     /** Current route segments (if a RouteProvider is configured) */
     segments?: string[];
+    /** Modal/sheet/drawer context (populated when a modalDetector enricher is registered) */
+    modalStack?: NativeSnapshotModalContext;
+    /** Toast/snackbar context (populated when a toastCapture enricher is registered) */
+    toasts?: NativeSnapshotToastContext;
+    /** Undo/redo context (populated when an undoTracker enricher is registered) */
+    undoRedo?: NativeSnapshotUndoContext;
 }
+/** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
+interface NativeModalInfo {
+    id: string;
+    title?: string;
+    type: 'modal' | 'sheet' | 'drawer' | 'popover' | 'alertdialog' | 'dialog';
+    /** Whether the modal blocks interaction with the underlying UI */
+    blocking: boolean;
+    /** Whether it can be dismissed by the user (backdrop tap, swipe, esc, etc.) */
+    dismissible: boolean;
+    detectedAt: number;
+}
+/**
+ * Modal context attached to a snapshot. Field names match the web SDK's
+ * `SnapshotModalContext` so external agents can write transport-agnostic checks
+ * like `snapshot.modalStack?.hasBlockingModal`.
+ */
+interface NativeSnapshotModalContext {
+    modals: NativeModalInfo[];
+    topModal?: NativeModalInfo;
+    hasBlockingModal: boolean;
+    count: number;
+}
+/** A captured toast/snackbar */
+interface NativeCapturedToast {
+    id: string;
+    message: string;
+    level: 'info' | 'success' | 'warning' | 'error' | 'loading' | 'unknown';
+    appearedAt: number;
+    dismissedAt?: number;
+    visible: boolean;
+    /** Total duration in ms (lifetime so far if still visible, total if dismissed) */
+    durationMs: number;
+}
+/** Toast context attached to a snapshot */
+interface NativeSnapshotToastContext {
+    /** Toasts currently on screen */
+    active: NativeCapturedToast[];
+    /** Recently-dismissed toasts retained by the capture buffer (most recent first) */
+    recent: NativeCapturedToast[];
+    /** Total number of toasts ever captured by this tracker */
+    totalCaptured: number;
+}
+/**
+ * Undo/redo context attached to a snapshot. Mirrors the web SDK's
+ * `SnapshotUndoContext` minus DOM-only fields — RN has no `document.execCommand`
+ * or selectors, so the native variant relies entirely on developer declaration.
+ */
+interface NativeSnapshotUndoContext {
+    /** Whether undo appears to be available */
+    canUndo: boolean;
+    /** Whether redo appears to be available */
+    canRedo: boolean;
+    /** Description of what undo would reverse */
+    undoDescription?: string;
+    /** Description of what redo would restore */
+    redoDescription?: string;
+    /** Undo stack depth (if known) */
+    undoDepth?: number;
+    /** Redo stack depth (if known) */
+    redoDepth?: number;
+    /** Human-readable summary for AI */
+    summary: string;
+}
+/**
+ * Canonical enricher slot. Each tracker exposes a `getSnapshot*Context()` method
+ * that the registry calls during `createSnapshot`. NavigationTracker is intentionally
+ * NOT here — route info already flows through `currentRoute` / `segments`.
+ */
+interface NativeSnapshotEnrichers {
+    modalDetector?: {
+        getSnapshotModalContext(): NativeSnapshotModalContext;
+    };
+    toastCapture?: {
+        getSnapshotToastContext(): NativeSnapshotToastContext;
+    };
+    undoTracker?: {
+        getSnapshotUndoContext(): NativeSnapshotUndoContext;
+    };
+}
+/**
+ * Pluggable snapshot enricher: receives base context and returns extra fields
+ * that get `Object.assign`ed onto the snapshot. Used for ad-hoc/custom trackers
+ * (e.g. runner sidebar tabs) without growing the canonical enricher set.
+ */
+type NativeSnapshotEnricher = (ctx: {
+    elements: RegisteredNativeElement[];
+    currentRoute: string | null;
+}) => Record<string, unknown>;
 /**
  * UI Bridge Native feature flags
  */
@@ -380,4 +474,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeComponentAction as f, NativeCustomAction as g, NativeElementIdentifier as h, NativeElementRef as i, NativeElementState as j, NativeElementType as k, NativeFindRequest as l, NativeFindResponse as m, NativeLayout as n, NativeStandardAction as o, NativeUIBridgeConfig as p, NativeUIBridgeFeatures as q, RegisteredNativeElement as r, Workflow as s, WorkflowStep as t, WorkflowStepType as u };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, WorkflowStep as E, WorkflowStepType as F, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeCapturedToast as f, NativeComponentAction as g, NativeCustomAction as h, NativeElementIdentifier as i, NativeElementRef as j, NativeElementState as k, NativeElementType as l, NativeFindRequest as m, NativeFindResponse as n, NativeLayout as o, NativeModalInfo as p, NativeSnapshotEnricher as q, NativeSnapshotEnrichers as r, NativeSnapshotModalContext as s, NativeSnapshotToastContext as t, NativeSnapshotUndoContext as u, NativeStandardAction as v, NativeUIBridgeConfig as w, NativeUIBridgeFeatures as x, RegisteredNativeElement as y, Workflow as z };

package/dist/{types-BCYWwyVy.d.ts → types-ajakyp-l.d.ts}

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, l as NativeFindRequest, m as NativeFindResponse, j as NativeElementState } from './types-BPNuYxDx.js';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-Oz13YLZq.js';
 
 /**
  * UI Bridge Native Control Types
@@ -72,6 +72,22 @@ interface WaitResult {
     /** Error message if failed */
     error?: string;
 }
+/**
+ * Action event emitted after executeAction completes (success or failure).
+ */
+interface NativeActionEvent {
+    elementId: string;
+    action: string;
+    params?: unknown;
+    success: boolean;
+    error?: string;
+    /** ms since epoch when the executor finished the action */
+    timestamp: number;
+    /** request id propagated from ControlActionRequest, if any */
+    requestId?: string;
+    durationMs: number;
+}
+type NativeActionListener = (event: NativeActionEvent) => void;
 /**
  * Native action executor interface
  */
@@ -92,6 +108,8 @@ interface NativeActionExecutor {
      * Wait for element conditions
      */
     waitForElement(elementId: string, options: WaitOptions): Promise<WaitResult>;
+    /** Subscribe to action events. Returns an unsubscribe function. */
+    onActionExecuted(listener: NativeActionListener): () => void;
 }
 /**
  * Page navigation request
@@ -132,6 +150,8 @@ interface TypeActionParams {
     delay?: number;
     /** Clear existing text first */
     clearFirst?: boolean;
+    /** Alias for `clearFirst` matching the runner UI Bridge convention. */
+    clear?: boolean;
 }
 /**
  * Scroll action params
@@ -174,4 +194,4 @@ interface PressActionParams {
     duration?: number;
 }
 
-export type { ActionExecutionOptions as A, ControlActionRequest as C, NativeActionExecutor as N, PressActionParams as P, ScrollActionParams as S, TypeActionParams as T, WaitResult as W, ControlActionResponse as a, ComponentActionRequest as b, ComponentActionResponse as c, SwipeActionParams as d, PageNavigationResponse as e, PageNavigateRequest as f };
+export type { ActionExecutionOptions as A, ControlActionRequest as C, NativeActionExecutor as N, PressActionParams as P, ScrollActionParams as S, TypeActionParams as T, WaitResult as W, ControlActionResponse as a, ComponentActionRequest as b, ComponentActionResponse as c, SwipeActionParams as d, PageNavigationResponse as e, NativeActionListener as f, NativeActionEvent as g, PageNavigateRequest as h };

package/dist/{useUIBridge-CDZbWxII.d.ts → useUIBridgeToast-D32KXyL1.d.ts}

@@ -1,9 +1,9 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1 from 'react';
-import { q as NativeUIBridgeFeatures, p as NativeUIBridgeConfig, r as RegisteredNativeElement, R as RegisteredNativeComponent, e as NativeBridgeSnapshot, b as BridgeEventType, a as BridgeEventListener, k as NativeElementType, o as NativeStandardAction, g as NativeCustomAction, j as NativeElementState, i as NativeElementRef, h as NativeElementIdentifier, s as Workflow, N as NativeActionRequest, d as NativeActionResponse, l as NativeFindRequest, m as NativeFindResponse } from './types-BPNuYxDx.js';
-import { a as NativeUIBridgeRegistry } from './registry-B8A_EoxS.js';
-import { N as NativeActionExecutor } from './types-BCYWwyVy.js';
-import { i as NativeUIBridgeServer, m as ServerAdapter, l as RouteProvider } from './http-server-B7KudcYJ.js';
+import { p as NativeModalInfo, s as NativeSnapshotModalContext, f as NativeCapturedToast, t as NativeSnapshotToastContext, u as NativeSnapshotUndoContext, x as NativeUIBridgeFeatures, w as NativeUIBridgeConfig, y as RegisteredNativeElement, R as RegisteredNativeComponent, e as NativeBridgeSnapshot, b as BridgeEventType, a as BridgeEventListener, l as NativeElementType, v as NativeStandardAction, h as NativeCustomAction, k as NativeElementState, j as NativeElementRef, i as NativeElementIdentifier, z as Workflow, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse } from './types-Oz13YLZq.js';
+import { a as NativeUIBridgeRegistry } from './registry-z-3WJsxp.js';
+import { N as NativeActionExecutor } from './types-ajakyp-l.js';
+import { i as NativeUIBridgeServer, m as ServerAdapter, l as RouteProvider } from './http-server-Dj3grQW4.js';
 
 /**
  * Cloud Relay Client — WebSocket tunnel from mobile device to backend
@@ -56,6 +56,112 @@ declare class CloudRelayClient {
     private scheduleReconnect;
 }
 
+interface ModalPushInput {
+    id: string;
+    title?: string;
+    type?: NativeModalInfo['type'];
+    blocking?: boolean;
+    dismissible?: boolean;
+}
+/**
+ * Declarative modal store. Components/hooks call pushModal/dismissModal directly
+ * — there is no DOM/tree scanner. The detector is the single source of truth for
+ * the snapshot's modalStack context.
+ */
+declare class ModalDetector {
+    /** Map preserves O(1) idempotent replace by id; ordering comes from detectedAt. */
+    private modals;
+    pushModal(modal: ModalPushInput): void;
+    dismissModal(id: string): void;
+    getSnapshotModalContext(): NativeSnapshotModalContext;
+    getActive(): NativeModalInfo[];
+    clear(): void;
+}
+
+interface ToastRecordInput {
+    id: string;
+    message: string;
+    level?: NativeCapturedToast['level'];
+    appearedAt?: number;
+}
+interface ToastCaptureConfig {
+    maxRecent?: number;
+}
+/**
+ * Declarative toast/snackbar tracker. Components call recordToast/dismissToast
+ * directly — there is no DOM/tree scanner. The active map plus a fixed-size
+ * recent ring buffer feed the snapshot's toasts context.
+ */
+declare class ToastCapture {
+    private active;
+    private recent;
+    private totalCaptured;
+    private maxRecent;
+    constructor(config?: ToastCaptureConfig);
+    recordToast(toast: ToastRecordInput): void;
+    dismissToast(id: string): void;
+    getSnapshotToastContext(): NativeSnapshotToastContext;
+    clear(): void;
+}
+
+/**
+ * A single bridge action recorded for undo correlation. Action-correlation
+ * only — RN has no DOM/execCommand probe, so we rely on developer
+ * declaration plus this rolling history of recent actions.
+ */
+interface ActionRecord {
+    id: string;
+    type: string;
+    targetId?: string;
+    description?: string;
+    timestamp: number;
+    /** Default true — set false for actions that aren't reversible (e.g. navigation, network calls) */
+    reversible?: boolean;
+}
+/**
+ * Developer-declared undo/redo state. When set, this is authoritative and
+ * overrides any heuristic inference from action history.
+ */
+interface DeclaredUndoState {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoDescription?: string;
+    redoDescription?: string;
+    undoDepth?: number;
+    redoDepth?: number;
+}
+interface UndoTrackerConfig {
+    maxHistory?: number;
+}
+/**
+ * Action-correlation undo tracker for React Native.
+ *
+ * Maintains a rolling buffer of recent actions and a developer-declared
+ * undo state slot. The declared state is authoritative when set; otherwise
+ * we infer `canUndo` from whether any reversible action has been recorded.
+ * `executeUndo`/`executeRedo` are placeholders pending an IPC path through
+ * ui-bridge-native to the runner's `/control/undo`.
+ */
+declare class UndoTracker {
+    private readonly maxHistory;
+    private actions;
+    private declaredState;
+    constructor(config?: UndoTrackerConfig);
+    recordAction(record: ActionRecord): void;
+    setDeclaredState(state: DeclaredUndoState): void;
+    getActionHistory(): ActionRecord[];
+    getSnapshotUndoContext(): NativeSnapshotUndoContext;
+    executeUndo(): {
+        ok: boolean;
+        reason?: string;
+    };
+    executeRedo(): {
+        ok: boolean;
+        reason?: string;
+    };
+    clear(): void;
+}
+
 /**
  * UI Bridge Native context value
  */
@@ -68,6 +174,12 @@ interface UIBridgeNativeContextValue {
     registry: NativeUIBridgeRegistry;
     /** Action executor */
     executor: NativeActionExecutor;
+    /** Modal stack tracker (declarative pushModal/dismissModal) */
+    modalDetector: ModalDetector;
+    /** Toast/snackbar tracker (declarative recordToast/dismissToast) */
+    toastCapture: ToastCapture;
+    /** Undo/redo action-correlation tracker */
+    undoTracker: UndoTracker;
     /** Get all registered elements */
     getElements: () => RegisteredNativeElement[];
     /** Get all registered components */
@@ -568,4 +680,41 @@ declare function useUIBridge(): UseUIBridgeReturn;
  */
 declare function useUIBridgeRequired(): UseUIBridgeReturn;
 
-export { CloudRelayClient as C, type UIBridgeNativeContextValue as U, type CloudRelayConfig as a, type ComponentActionDef as b, type ComponentActionRequest as c, type ComponentActionResponse as d, UIBridgeNativeProvider as e, type UIBridgeNativeProviderProps as f, type UIBridgeProps as g, type UseUIBridgeReturn as h, type UseUIComponentOptions as i, type UseUIComponentReturn as j, type UseUIElementOptions as k, type UseUIElementReturn as l, type UseUIElementWithPropsReturn as m, useUIBridgeNative as n, useUIBridgeNativeOptional as o, useUIBridgeNativeRequired as p, useUIBridgeRequired as q, useUIComponent as r, useUIComponentAction as s, useUIElement as t, useUIBridge as u, useUIElementWithProps as v };
+interface UseUIBridgeModalOptions {
+    id: string;
+    title?: string;
+    type?: NativeModalInfo['type'];
+    blocking?: boolean;
+    dismissible?: boolean;
+}
+/**
+ * Declarative hook: while mounted, registers a modal entry on the active
+ * stack so UI Bridge snapshots reflect that a modal is open.
+ */
+declare function useUIBridgeModal(opts: UseUIBridgeModalOptions): void;
+
+interface UseUIBridgeToastOptions {
+    id: string;
+    message: string;
+    level?: NativeCapturedToast['level'];
+}
+/**
+ * Declarative hook: while mounted, surfaces a toast via the snapshot enricher.
+ * Best for explicit-lifecycle toast components.
+ */
+declare function useUIBridgeToast(opts: UseUIBridgeToastOptions): void;
+interface ToastRecorderInput {
+    id: string;
+    message: string;
+    level?: NativeCapturedToast['level'];
+}
+/**
+ * Imperative hook: returns a `recordToast` callback for code that fires
+ * toasts outside React (catch blocks, library callbacks, etc.).
+ */
+declare function useToastRecorder(): {
+    recordToast: (toast: ToastRecorderInput) => void;
+    dismissToast: (id: string) => void;
+};
+
+export { type ActionRecord as A, useUIBridgeNativeRequired as B, CloudRelayClient as C, type DeclaredUndoState as D, useUIBridgeRequired as E, useUIBridgeToast as F, useUIComponent as G, useUIComponentAction as H, useUIElement as I, useUIElementWithProps as J, ModalDetector as M, ToastCapture as T, type UIBridgeNativeContextValue as U, type CloudRelayConfig as a, type ComponentActionDef as b, type ComponentActionRequest as c, type ComponentActionResponse as d, type ModalPushInput as e, type ToastCaptureConfig as f, type ToastRecordInput as g, type ToastRecorderInput as h, UIBridgeNativeProvider as i, type UIBridgeNativeProviderProps as j, type UIBridgeProps as k, UndoTracker as l, type UndoTrackerConfig as m, type UseUIBridgeModalOptions as n, type UseUIBridgeReturn as o, type UseUIBridgeToastOptions as p, type UseUIComponentOptions as q, type UseUIComponentReturn as r, type UseUIElementOptions as s, type UseUIElementReturn as t, type UseUIElementWithPropsReturn as u, useToastRecorder as v, useUIBridge as w, useUIBridgeModal as x, useUIBridgeNative as y, useUIBridgeNativeOptional as z };