kordoc 4.7.1 → 4.7.3

package/dist/{watch-5ST75Q7Q.js → watch-AZIY6AWC.js}

@@ -2,19 +2,22 @@
 import {
   detectFormat,
   parse
-} from "./chunk-5KPNXBNR.js";
+} from "./chunk-W5NZYPRQ.js";
 import "./chunk-7FCNOKOR.js";
-import "./chunk-4VNUQYUE.js";
+import "./chunk-4KGGVCYX.js";
 import "./chunk-MOL7MDBG.js";
-import "./chunk-VECVLIWE.js";
+import "./chunk-NYLYIN55.js";
 import "./chunk-DZIXKL7E.js";
-import "./chunk-AFX6ZXER.js";
-import "./chunk-YWDN5PQC.js";
-import "./chunk-JEX5P66D.js";
-import "./chunk-7ZIOZ6PU.js";
+import "./chunk-CGJDCZA3.js";
+import "./chunk-KEGAEHWO.js";
+import "./chunk-XOO6YEZE.js";
+import "./chunk-VZ3AQVBN.js";
+import {
+  assertNetworkAllowed
+} from "./chunk-RQVFFSAO.js";
 import {
   toArrayBuffer
-} from "./chunk-J3W6Q3AX.js";
+} from "./chunk-IMFIACHP.js";
 
 // src/watch.ts
 import { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync, realpathSync } from "fs";
@@ -181,6 +184,7 @@ function isPrivateIp(ip) {
 async function sendWebhook(url, payload) {
   if (!url) return;
   try {
+    assertNetworkAllowed("webhook \uC804\uC1A1", "\uD3D0\uC1C4\uB9DD\uC5D0\uC11C \uC54C\uB9BC\uC774 \uD544\uC694\uD558\uBA74 --output \uACB0\uACFC \uD30C\uC77C\uC744 \uAC10\uC2DC\uD558\uB294 \uB0B4\uBD80 \uC791\uC5C5\uC73C\uB85C \uB300\uCCB4\uD558\uC138\uC694");
     validateWebhookUrl(url);
     const hostname = new URL(url).hostname.replace(/^\[|\]$/g, "");
     const addrs = await lookup(hostname, { all: true, verbatim: true });
@@ -204,4 +208,4 @@ export {
   isPrivateIp,
   watchDirectory
 };
-//# sourceMappingURL=watch-5ST75Q7Q.js.map
+//# sourceMappingURL=watch-AZIY6AWC.js.map

package/dist/watch-AZIY6AWC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/watch.ts"],"sourcesContent":["/** 디렉토리 감시 모드 — 새 문서 자동 변환 + Webhook 알림 */\n\nimport { watch, readFileSync, writeFileSync, mkdirSync, statSync, existsSync, realpathSync } from \"fs\"\nimport { lookup } from \"dns/promises\"\nimport { basename, resolve, extname, sep } from \"path\"\nimport { parse, detectFormat } from \"./index.js\"\nimport { toArrayBuffer } from \"./utils.js\"\nimport { assertNetworkAllowed } from \"./shared/offline.js\"\nimport type { WatchOptions, ParseOptions } from \"./types.js\"\n\nexport const SUPPORTED_EXTENSIONS = new Set([\".hwp\", \".hwpx\", \".hml\", \".pdf\", \".xls\", \".xlsx\", \".docx\"])\nconst DEBOUNCE_MS = 1000\n/** 파일 쓰기 완료 판정: 연속 2회 동일 크기 확인 간격 */\nconst STABLE_CHECK_MS = 300\nconst MAX_FILE_SIZE = 500 * 1024 * 1024\n\n/**\n * Linux fs.watch recursive는 Node 19.1+ 전용 — 미지원 조합이면 크립틱\n * ERR_FEATURE_UNAVAILABLE 대신 명확한 안내로 즉시 실패시킨다.\n */\nexport function assertRecursiveWatchSupport(\n  platform: NodeJS.Platform = process.platform,\n  nodeVersion: string = process.versions.node,\n): void {\n  if (platform !== \"linux\") return\n  const [major = 0, minor = 0] = nodeVersion.split(\".\").map(Number)\n  if (major >= 20 || (major === 19 && minor >= 1)) return\n  throw new Error(\n    `Linux에서 디렉토리 감시(fs.watch recursive)는 Node 19.1 이상이 필요합니다 (현재 ${nodeVersion}) — Node 20+ 업그레이드를 권장합니다`,\n  )\n}\n\n/**\n * 동시 처리 상한 게이트 — 상한 초과분은 버리지 않고 대기 큐에 넣어 처리 완료 시\n * 순서대로 drain (기존: 상한 초과 return으로 새 파일이 무음 유실되던 것 방지).\n */\nexport function createTaskQueue(maxConcurrent: number, run: (key: string) => Promise<void>): (key: string) => void {\n  let active = 0\n  const inProgress = new Set<string>()\n  const waiting: string[] = []\n  const enqueue = (key: string): void => {\n    if (inProgress.has(key)) return // 동일 파일 동시 처리 방지\n    if (active >= maxConcurrent) {\n      if (!waiting.includes(key)) waiting.push(key)\n      return\n    }\n    inProgress.add(key)\n    active++\n    void run(key).finally(() => {\n      inProgress.delete(key)\n      active--\n      const next = waiting.shift()\n      if (next) enqueue(next)\n    })\n  }\n  return enqueue\n}\n\n/**\n * 디렉토리를 감시하여 새 문서 파일을 자동 변환.\n *\n * @example\n * ```bash\n * kordoc watch ./incoming -d ./output --webhook https://api.example.com/docs\n * ```\n */\nexport async function watchDirectory(options: WatchOptions): Promise<void> {\n  const { dir, outDir, webhook, format = \"markdown\", pages, silent } = options\n\n  if (!existsSync(dir)) throw new Error(`디렉토리를 찾을 수 없습니다: ${dir}`)\n  if (webhook) validateWebhookUrl(webhook)\n  if (outDir) mkdirSync(outDir, { recursive: true })\n\n  const log = silent ? () => {} : (msg: string) => process.stderr.write(msg + \"\\n\")\n  log(`[kordoc watch] 감시 시작: ${resolve(dir)}`)\n  if (outDir) log(`[kordoc watch] 출력: ${resolve(outDir)}`)\n  if (webhook) log(`[kordoc watch] 웹훅: ${webhook}`)\n\n  // 설정 로그 뒤·감시 시작 전에 검사 — 무엇을 하려다 막혔는지 보이고,\n  // 옵션 파싱 계약 테스트(plugin-5)도 Linux+Node<19.1 에서 로그를 관측할 수 있다\n  assertRecursiveWatchSupport()\n\n  // 디바운스 맵\n  const pending = new Map<string, ReturnType<typeof setTimeout>>()\n  // 동시 처리 제한 — 메모리 폭주 방지 (초과분은 대기 큐로, createTaskQueue)\n  const MAX_CONCURRENT = 3\n\n  /** 파일 크기가 안정화될 때까지 대기 (쓰기 완료 감지) */\n  const waitForStableSize = async (absPath: string): Promise<number> => {\n    let prevSize = statSync(absPath).size\n    await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n    if (!existsSync(absPath)) return 0\n    const currSize = statSync(absPath).size\n    if (currSize !== prevSize) {\n      // 크기가 변했으면 한 번 더 대기\n      await new Promise(r => setTimeout(r, STABLE_CHECK_MS))\n      if (!existsSync(absPath)) return 0\n      return statSync(absPath).size\n    }\n    return currSize\n  }\n\n  const processFile = async (filePath: string) => {\n    const ext = extname(filePath).toLowerCase()\n    if (!SUPPORTED_EXTENSIONS.has(ext)) return\n\n    const fileName = basename(filePath)\n    try {\n      const rawPath = resolve(dir, filePath)\n      if (!existsSync(rawPath)) return\n      // 심볼릭 링크 해석 후 감시 디렉토리 외부 파일 차단\n      let absPath: string\n      try { absPath = realpathSync(rawPath) } catch { return }\n      const realDir = realpathSync(resolve(dir))\n      if (!absPath.startsWith(realDir + sep) && absPath !== realDir) return\n\n      const fileSize = await waitForStableSize(absPath)\n      if (fileSize > MAX_FILE_SIZE || fileSize === 0) return\n\n      log(`[kordoc watch] 변환 중: ${fileName}`)\n\n      const buffer = readFileSync(absPath)\n      const arrayBuffer = toArrayBuffer(buffer)\n      // filePath 전달 — 배포용 HWP의 COM fallback에 필요 (CLI와 동일)\n      const parseOptions: ParseOptions = { filePath: absPath }\n      if (pages) parseOptions.pages = pages\n      const result = await parse(arrayBuffer, parseOptions)\n\n      if (!result.success) {\n        log(`[kordoc watch] 실패: ${fileName} — ${result.error}`)\n        await sendWebhook(webhook, { file: fileName, format: detectFormat(arrayBuffer), success: false, error: result.error })\n        return\n      }\n\n      const output = format === \"json\" ? JSON.stringify(result, null, 2) : result.markdown\n\n      if (outDir) {\n        const outExt = format === \"json\" ? \".json\" : \".md\"\n        const outPath = resolve(outDir, fileName.replace(/\\.[^.]+$/, outExt))\n        writeFileSync(outPath, output, \"utf-8\")\n        log(`[kordoc watch] 완료: ${fileName} → ${basename(outPath)}`)\n      } else {\n        process.stdout.write(output + \"\\n\")\n      }\n\n      await sendWebhook(webhook, {\n        file: fileName,\n        format: result.fileType,\n        success: true,\n        markdown: format === \"markdown\" ? output.substring(0, 1000) : undefined,\n      })\n    } catch (err) {\n      log(`[kordoc watch] 에러: ${fileName} — ${err instanceof Error ? err.message : err}`)\n    }\n  }\n\n  const enqueue = createTaskQueue(MAX_CONCURRENT, (filePath) =>\n    processFile(filePath).catch((err) => {\n      process.stderr.write(`[kordoc watch] 처리 실패: ${filePath} — ${err instanceof Error ? err.message : String(err)}\\n`)\n    }),\n  )\n\n  // fs.watch recursive (Node 18+ Windows/macOS, Node 19.1+ Linux — 위에서 사전 검증)\n  const watcher = watch(dir, { recursive: true }, (event, filename) => {\n    if (!filename) return\n    const filePath = filename.toString()\n\n    // 디바운스\n    const existing = pending.get(filePath)\n    if (existing) clearTimeout(existing)\n    pending.set(filePath, setTimeout(() => {\n      pending.delete(filePath)\n      enqueue(filePath)\n    }, DEBOUNCE_MS))\n  })\n  // 감시 자체의 런타임 에러(EMFILE 등)로 데몬이 죽지 않게 — 로그만 남기고 유지\n  watcher.on(\"error\", (err) => {\n    process.stderr.write(`[kordoc watch] 감시 오류: ${err instanceof Error ? err.message : String(err)}\\n`)\n  })\n\n  // 프로세스 종료 방지 (Ctrl+C로 종료)\n  return new Promise(() => {})\n}\n\n/** Webhook URL 검증 — SSRF 방지: http/https만 허용, localhost/private IP 차단 */\nfunction validateWebhookUrl(url: string): void {\n  let parsed: URL\n  try {\n    parsed = new URL(url)\n  } catch {\n    throw new Error(`유효하지 않은 webhook URL: ${url}`)\n  }\n  if (parsed.protocol !== \"http:\" && parsed.protocol !== \"https:\") {\n    throw new Error(`허용되지 않는 webhook 프로토콜: ${parsed.protocol}`)\n  }\n  const hostname = parsed.hostname.toLowerCase()\n  if (\n    hostname === \"localhost\" ||\n    hostname === \"[::1]\" ||\n    hostname.startsWith(\"127.\") ||\n    hostname.startsWith(\"10.\") ||\n    hostname.startsWith(\"192.168.\") ||\n    /^172\\.(1[6-9]|2\\d|3[01])\\./.test(hostname) ||\n    hostname === \"0.0.0.0\" ||\n    hostname.startsWith(\"169.254.\") ||\n    hostname.endsWith(\".local\") ||\n    // IPv6 사설 대역\n    hostname.startsWith(\"[fc\") ||\n    hostname.startsWith(\"[fd\") ||\n    hostname.startsWith(\"[fe80:\") ||\n    hostname === \"[::0]\" ||\n    hostname === \"[::]\" ||\n    // 클라우드 메타데이터 엔드포인트\n    hostname === \"metadata.google.internal\" ||\n    hostname === \"metadata.google\" ||\n    // 16진수/8진수/10진수 정수 IP 인코딩 우회 방지\n    /^0x[0-9a-f]+$/i.test(hostname) ||\n    /^0[0-7]+$/.test(hostname) ||\n    /^\\d+$/.test(hostname)\n  ) {\n    throw new Error(`내부 네트워크 대상 webhook은 허용되지 않습니다: ${hostname}`)\n  }\n}\n\n/** IP 리터럴의 사설/내부 대역 여부 — DNS 해석 결과 재검증용 (IPv4-mapped IPv6 포함) */\nexport function isPrivateIp(ip: string): boolean {\n  let addr = ip.toLowerCase()\n  // IPv4-mapped IPv6 (::ffff:10.0.0.1) → 내장 IPv4로 재검사\n  const mapped = /^::ffff:(\\d+\\.\\d+\\.\\d+\\.\\d+)$/.exec(addr)\n  if (mapped) addr = mapped[1]\n  if (/^\\d+\\.\\d+\\.\\d+\\.\\d+$/.test(addr)) {\n    const [a, b] = addr.split(\".\").map(Number)\n    return (\n      a === 0 || a === 10 || a === 127 ||\n      (a === 100 && b >= 64 && b <= 127) || // CGNAT 100.64/10\n      (a === 169 && b === 254) ||\n      (a === 172 && b >= 16 && b <= 31) ||\n      (a === 192 && b === 168)\n    )\n  }\n  // IPv6 — loopback/미지정, ULA fc00::/7, link-local fe80::/10\n  return addr === \"::\" || addr === \"::1\" || /^f[cd]/.test(addr) || /^fe[89ab]/.test(addr)\n}\n\nasync function sendWebhook(url: string | undefined, payload: Record<string, unknown>): Promise<void> {\n  if (!url) return\n  try {\n    assertNetworkAllowed(\"webhook 전송\", \"폐쇄망에서 알림이 필요하면 --output 결과 파일을 감시하는 내부 작업으로 대체하세요\")\n    validateWebhookUrl(url)\n    // DNS 해석 후 사설 IP 재검증 — 문자열 검사만으로는 내부망 도메인을 못 거른다\n    const hostname = new URL(url).hostname.replace(/^\\[|\\]$/g, \"\")\n    const addrs = await lookup(hostname, { all: true, verbatim: true })\n    const bad = addrs.find((a) => isPrivateIp(a.address))\n    if (bad) throw new Error(`webhook 대상이 내부 네트워크로 해석됩니다: ${hostname} → ${bad.address}`)\n    await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ ...payload, timestamp: new Date().toISOString() }),\n      redirect: \"error\",\n    })\n  } catch (err) {\n    process.stderr.write(`[kordoc watch] webhook 전송 실패: ${err instanceof Error ? err.message : String(err)}\\n`)\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kordoc",
-  "version": "4.7.1",
+  "version": "4.7.3",
   "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": {
@@ -85,7 +85,11 @@
     "@hyzyla/pdfium": "^2.1.0",
     "onnxruntime-node": "^1.24.0",
     "pdfjs-dist": "^4.10.38",
-    "sharp": "^0.34.0"
+    "sharp": "^0.35.0"
+  },
+  "overrides": {
+    "adm-zip": "^0.6.0",
+    "sharp": "^0.35.0"
   },
   "devDependencies": {
     "@huggingface/transformers": "^4.1.0",
@@ -95,7 +99,7 @@
     "onnxruntime-node": "^1.24.0",
     "pdfjs-dist": "^4.10.38",
     "puppeteer-core": "^24.42.0",
-    "sharp": "^0.34.0",
+    "sharp": "^0.35.0",
     "tsup": "^8.4.0",
     "tsx": "^4.21.0",
     "typescript": "^5.9.0"

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/pdf/formula/models.ts"],"sourcesContent":["/**\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\"\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  // 먼저 .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"],"mappings":"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","names":[]}

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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/** 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\nexport interface IRBlock {\n  type: IRBlockType\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\nexport interface IRTable {\n  rows: number\n  cols: number\n  cells: IRCell[][]\n  /** 첫 행을 헤더로 렌더링할지 여부 (현재: rows > 1이면 true — 의미적 감지가 아닌 레이아웃 힌트) */\n  hasHeader: boolean\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  /** 페이지/섹션 수 */\n  pageCount?: number\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   *  - `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  /** 표 오른쪽 끝의 빈 열(서식 문서의 입력란) 보존 (#47).\n   *  기본 false: 마크다운 가독성을 위해 후행 빈 열을 트림.\n   *  양식 인식 경로(parse_form·fill)는 내부적으로 항상 켠다. */\n  keepTrailingEmptyCols?: boolean\n  /** 빈 문단(텍스트 없는 hp:p) 보존 (#57). 기본 false: 종전대로 빈 문단 제거.\n   *  켜면 본문은 `text: \"\"` paragraph 블록으로, 표 셀은 빈 줄로 순서대로 보존해\n   *  \"원문 문단 수 = 줄 수\" 대응을 유지한다 (행 줄맞춤 서식 문서용).\n   *  개체(표·이미지·글상자)만 있는 문단은 개체 출력이 따로 있어 대상이 아니다.\n   *  현재 HWPX 경로 적용. */\n  keepEmptyParagraphs?: 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   * 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\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\n// ─── 파싱 결과 (discriminated union) ────────────────\n\nexport type FileType = \"hwpx\" | \"hwp\" | \"hwp3\" | \"hwpml\" | \"pdf\" | \"xlsx\" | \"xls\" | \"docx\" | \"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  /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */\n  pageQuality?: PageQuality[]\n  /** 문서 단위 품질 요약 — PDF에서만 제공 */\n  qualitySummary?: DocumentQualitySummary\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?: \"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}\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}\n"],"mappings":";;;AAmfO,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;","names":[]}