ai-props 2.1.3 → 2.4.0

package/dist/hono-jsx.js

@@ -0,0 +1,459 @@
+/**
+ * hono/jsx integration for AI-powered props with hydration and streaming
+ *
+ * This module provides:
+ * - Hydration data collection during server render
+ * - Streaming render support with hono/jsx
+ * - AI-powered component prop generation
+ * - Context-aware rendering with Suspense support
+ *
+ * Bead: aip-fxpy (tests), aip-z57t (implementation)
+ *
+ * @packageDocumentation
+ */
+import { generateProps, mergeWithGenerated } from './generate.js';
+// ============================================================================
+// Global hydration context (for useHydration hook simulation)
+// ============================================================================
+let globalHydrationContext = null;
+// ============================================================================
+// Hydration Data Collection
+// ============================================================================
+/**
+ * Create hydration data with the toJSON method
+ */
+function createHydrationData(components, tree) {
+    return {
+        components,
+        tree,
+        toJSON() {
+            return serializeHydrationData(this);
+        },
+    };
+}
+/**
+ * Collect hydration data from a component render
+ *
+ * @param component - Component function to render
+ * @param props - Props to pass to component
+ * @returns Hydration data collected during render
+ */
+export async function collectHydrationData(component, props) {
+    // Create a hydration context
+    const ctx = createHydrationContext();
+    // Store global context for nested components
+    const prevContext = globalHydrationContext;
+    globalHydrationContext = ctx;
+    try {
+        // Get component name
+        const componentName = component.name || 'Anonymous';
+        // Register the component
+        ctx.register(componentName, props);
+        // Render the component (this might trigger nested registrations)
+        await component(props);
+        // Return collected data
+        return ctx.getData();
+    }
+    finally {
+        // Restore previous context
+        globalHydrationContext = prevContext;
+    }
+}
+/**
+ * Create a hydration context for tracking component renders
+ *
+ * @returns New hydration context
+ */
+export function createHydrationContext() {
+    const components = new Map();
+    const tree = [];
+    let idCounter = 0;
+    return {
+        register(componentName, props) {
+            const id = `${componentName}-${idCounter++}`;
+            components.set(componentName, props);
+            const node = {
+                id,
+                component: componentName,
+                props,
+                children: [],
+            };
+            tree.push(node);
+            return id;
+        },
+        getData() {
+            return createHydrationData(new Map(components), [...tree]);
+        },
+        clear() {
+            components.clear();
+            tree.length = 0;
+            idCounter = 0;
+        },
+    };
+}
+/**
+ * Serialize hydration data to JSON string
+ *
+ * @param data - Hydration data to serialize
+ * @returns JSON string safe for script embedding
+ */
+export function serializeHydrationData(data) {
+    // Convert Map to object for serialization
+    const componentsObj = {};
+    // Use a WeakSet to detect circular references
+    const seen = new WeakSet();
+    function sanitizeValue(value) {
+        if (value === null || value === undefined) {
+            return value;
+        }
+        if (typeof value === 'object') {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+            if (Array.isArray(value)) {
+                return value.map(sanitizeValue);
+            }
+            const result = {};
+            for (const [k, v] of Object.entries(value)) {
+                result[k] = sanitizeValue(v);
+            }
+            return result;
+        }
+        return value;
+    }
+    for (const [key, value] of data.components) {
+        componentsObj[key] = sanitizeValue(value);
+    }
+    const serializable = {
+        components: componentsObj,
+        tree: data.tree.map((node) => ({
+            id: node.id,
+            component: node.component,
+            props: sanitizeValue(node.props),
+            children: node.children,
+        })),
+    };
+    let json = JSON.stringify(serializable);
+    // Escape script tags to prevent XSS
+    json = json.replace(/<script/gi, '\\u003cscript');
+    json = json.replace(/<\/script/gi, '\\u003c/script');
+    return json;
+}
+/**
+ * Provider component that enables hydration tracking for children
+ *
+ * @param props - Provider props with context and children
+ * @returns Rendered output with hydration tracking
+ */
+export function HydrationProvider(props) {
+    // Store context globally for nested components
+    const prevContext = globalHydrationContext;
+    globalHydrationContext = props.context;
+    try {
+        // Return children - in a real JSX environment this would render them
+        return props.children;
+    }
+    finally {
+        // Note: In real JSX, we'd restore on unmount, not here
+        // For our purposes, we keep it set for the duration
+        globalHydrationContext = prevContext;
+    }
+}
+/**
+ * Hook to access hydration context from within a component
+ *
+ * @returns Current hydration context
+ */
+export function useHydration() {
+    if (!globalHydrationContext) {
+        // Return a no-op context if not in a HydrationProvider
+        return createHydrationContext();
+    }
+    return globalHydrationContext;
+}
+// ============================================================================
+// Streaming Render
+// ============================================================================
+/**
+ * Render a component to a ReadableStream
+ *
+ * @param component - Component function to render
+ * @param props - Props to pass to component
+ * @param options - Streaming options
+ * @returns ReadableStream of rendered HTML
+ */
+export async function renderToReadableStream(component, props, options) {
+    const encoder = new TextEncoder();
+    return new ReadableStream({
+        async start(controller) {
+            try {
+                // Create hydration context if needed
+                const ctx = options?.includeHydration ? createHydrationContext() : null;
+                if (ctx) {
+                    globalHydrationContext = ctx;
+                }
+                // Render the component
+                let content;
+                try {
+                    content = await component(props);
+                }
+                catch (error) {
+                    if (options?.onError && error instanceof Error) {
+                        content = options.onError(error);
+                    }
+                    else {
+                        throw error;
+                    }
+                }
+                // Enqueue the content in chunks for streaming behavior
+                const chunkSize = 1024;
+                for (let i = 0; i < content.length; i += chunkSize) {
+                    const chunk = content.slice(i, i + chunkSize);
+                    controller.enqueue(encoder.encode(chunk));
+                }
+                // Add hydration script if requested
+                if (options?.includeHydration && ctx) {
+                    const componentName = component.name || 'Anonymous';
+                    ctx.register(componentName, props);
+                    const hydrationData = ctx.getData();
+                    const hydrationScript = `<script>window.__HYDRATION_DATA__=${serializeHydrationData(hydrationData)}</script>`;
+                    controller.enqueue(encoder.encode(hydrationScript));
+                }
+                controller.close();
+            }
+            catch (error) {
+                controller.error(error);
+            }
+            finally {
+                globalHydrationContext = null;
+            }
+        },
+    });
+}
+/**
+ * Create a streaming Response from a component
+ *
+ * @param component - Component function to render
+ * @param props - Props to pass to component
+ * @param options - Streaming options
+ * @returns Response with streaming body
+ */
+export async function streamJSXResponse(component, props, options) {
+    const stream = await renderToReadableStream(component, props, options);
+    const headers = new Headers({
+        'Content-Type': 'text/html; charset=utf-8',
+        ...options?.headers,
+    });
+    // Don't set Content-Length for streaming responses
+    if (options?.streaming) {
+        // Transfer-Encoding is typically set automatically by the runtime
+    }
+    return new Response(stream, {
+        status: 200,
+        headers,
+    });
+}
+/**
+ * Create a reusable streaming renderer with configuration
+ *
+ * @param options - Renderer options
+ * @returns Streaming renderer instance
+ */
+export function createStreamingRenderer(options) {
+    return {
+        async render(component, props) {
+            const encoder = new TextEncoder();
+            return new ReadableStream({
+                async start(controller) {
+                    try {
+                        // Create hydration context
+                        const ctx = options.includeHydration ? createHydrationContext() : null;
+                        if (ctx) {
+                            globalHydrationContext = ctx;
+                        }
+                        // Render the component
+                        const content = await component(props);
+                        // Register for hydration data
+                        if (ctx) {
+                            const componentName = component.name || 'Anonymous';
+                            ctx.register(componentName, props);
+                        }
+                        // Get hydration data
+                        let hydrationJson = '';
+                        if (options.includeHydration && ctx) {
+                            hydrationJson = serializeHydrationData(ctx.getData());
+                        }
+                        // Apply shell wrapper if provided
+                        let output;
+                        if (options.shell) {
+                            // When using shell, pass hydration data with __HYDRATION_DATA__ prefix
+                            // so the shell can embed it directly in a script tag
+                            const hydrationScript = hydrationJson
+                                ? `window.__HYDRATION_DATA__=${hydrationJson}`
+                                : '';
+                            output = options.shell(content, hydrationScript);
+                        }
+                        else {
+                            output = content;
+                            if (options.includeHydration && hydrationJson) {
+                                output += `<script>window.__HYDRATION_DATA__=${hydrationJson}</script>`;
+                            }
+                        }
+                        // Prepend doctype if provided
+                        if (options.doctype) {
+                            output = options.doctype + '\n' + output;
+                        }
+                        // Stream in chunks
+                        const chunkSize = 1024;
+                        for (let i = 0; i < output.length; i += chunkSize) {
+                            const chunk = output.slice(i, i + chunkSize);
+                            controller.enqueue(encoder.encode(chunk));
+                        }
+                        controller.close();
+                    }
+                    catch (error) {
+                        controller.error(error);
+                    }
+                    finally {
+                        globalHydrationContext = null;
+                    }
+                },
+            });
+        },
+    };
+}
+// ============================================================================
+// AI Component Creation
+// ============================================================================
+/**
+ * Create a component with AI-powered prop generation
+ *
+ * @param options - Component options including schema and render function
+ * @returns AI-enhanced component function
+ */
+export function createAIComponent(options) {
+    const { name, schema, render, fallback, progressive } = options;
+    const aiComponent = async (props) => {
+        const { context, ...partialProps } = props;
+        // Check which props are missing
+        const schemaKeys = Object.keys(schema);
+        const providedKeys = Object.keys(partialProps);
+        const missingKeys = schemaKeys.filter((k) => !providedKeys.includes(k));
+        let finalProps;
+        if (missingKeys.length === 0) {
+            // All props provided, no generation needed
+            finalProps = partialProps;
+        }
+        else {
+            // Generate missing props
+            try {
+                // Build schema for only missing props
+                const missingSchema = {};
+                for (const key of missingKeys) {
+                    const schemaValue = schema[key];
+                    if (schemaValue !== undefined) {
+                        missingSchema[key] = schemaValue;
+                    }
+                }
+                const result = await generateProps({
+                    schema: missingSchema,
+                    context: context || partialProps,
+                });
+                finalProps = {
+                    ...result.props,
+                    ...partialProps,
+                };
+            }
+            catch (error) {
+                // Use fallback on error
+                if (fallback) {
+                    finalProps = {
+                        ...fallback,
+                        ...partialProps,
+                    };
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        // Render the component
+        return render(finalProps);
+    };
+    // Attach schema and metadata
+    aiComponent.schema = schema;
+    aiComponent.displayName = `AI(${name})`;
+    return aiComponent;
+}
+/**
+ * Wrap an existing component with AI prop generation
+ *
+ * @param component - Component function to wrap
+ * @param options - AI props options
+ * @returns Wrapped component with AI props
+ */
+export function withAIProps(component, options) {
+    const { schema, fallback } = options;
+    const wrappedComponent = async (props) => {
+        const { context, ...partialProps } = props;
+        // Check which props are missing
+        const schemaKeys = Object.keys(schema);
+        const providedKeys = Object.keys(partialProps);
+        const missingKeys = schemaKeys.filter((k) => !providedKeys.includes(k));
+        let finalProps;
+        if (missingKeys.length === 0) {
+            // All props provided
+            finalProps = partialProps;
+        }
+        else {
+            // Generate missing props
+            try {
+                const missingSchema = {};
+                for (const key of missingKeys) {
+                    const schemaValue = schema[key];
+                    if (schemaValue !== undefined) {
+                        missingSchema[key] = schemaValue;
+                    }
+                }
+                const result = await generateProps({
+                    schema: missingSchema,
+                    context: context || partialProps,
+                });
+                finalProps = {
+                    ...result.props,
+                    ...partialProps,
+                };
+            }
+            catch (error) {
+                if (fallback) {
+                    finalProps = {
+                        ...fallback,
+                        ...partialProps,
+                    };
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        return component(finalProps);
+    };
+    // Preserve displayName
+    const originalName = component.displayName || component.name || 'Component';
+    wrappedComponent.schema = schema;
+    wrappedComponent.displayName = `withAIProps(${originalName})`;
+    return wrappedComponent;
+}
+/**
+ * Provider component for AI props configuration
+ *
+ * @param props - Provider props with config and children
+ * @returns Rendered output with AI props context
+ */
+export function AIPropsProvider(props) {
+    // Store configuration globally (in a real implementation, use React Context)
+    // For now, we just pass through children
+    return props.children;
+}
+//# sourceMappingURL=hono-jsx.js.map

package/dist/hono-jsx.js.map

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

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export { generateProps, getPropsSync, prefetchProps, generatePropsMany, mergeWit
 export { MemoryPropsCache, LRUPropsCache, createCacheKey, getDefaultCache, configureCache, clearCache, DEFAULT_CACHE_TTL, } from './cache.js';
 export { createPropsEnhancer, createAsyncPropsProvider, createPropsTransformer, createConditionalGenerator, createBatchGenerator, type WithAIPropsOptions, } from './hoc.js';
 export { validateProps, hasRequiredProps, getMissingProps, isComplete, getMissingFromSchema, sanitizeProps, mergeWithDefaults, createValidator, assertValidProps, } from './validate.js';
+export { parseMDX, extractComponentSchemas, renderMDXWithProps, streamMDXWithProps, createMDXPropsGenerator, compileMDX, clearMDXCache, getMDXCacheSize, configureMDXCache, getMDXCacheStats, invalidateMDXCacheByTag, cleanupMDXCache, type ParsedMDX, type ComponentSchemas, type MDXPropsGeneratorOptions, type MDXPropsGenerator, type RenderMDXOptions, type StreamMDXOptions, type CompileMDXOptions, type CompiledMDXFunction, type MDXCacheEntry, type MDXParseError, type CacheInvalidationStrategy, type MDXCacheOptions, type MDXCacheStats, type ParseMDXOptions, } from './mdx.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAA;AAG1B,OAAO,EACL,EAAE,EACF,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAA;AAG1B,OAAO,EACL,EAAE,EACF,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,kBAAkB,GACxB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -18,4 +18,6 @@ export { MemoryPropsCache, LRUPropsCache, createCacheKey, getDefaultCache, confi
 export { createPropsEnhancer, createAsyncPropsProvider, createPropsTransformer, createConditionalGenerator, createBatchGenerator, } from './hoc.js';
 // Export validation utilities
 export { validateProps, hasRequiredProps, getMissingProps, isComplete, getMissingFromSchema, sanitizeProps, mergeWithDefaults, createValidator, assertValidProps, } from './validate.js';
+// Export MDX utilities
+export { parseMDX, extractComponentSchemas, renderMDXWithProps, streamMDXWithProps, createMDXPropsGenerator, compileMDX, clearMDXCache, getMDXCacheSize, configureMDXCache, getMDXCacheStats, invalidateMDXCacheByTag, cleanupMDXCache, } from './mdx.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAe;AACf,cAAc,YAAY,CAAA;AAE1B,4BAA4B;AAC5B,OAAO,EACL,EAAE,EACF,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAA;AAEtB,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,UAAU,CAAA;AAEjB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAe;AACf,cAAc,YAAY,CAAA;AAE1B,4BAA4B;AAC5B,OAAO,EACL,EAAE,EACF,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAEhB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,WAAW,GACZ,MAAM,eAAe,CAAA;AAEtB,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,YAAY,CAAA;AAEnB,2BAA2B;AAC3B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,UAAU,CAAA;AAEjB,8BAA8B;AAC9B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,eAAe,CAAA;AAEtB,uBAAuB;AACvB,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAehB,MAAM,UAAU,CAAA"}

package/dist/mdx-types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Type definitions for MDX integration
+ *
+ * Shared types used across MDX parsing, props generation, and rendering.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Result of parsing MDX content
+ */
+export interface ParsedMDX {
+    /** Original MDX content */
+    content: string;
+    /** Body content without frontmatter */
+    body: string;
+    /** Parsed frontmatter data */
+    frontmatter: Record<string, unknown>;
+    /** List of component names found in MDX */
+    components: string[];
+    /** Props extracted from components */
+    componentProps: Record<string, Record<string, unknown>>;
+}
+/**
+ * Component schema definitions
+ * Each component maps to an object schema (key -> description string)
+ */
+export type ComponentSchemas = Record<string, Record<string, string>>;
+/**
+ * Options for creating an MDX props generator
+ */
+export interface MDXPropsGeneratorOptions {
+    /** Schemas for components */
+    schemas: ComponentSchemas;
+    /** Whether to cache generated props */
+    cache?: boolean;
+    /** Model to use for generation */
+    model?: string;
+    /** Maximum parallel generation requests (default: 3) */
+    maxParallel?: number;
+}
+/**
+ * MDX props generator instance
+ */
+export interface MDXPropsGenerator {
+    /** Generate props for components in MDX */
+    generate: (mdx: string) => Promise<Record<string, Record<string, unknown>>>;
+    /** Clear the generator's cache */
+    clearCache?: () => void;
+}
+/**
+ * Options for rendering MDX with props
+ */
+export interface RenderMDXOptions {
+    /** Custom component renderers */
+    components?: Record<string, (props: Record<string, unknown>) => string>;
+    /** Enable streaming render */
+    stream?: boolean;
+}
+/**
+ * Options for compiling MDX
+ */
+export interface CompileMDXOptions {
+    /** Custom component map */
+    components?: Record<string, (props: Record<string, unknown>) => string>;
+}
+/**
+ * Compiled MDX function type
+ */
+export interface CompiledMDXFunction {
+    (props: Record<string, Record<string, unknown>>): string;
+    /** Exported metadata from MDX */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for streaming MDX rendering
+ */
+export interface StreamMDXOptions {
+    /** Custom component renderers */
+    components?: Record<string, (props: Record<string, unknown>) => string>;
+}
+/**
+ * Cache entry for parsed MDX
+ */
+export interface MDXCacheEntry {
+    /** Content hash */
+    hash: string;
+    /** Parsed MDX result */
+    parsed: ParsedMDX;
+    /** Timestamp of cache entry */
+    timestamp: number;
+}
+/**
+ * Cache entry for generated props
+ */
+export interface PropsCacheEntry {
+    /** Cache key */
+    key: string;
+    /** Generated props */
+    props: Record<string, unknown>;
+    /** Timestamp of cache entry */
+    timestamp: number;
+    /** Content hash used for generation */
+    contentHash?: string;
+    /** Tags for invalidation */
+    tags?: string[];
+}
+/**
+ * MDX parse error with location information
+ */
+export interface MDXParseError extends Error {
+    /** Line number where error occurred (1-indexed) */
+    line?: number;
+    /** Column number where error occurred (1-indexed) */
+    column?: number;
+    /** The problematic content */
+    source?: string;
+}
+/**
+ * Cache invalidation strategy type
+ */
+export type CacheInvalidationStrategy = 'ttl' | 'lru' | 'tag' | 'manual';
+/**
+ * Options for MDX cache configuration
+ */
+export interface MDXCacheOptions {
+    /** Maximum cache size (default: 100) */
+    maxSize?: number;
+    /** Time-to-live in milliseconds (default: 5 minutes) */
+    ttl?: number;
+    /** Invalidation strategy (default: 'lru') */
+    strategy?: CacheInvalidationStrategy;
+    /** Enable automatic cleanup interval */
+    autoCleanup?: boolean;
+    /** Cleanup interval in milliseconds (default: 60 seconds) */
+    cleanupInterval?: number;
+}
+/**
+ * MDX cache statistics
+ */
+export interface MDXCacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Current cache size */
+    size: number;
+    /** Maximum cache size */
+    maxSize: number;
+    /** Cache hit ratio */
+    hitRatio: number;
+}
+//# sourceMappingURL=mdx-types.d.ts.map

package/dist/mdx-types.d.ts.map

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

package/dist/mdx-types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for MDX integration
+ *
+ * Shared types used across MDX parsing, props generation, and rendering.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=mdx-types.js.map