uilint-react 0.2.47 → 0.2.49

package/dist/core/services/dom-observer.d.ts

@@ -0,0 +1,171 @@
+/**
+ * DOM Observer Service
+ *
+ * A shared service that watches for elements with data-loc attributes.
+ * Used to track DOM elements for source visualization and scanning.
+ *
+ * Features:
+ * - MutationObserver-based tracking of data-loc elements
+ * - Debounced reconciliation for handling streaming/suspense
+ * - Subscribe/unsubscribe pattern for add/remove notifications
+ * - Filtering for node_modules and UILint's own UI
+ * - Dependency injection for testability
+ */
+/** The attribute used to identify source-mapped elements */
+export declare const DATA_LOC_ATTR = "data-loc";
+/** Debounce delay for reconciliation to handle rapid DOM changes */
+export declare const RECONCILE_DEBOUNCE_MS = 100;
+/**
+ * Generate a unique element ID from data-loc and occurrence number
+ * @param dataLoc - The parsed data-loc value (path:line:column)
+ * @param occurrence - The occurrence number (1-based) for elements with same dataLoc
+ * @returns Unique ID in format "loc:path:line:column#occurrence"
+ */
+export declare function generateElementId(dataLoc: string, occurrence: number): string;
+/**
+ * Parse a raw data-loc attribute value, normalizing runtime ID format if present
+ * @param rawDataLoc - The raw data-loc attribute value
+ * @returns The normalized data-loc value (path:line:column) or null if invalid
+ */
+export declare function parseDataLoc(rawDataLoc: string): string | null;
+/**
+ * Check if a path should be filtered based on node_modules presence
+ * @param path - The file path to check
+ * @param hideNodeModules - Whether to filter node_modules paths
+ * @returns True if the path should be filtered out
+ */
+export declare function shouldFilterPath(path: string, hideNodeModules: boolean): boolean;
+/**
+ * Options for creating a DOMObserverService instance
+ * Enables dependency injection for testing
+ */
+export interface DOMObserverOptions {
+    /** Root element to observe (defaults to document.body) */
+    root?: Element;
+    /** MutationObserver implementation (defaults to window.MutationObserver) */
+    MutationObserverImpl?: typeof MutationObserver;
+    /** Custom querySelectorAll function (defaults to document.querySelectorAll) */
+    querySelectorAll?: (selector: string) => NodeListOf<Element>;
+}
+/**
+ * Information about a scanned DOM element with data-loc attribute
+ */
+export interface ScannedElementInfo {
+    /**
+     * Unique per-instance ID derived from data-loc.
+     * Format: "loc:path:line:column#occurrence"
+     */
+    id: string;
+    /** The raw data-loc attribute value (path:line:column) */
+    dataLoc: string;
+    /** Reference to the DOM element */
+    element: Element;
+    /** Lowercase tag name of the element */
+    tagName: string;
+    /** Current bounding client rect */
+    rect: DOMRect;
+}
+/** Handler called when new elements with data-loc are detected */
+export type ElementAddedHandler = (elements: ScannedElementInfo[]) => void;
+/** Handler called when elements with data-loc are removed */
+export type ElementRemovedHandler = (elementIds: string[]) => void;
+/**
+ * Interface for the DOM Observer Service
+ */
+export interface DOMObserverService {
+    /** Configure whether to filter out node_modules paths */
+    setHideNodeModules(hide: boolean): void;
+    /** Start observing the DOM */
+    start(): void;
+    /** Stop observing and clear state */
+    stop(): void;
+    /** Subscribe to element addition events, returns unsubscribe function */
+    onElementsAdded(handler: ElementAddedHandler): () => void;
+    /** Subscribe to element removal events, returns unsubscribe function */
+    onElementsRemoved(handler: ElementRemovedHandler): () => void;
+    /** Get all currently tracked elements */
+    getElements(): ScannedElementInfo[];
+}
+/**
+ * DOM Observer Service Implementation
+ *
+ * Service that tracks data-loc elements in the DOM.
+ * Supports dependency injection for testability.
+ */
+export declare class DOMObserverServiceImpl implements DOMObserverService {
+    private observer;
+    private reconcileTimeout;
+    private knownElements;
+    private addedHandlers;
+    private removedHandlers;
+    private isRunning;
+    private hideNodeModules;
+    private readonly options;
+    /**
+     * Create a new DOMObserverService instance
+     * @param options - Optional configuration for dependency injection
+     */
+    constructor(options?: DOMObserverOptions);
+    /**
+     * Configure whether to filter out elements from node_modules
+     */
+    setHideNodeModules(hide: boolean): void;
+    /**
+     * Start observing the DOM for data-loc elements
+     */
+    start(): void;
+    /**
+     * Stop observing and clear all state
+     */
+    stop(): void;
+    /**
+     * Subscribe to element addition events
+     * @returns Unsubscribe function
+     */
+    onElementsAdded(handler: ElementAddedHandler): () => void;
+    /**
+     * Subscribe to element removal events
+     * @returns Unsubscribe function
+     */
+    onElementsRemoved(handler: ElementRemovedHandler): () => void;
+    /**
+     * Get all currently tracked elements
+     */
+    getElements(): ScannedElementInfo[];
+    /**
+     * Handle MutationObserver callbacks
+     */
+    private handleMutations;
+    /**
+     * Check if a node or its descendants have data-loc attributes
+     */
+    private hasDataLocElements;
+    /**
+     * Debounced reconciliation to handle rapid DOM updates
+     */
+    private debouncedReconcile;
+    /**
+     * Full reconciliation: scan DOM, diff with known elements, emit events
+     */
+    private reconcile;
+    /**
+     * Scan the DOM for all elements with data-loc attributes
+     */
+    private scanElements;
+    /**
+     * Check if an element is inside UILint's own UI
+     */
+    private isInsideUILintUI;
+}
+/**
+ * Create a new DOMObserverService instance with optional dependency injection
+ * @param options - Optional configuration for dependency injection (useful for testing)
+ * @returns A new DOMObserverService instance
+ */
+export declare function createDOMObserverService(options?: DOMObserverOptions): DOMObserverService;
+/**
+ * Shared DOM observer service instance
+ * @deprecated Use createDOMObserverService() for new code that needs testability
+ */
+export declare const domObserver: DOMObserverService;
+//# sourceMappingURL=dom-observer.d.ts.map

package/dist/core/services/dom-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-observer.d.ts","sourceRoot":"","sources":["../../../src/core/services/dom-observer.ts"],"names":[],"mappings":"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"}

package/dist/core/services/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Core Services - Shared services for all plugins
+ */
+export { websocket, WebSocketServiceImpl, createWebSocketService, DEFAULT_WS_URL, MAX_RECONNECT_ATTEMPTS, RECONNECT_BASE_DELAY, type WebSocketService, type WebSocketServiceOptions, type MessageHandler, type ConnectionHandler, } from './websocket';
+export { domObserver, createDOMObserverService, DOMObserverServiceImpl, generateElementId, parseDataLoc, shouldFilterPath, DATA_LOC_ATTR, RECONCILE_DEBOUNCE_MS, type DOMObserverOptions, type DOMObserverService, type ScannedElementInfo, type ElementAddedHandler, type ElementRemovedHandler, } from './dom-observer';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,WAAW,EAEX,wBAAwB,EAExB,sBAAsB,EAEtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAEhB,aAAa,EACb,qBAAqB,EAErB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/core/services/websocket.d.ts

@@ -0,0 +1,112 @@
+/**
+ * WebSocket Service - Singleton shared by all plugins
+ *
+ * Provides connection management, message routing, and automatic reconnection
+ * with exponential backoff.
+ */
+export declare const DEFAULT_WS_URL = "ws://localhost:9234";
+export declare const MAX_RECONNECT_ATTEMPTS = 5;
+export declare const RECONNECT_BASE_DELAY = 1000;
+export type MessageHandler<T = unknown> = (data: T) => void;
+export type ConnectionHandler = (connected: boolean) => void;
+/**
+ * Options for dependency injection in WebSocketService
+ * Allows injecting mock implementations for testing
+ */
+export interface WebSocketServiceOptions {
+    /** Factory function to create WebSocket instances */
+    createWebSocket?: (url: string) => WebSocket;
+    /** Custom setTimeout implementation */
+    setTimeout?: typeof globalThis.setTimeout;
+    /** Custom clearTimeout implementation */
+    clearTimeout?: typeof globalThis.clearTimeout;
+}
+/**
+ * WebSocket service interface
+ */
+export interface WebSocketService {
+    readonly isConnected: boolean;
+    readonly url: string;
+    connect(url?: string): void;
+    disconnect(): void;
+    send(message: unknown): void;
+    on<T>(type: string, handler: MessageHandler<T>): () => void;
+    onConnectionChange(handler: ConnectionHandler): () => void;
+}
+/**
+ * WebSocket service implementation
+ */
+export declare class WebSocketServiceImpl implements WebSocketService {
+    private options;
+    private ws;
+    private handlers;
+    private connectionHandlers;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private intentionalDisconnect;
+    private readonly createWebSocket;
+    private readonly _setTimeout;
+    private readonly _clearTimeout;
+    isConnected: boolean;
+    url: string;
+    /**
+     * Create a new WebSocket service instance
+     * @param options - Optional dependency injection options for testing
+     */
+    constructor(options?: WebSocketServiceOptions);
+    /**
+     * Connect to the WebSocket server
+     * @param url - Optional URL to connect to (defaults to DEFAULT_WS_URL)
+     */
+    connect(url?: string): void;
+    /**
+     * Disconnect from the WebSocket server
+     * Prevents automatic reconnection
+     */
+    disconnect(): void;
+    /**
+     * Send a message to the WebSocket server
+     * @param message - The message to send (will be JSON stringified)
+     */
+    send(message: unknown): void;
+    /**
+     * Subscribe to messages of a specific type
+     * @param type - Message type to subscribe to, or "*" for all messages
+     * @param handler - Handler function to call when message is received
+     * @returns Unsubscribe function
+     */
+    on<T>(type: string, handler: MessageHandler<T>): () => void;
+    /**
+     * Subscribe to connection status changes
+     * @param handler - Handler function to call when connection status changes
+     * @returns Unsubscribe function
+     */
+    onConnectionChange(handler: ConnectionHandler): () => void;
+    /**
+     * Set up WebSocket event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Dispatch a message to registered handlers
+     * @param type - Message type
+     * @param data - Message data
+     */
+    private dispatch;
+    /**
+     * Notify all connection handlers of a status change
+     * @param connected - Current connection status
+     */
+    private notifyConnectionChange;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    private scheduleReconnect;
+}
+/**
+ * Factory function to create a WebSocket service instance
+ * @param options - Optional dependency injection options for testing
+ * @returns A new WebSocket service instance
+ */
+export declare function createWebSocketService(options?: WebSocketServiceOptions): WebSocketService;
+export declare const websocket: WebSocketServiceImpl;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/core/services/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/core/services/websocket.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,cAAc,wBAAwB,CAAC;AACpD,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAGzC,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAC5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;AAE7D;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7C,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC,UAAU,CAAC;IAC1C,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC,YAAY,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,IAAI,IAAI,CAAC;IACnB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAC5D,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAoB/C,OAAO,CAAC,OAAO;IAnB3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,kBAAkB,CAAqC;IAC/D,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,qBAAqB,CAAkB;IAG/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAExD,WAAW,EAAE,OAAO,CAAS;IAC7B,GAAG,EAAE,MAAM,CAAkB;IAEpC;;;OAGG;gBACiB,OAAO,GAAE,uBAA4B;IAOzD;;;OAGG;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IA8B3B;;;OAGG;IACH,UAAU,IAAI,IAAI;IAkBlB;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAa5B;;;;;OAKG;IACH,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAiB3D;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAY1D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IA4BhB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA8B1B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAElB;AAGD,eAAO,MAAM,SAAS,sBAA6B,CAAC"}

package/dist/core/store/composed-store.d.ts

@@ -0,0 +1,212 @@
+import { StoreApi, UseBoundStore } from 'zustand';
+import { CoreSlice } from './core-slice';
+import { PluginRegistry } from '../plugin-system/registry';
+import { PluginServices, WebSocketService, DOMObserverService } from '../plugin-system/types';
+import { ESLintPluginSlice } from '../../plugins/eslint/slice';
+import { VisionSlice } from '../../plugins/vision/slice';
+import { SemanticPluginSlice } from '../../plugins/semantic/slice';
+/**
+ * Options for creating a composed store instance.
+ * Allows dependency injection for testing and customization.
+ */
+export interface ComposedStoreOptions {
+    /** Custom WebSocket service implementation */
+    websocket?: WebSocketService;
+    /** Custom DOM observer service implementation */
+    domObserver?: DOMObserverService;
+    /** Custom plugin registry instance */
+    registry?: PluginRegistry;
+}
+/**
+ * Map of plugin IDs to their slice types.
+ * Extend this interface when adding new plugins.
+ */
+export interface PluginSliceMap {
+    eslint: ESLintPluginSlice;
+    vision: VisionSlice;
+    semantic: SemanticPluginSlice;
+}
+/**
+ * Type for all possible plugin slices (union of all plugin slice types).
+ */
+export type AnyPluginSlice = PluginSliceMap[keyof PluginSliceMap];
+/**
+ * Namespace-prefixed plugin slices.
+ * Each plugin's state is accessible via `plugins.{pluginId}`.
+ */
+export interface PluginSlices {
+    plugins: {
+        [K in keyof PluginSliceMap]?: PluginSliceMap[K];
+    };
+}
+/**
+ * The composed store state combines:
+ * 1. CoreSlice - Core UI state (floating icon, command palette, inspector, etc.)
+ * 2. PluginSlices - Namespaced plugin state accessible via `plugins.{pluginId}`
+ */
+export type ComposedState = CoreSlice & PluginSlices;
+/**
+ * Actions for managing the composed store
+ */
+export interface ComposedStoreActions {
+    /**
+     * Register a plugin's slice into the store.
+     * Called when a plugin is initialized with its createSlice method.
+     *
+     * @param pluginId - The unique plugin identifier
+     * @param slice - The plugin's state slice
+     */
+    registerPluginSlice: <K extends keyof PluginSliceMap>(pluginId: K, slice: PluginSliceMap[K]) => void;
+    /**
+     * Unregister a plugin's slice from the store.
+     * Called when a plugin is disposed.
+     *
+     * @param pluginId - The unique plugin identifier
+     */
+    unregisterPluginSlice: (pluginId: keyof PluginSliceMap) => void;
+    /**
+     * Get a specific plugin's slice.
+     * Returns undefined if the plugin is not registered.
+     *
+     * @param pluginId - The unique plugin identifier
+     * @returns The plugin's slice or undefined
+     */
+    getPluginSlice: <K extends keyof PluginSliceMap>(pluginId: K) => PluginSliceMap[K] | undefined;
+    /**
+     * Update a specific plugin's slice.
+     * Merges the partial update with the existing slice.
+     *
+     * @param pluginId - The unique plugin identifier
+     * @param partial - Partial update to merge into the slice
+     */
+    setPluginSlice: <K extends keyof PluginSliceMap>(pluginId: K, partial: Partial<PluginSliceMap[K]>) => void;
+}
+/**
+ * Full composed store type including state and actions
+ */
+export type ComposedStore = ComposedState & ComposedStoreActions;
+/**
+ * Factory function for creating isolated store instances.
+ * Use this in tests to get fresh stores with injected dependencies.
+ *
+ * Unlike createComposedStore(), this does NOT use a singleton pattern.
+ * Each call creates a completely new, isolated store instance.
+ *
+ * @param options - Dependencies and configuration for the store
+ * @returns A new store instance (not a singleton)
+ *
+ * @example
+ * ```typescript
+ * // In tests
+ * const mockWebSocket = createMockWebSocketService();
+ * const mockDomObserver = createMockDOMObserverService();
+ * const testRegistry = createPluginRegistry();
+ *
+ * const store = createComposedStoreFactory({
+ *   websocket: mockWebSocket,
+ *   domObserver: mockDomObserver,
+ *   registry: testRegistry,
+ * });
+ *
+ * // Each test gets its own isolated store
+ * expect(store.getState().commandPalette.open).toBe(false);
+ * ```
+ */
+export declare function createComposedStoreFactory(options?: ComposedStoreOptions): UseBoundStore<StoreApi<ComposedStore>>;
+/**
+ * Create the composed store with core slice and plugin support.
+ * Uses a singleton pattern - returns the same instance if already created.
+ *
+ * For testing, use createComposedStoreFactory() instead which creates
+ * isolated instances.
+ *
+ * @param options - Optional configuration for the store
+ * @returns The singleton store instance
+ */
+export declare function createComposedStore(options?: ComposedStoreOptions): UseBoundStore<StoreApi<ComposedStore>>;
+/**
+ * Hook to access the composed store.
+ * This is the primary way components should access the store.
+ *
+ * If the store hasn't been created yet, it will be created with default options.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   // Access core state
+ *   const isOpen = useComposedStore((state) => state.commandPalette.open);
+ *
+ *   // Access plugin state
+ *   const eslintSlice = useComposedStore((state) => state.plugins.eslint);
+ *
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useComposedStore(): ComposedStore;
+export declare function useComposedStore<T>(selector: (state: ComposedStore) => T): T;
+/**
+ * Initialize all registered plugins and merge their slices into the store.
+ * This should be called after the store is created and before rendering.
+ *
+ * @param options - Optional configuration for services and registry
+ * @returns Promise that resolves when all plugins are initialized
+ */
+export declare function initializePlugins(options?: ComposedStoreOptions): Promise<void>;
+/**
+ * Get the raw store API for advanced use cases.
+ * Prefer using useComposedStore hook in React components.
+ *
+ * @returns The store API or null if not created
+ */
+export declare function getStoreApi(): StoreApi<ComposedStore> | null;
+/**
+ * Get the plugin services instance.
+ * Useful for plugins that need to access services outside of React.
+ *
+ * @returns The plugin services or null if not created
+ */
+export declare function getPluginServices(): PluginServices | null;
+/**
+ * Reset the store instance.
+ * Primarily useful for testing.
+ *
+ * @param options - Optional configuration to immediately create a new store with
+ * @returns The new store instance if options were provided, undefined otherwise
+ *
+ * @example
+ * ```typescript
+ * // Simple reset
+ * resetStore();
+ *
+ * // Reset and immediately create new store with mocks
+ * const store = resetStore({
+ *   websocket: mockWebSocket,
+ *   domObserver: mockDomObserver,
+ * });
+ * ```
+ */
+export declare function resetStore(options?: ComposedStoreOptions): UseBoundStore<StoreApi<ComposedStore>> | void;
+/**
+ * Check if a plugin slice is registered in the store.
+ *
+ * @param pluginId - The plugin ID to check
+ * @returns true if the plugin slice is registered
+ */
+export declare function hasPluginSlice(pluginId: string): boolean;
+/**
+ * Get typed plugin slice with proper type inference.
+ *
+ * @param pluginId - The plugin ID
+ * @returns The plugin slice or undefined
+ */
+export declare function getPluginSlice<K extends keyof PluginSliceMap>(pluginId: K): PluginSliceMap[K] | undefined;
+/**
+ * Create typed plugin services for a specific plugin.
+ * This provides getState/setState scoped to the plugin's slice.
+ *
+ * @param pluginId - The plugin ID
+ * @returns Scoped plugin services
+ */
+export declare function createScopedPluginServices<K extends keyof PluginSliceMap>(pluginId: K): PluginServices | null;
+//# sourceMappingURL=composed-store.d.ts.map

package/dist/core/store/composed-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composed-store.d.ts","sourceRoot":"","sources":["../../../src/core/store/composed-store.ts"],"names":[],"mappings":"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"}

package/dist/core/store/core-slice.d.ts

@@ -0,0 +1,126 @@
+import { StateCreator } from 'zustand';
+import { PluginServices } from '../plugin-system/types';
+/**
+ * Position of the floating icon in pixel coordinates.
+ */
+export interface FloatingIconPosition {
+    x: number;
+    y: number;
+}
+/**
+ * Filter chip for the command palette search.
+ * Allows filtering by rule, issue, loc (source location), file, capture, or plugin.
+ */
+export interface CommandPaletteFilter {
+    type: "rule" | "issue" | "loc" | "file" | "capture" | "plugin";
+    value: string;
+    label: string;
+}
+/**
+ * Command palette state.
+ */
+export interface CommandPaletteState {
+    /** Whether the command palette is open */
+    open: boolean;
+    /** Current search query */
+    query: string;
+    /** Currently selected index for keyboard navigation */
+    selectedIndex: number;
+    /** Active filters (shown as chips) */
+    filters: CommandPaletteFilter[];
+}
+/**
+ * Inspector sidebar state.
+ */
+export interface InspectorState {
+    /** Whether the inspector is open */
+    open: boolean;
+    /** Which plugin panel is currently shown (null if none) */
+    panelId: string | null;
+    /** Data passed to the panel */
+    data: Record<string, unknown> | null;
+    /** Whether inspector is docked (participates in layout) or floating */
+    docked: boolean;
+    /** Width when docked (resizable) */
+    width: number;
+    /** Position when floating */
+    floatingPosition: {
+        x: number;
+        y: number;
+    } | null;
+    /** Size when floating */
+    floatingSize: {
+        width: number;
+        height: number;
+    } | null;
+}
+/**
+ * Core UI state slice interface.
+ * Contains state and actions for core UI functionality.
+ */
+export interface CoreSlice {
+    /** Floating icon position (null = default top-center) */
+    floatingIconPosition: FloatingIconPosition | null;
+    /** Set floating icon position and persist to localStorage */
+    setFloatingIconPosition: (position: FloatingIconPosition) => void;
+    /** Whether the Alt key is currently held */
+    altKeyHeld: boolean;
+    /** Set Alt key held state */
+    setAltKeyHeld: (held: boolean) => void;
+    /** Currently selected element ID */
+    selectedElementId: string | null;
+    /** Currently hovered element ID (for overlay highlighting) */
+    hoveredElementId: string | null;
+    /** Set selected element ID */
+    setSelectedElementId: (id: string | null) => void;
+    /** Set hovered element ID */
+    setHoveredElementId: (id: string | null) => void;
+    /** Command palette state */
+    commandPalette: CommandPaletteState;
+    /** Open the command palette */
+    openCommandPalette: () => void;
+    /** Close the command palette */
+    closeCommandPalette: () => void;
+    /** Set the command palette search query */
+    setCommandPaletteQuery: (query: string) => void;
+    /** Set the selected index for keyboard navigation */
+    setCommandPaletteSelectedIndex: (index: number) => void;
+    /** Add a filter to the command palette */
+    addFilter: (filter: CommandPaletteFilter) => void;
+    /** Remove a filter at the specified index */
+    removeFilter: (index: number) => void;
+    /** Clear all command palette filters */
+    clearFilters: () => void;
+    /** Inspector sidebar state */
+    inspector: InspectorState;
+    /** Open the inspector with a specific panel */
+    openInspector: (panelId: string, data?: Record<string, unknown>) => void;
+    /** Close the inspector */
+    closeInspector: () => void;
+    /** Toggle between docked and floating mode */
+    toggleInspectorDocked: () => void;
+    /** Set inspector width (docked mode) */
+    setInspectorWidth: (width: number) => void;
+    /** Set inspector position (floating mode) */
+    setInspectorFloatingPosition: (position: {
+        x: number;
+        y: number;
+    }) => void;
+    /** Set inspector size (floating mode) */
+    setInspectorFloatingSize: (size: {
+        width: number;
+        height: number;
+    }) => void;
+    /** Whether connected to the WebSocket server */
+    wsConnected: boolean;
+    /** WebSocket server URL */
+    wsUrl: string;
+}
+/**
+ * Create the core UI state slice.
+ *
+ * @param services - Plugin services for accessing WebSocket and storage
+ * @returns StateCreator for the core slice
+ */
+export declare const createCoreSlice: (services: PluginServices) => StateCreator<CoreSlice>;
+//# sourceMappingURL=core-slice.d.ts.map

package/dist/core/store/core-slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-slice.d.ts","sourceRoot":"","sources":["../../../src/core/store/core-slice.ts"],"names":[],"mappings":"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"}

package/dist/core/store/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Core Store - UI state management
+ */
+export { createCoreSlice, type CoreSlice, type FloatingIconPosition, type CommandPaletteState, type CommandPaletteFilter, type InspectorState, } from './core-slice';
+export { createComposedStore, createComposedStoreFactory, useComposedStore, initializePlugins, getStoreApi, getPluginServices, resetStore, hasPluginSlice, getPluginSlice, createScopedPluginServices, type ComposedStoreOptions, type PluginSliceMap, type AnyPluginSlice, type PluginSlices, type ComposedState, type ComposedStoreActions, type ComposedStore, } from './composed-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,cAAc,EACd,0BAA0B,EAE1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC"}