@tachui/cli 0.8.0-alpha → 0.8.5-alpha

package/dist/core/src/runtime/props.js

@@ -0,0 +1,389 @@
+/**
+ * Props and Children Handling System (Phase 3.1.2)
+ *
+ * Type-safe props system with reactive updates, children handling,
+ * and component composition patterns.
+ */
+import { createComputed, createEffect, createSignal } from '../reactive';
+/**
+ * Props manager for handling component props reactively
+ */
+export class PropsManager {
+    validator;
+    propsSignal;
+    childrenSignal;
+    changedKeys = new Set();
+    constructor(initialProps, validator) {
+        this.validator = validator;
+        // Create reactive signals for props and children
+        this.propsSignal = createSignal(this.validateAndMergeProps(initialProps));
+        this.childrenSignal = createSignal(initialProps.children);
+        // Track prop changes
+        createEffect(() => {
+            const props = this.propsSignal[0]();
+            this.trackChanges(props);
+        });
+    }
+    /**
+     * Get current props reactively
+     */
+    getProps() {
+        return this.propsSignal[0]();
+    }
+    /**
+     * Update props with validation and change detection
+     */
+    setProps(newProps) {
+        const currentProps = this.propsSignal[0]();
+        const mergedProps = { ...currentProps, ...newProps };
+        const validatedProps = this.validateAndMergeProps(mergedProps);
+        // Track which keys changed
+        this.changedKeys.clear();
+        Object.keys(newProps).forEach((key) => {
+            if (currentProps[key] !== newProps[key]) {
+                this.changedKeys.add(key);
+            }
+        });
+        this.propsSignal[1](validatedProps);
+        // Update children separately if it changed
+        if (newProps.children !== undefined) {
+            this.childrenSignal[1](newProps.children);
+        }
+    }
+    /**
+     * Get current children reactively
+     */
+    getChildren() {
+        return this.childrenSignal[0]();
+    }
+    /**
+     * Set children directly
+     */
+    setChildren(children) {
+        this.childrenSignal[1](children);
+    }
+    /**
+     * Get keys that changed in last update
+     */
+    getChangedKeys() {
+        return Array.from(this.changedKeys);
+    }
+    /**
+     * Create reactive computed for a specific prop
+     */
+    createPropComputed(key) {
+        return createComputed(() => this.getProps()[key]);
+    }
+    /**
+     * Create effect that runs when specific props change
+     */
+    createPropsEffect(keys, effect) {
+        const effectComputation = createEffect(() => {
+            const props = this.getProps();
+            const changed = this.getChangedKeys();
+            // Check if any of the specified keys changed or it's the first run
+            const hasChanges = changed.length === 0 || keys.some((key) => changed.includes(key));
+            if (hasChanges) {
+                effect(props, changed.filter((key) => keys.includes(key)));
+            }
+        });
+        return () => effectComputation.dispose();
+    }
+    validateAndMergeProps(props) {
+        let validatedProps = props;
+        // Apply defaults
+        if (this.validator?.defaults) {
+            validatedProps = { ...this.validator.defaults, ...props };
+        }
+        // Validate required props
+        if (this.validator?.required) {
+            for (const key of this.validator.required) {
+                if (validatedProps[key] === undefined || validatedProps[key] === null) {
+                    throw new Error(`Required prop '${String(key)}' is missing`);
+                }
+            }
+        }
+        // Run custom validator
+        if (this.validator?.validator) {
+            const result = this.validator.validator(validatedProps);
+            if (typeof result === 'string') {
+                throw new Error(`Props validation failed: ${result}`);
+            }
+            else if (result === false) {
+                throw new Error('Props validation failed');
+            }
+        }
+        return validatedProps;
+    }
+    trackChanges(_props) {
+        // This will be called reactively when props change
+        // Additional change tracking logic can be added here
+    }
+}
+/**
+ * Children manager for handling component composition
+ */
+export class ChildrenManager {
+    childrenSignal;
+    constructor(initialChildren = null) {
+        this.childrenSignal = createSignal(initialChildren);
+    }
+    /**
+     * Get current children reactively
+     */
+    getChildren() {
+        return this.childrenSignal[0]();
+    }
+    /**
+     * Set new children
+     */
+    setChildren(children) {
+        this.childrenSignal[1](children);
+    }
+    /**
+     * Render children to DOM nodes
+     */
+    renderChildren() {
+        const children = this.getChildren();
+        return this.renderChildrenArray(Array.isArray(children) ? children : [children]);
+    }
+    /**
+     * Create fragment with multiple children
+     */
+    createFragment(children) {
+        return { children };
+    }
+    /**
+     * Map children with a function
+     */
+    mapChildren(mapper) {
+        const children = this.getChildren();
+        const childArray = Array.isArray(children) ? children : [children];
+        return childArray.map(mapper);
+    }
+    /**
+     * Filter children
+     */
+    filterChildren(predicate) {
+        const children = this.getChildren();
+        const childArray = Array.isArray(children) ? children : [children];
+        return childArray.filter(predicate);
+    }
+    /**
+     * Count non-null children
+     */
+    countChildren() {
+        const children = this.getChildren();
+        if (children === null || children === undefined)
+            return 0;
+        if (Array.isArray(children)) {
+            return children.filter((child) => child !== null && child !== undefined).length;
+        }
+        return 1;
+    }
+    renderChildrenArray(children) {
+        const nodes = [];
+        for (const child of children) {
+            if (child === null || child === undefined) {
+                continue;
+            }
+            if (typeof child === 'string' || typeof child === 'number') {
+                nodes.push({
+                    type: 'text',
+                    text: String(child),
+                });
+            }
+            else if (typeof child === 'boolean') {
+            }
+            else if (typeof child === 'function') {
+                // Render function children
+                const result = child();
+                if (Array.isArray(result)) {
+                    nodes.push(...result);
+                }
+                else {
+                    nodes.push(result);
+                }
+            }
+            else if (Array.isArray(child)) {
+                // Nested array of children
+                nodes.push(...this.renderChildrenArray(child));
+            }
+            else if (isModifierBuilder(child)) {
+                // ModifierBuilder - build before rendering so auto-build logic always runs
+                const builtChild = child.build();
+                const result = builtChild.render();
+                if (Array.isArray(result)) {
+                    nodes.push(...result);
+                }
+                else {
+                    nodes.push(result);
+                }
+            }
+            else if (typeof child === 'object' && child !== null && 'render' in child) {
+                // Component instance - auto-build if it still exposes ModifierBuilder API
+                let componentToRender = child;
+                if ('build' in child && typeof child.build === 'function') {
+                    componentToRender = child.build();
+                }
+                const result = componentToRender.render();
+                if (Array.isArray(result)) {
+                    nodes.push(...result);
+                }
+                else {
+                    nodes.push(result);
+                }
+            }
+        }
+        return nodes;
+    }
+}
+/**
+ * Ref manager for component references
+ */
+export class RefManager {
+    ref;
+    constructor(initialValue = null) {
+        this.ref = { current: initialValue };
+    }
+    /**
+     * Get the ref object
+     */
+    getRef() {
+        return this.ref;
+    }
+    /**
+     * Set ref value
+     */
+    setValue(value) {
+        this.ref.current = value;
+    }
+    /**
+     * Get current ref value
+     */
+    getValue() {
+        return this.ref.current;
+    }
+    /**
+     * Apply ref (handle both ref objects and callback refs)
+     */
+    static applyRef(ref, value) {
+        if (!ref)
+            return;
+        if (typeof ref === 'function') {
+            // Callback ref
+            ref(value);
+        }
+        else if (typeof ref === 'object' && ref !== null) {
+            // Ref object
+            ref.current = value;
+        }
+    }
+    /**
+     * Create a new ref
+     */
+    static createRef(initialValue = null) {
+        return { current: initialValue };
+    }
+    /**
+     * Forward ref to another component
+     */
+    static forwardRef(render) {
+        return (props) => {
+            const { ref, ...restProps } = props;
+            return render(restProps, ref || undefined);
+        };
+    }
+}
+/**
+ * Create props manager with validation
+ */
+export function createPropsManager(initialProps, validation) {
+    return new PropsManager(initialProps, validation);
+}
+/**
+ * Create children manager
+ */
+export function createChildrenManager(initialChildren) {
+    return new ChildrenManager(initialChildren);
+}
+function isModifierBuilder(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const hasBuild = 'build' in value && typeof value.build === 'function';
+    if (!hasBuild) {
+        return false;
+    }
+    const hasRender = 'render' in value && typeof value.render === 'function';
+    return !hasRender;
+}
+/**
+ * Create ref manager
+ */
+export function createRefManager(initialValue) {
+    return new RefManager(initialValue);
+}
+/**
+ * Utility functions for props handling
+ */
+export const propsUtils = {
+    /**
+     * Compare props for changes
+     */
+    compareProps(prevProps, nextProps) {
+        const changedKeys = [];
+        // Check all keys from both objects
+        const allKeys = new Set([...Object.keys(prevProps), ...Object.keys(nextProps)]);
+        for (const key of allKeys) {
+            if (prevProps[key] !== nextProps[key]) {
+                changedKeys.push(key);
+            }
+        }
+        return changedKeys;
+    },
+    /**
+     * Shallow compare props
+     */
+    shallowEqual(prevProps, nextProps) {
+        const prevKeys = Object.keys(prevProps);
+        const nextKeys = Object.keys(nextProps);
+        if (prevKeys.length !== nextKeys.length) {
+            return false;
+        }
+        for (const key of prevKeys) {
+            if (prevProps[key] !== nextProps[key]) {
+                return false;
+            }
+        }
+        return true;
+    },
+    /**
+     * Pick specific props
+     */
+    pickProps(props, keys) {
+        const picked = {};
+        for (const key of keys) {
+            picked[key] = props[key];
+        }
+        return picked;
+    },
+    /**
+     * Omit specific props
+     */
+    omitProps(props, keys) {
+        const omitted = { ...props };
+        for (const key of keys) {
+            delete omitted[key];
+        }
+        return omitted;
+    },
+};
+/**
+ * Default children renderer
+ */
+export const defaultChildrenRenderer = (children) => {
+    const manager = new ChildrenManager(children);
+    return manager.renderChildren();
+};
+//# sourceMappingURL=props.js.map

package/dist/core/src/runtime/props.js.map

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

package/dist/core/src/runtime/renderer.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Direct DOM Renderer (Phase 3.1.1)
+ *
+ * Efficient DOM manipulation without virtual DOM overhead.
+ * Provides surgical DOM updates integrated with the reactive system.
+ */
+import type { ComponentInstance, DOMNode } from './types';
+/**
+ * Direct DOM renderer for efficient DOM manipulation
+ */
+type RendererMetrics = {
+    created: number;
+    adopted: number;
+    removed: number;
+    inserted: number;
+    moved: number;
+    cacheHits: number;
+    cacheMisses: number;
+    attributeWrites: number;
+    attributeRemovals: number;
+    textUpdates: number;
+    modifierApplications: number;
+};
+export declare class DOMRenderer {
+    private nodeMap;
+    private cleanupMap;
+    private renderedNodes;
+    private elementToContainer;
+    private metrics;
+    /**
+     * Render a DOM node to an actual DOM element
+     */
+    render(node: DOMNode | DOMNode[], container?: Element): Element | Text | Comment | DocumentFragment;
+    /**
+     * Check if a DOM node has been rendered and tracked.
+     */
+    hasNode(node: DOMNode): boolean;
+    /**
+     * Get the rendered DOM element associated with a node.
+     */
+    getRenderedNode(node: DOMNode): Element | Text | Comment | undefined;
+    /**
+     * Render a single DOM node
+     */
+    private renderSingle;
+    /**
+     * Render multiple nodes as a document fragment
+     */
+    private renderFragment;
+    /**
+     * Create a DOM element with props and children
+     */
+    private createOrUpdateElement;
+    private updateProps;
+    private updateChildren;
+    private updateExistingNode;
+    /**
+     * Apply debug attributes to DOM element if debug mode is enabled
+     */
+    private applyDebugAttributes;
+    /**
+     * Create or update a text node
+     */
+    private createOrUpdateTextNode;
+    /**
+     * Create a text node
+     */
+    private createTextNode;
+    /**
+     * Create a comment node
+     */
+    private createComment;
+    /**
+     * Apply props to a DOM element with reactive updates
+     */
+    private applyProps;
+    /**
+     * Apply a single prop to an element
+     */
+    private applyProp;
+    /**
+     * Set a property on an element
+     */
+    private setElementProp;
+    /**
+     * Apply className with reactive updates
+     */
+    private applyClassName;
+    /**
+     * Normalize className value
+     */
+    private normalizeClassName;
+    /**
+     * Apply styles with reactive updates
+     */
+    private applyStyle;
+    /**
+     * Set styles on an element
+     */
+    private setElementStyles;
+    /**
+     * Apply event listener (with delegation if possible)
+     */
+    private applyEventListener;
+    /**
+     * Add cleanup function for an element
+     */
+    private addCleanup;
+    /**
+     * Update an existing DOM node
+     */
+    updateNode(node: DOMNode, newProps?: Record<string, any>): void;
+    /**
+     * Remove a DOM node and run cleanup
+     */
+    removeNode(node: DOMNode): void;
+    /**
+     * Cleanup a node (and its descendants) and optionally remove from DOM.
+     */
+    private cleanupNode;
+    /**
+     * Create reactive text content
+     */
+    createReactiveText(textAccessor: () => string): Text;
+    /**
+     * Create reactive element with dynamic props
+     */
+    createReactiveElement(tag: string, propsAccessor: () => Record<string, any>, children?: DOMNode[]): Element;
+    /**
+     * Apply modifiers to a DOM element
+     */
+    private applyModifiersToElement;
+    /**
+     * Adopt an existing DOM mapping from one node to another.
+     */
+    adoptNode(oldNode: DOMNode, newNode: DOMNode): void;
+    /**
+     * Cleanup all tracked elements
+     */
+    cleanup(): void;
+    resetMetrics(): void;
+    getMetrics(): RendererMetrics;
+    recordCacheHit(): void;
+    recordCacheMiss(): void;
+    insertNode(container: Element, node: Element | Text | Comment, nextSibling: Node | null): void;
+    appendNode(container: Element, node: Element | Text | Comment): void;
+    private recordAttributeWrite;
+    private recordAttributeRemoval;
+    private recordTextUpdate;
+    private recordModifierApplications;
+}
+export type RendererMetricsSnapshot = RendererMetrics;
+export declare function resetRendererMetrics(): void;
+export declare function getRendererMetrics(): RendererMetricsSnapshot;
+/**
+ * Render a component instance to DOM
+ */
+export declare function renderComponent(instance: ComponentInstance, container: Element): () => void;
+/**
+ * Create a DOM node helper
+ */
+export declare function h(tag: string, props?: Record<string, any> | null, ...children: (DOMNode | string | number)[]): DOMNode;
+/**
+ * Create a text node helper
+ */
+export declare function text(content: string | (() => string)): DOMNode;
+export {};
+//# sourceMappingURL=renderer.d.ts.map

package/dist/core/src/runtime/renderer.d.ts.map

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