@rhwp/editor 0.7.8 → 0.7.10

package/README.md

@@ -117,6 +117,40 @@ a.click();
 URL.revokeObjectURL(url);
 ```
 
+### editor.exportHwpx()
+
+현재 편집 중인 문서를 HWPX(ZIP+XML) 바이너리로 내보냅니다.
+
+```javascript
+const bytes = await editor.exportHwpx();
+const blob = new Blob([bytes], { type: 'application/vnd.hancom.hwpx' });
+
+const url = URL.createObjectURL(blob);
+const a = document.createElement('a');
+a.href = url;
+a.download = 'document.hwpx';
+a.click();
+URL.revokeObjectURL(url);
+```
+
+### editor.exportHwpVerify()
+
+HWP 직렬화 + 자기 재로드 검증 메타데이터를 반환합니다 (#178).
+검증 메타데이터만 반환하며, 실제 HWP bytes 가 필요하면 `exportHwp()` 를 별도 호출하세요.
+
+```javascript
+const verify = await editor.exportHwpVerify();
+// {
+//   bytesLen: 678912,
+//   pageCountBefore: 9,
+//   pageCountAfter: 9,
+//   recovered: true
+// }
+if (!verify.recovered || verify.pageCountBefore !== verify.pageCountAfter) {
+  console.warn('HWP 직렬화 검증 실패', verify);
+}
+```
+
 ### editor.destroy()
 
 에디터를 제거합니다.

package/index.d.ts

@@ -15,6 +15,17 @@ export interface LoadResult {
   pageCount: number;
 }
 
+export interface HwpVerifyResult {
+  /** 직렬화된 HWP 바이트 수 */
+  bytesLen: number;
+  /** 직렬화 직전 페이지 수 */
+  pageCountBefore: number;
+  /** 자기 재로드 후 페이지 수 (recovered === true 일 때 의미 있음) */
+  pageCountAfter: number;
+  /** 자기 재로드 성공 여부 */
+  recovered: boolean;
+}
+
 export declare class RhwpEditor {
   /** HWP 파일을 로드합니다 */
   loadFile(data: ArrayBuffer | Uint8Array, fileName?: string): Promise<LoadResult>;
@@ -24,6 +35,10 @@ export declare class RhwpEditor {
   getPageSvg(page?: number): Promise<string>;
   /** 현재 문서를 HWP 바이너리로 내보냅니다 */
   exportHwp(): Promise<Uint8Array>;
+  /** 현재 문서를 HWPX(ZIP+XML) 바이너리로 내보냅니다 */
+  exportHwpx(): Promise<Uint8Array>;
+  /** HWP 직렬화 + 자기 재로드 검증 메타데이터 (#178) */
+  exportHwpVerify(): Promise<HwpVerifyResult>;
   /** iframe 엘리먼트를 반환합니다 */
   readonly element: HTMLIFrameElement;
   /** 에디터를 제거합니다 */

package/index.js

@@ -166,6 +166,26 @@ class RhwpEditor {
     return result instanceof Uint8Array ? result : new Uint8Array(result || []);
   }
 
+  /**
+   * 현재 문서를 HWPX(ZIP+XML) 바이너리로 내보냅니다.
+   * @returns {Promise<Uint8Array>} HWPX 파일 bytes
+   */
+  async exportHwpx() {
+    const result = await this._request('exportHwpx');
+    return result instanceof Uint8Array ? result : new Uint8Array(result || []);
+  }
+
+  /**
+   * HWP 직렬화 + 자기 재로드 검증 메타데이터를 반환합니다 (#178).
+   *
+   * 검증 메타데이터만 반환하며, 실제 HWP bytes 가 필요하면 `exportHwp()` 를 별도 호출하세요.
+   *
+   * @returns {Promise<{bytesLen: number, pageCountBefore: number, pageCountAfter: number, recovered: boolean}>}
+   */
+  async exportHwpVerify() {
+    return this._request('exportHwpVerify');
+  }
+
   /**
    * iframe 엘리먼트를 반환합니다.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhwp/editor",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "description": "HWP 에디터 웹 컴포넌트 — iframe 기반 임베드",
   "type": "module",
   "main": "index.js",