@tachui/cli 0.8.1-alpha → 0.8.5-alpha

package/dist/devtools/src/debug/validation-debug-tools.js

@@ -0,0 +1,472 @@
+/**
+ * Validation Debugging Tools - Phase 1C
+ *
+ * Comprehensive debugging helpers, diagnostic tools, validation inspector,
+ * and developer utilities for analyzing validation behavior.
+ *
+ * Moved from @tachui/core to @tachui/devtools for better separation of concerns.
+ */
+// Enhanced runtime imports - these will need to be handled differently in devtools
+// For now, we'll create mocks or import what's needed
+const _enhancedConfig = { recovery: { enableRecovery: true } };
+const performanceMonitor = {
+    getSnapshot: () => ({
+        memory: 0,
+        timing: {},
+        validationOverhead: 0,
+        cacheEfficiency: 0.85,
+    }),
+};
+const _validationCache = { size: 0, hitRate: 0 };
+/**
+ * Validation debugging inspector
+ */
+export class ValidationDebugger {
+    static instance;
+    sessions = new Map();
+    currentSession = null;
+    eventListeners = new Map();
+    componentRegistry = new Map();
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new ValidationDebugger();
+        }
+        return this.instance;
+    }
+    /**
+     * Start a debugging session
+     */
+    startSession(sessionId) {
+        const id = sessionId ||
+            `debug-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        const session = {
+            id,
+            startTime: Date.now(),
+            validationEvents: [],
+            components: [],
+            errors: [],
+            performance: performanceMonitor.getSnapshot(),
+        };
+        this.sessions.set(id, session);
+        this.currentSession = session;
+        this.logEvent('validation-start', `Debug session ${id} started`);
+        if (process.env.NODE_ENV !== 'production') {
+            console.info(`🔍 TachUI Debug Session Started: ${id}`);
+        }
+        return id;
+    }
+    /**
+     * End the current debugging session
+     */
+    endSession() {
+        if (!this.currentSession) {
+            console.warn('No active debug session to end');
+            return null;
+        }
+        this.currentSession.endTime = Date.now();
+        this.logEvent('validation-end', `Debug session ${this.currentSession.id} ended`);
+        const session = this.currentSession;
+        this.currentSession = null;
+        if (process.env.NODE_ENV !== 'production') {
+            console.info(`🔍 TachUI Debug Session Ended: ${session.id}`);
+            this.printSessionSummary(session);
+        }
+        return session;
+    }
+    /**
+     * Log a debug event
+     */
+    logEvent(type, message, data) {
+        if (!this.currentSession)
+            return;
+        const event = {
+            id: `event-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`,
+            type,
+            timestamp: Date.now(),
+            message,
+            data,
+            stackTrace: process.env.NODE_ENV !== 'production' ? new Error().stack : undefined,
+        };
+        this.currentSession.validationEvents.push(event);
+        // Notify event listeners
+        const listeners = this.eventListeners.get(type) || [];
+        listeners.forEach(listener => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Debug event listener error:', error);
+            }
+        });
+    }
+    /**
+     * Register component for debugging
+     */
+    registerComponent(_component, type, props) {
+        const componentId = `${type}-${Date.now()}-${Math.random().toString(36).substr(2, 6)}`;
+        const debugInfo = {
+            type,
+            id: componentId,
+            props,
+            lifecycle: {
+                created: Date.now(),
+            },
+            validation: {
+                passed: true,
+                errors: [],
+                warnings: [],
+                lastCheck: Date.now(),
+            },
+            performance: {
+                updateTimes: [],
+                validationTime: 0,
+            },
+        };
+        this.componentRegistry.set(componentId, debugInfo);
+        if (this.currentSession) {
+            this.currentSession.components.push(debugInfo);
+            this.logEvent('component-mount', `Component ${type} registered`, {
+                componentId,
+                props,
+            });
+        }
+        return componentId;
+    }
+    /**
+     * Update component debug info
+     */
+    updateComponent(componentId, phase, data) {
+        const debugInfo = this.componentRegistry.get(componentId);
+        if (!debugInfo)
+            return;
+        const timestamp = Date.now();
+        switch (phase) {
+            case 'mount':
+                debugInfo.lifecycle.mounted = timestamp;
+                if (data?.performance) {
+                    debugInfo.performance.mountTime = data.performance.duration;
+                }
+                this.logEvent('component-mount', `Component ${debugInfo.type} mounted`, { componentId, data });
+                break;
+            case 'update':
+                debugInfo.lifecycle.lastUpdate = timestamp;
+                if (data?.performance) {
+                    debugInfo.performance.updateTimes.push(data.performance.duration);
+                }
+                if (data?.props) {
+                    debugInfo.props = { ...data.props };
+                }
+                this.logEvent('component-update', `Component ${debugInfo.type} updated`, { componentId, data });
+                break;
+            case 'unmount':
+                debugInfo.lifecycle.unmounted = timestamp;
+                this.logEvent('component-unmount', `Component ${debugInfo.type} unmounted`, { componentId });
+                break;
+        }
+    }
+    /**
+     * Record validation error for debugging
+     */
+    recordValidationError(error, componentId) {
+        if (this.currentSession) {
+            this.currentSession.errors.push(error);
+            this.logEvent('validation-error', `Validation error: ${error.message}`, {
+                error,
+                componentId,
+            });
+        }
+        if (componentId) {
+            const debugInfo = this.componentRegistry.get(componentId);
+            if (debugInfo) {
+                debugInfo.validation.passed = false;
+                debugInfo.validation.errors.push(error.message);
+            }
+        }
+    }
+    /**
+     * Record validation recovery for debugging
+     */
+    recordValidationRecovery(originalError, recoveryStrategy, componentId) {
+        this.logEvent('validation-recovery', `Recovered from validation error using ${recoveryStrategy}`, { originalError, recoveryStrategy, componentId });
+        if (componentId) {
+            const debugInfo = this.componentRegistry.get(componentId);
+            if (debugInfo) {
+                debugInfo.validation.warnings.push(`Recovered from: ${originalError}`);
+            }
+        }
+    }
+    /**
+     * Add event listener for debug events
+     */
+    addEventListener(type, listener) {
+        if (!this.eventListeners.has(type)) {
+            this.eventListeners.set(type, []);
+        }
+        this.eventListeners.get(type).push(listener);
+    }
+    /**
+     * Remove event listener
+     */
+    removeEventListener(type, listener) {
+        const listeners = this.eventListeners.get(type);
+        if (listeners) {
+            const index = listeners.indexOf(listener);
+            if (index > -1) {
+                listeners.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Get debug session by ID
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get current active session
+     */
+    getCurrentSession() {
+        return this.currentSession;
+    }
+    /**
+     * Get all debug sessions
+     */
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    /**
+     * Search debug events by criteria
+     */
+    searchEvents(criteria) {
+        if (!this.currentSession)
+            return [];
+        return this.currentSession.validationEvents.filter(event => {
+            if (criteria.type && event.type !== criteria.type)
+                return false;
+            if (criteria.componentType &&
+                event.componentType !== criteria.componentType)
+                return false;
+            if (criteria.timeRange) {
+                if (event.timestamp < criteria.timeRange.start ||
+                    event.timestamp > criteria.timeRange.end)
+                    return false;
+            }
+            if (criteria.messageContains &&
+                !event.message.includes(criteria.messageContains))
+                return false;
+            return true;
+        });
+    }
+    /**
+     * Analyze component performance
+     */
+    analyzeComponent(componentId) {
+        const debugInfo = this.componentRegistry.get(componentId);
+        if (!debugInfo)
+            return null;
+        // Calculate average update time
+        if (debugInfo.performance.updateTimes.length > 0) {
+            const average = debugInfo.performance.updateTimes.reduce((sum, time) => sum + time, 0) /
+                debugInfo.performance.updateTimes.length;
+            console.info(`📊 Component ${debugInfo.type} average update time: ${average.toFixed(2)}ms`);
+        }
+        // Calculate component age
+        const age = Date.now() - debugInfo.lifecycle.created;
+        console.info(`📊 Component ${debugInfo.type} age: ${age}ms`);
+        return debugInfo;
+    }
+    /**
+     * Generate performance report
+     */
+    generatePerformanceReport() {
+        if (!this.currentSession)
+            return 'No active debug session';
+        const components = this.currentSession.components;
+        const totalValidationTime = components.reduce((sum, comp) => sum + comp.performance.validationTime, 0);
+        const averageValidationTime = components.length > 0 ? totalValidationTime / components.length : 0;
+        const report = [
+            '🔍 TachUI Validation Performance Report',
+            `Session ID: ${this.currentSession.id}`,
+            `Duration: ${this.currentSession.endTime ? this.currentSession.endTime - this.currentSession.startTime : 'Ongoing'}ms`,
+            `Components: ${components.length}`,
+            `Validation Events: ${this.currentSession.validationEvents.length}`,
+            `Errors: ${this.currentSession.errors.length}`,
+            `Average Validation Time: ${averageValidationTime.toFixed(2)}ms`,
+            '',
+            'Component Performance:',
+            ...components.map(comp => {
+                const updateCount = comp.performance.updateTimes.length;
+                const avgUpdateTime = updateCount > 0
+                    ? comp.performance.updateTimes.reduce((sum, time) => sum + time, 0) / updateCount
+                    : 0;
+                return `  ${comp.type} (${comp.id}): ${comp.performance.validationTime}ms validation, ${avgUpdateTime.toFixed(2)}ms avg update, ${updateCount} updates`;
+            }),
+        ].join('\n');
+        return report;
+    }
+    /**
+     * Clear all debug data
+     */
+    clearDebugData() {
+        this.sessions.clear();
+        this.currentSession = null;
+        this.componentRegistry.clear();
+        this.eventListeners.clear();
+        console.info('🔍 Debug data cleared');
+    }
+    /**
+     * Export debug data for external analysis
+     */
+    exportDebugData() {
+        const data = {
+            sessions: Array.from(this.sessions.entries()),
+            currentSession: this.currentSession,
+            components: Array.from(this.componentRegistry.entries()),
+            timestamp: Date.now(),
+        };
+        return JSON.stringify(data, null, 2);
+    }
+    /**
+     * Import debug data from external source
+     */
+    importDebugData(jsonData) {
+        try {
+            const data = JSON.parse(jsonData);
+            if (data.sessions) {
+                this.sessions = new Map(data.sessions);
+            }
+            if (data.components) {
+                this.componentRegistry = new Map(data.components);
+            }
+            if (data.currentSession) {
+                this.currentSession = data.currentSession;
+            }
+            console.info('🔍 Debug data imported successfully');
+        }
+        catch (error) {
+            console.error('Failed to import debug data:', error);
+        }
+    }
+    /**
+     * Print session summary to console
+     */
+    printSessionSummary(session) {
+        const duration = session.endTime ? session.endTime - session.startTime : 0;
+        const errorCount = session.errors.length;
+        const componentCount = session.components.length;
+        const eventCount = session.validationEvents.length;
+        console.group(`📊 Debug Session Summary: ${session.id}`);
+        console.info(`Duration: ${duration}ms`);
+        console.info(`Components: ${componentCount}`);
+        console.info(`Events: ${eventCount}`);
+        console.info(`Errors: ${errorCount}`);
+        if (errorCount > 0) {
+            console.warn('Errors encountered:', session.errors.map(e => e.message));
+        }
+        const performanceEvents = session.validationEvents.filter(e => e.type === 'performance-warning');
+        if (performanceEvents.length > 0) {
+            console.warn(`Performance warnings: ${performanceEvents.length}`);
+        }
+        console.groupEnd();
+    }
+}
+/**
+ * Global validation debugger instance
+ */
+export const validationDebugger = ValidationDebugger.getInstance();
+/**
+ * Validation debugging utilities
+ */
+export const ValidationDebugUtils = {
+    /**
+     * Start debugging session
+     */
+    startSession: (sessionId) => validationDebugger.startSession(sessionId),
+    /**
+     * End debugging session
+     */
+    endSession: () => validationDebugger.endSession(),
+    /**
+     * Log debug event
+     */
+    logEvent: (type, message, data) => validationDebugger.logEvent(type, message, data),
+    /**
+     * Register component for debugging
+     */
+    registerComponent: (component, type, props) => validationDebugger.registerComponent(component, type, props),
+    /**
+     * Record validation error
+     */
+    recordError: (error, componentId) => validationDebugger.recordValidationError(error, componentId),
+    /**
+     * Record validation recovery
+     */
+    recordRecovery: (originalError, strategy, componentId) => validationDebugger.recordValidationRecovery(originalError, strategy, componentId),
+    /**
+     * Get performance report
+     */
+    getPerformanceReport: () => validationDebugger.generatePerformanceReport(),
+    /**
+     * Search events
+     */
+    searchEvents: (criteria) => validationDebugger.searchEvents(criteria),
+    /**
+     * Export debug data
+     */
+    export: () => validationDebugger.exportDebugData(),
+    /**
+     * Import debug data
+     */
+    import: (data) => validationDebugger.importDebugData(data),
+    /**
+     * Clear all debug data
+     */
+    clear: () => validationDebugger.clearDebugData(),
+    /**
+     * Test debugging system
+     */
+    test: () => {
+        console.group('🔍 Validation Debug System Test');
+        try {
+            // Start a test session
+            const sessionId = validationDebugger.startSession('test-session');
+            console.info('✅ Debug session started:', sessionId);
+            // Register a test component
+            const componentId = validationDebugger.registerComponent({}, 'TestComponent', { prop: 'value' });
+            console.info('✅ Test component registered:', componentId);
+            // Log some test events
+            validationDebugger.logEvent('validation-start', 'Test validation started');
+            validationDebugger.logEvent('cache-hit', 'Test cache hit', {
+                key: 'test-key',
+            });
+            validationDebugger.logEvent('validation-end', 'Test validation completed');
+            // Update component
+            validationDebugger.updateComponent(componentId, 'mount', {
+                performance: { duration: 5 },
+            });
+            validationDebugger.updateComponent(componentId, 'update', {
+                props: { updated: true },
+            });
+            // Record a test error and recovery
+            validationDebugger.recordValidationError(new Error('Test error'), componentId);
+            validationDebugger.recordValidationRecovery('Test error', 'fallback', componentId);
+            // Generate and log performance report
+            const _report = validationDebugger.generatePerformanceReport();
+            console.info('✅ Performance report generated');
+            // Search events
+            const errorEvents = validationDebugger.searchEvents({
+                type: 'validation-error',
+            });
+            console.info('✅ Event search:', errorEvents.length, 'error events found');
+            // End session
+            const session = validationDebugger.endSession();
+            console.info('✅ Debug session ended:', session?.id);
+            console.info('✅ Validation debugging system is working correctly');
+        }
+        catch (error) {
+            console.error('❌ Validation debugging test failed:', error);
+        }
+        console.groupEnd();
+    },
+};
+//# sourceMappingURL=validation-debug-tools.js.map

package/dist/devtools/src/debug/validation-debug-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-debug-tools.js","sourceRoot":"","sources":["../../../../../devtools/src/debug/validation-debug-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,mFAAmF;AACnF,sDAAsD;AACtD,MAAM,eAAe,GAAG,EAAE,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,CAAA;AAC9D,MAAM,kBAAkB,GAAG;IACzB,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QAClB,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,EAAE;QACV,kBAAkB,EAAE,CAAC;QACrB,eAAe,EAAE,IAAI;KACtB,CAAC;CACH,CAAA;AACD,MAAM,gBAAgB,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAA;AAoFhD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAC,QAAQ,CAAoB;IACnC,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC1C,cAAc,GAAwB,IAAI,CAAA;IAC1C,cAAc,GAAG,IAAI,GAAG,EAAwC,CAAA;IAChE,iBAAiB,GAAG,IAAI,GAAG,EAA8B,CAAA;IAEjE,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAA;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAkB;QAC7B,MAAM,EAAE,GACN,SAAS;YACT,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;QAElE,MAAM,OAAO,GAAiB;YAC5B,EAAE;YACF,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,gBAAgB,EAAE,EAAE;YACpB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE;SAC9C,CAAA;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC9B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAA;QAE7B,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAA;QAEhE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;YAC9C,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAExC,IAAI,CAAC,QAAQ,CACX,gBAAgB,EAChB,iBAAiB,IAAI,CAAC,cAAc,CAAC,EAAE,QAAQ,CAChD,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAA;QACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAE1B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,kCAAkC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;YAC5D,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAA8B,EAAE,OAAe,EAAE,IAAU;QAClE,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAM;QAEhC,MAAM,KAAK,GAAe;YACxB,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;YACpE,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,OAAO;YACP,IAAI;YACJ,UAAU,EACR,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACxE,CAAA;QAED,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAEhD,yBAAyB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACrD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YAC3B,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAA;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAA;YACrD,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,UAA6B,EAC7B,IAAY,EACZ,KAAU;QAEV,MAAM,WAAW,GAAG,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAA;QAEtF,MAAM,SAAS,GAAuB;YACpC,IAAI;YACJ,EAAE,EAAE,WAAW;YACf,KAAK;YACL,SAAS,EAAE;gBACT,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;aACpB;YACD,UAAU,EAAE;gBACV,MAAM,EAAE,IAAI;gBACZ,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE,EAAE;gBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB;YACD,WAAW,EAAE;gBACX,WAAW,EAAE,EAAE;gBACf,cAAc,EAAE,CAAC;aAClB;SACF,CAAA;QAED,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;QAElD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC9C,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,IAAI,aAAa,EAAE;gBAC/D,WAAW;gBACX,KAAK;aACN,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,WAAW,CAAA;IACpB,CAAC;IAED;;OAEG;IACH,eAAe,CACb,WAAmB,EACnB,KAAqC,EACrC,IAAU;QAEV,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACzD,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,OAAO;gBACV,SAAS,CAAC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAA;gBACvC,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;oBACtB,SAAS,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAA;gBAC7D,CAAC;gBACD,IAAI,CAAC,QAAQ,CACX,iBAAiB,EACjB,aAAa,SAAS,CAAC,IAAI,UAAU,EACrC,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAA;gBACD,MAAK;YAEP,KAAK,QAAQ;gBACX,SAAS,CAAC,SAAS,CAAC,UAAU,GAAG,SAAS,CAAA;gBAC1C,IAAI,IAAI,EAAE,WAAW,EAAE,CAAC;oBACtB,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;gBACnE,CAAC;gBACD,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;oBAChB,SAAS,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;gBACrC,CAAC;gBACD,IAAI,CAAC,QAAQ,CACX,kBAAkB,EAClB,aAAa,SAAS,CAAC,IAAI,UAAU,EACrC,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAA;gBACD,MAAK;YAEP,KAAK,SAAS;gBACZ,SAAS,CAAC,SAAS,CAAC,SAAS,GAAG,SAAS,CAAA;gBACzC,IAAI,CAAC,QAAQ,CACX,mBAAmB,EACnB,aAAa,SAAS,CAAC,IAAI,YAAY,EACvC,EAAE,WAAW,EAAE,CAChB,CAAA;gBACD,MAAK;QACT,CAAC;IACH,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,KAAU,EAAE,WAAoB;QACpD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,qBAAqB,KAAK,CAAC,OAAO,EAAE,EAAE;gBACtE,KAAK;gBACL,WAAW;aACZ,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAA;gBACnC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,wBAAwB,CACtB,aAAqB,EACrB,gBAAwB,EACxB,WAAoB;QAEpB,IAAI,CAAC,QAAQ,CACX,qBAAqB,EACrB,yCAAyC,gBAAgB,EAAE,EAC3D,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,CACjD,CAAA;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;YACzD,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,aAAa,EAAE,CAAC,CAAA;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,IAA8B,EAC9B,QAAqC;QAErC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,IAA8B,EAC9B,QAAkB;QAElB,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC/C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YACzC,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;gBACf,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAKZ;QACC,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,EAAE,CAAA;QAEnC,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACzD,IAAI,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAA;YAC/D,IACE,QAAQ,CAAC,aAAa;gBACtB,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa;gBAE9C,OAAO,KAAK,CAAA;YACd,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACvB,IACE,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK;oBAC1C,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG;oBAExC,OAAO,KAAK,CAAA;YAChB,CAAC;YACD,IACE,QAAQ,CAAC,eAAe;gBACxB,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAEjD,OAAO,KAAK,CAAA;YACd,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,WAAmB;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACzD,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAA;QAE3B,gCAAgC;QAChC,IAAI,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,OAAO,GACX,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC;gBACtE,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAA;YAC1C,OAAO,CAAC,IAAI,CACV,gBAAgB,SAAS,CAAC,IAAI,yBAAyB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC9E,CAAA;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAA;QACpD,OAAO,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,IAAI,SAAS,GAAG,IAAI,CAAC,CAAA;QAE5D,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,yBAAyB;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,OAAO,yBAAyB,CAAA;QAE1D,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAA;QACjD,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAC3C,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,EACpD,CAAC,CACF,CAAA;QACD,MAAM,qBAAqB,GACzB,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAErE,MAAM,MAAM,GAAG;YACb,yCAAyC;YACzC,eAAe,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE;YACvC,aAAa,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI;YACtH,eAAe,UAAU,CAAC,MAAM,EAAE;YAClC,sBAAsB,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,MAAM,EAAE;YACnE,WAAW,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE;YAC9C,4BAA4B,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;YAChE,EAAE;YACF,wBAAwB;YACxB,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACvB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAA;gBACvD,MAAM,aAAa,GACjB,WAAW,GAAG,CAAC;oBACb,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,EACzB,CAAC,CACF,GAAG,WAAW;oBACjB,CAAC,CAAC,CAAC,CAAA;gBACP,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,kBAAkB,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,WAAW,UAAU,CAAA;YACzJ,CAAC,CAAC;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACrB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAC1B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAA;QAC9B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAA;QAC3B,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC7C,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACxD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACtC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAgB;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAEjC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACxC,CAAC;YAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,iBAAiB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACnD,CAAC;YAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;YAC3C,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAqB;QAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAA;QACxC,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,CAAA;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAA;QAElD,OAAO,CAAC,KAAK,CAAC,6BAA6B,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QACxD,OAAO,CAAC,IAAI,CAAC,aAAa,QAAQ,IAAI,CAAC,CAAA;QACvC,OAAO,CAAC,IAAI,CAAC,eAAe,cAAc,EAAE,CAAC,CAAA;QAC7C,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAA;QAErC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CACV,qBAAqB,EACrB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CACnC,CAAA;QACH,CAAC;QAED,MAAM,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CACvD,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CACtC,CAAA;QACD,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,yBAAyB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,OAAO,CAAC,QAAQ,EAAE,CAAA;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAA;AAElE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC;;OAEG;IACH,YAAY,EAAE,CAAC,SAAkB,EAAE,EAAE,CACnC,kBAAkB,CAAC,YAAY,CAAC,SAAS,CAAC;IAE5C;;OAEG;IACH,UAAU,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,UAAU,EAAE;IAEjD;;OAEG;IACH,QAAQ,EAAE,CAAC,IAA8B,EAAE,OAAe,EAAE,IAAU,EAAE,EAAE,CACxE,kBAAkB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC;IAElD;;OAEG;IACH,iBAAiB,EAAE,CAAC,SAA4B,EAAE,IAAY,EAAE,KAAU,EAAE,EAAE,CAC5E,kBAAkB,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC;IAE9D;;OAEG;IACH,WAAW,EAAE,CAAC,KAAU,EAAE,WAAoB,EAAE,EAAE,CAChD,kBAAkB,CAAC,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC;IAE9D;;OAEG;IACH,cAAc,EAAE,CACd,aAAqB,EACrB,QAAgB,EAChB,WAAoB,EACpB,EAAE,CACF,kBAAkB,CAAC,wBAAwB,CACzC,aAAa,EACb,QAAQ,EACR,WAAW,CACZ;IAEH;;OAEG;IACH,oBAAoB,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,yBAAyB,EAAE;IAE1E;;OAEG;IACH,YAAY,EAAE,CAAC,QAAa,EAAE,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,QAAQ,CAAC;IAE1E;;OAEG;IACH,MAAM,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,eAAe,EAAE;IAElD;;OAEG;IACH,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,kBAAkB,CAAC,eAAe,CAAC,IAAI,CAAC;IAElE;;OAEG;IACH,KAAK,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,cAAc,EAAE;IAEhD;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE;QACT,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAEhD,IAAI,CAAC;YACH,uBAAuB;YACvB,MAAM,SAAS,GAAG,kBAAkB,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;YACjE,OAAO,CAAC,IAAI,CAAC,0BAA0B,EAAE,SAAS,CAAC,CAAA;YAEnD,4BAA4B;YAC5B,MAAM,WAAW,GAAG,kBAAkB,CAAC,iBAAiB,CACtD,EAAuB,EACvB,eAAe,EACf,EAAE,IAAI,EAAE,OAAO,EAAE,CAClB,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAA;YAEzD,uBAAuB;YACvB,kBAAkB,CAAC,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAA;YAC1E,kBAAkB,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,EAAE;gBACzD,GAAG,EAAE,UAAU;aAChB,CAAC,CAAA;YACF,kBAAkB,CAAC,QAAQ,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAA;YAE1E,mBAAmB;YACnB,kBAAkB,CAAC,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE;gBACvD,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;aAC7B,CAAC,CAAA;YACF,kBAAkB,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE;gBACxD,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;aACzB,CAAC,CAAA;YAEF,mCAAmC;YACnC,kBAAkB,CAAC,qBAAqB,CACtC,IAAI,KAAK,CAAC,YAAY,CAAC,EACvB,WAAW,CACZ,CAAA;YACD,kBAAkB,CAAC,wBAAwB,CACzC,YAAY,EACZ,UAAU,EACV,WAAW,CACZ,CAAA;YAED,sCAAsC;YACtC,MAAM,OAAO,GAAG,kBAAkB,CAAC,yBAAyB,EAAE,CAAA;YAC9D,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;YAE9C,gBAAgB;YAChB,MAAM,WAAW,GAAG,kBAAkB,CAAC,YAAY,CAAC;gBAClD,IAAI,EAAE,kBAAkB;aACzB,CAAC,CAAA;YACF,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;YAEzE,cAAc;YACd,MAAM,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,CAAA;YAC/C,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;YAEnD,OAAO,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAA;QACpE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,CAAC,QAAQ,EAAE,CAAA;IACpB,CAAC;CACF,CAAA"}

package/dist/devtools/src/import-guide.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Developer Guidance Tools for Optimal TachUI Imports
+ *
+ * Provides interactive guidance and documentation for optimal import patterns
+ */
+export interface ImportGuidanceRule {
+    pattern: RegExp;
+    recommendation: string;
+    example: string;
+    bundleImpact: string;
+    category: 'layout' | 'reactive' | 'display' | 'effects' | 'forms' | 'navigation';
+}
+export interface ImportGuide {
+    title: string;
+    description: string;
+    rules: ImportGuidanceRule[];
+    examples: {
+        good: string[];
+        avoid: string[];
+    };
+}
+export declare class ImportGuidanceSystem {
+    private guides;
+    constructor();
+    private initializeGuides;
+    /**
+     * Get import guidance for specific imports
+     */
+    getGuidance(importPath: string, namedImports?: string[]): ImportGuidanceRule[];
+    /**
+     * Generate import documentation for a specific package
+     */
+    generatePackageGuide(packageName: string): string;
+    /**
+     * Interactive import helper for CLI
+     */
+    getInteractiveRecommendations(imports: string[]): Promise<{
+        recommendations: string[];
+        potentialSavings: string;
+    }>;
+    /**
+     * Generate import cheat sheet
+     */
+    generateCheatSheet(): string;
+}
+/**
+ * Console utility for development guidance
+ */
+export declare function logImportGuidance(importPath: string, namedImports?: string[]): void;
+//# sourceMappingURL=import-guide.d.ts.map

package/dist/devtools/src/import-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-guide.d.ts","sourceRoot":"","sources":["../../../../devtools/src/import-guide.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EACJ,QAAQ,GACR,UAAU,GACV,SAAS,GACT,SAAS,GACT,OAAO,GACP,YAAY,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,kBAAkB,EAAE,CAAA;IAC3B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,EAAE,CAAA;QACd,KAAK,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;CACF;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAsC;;IAMpD,OAAO,CAAC,gBAAgB;IA+GxB;;OAEG;IACH,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAM,EAAO,GAC1B,kBAAkB,EAAE;IAiBvB;;OAEG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAwBjD;;OAEG;IACG,6BAA6B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9D,eAAe,EAAE,MAAM,EAAE,CAAA;QACzB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAC;IAsBF;;OAEG;IACH,kBAAkB,IAAI,MAAM;CA6D7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAM,EAAO,QAoB5B"}