@qontinui/ui-bridge-native 0.1.5 → 0.2.0

package/dist/{useUIBridge-DfIEq9EQ.d.mts → useUIBridgeToast-GmT1TzUe.d.mts}

@@ -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.mjs';
-import { a as NativeUIBridgeRegistry } from './registry-DhbGbl9c.mjs';
-import { N as NativeActionExecutor } from './types-Bcj7ji97.mjs';
-import { i as NativeUIBridgeServer, m as ServerAdapter, l as RouteProvider } from './http-server-D7uVANBU.mjs';
+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.mjs';
+import { a as NativeUIBridgeRegistry } from './registry-Cahd8Gn2.mjs';
+import { N as NativeActionExecutor } from './types-DAfCeWXc.mjs';
+import { i as NativeUIBridgeServer, m as ServerAdapter, l as RouteProvider } from './http-server-DCdR8WlL.mjs';
 
 /**
  * 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge-native",
-  "version": "0.1.5",
+  "version": "0.2.0",
   "description": "UI Bridge Framework for React Native - Hooks and providers for UI observation and control in mobile apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",