kordoc 4.2.9 → 4.3.0

package/dist/{chunk-G3DMDTZI.js → chunk-DRZUJ2RK.js}

@@ -1,18 +1,12 @@
 #!/usr/bin/env node
 import {
   inlineImagesIntoMarkdown
-} from "./chunk-7FCNOKOR.js";
+} from "./chunk-W34QSJFF.js";
 import {
   HEADING_RATIO_H1,
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
-} from "./chunk-LM7C6HI2.js";
-import {
-  detectFormat,
-  detectOle2Format,
-  detectZipFormat,
-  parseLenientCfb
-} from "./chunk-TCJRGFYY.js";
+} from "./chunk-ZSL6MQVE.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -21,13 +15,14 @@ import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
+  decodeXmlEntities,
   escapeXmlText,
   findElementEnd,
   paraTText,
   paraTextPureT,
   patchZipEntries,
   scanSectionXml
-} from "./chunk-XU4VWOKL.js";
+} from "./chunk-NMWXBJ5B.js";
 import {
   MAX_COLS,
   MAX_ROWS,
@@ -37,26 +32,30 @@ import {
   dedupeRunningHeaders,
   flattenLayoutTables,
   mapPuaText
-} from "./chunk-MHMVFI2N.js";
+} from "./chunk-GSMPTZC7.js";
 import {
   SPACE_EM_FIXED,
   charWidthEm1000,
   fitRatioForFewerLines,
   measureTextWidth,
   simulateWrap
-} from "./chunk-WTT2KJOM.js";
+} from "./chunk-VXMLENCV.js";
 import {
   MAX_DECOMPRESS_SIZE,
   MAX_XML_DEPTH,
   MAX_ZIP_ENTRIES,
   ZipBombError,
   applyPageText,
+  childrenByLocalName,
   clampSpan,
   createSectionShared,
   createXmlParser,
+  elementChildren,
   extractTextFromNode,
-  findChildByLocalName
-} from "./chunk-NIISBGSR.js";
+  findChildByLocalName,
+  localName,
+  rawTextContent
+} from "./chunk-EFVAY5VE.js";
 import {
   KordocError,
   classifyError,
@@ -68,13 +67,277 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-3TSTZGCJ.js";
+} from "./chunk-DRQUAYNT.js";
 
 // src/index.ts
 import { readFile } from "fs/promises";
 
+// src/detect.ts
+import JSZip from "jszip";
+
+// src/hwp5/cfb-lenient.ts
+var CFB_MAGIC = Buffer.from([208, 207, 17, 224, 161, 177, 26, 225]);
+var END_OF_CHAIN = 4294967294;
+var FREE_SECT = 4294967295;
+var MAX_CHAIN_LENGTH = 1e6;
+var MAX_DIR_ENTRIES = 1e5;
+var MAX_STREAM_SIZE = 100 * 1024 * 1024;
+function parseLenientCfb(data) {
+  if (data.length < 512) throw new Error("CFB \uD30C\uC77C\uC774 \uB108\uBB34 \uC9E7\uC2B5\uB2C8\uB2E4 (\uCD5C\uC18C 512\uBC14\uC774\uD2B8)");
+  if (!data.subarray(0, 8).equals(CFB_MAGIC)) throw new Error("CFB \uB9E4\uC9C1 \uBC14\uC774\uD2B8 \uBD88\uC77C\uCE58");
+  const sectorSizeShift = data.readUInt16LE(30);
+  if (sectorSizeShift < 7 || sectorSizeShift > 16) throw new Error("\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uC139\uD130 \uD06C\uAE30 \uC2DC\uD504\uD2B8: " + sectorSizeShift);
+  const sectorSize = 1 << sectorSizeShift;
+  const miniSectorSizeShift = data.readUInt16LE(32);
+  if (miniSectorSizeShift > 16) throw new Error("\uC720\uD6A8\uD558\uC9C0 \uC54A\uC740 \uBBF8\uB2C8 \uC139\uD130 \uD06C\uAE30 \uC2DC\uD504\uD2B8: " + miniSectorSizeShift);
+  const miniSectorSize = 1 << miniSectorSizeShift;
+  const headerFatSectorCount = data.readUInt32LE(44);
+  if (headerFatSectorCount > 1e4) throw new Error("FAT \uC139\uD130 \uC218\uAC00 \uB108\uBB34 \uB9CE\uC2B5\uB2C8\uB2E4: " + headerFatSectorCount);
+  const maxRealSectors = Math.ceil(Math.max(0, data.length - 512) / sectorSize);
+  const maxFatSectors = Math.max(1, Math.ceil(maxRealSectors / (sectorSize / 4)));
+  const fatSectorCount = Math.min(headerFatSectorCount, maxFatSectors);
+  const firstDirSector = data.readUInt32LE(48);
+  const miniStreamCutoff = data.readUInt32LE(56);
+  const firstMiniFatSector = data.readUInt32LE(60);
+  const miniFatSectorCount = data.readUInt32LE(64);
+  const firstDifatSector = data.readUInt32LE(68);
+  const difatSectorCount = data.readUInt32LE(72);
+  function sectorOffset(id) {
+    return 512 + id * sectorSize;
+  }
+  function readSectorData(id) {
+    const off = sectorOffset(id);
+    if (off + sectorSize > data.length) return Buffer.alloc(0);
+    return data.subarray(off, off + sectorSize);
+  }
+  const fatSectors = [];
+  for (let i = 0; i < 109 && fatSectors.length < fatSectorCount; i++) {
+    const sid = data.readUInt32LE(76 + i * 4);
+    if (sid === FREE_SECT || sid === END_OF_CHAIN) break;
+    fatSectors.push(sid);
+  }
+  let difatSector = firstDifatSector;
+  const visitedDifat = /* @__PURE__ */ new Set();
+  for (let d = 0; d < difatSectorCount && difatSector !== END_OF_CHAIN && difatSector !== FREE_SECT; d++) {
+    if (visitedDifat.has(difatSector)) break;
+    visitedDifat.add(difatSector);
+    const buf = readSectorData(difatSector);
+    if (buf.length < sectorSize) break;
+    const entriesPerSector = sectorSize / 4 - 1;
+    for (let i = 0; i < entriesPerSector && fatSectors.length < fatSectorCount; i++) {
+      const sid = buf.readUInt32LE(i * 4);
+      if (sid === FREE_SECT || sid === END_OF_CHAIN) continue;
+      fatSectors.push(sid);
+    }
+    difatSector = buf.readUInt32LE(entriesPerSector * 4);
+  }
+  const entriesPerFatSector = sectorSize / 4;
+  const fatTable = new Uint32Array(fatSectors.length * entriesPerFatSector);
+  for (let fi = 0; fi < fatSectors.length; fi++) {
+    const buf = readSectorData(fatSectors[fi]);
+    for (let i = 0; i < entriesPerFatSector; i++) {
+      fatTable[fi * entriesPerFatSector + i] = i * 4 + 3 < buf.length ? buf.readUInt32LE(i * 4) : FREE_SECT;
+    }
+  }
+  function readChain(startSector, maxBytes) {
+    if (startSector === END_OF_CHAIN || startSector === FREE_SECT) return Buffer.alloc(0);
+    if (maxBytes > MAX_STREAM_SIZE) throw new Error("\uC2A4\uD2B8\uB9BC\uC774 \uB108\uBB34 \uD07D\uB2C8\uB2E4");
+    const chunks = [];
+    let current = startSector;
+    let totalRead = 0;
+    const visited = /* @__PURE__ */ new Set();
+    while (current !== END_OF_CHAIN && current !== FREE_SECT && totalRead < maxBytes) {
+      if (visited.has(current)) break;
+      if (visited.size > MAX_CHAIN_LENGTH) break;
+      visited.add(current);
+      const buf = readSectorData(current);
+      const remaining = maxBytes - totalRead;
+      chunks.push(remaining < sectorSize ? buf.subarray(0, remaining) : buf);
+      totalRead += Math.min(buf.length, remaining);
+      current = current < fatTable.length ? fatTable[current] : END_OF_CHAIN;
+    }
+    return Buffer.concat(chunks);
+  }
+  let miniFatTable = null;
+  function getMiniFatTable() {
+    if (miniFatTable) return miniFatTable;
+    if (miniFatSectorCount === 0 || firstMiniFatSector === END_OF_CHAIN) {
+      miniFatTable = new Uint32Array(0);
+      return miniFatTable;
+    }
+    const miniFatData = readChain(firstMiniFatSector, miniFatSectorCount * sectorSize);
+    const entries = miniFatData.length / 4;
+    miniFatTable = new Uint32Array(entries);
+    for (let i = 0; i < entries; i++) {
+      miniFatTable[i] = miniFatData.readUInt32LE(i * 4);
+    }
+    return miniFatTable;
+  }
+  const dirData = readChain(firstDirSector, MAX_DIR_ENTRIES * 128);
+  const dirEntries = [];
+  for (let offset = 0; offset + 128 <= dirData.length && dirEntries.length < MAX_DIR_ENTRIES; offset += 128) {
+    const nameLen = dirData.readUInt16LE(offset + 64);
+    if (nameLen <= 0 || nameLen > 64) {
+      dirEntries.push({ name: "", type: 0, startSector: 0, size: 0 });
+      continue;
+    }
+    const nameBytes = nameLen - 2;
+    const name = nameBytes > 0 ? dirData.subarray(offset, offset + nameBytes).toString("utf16le") : "";
+    const type = dirData[offset + 66];
+    const startSector = dirData.readUInt32LE(offset + 116);
+    const size = dirData.readUInt32LE(offset + 120);
+    dirEntries.push({ name, type, startSector, size });
+  }
+  let miniStreamData = null;
+  function getMiniStream() {
+    if (miniStreamData) return miniStreamData;
+    const root = dirEntries[0];
+    if (!root || root.type !== 5) {
+      miniStreamData = Buffer.alloc(0);
+      return miniStreamData;
+    }
+    miniStreamData = readChain(root.startSector, root.size || MAX_STREAM_SIZE);
+    return miniStreamData;
+  }
+  function readMiniStream(startSector, size) {
+    const mft = getMiniFatTable();
+    const ms = getMiniStream();
+    if (mft.length === 0 || ms.length === 0) return Buffer.alloc(0);
+    const chunks = [];
+    let current = startSector;
+    let totalRead = 0;
+    const visited = /* @__PURE__ */ new Set();
+    while (current !== END_OF_CHAIN && current !== FREE_SECT && totalRead < size) {
+      if (visited.has(current)) break;
+      if (visited.size > MAX_CHAIN_LENGTH) break;
+      visited.add(current);
+      const off = current * miniSectorSize;
+      const remaining = size - totalRead;
+      const chunkSize = Math.min(miniSectorSize, remaining);
+      if (off + chunkSize <= ms.length) {
+        chunks.push(ms.subarray(off, off + chunkSize));
+      }
+      totalRead += chunkSize;
+      current = current < mft.length ? mft[current] : END_OF_CHAIN;
+    }
+    return Buffer.concat(chunks);
+  }
+  function readStreamData(entry) {
+    if (entry.size === 0) return Buffer.alloc(0);
+    if (entry.size < miniStreamCutoff) {
+      const miniResult = readMiniStream(entry.startSector, entry.size);
+      if (miniResult.length > 0) return miniResult;
+    }
+    return readChain(entry.startSector, entry.size);
+  }
+  function findEntryByPath(path) {
+    const parts = path.replace(/^\//, "").split("/");
+    if (parts.length === 1) {
+      return dirEntries.find((e) => e.name === parts[0] && e.type === 2) ?? null;
+    }
+    const storageName = parts[0];
+    const streamName = parts.slice(1).join("/");
+    for (const e of dirEntries) {
+      if (e.type === 2 && e.name === streamName) {
+        return e;
+      }
+    }
+    const lastPart = parts[parts.length - 1];
+    return dirEntries.find((e) => e.type === 2 && e.name === lastPart) ?? null;
+  }
+  return {
+    findStream(path) {
+      const normalized = path.replace(/^\//, "");
+      const entry = findEntryByPath(normalized);
+      if (!entry || entry.type !== 2) return null;
+      const stream = readStreamData(entry);
+      return stream.length > 0 ? stream : null;
+    },
+    entries() {
+      return dirEntries.filter((e) => e.type === 2);
+    }
+  };
+}
+
+// src/detect.ts
+function magicBytes(buffer) {
+  return new Uint8Array(buffer, 0, Math.min(4, buffer.byteLength));
+}
+function isZipFile(buffer) {
+  const b = magicBytes(buffer);
+  return b[0] === 80 && b[1] === 75 && b[2] === 3 && b[3] === 4;
+}
+function isHwpxFile(buffer) {
+  return isZipFile(buffer);
+}
+function isOldHwpFile(buffer) {
+  const b = magicBytes(buffer);
+  return b[0] === 208 && b[1] === 207 && b[2] === 17 && b[3] === 224;
+}
+var HWP3_PREFIX = new TextEncoder().encode("HWP Document File V3.00");
+function isHwp3File(buffer) {
+  if (buffer.byteLength < HWP3_PREFIX.length) return false;
+  const head = new Uint8Array(buffer, 0, HWP3_PREFIX.length);
+  for (let i = 0; i < HWP3_PREFIX.length; i++) {
+    if (head[i] !== HWP3_PREFIX[i]) return false;
+  }
+  return true;
+}
+function isPdfFile(buffer) {
+  const b = magicBytes(buffer);
+  return b[0] === 37 && b[1] === 80 && b[2] === 68 && b[3] === 70;
+}
+function isImageFile(buffer) {
+  if (buffer.byteLength < 12) return false;
+  const b = new Uint8Array(buffer, 0, 12);
+  if (b[0] === 137 && b[1] === 80 && b[2] === 78 && b[3] === 71) return true;
+  if (b[0] === 255 && b[1] === 216 && b[2] === 255) return true;
+  if (b[0] === 82 && b[1] === 73 && b[2] === 70 && b[3] === 70 && b[8] === 87 && b[9] === 69 && b[10] === 66 && b[11] === 80) return true;
+  return false;
+}
+function isHwpmlFile(buffer) {
+  const bytes = new Uint8Array(buffer, 0, Math.min(512, buffer.byteLength));
+  const head = new TextDecoder("utf-8", { fatal: false }).decode(bytes).replace(/^\uFEFF/, "");
+  return head.trimStart().startsWith("<?xml") && head.includes("<HWPML");
+}
+function detectFormat(buffer) {
+  if (buffer.byteLength < 4) return "unknown";
+  if (isHwp3File(buffer)) return "hwp3";
+  if (isZipFile(buffer)) return "hwpx";
+  if (isOldHwpFile(buffer)) return "hwp";
+  if (isPdfFile(buffer)) return "pdf";
+  if (isHwpmlFile(buffer)) return "hwpml";
+  if (isImageFile(buffer)) return "image";
+  return "unknown";
+}
+function detectOle2Format(buffer) {
+  try {
+    const cfb = parseLenientCfb(Buffer.from(buffer));
+    const names = cfb.entries().map((e) => e.name);
+    if (names.includes("Workbook") || names.includes("Book")) return "xls";
+    if (names.includes("FileHeader")) return "hwp";
+    if (names.some((n) => n === "DocInfo" || n.startsWith("Section"))) return "hwp";
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+async function detectZipFormat(buffer) {
+  try {
+    const zip = await JSZip.loadAsync(buffer);
+    if (zip.file("xl/workbook.xml")) return "xlsx";
+    if (zip.file("word/document.xml")) return "docx";
+    if (zip.file("Contents/content.hpf") || zip.file("mimetype")) return "hwpx";
+    const hasSection = Object.keys(zip.files).some((f) => f.startsWith("Contents/"));
+    if (hasSection) return "hwpx";
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
 // src/hwpx/parser.ts
-import JSZip2 from "jszip";
+import JSZip3 from "jszip";
 
 // src/hwpx/com-fallback.ts
 import { execFileSync } from "child_process";
@@ -261,9 +524,9 @@ function parseCharProperties(doc, map) {
       if (bold === "true" || bold === "1") prop.bold = true;
       const italic = el.getAttribute("italic");
       if (italic === "true" || italic === "1") prop.italic = true;
-      const kids2 = el.childNodes;
-      for (let j = 0; j < (kids2?.length ?? 0); j++) {
-        const k = kids2[j];
+      const kids = el.childNodes;
+      for (let j = 0; j < (kids?.length ?? 0); j++) {
+        const k = kids[j];
         if (k.nodeType !== 1) continue;
         const localTag = (k.tagName || "").replace(/^[^:]+:/, "");
         if (localTag === "bold") prop.bold = true;
@@ -895,615 +1158,239 @@ function hmlToLatex(hmlEqStr) {
   return out;
 }
 
-// src/hwpx/geometry.ts
-var A4_W_HU = 59528;
-var A4_H_HU = 84188;
-var HU_PER_MM = 7200 / 25.4;
-function mmToHwpunit(mm) {
-  return Math.round(mm * 7200 / 25.4);
-}
-var BODY_WIDTH_20MM = mmToHwpunit(170);
-var COVER_MEASURED_W = 48180;
-var DATA_TABLE_ID_BASE = 1e3;
-var CHART_TABLE_ID_BASE = 91e5;
-var GJ_TABLE_ID_BASE = 92e5;
-var EXTRA_TABLE_ID_BASE = 93e5;
-var PIC_ID_BASE = 94e5;
-
-// src/hwpx/gaejosik.ts
-var GAEJOSIK_BULLETS = ["\u25A1", "\u25CB", "-", "\u318D"];
-function gaejosikMarker(depth, bullet2 = "\u25CB") {
-  if (depth === 1) return bullet2;
-  return GAEJOSIK_BULLETS[Math.min(depth, GAEJOSIK_BULLETS.length - 1)];
-}
-function gaejosikSizes(bodyHeight, ov = {}) {
-  const s = bodyHeight / 1500;
-  const r = (v, pt) => pt ? Math.round(pt * 100) : Math.round(v * s);
-  return {
-    /** □ 대항목 — HY헤드라인M 16pt */
-    dae: r(1600, ov.dae),
-    /** ※ 참고 — 한양중고딕 13pt */
-    cham: r(1300, ov.cham),
-    /** 장 헤더(로마숫자·제목) 17pt */
-    chapter: r(1700, ov.chapter),
-    /** 표지 제목 30pt */
-    coverTitle: r(3e3, ov.coverTitle),
-    /** 표지 날짜·기관명 25pt */
-    coverSub: r(2500, ov.coverSub),
-    /** 목차 라벨 "목  차" 28pt */
-    tocLabel: r(2800, ov.tocLabel),
-    /** 목차 로마숫자 21pt(한양신명조) */
-    tocRoman: r(2100, ov.tocRoman),
-    /** 목차 항목 18pt */
-    tocItem: r(1800, ov.tocItem),
-    /** 표 셀 — 맑은 고딕 12pt (실측: 정부 양식 표) */
-    table: r(1200, ov.table),
-    /** 표지 장식 바 셀 빈 문단 — 6pt (실측: 바 높이 818 안에 줄높이 수납) */
-    bar: r(600),
-    /** 본문 첫 페이지 제목 박스 — HY헤드라인M 22pt (실측: GT3 표④) */
-    bodyTitle: r(2200, ov.bodyTitle)
-  };
-}
-function gaejosikSpaceBefore(depth, bodyHeight) {
-  const s = bodyHeight / 1500;
-  const ui = [3e3, 2e3, 1200, 600][Math.min(depth, 3)];
-  return Math.round(ui * s);
-}
-function gaejosikLevelIndent(depth, bodyHeight, sizes = {}, bullet2 = "\u25CB") {
-  const lefts = [0, 1, 1.5, 2];
-  const left = depth <= 3 ? Math.round(lefts[depth] * bodyHeight) : Math.round((2 + (depth - 3) * 0.5) * bodyHeight);
-  const h = depth === 0 ? gaejosikSizes(bodyHeight, sizes).dae : bodyHeight;
-  return { left, indent: -markerWidth(gaejosikMarker(depth, bullet2), h) };
+// src/shared/numbering.ts
+var HANGUL_INITIALS = [0, 2, 3, 5, 6, 7, 9, 11, 12, 14, 15, 16, 17, 18];
+var HANGUL_MEDIALS = [0, 4, 8, 13, 18, 20];
+function hangulOrdinal(n) {
+  const cols = HANGUL_INITIALS.length;
+  const vowel = HANGUL_MEDIALS[Math.min(Math.floor(n / cols), HANGUL_MEDIALS.length - 1)];
+  const init = HANGUL_INITIALS[n % cols];
+  return String.fromCodePoint(44032 + init * 588 + vowel * 28);
 }
-function gaejosikChamIndent(bodyHeight, sizes = {}) {
-  const cham = gaejosikSizes(bodyHeight, sizes).cham;
-  return { left: Math.round(2.5 * cham), indent: -markerWidth("\u203B", cham) };
+function circledNumber(n) {
+  if (n < 20) return String.fromCodePoint(9312 + n);
+  if (n < 35) return String.fromCodePoint(12881 + (n - 20));
+  if (n < 50) return String.fromCodePoint(12977 + (n - 35));
+  return `(${n + 1})`;
 }
-function gaejosikTocItemIndent(bodyHeight, sizes = {}) {
-  const sz = gaejosikSizes(bodyHeight, sizes);
-  const hang = markerWidth("\u2167.", sz.tocRoman);
-  return { left: 2e3 + hang, indent: -hang };
+function circledHangul(n) {
+  return n < 14 ? String.fromCodePoint(12910 + n) : hangulOrdinal(n);
 }
-function formatGaejosikDate(d) {
-  return `${d.getFullYear()}. ${d.getMonth() + 1}. ${d.getDate()}.`;
+function romanNumeral(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 num2 = n;
+  for (let i = 0; i < values.length; i++) {
+    while (num2 >= values[i]) {
+      result += symbols[i];
+      num2 -= values[i];
+    }
+  }
+  return result;
 }
-function stripChapterNumber(title) {
-  return title.replace(/^\s*[□○ㅇㆍ-]\s+/u, "").replace(/^\s*(?:\d+(?:\.\d+)*|[Ⅰ-Ⅻ]+)\s*[.)]\s*/u, "").trim();
+
+// src/hwpx/para-heading.ts
+var HANGUL_JAMO_SEQ = "\u3131\u3134\u3137\u3139\u3141\u3142\u3145\u3147\u3148\u314A\u314B\u314C\u314D\u314E";
+function formatHeadNumber(n, numFormat) {
+  if (n === 0 && numFormat === "DIGIT") return "0";
+  if (n <= 0) n = 1;
+  switch (numFormat) {
+    case "DIGIT":
+      return String(n);
+    // 서수 시퀀스는 생성기(gongmun.ts)와 단일 소스 (v4.0.5) — 종전 mod-14 순환은
+    // 15번째 형제를 다시 '가'로 만들어 한글 실렌더(가→하→거→너 단모음 연속)와 어긋났다
+    case "CIRCLED_DIGIT":
+      return n <= 50 ? circledNumber(n - 1) : `(${n})`;
+    case "HANGUL_SYLLABLE":
+      return hangulOrdinal(n - 1);
+    case "CIRCLED_HANGUL_SYLLABLE":
+      return n <= 14 ? circledHangul(n - 1) : hangulOrdinal(n - 1);
+    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 romanNumeral(n, true);
+    case "ROMAN_SMALL":
+      return romanNumeral(n, false);
+    default:
+      return String(n);
+  }
 }
-var GAEJOSIK_COLORS = {
-  /** 장헤더 로마숫자 셀·표지 진한 바 음영 */
-  primary: "#193AAA",
-  /** 장헤더 셀 테두리 */
-  border: "#006699",
-  /** 표지 연한 바 */
-  accent: "#A0B4E6",
-  /** 장헤더 제목 셀 음영 */
-  titleFill: "#F2F2F2",
-  /** 장헤더 제목 셀 상하선 */
-  titleLine: "#A6A6A6",
-  /** 목차 박스 테두리 */
-  tocBorder: "#514BAC",
-  /** 목차 배너 라벤더 스트라이프 (실측: GT3 표②) */
-  tocStripe: "#E0E5FA"
-};
-var GAEJOSIK_BASE_WIDTH = BODY_WIDTH_20MM;
-var CHAPTER_GEOM = { numW: 3327, gapW: 848, titleW: 43513, rowH: 2832 };
-var COVER_GEOM = {
-  totalW: COVER_MEASURED_W,
-  topDarkW: 38219,
-  topLightW: 9961,
-  barH: 818,
-  titleH: 11060,
-  botDarkW: 10466,
-  botLightW: 37714,
-  botBarH: 812
-};
-var TOC_GEOM = { boxW: 46492, boxH: 57840 };
-function chapterGeom(bodyHeight, ov = {}, bodyWidth = GAEJOSIK_BASE_WIDTH) {
-  const s = gaejosikSizes(bodyHeight, ov).chapter / 1700;
-  const ws = bodyWidth / GAEJOSIK_BASE_WIDTH;
-  const numW = Math.round(CHAPTER_GEOM.numW * ws);
-  const gapW = Math.round(CHAPTER_GEOM.gapW * ws);
-  const titleW = Math.round((CHAPTER_GEOM.numW + CHAPTER_GEOM.gapW + CHAPTER_GEOM.titleW) * ws) - numW - gapW;
-  return { numW, gapW, titleW, rowH: Math.round(CHAPTER_GEOM.rowH * s) };
-}
-function coverGeom(bodyHeight, ov = {}, bodyWidth = GAEJOSIK_BASE_WIDTH) {
-  const s = gaejosikSizes(bodyHeight, ov).coverTitle / 3e3;
-  const w = (v) => Math.round(v * bodyWidth / GAEJOSIK_BASE_WIDTH);
-  const totalW = w(COVER_GEOM.totalW);
-  return {
-    ...COVER_GEOM,
-    totalW,
-    topDarkW: w(COVER_GEOM.topDarkW),
-    topLightW: totalW - w(COVER_GEOM.topDarkW),
-    botDarkW: w(COVER_GEOM.botDarkW),
-    botLightW: totalW - w(COVER_GEOM.botDarkW),
-    titleH: Math.round(COVER_GEOM.titleH * s)
-  };
-}
-var TOC_BANNER_GEOM = {
-  colWs: [565, 565, 1414, 13191, 1414, 565, 565],
-  h: 3931
-};
-function tocBannerGeom(bodyHeight, ov = {}) {
-  const s = gaejosikSizes(bodyHeight, ov).tocLabel / 2800;
-  return { colWs: TOC_BANNER_GEOM.colWs, h: Math.round(TOC_BANNER_GEOM.h * s) };
-}
-var BODY_TITLE_GEOM = { barH: 600, titleH: 3566 };
-function bodyTitleGeom(bodyHeight, ov = {}) {
-  const s = gaejosikSizes(bodyHeight, ov).bodyTitle / 2200;
-  return { barH: BODY_TITLE_GEOM.barH, titleH: Math.round(BODY_TITLE_GEOM.titleH * s) };
+function resolveParaHeading(paraEl, ctx) {
+  const sm = ctx.styleMap;
+  if (!sm) return null;
+  const styleId = paraEl.getAttribute("styleIDRef");
+  let styleHeading;
+  if (styleId && styleId !== "0") {
+    const st = sm.styles.get(styleId);
+    const m = st && /^개요\s*([1-6])$/.exec(st.name);
+    if (m) styleHeading = Math.min(parseInt(m[1], 10), 6);
+  }
+  const prId = paraEl.getAttribute("paraPrIDRef");
+  if (!prId) return styleHeading ? { headingLevel: styleHeading } : null;
+  const ref = sm.paraHeadings.get(prId);
+  if (!ref) return styleHeading ? { headingLevel: styleHeading } : 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(-1);
+    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] = -1;
+  const fmtText = head ? 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] >= 0 ? counters[lv] : refHead?.start ?? 1;
+    return formatHeadNumber(n, refHead?.numFormat || "DIGIT");
+  });
+  return { prefix: prefix || void 0, headingLevel };
 }
 
-// src/hwpx/gongmun.ts
-var OFFICIAL_MARGINS = { top: 20, bottom: 15, left: 20, right: 15 };
-var GAEJOSIK_MARGINS = { top: 15, bottom: 15, left: 20, right: 20 };
-var GAEJOSIK_HEADER_FOOTER = 4251;
-var PRESET_DEFAULTS = {
-  // 서울시 실결재 104건 중 12pt 64건(13pt 30, 15pt 5) — 지배값을 기본으로 사용.
-  official: { bodyPt: 12, lineSpacing: 160, numbering: "standard" },
-  report: { bodyPt: 15, lineSpacing: 160, numbering: "report" },
-  // 실측 추진계획안: □ → ㅇ → * 계층.
-  plan: { bodyPt: 15, lineSpacing: 160, numbering: "report" },
-  notice: { bodyPt: 15, lineSpacing: 160, numbering: "standard" },
-  minutes: { bodyPt: 14, lineSpacing: 130, numbering: "standard" },
-  gaejosik: { bodyPt: 15, lineSpacing: 160, numbering: "gaejosik" },
-  // 보도자료 — 실측(국토부 실물): 본문 바탕 14pt 160%, □→ㅇ→*(각주) 부호
-  press: { bodyPt: 14, lineSpacing: 160, numbering: "report" }
-};
-var PRESET_ALIAS = {
-  official: "official",
-  \uAE30\uC548\uBB38: "official",
-  \uC2DC\uD589\uBB38: "official",
-  \uACF5\uBB38: "official",
-  \uACF5\uBB38\uC11C: "official",
-  report: "report",
-  \uBCF4\uACE0\uC11C: "report",
-  plan: "plan",
-  \uACC4\uD68D\uC11C: "plan",
-  \uACC4\uD68D: "plan",
-  notice: "notice",
-  \uD1B5\uC9C0: "notice",
-  \uC54C\uB9BC: "notice",
-  \uC548\uB0B4: "notice",
-  minutes: "minutes",
-  \uD68C\uC758\uB85D: "minutes",
-  gaejosik: "gaejosik",
-  \uAC1C\uC870\uC2DD: "gaejosik",
-  \uAC1C\uC870\uC2DD\uBCF4\uACE0\uC11C: "gaejosik",
-  \uC815\uBD80\uBCF4\uACE0\uC11C: "gaejosik",
-  \uC815\uBD80\uD45C\uC900\uAC1C\uC870\uC2DD\uBCF4\uACE0\uC11C: "gaejosik",
-  press: "press",
-  \uBCF4\uB3C4\uC790\uB8CC: "press"
-};
-function normalizeGongmunPreset(preset) {
-  if (!preset) return "official";
-  return PRESET_ALIAS[preset.trim()] ?? "official";
-}
-function usesReportFonts(preset) {
-  return preset === "gaejosik" || preset === "report" || preset === "plan";
-}
-function usesAsteriskThird(preset) {
-  return preset === "plan" || preset === "press";
-}
-function needsGaejosikAssets(gongmun) {
-  return usesReportFonts(gongmun.preset) || gongmun.cover !== null || gongmun.toc;
-}
-function assertFiniteRange(name, value, min, max) {
-  if (!Number.isFinite(value) || value < min || value > max) {
-    throw new KordocError(`${name} must be a finite number between ${min} and ${max}`);
+// src/hwpx/table-build.ts
+function buildTableWithCellMeta(state, keepAnchoredEmptyCols, keepEmptyParagraphs) {
+  const table2 = buildTable(state.rows, { keepAnchoredEmptyCols, keepEmptyParagraphs });
+  if (state.caption) table2.caption = state.caption;
+  if (state.captionBlocks?.length) table2.captionBlocks = state.captionBlocks;
+  const anchors = [];
+  {
+    const covered = /* @__PURE__ */ new Set();
+    for (let r = 0; r < table2.rows; r++) {
+      for (let c = 0; c < table2.cols; c++) {
+        if (covered.has(`${r},${c}`)) continue;
+        const cell2 = table2.cells[r]?.[c];
+        if (!cell2) continue;
+        for (let dr = 0; dr < cell2.rowSpan; dr++) {
+          for (let dc = 0; dc < cell2.colSpan; dc++) {
+            if (dr === 0 && dc === 0) continue;
+            if (r + dr < table2.rows && c + dc < table2.cols) covered.add(`${r + dr},${c + dc}`);
+          }
+        }
+        anchors.push(cell2);
+        c += cell2.colSpan - 1;
+      }
+    }
+  }
+  const srcCount = state.rows.reduce((s, r) => s + r.length, 0);
+  const ordinalReliable = anchors.length === srcCount;
+  const claimed = /* @__PURE__ */ new Set();
+  let flatIdx = -1;
+  for (const row of state.rows) {
+    for (const src of row) {
+      flatIdx++;
+      const needsBlocks = !!src.blocks && src.blocks.length > 0 && (src.hasStructure || src.blocks.some((b) => b.spans));
+      if (!needsBlocks && !src.isHeader) continue;
+      let target;
+      const trimmed = keepEmptyParagraphs ? src.text : src.text.trim();
+      if (src.rowAddr !== void 0 && src.colAddr !== void 0) {
+        const cand = table2.cells[src.rowAddr]?.[src.colAddr];
+        if (cand && cand.text === trimmed && !claimed.has(cand)) target = cand;
+      }
+      if (!target) {
+        outer: for (const irRow of table2.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 && ordinalReliable) {
+        const cand = anchors[flatIdx];
+        if (cand && !claimed.has(cand)) target = cand;
+      }
+      if (!target) continue;
+      claimed.add(target);
+      if (needsBlocks) target.blocks = src.blocks;
+      if (src.isHeader) target.isHeader = true;
+    }
   }
+  return table2;
 }
-function validateGongmunOptions(opts) {
-  if (opts.bodyPt !== void 0) assertFiniteRange("bodyPt", opts.bodyPt, 6, 40);
-  if (opts.lineSpacing !== void 0) assertFiniteRange("lineSpacing", opts.lineSpacing, 50, 300);
-  if (typeof opts.autoFit === "object" && opts.autoFit.minRatio !== void 0) {
-    assertFiniteRange("autoFit.minRatio", opts.autoFit.minRatio, 50, 99);
+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;
   }
-  if (opts.margins) {
-    for (const side of ["top", "bottom", "left", "right"]) {
-      const value = opts.margins[side];
-      assertFiniteRange(`margins.${side}`, value, 0, 200);
-    }
-    if (opts.margins.left + opts.margins.right >= 210) {
-      throw new KordocError("margins.left + margins.right must be less than 210");
-    }
-    if (opts.margins.top + opts.margins.bottom >= 297) {
-      throw new KordocError("margins.top + margins.bottom must be less than 297");
+  const ir = buildTableWithCellMeta(newTable, ctx.shared.keepTrailingEmptyCols, ctx.shared.keepEmptyParagraphs);
+  const block = { type: "table", table: ir, pageNumber: ctx.sectionNum };
+  if (parentTable?.cell) {
+    const cell2 = parentTable.cell;
+    (cell2.blocks ??= []).push(block);
+    cell2.hasStructure = true;
+    let flat = convertTableToText(newTable.rows);
+    if (newTable.caption) flat = newTable.caption + (flat ? "\n" + flat : "");
+    if (flat) {
+      const inlineJoin = newTable.inline === true && cell2.lineOpen === true;
+      cell2.text += (cell2.text ? inlineJoin ? " " : "\n" : "") + flat;
+      cell2.lineOpen = newTable.inline === true;
     }
+  } else {
+    blocks.push(block);
   }
-  if (opts.sizes) {
-    for (const [key, value] of Object.entries(opts.sizes)) {
-      if (value !== void 0) assertFiniteRange(`sizes.${key}`, value, 6, 60);
+  return parentTable;
+}
+
+// src/hwpx/section-walker.ts
+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;
     }
   }
-  if (opts.approval && opts.approval.length > 6) {
-    throw new KordocError("approval must contain at most 6 labels");
-  }
+  const blocks = [];
+  walkSection(doc.documentElement, blocks, null, [], ctx);
+  return blocks;
 }
-function incompatibleGongmunWarnings(opts) {
-  const warns = [];
-  const preset = normalizeGongmunPreset(opts.preset);
-  if (opts.docHead && preset !== "official") warns.push(`doc_head(\uB450\uBB38)\uB294 \uAE30\uC548\uBB38(official) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
-  if (opts.docFoot && preset !== "official") warns.push(`doc_foot(\uACB0\uBB38)\uB294 \uAE30\uC548\uBB38(official) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
-  if (opts.noticeHead && preset !== "notice") warns.push(`notice_head(\uACF5\uACE0\uBC88\uD638\xB7\uBC1C\uC2E0\uBA85\uC758)\uB294 \uD1B5\uC9C0(notice) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
-  if (opts.press && preset !== "press") warns.push(`press(\uBA38\uB9AC\uBC15\uC2A4\xB7\uBD80\uC81C\xB7\uB2F4\uB2F9)\uB294 \uBCF4\uB3C4\uC790\uB8CC(press) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
-  if (preset === "press" && (opts.cover === true || typeof opts.cover === "object" || opts.toc === true)) {
-    warns.push("\uBCF4\uB3C4\uC790\uB8CC\uB294 \uBA38\uB9AC\uBC15\uC2A4 \uC11C\uC2DD\uACFC \uC591\uB9BD \uBD88\uAC00\uB77C \uD45C\uC9C0\xB7\uBAA9\uCC28\uAC00 \uBB34\uC2DC\uB428");
-  }
-  if (opts.sizes && Object.keys(opts.sizes).length > 0 && !usesReportFonts(preset)) {
-    warns.push(`sizes(\uAC1C\uC870\uC2DD \uC694\uC18C \uD06C\uAE30)\uB294 \uAC1C\uC870\uC2DD\xB7\uBCF4\uACE0\uC11C\xB7\uACC4\uD68D\uC11C \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
-  }
-  if (opts.suppressSingle && (opts.numbering ?? PRESET_DEFAULTS[preset].numbering) !== "standard") {
-    warns.push(`suppress_single(\uB2E8\uC77C \uD615\uC81C \uBD80\uD638 \uC0DD\uB7B5)\uC740 \uBC95\uC815 \uBC88\uD638(standard) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B(\uBD88\uB9BF \uCCB4\uACC4)\uC5D0\uC11C \uBB34\uB3D9\uC791`);
+function extractImageRef(el, depth = 0) {
+  if (depth > MAX_XML_DEPTH) return null;
+  const children = el.childNodes;
+  if (!children) return null;
+  for (let i = 0; i < children.length; i++) {
+    const child = children[i];
+    if (child.nodeType !== 1) continue;
+    const tag = (child.tagName || child.localName || "").replace(/^[^:]+:/, "");
+    if (tag === "imgRect" || tag === "img" || tag === "imgClip") {
+      const ref = child.getAttribute("binaryItemIDRef") || child.getAttribute("href") || "";
+      if (ref) return ref;
+    }
+    const nested = extractImageRef(child, depth + 1);
+    if (nested) return nested;
   }
-  return warns;
-}
-function resolveGongmun(opts) {
-  validateGongmunOptions(opts);
-  const preset = normalizeGongmunPreset(opts.preset);
-  const d = PRESET_DEFAULTS[preset];
-  const bodyPt = opts.bodyPt ?? d.bodyPt;
-  const autoFitMinRatio = opts.autoFit === false ? null : typeof opts.autoFit === "object" ? Math.min(Math.max(opts.autoFit.minRatio ?? 90, 50), 99) : 90;
-  const coverOn = opts.cover !== void 0 ? opts.cover !== false : preset === "gaejosik";
-  const coverOpts = typeof opts.cover === "object" ? opts.cover : {};
-  const gaejosik = preset === "gaejosik";
-  const reportFamily = gaejosik || preset === "report" || preset === "plan" || preset === "notice" || preset === "press";
-  return {
-    preset,
-    bodyFont: opts.bodyFont ?? "myeongjo",
-    bodyHeight: Math.round(bodyPt * 100),
-    lineSpacing: opts.lineSpacing ?? d.lineSpacing,
-    numbering: opts.numbering ?? d.numbering,
-    margins: opts.margins ?? (reportFamily ? GAEJOSIK_MARGINS : OFFICIAL_MARGINS),
-    centerTitle: opts.centerTitle ?? true,
-    autoFitMinRatio,
-    // 보도자료는 머리박스가 1페이지 최상단을 차지하는 서식이라 표지·목차와 양립 불가 —
-    // 켜면 머리박스가 표지에 얹히고 25pt 제목·부제가 유실된다 (docHead 프리셋 게이팅과 동일 관례)
-    cover: coverOn && preset !== "press" ? { date: coverOpts.date ?? null, org: coverOpts.org ?? "" } : null,
-    toc: preset !== "press" && (opts.toc ?? gaejosik),
-    fonts: opts.fonts ?? {},
-    sizes: opts.sizes ?? {},
-    // 쪽번호 — 보고서 계열 관행(실측: 2_보고서 양식·추진계획·공고문 전부 하단 중앙)
-    pageNumbers: opts.pageNumbers ?? (gaejosik || preset === "report" || preset === "plan"),
-    // 머리말·꼬리말 — 실측: 보고서 계열 15mm(GT3·t2·춘천·브라더), 공고·보도 10mm,
-    // 기안문 0(실결재 41/60건 h0/f0)
-    headerFooter: usesReportFonts(preset) ? GAEJOSIK_HEADER_FOOTER : preset === "notice" || preset === "press" ? 2835 : 0,
-    // "끝." — 기안문 규정(본문 끝 2타+"끝."). 그 외는 opt-in
-    endMark: opts.endMark ?? preset === "official",
-    approval: opts.approval && opts.approval.length > 0 ? opts.approval : null,
-    // 본문 제목박스 — 실측(GT3·GT12): 목차 뒤 본문 시작에 제목 반복. 표지 켜진 개조식 기본
-    bodyTitleBox: opts.bodyTitleBox ?? (gaejosik && coverOn),
-    // h2 말머리 — 실측: 보고서 양식 □ 대항목(QA-2), 공고문 아라비아("1. 사업개요", 바이오헬스 실측)
-    h2Marker: opts.h2Marker ?? (preset === "report" || preset === "plan" ? "box" : preset === "notice" ? "number" : "none"),
-    // 2단계 부호 — 실결재 기안문·공고문 ㅇ 지배(60건 중 ㅇ134:○5), 보고서 양식 계열 ○
-    bullet2: opts.bullet2 ?? (preset === "plan" || preset === "notice" || preset === "press" ? "\u3147" : "\u25CB"),
-    // 단일 형제 부호 생략 — 규정이지만 부호 없는 계단이 실무 눈에 어색 (실무자 QA)
-    suppressSingle: opts.suppressSingle ?? false,
-    docHead: preset === "official" && opts.docHead ? opts.docHead : null,
-    docFoot: preset === "official" && opts.docFoot ? opts.docFoot : null,
-    reportInfo: opts.reportInfo?.trim() || null,
-    noticeHead: preset === "notice" && opts.noticeHead ? opts.noticeHead : null,
-    // 보도자료 머리박스는 프리셋 자체가 요구 — 옵션 미지정이어도 빈 객체
-    press: preset === "press" ? opts.press ?? {} : null
-  };
-}
-var HANGUL_INITIALS = [0, 2, 3, 5, 6, 7, 9, 11, 12, 14, 15, 16, 17, 18];
-var HANGUL_MEDIALS = [0, 4, 8, 13, 18, 20];
-function hangulOrdinal(n) {
-  const cols = HANGUL_INITIALS.length;
-  const vowel = HANGUL_MEDIALS[Math.min(Math.floor(n / cols), HANGUL_MEDIALS.length - 1)];
-  const init = HANGUL_INITIALS[n % cols];
-  return String.fromCodePoint(44032 + init * 588 + vowel * 28);
-}
-function circledNumber(n) {
-  if (n < 20) return String.fromCodePoint(9312 + n);
-  if (n < 35) return String.fromCodePoint(12881 + (n - 20));
-  if (n < 50) return String.fromCodePoint(12977 + (n - 35));
-  return `(${n + 1})`;
-}
-function circledHangul(n) {
-  return n < 14 ? String.fromCodePoint(12910 + n) : hangulOrdinal(n);
-}
-var REPORT_BULLETS = ["\u25A1", "\u25CB", "-", "\u318D"];
-var ASTERISK_BULLETS = ["\u25A1", "\u25CB", "*", "\u318D"];
-function standardMarker(depth, n) {
-  switch (depth) {
-    case 0:
-      return `${n + 1}.`;
-    case 1:
-      return `${hangulOrdinal(n)}.`;
-    case 2:
-      return `${n + 1})`;
-    case 3:
-      return `${hangulOrdinal(n)})`;
-    case 4:
-      return `(${n + 1})`;
-    case 5:
-      return `(${hangulOrdinal(n)})`;
-    case 6:
-      return circledNumber(n);
-    case 7:
-      return circledHangul(n);
-    default:
-      return circledHangul(n);
-  }
-}
-function reportMarker(depth, bullet2 = "\u25CB", asteriskThird = false) {
-  const bullets = asteriskThird ? ASTERISK_BULLETS : REPORT_BULLETS;
-  const m = bullets[Math.min(depth, bullets.length - 1)];
-  return depth === 1 ? bullet2 : m;
-}
-function markerWidth(marker, bodyHeight) {
-  let em = SPACE_EM_FIXED;
-  for (const c of marker) em += charWidthEm1000(c.codePointAt(0));
-  return Math.round(em / 1e3 * bodyHeight);
-}
-function levelIndent(depth, bodyHeight, numbering, sizes = {}, bullet2 = "\u25CB", asteriskThird = false) {
-  if (numbering === "gaejosik") return gaejosikLevelIndent(depth, bodyHeight, sizes, bullet2);
-  const marker = numbering === "report" ? reportMarker(depth, bullet2, asteriskThird) : standardMarker(depth, 0);
-  return { left: Math.round(depth * bodyHeight), indent: -markerWidth(marker, bodyHeight) };
-}
-function computeSuppression(depths) {
-  const counts = /* @__PURE__ */ new Map();
-  const keys = [];
-  const path = [];
-  for (const depth of depths) {
-    path.length = depth + 1;
-    path[depth] = (path[depth] ?? 0) + 1;
-    const parentKey = path.slice(0, depth).join(".") + "|" + depth;
-    keys.push(parentKey);
-    counts.set(parentKey, (counts.get(parentKey) ?? 0) + 1);
-  }
-  return keys.map((k) => (counts.get(k) ?? 0) <= 1);
-}
-var GongmunNumberer = class {
-  constructor(numbering, bullet2 = "\u25CB", asteriskThird = false) {
-    this.numbering = numbering;
-    this.bullet2 = bullet2;
-    this.asteriskThird = asteriskThird;
-  }
-  counts = [];
-  /** depth 항목 하나에 대한 마커. suppress=true면 빈 문자열(부호 없음) */
-  next(depth, suppress) {
-    this.counts.length = depth + 1;
-    const n = this.counts[depth] ?? 0;
-    this.counts[depth] = n + 1;
-    if (suppress) return "";
-    if (this.numbering === "gaejosik") return gaejosikMarker(depth, this.bullet2);
-    return this.numbering === "report" ? reportMarker(depth, this.bullet2, this.asteriskThird) : standardMarker(depth, n);
-  }
-  reset() {
-    this.counts = [];
-  }
-};
-
-// src/hwpx/para-heading.ts
-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 table2 = [
-    [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 table2) {
-    while (n >= v) {
-      out += s;
-      n -= v;
-    }
-  }
-  return out;
-}
-function formatHeadNumber(n, numFormat) {
-  if (n === 0 && numFormat === "DIGIT") return "0";
-  if (n <= 0) n = 1;
-  switch (numFormat) {
-    case "DIGIT":
-      return String(n);
-    // 서수 시퀀스는 생성기(gongmun.ts)와 단일 소스 (v4.0.5) — 종전 mod-14 순환은
-    // 15번째 형제를 다시 '가'로 만들어 한글 실렌더(가→하→거→너 단모음 연속)와 어긋났다
-    case "CIRCLED_DIGIT":
-      return n <= 50 ? circledNumber(n - 1) : `(${n})`;
-    case "HANGUL_SYLLABLE":
-      return hangulOrdinal(n - 1);
-    case "CIRCLED_HANGUL_SYLLABLE":
-      return n <= 14 ? circledHangul(n - 1) : hangulOrdinal(n - 1);
-    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 styleId = paraEl.getAttribute("styleIDRef");
-  let styleHeading;
-  if (styleId && styleId !== "0") {
-    const st = sm.styles.get(styleId);
-    const m = st && /^개요\s*([1-6])$/.exec(st.name);
-    if (m) styleHeading = Math.min(parseInt(m[1], 10), 6);
-  }
-  const prId = paraEl.getAttribute("paraPrIDRef");
-  if (!prId) return styleHeading ? { headingLevel: styleHeading } : null;
-  const ref = sm.paraHeadings.get(prId);
-  if (!ref) return styleHeading ? { headingLevel: styleHeading } : 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(-1);
-    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] = -1;
-  const fmtText = head ? 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] >= 0 ? counters[lv] : refHead?.start ?? 1;
-    return formatHeadNumber(n, refHead?.numFormat || "DIGIT");
-  });
-  return { prefix: prefix || void 0, headingLevel };
-}
-
-// src/hwpx/table-build.ts
-function buildTableWithCellMeta(state, keepAnchoredEmptyCols) {
-  const table2 = buildTable(state.rows, { keepAnchoredEmptyCols });
-  if (state.caption) table2.caption = state.caption;
-  if (state.captionBlocks?.length) table2.captionBlocks = state.captionBlocks;
-  const anchors = [];
-  {
-    const covered = /* @__PURE__ */ new Set();
-    for (let r = 0; r < table2.rows; r++) {
-      for (let c = 0; c < table2.cols; c++) {
-        if (covered.has(`${r},${c}`)) continue;
-        const cell2 = table2.cells[r]?.[c];
-        if (!cell2) continue;
-        for (let dr = 0; dr < cell2.rowSpan; dr++) {
-          for (let dc = 0; dc < cell2.colSpan; dc++) {
-            if (dr === 0 && dc === 0) continue;
-            if (r + dr < table2.rows && c + dc < table2.cols) covered.add(`${r + dr},${c + dc}`);
-          }
-        }
-        anchors.push(cell2);
-        c += cell2.colSpan - 1;
-      }
-    }
-  }
-  const srcCount = state.rows.reduce((s, r) => s + r.length, 0);
-  const ordinalReliable = anchors.length === srcCount;
-  const claimed = /* @__PURE__ */ new Set();
-  let flatIdx = -1;
-  for (const row of state.rows) {
-    for (const src of row) {
-      flatIdx++;
-      const needsBlocks = !!src.blocks && src.blocks.length > 0 && (src.hasStructure || src.blocks.some((b) => b.spans));
-      if (!needsBlocks && !src.isHeader) continue;
-      let target;
-      const trimmed = src.text.trim();
-      if (src.rowAddr !== void 0 && src.colAddr !== void 0) {
-        const cand = table2.cells[src.rowAddr]?.[src.colAddr];
-        if (cand && cand.text === trimmed && !claimed.has(cand)) target = cand;
-      }
-      if (!target) {
-        outer: for (const irRow of table2.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 && ordinalReliable) {
-        const cand = anchors[flatIdx];
-        if (cand && !claimed.has(cand)) target = cand;
-      }
-      if (!target) continue;
-      claimed.add(target);
-      if (needsBlocks) target.blocks = src.blocks;
-      if (src.isHeader) target.isHeader = true;
-    }
-  }
-  return table2;
-}
-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, ctx.shared.keepTrailingEmptyCols);
-  const block = { type: "table", table: ir, pageNumber: ctx.sectionNum };
-  if (parentTable?.cell) {
-    const cell2 = parentTable.cell;
-    (cell2.blocks ??= []).push(block);
-    cell2.hasStructure = true;
-    let flat = convertTableToText(newTable.rows);
-    if (newTable.caption) flat = newTable.caption + (flat ? "\n" + flat : "");
-    if (flat) {
-      const inlineJoin = newTable.inline === true && cell2.lineOpen === true;
-      cell2.text += (cell2.text ? inlineJoin ? " " : "\n" : "") + flat;
-      cell2.lineOpen = newTable.inline === true;
-    }
-  } else {
-    blocks.push(block);
-  }
-  return parentTable;
-}
-
-// src/hwpx/section-walker.ts
-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 = [];
-  walkSection(doc.documentElement, blocks, null, [], ctx);
-  return blocks;
-}
-function extractImageRef(el, depth = 0) {
-  if (depth > MAX_XML_DEPTH) return null;
-  const children = el.childNodes;
-  if (!children) return null;
-  for (let i = 0; i < children.length; i++) {
-    const child = children[i];
-    if (child.nodeType !== 1) continue;
-    const tag = (child.tagName || child.localName || "").replace(/^[^:]+:/, "");
-    if (tag === "imgRect" || tag === "img" || tag === "imgClip") {
-      const ref = child.getAttribute("binaryItemIDRef") || child.getAttribute("href") || "";
-      if (ref) return ref;
-    }
-    const nested = extractImageRef(child, depth + 1);
-    if (nested) return nested;
-  }
-  const directRef = el.getAttribute("binaryItemIDRef") || "";
-  if (directRef) return directRef;
-  return null;
+  const directRef = el.getAttribute("binaryItemIDRef") || "";
+  if (directRef) return directRef;
+  return null;
 }
 function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
   if (depth > MAX_XML_DEPTH) return;
@@ -1625,7 +1512,8 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
           if (tableCtx?.cell) {
             const cell2 = tableCtx.cell;
             if (footnote) text += ` (\uC8FC: ${footnote})`;
-            cell2.text += (cell2.text ? "\n" : "") + text;
+            cell2.text += (cell2.text || cell2.paraSeen ? "\n" : "") + text;
+            cell2.paraSeen = true;
             const cellBlock = { type: "paragraph", text, pageNumber: ctx.sectionNum };
             const cellSpanMode = spanModeOf(ctx.shared.kordocLayout);
             if (cellSpanMode && !ph?.prefix) {
@@ -1670,6 +1558,16 @@ function walkSection(node, blocks, tableCtx, tableStack, ctx, depth = 0) {
           } else {
             blocks.push({ type: "paragraph", text, pageNumber: ctx.sectionNum });
           }
+        } else if (ctx.shared.keepEmptyParagraphs && !hasObjectDescendant(el)) {
+          if (tableCtx?.cell) {
+            const cell2 = tableCtx.cell;
+            if (cell2.text || cell2.paraSeen) cell2.text += "\n";
+            cell2.paraSeen = true;
+            cell2.lineOpen = false;
+            (cell2.blocks ??= []).push({ type: "paragraph", text: "", pageNumber: ctx.sectionNum });
+          } else if (!tableCtx) {
+            blocks.push({ type: "paragraph", text: "", pageNumber: ctx.sectionNum });
+          }
         }
         tableCtx = walkParagraphChildren(el, blocks, tableCtx, tableStack, ctx, depth + 1);
         break;
@@ -1846,10 +1744,10 @@ function buildSubListTable(el, ctx, depth) {
 }
 function findTopLevelTbls(el, out, depth = 0) {
   if (depth > MAX_XML_DEPTH) return;
-  const kids2 = el.childNodes;
-  if (!kids2) return;
-  for (let i = 0; i < kids2.length; i++) {
-    const ch = kids2[i];
+  const kids = el.childNodes;
+  if (!kids) return;
+  for (let i = 0; i < kids.length; i++) {
+    const ch = kids[i];
     if (ch.nodeType !== 1) continue;
     const tag = (ch.tagName || ch.localName || "").replace(/^[^:]+:/, "");
     if (tag === "tbl") {
@@ -1865,10 +1763,10 @@ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth =
   if (!children) return tableCtx;
   const walkChildren = (parent, d, inShape = false) => {
     if (d > MAX_XML_DEPTH) return;
-    const kids2 = parent.childNodes;
-    if (!kids2) return;
-    for (let i = 0; i < kids2.length; i++) {
-      const el = kids2[i];
+    const kids = parent.childNodes;
+    if (!kids) return;
+    for (let i = 0; i < kids.length; i++) {
+      const el = kids[i];
       if (el.nodeType !== 1) continue;
       const tag = el.tagName || el.localName || "";
       const localTag = tag.replace(/^[^:]+:/, "");
@@ -1922,6 +1820,20 @@ function walkParagraphChildren(node, blocks, tableCtx, tableStack, ctx, depth =
   walkChildren(node, depth);
   return tableCtx;
 }
+var OBJECT_TAGS = /* @__PURE__ */ new Set(["tbl", "pic", "shape", "drawingObject", "drawText"]);
+function hasObjectDescendant(node, depth = 0) {
+  if (depth > MAX_XML_DEPTH) return false;
+  const kids = node.childNodes;
+  if (!kids) return false;
+  for (let i = 0; i < kids.length; i++) {
+    const ch = kids[i];
+    if (ch.nodeType !== 1) continue;
+    const tag = (ch.tagName || ch.localName || "").replace(/^[^:]+:/, "");
+    if (OBJECT_TAGS.has(tag)) return true;
+    if (hasObjectDescendant(ch, depth + 1)) return true;
+  }
+  return false;
+}
 function isInlineTbl(tbl2) {
   return findChildByLocalName(tbl2, "pos")?.getAttribute("treatAsChar") === "1";
 }
@@ -2009,10 +1921,10 @@ function extractParagraphInfo(para2, styleMap, ctx) {
     if (open?.rangeIdx !== void 0) linkRanges[open.rangeIdx].end = text.length;
   };
   const handleCtrl = (ctrlEl) => {
-    const kids2 = ctrlEl.childNodes;
-    if (!kids2) return;
-    for (let j = 0; j < kids2.length; j++) {
-      const k = kids2[j];
+    const kids = ctrlEl.childNodes;
+    if (!kids) return;
+    for (let j = 0; j < kids.length; j++) {
+      const k = kids[j];
       if (k.nodeType !== 1) continue;
       const ktag = (k.tagName || k.localName || "").replace(/^[^:]+:/, "");
       switch (ktag) {
@@ -2205,6 +2117,13 @@ function extractParagraphInfo(para2, styleMap, ctx) {
               const latex = hmlToLatex(raw).trim();
               if (latex) text += " $" + latex + "$ ";
             } catch {
+              if (ctx?.warnings) {
+                ctx.warnings.push({
+                  page: ctx.sectionNum,
+                  message: `\uC218\uC2DD LaTeX \uBCC0\uD658 \uC2E4\uD328 \u2014 \uC218\uC2DD \uD14D\uC2A4\uD2B8 \uC81C\uC678: ${raw.trim().slice(0, 40)}`,
+                  code: "PARTIAL_PARSE"
+                });
+              }
             }
           }
           break;
@@ -2276,10 +2195,10 @@ function extractRunSpans(para2, ctx, mode, requireMixed) {
   if (!styleMap) return null;
   const spans = [];
   let styled = false;
-  const kids2 = para2.childNodes;
-  if (!kids2) return null;
-  for (let i = 0; i < kids2.length; i++) {
-    const child = kids2[i];
+  const kids = para2.childNodes;
+  if (!kids) return null;
+  for (let i = 0; i < kids.length; i++) {
+    const child = kids[i];
     if (child.nodeType !== 1) continue;
     const tag = (child.tagName || child.localName || "").replace(/^[^:]+:/, "");
     if (tag === "linesegarray") continue;
@@ -2334,9 +2253,9 @@ function gongmunDepthFromIndent(para2, left, ctx) {
   const styleMap = ctx.styleMap;
   if (!styleMap) return null;
   let unit = 0;
-  const kids2 = para2.childNodes;
-  for (let i = 0; i < (kids2?.length ?? 0); i++) {
-    const child = kids2[i];
+  const kids = para2.childNodes;
+  for (let i = 0; i < (kids?.length ?? 0); i++) {
+    const child = kids[i];
     if (child.nodeType !== 1) continue;
     const tag = (child.tagName || child.localName || "").replace(/^[^:]+:/, "");
     if (tag !== "run" && tag !== "r") continue;
@@ -2650,17 +2569,19 @@ function normalizeBinPayload(data) {
   return data;
 }
 var BIN_ENTRY_RE = /(?:^|\/)BIN([0-9A-Fa-f]{4,8})(?:\.[^./\\]*)?$/;
-function collectImageBlocks(blocks, out) {
+var MAX_BLOCK_DEPTH = 200;
+function collectImageBlocks(blocks, out, depth = 0) {
+  if (depth > MAX_BLOCK_DEPTH) return;
   for (const b of blocks) {
     if (b.type === "image") out.push(b);
     if (b.table) {
       for (const row of b.table.cells) {
         for (const cell2 of row) {
-          if (cell2.blocks) collectImageBlocks(cell2.blocks, out);
+          if (cell2.blocks) collectImageBlocks(cell2.blocks, out, depth + 1);
         }
       }
     }
-    if (b.children) collectImageBlocks(b.children, out);
+    if (b.children) collectImageBlocks(b.children, out, depth + 1);
   }
 }
 function forEachTableCell(blocks, fn) {
@@ -2828,6 +2749,7 @@ function collectImageBlocks2(blocks, out, ownerCell, depth = 0) {
         }
       }
     }
+    if (block.children?.length) collectImageBlocks2(block.children, out, ownerCell, depth + 1);
   }
 }
 async function extractImagesFromZip(zip, blocks, decompressed, warnings, sweepUnreferenced) {
@@ -2925,7 +2847,7 @@ async function extractImagesFromZip(zip, blocks, decompressed, warnings, sweepUn
 }
 
 // src/hwpx/metadata.ts
-import JSZip from "jszip";
+import JSZip2 from "jszip";
 
 // src/hwpx/zip-sections.ts
 import { inflateRawSync as inflateRawSync2 } from "zlib";
@@ -3089,7 +3011,7 @@ function parseDublinCoreMetadata(xml, metadata) {
 async function extractHwpxMetadataOnly(buffer) {
   let zip;
   try {
-    zip = await JSZip.loadAsync(buffer);
+    zip = await JSZip2.loadAsync(buffer);
   } catch {
     throw new KordocError("HWPX ZIP\uC744 \uC5F4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
   }
@@ -3105,7 +3027,7 @@ async function parseHwpxDocument(buffer, options) {
   precheckZipSize(buffer, MAX_DECOMPRESS_SIZE, MAX_ZIP_ENTRIES);
   let zip;
   try {
-    zip = await JSZip2.loadAsync(buffer);
+    zip = await JSZip3.loadAsync(buffer);
   } catch {
     return extractFromBrokenZip(buffer);
   }
@@ -3140,6 +3062,7 @@ async function parseHwpxDocument(buffer, options) {
   const shared = createSectionShared();
   shared.kordocLayout = await readKordocLayout(zip);
   shared.keepTrailingEmptyCols = options?.keepTrailingEmptyCols;
+  shared.keepEmptyParagraphs = options?.keepEmptyParagraphs;
   let parsedSections = 0;
   for (let si = 0; si < sectionPaths.length; si++) {
     if (pageFilter && !pageFilter.has(si + 1)) continue;
@@ -3240,28 +3163,11 @@ function shapeFormatToNumFmt(code) {
       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, table2) {
   return n >= 1 && n <= table2.length ? table2[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 num2 = n;
-  for (let i = 0; i < values.length; i++) {
-    while (num2 >= values[i]) {
-      result += symbols[i];
-      num2 -= values[i];
-    }
-  }
-  return result;
-}
 function formatLatin(n, upper) {
   if (n <= 0) return "";
   let result = "";
@@ -3297,19 +3203,19 @@ var HANJA_UNITS = ["", "\u5341", "\u767E", "\u5343", "\u842C"];
 function formatNumber(n, fmt) {
   switch (fmt) {
     case "circled":
-      return fromTable(n, CIRCLED_DIGITS);
+      return n >= 1 ? circledNumber(n - 1) : String(n);
     case "romanUpper":
-      return formatRoman(n, true);
+      return romanNumeral(n, true);
     case "romanLower":
-      return formatRoman(n, false);
+      return romanNumeral(n, false);
     case "latinUpper":
       return formatLatin(n, true) || String(n);
     case "latinLower":
       return formatLatin(n, false) || String(n);
     case "ganada":
-      return fromTable(n, GANADA);
+      return n >= 1 ? hangulOrdinal(n - 1) : String(n);
     case "circledGanada":
-      return fromTable(n, CIRCLED_GANADA);
+      return n >= 1 ? circledHangul(n - 1) : String(n);
     case "jamo":
       return fromTable(n, JAMO);
     case "circledJamo":
@@ -4047,220 +3953,75 @@ function decryptViewText(viewTextRaw, compressed) {
 }
 
 // src/hwp5/equation.ts
-var WORD_COMMANDS = /* @__PURE__ */ new Map([
-  ["alpha", "\\alpha"],
-  ["beta", "\\beta"],
-  ["gamma", "\\gamma"],
-  ["delta", "\\delta"],
-  ["epsilon", "\\epsilon"],
-  ["theta", "\\theta"],
-  ["lambda", "\\lambda"],
-  ["mu", "\\mu"],
-  ["pi", "\\pi"],
-  ["sigma", "\\sigma"],
-  ["tau", "\\tau"],
-  ["phi", "\\phi"],
-  ["omega", "\\omega"],
-  ["sin", "\\sin"],
-  ["cos", "\\cos"],
-  ["tan", "\\tan"],
-  ["sec", "\\sec"],
-  ["csc", "\\csc"],
-  ["cot", "\\cot"],
-  ["log", "\\log"],
-  ["ln", "\\ln"],
-  ["lim", "\\lim"],
-  ["inf", "\\infty"],
-  ["sum", "\\sum"],
-  ["smallsum", "\\sum"],
-  ["prod", "\\prod"],
-  ["int", "\\int"],
-  ["oint", "\\oint"],
-  ["rightarrow", "\\rightarrow"],
-  ["leftarrow", "\\leftarrow"],
-  ["partial", "\\partial"],
-  ["nabla", "\\nabla"],
-  ["angle", "\\angle"],
-  ["triangle", "\\triangle"],
-  ["vec", "\\vec"],
-  ["bar", "\\overline"],
-  ["dot", "\\dot"],
-  ["hat", "\\hat"],
-  ["left", "\\left"],
-  ["right", "\\right"]
-]);
-var SYMBOL_WORDS = /* @__PURE__ */ new Map([
-  ["times", "\\times"],
-  ["divide", "\\div"],
-  ["div", "\\div"],
-  ["le", "\\leq"],
-  ["ge", "\\geq"],
-  ["geq", "\\geq"],
-  ["deg", "^\\circ"],
-  ["rarrow", "\\rightarrow"],
-  ["larrow", "\\leftarrow"],
-  ["lrarrow", "\\leftrightarrow"],
-  ["in", "\\in"],
-  ["notin", "\\notin"],
-  ["emptyset", "\\emptyset"],
-  ["subset", "\\subset"],
-  ["nsubset", "\\nsubseteq"],
-  ["cup", "\\cup"],
-  ["cap", "\\cap"],
-  ["smallinter", "\\cap"],
-  ["sim", "\\sim"],
-  ["circ", "\\circ"],
-  ["bot", "\\perp"],
-  ["dyad", "\\overleftrightarrow"],
-  ["arch", "\\overset{\\frown}"]
-]);
-function hwpEquationToLatex(equation) {
-  return convertEquation(equation.replace(/\0/g, "").trim(), 0);
-}
-function convertEquation(equation, depth) {
-  if (!equation || depth > 12) return equation;
-  let result = equation.replace(/\s+/g, " ").replace(/`+/g, "\\,").replace(/~+/g, "\\,").trim();
-  result = convertMatrixLike(result);
-  result = convertRoots(result, depth);
-  result = convertOver(result, depth);
-  result = convertSqrt(result, depth);
-  result = convertScripts(result);
-  result = convertOperators(result);
-  result = removeFontDirectives(result);
-  result = convertWords(result);
-  result = cleanupLatexSpacing(result);
-  return result;
-}
-function convertMatrixLike(input) {
-  return input.replace(
-    /\bmatrix\s*\{([^{}]*)\}/gi,
-    (_match, body) => `\\begin{matrix} ${body.split("#").map((part) => part.trim()).join(" & ")} \\end{matrix}`
-  ).replace(
-    /\bcases\s*\{([^{}]*)\}/gi,
-    (_match, body) => `\\begin{cases} ${body.split("#").map((part) => part.trim()).join(" \\\\ ")} \\end{cases}`
-  );
-}
-function convertRoots(input, depth) {
-  return input.replace(/(?<!\\)\broot\s+({[^{}]*}|\S+)\s+of\s+({[^{}]*}|\S+)/gi, (_match, degree, radicand) => {
-    return `\\sqrt[${convertEquation(unwrapGroup(degree), depth + 1)}]{${convertEquation(unwrapGroup(radicand), depth + 1)}}`;
-  });
-}
-function convertSqrt(input, depth) {
-  return input.replace(/(?<!\\)\bsqrt\s*({[^{}]*}|\S+)/gi, (_match, radicand) => {
-    return `\\sqrt{${convertEquation(unwrapGroup(radicand), depth + 1)}}`;
-  });
-}
-function convertOver(input, depth) {
-  let result = input;
-  for (let guard = 0; guard < 50; guard++) {
-    const over = findTopLevelWord(result, "over");
-    if (over < 0) break;
-    const left = readLeftAtom(result, over);
-    const right = readRightAtom(result, over + "over".length);
-    if (!left || !right) break;
-    const numerator = convertEquation(unwrapGroup(left.atom), depth + 1);
-    const denominator = convertEquation(unwrapGroup(right.atom), depth + 1);
-    result = result.slice(0, left.start) + `\\frac{${numerator}}{${denominator}}` + result.slice(right.end);
-  }
-  return result;
-}
-function convertScripts(input) {
-  return input.replace(/\s*\^\s*/g, "^").replace(/\s*_\s*/g, "_").replace(/\^(?!\{)([^\s{}_^]+)/g, "^{$1}").replace(/_(?!\{)([^\s{}_^]+)/g, "_{$1}");
-}
-function convertOperators(input) {
-  return input.replace(/\+-/g, "\\pm").replace(/-\+/g, "\\mp").replace(/\/\//g, "\\parallel").replace(/△/g, "\\triangle ").replace(/□/g, "\\square ").replace(/‧/g, "\\cdot ").replace(/!=/g, "\\neq").replace(/<=/g, "\\leq").replace(/>=/g, "\\geq").replace(/==/g, "\\equiv");
-}
-function removeFontDirectives(input) {
-  return input.replace(/(?<!\\)\b(?:rm|it)\b\s*/gi, "");
-}
-function convertWords(input) {
+var WORD_ALIASES = {
+  // 삼각/로그 함수 — 정본 맵 부재
+  sin: "\\sin",
+  cos: "\\cos",
+  tan: "\\tan",
+  sec: "\\sec",
+  csc: "\\csc",
+  cot: "\\cot",
+  log: "\\log",
+  ln: "\\ln",
+  // 연산자·관계 기호 (정본은 대문자 키만 보유)
+  divide: "\\div",
+  div: "\\div",
+  le: "\\leq",
+  ge: "\\geq",
+  geq: "\\geq",
+  deg: "^\\circ",
+  rarrow: "\\rightarrow",
+  lrarrow: "\\leftrightarrow",
+  rightarrow: "\\rightarrow",
+  leftarrow: "\\leftarrow",
+  in: "\\in",
+  notin: "\\notin",
+  emptyset: "\\emptyset",
+  subset: "\\subset",
+  nsubset: "\\nsubseteq",
+  cup: "\\cup",
+  cap: "\\cap",
+  smallinter: "\\cap",
+  smallsum: "\\sum",
+  sim: "\\sim",
+  circ: "\\circ",
+  bot: "\\perp",
+  partial: "\\partial",
+  nabla: "\\nabla",
+  angle: "\\angle",
+  triangle: "\\triangle",
+  inf: "\\infty",
+  left: "\\left",
+  right: "\\right",
+  // 글꼴 지시자 — 제거
+  rm: "",
+  it: ""
+};
+var STRUCTURAL_FOLD = /* @__PURE__ */ new Set(["over", "root", "of"]);
+function normalizeWords(input) {
   return input.replace(/(?<![\\A-Za-z0-9])([A-Za-z][A-Za-z0-9]*)(?![A-Za-z0-9])/g, (word) => {
-    const exact = SYMBOL_WORDS.get(word);
-    if (exact) return exact;
+    if (word in CONVERT_MAP || word in MIDDLE_CONVERT_MAP) return word;
     const lower = word.toLowerCase();
-    return SYMBOL_WORDS.get(lower) ?? WORD_COMMANDS.get(lower) ?? word;
+    if (STRUCTURAL_FOLD.has(lower)) return lower;
+    if (lower in WORD_ALIASES) return WORD_ALIASES[lower];
+    if (lower !== word && (lower in CONVERT_MAP || lower in MIDDLE_CONVERT_MAP)) return lower;
+    return word;
   });
 }
-function cleanupLatexSpacing(input) {
-  return input.replace(/\\left\s*\{/g, "\\left\\{").replace(/\\right\s*\}/g, "\\right\\}").replace(/\\left\s*([\[\]\(\)\|])/g, "\\left$1").replace(/\\right\s*([\[\]\(\)\|])/g, "\\right$1").replace(/\s*\\,\s*/g, "\\,").replace(/\s+/g, " ").replace(/\{\s+/g, "{").replace(/\s+\}/g, "}").trim();
-}
-function findTopLevelWord(input, word) {
-  let curly = 0;
-  let paren = 0;
-  for (let i = 0; i <= input.length - word.length; i++) {
-    const ch = input[i];
-    if (ch === "{") curly++;
-    else if (ch === "}") curly = Math.max(0, curly - 1);
-    else if (ch === "(") paren++;
-    else if (ch === ")") paren = Math.max(0, paren - 1);
-    if (curly !== 0 || paren !== 0) continue;
-    if (input.slice(i, i + word.length).toLowerCase() !== word) continue;
-    if (isWordChar(input[i - 1]) || isWordChar(input[i + word.length])) continue;
-    return i;
-  }
-  return -1;
-}
-function readLeftAtom(input, end) {
-  let pos = end - 1;
-  while (pos >= 0 && /\s/.test(input[pos])) pos--;
-  if (pos < 0) return null;
-  if (input[pos] === "}") {
-    const start2 = findMatchingLeft(input, pos, "{", "}");
-    if (start2 >= 0) return { start: start2, atom: input.slice(start2, pos + 1) };
-  }
-  if (input[pos] === ")") {
-    const start2 = findMatchingLeft(input, pos, "(", ")");
-    if (start2 >= 0) return { start: start2, atom: input.slice(start2, pos + 1) };
-  }
-  let start = pos;
-  while (start >= 0 && !/\s/.test(input[start]) && !/[+\-=<>]/.test(input[start])) start--;
-  return { start: start + 1, atom: input.slice(start + 1, pos + 1) };
-}
-function readRightAtom(input, start) {
-  let pos = start;
-  while (pos < input.length && /\s/.test(input[pos])) pos++;
-  if (pos >= input.length) return null;
-  if (input[pos] === "{") {
-    const end2 = findMatchingRight(input, pos, "{", "}");
-    if (end2 >= 0) return { end: end2 + 1, atom: input.slice(pos, end2 + 1) };
-  }
-  if (input[pos] === "(") {
-    const end2 = findMatchingRight(input, pos, "(", ")");
-    if (end2 >= 0) return { end: end2 + 1, atom: input.slice(pos, end2 + 1) };
-  }
-  let end = pos;
-  while (end < input.length && !/\s/.test(input[end]) && !/[+\-=<>]/.test(input[end])) end++;
-  return { end, atom: input.slice(pos, end) };
-}
-function findMatchingLeft(input, closeIndex, open, close) {
-  let depth = 0;
-  for (let i = closeIndex; i >= 0; i--) {
-    if (input[i] === close) depth++;
-    else if (input[i] === open) {
-      depth--;
-      if (depth === 0) return i;
-    }
-  }
-  return -1;
-}
-function findMatchingRight(input, openIndex, open, close) {
-  let depth = 0;
-  for (let i = openIndex; i < input.length; i++) {
-    if (input[i] === open) depth++;
-    else if (input[i] === close) {
-      depth--;
-      if (depth === 0) return i;
-    }
-  }
-  return -1;
+function normalizeScripts(input) {
+  return input.replace(/\s*\^\s*/g, "^").replace(/\s*_\s*/g, "_").replace(/\^(?!\{)([^\s{}_^]+)/g, "^{$1}").replace(/_(?!\{)([^\s{}_^]+)/g, "_{$1}").replace(/([_^])/g, " $1 ");
 }
-function unwrapGroup(input) {
-  const trimmed = input.trim();
-  if (trimmed.startsWith("{") && trimmed.endsWith("}")) return trimmed.slice(1, -1);
-  return trimmed;
+function normalizeOperators(input) {
+  return input.replace(/\+-/g, " \\pm ").replace(/-\+/g, " \\mp ").replace(/\/\//g, " \\parallel ").replace(/!=/g, " \\neq ").replace(/<=/g, " \\leq ").replace(/>=/g, " \\geq ").replace(/==/g, " \\equiv ").replace(/△/g, " \\triangle ").replace(/□/g, " \\square ").replace(/‧/g, " \\cdot ");
 }
-function isWordChar(ch) {
-  return !!ch && /[A-Za-z0-9_]/.test(ch);
+function hwpEquationToLatex(equation) {
+  let s = equation.replace(/\0/g, "").replace(/\s+/g, " ").trim();
+  if (!s) return "";
+  s = normalizeScripts(s);
+  s = normalizeOperators(s);
+  s = normalizeWords(s);
+  s = s.replace(/\broot\s+(?!\{)(\S+)\s+of(?![A-Za-z0-9])/gi, "root { $1 } of");
+  return hmlToLatex(s).replace(/\s+/g, " ").trim();
 }
 
 // src/hwp5/parser.ts
@@ -17255,9 +17016,7 @@ function parseHwp3Document(buffer, _options) {
   const headReader = new Reader(Buffer.from(buffer));
   const header = readHeader(headReader);
   if (header.encrypted !== 0) {
-    const e = new Error("HWP3 \uBCF8\uBB38\uC774 \uC554\uD638\uB85C \uBCF4\uD638\uB418\uC5B4 \uC788\uC5B4 \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
-    e.code = "ENCRYPTED";
-    throw e;
+    throw new KordocError("\uC554\uD638\uD654\uB41C HWP3 \uBB38\uC11C \u2014 \uBCF8\uBB38\uC774 \uC554\uD638\uB85C \uBCF4\uD638\uB418\uC5B4 \uC788\uC5B4 \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
   }
   headReader.skip(header.infoBlockLength);
   const tail = headReader.readToEnd();
@@ -17268,10 +17027,10 @@ function parseHwp3Document(buffer, _options) {
       body = inflateRawSync3(tail, { maxOutputLength: MAX_DECOMPRESS_SIZE3 });
     } catch (err) {
       if (err?.code === "ERR_BUFFER_TOO_LARGE") {
-        throw new Error(`HWP3 \uC555\uCD95 \uD574\uC81C \uACB0\uACFC\uAC00 \uCD5C\uB300 \uD5C8\uC6A9 \uD06C\uAE30(${MAX_DECOMPRESS_SIZE3 / 1024 / 1024}MB)\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4`);
+        throw new KordocError(`HWP3 \uC555\uCD95 \uD574\uC81C \uACB0\uACFC\uAC00 \uCD5C\uB300 \uD5C8\uC6A9 \uD06C\uAE30(${MAX_DECOMPRESS_SIZE3 / 1024 / 1024}MB)\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4`);
       }
       const msg2 = err instanceof Error ? err.message : String(err);
-      throw new Error(`HWP3 \uC555\uCD95 \uD574\uC81C \uC2E4\uD328: ${msg2}`);
+      throw new KordocError(`HWP3 \uC555\uCD95 \uD574\uC81C \uC2E4\uD328: ${msg2}`);
     }
   } else {
     body = tail;
@@ -17472,7 +17231,7 @@ function isDistributionSentinel(markdown) {
 }
 
 // src/xlsx/parser.ts
-import JSZip3 from "jszip";
+import JSZip4 from "jszip";
 import { DOMParser } from "@xmldom/xmldom";
 var MAX_SHEETS = 100;
 var MAX_DECOMPRESS_SIZE4 = 100 * 1024 * 1024;
@@ -17757,7 +17516,7 @@ function sheetToBlocks(sheetName, grid, merges, maxRow, maxCol, sheetIndex, keep
 }
 async function parseXlsxDocument(buffer, options) {
   precheckZipSize(buffer, MAX_DECOMPRESS_SIZE4);
-  const zip = await JSZip3.loadAsync(buffer);
+  const zip = await JSZip4.loadAsync(buffer);
   const warnings = [];
   const workbookFile = zip.file("xl/workbook.xml");
   if (!workbookFile) {
@@ -17778,6 +17537,10 @@ async function parseXlsxDocument(buffer, options) {
     try {
       dateXfs = parseStyleDateXfs(await stylesFile.async("text"));
     } catch {
+      warnings.push({
+        code: "PARTIAL_PARSE",
+        message: "xl/styles.xml \uB0A0\uC9DC \uC11C\uC2DD \uD310\uC815 \uC2E4\uD328 \u2014 \uB0A0\uC9DC \uC140\uC774 \uC2DC\uB9AC\uC5BC \uC22B\uC790\uB85C \uCD9C\uB825\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4"
+      });
     }
   }
   let relsMap = /* @__PURE__ */ new Map();
@@ -18474,17 +18237,7 @@ async function parseXlsDocument(buffer, options) {
   const globals = processGlobals(records);
   const warnings = [];
   if (globals.encrypted) {
-    return {
-      markdown: "",
-      blocks: [],
-      metadata: { pageCount: globals.sheets.length },
-      warnings: [
-        {
-          message: "XLS \uD30C\uC77C\uC774 \uC554\uD638\uD654\uB418\uC5B4 \uC788\uC5B4 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4",
-          code: "PARTIAL_PARSE"
-        }
-      ]
-    };
+    throw new KordocError("XLS \uD30C\uC77C\uC774 \uC554\uD638\uD654\uB418\uC5B4 \uC788\uC5B4 \uD30C\uC2F1\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
   }
   const convertNum = globals.dateXfs.size > 0 ? (n, ixfe) => {
     const kind = globals.dateXfs.get(ixfe);
@@ -18543,41 +18296,13 @@ async function parseXlsDocument(buffer, options) {
 }
 
 // src/docx/parser.ts
-import JSZip4 from "jszip";
+import JSZip5 from "jszip";
 import { DOMParser as DOMParser2 } from "@xmldom/xmldom";
 
 // src/docx/equation.ts
-function lname(el) {
-  return el.localName || el.tagName?.replace(/^[^:]+:/, "") || "";
-}
-function kids(parent, name) {
-  const out = [];
-  const nodes = parent.childNodes;
-  if (!nodes) return out;
-  for (let i = 0; i < nodes.length; i++) {
-    const n = nodes[i];
-    if (n.nodeType !== 1) continue;
-    const el = n;
-    if (lname(el) === name) out.push(el);
-  }
-  return out;
-}
-function firstKid(parent, name) {
-  const list = kids(parent, name);
-  return list[0] ?? null;
-}
-function eachChild(parent) {
-  const out = [];
-  const nodes = parent.childNodes;
-  if (!nodes) return out;
-  for (let i = 0; i < nodes.length; i++) {
-    if (nodes[i].nodeType === 1) out.push(nodes[i]);
-  }
-  return out;
-}
 function runToLatex(r) {
   let out = "";
-  for (const t of kids(r, "t")) out += t.textContent ?? "";
+  for (const t of childrenByLocalName(r, "t")) out += t.textContent ?? "";
   return out;
 }
 var FUNC_NAMES = /* @__PURE__ */ new Set([
@@ -18698,13 +18423,13 @@ function grp(body) {
 }
 function childrenToLatex(parent) {
   let out = "";
-  for (const ch of eachChild(parent)) {
+  for (const ch of elementChildren(parent)) {
     out += nodeToLatex(ch);
   }
   return out;
 }
 function nodeToLatex(el) {
-  const tag = lname(el);
+  const tag = localName(el);
   switch (tag) {
     case "r":
       return runToLatex(el);
@@ -18720,33 +18445,33 @@ function nodeToLatex(el) {
       return childrenToLatex(el);
     // 분수
     case "f": {
-      const n = firstKid(el, "num");
-      const d = firstKid(el, "den");
+      const n = findChildByLocalName(el, "num");
+      const d = findChildByLocalName(el, "den");
       const num2 = n ? childrenToLatex(n) : "";
       const den = d ? childrenToLatex(d) : "";
       return "\\frac" + grp(num2) + grp(den);
     }
     // 첨자
     case "sSup": {
-      const e = firstKid(el, "e");
-      const sup = firstKid(el, "sup");
+      const e = findChildByLocalName(el, "e");
+      const sup = findChildByLocalName(el, "sup");
       return grp(e ? childrenToLatex(e) : "") + "^" + grp(sup ? childrenToLatex(sup) : "");
     }
     case "sSub": {
-      const e = firstKid(el, "e");
-      const sub = firstKid(el, "sub");
+      const e = findChildByLocalName(el, "e");
+      const sub = findChildByLocalName(el, "sub");
       return grp(e ? childrenToLatex(e) : "") + "_" + grp(sub ? childrenToLatex(sub) : "");
     }
     case "sSubSup": {
-      const e = firstKid(el, "e");
-      const sub = firstKid(el, "sub");
-      const sup = firstKid(el, "sup");
+      const e = findChildByLocalName(el, "e");
+      const sub = findChildByLocalName(el, "sub");
+      const sup = findChildByLocalName(el, "sup");
       return grp(e ? childrenToLatex(e) : "") + "_" + grp(sub ? childrenToLatex(sub) : "") + "^" + grp(sup ? childrenToLatex(sup) : "");
     }
     case "sPre": {
-      const sub = firstKid(el, "sub");
-      const sup = firstKid(el, "sup");
-      const e = firstKid(el, "e");
+      const sub = findChildByLocalName(el, "sub");
+      const sup = findChildByLocalName(el, "sup");
+      const e = findChildByLocalName(el, "e");
       const preSub = sub ? grp(childrenToLatex(sub)) : "{}";
       const preSup = sup ? grp(childrenToLatex(sup)) : "{}";
       const body = e ? childrenToLatex(e) : "";
@@ -18754,13 +18479,13 @@ function nodeToLatex(el) {
     }
     // 근호
     case "rad": {
-      const deg = firstKid(el, "deg");
-      const e = firstKid(el, "e");
+      const deg = findChildByLocalName(el, "deg");
+      const e = findChildByLocalName(el, "e");
       const body = e ? childrenToLatex(e) : "";
-      const radPr = firstKid(el, "radPr");
+      const radPr = findChildByLocalName(el, "radPr");
       let hide = false;
       if (radPr) {
-        const degHide = firstKid(radPr, "degHide");
+        const degHide = findChildByLocalName(radPr, "degHide");
         if (degHide) {
           const val = degHide.getAttribute("m:val") ?? degHide.getAttribute("val");
           hide = val === "1" || val === "on" || val === "true";
@@ -18771,13 +18496,13 @@ function nodeToLatex(el) {
     }
     // n-ary 연산자 (sum, prod, int, …)
     case "nary": {
-      const naryPr = firstKid(el, "naryPr");
+      const naryPr = findChildByLocalName(el, "naryPr");
       let op = "\\int";
       let subHide = false;
       let supHide = false;
       let limLoc = "";
       if (naryPr) {
-        const chr = firstKid(naryPr, "chr");
+        const chr = findChildByLocalName(naryPr, "chr");
         if (chr) {
           const v = chr.getAttribute("m:val") ?? chr.getAttribute("val") ?? "";
           if (v && NARY_MAP[v]) op = NARY_MAP[v];
@@ -18785,16 +18510,16 @@ function nodeToLatex(el) {
         } else {
           op = "\\int";
         }
-        const sh = firstKid(naryPr, "subHide");
-        const ph = firstKid(naryPr, "supHide");
+        const sh = findChildByLocalName(naryPr, "subHide");
+        const ph = findChildByLocalName(naryPr, "supHide");
         if (sh) subHide = onOffVal(sh.getAttribute("m:val") ?? sh.getAttribute("val"));
         if (ph) supHide = onOffVal(ph.getAttribute("m:val") ?? ph.getAttribute("val"));
-        const ll = firstKid(naryPr, "limLoc");
+        const ll = findChildByLocalName(naryPr, "limLoc");
         if (ll) limLoc = ll.getAttribute("m:val") ?? ll.getAttribute("val") ?? "";
       }
-      const sub = firstKid(el, "sub");
-      const sup = firstKid(el, "sup");
-      const e = firstKid(el, "e");
+      const sub = findChildByLocalName(el, "sub");
+      const sup = findChildByLocalName(el, "sup");
+      const e = findChildByLocalName(el, "e");
       const subStr = !subHide && sub ? childrenToLatex(sub) : "";
       const supStr = !supHide && sup ? childrenToLatex(sup) : "";
       const body = e ? childrenToLatex(e) : "";
@@ -18810,27 +18535,27 @@ function nodeToLatex(el) {
     }
     // 괄호 (delimiter)
     case "d": {
-      const dPr = firstKid(el, "dPr");
+      const dPr = findChildByLocalName(el, "dPr");
       let beg = "(";
       let end = ")";
       let sep = ",";
       if (dPr) {
-        const begChr = firstKid(dPr, "begChr");
-        const endChr = firstKid(dPr, "endChr");
-        const sepChr = firstKid(dPr, "sepChr");
+        const begChr = findChildByLocalName(dPr, "begChr");
+        const endChr = findChildByLocalName(dPr, "endChr");
+        const sepChr = findChildByLocalName(dPr, "sepChr");
         if (begChr) beg = begChr.getAttribute("m:val") ?? begChr.getAttribute("val") ?? beg;
         if (endChr) end = endChr.getAttribute("m:val") ?? endChr.getAttribute("val") ?? end;
         if (sepChr) sep = sepChr.getAttribute("m:val") ?? sepChr.getAttribute("val") ?? sep;
       }
-      const items = kids(el, "e").map(childrenToLatex);
+      const items = childrenByLocalName(el, "e").map(childrenToLatex);
       const body = items.join(sep);
       return "\\left" + mapDelim(beg, true) + body + "\\right" + mapDelim(end, false);
     }
     // 행렬
     case "m": {
       const rows = [];
-      for (const mr of kids(el, "mr")) {
-        const cells = kids(mr, "e").map(childrenToLatex);
+      for (const mr of childrenByLocalName(el, "mr")) {
+        const cells = childrenByLocalName(mr, "e").map(childrenToLatex);
         rows.push(cells.join(" & "));
       }
       return "\\begin{matrix}" + rows.join(" \\\\ ") + "\\end{matrix}";
@@ -18840,8 +18565,8 @@ function nodeToLatex(el) {
       return childrenToLatex(el);
     // 함수 적용 (sin, cos, log …)
     case "func": {
-      const fn = firstKid(el, "fName");
-      const e = firstKid(el, "e");
+      const fn = findChildByLocalName(el, "fName");
+      const e = findChildByLocalName(el, "e");
       const fnStr = fn ? childrenToLatex(fn).trim() : "";
       const body = e ? childrenToLatex(e) : "";
       const fnLatex = FUNC_NAMES.has(fnStr) ? "\\" + fnStr : fnStr;
@@ -18849,42 +18574,42 @@ function nodeToLatex(el) {
     }
     // 악센트 (hat/bar/vec/…)
     case "acc": {
-      const accPr = firstKid(el, "accPr");
+      const accPr = findChildByLocalName(el, "accPr");
       let chr = "";
       if (accPr) {
-        const chrEl = firstKid(accPr, "chr");
+        const chrEl = findChildByLocalName(accPr, "chr");
         if (chrEl) chr = chrEl.getAttribute("m:val") ?? chrEl.getAttribute("val") ?? "";
       }
       if (!chr) chr = "\u0302";
-      const e = firstKid(el, "e");
+      const e = findChildByLocalName(el, "e");
       const body = e ? childrenToLatex(e) : "";
       const cmd = ACCENT_MAP[chr] ?? "\\hat";
       return cmd + grp(body);
     }
     // bar (위/아래 줄)
     case "bar": {
-      const barPr = firstKid(el, "barPr");
+      const barPr = findChildByLocalName(el, "barPr");
       let pos = "top";
       if (barPr) {
-        const posEl = firstKid(barPr, "pos");
+        const posEl = findChildByLocalName(barPr, "pos");
         if (posEl) pos = posEl.getAttribute("m:val") ?? posEl.getAttribute("val") ?? pos;
       }
-      const e = firstKid(el, "e");
+      const e = findChildByLocalName(el, "e");
       const body = e ? childrenToLatex(e) : "";
       return (pos === "bot" ? "\\underline" : "\\overline") + grp(body);
     }
     // lim 위/아래
     case "limLow": {
-      const e = firstKid(el, "e");
-      const lim = firstKid(el, "lim");
+      const e = findChildByLocalName(el, "e");
+      const lim = findChildByLocalName(el, "lim");
       const base = e ? childrenToLatex(e).trim() : "";
       const below = lim ? childrenToLatex(lim) : "";
       if (FUNC_NAMES.has(base)) return "\\" + base + "_" + grp(below);
       return base + "_" + grp(below);
     }
     case "limUpp": {
-      const e = firstKid(el, "e");
-      const lim = firstKid(el, "lim");
+      const e = findChildByLocalName(el, "e");
+      const lim = findChildByLocalName(el, "lim");
       const base = e ? childrenToLatex(e).trim() : "";
       const above = lim ? childrenToLatex(lim) : "";
       if (FUNC_NAMES.has(base)) return "\\" + base + "^" + grp(above);
@@ -18892,7 +18617,7 @@ function nodeToLatex(el) {
     }
     // group character (over/underset 비슷)
     case "groupChr":
-      return childrenToLatex(firstKid(el, "e") ?? el);
+      return childrenToLatex(findChildByLocalName(el, "e") ?? el);
     // box/borderBox/phantom/eqArr/… 는 자식 본문만 유지
     case "borderBox":
     case "phant":
@@ -18922,7 +18647,7 @@ function nodeToLatex(el) {
   }
 }
 function isOmmlRoot(el) {
-  const t = lname(el);
+  const t = localName(el);
   return t === "oMath" || t === "oMathPara";
 }
 function ommlElementToLatex(el) {
@@ -18931,7 +18656,7 @@ function ommlElementToLatex(el) {
   return raw.replace(/\s+/g, " ").trim();
 }
 function isDisplayMath(el) {
-  return lname(el) === "oMathPara";
+  return localName(el) === "oMathPara";
 }
 
 // src/docx/parser.ts
@@ -19446,7 +19171,7 @@ function emitParagraphImages(p, imageMap, linked, out) {
 }
 async function parseDocxDocument(buffer, options) {
   precheckZipSize(buffer, MAX_DECOMPRESS_SIZE5);
-  const zip = await JSZip4.loadAsync(buffer);
+  const zip = await JSZip5.loadAsync(buffer);
   const warnings = [];
   const docFile = zip.file("word/document.xml");
   if (!docFile) {
@@ -19561,13 +19286,12 @@ async function parseDocxDocument(buffer, options) {
 
 // src/hwpml/parser.ts
 import { DOMParser as DOMParser3 } from "@xmldom/xmldom";
-var MAX_XML_DEPTH2 = 200;
 var MAX_TABLE_ROWS = 5e3;
 var MAX_TABLE_COLS = 500;
 var MAX_HWPML_BYTES = 50 * 1024 * 1024;
 function parseHwpmlDocument(buffer, options) {
   if (buffer.byteLength > MAX_HWPML_BYTES) {
-    throw new Error(`HWPML \uD30C\uC77C \uD06C\uAE30 \uCD08\uACFC (${(buffer.byteLength / 1024 / 1024).toFixed(1)}MB > 50MB)`);
+    throw new KordocError(`HWPML \uD30C\uC77C \uD06C\uAE30 \uCD08\uACFC (${(buffer.byteLength / 1024 / 1024).toFixed(1)}MB > 50MB)`);
   }
   const text = new TextDecoder("utf-8").decode(buffer).replace(/^\uFEFF/, "");
   const normalized = text.replace(/&nbsp;/g, "&#160;");
@@ -19584,17 +19308,17 @@ function parseHwpmlDocument(buffer, options) {
   }
   const root = doc.documentElement;
   const metadata = {};
-  const docSummary = findChild(root, "DOCSUMMARY");
+  const docSummary = findChildByLocalName(root, "DOCSUMMARY");
   if (docSummary) {
-    const title = findChild(docSummary, "TITLE");
-    const author = findChild(docSummary, "AUTHOR");
-    const date = findChild(docSummary, "DATE");
-    if (title) metadata.title = textContent(title).trim();
-    if (author) metadata.author = textContent(author).trim();
-    if (date) metadata.createdAt = textContent(date).trim() || void 0;
+    const title = findChildByLocalName(docSummary, "TITLE");
+    const author = findChildByLocalName(docSummary, "AUTHOR");
+    const date = findChildByLocalName(docSummary, "DATE");
+    if (title) metadata.title = rawTextContent(title).trim();
+    if (author) metadata.author = rawTextContent(author).trim();
+    if (date) metadata.createdAt = rawTextContent(date).trim() || void 0;
   }
   const paraShapeMap = buildParaShapeMap(root);
-  const body = findChild(root, "BODY");
+  const body = findChildByLocalName(root, "BODY");
   if (!body) {
     return { markdown: "", blocks: [], metadata, warnings };
   }
@@ -19622,11 +19346,11 @@ function parseHwpmlDocument(buffer, options) {
 }
 function buildParaShapeMap(root) {
   const map = /* @__PURE__ */ new Map();
-  const head = findChild(root, "HEAD");
+  const head = findChildByLocalName(root, "HEAD");
   if (!head) return map;
-  const mappingTable = findChild(head, "MAPPINGTABLE");
+  const mappingTable = findChildByLocalName(head, "MAPPINGTABLE");
   if (!mappingTable) return map;
-  const paraShapeList = findChild(mappingTable, "PARASHAPELIST");
+  const paraShapeList = findChildByLocalName(mappingTable, "PARASHAPELIST");
   if (!paraShapeList) return map;
   const children = paraShapeList.childNodes;
   for (let i = 0; i < children.length; i++) {
@@ -19648,7 +19372,7 @@ function parseSection2(section, blocks, paraShapeMap, sectionNum, warnings, keep
   walkContent(section, blocks, paraShapeMap, sectionNum, warnings, false, keep);
 }
 function walkContent(node, blocks, paraShapeMap, sectionNum, warnings, inHeaderFooter, keep, depth = 0) {
-  if (depth > MAX_XML_DEPTH2) return;
+  if (depth > MAX_XML_DEPTH) return;
   const children = node.childNodes;
   for (let i = 0; i < children.length; i++) {
     const el = children[i];
@@ -19678,7 +19402,7 @@ function walkContent(node, blocks, paraShapeMap, sectionNum, warnings, inHeaderF
   }
 }
 function walkTablesInP(node, blocks, paraShapeMap, sectionNum, warnings, keep, depth = 0) {
-  if (depth > MAX_XML_DEPTH2) return;
+  if (depth > MAX_XML_DEPTH) return;
   const children = node.childNodes;
   for (let i = 0; i < children.length; i++) {
     const el = children[i];
@@ -19709,14 +19433,14 @@ function extractParagraphText(p) {
   return parts.join("").trim();
 }
 function collectCharText(node, parts, depth = 0) {
-  if (depth > MAX_XML_DEPTH2) return;
+  if (depth > MAX_XML_DEPTH) return;
   const children = node.childNodes;
   for (let i = 0; i < children.length; i++) {
     const el = children[i];
     if (el.nodeType !== 1) continue;
     const tag = localName(el);
     if (tag === "CHAR") {
-      const t = textContent(el);
+      const t = rawTextContent(el);
       if (t) parts.push(t);
     } else if (tag === "TABLE" || tag === "PICTURE" || tag === "SHAPEOBJECT") {
     } else if (tag === "AUTONUM") {
@@ -19725,14 +19449,28 @@ function collectCharText(node, parts, depth = 0) {
     }
   }
 }
-function parseTable2(el, blocks, paraShapeMap, sectionNum, warnings, keep) {
+function parseTable2(el, blocks, _paraShapeMap, sectionNum, warnings, keep) {
+  const table2 = buildHmlTable(el, warnings, keep, 0);
+  if (!table2) return;
+  const caption = extractShapeCaption(el);
+  if (caption.text && caption.before) {
+    blocks.push({ type: "paragraph", text: caption.text, pageNumber: sectionNum });
+  }
+  blocks.push({ type: "table", table: table2, pageNumber: sectionNum });
+  if (caption.text && !caption.before) {
+    blocks.push({ type: "paragraph", text: caption.text, pageNumber: sectionNum });
+  }
+}
+var MAX_TABLE_NEST = 8;
+function buildHmlTable(el, warnings, keep, tableDepth) {
   const cells = [];
+  const structured = [];
   const rowCount = parseInt(el.getAttribute("RowCount") ?? "0", 10);
   const colCount = parseInt(el.getAttribute("ColCount") ?? "0", 10);
-  if (isNaN(rowCount) || isNaN(colCount) || rowCount === 0 || colCount === 0) return;
+  if (isNaN(rowCount) || isNaN(colCount) || rowCount === 0 || colCount === 0) return null;
   if (rowCount > MAX_TABLE_ROWS || colCount > MAX_TABLE_COLS) {
     warnings.push({ message: `\uD14C\uC774\uBE14 \uD06C\uAE30 \uCD08\uACFC (${rowCount}x${colCount}) \u2014 \uC2A4\uD0B5`, code: "TRUNCATED_TABLE" });
-    return;
+    return null;
   }
   const children = el.childNodes;
   for (let i = 0; i < children.length; i++) {
@@ -19747,28 +19485,106 @@ function parseTable2(el, blocks, paraShapeMap, sectionNum, warnings, keep) {
       const colSpan = Math.min(Math.max(1, parseInt(cellEl.getAttribute("ColSpan") ?? "1", 10) || 1), MAX_TABLE_COLS);
       const rowSpan = Math.min(Math.max(1, parseInt(cellEl.getAttribute("RowSpan") ?? "1", 10) || 1), MAX_TABLE_ROWS);
       const cellText = extractCellText(cellEl);
-      cells.push({ text: cellText, colSpan, rowSpan, colAddr, rowAddr });
+      const ctx = { text: cellText, colSpan, rowSpan, colAddr, rowAddr };
+      cells.push(ctx);
+      if (tableDepth < MAX_TABLE_NEST && cellHasNestedTable(cellEl, 0)) {
+        const cellBlocks = [];
+        collectCellBlocks(cellEl, cellBlocks, warnings, keep, 0, tableDepth);
+        if (cellBlocks.some((b) => b.type === "table")) structured.push({ ctx, cellBlocks });
+      }
     }
   }
-  if (cells.length === 0) return;
+  if (cells.length === 0) return null;
   const cellRows = Array.from({ length: rowCount }, () => []);
   for (const cell2 of cells) {
     const r = Math.min(Math.max(cell2.rowAddr ?? 0, 0), rowCount - 1);
     cellRows[r].push(cell2);
   }
   const table2 = buildTable(cellRows, { keepAnchoredEmptyCols: keep });
-  const caption = extractShapeCaption(el);
-  if (caption.text && caption.before) {
-    blocks.push({ type: "paragraph", text: caption.text, pageNumber: sectionNum });
+  if (structured.length > 0) {
+    const claimed = /* @__PURE__ */ new Set();
+    for (const { ctx, cellBlocks } of structured) {
+      let target = table2.cells[ctx.rowAddr ?? -1]?.[ctx.colAddr ?? -1];
+      if (!target || claimed.has(target) || target.text !== ctx.text) {
+        target = void 0;
+        outer: for (const irRow of table2.cells) {
+          for (const cand of irRow) {
+            if (!claimed.has(cand) && cand.text === ctx.text && cand.colSpan === ctx.colSpan && cand.rowSpan === ctx.rowSpan) {
+              target = cand;
+              break outer;
+            }
+          }
+        }
+      }
+      if (!target) continue;
+      claimed.add(target);
+      target.blocks = cellBlocks;
+    }
   }
-  blocks.push({ type: "table", table: table2, pageNumber: sectionNum });
-  if (caption.text && !caption.before) {
-    blocks.push({ type: "paragraph", text: caption.text, pageNumber: sectionNum });
+  return table2;
+}
+function cellHasNestedTable(node, depth) {
+  if (depth > 20) return false;
+  const children = node.childNodes;
+  for (let i = 0; i < children.length; i++) {
+    const el = children[i];
+    if (el.nodeType !== 1) continue;
+    const tag = localName(el);
+    if (tag === "TABLE") return true;
+    if (tag === "FOOTNOTE" || tag === "ENDNOTE" || tag === "HEADER" || tag === "FOOTER") continue;
+    if (cellHasNestedTable(el, depth + 1)) return true;
+  }
+  return false;
+}
+function collectCellBlocks(node, out, warnings, keep, depth, tableDepth) {
+  if (depth > 20) return;
+  const children = node.childNodes;
+  for (let i = 0; i < children.length; i++) {
+    const el = children[i];
+    if (el.nodeType !== 1) continue;
+    const tag = localName(el);
+    if (tag === "P") {
+      const t = extractParagraphText(el);
+      if (t) out.push({ type: "paragraph", text: t });
+      collectNestedTableBlocks(el, out, warnings, keep, depth + 1, tableDepth);
+    } else if (tag === "TABLE") {
+      pushNestedTableBlock(el, out, warnings, keep, tableDepth);
+    } else {
+      collectCellBlocks(el, out, warnings, keep, depth + 1, tableDepth);
+    }
+  }
+}
+function collectNestedTableBlocks(node, out, warnings, keep, depth, tableDepth) {
+  if (depth > 20) return;
+  const children = node.childNodes;
+  for (let i = 0; i < children.length; i++) {
+    const el = children[i];
+    if (el.nodeType !== 1) continue;
+    const tag = localName(el);
+    if (tag === "TABLE") {
+      pushNestedTableBlock(el, out, warnings, keep, tableDepth);
+      continue;
+    }
+    if (tag === "FOOTNOTE" || tag === "ENDNOTE" || tag === "HEADER" || tag === "FOOTER") continue;
+    collectNestedTableBlocks(el, out, warnings, keep, depth + 1, tableDepth);
+  }
+}
+function pushNestedTableBlock(el, out, warnings, keep, tableDepth) {
+  const nested = buildHmlTable(el, warnings, keep, tableDepth + 1);
+  if (nested) {
+    const cap = extractShapeCaption(el);
+    if (cap.text) nested.caption = cap.text;
+    out.push({ type: "table", table: nested });
+    return;
   }
+  const parts = [];
+  collectCellText2(el, parts, 0);
+  const flat = parts.filter(Boolean).join("\n").trim();
+  if (flat) out.push({ type: "paragraph", text: flat });
 }
 function extractShapeCaption(tableEl) {
-  const shape = findChild(tableEl, "SHAPEOBJECT");
-  const caption = shape && findChild(shape, "CAPTION");
+  const shape = findChildByLocalName(tableEl, "SHAPEOBJECT");
+  const caption = shape && findChildByLocalName(shape, "CAPTION");
   if (!caption) return { text: "", before: false };
   const parts = [];
   collectCellText2(caption, parts, 0);
@@ -19813,30 +19629,6 @@ function collectNestedTableText(node, parts, depth) {
     collectNestedTableText(el, parts, depth + 1);
   }
 }
-function localName(el) {
-  return (el.tagName || el.localName || "").replace(/^[^:]+:/, "");
-}
-function findChild(parent, tag) {
-  const children = parent.childNodes;
-  for (let i = 0; i < children.length; i++) {
-    const el = children[i];
-    if (el.nodeType === 1 && localName(el) === tag) return el;
-  }
-  return null;
-}
-function textContent(el) {
-  const children = el.childNodes;
-  const parts = [];
-  for (let i = 0; i < children.length; i++) {
-    const node = children[i];
-    if (node.nodeType === 3) {
-      parts.push(node.nodeValue || "");
-    } else if (node.nodeType === 1) {
-      parts.push(textContent(node));
-    }
-  }
-  return parts.join("");
-}
 function countSections(body) {
   let count = 0;
   const children = body.childNodes;
@@ -20586,10 +20378,136 @@ function fillInlineFields(text, values, filled, matchedLabels, blockedLabels) {
 }
 
 // src/form/filler-hwpx.ts
-import JSZip5 from "jszip";
+import JSZip7 from "jszip";
+
+// src/form/click-here.ts
+import JSZip6 from "jszip";
+var FIELD_BEGIN_RE = /<([A-Za-z0-9_]+:)?fieldBegin\b([^>]*?)(\/?)>/g;
+function attrOf(attrs, name) {
+  const m = attrs.match(new RegExp(`(?:^|\\s)${name}="([^"]*)"`));
+  return m ? m[1] : void 0;
+}
+function extractPlaceholder(fieldBeginXml) {
+  const m = fieldBeginXml.match(/Direction:wstring:(\d+):/);
+  if (!m) return void 0;
+  const start = (m.index ?? 0) + m[0].length;
+  const n = parseInt(m[1], 10);
+  if (!Number.isFinite(n) || n < 0 || n > 1e3) return void 0;
+  return decodeXmlEntities(fieldBeginXml.slice(start, start + n));
+}
+function regionText(inner) {
+  return decodeXmlEntities(
+    inner.replace(/<(?:[A-Za-z0-9_]+:)?(?:lineBreak|br)\b[^>]*\/?>/g, "\n").replace(/<(?:[A-Za-z0-9_]+:)?tab\b[^>]*\/?>/g, "	").replace(/<[^>]+>/g, "")
+  );
+}
+function scanClickHereRegions(xml) {
+  const regions = [];
+  FIELD_BEGIN_RE.lastIndex = 0;
+  let m;
+  let lastEnd = -1;
+  while ((m = FIELD_BEGIN_RE.exec(xml)) !== null) {
+    const prefix = m[1] ?? "";
+    const attrs = m[2];
+    const selfClosed = m[3] === "/";
+    if ((attrOf(attrs, "type") ?? "").toUpperCase() !== "CLICK_HERE") continue;
+    const name = attrOf(attrs, "name");
+    if (name === void 0) continue;
+    const id = attrOf(attrs, "id");
+    let beginElemEnd;
+    if (selfClosed) {
+      beginElemEnd = FIELD_BEGIN_RE.lastIndex;
+    } else {
+      const closeTag = `</${prefix}fieldBegin>`;
+      const ci = xml.indexOf(closeTag, FIELD_BEGIN_RE.lastIndex);
+      if (ci < 0) continue;
+      beginElemEnd = ci + closeTag.length;
+    }
+    const fieldBeginXml = xml.slice(m.index, beginElemEnd);
+    const ctrlClose = `</${prefix}ctrl>`;
+    let start = beginElemEnd;
+    let wrapped = false;
+    if (xml.startsWith(ctrlClose, beginElemEnd)) {
+      start = beginElemEnd + ctrlClose.length;
+      wrapped = true;
+    }
+    const feRe = new RegExp(`<${prefix}fieldEnd\\b[^>]*>`, "g");
+    feRe.lastIndex = start;
+    let end = -1;
+    let fe;
+    while ((fe = feRe.exec(xml)) !== null) {
+      const ref = attrOf(fe[0], "beginIDRef");
+      if (id !== void 0 && ref !== void 0 && ref !== id) continue;
+      end = fe.index;
+      break;
+    }
+    if (end < 0) continue;
+    const ctrlOpen = `<${prefix}ctrl>`;
+    if (wrapped && xml.slice(end - ctrlOpen.length, end) === ctrlOpen) {
+      end -= ctrlOpen.length;
+    }
+    if (start > end) continue;
+    if (start < lastEnd) continue;
+    lastEnd = end;
+    regions.push({
+      name: decodeXmlEntities(name),
+      placeholder: extractPlaceholder(fieldBeginXml),
+      start,
+      end,
+      prefix
+    });
+  }
+  return regions;
+}
+function valueXml(value, prefix) {
+  if (value === "") return "";
+  const lines = value.split("\n").map(escapeXmlText);
+  return `<${prefix}t>${lines.join(`<${prefix}lineBreak/>`)}</${prefix}t>`;
+}
+function fillClickHereInXml(xml, cursor, blockedLabels) {
+  const filled = [];
+  const matchedKeys = /* @__PURE__ */ new Set();
+  const splices = [];
+  for (const region of scanClickHereRegions(xml)) {
+    const key = normalizeLabel(region.name);
+    if (!key || blockedLabels?.has(key)) continue;
+    if (!cursor.has(key)) continue;
+    const value = cursor.consume(key);
+    if (value === void 0) continue;
+    const replacement = valueXml(value, region.prefix);
+    const current = xml.slice(region.start, region.end);
+    matchedKeys.add(key);
+    filled.push({ label: region.name, value, row: -1, col: -1, key });
+    if (current === replacement) continue;
+    splices.push({ start: region.start, end: region.end, replacement });
+  }
+  return {
+    xml: splices.length > 0 ? applySplices(xml, splices) : null,
+    filled,
+    matchedKeys
+  };
+}
+async function extractClickHereFields(hwpxBuffer) {
+  const zip = await JSZip6.loadAsync(hwpxBuffer);
+  const sectionPaths = Object.keys(zip.files).filter((name) => /[Ss]ection\d+\.xml$/i.test(name)).sort();
+  const fields = [];
+  for (let si = 0; si < sectionPaths.length; si++) {
+    const xml = await zip.file(sectionPaths[si]).async("text");
+    for (const r of scanClickHereRegions(xml)) {
+      fields.push({
+        name: r.name,
+        ...r.placeholder !== void 0 ? { placeholder: r.placeholder } : {},
+        value: regionText(xml.slice(r.start, r.end)),
+        section: si
+      });
+    }
+  }
+  return fields;
+}
+
+// src/form/filler-hwpx.ts
 async function fillHwpx(hwpxBuffer, values, blockedLabels) {
   const u8 = new Uint8Array(hwpxBuffer);
-  const zip = await JSZip5.loadAsync(hwpxBuffer);
+  const zip = await JSZip7.loadAsync(hwpxBuffer);
   const sectionPaths = Object.keys(zip.files).filter((name) => /[Ss]ection\d+\.xml$/i.test(name)).sort();
   if (sectionPaths.length === 0) {
     throw new KordocError("HWPX\uC5D0\uC11C \uC139\uC158 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
@@ -20603,8 +20521,23 @@ async function fillHwpx(hwpxBuffer, values, blockedLabels) {
   const succeededKeys = /* @__PURE__ */ new Set();
   const replacements = /* @__PURE__ */ new Map();
   const encoder = new TextEncoder();
+  const sectionXmls = /* @__PURE__ */ new Map();
+  const fieldModified = /* @__PURE__ */ new Set();
+  const fieldMatchedKeys = /* @__PURE__ */ new Set();
+  for (const p of sectionPaths) {
+    const xml = await zip.file(p).async("text");
+    const outcome = fillClickHereInXml(xml, cursor, blockedLabels);
+    sectionXmls.set(p, outcome.xml ?? xml);
+    if (outcome.xml !== null) fieldModified.add(p);
+    for (const f of outcome.filled) filled.push(f);
+    for (const k of outcome.matchedKeys) fieldMatchedKeys.add(k);
+  }
+  for (const k of fieldMatchedKeys) {
+    matchedLabels.add(k);
+    normalizedValues.delete(k);
+  }
   for (let si = 0; si < sectionPaths.length; si++) {
-    const xml = await zip.file(sectionPaths[si]).async("text");
+    const xml = sectionXmls.get(sectionPaths[si]);
     const scan = scanSectionXml(xml, si);
     const ledger = /* @__PURE__ */ new Map();
     const led = (p) => {
@@ -20786,94 +20719,460 @@ async function fillHwpx(hwpxBuffer, values, blockedLabels) {
         }
       }
     }
-    for (const para2 of [...scan.bodyParagraphs, ...scan.excludedParagraphs]) {
-      const existing = ledger.get(para2);
-      if (existing?.fullText !== void 0) continue;
-      const text = matchText(para2);
-      const segments = scanInlineSegments(text);
-      const matches = segments.map((seg) => matchInlineSegment(seg, cursor, blockedLabels));
-      for (let i = 0; i < segments.length; i++) {
-        const seg = segments[i];
-        const matched = matches[i];
-        if (matched === void 0) continue;
-        const matchKey = matched.key;
-        const newValue = cursor.consume(matchKey);
-        if (newValue === void 0) continue;
-        const ve = clampSegmentEnd(text, seg, segments[i + 1], matches[i + 1]?.viaExt ?? false);
-        const replacement = seg.valueStart === ve ? padInsertion(text, seg.valueStart, newValue) : newValue;
-        const l = led(para2);
-        l.ranges.push({ start: seg.valueStart, end: ve, replacement });
-        matchedLabels.add(matchKey);
-        l.filledIdx.push(filled.length);
-        l.matchKeys.push(matchKey);
-        filled.push({ label: matched.label.trim(), value: newValue, row: -1, col: -1, key: matchKey });
-      }
+    for (const para2 of [...scan.bodyParagraphs, ...scan.excludedParagraphs]) {
+      const existing = ledger.get(para2);
+      if (existing?.fullText !== void 0) continue;
+      const text = matchText(para2);
+      const segments = scanInlineSegments(text);
+      const matches = segments.map((seg) => matchInlineSegment(seg, cursor, blockedLabels));
+      for (let i = 0; i < segments.length; i++) {
+        const seg = segments[i];
+        const matched = matches[i];
+        if (matched === void 0) continue;
+        const matchKey = matched.key;
+        const newValue = cursor.consume(matchKey);
+        if (newValue === void 0) continue;
+        const ve = clampSegmentEnd(text, seg, segments[i + 1], matches[i + 1]?.viaExt ?? false);
+        const replacement = seg.valueStart === ve ? padInsertion(text, seg.valueStart, newValue) : newValue;
+        const l = led(para2);
+        l.ranges.push({ start: seg.valueStart, end: ve, replacement });
+        matchedLabels.add(matchKey);
+        l.filledIdx.push(filled.length);
+        l.matchKeys.push(matchKey);
+        filled.push({ label: matched.label.trim(), value: newValue, row: -1, col: -1, key: matchKey });
+      }
+    }
+    const splices = [];
+    for (const [para2, l] of ledger) {
+      let paraSplices = null;
+      if (l.fullText !== void 0) {
+        paraSplices = buildParagraphSplices(para2, l.fullText, xml);
+      } else if (l.ranges.length > 0) {
+        const sorted = [...l.ranges].sort((a, b) => a.start - b.start || a.end - b.end);
+        const merged = [];
+        for (const r of sorted) {
+          const prev = merged[merged.length - 1];
+          if (prev && r.start < prev.end) continue;
+          merged.push(r);
+        }
+        if (paraTText(para2, xml) !== null) {
+          const precise = [];
+          let ok = true;
+          for (const r of merged) {
+            const sp = buildRangeSplices(para2, xml, r.start, r.end, r.replacement);
+            if (!sp) {
+              ok = false;
+              break;
+            }
+            precise.push(...sp);
+          }
+          paraSplices = ok ? precise : null;
+        } else if (paraTextPureT(para2, xml)) {
+          let text = para2.text;
+          for (let k = merged.length - 1; k >= 0; k--) {
+            const r = merged[k];
+            text = text.slice(0, r.start) + r.replacement + text.slice(r.end);
+          }
+          paraSplices = buildParagraphSplices(para2, text, xml);
+        } else {
+          paraSplices = null;
+        }
+      }
+      if (paraSplices === null) {
+        for (const idx of l.filledIdx) filled[idx] = null;
+        for (const k of l.matchKeys) failedKeys.add(k);
+        continue;
+      }
+      for (const k of l.matchKeys) succeededKeys.add(k);
+      splices.push(...paraSplices);
+    }
+    if (splices.length > 0 || fieldModified.has(sectionPaths[si])) {
+      splices.push(...allLinesegRemovalSplices(xml));
+      replacements.set(sectionPaths[si], encoder.encode(applySplices(xml, splices)));
+    }
+  }
+  for (const k of failedKeys) {
+    if (!succeededKeys.has(k) || cursor.isArray(k)) matchedLabels.delete(k);
+  }
+  const cleanFilled = filled.filter((f) => f !== null);
+  const unmatched = resolveUnmatched(normalizedValues, matchedLabels, values);
+  const out = replacements.size > 0 ? patchZipEntries(u8, replacements) : new Uint8Array(u8);
+  return {
+    buffer: out.buffer.slice(out.byteOffset, out.byteOffset + out.byteLength),
+    filled: cleanFilled,
+    unmatched,
+    ...warnings.length > 0 ? { warnings } : {}
+  };
+}
+
+// src/hwpx/generator.ts
+import JSZip8 from "jszip";
+
+// src/hwpx/geometry.ts
+var A4_W_HU = 59528;
+var A4_H_HU = 84188;
+var HU_PER_MM = 7200 / 25.4;
+function mmToHwpunit(mm) {
+  return Math.round(mm * 7200 / 25.4);
+}
+var BODY_WIDTH_20MM = mmToHwpunit(170);
+var COVER_MEASURED_W = 48180;
+var DATA_TABLE_ID_BASE = 1e3;
+var CHART_TABLE_ID_BASE = 91e5;
+var GJ_TABLE_ID_BASE = 92e5;
+var EXTRA_TABLE_ID_BASE = 93e5;
+var PIC_ID_BASE = 94e5;
+
+// src/hwpx/gaejosik.ts
+var GAEJOSIK_BULLETS = ["\u25A1", "\u25CB", "-", "\u318D"];
+function gaejosikMarker(depth, bullet2 = "\u25CB") {
+  if (depth === 1) return bullet2;
+  return GAEJOSIK_BULLETS[Math.min(depth, GAEJOSIK_BULLETS.length - 1)];
+}
+function gaejosikSizes(bodyHeight, ov = {}) {
+  const s = bodyHeight / 1500;
+  const r = (v, pt) => pt ? Math.round(pt * 100) : Math.round(v * s);
+  return {
+    /** □ 대항목 — HY헤드라인M 16pt */
+    dae: r(1600, ov.dae),
+    /** ※ 참고 — 한양중고딕 13pt */
+    cham: r(1300, ov.cham),
+    /** 장 헤더(로마숫자·제목) 17pt */
+    chapter: r(1700, ov.chapter),
+    /** 표지 제목 30pt */
+    coverTitle: r(3e3, ov.coverTitle),
+    /** 표지 날짜·기관명 25pt */
+    coverSub: r(2500, ov.coverSub),
+    /** 목차 라벨 "목  차" 28pt */
+    tocLabel: r(2800, ov.tocLabel),
+    /** 목차 로마숫자 21pt(한양신명조) */
+    tocRoman: r(2100, ov.tocRoman),
+    /** 목차 항목 18pt */
+    tocItem: r(1800, ov.tocItem),
+    /** 표 셀 — 맑은 고딕 12pt (실측: 정부 양식 표) */
+    table: r(1200, ov.table),
+    /** 표지 장식 바 셀 빈 문단 — 6pt (실측: 바 높이 818 안에 줄높이 수납) */
+    bar: r(600),
+    /** 본문 첫 페이지 제목 박스 — HY헤드라인M 22pt (실측: GT3 표④) */
+    bodyTitle: r(2200, ov.bodyTitle)
+  };
+}
+function gaejosikSpaceBefore(depth, bodyHeight) {
+  const s = bodyHeight / 1500;
+  const ui = [3e3, 2e3, 1200, 600][Math.min(depth, 3)];
+  return Math.round(ui * s);
+}
+function gaejosikLevelIndent(depth, bodyHeight, sizes = {}, bullet2 = "\u25CB") {
+  const lefts = [0, 1, 1.5, 2];
+  const left = depth <= 3 ? Math.round(lefts[depth] * bodyHeight) : Math.round((2 + (depth - 3) * 0.5) * bodyHeight);
+  const h = depth === 0 ? gaejosikSizes(bodyHeight, sizes).dae : bodyHeight;
+  return { left, indent: -markerWidth(gaejosikMarker(depth, bullet2), h) };
+}
+function gaejosikChamIndent(bodyHeight, sizes = {}) {
+  const cham = gaejosikSizes(bodyHeight, sizes).cham;
+  return { left: Math.round(2.5 * cham), indent: -markerWidth("\u203B", cham) };
+}
+function gaejosikTocItemIndent(bodyHeight, sizes = {}) {
+  const sz = gaejosikSizes(bodyHeight, sizes);
+  const hang = markerWidth("\u2167.", sz.tocRoman);
+  return { left: 2e3 + hang, indent: -hang };
+}
+function formatGaejosikDate(d) {
+  return `${d.getFullYear()}. ${d.getMonth() + 1}. ${d.getDate()}.`;
+}
+function stripChapterNumber(title) {
+  return title.replace(/^\s*[□○ㅇㆍ-]\s+/u, "").replace(/^\s*(?:\d+(?:\.\d+)*|[Ⅰ-Ⅻ]+)\s*[.)]\s*/u, "").trim();
+}
+var GAEJOSIK_COLORS = {
+  /** 장헤더 로마숫자 셀·표지 진한 바 음영 */
+  primary: "#193AAA",
+  /** 장헤더 셀 테두리 */
+  border: "#006699",
+  /** 표지 연한 바 */
+  accent: "#A0B4E6",
+  /** 장헤더 제목 셀 음영 */
+  titleFill: "#F2F2F2",
+  /** 장헤더 제목 셀 상하선 */
+  titleLine: "#A6A6A6",
+  /** 목차 박스 테두리 */
+  tocBorder: "#514BAC",
+  /** 목차 배너 라벤더 스트라이프 (실측: GT3 표②) */
+  tocStripe: "#E0E5FA"
+};
+var GAEJOSIK_BASE_WIDTH = BODY_WIDTH_20MM;
+var CHAPTER_GEOM = { numW: 3327, gapW: 848, titleW: 43513, rowH: 2832 };
+var COVER_GEOM = {
+  totalW: COVER_MEASURED_W,
+  topDarkW: 38219,
+  topLightW: 9961,
+  barH: 818,
+  titleH: 11060,
+  botDarkW: 10466,
+  botLightW: 37714,
+  botBarH: 812
+};
+var TOC_GEOM = { boxW: 46492, boxH: 57840 };
+function chapterGeom(bodyHeight, ov = {}, bodyWidth = GAEJOSIK_BASE_WIDTH) {
+  const s = gaejosikSizes(bodyHeight, ov).chapter / 1700;
+  const ws = bodyWidth / GAEJOSIK_BASE_WIDTH;
+  const numW = Math.round(CHAPTER_GEOM.numW * ws);
+  const gapW = Math.round(CHAPTER_GEOM.gapW * ws);
+  const titleW = Math.round((CHAPTER_GEOM.numW + CHAPTER_GEOM.gapW + CHAPTER_GEOM.titleW) * ws) - numW - gapW;
+  return { numW, gapW, titleW, rowH: Math.round(CHAPTER_GEOM.rowH * s) };
+}
+function coverGeom(bodyHeight, ov = {}, bodyWidth = GAEJOSIK_BASE_WIDTH) {
+  const s = gaejosikSizes(bodyHeight, ov).coverTitle / 3e3;
+  const w = (v) => Math.round(v * bodyWidth / GAEJOSIK_BASE_WIDTH);
+  const totalW = w(COVER_GEOM.totalW);
+  return {
+    ...COVER_GEOM,
+    totalW,
+    topDarkW: w(COVER_GEOM.topDarkW),
+    topLightW: totalW - w(COVER_GEOM.topDarkW),
+    botDarkW: w(COVER_GEOM.botDarkW),
+    botLightW: totalW - w(COVER_GEOM.botDarkW),
+    titleH: Math.round(COVER_GEOM.titleH * s)
+  };
+}
+var TOC_BANNER_GEOM = {
+  colWs: [565, 565, 1414, 13191, 1414, 565, 565],
+  h: 3931
+};
+function tocBannerGeom(bodyHeight, ov = {}) {
+  const s = gaejosikSizes(bodyHeight, ov).tocLabel / 2800;
+  return { colWs: TOC_BANNER_GEOM.colWs, h: Math.round(TOC_BANNER_GEOM.h * s) };
+}
+var BODY_TITLE_GEOM = { barH: 600, titleH: 3566 };
+function bodyTitleGeom(bodyHeight, ov = {}) {
+  const s = gaejosikSizes(bodyHeight, ov).bodyTitle / 2200;
+  return { barH: BODY_TITLE_GEOM.barH, titleH: Math.round(BODY_TITLE_GEOM.titleH * s) };
+}
+
+// src/hwpx/gongmun.ts
+var OFFICIAL_MARGINS = { top: 20, bottom: 15, left: 20, right: 15 };
+var GAEJOSIK_MARGINS = { top: 15, bottom: 15, left: 20, right: 20 };
+var GAEJOSIK_HEADER_FOOTER = 4251;
+var PRESET_DEFAULTS = {
+  // 서울시 실결재 104건 중 12pt 64건(13pt 30, 15pt 5) — 지배값을 기본으로 사용.
+  official: { bodyPt: 12, lineSpacing: 160, numbering: "standard" },
+  report: { bodyPt: 15, lineSpacing: 160, numbering: "report" },
+  // 실측 추진계획안: □ → ㅇ → * 계층.
+  plan: { bodyPt: 15, lineSpacing: 160, numbering: "report" },
+  notice: { bodyPt: 15, lineSpacing: 160, numbering: "standard" },
+  minutes: { bodyPt: 14, lineSpacing: 130, numbering: "standard" },
+  gaejosik: { bodyPt: 15, lineSpacing: 160, numbering: "gaejosik" },
+  // 보도자료 — 실측(국토부 실물): 본문 바탕 14pt 160%, □→ㅇ→*(각주) 부호
+  press: { bodyPt: 14, lineSpacing: 160, numbering: "report" }
+};
+var PRESET_ALIAS = {
+  official: "official",
+  \uAE30\uC548\uBB38: "official",
+  \uC2DC\uD589\uBB38: "official",
+  \uACF5\uBB38: "official",
+  \uACF5\uBB38\uC11C: "official",
+  report: "report",
+  \uBCF4\uACE0\uC11C: "report",
+  plan: "plan",
+  \uACC4\uD68D\uC11C: "plan",
+  \uACC4\uD68D: "plan",
+  notice: "notice",
+  \uD1B5\uC9C0: "notice",
+  \uC54C\uB9BC: "notice",
+  \uC548\uB0B4: "notice",
+  minutes: "minutes",
+  \uD68C\uC758\uB85D: "minutes",
+  gaejosik: "gaejosik",
+  \uAC1C\uC870\uC2DD: "gaejosik",
+  \uAC1C\uC870\uC2DD\uBCF4\uACE0\uC11C: "gaejosik",
+  \uC815\uBD80\uBCF4\uACE0\uC11C: "gaejosik",
+  \uC815\uBD80\uD45C\uC900\uAC1C\uC870\uC2DD\uBCF4\uACE0\uC11C: "gaejosik",
+  press: "press",
+  \uBCF4\uB3C4\uC790\uB8CC: "press"
+};
+function normalizeGongmunPreset(preset) {
+  if (!preset) return "official";
+  return PRESET_ALIAS[preset.trim()] ?? "official";
+}
+function usesReportFonts(preset) {
+  return preset === "gaejosik" || preset === "report" || preset === "plan";
+}
+function usesAsteriskThird(preset) {
+  return preset === "plan" || preset === "press";
+}
+function needsGaejosikAssets(gongmun) {
+  return usesReportFonts(gongmun.preset) || gongmun.cover !== null || gongmun.toc;
+}
+function assertFiniteRange(name, value, min, max) {
+  if (!Number.isFinite(value) || value < min || value > max) {
+    throw new KordocError(`${name} must be a finite number between ${min} and ${max}`);
+  }
+}
+function validateGongmunOptions(opts) {
+  if (opts.bodyPt !== void 0) assertFiniteRange("bodyPt", opts.bodyPt, 6, 40);
+  if (opts.lineSpacing !== void 0) assertFiniteRange("lineSpacing", opts.lineSpacing, 50, 300);
+  if (typeof opts.autoFit === "object" && opts.autoFit.minRatio !== void 0) {
+    assertFiniteRange("autoFit.minRatio", opts.autoFit.minRatio, 50, 99);
+  }
+  if (opts.margins) {
+    for (const side of ["top", "bottom", "left", "right"]) {
+      const value = opts.margins[side];
+      assertFiniteRange(`margins.${side}`, value, 0, 200);
+    }
+    if (opts.margins.left + opts.margins.right >= 210) {
+      throw new KordocError("margins.left + margins.right must be less than 210");
     }
-    const splices = [];
-    for (const [para2, l] of ledger) {
-      let paraSplices = null;
-      if (l.fullText !== void 0) {
-        paraSplices = buildParagraphSplices(para2, l.fullText, xml);
-      } else if (l.ranges.length > 0) {
-        const sorted = [...l.ranges].sort((a, b) => a.start - b.start || a.end - b.end);
-        const merged = [];
-        for (const r of sorted) {
-          const prev = merged[merged.length - 1];
-          if (prev && r.start < prev.end) continue;
-          merged.push(r);
-        }
-        if (paraTText(para2, xml) !== null) {
-          const precise = [];
-          let ok = true;
-          for (const r of merged) {
-            const sp = buildRangeSplices(para2, xml, r.start, r.end, r.replacement);
-            if (!sp) {
-              ok = false;
-              break;
-            }
-            precise.push(...sp);
-          }
-          paraSplices = ok ? precise : null;
-        } else if (paraTextPureT(para2, xml)) {
-          let text = para2.text;
-          for (let k = merged.length - 1; k >= 0; k--) {
-            const r = merged[k];
-            text = text.slice(0, r.start) + r.replacement + text.slice(r.end);
-          }
-          paraSplices = buildParagraphSplices(para2, text, xml);
-        } else {
-          paraSplices = null;
-        }
-      }
-      if (paraSplices === null) {
-        for (const idx of l.filledIdx) filled[idx] = null;
-        for (const k of l.matchKeys) failedKeys.add(k);
-        continue;
-      }
-      for (const k of l.matchKeys) succeededKeys.add(k);
-      splices.push(...paraSplices);
+    if (opts.margins.top + opts.margins.bottom >= 297) {
+      throw new KordocError("margins.top + margins.bottom must be less than 297");
     }
-    if (splices.length > 0) {
-      splices.push(...allLinesegRemovalSplices(xml));
-      replacements.set(sectionPaths[si], encoder.encode(applySplices(xml, splices)));
+  }
+  if (opts.sizes) {
+    for (const [key, value] of Object.entries(opts.sizes)) {
+      if (value !== void 0) assertFiniteRange(`sizes.${key}`, value, 6, 60);
     }
   }
-  for (const k of failedKeys) {
-    if (!succeededKeys.has(k) || cursor.isArray(k)) matchedLabels.delete(k);
+  if (opts.approval && opts.approval.length > 6) {
+    throw new KordocError("approval must contain at most 6 labels");
   }
-  const cleanFilled = filled.filter((f) => f !== null);
-  const unmatched = resolveUnmatched(normalizedValues, matchedLabels, values);
-  const out = replacements.size > 0 ? patchZipEntries(u8, replacements) : new Uint8Array(u8);
+}
+function incompatibleGongmunWarnings(opts) {
+  const warns = [];
+  const preset = normalizeGongmunPreset(opts.preset);
+  if (opts.docHead && preset !== "official") warns.push(`doc_head(\uB450\uBB38)\uB294 \uAE30\uC548\uBB38(official) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
+  if (opts.docFoot && preset !== "official") warns.push(`doc_foot(\uACB0\uBB38)\uB294 \uAE30\uC548\uBB38(official) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
+  if (opts.noticeHead && preset !== "notice") warns.push(`notice_head(\uACF5\uACE0\uBC88\uD638\xB7\uBC1C\uC2E0\uBA85\uC758)\uB294 \uD1B5\uC9C0(notice) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
+  if (opts.press && preset !== "press") warns.push(`press(\uBA38\uB9AC\uBC15\uC2A4\xB7\uBD80\uC81C\xB7\uB2F4\uB2F9)\uB294 \uBCF4\uB3C4\uC790\uB8CC(press) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
+  if (preset === "press" && (opts.cover === true || typeof opts.cover === "object" || opts.toc === true)) {
+    warns.push("\uBCF4\uB3C4\uC790\uB8CC\uB294 \uBA38\uB9AC\uBC15\uC2A4 \uC11C\uC2DD\uACFC \uC591\uB9BD \uBD88\uAC00\uB77C \uD45C\uC9C0\xB7\uBAA9\uCC28\uAC00 \uBB34\uC2DC\uB428");
+  }
+  if (opts.sizes && Object.keys(opts.sizes).length > 0 && !usesReportFonts(preset)) {
+    warns.push(`sizes(\uAC1C\uC870\uC2DD \uC694\uC18C \uD06C\uAE30)\uB294 \uAC1C\uC870\uC2DD\xB7\uBCF4\uACE0\uC11C\xB7\uACC4\uD68D\uC11C \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B\uC5D0\uC11C \uBB34\uC2DC\uB428`);
+  }
+  if (opts.suppressSingle && (opts.numbering ?? PRESET_DEFAULTS[preset].numbering) !== "standard") {
+    warns.push(`suppress_single(\uB2E8\uC77C \uD615\uC81C \uBD80\uD638 \uC0DD\uB7B5)\uC740 \uBC95\uC815 \uBC88\uD638(standard) \uC804\uC6A9 \u2014 '${preset}' \uD504\uB9AC\uC14B(\uBD88\uB9BF \uCCB4\uACC4)\uC5D0\uC11C \uBB34\uB3D9\uC791`);
+  }
+  return warns;
+}
+function resolveGongmun(opts) {
+  validateGongmunOptions(opts);
+  const preset = normalizeGongmunPreset(opts.preset);
+  const d = PRESET_DEFAULTS[preset];
+  const bodyPt = opts.bodyPt ?? d.bodyPt;
+  const autoFitMinRatio = opts.autoFit === false ? null : typeof opts.autoFit === "object" ? Math.min(Math.max(opts.autoFit.minRatio ?? 90, 50), 99) : 90;
+  const coverOn = opts.cover !== void 0 ? opts.cover !== false : preset === "gaejosik";
+  const coverOpts = typeof opts.cover === "object" ? opts.cover : {};
+  const gaejosik = preset === "gaejosik";
+  const reportFamily = gaejosik || preset === "report" || preset === "plan" || preset === "notice" || preset === "press";
   return {
-    buffer: out.buffer.slice(out.byteOffset, out.byteOffset + out.byteLength),
-    filled: cleanFilled,
-    unmatched,
-    ...warnings.length > 0 ? { warnings } : {}
+    preset,
+    bodyFont: opts.bodyFont ?? "myeongjo",
+    bodyHeight: Math.round(bodyPt * 100),
+    lineSpacing: opts.lineSpacing ?? d.lineSpacing,
+    numbering: opts.numbering ?? d.numbering,
+    margins: opts.margins ?? (reportFamily ? GAEJOSIK_MARGINS : OFFICIAL_MARGINS),
+    centerTitle: opts.centerTitle ?? true,
+    autoFitMinRatio,
+    // 보도자료는 머리박스가 1페이지 최상단을 차지하는 서식이라 표지·목차와 양립 불가 —
+    // 켜면 머리박스가 표지에 얹히고 25pt 제목·부제가 유실된다 (docHead 프리셋 게이팅과 동일 관례)
+    cover: coverOn && preset !== "press" ? { date: coverOpts.date ?? null, org: coverOpts.org ?? "" } : null,
+    toc: preset !== "press" && (opts.toc ?? gaejosik),
+    fonts: opts.fonts ?? {},
+    sizes: opts.sizes ?? {},
+    // 쪽번호 — 보고서 계열 관행(실측: 2_보고서 양식·추진계획·공고문 전부 하단 중앙)
+    pageNumbers: opts.pageNumbers ?? (gaejosik || preset === "report" || preset === "plan"),
+    // 머리말·꼬리말 — 실측: 보고서 계열 15mm(GT3·t2·춘천·브라더), 공고·보도 10mm,
+    // 기안문 0(실결재 41/60건 h0/f0)
+    headerFooter: usesReportFonts(preset) ? GAEJOSIK_HEADER_FOOTER : preset === "notice" || preset === "press" ? 2835 : 0,
+    // "끝." — 기안문 규정(본문 끝 2타+"끝."). 그 외는 opt-in
+    endMark: opts.endMark ?? preset === "official",
+    approval: opts.approval && opts.approval.length > 0 ? opts.approval : null,
+    // 본문 제목박스 — 실측(GT3·GT12): 목차 뒤 본문 시작에 제목 반복. 표지 켜진 개조식 기본
+    bodyTitleBox: opts.bodyTitleBox ?? (gaejosik && coverOn),
+    // h2 말머리 — 실측: 보고서 양식 □ 대항목(QA-2), 공고문 아라비아("1. 사업개요", 바이오헬스 실측)
+    h2Marker: opts.h2Marker ?? (preset === "report" || preset === "plan" ? "box" : preset === "notice" ? "number" : "none"),
+    // 2단계 부호 — 실결재 기안문·공고문 ㅇ 지배(60건 중 ㅇ134:○5), 보고서 양식 계열 ○
+    bullet2: opts.bullet2 ?? (preset === "plan" || preset === "notice" || preset === "press" ? "\u3147" : "\u25CB"),
+    // 단일 형제 부호 생략 — 규정이지만 부호 없는 계단이 실무 눈에 어색 (실무자 QA)
+    suppressSingle: opts.suppressSingle ?? false,
+    docHead: preset === "official" && opts.docHead ? opts.docHead : null,
+    docFoot: preset === "official" && opts.docFoot ? opts.docFoot : null,
+    reportInfo: opts.reportInfo?.trim() || null,
+    noticeHead: preset === "notice" && opts.noticeHead ? opts.noticeHead : null,
+    // 보도자료 머리박스는 프리셋 자체가 요구 — 옵션 미지정이어도 빈 객체
+    press: preset === "press" ? opts.press ?? {} : null
   };
 }
-
-// src/hwpx/generator.ts
-import JSZip6 from "jszip";
+var REPORT_BULLETS = ["\u25A1", "\u25CB", "-", "\u318D"];
+var ASTERISK_BULLETS = ["\u25A1", "\u25CB", "*", "\u318D"];
+function standardMarker(depth, n) {
+  switch (depth) {
+    case 0:
+      return `${n + 1}.`;
+    case 1:
+      return `${hangulOrdinal(n)}.`;
+    case 2:
+      return `${n + 1})`;
+    case 3:
+      return `${hangulOrdinal(n)})`;
+    case 4:
+      return `(${n + 1})`;
+    case 5:
+      return `(${hangulOrdinal(n)})`;
+    case 6:
+      return circledNumber(n);
+    case 7:
+      return circledHangul(n);
+    default:
+      return circledHangul(n);
+  }
+}
+function reportMarker(depth, bullet2 = "\u25CB", asteriskThird = false) {
+  const bullets = asteriskThird ? ASTERISK_BULLETS : REPORT_BULLETS;
+  const m = bullets[Math.min(depth, bullets.length - 1)];
+  return depth === 1 ? bullet2 : m;
+}
+function markerWidth(marker, bodyHeight) {
+  let em = SPACE_EM_FIXED;
+  for (const c of marker) em += charWidthEm1000(c.codePointAt(0));
+  return Math.round(em / 1e3 * bodyHeight);
+}
+function levelIndent(depth, bodyHeight, numbering, sizes = {}, bullet2 = "\u25CB", asteriskThird = false) {
+  if (numbering === "gaejosik") return gaejosikLevelIndent(depth, bodyHeight, sizes, bullet2);
+  const marker = numbering === "report" ? reportMarker(depth, bullet2, asteriskThird) : standardMarker(depth, 0);
+  return { left: Math.round(depth * bodyHeight), indent: -markerWidth(marker, bodyHeight) };
+}
+function computeSuppression(depths) {
+  const counts = /* @__PURE__ */ new Map();
+  const keys = [];
+  const path = [];
+  for (const depth of depths) {
+    path.length = depth + 1;
+    path[depth] = (path[depth] ?? 0) + 1;
+    const parentKey = path.slice(0, depth).join(".") + "|" + depth;
+    keys.push(parentKey);
+    counts.set(parentKey, (counts.get(parentKey) ?? 0) + 1);
+  }
+  return keys.map((k) => (counts.get(k) ?? 0) <= 1);
+}
+var GongmunNumberer = class {
+  constructor(numbering, bullet2 = "\u25CB", asteriskThird = false) {
+    this.numbering = numbering;
+    this.bullet2 = bullet2;
+    this.asteriskThird = asteriskThird;
+  }
+  counts = [];
+  /** depth 항목 하나에 대한 마커. suppress=true면 빈 문자열(부호 없음) */
+  next(depth, suppress) {
+    this.counts.length = depth + 1;
+    const n = this.counts[depth] ?? 0;
+    this.counts[depth] = n + 1;
+    if (suppress) return "";
+    if (this.numbering === "gaejosik") return gaejosikMarker(depth, this.bullet2);
+    return this.numbering === "report" ? reportMarker(depth, this.bullet2, this.asteriskThird) : standardMarker(depth, n);
+  }
+  reset() {
+    this.counts = [];
+  }
+};
 
 // src/hwpx/gen-ids.ts
 var NS_SECTION = "http://www.hancom.co.kr/hwpml/2011/section";
@@ -24240,7 +24539,7 @@ async function markdownToHwpx(markdown, options) {
     }
   }
   const extraBorderFills = [...remap?.borderFillXmls ?? [], ...bfReg?.emit() ?? []];
-  const zip = new JSZip6();
+  const zip = new JSZip8();
   zip.file("mimetype", "application/hwp+zip", { compression: "STORE" });
   zip.file("META-INF/container.xml", generateContainerXml());
   zip.file("Contents/content.hpf", generateManifest(chartParts, images.manifestItems(), gongmun ? "gongmun" : "default"));
@@ -24402,8 +24701,55 @@ function diffTableCells(a, b) {
   return result;
 }
 
+// src/form/templates.ts
+import { existsSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+var BUILTIN_TEMPLATES = [
+  {
+    id: "gian",
+    aliases: ["\uC77C\uBC18\uAE30\uC548\uBB38", "\uAE30\uC548\uBB38", "\uC77C\uBC18\uAE30\uC548\uBB38_\uC11C\uC2DD"],
+    file: "\uC77C\uBC18\uAE30\uC548\uBB38_\uC11C\uC2DD.hwpx",
+    sampleFile: "\uC77C\uBC18\uAE30\uC548\uBB38_\uC608\uC2DC\uAC12.json",
+    title: "\uC77C\uBC18\uAE30\uC548\uBB38 \u2014 \uBCC4\uC9C0 \uC81C1\uD638\uC11C\uC2DD (\uB300\uC678 \uC2DC\uD589\uBB38\xB7\uD611\uC870\uBB38, \uB204\uB984\uD2C0 23\uACF3)"
+  },
+  {
+    id: "gian-simple",
+    aliases: ["\uAC04\uC774\uAE30\uC548\uBB38", "\uAC04\uC774\uAE30\uC548\uBB38_\uC11C\uC2DD"],
+    file: "\uAC04\uC774\uAE30\uC548\uBB38_\uC11C\uC2DD.hwpx",
+    sampleFile: "\uAC04\uC774\uAE30\uC548\uBB38_\uC608\uC2DC\uAC12.json",
+    title: "\uAC04\uC774\uAE30\uC548\uBB38 \u2014 \uBCC4\uC9C0 \uC81C2\uD638\uC11C\uC2DD (\uB0B4\uBD80\uACB0\uC7AC \uBCF4\uACE0\uC11C\xB7\uACC4\uD68D\uC11C, \uACB0\uC7AC\uB780 \uD45C, \uB204\uB984\uD2C0 13\uACF3)"
+  }
+];
+function resolveBuiltinTemplate(name) {
+  const n = name.trim().replace(/^templates?:/i, "").trim();
+  if (!n) return void 0;
+  const low = n.toLowerCase();
+  return BUILTIN_TEMPLATES.find((t) => t.id === low || t.aliases.includes(n));
+}
+function builtinTemplateDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    join(here, "..", "..", "templates"),
+    // src/form/templates.ts → 패키지 루트
+    join(here, "..", "templates")
+    // dist/*.js (tsup 번들) → 패키지 루트
+  ];
+  for (const c of candidates) {
+    if (existsSync(join(c, BUILTIN_TEMPLATES[0].file))) return c;
+  }
+  throw new KordocError("\uB0B4\uC7A5 templates \uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 (\uD328\uD0A4\uC9C0 \uC124\uCE58\uAC00 \uC190\uC0C1\uB418\uC5C8\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4)");
+}
+function readBuiltinTemplate(t) {
+  const buf = readFileSync(join(builtinTemplateDir(), t.file));
+  return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+}
+function readBuiltinTemplateSample(t) {
+  return JSON.parse(readFileSync(join(builtinTemplateDir(), t.sampleFile), "utf-8"));
+}
+
 // src/hwpx/extract-profile.ts
-import JSZip7 from "jszip";
+import JSZip9 from "jszip";
 function elemsByLocal(root, name) {
   const all = root.getElementsByTagName("*");
   const out = [];
@@ -24606,7 +24952,7 @@ function pick(map, keys) {
 }
 async function hwpxToProfile(input) {
   const buf = input instanceof ArrayBuffer ? input : toArrayBuffer(input);
-  const zip = await JSZip7.loadAsync(buf);
+  const zip = await JSZip9.loadAsync(buf);
   const parser = createXmlParser();
   const headerFile = zip.file("Contents/header.xml") ?? zip.file(/[Hh]eader\.xml$/)?.[0];
   let headerXml = "<root/>";
@@ -24921,7 +25267,7 @@ function gongmunLintWarnings(text, limit = 10) {
 }
 
 // src/roundtrip/patcher.ts
-import JSZip8 from "jszip";
+import JSZip10 from "jszip";
 
 // src/roundtrip/table-rows.ts
 var ROW_OBJECT_RE = /<(?:[A-Za-z0-9_]+:)?(?:tbl|pic|equation|ole|container|shape|drawingObject|drawText|video|chart|fieldBegin|fieldEnd|ctrl)\b/;
@@ -25568,7 +25914,7 @@ async function patchHwpx(original, editedMarkdown, options) {
   }
   let zip;
   try {
-    zip = await JSZip8.loadAsync(original);
+    zip = await JSZip10.loadAsync(original);
   } catch {
     return { success: false, applied: 0, skipped, error: "ZIP \uB85C\uB4DC \uC2E4\uD328" };
   }
@@ -25928,6 +26274,8 @@ function replaceOleStream(file, path, newData) {
 }
 var Surgeon = class {
   buf;
+  /** 논리 파일 길이 — buf는 성장 시 기하급수 capacity로 재할당되므로 buf.length와 다를 수 있음 */
+  len;
   fat = [];
   /** FAT 배열을 구성하는 섹터 번호들 (DIFAT 순서) */
   fatSectors = [];
@@ -25947,6 +26295,7 @@ var Surgeon = class {
     }
     const padded = Math.ceil((file.length - SECTOR) / SECTOR) * SECTOR + SECTOR;
     this.buf = Buffer.alloc(padded);
+    this.len = padded;
     file.copy(this.buf);
     this.loadFat();
     this.loadMiniFat();
@@ -26001,7 +26350,7 @@ var Surgeon = class {
   // ── 헬퍼 ──
   sectorOffset(n) {
     const off = SECTOR + n * SECTOR;
-    if (n >= 4294967290 || off + SECTOR > this.buf.length) throw new OleSurgeonError(`\uC139\uD130 \uBC94\uC704 \uCD08\uACFC: ${n}`);
+    if (n >= 4294967290 || off + SECTOR > this.len) throw new OleSurgeonError(`\uC139\uD130 \uBC94\uC704 \uCD08\uACFC: ${n}`);
     return off;
   }
   chain(start) {
@@ -26059,26 +26408,40 @@ var Surgeon = class {
     const out = [];
     for (let i = 0; i < this.fat.length && out.length < n; i++) {
       if (this.fat[i] !== FREESECT) continue;
-      if (SECTOR + (i + 1) * SECTOR > this.buf.length) continue;
+      if (SECTOR + (i + 1) * SECTOR > this.len) continue;
       this.fat[i] = ENDOFCHAIN;
       const off = this.sectorOffset(i);
       this.buf.fill(0, off, off + SECTOR);
       out.push(i);
     }
     while (out.length < n) {
-      this.ensureFatCapacity((this.buf.length - SECTOR) / SECTOR + 2);
-      const idx = (this.buf.length - SECTOR) / SECTOR;
-      this.buf = Buffer.concat([this.buf, Buffer.alloc(SECTOR)]);
+      this.ensureFatCapacity((this.len - SECTOR) / SECTOR + 2);
+      const idx = this.appendSector();
       this.fat[idx] = ENDOFCHAIN;
       out.push(idx);
     }
     return out;
   }
+  /**
+   * 파일 끝에 빈 섹터 1개 추가 — 새 섹터 번호 반환.
+   * 섹터마다 Buffer.concat(전체 복사)하면 대형 스트림 삽입이 O(n²)이라,
+   * capacity를 기하급수(×2)로 재할당하고 논리 길이(len)만 늘린다 (amortized O(n)).
+   * Buffer.alloc은 0으로 채워지고 len 너머엔 아무도 쓰지 않으므로 새 섹터는 항상 0.
+   */
+  appendSector() {
+    const idx = (this.len - SECTOR) / SECTOR;
+    if (this.len + SECTOR > this.buf.length) {
+      const grown = Buffer.alloc(Math.max(this.buf.length * 2, this.len + SECTOR));
+      this.buf.copy(grown, 0, 0, this.len);
+      this.buf = grown;
+    }
+    this.len += SECTOR;
+    return idx;
+  }
   /** FAT 배열이 sectorCount개 엔트리를 담도록 확장 (FAT 섹터 추가 + DIFAT 갱신) */
   ensureFatCapacity(sectorCount) {
     while (this.fat.length < sectorCount) {
-      const idx = (this.buf.length - SECTOR) / SECTOR;
-      this.buf = Buffer.concat([this.buf, Buffer.alloc(SECTOR)]);
+      const idx = this.appendSector();
       for (let i = 0; i < 128; i++) this.fat.push(FREESECT);
       this.fat[idx] = FATSECT;
       this.fatSectors.push(idx);
@@ -26201,7 +26564,7 @@ var Surgeon = class {
   finish() {
     this.wipeFreedSectors();
     this.flushFat();
-    return this.buf;
+    return this.len === this.buf.length ? this.buf : this.buf.subarray(0, this.len);
   }
   /** 해제 후 재할당되지 않고 남은 FREESECT 섹터의 바이트를 0으로 채움 (데이터 remanence 제거) */
   wipeFreedSectors() {
@@ -27019,7 +27382,7 @@ function stageParaPatch(scan, para2, newPlain, skip) {
 }
 
 // src/validate.ts
-import JSZip9 from "jszip";
+import JSZip11 from "jszip";
 import { DOMParser as DOMParser4 } from "@xmldom/xmldom";
 var REQUIRED_FILES = [
   "mimetype",
@@ -27037,7 +27400,7 @@ async function validateHwpx(buffer) {
   const issues = [];
   let zip;
   try {
-    zip = await JSZip9.loadAsync(buffer);
+    zip = await JSZip11.loadAsync(buffer);
   } catch (err) {
     return {
       ok: false,
@@ -27105,10 +27468,10 @@ async function validateHwpx(buffer) {
 }
 
 // src/roundtrip/session.ts
-import JSZip10 from "jszip";
+import JSZip12 from "jszip";
 async function buildState(bytes) {
   const parsed = await parseHwpxDocument(u8ToArrayBuffer2(bytes));
-  const zip = await JSZip10.loadAsync(bytes);
+  const zip = await JSZip12.loadAsync(bytes);
   const sectionPaths = await resolveSectionEntryNames(zip);
   if (sectionPaths.length === 0) {
     throw new Error("HWPX \uC139\uC158 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
@@ -27450,7 +27813,7 @@ async function patchHwpxBlocks(original, edits, options) {
 }
 
 // src/print/renderer.ts
-import { existsSync } from "fs";
+import { existsSync as existsSync2 } from "fs";
 import MarkdownIt from "markdown-it";
 var PRESETS = {
   default: `
@@ -27589,7 +27952,7 @@ function findChromiumPath() {
   const linux = ["/usr/bin/google-chrome", "/usr/bin/chromium-browser", "/usr/bin/chromium"];
   const candidates = process.platform === "win32" ? win : process.platform === "darwin" ? mac : linux;
   for (const p of candidates) {
-    if (p && existsSync(p)) return p;
+    if (p && existsSync2(p)) return p;
   }
   return null;
 }
@@ -27649,7 +28012,7 @@ async function parse(input, options) {
 }
 async function parseImage(buffer, options) {
   try {
-    const { parseImageDocument } = await import("./image-ocr-KZTNJ62U.js");
+    const { parseImageDocument } = await import("./image-ocr-R44RYDBU.js");
     const { blocks, warnings } = await parseImageDocument(buffer, options);
     return {
       success: true,
@@ -27666,7 +28029,7 @@ async function parseImage(buffer, options) {
 async function parseHwp3(buffer, options) {
   try {
     const { markdown, blocks, metadata, outline, warnings } = parseHwp3Document(buffer, options);
-    return { success: true, fileType: "hwp3", markdown, blocks, metadata, outline, warnings };
+    return { success: true, fileType: "hwp3", markdown, blocks, metadata, outline, warnings, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "hwp3", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27674,7 +28037,7 @@ async function parseHwp3(buffer, options) {
 async function parseHwpx(buffer, options) {
   try {
     const { markdown, blocks, metadata, outline, warnings, images } = await parseHwpxDocument(buffer, options);
-    return { success: true, fileType: "hwpx", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0 };
+    return { success: true, fileType: "hwpx", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "hwpx", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27693,13 +28056,14 @@ async function parseHwp(buffer, options) {
             markdown: com.markdown,
             blocks: com.blocks,
             metadata: com.metadata,
-            warnings: com.warnings
+            warnings: com.warnings,
+            pageCount
           };
         }
       } catch {
       }
     }
-    return { success: true, fileType: "hwp", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0 };
+    return { success: true, fileType: "hwp", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "hwp", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27707,7 +28071,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-WNFWMBSL.js");
+    const mod = await import("./parser-W3POOYQQ.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -27719,7 +28083,7 @@ async function parsePdf(buffer, options) {
   }
   try {
     const { markdown, blocks, metadata, outline, warnings, isImageBased, pageQuality, qualitySummary, images } = await parsePdfDocument(buffer, options);
-    return { success: true, fileType: "pdf", markdown, blocks, metadata, outline, warnings, isImageBased, pageQuality, qualitySummary, images };
+    return { success: true, fileType: "pdf", markdown, blocks, metadata, outline, warnings, isImageBased, pageQuality, qualitySummary, images, pageCount: metadata?.pageCount };
   } catch (err) {
     const isImageBased = err instanceof Error && "isImageBased" in err ? true : void 0;
     return { success: false, fileType: "pdf", error: sanitizeError(err), code: classifyError(err), isImageBased };
@@ -27728,7 +28092,7 @@ async function parsePdf(buffer, options) {
 async function parseXlsx(buffer, options) {
   try {
     const { markdown, blocks, metadata, warnings } = await parseXlsxDocument(buffer, options);
-    return { success: true, fileType: "xlsx", markdown, blocks, metadata, warnings };
+    return { success: true, fileType: "xlsx", markdown, blocks, metadata, warnings, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "xlsx", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27736,7 +28100,7 @@ async function parseXlsx(buffer, options) {
 async function parseXls(buffer, options) {
   try {
     const { markdown, blocks, metadata, warnings } = await parseXlsDocument(buffer, options);
-    return { success: true, fileType: "xls", markdown, blocks, metadata, warnings };
+    return { success: true, fileType: "xls", markdown, blocks, metadata, warnings, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "xls", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27744,7 +28108,7 @@ async function parseXls(buffer, options) {
 async function parseDocx(buffer, options) {
   try {
     const { markdown, blocks, metadata, outline, warnings, images } = await parseDocxDocument(buffer, options);
-    return { success: true, fileType: "docx", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0 };
+    return { success: true, fileType: "docx", markdown, blocks, metadata, outline, warnings, images: images?.length ? images : void 0, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "docx", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27752,7 +28116,7 @@ async function parseDocx(buffer, options) {
 async function parseHwpml(buffer, options) {
   try {
     const { markdown, blocks, metadata, outline, warnings } = parseHwpmlDocument(buffer, options);
-    return { success: true, fileType: "hwpml", markdown, blocks, metadata, outline, warnings };
+    return { success: true, fileType: "hwpml", markdown, blocks, metadata, outline, warnings, pageCount: metadata?.pageCount };
   } catch (err) {
     return { success: false, fileType: "hwpml", error: sanitizeError(err), code: classifyError(err) };
   }
@@ -27798,9 +28162,13 @@ async function fillForm(input, values, outputFormat = "markdown") {
 }
 
 export {
-  PRESET_ALIAS,
-  normalizeGongmunPreset,
-  incompatibleGongmunWarnings,
+  isZipFile,
+  isHwpxFile,
+  isOldHwpFile,
+  isPdfFile,
+  detectFormat,
+  detectOle2Format,
+  detectZipFormat,
   extractHwpxMetadataOnly,
   extractHwp5MetadataOnly,
   formatFillValue,
@@ -27811,10 +28179,18 @@ export {
   inferFieldType,
   extractFormSchema,
   fillFormFields,
+  extractClickHereFields,
   fillHwpx,
+  PRESET_ALIAS,
+  normalizeGongmunPreset,
+  incompatibleGongmunWarnings,
   markdownToHwpx,
   compare,
   diffBlocks,
+  BUILTIN_TEMPLATES,
+  resolveBuiltinTemplate,
+  readBuiltinTemplate,
+  readBuiltinTemplateSample,
   hwpxToProfile,
   isKnownFont,
   unknownFontWarnings,
@@ -27841,4 +28217,4 @@ export {
   parseHwpml,
   fillForm
 };
-//# sourceMappingURL=chunk-G3DMDTZI.js.map
+//# sourceMappingURL=chunk-DRZUJ2RK.js.map