@qontinui/ui-bridge-native 0.3.2 → 0.5.1

package/dist/modal/index.d.ts

@@ -0,0 +1,2 @@
+export { ModalDetector } from './modal-detector';
+//# sourceMappingURL=index.d.ts.map

package/dist/modal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/modal/modal-detector.d.ts

@@ -0,0 +1,29 @@
+import type { NativeModalInfo, NativeSnapshotModalContext } from '../core/types';
+export 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.
+ */
+export declare class ModalDetector {
+    /** Map preserves O(1) idempotent replace by id; ordering comes from detectedAt. */
+    private modals;
+    pushModal(modal: ModalPushInput): void;
+    /**
+     * Remove a modal from the stack. Returns `true` if a modal with that id
+     * was actually deleted, `false` if nothing matched (idempotent so repeated
+     * calls don't throw, but callers — e.g. the HTTP test-hook endpoint — can
+     * surface the miss to clients).
+     */
+    dismissModal(id: string): boolean;
+    getSnapshotModalContext(): NativeSnapshotModalContext;
+    getActive(): NativeModalInfo[];
+    clear(): void;
+}
+//# sourceMappingURL=modal-detector.d.ts.map

package/dist/modal/modal-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-detector.d.ts","sourceRoot":"","sources":["../../src/modal/modal-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IACxB,mFAAmF;IACnF,OAAO,CAAC,MAAM,CAAsC;IAEpD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IActC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC,uBAAuB,IAAI,0BAA0B;IAarD,SAAS,IAAI,eAAe,EAAE;IAI9B,KAAK,IAAI,IAAI;CAGd"}

package/dist/react/StateAnnotation.d.ts

@@ -0,0 +1,30 @@
+import type { ReactElement, ReactNode } from 'react';
+export interface StateAnnotationRequiredElement {
+    role?: string;
+    text?: string;
+    testID?: string;
+    [key: string]: unknown;
+}
+export interface StateProps {
+    id: string;
+    name?: string;
+    description?: string;
+    requiredElements?: StateAnnotationRequiredElement[];
+    blocking?: boolean;
+    children?: ReactNode;
+    [key: string]: unknown;
+}
+export declare function State(props: StateProps): ReactElement;
+export interface TransitionToProps {
+    id: string;
+    name?: string;
+    fromStates?: string[];
+    activateStates?: string[];
+    exitStates?: string[];
+    effect?: string;
+    description?: string;
+    children?: ReactNode;
+    [key: string]: unknown;
+}
+export declare function TransitionTo(props: TransitionToProps): ReactElement;
+//# sourceMappingURL=StateAnnotation.d.ts.map

package/dist/react/StateAnnotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateAnnotation.d.ts","sourceRoot":"","sources":["../../src/react/StateAnnotation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,MAAM,WAAW,8BAA8B;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,8BAA8B,EAAE,CAAC;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAErD;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAEnE"}

package/dist/react/UIBridgeNativeProvider.d.ts

@@ -0,0 +1,163 @@
+/**
+ * UI Bridge Native Provider
+ *
+ * React context provider for UI Bridge Native functionality.
+ */
+import React from 'react';
+import type { NativeUIBridgeFeatures, NativeUIBridgeConfig, RegisteredNativeElement, RegisteredNativeComponent, NativeBridgeSnapshot, BridgeEventType, BridgeEventListener } from '../core/types';
+import { NativeUIBridgeRegistry } from '../core/registry';
+import type { NativeActionExecutor } from '../control/types';
+import { type ServerAdapter } from '../server/http-server';
+import type { RouteProvider, KeepAwakeProvider } from '../server/types';
+import { type CloudRelayConfig } from '../transport/CloudRelayClient';
+import { ModalDetector } from '../modal/modal-detector';
+import { ToastCapture } from '../toast/toast-capture';
+import { UndoTracker } from '../undo/undo-tracker';
+/**
+ * UI Bridge Native context value
+ */
+export interface UIBridgeNativeContextValue {
+    /** Feature flags */
+    features: NativeUIBridgeFeatures;
+    /** Configuration */
+    config: NativeUIBridgeConfig;
+    /** Element registry */
+    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 */
+    getComponents: () => RegisteredNativeComponent[];
+    /** Create a snapshot */
+    createSnapshot: () => NativeBridgeSnapshot;
+    /** Subscribe to events */
+    on: <T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>) => () => void;
+    /** Unsubscribe from events */
+    off: <T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>) => void;
+    /** Whether the provider is initialized */
+    initialized: boolean;
+    /** Server running status */
+    serverRunning: boolean;
+    /** Start the HTTP server */
+    startServer: () => Promise<void>;
+    /** Stop the HTTP server */
+    stopServer: () => void;
+    /** Get the current navigation route (if a RouteProvider is configured) */
+    getCurrentRoute: () => string | null;
+}
+/**
+ * UI Bridge Native provider props
+ */
+export interface UIBridgeNativeProviderProps {
+    /** Child components */
+    children: React.ReactNode;
+    /** Feature flags */
+    features?: NativeUIBridgeFeatures;
+    /** Configuration */
+    config?: NativeUIBridgeConfig;
+    /** Event handler */
+    onEvent?: BridgeEventListener;
+    /**
+     * A ServerAdapter instance for the HTTP server.
+     * The app is responsible for creating this using its preferred native TCP/HTTP library.
+     * @see ServerAdapter interface in server/http-server.ts
+     */
+    serverAdapter?: ServerAdapter;
+    /**
+     * Navigation provider for programmatic route navigation via UI Bridge.
+     * Pass Expo Router's push/back functions to enable `control/page/navigate`.
+     */
+    navigationProvider?: {
+        navigate: (url: string) => void;
+        back?: () => void;
+    };
+    /**
+     * Screenshot provider for native screen capture via UI Bridge.
+     * Pass a function that captures the current screen as base64 PNG.
+     */
+    screenshotProvider?: {
+        capture: () => Promise<{
+            base64: string;
+            width: number;
+            height: number;
+        }>;
+    };
+    /**
+     * Keep-awake provider for native screen-wake control via UI Bridge.
+     * Pass expo-keep-awake's activateKeepAwakeAsync/deactivateKeepAwake (wrapped
+     * to the request/release shape) so an external runner never loses the device
+     * to a screen lock. The SDK never imports expo-keep-awake directly.
+     */
+    keepAwakeProvider?: KeepAwakeProvider;
+    /**
+     * Route provider for exposing the current navigation route in snapshots.
+     * Wire this to Expo Router's `usePathname()` / `useSegments()` via a module-level ref.
+     */
+    routeProvider?: RouteProvider;
+    /**
+     * Configuration for the cloud relay tunnel (enables remote device verification
+     * when USB/LAN are not available).  Omit `uiBridgeServer` — the provider wires
+     * that automatically after the server starts.
+     */
+    cloudRelayConfig?: Omit<CloudRelayConfig, 'uiBridgeServer'>;
+    /**
+     * Enable mDNS advertisement so that runners on the same LAN can discover this
+     * device automatically (requires react-native-zeroconf).
+     */
+    enableMdnsAnnounce?: boolean;
+    /**
+     * Stable device identifier used for mDNS TXT records and cloud relay
+     * registration.  Typically sourced from expo-device or a UUID stored in
+     * AsyncStorage.
+     */
+    deviceId?: string;
+}
+/**
+ * UI Bridge Native Provider
+ *
+ * Provides UI Bridge Native context to child components.
+ *
+ * @example
+ * ```tsx
+ * // app/_layout.tsx
+ * import { UIBridgeNativeProvider } from 'ui-bridge-native';
+ *
+ * export default function RootLayout() {
+ *   return (
+ *     <UIBridgeNativeProvider
+ *       features={{ server: __DEV__, debug: __DEV__ }}
+ *       config={{ serverPort: 8087 }}
+ *     >
+ *       <Stack>{children}</Stack>
+ *     </UIBridgeNativeProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function UIBridgeNativeProvider({ children, features, config, onEvent, serverAdapter, navigationProvider, screenshotProvider, keepAwakeProvider, routeProvider, cloudRelayConfig, enableMdnsAnnounce, deviceId, }: UIBridgeNativeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * useUIBridgeNative hook
+ *
+ * Access the UI Bridge Native context. Throws if used outside provider.
+ */
+export declare function useUIBridgeNative(): UIBridgeNativeContextValue;
+/**
+ * useUIBridgeNativeOptional hook
+ *
+ * Access the UI Bridge Native context, returning null if outside provider.
+ */
+export declare function useUIBridgeNativeOptional(): UIBridgeNativeContextValue | null;
+/**
+ * useUIBridgeNativeRequired hook
+ *
+ * Alias for useUIBridgeNative (throws if outside provider).
+ */
+export declare const useUIBridgeNativeRequired: typeof useUIBridgeNative;
+//# sourceMappingURL=UIBridgeNativeProvider.d.ts.map

package/dist/react/UIBridgeNativeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIBridgeNativeProvider.d.ts","sourceRoot":"","sources":["../../src/react/UIBridgeNativeProvider.tsx"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -1,72 +1,17 @@
-export { b as ComponentActionDef, c as ComponentActionRequest, d as ComponentActionResponse, S as State, f as StateAnnotationRequiredElement, g as StateProps, j as ToastRecorderInput, k as TransitionTo, l as TransitionToProps, U as UIBridgeNativeContextValue, m as UIBridgeNativeProvider, n as UIBridgeNativeProviderProps, o as UIBridgeProps, r as UseUIBridgeModalOptions, s as UseUIBridgeReturn, t as UseUIBridgeToastOptions, u as UseUIComponentOptions, v as UseUIComponentReturn, w as UseUIElementOptions, x as UseUIElementReturn, y as UseUIElementWithPropsReturn, z as useToastRecorder, B as useUIBridge, E as useUIBridgeModal, F as useUIBridgeNative, G as useUIBridgeNativeOptional, H as useUIBridgeNativeRequired, I as useUIBridgeRequired, J as useUIBridgeToast, K as useUIComponent, L as useUIComponentAction, N as useUIElement, O as useUIElementWithProps } from '../StateAnnotation--zm0Jfqj.js';
-import { j as NativeElementRef } from '../types-CGVut7mc.js';
-import { b as RegisterElementOptions } from '../registry-pAUpQq2O.js';
-import 'react/jsx-runtime';
-import 'react';
-import '../types-CjEKTDYT.js';
-import '../http-server-C9NaNBEP.js';
-import '../design-types-BHr6Q1FX.js';
-
 /**
- * useAutoRegister Hook for React Native
+ * UI Bridge Native - React
  *
- * Enables automatic registration of interactive React Native components.
- * Unlike the web version, this doesn't use MutationObserver (no DOM).
- * Instead, it provides a simple API for components to register themselves.
- *
- * For comprehensive coverage in React Native, components should:
- * 1. Use this hook at the app root to enable the registry
- * 2. Use useUIElement on interactive components (or wrap with Pressable/TouchableOpacity)
- */
-
-/**
- * Options for auto-registration in React Native
- */
-interface NativeAutoRegisterOptions {
-    /** Enable auto-registration (default: true in dev mode) */
-    enabled?: boolean;
-    /** Callback when element is registered */
-    onRegister?: (id: string) => void;
-    /** Callback when element is unregistered */
-    onUnregister?: (id: string) => void;
-}
-/**
- * Handle returned by useAutoRegister for programmatic registration
- */
-interface NativeAutoRegisterHandle {
-    /** Register an element programmatically */
-    register: (id: string, ref: React.RefObject<NativeElementRef>, options?: RegisterElementOptions) => void;
-    /** Unregister an element programmatically */
-    unregister: (id: string) => void;
-    /** Check if auto-registration is enabled */
-    isEnabled: boolean;
-}
-/**
- * Hook for enabling automatic element registration in React Native.
- *
- * Since React Native doesn't have a DOM to observe, this hook provides
- * a handle for programmatic registration. For most use cases, you should
- * use useUIElement directly on interactive components.
- *
- * @example
- * ```tsx
- * function App() {
- *   const autoRegister = useAutoRegister({ enabled: __DEV__ });
- *
- *   // Programmatic registration (rare use case)
- *   useEffect(() => {
- *     autoRegister.register('custom-element', {
- *       type: 'button',
- *       label: 'Custom Button',
- *     });
- *
- *     return () => autoRegister.unregister('custom-element');
- *   }, []);
- *
- *   return <YourApp />;
- * }
- * ```
+ * React hooks and provider for React Native.
  */
-declare function useAutoRegister(options?: NativeAutoRegisterOptions): NativeAutoRegisterHandle;
-
-export { type NativeAutoRegisterHandle, type NativeAutoRegisterOptions, useAutoRegister };
+export * from './UIBridgeNativeProvider';
+export * from './useUIElement';
+export * from './useUIComponent';
+export * from './useUIBridge';
+export * from './useAutoRegister';
+export { useUIBridgeModal } from './useUIBridgeModal';
+export type { UseUIBridgeModalOptions } from './useUIBridgeModal';
+export { useUIBridgeToast, useToastRecorder } from './useUIBridgeToast';
+export type { UseUIBridgeToastOptions, ToastRecorderInput } from './useUIBridgeToast';
+export { State, TransitionTo } from './StateAnnotation';
+export type { StateProps, TransitionToProps, StateAnnotationRequiredElement } from './StateAnnotation';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/react/index.js

@@ -2168,6 +2168,14 @@ function createServerHandlers(registry, executor, config) {
         "NOT_SUPPORTED"
       );
     },
+    // Keep-awake (stub — apps should override via setKeepAwakeProvider, which
+    // the provider wires when a keepAwakeProvider prop is supplied)
+    keepAwake: async () => {
+      return error2(
+        "keep-awake not configured. Provide a keepAwakeProvider to UIBridgeNativeProvider.",
+        "NOT_SUPPORTED"
+      );
+    },
     // Meta / Introspection (stub — server constructor overrides with real route table)
     getMethods: async () => {
       return error2("Methods introspection not configured", "NOT_SUPPORTED");
@@ -2841,6 +2849,12 @@ var WS_ROUTES = [
     httpMethods: ["POST"],
     requiresTestHooks: true
   },
+  {
+    pattern: "control/keep-awake",
+    handler: "keepAwake",
+    httpMethods: ["POST"],
+    requiresTestHooks: true
+  },
   // Observability — last-N console errors + network requests. testHooks-gated
   // because patching `console.error` / `fetch` is invasive in production.
   {
@@ -2893,7 +2907,8 @@ var HANDLER_DESCRIPTIONS = {
   getConsoleErrors: "TEST HOOK \u2014 last-N console.error/console.warn entries; ?since=<ms>&limit=<n>",
   getNetworkRequests: "TEST HOOK \u2014 last-N fetch/XHR entries with status + duration; ?since=<ms>&limit=<n>",
   pushModal: "TEST HOOK \u2014 push a modal onto the snapshot.modalStack via the registry ModalDetector",
-  dismissModal: "TEST HOOK \u2014 dismiss a modal by id from the snapshot.modalStack via the registry ModalDetector"
+  dismissModal: "TEST HOOK \u2014 dismiss a modal by id from the snapshot.modalStack via the registry ModalDetector",
+  keepAwake: "TEST HOOK \u2014 keep the device screen awake via the injected keepAwakeProvider: body { enabled: boolean, durationMs?: number }"
 };
 var ACTION_REFERENCE = [
   { name: "press", aliases: ["click"], params: "PressActionParams (optional position)" },
@@ -3161,6 +3176,35 @@ var NativeUIBridgeServer = class {
       }
     };
   }
+  /**
+   * Set a keep-awake provider for native screen-wake control.
+   * This enables `control/keep-awake` and arms the auto-arm hook in
+   * handleRequest (every request keeps the screen alive for 60s).
+   */
+  setKeepAwakeProvider(provider) {
+    this.keepAwakeProvider = provider;
+    this.handlers.keepAwake = async (ctx) => {
+      const { enabled, durationMs } = ctx.body ?? {};
+      if (typeof enabled !== "boolean") {
+        return {
+          success: false,
+          error: "enabled must be boolean",
+          code: "INVALID_REQUEST",
+          timestamp: Date.now()
+        };
+      }
+      if (enabled) {
+        provider.request("ui-bridge", typeof durationMs === "number" ? durationMs : void 0);
+      } else {
+        provider.release("ui-bridge");
+      }
+      return {
+        success: true,
+        data: { enabled, durationMs: typeof durationMs === "number" ? durationMs : null },
+        timestamp: Date.now()
+      };
+    };
+  }
   /**
    * Start the HTTP server
    */
@@ -3753,6 +3797,12 @@ var NativeUIBridgeServer = class {
     if (request.method === "OPTIONS") {
       return { status: 204, headers, body: "" };
     }
+    if (this.config.testHooks === true && this.keepAwakeProvider) {
+      try {
+        this.keepAwakeProvider.request("auto-arm", 6e4);
+      } catch {
+      }
+    }
     try {
       const response = await this.routeRequest(request);
       return {
@@ -4653,6 +4703,7 @@ function UIBridgeNativeProvider({
   serverAdapter,
   navigationProvider,
   screenshotProvider,
+  keepAwakeProvider,
   routeProvider,
   cloudRelayConfig,
   enableMdnsAnnounce,
@@ -4707,6 +4758,9 @@ function UIBridgeNativeProvider({
     if (screenshotProvider) {
       server.setScreenshotProvider(screenshotProvider);
     }
+    if (keepAwakeProvider) {
+      server.setKeepAwakeProvider(keepAwakeProvider);
+    }
     if (routeProvider) {
       server.setRouteProvider(routeProvider);
     }
@@ -4760,6 +4814,7 @@ function UIBridgeNativeProvider({
     serverAdapter,
     navigationProvider,
     screenshotProvider,
+    keepAwakeProvider,
     routeProvider
   ]);
   const stopServer = react.useCallback(() => {
@@ -4793,6 +4848,7 @@ function UIBridgeNativeProvider({
           });
           if (navigationProvider) bareServer.setNavigationProvider(navigationProvider);
           if (screenshotProvider) bareServer.setScreenshotProvider(screenshotProvider);
+          if (keepAwakeProvider) bareServer.setKeepAwakeProvider(keepAwakeProvider);
           if (routeProvider) bareServer.setRouteProvider(routeProvider);
           serverRef.current = bareServer;
         } catch (err) {
@@ -4937,17 +4993,17 @@ function UIBridgeNativeProvider({
       getCurrentRoute
     ]
   );
-  return /* @__PURE__ */ jsxRuntime.jsx(UIBridgeNativeContext.Provider, { value: contextValue, children });
+  return /* @__PURE__ */ jsxRuntime.jsx(UIBridgeNativeContext, { value: contextValue, children });
 }
 function useUIBridgeNative() {
-  const context = react.useContext(UIBridgeNativeContext);
+  const context = react.use(UIBridgeNativeContext);
   if (!context) {
     throw new Error("useUIBridgeNative must be used within a UIBridgeNativeProvider");
   }
   return context;
 }
 function useUIBridgeNativeOptional() {
-  return react.useContext(UIBridgeNativeContext);
+  return react.use(UIBridgeNativeContext);
 }
 var useUIBridgeNativeRequired = useUIBridgeNative;
 function flattenStyle(style) {