@iyulab/unhwp 0.9.0 → 0.10.0

package/README.md

@@ -10,10 +10,12 @@ npm install @iyulab/unhwp
 
 ## Usage (ES Module / browser)
 
-```js
-import init, { parse } from '@iyulab/unhwp';
+> 이 패키지는 `wasm-pack --target bundler` 로 빌드된 ES 모듈입니다. WebAssembly 바이너리가
+> 자동으로 초기화되므로 `await init()` 이 필요 없습니다 — 함수를 그대로 import 해 호출하세요.
+> 번들러(webpack, Vite, Rollup, esbuild)를 통해 사용합니다.
 
-await init();
+```js
+import { parse } from '@iyulab/unhwp';
 
 const response = await fetch('document.hwp');
 const data = new Uint8Array(await response.arrayBuffer());
@@ -43,7 +45,7 @@ HWP 또는 HWPX 파일 바이트를 파싱합니다. 파싱 실패 시 오류를
 ### `ParseOptions`
 
 ```js
-import { parse, ParseOptions } from '@iyulab/unhwp';
+import { parseWithOptions, ParseOptions } from '@iyulab/unhwp';
 
 const opts = new ParseOptions().lenient().textOnly();
 const doc = parseWithOptions(data, opts);

package/package.json

@@ -2,7 +2,7 @@
   "name": "@iyulab/unhwp",
   "type": "module",
   "description": "HWP/HWPX extraction to Markdown, text, and JSON (WebAssembly)",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/unhwp_wasm.d.ts

@@ -2,54 +2,57 @@
 /* eslint-disable */
 
 export class HwpDocument {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  static fromBytes(data: Uint8Array): HwpDocument;
-  toMarkdown(): string;
-  sectionCount(): number;
-  paragraphCount(): number;
-  toJson(): string;
-  toText(): string;
-  /**
-   * Returns the document's embedded images as an array of [`HwpImage`],
-   * sorted by resource ID for deterministic ordering.
-   */
-  toImages(): HwpImage[];
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    static fromBytes(data: Uint8Array): HwpDocument;
+    paragraphCount(): number;
+    sectionCount(): number;
+    /**
+     * Returns the document's embedded images as an array of [`HwpImage`],
+     * sorted by resource ID for deterministic ordering.
+     */
+    toImages(): HwpImage[];
+    toJson(): string;
+    toMarkdown(): string;
+    toText(): string;
 }
 
+/**
+ * An embedded image extracted from a document.
+ */
 export class HwpImage {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  /**
-   * Resource identifier (matches markdown image references).
-   */
-  readonly id: string;
-  /**
-   * Raw image bytes (`Uint8Array` in JS).
-   */
-  readonly bytes: Uint8Array;
-  /**
-   * Image bytes encoded as standard base64 (for `data:` URLs).
-   */
-  readonly base64: string;
-  /**
-   * Original filename, if known.
-   */
-  readonly filename: string | undefined;
-  /**
-   * MIME type, if known.
-   */
-  readonly mimeType: string | undefined;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Image bytes encoded as standard base64 (for `data:` URLs).
+     */
+    readonly base64: string;
+    /**
+     * Raw image bytes (`Uint8Array` in JS).
+     */
+    readonly bytes: Uint8Array;
+    /**
+     * Original filename, if known.
+     */
+    readonly filename: string | undefined;
+    /**
+     * Resource identifier (matches markdown image references).
+     */
+    readonly id: string;
+    /**
+     * MIME type, if known.
+     */
+    readonly mimeType: string | undefined;
 }
 
 export class ParseOptions {
-  free(): void;
-  [Symbol.dispose](): void;
-  constructor();
-  lenient(): ParseOptions;
-  textOnly(): ParseOptions;
+    free(): void;
+    [Symbol.dispose](): void;
+    lenient(): ParseOptions;
+    constructor();
+    textOnly(): ParseOptions;
 }
 
 export function parse(data: Uint8Array): HwpDocument;

package/unhwp_wasm.js

@@ -1,5 +1,9 @@
+/* @ts-self-types="./unhwp_wasm.d.ts" */
 import * as wasm from "./unhwp_wasm_bg.wasm";
-export * from "./unhwp_wasm_bg.js";
 import { __wbg_set_wasm } from "./unhwp_wasm_bg.js";
+
 __wbg_set_wasm(wasm);
 wasm.__wbindgen_start();
+export {
+    HwpDocument, HwpImage, ParseOptions, parse, parseWithOptions
+} from "./unhwp_wasm_bg.js";

package/unhwp_wasm_bg.js

@@ -1,95 +1,5 @@
-let wasm;
-export function __wbg_set_wasm(val) {
-    wasm = val;
-}
-
-function _assertClass(instance, klass) {
-    if (!(instance instanceof klass)) {
-        throw new Error(`expected instance of ${klass.name}`);
-    }
-}
-
-function getArrayJsValueFromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    const mem = getDataViewMemory0();
-    const result = [];
-    for (let i = ptr; i < ptr + 4 * len; i += 4) {
-        result.push(wasm.__wbindgen_externrefs.get(mem.getUint32(i, true)));
-    }
-    wasm.__externref_drop_slice(ptr, len);
-    return result;
-}
-
-function getArrayU8FromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
-}
-
-let cachedDataViewMemory0 = null;
-function getDataViewMemory0() {
-    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
-        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
-    }
-    return cachedDataViewMemory0;
-}
-
-function getStringFromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return decodeText(ptr, len);
-}
-
-let cachedUint8ArrayMemory0 = null;
-function getUint8ArrayMemory0() {
-    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
-        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
-    }
-    return cachedUint8ArrayMemory0;
-}
-
-function passArray8ToWasm0(arg, malloc) {
-    const ptr = malloc(arg.length * 1, 1) >>> 0;
-    getUint8ArrayMemory0().set(arg, ptr / 1);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
-function takeFromExternrefTable0(idx) {
-    const value = wasm.__wbindgen_externrefs.get(idx);
-    wasm.__externref_table_dealloc(idx);
-    return value;
-}
-
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
-cachedTextDecoder.decode();
-const MAX_SAFARI_DECODE_BYTES = 2146435072;
-let numBytesDecoded = 0;
-function decodeText(ptr, len) {
-    numBytesDecoded += len;
-    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
-        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
-        cachedTextDecoder.decode();
-        numBytesDecoded = len;
-    }
-    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
-}
-
-let WASM_VECTOR_LEN = 0;
-
-const HwpDocumentFinalization = (typeof FinalizationRegistry === 'undefined')
-    ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_hwpdocument_free(ptr >>> 0, 1));
-
-const HwpImageFinalization = (typeof FinalizationRegistry === 'undefined')
-    ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_hwpimage_free(ptr >>> 0, 1));
-
-const ParseOptionsFinalization = (typeof FinalizationRegistry === 'undefined')
-    ? { register: () => {}, unregister: () => {} }
-    : new FinalizationRegistry(ptr => wasm.__wbg_parseoptions_free(ptr >>> 0, 1));
-
 export class HwpDocument {
     static __wrap(ptr) {
-        ptr = ptr >>> 0;
         const obj = Object.create(HwpDocument.prototype);
         obj.__wbg_ptr = ptr;
         HwpDocumentFinalization.register(obj, obj.__wbg_ptr, obj);
@@ -118,14 +28,39 @@ export class HwpDocument {
         }
         return HwpDocument.__wrap(ret[0]);
     }
+    /**
+     * @returns {number}
+     */
+    paragraphCount() {
+        const ret = wasm.hwpdocument_paragraphCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @returns {number}
+     */
+    sectionCount() {
+        const ret = wasm.hwpdocument_sectionCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * Returns the document's embedded images as an array of [`HwpImage`],
+     * sorted by resource ID for deterministic ordering.
+     * @returns {HwpImage[]}
+     */
+    toImages() {
+        const ret = wasm.hwpdocument_toImages(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
     /**
      * @returns {string}
      */
-    toMarkdown() {
+    toJson() {
         let deferred2_0;
         let deferred2_1;
         try {
-            const ret = wasm.hwpdocument_toMarkdown(this.__wbg_ptr);
+            const ret = wasm.hwpdocument_toJson(this.__wbg_ptr);
             var ptr1 = ret[0];
             var len1 = ret[1];
             if (ret[3]) {
@@ -139,28 +74,14 @@ export class HwpDocument {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
-    /**
-     * @returns {number}
-     */
-    sectionCount() {
-        const ret = wasm.hwpdocument_sectionCount(this.__wbg_ptr);
-        return ret >>> 0;
-    }
-    /**
-     * @returns {number}
-     */
-    paragraphCount() {
-        const ret = wasm.hwpdocument_paragraphCount(this.__wbg_ptr);
-        return ret >>> 0;
-    }
     /**
      * @returns {string}
      */
-    toJson() {
+    toMarkdown() {
         let deferred2_0;
         let deferred2_1;
         try {
-            const ret = wasm.hwpdocument_toJson(this.__wbg_ptr);
+            const ret = wasm.hwpdocument_toMarkdown(this.__wbg_ptr);
             var ptr1 = ret[0];
             var len1 = ret[1];
             if (ret[3]) {
@@ -189,17 +110,6 @@ export class HwpDocument {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
-    /**
-     * Returns the document's embedded images as an array of [`HwpImage`],
-     * sorted by resource ID for deterministic ordering.
-     * @returns {HwpImage[]}
-     */
-    toImages() {
-        const ret = wasm.hwpdocument_toImages(this.__wbg_ptr);
-        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
-        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
-        return v1;
-    }
 }
 if (Symbol.dispose) HwpDocument.prototype[Symbol.dispose] = HwpDocument.prototype.free;
 
@@ -208,7 +118,6 @@ if (Symbol.dispose) HwpDocument.prototype[Symbol.dispose] = HwpDocument.prototyp
  */
 export class HwpImage {
     static __wrap(ptr) {
-        ptr = ptr >>> 0;
         const obj = Object.create(HwpImage.prototype);
         obj.__wbg_ptr = ptr;
         HwpImageFinalization.register(obj, obj.__wbg_ptr, obj);
@@ -225,14 +134,14 @@ export class HwpImage {
         wasm.__wbg_hwpimage_free(ptr, 0);
     }
     /**
-     * Resource identifier (matches markdown image references).
+     * Image bytes encoded as standard base64 (for `data:` URLs).
      * @returns {string}
      */
-    get id() {
+    get base64() {
         let deferred1_0;
         let deferred1_1;
         try {
-            const ret = wasm.hwpimage_id(this.__wbg_ptr);
+            const ret = wasm.hwpimage_base64(this.__wbg_ptr);
             deferred1_0 = ret[0];
             deferred1_1 = ret[1];
             return getStringFromWasm0(ret[0], ret[1]);
@@ -251,14 +160,27 @@ export class HwpImage {
         return v1;
     }
     /**
-     * Image bytes encoded as standard base64 (for `data:` URLs).
+     * Original filename, if known.
+     * @returns {string | undefined}
+     */
+    get filename() {
+        const ret = wasm.hwpimage_filename(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
+    /**
+     * Resource identifier (matches markdown image references).
      * @returns {string}
      */
-    get base64() {
+    get id() {
         let deferred1_0;
         let deferred1_1;
         try {
-            const ret = wasm.hwpimage_base64(this.__wbg_ptr);
+            const ret = wasm.hwpimage_id(this.__wbg_ptr);
             deferred1_0 = ret[0];
             deferred1_1 = ret[1];
             return getStringFromWasm0(ret[0], ret[1]);
@@ -266,19 +188,6 @@ export class HwpImage {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
-    /**
-     * Original filename, if known.
-     * @returns {string | undefined}
-     */
-    get filename() {
-        const ret = wasm.hwpimage_filename(this.__wbg_ptr);
-        let v1;
-        if (ret[0] !== 0) {
-            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
-            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        }
-        return v1;
-    }
     /**
      * MIME type, if known.
      * @returns {string | undefined}
@@ -287,7 +196,7 @@ export class HwpImage {
         const ret = wasm.hwpimage_mimeType(this.__wbg_ptr);
         let v1;
         if (ret[0] !== 0) {
-            v1 = getStringFromWasm0(ret[0], ret[1]).slice();
+            v1 = getStringFromWasm0(ret[0], ret[1]);
             wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         }
         return v1;
@@ -297,7 +206,6 @@ if (Symbol.dispose) HwpImage.prototype[Symbol.dispose] = HwpImage.prototype.free
 
 export class ParseOptions {
     static __wrap(ptr) {
-        ptr = ptr >>> 0;
         const obj = Object.create(ParseOptions.prototype);
         obj.__wbg_ptr = ptr;
         ParseOptionsFinalization.register(obj, obj.__wbg_ptr, obj);
@@ -313,12 +221,6 @@ export class ParseOptions {
         const ptr = this.__destroy_into_raw();
         wasm.__wbg_parseoptions_free(ptr, 0);
     }
-    constructor() {
-        const ret = wasm.parseoptions_new();
-        this.__wbg_ptr = ret >>> 0;
-        ParseOptionsFinalization.register(this, this.__wbg_ptr, this);
-        return this;
-    }
     /**
      * @returns {ParseOptions}
      */
@@ -327,6 +229,12 @@ export class ParseOptions {
         const ret = wasm.parseoptions_lenient(ptr);
         return ParseOptions.__wrap(ret);
     }
+    constructor() {
+        const ret = wasm.parseoptions_new();
+        this.__wbg_ptr = ret;
+        ParseOptionsFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
     /**
      * @returns {ParseOptions}
      */
@@ -368,22 +276,18 @@ export function parseWithOptions(data, opts) {
     }
     return HwpDocument.__wrap(ret[0]);
 }
-
-export function __wbg___wbindgen_throw_dd24417ed36fc46e(arg0, arg1) {
+export function __wbg___wbindgen_throw_5d9e815e6fdf150f(arg0, arg1) {
     throw new Error(getStringFromWasm0(arg0, arg1));
-};
-
+}
 export function __wbg_hwpimage_new(arg0) {
     const ret = HwpImage.__wrap(arg0);
     return ret;
-};
-
-export function __wbindgen_cast_2241b6af4c4b2941(arg0, arg1) {
+}
+export function __wbindgen_generic_0000000000000001(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
-};
-
+}
 export function __wbindgen_init_externref_table() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);
@@ -392,4 +296,90 @@ export function __wbindgen_init_externref_table() {
     table.set(offset + 1, null);
     table.set(offset + 2, true);
     table.set(offset + 3, false);
-};
+}
+const HwpDocumentFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_hwpdocument_free(ptr, 1));
+const HwpImageFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_hwpimage_free(ptr, 1));
+const ParseOptionsFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_parseoptions_free(ptr, 1));
+
+function _assertClass(instance, klass) {
+    if (!(instance instanceof klass)) {
+        throw new Error(`expected instance of ${klass.name}`);
+    }
+}
+
+function getArrayJsValueFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    const mem = getDataViewMemory0();
+    const result = [];
+    for (let i = ptr; i < ptr + 4 * len; i += 4) {
+        result.push(wasm.__wbindgen_externrefs.get(mem.getUint32(i, true)));
+    }
+    wasm.__externref_drop_slice(ptr, len);
+    return result;
+}
+
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+let WASM_VECTOR_LEN = 0;
+
+
+let wasm;
+export function __wbg_set_wasm(val) {
+    wasm = val;
+}