kordoc 4.16.2 → 4.17.0

package/dist/pdf-ocr-462ZFSHX.js

@@ -0,0 +1,15 @@
+import {
+  MAX_OCR_PIXELS,
+  ocrItemsToBlocks,
+  runPdfOcr
+} from "./chunk-TDQ6XDB3.js";
+import "./chunk-4XVNQAK5.js";
+import "./chunk-MJBCXW5R.js";
+import "./chunk-EFO6JZY6.js";
+import "./chunk-ML4NHUR7.js";
+export {
+  MAX_OCR_PIXELS,
+  ocrItemsToBlocks,
+  runPdfOcr
+};
+//# sourceMappingURL=pdf-ocr-462ZFSHX.js.map

package/dist/pdf-ocr-L35FQYGP.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import {
+  MAX_OCR_PIXELS,
+  ocrItemsToBlocks,
+  runPdfOcr
+} from "./chunk-4GSF2R7T.js";
+import "./chunk-WN6OD2CQ.js";
+import "./chunk-A55JGNKD.js";
+import "./chunk-BLPR4HRF.js";
+import "./chunk-BZG7K44Z.js";
+import "./chunk-5CDUL6PH.js";
+import "./chunk-ZF6KHPB7.js";
+export {
+  MAX_OCR_PIXELS,
+  ocrItemsToBlocks,
+  runPdfOcr
+};
+//# sourceMappingURL=pdf-ocr-L35FQYGP.js.map

package/dist/pdf-ocr-STK5EQFF.cjs

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunkO7OUX6NUcjs = require('./chunk-O7OUX6NU.cjs');
+require('./chunk-XEPKOC2O.cjs');
+require('./chunk-AKB72TEH.cjs');
+require('./chunk-WYON5ANU.cjs');
+require('./chunk-QNJLLF4J.cjs');
+require('./chunk-GS7T56RP.cjs');
+
+
+
+
+exports.MAX_OCR_PIXELS = _chunkO7OUX6NUcjs.MAX_OCR_PIXELS; exports.ocrItemsToBlocks = _chunkO7OUX6NUcjs.ocrItemsToBlocks; exports.runPdfOcr = _chunkO7OUX6NUcjs.runPdfOcr;
+//# sourceMappingURL=pdf-ocr-STK5EQFF.cjs.map

package/dist/pdf-ocr-STK5EQFF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/chris_gomdori/workspace/kordoc/dist/pdf-ocr-STK5EQFF.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACF,0KAAC","file":"/Users/chris_gomdori/workspace/kordoc/dist/pdf-ocr-STK5EQFF.cjs"}

package/dist/{profile-io-GJPKCYPT.js → profile-io-YZUW6MAN.js}

@@ -2,10 +2,10 @@
 import {
   formatProfileSchema,
   parseFormatProfileJson
-} from "./chunk-5KS5PWJR.js";
-import "./chunk-P6ZDXTV6.js";
+} from "./chunk-WY5JAR4O.js";
+import "./chunk-ZF6KHPB7.js";
 export {
   formatProfileSchema,
   parseFormatProfileJson
 };
-//# sourceMappingURL=profile-io-GJPKCYPT.js.map
+//# sourceMappingURL=profile-io-YZUW6MAN.js.map

package/dist/{rasterize-UOALJQDS.js → rasterize-OUR2QJXX.js}

@@ -3,11 +3,11 @@ import {
   loadSharp,
   rasterizePageSvg,
   rasterizeSvg
-} from "./chunk-S2PL227Q.js";
-import "./chunk-P6ZDXTV6.js";
+} from "./chunk-PHID6WNG.js";
+import "./chunk-ZF6KHPB7.js";
 export {
   loadSharp,
   rasterizePageSvg,
   rasterizeSvg
 };
-//# sourceMappingURL=rasterize-UOALJQDS.js.map
+//# sourceMappingURL=rasterize-OUR2QJXX.js.map

package/dist/{redact-doc-22SYW3KH.js → redact-doc-4OQKG4SM.js}

@@ -4,14 +4,14 @@ import {
   parse,
   replaceOleStream,
   wipeFreeSectors
-} from "./chunk-QOCS7W7R.js";
-import "./chunk-AUWGDP4G.js";
+} from "./chunk-K2VYABZ3.js";
+import "./chunk-2KF5WZCR.js";
 import {
   allLinesegRemovalSplices,
   findElementEnd,
   patchZipEntries,
   scanSectionXml
-} from "./chunk-4VODJKFL.js";
+} from "./chunk-6RGGYQQC.js";
 import {
   DEFAULT_REDACT_RULES,
   mdMarkerRanges,
@@ -20,7 +20,7 @@ import {
   redactMarkdown,
   redactText
 } from "./chunk-3WSNLH4B.js";
-import "./chunk-GO5IFOUF.js";
+import "./chunk-N6V7LQBL.js";
 import {
   FLAG_COMPRESSED,
   FLAG_DISTRIBUTION,
@@ -36,14 +36,14 @@ import {
   isExtendedOnlyCtrlChar,
   parseFileHeader,
   readRecords
-} from "./chunk-IQGIT2VX.js";
+} from "./chunk-QJWVMPB6.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-J3IF6KGW.js";
+import "./chunk-5CDUL6PH.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-JFLAM3MM.js";
-import "./chunk-LEIAEWZ7.js";
-import "./chunk-S2PL227Q.js";
-import "./chunk-P6ZDXTV6.js";
+import "./chunk-I5DJOP62.js";
+import "./chunk-BFT5IM2R.js";
+import "./chunk-PHID6WNG.js";
+import "./chunk-ZF6KHPB7.js";
 
 // src/redact-scrub.ts
 import { createRequire } from "module";
@@ -1282,4 +1282,4 @@ function markdownLeftovers(markdown, ctx) {
 export {
   redactDocument
 };
-//# sourceMappingURL=redact-doc-22SYW3KH.js.map
+//# sourceMappingURL=redact-doc-4OQKG4SM.js.map

package/dist/{render-MJ4H3R23.js → render-XNO6PZJO.js}

@@ -15,17 +15,17 @@ import {
   renderHwpxToSvg,
   renderSceneToHtml,
   unionBBox
-} from "./chunk-IQGIT2VX.js";
+} from "./chunk-QJWVMPB6.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-J3IF6KGW.js";
+import "./chunk-5CDUL6PH.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-JFLAM3MM.js";
-import "./chunk-LEIAEWZ7.js";
+import "./chunk-I5DJOP62.js";
+import "./chunk-BFT5IM2R.js";
 import {
   rasterizePageSvg,
   rasterizeSvg
-} from "./chunk-S2PL227Q.js";
-import "./chunk-P6ZDXTV6.js";
+} from "./chunk-PHID6WNG.js";
+import "./chunk-ZF6KHPB7.js";
 export {
   RegionCollector,
   buildHwp5RenderStyles,
@@ -45,4 +45,4 @@ export {
   renderSceneToHtml,
   unionBBox
 };
-//# sourceMappingURL=render-MJ4H3R23.js.map
+//# sourceMappingURL=render-XNO6PZJO.js.map

package/dist/seal-CJ7C44JN.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import {
+  placeSealHwpx
+} from "./chunk-6RGGYQQC.js";
+import "./chunk-I5DJOP62.js";
+import "./chunk-ZF6KHPB7.js";
+export {
+  placeSealHwpx
+};
+//# sourceMappingURL=seal-CJ7C44JN.js.map

package/dist/{setup-2URYVUEO.js → setup-UU3EIHNI.js}

@@ -2,8 +2,8 @@
 import {
   getAccessRoot,
   isOfflineMode
-} from "./chunk-JELRWAZC.js";
-import "./chunk-P6ZDXTV6.js";
+} from "./chunk-BZG7K44Z.js";
+import "./chunk-ZF6KHPB7.js";
 
 // src/setup.ts
 import { createInterface } from "readline/promises";
@@ -243,4 +243,4 @@ function printManualConfig() {
 export {
   runSetup
 };
-//# sourceMappingURL=setup-2URYVUEO.js.map
+//# sourceMappingURL=setup-UU3EIHNI.js.map

package/dist/visual-QRMRFPUK.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import {
+  extractTables
+} from "./chunk-K2VYABZ3.js";
+import "./chunk-2KF5WZCR.js";
+import "./chunk-6RGGYQQC.js";
+import "./chunk-3WSNLH4B.js";
+import "./chunk-N6V7LQBL.js";
+import "./chunk-QJWVMPB6.js";
+import "./chunk-7FCNOKOR.js";
+import "./chunk-5CDUL6PH.js";
+import "./chunk-VQFA55IC.js";
+import "./chunk-I5DJOP62.js";
+import "./chunk-BFT5IM2R.js";
+import "./chunk-PHID6WNG.js";
+import "./chunk-ZF6KHPB7.js";
+export {
+  extractTables
+};
+//# sourceMappingURL=visual-QRMRFPUK.js.map

package/dist/{watch-ALXZGTOB.js → watch-SR6Q5SQN.js}

@@ -1,26 +1,26 @@
 #!/usr/bin/env node
 import {
   assertNetworkAllowed
-} from "./chunk-JELRWAZC.js";
+} from "./chunk-BZG7K44Z.js";
 import {
   parse
-} from "./chunk-QOCS7W7R.js";
-import "./chunk-AUWGDP4G.js";
-import "./chunk-4VODJKFL.js";
+} from "./chunk-K2VYABZ3.js";
+import "./chunk-2KF5WZCR.js";
+import "./chunk-6RGGYQQC.js";
 import "./chunk-3WSNLH4B.js";
-import "./chunk-GO5IFOUF.js";
+import "./chunk-N6V7LQBL.js";
 import {
   detectFormat
-} from "./chunk-IQGIT2VX.js";
+} from "./chunk-QJWVMPB6.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-J3IF6KGW.js";
+import "./chunk-5CDUL6PH.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-JFLAM3MM.js";
-import "./chunk-LEIAEWZ7.js";
-import "./chunk-S2PL227Q.js";
+import "./chunk-I5DJOP62.js";
+import "./chunk-BFT5IM2R.js";
+import "./chunk-PHID6WNG.js";
 import {
   toArrayBuffer
-} from "./chunk-P6ZDXTV6.js";
+} from "./chunk-ZF6KHPB7.js";
 
 // src/watch.ts
 import { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync, realpathSync } from "fs";
@@ -256,4 +256,4 @@ export {
   postWebhookToAddress,
   watchDirectory
 };
-//# sourceMappingURL=watch-ALXZGTOB.js.map
+//# sourceMappingURL=watch-SR6Q5SQN.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kordoc",
-  "version": "4.16.2",
+  "version": "4.17.0",
   "description": "Parse Korean documents (HWP3-5, HWPX, HWPML, PDF, XLS(X), DOCX) to Markdown — CLI + MCP server with lossless patch/roundtrip, form-filler, document diff, print & layout-preserving SVG renderer",
   "type": "module",
   "exports": {
@@ -28,7 +28,7 @@
     "dev": "tsup --watch",
     "test": "node --import tsx --test tests/*.test.ts",
     "typecheck": "tsc --noEmit",
-    "bench:gate": "node bench/verify-pages.mjs --gate && node bench/score.mjs && node bench/roundtrip.mjs --gate && node bench/pdf-table-gt.mjs --gate --no-ocr && node bench/pdf-text-gt.mjs --gate && node bench/formats-sweep.mjs --gate && node bench/fuzz-sweep.mjs --gate && node bench/verify-reflow.mjs --gate && node bench/redact-bench.mjs --gate && node bench/ocr-accuracy.mjs --gate",
+    "bench:gate": "node bench/verify-pages.mjs --gate && node bench/score.mjs && node bench/roundtrip.mjs --gate && node bench/pdf-table-gt.mjs --gate --no-ocr && node bench/pdf-text-gt.mjs --gate && node bench/annex-gt.mjs --gate && node bench/formats-sweep.mjs --gate && node bench/fuzz-sweep.mjs --gate && node bench/verify-reflow.mjs --gate && node bench/redact-bench.mjs --gate && node bench/ocr-accuracy.mjs --gate",
     "bench:visual": "node bench/visual/verify-visual.mjs --gate",
     "sync-meta": "node scripts/sync-meta.mjs",
     "prepublishOnly": "node scripts/sync-meta.mjs --check && node scripts/check-notices.mjs && npm run typecheck && npm run test && npm run build && node bench/gate-if-corpus.mjs"

package/dist/chunk-3IB7LBHC.js

@@ -1,57 +0,0 @@
-// src/script-tags.ts
-function wrapScript(text, kind) {
-  if (!kind) return text;
-  const m = /^(\s*)([\s\S]*?)(\s*)$/.exec(text);
-  return m[2] ? `${m[1]}<${kind}>${m[2]}</${kind}>${m[3]}` : text;
-}
-function tidyScriptTags(text) {
-  if (!text.includes("<su")) return text;
-  return text.replace(/<\/(sup|sub)><\1>/g, "").replace(/<(sup|sub)>(\s+)/g, "$2<$1>").replace(/(\s+)<\/(sup|sub)>/g, "</$2>$1").replace(/<(sup|sub)><\/\1>/g, "");
-}
-function plainScripts(md) {
-  if (!md.includes("<su")) return md;
-  return md.replace(/<(sup|sub)>([^<\n]*)<\/\1>/g, (_, kind, body) => {
-    const mark = kind === "sup" ? "^" : "_";
-    return /^(?:[+\-−]?[\p{L}\p{N}]+|[*∗†‡§¶]+)$/u.test(body) ? mark + body : `${mark}(${body})`;
-  });
-}
-var TAG_RE = /<\/?su[bp]>/g;
-function stripScriptTags(r) {
-  const s = (t) => t.includes("<su") ? t.replace(TAG_RE, "") : t;
-  const walk = (bs) => {
-    for (const b of bs ?? []) {
-      if (b.text) b.text = s(b.text);
-      if (b.footnoteText) b.footnoteText = s(b.footnoteText);
-      for (const sp of b.spans ?? []) sp.text = s(sp.text);
-      walk(b.children);
-      if (b.table) {
-        if (b.table.caption) b.table.caption = s(b.table.caption);
-        walk(b.table.captionBlocks);
-        for (const row of b.table.cells) for (const c of row) {
-          c.text = s(c.text);
-          walk(c.blocks);
-        }
-      }
-    }
-  };
-  walk(r.blocks);
-  if (r.markdown) r.markdown = s(r.markdown);
-  for (const p of r.pages ?? []) p.markdown = s(p.markdown);
-  return r;
-}
-
-// src/types.ts
-var HEADING_RATIO_H1 = 1.5;
-var HEADING_RATIO_H2 = 1.3;
-var HEADING_RATIO_H3 = 1.15;
-
-export {
-  wrapScript,
-  tidyScriptTags,
-  plainScripts,
-  stripScriptTags,
-  HEADING_RATIO_H1,
-  HEADING_RATIO_H2,
-  HEADING_RATIO_H3
-};
-//# sourceMappingURL=chunk-3IB7LBHC.js.map

package/dist/chunk-3IB7LBHC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/script-tags.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/** 첨자 글을 태그로 감싼다 — 앞뒤 공백은 태그 밖으로, 공백뿐이면 그대로 */\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  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\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","/** 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열 데이터 표. 목록성 1열 틀의 평탄화와 구분한다. */\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  /** 렌더 인프라가 준 페이지 로컬 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), \"section\": 섹션 단위 근사\n   * (조판 캐시 없는 생성 파일). HWP/HWPX/PDF에서만 설정된다.\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  /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n   *  기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n   *  양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n  keepTrailingEmptyCols?: boolean\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   * 않아, 그 상한 뒤의 그림도 자리 표시가 남는다.\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/** 감지된 파일 형식. pptx는 감지만 지원하며 파싱 시 UNSUPPORTED_FORMAT을 반환한다. */\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":";AAWO,SAAS,WAAW,MAAc,MAA6C;AACpF,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,IAAI,yBAAyB,KAAK,IAAI;AAC5C,SAAO,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK;AAC7D;AAGO,SAAS,eAAe,MAAsB;AACnD,MAAI,CAAC,KAAK,SAAS,KAAK,EAAG,QAAO;AAClC,SAAO,KACJ,QAAQ,sBAAsB,EAAE,EAChC,QAAQ,qBAAqB,QAAQ,EACrC,QAAQ,uBAAuB,SAAS,EACxC,QAAQ,sBAAsB,EAAE;AACrC;AAMO,SAAS,aAAa,IAAoB;AAC/C,MAAI,CAAC,GAAG,SAAS,KAAK,EAAG,QAAO;AAChC,SAAO,GAAG,QAAQ,+BAA+B,CAAC,GAAG,MAAc,SAAiB;AAClF,UAAM,OAAO,SAAS,QAAQ,MAAM;AACpC,WAAO,wCAAwC,KAAK,IAAI,IAAI,OAAO,OAAO,GAAG,IAAI,IAAI,IAAI;AAAA,EAC3F,CAAC;AACH;AAEA,IAAM,SAAS;AAMR,SAAS,gBAA0G,GAAS;AACjI,QAAM,IAAI,CAAC,MAAe,EAAE,SAAS,KAAK,IAAI,EAAE,QAAQ,QAAQ,EAAE,IAAI;AACtE,QAAM,OAAO,CAAC,OAAoC;AAChD,eAAW,KAAK,MAAM,CAAC,GAAG;AACxB,UAAI,EAAE,KAAM,GAAE,OAAO,EAAE,EAAE,IAAI;AAC7B,UAAI,EAAE,aAAc,GAAE,eAAe,EAAE,EAAE,YAAY;AACrD,iBAAW,MAAM,EAAE,SAAS,CAAC,EAAG,IAAG,OAAO,EAAE,GAAG,IAAI;AACnD,WAAK,EAAE,QAAQ;AACf,UAAI,EAAE,OAAO;AACX,YAAI,EAAE,MAAM,QAAS,GAAE,MAAM,UAAU,EAAE,EAAE,MAAM,OAAO;AACxD,aAAK,EAAE,MAAM,aAAa;AAC1B,mBAAW,OAAO,EAAE,MAAM,MAAO,YAAW,KAAK,KAAK;AAAE,YAAE,OAAO,EAAE,EAAE,IAAI;AAAG,eAAK,EAAE,MAAM;AAAA,QAAE;AAAA,MAC7F;AAAA,IACF;AAAA,EACF;AACA,OAAK,EAAE,MAAM;AACb,MAAI,EAAE,SAAU,GAAE,WAAW,EAAE,EAAE,QAAQ;AACzC,aAAW,KAAK,EAAE,SAAS,CAAC,EAAG,GAAE,WAAW,EAAE,EAAE,QAAQ;AACxD,SAAO;AACT;;;AC6hBO,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;","names":[]}

package/dist/chunk-62W7QCEX.cjs

@@ -1,57 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/script-tags.ts
-function wrapScript(text, kind) {
-  if (!kind) return text;
-  const m = /^(\s*)([\s\S]*?)(\s*)$/.exec(text);
-  return m[2] ? `${m[1]}<${kind}>${m[2]}</${kind}>${m[3]}` : text;
-}
-function tidyScriptTags(text) {
-  if (!text.includes("<su")) return text;
-  return text.replace(/<\/(sup|sub)><\1>/g, "").replace(/<(sup|sub)>(\s+)/g, "$2<$1>").replace(/(\s+)<\/(sup|sub)>/g, "</$2>$1").replace(/<(sup|sub)><\/\1>/g, "");
-}
-function plainScripts(md) {
-  if (!md.includes("<su")) return md;
-  return md.replace(/<(sup|sub)>([^<\n]*)<\/\1>/g, (_, kind, body) => {
-    const mark = kind === "sup" ? "^" : "_";
-    return /^(?:[+\-−]?[\p{L}\p{N}]+|[*∗†‡§¶]+)$/u.test(body) ? mark + body : `${mark}(${body})`;
-  });
-}
-var TAG_RE = /<\/?su[bp]>/g;
-function stripScriptTags(r) {
-  const s = (t) => t.includes("<su") ? t.replace(TAG_RE, "") : t;
-  const walk = (bs) => {
-    for (const b of _nullishCoalesce(bs, () => ( []))) {
-      if (b.text) b.text = s(b.text);
-      if (b.footnoteText) b.footnoteText = s(b.footnoteText);
-      for (const sp of _nullishCoalesce(b.spans, () => ( []))) sp.text = s(sp.text);
-      walk(b.children);
-      if (b.table) {
-        if (b.table.caption) b.table.caption = s(b.table.caption);
-        walk(b.table.captionBlocks);
-        for (const row of b.table.cells) for (const c of row) {
-          c.text = s(c.text);
-          walk(c.blocks);
-        }
-      }
-    }
-  };
-  walk(r.blocks);
-  if (r.markdown) r.markdown = s(r.markdown);
-  for (const p of _nullishCoalesce(r.pages, () => ( []))) p.markdown = s(p.markdown);
-  return r;
-}
-
-// src/types.ts
-var HEADING_RATIO_H1 = 1.5;
-var HEADING_RATIO_H2 = 1.3;
-var HEADING_RATIO_H3 = 1.15;
-
-
-
-
-
-
-
-
-
-exports.wrapScript = wrapScript; exports.tidyScriptTags = tidyScriptTags; exports.plainScripts = plainScripts; exports.stripScriptTags = stripScriptTags; exports.HEADING_RATIO_H1 = HEADING_RATIO_H1; exports.HEADING_RATIO_H2 = HEADING_RATIO_H2; exports.HEADING_RATIO_H3 = HEADING_RATIO_H3;
-//# sourceMappingURL=chunk-62W7QCEX.cjs.map

package/dist/chunk-62W7QCEX.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-62W7QCEX.cjs","../src/script-tags.ts","../src/types.ts"],"names":[],"mappings":"AAAA;ACWO,SAAS,UAAA,CAAW,IAAA,EAAc,IAAA,EAA6C;AACpF,EAAA,GAAA,CAAI,CAAC,IAAA,EAAM,OAAO,IAAA;AAClB,EAAA,MAAM,EAAA,EAAI,wBAAA,CAAyB,IAAA,CAAK,IAAI,CAAA;AAC5C,EAAA,OAAO,CAAA,CAAE,CAAC,EAAA,EAAI,CAAA,EAAA;AAChB;AAGgB;AACJ,EAAA;AAEP,EAAA;AAIL;AAMgB;AACN,EAAA;AACE,EAAA;AACK,IAAA;AACN,IAAA;AACR,EAAA;AACH;AAEe;AAMC;AACH,EAAA;AACG,EAAA;AACD,IAAA;AACG,MAAA;AACN,MAAA;AACK,MAAA;AACJ,MAAA;AACD,MAAA;AACE,QAAA;AACC,QAAA;AACP,QAAA;AAA0D,UAAA;AAAyB,UAAA;AAAQ,QAAA;AAC7F,MAAA;AACF,IAAA;AACF,EAAA;AACa,EAAA;AACG,EAAA;AACL,EAAA;AACJ,EAAA;AACT;ADvBiB;AACA;AEmjBJ;AACA;AACA;AFjjBI;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/mong-e/workspace/kordoc/dist/chunk-62W7QCEX.cjs","sourcesContent":[null,"/**\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/** 첨자 글을 태그로 감싼다 — 앞뒤 공백은 태그 밖으로, 공백뿐이면 그대로 */\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  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\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","/** 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열 데이터 표. 목록성 1열 틀의 평탄화와 구분한다. */\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  /** 렌더 인프라가 준 페이지 로컬 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), \"section\": 섹션 단위 근사\n   * (조판 캐시 없는 생성 파일). HWP/HWPX/PDF에서만 설정된다.\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  /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n   *  기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n   *  양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n  keepTrailingEmptyCols?: boolean\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   * 않아, 그 상한 뒤의 그림도 자리 표시가 남는다.\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/** 감지된 파일 형식. pptx는 감지만 지원하며 파싱 시 UNSUPPORTED_FORMAT을 반환한다. */\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"]}

package/dist/chunk-CEIATRDW.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-CEIATRDW.cjs","../src/pdf/formula/models.ts","../src/shared/offline.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;ACMA,gCAA2B;AAC3B,wBAAiC;AACjC,uCAA4C;AAC5C;AACA,wBAAwB;AACxB,4BAA8B;AAC9B,4CAAyB;AACzB,gCAAyB;ADJzB;AACA;AEKA,IAAM,OAAA,kBAAS,IAAI,GAAA,CAAI,CAAC,GAAA,EAAK,MAAA,EAAQ,KAAA,EAAO,IAAI,CAAC,CAAA;AAEjD,SAAS,OAAA,CAAQ,IAAA,EAAuB;AACtC,EAAA,MAAM,EAAA,EAAI,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA;AAC1B,EAAA,OAAO,CAAC,CAAC,EAAA,GAAK,MAAA,CAAO,GAAA,CAAI,CAAA,CAAE,IAAA,CAAK,CAAA,CAAE,WAAA,CAAY,CAAC,CAAA;AACjD;AAGO,SAAS,aAAA,CAAA,EAAyB;AACvC,EAAA,OAAO,OAAA,CAAQ,gBAAgB,CAAA;AACjC;AAOO,SAAS,oBAAA,CAAqB,IAAA,EAAc,IAAA,EAAqB;AACtE,EAAA,GAAA,CAAI,CAAC,aAAA,CAAc,CAAA,EAAG,MAAA;AACtB,EAAA,MAAM,IAAI,kCAAA;AAAA,IACR,CAAA,gFAAA,EAAiC,IAAI,CAAA,EAAA;AACvC,EAAA;AACF;AFZ4F;AACA;ACDxD;AAC5B,EAAA;AACI,EAAA;AACL,EAAA;AACG,EAAA;AACA,EAAA;AACV;AAE4C;AACpC,EAAA;AACI,EAAA;AACL,EAAA;AACG,EAAA;AACA,EAAA;AACV;AAE4C;AACpC,EAAA;AACI,EAAA;AACL,EAAA;AACG,EAAA;AACA,EAAA;AACV;AAEwC;AAChC,EAAA;AACI,EAAA;AACL,EAAA;AACG,EAAA;AACA,EAAA;AACV;AAE4D;AAC1D,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACF;AAOqD;AACtB,EAAA;AACI,EAAA;AACH,IAAA;AAC9B,EAAA;AAC2D,EAAA;AAC7D;AAE8C;AACd,EAAA;AAChC;AAa6G;AAC5E,EAAA;AACL,EAAA;AACiB,IAAA;AAC5B,IAAA;AACT,IAAA;AAC4B,MAAA;AACE,MAAA;AAC1B,IAAA;AACG,MAAA;AACX,IAAA;AACa,IAAA;AACoD,MAAA;AAC/D,MAAA;AACF,IAAA;AACI,IAAA;AACyC,MAAA;AACf,MAAA;AACmC,QAAA;AACxD,MAAA;AACO,QAAA;AACV,UAAA;AACA,UAAA;AACQ,UAAA;AACE,UAAA;AAC4D,UAAA;AACvE,QAAA;AACH,MAAA;AACU,IAAA;AACE,MAAA;AACV,QAAA;AACA,QAAA;AACQ,QAAA;AACE,QAAA;AACgD,QAAA;AAC3D,MAAA;AACH,IAAA;AACF,EAAA;AACO,EAAA;AACT;AAGsE;AACH,EAAA;AACnE;AAoBgI;AAC1F,EAAA;AAEV,EAAA;AACiB,IAAA;AAEU,IAAA;AACpC,sBAAA;AACX,QAAA;AACY,QAAA;AACL,QAAA;AACA,QAAA;AACE,QAAA;AACV,MAAA;AACD,MAAA;AACF,IAAA;AAGI,IAAA;AACoB,MAAA;AAChB,IAAA;AAER,IAAA;AAEgD,IAAA;AAClD,EAAA;AACF;AAGuF;AACV,EAAA;AAC7E;AAGsG;AACpE,EAAA;AACI,EAAA;AACK,EAAA;AACU,EAAA;AACe,oBAAA;AAChE,IAAA;AACF,EAAA;AACI,EAAA;AACoB,IAAA;AAChB,EAAA;AAER,EAAA;AACgD,EAAA;AAClD;AAE4F;AACtF,EAAA;AAC4B,IAAA;AACU,IAAA;AAClC,EAAA;AACC,IAAA;AACT,EAAA;AACI,EAAA;AACyC,IAAA;AACzB,IAAA;AACZ,EAAA;AACC,IAAA;AACT,EAAA;AACF;AAMiB;AAEf,EAAA;AACc,IAAA;AACZ,IAAA;AACF,EAAA;AAG6B,EAAA;AACsB,EAAA;AAEhB,EAAA;AACxB,IAAA;AAAA;AAEO,MAAA;AAChB,IAAA;AACD,EAAA;AAC2B,EAAA;AAChB,IAAA;AAC0C,MAAA;AACpD,IAAA;AACF,EAAA;AAEmD,EAAA;AACQ,EAAA;AAC1C,EAAA;AAEoB,EAAA;AACjC,EAAA;AACyF,IAAA;AACzC,IAAA;AAC5B,MAAA;AACP,sBAAA;AACX,QAAA;AACA,QAAA;AACA,QAAA;AACO,QAAA;AACR,MAAA;AACF,IAAA;AACwB,IAAA;AACf,EAAA;AACN,IAAA;AACmB,MAAA;AACf,IAAA;AAER,IAAA;AAC+D,IAAA;AACjE,EAAA;AAEa,kBAAA;AACX,IAAA;AACA,IAAA;AACA,IAAA;AACO,IAAA;AACR,EAAA;AAGG,EAAA;AACA,EAAA;AACkC,IAAA;AAC1B,EAAA;AACN,IAAA;AACmB,MAAA;AACf,IAAA;AAER,IAAA;AACiE,IAAA;AACnE,EAAA;AAE4B,EAAA;AACtB,IAAA;AACmB,MAAA;AACf,IAAA;AAER,IAAA;AACU,IAAA;AAC4D,MAAA;AACtE,IAAA;AACF,EAAA;AAEgC,EAAA;AACnB,kBAAA;AACX,IAAA;AACA,IAAA;AACA,IAAA;AACO,IAAA;AACR,EAAA;AACH;AAEwD;AACzB,EAAA;AACI,EAAA;AACY,EAAA;AACZ,IAAA;AACf,MAAA;AAEhB,IAAA;AACD,EAAA;AACoB,EAAA;AACvB;AD1E4F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/mong-e/workspace/kordoc/dist/chunk-CEIATRDW.cjs","sourcesContent":[null,"/**\n * 수식 OCR 모델 자동 다운로드 + SHA-256 검증\n *\n * 캐시 위치: `~/.cache/kordoc/models/pix2text/`\n * 총 ~155MB (MFD 44MB + MFR encoder 87MB + MFR decoder 30MB + tokenizer 40KB)\n *\n * HF URL + SHA 는 Docufinder archive/rust-formula-ocr-wip 에서 검증 완료됨.\n * 모델 버전 갱신 시 URL + SHA 를 함께 갱신해야 한다.\n */\n\nimport { createHash } from \"crypto\"\nimport { createReadStream } from \"fs\"\nimport { mkdir, stat, unlink, rename } from \"fs/promises\"\nimport { createWriteStream } from \"fs\"\nimport { homedir } from \"os\"\nimport { join, dirname } from \"path\"\nimport { pipeline } from \"stream/promises\"\nimport { Readable } from \"stream\"\nimport { assertNetworkAllowed } from \"../../shared/offline.js\"\n\nexport interface ModelSpec {\n  name: string\n  filename: string\n  url: string\n  sha256: string\n  sizeMb: number\n}\n\n/** 모델 스펙 (SHA-256 은 실제 다운로드로 검증됨 — 변경 금지) */\nexport const MFD_MODEL: ModelSpec = {\n  name: \"Pix2Text MFD\",\n  filename: \"mfd.onnx\",\n  url: \"https://huggingface.co/breezedeus/pix2text-mfd/resolve/main/mfd-v20240618.onnx\",\n  sha256: \"51a8854743b17ae654729af8db82a630c1ccfa06debf4856c8b28055f87d02c1\",\n  sizeMb: 42,\n}\n\nexport const MFR_ENCODER_MODEL: ModelSpec = {\n  name: \"Pix2Text MFR encoder\",\n  filename: \"encoder_model.onnx\",\n  url: \"https://huggingface.co/breezedeus/pix2text-mfr/resolve/main/encoder_model.onnx\",\n  sha256: \"bd8d5c322792e9ec45793af5569e9748f82a3d728a9e00213dbfc56c1486f37d\",\n  sizeMb: 87,\n}\n\nexport const MFR_DECODER_MODEL: ModelSpec = {\n  name: \"Pix2Text MFR decoder\",\n  filename: \"decoder_model.onnx\",\n  url: \"https://huggingface.co/breezedeus/pix2text-mfr/resolve/main/decoder_model.onnx\",\n  sha256: \"fd0f92d7a012f3dae41e1ac79421aea0ea888b5a66cb3f9a004e424f82f3daed\",\n  sizeMb: 30,\n}\n\nexport const MFR_TOKENIZER: ModelSpec = {\n  name: \"Pix2Text MFR tokenizer\",\n  filename: \"tokenizer.json\",\n  url: \"https://huggingface.co/breezedeus/pix2text-mfr/resolve/main/tokenizer.json\",\n  sha256: \"3e2ab757277d22639bec28c9d7972e352d3d1dba223051fa674002dc5ab64df3\",\n  sizeMb: 1,\n}\n\nexport const ALL_FORMULA_MODELS: ReadonlyArray<ModelSpec> = [\n  MFD_MODEL,\n  MFR_ENCODER_MODEL,\n  MFR_DECODER_MODEL,\n  MFR_TOKENIZER,\n]\n\n/**\n * 모델 캐시 하위 디렉토리 경로. 환경 변수 `KORDOC_MODEL_CACHE` 가 설정되면\n * 해당 경로를 우선 사용, 없으면 `~/.cache/kordoc/models/<subdir>/`.\n * (수식 OCR 외 텍스트 OCR 등 다른 모델군도 공용 — subdir 로 격리)\n */\nexport function getModelsDir(subdir: string): string {\n  const override = process.env.KORDOC_MODEL_CACHE\n  if (override && override.trim()) {\n    return join(override, subdir)\n  }\n  return join(homedir(), \".cache\", \"kordoc\", \"models\", subdir)\n}\n\nexport function getFormulaModelsDir(): string {\n  return getModelsDir(\"pix2text\")\n}\n\nexport interface ModelStatus {\n  spec: ModelSpec\n  localPath: string\n  exists: boolean\n  /** SHA 검증까지 끝났는가 (exists && valid) */\n  verified: boolean\n  /** 검증 실패 시 이유 */\n  invalidReason?: string\n}\n\n/** 지정 모델군의 존재/유효성 상태 반환 (다운로드 없이 확인만) */\nexport async function getModelStatusIn(dir: string, specs: ReadonlyArray<ModelSpec>): Promise<ModelStatus[]> {\n  const result: ModelStatus[] = []\n  for (const spec of specs) {\n    const localPath = join(dir, spec.filename)\n    let exists = false\n    try {\n      const s = await stat(localPath)\n      exists = s.isFile() && s.size > 0\n    } catch {\n      exists = false\n    }\n    if (!exists) {\n      result.push({ spec, localPath, exists: false, verified: false })\n      continue\n    }\n    try {\n      const actual = await sha256OfFile(localPath)\n      if (actual === spec.sha256) {\n        result.push({ spec, localPath, exists: true, verified: true })\n      } else {\n        result.push({\n          spec,\n          localPath,\n          exists: true,\n          verified: false,\n          invalidReason: `SHA256 mismatch: expected ${spec.sha256}, got ${actual}`,\n        })\n      }\n    } catch (e) {\n      result.push({\n        spec,\n        localPath,\n        exists: true,\n        verified: false,\n        invalidReason: `SHA compute failed: ${(e as Error).message}`,\n      })\n    }\n  }\n  return result\n}\n\n/** 모든 수식 모델의 존재/유효성 상태 반환 (다운로드 없이 확인만) */\nexport async function getFormulaModelStatus(): Promise<ModelStatus[]> {\n  return getModelStatusIn(getFormulaModelsDir(), ALL_FORMULA_MODELS)\n}\n\nexport interface DownloadProgress {\n  spec: ModelSpec\n  /** 현재까지 다운로드한 바이트 */\n  downloaded: number\n  /** 전체 바이트 (알 수 있으면) */\n  total: number | null\n  /** \"download\" | \"verify\" | \"done\" | \"skip\" */\n  phase: \"download\" | \"verify\" | \"done\" | \"skip\" | \"error\"\n  message?: string\n}\n\nexport type ProgressHandler = (p: DownloadProgress) => void\n\n/**\n * 지정 모델군을 다운로드/검증한다.\n * - 이미 있고 SHA 일치 → skip\n * - 없음 → 다운로드 후 SHA 검증. 실패 시 파일 삭제.\n */\nexport async function ensureModelsIn(dir: string, specs: ReadonlyArray<ModelSpec>, onProgress?: ProgressHandler): Promise<void> {\n  await mkdir(dir, { recursive: true })\n\n  for (const spec of specs) {\n    const localPath = join(dir, spec.filename)\n\n    if (await isExistingValid(localPath, spec.sha256)) {\n      onProgress?.({\n        spec,\n        downloaded: 0,\n        total: null,\n        phase: \"skip\",\n        message: \"이미 존재 + SHA 일치\",\n      })\n      continue\n    }\n\n    // 기존 파일 있지만 SHA 불일치 → 삭제\n    try {\n      await unlink(localPath)\n    } catch {\n      // 없을 수 있음\n    }\n\n    await downloadToFile(spec, localPath, onProgress)\n  }\n}\n\n/** 필요한 모든 수식 모델을 다운로드/검증한다. */\nexport async function ensureFormulaModels(onProgress?: ProgressHandler): Promise<void> {\n  return ensureModelsIn(getFormulaModelsDir(), ALL_FORMULA_MODELS, onProgress)\n}\n\n/** 단일 모델만 확인/다운로드 (진단 UI 에서 개별 상태 새로고침용) */\nexport async function ensureSingleModel(spec: ModelSpec, onProgress?: ProgressHandler): Promise<void> {\n  const dir = getFormulaModelsDir()\n  await mkdir(dir, { recursive: true })\n  const localPath = join(dir, spec.filename)\n  if (await isExistingValid(localPath, spec.sha256)) {\n    onProgress?.({ spec, downloaded: 0, total: null, phase: \"skip\" })\n    return\n  }\n  try {\n    await unlink(localPath)\n  } catch {\n    // 재다운로드 전 손상/잔존 파일 정리 best-effort — 애초에 없으면 실패해도 무방\n  }\n  await downloadToFile(spec, localPath, onProgress)\n}\n\nasync function isExistingValid(localPath: string, sha256Expected: string): Promise<boolean> {\n  try {\n    const s = await stat(localPath)\n    if (!s.isFile() || s.size === 0) return false\n  } catch {\n    return false\n  }\n  try {\n    const actual = await sha256OfFile(localPath)\n    return actual === sha256Expected\n  } catch {\n    return false\n  }\n}\n\nasync function downloadToFile(\n  spec: ModelSpec,\n  localPath: string,\n  onProgress?: ProgressHandler,\n): Promise<void> {\n  // 폐쇄망 모드에서는 요청 자체를 보내지 않는다 (사이드로드 안내로 대체)\n  assertNetworkAllowed(\n    `${spec.name} 모델 다운로드`,\n    \"온라인 PC에서 `kordoc models --export <디렉토리>` 로 내보낸 뒤 이 PC에서 `kordoc models --import <디렉토리>` 하거나, KORDOC_MODEL_CACHE 로 모델 캐시 경로를 지정하세요\",\n  )\n\n  // 먼저 .part 로 받고 검증 후 rename — 중단된 다운로드가 \"정상 파일\"로 오인되는 걸 방지\n  const partPath = `${localPath}.part`\n  await mkdir(dirname(localPath), { recursive: true })\n\n  const resp = await fetch(spec.url, {\n    headers: {\n      // HF CDN 은 UA 없으면 가끔 403 을 뱉는다\n      \"User-Agent\": \"kordoc-formula-ocr/1.0 (+https://github.com/chrisryugj/kordoc)\",\n    },\n  })\n  if (!resp.ok || !resp.body) {\n    throw new Error(\n      `${spec.name} 다운로드 실패: HTTP ${resp.status} ${resp.statusText} (${spec.url})`,\n    )\n  }\n\n  const lenHeader = resp.headers.get(\"content-length\")\n  const total = lenHeader ? Number.parseInt(lenHeader, 10) : null\n  let downloaded = 0\n\n  const ws = createWriteStream(partPath)\n  try {\n    const reader = Readable.fromWeb(resp.body as unknown as import(\"stream/web\").ReadableStream)\n    reader.on(\"data\", (chunk: Buffer | Uint8Array) => {\n      downloaded += chunk.length\n      onProgress?.({\n        spec,\n        downloaded,\n        total,\n        phase: \"download\",\n      })\n    })\n    await pipeline(reader, ws)\n  } catch (e) {\n    try {\n      await unlink(partPath)\n    } catch {\n      // .part 임시파일 정리 best-effort — 본 에러(스트리밍 실패)를 가리지 않도록 무시\n    }\n    throw new Error(`${spec.name} 스트리밍 실패: ${(e as Error).message}`)\n  }\n\n  onProgress?.({\n    spec,\n    downloaded,\n    total,\n    phase: \"verify\",\n  })\n\n  // SHA 검증\n  let actual: string\n  try {\n    actual = await sha256OfFile(partPath)\n  } catch (e) {\n    try {\n      await unlink(partPath)\n    } catch {\n      // .part 임시파일 정리 best-effort — 본 에러(SHA 계산 실패)를 가리지 않도록 무시\n    }\n    throw new Error(`${spec.name} SHA 계산 실패: ${(e as Error).message}`)\n  }\n\n  if (actual !== spec.sha256) {\n    try {\n      await unlink(partPath)\n    } catch {\n      // 오염된 .part 정리 best-effort — 본 에러(SHA mismatch)를 가리지 않도록 무시\n    }\n    throw new Error(\n      `${spec.name} SHA256 mismatch: expected ${spec.sha256}, got ${actual} — 모델 URL 이 오염되었거나 전송 중 손상되었습니다.`,\n    )\n  }\n\n  await rename(partPath, localPath)\n  onProgress?.({\n    spec,\n    downloaded,\n    total,\n    phase: \"done\",\n  })\n}\n\nasync function sha256OfFile(p: string): Promise<string> {\n  const h = createHash(\"sha256\")\n  const stream = createReadStream(p)\n  await pipeline(stream, async function* (src) {\n    for await (const chunk of src) {\n      h.update(chunk)\n      // yield 안 함 (소비만)\n    }\n  })\n  return h.digest(\"hex\")\n}\n","/**\n * 폐쇄망(내부망) 배포용 아웃바운드 통신 킬스위치 + 파일 접근 루트 제한.\n *\n * kordoc 자체는 문서 파서라 상시 외부 통신이 없지만, 두 경로만 나간다:\n *   1. OCR/수식 모델 최초 1회 다운로드 (huggingface.co)\n *   2. `kordoc watch --webhook` 사용자가 명시한 URL\n *\n * `KORDOC_OFFLINE=1` 이면 위 경로를 **시도 전에** 차단한다. 보안성 검토에서\n * \"외부 통신 없음\"을 런타임으로 증명하기 위한 단일 관문 — 새 아웃바운드 경로를\n * 추가하면 반드시 `assertNetworkAllowed()` 를 먼저 통과시킬 것.\n *\n * `KORDOC_ROOT` 는 파일 접근을 특정 디렉토리 하위로 제한한다(미설정 시 제한 없음 —\n * 기존 동작 보존). 내부망 배포에서는 두 변수를 함께 고정하는 것을 권장.\n */\n\nimport { realpathSync } from \"fs\"\nimport { isAbsolute, relative, resolve, sep } from \"path\"\nimport { KordocError } from \"../utils.js\"\n\nconst TRUTHY = new Set([\"1\", \"true\", \"yes\", \"on\"])\n\nfunction envFlag(name: string): boolean {\n  const v = process.env[name]\n  return !!v && TRUTHY.has(v.trim().toLowerCase())\n}\n\n/** 폐쇄망 모드 여부 (`KORDOC_OFFLINE=1|true|yes|on`) */\nexport function isOfflineMode(): boolean {\n  return envFlag(\"KORDOC_OFFLINE\")\n}\n\n/**\n * 아웃바운드 통신 관문. 폐쇄망 모드면 요청을 보내기 전에 예외로 끊는다.\n * @param what 차단 대상 설명 (사용자에게 노출됨 — 호스트/URL 은 넣지 말 것)\n * @param hint 대안 안내 (오프라인 사이드로드 방법 등)\n */\nexport function assertNetworkAllowed(what: string, hint?: string): void {\n  if (!isOfflineMode()) return\n  throw new KordocError(\n    `폐쇄망 모드(KORDOC_OFFLINE)에서 차단됨: ${what}` + (hint ? ` — ${hint}` : \"\"),\n  )\n}\n\n/** 파일 접근 루트 (`KORDOC_ROOT`). 미설정이면 null = 제한 없음 */\nexport function getAccessRoot(): string | null {\n  const raw = process.env.KORDOC_ROOT\n  if (!raw || !raw.trim()) return null\n  const resolved = resolve(raw.trim())\n  try {\n    return realpathSync(resolved)\n  } catch {\n    // 루트가 실재하지 않으면 모든 접근이 막히는 게 안전한 기본값\n    return resolved\n  }\n}\n\n/** 경로가 루트 하위인지 (루트 자신 포함). 경계 문자열 매칭이 아닌 세그먼트 단위 비교 */\nexport function isWithinRoot(realPath: string, root: string): boolean {\n  if (realPath === root) return true\n  const rel = relative(root, realPath)\n  return rel !== \"\" && !rel.startsWith(\"..\") && !isAbsolute(rel) && !rel.startsWith(`..${sep}`)\n}\n\n/**\n * `KORDOC_ROOT` 가 설정된 경우 경로가 루트 하위인지 검증한다.\n * 인자는 이미 realpath 로 해석된 절대경로여야 한다 (심볼릭 링크 탈출 방지).\n */\nexport function assertWithinRoot(realPath: string): void {\n  const root = getAccessRoot()\n  if (!root) return\n  if (!isWithinRoot(realPath, root)) {\n    throw new KordocError(`허용된 작업 디렉토리(KORDOC_ROOT) 밖의 경로입니다: ${realPath}`)\n  }\n}\n"]}