kordoc 2.9.1 → 3.0.0

package/dist/index.js

@@ -12,11 +12,12 @@ import {
   convertTableToText,
   flattenLayoutTables,
   isPathTraversal,
+  mapPuaText,
   precheckZipSize,
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-Z6TLTWYK.js";
+} from "./chunk-NHXKJWR7.js";
 import {
   parsePageRange
 } from "./chunk-SBVRCJFH.js";
@@ -818,6 +819,9 @@ function clampSpan(val, max) {
   return Math.max(1, Math.min(val, max));
 }
 var MAX_XML_DEPTH = 200;
+function createSectionShared() {
+  return { numState: /* @__PURE__ */ new Map(), pageText: { headers: [], footers: [] }, track: { deleteDepth: 0, warned: false } };
+}
 function createXmlParser(warnings) {
   return new DOMParser({
     onError(level, msg) {
@@ -829,7 +833,10 @@ function createXmlParser(warnings) {
 async function extractHwpxStyles(zip, decompressed) {
   const result = {
     charProperties: /* @__PURE__ */ new Map(),
-    styles: /* @__PURE__ */ new Map()
+    styles: /* @__PURE__ */ new Map(),
+    numberings: /* @__PURE__ */ new Map(),
+    bullets: /* @__PURE__ */ new Map(),
+    paraHeadings: /* @__PURE__ */ new Map()
   };
   const headerPaths = ["Contents/header.xml", "header.xml", "Contents/head.xml", "head.xml"];
   for (const hp of headerPaths) {
@@ -847,6 +854,10 @@ async function extractHwpxStyles(zip, decompressed) {
       if (!doc.documentElement) continue;
       parseCharProperties(doc, result.charProperties);
       parseStyleElements(doc, result.styles);
+      const domDoc = doc;
+      parseNumberings(domDoc, result.numberings);
+      parseBullets(domDoc, result.bullets);
+      parseParaHeadings(domDoc, result.paraHeadings);
       break;
     } catch {
       continue;
@@ -904,6 +915,162 @@ function parseStyleElements(doc, map) {
     }
   }
 }
+function parseNumberings(doc, map) {
+  const tagNames = ["hh:numbering", "numbering"];
+  for (const tagName of tagNames) {
+    const elements = doc.getElementsByTagName(tagName);
+    for (let i = 0; i < elements.length; i++) {
+      const el = elements[i];
+      const id = el.getAttribute("id") || "";
+      if (!id) continue;
+      const def = { heads: /* @__PURE__ */ new Map() };
+      const children = el.childNodes;
+      for (let j = 0; j < children.length; j++) {
+        const ch = children[j];
+        if (ch.nodeType !== 1) continue;
+        const tag = (ch.tagName || ch.localName || "").replace(/^[^:]+:/, "");
+        if (tag !== "paraHead") continue;
+        const level = parseInt(ch.getAttribute("level") || "", 10);
+        if (isNaN(level) || level < 1 || level > 10) continue;
+        const start = parseInt(ch.getAttribute("start") || "1", 10);
+        def.heads.set(level, {
+          numFormat: ch.getAttribute("numFormat") || "DIGIT",
+          text: ch.textContent || "",
+          start: isNaN(start) ? 1 : start
+        });
+      }
+      if (def.heads.size > 0) map.set(id, def);
+    }
+    if (map.size > 0) break;
+  }
+}
+function parseBullets(doc, map) {
+  const tagNames = ["hh:bullet", "bullet"];
+  for (const tagName of tagNames) {
+    const elements = doc.getElementsByTagName(tagName);
+    for (let i = 0; i < elements.length; i++) {
+      const el = elements[i];
+      const id = el.getAttribute("id") || "";
+      const char = el.getAttribute("char") || "";
+      if (id && char) map.set(id, char);
+    }
+    if (map.size > 0) break;
+  }
+}
+function parseParaHeadings(doc, map) {
+  const tagNames = ["hh:paraPr", "paraPr"];
+  for (const tagName of tagNames) {
+    const elements = doc.getElementsByTagName(tagName);
+    for (let i = 0; i < elements.length; i++) {
+      const el = elements[i];
+      const id = el.getAttribute("id") || "";
+      if (!id) continue;
+      const heading = findChildByLocalName(el, "heading");
+      if (!heading) continue;
+      const type = heading.getAttribute("type") || "NONE";
+      if (type !== "NUMBER" && type !== "BULLET" && type !== "OUTLINE") continue;
+      const level = parseInt(heading.getAttribute("level") || "0", 10);
+      map.set(id, {
+        type,
+        idRef: heading.getAttribute("idRef") || "0",
+        level: isNaN(level) ? 0 : Math.max(0, Math.min(level, 9))
+      });
+    }
+    if (map.size > 0) break;
+  }
+}
+var HANGUL_SYLLABLE_SEQ = "\uAC00\uB098\uB2E4\uB77C\uB9C8\uBC14\uC0AC\uC544\uC790\uCC28\uCE74\uD0C0\uD30C\uD558";
+var HANGUL_JAMO_SEQ = "\u3131\u3134\u3137\u3139\u3141\u3142\u3145\u3147\u3148\u314A\u314B\u314C\u314D\u314E";
+function toRoman(n) {
+  if (n <= 0 || n >= 4e3) return String(n);
+  const table = [
+    [1e3, "M"],
+    [900, "CM"],
+    [500, "D"],
+    [400, "CD"],
+    [100, "C"],
+    [90, "XC"],
+    [50, "L"],
+    [40, "XL"],
+    [10, "X"],
+    [9, "IX"],
+    [5, "V"],
+    [4, "IV"],
+    [1, "I"]
+  ];
+  let out = "";
+  for (const [v, s] of table) {
+    while (n >= v) {
+      out += s;
+      n -= v;
+    }
+  }
+  return out;
+}
+function formatHeadNumber(n, numFormat) {
+  if (n <= 0) n = 1;
+  switch (numFormat) {
+    case "DIGIT":
+      return String(n);
+    case "CIRCLED_DIGIT":
+      return n <= 20 ? String.fromCodePoint(9312 + n - 1) : `(${n})`;
+    case "HANGUL_SYLLABLE":
+      return HANGUL_SYLLABLE_SEQ[(n - 1) % HANGUL_SYLLABLE_SEQ.length];
+    case "CIRCLED_HANGUL_SYLLABLE":
+      return n <= 14 ? String.fromCodePoint(12910 + n - 1) : HANGUL_SYLLABLE_SEQ[(n - 1) % 14];
+    case "HANGUL_JAMO":
+      return HANGUL_JAMO_SEQ[(n - 1) % HANGUL_JAMO_SEQ.length];
+    case "CIRCLED_HANGUL_JAMO":
+      return n <= 14 ? String.fromCodePoint(12896 + n - 1) : HANGUL_JAMO_SEQ[(n - 1) % 14];
+    case "LATIN_CAPITAL":
+      return String.fromCharCode(65 + (n - 1) % 26);
+    case "LATIN_SMALL":
+      return String.fromCharCode(97 + (n - 1) % 26);
+    case "CIRCLED_LATIN_CAPITAL":
+      return n <= 26 ? String.fromCodePoint(9398 + n - 1) : String.fromCharCode(65 + (n - 1) % 26);
+    case "CIRCLED_LATIN_SMALL":
+      return n <= 26 ? String.fromCodePoint(9424 + n - 1) : String.fromCharCode(97 + (n - 1) % 26);
+    case "ROMAN_CAPITAL":
+      return toRoman(n);
+    case "ROMAN_SMALL":
+      return toRoman(n).toLowerCase();
+    default:
+      return String(n);
+  }
+}
+function resolveParaHeading(paraEl, ctx) {
+  const sm = ctx.styleMap;
+  if (!sm) return null;
+  const prId = paraEl.getAttribute("paraPrIDRef");
+  if (!prId) return null;
+  const ref = sm.paraHeadings.get(prId);
+  if (!ref) return null;
+  if (ref.type === "BULLET") {
+    const char = sm.bullets.get(ref.idRef);
+    return char ? { prefix: char } : null;
+  }
+  const numId = ref.type === "OUTLINE" ? ctx.outlineNumId || "1" : ref.idRef;
+  const level = Math.min(ref.level + 1, 10);
+  const headingLevel = ref.type === "OUTLINE" ? Math.min(ref.level + 1, 6) : void 0;
+  const numDef = sm.numberings.get(numId);
+  if (!numDef) return headingLevel ? { headingLevel } : null;
+  let counters = ctx.shared.numState.get(numId);
+  if (!counters) {
+    counters = new Array(11).fill(0);
+    ctx.shared.numState.set(numId, counters);
+  }
+  const head = numDef.heads.get(level);
+  counters[level] = counters[level] === 0 ? head?.start ?? 1 : counters[level] + 1;
+  for (let l = level + 1; l <= 10; l++) counters[l] = 0;
+  const fmtText = head?.text?.trim() || `^${level}.`;
+  const prefix = fmtText.replace(/\^(10|[1-9])/g, (_, d) => {
+    const lv = parseInt(d, 10);
+    const refHead = numDef.heads.get(lv);
+    const n = counters[lv] || refHead?.start || 1;
+    return formatHeadNumber(n, refHead?.numFormat || "DIGIT");
+  });
+  return { prefix, headingLevel };
+}
 async function parseHwpxDocument(buffer, options) {
   precheckZipSize(buffer, MAX_DECOMPRESS_SIZE, MAX_ZIP_ENTRIES);
   let zip;
@@ -940,7 +1107,7 @@ async function parseHwpxDocument(buffer, options) {
   const pageFilter = options?.pages ? parsePageRange(options.pages, sectionPaths.length) : null;
   const totalTarget = pageFilter ? pageFilter.size : sectionPaths.length;
   const blocks = [];
-  const nestedTableCounter = { count: 0 };
+  const shared = createSectionShared();
   let parsedSections = 0;
   for (let si = 0; si < sectionPaths.length; si++) {
     if (pageFilter && !pageFilter.has(si + 1)) continue;
@@ -950,7 +1117,7 @@ async function parseHwpxDocument(buffer, options) {
       const xml = await file.async("text");
       decompressed.total += xml.length * 2;
       if (decompressed.total > MAX_DECOMPRESS_SIZE) throw new KordocError("ZIP \uC555\uCD95 \uD574\uC81C \uD06C\uAE30 \uCD08\uACFC (ZIP bomb \uC758\uC2EC)");
-      blocks.push(...parseSectionXml(xml, styleMap, warnings, si + 1, nestedTableCounter));
+      blocks.push(...parseSectionXml(xml, styleMap, warnings, si + 1, shared));
       parsedSections++;
       options?.onProgress?.(parsedSections, totalTarget);
     } catch (secErr) {
@@ -958,12 +1125,22 @@ async function parseHwpxDocument(buffer, options) {
       warnings.push({ page: si + 1, message: `\uC139\uC158 ${si + 1} \uD30C\uC2F1 \uC2E4\uD328: ${secErr instanceof Error ? secErr.message : "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958"}`, code: "PARTIAL_PARSE" });
     }
   }
+  applyPageText(blocks, shared);
   const images = await extractImagesFromZip(zip, blocks, decompressed, warnings);
   detectHwpxHeadings(blocks, styleMap);
   const outline = blocks.filter((b) => b.type === "heading" && b.level && b.text).map((b) => ({ level: b.level, text: b.text, pageNumber: b.pageNumber }));
   const markdown = blocksToMarkdown(blocks);
   return { markdown, blocks, metadata, outline: outline.length > 0 ? outline : void 0, warnings: warnings.length > 0 ? warnings : void 0, images: images.length > 0 ? images : void 0 };
 }
+function applyPageText(blocks, shared) {
+  const { headers, footers } = shared.pageText;
+  if (headers.length > 0) {
+    blocks.unshift(...headers.map((t) => ({ type: "paragraph", text: t, pageNumber: 1 })));
+  }
+  if (footers.length > 0) {
+    blocks.push(...footers.map((t) => ({ type: "paragraph", text: t })));
+  }
+}
 function imageExtToMime(ext) {
   switch (ext.toLowerCase()) {
     case "jpg":
@@ -999,10 +1176,26 @@ function mimeToExt(mime) {
   if (mime.includes("svg")) return "svg";
   return "bin";
 }
+function collectImageBlocks(blocks, out, ownerCell, depth = 0) {
+  if (depth > MAX_XML_DEPTH) return;
+  for (const block of blocks) {
+    if (block.type === "image") {
+      out.push({ block, ownerCell });
+    } else if (block.type === "table" && block.table) {
+      for (const row of block.table.cells) {
+        for (const cell of row) {
+          if (cell.blocks?.length) collectImageBlocks(cell.blocks, out, cell, depth + 1);
+        }
+      }
+    }
+  }
+}
 async function extractImagesFromZip(zip, blocks, decompressed, warnings) {
   const images = [];
   let imageIndex = 0;
-  for (const block of blocks) {
+  const imageBlocks = [];
+  collectImageBlocks(blocks, imageBlocks);
+  for (const { block, ownerCell } of imageBlocks) {
     if (block.type !== "image" || !block.text) continue;
     const ref = block.text;
     const candidates = [
@@ -1040,6 +1233,7 @@ async function extractImagesFromZip(zip, blocks, decompressed, warnings) {
         images.push({ filename, data, mimeType });
         block.text = filename;
         block.imageData = { data, mimeType, filename: ref };
+        if (ownerCell) ownerCell.text = ownerCell.text.replace(`![image](${ref})`, `![image](${filename})`);
         found = true;
         break;
       } catch (err) {
@@ -1050,6 +1244,7 @@ async function extractImagesFromZip(zip, blocks, decompressed, warnings) {
       warnings?.push({ page: block.pageNumber, message: `\uC774\uBBF8\uC9C0 \uD30C\uC77C \uC5C6\uC74C: ${ref}`, code: "SKIPPED_IMAGE" });
       block.type = "paragraph";
       block.text = `[\uC774\uBBF8\uC9C0: ${ref}]`;
+      if (ownerCell) ownerCell.text = ownerCell.text.replace(`![image](${ref})`, `[\uC774\uBBF8\uC9C0: ${ref}]`);
     }
   }
   return images;
@@ -1106,7 +1301,7 @@ function extractFromBrokenZip(buffer) {
   let totalDecompressed = 0;
   let entryCount = 0;
   let sectionNum = 0;
-  const nestedTableCounter = { count: 0 };
+  const shared = createSectionShared();
   while (pos < data.length - 30) {
     if (data[pos] !== 80 || data[pos + 1] !== 75 || data[pos + 2] !== 3 || data[pos + 3] !== 4) {
       pos++;
@@ -1153,12 +1348,13 @@ function extractFromBrokenZip(buffer) {
       totalDecompressed += content.length * 2;
       if (totalDecompressed > MAX_DECOMPRESS_SIZE) throw new KordocError("\uC555\uCD95 \uD574\uC81C \uD06C\uAE30 \uCD08\uACFC");
       sectionNum++;
-      blocks.push(...parseSectionXml(content, void 0, warnings, sectionNum, nestedTableCounter));
+      blocks.push(...parseSectionXml(content, void 0, warnings, sectionNum, shared));
     } catch {
       continue;
     }
   }
   if (blocks.length === 0) throw new KordocError("\uC190\uC0C1\uB41C HWPX\uC5D0\uC11C \uC139\uC158 \uB370\uC774\uD130\uB97C \uBCF5\uAD6C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
+  applyPageText(blocks, shared);
   const markdown = blocksToMarkdown(blocks);
   return { markdown, blocks, warnings: warnings.length > 0 ? warnings : void 0 };
 }
@@ -1203,6 +1399,7 @@ function parseSectionPathsFromManifest(xml) {
   return Array.from(idToHref.entries()).filter(([id]) => isSectionId(id)).sort((a, b) => a[0].localeCompare(b[0])).map(([, href]) => href);
 }
 function detectHwpxHeadings(blocks, styleMap) {
+  if (blocks.some((b) => b.type === "heading")) return;
   let baseFontSize = 0;
   const sizeFreq = /* @__PURE__ */ new Map();
   for (const b of blocks) {
@@ -1238,39 +1435,73 @@ function detectHwpxHeadings(blocks, styleMap) {
     }
   }
 }
-function makeNestedTableMarker(counter, rows) {
-  counter.count++;
-  const firstRow = rows[0] ?? [];
-  const hint = firstRow.map((c) => c.text.trim().replace(/\n/g, " ")).filter(Boolean).join(" | ");
-  const hintChars = [...hint];
-  const truncated = hintChars.length > 60 ? hintChars.slice(0, 60).join("") + "\u2026" : hint;
-  return truncated ? `[\uC911\uCCA9 \uD14C\uC774\uBE14 #${counter.count}: ${truncated}]` : `[\uC911\uCCA9 \uD14C\uC774\uBE14 #${counter.count}]`;
-}
-function handleNestedTable(newTable, tableStack, blocks, ctx) {
-  const parentTable = tableStack.pop();
-  let nestedCols = 0;
-  for (const r of newTable.rows) if (r.length > nestedCols) nestedCols = r.length;
-  if (newTable.rows.length >= 3 && nestedCols >= 2) {
-    blocks.push({ type: "table", table: buildTable(newTable.rows), pageNumber: ctx.sectionNum });
-    if (parentTable.cell) {
-      const marker = ctx.counter ? makeNestedTableMarker(ctx.counter, newTable.rows) : "[\uC911\uCCA9 \uD14C\uC774\uBE14]";
-      parentTable.cell.text += (parentTable.cell.text ? "\n" : "") + marker;
+function buildTableWithCellMeta(state) {
+  const table = buildTable(state.rows);
+  if (state.caption) table.caption = state.caption;
+  const claimed = /* @__PURE__ */ new Set();
+  for (const row of state.rows) {
+    for (const src of row) {
+      const needsBlocks = src.hasStructure && src.blocks && src.blocks.length > 0;
+      if (!needsBlocks && !src.isHeader) continue;
+      let target;
+      const trimmed = src.text.trim();
+      if (src.rowAddr !== void 0 && src.colAddr !== void 0) {
+        const cand = table.cells[src.rowAddr]?.[src.colAddr];
+        if (cand && cand.text === trimmed && !claimed.has(cand)) target = cand;
+      }
+      if (!target) {
+        outer: for (const irRow of table.cells) {
+          for (const cand of irRow) {
+            if (!claimed.has(cand) && cand.text === trimmed && cand.colSpan === src.colSpan && cand.rowSpan === src.rowSpan) {
+              target = cand;
+              break outer;
+            }
+          }
+        }
+      }
+      if (!target) continue;
+      claimed.add(target);
+      if (needsBlocks) target.blocks = src.blocks;
+      if (src.isHeader) target.isHeader = true;
     }
+  }
+  return table;
+}
+function completeTable(newTable, tableStack, blocks, ctx) {
+  const parentTable = tableStack.length > 0 ? tableStack.pop() : null;
+  if (newTable.rows.length === 0) {
+    if (newTable.caption) blocks.push({ type: "paragraph", text: newTable.caption, pageNumber: ctx.sectionNum });
+    return parentTable;
+  }
+  const ir = buildTableWithCellMeta(newTable);
+  const block = { type: "table", table: ir, pageNumber: ctx.sectionNum };
+  if (parentTable?.cell) {
+    const cell = parentTable.cell;
+    (cell.blocks ??= []).push(block);
+    cell.hasStructure = true;
+    let flat = convertTableToText(newTable.rows);
+    if (newTable.caption) flat = newTable.caption + (flat ? "\n" + flat : "");
+    if (flat) cell.text += (cell.text ? "\n" : "") + flat;
   } else {
-    const nestedText = convertTableToText(newTable.rows);
-    if (parentTable.cell) {
-      const marker = ctx.counter ? makeNestedTableMarker(ctx.counter, newTable.rows) : "[\uC911\uCCA9 \uD14C\uC774\uBE14]";
-      parentTable.cell.text += (parentTable.cell.text ? "\n" : "") + marker + "\n" + nestedText;
-    }
+    blocks.push(block);
   }
   return parentTable;
 }
-function parseSectionXml(xml, styleMap, warnings, sectionNum, counter) {
+function parseSectionXml(xml, styleMap, warnings, sectionNum, shared) {
   const parser = createXmlParser(warnings);
   const doc = parser.parseFromString(stripDtd(xml), "text/xml");
   if (!doc.documentElement) return [];
+  const ctx = { styleMap, warnings, sectionNum, shared: shared ?? createSectionShared() };
+  ctx.shared.track.deleteDepth = 0;
+  for (const tagName of ["hp:secPr", "secPr"]) {
+    const els = doc.getElementsByTagName(tagName);
+    if (els.length > 0) {
+      const v = els[0].getAttribute("outlineShapeIDRef");
+      if (v) ctx.outlineNumId = v;
+      break;
+    }
+  }
   const blocks = [];
-  const ctx = { styleMap, warnings, sectionNum, counter };
   walkSection(doc.documentElement, blocks, null, [], ctx);
   return blocks;
 }
@@ -1306,18 +1537,16 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
         if (tableCtx) tableStack.push(tableCtx);
         const newTable = { rows: [], currentRow: [], cell: null };
         walkSection(el, blocks, newTable, tableStack, ctx, depth + 1);
-        if (newTable.rows.length > 0) {
-          if (tableStack.length > 0) {
-            tableCtx = handleNestedTable(newTable, tableStack, blocks, ctx);
-          } else {
-            blocks.push({ type: "table", table: buildTable(newTable.rows), pageNumber: ctx.sectionNum });
-            tableCtx = null;
-          }
-        } else {
-          tableCtx = tableStack.length > 0 ? tableStack.pop() : null;
-        }
+        tableCtx = completeTable(newTable, tableStack, blocks, ctx);
         break;
       }
+      // 표/도표 캡션 — IRTable.caption으로 보존 (v3.0, 기존 무음 드롭 수정)
+      case "caption":
+        if (tableCtx) {
+          const capText = collectSubListText(el, ctx);
+          if (capText) tableCtx.caption = (tableCtx.caption ? tableCtx.caption + "\n" : "") + capText;
+        }
+        break;
       case "tr":
         if (tableCtx) {
           tableCtx.currentRow = [];
@@ -1329,6 +1558,7 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
       case "tc":
         if (tableCtx) {
           tableCtx.cell = { text: "", colSpan: 1, rowSpan: 1 };
+          if (el.getAttribute("header") === "1" || el.getAttribute("header") === "true") tableCtx.cell.isHeader = true;
           walkSection(el, blocks, tableCtx, tableStack, ctx, depth + 1);
           if (tableCtx.cell) {
             tableCtx.currentRow.push(tableCtx.cell);
@@ -1355,30 +1585,52 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
         }
         break;
       case "p": {
-        const { text, href, footnote, style } = extractParagraphInfo(el, ctx.styleMap);
+        const { text: rawText, href, footnote, style } = extractParagraphInfo(el, ctx.styleMap, ctx);
+        let text = rawText;
+        let headingLevel;
+        if (text) {
+          const ph = resolveParaHeading(el, ctx);
+          if (ph?.prefix) text = ph.prefix + " " + text;
+          headingLevel = ph?.headingLevel;
+        }
         if (text) {
           if (tableCtx?.cell) {
-            tableCtx.cell.text += (tableCtx.cell.text ? "\n" : "") + text;
+            const cell = tableCtx.cell;
+            if (footnote) text += ` (\uC8FC: ${footnote})`;
+            cell.text += (cell.text ? "\n" : "") + text;
+            (cell.blocks ??= []).push({ type: "paragraph", text, pageNumber: ctx.sectionNum });
           } else if (!tableCtx) {
-            const block = { type: "paragraph", text, pageNumber: ctx.sectionNum };
+            const block = { type: headingLevel ? "heading" : "paragraph", text, pageNumber: ctx.sectionNum };
+            if (headingLevel) block.level = headingLevel;
             if (style) block.style = style;
             if (href) block.href = href;
             if (footnote) block.footnoteText = footnote;
             blocks.push(block);
+          } else {
+            blocks.push({ type: "paragraph", text, pageNumber: ctx.sectionNum });
           }
         }
         tableCtx = walkParagraphChildren(el, blocks, tableCtx, tableStack, ctx, depth + 1);
         break;
       }
-      // 이미지/그림 — 경로 추출 또는 경고
+      // 이미지/그림/글상자 — 이미지·텍스트·캡션 병행 추출
       case "pic":
       case "shape":
       case "drawingObject": {
-        const imgRef = extractImageRef(el);
-        if (imgRef) {
-          blocks.push({ type: "image", text: imgRef, pageNumber: ctx.sectionNum });
-        } else if (ctx.warnings && ctx.sectionNum) {
-          ctx.warnings.push({ page: ctx.sectionNum, message: `\uC2A4\uD0B5\uB41C \uC694\uC18C: ${localTag}`, code: "SKIPPED_IMAGE" });
+        if (tableCtx?.cell) {
+          const sink = [];
+          handleShape(el, sink, ctx);
+          mergeBlocksIntoCell(tableCtx.cell, sink);
+        } else {
+          handleShape(el, blocks, ctx);
+        }
+        break;
+      }
+      // 메모 — 본문 혼입 차단 (v3.0)
+      case "memogroup":
+      case "memo": {
+        if (ctx.warnings && extractTextFromNode(el)) {
+          ctx.warnings.push({ page: ctx.sectionNum, message: "\uBA54\uBAA8 \uD14D\uC2A4\uD2B8 \uBCF8\uBB38 \uC81C\uC678: memogroup", code: "HIDDEN_TEXT_FILTERED" });
         }
         break;
       }
@@ -1388,6 +1640,73 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
     }
   }
 }
+function handleShape(el, sink, ctx) {
+  const imgRef = extractImageRef(el);
+  const drawTextChild = findDescendant(el, "drawText");
+  if (imgRef) {
+    const block = { type: "image", text: imgRef, pageNumber: ctx.sectionNum };
+    const alt = userShapeComment(el);
+    if (alt) block.footnoteText = alt;
+    sink.push(block);
+  }
+  if (drawTextChild) {
+    extractDrawTextBlocks(drawTextChild, sink, ctx);
+  }
+  const capEl = findChildByLocalName(el, "caption");
+  if (capEl) {
+    const capText = collectSubListText(capEl, ctx);
+    if (capText) sink.push({ type: "paragraph", text: capText, pageNumber: ctx.sectionNum });
+  }
+  if (!imgRef && !drawTextChild && ctx.warnings && ctx.sectionNum) {
+    const localTag = (el.tagName || el.localName || "").replace(/^[^:]+:/, "");
+    ctx.warnings.push({ page: ctx.sectionNum, message: `\uC2A4\uD0B5\uB41C \uC694\uC18C: ${localTag}`, code: "SKIPPED_IMAGE" });
+  }
+}
+function userShapeComment(el) {
+  const commentEl = findChildByLocalName(el, "shapeComment");
+  if (!commentEl) return void 0;
+  const text = extractTextFromNode(commentEl);
+  if (!text) return void 0;
+  if (/^그림입니다/.test(text)) return void 0;
+  if (/^(?:모서리가 둥근 |둥근 )?[^\n]{1,20}입니다\.?$/.test(text)) return void 0;
+  return text;
+}
+function mergeBlocksIntoCell(cell, sink) {
+  for (const b of sink) {
+    if ((b.type === "paragraph" || b.type === "heading") && b.text) {
+      cell.text += (cell.text ? "\n" : "") + b.text;
+      (cell.blocks ??= []).push(b);
+    } else if (b.type === "image" || b.type === "table") {
+      if (b.type === "image" && b.text) {
+        cell.text += (cell.text ? "\n" : "") + `![image](${b.text})`;
+      }
+      ;
+      (cell.blocks ??= []).push(b);
+      cell.hasStructure = true;
+    }
+  }
+}
+function collectSubListText(el, ctx, depth = 0) {
+  if (depth > 10) return "";
+  const parts = [];
+  const children = el.childNodes;
+  if (!children) return "";
+  for (let i = 0; i < children.length; i++) {
+    const ch = children[i];
+    if (ch.nodeType !== 1) continue;
+    const tag = (ch.tagName || ch.localName || "").replace(/^[^:]+:/, "");
+    if (tag === "p" || tag === "para") {
+      const t = extractParagraphInfo(ch, ctx.styleMap, ctx).text;
+      if (t) parts.push(t);
+    } else if (tag === "tbl") {
+      continue;
+    } else {
+      const t = collectSubListText(ch, ctx, depth + 1);
+      if (t) parts.push(t);
+    }
+  }
+  return parts.join("\n").trim();
+}
 function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
   if (depth > MAX_XML_DEPTH) return tableCtx;
   const children = node.childNodes;
@@ -1405,34 +1724,25 @@ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth =
         if (tableCtx) tableStack.push(tableCtx);
         const newTable = { rows: [], currentRow: [], cell: null };
         walkSection(el, blocks, newTable, tableStack, ctx, d + 1);
-        if (newTable.rows.length > 0) {
-          if (tableStack.length > 0) {
-            tableCtx = handleNestedTable(newTable, tableStack, blocks, ctx);
-          } else {
-            blocks.push({ type: "table", table: buildTable(newTable.rows), pageNumber: ctx.sectionNum });
-            tableCtx = null;
-          }
-        } else {
-          tableCtx = tableStack.length > 0 ? tableStack.pop() : null;
-        }
+        tableCtx = completeTable(newTable, tableStack, blocks, ctx);
       } else if (localTag === "pic" || localTag === "shape" || localTag === "drawingObject") {
-        const drawTextChild = findDescendant(el, "drawText");
-        if (drawTextChild) {
-          extractDrawTextBlocks(drawTextChild, blocks, ctx.styleMap, ctx.sectionNum);
+        if (tableCtx?.cell) {
+          const sink = [];
+          handleShape(el, sink, ctx);
+          mergeBlocksIntoCell(tableCtx.cell, sink);
         } else {
-          const imgRef = extractImageRef(el);
-          if (imgRef) {
-            blocks.push({ type: "image", text: imgRef, pageNumber: ctx.sectionNum });
-          } else if (ctx.warnings && ctx.sectionNum) {
-            ctx.warnings.push({ page: ctx.sectionNum, message: `\uC2A4\uD0B5\uB41C \uC694\uC18C: ${localTag}`, code: "SKIPPED_IMAGE" });
-          }
+          handleShape(el, blocks, ctx);
         }
       } else if (localTag === "drawText") {
-        extractDrawTextBlocks(el, blocks, ctx.styleMap, ctx.sectionNum);
+        if (tableCtx?.cell) {
+          const sink = [];
+          extractDrawTextBlocks(el, sink, ctx);
+          mergeBlocksIntoCell(tableCtx.cell, sink);
+        } else {
+          extractDrawTextBlocks(el, blocks, ctx);
+        }
       } else if (localTag === "r" || localTag === "run" || localTag === "ctrl" || localTag === "rect" || localTag === "ellipse" || localTag === "polygon" || localTag === "line" || localTag === "arc" || localTag === "curve" || localTag === "connectLine" || localTag === "container") {
         walkChildren(el, d + 1);
-      } else if (localTag === "run") {
-        tableCtx = walkParagraphChildren(el, blocks, tableCtx, tableStack, ctx, depth + 1);
       }
     }
   };
@@ -1453,7 +1763,7 @@ function findDescendant(node, targetTag, depth = 0) {
   }
   return null;
 }
-function extractDrawTextBlocks(drawTextNode, blocks, styleMap, sectionNum) {
+function extractDrawTextBlocks(drawTextNode, blocks, ctx) {
   const children = drawTextNode.childNodes;
   if (!children) return;
   for (let i = 0; i < children.length; i++) {
@@ -1462,29 +1772,136 @@ function extractDrawTextBlocks(drawTextNode, blocks, styleMap, sectionNum) {
     const tag = (child.tagName || child.localName || "").replace(/^[^:]+:/, "");
     if (tag === "subList" || tag === "p" || tag === "para") {
       if (tag === "subList") {
-        extractDrawTextBlocks(child, blocks, styleMap, sectionNum);
+        extractDrawTextBlocks(child, blocks, ctx);
       } else {
-        const info = extractParagraphInfo(child, styleMap);
-        const text = info.text.trim();
+        const info = extractParagraphInfo(child, ctx.styleMap, ctx);
+        let text = info.text.trim();
         if (text) {
-          blocks.push({ type: "paragraph", text, style: info.style ?? void 0, pageNumber: sectionNum });
+          const ph = resolveParaHeading(child, ctx);
+          if (ph?.prefix) text = ph.prefix + " " + text;
+          const block = { type: "paragraph", text, style: info.style ?? void 0, pageNumber: ctx.sectionNum };
+          if (info.href) block.href = info.href;
+          if (info.footnote) block.footnoteText = info.footnote;
+          blocks.push(block);
         }
+        walkParagraphChildren(child, blocks, null, [], ctx);
       }
     }
   }
 }
-function extractParagraphInfo(para, styleMap) {
+function extractHyperlinkHref(fieldBegin) {
+  if ((fieldBegin.getAttribute("type") || "").toUpperCase() !== "HYPERLINK") return void 0;
+  const params = findChildByLocalName(fieldBegin, "parameters");
+  if (!params) return void 0;
+  const children = params.childNodes;
+  if (!children) return void 0;
+  for (let i = 0; i < children.length; i++) {
+    const ch = children[i];
+    if (ch.nodeType !== 1) continue;
+    const tag = (ch.tagName || ch.localName || "").replace(/^[^:]+:/, "");
+    if (tag !== "stringParam" || ch.getAttribute("name") !== "Path") continue;
+    let url = (ch.textContent || "").trim();
+    if (!url) continue;
+    url = url.replace(/^https?:\/\/(?=https?:\/\/)/i, "");
+    const safe = sanitizeHref(url);
+    if (safe) return safe;
+  }
+  return void 0;
+}
+function isInDeletedRange(ctx) {
+  return (ctx?.shared.track.deleteDepth ?? 0) > 0;
+}
+function extractParagraphInfo(para, styleMap, ctx) {
   let text = "";
   let href;
   let footnote;
   let charPrId;
+  const handleCtrl = (ctrlEl) => {
+    const kids2 = ctrlEl.childNodes;
+    if (!kids2) return;
+    for (let j = 0; j < kids2.length; j++) {
+      const k = kids2[j];
+      if (k.nodeType !== 1) continue;
+      const ktag = (k.tagName || k.localName || "").replace(/^[^:]+:/, "");
+      switch (ktag) {
+        // 머리말/꼬리말 — 문서당 1회 수집, 본문 앞/뒤 배치
+        case "header":
+        case "footer": {
+          if (!ctx) break;
+          const t = collectSubListText(k, ctx);
+          if (t) {
+            const bucket = ktag === "header" ? ctx.shared.pageText.headers : ctx.shared.pageText.footers;
+            if (!bucket.includes(t)) bucket.push(t);
+          }
+          break;
+        }
+        // 각주/미주 — 해당 문단의 footnote로 인라인 보존
+        case "footNote":
+        case "endNote": {
+          const noteText = extractTextFromNode(k);
+          if (noteText) footnote = (footnote ? footnote + "; " : "") + noteText;
+          break;
+        }
+        // 하이퍼링크 — fieldBegin type=HYPERLINK의 Path 파라미터
+        case "fieldBegin": {
+          const url = extractHyperlinkHref(k);
+          if (url && !href) href = url;
+          break;
+        }
+        case "fieldEnd":
+          break;
+        // 변경추적 — 삭제 구간(deleteBegin~End)의 텍스트는 출력 제외 (최종본 상태 재현)
+        case "deleteBegin":
+          if (ctx) ctx.shared.track.deleteDepth++;
+          break;
+        case "deleteEnd":
+          if (ctx && ctx.shared.track.deleteDepth > 0) ctx.shared.track.deleteDepth--;
+          break;
+        case "insertBegin":
+        case "insertEnd":
+          break;
+        // 삽입분은 최종본에 포함
+        // 숨은 설명 — 본문 혼입 차단
+        case "hiddenComment": {
+          if (ctx?.warnings && extractTextFromNode(k)) {
+            ctx.warnings.push({ page: ctx.sectionNum, message: "\uC228\uC740 \uC124\uBA85 \uD14D\uC2A4\uD2B8 \uC81C\uC678: hiddenComment", code: "HIDDEN_TEXT_FILTERED" });
+          }
+          break;
+        }
+        // 콘텐츠 없는 제어 요소 — 스킵
+        case "bookmark":
+        case "pageNum":
+        case "pageNumCtrl":
+        case "pageHiding":
+        case "newNum":
+        case "autoNum":
+        case "indexmark":
+        case "colPr":
+          break;
+        // 미지원 요소 — 텍스트를 가졌으면 무음 손실 대신 경고
+        default: {
+          if (ctx?.warnings && extractTextFromNode(k)) {
+            ctx.warnings.push({ page: ctx.sectionNum, message: `\uBBF8\uC9C0\uC6D0 \uC81C\uC5B4 \uC694\uC18C\uC758 \uD14D\uC2A4\uD2B8 \uC190\uC2E4: ${ktag}`, code: "UNSUPPORTED_ELEMENT" });
+          }
+        }
+      }
+    }
+  };
   const walk = (node) => {
     const children = node.childNodes;
     if (!children) return;
     for (let i = 0; i < children.length; i++) {
       const child = children[i];
       if (child.nodeType === 3) {
-        text += child.textContent || "";
+        const t = child.textContent || "";
+        if (isInDeletedRange(ctx)) {
+          if (t && ctx && !ctx.shared.track.warned) {
+            ctx.shared.track.warned = true;
+            ctx.warnings?.push({ page: ctx.sectionNum, message: "\uBCC0\uACBD\uCD94\uC801 \uC0AD\uC81C \uD14D\uC2A4\uD2B8 \uCD9C\uB825 \uC81C\uC678", code: "HIDDEN_TEXT_FILTERED" });
+          }
+        } else {
+          text += t;
+        }
         continue;
       }
       if (child.nodeType !== 1) continue;
@@ -1506,6 +1923,10 @@ function extractParagraphInfo(para, styleMap) {
         case "br":
           if ((child.getAttribute("type") || "line") === "line") text += "\n";
           break;
+        case "lineBreak":
+          text += "\n";
+          break;
+        // 강제 줄바꿈 — ref 추출기·소스맵 스캐너와 동일 모델
         case "fwSpace":
         case "hwSpace":
           text += " ";
@@ -1532,9 +1953,26 @@ function extractParagraphInfo(para, styleMap) {
           if (noteText) footnote = (footnote ? footnote + "; " : "") + noteText;
           break;
         }
-        // 제어 요소 — 필드, 컨트롤, 매개변수 등 스킵
+        // 제어 요소 — 선별 순회 (머리말/꼬리말/각주/하이퍼링크/변경추적, v3.0)
         case "ctrl":
-        case "fieldBegin":
+          handleCtrl(child);
+          break;
+        // run 직계 fieldBegin (비표준 경로) — 하이퍼링크 URL만 추출
+        case "fieldBegin": {
+          const url = extractHyperlinkHref(child);
+          if (url && !href) href = url;
+          break;
+        }
+        // run 직계 변경추적 마커 (비표준 경로)
+        case "deleteBegin":
+          if (ctx) ctx.shared.track.deleteDepth++;
+          break;
+        case "deleteEnd":
+          if (ctx && ctx.shared.track.deleteDepth > 0) ctx.shared.track.deleteDepth--;
+          break;
+        case "insertBegin":
+        case "insertEnd":
+          break;
         case "fieldEnd":
         case "parameters":
         case "stringParam":
@@ -1548,7 +1986,7 @@ function extractParagraphInfo(para, styleMap) {
         case "linesegarray":
         case "lineseg":
         // 레이아웃 정보
-        // 도형/이미지 요소 — 대체텍스트("사각형입니다." 등) 누출 방지
+        // 도형/이미지 요소 — 대체텍스트("사각형입니다." 등) 누출 방지 (walkParagraphChildren에서 처리)
         case "pic":
         case "shape":
         case "drawingObject":
@@ -1635,8 +2073,14 @@ var TAG_CHAR_SHAPE = 68;
 var TAG_CTRL_HEADER = 71;
 var TAG_LIST_HEADER = 72;
 var TAG_TABLE = 77;
+var TAG_SHAPE_COMPONENT = 76;
+var TAG_SHAPE_COMPONENT_PICTURE = 85;
+var TAG_SHAPE_COMPONENT_CONTAINER = 86;
 var TAG_EQEDIT = 88;
+var TAG_BIN_DATA = 18;
 var TAG_DOC_CHAR_SHAPE = 21;
+var TAG_NUMBERING = 23;
+var TAG_BULLET = 24;
 var TAG_DOC_PARA_SHAPE = 25;
 var TAG_DOC_STYLE = 26;
 var CHAR_LINE = 0;
@@ -1692,15 +2136,76 @@ function parseFileHeader(data) {
     flags: data.readUInt32LE(36)
   };
 }
+function readHwpString(data, offset) {
+  if (offset + 2 > data.length) return { value: "", next: data.length };
+  const len = data.readUInt16LE(offset);
+  const start = offset + 2;
+  const end = start + len * 2;
+  if (len === 0 || end > data.length) return { value: "", next: start };
+  return { value: data.subarray(start, end).toString("utf16le"), next: end };
+}
 function parseDocInfo(records) {
   const charShapes = [];
   const paraShapes = [];
   const styles = [];
+  const binData = [];
+  const numberings = [];
+  const bullets = [];
   for (const rec of records) {
     if (rec.tagId === TAG_DOC_PARA_SHAPE && rec.data.length >= 4) {
-      const flags = rec.data.readUInt32LE(0);
-      const outlineLevel = flags >> 25 & 7;
-      paraShapes.push({ outlineLevel });
+      const attr1 = rec.data.readUInt32LE(0);
+      const headType = attr1 >>> 23 & 3;
+      const paraLevel = attr1 >>> 25 & 7;
+      const numberingId = rec.data.length >= 32 ? rec.data.readUInt16LE(30) : 0;
+      paraShapes.push({ headType, paraLevel, numberingId });
+    }
+    if (rec.tagId === TAG_BIN_DATA && rec.data.length >= 2) {
+      const attr = rec.data.readUInt16LE(0);
+      const typeBits = attr & 15;
+      if (typeBits === 0) {
+        binData.push({ kind: "link", storageId: 0, extension: "" });
+      } else {
+        const storageId = rec.data.length >= 4 ? rec.data.readUInt16LE(2) : 0;
+        const { value: extension } = readHwpString(rec.data, 4);
+        binData.push({ kind: typeBits === 2 ? "storage" : "embed", storageId, extension });
+      }
+    }
+    if (rec.tagId === TAG_NUMBERING && rec.data.length >= 14) {
+      const levelFormats = [];
+      const numberFormats = [];
+      const startNumbers = [1, 1, 1, 1, 1, 1, 1];
+      let offset = 0;
+      for (let level = 0; level < 7; level++) {
+        if (offset + 12 > rec.data.length) {
+          levelFormats.push("");
+          numberFormats.push(0);
+          continue;
+        }
+        const attr = rec.data.readUInt32LE(offset);
+        numberFormats.push(attr >>> 5 & 15);
+        offset += 12;
+        const { value, next } = readHwpString(rec.data, offset);
+        levelFormats.push(value);
+        offset = next;
+      }
+      let baseStart = 1;
+      if (offset + 2 <= rec.data.length) {
+        baseStart = rec.data.readUInt16LE(offset) || 1;
+        offset += 2;
+      }
+      for (let level = 0; level < 7; level++) {
+        if (offset + 4 <= rec.data.length) {
+          startNumbers[level] = rec.data.readUInt32LE(offset) || 1;
+          offset += 4;
+        } else {
+          startNumbers[level] = baseStart;
+        }
+      }
+      numberings.push({ levelFormats, numberFormats, startNumbers });
+    }
+    if (rec.tagId === TAG_BULLET && rec.data.length >= 14) {
+      const code = rec.data.readUInt16LE(12);
+      bullets.push({ char: code > 0 ? String.fromCharCode(code) : "\u2022" });
     }
     if (rec.tagId === TAG_DOC_CHAR_SHAPE && rec.data.length >= 18) {
       if (rec.data.length >= 50) {
@@ -1731,7 +2236,7 @@ function parseDocInfo(records) {
         }
         const type = offset < rec.data.length ? rec.data.readUInt8(offset) : 0;
         offset += 1;
-        offset += 2;
+        offset += 1;
         offset += 2;
         const paraShapeId = offset + 2 <= rec.data.length ? rec.data.readUInt16LE(offset) : 0;
         offset += 2;
@@ -1741,11 +2246,25 @@ function parseDocInfo(records) {
       }
     }
   }
-  return { charShapes, paraShapes, styles };
+  return { charShapes, paraShapes, styles, binData, numberings, bullets };
+}
+function createParaTextState() {
+  return { text: "", ctrlIdx: 0, fieldStack: [], fieldRanges: [] };
 }
-function extractTextWithControls(data, resolveControl) {
+function isExtendedOnlyCtrlChar(ch) {
+  return ch >= 1 && ch <= 3 || ch >= 11 && ch <= 12 || ch >= 14 && ch <= 18 || ch >= 21 && ch <= 23;
+}
+function appendParaText(state, data, resolveControl) {
   let result = "";
   let i = 0;
+  const base = state.text.length;
+  const resolveAt = (byteOffset, extended) => {
+    const ctrlId = data.readUInt32LE(byteOffset);
+    const idx = extended ? state.ctrlIdx : -1;
+    const replacement = resolveControl?.(idx, ctrlId);
+    if (replacement) result += replacement;
+    if (extended) state.ctrlIdx++;
+  };
   while (i + 1 < data.length) {
     const ch = data.readUInt16LE(i);
     i += 2;
@@ -1756,9 +2275,7 @@ function extractTextWithControls(data, resolveControl) {
         break;
       case CHAR_SECTION_BREAK: {
         if (i + 16 <= data.length && data.readUInt16LE(i) === 11) {
-          const ctrlId = data.subarray(i + 2, i + 6).toString("ascii");
-          const replacement = resolveControl?.(ctrlId);
-          if (replacement) result += replacement;
+          resolveAt(i + 2, true);
           i += 16;
           break;
         }
@@ -1790,12 +2307,18 @@ function extractTextWithControls(data, resolveControl) {
         break;
       default:
         if (ch >= 1 && ch <= 31) {
-          const isExtended = ch >= 1 && ch <= 3 || ch >= 11 && ch <= 12 || ch >= 14 && ch <= 18 || ch >= 21 && ch <= 23;
+          const isExtended = isExtendedOnlyCtrlChar(ch);
           const isInline = ch >= 4 && ch <= 9 || ch >= 19 && ch <= 20;
           if ((isExtended || isInline) && i + 14 <= data.length) {
-            const ctrlId = data.subarray(i, i + 4).toString("ascii");
-            const replacement = resolveControl?.(ctrlId);
-            if (replacement) result += replacement;
+            if (ch === 3) {
+              state.fieldStack.push({ start: base + result.length, ctrlIdx: state.ctrlIdx });
+            } else if (ch === 4) {
+              const open = state.fieldStack.pop();
+              if (open) {
+                state.fieldRanges.push({ start: open.start, end: base + result.length, ctrlIdx: open.ctrlIdx });
+              }
+            }
+            resolveAt(i, isExtended);
             i += 14;
           }
         } else if (ch >= 32) {
@@ -1813,7 +2336,7 @@ function extractTextWithControls(data, resolveControl) {
         break;
     }
   }
-  return result;
+  state.text += result;
 }
 function extractEquationText(data) {
   if (data.length < 6) return null;
@@ -1825,100 +2348,407 @@ function extractEquationText(data) {
   return equation || null;
 }
 
-// src/hwp5/aes.ts
-var S_BOX = new Uint8Array([
-  99,
-  124,
-  119,
-  123,
-  242,
-  107,
-  111,
-  197,
-  48,
-  1,
-  103,
-  43,
-  254,
-  215,
-  171,
-  118,
-  202,
-  130,
-  201,
-  125,
-  250,
-  89,
-  71,
-  240,
-  173,
-  212,
-  162,
-  175,
-  156,
-  164,
-  114,
-  192,
-  183,
-  253,
-  147,
-  38,
-  54,
-  63,
-  247,
-  204,
-  52,
-  165,
-  229,
-  241,
-  113,
-  216,
-  49,
-  21,
-  4,
-  199,
-  35,
-  195,
-  24,
-  150,
-  5,
-  154,
-  7,
-  18,
-  128,
-  226,
-  235,
-  39,
-  178,
-  117,
-  9,
-  131,
-  44,
-  26,
-  27,
-  110,
-  90,
-  160,
-  82,
-  59,
-  214,
-  179,
-  41,
-  227,
-  47,
-  132,
-  83,
-  209,
-  0,
-  237,
-  32,
-  252,
-  177,
-  91,
-  106,
-  203,
-  190,
-  57,
+// src/hwp5/numbering.ts
+var NumberingState = class {
+  currentId = 0;
+  counters = [0, 0, 0, 0, 0, 0, 0];
+  history = /* @__PURE__ */ new Map();
+  /** 번호 문단 처리: 카운터 갱신 후 수준별 카운터 스냅샷 반환 */
+  advance(numberingId, level) {
+    const lv = Math.min(Math.max(level, 0), 6);
+    if (this.currentId !== numberingId) {
+      if (this.currentId !== 0) this.history.set(this.currentId, [...this.counters]);
+      const saved = this.history.get(numberingId);
+      if (saved) {
+        this.counters = [...saved];
+      } else {
+        const prev = this.counters;
+        this.counters = [0, 0, 0, 0, 0, 0, 0];
+        for (let i = 0; i < lv; i++) this.counters[i] = prev[i];
+      }
+      this.currentId = numberingId;
+    }
+    this.counters[lv]++;
+    for (let i = lv + 1; i < 7; i++) this.counters[i] = 0;
+    return [...this.counters];
+  }
+};
+function headFormatToNumFmt(code) {
+  switch (code) {
+    case 1:
+      return "circled";
+    case 2:
+      return "romanUpper";
+    case 3:
+      return "romanLower";
+    case 4:
+      return "latinUpper";
+    case 5:
+      return "latinLower";
+    case 8:
+      return "ganada";
+    case 9:
+      return "circledGanada";
+    case 10:
+      return "jamo";
+    case 11:
+      return "circledJamo";
+    case 12:
+      return "hangulNum";
+    case 13:
+      return "hanjaNum";
+    default:
+      return "digit";
+  }
+}
+function shapeFormatToNumFmt(code) {
+  switch (code) {
+    case 1:
+      return "circled";
+    case 2:
+      return "romanUpper";
+    case 3:
+      return "romanLower";
+    case 4:
+      return "latinUpper";
+    case 5:
+      return "latinLower";
+    case 6:
+      return "ganada";
+    case 7:
+      return "hangulNum";
+    case 8:
+      return "hanjaNum";
+    default:
+      return "digit";
+  }
+}
+var CIRCLED_DIGITS = "\u2460\u2461\u2462\u2463\u2464\u2465\u2466\u2467\u2468\u2469\u246A\u246B\u246C\u246D\u246E\u246F\u2470\u2471\u2472\u2473";
+var GANADA = "\uAC00\uB098\uB2E4\uB77C\uB9C8\uBC14\uC0AC\uC544\uC790\uCC28\uCE74\uD0C0\uD30C\uD558";
+var CIRCLED_GANADA = "\u326E\u326F\u3270\u3271\u3272\u3273\u3274\u3275\u3276\u3277\u3278\u3279\u327A\u327B";
+var JAMO = "\u3131\u3134\u3137\u3139\u3141\u3142\u3145\u3147\u3148\u314A\u314B\u314C\u314D\u314E";
+var CIRCLED_JAMO = "\u3260\u3261\u3262\u3263\u3264\u3265\u3266\u3267\u3268\u3269\u326A\u326B\u326C\u326D";
+function fromTable(n, table) {
+  return n >= 1 && n <= table.length ? table[n - 1] : String(n);
+}
+function formatRoman(n, upper) {
+  if (n <= 0 || n > 3999) return String(n);
+  const values = [1e3, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1];
+  const symbols = upper ? ["M", "CM", "D", "CD", "C", "XC", "L", "XL", "X", "IX", "V", "IV", "I"] : ["m", "cm", "d", "cd", "c", "xc", "l", "xl", "x", "ix", "v", "iv", "i"];
+  let result = "";
+  let num = n;
+  for (let i = 0; i < values.length; i++) {
+    while (num >= values[i]) {
+      result += symbols[i];
+      num -= values[i];
+    }
+  }
+  return result;
+}
+function formatLatin(n, upper) {
+  if (n <= 0) return "";
+  let result = "";
+  let num = n;
+  while (num > 0) {
+    num--;
+    result = String.fromCharCode((upper ? 65 : 97) + num % 26) + result;
+    num = Math.floor(num / 26);
+  }
+  return result;
+}
+function formatEastAsianNumber(n, digits, units, zero) {
+  if (n === 0) return zero;
+  if (n < 0 || n > 99999) return String(n);
+  let result = "";
+  let num = n;
+  let unit = 0;
+  while (num > 0) {
+    const d = num % 10;
+    if (d > 0) {
+      const digitStr = d === 1 && unit > 0 ? "" : digits[d];
+      result = digitStr + units[unit] + result;
+    }
+    num = Math.floor(num / 10);
+    unit++;
+  }
+  return result;
+}
+var HANGUL_DIGITS = ["", "\uC77C", "\uC774", "\uC0BC", "\uC0AC", "\uC624", "\uC721", "\uCE60", "\uD314", "\uAD6C"];
+var HANGUL_UNITS = ["", "\uC2ED", "\uBC31", "\uCC9C", "\uB9CC"];
+var HANJA_DIGITS = ["", "\u4E00", "\u4E8C", "\u4E09", "\u56DB", "\u4E94", "\u516D", "\u4E03", "\u516B", "\u4E5D"];
+var HANJA_UNITS = ["", "\u5341", "\u767E", "\u5343", "\u842C"];
+function formatNumber(n, fmt) {
+  switch (fmt) {
+    case "circled":
+      return fromTable(n, CIRCLED_DIGITS);
+    case "romanUpper":
+      return formatRoman(n, true);
+    case "romanLower":
+      return formatRoman(n, false);
+    case "latinUpper":
+      return formatLatin(n, true) || String(n);
+    case "latinLower":
+      return formatLatin(n, false) || String(n);
+    case "ganada":
+      return fromTable(n, GANADA);
+    case "circledGanada":
+      return fromTable(n, CIRCLED_GANADA);
+    case "jamo":
+      return fromTable(n, JAMO);
+    case "circledJamo":
+      return fromTable(n, CIRCLED_JAMO);
+    case "hangulNum":
+      return formatEastAsianNumber(n, HANGUL_DIGITS, HANGUL_UNITS, "\uC601");
+    case "hanjaNum":
+      return formatEastAsianNumber(n, HANJA_DIGITS, HANJA_UNITS, "\u96F6");
+    default:
+      return String(n);
+  }
+}
+function expandNumberingFormat(formatStr, counters, numbering) {
+  let result = "";
+  let i = 0;
+  while (i < formatStr.length) {
+    const ch = formatStr[i];
+    if (ch === "^" && i + 1 < formatStr.length && formatStr[i + 1] >= "1" && formatStr[i + 1] <= "7") {
+      const levelRef = formatStr.charCodeAt(i + 1) - 48;
+      const idx = levelRef - 1;
+      const counterVal = counters[idx] ?? 0;
+      const start = numbering.startNumbers[idx] ?? 1;
+      const num = counterVal > 0 ? start - 1 + counterVal : start;
+      result += formatNumber(num, headFormatToNumFmt(numbering.numberFormats[idx] ?? 0));
+      i += 2;
+      continue;
+    }
+    result += ch;
+    i++;
+  }
+  return result;
+}
+
+// src/hwp5/images.ts
+function detectImageMime(data) {
+  if (data.length < 4) return null;
+  if (data[0] === 137 && data[1] === 80 && data[2] === 78 && data[3] === 71) return "image/png";
+  if (data[0] === 255 && data[1] === 216 && data[2] === 255) return "image/jpeg";
+  if (data[0] === 71 && data[1] === 73 && data[2] === 70) return "image/gif";
+  if (data[0] === 66 && data[1] === 77) return "image/bmp";
+  if (data[0] === 215 && data[1] === 205 && data[2] === 198 && data[3] === 154) return "image/wmf";
+  if (data[0] === 1 && data[1] === 0 && data[2] === 0 && data[3] === 0) return "image/emf";
+  return null;
+}
+function normalizeBinPayload(data) {
+  if (detectImageMime(data)) return data;
+  try {
+    const inflated = decompressStream(data);
+    if (inflated.length > 0) return inflated;
+  } catch {
+  }
+  return data;
+}
+var BIN_ENTRY_RE = /(?:^|\/)BIN([0-9A-Fa-f]{4,8})(?:\.[^./\\]*)?$/;
+function collectImageBlocks2(blocks, out) {
+  for (const b of blocks) {
+    if (b.type === "image") out.push(b);
+    if (b.table) {
+      for (const row of b.table.cells) {
+        for (const cell of row) {
+          if (cell.blocks) collectImageBlocks2(cell.blocks, out);
+        }
+      }
+    }
+    if (b.children) collectImageBlocks2(b.children, out);
+  }
+}
+function forEachTableCell(blocks, fn) {
+  for (const b of blocks) {
+    if (b.table) {
+      for (const row of b.table.cells) {
+        for (const cell of row) {
+          fn(cell);
+          if (cell.blocks) forEachTableCell(cell.blocks, fn);
+        }
+      }
+    }
+    if (b.children) forEachTableCell(b.children, fn);
+  }
+}
+var CELL_IMAGE_SENTINEL_RE = /!\[image\]\(hwp5bin:(\d+)\)/g;
+function resolveCellImageSentinels(blocks, renamed) {
+  forEachTableCell(blocks, (cell) => {
+    if (!cell.text.includes("hwp5bin:")) return;
+    cell.text = cell.text.replace(CELL_IMAGE_SENTINEL_RE, (_m, idStr) => {
+      const filename = renamed.get(Number(idStr));
+      return filename ? `![image](${filename})` : "[\uC774\uBBF8\uC9C0]";
+    });
+  });
+}
+function resolveImageBlocks(binDataMap, blocks, warnings) {
+  const imageBlocks = [];
+  collectImageBlocks2(blocks, imageBlocks);
+  if (imageBlocks.length === 0) return [];
+  const images = [];
+  const renamed = /* @__PURE__ */ new Map();
+  let imageIndex = 0;
+  for (const block of imageBlocks) {
+    if (!block.text) continue;
+    const storageId = parseInt(block.text, 10);
+    if (isNaN(storageId)) continue;
+    const bin = binDataMap.get(storageId);
+    if (!bin) {
+      warnings.push({ page: block.pageNumber, message: `BinData ${storageId} \uC5C6\uC74C`, code: "SKIPPED_IMAGE" });
+      block.type = "paragraph";
+      block.text = `[\uC774\uBBF8\uC9C0: BinData ${storageId}]`;
+      continue;
+    }
+    const mime = detectImageMime(bin.data);
+    if (!mime) {
+      warnings.push({ page: block.pageNumber, message: `BinData ${storageId}: \uC54C \uC218 \uC5C6\uB294 \uC774\uBBF8\uC9C0 \uD615\uC2DD`, code: "SKIPPED_IMAGE" });
+      block.type = "paragraph";
+      block.text = `[\uC774\uBBF8\uC9C0: ${bin.name}]`;
+      continue;
+    }
+    imageIndex++;
+    const ext = mime.includes("jpeg") ? "jpg" : mime.includes("png") ? "png" : mime.includes("gif") ? "gif" : mime.includes("bmp") ? "bmp" : "bin";
+    const filename = `image_${String(imageIndex).padStart(3, "0")}.${ext}`;
+    images.push({ filename, data: new Uint8Array(bin.data), mimeType: mime });
+    renamed.set(storageId, filename);
+    block.text = filename;
+    block.imageData = { data: new Uint8Array(bin.data), mimeType: mime, filename: bin.name };
+  }
+  resolveCellImageSentinels(blocks, renamed);
+  return images;
+}
+function extractHwp5Images(fileIndex, blocks, warnings) {
+  const binDataMap = /* @__PURE__ */ new Map();
+  if (fileIndex) {
+    for (const entry of fileIndex) {
+      if (!entry?.name || !entry.content) continue;
+      const match = entry.name.match(BIN_ENTRY_RE);
+      if (!match) continue;
+      const idx = parseInt(match[1], 16);
+      const data = normalizeBinPayload(Buffer.from(entry.content));
+      binDataMap.set(idx, { data, name: entry.name });
+    }
+  }
+  if (binDataMap.size === 0) {
+    resolveCellImageSentinels(blocks, /* @__PURE__ */ new Map());
+    return [];
+  }
+  return resolveImageBlocks(binDataMap, blocks, warnings);
+}
+function extractHwp5ImagesLenient(lcfb, blocks, warnings) {
+  const binDataMap = /* @__PURE__ */ new Map();
+  const binRe = /^BIN([0-9A-Fa-f]{4,8})(?:\.|$)/;
+  for (const e of lcfb.entries()) {
+    const match = e.name.match(binRe);
+    if (!match) continue;
+    const idx = parseInt(match[1], 16);
+    const raw = lcfb.findStream(e.name);
+    if (!raw) continue;
+    binDataMap.set(idx, { data: normalizeBinPayload(raw), name: e.name });
+  }
+  if (binDataMap.size === 0) {
+    resolveCellImageSentinels(blocks, /* @__PURE__ */ new Map());
+    return [];
+  }
+  return resolveImageBlocks(binDataMap, blocks, warnings);
+}
+
+// src/hwp5/aes.ts
+var S_BOX = new Uint8Array([
+  99,
+  124,
+  119,
+  123,
+  242,
+  107,
+  111,
+  197,
+  48,
+  1,
+  103,
+  43,
+  254,
+  215,
+  171,
+  118,
+  202,
+  130,
+  201,
+  125,
+  250,
+  89,
+  71,
+  240,
+  173,
+  212,
+  162,
+  175,
+  156,
+  164,
+  114,
+  192,
+  183,
+  253,
+  147,
+  38,
+  54,
+  63,
+  247,
+  204,
+  52,
+  165,
+  229,
+  241,
+  113,
+  216,
+  49,
+  21,
+  4,
+  199,
+  35,
+  195,
+  24,
+  150,
+  5,
+  154,
+  7,
+  18,
+  128,
+  226,
+  235,
+  39,
+  178,
+  117,
+  9,
+  131,
+  44,
+  26,
+  27,
+  110,
+  90,
+  160,
+  82,
+  59,
+  214,
+  179,
+  41,
+  227,
+  47,
+  132,
+  83,
+  209,
+  0,
+  237,
+  32,
+  252,
+  177,
+  91,
+  106,
+  203,
+  190,
+  57,
   74,
   76,
   88,
@@ -2751,6 +3581,66 @@ var require2 = createRequire(import.meta.url);
 var CFB = require2("cfb");
 var MAX_SECTIONS = 100;
 var MAX_TOTAL_DECOMPRESS = 100 * 1024 * 1024;
+var MAX_NEST_DEPTH = 8;
+function cid(s) {
+  return (s.charCodeAt(0) << 24 | s.charCodeAt(1) << 16 | s.charCodeAt(2) << 8 | s.charCodeAt(3)) >>> 0;
+}
+var CTRL_TBL = cid("tbl ");
+var CTRL_GSO = cid("gso ");
+var CTRL_EQED = cid("eqed");
+var CTRL_HEAD = cid("head");
+var CTRL_FOOT = cid("foot");
+var CTRL_FN = cid("fn  ");
+var CTRL_EN = cid("en  ");
+var CTRL_ATNO = cid("atno");
+var CTRL_NWNO = cid("nwno");
+var CTRL_PGNP = cid("pgnp");
+var CTRL_PGHD = cid("pghd");
+var CTRL_IDXM = cid("idxm");
+var CTRL_BOKM = cid("bokm");
+var CTRL_TCPS = cid("tcps");
+var CTRL_TDUT = cid("tdut");
+var CTRL_TCMT = cid("tcmt");
+var CTRL_SECD = cid("secd");
+var CTRL_COLD = cid("cold");
+var CTRL_FORM = cid("form");
+var CTRL_OLE = cid("ole ");
+var FIELD_HLK = cid("%hlk");
+var FIELD_CLK = cid("%clk");
+var KNOWN_CTRL_IDS = /* @__PURE__ */ new Set([
+  CTRL_TBL,
+  CTRL_GSO,
+  CTRL_EQED,
+  CTRL_HEAD,
+  CTRL_FOOT,
+  CTRL_FN,
+  CTRL_EN,
+  CTRL_ATNO,
+  CTRL_NWNO,
+  CTRL_PGNP,
+  CTRL_PGHD,
+  CTRL_IDXM,
+  CTRL_BOKM,
+  CTRL_TCPS,
+  CTRL_TDUT,
+  CTRL_TCMT,
+  CTRL_SECD,
+  CTRL_COLD,
+  CTRL_FORM,
+  CTRL_OLE
+]);
+function isFieldCtrlId(id) {
+  return id >>> 24 === 37;
+}
+function swap32(id) {
+  return ((id & 255) << 24 | (id >>> 8 & 255) << 16 | (id >>> 16 & 255) << 8 | id >>> 24 & 255) >>> 0;
+}
+function normalizeCtrlId(raw) {
+  if (KNOWN_CTRL_IDS.has(raw) || isFieldCtrlId(raw)) return raw;
+  const sw = swap32(raw);
+  if (KNOWN_CTRL_IDS.has(sw) || isFieldCtrlId(sw)) return sw;
+  return raw;
+}
 function parseHwp5Document(buffer, options) {
   let cfb = null;
   let lenientCfb = null;
@@ -2790,8 +3680,8 @@ function parseHwp5Document(buffer, options) {
   metadata.pageCount = sections.length;
   const pageFilter = options?.pages ? parsePageRange(options.pages, sections.length) : null;
   const totalTarget = pageFilter ? pageFilter.size : sections.length;
-  const blocks = [];
-  const nestedTableCounter = { count: 0 };
+  const bodyBlocks = [];
+  const doc = createHwp5DocState();
   let totalDecompressed = 0;
   let parsedSections = 0;
   for (let si = 0; si < sections.length; si++) {
@@ -2802,8 +3692,8 @@ function parseHwp5Document(buffer, options) {
       totalDecompressed += data.length;
       if (totalDecompressed > MAX_TOTAL_DECOMPRESS) throw new KordocError("\uCD1D \uC555\uCD95 \uD574\uC81C \uD06C\uAE30 \uCD08\uACFC (decompression bomb \uC758\uC2EC)");
       const records = readRecords(data);
-      const sectionBlocks = parseSection(records, docInfo, warnings, si + 1, nestedTableCounter);
-      blocks.push(...sectionBlocks);
+      const sectionBlocks = parseSection(records, docInfo, warnings, si + 1, doc);
+      bodyBlocks.push(...sectionBlocks);
       parsedSections++;
       options?.onProgress?.(parsedSections, totalTarget);
     } catch (secErr) {
@@ -2811,7 +3701,8 @@ function parseHwp5Document(buffer, options) {
       warnings.push({ page: si + 1, message: `\uC139\uC158 ${si + 1} \uD30C\uC2F1 \uC2E4\uD328: ${secErr instanceof Error ? secErr.message : "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958"}`, code: "PARTIAL_PARSE" });
     }
   }
-  const images = cfb ? extractHwp5Images(cfb, blocks, compressed, warnings) : extractHwp5ImagesLenient(lenientCfb, blocks, compressed, warnings);
+  const blocks = [...doc.headerBlocks, ...bodyBlocks, ...doc.footerBlocks];
+  const images = cfb ? extractHwp5Images(cfb.FileIndex, blocks, warnings) : extractHwp5ImagesLenient(lenientCfb, blocks, warnings);
   const flatBlocks = flattenLayoutTables(blocks);
   if (docInfo) {
     detectHwp5Headings(flatBlocks, docInfo);
@@ -2842,28 +3733,28 @@ function parseDocInfoFromStream(raw, compressed) {
 }
 function detectHwp5Headings(blocks, docInfo) {
   let baseFontSize = 0;
-  for (const style of docInfo.styles) {
-    const name = (style.nameKo || style.name).toLowerCase();
-    if (name.includes("\uBC14\uD0D5") || name.includes("\uBCF8\uBB38") || name === "normal" || name === "body") {
-      const cs = docInfo.charShapes[style.charShapeId];
-      if (cs?.fontSize > 0) {
-        baseFontSize = cs.fontSize / 10;
-        break;
-      }
+  const sizeFreq = /* @__PURE__ */ new Map();
+  for (const b of blocks) {
+    if (b.style?.fontSize && b.text) {
+      sizeFreq.set(b.style.fontSize, (sizeFreq.get(b.style.fontSize) || 0) + b.text.length);
     }
   }
-  if (baseFontSize === 0) {
-    const sizeFreq = /* @__PURE__ */ new Map();
-    for (const b of blocks) {
-      if (b.style?.fontSize) {
-        sizeFreq.set(b.style.fontSize, (sizeFreq.get(b.style.fontSize) || 0) + 1);
-      }
+  let maxWeight = 0;
+  for (const [size, weight] of sizeFreq) {
+    if (weight > maxWeight) {
+      maxWeight = weight;
+      baseFontSize = size;
     }
-    let maxCount = 0;
-    for (const [size, count] of sizeFreq) {
-      if (count > maxCount) {
-        maxCount = count;
-        baseFontSize = size;
+  }
+  if (baseFontSize === 0) {
+    for (const style of docInfo.styles) {
+      const name = (style.nameKo || style.name).toLowerCase();
+      if (name.includes("\uBC14\uD0D5") || name.includes("\uBCF8\uBB38") || name === "normal" || name === "body") {
+        const cs = docInfo.charShapes[style.charShapeId];
+        if (cs?.fontSize > 0) {
+          baseFontSize = cs.fontSize / 10;
+          break;
+        }
       }
     }
   }
@@ -3001,414 +3892,397 @@ function findViewTextSectionsLenient(lcfb, compressed) {
   }
   return sections.sort((a, b) => a.idx - b.idx).map((s) => s.content);
 }
-var TAG_SHAPE_COMPONENT = 74;
-var CTRL_ID_EQEDIT = "deqe";
-function extractBinDataId(records, ctrlIdx) {
-  const ctrlLevel = records[ctrlIdx].level;
-  for (let j = ctrlIdx + 1; j < records.length && j < ctrlIdx + 50; j++) {
-    const r = records[j];
-    if (r.level <= ctrlLevel) break;
-    if (r.data.length >= 2) {
-      if (r.tagId > TAG_SHAPE_COMPONENT && r.level > ctrlLevel + 1 && r.data.length >= 4) {
-        const possibleId = r.data.readUInt16LE(0);
-        if (possibleId < 1e4) return possibleId;
-      }
-    }
-  }
-  return -1;
-}
-function isEquationControlId(ctrlId) {
-  return ctrlId === CTRL_ID_EQEDIT || ctrlId === "eqed";
-}
 function formatEquationForMarkdown(equation) {
   const normalized = hwpEquationToLatex(equation);
   if (!normalized) return "";
   return `$${normalized.replace(/\$/g, "\\$")}$`;
 }
-function extractEquationFromControl(records, ctrlIdx) {
-  const ctrlLevel = records[ctrlIdx].level;
-  for (let j = ctrlIdx + 1; j < records.length && j < ctrlIdx + 10; j++) {
-    const r = records[j];
-    if (r.level <= ctrlLevel) break;
-    if (r.tagId !== TAG_EQEDIT) continue;
-    const equation = extractEquationText(r.data);
+function extractEquationFromSlice(records, start, end) {
+  for (let i = start; i < end; i++) {
+    if (records[i].tagId !== TAG_EQEDIT) continue;
+    const equation = extractEquationText(records[i].data);
     return equation ? formatEquationForMarkdown(equation) : null;
   }
   return null;
 }
-function renderTextWithEquations(textRecords, equations) {
-  const queue = [...equations];
-  return textRecords.map((data) => extractTextWithControls(data, (ctrlId) => {
-    if (!isEquationControlId(ctrlId) || queue.length === 0) return null;
-    return queue.shift();
-  })).join("").replace(/\$\$/g, "$ $");
+function createHwp5DocState() {
+  return {
+    numbering: new NumberingState(),
+    outlineNumberingId: 0,
+    autoCounters: /* @__PURE__ */ new Map(),
+    headerTexts: /* @__PURE__ */ new Set(),
+    headerBlocks: [],
+    footerBlocks: []
+  };
 }
-function detectImageMime(data) {
-  if (data.length < 4) return null;
-  if (data[0] === 137 && data[1] === 80 && data[2] === 78 && data[3] === 71) return "image/png";
-  if (data[0] === 255 && data[1] === 216 && data[2] === 255) return "image/jpeg";
-  if (data[0] === 71 && data[1] === 73 && data[2] === 70) return "image/gif";
-  if (data[0] === 66 && data[1] === 77) return "image/bmp";
-  if (data[0] === 215 && data[1] === 205 && data[2] === 198 && data[3] === 154) return "image/wmf";
-  if (data[0] === 1 && data[1] === 0 && data[2] === 0 && data[3] === 0) return "image/emf";
-  return null;
+function parseSection(records, docInfo, warnings, sectionNum, doc) {
+  const ctx = { docInfo, warnings, sectionNum, doc: doc ?? createHwp5DocState(), depth: 0 };
+  return parseParagraphList(records, 0, records.length, ctx);
 }
-function extractHwp5Images(cfb, blocks, compressed, warnings) {
-  const binDataMap = /* @__PURE__ */ new Map();
-  const binDataRe = /\/BinData\/[Bb][Ii][Nn](\d{4})$/;
-  if (cfb.FileIndex) {
-    for (const entry of cfb.FileIndex) {
-      if (!entry?.name || !entry.content) continue;
-      const match = entry.name.match(binDataRe);
-      if (!match) continue;
-      const idx = parseInt(match[1], 10);
-      let data = Buffer.from(entry.content);
-      if (compressed) {
-        try {
-          data = decompressStream(data);
-        } catch {
-        }
-      }
-      binDataMap.set(idx, { data, name: entry.name });
+function parseParagraphList(records, start, end, ctx) {
+  const blocks = [];
+  let i = start;
+  while (i < end) {
+    if (records[i].tagId === TAG_PARA_HEADER) {
+      const baseLevel = records[i].level;
+      let j = i + 1;
+      while (j < end && records[j].level > baseLevel) j++;
+      blocks.push(...parseParagraph(records, i, j, ctx));
+      i = j;
+    } else {
+      i++;
     }
   }
-  if (binDataMap.size === 0) return [];
-  const images = [];
-  let imageIndex = 0;
-  for (const block of blocks) {
-    if (block.type !== "image" || !block.text) continue;
-    const binId = parseInt(block.text, 10);
-    if (isNaN(binId)) continue;
-    const bin = binDataMap.get(binId);
-    if (!bin) {
-      warnings.push({ page: block.pageNumber, message: `BinData ${binId} \uC5C6\uC74C`, code: "SKIPPED_IMAGE" });
-      block.type = "paragraph";
-      block.text = `[\uC774\uBBF8\uC9C0: BinData ${binId}]`;
+  return blocks;
+}
+function parseParagraph(records, start, end, ctx) {
+  const header = records[start];
+  const baseLevel = header.level;
+  const paraShapeId = header.data.length >= 10 ? header.data.readUInt16LE(8) : -1;
+  const textRecords = [];
+  const charShapeIds = [];
+  const ctrls = [];
+  let i = start + 1;
+  while (i < end) {
+    const rec = records[i];
+    if (rec.tagId === TAG_CTRL_HEADER && rec.level === baseLevel + 1 && rec.data.length >= 4) {
+      const childStart = i + 1;
+      let j = childStart;
+      while (j < end && records[j].level > baseLevel + 1) j++;
+      const idRaw = rec.data.readUInt32LE(0);
+      ctrls.push({ id: normalizeCtrlId(idRaw), idRaw, data: rec.data, childStart, childEnd: j });
+      i = j;
       continue;
     }
-    const mime = detectImageMime(bin.data);
-    if (!mime) {
-      warnings.push({ page: block.pageNumber, message: `BinData ${binId}: \uC54C \uC218 \uC5C6\uB294 \uC774\uBBF8\uC9C0 \uD615\uC2DD`, code: "SKIPPED_IMAGE" });
-      block.type = "paragraph";
-      block.text = `[\uC774\uBBF8\uC9C0: ${bin.name}]`;
-      continue;
-    }
-    imageIndex++;
-    const ext = mime.includes("jpeg") ? "jpg" : mime.includes("png") ? "png" : mime.includes("gif") ? "gif" : mime.includes("bmp") ? "bmp" : "bin";
-    const filename = `image_${String(imageIndex).padStart(3, "0")}.${ext}`;
-    images.push({ filename, data: new Uint8Array(bin.data), mimeType: mime });
-    block.text = filename;
-    block.imageData = { data: new Uint8Array(bin.data), mimeType: mime, filename: bin.name };
-  }
-  return images;
-}
-function extractHwp5ImagesLenient(lcfb, blocks, compressed, warnings) {
-  const binDataMap = /* @__PURE__ */ new Map();
-  const binRe = /^BIN(\d{4})/i;
-  for (const e of lcfb.entries()) {
-    const match = e.name.match(binRe);
-    if (!match) continue;
-    const idx = parseInt(match[1], 10);
-    let raw = lcfb.findStream(e.name);
-    if (!raw) continue;
-    if (compressed) {
-      try {
-        raw = decompressStream(raw);
-      } catch {
+    if (rec.tagId === TAG_PARA_TEXT && rec.level === baseLevel + 1) {
+      textRecords.push(rec.data);
+    } else if (rec.tagId === TAG_CHAR_SHAPE && rec.level === baseLevel + 1 && rec.data.length >= 8) {
+      for (let offset = 0; offset + 7 < rec.data.length; offset += 8) {
+        charShapeIds.push(rec.data.readUInt32LE(offset + 4));
       }
     }
-    binDataMap.set(idx, { data: raw, name: e.name });
+    i++;
   }
-  if (binDataMap.size === 0) return [];
-  const images = [];
-  let imageIndex = 0;
-  for (const block of blocks) {
-    if (block.type !== "image" || !block.text) continue;
-    const binId = parseInt(block.text, 10);
-    if (isNaN(binId)) continue;
-    const bin = binDataMap.get(binId);
-    if (!bin) {
-      warnings.push({ page: block.pageNumber, message: `BinData ${binId} \uFFFD\uFFFD\uFFFD\uC74C`, code: "SKIPPED_IMAGE" });
-      block.type = "paragraph";
-      block.text = `[\uC774\uBBF8\uC9C0: BinData ${binId}]`;
-      continue;
+  for (const ctrl of ctrls) {
+    applyCtrlEffect(ctrl, records, ctx);
+  }
+  const state = createParaTextState();
+  const resolver = (idx, id) => {
+    let ctrl = idx >= 0 && idx < ctrls.length ? ctrls[idx] : void 0;
+    if (!ctrl || ctrl.idRaw !== id && ctrl.id !== id) {
+      ctrl = ctrls.find((c) => !c.resolved && (c.idRaw === id || c.id === id));
     }
-    const mime = detectImageMime(bin.data);
-    if (!mime) {
-      warnings.push({ page: block.pageNumber, message: `BinData ${binId}: \uC54C \uC218 \uC5C6\uB294 \uC774\uBBF8\uC9C0 \uD615\uC2DD`, code: "SKIPPED_IMAGE" });
-      block.type = "paragraph";
-      block.text = `[\uC774\uBBF8\uC9C0: ${bin.name}]`;
-      continue;
+    if (!ctrl) return null;
+    ctrl.resolved = true;
+    return ctrl.inlineText ?? null;
+  };
+  for (const data of textRecords) {
+    appendParaText(state, data, resolver);
+  }
+  let text = state.text;
+  if (state.fieldRanges.length > 0) {
+    const ranges = [...state.fieldRanges].sort((a, b) => b.start - a.start);
+    const applied = [];
+    for (const r of ranges) {
+      const ctrl = ctrls[r.ctrlIdx];
+      if (!ctrl?.href || r.end <= r.start) continue;
+      if (applied.some(([s, e]) => r.start < e && r.end > s)) continue;
+      const href = sanitizeHref(ctrl.href);
+      if (!href) continue;
+      const anchor = text.slice(r.start, r.end);
+      if (!anchor.trim()) continue;
+      text = text.slice(0, r.start) + `[${anchor}](${href})` + text.slice(r.end);
+      applied.push([r.start, r.end]);
     }
-    imageIndex++;
-    const ext = mime.includes("jpeg") ? "jpg" : mime.includes("png") ? "png" : mime.includes("gif") ? "gif" : mime.includes("bmp") ? "bmp" : "bin";
-    const filename = `image_${String(imageIndex).padStart(3, "0")}.${ext}`;
-    images.push({ filename, data: new Uint8Array(bin.data), mimeType: mime });
-    block.text = filename;
-    block.imageData = { data: new Uint8Array(bin.data), mimeType: mime, filename: bin.name };
   }
-  return images;
-}
-function parseSection(records, docInfo, warnings, sectionNum, counter) {
-  const blocks = [];
-  let i = 0;
-  while (i < records.length) {
-    const rec = records[i];
-    if (rec.tagId === TAG_PARA_HEADER && rec.level === 0) {
-      const { paragraph, tables, nextIdx, charShapeIds, paraShapeId } = parseParagraphWithTables(records, i, counter);
-      if (paragraph) {
-        const block = { type: "paragraph", text: paragraph, pageNumber: sectionNum };
-        if (docInfo && charShapeIds.length > 0) {
-          const style = resolveCharStyle(charShapeIds, docInfo);
-          if (style) block.style = style;
-        }
-        if (docInfo && paraShapeId >= 0 && paraShapeId < docInfo.paraShapes.length) {
-          const ol = docInfo.paraShapes[paraShapeId].outlineLevel;
-          if (ol >= 1 && ol <= 6) {
-            block.type = "heading";
-            block.level = ol;
-          }
-        }
-        blocks.push(block);
-      }
-      for (const t of tables) blocks.push({ type: "table", table: t, pageNumber: sectionNum });
-      i = nextIdx;
-      continue;
+  const trimmed = text.replace(/\$\$/g, "$ $").trim();
+  let headingLevel = 0;
+  let headMarker = null;
+  const ps = ctx.docInfo && paraShapeId >= 0 && paraShapeId < ctx.docInfo.paraShapes.length ? ctx.docInfo.paraShapes[paraShapeId] : null;
+  if (ps && ps.headType > 0) {
+    if (ps.headType === 1) {
+      headingLevel = Math.min(ps.paraLevel + 1, 6);
     }
-    if (rec.tagId === TAG_CTRL_HEADER && rec.level <= 1 && rec.data.length >= 4) {
-      const ctrlId = rec.data.subarray(0, 4).toString("ascii");
-      if (ctrlId === " lbt" || ctrlId === "tbl ") {
-        const { table, nextIdx } = parseTableBlock(records, i, counter);
-        if (table) blocks.push({ type: "table", table, pageNumber: sectionNum });
-        i = nextIdx;
-        continue;
-      }
-      if (ctrlId === "gso " || ctrlId === " osg") {
-        const binId = extractBinDataId(records, i);
-        if (binId >= 0) {
-          blocks.push({ type: "image", text: String(binId), pageNumber: sectionNum });
-        } else {
-          const boxText = extractTextBoxText(records, i);
-          if (boxText) {
-            blocks.push({ type: "paragraph", text: boxText, pageNumber: sectionNum });
-          }
-        }
-      } else if (ctrlId === " elo" || ctrlId === "ole ") {
-        warnings.push({ page: sectionNum, message: `\uC2A4\uD0B5\uB41C \uC81C\uC5B4 \uC694\uC18C: ${ctrlId.trim()}`, code: "SKIPPED_IMAGE" });
-      } else if (ctrlId === "fn  " || ctrlId === " nf " || ctrlId === "en  " || ctrlId === " ne ") {
-        const noteText = extractNoteText(records, i);
-        if (noteText && blocks.length > 0) {
-          const lastBlock = blocks[blocks.length - 1];
-          if (lastBlock.type === "paragraph") {
-            lastBlock.footnoteText = lastBlock.footnoteText ? lastBlock.footnoteText + "; " + noteText : noteText;
-          }
-        }
-      } else if (ctrlId === "%tok" || ctrlId === "klnk") {
-        const url = extractHyperlinkUrl(rec.data);
-        if (url && blocks.length > 0) {
-          const lastBlock = blocks[blocks.length - 1];
-          if (lastBlock.type === "paragraph" && !lastBlock.href) {
-            lastBlock.href = sanitizeHref(url) ?? void 0;
-          }
+    if (ps.headType === 1 || ps.headType === 2) {
+      const nid = ps.numberingId || (ps.headType === 1 ? ctx.doc.outlineNumberingId : 0);
+      const numbering = nid >= 1 ? ctx.docInfo?.numberings[nid - 1] : void 0;
+      if (numbering) {
+        const counters = ctx.doc.numbering.advance(nid, ps.paraLevel);
+        const fmt = numbering.levelFormats[Math.min(ps.paraLevel, 6)];
+        if (fmt) {
+          const headText = expandNumberingFormat(fmt, counters, numbering);
+          if (headText) headMarker = headText;
         }
       }
+    } else if (ps.headType === 3) {
+      const bullet = ps.numberingId >= 1 ? ctx.docInfo?.bullets[ps.numberingId - 1] : void 0;
+      if (bullet && bullet.char !== "\uFFFF") headMarker = bullet.char;
     }
-    i++;
+  }
+  const blocks = [];
+  const footnotes = ctrls.filter((c) => c.footnote).map((c) => c.footnote);
+  if (trimmed) {
+    const block = {
+      type: headingLevel > 0 ? "heading" : "paragraph",
+      text: headMarker ? `${headMarker} ${trimmed}` : trimmed,
+      pageNumber: ctx.sectionNum
+    };
+    if (headingLevel > 0) block.level = headingLevel;
+    if (ctx.docInfo && charShapeIds.length > 0) {
+      const style = resolveCharStyle(charShapeIds, ctx.docInfo);
+      if (style) block.style = style;
+    }
+    if (footnotes.length > 0) block.footnoteText = footnotes.join("; ");
+    blocks.push(block);
+  } else if (footnotes.length > 0) {
+    blocks.push({ type: "paragraph", text: `(\uC8FC: ${footnotes.join("; ")})`, pageNumber: ctx.sectionNum });
+  }
+  for (const ctrl of ctrls) {
+    if (ctrl.afterBlocks) blocks.push(...ctrl.afterBlocks);
   }
   return blocks;
 }
-function extractNoteText(records, ctrlIdx) {
-  const ctrlLevel = records[ctrlIdx].level;
-  const texts = [];
-  let textRecords = [];
-  let equations = [];
-  const flushText = () => {
-    const text = renderTextWithEquations(textRecords, equations).trim();
-    if (text) texts.push(text);
-    textRecords = [];
-    equations = [];
-  };
-  for (let j = ctrlIdx + 1; j < records.length && j < ctrlIdx + 100; j++) {
-    const r = records[j];
-    if (r.level <= ctrlLevel) break;
-    if (r.tagId === TAG_PARA_HEADER) {
-      flushText();
-    }
-    if (r.tagId === TAG_PARA_TEXT) {
-      textRecords.push(r.data);
-    }
-    if (r.tagId === TAG_CTRL_HEADER && r.data.length >= 4) {
-      const ctrlId = r.data.subarray(0, 4).toString("ascii");
-      if (isEquationControlId(ctrlId)) {
-        const equation = extractEquationFromControl(records, j);
-        if (equation) equations.push(equation);
+function applyCtrlEffect(ctrl, records, ctx) {
+  switch (ctrl.id) {
+    case CTRL_TBL: {
+      const table = parseTableControl(ctrl, records, ctx);
+      if (table) ctrl.afterBlocks = [{ type: "table", table, pageNumber: ctx.sectionNum }];
+      return;
+    }
+    case CTRL_GSO: {
+      const blocks = parseGsoControl(ctrl, records, ctx);
+      if (blocks.length > 0) ctrl.afterBlocks = blocks;
+      return;
+    }
+    case CTRL_EQED: {
+      const eq = extractEquationFromSlice(records, ctrl.childStart, ctrl.childEnd);
+      if (eq) ctrl.inlineText = eq;
+      return;
+    }
+    case CTRL_FN:
+    case CTRL_EN: {
+      applyNoteEffect(ctrl, records, ctx, ctrl.id === CTRL_FN ? 1 : 2);
+      return;
+    }
+    case CTRL_HEAD:
+    case CTRL_FOOT: {
+      applyHeaderFooterEffect(ctrl, records, ctx, ctrl.id === CTRL_HEAD);
+      return;
+    }
+    case CTRL_ATNO: {
+      if (ctrl.data.length >= 8) {
+        const attr = ctrl.data.readUInt32LE(4);
+        const type = attr & 15;
+        const format = attr >>> 4 & 255;
+        const num = ctx.doc.autoCounters.get(type) ?? 1;
+        ctx.doc.autoCounters.set(type, num + 1);
+        const prefix = ctrl.data.length >= 14 ? wcharAt(ctrl.data, 12) : "";
+        const suffix = ctrl.data.length >= 16 ? wcharAt(ctrl.data, 14) : "";
+        ctrl.inlineText = `${prefix}${formatNumber(num, shapeFormatToNumFmt(format))}${suffix}`;
       }
+      return;
     }
-  }
-  flushText();
-  return texts.length > 0 ? texts.join(" ") : null;
-}
-function extractTextBoxText(records, ctrlIdx) {
-  const ctrlLevel = records[ctrlIdx].level;
-  const texts = [];
-  let textRecords = [];
-  let equations = [];
-  const flushText = () => {
-    const text = renderTextWithEquations(textRecords, equations).trim();
-    if (text) texts.push(text);
-    textRecords = [];
-    equations = [];
-  };
-  for (let j = ctrlIdx + 1; j < records.length && j < ctrlIdx + 200; j++) {
-    const r = records[j];
-    if (r.level <= ctrlLevel) break;
-    if (r.tagId === TAG_PARA_HEADER) {
-      flushText();
-    }
-    if (r.tagId === TAG_PARA_TEXT) {
-      textRecords.push(r.data);
-    }
-    if (r.tagId === TAG_CTRL_HEADER && r.data.length >= 4) {
-      const ctrlId = r.data.subarray(0, 4).toString("ascii");
-      if (isEquationControlId(ctrlId)) {
-        const equation = extractEquationFromControl(records, j);
-        if (equation) equations.push(equation);
+    case CTRL_NWNO: {
+      if (ctrl.data.length >= 10) {
+        const attr = ctrl.data.readUInt32LE(4);
+        const type = attr & 15;
+        const num = ctrl.data.readUInt16LE(8);
+        if (num > 0) ctx.doc.autoCounters.set(type, num);
       }
+      return;
     }
-  }
-  flushText();
-  return texts.length > 0 ? texts.join("\n") : null;
-}
-function extractHyperlinkUrl(data) {
-  try {
-    const httpSig = Buffer.from("http", "utf16le");
-    const idx = data.indexOf(httpSig);
-    if (idx >= 0) {
-      let end = idx;
-      while (end + 1 < data.length) {
-        const ch = data.readUInt16LE(end);
-        if (ch === 0) break;
-        end += 2;
+    case CTRL_SECD: {
+      if (ctrl.data.length >= 20) {
+        ctx.doc.outlineNumberingId = ctrl.data.readUInt16LE(18);
       }
-      const url = data.subarray(idx, end).toString("utf16le");
-      if (/^https?:\/\/.+/.test(url) && url.length < 2e3) {
-        return url;
+      return;
+    }
+    case CTRL_OLE: {
+      ctx.warnings.push({ page: ctx.sectionNum, message: "\uC2A4\uD0B5\uB41C OLE \uAC1C\uCCB4", code: "SKIPPED_OLE" });
+      return;
+    }
+    // 숨은 설명/단 정의/쪽번호 위치/감추기/찾아보기/책갈피/글자겹침/덧말 — 본문 텍스트 없음 또는 의도적 스킵
+    case CTRL_TCMT:
+    case CTRL_COLD:
+    case CTRL_PGNP:
+    case CTRL_PGHD:
+    case CTRL_IDXM:
+    case CTRL_BOKM:
+    case CTRL_TCPS:
+    case CTRL_TDUT:
+    case CTRL_FORM:
+      return;
+    default: {
+      if (isFieldCtrlId(ctrl.id)) {
+        applyFieldEffect(ctrl);
+        return;
       }
+      const blocks = parseListHeaderParagraphs(ctrl, records, ctx);
+      if (blocks.length > 0) ctrl.afterBlocks = blocks;
     }
-  } catch {
   }
-  return null;
 }
-function resolveCharStyle(charShapeIds, docInfo) {
-  if (charShapeIds.length === 0 || docInfo.charShapes.length === 0) return void 0;
-  const freq = /* @__PURE__ */ new Map();
-  let maxCount = 0, dominantId = charShapeIds[0];
-  for (const id of charShapeIds) {
-    const count = (freq.get(id) || 0) + 1;
-    freq.set(id, count);
-    if (count > maxCount) {
-      maxCount = count;
-      dominantId = id;
+function wcharAt(data, offset) {
+  const code = data.readUInt16LE(offset);
+  return code > 0 ? String.fromCharCode(code) : "";
+}
+function parseListHeaderParagraphs(ctrl, records, ctx) {
+  if (ctx.depth >= MAX_NEST_DEPTH) return [];
+  for (let i = ctrl.childStart; i < ctrl.childEnd; i++) {
+    if (records[i].tagId === TAG_LIST_HEADER) {
+      return parseParagraphList(records, i + 1, ctrl.childEnd, { ...ctx, depth: ctx.depth + 1 });
     }
   }
-  const cs = docInfo.charShapes[dominantId];
-  if (!cs) return void 0;
-  const style = {};
-  if (cs.fontSize > 0) style.fontSize = cs.fontSize / 10;
-  if (cs.attrFlags & 1) style.italic = true;
-  if (cs.attrFlags & 2) style.bold = true;
-  return style.fontSize || style.bold || style.italic ? style : void 0;
+  return [];
 }
-function parseParagraphWithTables(records, startIdx, counter) {
-  const startLevel = records[startIdx].level;
-  const textRecords = [];
-  const equations = [];
-  const tables = [];
-  const charShapeIds = [];
-  const paraHeaderData = records[startIdx].data;
-  const paraShapeId = paraHeaderData.length >= 10 ? paraHeaderData.readUInt16LE(8) : -1;
-  let i = startIdx + 1;
-  while (i < records.length) {
-    const rec = records[i];
-    if (rec.tagId === TAG_PARA_HEADER && rec.level <= startLevel) break;
-    if (rec.tagId === TAG_PARA_TEXT) {
-      textRecords.push(rec.data);
+function blocksPlainText(blocks, sep) {
+  const parts = [];
+  for (const b of blocks) {
+    if (b.type === "image") continue;
+    if (b.type === "table") continue;
+    if (b.text) {
+      let t = b.text;
+      if (b.footnoteText) t += ` (\uC8FC: ${b.footnoteText})`;
+      parts.push(t);
     }
-    if (rec.tagId === TAG_CHAR_SHAPE && rec.data.length >= 8) {
-      for (let offset = 0; offset + 7 < rec.data.length; offset += 8) {
-        charShapeIds.push(rec.data.readUInt32LE(offset + 4));
-      }
+  }
+  return parts.join(sep).trim();
+}
+function applyNoteEffect(ctrl, records, ctx, autoType) {
+  const num = ctx.doc.autoCounters.get(autoType) ?? 1;
+  let before = "";
+  let after = "";
+  let shape = 0;
+  if (ctrl.data.length >= 12) {
+    before = wcharAt(ctrl.data, 8);
+    after = wcharAt(ctrl.data, 10);
+  }
+  if (ctrl.data.length >= 16) {
+    shape = ctrl.data.readUInt32LE(12) & 255;
+  }
+  const formatted = formatNumber(num, shapeFormatToNumFmt(shape));
+  const marker = before || after ? `${before}${formatted}${after}` : `${formatted})`;
+  const content = blocksPlainText(parseListHeaderParagraphs(ctrl, records, ctx), " ");
+  if ((ctx.doc.autoCounters.get(autoType) ?? 1) <= num) {
+    ctx.doc.autoCounters.set(autoType, num + 1);
+  }
+  ctrl.inlineText = marker;
+  if (content) ctrl.footnote = content.startsWith(marker) ? content : `${marker} ${content}`;
+}
+function applyHeaderFooterEffect(ctrl, records, ctx, isHeader) {
+  const text = blocksPlainText(parseListHeaderParagraphs(ctrl, records, ctx), "\n");
+  if (!text) return;
+  const key = (isHeader ? "h:" : "f:") + text;
+  if (ctx.doc.headerTexts.has(key)) return;
+  ctx.doc.headerTexts.add(key);
+  const block = { type: "paragraph", text, pageNumber: ctx.sectionNum };
+  if (isHeader) ctx.doc.headerBlocks.push(block);
+  else ctx.doc.footerBlocks.push(block);
+}
+function applyFieldEffect(ctrl) {
+  if (ctrl.id === FIELD_HLK) {
+    const command = parseFieldCommand(ctrl.data);
+    if (command) {
+      const url = hyperlinkUrlFromCommand(command);
+      if (url) ctrl.href = url;
     }
-    if (rec.tagId === TAG_CTRL_HEADER && rec.data.length >= 4) {
-      const ctrlId = rec.data.subarray(0, 4).toString("ascii");
-      if (isEquationControlId(ctrlId)) {
-        const equation = extractEquationFromControl(records, i);
-        if (equation) equations.push(equation);
-      } else if (ctrlId === " lbt" || ctrlId === "tbl ") {
-        const { table, nextIdx } = parseTableBlock(records, i, counter);
-        if (table) tables.push(table);
-        i = nextIdx;
-        continue;
-      }
+  }
+}
+function parseFieldCommand(data) {
+  if (data.length < 11) return null;
+  const cmdLen = data.readUInt16LE(9);
+  if (cmdLen === 0) return null;
+  const start = 11;
+  const end = start + cmdLen * 2;
+  if (end > data.length) return null;
+  return data.subarray(start, end).toString("utf16le").replace(/\0+$/, "");
+}
+function hyperlinkUrlFromCommand(command) {
+  let url = "";
+  for (let i = 0; i < command.length; i++) {
+    const c = command[i];
+    if (c === "\\" && i + 1 < command.length) {
+      url += command[i + 1];
+      i++;
+      continue;
     }
-    i++;
+    if (c === ";") break;
+    url += c;
   }
-  const text = renderTextWithEquations(textRecords, equations);
-  const trimmed = text.trim();
-  return { paragraph: trimmed || null, tables, nextIdx: i, charShapeIds, paraShapeId };
+  url = url.trim();
+  return url.length > 0 && url.length < 2e3 ? url : null;
 }
-function parseTableBlock(records, startIdx, counter) {
-  const tableLevel = records[startIdx].level;
-  let i = startIdx + 1;
-  let rows = 0, cols = 0;
+function parseTableControl(ctrl, records, ctx) {
+  if (ctx.depth >= MAX_NEST_DEPTH) return null;
+  const { childStart, childEnd } = ctrl;
+  let rows = 0;
+  let cols = 0;
+  let tableIdx = -1;
+  for (let i2 = childStart; i2 < childEnd; i2++) {
+    if (records[i2].tagId === TAG_TABLE && records[i2].data.length >= 8) {
+      rows = Math.min(records[i2].data.readUInt16LE(4), MAX_ROWS);
+      cols = Math.min(records[i2].data.readUInt16LE(6), MAX_COLS);
+      tableIdx = i2;
+      break;
+    }
+  }
+  if (tableIdx < 0 || rows === 0 || cols === 0) return null;
+  let caption;
+  for (let i2 = childStart; i2 < tableIdx; i2++) {
+    if (records[i2].tagId === TAG_LIST_HEADER) {
+      const capBlocks = parseParagraphList(records, i2 + 1, tableIdx, { ...ctx, depth: ctx.depth + 1 });
+      const capText = blocksPlainText(capBlocks, " ");
+      if (capText) caption = capText;
+      break;
+    }
+  }
   const cells = [];
-  while (i < records.length) {
+  let i = tableIdx + 1;
+  while (i < childEnd) {
     const rec = records[i];
-    if (rec.tagId === TAG_PARA_HEADER && rec.level <= tableLevel) break;
-    if (rec.tagId === TAG_CTRL_HEADER && rec.level <= tableLevel) break;
-    if (rec.tagId === TAG_TABLE && rec.data.length >= 8) {
-      rows = Math.min(rec.data.readUInt16LE(4), MAX_ROWS);
-      cols = Math.min(rec.data.readUInt16LE(6), MAX_COLS);
-    }
     if (rec.tagId === TAG_LIST_HEADER) {
-      const { cell, nextIdx } = parseCellBlock(records, i, tableLevel, counter);
-      if (cell) cells.push(cell);
-      i = nextIdx;
+      const cellLevel = rec.level;
+      let j = i + 1;
+      while (j < childEnd) {
+        const r = records[j];
+        if (r.level < cellLevel) break;
+        if (r.level === cellLevel && (r.tagId === TAG_LIST_HEADER || r.tagId === TAG_TABLE)) break;
+        j++;
+      }
+      cells.push(parseCell(records, i, j, ctx));
+      i = j;
       continue;
     }
     i++;
   }
-  if (rows === 0 || cols === 0 || cells.length === 0) return { table: null, nextIdx: i };
+  if (cells.length === 0) return null;
   const hasAddr = cells.some((c) => c.colAddr !== void 0 && c.rowAddr !== void 0);
   if (hasAddr) {
     const cellRows2 = arrangeCells(rows, cols, cells);
-    const irCells = cellRows2.map((row) => row.map((c) => ({
-      text: c.text.trim(),
-      colSpan: c.colSpan,
-      rowSpan: c.rowSpan
-    })));
-    return { table: { rows, cols, cells: irCells, hasHeader: rows > 1 }, nextIdx: i };
+    const irCells = cellRows2.map((row) => row.map((c) => {
+      const ir = { text: c.text.trim(), colSpan: c.colSpan, rowSpan: c.rowSpan };
+      if (c.blocks?.length) ir.blocks = c.blocks;
+      if (c.isHeader) ir.isHeader = true;
+      return ir;
+    }));
+    const table2 = { rows, cols, cells: irCells, hasHeader: rows > 1 };
+    if (caption) table2.caption = caption;
+    return table2;
   }
   const cellRows = arrangeCells(rows, cols, cells);
-  return { table: buildTable(cellRows), nextIdx: i };
-}
-function parseCellBlock(records, startIdx, tableLevel, counter) {
-  const rec = records[startIdx];
-  const cellLevel = rec.level;
-  const texts = [];
-  let textRecords = [];
-  let equations = [];
-  const flushText = () => {
-    const text = renderTextWithEquations(textRecords, equations).trim();
-    if (text) texts.push(text);
-    textRecords = [];
-    equations = [];
-  };
+  const table = buildTable(cellRows);
+  if (caption && table.rows > 0) table.caption = caption;
+  return table.rows > 0 ? table : null;
+}
+function parseCell(records, lhIdx, end, ctx) {
+  const rec = records[lhIdx];
   let colSpan = 1;
   let rowSpan = 1;
   let colAddr;
   let rowAddr;
+  let isHeader = false;
   if (rec.data.length >= 16) {
+    isHeader = (rec.data.readUInt16LE(6) & 4) !== 0;
     colAddr = rec.data.readUInt16LE(8);
     rowAddr = rec.data.readUInt16LE(10);
     const cs = rec.data.readUInt16LE(12);
@@ -3416,36 +4290,30 @@ function parseCellBlock(records, startIdx, tableLevel, counter) {
     if (cs > 0) colSpan = Math.min(cs, MAX_COLS);
     if (rs > 0) rowSpan = Math.min(rs, MAX_ROWS);
   }
-  let i = startIdx + 1;
-  while (i < records.length) {
-    const r = records[i];
-    if (r.tagId === TAG_LIST_HEADER && r.level <= cellLevel) break;
-    if (r.level <= tableLevel && (r.tagId === TAG_PARA_HEADER || r.tagId === TAG_CTRL_HEADER)) break;
-    if (r.tagId === TAG_PARA_HEADER) {
-      flushText();
-    }
-    if (r.tagId === TAG_PARA_TEXT) {
-      textRecords.push(r.data);
-    }
-    if (r.tagId === TAG_CTRL_HEADER && r.data.length >= 4) {
-      const ctrlId = r.data.subarray(0, 4).toString("ascii");
-      if (isEquationControlId(ctrlId)) {
-        const equation = extractEquationFromControl(records, i);
-        if (equation) equations.push(equation);
-      } else if (ctrlId === " lbt" || ctrlId === "tbl ") {
-        flushText();
-        if (counter) {
-          counter.count++;
-          texts.push(`[\uC911\uCCA9 \uD14C\uC774\uBE14 #${counter.count}]`);
-        } else {
-          texts.push("[\uC911\uCCA9 \uD14C\uC774\uBE14]");
-        }
+  const blocks = ctx.depth < MAX_NEST_DEPTH ? parseParagraphList(records, lhIdx + 1, end, { ...ctx, depth: ctx.depth + 1 }) : [];
+  const parts = [];
+  let hasStructure = false;
+  for (const b of blocks) {
+    if (b.type === "image" && b.text) {
+      parts.push(`![image](hwp5bin:${b.text})`);
+      hasStructure = true;
+    } else if (b.type === "table" && b.table) {
+      const flat = convertTableToText(b.table.cells);
+      if (flat) parts.push(flat);
+      hasStructure = true;
+    } else if (b.text) {
+      let t = b.text;
+      if (b.footnoteText) {
+        t += ` (\uC8FC: ${b.footnoteText})`;
+        hasStructure = true;
       }
+      parts.push(t);
     }
-    i++;
   }
-  flushText();
-  return { cell: { text: texts.join("\n"), colSpan, rowSpan, colAddr, rowAddr }, nextIdx: i };
+  const cell = { text: parts.join("\n"), colSpan, rowSpan, colAddr, rowAddr };
+  if (hasStructure && blocks.length > 0) cell.blocks = blocks;
+  if (isHeader) cell.isHeader = true;
+  return cell;
 }
 function arrangeCells(rows, cols, cells) {
   const grid = Array.from({ length: rows }, () => Array(cols).fill(null));
@@ -3483,6 +4351,78 @@ function arrangeCells(rows, cols, cells) {
   }
   return grid.map((row) => row.map((c) => c || { text: "", colSpan: 1, rowSpan: 1 }));
 }
+function parseGsoControl(ctrl, records, ctx) {
+  if (ctx.depth >= MAX_NEST_DEPTH) return [];
+  const { childStart, childEnd } = ctrl;
+  const blocks = [];
+  let scIdx = -1;
+  for (let i = childStart; i < childEnd; i++) {
+    const t = records[i].tagId;
+    if (t === TAG_SHAPE_COMPONENT || t === TAG_SHAPE_COMPONENT_CONTAINER) {
+      scIdx = i;
+      break;
+    }
+  }
+  if (scIdx > childStart) {
+    for (let i = childStart; i < scIdx; i++) {
+      if (records[i].tagId === TAG_LIST_HEADER) {
+        blocks.push(...parseParagraphList(records, i + 1, scIdx, { ...ctx, depth: ctx.depth + 1 }));
+        break;
+      }
+    }
+  }
+  const scanStart = scIdx >= 0 ? scIdx + 1 : childStart;
+  let textListIdx = -1;
+  for (let i = scanStart; i < childEnd; i++) {
+    if (records[i].tagId === TAG_LIST_HEADER) {
+      textListIdx = i;
+      break;
+    }
+  }
+  const picEnd = textListIdx >= 0 ? textListIdx : childEnd;
+  for (let i = scanStart; i < picEnd; i++) {
+    if (records[i].tagId === TAG_SHAPE_COMPONENT_PICTURE) {
+      const img = pictureToImageBlock(records[i].data, ctx);
+      if (img) blocks.push(img);
+    }
+  }
+  if (textListIdx >= 0) {
+    blocks.push(...parseParagraphList(records, textListIdx + 1, childEnd, { ...ctx, depth: ctx.depth + 1 }));
+  }
+  return blocks;
+}
+function pictureToImageBlock(data, ctx) {
+  if (data.length < 73) return null;
+  const binDataId = data.readUInt16LE(71);
+  if (binDataId === 0) return null;
+  const item = ctx.docInfo?.binData[binDataId - 1];
+  if (item?.kind === "link") {
+    ctx.warnings.push({ page: ctx.sectionNum, message: `\uC678\uBD80 \uC5F0\uACB0 \uC774\uBBF8\uC9C0 (binDataId ${binDataId})`, code: "SKIPPED_IMAGE" });
+    return null;
+  }
+  const storageId = item && item.storageId > 0 ? item.storageId : binDataId;
+  return { type: "image", text: String(storageId), pageNumber: ctx.sectionNum };
+}
+function resolveCharStyle(charShapeIds, docInfo) {
+  if (charShapeIds.length === 0 || docInfo.charShapes.length === 0) return void 0;
+  const freq = /* @__PURE__ */ new Map();
+  let maxCount = 0, dominantId = charShapeIds[0];
+  for (const id of charShapeIds) {
+    const count = (freq.get(id) || 0) + 1;
+    freq.set(id, count);
+    if (count > maxCount) {
+      maxCount = count;
+      dominantId = id;
+    }
+  }
+  const cs = docInfo.charShapes[dominantId];
+  if (!cs) return void 0;
+  const style = {};
+  if (cs.fontSize > 0) style.fontSize = cs.fontSize / 10;
+  if (cs.attrFlags & 1) style.italic = true;
+  if (cs.attrFlags & 2) style.bold = true;
+  return style.fontSize || style.bold || style.italic ? style : void 0;
+}
 
 // src/hwp3/parser.ts
 import { inflateRawSync as inflateRawSync3 } from "zlib";
@@ -15571,7 +16511,7 @@ function parseHwp3Document(buffer, _options) {
   const ctx = { paragraphs: [], warnings };
   try {
     skipFontFacesAndStyles(bodyReader);
-    parseParagraphList(bodyReader, ctx);
+    parseParagraphList2(bodyReader, ctx);
   } catch (err) {
     warnings.push({
       code: "PARTIAL_PARSE",
@@ -15603,7 +16543,7 @@ function skipFontFacesAndStyles(reader) {
   const nStyles = reader.readU16();
   reader.skip(nStyles * STYLE_RECORD_SIZE);
 }
-function parseParagraphList(reader, ctx) {
+function parseParagraphList2(reader, ctx) {
   for (; ; ) {
     if (reader.eof()) return;
     const followPrev = reader.readU8();
@@ -15688,17 +16628,17 @@ function parseCharStream(reader, charCount, ctx) {
         break;
       case 15: {
         reader.skip(8);
-        parseParagraphList(reader, ctx);
+        parseParagraphList2(reader, ctx);
         break;
       }
       case 16: {
         reader.skip(10);
-        parseParagraphList(reader, ctx);
+        parseParagraphList2(reader, ctx);
         break;
       }
       case 17: {
         reader.skip(14);
-        parseParagraphList(reader, ctx);
+        parseParagraphList2(reader, ctx);
         break;
       }
       case 29:
@@ -15728,9 +16668,9 @@ function parseTableLike(reader, ctx) {
   }
   reader.skip(27 * cellCount);
   for (let i = 0; i < cellCount; i++) {
-    parseParagraphList(reader, ctx);
+    parseParagraphList2(reader, ctx);
   }
-  parseParagraphList(reader, ctx);
+  parseParagraphList2(reader, ctx);
   return "";
 }
 function parsePicture(reader, _ctx) {
@@ -17194,7 +18134,7 @@ function extractRun(r) {
   }
   return { text, bold, italic };
 }
-function parseParagraph(p, styles, numbering, footnotes, rels) {
+function parseParagraph2(p, styles, numbering, footnotes, rels) {
   const pPrEls = getChildElements(p, "pPr");
   let styleId = "";
   let numId = "";
@@ -17310,7 +18250,7 @@ function parseTable(tbl, styles, numbering, footnotes, rels) {
       const cellTexts = [];
       const pElements = getChildElements(tc, "p");
       for (const p of pElements) {
-        const block = parseParagraph(p, styles, numbering, footnotes, rels);
+        const block = parseParagraph2(p, styles, numbering, footnotes, rels);
         if (block?.text) cellTexts.push(block.text);
       }
       row.push({ text: cellTexts.join("\n"), colSpan, rowSpan });
@@ -17439,7 +18379,7 @@ async function parseDocxDocument(buffer, options) {
     const el = node;
     const localName3 = el.localName ?? el.tagName?.split(":").pop();
     if (localName3 === "p") {
-      const block = parseParagraph(el, styles, numbering, footnotes, rels);
+      const block = parseParagraph2(el, styles, numbering, footnotes, rels);
       if (block) blocks.push(block);
     } else if (localName3 === "tbl") {
       const block = parseTable(el, styles, numbering, footnotes, rels);
@@ -17579,7 +18519,7 @@ function walkContent(node, blocks, paraShapeMap, sectionNum, warnings, inHeaderF
     }
     if (tag === "P") {
       if (!inHeaderFooter) {
-        parseParagraph2(el, blocks, paraShapeMap, sectionNum);
+        parseParagraph3(el, blocks, paraShapeMap, sectionNum);
       }
       continue;
     }
@@ -17596,7 +18536,7 @@ function walkContent(node, blocks, paraShapeMap, sectionNum, warnings, inHeaderF
     walkContent(el, blocks, paraShapeMap, sectionNum, warnings, inHeaderFooter, depth + 1);
   }
 }
-function parseParagraph2(el, blocks, paraShapeMap, sectionNum) {
+function parseParagraph3(el, blocks, paraShapeMap, sectionNum) {
   const paraShapeId = el.getAttribute("ParaShape") ?? "";
   const shapeInfo = paraShapeMap.get(paraShapeId);
   const text = extractParagraphText(el);
@@ -19041,6 +19981,1490 @@ function diffTableCells(a, b) {
   return result;
 }
 
+// src/roundtrip/patcher.ts
+import JSZip7 from "jszip";
+
+// src/roundtrip/source-map.ts
+function escapeXmlText(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function decodeXmlEntities(text) {
+  return text.replace(/&(lt|gt|amp|quot|apos|#x?[0-9a-fA-F]+);/g, (m, ent) => {
+    switch (ent) {
+      case "lt":
+        return "<";
+      case "gt":
+        return ">";
+      case "amp":
+        return "&";
+      case "quot":
+        return '"';
+      case "apos":
+        return "'";
+    }
+    try {
+      const code = ent[1] === "x" || ent[1] === "X" ? parseInt(ent.slice(2), 16) : parseInt(ent.slice(1), 10);
+      if (!isNaN(code) && code >= 0 && code <= 1114111) return String.fromCodePoint(code);
+    } catch {
+    }
+    return m;
+  });
+}
+function tContentToText(raw) {
+  return decodeXmlEntities(
+    raw.replace(/<\/?(?:[A-Za-z0-9_]+:)?(?:tab|fwSpace|hwSpace|br|lineBreak)(?:\s[^>]*)?\/?>/g, " ").replace(/<[^>]*>/g, "")
+  );
+}
+var TAG_RE = /<!--[\s\S]*?-->|<!\[CDATA\[[\s\S]*?\]\]>|<\?[\s\S]*?\?>|<!(?:"[^"]*"|'[^']*'|[^>"'])*>|<\/([^\s>]+)\s*>|<([^\s/>!?]+)((?:"[^"]*"|'[^']*'|[^>"'])*?)(\/?)>/g;
+var T_BARRIER = /* @__PURE__ */ new Set([
+  "tbl",
+  "ctrl",
+  "caption",
+  "pic",
+  "shape",
+  "drawingObject",
+  "drawText",
+  "shapeComment",
+  "memogroup",
+  "memo",
+  "hiddenComment",
+  "equation",
+  "parameters",
+  "subList",
+  "p"
+]);
+var PARA_CONTAINER = /* @__PURE__ */ new Set([
+  "tc",
+  "ctrl",
+  "caption",
+  "drawText",
+  "pic",
+  "shape",
+  "drawingObject",
+  "memogroup",
+  "memo",
+  "hiddenComment",
+  "footNote",
+  "endNote",
+  "fn",
+  "en"
+  // 각주/미주 — 파서는 호스트 블록 footnoteText로만 흡수
+]);
+var TABLE_BARRIER = /* @__PURE__ */ new Set([
+  "tbl",
+  "ctrl",
+  "caption",
+  "memogroup",
+  "memo",
+  "hiddenComment"
+]);
+function localOf(qname) {
+  const i = qname.indexOf(":");
+  return i >= 0 ? qname.slice(i + 1) : qname;
+}
+function prefixOf(qname) {
+  const i = qname.indexOf(":");
+  return i >= 0 ? qname.slice(0, i) : "";
+}
+function scanSectionXml(xml, sectionIndex) {
+  const stack = [];
+  const bodyParagraphs = [];
+  const tables = [];
+  const headerTexts = [];
+  const footerTexts = [];
+  const paraStack = [];
+  const tableStack = [];
+  const rowStack = [];
+  const cellStack = [];
+  let pendingT = null;
+  const ctrlSubStack = [];
+  const classifyPara = () => {
+    let sawDrawText = false;
+    for (let i = stack.length - 1; i >= 0; i--) {
+      const l = stack[i].local;
+      if (l === "tc") return "cell";
+      if (l === "drawText") {
+        sawDrawText = true;
+        continue;
+      }
+      if (PARA_CONTAINER.has(l)) return "excluded";
+    }
+    return sawDrawText ? "draw" : "body";
+  };
+  const owningPara = () => {
+    if (paraStack.length === 0) return null;
+    for (let i = stack.length - 1; i >= 0; i--) {
+      const l = stack[i].local;
+      if (l === "p") return paraStack[paraStack.length - 1];
+      if (T_BARRIER.has(l)) return null;
+    }
+    return null;
+  };
+  const isTableTopLevel = () => {
+    for (let i = stack.length - 1; i >= 0; i--) {
+      if (TABLE_BARRIER.has(stack[i].local)) return false;
+    }
+    return true;
+  };
+  const currentCtrlSub = () => ctrlSubStack.length > 0 ? ctrlSubStack[ctrlSubStack.length - 1] : null;
+  TAG_RE.lastIndex = 0;
+  let m;
+  while ((m = TAG_RE.exec(xml)) !== null) {
+    const [full, closeName, openName, , selfClose] = m;
+    if (closeName === void 0 && openName === void 0) continue;
+    if (closeName !== void 0) {
+      const local2 = localOf(closeName);
+      if (local2 === "t" && pendingT) {
+        const { para, contentStart: contentStart2 } = pendingT;
+        para.tRanges.push({ contentStart: contentStart2, contentEnd: m.index });
+        para.text += tContentToText(xml.slice(contentStart2, m.index));
+        pendingT = null;
+      }
+      for (let i = stack.length - 1; i >= 0; i--) {
+        if (stack[i].local === local2) {
+          stack.length = i;
+          break;
+        }
+      }
+      if (local2 === "p") {
+        const para = paraStack.pop();
+        if (para && para.kind === "excluded") {
+          const sub = currentCtrlSub();
+          if (sub && para.text.trim()) sub.texts.push(para.text);
+        }
+      } else if (local2 === "tc") {
+        const cell = cellStack.pop();
+        const row = rowStack[rowStack.length - 1];
+        if (cell && row) row.push(cell);
+      } else if (local2 === "tr") {
+        const row = rowStack[rowStack.length - 1];
+        const table = tableStack[tableStack.length - 1];
+        if (row && table && row.length > 0) table.rows.push(row);
+        if (rowStack.length > 0) rowStack[rowStack.length - 1] = [];
+      } else if (local2 === "tbl") {
+        const table = tableStack.pop();
+        rowStack.pop();
+        if (table) {
+          finalizeTable(table);
+          if (!table.topLevel) {
+            const cell = cellStack[cellStack.length - 1];
+            if (cell) cell.tables.push(table);
+          }
+        }
+      } else if (local2 === "header" || local2 === "footer") {
+        const sub = ctrlSubStack[ctrlSubStack.length - 1];
+        if (sub) {
+          ctrlSubStack.pop();
+          const joined = sub.texts.join("\n").trim();
+          if (joined) (sub.kind === "header" ? headerTexts : footerTexts).push(joined);
+        }
+      }
+      continue;
+    }
+    const qname = openName;
+    const local = localOf(qname);
+    const attrsRaw = m[3] || "";
+    const isSelfClose = selfClose === "/";
+    const contentStart = m.index + full.length;
+    if (isSelfClose) {
+      if (local === "t") {
+        const para = owningPara();
+        if (para) para.tRanges.push({ contentStart: m.index, contentEnd: m.index + full.length, selfClosing: true, prefix: prefixOf(qname) });
+      } else if (local === "tab" || local === "fwSpace" || local === "hwSpace" || local === "br" || local === "lineBreak") {
+        if (!pendingT) {
+          const para = owningPara();
+          if (para) para.text += " ";
+        }
+      } else if (local === "run" || local === "r") {
+        const para = owningPara();
+        if (para && !para.selfCloseRun) para.selfCloseRun = { start: m.index, end: m.index + full.length };
+      } else if (local === "cellAddr") {
+        const cell = cellStack[cellStack.length - 1];
+        if (cell && insideCurrentTable(stack, tableStack)) {
+          const ca = parseInt(getAttr2(attrsRaw, "colAddr") || "", 10);
+          const ra = parseInt(getAttr2(attrsRaw, "rowAddr") || "", 10);
+          if (!isNaN(ca)) cell.colAddr = ca;
+          if (!isNaN(ra)) cell.rowAddr = ra;
+        }
+      } else if (local === "cellSpan") {
+        const cell = cellStack[cellStack.length - 1];
+        if (cell && insideCurrentTable(stack, tableStack)) {
+          const cs = parseInt(getAttr2(attrsRaw, "colSpan") || "1", 10);
+          const rs = parseInt(getAttr2(attrsRaw, "rowSpan") || "1", 10);
+          cell.colSpan = isNaN(cs) || cs < 1 ? 1 : cs;
+          cell.rowSpan = isNaN(rs) || rs < 1 ? 1 : rs;
+        }
+      }
+      continue;
+    }
+    if (local === "t") {
+      const para = owningPara();
+      if (para) pendingT = { para, contentStart };
+      stack.push({ local, qname, contentStart });
+      continue;
+    }
+    stack.push({ local, qname, contentStart });
+    if (local === "p") {
+      const para = {
+        sectionIndex,
+        kind: "excluded",
+        // 분류는 push 직후 스택 기준 (자기 자신 제외)
+        start: m.index,
+        tRanges: [],
+        text: ""
+      };
+      stack.pop();
+      para.kind = classifyPara();
+      stack.push({ local, qname, contentStart });
+      paraStack.push(para);
+      if (para.kind === "body" || para.kind === "draw") bodyParagraphs.push(para);
+      else if (para.kind === "cell") {
+        const cell = cellStack[cellStack.length - 1];
+        if (cell) cell.paragraphs.push(para);
+      }
+    } else if (local === "run" || local === "r") {
+      const para = owningPara();
+      if (para && para.runPrefix === void 0) para.runPrefix = prefixOf(qname);
+    } else if (local === "tbl") {
+      const table = {
+        sectionIndex,
+        start: m.index,
+        topLevel: false,
+        rows: [],
+        cellByAnchor: /* @__PURE__ */ new Map()
+      };
+      stack.pop();
+      table.topLevel = isTableTopLevel();
+      stack.push({ local, qname, contentStart });
+      tableStack.push(table);
+      rowStack.push([]);
+      if (table.topLevel) tables.push(table);
+    } else if (local === "tr") {
+      if (rowStack.length > 0) rowStack[rowStack.length - 1] = [];
+    } else if (local === "tc") {
+      cellStack.push({ colSpan: 1, rowSpan: 1, paragraphs: [], tables: [] });
+    } else if (local === "cellAddr" || local === "cellSpan") {
+      const cell = cellStack[cellStack.length - 1];
+      if (cell && insideCurrentTable(stack, tableStack)) {
+        if (local === "cellAddr") {
+          const ca = parseInt(getAttr2(attrsRaw, "colAddr") || "", 10);
+          const ra = parseInt(getAttr2(attrsRaw, "rowAddr") || "", 10);
+          if (!isNaN(ca)) cell.colAddr = ca;
+          if (!isNaN(ra)) cell.rowAddr = ra;
+        } else {
+          const cs = parseInt(getAttr2(attrsRaw, "colSpan") || "1", 10);
+          const rs = parseInt(getAttr2(attrsRaw, "rowSpan") || "1", 10);
+          cell.colSpan = isNaN(cs) || cs < 1 ? 1 : cs;
+          cell.rowSpan = isNaN(rs) || rs < 1 ? 1 : rs;
+        }
+      }
+    } else if (local === "header" || local === "footer") {
+      if (stack.some((f) => f.local === "ctrl")) {
+        ctrlSubStack.push({ kind: local, texts: [] });
+      }
+    } else if (local === "tab" || local === "fwSpace" || local === "hwSpace" || local === "br" || local === "lineBreak") {
+      const para = owningPara();
+      if (para) para.text += " ";
+    }
+  }
+  for (const para of bodyParagraphs) fillRunInsertPos(para, xml);
+  const fillTableInsertPos = (table, depth = 0) => {
+    if (depth > 16) return;
+    for (const row of table.rows) {
+      for (const cell of row) {
+        for (const para of cell.paragraphs) fillRunInsertPos(para, xml);
+        for (const nested of cell.tables) fillTableInsertPos(nested, depth + 1);
+      }
+    }
+  };
+  for (const table of tables) fillTableInsertPos(table);
+  return { sectionIndex, xml, bodyParagraphs, tables, headerTexts, footerTexts };
+}
+function getAttr2(attrsRaw, name) {
+  const re = new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`);
+  const m = attrsRaw.match(re);
+  return m ? m[1] ?? m[2] : void 0;
+}
+function insideCurrentTable(stack, tableStack) {
+  if (tableStack.length === 0) return false;
+  for (let i = stack.length - 1; i >= 0; i--) {
+    const l = stack[i].local;
+    if (l === "tc") return true;
+    if (l === "tbl") return false;
+  }
+  return false;
+}
+function fillRunInsertPos(para, xml) {
+  if (para.tRanges.length > 0) return;
+  const pEnd = findElementEnd(xml, para.start);
+  if (pEnd < 0) return;
+  const slice = xml.slice(para.start, pEnd);
+  const runOpen = slice.match(/<((?:[A-Za-z0-9_]+:)?run)(?:\s(?:"[^"]*"|'[^']*'|[^>"'])*?)?(\/?)>/);
+  if (!runOpen || runOpen.index === void 0) return;
+  if (runOpen[2] === "/") return;
+  const qname = runOpen[1];
+  const closeIdx = slice.indexOf(`</${qname}>`, runOpen.index);
+  if (closeIdx < 0) return;
+  para.runInsertPos = para.start + closeIdx;
+  para.runPrefix = prefixOf(qname);
+}
+function findElementEnd(xml, start) {
+  const open = xml.slice(start).match(/^<([^\s/>!?]+)/);
+  if (!open) return -1;
+  const qname = open[1];
+  const re = new RegExp(`<${qname}(?=[\\s/>])(?:"[^"]*"|'[^']*'|[^>"'])*?(/?)>|</${qname}\\s*>`, "g");
+  re.lastIndex = start;
+  let depth = 0;
+  let mm;
+  while ((mm = re.exec(xml)) !== null) {
+    if (mm[0].startsWith("</")) {
+      depth--;
+      if (depth === 0) return mm.index + mm[0].length;
+    } else if (mm[1] !== "/") {
+      depth++;
+    }
+  }
+  return -1;
+}
+function finalizeTable(table) {
+  const hasAddr = table.rows.some((row) => row.some((c) => c.colAddr !== void 0 && c.rowAddr !== void 0));
+  if (hasAddr) {
+    for (const row of table.rows) {
+      for (const cell of row) {
+        if (cell.rowAddr !== void 0 && cell.colAddr !== void 0) {
+          table.cellByAnchor.set(`${cell.rowAddr},${cell.colAddr}`, cell);
+        }
+      }
+    }
+    return;
+  }
+  const numRows = table.rows.length;
+  const occupied = Array.from({ length: numRows }, () => []);
+  for (let rowIdx = 0; rowIdx < numRows; rowIdx++) {
+    let colIdx = 0;
+    for (const cell of table.rows[rowIdx]) {
+      while (occupied[rowIdx][colIdx]) colIdx++;
+      cell.rowAddr = rowIdx;
+      cell.colAddr = colIdx;
+      table.cellByAnchor.set(`${rowIdx},${colIdx}`, cell);
+      for (let r = rowIdx; r < Math.min(rowIdx + cell.rowSpan, numRows); r++) {
+        for (let c = colIdx; c < colIdx + cell.colSpan; c++) {
+          occupied[r][c] = true;
+        }
+      }
+      colIdx += cell.colSpan;
+    }
+  }
+}
+function buildParagraphSplices(para, newText, xml) {
+  const escaped = escapeXmlText(newText);
+  if (para.tRanges.length > 0) {
+    const splices = [];
+    const first = para.tRanges[0];
+    if (first.selfClosing) {
+      const prefix = first.prefix ? first.prefix + ":" : "";
+      splices.push({ start: first.contentStart, end: first.contentEnd, replacement: `<${prefix}t>${escaped}</${prefix}t>` });
+    } else {
+      splices.push({ start: first.contentStart, end: first.contentEnd, replacement: escaped });
+    }
+    for (let i = 1; i < para.tRanges.length; i++) {
+      const r = para.tRanges[i];
+      if (!r.selfClosing && r.contentStart < r.contentEnd) {
+        splices.push({ start: r.contentStart, end: r.contentEnd, replacement: "" });
+      }
+    }
+    return splices;
+  }
+  if (para.runInsertPos !== void 0) {
+    if (!newText) return [];
+    const prefix = para.runPrefix ? para.runPrefix + ":" : "";
+    return [{ start: para.runInsertPos, end: para.runInsertPos, replacement: `<${prefix}t>${escaped}</${prefix}t>` }];
+  }
+  if (para.selfCloseRun && xml) {
+    if (!newText) return [];
+    const { start, end } = para.selfCloseRun;
+    const tag = xml.slice(start, end);
+    const qm = tag.match(/^<([^\s/>]+)/);
+    if (!qm || !tag.endsWith("/>")) return null;
+    const qname = qm[1];
+    const colon = qname.indexOf(":");
+    const prefix = colon >= 0 ? qname.slice(0, colon) + ":" : "";
+    const opened = tag.slice(0, tag.length - 2).trimEnd() + ">";
+    return [{ start, end, replacement: `${opened}<${prefix}t>${escaped}</${prefix}t></${qname}>` }];
+  }
+  return newText ? null : [];
+}
+function applySplices(xml, splices) {
+  const sorted = [...splices].sort((a, b) => a.start - b.start);
+  for (let i = 1; i < sorted.length; i++) {
+    if (sorted[i].start < sorted[i - 1].end) {
+      throw new Error("\uC18C\uC2A4\uB9F5 splice \uBC94\uC704 \uACB9\uCE68 \u2014 \uB0B4\uBD80 \uC624\uB958");
+    }
+  }
+  let result = xml;
+  for (let i = sorted.length - 1; i >= 0; i--) {
+    const s = sorted[i];
+    result = result.slice(0, s.start) + s.replacement + result.slice(s.end);
+  }
+  return result;
+}
+
+// src/roundtrip/zip-patch.ts
+import { deflateRawSync } from "zlib";
+var EOCD_SIG = 101010256;
+var CD_SIG = 33639248;
+var LOCAL_SIG = 67324752;
+var ZIP64_EOCD_LOC_SIG = 117853008;
+function copyBytes(buf, start, end) {
+  return new Uint8Array(buf.subarray(start, end));
+}
+function parseCentralDirectory(buf) {
+  const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+  const minEocd = Math.max(0, buf.length - 22 - 65535);
+  let eocdOffset = -1;
+  for (let i = buf.length - 22; i >= minEocd; i--) {
+    if (view.getUint32(i, true) === EOCD_SIG && i + 22 + view.getUint16(i + 20, true) === buf.length) {
+      eocdOffset = i;
+      break;
+    }
+  }
+  if (eocdOffset < 0) {
+    for (let i = buf.length - 22; i >= minEocd; i--) {
+      if (view.getUint32(i, true) !== EOCD_SIG) continue;
+      if (i + 22 + view.getUint16(i + 20, true) > buf.length) continue;
+      const cand = view.getUint32(i + 16, true);
+      if (cand < buf.length - 4 && view.getUint32(cand, true) === CD_SIG) {
+        eocdOffset = i;
+        break;
+      }
+    }
+  }
+  if (eocdOffset < 0) throw new KordocError("ZIP EOCD\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
+  const totalEntries = view.getUint16(eocdOffset + 10, true);
+  const cdSize = view.getUint32(eocdOffset + 12, true);
+  const cdOffset = view.getUint32(eocdOffset + 16, true);
+  if (cdOffset === 4294967295 || totalEntries === 65535) throw new KordocError("ZIP64\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4");
+  if (eocdOffset >= 20 && view.getUint32(eocdOffset - 20, true) === ZIP64_EOCD_LOC_SIG) {
+    throw new KordocError("ZIP64\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4");
+  }
+  const decoder = new TextDecoder("utf-8");
+  const entries = [];
+  let pos = cdOffset;
+  for (let i = 0; i < totalEntries; i++) {
+    if (view.getUint32(pos, true) !== CD_SIG) throw new KordocError("ZIP Central Directory \uC190\uC0C1");
+    const flags = view.getUint16(pos + 8, true);
+    const method = view.getUint16(pos + 10, true);
+    const crc = view.getUint32(pos + 16, true);
+    const compSize = view.getUint32(pos + 20, true);
+    const uncompSize = view.getUint32(pos + 24, true);
+    const nameLen = view.getUint16(pos + 28, true);
+    const extraLen = view.getUint16(pos + 30, true);
+    const commentLen = view.getUint16(pos + 32, true);
+    const localOffset = view.getUint32(pos + 42, true);
+    if (compSize === 4294967295 || uncompSize === 4294967295 || localOffset === 4294967295) {
+      throw new KordocError("ZIP64\uB294 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4");
+    }
+    const name = decoder.decode(buf.subarray(pos + 46, pos + 46 + nameLen));
+    const cdEnd = pos + 46 + nameLen + extraLen + commentLen;
+    entries.push({ cdStart: pos, cdEnd, name, flags, method, crc, compSize, uncompSize, localOffset });
+    pos = cdEnd;
+  }
+  return { entries, cdOffset, cdSize, eocdOffset };
+}
+var CRC_TABLE = (() => {
+  const table = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    table[n] = c >>> 0;
+  }
+  return table;
+})();
+function crc32(data) {
+  let crc = 4294967295;
+  for (let i = 0; i < data.length; i++) {
+    crc = CRC_TABLE[(crc ^ data[i]) & 255] ^ crc >>> 8;
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function patchZipEntries(original, replacements) {
+  const { entries, cdOffset, eocdOffset } = parseCentralDirectory(original);
+  const view = new DataView(original.buffer, original.byteOffset, original.byteLength);
+  for (const name of replacements.keys()) {
+    if (!entries.some((e) => e.name === name)) throw new KordocError(`ZIP\uC5D0 \uC5C6\uB294 \uC5D4\uD2B8\uB9AC: ${name}`);
+  }
+  const byLocal = [...entries].sort((a, b) => a.localOffset - b.localOffset);
+  const segments = [];
+  const newLocalOffset = /* @__PURE__ */ new Map();
+  const newMeta = /* @__PURE__ */ new Map();
+  let offset = 0;
+  for (let i = 0; i < byLocal.length; i++) {
+    const e = byLocal[i];
+    const segEnd = i + 1 < byLocal.length ? byLocal[i + 1].localOffset : cdOffset;
+    newLocalOffset.set(e, offset);
+    const newData = replacements.get(e.name);
+    if (newData === void 0) {
+      const seg = original.subarray(e.localOffset, segEnd);
+      segments.push(seg);
+      offset += seg.length;
+      continue;
+    }
+    if (view.getUint32(e.localOffset, true) !== LOCAL_SIG) throw new KordocError("ZIP \uB85C\uCEEC \uD5E4\uB354 \uC2DC\uADF8\uB2C8\uCC98 \uBD88\uC77C\uCE58");
+    const nameLen = view.getUint16(e.localOffset + 26, true);
+    const extraLen = view.getUint16(e.localOffset + 28, true);
+    const headerLen = 30 + nameLen + extraLen;
+    const header = copyBytes(original, e.localOffset, e.localOffset + headerLen);
+    const hview = new DataView(header.buffer, header.byteOffset, header.byteLength);
+    const method = e.method;
+    const compData = method === 0 ? newData : new Uint8Array(deflateRawSync(newData));
+    const crc = crc32(newData);
+    const flags = e.flags & ~8;
+    hview.setUint16(6, flags, true);
+    hview.setUint32(14, crc, true);
+    hview.setUint32(18, compData.length, true);
+    hview.setUint32(22, newData.length, true);
+    segments.push(header, compData);
+    offset += headerLen + compData.length;
+    newMeta.set(e, { crc, compSize: compData.length, uncompSize: newData.length, flags });
+  }
+  const newCdOffset = offset;
+  for (const e of entries) {
+    const cd = copyBytes(original, e.cdStart, e.cdEnd);
+    const cview = new DataView(cd.buffer, cd.byteOffset, cd.byteLength);
+    cview.setUint32(42, newLocalOffset.get(e), true);
+    const meta = newMeta.get(e);
+    if (meta) {
+      cview.setUint16(8, meta.flags, true);
+      cview.setUint32(16, meta.crc, true);
+      cview.setUint32(20, meta.compSize, true);
+      cview.setUint32(24, meta.uncompSize, true);
+    }
+    segments.push(cd);
+    offset += cd.length;
+  }
+  const newCdSize = offset - newCdOffset;
+  const eocd = copyBytes(original, eocdOffset);
+  const eview = new DataView(eocd.buffer, eocd.byteOffset, eocd.byteLength);
+  eview.setUint32(12, newCdSize, true);
+  eview.setUint32(16, newCdOffset, true);
+  segments.push(eocd);
+  offset += eocd.length;
+  const result = new Uint8Array(offset);
+  let pos = 0;
+  for (const seg of segments) {
+    result.set(seg, pos);
+    pos += seg.length;
+  }
+  return result;
+}
+
+// src/roundtrip/markdown-units.ts
+function splitMarkdownUnits(md2) {
+  const lines = md2.split("\n");
+  const units = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (!line.trim()) {
+      i++;
+      continue;
+    }
+    if (line.trim().startsWith("<table>")) {
+      const collected2 = [];
+      let depth = 0;
+      while (i < lines.length) {
+        const l = lines[i];
+        collected2.push(l);
+        depth += (l.match(/<table>/g) || []).length;
+        depth -= (l.match(/<\/table>/g) || []).length;
+        i++;
+        if (depth <= 0) break;
+      }
+      units.push({ kind: "html-table", raw: collected2.join("\n"), lines: collected2 });
+      continue;
+    }
+    if (line.trimStart().startsWith("|")) {
+      const collected2 = [];
+      while (i < lines.length && lines[i].trimStart().startsWith("|")) {
+        collected2.push(lines[i]);
+        i++;
+      }
+      units.push({ kind: "gfm-table", raw: collected2.join("\n"), lines: collected2 });
+      continue;
+    }
+    if (/^-{3,}\s*$/.test(line.trim())) {
+      units.push({ kind: "separator", raw: line.trim(), lines: [line.trim()] });
+      i++;
+      continue;
+    }
+    if (/^!\[image\]\([^)]*\)\s*$/.test(line.trim())) {
+      units.push({ kind: "image", raw: line.trim(), lines: [line.trim()] });
+      i++;
+      continue;
+    }
+    const collected = [];
+    while (i < lines.length && lines[i].trim() && !lines[i].trimStart().startsWith("|") && !lines[i].trim().startsWith("<table>")) {
+      collected.push(lines[i].trim());
+      i++;
+    }
+    units.push({ kind: "text", raw: collected.join("\n"), lines: collected });
+  }
+  return units;
+}
+function escapeGfm(text) {
+  return text.replace(/~/g, "\\~");
+}
+var HWP_SHAPE_ALT_TEXT_RE = /(?:모서리가 둥근 |둥근 )?(?:사각형|직사각형|정사각형|원|타원|삼각형|이등변 삼각형|직각 삼각형|선|직선|곡선|화살표|굵은 화살표|이중 화살표|오각형|육각형|팔각형|별|[4-8]점별|십자|십자형|구름|구름형|마름모|도넛|평행사변형|사다리꼴|부채꼴|호|반원|물결|번개|하트|빗금|블록 화살표|수식|표|그림|개체|그리기\s?개체|묶음\s?개체|글상자|수식\s?개체|OLE\s?개체)\s?입니다\.?/g;
+function sanitizeText(text) {
+  let result = mapPuaText(text).replace(/[\u{F0000}-\u{FFFFD}]/gu, "").replace(HWP_SHAPE_ALT_TEXT_RE, "").replace(/  +/g, " ").trim();
+  if (result.length <= 30 && result.includes(" ")) {
+    const tokens = result.split(" ");
+    const koreanSingleCharCount = tokens.filter((t) => t.length === 1 && /[가-힯ㄱ-ㆎ]/.test(t)).length;
+    if (tokens.length >= 3 && koreanSingleCharCount / tokens.length >= 0.7) {
+      result = tokens.join("");
+    }
+  }
+  return result;
+}
+function normForMatch(text) {
+  return sanitizeText(text).replace(/\s+/g, " ").trim();
+}
+function unescapeGfm(text) {
+  return text.replace(/\\~/g, "~");
+}
+function summarize(text) {
+  const t = text.replace(/\s+/g, " ").trim();
+  return t.length > 80 ? t.slice(0, 77) + "..." : t;
+}
+function replicateGfmTable(table) {
+  const { cells, rows: numRows, cols: numCols } = table;
+  if (numRows === 0 || numCols === 0) return null;
+  if (numRows === 1 && numCols === 1) return null;
+  if (numCols === 1) return null;
+  const display = Array.from({ length: numRows }, (_, r) => Array.from({ length: numCols }, (_2, c) => ({ text: "", gridR: r, gridC: c })));
+  const skip = /* @__PURE__ */ new Set();
+  for (let r = 0; r < numRows; r++) {
+    for (let c = 0; c < numCols; c++) {
+      if (skip.has(`${r},${c}`)) continue;
+      const cell = cells[r]?.[c];
+      if (!cell) continue;
+      display[r][c] = {
+        text: escapeGfm(sanitizeText(cell.text)).replace(/\|/g, "\\|").replace(/\n/g, "<br>"),
+        gridR: r,
+        gridC: c
+      };
+      for (let dr = 0; dr < cell.rowSpan; dr++) {
+        for (let dc = 0; dc < cell.colSpan; dc++) {
+          if (dr === 0 && dc === 0) continue;
+          if (r + dr < numRows && c + dc < numCols) skip.add(`${r + dr},${c + dc}`);
+        }
+      }
+      c += cell.colSpan - 1;
+    }
+  }
+  const uniqueRows = [];
+  let pendingLabelRow = null;
+  for (let r = 0; r < display.length; r++) {
+    const row = display[r];
+    if (row.every((cell) => cell.text === "")) continue;
+    const nonEmptyCols = row.filter((cell) => cell.text !== "");
+    const hasSkipInRow = row.some((_, c) => skip.has(`${r},${c}`));
+    if (!hasSkipInRow && nonEmptyCols.length === 1 && row[0].text !== "" && row.slice(1).every((c) => c.text === "")) {
+      if (pendingLabelRow) uniqueRows.push(pendingLabelRow);
+      pendingLabelRow = row;
+      continue;
+    }
+    if (pendingLabelRow) {
+      if (row[0].text === "") row[0] = pendingLabelRow[0];
+      else uniqueRows.push(pendingLabelRow);
+      pendingLabelRow = null;
+    }
+    uniqueRows.push(row);
+  }
+  if (pendingLabelRow) uniqueRows.push(pendingLabelRow);
+  return uniqueRows.length > 0 ? uniqueRows : null;
+}
+function parseGfmTable(lines) {
+  const rows = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|")) continue;
+    const cells = trimmed.split(/(?<!\\)\|/).slice(1, -1).map((c) => c.trim());
+    if (cells.length === 0) continue;
+    if (cells.every((c) => /^:?-{3,}:?$/.test(c))) continue;
+    rows.push(cells);
+  }
+  return rows;
+}
+function unescapeGfmCell(text) {
+  return text.replace(/<br\s*\/?>/gi, "\n").replace(/\\\|/g, "|").replace(/\\~/g, "~");
+}
+function replicateCellInnerHtml(cell) {
+  if (cell.blocks?.length) {
+    return cell.blocks.map((b) => {
+      if (b.type === "table" && b.table) {
+        const cap = b.table.caption ? sanitizeText(b.table.caption) : "";
+        return (cap ? cap + "<br>" : "") + replicateTableToHtml(b.table);
+      }
+      if (b.type === "image" && b.text) return `<img src="${b.text}" alt="image">`;
+      const t = sanitizeText(b.text ?? "");
+      return t ? t.replace(/\n/g, "<br>") : "";
+    }).filter(Boolean).join("<br>");
+  }
+  return sanitizeText(cell.text).replace(/\n/g, "<br>");
+}
+function replicateTableToHtml(table) {
+  const rows = replicateHtmlTable(table);
+  const lines = ["<table>"];
+  for (let r = 0; r < rows.length; r++) {
+    const tag = rows[r].tag;
+    const rowHtml = rows[r].cells.map((cell) => {
+      const attrs = [];
+      if (cell.colSpan > 1) attrs.push(`colspan="${cell.colSpan}"`);
+      if (cell.rowSpan > 1) attrs.push(`rowspan="${cell.rowSpan}"`);
+      const attrStr = attrs.length ? " " + attrs.join(" ") : "";
+      return `<${tag}${attrStr}>${cell.inner}</${tag}>`;
+    });
+    if (rowHtml.length) lines.push(`<tr>${rowHtml.join("")}</tr>`);
+  }
+  lines.push("</table>");
+  return lines.join("\n");
+}
+function replicateHtmlTable(table) {
+  const { cells, rows: numRows, cols: numCols } = table;
+  const skip = /* @__PURE__ */ new Set();
+  const result = [];
+  for (let r = 0; r < numRows; r++) {
+    const tag = r === 0 ? "th" : "td";
+    const rowCells = [];
+    for (let c = 0; c < numCols; c++) {
+      if (skip.has(`${r},${c}`)) continue;
+      const cell = cells[r]?.[c];
+      if (!cell) continue;
+      for (let dr = 0; dr < cell.rowSpan; dr++) {
+        for (let dc = 0; dc < cell.colSpan; dc++) {
+          if (dr === 0 && dc === 0) continue;
+          if (r + dr < numRows && c + dc < numCols) skip.add(`${r + dr},${c + dc}`);
+        }
+      }
+      rowCells.push({
+        inner: replicateCellInnerHtml(cell),
+        colSpan: cell.colSpan,
+        rowSpan: cell.rowSpan,
+        gridR: r,
+        gridC: c
+      });
+    }
+    if (rowCells.length) result.push({ tag, cells: rowCells });
+  }
+  return result;
+}
+function parseHtmlTable(raw) {
+  const re = /<(\/?)(table|tr|td|th)((?:"[^"]*"|'[^']*'|[^>"'])*?)>/gi;
+  let depth = 0;
+  let currentRow = null;
+  let cellStart = -1;
+  let cellInfo = null;
+  const rows = [];
+  let m;
+  while ((m = re.exec(raw)) !== null) {
+    const isClose = m[1] === "/";
+    const tag = m[2].toLowerCase();
+    const attrs = m[3] || "";
+    if (tag === "table") {
+      depth += isClose ? -1 : 1;
+      if (depth < 0) return null;
+      continue;
+    }
+    if (depth !== 1) continue;
+    if (tag === "tr") {
+      if (!isClose) currentRow = [];
+      else if (currentRow) {
+        rows.push({ tag: rows.length === 0 ? "th" : "td", cells: currentRow });
+        currentRow = null;
+      }
+    } else {
+      if (!isClose) {
+        const cs = parseInt(attrs.match(/colspan\s*=\s*"(\d+)"/i)?.[1] || "1", 10);
+        const rs = parseInt(attrs.match(/rowspan\s*=\s*"(\d+)"/i)?.[1] || "1", 10);
+        cellStart = m.index + m[0].length;
+        cellInfo = { colSpan: isNaN(cs) ? 1 : cs, rowSpan: isNaN(rs) ? 1 : rs };
+      } else if (cellStart >= 0 && cellInfo && currentRow) {
+        currentRow.push({ inner: raw.slice(cellStart, m.index), colSpan: cellInfo.colSpan, rowSpan: cellInfo.rowSpan });
+        cellStart = -1;
+        cellInfo = null;
+      }
+    }
+  }
+  if (depth !== 0) return null;
+  return rows;
+}
+function htmlCellInnerToLines(inner) {
+  let hadNonText = false;
+  let work = inner;
+  if (/<table[\s>]/i.test(work)) {
+    hadNonText = true;
+    work = removeNestedTables(work);
+  }
+  if (/<img\s/i.test(work)) {
+    hadNonText = true;
+    work = work.replace(/<img\s(?:"[^"]*"|'[^']*'|[^>"'])*?>/gi, "");
+  }
+  const lines = work.split(/<br\s*\/?>/gi).map((s) => s.trim()).filter((s) => s.length > 0);
+  return { lines, hadNonText };
+}
+function extractTopLevelTables(html) {
+  const result = [];
+  let depth = 0;
+  let start = -1;
+  const re = /<(\/?)table(?:[\s>]|>)/gi;
+  let m;
+  while ((m = re.exec(html)) !== null) {
+    if (m[1] !== "/") {
+      if (depth === 0) start = m.index;
+      depth++;
+    } else {
+      depth--;
+      if (depth === 0 && start >= 0) {
+        result.push(html.slice(start, m.index + m[0].length));
+        start = -1;
+      }
+      if (depth < 0) depth = 0;
+    }
+  }
+  return result;
+}
+function removeNestedTables(html) {
+  let result = "";
+  let depth = 0;
+  const re = /<(\/?)table(?:[\s>]|>)/gi;
+  let last = 0;
+  let m;
+  while ((m = re.exec(html)) !== null) {
+    if (m[1] !== "/") {
+      if (depth === 0) result += html.slice(last, m.index);
+      depth++;
+    } else {
+      depth--;
+      if (depth === 0) last = m.index + m[0].length;
+      if (depth < 0) depth = 0;
+    }
+  }
+  if (depth === 0) result += html.slice(last);
+  return result;
+}
+
+// src/roundtrip/table-patch.ts
+function patchGfmTable(table, scanTable, orig, edited, ctx, skip) {
+  const replica = replicateGfmTable(table);
+  if (!replica) return skip("\uD45C \uB80C\uB354 \uACBD\uB85C \uC2DD\uBCC4 \uC2E4\uD328");
+  const origRows = parseGfmTable(orig.lines);
+  const editedRows = parseGfmTable(edited.lines);
+  if (replica.length !== origRows.length || replica.some((row, r) => row.length !== origRows[r].length || row.some((c, j) => c.text !== origRows[r][j]))) {
+    return skip("\uD45C \uC88C\uD45C \uC7AC\uD604 \uBD88\uC77C\uCE58 \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+  }
+  if (editedRows.length !== origRows.length) return skip("\uD45C \uD589 \uCD94\uAC00/\uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0 (\uD45C \uAD6C\uC870 \uBCC0\uACBD)");
+  let applied = 0;
+  for (let r = 0; r < origRows.length; r++) {
+    if (editedRows[r].length !== origRows[r].length) {
+      skip(`\uD45C ${r + 1}\uD589 \uC5F4 \uC218 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0`);
+      continue;
+    }
+    for (let c = 0; c < origRows[r].length; c++) {
+      if (origRows[r][c] === editedRows[r][c]) continue;
+      const { gridR, gridC } = replica[r][c];
+      const origTokens = extractCellTokens(origRows[r][c]);
+      const editedTokens = extractCellTokens(editedRows[r][c]);
+      if (origTokens !== editedTokens) {
+        skip("\uC140 \uB0B4 \uC774\uBBF8\uC9C0 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+        continue;
+      }
+      const newLines = unescapeGfmCell(stripCellTokens(editedRows[r][c])).split("\n").map((s) => s.trim()).filter(Boolean);
+      const origLines = unescapeGfmCell(stripCellTokens(origRows[r][c])).split("\n").map((s) => s.trim()).filter(Boolean);
+      const n = applyCellEdit(table, scanTable, gridR, gridC, newLines, ctx, origRows[r][c], editedRows[r][c], origLines.length);
+      if (n > 0 && origTokens) {
+        ctx.skipped.push({
+          reason: "\uC140 \uB0B4 \uC774\uBBF8\uC9C0\xB7\uD14D\uC2A4\uD2B8 \uD63C\uC7AC \u2014 \uD14D\uC2A4\uD2B8\uB9CC \uC801\uC6A9 (\uC774\uBBF8\uC9C0 \uC778\uC811 \uBC30\uCE58\uB294 <br> \uBD84\uB9AC\uB85C \uC7AC\uD604\uB428)",
+          before: summarize(origRows[r][c]),
+          after: summarize(editedRows[r][c])
+        });
+      }
+      applied += n;
+    }
+  }
+  return applied;
+}
+function patchHtmlTable(table, scanTable, orig, edited, ctx, skip) {
+  return patchHtmlTableRaw(table, scanTable, orig.raw, edited.raw, ctx, skip, 0);
+}
+function patchHtmlTableRaw(table, scanTable, origRaw, editedRaw, ctx, skip, depth) {
+  if (depth > 8) return skip("\uC911\uCCA9\uD45C \uAE4A\uC774 \uCD08\uACFC");
+  if (replicateTableToHtml(table) !== origRaw) return skip("\uD45C \uC88C\uD45C \uC7AC\uD604 \uBD88\uC77C\uCE58 \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+  const replica = replicateHtmlTable(table);
+  const origRows = parseHtmlTable(origRaw);
+  if (!origRows || origRows.length !== replica.length || origRows.some((r, i) => r.cells.length !== replica[i].cells.length || r.cells.some((c, j) => c.inner !== replica[i].cells[j].inner))) {
+    return skip("\uC140 \uACBD\uACC4 \uBAA8\uD638 (\uB9AC\uD130\uB7F4 \uD0DC\uADF8 \uC758\uC2EC) \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+  }
+  const editedRows = parseHtmlTable(editedRaw);
+  if (!editedRows) return skip("\uD3B8\uC9D1\uB41C HTML \uD45C \uD30C\uC2F1 \uC2E4\uD328");
+  if (editedRows.length !== replica.length) return skip("\uD45C \uD589 \uCD94\uAC00/\uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0 (\uD45C \uAD6C\uC870 \uBCC0\uACBD)");
+  let applied = 0;
+  for (let r = 0; r < replica.length; r++) {
+    if (editedRows[r].cells.length !== replica[r].cells.length) {
+      skip(`\uD45C ${r + 1}\uD589 \uC140 \uC218 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0`);
+      continue;
+    }
+    for (let c = 0; c < replica[r].cells.length; c++) {
+      const oc = replica[r].cells[c];
+      const ec = editedRows[r].cells[c];
+      if (oc.colSpan !== ec.colSpan || oc.rowSpan !== ec.rowSpan) {
+        skip(`\uC140 \uBCD1\uD569(colspan/rowspan) \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0`);
+        continue;
+      }
+      if (oc.inner === ec.inner) continue;
+      const origContent = htmlCellInnerToLines(oc.inner);
+      const editedContent = htmlCellInnerToLines(ec.inner);
+      if (origContent.hadNonText || editedContent.hadNonText) {
+        if (extractImgTags(oc.inner) !== extractImgTags(ec.inner)) {
+          skip("\uC140 \uB0B4 \uC774\uBBF8\uC9C0 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+          continue;
+        }
+        const origTables = extractTopLevelTables(oc.inner);
+        const editedTables = extractTopLevelTables(ec.inner);
+        if (origTables.length !== editedTables.length) {
+          skip("\uC140 \uB0B4 \uC911\uCCA9\uD45C \uCD94\uAC00/\uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0");
+          continue;
+        }
+        if (origTables.join("\n") !== editedTables.join("\n")) {
+          applied += patchNestedTables(table, scanTable, oc, origTables, editedTables, ctx, skip, depth);
+        }
+      }
+      if (origContent.lines.join("\n") !== editedContent.lines.join("\n")) {
+        const newLines = editedContent.lines.map((l) => unescapeGfm(l));
+        applied += applyCellEdit(table, scanTable, oc.gridR, oc.gridC, newLines, ctx, oc.inner, ec.inner, origContent.lines.length);
+      }
+    }
+  }
+  return applied;
+}
+function patchNestedTables(table, scanTable, oc, origTables, editedTables, ctx, skip, depth) {
+  const irCell = table.cells[oc.gridR]?.[oc.gridC];
+  const scanCell = scanTable.cellByAnchor.get(`${oc.gridR},${oc.gridC}`);
+  const nestedIRs = (irCell?.blocks ?? []).filter((b) => b.type === "table" && b.table).map((b) => b.table);
+  if (!scanCell || nestedIRs.length !== origTables.length || scanCell.tables.length !== origTables.length) {
+    return skip("\uC911\uCCA9\uD45C \uC18C\uC2A4\uB9F5 \uB9E4\uD551 \uC2E4\uD328");
+  }
+  let applied = 0;
+  for (let k = 0; k < origTables.length; k++) {
+    if (origTables[k] === editedTables[k]) continue;
+    applied += patchHtmlTableRaw(nestedIRs[k], scanCell.tables[k], origTables[k], editedTables[k], ctx, skip, depth + 1);
+  }
+  return applied;
+}
+function extractImgTags(inner) {
+  return (inner.match(/<img\s(?:"[^"]*"|'[^']*'|[^>"'])*?>/gi) || []).join(" ");
+}
+var CELL_TOKEN_RE = /!\[image\]\([^)]*\)|\[이미지: [^\]]*\]/g;
+function extractCellTokens(text) {
+  return (text.match(CELL_TOKEN_RE) || []).join(" ");
+}
+function stripCellTokens(text) {
+  return text.replace(CELL_TOKEN_RE, "");
+}
+function patchTextChunkTable(table, scanTable, orig, edited, ctx, skip) {
+  if (table.rows === 1 && table.cols === 1) {
+    const content = sanitizeText(table.cells[0][0].text);
+    const replicaLines = content.split(/\n/).map((line) => {
+      const t = line.trim();
+      if (!t) return "";
+      if (/^\d+\.\s/.test(t)) return `**${escapeGfm(t)}**`;
+      return escapeGfm(t);
+    }).filter(Boolean);
+    if (replicaLines.join("\n") !== orig.lines.join("\n")) return skip("\uD45C \uC88C\uD45C \uC7AC\uD604 \uBD88\uC77C\uCE58 \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+    if (extractCellTokens(orig.raw) !== extractCellTokens(edited.raw)) return skip("\uC140 \uB0B4 \uC774\uBBF8\uC9C0 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+    const newLines = edited.lines.map((l) => {
+      const m = l.match(/^\*\*([\s\S]*)\*\*$/);
+      const unwrap = m && /^\d+\.\s/.test(unescapeGfm(m[1]));
+      return stripCellTokens(unescapeGfm(unwrap ? m[1] : l)).trim();
+    }).filter(Boolean);
+    return applyCellEdit(table, scanTable, 0, 0, newLines, ctx, orig.raw, edited.raw, orig.lines.length);
+  }
+  if (table.cols === 1 && table.rows >= 2) {
+    const replica = [];
+    for (let r = 0; r < table.rows; r++) {
+      const line = escapeGfm(sanitizeText(table.cells[r][0].text)).replace(/\n/g, " ");
+      if (line) replica.push({ line, gridR: r });
+    }
+    if (replica.map((x) => x.line).join("\n") !== orig.lines.join("\n")) return skip("\uD45C \uC88C\uD45C \uC7AC\uD604 \uBD88\uC77C\uCE58 \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+    if (edited.lines.length !== replica.length) return skip("\uD45C \uD589 \uCD94\uAC00/\uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0 (\uD45C \uAD6C\uC870 \uBCC0\uACBD)");
+    let applied = 0;
+    for (let i = 0; i < replica.length; i++) {
+      if (replica[i].line === edited.lines[i]) continue;
+      if (extractCellTokens(replica[i].line) !== extractCellTokens(edited.lines[i])) {
+        skip("\uC140 \uB0B4 \uC774\uBBF8\uC9C0 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+        continue;
+      }
+      const newLines = [stripCellTokens(unescapeGfm(edited.lines[i])).trim()].filter(Boolean);
+      applied += applyCellEdit(table, scanTable, replica[i].gridR, 0, newLines, ctx, replica[i].line, edited.lines[i], 1);
+    }
+    return applied;
+  }
+  return skip("\uD45C \uB80C\uB354 \uACBD\uB85C \uC2DD\uBCC4 \uC2E4\uD328");
+}
+function applyCellEdit(table, scanTable, gridR, gridC, newLines, ctx, before, after, origLineCount) {
+  const skip = (reason) => {
+    ctx.skipped.push({ reason, before: summarize(before), after: summarize(after) });
+    return 0;
+  };
+  const cell = scanTable.cellByAnchor.get(`${gridR},${gridC}`);
+  if (!cell) return skip("\uC140 \uC88C\uD45C \uB9E4\uD551 \uC2E4\uD328 (\uBCD1\uD569 \uC601\uC5ED\uC758 \uBE48 \uCE78\uC774\uAC70\uB098 \uC88C\uD45C \uBD88\uC77C\uCE58)");
+  const irCell = table.cells[gridR]?.[gridC];
+  const scanJoined = cell.paragraphs.map((p) => p.text).filter((t) => normForMatch(t)).join("\n");
+  if (irCell && normForMatch(scanJoined) !== normForMatch(stripCellTokens(irCell.text))) {
+    if (normForMatch(irCell.text) !== "" || normForMatch(scanJoined) !== "") {
+      const flatBlocks = (irCell.blocks ?? []).filter((b) => b.type === "paragraph" || b.type === "heading");
+      const flatJoined = flatBlocks.map((b) => b.text ?? "").join("\n");
+      if (normForMatch(scanJoined) !== normForMatch(flatJoined)) {
+        return skip("\uC140 \uCF58\uD150\uCE20 \uAD6C\uC870 \uBCF5\uC7A1 (\uC911\uCCA9\uD45C/\uAE00\uC0C1\uC790) \u2014 \uB9E4\uD551 \uC2E0\uB8B0 \uBD88\uAC00");
+      }
+    }
+  }
+  const nonEmpty = cell.paragraphs.filter((p) => normForMatch(p.text) !== "");
+  if (origLineCount !== void 0 && nonEmpty.length > 0 && origLineCount !== nonEmpty.length) {
+    return skip("\uC140 \uC904 \uACBD\uACC4 \uB9E4\uD551 \uBAA8\uD638 (\uB9AC\uD130\uB7F4 <br>/\uBB38\uB2E8 \uB0B4 \uC904\uBC14\uAFC8) \u2014 \uBBF8\uC9C0\uC6D0");
+  }
+  const splices = [];
+  let sectionIndex = -1;
+  const unstable = newLines.find((l) => sanitizeText(l) !== l);
+  if (unstable !== void 0) return skip("\uACF5\uBC31 \uC815\uADDC\uD654 \uBD88\uC548\uC815 \uD14D\uC2A4\uD2B8 \u2014 \uD328\uCE58 \uC2DC \uC6D0\uBB38 \uBCF4\uC874 \uBD88\uAC00\uB85C \uBBF8\uC9C0\uC6D0");
+  if (nonEmpty.length === 0) {
+    if (newLines.length === 0) return 0;
+    const target = cell.paragraphs[0];
+    if (!target) return skip("\uBE48 \uC140\uC5D0 \uBB38\uB2E8\uC774 \uC5C6\uC5B4 \uD14D\uC2A4\uD2B8 \uC0BD\uC785 \uBD88\uAC00");
+    const sp = buildParagraphSplices(target, newLines.join(" "), ctx.scans[target.sectionIndex]?.xml);
+    if (sp === null) return skip("\uC140 \uBB38\uB2E8\uC5D0 \uD14D\uC2A4\uD2B8 \uB178\uB4DC\uB97C \uB9CC\uB4E4 \uC218 \uC5C6\uC74C");
+    splices.push(...sp);
+    sectionIndex = target.sectionIndex;
+    if (newLines.length > 1) {
+      ctx.skipped.push({ reason: "\uC140 \uB0B4 \uC904 \uCD94\uAC00\uB294 \uBB38\uB2E8 \uC0DD\uC131 \uBBF8\uC9C0\uC6D0 \u2014 \uD55C \uBB38\uB2E8\uC73C\uB85C \uBCD1\uD569 \uC801\uC6A9", after: summarize(after) });
+    }
+  } else {
+    const assigned = [];
+    for (let i = 0; i < nonEmpty.length; i++) {
+      if (i < newLines.length) {
+        assigned.push(i === nonEmpty.length - 1 && newLines.length > nonEmpty.length ? newLines.slice(i).join(" ") : newLines[i]);
+      } else {
+        assigned.push("");
+      }
+    }
+    if (newLines.length > nonEmpty.length) {
+      ctx.skipped.push({ reason: "\uC140 \uB0B4 \uC904 \uCD94\uAC00\uB294 \uBB38\uB2E8 \uC0DD\uC131 \uBBF8\uC9C0\uC6D0 \u2014 \uB9C8\uC9C0\uB9C9 \uBB38\uB2E8\uC5D0 \uBCD1\uD569 \uC801\uC6A9", after: summarize(after) });
+    }
+    for (let i = 0; i < nonEmpty.length; i++) {
+      if (assigned[i] === nonEmpty[i].text || normForMatch(assigned[i]) === normForMatch(nonEmpty[i].text)) continue;
+      const sp = buildParagraphSplices(nonEmpty[i], assigned[i], ctx.scans[nonEmpty[i].sectionIndex]?.xml);
+      if (sp === null) return skip("\uC140 \uBB38\uB2E8\uC5D0 \uD14D\uC2A4\uD2B8 \uB178\uB4DC\uB97C \uB9CC\uB4E4 \uC218 \uC5C6\uC74C");
+      splices.push(...sp);
+      sectionIndex = nonEmpty[i].sectionIndex;
+    }
+  }
+  if (splices.length === 0) return 0;
+  ctx.sectionSplices[sectionIndex].push(...splices);
+  return 1;
+}
+
+// src/roundtrip/patcher.ts
+async function patchHwpx(original, editedMarkdown, options) {
+  const skipped = [];
+  let applied = 0;
+  let origBlocks;
+  try {
+    const parsed = await parseHwpxDocument(u8ToArrayBuffer(original));
+    origBlocks = parsed.blocks;
+  } catch (err) {
+    return { success: false, applied: 0, skipped, error: `\uC6D0\uBCF8 HWPX \uD30C\uC2F1 \uC2E4\uD328: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  let zip;
+  try {
+    zip = await JSZip7.loadAsync(original);
+  } catch {
+    return { success: false, applied: 0, skipped, error: "ZIP \uB85C\uB4DC \uC2E4\uD328" };
+  }
+  const sectionPaths = await resolveSectionEntryNames(zip);
+  if (sectionPaths.length === 0) {
+    return { success: false, applied: 0, skipped, error: "HWPX \uC139\uC158 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4" };
+  }
+  const scans = [];
+  for (let i = 0; i < sectionPaths.length; i++) {
+    const xml = await zip.file(sectionPaths[i]).async("text");
+    scans.push(scanSectionXml(xml, i));
+  }
+  const origUnits = buildOrigUnits(origBlocks);
+  const editedUnits = splitMarkdownUnits(editedMarkdown);
+  const pairs = alignUnits(origUnits.map((u) => u.raw), editedUnits.map((u) => u.raw));
+  const paraMap = resolveParagraphMappings(origBlocks, scans);
+  const scanTables = scans.flatMap((s) => s.tables.filter((t) => t.rows.length > 0));
+  const obTableOrdinals = buildTableOrdinals(origBlocks);
+  const sectionSplices = scans.map(() => []);
+  for (const [oi, ei] of pairs) {
+    if (oi !== null && ei !== null) {
+      const orig = origUnits[oi];
+      const edited = editedUnits[ei];
+      if (orig.raw === edited.raw) continue;
+      applied += handleModifiedUnit(orig, edited, {
+        origBlocks,
+        paraMap,
+        scans,
+        scanTables,
+        obTableOrdinals,
+        sectionSplices,
+        skipped
+      });
+    } else if (oi !== null) {
+      skipped.push({ reason: "\uBE14\uB85D \uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0 (v1) \u2014 \uC6D0\uBCF8 \uC720\uC9C0", before: summarize(origUnits[oi].raw) });
+    } else if (ei !== null) {
+      skipped.push({ reason: "\uBE14\uB85D \uCD94\uAC00\uB294 \uBBF8\uC9C0\uC6D0 (v1)", after: summarize(editedUnits[ei].raw) });
+    }
+  }
+  const replacements = /* @__PURE__ */ new Map();
+  const encoder = new TextEncoder();
+  try {
+    for (let i = 0; i < scans.length; i++) {
+      if (sectionSplices[i].length === 0) continue;
+      const newXml = applySplices(scans[i].xml, sectionSplices[i]);
+      replacements.set(sectionPaths[i], encoder.encode(newXml));
+    }
+  } catch (err) {
+    return { success: false, applied: 0, skipped, error: `\uC18C\uC2A4\uB9F5 splice \uC2E4\uD328: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  let data;
+  if (replacements.size === 0) {
+    data = new Uint8Array(original);
+  } else {
+    try {
+      data = patchZipEntries(original, replacements);
+    } catch (err) {
+      return { success: false, applied: 0, skipped, error: `ZIP \uC7AC\uC870\uB9BD \uC2E4\uD328: ${err instanceof Error ? err.message : String(err)}` };
+    }
+  }
+  let verification;
+  if (options?.verify !== false) {
+    try {
+      const reparsed = await parseHwpxDocument(u8ToArrayBuffer(data));
+      verification = diffUnitLists(splitMarkdownUnits(reparsed.markdown), editedUnits);
+    } catch (err) {
+      return { success: false, applied, skipped, error: `\uD328\uCE58\uBCF8 \uC7AC\uD30C\uC2F1 \uC2E4\uD328 \u2014 \uD328\uCE58 \uC911\uB2E8: ${err instanceof Error ? err.message : String(err)}` };
+    }
+  }
+  return { success: true, data, applied, skipped, verification };
+}
+function buildOrigUnits(blocks) {
+  const units = [];
+  for (let i = 0; i < blocks.length; i++) {
+    const block = blocks[i];
+    let consume = 1;
+    let chunk;
+    if (block.type === "paragraph" && block.text && /^\[별표\s*\d+/.test(sanitizeText(block.text))) {
+      const next = blocks[i + 1];
+      if (next?.type === "paragraph" && next.text && /관련\)?$/.test(next.text)) consume = 2;
+      chunk = blocksToMarkdown(blocks.slice(i, i + consume));
+    } else {
+      chunk = blocksToMarkdown([block]);
+    }
+    if (chunk) {
+      const subUnits = splitMarkdownUnits(chunk);
+      const isFragment = consume === 2 || (block.type === "paragraph" || block.type === "heading") && subUnits.length > 1;
+      for (let s = 0; s < subUnits.length; s++) {
+        const u = { ...subUnits[s], blockIdx: i, fragment: isFragment || void 0 };
+        if (block.type === "table" && block.table?.caption && s === 0 && subUnits.length > 1 && u.kind === "text" && u.raw.startsWith("**")) {
+          u.role = "caption";
+        }
+        units.push(u);
+      }
+    }
+    i += consume - 1;
+  }
+  return units;
+}
+function buildTableOrdinals(blocks) {
+  const map = /* @__PURE__ */ new Map();
+  let ordinal = 0;
+  for (let i = 0; i < blocks.length; i++) {
+    if (blocks[i].type === "table" && blocks[i].table) map.set(i, ordinal++);
+  }
+  return map;
+}
+function alignUnits(a, b) {
+  const m = a.length, n = b.length;
+  if (m * n > 4e6) {
+    const result2 = [];
+    let pre = 0;
+    while (pre < m && pre < n && a[pre] === b[pre]) {
+      result2.push([pre, pre]);
+      pre++;
+    }
+    let suf = 0;
+    while (suf < m - pre && suf < n - pre && a[m - 1 - suf] === b[n - 1 - suf]) suf++;
+    const aMid = m - pre - suf, bMid = n - pre - suf;
+    if (aMid === bMid) {
+      for (let i2 = 0; i2 < aMid; i2++) result2.push([pre + i2, pre + i2]);
+    } else {
+      for (let i2 = 0; i2 < aMid; i2++) result2.push([pre + i2, null]);
+      for (let j2 = 0; j2 < bMid; j2++) result2.push([null, pre + j2]);
+    }
+    for (let s = suf - 1; s >= 0; s--) result2.push([m - 1 - s, n - 1 - s]);
+    return result2;
+  }
+  const dp = Array.from({ length: m + 1 }, () => new Int32Array(n + 1));
+  for (let i2 = 1; i2 <= m; i2++) {
+    for (let j2 = 1; j2 <= n; j2++) {
+      dp[i2][j2] = a[i2 - 1] === b[j2 - 1] ? dp[i2 - 1][j2 - 1] + 1 : Math.max(dp[i2 - 1][j2], dp[i2][j2 - 1]);
+    }
+  }
+  const matches = [];
+  let i = m, j = n;
+  while (i > 0 && j > 0) {
+    if (a[i - 1] === b[j - 1] && dp[i][j] === dp[i - 1][j - 1] + 1) {
+      matches.push([i - 1, j - 1]);
+      i--;
+      j--;
+    } else if (dp[i - 1][j] >= dp[i][j - 1]) i--;
+    else j--;
+  }
+  matches.reverse();
+  const result = [];
+  let ai = 0, bi = 0;
+  const flushGap = (aEnd, bEnd) => {
+    if (aEnd - ai === bEnd - bi) {
+      while (ai < aEnd) result.push([ai++, bi++]);
+      return;
+    }
+    while (ai < aEnd && bi < bEnd) {
+      const sim = normalizedSimilarity(a[ai], b[bi]);
+      if (sim >= 0.4) {
+        if (aEnd - ai > bEnd - bi && bestSimInRange(a, ai + 1, ai + (aEnd - ai) - (bEnd - bi), b[bi]) > sim) {
+          result.push([ai++, null]);
+        } else if (bEnd - bi > aEnd - ai && bestSimInRange(b, bi + 1, bi + (bEnd - bi) - (aEnd - ai), a[ai]) > sim) {
+          result.push([null, bi++]);
+        } else {
+          result.push([ai++, bi++]);
+        }
+      } else if (aEnd - ai >= bEnd - bi) result.push([ai++, null]);
+      else result.push([null, bi++]);
+    }
+    while (ai < aEnd) result.push([ai++, null]);
+    while (bi < bEnd) result.push([null, bi++]);
+  };
+  for (const [pi, pj] of matches) {
+    flushGap(pi, pj);
+    result.push([ai++, bi++]);
+  }
+  flushGap(m, n);
+  return result;
+}
+function bestSimInRange(arr, from, to, target) {
+  let best = 0;
+  for (let k = from; k <= to && k < arr.length; k++) {
+    const s = normalizedSimilarity(arr[k], target);
+    if (s > best) best = s;
+  }
+  return best;
+}
+function resolveParagraphMappings(blocks, scans) {
+  const buckets = /* @__PURE__ */ new Map();
+  for (const scan of scans) {
+    for (const para of scan.bodyParagraphs) {
+      const key = normForMatch(para.text);
+      if (!key) continue;
+      let list = buckets.get(key);
+      if (!list) buckets.set(key, list = []);
+      list.push(para);
+    }
+  }
+  const headerNorms = new Set(scans.flatMap((s) => s.headerTexts.map(normForMatch)).filter(Boolean));
+  const footerNorms = new Set(scans.flatMap((s) => s.footerTexts.map(normForMatch)).filter(Boolean));
+  const pageText = /* @__PURE__ */ new Set();
+  for (let i = 0; i < blocks.length; i++) {
+    const b = blocks[i];
+    if (b.type !== "paragraph" && b.type !== "heading" || !b.text || !headerNorms.has(normForMatch(b.text))) break;
+    pageText.add(i);
+  }
+  for (let i = blocks.length - 1; i >= 0; i--) {
+    const b = blocks[i];
+    if (b.type !== "paragraph" && b.type !== "heading" || !b.text || !footerNorms.has(normForMatch(b.text))) break;
+    pageText.add(i);
+  }
+  const counters = /* @__PURE__ */ new Map();
+  const result = /* @__PURE__ */ new Map();
+  for (let i = 0; i < blocks.length; i++) {
+    const b = blocks[i];
+    if (b.type !== "paragraph" && b.type !== "heading" || !b.text) continue;
+    if (pageText.has(i)) {
+      result.set(i, {});
+      continue;
+    }
+    let key = normForMatch(b.text);
+    let prefixStripped = false;
+    if (!buckets.has(key)) {
+      const sp = b.text.indexOf(" ");
+      if (sp > 0) {
+        const alt = normForMatch(b.text.slice(sp + 1));
+        if (alt && buckets.has(alt)) {
+          key = alt;
+          prefixStripped = true;
+        }
+      }
+    }
+    const list = buckets.get(key);
+    if (!list) {
+      result.set(i, {});
+      continue;
+    }
+    const occ = counters.get(key) ?? 0;
+    counters.set(key, occ + 1);
+    result.set(i, occ < list.length ? { para: list[occ], prefixStripped } : {});
+  }
+  return result;
+}
+function handleModifiedUnit(orig, edited, ctx) {
+  const block = ctx.origBlocks[orig.blockIdx];
+  const skip = (reason) => {
+    ctx.skipped.push({ reason, before: summarize(orig.raw), after: summarize(edited.raw) });
+    return 0;
+  };
+  if (orig.role === "caption") return skip("\uD45C \uCEA1\uC158 \uC218\uC815\uC740 \uBBF8\uC9C0\uC6D0 (v1)");
+  if (orig.kind === "separator" || orig.kind === "image") return skip("\uC774\uBBF8\uC9C0/\uAD6C\uBD84\uC120 \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+  if (!block) return skip("\uBE14\uB85D \uB9E4\uD551 \uC2E4\uD328");
+  if (orig.fragment) return skip("\uBB38\uB2E8 \uBD84\uC808(\uAC15\uC81C \uC904\uBC14\uAFC8/\uBCD1\uD569 \uC720\uB2DB) \u2014 \uBD80\uBD84 \uC218\uC815\uC740 \uBBF8\uC9C0\uC6D0 (v1)");
+  if (block.type === "table" && block.table) {
+    if (orig.kind !== edited.kind) return skip("\uD45C \u2194 \uBE44\uD45C \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0 (\uD45C \uAD6C\uC870 \uBCC0\uACBD)");
+    if (ctx.obTableOrdinals.size !== ctx.scanTables.length) return skip("\uD45C \uAC1C\uC218 \uBD88\uC77C\uCE58 \u2014 \uC18C\uC2A4\uB9F5 \uC2E0\uB8B0 \uBD88\uAC00");
+    const ordinal = ctx.obTableOrdinals.get(orig.blockIdx);
+    const scanTable = ordinal !== void 0 ? ctx.scanTables[ordinal] : void 0;
+    if (!scanTable) return skip("\uD45C \uC18C\uC2A4\uB9F5 \uB9E4\uD551 \uC2E4\uD328");
+    if (orig.kind === "gfm-table") return patchGfmTable(block.table, scanTable, orig, edited, ctx, skip);
+    if (orig.kind === "html-table") return patchHtmlTable(block.table, scanTable, orig, edited, ctx, skip);
+    return patchTextChunkTable(block.table, scanTable, orig, edited, ctx, skip);
+  }
+  if ((block.type === "paragraph" || block.type === "heading") && orig.kind === "text" && edited.kind === "text") {
+    return patchParagraphUnit(block, orig, edited, ctx, skip);
+  }
+  return skip("\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBE14\uB85D \uC720\uD615 \uBCC0\uACBD");
+}
+function patchParagraphUnit(block, orig, edited, ctx, skip) {
+  const mapping = ctx.paraMap.get(orig.blockIdx);
+  if (!mapping?.para) return skip("\uBB38\uB2E8 \uC18C\uC2A4\uB9F5 \uB9E4\uD551 \uC2E4\uD328 (\uBA38\uB9AC\uB9D0/\uAE00\uC0C1\uC790/\uCEA1\uC158 \uC601\uC5ED\uC774\uAC70\uB098 \uD14D\uC2A4\uD2B8 \uBD88\uC77C\uCE58)");
+  if (block.text && block.text.includes("\n")) {
+    return skip("\uBB38\uB2E8 \uB0B4 \uAC15\uC81C \uC904\uBC14\uAFC8 \uD3EC\uD568 \u2014 \uC218\uC815 \uC2DC \uC904\uBC14\uAFC8 \uBCF4\uC874 \uBD88\uAC00\uB85C \uBBF8\uC9C0\uC6D0 (v1)");
+  }
+  const origPlain = textUnitToPlain(orig.raw, block);
+  let newPlain = textUnitToPlain(edited.raw, block);
+  if (block.footnoteText) {
+    const noteMatch = newPlain.match(/\s*\(주: ([\s\S]*)\)$/);
+    if (noteMatch) {
+      newPlain = newPlain.slice(0, noteMatch.index).trimEnd();
+      if (normForMatch(noteMatch[1]) !== normForMatch(block.footnoteText)) {
+        ctx.skipped.push({ reason: "\uAC01\uC8FC \uD14D\uC2A4\uD2B8 \uC218\uC815\uC740 \uBBF8\uC9C0\uC6D0 \u2014 \uBCF8\uBB38\uB9CC \uC801\uC6A9", before: block.footnoteText, after: noteMatch[1] });
+      }
+    } else {
+      ctx.skipped.push({ reason: "\uAC01\uC8FC \uD45C\uAE30 \uC0AD\uC81C\uB294 \uBBF8\uC9C0\uC6D0 \u2014 \uAC01\uC8FC \uC720\uC9C0, \uBCF8\uBB38\uB9CC \uC801\uC6A9", before: `(\uC8FC: ${block.footnoteText})` });
+    }
+  }
+  if (mapping.prefixStripped) {
+    const origPrefix = block.text.split(" ", 1)[0];
+    const sp = newPlain.indexOf(" ");
+    const newFirst = sp > 0 ? newPlain.slice(0, sp) : newPlain;
+    if (newFirst === origPrefix || /^(?:[0-9０-９a-zA-Z가-힣]{1,6}[.)\]:]|[([][0-9０-９a-zA-Z가-힣]{1,6}[)\]][.:]?|[ⅰ-ⅹⅠ-Ⅹ①-⑮][.)\]:]?)$/u.test(newFirst)) {
+      newPlain = sp > 0 ? newPlain.slice(sp + 1) : "";
+    } else {
+      ctx.skipped.push({ reason: "\uC790\uB3D9\uBC88\uD638 \uC811\uB450 \uC2DD\uBCC4 \uC2E4\uD328 \u2014 \uBC88\uD638 \uD3EC\uD568 \uD14D\uC2A4\uD2B8\uB85C \uC801\uC6A9 (\uBDF0\uC5B4\uC5D0\uC11C \uC911\uBCF5 \uD45C\uC2DC \uAC00\uB2A5)", after: summarize(newPlain) });
+    }
+  }
+  if (newPlain === origPlain) return skip("\uD14D\uC2A4\uD2B8 \uC678 \uBCC0\uACBD(\uD5E4\uB529 \uB808\uBCA8/\uC11C\uC2DD)\uB9CC \uAC10\uC9C0 \u2014 \uC2A4\uD0C0\uC77C \uBCC0\uACBD\uC740 \uBBF8\uC9C0\uC6D0");
+  if (sanitizeText(newPlain) !== newPlain) {
+    return skip("\uACF5\uBC31 \uC815\uADDC\uD654 \uBD88\uC548\uC815 \uD14D\uC2A4\uD2B8 \u2014 \uD328\uCE58 \uC2DC \uC6D0\uBB38 \uBCF4\uC874 \uBD88\uAC00\uB85C \uBBF8\uC9C0\uC6D0");
+  }
+  const splices = buildParagraphSplices(mapping.para, newPlain, ctx.scans[mapping.para.sectionIndex]?.xml);
+  if (splices === null) return skip("\uBB38\uB2E8\uC5D0 \uD14D\uC2A4\uD2B8 \uB178\uB4DC\uB97C \uB9CC\uB4E4 \uC218 \uC5C6\uC74C");
+  ctx.sectionSplices[mapping.para.sectionIndex].push(...splices);
+  return 1;
+}
+function textUnitToPlain(raw, block) {
+  let text = raw.split("\n").map((l) => l.trim()).filter(Boolean).join(" ");
+  if (block.type === "heading" || block.text && /^\[별표\s*\d+/.test(sanitizeText(block.text))) {
+    text = text.replace(/^#{1,6}\s+/, "");
+  }
+  if (block.href) {
+    const linkMatch = text.match(/^\[([\s\S]*)\]\([^)]*\)$/);
+    if (linkMatch) text = linkMatch[1];
+  }
+  if (/^\*[^*][\s\S]*\*$/.test(text) && block.text && /^\([^)]*조[^)]*관련\)$/.test(sanitizeText(block.text))) {
+    text = text.slice(1, -1);
+  }
+  return unescapeGfm(text);
+}
+function diffUnitLists(a, b) {
+  const pairs = alignUnits(a.map((u) => u.raw), b.map((u) => u.raw));
+  const stats = { added: 0, removed: 0, modified: 0, unchanged: 0 };
+  const diffs = [];
+  for (const [ai, bi] of pairs) {
+    if (ai !== null && bi !== null) {
+      if (a[ai].raw === b[bi].raw) {
+        stats.unchanged++;
+        continue;
+      }
+      stats.modified++;
+      diffs.push({ type: "modified", before: unitToBlock(a[ai]), after: unitToBlock(b[bi]), similarity: normalizedSimilarity(a[ai].raw, b[bi].raw) });
+    } else if (ai !== null) {
+      stats.removed++;
+      diffs.push({ type: "removed", before: unitToBlock(a[ai]) });
+    } else if (bi !== null) {
+      stats.added++;
+      diffs.push({ type: "added", after: unitToBlock(b[bi]) });
+    }
+  }
+  return { stats, diffs };
+}
+function unitToBlock(u) {
+  return { type: "paragraph", text: u.raw };
+}
+function u8ToArrayBuffer(u8) {
+  return u8.buffer.slice(u8.byteOffset, u8.byteOffset + u8.byteLength);
+}
+async function resolveSectionEntryNames(zip) {
+  for (const mp of ["Contents/content.hpf", "content.hpf"]) {
+    const f = zip.file(mp);
+    if (!f) continue;
+    const xml = await f.async("text");
+    const paths = sectionPathsFromManifest(xml).filter((p) => zip.file(p) !== null);
+    if (paths.length > 0) return paths;
+  }
+  return Object.keys(zip.files).filter((n) => /[Ss]ection\d+\.xml$/.test(n)).sort();
+}
+function sectionPathsFromManifest(xml) {
+  const isSectionId = (id) => /^s/i.test(id) || id.toLowerCase().includes("section");
+  const attr = (tag, name) => {
+    const m = tag.match(new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`));
+    return m ? m[1] ?? m[2] : "";
+  };
+  const idToHref = /* @__PURE__ */ new Map();
+  for (const m of xml.matchAll(/<opf:item(\s(?:"[^"]*"|'[^']*'|[^>"'])*?)\/?>/g)) {
+    const id = attr(m[1], "id");
+    let href = attr(m[1], "href");
+    const mediaType = attr(m[1], "media-type");
+    if (!isSectionId(id) && !mediaType.includes("xml")) continue;
+    if (!href.startsWith("/") && !href.startsWith("Contents/") && isSectionId(id)) href = "Contents/" + href;
+    if (id) idToHref.set(id, href);
+  }
+  const ordered = [];
+  for (const m of xml.matchAll(/<opf:itemref(\s(?:"[^"]*"|'[^']*'|[^>"'])*?)\/?>/g)) {
+    const href = idToHref.get(attr(m[1], "idref"));
+    if (href) ordered.push(href);
+  }
+  if (ordered.length > 0) return ordered;
+  return Array.from(idToHref.entries()).filter(([id]) => isSectionId(id)).sort((a, b) => a[0].localeCompare(b[0])).map(([, href]) => href);
+}
+
 // src/print/renderer.ts
 import { existsSync } from "fs";
 import MarkdownIt from "markdown-it";
@@ -19281,7 +21705,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-BKYM3LKN.js");
+    const mod = await import("./parser-4IVYHKSL.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -19399,6 +21823,7 @@ export {
   parsePdf,
   parseXls,
   parseXlsx,
+  patchHwpx,
   renderHtml
 };
 //# sourceMappingURL=index.js.map