kordoc 4.21.24 → 4.21.26

package/README.md

@@ -117,10 +117,12 @@ await writeFile("보고서.hwpx", Buffer.from(hwpx))
 
 ## 최근 업데이트
 
-최신 배포: **[4.21.24](https://github.com/chrisryugj/kordoc/releases/tag/v4.21.24)** · 2026-10-12
+최신 배포: **[4.21.26](https://github.com/chrisryugj/kordoc/releases/tag/v4.21.26)** · 2026-10-12
 
 | 버전 | 주요 변경 |
 | --- | --- |
+| 4.21.26 | 학력 칸 `년 월 입학/졸업` 자리표시 기간 채움, markdown 경로 라벨 덮어쓰기 2,843 → 486(#146) |
+| 4.21.25 | 채운 칸 좌표·fill --dry-run 대상 칸, 2단 머리 표 채움(#145·#146) |
 | 4.21.24 | 서식 표 patch 거부 해소·끝 빈 칸 채움·행 추가, fill 하위 라벨·자리표시·상자 줄(#144·#145·#146) |
 | 4.21.23 | HWP·HWPX 삽입 그림 속 글 OCR — `ocr: true` 일 때 그림 블록 뒤에 그림 속 글(#143, 기본 산출 불변) |
 | 4.21.22 | PDF 양쪽 정렬 영문 참고문헌 줄을 열로 읽어 낱말이 뒤섞이던 것 고침 (web052 읽기 순서 → 1, score 커버리지 2문서 → 1) |

package/dist/{-6ZESKLUQ.js → -K2UEFE7X.js}

@@ -54,10 +54,10 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-6CG6V3IT.js";
+} from "./chunk-SOVJDMJY.js";
 import {
   blocksToChunks
-} from "./chunk-SKB7HDL7.js";
+} from "./chunk-AWFUJ2CE.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -82,30 +82,30 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-W6AXLG3S.js";
-import "./chunk-5IMVYWH6.js";
+} from "./chunk-Q6UEDUKY.js";
+import "./chunk-OAY3X47Q.js";
 import {
   blocksToPages
-} from "./chunk-OS2CIYLK.js";
+} from "./chunk-YBZWKPGR.js";
 import "./chunk-VKVDMH7X.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-F7HTSSTI.js";
+import "./chunk-3ZCHEQX6.js";
 import {
   blocksToMarkdown,
   flattenLayoutTables,
   hasStructuredCellContent
-} from "./chunk-47GYLNNK.js";
+} from "./chunk-5VUUWX45.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-FH5ICNNI.js";
-import "./chunk-A7NW4DGF.js";
+} from "./chunk-PBH2C3OP.js";
+import "./chunk-TF7AUNDC.js";
 import {
   VERSION
-} from "./chunk-6ED4Q6IK.js";
+} from "./chunk-SJCNQUDE.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -204,4 +204,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-6ZESKLUQ.js.map
+//# sourceMappingURL=-K2UEFE7X.js.map

package/dist/{chunk-F7HTSSTI.js → chunk-3ZCHEQX6.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   visibleText
-} from "./chunk-47GYLNNK.js";
+} from "./chunk-5VUUWX45.js";
 
 // src/script-tags.ts
 var LITERAL_TAG = /<(?=\/?(?:u|sup|sub)>)/g;
@@ -304,4 +304,4 @@ export {
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
 };
-//# sourceMappingURL=chunk-F7HTSSTI.js.map
+//# sourceMappingURL=chunk-3ZCHEQX6.js.map

package/dist/{chunk-F7HTSSTI.js.map → chunk-3ZCHEQX6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/script-tags.ts","../src/table/layout-frames.ts","../src/types.ts"],"sourcesContent":["/**\n * 위·아래첨자 표지 — 파서가 첨자 글을 인라인 HTML `<sup>`·`<sub>` 로 감싸 IR 글에 넣는다(밑줄 `<u>` 와 같은 방식,\n * GFM 에 첨자 문법이 없다). 평문으로 펴면 \"10⁴ m²\" 가 \"104 m2\", \"x_i\" 가 \"xi\" 로 값이 바뀐다.\n * HWPX·HWP5·DOCX 는 글자 모양 속성, PDF 는 기준선·글자 크기로 판정한다.\n */\n\nimport type { IRBlock } from \"./types.js\"\n\nexport type ScriptKind = \"sup\" | \"sub\"\n\n/** 원문 글자 가운데 파서가 넣는 표지(<u>·<sup>·<sub>)와 같은 꼴의 `<` */\nconst LITERAL_TAG = /<(?=\\/?(?:u|sup|sub)>)/g\n\n/**\n * IR 글 규약: 원문 글자 \"<sub>\"·\"</sup>\"·\"<u>\" 의 `<` 는 `\\<` 로 담는다(리터럴 `$` → `\\$` 와 같은 규약, escapeLiteralDollar).\n * 파서가 넣는 첨자·밑줄 표지와 같은 꼴이면 첨자 끔(stripScriptTags)·평문(plainScripts)·태그 정리(tidyScriptTags)가 원문 글자까지\n * 걷거나 고쳤다(#122 \"Close it with </sup> please.\" → \"Close it with  please.\"). `\\<` 는 CommonMark 이스케이프라 렌더는 `<` 그대로\n */\nexport function escapeLiteralTags(text: string): string {\n  return text.includes(\"<\") ? text.replace(LITERAL_TAG, \"\\\\<\") : text\n}\n\n/** 첨자 글을 태그로 감싼다 — 앞뒤 공백은 태그 밖으로, 공백뿐이면 그대로 */\nexport function wrapScript(text: string, kind: ScriptKind | null | undefined): string {\n  if (!kind) return text\n  const m = /^(\\s*)([\\s\\S]*?)(\\s*)$/.exec(text)!\n  return m[2] ? `${m[1]}<${kind}>${m[2]}</${kind}>${m[3]}` : text\n}\n\n/** 조각마다 감싼 태그 정리 — 이웃한 같은 태그를 합치고, 태그 안 앞뒤 공백을 밖으로 내고, 빈 태그를 지운다 */\nexport function tidyScriptTags(text: string): string {\n  if (!text.includes(\"<su\")) return text\n  // 이스케이프된 \\< 는 원문 글자 (escapeLiteralTags)\n  return text\n    .replace(/(?<!\\\\)<\\/(sup|sub)><\\1>/g, \"\")\n    .replace(/(?<!\\\\)<(sup|sub)>(\\s+)/g, \"$2<$1>\")\n    .replace(/(\\s+)<\\/(sup|sub)>/g, \"</$2>$1\")\n    .replace(/(?<!\\\\)<(sup|sub)><\\/\\1>/g, \"\")\n}\n\n/**\n * 평문(`plain`) 표기 — 태그를 걷되 값이 바뀌지 않게 `^`·`_` 로: \"10^4\"·\"m^2\"·\"H_2O\"·\"x^(n+1)\".\n * 글자·숫자(와 앞 부호)만이거나 주석 기호뿐이면 괄호 없이, 그 밖은 괄호로 묶는다.\n */\nexport function plainScripts(md: string): string {\n  if (!md.includes(\"<su\")) return md\n  return md.replace(/(?<!\\\\)<(sup|sub)>([^<\\n]*)<\\/\\1>/g, (_, kind: string, body: string) => {\n    const mark = kind === \"sup\" ? \"^\" : \"_\"\n    return /^(?:[+\\-−]?[\\p{L}\\p{N}]+|[*∗†‡§¶]+)$/u.test(body) ? mark + body : `${mark}(${body})`\n  })\n}\n\n/** 파서가 넣은 첨자 표지 — 이스케이프된 \\< 는 원문 글자 (escapeLiteralTags) */\nconst TAG_RE = /(?<!\\\\)<\\/?su[bp]>/g\n\n/**\n * 첨자 표기를 끈 결과(`scriptTags: false`, PDF·이미지 기본) — 마크다운·쪽별 마크다운·IR 글(문단·span·각주·목록·표 칸·캡션)에서\n * 태그만 걷는다. 파이프라인은 그대로 돌고 끝에서 걷으므로 글자 순서는 첨자 판정 전과 같다\n */\nexport function stripScriptTags<T extends { markdown?: string; blocks?: IRBlock[]; pages?: Array<{ markdown: string }> }>(r: T): T {\n  const s = (t: string) => (t.includes(\"<su\") ? t.replace(TAG_RE, \"\") : t)\n  const walk = (bs: IRBlock[] | undefined): void => {\n    for (const b of bs ?? []) {\n      if (b.text) b.text = s(b.text)\n      if (b.footnoteText) b.footnoteText = s(b.footnoteText)\n      for (const sp of b.spans ?? []) sp.text = s(sp.text)\n      walk(b.children)\n      if (b.table) {\n        if (b.table.caption) b.table.caption = s(b.table.caption)\n        walk(b.table.captionBlocks)\n        for (const row of b.table.cells) for (const c of row) { c.text = s(c.text); walk(c.blocks) }\n      }\n    }\n  }\n  walk(r.blocks)\n  if (r.markdown) r.markdown = s(r.markdown)\n  for (const p of r.pages ?? []) p.markdown = s(p.markdown)\n  return r\n}\n","/**\n * 보이지 않는 틀 표 풀기 — 한글 문서는 테두리를 없앤 표로 쪽을 짜는 일이 흔하다. 법령 별표 272건 중 103건이 본문 전체를\n * 안 보이는 틀 표에 담았고 표 381개 중 95개는 보이는 변이 하나도 없다(2026-09-29 실측). 구조대로 표로 내면 화면·LLM 이\n * 원본에 없는 격자를 본다(할부거래법 시행령 [별표 1]: 원본은 글과 분수뿐인데 5열 표 한 장).\n *\n * 칸마다 보이는 변(`CELL_EDGES` — HWPX borderFill·HWP5 BORDER_FILL·PDF 획)으로 두 가지를 한다.\n *  ① 분수 — 위아래로 붙은 두 칸 사이 가로선만 보이고 두 칸의 다른 변이 모두 안 보이는 짧은 한 줄 칸 쌍은 분수를 칸으로\n *     조립한 것이다(할부거래법 \"A=P×r× (1+r)ⁿ / (1+r)ⁿ-1\"). 한 칸 `$\\frac{위}{아래}$` 로 합친다.\n *  ② 행 띠 — 세로선이 보이는 행과, 위아래 가로선이 온 폭에 그어진 사이에 칸이 둘 이상인 행(가로선만 긋는 표)은 표 띠다.\n *     이어진 표 띠만 새 표로 다시 짜고(띠 안에서 쓰지 않는 행·열 경계와 선 밖 빈 칸은 접음) 나머지 행은 칸 글을 문단으로\n *     푼다. 칸 안 블록(중첩표)은 재귀로 같은 처리. 표 띠 칸 안의 중첩표도 본다.\n * 테두리 정보가 하나도 없는 표(다른 포맷)는 손대지 않는다. 호출자는 파서가 마크다운을 만들기 직전 — 왕복 패치·양식 채우기처럼\n * 원 구조가 필요한 경로는 `layoutTables: \"keep\"` 으로 건너뛴다.\n */\n\nimport type { IRBlock, IRCell, IRTable } from \"../types.js\"\nimport { visibleText } from \"./builder.js\"\n\n/** 칸의 보이는 변 */\nexport interface Edges { t: boolean; b: boolean; l: boolean; r: boolean }\n\n/** IR 칸 → 보이는 변. 공개 IR 에는 나가지 않는 곁정보 (파서가 채움) */\nexport const CELL_EDGES = new WeakMap<IRCell, Edges>()\n/** 쪽 넘김으로 이은 표에서 첫 쪽 뒤에 놓인 칸 → 그 쪽 번호 (PDF 쪽 넘김 잇기가 채움, #136). 표를 풀어 낸 문단과 쪽별 마크다운이\n *  칸이 놓인 쪽을 따른다. 표시가 없는 칸은 표 블록의 쪽이다 */\nexport const CELL_PAGES = new WeakMap<IRCell, number>()\n/** 글·블록 없이도 내용이 있는 칸 — PDF 는 칸 그림을 칸 글과 따로 뽑아 그림 칸의 text·blocks 가 빈다. 빈 여백 행 접기가 그림 행을\n *  접지 않게 파서가 표시한다 (경찰복제 [별표] 특수복식 도면 행) */\nexport const CONTENT_CELLS = new WeakSet<IRCell>()\n\n/** 칸 글 줄마다의 기준선 y (위→아래, 칸 text 의 줄과 같은 수일 때만 쓴다) — PDF 가 칸 글줄 기하로 채운다. 목차 행의 제목 줄과\n *  쪽 번호 줄을 짝짓는다 (textRow) */\nexport const CELL_BASELINES = new WeakMap<IRCell, number[]>()\n\n/** 분수 칸 글 상한(자) — 분자·분모는 식 조각이다. 문장 칸이 가로선 하나로 나뉜 것과 가른다 */\nconst FRACTION_MAX_CHARS = 40\n\ninterface Anchor { r: number; c: number; rs: number; cs: number; cell: IRCell }\n\nfunction anchorsOf(t: IRTable): Anchor[] {\n  const out: Anchor[] = []\n  const covered = new Set<number>()\n  for (let r = 0; r < t.rows; r++) for (let c = 0; c < t.cols; c++) {\n    if (covered.has(r * t.cols + c)) continue\n    const cell = t.cells[r]?.[c]\n    if (!cell) continue\n    const rs = Math.max(1, Math.min(cell.rowSpan, t.rows - r)), cs = Math.max(1, Math.min(cell.colSpan, t.cols - c))\n    for (let dr = 0; dr < rs; dr++) for (let dc = 0; dc < cs; dc++) covered.add((r + dr) * t.cols + c + dc)\n    out.push({ r, c, rs, cs, cell })\n  }\n  return out\n}\n\n/** 단위 격자의 보이는 가로선 H[r][c](행 r 윗변)·세로선 V[r][c](열 c 왼변) — 맞닿은 두 칸 가운데 하나라도 그으면 보인다 */\nfunction ruleGrids(t: IRTable, anchors: Anchor[]): { H: boolean[][]; V: boolean[][] } {\n  const H = Array.from({ length: t.rows + 1 }, () => new Array<boolean>(t.cols).fill(false))\n  const V = Array.from({ length: t.rows }, () => new Array<boolean>(t.cols + 1).fill(false))\n  for (const a of anchors) {\n    // 테두리 정보가 없는 칸은 보이는 칸으로 둔다 — 모르면 표를 지키는 쪽이다\n    const e = CELL_EDGES.get(a.cell) ?? { t: true, b: true, l: true, r: true }\n    for (let c = a.c; c < a.c + a.cs; c++) { if (e.t) H[a.r][c] = true; if (e.b) H[a.r + a.rs][c] = true }\n    for (let r = a.r; r < a.r + a.rs; r++) { if (e.l) V[r][a.c] = true; if (e.r) V[r][a.c + a.cs] = true }\n  }\n  return { H, V }\n}\n\n/** 분자·분모 글 → LaTeX. 첨자 태그는 ^{}·_{}, 한글 낱말은 \\text{} */\nfunction toTex(s: string): string {\n  // IR 이스케이프(리터럴 \\$, 태그 꼴 글자 \\<sub>)는 먼저 원래 글자로 — 그대로 두면 역슬래시가 다시 이스케이프돼 \"\\\\\\$5\"(LaTeX 줄바꿈)가\n  // 되고, 글자 \"<sub>\" 가 아래첨자가 됐다. 태그 꼴 글자는 첨자 변환이 끝난 뒤 되돌린다\n  return s\n    .replace(/\\\\\\$/g, \"$\")\n    .replace(/\\\\</g, \"\\u0001\")\n    .replace(/<\\/?u>/g, \"\")\n    .replace(/([\\\\{}%#&_$])/g, \"\\\\$1\")\n    .replace(/<sup>(.*?)<\\/sup>/g, \"^{$1}\")\n    .replace(/<sub>(.*?)<\\/sub>/g, \"_{$1}\")\n    .replace(/\\u0001/g, \"<\")\n    .replace(/[가-힣ㄱ-ㅎㅏ-ㅣ][가-힣ㄱ-ㅎㅏ-ㅣ\\s·ㆍ]*/g, m => `\\\\text{${m.trim()}}`)\n    .trim()\n}\n\n/** 분수 조각 칸 — 한 줄 짧은 글, 블록 없음 */\nfunction fractionPart(cell: IRCell): boolean {\n  const t = cell.text.trim()\n  return !!t && !t.includes(\"\\n\") && !cell.blocks?.length && t.replace(/<\\/?(?:u|sup|sub)>/g, \"\").length <= FRACTION_MAX_CHARS\n    && !/(?<!\\\\)\\$/.test(t)\n}\n\n/** ① 칸으로 조립한 분수를 한 칸으로 합친다. 합친 쌍이 있으면 true (anchors·격자는 새로 만들어야 함) */\nfunction mergeFractions(t: IRTable, anchors: Anchor[], H: boolean[][], V: boolean[][]): boolean {\n  const at = new Map<number, Anchor>()\n  for (const a of anchors) at.set(a.r * t.cols + a.c, a)\n  let merged = false\n  for (const u of anchors) {\n    const d = at.get((u.r + u.rs) * t.cols + u.c)\n    if (!d || d.cs !== u.cs || u.rs !== 1 || d.rs !== 1 || !fractionPart(u.cell) || !fractionPart(d.cell)) continue\n    // 표 온 폭을 차지하는 두 칸은 칸 두 개짜리 표(2×1 분수 표)일 때만 — 서식 끝 \"…귀하\"·\"210mm×297mm\" 칸, 제목과 본문 줄이\n    // 가로선 하나로 나뉜 모양이 분수로 잡혔다 (정답 그림 대조: 오탐 10건 → 0, 진짜 분수 9개 유지)\n    // 옆 열이 빈 여백 칸뿐이어도 온 폭과 같다 (임금채권보장법 시행규칙 재산목록: 왼쪽 빈 열 하나 때문에 \"…장 귀하\"·\"210mm×297mm\" 가 분수로)\n    const besideText = anchors.some(a => a !== u && a !== d && a.r <= d.r && a.r + a.rs > u.r && a.cell.text.trim())\n    if (!besideText && anchors.filter(a => a.cell.text.trim()).length !== 2) continue\n    const bar = d.r, c1 = u.c, c2 = u.c + u.cs\n    // 막대: 두 칸 사이 가로선이 두 칸 폭에만 — 옆 칸까지 이어지면 가로선만 긋는 표의 행 구분이다\n    let ok = true\n    for (let c = c1; c < c2 && ok; c++) if (!H[bar][c]) ok = false\n    if (!ok || (c1 > 0 && H[bar][c1 - 1]) || (c2 < t.cols && H[bar][c2])) continue\n    // 두 칸의 나머지 변은 모두 안 보여야 한다 (위·아래·좌·우)\n    for (let c = c1; c < c2 && ok; c++) if (H[u.r][c] || H[d.r + d.rs][c]) ok = false\n    for (let r = u.r; r < d.r + d.rs && ok; r++) if (V[r][c1] || V[r][c2]) ok = false\n    if (!ok) continue\n    u.cell.text = `$\\\\frac{${toTex(u.cell.text)}}{${toTex(d.cell.text)}}$`\n    u.cell.rowSpan = u.rs + d.rs\n    t.cells[d.r][d.c] = { text: \"\", colSpan: 1, rowSpan: 1 }\n    at.delete(d.r * t.cols + d.c)\n    merged = true\n  }\n  return merged\n}\n\n/** 표 띠 행 — 세로선이 보이거나, 온 폭 가로선 사이에 칸이 둘 이상 */\nfunction ruledRows(t: IRTable, anchors: Anchor[], H: boolean[][], V: boolean[][]): boolean[] {\n  const inRow = new Array<number>(t.rows).fill(0)\n  for (const a of anchors) for (let r = a.r; r < a.r + a.rs; r++) inRow[r]++\n  return Array.from({ length: t.rows }, (_, r) =>\n    V[r].some(Boolean) || (inRow[r] >= 2 && H[r].every(Boolean) && H[r + 1].every(Boolean)))\n}\n\n/** 표 띠 [r0, r1] → 새 표. 띠 안에서 시작하는 칸만, 띠 밖으로 나가는 병합은 자른다. 선 밖 빈 칸·안 쓰는 경계는 접는다 */\nfunction bandTable(t: IRTable, anchors: Anchor[], V: boolean[][], H: boolean[][], r0: number, r1: number, keepEmptyCols: boolean): IRTable | null {\n  let list = anchors.filter(a => a.r >= r0 && a.r <= r1).map(a => ({ ...a, rs: Math.min(a.rs, r1 - a.r + 1) }))\n  const blank = (a: Anchor): boolean => {\n    if (CONTENT_CELLS.has(a.cell)) return false\n    if (!a.cell.blocks?.length) return !a.cell.text.trim()\n    return a.cell.blocks.every(b => (b.type === \"paragraph\" || b.type === \"heading\") && !visibleText(b).trim() && !b.footnoteText)\n  }\n  // 선이 닿는 열 범위 — 선 밖 빈 들여쓰기 칸부터 빼야 그 칸을 표 행의 시작으로 세지 않는다.\n  let lo = Infinity, hi = -Infinity\n  for (let r = r0; r <= r1; r++) {\n    for (let c = 0; c <= t.cols; c++) if (V[r][c]) { lo = Math.min(lo, c); hi = Math.max(hi, c) }\n    for (const rr of [r, r + 1]) for (let c = 0; c < t.cols; c++) if (H[rr][c]) { lo = Math.min(lo, c); hi = Math.max(hi, c + 1) }\n  }\n  // 한쪽 세로선만 있는 입력 항목도 경계가 알려져 있다(lo === hi). 선 밖 글·그림은 보존한다.\n  if (Number.isFinite(lo)) list = list.filter(a => a.c < hi && a.c + a.cs > lo || !blank(a))\n  if (!list.length) return null\n  // 선 없이 붙은 빈 여백 행 — 그 행에서 시작하는 칸이 모두 비었고 윗선이나 아랫선이 표 폭 어디에도 없으면 그림에서 이웃 행과\n  // 한 행이다. 접는다 (양곡관리법·에너지이용 합리화법 별표 여백 행, 근로기준법 [별표 6] 여백 행 10개 — 정답 그림 대조 42→48/50.\n  // 윗선·아랫선 둘 다 없을 때만 접으면 에너지이용 합리화법 두 표가 안 접힌다)\n  const drop: number[] = []\n  for (let r = r0; r <= r1; r++) {\n    const starts = list.filter(a => a.r === r)\n    // 시작 칸이 없는 행은 위 칸의 병합 덮개다. 실제 빈 여백 칸이 있는 행만 접는다.\n    if (starts.length && (!H[r].some(Boolean) || !H[r + 1].some(Boolean)) && starts.every(blank)) drop.push(r)\n  }\n  if (drop.length) {\n    const shift = (y: number): number => y - drop.filter(d => d < y).length\n    list = list.filter(a => !drop.includes(a.r))\n      .map(a => ({ ...a, r: shift(a.r), rs: shift(a.r + a.rs) - shift(a.r) }))\n      .filter(a => a.rs > 0)\n  }\n  // 후행 빈 열 — 띠에서 오른쪽 끝 열이 비면 자른다. 원래 표를 만들 때 builder 가 하는 트림(마크다운 가독성)을 띠 표에도 똑같이:\n  // 표 전체로는 글이 있어 남은 열이 한 띠에서만 비는 경우다(결재문서 점검표 \"□ | ■ | (빈 칸)\" — 생성 → 재파싱 왕복이 어긋났다).\n  // keepTrailingEmptyCols(#47 서식 입력란)면 builder 처럼 두고\n  // 빈 띠도 HTML로 남긴다. 후행 열 정리는 마지막 앵커를 지우기 전에 멈춘다.\n  const emptyBand = list.every(blank)\n  for (let right = keepEmptyCols ? 0 : Math.max(...list.map(a => a.c + a.cs)); right > 1;) {\n    const starts = list.filter(a => a.c === right - 1)\n    if (!starts.length || !starts.every(blank) || starts.length === list.length) break\n    list = list.filter(a => a.c !== right - 1).map(a => (a.c + a.cs === right ? { ...a, cs: a.cs - 1 } : a))\n    right--\n  }\n  const colB = new Set<number>(), rowB = new Set<number>()\n  for (const a of list) { colB.add(a.c); colB.add(a.c + a.cs); rowB.add(a.r); rowB.add(a.r + a.rs) }\n  const cx = [...colB].sort((x, y) => x - y), rx = [...rowB].sort((x, y) => x - y)\n  const cols = cx.length - 1, rows = rx.length - 1\n  if (cols < 1 || rows < 1) return null\n  const cells: IRCell[][] = Array.from({ length: rows }, () => Array.from({ length: cols }, () => ({ text: \"\", colSpan: 1, rowSpan: 1 })))\n  for (const a of list) {\n    const r = rx.indexOf(a.r), c = cx.indexOf(a.c)\n    a.cell.rowSpan = rx.indexOf(a.r + a.rs) - r\n    a.cell.colSpan = cx.indexOf(a.c + a.cs) - c\n    cells[r][c] = a.cell\n  }\n  return { rows, cols, cells, hasHeader: t.hasHeader, ...(emptyBand ? { renderAsTable: true } : {}) }\n}\n\n/** 목차 행 — 제목 칸과 쪽 번호 칸(\"1. 직업계고 현장실습의 이해⏎2. 현장실습 운영지원 | 2⏎8\")을 기준선으로 짝지은 줄들. 칸 글을 통째로\n *  이으면 제목을 다 읽은 뒤 쪽 번호만 몰렸다(현장실습 매뉴얼 목차 \"…운영지원 2 8\"). 쪽 번호 없는 줄(장 제목)은 홀로 선다. 짝이 안 맞으면 null */\nfunction tocLines(cells: IRCell[]): string[] | null {\n  if (cells.length !== 2) return null\n  const [titles, pages] = cells.map(c => c.text.trim().split(\"\\n\").map(l => l.trim()))\n  const [ty, py] = cells.map(c => CELL_BASELINES.get(c))\n  if (!ty || !py || ty.length !== titles.length || py.length !== pages.length || titles.length < 2 ||\n      !pages.every(l => /^\\d{1,4}$/.test(l)) || titles.some(l => !l || /^\\d{1,4}$/.test(l))) return null\n  const lines = [...titles], taken = new Set<number>()\n  for (let j = 0; j < pages.length; j++) {\n    const i = ty.findIndex(y => Math.abs(y - py[j]) <= 3)\n    if (i < 0 || taken.has(i)) return null\n    taken.add(i)\n    lines[i] += \" \" + pages[j]\n  }\n  return lines\n}\n\n/** 글 띠 행 → 문단. 칸이 하나면 칸 안 줄마다, 여럿이면 칸 글을 공백으로 이은 한 문단(목차 행은 줄마다 \"제목 쪽\"). 칸 블록은 재귀로 푼다 */\nfunction textRow(row: Anchor[], out: IRBlock[], pageNumber: number | undefined, keepEmptyCols: boolean): void {\n  const parts: string[] = []\n  const cells: IRCell[] = []\n  const flush = (): void => {\n    if (!parts.length) return\n    const toc = tocLines(cells)\n    if (toc) {\n      for (const line of toc) out.push({ type: \"paragraph\", text: line, pageNumber })\n    } else if (parts.length === 1) {\n      for (const line of parts[0].split(\"\\n\")) if (line.trim()) out.push({ type: \"paragraph\", text: line.trim(), pageNumber })\n    } else {\n      const text = parts.map(p => p.replace(/\\s*\\n\\s*/g, \" \").trim()).filter(Boolean).join(\" \")\n      if (text) out.push({ type: \"paragraph\", text, pageNumber })\n    }\n    parts.length = 0\n    cells.length = 0\n  }\n  for (const a of row) {\n    if (a.cell.blocks?.length) {\n      flush()\n      out.push(...unframeLayoutTables(a.cell.blocks, keepEmptyCols))\n      continue\n    }\n    if (a.cell.text.trim()) { parts.push(a.cell.text.trim()); cells.push(a.cell) }\n  }\n  flush()\n}\n\n/** 표 하나 → 풀어낸 블록. 바꿀 게 없으면 null (원래 표 그대로) */\nfunction unframeTable(t: IRTable, pageNumber: number | undefined, keepEmptyCols: boolean): IRBlock[] | null {\n  let anchors = anchorsOf(t)\n  if (!anchors.some(a => CELL_EDGES.has(a.cell))) return null\n  let { H, V } = ruleGrids(t, anchors)\n  if (mergeFractions(t, anchors, H, V)) {\n    anchors = anchorsOf(t)\n    ;({ H, V } = ruleGrids(t, anchors))\n  }\n  const ruled = ruledRows(t, anchors, H, V)\n  if (ruled.every(Boolean)) {\n    // 표 전체가 표 띠여도 안 쓰는 격자선·선 밖 빈 칸·빈 여백 행은 접는다(한글 편집기 격자에만 있는 선, 86712 규제영향분석서 10×8 → 10×5).\n    // 모양이 그대로면 원래 표 객체(sourceId·캡션·곁정보)를 둔다\n    const whole = bandTable(t, anchors, V, H, 0, t.rows - 1, keepEmptyCols)\n    if (!whole) return null\n    if (whole.rows === t.rows && whole.cols === t.cols) {\n      if (whole.renderAsTable) t.renderAsTable = true\n      return null\n    }\n    return [{ type: \"table\", table: { ...t, rows: whole.rows, cols: whole.cols, cells: whole.cells,\n      ...(whole.renderAsTable ? { renderAsTable: true } : {}) }, pageNumber }]\n  }\n  const out: IRBlock[] = []\n  if (t.captionBlocks?.length) out.push(...t.captionBlocks)\n  else if (t.caption) out.push({ type: \"paragraph\", text: t.caption, pageNumber })\n  // 쪽 넘김으로 이은 표는 행이 놓인 쪽을 칸 표시로 안다 (CELL_PAGES) — 풀어 낸 띠·문단도 그 쪽에\n  const rowPage = (r: number): number | undefined => {\n    const marks = anchors.filter(a => a.r === r).map(a => CELL_PAGES.get(a.cell)).filter((p): p is number => p !== undefined)\n    return marks.length ? Math.max(...marks) : pageNumber\n  }\n  for (let r = 0; r < t.rows;) {\n    if (ruled[r]) {\n      let r1 = r\n      while (r1 + 1 < t.rows && ruled[r1 + 1]) r1++\n      const sub = bandTable(t, anchors, V, H, r, r1, keepEmptyCols)\n      if (sub) out.push({ type: \"table\", table: sub, pageNumber: rowPage(r) })\n      r = r1 + 1\n      continue\n    }\n    textRow(anchors.filter(a => a.r === r).sort((x, y) => x.c - y.c), out, rowPage(r), keepEmptyCols)\n    r++\n  }\n  return out\n}\n\n/** 블록 목록의 보이지 않는 틀 표를 푼다 (표 띠에 남은 칸 안 블록까지). 새 배열을 돌려준다.\n *  keepEmptyCols = ParseOptions.keepTrailingEmptyCols (띠 표의 후행 빈 열을 자르지 않는다) */\nexport function unframeLayoutTables(blocks: IRBlock[], keepEmptyCols = false): IRBlock[] {\n  const out: IRBlock[] = []\n  for (const b of blocks) {\n    if (b.type !== \"table\" || !b.table) { out.push(b); continue }\n    if (b.table.captionBlocks?.length) b.table.captionBlocks = unframeLayoutTables(b.table.captionBlocks, keepEmptyCols)\n    const flat = unframeTable(b.table, b.pageNumber, keepEmptyCols)\n    const kept = flat ?? [b]\n    for (const k of kept) {\n      if (k.type === \"table\" && k.table) {\n        for (const row of k.table.cells) for (const cell of row) if (cell.blocks?.length) cell.blocks = unframeLayoutTables(cell.blocks, keepEmptyCols)\n      }\n      out.push(k)\n    }\n  }\n  return out\n}\n","/** kordoc 공통 타입 정의 */\n\n// ─── 중간 표현 (Intermediate Representation) ─────────\n\nexport interface CellContext {\n  text: string\n  colSpan: number\n  rowSpan: number\n  /** HWP5 셀 열 주소 (0-based) — 병합 테이블 배치용 */\n  colAddr?: number\n  /** HWP5 셀 행 주소 (0-based) — 병합 테이블 배치용 */\n  rowAddr?: number\n}\n\n/** 블록 타입 — v2.0에서 heading, list, image, separator 추가 */\nexport type IRBlockType = \"paragraph\" | \"table\" | \"heading\" | \"list\" | \"image\" | \"separator\"\n\n/** 인라인 강조 run-span — 문단 텍스트를 서식 단위로 쪼갠 조각 (텍스트 연결 = block.text) */\nexport interface IRSpan {\n  text: string\n  bold?: boolean\n  italic?: boolean\n  strike?: boolean\n  /** 밑줄 — 개정문 추가·변경 표시 등. GFM 문법이 없어 <u>…</u> 인라인 HTML 로 방출 */\n  underline?: boolean\n  code?: boolean\n  /**\n   * 미기입 누름틀의 안내문(HWPX CLICK_HERE, 수정 안 됨). 한컴은 화면에만 흐리게 보이고 인쇄하지 않는다.\n   * 블록 `text` 에는 남기고(양식 채우기·패치가 원문 자리와 맞대도록) 마크다운에서는 뺀다 (v4.14.3)\n   */\n  placeholder?: boolean\n}\n\nexport interface IRBlock {\n  type: IRBlockType\n  /** 블록 글. HWPX·HWP5·HWP3 은 원문의 리터럴 `$` 를 `\\$` 로 담고 `$…$`·`$$…$$` 는 수식 스팬에만 쓴다 (v4.14.3) */\n  text?: string\n  table?: IRTable\n  /** 헤딩 레벨 (1-6), type=\"heading\"일 때 사용 */\n  level?: number\n  /** 원본 페이지 번호 (1-based) */\n  pageNumber?: number\n  /** 바운딩 박스 — PDF에서만 제공 */\n  bbox?: BoundingBox\n  /** 텍스트 스타일 정보 (선택) */\n  style?: InlineStyle\n  /** 리스트 타입, type=\"list\"일 때 사용 */\n  listType?: \"ordered\" | \"unordered\"\n  /** 중첩 리스트 아이템 */\n  children?: IRBlock[]\n  /** 하이퍼링크 URL */\n  href?: string\n  /** 각주/미주 텍스트 (인라인 삽입용) */\n  footnoteText?: string\n  /** 이미지 데이터 (type=\"image\"일 때) */\n  imageData?: ImageData\n  /** 인라인 강조 run-span (선택 — kordoc 생성 hwpx 왕복 채널 + 외래 실속성 볼드/이탤릭).\n   *  존재하면 마크다운 변환이 **·*·` 마커를 재방출한다 */\n  spans?: IRSpan[]\n  /** 인용문 문단 (선택 — kordoc 생성 hwpx 왕복 채널) — 마크다운 변환이 \"> \" 접두 재방출 */\n  quote?: boolean\n  /**\n   * 문단 들여쓰기(HWPUNIT, 선택) — HWPX paraPr `<hh:margin>` 자식요소형 hc:left\n   * (+양수 hc:intent 첫줄분). 마크다운 방출엔 쓰지 않는 관찰 슬롯 — gongmun 리스트\n   * depth 재유도·양식 분석 등 소비자 몫 (v4.0.4)\n   */\n  indent?: number\n  /**\n   * gongmun 리스트 단계(1~7, 선택) — indent를 levelIndent 단위로 역산한 소비 결과\n   * (v4.0.5). md 리스트 문법과 충돌하는 부호('- '·'1) ') 문단에만 채워지며,\n   * 마크다운 변환이 2칸/단계 선행 공백을 방출해 재생성 시 depth가 복원된다\n   */\n  listDepth?: number\n}\n\n/** 추출된 이미지 바이너리 데이터 */\nexport interface ImageData {\n  /** 이미지 바이너리 */\n  data: Uint8Array\n  /** MIME 타입 (image/png, image/jpeg, image/gif, image/bmp, image/wmf, image/emf) */\n  mimeType: string\n  /** 원본 파일명 (있는 경우) */\n  filename?: string\n}\n\n/** 바운딩 박스 — PDF 포인트 단위 (72pt = 1인치) */\nexport interface BoundingBox {\n  page: number\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\n/** 인라인 텍스트 스타일 */\nexport interface InlineStyle {\n  bold?: boolean\n  italic?: boolean\n  /** 취소선 — 법령 개정문 등의 삭제 표시. 판정은 취소선 모양 whitelist (비트만 믿으면 오탐) */\n  strike?: boolean\n  /** 밑줄 — 판정은 밑줄 종류 BOTTOM 한정 (NONE 이 기본 잡음, 코퍼스 실측) */\n  underline?: boolean\n  fontSize?: number\n  fontName?: string\n}\n\n// ─── 표 분류 계약 (#76) — 분류기 내부 점수 구조(TableSignals)는 노출하지 않는다 ───\n\nexport type TableClassificationKind = \"semantic-table\" | \"non-tabular-layout\" | \"uncertain\"\n\nexport type TableClassificationReason =\n  | \"repeated-row-schema\"\n  | \"grid-regularity\"\n  | \"high-active-density\"\n  | \"column-type-consistency\"\n  | \"nested-structure-wrapper\"\n  | \"span-irregularity\"\n  | \"spacer-bands\"\n  | \"extreme-sparsity\"\n  | \"diagram-context-keyword\"\n  | \"low-evidence\"\n  | \"ambiguous-scores\"\n\n/** 휴리스틱 분류 결과 — confidence 는 확률이 아니라 두 점수의 격차 */\nexport interface TableClassificationSummary {\n  kind: TableClassificationKind\n  confidence: number\n  semanticScore: number\n  nonTabularScore: number\n  reasons: TableClassificationReason[]\n}\n\nexport interface IRTable {\n  rows: number\n  cols: number\n  cells: IRCell[][]\n  /** PDF의 1열 데이터 표나 테두리가 있는 빈 입력란을 HTML 표로 유지한다. 목록성 틀의 평탄화와 구분한다. */\n  renderAsTable?: boolean\n  /** 첫 행을 헤더로 렌더링할지 여부 (현재: rows > 1이면 true — 의미적 감지가 아닌 레이아웃 힌트) */\n  hasHeader: boolean\n  /** opt-in 분류(`ParseOptions.classifyTables`) 결과 — #76 */\n  classification?: TableClassificationSummary\n  /** 원본 표 식별자(HWPX `hp:tbl id`) — 렌더 region(`RenderRegion.sourceId`)과의 조인 키 */\n  sourceId?: string\n  /** `tableFormat: \"gfm\"` 관계 표지의 표 id(`t1`, `t2` …) — 문서 블록 트리 전위 순회 순번. 그 옵션으로 렌더할 때만 채워진다(원본 id 아님) */\n  markdownId?: string\n  /** 렌더 인프라가 준 페이지 로컬 pt 조각(다중 페이지 표는 여럿) — extractTables 가 채운다 */\n  regions?: BoundingBox[]\n  /** 표 캡션 (예: \"표 1. 부서별 예산\") — v3.0 */\n  caption?: string\n  /**\n   * 캡션 내부 블록 콘텐츠 — v4.2.8 (#55).\n   * 캡션 안 중첩표·문단을 구조 그대로, 원문 순서대로 보존한다 (IRCell.blocks와 같은 계약).\n   * 표가 있을 때만 채워지며, caption은 하위 호환용 평탄화 문자열로 계속 제공된다.\n   */\n  captionBlocks?: IRBlock[]\n}\n\nexport interface IRCell {\n  text: string\n  colSpan: number\n  rowSpan: number\n  /**\n   * 셀 내부 블록 콘텐츠 — v3.0.\n   * 중첩 표·이미지 등 구조 콘텐츠(또는 왕복 채널 span 문단)가 있는 셀에만 채워지며,\n   * 그 안의 문단·표·이미지를 문서(원문) 순서대로 보존한다. 다중 문단뿐인 평문 셀은\n   * blocks 없이 text 평탄화(문단을 `\\n`으로 결합)로만 제공된다 (blocks 무게 억제, #57).\n   * 표와 텍스트가 한 줄에 번갈아 놓인 셀도 배치 순서를 따른다 (v4.2.3, #49).\n   * blocks가 있으면 text는 blocks의 평탄화 텍스트(하위 호환용)다.\n   */\n  blocks?: IRBlock[]\n  /** 제목 셀 여부 (HWP5 width_ref bit2 / HWPX header 속성) — v3.0 */\n  isHeader?: boolean\n}\n\n// ─── 메타데이터 ─────────────────────────────────────\n\n/** 문서 메타데이터 — 각 포맷에서 추출 가능한 필드만 채워짐 */\nexport interface DocumentMetadata {\n  /** 문서 제목 */\n  title?: string\n  /** 작성자 */\n  author?: string\n  /** 작성 프로그램 (예: \"한글 2020\", \"Adobe Acrobat\") */\n  creator?: string\n  /** 생성일시 (ISO 8601) */\n  createdAt?: string\n  /** 수정일시 (ISO 8601) */\n  modifiedAt?: string\n  /** 페이지/섹션 수 — pageMode=\"layout\"이면 실제 페이지 수, \"section\"이면 섹션 수 */\n  pageCount?: number\n  /**\n   * 페이지 경계 신뢰도 (#66) — \"layout\": 조판 정보 기반 실제 페이지\n   * (한컴 저장본 HWP/HWPX·PDF·COM, PPTX 슬라이드), \"section\": 섹션 단위 근사\n   * (조판 캐시 없는 생성 파일). HWP/HWPX/PDF·PPTX에서만 설정된다.\n   */\n  pageMode?: \"layout\" | \"section\"\n  /** 문서 포맷 버전 (예: HWP \"5.1.0.1\") */\n  version?: string\n  /** 설명 */\n  description?: string\n  /** 키워드 */\n  keywords?: string[]\n}\n\n// ─── 파싱 옵션 ──────────────────────────────────────\n\n/** 파싱 옵션 — parse() 함수에 전달 */\nexport interface ParseOptions {\n  /**\n   * 파싱할 페이지/섹션 범위 (1-based).\n   * - 배열: [1, 2, 3]\n   * - 문자열: \"1-3\", \"1,3,5-7\"\n   *\n   * PDF: 정확한 페이지 단위. HWP/HWPX: 섹션 단위 근사치.\n   */\n  pages?: number[] | string\n  /** 이미지 기반 PDF OCR (선택).\n   *  - 지정 안 함(기본): 내장 모델이 이미 캐시에 있으면(`kordoc models` 로 받았거나 앞서 `ocr: true` 로 받은 경우) 텍스트층이\n   *    없는 쪽(스캔·글자를 곡선으로 그린 쪽)과 글 없는 큰 그림(쪽 면적 5% 넘는) 속 글을 자동 인식한다. 모델이 없으면 다운로드하지\n   *    않고 NEEDS_OCR·SKIPPED_IMAGE 경고만.\n   *  - `false`: 끈다.\n   *  - `true`: 내장 엔진(PP-OCRv5 korean, ~18MB 자동 다운로드)으로 OCR 필요 판정\n   *    페이지만 인식 (스캔 페이지·글꼴 매핑 깨진 페이지). 정상 페이지는 파싱 결과 유지.\n   *  - `\"force\"`: 전 페이지를 내장 엔진으로 강제 OCR.\n   *  - 함수: 사용자 제공 OcrProvider (Claude Vision·Tesseract 등) — 판정은 `true`와 동일. */\n  ocr?: boolean | \"force\" | OcrProvider\n  /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */\n  onProgress?: (current: number, total: number) => void\n  /** PDF 머리글/바닥글 자동 제거 */\n  removeHeaderFooter?: boolean\n  /**\n   * 위·아래첨자를 인라인 HTML `<sup>`·`<sub>` 로 표기 — 평문으로 펴면 \"10⁴ m²\" 가 \"104 m2\", \"x_i\" 가 \"xi\" 로 값이 바뀐다.\n   * 기본: HWPX·HWP·DOCX 켬(글자 모양에 적힌 첨자), PDF 끔(글자 크기·기준선으로 추정 — 논문·수식 문서는 true 권장.\n   * 공개 벤치 ODL 정답이 첨자를 평문으로 적어 기본값을 두지 않는다). false 면 모든 형식에서 평문. OCR 로 읽은 글은 늘 평문\n   */\n  scriptTags?: boolean\n  /** 평문 Markdown — 그림 자리 표시·링크 URL·밑줄(`<u>`)·굵게(`**`) 표기를 빼고 글만 (제목·목록·표 구조는 유지).\n   *  첨자 `<sup>`·`<sub>` 는 값이 남게 `10^4`·`H_2O` 로 편다. 이미지 바이트를 따로 저장하지 않는 색인·RAG 용. 기본 false. `blocks` IR 은 그대로 */\n  plain?: boolean\n  /** 모든 표를 HTML 로 — 파이프 표도 HTML 표로 옮기고, 표마다 태그를 한 줄씩 들여써 낸다(BeautifulSoup prettify 모양, 첫 행 `<th>`).\n   *  HTML 표만 다루는 소비자·채점기용. 기본 false(병합·중첩 없는 표는 GFM 파이프 표) */\n  htmlTables?: boolean\n  /** `\"gfm\"`: 모든 표를 HTML 없이 GFM 파이프 표로 — 세로 병합 칸은 덮인 행마다 같은 값, 가로 병합 칸은 시작 칸에만 값, 셀 안 표는 부모 표 뒤 독립 표로 꺼내고\n   *  부모·자식 관계를 `<!-- <table id=\"t2\" parent_id=\"t1\" /> -->` 표지로 남긴다(RAG 색인용). `htmlTables` 와 함께 쓸 수 없다. 기본: 병합·중첩 표는 HTML */\n  tableFormat?: \"gfm\"\n  /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n   *  기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n   *  양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n  keepTrailingEmptyCols?: boolean\n  /** 테두리가 안 보이는 틀 표 처리 (v4.17.0). 기본 `\"visual\"`: 보이는 대로 — 선이 없는 틀은 글로 풀고 선이 보이는 부분만 표로,\n   *  칸으로 조립한 분수는 `$\\frac{…}{…}$` 수식으로. `\"keep\"`: 종전대로 원본 표 구조 그대로(왕복 패치·양식 채우기처럼\n   *  원본 표 서수가 필요한 경로). HWPX·HWP5·PDF */\n  layoutTables?: \"visual\" | \"keep\"\n  /** 구조 파싱 뒤 표를 의미표/레이아웃/불확실로 분류해 `IRTable.classification` 에 붙인다 (#76).\n   *  기본 false — 기본 parse 출력 불변. 중첩표·셀 blocks·캡션 blocks 까지 재귀, 원문 순서는 바꾸지 않는다. */\n  classifyTables?: boolean\n  /** 빈 문단(텍스트 없는 hp:p) 보존 (#57). 기본 false: 종전대로 빈 문단 제거.\n   *  켜면 본문은 `text: \"\"` paragraph 블록으로, 표 셀은 빈 줄로 순서대로 보존해\n   *  \"원문 문단 수 = 줄 수\" 대응을 유지한다 (행 줄맞춤 서식 문서용).\n   *  개체(표·이미지·글상자)만 있는 문단은 개체 출력이 따로 있어 대상이 아니다.\n   *  현재 HWPX 경로 적용. */\n  keepEmptyParagraphs?: boolean\n  /** 미기입 누름틀 안내문도 마크다운에 낸다 (#92). 기본 false: 종전대로 뺀다(한컴은 화면에만 흐리게 보이고 인쇄하지 않는 글).\n   *  빈 서식 문서에서 \"이 칸에 무엇을 적나\"(예: \"학교명 기재 금지\")가 안내문뿐일 때 켠다. HWPX·HWP5 */\n  includeFieldPlaceholders?: boolean\n  /** 비밀번호로 보호된 문서의 열기 암호.\n   *  HWPX(ODF AES-256-CBC)·HWP3(DES) 지원. 한컴 DRM(문서 보안)은 별개라 해당 없음. */\n  password?: string\n  /** 원본 파일 경로 (DRM COM fallback에 필요, 내부 전용) */\n  filePath?: string\n  /**\n   * PDF 수식 OCR 활성화 (기본 false).\n   *\n   * 활성화 시 각 PDF 페이지를 이미지로 렌더링 → YOLOv8 기반 수식 영역 검출 →\n   * TrOCR 기반 LaTeX 인식. 감지된 수식은 `$...$` (inline) / `$$...$$` (display) 로\n   * 블록 텍스트에 삽입된다.\n   *\n   * 필수 optional 의존성: `onnxruntime-node`, `@huggingface/transformers`,\n   * `@hyzyla/pdfium`, `sharp`. 미설치 시 parse 에 실패하지 않고 **경고만** 남기고\n   * 수식 인식은 skip 한다 (일반 텍스트 추출은 정상 동작).\n   *\n   * 모델(~155MB) 은 첫 사용 시 HuggingFace 에서 자동 다운로드 되어\n   * `~/.cache/kordoc/models/pix2text/` 에 SHA-256 검증과 함께 저장된다.\n   */\n  formulaOcr?: boolean\n  /**\n   * 레이아웃 표 페이지 반복 헤더(러닝 헤더) 정리 휴리스틱 활성화 (기본 false).\n   *\n   * 구형 HWP5 문서가 페이지마다 재삽입한 짧은 번호매김 러닝 헤더\n   * (\"2. 과제 구축 내용\")를 최초 1회만 남기고 이후 중복을 제거한다.\n   * 다만 페이지 위치 정보가 없는 HWP5 특성상 이 휴리스틱은 정당하게 반복되는\n   * 번호매김 문단(예: 붙임/별지별 재번호 \"1. 목적\")도 삭제할 수 있어 opt-in 으로\n   * 둔다. 활성 시 제거가 발생하면 HIDDEN_TEXT_FILTERED 경고를 남긴다.\n   */\n  dedupeRunningHeaders?: boolean\n  /**\n   * 추출된 이미지를 마크다운에 base64 data URI 로 인라인 (기본 false).\n   *\n   * 활성화 시 `![image](image_001.bmp)` 참조를 `![image](data:image/png;base64,...)` 로\n   * 치환한다. 임베드된 BMP 는 PNG 로 무손실 압축 후 인라인하여 용량을 크게 줄인다.\n   * 별도 이미지 파일 없이 자체 완결형 마크다운이 되어 MCP/AI 에이전트 소비에 적합하다.\n   * (현재 HWP5 경로 지원)\n   */\n  inlineImages?: boolean\n  /**\n   * 이미지 바이트 추출 (기본 true). false 면 결과에 이미지 바이트를 싣지 않는다.\n   * `images` 는 비고, 블록의 `imageData` 도 떼며, HWP5 `inlineImages` 도 무시한다.\n   * 그림 자리 표시(`![image](…)`)는 마크다운·블록에 그대로 남아 위치는 알 수 있다.\n   * PDF 는 PNG 인코딩을 건너뛴다. 거르는 기준은 같되 메모리 보호용 128MB 누적 상한은 걸리지\n   * 않아, 그 상한 뒤의 그림도 자리 표시가 남는다. DOCX 는 그림 파트(`word/media`·`word/embeddings`)를\n   * 풀지 않고 ZIP 비압축 상한(100MB)에도 세지 않는다 (#108).\n   *\n   * 검색 색인처럼 글자만 필요한 호출자용이다. 그림이 많은 문서는 base64 로 불어난 이미지가\n   * JSON 출력의 대부분을 차지했다 (PDF 실측 200MB → 9.5MB, CPU 시간 30% 감소). 본문 글자와\n   * OCR 은 이 옵션과 무관하다.\n   */\n  images?: boolean\n  /**\n   * PDF 표 감지 활성화 (기본 true). false 면 선 기반 그리드·클러스터 표 감지를 모두 끄고\n   * 자연 읽기순 텍스트만 뽑는다 (#64).\n   *\n   * 시각적 테두리 박스(시험지 안내문·보기 상자)가 표로 잡히면 주변 본문이 셀 매핑으로\n   * 끌려 들어가 문항 순서가 뒤집히는데, 표가 애초에 필요 없는 텍스트 중심 사용처에는\n   * 우회 수단이 없었다. 표가 실제로 있는 문서에 켜면 표 구조가 문단으로 흩어지므로\n   * 문서 종류를 아는 호출자만 쓰는 opt-out 이다. PDF 전용 — 다른 포맷은 무시.\n   */\n  tables?: boolean\n}\n\n// ─── 파싱 경고 ──────────────────────────────────────\n\n/** 파싱 중 스킵/실패한 요소 보고 */\nexport interface ParseWarning {\n  /** 관련 페이지 번호 (알 수 있는 경우) */\n  page?: number\n  /** 경고 메시지 */\n  message: string\n  /** 구조화된 경고 코드 */\n  code: WarningCode\n}\n\nexport type WarningCode =\n  | \"SKIPPED_IMAGE\"\n  | \"SKIPPED_OLE\"\n  | \"TRUNCATED_TABLE\"\n  | \"OCR_FALLBACK\"\n  | \"UNSUPPORTED_ELEMENT\"\n  | \"BROKEN_ZIP_RECOVERY\"\n  | \"HIDDEN_TEXT_FILTERED\"\n  | \"MALFORMED_XML\"\n  | \"PARTIAL_PARSE\"\n  | \"LENIENT_CFB_RECOVERY\"\n  | \"NEEDS_OCR\"\n  | \"OCR_FAILED\"\n  | \"OCR_APPLIED\"\n  | \"OCR_LOW_CONF\"\n  | \"COM_EMPTY\"\n  | \"DRM_COM_FALLBACK\"\n  /** pages 옵션 요청됐으나 조판 캐시가 없어 섹션 단위 근사로 적용됨 (#66) */\n  | \"PAGE_BOUNDARY_APPROXIMATE\"\n\n/** 문서 구조 (헤딩 트리) */\nexport interface OutlineItem {\n  level: number\n  text: string\n  pageNumber?: number\n}\n\n// ─── 에러 코드 ──────────────────────────────────────\n\n/** 구조화된 에러 코드 — 프로그래밍적 에러 핸들링용 */\nexport type ErrorCode =\n  | \"EMPTY_INPUT\"\n  | \"UNSUPPORTED_FORMAT\"\n  | \"ENCRYPTED\"\n  | \"DRM_PROTECTED\"\n  | \"CORRUPTED\"\n  | \"DECOMPRESSION_BOMB\"\n  | \"ZIP_BOMB\"\n  | \"IMAGE_BASED_PDF\"\n  | \"NO_SECTIONS\"\n  | \"PARSE_ERROR\"\n  | \"MISSING_DEPENDENCY\"\n  /** 결과 직렬화가 런타임 문자열 한계를 넘음 — 이미지 다량 문서의 JSON 출력 (#65) */\n  | \"OUTPUT_TOO_LARGE\"\n  /** 입력 경로가 존재하지 않음(ENOENT) — 문서 파싱 이전 단계의 실패 */\n  | \"FILE_NOT_FOUND\"\n\n// ─── 파싱 결과 (discriminated union) ────────────────\n\n/** 감지된 파일 형식 */\nexport type FileType = \"hwpx\" | \"hwp\" | \"hwp3\" | \"hwpml\" | \"pdf\" | \"xlsx\" | \"xls\" | \"docx\" | \"pptx\" | \"image\" | \"unknown\"\n\ninterface ParseResultBase {\n  fileType: FileType\n  /** 페이지/섹션 수 — PDF: 실제 페이지 수, HWP/HWPX: 섹션 수, XLSX: 시트 수 */\n  pageCount?: number\n  /** 이미지 기반 PDF 여부 (텍스트 추출 불가) */\n  isImageBased?: boolean\n}\n\nexport interface ParseSuccess extends ParseResultBase {\n  success: true\n  /** 추출된 마크다운 텍스트 */\n  markdown: string\n  /**\n   * 중간 표현 블록 (구조화된 데이터 접근용).\n   * 블록은 문서(원문) 읽기 순서를 따른다 — 한 문단 안에 글자취급(treatAsChar)\n   * 표와 텍스트가 섞여 있어도 배치 순서대로 방출된다 (v4.2.3, #50).\n   */\n  blocks: IRBlock[]\n  /** 문서 메타데이터 */\n  metadata?: DocumentMetadata\n  /** 문서 구조 (헤딩 트리) — v2.0 */\n  outline?: OutlineItem[]\n  /** 파싱 중 발생한 경고 — v2.0 */\n  warnings?: ParseWarning[]\n  /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */\n  images?: ExtractedImage[]\n  /**\n   * 페이지별 마크다운 (#68) — `blocks` 의 `pageNumber` 로 갈라 페이지마다 다시\n   * 마크다운을 만든 것. 페이지 경계의 신뢰도는 `metadata.pageMode` 를 따른다\n   * (\"layout\" = 실제 페이지, \"section\" = 섹션 근사). `pages` 옵션으로 범위를\n   * 줄이면 그 범위만 담긴다. 페이지 번호를 매기지 않는 포맷(DOCX 등)에서는 없고,\n   * XLSX 는 `pageCount` 와 같은 의미로 시트 한 장이 한 쪽이다.\n   *\n   * 여러 페이지에 걸친 표는 시작 페이지 한 블록이라, 표가 이어지는 중간\n   * 페이지의 `markdown` 은 빈 문자열일 수 있다 (현 IR 구조의 한계).\n   */\n  pages?: PageMarkdown[]\n  /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */\n  pageQuality?: PageQuality[]\n  /** 문서 단위 품질 요약 — PDF에서만 제공 */\n  qualitySummary?: DocumentQualitySummary\n}\n\n/** 페이지 한 장의 마크다운 (#68). ParseSuccess.pages 항목. */\nexport interface PageMarkdown {\n  /** 원본 페이지 번호 (1-based) */\n  pageNumber: number\n  /** 그 페이지 블록만으로 만든 마크다운. 블록이 없으면 빈 문자열 */\n  markdown: string\n}\n\n/** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */\nexport interface PageQuality {\n  page: number\n  textChars: number\n  hangulRatio: number\n  controlCharRatio: number\n  replacementCharRatio: number\n  puaRatio: number\n  needsOcr: boolean\n  ocrReason?: \"vector_text\" | \"low_text\" | \"high_pua\" | \"high_control\" | \"high_replacement\" | \"garbled_hangul\"\n}\n\n/** 문서 단위 품질 요약 (PDF 전용). */\nexport interface DocumentQualitySummary {\n  totalPages: number\n  totalTextChars: number\n  avgHangulRatio: number\n  avgControlCharRatio: number\n  avgReplacementCharRatio: number\n  avgPuaRatio: number\n  lowTextPageCount: number\n  highPuaPageCount: number\n  needsOcr: boolean\n  ocrCandidatePages: number[]\n}\n\n/** 추출된 이미지 — ParseSuccess.images에 포함 */\nexport interface ExtractedImage {\n  /** 마크다운에서 참조되는 파일명 (예: image_001.png) */\n  filename: string\n  /** 이미지 바이너리 */\n  data: Uint8Array\n  /** MIME 타입 */\n  mimeType: string\n  /** 원본 컨테이너 내 항목명 (HWPX/DOCX ZIP 경로, HWP5 BinData 스토리지명 — PDF 등 합성 이미지는 없음, #70) */\n  source?: string\n}\n\nexport interface ParseFailure extends ParseResultBase {\n  success: false\n  /** 오류 메시지 */\n  error: string\n  /** 구조화된 에러 코드 */\n  code?: ErrorCode\n}\n\nexport type ParseResult = ParseSuccess | ParseFailure\n\n// ─── 문서 비교 (Diff) ───────────────────────────────\n\nexport type DiffChangeType = \"added\" | \"removed\" | \"modified\" | \"unchanged\"\n\nexport interface BlockDiff {\n  type: DiffChangeType\n  /** 원본 블록 (added이면 undefined) */\n  before?: IRBlock\n  /** 변경 후 블록 (removed이면 undefined) */\n  after?: IRBlock\n  /** modified 테이블의 셀 단위 diff */\n  cellDiffs?: CellDiff[][]\n  /** 유사도 (0-1) */\n  similarity?: number\n}\n\nexport interface CellDiff {\n  type: DiffChangeType\n  before?: string\n  after?: string\n}\n\nexport interface DiffResult {\n  stats: { added: number; removed: number; modified: number; unchanged: number }\n  diffs: BlockDiff[]\n}\n\n// ─── 라운드트립 패치 (v3.0) ─────────────────────────\n\n/** 패치 중 매핑 실패/미지원으로 건너뛴 항목 — silent 실패 금지 */\nexport interface PatchSkip {\n  /** 건너뛴 사유 */\n  reason: string\n  /** 원본 쪽 내용 요약 (최대 80자) */\n  before?: string\n  /** 편집 쪽 내용 요약 (최대 80자) */\n  after?: string\n  /**\n   * 부분 적용 표시 — 변경이 적용은 됐지만(applied 계상) 편집 원형 그대로는\n   * 아님 (예: 셀 내 줄 추가를 마지막 문단에 병합). 완전 미적용 skip과 구분.\n   */\n  partial?: boolean\n}\n\n/** patchHwpx 옵션 */\nexport interface PatchOptions {\n  /** 패치 후 재파싱 자동 검증 (기본 true) */\n  verify?: boolean\n}\n\n/** patchHwpx / patchBlocks 결과 */\nexport interface PatchResult {\n  success: boolean\n  /** 패치된 HWPX (success=true) */\n  data?: Uint8Array\n  /** 적용된 변경 수 */\n  applied: number\n  /** 매핑 실패 항목 (이유 포함) */\n  skipped: PatchSkip[]\n  /**\n   * 무손실 검증 (patchHwpx/patchHwp 전용): 패치본 재파싱 vs 편집 마크다운의\n   * 잔차 diff — modified/added/removed가 0이어야 의도가 전부 반영된 것.\n   * session.patchBlocks는 이 필드를 채우지 않는다 (changes 참조).\n   */\n  verification?: DiffResult\n  /**\n   * 변경 가시화 (session.patchBlocks 전용): 패치 전 → 후 문서 diff —\n   * 적용된 편집 수만큼 modified가 나오는 것이 정상. verification과 의미가\n   * 정반대이므로 혼용 금지.\n   */\n  changes?: DiffResult\n  /** 실패 사유 (success=false) */\n  error?: string\n}\n\n// ─── 양식 인식 ──────────────────────────────────────\n\nexport interface FormField {\n  label: string\n  value: string\n  /** 0-based 소스 행 */\n  row: number\n  /** 0-based 소스 열 */\n  col: number\n  /** 매칭된 입력 키(정규화) — 모호 라벨 거부 가드(fillWithUniqueGuard)의 집계 기준 */\n  key?: string\n  /** 매칭 근거. `clickhere`(누름틀 name 정확 일치)는 서식 제작자가 선언한 계약이라\n   *  여러 곳에 같은 이름이 있어도 \"모호\"가 아니다 — 모호 라벨 거부 집계에서 제외된다.\n   *  (머리말·본문에 같은 이름의 누름틀을 두는 서식이 실제로 있다) */\n  source?: \"clickhere\"\n}\n\nexport interface FormResult {\n  fields: FormField[]\n  /** 양식 확신도 (0-1) */\n  confidence: number\n}\n\n// ─── OCR 프로바이더 ─────────────────────────────────\n\n/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 반환.\n *  PDF 경로는 항상 \"image/png\", 이미지 직접 입력 경로는 원본 mime 그대로 전달. */\nexport type OcrProvider = (\n  pageImage: Uint8Array,\n  pageNumber: number,\n  mimeType: \"image/png\" | \"image/jpeg\" | \"image/webp\"\n) => Promise<string>\n\n// ─── Watch 모드 ─────────────────────────────────────\n\nexport interface WatchOptions {\n  dir: string\n  outDir?: string\n  webhook?: string\n  format?: \"markdown\" | \"json\"\n  pages?: string\n  silent?: boolean\n}\n\n// ─── 헤딩 감지 공통 임계값 ──────────────────────────\n\n/** 폰트 크기 비율 → heading level (전 파서 공통) */\nexport const HEADING_RATIO_H1 = 1.5\nexport const HEADING_RATIO_H2 = 1.3\nexport const HEADING_RATIO_H3 = 1.15\n\n// ─── 내부 파서 반환 타입 ─────────────────────────────\n\n/** 내부 파서가 index.ts에 반환하는 공통 타입 (HWP5/HWPX/PDF/XLSX/DOCX) */\nexport interface InternalParseResult {\n  markdown: string\n  blocks: IRBlock[]\n  metadata?: DocumentMetadata\n  outline?: OutlineItem[]\n  warnings?: ParseWarning[]\n  images?: ExtractedImage[]\n  /** PDF 전용: 이미지 기반 PDF 여부 */\n  isImageBased?: boolean\n  /** PDF 전용: 페이지별 품질 신호 */\n  pageQuality?: PageQuality[]\n  /** PDF 전용: 문서 단위 품질 요약 */\n  qualitySummary?: DocumentQualitySummary\n  /** PDF 전용: 페이지별 마크다운 — 문서 마크다운과 같은 PDF 마무리(1×1 표 펴기·cleanPdfText)를 쪽마다 적용한 것 */\n  pages?: PageMarkdown[]\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/script-tags.ts","../src/table/layout-frames.ts","../src/types.ts"],"sourcesContent":["/**\n * 위·아래첨자 표지 — 파서가 첨자 글을 인라인 HTML `<sup>`·`<sub>` 로 감싸 IR 글에 넣는다(밑줄 `<u>` 와 같은 방식,\n * GFM 에 첨자 문법이 없다). 평문으로 펴면 \"10⁴ m²\" 가 \"104 m2\", \"x_i\" 가 \"xi\" 로 값이 바뀐다.\n * HWPX·HWP5·DOCX 는 글자 모양 속성, PDF 는 기준선·글자 크기로 판정한다.\n */\n\nimport type { IRBlock } from \"./types.js\"\n\nexport type ScriptKind = \"sup\" | \"sub\"\n\n/** 원문 글자 가운데 파서가 넣는 표지(<u>·<sup>·<sub>)와 같은 꼴의 `<` */\nconst LITERAL_TAG = /<(?=\\/?(?:u|sup|sub)>)/g\n\n/**\n * IR 글 규약: 원문 글자 \"<sub>\"·\"</sup>\"·\"<u>\" 의 `<` 는 `\\<` 로 담는다(리터럴 `$` → `\\$` 와 같은 규약, escapeLiteralDollar).\n * 파서가 넣는 첨자·밑줄 표지와 같은 꼴이면 첨자 끔(stripScriptTags)·평문(plainScripts)·태그 정리(tidyScriptTags)가 원문 글자까지\n * 걷거나 고쳤다(#122 \"Close it with </sup> please.\" → \"Close it with  please.\"). `\\<` 는 CommonMark 이스케이프라 렌더는 `<` 그대로\n */\nexport function escapeLiteralTags(text: string): string {\n  return text.includes(\"<\") ? text.replace(LITERAL_TAG, \"\\\\<\") : text\n}\n\n/** 첨자 글을 태그로 감싼다 — 앞뒤 공백은 태그 밖으로, 공백뿐이면 그대로 */\nexport function wrapScript(text: string, kind: ScriptKind | null | undefined): string {\n  if (!kind) return text\n  const m = /^(\\s*)([\\s\\S]*?)(\\s*)$/.exec(text)!\n  return m[2] ? `${m[1]}<${kind}>${m[2]}</${kind}>${m[3]}` : text\n}\n\n/** 조각마다 감싼 태그 정리 — 이웃한 같은 태그를 합치고, 태그 안 앞뒤 공백을 밖으로 내고, 빈 태그를 지운다 */\nexport function tidyScriptTags(text: string): string {\n  if (!text.includes(\"<su\")) return text\n  // 이스케이프된 \\< 는 원문 글자 (escapeLiteralTags)\n  return text\n    .replace(/(?<!\\\\)<\\/(sup|sub)><\\1>/g, \"\")\n    .replace(/(?<!\\\\)<(sup|sub)>(\\s+)/g, \"$2<$1>\")\n    .replace(/(\\s+)<\\/(sup|sub)>/g, \"</$2>$1\")\n    .replace(/(?<!\\\\)<(sup|sub)><\\/\\1>/g, \"\")\n}\n\n/**\n * 평문(`plain`) 표기 — 태그를 걷되 값이 바뀌지 않게 `^`·`_` 로: \"10^4\"·\"m^2\"·\"H_2O\"·\"x^(n+1)\".\n * 글자·숫자(와 앞 부호)만이거나 주석 기호뿐이면 괄호 없이, 그 밖은 괄호로 묶는다.\n */\nexport function plainScripts(md: string): string {\n  if (!md.includes(\"<su\")) return md\n  return md.replace(/(?<!\\\\)<(sup|sub)>([^<\\n]*)<\\/\\1>/g, (_, kind: string, body: string) => {\n    const mark = kind === \"sup\" ? \"^\" : \"_\"\n    return /^(?:[+\\-−]?[\\p{L}\\p{N}]+|[*∗†‡§¶]+)$/u.test(body) ? mark + body : `${mark}(${body})`\n  })\n}\n\n/** 파서가 넣은 첨자 표지 — 이스케이프된 \\< 는 원문 글자 (escapeLiteralTags) */\nconst TAG_RE = /(?<!\\\\)<\\/?su[bp]>/g\n\n/**\n * 첨자 표기를 끈 결과(`scriptTags: false`, PDF·이미지 기본) — 마크다운·쪽별 마크다운·IR 글(문단·span·각주·목록·표 칸·캡션)에서\n * 태그만 걷는다. 파이프라인은 그대로 돌고 끝에서 걷으므로 글자 순서는 첨자 판정 전과 같다\n */\nexport function stripScriptTags<T extends { markdown?: string; blocks?: IRBlock[]; pages?: Array<{ markdown: string }> }>(r: T): T {\n  const s = (t: string) => (t.includes(\"<su\") ? t.replace(TAG_RE, \"\") : t)\n  const walk = (bs: IRBlock[] | undefined): void => {\n    for (const b of bs ?? []) {\n      if (b.text) b.text = s(b.text)\n      if (b.footnoteText) b.footnoteText = s(b.footnoteText)\n      for (const sp of b.spans ?? []) sp.text = s(sp.text)\n      walk(b.children)\n      if (b.table) {\n        if (b.table.caption) b.table.caption = s(b.table.caption)\n        walk(b.table.captionBlocks)\n        for (const row of b.table.cells) for (const c of row) { c.text = s(c.text); walk(c.blocks) }\n      }\n    }\n  }\n  walk(r.blocks)\n  if (r.markdown) r.markdown = s(r.markdown)\n  for (const p of r.pages ?? []) p.markdown = s(p.markdown)\n  return r\n}\n","/**\n * 보이지 않는 틀 표 풀기 — 한글 문서는 테두리를 없앤 표로 쪽을 짜는 일이 흔하다. 법령 별표 272건 중 103건이 본문 전체를\n * 안 보이는 틀 표에 담았고 표 381개 중 95개는 보이는 변이 하나도 없다(2026-09-29 실측). 구조대로 표로 내면 화면·LLM 이\n * 원본에 없는 격자를 본다(할부거래법 시행령 [별표 1]: 원본은 글과 분수뿐인데 5열 표 한 장).\n *\n * 칸마다 보이는 변(`CELL_EDGES` — HWPX borderFill·HWP5 BORDER_FILL·PDF 획)으로 두 가지를 한다.\n *  ① 분수 — 위아래로 붙은 두 칸 사이 가로선만 보이고 두 칸의 다른 변이 모두 안 보이는 짧은 한 줄 칸 쌍은 분수를 칸으로\n *     조립한 것이다(할부거래법 \"A=P×r× (1+r)ⁿ / (1+r)ⁿ-1\"). 한 칸 `$\\frac{위}{아래}$` 로 합친다.\n *  ② 행 띠 — 세로선이 보이는 행과, 위아래 가로선이 온 폭에 그어진 사이에 칸이 둘 이상인 행(가로선만 긋는 표)은 표 띠다.\n *     이어진 표 띠만 새 표로 다시 짜고(띠 안에서 쓰지 않는 행·열 경계와 선 밖 빈 칸은 접음) 나머지 행은 칸 글을 문단으로\n *     푼다. 칸 안 블록(중첩표)은 재귀로 같은 처리. 표 띠 칸 안의 중첩표도 본다.\n * 테두리 정보가 하나도 없는 표(다른 포맷)는 손대지 않는다. 호출자는 파서가 마크다운을 만들기 직전 — 왕복 패치·양식 채우기처럼\n * 원 구조가 필요한 경로는 `layoutTables: \"keep\"` 으로 건너뛴다.\n */\n\nimport type { IRBlock, IRCell, IRTable } from \"../types.js\"\nimport { visibleText } from \"./builder.js\"\n\n/** 칸의 보이는 변 */\nexport interface Edges { t: boolean; b: boolean; l: boolean; r: boolean }\n\n/** IR 칸 → 보이는 변. 공개 IR 에는 나가지 않는 곁정보 (파서가 채움) */\nexport const CELL_EDGES = new WeakMap<IRCell, Edges>()\n/** 쪽 넘김으로 이은 표에서 첫 쪽 뒤에 놓인 칸 → 그 쪽 번호 (PDF 쪽 넘김 잇기가 채움, #136). 표를 풀어 낸 문단과 쪽별 마크다운이\n *  칸이 놓인 쪽을 따른다. 표시가 없는 칸은 표 블록의 쪽이다 */\nexport const CELL_PAGES = new WeakMap<IRCell, number>()\n/** 글·블록 없이도 내용이 있는 칸 — PDF 는 칸 그림을 칸 글과 따로 뽑아 그림 칸의 text·blocks 가 빈다. 빈 여백 행 접기가 그림 행을\n *  접지 않게 파서가 표시한다 (경찰복제 [별표] 특수복식 도면 행) */\nexport const CONTENT_CELLS = new WeakSet<IRCell>()\n\n/** 칸 글 줄마다의 기준선 y (위→아래, 칸 text 의 줄과 같은 수일 때만 쓴다) — PDF 가 칸 글줄 기하로 채운다. 목차 행의 제목 줄과\n *  쪽 번호 줄을 짝짓는다 (textRow) */\nexport const CELL_BASELINES = new WeakMap<IRCell, number[]>()\n\n/** 분수 칸 글 상한(자) — 분자·분모는 식 조각이다. 문장 칸이 가로선 하나로 나뉜 것과 가른다 */\nconst FRACTION_MAX_CHARS = 40\n\ninterface Anchor { r: number; c: number; rs: number; cs: number; cell: IRCell }\n\nfunction anchorsOf(t: IRTable): Anchor[] {\n  const out: Anchor[] = []\n  const covered = new Set<number>()\n  for (let r = 0; r < t.rows; r++) for (let c = 0; c < t.cols; c++) {\n    if (covered.has(r * t.cols + c)) continue\n    const cell = t.cells[r]?.[c]\n    if (!cell) continue\n    const rs = Math.max(1, Math.min(cell.rowSpan, t.rows - r)), cs = Math.max(1, Math.min(cell.colSpan, t.cols - c))\n    for (let dr = 0; dr < rs; dr++) for (let dc = 0; dc < cs; dc++) covered.add((r + dr) * t.cols + c + dc)\n    out.push({ r, c, rs, cs, cell })\n  }\n  return out\n}\n\n/** 단위 격자의 보이는 가로선 H[r][c](행 r 윗변)·세로선 V[r][c](열 c 왼변) — 맞닿은 두 칸 가운데 하나라도 그으면 보인다 */\nfunction ruleGrids(t: IRTable, anchors: Anchor[]): { H: boolean[][]; V: boolean[][] } {\n  const H = Array.from({ length: t.rows + 1 }, () => new Array<boolean>(t.cols).fill(false))\n  const V = Array.from({ length: t.rows }, () => new Array<boolean>(t.cols + 1).fill(false))\n  for (const a of anchors) {\n    // 테두리 정보가 없는 칸은 보이는 칸으로 둔다 — 모르면 표를 지키는 쪽이다\n    const e = CELL_EDGES.get(a.cell) ?? { t: true, b: true, l: true, r: true }\n    for (let c = a.c; c < a.c + a.cs; c++) { if (e.t) H[a.r][c] = true; if (e.b) H[a.r + a.rs][c] = true }\n    for (let r = a.r; r < a.r + a.rs; r++) { if (e.l) V[r][a.c] = true; if (e.r) V[r][a.c + a.cs] = true }\n  }\n  return { H, V }\n}\n\n/** 분자·분모 글 → LaTeX. 첨자 태그는 ^{}·_{}, 한글 낱말은 \\text{} */\nfunction toTex(s: string): string {\n  // IR 이스케이프(리터럴 \\$, 태그 꼴 글자 \\<sub>)는 먼저 원래 글자로 — 그대로 두면 역슬래시가 다시 이스케이프돼 \"\\\\\\$5\"(LaTeX 줄바꿈)가\n  // 되고, 글자 \"<sub>\" 가 아래첨자가 됐다. 태그 꼴 글자는 첨자 변환이 끝난 뒤 되돌린다\n  return s\n    .replace(/\\\\\\$/g, \"$\")\n    .replace(/\\\\</g, \"\\u0001\")\n    .replace(/<\\/?u>/g, \"\")\n    .replace(/([\\\\{}%#&_$])/g, \"\\\\$1\")\n    .replace(/<sup>(.*?)<\\/sup>/g, \"^{$1}\")\n    .replace(/<sub>(.*?)<\\/sub>/g, \"_{$1}\")\n    .replace(/\\u0001/g, \"<\")\n    .replace(/[가-힣ㄱ-ㅎㅏ-ㅣ][가-힣ㄱ-ㅎㅏ-ㅣ\\s·ㆍ]*/g, m => `\\\\text{${m.trim()}}`)\n    .trim()\n}\n\n/** 분수 조각 칸 — 한 줄 짧은 글, 블록 없음 */\nfunction fractionPart(cell: IRCell): boolean {\n  const t = cell.text.trim()\n  return !!t && !t.includes(\"\\n\") && !cell.blocks?.length && t.replace(/<\\/?(?:u|sup|sub)>/g, \"\").length <= FRACTION_MAX_CHARS\n    && !/(?<!\\\\)\\$/.test(t)\n}\n\n/** ① 칸으로 조립한 분수를 한 칸으로 합친다. 합친 쌍이 있으면 true (anchors·격자는 새로 만들어야 함) */\nfunction mergeFractions(t: IRTable, anchors: Anchor[], H: boolean[][], V: boolean[][]): boolean {\n  const at = new Map<number, Anchor>()\n  for (const a of anchors) at.set(a.r * t.cols + a.c, a)\n  let merged = false\n  for (const u of anchors) {\n    const d = at.get((u.r + u.rs) * t.cols + u.c)\n    if (!d || d.cs !== u.cs || u.rs !== 1 || d.rs !== 1 || !fractionPart(u.cell) || !fractionPart(d.cell)) continue\n    // 표 온 폭을 차지하는 두 칸은 칸 두 개짜리 표(2×1 분수 표)일 때만 — 서식 끝 \"…귀하\"·\"210mm×297mm\" 칸, 제목과 본문 줄이\n    // 가로선 하나로 나뉜 모양이 분수로 잡혔다 (정답 그림 대조: 오탐 10건 → 0, 진짜 분수 9개 유지)\n    // 옆 열이 빈 여백 칸뿐이어도 온 폭과 같다 (임금채권보장법 시행규칙 재산목록: 왼쪽 빈 열 하나 때문에 \"…장 귀하\"·\"210mm×297mm\" 가 분수로)\n    const besideText = anchors.some(a => a !== u && a !== d && a.r <= d.r && a.r + a.rs > u.r && a.cell.text.trim())\n    if (!besideText && anchors.filter(a => a.cell.text.trim()).length !== 2) continue\n    const bar = d.r, c1 = u.c, c2 = u.c + u.cs\n    // 막대: 두 칸 사이 가로선이 두 칸 폭에만 — 옆 칸까지 이어지면 가로선만 긋는 표의 행 구분이다\n    let ok = true\n    for (let c = c1; c < c2 && ok; c++) if (!H[bar][c]) ok = false\n    if (!ok || (c1 > 0 && H[bar][c1 - 1]) || (c2 < t.cols && H[bar][c2])) continue\n    // 두 칸의 나머지 변은 모두 안 보여야 한다 (위·아래·좌·우)\n    for (let c = c1; c < c2 && ok; c++) if (H[u.r][c] || H[d.r + d.rs][c]) ok = false\n    for (let r = u.r; r < d.r + d.rs && ok; r++) if (V[r][c1] || V[r][c2]) ok = false\n    if (!ok) continue\n    u.cell.text = `$\\\\frac{${toTex(u.cell.text)}}{${toTex(d.cell.text)}}$`\n    u.cell.rowSpan = u.rs + d.rs\n    t.cells[d.r][d.c] = { text: \"\", colSpan: 1, rowSpan: 1 }\n    at.delete(d.r * t.cols + d.c)\n    merged = true\n  }\n  return merged\n}\n\n/** 표 띠 행 — 세로선이 보이거나, 온 폭 가로선 사이에 칸이 둘 이상 */\nfunction ruledRows(t: IRTable, anchors: Anchor[], H: boolean[][], V: boolean[][]): boolean[] {\n  const inRow = new Array<number>(t.rows).fill(0)\n  for (const a of anchors) for (let r = a.r; r < a.r + a.rs; r++) inRow[r]++\n  return Array.from({ length: t.rows }, (_, r) =>\n    V[r].some(Boolean) || (inRow[r] >= 2 && H[r].every(Boolean) && H[r + 1].every(Boolean)))\n}\n\n/** 표 띠 [r0, r1] → 새 표. 띠 안에서 시작하는 칸만, 띠 밖으로 나가는 병합은 자른다. 선 밖 빈 칸·안 쓰는 경계는 접는다 */\nfunction bandTable(t: IRTable, anchors: Anchor[], V: boolean[][], H: boolean[][], r0: number, r1: number, keepEmptyCols: boolean): IRTable | null {\n  let list = anchors.filter(a => a.r >= r0 && a.r <= r1).map(a => ({ ...a, rs: Math.min(a.rs, r1 - a.r + 1) }))\n  const blank = (a: Anchor): boolean => {\n    if (CONTENT_CELLS.has(a.cell)) return false\n    if (!a.cell.blocks?.length) return !a.cell.text.trim()\n    return a.cell.blocks.every(b => (b.type === \"paragraph\" || b.type === \"heading\") && !visibleText(b).trim() && !b.footnoteText)\n  }\n  // 선이 닿는 열 범위 — 선 밖 빈 들여쓰기 칸부터 빼야 그 칸을 표 행의 시작으로 세지 않는다.\n  let lo = Infinity, hi = -Infinity\n  for (let r = r0; r <= r1; r++) {\n    for (let c = 0; c <= t.cols; c++) if (V[r][c]) { lo = Math.min(lo, c); hi = Math.max(hi, c) }\n    for (const rr of [r, r + 1]) for (let c = 0; c < t.cols; c++) if (H[rr][c]) { lo = Math.min(lo, c); hi = Math.max(hi, c + 1) }\n  }\n  // 한쪽 세로선만 있는 입력 항목도 경계가 알려져 있다(lo === hi). 선 밖 글·그림은 보존한다.\n  if (Number.isFinite(lo)) list = list.filter(a => a.c < hi && a.c + a.cs > lo || !blank(a))\n  if (!list.length) return null\n  // 선 없이 붙은 빈 여백 행 — 그 행에서 시작하는 칸이 모두 비었고 윗선이나 아랫선이 표 폭 어디에도 없으면 그림에서 이웃 행과\n  // 한 행이다. 접는다 (양곡관리법·에너지이용 합리화법 별표 여백 행, 근로기준법 [별표 6] 여백 행 10개 — 정답 그림 대조 42→48/50.\n  // 윗선·아랫선 둘 다 없을 때만 접으면 에너지이용 합리화법 두 표가 안 접힌다)\n  const drop: number[] = []\n  for (let r = r0; r <= r1; r++) {\n    const starts = list.filter(a => a.r === r)\n    // 시작 칸이 없는 행은 위 칸의 병합 덮개다. 실제 빈 여백 칸이 있는 행만 접는다.\n    if (starts.length && (!H[r].some(Boolean) || !H[r + 1].some(Boolean)) && starts.every(blank)) drop.push(r)\n  }\n  if (drop.length) {\n    const shift = (y: number): number => y - drop.filter(d => d < y).length\n    list = list.filter(a => !drop.includes(a.r))\n      .map(a => ({ ...a, r: shift(a.r), rs: shift(a.r + a.rs) - shift(a.r) }))\n      .filter(a => a.rs > 0)\n  }\n  // 후행 빈 열 — 띠에서 오른쪽 끝 열이 비면 자른다. 원래 표를 만들 때 builder 가 하는 트림(마크다운 가독성)을 띠 표에도 똑같이:\n  // 표 전체로는 글이 있어 남은 열이 한 띠에서만 비는 경우다(결재문서 점검표 \"□ | ■ | (빈 칸)\" — 생성 → 재파싱 왕복이 어긋났다).\n  // keepTrailingEmptyCols(#47 서식 입력란)면 builder 처럼 두고\n  // 빈 띠도 HTML로 남긴다. 후행 열 정리는 마지막 앵커를 지우기 전에 멈춘다.\n  const emptyBand = list.every(blank)\n  for (let right = keepEmptyCols ? 0 : Math.max(...list.map(a => a.c + a.cs)); right > 1;) {\n    const starts = list.filter(a => a.c === right - 1)\n    if (!starts.length || !starts.every(blank) || starts.length === list.length) break\n    list = list.filter(a => a.c !== right - 1).map(a => (a.c + a.cs === right ? { ...a, cs: a.cs - 1 } : a))\n    right--\n  }\n  const colB = new Set<number>(), rowB = new Set<number>()\n  for (const a of list) { colB.add(a.c); colB.add(a.c + a.cs); rowB.add(a.r); rowB.add(a.r + a.rs) }\n  const cx = [...colB].sort((x, y) => x - y), rx = [...rowB].sort((x, y) => x - y)\n  const cols = cx.length - 1, rows = rx.length - 1\n  if (cols < 1 || rows < 1) return null\n  const cells: IRCell[][] = Array.from({ length: rows }, () => Array.from({ length: cols }, () => ({ text: \"\", colSpan: 1, rowSpan: 1 })))\n  for (const a of list) {\n    const r = rx.indexOf(a.r), c = cx.indexOf(a.c)\n    a.cell.rowSpan = rx.indexOf(a.r + a.rs) - r\n    a.cell.colSpan = cx.indexOf(a.c + a.cs) - c\n    cells[r][c] = a.cell\n  }\n  return { rows, cols, cells, hasHeader: t.hasHeader, ...(emptyBand ? { renderAsTable: true } : {}) }\n}\n\n/** 목차 행 — 제목 칸과 쪽 번호 칸(\"1. 직업계고 현장실습의 이해⏎2. 현장실습 운영지원 | 2⏎8\")을 기준선으로 짝지은 줄들. 칸 글을 통째로\n *  이으면 제목을 다 읽은 뒤 쪽 번호만 몰렸다(현장실습 매뉴얼 목차 \"…운영지원 2 8\"). 쪽 번호 없는 줄(장 제목)은 홀로 선다. 짝이 안 맞으면 null */\nfunction tocLines(cells: IRCell[]): string[] | null {\n  if (cells.length !== 2) return null\n  const [titles, pages] = cells.map(c => c.text.trim().split(\"\\n\").map(l => l.trim()))\n  const [ty, py] = cells.map(c => CELL_BASELINES.get(c))\n  if (!ty || !py || ty.length !== titles.length || py.length !== pages.length || titles.length < 2 ||\n      !pages.every(l => /^\\d{1,4}$/.test(l)) || titles.some(l => !l || /^\\d{1,4}$/.test(l))) return null\n  const lines = [...titles], taken = new Set<number>()\n  for (let j = 0; j < pages.length; j++) {\n    const i = ty.findIndex(y => Math.abs(y - py[j]) <= 3)\n    if (i < 0 || taken.has(i)) return null\n    taken.add(i)\n    lines[i] += \" \" + pages[j]\n  }\n  return lines\n}\n\n/** 글 띠 행 → 문단. 칸이 하나면 칸 안 줄마다, 여럿이면 칸 글을 공백으로 이은 한 문단(목차 행은 줄마다 \"제목 쪽\"). 칸 블록은 재귀로 푼다 */\nfunction textRow(row: Anchor[], out: IRBlock[], pageNumber: number | undefined, keepEmptyCols: boolean): void {\n  const parts: string[] = []\n  const cells: IRCell[] = []\n  const flush = (): void => {\n    if (!parts.length) return\n    const toc = tocLines(cells)\n    if (toc) {\n      for (const line of toc) out.push({ type: \"paragraph\", text: line, pageNumber })\n    } else if (parts.length === 1) {\n      for (const line of parts[0].split(\"\\n\")) if (line.trim()) out.push({ type: \"paragraph\", text: line.trim(), pageNumber })\n    } else {\n      const text = parts.map(p => p.replace(/\\s*\\n\\s*/g, \" \").trim()).filter(Boolean).join(\" \")\n      if (text) out.push({ type: \"paragraph\", text, pageNumber })\n    }\n    parts.length = 0\n    cells.length = 0\n  }\n  for (const a of row) {\n    if (a.cell.blocks?.length) {\n      flush()\n      out.push(...unframeLayoutTables(a.cell.blocks, keepEmptyCols))\n      continue\n    }\n    if (a.cell.text.trim()) { parts.push(a.cell.text.trim()); cells.push(a.cell) }\n  }\n  flush()\n}\n\n/** 표 하나 → 풀어낸 블록. 바꿀 게 없으면 null (원래 표 그대로) */\nfunction unframeTable(t: IRTable, pageNumber: number | undefined, keepEmptyCols: boolean): IRBlock[] | null {\n  let anchors = anchorsOf(t)\n  if (!anchors.some(a => CELL_EDGES.has(a.cell))) return null\n  let { H, V } = ruleGrids(t, anchors)\n  if (mergeFractions(t, anchors, H, V)) {\n    anchors = anchorsOf(t)\n    ;({ H, V } = ruleGrids(t, anchors))\n  }\n  const ruled = ruledRows(t, anchors, H, V)\n  if (ruled.every(Boolean)) {\n    // 표 전체가 표 띠여도 안 쓰는 격자선·선 밖 빈 칸·빈 여백 행은 접는다(한글 편집기 격자에만 있는 선, 86712 규제영향분석서 10×8 → 10×5).\n    // 모양이 그대로면 원래 표 객체(sourceId·캡션·곁정보)를 둔다\n    const whole = bandTable(t, anchors, V, H, 0, t.rows - 1, keepEmptyCols)\n    if (!whole) return null\n    if (whole.rows === t.rows && whole.cols === t.cols) {\n      if (whole.renderAsTable) t.renderAsTable = true\n      return null\n    }\n    return [{ type: \"table\", table: { ...t, rows: whole.rows, cols: whole.cols, cells: whole.cells,\n      ...(whole.renderAsTable ? { renderAsTable: true } : {}) }, pageNumber }]\n  }\n  const out: IRBlock[] = []\n  if (t.captionBlocks?.length) out.push(...t.captionBlocks)\n  else if (t.caption) out.push({ type: \"paragraph\", text: t.caption, pageNumber })\n  // 쪽 넘김으로 이은 표는 행이 놓인 쪽을 칸 표시로 안다 (CELL_PAGES) — 풀어 낸 띠·문단도 그 쪽에\n  const rowPage = (r: number): number | undefined => {\n    const marks = anchors.filter(a => a.r === r).map(a => CELL_PAGES.get(a.cell)).filter((p): p is number => p !== undefined)\n    return marks.length ? Math.max(...marks) : pageNumber\n  }\n  for (let r = 0; r < t.rows;) {\n    if (ruled[r]) {\n      let r1 = r\n      while (r1 + 1 < t.rows && ruled[r1 + 1]) r1++\n      const sub = bandTable(t, anchors, V, H, r, r1, keepEmptyCols)\n      if (sub) out.push({ type: \"table\", table: sub, pageNumber: rowPage(r) })\n      r = r1 + 1\n      continue\n    }\n    textRow(anchors.filter(a => a.r === r).sort((x, y) => x.c - y.c), out, rowPage(r), keepEmptyCols)\n    r++\n  }\n  return out\n}\n\n/** 블록 목록의 보이지 않는 틀 표를 푼다 (표 띠에 남은 칸 안 블록까지). 새 배열을 돌려준다.\n *  keepEmptyCols = ParseOptions.keepTrailingEmptyCols (띠 표의 후행 빈 열을 자르지 않는다) */\nexport function unframeLayoutTables(blocks: IRBlock[], keepEmptyCols = false): IRBlock[] {\n  const out: IRBlock[] = []\n  for (const b of blocks) {\n    if (b.type !== \"table\" || !b.table) { out.push(b); continue }\n    if (b.table.captionBlocks?.length) b.table.captionBlocks = unframeLayoutTables(b.table.captionBlocks, keepEmptyCols)\n    const flat = unframeTable(b.table, b.pageNumber, keepEmptyCols)\n    const kept = flat ?? [b]\n    for (const k of kept) {\n      if (k.type === \"table\" && k.table) {\n        for (const row of k.table.cells) for (const cell of row) if (cell.blocks?.length) cell.blocks = unframeLayoutTables(cell.blocks, keepEmptyCols)\n      }\n      out.push(k)\n    }\n  }\n  return out\n}\n","/** kordoc 공통 타입 정의 */\n\n// ─── 중간 표현 (Intermediate Representation) ─────────\n\nexport interface CellContext {\n  text: string\n  colSpan: number\n  rowSpan: number\n  /** HWP5 셀 열 주소 (0-based) — 병합 테이블 배치용 */\n  colAddr?: number\n  /** HWP5 셀 행 주소 (0-based) — 병합 테이블 배치용 */\n  rowAddr?: number\n}\n\n/** 블록 타입 — v2.0에서 heading, list, image, separator 추가 */\nexport type IRBlockType = \"paragraph\" | \"table\" | \"heading\" | \"list\" | \"image\" | \"separator\"\n\n/** 인라인 강조 run-span — 문단 텍스트를 서식 단위로 쪼갠 조각 (텍스트 연결 = block.text) */\nexport interface IRSpan {\n  text: string\n  bold?: boolean\n  italic?: boolean\n  strike?: boolean\n  /** 밑줄 — 개정문 추가·변경 표시 등. GFM 문법이 없어 <u>…</u> 인라인 HTML 로 방출 */\n  underline?: boolean\n  code?: boolean\n  /**\n   * 미기입 누름틀의 안내문(HWPX CLICK_HERE, 수정 안 됨). 한컴은 화면에만 흐리게 보이고 인쇄하지 않는다.\n   * 블록 `text` 에는 남기고(양식 채우기·패치가 원문 자리와 맞대도록) 마크다운에서는 뺀다 (v4.14.3)\n   */\n  placeholder?: boolean\n}\n\nexport interface IRBlock {\n  type: IRBlockType\n  /** 블록 글. HWPX·HWP5·HWP3 은 원문의 리터럴 `$` 를 `\\$` 로 담고 `$…$`·`$$…$$` 는 수식 스팬에만 쓴다 (v4.14.3) */\n  text?: string\n  table?: IRTable\n  /** 헤딩 레벨 (1-6), type=\"heading\"일 때 사용 */\n  level?: number\n  /** 원본 페이지 번호 (1-based) */\n  pageNumber?: number\n  /** 바운딩 박스 — PDF에서만 제공 */\n  bbox?: BoundingBox\n  /** 텍스트 스타일 정보 (선택) */\n  style?: InlineStyle\n  /** 리스트 타입, type=\"list\"일 때 사용 */\n  listType?: \"ordered\" | \"unordered\"\n  /** 중첩 리스트 아이템 */\n  children?: IRBlock[]\n  /** 하이퍼링크 URL */\n  href?: string\n  /** 각주/미주 텍스트 (인라인 삽입용) */\n  footnoteText?: string\n  /** 이미지 데이터 (type=\"image\"일 때) */\n  imageData?: ImageData\n  /** 인라인 강조 run-span (선택 — kordoc 생성 hwpx 왕복 채널 + 외래 실속성 볼드/이탤릭).\n   *  존재하면 마크다운 변환이 **·*·` 마커를 재방출한다 */\n  spans?: IRSpan[]\n  /** 인용문 문단 (선택 — kordoc 생성 hwpx 왕복 채널) — 마크다운 변환이 \"> \" 접두 재방출 */\n  quote?: boolean\n  /**\n   * 문단 들여쓰기(HWPUNIT, 선택) — HWPX paraPr `<hh:margin>` 자식요소형 hc:left\n   * (+양수 hc:intent 첫줄분). 마크다운 방출엔 쓰지 않는 관찰 슬롯 — gongmun 리스트\n   * depth 재유도·양식 분석 등 소비자 몫 (v4.0.4)\n   */\n  indent?: number\n  /**\n   * gongmun 리스트 단계(1~7, 선택) — indent를 levelIndent 단위로 역산한 소비 결과\n   * (v4.0.5). md 리스트 문법과 충돌하는 부호('- '·'1) ') 문단에만 채워지며,\n   * 마크다운 변환이 2칸/단계 선행 공백을 방출해 재생성 시 depth가 복원된다\n   */\n  listDepth?: number\n}\n\n/** 추출된 이미지 바이너리 데이터 */\nexport interface ImageData {\n  /** 이미지 바이너리 */\n  data: Uint8Array\n  /** MIME 타입 (image/png, image/jpeg, image/gif, image/bmp, image/wmf, image/emf) */\n  mimeType: string\n  /** 원본 파일명 (있는 경우) */\n  filename?: string\n}\n\n/** 바운딩 박스 — PDF 포인트 단위 (72pt = 1인치) */\nexport interface BoundingBox {\n  page: number\n  x: number\n  y: number\n  width: number\n  height: number\n}\n\n/** 인라인 텍스트 스타일 */\nexport interface InlineStyle {\n  bold?: boolean\n  italic?: boolean\n  /** 취소선 — 법령 개정문 등의 삭제 표시. 판정은 취소선 모양 whitelist (비트만 믿으면 오탐) */\n  strike?: boolean\n  /** 밑줄 — 판정은 밑줄 종류 BOTTOM 한정 (NONE 이 기본 잡음, 코퍼스 실측) */\n  underline?: boolean\n  fontSize?: number\n  fontName?: string\n}\n\n// ─── 표 분류 계약 (#76) — 분류기 내부 점수 구조(TableSignals)는 노출하지 않는다 ───\n\nexport type TableClassificationKind = \"semantic-table\" | \"non-tabular-layout\" | \"uncertain\"\n\nexport type TableClassificationReason =\n  | \"repeated-row-schema\"\n  | \"grid-regularity\"\n  | \"high-active-density\"\n  | \"column-type-consistency\"\n  | \"nested-structure-wrapper\"\n  | \"span-irregularity\"\n  | \"spacer-bands\"\n  | \"extreme-sparsity\"\n  | \"diagram-context-keyword\"\n  | \"low-evidence\"\n  | \"ambiguous-scores\"\n\n/** 휴리스틱 분류 결과 — confidence 는 확률이 아니라 두 점수의 격차 */\nexport interface TableClassificationSummary {\n  kind: TableClassificationKind\n  confidence: number\n  semanticScore: number\n  nonTabularScore: number\n  reasons: TableClassificationReason[]\n}\n\nexport interface IRTable {\n  rows: number\n  cols: number\n  cells: IRCell[][]\n  /** PDF의 1열 데이터 표나 테두리가 있는 빈 입력란을 HTML 표로 유지한다. 목록성 틀의 평탄화와 구분한다. */\n  renderAsTable?: boolean\n  /** 첫 행을 헤더로 렌더링할지 여부 (현재: rows > 1이면 true — 의미적 감지가 아닌 레이아웃 힌트) */\n  hasHeader: boolean\n  /** opt-in 분류(`ParseOptions.classifyTables`) 결과 — #76 */\n  classification?: TableClassificationSummary\n  /** 원본 표 식별자(HWPX `hp:tbl id`) — 렌더 region(`RenderRegion.sourceId`)과의 조인 키 */\n  sourceId?: string\n  /** `tableFormat: \"gfm\"` 관계 표지의 표 id(`t1`, `t2` …) — 문서 블록 트리 전위 순회 순번. 그 옵션으로 렌더할 때만 채워진다(원본 id 아님) */\n  markdownId?: string\n  /** 렌더 인프라가 준 페이지 로컬 pt 조각(다중 페이지 표는 여럿) — extractTables 가 채운다 */\n  regions?: BoundingBox[]\n  /** 표 캡션 (예: \"표 1. 부서별 예산\") — v3.0 */\n  caption?: string\n  /**\n   * 캡션 내부 블록 콘텐츠 — v4.2.8 (#55).\n   * 캡션 안 중첩표·문단을 구조 그대로, 원문 순서대로 보존한다 (IRCell.blocks와 같은 계약).\n   * 표가 있을 때만 채워지며, caption은 하위 호환용 평탄화 문자열로 계속 제공된다.\n   */\n  captionBlocks?: IRBlock[]\n}\n\nexport interface IRCell {\n  text: string\n  colSpan: number\n  rowSpan: number\n  /**\n   * 셀 내부 블록 콘텐츠 — v3.0.\n   * 중첩 표·이미지 등 구조 콘텐츠(또는 왕복 채널 span 문단)가 있는 셀에만 채워지며,\n   * 그 안의 문단·표·이미지를 문서(원문) 순서대로 보존한다. 다중 문단뿐인 평문 셀은\n   * blocks 없이 text 평탄화(문단을 `\\n`으로 결합)로만 제공된다 (blocks 무게 억제, #57).\n   * 표와 텍스트가 한 줄에 번갈아 놓인 셀도 배치 순서를 따른다 (v4.2.3, #49).\n   * blocks가 있으면 text는 blocks의 평탄화 텍스트(하위 호환용)다.\n   */\n  blocks?: IRBlock[]\n  /** 제목 셀 여부 (HWP5 width_ref bit2 / HWPX header 속성) — v3.0 */\n  isHeader?: boolean\n}\n\n// ─── 메타데이터 ─────────────────────────────────────\n\n/** 문서 메타데이터 — 각 포맷에서 추출 가능한 필드만 채워짐 */\nexport interface DocumentMetadata {\n  /** 문서 제목 */\n  title?: string\n  /** 작성자 */\n  author?: string\n  /** 작성 프로그램 (예: \"한글 2020\", \"Adobe Acrobat\") */\n  creator?: string\n  /** 생성일시 (ISO 8601) */\n  createdAt?: string\n  /** 수정일시 (ISO 8601) */\n  modifiedAt?: string\n  /** 페이지/섹션 수 — pageMode=\"layout\"이면 실제 페이지 수, \"section\"이면 섹션 수 */\n  pageCount?: number\n  /**\n   * 페이지 경계 신뢰도 (#66) — \"layout\": 조판 정보 기반 실제 페이지\n   * (한컴 저장본 HWP/HWPX·PDF·COM, PPTX 슬라이드), \"section\": 섹션 단위 근사\n   * (조판 캐시 없는 생성 파일). HWP/HWPX/PDF·PPTX에서만 설정된다.\n   */\n  pageMode?: \"layout\" | \"section\"\n  /** 문서 포맷 버전 (예: HWP \"5.1.0.1\") */\n  version?: string\n  /** 설명 */\n  description?: string\n  /** 키워드 */\n  keywords?: string[]\n}\n\n// ─── 파싱 옵션 ──────────────────────────────────────\n\n/** 파싱 옵션 — parse() 함수에 전달 */\nexport interface ParseOptions {\n  /**\n   * 파싱할 페이지/섹션 범위 (1-based).\n   * - 배열: [1, 2, 3]\n   * - 문자열: \"1-3\", \"1,3,5-7\"\n   *\n   * PDF: 정확한 페이지 단위. HWP/HWPX: 섹션 단위 근사치.\n   */\n  pages?: number[] | string\n  /** 이미지 기반 PDF OCR (선택).\n   *  - 지정 안 함(기본): 내장 모델이 이미 캐시에 있으면(`kordoc models` 로 받았거나 앞서 `ocr: true` 로 받은 경우) 텍스트층이\n   *    없는 쪽(스캔·글자를 곡선으로 그린 쪽)과 글 없는 큰 그림(쪽 면적 5% 넘는) 속 글을 자동 인식한다. 모델이 없으면 다운로드하지\n   *    않고 NEEDS_OCR·SKIPPED_IMAGE 경고만.\n   *  - `false`: 끈다.\n   *  - `true`: 내장 엔진(PP-OCRv5 korean, ~18MB 자동 다운로드)으로 OCR 필요 판정\n   *    페이지만 인식 (스캔 페이지·글꼴 매핑 깨진 페이지). 정상 페이지는 파싱 결과 유지.\n   *  - `\"force\"`: 전 페이지를 내장 엔진으로 강제 OCR.\n   *  - 함수: 사용자 제공 OcrProvider (Claude Vision·Tesseract 등) — 판정은 `true`와 동일. */\n  ocr?: boolean | \"force\" | OcrProvider\n  /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */\n  onProgress?: (current: number, total: number) => void\n  /** PDF 머리글/바닥글 자동 제거 */\n  removeHeaderFooter?: boolean\n  /**\n   * 위·아래첨자를 인라인 HTML `<sup>`·`<sub>` 로 표기 — 평문으로 펴면 \"10⁴ m²\" 가 \"104 m2\", \"x_i\" 가 \"xi\" 로 값이 바뀐다.\n   * 기본: HWPX·HWP·DOCX 켬(글자 모양에 적힌 첨자), PDF 끔(글자 크기·기준선으로 추정 — 논문·수식 문서는 true 권장.\n   * 공개 벤치 ODL 정답이 첨자를 평문으로 적어 기본값을 두지 않는다). false 면 모든 형식에서 평문. OCR 로 읽은 글은 늘 평문\n   */\n  scriptTags?: boolean\n  /** 평문 Markdown — 그림 자리 표시·링크 URL·밑줄(`<u>`)·굵게(`**`) 표기를 빼고 글만 (제목·목록·표 구조는 유지).\n   *  첨자 `<sup>`·`<sub>` 는 값이 남게 `10^4`·`H_2O` 로 편다. 이미지 바이트를 따로 저장하지 않는 색인·RAG 용. 기본 false. `blocks` IR 은 그대로 */\n  plain?: boolean\n  /** 모든 표를 HTML 로 — 파이프 표도 HTML 표로 옮기고, 표마다 태그를 한 줄씩 들여써 낸다(BeautifulSoup prettify 모양, 첫 행 `<th>`).\n   *  HTML 표만 다루는 소비자·채점기용. 기본 false(병합·중첩 없는 표는 GFM 파이프 표) */\n  htmlTables?: boolean\n  /** `\"gfm\"`: 모든 표를 HTML 없이 GFM 파이프 표로 — 세로 병합 칸은 덮인 행마다 같은 값, 가로 병합 칸은 시작 칸에만 값, 셀 안 표는 부모 표 뒤 독립 표로 꺼내고\n   *  부모·자식 관계를 `<!-- <table id=\"t2\" parent_id=\"t1\" /> -->` 표지로 남긴다(RAG 색인용). `htmlTables` 와 함께 쓸 수 없다. 기본: 병합·중첩 표는 HTML */\n  tableFormat?: \"gfm\"\n  /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n   *  기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n   *  양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n  keepTrailingEmptyCols?: boolean\n  /** 테두리가 안 보이는 틀 표 처리 (v4.17.0). 기본 `\"visual\"`: 보이는 대로 — 선이 없는 틀은 글로 풀고 선이 보이는 부분만 표로,\n   *  칸으로 조립한 분수는 `$\\frac{…}{…}$` 수식으로. `\"keep\"`: 종전대로 원본 표 구조 그대로(왕복 패치·양식 채우기처럼\n   *  원본 표 서수가 필요한 경로). HWPX·HWP5·PDF */\n  layoutTables?: \"visual\" | \"keep\"\n  /** 구조 파싱 뒤 표를 의미표/레이아웃/불확실로 분류해 `IRTable.classification` 에 붙인다 (#76).\n   *  기본 false — 기본 parse 출력 불변. 중첩표·셀 blocks·캡션 blocks 까지 재귀, 원문 순서는 바꾸지 않는다. */\n  classifyTables?: boolean\n  /** 빈 문단(텍스트 없는 hp:p) 보존 (#57). 기본 false: 종전대로 빈 문단 제거.\n   *  켜면 본문은 `text: \"\"` paragraph 블록으로, 표 셀은 빈 줄로 순서대로 보존해\n   *  \"원문 문단 수 = 줄 수\" 대응을 유지한다 (행 줄맞춤 서식 문서용).\n   *  개체(표·이미지·글상자)만 있는 문단은 개체 출력이 따로 있어 대상이 아니다.\n   *  현재 HWPX 경로 적용. */\n  keepEmptyParagraphs?: boolean\n  /** 미기입 누름틀 안내문도 마크다운에 낸다 (#92). 기본 false: 종전대로 뺀다(한컴은 화면에만 흐리게 보이고 인쇄하지 않는 글).\n   *  빈 서식 문서에서 \"이 칸에 무엇을 적나\"(예: \"학교명 기재 금지\")가 안내문뿐일 때 켠다. HWPX·HWP5 */\n  includeFieldPlaceholders?: boolean\n  /** 비밀번호로 보호된 문서의 열기 암호.\n   *  HWPX(ODF AES-256-CBC)·HWP3(DES) 지원. 한컴 DRM(문서 보안)은 별개라 해당 없음. */\n  password?: string\n  /** 원본 파일 경로 (DRM COM fallback에 필요, 내부 전용) */\n  filePath?: string\n  /**\n   * PDF 수식 OCR 활성화 (기본 false).\n   *\n   * 활성화 시 각 PDF 페이지를 이미지로 렌더링 → YOLOv8 기반 수식 영역 검출 →\n   * TrOCR 기반 LaTeX 인식. 감지된 수식은 `$...$` (inline) / `$$...$$` (display) 로\n   * 블록 텍스트에 삽입된다.\n   *\n   * 필수 optional 의존성: `onnxruntime-node`, `@huggingface/transformers`,\n   * `@hyzyla/pdfium`, `sharp`. 미설치 시 parse 에 실패하지 않고 **경고만** 남기고\n   * 수식 인식은 skip 한다 (일반 텍스트 추출은 정상 동작).\n   *\n   * 모델(~155MB) 은 첫 사용 시 HuggingFace 에서 자동 다운로드 되어\n   * `~/.cache/kordoc/models/pix2text/` 에 SHA-256 검증과 함께 저장된다.\n   */\n  formulaOcr?: boolean\n  /**\n   * 레이아웃 표 페이지 반복 헤더(러닝 헤더) 정리 휴리스틱 활성화 (기본 false).\n   *\n   * 구형 HWP5 문서가 페이지마다 재삽입한 짧은 번호매김 러닝 헤더\n   * (\"2. 과제 구축 내용\")를 최초 1회만 남기고 이후 중복을 제거한다.\n   * 다만 페이지 위치 정보가 없는 HWP5 특성상 이 휴리스틱은 정당하게 반복되는\n   * 번호매김 문단(예: 붙임/별지별 재번호 \"1. 목적\")도 삭제할 수 있어 opt-in 으로\n   * 둔다. 활성 시 제거가 발생하면 HIDDEN_TEXT_FILTERED 경고를 남긴다.\n   */\n  dedupeRunningHeaders?: boolean\n  /**\n   * 추출된 이미지를 마크다운에 base64 data URI 로 인라인 (기본 false).\n   *\n   * 활성화 시 `![image](image_001.bmp)` 참조를 `![image](data:image/png;base64,...)` 로\n   * 치환한다. 임베드된 BMP 는 PNG 로 무손실 압축 후 인라인하여 용량을 크게 줄인다.\n   * 별도 이미지 파일 없이 자체 완결형 마크다운이 되어 MCP/AI 에이전트 소비에 적합하다.\n   * (현재 HWP5 경로 지원)\n   */\n  inlineImages?: boolean\n  /**\n   * 이미지 바이트 추출 (기본 true). false 면 결과에 이미지 바이트를 싣지 않는다.\n   * `images` 는 비고, 블록의 `imageData` 도 떼며, HWP5 `inlineImages` 도 무시한다.\n   * 그림 자리 표시(`![image](…)`)는 마크다운·블록에 그대로 남아 위치는 알 수 있다.\n   * PDF 는 PNG 인코딩을 건너뛴다. 거르는 기준은 같되 메모리 보호용 128MB 누적 상한은 걸리지\n   * 않아, 그 상한 뒤의 그림도 자리 표시가 남는다. DOCX 는 그림 파트(`word/media`·`word/embeddings`)를\n   * 풀지 않고 ZIP 비압축 상한(100MB)에도 세지 않는다 (#108).\n   *\n   * 검색 색인처럼 글자만 필요한 호출자용이다. 그림이 많은 문서는 base64 로 불어난 이미지가\n   * JSON 출력의 대부분을 차지했다 (PDF 실측 200MB → 9.5MB, CPU 시간 30% 감소). 본문 글자와\n   * OCR 은 이 옵션과 무관하다.\n   */\n  images?: boolean\n  /**\n   * PDF 표 감지 활성화 (기본 true). false 면 선 기반 그리드·클러스터 표 감지를 모두 끄고\n   * 자연 읽기순 텍스트만 뽑는다 (#64).\n   *\n   * 시각적 테두리 박스(시험지 안내문·보기 상자)가 표로 잡히면 주변 본문이 셀 매핑으로\n   * 끌려 들어가 문항 순서가 뒤집히는데, 표가 애초에 필요 없는 텍스트 중심 사용처에는\n   * 우회 수단이 없었다. 표가 실제로 있는 문서에 켜면 표 구조가 문단으로 흩어지므로\n   * 문서 종류를 아는 호출자만 쓰는 opt-out 이다. PDF 전용 — 다른 포맷은 무시.\n   */\n  tables?: boolean\n}\n\n// ─── 파싱 경고 ──────────────────────────────────────\n\n/** 파싱 중 스킵/실패한 요소 보고 */\nexport interface ParseWarning {\n  /** 관련 페이지 번호 (알 수 있는 경우) */\n  page?: number\n  /** 경고 메시지 */\n  message: string\n  /** 구조화된 경고 코드 */\n  code: WarningCode\n}\n\nexport type WarningCode =\n  | \"SKIPPED_IMAGE\"\n  | \"SKIPPED_OLE\"\n  | \"TRUNCATED_TABLE\"\n  | \"OCR_FALLBACK\"\n  | \"UNSUPPORTED_ELEMENT\"\n  | \"BROKEN_ZIP_RECOVERY\"\n  | \"HIDDEN_TEXT_FILTERED\"\n  | \"MALFORMED_XML\"\n  | \"PARTIAL_PARSE\"\n  | \"LENIENT_CFB_RECOVERY\"\n  | \"NEEDS_OCR\"\n  | \"OCR_FAILED\"\n  | \"OCR_APPLIED\"\n  | \"OCR_LOW_CONF\"\n  | \"COM_EMPTY\"\n  | \"DRM_COM_FALLBACK\"\n  /** pages 옵션 요청됐으나 조판 캐시가 없어 섹션 단위 근사로 적용됨 (#66) */\n  | \"PAGE_BOUNDARY_APPROXIMATE\"\n\n/** 문서 구조 (헤딩 트리) */\nexport interface OutlineItem {\n  level: number\n  text: string\n  pageNumber?: number\n}\n\n// ─── 에러 코드 ──────────────────────────────────────\n\n/** 구조화된 에러 코드 — 프로그래밍적 에러 핸들링용 */\nexport type ErrorCode =\n  | \"EMPTY_INPUT\"\n  | \"UNSUPPORTED_FORMAT\"\n  | \"ENCRYPTED\"\n  | \"DRM_PROTECTED\"\n  | \"CORRUPTED\"\n  | \"DECOMPRESSION_BOMB\"\n  | \"ZIP_BOMB\"\n  | \"IMAGE_BASED_PDF\"\n  | \"NO_SECTIONS\"\n  | \"PARSE_ERROR\"\n  | \"MISSING_DEPENDENCY\"\n  /** 결과 직렬화가 런타임 문자열 한계를 넘음 — 이미지 다량 문서의 JSON 출력 (#65) */\n  | \"OUTPUT_TOO_LARGE\"\n  /** 입력 경로가 존재하지 않음(ENOENT) — 문서 파싱 이전 단계의 실패 */\n  | \"FILE_NOT_FOUND\"\n\n// ─── 파싱 결과 (discriminated union) ────────────────\n\n/** 감지된 파일 형식 */\nexport type FileType = \"hwpx\" | \"hwp\" | \"hwp3\" | \"hwpml\" | \"pdf\" | \"xlsx\" | \"xls\" | \"docx\" | \"pptx\" | \"image\" | \"unknown\"\n\ninterface ParseResultBase {\n  fileType: FileType\n  /** 페이지/섹션 수 — PDF: 실제 페이지 수, HWP/HWPX: 섹션 수, XLSX: 시트 수 */\n  pageCount?: number\n  /** 이미지 기반 PDF 여부 (텍스트 추출 불가) */\n  isImageBased?: boolean\n}\n\nexport interface ParseSuccess extends ParseResultBase {\n  success: true\n  /** 추출된 마크다운 텍스트 */\n  markdown: string\n  /**\n   * 중간 표현 블록 (구조화된 데이터 접근용).\n   * 블록은 문서(원문) 읽기 순서를 따른다 — 한 문단 안에 글자취급(treatAsChar)\n   * 표와 텍스트가 섞여 있어도 배치 순서대로 방출된다 (v4.2.3, #50).\n   */\n  blocks: IRBlock[]\n  /** 문서 메타데이터 */\n  metadata?: DocumentMetadata\n  /** 문서 구조 (헤딩 트리) — v2.0 */\n  outline?: OutlineItem[]\n  /** 파싱 중 발생한 경고 — v2.0 */\n  warnings?: ParseWarning[]\n  /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */\n  images?: ExtractedImage[]\n  /**\n   * 페이지별 마크다운 (#68) — `blocks` 의 `pageNumber` 로 갈라 페이지마다 다시\n   * 마크다운을 만든 것. 페이지 경계의 신뢰도는 `metadata.pageMode` 를 따른다\n   * (\"layout\" = 실제 페이지, \"section\" = 섹션 근사). `pages` 옵션으로 범위를\n   * 줄이면 그 범위만 담긴다. 페이지 번호를 매기지 않는 포맷(DOCX 등)에서는 없고,\n   * XLSX 는 `pageCount` 와 같은 의미로 시트 한 장이 한 쪽이다.\n   *\n   * 여러 페이지에 걸친 표는 시작 페이지 한 블록이라, 표가 이어지는 중간\n   * 페이지의 `markdown` 은 빈 문자열일 수 있다 (현 IR 구조의 한계).\n   */\n  pages?: PageMarkdown[]\n  /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */\n  pageQuality?: PageQuality[]\n  /** 문서 단위 품질 요약 — PDF에서만 제공 */\n  qualitySummary?: DocumentQualitySummary\n}\n\n/** 페이지 한 장의 마크다운 (#68). ParseSuccess.pages 항목. */\nexport interface PageMarkdown {\n  /** 원본 페이지 번호 (1-based) */\n  pageNumber: number\n  /** 그 페이지 블록만으로 만든 마크다운. 블록이 없으면 빈 문자열 */\n  markdown: string\n}\n\n/** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */\nexport interface PageQuality {\n  page: number\n  textChars: number\n  hangulRatio: number\n  controlCharRatio: number\n  replacementCharRatio: number\n  puaRatio: number\n  needsOcr: boolean\n  ocrReason?: \"vector_text\" | \"low_text\" | \"high_pua\" | \"high_control\" | \"high_replacement\" | \"garbled_hangul\"\n}\n\n/** 문서 단위 품질 요약 (PDF 전용). */\nexport interface DocumentQualitySummary {\n  totalPages: number\n  totalTextChars: number\n  avgHangulRatio: number\n  avgControlCharRatio: number\n  avgReplacementCharRatio: number\n  avgPuaRatio: number\n  lowTextPageCount: number\n  highPuaPageCount: number\n  needsOcr: boolean\n  ocrCandidatePages: number[]\n}\n\n/** 추출된 이미지 — ParseSuccess.images에 포함 */\nexport interface ExtractedImage {\n  /** 마크다운에서 참조되는 파일명 (예: image_001.png) */\n  filename: string\n  /** 이미지 바이너리 */\n  data: Uint8Array\n  /** MIME 타입 */\n  mimeType: string\n  /** 원본 컨테이너 내 항목명 (HWPX/DOCX ZIP 경로, HWP5 BinData 스토리지명 — PDF 등 합성 이미지는 없음, #70) */\n  source?: string\n}\n\nexport interface ParseFailure extends ParseResultBase {\n  success: false\n  /** 오류 메시지 */\n  error: string\n  /** 구조화된 에러 코드 */\n  code?: ErrorCode\n}\n\nexport type ParseResult = ParseSuccess | ParseFailure\n\n// ─── 문서 비교 (Diff) ───────────────────────────────\n\nexport type DiffChangeType = \"added\" | \"removed\" | \"modified\" | \"unchanged\"\n\nexport interface BlockDiff {\n  type: DiffChangeType\n  /** 원본 블록 (added이면 undefined) */\n  before?: IRBlock\n  /** 변경 후 블록 (removed이면 undefined) */\n  after?: IRBlock\n  /** modified 테이블의 셀 단위 diff */\n  cellDiffs?: CellDiff[][]\n  /** 유사도 (0-1) */\n  similarity?: number\n}\n\nexport interface CellDiff {\n  type: DiffChangeType\n  before?: string\n  after?: string\n}\n\nexport interface DiffResult {\n  stats: { added: number; removed: number; modified: number; unchanged: number }\n  diffs: BlockDiff[]\n}\n\n// ─── 라운드트립 패치 (v3.0) ─────────────────────────\n\n/** 패치 중 매핑 실패/미지원으로 건너뛴 항목 — silent 실패 금지 */\nexport interface PatchSkip {\n  /** 건너뛴 사유 */\n  reason: string\n  /** 원본 쪽 내용 요약 (최대 80자) */\n  before?: string\n  /** 편집 쪽 내용 요약 (최대 80자) */\n  after?: string\n  /**\n   * 부분 적용 표시 — 변경이 적용은 됐지만(applied 계상) 편집 원형 그대로는\n   * 아님 (예: 셀 내 줄 추가를 마지막 문단에 병합). 완전 미적용 skip과 구분.\n   */\n  partial?: boolean\n}\n\n/** patchHwpx 옵션 */\nexport interface PatchOptions {\n  /** 패치 후 재파싱 자동 검증 (기본 true) */\n  verify?: boolean\n}\n\n/** patchHwpx / patchBlocks 결과 */\nexport interface PatchResult {\n  success: boolean\n  /** 패치된 HWPX (success=true) */\n  data?: Uint8Array\n  /** 적용된 변경 수 */\n  applied: number\n  /** 매핑 실패 항목 (이유 포함) */\n  skipped: PatchSkip[]\n  /**\n   * 무손실 검증 (patchHwpx/patchHwp 전용): 패치본 재파싱 vs 편집 마크다운의\n   * 잔차 diff — modified/added/removed가 0이어야 의도가 전부 반영된 것.\n   * session.patchBlocks는 이 필드를 채우지 않는다 (changes 참조).\n   */\n  verification?: DiffResult\n  /**\n   * 변경 가시화 (session.patchBlocks 전용): 패치 전 → 후 문서 diff —\n   * 적용된 편집 수만큼 modified가 나오는 것이 정상. verification과 의미가\n   * 정반대이므로 혼용 금지.\n   */\n  changes?: DiffResult\n  /** 실패 사유 (success=false) */\n  error?: string\n}\n\n// ─── 양식 인식 ──────────────────────────────────────\n\nexport interface FormField {\n  label: string\n  value: string\n  /** 0-based 소스 행 */\n  row: number\n  /** 0-based 소스 열 */\n  col: number\n  /** 매칭된 입력 키(정규화) — 모호 라벨 거부 가드(fillWithUniqueGuard)의 집계 기준 */\n  key?: string\n  /** 채우기 결과 전용: 값을 쓴 칸 — 표 번호(문서 순서, 중첩표 포함 0-based)와 그 표의 격자 행·열(0-based).\n   *  표 밖 본문·누름틀 채움은 없다. row/col 은 경로에 따라 라벨 칸 좌표라 대상 칸은 이것으로 본다 (#145) */\n  target?: { table: number; row: number; col: number }\n  /** 매칭 근거. `clickhere`(누름틀 name 정확 일치)는 서식 제작자가 선언한 계약이라\n   *  여러 곳에 같은 이름이 있어도 \"모호\"가 아니다 — 모호 라벨 거부 집계에서 제외된다.\n   *  (머리말·본문에 같은 이름의 누름틀을 두는 서식이 실제로 있다) */\n  source?: \"clickhere\"\n}\n\nexport interface FormResult {\n  fields: FormField[]\n  /** 양식 확신도 (0-1) */\n  confidence: number\n}\n\n// ─── OCR 프로바이더 ─────────────────────────────────\n\n/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 반환.\n *  PDF 경로는 항상 \"image/png\", 이미지 직접 입력 경로는 원본 mime 그대로 전달. */\nexport type OcrProvider = (\n  pageImage: Uint8Array,\n  pageNumber: number,\n  mimeType: \"image/png\" | \"image/jpeg\" | \"image/webp\"\n) => Promise<string>\n\n// ─── Watch 모드 ─────────────────────────────────────\n\nexport interface WatchOptions {\n  dir: string\n  outDir?: string\n  webhook?: string\n  format?: \"markdown\" | \"json\"\n  pages?: string\n  silent?: boolean\n}\n\n// ─── 헤딩 감지 공통 임계값 ──────────────────────────\n\n/** 폰트 크기 비율 → heading level (전 파서 공통) */\nexport const HEADING_RATIO_H1 = 1.5\nexport const HEADING_RATIO_H2 = 1.3\nexport const HEADING_RATIO_H3 = 1.15\n\n// ─── 내부 파서 반환 타입 ─────────────────────────────\n\n/** 내부 파서가 index.ts에 반환하는 공통 타입 (HWP5/HWPX/PDF/XLSX/DOCX) */\nexport interface InternalParseResult {\n  markdown: string\n  blocks: IRBlock[]\n  metadata?: DocumentMetadata\n  outline?: OutlineItem[]\n  warnings?: ParseWarning[]\n  images?: ExtractedImage[]\n  /** PDF 전용: 이미지 기반 PDF 여부 */\n  isImageBased?: boolean\n  /** PDF 전용: 페이지별 품질 신호 */\n  pageQuality?: PageQuality[]\n  /** PDF 전용: 문서 단위 품질 요약 */\n  qualitySummary?: DocumentQualitySummary\n  /** PDF 전용: 페이지별 마크다운 — 문서 마크다운과 같은 PDF 마무리(1×1 표 펴기·cleanPdfText)를 쪽마다 적용한 것 */\n  pages?: PageMarkdown[]\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-47GYLNNK.js → chunk-5VUUWX45.js}

@@ -2,7 +2,7 @@
 import {
   escapeHtml,
   sanitizeHref
-} from "./chunk-6ED4Q6IK.js";
+} from "./chunk-SJCNQUDE.js";
 
 // src/shared/symbol-fonts.ts
 var WINGDINGS = [
@@ -1063,4 +1063,4 @@ export {
   visibleText,
   escapeHtmlCellText
 };
-//# sourceMappingURL=chunk-47GYLNNK.js.map
+//# sourceMappingURL=chunk-5VUUWX45.js.map

package/dist/{chunk-RNBATQWV.js → chunk-A4HUSCRK.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   assertNetworkAllowed
-} from "./chunk-4PLQ74D5.js";
+} from "./chunk-W7UWPQHF.js";
 
 // src/pdf/formula/models.ts
 import { createHash as createHash2 } from "crypto";
@@ -294,4 +294,4 @@ export {
   ensureFormulaModels,
   ensureSingleModel
 };
-//# sourceMappingURL=chunk-RNBATQWV.js.map
+//# sourceMappingURL=chunk-A4HUSCRK.js.map

package/dist/{chunk-SKB7HDL7.js → chunk-AWFUJ2CE.js}

@@ -2,7 +2,7 @@
 import {
   assignTableIds,
   blocksToMarkdown
-} from "./chunk-47GYLNNK.js";
+} from "./chunk-5VUUWX45.js";
 
 // src/chunks.ts
 var LIST_MARKER_RE = /^(?:[□■◇◆○◎●◦ㅇ•▪▸▶※-]|\d{1,3}[.)]|[가나다라마바사아자차카타파하][.)]|\([가나다라마바사아자차카타파하0-9]{1,3}\)|[①-⑳㉮-㉻㈎-㈛])\s/;
@@ -82,4 +82,4 @@ function blocksToChunks(blocks, options) {
 export {
   blocksToChunks
 };
-//# sourceMappingURL=chunk-SKB7HDL7.js.map
+//# sourceMappingURL=chunk-AWFUJ2CE.js.map

package/dist/{chunk-JLEFUOXS.js → chunk-BSPSDDNO.js}

@@ -1,5 +1,5 @@
 // src/utils.ts
-var VERSION = true ? "4.21.24" : "0.0.0-dev";
+var VERSION = true ? "4.21.26" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -159,4 +159,4 @@ export {
   classifyError,
   partExtension
 };
-//# sourceMappingURL=chunk-JLEFUOXS.js.map
+//# sourceMappingURL=chunk-BSPSDDNO.js.map

package/dist/{chunk-ALK46O7J.js → chunk-D2MPOLNQ.js}

@@ -4,15 +4,15 @@ import {
   HEADING_RATIO_H2,
   HEADING_RATIO_H3,
   tidyScriptTags
-} from "./chunk-BSLF5THD.js";
+} from "./chunk-TKCNKW5W.js";
 import {
   ensureModelsIn,
   getModelsDir
-} from "./chunk-RNCWGU27.js";
+} from "./chunk-GTBUIVUV.js";
 import {
   safeMax,
   safeMin
-} from "./chunk-JLEFUOXS.js";
+} from "./chunk-BSPSDDNO.js";
 
 // src/ocr/models.ts
 import { join } from "path";
@@ -8971,4 +8971,4 @@ export {
   UNRULED_REGION_TABLES,
   mergeOcrImageRegions
 };
-//# sourceMappingURL=chunk-ALK46O7J.js.map
+//# sourceMappingURL=chunk-D2MPOLNQ.js.map

package/dist/{chunk-CMGO4G3U.cjs → chunk-DTFLALDT.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/utils.ts
-var VERSION = true ? "4.21.24" : "0.0.0-dev";
+var VERSION = true ? "4.21.26" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -159,4 +159,4 @@ function partExtension(path) {
 
 
 exports.VERSION = VERSION; exports.toArrayBuffer = toArrayBuffer; exports.KordocError = KordocError; exports.sanitizeError = sanitizeError; exports.isPathTraversal = isPathTraversal; exports.normalizeSectionHref = normalizeSectionHref; exports.compareSectionPaths = compareSectionPaths; exports.unzipLimitBytes = unzipLimitBytes; exports.precheckZipSize = precheckZipSize; exports.stripDtd = stripDtd; exports.sanitizeHref = sanitizeHref; exports.escapeHtml = escapeHtml; exports.unescapeHtml = unescapeHtml; exports.safeMin = safeMin; exports.safeMax = safeMax; exports.OPTIONAL_DEP_INSTALL_HINT = OPTIONAL_DEP_INSTALL_HINT; exports.classifyError = classifyError; exports.partExtension = partExtension;
-//# sourceMappingURL=chunk-CMGO4G3U.cjs.map
+//# sourceMappingURL=chunk-DTFLALDT.cjs.map

package/dist/{chunk-CMGO4G3U.cjs.map → chunk-DTFLALDT.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-CMGO4G3U.cjs","../src/utils.ts"],"names":[],"mappings":"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","file":"/Users/mong-e/workspace/kordoc/dist/chunk-CMGO4G3U.cjs","sourcesContent":[null,"/** kordoc 공용 유틸리티 */\n\nimport { format } from \"util\"\n\n/** 빌드 타임에 tsup define으로 주입되는 버전 */\ndeclare const __KORDOC_VERSION__: string\nexport const VERSION: string = typeof __KORDOC_VERSION__ !== \"undefined\" ? __KORDOC_VERSION__ : \"0.0.0-dev\"\n\n/**\n * Node.js Buffer → ArrayBuffer 변환\n * pool Buffer의 공유 ArrayBuffer 문제를 안전하게 처리.\n * offset=0이고 전체 ArrayBuffer를 차지하면 복사 없이 직접 반환.\n */\nexport function toArrayBuffer(buf: Buffer): ArrayBuffer {\n  if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {\n    return buf.buffer as ArrayBuffer\n  }\n  return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n}\n\n/**\n * kordoc 내부 에러 클래스 — 사용자에게 노출해도 안전한 메시지만 포함.\n * MCP 에러 정제에서 instanceof로 판별하여 allowlist 패턴 매칭 없이 안전하게 통과.\n */\nexport class KordocError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = \"KordocError\"\n  }\n}\n\n/**\n * ENOENT 판별 — 입력 경로가 존재하지 않음.\n * 래핑된 KordocError 를 뚫고 올라온 경우도 있으므로 메시지까지 함께 본다.\n */\nfunction isFileNotFound(err: unknown): boolean {\n  if (typeof err !== \"object\" || err === null) return false\n  if ((err as NodeJS.ErrnoException).code === \"ENOENT\") return true\n  const msg = (err as Error).message\n  return typeof msg === \"string\" && /ENOENT|no such file or directory/i.test(msg)\n}\n\n/**\n * 에러 메시지 정제 — KordocError는 그대로, ENOENT 만 구분 문구, 나머지는 일반 메시지로 대체.\n * 파일시스템 경로, 스택 트레이스 등 내부 정보 노출 방지.\n */\nexport function sanitizeError(err: unknown): string {\n  if (err instanceof KordocError) return err.message\n  // 없는 파일은 문서 문제가 아니라 고칠 수 있는 입력 문제다 — 사유를 숨기지 않는다.\n  // 경로는 노출하지 않는다(어느 파일인지는 stderr·실패 JSON 의 basename 이 알린다).\n  // 문구는 MCP describeError 의 ENOENT 힌트와 같은 표현을 쓴다.\n  if (isFileNotFound(err)) return \"파일 또는 디렉토리를 찾을 수 없습니다\"\n  return \"문서 처리 중 오류가 발생했습니다\"\n}\n\n/**\n * ZIP 엔트리 경로의 경로 순회 여부 판별.\n * 백슬래시 정규화, .., 절대경로, Windows 드라이브 문자 모두 차단.\n */\nexport function isPathTraversal(name: string): boolean {\n  if (name.includes(\"\\x00\")) return true\n  const normalized = name.replace(/\\\\/g, \"/\")\n  const segments = normalized.split(\"/\")\n  return segments.some(s => s === \"..\") || normalized.startsWith(\"/\") || /^[A-Za-z]:/.test(normalized)\n}\n\n// ─── HWPX 섹션 href 해석 (parser/roundtrip 공용) ────────────────────\n\n/**\n * manifest href를 본문 섹션 경로(`Contents/sectionN.xml`)로 정규화.\n * 비본문 XML(header/script/settings)·path traversal·드라이브 경로는 null로 거른다.\n * 백슬래시 구분자를 슬래시로 통일해 parser와 roundtrip이 동일한 목록을 만든다.\n */\nexport function normalizeSectionHref(href: string): string | null {\n  if (!href) return null\n  let normalized = href.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\")\n  if (isPathTraversal(normalized)) return null\n  if (/^[Ss]ection\\d+\\.xml$/.test(normalized)) normalized = \"Contents/\" + normalized\n  return /(?:^|\\/)[Ss]ection\\d+\\.xml$/.test(normalized) ? normalized : null\n}\n\n/** sectionN.xml을 N 숫자 순서로 정렬 (section10 > section2). */\nexport function compareSectionPaths(a: string, b: string): number {\n  const ai = Number(a.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  const bi = Number(b.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  return ai === bi ? a.localeCompare(b) : ai - bi\n}\n\n// ─── ZIP 안전 로딩 (ZIP bomb 방지) ────────────────────\n\n/** ZIP 비압축 상한 env 의 최대값 (MB) — 오타로 사실상 무제한이 되지 않게 */\nconst MAX_UNZIP_ENV_MB = 8192\n\n/**\n * ZIP 비압축 크기 상한 — `KORDOC_MAX_UNZIP_MB` 가 양수면 그 값(MB, 최대 8192), 아니면 포맷 기본값.\n * 빈 행이 수백만 개인 XLSX 처럼 내용은 작고 XML 만 큰 실문서를 폐쇄망 대량 적재에서 받으려는 설정 (#91)\n */\nexport function unzipLimitBytes(defaultBytes: number): number {\n  const mb = Number(process.env.KORDOC_MAX_UNZIP_MB)\n  return Number.isFinite(mb) && mb > 0 ? Math.min(mb, MAX_UNZIP_ENV_MB) * 1024 * 1024 : defaultBytes\n}\n\n/**\n * ZIP bomb 사전 검사 — Central Directory에서 비압축 합계와 엔트리 수 확인.\n * HWPX/XLSX/DOCX 등 모든 ZIP 기반 포맷에서 공통 사용.\n */\nexport function precheckZipSize(\n  buffer: ArrayBuffer,\n  maxUncompressedSize = 256 * 1024 * 1024, // parser-shared MAX_DECOMPRESS_SIZE 와 동기\n  maxEntries = 500,\n  /** 그림·개체 파트(엔트리 이름 re) — skip 이면 합계에서 뺀다(파서가 풀지 않는다), 아니면 한도 초과 메시지에 크기를 적는다 (#108).\n   *  never — 파서가 어느 때도 풀지 않는 파트(동영상·음성·OLE 임베드)는 늘 뺀다: 110MB 동영상 하나로 발표 자료가 통째 거부됐다 */\n  media?: { re: RegExp; skip: boolean; never?: RegExp },\n): { totalUncompressed: number; entryCount: number } {\n  try {\n    const data = new DataView(buffer)\n    const len = buffer.byteLength\n    // EOCD 시그니처 역방향 스캔\n    let eocdOffset = -1\n    for (let i = len - 22; i >= Math.max(0, len - 65557); i--) {\n      if (data.getUint32(i, true) === 0x06054b50) { eocdOffset = i; break }\n    }\n    if (eocdOffset < 0) return { totalUncompressed: 0, entryCount: 0 }\n\n    const entryCount = data.getUint16(eocdOffset + 10, true)\n    if (entryCount > maxEntries) {\n      throw new KordocError(`ZIP 엔트리 수 초과: ${entryCount} (최대 ${maxEntries})`)\n    }\n\n    const cdSize = data.getUint32(eocdOffset + 12, true)\n    const cdOffset = data.getUint32(eocdOffset + 16, true)\n    if (cdOffset + cdSize > len) return { totalUncompressed: 0, entryCount }\n\n    let totalUncompressed = 0\n    let mediaUncompressed = 0\n    let pos = cdOffset\n    for (let i = 0; i < entryCount && pos + 46 <= cdOffset + cdSize; i++) {\n      if (data.getUint32(pos, true) !== 0x02014b50) break\n      const size = data.getUint32(pos + 24, true)\n      const nameLen = data.getUint16(pos + 28, true)\n      const extraLen = data.getUint16(pos + 30, true)\n      const commentLen = data.getUint16(pos + 32, true)\n      // 이름이 버퍼 밖이면 그림 파트로 치지 않는다(합계에서 빠지지 않게)\n      const isMedia = !!media && pos + 46 + nameLen <= len &&\n        media.re.test(new TextDecoder().decode(new Uint8Array(buffer, pos + 46, nameLen)))\n      const never = isMedia && !!media?.never && media.never.test(new TextDecoder().decode(new Uint8Array(buffer, pos + 46, nameLen)))\n      if (isMedia && !never) mediaUncompressed += size\n      if (!(isMedia && (media?.skip || never))) totalUncompressed += size\n      pos += 46 + nameLen + extraLen + commentLen\n    }\n\n    if (totalUncompressed > maxUncompressedSize) {\n      const mb = (n: number) => (n / 1024 / 1024).toFixed(1)\n      const mediaNote = media && !media.skip && mediaUncompressed > 0\n        ? ` — 그림·개체 파트가 ${mb(mediaUncompressed)}MB, 이미지 추출을 끄면(images: false·--no-images) 세지 않는다` : \"\"\n      throw new KordocError(`ZIP 비압축 크기 초과: ${mb(totalUncompressed)}MB (최대 ${maxUncompressedSize / 1024 / 1024}MB)${mediaNote}`)\n    }\n\n    return { totalUncompressed, entryCount }\n  } catch (err) {\n    if (err instanceof KordocError) throw err\n    return { totalUncompressed: 0, entryCount: 0 }\n  }\n}\n\n/**\n * XML 파싱 전 프롤로그 정리 — 선두 BOM 제거 + DOCTYPE 제거(XXE/Billion Laughs 방지).\n *\n * BOM: 일부 OpenXML 라이터가 `[Content_Types].xml`·`.rels` 앞에 EF BB BF를 붙인다.\n * XML 스펙상 적법(엔티티는 BOM으로 시작할 수 있음)이고 엑셀·리브레오피스는 여는데,\n * xmldom은 \"선언이 문서 시작이 아님\" fatalError로 파일 전체를 거부했다 (#63).\n */\nexport function stripDtd(xml: string): string {\n  return xml.replace(/^\\uFEFF/, \"\").replace(/<!DOCTYPE\\s[^[>]*(\\[[\\s\\S]*?\\])?\\s*>/gi, \"\")\n}\n\n/** 하이퍼링크 URL 살균 — javascript: 등 XSS 위험 스킴 차단 */\nconst SAFE_HREF_RE = /^(?:https?:|mailto:|tel:|#)/i\nconst HREF_ESCAPE: Record<string, string> = { \"(\": \"%28\", \")\": \"%29\", \"<\": \"%3C\", \">\": \"%3E\", \"\\\"\": \"%22\", \"'\": \"%27\", \"`\": \"%60\" }\nexport function sanitizeHref(href: string): string | null {\n  const trimmed = href.trim()\n  if (!trimmed || !SAFE_HREF_RE.test(trimmed)) return null\n  // 괄호 percent-encoding — 마크다운 링크 목적지에서 불균형 ')'는 링크를 조기 종료시켜\n  // 문법이 깨진다 (원문 하이퍼링크에 ')'가 박힌 실문서 존재). %28/%29는 의미 동일.\n  // 공백·<>\"'` 도 — 스킴만 보고 통과시키면 \"mailto:a <img src=x onerror=…>\" 가 링크 목적지를 깨고 날 태그로\n  // 렌더됐다(pdfjs 는 mailto·tel URI 를 정규화하지 않는다, v4.14.4 리뷰 재현). 인코딩해도 같은 주소다\n  return trimmed.replace(/[()<>\"'`]/g, c => HREF_ESCAPE[c]).replace(/\\s/g, c => encodeURIComponent(c))\n}\n\n/**\n * HTML 엔티티 이스케이프 — 글은 `& < >`, 속성값(attr)은 `\"` 까지. HTML 표 경로(builder tableToHtml)와\n * 인쇄 렌더러가 같이 쓰는 한 벌. 읽는 쪽은 unescapeHtml 로 푼다\n */\nexport function escapeHtml(text: string, attr = false): string {\n  const s = text.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\")\n  return attr ? s.replace(/\"/g, \"&quot;\") : s\n}\n\n/** escapeHtml 의 역 (+ 손으로 쓴 HTML 표의 &#39;) — 한 번에 풀어 \"&amp;lt;\" 는 \"&lt;\" 로 남는다 */\nexport function unescapeHtml(text: string): string {\n  return text.replace(/&(lt|gt|quot|#39|amp);/g, (_, e: string) => HTML_ENTITY[e])\n}\nconst HTML_ENTITY: Record<string, string> = { lt: \"<\", gt: \">\", quot: \"\\\"\", \"#39\": \"'\", amp: \"&\" }\n\n/**\n * console.log·info·warn·debug 를 stderr 로 — stdout 이 기계 출력 채널(MCP JSON-RPC·CLI 마크다운/JSON·parse-worker\n * NDJSON)인 진입점용. 라이브러리(pdfjs 등)가 console 로 찍는 경고가 그 채널을 깨지 않게 한다\n */\nexport function routeConsoleToStderr(): void {\n  const toStderr = (...args: unknown[]): void => void process.stderr.write(format(...args) + \"\\n\")\n  console.log = toStderr\n  console.info = toStderr\n  console.warn = toStderr\n  console.debug = toStderr\n}\n\n// ─── 안전한 min/max (스택 오버플로 방지) ─────────────\n\n/** Math.min(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMin(arr: number[]): number {\n  let min = Infinity\n  for (let i = 0; i < arr.length; i++) if (arr[i] < min) min = arr[i]\n  return min\n}\n\n/** Math.max(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMax(arr: number[]): number {\n  let max = -Infinity\n  for (let i = 0; i < arr.length; i++) if (arr[i] > max) max = arr[i]\n  return max\n}\n\n// ─── 에러 분류 ──────────────────────────────────────\n\nimport type { ErrorCode } from \"./types.js\"\n\n/** 에러를 구조화된 ErrorCode로 분류 — KordocError 메시지 패턴 매칭 */\n/** 선택 의존 설치 실패 안내 꼬리 — 네트워크가 막힌 linux/x64 에서 onnxruntime-node 설치 스크립트가 CUDA 바이너리를 받다 실패하면\n *  npm 이 sharp·@huggingface/transformers 까지 선택 의존 설치에서 뺀다(#99). npx 캐시 실행은 npm install 로 못 고친다 */\nexport const OPTIONAL_DEP_INSTALL_HINT =\n  \" 네트워크가 제한된 linux/x64 에서 npx 로 설치했다면 onnxruntime-node 의 CUDA 다운로드 실패로 함께 빠졌을 수 있습니다 — \" +\n  \"`ONNXRUNTIME_NODE_INSTALL=skip npx -y kordoc@^4 …` 로 다시 설치하세요.\"\n\nexport function classifyError(err: unknown): ErrorCode {\n  if (!(err instanceof Error)) return \"PARSE_ERROR\"\n  const msg = err.message\n  // 입력 파일 없음 — 문서 내용 문제가 아니라 호출자의 경로 문제라 PARSE_ERROR 로 덮지 않는다.\n  if (isFileNotFound(err)) return \"FILE_NOT_FOUND\"\n  // DRM 을 암호화보다 먼저 — \"DRM 암호화된 HWPX…\" 류 메시지가 ENCRYPTED 로 떨어지지 않도록\n  if (msg.includes(\"DRM\")) return \"DRM_PROTECTED\"\n  if (msg.includes(\"암호화\") || msg.includes(\"암호로 보호\")) return \"ENCRYPTED\"\n  if (msg.includes(\"optional dependency\")) return \"MISSING_DEPENDENCY\"\n  // V8 문자열 한계 초과 — 이미지 base64 총량이 큰 문서의 JSON 직렬화 (#65)\n  if (msg.includes(\"Invalid string length\") || msg.includes(\"Cannot create a string longer\")) return \"OUTPUT_TOO_LARGE\"\n  if (msg.includes(\"ZIP bomb\") || msg.includes(\"ZIP 비압축 크기 초과\") || msg.includes(\"ZIP 엔트리 수 초과\")) return \"ZIP_BOMB\"\n  if (msg.includes(\"bomb\") || msg.includes(\"크기 초과\") || msg.includes(\"압축 해제\")) return \"DECOMPRESSION_BOMB\"\n  if (msg.includes(\"이미지 기반\")) return \"IMAGE_BASED_PDF\"\n  if (msg.includes(\"섹션\") && (msg.includes(\"찾을 수 없\") || msg.includes(\"없음\"))) return \"NO_SECTIONS\"\n  if (msg.includes(\"시그니처\") || msg.includes(\"복구할 수 없\")) return \"CORRUPTED\"\n  return \"PARSE_ERROR\"\n}\n\n/** ZIP 파트 경로의 확장자 — 마지막 경로 조각에서만, 없으면 \"bin\". \"ppt/media.v2/image1\" 의 \"v2/image1\" 이 그림 파일 이름에 들어가\n *  저장 경로가 깨졌다 */\nexport function partExtension(path: string): string {\n  return (/\\.([A-Za-z0-9]{1,5})$/.exec(path.slice(path.lastIndexOf(\"/\") + 1))?.[1] ?? \"bin\").toLowerCase()\n}\n"]}
+{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-DTFLALDT.cjs","../src/utils.ts"],"names":[],"mappings":"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","file":"/Users/mong-e/workspace/kordoc/dist/chunk-DTFLALDT.cjs","sourcesContent":[null,"/** kordoc 공용 유틸리티 */\n\nimport { format } from \"util\"\n\n/** 빌드 타임에 tsup define으로 주입되는 버전 */\ndeclare const __KORDOC_VERSION__: string\nexport const VERSION: string = typeof __KORDOC_VERSION__ !== \"undefined\" ? __KORDOC_VERSION__ : \"0.0.0-dev\"\n\n/**\n * Node.js Buffer → ArrayBuffer 변환\n * pool Buffer의 공유 ArrayBuffer 문제를 안전하게 처리.\n * offset=0이고 전체 ArrayBuffer를 차지하면 복사 없이 직접 반환.\n */\nexport function toArrayBuffer(buf: Buffer): ArrayBuffer {\n  if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {\n    return buf.buffer as ArrayBuffer\n  }\n  return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n}\n\n/**\n * kordoc 내부 에러 클래스 — 사용자에게 노출해도 안전한 메시지만 포함.\n * MCP 에러 정제에서 instanceof로 판별하여 allowlist 패턴 매칭 없이 안전하게 통과.\n */\nexport class KordocError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = \"KordocError\"\n  }\n}\n\n/**\n * ENOENT 판별 — 입력 경로가 존재하지 않음.\n * 래핑된 KordocError 를 뚫고 올라온 경우도 있으므로 메시지까지 함께 본다.\n */\nfunction isFileNotFound(err: unknown): boolean {\n  if (typeof err !== \"object\" || err === null) return false\n  if ((err as NodeJS.ErrnoException).code === \"ENOENT\") return true\n  const msg = (err as Error).message\n  return typeof msg === \"string\" && /ENOENT|no such file or directory/i.test(msg)\n}\n\n/**\n * 에러 메시지 정제 — KordocError는 그대로, ENOENT 만 구분 문구, 나머지는 일반 메시지로 대체.\n * 파일시스템 경로, 스택 트레이스 등 내부 정보 노출 방지.\n */\nexport function sanitizeError(err: unknown): string {\n  if (err instanceof KordocError) return err.message\n  // 없는 파일은 문서 문제가 아니라 고칠 수 있는 입력 문제다 — 사유를 숨기지 않는다.\n  // 경로는 노출하지 않는다(어느 파일인지는 stderr·실패 JSON 의 basename 이 알린다).\n  // 문구는 MCP describeError 의 ENOENT 힌트와 같은 표현을 쓴다.\n  if (isFileNotFound(err)) return \"파일 또는 디렉토리를 찾을 수 없습니다\"\n  return \"문서 처리 중 오류가 발생했습니다\"\n}\n\n/**\n * ZIP 엔트리 경로의 경로 순회 여부 판별.\n * 백슬래시 정규화, .., 절대경로, Windows 드라이브 문자 모두 차단.\n */\nexport function isPathTraversal(name: string): boolean {\n  if (name.includes(\"\\x00\")) return true\n  const normalized = name.replace(/\\\\/g, \"/\")\n  const segments = normalized.split(\"/\")\n  return segments.some(s => s === \"..\") || normalized.startsWith(\"/\") || /^[A-Za-z]:/.test(normalized)\n}\n\n// ─── HWPX 섹션 href 해석 (parser/roundtrip 공용) ────────────────────\n\n/**\n * manifest href를 본문 섹션 경로(`Contents/sectionN.xml`)로 정규화.\n * 비본문 XML(header/script/settings)·path traversal·드라이브 경로는 null로 거른다.\n * 백슬래시 구분자를 슬래시로 통일해 parser와 roundtrip이 동일한 목록을 만든다.\n */\nexport function normalizeSectionHref(href: string): string | null {\n  if (!href) return null\n  let normalized = href.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\")\n  if (isPathTraversal(normalized)) return null\n  if (/^[Ss]ection\\d+\\.xml$/.test(normalized)) normalized = \"Contents/\" + normalized\n  return /(?:^|\\/)[Ss]ection\\d+\\.xml$/.test(normalized) ? normalized : null\n}\n\n/** sectionN.xml을 N 숫자 순서로 정렬 (section10 > section2). */\nexport function compareSectionPaths(a: string, b: string): number {\n  const ai = Number(a.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  const bi = Number(b.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  return ai === bi ? a.localeCompare(b) : ai - bi\n}\n\n// ─── ZIP 안전 로딩 (ZIP bomb 방지) ────────────────────\n\n/** ZIP 비압축 상한 env 의 최대값 (MB) — 오타로 사실상 무제한이 되지 않게 */\nconst MAX_UNZIP_ENV_MB = 8192\n\n/**\n * ZIP 비압축 크기 상한 — `KORDOC_MAX_UNZIP_MB` 가 양수면 그 값(MB, 최대 8192), 아니면 포맷 기본값.\n * 빈 행이 수백만 개인 XLSX 처럼 내용은 작고 XML 만 큰 실문서를 폐쇄망 대량 적재에서 받으려는 설정 (#91)\n */\nexport function unzipLimitBytes(defaultBytes: number): number {\n  const mb = Number(process.env.KORDOC_MAX_UNZIP_MB)\n  return Number.isFinite(mb) && mb > 0 ? Math.min(mb, MAX_UNZIP_ENV_MB) * 1024 * 1024 : defaultBytes\n}\n\n/**\n * ZIP bomb 사전 검사 — Central Directory에서 비압축 합계와 엔트리 수 확인.\n * HWPX/XLSX/DOCX 등 모든 ZIP 기반 포맷에서 공통 사용.\n */\nexport function precheckZipSize(\n  buffer: ArrayBuffer,\n  maxUncompressedSize = 256 * 1024 * 1024, // parser-shared MAX_DECOMPRESS_SIZE 와 동기\n  maxEntries = 500,\n  /** 그림·개체 파트(엔트리 이름 re) — skip 이면 합계에서 뺀다(파서가 풀지 않는다), 아니면 한도 초과 메시지에 크기를 적는다 (#108).\n   *  never — 파서가 어느 때도 풀지 않는 파트(동영상·음성·OLE 임베드)는 늘 뺀다: 110MB 동영상 하나로 발표 자료가 통째 거부됐다 */\n  media?: { re: RegExp; skip: boolean; never?: RegExp },\n): { totalUncompressed: number; entryCount: number } {\n  try {\n    const data = new DataView(buffer)\n    const len = buffer.byteLength\n    // EOCD 시그니처 역방향 스캔\n    let eocdOffset = -1\n    for (let i = len - 22; i >= Math.max(0, len - 65557); i--) {\n      if (data.getUint32(i, true) === 0x06054b50) { eocdOffset = i; break }\n    }\n    if (eocdOffset < 0) return { totalUncompressed: 0, entryCount: 0 }\n\n    const entryCount = data.getUint16(eocdOffset + 10, true)\n    if (entryCount > maxEntries) {\n      throw new KordocError(`ZIP 엔트리 수 초과: ${entryCount} (최대 ${maxEntries})`)\n    }\n\n    const cdSize = data.getUint32(eocdOffset + 12, true)\n    const cdOffset = data.getUint32(eocdOffset + 16, true)\n    if (cdOffset + cdSize > len) return { totalUncompressed: 0, entryCount }\n\n    let totalUncompressed = 0\n    let mediaUncompressed = 0\n    let pos = cdOffset\n    for (let i = 0; i < entryCount && pos + 46 <= cdOffset + cdSize; i++) {\n      if (data.getUint32(pos, true) !== 0x02014b50) break\n      const size = data.getUint32(pos + 24, true)\n      const nameLen = data.getUint16(pos + 28, true)\n      const extraLen = data.getUint16(pos + 30, true)\n      const commentLen = data.getUint16(pos + 32, true)\n      // 이름이 버퍼 밖이면 그림 파트로 치지 않는다(합계에서 빠지지 않게)\n      const isMedia = !!media && pos + 46 + nameLen <= len &&\n        media.re.test(new TextDecoder().decode(new Uint8Array(buffer, pos + 46, nameLen)))\n      const never = isMedia && !!media?.never && media.never.test(new TextDecoder().decode(new Uint8Array(buffer, pos + 46, nameLen)))\n      if (isMedia && !never) mediaUncompressed += size\n      if (!(isMedia && (media?.skip || never))) totalUncompressed += size\n      pos += 46 + nameLen + extraLen + commentLen\n    }\n\n    if (totalUncompressed > maxUncompressedSize) {\n      const mb = (n: number) => (n / 1024 / 1024).toFixed(1)\n      const mediaNote = media && !media.skip && mediaUncompressed > 0\n        ? ` — 그림·개체 파트가 ${mb(mediaUncompressed)}MB, 이미지 추출을 끄면(images: false·--no-images) 세지 않는다` : \"\"\n      throw new KordocError(`ZIP 비압축 크기 초과: ${mb(totalUncompressed)}MB (최대 ${maxUncompressedSize / 1024 / 1024}MB)${mediaNote}`)\n    }\n\n    return { totalUncompressed, entryCount }\n  } catch (err) {\n    if (err instanceof KordocError) throw err\n    return { totalUncompressed: 0, entryCount: 0 }\n  }\n}\n\n/**\n * XML 파싱 전 프롤로그 정리 — 선두 BOM 제거 + DOCTYPE 제거(XXE/Billion Laughs 방지).\n *\n * BOM: 일부 OpenXML 라이터가 `[Content_Types].xml`·`.rels` 앞에 EF BB BF를 붙인다.\n * XML 스펙상 적법(엔티티는 BOM으로 시작할 수 있음)이고 엑셀·리브레오피스는 여는데,\n * xmldom은 \"선언이 문서 시작이 아님\" fatalError로 파일 전체를 거부했다 (#63).\n */\nexport function stripDtd(xml: string): string {\n  return xml.replace(/^\\uFEFF/, \"\").replace(/<!DOCTYPE\\s[^[>]*(\\[[\\s\\S]*?\\])?\\s*>/gi, \"\")\n}\n\n/** 하이퍼링크 URL 살균 — javascript: 등 XSS 위험 스킴 차단 */\nconst SAFE_HREF_RE = /^(?:https?:|mailto:|tel:|#)/i\nconst HREF_ESCAPE: Record<string, string> = { \"(\": \"%28\", \")\": \"%29\", \"<\": \"%3C\", \">\": \"%3E\", \"\\\"\": \"%22\", \"'\": \"%27\", \"`\": \"%60\" }\nexport function sanitizeHref(href: string): string | null {\n  const trimmed = href.trim()\n  if (!trimmed || !SAFE_HREF_RE.test(trimmed)) return null\n  // 괄호 percent-encoding — 마크다운 링크 목적지에서 불균형 ')'는 링크를 조기 종료시켜\n  // 문법이 깨진다 (원문 하이퍼링크에 ')'가 박힌 실문서 존재). %28/%29는 의미 동일.\n  // 공백·<>\"'` 도 — 스킴만 보고 통과시키면 \"mailto:a <img src=x onerror=…>\" 가 링크 목적지를 깨고 날 태그로\n  // 렌더됐다(pdfjs 는 mailto·tel URI 를 정규화하지 않는다, v4.14.4 리뷰 재현). 인코딩해도 같은 주소다\n  return trimmed.replace(/[()<>\"'`]/g, c => HREF_ESCAPE[c]).replace(/\\s/g, c => encodeURIComponent(c))\n}\n\n/**\n * HTML 엔티티 이스케이프 — 글은 `& < >`, 속성값(attr)은 `\"` 까지. HTML 표 경로(builder tableToHtml)와\n * 인쇄 렌더러가 같이 쓰는 한 벌. 읽는 쪽은 unescapeHtml 로 푼다\n */\nexport function escapeHtml(text: string, attr = false): string {\n  const s = text.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\")\n  return attr ? s.replace(/\"/g, \"&quot;\") : s\n}\n\n/** escapeHtml 의 역 (+ 손으로 쓴 HTML 표의 &#39;) — 한 번에 풀어 \"&amp;lt;\" 는 \"&lt;\" 로 남는다 */\nexport function unescapeHtml(text: string): string {\n  return text.replace(/&(lt|gt|quot|#39|amp);/g, (_, e: string) => HTML_ENTITY[e])\n}\nconst HTML_ENTITY: Record<string, string> = { lt: \"<\", gt: \">\", quot: \"\\\"\", \"#39\": \"'\", amp: \"&\" }\n\n/**\n * console.log·info·warn·debug 를 stderr 로 — stdout 이 기계 출력 채널(MCP JSON-RPC·CLI 마크다운/JSON·parse-worker\n * NDJSON)인 진입점용. 라이브러리(pdfjs 등)가 console 로 찍는 경고가 그 채널을 깨지 않게 한다\n */\nexport function routeConsoleToStderr(): void {\n  const toStderr = (...args: unknown[]): void => void process.stderr.write(format(...args) + \"\\n\")\n  console.log = toStderr\n  console.info = toStderr\n  console.warn = toStderr\n  console.debug = toStderr\n}\n\n// ─── 안전한 min/max (스택 오버플로 방지) ─────────────\n\n/** Math.min(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMin(arr: number[]): number {\n  let min = Infinity\n  for (let i = 0; i < arr.length; i++) if (arr[i] < min) min = arr[i]\n  return min\n}\n\n/** Math.max(...arr) 대체 — 대형 배열에서 스택 오버플로 방지 */\nexport function safeMax(arr: number[]): number {\n  let max = -Infinity\n  for (let i = 0; i < arr.length; i++) if (arr[i] > max) max = arr[i]\n  return max\n}\n\n// ─── 에러 분류 ──────────────────────────────────────\n\nimport type { ErrorCode } from \"./types.js\"\n\n/** 에러를 구조화된 ErrorCode로 분류 — KordocError 메시지 패턴 매칭 */\n/** 선택 의존 설치 실패 안내 꼬리 — 네트워크가 막힌 linux/x64 에서 onnxruntime-node 설치 스크립트가 CUDA 바이너리를 받다 실패하면\n *  npm 이 sharp·@huggingface/transformers 까지 선택 의존 설치에서 뺀다(#99). npx 캐시 실행은 npm install 로 못 고친다 */\nexport const OPTIONAL_DEP_INSTALL_HINT =\n  \" 네트워크가 제한된 linux/x64 에서 npx 로 설치했다면 onnxruntime-node 의 CUDA 다운로드 실패로 함께 빠졌을 수 있습니다 — \" +\n  \"`ONNXRUNTIME_NODE_INSTALL=skip npx -y kordoc@^4 …` 로 다시 설치하세요.\"\n\nexport function classifyError(err: unknown): ErrorCode {\n  if (!(err instanceof Error)) return \"PARSE_ERROR\"\n  const msg = err.message\n  // 입력 파일 없음 — 문서 내용 문제가 아니라 호출자의 경로 문제라 PARSE_ERROR 로 덮지 않는다.\n  if (isFileNotFound(err)) return \"FILE_NOT_FOUND\"\n  // DRM 을 암호화보다 먼저 — \"DRM 암호화된 HWPX…\" 류 메시지가 ENCRYPTED 로 떨어지지 않도록\n  if (msg.includes(\"DRM\")) return \"DRM_PROTECTED\"\n  if (msg.includes(\"암호화\") || msg.includes(\"암호로 보호\")) return \"ENCRYPTED\"\n  if (msg.includes(\"optional dependency\")) return \"MISSING_DEPENDENCY\"\n  // V8 문자열 한계 초과 — 이미지 base64 총량이 큰 문서의 JSON 직렬화 (#65)\n  if (msg.includes(\"Invalid string length\") || msg.includes(\"Cannot create a string longer\")) return \"OUTPUT_TOO_LARGE\"\n  if (msg.includes(\"ZIP bomb\") || msg.includes(\"ZIP 비압축 크기 초과\") || msg.includes(\"ZIP 엔트리 수 초과\")) return \"ZIP_BOMB\"\n  if (msg.includes(\"bomb\") || msg.includes(\"크기 초과\") || msg.includes(\"압축 해제\")) return \"DECOMPRESSION_BOMB\"\n  if (msg.includes(\"이미지 기반\")) return \"IMAGE_BASED_PDF\"\n  if (msg.includes(\"섹션\") && (msg.includes(\"찾을 수 없\") || msg.includes(\"없음\"))) return \"NO_SECTIONS\"\n  if (msg.includes(\"시그니처\") || msg.includes(\"복구할 수 없\")) return \"CORRUPTED\"\n  return \"PARSE_ERROR\"\n}\n\n/** ZIP 파트 경로의 확장자 — 마지막 경로 조각에서만, 없으면 \"bin\". \"ppt/media.v2/image1\" 의 \"v2/image1\" 이 그림 파일 이름에 들어가\n *  저장 경로가 깨졌다 */\nexport function partExtension(path: string): string {\n  return (/\\.([A-Za-z0-9]{1,5})$/.exec(path.slice(path.lastIndexOf(\"/\") + 1))?.[1] ?? \"bin\").toLowerCase()\n}\n"]}