@frontmcp/ui 0.5.0

package/src/render/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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

@@ -0,0 +1,14 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,56 @@
+/**
+ * @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

@@ -0,0 +1,98 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,144 @@
+/**
+ * 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

@@ -0,0 +1,240 @@
+"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

@@ -0,0 +1 @@
+{"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"]}