@adeu/core 1.6.7 → 1.6.8

package/dist/index.js

@@ -12,6 +12,16 @@ function findChild(element, tagName) {
   }
   return null;
 }
+function findChildren(element, tagName) {
+  const result = [];
+  for (let i = 0; i < element.childNodes.length; i++) {
+    const child = element.childNodes[i];
+    if (child.nodeType === 1 && child.tagName === tagName) {
+      result.push(child);
+    }
+  }
+  return result;
+}
 function findAllDescendants(element, tagName) {
   return Array.from(element.getElementsByTagName(tagName));
 }
@@ -49,10 +59,10 @@ var Part = class {
   _element;
   addRelationship(id, type, target, isExternal = false) {
     this.rels.set(id, new Relationship(id, type, target, isExternal));
-    if (this._element.tagName === "Relationships") {
+    if (this.partname.endsWith(".rels")) {
       const doc = this._element.ownerDocument;
       if (doc) {
-        const relEl = doc.createElement("Relationship");
+        const relEl = doc.createElementNS("http://schemas.openxmlformats.org/package/2006/relationships", "Relationship");
         relEl.setAttribute("Id", id);
         relEl.setAttribute("Type", type);
         relEl.setAttribute("Target", target);
@@ -174,6 +184,15 @@ var DocumentObject = class _DocumentObject {
     const relsPart = this.pkg.getOrCreateRelsPart(this.part.partname);
     relsPart.addRelationship(id, relType, target, false);
   }
+  relateToExternal(target, relType) {
+    let rId = 1;
+    while (this.part.rels.has(`rId${rId}`)) rId++;
+    const id = `rId${rId}`;
+    this.part.rels.set(id, new Relationship(id, relType, target, true));
+    const relsPart = this.pkg.getOrCreateRelsPart(this.part.partname);
+    relsPart.addRelationship(id, relType, target, true);
+    return id;
+  }
   async save() {
     for (const part of this.pkg.parts) {
       let xmlStr = serializeXml(part._element.ownerDocument || part._element);
@@ -270,573 +289,157 @@ var FootnoteItem = class {
   part;
 };
 
-// src/utils/docx.ts
-var QN_W_P = "w:p";
-var QN_W_R = "w:r";
-var QN_W_T = "w:t";
-var QN_W_DELTEXT = "w:delText";
-var QN_W_TAB = "w:tab";
-var QN_W_BR = "w:br";
-var QN_W_CR = "w:cr";
-var QN_W_RPR = "w:rPr";
-var QN_W_RPRCHANGE = "w:rPrChange";
-var QN_W_COMMENTREFERENCE = "w:commentReference";
-var QN_W_FOOTNOTEREFERENCE = "w:footnoteReference";
-var QN_W_ENDNOTEREFERENCE = "w:endnoteReference";
-var QN_W_FLDCHAR = "w:fldChar";
-var QN_W_FLDCHARTYPE = "w:fldCharType";
-var QN_W_INSTRTEXT = "w:instrText";
-var QN_W_INS = "w:ins";
-var QN_W_DEL = "w:del";
-var QN_W_ID = "w:id";
-var QN_W_AUTHOR = "w:author";
-var QN_W_DATE = "w:date";
-var QN_W_COMMENTRANGESTART = "w:commentRangeStart";
-var QN_W_COMMENTRANGEEND = "w:commentRangeEnd";
-var QN_W_HYPERLINK = "w:hyperlink";
-var QN_R_ID = "r:id";
-var QN_W_FLDSIMPLE = "w:fldSimple";
-var QN_W_INSTR = "w:instr";
-var QN_W_BOOKMARKSTART = "w:bookmarkStart";
-var QN_W_NAME = "w:name";
-var QN_W_SDT = "w:sdt";
-var QN_W_SMARTTAG = "w:smartTag";
-var QN_W_SDTCONTENT = "w:sdtContent";
-var QN_W_B = "w:b";
-var QN_W_I = "w:i";
-var QN_W_VAL = "w:val";
-var QN_W_PPR = "w:pPr";
-var QN_W_PSTYLE = "w:pStyle";
-var QN_W_OUTLINELVL = "w:outlineLvl";
-var QN_W_NUMPR = "w:numPr";
-var QN_W_NUMID = "w:numId";
-var QN_W_ILVL = "w:ilvl";
-var _CUSTOM_HEADING_NAME_RE = /Heading[ ]?([1-6])(?![0-9])/;
-function _get_style_cache(part) {
-  const pkg = part.package || part.pkg || (part.part ? part.part.pkg : null);
-  if (pkg && pkg._adeu_style_cache) {
-    return pkg._adeu_style_cache;
-  }
-  const cache = {};
-  let default_pstyle = null;
-  const raw_styles = {};
-  const stylesPart = pkg?.getPartByPath("word/styles.xml");
-  if (!stylesPart) {
-    const result2 = [cache, null];
-    if (pkg) pkg._adeu_style_cache = result2;
-    return result2;
+// src/comments.ts
+var NS = {
+  w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
+  w14: "http://schemas.microsoft.com/office/word/2010/wordml",
+  w15: "http://schemas.microsoft.com/office/word/2012/wordml",
+  w16cid: "http://schemas.microsoft.com/office/word/2016/wordml/cid",
+  w16cex: "http://schemas.microsoft.com/office/word/2018/wordml/cex",
+  mc: "http://schemas.openxmlformats.org/markup-compatibility/2006"
+};
+var CT = {
+  COMMENTS: "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
+  EXTENDED: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml",
+  IDS: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsIds+xml",
+  EXTENSIBLE: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtensible+xml"
+};
+var RT = {
+  COMMENTS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
+  EXTENDED: "http://schemas.microsoft.com/office/2011/relationships/commentsExtended",
+  IDS: "http://schemas.microsoft.com/office/2016/09/relationships/commentsIds",
+  EXTENSIBLE: "http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible"
+};
+var CommentsManager = class {
+  constructor(doc) {
+    this.doc = doc;
   }
-  const styles = findAllDescendants(stylesPart._element, "w:style");
-  for (const s of styles) {
-    const s_id = s.getAttribute("w:styleId");
-    if (!s_id) continue;
-    const s_type = s.getAttribute("w:type");
-    const is_default = s.getAttribute("w:default") === "1" || s.getAttribute("w:default") === "true";
-    if (s_type === "paragraph" && is_default) default_pstyle = s_id;
-    const name_el = findChild(s, "w:name");
-    const name = name_el ? name_el.getAttribute("w:val") : s_id;
-    const based_on_el = findChild(s, "w:basedOn");
-    const based_on = based_on_el ? based_on_el.getAttribute("w:val") : null;
-    let outline_lvl = null;
-    const pPr = findChild(s, "w:pPr");
-    if (pPr) {
-      const oLvl = findChild(pPr, "w:outlineLvl");
-      if (oLvl) {
-        const val = oLvl.getAttribute("w:val");
-        if (val && /^\d+$/.test(val)) outline_lvl = parseInt(val, 10);
-      }
-    }
-    let bold = null;
-    const rPr = findChild(s, "w:rPr");
-    if (rPr) {
-      const b = findChild(rPr, "w:b");
-      if (b) {
-        const val = b.getAttribute("w:val");
-        bold = val !== "0" && val !== "false" && val !== "off";
-      }
+  doc;
+  _commentsPart = null;
+  _extendedPart = null;
+  _idsPart = null;
+  _extensiblePart = null;
+  _nextId = null;
+  get commentsPart() {
+    if (!this._commentsPart) {
+      this._commentsPart = this._getOrCreateCommentsPart();
+      this._ensureNamespaces();
     }
-    raw_styles[s_id] = { name, based_on, outline_level: outline_lvl, bold };
+    return this._commentsPart;
   }
-  const resolve_style = (s_id, visited) => {
-    if (cache[s_id]) return cache[s_id];
-    if (visited.has(s_id) || !raw_styles[s_id]) return { name: s_id, outline_level: null, bold: false };
-    visited.add(s_id);
-    const raw = raw_styles[s_id];
-    const based_on_id = raw.based_on;
-    let o_lvl = raw.outline_level;
-    let bold_val = raw.bold !== null ? raw.bold : false;
-    if (based_on_id) {
-      const parent = resolve_style(based_on_id, visited);
-      if (o_lvl === null) o_lvl = parent.outline_level;
-      if (raw.bold === null) bold_val = parent.bold;
-    }
-    const resolved = { name: raw.name, outline_level: o_lvl, bold: bold_val };
-    cache[s_id] = resolved;
-    return resolved;
-  };
-  for (const s_id in raw_styles) resolve_style(s_id, /* @__PURE__ */ new Set());
-  const result = [cache, default_pstyle];
-  if (pkg) pkg._adeu_style_cache = result;
-  return result;
-}
-function _detect_heading_level_from_name(name) {
-  if (!name) return null;
-  const match = name.match(_CUSTOM_HEADING_NAME_RE);
-  return match ? parseInt(match[1], 10) : null;
-}
-function is_native_heading(paragraph, style_cache, default_pstyle) {
-  if (!style_cache) {
-    [style_cache, default_pstyle] = _get_style_cache(paragraph._parent.part || paragraph._parent);
+  get extendedPart() {
+    if (!this._extendedPart) this._extendedPart = this._getOrCreateExtendedPart();
+    return this._extendedPart;
   }
-  const pPr = findChild(paragraph._element, QN_W_PPR);
-  if (pPr) {
-    const oLvl = findChild(pPr, QN_W_OUTLINELVL);
-    if (oLvl) {
-      const val = oLvl.getAttribute(QN_W_VAL);
-      if (val && /^\d+$/.test(val)) {
-        const lvl = parseInt(val, 10);
-        if (lvl >= 0 && lvl <= 8) return true;
-      }
-    }
+  get idsPart() {
+    if (!this._idsPart) this._idsPart = this._getOrCreateIdsPart();
+    return this._idsPart;
   }
-  let style_id = default_pstyle;
-  if (pPr) {
-    const pStyle = findChild(pPr, QN_W_PSTYLE);
-    if (pStyle) style_id = pStyle.getAttribute(QN_W_VAL) || default_pstyle;
+  get extensiblePart() {
+    if (!this._extensiblePart) this._extensiblePart = this._getOrCreateExtensiblePart();
+    return this._extensiblePart;
   }
-  const style_info = style_id && style_cache ? style_cache[style_id] : null;
-  if (style_info && style_info.outline_level !== null && style_info.outline_level >= 0 && style_info.outline_level <= 8) {
-    return true;
+  get nextId() {
+    if (this._nextId === null) this._nextId = this._getNextCommentId();
+    return this._nextId;
   }
-  const style_name = style_info ? style_info.name : null;
-  if (style_name?.startsWith("Heading")) return true;
-  if (style_name === "Title") return true;
-  if (style_name && style_name !== "Normal") {
-    if (_detect_heading_level_from_name(style_name) !== null) return true;
+  set nextId(value) {
+    this._nextId = value;
   }
-  return false;
-}
-function get_paragraph_prefix(paragraph, style_cache, default_pstyle) {
-  if (!style_cache) {
-    [style_cache, default_pstyle] = _get_style_cache(paragraph._parent.part || paragraph._parent);
+  _getExistingPartByType(contentType) {
+    return this.doc.pkg.parts.find((p) => p.contentType === contentType) || null;
   }
-  const pPr = findChild(paragraph._element, QN_W_PPR);
-  if (pPr) {
-    const oLvl = findChild(pPr, QN_W_OUTLINELVL);
-    if (oLvl) {
-      const val = oLvl.getAttribute(QN_W_VAL);
-      if (val && /^\d+$/.test(val)) {
-        const lvl = parseInt(val, 10);
-        if (lvl >= 0 && lvl <= 8) return "#".repeat(lvl + 1) + " ";
+  _linkPart(part, relType) {
+    for (const rel of this.doc.part.rels.values()) {
+      if (!rel.isExternal && rel.target === part.partname.split("/").pop()) {
+        return part;
       }
     }
+    this.doc.relateTo(part, relType);
+    return part;
   }
-  let style_id = default_pstyle;
-  if (pPr) {
-    const pStyle = findChild(pPr, QN_W_PSTYLE);
-    if (pStyle) style_id = pStyle.getAttribute(QN_W_VAL) || default_pstyle;
+  _getOrCreateCommentsPart() {
+    let part = this._getExistingPartByType(CT.COMMENTS);
+    if (part) return this._linkPart(part, RT.COMMENTS);
+    const partname = this.doc.pkg.nextPartname("/word/comments%d.xml");
+    const xml = `<w:comments xmlns:w="${NS.w}" xmlns:w14="${NS.w14}" xmlns:w15="${NS.w15}" xmlns:w16cid="${NS.w16cid}" xmlns:w16cex="${NS.w16cex}" xmlns:mc="${NS.mc}" mc:Ignorable="w14 w15 w16cid w16cex"></w:comments>`;
+    part = this.doc.pkg.addPart(partname, CT.COMMENTS, xml);
+    this.doc.relateTo(part, RT.COMMENTS);
+    return part;
   }
-  const style_info = style_id && style_cache ? style_cache[style_id] : null;
-  if (style_info && style_info.outline_level !== null && style_info.outline_level >= 0 && style_info.outline_level <= 8) {
-    return "#".repeat(style_info.outline_level + 1) + " ";
+  _getOrCreateExtendedPart() {
+    let part = this._getExistingPartByType(CT.EXTENDED);
+    if (part) return this._linkPart(part, RT.EXTENDED);
+    const partname = this.doc.pkg.nextPartname("/word/commentsExtended%d.xml");
+    const xml = `<w15:commentsEx xmlns:w15="${NS.w15}"></w15:commentsEx>`;
+    part = this.doc.pkg.addPart(partname, CT.EXTENDED, xml);
+    this.doc.relateTo(part, RT.EXTENDED);
+    return part;
   }
-  const style_name = style_info ? style_info.name : null;
-  if (style_name?.startsWith("Heading")) {
-    const match = style_name.replace("Heading", "").trim();
-    if (/^\d+$/.test(match)) return "#".repeat(parseInt(match, 10)) + " ";
+  _getOrCreateIdsPart() {
+    let part = this._getExistingPartByType(CT.IDS);
+    if (part) return this._linkPart(part, RT.IDS);
+    const partname = this.doc.pkg.nextPartname("/word/commentsIds%d.xml");
+    const xml = `<w16cid:commentsIds xmlns:w16cid="${NS.w16cid}"></w16cid:commentsIds>`;
+    part = this.doc.pkg.addPart(partname, CT.IDS, xml);
+    this.doc.relateTo(part, RT.IDS);
+    return part;
   }
-  if (style_name === "Title") return "# ";
-  if (pPr) {
-    const numPr = findChild(pPr, QN_W_NUMPR);
-    if (numPr) {
-      const numId = findChild(numPr, QN_W_NUMID);
-      if (numId && numId.getAttribute(QN_W_VAL) !== "0") {
-        let level = 0;
-        const ilvl = findChild(numPr, QN_W_ILVL);
-        if (ilvl) {
-          const valAttr = ilvl.getAttribute(QN_W_VAL);
-          if (valAttr) level = parseInt(valAttr, 10) || 0;
-        }
-        return "    ".repeat(level) + "* ";
-      }
-    }
+  _getOrCreateExtensiblePart() {
+    let part = this._getExistingPartByType(CT.EXTENSIBLE);
+    if (part) return this._linkPart(part, RT.EXTENSIBLE);
+    const partname = this.doc.pkg.nextPartname("/word/commentsExtensible%d.xml");
+    const xml = `<w16cex:commentsExtensible xmlns:w16cex="${NS.w16cex}"></w16cex:commentsExtensible>`;
+    part = this.doc.pkg.addPart(partname, CT.EXTENSIBLE, xml);
+    this.doc.relateTo(part, RT.EXTENSIBLE);
+    return part;
   }
-  if (style_name && style_name !== "Normal") {
-    const custom_level = _detect_heading_level_from_name(style_name);
-    if (custom_level !== null) return "#".repeat(custom_level) + " ";
+  _ensureNamespaces() {
   }
-  if (!style_name || style_name === "Normal") {
-    const text = paragraph.text.trim();
-    if (text && text.length < 100 && text === text.toUpperCase()) {
-      let is_bold = false;
-      if (style_info?.bold) {
-        is_bold = true;
-      } else {
-        const runs = findAllDescendants(paragraph._element, QN_W_R);
-        for (const r of runs) {
-          const tList = findAllDescendants(r, QN_W_T);
-          const tText = tList.map((t) => t.textContent || "").join("");
-          if (tText.trim()) {
-            const rPr_run = findChild(r, QN_W_RPR);
-            if (rPr_run) {
-              const b = findChild(rPr_run, QN_W_B);
-              if (b && b.getAttribute(QN_W_VAL) !== "0" && b.getAttribute(QN_W_VAL) !== "false") {
-                is_bold = true;
-              }
-            }
-            break;
-          }
-        }
+  _getNextCommentId() {
+    const ids = [0];
+    const part = this._getExistingPartByType(CT.COMMENTS);
+    if (part) {
+      const comments = findAllDescendants(part._element, "w:comment");
+      for (const c of comments) {
+        const idStr = c.getAttribute("w:id");
+        if (idStr) ids.push(parseInt(idStr, 10) || 0);
       }
-      if (is_bold) return "## ";
-    }
-  }
-  return "";
-}
-function is_heading_paragraph(paragraph, style_cache, default_pstyle) {
-  const prefix = get_paragraph_prefix(paragraph, style_cache, default_pstyle);
-  if (!prefix) return false;
-  const stripped = prefix.trimEnd();
-  return stripped.length > 0 && stripped === "#".repeat(stripped.length);
-}
-function get_run_style_markers(run, is_heading = null) {
-  let prefix = "";
-  let suffix = "";
-  const rPr = findChild(run._element, QN_W_RPR);
-  let is_bold = false;
-  let is_italic = false;
-  if (rPr) {
-    const b = findChild(rPr, QN_W_B);
-    if (b && b.getAttribute(QN_W_VAL) !== "0" && b.getAttribute(QN_W_VAL) !== "false") is_bold = true;
-    const i = findChild(rPr, QN_W_I);
-    if (i && i.getAttribute(QN_W_VAL) !== "0" && i.getAttribute(QN_W_VAL) !== "false") is_italic = true;
-  }
-  if (is_heading === null) {
-    const parent = run._parent;
-    is_heading = parent instanceof Paragraph ? is_native_heading(parent) : false;
-  }
-  if (is_bold && !is_heading) {
-    prefix += "**";
-    suffix = "**" + suffix;
-  }
-  if (is_italic) {
-    prefix += "_";
-    suffix = "_" + suffix;
-  }
-  return [prefix, suffix];
-}
-function apply_formatting_to_segments(text, prefix, suffix) {
-  if (!prefix && !suffix) return text;
-  if (!text) return "";
-  if (!text.includes("\n")) return `${prefix}${text}${suffix}`;
-  const parts = text.split("\n");
-  return parts.map((p) => p ? `${prefix}${p}${suffix}` : "").join("\n");
-}
-function get_run_text(run) {
-  let text = "";
-  for (let i = 0; i < run._element.childNodes.length; i++) {
-    const child = run._element.childNodes[i];
-    if (child.nodeType !== 1) continue;
-    if (child.tagName === QN_W_T || child.tagName === QN_W_DELTEXT) {
-      const raw = child.textContent || "";
-      text += raw.replace(/\t/g, " ");
-    } else if (child.tagName === QN_W_TAB) {
-      text += " ";
-    } else if (child.tagName === QN_W_BR || child.tagName === QN_W_CR) {
-      text += "\n";
     }
+    return Math.max(...ids) + 1;
   }
-  return text;
-}
-function* iter_block_items(parent) {
-  const parent_elm = parent._element || parent.element || parent;
-  if (parent.constructor.name === "NotesPart") {
-    const tag = parent.note_type === "fn" ? "w:footnote" : "w:endnote";
-    const notes = findAllDescendants(parent_elm, tag);
-    for (const child of notes) {
-      if (child.getAttribute("w:type") === "separator" || child.getAttribute("w:type") === "continuationSeparator") continue;
-      yield new FootnoteItem(child, parent, parent.note_type);
-    }
-    return;
+  _generateHexId() {
+    return Math.floor(Math.random() * 4294967295).toString(16).toUpperCase().padStart(8, "0");
   }
-  for (let i = 0; i < parent_elm.childNodes.length; i++) {
-    const child = parent_elm.childNodes[i];
-    if (child.nodeType !== 1) continue;
-    if (child.tagName === QN_W_P) {
-      yield new Paragraph(child, parent);
-    } else if (child.tagName === "w:tbl") {
-      yield new Table(child, parent);
-    }
+  _getInitials(author) {
+    if (!author) return "";
+    return author.split(" ").filter(Boolean).map((p) => p[0]).join("").toUpperCase();
   }
-}
-function* iter_document_parts(doc) {
-  yield doc;
-  const fnPart = doc.pkg.getPartByPath("word/footnotes.xml");
-  const enPart = doc.pkg.getPartByPath("word/endnotes.xml");
-  if (fnPart) yield new NotesPart(fnPart, "fn");
-  if (enPart) yield new NotesPart(enPart, "en");
-}
-function _is_page_instr(instr) {
-  if (!instr) return false;
-  const parts = instr.toUpperCase().trim().split(/\s+/);
-  return parts.length > 0 && (parts[0] === "PAGE" || parts[0] === "NUMPAGES");
-}
-function* iter_paragraph_content(paragraph) {
-  let in_complex_field = false;
-  let current_instr = "";
-  let hide_result = false;
-  function* process_run_element(r_element) {
-    let c_id = null;
-    const rPr = findChild(r_element, QN_W_RPR);
-    if (rPr) {
-      const rPrChange = findChild(rPr, QN_W_RPRCHANGE);
-      if (rPrChange) {
-        c_id = rPrChange.getAttribute(QN_W_ID);
-        yield { type: "fmt_start", id: c_id, author: rPrChange.getAttribute(QN_W_AUTHOR) || void 0, date: rPrChange.getAttribute(QN_W_DATE) || void 0 };
-      }
-    }
-    for (let i = 0; i < r_element.childNodes.length; i++) {
-      const child = r_element.childNodes[i];
-      if (child.nodeType !== 1) continue;
-      const tag = child.tagName;
-      if (tag === QN_W_COMMENTREFERENCE) {
-        const ref_id = child.getAttribute(QN_W_ID);
-        if (ref_id) yield { type: "ref", id: ref_id };
-      } else if (tag === QN_W_FOOTNOTEREFERENCE) {
-        const f_id = child.getAttribute(QN_W_ID);
-        if (f_id) yield { type: "footnote", id: f_id };
-      } else if (tag === QN_W_ENDNOTEREFERENCE) {
-        const e_id = child.getAttribute(QN_W_ID);
-        if (e_id) yield { type: "endnote", id: e_id };
-      } else if (tag === QN_W_FLDCHAR) {
-        const fld_type = child.getAttribute(QN_W_FLDCHARTYPE);
-        if (fld_type === "begin") {
-          in_complex_field = true;
-          current_instr = "";
-        } else if (fld_type === "separate") {
-          if (_is_page_instr(current_instr)) hide_result = true;
-          else {
-            const parts = current_instr.trim().split(/\s+/);
-            if (parts.length > 1 && parts[0] === "REF") yield { type: "xref_start", id: parts[1] };
-          }
-        } else if (fld_type === "end") {
-          if (!hide_result) {
-            const parts = current_instr.trim().split(/\s+/);
-            if (parts.length > 1 && parts[0] === "REF") yield { type: "xref_end", id: parts[1] };
-          }
-          in_complex_field = false;
-          current_instr = "";
-          hide_result = false;
+  _findParaIdForComment(commentId) {
+    if (!this._commentsPart) return null;
+    for (const c of findAllDescendants(this._commentsPart._element, "w:comment")) {
+      if (c.getAttribute("w:id") === commentId) {
+        for (const p of findAllDescendants(c, "w:p")) {
+          const pid = p.getAttribute("w14:paraId");
+          if (pid) return pid;
         }
-      } else if (tag === QN_W_INSTRTEXT && in_complex_field && !hide_result) {
-        current_instr += child.textContent || "";
       }
     }
-    if (!hide_result) yield new Run(r_element, paragraph);
-    if (c_id !== null) yield { type: "fmt_end", id: c_id };
+    return null;
   }
-  function* traverse_node(node) {
-    for (let i = 0; i < node.childNodes.length; i++) {
-      const child = node.childNodes[i];
+  _findThreadRootParaId(commentId) {
+    const directParaId = this._findParaIdForComment(commentId);
+    const extPart = this._getExistingPartByType(CT.EXTENDED);
+    if (!directParaId || !extPart) return directParaId;
+    for (let i = 0; i < extPart._element.childNodes.length; i++) {
+      const child = extPart._element.childNodes[i];
       if (child.nodeType !== 1) continue;
-      const tag = child.tagName;
-      if (tag === QN_W_R) yield* process_run_element(child);
-      else if (tag === QN_W_INS) {
-        const i_id = child.getAttribute(QN_W_ID);
-        yield { type: "ins_start", id: i_id, author: child.getAttribute(QN_W_AUTHOR) || void 0, date: child.getAttribute(QN_W_DATE) || void 0 };
-        yield* traverse_node(child);
-        yield { type: "ins_end", id: i_id };
-      } else if (tag === QN_W_DEL) {
-        const d_id = child.getAttribute(QN_W_ID);
-        yield { type: "del_start", id: d_id, author: child.getAttribute(QN_W_AUTHOR) || void 0, date: child.getAttribute(QN_W_DATE) || void 0 };
-        yield* traverse_node(child);
-        yield { type: "del_end", id: d_id };
-      } else if (tag === QN_W_COMMENTRANGESTART) yield { type: "start", id: child.getAttribute(QN_W_ID) };
-      else if (tag === QN_W_COMMENTRANGEEND) yield { type: "end", id: child.getAttribute(QN_W_ID) };
-      else if (tag === QN_W_HYPERLINK) {
-        const rId = child.getAttribute(QN_R_ID);
-        let url = "";
-        if (rId && paragraph._parent.part) {
-          const rel = paragraph._parent.part.rels.get(rId);
-          if (rel && rel.isExternal) url = rel.target;
-        }
-        if (url) yield { type: "hyperlink_start", id: rId, date: url };
-        yield* traverse_node(child);
-        if (url) yield { type: "hyperlink_end", id: rId, date: url };
-      } else if (tag === QN_W_FLDSIMPLE) {
-        const instr = child.getAttribute(QN_W_INSTR) || "";
-        const parts = instr.trim().split(/\s+/);
-        const target = parts.length > 1 && parts[0] === "REF" ? parts[1] : "";
-        if (target) yield { type: "xref_start", id: target };
-        yield* traverse_node(child);
-        if (target) yield { type: "xref_end", id: target };
-      } else if (tag === QN_W_BOOKMARKSTART) {
-        const b_name = child.getAttribute(QN_W_NAME);
-        if (b_name && (!b_name.startsWith("_") || b_name.startsWith("_Ref"))) yield { type: "bookmark", id: b_name };
-      } else if (tag === QN_W_SDT || tag === QN_W_SMARTTAG || tag === QN_W_SDTCONTENT) {
-        yield* traverse_node(child);
+      if (child.getAttribute("w15:paraId") === directParaId) {
+        const parent = child.getAttribute("w15:paraIdParent");
+        if (parent) return parent;
       }
     }
-  }
-  yield* traverse_node(paragraph._element);
-}
-
-// src/domain.ts
-function build_structural_appendix(doc, base_text) {
-  return "";
-}
-
-// src/comments.ts
-var NS = {
-  w: "http://schemas.openxmlformats.org/wordprocessingml/2006/main",
-  w14: "http://schemas.microsoft.com/office/word/2010/wordml",
-  w15: "http://schemas.microsoft.com/office/word/2012/wordml",
-  w16cid: "http://schemas.microsoft.com/office/word/2016/wordml/cid",
-  w16cex: "http://schemas.microsoft.com/office/word/2018/wordml/cex",
-  mc: "http://schemas.openxmlformats.org/markup-compatibility/2006"
-};
-var CT = {
-  COMMENTS: "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml",
-  EXTENDED: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml",
-  IDS: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsIds+xml",
-  EXTENSIBLE: "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtensible+xml"
-};
-var RT = {
-  COMMENTS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments",
-  EXTENDED: "http://schemas.microsoft.com/office/2011/relationships/commentsExtended",
-  IDS: "http://schemas.microsoft.com/office/2016/09/relationships/commentsIds",
-  EXTENSIBLE: "http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible"
-};
-var CommentsManager = class {
-  constructor(doc) {
-    this.doc = doc;
-  }
-  doc;
-  _commentsPart = null;
-  _extendedPart = null;
-  _idsPart = null;
-  _extensiblePart = null;
-  _nextId = null;
-  get commentsPart() {
-    if (!this._commentsPart) {
-      this._commentsPart = this._getOrCreateCommentsPart();
-      this._ensureNamespaces();
-    }
-    return this._commentsPart;
-  }
-  get extendedPart() {
-    if (!this._extendedPart) this._extendedPart = this._getOrCreateExtendedPart();
-    return this._extendedPart;
-  }
-  get idsPart() {
-    if (!this._idsPart) this._idsPart = this._getOrCreateIdsPart();
-    return this._idsPart;
-  }
-  get extensiblePart() {
-    if (!this._extensiblePart) this._extensiblePart = this._getOrCreateExtensiblePart();
-    return this._extensiblePart;
-  }
-  get nextId() {
-    if (this._nextId === null) this._nextId = this._getNextCommentId();
-    return this._nextId;
-  }
-  set nextId(value) {
-    this._nextId = value;
-  }
-  _getExistingPartByType(contentType) {
-    return this.doc.pkg.parts.find((p) => p.contentType === contentType) || null;
-  }
-  _linkPart(part, relType) {
-    for (const rel of this.doc.part.rels.values()) {
-      if (!rel.isExternal && rel.target === part.partname.split("/").pop()) {
-        return part;
-      }
-    }
-    this.doc.relateTo(part, relType);
-    return part;
-  }
-  _getOrCreateCommentsPart() {
-    let part = this._getExistingPartByType(CT.COMMENTS);
-    if (part) return this._linkPart(part, RT.COMMENTS);
-    const partname = this.doc.pkg.nextPartname("/word/comments%d.xml");
-    const xml = `<w:comments xmlns:w="${NS.w}" xmlns:w14="${NS.w14}" xmlns:w15="${NS.w15}" xmlns:w16cid="${NS.w16cid}" xmlns:w16cex="${NS.w16cex}" xmlns:mc="${NS.mc}" mc:Ignorable="w14 w15 w16cid w16cex"></w:comments>`;
-    part = this.doc.pkg.addPart(partname, CT.COMMENTS, xml);
-    this.doc.relateTo(part, RT.COMMENTS);
-    return part;
-  }
-  _getOrCreateExtendedPart() {
-    let part = this._getExistingPartByType(CT.EXTENDED);
-    if (part) return this._linkPart(part, RT.EXTENDED);
-    const partname = this.doc.pkg.nextPartname("/word/commentsExtended%d.xml");
-    const xml = `<w15:commentsEx xmlns:w15="${NS.w15}"></w15:commentsEx>`;
-    part = this.doc.pkg.addPart(partname, CT.EXTENDED, xml);
-    this.doc.relateTo(part, RT.EXTENDED);
-    return part;
-  }
-  _getOrCreateIdsPart() {
-    let part = this._getExistingPartByType(CT.IDS);
-    if (part) return this._linkPart(part, RT.IDS);
-    const partname = this.doc.pkg.nextPartname("/word/commentsIds%d.xml");
-    const xml = `<w16cid:commentsIds xmlns:w16cid="${NS.w16cid}"></w16cid:commentsIds>`;
-    part = this.doc.pkg.addPart(partname, CT.IDS, xml);
-    this.doc.relateTo(part, RT.IDS);
-    return part;
-  }
-  _getOrCreateExtensiblePart() {
-    let part = this._getExistingPartByType(CT.EXTENSIBLE);
-    if (part) return this._linkPart(part, RT.EXTENSIBLE);
-    const partname = this.doc.pkg.nextPartname("/word/commentsExtensible%d.xml");
-    const xml = `<w16cex:commentsExtensible xmlns:w16cex="${NS.w16cex}"></w16cex:commentsExtensible>`;
-    part = this.doc.pkg.addPart(partname, CT.EXTENSIBLE, xml);
-    this.doc.relateTo(part, RT.EXTENSIBLE);
-    return part;
-  }
-  _ensureNamespaces() {
-  }
-  _getNextCommentId() {
-    const ids = [0];
-    const part = this._getExistingPartByType(CT.COMMENTS);
-    if (part) {
-      const comments = findAllDescendants(part._element, "w:comment");
-      for (const c of comments) {
-        const idStr = c.getAttribute("w:id");
-        if (idStr) ids.push(parseInt(idStr, 10) || 0);
-      }
-    }
-    return Math.max(...ids) + 1;
-  }
-  _generateHexId() {
-    return Math.floor(Math.random() * 4294967295).toString(16).toUpperCase().padStart(8, "0");
-  }
-  _getInitials(author) {
-    if (!author) return "";
-    return author.split(" ").filter(Boolean).map((p) => p[0]).join("").toUpperCase();
-  }
-  _findParaIdForComment(commentId) {
-    if (!this._commentsPart) return null;
-    for (const c of findAllDescendants(this._commentsPart._element, "w:comment")) {
-      if (c.getAttribute("w:id") === commentId) {
-        for (const p of findAllDescendants(c, "w:p")) {
-          const pid = p.getAttribute("w14:paraId");
-          if (pid) return pid;
-        }
-      }
-    }
-    return null;
-  }
-  _findThreadRootParaId(commentId) {
-    const directParaId = this._findParaIdForComment(commentId);
-    const extPart = this._getExistingPartByType(CT.EXTENDED);
-    if (!directParaId || !extPart) return directParaId;
-    for (let i = 0; i < extPart._element.childNodes.length; i++) {
-      const child = extPart._element.childNodes[i];
-      if (child.nodeType !== 1) continue;
-      if (child.getAttribute("w15:paraId") === directParaId) {
-        const parent = child.getAttribute("w15:paraIdParent");
-        if (parent) return parent;
-      }
-    }
-    return directParaId;
+    return directParaId;
   }
   addComment(author, text, parentId = null) {
     const commentId = this.nextId.toString();
@@ -1068,377 +671,458 @@ function extract_comments_data(pkg) {
   return data;
 }
 
-// src/ingest.ts
-async function extractTextFromBuffer(buffer, cleanView = false) {
-  const doc = await DocumentObject.load(buffer);
-  return _extractTextFromDoc(doc, cleanView);
-}
-function _extractTextFromDoc(doc, cleanView = false, includeAppendix = true) {
-  const comments_map = extract_comments_data(doc.pkg);
-  const full_text = [];
-  let cursor = 0;
-  for (const part of iter_document_parts(doc)) {
-    const part_cursor = full_text.length > 0 ? cursor + 2 : cursor;
-    const part_text = _extract_blocks(part, comments_map, cleanView, part_cursor);
-    if (part_text) {
-      if (full_text.length > 0) cursor += 2;
-      full_text.push(part_text);
-      cursor += part_text.length;
-    }
+// src/utils/docx.ts
+var QN_W_P = "w:p";
+var QN_W_R = "w:r";
+var QN_W_T = "w:t";
+var QN_W_DELTEXT = "w:delText";
+var QN_W_TAB = "w:tab";
+var QN_W_BR = "w:br";
+var QN_W_CR = "w:cr";
+var QN_W_RPR = "w:rPr";
+var QN_W_RPRCHANGE = "w:rPrChange";
+var QN_W_COMMENTREFERENCE = "w:commentReference";
+var QN_W_FOOTNOTEREFERENCE = "w:footnoteReference";
+var QN_W_ENDNOTEREFERENCE = "w:endnoteReference";
+var QN_W_FLDCHAR = "w:fldChar";
+var QN_W_FLDCHARTYPE = "w:fldCharType";
+var QN_W_INSTRTEXT = "w:instrText";
+var QN_W_INS = "w:ins";
+var QN_W_DEL = "w:del";
+var QN_W_ID = "w:id";
+var QN_W_AUTHOR = "w:author";
+var QN_W_DATE = "w:date";
+var QN_W_COMMENTRANGESTART = "w:commentRangeStart";
+var QN_W_COMMENTRANGEEND = "w:commentRangeEnd";
+var QN_W_HYPERLINK = "w:hyperlink";
+var QN_R_ID = "r:id";
+var QN_W_FLDSIMPLE = "w:fldSimple";
+var QN_W_INSTR = "w:instr";
+var QN_W_BOOKMARKSTART = "w:bookmarkStart";
+var QN_W_NAME = "w:name";
+var QN_W_SDT = "w:sdt";
+var QN_W_SMARTTAG = "w:smartTag";
+var QN_W_SDTCONTENT = "w:sdtContent";
+var QN_W_B = "w:b";
+var QN_W_I = "w:i";
+var QN_W_VAL = "w:val";
+var QN_W_PPR = "w:pPr";
+var QN_W_PSTYLE = "w:pStyle";
+var QN_W_OUTLINELVL = "w:outlineLvl";
+var QN_W_NUMPR = "w:numPr";
+var QN_W_NUMID = "w:numId";
+var QN_W_ILVL = "w:ilvl";
+var _CUSTOM_HEADING_NAME_RE = /Heading[ ]?([1-6])(?![0-9])/;
+function _get_style_cache(part) {
+  const pkg = part.package || part.pkg || (part.part ? part.part.pkg : null);
+  if (pkg && pkg._adeu_style_cache) {
+    return pkg._adeu_style_cache;
   }
-  let base_text = full_text.join("\n\n");
-  if (includeAppendix) {
-    const appendix = build_structural_appendix(doc, base_text);
-    if (appendix) base_text += appendix;
+  const cache = {};
+  let default_pstyle = null;
+  const raw_styles = {};
+  const stylesPart = pkg?.getPartByPath("word/styles.xml");
+  if (!stylesPart) {
+    const result2 = [cache, null];
+    if (pkg) pkg._adeu_style_cache = result2;
+    return result2;
   }
-  return base_text;
-}
-function _extract_blocks(container, comments_map, cleanView, cursor) {
-  const part = container.part || container;
-  const [style_cache, default_pstyle] = _get_style_cache(part);
-  const blocks = [];
-  let local_cursor = cursor;
-  let is_first_block = true;
-  let is_first_para = true;
-  for (const item of iter_block_items(container)) {
-    if (!is_first_block) local_cursor += 2;
-    const block_start = local_cursor;
-    if (item.constructor.name === "FootnoteItem") {
-      const fn_text = _extract_blocks(item, comments_map, cleanView, block_start);
-      if (fn_text) {
-        blocks.push(fn_text);
-        local_cursor = block_start + fn_text.length;
-        is_first_block = false;
-      } else if (!is_first_block) {
-        local_cursor -= 2;
-      }
-    } else if (item instanceof Paragraph) {
-      let prefix = get_paragraph_prefix(item, style_cache, default_pstyle);
-      if (is_first_para && container.constructor.name === "FootnoteItem") {
-        prefix = `[^${container.note_type}-${container.id}]: ` + prefix;
+  const styles = findAllDescendants(stylesPart._element, "w:style");
+  for (const s of styles) {
+    const s_id = s.getAttribute("w:styleId");
+    if (!s_id) continue;
+    const s_type = s.getAttribute("w:type");
+    const is_default = s.getAttribute("w:default") === "1" || s.getAttribute("w:default") === "true";
+    if (s_type === "paragraph" && is_default) default_pstyle = s_id;
+    const name_el = findChild(s, "w:name");
+    const name = name_el ? name_el.getAttribute("w:val") : s_id;
+    const based_on_el = findChild(s, "w:basedOn");
+    const based_on = based_on_el ? based_on_el.getAttribute("w:val") : null;
+    let outline_lvl = null;
+    const pPr = findChild(s, "w:pPr");
+    if (pPr) {
+      const oLvl = findChild(pPr, "w:outlineLvl");
+      if (oLvl) {
+        const val = oLvl.getAttribute("w:val");
+        if (val && /^\d+$/.test(val)) outline_lvl = parseInt(val, 10);
       }
-      const p_text = build_paragraph_text(item, comments_map, cleanView, style_cache, default_pstyle);
-      const full_block = prefix + p_text;
-      blocks.push(full_block);
-      local_cursor = block_start + full_block.length;
-      is_first_para = false;
-      is_first_block = false;
-    } else if (item instanceof Table) {
-      const table_text = extract_table(item, comments_map, cleanView, block_start);
-      if (table_text) {
-        blocks.push(table_text);
-        local_cursor = block_start + table_text.length;
-        is_first_block = false;
-      } else if (!is_first_block) {
-        local_cursor -= 2;
+    }
+    let bold = null;
+    const rPr = findChild(s, "w:rPr");
+    if (rPr) {
+      const b = findChild(rPr, "w:b");
+      if (b) {
+        const val = b.getAttribute("w:val");
+        bold = val !== "0" && val !== "false" && val !== "off";
       }
-      is_first_para = false;
     }
+    raw_styles[s_id] = { name, based_on, outline_level: outline_lvl, bold };
   }
-  return blocks.join("\n\n");
-}
-function extract_table(table, comments_map, cleanView, cursor) {
-  const rows_text = [];
-  let rows_processed = 0;
-  let local_cursor = cursor;
-  for (const row of table.rows) {
-    const cell_texts = [];
-    const seen_cells = /* @__PURE__ */ new Set();
-    const trPr = findChild(row._element, "w:trPr");
-    const ins = trPr ? findChild(trPr, "w:ins") : null;
-    const del_node = trPr ? findChild(trPr, "w:del") : null;
-    if (cleanView && del_node) continue;
-    const row_start = local_cursor + (rows_processed > 0 ? 1 : 0);
-    const wrapper_prefix_len = !cleanView && ins ? 4 : !cleanView && del_node ? 4 : 0;
-    let cell_cursor = row_start + wrapper_prefix_len;
-    let first_cell = true;
-    for (const cell of row.cells) {
-      if (seen_cells.has(cell)) continue;
-      seen_cells.add(cell);
-      if (!first_cell) cell_cursor += 3;
-      const cell_content = _extract_blocks(cell, comments_map, cleanView, cell_cursor);
-      cell_texts.push(cell_content);
-      cell_cursor += cell_content.length;
-      first_cell = false;
+  const resolve_style = (s_id, visited) => {
+    if (cache[s_id]) return cache[s_id];
+    if (visited.has(s_id) || !raw_styles[s_id]) return { name: s_id, outline_level: null, bold: false };
+    visited.add(s_id);
+    const raw = raw_styles[s_id];
+    const based_on_id = raw.based_on;
+    let o_lvl = raw.outline_level;
+    let bold_val = raw.bold !== null ? raw.bold : false;
+    if (based_on_id) {
+      const parent = resolve_style(based_on_id, visited);
+      if (o_lvl === null) o_lvl = parent.outline_level;
+      if (raw.bold === null) bold_val = parent.bold;
     }
-    let row_str = cell_texts.join(" | ");
-    if (!cleanView) {
-      if (ins) row_str = `{++ ${row_str} |Chg:${ins.getAttribute("w:id")}++}`;
-      else if (del_node) row_str = `{-- ${row_str} |Chg:${del_node.getAttribute("w:id")}--}`;
+    const resolved = { name: raw.name, outline_level: o_lvl, bold: bold_val };
+    cache[s_id] = resolved;
+    return resolved;
+  };
+  for (const s_id in raw_styles) resolve_style(s_id, /* @__PURE__ */ new Set());
+  const result = [cache, default_pstyle];
+  if (pkg) pkg._adeu_style_cache = result;
+  return result;
+}
+function _detect_heading_level_from_name(name) {
+  if (!name) return null;
+  const match = name.match(_CUSTOM_HEADING_NAME_RE);
+  return match ? parseInt(match[1], 10) : null;
+}
+function is_native_heading(paragraph, style_cache, default_pstyle) {
+  if (!style_cache) {
+    [style_cache, default_pstyle] = _get_style_cache(paragraph._parent.part || paragraph._parent);
+  }
+  const pPr = findChild(paragraph._element, QN_W_PPR);
+  if (pPr) {
+    const oLvl = findChild(pPr, QN_W_OUTLINELVL);
+    if (oLvl) {
+      const val = oLvl.getAttribute(QN_W_VAL);
+      if (val && /^\d+$/.test(val)) {
+        const lvl = parseInt(val, 10);
+        if (lvl >= 0 && lvl <= 8) return true;
+      }
     }
-    rows_text.push(row_str);
-    local_cursor = row_start + row_str.length;
-    rows_processed++;
   }
-  return rows_text.join("\n");
+  let style_id = default_pstyle;
+  if (pPr) {
+    const pStyle = findChild(pPr, QN_W_PSTYLE);
+    if (pStyle) style_id = pStyle.getAttribute(QN_W_VAL) || default_pstyle;
+  }
+  const style_info = style_id && style_cache ? style_cache[style_id] : null;
+  if (style_info && style_info.outline_level !== null && style_info.outline_level >= 0 && style_info.outline_level <= 8) {
+    return true;
+  }
+  const style_name = style_info ? style_info.name : null;
+  if (style_name?.startsWith("Heading")) return true;
+  if (style_name === "Title") return true;
+  if (style_name && style_name !== "Normal") {
+    if (_detect_heading_level_from_name(style_name) !== null) return true;
+  }
+  return false;
 }
-function build_paragraph_text(paragraph, comments_map, cleanView, style_cache, default_pstyle) {
-  const parts = [];
-  const active_ins = {};
-  const active_del = {};
-  const active_comments = /* @__PURE__ */ new Set();
-  const active_fmt = {};
-  const deferred_meta_states = [];
-  let pending_text = "";
-  let current_wrappers = ["", ""];
-  let current_style = ["", ""];
-  const items = Array.from(iter_paragraph_content(paragraph));
-  const is_heading = is_heading_paragraph(paragraph, style_cache, default_pstyle);
-  const native_heading = is_native_heading(paragraph, style_cache, default_pstyle);
-  let leading_strip_active = is_heading;
-  for (let i = 0; i < items.length; i++) {
-    const item = items[i];
-    if (item instanceof Run) {
-      const [prefix, suffix] = get_run_style_markers(item, native_heading);
-      const text = get_run_text(item);
-      if (cleanView && Object.keys(active_del).length > 0) continue;
-      if (leading_strip_active) {
-        if (!text || !text.trim()) continue;
-        leading_strip_active = false;
+function get_paragraph_prefix(paragraph, style_cache, default_pstyle) {
+  if (!style_cache) {
+    [style_cache, default_pstyle] = _get_style_cache(paragraph._parent.part || paragraph._parent);
+  }
+  const pPr = findChild(paragraph._element, QN_W_PPR);
+  if (pPr) {
+    const oLvl = findChild(pPr, QN_W_OUTLINELVL);
+    if (oLvl) {
+      const val = oLvl.getAttribute(QN_W_VAL);
+      if (val && /^\d+$/.test(val)) {
+        const lvl = parseInt(val, 10);
+        if (lvl >= 0 && lvl <= 8) return "#".repeat(lvl + 1) + " ";
       }
-      const seg = apply_formatting_to_segments(text, prefix, suffix);
-      if (seg) {
-        const new_wrappers = cleanView ? ["", ""] : _get_wrappers(active_ins, active_del, active_comments, active_fmt);
-        const new_style = [prefix, suffix];
-        if (pending_text && new_wrappers[0] === current_wrappers[0] && new_wrappers[1] === current_wrappers[1]) {
-          if (new_style[0] === current_style[0] && new_style[1] === current_style[1] && current_style[0] !== "" && pending_text.endsWith(current_style[1]) && seg.startsWith(new_style[0])) {
-            pending_text = pending_text.slice(0, -current_style[1].length) + seg.slice(new_style[0].length);
-          } else {
-            pending_text += seg;
-          }
-          current_style = new_style;
-        } else {
-          if (pending_text) parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = seg;
-          current_wrappers = new_wrappers;
-          current_style = new_style;
+    }
+  }
+  let style_id = default_pstyle;
+  if (pPr) {
+    const pStyle = findChild(pPr, QN_W_PSTYLE);
+    if (pStyle) style_id = pStyle.getAttribute(QN_W_VAL) || default_pstyle;
+  }
+  const style_info = style_id && style_cache ? style_cache[style_id] : null;
+  if (style_info && style_info.outline_level !== null && style_info.outline_level >= 0 && style_info.outline_level <= 8) {
+    return "#".repeat(style_info.outline_level + 1) + " ";
+  }
+  const style_name = style_info ? style_info.name : null;
+  if (style_name?.startsWith("Heading")) {
+    const match = style_name.replace("Heading", "").trim();
+    if (/^\d+$/.test(match)) return "#".repeat(parseInt(match, 10)) + " ";
+  }
+  if (style_name === "Title") return "# ";
+  if (pPr) {
+    const numPr = findChild(pPr, QN_W_NUMPR);
+    if (numPr) {
+      const numId = findChild(numPr, QN_W_NUMID);
+      if (numId && numId.getAttribute(QN_W_VAL) !== "0") {
+        let level = 0;
+        const ilvl = findChild(numPr, QN_W_ILVL);
+        if (ilvl) {
+          const valAttr = ilvl.getAttribute(QN_W_VAL);
+          if (valAttr) level = parseInt(valAttr, 10) || 0;
         }
-        if (!cleanView) {
-          const has_meta = Object.keys(active_ins).length > 0 || Object.keys(active_del).length > 0 || active_comments.size > 0 || Object.keys(active_fmt).length > 0;
-          if (has_meta) {
-            deferred_meta_states.push([{ ...active_ins }, { ...active_del }, new Set(active_comments), { ...active_fmt }]);
+        return "    ".repeat(level) + "* ";
+      }
+    }
+  }
+  if (style_name && style_name !== "Normal") {
+    const custom_level = _detect_heading_level_from_name(style_name);
+    if (custom_level !== null) return "#".repeat(custom_level) + " ";
+  }
+  if (!style_name || style_name === "Normal") {
+    const text = paragraph.text.trim();
+    if (text && text.length < 100 && text === text.toUpperCase()) {
+      let is_bold = false;
+      if (style_info?.bold) {
+        is_bold = true;
+      } else {
+        const runs = findAllDescendants(paragraph._element, QN_W_R);
+        for (const r of runs) {
+          const tList = findAllDescendants(r, QN_W_T);
+          const tText = tList.map((t) => t.textContent || "").join("");
+          if (tText.trim()) {
+            const rPr_run = findChild(r, QN_W_RPR);
+            if (rPr_run) {
+              const b = findChild(rPr_run, QN_W_B);
+              if (b && b.getAttribute(QN_W_VAL) !== "0" && b.getAttribute(QN_W_VAL) !== "false") {
+                is_bold = true;
+              }
+            }
+            break;
           }
-          let should_defer = false;
-          const is_redline = Object.keys(active_ins).length > 0 || Object.keys(active_del).length > 0 || Object.keys(active_fmt).length > 0;
-          if (is_redline) {
-            let j = i + 1;
-            let next_is_redline = false;
-            let temp_ins = Object.keys(active_ins).length;
-            let temp_del = Object.keys(active_del).length;
-            let temp_fmt = Object.keys(active_fmt).length;
-            while (j < items.length) {
-              const next_item = items[j];
-              if (next_item instanceof Run) {
-                if (!get_run_text(next_item)) {
-                  j++;
-                  continue;
-                }
-                if (temp_ins > 0 || temp_del > 0 || temp_fmt > 0) next_is_redline = true;
-                break;
-              } else {
-                const ev = next_item;
-                if (ev.type === "ins_start") temp_ins++;
-                else if (ev.type === "ins_end") temp_ins = Math.max(0, temp_ins - 1);
-                else if (ev.type === "del_start") temp_del++;
-                else if (ev.type === "del_end") temp_del = Math.max(0, temp_del - 1);
-                else if (ev.type === "fmt_start") temp_fmt++;
-                else if (ev.type === "fmt_end") temp_fmt = Math.max(0, temp_fmt - 1);
-              }
-              j++;
-            }
-            if (next_is_redline) should_defer = true;
-          }
-          if (!should_defer && deferred_meta_states.length > 0) {
-            const meta_block = _build_merged_meta_block(deferred_meta_states, comments_map);
-            if (meta_block) {
-              if (pending_text) {
-                parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-                pending_text = "";
-                current_wrappers = ["", ""];
-                current_style = ["", ""];
-              }
-              parts.push(`{>>${meta_block}<<}`);
-            }
-            deferred_meta_states.length = 0;
-          }
-        }
-      }
-    } else {
-      const ev = item;
-      leading_strip_active = false;
-      if (!["ins_start", "ins_end", "del_start", "del_end", "fmt_start", "fmt_end"].includes(ev.type)) {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-      }
-      if (ev.type === "start") active_comments.add(ev.id);
-      else if (ev.type === "end") active_comments.delete(ev.id);
-      else if (ev.type === "ins_start") active_ins[ev.id] = ev;
-      else if (ev.type === "ins_end") delete active_ins[ev.id];
-      else if (ev.type === "del_start") active_del[ev.id] = ev;
-      else if (ev.type === "del_end") delete active_del[ev.id];
-      else if (ev.type === "fmt_start") active_fmt[ev.id] = ev;
-      else if (ev.type === "fmt_end") delete active_fmt[ev.id];
-      else if (ev.type === "footnote" || ev.type === "endnote") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-        parts.push(`[^${ev.type === "footnote" ? "fn" : "en"}-${ev.id}]`);
-      } else if (ev.type === "hyperlink_start") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-        parts.push("[");
-      } else if (ev.type === "hyperlink_end") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-        parts.push(`](${ev.date})`);
-      } else if (ev.type === "xref_start") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-        parts.push("[~");
-      } else if (ev.type === "xref_end") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
-        }
-        parts.push(`~](#${ev.id})`);
-      } else if (ev.type === "bookmark") {
-        if (pending_text) {
-          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-          pending_text = "";
-          current_wrappers = ["", ""];
-          current_style = ["", ""];
         }
-        parts.push(`{#${ev.id}}`);
       }
+      if (is_bold) return "## ";
     }
   }
-  if (pending_text) parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
-  if (deferred_meta_states.length > 0) {
-    const meta_block = _build_merged_meta_block(deferred_meta_states, comments_map);
-    if (meta_block) parts.push(`{>>${meta_block}<<}`);
+  return "";
+}
+function is_heading_paragraph(paragraph, style_cache, default_pstyle) {
+  const prefix = get_paragraph_prefix(paragraph, style_cache, default_pstyle);
+  if (!prefix) return false;
+  const stripped = prefix.trimEnd();
+  return stripped.length > 0 && stripped === "#".repeat(stripped.length);
+}
+function get_run_style_markers(run, is_heading = null) {
+  let prefix = "";
+  let suffix = "";
+  const rPr = findChild(run._element, QN_W_RPR);
+  let is_bold = false;
+  let is_italic = false;
+  if (rPr) {
+    const b = findChild(rPr, QN_W_B);
+    if (b && b.getAttribute(QN_W_VAL) !== "0" && b.getAttribute(QN_W_VAL) !== "false") is_bold = true;
+    const i = findChild(rPr, QN_W_I);
+    if (i && i.getAttribute(QN_W_VAL) !== "0" && i.getAttribute(QN_W_VAL) !== "false") is_italic = true;
   }
-  return parts.join("");
+  if (is_heading === null) {
+    const parent = run._parent;
+    is_heading = parent instanceof Paragraph ? is_native_heading(parent) : false;
+  }
+  if (is_bold && !is_heading) {
+    prefix += "**";
+    suffix = "**" + suffix;
+  }
+  if (is_italic) {
+    prefix += "_";
+    suffix = "_" + suffix;
+  }
+  return [prefix, suffix];
 }
-function _get_wrappers(ins, del, comments, fmt) {
-  if (Object.keys(del).length > 0) return ["{--", "--}"];
-  if (Object.keys(ins).length > 0) return ["{++", "++}"];
-  if (comments.size > 0 || Object.keys(fmt).length > 0) return ["{==", "==}"];
-  return ["", ""];
+function apply_formatting_to_segments(text, prefix, suffix) {
+  if (!prefix && !suffix) return text;
+  if (!text) return "";
+  if (!text.includes("\n")) return `${prefix}${text}${suffix}`;
+  const parts = text.split("\n");
+  return parts.map((p) => p ? `${prefix}${p}${suffix}` : "").join("\n");
 }
-function _build_merged_meta_block(states_list, comments_map) {
-  const change_lines = [];
-  const comment_lines = [];
-  const seen_sigs = /* @__PURE__ */ new Set();
-  for (const [ins_map, del_map, comments_set, fmt_map] of states_list) {
-    let render_comment2 = function(cid) {
-      if (!comments_map[cid]) return;
-      const sig = `Com:${cid}`;
-      if (seen_sigs.has(sig)) return;
-      const data = comments_map[cid];
-      let header = `[${sig}] ${data.author}`;
-      if (data.date) header += ` @ ${data.date}`;
-      if (data.resolved) header += `(RESOLVED)`;
-      comment_lines.push(`${header}: ${data.text}`);
-      seen_sigs.add(sig);
-      if (children_map[cid]) {
-        const children = children_map[cid].sort((a, b) => (comments_map[a]?.date || "").localeCompare(comments_map[b]?.date || ""));
-        for (const child_id of children) {
-          render_comment2(child_id);
-        }
-      }
-    };
-    var render_comment = render_comment2;
-    for (const [uid, meta] of Object.entries(ins_map)) {
-      const sig = `Chg:${uid}`;
-      if (!seen_sigs.has(sig)) {
-        change_lines.push(`[${sig} insert] ${meta.author || "Unknown"}`);
-        seen_sigs.add(sig);
-      }
-    }
-    for (const [uid, meta] of Object.entries(del_map)) {
-      const sig = `Chg:${uid}`;
-      if (!seen_sigs.has(sig)) {
-        change_lines.push(`[${sig} delete] ${meta.author || "Unknown"}`);
-        seen_sigs.add(sig);
-      }
-    }
-    for (const [uid, meta] of Object.entries(fmt_map)) {
-      const sig = `Chg:${uid}`;
-      if (!seen_sigs.has(sig)) {
-        change_lines.push(`[${sig} format] ${meta.author || "Unknown"}`);
-        seen_sigs.add(sig);
-      }
-    }
-    const children_map = {};
-    for (const [c_id, data] of Object.entries(comments_map)) {
-      const p_id = data.parent_id;
-      if (p_id) {
-        if (!children_map[p_id]) children_map[p_id] = [];
-        children_map[p_id].push(c_id);
-      }
-    }
-    const sorted_ids = Array.from(comments_set).sort();
-    for (const c_id of sorted_ids) {
-      render_comment2(c_id);
+function get_run_text(run) {
+  let text = "";
+  for (let i = 0; i < run._element.childNodes.length; i++) {
+    const child = run._element.childNodes[i];
+    if (child.nodeType !== 1) continue;
+    if (child.tagName === QN_W_T || child.tagName === QN_W_DELTEXT) {
+      const raw = child.textContent || "";
+      text += raw.replace(/\t/g, " ");
+    } else if (child.tagName === QN_W_TAB) {
+      text += " ";
+    } else if (child.tagName === QN_W_BR || child.tagName === QN_W_CR) {
+      text += "\n";
     }
   }
-  return [...change_lines, ...comment_lines].join("\n");
+  return text;
 }
-
-// src/mapper.ts
-var DocumentMapper = class {
-  doc;
-  clean_view;
-  comments_map;
-  full_text = "";
-  spans = [];
-  appendix_start_index = -1;
-  _text_chunks = [];
-  constructor(doc, clean_view = false) {
-    this.doc = doc;
-    this.clean_view = clean_view;
-    this.comments_map = extract_comments_data(doc.pkg);
-    this._build_map();
-  }
-  _build_map() {
-    let current_offset = 0;
-    this.spans = [];
-    this._text_chunks = [];
-    this.full_text = "";
-    for (const part of iter_document_parts(this.doc)) {
-      current_offset = this._map_blocks(part, current_offset);
-      if (this.spans.length > 0 && this.spans[this.spans.length - 1].text !== "\n\n") {
-        this._add_virtual_text("\n\n", current_offset, null);
-        current_offset += 2;
-      }
-    }
-    while (this.spans.length > 0 && this.spans[this.spans.length - 1].text === "\n\n") {
-      this.spans.pop();
-      this._text_chunks.pop();
+function* iter_block_items(parent) {
+  const parent_elm = parent._element || parent.element || parent;
+  if (parent.constructor.name === "NotesPart") {
+    const tag = parent.note_type === "fn" ? "w:footnote" : "w:endnote";
+    const notes = findAllDescendants(parent_elm, tag);
+    for (const child of notes) {
+      if (child.getAttribute("w:type") === "separator" || child.getAttribute("w:type") === "continuationSeparator") continue;
+      yield new FootnoteItem(child, parent, parent.note_type);
     }
-    this.full_text = this._text_chunks.join("");
-    this.appendix_start_index = -1;
+    return;
+  }
+  for (let i = 0; i < parent_elm.childNodes.length; i++) {
+    const child = parent_elm.childNodes[i];
+    if (child.nodeType !== 1) continue;
+    if (child.tagName === QN_W_P) {
+      yield new Paragraph(child, parent);
+    } else if (child.tagName === "w:tbl") {
+      yield new Table(child, parent);
+    }
+  }
+}
+function* iter_document_parts(doc) {
+  yield doc;
+  const fnPart = doc.pkg.getPartByPath("word/footnotes.xml");
+  const enPart = doc.pkg.getPartByPath("word/endnotes.xml");
+  if (fnPart) yield new NotesPart(fnPart, "fn");
+  if (enPart) yield new NotesPart(enPart, "en");
+}
+function _is_page_instr(instr) {
+  if (!instr) return false;
+  const parts = instr.toUpperCase().trim().split(/\s+/);
+  return parts.length > 0 && (parts[0] === "PAGE" || parts[0] === "NUMPAGES");
+}
+function _get_part(parent) {
+  if (!parent) return null;
+  if (parent.part) return parent.part;
+  if (parent.pkg && parent.pkg.mainDocumentPart) return parent.pkg.mainDocumentPart;
+  if (parent._parent) return _get_part(parent._parent);
+  return null;
+}
+function* iter_paragraph_content(paragraph) {
+  let in_complex_field = false;
+  let current_instr = "";
+  let hide_result = false;
+  function* process_run_element(r_element) {
+    let c_id = null;
+    const rPr = findChild(r_element, QN_W_RPR);
+    if (rPr) {
+      const rPrChange = findChild(rPr, QN_W_RPRCHANGE);
+      if (rPrChange) {
+        c_id = rPrChange.getAttribute(QN_W_ID);
+        yield { type: "fmt_start", id: c_id, author: rPrChange.getAttribute(QN_W_AUTHOR) || void 0, date: rPrChange.getAttribute(QN_W_DATE) || void 0 };
+      }
+    }
+    for (let i = 0; i < r_element.childNodes.length; i++) {
+      const child = r_element.childNodes[i];
+      if (child.nodeType !== 1) continue;
+      const tag = child.tagName;
+      if (tag === QN_W_COMMENTREFERENCE) {
+        const ref_id = child.getAttribute(QN_W_ID);
+        if (ref_id) yield { type: "ref", id: ref_id };
+      } else if (tag === QN_W_FOOTNOTEREFERENCE) {
+        const f_id = child.getAttribute(QN_W_ID);
+        if (f_id) yield { type: "footnote", id: f_id };
+      } else if (tag === QN_W_ENDNOTEREFERENCE) {
+        const e_id = child.getAttribute(QN_W_ID);
+        if (e_id) yield { type: "endnote", id: e_id };
+      } else if (tag === QN_W_FLDCHAR) {
+        const fld_type = child.getAttribute(QN_W_FLDCHARTYPE);
+        if (fld_type === "begin") {
+          in_complex_field = true;
+          current_instr = "";
+        } else if (fld_type === "separate") {
+          if (_is_page_instr(current_instr)) hide_result = true;
+          else {
+            const parts = current_instr.trim().split(/\s+/);
+            if (parts.length > 1 && parts[0] === "REF") yield { type: "xref_start", id: parts[1] };
+          }
+        } else if (fld_type === "end") {
+          if (!hide_result) {
+            const parts = current_instr.trim().split(/\s+/);
+            if (parts.length > 1 && parts[0] === "REF") yield { type: "xref_end", id: parts[1] };
+          }
+          in_complex_field = false;
+          current_instr = "";
+          hide_result = false;
+        }
+      } else if (tag === QN_W_INSTRTEXT && in_complex_field && !hide_result) {
+        current_instr += child.textContent || "";
+      }
+    }
+    if (!hide_result) yield new Run(r_element, paragraph);
+    if (c_id !== null) yield { type: "fmt_end", id: c_id };
+  }
+  function* traverse_node(node) {
+    for (let i = 0; i < node.childNodes.length; i++) {
+      const child = node.childNodes[i];
+      if (child.nodeType !== 1) continue;
+      const tag = child.tagName;
+      if (tag === QN_W_R) yield* process_run_element(child);
+      else if (tag === QN_W_INS) {
+        const i_id = child.getAttribute(QN_W_ID);
+        yield { type: "ins_start", id: i_id, author: child.getAttribute(QN_W_AUTHOR) || void 0, date: child.getAttribute(QN_W_DATE) || void 0 };
+        yield* traverse_node(child);
+        yield { type: "ins_end", id: i_id };
+      } else if (tag === QN_W_DEL) {
+        const d_id = child.getAttribute(QN_W_ID);
+        yield { type: "del_start", id: d_id, author: child.getAttribute(QN_W_AUTHOR) || void 0, date: child.getAttribute(QN_W_DATE) || void 0 };
+        yield* traverse_node(child);
+        yield { type: "del_end", id: d_id };
+      } else if (tag === QN_W_COMMENTRANGESTART) yield { type: "start", id: child.getAttribute(QN_W_ID) };
+      else if (tag === QN_W_COMMENTRANGEEND) yield { type: "end", id: child.getAttribute(QN_W_ID) };
+      else if (tag === QN_W_HYPERLINK) {
+        const rId = child.getAttribute(QN_R_ID) || child.getAttribute("id");
+        let url = "";
+        const part = _get_part(paragraph._parent);
+        if (rId && part) {
+          const rel = part.rels.get(rId);
+          if (rel && rel.isExternal) url = rel.target;
+        }
+        if (url) yield { type: "hyperlink_start", id: rId, date: url };
+        yield* traverse_node(child);
+        if (url) yield { type: "hyperlink_end", id: rId, date: url };
+      } else if (tag === QN_W_FLDSIMPLE) {
+        const instr = child.getAttribute(QN_W_INSTR) || "";
+        const parts = instr.trim().split(/\s+/);
+        const target = parts.length > 1 && parts[0] === "REF" ? parts[1] : "";
+        if (target) yield { type: "xref_start", id: target };
+        yield* traverse_node(child);
+        if (target) yield { type: "xref_end", id: target };
+      } else if (tag === QN_W_BOOKMARKSTART) {
+        const b_name = child.getAttribute(QN_W_NAME);
+        if (b_name && (!b_name.startsWith("_") || b_name.startsWith("_Ref"))) yield { type: "bookmark", id: b_name };
+      } else if (tag === QN_W_SDT || tag === QN_W_SMARTTAG || tag === QN_W_SDTCONTENT) {
+        yield* traverse_node(child);
+      }
+    }
+  }
+  yield* traverse_node(paragraph._element);
+}
+
+// src/mapper.ts
+var DocumentMapper = class {
+  doc;
+  clean_view;
+  comments_map;
+  full_text = "";
+  spans = [];
+  appendix_start_index = -1;
+  _text_chunks = [];
+  constructor(doc, clean_view = false) {
+    this.doc = doc;
+    this.clean_view = clean_view;
+    this.comments_map = extract_comments_data(doc.pkg);
+    this._build_map();
+  }
+  _build_map() {
+    let current_offset = 0;
+    this.spans = [];
+    this._text_chunks = [];
+    this.full_text = "";
+    for (const part of iter_document_parts(this.doc)) {
+      current_offset = this._map_blocks(part, current_offset);
+      if (this.spans.length > 0 && this.spans[this.spans.length - 1].text !== "\n\n") {
+        this._add_virtual_text("\n\n", current_offset, null);
+        current_offset += 2;
+      }
+    }
+    while (this.spans.length > 0 && this.spans[this.spans.length - 1].text === "\n\n") {
+      this.spans.pop();
+      this._text_chunks.pop();
+    }
+    this.full_text = this._text_chunks.join("");
+    this.appendix_start_index = -1;
   }
   _map_blocks(container, offset) {
     let current = offset;
@@ -2248,6 +1932,50 @@ function generate_edits_from_text(original_text, modified_text) {
   }
   return edits;
 }
+function create_unified_diff(original_text, modified_text, context_lines = 3) {
+  const dmp = new diff_match_patch.diff_match_patch();
+  const a = dmp.diff_linesToChars_(original_text, modified_text);
+  const diffs = dmp.diff_main(a.chars1, a.chars2, false);
+  dmp.diff_charsToLines_(diffs, a.lineArray);
+  const output = [];
+  output.push("--- Original");
+  output.push("+++ Modified");
+  let i = 0;
+  while (i < diffs.length) {
+    while (i < diffs.length && diffs[i][0] === 0) i++;
+    if (i >= diffs.length) break;
+    let start = i;
+    let preContext = [];
+    if (start > 0 && diffs[start - 1][0] === 0) {
+      const lines = diffs[start - 1][1].replace(/\n$/, "").split("\n");
+      preContext = lines.slice(-context_lines);
+    }
+    const chunk = [];
+    chunk.push(...preContext.map((l) => ` ${l}`));
+    while (i < diffs.length) {
+      const [op, text] = diffs[i];
+      const lines = text.replace(/\n$/, "").split("\n");
+      if (op === 0) {
+        if (lines.length > context_lines * 2) break;
+        chunk.push(...lines.map((l) => ` ${l}`));
+      } else {
+        const prefix = op === -1 ? "-" : "+";
+        chunk.push(...lines.map((l) => `${prefix}${l}`));
+      }
+      i++;
+    }
+    let postContext = [];
+    if (i < diffs.length && diffs[i][0] === 0) {
+      const lines = diffs[i][1].replace(/\n$/, "").split("\n");
+      postContext = lines.slice(0, context_lines);
+    }
+    chunk.push(...postContext.map((l) => ` ${l}`));
+    output.push("@@ ... @@");
+    output.push(...chunk);
+  }
+  if (output.length === 2) return "";
+  return output.join("\n");
+}
 
 // src/engine.ts
 function insertAfter(newNode, refNode) {
@@ -3195,85 +2923,664 @@ function _split_on_safe_paragraph_breaks(text) {
         continue;
       }
     }
-    i++;
+    i++;
+  }
+  if (block_start < n) {
+    const block_text = text.substring(block_start, n);
+    if (block_text) blocks.push([block_text, block_start]);
+  }
+  return blocks;
+}
+function _merge_footnote_sections(blocks) {
+  if (!blocks.length) return blocks;
+  const merged = [];
+  let i = 0;
+  while (i < blocks.length) {
+    const [block_text, block_offset] = blocks[i];
+    const stripped = block_text.trimStart();
+    const is_section_header = stripped.startsWith("## Footnotes") || stripped.startsWith("## Endnotes");
+    if (!is_section_header) {
+      merged.push([block_text, block_offset]);
+      i++;
+      continue;
+    }
+    let accumulated_text = block_text;
+    let j = i + 1;
+    while (j < blocks.length) {
+      const [next_text] = blocks[j];
+      const next_stripped = next_text.trimStart();
+      if (next_stripped.startsWith("[^fn-") || next_stripped.startsWith("[^en-")) {
+        accumulated_text = `${accumulated_text}
+
+${next_text}`;
+        j++;
+      } else {
+        break;
+      }
+    }
+    merged.push([accumulated_text, block_offset]);
+    i = j;
+  }
+  return merged;
+}
+function _assemble_pages(block_records) {
+  if (!block_records.length) return [[""], [0]];
+  const pages = [];
+  const page_starts = [];
+  let current_blocks = [];
+  let current_size = 0;
+  let current_start = -1;
+  const flush_current = () => {
+    if (current_blocks.length > 0) {
+      pages.push(current_blocks.join("\n\n"));
+      page_starts.push(current_start);
+    }
+    current_blocks = [];
+    current_size = 0;
+    current_start = -1;
+  };
+  for (const [block_text, block_offset] of block_records) {
+    const block_size = block_text.length;
+    const added_size = block_size + (current_blocks.length > 0 ? 2 : 0);
+    if (current_blocks.length > 0 && current_size + added_size > PAGE_TARGET_CHARS) {
+      flush_current();
+    }
+    if (current_blocks.length === 0 && block_size > PAGE_TARGET_CHARS) {
+      pages.push(block_text);
+      page_starts.push(block_offset);
+      continue;
+    }
+    if (current_blocks.length === 0) current_start = block_offset;
+    current_blocks.push(block_text);
+    current_size += current_size > 0 ? added_size : block_size;
+  }
+  flush_current();
+  if (!pages.length) return [[""], [0]];
+  return [pages, page_starts];
+}
+function _count_tracked_changes(page_content) {
+  const matches = [...page_content.matchAll(_CHG_ID_PATTERN)];
+  const distinct = new Set(matches.map((m) => m[1]));
+  return distinct.size;
+}
+
+// src/domain.ts
+function boundedLevenshtein(a, b, maxDist = 2) {
+  if (a === b) return 0;
+  if (Math.abs(a.length - b.length) > maxDist) return maxDist + 1;
+  if (a.length === 0) return b.length <= maxDist ? b.length : maxDist + 1;
+  if (b.length === 0) return a.length <= maxDist ? a.length : maxDist + 1;
+  if (a.length > b.length) {
+    const temp = a;
+    a = b;
+    b = temp;
+  }
+  let row = Array.from({ length: a.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= b.length; i++) {
+    const newRow = [i];
+    let minInRow = i;
+    for (let j = 1; j <= a.length; j++) {
+      const cost = a[j - 1] === b[i - 1] ? 0 : 1;
+      const val = Math.min(
+        row[j] + 1,
+        newRow[j - 1] + 1,
+        row[j - 1] + cost
+      );
+      newRow.push(val);
+      if (val < minInRow) minInRow = val;
+    }
+    if (minInRow > maxDist) return maxDist + 1;
+    row = newRow;
+  }
+  return row[a.length] <= maxDist ? row[a.length] : maxDist + 1;
+}
+function _get_paragraph_text(p) {
+  let text = "";
+  const runs = findAllDescendants(p._element, "w:r");
+  for (const r of runs) {
+    text += get_run_text(new Run(r, p));
+  }
+  return text;
+}
+function extract_all_domain_metadata(doc, base_text) {
+  const definitions = {};
+  const duplicates = /* @__PURE__ */ new Set();
+  const raw_anchors = {};
+  const raw_references = [];
+  const leading_re = /^(?:[\d.\-()a-zA-Z]+\s*)?["“]([A-Z][A-Za-z0-9\s\-&'’]{1,60})["”]/;
+  const inline_re = /\([^)]*?["“]([A-Z][A-Za-z0-9\s\-&'’]{1,60})["”][^)]*?\)/g;
+  for (const item of iter_block_items(doc)) {
+    if (!(item instanceof Paragraph)) continue;
+    const text = _get_paragraph_text(item).trim();
+    if (!text) continue;
+    const extracted_terms = [];
+    const leading_match = text.match(leading_re);
+    if (leading_match) extracted_terms.push(leading_match[1].trim());
+    const inline_matches = text.matchAll(inline_re);
+    for (const m of inline_matches) {
+      extracted_terms.push(m[1].trim());
+    }
+    for (const term of extracted_terms) {
+      if (definitions[term]) duplicates.add(term);
+      else definitions[term] = { count: 0 };
+    }
+    const short_text = text.length > 60 ? text.substring(0, 60) + "..." : text;
+    const nodes = findAllDescendants(item._element, "*");
+    for (const node of nodes) {
+      if (node.tagName === "w:bookmarkStart") {
+        const b_name = node.getAttribute("w:name");
+        if (b_name && (!b_name.startsWith("_") || b_name.startsWith("_Ref"))) {
+          if (!raw_anchors[b_name]) {
+            raw_anchors[b_name] = { anchored_to: short_text, referenced_from: [] };
+          }
+        }
+      }
+      let target = null;
+      if (node.tagName === "w:fldSimple") {
+        const instr = node.getAttribute("w:instr") || "";
+        const parts = instr.trim().split(/\s+/);
+        if (parts.length > 1 && parts[0] === "REF") target = parts[1];
+      } else if (node.tagName === "w:instrText") {
+        const instr = node.textContent || "";
+        const parts = instr.trim().split(/\s+/);
+        if (parts.length > 1 && parts[0] === "REF") target = parts[1];
+      }
+      if (target) raw_references.push([target, short_text]);
+    }
+  }
+  for (const [target, ref_text] of raw_references) {
+    if (raw_anchors[target]) {
+      raw_anchors[target].referenced_from.push(ref_text);
+    }
+  }
+  const diagnostics = [];
+  const def_keys = Object.keys(definitions);
+  if (def_keys.length > 0) {
+    const sorted_terms = def_keys.sort((a, b) => b.length - a.length);
+    const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const alt = sorted_terms.map(escapeRegExp).join("|");
+    const usage_pattern = new RegExp(`(?<!["\u201C])\\b(${alt})\\b(?![\u201D"])`, "g");
+    for (const m of base_text.matchAll(usage_pattern)) {
+      const matched_term = m[1];
+      if (definitions[matched_term]) definitions[matched_term].count++;
+    }
+    for (const term of def_keys) {
+      if (definitions[term].count === 0) {
+        delete definitions[term];
+        duplicates.delete(term);
+      }
+    }
+  }
+  for (const term of duplicates) {
+    diagnostics.push(`[Error] Duplicate Definition: '${term}' is defined multiple times.`);
+  }
+  const stop_words = /* @__PURE__ */ new Set([
+    "The",
+    "This",
+    "That",
+    "Such",
+    "A",
+    "An",
+    "Any",
+    "All",
+    "Some",
+    "No",
+    "Every",
+    "Each",
+    "As",
+    "In",
+    "Of",
+    "For",
+    "To",
+    "On",
+    "By",
+    "With"
+  ]);
+  const all_cap_pattern = /\b[A-Z][a-zA-Z]*(?:\s+[A-Z][a-zA-Z]*)*\b/g;
+  const all_caps = new Set(base_text.match(all_cap_pattern) || []);
+  const valid_terms = new Set(Object.keys(definitions));
+  const terms_by_first_letter = {};
+  for (const term of valid_terms) {
+    const fl = term[0].toLowerCase();
+    if (!terms_by_first_letter[fl]) terms_by_first_letter[fl] = [];
+    terms_by_first_letter[fl].push(term);
+  }
+  const candidates_by_term = {};
+  for (const raw_candidate of all_caps) {
+    let candidate = raw_candidate.trim();
+    const words = candidate.split(/\s+/);
+    while (words.length > 0) {
+      const first = words[0];
+      const title = first.charAt(0).toUpperCase() + first.slice(1).toLowerCase();
+      if (stop_words.has(title)) words.shift();
+      else break;
+    }
+    candidate = words.join(" ");
+    if (candidate.length < 4) continue;
+    if (valid_terms.has(candidate)) continue;
+    const first_letter = candidate[0].toLowerCase();
+    let candidate_terms = terms_by_first_letter[first_letter] || [];
+    if (candidate.length > 5) {
+      for (const [k, v] of Object.entries(terms_by_first_letter)) {
+        if (k !== first_letter) candidate_terms = candidate_terms.concat(v);
+      }
+    }
+    for (const term of candidate_terms) {
+      if (Math.abs(candidate.length - term.length) > 2) continue;
+      if (candidate === term + "s" || candidate === term + "es") continue;
+      if (term === candidate + "s" || term === candidate + "es") continue;
+      const dist = boundedLevenshtein(candidate, term, 2);
+      if (dist === 0 || dist > 2) continue;
+      if (term.length <= 5) {
+        if (dist > 1) continue;
+        if (candidate[0].toLowerCase() !== term[0].toLowerCase()) continue;
+      }
+      if (!candidates_by_term[term]) candidates_by_term[term] = [];
+      if (!candidates_by_term[term].includes(candidate)) candidates_by_term[term].push(candidate);
+    }
+  }
+  for (const [term, candidates] of Object.entries(candidates_by_term)) {
+    candidates.sort();
+    const c_str = candidates.map((c) => `'${c}'`).join(", ");
+    diagnostics.push(`[Info] Possible Typos for '${term}': Found ${c_str}`);
+  }
+  function diag_sort_key(msg) {
+    if (msg.startsWith("[Error]")) return 0;
+    if (msg.startsWith("[Warning]")) return 1;
+    return 2;
+  }
+  diagnostics.sort((a, b) => {
+    const keyA = diag_sort_key(a);
+    const keyB = diag_sort_key(b);
+    if (keyA !== keyB) return keyA - keyB;
+    return a.localeCompare(b);
+  });
+  return [definitions, diagnostics, raw_anchors];
+}
+function build_structural_appendix(doc, base_text) {
+  const [defs, diagnostics, anchors] = extract_all_domain_metadata(doc, base_text);
+  const lines = [
+    "\n\n---",
+    "",
+    "<!-- READONLY_BOUNDARY_START -->",
+    "# Document Structure (Read-Only)",
+    "The content below is metadata describing the document's reference structure. Do not include this section in any tracked changes or edits \u2014 it is for your context only and will be discarded on write."
+  ];
+  let has_content = false;
+  if (Object.keys(defs).length > 0) {
+    has_content = true;
+    lines.push("\n## Defined Terms");
+    for (const [term, data] of Object.entries(defs)) {
+      lines.push(`- "${term}" \u2014 used ${data.count} times.`);
+    }
+  }
+  if (diagnostics.length > 0) {
+    has_content = true;
+    lines.push("\n## Semantic Diagnostics");
+    for (const diag of diagnostics) {
+      lines.push(`- ${diag}`);
+    }
+  }
+  if (Object.keys(anchors).length > 0) {
+    has_content = true;
+    lines.push("\n## Named Anchors");
+    for (const [b_name, data] of Object.entries(anchors)) {
+      lines.push(`- ${b_name} \u2192 Anchored to: "${data.anchored_to}"`);
+      for (const ref of data.referenced_from) {
+        lines.push(`  - Referenced from: "${ref}"`);
+      }
+    }
+  }
+  if (has_content) {
+    return lines.join("\n");
+  }
+  return "";
+}
+
+// src/ingest.ts
+async function extractTextFromBuffer(buffer, cleanView = false) {
+  const doc = await DocumentObject.load(buffer);
+  return _extractTextFromDoc(doc, cleanView);
+}
+function _extractTextFromDoc(doc, cleanView = false, includeAppendix = true) {
+  const comments_map = extract_comments_data(doc.pkg);
+  const full_text = [];
+  let cursor = 0;
+  for (const part of iter_document_parts(doc)) {
+    const part_cursor = full_text.length > 0 ? cursor + 2 : cursor;
+    const part_text = _extract_blocks(part, comments_map, cleanView, part_cursor);
+    if (part_text) {
+      if (full_text.length > 0) cursor += 2;
+      full_text.push(part_text);
+      cursor += part_text.length;
+    }
+  }
+  let base_text = full_text.join("\n\n");
+  if (includeAppendix) {
+    const appendix = build_structural_appendix(doc, base_text);
+    if (appendix) base_text += appendix;
+  }
+  return base_text;
+}
+function _extract_blocks(container, comments_map, cleanView, cursor) {
+  const part = container.part || container;
+  const [style_cache, default_pstyle] = _get_style_cache(part);
+  const blocks = [];
+  let local_cursor = cursor;
+  let is_first_block = true;
+  let is_first_para = true;
+  if (container.constructor && container.constructor.name === "NotesPart") {
+    const header = container.note_type === "fn" ? "## Footnotes" : "## Endnotes";
+    const sep = `---
+${header}`;
+    blocks.push(sep);
+    local_cursor += sep.length;
+    is_first_block = false;
+  }
+  for (const item of iter_block_items(container)) {
+    if (!is_first_block) local_cursor += 2;
+    const block_start = local_cursor;
+    if (item.constructor.name === "FootnoteItem") {
+      const fn_text = _extract_blocks(item, comments_map, cleanView, block_start);
+      if (fn_text) {
+        blocks.push(fn_text);
+        local_cursor = block_start + fn_text.length;
+        is_first_block = false;
+      } else if (!is_first_block) {
+        local_cursor -= 2;
+      }
+    } else if (item instanceof Paragraph) {
+      let prefix = get_paragraph_prefix(item, style_cache, default_pstyle);
+      if (is_first_para && container.constructor.name === "FootnoteItem") {
+        prefix = `[^${container.note_type}-${container.id}]: ` + prefix;
+      }
+      const p_text = build_paragraph_text(item, comments_map, cleanView, style_cache, default_pstyle);
+      const full_block = prefix + p_text;
+      blocks.push(full_block);
+      local_cursor = block_start + full_block.length;
+      is_first_para = false;
+      is_first_block = false;
+    } else if (item instanceof Table) {
+      const table_text = extract_table(item, comments_map, cleanView, block_start);
+      if (table_text) {
+        blocks.push(table_text);
+        local_cursor = block_start + table_text.length;
+        is_first_block = false;
+      } else if (!is_first_block) {
+        local_cursor -= 2;
+      }
+      is_first_para = false;
+    }
+  }
+  return blocks.join("\n\n");
+}
+function extract_table(table, comments_map, cleanView, cursor) {
+  const rows_text = [];
+  let rows_processed = 0;
+  let local_cursor = cursor;
+  for (const row of table.rows) {
+    const cell_texts = [];
+    const seen_cells = /* @__PURE__ */ new Set();
+    const trPr = findChild(row._element, "w:trPr");
+    const ins = trPr ? findChild(trPr, "w:ins") : null;
+    const del_node = trPr ? findChild(trPr, "w:del") : null;
+    if (cleanView && del_node) continue;
+    const row_start = local_cursor + (rows_processed > 0 ? 1 : 0);
+    const wrapper_prefix_len = !cleanView && ins ? 4 : !cleanView && del_node ? 4 : 0;
+    let cell_cursor = row_start + wrapper_prefix_len;
+    let first_cell = true;
+    for (const cell of row.cells) {
+      if (seen_cells.has(cell)) continue;
+      seen_cells.add(cell);
+      if (!first_cell) cell_cursor += 3;
+      const cell_content = _extract_blocks(cell, comments_map, cleanView, cell_cursor);
+      cell_texts.push(cell_content);
+      cell_cursor += cell_content.length;
+      first_cell = false;
+    }
+    let row_str = cell_texts.join(" | ");
+    if (!cleanView) {
+      if (ins) row_str = `{++ ${row_str} |Chg:${ins.getAttribute("w:id")}++}`;
+      else if (del_node) row_str = `{-- ${row_str} |Chg:${del_node.getAttribute("w:id")}--}`;
+    }
+    rows_text.push(row_str);
+    local_cursor = row_start + row_str.length;
+    rows_processed++;
+  }
+  return rows_text.join("\n");
+}
+function build_paragraph_text(paragraph, comments_map, cleanView, style_cache, default_pstyle) {
+  const parts = [];
+  const active_ins = {};
+  const active_del = {};
+  const active_comments = /* @__PURE__ */ new Set();
+  const active_fmt = {};
+  const deferred_meta_states = [];
+  let pending_text = "";
+  let current_wrappers = ["", ""];
+  let current_style = ["", ""];
+  const items = Array.from(iter_paragraph_content(paragraph));
+  const is_heading = is_heading_paragraph(paragraph, style_cache, default_pstyle);
+  const native_heading = is_native_heading(paragraph, style_cache, default_pstyle);
+  let leading_strip_active = is_heading;
+  for (let i = 0; i < items.length; i++) {
+    const item = items[i];
+    if (item instanceof Run) {
+      const [prefix, suffix] = get_run_style_markers(item, native_heading);
+      const text = get_run_text(item);
+      if (cleanView && Object.keys(active_del).length > 0) continue;
+      if (leading_strip_active) {
+        if (!text || !text.trim()) continue;
+        leading_strip_active = false;
+      }
+      const seg = apply_formatting_to_segments(text, prefix, suffix);
+      if (seg) {
+        const new_wrappers = cleanView ? ["", ""] : _get_wrappers(active_ins, active_del, active_comments, active_fmt);
+        const new_style = [prefix, suffix];
+        if (pending_text && new_wrappers[0] === current_wrappers[0] && new_wrappers[1] === current_wrappers[1]) {
+          if (new_style[0] === current_style[0] && new_style[1] === current_style[1] && current_style[0] !== "" && pending_text.endsWith(current_style[1]) && seg.startsWith(new_style[0])) {
+            pending_text = pending_text.slice(0, -current_style[1].length) + seg.slice(new_style[0].length);
+          } else {
+            pending_text += seg;
+          }
+          current_style = new_style;
+        } else {
+          if (pending_text) parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = seg;
+          current_wrappers = new_wrappers;
+          current_style = new_style;
+        }
+        if (!cleanView) {
+          const has_meta = Object.keys(active_ins).length > 0 || Object.keys(active_del).length > 0 || active_comments.size > 0 || Object.keys(active_fmt).length > 0;
+          if (has_meta) {
+            deferred_meta_states.push([{ ...active_ins }, { ...active_del }, new Set(active_comments), { ...active_fmt }]);
+          }
+          let should_defer = false;
+          const is_redline = Object.keys(active_ins).length > 0 || Object.keys(active_del).length > 0 || Object.keys(active_fmt).length > 0;
+          if (is_redline) {
+            let j = i + 1;
+            let next_is_redline = false;
+            let temp_ins = Object.keys(active_ins).length;
+            let temp_del = Object.keys(active_del).length;
+            let temp_fmt = Object.keys(active_fmt).length;
+            while (j < items.length) {
+              const next_item = items[j];
+              if (next_item instanceof Run) {
+                if (!get_run_text(next_item)) {
+                  j++;
+                  continue;
+                }
+                if (temp_ins > 0 || temp_del > 0 || temp_fmt > 0) next_is_redline = true;
+                break;
+              } else {
+                const ev = next_item;
+                if (ev.type === "ins_start") temp_ins++;
+                else if (ev.type === "ins_end") temp_ins = Math.max(0, temp_ins - 1);
+                else if (ev.type === "del_start") temp_del++;
+                else if (ev.type === "del_end") temp_del = Math.max(0, temp_del - 1);
+                else if (ev.type === "fmt_start") temp_fmt++;
+                else if (ev.type === "fmt_end") temp_fmt = Math.max(0, temp_fmt - 1);
+              }
+              j++;
+            }
+            if (next_is_redline) should_defer = true;
+          }
+          if (!should_defer && deferred_meta_states.length > 0) {
+            const meta_block = _build_merged_meta_block(deferred_meta_states, comments_map);
+            if (meta_block) {
+              if (pending_text) {
+                parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+                pending_text = "";
+                current_wrappers = ["", ""];
+                current_style = ["", ""];
+              }
+              parts.push(`{>>${meta_block}<<}`);
+            }
+            deferred_meta_states.length = 0;
+          }
+        }
+      }
+    } else {
+      const ev = item;
+      leading_strip_active = false;
+      if (!["ins_start", "ins_end", "del_start", "del_end", "fmt_start", "fmt_end"].includes(ev.type)) {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+      }
+      if (ev.type === "start") active_comments.add(ev.id);
+      else if (ev.type === "end") active_comments.delete(ev.id);
+      else if (ev.type === "ins_start") active_ins[ev.id] = ev;
+      else if (ev.type === "ins_end") delete active_ins[ev.id];
+      else if (ev.type === "del_start") active_del[ev.id] = ev;
+      else if (ev.type === "del_end") delete active_del[ev.id];
+      else if (ev.type === "fmt_start") active_fmt[ev.id] = ev;
+      else if (ev.type === "fmt_end") delete active_fmt[ev.id];
+      else if (ev.type === "footnote" || ev.type === "endnote") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push(`[^${ev.type === "footnote" ? "fn" : "en"}-${ev.id}]`);
+      } else if (ev.type === "hyperlink_start") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push("[");
+      } else if (ev.type === "hyperlink_end") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push(`](${ev.date})`);
+      } else if (ev.type === "xref_start") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push("[~");
+      } else if (ev.type === "xref_end") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push(`~](#${ev.id})`);
+      } else if (ev.type === "bookmark") {
+        if (pending_text) {
+          parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+          pending_text = "";
+          current_wrappers = ["", ""];
+          current_style = ["", ""];
+        }
+        parts.push(`{#${ev.id}}`);
+      }
+    }
   }
-  if (block_start < n) {
-    const block_text = text.substring(block_start, n);
-    if (block_text) blocks.push([block_text, block_start]);
+  if (pending_text) parts.push(`${current_wrappers[0]}${pending_text}${current_wrappers[1]}`);
+  if (deferred_meta_states.length > 0) {
+    const meta_block = _build_merged_meta_block(deferred_meta_states, comments_map);
+    if (meta_block) parts.push(`{>>${meta_block}<<}`);
   }
-  return blocks;
+  return parts.join("");
 }
-function _merge_footnote_sections(blocks) {
-  if (!blocks.length) return blocks;
-  const merged = [];
-  let i = 0;
-  while (i < blocks.length) {
-    const [block_text, block_offset] = blocks[i];
-    const stripped = block_text.trimStart();
-    const is_section_header = stripped.startsWith("## Footnotes") || stripped.startsWith("## Endnotes");
-    if (!is_section_header) {
-      merged.push([block_text, block_offset]);
-      i++;
-      continue;
+function _get_wrappers(ins, del, comments, fmt) {
+  if (Object.keys(del).length > 0) return ["{--", "--}"];
+  if (Object.keys(ins).length > 0) return ["{++", "++}"];
+  if (comments.size > 0 || Object.keys(fmt).length > 0) return ["{==", "==}"];
+  return ["", ""];
+}
+function _build_merged_meta_block(states_list, comments_map) {
+  const change_lines = [];
+  const comment_lines = [];
+  const seen_sigs = /* @__PURE__ */ new Set();
+  for (const [ins_map, del_map, comments_set, fmt_map] of states_list) {
+    let render_comment2 = function(cid) {
+      if (!comments_map[cid]) return;
+      const sig = `Com:${cid}`;
+      if (seen_sigs.has(sig)) return;
+      const data = comments_map[cid];
+      let header = `[${sig}] ${data.author}`;
+      if (data.date) header += ` @ ${data.date}`;
+      if (data.resolved) header += `(RESOLVED)`;
+      comment_lines.push(`${header}: ${data.text}`);
+      seen_sigs.add(sig);
+      if (children_map[cid]) {
+        const children = children_map[cid].sort((a, b) => (comments_map[a]?.date || "").localeCompare(comments_map[b]?.date || ""));
+        for (const child_id of children) {
+          render_comment2(child_id);
+        }
+      }
+    };
+    var render_comment = render_comment2;
+    for (const [uid, meta] of Object.entries(ins_map)) {
+      const sig = `Chg:${uid}`;
+      if (!seen_sigs.has(sig)) {
+        change_lines.push(`[${sig} insert] ${meta.author || "Unknown"}`);
+        seen_sigs.add(sig);
+      }
     }
-    let accumulated_text = block_text;
-    let j = i + 1;
-    while (j < blocks.length) {
-      const [next_text] = blocks[j];
-      const next_stripped = next_text.trimStart();
-      if (next_stripped.startsWith("[^fn-") || next_stripped.startsWith("[^en-")) {
-        accumulated_text = `${accumulated_text}
-
-${next_text}`;
-        j++;
-      } else {
-        break;
+    for (const [uid, meta] of Object.entries(del_map)) {
+      const sig = `Chg:${uid}`;
+      if (!seen_sigs.has(sig)) {
+        change_lines.push(`[${sig} delete] ${meta.author || "Unknown"}`);
+        seen_sigs.add(sig);
       }
     }
-    merged.push([accumulated_text, block_offset]);
-    i = j;
-  }
-  return merged;
-}
-function _assemble_pages(block_records) {
-  if (!block_records.length) return [[""], [0]];
-  const pages = [];
-  const page_starts = [];
-  let current_blocks = [];
-  let current_size = 0;
-  let current_start = -1;
-  const flush_current = () => {
-    if (current_blocks.length > 0) {
-      pages.push(current_blocks.join("\n\n"));
-      page_starts.push(current_start);
+    for (const [uid, meta] of Object.entries(fmt_map)) {
+      const sig = `Chg:${uid}`;
+      if (!seen_sigs.has(sig)) {
+        change_lines.push(`[${sig} format] ${meta.author || "Unknown"}`);
+        seen_sigs.add(sig);
+      }
     }
-    current_blocks = [];
-    current_size = 0;
-    current_start = -1;
-  };
-  for (const [block_text, block_offset] of block_records) {
-    const block_size = block_text.length;
-    const added_size = block_size + (current_blocks.length > 0 ? 2 : 0);
-    if (current_blocks.length > 0 && current_size + added_size > PAGE_TARGET_CHARS) {
-      flush_current();
+    const children_map = {};
+    for (const [c_id, data] of Object.entries(comments_map)) {
+      const p_id = data.parent_id;
+      if (p_id) {
+        if (!children_map[p_id]) children_map[p_id] = [];
+        children_map[p_id].push(c_id);
+      }
     }
-    if (current_blocks.length === 0 && block_size > PAGE_TARGET_CHARS) {
-      pages.push(block_text);
-      page_starts.push(block_offset);
-      continue;
+    const sorted_ids = Array.from(comments_set).sort();
+    for (const c_id of sorted_ids) {
+      render_comment2(c_id);
     }
-    if (current_blocks.length === 0) current_start = block_offset;
-    current_blocks.push(block_text);
-    current_size += current_size > 0 ? added_size : block_size;
   }
-  flush_current();
-  if (!pages.length) return [[""], [0]];
-  return [pages, page_starts];
-}
-function _count_tracked_changes(page_content) {
-  const matches = [...page_content.matchAll(_CHG_ID_PATTERN)];
-  const distinct = new Set(matches.map((m) => m[1]));
-  return distinct.size;
+  return [...change_lines, ...comment_lines].join("\n");
 }
 
 // src/outline.ts
@@ -3560,16 +3867,524 @@ function _offset_to_page(offset, body_page_offsets) {
   return page;
 }
 
+// src/sanitize/report.ts
+var SanitizeReport = class {
+  filename;
+  mode;
+  author;
+  tracked_changes_found = 0;
+  tracked_changes_accepted = 0;
+  tracked_changes_kept = 0;
+  change_lines = [];
+  comments_removed = 0;
+  comments_kept = 0;
+  removed_comment_lines = [];
+  kept_comment_lines = [];
+  metadata_lines = [];
+  structural_lines = [];
+  warnings = [];
+  status = "clean";
+  blocked_reason = null;
+  constructor(filename, mode = "full", author = null) {
+    this.filename = filename;
+    this.mode = mode;
+    this.author = author;
+  }
+  add_transform_lines(lines) {
+    for (const line of lines) {
+      const lower = line.toLowerCase();
+      if (lower.includes("tracked change") || lower.includes("insertion") || lower.includes("deletion") || lower.includes("accepted")) {
+        this.change_lines.push(line);
+      } else if (lower.includes("comment") || lower.includes("[open]") || lower.includes("[resolved]")) {
+        if (lower.includes("kept") || lower.includes("visible")) {
+          this.kept_comment_lines.push(line);
+        } else {
+          this.removed_comment_lines.push(line);
+        }
+      } else if (lower.includes("author") || lower.includes("template") || lower.includes("company") || lower.includes("manager") || lower.includes("metadata") || lower.includes("timestamp") || lower.includes("custom xml") || lower.includes("last modified by") || lower.includes("revision count") || lower.includes("last printed")) {
+        this.metadata_lines.push(line);
+      } else if (lower.includes("hyperlink") || lower.includes("warning")) {
+        this.warnings.push(line);
+      } else {
+        this.structural_lines.push(line);
+      }
+    }
+  }
+  render() {
+    const sep = "\u2550".repeat(50);
+    const lines = [sep, `Finalization Report: ${this.filename}`];
+    const flags = [];
+    if (this.mode === "keep-markup") flags.push("--keep-markup");
+    if (this.author) flags.push(`--author "${this.author}"`);
+    if (this.tracked_changes_accepted > 0) flags.push("--accept-all");
+    if (flags.length > 0) lines.push(flags.join(" "));
+    lines.push(sep);
+    if (this.status === "blocked") {
+      lines.push("");
+      lines.push(`BLOCKED: ${this.blocked_reason}`);
+      lines.push(sep);
+      return lines.join("\n");
+    }
+    if (this.mode === "keep-markup" && (this.tracked_changes_kept > 0 || this.comments_kept > 0)) {
+      lines.push("");
+      lines.push("VISIBLE TO COUNTERPARTY");
+      if (this.tracked_changes_kept > 0) lines.push(`  Tracked changes: ${this.tracked_changes_kept}`);
+      if (this.comments_kept > 0) {
+        lines.push(`  Open comments: ${this.comments_kept}`);
+        for (const cl of this.kept_comment_lines) lines.push(`    ${cl}`);
+      }
+      if (this.author) lines.push(`  Author on all markup: "${this.author}"`);
+    }
+    if (this.change_lines.length > 0) {
+      lines.push("");
+      lines.push("TRACKED CHANGES");
+      for (const cl of this.change_lines) lines.push(`  ${cl}`);
+    }
+    if (this.removed_comment_lines.length > 0) {
+      lines.push("");
+      lines.push("COMMENTS (stripped)");
+      for (const cl of this.removed_comment_lines) lines.push(`  ${cl}`);
+    }
+    if (this.metadata_lines.length > 0) {
+      lines.push("");
+      lines.push("METADATA");
+      for (const ml of this.metadata_lines) lines.push(`  ${ml}`);
+    }
+    if (this.structural_lines.length > 0) {
+      lines.push("");
+      lines.push("STRUCTURAL & PROTECTION");
+      for (const sl of this.structural_lines) lines.push(`  ${sl}`);
+    }
+    if (this.warnings.length > 0) {
+      lines.push("");
+      lines.push("WARNINGS");
+      for (const w of this.warnings) lines.push(`  \u26A0 ${w}`);
+    }
+    lines.push("");
+    lines.push(sep);
+    if (this.warnings.length > 0) {
+      lines.push(`Result: CLEAN WITH WARNINGS (${this.warnings.length} warning${this.warnings.length > 1 ? "s" : ""})`);
+    } else {
+      lines.push("Result: SECURE & READY TO SEND");
+    }
+    lines.push(sep);
+    return lines.join("\n");
+  }
+};
+
+// src/sanitize/transforms.ts
+function findDescendantsByLocalName(element, localName) {
+  const result = [];
+  const all = element.getElementsByTagName("*");
+  for (let i = 0; i < all.length; i++) {
+    const tag = all[i].tagName;
+    if (tag === localName || tag.endsWith(":" + localName)) {
+      result.push(all[i]);
+    }
+  }
+  return result;
+}
+function strip_rsid(doc) {
+  let count = 0;
+  const rsidAttrs = ["w:rsidR", "w:rsidRPr", "w:rsidRDefault", "w:rsidP", "w:rsidDel", "w:rsidSect", "w:rsidTr"];
+  const all = doc.element.getElementsByTagName("*");
+  for (let i = 0; i < all.length; i++) {
+    for (const attr of rsidAttrs) {
+      if (all[i].hasAttribute(attr)) {
+        all[i].removeAttribute(attr);
+        count++;
+      }
+    }
+  }
+  const rsidsElements = findAllDescendants(doc.element, "w:rsids");
+  for (const el of rsidsElements) {
+    if (el.parentNode) {
+      el.parentNode.removeChild(el);
+      count++;
+    }
+  }
+  return count ? [`rsid attributes: ${count} removed`] : [];
+}
+function strip_para_ids(doc) {
+  let count = 0;
+  const attrs = ["w14:paraId", "w14:textId"];
+  const all = doc.element.getElementsByTagName("*");
+  for (let i = 0; i < all.length; i++) {
+    for (const attr of attrs) {
+      if (all[i].hasAttribute(attr)) {
+        all[i].removeAttribute(attr);
+        count++;
+      }
+    }
+  }
+  return count ? [`Paragraph/text IDs: ${count} removed`] : [];
+}
+function strip_proof_errors(doc) {
+  const elements = findAllDescendants(doc.element, "w:proofErr");
+  elements.forEach((el) => el.parentNode?.removeChild(el));
+  return elements.length ? [`Spell check markers: ${elements.length} removed`] : [];
+}
+function strip_empty_properties(doc) {
+  let count = 0;
+  for (const tag of ["w:rPr", "w:pPr"]) {
+    const elements = findAllDescendants(doc.element, tag);
+    for (const el of elements) {
+      if (el.childNodes.length === 0 || el.childNodes.length === 1 && el.childNodes[0].nodeType === 3 && !el.childNodes[0].textContent?.trim()) {
+        el.parentNode?.removeChild(el);
+        count++;
+      }
+    }
+  }
+  return count ? [`Empty property elements: ${count} removed`] : [];
+}
+function strip_hidden_text(doc) {
+  let count = 0;
+  const elements = findAllDescendants(doc.element, "w:rPr");
+  for (const rPr of elements) {
+    if (findChild(rPr, "w:vanish") || findChild(rPr, "w:webHidden")) {
+      const run = rPr.parentNode;
+      if (run && run.tagName === "w:r" && run.parentNode) {
+        run.parentNode.removeChild(run);
+        count++;
+      }
+    }
+  }
+  return count ? [`Hidden text runs: ${count} removed`] : [];
+}
+function count_tracked_changes(doc) {
+  const ins = findAllDescendants(doc.element, "w:ins").length;
+  const del = findAllDescendants(doc.element, "w:del").length;
+  const fmt = findAllDescendants(doc.element, "w:rPrChange").length + findAllDescendants(doc.element, "w:pPrChange").length + findAllDescendants(doc.element, "w:sectPrChange").length;
+  return [ins, del, fmt];
+}
+function get_track_change_authors(doc) {
+  const authors = /* @__PURE__ */ new Set();
+  for (const tag of ["w:ins", "w:del", "w:rPrChange", "w:pPrChange", "w:sectPrChange"]) {
+    for (const el of findAllDescendants(doc.element, tag)) {
+      const author = el.getAttribute("w:author");
+      if (author) authors.add(author);
+    }
+  }
+  return authors;
+}
+function _getElementText(el) {
+  const texts = [];
+  const ts = findAllDescendants(el, "w:t");
+  for (const t of ts) if (t.textContent) texts.push(t.textContent);
+  const dts = findAllDescendants(el, "w:delText");
+  for (const dt of dts) if (dt.textContent) texts.push(dt.textContent);
+  return texts.join("");
+}
+function _truncate(text, maxLen = 60) {
+  const clean = text.replace(/\n/g, " ").trim();
+  if (clean.length <= maxLen) return clean;
+  return clean.substring(0, maxLen - 3) + "...";
+}
+function accept_all_tracked_changes(doc) {
+  const lines = [];
+  const insEls = findAllDescendants(doc.element, "w:ins");
+  const delEls = findAllDescendants(doc.element, "w:del");
+  for (const ins of insEls) {
+    const text = _getElementText(ins).trim();
+    if (text) lines.push(`  Accepted insertion: "${_truncate(text, 60)}"`);
+  }
+  for (const del of delEls) {
+    const text = _getElementText(del).trim();
+    if (text) lines.push(`  Accepted deletion of: "${_truncate(text, 60)}"`);
+  }
+  const engine = new RedlineEngine(doc);
+  engine.accept_all_revisions();
+  for (const tag of ["w:rPrChange", "w:pPrChange", "w:sectPrChange"]) {
+    for (const el of findAllDescendants(doc.element, tag)) {
+      el.parentNode?.removeChild(el);
+    }
+  }
+  const total = insEls.length + delEls.length;
+  if (total) {
+    return [`Tracked changes auto-accepted: ${total}`].concat(lines);
+  }
+  return [];
+}
+function get_comments_summary(doc) {
+  const data = extract_comments_data(doc.pkg);
+  const comments = [];
+  let openCount = 0;
+  let resolvedCount = 0;
+  for (const [cId, info] of Object.entries(data)) {
+    if (info.resolved) resolvedCount++;
+    else openCount++;
+    comments.push({ id: cId, ...info });
+  }
+  return { total: comments.length, open: openCount, resolved: resolvedCount, comments };
+}
+function remove_all_comments(doc) {
+  const data = extract_comments_data(doc.pkg);
+  const keys = Object.keys(data);
+  if (keys.length === 0) return [];
+  const lines = [];
+  const cm = new CommentsManager(doc);
+  for (const [cId, info] of Object.entries(data)) {
+    const status = info.resolved ? "[Resolved]" : "[Open]";
+    lines.push(`  ${status} "${_truncate(info.text || "", 60)}" (${info.author || "Unknown"})`);
+    cm.deleteComment(cId);
+  }
+  for (const tag of ["w:commentRangeStart", "w:commentRangeEnd", "w:commentReference"]) {
+    for (const el of findAllDescendants(doc.element, tag)) {
+      el.parentNode?.removeChild(el);
+    }
+  }
+  const resolvedCount = Object.values(data).filter((c) => c.resolved).length;
+  const openCount = Object.values(data).filter((c) => !c.resolved).length;
+  return [`Comments removed: ${keys.length} (${resolvedCount} resolved, ${openCount} open)`].concat(lines);
+}
+function replace_comment_authors(doc, newAuthor) {
+  const cm = new CommentsManager(doc);
+  if (!cm.commentsPart) return [];
+  const original = /* @__PURE__ */ new Set();
+  const comments = findAllDescendants(cm.commentsPart._element, "w:comment");
+  for (const c of comments) {
+    const author = c.getAttribute("w:author");
+    if (author) {
+      original.add(author);
+      c.setAttribute("w:author", newAuthor);
+    }
+    if (c.hasAttribute("w:initials")) {
+      const initials = newAuthor.split(" ").filter(Boolean).map((p) => p[0]).join("").toUpperCase();
+      c.setAttribute("w:initials", initials);
+    }
+  }
+  return original.size ? [`Comment authors replaced: ${Array.from(original).sort().join(", ")} \u2192 "${newAuthor}"`] : [];
+}
+function replace_change_authors(doc, newAuthor) {
+  const original = /* @__PURE__ */ new Set();
+  for (const tag of ["w:ins", "w:del", "w:rPrChange", "w:pPrChange"]) {
+    for (const el of findAllDescendants(doc.element, tag)) {
+      const author = el.getAttribute("w:author");
+      if (author) {
+        original.add(author);
+        el.setAttribute("w:author", newAuthor);
+      }
+    }
+  }
+  return original.size ? [`Track change authors replaced: ${Array.from(original).sort().join(", ")} \u2192 "${newAuthor}"`] : [];
+}
+function normalize_change_dates(doc) {
+  let count = 0;
+  const fixed = "2025-01-01T00:00:00Z";
+  for (const tag of ["w:ins", "w:del", "w:rPrChange", "w:pPrChange"]) {
+    for (const el of findAllDescendants(doc.element, tag)) {
+      if (el.hasAttribute("w:date")) {
+        el.setAttribute("w:date", fixed);
+        count++;
+      }
+    }
+  }
+  return count ? [`Track change timestamps: ${count} normalized`] : [];
+}
+function scrub_doc_properties(doc) {
+  const lines = [];
+  const corePart = doc.pkg.getPartByPath("docProps/core.xml");
+  if (corePart) {
+    const creators = findDescendantsByLocalName(corePart._element, "creator");
+    creators.forEach((c) => {
+      if (c.textContent) {
+        lines.push(`Author: ${c.textContent}`);
+        c.textContent = "";
+      }
+    });
+    const modifiers = findDescendantsByLocalName(corePart._element, "lastModifiedBy");
+    modifiers.forEach((c) => {
+      if (c.textContent) {
+        lines.push(`Last modified by: ${c.textContent}`);
+        c.textContent = "";
+      }
+    });
+    const revisions = findDescendantsByLocalName(corePart._element, "revision");
+    revisions.forEach((c) => {
+      if (c.textContent && parseInt(c.textContent) > 1) {
+        lines.push(`Revision count: ${c.textContent} \u2192 1`);
+        c.textContent = "1";
+      }
+    });
+  }
+  const appPart = doc.pkg.getPartByPath("docProps/app.xml");
+  if (appPart) {
+    const docEl = appPart._element;
+    const intFields = ["TotalTime", "Words", "Characters", "Paragraphs", "Lines", "CharactersWithSpaces"];
+    for (const f of intFields) {
+      findDescendantsByLocalName(docEl, f).forEach((el) => {
+        if (el.textContent && el.textContent !== "0") {
+          if (f === "TotalTime") lines.push(`Total editing time: ${el.textContent} minutes`);
+          el.textContent = "0";
+        }
+      });
+    }
+    const strFields = ["Template", "Manager", "Company"];
+    for (const f of strFields) {
+      findDescendantsByLocalName(docEl, f).forEach((el) => {
+        if (el.textContent) {
+          lines.push(`${f}: ${el.textContent}`);
+          el.textContent = "";
+        }
+      });
+    }
+  }
+  return lines.length ? ["Metadata scrubbed:", ...lines.map((l) => `  ${l}`)] : [];
+}
+function scrub_timestamps(doc) {
+  let modified = false;
+  const epoch = "1970-01-01T00:00:00Z";
+  const corePart = doc.pkg.getPartByPath("docProps/core.xml");
+  if (corePart) {
+    for (const tag of ["created", "modified", "lastPrinted"]) {
+      findDescendantsByLocalName(corePart._element, tag).forEach((el) => {
+        if (el.textContent && el.textContent !== epoch) {
+          el.textContent = epoch;
+          modified = true;
+        }
+      });
+    }
+  }
+  return modified ? ["Timestamps normalized to epoch"] : [];
+}
+function strip_custom_xml(doc) {
+  const customParts = doc.pkg.parts.filter((p) => p.partname.includes("/customXml"));
+  if (customParts.length === 0) return [];
+  const partnames = new Set(customParts.map((p) => p.partname));
+  doc.pkg.parts = doc.pkg.parts.filter((p) => !partnames.has(p.partname));
+  const removeRelationsTo = (relsPart) => {
+    const toRemove = [];
+    for (const rel of findAllDescendants(relsPart._element, "Relationship")) {
+      const target = rel.getAttribute("Target");
+      if (target && target.includes("customXml")) toRemove.push(rel);
+    }
+    toRemove.forEach((r) => r.parentNode?.removeChild(r));
+  };
+  const rootRels = doc.pkg.getPartByPath("_rels/.rels");
+  if (rootRels) removeRelationsTo(rootRels);
+  const docRels = doc.pkg.getOrCreateRelsPart(doc.part.partname);
+  if (docRels) removeRelationsTo(docRels);
+  for (const sdtPr of findAllDescendants(doc.element, "w:sdtPr")) {
+    findChildren(sdtPr, "w:dataBinding").forEach((b) => sdtPr.removeChild(b));
+  }
+  return [`Custom XML parts: ${customParts.length} removed`];
+}
+function strip_image_alt_text(doc) {
+  let count = 0;
+  for (const docPr of findDescendantsByLocalName(doc.element, "docPr")) {
+    const descr = docPr.getAttribute("descr");
+    if (descr) {
+      const isShort = descr.length < 10;
+      const isFile = descr.includes(".") && descr.length < 60;
+      if (isShort || isFile) {
+        docPr.removeAttribute("descr");
+        count++;
+      }
+    }
+  }
+  return count ? [`Image alt text: ${count} auto-generated descriptions removed`] : [];
+}
+function audit_hyperlinks(doc) {
+  const internal = ["sharepoint.com", "onedrive.com", ".internal", "intranet", "localhost", "10.", "192.168.", "172.16."];
+  const warnings = [];
+  const docRels = doc.pkg.getOrCreateRelsPart(doc.part.partname);
+  for (const rel of findAllDescendants(docRels._element, "Relationship")) {
+    if (rel.getAttribute("TargetMode") === "External") {
+      const url = rel.getAttribute("Target") || "";
+      for (const pattern of internal) {
+        if (url.toLowerCase().includes(pattern.toLowerCase())) {
+          warnings.push(`Hyperlink targets internal URL: ${_truncate(url, 80)}`);
+          break;
+        }
+      }
+    }
+  }
+  return warnings;
+}
+
+// src/sanitize/core.ts
+async function finalize_document(doc, options) {
+  const report = new SanitizeReport(options.filename, options.sanitize_mode || "full", options.author || null);
+  if (options.sanitize_mode === "full") {
+    const counts = count_tracked_changes(doc);
+    const total = counts[0] + counts[1] + counts[2];
+    report.tracked_changes_found = total;
+    if (total > 0 && !options.accept_all) {
+      report.status = "blocked";
+      report.blocked_reason = `Document contains ${total} unresolved tracked changes (${counts[0]} insertions, ${counts[1]} deletions, ${counts[2]} formatting). Review in Word first, or set accept_all=true.`;
+      return { reportText: report.render() };
+    }
+    if (total > 0) {
+      const authors = get_track_change_authors(doc);
+      if (authors.size > 1) {
+        report.warnings.push(`Multiple authors detected in tracked changes: ${Array.from(authors).sort().join(", ")}. Review per-change list before sending.`);
+      }
+      report.add_transform_lines(accept_all_tracked_changes(doc));
+      report.tracked_changes_accepted = total;
+    }
+    const commentsSummary = get_comments_summary(doc);
+    report.comments_removed = commentsSummary.total;
+    report.add_transform_lines(remove_all_comments(doc));
+  } else if (options.sanitize_mode === "keep-markup") {
+    const counts = count_tracked_changes(doc);
+    report.tracked_changes_found = counts[0] + counts[1] + counts[2];
+    report.tracked_changes_kept = report.tracked_changes_found;
+    if (options.author) {
+      report.add_transform_lines(replace_comment_authors(doc, options.author));
+      report.add_transform_lines(replace_change_authors(doc, options.author));
+    }
+  }
+  report.add_transform_lines(strip_rsid(doc));
+  report.add_transform_lines(strip_para_ids(doc));
+  report.add_transform_lines(strip_proof_errors(doc));
+  report.add_transform_lines(strip_empty_properties(doc));
+  report.add_transform_lines(strip_hidden_text(doc));
+  report.add_transform_lines(scrub_doc_properties(doc));
+  report.add_transform_lines(scrub_timestamps(doc));
+  report.add_transform_lines(strip_custom_xml(doc));
+  report.add_transform_lines(strip_image_alt_text(doc));
+  const warnings = audit_hyperlinks(doc);
+  for (const w of warnings) report.warnings.push(w);
+  report.add_transform_lines(normalize_change_dates(doc));
+  if (options.protection_mode === "read_only" || options.protection_mode === "encrypt") {
+    if (options.protection_mode === "encrypt") {
+      report.warnings.push("Encryption mode (AES compound wrappers) is strictly unsupported in the zero-dependency Node engine. Falling back to native Word Read-Only lock.");
+    }
+    const settingsPart = doc.pkg.getPartByPath("word/settings.xml");
+    if (settingsPart) {
+      const docEl = settingsPart._element.ownerDocument;
+      let prot = findDescendantsByLocalName(settingsPart._element, "documentProtection")[0];
+      if (!prot) {
+        prot = docEl.createElement("w:documentProtection");
+        settingsPart._element.appendChild(prot);
+      }
+      prot.setAttribute("w:edit", "readOnly");
+      prot.setAttribute("w:enforcement", "1");
+      report.structural_lines.push("Document locked (Read-Only enforcement injected into settings.xml)");
+    }
+  }
+  if (options.export_pdf) {
+    report.warnings.push("PDF export requires the Python/Word COM environment and is skipped in this zero-dependency Node agent.");
+  }
+  if (report.warnings.length > 0) report.status = "clean_with_warnings";
+  const outBuffer = await doc.save();
+  return { reportText: report.render(), outBuffer };
+}
+
 // src/index.ts
-var identifyEngine = () => "adeu-core-node";
+function identifyEngine() {
+  return "adeu-core-node";
+}
 export {
   BatchValidationError,
   DocumentMapper,
   DocumentObject,
   RedlineEngine,
   apply_edits_to_markdown,
+  create_unified_diff,
   extractTextFromBuffer,
   extract_outline,
+  finalize_document,
   generate_edits_from_text,
   identifyEngine,
   paginate,