@rhwp/core 0.7.2 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhwp/core",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "HWP/HWPX file parser and renderer — Rust + WebAssembly",
   "type": "module",
   "main": "rhwp.js",

package/rhwp.d.ts

@@ -252,8 +252,32 @@ export class HwpDocument {
      * 문서를 HWP 바이너리로 내보낸다.
      *
      * Document IR을 HWP 5.0 CFB 바이너리로 직렬화하여 반환한다.
+     * HWPX 출처 문서는 `export_hwp_with_adapter` 를 통해 HWPX→HWP IR 매핑 어댑터를
+     * 자동 적용하여 한컴 호환성과 자기 재로드 페이지 보존을 보장한다 (#178).
+     * HWP 출처는 어댑터가 no-op 이므로 기존 동작과 동일.
      */
     exportHwp(): Uint8Array;
+    /**
+     * 어댑터 적용 + HWP 직렬화 + 자기 재로드 검증을 수행하고 결과를 JSON 으로 반환한다 (#178).
+     *
+     * 반환 JSON:
+     * ```json
+     * {
+     *   "bytesLen": 678912,
+     *   "pageCountBefore": 9,
+     *   "pageCountAfter": 9,
+     *   "recovered": true
+     * }
+     * ```
+     *
+     * 본 함수는 검증 메타데이터만 반환하며 bytes 자체는 별도 호출 (`exportHwp`) 로 받아야 한다.
+     * 검증과 실제 사용을 분리하여 호출자가 결과에 따라 다른 동작을 취할 수 있도록 한다.
+     */
+    exportHwpVerify(): string;
+    /**
+     * Document IR을 HWPX(ZIP+XML)로 직렬화하여 반환한다.
+     */
+    exportHwpx(): Uint8Array;
     /**
      * 선택 영역을 HTML 문자열로 변환한다 (본문).
      */
@@ -622,6 +646,10 @@ export class HwpDocument {
      * 투명선 표시 여부를 반환한다.
      */
     getShowTransparentBorders(): boolean;
+    /**
+     * 원본 파일 형식을 반환한다 ("hwp" 또는 "hwpx").
+     */
+    getSourceFormat(): string;
     /**
      * 특정 문단의 스타일을 조회한다.
      *
@@ -690,6 +718,36 @@ export class HwpDocument {
      * 문단에서 텍스트 부분 문자열을 반환한다 (Undo용 텍스트 보존).
      */
     getTextRange(section_idx: number, para_idx: number, char_offset: number, count: number): string;
+    /**
+     * HWPX 비표준 감지 경고를 JSON 문자열로 반환한다 (#177).
+     *
+     * ## 반환 형식
+     *
+     * ```json
+     * {
+     *   "count": 3,
+     *   "summary": {
+     *     "lineseg 배열이 비어있음": 1,
+     *     "lineseg 가 미계산 상태 (line_height=0)": 2
+     *   },
+     *   "warnings": [
+     *     {
+     *       "section": 0,
+     *       "paragraph": 5,
+     *       "kind": "LinesegArrayEmpty",
+     *       "cell": null
+     *     },
+     *     {
+     *       "section": 0,
+     *       "paragraph": 10,
+     *       "kind": "LinesegUncomputed",
+     *       "cell": {"ctrl": 0, "row": 0, "col": 1, "innerPara": 0}
+     *     }
+     *   ]
+     * }
+     * ```
+     */
+    getValidationWarnings(): string;
     /**
      * 선택된 개체들을 하나의 GroupShape로 묶는다.
      * json: `{"sectionIdx":N, "targets":[{"paraIdx":N,"controlIdx":N},...]}`
@@ -909,6 +967,15 @@ export class HwpDocument {
      * 반환값: JSON `{"ok":true,"cellParaIdx":<idx>,"charOffset":<offset>}`
      */
     pasteInternalInCell(section_idx: number, parent_para_idx: number, control_idx: number, cell_idx: number, cell_para_idx: number, char_offset: number): string;
+    /**
+     * 사용자 명시 요청에 의한 lineseg 전체 reflow (#177).
+     *
+     * `reflow_zero_height_paragraphs` 의 자동 경로와 달리, "빈 line_segs + text 존재"
+     * 케이스까지 포함해 재계산한다. 반환값은 실제로 reflow 된 문단 개수.
+     *
+     * 호출 이후 렌더 캐시·페이지네이션이 갱신되므로 즉시 렌더링하면 보정된 결과가 보인다.
+     */
+    reflowLinesegs(): number;
     /**
      * 커서 위치의 누름틀 필드를 제거한다 (본문 문단).
      */
@@ -1242,8 +1309,6 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly version: () => [number, number];
-    readonly init_panic_hook: () => void;
     readonly __wbg_hwpdocument_free: (a: number, b: number) => void;
     readonly __wbg_hwpviewer_free: (a: number, b: number) => void;
     readonly extractThumbnail: (a: number, b: number) => any;
@@ -1295,6 +1360,8 @@ export interface InitOutput {
     readonly hwpdocument_evaluateTableFormula: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_exportControlHtml: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_exportHwp: (a: number) => [number, number, number, number];
+    readonly hwpdocument_exportHwpVerify: (a: number) => [number, number, number, number];
+    readonly hwpdocument_exportHwpx: (a: number) => [number, number, number, number];
     readonly hwpdocument_exportSelectionHtml: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
     readonly hwpdocument_exportSelectionInCellHtml: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_findNearestControlBackward: (a: number, b: number, c: number, d: number) => [number, number];
@@ -1370,6 +1437,7 @@ export interface InitOutput {
     readonly hwpdocument_getShapeProperties: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_getShowControlCodes: (a: number) => number;
     readonly hwpdocument_getShowTransparentBorders: (a: number) => number;
+    readonly hwpdocument_getSourceFormat: (a: number) => [number, number];
     readonly hwpdocument_getStyleAt: (a: number, b: number, c: number) => [number, number];
     readonly hwpdocument_getStyleDetail: (a: number, b: number) => [number, number];
     readonly hwpdocument_getStyleList: (a: number) => [number, number];
@@ -1383,6 +1451,7 @@ export interface InitOutput {
     readonly hwpdocument_getTextInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly hwpdocument_getTextInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
     readonly hwpdocument_getTextRange: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+    readonly hwpdocument_getValidationWarnings: (a: number) => [number, number];
     readonly hwpdocument_groupShapes: (a: number, b: number, c: number) => [number, number, number, number];
     readonly hwpdocument_hasInternalClipboard: (a: number) => number;
     readonly hwpdocument_hitTest: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -1424,6 +1493,7 @@ export interface InitOutput {
     readonly hwpdocument_pasteHtmlInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
     readonly hwpdocument_pasteInternal: (a: number, b: number, c: number, d: number) => [number, number, number, number];
     readonly hwpdocument_pasteInternalInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+    readonly hwpdocument_reflowLinesegs: (a: number) => number;
     readonly hwpdocument_removeFieldAt: (a: number, b: number, c: number, d: number) => [number, number];
     readonly hwpdocument_removeFieldAtInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
     readonly hwpdocument_renameBookmark: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
@@ -1487,6 +1557,8 @@ export interface InitOutput {
     readonly hwpviewer_updateViewport: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly hwpviewer_visiblePages: (a: number) => [number, number];
     readonly hwpviewer_pageCount: (a: number) => number;
+    readonly version: () => [number, number];
+    readonly init_panic_hook: () => void;
     readonly __wbindgen_exn_store: (a: number) => void;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;

package/rhwp.js

@@ -1151,6 +1151,9 @@ export class HwpDocument {
      * 문서를 HWP 바이너리로 내보낸다.
      *
      * Document IR을 HWP 5.0 CFB 바이너리로 직렬화하여 반환한다.
+     * HWPX 출처 문서는 `export_hwp_with_adapter` 를 통해 HWPX→HWP IR 매핑 어댑터를
+     * 자동 적용하여 한컴 호환성과 자기 재로드 페이지 보존을 보장한다 (#178).
+     * HWP 출처는 어댑터가 no-op 이므로 기존 동작과 동일.
      * @returns {Uint8Array}
      */
     exportHwp() {
@@ -1162,6 +1165,54 @@ export class HwpDocument {
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         return v1;
     }
+    /**
+     * 어댑터 적용 + HWP 직렬화 + 자기 재로드 검증을 수행하고 결과를 JSON 으로 반환한다 (#178).
+     *
+     * 반환 JSON:
+     * ```json
+     * {
+     *   "bytesLen": 678912,
+     *   "pageCountBefore": 9,
+     *   "pageCountAfter": 9,
+     *   "recovered": true
+     * }
+     * ```
+     *
+     * 본 함수는 검증 메타데이터만 반환하며 bytes 자체는 별도 호출 (`exportHwp`) 로 받아야 한다.
+     * 검증과 실제 사용을 분리하여 호출자가 결과에 따라 다른 동작을 취할 수 있도록 한다.
+     * @returns {string}
+     */
+    exportHwpVerify() {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ret = wasm.hwpdocument_exportHwpVerify(this.__wbg_ptr);
+            var ptr1 = ret[0];
+            var len1 = ret[1];
+            if (ret[3]) {
+                ptr1 = 0; len1 = 0;
+                throw takeFromExternrefTable0(ret[2]);
+            }
+            deferred2_0 = ptr1;
+            deferred2_1 = len1;
+            return getStringFromWasm0(ptr1, len1);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
+    /**
+     * Document IR을 HWPX(ZIP+XML)로 직렬화하여 반환한다.
+     * @returns {Uint8Array}
+     */
+    exportHwpx() {
+        const ret = wasm.hwpdocument_exportHwpx(this.__wbg_ptr);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
     /**
      * 선택 영역을 HTML 문자열로 변환한다 (본문).
      * @param {number} section_idx
@@ -2821,6 +2872,22 @@ export class HwpDocument {
         const ret = wasm.hwpdocument_getShowTransparentBorders(this.__wbg_ptr);
         return ret !== 0;
     }
+    /**
+     * 원본 파일 형식을 반환한다 ("hwp" 또는 "hwpx").
+     * @returns {string}
+     */
+    getSourceFormat() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.hwpdocument_getSourceFormat(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * 특정 문단의 스타일을 조회한다.
      *
@@ -3139,6 +3206,48 @@ export class HwpDocument {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * HWPX 비표준 감지 경고를 JSON 문자열로 반환한다 (#177).
+     *
+     * ## 반환 형식
+     *
+     * ```json
+     * {
+     *   "count": 3,
+     *   "summary": {
+     *     "lineseg 배열이 비어있음": 1,
+     *     "lineseg 가 미계산 상태 (line_height=0)": 2
+     *   },
+     *   "warnings": [
+     *     {
+     *       "section": 0,
+     *       "paragraph": 5,
+     *       "kind": "LinesegArrayEmpty",
+     *       "cell": null
+     *     },
+     *     {
+     *       "section": 0,
+     *       "paragraph": 10,
+     *       "kind": "LinesegUncomputed",
+     *       "cell": {"ctrl": 0, "row": 0, "col": 1, "innerPara": 0}
+     *     }
+     *   ]
+     * }
+     * ```
+     * @returns {string}
+     */
+    getValidationWarnings() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.hwpdocument_getValidationWarnings(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
+        }
+    }
     /**
      * 선택된 개체들을 하나의 GroupShape로 묶는다.
      * json: `{"sectionIdx":N, "targets":[{"paraIdx":N,"controlIdx":N},...]}`
@@ -4252,6 +4361,19 @@ export class HwpDocument {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * 사용자 명시 요청에 의한 lineseg 전체 reflow (#177).
+     *
+     * `reflow_zero_height_paragraphs` 의 자동 경로와 달리, "빈 line_segs + text 존재"
+     * 케이스까지 포함해 재계산한다. 반환값은 실제로 reflow 된 문단 개수.
+     *
+     * 호출 이후 렌더 캐시·페이지네이션이 갱신되므로 즉시 렌더링하면 보정된 결과가 보인다.
+     * @returns {number}
+     */
+    reflowLinesegs() {
+        const ret = wasm.hwpdocument_reflowLinesegs(this.__wbg_ptr);
+        return ret >>> 0;
+    }
     /**
      * 커서 위치의 누름틀 필드를 제거한다 (본문 문단).
      * @param {number} section_idx
@@ -5770,7 +5892,7 @@ function __wbg_get_imports() {
         __wbg_lineTo_c9f1e0dd4824ae31: function(arg0, arg1, arg2) {
             arg0.lineTo(arg1, arg2);
         },
-        __wbg_measureTextWidth_3f7ab3a9f314ad03: function(arg0, arg1, arg2, arg3) {
+        __wbg_measureTextWidth_0962d94b80b2a16a: function(arg0, arg1, arg2, arg3) {
             const ret = globalThis.measureTextWidth(getStringFromWasm0(arg0, arg1), getStringFromWasm0(arg2, arg3));
             return ret;
         },

package/rhwp_bg.wasm.d.ts

@@ -1,8 +1,6 @@
 /* tslint:disable */
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
-export const version: () => [number, number];
-export const init_panic_hook: () => void;
 export const __wbg_hwpdocument_free: (a: number, b: number) => void;
 export const __wbg_hwpviewer_free: (a: number, b: number) => void;
 export const extractThumbnail: (a: number, b: number) => any;
@@ -54,6 +52,8 @@ export const hwpdocument_ensureDefaultNumbering: (a: number) => number;
 export const hwpdocument_evaluateTableFormula: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
 export const hwpdocument_exportControlHtml: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const hwpdocument_exportHwp: (a: number) => [number, number, number, number];
+export const hwpdocument_exportHwpVerify: (a: number) => [number, number, number, number];
+export const hwpdocument_exportHwpx: (a: number) => [number, number, number, number];
 export const hwpdocument_exportSelectionHtml: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
 export const hwpdocument_exportSelectionInCellHtml: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
 export const hwpdocument_findNearestControlBackward: (a: number, b: number, c: number, d: number) => [number, number];
@@ -129,6 +129,7 @@ export const hwpdocument_getSelectionRectsInCell: (a: number, b: number, c: numb
 export const hwpdocument_getShapeProperties: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const hwpdocument_getShowControlCodes: (a: number) => number;
 export const hwpdocument_getShowTransparentBorders: (a: number) => number;
+export const hwpdocument_getSourceFormat: (a: number) => [number, number];
 export const hwpdocument_getStyleAt: (a: number, b: number, c: number) => [number, number];
 export const hwpdocument_getStyleDetail: (a: number, b: number) => [number, number];
 export const hwpdocument_getStyleList: (a: number) => [number, number];
@@ -142,6 +143,7 @@ export const hwpdocument_getTextBoxControlIndex: (a: number, b: number, c: numbe
 export const hwpdocument_getTextInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
 export const hwpdocument_getTextInCellByPath: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
 export const hwpdocument_getTextRange: (a: number, b: number, c: number, d: number, e: number) => [number, number, number, number];
+export const hwpdocument_getValidationWarnings: (a: number) => [number, number];
 export const hwpdocument_groupShapes: (a: number, b: number, c: number) => [number, number, number, number];
 export const hwpdocument_hasInternalClipboard: (a: number) => number;
 export const hwpdocument_hitTest: (a: number, b: number, c: number, d: number) => [number, number, number, number];
@@ -183,6 +185,7 @@ export const hwpdocument_pasteHtml: (a: number, b: number, c: number, d: number,
 export const hwpdocument_pasteHtmlInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => [number, number, number, number];
 export const hwpdocument_pasteInternal: (a: number, b: number, c: number, d: number) => [number, number, number, number];
 export const hwpdocument_pasteInternalInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => [number, number, number, number];
+export const hwpdocument_reflowLinesegs: (a: number) => number;
 export const hwpdocument_removeFieldAt: (a: number, b: number, c: number, d: number) => [number, number];
 export const hwpdocument_removeFieldAtInCell: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number];
 export const hwpdocument_renameBookmark: (a: number, b: number, c: number, d: number, e: number, f: number) => [number, number, number, number];
@@ -246,6 +249,8 @@ export const hwpviewer_setZoom: (a: number, b: number) => void;
 export const hwpviewer_updateViewport: (a: number, b: number, c: number, d: number, e: number) => void;
 export const hwpviewer_visiblePages: (a: number) => [number, number];
 export const hwpviewer_pageCount: (a: number) => number;
+export const version: () => [number, number];
+export const init_panic_hook: () => void;
 export const __wbindgen_exn_store: (a: number) => void;
 export const __externref_table_alloc: () => number;
 export const __wbindgen_externrefs: WebAssembly.Table;