@qontinui/ui-bridge-native 0.1.6 → 0.2.1

package/dist/{core/registry.d.ts → registry-BxXaxmsT.d.ts}

@@ -1,14 +1,16 @@
+import { a as BridgeEventListener, 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-BwdPNpII.js';
+
 /**
  * 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.
  */
-import type { RegisteredNativeElement, RegisteredNativeComponent, NativeElementState, NativeElementType, NativeStandardAction, NativeCustomAction, NativeBridgeSnapshot, NativeElementRef, Workflow, BridgeEventType, BridgeEventListener } from './types';
+
 /**
  * Options for registering an element
  */
-export interface RegisterElementOptions {
+interface RegisterElementOptions {
     type?: NativeElementType;
     label?: string;
     actions?: NativeStandardAction[];
@@ -31,7 +33,7 @@ export interface RegisterElementOptions {
 /**
  * Options for registering a component
  */
-export interface RegisterComponentOptions {
+interface RegisterComponentOptions {
     name: string;
     description?: string;
     actions?: Array<{
@@ -45,7 +47,7 @@ export interface RegisterComponentOptions {
 /**
  * Registry configuration
  */
-export interface NativeRegistryConfig {
+interface NativeRegistryConfig {
     verbose?: boolean;
     onEvent?: BridgeEventListener;
 }
@@ -53,19 +55,49 @@ export interface NativeRegistryConfig {
  * Extract handler function names from an element's props.
  * Returns names of props whose values are functions (e.g. ['onPress', 'onChangeText']).
  */
-export declare function extractHandlerNames(props?: Record<string, unknown>): string[];
+declare function extractHandlerNames(props?: Record<string, unknown>): string[];
 /**
  * Native UI Bridge Registry
  *
  * Manages registration and lookup of native UI elements and components.
  */
-export declare class NativeUIBridgeRegistry {
+declare class NativeUIBridgeRegistry {
     private elements;
     private components;
     private workflows;
     private eventListeners;
     private config;
+    private enrichers;
+    private snapshotExtras;
+    /**
+     * 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);
+    /**
+     * 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
      */
@@ -192,6 +224,14 @@ export declare class NativeUIBridgeRegistry {
         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
      */
@@ -200,13 +240,14 @@ export declare class NativeUIBridgeRegistry {
 /**
  * Set the global registry
  */
-export declare function setGlobalRegistry(registry: NativeUIBridgeRegistry): void;
+declare function setGlobalRegistry(registry: NativeUIBridgeRegistry): void;
 /**
  * Get the global registry
  */
-export declare function getGlobalRegistry(): NativeUIBridgeRegistry | null;
+declare function getGlobalRegistry(): NativeUIBridgeRegistry | null;
 /**
  * Reset the global registry
  */
-export declare function resetGlobalRegistry(): void;
-//# sourceMappingURL=registry.d.ts.map
+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/registry-KdUW_koV.d.mts

@@ -0,0 +1,253 @@
+import { a as BridgeEventListener, 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-BwdPNpII.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;
+    /**
+     * 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);
+    /**
+     * 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
+     */
+    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

@@ -0,0 +1,119 @@
+import { k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server-D2U1k48d.mjs';
+export { 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, u as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, v as JsonRpcServerMessage, w as JsonRpcSubscribe, x as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, P as PushModalRequest, y as PushModalResponse, 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, z as isBatchRequest, B as isSubscribe, C as isUnsubscribe } from '../http-server-D2U1k48d.mjs';
+import { a as NativeUIBridgeRegistry } from '../registry-KdUW_koV.mjs';
+import { N as NativeActionExecutor } from '../types-DjB0zJJH.mjs';
+import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.mjs';
+import '../types-BwdPNpII.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 };

package/dist/server/index.d.ts

@@ -1,15 +1,119 @@
+import { k as NativeServerHandlers, e as HandlerContext, A as APIResponse } from '../http-server-ck8clUsZ.js';
+export { 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, u as JsonRpcClientMessage, h as JsonRpcEvent, i as JsonRpcRequest, j as JsonRpcResponse, v as JsonRpcServerMessage, w as JsonRpcSubscribe, x as JsonRpcUnsubscribe, N as NativeServerConfig, l as NativeUIBridgeServer, m as NavigationProvider, P as PushModalRequest, y as PushModalResponse, 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, z as isBatchRequest, B as isSubscribe, C as isUnsubscribe } from '../http-server-ck8clUsZ.js';
+import { a as NativeUIBridgeRegistry } from '../registry-BxXaxmsT.js';
+import { N as NativeActionExecutor } from '../types-DCEv5qb6.js';
+import { E as ElementDesignData, S as StateStyles, R as ResponsiveSnapshot } from '../design-types-BHr6Q1FX.js';
+import '../types-BwdPNpII.js';
+
 /**
- * UI Bridge Native - Server
+ * UI Bridge Native Server Handlers
  *
- * HTTP and WebSocket server for external control of native apps.
- */
-export * from './types';
-export * from './handlers';
-export * from './design-handlers';
-export * from './http-server';
-export * from './ws-protocol';
-export * from './ws-types';
-export { WebSocketConnection } from './ws-connection';
-export type { WebSocketMessageHandler } from './ws-connection';
-export { WebSocketEventBridge } from './ws-event-bridge';
-//# sourceMappingURL=index.d.ts.map
+ * 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 };