@frontmcp/ui 0.5.0

package/src/build/cdn-resources.d.ts

@@ -0,0 +1,140 @@
+/**
+ * CDN Resource URLs
+ *
+ * Default CDN URLs for runtime dependencies (React, MDX, Handlebars, etc).
+ * These URLs are used when resourceMode is 'cdn' (default).
+ *
+ * @packageDocumentation
+ */
+import type { CDNResource, UIType, RendererAssets, ResourceMode } from '../types';
+/**
+ * React 19 from esm.sh (ES module).
+ *
+ * React 19 removed UMD builds, so we use esm.sh which provides
+ * ES module builds that work in modern browsers.
+ */
+export declare const REACT_CDN: CDNResource;
+/**
+ * ReactDOM 19 client from esm.sh (ES module).
+ *
+ * React 19 removed UMD builds, so we use esm.sh which provides
+ * ES module builds that work in modern browsers.
+ */
+export declare const REACT_DOM_CDN: CDNResource;
+/**
+ * Marked markdown parser from unpkg.
+ */
+export declare const MARKED_CDN: CDNResource;
+/**
+ * Handlebars runtime from unpkg.
+ */
+export declare const HANDLEBARS_CDN: CDNResource;
+/**
+ * MDX runtime from esm.sh (for browser use).
+ * Note: MDX compilation typically happens server-side.
+ */
+export declare const MDX_RUNTIME_CDN: CDNResource;
+/**
+ * Tailwind CSS Browser CDN (play.tailwindcss.com CDN).
+ */
+export declare const TAILWIND_CDN: CDNResource;
+/**
+ * Get default CDN resources for a UI type.
+ *
+ * @param uiType - The UI renderer type
+ * @param mode - Resource loading mode (cdn or inline)
+ * @returns RendererAssets with appropriate CDN URLs
+ *
+ * @example
+ * ```typescript
+ * // Get CDN assets for React
+ * const assets = getDefaultAssets('react', 'cdn');
+ * console.log(assets.react.url);
+ * // "https://unpkg.com/react@18/umd/react.production.min.js"
+ * ```
+ */
+export declare function getDefaultAssets(uiType: UIType, mode?: ResourceMode): RendererAssets;
+/**
+ * Build a script tag for a CDN resource.
+ *
+ * @param resource - CDN resource configuration
+ * @param options - Additional script tag options
+ * @returns HTML script tag string
+ */
+export declare function buildCDNScriptTag(resource: CDNResource, options?: {
+    async?: boolean;
+    defer?: boolean;
+    type?: string;
+}): string;
+/**
+ * Build all required script tags for a UI type.
+ *
+ * @param uiType - The UI renderer type
+ * @param mode - Resource mode (cdn or inline)
+ * @returns Array of script tag strings
+ *
+ * @example
+ * ```typescript
+ * const scripts = buildScriptsForUIType('react', 'cdn');
+ * // Returns:
+ * // [
+ * //   '<script src="https://unpkg.com/react@18/..." crossorigin="anonymous"></script>',
+ * //   '<script src="https://unpkg.com/react-dom@18/..." crossorigin="anonymous"></script>',
+ * // ]
+ * ```
+ */
+export declare function buildScriptsForUIType(uiType: UIType, mode?: ResourceMode): string[];
+/**
+ * Build a Tailwind script tag.
+ *
+ * @param config - Optional Tailwind config to inline
+ * @returns Tailwind script tag(s)
+ */
+export declare function buildTailwindScriptTag(config?: string): string;
+/**
+ * Check if inline scripts are available in cache.
+ *
+ * Inline scripts need to be pre-fetched and cached before use.
+ * This is typically done at build time or server startup.
+ */
+export declare function hasInlineScripts(): boolean;
+/**
+ * Get all CDN URLs that need to be pre-fetched for inline mode.
+ *
+ * @param uiType - The UI renderer type
+ * @returns Array of URLs to fetch
+ */
+export declare function getURLsToPreFetch(uiType: UIType): string[];
+/**
+ * CDN info structure for tools/list _meta['ui/cdn'].
+ *
+ * Contains CDN URLs for runtime dependencies needed to render the widget.
+ */
+export interface CDNInfo {
+    react?: string;
+    reactDom?: string;
+    handlebars?: string;
+    marked?: string;
+    mdxRuntime?: string;
+    tailwind?: string;
+}
+/**
+ * Build CDN info object for a UI type.
+ *
+ * This is used in tools/list response _meta to inform clients
+ * which CDN resources are needed to render the widget.
+ *
+ * @param uiType - The UI renderer type
+ * @returns CDN info object with URLs
+ *
+ * @example
+ * ```typescript
+ * // In tools/list response
+ * item._meta = {
+ *   'openai/outputTemplate': 'ui://widget/get_weather.html',
+ *   'ui/cdn': buildCDNInfoForUIType('react'),
+ *   // { react: 'https://...', reactDom: 'https://...' }
+ * };
+ * ```
+ */
+export declare function buildCDNInfoForUIType(uiType: UIType): CDNInfo;

package/src/build/cdn-resources.js

@@ -0,0 +1,314 @@
+"use strict";
+/**
+ * CDN Resource URLs
+ *
+ * Default CDN URLs for runtime dependencies (React, MDX, Handlebars, etc).
+ * These URLs are used when resourceMode is 'cdn' (default).
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAILWIND_CDN = exports.MDX_RUNTIME_CDN = exports.HANDLEBARS_CDN = exports.MARKED_CDN = exports.REACT_DOM_CDN = exports.REACT_CDN = void 0;
+exports.getDefaultAssets = getDefaultAssets;
+exports.buildCDNScriptTag = buildCDNScriptTag;
+exports.buildScriptsForUIType = buildScriptsForUIType;
+exports.buildTailwindScriptTag = buildTailwindScriptTag;
+exports.hasInlineScripts = hasInlineScripts;
+exports.getURLsToPreFetch = getURLsToPreFetch;
+exports.buildCDNInfoForUIType = buildCDNInfoForUIType;
+// ============================================
+// CDN URL Constants
+// ============================================
+/**
+ * React 19 from esm.sh (ES module).
+ *
+ * React 19 removed UMD builds, so we use esm.sh which provides
+ * ES module builds that work in modern browsers.
+ */
+exports.REACT_CDN = {
+    url: 'https://esm.sh/react@19',
+    crossorigin: 'anonymous',
+};
+/**
+ * ReactDOM 19 client from esm.sh (ES module).
+ *
+ * React 19 removed UMD builds, so we use esm.sh which provides
+ * ES module builds that work in modern browsers.
+ */
+exports.REACT_DOM_CDN = {
+    url: 'https://esm.sh/react-dom@19/client',
+    crossorigin: 'anonymous',
+};
+/**
+ * Marked markdown parser from unpkg.
+ */
+exports.MARKED_CDN = {
+    url: 'https://unpkg.com/marked@latest/marked.min.js',
+    crossorigin: 'anonymous',
+};
+/**
+ * Handlebars runtime from unpkg.
+ */
+exports.HANDLEBARS_CDN = {
+    url: 'https://unpkg.com/handlebars@latest/dist/handlebars.min.js',
+    crossorigin: 'anonymous',
+};
+/**
+ * MDX runtime from esm.sh (for browser use).
+ * Note: MDX compilation typically happens server-side.
+ */
+exports.MDX_RUNTIME_CDN = {
+    url: 'https://esm.sh/@mdx-js/mdx@3?bundle',
+    crossorigin: 'anonymous',
+};
+/**
+ * Tailwind CSS Browser CDN (play.tailwindcss.com CDN).
+ */
+exports.TAILWIND_CDN = {
+    url: 'https://cdn.tailwindcss.com',
+    crossorigin: 'anonymous',
+};
+// ============================================
+// Default Assets by UI Type
+// ============================================
+/**
+ * Get default CDN resources for a UI type.
+ *
+ * @param uiType - The UI renderer type
+ * @param mode - Resource loading mode (cdn or inline)
+ * @returns RendererAssets with appropriate CDN URLs
+ *
+ * @example
+ * ```typescript
+ * // Get CDN assets for React
+ * const assets = getDefaultAssets('react', 'cdn');
+ * console.log(assets.react.url);
+ * // "https://unpkg.com/react@18/umd/react.production.min.js"
+ * ```
+ */
+function getDefaultAssets(uiType, mode = 'cdn') {
+    const baseAssets = {
+        mode,
+        tailwind: exports.TAILWIND_CDN,
+    };
+    switch (uiType) {
+        case 'react':
+            return {
+                ...baseAssets,
+                react: exports.REACT_CDN,
+                reactDom: exports.REACT_DOM_CDN,
+            };
+        case 'mdx':
+            return {
+                ...baseAssets,
+                react: exports.REACT_CDN,
+                reactDom: exports.REACT_DOM_CDN,
+                mdxRuntime: exports.MDX_RUNTIME_CDN,
+                markdown: exports.MARKED_CDN,
+            };
+        case 'markdown':
+            return {
+                ...baseAssets,
+                markdown: exports.MARKED_CDN,
+            };
+        case 'html':
+            // HTML can optionally use Handlebars for {{}} syntax
+            return {
+                ...baseAssets,
+                handlebars: exports.HANDLEBARS_CDN,
+            };
+        case 'auto':
+            // Auto mode includes all renderers (lazy-loaded at runtime)
+            return {
+                ...baseAssets,
+                react: exports.REACT_CDN,
+                reactDom: exports.REACT_DOM_CDN,
+                markdown: exports.MARKED_CDN,
+                handlebars: exports.HANDLEBARS_CDN,
+            };
+        default:
+            return baseAssets;
+    }
+}
+// ============================================
+// Script Tag Builders
+// ============================================
+/**
+ * Build a script tag for a CDN resource.
+ *
+ * @param resource - CDN resource configuration
+ * @param options - Additional script tag options
+ * @returns HTML script tag string
+ */
+function buildCDNScriptTag(resource, options) {
+    const attrs = [`src="${resource.url}"`];
+    if (resource.integrity) {
+        attrs.push(`integrity="${resource.integrity}"`);
+    }
+    if (resource.crossorigin) {
+        attrs.push(`crossorigin="${resource.crossorigin}"`);
+    }
+    if (options?.async) {
+        attrs.push('async');
+    }
+    if (options?.defer) {
+        attrs.push('defer');
+    }
+    if (options?.type) {
+        attrs.push(`type="${options.type}"`);
+    }
+    return `<script ${attrs.join(' ')}></script>`;
+}
+/**
+ * Build all required script tags for a UI type.
+ *
+ * @param uiType - The UI renderer type
+ * @param mode - Resource mode (cdn or inline)
+ * @returns Array of script tag strings
+ *
+ * @example
+ * ```typescript
+ * const scripts = buildScriptsForUIType('react', 'cdn');
+ * // Returns:
+ * // [
+ * //   '<script src="https://unpkg.com/react@18/..." crossorigin="anonymous"></script>',
+ * //   '<script src="https://unpkg.com/react-dom@18/..." crossorigin="anonymous"></script>',
+ * // ]
+ * ```
+ */
+function buildScriptsForUIType(uiType, mode = 'cdn') {
+    if (mode !== 'cdn') {
+        // Inline mode doesn't use CDN script tags
+        return [];
+    }
+    const assets = getDefaultAssets(uiType, mode);
+    const scripts = [];
+    // React (must load before ReactDOM)
+    if (assets.react) {
+        scripts.push(buildCDNScriptTag(assets.react));
+    }
+    if (assets.reactDom) {
+        scripts.push(buildCDNScriptTag(assets.reactDom));
+    }
+    // Markdown
+    if (assets.markdown) {
+        scripts.push(buildCDNScriptTag(assets.markdown));
+    }
+    // MDX Runtime
+    if (assets.mdxRuntime) {
+        scripts.push(buildCDNScriptTag(assets.mdxRuntime, { type: 'module' }));
+    }
+    // Handlebars
+    if (assets.handlebars) {
+        scripts.push(buildCDNScriptTag(assets.handlebars));
+    }
+    return scripts;
+}
+/**
+ * Build a Tailwind script tag.
+ *
+ * @param config - Optional Tailwind config to inline
+ * @returns Tailwind script tag(s)
+ */
+function buildTailwindScriptTag(config) {
+    const baseTag = buildCDNScriptTag(exports.TAILWIND_CDN);
+    if (config) {
+        return `${baseTag}
+<script>
+  tailwind.config = ${config};
+</script>`;
+    }
+    return baseTag;
+}
+// ============================================
+// Inline Mode Helpers
+// ============================================
+/**
+ * Check if inline scripts are available in cache.
+ *
+ * Inline scripts need to be pre-fetched and cached before use.
+ * This is typically done at build time or server startup.
+ */
+function hasInlineScripts() {
+    // This would check a cache - implementation depends on runtime
+    return false;
+}
+/**
+ * Get all CDN URLs that need to be pre-fetched for inline mode.
+ *
+ * @param uiType - The UI renderer type
+ * @returns Array of URLs to fetch
+ */
+function getURLsToPreFetch(uiType) {
+    const assets = getDefaultAssets(uiType, 'cdn');
+    const urls = [];
+    if (assets.react)
+        urls.push(assets.react.url);
+    if (assets.reactDom)
+        urls.push(assets.reactDom.url);
+    if (assets.markdown)
+        urls.push(assets.markdown.url);
+    if (assets.handlebars)
+        urls.push(assets.handlebars.url);
+    if (assets.tailwind)
+        urls.push(assets.tailwind.url);
+    return urls;
+}
+/**
+ * Build CDN info object for a UI type.
+ *
+ * This is used in tools/list response _meta to inform clients
+ * which CDN resources are needed to render the widget.
+ *
+ * @param uiType - The UI renderer type
+ * @returns CDN info object with URLs
+ *
+ * @example
+ * ```typescript
+ * // In tools/list response
+ * item._meta = {
+ *   'openai/outputTemplate': 'ui://widget/get_weather.html',
+ *   'ui/cdn': buildCDNInfoForUIType('react'),
+ *   // { react: 'https://...', reactDom: 'https://...' }
+ * };
+ * ```
+ */
+function buildCDNInfoForUIType(uiType) {
+    switch (uiType) {
+        case 'react':
+            return {
+                react: exports.REACT_CDN.url,
+                reactDom: exports.REACT_DOM_CDN.url,
+                tailwind: exports.TAILWIND_CDN.url,
+            };
+        case 'mdx':
+            return {
+                react: exports.REACT_CDN.url,
+                reactDom: exports.REACT_DOM_CDN.url,
+                mdxRuntime: exports.MDX_RUNTIME_CDN.url,
+                marked: exports.MARKED_CDN.url,
+                tailwind: exports.TAILWIND_CDN.url,
+            };
+        case 'markdown':
+            return {
+                marked: exports.MARKED_CDN.url,
+                tailwind: exports.TAILWIND_CDN.url,
+            };
+        case 'html':
+            return {
+                handlebars: exports.HANDLEBARS_CDN.url,
+                tailwind: exports.TAILWIND_CDN.url,
+            };
+        case 'auto':
+        default:
+            // Auto mode includes all renderers
+            return {
+                react: exports.REACT_CDN.url,
+                reactDom: exports.REACT_DOM_CDN.url,
+                handlebars: exports.HANDLEBARS_CDN.url,
+                marked: exports.MARKED_CDN.url,
+                tailwind: exports.TAILWIND_CDN.url,
+            };
+    }
+}
+//# sourceMappingURL=cdn-resources.js.map

package/src/build/cdn-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-resources.js","sourceRoot":"","sources":["../../../src/build/cdn-resources.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CDN Resource URLs\n *\n * Default CDN URLs for runtime dependencies (React, MDX, Handlebars, etc).\n * These URLs are used when resourceMode is 'cdn' (default).\n *\n * @packageDocumentation\n */\n\nimport type { CDNResource, UIType, RendererAssets, ResourceMode } from '../types';\n\n// ============================================\n// CDN URL Constants\n// ============================================\n\n/**\n * React 19 from esm.sh (ES module).\n *\n * React 19 removed UMD builds, so we use esm.sh which provides\n * ES module builds that work in modern browsers.\n */\nexport const REACT_CDN: CDNResource = {\n  url: 'https://esm.sh/react@19',\n  crossorigin: 'anonymous',\n};\n\n/**\n * ReactDOM 19 client from esm.sh (ES module).\n *\n * React 19 removed UMD builds, so we use esm.sh which provides\n * ES module builds that work in modern browsers.\n */\nexport const REACT_DOM_CDN: CDNResource = {\n  url: 'https://esm.sh/react-dom@19/client',\n  crossorigin: 'anonymous',\n};\n\n/**\n * Marked markdown parser from unpkg.\n */\nexport const MARKED_CDN: CDNResource = {\n  url: 'https://unpkg.com/marked@latest/marked.min.js',\n  crossorigin: 'anonymous',\n};\n\n/**\n * Handlebars runtime from unpkg.\n */\nexport const HANDLEBARS_CDN: CDNResource = {\n  url: 'https://unpkg.com/handlebars@latest/dist/handlebars.min.js',\n  crossorigin: 'anonymous',\n};\n\n/**\n * MDX runtime from esm.sh (for browser use).\n * Note: MDX compilation typically happens server-side.\n */\nexport const MDX_RUNTIME_CDN: CDNResource = {\n  url: 'https://esm.sh/@mdx-js/mdx@3?bundle',\n  crossorigin: 'anonymous',\n};\n\n/**\n * Tailwind CSS Browser CDN (play.tailwindcss.com CDN).\n */\nexport const TAILWIND_CDN: CDNResource = {\n  url: 'https://cdn.tailwindcss.com',\n  crossorigin: 'anonymous',\n};\n\n// ============================================\n// Default Assets by UI Type\n// ============================================\n\n/**\n * Get default CDN resources for a UI type.\n *\n * @param uiType - The UI renderer type\n * @param mode - Resource loading mode (cdn or inline)\n * @returns RendererAssets with appropriate CDN URLs\n *\n * @example\n * ```typescript\n * // Get CDN assets for React\n * const assets = getDefaultAssets('react', 'cdn');\n * console.log(assets.react.url);\n * // \"https://unpkg.com/react@18/umd/react.production.min.js\"\n * ```\n */\nexport function getDefaultAssets(\n  uiType: UIType,\n  mode: ResourceMode = 'cdn'\n): RendererAssets {\n  const baseAssets: RendererAssets = {\n    mode,\n    tailwind: TAILWIND_CDN,\n  };\n\n  switch (uiType) {\n    case 'react':\n      return {\n        ...baseAssets,\n        react: REACT_CDN,\n        reactDom: REACT_DOM_CDN,\n      };\n\n    case 'mdx':\n      return {\n        ...baseAssets,\n        react: REACT_CDN,\n        reactDom: REACT_DOM_CDN,\n        mdxRuntime: MDX_RUNTIME_CDN,\n        markdown: MARKED_CDN,\n      };\n\n    case 'markdown':\n      return {\n        ...baseAssets,\n        markdown: MARKED_CDN,\n      };\n\n    case 'html':\n      // HTML can optionally use Handlebars for {{}} syntax\n      return {\n        ...baseAssets,\n        handlebars: HANDLEBARS_CDN,\n      };\n\n    case 'auto':\n      // Auto mode includes all renderers (lazy-loaded at runtime)\n      return {\n        ...baseAssets,\n        react: REACT_CDN,\n        reactDom: REACT_DOM_CDN,\n        markdown: MARKED_CDN,\n        handlebars: HANDLEBARS_CDN,\n      };\n\n    default:\n      return baseAssets;\n  }\n}\n\n// ============================================\n// Script Tag Builders\n// ============================================\n\n/**\n * Build a script tag for a CDN resource.\n *\n * @param resource - CDN resource configuration\n * @param options - Additional script tag options\n * @returns HTML script tag string\n */\nexport function buildCDNScriptTag(\n  resource: CDNResource,\n  options?: {\n    async?: boolean;\n    defer?: boolean;\n    type?: string;\n  }\n): string {\n  const attrs: string[] = [`src=\"${resource.url}\"`];\n\n  if (resource.integrity) {\n    attrs.push(`integrity=\"${resource.integrity}\"`);\n  }\n\n  if (resource.crossorigin) {\n    attrs.push(`crossorigin=\"${resource.crossorigin}\"`);\n  }\n\n  if (options?.async) {\n    attrs.push('async');\n  }\n\n  if (options?.defer) {\n    attrs.push('defer');\n  }\n\n  if (options?.type) {\n    attrs.push(`type=\"${options.type}\"`);\n  }\n\n  return `<script ${attrs.join(' ')}></script>`;\n}\n\n/**\n * Build all required script tags for a UI type.\n *\n * @param uiType - The UI renderer type\n * @param mode - Resource mode (cdn or inline)\n * @returns Array of script tag strings\n *\n * @example\n * ```typescript\n * const scripts = buildScriptsForUIType('react', 'cdn');\n * // Returns:\n * // [\n * //   '<script src=\"https://unpkg.com/react@18/...\" crossorigin=\"anonymous\"></script>',\n * //   '<script src=\"https://unpkg.com/react-dom@18/...\" crossorigin=\"anonymous\"></script>',\n * // ]\n * ```\n */\nexport function buildScriptsForUIType(\n  uiType: UIType,\n  mode: ResourceMode = 'cdn'\n): string[] {\n  if (mode !== 'cdn') {\n    // Inline mode doesn't use CDN script tags\n    return [];\n  }\n\n  const assets = getDefaultAssets(uiType, mode);\n  const scripts: string[] = [];\n\n  // React (must load before ReactDOM)\n  if (assets.react) {\n    scripts.push(buildCDNScriptTag(assets.react));\n  }\n\n  if (assets.reactDom) {\n    scripts.push(buildCDNScriptTag(assets.reactDom));\n  }\n\n  // Markdown\n  if (assets.markdown) {\n    scripts.push(buildCDNScriptTag(assets.markdown));\n  }\n\n  // MDX Runtime\n  if (assets.mdxRuntime) {\n    scripts.push(buildCDNScriptTag(assets.mdxRuntime, { type: 'module' }));\n  }\n\n  // Handlebars\n  if (assets.handlebars) {\n    scripts.push(buildCDNScriptTag(assets.handlebars));\n  }\n\n  return scripts;\n}\n\n/**\n * Build a Tailwind script tag.\n *\n * @param config - Optional Tailwind config to inline\n * @returns Tailwind script tag(s)\n */\nexport function buildTailwindScriptTag(config?: string): string {\n  const baseTag = buildCDNScriptTag(TAILWIND_CDN);\n\n  if (config) {\n    return `${baseTag}\n<script>\n  tailwind.config = ${config};\n</script>`;\n  }\n\n  return baseTag;\n}\n\n// ============================================\n// Inline Mode Helpers\n// ============================================\n\n/**\n * Check if inline scripts are available in cache.\n *\n * Inline scripts need to be pre-fetched and cached before use.\n * This is typically done at build time or server startup.\n */\nexport function hasInlineScripts(): boolean {\n  // This would check a cache - implementation depends on runtime\n  return false;\n}\n\n/**\n * Get all CDN URLs that need to be pre-fetched for inline mode.\n *\n * @param uiType - The UI renderer type\n * @returns Array of URLs to fetch\n */\nexport function getURLsToPreFetch(uiType: UIType): string[] {\n  const assets = getDefaultAssets(uiType, 'cdn');\n  const urls: string[] = [];\n\n  if (assets.react) urls.push(assets.react.url);\n  if (assets.reactDom) urls.push(assets.reactDom.url);\n  if (assets.markdown) urls.push(assets.markdown.url);\n  if (assets.handlebars) urls.push(assets.handlebars.url);\n  if (assets.tailwind) urls.push(assets.tailwind.url);\n\n  return urls;\n}\n\n// ============================================\n// CDN Info for tools/list _meta\n// ============================================\n\n/**\n * CDN info structure for tools/list _meta['ui/cdn'].\n *\n * Contains CDN URLs for runtime dependencies needed to render the widget.\n */\nexport interface CDNInfo {\n  react?: string;\n  reactDom?: string;\n  handlebars?: string;\n  marked?: string;\n  mdxRuntime?: string;\n  tailwind?: string;\n}\n\n/**\n * Build CDN info object for a UI type.\n *\n * This is used in tools/list response _meta to inform clients\n * which CDN resources are needed to render the widget.\n *\n * @param uiType - The UI renderer type\n * @returns CDN info object with URLs\n *\n * @example\n * ```typescript\n * // In tools/list response\n * item._meta = {\n *   'openai/outputTemplate': 'ui://widget/get_weather.html',\n *   'ui/cdn': buildCDNInfoForUIType('react'),\n *   // { react: 'https://...', reactDom: 'https://...' }\n * };\n * ```\n */\nexport function buildCDNInfoForUIType(uiType: UIType): CDNInfo {\n  switch (uiType) {\n    case 'react':\n      return {\n        react: REACT_CDN.url,\n        reactDom: REACT_DOM_CDN.url,\n        tailwind: TAILWIND_CDN.url,\n      };\n\n    case 'mdx':\n      return {\n        react: REACT_CDN.url,\n        reactDom: REACT_DOM_CDN.url,\n        mdxRuntime: MDX_RUNTIME_CDN.url,\n        marked: MARKED_CDN.url,\n        tailwind: TAILWIND_CDN.url,\n      };\n\n    case 'markdown':\n      return {\n        marked: MARKED_CDN.url,\n        tailwind: TAILWIND_CDN.url,\n      };\n\n    case 'html':\n      return {\n        handlebars: HANDLEBARS_CDN.url,\n        tailwind: TAILWIND_CDN.url,\n      };\n\n    case 'auto':\n    default:\n      // Auto mode includes all renderers\n      return {\n        react: REACT_CDN.url,\n        reactDom: REACT_DOM_CDN.url,\n        handlebars: HANDLEBARS_CDN.url,\n        marked: MARKED_CDN.url,\n        tailwind: TAILWIND_CDN.url,\n      };\n  }\n}\n"]}