kordoc 4.14.0 → 4.14.2

package/dist/index.d.cts

@@ -267,7 +267,8 @@ interface OutlineItem {
 type ErrorCode = "EMPTY_INPUT" | "UNSUPPORTED_FORMAT" | "ENCRYPTED" | "DRM_PROTECTED" | "CORRUPTED" | "DECOMPRESSION_BOMB" | "ZIP_BOMB" | "IMAGE_BASED_PDF" | "NO_SECTIONS" | "PARSE_ERROR" | "MISSING_DEPENDENCY"
 /** 결과 직렬화가 런타임 문자열 한계를 넘음 — 이미지 다량 문서의 JSON 출력 (#65) */
  | "OUTPUT_TOO_LARGE";
-type FileType = "hwpx" | "hwp" | "hwp3" | "hwpml" | "pdf" | "xlsx" | "xls" | "docx" | "image" | "unknown";
+/** 감지된 파일 형식. pptx는 감지만 지원하며 파싱 시 UNSUPPORTED_FORMAT을 반환한다. */
+type FileType = "hwpx" | "hwp" | "hwp3" | "hwpml" | "pdf" | "xlsx" | "xls" | "docx" | "pptx" | "image" | "unknown";
 interface ParseResultBase {
     fileType: FileType;
     /** 페이지/섹션 수 — PDF: 실제 페이지 수, HWP/HWPX: 섹션 수, XLSX: 시트 수 */
@@ -1316,7 +1317,7 @@ declare const SPACE_EM_FONT = 300;
  * 넓어 함초롬 테이블로 재면 줄당 1~2자 과대적재로 wrap 지점이 어긋난다
  * (bench/verify-linebreak.mjs seoul 코퍼스 실측: fixedPitch 테이블로 74/75 일치).
  */
-type FaceClass = "hcr" | "fixedPitch" | "gothic";
+type FaceClass = "hcr" | "fixedPitch" | "gothic" | `font:${string}`;
 interface MeasureOptions {
     /** 공백 폭(em×1000). 기본 SPACE_EM_FIXED(500) = useFontSpace 0 */
     spaceEm?: number;
@@ -1331,6 +1332,10 @@ interface MeasureOptions {
  */
 declare function measureTextWidth(text: string, height: number, ratioPct: number, opts?: MeasureOptions): number;
 type WrapMode = "keep" | "charAll";
+interface WrapOptions extends MeasureOptions {
+    /** UTF-16 단위별 실폭(HWPUNIT) — 주면 height·장평·폭 클래스 대신 쓴다(여러 run 문단, 탭 전진폭) */
+    widths?: number[];
+}
 interface WrapResult {
     /** 줄 수 */
     lines: number;
@@ -1343,7 +1348,7 @@ interface WrapResult {
  * 문단 줄바꿈 시뮬레이션.
  * mode 'keep' = 어절 단위(공문서 모드 — 저장 속성 breakNonLatinWord="BREAK_WORD", 이름 역전 주의),
  * mode 'charAll' = 글자 단위(breakNonLatinWord="KEEP_WORD" — 한글 기본값·전자결재 변환기).
- * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해(한컴 동일).
+ * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해 — 한컴처럼 다음 줄로 넘긴 뒤 쪼갠다(앞 줄은 벌어진다).
  *
  * @param text        문단 전체 텍스트(항목 부호 포함)
  * @param firstWidth  첫 줄 가용 폭(HWPUNIT)
@@ -1351,7 +1356,7 @@ interface WrapResult {
  * @param height      charPr height (pt×100)
  * @param ratioPct    장평 %
  */
-declare function simulateWrap(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, mode?: WrapMode, opts?: MeasureOptions): WrapResult;
+declare function simulateWrap(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, mode?: WrapMode, opts?: WrapOptions): WrapResult;
 /** @deprecated simulateWrap(text, …, 'keep') 별칭 — 하위 호환 */
 declare function simulateWrapKeepWord(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, opts?: MeasureOptions): WrapResult;
 /**
@@ -2155,9 +2160,9 @@ declare function detectFormat(buffer: ArrayBuffer): FileType;
 declare function detectOle2Format(buffer: ArrayBuffer): "hwp" | "xls" | "unknown";
 /**
  * ZIP 내부 구조 기반 포맷 세분화.
- * HWPX, XLSX, DOCX 모두 ZIP이므로 내부 파일로 구분.
+ * HWPX, XLSX, DOCX, PPTX 모두 ZIP이므로 내부 파일로 구분 (PPTX는 감지만 지원).
  */
-declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" | "docx" | "unknown">;
+declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" | "docx" | "pptx" | "unknown">;
 
 /**
  * 페이지별 마크다운 사영 (#68)

package/dist/index.d.ts

@@ -267,7 +267,8 @@ interface OutlineItem {
 type ErrorCode = "EMPTY_INPUT" | "UNSUPPORTED_FORMAT" | "ENCRYPTED" | "DRM_PROTECTED" | "CORRUPTED" | "DECOMPRESSION_BOMB" | "ZIP_BOMB" | "IMAGE_BASED_PDF" | "NO_SECTIONS" | "PARSE_ERROR" | "MISSING_DEPENDENCY"
 /** 결과 직렬화가 런타임 문자열 한계를 넘음 — 이미지 다량 문서의 JSON 출력 (#65) */
  | "OUTPUT_TOO_LARGE";
-type FileType = "hwpx" | "hwp" | "hwp3" | "hwpml" | "pdf" | "xlsx" | "xls" | "docx" | "image" | "unknown";
+/** 감지된 파일 형식. pptx는 감지만 지원하며 파싱 시 UNSUPPORTED_FORMAT을 반환한다. */
+type FileType = "hwpx" | "hwp" | "hwp3" | "hwpml" | "pdf" | "xlsx" | "xls" | "docx" | "pptx" | "image" | "unknown";
 interface ParseResultBase {
     fileType: FileType;
     /** 페이지/섹션 수 — PDF: 실제 페이지 수, HWP/HWPX: 섹션 수, XLSX: 시트 수 */
@@ -1316,7 +1317,7 @@ declare const SPACE_EM_FONT = 300;
  * 넓어 함초롬 테이블로 재면 줄당 1~2자 과대적재로 wrap 지점이 어긋난다
  * (bench/verify-linebreak.mjs seoul 코퍼스 실측: fixedPitch 테이블로 74/75 일치).
  */
-type FaceClass = "hcr" | "fixedPitch" | "gothic";
+type FaceClass = "hcr" | "fixedPitch" | "gothic" | `font:${string}`;
 interface MeasureOptions {
     /** 공백 폭(em×1000). 기본 SPACE_EM_FIXED(500) = useFontSpace 0 */
     spaceEm?: number;
@@ -1331,6 +1332,10 @@ interface MeasureOptions {
  */
 declare function measureTextWidth(text: string, height: number, ratioPct: number, opts?: MeasureOptions): number;
 type WrapMode = "keep" | "charAll";
+interface WrapOptions extends MeasureOptions {
+    /** UTF-16 단위별 실폭(HWPUNIT) — 주면 height·장평·폭 클래스 대신 쓴다(여러 run 문단, 탭 전진폭) */
+    widths?: number[];
+}
 interface WrapResult {
     /** 줄 수 */
     lines: number;
@@ -1343,7 +1348,7 @@ interface WrapResult {
  * 문단 줄바꿈 시뮬레이션.
  * mode 'keep' = 어절 단위(공문서 모드 — 저장 속성 breakNonLatinWord="BREAK_WORD", 이름 역전 주의),
  * mode 'charAll' = 글자 단위(breakNonLatinWord="KEEP_WORD" — 한글 기본값·전자결재 변환기).
- * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해(한컴 동일).
+ * 한 어절이 줄보다 길면 keep에서도 글자 단위로 강제 분해 — 한컴처럼 다음 줄로 넘긴 뒤 쪼갠다(앞 줄은 벌어진다).
  *
  * @param text        문단 전체 텍스트(항목 부호 포함)
  * @param firstWidth  첫 줄 가용 폭(HWPUNIT)
@@ -1351,7 +1356,7 @@ interface WrapResult {
  * @param height      charPr height (pt×100)
  * @param ratioPct    장평 %
  */
-declare function simulateWrap(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, mode?: WrapMode, opts?: MeasureOptions): WrapResult;
+declare function simulateWrap(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, mode?: WrapMode, opts?: WrapOptions): WrapResult;
 /** @deprecated simulateWrap(text, …, 'keep') 별칭 — 하위 호환 */
 declare function simulateWrapKeepWord(text: string, firstWidth: number, contWidth: number, height: number, ratioPct: number, opts?: MeasureOptions): WrapResult;
 /**
@@ -2155,9 +2160,9 @@ declare function detectFormat(buffer: ArrayBuffer): FileType;
 declare function detectOle2Format(buffer: ArrayBuffer): "hwp" | "xls" | "unknown";
 /**
  * ZIP 내부 구조 기반 포맷 세분화.
- * HWPX, XLSX, DOCX 모두 ZIP이므로 내부 파일로 구분.
+ * HWPX, XLSX, DOCX, PPTX 모두 ZIP이므로 내부 파일로 구분 (PPTX는 감지만 지원).
  */
-declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" | "docx" | "unknown">;
+declare function detectZipFormat(buffer: ArrayBuffer): Promise<"hwpx" | "xlsx" | "docx" | "pptx" | "unknown">;
 
 /**
  * 페이지별 마크다운 사영 (#68)