@tachui/cli 0.8.10-alpha.0 → 0.8.12

package/dist/core/src/runtime/dom-bridge.js

@@ -0,0 +1,481 @@
+/**
+ * DOM Rendering Bridge Layer
+ *
+ * Critical missing piece that connects TachUI components to actual DOM rendering.
+ * This bridges the gap between component instances and browser DOM elements.
+ */
+import { createRoot as createReactiveRoot, getOwner } from '../reactive';
+import { ComponentContextSymbol, createComponentContext, setCurrentComponentContext, } from './component-context';
+import { DOMRenderer } from './renderer';
+/**
+ * Global DOM renderer instance
+ */
+const globalRenderer = new DOMRenderer();
+/**
+ * Component mounting registry to track mounted components
+ */
+const mountedComponents = new Map();
+const componentElements = new Map();
+/**
+ * Track component instances with lifecycle hooks for processing
+ */
+const componentsWithLifecycleHooks = new Set();
+/**
+ * Register a component that has lifecycle hooks for later processing
+ */
+export function registerComponentWithLifecycleHooks(component) {
+    if (component._enhancedLifecycle) {
+        componentsWithLifecycleHooks.add(component);
+    }
+}
+/**
+ * Process pending lifecycle hooks for components that were rendered but not mounted
+ */
+function processPendingLifecycleHooks() {
+    for (const component of componentsWithLifecycleHooks) {
+        const enhancedLifecycle = component._enhancedLifecycle;
+        if (enhancedLifecycle && !component.domReady) {
+            // Find DOM elements associated with this component by searching the DOM
+            const elements = findDOMElementsForComponent(component);
+            if (elements.length > 0) {
+                // Set up DOM tracking
+                component.domElements = new Map();
+                elements.forEach((element, index) => {
+                    const key = element.id || `element-${index}`;
+                    component.domElements.set(key, element);
+                    if (!component.primaryElement) {
+                        component.primaryElement = element;
+                    }
+                });
+                component.domReady = true;
+                // Process lifecycle hooks
+                if (enhancedLifecycle.onDOMReady) {
+                    const cleanup = enhancedLifecycle.onDOMReady(component.domElements, component.primaryElement);
+                    if (typeof cleanup === 'function') {
+                        component.cleanup = component.cleanup || [];
+                        component.cleanup.push(cleanup);
+                    }
+                }
+                if (enhancedLifecycle.onMount) {
+                    const cleanup = enhancedLifecycle.onMount();
+                    if (typeof cleanup === 'function') {
+                        component.cleanup = component.cleanup || [];
+                        component.cleanup.push(cleanup);
+                    }
+                }
+            }
+        }
+    }
+    // Clear the set of processed components
+    componentsWithLifecycleHooks.clear();
+}
+/**
+ * Find DOM elements associated with a component by searching the DOM
+ * This is a fallback method for components that were rendered but not mounted
+ */
+function findDOMElementsForComponent(component) {
+    // First, check if component already has DOM elements from normal mounting
+    const existingElements = componentElements.get(component);
+    if (existingElements && existingElements.length > 0) {
+        return existingElements;
+    }
+    // Fallback: Search for DOM elements by component ID or data attributes
+    const elementsWithComponentId = document.querySelectorAll(`[data-component-id="${component.id}"]`);
+    if (elementsWithComponentId.length > 0) {
+        return Array.from(elementsWithComponentId);
+    }
+    // Type-specific fallbacks for components that might not have proper ID tracking
+    if (component.id.startsWith('image-')) {
+        const allImages = document.querySelectorAll('img.tachui-image');
+        // Filter to only unassociated images to prevent stealing from other components
+        return Array.from(allImages).filter(img => !Array.from(componentElements.values()).flat().includes(img));
+    }
+    if (component.id.startsWith('text-')) {
+        const allTextElements = document.querySelectorAll('.tachui-text');
+        return Array.from(allTextElements).filter(el => !Array.from(componentElements.values()).flat().includes(el));
+    }
+    if (component.id.startsWith('vstack-') || component.id.startsWith('hstack-')) {
+        const allStackElements = document.querySelectorAll('.tachui-vstack, .tachui-hstack');
+        return Array.from(allStackElements).filter(el => !Array.from(componentElements.values()).flat().includes(el));
+    }
+    // No elements found
+    return [];
+}
+/**
+ * Create a reactive root that can mount component trees to DOM.
+ *
+ * This is the application-level mounting function for TachUI apps.
+ * It creates a reactive context and mounts your component tree to the DOM.
+ *
+ * @param rootFunction - Function that returns the root component of your app
+ *
+ * @example
+ * ```typescript
+ * import { mountRoot } from '@tachui/core'
+ * import { MyApp } from './MyApp'
+ *
+ * mountRoot(() => MyApp())
+ * ```
+ *
+ * Note: This requires a DOM element with id="app" to exist.
+ */
+export function mountRoot(rootFunction) {
+    createReactiveRoot(dispose => {
+        // Create root component context for State() to work throughout the entire app
+        const rootContext = createComponentContext('root-app');
+        setCurrentComponentContext(rootContext);
+        // Also store context in reactive owner so State() can find it
+        const owner = getOwner();
+        if (owner) {
+            owner.context.set(ComponentContextSymbol, rootContext);
+        }
+        let component;
+        try {
+            component = rootFunction();
+            // Find app container
+            const container = document.getElementById('app');
+            if (!container) {
+                throw new Error('App container element with id="app" not found');
+            }
+            // Mount the component tree to the container
+            mountComponentTree(component, container);
+        }
+        catch (error) {
+            // Reset context on error
+            setCurrentComponentContext(null);
+            if (owner) {
+                owner.context.delete(ComponentContextSymbol);
+            }
+            throw error;
+        }
+        // Set up cleanup that resets context when the root is disposed
+        const originalDispose = dispose;
+        return () => {
+            setCurrentComponentContext(null);
+            if (owner) {
+                owner.context.delete(ComponentContextSymbol);
+            }
+            return originalDispose();
+        };
+    });
+}
+/**
+ * Mount a component tree to a DOM container
+ */
+export function mountComponentTree(component, container, clearContainer = true) {
+    try {
+        // Clear container only if requested (typically only for root components)
+        if (clearContainer) {
+            container.innerHTML = '';
+        }
+        // Render component to DOM nodes - auto-build if it's a ModifierBuilder
+        let componentToRender = component;
+        if ('build' in component && typeof component.build === 'function') {
+            // This is a ModifierBuilder that hasn't been built yet - build it automatically
+            componentToRender = component.build();
+        }
+        const domNodes = componentToRender.render();
+        const nodeArray = Array.isArray(domNodes) ? domNodes : [domNodes];
+        // Convert DOM nodes to actual DOM elements
+        const elements = [];
+        for (const node of nodeArray) {
+            const element = globalRenderer.render(node, container);
+            if (element instanceof DocumentFragment) {
+                // Handle fragments by adding all child nodes
+                const children = Array.from(element.childNodes);
+                for (const child of children) {
+                    if (child instanceof Element) {
+                        elements.push(child);
+                        container.appendChild(child);
+                    }
+                }
+            }
+            else if (element instanceof Element) {
+                elements.push(element);
+                container.appendChild(element);
+            }
+        }
+        // ENHANCED: Set up DOM element tracking for lifecycle hooks
+        if (elements.length > 0) {
+            component.domElements = new Map();
+            elements.forEach((element, index) => {
+                const key = element.id || `element-${index}`;
+                component.domElements.set(key, element);
+                // Enhanced: Add component ID to DOM element for proper cleanup tracking
+                if (element instanceof HTMLElement) {
+                    element._componentId = component.id;
+                }
+                // Set primary element (first element with ID or index 0)
+                if (!component.primaryElement) {
+                    component.primaryElement = element;
+                }
+            });
+            // Mark DOM as ready
+            component.domReady = true;
+            // ENHANCED: Trigger onDOMReady with guaranteed DOM elements
+            const enhancedLifecycle = component._enhancedLifecycle;
+            if (enhancedLifecycle?.onDOMReady) {
+                const cleanup = enhancedLifecycle.onDOMReady(component.domElements, component.primaryElement);
+                if (typeof cleanup === 'function') {
+                    component.cleanup = component.cleanup || [];
+                    component.cleanup.push(cleanup);
+                }
+            }
+            // Trigger legacy onMount for backwards compatibility
+            if (enhancedLifecycle?.onMount) {
+                const cleanup = enhancedLifecycle.onMount();
+                if (typeof cleanup === 'function') {
+                    component.cleanup = component.cleanup || [];
+                    component.cleanup.push(cleanup);
+                }
+            }
+        }
+        // ARCHITECTURAL FIX: Removed duplicate modifier application
+        // Modifiers are now handled exclusively by the renderer during element creation
+        // This eliminates the dangerous dual-system approach that was causing conflicts
+        // Bind event handlers
+        for (const element of elements) {
+            bindEventHandlers(element, component);
+        }
+        // REMOVED: Recursive child mounting - children are rendered as part of parent's render() method
+        // This was causing duplicate mounting where child components were being mounted individually
+        // instead of being rendered as part of their parent's DOM structure
+        const childCleanupFunctions = [];
+        // Register component
+        mountedComponents.set(container, component);
+        componentElements.set(component, elements);
+        component.mounted = true;
+        // Process any pending lifecycle hooks for components that were rendered but not mounted
+        // Execute synchronously to stay within the reactive update cycle
+        processPendingLifecycleHooks();
+        // Return cleanup function
+        return () => {
+            // Clean up child components first
+            childCleanupFunctions.forEach(cleanup => cleanup());
+            // Then clean up this component
+            unmountComponentEnhanced(component, container);
+        };
+    }
+    catch (error) {
+        // ENHANCED: Better error handling with DOM context
+        const domError = Object.assign(new Error(), error, {
+            code: 'MOUNT_FAILED',
+            context: 'mountComponentTree',
+        });
+        const enhancedLifecycle = component._enhancedLifecycle;
+        if (enhancedLifecycle?.onDOMError) {
+            enhancedLifecycle.onDOMError(domError, 'mount');
+        }
+        else if (enhancedLifecycle?.onError) {
+            enhancedLifecycle.onError(domError);
+        }
+        else {
+            console.error('Failed to mount component tree:', error);
+        }
+        throw error;
+    }
+}
+/**
+ * Unmount a component from DOM
+ */
+export function unmountComponent(component, container) {
+    const elements = componentElements.get(component);
+    if (elements) {
+        elements.forEach(element => {
+            if (element.parentNode) {
+                element.parentNode.removeChild(element);
+            }
+        });
+        componentElements.delete(component);
+    }
+    mountedComponents.delete(container);
+    component.mounted = false;
+    // Run cleanup functions
+    if (component.cleanup) {
+        component.cleanup.forEach(cleanup => cleanup());
+        component.cleanup = [];
+    }
+}
+/**
+ * Enhanced unmount component with lifecycle hooks
+ */
+export function unmountComponentEnhanced(component, container) {
+    try {
+        // Trigger onUnmount lifecycle
+        const enhancedLifecycle = component._enhancedLifecycle;
+        if (enhancedLifecycle?.onUnmount) {
+            enhancedLifecycle.onUnmount();
+        }
+        // Run cleanup functions
+        if (component.cleanup) {
+            component.cleanup.forEach(cleanup => {
+                try {
+                    cleanup();
+                }
+                catch (error) {
+                    console.error(`Cleanup error for component ${component.id}:`, error);
+                }
+            });
+            component.cleanup = [];
+        }
+        // Remove DOM elements
+        const elements = componentElements.get(component);
+        if (elements) {
+            elements.forEach(element => {
+                if (element.parentNode) {
+                    element.parentNode.removeChild(element);
+                }
+            });
+            componentElements.delete(component);
+        }
+        // Clear enhanced DOM tracking
+        if (component.domElements) {
+            // Clean up component ID references from DOM elements
+            for (const element of component.domElements.values()) {
+                if (element instanceof HTMLElement) {
+                    delete element._componentId;
+                }
+            }
+            component.domElements.clear();
+        }
+        // Clear references
+        component.primaryElement = undefined;
+        component.domReady = false;
+        component.mounted = false;
+        mountedComponents.delete(container);
+    }
+    catch (error) {
+        const domError = Object.assign(new Error(), error, {
+            code: 'UNMOUNT_FAILED',
+            context: 'unmountComponentEnhanced',
+        });
+        const enhancedLifecycle = component._enhancedLifecycle;
+        if (enhancedLifecycle?.onDOMError) {
+            enhancedLifecycle.onDOMError(domError, 'unmount');
+        }
+        else {
+            console.error('Component unmounting failed:', error);
+        }
+    }
+}
+/**
+ * Bind component event handlers to DOM events
+ */
+function bindEventHandlers(element, component) {
+    const htmlElement = element;
+    // Handle component-level events from props
+    if (component.props) {
+        const props = component.props;
+        // Bind common event handlers
+        if (props.onClick && typeof props.onClick === 'function') {
+            htmlElement.addEventListener('click', props.onClick);
+        }
+        if (props.onMouseEnter && typeof props.onMouseEnter === 'function') {
+            htmlElement.addEventListener('mouseenter', props.onMouseEnter);
+        }
+        if (props.onMouseLeave && typeof props.onMouseLeave === 'function') {
+            htmlElement.addEventListener('mouseleave', props.onMouseLeave);
+        }
+        if (props.onFocus && typeof props.onFocus === 'function') {
+            htmlElement.addEventListener('focus', props.onFocus);
+        }
+        if (props.onBlur && typeof props.onBlur === 'function') {
+            htmlElement.addEventListener('blur', props.onBlur);
+        }
+    }
+    // Handle modifier-based events if this is a modifiable component
+    if (isModifiableComponent(component) && component.modifiers) {
+        for (const modifier of component.modifiers) {
+            if (modifier && 'eventHandlers' in modifier && modifier.eventHandlers) {
+                for (const [eventType, handler] of Object.entries(modifier.eventHandlers)) {
+                    if (typeof handler === 'function') {
+                        htmlElement.addEventListener(eventType, handler);
+                    }
+                }
+            }
+        }
+    }
+}
+/**
+ * Type guard to check if component is modifiable
+ */
+function isModifiableComponent(component) {
+    return (component &&
+        typeof component === 'object' &&
+        ('modifiers' in component || 'modifier' in component));
+}
+/**
+ * Recursively mount component children
+ */
+export function mountComponentChildren(children, container) {
+    const cleanupFunctions = [];
+    for (const child of children) {
+        const childCleanup = mountComponentTree(child, container);
+        cleanupFunctions.push(childCleanup);
+    }
+    return cleanupFunctions;
+}
+/**
+ * Update a mounted component with new props
+ */
+export function updateComponent(component, newProps) {
+    const elements = componentElements.get(component);
+    if (!elements) {
+        console.warn('Attempted to update unmounted component');
+        return;
+    }
+    // Update props
+    component.prevProps = component.props;
+    component.props = { ...component.props, ...newProps };
+    // Re-render if needed
+    const container = elements[0]?.parentElement;
+    if (container) {
+        unmountComponent(component, container);
+        mountComponentTree(component, container);
+    }
+}
+/**
+ * Get mounted component from DOM element
+ */
+export function getComponentFromElement(element) {
+    let current = element;
+    while (current) {
+        const component = mountedComponents.get(current);
+        if (component) {
+            return component;
+        }
+        current = current.parentElement;
+    }
+    return undefined;
+}
+/**
+ * Debug utilities for DOM bridge
+ */
+export const DOMBridgeDebug = {
+    getMountedComponents: () => Array.from(mountedComponents.entries()),
+    getComponentElements: (component) => componentElements.get(component),
+    isComponentMounted: (component) => component.mounted || false,
+    /**
+     * Validate that all components are properly mounted
+     */
+    validateMounting() {
+        const issues = [];
+        for (const [container, component] of mountedComponents.entries()) {
+            if (!document.contains(container)) {
+                issues.push(`Container for component ${component.id} is not in DOM`);
+            }
+            if (!component.mounted) {
+                issues.push(`Component ${component.id} marked as unmounted but still registered`);
+            }
+            const elements = componentElements.get(component);
+            if (!elements || elements.length === 0) {
+                issues.push(`Component ${component.id} has no associated DOM elements`);
+            }
+        }
+        return {
+            valid: issues.length === 0,
+            issues,
+        };
+    },
+};
+//# sourceMappingURL=dom-bridge.js.map

package/dist/core/src/runtime/dom-bridge.js.map

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

package/dist/core/src/runtime/element-override.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Element Override System - Tag Specification Enhancement
+ *
+ * Enables components to override their default HTML tags for semantic markup,
+ * improving SEO and accessibility while preserving all styling and functionality.
+ */
+export interface ElementOverrideProps {
+    element?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    warnings?: Warning[];
+    severity?: 'error' | 'warning' | 'info';
+    warning?: string;
+    semanticRole?: SemanticRoleInfo;
+}
+export interface Warning {
+    message: string;
+    severity: 'error' | 'warning' | 'info';
+}
+export interface SemanticRoleInfo {
+    role: string;
+    applyARIA: boolean;
+}
+export interface ElementOverrideConfig {
+    autoApplySemanticRoles: boolean;
+    warnOnOverrides: boolean;
+    warnOnSemanticIssues: boolean;
+    validateTags: boolean;
+    allowInvalidTags: boolean;
+}
+export declare const VALID_HTML_TAGS: Set<string>;
+export declare const SEMANTIC_TAG_ROLES: Map<string, SemanticRoleInfo>;
+/**
+ * Component Eligibility Matrix - Warning Levels
+ * Based on design/Enh-TagSpecification.md Component Eligibility Matrix
+ */
+export declare const COMPONENT_ELIGIBILITY: Map<string, {
+    warningLevel: "none" | "info" | "warning";
+    idealTags?: string[];
+    problematicTags?: string[];
+}>;
+/**
+ * Check if an element override should show a warning based on component eligibility matrix
+ */
+export declare function shouldWarnOnOverride(componentType: string, tag: string): boolean;
+/**
+ * The applyARIA flag controls whether the framework automatically adds
+ * the corresponding ARIA role attribute to elements with semantic tags.
+ *
+ * applyARIA: true  - Always add the ARIA role (e.g., <nav> gets role="navigation")
+ * applyARIA: false - Don't automatically add ARIA role due to context sensitivity
+ *
+ * Examples:
+ * - <nav> always represents navigation → applyARIA: true
+ * - <header> could be page banner OR section header → applyARIA: false
+ * - <footer> could be page footer OR article footer → applyARIA: false
+ *
+ * When applyARIA is false, developers should manually specify appropriate
+ * ARIA roles using the .aria() modifier when semantic meaning is ambiguous.
+ */
+export declare class ElementTagValidator {
+    static validate(tag: string, componentType: string): ValidationResult;
+    private static checkSemanticWarnings;
+}
+export declare function configureElementOverrides(config: Partial<ElementOverrideConfig>): void;
+export declare function getElementOverrideConfig(): ElementOverrideConfig;
+/**
+ * Process element override for a component with validation and warnings
+ */
+export declare function processElementOverride(componentType: string, defaultTag: string, overrideTag?: string): {
+    tag: string;
+    validation: ValidationResult;
+};
+/**
+ * Create element override validation helper for components
+ */
+export declare function createElementOverrideValidator(componentType: string, defaultTag: string): (overrideTag?: string) => {
+    tag: string;
+    validation: ValidationResult;
+};
+//# sourceMappingURL=element-override.d.ts.map

package/dist/core/src/runtime/element-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-override.d.ts","sourceRoot":"","sources":["../../../../../core/src/runtime/element-override.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,gBAAgB,CAAA;CAChC;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IAEpC,sBAAsB,EAAE,OAAO,CAAA;IAG/B,eAAe,EAAE,OAAO,CAAA;IACxB,oBAAoB,EAAE,OAAO,CAAA;IAG7B,YAAY,EAAE,OAAO,CAAA;IACrB,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAGD,eAAO,MAAM,eAAe,aA6G1B,CAAA;AAEF,eAAO,MAAM,kBAAkB,+BAa7B,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB;kBAGhB,MAAM,GAAG,MAAM,GAAG,SAAS;gBAC7B,MAAM,EAAE;sBACF,MAAM,EAAE;EA0E5B,CAAA;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,OAAO,CAyBT;AAED;;;;;;;;;;;;;;GAcG;AAEH,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB;IA0BrE,OAAO,CAAC,MAAM,CAAC,qBAAqB;CA0DrC;AAWD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACrC,IAAI,CAEN;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAqC/C;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,IAEV,cAAc,MAAM;SA9CpB,MAAM;gBAAc,gBAAgB;EAgD7C"}