@frontmcp/ui 0.5.0 → 0.6.0

package/src/render/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * @file render/index.ts
- * @description React 19 static rendering utilities.
- *
- * @module @frontmcp/ui/render
- */
-export { renderToString, renderToStringSync, isReactAvailable } from './prerender';

package/src/render/index.js

@@ -1,14 +0,0 @@
-"use strict";
-/**
- * @file render/index.ts
- * @description React 19 static rendering utilities.
- *
- * @module @frontmcp/ui/render
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReactAvailable = exports.renderToStringSync = exports.renderToString = void 0;
-var prerender_1 = require("./prerender");
-Object.defineProperty(exports, "renderToString", { enumerable: true, get: function () { return prerender_1.renderToString; } });
-Object.defineProperty(exports, "renderToStringSync", { enumerable: true, get: function () { return prerender_1.renderToStringSync; } });
-Object.defineProperty(exports, "isReactAvailable", { enumerable: true, get: function () { return prerender_1.isReactAvailable; } });
-//# sourceMappingURL=index.js.map

package/src/render/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,yCAAmF;AAA1E,2GAAA,cAAc,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAAE,6GAAA,gBAAgB,OAAA","sourcesContent":["/**\n * @file render/index.ts\n * @description React 19 static rendering utilities.\n *\n * @module @frontmcp/ui/render\n */\n\nexport { renderToString, renderToStringSync, isReactAvailable } from './prerender';\n"]}

package/src/render/prerender.d.ts

@@ -1,56 +0,0 @@
-/**
- * @file prerender.ts
- * @description React 19 static rendering utilities.
- *
- * Provides both async (prerender) and sync (renderToStaticMarkup) methods
- * for converting React elements to HTML strings.
- *
- * @example Async rendering (recommended)
- * ```typescript
- * import { renderToString } from '@frontmcp/ui/render';
- * import { Card } from '@frontmcp/ui/components';
- *
- * const html = await renderToString(<Card title="Hello">Content</Card>);
- * ```
- *
- * @example Sync rendering (backwards compatible)
- * ```typescript
- * import { renderToStringSync } from '@frontmcp/ui/render';
- *
- * const html = renderToStringSync(<Card title="Hello">Content</Card>);
- * ```
- *
- * @module @frontmcp/ui/render
- */
-import type { ReactElement } from 'react';
-/**
- * Render a React element to static HTML string using React 19's prerender API.
- *
- * This is the recommended async method that:
- * - Waits for all Suspense boundaries to resolve
- * - Uses React 19's streaming prerender API
- * - Returns clean static HTML without hydration markers
- *
- * @param element - The React element to render
- * @returns Promise resolving to HTML string
- */
-export declare function renderToString(element: ReactElement): Promise<string>;
-/**
- * Render a React element to static HTML string synchronously.
- *
- * This is the sync method for backwards compatibility that:
- * - Does NOT wait for Suspense boundaries
- * - Uses React's renderToStaticMarkup
- * - Returns clean static HTML without hydration markers
- *
- * @param element - The React element to render
- * @returns HTML string
- */
-export declare function renderToStringSync(element: ReactElement): string;
-/**
- * Check if React and react-dom are available.
- * Useful for conditional rendering in environments where React may not be installed.
- *
- * @returns true if React and react-dom are available
- */
-export declare function isReactAvailable(): boolean;

package/src/render/prerender.js

@@ -1,98 +0,0 @@
-"use strict";
-/**
- * @file prerender.ts
- * @description React 19 static rendering utilities.
- *
- * Provides both async (prerender) and sync (renderToStaticMarkup) methods
- * for converting React elements to HTML strings.
- *
- * @example Async rendering (recommended)
- * ```typescript
- * import { renderToString } from '@frontmcp/ui/render';
- * import { Card } from '@frontmcp/ui/components';
- *
- * const html = await renderToString(<Card title="Hello">Content</Card>);
- * ```
- *
- * @example Sync rendering (backwards compatible)
- * ```typescript
- * import { renderToStringSync } from '@frontmcp/ui/render';
- *
- * const html = renderToStringSync(<Card title="Hello">Content</Card>);
- * ```
- *
- * @module @frontmcp/ui/render
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderToString = renderToString;
-exports.renderToStringSync = renderToStringSync;
-exports.isReactAvailable = isReactAvailable;
-/**
- * Render a React element to static HTML string using React 19's prerender API.
- *
- * This is the recommended async method that:
- * - Waits for all Suspense boundaries to resolve
- * - Uses React 19's streaming prerender API
- * - Returns clean static HTML without hydration markers
- *
- * @param element - The React element to render
- * @returns Promise resolving to HTML string
- */
-async function renderToString(element) {
-    // Dynamically import to avoid issues when react-dom is not installed
-    const { prerender } = await import('react-dom/static');
-    const { prelude } = await prerender(element);
-    // Convert ReadableStream to string
-    const reader = prelude.getReader();
-    const chunks = [];
-    while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        if (value)
-            chunks.push(value);
-    }
-    // Concatenate all chunks and decode
-    const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
-    const combined = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-        combined.set(chunk, offset);
-        offset += chunk.length;
-    }
-    return new TextDecoder().decode(combined);
-}
-/**
- * Render a React element to static HTML string synchronously.
- *
- * This is the sync method for backwards compatibility that:
- * - Does NOT wait for Suspense boundaries
- * - Uses React's renderToStaticMarkup
- * - Returns clean static HTML without hydration markers
- *
- * @param element - The React element to render
- * @returns HTML string
- */
-function renderToStringSync(element) {
-    // Use dynamic require to handle optional react-dom dependency
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const ReactDOMServer = require('react-dom/server');
-    return ReactDOMServer.renderToStaticMarkup(element);
-}
-/**
- * Check if React and react-dom are available.
- * Useful for conditional rendering in environments where React may not be installed.
- *
- * @returns true if React and react-dom are available
- */
-function isReactAvailable() {
-    try {
-        require('react');
-        require('react-dom/server');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=prerender.js.map

package/src/render/prerender.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../../../src/render/prerender.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAgBH,wCA0BC;AAaD,gDAKC;AAQD,4CAQC;AAvED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,cAAc,CAAC,OAAqB;IACxD,qEAAqE;IACrE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IAE7C,mCAAmC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACnC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,IAAI,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAAC,OAAqB;IACtD,8DAA8D;IAC9D,iEAAiE;IACjE,MAAM,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnD,OAAO,cAAc,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC9B,IAAI,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["/**\n * @file prerender.ts\n * @description React 19 static rendering utilities.\n *\n * Provides both async (prerender) and sync (renderToStaticMarkup) methods\n * for converting React elements to HTML strings.\n *\n * @example Async rendering (recommended)\n * ```typescript\n * import { renderToString } from '@frontmcp/ui/render';\n * import { Card } from '@frontmcp/ui/components';\n *\n * const html = await renderToString(<Card title=\"Hello\">Content</Card>);\n * ```\n *\n * @example Sync rendering (backwards compatible)\n * ```typescript\n * import { renderToStringSync } from '@frontmcp/ui/render';\n *\n * const html = renderToStringSync(<Card title=\"Hello\">Content</Card>);\n * ```\n *\n * @module @frontmcp/ui/render\n */\n\n/// <reference path=\"./react-dom-static.d.ts\" />\nimport type { ReactElement } from 'react';\n\n/**\n * Render a React element to static HTML string using React 19's prerender API.\n *\n * This is the recommended async method that:\n * - Waits for all Suspense boundaries to resolve\n * - Uses React 19's streaming prerender API\n * - Returns clean static HTML without hydration markers\n *\n * @param element - The React element to render\n * @returns Promise resolving to HTML string\n */\nexport async function renderToString(element: ReactElement): Promise<string> {\n  // Dynamically import to avoid issues when react-dom is not installed\n  const { prerender } = await import('react-dom/static');\n\n  const { prelude } = await prerender(element);\n\n  // Convert ReadableStream to string\n  const reader = prelude.getReader();\n  const chunks: Uint8Array[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    if (value) chunks.push(value);\n  }\n\n  // Concatenate all chunks and decode\n  const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);\n  const combined = new Uint8Array(totalLength);\n  let offset = 0;\n  for (const chunk of chunks) {\n    combined.set(chunk, offset);\n    offset += chunk.length;\n  }\n\n  return new TextDecoder().decode(combined);\n}\n\n/**\n * Render a React element to static HTML string synchronously.\n *\n * This is the sync method for backwards compatibility that:\n * - Does NOT wait for Suspense boundaries\n * - Uses React's renderToStaticMarkup\n * - Returns clean static HTML without hydration markers\n *\n * @param element - The React element to render\n * @returns HTML string\n */\nexport function renderToStringSync(element: ReactElement): string {\n  // Use dynamic require to handle optional react-dom dependency\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const ReactDOMServer = require('react-dom/server');\n  return ReactDOMServer.renderToStaticMarkup(element);\n}\n\n/**\n * Check if React and react-dom are available.\n * Useful for conditional rendering in environments where React may not be installed.\n *\n * @returns true if React and react-dom are available\n */\nexport function isReactAvailable(): boolean {\n  try {\n    require('react');\n    require('react-dom/server');\n    return true;\n  } catch {\n    return false;\n  }\n}\n"]}

package/src/renderers/cache.d.ts

@@ -1,144 +0,0 @@
-/**
- * LRU Cache for Renderer Transpilation Results
- *
- * Provides fast, memory-bounded caching for transpiled templates.
- * Uses content-addressable keys (hash of source) for deduplication.
- */
-import type { TranspileResult } from './types';
-/**
- * Options for the transpile cache.
- */
-export interface TranspileCacheOptions {
-    /** Maximum number of entries (default: 500) */
-    maxSize?: number;
-    /** TTL in milliseconds, 0 = infinite (default: 0 for transpile cache) */
-    ttl?: number;
-}
-/**
- * LRU Cache for transpiled template results.
- *
- * Features:
- * - Content-addressable keys via hash
- * - LRU eviction when max size reached
- * - Optional TTL for time-based expiration
- * - Access statistics
- *
- * @example
- * ```typescript
- * const cache = new TranspileCache({ maxSize: 500 });
- *
- * // Store a transpiled result
- * const hash = cache.set(sourceCode, transpileResult);
- *
- * // Retrieve it later
- * const result = cache.get(sourceCode);
- * if (result) {
- *   console.log('Cache hit!', result.code);
- * }
- * ```
- */
-export declare class TranspileCache {
-    private cache;
-    private readonly maxSize;
-    private readonly ttl;
-    /** Cache statistics */
-    private stats;
-    constructor(options?: TranspileCacheOptions);
-    /**
-     * Get a cached transpile result by source content.
-     *
-     * @param source - Source code to look up
-     * @returns Cached result or undefined if not found/expired
-     */
-    get(source: string): TranspileResult | undefined;
-    /**
-     * Get a cached transpile result by hash key.
-     *
-     * @param key - Hash key
-     * @returns Cached result or undefined if not found/expired
-     */
-    getByKey(key: string): TranspileResult | undefined;
-    /**
-     * Store a transpile result.
-     *
-     * @param source - Source code (used to generate key)
-     * @param value - Transpile result to cache
-     * @returns The hash key used for storage
-     */
-    set(source: string, value: TranspileResult): string;
-    /**
-     * Store a transpile result by hash key.
-     *
-     * @param key - Hash key
-     * @param value - Transpile result to cache
-     */
-    setByKey(key: string, value: TranspileResult): void;
-    /**
-     * Check if a source is cached.
-     *
-     * @param source - Source code to check
-     * @returns True if cached and not expired
-     */
-    has(source: string): boolean;
-    /**
-     * Check if a key is cached.
-     *
-     * @param key - Hash key to check
-     * @returns True if cached and not expired
-     */
-    hasByKey(key: string): boolean;
-    /**
-     * Delete a cached entry by source.
-     *
-     * @param source - Source code to delete
-     * @returns True if entry was deleted
-     */
-    delete(source: string): boolean;
-    /**
-     * Clear all cached entries.
-     */
-    clear(): void;
-    /**
-     * Get current cache size.
-     */
-    get size(): number;
-    /**
-     * Get cache statistics.
-     */
-    getStats(): {
-        hits: number;
-        misses: number;
-        evictions: number;
-        size: number;
-        hitRate: number;
-    };
-}
-/**
- * Global transpile cache instance.
- * Shared across all renderers for deduplication.
- */
-export declare const transpileCache: TranspileCache;
-/**
- * Render cache for full HTML output.
- * Uses shorter TTL since outputs depend on input/output data.
- */
-export declare const renderCache: TranspileCache;
-/**
- * Simple LRU cache for storing any type of values.
- * Used for caching compiled components (React/MDX).
- */
-export declare class ComponentCache<T = unknown> {
-    private cache;
-    private readonly maxSize;
-    constructor(maxSize?: number);
-    get(key: string): T | undefined;
-    set(key: string, value: T): void;
-    has(key: string): boolean;
-    delete(key: string): boolean;
-    clear(): void;
-    get size(): number;
-}
-/**
- * Global component cache for storing compiled React/MDX components.
- */
-export declare const componentCache: ComponentCache<unknown>;

package/src/renderers/cache.js

@@ -1,240 +0,0 @@
-"use strict";
-/**
- * LRU Cache for Renderer Transpilation Results
- *
- * Provides fast, memory-bounded caching for transpiled templates.
- * Uses content-addressable keys (hash of source) for deduplication.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.componentCache = exports.ComponentCache = exports.renderCache = exports.transpileCache = exports.TranspileCache = void 0;
-const hash_1 = require("./utils/hash");
-/**
- * LRU Cache for transpiled template results.
- *
- * Features:
- * - Content-addressable keys via hash
- * - LRU eviction when max size reached
- * - Optional TTL for time-based expiration
- * - Access statistics
- *
- * @example
- * ```typescript
- * const cache = new TranspileCache({ maxSize: 500 });
- *
- * // Store a transpiled result
- * const hash = cache.set(sourceCode, transpileResult);
- *
- * // Retrieve it later
- * const result = cache.get(sourceCode);
- * if (result) {
- *   console.log('Cache hit!', result.code);
- * }
- * ```
- */
-class TranspileCache {
-    cache = new Map();
-    maxSize;
-    ttl;
-    /** Cache statistics */
-    stats = {
-        hits: 0,
-        misses: 0,
-        evictions: 0,
-    };
-    constructor(options = {}) {
-        this.maxSize = options.maxSize ?? 500;
-        this.ttl = options.ttl ?? 0; // 0 = infinite TTL
-    }
-    /**
-     * Get a cached transpile result by source content.
-     *
-     * @param source - Source code to look up
-     * @returns Cached result or undefined if not found/expired
-     */
-    get(source) {
-        const key = (0, hash_1.hashString)(source);
-        return this.getByKey(key);
-    }
-    /**
-     * Get a cached transpile result by hash key.
-     *
-     * @param key - Hash key
-     * @returns Cached result or undefined if not found/expired
-     */
-    getByKey(key) {
-        const entry = this.cache.get(key);
-        if (!entry) {
-            this.stats.misses++;
-            return undefined;
-        }
-        // Check TTL expiration
-        if (this.ttl > 0 && Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            this.stats.misses++;
-            return undefined;
-        }
-        // Move to end for LRU (delete and re-add)
-        this.cache.delete(key);
-        entry.accessCount++;
-        this.cache.set(key, entry);
-        this.stats.hits++;
-        return entry.value;
-    }
-    /**
-     * Store a transpile result.
-     *
-     * @param source - Source code (used to generate key)
-     * @param value - Transpile result to cache
-     * @returns The hash key used for storage
-     */
-    set(source, value) {
-        const key = (0, hash_1.hashString)(source);
-        this.setByKey(key, value);
-        return key;
-    }
-    /**
-     * Store a transpile result by hash key.
-     *
-     * @param key - Hash key
-     * @param value - Transpile result to cache
-     */
-    setByKey(key, value) {
-        // Enforce size limit with LRU eviction
-        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-            // Remove oldest entry (first in Map iteration order)
-            const oldestKey = this.cache.keys().next().value;
-            if (oldestKey) {
-                this.cache.delete(oldestKey);
-                this.stats.evictions++;
-            }
-        }
-        this.cache.set(key, {
-            value,
-            timestamp: Date.now(),
-            accessCount: 1,
-        });
-    }
-    /**
-     * Check if a source is cached.
-     *
-     * @param source - Source code to check
-     * @returns True if cached and not expired
-     */
-    has(source) {
-        const key = (0, hash_1.hashString)(source);
-        return this.hasByKey(key);
-    }
-    /**
-     * Check if a key is cached.
-     *
-     * @param key - Hash key to check
-     * @returns True if cached and not expired
-     */
-    hasByKey(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return false;
-        // Check TTL
-        if (this.ttl > 0 && Date.now() - entry.timestamp > this.ttl) {
-            this.cache.delete(key);
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Delete a cached entry by source.
-     *
-     * @param source - Source code to delete
-     * @returns True if entry was deleted
-     */
-    delete(source) {
-        const key = (0, hash_1.hashString)(source);
-        return this.cache.delete(key);
-    }
-    /**
-     * Clear all cached entries.
-     */
-    clear() {
-        this.cache.clear();
-        this.stats = { hits: 0, misses: 0, evictions: 0 };
-    }
-    /**
-     * Get current cache size.
-     */
-    get size() {
-        return this.cache.size;
-    }
-    /**
-     * Get cache statistics.
-     */
-    getStats() {
-        const total = this.stats.hits + this.stats.misses;
-        return {
-            ...this.stats,
-            size: this.cache.size,
-            hitRate: total > 0 ? this.stats.hits / total : 0,
-        };
-    }
-}
-exports.TranspileCache = TranspileCache;
-/**
- * Global transpile cache instance.
- * Shared across all renderers for deduplication.
- */
-exports.transpileCache = new TranspileCache({ maxSize: 500 });
-/**
- * Render cache for full HTML output.
- * Uses shorter TTL since outputs depend on input/output data.
- */
-exports.renderCache = new TranspileCache({
-    maxSize: 1000,
-    ttl: 5 * 60 * 1000, // 5 minutes
-});
-/**
- * Simple LRU cache for storing any type of values.
- * Used for caching compiled components (React/MDX).
- */
-class ComponentCache {
-    cache = new Map();
-    maxSize;
-    constructor(maxSize = 200) {
-        this.maxSize = maxSize;
-    }
-    get(key) {
-        const entry = this.cache.get(key);
-        if (!entry)
-            return undefined;
-        // Move to end for LRU
-        this.cache.delete(key);
-        this.cache.set(key, entry);
-        return entry.value;
-    }
-    set(key, value) {
-        // Enforce size limit with LRU eviction
-        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
-            const oldestKey = this.cache.keys().next().value;
-            if (oldestKey) {
-                this.cache.delete(oldestKey);
-            }
-        }
-        this.cache.set(key, { value, timestamp: Date.now() });
-    }
-    has(key) {
-        return this.cache.has(key);
-    }
-    delete(key) {
-        return this.cache.delete(key);
-    }
-    clear() {
-        this.cache.clear();
-    }
-    get size() {
-        return this.cache.size;
-    }
-}
-exports.ComponentCache = ComponentCache;
-/**
- * Global component cache for storing compiled React/MDX components.
- */
-exports.componentCache = new ComponentCache();
-//# sourceMappingURL=cache.js.map

package/src/renderers/cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/renderers/cache.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * LRU Cache for Renderer Transpilation Results\n *\n * Provides fast, memory-bounded caching for transpiled templates.\n * Uses content-addressable keys (hash of source) for deduplication.\n */\n\nimport { hashString } from './utils/hash';\nimport type { TranspileResult } from './types';\n\n/**\n * Cache entry with metadata.\n */\ninterface CacheEntry<T> {\n  /** Cached value */\n  value: T;\n  /** Timestamp when entry was created */\n  timestamp: number;\n  /** Number of times this entry was accessed */\n  accessCount: number;\n}\n\n/**\n * Options for the transpile cache.\n */\nexport interface TranspileCacheOptions {\n  /** Maximum number of entries (default: 500) */\n  maxSize?: number;\n  /** TTL in milliseconds, 0 = infinite (default: 0 for transpile cache) */\n  ttl?: number;\n}\n\n/**\n * LRU Cache for transpiled template results.\n *\n * Features:\n * - Content-addressable keys via hash\n * - LRU eviction when max size reached\n * - Optional TTL for time-based expiration\n * - Access statistics\n *\n * @example\n * ```typescript\n * const cache = new TranspileCache({ maxSize: 500 });\n *\n * // Store a transpiled result\n * const hash = cache.set(sourceCode, transpileResult);\n *\n * // Retrieve it later\n * const result = cache.get(sourceCode);\n * if (result) {\n *   console.log('Cache hit!', result.code);\n * }\n * ```\n */\nexport class TranspileCache {\n  private cache = new Map<string, CacheEntry<TranspileResult>>();\n  private readonly maxSize: number;\n  private readonly ttl: number;\n\n  /** Cache statistics */\n  private stats = {\n    hits: 0,\n    misses: 0,\n    evictions: 0,\n  };\n\n  constructor(options: TranspileCacheOptions = {}) {\n    this.maxSize = options.maxSize ?? 500;\n    this.ttl = options.ttl ?? 0; // 0 = infinite TTL\n  }\n\n  /**\n   * Get a cached transpile result by source content.\n   *\n   * @param source - Source code to look up\n   * @returns Cached result or undefined if not found/expired\n   */\n  get(source: string): TranspileResult | undefined {\n    const key = hashString(source);\n    return this.getByKey(key);\n  }\n\n  /**\n   * Get a cached transpile result by hash key.\n   *\n   * @param key - Hash key\n   * @returns Cached result or undefined if not found/expired\n   */\n  getByKey(key: string): TranspileResult | undefined {\n    const entry = this.cache.get(key);\n\n    if (!entry) {\n      this.stats.misses++;\n      return undefined;\n    }\n\n    // Check TTL expiration\n    if (this.ttl > 0 && Date.now() - entry.timestamp > this.ttl) {\n      this.cache.delete(key);\n      this.stats.misses++;\n      return undefined;\n    }\n\n    // Move to end for LRU (delete and re-add)\n    this.cache.delete(key);\n    entry.accessCount++;\n    this.cache.set(key, entry);\n\n    this.stats.hits++;\n    return entry.value;\n  }\n\n  /**\n   * Store a transpile result.\n   *\n   * @param source - Source code (used to generate key)\n   * @param value - Transpile result to cache\n   * @returns The hash key used for storage\n   */\n  set(source: string, value: TranspileResult): string {\n    const key = hashString(source);\n    this.setByKey(key, value);\n    return key;\n  }\n\n  /**\n   * Store a transpile result by hash key.\n   *\n   * @param key - Hash key\n   * @param value - Transpile result to cache\n   */\n  setByKey(key: string, value: TranspileResult): void {\n    // Enforce size limit with LRU eviction\n    if (this.cache.size >= this.maxSize && !this.cache.has(key)) {\n      // Remove oldest entry (first in Map iteration order)\n      const oldestKey = this.cache.keys().next().value;\n      if (oldestKey) {\n        this.cache.delete(oldestKey);\n        this.stats.evictions++;\n      }\n    }\n\n    this.cache.set(key, {\n      value,\n      timestamp: Date.now(),\n      accessCount: 1,\n    });\n  }\n\n  /**\n   * Check if a source is cached.\n   *\n   * @param source - Source code to check\n   * @returns True if cached and not expired\n   */\n  has(source: string): boolean {\n    const key = hashString(source);\n    return this.hasByKey(key);\n  }\n\n  /**\n   * Check if a key is cached.\n   *\n   * @param key - Hash key to check\n   * @returns True if cached and not expired\n   */\n  hasByKey(key: string): boolean {\n    const entry = this.cache.get(key);\n    if (!entry) return false;\n\n    // Check TTL\n    if (this.ttl > 0 && Date.now() - entry.timestamp > this.ttl) {\n      this.cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Delete a cached entry by source.\n   *\n   * @param source - Source code to delete\n   * @returns True if entry was deleted\n   */\n  delete(source: string): boolean {\n    const key = hashString(source);\n    return this.cache.delete(key);\n  }\n\n  /**\n   * Clear all cached entries.\n   */\n  clear(): void {\n    this.cache.clear();\n    this.stats = { hits: 0, misses: 0, evictions: 0 };\n  }\n\n  /**\n   * Get current cache size.\n   */\n  get size(): number {\n    return this.cache.size;\n  }\n\n  /**\n   * Get cache statistics.\n   */\n  getStats(): { hits: number; misses: number; evictions: number; size: number; hitRate: number } {\n    const total = this.stats.hits + this.stats.misses;\n    return {\n      ...this.stats,\n      size: this.cache.size,\n      hitRate: total > 0 ? this.stats.hits / total : 0,\n    };\n  }\n}\n\n/**\n * Global transpile cache instance.\n * Shared across all renderers for deduplication.\n */\nexport const transpileCache = new TranspileCache({ maxSize: 500 });\n\n/**\n * Render cache for full HTML output.\n * Uses shorter TTL since outputs depend on input/output data.\n */\nexport const renderCache = new TranspileCache({\n  maxSize: 1000,\n  ttl: 5 * 60 * 1000, // 5 minutes\n});\n\n/**\n * Simple LRU cache for storing any type of values.\n * Used for caching compiled components (React/MDX).\n */\nexport class ComponentCache<T = unknown> {\n  private cache = new Map<string, { value: T; timestamp: number }>();\n  private readonly maxSize: number;\n\n  constructor(maxSize = 200) {\n    this.maxSize = maxSize;\n  }\n\n  get(key: string): T | undefined {\n    const entry = this.cache.get(key);\n    if (!entry) return undefined;\n\n    // Move to end for LRU\n    this.cache.delete(key);\n    this.cache.set(key, entry);\n    return entry.value;\n  }\n\n  set(key: string, value: T): void {\n    // Enforce size limit with LRU eviction\n    if (this.cache.size >= this.maxSize && !this.cache.has(key)) {\n      const oldestKey = this.cache.keys().next().value;\n      if (oldestKey) {\n        this.cache.delete(oldestKey);\n      }\n    }\n\n    this.cache.set(key, { value, timestamp: Date.now() });\n  }\n\n  has(key: string): boolean {\n    return this.cache.has(key);\n  }\n\n  delete(key: string): boolean {\n    return this.cache.delete(key);\n  }\n\n  clear(): void {\n    this.cache.clear();\n  }\n\n  get size(): number {\n    return this.cache.size;\n  }\n}\n\n/**\n * Global component cache for storing compiled React/MDX components.\n */\nexport const componentCache = new ComponentCache();\n"]}