@qontinui/ui-bridge-native 0.2.0 → 0.3.0

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

@@ -267,6 +267,24 @@ interface NativeActionResponse {
     /** Time spent waiting for conditions */
     waitDurationMs?: number;
 }
+/**
+ * Registration coverage metadata. Lets automation agents detect routes that
+ * have interactive controls but never registered any of them with the bridge,
+ * without having to read source code.
+ *
+ * - `totalRegistered`: number of elements currently in the registry.
+ * - `everHadRegistrations`: sticks `true` once any element is registered, even
+ *   after every element has been unregistered. A route that registered then
+ *   unmounted should NOT be reported as "never wired".
+ * - `byRoute`: count of currently-registered elements grouped by
+ *   `registrationRoute`. Elements registered without a route are bucketed
+ *   under `'?'`, which is itself a useful diagnostic signal.
+ */
+interface NativeRegistrationCoverage {
+    totalRegistered: number;
+    everHadRegistrations: boolean;
+    byRoute: Record<string, number>;
+}
 /**
  * Snapshot of the entire native UI bridge state
  */
@@ -312,6 +330,11 @@ interface NativeBridgeSnapshot {
     toasts?: NativeSnapshotToastContext;
     /** Undo/redo context (populated when an undoTracker enricher is registered) */
     undoRedo?: NativeSnapshotUndoContext;
+    /**
+     * Registration coverage metadata so agents can detect routes that have
+     * interactive controls but did not register them with the bridge.
+     */
+    registration?: NativeRegistrationCoverage;
 }
 /** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
 interface NativeModalInfo {
@@ -376,15 +399,32 @@ interface NativeSnapshotUndoContext {
     /** Human-readable summary for AI */
     summary: string;
 }
+/**
+ * Modal-stack tracker contract. Surfaced in NativeSnapshotEnrichers so the
+ * test-hook HTTP endpoints (`control/modal/push`, `control/modal/dismiss/:id`)
+ * can drive the same instance the snapshot reads from. Any duck-typed
+ * implementation that satisfies this shape can fill the slot — production
+ * uses the `ModalDetector` class.
+ */
+interface NativeModalDetectorLike {
+    getSnapshotModalContext(): NativeSnapshotModalContext;
+    pushModal(modal: {
+        id: string;
+        title?: string;
+        type?: NativeModalInfo['type'];
+        blocking?: boolean;
+        dismissible?: boolean;
+    }): void;
+    dismissModal(id: string): boolean | void;
+    getActive(): NativeModalInfo[];
+}
 /**
  * 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;
-    };
+    modalDetector?: NativeModalDetectorLike;
     toastCapture?: {
         getSnapshotToastContext(): NativeSnapshotToastContext;
     };
@@ -409,6 +449,14 @@ interface NativeUIBridgeFeatures {
     server?: boolean;
     /** Enable debug tools (inspector overlay) */
     debug?: boolean;
+    /**
+     * Enable test-only HTTP endpoints that let external runners drive
+     * registry-internal state (currently `control/modal/push` and
+     * `control/modal/dismiss/:id`). Default `false` so production builds
+     * cannot have their modal stack manipulated remotely; set to `true`
+     * (typically gated on `__DEV__`) when running automated tests.
+     */
+    testHooks?: boolean;
 }
 /**
  * UI Bridge Native configuration
@@ -474,4 +522,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-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 };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeModalDetectorLike as H, 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, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };

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

@@ -267,6 +267,24 @@ interface NativeActionResponse {
     /** Time spent waiting for conditions */
     waitDurationMs?: number;
 }
+/**
+ * Registration coverage metadata. Lets automation agents detect routes that
+ * have interactive controls but never registered any of them with the bridge,
+ * without having to read source code.
+ *
+ * - `totalRegistered`: number of elements currently in the registry.
+ * - `everHadRegistrations`: sticks `true` once any element is registered, even
+ *   after every element has been unregistered. A route that registered then
+ *   unmounted should NOT be reported as "never wired".
+ * - `byRoute`: count of currently-registered elements grouped by
+ *   `registrationRoute`. Elements registered without a route are bucketed
+ *   under `'?'`, which is itself a useful diagnostic signal.
+ */
+interface NativeRegistrationCoverage {
+    totalRegistered: number;
+    everHadRegistrations: boolean;
+    byRoute: Record<string, number>;
+}
 /**
  * Snapshot of the entire native UI bridge state
  */
@@ -312,6 +330,11 @@ interface NativeBridgeSnapshot {
     toasts?: NativeSnapshotToastContext;
     /** Undo/redo context (populated when an undoTracker enricher is registered) */
     undoRedo?: NativeSnapshotUndoContext;
+    /**
+     * Registration coverage metadata so agents can detect routes that have
+     * interactive controls but did not register them with the bridge.
+     */
+    registration?: NativeRegistrationCoverage;
 }
 /** A single detected modal-like surface (modal, sheet, drawer, popover, alert) */
 interface NativeModalInfo {
@@ -376,15 +399,32 @@ interface NativeSnapshotUndoContext {
     /** Human-readable summary for AI */
     summary: string;
 }
+/**
+ * Modal-stack tracker contract. Surfaced in NativeSnapshotEnrichers so the
+ * test-hook HTTP endpoints (`control/modal/push`, `control/modal/dismiss/:id`)
+ * can drive the same instance the snapshot reads from. Any duck-typed
+ * implementation that satisfies this shape can fill the slot — production
+ * uses the `ModalDetector` class.
+ */
+interface NativeModalDetectorLike {
+    getSnapshotModalContext(): NativeSnapshotModalContext;
+    pushModal(modal: {
+        id: string;
+        title?: string;
+        type?: NativeModalInfo['type'];
+        blocking?: boolean;
+        dismissible?: boolean;
+    }): void;
+    dismissModal(id: string): boolean | void;
+    getActive(): NativeModalInfo[];
+}
 /**
  * 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;
-    };
+    modalDetector?: NativeModalDetectorLike;
     toastCapture?: {
         getSnapshotToastContext(): NativeSnapshotToastContext;
     };
@@ -409,6 +449,14 @@ interface NativeUIBridgeFeatures {
     server?: boolean;
     /** Enable debug tools (inspector overlay) */
     debug?: boolean;
+    /**
+     * Enable test-only HTTP endpoints that let external runners drive
+     * registry-internal state (currently `control/modal/push` and
+     * `control/modal/dismiss/:id`). Default `false` so production builds
+     * cannot have their modal stack manipulated remotely; set to `true`
+     * (typically gated on `__DEV__`) when running automated tests.
+     */
+    testHooks?: boolean;
 }
 /**
  * UI Bridge Native configuration
@@ -474,4 +522,4 @@ interface NativeFindResponse {
     timestamp: number;
 }
 
-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 };
+export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, Workflow as E, WorkflowStep as F, WorkflowStepType as G, NativeModalDetectorLike as H, 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, NativeRegistrationCoverage as q, NativeSnapshotEnricher as r, NativeSnapshotEnrichers as s, NativeSnapshotModalContext as t, NativeSnapshotToastContext as u, NativeSnapshotUndoContext as v, NativeStandardAction as w, NativeUIBridgeConfig as x, NativeUIBridgeFeatures as y, RegisteredNativeElement as z };

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

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-Oz13YLZq.js';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-BwdPNpII.js';
 
 /**
  * UI Bridge Native Control Types

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

@@ -1,4 +1,4 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-Oz13YLZq.mjs';
+import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, m as NativeFindRequest, n as NativeFindResponse, k as NativeElementState } from './types-BwdPNpII.mjs';
 
 /**
  * UI Bridge Native Control Types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/ui-bridge-native",
-  "version": "0.2.0",
+  "version": "0.3.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",
@@ -72,7 +72,7 @@
     "typescript": "^5.3.0",
     "vitest": "^4.0.18"
   },
-  "license": "MIT",
+  "license": "AGPL-3.0-or-later",
   "repository": {
     "type": "git",
     "url": "https://github.com/qontinui/ui-bridge.git",