@qontinui/ui-bridge-native 0.1.5 → 0.1.6

package/dist/types-BPNuYxDx.d.mts

@@ -1,383 +0,0 @@
-/**
- * UI Bridge Native Core Types
- *
- * Defines the fundamental types used throughout the UI Bridge Native framework.
- * Adapted from ui-bridge for React Native environments.
- */
-type AnyNativeElement = any;
-interface WaitOptions {
-    /** Wait for element to be visible */
-    visible?: boolean;
-    /** Wait for element to be enabled */
-    enabled?: boolean;
-    /** Wait for element to have focus */
-    focused?: boolean;
-    /** Wait for element state to match */
-    state?: Record<string, unknown>;
-    /** Timeout in milliseconds */
-    timeout?: number;
-    /** Polling interval in milliseconds */
-    interval?: number;
-}
-type ActionHandler<TParams = unknown, TResult = unknown> = (params?: TParams) => TResult | Promise<TResult>;
-interface CustomAction<TParams = unknown, TResult = unknown> {
-    id: string;
-    label?: string;
-    description?: string;
-    handler: ActionHandler<TParams, TResult>;
-}
-interface ComponentAction<TParams = unknown, TResult = unknown> {
-    id: string;
-    label?: string;
-    description?: string;
-    paramSchema?: Record<string, unknown>;
-    handler: ActionHandler<TParams, TResult>;
-}
-type WorkflowStepType = 'element-action' | 'component-action' | 'wait' | 'assert' | 'navigate' | 'branch' | 'loop' | 'extract' | 'log' | 'custom';
-interface WorkflowStep {
-    id: string;
-    type: WorkflowStepType;
-    target?: string;
-    action?: string;
-    params?: Record<string, unknown>;
-    waitOptions?: WaitOptions;
-    handler?: () => unknown | Promise<unknown>;
-}
-interface Workflow {
-    id: string;
-    name: string;
-    description?: string;
-    steps: WorkflowStep[];
-    defaultParams?: Record<string, unknown>;
-}
-type BridgeEventType = 'element:registered' | 'element:unregistered' | 'element:stateChanged' | 'component:registered' | 'component:unregistered' | 'action:started' | 'action:completed' | 'action:failed' | 'workflow:started' | 'workflow:stepCompleted' | 'workflow:completed' | 'workflow:failed' | 'render:snapshot' | 'error';
-interface BridgeEvent<T = unknown> {
-    type: BridgeEventType;
-    timestamp: number;
-    data: T;
-}
-type BridgeEventListener<T = unknown> = (event: BridgeEvent<T>) => void;
-/**
- * React Native element reference type.
- * Uses a generic type to avoid conflicts between different react-native versions.
- */
-type NativeElementRef = AnyNativeElement | null;
-/**
- * Element identification for React Native (replaces XPath/CSS selectors)
- */
-interface NativeElementIdentifier {
-    /** Explicit UI Bridge identifier */
-    uiId?: string;
-    /** React Native testID prop */
-    testId?: string;
-    /** Accessibility label */
-    accessibilityLabel?: string;
-    /** Accessibility hint */
-    accessibilityHint?: string;
-    /** Tree path for element (e.g., "App/HomeScreen/Button[0]") */
-    treePath: string;
-    /** Native handle (platform-specific) */
-    nativeHandle?: number;
-}
-/**
- * Layout information from onLayout callback
- */
-interface NativeLayout {
-    /** X position relative to parent */
-    x: number;
-    /** Y position relative to parent */
-    y: number;
-    /** Element width */
-    width: number;
-    /** Element height */
-    height: number;
-    /** Absolute X position on screen (from measureInWindow) */
-    pageX: number;
-    /** Absolute Y position on screen (from measureInWindow) */
-    pageY: number;
-}
-/**
- * Current state of a native UI element
- */
-interface NativeElementState {
-    /** Whether the element is mounted in the tree */
-    mounted: boolean;
-    /** Whether the element is visible on screen */
-    visible: boolean;
-    /** Whether the element is enabled (not disabled) */
-    enabled: boolean;
-    /** Whether the element has focus */
-    focused: boolean;
-    /** Layout information */
-    layout: NativeLayout | null;
-    /** Current value for text inputs */
-    value?: string;
-    /** Selected state for toggles/checkboxes */
-    selected?: boolean;
-    /** Checked state for checkboxes/radios */
-    checked?: boolean;
-    /** Text content of the element */
-    textContent?: string;
-    /** Additional accessibility state */
-    accessibilityState?: {
-        disabled?: boolean;
-        selected?: boolean;
-        checked?: boolean | 'mixed';
-        busy?: boolean;
-        expanded?: boolean;
-    };
-}
-/**
- * Types of native UI elements that can be registered
- */
-type NativeElementType = 'button' | 'input' | 'text' | 'view' | 'scroll' | 'list' | 'listItem' | 'switch' | 'checkbox' | 'radio' | 'image' | 'touchable' | 'pressable' | 'modal' | 'custom';
-/**
- * Standard actions available on native elements
- */
-type NativeStandardAction = 'press' | 'click' | 'longPress' | 'doubleTap' | 'type' | 'clear' | 'focus' | 'blur' | 'scroll' | 'swipe' | 'toggle';
-/**
- * Custom action definition for native elements
- */
-interface NativeCustomAction<TParams = unknown, TResult = unknown> {
-    /** Action identifier */
-    id: string;
-    /** Human-readable label */
-    label?: string;
-    /** Description of what the action does */
-    description?: string;
-    /** Action handler function */
-    handler: (params?: TParams) => TResult | Promise<TResult>;
-}
-/**
- * A native UI element registered with the bridge
- */
-interface RegisteredNativeElement {
-    /** Unique identifier for this element */
-    id: string;
-    /** Reference to the native element */
-    ref: React.RefObject<NativeElementRef>;
-    /** Type of UI element */
-    type: NativeElementType;
-    /** Human-readable label */
-    label?: string;
-    /** Available standard actions for this element */
-    actions: NativeStandardAction[];
-    /** Custom actions specific to this element */
-    customActions?: Record<string, NativeCustomAction>;
-    /** Props passed to the element (for action execution) */
-    props?: Record<string, unknown>;
-    /** Function to get the current state */
-    getState: () => NativeElementState;
-    /** Function to get the element identifier */
-    getIdentifier: () => NativeElementIdentifier;
-    /** Timestamp when the element was registered */
-    registeredAt: number;
-    /** Whether this element is currently mounted */
-    mounted: boolean;
-    /** Route path where this element was registered (for page-scoped filtering) */
-    registrationRoute?: string | null;
-    /** Flattened RN style for design review */
-    flatStyle?: Record<string, unknown>;
-    /** State-specific style overrides (pressed, focused, disabled) */
-    stateStyles?: {
-        pressed?: Record<string, unknown>;
-        focused?: Record<string, unknown>;
-        disabled?: Record<string, unknown>;
-    };
-}
-/**
- * Component action definition for native components
- */
-interface NativeComponentAction<TParams = unknown, TResult = unknown> {
-    /** Action identifier */
-    id: string;
-    /** Human-readable label */
-    label?: string;
-    /** Description of what the action does */
-    description?: string;
-    /** Parameter schema (for documentation/validation) */
-    paramSchema?: Record<string, unknown>;
-    /** Action handler function */
-    handler: (params?: TParams) => TResult | Promise<TResult>;
-}
-/**
- * A native component registered with the bridge (higher-level than elements)
- */
-interface RegisteredNativeComponent {
-    /** Unique identifier for this component */
-    id: string;
-    /** Human-readable name */
-    name: string;
-    /** Description of the component's purpose */
-    description?: string;
-    /** Available actions on this component */
-    actions: NativeComponentAction[];
-    /** Child element IDs owned by this component */
-    elementIds?: string[];
-    /** Timestamp when the component was registered */
-    registeredAt: number;
-    /** Whether this component is currently mounted */
-    mounted: boolean;
-}
-/**
- * Action request for native elements
- */
-interface NativeActionRequest {
-    /** Action to execute */
-    action: NativeStandardAction | string;
-    /** Action parameters */
-    params?: {
-        /** Text to type */
-        text?: string;
-        /** Scroll offset */
-        offset?: {
-            x: number;
-            y: number;
-        };
-        /** Swipe direction */
-        direction?: 'up' | 'down' | 'left' | 'right';
-        /** Duration in milliseconds */
-        duration?: number;
-        /** Additional custom parameters */
-        [key: string]: unknown;
-    };
-    /** Wait options before executing */
-    waitOptions?: WaitOptions;
-}
-/**
- * Response from a native action execution
- */
-interface NativeActionResponse {
-    /** Whether the action succeeded */
-    success: boolean;
-    /** Element state after the action */
-    elementState?: NativeElementState;
-    /** Result of the action (for custom actions) */
-    result?: unknown;
-    /** Error message if failed */
-    error?: string;
-    /** Stack trace if failed */
-    stack?: string;
-    /** Duration of the action in milliseconds */
-    durationMs: number;
-    /** Timestamp when the action completed */
-    timestamp: number;
-    /** Request ID for correlation */
-    requestId?: string;
-    /** Time spent waiting for conditions */
-    waitDurationMs?: number;
-}
-/**
- * Snapshot of the entire native UI bridge state
- */
-interface NativeBridgeSnapshot {
-    /** Timestamp of the snapshot */
-    timestamp: number;
-    /** All registered elements */
-    elements: Array<{
-        id: string;
-        type: NativeElementType;
-        label?: string;
-        identifier: NativeElementIdentifier;
-        state: NativeElementState;
-        actions: NativeStandardAction[];
-        customActions?: string[];
-        /** Handler names actually registered via updateElementProps (e.g. ['onPress', 'onChangeText']) */
-        registeredHandlers?: string[];
-        /** Route path where this element was registered (for page-scoped filtering) */
-        registrationRoute?: string | null;
-    }>;
-    /** All registered components */
-    components: Array<{
-        id: string;
-        name: string;
-        description?: string;
-        actions: string[];
-        elementIds?: string[];
-    }>;
-    /** Available workflows */
-    workflows: Array<{
-        id: string;
-        name: string;
-        description?: string;
-        stepCount: number;
-    }>;
-    /** Current navigation route path (if a RouteProvider is configured) */
-    currentRoute?: string | null;
-    /** Current route segments (if a RouteProvider is configured) */
-    segments?: string[];
-}
-/**
- * UI Bridge Native feature flags
- */
-interface NativeUIBridgeFeatures {
-    /** Enable HTTP control server */
-    server?: boolean;
-    /** Enable debug tools (inspector overlay) */
-    debug?: boolean;
-}
-/**
- * UI Bridge Native configuration
- */
-interface NativeUIBridgeConfig {
-    /** Port for HTTP server */
-    serverPort?: number;
-    /** Enable verbose logging */
-    verbose?: boolean;
-    /** Path prefix for parent components (for treePath generation) */
-    parentPath?: string;
-    /** Application info for discovery */
-    appInfo?: {
-        appId: string;
-        appName: string;
-        appType: 'web' | 'desktop' | 'mobile' | 'other';
-        framework?: string;
-    };
-}
-/**
- * Find request for discovering native elements
- */
-interface NativeFindRequest {
-    /** Filter by element type */
-    types?: NativeElementType[];
-    /** Filter by testID pattern (supports wildcards) */
-    testIdPattern?: string;
-    /** Filter by accessibility label pattern */
-    accessibilityLabelPattern?: string;
-    /** Include only visible elements */
-    visibleOnly?: boolean;
-    /** Maximum number of results */
-    limit?: number;
-}
-/**
- * Discovered native element
- */
-interface DiscoveredNativeElement {
-    /** Element ID */
-    id: string;
-    /** Element type */
-    type: NativeElementType;
-    /** Element identifier */
-    identifier: NativeElementIdentifier;
-    /** Current state */
-    state: NativeElementState;
-    /** Available actions */
-    actions: NativeStandardAction[];
-    /** Label */
-    label?: string;
-}
-/**
- * Find response
- */
-interface NativeFindResponse {
-    /** Discovered elements */
-    elements: DiscoveredNativeElement[];
-    /** Total count */
-    total: number;
-    /** Duration in milliseconds */
-    durationMs: number;
-    /** Timestamp */
-    timestamp: number;
-}
-
-export type { ActionHandler as A, BridgeEvent as B, ComponentAction as C, DiscoveredNativeElement as D, NativeActionRequest as N, RegisteredNativeComponent as R, WaitOptions as W, BridgeEventListener as a, BridgeEventType as b, CustomAction as c, NativeActionResponse as d, NativeBridgeSnapshot as e, NativeComponentAction as f, NativeCustomAction as g, NativeElementIdentifier as h, NativeElementRef as i, NativeElementState as j, NativeElementType as k, NativeFindRequest as l, NativeFindResponse as m, NativeLayout as n, NativeStandardAction as o, NativeUIBridgeConfig as p, NativeUIBridgeFeatures as q, RegisteredNativeElement as r, Workflow as s, WorkflowStep as t, WorkflowStepType as u };

package/dist/types-Bcj7ji97.d.mts

@@ -1,177 +0,0 @@
-import { W as WaitOptions, N as NativeActionRequest, d as NativeActionResponse, l as NativeFindRequest, m as NativeFindResponse, j as NativeElementState } from './types-BPNuYxDx.mjs';
-
-/**
- * UI Bridge Native Control Types
- *
- * Types for action execution and control operations.
- */
-
-/**
- * Extended action request with control-specific options
- */
-interface ControlActionRequest extends NativeActionRequest {
-    /** Request ID for correlation */
-    requestId?: string;
-    /** Capture snapshot after action */
-    captureAfter?: boolean;
-    /** Retry options */
-    retryOptions?: {
-        maxRetries?: number;
-        retryDelay?: number;
-    };
-}
-/**
- * Extended action response with control-specific data
- */
-interface ControlActionResponse extends NativeActionResponse {
-    /** Request ID for correlation */
-    requestId?: string;
-    /** Retry count */
-    retryCount?: number;
-}
-/**
- * Component action request
- */
-interface ComponentActionRequest {
-    /** Action to execute */
-    action: string;
-    /** Action parameters */
-    params?: Record<string, unknown>;
-    /** Request ID for correlation */
-    requestId?: string;
-}
-/**
- * Component action response
- */
-interface ComponentActionResponse {
-    /** Whether the action succeeded */
-    success: boolean;
-    /** Result of the action */
-    result?: unknown;
-    /** Error message if failed */
-    error?: string;
-    /** Stack trace if failed */
-    stack?: string;
-    /** Duration in milliseconds */
-    durationMs: number;
-    /** Timestamp */
-    timestamp: number;
-    /** Request ID for correlation */
-    requestId?: string;
-}
-/**
- * Wait result
- */
-interface WaitResult {
-    /** Whether conditions were met */
-    met: boolean;
-    /** Time spent waiting in milliseconds */
-    waitedMs: number;
-    /** Final element state */
-    state?: NativeElementState;
-    /** Error message if failed */
-    error?: string;
-}
-/**
- * Native action executor interface
- */
-interface NativeActionExecutor {
-    /**
-     * Execute an action on an element
-     */
-    executeAction(elementId: string, request: ControlActionRequest): Promise<ControlActionResponse>;
-    /**
-     * Execute a component action
-     */
-    executeComponentAction(componentId: string, request: ComponentActionRequest): Promise<ComponentActionResponse>;
-    /**
-     * Find elements
-     */
-    find(request: NativeFindRequest): Promise<NativeFindResponse>;
-    /**
-     * Wait for element conditions
-     */
-    waitForElement(elementId: string, options: WaitOptions): Promise<WaitResult>;
-}
-/**
- * Page navigation request
- */
-interface PageNavigateRequest {
-    /** URL to navigate to */
-    url: string;
-}
-/**
- * Page navigation response
- */
-interface PageNavigationResponse {
-    /** Whether the navigation succeeded */
-    success: boolean;
-    /** Current URL after navigation */
-    url?: string;
-    /** Timestamp */
-    timestamp: number;
-}
-/**
- * Action execution options
- */
-interface ActionExecutionOptions {
-    /** Timeout in milliseconds */
-    timeout?: number;
-    /** Whether to wait for element to be ready */
-    waitForReady?: boolean;
-    /** Custom wait conditions */
-    waitOptions?: WaitOptions;
-}
-/**
- * Type action params
- */
-interface TypeActionParams {
-    /** Text to type */
-    text: string;
-    /** Typing delay between characters (ms) */
-    delay?: number;
-    /** Clear existing text first */
-    clearFirst?: boolean;
-}
-/**
- * Scroll action params
- */
-interface ScrollActionParams {
-    /** Scroll offset */
-    offset?: {
-        x: number;
-        y: number;
-    };
-    /** Scroll to specific position */
-    position?: {
-        x: number;
-        y: number;
-    };
-    /** Animate the scroll */
-    animated?: boolean;
-}
-/**
- * Swipe action params
- */
-interface SwipeActionParams {
-    /** Swipe direction */
-    direction: 'up' | 'down' | 'left' | 'right';
-    /** Swipe distance (in points) */
-    distance?: number;
-    /** Swipe duration (ms) */
-    duration?: number;
-}
-/**
- * Press action params
- */
-interface PressActionParams {
-    /** Position relative to element */
-    position?: {
-        x: number;
-        y: number;
-    };
-    /** Press duration (ms) for long press */
-    duration?: number;
-}
-
-export type { ActionExecutionOptions as A, ControlActionRequest as C, NativeActionExecutor as N, PressActionParams as P, ScrollActionParams as S, TypeActionParams as T, WaitResult as W, ControlActionResponse as a, ComponentActionRequest as b, ComponentActionResponse as c, SwipeActionParams as d, PageNavigationResponse as e, PageNavigateRequest as f };