kordoc 4.9.2 → 4.11.0

package/dist/{chunk-LKZQ4564.js → chunk-SD3ITJLU.js}

@@ -1,6 +1,6 @@
 import {
   KordocError
-} from "./chunk-OOT54JF2.js";
+} from "./chunk-Z6NFU6DA.js";
 
 // src/pdf/formula/models.ts
 import { createHash } from "crypto";
@@ -266,4 +266,4 @@ export {
   ensureFormulaModels,
   ensureSingleModel
 };
-//# sourceMappingURL=chunk-LKZQ4564.js.map
+//# sourceMappingURL=chunk-SD3ITJLU.js.map

package/dist/{chunk-L5CDTOC3.cjs → chunk-T7GRHAIW.cjs}

@@ -8,4 +8,4 @@ var HEADING_RATIO_H3 = 1.15;
 
 
 exports.HEADING_RATIO_H1 = HEADING_RATIO_H1; exports.HEADING_RATIO_H2 = HEADING_RATIO_H2; exports.HEADING_RATIO_H3 = HEADING_RATIO_H3;
-//# sourceMappingURL=chunk-L5CDTOC3.cjs.map
+//# sourceMappingURL=chunk-T7GRHAIW.cjs.map

package/dist/chunk-T7GRHAIW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/mong-e/workspace/kordoc/dist/chunk-T7GRHAIW.cjs","../src/types.ts"],"names":[],"mappings":"AAAA;ACghBO,IAAM,iBAAA,EAAmB,GAAA;AACzB,IAAM,iBAAA,EAAmB,GAAA;AACzB,IAAM,iBAAA,EAAmB,IAAA;AD9gBhC;AACA;AACE;AACA;AACA;AACF,sIAAC","file":"/Users/mong-e/workspace/kordoc/dist/chunk-T7GRHAIW.cjs","sourcesContent":[null,"/** 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  /** 페이지/섹션 수 — 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   *  - `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  /** 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\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  /**\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?: \"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}\n"]}

package/dist/{chunk-WLZX2HTC.js → chunk-V2TMM6OD.js}

@@ -3,11 +3,11 @@ import {
   HEADING_RATIO_H1,
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
-} from "./chunk-XINP35F4.js";
+} from "./chunk-N3DLQ2YH.js";
 import {
   safeMax,
   safeMin
-} from "./chunk-5ZPXRDS2.js";
+} from "./chunk-CF2FQBVN.js";
 
 // src/pdf/image-regions.ts
 import { OPS } from "pdfjs-dist/legacy/build/pdf.mjs";
@@ -3687,4 +3687,4 @@ export {
   extractPageBlocksWithLines,
   mergeCrossPageTables
 };
-//# sourceMappingURL=chunk-WLZX2HTC.js.map
+//# sourceMappingURL=chunk-V2TMM6OD.js.map

package/dist/{chunk-6WYMV73J.js → chunk-W4DVZN5M.js}

@@ -6,7 +6,7 @@ import {
   HEADING_RATIO_H1,
   HEADING_RATIO_H2,
   HEADING_RATIO_H3
-} from "./chunk-XINP35F4.js";
+} from "./chunk-N3DLQ2YH.js";
 import {
   parsePageRange
 } from "./chunk-MOL7MDBG.js";
@@ -22,7 +22,7 @@ import {
   paraTextPureT,
   patchZipEntries,
   scanSectionXml
-} from "./chunk-JHPEDWJX.js";
+} from "./chunk-LXMQUWGU.js";
 import {
   MAX_COLS,
   MAX_ROWS,
@@ -32,14 +32,14 @@ import {
   dedupeRunningHeaders,
   flattenLayoutTables,
   mapPuaText
-} from "./chunk-LUY46O7O.js";
+} from "./chunk-FNNOBF36.js";
 import {
   SPACE_EM_FIXED,
   charWidthEm1000,
   fitRatioForFewerLines,
   measureTextWidth,
   simulateWrap
-} from "./chunk-NOEYLJGJ.js";
+} from "./chunk-476CF3WL.js";
 import {
   MAX_DECOMPRESS_SIZE,
   MAX_XML_DEPTH,
@@ -55,7 +55,7 @@ import {
   findChildByLocalName,
   localName,
   rawTextContent
-} from "./chunk-PKCDYIIJ.js";
+} from "./chunk-Z37BVIRF.js";
 import {
   KordocError,
   classifyError,
@@ -67,7 +67,7 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-5ZPXRDS2.js";
+} from "./chunk-CF2FQBVN.js";
 
 // src/index.ts
 import { readFile } from "fs/promises";
@@ -2859,7 +2859,7 @@ function resolveImageBlocks(binDataMap, blocks, warnings, sweepUnreferenced) {
           const ext = mime.includes("jpeg") ? "jpg" : mime.includes("png") ? "png" : mime.includes("gif") ? "gif" : mime.includes("bmp") ? "bmp" : "bin";
           img = { filename: `image_${String(imageIndex).padStart(3, "0")}.${ext}`, data: new Uint8Array(bin.data), mime };
           resolved.set(storageId, img);
-          images.push({ filename: img.filename, data: img.data, mimeType: img.mime });
+          images.push({ filename: img.filename, data: img.data, mimeType: img.mime, source: bin.name });
           renamed.set(storageId, img.filename);
         }
       }
@@ -2883,7 +2883,7 @@ function resolveImageBlocks(binDataMap, blocks, warnings, sweepUnreferenced) {
       const ext = mime.includes("jpeg") ? "jpg" : mime.includes("png") ? "png" : mime.includes("gif") ? "gif" : mime.includes("bmp") ? "bmp" : "bin";
       const filename = `image_${String(imageIndex).padStart(3, "0")}.${ext}`;
       const data = new Uint8Array(bin.data);
-      images.push({ filename, data, mimeType: mime });
+      images.push({ filename, data, mimeType: mime, source: bin.name });
       blocks.push({ type: "image", text: filename, imageData: { data, mimeType: mime, filename: bin.name } });
     }
   }
@@ -3020,7 +3020,7 @@ async function extractImagesFromZip(zip, blocks, decompressed, warnings, sweepUn
           const mimeType = imageExtToMime(ext);
           imageIndex++;
           const filename2 = `image_${String(imageIndex).padStart(3, "0")}.${mimeToExt(mimeType)}`;
-          img = { filename: filename2, data, mimeType };
+          img = { filename: filename2, data, mimeType, source: path };
           images.push(img);
           usedPaths.add(path);
           break;
@@ -3059,7 +3059,7 @@ async function extractImagesFromZip(zip, blocks, decompressed, warnings, sweepUn
         }
         imageIndex++;
         const filename = `image_${String(imageIndex).padStart(3, "0")}.${mimeToExt(mimeType)}`;
-        const img = { filename, data, mimeType };
+        const img = { filename, data, mimeType, source: file.name };
         images.push(img);
         blocks.push({ type: "image", text: filename, imageData: { data, mimeType, filename: file.name } });
       } catch (err) {
@@ -17342,9 +17342,15 @@ var ARAEA_JAMO = 4510;
 function decodeAraeaSyllable(ch) {
   if (ch < 32768) return null;
   if ((ch >> 5 & 31) !== JUNG_ARAEA) return null;
-  const cho = CHO_MAP[ch >> 10 & 31];
+  const choIdx = ch >> 10 & 31;
+  const cho = CHO_MAP[choIdx];
   const jong = JONG_MAP[ch & 31];
-  if (cho === -1 || jong === -1) return null;
+  if (jong === -1) return null;
+  if (cho === -1) {
+    if (choIdx !== 1) return null;
+    const bare = String.fromCodePoint(ARAEA_JAMO);
+    return jong === 0 ? bare : bare + String.fromCodePoint(4519 + jong);
+  }
   const out = String.fromCodePoint(4352 + cho) + String.fromCodePoint(ARAEA_JAMO);
   return jong === 0 ? out : out + String.fromCodePoint(4519 + jong);
 }
@@ -17372,7 +17378,44 @@ function decodeJohab(ch) {
   }
   return decodeHwp3Extra(ch);
 }
+var eucKrDecoder;
+function kscChar(row, cell2) {
+  if (eucKrDecoder === void 0) {
+    try {
+      eucKrDecoder = new TextDecoder("euc-kr", { fatal: false });
+    } catch {
+      eucKrDecoder = null;
+    }
+  }
+  if (!eucKrDecoder) return null;
+  if (row < 161 || row > 254 || cell2 < 161 || cell2 > 254) return null;
+  const text = eucKrDecoder.decode(Uint8Array.of(row, cell2));
+  if (text.length !== 1) return null;
+  const cp = text.codePointAt(0);
+  if (cp === 65533) return null;
+  return hancomVariant(cp);
+}
+function hancomVariant(cp) {
+  if (cp === 8764) return 65374;
+  if (cp === 8857) return 9673;
+  return cp;
+}
+function decodeHwp3KscSymbol(ch) {
+  if (ch < 13313) return null;
+  const idx = ch - 13313;
+  const row = 161 + Math.floor(idx / 96);
+  if (row > 172) return null;
+  return kscChar(row, 161 + idx % 96);
+}
+function decodeHwp3KscHanja(ch) {
+  if (ch < 16384) return null;
+  const idx = ch - 16384;
+  const row = 202 + Math.floor(idx / 94);
+  if (row > 253) return null;
+  return kscChar(row, 161 + idx % 94);
+}
 function decodeHwp3Extra(ch) {
+  if (ch >= 160 && ch <= 255) return ch;
   if (ch >= 13712 && ch <= 13721) return 8544 + (ch - 13712);
   if (ch >= 14055 && ch <= 14064) return 9312 + (ch - 14055);
   if (ch >= 14272 && ch <= 14277) return "\uD55C\uAE00\uACFC\uCEF4\uD4E8\uD130".codePointAt(ch - 14272);
@@ -17386,6 +17429,28 @@ function decodeHwp3Extra(ch) {
     case 12316:
       return 9473;
     // ━ 굵은 가로선 (rhwp: U+F080F, 표시값 직행)
+    // 텍스트 다이어그램 괘선 조각 — 한컴은 U+F0806~F0810 으로 보존하고 rhwp 검증표가
+    // ┌┬┐└┘│ 로 편다. HWP3 코드는 그 PUA 에서 상수 오프셋(0xC07F3)만큼 떨어져 있고
+    // (0x301C→F080F 가 이미 그 관계), hwp3-sample11 ↔ 변환본 개수도 그대로 맞는다
+    // (0x3013×3↔┌, 0x3014×1↔┬, 0x3015×10↔┐, 0x3019×6↔└, 0x301B×9↔┘, 0x301D×17↔│).
+    case 12307:
+      return 9484;
+    // ┌
+    case 12308:
+      return 9516;
+    // ┬
+    case 12309:
+      return 9488;
+    // ┐
+    case 12313:
+      return 9492;
+    // └
+    case 12315:
+      return 9496;
+    // ┘
+    case 12317:
+      return 9474;
+    // │
     case 12349:
       return 9632;
     // ■ (rhwp: U+F0827, 표시값 직행)
@@ -17413,8 +17478,119 @@ function decodeHwp3Extra(ch) {
     case 12135:
       return 9656;
     // ▸ 표 셀 글머리표 (rhwp 16db8260 — HWP5 변환본·한컴 PDF 대조)
+    // 아래 항등 코드들은 rhwp #5860 실측표(한글 2022 오라클 위치 정렬) 이식.
+    // 같은 0x20xx 대에 항등과 비항등이 섞여 있어 구간 통과는 하지 않는다.
+    case 8208:
+      return 8208;
+    // ‐
+    case 8211:
+      return 8211;
+    // –
+    case 8451:
+      return 8451;
+    // ℃
+    case 8467:
+      return 8467;
+    // ℓ
+    case 8592:
+      return 8592;
+    // ←
+    case 8594:
+      return 8594;
+    // →
+    case 8595:
+      return 8595;
+    // ↓
+    case 8729:
+      return 8729;
+    // ∙ (sample11 실측 11건)
+    case 8901:
+      return 8901;
+    // ⋅
+    case 8251:
+      return 8251;
+    // ※ — 한자를 완성형 좌표로 담으면서 ※ 만 유니코드 값으로 담은 문서가 있다
+    // 비항등 — 유니코드로 읽으면 ⁚·․·⁘ 같은 다른 글자가 된다 (rhwp #5860)
+    case 8228:
+      return 12539;
+    // ・
+    case 8280:
+      return 9651;
+    // △
+    case 8282:
+      return 9675;
+    // ○
+    case 12040:
+      return 9642;
+    // ▪
+    case 12049:
+      return 9702;
+    // ◦ (sample16 실측 332건)
+    case 12052:
+      return 9702;
+    // ◦
+    case 12631:
+      return 8231;
+    // ‧
+    case 1152:
+      return 720;
+    // ː
+    case 7982:
+      return 12398;
+    // の
+    case 12976:
+      return 65392;
+    // ｰ (반각)
+    case 12391:
+      return 8216;
+    // ‘
+    case 12392:
+      return 8217;
+    // ’
+    case 12443:
+      return 65378;
+    // ｢
+    case 12445:
+      return 65379;
+    // ｣
+    case 131:
+      return 8216;
+    // ‘ — 큰따옴표(0x0081/0x0082) 바로 다음 코드 (sample11/14 실측 18건)
+    case 132:
+      return 8217;
+    // ’
+    // 아래 셋은 rhwp 표에 없는 값 — kordoc 이 rhwp 샘플 ↔ 한컴 변환본 문맥 정렬로 실측했다.
+    case 8226:
+      return 8226;
+    // • hwp3-sample 글머리표 4건 (항등)
+    case 12055:
+      return 8226;
+    // • hwp3-sample10 글머리표 3건
+    case 12038:
+      return 9632;
+    // ■ hwp3-sample10 "제목차례" 좌우 장식 2건
+    // 관인·서명란 도장 기호. rhwp 는 U+F012B 로 보존하고 렌더러가 `(인)` 으로 편다 —
+    // kordoc 도 PUA 를 그대로 내보내면 shared/pua.ts 의 검증표가 같은 문자열로 편다.
+    case 11214:
+      return 983339;
+    // ═ 겹줄. rhwp 는 0x3048 을 U+F0832(렌더 표시값 `═`)로 보존한다. 0x37ED 는 기호
+    // 규칙으로는 가타카나 `ネ` 가 되는 사적 graphic 코드로, sample10(42건)·sample11(12건)
+    // 두 문서에서 한컴 변환본의 `═` 개수와 정확히 일치해 표시값 직행으로 싣는다.
+    case 12360:
+      return 9552;
+    case 14317:
+      return 9552;
+    // 사적 원문자·괄호문자 계열. 사적 코드는 일반식이 없어 실측 문서에서 연속으로
+    // 확인된 구간만 싣는다 (sample11 ↔ hwp3-sample11-hwpx 문맥 정렬).
+    //   0x2E01~0x2E07 → ①~⑦ 7코드 연속 일치, 0x2C21~0x2C26 → ⓐ~ⓕ (ⓒ~ⓕ 개수 일치),
+    //   0x2C40~0x2C42 → ㉠~㉢
     default:
-      return JOHAB_UNMAPPED;
+      if (ch >= 11777 && ch <= 11783) return 9312 + (ch - 11777);
+      if (ch === 11776) return 9450;
+      if (ch >= 11786 && ch <= 11794) return 9312 + (ch - 11786);
+      if (ch >= 11297 && ch <= 11302) return 9424 + (ch - 11297);
+      if (ch >= 11328 && ch <= 11330) return 12896 + (ch - 11328);
+      return decodeHwp3KscSymbol(ch) ?? decodeHwp3KscHanja(ch) ?? JOHAB_UNMAPPED;
   }
 }
 function decodeHcharString(bytes) {
@@ -19749,10 +19925,14 @@ async function buildImageMap(zip, rels, doc, warnings) {
         gif: "image/gif",
         bmp: "image/bmp",
         wmf: "image/wmf",
-        emf: "image/emf"
+        emf: "image/emf",
+        tif: "image/tiff",
+        tiff: "image/tiff",
+        svg: "image/svg+xml"
       };
       const filename = `image_${String(imgIdx).padStart(3, "0")}.${ext}`;
-      images.push({ filename, data, mimeType: mimeMap[ext] ?? "image/png" });
+      const mimeType = mimeMap[ext] ?? detectImageMime(data) ?? "application/octet-stream";
+      images.push({ filename, data, mimeType, source: imgPath });
       imageMap.set(embedId, filename);
     } catch (err) {
       warnings.push({
@@ -28012,7 +28192,7 @@ async function patchHwp(original, editedMarkdown, options) {
       for (let i = 0; i < scans.length; i++) {
         if (scans[i].repl.size === 0 && scans[i].inserts.size === 0) continue;
         const newStream = serializeRecords(scans[i].records, scans[i].repl, scans[i].inserts);
-        const content = compressed ? deflateRawSync(newStream) : newStream;
+        const content = compressed ? compressWithTail(newStream) : newStream;
         out = replaceOleStream(out, sectionPaths[i], content);
       }
       data = new Uint8Array(out);
@@ -28495,6 +28675,26 @@ function rebuildCharShape(csData, coreStartUnit) {
   });
   return { buf, count: kept.length };
 }
+var CRC_TABLE = (() => {
+  const t = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    t[n] = c >>> 0;
+  }
+  return t;
+})();
+function crc32(buf) {
+  let c = 4294967295;
+  for (let i = 0; i < buf.length; i++) c = CRC_TABLE[(c ^ buf[i]) & 255] ^ c >>> 8;
+  return (c ^ 4294967295) >>> 0;
+}
+function compressWithTail(raw) {
+  const tail = Buffer.alloc(8);
+  tail.writeUInt32LE(crc32(raw), 0);
+  tail.writeUInt32LE(raw.length >>> 0, 4);
+  return Buffer.concat([deflateRawSync(raw), tail]);
+}
 function synthesizeLineSegs(lineSegData, newRaw, startUnits) {
   if (lineSegData.length < 36) return null;
   const seg0 = lineSegData.subarray(0, 36);
@@ -28572,6 +28772,15 @@ function stageParaPatch(scan, para2, newPlain, skip) {
       scan.repl.set(para2.lineSegIdx, synth.buf);
       newHeader.writeUInt16LE(synth.count, 16);
     }
+  } else {
+    const lineSegData = records[para2.lineSegIdx].data;
+    const segCount = Math.floor(lineSegData.length / 36);
+    let keep = 1;
+    while (keep < segCount && lineSegData.readUInt32LE(keep * 36) < nChars) keep++;
+    if (keep < segCount) {
+      scan.repl.set(para2.lineSegIdx, Buffer.from(lineSegData.subarray(0, keep * 36)));
+      newHeader.writeUInt16LE(keep, 16);
+    }
   }
   scan.repl.set(para2.headerIdx, newHeader);
   return 1;
@@ -29216,7 +29425,7 @@ async function dispatch(format, buffer, opts) {
 }
 async function parseImage(buffer, options) {
   try {
-    const { parseImageDocument } = await import("./image-ocr-6SY623KL.js");
+    const { parseImageDocument } = await import("./image-ocr-2B7NVDRS.js");
     const { blocks, warnings } = await parseImageDocument(buffer, options);
     return {
       success: true,
@@ -29275,7 +29484,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-GDYZDBZI.js");
+    const mod = await import("./parser-TXBQATM7.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -29373,6 +29582,7 @@ export {
   detectFormat,
   detectOle2Format,
   detectZipFormat,
+  detectImageMime,
   extractHwpxMetadataOnly,
   extractHwp5MetadataOnly,
   formatFillValue,
@@ -29425,4 +29635,4 @@ export {
   parseHwpml,
   fillForm
 };
-//# sourceMappingURL=chunk-6WYMV73J.js.map
+//# sourceMappingURL=chunk-W4DVZN5M.js.map