kordoc 2.8.0 → 2.9.1

package/dist/index.d.cts

@@ -164,6 +164,34 @@ interface ParseSuccess extends ParseResultBase {
     warnings?: ParseWarning[];
     /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
     images?: ExtractedImage[];
+    /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */
+    pageQuality?: PageQuality[];
+    /** 문서 단위 품질 요약 — PDF에서만 제공 */
+    qualitySummary?: DocumentQualitySummary;
+}
+/** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */
+interface PageQuality {
+    page: number;
+    textChars: number;
+    hangulRatio: number;
+    controlCharRatio: number;
+    replacementCharRatio: number;
+    puaRatio: number;
+    needsOcr: boolean;
+    ocrReason?: "low_text" | "high_pua" | "high_control" | "high_replacement";
+}
+/** 문서 단위 품질 요약 (PDF 전용). */
+interface DocumentQualitySummary {
+    totalPages: number;
+    totalTextChars: number;
+    avgHangulRatio: number;
+    avgControlCharRatio: number;
+    avgReplacementCharRatio: number;
+    avgPuaRatio: number;
+    lowTextPageCount: number;
+    highPuaPageCount: number;
+    needsOcr: boolean;
+    ocrCandidatePages: number[];
 }
 /** 추출된 이미지 — ParseSuccess.images에 포함 */
 interface ExtractedImage {
@@ -491,4 +519,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, string>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillOutputFormat, type FillResult, type FormField, type FormResult, type HwpxFillResult, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type OcrProvider, type OutlineItem, type PageMargin, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PrintOptions, type PrintPreset, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, blocksToPdf, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, fillForm, fillFormFields, fillHwpx, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, renderHtml };
+export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillOutputFormat, type FillResult, type FormField, type FormResult, type HwpxFillResult, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type OcrProvider, type OutlineItem, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PrintOptions, type PrintPreset, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, blocksToPdf, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, fillForm, fillFormFields, fillHwpx, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, renderHtml };

package/dist/index.d.ts

@@ -164,6 +164,34 @@ interface ParseSuccess extends ParseResultBase {
     warnings?: ParseWarning[];
     /** 추출된 이미지 목록 — 마크다운에서 파일명으로 참조됨 */
     images?: ExtractedImage[];
+    /** 페이지별 텍스트 품질 신호 — PDF에서만 제공 */
+    pageQuality?: PageQuality[];
+    /** 문서 단위 품질 요약 — PDF에서만 제공 */
+    qualitySummary?: DocumentQualitySummary;
+}
+/** 페이지별 텍스트 품질 신호 (PDF 전용). 자세한 설명은 src/pdf/quality.ts */
+interface PageQuality {
+    page: number;
+    textChars: number;
+    hangulRatio: number;
+    controlCharRatio: number;
+    replacementCharRatio: number;
+    puaRatio: number;
+    needsOcr: boolean;
+    ocrReason?: "low_text" | "high_pua" | "high_control" | "high_replacement";
+}
+/** 문서 단위 품질 요약 (PDF 전용). */
+interface DocumentQualitySummary {
+    totalPages: number;
+    totalTextChars: number;
+    avgHangulRatio: number;
+    avgControlCharRatio: number;
+    avgReplacementCharRatio: number;
+    avgPuaRatio: number;
+    lowTextPageCount: number;
+    highPuaPageCount: number;
+    needsOcr: boolean;
+    ocrCandidatePages: number[];
 }
 /** 추출된 이미지 — ParseSuccess.images에 포함 */
 interface ExtractedImage {
@@ -491,4 +519,4 @@ interface FillFormOutput {
  */
 declare function fillForm(input: string | ArrayBuffer | Buffer, values: Record<string, string>, outputFormat?: FillOutputFormat): Promise<FillFormOutput>;
 
-export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillOutputFormat, type FillResult, type FormField, type FormResult, type HwpxFillResult, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type OcrProvider, type OutlineItem, type PageMargin, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PrintOptions, type PrintPreset, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, blocksToPdf, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, fillForm, fillFormFields, fillHwpx, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, renderHtml };
+export { type BlockDiff, type BoundingBox, type CellContext, type CellDiff, type DiffChangeType, type DiffResult, type DocumentMetadata, type DocumentQualitySummary, type ErrorCode, type ExtractedImage, type FileType, type FillFormOutput, type FillOutputFormat, type FillResult, type FormField, type FormResult, type HwpxFillResult, type HwpxTheme, type IRBlock, type IRBlockType, type IRCell, type IRTable, type ImageData, type InlineStyle, type MarkdownToHwpxOptions, type OcrProvider, type OutlineItem, type PageMargin, type PageQuality, type ParseFailure, type ParseOptions, type ParseResult, type ParseSuccess, type ParseWarning, type PrintOptions, type PrintPreset, VERSION, type WarningCode, type WatchOptions, blocksToMarkdown, blocksToPdf, compare, detectFormat, detectOle2Format, detectZipFormat, diffBlocks, extractFormFields, fillForm, fillFormFields, fillHwpx, isHwpxFile, isLabelCell, isOldHwpFile, isPdfFile, isZipFile, markdownToHwpx, markdownToPdf, parse, parseDocx, parseHwp, parseHwp3, parseHwpml, parseHwpx, parsePdf, parseXls, parseXlsx, renderHtml };

package/dist/index.js

@@ -16,7 +16,7 @@ import {
   sanitizeHref,
   stripDtd,
   toArrayBuffer
-} from "./chunk-DLQY6FJH.js";
+} from "./chunk-Z6TLTWYK.js";
 import {
   parsePageRange
 } from "./chunk-SBVRCJFH.js";
@@ -19281,7 +19281,7 @@ async function parseHwp(buffer, options) {
 async function parsePdf(buffer, options) {
   let parsePdfDocument;
   try {
-    const mod = await import("./parser-ZQQM6J7T.js");
+    const mod = await import("./parser-BKYM3LKN.js");
     parsePdfDocument = mod.parsePdfDocument;
   } catch {
     return {
@@ -19292,8 +19292,8 @@ async function parsePdf(buffer, options) {
     };
   }
   try {
-    const { markdown, blocks, metadata, outline, warnings, isImageBased } = await parsePdfDocument(buffer, options);
-    return { success: true, fileType: "pdf", markdown, blocks, metadata, outline, warnings, isImageBased };
+    const { markdown, blocks, metadata, outline, warnings, isImageBased, pageQuality, qualitySummary } = await parsePdfDocument(buffer, options);
+    return { success: true, fileType: "pdf", markdown, blocks, metadata, outline, warnings, isImageBased, pageQuality, qualitySummary };
   } catch (err) {
     const isImageBased = err instanceof Error && "isImageBased" in err ? true : void 0;
     return { success: false, fileType: "pdf", error: err instanceof Error ? err.message : "PDF \uD30C\uC2F1 \uC2E4\uD328", code: classifyError(err), isImageBased };