@qontinui/ui-bridge-native 0.1.5 → 0.1.6

package/dist/index.d.mts

@@ -1,89 +0,0 @@
-export { A as ActionHandler, B as BridgeEvent, a as BridgeEventListener, b as BridgeEventType, C as ComponentAction, c as CustomAction, D as DiscoveredNativeElement, N as NativeActionRequest, d as NativeActionResponse, e as NativeBridgeSnapshot, f as NativeComponentAction, g as NativeCustomAction, h as NativeElementIdentifier, i as NativeElementRef, j as NativeElementState, k as NativeElementType, l as NativeFindRequest, m as NativeFindResponse, n as NativeLayout, o as NativeStandardAction, p as NativeUIBridgeConfig, q as NativeUIBridgeFeatures, R as RegisteredNativeComponent, r as RegisteredNativeElement, W as WaitOptions, s as Workflow, t as WorkflowStep, u as WorkflowStepType } from './types-BPNuYxDx.mjs';
-export { N as NativeRegistryConfig, a as NativeUIBridgeRegistry, R as RegisterComponentOptions, b as RegisterElementOptions, e as extractHandlerNames, g as getGlobalRegistry, r as resetGlobalRegistry, s as setGlobalRegistry } from './registry-DhbGbl9c.mjs';
-export { buildTreePath, createNativeElementIdentifier, findAllByPattern, findElementByIdentifier, matchesIdentifier, parseTreePath } from './core/index.mjs';
-export { C as CloudRelayClient, a as CloudRelayConfig, b as ComponentActionDef, c as ComponentActionRequest, d as ComponentActionResponse, U as UIBridgeNativeContextValue, e as UIBridgeNativeProvider, f as UIBridgeNativeProviderProps, g as UIBridgeProps, h as UseUIBridgeReturn, i as UseUIComponentOptions, j as UseUIComponentReturn, k as UseUIElementOptions, l as UseUIElementReturn, m as UseUIElementWithPropsReturn, u as useUIBridge, n as useUIBridgeNative, o as useUIBridgeNativeOptional, p as useUIBridgeNativeRequired, q as useUIBridgeRequired, r as useUIComponent, s as useUIComponentAction, t as useUIElement, v as useUIElementWithProps } from './useUIBridge-DfIEq9EQ.mjs';
-export { A as ActionExecutionOptions, C as ControlActionRequest, a as ControlActionResponse, b as ControlComponentActionRequest, c as ControlComponentActionResponse, N as NativeActionExecutor, P as PressActionParams, S as ScrollActionParams, d as SwipeActionParams, T as TypeActionParams, W as WaitResult } from './types-Bcj7ji97.mjs';
-export { DefaultNativeActionExecutor, createNativeActionExecutor } from './control/index.mjs';
-export { A as APIResponse, H as HTTPRequest, a as HTTPResponse, b as HandlerContext, c as HandlerFunction, J as JsonRpcBatchRequest, d as JsonRpcBatchResponse, e as JsonRpcEvent, f as JsonRpcRequest, g as JsonRpcResponse, N as NativeServerConfig, h as NativeServerHandlers, i as NativeUIBridgeServer, j as NavigationProvider, R as RequestHandler, k as RouteDefinition, l as RouteProvider, S as ScreenshotProvider, m as ServerAdapter, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, n as WebSocketEventBridge, o as WebSocketMessageHandler, p as WebSocketServerAdapter, q as createNativeServer } from './http-server-D7uVANBU.mjs';
-export { NativeDesignHandlers, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers } from './server/index.mjs';
-export { E as ElementDesignData, a as ExtendedComputedStyles, F as FlattenedNativeStyle, N as NativeInteractionStateName, b as NativeStateStyles, P as PseudoElementStyles, R as ResponsiveSnapshot, S as StateStyles, c as StyleDiff } from './design-types-BHr6Q1FX.mjs';
-export { captureNativeResponsiveSnapshot, captureNativeStateVariations, getNativeElementDesignData, mapNativeStyleToExtended } from './design/index.mjs';
-export { UIBridgeInspector, UIBridgeInspectorProps } from './debug/index.mjs';
-import 'react/jsx-runtime';
-import 'react';
-
-/**
- * Device Announcer — mDNS + Cloud registration for physical device discovery
- *
- * Announces the UI Bridge service on the local network via mDNS (when
- * react-native-zeroconf is available) and optionally registers with the
- * cloud relay backend.
- */
-interface AnnouncerConfig {
-    /** Stable device identifier */
-    deviceId: string;
-    /** App bundle/package ID */
-    appId: string;
-    /** UI Bridge server port (default 8087) */
-    port?: number;
-    /** Cloud relay WebSocket URL for registration */
-    cloudRelayUrl?: string;
-    /** Auth token for cloud relay */
-    cloudToken?: string;
-    /** UI Bridge SDK version */
-    version?: string;
-}
-interface DeviceAnnouncerState {
-    mdnsActive: boolean;
-    cloudConnected: boolean;
-}
-/** Minimal interface for the react-native-zeroconf Zeroconf instance */
-interface ZeroconfService {
-    publishService(type: string, protocol: string, domain: string, name: string, port: number, txtRecord: Record<string, string>): void;
-    unpublishService(name: string): void;
-}
-/**
- * Announces the UI Bridge server on the local network (mDNS) and optionally
- * registers with the qontinui.io cloud relay for remote discovery.
- */
-declare class DeviceAnnouncer {
-    private config;
-    private state;
-    private cloudWs;
-    private reconnectTimer;
-    private reconnectDelay;
-    private stopped;
-    /** Zeroconf instance, set when mDNS is successfully started */
-    private zeroconf;
-    /** Rotated pairing token for mDNS TXT records */
-    private pairingToken;
-    constructor(config: AnnouncerConfig);
-    /**
-     * Start mDNS advertisement.
-     *
-     * The consumer must pass the `Zeroconf` constructor (from `react-native-zeroconf`)
-     * explicitly; otherwise this is a no-op.
-     *
-     * Rationale: Metro's `require()` throws an uncatchable module-load error if the
-     * bundle doesn't include the named package. That error escapes async try/catch
-     * boundaries and crashes the app. We avoid it by never calling `require()`
-     * ourselves — the consumer imports the package when they know it's installed.
-     *
-     * @param ZeroconfCtor - constructor from `import Zeroconf from 'react-native-zeroconf'`
-     */
-    startMdnsAdvertise(ZeroconfCtor?: new () => ZeroconfService): Promise<void>;
-    /**
-     * Connect to the cloud relay WebSocket and send a device_register message.
-     *
-     * Reconnects automatically with exponential backoff (2 s → 60 s) if the
-     * connection drops.
-     */
-    connectCloudRelay(): Promise<void>;
-    /** Stop all advertising and registration. */
-    stop(): Promise<void>;
-    /** Return a copy of the current announcer state. */
-    getState(): DeviceAnnouncerState;
-    private scheduleReconnect;
-}
-
-export { type AnnouncerConfig, DeviceAnnouncer, type DeviceAnnouncerState };

package/dist/registry-DhbGbl9c.d.mts

@@ -1,215 +0,0 @@
-import { a as BridgeEventListener, i as NativeElementRef, k as NativeElementType, o as NativeStandardAction, g as NativeCustomAction, r as RegisteredNativeElement, j as NativeElementState, R as RegisteredNativeComponent, s as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot } from './types-BPNuYxDx.mjs';
-
-/**
- * Native Element and Component Registry
- *
- * Central registry for all UI elements and components registered with UI Bridge Native.
- * Adapted from ui-bridge for React Native environments.
- */
-
-/**
- * Options for registering an element
- */
-interface RegisterElementOptions {
-    type?: NativeElementType;
-    label?: string;
-    actions?: NativeStandardAction[];
-    customActions?: Record<string, NativeCustomAction>;
-    props?: Record<string, unknown>;
-    treePath?: string;
-    testId?: string;
-    accessibilityLabel?: string;
-    /** Route path where the element was registered (for page-scoped filtering) */
-    registrationRoute?: string | null;
-    /** Flattened RN style (from StyleSheet.flatten) for design review */
-    flatStyle?: Record<string, unknown>;
-    /** State-specific style overrides for design review */
-    stateStyles?: {
-        pressed?: Record<string, unknown>;
-        focused?: Record<string, unknown>;
-        disabled?: Record<string, unknown>;
-    };
-}
-/**
- * Options for registering a component
- */
-interface RegisterComponentOptions {
-    name: string;
-    description?: string;
-    actions?: Array<{
-        id: string;
-        label?: string;
-        description?: string;
-        handler: (params?: unknown) => unknown | Promise<unknown>;
-    }>;
-    elementIds?: string[];
-}
-/**
- * Registry configuration
- */
-interface NativeRegistryConfig {
-    verbose?: boolean;
-    onEvent?: BridgeEventListener;
-}
-/**
- * Extract handler function names from an element's props.
- * Returns names of props whose values are functions (e.g. ['onPress', 'onChangeText']).
- */
-declare function extractHandlerNames(props?: Record<string, unknown>): string[];
-/**
- * Native UI Bridge Registry
- *
- * Manages registration and lookup of native UI elements and components.
- */
-declare class NativeUIBridgeRegistry {
-    private elements;
-    private components;
-    private workflows;
-    private eventListeners;
-    private config;
-    constructor(config?: NativeRegistryConfig);
-    /**
-     * Register a native element
-     */
-    registerElement(id: string, ref: React.RefObject<NativeElementRef>, options?: RegisterElementOptions): RegisteredNativeElement;
-    /**
-     * Unregister an element
-     */
-    unregisterElement(id: string): void;
-    /**
-     * Get a registered element
-     */
-    getElement(id: string): RegisteredNativeElement | undefined;
-    /**
-     * Get all registered elements
-     */
-    getAllElements(): RegisteredNativeElement[];
-    /**
-     * Get all registered elements that are visible and have a layout
-     */
-    getVisibleElements(): RegisteredNativeElement[];
-    /**
-     * Get elements registered on a specific route (for page-scoped filtering)
-     */
-    getElementsForRoute(route: string): RegisteredNativeElement[];
-    /**
-     * Mark elements registered on a route as off-screen (visible: false, layout: null).
-     *
-     * Use this when a screen loses focus but stays mounted — common in React Navigation
-     * tab navigators where inactive tabs remain in the tree. Without this call, stale
-     * `layout` data lingers in snapshots and makes off-screen elements look rendered.
-     *
-     * Does NOT unregister the elements — they stay registered so the user's next visit
-     * re-measures them via `onLayout` without re-mount cost. Elements without a
-     * `registrationRoute` (app-wide registrations) are untouched.
-     */
-    markRouteOffscreen(route: string): void;
-    /**
-     * Update element state
-     */
-    updateElementState(id: string, state: Partial<NativeElementState>): void;
-    /**
-     * Update element props (for action execution)
-     */
-    updateElementProps(id: string, props: Record<string, unknown>): void;
-    /**
-     * Update element style for design review
-     */
-    updateElementStyle(id: string, flatStyle: Record<string, unknown>, stateStyles?: {
-        pressed?: Record<string, unknown>;
-        focused?: Record<string, unknown>;
-        disabled?: Record<string, unknown>;
-    }): void;
-    /**
-     * Get element style for design review
-     */
-    getElementStyle(id: string): Record<string, unknown> | null;
-    /**
-     * Find element by testID
-     */
-    findByTestId(testId: string): RegisteredNativeElement | undefined;
-    /**
-     * Find elements by type
-     */
-    findByType(type: NativeElementType): RegisteredNativeElement[];
-    /**
-     * Register a component
-     */
-    registerComponent(id: string, options: RegisterComponentOptions): RegisteredNativeComponent;
-    /**
-     * Unregister a component
-     */
-    unregisterComponent(id: string): void;
-    /**
-     * Get a registered component
-     */
-    getComponent(id: string): RegisteredNativeComponent | undefined;
-    /**
-     * Get all registered components
-     */
-    getAllComponents(): RegisteredNativeComponent[];
-    /**
-     * Register a workflow
-     */
-    registerWorkflow(workflow: Workflow): void;
-    /**
-     * Unregister a workflow
-     */
-    unregisterWorkflow(id: string): void;
-    /**
-     * Get a workflow
-     */
-    getWorkflow(id: string): Workflow | undefined;
-    /**
-     * Get all workflows
-     */
-    getAllWorkflows(): Workflow[];
-    /**
-     * Subscribe to events
-     */
-    on<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): () => void;
-    /**
-     * Unsubscribe from events
-     */
-    off<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): void;
-    /**
-     * Emit an event
-     */
-    emit(type: BridgeEventType, data: unknown): void;
-    /**
-     * Create a snapshot of the current state
-     */
-    createSnapshot(routeInfo?: {
-        currentRoute?: string | null;
-        segments?: string[];
-    }, options?: {
-        visibleOnly?: boolean;
-        currentRouteOnly?: boolean;
-    }): NativeBridgeSnapshot;
-    /**
-     * Get registry statistics
-     */
-    getStats(): {
-        elements: number;
-        components: number;
-        workflows: number;
-    };
-    /**
-     * Clear all registrations
-     */
-    clear(): void;
-}
-/**
- * Set the global registry
- */
-declare function setGlobalRegistry(registry: NativeUIBridgeRegistry): void;
-/**
- * Get the global registry
- */
-declare function getGlobalRegistry(): NativeUIBridgeRegistry | null;
-/**
- * Reset the global registry
- */
-declare function resetGlobalRegistry(): void;
-
-export { type NativeRegistryConfig as N, type RegisterComponentOptions as R, NativeUIBridgeRegistry as a, type RegisterElementOptions as b, extractHandlerNames as e, getGlobalRegistry as g, resetGlobalRegistry as r, setGlobalRegistry as s };

package/dist/server/index.d.mts

@@ -1,119 +0,0 @@
-import { h as NativeServerHandlers, b as HandlerContext, A as APIResponse } from '../http-server-D7uVANBU.mjs';
-export { H as HTTPRequest, a as HTTPResponse, c as HandlerFunction, J as JsonRpcBatchRequest, d as JsonRpcBatchResponse, r as JsonRpcClientMessage, e as JsonRpcEvent, f as JsonRpcRequest, g as JsonRpcResponse, s as JsonRpcServerMessage, t as JsonRpcSubscribe, u as JsonRpcUnsubscribe, N as NativeServerConfig, i as NativeUIBridgeServer, j as NavigationProvider, R as RequestHandler, k as RouteDefinition, l as RouteProvider, S as ScreenshotProvider, m as ServerAdapter, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, n as WebSocketEventBridge, o as WebSocketMessageHandler, p as WebSocketServerAdapter, q as createNativeServer, v as isBatchRequest, w as isSubscribe, x as isUnsubscribe } from '../http-server-D7uVANBU.mjs';
-import { a as NativeUIBridgeRegistry } from '../registry-DhbGbl9c.mjs';
-import { N as NativeActionExecutor } from '../types-Bcj7ji97.mjs';
-import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.mjs';
-import '../types-BPNuYxDx.mjs';
-
-/**
- * UI Bridge Native Server Handlers
- *
- * Request handlers for the HTTP API endpoints.
- */
-
-/**
- * Create server handlers
- */
-declare function createServerHandlers(registry: NativeUIBridgeRegistry, executor: NativeActionExecutor, config?: {
-    appInfo?: {
-        appId: string;
-        appName: string;
-        appType: string;
-        framework?: string;
-    };
-}): NativeServerHandlers;
-
-/**
- * Pure-JS RFC 6455 WebSocket protocol implementation.
- *
- * Provides frame encoding/decoding and handshake utilities for running
- * a WebSocket server on react-native-tcp-socket without native crypto deps.
- */
-declare const OPCODE_CONTINUATION = 0;
-declare const OPCODE_TEXT = 1;
-declare const OPCODE_BINARY = 2;
-declare const OPCODE_CLOSE = 8;
-declare const OPCODE_PING = 9;
-declare const OPCODE_PONG = 10;
-interface DecodedFrame {
-    opcode: number;
-    fin: boolean;
-    payload: Uint8Array;
-    masked: boolean;
-}
-interface DecodeResult {
-    frames: DecodedFrame[];
-    remainder: Uint8Array<any>;
-}
-/**
- * Compute the Sec-WebSocket-Accept value from the client's Sec-WebSocket-Key.
- */
-declare function computeAcceptKey(clientKey: string): string;
-/**
- * Build the HTTP 101 Switching Protocols response for a WebSocket upgrade.
- */
-declare function buildUpgradeResponse(clientKey: string): string;
-/** Encode a text message as a WebSocket frame. */
-declare function encodeTextFrame(text: string): Uint8Array;
-/** Encode a PING frame with optional payload. */
-declare function encodePingFrame(payload?: Uint8Array): Uint8Array;
-/** Encode a PONG frame with the payload from the PING. */
-declare function encodePongFrame(payload: Uint8Array): Uint8Array;
-/** Encode a CLOSE frame with optional status code and reason. */
-declare function encodeCloseFrame(code?: number, reason?: string): Uint8Array;
-/**
- * Decode one or more WebSocket frames from a byte buffer.
- * Returns decoded frames and any unconsumed bytes (for partial frames).
- */
-declare function decodeFrames(buffer: Uint8Array): DecodeResult;
-/**
- * Decode a text payload from a Uint8Array.
- */
-declare function decodeTextPayload(payload: Uint8Array): string;
-
-/**
- * UI Bridge Native Design Review Handlers
- *
- * HTTP handlers for the 8 design review endpoints.
- * Maps registered element styles to the web SDK's design data format.
- */
-
-/**
- * Design handler interface (subset of NativeServerHandlers)
- */
-interface NativeDesignHandlers {
-    getElementStyles: (ctx: HandlerContext) => Promise<APIResponse<ElementDesignData>>;
-    getElementStateStyles: (ctx: HandlerContext) => Promise<APIResponse<{
-        elementId: string;
-        stateStyles: StateStyles[];
-    }>>;
-    getDesignSnapshot: (ctx: HandlerContext) => Promise<APIResponse<{
-        elements: ElementDesignData[];
-        timestamp: number;
-    }>>;
-    getResponsiveSnapshots: (ctx: HandlerContext) => Promise<APIResponse<ResponsiveSnapshot[]>>;
-    runDesignAudit: (ctx: HandlerContext) => Promise<APIResponse<unknown>>;
-    loadStyleGuide: (ctx: HandlerContext) => Promise<APIResponse<{
-        loaded: boolean;
-    }>>;
-    getStyleGuide: (ctx: HandlerContext) => Promise<APIResponse<unknown>>;
-    clearStyleGuide: (ctx: HandlerContext) => Promise<APIResponse<{
-        cleared: boolean;
-    }>>;
-    evaluateQuality: (ctx: HandlerContext) => Promise<APIResponse<unknown>>;
-    getQualityContexts: (ctx: HandlerContext) => Promise<APIResponse<Array<{
-        name: string;
-        description: string;
-    }>>>;
-    saveBaseline: (ctx: HandlerContext) => Promise<APIResponse<{
-        saved: boolean;
-        elementCount: number;
-    }>>;
-    diffBaseline: (ctx: HandlerContext) => Promise<APIResponse<unknown>>;
-}
-/**
- * Create design review handlers.
- */
-declare function createDesignHandlers(registry: NativeUIBridgeRegistry): NativeDesignHandlers;
-
-export { APIResponse, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };