@toaq-oss/omni-mdx 0.1.0

package/LICENCE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TOAQ-oss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,221 @@
+# @toaq-oss/omni-mdx
+
+The React/Next.js visual rendering engine of the TOAQ-oss MDX ecosystem.
+
+[![GitHub](https://img.shields.io/badge/GitHub-TOAQ--oss-181717?logo=github)](https://github.com/toaq-oss)
+
+
+This package consumes the ultra-fast Abstract Syntax Tree (AST) generated by our Rust core in WebAssembly (@toaq-oss/core-parser) and transforms it into interactive, secure, and highly customizable React components.
+
+---
+
+## Why this exists
+
+Most MDX pipelines (next-mdx-remote, @next/mdx, contentlayer) run at the JS level and require client-side hydration for math, syntax highlighting, and custom components. This means:
+
+- A large JS bundle sent to every visitor
+- Math rendered on the client (flash of unstyled content)
+- Custom components that can't be pure Server Components
+
+`@toaq-oss/omni-mdx` solves this by moving the parse step into Rust and the render step into React Server Components. The result is **zero JS for content** — everything is HTML by the time it reaches the browser.
+
+The WASM build is available as a fallback for Edge runtimes or environments where native addons are not supported.
+
+---
+
+## Performance & Architecture
+
+`@toaq-oss/omni-mdx` is designed for scale. While traditional parsers block the Node.js main thread, our parser offloads the heavy lifting to a native Rust core via WebAssembly or N-API.
+
+**1. Non-Blocking by Design**
+Parsing complex documents or extracting data from thousands of files for ML datasets won't freeze your server. Node.js remains completely free to handle other HTTP requests while Rust does the work in the background.
+
+**2. Faster than the Standard**
+In a strict end-to-end benchmark (parsing raw text to an exploitable JSX AST) over 1,000 iterations of a complex document:
+- `@toaq-oss/omni-mdx` is consistently **~30% faster** than the official `@mdx-js/mdx` compiler.
+
+**3. Zero Client JS**
+Because the AST is generated on the server and maps directly to React Server Components, the client receives 0 bytes of parsing logic.
+
+## Installation
+
+```bash
+npm install @toaq-oss/omni-mdx
+# KaTeX is optional — only needed if your content has math
+npm install katex
+```
+
+Add the KaTeX stylesheet to your `layout.tsx`:
+
+```tsx
+import "katex/dist/katex.min.css";
+```
+
+---
+
+## Usage
+
+### Server Component (recommended)
+
+```tsx
+import { parseMdx, MDXServerRenderer } from "@toaq-oss/omni-mdx/server";
+import { Note, Details }               from "@/components/mdx";
+
+const COMPONENTS = { Note, Details };
+
+export default async function ArticlePage({ params }) {
+  const content = await getArticleContent(params.slug);
+  const ast     = await parseMdx(content);
+
+  return <MDXServerRenderer ast={ast} components={COMPONENTS} />;
+}
+```
+
+That's it. No `getStaticProps`, no serialisation workarounds, no client bundle for the content.
+
+### Static generation
+
+Because `parseMdx` is async and runs on the server, it works naturally with `generateStaticParams`:
+
+```tsx
+export async function generateStaticParams() {
+  const slugs = await getAllSlugs();
+  return slugs.map(slug => ({ slug }));
+}
+
+export default async function ArticlePage({ params }) {
+  const content = await getArticleContent(params.slug);
+  const ast     = await parseMdx(content);
+  return <MDXServerRenderer ast={ast} components={COMPONENTS} />;
+}
+```
+
+At `next build`, Next.js calls `parseMdx` once per article and pre-renders everything to static HTML. The Rust parser never runs in the browser.
+
+### Live editor (client-side)
+
+For live MDX previews where the content changes in the browser:
+
+```tsx
+"use client";
+import { MDXClientRenderer } from "@toaq-oss/omni-mdx/client";
+
+export function LivePreview({ ast, components }) {
+  return <MDXClientRenderer ast={ast} components={components} katex />;
+}
+```
+
+The `ast` prop should be computed server-side and passed down, or computed client-side by calling a Route Handler that runs `parseMdx`.
+
+---
+
+## Import map
+
+|Import path|What you get|Where to use|
+|----|---|----|
+|`@toaq-oss/omni-mdx`|Types + `MDX_COMPONENTS` registry|Anywhere|
+|`@toaq-oss/omni-mdx/server`|`parseMdx`, `MDXServerRenderer`, `MDXParseError` |Server Components only|
+|`@toaq-oss/omni-mdx/client`|`MDXClientRenderer`, `MDXErrorBoundary`|Client Components only|
+
+---
+
+## Custom components
+
+Register components by name — the key matches the JSX tag in the MDX source:
+
+```tsx
+// MDX source:
+// <Note type="warning" title="Heads up">
+//   Be careful with **this**.
+// </Note>
+
+import { Note }    from "@/components/Note";    // can be a Server Component
+import { Details } from "@/components/Details"; // can be a Server Component
+import { Chart }   from "@/components/Chart";   // "use client" inside
+
+const COMPONENTS = { Note, Details, Chart };
+
+const ast = await parseMdx(content);
+return <MDXServerRenderer ast={ast} components={COMPONENTS} />;
+```
+
+Server Components in the registry are rendered on the server with zero client JS. Client Components are hydrated normally.
+
+---
+
+## Error handling
+
+### Parse errors
+
+```tsx
+import { parseMdx, MDXParseError } from "@toaq-oss/omni-mdx/server";
+
+try {
+  const ast = await parseMdx(content);
+} catch (e) {
+  if (e instanceof MDXParseError) {
+    console.error("MDX syntax error:", e.message);
+    console.error("Source:", e.source);
+  }
+}
+```
+
+### Component render errors
+
+In `MDXClientRenderer`, every custom component is automatically wrapped in `MDXErrorBoundary`. If a component throws, the error is isolated — the rest of the document continues to render.
+
+You can also use `MDXErrorBoundary` directly:
+
+```tsx
+import { MDXErrorBoundary } from "@toaq-oss/omni-mdx/client";
+
+<MDXErrorBoundary componentName="Chart">
+  <Chart data={maybeNull} />
+</MDXErrorBoundary>
+```
+
+---
+
+## Math
+
+Math is handled entirely by the Rust parser — no remark-math or rehype-katex needed.
+
+| Syntax | Output |
+|---|---|
+| `$E = mc^2$`  | `<span class="math math-inline" data-math="…">` |
+| `$$…$$`       | `<div class="math math-display" data-math="…">` |
+
+KaTeX hydrates the `data-math` attributes on the client via `MDXClientRenderer`, or you can use any KaTeX auto-render script in your layout.
+
+---
+
+## Runtime support
+
+| Runtime | Native `.node` | WASM fallback |
+|-----------------|:--------------:|:-------------:|
+| Node.js 18+ | ✅ | ✅ |
+| Next.js (RSC) | ✅ | ✅ |
+| Edge runtime | ❌ | ✅ |
+| Browser | ❌ | ✅ |
+
+The package auto-detects the environment and loads the appropriate backend. No configuration required.
+
+---
+
+## Building the native addon
+
+The `.node` files are pre-built for common platforms. To build for your platform:
+
+```bash
+cd core-parser
+napi build --platform --release --features node --no-js
+cp toaq-parser-core.*.node ../packages/mdx-next/native/
+```
+
+To build the WASM fallback:
+
+```bash
+cd core-parser
+wasm-pack build --target bundler --features wasm
+mv pkg/* ../packages/mdx-next/wasm/
+```

package/dist/client.cjs

@@ -0,0 +1,274 @@
+"use strict";
+"use client";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  MDXClientRenderer: () => MDXClientRenderer,
+  MDXErrorBoundary: () => MDXErrorBoundary
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/MDXClientRenderer.tsx
+var import_react2 = __toESM(require("react"), 1);
+
+// src/MDXErrorBoundary.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var MDXErrorBoundary = class extends import_react.Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false, error: null };
+  }
+  /**
+   * Updates the state when an error occurs to trigger the fallback UI rendering.
+   */
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  /**
+   * Intercepts the error and its contextual information.
+   * This is the ideal place to hook into monitoring tools (like Sentry or Datadog) 
+   * for production environments.
+   */
+  componentDidCatch(error, errorInfo) {
+    console.error(
+      `[MDXErrorBoundary] Error caught in component <${this.props.componentName || "Unknown"}>:
+`,
+      error,
+      errorInfo.componentStack
+    );
+  }
+  render() {
+    if (this.state.hasError) {
+      return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { padding: "1rem", border: "2px solid #ef4444", backgroundColor: "#fef2f2", borderRadius: "0.5rem", margin: "1rem 0" }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("h3", { style: { color: "#b91c1c", fontWeight: "bold", margin: 0 }, children: [
+          "Render Error : ",
+          this.props.componentName || "Unknown Component"
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { style: { color: "#dc2626", fontFamily: "monospace", fontSize: "0.875rem" }, children: this.state.error?.message })
+      ] });
+    }
+    return this.props.children;
+  }
+};
+
+// src/MDXClientRenderer.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var katexLoaded = false;
+async function loadKatex() {
+  if (katexLoaded || typeof window === "undefined") return;
+  try {
+    const [{ default: katex }, autoRenderMod] = await Promise.all([
+      import("katex"),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      import("katex/contrib/auto-render")
+    ]);
+    const renderMathInElement = autoRenderMod.default ?? autoRenderMod;
+    katexLoaded = true;
+    return renderMathInElement;
+  } catch {
+    console.warn("[toaq/mdx-engine] KaTeX not available. Install: npm install katex");
+    return null;
+  }
+}
+function resolveAttr(attr, components) {
+  switch (attr.kind) {
+    case "text":
+      return attr.value;
+    case "boolean":
+      return true;
+    case "expression": {
+      const raw = attr.value.trim();
+      try {
+        return JSON.parse(raw);
+      } catch {
+      }
+      try {
+        return new Function(`return (${raw})`)();
+      } catch {
+      }
+      return raw;
+    }
+    case "ast":
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MDXClientContent, { ast: attr.value, components });
+    default:
+      return void 0;
+  }
+}
+var HTML_TAGS = /* @__PURE__ */ new Set([
+  "a",
+  "abbr",
+  "article",
+  "aside",
+  "b",
+  "blockquote",
+  "br",
+  "caption",
+  "cite",
+  "code",
+  "col",
+  "colgroup",
+  "dd",
+  "del",
+  "details",
+  "dfn",
+  "div",
+  "dl",
+  "dt",
+  "em",
+  "figcaption",
+  "figure",
+  "footer",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "header",
+  "hr",
+  "i",
+  "img",
+  "ins",
+  "kbd",
+  "li",
+  "main",
+  "mark",
+  "nav",
+  "ol",
+  "p",
+  "pre",
+  "q",
+  "s",
+  "section",
+  "small",
+  "span",
+  "strong",
+  "sub",
+  "summary",
+  "sup",
+  "table",
+  "tbody",
+  "td",
+  "tfoot",
+  "th",
+  "thead",
+  "tr",
+  "u",
+  "ul",
+  "var"
+]);
+function renderNode(node, index, components) {
+  const key = `${node.node_type}-${index}`;
+  if (node.node_type === "text") return node.content ?? null;
+  if (node.node_type === "fragment") {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react2.default.Fragment, { children: node.children?.map((c, i) => renderNode(c, i, components)) }, key);
+  }
+  if (node.node_type === "InlineMath") {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "span",
+      {
+        className: "math math-inline",
+        "data-math": node.content ?? "",
+        suppressHydrationWarning: true
+      },
+      key
+    );
+  }
+  if (node.node_type === "BlockMath") {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "div",
+      {
+        className: "math math-display",
+        "data-math": node.content ?? "",
+        suppressHydrationWarning: true
+      },
+      key
+    );
+  }
+  const resolvedProps = {};
+  if (node.attributes) {
+    for (const [k, v] of Object.entries(node.attributes)) {
+      resolvedProps[k] = resolveAttr(v, components);
+    }
+  }
+  const renderedChildren = node.children?.length ? node.children.map((c, i) => renderNode(c, i, components)) : node.content ?? void 0;
+  const Custom = components[node.node_type];
+  if (Custom) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MDXErrorBoundary, { componentName: node.node_type, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Custom, { ...resolvedProps, children: renderedChildren }) }, key);
+  }
+  if (HTML_TAGS.has(node.node_type)) {
+    const Tag = node.node_type;
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Tag, { ...resolvedProps, children: renderedChildren }, key);
+  }
+  if (true) {
+    console.warn(`[toaq/mdx-engine] Unknown component: <${node.node_type}>`);
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { "data-missing-component": node.node_type, className: "mdx-missing-component", children: renderedChildren }, key);
+}
+function MDXClientContent({
+  ast,
+  components
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_jsx_runtime2.Fragment, { children: ast.map((node, i) => renderNode(node, i, components)) });
+}
+function MDXClientRenderer({
+  ast,
+  components = {},
+  katex = true
+}) {
+  const rootRef = (0, import_react2.useRef)(null);
+  (0, import_react2.useEffect)(() => {
+    if (!katex || !rootRef.current) return;
+    loadKatex().then((renderMath) => {
+      if (!renderMath || !rootRef.current) return;
+      renderMath(rootRef.current, {
+        delimiters: [
+          { left: "$$", right: "$$", display: true },
+          { left: "$", right: "$", display: false }
+        ]
+      });
+      rootRef.current.querySelectorAll("[data-math]").forEach((el) => {
+        const math = el.getAttribute("data-math") ?? "";
+        const display = el.classList.contains("math-display");
+        try {
+          import("katex").then(({ default: k }) => {
+            el.innerHTML = k.renderToString(math, { displayMode: display, throwOnError: false });
+          });
+        } catch {
+        }
+      });
+    });
+  }, [ast, katex]);
+  if (!ast || !Array.isArray(ast)) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { ref: rootRef, className: "omni-mdx-root", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(MDXClientContent, { ast, components }) });
+}
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/MDXClientRenderer.tsx","../src/MDXErrorBoundary.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * @toaq/mdx-engine/client\n *\n * Client-only entry point.\n * Use for live MDX editors, previews, or any fully client-side rendering.\n */\n\nexport { MDXClientRenderer } from \"./MDXClientRenderer\";\nexport { MDXErrorBoundary } from \"./MDXErrorBoundary\";\nexport type { AstNode, MDXComponents } from \"./MDXServerRenderer\";","\"use client\";\n\n/**\n * MDXClientRenderer.tsx\n *\n * Client Component — handles KaTeX hydration and interactive components.\n *\n * You generally do NOT use this directly.\n * Use <MDXServerRenderer> in Server Components and only register Client\n * Components (wrapped in \"use client\") for interactive parts (charts, tabs, etc.).\n *\n * Use this component ONLY when:\n *   1. You are in a page/layout that is entirely client-side (no RSC)\n *   2. You need live re-rendering (e.g. a live MDX editor/preview)\n *\n * For the live editor use case, import from '@toaq/mdx-engine/client'.\n */\n\nimport React, { ReactNode, createContext, useContext, useEffect, useRef } from \"react\";\nimport { MDXErrorBoundary } from \"./MDXErrorBoundary\";\nimport type { AstNode, MDXComponents } from \"./MDXServerRenderer\";\n\n// KaTeX loader (client-only, dynamic import)\n\nlet katexLoaded = false;\n\nasync function loadKatex() {\n  if (katexLoaded || typeof window === \"undefined\") return;\n  try {\n    // Dynamically import KaTeX auto-render (avoids SSR issues)\n    const [{ default: katex }, autoRenderMod] = await Promise.all([\n      import(\"katex\"),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      import(\"katex/contrib/auto-render\") as any,\n    ]);\n    const renderMathInElement = autoRenderMod.default ?? autoRenderMod;\n    katexLoaded = true;\n    return renderMathInElement;\n  } catch {\n    console.warn(\"[toaq/mdx-engine] KaTeX not available. Install: npm install katex\");\n    return null;\n  }\n}\n\n// Attr resolver (client version handles expressions fully)\n\ntype AttrValueKind =\n  | { kind: \"text\";       value: string }\n  | { kind: \"expression\"; value: string }\n  | { kind: \"boolean\" }\n  | { kind: \"ast\";        value: AstNode[] };\n\nfunction resolveAttr(\n  attr: AttrValueKind,\n  components: MDXComponents,\n): React.ReactNode | string | boolean {\n  switch (attr.kind) {\n    case \"text\":    return attr.value;\n    case \"boolean\": return true;\n    case \"expression\": {\n      const raw = attr.value.trim();\n      try { return JSON.parse(raw); } catch {}\n      try { return new Function(`return (${raw})`)(); } catch {}\n      return raw;\n    }\n    case \"ast\":\n      return <MDXClientContent ast={attr.value} components={components} />;\n    default:\n      return undefined;\n  }\n}\n\nconst HTML_TAGS = new Set([\n  \"a\",\"abbr\",\"article\",\"aside\",\"b\",\"blockquote\",\"br\",\"caption\",\"cite\",\"code\",\n  \"col\",\"colgroup\",\"dd\",\"del\",\"details\",\"dfn\",\"div\",\"dl\",\"dt\",\"em\",\"figcaption\",\n  \"figure\",\"footer\",\"h1\",\"h2\",\"h3\",\"h4\",\"h5\",\"h6\",\"header\",\"hr\",\"i\",\"img\",\"ins\",\n  \"kbd\",\"li\",\"main\",\"mark\",\"nav\",\"ol\",\"p\",\"pre\",\"q\",\"s\",\"section\",\"small\",\"span\",\n  \"strong\",\"sub\",\"summary\",\"sup\",\"table\",\"tbody\",\"td\",\"tfoot\",\"th\",\"thead\",\"tr\",\n  \"u\",\"ul\",\"var\",\n]);\n\nfunction renderNode(\n  node: AstNode,\n  index: number,\n  components: MDXComponents,\n): ReactNode {\n  const key = `${node.node_type}-${index}`;\n\n  if (node.node_type === \"text\") return node.content ?? null;\n\n  if (node.node_type === \"fragment\") {\n    return (\n      <React.Fragment key={key}>\n        {node.children?.map((c, i) => renderNode(c, i, components))}\n      </React.Fragment>\n    );\n  }\n\n  // Math — rendered as semantic spans; KaTeX hydrates them via useEffect\n  if (node.node_type === \"InlineMath\") {\n    return (\n      <span\n        key={key}\n        className=\"math math-inline\"\n        data-math={node.content ?? \"\"}\n        suppressHydrationWarning\n      />\n    );\n  }\n  if (node.node_type === \"BlockMath\") {\n    return (\n      <div\n        key={key}\n        className=\"math math-display\"\n        data-math={node.content ?? \"\"}\n        suppressHydrationWarning\n      />\n    );\n  }\n\n  const resolvedProps: Record<string, any> = {};\n  if (node.attributes) {\n    for (const [k, v] of Object.entries(node.attributes)) {\n      resolvedProps[k] = resolveAttr(v as AttrValueKind, components);\n    }\n  }\n\n  const renderedChildren = node.children?.length\n    ? node.children.map((c, i) => renderNode(c, i, components))\n    : (node.content ?? undefined);\n\n  const Custom = components[node.node_type];\n  if (Custom) {\n    return (\n      <MDXErrorBoundary key={key} componentName={node.node_type}>\n        <Custom {...resolvedProps}>\n          {renderedChildren}\n        </Custom>\n      </MDXErrorBoundary>\n    );\n  }\n\n  if (HTML_TAGS.has(node.node_type)) {\n    const Tag = node.node_type as any;\n    return <Tag key={key} {...resolvedProps}>{renderedChildren}</Tag>;\n  }\n\n  if (process.env.NODE_ENV === \"development\") {\n    console.warn(`[toaq/mdx-engine] Unknown component: <${node.node_type}>`);\n  }\n  return (\n    <div key={key} data-missing-component={node.node_type} className=\"mdx-missing-component\">\n      {renderedChildren}\n    </div>\n  );\n}\n\nfunction MDXClientContent({\n  ast,\n  components,\n}: {\n  ast: AstNode[];\n  components: MDXComponents;\n}) {\n  return <>{ast.map((node, i) => renderNode(node, i, components))}</>;\n}\n\ninterface MDXClientRendererProps {\n  /** AST from parseMdx() — must be JSON-serialisable (pass via Server Component). */\n  ast: AstNode[];\n  /** Component registry — same shape as MDX_COMPONENTS. */\n  components?: MDXComponents;\n  /** If true, activates KaTeX auto-render after mount. Default: true. */\n  katex?: boolean;\n}\n\nexport function MDXClientRenderer({\n  ast,\n  components = {},\n  katex = true,\n}: MDXClientRendererProps) {\n  const rootRef = useRef<HTMLDivElement>(null);\n\n  // Hydrate math after mount\n  useEffect(() => {\n    if (!katex || !rootRef.current) return;\n    loadKatex().then((renderMath) => {\n      if (!renderMath || !rootRef.current) return;\n      renderMath(rootRef.current, {\n        delimiters: [\n          { left: \"$$\", right: \"$$\", display: true },\n          { left: \"$\",  right: \"$\",  display: false },\n        ],\n      });\n      // Also handle data-math attributes directly\n      rootRef.current.querySelectorAll<HTMLElement>(\"[data-math]\").forEach((el) => {\n        const math = el.getAttribute(\"data-math\") ?? \"\";\n        const display = el.classList.contains(\"math-display\");\n        try {\n          import(\"katex\").then(({ default: k }) => {\n            el.innerHTML = k.renderToString(math, { displayMode: display, throwOnError: false });\n          });\n        } catch {}\n      });\n    });\n  }, [ast, katex]);\n\n  if (!ast || !Array.isArray(ast)) return null;\n\n  return (\n    <div ref={rootRef} className=\"omni-mdx-root\">\n      <MDXClientContent ast={ast} components={components} />\n    </div>\n  );\n}","\"use client\";\nimport { Component, ErrorInfo, ReactNode } from 'react';\n\ninterface Props {\n  children: ReactNode;\n  /** The name of the MDX component being rendered (e.g., 'Chart', 'SplitLayout') */\n  componentName?: string;\n}\n\ninterface State {\n  hasError: boolean;\n  error: Error | null;\n}\n\n/**\n * A dedicated Error Boundary for MDX rendering.\n *\n * If a React component injected via MDX crashes (e.g., due to a data parsing error \n * inside a <Chart />), this boundary intercepts the error. This prevents the \n * entire React tree from unmounting and displays a clean fallback UI to \n * isolate the defective component.\n */\nexport class MDXErrorBoundary extends Component<Props, State> {\n  constructor(props: Props) {\n    super(props);\n    this.state = { hasError: false, error: null };\n  }\n\n  /**\n   * Updates the state when an error occurs to trigger the fallback UI rendering.\n   */\n  static getDerivedStateFromError(error: Error): State {\n    return { hasError: true, error };\n  }\n\n  /**\n   * Intercepts the error and its contextual information.\n   * This is the ideal place to hook into monitoring tools (like Sentry or Datadog) \n   * for production environments.\n   */\n  componentDidCatch(error: Error, errorInfo: ErrorInfo) {\n    console.error(\n      `[MDXErrorBoundary] Error caught in component <${this.props.componentName || 'Unknown'}>:\\n`,\n      error,\n      errorInfo.componentStack\n    );\n  }\n  \n  render() {\n    if (this.state.hasError) {\n      // Fallback UI: A clean, isolated container that doesn't break the main layout\n      return (\n        <div style={{ padding: '1rem', border: '2px solid #ef4444', backgroundColor: '#fef2f2', borderRadius: '0.5rem', margin: '1rem 0' }}>\n          <h3 style={{ color: '#b91c1c', fontWeight: 'bold', margin: 0 }}>\n            Render Error : {this.props.componentName || 'Unknown Component'}\n          </h3>\n          <p style={{ color: '#dc2626', fontFamily: 'monospace', fontSize: '0.875rem' }}>\n            {this.state.error?.message}\n          </p>\n        </div>\n      );\n    }\n    return this.props.children;\n  }\n}"],"mappings":"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","names":["import_react","import_jsx_runtime","React"]}