tuiuiu.js 0.1.1

package/dist/core/dirty.js

@@ -0,0 +1,335 @@
+/**
+ * Dirty Flag System
+ *
+ * Tracks which VNodes have changed and need re-rendering.
+
+ *
+ * Features:
+ * - Mark individual nodes as dirty
+ * - Propagate dirty state to ancestors
+ * - Skip re-rendering of clean subtrees
+ * - Content caching with invalidation
+ * - Automatic dirty tracking for signal changes
+ */
+// =============================================================================
+// Dirty Tracking Registry
+// =============================================================================
+/**
+ * Registry for tracking dirty state across VNodes
+ */
+class DirtyRegistry {
+    states = new WeakMap();
+    renderCache = new Map();
+    maxCacheSize = 1000;
+    globalVersion = 0;
+    isDirty = true; // Start dirty for initial render
+    /**
+     * Get or create dirty state for a node
+     */
+    getState(node) {
+        let state = this.states.get(node);
+        if (!state) {
+            state = { dirty: true, childrenDirty: false, version: 0 };
+            this.states.set(node, state);
+        }
+        return state;
+    }
+    /**
+     * Mark a node as dirty (needs re-rendering)
+     */
+    markDirty(node) {
+        const state = this.getState(node);
+        if (!state.dirty) {
+            state.dirty = true;
+            state.version++;
+            this.isDirty = true;
+            this.globalVersion++;
+        }
+    }
+    /**
+     * Mark a node as clean (just rendered)
+     */
+    markClean(node) {
+        const state = this.getState(node);
+        state.dirty = false;
+        state.childrenDirty = false;
+    }
+    /**
+     * Mark children as dirty (propagates up)
+     */
+    markChildrenDirty(node) {
+        const state = this.getState(node);
+        if (!state.childrenDirty) {
+            state.childrenDirty = true;
+            this.isDirty = true;
+        }
+    }
+    /**
+     * Check if a node is dirty
+     */
+    isDirtyNode(node) {
+        const state = this.states.get(node);
+        return state ? state.dirty : true; // Unknown nodes are dirty
+    }
+    /**
+     * Check if a node or any children are dirty
+     */
+    needsRender(node) {
+        const state = this.states.get(node);
+        if (!state)
+            return true;
+        return state.dirty || state.childrenDirty;
+    }
+    /**
+     * Check if anything needs rendering
+     */
+    hasChanges() {
+        return this.isDirty;
+    }
+    /**
+     * Clear global dirty flag (after render)
+     */
+    clearGlobalDirty() {
+        this.isDirty = false;
+    }
+    /**
+     * Get the global version (increments on any change)
+     */
+    getGlobalVersion() {
+        return this.globalVersion;
+    }
+    // ===========================================================================
+    // Render Cache
+    // ===========================================================================
+    /**
+     * Generate a hash for a VNode (for cache key)
+     */
+    hashNode(node) {
+        const props = { ...node.props };
+        // Remove function props from hash
+        for (const key in props) {
+            if (typeof props[key] === 'function') {
+                delete props[key];
+            }
+        }
+        // Include children in hash
+        const childrenStr = JSON.stringify(node.children?.map((child) => {
+            if (typeof child === 'string' || typeof child === 'number') {
+                return child;
+            }
+            if (child && typeof child === 'object' && 'type' in child) {
+                return { type: child.type, key: child.props?.key };
+            }
+            return null;
+        }) ?? []);
+        return `${node.type}:${JSON.stringify(props)}:${childrenStr}`;
+    }
+    /**
+     * Get cached render output for a node
+     */
+    getCachedRender(node, width) {
+        const hash = this.hashNode(node);
+        const key = `${hash}:${width}`;
+        const entry = this.renderCache.get(key);
+        if (entry) {
+            entry.lastAccess = Date.now();
+            return entry;
+        }
+        return undefined;
+    }
+    /**
+     * Store render output in cache
+     */
+    setCachedRender(node, width, output, height) {
+        const hash = this.hashNode(node);
+        const key = `${hash}:${width}`;
+        // Evict old entries if cache is too large
+        if (this.renderCache.size >= this.maxCacheSize) {
+            this.evictOldest();
+        }
+        this.renderCache.set(key, {
+            output,
+            width,
+            height,
+            hash,
+            lastAccess: Date.now(),
+        });
+    }
+    /**
+     * Evict oldest cache entries
+     */
+    evictOldest() {
+        const entries = [...this.renderCache.entries()];
+        entries.sort((a, b) => a[1].lastAccess - b[1].lastAccess);
+        // Remove oldest 20%
+        const toRemove = Math.ceil(entries.length * 0.2);
+        for (let i = 0; i < toRemove; i++) {
+            this.renderCache.delete(entries[i][0]);
+        }
+    }
+    /**
+     * Invalidate cache for a node
+     */
+    invalidateCache(node) {
+        const hash = this.hashNode(node);
+        // Remove all entries with this hash (any width)
+        for (const key of this.renderCache.keys()) {
+            if (key.startsWith(hash)) {
+                this.renderCache.delete(key);
+            }
+        }
+    }
+    /**
+     * Clear entire cache
+     */
+    clearCache() {
+        this.renderCache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.renderCache.size,
+            maxSize: this.maxCacheSize,
+        };
+    }
+    /**
+     * Reset all state
+     */
+    reset() {
+        this.states = new WeakMap();
+        this.renderCache.clear();
+        this.globalVersion = 0;
+        this.isDirty = true;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let registryInstance = null;
+/**
+ * Get the global dirty registry
+ */
+export function getDirtyRegistry() {
+    if (!registryInstance) {
+        registryInstance = new DirtyRegistry();
+    }
+    return registryInstance;
+}
+/**
+ * Reset the registry (for testing)
+ */
+export function resetDirtyRegistry() {
+    registryInstance = null;
+}
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+/**
+ * Mark a node as dirty
+ */
+export function markDirty(node) {
+    getDirtyRegistry().markDirty(node);
+}
+/**
+ * Mark a node as clean
+ */
+export function markClean(node) {
+    getDirtyRegistry().markClean(node);
+}
+/**
+ * Check if a node needs rendering
+ */
+export function needsRender(node) {
+    return getDirtyRegistry().needsRender(node);
+}
+/**
+ * Check if anything has changed
+ */
+export function hasChanges() {
+    return getDirtyRegistry().hasChanges();
+}
+/**
+ * Clear the global dirty flag
+ */
+export function clearChanges() {
+    getDirtyRegistry().clearGlobalDirty();
+}
+/**
+ * Get cached render output
+ */
+export function getCachedRender(node, width) {
+    return getDirtyRegistry().getCachedRender(node, width);
+}
+/**
+ * Store render output in cache
+ */
+export function setCachedRender(node, width, output, height) {
+    getDirtyRegistry().setCachedRender(node, width, output, height);
+}
+/**
+ * Invalidate cache for a node
+ */
+export function invalidateCache(node) {
+    getDirtyRegistry().invalidateCache(node);
+}
+/**
+ * Clear all caches
+ */
+export function clearAllCaches() {
+    getDirtyRegistry().clearCache();
+}
+// =============================================================================
+// Layout Tree Dirty Tracking
+// =============================================================================
+/**
+ * Walk a layout tree and mark dirty nodes
+ * Returns true if any node in the subtree is dirty
+ */
+export function markLayoutTreeDirty(layout) {
+    const registry = getDirtyRegistry();
+    let anyDirty = registry.isDirtyNode(layout.node);
+    // Check children
+    for (const child of layout.children) {
+        if (markLayoutTreeDirty(child)) {
+            anyDirty = true;
+        }
+    }
+    // Mark children dirty if any descendant is dirty
+    if (anyDirty) {
+        registry.markChildrenDirty(layout.node);
+    }
+    return anyDirty;
+}
+/**
+ * Clean all nodes in a layout tree after render
+ */
+export function cleanLayoutTree(layout) {
+    const registry = getDirtyRegistry();
+    registry.markClean(layout.node);
+    for (const child of layout.children) {
+        cleanLayoutTree(child);
+    }
+}
+// =============================================================================
+// Signal Integration
+// =============================================================================
+/**
+ * Create a dirty-tracking wrapper for a component
+ *
+ * Automatically marks the component dirty when its render function
+ * is called (typically triggered by signal changes)
+ */
+export function withDirtyTracking(render, nodeRef) {
+    return () => {
+        const result = render();
+        // Mark the previous node as dirty if exists
+        if (nodeRef.current) {
+            markDirty(nodeRef.current);
+        }
+        nodeRef.current = result;
+        return result;
+    };
+}
+//# sourceMappingURL=dirty.js.map

package/dist/core/dirty.js.map

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

package/dist/core/error-boundary.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Error Boundary System
+ *
+ * Provides error handling with detailed error display including:
+ * - Error message and stack trace
+ * - Source code excerpt around the error location
+ * - File path and line number
+ *
+
+ */
+import type { VNode } from '../utils/types.js';
+export interface ErrorInfo {
+    /** The error object */
+    error: Error;
+    /** Component stack trace */
+    componentStack?: string;
+}
+export interface StackFrame {
+    /** Function name */
+    function?: string;
+    /** File path */
+    file?: string;
+    /** Line number */
+    line?: number;
+    /** Column number */
+    column?: number;
+}
+export interface CodeExcerpt {
+    /** Line number */
+    line: number;
+    /** Line content */
+    value: string;
+    /** Is this the error line? */
+    isErrorLine: boolean;
+}
+/**
+ * Parse a single stack trace line into a StackFrame
+ */
+export declare function parseStackLine(line: string): StackFrame | null;
+/**
+ * Parse full stack trace into frames
+ */
+export declare function parseStackTrace(stack: string): StackFrame[];
+/**
+ * Extract source code excerpt around a line number
+ */
+export declare function extractCodeExcerpt(filePath: string, errorLine: number, contextLines?: number): CodeExcerpt[] | null;
+/**
+ * Render an error overview with source code excerpt
+ */
+export declare function ErrorOverview(props: {
+    error: Error;
+}): VNode;
+/**
+ * Set the current error (triggers error display)
+ */
+export declare function setError(error: Error): void;
+/**
+ * Clear the current error
+ */
+export declare function clearError(): void;
+/**
+ * Get the current error
+ */
+export declare function getError(): Error | null;
+/**
+ * Register an error handler
+ */
+export declare function onError(handler: (error: Error) => void): () => void;
+/**
+ * Wrap a render function with error boundary
+ */
+export declare function withErrorBoundary(render: () => VNode): () => VNode;
+/**
+ * Try to execute a function and catch errors
+ */
+export declare function tryCatch<T>(fn: () => T, onError?: (error: Error) => void): T | null;
+export declare function resetErrorBoundary(): void;
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/core/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/core/error-boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAS/C,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAsC9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAY3D;AA0BD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,YAAY,SAAI,GACf,WAAW,EAAE,GAAG,IAAI,CAkCtB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,KAAK,CAiG5D;AAUD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAK3C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,KAAK,GAAG,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,KAAK,GAAG,MAAM,KAAK,CAelE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,CAAC,EACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,CAAC,GAAG,IAAI,CAYV;AAMD,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/core/error-boundary.js

@@ -0,0 +1,258 @@
+/**
+ * Error Boundary System
+ *
+ * Provides error handling with detailed error display including:
+ * - Error message and stack trace
+ * - Source code excerpt around the error location
+ * - File path and line number
+ *
+
+ */
+import { Box, Text } from '../primitives/nodes.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// =============================================================================
+// Stack Trace Parsing
+// =============================================================================
+/**
+ * Parse a single stack trace line into a StackFrame
+ */
+export function parseStackLine(line) {
+    // Match patterns like:
+    // "    at functionName (file:line:column)"
+    // "    at file:line:column"
+    // "    at functionName (/path/to/file.ts:10:5)"
+    const patterns = [
+        // Node.js style with function name
+        /^\s*at\s+(.+?)\s+\((.+):(\d+):(\d+)\)$/,
+        // Node.js style without function name
+        /^\s*at\s+(.+):(\d+):(\d+)$/,
+        // File URL style
+        /^\s*at\s+(.+?)\s+\(file:\/\/(.+):(\d+):(\d+)\)$/,
+    ];
+    for (const pattern of patterns) {
+        const match = line.match(pattern);
+        if (match) {
+            if (match.length === 5) {
+                // With function name
+                return {
+                    function: match[1],
+                    file: cleanFilePath(match[2]),
+                    line: parseInt(match[3], 10),
+                    column: parseInt(match[4], 10),
+                };
+            }
+            else if (match.length === 4) {
+                // Without function name
+                return {
+                    file: cleanFilePath(match[1]),
+                    line: parseInt(match[2], 10),
+                    column: parseInt(match[3], 10),
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Parse full stack trace into frames
+ */
+export function parseStackTrace(stack) {
+    const lines = stack.split('\n').slice(1); // Skip first line (error message)
+    const frames = [];
+    for (const line of lines) {
+        const frame = parseStackLine(line);
+        if (frame) {
+            frames.push(frame);
+        }
+    }
+    return frames;
+}
+/**
+ * Clean up file path (remove node_modules, file:// prefix, etc.)
+ */
+function cleanFilePath(filePath) {
+    let cleaned = filePath;
+    // Remove file:// prefix
+    if (cleaned.startsWith('file://')) {
+        cleaned = cleaned.slice(7);
+    }
+    // Get relative path from cwd
+    const cwd = process.cwd();
+    if (cleaned.startsWith(cwd)) {
+        cleaned = cleaned.slice(cwd.length + 1);
+    }
+    return cleaned;
+}
+// =============================================================================
+// Source Code Extraction
+// =============================================================================
+/**
+ * Extract source code excerpt around a line number
+ */
+export function extractCodeExcerpt(filePath, errorLine, contextLines = 3) {
+    try {
+        // Resolve file path
+        let resolvedPath = filePath;
+        if (!path.isAbsolute(filePath)) {
+            resolvedPath = path.join(process.cwd(), filePath);
+        }
+        // Check if file exists
+        if (!fs.existsSync(resolvedPath)) {
+            return null;
+        }
+        // Read file content
+        const content = fs.readFileSync(resolvedPath, 'utf-8');
+        const lines = content.split('\n');
+        // Calculate range
+        const startLine = Math.max(1, errorLine - contextLines);
+        const endLine = Math.min(lines.length, errorLine + contextLines);
+        const excerpt = [];
+        for (let i = startLine; i <= endLine; i++) {
+            excerpt.push({
+                line: i,
+                value: lines[i - 1] ?? '',
+                isErrorLine: i === errorLine,
+            });
+        }
+        return excerpt;
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Error Display Components
+// =============================================================================
+/**
+ * Render an error overview with source code excerpt
+ */
+export function ErrorOverview(props) {
+    const { error } = props;
+    const frames = error.stack ? parseStackTrace(error.stack) : [];
+    const origin = frames[0];
+    // Extract source code if we have file info
+    let excerpt = null;
+    if (origin?.file && origin?.line) {
+        excerpt = extractCodeExcerpt(origin.file, origin.line);
+    }
+    // Calculate line number padding width
+    const lineWidth = excerpt
+        ? Math.max(...excerpt.map((e) => String(e.line).length))
+        : 0;
+    return Box({ flexDirection: 'column', padding: 1 }, 
+    // Error header
+    Box({ flexDirection: 'row' }, Text({ backgroundColor: 'red', color: 'white', bold: true }, ' ERROR '), Text({ color: 'white' }, ` ${error.message}`)), 
+    // File location
+    origin?.file && origin?.line
+        ? Box({ marginTop: 1 }, Text({ color: 'gray' }, `${origin.file}:${origin.line}${origin.column ? `:${origin.column}` : ''}`))
+        : null, 
+    // Source code excerpt
+    excerpt
+        ? Box({ flexDirection: 'column', marginTop: 1 }, ...excerpt.map((line) => Box({ flexDirection: 'row' }, 
+        // Line number
+        Text({
+            color: line.isErrorLine ? 'red' : 'gray',
+            backgroundColor: line.isErrorLine ? 'red' : undefined,
+        }, ` ${String(line.line).padStart(lineWidth, ' ')} `), 
+        // Separator
+        Text({ color: 'gray' }, '│ '), 
+        // Code content
+        Text({
+            color: line.isErrorLine ? 'white' : 'gray',
+            bold: line.isErrorLine,
+        }, line.value))))
+        : null, 
+    // Stack trace
+    frames.length > 0
+        ? Box({ flexDirection: 'column', marginTop: 1 }, Text({ color: 'gray', dim: true }, 'Stack trace:'), ...frames.slice(0, 10).map((frame, index) => Box({ flexDirection: 'row' }, Text({ color: 'gray', dim: true }, '  '), Text({ color: 'cyan', dim: true }, `${index + 1}. `), frame.function
+            ? Text({ color: 'yellow', dim: true }, `${frame.function} `)
+            : null, Text({ color: 'gray', dim: true }, frame.file
+            ? `(${frame.file}:${frame.line ?? '?'}:${frame.column ?? '?'})`
+            : '(unknown)'))), frames.length > 10
+            ? Text({ color: 'gray', dim: true }, `  ... and ${frames.length - 10} more frames`)
+            : null)
+        : null);
+}
+// =============================================================================
+// Error Boundary State
+// =============================================================================
+/** Global error state */
+let currentError = null;
+let errorHandlers = [];
+/**
+ * Set the current error (triggers error display)
+ */
+export function setError(error) {
+    currentError = error;
+    for (const handler of errorHandlers) {
+        handler(error);
+    }
+}
+/**
+ * Clear the current error
+ */
+export function clearError() {
+    currentError = null;
+}
+/**
+ * Get the current error
+ */
+export function getError() {
+    return currentError;
+}
+/**
+ * Register an error handler
+ */
+export function onError(handler) {
+    errorHandlers.push(handler);
+    return () => {
+        errorHandlers = errorHandlers.filter((h) => h !== handler);
+    };
+}
+/**
+ * Wrap a render function with error boundary
+ */
+export function withErrorBoundary(render) {
+    return () => {
+        try {
+            // If there's a current error, show it
+            if (currentError) {
+                return ErrorOverview({ error: currentError });
+            }
+            return render();
+        }
+        catch (error) {
+            // Catch render errors
+            const err = error instanceof Error ? error : new Error(String(error));
+            setError(err);
+            return ErrorOverview({ error: err });
+        }
+    };
+}
+/**
+ * Try to execute a function and catch errors
+ */
+export function tryCatch(fn, onError) {
+    try {
+        return fn();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        if (onError) {
+            onError(err);
+        }
+        else {
+            setError(err);
+        }
+        return null;
+    }
+}
+// =============================================================================
+// Reset (for testing)
+// =============================================================================
+export function resetErrorBoundary() {
+    currentError = null;
+    errorHandlers = [];
+}
+//# sourceMappingURL=error-boundary.js.map