@ai-react-markdown/engine 2.3.3 → 2.4.1

package/dist/index.cjs

@@ -61,6 +61,7 @@ __export(src_exports, {
   extendSanitizeSchema: () => extendSanitizeSchema,
   extractContributions: () => extractContributions,
   extractDefBodiesFromHast: () => extractDefBodiesFromHast,
+  footnoteSafeId: () => footnoteSafeId,
   getEnginePluginInternals: () => getEnginePluginInternals,
   hasLoneSurrogate: () => hasLoneSurrogate,
   highlight: () => highlight,
@@ -72,6 +73,7 @@ __export(src_exports, {
   normalizeId: () => normalizeId,
   pangu: () => pangu,
   parseStage: () => parseStage,
+  phantomSuffixCloser: () => phantomSuffixCloser,
   preprocessAIMDContent: () => preprocessAIMDContent,
   preprocessLaTeX: () => preprocessLaTeX,
   rehypeFooterAdorn: () => rehypeFooterAdorn,
@@ -289,7 +291,7 @@ var DEF_LIST_DD_RE = /^ {0,3}:[ \t]/;
 var DEF_RE = /^ {0,3}\[((?:[^[\]\\]|\\.)+)\]:/;
 var FENCE_RE = /^ {0,3}(`{3,}|~{3,})/;
 var MATH_RUN_RE = /^ {0,3}(\$\$+)/;
-var TAG_OR_COMMENT_RE = /<(\/?)([A-Za-z][A-Za-z0-9-]*)(?=[\s/>])([^>]*)>|<!--|-->/g;
+var TAG_OR_COMMENT_RE = /<(\/?)([A-Za-z][A-Za-z0-9-]*)(?=[\s/>])([^>]*)>|<!--|-->|--!>/g;
 var TRUNCATED_TAG_RE = /<(\/?)([A-Za-z][A-Za-z0-9-]*)([^<>]*)$/;
 var REF_RE = /!?\[((?:[^[\]\\]|\\.)*)\]/g;
 var BACKTICK_RUN_RE = /`+/g;
@@ -371,6 +373,7 @@ function freshCheckpoint(defListEnabled, mathFlow, referenceTaint) {
     fenceLen: 0,
     inMath: false,
     mathFenceLen: 0,
+    openIndent: 0,
     blankRun: 0,
     lastBlankStart: -1,
     hazardVerdict: false,
@@ -381,21 +384,15 @@ function freshCheckpoint(defListEnabled, mathFlow, referenceTaint) {
     paragraphHasUnpairedRun: false,
     htmlFlowSinceBlank: false,
     htmlSeamPending: false,
-    phasePoisonedAt: Infinity
+    phasePoisonedAt: Infinity,
+    pendingTruncatedTags: []
   };
 }
 function isPlausibleLinkDefRest(rest) {
   const t = rest.trim();
   if (t === "") return false;
-  let destEnd;
-  if (t.startsWith("<")) {
-    const close = t.indexOf(">");
-    if (close === -1) return false;
-    destEnd = close + 1;
-  } else {
-    const ws = t.search(/[ \t]/);
-    destEnd = ws === -1 ? t.length : ws;
-  }
+  const destEnd = linkDestinationEnd(t);
+  if (destEnd === -1) return false;
   const after = t.slice(destEnd).trim();
   if (after === "") return true;
   const opener = after[0];
@@ -410,6 +407,39 @@ function isPlausibleLinkDefRest(rest) {
   }
   return false;
 }
+function linkDestinationEnd(t) {
+  if (t.startsWith("<")) {
+    for (let i2 = 1; i2 < t.length; i2++) {
+      const ch = t[i2];
+      if (ch === "\\" && (t[i2 + 1] === "<" || t[i2 + 1] === ">" || t[i2 + 1] === "\\")) {
+        i2 += 1;
+        continue;
+      }
+      if (ch === ">") return i2 + 1;
+      if (ch === "<") return -1;
+    }
+    return -1;
+  }
+  let balance = 0;
+  let i = 0;
+  for (; i < t.length; i++) {
+    const code = t.charCodeAt(i);
+    if (code === 32 || code === 9) break;
+    if (code < 32 || code === 127) return -1;
+    const ch = t[i];
+    if (ch === "\\" && (t[i + 1] === "(" || t[i + 1] === ")" || t[i + 1] === "\\")) {
+      i += 1;
+      continue;
+    }
+    if (ch === "(") balance += 1;
+    else if (ch === ")") {
+      if (balance === 0) break;
+      balance -= 1;
+    }
+  }
+  if (balance !== 0 || i === 0) return -1;
+  return i;
+}
 function classifyBlockStart(text, indent, defListEnabled) {
   if (indent >= 4) return true;
   if (LIST_MARKER_RE.test(text) || FOOTNOTE_DEF_RE.test(text)) return true;
@@ -471,6 +501,48 @@ function computeFreezeBoundary(text, options, resume) {
   }
   return { boundary, checkpoint: cp };
 }
+function floatingResidue(text, commentOpenAtStart) {
+  let out = "";
+  let open = commentOpenAtStart;
+  let last = 0;
+  TAG_OR_COMMENT_RE.lastIndex = 0;
+  let m;
+  while ((m = TAG_OR_COMMENT_RE.exec(text)) !== null) {
+    if (m[0] === "<!--") {
+      const next = text.slice(m.index + 4, m.index + 6);
+      const overlapLen = next.startsWith(">") ? 5 : next === "->" ? 6 : 0;
+      if (open) {
+        if (overlapLen) {
+          open = false;
+          last = m.index + overlapLen;
+          TAG_OR_COMMENT_RE.lastIndex = last;
+        }
+        continue;
+      }
+      out += text.slice(last, m.index);
+      if (overlapLen) {
+        last = m.index + overlapLen;
+        TAG_OR_COMMENT_RE.lastIndex = last;
+        continue;
+      }
+      open = true;
+      continue;
+    }
+    if (m[0] === "-->") {
+      if (open) {
+        open = false;
+        last = m.index + 3;
+      }
+      continue;
+    }
+    if (m[0] === "--!>") continue;
+    if (open) continue;
+    out += text.slice(last, m.index);
+    last = m.index + m[0].length;
+  }
+  if (!open) out += text.slice(last);
+  return out;
+}
 function processConfirmedLine(cp, ln, text) {
   const newest = cp.candidates[cp.candidates.length - 1];
   if (newest && newest.defListSettled === null) {
@@ -525,6 +597,7 @@ function processConfirmedLine(cp, ln, text) {
       cp.inFence = true;
       cp.fenceChar = open[1][0];
       cp.fenceLen = open[1].length;
+      cp.openIndent = ln.indent;
       cp.blankRun = 0;
       cp.paragraphHasUnpairedRun = false;
       cp.prevLineBlank = false;
@@ -559,6 +632,7 @@ function processConfirmedLine(cp, ln, text) {
         }
         cp.inMath = true;
         cp.mathFenceLen = mathRun[1].length;
+        cp.openIndent = ln.indent;
         cp.blankRun = 0;
         cp.paragraphHasUnpairedRun = false;
         cp.prevLineBlank = false;
@@ -569,6 +643,10 @@ function processConfirmedLine(cp, ln, text) {
     }
   }
   if (ln.blank) {
+    if (cp.pendingTruncatedTags.length > 0) {
+      for (const tag of cp.pendingTruncatedTags) applyTag(tag, true);
+      cp.pendingTruncatedTags = [];
+    }
     cp.blankRun += 1;
     cp.lastBlankStart = ln.start;
     cp.candidates.push({
@@ -598,6 +676,7 @@ function processConfirmedLine(cp, ln, text) {
     if (!TYPE6_NAMES.has(tagStart[1].toLowerCase())) cp.hazardVerdict = true;
   }
   const inRawText = cp.htmlFlowSinceBlank || rawOpenAtLineStart;
+  const rawFlowStart = ln.indent <= 3 && /^<(?:!--|\?|![A-Za-z]|!\[CDATA\[)/.test(ln.text.trimStart());
   const { masked, unpaired } = inRawText ? { masked: null, unpaired: false } : maskIntraLineCodeSpans(ln.text, cp.paragraphHasUnpairedRun);
   if (unpaired) cp.paragraphHasUnpairedRun = true;
   const scanText = masked ?? ln.text;
@@ -639,12 +718,16 @@ function processConfirmedLine(cp, ln, text) {
       cp.unresolvedRefs.push({ offset: ln.start + m.index, label, footnote });
     }
   }
-  const rawOpenAtStart = cp.piOpen || cp.declOpen || cp.cdataOpen;
   const rawSpans = [];
   let pos = 0;
+  const poisonRawDivergence = () => {
+    cp.phasePoisonedAt = Math.min(cp.phasePoisonedAt, ln.start);
+  };
   while (pos < scanText.length) {
     if (cp.piOpen) {
       const c = scanText.indexOf("?>", pos);
+      const gt = scanText.indexOf(">", pos);
+      if (gt !== -1 && (c === -1 || gt !== c + 1)) poisonRawDivergence();
       if (c === -1) {
         rawSpans.push([pos, scanText.length]);
         break;
@@ -656,6 +739,8 @@ function processConfirmedLine(cp, ln, text) {
     }
     if (cp.cdataOpen) {
       const c = scanText.indexOf("]]>", pos);
+      const gt = scanText.indexOf(">", pos);
+      if (gt !== -1 && (c === -1 || gt !== c + 2)) poisonRawDivergence();
       if (c === -1) {
         rawSpans.push([pos, scanText.length]);
         break;
@@ -688,6 +773,12 @@ function processConfirmedLine(cp, ln, text) {
       cp.cdataOpen = true;
       pos = cd + 9;
     } else if (first === pi) {
+      if (scanText[pi + 2] === ">") {
+        rawSpans.push([pi, pi + 3]);
+        pos = pi + 3;
+        if (scanText.slice(0, pi).trim() !== "" || ln.indent > 3) poisonRawDivergence();
+        continue;
+      }
       rawSpans.push([pi, pi + 2]);
       cp.piOpen = true;
       pos = pi + 2;
@@ -697,13 +788,25 @@ function processConfirmedLine(cp, ln, text) {
       pos = decl + 2;
     }
   }
-  const rawOpenAtEnd = cp.piOpen || cp.declOpen || cp.cdataOpen;
-  if (!rawOpenAtStart && !rawOpenAtEnd) {
+  let tagText = scanText;
+  for (const [from, to] of rawSpans) {
+    tagText = tagText.slice(0, from) + " ".repeat(to - from) + tagText.slice(to);
+  }
+  {
     TAG_OR_COMMENT_RE.lastIndex = 0;
     let m;
     let lastCommentOpenerIdx = -1;
-    while ((m = TAG_OR_COMMENT_RE.exec(scanText)) !== null) {
+    while ((m = TAG_OR_COMMENT_RE.exec(tagText)) !== null) {
       if (m[0] === "<!--") {
+        const next = tagText.slice(m.index + 4, m.index + 6);
+        if (cp.commentOpen) {
+          if (next.startsWith(">") || next === "->") cp.commentOpen = false;
+          else if (next === "!>" || next === "-!") poisonRawDivergence();
+          continue;
+        }
+        if (next.startsWith(">") || next === "->") {
+          continue;
+        }
         cp.commentOpen = true;
         lastCommentOpenerIdx = m.index;
         continue;
@@ -712,6 +815,10 @@ function processConfirmedLine(cp, ln, text) {
         cp.commentOpen = false;
         continue;
       }
+      if (m[0] === "--!>") {
+        if (cp.commentOpen) poisonRawDivergence();
+        continue;
+      }
       if (cp.commentOpen) continue;
       const closing = m[1] === "/";
       const tag = m[2].toLowerCase();
@@ -720,33 +827,56 @@ function processConfirmedLine(cp, ln, text) {
       applyTag(tag, closing);
     }
     if (cp.commentOpen && lastCommentOpenerIdx !== -1 && !inRawText) {
-      if (scanText.slice(0, lastCommentOpenerIdx).trim() !== "") {
+      if (tagText.slice(0, lastCommentOpenerIdx).trim() !== "") {
         cp.phasePoisonedAt = Math.min(cp.phasePoisonedAt, ln.start + lastCommentOpenerIdx);
       }
     }
+    if (masked !== null && masked !== ln.text) {
+      const inRaw = (i) => rawSpans.some(([from, to]) => i >= from && i < to);
+      TAG_OR_COMMENT_RE.lastIndex = 0;
+      let mr;
+      while ((mr = TAG_OR_COMMENT_RE.exec(ln.text)) !== null) {
+        if (mr[0] === "<!--" || mr[0] === "-->" || mr[0] === "--!>") continue;
+        const startMasked = masked[mr.index] !== ln.text[mr.index];
+        const wholeVisible = masked.slice(mr.index, mr.index + mr[0].length) === mr[0];
+        if (startMasked || wholeVisible || inRaw(mr.index) || cp.commentOpen) continue;
+        const closing = mr[1] === "/";
+        const tag = mr[2].toLowerCase();
+        const selfClosing = mr[3] !== void 0 && /\/\s*$/.test(mr[3]);
+        if (VOID_TAGS.has(tag) || selfClosing) continue;
+        applyTag(tag, closing);
+      }
+    }
+    if (cp.pendingTruncatedTags.length > 0 && ln.text.includes(">")) {
+      cp.pendingTruncatedTags = [];
+    }
     if (!cp.commentOpen) {
-      const lastLt = scanText.lastIndexOf("<");
-      if (lastLt !== -1 && !scanText.includes(">", lastLt)) {
-        const m2 = TRUNCATED_TAG_RE.exec(scanText.slice(lastLt));
+      const lastLt = tagText.lastIndexOf("<");
+      if (lastLt !== -1 && !tagText.includes(">", lastLt)) {
+        const m2 = TRUNCATED_TAG_RE.exec(tagText.slice(lastLt));
         if (m2) {
           const closing = m2[1] === "/";
           const tag = m2[2].toLowerCase();
-          if (!VOID_TAGS.has(tag)) applyTag(tag, closing);
+          if (!VOID_TAGS.has(tag)) {
+            applyTag(tag, closing);
+            const rawLastLt = ln.text.lastIndexOf("<");
+            const rawTruncated = rawLastLt !== -1 && !ln.text.includes(">", rawLastLt);
+            if (!closing && !inRawText && rawTruncated) cp.pendingTruncatedTags.push(tag);
+          }
         }
       }
     }
   }
-  if (inRawText && cp.openTotal === 0) {
-    let residue = scanText;
+  const effectiveOpen = cp.openTotal - cp.pendingTruncatedTags.length;
+  if ((inRawText || rawFlowStart) && effectiveOpen <= 0) {
+    let masked2 = "";
+    let cursor = 0;
     for (const [from, to] of rawSpans) {
-      residue = residue.slice(0, from) + " ".repeat(to - from) + residue.slice(to);
+      masked2 += scanText.slice(cursor, from);
+      cursor = to;
     }
-    residue = residue.replace(/<!--[\s\S]*?-->/g, " ");
-    if (commentOpenAtLineStart) {
-      residue = residue.includes("-->") ? residue.replace(/[\s\S]*?-->/, " ") : "";
-    }
-    residue = residue.replace(TAG_OR_COMMENT_RE, "");
-    if (residue.trim() !== "") {
+    masked2 += scanText.slice(cursor);
+    if (floatingResidue(masked2, commentOpenAtLineStart).length > 0) {
       cp.htmlSeamPending = true;
     }
   }
@@ -756,6 +886,9 @@ function processConfirmedLine(cp, ln, text) {
   cp.prevLineWasValidDef = validDef && !def[1].startsWith("^");
 }
 
+// src/components/incrementalParse/spliceParse.ts
+var import_micromark_util_normalize_identifier2 = require("micromark-util-normalize-identifier");
+
 // src/components/hastPredicates.ts
 function isFootnoteSection(node) {
   if (node.tagName !== "section") return false;
@@ -806,7 +939,7 @@ function collectPrefixInjection(mdast, content, boundary, resume) {
     if (last && last.kind === "refs") last.tokens.push(token);
     else events.push({ kind: "refs", tokens: [token] });
   };
-  const visit6 = (node, nested) => {
+  const visit7 = (node, nested) => {
     const type = node.type;
     if (type === "definition") {
       const start = node.position?.start?.offset;
@@ -847,20 +980,24 @@ function collectPrefixInjection(mdast, content, boundary, resume) {
     }
     const children = node.children;
     if (children) {
-      for (const child of children) visit6(child, true);
+      for (const child of children) visit7(child, true);
     }
   };
+  let lastStart = -1;
   for (const child of mdast.children) {
     const start = child.position?.start?.offset;
+    if (start !== void 0) {
+      if (start < lastStart) return { events: [], uninjectable: true, cacheable: false };
+      lastStart = start;
+    }
     if (start === void 0) {
       if (resumeAt > 0) return collectPrefixInjection(mdast, content, boundary, null);
       cacheable = false;
-      visit6(child, false);
+      visit7(child, false);
       continue;
     }
-    if (start >= boundary) break;
-    if (start < resumeAt) continue;
-    visit6(child, false);
+    if (start >= boundary || start < resumeAt) continue;
+    visit7(child, false);
   }
   return { events, uninjectable, cacheable };
 }
@@ -873,7 +1010,7 @@ function cloneEventsForAppend(events) {
 var TERMINATOR_LABEL = "__aimd_injection_terminator__";
 var INJECTION_TERMINATOR = `[${TERMINATOR_LABEL}]: __aimd_sentinel_link__`;
 function tailMentionsTerminator(tailSource) {
-  return tailSource.includes(`[${TERMINATOR_LABEL}`);
+  return (0, import_micromark_util_normalize_identifier2.normalizeIdentifier)(tailSource).replace(/\[ /g, "[").includes(`[${(0, import_micromark_util_normalize_identifier2.normalizeIdentifier)(TERMINATOR_LABEL)}`);
 }
 function buildInjectionPrefix(events) {
   if (events.length === 0) return { text: "", segments: [] };
@@ -953,12 +1090,25 @@ function spliceTrees(input) {
       if (isTrailingLiteralText(node2)) {
         const prev = i > 0 ? prevHast.children[i - 1] : void 0;
         if (!prev || prev.type !== "element" || prev.position === void 0) return null;
+        if (!ownsTrailingLiteral(prev, node2, prefixMdast))
+          return null;
       }
       cutRegion.push(node2);
       continue;
     }
     const node = prevHast.children[i];
-    if (i > 0 && attrs[i - 1] < boundary && prevHast.children[i - 1].type === "element" && isTrailingLiteralText(node)) {
+    if (i > 0 && attrs[i - 1] < boundary && prevHast.children[i - 1].type === "element" && isTrailingLiteralText(node) && // …and only when that element really IS an html block's output: a
+    // raw literal can only trail an `html` mdast node. A position-less
+    // text after a `<p>` is the NEXT block's remnant — a stray end tag
+    // (`</t>\na`) parse5 dropped, whose text merged with the wrap
+    // separator — owned by the tail, which re-parses it; freezing it
+    // here duplicated it (v2.4.0 review P3). Falls through to the
+    // remnant look-ahead below, which bails to a full parse. And the
+    // literal must really be THAT block's trailing text: the block's raw
+    // source ends with it. A dropped-tag block right after a frozen html
+    // element (`</details>\n\n</t>\ntext`) puts its remnant in the same
+    // position, and freezing it duplicated it (release soak of the fix).
+    ownsTrailingLiteral(prevHast.children[i - 1], node, prefixMdast)) {
       cutRegion.push(node);
       break;
     }
@@ -1173,8 +1323,16 @@ function stripInjectedHast(tailMdast, tailHast, injectedLen, tailWrapVisible) {
 }
 function tailLeadingTextIsHoist(tailMdastChildren, tailHastChildren) {
   const firstText = tailHastChildren[0];
-  if (!firstText || !isSeparatorText(firstText)) return false;
+  if (!firstText) return false;
   const firstVisible = tailMdastChildren.find((c) => !isWrapInvisible(c));
+  if (!isSeparatorText(firstText)) {
+    if (firstText.type === "text" && firstText.position === void 0 && firstVisible?.type === "html") {
+      if (/^\s*<\/[A-Za-z][A-Za-z0-9-]*\s*>/.test(firstVisible.value)) return true;
+      if (isCompleteRawConstruct(firstVisible.value)) return false;
+      return null;
+    }
+    return false;
+  }
   if (!firstVisible) return false;
   const firstContent = tailHastChildren.find((c) => !isSeparatorText(c));
   if (firstContent) {
@@ -1196,6 +1354,14 @@ function isCompleteRawConstruct(value) {
 function isSeparatorText(node) {
   return node.type === "text" && node.position === void 0 && node.value.trim() === "";
 }
+function ownsTrailingLiteral(el, literal, prefixMdast) {
+  const start = el.position?.start?.offset;
+  if (start === void 0) return false;
+  const owner = prefixMdast.find((c) => c.type === "html" && c.position?.start?.offset === start);
+  if (!owner || owner.type !== "html") return false;
+  const text = literal.value.trim();
+  return text !== "" && owner.value.trimEnd().endsWith(text);
+}
 function isTrailingLiteralText(node) {
   return node.type === "text" && node.position === void 0 && node.value.trim() !== "";
 }
@@ -1321,11 +1487,12 @@ var import_remark_gfm = __toESM(require("remark-gfm"), 1);
 var import_unist_util_visit = require("unist-util-visit");
 
 // src/components/normalizeId.ts
+var import_micromark_util_normalize_identifier3 = require("micromark-util-normalize-identifier");
 function normalizeId(s) {
-  return s.replace(/\s+/g, " ").toUpperCase();
+  return (0, import_micromark_util_normalize_identifier3.normalizeIdentifier)(s);
 }
 function normalizeForMatch(s) {
-  return s.replace(/\\(.)/g, "$1").replace(/\s+/g, " ").toUpperCase();
+  return (0, import_micromark_util_normalize_identifier3.normalizeIdentifier)(s.replace(/\\(.)/g, "$1"));
 }
 
 // src/components/collectDefLabels.ts
@@ -1429,7 +1596,11 @@ function createDefLabelScanner(parse = collectDefLabels) {
 
 // src/components/extractDefBodiesFromHast.ts
 var import_unist_util_visit2 = require("unist-util-visit");
+var import_micromark_util_sanitize_uri = require("micromark-util-sanitize-uri");
 var FN_LI_ID_RE = /(?:^|-)user-content-fn-(.+)$/;
+function footnoteSafeId(identifier) {
+  return (0, import_micromark_util_sanitize_uri.normalizeUri)(identifier.toLowerCase());
+}
 function sourceIdFromFootnoteLiId(idProp, clobberPrefix) {
   let raw = null;
   if (clobberPrefix !== void 0) {
@@ -1580,6 +1751,18 @@ function buildPhantomSuffix(phantoms) {
   }
   return suffix;
 }
+function phantomSuffixCloser(content) {
+  if (content === "") return "";
+  const endsWithNewline = content.endsWith("\n");
+  const confirmed = endsWithNewline ? content : content + "\n";
+  const { checkpoint } = computeFreezeBoundary(confirmed, { defListEnabled: false, referenceTaint: false });
+  if (checkpoint.phasePoisonedAt !== Infinity) return "";
+  if (checkpoint.openIndent !== 0) return "";
+  const nl = endsWithNewline ? "" : "\n";
+  if (checkpoint.inFence) return `${nl}${checkpoint.fenceChar.repeat(checkpoint.fenceLen)}`;
+  if (checkpoint.inMath) return `${nl}${"$".repeat(checkpoint.mathFenceLen)}`;
+  return "";
+}
 
 // src/components/extractContributions.ts
 function fakeAnchorElement(url) {
@@ -1658,6 +1841,14 @@ function createRegistry(onEmpty) {
     releaseSymbol(reactId) {
       const entry = this._reactIdMap.get(reactId);
       if (!entry) return;
+      if (entry.refcount <= 0) {
+        if (false) {
+          console.warn(
+            `[ai-react-markdown] Registry.releaseSymbol("${reactId}") called with no matching allocateSymbol \u2014 ignoring (unbalanced release).`
+          );
+        }
+        return;
+      }
       entry.refcount--;
       if (entry.refcount === 0) {
         queueMicrotask(() => {
@@ -1808,6 +1999,41 @@ function createRegistry(onEmpty) {
 var import_rehype_katex = __toESM(require("rehype-katex"), 1);
 var import_rehype_raw = __toESM(require("rehype-raw"), 1);
 var import_rehype_unwrap_images = __toESM(require("rehype-unwrap-images"), 1);
+
+// src/components/rehypeUnwrapCrossChunkImages.ts
+var import_unist_util_visit4 = require("unist-util-visit");
+var IMAGE_TAGS = /* @__PURE__ */ new Set(["img", "cross-chunk-image"]);
+var LINK_TAGS = /* @__PURE__ */ new Set(["a", "cross-chunk-link"]);
+function applicable(node, inLink) {
+  let image = 0 /* Unknown */;
+  for (const child of node.children) {
+    if (child.type === "text" && /^\s*$/.test(child.value)) continue;
+    if (child.type === "element" && IMAGE_TAGS.has(child.tagName)) {
+      image = 1 /* ContainsImage */;
+    } else if (!inLink && child.type === "element" && LINK_TAGS.has(child.tagName)) {
+      const inner = applicable(child, true);
+      if (inner === 2 /* ContainsOther */) return 2 /* ContainsOther */;
+      if (inner === 1 /* ContainsImage */) image = 1 /* ContainsImage */;
+    } else {
+      return 2 /* ContainsOther */;
+    }
+  }
+  return image;
+}
+function rehypeUnwrapCrossChunkImages() {
+  return function transform(tree) {
+    (0, import_unist_util_visit4.visit)(tree, "element", (node, index, parent) => {
+      if (node.tagName === "p" && parent && typeof index === "number" && applicable(node, false) === 1 /* ContainsImage */ && // Only paragraphs that actually hold a placeholder — plain <img>
+      // paragraphs were already unwrapped by rehype-unwrap-images.
+      JSON.stringify(node.children).includes('"cross-chunk-image"')) {
+        parent.children.splice(index, 1, ...node.children);
+        return [import_unist_util_visit4.SKIP, index];
+      }
+    });
+  };
+}
+
+// src/components/pluginChain.ts
 var import_rehype_sanitize = __toESM(require("rehype-sanitize"), 1);
 var import_remark_breaks = __toESM(require("remark-breaks"), 1);
 var import_remark_cjk_friendly = __toESM(require("remark-cjk-friendly"), 1);
@@ -1823,13 +2049,13 @@ var import_remark_pangu = __toESM(require("remark-pangu"), 1);
 var import_remark_remove_comments = __toESM(require("remark-remove-comments"), 1);
 
 // src/components/rehypeRebaseHashLinks.ts
-var import_unist_util_visit4 = require("unist-util-visit");
+var import_unist_util_visit5 = require("unist-util-visit");
 var DEFAULT_PREFIX = "user-content-";
 var rehypeRebaseHashLinks = (options) => {
   const prefix = options?.prefix ?? DEFAULT_PREFIX;
   const hashPrefix = "#" + prefix;
   return (tree) => {
-    (0, import_unist_util_visit4.visit)(tree, "element", (node) => {
+    (0, import_unist_util_visit5.visit)(tree, "element", (node) => {
       if (node.tagName !== "a") return;
       const href = node.properties?.href;
       if (typeof href !== "string" || !href.startsWith("#")) return;
@@ -1841,7 +2067,7 @@ var rehypeRebaseHashLinks = (options) => {
 var rehypeRebaseHashLinks_default = rehypeRebaseHashLinks;
 
 // src/components/rehypeFooterAdorn.ts
-var import_unist_util_visit5 = require("unist-util-visit");
+var import_unist_util_visit6 = require("unist-util-visit");
 var FOOTNOTE_LABEL_ID_RE = /(?:^|-)footnote-label$/;
 function isFootnoteLabelH2(node) {
   if (node.type !== "element") return false;
@@ -1856,7 +2082,7 @@ function isHr(node) {
 }
 function rehypeFooterAdorn() {
   return (tree) => {
-    (0, import_unist_util_visit5.visit)(tree, "element", (n) => {
+    (0, import_unist_util_visit6.visit)(tree, "element", (n) => {
       const el = n;
       if (el.tagName !== "section") return;
       if (!(el.properties && "dataFootnotes" in el.properties)) return;
@@ -1934,7 +2160,10 @@ function buildCoreRehypePlugins(sanitizeSchema2, clobberPrefix) {
     // above.
     [rehypeRebaseHashLinks_default, { prefix: clobberPrefix }],
     import_rehype_katex.default,
-    import_rehype_unwrap_images.default
+    import_rehype_unwrap_images.default,
+    // Same unwrap for `<cross-chunk-image>` placeholders (coordinated mode);
+    // no-op on standalone documents.
+    rehypeUnwrapCrossChunkImages
   ];
 }
 function buildCoreRemarkRehypeOptions(enableDefinitionList) {
@@ -1954,6 +2183,11 @@ function buildCoreRemarkRehypeOptions(enableDefinitionList) {
 }
 
 // src/components/customMdastHandlers.ts
+function localDefProps(s, id) {
+  const def = s.definitionById.get(id);
+  if (!def || typeof def.url !== "string" || def.url === SENTINEL_LINK_URL) return {};
+  return def.title ? { localUrl: def.url, localTitle: def.title } : { localUrl: def.url };
+}
 function buildCrossChunkHandlers() {
   return {
     footnoteDefinition: (state, node) => {
@@ -1986,7 +2220,8 @@ function buildCrossChunkHandlers() {
           // internally, so cross-chunk case-insensitive matching still works.
           label: node.label ?? node.identifier,
           referenceType: node.referenceType,
-          documentId: s.options.documentId
+          documentId: s.options.documentId,
+          ...localDefProps(s, id)
         },
         children: s.all(node)
       };
@@ -2003,7 +2238,8 @@ function buildCrossChunkHandlers() {
           label: node.label ?? node.identifier,
           referenceType: node.referenceType,
           alt: node.alt ?? "",
-          documentId: s.options.documentId
+          documentId: s.options.documentId,
+          ...localDefProps(s, id)
         },
         children: []
       };
@@ -2032,6 +2268,12 @@ function buildCrossChunkHandlers() {
         properties: {
           label: node.identifier,
           localOccurrence,
+          // The number mdast-util-to-hast would give this reference in a
+          // standalone render (footnoteOrder position) — the placeholder's
+          // fallback while the registry has no global number (server render /
+          // first client frame), where the local synthetic footer is what
+          // renders, so marks and footer agree (core-render-02).
+          localNumber: s.footnoteOrder.indexOf(id) + 1,
           documentId: s.options.documentId
         },
         children: []
@@ -2040,6 +2282,9 @@ function buildCrossChunkHandlers() {
   };
 }
 
+// src/components/crossChunkUrlSanitize.ts
+var import_micromark_util_sanitize_uri2 = require("micromark-util-sanitize-uri");
+
 // ../../node_modules/.pnpm/lodash-es@4.18.1/node_modules/lodash-es/_listCacheClear.js
 function listCacheClear() {
   this.__data__ = [];
@@ -3240,9 +3485,9 @@ var sanitizeSchema = cloneDeep_default({
   attributes: {
     ...import_rehype_sanitize2.defaultSchema.attributes,
     code: mergeClassNameAllowlist(import_rehype_sanitize2.defaultSchema.attributes?.code, ["math-inline", "math-display"]),
-    "cross-chunk-link": ["label", "referenceType", "documentId"],
-    "cross-chunk-image": ["label", "referenceType", "documentId", "alt"],
-    "footnote-sup": ["label", "localOccurrence", "documentId"]
+    "cross-chunk-link": ["label", "referenceType", "documentId", "localUrl", "localTitle"],
+    "cross-chunk-image": ["label", "referenceType", "documentId", "alt", "localUrl", "localTitle"],
+    "footnote-sup": ["label", "localOccurrence", "localNumber", "documentId"]
   }
 });
 
@@ -3267,6 +3512,7 @@ function isProtocolAllowed(url, allowed) {
   return allowed.some((p) => p === protocol);
 }
 function sanitizeCrossChunkUrl(rawUrl, key, tagName, urlTransform, schema) {
+  rawUrl = (0, import_micromark_util_sanitize_uri2.normalizeUri)(rawUrl);
   const transformed = urlTransform(rawUrl, key, fakeElement(tagName, key, rawUrl));
   if (transformed == null) return "";
   const stringUrl = String(transformed);
@@ -3611,9 +3857,9 @@ var createSmoothStreamController = (options = {}) => {
     snap,
     flush() {
       disposed = false;
-      if (visibleEnd === source.length) return;
-      visibleEnd = source.length;
-      tentativeEnd = source.length;
+      const target = finished ? source.length : pending.length > 0 ? pending[pending.length - 1] : visibleEnd;
+      if (target <= visibleEnd) return;
+      visibleEnd = target;
       pending = [];
       credit = 0;
       cancelScheduled();
@@ -4129,6 +4375,7 @@ function createRemendPreprocessor(options) {
   extendSanitizeSchema,
   extractContributions,
   extractDefBodiesFromHast,
+  footnoteSafeId,
   getEnginePluginInternals,
   hasLoneSurrogate,
   highlight,
@@ -4140,6 +4387,7 @@ function createRemendPreprocessor(options) {
   normalizeId,
   pangu,
   parseStage,
+  phantomSuffixCloser,
   preprocessAIMDContent,
   preprocessLaTeX,
   rehypeFooterAdorn,