@qontinui/ui-bridge 0.1.1

package/dist/registry-CT6BVVKr.d.mts

@@ -0,0 +1,253 @@
+import { d as BridgeEventListener, e as BridgeEventType, i as ElementType, S as StandardAction, g as CustomAction, l as RegisteredElement, R as RegisteredComponent, a1 as Workflow, o as UIState, p as UIStateGroup, q as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, m as StateSnapshot, f as BridgeSnapshot } from './types-BpvpStn3.mjs';
+
+/**
+ * Element and Component Registry
+ *
+ * Central registry for all UI elements and components registered with UI Bridge.
+ * Provides methods for registration, lookup, and lifecycle management.
+ */
+
+/**
+ * Registry options
+ */
+interface RegistryOptions {
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Callback when an event occurs */
+    onEvent?: BridgeEventListener;
+}
+/**
+ * UI Bridge Registry
+ *
+ * Central registry for managing elements, components, and workflows.
+ */
+declare class UIBridgeRegistry {
+    private elements;
+    private components;
+    private workflows;
+    private eventListeners;
+    private options;
+    private states;
+    private stateGroups;
+    private transitions;
+    private activeStates;
+    constructor(options?: RegistryOptions);
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Register an event listener
+     */
+    on<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): () => void;
+    /**
+     * Remove an event listener
+     */
+    off<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): void;
+    /**
+     * Register an element
+     */
+    registerElement(id: string, element: HTMLElement, options?: {
+        type?: ElementType;
+        label?: string;
+        actions?: StandardAction[];
+        customActions?: Record<string, CustomAction>;
+    }): RegisteredElement;
+    /**
+     * Unregister an element
+     */
+    unregisterElement(id: string): boolean;
+    /**
+     * Get a registered element
+     */
+    getElement(id: string): RegisteredElement | undefined;
+    /**
+     * Get all registered elements
+     */
+    getAllElements(): RegisteredElement[];
+    /**
+     * Find element by DOM element reference
+     */
+    findByDOMElement(element: HTMLElement): RegisteredElement | undefined;
+    /**
+     * Register a component
+     */
+    registerComponent(id: string, options: {
+        name: string;
+        description?: string;
+        actions?: Array<{
+            id: string;
+            label?: string;
+            description?: string;
+            handler: (params?: unknown) => unknown | Promise<unknown>;
+        }>;
+        elementIds?: string[];
+    }): RegisteredComponent;
+    /**
+     * Unregister a component
+     */
+    unregisterComponent(id: string): boolean;
+    /**
+     * Get a registered component
+     */
+    getComponent(id: string): RegisteredComponent | undefined;
+    /**
+     * Get all registered components
+     */
+    getAllComponents(): RegisteredComponent[];
+    /**
+     * Register a workflow
+     */
+    registerWorkflow(workflow: Workflow): Workflow;
+    /**
+     * Unregister a workflow
+     */
+    unregisterWorkflow(id: string): boolean;
+    /**
+     * Get a workflow
+     */
+    getWorkflow(id: string): Workflow | undefined;
+    /**
+     * Get all workflows
+     */
+    getAllWorkflows(): Workflow[];
+    /**
+     * Register a state
+     */
+    registerState(state: UIState): UIState;
+    /**
+     * Unregister a state
+     */
+    unregisterState(id: string): boolean;
+    /**
+     * Get a registered state
+     */
+    getState(id: string): UIState | undefined;
+    /**
+     * Get all registered states
+     */
+    getAllStates(): UIState[];
+    /**
+     * Register a state group
+     */
+    registerStateGroup(group: UIStateGroup): UIStateGroup;
+    /**
+     * Unregister a state group
+     */
+    unregisterStateGroup(id: string): boolean;
+    /**
+     * Get a state group
+     */
+    getStateGroup(id: string): UIStateGroup | undefined;
+    /**
+     * Get all state groups
+     */
+    getAllStateGroups(): UIStateGroup[];
+    /**
+     * Register a transition
+     */
+    registerTransition(transition: UITransition): UITransition;
+    /**
+     * Unregister a transition
+     */
+    unregisterTransition(id: string): boolean;
+    /**
+     * Get a transition
+     */
+    getTransition(id: string): UITransition | undefined;
+    /**
+     * Get all transitions
+     */
+    getAllTransitions(): UITransition[];
+    /**
+     * Get currently active states
+     */
+    getActiveStates(): string[];
+    /**
+     * Check if a state is active
+     */
+    isStateActive(id: string): boolean;
+    /**
+     * Activate a state
+     */
+    activateState(id: string): boolean;
+    /**
+     * Deactivate a state
+     */
+    deactivateState(id: string): boolean;
+    /**
+     * Activate multiple states
+     */
+    activateStates(ids: string[]): string[];
+    /**
+     * Deactivate multiple states
+     */
+    deactivateStates(ids: string[]): string[];
+    /**
+     * Activate a state group (all states in the group)
+     */
+    activateStateGroup(groupId: string): string[];
+    /**
+     * Deactivate a state group (all states in the group)
+     */
+    deactivateStateGroup(groupId: string): string[];
+    /**
+     * Check if a transition can be executed from current state
+     */
+    canExecuteTransition(transitionId: string): boolean;
+    /**
+     * Execute a transition
+     */
+    executeTransition(transitionId: string): Promise<TransitionResult>;
+    /**
+     * Find a path from current state to target states
+     *
+     * Uses a simple BFS algorithm for pathfinding.
+     * For more advanced pathfinding (Dijkstra, A*), use the Python state manager service.
+     */
+    findPath(targetStates: string[]): PathResult;
+    /**
+     * Navigate to target states using pathfinding
+     */
+    navigateTo(targetStates: string[]): Promise<NavigationResult>;
+    /**
+     * Create a state snapshot
+     */
+    createStateSnapshot(): StateSnapshot;
+    /**
+     * Create a snapshot of the current state
+     */
+    createSnapshot(): BridgeSnapshot;
+    /**
+     * Clear all registrations
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        elementCount: number;
+        componentCount: number;
+        workflowCount: number;
+        mountedElementCount: number;
+        mountedComponentCount: number;
+        stateCount: number;
+        stateGroupCount: number;
+        transitionCount: number;
+        activeStateCount: number;
+    };
+}
+/**
+ * Get or create the global registry
+ */
+declare function getGlobalRegistry(): UIBridgeRegistry;
+/**
+ * Set the global registry
+ */
+declare function setGlobalRegistry(registry: UIBridgeRegistry): void;
+/**
+ * Reset the global registry
+ */
+declare function resetGlobalRegistry(): void;
+
+export { type RegistryOptions as R, UIBridgeRegistry as U, getGlobalRegistry as g, resetGlobalRegistry as r, setGlobalRegistry as s };

package/dist/registry-D4mQ01B3.d.ts

@@ -0,0 +1,253 @@
+import { d as BridgeEventListener, e as BridgeEventType, i as ElementType, S as StandardAction, g as CustomAction, l as RegisteredElement, R as RegisteredComponent, a1 as Workflow, o as UIState, p as UIStateGroup, q as UITransition, T as TransitionResult, P as PathResult, N as NavigationResult, m as StateSnapshot, f as BridgeSnapshot } from './types-BpvpStn3.js';
+
+/**
+ * Element and Component Registry
+ *
+ * Central registry for all UI elements and components registered with UI Bridge.
+ * Provides methods for registration, lookup, and lifecycle management.
+ */
+
+/**
+ * Registry options
+ */
+interface RegistryOptions {
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Callback when an event occurs */
+    onEvent?: BridgeEventListener;
+}
+/**
+ * UI Bridge Registry
+ *
+ * Central registry for managing elements, components, and workflows.
+ */
+declare class UIBridgeRegistry {
+    private elements;
+    private components;
+    private workflows;
+    private eventListeners;
+    private options;
+    private states;
+    private stateGroups;
+    private transitions;
+    private activeStates;
+    constructor(options?: RegistryOptions);
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Register an event listener
+     */
+    on<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): () => void;
+    /**
+     * Remove an event listener
+     */
+    off<T = unknown>(type: BridgeEventType, listener: BridgeEventListener<T>): void;
+    /**
+     * Register an element
+     */
+    registerElement(id: string, element: HTMLElement, options?: {
+        type?: ElementType;
+        label?: string;
+        actions?: StandardAction[];
+        customActions?: Record<string, CustomAction>;
+    }): RegisteredElement;
+    /**
+     * Unregister an element
+     */
+    unregisterElement(id: string): boolean;
+    /**
+     * Get a registered element
+     */
+    getElement(id: string): RegisteredElement | undefined;
+    /**
+     * Get all registered elements
+     */
+    getAllElements(): RegisteredElement[];
+    /**
+     * Find element by DOM element reference
+     */
+    findByDOMElement(element: HTMLElement): RegisteredElement | undefined;
+    /**
+     * Register a component
+     */
+    registerComponent(id: string, options: {
+        name: string;
+        description?: string;
+        actions?: Array<{
+            id: string;
+            label?: string;
+            description?: string;
+            handler: (params?: unknown) => unknown | Promise<unknown>;
+        }>;
+        elementIds?: string[];
+    }): RegisteredComponent;
+    /**
+     * Unregister a component
+     */
+    unregisterComponent(id: string): boolean;
+    /**
+     * Get a registered component
+     */
+    getComponent(id: string): RegisteredComponent | undefined;
+    /**
+     * Get all registered components
+     */
+    getAllComponents(): RegisteredComponent[];
+    /**
+     * Register a workflow
+     */
+    registerWorkflow(workflow: Workflow): Workflow;
+    /**
+     * Unregister a workflow
+     */
+    unregisterWorkflow(id: string): boolean;
+    /**
+     * Get a workflow
+     */
+    getWorkflow(id: string): Workflow | undefined;
+    /**
+     * Get all workflows
+     */
+    getAllWorkflows(): Workflow[];
+    /**
+     * Register a state
+     */
+    registerState(state: UIState): UIState;
+    /**
+     * Unregister a state
+     */
+    unregisterState(id: string): boolean;
+    /**
+     * Get a registered state
+     */
+    getState(id: string): UIState | undefined;
+    /**
+     * Get all registered states
+     */
+    getAllStates(): UIState[];
+    /**
+     * Register a state group
+     */
+    registerStateGroup(group: UIStateGroup): UIStateGroup;
+    /**
+     * Unregister a state group
+     */
+    unregisterStateGroup(id: string): boolean;
+    /**
+     * Get a state group
+     */
+    getStateGroup(id: string): UIStateGroup | undefined;
+    /**
+     * Get all state groups
+     */
+    getAllStateGroups(): UIStateGroup[];
+    /**
+     * Register a transition
+     */
+    registerTransition(transition: UITransition): UITransition;
+    /**
+     * Unregister a transition
+     */
+    unregisterTransition(id: string): boolean;
+    /**
+     * Get a transition
+     */
+    getTransition(id: string): UITransition | undefined;
+    /**
+     * Get all transitions
+     */
+    getAllTransitions(): UITransition[];
+    /**
+     * Get currently active states
+     */
+    getActiveStates(): string[];
+    /**
+     * Check if a state is active
+     */
+    isStateActive(id: string): boolean;
+    /**
+     * Activate a state
+     */
+    activateState(id: string): boolean;
+    /**
+     * Deactivate a state
+     */
+    deactivateState(id: string): boolean;
+    /**
+     * Activate multiple states
+     */
+    activateStates(ids: string[]): string[];
+    /**
+     * Deactivate multiple states
+     */
+    deactivateStates(ids: string[]): string[];
+    /**
+     * Activate a state group (all states in the group)
+     */
+    activateStateGroup(groupId: string): string[];
+    /**
+     * Deactivate a state group (all states in the group)
+     */
+    deactivateStateGroup(groupId: string): string[];
+    /**
+     * Check if a transition can be executed from current state
+     */
+    canExecuteTransition(transitionId: string): boolean;
+    /**
+     * Execute a transition
+     */
+    executeTransition(transitionId: string): Promise<TransitionResult>;
+    /**
+     * Find a path from current state to target states
+     *
+     * Uses a simple BFS algorithm for pathfinding.
+     * For more advanced pathfinding (Dijkstra, A*), use the Python state manager service.
+     */
+    findPath(targetStates: string[]): PathResult;
+    /**
+     * Navigate to target states using pathfinding
+     */
+    navigateTo(targetStates: string[]): Promise<NavigationResult>;
+    /**
+     * Create a state snapshot
+     */
+    createStateSnapshot(): StateSnapshot;
+    /**
+     * Create a snapshot of the current state
+     */
+    createSnapshot(): BridgeSnapshot;
+    /**
+     * Clear all registrations
+     */
+    clear(): void;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        elementCount: number;
+        componentCount: number;
+        workflowCount: number;
+        mountedElementCount: number;
+        mountedComponentCount: number;
+        stateCount: number;
+        stateGroupCount: number;
+        transitionCount: number;
+        activeStateCount: number;
+    };
+}
+/**
+ * Get or create the global registry
+ */
+declare function getGlobalRegistry(): UIBridgeRegistry;
+/**
+ * Set the global registry
+ */
+declare function setGlobalRegistry(registry: UIBridgeRegistry): void;
+/**
+ * Reset the global registry
+ */
+declare function resetGlobalRegistry(): void;
+
+export { type RegistryOptions as R, UIBridgeRegistry as U, getGlobalRegistry as g, resetGlobalRegistry as r, setGlobalRegistry as s };