kordoc 1.6.0 → 1.7.0

package/dist/index.d.cts

@@ -3,6 +3,10 @@ interface CellContext {
     text: string;
     colSpan: number;
     rowSpan: number;
+    /** HWP5 셀 열 주소 (0-based) — 병합 테이블 배치용 */
+    colAddr?: number;
+    /** HWP5 셀 행 주소 (0-based) — 병합 테이블 배치용 */
+    rowAddr?: number;
 }
 /** 블록 타입 — v2.0에서 heading, list, image, separator 추가 */
 type IRBlockType = "paragraph" | "table" | "heading" | "list" | "image" | "separator";
@@ -26,6 +30,17 @@ interface IRBlock {
     href?: string;
     /** 각주/미주 텍스트 (인라인 삽입용) */
     footnoteText?: string;
+    /** 이미지 데이터 (type="image"일 때) */
+    imageData?: ImageData;
+}
+/** 추출된 이미지 바이너리 데이터 */
+interface ImageData {
+    /** 이미지 바이너리 */
+    data: Uint8Array;
+    /** MIME 타입 (image/png, image/jpeg, image/gif, image/bmp, image/wmf, image/emf) */
+    mimeType: string;
+    /** 원본 파일명 (있는 경우) */
+    filename?: string;
 }
 /** 바운딩 박스 — PDF 포인트 단위 (72pt = 1인치) */
 interface BoundingBox {
@@ -86,6 +101,10 @@ interface ParseOptions {
     pages?: number[] | string;
     /** 이미지 기반 PDF용 OCR 프로바이더 (선택) */
     ocr?: OcrProvider;
+    /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */
+    onProgress?: (current: number, total: number) => void;
+    /** PDF 머리글/바닥글 자동 제거 */
+    removeHeaderFooter?: boolean;
 }
 /** 파싱 중 스킵/실패한 요소 보고 */
 interface ParseWarning {
@@ -96,7 +115,7 @@ interface ParseWarning {
     /** 구조화된 경고 코드 */
     code: WarningCode;
 }
-type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED";
+type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE";
 /** 문서 구조 (헤딩 트리) */
 interface OutlineItem {
     level: number;
@@ -125,6 +144,17 @@ interface ParseSuccess extends ParseResultBase {
     outline?: OutlineItem[];
     /** 파싱 중 발생한 경고 — v2.0 */
     warnings?: ParseWarning[];
+    /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
+    images?: ExtractedImage[];
+}
+/** 추출된 이미지 — ParseSuccess.images에 포함 */
+interface ExtractedImage {
+    /** 마크다운에서 참조되는 파일명 (예: image_001.png) */
+    filename: string;
+    /** 이미지 바이너리 */
+    data: Uint8Array;
+    /** MIME 타입 */
+    mimeType: string;
 }
 interface ParseFailure extends ParseResultBase {
     success: false;
@@ -250,15 +280,13 @@ declare const VERSION: string;
  * @example
  * ```ts
  * import { parse } from "kordoc"
+ * // 파일 경로로 파싱
+ * const result = await parse("document.hwp")
+ * // 또는 Buffer로 파싱
  * const result = await parse(buffer)
- * if (result.success) {
- *   console.log(result.markdown)     // 마크다운 텍스트
- *   console.log(result.blocks)       // IRBlock[] 구조화 데이터
- *   console.log(result.metadata)     // 문서 메타데이터
- * }
  * ```
  */
-declare function parse(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
+declare function parse(input: string | ArrayBuffer | Buffer, options?: ParseOptions): Promise<ParseResult>;
 /** HWPX 파일을 Markdown으로 변환 */
 declare function parseHwpx(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 /** HWP 5.x 바이너리 파일을 Markdown으로 변환 */
@@ -266,4 +294,4 @@ declare function parseHwp(buffer: ArrayBuffer, options?: ParseOptions): Promise<
 /** PDF 파일에서 텍스트를 추출하여 Markdown으로 변환 */
 declare function parsePdf(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 
-export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type FileType, type FormField, type FormResult, type IRBlock, type IRBlockType, type IRCell, type IRTable, type InlineStyle, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, markdownToHwpx, parse, parseHwp, parseHwpx, parsePdf };
+export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type ExtractedImage, type FileType, type FormField, type FormResult, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, markdownToHwpx, parse, parseHwp, parseHwpx, parsePdf };

package/dist/index.d.ts

@@ -3,6 +3,10 @@ interface CellContext {
     text: string;
     colSpan: number;
     rowSpan: number;
+    /** HWP5 셀 열 주소 (0-based) — 병합 테이블 배치용 */
+    colAddr?: number;
+    /** HWP5 셀 행 주소 (0-based) — 병합 테이블 배치용 */
+    rowAddr?: number;
 }
 /** 블록 타입 — v2.0에서 heading, list, image, separator 추가 */
 type IRBlockType = "paragraph" | "table" | "heading" | "list" | "image" | "separator";
@@ -26,6 +30,17 @@ interface IRBlock {
     href?: string;
     /** 각주/미주 텍스트 (인라인 삽입용) */
     footnoteText?: string;
+    /** 이미지 데이터 (type="image"일 때) */
+    imageData?: ImageData;
+}
+/** 추출된 이미지 바이너리 데이터 */
+interface ImageData {
+    /** 이미지 바이너리 */
+    data: Uint8Array;
+    /** MIME 타입 (image/png, image/jpeg, image/gif, image/bmp, image/wmf, image/emf) */
+    mimeType: string;
+    /** 원본 파일명 (있는 경우) */
+    filename?: string;
 }
 /** 바운딩 박스 — PDF 포인트 단위 (72pt = 1인치) */
 interface BoundingBox {
@@ -86,6 +101,10 @@ interface ParseOptions {
     pages?: number[] | string;
     /** 이미지 기반 PDF용 OCR 프로바이더 (선택) */
     ocr?: OcrProvider;
+    /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */
+    onProgress?: (current: number, total: number) => void;
+    /** PDF 머리글/바닥글 자동 제거 */
+    removeHeaderFooter?: boolean;
 }
 /** 파싱 중 스킵/실패한 요소 보고 */
 interface ParseWarning {
@@ -96,7 +115,7 @@ interface ParseWarning {
     /** 구조화된 경고 코드 */
     code: WarningCode;
 }
-type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED";
+type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE";
 /** 문서 구조 (헤딩 트리) */
 interface OutlineItem {
     level: number;
@@ -125,6 +144,17 @@ interface ParseSuccess extends ParseResultBase {
     outline?: OutlineItem[];
     /** 파싱 중 발생한 경고 — v2.0 */
     warnings?: ParseWarning[];
+    /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
+    images?: ExtractedImage[];
+}
+/** 추출된 이미지 — ParseSuccess.images에 포함 */
+interface ExtractedImage {
+    /** 마크다운에서 참조되는 파일명 (예: image_001.png) */
+    filename: string;
+    /** 이미지 바이너리 */
+    data: Uint8Array;
+    /** MIME 타입 */
+    mimeType: string;
 }
 interface ParseFailure extends ParseResultBase {
     success: false;
@@ -250,15 +280,13 @@ declare const VERSION: string;
  * @example
  * ```ts
  * import { parse } from "kordoc"
+ * // 파일 경로로 파싱
+ * const result = await parse("document.hwp")
+ * // 또는 Buffer로 파싱
  * const result = await parse(buffer)
- * if (result.success) {
- *   console.log(result.markdown)     // 마크다운 텍스트
- *   console.log(result.blocks)       // IRBlock[] 구조화 데이터
- *   console.log(result.metadata)     // 문서 메타데이터
- * }
  * ```
  */
-declare function parse(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
+declare function parse(input: string | ArrayBuffer | Buffer, options?: ParseOptions): Promise<ParseResult>;
 /** HWPX 파일을 Markdown으로 변환 */
 declare function parseHwpx(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 /** HWP 5.x 바이너리 파일을 Markdown으로 변환 */
@@ -266,4 +294,4 @@ declare function parseHwp(buffer: ArrayBuffer, options?: ParseOptions): Promise<
 /** PDF 파일에서 텍스트를 추출하여 Markdown으로 변환 */
 declare function parsePdf(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 
-export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type FileType, type FormField, type FormResult, type IRBlock, type IRBlockType, type IRCell, type IRTable, type InlineStyle, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, markdownToHwpx, parse, parseHwp, parseHwpx, parsePdf };
+export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type ExtractedImage, type FileType, type FormField, type FormResult, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, markdownToHwpx, parse, parseHwp, parseHwpx, parsePdf };