@tachui/cli 0.8.0-alpha → 0.8.5-alpha

package/dist/devtools/src/debug/debug.js

@@ -0,0 +1,239 @@
+/**
+ * TachUI Debug System
+ *
+ * Provides visual debugging tools for component hierarchy and layout
+ */
+class DebugManager {
+    config = {
+        enabled: false,
+        showLabels: false,
+        showBounds: false,
+        logComponentTree: false,
+    };
+    componentTree = [];
+    /**
+     * Enable debug mode with optional configuration
+     */
+    enable(options = {}) {
+        this.config = {
+            enabled: true,
+            showLabels: true,
+            showBounds: true,
+            logComponentTree: true,
+            ...options,
+        };
+        if (this.config.enabled) {
+            this.injectDebugStyles();
+            // Only log in development mode
+            if (typeof import.meta !== 'undefined' && import.meta.env?.DEV) {
+                console.log('🔧 TachUI Debug Mode Enabled');
+            }
+        }
+    }
+    /**
+     * Disable debug mode
+     */
+    disable() {
+        this.config.enabled = false;
+        this.removeDebugStyles();
+        if (typeof import.meta !== 'undefined' && import.meta.env?.DEV) {
+            console.log('🔧 TachUI Debug Mode Disabled');
+        }
+    }
+    /**
+     * Check if debug mode is enabled
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Get current debug configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Add debug attributes to DOM element
+     */
+    addDebugAttributes(element, componentType, debugLabel) {
+        if (!this.config.enabled)
+            return;
+        element.setAttribute('data-tachui-component', componentType);
+        if (debugLabel) {
+            element.setAttribute('data-tachui-label', debugLabel);
+        }
+        if (this.config.showLabels || this.config.showBounds) {
+            element.classList.add('tachui-debug');
+        }
+        if (this.config.showLabels && debugLabel) {
+            element.classList.add('tachui-debug-labeled');
+        }
+        if (this.config.showBounds) {
+            element.classList.add('tachui-debug-bounds');
+        }
+    }
+    /**
+     * Log component to tree (for hierarchical debugging)
+     */
+    logComponent(type, label, depth = 0) {
+        if (!this.config.enabled || !this.config.logComponentTree)
+            return;
+        this.componentTree.push({
+            label: label || `<${type}>`,
+            type,
+            depth,
+        });
+    }
+    /**
+     * Print component tree to console
+     */
+    printComponentTree() {
+        if (!this.config.enabled || !this.config.logComponentTree)
+            return;
+        console.group('🌳 TachUI Component Tree:');
+        this.componentTree.forEach(({ label, type, depth }) => {
+            const indent = '  '.repeat(depth);
+            const icon = this.getComponentIcon(type);
+            console.log(`${indent}${icon} ${type}: "${label}"`);
+        });
+        console.groupEnd();
+        // Clear tree for next render cycle
+        this.componentTree = [];
+    }
+    /**
+     * Get icon for component type
+     */
+    getComponentIcon(type) {
+        const icons = {
+            VStack: '📚',
+            HStack: '➡️',
+            ZStack: '📑',
+            Button: '🔘',
+            Text: '📝',
+            Image: '🖼️',
+            ScrollView: '📜',
+            List: '📋',
+            Form: '📋',
+            Section: '📁',
+            default: '🧩',
+        };
+        return icons[type] || icons.default;
+    }
+    /**
+     * Inject debug CSS styles
+     */
+    injectDebugStyles() {
+        if (document.getElementById('tachui-debug-styles'))
+            return;
+        const styles = `
+      /* TachUI Debug Styles */
+      .tachui-debug {
+        position: relative;
+      }
+
+      .tachui-debug-bounds {
+        outline: 1px dashed rgba(255, 0, 0, 0.3) !important;
+        outline-offset: -1px;
+      }
+
+      .tachui-debug-labeled::before {
+        content: attr(data-tachui-label);
+        position: absolute;
+        top: -1px;
+        left: -1px;
+        background: rgba(255, 0, 0, 0.9);
+        color: white;
+        font-family: 'Monaco', 'Menlo', 'Consolas', monospace;
+        font-size: 10px;
+        font-weight: bold;
+        line-height: 1;
+        padding: 2px 4px;
+        border-radius: 2px;
+        z-index: 9999;
+        pointer-events: none;
+        white-space: nowrap;
+        max-width: 200px;
+        overflow: hidden;
+        text-overflow: ellipsis;
+      }
+
+      .tachui-debug-labeled:hover::before {
+        background: rgba(255, 0, 0, 1);
+        max-width: none;
+        white-space: normal;
+      }
+
+      /* Component type indicators */
+      [data-tachui-component="VStack"] {
+        border-left: 2px solid rgba(0, 255, 0, 0.5) !important;
+      }
+
+      [data-tachui-component="HStack"] {
+        border-top: 2px solid rgba(0, 0, 255, 0.5) !important;
+      }
+
+      [data-tachui-component="Button"] {
+        box-shadow: inset 0 0 0 1px rgba(255, 165, 0, 0.5) !important;
+      }
+    `;
+        const styleElement = document.createElement('style');
+        styleElement.id = 'tachui-debug-styles';
+        styleElement.textContent = styles;
+        document.head.appendChild(styleElement);
+    }
+    /**
+     * Remove debug CSS styles
+     */
+    removeDebugStyles() {
+        const styleElement = document.getElementById('tachui-debug-styles');
+        if (styleElement) {
+            styleElement.remove();
+        }
+        // Remove debug classes from all elements
+        document.querySelectorAll('.tachui-debug').forEach(el => {
+            el.classList.remove('tachui-debug', 'tachui-debug-labeled', 'tachui-debug-bounds');
+        });
+    }
+}
+// Global debug instance
+export const debugManager = new DebugManager();
+// Convenience functions
+export const enableDebug = (options) => debugManager.enable(options);
+export const disableDebug = () => debugManager.disable();
+export const isDebugEnabled = () => debugManager.isEnabled();
+// Auto-enable debug mode based on URL parameters
+if (typeof window !== 'undefined') {
+    const urlParams = new URLSearchParams(window.location.search);
+    const debugParam = urlParams.get('debug');
+    if (debugParam === 'true' || debugParam === '1') {
+        // Enable full debug mode
+        debugManager.enable({
+            enabled: true,
+            showLabels: true,
+            showBounds: true,
+            logComponentTree: true,
+        });
+        console.log('🔧 TachUI Debug Mode: Enabled via URL parameter (?debug=true)');
+    }
+    else if (debugParam === 'labels') {
+        // Enable only labels
+        debugManager.enable({
+            enabled: true,
+            showLabels: true,
+            showBounds: false,
+            logComponentTree: false,
+        });
+        console.log('🔧 TachUI Debug Mode: Labels only (?debug=labels)');
+    }
+    else if (debugParam === 'bounds') {
+        // Enable only bounds
+        debugManager.enable({
+            enabled: true,
+            showLabels: false,
+            showBounds: true,
+            logComponentTree: false,
+        });
+        console.log('🔧 TachUI Debug Mode: Bounds only (?debug=bounds)');
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/devtools/src/debug/debug.js.map

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

package/dist/devtools/src/debug/development-warnings.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Development Warning System - Tag Override Safety
+ *
+ * Provides helpful console warnings during development when components
+ * use tag overrides, particularly for potentially problematic combinations.
+ */
+export declare class DevelopmentWarnings {
+    private static warningsShown;
+    /**
+     * Warn about element tag overrides in development
+     */
+    static warnElementOverride(componentType: string, originalTag: string, overrideTag: string): void;
+    /**
+     * Error for invalid HTML tags
+     */
+    static errorInvalidTag(tag: string, componentType: string): void;
+    /**
+     * Info message for semantic role application
+     */
+    static infoSemanticRole(tag: string, role: string): void;
+    /**
+     * Warn about potentially problematic tag combinations
+     */
+    static warnProblematicCombination(componentType: string, tag: string, issue: string, severity?: 'warning' | 'info'): void;
+    /**
+     * Warn about accessibility concerns
+     */
+    static warnAccessibility(componentType: string, tag: string, accessibilityIssue: string): void;
+    /**
+     * Clear all shown warnings (useful for testing)
+     */
+    static clearWarnings(): void;
+    /**
+     * Check if a warning has been shown
+     */
+    static hasWarningBeenShown(warningKey: string): boolean;
+    /**
+     * Get count of unique warnings shown
+     */
+    static getWarningCount(): number;
+}
+//# sourceMappingURL=development-warnings.d.ts.map

package/dist/devtools/src/debug/development-warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-warnings.d.ts","sourceRoot":"","sources":["../../../../../devtools/src/debug/development-warnings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAoB;IAEhD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CACxB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,IAAI;IAcP;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAShE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxD;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,SAAS,GAAG,MAAkB,GACvC,IAAI;IAYP;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,GACzB,IAAI;IAcP;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAIvD;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;CAGjC"}

package/dist/devtools/src/debug/development-warnings.js

@@ -0,0 +1,84 @@
+/**
+ * Development Warning System - Tag Override Safety
+ *
+ * Provides helpful console warnings during development when components
+ * use tag overrides, particularly for potentially problematic combinations.
+ */
+export class DevelopmentWarnings {
+    static warningsShown = new Set();
+    /**
+     * Warn about element tag overrides in development
+     */
+    static warnElementOverride(componentType, originalTag, overrideTag) {
+        if (process.env.NODE_ENV === 'production')
+            return;
+        const warningKey = `${componentType}-${originalTag}-${overrideTag}`;
+        if (this.warningsShown.has(warningKey))
+            return;
+        this.warningsShown.add(warningKey);
+        console.warn(`[tachUI] ${componentType} (${originalTag}) overridden to <${overrideTag}>. ` +
+            `Ensure this maintains expected behavior and accessibility.`);
+    }
+    /**
+     * Error for invalid HTML tags
+     */
+    static errorInvalidTag(tag, componentType) {
+        if (process.env.NODE_ENV === 'production')
+            return;
+        console.error(`[tachUI] Invalid HTML tag '${tag}' specified for ${componentType}. ` +
+            `Using tag as-is - ensure this is intentional.`);
+    }
+    /**
+     * Info message for semantic role application
+     */
+    static infoSemanticRole(tag, role) {
+        if (process.env.NODE_ENV !== 'development')
+            return;
+        console.info(`[tachUI] Applied semantic role '${role}' to <${tag}> element`);
+    }
+    /**
+     * Warn about potentially problematic tag combinations
+     */
+    static warnProblematicCombination(componentType, tag, issue, severity = 'warning') {
+        if (process.env.NODE_ENV === 'production')
+            return;
+        const warningKey = `${componentType}-${tag}-${issue}`;
+        if (this.warningsShown.has(warningKey))
+            return;
+        this.warningsShown.add(warningKey);
+        const logFunction = severity === 'warning' ? console.warn : console.info;
+        logFunction(`[tachUI] ${componentType}: ${issue}`);
+    }
+    /**
+     * Warn about accessibility concerns
+     */
+    static warnAccessibility(componentType, tag, accessibilityIssue) {
+        if (process.env.NODE_ENV === 'production')
+            return;
+        const warningKey = `a11y-${componentType}-${tag}-${accessibilityIssue}`;
+        if (this.warningsShown.has(warningKey))
+            return;
+        this.warningsShown.add(warningKey);
+        console.warn(`[tachUI A11y] ${componentType} with <${tag}>: ${accessibilityIssue}. ` +
+            `Consider using appropriate ARIA attributes or different semantic structure.`);
+    }
+    /**
+     * Clear all shown warnings (useful for testing)
+     */
+    static clearWarnings() {
+        this.warningsShown.clear();
+    }
+    /**
+     * Check if a warning has been shown
+     */
+    static hasWarningBeenShown(warningKey) {
+        return this.warningsShown.has(warningKey);
+    }
+    /**
+     * Get count of unique warnings shown
+     */
+    static getWarningCount() {
+        return this.warningsShown.size;
+    }
+}
+//# sourceMappingURL=development-warnings.js.map

package/dist/devtools/src/debug/development-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"development-warnings.js","sourceRoot":"","sources":["../../../../../devtools/src/debug/development-warnings.ts"],"names":[],"mappings":"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"}

package/dist/devtools/src/debug/enhanced-errors.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Enhanced Error Messages and Developer Experience
+ *
+ * Provides better error messages, debugging aids, and developer-friendly
+ * error reporting for the TachUI framework.
+ */
+import type { Modifier } from '@tachui/core';
+import type { ComponentInstance } from '@tachui/core';
+/**
+ * Enhanced error with developer-friendly context
+ */
+export interface EnhancedTachUIError extends Error {
+    code: string;
+    category: 'modifier' | 'component' | 'runtime' | 'reactive' | 'validation';
+    severity: 'warning' | 'error' | 'fatal';
+    component?: string;
+    suggestion: string;
+    documentation?: string;
+    examples?: string[];
+    relatedErrors?: string[];
+}
+/**
+ * Developer experience error factory
+ */
+export declare class DeveloperErrorFactory {
+    /**
+     * Create modifier validation error
+     */
+    static modifierValidationError(modifier: string, issue: string, component?: ComponentInstance): EnhancedTachUIError;
+    /**
+     * Create component validation error
+     */
+    static componentValidationError(componentType: string, prop: string, expectedType: string, actualValue: any): EnhancedTachUIError;
+    /**
+     * Create reactive system error
+     */
+    static reactiveSystemError(operation: string, issue: string, context?: string): EnhancedTachUIError;
+    /**
+     * Create runtime error
+     */
+    static runtimeError(operation: string, issue: string, component?: string): EnhancedTachUIError;
+    /**
+     * Get modifier-specific suggestion
+     */
+    private static getModifierSuggestion;
+    /**
+     * Get modifier examples
+     */
+    private static getModifierExamples;
+    /**
+     * Get component examples
+     */
+    private static getComponentExamples;
+    /**
+     * Get type conversion suggestion
+     */
+    private static getTypeConversionSuggestion;
+    /**
+     * Get reactive system suggestion
+     */
+    private static getReactiveSuggestion;
+    /**
+     * Get reactive examples
+     */
+    private static getReactiveExamples;
+    /**
+     * Get runtime suggestion
+     */
+    private static getRuntimeSuggestion;
+}
+/**
+ * Enhanced warning system
+ */
+export declare class DeveloperWarnings {
+    private static warningsSeen;
+    /**
+     * Warn about deprecated API usage
+     */
+    static deprecation(oldAPI: string, newAPI: string, component?: string, willBeRemovedIn?: string): void;
+    /**
+     * Warn about performance issues
+     */
+    static performance(issue: string, suggestion: string, component?: string): void;
+    /**
+     * Warn about accessibility issues
+     */
+    static accessibility(issue: string, suggestion: string, component?: string): void;
+    /**
+     * Clear warning cache (for testing)
+     */
+    static clearWarnings(): void;
+    /**
+     * Get count of unique warnings shown
+     */
+    static getWarningCount(): number;
+}
+/**
+ * Type validation helpers
+ */
+export declare class TypeValidation {
+    /**
+     * Validate component props with enhanced error messages
+     */
+    static validateComponentProps<T extends Record<string, any>>(componentType: string, props: T, schema: Record<keyof T, {
+        type: string;
+        required?: boolean;
+        validator?: (value: any) => boolean;
+        message?: string;
+    }>): void;
+    /**
+     * Validate type
+     */
+    private static validateType;
+    /**
+     * Validate modifier combination
+     */
+    static validateModifierCombination(modifiers: Modifier[]): void;
+}
+/**
+ * Formatted error message type
+ */
+export interface FormattedErrorMessage {
+    code: string;
+    message: string;
+    suggestion: string;
+    severity: 'warning' | 'error' | 'fatal';
+    component?: string;
+    documentation?: string;
+    examples?: string[];
+    template?: {
+        severity: string;
+        message: string;
+    };
+    error?: {
+        message: string;
+    };
+}
+/**
+ * Developer experience utilities
+ */
+export declare class DeveloperExperienceUtils {
+    /**
+     * Format error message for better developer experience
+     */
+    static formatError(error: EnhancedTachUIError): FormattedErrorMessage;
+    /**
+     * Get statistics about developer experience features
+     */
+    static getStatistics(): {
+        errorCount: number;
+        warningCount: number;
+        suggestionCount: number;
+    };
+    /**
+     * Get suggestions for a diagnostic
+     */
+    static getSuggestions(_code: string, _data?: any): any[];
+    /**
+     * Test developer experience features
+     */
+    static test(): Promise<void>;
+}
+/**
+ * Development mode utilities
+ */
+export declare const devMode: {
+    /**
+     * Enable enhanced error reporting in development
+     */
+    enableEnhancedErrors(): void;
+    /**
+     * Log component tree for debugging
+     */
+    logComponentTree(root: any, depth?: number): void;
+};
+//# sourceMappingURL=enhanced-errors.d.ts.map

package/dist/devtools/src/debug/enhanced-errors.d.ts.map

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