@clazic/kordoc 2.1.6 → 2.2.1

package/dist/index.d.cts

@@ -102,6 +102,14 @@ interface ParseOptions {
     pages?: number[] | string;
     /** 이미지 기반 PDF용 OCR 프로바이더 (선택) */
     ocr?: OcrProvider;
+    /**
+     * OCR 모드 (CLI 자동 탐색용).
+     * - "auto": 설치된 CLI 자동 탐색 (gemini→claude→codex→ollama→tesseract)
+     * - "gemini"|"claude"|"codex"|"ollama"|"tesseract": 특정 도구 강제 지정
+     * - "off": OCR 비활성화 (이미지 기반 PDF면 에러)
+     * - undefined: 라이브러리 API 기존 동작 유지 (자동 탐색 안 함)
+     */
+    ocrMode?: OcrMode;
     /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */
     onProgress?: (current: number, total: number) => void;
     /** PDF 머리글/바닥글 자동 제거 */
@@ -116,7 +124,7 @@ interface ParseWarning {
     /** 구조화된 경고 코드 */
     code: WarningCode;
 }
-type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE" | "LENIENT_CFB_RECOVERY";
+type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE" | "LENIENT_CFB_RECOVERY" | "OCR_PAGE_FAILED" | "OCR_CLI_FALLBACK";
 /** 문서 구조 (헤딩 트리) */
 interface OutlineItem {
     level: number;
@@ -204,8 +212,15 @@ interface FormResult {
     /** 양식 확신도 (0-1) */
     confidence: number;
 }
-/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 반환 */
-type OcrProvider = (pageImage: Uint8Array, pageNumber: number, mimeType: "image/png") => Promise<string>;
+/** Vision LLM이 반환하는 구조화된 OCR 결과 */
+interface StructuredOcrResult {
+    /** 구조화된 Markdown (테이블/헤딩/리스트 포함) */
+    markdown: string;
+}
+/** OCR 모드 — CLI --ocr 옵션 허용값 */
+type OcrMode = "auto" | "gemini" | "claude" | "codex" | "ollama" | "tesseract" | "off";
+/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 또는 구조화된 결과 반환 */
+type OcrProvider = (pageImage: Uint8Array, pageNumber: number, mimeType: "image/png") => Promise<string | StructuredOcrResult>;
 interface WatchOptions {
     dir: string;
     outDir?: string;
@@ -252,6 +267,23 @@ interface MarkdownToHwpxOptions {
  */
 declare function markdownToHwpx(markdown: string, options?: MarkdownToHwpxOptions | ArrayBuffer): Promise<ArrayBuffer>;
 
+/**
+ * Markdown → XLSX 변환기
+ *
+ * 지원: 헤딩, 단락, 코드, blockquote, hr, 테이블(별도 시트), 이미지
+ */
+
+interface MarkdownToXlsxOptions {
+    warnings?: string[];
+    images?: ExtractedImage[];
+}
+/**
+ * 마크다운 텍스트를 XLSX (ArrayBuffer)로 변환.
+ * @param markdown 마크다운 텍스트
+ * @param options 경고 수집, 이미지 데이터 등
+ */
+declare function markdownToXlsx(markdown: string, options?: MarkdownToXlsxOptions): Promise<ArrayBuffer>;
+
 /** 매직 바이트 기반 파일 포맷 감지 */
 
 /** ZIP 파일 여부: PK\x03\x04 */
@@ -307,4 +339,4 @@ declare function parseXlsx(buffer: ArrayBuffer, options?: ParseOptions): Promise
 /** DOCX 파일을 Markdown으로 변환 */
 declare function parseDocx(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 
-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, detectZipFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, parse, parseDocx, parseHwp, parseHwpx, parsePdf, parseXlsx };
+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 MarkdownToXlsxOptions, type OcrMode, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type StructuredOcrResult, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, detectZipFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToXlsx, parse, parseDocx, parseHwp, parseHwpx, parsePdf, parseXlsx };

package/dist/index.d.ts

@@ -102,6 +102,14 @@ interface ParseOptions {
     pages?: number[] | string;
     /** 이미지 기반 PDF용 OCR 프로바이더 (선택) */
     ocr?: OcrProvider;
+    /**
+     * OCR 모드 (CLI 자동 탐색용).
+     * - "auto": 설치된 CLI 자동 탐색 (gemini→claude→codex→ollama→tesseract)
+     * - "gemini"|"claude"|"codex"|"ollama"|"tesseract": 특정 도구 강제 지정
+     * - "off": OCR 비활성화 (이미지 기반 PDF면 에러)
+     * - undefined: 라이브러리 API 기존 동작 유지 (자동 탐색 안 함)
+     */
+    ocrMode?: OcrMode;
     /** 진행률 콜백 — current: 현재 페이지/섹션, total: 전체 수 */
     onProgress?: (current: number, total: number) => void;
     /** PDF 머리글/바닥글 자동 제거 */
@@ -116,7 +124,7 @@ interface ParseWarning {
     /** 구조화된 경고 코드 */
     code: WarningCode;
 }
-type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE" | "LENIENT_CFB_RECOVERY";
+type WarningCode = "SKIPPED_IMAGE" | "SKIPPED_OLE" | "TRUNCATED_TABLE" | "OCR_FALLBACK" | "UNSUPPORTED_ELEMENT" | "BROKEN_ZIP_RECOVERY" | "HIDDEN_TEXT_FILTERED" | "MALFORMED_XML" | "PARTIAL_PARSE" | "LENIENT_CFB_RECOVERY" | "OCR_PAGE_FAILED" | "OCR_CLI_FALLBACK";
 /** 문서 구조 (헤딩 트리) */
 interface OutlineItem {
     level: number;
@@ -204,8 +212,15 @@ interface FormResult {
     /** 양식 확신도 (0-1) */
     confidence: number;
 }
-/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 반환 */
-type OcrProvider = (pageImage: Uint8Array, pageNumber: number, mimeType: "image/png") => Promise<string>;
+/** Vision LLM이 반환하는 구조화된 OCR 결과 */
+interface StructuredOcrResult {
+    /** 구조화된 Markdown (테이블/헤딩/리스트 포함) */
+    markdown: string;
+}
+/** OCR 모드 — CLI --ocr 옵션 허용값 */
+type OcrMode = "auto" | "gemini" | "claude" | "codex" | "ollama" | "tesseract" | "off";
+/** 사용자 제공 OCR 함수 — 페이지 이미지를 받아 텍스트 또는 구조화된 결과 반환 */
+type OcrProvider = (pageImage: Uint8Array, pageNumber: number, mimeType: "image/png") => Promise<string | StructuredOcrResult>;
 interface WatchOptions {
     dir: string;
     outDir?: string;
@@ -252,6 +267,23 @@ interface MarkdownToHwpxOptions {
  */
 declare function markdownToHwpx(markdown: string, options?: MarkdownToHwpxOptions | ArrayBuffer): Promise<ArrayBuffer>;
 
+/**
+ * Markdown → XLSX 변환기
+ *
+ * 지원: 헤딩, 단락, 코드, blockquote, hr, 테이블(별도 시트), 이미지
+ */
+
+interface MarkdownToXlsxOptions {
+    warnings?: string[];
+    images?: ExtractedImage[];
+}
+/**
+ * 마크다운 텍스트를 XLSX (ArrayBuffer)로 변환.
+ * @param markdown 마크다운 텍스트
+ * @param options 경고 수집, 이미지 데이터 등
+ */
+declare function markdownToXlsx(markdown: string, options?: MarkdownToXlsxOptions): Promise<ArrayBuffer>;
+
 /** 매직 바이트 기반 파일 포맷 감지 */
 
 /** ZIP 파일 여부: PK\x03\x04 */
@@ -307,4 +339,4 @@ declare function parseXlsx(buffer: ArrayBuffer, options?: ParseOptions): Promise
 /** DOCX 파일을 Markdown으로 변환 */
 declare function parseDocx(buffer: ArrayBuffer, options?: ParseOptions): Promise<ParseResult>;
 
-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, detectZipFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, parse, parseDocx, parseHwp, parseHwpx, parsePdf, parseXlsx };
+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 MarkdownToXlsxOptions, type OcrMode, type OcrProvider, type OutlineItem, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type StructuredOcrResult, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, compare, detectFormat, detectZipFormat, diffBlocks, extractFormFields, isHwpxFile, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToXlsx, parse, parseDocx, parseHwp, parseHwpx, parsePdf, parseXlsx };