kordoc 4.17.3 → 4.17.4

package/dist/chunk-EXBZHI25.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-EXBZHI25.cjs","../src/utils.ts"],"names":[],"mappings":"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","file":"/Users/mong-e/workspace/kordoc/dist/chunk-EXBZHI25.cjs","sourcesContent":[null,"/** kordoc 공용 유틸리티 */\n\nimport { format } from \"util\"\n\n/** 빌드 타임에 tsup define으로 주입되는 버전 */\ndeclare const __KORDOC_VERSION__: string\nexport const VERSION: string = typeof __KORDOC_VERSION__ !== \"undefined\" ? __KORDOC_VERSION__ : \"0.0.0-dev\"\n\n/**\n * Node.js Buffer → ArrayBuffer 변환\n * pool Buffer의 공유 ArrayBuffer 문제를 안전하게 처리.\n * offset=0이고 전체 ArrayBuffer를 차지하면 복사 없이 직접 반환.\n */\nexport function toArrayBuffer(buf: Buffer): ArrayBuffer {\n  if (buf.byteOffset === 0 && buf.byteLength === buf.buffer.byteLength) {\n    return buf.buffer as ArrayBuffer\n  }\n  return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n}\n\n/**\n * kordoc 내부 에러 클래스 — 사용자에게 노출해도 안전한 메시지만 포함.\n * MCP 에러 정제에서 instanceof로 판별하여 allowlist 패턴 매칭 없이 안전하게 통과.\n */\nexport class KordocError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = \"KordocError\"\n  }\n}\n\n/**\n * ENOENT 판별 — 입력 경로가 존재하지 않음.\n * 래핑된 KordocError 를 뚫고 올라온 경우도 있으므로 메시지까지 함께 본다.\n */\nfunction isFileNotFound(err: unknown): boolean {\n  if (typeof err !== \"object\" || err === null) return false\n  if ((err as NodeJS.ErrnoException).code === \"ENOENT\") return true\n  const msg = (err as Error).message\n  return typeof msg === \"string\" && /ENOENT|no such file or directory/i.test(msg)\n}\n\n/**\n * 에러 메시지 정제 — KordocError는 그대로, ENOENT 만 구분 문구, 나머지는 일반 메시지로 대체.\n * 파일시스템 경로, 스택 트레이스 등 내부 정보 노출 방지.\n */\nexport function sanitizeError(err: unknown): string {\n  if (err instanceof KordocError) return err.message\n  // 없는 파일은 문서 문제가 아니라 고칠 수 있는 입력 문제다 — 사유를 숨기지 않는다.\n  // 경로는 노출하지 않는다(어느 파일인지는 stderr·실패 JSON 의 basename 이 알린다).\n  // 문구는 MCP describeError 의 ENOENT 힌트와 같은 표현을 쓴다.\n  if (isFileNotFound(err)) return \"파일 또는 디렉토리를 찾을 수 없습니다\"\n  return \"문서 처리 중 오류가 발생했습니다\"\n}\n\n/**\n * ZIP 엔트리 경로의 경로 순회 여부 판별.\n * 백슬래시 정규화, .., 절대경로, Windows 드라이브 문자 모두 차단.\n */\nexport function isPathTraversal(name: string): boolean {\n  if (name.includes(\"\\x00\")) return true\n  const normalized = name.replace(/\\\\/g, \"/\")\n  const segments = normalized.split(\"/\")\n  return segments.some(s => s === \"..\") || normalized.startsWith(\"/\") || /^[A-Za-z]:/.test(normalized)\n}\n\n// ─── HWPX 섹션 href 해석 (parser/roundtrip 공용) ────────────────────\n\n/**\n * manifest href를 본문 섹션 경로(`Contents/sectionN.xml`)로 정규화.\n * 비본문 XML(header/script/settings)·path traversal·드라이브 경로는 null로 거른다.\n * 백슬래시 구분자를 슬래시로 통일해 parser와 roundtrip이 동일한 목록을 만든다.\n */\nexport function normalizeSectionHref(href: string): string | null {\n  if (!href) return null\n  let normalized = href.replace(/\\\\/g, \"/\").replace(/^\\/+/, \"\")\n  if (isPathTraversal(normalized)) return null\n  if (/^[Ss]ection\\d+\\.xml$/.test(normalized)) normalized = \"Contents/\" + normalized\n  return /(?:^|\\/)[Ss]ection\\d+\\.xml$/.test(normalized) ? normalized : null\n}\n\n/** sectionN.xml을 N 숫자 순서로 정렬 (section10 > section2). */\nexport function compareSectionPaths(a: string, b: string): number {\n  const ai = Number(a.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  const bi = Number(b.match(/[Ss]ection(\\d+)\\.xml$/)?.[1] ?? Number.MAX_SAFE_INTEGER)\n  return ai === bi ? a.localeCompare(b) : ai - bi\n}\n\n// ─── ZIP 안전 로딩 (ZIP bomb 방지) ────────────────────\n\n/** ZIP 비압축 상한 env 의 최대값 (MB) — 오타로 사실상 무제한이 되지 않게 */\nconst MAX_UNZIP_ENV_MB = 8192\n\n/**\n * ZIP 비압축 크기 상한 — `KORDOC_MAX_UNZIP_MB` 가 양수면 그 값(MB, 최대 8192), 아니면 포맷 기본값.\n * 빈 행이 수백만 개인 XLSX 처럼 내용은 작고 XML 만 큰 실문서를 폐쇄망 대량 적재에서 받으려는 설정 (#91)\n */\nexport function unzipLimitBytes(defaultBytes: number): number {\n  const mb = Number(process.env.KORDOC_MAX_UNZIP_MB)\n  return Number.isFinite(mb) && mb > 0 ? Math.min(mb, MAX_UNZIP_ENV_MB) * 1024 * 1024 : defaultBytes\n}\n\n/**\n * ZIP bomb 사전 검사 — Central Directory에서 비압축 합계와 엔트리 수 확인.\n * HWPX/XLSX/DOCX 등 모든 ZIP 기반 포맷에서 공통 사용.\n */\nexport function precheckZipSize(\n  buffer: ArrayBuffer,\n  maxUncompressedSize = 256 * 1024 * 1024, // parser-shared MAX_DECOMPRESS_SIZE 와 동기\n  maxEntries = 500,\n  /** 그림·개체 파트(엔트리 이름 re) — skip 이면 합계에서 뺀다(파서가 풀지 않는다), 아니면 한도 초과 메시지에 크기를 적는다 (#108) */\n  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"]}

package/dist/{chunk-OOUW3ROZ.js → chunk-FSCVZR4A.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   extractPageBlocksWithLines
-} from "./chunk-K7W5L4GI.js";
+} from "./chunk-PVJFCDND.js";
 import {
   OCR_DET_MODEL,
   OCR_REC_DICT,
@@ -9,10 +9,10 @@ import {
   ensureOcrModels,
   getOcrModelsDir,
   parseCharacterDict
-} from "./chunk-WFXZRYFS.js";
+} from "./chunk-AAQR4RIX.js";
 import {
   OPTIONAL_DEP_INSTALL_HINT
-} from "./chunk-5BDNDGUI.js";
+} from "./chunk-DD6AY6EI.js";
 
 // src/ocr/ruling-lines.ts
 var INK_LUMA_MAX = 205;
@@ -2061,4 +2061,4 @@ export {
   runPdfOcr,
   ocrItemsToBlocks
 };
-//# sourceMappingURL=chunk-OOUW3ROZ.js.map
+//# sourceMappingURL=chunk-FSCVZR4A.js.map

package/dist/{chunk-2VMTMIGD.cjs → chunk-GNORDND5.cjs}

@@ -6,10 +6,10 @@
 
 
 
-var _chunkK2GXTJPKcjs = require('./chunk-K2GXTJPK.cjs');
+var _chunkWNF3TSV3cjs = require('./chunk-WNF3TSV3.cjs');
 
 
-var _chunkZWPINXUXcjs = require('./chunk-ZWPINXUX.cjs');
+var _chunkEXBZHI25cjs = require('./chunk-EXBZHI25.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 = _chunkK2GXTJPKcjs.getOcrModelsDir.call(void 0, );
+    const dir = _chunkWNF3TSV3cjs.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, _chunkK2GXTJPKcjs.OCR_DET_MODEL.filename), sessionOpts),
-      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkK2GXTJPKcjs.OCR_REC_MODEL.filename), sessionOpts),
-      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkK2GXTJPKcjs.OCR_REC_DICT.filename), "utf-8")
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkWNF3TSV3cjs.OCR_DET_MODEL.filename), sessionOpts),
+      ortMod.InferenceSession.create(_path.join.call(void 0, dir, _chunkWNF3TSV3cjs.OCR_REC_MODEL.filename), sessionOpts),
+      _promises.readFile.call(void 0, _path.join.call(void 0, dir, _chunkWNF3TSV3cjs.OCR_REC_DICT.filename), "utf-8")
     ]);
-    const dict = _chunkK2GXTJPKcjs.parseCharacterDict.call(void 0, dictYml);
+    const dict = _chunkWNF3TSV3cjs.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.${_chunkZWPINXUXcjs.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.${_chunkEXBZHI25cjs.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 _chunkK2GXTJPKcjs.ensureOcrModels.call(void 0, (p) => {
+    await _chunkWNF3TSV3cjs.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 _chunkK2GXTJPKcjs.extractPageBlocksWithLines.call(void 0, norm, pageNumber, opList, pdfW, pdfH, extraLines, detectTables);
+  return _chunkWNF3TSV3cjs.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.${_chunkZWPINXUXcjs.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.${_chunkEXBZHI25cjs.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-2VMTMIGD.cjs.map
+//# sourceMappingURL=chunk-GNORDND5.cjs.map