@stream-mdx/react 0.1.1 → 0.3.0

package/dist/components/index.cjs

@@ -92,6 +92,8 @@ var init_mdx_client = __esm({
       constructor(compileEndpoint = "/api/mdx-compile-v2") {
         this.cache = /* @__PURE__ */ new Map();
         this.inlineModules = /* @__PURE__ */ new Map();
+        this.compiledCache = /* @__PURE__ */ new Map();
+        this.compiledInflight = /* @__PURE__ */ new Map();
         this.compileEndpoint = compileEndpoint;
       }
       /**
@@ -116,34 +118,53 @@ var init_mdx_client = __esm({
           throw error;
         }
       }
-      /**
-       * Get compiled MDX by reference
-       */
-      async getCompiled(ref) {
+      async getCompiledInternal(ref) {
         const inline = this.inlineModules.get(ref.id);
         if (inline) {
-          return {
-            ...inline,
-            dependencies: Array.isArray(inline.dependencies) ? [...inline.dependencies] : []
-          };
+          return this.cloneCompiled(inline);
         }
-        const response = await fetch(`${this.compileEndpoint}?id=${ref.id}`);
-        if (!response.ok) {
-          throw new Error(`Failed to get compiled MDX: ${response.statusText}`);
+        const cached = this.compiledCache.get(ref.id);
+        if (cached) {
+          return this.cloneCompiled(cached);
         }
-        const data = await response.json();
-        return {
-          id: data.id,
-          code: data.code,
-          dependencies: data.dependencies || [],
-          timestamp: data.timestamp
-        };
+        const inflight = this.compiledInflight.get(ref.id);
+        if (inflight) {
+          const resolved = await inflight;
+          return this.cloneCompiled(resolved);
+        }
+        const fetchPromise = this.fetchCompiled(ref);
+        this.compiledInflight.set(ref.id, fetchPromise);
+        try {
+          const data = await fetchPromise;
+          this.compiledCache.set(ref.id, data);
+          return this.cloneCompiled(data);
+        } finally {
+          this.compiledInflight.delete(ref.id);
+        }
+      }
+      async getCompiled(ref, options) {
+        if (options?.signal) {
+          const inline = this.inlineModules.get(ref.id);
+          if (inline) {
+            return this.cloneCompiled(inline);
+          }
+          const cached = this.compiledCache.get(ref.id);
+          if (cached) {
+            return this.cloneCompiled(cached);
+          }
+          const data = await this.fetchCompiled(ref, options);
+          this.compiledCache.set(ref.id, data);
+          return this.cloneCompiled(data);
+        }
+        return this.getCompiledInternal(ref);
       }
       /**
        * Clear compilation cache
        */
       clearCache() {
         this.cache.clear();
+        this.compiledCache.clear();
+        this.compiledInflight.clear();
       }
       registerInlineModule(compiled) {
         this.inlineModules.set(compiled.id, {
@@ -180,6 +201,27 @@ var init_mdx_client = __esm({
           cached: data.cached || false
         };
       }
+      async fetchCompiled(ref, options) {
+        const response = await fetch(`${this.compileEndpoint}?id=${ref.id}`, {
+          signal: options?.signal
+        });
+        if (!response.ok) {
+          throw new Error(`Failed to get compiled MDX: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return {
+          id: data.id,
+          code: data.code,
+          dependencies: data.dependencies || [],
+          timestamp: data.timestamp
+        };
+      }
+      cloneCompiled(compiled) {
+        return {
+          ...compiled,
+          dependencies: Array.isArray(compiled.dependencies) ? [...compiled.dependencies] : []
+        };
+      }
     };
     MDXComponentFactory = class {
       constructor(mdxClient) {
@@ -368,6 +410,7 @@ var init_mdx_client = __esm({
 var components_exports = {};
 __export(components_exports, {
   ComponentRegistry: () => ComponentRegistry,
+  DefaultLinkSafetyModal: () => DefaultLinkSafetyModal,
   defaultBlockComponents: () => defaultBlockComponents,
   defaultInlineComponents: () => defaultInlineComponents,
   mapHtmlToReact: () => mapHtmlToReact,
@@ -376,11 +419,118 @@ __export(components_exports, {
 });
 module.exports = __toCommonJS(components_exports);
 var import_core = require("@stream-mdx/core");
+
+// src/mdx-hydration-metrics.ts
+var entries = /* @__PURE__ */ new Map();
+var lastHydrationMs = null;
+function now() {
+  if (typeof performance !== "undefined" && typeof performance.now === "function") {
+    return performance.now();
+  }
+  return Date.now();
+}
+function markMdxHydrationStart(id) {
+  if (!id) return;
+  const entry = entries.get(id) ?? { status: "compiled" };
+  if (entry.startedAt === void 0) {
+    entry.startedAt = now();
+  }
+  entry.status = "compiled";
+  entries.set(id, entry);
+}
+function markMdxHydrated(id) {
+  if (!id) return;
+  const entry = entries.get(id) ?? { status: "hydrated" };
+  if (entry.startedAt === void 0) {
+    entry.startedAt = now();
+  }
+  entry.hydratedAt = now();
+  entry.status = "hydrated";
+  entries.set(id, entry);
+  lastHydrationMs = entry.startedAt ? entry.hydratedAt - entry.startedAt : null;
+}
+function markMdxHydrationError(id) {
+  if (!id) return;
+  const entry = entries.get(id) ?? { status: "error" };
+  entry.status = "error";
+  entries.set(id, entry);
+}
+
+// src/mdx-hydration-context.ts
+var import_react = __toESM(require("react"), 1);
+var MdxHydrationContext = import_react.default.createContext({ controller: null });
+
+// src/mdx-runtime.ts
+var mdxRuntimePromise = null;
+function loadMdxRuntime() {
+  if (!mdxRuntimePromise) {
+    mdxRuntimePromise = Promise.resolve().then(() => (init_mdx_client(), mdx_client_exports));
+  }
+  return mdxRuntimePromise;
+}
+
+// src/renderer/use-deferred-render.ts
+var import_react3 = require("react");
+function useDeferredRender(ref, options) {
+  const enabled = options?.enabled ?? true;
+  const [shouldRender, setShouldRender] = (0, import_react3.useState)(!enabled);
+  (0, import_react3.useEffect)(() => {
+    if (!enabled) {
+      setShouldRender(true);
+      return;
+    }
+    const target = ref.current;
+    if (!target) {
+      return;
+    }
+    let cancelled = false;
+    let idleId = null;
+    let timerId = null;
+    const scheduleRender = () => {
+      if (cancelled) return;
+      setShouldRender(true);
+    };
+    const runWithIdle = () => {
+      if (typeof globalThis.requestIdleCallback === "function") {
+        idleId = globalThis.requestIdleCallback(scheduleRender, { timeout: options?.idleTimeoutMs ?? 200 });
+      } else {
+        timerId = window.setTimeout(scheduleRender, options?.idleTimeoutMs ?? 200);
+      }
+    };
+    const observer = new IntersectionObserver(
+      (entries2) => {
+        for (const entry of entries2) {
+          if (entry.isIntersecting || entry.intersectionRatio > 0) {
+            observer.disconnect();
+            const debounceMs = options?.debounceMs ?? 80;
+            timerId = window.setTimeout(runWithIdle, debounceMs);
+            return;
+          }
+        }
+      },
+      { rootMargin: options?.rootMargin ?? "200px 0px" }
+    );
+    observer.observe(target);
+    return () => {
+      cancelled = true;
+      observer.disconnect();
+      if (idleId !== null && typeof globalThis.cancelIdleCallback === "function") {
+        globalThis.cancelIdleCallback(idleId);
+      }
+      if (timerId !== null) {
+        window.clearTimeout(timerId);
+      }
+    };
+  }, [enabled, options?.debounceMs, options?.idleTimeoutMs, options?.rootMargin, ref]);
+  return shouldRender;
+}
+
+// src/components/index.ts
 var import_core2 = require("@stream-mdx/core");
-var import_react3 = __toESM(require("react"), 1);
+var import_react5 = __toESM(require("react"), 1);
 
 // src/utils/inline-html.ts
-var import_react = __toESM(require("react"), 1);
+var import_react4 = __toESM(require("react"), 1);
 var BACKTICK_CONTENT = /^`([\s\S]+)`$/;
 var DEFAULT_INLINE_HTML_RENDERERS = {
   kbd: (descriptor, ctx) => {
@@ -392,7 +542,7 @@ var DEFAULT_INLINE_HTML_RENDERERS = {
       if (ctx.key !== void 0 && ctx.key !== null) {
         props.key = ctx.key;
       }
-      return import_react.default.createElement("kbd", props, import_react.default.createElement("code", { className: "inline-code" }, codeText));
+      return import_react4.default.createElement("kbd", props, import_react4.default.createElement("code", { className: "inline-code" }, codeText));
     }
     return ctx.defaultRender();
   }
@@ -410,9 +560,9 @@ function renderInlineHtmlSegment(raw, sanitized, options = {}) {
         return null;
       }
       if (options.key !== void 0 && options.key !== null) {
-        return import_react.default.createElement(import_react.default.Fragment, { key: options.key }, descriptor.text);
+        return import_react4.default.createElement(import_react4.default.Fragment, { key: options.key }, descriptor.text);
       }
-      return import_react.default.createElement(import_react.default.Fragment, {}, descriptor.text);
+      return import_react4.default.createElement(import_react4.default.Fragment, {}, descriptor.text);
     }
     if (isInlineTag) {
       const parsedElement = renderSanitizedHtmlTree(descriptor.sanitized, options.key);
@@ -427,15 +577,15 @@ function renderInlineHtmlSegment(raw, sanitized, options = {}) {
     if (options.key !== void 0 && options.key !== null) {
       props.key = options.key;
     }
-    return import_react.default.createElement("span", props);
+    return import_react4.default.createElement("span", props);
   };
   const allRenderers = options.renderers ? { ...DEFAULT_INLINE_HTML_RENDERERS, ...options.renderers } : DEFAULT_INLINE_HTML_RENDERERS;
   const renderer = allRenderers[descriptor.tagName];
   if (renderer) {
     const rendered = renderer(descriptor, { key: options.key, defaultRender });
     if (rendered) {
-      if (options.key !== void 0 && options.key !== null && import_react.default.isValidElement(rendered) && rendered.key === null) {
-        return import_react.default.cloneElement(rendered, { key: options.key });
+      if (options.key !== void 0 && options.key !== null && import_react4.default.isValidElement(rendered) && rendered.key === null) {
+        return import_react4.default.cloneElement(rendered, { key: options.key });
       }
       return rendered;
     }
@@ -547,21 +697,21 @@ function renderSanitizedHtmlTree(html, key) {
     }
     if (children.length === 1) {
       const [child] = children;
-      if (import_react.default.isValidElement(child)) {
+      if (import_react4.default.isValidElement(child)) {
         if (key !== void 0 && key !== null) {
-          return import_react.default.cloneElement(child, { key });
+          return import_react4.default.cloneElement(child, { key });
         }
         return child;
       }
       if (typeof child === "string" || typeof child === "number") {
         if (key !== void 0 && key !== null) {
-          return import_react.default.createElement(import_react.default.Fragment, { key }, child);
+          return import_react4.default.createElement(import_react4.default.Fragment, { key }, child);
         }
-        return import_react.default.createElement(import_react.default.Fragment, {}, child);
+        return import_react4.default.createElement(import_react4.default.Fragment, {}, child);
       }
-      return import_react.default.createElement(import_react.default.Fragment, { key }, child);
+      return import_react4.default.createElement(import_react4.default.Fragment, { key }, child);
     }
-    return import_react.default.createElement(import_react.default.Fragment, { key }, ...children);
+    return import_react4.default.createElement(import_react4.default.Fragment, { key }, ...children);
   } catch {
     return null;
   }
@@ -586,9 +736,9 @@ function convertDomNode(node, key) {
     }
   });
   if (children.length === 0) {
-    return import_react.default.createElement(tagName, props);
+    return import_react4.default.createElement(tagName, props);
   }
-  return import_react.default.createElement(tagName, props, ...children);
+  return import_react4.default.createElement(tagName, props, ...children);
 }
 function getElementAttributes(element) {
   const attrs = {};
@@ -648,7 +798,97 @@ var INLINE_ELEMENTS = /* @__PURE__ */ new Set([
   "mtd"
 ]);
 
+// src/components/link-safety-modal.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var DefaultLinkSafetyModal = ({ url, isOpen, isChecking, onClose, onConfirm, onCopy }) => {
+  if (!isOpen) {
+    return null;
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+    "div",
+    {
+      className: "stream-mdx-link-modal-backdrop",
+      role: "dialog",
+      "aria-modal": "true",
+      "aria-label": "Link safety confirmation",
+      style: {
+        position: "fixed",
+        inset: 0,
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        background: "rgba(0, 0, 0, 0.4)",
+        zIndex: 9999,
+        padding: "24px"
+      },
+      onClick: onClose,
+      children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+        "div",
+        {
+          className: "stream-mdx-link-modal",
+          style: {
+            width: "min(520px, 100%)",
+            borderRadius: 12,
+            background: "var(--background, #fff)",
+            color: "var(--foreground, #111)",
+            border: "1px solid var(--border, rgba(0, 0, 0, 0.1))",
+            boxShadow: "0 20px 60px rgba(0, 0, 0, 0.25)",
+            padding: 20
+          },
+          onClick: (event) => event.stopPropagation(),
+          children: [
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { fontWeight: 600, marginBottom: 8 }, children: "Open external link?" }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { fontSize: 13, opacity: 0.8, wordBreak: "break-all", marginBottom: 16 }, children: url }),
+            /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", gap: 8, justifyContent: "flex-end" }, children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: onCopy, disabled: isChecking, style: buttonStyle, children: "Copy link" }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: onConfirm, disabled: isChecking, style: primaryButtonStyle, children: "Open link" }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: onClose, style: buttonStyle, children: "Cancel" })
+            ] })
+          ]
+        }
+      )
+    }
+  );
+};
+var buttonStyle = {
+  borderRadius: 8,
+  border: "1px solid var(--border, rgba(0, 0, 0, 0.1))",
+  padding: "6px 12px",
+  background: "var(--background, #fff)",
+  color: "inherit",
+  fontSize: 13
+};
+var primaryButtonStyle = {
+  ...buttonStyle,
+  background: "var(--foreground, #111)",
+  color: "var(--background, #fff)",
+  borderColor: "var(--foreground, #111)"
+};
+
 // src/components/index.ts
+var MdxRuntimeBoundary = class extends import_react5.default.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError() {
+    return { hasError: true };
+  }
+  componentDidCatch(error) {
+    this.props.onError(error);
+  }
+  componentDidUpdate(prevProps) {
+    if (prevProps.resetKey !== this.props.resetKey && this.state.hasError) {
+      this.setState({ hasError: false });
+    }
+  }
+  render() {
+    if (this.state.hasError) {
+      return null;
+    }
+    return this.props.children;
+  }
+};
 function renderInlineNodes(nodes, components) {
   return nodes.map((node, index) => {
     const key = `${node.kind}-${index}`;
@@ -656,31 +896,31 @@ function renderInlineNodes(nodes, components) {
       case "text": {
         const textComponent = components.text;
         if (textComponent && textComponent !== defaultInlineComponents.text) {
-          return import_react3.default.createElement(textComponent, { key, text: node.text });
+          return import_react5.default.createElement(textComponent, { key, text: node.text });
         }
-        return import_react3.default.createElement(import_react3.default.Fragment, { key, children: node.text });
+        return import_react5.default.createElement(import_react5.default.Fragment, { key, children: node.text });
       }
       case "strong":
-        return import_react3.default.createElement(components.strong, {
+        return import_react5.default.createElement(components.strong, {
           key,
           children: renderInlineNodes(node.children, components)
         });
       case "em":
-        return import_react3.default.createElement(components.em, {
+        return import_react5.default.createElement(components.em, {
           key,
           children: renderInlineNodes(node.children, components)
         });
       case "strike": {
-        const StrikeComponent = components.strike ?? ((props) => import_react3.default.createElement("del", {}, props.children));
-        return import_react3.default.createElement(StrikeComponent, {
+        const StrikeComponent = components.strike ?? ((props) => import_react5.default.createElement("del", {}, props.children));
+        return import_react5.default.createElement(StrikeComponent, {
           key,
           children: renderInlineNodes(node.children, components)
         });
       }
       case "code":
-        return import_react3.default.createElement(components.code, { key, text: node.text });
+        return import_react5.default.createElement(components.code, { key, text: node.text });
       case "link":
-        return import_react3.default.createElement(
+        return import_react5.default.createElement(
           components.link,
           {
             key,
@@ -690,18 +930,18 @@ function renderInlineNodes(nodes, components) {
           }
         );
       case "image":
-        return import_react3.default.createElement(components.image, {
+        return import_react5.default.createElement(components.image, {
           key,
           src: node.src,
           alt: node.alt,
           title: node.title
         });
       case "br":
-        return import_react3.default.createElement(import_react3.default.Fragment, { key }, import_react3.default.createElement(components.br, {}));
+        return import_react5.default.createElement(import_react5.default.Fragment, { key }, import_react5.default.createElement(components.br, {}));
       default: {
         const component = components[node.kind];
         if (component) {
-          return import_react3.default.createElement(component, { key, ...node });
+          return import_react5.default.createElement(component, { key, ...node });
         }
         return null;
       }
@@ -709,18 +949,18 @@ function renderInlineNodes(nodes, components) {
   });
 }
 var defaultInlineComponents = {
-  text: ({ text }) => import_react3.default.createElement(import_react3.default.Fragment, {}, text),
-  strong: ({ children }) => import_react3.default.createElement("strong", {}, children),
-  em: ({ children }) => import_react3.default.createElement("em", {}, children),
-  strike: ({ children }) => import_react3.default.createElement("del", {}, children),
-  code: ({ text }) => import_react3.default.createElement(
+  text: ({ text }) => import_react5.default.createElement(import_react5.default.Fragment, {}, text),
+  strong: ({ children }) => import_react5.default.createElement("strong", {}, children),
+  em: ({ children }) => import_react5.default.createElement("em", {}, children),
+  strike: ({ children }) => import_react5.default.createElement("del", {}, children),
+  code: ({ text }) => import_react5.default.createElement(
     "code",
     {
       className: "inline-code"
     },
     text
   ),
-  link: ({ href, title, children }) => import_react3.default.createElement(
+  link: ({ href, title, children }) => import_react5.default.createElement(
     "a",
     {
       href,
@@ -731,15 +971,15 @@ var defaultInlineComponents = {
     },
     children
   ),
-  image: ({ src, alt, title }) => import_react3.default.createElement("img", {
+  image: ({ src, alt, title }) => import_react5.default.createElement("img", {
     src,
     alt,
     title,
     className: "markdown-image"
   }),
-  br: () => import_react3.default.createElement("br"),
+  br: () => import_react5.default.createElement("br"),
   // Custom extensible components
-  mention: ({ handle }) => import_react3.default.createElement(
+  mention: ({ handle }) => import_react5.default.createElement(
     "span",
     {
       className: "mention",
@@ -747,7 +987,7 @@ var defaultInlineComponents = {
     },
     `@${handle}`
   ),
-  citation: ({ id }) => import_react3.default.createElement(
+  citation: ({ id }) => import_react5.default.createElement(
     "span",
     {
       className: "citation",
@@ -755,7 +995,7 @@ var defaultInlineComponents = {
     },
     `[${id}]`
   ),
-  "math-inline": ({ tex }) => import_react3.default.createElement(
+  "math-inline": ({ tex }) => import_react5.default.createElement(
     "span",
     {
       className: "math-inline",
@@ -763,27 +1003,27 @@ var defaultInlineComponents = {
     },
     `$${tex}$`
   ),
-  "math-display": ({ tex }) => import_react3.default.createElement(
+  "math-display": ({ tex }) => import_react5.default.createElement(
     "div",
     {
       className: "math-display markdown-math-display",
       "data-tex": tex,
       style: { overflowX: "auto" }
     },
-    import_react3.default.createElement("span", { className: "math-display-content" }, `$$${tex}$$`)
+    import_react5.default.createElement("span", { className: "math-display-content" }, `$$${tex}$$`)
   ),
   // Footnote inline reference (superscript anchor)
   "footnote-ref": ({ label, number }) => {
     const n = number ?? "?";
     const href = number ? `#fn:${n}` : void 0;
     const id = number ? `fnref:${n}` : void 0;
-    return import_react3.default.createElement("sup", { className: "footnote-ref" }, import_react3.default.createElement("a", { href, id, "data-label": label }, String(n)));
+    return import_react5.default.createElement("sup", { className: "footnote-ref" }, import_react5.default.createElement("a", { href, id, "data-label": label }, String(n)));
   }
 };
 var defaultBlockComponents = {
   paragraph: ({ inlines, raw, meta, children }) => {
     if (children !== void 0) {
-      return import_react3.default.createElement(
+      return import_react5.default.createElement(
         "p",
         {
           className: "markdown-paragraph"
@@ -797,7 +1037,7 @@ var defaultBlockComponents = {
       if (structured.length === 1) {
         return structured[0];
       }
-      return import_react3.default.createElement(import_react3.default.Fragment, {}, ...structured);
+      return import_react5.default.createElement(import_react5.default.Fragment, {}, ...structured);
     }
     const filteredInlines = inlines && raw && inlines.length > 0 ? inlines.filter((node) => !(node.kind === "text" && node.text === raw)) : inlines ?? [];
     const effectiveInlines = filteredInlines.length > 0 ? filteredInlines : raw ? [
@@ -806,7 +1046,7 @@ var defaultBlockComponents = {
         text: raw
       }
     ] : [];
-    return import_react3.default.createElement(
+    return import_react5.default.createElement(
       "p",
       {
         className: "markdown-paragraph"
@@ -818,7 +1058,7 @@ var defaultBlockComponents = {
     const tag = `h${level}`;
     const onlyPlainText = Array.isArray(inlines) && inlines.length > 0 && inlines.every((node) => node.kind === "text");
     const children = onlyPlainText ? inlines.map((node) => node.kind === "text" ? node.text : "").join("") : renderInlineNodes(inlines, defaultInlineComponents);
-    return import_react3.default.createElement(
+    return import_react5.default.createElement(
       tag,
       {
         className: `markdown-heading markdown-h${level}`,
@@ -830,7 +1070,7 @@ var defaultBlockComponents = {
   code: ({ html, meta, lines, lang, preAttrs, codeAttrs }) => {
     const language = typeof lang === "string" ? lang : typeof meta?.lang === "string" ? String(meta.lang) : "text";
     if (html) {
-      return import_react3.default.createElement("div", {
+      return import_react5.default.createElement("div", {
         className: `markdown-code-block language-${language || "text"}`,
         /* biome-ignore lint/security/noDangerouslySetInnerHtml: highlighted HTML is generated by our sanitizer */
         dangerouslySetInnerHTML: { __html: html }
@@ -840,20 +1080,20 @@ var defaultBlockComponents = {
     if (lines && lines.length > 0) {
       const preAttributes = attrsToProps(preAttrs);
       const codeAttributes = attrsToProps(codeAttrs);
-      return import_react3.default.createElement(
+      return import_react5.default.createElement(
         "pre",
         {
           ...preAttributes,
           className: preAttributes.className ? `${preAttributes.className} markdown-code-block language-${language || "text"}` : `markdown-code-block language-${language || "text"}`
         },
-        import_react3.default.createElement(
+        import_react5.default.createElement(
           "code",
           {
             ...codeAttributes,
             className: codeAttributes.className ? `${codeAttributes.className} language-${language || "text"}` : `language-${language || "text"}`
           },
           lines.map(
-            (line) => import_react3.default.createElement("span", {
+            (line) => import_react5.default.createElement("span", {
               key: line.id,
               className: "line",
               /* biome-ignore lint/security/noDangerouslySetInnerHtml: line HTML is sanitized server-side */
@@ -863,34 +1103,44 @@ var defaultBlockComponents = {
         )
       );
     }
-    return import_react3.default.createElement("pre", {
+    return import_react5.default.createElement("pre", {
       className: `markdown-code-block language-${language || "text"}`,
       children: code
     });
   },
-  blockquote: ({ inlines, renderedContent }) => import_react3.default.createElement(
+  blockquote: ({ inlines, renderedContent }) => import_react5.default.createElement(
     "blockquote",
     {
       className: "markdown-blockquote"
     },
     renderedContent ?? renderInlineNodes(inlines, defaultInlineComponents)
   ),
+  hr: (props) => import_react5.default.createElement("hr", props),
   list: ({ ordered, items }) => {
+    if (items.length === 0) {
+      return null;
+    }
     const tag = ordered ? "ol" : "ul";
+    const listStyle = ordered ? {
+      ["--list-indent"]: `calc(2.5rem + ${String(items.length).length}ch)`
+    } : void 0;
     const listItems = items.map(
-      (item, index) => import_react3.default.createElement(
+      (item, index) => import_react5.default.createElement(
         "li",
         {
           key: index,
-          className: "markdown-list-item"
+          className: "markdown-list-item",
+          "data-counter-text": ordered ? `${index + 1}.` : void 0,
+          "data-list-depth": 0
         },
         renderInlineNodes(item, defaultInlineComponents)
       )
     );
-    return import_react3.default.createElement(
+    return import_react5.default.createElement(
       tag,
       {
-        className: `markdown-list ${ordered ? "ordered" : "unordered"}`
+        className: `markdown-list ${ordered ? "ordered" : "unordered"}`,
+        style: listStyle
       },
       listItems
     );
@@ -900,29 +1150,62 @@ var defaultBlockComponents = {
     const htmlString = (0, import_core.sanitizeHTML)(raw);
     if (typeof window !== "undefined" && elements) {
       const content = mapHtmlToReact(htmlString, elements);
-      return import_react3.default.createElement("div", { className: "markdown-html" }, content);
+      return import_react5.default.createElement("div", { className: "markdown-html" }, content);
     }
-    return import_react3.default.createElement("div", {
+    return import_react5.default.createElement("div", {
       className: "markdown-html",
       /* biome-ignore lint/security/noDangerouslySetInnerHtml: htmlString is sanitized before injection */
       dangerouslySetInnerHTML: { __html: htmlString }
     });
   },
-  mdx: ({ compiledRef, compiledModule, status, errorMessage }) => {
-    const [Comp, setComp] = import_react3.default.useState(null);
-    const [internalError, setInternalError] = import_react3.default.useState(null);
+  mdx: ({ compiledRef, compiledModule, status, errorMessage, raw }) => {
+    const [Comp, setComp] = import_react5.default.useState(null);
+    const [internalError, setInternalError] = import_react5.default.useState(null);
+    const [renderError, setRenderError] = import_react5.default.useState(null);
+    const [retryKey, setRetryKey] = import_react5.default.useState(0);
+    const hydrationContext = import_react5.default.useContext(MdxHydrationContext);
+    const hydrationController = hydrationContext?.controller ?? null;
+    const hydrationOptions = hydrationContext?.options;
+    const containerRef = import_react5.default.useRef(null);
+    const deferHydration = hydrationOptions?.strategy === "visible";
+    const shouldHydrate = useDeferredRender(
+      containerRef,
+      deferHydration ? {
+        enabled: true,
+        rootMargin: hydrationOptions?.rootMargin,
+        idleTimeoutMs: hydrationOptions?.idleTimeoutMs,
+        debounceMs: hydrationOptions?.debounceMs
+      } : { enabled: false }
+    );
     const resolvedId = compiledModule?.id ?? (compiledRef?.id && compiledRef.id !== "pending" ? compiledRef.id : void 0);
+    const handleRetry = import_react5.default.useCallback(() => {
+      setInternalError(null);
+      setRenderError(null);
+      setComp(null);
+      setRetryKey((prev) => prev + 1);
+    }, []);
+    const handleRuntimeError = import_react5.default.useCallback(
+      (error) => {
+        const message2 = error instanceof Error ? error.message : String(error);
+        setRenderError(message2);
+        markMdxHydrationError(resolvedId ?? compiledRef?.id);
+      },
+      [resolvedId, compiledRef?.id]
+    );
     const effectiveStatus = status ? status : resolvedId ? "compiled" : "pending";
-    const failureMessage = errorMessage ?? internalError ?? null;
+    const failureMessage = errorMessage ?? internalError ?? renderError ?? null;
     const moduleDependencies = compiledModule?.dependencies;
-    import_react3.default.useEffect(() => {
+    import_react5.default.useEffect(() => {
+      if (!shouldHydrate) {
+        return;
+      }
       if (status === "error") {
-        setComp(null);
-        setInternalError(null);
+        markMdxHydrationError(resolvedId ?? compiledRef?.id);
         return;
       }
       let cancelled = false;
       async function ensure() {
+        let permit = null;
         try {
           if (status === "error" || !resolvedId || resolvedId === "pending") {
             if (!cancelled) {
@@ -931,7 +1214,17 @@ var defaultBlockComponents = {
             }
             return;
           }
-          const { getMDXComponentFactory: getMDXComponentFactory2, registerInlineMdxModule: registerInlineMdxModule2 } = await Promise.resolve().then(() => (init_mdx_client(), mdx_client_exports));
+          if (hydrationController) {
+            permit = await hydrationController.acquire();
+            if (cancelled) {
+              permit.release();
+              return;
+            }
+          }
+          setInternalError(null);
+          setRenderError(null);
+          markMdxHydrationStart(resolvedId);
+          const { getMDXComponentFactory: getMDXComponentFactory2, registerInlineMdxModule: registerInlineMdxModule2 } = await loadMdxRuntime();
           if (compiledModule?.code) {
             registerInlineMdxModule2({
               id: compiledModule.id,
@@ -944,41 +1237,82 @@ var defaultBlockComponents = {
           if (!cancelled) {
             setComp(() => C);
             setInternalError(null);
+            markMdxHydrated(resolvedId);
           }
         } catch (error) {
           if (!cancelled) {
-            const message = error instanceof Error ? error.message : String(error);
-            setComp(null);
-            setInternalError(message);
+            const message2 = error instanceof Error ? error.message : String(error);
+            setInternalError(message2);
+            markMdxHydrationError(resolvedId);
           }
+        } finally {
+          permit?.release();
         }
       }
       ensure();
       return () => {
         cancelled = true;
       };
-    }, [compiledModule?.id, compiledModule?.code, moduleDependencies, resolvedId, status]);
+    }, [compiledModule?.id, compiledModule?.code, moduleDependencies, resolvedId, status, shouldHydrate, retryKey]);
     const compileMode = compiledModule?.source === "worker" || compiledRef?.id?.startsWith("worker:") ? "worker" : "server";
-    if (effectiveStatus === "error" || failureMessage) {
-      const message = failureMessage ?? (compileMode === "worker" ? "MDX compilation failed in client mode. Try switching back to server rendering or restarting the stream." : "MDX compilation failed. Try restarting the stream.");
-      return import_react3.default.createElement(
+    const pendingId = resolvedId && resolvedId !== "pending" ? resolvedId : compiledRef?.id ?? "pending";
+    const waitingForVisibility = deferHydration && !shouldHydrate && Boolean(resolvedId);
+    const pendingLabel = waitingForVisibility ? "MDX ready (hydrate on view)\u2026" : compileMode === "worker" ? "Compiling MDX (client)\u2026" : "Compiling MDX (server)\u2026";
+    const message = failureMessage ?? (compileMode === "worker" ? "MDX compilation failed in client mode. Try switching back to server rendering or restarting the stream." : "MDX compilation failed. Try restarting the stream.");
+    const rawFallback = typeof raw === "string" && raw.trim().length > 0 ? import_react5.default.createElement("pre", { className: "markdown-mdx-fallback" }, raw) : null;
+    const allowRetry = Boolean(internalError || renderError);
+    const retryButton = allowRetry ? import_react5.default.createElement(
+      "button",
+      {
+        type: "button",
+        className: "markdown-mdx-retry",
+        onClick: handleRetry
+      },
+      "Retry hydration"
+    ) : null;
+    const errorPanel = import_react5.default.createElement(
+      "div",
+      { className: "markdown-mdx-error" },
+      import_react5.default.createElement(import_react5.default.Fragment, null, import_react5.default.createElement("strong", null, "MDX failed"), import_react5.default.createElement("div", null, message))
+    );
+    if (Comp && !failureMessage) {
+      return import_react5.default.createElement(
         "div",
         {
-          className: "markdown-mdx error",
-          "data-mdx-ref": resolvedId ?? compiledRef?.id ?? "error",
+          className: "markdown-mdx",
+          ref: containerRef,
+          "data-mdx-ref": resolvedId ?? compiledRef?.id ?? "compiled",
+          "data-mdx-status": failureMessage ? "error" : "compiled",
+          "data-mdx-mode": compileMode
+        },
+        import_react5.default.createElement(
+          MdxRuntimeBoundary,
+          { resetKey: retryKey, onError: handleRuntimeError },
+          import_react5.default.createElement(Comp, {})
+        )
+      );
+    }
+    if (failureMessage) {
+      return import_react5.default.createElement(
+        "div",
+        {
+          className: "markdown-mdx",
+          ref: containerRef,
+          "data-mdx-ref": pendingId,
           "data-mdx-status": "error",
           "data-mdx-mode": compileMode
         },
-        import_react3.default.createElement(import_react3.default.Fragment, null, import_react3.default.createElement("strong", null, "MDX failed"), import_react3.default.createElement("div", null, message))
+        errorPanel,
+        rawFallback,
+        retryButton
       );
     }
     if (!Comp) {
-      const pendingId = resolvedId && resolvedId !== "pending" ? resolvedId : compiledRef?.id ?? "pending";
-      const pendingLabel = compileMode === "worker" ? "Compiling MDX (client)\u2026" : "Compiling MDX (server)\u2026";
-      return import_react3.default.createElement(
+      return import_react5.default.createElement(
         "div",
         {
           className: "markdown-mdx",
+          ref: containerRef,
           "data-mdx-ref": pendingId,
           "data-mdx-status": "pending",
           "data-mdx-mode": compileMode
@@ -986,41 +1320,31 @@ var defaultBlockComponents = {
         pendingLabel
       );
     }
-    return import_react3.default.createElement(
-      "div",
-      {
-        className: "markdown-mdx",
-        "data-mdx-ref": resolvedId ?? compiledRef?.id ?? "compiled",
-        "data-mdx-status": "compiled",
-        "data-mdx-mode": compileMode
-      },
-      import_react3.default.createElement(Comp, {})
-    );
   },
   // Footnotes block rendered at page end
   footnotes: ({ items }) => {
-    if (!items || items.length === 0) return import_react3.default.createElement(import_react3.default.Fragment, null);
+    if (!items || items.length === 0) return import_react5.default.createElement(import_react5.default.Fragment, null);
     const listItems = items.map(
-      (item) => import_react3.default.createElement(
+      (item) => import_react5.default.createElement(
         "li",
         { key: item.number, id: `fn:${item.number}` },
         renderInlineNodes(item.inlines, defaultInlineComponents),
         " ",
-        import_react3.default.createElement("a", { href: `#fnref:${item.number}`, className: "footnote-backref", "aria-label": "Back to content" }, "\u21A9")
+        import_react5.default.createElement("a", { href: `#fnref:${item.number}`, className: "footnote-backref", "aria-label": "Back to content" }, "\u21A9")
       )
     );
-    return import_react3.default.createElement("section", { className: "footnotes" }, import_react3.default.createElement("hr", {}), import_react3.default.createElement("ol", {}, listItems));
+    return import_react5.default.createElement("section", { className: "footnotes" }, import_react5.default.createElement("hr", {}), import_react5.default.createElement("ol", {}, listItems));
   },
   // Footnote definition placeholders (render nothing)
-  "footnote-def": () => import_react3.default.createElement(import_react3.default.Fragment, null),
+  "footnote-def": () => import_react5.default.createElement(import_react5.default.Fragment, null),
   // Callouts block
   callout: ({ kind, inlines = [] }) => {
     const tone = (kind || "NOTE").toUpperCase();
     const title = tone.charAt(0) + tone.slice(1).toLowerCase();
-    return import_react3.default.createElement(
+    return import_react5.default.createElement(
       "div",
       { className: `markdown-callout markdown-callout-${tone.toLowerCase()} border rounded p-3 my-3` },
-      import_react3.default.createElement("div", { className: "font-semibold mb-1" }, title),
+      import_react5.default.createElement("div", { className: "font-semibold mb-1" }, title),
       inlines.length > 0 ? renderInlineNodes(inlines, defaultInlineComponents) : null
     );
   },
@@ -1035,7 +1359,7 @@ var defaultBlockComponents = {
     const renderCells = (cells, tag, rowIdx) => cells.map((cell, i) => {
       const columnAlign = align?.[i] ?? void 0;
       const cellStyle = columnAlign ? { textAlign: columnAlign } : void 0;
-      return import_react3.default.createElement(
+      return import_react5.default.createElement(
         tag === "th" ? El.Th : El.Td,
         {
           key: `${rowIdx}-${i}`,
@@ -1046,14 +1370,14 @@ var defaultBlockComponents = {
         renderInlineNodes(cell, defaultInlineComponents)
       );
     });
-    return import_react3.default.createElement(
+    return import_react5.default.createElement(
       El.Table,
       { className: "markdown-table" },
-      header && header.length > 0 ? import_react3.default.createElement(El.Thead, {}, import_react3.default.createElement(El.Tr, {}, renderCells(header, "th", -1))) : null,
-      import_react3.default.createElement(
+      header && header.length > 0 ? import_react5.default.createElement(El.Thead, {}, import_react5.default.createElement(El.Tr, {}, renderCells(header, "th", -1))) : null,
+      import_react5.default.createElement(
         El.Tbody,
         {},
-        rows.map((row, r) => import_react3.default.createElement(El.Tr, { key: r }, renderCells(row, "td", r)))
+        rows.map((row, r) => import_react5.default.createElement(El.Tr, { key: r }, renderCells(row, "td", r)))
       )
     );
   }
@@ -1122,7 +1446,7 @@ var ComponentRegistry = class {
   renderBlock(block) {
     const Component = this.getBlockComponent(block.type);
     const props = this.getBlockProps(block);
-    return import_react3.default.createElement(Component, {
+    return import_react5.default.createElement(Component, {
       key: block.id,
       ...props
     });
@@ -1157,6 +1481,14 @@ var ComponentRegistry = class {
         return {
           inlines: block.payload.inline || []
         };
+      case "hr": {
+        const range = block.payload.range;
+        return {
+          className: "markdown-hr",
+          "data-start": typeof range?.from === "number" ? range.from : void 0,
+          "data-end": typeof range?.to === "number" ? range.to : void 0
+        };
+      }
       case "code":
         return {
           html: block.payload.highlightedHtml,
@@ -1189,7 +1521,8 @@ var ComponentRegistry = class {
             compiledRef: compiledRef ?? { id: "pending" },
             compiledModule,
             status,
-            errorMessage
+            errorMessage,
+            raw: typeof block.payload.raw === "string" ? block.payload.raw : void 0
           };
         })();
       case "table": {
@@ -1240,42 +1573,42 @@ var ComponentRegistry = class {
 function getDefaultHtmlElements() {
   return {
     // Text semantics
-    p: (props) => import_react3.default.createElement("p", props),
-    strong: (props) => import_react3.default.createElement("strong", props),
-    em: (props) => import_react3.default.createElement("em", props),
-    code: (props) => import_react3.default.createElement("code", props),
-    pre: (props) => import_react3.default.createElement("pre", props),
-    span: (props) => import_react3.default.createElement("span", props),
-    br: (props) => import_react3.default.createElement("br", props),
-    hr: (props) => import_react3.default.createElement("hr", props),
+    p: (props) => import_react5.default.createElement("p", props),
+    strong: (props) => import_react5.default.createElement("strong", props),
+    em: (props) => import_react5.default.createElement("em", props),
+    code: (props) => import_react5.default.createElement("code", props),
+    pre: (props) => import_react5.default.createElement("pre", props),
+    span: (props) => import_react5.default.createElement("span", props),
+    br: (props) => import_react5.default.createElement("br", props),
+    hr: (props) => import_react5.default.createElement("hr", props),
     // Lists
-    ul: (props) => import_react3.default.createElement("ul", props),
-    ol: (props) => import_react3.default.createElement("ol", props),
-    li: (props) => import_react3.default.createElement("li", props),
+    ul: (props) => import_react5.default.createElement("ul", props),
+    ol: (props) => import_react5.default.createElement("ol", props),
+    li: (props) => import_react5.default.createElement("li", props),
     // Links & media
-    a: (props) => import_react3.default.createElement("a", props),
-    img: (props) => import_react3.default.createElement("img", props),
+    a: (props) => import_react5.default.createElement("a", props),
+    img: (props) => import_react5.default.createElement("img", props),
     // Blockquotes
-    blockquote: (props) => import_react3.default.createElement("blockquote", props),
+    blockquote: (props) => import_react5.default.createElement("blockquote", props),
     // Tables
-    table: (props) => import_react3.default.createElement("table", props),
-    thead: (props) => import_react3.default.createElement("thead", props),
-    tbody: (props) => import_react3.default.createElement("tbody", props),
-    tr: (props) => import_react3.default.createElement("tr", props),
-    th: (props) => import_react3.default.createElement("th", props),
-    td: (props) => import_react3.default.createElement("td", props),
+    table: (props) => import_react5.default.createElement("table", props),
+    thead: (props) => import_react5.default.createElement("thead", props),
+    tbody: (props) => import_react5.default.createElement("tbody", props),
+    tr: (props) => import_react5.default.createElement("tr", props),
+    th: (props) => import_react5.default.createElement("th", props),
+    td: (props) => import_react5.default.createElement("td", props),
     // Generic
-    div: (props) => import_react3.default.createElement("div", props)
+    div: (props) => import_react5.default.createElement("div", props)
   };
 }
 function getDefaultTableElements(overrides) {
   const base = {
-    Table: (props) => import_react3.default.createElement("table", props),
-    Thead: (props) => import_react3.default.createElement("thead", props),
-    Tbody: (props) => import_react3.default.createElement("tbody", props),
-    Tr: (props) => import_react3.default.createElement("tr", props),
-    Th: (props) => import_react3.default.createElement("th", props),
-    Td: (props) => import_react3.default.createElement("td", props)
+    Table: (props) => import_react5.default.createElement("table", props),
+    Thead: (props) => import_react5.default.createElement("thead", props),
+    Tbody: (props) => import_react5.default.createElement("tbody", props),
+    Tr: (props) => import_react5.default.createElement("tr", props),
+    Th: (props) => import_react5.default.createElement("th", props),
+    Td: (props) => import_react5.default.createElement("td", props)
   };
   return { ...base, ...overrides || {} };
 }
@@ -1289,12 +1622,12 @@ function mapHtmlToReact(html, elements) {
       children.push(element);
     }
   });
-  return import_react3.default.createElement(import_react3.default.Fragment, {}, ...children);
+  return import_react5.default.createElement(import_react5.default.Fragment, {}, ...children);
 }
 function toReact(node, elements, key) {
   if (node.nodeType === Node.TEXT_NODE) {
     const text = node.textContent ?? "";
-    return import_react3.default.createElement(import_react3.default.Fragment, { key }, text);
+    return import_react5.default.createElement(import_react5.default.Fragment, { key }, text);
   }
   if (node.nodeType !== Node.ELEMENT_NODE) {
     return null;
@@ -1316,9 +1649,9 @@ function toReact(node, elements, key) {
   const component = elements[tag];
   const elementChildren = children.length > 0 ? children : void 0;
   if (component) {
-    return import_react3.default.createElement(component, { ...props, key }, elementChildren);
+    return import_react5.default.createElement(component, { ...props, key }, elementChildren);
   }
-  return import_react3.default.createElement(tag, { ...props, key }, elementChildren);
+  return import_react5.default.createElement(tag, { ...props, key }, elementChildren);
 }
 function attrsToProps(attrs) {
   if (!attrs) return {};
@@ -1363,12 +1696,12 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
     nodes.forEach((node, idx) => {
       if (node === null || node === void 0) return;
       const key = `${baseKey}-${idx}`;
-      if (import_react3.default.isValidElement(node)) {
-        target.push(node.key === key ? node : import_react3.default.cloneElement(node, { key }));
+      if (import_react5.default.isValidElement(node)) {
+        target.push(node.key === key ? node : import_react5.default.cloneElement(node, { key }));
       } else if (typeof node === "string" || typeof node === "number") {
-        target.push(import_react3.default.createElement(import_react3.default.Fragment, { key }, node));
+        target.push(import_react5.default.createElement(import_react5.default.Fragment, { key }, node));
       } else {
-        target.push(import_react3.default.createElement(import_react3.default.Fragment, { key }, node));
+        target.push(import_react5.default.createElement(import_react5.default.Fragment, { key }, node));
       }
     });
   };
@@ -1384,7 +1717,7 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
     }
     const key = `paragraph-inline-group-${inlineGroupIndex++}`;
     result.push(
-      import_react3.default.createElement(
+      import_react5.default.createElement(
         "p",
         {
           key,
@@ -1402,7 +1735,7 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
         const inlineNodes = Array.isArray(segment.inline) ? segment.inline : [];
         if (inlineNodes.length === 0) {
           if (segment.value) {
-            inlineBuffer.push(import_react3.default.createElement(import_react3.default.Fragment, { key }, segment.value));
+            inlineBuffer.push(import_react5.default.createElement(import_react5.default.Fragment, { key }, segment.value));
           }
           break;
         }
@@ -1430,14 +1763,14 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
         const status = segment.status ?? "pending";
         let element;
         if (status === "compiled") {
-          element = import_react3.default.createElement("span", { className: "markdown-mdx-inline", "data-mdx-status": "compiled" });
+          element = import_react5.default.createElement("span", { className: "markdown-mdx-inline", "data-mdx-status": "compiled" });
         } else if (status === "error") {
           const message = segment.value || "MDX error";
-          element = import_react3.default.createElement("span", { className: "markdown-mdx-inline text-destructive", "data-mdx-status": "error" }, message);
+          element = import_react5.default.createElement("span", { className: "markdown-mdx-inline text-destructive", "data-mdx-status": "error" }, message);
         } else {
-          element = import_react3.default.createElement("span", { className: "markdown-mdx-inline", "data-mdx-status": status }, segment.value);
+          element = import_react5.default.createElement("span", { className: "markdown-mdx-inline", "data-mdx-status": status }, segment.value);
         }
-        inlineBuffer.push(import_react3.default.createElement(import_react3.default.Fragment, { key }, element));
+        inlineBuffer.push(import_react5.default.createElement(import_react5.default.Fragment, { key }, element));
         break;
       }
       case "html": {
@@ -1453,7 +1786,7 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
             result.push(element);
           } else if (html) {
             result.push(
-              import_react3.default.createElement("div", {
+              import_react5.default.createElement("div", {
                 key,
                 className: "markdown-inline-html-block",
                 dangerouslySetInnerHTML: { __html: html }
@@ -1472,7 +1805,7 @@ function renderParagraphMixedSegments(segments, inlineComponents, inlineHtmlRend
   flushInline();
   if (result.length === 0) {
     return [
-      import_react3.default.createElement(
+      import_react5.default.createElement(
         "p",
         {
           key: "paragraph-inline-group-0",
@@ -1532,6 +1865,7 @@ var BLOCK_LEVEL_TAGS = /* @__PURE__ */ new Set([
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ComponentRegistry,
+  DefaultLinkSafetyModal,
   defaultBlockComponents,
   defaultInlineComponents,
   mapHtmlToReact,