cms-renderer 0.6.5 → 0.6.7

package/dist/lib/docs-markdown.d.ts

@@ -8,6 +8,7 @@ interface DocsMarkdownProps {
         src: string;
         alt: string;
         title?: string;
+        loading?: 'eager' | 'lazy';
     }) => ReactNode;
 }
 declare function markdownStartsWithHeading(markdown: string): boolean;

package/dist/lib/docs-markdown.js

@@ -146,10 +146,81 @@ async function initMarkdown() {
 
 // lib/docs-markdown.tsx
 import { Fragment as Fragment3 } from "react";
-import { codeToTokens } from "shiki";
+import { bundledLanguages, createHighlighter } from "shiki";
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var defaultClassName = "cms-docs-markdown";
 var markdownInitPromise;
+var PRELOADED_LANGS = [
+  // Web
+  "typescript",
+  "javascript",
+  "tsx",
+  "jsx",
+  "html",
+  "css",
+  "scss",
+  // Systems
+  "c",
+  "cpp",
+  "rust",
+  "go",
+  // Enterprise
+  "java",
+  "csharp",
+  "kotlin",
+  "swift",
+  // Scripting
+  "python",
+  "ruby",
+  "php",
+  "bash",
+  "shellscript",
+  "powershell",
+  // Data
+  "json",
+  "yaml",
+  "toml",
+  "xml",
+  "sql",
+  "graphql",
+  // Other
+  "markdown",
+  "dockerfile"
+];
+var highlighterPromise;
+var loadedLanguages = new Set(PRELOADED_LANGS);
+async function getHighlighter() {
+  highlighterPromise ??= createHighlighter({
+    themes: ["github-dark"],
+    langs: PRELOADED_LANGS
+  });
+  return highlighterPromise;
+}
+async function ensureLanguageLoaded(highlighter, lang) {
+  if (loadedLanguages.has(lang)) {
+    return lang;
+  }
+  if (lang in bundledLanguages) {
+    try {
+      await highlighter.loadLanguage(lang);
+      loadedLanguages.add(lang);
+      return lang;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+if (typeof window === "undefined") {
+  markdownInitPromise = initMarkdown();
+  highlighterPromise = createHighlighter({
+    themes: ["github-dark"],
+    langs: PRELOADED_LANGS
+  });
+  Promise.all([markdownInitPromise, highlighterPromise]).then(
+    () => console.log(`[docs-markdown] WASM and Shiki pre-warmed (${PRELOADED_LANGS.length} languages)`)
+  ).catch((err) => console.error("[docs-markdown] Pre-warm failed:", err));
+}
 function markdownStartsWithHeading(markdown) {
   return /^\s*#\s+/.test(markdown);
 }
@@ -170,24 +241,33 @@ function buildComponentProps(type, props) {
 }
 function normalizeLanguage(lang) {
   if (typeof lang !== "string") {
-    return "text";
+    return "";
   }
   const normalized = lang.trim().toLowerCase();
-  return normalized || "text";
+  return normalized;
+}
+function decodeHtmlEntities(value) {
+  return value.replaceAll("&lt;", "<").replaceAll("&gt;", ">").replaceAll("&quot;", '"').replaceAll("&#39;", "'").replaceAll("&amp;", "&");
 }
 async function renderHighlightedCode(code, lang) {
   const language = normalizeLanguage(lang);
+  const displayLanguage = language || "text";
   try {
-    const result = await codeToTokens(code, {
-      lang: language,
+    const highlighter = await getHighlighter();
+    const resolvedLang = await ensureLanguageLoaded(highlighter, language);
+    if (!resolvedLang) {
+      return /* @__PURE__ */ jsx3("pre", { className: `language-${displayLanguage}`, children: /* @__PURE__ */ jsx3("code", { className: `language-${displayLanguage}`, children: code }) });
+    }
+    const result = highlighter.codeToTokens(code, {
+      lang: resolvedLang,
       theme: "github-dark"
     });
     return /* @__PURE__ */ jsx3(
       "pre",
       {
-        className: `shiki language-${language}`,
+        className: `shiki language-${displayLanguage}`,
         style: { backgroundColor: result.bg, color: result.fg },
-        children: /* @__PURE__ */ jsx3("code", { className: `shiki_code language-${language}`, "data-language": language, children: (() => {
+        children: /* @__PURE__ */ jsx3("code", { className: `shiki_code language-${displayLanguage}`, "data-language": displayLanguage, children: (() => {
           const lineOccurrences = /* @__PURE__ */ new Map();
           return result.tokens.map((line, lineIndex) => {
             const isLastLine = lineIndex === result.tokens.length - 1;
@@ -208,27 +288,33 @@ async function renderHighlightedCode(code, lang) {
       }
     );
   } catch {
-    return /* @__PURE__ */ jsx3("pre", { className: `language-${language}`, children: /* @__PURE__ */ jsx3("code", { className: `language-${language}`, children: code }) });
+    return /* @__PURE__ */ jsx3("pre", { className: `language-${displayLanguage}`, children: /* @__PURE__ */ jsx3("code", { className: `language-${displayLanguage}`, children: code }) });
   }
 }
-async function renderNode(node, components, renderImage, key) {
+async function renderNode(node, components, renderImage, imageIndexRef, key) {
   if (isTextNode2(node)) {
-    return node;
+    return decodeHtmlEntities(node);
   }
   const { type, props, children } = node;
   if (type === NodeType3.IMG && renderImage) {
+    const imageIndex = imageIndexRef.current;
+    imageIndexRef.current += 1;
     return /* @__PURE__ */ jsx3(Fragment3, { children: renderImage({
       src: typeof props?.src === "string" ? props.src : "",
       alt: typeof props?.alt === "string" ? props.alt : "",
-      title: typeof props?.title === "string" ? props.title : void 0
+      title: typeof props?.title === "string" ? props.title : void 0,
+      loading: imageIndex === 0 ? "eager" : "lazy"
     }) }, key);
   }
   if (type === NodeType3.CODE_BLOCK) {
-    const code = children?.filter(isTextNode2).join("") ?? "";
+    const rawCode = children?.filter(isTextNode2).join("") ?? "";
+    const code = decodeHtmlEntities(rawCode);
     return /* @__PURE__ */ jsx3(Fragment3, { children: await renderHighlightedCode(code, props?.lang) }, key);
   }
   const renderedChildren = children ? await Promise.all(
-    children.map((child, index) => renderNode(child, components, renderImage, index))
+    children.map(
+      (child, index) => renderNode(child, components, renderImage, imageIndexRef, index)
+    )
   ) : void 0;
   const Component = components[type];
   if (Component) {
@@ -244,8 +330,11 @@ async function DocsMarkdown({
 }) {
   await initMarkdown2();
   const ast = mdToJSON2(content);
+  const imageIndexRef = { current: 0 };
   const rendered = await Promise.all(
-    ast.children.map((node, index) => renderNode(node, defaultComponents, renderImage, index))
+    ast.children.map(
+      (node, index) => renderNode(node, defaultComponents, renderImage, imageIndexRef, index)
+    )
   );
   const resolvedClassName = className === defaultClassName ? defaultClassName : `${defaultClassName} ${className}`.trim();
   return /* @__PURE__ */ jsx3("div", { className: resolvedClassName, children: rendered });

package/dist/lib/docs-markdown.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../packages/markdown-wasm/src/index.ts","../../../../packages/markdown-wasm/src/components.tsx","../../../../packages/markdown-wasm/src/renderer.tsx","../../../../packages/markdown-wasm/src/types.ts","../../lib/docs-markdown.tsx"],"sourcesContent":["/**\n * @repo/markdown-wasm\n *\n * High-performance markdown rendering using md4w WASM engine\n * with React component mapping support.\n *\n * @example\n * ```tsx\n * import { MarkdownRenderer, createMarkdownRenderer, NodeType } from \"@repo/markdown-wasm\";\n *\n * // Basic usage\n * <MarkdownRenderer content=\"# Hello **world**\" />\n *\n * // With custom components\n * <MarkdownRenderer\n *   content={markdown}\n *   components={{\n *     [NodeType.H1]: ({ children }) => <MyHeading>{children}</MyHeading>,\n *   }}\n * />\n *\n * // Factory pattern for reusable renderer\n * const CustomRenderer = createMarkdownRenderer({\n *   components: { ... },\n *   className: \"prose\",\n * });\n * <CustomRenderer content={markdown} />\n * ```\n */\n\n// Re-export md4w utilities for advanced usage\nexport { init, mdToHtml, mdToJSON, mdToReadableHtml, ParseFlags as Md4wParseFlags } from 'md4w';\n\n// Component exports\nexport { defaultComponents, minimalComponents } from './components';\n// Main renderer exports\nexport {\n  createMarkdownRenderer,\n  initMarkdown,\n  MarkdownRenderer,\n  NodeType,\n  renderMarkdown,\n} from './renderer';\n// Type exports\nexport type {\n  ComponentMap,\n  CreateRendererOptions,\n  GenericNodeComponent,\n  HeadingLevel,\n  MarkdownRendererProps,\n  MDNode,\n  MDTree,\n  NodeComponent,\n  NodePropsFor,\n  NodeRenderProps,\n  Options,\n  ParseFlags,\n} from './types';\n// Utility exports\nexport { getHeadingLevel, isElementNode, isTextNode } from './types';\n","/**\n * @repo/markdown-wasm - Default Component Mappings\n *\n * Provides semantic HTML components for all md4w node types.\n * Override any of these by passing custom components to MarkdownRenderer.\n */\n\nimport { NodeType } from 'md4w';\nimport type { ReactNode } from 'react';\n\nimport type { ComponentMap, HeadingLevel } from './types';\n\n/**\n * Default heading component.\n * Renders H1-H6 based on level prop.\n */\nfunction Heading({ level, children }: { level: HeadingLevel; children: ReactNode }) {\n  const Tag = `h${level}` as const;\n  return <Tag>{children}</Tag>;\n}\n\n/**\n * Default components for all md4w node types.\n * These render semantic HTML elements that can be styled with CSS.\n *\n * Props are accessed from a generic props object to satisfy GenericNodeComponent type.\n * Runtime guarantees from md4w ensure the props exist for each node type.\n */\nexport const defaultComponents: ComponentMap = {\n  // Block elements\n  [NodeType.QUOTE]: (props) => <blockquote>{props.children}</blockquote>,\n  [NodeType.UL]: (props) => <ul>{props.children}</ul>,\n  [NodeType.OL]: (props) => <ol start={props.start as number | undefined}>{props.children}</ol>,\n  [NodeType.LI]: (props) => {\n    const isTask = props.isTask as boolean | undefined;\n    const done = props.done as boolean | undefined;\n    if (isTask) {\n      return (\n        <li>\n          <input type=\"checkbox\" checked={done} disabled readOnly />\n          {props.children}\n        </li>\n      );\n    }\n    return <li>{props.children}</li>;\n  },\n  [NodeType.HR]: () => <hr />,\n  [NodeType.CODE_BLOCK]: (props: { lang?: string; children: React.ReactNode }) => {\n    const language = props.lang?.toLowerCase() || 'plaintext';\n    const languageClass = language ? `language-${language}` : undefined;\n    return (\n      <pre className={languageClass}>\n        <code className={languageClass} data-language={language}>\n          {props.children}\n        </code>\n      </pre>\n    );\n  },\n  [NodeType.HTML]: (props) => {\n    const html = getHtmlString(props.children);\n    if (html && isLineBreakHtml(html)) {\n      return <br />;\n    }\n    // HTML blocks are rendered as-is inside a div\n    // Note: This is raw HTML from markdown, use dangerouslySetInnerHTML if needed\n    return <div data-markdown-html>{props.children}</div>;\n  },\n  [NodeType.P]: (props) => <p>{props.children}</p>,\n\n  // Table elements\n  [NodeType.TABLE]: (props) => <table>{props.children}</table>,\n  [NodeType.THEAD]: (props) => <thead>{props.children}</thead>,\n  [NodeType.TBODY]: (props) => <tbody>{props.children}</tbody>,\n  [NodeType.TR]: (props) => <tr>{props.children}</tr>,\n  [NodeType.TH]: (props) => {\n    const align = props.align as 'left' | 'center' | 'right' | '' | undefined;\n    return <th style={align ? { textAlign: align } : undefined}>{props.children}</th>;\n  },\n  [NodeType.TD]: (props) => {\n    const align = props.align as 'left' | 'center' | 'right' | '' | undefined;\n    return <td style={align ? { textAlign: align } : undefined}>{props.children}</td>;\n  },\n\n  // Headings (H1-H6 share the same component with level prop injected by renderer)\n  [NodeType.H1]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 1}>{props.children}</Heading>\n  ),\n  [NodeType.H2]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 2}>{props.children}</Heading>\n  ),\n  [NodeType.H3]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 3}>{props.children}</Heading>\n  ),\n  [NodeType.H4]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 4}>{props.children}</Heading>\n  ),\n  [NodeType.H5]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 5}>{props.children}</Heading>\n  ),\n  [NodeType.H6]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 6}>{props.children}</Heading>\n  ),\n\n  // Inline elements\n  [NodeType.EM]: (props) => <em>{props.children}</em>,\n  [NodeType.STRONG]: (props) => <strong>{props.children}</strong>,\n  [NodeType.A]: (props) => (\n    <a href={props.href as string} title={props.title as string | undefined}>\n      {props.children}\n    </a>\n  ),\n  [NodeType.IMG]: (props) => (\n    // biome-ignore lint/performance/noImgElement: Generic markdown package, not Next.js specific. Users can override with next/image.\n    <img\n      src={props.src as string}\n      alt={props.alt as string}\n      title={props.title as string | undefined}\n    />\n  ),\n  [NodeType.CODE_SPAN]: (props) => <code>{props.children}</code>,\n  [NodeType.DEL]: (props) => <del>{props.children}</del>,\n\n  // Math (LaTeX)\n  [NodeType.LATEXMATH]: (props) => <span data-math=\"inline\">{props.children}</span>,\n  [NodeType.LATEXMATH_DISPLAY]: (props) => <div data-math=\"display\">{props.children}</div>,\n\n  // Wiki links\n  [NodeType.WIKILINK]: (props) => {\n    const target = props.target as string;\n    return (\n      <a href={`/wiki/${encodeURIComponent(target)}`} data-wikilink={target}>\n        {props.children}\n      </a>\n    );\n  },\n\n  // Underline (when UNDERLINE parse flag is enabled)\n  [NodeType.U]: (props) => <u>{props.children}</u>,\n};\n\nfunction getHtmlString(children: ReactNode): string | null {\n  if (typeof children === 'string') {\n    return children;\n  }\n  if (Array.isArray(children) && children.length === 1 && typeof children[0] === 'string') {\n    return children[0];\n  }\n  return null;\n}\n\nfunction isLineBreakHtml(html: string): boolean {\n  const trimmed = html.trim().toLowerCase();\n  return trimmed === '<br>' || trimmed === '<br/>' || trimmed === '<br />';\n}\n\n/**\n * Minimal component set - only essential elements.\n * Use this when you want to style everything yourself.\n */\nexport const minimalComponents: ComponentMap = {\n  [NodeType.P]: (props) => <p>{props.children}</p>,\n  [NodeType.H1]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 1}>{props.children}</Heading>\n  ),\n  [NodeType.H2]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 2}>{props.children}</Heading>\n  ),\n  [NodeType.H3]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 3}>{props.children}</Heading>\n  ),\n  [NodeType.H4]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 4}>{props.children}</Heading>\n  ),\n  [NodeType.H5]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 5}>{props.children}</Heading>\n  ),\n  [NodeType.H6]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 6}>{props.children}</Heading>\n  ),\n  [NodeType.STRONG]: (props) => <strong>{props.children}</strong>,\n  [NodeType.EM]: (props) => <em>{props.children}</em>,\n  [NodeType.A]: (props) => <a href={props.href as string}>{props.children}</a>,\n  [NodeType.CODE_SPAN]: (props) => <code>{props.children}</code>,\n};\n","/**\n * @repo/markdown-wasm - AST to React Renderer\n *\n * Converts md4w JSON AST to React components.\n * Pattern B from research: Direct AST-to-React mapping for maximum performance.\n *\n * IMPORTANT: md4w is a WASM module that requires async initialization.\n * This module uses a singleton pattern with cached promise to ensure\n * init() is called exactly once before any parsing.\n *\n * NOTE: For Vercel/Next.js deployment, ensure `serverExternalPackages: ['md4w']`\n * is set in next.config.ts so md4w can properly resolve its WASM files.\n */\n\nimport { init, mdToJSON, NodeType } from 'md4w';\nimport { Fragment, type ReactNode } from 'react';\n\nimport { defaultComponents } from './components';\nimport type { ComponentMap, CreateRendererOptions, MarkdownRendererProps, MDNode } from './types';\nimport { getHeadingLevel, isTextNode } from './types';\n\n// -----------------------------------------------------------------------------\n// WASM Initialization (Singleton Pattern)\n// -----------------------------------------------------------------------------\n\n/**\n * Cached initialization promise.\n * Ensures init() is called exactly once, even with concurrent calls.\n */\nlet initPromise: Promise<void> | null = null;\n\n/**\n * Ensures md4w WASM is initialized before use.\n * Uses singleton pattern - multiple calls return the same promise.\n *\n * When md4w is listed in `serverExternalPackages`, it will be kept as an\n * external package and can properly resolve its WASM file using import.meta.url.\n *\n * @returns Promise that resolves when WASM is ready\n */\nasync function ensureInitialized(): Promise<void> {\n  if (!initPromise) {\n    // Use \"small\" variant (28KB gzipped) for faster loading\n    initPromise = init('small');\n  }\n  return initPromise;\n}\n\n// -----------------------------------------------------------------------------\n// Internal Helpers\n// -----------------------------------------------------------------------------\n\n/**\n * Recursively renders an AST node to React elements.\n *\n * @param node - The AST node (MDNode or string)\n * @param components - Component map for rendering\n * @param key - React key for list rendering\n * @returns React element or text\n */\nfunction renderNode(\n  node: string | MDNode,\n  components: ComponentMap,\n  key?: string | number\n): ReactNode {\n  // Text nodes render as-is\n  if (isTextNode(node)) {\n    return node;\n  }\n\n  const { type, props, children } = node;\n\n  // Recursively render children first\n  const renderedChildren = children?.map((child, index) => renderNode(child, components, index));\n\n  // Get component for this node type\n  const Component = components[type as NodeType];\n\n  if (Component) {\n    // Build props based on node type\n    const componentProps = buildComponentProps(type, props);\n\n    return (\n      <Fragment key={key}>{Component({ ...componentProps, children: renderedChildren })}</Fragment>\n    );\n  }\n\n  // Unmapped node types: warn in development and render children only\n  if (process.env.NODE_ENV === 'development') {\n    console.warn(\n      `[@repo/markdown-wasm] Unmapped node type: ${type} (${NodeType[type] ?? 'unknown'})`\n    );\n  }\n\n  return <Fragment key={key}>{renderedChildren}</Fragment>;\n}\n\n/**\n * Builds component props from AST node props.\n * Handles special cases like heading levels.\n */\nfunction buildComponentProps(\n  type: number,\n  props?: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...props };\n\n  // Add heading level for H1-H6 nodes\n  const headingLevel = getHeadingLevel(type as NodeType);\n  if (headingLevel !== undefined) {\n    result.level = headingLevel;\n  }\n\n  return result;\n}\n\n// -----------------------------------------------------------------------------\n// Public API\n// -----------------------------------------------------------------------------\n\n/**\n * Renders markdown content to React elements.\n *\n * This is an async Server Component that initializes the WASM module\n * on first use, then parses and renders markdown content.\n *\n * @example\n * ```tsx\n * import { MarkdownRenderer } from \"@repo/markdown-wasm\";\n *\n * // In a Server Component (async)\n * async function MyComponent() {\n *   return <MarkdownRenderer content=\"# Hello **world**\" />;\n * }\n *\n * // Or with await\n * export default async function Page() {\n *   return (\n *     <article>\n *       {await MarkdownRenderer({ content: markdown })}\n *     </article>\n *   );\n * }\n * ```\n */\nexport async function MarkdownRenderer({\n  content,\n  components: componentOverrides,\n  parseFlags,\n  className,\n}: MarkdownRendererProps): Promise<ReactNode> {\n  // Ensure WASM is initialized before parsing\n  await ensureInitialized();\n\n  // Parse markdown to AST\n  const ast = mdToJSON(content, { parseFlags });\n\n  // Merge default components with overrides\n  const components: ComponentMap = {\n    ...defaultComponents,\n    ...componentOverrides,\n  };\n\n  // Render AST children\n  const rendered = ast.children.map((node, index) => renderNode(node, components, index));\n\n  // Wrap in container if className provided, otherwise return fragment\n  if (className) {\n    return <div className={className}>{rendered}</div>;\n  }\n\n  return <>{rendered}</>;\n}\n\n/**\n * Creates a pre-configured markdown renderer with default settings.\n *\n * Returns an async function suitable for Server Components.\n *\n * @example\n * ```tsx\n * import { createMarkdownRenderer } from \"@repo/markdown-wasm\";\n * import { MyHeading, MyText, MyLink } from \"./components\";\n *\n * const CustomRenderer = createMarkdownRenderer({\n *   components: {\n *     [NodeType.H1]: ({ level, children }) => <MyHeading level={level}>{children}</MyHeading>,\n *     [NodeType.P]: ({ children }) => <MyText>{children}</MyText>,\n *     [NodeType.A]: ({ href, children }) => <MyLink href={href}>{children}</MyLink>,\n *   },\n *   className: \"prose prose-lg\",\n * });\n *\n * async function Article({ markdown }: { markdown: string }) {\n *   return <CustomRenderer content={markdown} />;\n * }\n * ```\n */\nexport function createMarkdownRenderer(options: CreateRendererOptions) {\n  const {\n    components: defaultOverrides,\n    parseFlags: defaultParseFlags,\n    className: defaultClassName,\n  } = options;\n\n  return async function ConfiguredMarkdownRenderer({\n    content,\n    components: instanceOverrides,\n    parseFlags: instanceParseFlags,\n    className: instanceClassName,\n  }: MarkdownRendererProps): Promise<ReactNode> {\n    return MarkdownRenderer({\n      content,\n      components: { ...defaultOverrides, ...instanceOverrides },\n      parseFlags: instanceParseFlags ?? defaultParseFlags,\n      className: instanceClassName ?? defaultClassName,\n    });\n  };\n}\n\n/**\n * Renders markdown to React elements without a wrapper component.\n * Useful for embedding markdown content inline.\n *\n * @example\n * ```tsx\n * import { renderMarkdown } from \"@repo/markdown-wasm\";\n *\n * // In an async Server Component\n * const elements = await renderMarkdown(\"**bold** and *italic*\");\n * ```\n */\nexport async function renderMarkdown(\n  content: string,\n  options?: Omit<MarkdownRendererProps, 'content'>\n): Promise<ReactNode> {\n  return MarkdownRenderer({ content, ...options });\n}\n\n/**\n * Explicitly initialize the md4w WASM module.\n * Useful for pre-warming in middleware or layout components.\n *\n * @example\n * ```tsx\n * // In layout.tsx\n * import { initMarkdown } from \"@repo/markdown-wasm\";\n *\n * export default async function RootLayout({ children }) {\n *   // Pre-warm WASM for faster first render\n *   await initMarkdown();\n *   return <html>{children}</html>;\n * }\n * ```\n */\nexport async function initMarkdown(): Promise<void> {\n  await ensureInitialized();\n}\n\n// Re-export for convenience\nexport { NodeType } from 'md4w';\n","/**\n * @repo/markdown-wasm - Type definitions\n *\n * Re-exports md4w types with additional utility types for React rendering.\n */\n\nimport type { MDNode, MDTree, NodeType, Options, ParseFlags } from 'md4w';\nimport type { ReactNode } from 'react';\n\n// Re-export md4w types\nexport type { MDNode, MDTree, NodeType, Options, ParseFlags };\n\n/**\n * Props passed to a custom component for an AST node.\n * Each node type has different props available.\n */\nexport interface NodeRenderProps {\n  /** The original AST node */\n  node: MDNode;\n  /** Rendered children (already converted to React elements) */\n  children: ReactNode;\n}\n\n/**\n * A component that renders a specific node type.\n * Receives the node props and pre-rendered children.\n */\nexport type NodeComponent<TProps = Record<string, unknown>> = (\n  props: TProps & { children: ReactNode }\n) => ReactNode;\n\n/**\n * Generic component function used internally.\n * Accepts any props and children.\n */\nexport type GenericNodeComponent = (\n  props: Record<string, unknown> & { children: ReactNode }\n) => ReactNode;\n\n/**\n * Component overrides map keyed by NodeType.\n * Each entry maps a node type number to a component function.\n * Uses GenericNodeComponent internally for flexibility.\n */\nexport type ComponentMap = Partial<Record<NodeType, GenericNodeComponent>>;\n\n/**\n * Utility type to extract props for a specific node type.\n * This provides type-safe access to node-specific properties.\n */\nexport type NodePropsFor<T extends NodeType> = T extends NodeType.CODE_BLOCK\n  ? { lang?: string }\n  : T extends NodeType.OL\n    ? { start?: number }\n    : T extends NodeType.LI\n      ? { isTask?: boolean; done?: boolean }\n      : T extends NodeType.TH | NodeType.TD\n        ? { align?: 'left' | 'center' | 'right' | '' }\n        : T extends NodeType.A\n          ? { href: string; title?: string }\n          : T extends NodeType.IMG\n            ? { src: string; alt: string; title?: string }\n            : T extends NodeType.WIKILINK\n              ? { target: string }\n              : T extends\n                    | NodeType.H1\n                    | NodeType.H2\n                    | NodeType.H3\n                    | NodeType.H4\n                    | NodeType.H5\n                    | NodeType.H6\n                ? { level: 1 | 2 | 3 | 4 | 5 | 6 }\n                : Record<string, unknown>;\n\n/**\n * Props for the MarkdownRenderer component.\n */\nexport interface MarkdownRendererProps {\n  /** Markdown content to render */\n  content: string;\n  /** Optional component overrides */\n  components?: ComponentMap;\n  /** Optional parse flags for md4w */\n  parseFlags?: Options['parseFlags'];\n  /** Optional className for the wrapper element */\n  className?: string;\n}\n\n/**\n * Factory function options for creating a custom renderer.\n */\nexport interface CreateRendererOptions {\n  /** Component overrides */\n  components?: ComponentMap;\n  /** Default parse flags */\n  parseFlags?: Options['parseFlags'];\n  /** Default wrapper className */\n  className?: string;\n}\n\n/**\n * Heading level type (1-6).\n */\nexport type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\n/**\n * Maps NodeType.H1-H6 to numeric heading level.\n */\nexport function getHeadingLevel(type: NodeType): HeadingLevel | undefined {\n  const levelMap: Record<number, HeadingLevel> = {\n    21: 1,\n    22: 2,\n    23: 3,\n    24: 4,\n    25: 5,\n    26: 6,\n  };\n  return levelMap[type];\n}\n\n/**\n * Type guard to check if a node is a text node (string).\n */\nexport function isTextNode(node: string | MDNode): node is string {\n  return typeof node === 'string';\n}\n\n/**\n * Type guard to check if a node is an element node (MDNode).\n */\nexport function isElementNode(node: string | MDNode): node is MDNode {\n  return typeof node !== 'string' && typeof node === 'object' && 'type' in node;\n}\n","import {\n  type ComponentMap,\n  defaultComponents,\n  getHeadingLevel,\n  initMarkdown as initMarkdownWasm,\n  type MDNode,\n  mdToJSON,\n  NodeType,\n} from '@repo/markdown-wasm';\nimport { Fragment, type ReactNode } from 'react';\nimport { type BuiltinLanguage, codeToTokens } from 'shiki';\n\nexport interface DocsMarkdownProps {\n  content: string;\n  className?: string;\n  renderImage?: (props: { src: string; alt: string; title?: string }) => ReactNode;\n}\n\nconst defaultClassName = 'cms-docs-markdown';\nlet markdownInitPromise: Promise<void> | undefined;\n\nexport function markdownStartsWithHeading(markdown: string): boolean {\n  return /^\\s*#\\s+/.test(markdown);\n}\n\nexport async function initMarkdown(): Promise<void> {\n  markdownInitPromise ??= initMarkdownWasm();\n  await markdownInitPromise;\n}\n\nfunction isTextNode(node: string | MDNode): node is string {\n  return typeof node === 'string';\n}\n\nfunction buildComponentProps(\n  type: number,\n  props?: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...props };\n  const headingLevel = getHeadingLevel(type as NodeType);\n\n  if (headingLevel !== undefined) {\n    result.level = headingLevel;\n  }\n\n  return result;\n}\n\nfunction normalizeLanguage(lang: unknown): string {\n  if (typeof lang !== 'string') {\n    return 'text';\n  }\n\n  const normalized = lang.trim().toLowerCase();\n  return normalized || 'text';\n}\n\nasync function renderHighlightedCode(code: string, lang: unknown): Promise<ReactNode> {\n  const language = normalizeLanguage(lang);\n\n  try {\n    const result = await codeToTokens(code, {\n      lang: language as BuiltinLanguage,\n      theme: 'github-dark',\n    });\n\n    return (\n      <pre\n        className={`shiki language-${language}`}\n        style={{ backgroundColor: result.bg, color: result.fg }}\n      >\n        <code className={`shiki_code language-${language}`} data-language={language}>\n          {(() => {\n            const lineOccurrences = new Map<string, number>();\n\n            return result.tokens.map((line, lineIndex) => {\n              const isLastLine = lineIndex === result.tokens.length - 1;\n              const lineSignature = line\n                .map((token) => `${token.offset}:${token.color ?? ''}:${token.content}`)\n                .join('|');\n              const lineOccurrence = lineOccurrences.get(lineSignature) ?? 0;\n\n              lineOccurrences.set(lineSignature, lineOccurrence + 1);\n\n              let tokenCursor = 0;\n\n              return (\n                <Fragment key={`${lineSignature}#${lineOccurrence}`}>\n                  {line.map((token) => {\n                    const tokenKey = `${token.offset}:${token.color ?? ''}:${tokenCursor}:${token.content}`;\n                    tokenCursor += token.content.length;\n\n                    return (\n                      <span key={tokenKey} style={{ color: token.color }}>\n                        {token.content}\n                      </span>\n                    );\n                  })}\n                  {isLastLine ? null : '\\n'}\n                </Fragment>\n              );\n            });\n          })()}\n        </code>\n      </pre>\n    );\n  } catch {\n    return (\n      <pre className={`language-${language}`}>\n        <code className={`language-${language}`}>{code}</code>\n      </pre>\n    );\n  }\n}\n\nasync function renderNode(\n  node: string | MDNode,\n  components: ComponentMap,\n  renderImage: DocsMarkdownProps['renderImage'],\n  key?: string | number\n): Promise<ReactNode> {\n  if (isTextNode(node)) {\n    return node;\n  }\n\n  const { type, props, children } = node;\n\n  if (type === NodeType.IMG && renderImage) {\n    return (\n      <Fragment key={key}>\n        {renderImage({\n          src: typeof props?.src === 'string' ? props.src : '',\n          alt: typeof props?.alt === 'string' ? props.alt : '',\n          title: typeof props?.title === 'string' ? props.title : undefined,\n        })}\n      </Fragment>\n    );\n  }\n\n  if (type === NodeType.CODE_BLOCK) {\n    const code = children?.filter(isTextNode).join('') ?? '';\n    return <Fragment key={key}>{await renderHighlightedCode(code, props?.lang)}</Fragment>;\n  }\n\n  const renderedChildren = children\n    ? await Promise.all(\n        children.map((child, index) => renderNode(child, components, renderImage, index))\n      )\n    : undefined;\n\n  const Component = components[type as NodeType];\n\n  if (Component) {\n    const componentProps = buildComponentProps(type, props);\n    return (\n      <Fragment key={key}>{Component({ ...componentProps, children: renderedChildren })}</Fragment>\n    );\n  }\n\n  return <Fragment key={key}>{renderedChildren}</Fragment>;\n}\n\nexport async function DocsMarkdown({\n  content,\n  className = defaultClassName,\n  renderImage,\n}: DocsMarkdownProps) {\n  await initMarkdown();\n\n  const ast = mdToJSON(content);\n  const rendered = await Promise.all(\n    ast.children.map((node, index) => renderNode(node, defaultComponents, renderImage, index))\n  );\n\n  const resolvedClassName =\n    className === defaultClassName ? defaultClassName : `${defaultClassName} ${className}`.trim();\n\n  return <div className={resolvedClassName}>{rendered}</div>;\n}\n"],"mappings":"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","names":["init","mdToJSON","NodeType","NodeType","Fragment","jsx","Fragment","jsx","jsxs","initMarkdown","isTextNode","NodeType","mdToJSON"]}
+{"version":3,"sources":["../../../../packages/markdown-wasm/src/index.ts","../../../../packages/markdown-wasm/src/components.tsx","../../../../packages/markdown-wasm/src/renderer.tsx","../../../../packages/markdown-wasm/src/types.ts","../../lib/docs-markdown.tsx"],"sourcesContent":["/**\n * @repo/markdown-wasm\n *\n * High-performance markdown rendering using md4w WASM engine\n * with React component mapping support.\n *\n * @example\n * ```tsx\n * import { MarkdownRenderer, createMarkdownRenderer, NodeType } from \"@repo/markdown-wasm\";\n *\n * // Basic usage\n * <MarkdownRenderer content=\"# Hello **world**\" />\n *\n * // With custom components\n * <MarkdownRenderer\n *   content={markdown}\n *   components={{\n *     [NodeType.H1]: ({ children }) => <MyHeading>{children}</MyHeading>,\n *   }}\n * />\n *\n * // Factory pattern for reusable renderer\n * const CustomRenderer = createMarkdownRenderer({\n *   components: { ... },\n *   className: \"prose\",\n * });\n * <CustomRenderer content={markdown} />\n * ```\n */\n\n// Re-export md4w utilities for advanced usage\nexport { init, mdToHtml, mdToJSON, mdToReadableHtml, ParseFlags as Md4wParseFlags } from 'md4w';\n\n// Component exports\nexport { defaultComponents, minimalComponents } from './components';\n// Main renderer exports\nexport {\n  createMarkdownRenderer,\n  initMarkdown,\n  MarkdownRenderer,\n  NodeType,\n  renderMarkdown,\n} from './renderer';\n// Type exports\nexport type {\n  ComponentMap,\n  CreateRendererOptions,\n  GenericNodeComponent,\n  HeadingLevel,\n  MarkdownRendererProps,\n  MDNode,\n  MDTree,\n  NodeComponent,\n  NodePropsFor,\n  NodeRenderProps,\n  Options,\n  ParseFlags,\n} from './types';\n// Utility exports\nexport { getHeadingLevel, isElementNode, isTextNode } from './types';\n","/**\n * @repo/markdown-wasm - Default Component Mappings\n *\n * Provides semantic HTML components for all md4w node types.\n * Override any of these by passing custom components to MarkdownRenderer.\n */\n\nimport { NodeType } from 'md4w';\nimport type { ReactNode } from 'react';\n\nimport type { ComponentMap, HeadingLevel } from './types';\n\n/**\n * Default heading component.\n * Renders H1-H6 based on level prop.\n */\nfunction Heading({ level, children }: { level: HeadingLevel; children: ReactNode }) {\n  const Tag = `h${level}` as const;\n  return <Tag>{children}</Tag>;\n}\n\n/**\n * Default components for all md4w node types.\n * These render semantic HTML elements that can be styled with CSS.\n *\n * Props are accessed from a generic props object to satisfy GenericNodeComponent type.\n * Runtime guarantees from md4w ensure the props exist for each node type.\n */\nexport const defaultComponents: ComponentMap = {\n  // Block elements\n  [NodeType.QUOTE]: (props) => <blockquote>{props.children}</blockquote>,\n  [NodeType.UL]: (props) => <ul>{props.children}</ul>,\n  [NodeType.OL]: (props) => <ol start={props.start as number | undefined}>{props.children}</ol>,\n  [NodeType.LI]: (props) => {\n    const isTask = props.isTask as boolean | undefined;\n    const done = props.done as boolean | undefined;\n    if (isTask) {\n      return (\n        <li>\n          <input type=\"checkbox\" checked={done} disabled readOnly />\n          {props.children}\n        </li>\n      );\n    }\n    return <li>{props.children}</li>;\n  },\n  [NodeType.HR]: () => <hr />,\n  [NodeType.CODE_BLOCK]: (props: { lang?: string; children: React.ReactNode }) => {\n    const language = props.lang?.toLowerCase() || 'plaintext';\n    const languageClass = language ? `language-${language}` : undefined;\n    return (\n      <pre className={languageClass}>\n        <code className={languageClass} data-language={language}>\n          {props.children}\n        </code>\n      </pre>\n    );\n  },\n  [NodeType.HTML]: (props) => {\n    const html = getHtmlString(props.children);\n    if (html && isLineBreakHtml(html)) {\n      return <br />;\n    }\n    // HTML blocks are rendered as-is inside a div\n    // Note: This is raw HTML from markdown, use dangerouslySetInnerHTML if needed\n    return <div data-markdown-html>{props.children}</div>;\n  },\n  [NodeType.P]: (props) => <p>{props.children}</p>,\n\n  // Table elements\n  [NodeType.TABLE]: (props) => <table>{props.children}</table>,\n  [NodeType.THEAD]: (props) => <thead>{props.children}</thead>,\n  [NodeType.TBODY]: (props) => <tbody>{props.children}</tbody>,\n  [NodeType.TR]: (props) => <tr>{props.children}</tr>,\n  [NodeType.TH]: (props) => {\n    const align = props.align as 'left' | 'center' | 'right' | '' | undefined;\n    return <th style={align ? { textAlign: align } : undefined}>{props.children}</th>;\n  },\n  [NodeType.TD]: (props) => {\n    const align = props.align as 'left' | 'center' | 'right' | '' | undefined;\n    return <td style={align ? { textAlign: align } : undefined}>{props.children}</td>;\n  },\n\n  // Headings (H1-H6 share the same component with level prop injected by renderer)\n  [NodeType.H1]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 1}>{props.children}</Heading>\n  ),\n  [NodeType.H2]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 2}>{props.children}</Heading>\n  ),\n  [NodeType.H3]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 3}>{props.children}</Heading>\n  ),\n  [NodeType.H4]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 4}>{props.children}</Heading>\n  ),\n  [NodeType.H5]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 5}>{props.children}</Heading>\n  ),\n  [NodeType.H6]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 6}>{props.children}</Heading>\n  ),\n\n  // Inline elements\n  [NodeType.EM]: (props) => <em>{props.children}</em>,\n  [NodeType.STRONG]: (props) => <strong>{props.children}</strong>,\n  [NodeType.A]: (props) => (\n    <a href={props.href as string} title={props.title as string | undefined}>\n      {props.children}\n    </a>\n  ),\n  [NodeType.IMG]: (props) => (\n    // biome-ignore lint/performance/noImgElement: Generic markdown package, not Next.js specific. Users can override with next/image.\n    <img\n      src={props.src as string}\n      alt={props.alt as string}\n      title={props.title as string | undefined}\n    />\n  ),\n  [NodeType.CODE_SPAN]: (props) => <code>{props.children}</code>,\n  [NodeType.DEL]: (props) => <del>{props.children}</del>,\n\n  // Math (LaTeX)\n  [NodeType.LATEXMATH]: (props) => <span data-math=\"inline\">{props.children}</span>,\n  [NodeType.LATEXMATH_DISPLAY]: (props) => <div data-math=\"display\">{props.children}</div>,\n\n  // Wiki links\n  [NodeType.WIKILINK]: (props) => {\n    const target = props.target as string;\n    return (\n      <a href={`/wiki/${encodeURIComponent(target)}`} data-wikilink={target}>\n        {props.children}\n      </a>\n    );\n  },\n\n  // Underline (when UNDERLINE parse flag is enabled)\n  [NodeType.U]: (props) => <u>{props.children}</u>,\n};\n\nfunction getHtmlString(children: ReactNode): string | null {\n  if (typeof children === 'string') {\n    return children;\n  }\n  if (Array.isArray(children) && children.length === 1 && typeof children[0] === 'string') {\n    return children[0];\n  }\n  return null;\n}\n\nfunction isLineBreakHtml(html: string): boolean {\n  const trimmed = html.trim().toLowerCase();\n  return trimmed === '<br>' || trimmed === '<br/>' || trimmed === '<br />';\n}\n\n/**\n * Minimal component set - only essential elements.\n * Use this when you want to style everything yourself.\n */\nexport const minimalComponents: ComponentMap = {\n  [NodeType.P]: (props) => <p>{props.children}</p>,\n  [NodeType.H1]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 1}>{props.children}</Heading>\n  ),\n  [NodeType.H2]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 2}>{props.children}</Heading>\n  ),\n  [NodeType.H3]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 3}>{props.children}</Heading>\n  ),\n  [NodeType.H4]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 4}>{props.children}</Heading>\n  ),\n  [NodeType.H5]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 5}>{props.children}</Heading>\n  ),\n  [NodeType.H6]: (props) => (\n    <Heading level={(props.level as HeadingLevel) ?? 6}>{props.children}</Heading>\n  ),\n  [NodeType.STRONG]: (props) => <strong>{props.children}</strong>,\n  [NodeType.EM]: (props) => <em>{props.children}</em>,\n  [NodeType.A]: (props) => <a href={props.href as string}>{props.children}</a>,\n  [NodeType.CODE_SPAN]: (props) => <code>{props.children}</code>,\n};\n","/**\n * @repo/markdown-wasm - AST to React Renderer\n *\n * Converts md4w JSON AST to React components.\n * Pattern B from research: Direct AST-to-React mapping for maximum performance.\n *\n * IMPORTANT: md4w is a WASM module that requires async initialization.\n * This module uses a singleton pattern with cached promise to ensure\n * init() is called exactly once before any parsing.\n *\n * NOTE: For Vercel/Next.js deployment, ensure `serverExternalPackages: ['md4w']`\n * is set in next.config.ts so md4w can properly resolve its WASM files.\n */\n\nimport { init, mdToJSON, NodeType } from 'md4w';\nimport { Fragment, type ReactNode } from 'react';\n\nimport { defaultComponents } from './components';\nimport type { ComponentMap, CreateRendererOptions, MarkdownRendererProps, MDNode } from './types';\nimport { getHeadingLevel, isTextNode } from './types';\n\n// -----------------------------------------------------------------------------\n// WASM Initialization (Singleton Pattern)\n// -----------------------------------------------------------------------------\n\n/**\n * Cached initialization promise.\n * Ensures init() is called exactly once, even with concurrent calls.\n */\nlet initPromise: Promise<void> | null = null;\n\n/**\n * Ensures md4w WASM is initialized before use.\n * Uses singleton pattern - multiple calls return the same promise.\n *\n * When md4w is listed in `serverExternalPackages`, it will be kept as an\n * external package and can properly resolve its WASM file using import.meta.url.\n *\n * @returns Promise that resolves when WASM is ready\n */\nasync function ensureInitialized(): Promise<void> {\n  if (!initPromise) {\n    // Use \"small\" variant (28KB gzipped) for faster loading\n    initPromise = init('small');\n  }\n  return initPromise;\n}\n\n// -----------------------------------------------------------------------------\n// Internal Helpers\n// -----------------------------------------------------------------------------\n\n/**\n * Recursively renders an AST node to React elements.\n *\n * @param node - The AST node (MDNode or string)\n * @param components - Component map for rendering\n * @param key - React key for list rendering\n * @returns React element or text\n */\nfunction renderNode(\n  node: string | MDNode,\n  components: ComponentMap,\n  key?: string | number\n): ReactNode {\n  // Text nodes render as-is\n  if (isTextNode(node)) {\n    return node;\n  }\n\n  const { type, props, children } = node;\n\n  // Recursively render children first\n  const renderedChildren = children?.map((child, index) => renderNode(child, components, index));\n\n  // Get component for this node type\n  const Component = components[type as NodeType];\n\n  if (Component) {\n    // Build props based on node type\n    const componentProps = buildComponentProps(type, props);\n\n    return (\n      <Fragment key={key}>{Component({ ...componentProps, children: renderedChildren })}</Fragment>\n    );\n  }\n\n  // Unmapped node types: warn in development and render children only\n  if (process.env.NODE_ENV === 'development') {\n    console.warn(\n      `[@repo/markdown-wasm] Unmapped node type: ${type} (${NodeType[type] ?? 'unknown'})`\n    );\n  }\n\n  return <Fragment key={key}>{renderedChildren}</Fragment>;\n}\n\n/**\n * Builds component props from AST node props.\n * Handles special cases like heading levels.\n */\nfunction buildComponentProps(\n  type: number,\n  props?: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...props };\n\n  // Add heading level for H1-H6 nodes\n  const headingLevel = getHeadingLevel(type as NodeType);\n  if (headingLevel !== undefined) {\n    result.level = headingLevel;\n  }\n\n  return result;\n}\n\n// -----------------------------------------------------------------------------\n// Public API\n// -----------------------------------------------------------------------------\n\n/**\n * Renders markdown content to React elements.\n *\n * This is an async Server Component that initializes the WASM module\n * on first use, then parses and renders markdown content.\n *\n * @example\n * ```tsx\n * import { MarkdownRenderer } from \"@repo/markdown-wasm\";\n *\n * // In a Server Component (async)\n * async function MyComponent() {\n *   return <MarkdownRenderer content=\"# Hello **world**\" />;\n * }\n *\n * // Or with await\n * export default async function Page() {\n *   return (\n *     <article>\n *       {await MarkdownRenderer({ content: markdown })}\n *     </article>\n *   );\n * }\n * ```\n */\nexport async function MarkdownRenderer({\n  content,\n  components: componentOverrides,\n  parseFlags,\n  className,\n}: MarkdownRendererProps): Promise<ReactNode> {\n  // Ensure WASM is initialized before parsing\n  await ensureInitialized();\n\n  // Parse markdown to AST\n  const ast = mdToJSON(content, { parseFlags });\n\n  // Merge default components with overrides\n  const components: ComponentMap = {\n    ...defaultComponents,\n    ...componentOverrides,\n  };\n\n  // Render AST children\n  const rendered = ast.children.map((node, index) => renderNode(node, components, index));\n\n  // Wrap in container if className provided, otherwise return fragment\n  if (className) {\n    return <div className={className}>{rendered}</div>;\n  }\n\n  return <>{rendered}</>;\n}\n\n/**\n * Creates a pre-configured markdown renderer with default settings.\n *\n * Returns an async function suitable for Server Components.\n *\n * @example\n * ```tsx\n * import { createMarkdownRenderer } from \"@repo/markdown-wasm\";\n * import { MyHeading, MyText, MyLink } from \"./components\";\n *\n * const CustomRenderer = createMarkdownRenderer({\n *   components: {\n *     [NodeType.H1]: ({ level, children }) => <MyHeading level={level}>{children}</MyHeading>,\n *     [NodeType.P]: ({ children }) => <MyText>{children}</MyText>,\n *     [NodeType.A]: ({ href, children }) => <MyLink href={href}>{children}</MyLink>,\n *   },\n *   className: \"prose prose-lg\",\n * });\n *\n * async function Article({ markdown }: { markdown: string }) {\n *   return <CustomRenderer content={markdown} />;\n * }\n * ```\n */\nexport function createMarkdownRenderer(options: CreateRendererOptions) {\n  const {\n    components: defaultOverrides,\n    parseFlags: defaultParseFlags,\n    className: defaultClassName,\n  } = options;\n\n  return async function ConfiguredMarkdownRenderer({\n    content,\n    components: instanceOverrides,\n    parseFlags: instanceParseFlags,\n    className: instanceClassName,\n  }: MarkdownRendererProps): Promise<ReactNode> {\n    return MarkdownRenderer({\n      content,\n      components: { ...defaultOverrides, ...instanceOverrides },\n      parseFlags: instanceParseFlags ?? defaultParseFlags,\n      className: instanceClassName ?? defaultClassName,\n    });\n  };\n}\n\n/**\n * Renders markdown to React elements without a wrapper component.\n * Useful for embedding markdown content inline.\n *\n * @example\n * ```tsx\n * import { renderMarkdown } from \"@repo/markdown-wasm\";\n *\n * // In an async Server Component\n * const elements = await renderMarkdown(\"**bold** and *italic*\");\n * ```\n */\nexport async function renderMarkdown(\n  content: string,\n  options?: Omit<MarkdownRendererProps, 'content'>\n): Promise<ReactNode> {\n  return MarkdownRenderer({ content, ...options });\n}\n\n/**\n * Explicitly initialize the md4w WASM module.\n * Useful for pre-warming in middleware or layout components.\n *\n * @example\n * ```tsx\n * // In layout.tsx\n * import { initMarkdown } from \"@repo/markdown-wasm\";\n *\n * export default async function RootLayout({ children }) {\n *   // Pre-warm WASM for faster first render\n *   await initMarkdown();\n *   return <html>{children}</html>;\n * }\n * ```\n */\nexport async function initMarkdown(): Promise<void> {\n  await ensureInitialized();\n}\n\n// Re-export for convenience\nexport { NodeType } from 'md4w';\n","/**\n * @repo/markdown-wasm - Type definitions\n *\n * Re-exports md4w types with additional utility types for React rendering.\n */\n\nimport type { MDNode, MDTree, NodeType, Options, ParseFlags } from 'md4w';\nimport type { ReactNode } from 'react';\n\n// Re-export md4w types\nexport type { MDNode, MDTree, NodeType, Options, ParseFlags };\n\n/**\n * Props passed to a custom component for an AST node.\n * Each node type has different props available.\n */\nexport interface NodeRenderProps {\n  /** The original AST node */\n  node: MDNode;\n  /** Rendered children (already converted to React elements) */\n  children: ReactNode;\n}\n\n/**\n * A component that renders a specific node type.\n * Receives the node props and pre-rendered children.\n */\nexport type NodeComponent<TProps = Record<string, unknown>> = (\n  props: TProps & { children: ReactNode }\n) => ReactNode;\n\n/**\n * Generic component function used internally.\n * Accepts any props and children.\n */\nexport type GenericNodeComponent = (\n  props: Record<string, unknown> & { children: ReactNode }\n) => ReactNode;\n\n/**\n * Component overrides map keyed by NodeType.\n * Each entry maps a node type number to a component function.\n * Uses GenericNodeComponent internally for flexibility.\n */\nexport type ComponentMap = Partial<Record<NodeType, GenericNodeComponent>>;\n\n/**\n * Utility type to extract props for a specific node type.\n * This provides type-safe access to node-specific properties.\n */\nexport type NodePropsFor<T extends NodeType> = T extends NodeType.CODE_BLOCK\n  ? { lang?: string }\n  : T extends NodeType.OL\n    ? { start?: number }\n    : T extends NodeType.LI\n      ? { isTask?: boolean; done?: boolean }\n      : T extends NodeType.TH | NodeType.TD\n        ? { align?: 'left' | 'center' | 'right' | '' }\n        : T extends NodeType.A\n          ? { href: string; title?: string }\n          : T extends NodeType.IMG\n            ? { src: string; alt: string; title?: string }\n            : T extends NodeType.WIKILINK\n              ? { target: string }\n              : T extends\n                    | NodeType.H1\n                    | NodeType.H2\n                    | NodeType.H3\n                    | NodeType.H4\n                    | NodeType.H5\n                    | NodeType.H6\n                ? { level: 1 | 2 | 3 | 4 | 5 | 6 }\n                : Record<string, unknown>;\n\n/**\n * Props for the MarkdownRenderer component.\n */\nexport interface MarkdownRendererProps {\n  /** Markdown content to render */\n  content: string;\n  /** Optional component overrides */\n  components?: ComponentMap;\n  /** Optional parse flags for md4w */\n  parseFlags?: Options['parseFlags'];\n  /** Optional className for the wrapper element */\n  className?: string;\n}\n\n/**\n * Factory function options for creating a custom renderer.\n */\nexport interface CreateRendererOptions {\n  /** Component overrides */\n  components?: ComponentMap;\n  /** Default parse flags */\n  parseFlags?: Options['parseFlags'];\n  /** Default wrapper className */\n  className?: string;\n}\n\n/**\n * Heading level type (1-6).\n */\nexport type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\n/**\n * Maps NodeType.H1-H6 to numeric heading level.\n */\nexport function getHeadingLevel(type: NodeType): HeadingLevel | undefined {\n  const levelMap: Record<number, HeadingLevel> = {\n    21: 1,\n    22: 2,\n    23: 3,\n    24: 4,\n    25: 5,\n    26: 6,\n  };\n  return levelMap[type];\n}\n\n/**\n * Type guard to check if a node is a text node (string).\n */\nexport function isTextNode(node: string | MDNode): node is string {\n  return typeof node === 'string';\n}\n\n/**\n * Type guard to check if a node is an element node (MDNode).\n */\nexport function isElementNode(node: string | MDNode): node is MDNode {\n  return typeof node !== 'string' && typeof node === 'object' && 'type' in node;\n}\n","import {\n  type ComponentMap,\n  defaultComponents,\n  getHeadingLevel,\n  initMarkdown as initMarkdownWasm,\n  type MDNode,\n  mdToJSON,\n  NodeType,\n} from '@repo/markdown-wasm';\nimport { Fragment, type ReactNode } from 'react';\nimport { type BundledLanguage, bundledLanguages, createHighlighter, type Highlighter } from 'shiki';\n\nexport interface DocsMarkdownProps {\n  content: string;\n  className?: string;\n  renderImage?: (props: {\n    src: string;\n    alt: string;\n    title?: string;\n    loading?: 'eager' | 'lazy';\n  }) => ReactNode;\n}\n\nconst defaultClassName = 'cms-docs-markdown';\nlet markdownInitPromise: Promise<void> | undefined;\n\n// Pre-load common languages for fast cold-start\n// Less common languages are lazy-loaded on demand\nconst PRELOADED_LANGS: BundledLanguage[] = [\n  // Web\n  'typescript',\n  'javascript',\n  'tsx',\n  'jsx',\n  'html',\n  'css',\n  'scss',\n  // Systems\n  'c',\n  'cpp',\n  'rust',\n  'go',\n  // Enterprise\n  'java',\n  'csharp',\n  'kotlin',\n  'swift',\n  // Scripting\n  'python',\n  'ruby',\n  'php',\n  'bash',\n  'shellscript',\n  'powershell',\n  // Data\n  'json',\n  'yaml',\n  'toml',\n  'xml',\n  'sql',\n  'graphql',\n  // Other\n  'markdown',\n  'dockerfile',\n];\n\n// Cache the highlighter instance to avoid re-loading languages/themes\nlet highlighterPromise: Promise<Highlighter> | undefined;\n\n// Track which languages have been loaded\nconst loadedLanguages = new Set<string>(PRELOADED_LANGS);\n\nasync function getHighlighter(): Promise<Highlighter> {\n  highlighterPromise ??= createHighlighter({\n    themes: ['github-dark'],\n    langs: PRELOADED_LANGS,\n  });\n  return highlighterPromise;\n}\n\n/**\n * Ensures a language is loaded, lazy-loading if needed.\n * Returns the resolved language name, or null if not a valid language.\n */\nasync function ensureLanguageLoaded(\n  highlighter: Highlighter,\n  lang: string\n): Promise<BundledLanguage | null> {\n  // Already loaded\n  if (loadedLanguages.has(lang)) {\n    return lang as BundledLanguage;\n  }\n\n  // Check if it's a valid bundled language\n  if (lang in bundledLanguages) {\n    try {\n      await highlighter.loadLanguage(lang as BundledLanguage);\n      loadedLanguages.add(lang);\n      return lang as BundledLanguage;\n    } catch {\n      // Loading failed, will render as plain code\n      return null;\n    }\n  }\n\n  // Unknown language, will render as plain code\n  return null;\n}\n\n// Pre-warm WASM and Shiki at module load to avoid cold start penalty\n// This runs once when the module is first imported (server startup)\nif (typeof window === 'undefined') {\n  // Server-side only: trigger initialization immediately\n  markdownInitPromise = initMarkdownWasm();\n  highlighterPromise = createHighlighter({\n    themes: ['github-dark'],\n    langs: PRELOADED_LANGS,\n  });\n  // Log pre-warming for debugging\n  Promise.all([markdownInitPromise, highlighterPromise])\n    .then(() =>\n      console.log(`[docs-markdown] WASM and Shiki pre-warmed (${PRELOADED_LANGS.length} languages)`)\n    )\n    .catch((err) => console.error('[docs-markdown] Pre-warm failed:', err));\n}\n\nexport function markdownStartsWithHeading(markdown: string): boolean {\n  return /^\\s*#\\s+/.test(markdown);\n}\n\nexport async function initMarkdown(): Promise<void> {\n  markdownInitPromise ??= initMarkdownWasm();\n  await markdownInitPromise;\n}\n\nfunction isTextNode(node: string | MDNode): node is string {\n  return typeof node === 'string';\n}\n\nfunction buildComponentProps(\n  type: number,\n  props?: Record<string, unknown>\n): Record<string, unknown> {\n  const result = { ...props };\n  const headingLevel = getHeadingLevel(type as NodeType);\n\n  if (headingLevel !== undefined) {\n    result.level = headingLevel;\n  }\n\n  return result;\n}\n\nfunction normalizeLanguage(lang: unknown): string {\n  if (typeof lang !== 'string') {\n    return '';\n  }\n\n  const normalized = lang.trim().toLowerCase();\n  return normalized;\n}\n\nfunction decodeHtmlEntities(value: string): string {\n  return value\n    .replaceAll('&lt;', '<')\n    .replaceAll('&gt;', '>')\n    .replaceAll('&quot;', '\"')\n    .replaceAll('&#39;', \"'\")\n    .replaceAll('&amp;', '&');\n}\n\nasync function renderHighlightedCode(code: string, lang: unknown): Promise<ReactNode> {\n  const language = normalizeLanguage(lang);\n  const displayLanguage = language || 'text';\n\n  try {\n    const highlighter = await getHighlighter();\n    // Ensure language is loaded (lazy-load if needed)\n    const resolvedLang = await ensureLanguageLoaded(highlighter, language);\n\n    // If language not supported, render plain code\n    if (!resolvedLang) {\n      return (\n        <pre className={`language-${displayLanguage}`}>\n          <code className={`language-${displayLanguage}`}>{code}</code>\n        </pre>\n      );\n    }\n\n    const result = highlighter.codeToTokens(code, {\n      lang: resolvedLang,\n      theme: 'github-dark',\n    });\n\n    return (\n      <pre\n        className={`shiki language-${displayLanguage}`}\n        style={{ backgroundColor: result.bg, color: result.fg }}\n      >\n        <code className={`shiki_code language-${displayLanguage}`} data-language={displayLanguage}>\n          {(() => {\n            const lineOccurrences = new Map<string, number>();\n\n            return result.tokens.map((line, lineIndex) => {\n              const isLastLine = lineIndex === result.tokens.length - 1;\n              const lineSignature = line\n                .map((token) => `${token.offset}:${token.color ?? ''}:${token.content}`)\n                .join('|');\n              const lineOccurrence = lineOccurrences.get(lineSignature) ?? 0;\n\n              lineOccurrences.set(lineSignature, lineOccurrence + 1);\n\n              let tokenCursor = 0;\n\n              return (\n                <Fragment key={`${lineSignature}#${lineOccurrence}`}>\n                  {line.map((token) => {\n                    const tokenKey = `${token.offset}:${token.color ?? ''}:${tokenCursor}:${token.content}`;\n                    tokenCursor += token.content.length;\n\n                    return (\n                      <span key={tokenKey} style={{ color: token.color }}>\n                        {token.content}\n                      </span>\n                    );\n                  })}\n                  {isLastLine ? null : '\\n'}\n                </Fragment>\n              );\n            });\n          })()}\n        </code>\n      </pre>\n    );\n  } catch {\n    return (\n      <pre className={`language-${displayLanguage}`}>\n        <code className={`language-${displayLanguage}`}>{code}</code>\n      </pre>\n    );\n  }\n}\n\nasync function renderNode(\n  node: string | MDNode,\n  components: ComponentMap,\n  renderImage: DocsMarkdownProps['renderImage'],\n  imageIndexRef: { current: number },\n  key?: string | number\n): Promise<ReactNode> {\n  if (isTextNode(node)) {\n    return decodeHtmlEntities(node);\n  }\n\n  const { type, props, children } = node;\n\n  if (type === NodeType.IMG && renderImage) {\n    const imageIndex = imageIndexRef.current;\n    imageIndexRef.current += 1;\n\n    return (\n      <Fragment key={key}>\n        {renderImage({\n          src: typeof props?.src === 'string' ? props.src : '',\n          alt: typeof props?.alt === 'string' ? props.alt : '',\n          title: typeof props?.title === 'string' ? props.title : undefined,\n          loading: imageIndex === 0 ? 'eager' : 'lazy',\n        })}\n      </Fragment>\n    );\n  }\n\n  if (type === NodeType.CODE_BLOCK) {\n    const rawCode = children?.filter(isTextNode).join('') ?? '';\n    const code = decodeHtmlEntities(rawCode);\n    return <Fragment key={key}>{await renderHighlightedCode(code, props?.lang)}</Fragment>;\n  }\n\n  const renderedChildren = children\n    ? await Promise.all(\n        children.map((child, index) =>\n          renderNode(child, components, renderImage, imageIndexRef, index)\n        )\n      )\n    : undefined;\n\n  const Component = components[type as NodeType];\n\n  if (Component) {\n    const componentProps = buildComponentProps(type, props);\n    return (\n      <Fragment key={key}>{Component({ ...componentProps, children: renderedChildren })}</Fragment>\n    );\n  }\n\n  return <Fragment key={key}>{renderedChildren}</Fragment>;\n}\n\nexport async function DocsMarkdown({\n  content,\n  className = defaultClassName,\n  renderImage,\n}: DocsMarkdownProps) {\n  await initMarkdown();\n\n  const ast = mdToJSON(content);\n  const imageIndexRef = { current: 0 };\n  const rendered = await Promise.all(\n    ast.children.map((node, index) =>\n      renderNode(node, defaultComponents, renderImage, imageIndexRef, index)\n    )\n  );\n\n  const resolvedClassName =\n    className === defaultClassName ? defaultClassName : `${defaultClassName} ${className}`.trim();\n\n  return <div className={resolvedClassName}>{rendered}</div>;\n}\n"],"mappings":"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","names":["init","mdToJSON","NodeType","NodeType","Fragment","jsx","Fragment","jsx","jsxs","initMarkdown","isTextNode","NodeType","mdToJSON"]}

package/dist/lib/parametric-route.d.ts

@@ -0,0 +1,41 @@
+export { normalizePath } from '@repo/cms-schema/routing';
+import { ReactNode } from 'react';
+import { CmsConfig } from './cms-api.js';
+import { BlockComponentRegistry } from './types.js';
+import '@repo/cms-schema/trpc';
+import '@trpc/client';
+import '@repo/cms-schema/blocks';
+
+/**
+ * Framework-agnostic parametric route rendering for Profound CMS.
+ * Next.js and TanStack Start call `renderParametricRoute` and map `not_found`
+ * to their respective 404 mechanisms.
+ */
+
+type ParametricRouteProps = CmsConfig & {
+    params: Promise<{
+        slug: string[];
+    }>;
+    searchParams?: Promise<{
+        [key: string]: string | string[] | undefined;
+    }>;
+    registry?: Partial<BlockComponentRegistry>;
+};
+type ParametricRouteResult = {
+    status: 'ok';
+    node: ReactNode;
+} | {
+    status: 'not_found';
+} | {
+    status: 'error';
+    error: unknown;
+};
+/** @internal Exported for generateMetadata in renderer.tsx */
+declare function getWebsiteId(providedWebsiteId?: string): string;
+/**
+ * Renders CMS-backed blocks for a multi-segment path. Maps NOT_FOUND-style API
+ * outcomes to `{ status: 'not_found' }` instead of throwing.
+ */
+declare function renderParametricRoute({ params, searchParams, registry, apiKey, cmsUrl, websiteId: providedWebsiteId, }: ParametricRouteProps): Promise<ParametricRouteResult>;
+
+export { type ParametricRouteProps, type ParametricRouteResult, getWebsiteId, renderParametricRoute };