uilint-react 0.2.48 → 0.2.49

package/dist/DevTool.d.ts

@@ -4,8 +4,7 @@ export type DevToolProps = {
 /**
  * Main devtool React root.
  *
- * Handles all UILint functionality including event handlers,
- * WebSocket connection, auto-scans, and UI rendering.
+ * Handles WebSocket connection and UI rendering.
  */
 export declare function DevTool({ enabled }: DevToolProps): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=DevTool.d.ts.map

package/dist/DevTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DevTool.d.ts","sourceRoot":"","sources":["../src/DevTool.tsx"],"names":[],"mappings":"AA2BA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AASF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,EAAE,OAAc,EAAE,EAAE,YAAY,kDAsFvD"}
+{"version":3,"file":"DevTool.d.ts","sourceRoot":"","sources":["../src/DevTool.tsx"],"names":[],"mappings":"AAuBA,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AASF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,OAAc,EAAE,EAAE,YAAY,kDAkEvD"}

package/dist/components/ui-lint/index.d.ts

@@ -1,17 +1,10 @@
 /**
- * UILint Source Visualization Components
+ * UILint Legacy Utilities
  *
- * A dev overlay for inspecting React components and analyzing code with LLM.
- * Use Alt+Click on any element to open the inspector sidebar.
+ * These utilities are kept for backward compatibility.
+ * New UI components are in /ui/ directory.
  */
-export { useUILintStore } from './store';
-export type { UILintStore } from './store';
-export { FloatingIcon } from './FloatingIcon';
-export { CommandPalette } from './command-palette';
-export { VisionIssuesPanel } from './VisionIssuesPanel';
-export { ScreenshotViewer } from './ScreenshotViewer';
 export { scanDOMForSources, groupBySourceFile, cleanupDataAttributes, getElementById, updateElementRects, buildEditorUrl, isNodeModulesPath, getDisplayName, getSourceFromDataLoc, } from './dom-utils';
-export { useDOMObserver, getDataLocElementCount } from './useDOMObserver';
 export { fetchSource, fetchSourceWithContext, clearSourceCache, getCachedSource, prefetchSources, } from './source-fetcher';
 export type { SourceLocation, ScannedElement, SourceFile, UILintSettings, SourceApiResponse, CachedSource, LocatorTarget, InspectedElement, VisionIssue, VisionAnalysisResult, ElementManifest, } from './types';
 export { FILE_COLORS, DEFAULT_SETTINGS, DATA_UILINT_ID } from './types';

package/dist/components/ui-lint/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ui-lint/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ui-lint/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,GACtB,MAAM,8BAA8B,CAAC"}

package/dist/consistency/highlights.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highlights.d.ts","sourceRoot":"","sources":["../../src/consistency/highlights.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAiBzC,UAAU,2BAA2B;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,iBAAiB,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,SAAS,GAAG,IAAI,CAAC;CACnC;AA4KD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,iBAAiB,EACjB,eAAe,GAChB,EAAE,2BAA2B,4BAoG7B"}
+{"version":3,"file":"highlights.d.ts","sourceRoot":"","sources":["../../src/consistency/highlights.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA2C,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAyBzC,UAAU,2BAA2B;IACnC,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,iBAAiB,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,SAAS,GAAG,IAAI,CAAC;CACnC;AA4KD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,iBAAiB,EACjB,eAAe,GAChB,EAAE,2BAA2B,4BAoG7B"}

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core - Plugin system infrastructure
+ *
+ * This module provides the foundation for the UILint plugin architecture:
+ * - Plugin registration and lifecycle management
+ * - Dynamic plugin loading
+ * - Shared services (WebSocket, DOM observation)
+ * - Core UI state management
+ */
+export * from './plugin-system';
+export * from './services';
+export * from './store';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC"}

package/dist/core/plugin-system/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Plugin System - Core infrastructure for UILint plugin architecture
+ */
+export type { Plugin, PluginServices, Command, Analyzer, InspectorPanel, InspectorPanelProps, RuleUIContribution, RuleDetailProps, IssueInlineProps, FixSuggestion, } from './types';
+export { PluginRegistry, pluginRegistry, createPluginRegistry, sortByDependencies, } from './registry';
+export { loadPlugins, loadPlugin, getPluginManifest, BUILT_IN_PLUGINS, type PluginManifest, } from './loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugin-system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugin-system/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,MAAM,EACN,cAAc,EACd,OAAO,EACP,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC"}

package/dist/core/plugin-system/loader.d.ts

@@ -0,0 +1,38 @@
+import { Plugin } from './types';
+/**
+ * Plugin manifest for dynamic loading
+ */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    /** Dynamic import function */
+    load: () => Promise<{
+        default: Plugin;
+    }>;
+    /** Whether plugin is enabled */
+    enabled: boolean;
+}
+/**
+ * Built-in plugin manifests
+ */
+export declare const BUILT_IN_PLUGINS: PluginManifest[];
+/**
+ * Load a single plugin from its manifest
+ * @param manifest - The plugin manifest to load
+ * @returns The loaded plugin or null on failure
+ */
+export declare function loadPlugin(manifest: PluginManifest): Promise<Plugin | null>;
+/**
+ * Load multiple plugins from manifests
+ * @param manifests - Array of plugin manifests to load
+ * @param onProgress - Optional callback for progress updates
+ * @returns Array of loaded plugins sorted by dependencies
+ */
+export declare function loadPlugins(manifests?: PluginManifest[], onProgress?: (loaded: number, total: number, pluginId: string) => void): Promise<Plugin[]>;
+/**
+ * Get a plugin manifest by ID
+ * @param id - The plugin ID to find
+ * @returns The plugin manifest or undefined if not found
+ */
+export declare function getPluginManifest(id: string): PluginManifest | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/plugin-system/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/plugin-system/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAmB5C,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,SAAS,GAAE,cAAc,EAAqB,EAC9C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GACrE,OAAO,CAAC,MAAM,EAAE,CAAC,CAkCnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE"}

package/dist/core/plugin-system/registry.d.ts

@@ -0,0 +1,130 @@
+import { Plugin, PluginServices, Command, Analyzer, InspectorPanel, RuleUIContribution, RuleMeta } from './types';
+/**
+ * Topologically sort plugins by their dependencies.
+ * Ensures plugins are initialized after their dependencies.
+ *
+ * @param plugins - Array of plugins to sort
+ * @returns Sorted array with dependencies before dependents
+ * @throws Error if circular dependency is detected
+ */
+export declare function sortByDependencies(plugins: Plugin[]): Plugin[];
+/**
+ * Plugin Registry
+ *
+ * Central registry for managing UILint plugins. Handles:
+ * - Plugin registration with dependency validation
+ * - Ordered initialization based on dependencies
+ * - Aggregation of plugin contributions
+ * - Lifecycle management (dispose)
+ */
+export declare class PluginRegistry {
+    private plugins;
+    private services;
+    /**
+     * Register a plugin with the registry.
+     *
+     * @param plugin - The plugin to register
+     * @throws Warning if plugin with same ID already registered
+     * @throws Warning if plugin dependencies are not registered
+     */
+    register(plugin: Plugin): void;
+    /**
+     * Initialize all registered plugins in dependency order.
+     *
+     * @param services - Plugin services to pass to each plugin's initialize method
+     */
+    initializeAll(services: PluginServices): Promise<void>;
+    /**
+     * Get all registered plugins.
+     *
+     * @returns Array of all registered plugins
+     */
+    getPlugins(): Plugin[];
+    /**
+     * Get a specific plugin by ID.
+     *
+     * @param id - The plugin ID to look up
+     * @returns The plugin if found, undefined otherwise
+     */
+    getPlugin(id: string): Plugin | undefined;
+    /**
+     * Aggregate all commands from all registered plugins.
+     *
+     * @returns Array of all commands from all plugins
+     */
+    getAllCommands(): Command[];
+    /**
+     * Aggregate all analyzers from all registered plugins.
+     *
+     * @returns Array of all analyzers from all plugins
+     */
+    getAllAnalyzers(): Analyzer[];
+    /**
+     * Aggregate all inspector panels from all registered plugins.
+     * Panels are sorted by priority (higher priority first).
+     *
+     * @returns Array of all inspector panels, sorted by priority
+     */
+    getAllInspectorPanels(): InspectorPanel[];
+    /**
+     * Resolve which plugin handles a specific rule.
+     *
+     * First checks for plugins that explicitly claim the rule via ruleContributions,
+     * then falls back to matching by rule category.
+     *
+     * @param ruleId - The rule ID to look up
+     * @param ruleMeta - The rule metadata
+     * @returns The plugin that handles this rule, or a default core plugin
+     */
+    getPluginForRule(ruleId: string, ruleMeta: RuleMeta): Plugin;
+    /**
+     * Get custom UI contribution for a specific rule.
+     *
+     * @param ruleId - The rule ID to look up
+     * @returns The rule UI contribution if found, undefined otherwise
+     */
+    getRuleContribution(ruleId: string): RuleUIContribution | undefined;
+    /**
+     * Dispose all plugins and clean up resources.
+     * Calls dispose on each plugin in reverse initialization order.
+     */
+    disposeAll(): void;
+    /**
+     * Check if a plugin is registered.
+     *
+     * @param id - The plugin ID to check
+     * @returns true if the plugin is registered
+     */
+    isRegistered(id: string): boolean;
+    /**
+     * Check if a plugin is initialized.
+     *
+     * @param id - The plugin ID to check
+     * @returns true if the plugin is initialized, false otherwise
+     */
+    isInitialized(id: string): boolean;
+    /**
+     * Get the current plugin services (available after initializeAll).
+     *
+     * @returns The plugin services, or null if not yet initialized
+     */
+    getServices(): PluginServices | null;
+    /**
+     * Clear all registered plugins.
+     * Useful for testing or resetting the registry.
+     */
+    clear(): void;
+}
+/**
+ * Factory function to create a new PluginRegistry instance.
+ * Use this in tests to get isolated registry instances.
+ *
+ * @returns A new PluginRegistry instance
+ */
+export declare function createPluginRegistry(): PluginRegistry;
+/**
+ * Singleton instance of the plugin registry.
+ * Use this for global plugin management.
+ */
+export declare const pluginRegistry: PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/plugin-system/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/plugin-system/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,cAAc,EACd,OAAO,EACP,QAAQ,EACR,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACT,MAAM,SAAS,CAAC;AAUjB;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA+C9D;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CAA+B;IAE/C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsC9B;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C5D;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE;IAItB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC;;;;OAIG;IACH,cAAc,IAAI,OAAO,EAAE;IAY3B;;;;OAIG;IACH,eAAe,IAAI,QAAQ,EAAE;IAY7B;;;;;OAKG;IACH,qBAAqB,IAAI,cAAc,EAAE;IAazC;;;;;;;;;OASG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAmD5D;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAenE;;;OAGG;IACH,UAAU,IAAI,IAAI;IAoClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIjC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,WAAW,IAAI,cAAc,GAAG,IAAI;IAIpC;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,gBAAyB,CAAC"}

package/dist/core/plugin-system/types.d.ts

@@ -0,0 +1,353 @@
+import { ComponentType, ReactNode } from 'react';
+/**
+ * Metadata describing a plugin
+ */
+export interface PluginMeta {
+    /** Unique plugin identifier (e.g., "uilint-eslint", "uilint-vision") */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** Semantic version string */
+    version: string;
+    /** Short description of the plugin's purpose */
+    description: string;
+    /** Optional icon (React component or emoji string) */
+    icon?: ReactNode;
+    /** Plugin IDs this plugin depends on */
+    dependencies?: string[];
+}
+/**
+ * Services injected into plugins for accessing core functionality
+ */
+export interface PluginServices {
+    /** WebSocket service for server communication */
+    websocket: WebSocketService;
+    /** DOM observer service for tracking element changes */
+    domObserver: DOMObserverService;
+    /** Get current state from the store */
+    getState: <T = unknown>() => T;
+    /** Update state in the store */
+    setState: <T = unknown>(partial: Partial<T>) => void;
+    /** Open the inspector sidebar with specific content */
+    openInspector: (mode: "rule" | "issue" | "element" | "fixes", data: {
+        ruleId?: string;
+        issue?: unknown;
+        elementId?: string;
+        filePath?: string;
+    }) => void;
+    /** Close the command palette */
+    closeCommandPalette: () => void;
+}
+/**
+ * A command that can be triggered from the command palette
+ */
+export interface Command {
+    /** Unique command identifier */
+    id: string;
+    /** Display title in the command palette */
+    title: string;
+    /** Keywords for fuzzy search matching */
+    keywords: string[];
+    /** Category for grouping (e.g., "actions", "navigation", "settings") */
+    category: string;
+    /** Optional subtitle for additional context */
+    subtitle?: string;
+    /** Optional icon (React component or emoji string) */
+    icon?: ReactNode;
+    /** Optional keyboard shortcut (e.g., "Cmd+K", "Ctrl+Shift+P") */
+    shortcut?: string;
+    /**
+     * Predicate to determine if the command is available in the current state
+     * @param state Current application state
+     * @returns true if the command should be shown
+     */
+    isAvailable?: (state: unknown) => boolean;
+    /**
+     * Execute the command
+     * @param services Plugin services for accessing core functionality
+     * @returns Optional promise for async commands
+     */
+    execute: (services: PluginServices) => void | Promise<void>;
+}
+/**
+ * Props passed to inspector panel components
+ */
+export interface InspectorPanelProps {
+    /** Optional data payload for the panel */
+    data?: Record<string, unknown>;
+    /** Plugin services for accessing core functionality */
+    services: PluginServices;
+}
+/**
+ * An inspector panel contributed by a plugin
+ */
+export interface InspectorPanel {
+    /** Unique panel identifier */
+    id: string;
+    /** Panel title (string or function for dynamic titles) */
+    title: string | ((props: InspectorPanelProps) => string);
+    /** Optional icon (React component or emoji string) */
+    icon?: ReactNode;
+    /** React component to render the panel content */
+    component: ComponentType<InspectorPanelProps>;
+    /** Priority for ordering (higher = appears first, default: 0) */
+    priority?: number;
+}
+/**
+ * Trigger conditions for when an analyzer should run
+ */
+export type AnalyzerTrigger = "manual" | "page-load" | "route-change" | "file-change" | "dom-mutation";
+/**
+ * Context provided to analyzers during analysis
+ */
+export interface AnalysisContext {
+    /** Current route/pathname */
+    route: string;
+    /** Scanned DOM elements with data-loc attributes */
+    elements: ScannedElementInfo[];
+    /** Send a message to the server via WebSocket */
+    sendMessage: (message: unknown) => void;
+    /** Get current application state */
+    getState: <T = unknown>() => T;
+}
+/**
+ * An analyzer that can scan the page for issues
+ */
+export interface Analyzer {
+    /** Unique analyzer identifier */
+    id: string;
+    /** Human-readable analyzer name */
+    name: string;
+    /** When this analyzer should be triggered */
+    triggers: AnalyzerTrigger[];
+    /** Whether this analyzer requires a WebSocket connection to function */
+    requiresConnection: boolean;
+    /**
+     * Run the analysis
+     * @param context Analysis context with elements and services
+     * @returns Array of discovered issues or a promise resolving to them
+     */
+    analyze: (context: AnalysisContext) => PluginIssue[] | Promise<PluginIssue[]>;
+}
+/**
+ * Severity level for issues
+ */
+export type IssueSeverity = "error" | "warning" | "info";
+/**
+ * A unified issue type for all plugin-reported problems
+ */
+export interface PluginIssue {
+    /** Unique issue identifier */
+    id: string;
+    /** Human-readable issue message */
+    message: string;
+    /** Severity level */
+    severity: IssueSeverity;
+    /** data-loc attribute value linking to source location */
+    dataLoc?: string;
+    /** Source file path */
+    filePath?: string;
+    /** Line number in source file (1-indexed) */
+    line?: number;
+    /** Column number in source file (1-indexed) */
+    column?: number;
+    /** Rule ID that generated this issue */
+    ruleId?: string;
+    /** Additional metadata for the issue */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Issues contributed by a plugin for heatmap aggregation
+ */
+export interface IssueContribution {
+    /** Plugin ID that contributed these issues */
+    pluginId: string;
+    /**
+     * Map of dataLoc -> issues for that location
+     * Multiple issues can exist at the same source location
+     */
+    issues: Map<string, PluginIssue[]>;
+}
+/**
+ * Custom UI contribution for a specific rule
+ */
+export interface RuleUIContribution {
+    /** Rule ID this contribution applies to */
+    ruleId: string;
+    /** Custom inspector panel for this rule's issues */
+    inspectorPanel?: ComponentType<InspectorPanelProps>;
+    /** Custom icon for this rule */
+    icon?: ReactNode;
+    /** Additional commands specific to this rule */
+    commands?: Command[];
+    /** Custom heatmap color for this rule's issues (CSS color string) */
+    heatmapColor?: string;
+}
+/**
+ * Rule metadata for handlesRules predicate
+ */
+export interface RuleMeta {
+    /** Rule ID (e.g., "uilint/semantic") */
+    id: string;
+    /** Rule category */
+    category?: string;
+    /** Rule name */
+    name?: string;
+}
+/**
+ * Complete plugin definition with all contributions
+ * @template TSlice Type of the plugin's state slice
+ */
+export interface Plugin<TSlice = unknown> {
+    /** Plugin metadata (for structured access) */
+    meta?: PluginMeta;
+    /** Unique plugin identifier (e.g., "uilint-eslint", "uilint-vision") */
+    id: string;
+    /** Human-readable plugin name */
+    name: string;
+    /** Semantic version string */
+    version: string;
+    /** Short description of the plugin's purpose */
+    description?: string;
+    /** Optional icon (React component or emoji string) */
+    icon?: ReactNode;
+    /** Plugin IDs this plugin depends on */
+    dependencies?: string[];
+    /** Rule categories this plugin handles (e.g., ["semantic", "static"]) */
+    ruleCategories?: string[];
+    /**
+     * Create the plugin's state slice
+     * @param services Plugin services for initialization
+     * @returns Initial state slice for this plugin
+     */
+    createSlice?: (services: PluginServices) => TSlice;
+    /** Commands contributed by this plugin */
+    commands?: Command[];
+    /** Inspector panels contributed by this plugin */
+    inspectorPanels?: InspectorPanel[];
+    /** Analyzers contributed by this plugin */
+    analyzers?: Analyzer[];
+    /** Per-rule UI contributions */
+    ruleContributions?: RuleUIContribution[];
+    /**
+     * Predicate to determine if this plugin handles a specific rule
+     * Used for routing issues to the correct plugin
+     * @param ruleMeta Metadata about the rule
+     * @returns true if this plugin should handle issues from this rule
+     */
+    handlesRules?: (ruleMeta: RuleMeta) => boolean;
+    /**
+     * Get issues from the plugin's state for heatmap display
+     * @param state Current plugin state slice
+     * @returns Issue contribution for heatmap aggregation
+     */
+    getIssues?: (state: TSlice) => IssueContribution;
+    /**
+     * Initialize the plugin (called once on registration)
+     * @param services Plugin services
+     * @returns Optional cleanup function or promise
+     */
+    initialize?: (services: PluginServices) => void | (() => void) | Promise<void>;
+    /**
+     * Dispose the plugin (called on unregistration)
+     * @param services Plugin services
+     */
+    dispose?: (services: PluginServices) => void | Promise<void>;
+}
+/**
+ * Handler for WebSocket messages
+ */
+export type WebSocketMessageHandler = (message: unknown) => void;
+/**
+ * Handler for WebSocket connection state changes
+ */
+export type WebSocketConnectionHandler = (connected: boolean) => void;
+/**
+ * WebSocket service for server communication
+ */
+export interface WebSocketService {
+    /** Whether the WebSocket is currently connected */
+    readonly isConnected: boolean;
+    /** Current WebSocket URL */
+    readonly url: string;
+    /**
+     * Connect to the WebSocket server
+     * @param url Optional URL to connect to (uses default if not provided)
+     */
+    connect: (url?: string) => void;
+    /**
+     * Disconnect from the WebSocket server
+     */
+    disconnect: () => void;
+    /**
+     * Send a message to the server
+     * @param message Message to send (will be JSON stringified)
+     */
+    send: (message: unknown) => void;
+    /**
+     * Subscribe to messages of a specific type
+     * @param type Message type to listen for
+     * @param handler Handler function for messages of this type
+     * @returns Unsubscribe function
+     */
+    on: (type: string, handler: WebSocketMessageHandler) => () => void;
+    /**
+     * Subscribe to connection state changes
+     * @param handler Handler function for connection state changes
+     * @returns Unsubscribe function
+     */
+    onConnectionChange: (handler: WebSocketConnectionHandler) => () => void;
+}
+/**
+ * Handler for DOM element additions
+ */
+export type ElementsAddedHandler = (elements: ScannedElementInfo[]) => void;
+/**
+ * Handler for DOM element removals
+ */
+export type ElementsRemovedHandler = (elementIds: string[]) => void;
+/**
+ * DOM observer service for tracking element changes
+ */
+export interface DOMObserverService {
+    /**
+     * Start observing DOM changes
+     */
+    start: () => void;
+    /**
+     * Stop observing DOM changes
+     */
+    stop: () => void;
+    /**
+     * Subscribe to element additions
+     * @param handler Handler function for added elements
+     * @returns Unsubscribe function
+     */
+    onElementsAdded: (handler: ElementsAddedHandler) => () => void;
+    /**
+     * Subscribe to element removals
+     * @param handler Handler function for removed element IDs
+     * @returns Unsubscribe function
+     */
+    onElementsRemoved: (handler: ElementsRemovedHandler) => () => void;
+}
+/**
+ * Information about a scanned DOM element with data-loc attribute
+ */
+export interface ScannedElementInfo {
+    /**
+     * Unique element identifier
+     * Format: "loc:path:line:column#occurrence"
+     */
+    id: string;
+    /** data-loc attribute value (format: "path:line:column") */
+    dataLoc: string;
+    /** Reference to the DOM element */
+    element: Element;
+    /** HTML tag name (e.g., "div", "button") */
+    tagName: string;
+    /** Element's bounding rectangle */
+    rect: DOMRect;
+}
+export type { ComponentType, ReactNode };
+//# sourceMappingURL=types.d.ts.map

package/dist/core/plugin-system/types.d.ts.map

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