@qontinui/ui-bridge-native 0.3.1 → 0.4.0

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 NativeCapturedToast, g as NativeComponentAction, h as NativeCustomAction, i as NativeElementIdentifier, j as NativeElementRef, k as NativeElementState, l as NativeElementType, m as NativeFindRequest, n as NativeFindResponse, o as NativeLayout, p as NativeModalInfo, q as NativeRegistrationCoverage, r as NativeSnapshotEnricher, s as NativeSnapshotEnrichers, t as NativeSnapshotModalContext, u as NativeSnapshotToastContext, v as NativeSnapshotUndoContext, w as NativeStandardAction, x as NativeUIBridgeConfig, y as NativeUIBridgeFeatures, R as RegisteredNativeComponent, z as RegisteredNativeElement, W as WaitOptions, E as Workflow, F as WorkflowStep, G as WorkflowStepType } from './types-CGVut7mc.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-B5JadBN9.mjs';
-export { buildTreePath, createNativeElementIdentifier, findAllByPattern, findElementByIdentifier, matchesIdentifier, parseTreePath } from './core/index.mjs';
-export { A as ActionRecord, C as CloudRelayClient, a as CloudRelayConfig, b as ComponentActionDef, c as ComponentActionRequest, d as ComponentActionResponse, D as DeclaredUndoState, M as ModalDetector, e as ModalPushInput, S as State, f as StateAnnotationRequiredElement, g as StateProps, T as ToastCapture, h as ToastCaptureConfig, i as ToastRecordInput, j as ToastRecorderInput, k as TransitionTo, l as TransitionToProps, U as UIBridgeNativeContextValue, m as UIBridgeNativeProvider, n as UIBridgeNativeProviderProps, o as UIBridgeProps, p as UndoTracker, q as UndoTrackerConfig, 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-BgFoVWFy.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-B0XA4vOF.mjs';
-export { DefaultNativeActionExecutor, createNativeActionExecutor } from './control/index.mjs';
-export { A as APIResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, e as HandlerContext, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, N as NativeServerConfig, k as NativeServerHandlers, l as NativeUIBridgeServer, m as NavigationProvider, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer } from './http-server--550eD1F.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-B5JadBN9.d.mts

@@ -1,300 +0,0 @@
-import { a as BridgeEventListener, H as NativeAppInfo, I as NativeRouteProviderLike, s as NativeSnapshotEnrichers, r as NativeSnapshotEnricher, j as NativeElementRef, l as NativeElementType, w as NativeStandardAction, h as NativeCustomAction, z as RegisteredNativeElement, k as NativeElementState, R as RegisteredNativeComponent, E as Workflow, b as BridgeEventType, e as NativeBridgeSnapshot, q as NativeRegistrationCoverage } from './types-CGVut7mc.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;
-    private enrichers;
-    private snapshotExtras;
-    /**
-     * App identification metadata (appId/appName/appType/framework). Set via
-     * `setAppInfo` — typically wired in the server constructor from the
-     * `NativeUIBridgeConfig` the host passes to `UIBridgeNativeProvider`.
-     *
-     * When set, `createSnapshot` includes it on the resulting snapshot so
-     * agents can identify the app from snapshot bytes alone (parity with the
-     * `uiBridge` block on the `health` response). Snapshots created before
-     * this is wired simply omit the field.
-     */
-    private appInfo;
-    /**
-     * Optional route provider. When set, `createSnapshot` reads
-     * `currentRoute`/`segments` from it whenever the caller does not pass an
-     * explicit `routeInfo` argument. This lets the default `getSnapshot` HTTP
-     * handler — which has no direct reference to the `NativeUIBridgeServer`
-     * instance — still emit a populated `currentRoute` field.
-     *
-     * Wired by `NativeUIBridgeServer.setRouteProvider`, which forwards the
-     * provider into the registry alongside the per-handler overrides it
-     * already installs.
-     */
-    private routeProvider;
-    /**
-     * Sticky flag: flips `true` the first time any element is registered and
-     * stays `true` even after elements are unregistered. Lets agents distinguish
-     * "this route never wired any elements" from "this route registered then
-     * unmounted".
-     */
-    private everHadRegistrations;
-    constructor(config?: NativeRegistryConfig);
-    /**
-     * Set the app identification metadata returned alongside snapshots.
-     * Idempotent — re-calling with the same shape is a no-op.
-     * Pass `null` (or omit a previous call) to clear.
-     */
-    setAppInfo(info: NativeAppInfo | null | undefined): void;
-    /** Read-only accessor for the registered app info, if any. */
-    getAppInfo(): NativeAppInfo | null;
-    /**
-     * Set a route provider whose `getCurrentRoute`/`getSegments` are read by
-     * `createSnapshot` when no explicit `routeInfo` argument is supplied.
-     *
-     * Call with `null` to detach (e.g. when the host swaps providers on HMR).
-     */
-    setRouteProvider(provider: NativeRouteProviderLike | null | undefined): void;
-    /** Read-only accessor for the registered route provider, if any. */
-    getRouteProvider(): NativeRouteProviderLike | null;
-    /**
-     * Register/replace canonical enrichers (modal/toast/undo). HMR-safe — calling
-     * with a partial set merges into existing slots instead of clobbering them.
-     */
-    setEnrichers(e: Partial<NativeSnapshotEnrichers>): void;
-    /**
-     * Read-only accessor for the canonical enrichers slot. Returned object is
-     * the live reference, so callers can detect "no detector wired" via
-     * `getEnrichers().modalDetector === undefined`. Used by the test-hook HTTP
-     * handlers (`control/modal/push`, `control/modal/dismiss/:id`) which need
-     * to drive the ModalDetector directly without re-instantiating it.
-     */
-    getEnrichers(): Readonly<NativeSnapshotEnrichers>;
-    /**
-     * Register a custom snapshot enricher. The returned object will be
-     * `Object.assign`ed onto the snapshot, so use unique top-level keys to avoid
-     * clobbering canonical fields. Returns a disposer.
-     */
-    registerSnapshotEnricher(name: string, fn: NativeSnapshotEnricher): () => void;
-    /** Remove a custom snapshot enricher by name */
-    unregisterSnapshotEnricher(name: string): void;
-    /**
-     * 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.
-     *
-     * Route resolution: `routeInfo` wins when provided. Otherwise — and this
-     * is the path the default `getSnapshot` HTTP handler takes — we fall back
-     * to the registered `routeProvider`. This means callers that never wire a
-     * server-level override (the bare-server / cloud-relay path) still get a
-     * populated `currentRoute` field as long as `setRouteProvider` was called
-     * on the registry.
-     */
-    createSnapshot(routeInfo?: {
-        currentRoute?: string | null;
-        segments?: string[];
-    }, options?: {
-        visibleOnly?: boolean;
-        currentRouteOnly?: boolean;
-    }): NativeBridgeSnapshot;
-    /**
-     * Get registry statistics
-     */
-    getStats(): {
-        elements: number;
-        components: number;
-        workflows: number;
-    };
-    /**
-     * Compute registration coverage metadata for the current registry state.
-     *
-     * Groups currently-registered elements by `registrationRoute`, bucketing
-     * elements without a route under `'?'`. `everHadRegistrations` is sticky —
-     * once true, it stays true for the lifetime of the registry instance.
-     */
-    getRegistrationCoverage(): NativeRegistrationCoverage;
-    /**
-     * 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,178 +0,0 @@
-import { C as ConsoleErrorEntry, u as NetworkRequestEntry, k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server--550eD1F.mjs';
-export { v as ConsoleErrorsResponse, D as DismissModalResponse, F as FillFormFieldInput, a as FillFormFieldResult, b as FillFormRequest, c as FillFormResponse, H as HTTPRequest, d as HTTPResponse, f as HandlerFunction, J as JsonRpcBatchRequest, g as JsonRpcBatchResponse, w as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, x as JsonRpcServerMessage, y as JsonRpcSubscribe, z as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, B as NetworkRequestsResponse, P as PushModalRequest, E as PushModalResponse, R as RequestHandler, n as RouteDefinition, o as RouteProvider, S as ScreenshotProvider, p as ServerAdapter, T as TapAtRequest, G as TapAtResponse, U as UI_BRIDGE_NATIVE_ROUTES, W as WebSocketConnection, q as WebSocketEventBridge, r as WebSocketMessageHandler, s as WebSocketServerAdapter, t as createNativeServer, I as isBatchRequest, K as isSubscribe, L as isUnsubscribe } from '../http-server--550eD1F.mjs';
-import { a as NativeUIBridgeRegistry } from '../registry-B5JadBN9.mjs';
-import { N as NativeActionExecutor } from '../types-B0XA4vOF.mjs';
-import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.mjs';
-import '../types-CGVut7mc.mjs';
-
-/**
- * UI Bridge Native — observability ring buffers.
- *
- * Two small last-N buffers backing the `/control/console-errors` and
- * `/sdk/network-requests` endpoints. Each buffer monkey-patches the relevant
- * global on `install()` and restores the original on `uninstall()`, so they
- * can be installed/torn-down with the server's lifecycle.
- *
- * Both buffers are gated behind `features.testHooks` by the caller (see
- * NativeUIBridgeServer). Production builds default to `testHooks: false`,
- * so these patches never run on real users' devices.
- *
- * Implementation notes:
- *   - Buffers default to capacity 100 entries and drop oldest on overflow.
- *   - Patches are idempotent: `install()` is a no-op when already installed;
- *     `uninstall()` is a no-op when not installed.
- *   - Patches only restore the *original* function captured at install time;
- *     if other code wraps `console.error` / `fetch` between install and
- *     uninstall, those wrappers will be lost. Acceptable for test hooks.
- */
-
-declare class ConsoleErrorBuffer {
-    private buffer;
-    private installed;
-    private originalError?;
-    private originalWarn?;
-    constructor(capacity?: number);
-    install(): void;
-    uninstall(): void;
-    entries(opts?: {
-        since?: number;
-        limit?: number;
-    }): ConsoleErrorEntry[];
-    size(): number;
-    clear(): void;
-    isInstalled(): boolean;
-}
-declare class NetworkRequestBuffer {
-    private buffer;
-    private installed;
-    private originalFetch?;
-    private originalXhrOpen?;
-    private originalXhrSend?;
-    constructor(capacity?: number);
-    install(): void;
-    uninstall(): void;
-    entries(opts?: {
-        since?: number;
-        limit?: number;
-    }): NetworkRequestEntry[];
-    size(): number;
-    clear(): void;
-    isInstalled(): boolean;
-}
-
-/**
- * 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;
-    };
-    /** Optional console-error ring buffer powering `GET /control/console-errors`. */
-    consoleErrorBuffer?: ConsoleErrorBuffer;
-    /** Optional network-request ring buffer powering `GET /sdk/network-requests`. */
-    networkRequestBuffer?: NetworkRequestBuffer;
-}): 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, ConsoleErrorBuffer, ConsoleErrorEntry, type DecodeResult, type DecodedFrame, HandlerContext, type NativeDesignHandlers, NativeServerHandlers, NetworkRequestBuffer, NetworkRequestEntry, OPCODE_BINARY, OPCODE_CLOSE, OPCODE_CONTINUATION, OPCODE_PING, OPCODE_PONG, OPCODE_TEXT, buildUpgradeResponse, computeAcceptKey, createDesignHandlers, createServerHandlers, decodeFrames, decodeTextPayload, encodeCloseFrame, encodePingFrame, encodePongFrame, encodeTextFrame };