@coherent.js/core 1.0.0-beta.2

package/dist/rendering/base-renderer.js

@@ -0,0 +1,409 @@
+/**
+ * Base Renderer Class
+ * Provides common functionality shared across all Coherent.js renderers
+ * Reduces code duplication and ensures consistent behavior
+ */
+import { validateComponent, isCoherentObject, extractProps, hasChildren, normalizeChildren, } from '../core/object-utils.js';
+import { performanceMonitor } from '../performance/monitor.js';
+/**
+ * Unified configuration for all Coherent.js renderers
+ * Includes options for HTML, Streaming, and DOM renderers
+ */
+export const DEFAULT_RENDERER_CONFIG = {
+    // Core rendering options
+    maxDepth: 100,
+    enableValidation: true,
+    enableMonitoring: false,
+    validateInput: true,
+    // HTML Renderer specific options
+    enableCache: true,
+    minify: false,
+    cacheSize: 1000,
+    cacheTTL: 300000, // 5 minutes
+    // Streaming Renderer specific options
+    chunkSize: 1024, // Size of each chunk in bytes
+    bufferSize: 4096, // Internal buffer size
+    enableMetrics: false, // Track streaming metrics
+    yieldThreshold: 100, // Yield control after N elements
+    encoding: 'utf8', // Output encoding
+    // DOM Renderer specific options
+    enableHydration: true, // Enable hydration support
+    namespace: null, // SVG namespace support
+    // Performance options
+    enablePerformanceTracking: false,
+    performanceThreshold: 10, // ms threshold for slow renders
+    // Development options
+    enableDevWarnings: typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development',
+    enableDebugLogging: false,
+    // Error handling options
+    errorFallback: '', // Fallback content on errors
+    throwOnError: true, // Whether to throw or return fallback
+};
+/**
+ * Base renderer class with common functionality
+ */
+export class BaseRenderer {
+    constructor(options = {}) {
+        this.config = this.validateAndMergeConfig(options);
+        this.metrics = {
+            startTime: null,
+            endTime: null,
+            elementsProcessed: 0
+        };
+    }
+    /**
+     * Validate and merge configuration options
+     */
+    validateAndMergeConfig(options) {
+        const _config = { ...DEFAULT_RENDERER_CONFIG, ...options };
+        // Validate critical options
+        if (typeof config.maxDepth !== 'number') {
+            throw new Error('maxDepth must be a number');
+        }
+        if (config.maxDepth <= 0) {
+            throw new Error('maxDepth must be a positive number');
+        }
+        if (typeof config.chunkSize !== 'number') {
+            throw new Error('chunkSize must be a number');
+        }
+        if (config.chunkSize <= 0) {
+            throw new Error('chunkSize must be a positive number');
+        }
+        if (typeof config.yieldThreshold !== 'number') {
+            throw new Error('yieldThreshold must be a number');
+        }
+        if (config.yieldThreshold <= 0) {
+            throw new Error('yieldThreshold must be a positive number');
+        }
+        // Warn about potentially problematic configurations
+        if (config.enableDevWarnings) {
+            if (config.maxDepth > 1000) {
+                console.warn('Coherent.js: maxDepth > 1000 may cause performance issues');
+            }
+            if (config.chunkSize > 16384) {
+                console.warn('Coherent.js: Large chunkSize may increase memory usage');
+            }
+        }
+        return config;
+    }
+    /**
+     * Get configuration for specific renderer type
+     */
+    getRendererConfig(rendererType) {
+        const baseConfig = { ...this.config };
+        switch (rendererType) {
+            case 'html':
+                return {
+                    ...baseConfig,
+                    // HTML-specific defaults
+                    enableCache: baseConfig.enableCache !== false,
+                    enableMonitoring: baseConfig.enableMonitoring !== false
+                };
+            case 'streaming':
+                return {
+                    ...baseConfig,
+                    // Streaming-specific defaults
+                    enableMetrics: baseConfig.enableMetrics ?? false,
+                    maxDepth: baseConfig.maxDepth ?? 1000 // Higher default for streaming
+                };
+            case 'dom':
+                return {
+                    ...baseConfig,
+                    // DOM-specific defaults
+                    enableHydration: baseConfig.enableHydration !== false
+                };
+            default:
+                return baseConfig;
+        }
+    }
+    /**
+     * Validate component structure
+     */
+    validateComponent(component) {
+        if (this.config.validateInput !== false) {
+            return validateComponent(component);
+        }
+        return true;
+    }
+    /**
+     * Check if component is valid for rendering
+     */
+    isValidComponent(component) {
+        if (component === null || component === undefined)
+            return true;
+        if (typeof component === 'string' || typeof component === 'number')
+            return true;
+        if (typeof component === 'function')
+            return true;
+        if (Array.isArray(component))
+            return component.every(child => this.isValidComponent(child));
+        if (isCoherentObject(component))
+            return true;
+        return false;
+    }
+    /**
+     * Validate rendering depth to prevent stack overflow
+     */
+    validateDepth(depth) {
+        if (depth > this.config.maxDepth) {
+            throw new Error(`Maximum render depth (${this.config.maxDepth}) exceeded`);
+        }
+    }
+    /**
+     * Handle different component types with consistent logic
+     */
+    processComponentType(component) {
+        // Null/undefined
+        if (component === null || component === undefined) {
+            return { type: 'empty', value: '' };
+        }
+        // String
+        if (typeof component === 'string') {
+            return { type: 'text', value: component };
+        }
+        // Number/Boolean
+        if (typeof component === 'number' || typeof component === 'boolean') {
+            return { type: 'text', value: String(component) };
+        }
+        // Function
+        if (typeof component === 'function') {
+            return { type: 'function', value: component };
+        }
+        // Array
+        if (Array.isArray(component)) {
+            return { type: 'array', value: component };
+        }
+        // Object (Coherent element)
+        if (isCoherentObject(component)) {
+            return { type: 'element', value: component };
+        }
+        // Unknown type
+        return { type: 'unknown', value: component };
+    }
+    /**
+     * Execute function components with error handling
+     */
+    executeFunctionComponent(func, depth = 0) {
+        try {
+            // Check if this is a context provider by checking function arity or a marker
+            const isContextProvider = func.length > 0 || func.isContextProvider;
+            let result;
+            if (isContextProvider) {
+                // Call with render function for context providers
+                result = func((children) => {
+                    return this.renderComponent(children, this.config, depth + 1);
+                });
+            }
+            else {
+                // Regular function component
+                result = func();
+            }
+            // Handle case where function returns another function
+            if (typeof result === 'function') {
+                return this.executeFunctionComponent(result, depth);
+            }
+            return result;
+        }
+        catch (error) {
+            if (this.config.enableMonitoring) {
+                performanceMonitor.recordError('functionComponent', error);
+            }
+            // In development, provide detailed error info
+            if (typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development') {
+                console.warn('Coherent.js Function Component Error:', error.message);
+            }
+            return null;
+        }
+    }
+    /**
+     * Process element children consistently
+     */
+    processChildren(children, options, depth) {
+        if (!hasChildren({ children })) {
+            return [];
+        }
+        const normalizedChildren = normalizeChildren(children);
+        return normalizedChildren.map(child => this.renderComponent(child, options, depth + 1));
+    }
+    /**
+     * Extract and process element attributes
+     */
+    extractElementAttributes(_props) {
+        if (!props || typeof props !== 'object')
+            return {};
+        const attributes = { ...props };
+        delete attributes.children;
+        delete attributes.text;
+        return attributes;
+    }
+    /**
+     * Record performance metrics
+     */
+    recordPerformance(operation, startTime, fromCache = false, metadata = {}) {
+        if (this.config.enableMonitoring) {
+            performanceMonitor.recordRender(operation, this.getCurrentTime() - startTime, fromCache, metadata);
+        }
+    }
+    /**
+     * Record error for monitoring
+     */
+    recordError(operation, error, metadata = {}) {
+        if (this.config.enableMonitoring) {
+            performanceMonitor.recordError(operation, error, metadata);
+        }
+    }
+    /**
+     * Get current timestamp with fallback
+     */
+    getCurrentTime() {
+        if (typeof performance !== 'undefined' && performance.now) {
+            return performance.now();
+        }
+        return Date.now();
+    }
+    /**
+     * Start performance timing
+     */
+    startTiming() {
+        this.metrics.startTime = this.getCurrentTime();
+    }
+    /**
+     * End performance timing
+     */
+    endTiming() {
+        this.metrics.endTime = this.getCurrentTime();
+    }
+    /**
+     * Get performance metrics
+     */
+    getMetrics() {
+        const duration = this.metrics.endTime ?
+            this.metrics.endTime - this.metrics.startTime :
+            this.getCurrentTime() - this.metrics.startTime;
+        return {
+            ...this.metrics,
+            duration,
+            elementsPerSecond: this.metrics.elementsProcessed / (duration / 1000)
+        };
+    }
+    /**
+     * Reset metrics for new render
+     */
+    resetMetrics() {
+        this.metrics = {
+            startTime: null,
+            endTime: null,
+            elementsProcessed: 0
+        };
+    }
+    /**
+     * Abstract method - must be implemented by subclasses
+     */
+    renderComponent() {
+        throw new Error('renderComponent must be implemented by subclass');
+    }
+    /**
+     * Abstract method - must be implemented by subclasses
+     */
+    render() {
+        throw new Error('render must be implemented by subclass');
+    }
+}
+/**
+ * Utility functions for renderer implementations
+ */
+export const RendererUtils = {
+    /**
+     * Check if element is static (no functions)
+     */
+    isStaticElement(element) {
+        if (!element || typeof element !== 'object') {
+            return typeof element === 'string' || typeof element === 'number';
+        }
+        // Check if element has any dynamic content
+        for (const [key, value] of Object.entries(element)) {
+            if (typeof value === 'function')
+                return false;
+            if (key === 'children' && Array.isArray(value)) {
+                // Recursively check children for dynamic content
+                return value.every(child => RendererUtils.isStaticElement(child));
+            }
+            if (key === 'children' && typeof value === 'object' && value !== null) {
+                return RendererUtils.isStaticElement(value);
+            }
+        }
+        return true;
+    },
+    /**
+     * Check if object has functions (for caching decisions)
+     */
+    hasFunctions(obj, visited = new WeakSet()) {
+        if (visited.has(obj))
+            return false;
+        visited.add(obj);
+        for (const value of Object.values(obj)) {
+            if (typeof value === 'function')
+                return true;
+            if (typeof value === 'object' && value !== null && RendererUtils.hasFunctions(value, visited)) {
+                return true;
+            }
+        }
+        return false;
+    },
+    /**
+     * Get element complexity score
+     */
+    getElementComplexity(element) {
+        if (!element || typeof element !== 'object')
+            return 1;
+        let complexity = Object.keys(element).length;
+        if (element.children && Array.isArray(element.children)) {
+            complexity += element.children.reduce((sum, child) => sum + RendererUtils.getElementComplexity(child), 0);
+        }
+        return complexity;
+    },
+    /**
+     * Generate cache key for element
+     */
+    generateCacheKey(tagName, element) {
+        try {
+            // Create a stable cache key for the element
+            const keyData = {
+                tag: tagName,
+                props: extractProps(element),
+                hasChildren: hasChildren(element),
+                childrenType: Array.isArray(element.children) ? 'array' : typeof element.children
+            };
+            return `element:${JSON.stringify(keyData)}`;
+        }
+        catch (error) {
+            // Log error in development mode
+            if (typeof process !== 'undefined' && process.env && process.env.NODE_ENV === 'development') {
+                console.warn('Failed to generate cache key:', error);
+            }
+            // Return null to indicate uncacheable element
+            return null;
+        }
+    },
+    /**
+     * Check if element is cacheable
+     */
+    isCacheable(element, options) {
+        // Don't cache if caching is disabled
+        if (!options.enableCache)
+            return false;
+        // Don't cache elements with functions (dynamic content)
+        if (RendererUtils.hasFunctions(element))
+            return false;
+        // Don't cache very large elements (memory consideration)
+        if (RendererUtils.getElementComplexity(element) > 1000)
+            return false;
+        // Don't cache if we can't generate a stable cache key
+        const cacheKey = RendererUtils.generateCacheKey(element.tagName || 'unknown', element);
+        if (!cacheKey)
+            return false;
+        return true;
+    }
+};
+export default BaseRenderer;
+//# sourceMappingURL=base-renderer.js.map

package/dist/rendering/base-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-renderer.js","sourceRoot":"","sources":["../../../../src/rendering/base-renderer.js"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,iBAAiB,GACpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACnC,yBAAyB;IACzB,QAAQ,EAAE,GAAG;IACb,gBAAgB,EAAE,IAAI;IACtB,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,IAAI;IAEnB,iCAAiC;IACjC,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,MAAM,EAAE,YAAY;IAE9B,sCAAsC;IACtC,SAAS,EAAE,IAAI,EAAY,8BAA8B;IACzD,UAAU,EAAE,IAAI,EAAW,uBAAuB;IAClD,aAAa,EAAE,KAAK,EAAO,0BAA0B;IACrD,cAAc,EAAE,GAAG,EAAQ,iCAAiC;IAC5D,QAAQ,EAAE,MAAM,EAAW,kBAAkB;IAE7C,gCAAgC;IAChC,eAAe,EAAE,IAAI,EAAM,2BAA2B;IACtD,SAAS,EAAE,IAAI,EAAY,wBAAwB;IAEnD,sBAAsB;IACtB,yBAAyB,EAAE,KAAK;IAChC,oBAAoB,EAAE,EAAE,EAAG,gCAAgC;IAE3D,sBAAsB;IACtB,iBAAiB,EAAE,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa;IAC1G,kBAAkB,EAAE,KAAK;IAEzB,yBAAyB;IACzB,aAAa,EAAE,EAAE,EAAU,6BAA6B;IACxD,YAAY,EAAE,IAAI,EAAS,sCAAsC;CACpE,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACrB,YAAY,OAAO,GAAG,EAAE;QACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG;YACX,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,CAAC;SACvB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,OAAO;QAC1B,MAAM,MAAM,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,OAAO,EAAE,CAAC;QAE1D,4BAA4B;QAC5B,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;QAED,oDAAoD;QACpD,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YAC9E,CAAC;YAED,IAAI,MAAM,CAAC,SAAS,GAAG,KAAK,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;YAC3E,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,YAAY;QAC1B,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAEtC,QAAQ,YAAY,EAAE,CAAC;YACnB,KAAK,MAAM;gBACP,OAAO;oBACH,GAAG,UAAU;oBACb,yBAAyB;oBACzB,WAAW,EAAE,UAAU,CAAC,WAAW,KAAK,KAAK;oBAC7C,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,KAAK,KAAK;iBAC1D,CAAC;YAEN,KAAK,WAAW;gBACZ,OAAO;oBACH,GAAG,UAAU;oBACb,8BAA8B;oBAC9B,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,KAAK;oBAChD,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,IAAI,CAAC,+BAA+B;iBACxE,CAAC;YAEN,KAAK,KAAK;gBACN,OAAO;oBACH,GAAG,UAAU;oBACb,wBAAwB;oBACxB,eAAe,EAAE,UAAU,CAAC,eAAe,KAAK,KAAK;iBACxD,CAAC;YAEN;gBACI,OAAO,UAAU,CAAC;QAC1B,CAAC;IACL,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAAS;QACvB,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;YACtC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAS;QACtB,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAChF,IAAI,OAAO,SAAS,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5F,IAAI,gBAAgB,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAK;QACf,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,QAAQ,YAAY,CAAC,CAAC;QAC/E,CAAC;IACL,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,SAAS;QAC1B,iBAAiB;QACjB,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACxC,CAAC;QAED,SAAS;QACT,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9C,CAAC;QAED,iBAAiB;QACjB,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,CAAC;QAED,WAAW;QACX,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAClD,CAAC;QAED,QAAQ;QACR,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC/C,CAAC;QAED,4BAA4B;QAC5B,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QACjD,CAAC;QAED,eAAe;QACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC;QACpC,IAAI,CAAC;YACD,6EAA6E;YAC7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC;YAEpE,IAAI,MAAM,CAAC;YACX,IAAI,iBAAiB,EAAE,CAAC;gBACpB,kDAAkD;gBAClD,MAAM,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;oBACvB,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAClE,CAAC,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,6BAA6B;gBAC7B,MAAM,GAAG,IAAI,EAAE,CAAC;YACpB,CAAC;YAED,sDAAsD;YACtD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC/B,OAAO,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC/B,kBAAkB,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;YAC/D,CAAC;YAED,8CAA8C;YAC9C,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC1F,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK;QACpC,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACd,CAAC;QAED,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAClC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAClD,CAAC;IACN,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,KAAK;QAC1B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEnD,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC3B,OAAO,UAAU,CAAC,IAAI,CAAC;QACvB,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,EAAE,QAAQ,GAAG,EAAE;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC/B,kBAAkB,CAAC,YAAY,CAC3B,SAAS,EACT,IAAI,CAAC,cAAc,EAAE,GAAG,SAAS,EACjC,SAAS,EACT,QAAQ,CACX,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,EAAE;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC/B,kBAAkB,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc;QACV,IAAI,OAAO,WAAW,KAAK,WAAW,IAAI,WAAW,CAAC,GAAG,EAAE,CAAC;YACxD,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,WAAW;QACP,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,SAAS;QACL,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,UAAU;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;QAEnD,OAAO;YACH,GAAG,IAAI,CAAC,OAAO;YACf,QAAQ;YACR,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,iBAAiB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;SACxE,CAAC;IACN,CAAC;IAED;;OAEG;IACH,YAAY;QACR,IAAI,CAAC,OAAO,GAAG;YACX,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,CAAC;SACvB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,eAAe;QACX,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,MAAM;QACF,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB;;OAEG;IACH,eAAe,CAAC,OAAO;QACnB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1C,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC;QACtE,CAAC;QAED,2CAA2C;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YAE9C,IAAI,GAAG,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7C,iDAAiD;gBACjD,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,CAAC;YAED,IAAI,GAAG,KAAK,UAAU,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACpE,OAAO,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,OAAO,EAAE;QACrC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,OAAO,KAAK,KAAK,UAAU;gBAAE,OAAO,IAAI,CAAC;YAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,aAAa,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC5F,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,OAAO;QACxB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAE7C,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAC/D,CAAC,CACJ,CAAC;QACN,CAAC;QAED,OAAO,UAAU,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO;QAC7B,IAAI,CAAC;YACD,4CAA4C;YAC5C,MAAM,OAAO,GAAG;gBACZ,GAAG,EAAE,OAAO;gBACZ,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;gBAC5B,WAAW,EAAE,WAAW,CAAC,OAAO,CAAC;gBACjC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,QAAQ;aACpF,CAAC;YAEF,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,gCAAgC;YAChC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;gBAC1F,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;YACD,8CAA8C;YAC9C,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO;QACxB,qCAAqC;QACrC,IAAI,CAAC,OAAO,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QAEvC,wDAAwD;QACxD,IAAI,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAEtD,yDAAyD;QACzD,IAAI,aAAa,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;QAErE,sDAAsD;QACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,EAAE,OAAO,CAAC,CAAC;QACvF,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5B,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/rendering/css-manager.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Create a new CSS Manager instance
+ */
+export function createCSSManager(options?: {}): CSSManager;
+/**
+ * CSS Manager Class
+ * Handles CSS file loading, processing, and injection
+ */
+export class CSSManager {
+    constructor(options?: {});
+    options: {
+        basePath: string;
+        minify: boolean;
+        cache: boolean;
+        autoprefixer: boolean;
+    };
+    cache: Map<any, any>;
+    loadedFiles: Set<any>;
+    /**
+     * Load CSS file content
+     */
+    loadCSSFile(filePath: any): Promise<any>;
+    /**
+     * Load multiple CSS files
+     */
+    loadCSSFiles(filePaths: any): Promise<string>;
+    /**
+     * Generate CSS link tags for external files
+     */
+    generateCSSLinks(filePaths: any, baseUrl?: string): any;
+    /**
+     * Generate inline style tag with CSS content
+     */
+    generateInlineStyles(cssContent: any): string;
+    /**
+     * Basic CSS minification
+     */
+    minifyCSS(css: any): any;
+    /**
+     * Escape HTML entities
+     */
+    escapeHtml(text: any): any;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Get loaded file list
+     */
+    getLoadedFiles(): any[];
+}
+/**
+ * Default CSS Manager instance
+ */
+export const defaultCSSManager: CSSManager;
+export namespace cssUtils {
+    /**
+     * Process CSS options from render options
+     */
+    function processCSSOptions(options?: {}): {
+        files: any[];
+        inline: any;
+        links: any[];
+        basePath: any;
+        minify: any;
+        loadInline: boolean;
+    };
+    /**
+     * Generate complete CSS HTML for head section
+     */
+    function generateCSSHtml(cssOptions: any, cssManager?: CSSManager): Promise<string>;
+}
+//# sourceMappingURL=css-manager.d.ts.map

package/dist/rendering/css-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-manager.d.ts","sourceRoot":"","sources":["../../../../src/rendering/css-manager.js"],"names":[],"mappings":"AA6MA;;GAEG;AACH,2DAEC;AA1MD;;;GAGG;AACH;IACI,0BAWC;IAVG;;;;;MAMC;IAED,qBAAsB;IACtB,sBAA4B;IAGhC;;OAEG;IACH,yCA4BC;IAED;;OAEG;IACH,8CAUC;IAED;;OAEG;IACH,wDAcC;IAED;;OAEG;IACH,8CAIC;IAED;;OAEG;IACH,yBAQC;IAED;;OAEG;IACH,2BAGC;IAED;;OAEG;IACH,mBAGC;IAED;;OAEG;IACH,wBAEC;CACJ;AAED;;GAEG;AACH,2CAAkD;;IAM9C;;OAEG;IACH;;;;;;;MAkBC;IAED;;OAEG;IACH,oFA4BC"}

package/dist/rendering/css-manager.js

@@ -0,0 +1,176 @@
+/**
+ * CSS Management System for Coherent.js
+ * Handles CSS file inclusion, inline styles, and optimization
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * CSS Manager Class
+ * Handles CSS file loading, processing, and injection
+ */
+export class CSSManager {
+    constructor(options = {}) {
+        this.options = {
+            basePath: process.cwd(),
+            minify: false,
+            cache: true,
+            autoprefixer: false,
+            ...options
+        };
+        this.cache = new Map();
+        this.loadedFiles = new Set();
+    }
+    /**
+     * Load CSS file content
+     */
+    async loadCSSFile(filePath) {
+        const fullPath = path.resolve(this.options.basePath, filePath);
+        const cacheKey = fullPath;
+        // Return cached content if available
+        if (this.options.cache && this.cache.has(cacheKey)) {
+            return this.cache.get(cacheKey);
+        }
+        try {
+            let content = await fs.readFile(fullPath, 'utf8');
+            // Basic minification if enabled
+            if (this.options.minify) {
+                content = this.minifyCSS(content);
+            }
+            // Cache the content
+            if (this.options.cache) {
+                this.cache.set(cacheKey, content);
+            }
+            this.loadedFiles.add(filePath);
+            return content;
+        }
+        catch (error) {
+            console.warn(`Failed to load CSS file: ${filePath}`, error.message);
+            return '';
+        }
+    }
+    /**
+     * Load multiple CSS files
+     */
+    async loadCSSFiles(filePaths) {
+        if (!Array.isArray(filePaths)) {
+            filePaths = [filePaths];
+        }
+        const cssContents = await Promise.all(filePaths.map(filePath => this.loadCSSFile(filePath)));
+        return cssContents.join('\n');
+    }
+    /**
+     * Generate CSS link tags for external files
+     */
+    generateCSSLinks(filePaths, baseUrl = '/') {
+        if (!Array.isArray(filePaths)) {
+            filePaths = [filePaths];
+        }
+        return filePaths
+            .map(filePath => {
+            const href = filePath.startsWith('http')
+                ? filePath
+                : `${baseUrl}${filePath}`.replace(/\/+/g, '/');
+            return `<link rel="stylesheet" href="${this.escapeHtml(href)}" />`;
+        })
+            .join('\n');
+    }
+    /**
+     * Generate inline style tag with CSS content
+     */
+    generateInlineStyles(cssContent) {
+        if (!cssContent)
+            return '';
+        return `<style type="text/css">\n${cssContent}\n</style>`;
+    }
+    /**
+     * Basic CSS minification
+     */
+    minifyCSS(css) {
+        return css
+            .replace(/\/\*[\s\S]*?\*\//g, '') // Remove comments
+            .replace(/\s+/g, ' ') // Collapse whitespace
+            .replace(/;\s*}/g, '}') // Remove last semicolon in blocks
+            .replace(/{\s+/g, '{') // Remove space after opening brace
+            .replace(/;\s+/g, ';') // Remove space after semicolons
+            .trim();
+    }
+    /**
+     * Escape HTML entities
+     */
+    escapeHtml(text) {
+        const div = { textContent: text };
+        return div.innerHTML || text;
+    }
+    /**
+     * Clear cache
+     */
+    clearCache() {
+        this.cache.clear();
+        this.loadedFiles.clear();
+    }
+    /**
+     * Get loaded file list
+     */
+    getLoadedFiles() {
+        return Array.from(this.loadedFiles);
+    }
+}
+/**
+ * Default CSS Manager instance
+ */
+export const defaultCSSManager = new CSSManager();
+/**
+ * CSS processing utilities
+ */
+export const cssUtils = {
+    /**
+     * Process CSS options from render options
+     */
+    processCSSOptions(options = {}) {
+        const { css = {}, cssFiles = [], inlineCSS = '', cssLinks = [], cssBasePath = process.cwd(), cssMinify = false } = options;
+        return {
+            files: Array.isArray(cssFiles) ? cssFiles : [cssFiles].filter(Boolean),
+            inline: inlineCSS || css.inline || '',
+            links: Array.isArray(cssLinks) ? cssLinks : [cssLinks].filter(Boolean),
+            basePath: css.basePath || cssBasePath,
+            minify: css.minify || cssMinify,
+            loadInline: css.loadInline !== false // default true
+        };
+    },
+    /**
+     * Generate complete CSS HTML for head section
+     */
+    async generateCSSHtml(cssOptions, cssManager = defaultCSSManager) {
+        const cssHtmlParts = [];
+        // Process external CSS links
+        if (cssOptions.links.length > 0) {
+            cssHtmlParts.push(cssManager.generateCSSLinks(cssOptions.links));
+        }
+        // Process CSS files (inline or as links)
+        if (cssOptions.files.length > 0) {
+            if (cssOptions.loadInline) {
+                // Load and inline CSS files
+                const cssContent = await cssManager.loadCSSFiles(cssOptions.files);
+                if (cssContent) {
+                    cssHtmlParts.push(cssManager.generateInlineStyles(cssContent));
+                }
+            }
+            else {
+                // Generate link tags for CSS files
+                cssHtmlParts.push(cssManager.generateCSSLinks(cssOptions.files));
+            }
+        }
+        // Process inline CSS
+        if (cssOptions.inline) {
+            cssHtmlParts.push(cssManager.generateInlineStyles(cssOptions.inline));
+        }
+        return cssHtmlParts.join('\n');
+    }
+};
+/**
+ * Create a new CSS Manager instance
+ */
+export function createCSSManager(options = {}) {
+    return new CSSManager(options);
+}
+//# sourceMappingURL=css-manager.js.map