kordoc 4.16.3 → 4.17.1

package/README.md

@@ -73,7 +73,7 @@ PDF·OCR 의존성은 기본으로 설치됩니다(줄이려면 `--omit=optional
 | 기능 | 내용 |
 | --- | --- |
 | 📄 **문서 → Markdown** | HWP·HWPX·PDF·DOCX·XLS(X)·이미지를 Markdown + 구조 IR(`IRBlock[]`)로 |
-| 📊 **표 복원** | 병합·중첩 표를 구조 그대로 — 선 없는 PDF 표, 신구조문대비표까지 |
+| 📊 **표 복원** | 원본에서 보이는 모습 그대로: 선이 그어진 표는 병합·중첩까지 표로, 테두리 없는 틀은 글로, 칸으로 조립한 분수는 수식으로. 선 없는 PDF 표, 신구조문대비표까지 |
 | 🔍 **신구대조표** | 두 문서 차이를 블록·셀 단위로 (HWP ↔ HWPX 교차 비교) |
 | 📝 **Markdown → HWPX** | AI 가 쓴 글을 표·수식·차트 포함 HWPX 로 |
 | 🏛️ **공문서 생성** | 개조식 보고서·기안문·보도자료·서울 방침서 프리셋, 표기법 검수 19룰(`kordoc lint`) |
@@ -120,14 +120,15 @@ PDF·OCR 의존성은 기본으로 설치됩니다(줄이려면 `--omit=optional
 
 ### 한국 공문서 — 원본 HWPX 가 정답
 
-HWPX 원본과 그 PDF 가 짝으로 있는 실제 정부 문서(보도자료·결재문서·법령 서식·예산서 등)로 잽니다.
+HWPX 원본과 그 PDF 가 짝으로 있는 실제 정부 문서(보도자료·결재문서·법령 서식·예산서 등)로 잽니다. 표 정답은 원본에서 **보이는 표**입니다(칸 테두리로 그린 모습, v4.17.0 채점 기준).
 
 | 분야 | 규모 | 결과 |
 | --- | --- | --- |
-| HWPX 본문·표 | 2,286문서, 표 13,041개 | 글 누락 0 · 표 전부 칸까지 일치 · 읽기 순서 100% |
+| HWPX 본문·표 | 2,286문서, 보이는 표 9,865개 | 글 누락 0 · 표 칸까지 일치 99.6% · 읽기 순서 100% |
 | HWP 5.x | HWPX 와 짝 1,120쌍 | HWPX 결과와 전부 일치 |
 | PDF 글 | 744쌍 | 글자 재현율 99.8% · 정확도 99.6% · 읽기 순서 99.1% · 어절 F1 98.8% |
-| PDF 표 | 708쌍, 표 2,632개 | 표 찾기 99.5% · 칸까지 완전 일치 97.4% · 칸 F1 0.986 |
+| PDF 표 | 708쌍, 보이는 표 2,331개 | 표 찾기 99.7% · 칸까지 완전 일치 97.3% · 칸 F1 0.989 |
+| 법령 별표 (HWP·한컴 PDF) | 272건, 보이는 표 346개 | HWP 표 전부 칸까지 일치 · PDF 96.8% · 칸으로 조립한 분수 수식 11/11(HWP) |
 | PDF 전체 | 1,911문서 | 글 커버리지 99.8% |
 | 스캔 OCR (로컬 CPU) | 53문서 102쪽 | 글자 재현율 99.0% · 정확도 99.4% · 쪽당 약 1초 |
 | DOCX·XLSX·XLS·HML | 88문서 | 글·숫자 누락 0 |
@@ -135,7 +136,7 @@ HWPX 원본과 그 PDF 가 짝으로 있는 실제 정부 문서(보도자료·
 
 ### HWP·HWPX → Markdown — HwpForge 비교
 
-같은 코퍼스를 원본 HWPX XML 을 정답으로 같은 채점기에 넣었습니다(1열 표 제외).
+같은 코퍼스를 원본 HWPX XML 을 정답으로 같은 채점기에 넣었습니다(1열 표 제외). v4.16 시점, 종전 정답(HWPX 표 구조 그대로) 기준 측정입니다.
 
 | | kordoc | HwpForge 0.16.6 |
 | --- | ---: | ---: |
@@ -187,6 +188,7 @@ if (result.success) {
 | `password` | `--password` | 열기 암호 문서(HWPX·HWP3·HWP5, 한컴 DRM 은 해당 없음) |
 | `tables` | `--no-tables` | `false` 면 PDF 표 감지 끔(테두리 상자가 표로 잡혀 순서가 뒤집히는 2단 시험지 등) |
 | `removeHeaderFooter` | `--no-header-footer` | PDF 머리글/바닥글 제거(기본 켬, 3쪽 이상) |
+| `layoutTables` | `--keep-layout-tables` | 테두리 안 보이는 틀 표 처리. 기본 `"visual"`: 보이는 대로(틀은 글, 선이 보이는 부분만 표, 칸으로 조립한 분수는 수식). `"keep"`: 원본 표 구조 그대로(`patch` 로 되돌릴 편집본은 이것으로) |
 | `keepTrailingEmptyCols` | `--keep-empty-cols` | 표 오른쪽 끝 빈 열(서식 입력란) 보존 |
 | `keepEmptyParagraphs` | `--keep-empty-paragraphs` | 빈 문단 보존 — 원문 문단 수 = 줄 수(HWPX) |
 | `includeFieldPlaceholders` | `--include-field-placeholders` | 미기입 누름틀 안내문도 출력(HWPX·HWP5) |
@@ -578,12 +580,14 @@ import type {
 
 ## 📝 최근 변경
 
-### v4.16.3
-- 보안: MCP 문서 생성이 이미지 폴더 안 심링크로 `KORDOC_ROOT` 밖 파일을 싣던 것 차단 (#101) · MCP 도 한글 이름 그림 지원
+### v4.17.1
+- DOCX 과학 문서: 인라인 수식 제자리 (#104) · Symbol 기호 °·×·μ (#105) · `\langle` 띄어쓰기·수식 번호 `\tag` (#106) · `w:dir`·`w:bdo` 안 글 (#107) · `images: false` 면 그림 파트를 100MB 상한에 안 셈 (#108)
 
-### v4.16.2
-- 위·아래첨자를 `<sup>`·`<sub>` 로 — "10⁴ m²" 가 "104 m2" 로 펴지지 않게 (`scriptTags`, HWPX·HWP·DOCX 기본 켬, 논문·수식 PDF 는 `true`)
-- PDF 2단 논문 저자 줄의 소속 표시(∗†)가 이름 위로 떨어지던 것 수정
+### v4.17.0
+- 원본에서 **보이는 모습대로**: 테두리 없는 틀 표는 글로, 선이 보이는 부분만 표로, 칸으로 조립한 분수는 `$\frac{…}{…}$` (`layoutTables`, 기본 visual · `--keep-layout-tables` 로 종전 구조). 법령 별표 보이는 표 346개 일치: HWP 72 → 346, PDF 66 → 335
+- PDF 쪽 넘김 표: 쪼개진 행·안 이어지던 조각·그림 섞인 표·초대형 표(151×76) 복원
+- 점선(채움) 탭 뒤 글이 잘리던 것 수정 (HWPX·HWP5·HWP3, HWPML 탭)
+- `kordoc patch` 편집본은 `--keep-layout-tables` 로 뽑는다(기본 출력 편집본은 방법을 알려 거절)
 
 전체 이력은 [CHANGELOG.md](CHANGELOG.md).
 

package/dist/{-5XQIJN3D.js → -UNMTWAEI.js}

@@ -50,17 +50,17 @@ import {
   unknownFontWarnings,
   usesGaejosikMunche,
   validateHwpx
-} from "./chunk-D2UGAEXY.js";
+} from "./chunk-HAPCN7BD.js";
 import {
   blocksToPages
-} from "./chunk-XPYK7Z73.js";
+} from "./chunk-OVSCNCT6.js";
 import {
   applySplices,
   buildParagraphSplices,
   buildRangeSplices,
   placeSealHwpx,
   scanSectionXml
-} from "./chunk-UCGGVNTD.js";
+} from "./chunk-EULS3PDF.js";
 import {
   DEFAULT_REDACT_RULES,
   redactMarkdown,
@@ -68,7 +68,7 @@ import {
 } from "./chunk-3WSNLH4B.js";
 import {
   blocksToChunks
-} from "./chunk-7USPM2VT.js";
+} from "./chunk-66YTQ3NQ.js";
 import {
   SPACE_EM_FIXED,
   SPACE_EM_FONT,
@@ -93,20 +93,20 @@ import {
   renderSceneToHtml,
   simulateWrap,
   simulateWrapKeepWord
-} from "./chunk-3ZVZPYSA.js";
+} from "./chunk-ELNYQRBN.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-J3IF6KGW.js";
+import "./chunk-WL3BWROT.js";
 import "./chunk-VQFA55IC.js";
-import "./chunk-GH2JGKWP.js";
+import "./chunk-B4PUQ4FP.js";
 import {
   blocksToMarkdown,
   flattenLayoutTables,
   hasStructuredCellContent
-} from "./chunk-JIFG35UT.js";
-import "./chunk-IE6QX3T3.js";
+} from "./chunk-BHUYJBSQ.js";
+import "./chunk-AUFO5LVN.js";
 import {
   VERSION
-} from "./chunk-ENF34XNH.js";
+} from "./chunk-QXNQ2HNB.js";
 export {
   BUILTIN_TEMPLATES,
   DEFAULT_REDACT_RULES,
@@ -196,4 +196,4 @@ export {
   usesGaejosikMunche,
   validateHwpx
 };
-//# sourceMappingURL=-5XQIJN3D.js.map
+//# sourceMappingURL=-UNMTWAEI.js.map

package/dist/{chunk-4O5XQSCT.js → chunk-3J3BJIOZ.js}

@@ -1,7 +1,7 @@
 import {
   escapeHtml,
   sanitizeHref
-} from "./chunk-7NYRZI2Z.js";
+} from "./chunk-4CSY3QUO.js";
 
 // src/shared/symbol-fonts.ts
 var WINGDINGS = [
@@ -1133,4 +1133,4 @@ export {
   inlineImagesIntoMarkdown,
   blocksToPages
 };
-//# sourceMappingURL=chunk-4O5XQSCT.js.map
+//# sourceMappingURL=chunk-3J3BJIOZ.js.map

package/dist/{chunk-AWWFGIBA.js → chunk-3M2BMQJY.js}

@@ -1,6 +1,6 @@
 import {
   KordocError
-} from "./chunk-7NYRZI2Z.js";
+} from "./chunk-4CSY3QUO.js";
 
 // src/pdf/formula/models.ts
 import { createHash } from "crypto";
@@ -266,4 +266,4 @@ export {
   ensureFormulaModels,
   ensureSingleModel
 };
-//# sourceMappingURL=chunk-AWWFGIBA.js.map
+//# sourceMappingURL=chunk-3M2BMQJY.js.map

package/dist/{chunk-7NYRZI2Z.js → chunk-4CSY3QUO.js}

@@ -1,5 +1,5 @@
 // src/utils.ts
-var VERSION = true ? "4.16.3" : "0.0.0-dev";
+var VERSION = true ? "4.17.1" : "0.0.0-dev";
 function toArrayBuffer(buf) {
   if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {
     return buf.buffer;
@@ -46,7 +46,7 @@ function unzipLimitBytes(defaultBytes) {
   const mb = Number(process.env.KORDOC_MAX_UNZIP_MB);
   return Number.isFinite(mb) && mb > 0 ? Math.min(mb, MAX_UNZIP_ENV_MB) * 1024 * 1024 : defaultBytes;
 }
-function precheckZipSize(buffer, maxUncompressedSize = 256 * 1024 * 1024, maxEntries = 500) {
+function precheckZipSize(buffer, maxUncompressedSize = 256 * 1024 * 1024, maxEntries = 500, media) {
   try {
     const data = new DataView(buffer);
     const len = buffer.byteLength;
@@ -66,17 +66,23 @@ function precheckZipSize(buffer, maxUncompressedSize = 256 * 1024 * 1024, maxEnt
     const cdOffset = data.getUint32(eocdOffset + 16, true);
     if (cdOffset + cdSize > len) return { totalUncompressed: 0, entryCount };
     let totalUncompressed = 0;
+    let mediaUncompressed = 0;
     let pos = cdOffset;
     for (let i = 0; i < entryCount && pos + 46 <= cdOffset + cdSize; i++) {
       if (data.getUint32(pos, true) !== 33639248) break;
-      totalUncompressed += data.getUint32(pos + 24, true);
+      const size = data.getUint32(pos + 24, true);
       const nameLen = data.getUint16(pos + 28, true);
       const extraLen = data.getUint16(pos + 30, true);
       const commentLen = data.getUint16(pos + 32, true);
+      const isMedia = !!media && pos + 46 + nameLen <= len && media.re.test(new TextDecoder().decode(new Uint8Array(buffer, pos + 46, nameLen)));
+      if (isMedia) mediaUncompressed += size;
+      if (!(isMedia && media?.skip)) totalUncompressed += size;
       pos += 46 + nameLen + extraLen + commentLen;
     }
     if (totalUncompressed > maxUncompressedSize) {
-      throw new KordocError(`ZIP \uBE44\uC555\uCD95 \uD06C\uAE30 \uCD08\uACFC: ${(totalUncompressed / 1024 / 1024).toFixed(1)}MB (\uCD5C\uB300 ${maxUncompressedSize / 1024 / 1024}MB)`);
+      const mb = (n) => (n / 1024 / 1024).toFixed(1);
+      const mediaNote = media && !media.skip && mediaUncompressed > 0 ? ` \u2014 \uADF8\uB9BC\xB7\uAC1C\uCCB4 \uD30C\uD2B8\uAC00 ${mb(mediaUncompressed)}MB, \uC774\uBBF8\uC9C0 \uCD94\uCD9C\uC744 \uB044\uBA74(images: false\xB7--no-images) \uC138\uC9C0 \uC54A\uB294\uB2E4` : "";
+      throw new KordocError(`ZIP \uBE44\uC555\uCD95 \uD06C\uAE30 \uCD08\uACFC: ${mb(totalUncompressed)}MB (\uCD5C\uB300 ${maxUncompressedSize / 1024 / 1024}MB)${mediaNote}`);
     }
     return { totalUncompressed, entryCount };
   } catch (err) {
@@ -148,4 +154,4 @@ export {
   OPTIONAL_DEP_INSTALL_HINT,
   classifyError
 };
-//# sourceMappingURL=chunk-7NYRZI2Z.js.map
+//# sourceMappingURL=chunk-4CSY3QUO.js.map

package/dist/chunk-4CSY3QUO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils.ts"],"sourcesContent":["/** 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  media?: { re: RegExp; skip: boolean },\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      if (isMedia) mediaUncompressed += size\n      if (!(isMedia && media?.skip)) 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"],"mappings":"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","names":[]}

package/dist/{chunk-YJECRT5Q.cjs → chunk-4NH45EEB.cjs}

@@ -6,10 +6,10 @@
 
 
 
-var _chunkYOCFY44Zcjs = require('./chunk-YOCFY44Z.cjs');
+var _chunkZRXQDJPMcjs = require('./chunk-ZRXQDJPM.cjs');
 
 
-var _chunkPMULUMUFcjs = require('./chunk-PMULUMUF.cjs');
+var _chunkGRHSVGSBcjs = require('./chunk-GRHSVGSB.cjs');
 
 // src/ocr/ruling-lines.ts
 var INK_LUMA_MAX = 205;
@@ -1410,7 +1410,7 @@ var OcrEngine = class _OcrEngine {
     ]);
     const sharpAny = sharpModRaw;
     const sharpMod = typeof sharpAny === "function" ? sharpAny : _nullishCoalesce(sharpAny.default, () => ( sharpAny));
-    const dir = _chunkYOCFY44Zcjs.getOcrModelsDir.call(void 0, );
+    const dir = _chunkZRXQDJPMcjs.getOcrModelsDir.call(void 0, );
     const sessionOpts = {
       graphOptimizationLevel: "all",
       executionProviders: ["cpu"],
@@ -1418,11 +1418,11 @@ var OcrEngine = class _OcrEngine {
       // paddle2onnx 변환 잔여물 W 로그 폭주 억제
     };
     const [det, rec, dictYml] = await Promise.all([
-      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkYOCFY44Zcjs.OCR_DET_MODEL.filename), sessionOpts),
-      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkYOCFY44Zcjs.OCR_REC_MODEL.filename), sessionOpts),
-      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkYOCFY44Zcjs.OCR_REC_DICT.filename), "utf-8")
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkZRXQDJPMcjs.OCR_DET_MODEL.filename), sessionOpts),
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkZRXQDJPMcjs.OCR_REC_MODEL.filename), sessionOpts),
+      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkZRXQDJPMcjs.OCR_REC_DICT.filename), "utf-8")
     ]);
-    const dict = _chunkYOCFY44Zcjs.parseCharacterDict.call(void 0, dictYml);
+    const dict = _chunkZRXQDJPMcjs.parseCharacterDict.call(void 0, dictYml);
     if (dict.length === 0) throw new Error("OCR \uC0AC\uC804 \uD30C\uC2F1 \uC2E4\uD328 \u2014 \uBAA8\uB378 \uCE90\uC2DC\uB97C \uC0AD\uC81C \uD6C4 \uC7AC\uB2E4\uC6B4\uB85C\uB4DC\uD558\uC138\uC694");
     return new _OcrEngine({ det, rec, dict, ort: ortMod, sharp: sharpMod });
   }
@@ -1750,7 +1750,7 @@ async function tryImport(name, loader) {
     return await loader();
   } catch (e) {
     throw new Error(
-      `\uB0B4\uC7A5 OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkPMULUMUFcjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
+      `\uB0B4\uC7A5 OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkGRHSVGSBcjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
     );
   }
 }
@@ -1864,7 +1864,7 @@ async function runPdfOcr(buffer, targets, mode, warnings, onProgress, detectTabl
     () => Promise.resolve().then(() => _interopRequireWildcard(require("@hyzyla/pdfium")))
   );
   if (mode === "builtin") {
-    await _chunkYOCFY44Zcjs.ensureOcrModels.call(void 0, (p) => {
+    await _chunkZRXQDJPMcjs.ensureOcrModels.call(void 0, (p) => {
       if (p.phase === "download" && p.downloaded === 0) {
         process.stderr.write(`[kordoc-ocr] ${p.spec.name} \uB2E4\uC6B4\uB85C\uB4DC \uC911 (~${p.spec.sizeMb}MB)...
 `);
@@ -2012,14 +2012,14 @@ function ocrItemsToBlocks(items, pageNumber, pdfW, pdfH, scale, extraLines, dete
       isHidden: false
     };
   });
-  return _chunkYOCFY44Zcjs.extractPageBlocksWithLines.call(void 0, norm, pageNumber, opList, pdfW, pdfH, extraLines, detectTables);
+  return _chunkZRXQDJPMcjs.extractPageBlocksWithLines.call(void 0, norm, pageNumber, opList, pdfW, pdfH, extraLines, detectTables);
 }
 async function tryImport2(name, loader) {
   try {
     return await loader();
   } catch (e) {
     throw new Error(
-      `OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkPMULUMUFcjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
+      `OCR \uC744 \uC0AC\uC6A9\uD558\uB824\uBA74 optional dependency '${name}' \uC774 \uD544\uC694\uD569\uB2C8\uB2E4. \`npm install ${name}\` \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.${_chunkGRHSVGSBcjs.OPTIONAL_DEP_INSTALL_HINT} \uC6D0\uC778: ${e.message}`
     );
   }
 }
@@ -2058,4 +2058,4 @@ function bgraToRgba(bgra) {
 
 
 exports.getOcrEngine = getOcrEngine; exports.detectRulingLines = detectRulingLines; exports.rulingToPdfLines = rulingToPdfLines; exports.deskewPage = deskewPage; exports.MAX_OCR_PIXELS = MAX_OCR_PIXELS; exports.runPdfOcr = runPdfOcr; exports.ocrItemsToBlocks = ocrItemsToBlocks;
-//# sourceMappingURL=chunk-YJECRT5Q.cjs.map
+//# sourceMappingURL=chunk-4NH45EEB.cjs.map