@laisuk/opencc-fmmseg-wasm 0.2.4 → 0.3.0

package/README.md

@@ -24,6 +24,13 @@ Features:
 * In-memory Office / EPUB document conversion
 * Zero-dependency Node.js CLI
 
+Package profile:
+
+* 0 runtime dependencies
+* 1 WASM file
+* 18 conversion configs
+* 100% offline
+
 ---
 
 ## Installation
@@ -38,7 +45,8 @@ npm install @laisuk/opencc-fmmseg-wasm
 
 ```javascript
 import init, {
-    OpenccWasm
+    OpenccWasm,
+    DetofuLevelWasm
 } from "@laisuk/opencc-fmmseg-wasm";
 
 await init();
@@ -47,6 +55,9 @@ const cc = new OpenccWasm("s2t");
 
 console.log(cc.convert("汉字", false));
 // 漢字
+
+console.log(cc.convertDetofu("儼驂騑於上路", false, DetofuLevelWasm.ExtB));
+// 俨骖騑于上路
 ```
 
 ---
@@ -54,43 +65,47 @@ console.log(cc.convert("汉字", false));
 ## Using Config Enums
 
 ```javascript
-import init, {
-    OpenccWasm,
-    OpenccConfigWasm
-} from "@laisuk/opencc-fmmseg-wasm";
-
-await init();
-
-const cc = OpenccWasm.newWithEnum(
-    OpenccConfigWasm.S2t
-);
+import init, {
+    OpenccWasm,
+    OpenccConfigWasm
+} from "@laisuk/opencc-fmmseg-wasm";
 
-console.log(cc.convert("汉字", false));
-// 漢字
+await init();
+
+const cc = OpenccWasm.newWithEnum(
+    OpenccConfigWasm.S2hkp
+);
+
+console.log(cc.convert("别随便录影侵犯个人隐私权", false));
+// 別隨便錄影侵犯個人私隱權
 ```
 
 ---
 
 ## Supported Configs
 
-| Config  | Description                                        |
-|---------|----------------------------------------------------|
-| `s2t`   | Simplified Chinese → Traditional Chinese           |
-| `s2tw`  | Simplified Chinese → Taiwan Traditional            |
-| `s2twp` | Simplified Chinese → Taiwan Traditional (phrases)  |
-| `s2hk`  | Simplified Chinese → Hong Kong Traditional         |
-| `t2s`   | Traditional Chinese → Simplified Chinese           |
-| `t2tw`  | Traditional Chinese → Taiwan Traditional           |
-| `t2twp` | Traditional Chinese → Taiwan Traditional (phrases) |
-| `t2hk`  | Traditional Chinese → Hong Kong Traditional        |
-| `tw2s`  | Taiwan Traditional → Simplified Chinese            |
-| `tw2sp` | Taiwan Traditional → Simplified Chinese (phrases)  |
-| `tw2t`  | Taiwan Traditional → Traditional Chinese           |
-| `tw2tp` | Taiwan Traditional → Traditional Chinese (phrases) |
-| `hk2s`  | Hong Kong Traditional → Simplified Chinese         |
-| `hk2t`  | Hong Kong Traditional → Traditional Chinese        |
-| `jp2t`  | Japanese Shinjitai → Traditional Chinese           |
-| `t2jp`  | Traditional Chinese → Japanese Shinjitai           |
+| Config  | Enum                     | Description                                          |
+|---------|--------------------------|------------------------------------------------------|
+| `s2t`   | `OpenccConfigWasm.S2t`   | Simplified Chinese → Traditional Chinese             |
+| `s2tw`  | `OpenccConfigWasm.S2tw`  | Simplified Chinese → Taiwan Traditional              |
+| `s2twp` | `OpenccConfigWasm.S2twp` | Simplified Chinese → Taiwan Traditional (phrases)    |
+| `s2hk`  | `OpenccConfigWasm.S2hk`  | Simplified Chinese → Hong Kong Traditional           |
+| `s2hkp` | `OpenccConfigWasm.S2hkp` | Simplified Chinese → Hong Kong Traditional (phrases) |
+| `t2s`   | `OpenccConfigWasm.T2s`   | Traditional Chinese → Simplified Chinese             |
+| `t2tw`  | `OpenccConfigWasm.T2tw`  | Traditional Chinese → Taiwan Traditional             |
+| `t2twp` | `OpenccConfigWasm.T2twp` | Traditional Chinese → Taiwan Traditional (phrases)   |
+| `t2hk`  | `OpenccConfigWasm.T2hk`  | Traditional Chinese → Hong Kong Traditional          |
+| `tw2s`  | `OpenccConfigWasm.Tw2s`  | Taiwan Traditional → Simplified Chinese              |
+| `tw2sp` | `OpenccConfigWasm.Tw2sp` | Taiwan Traditional → Simplified Chinese (phrases)    |
+| `tw2t`  | `OpenccConfigWasm.Tw2t`  | Taiwan Traditional → Traditional Chinese             |
+| `tw2tp` | `OpenccConfigWasm.Tw2tp` | Taiwan Traditional → Traditional Chinese (phrases)   |
+| `hk2s`  | `OpenccConfigWasm.Hk2s`  | Hong Kong Traditional → Simplified Chinese           |
+| `hk2sp` | `OpenccConfigWasm.Hk2sp` | Hong Kong Traditional → Simplified Chinese (phrases) |
+| `hk2t`  | `OpenccConfigWasm.Hk2t`  | Hong Kong Traditional → Traditional Chinese          |
+| `jp2t`  | `OpenccConfigWasm.Jp2t`  | Japanese Shinjitai → Traditional Chinese             |
+| `t2jp`  | `OpenccConfigWasm.T2jp`  | Traditional Chinese → Japanese Shinjitai             |
+
+The numeric enum values match the vendored Rust backend. Existing values are unchanged; `S2hkp = 17` and `Hk2sp = 18`.
 
 ---
 
@@ -113,6 +128,15 @@ Example:
 const cc = new OpenccWasm("t2s");
 ```
 
+Hong Kong phrase config example:
+
+```javascript
+const cc = new OpenccWasm("s2hkp");
+
+cc.convert("别随便录影侵犯个人隐私权", false);
+// 別隨便錄影侵犯個人私隱權
+```
+
 ---
 
 ### convert
@@ -138,6 +162,85 @@ cc.convert("汉字", false);
 
 ---
 
+### detofu
+
+Replace tofu-risk rare CJK extension characters with display-compatible fallbacks.
+
+```javascript
+cc.detofu(text, level)
+```
+
+Parameters:
+
+* `text`: input string
+* `level`: `DetofuLevelWasm` threshold for the CJK extension ranges to replace
+
+Returns:
+
+* detofu-safe string
+
+Supported levels:
+
+| Enum                   | CLI value |
+|------------------------|-----------|
+| `DetofuLevelWasm.ExtB` | `ext-b`   |
+| `DetofuLevelWasm.ExtC` | `ext-c`   |
+| `DetofuLevelWasm.ExtD` | `ext-d`   |
+| `DetofuLevelWasm.ExtE` | `ext-e`   |
+| `DetofuLevelWasm.ExtF` | `ext-f`   |
+| `DetofuLevelWasm.ExtG` | `ext-g`   |
+| `DetofuLevelWasm.ExtH` | `ext-h`   |
+| `DetofuLevelWasm.ExtI` | `ext-i`   |
+
+Example:
+
+```javascript
+import init, {
+    OpenccWasm,
+    DetofuLevelWasm
+} from "@laisuk/opencc-fmmseg-wasm";
+
+await init();
+
+const cc = new OpenccWasm("t2s");
+const converted = cc.convert("儼驂騑於上路", false);
+
+console.log(converted);
+// 俨骖𬴂于上路
+
+console.log(cc.detofu(converted, DetofuLevelWasm.ExtB));
+// 俨骖騑于上路
+```
+
+---
+
+### convertDetofu
+
+Convert text and apply detofu in one call.
+
+```javascript
+cc.convertDetofu(text, punctuation, level)
+```
+
+Parameters:
+
+* `text`: input string
+* `punctuation`: whether to convert punctuation variants
+* `level`: `DetofuLevelWasm` threshold for the CJK extension ranges to replace
+
+Returns:
+
+* converted detofu-safe string
+
+Example:
+
+```javascript
+cc.convertDetofu("儼驂騑於上路", false, DetofuLevelWasm.ExtB);
+// 俨骖騑于上路
+```
+
+---
+
 ### setConfig
 
 ```javascript
@@ -177,6 +280,8 @@ OpenccWasm.getSupportedConfigs();
 
 Returns all supported config strings.
 
+Includes `s2hkp` and `hk2sp`.
+
 ---
 
 ### zhoCheck
@@ -197,6 +302,137 @@ Returns:
 
 ---
 
+### newWithCustomDicts
+
+Construct a converter with in-memory custom dictionary pairs.
+
+```javascript
+const cc = OpenccWasm.newWithCustomDicts(config, specs);
+```
+
+Parameters:
+
+* `config`: OpenCC config string, such as `"s2t"`
+* `specs`: array of custom dictionary specs
+
+TypeScript-style spec shape:
+
+```typescript
+type WasmCustomDictSpec = {
+    slot: string;
+    mode?: "Append" | "Override";
+    pairs: Array<[string, string]>;
+};
+```
+
+`mode` defaults to `"Append"` when omitted.
+
+Each `pairs` entry is a `[source, target]` string tuple for the selected slot.
+
+TypeScript example:
+
+```typescript
+import init, {OpenccWasm} from "@laisuk/opencc-fmmseg-wasm";
+
+await init();
+
+const specs: WasmCustomDictSpec[] = [
+    {
+        slot: "STPhrases",
+        pairs: [
+            ["云端", "雲端"]
+        ]
+    }
+];
+
+const cc = OpenccWasm.newWithCustomDicts("s2t", specs);
+```
+
+Practical example:
+
+```javascript
+import init, {OpenccWasm} from "@laisuk/opencc-fmmseg-wasm";
+
+await init();
+
+const cc = OpenccWasm.newWithCustomDicts("s2t", [
+    {
+        slot: "STPhrases",
+        mode: "Append",
+        pairs: [
+            ["帕兰蒂尔", "柏蘭蒂爾"],
+            ["软件", "軟體"]
+        ]
+    }
+]);
+
+console.log(cc.convert("帕兰蒂尔软件", false));
+// 柏蘭蒂爾軟體
+```
+
+Override example:
+
+```javascript
+const cc = OpenccWasm.newWithCustomDicts("s2t", [
+    {
+        slot: "STPhrases",
+        mode: "Override",
+        pairs: [
+            ["软件", "軟體"]
+        ]
+    }
+]);
+```
+
+`Override` replaces the selected slot before inserting the provided pairs. It is powerful and should be used only when
+the caller intentionally wants to discard built-in entries for that slot.
+
+Custom dictionary specs use strict canonical `DictSlot` names:
+
+```text
+STPhrases
+TSPhrases
+STCharacters
+TSCharacters
+TWPhrases
+TWPhrasesRev
+HKPhrases
+HKPhrasesRev
+TWVariants
+TWVariantsPhrases
+TWVariantsRev
+TWVariantsRevPhrases
+HKVariants
+HKVariantsPhrases
+HKVariantsRev
+HKVariantsRevPhrases
+JPShinjitaiCharacters
+JPShinjitaiPhrases
+JPVariants
+JPVariantsRev
+STPunctuations
+TSPunctuations
+```
+
+Suffixes such as `.txt` are not accepted. Use `"STPhrases"`, not `"STPhrases.txt"`.
+
+Merge contract:
+
+* Custom dictionaries are loaded from in-memory pairs only; no file I/O is involved.
+* The embedded compressed CBOR dictionary is loaded first.
+* Custom specs are applied to `DictionaryMaxlength` before `OpenCC::from_dictionary(...)`.
+* Conversion hot paths remain immutable after construction.
+* `Append` mode merges into the selected slot.
+* Duplicate or conflicting keys use last-wins semantics.
+* `Override` mode clears the selected slot first, then inserts the provided custom pairs.
+* Multiple specs are applied in array order.
+
+This API is useful for browser apps, user-defined terminology, database-loaded terms, generated dictionaries,
+`localStorage` or `IndexedDB` terms, testing, and embedded WASM environments. Customization happens at construction
+time, not during conversion.
+
+---
+
 ## Office / EPUB Conversion
 
 Office and EPUB conversion runs fully locally in the browser or Node.js. Files are passed in and returned as bytes;
@@ -308,6 +544,26 @@ fs.writeFileSync("output.docx", outputBytes);
 </html>
 ```
 
+> **Note**
+>
+> The npm package automatically loads the bundled WebAssembly module when
+> installed normally via npm.
+>
+> If you are running examples directly from a local repository checkout,
+> you may need to initialize using explicit WASM bytes:
+>
+> ```javascript
+> import fs from "fs";
+> import init from "../pkg/opencc_fmmseg_wasm.js";
+>
+> const wasmBytes = fs.readFileSync(
+>     "../pkg/opencc_fmmseg_wasm_bg.wasm"
+> );
+>
+> await init({ module: wasmBytes });
+> ```
+>
+
 ---
 
 ## Node.js CLI
@@ -316,6 +572,8 @@ The package includes a zero-dependency Node.js CLI:
 
 ```bash
 opencc-fmmseg convert -i input.txt -o output.txt -c s2t -p
+opencc-fmmseg convert -i input.txt -o output.txt -c t2s -p --detofu all
+echo "别随便录影侵犯个人隐私权" | opencc-fmmseg convert -c s2hkp
 ```
 
 ```bash
@@ -329,10 +587,20 @@ opencc-fmmseg office -i input.docx -o output.docx -c s2t -p --keep-font
 -o, --output <file>         Output text file
 -c, --config <conversion>   Conversion config
 -p, --punct                 Enable punctuation conversion
+--detofu [level]            Replace tofu-risk rare CJK extension chars after conversion
+                              level: all | ext-b | ext-c | ext-d | ext-e | ext-f | ext-g | ext-h | ext-i
+                              default when omitted value: all
 --in-enc <encoding>         Input encoding
 --out-enc <encoding>        Output encoding
 ```
 
+Supported conversion configs:
+
+```text
+s2t, s2tw, s2twp, s2hk, s2hkp, t2s, t2tw, t2twp, t2hk,
+tw2s, tw2sp, tw2t, tw2tp, hk2s, hk2sp, hk2t, jp2t, t2jp
+```
+
 ### Office / EPUB Options
 
 ```text
@@ -356,13 +624,16 @@ If `-o, --output` is omitted, `office` writes:
 
 ---
 
-## TypeScript Support
-
-The package includes generated TypeScript definitions from `wasm-bindgen`.
-
-The WASM-facing enum is exported as `OpenccConfigWasm`, alongside `OpenccWasm`.
-
----
+## TypeScript Support
+
+The package includes generated TypeScript definitions from `wasm-bindgen`.
+
+The WASM-facing enum is exported as `OpenccConfigWasm`, alongside `OpenccWasm`.
+
+`OpenccConfigWasm.S2hkp` and `OpenccConfigWasm.Hk2sp` are available for Hong Kong phrase conversions and map to backend
+config IDs `17` and `18`.
+
+---
 
 ## Performance Notes
 

package/bin/opencc.js

@@ -6,6 +6,7 @@ import process from "process";
 
 import init, {
     OpenccWasm,
+    DetofuLevelWasm,
     convert_office_bytes
 } from "../opencc_fmmseg_wasm.js";
 
@@ -53,9 +54,16 @@ Convert options:
   -o, --output <file>         Output text file; stdout if omitted
   -c, --config <conversion>   Conversion config (default: s2t)
   -p, --punct                 Enable punctuation conversion
+  --detofu [level]            Replace tofu-risk rare CJK extension chars after conversion
+                              level: all | ext-b | ext-c | ext-d | ext-e | ext-f | ext-g | ext-h | ext-i
+                              default when omitted value: all
   --in-enc <encoding>         Input encoding (default: utf8)
   --out-enc <encoding>        Output encoding (default: utf8)
 
+Supported configs:
+  s2t, s2tw, s2twp, s2hk, s2hkp, t2s, t2tw, t2twp, t2hk,
+  tw2s, tw2sp, tw2t, tw2tp, hk2s, hk2sp, hk2t, jp2t, t2jp
+
 Office options:
   -i, --input <file>          Input Office / EPUB file
   -o, --output <file>         Output file
@@ -73,6 +81,9 @@ Examples:
   npx opencc-fmmseg convert -i a.txt -o b.txt -c s2t
   npx opencc-fmmseg convert -i a.txt -o b.txt -c s2tw -p
   cat a.txt | npx opencc-fmmseg convert -c t2s
+  echo "别随便录影侵犯个人隐私权" | npx opencc-fmmseg convert -c s2hkp
+  npx opencc-fmmseg convert -i a.txt -o b.txt -c t2s --detofu
+  npx opencc-fmmseg convert -i a.txt -o b.txt -c t2s --detofu ext-c
 
   npx opencc-fmmseg office -i a.docx -o b.docx -c s2t -p
   npx opencc-fmmseg office -i a.epub -c s2tw --auto-ext
@@ -179,6 +190,56 @@ function applyAutoExt(outputFile, officeFormat, autoExt) {
     return `${outputFile}.${officeFormat}`;
 }
 
+function parseDetofuLevel(value) {
+    if (value === null || value === undefined || value === true) {
+        return DetofuLevelWasm.ExtB; // "all"
+    }
+
+    const normalized = String(value).trim().toLowerCase();
+
+    switch (normalized) {
+        case "":
+        case "all":
+        case "ext-b":
+        case "extb":
+        case "b":
+            return DetofuLevelWasm.ExtB;
+        case "ext-c":
+        case "extc":
+        case "c":
+            return DetofuLevelWasm.ExtC;
+        case "ext-d":
+        case "extd":
+        case "d":
+            return DetofuLevelWasm.ExtD;
+        case "ext-e":
+        case "exte":
+        case "e":
+            return DetofuLevelWasm.ExtE;
+        case "ext-f":
+        case "extf":
+        case "f":
+            return DetofuLevelWasm.ExtF;
+        case "ext-g":
+        case "extg":
+        case "g":
+            return DetofuLevelWasm.ExtG;
+        case "ext-h":
+        case "exth":
+        case "h":
+            return DetofuLevelWasm.ExtH;
+        case "ext-i":
+        case "exti":
+        case "i":
+            return DetofuLevelWasm.ExtI;
+        default:
+            throw new Error(
+                `Invalid detofu level: ${value}. ` +
+                `Valid values: all | ext-b | ext-c | ext-d | ext-e | ext-f | ext-g | ext-h | ext-i`
+            );
+    }
+}
+
 async function runConvert(args) {
     const input = getArg(args, "-i", "--input");
     const output = getArg(args, "-o", "--output");
@@ -187,6 +248,20 @@ async function runConvert(args) {
     const outEnc = getArg(args, null, "--out-enc", "utf8");
     const punct = hasFlag(args, "-p", "--punct");
 
+    const detofuIndex = args.indexOf("--detofu");
+    const detofuEnabled = detofuIndex !== -1;
+    let detofuLevel = null;
+
+    if (detofuEnabled) {
+        const next = args[detofuIndex + 1];
+
+        if (!next || next.startsWith("-")) {
+            detofuLevel = parseDetofuLevel("all");
+        } else {
+            detofuLevel = parseDetofuLevel(next);
+        }
+    }
+
     await ensureWasmInitialized();
 
     const cc = new OpenccWasm(config);
@@ -197,7 +272,11 @@ async function runConvert(args) {
     }
 
     const inputText = readInputText(input, inEnc);
-    const outputText = cc.convert(inputText, punct);
+    let outputText = cc.convert(inputText, punct);
+
+    if (detofuEnabled) {
+        outputText = cc.detofu(outputText, detofuLevel);
+    }
 
     writeOutputText(output, outputText, outEnc);
 
@@ -209,7 +288,8 @@ async function runConvert(args) {
             console.error();
         }
 
-        console.error(`Conversion completed (${config}): ${inFrom} -> ${outTo}`);
+        const suffix = detofuEnabled ? ", detofu" : "";
+        console.error(`Conversion completed (${config}${suffix}): ${inFrom} -> ${outTo}`);
     }
 }
 

package/opencc_fmmseg_wasm.d.ts

@@ -1,6 +1,17 @@
 /* tslint:disable */
 /* eslint-disable */
 
+export enum DetofuLevelWasm {
+    ExtB = 2,
+    ExtC = 3,
+    ExtD = 4,
+    ExtE = 5,
+    ExtF = 6,
+    ExtG = 7,
+    ExtH = 8,
+    ExtI = 9,
+}
+
 export enum OpenccConfigWasm {
     S2t = 1,
     S2tw = 2,
@@ -18,18 +29,23 @@ export enum OpenccConfigWasm {
     Hk2t = 14,
     Jp2t = 15,
     T2jp = 16,
+    S2hkp = 17,
+    Hk2sp = 18,
 }
 
 export class OpenccWasm {
     free(): void;
     [Symbol.dispose](): void;
     convert(text: string, punctuation: boolean): string;
+    convertDetofu(text: string, punctuation: boolean, level: DetofuLevelWasm): string;
     debugPing(): string;
+    detofu(text: string, level: DetofuLevelWasm): string;
     getConfig(): string;
     getConfigId(): number;
     static getSupportedConfigs(): string[];
     static isValidConfig(config: string): boolean;
     constructor(config?: string | null);
+    static newWithCustomDicts(config: string | null | undefined, specs: any): OpenccWasm;
     static newWithEnum(config?: OpenccConfigWasm | null): OpenccWasm;
     setConfig(config: string): boolean;
     setConfigEnum(config: OpenccConfigWasm): void;
@@ -45,19 +61,24 @@ export interface InitOutput {
     readonly __wbg_openccwasm_free: (a: number, b: number) => void;
     readonly convert_office_bytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => [number, number, number, number];
     readonly openccwasm_convert: (a: number, b: number, c: number, d: number) => [number, number];
+    readonly openccwasm_convertDetofu: (a: number, b: number, c: number, d: number, e: number) => [number, number];
     readonly openccwasm_debugPing: (a: number) => [number, number];
+    readonly openccwasm_detofu: (a: number, b: number, c: number, d: number) => [number, number];
     readonly openccwasm_getConfig: (a: number) => [number, number];
     readonly openccwasm_getConfigId: (a: number) => number;
     readonly openccwasm_getSupportedConfigs: () => [number, number];
     readonly openccwasm_isValidConfig: (a: number, b: number) => number;
     readonly openccwasm_new: (a: number, b: number) => [number, number, number];
+    readonly openccwasm_newWithCustomDicts: (a: number, b: number, c: any) => [number, number, number];
     readonly openccwasm_newWithEnum: (a: number) => [number, number, number];
     readonly openccwasm_setConfig: (a: number, b: number, c: number) => number;
     readonly openccwasm_setConfigEnum: (a: number, b: number) => void;
     readonly openccwasm_zhoCheck: (a: number, b: number, c: number) => number;
-    readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
+    readonly __wbindgen_exn_store: (a: number) => void;
+    readonly __externref_table_alloc: () => number;
+    readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __externref_drop_slice: (a: number, b: number) => void;

package/opencc_fmmseg_wasm.js

@@ -1,7 +1,21 @@
 /* @ts-self-types="./opencc_fmmseg_wasm.d.ts" */
 
 /**
- * @enum {1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16}
+ * @enum {2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}
+ */
+export const DetofuLevelWasm = Object.freeze({
+    ExtB: 2, "2": "ExtB",
+    ExtC: 3, "3": "ExtC",
+    ExtD: 4, "4": "ExtD",
+    ExtE: 5, "5": "ExtE",
+    ExtF: 6, "6": "ExtF",
+    ExtG: 7, "7": "ExtG",
+    ExtH: 8, "8": "ExtH",
+    ExtI: 9, "9": "ExtI",
+});
+
+/**
+ * @enum {1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18}
  */
 export const OpenccConfigWasm = Object.freeze({
     S2t: 1, "1": "S2t",
@@ -20,6 +34,8 @@ export const OpenccConfigWasm = Object.freeze({
     Hk2t: 14, "14": "Hk2t",
     Jp2t: 15, "15": "Jp2t",
     T2jp: 16, "16": "T2jp",
+    S2hkp: 17, "17": "S2hkp",
+    Hk2sp: 18, "18": "Hk2sp",
 });
 
 export class OpenccWasm {
@@ -58,6 +74,26 @@ export class OpenccWasm {
             wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
         }
     }
+    /**
+     * @param {string} text
+     * @param {boolean} punctuation
+     * @param {DetofuLevelWasm} level
+     * @returns {string}
+     */
+    convertDetofu(text, punctuation, level) {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ret = wasm.openccwasm_convertDetofu(this.__wbg_ptr, ptr0, len0, punctuation, level);
+            deferred2_0 = ret[0];
+            deferred2_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * @returns {string}
      */
@@ -73,6 +109,25 @@ export class OpenccWasm {
             wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * @param {string} text
+     * @param {DetofuLevelWasm} level
+     * @returns {string}
+     */
+    detofu(text, level) {
+        let deferred2_0;
+        let deferred2_1;
+        try {
+            const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len0 = WASM_VECTOR_LEN;
+            const ret = wasm.openccwasm_detofu(this.__wbg_ptr, ptr0, len0, level);
+            deferred2_0 = ret[0];
+            deferred2_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
+        }
+    }
     /**
      * @returns {string}
      */
@@ -128,6 +183,20 @@ export class OpenccWasm {
         OpenccWasmFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
+    /**
+     * @param {string | null | undefined} config
+     * @param {any} specs
+     * @returns {OpenccWasm}
+     */
+    static newWithCustomDicts(config, specs) {
+        var ptr0 = isLikeNone(config) ? 0 : passStringToWasm0(config, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+        var len0 = WASM_VECTOR_LEN;
+        const ret = wasm.openccwasm_newWithCustomDicts(ptr0, len0, specs);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return OpenccWasm.__wrap(ret[0]);
+    }
     /**
      * @param {OpenccConfigWasm | null} [config]
      * @returns {OpenccWasm}
@@ -194,9 +263,142 @@ export function convert_office_bytes(input, format, config, punctuation, keep_fo
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
+        __wbg_Error_ef53bc310eb298a0: function(arg0, arg1) {
+            const ret = Error(getStringFromWasm0(arg0, arg1));
+            return ret;
+        },
+        __wbg_String_8564e559799eccda: function(arg0, arg1) {
+            const ret = String(arg1);
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_boolean_get_1a45e2c38d4d41b9: function(arg0) {
+            const v = arg0;
+            const ret = typeof(v) === 'boolean' ? v : undefined;
+            return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
+        },
+        __wbg___wbindgen_debug_string_0accd80f45e5faa2: function(arg0, arg1) {
+            const ret = debugString(arg1);
+            const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            const len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
+        __wbg___wbindgen_in_70a403a56e771704: function(arg0, arg1) {
+            const ret = arg0 in arg1;
+            return ret;
+        },
+        __wbg___wbindgen_is_function_754e9f305ff6029e: function(arg0) {
+            const ret = typeof(arg0) === 'function';
+            return ret;
+        },
+        __wbg___wbindgen_is_object_56732c2bc353f41d: function(arg0) {
+            const val = arg0;
+            const ret = typeof(val) === 'object' && val !== null;
+            return ret;
+        },
+        __wbg___wbindgen_is_undefined_67b456be8673d3d7: function(arg0) {
+            const ret = arg0 === undefined;
+            return ret;
+        },
+        __wbg___wbindgen_jsval_loose_eq_2c56564c75129511: function(arg0, arg1) {
+            const ret = arg0 == arg1;
+            return ret;
+        },
+        __wbg___wbindgen_number_get_9bb1761122181af2: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'number' ? obj : undefined;
+            getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+        },
+        __wbg___wbindgen_string_get_72bdf95d3ae505b1: function(arg0, arg1) {
+            const obj = arg1;
+            const ret = typeof(obj) === 'string' ? obj : undefined;
+            var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+            var len1 = WASM_VECTOR_LEN;
+            getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
+            getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
+        },
         __wbg___wbindgen_throw_1506f2235d1bdba0: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
+        __wbg_call_8a89609d89f6608a: function() { return handleError(function (arg0, arg1) {
+            const ret = arg0.call(arg1);
+            return ret;
+        }, arguments); },
+        __wbg_done_60cf307fcc680536: function(arg0) {
+            const ret = arg0.done;
+            return ret;
+        },
+        __wbg_get_1f8f054ddbaa7db2: function() { return handleError(function (arg0, arg1) {
+            const ret = Reflect.get(arg0, arg1);
+            return ret;
+        }, arguments); },
+        __wbg_get_unchecked_33f6e5c9e2f2d6b2: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_get_with_ref_key_6412cf3094599694: function(arg0, arg1) {
+            const ret = arg0[arg1];
+            return ret;
+        },
+        __wbg_instanceof_ArrayBuffer_8f49811467741499: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof ArrayBuffer;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_Uint8Array_86f30649f63ef9c2: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Uint8Array;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_isArray_67c2c9c4313f4448: function(arg0) {
+            const ret = Array.isArray(arg0);
+            return ret;
+        },
+        __wbg_iterator_8732428d309e270e: function() {
+            const ret = Symbol.iterator;
+            return ret;
+        },
+        __wbg_length_4a591ecaa01354d9: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
+        __wbg_length_66f1a4b2e9026940: function(arg0) {
+            const ret = arg0.length;
+            return ret;
+        },
+        __wbg_new_578aeef4b6b94378: function(arg0) {
+            const ret = new Uint8Array(arg0);
+            return ret;
+        },
+        __wbg_next_9e03acdf51c4960d: function(arg0) {
+            const ret = arg0.next;
+            return ret;
+        },
+        __wbg_next_eb8ca7351fa27906: function() { return handleError(function (arg0) {
+            const ret = arg0.next();
+            return ret;
+        }, arguments); },
+        __wbg_prototypesetcall_3249fc62a0fafa30: function(arg0, arg1, arg2) {
+            Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+        },
+        __wbg_value_f3625092ee4b37f4: function(arg0) {
+            const ret = arg0.value;
+            return ret;
+        },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
@@ -222,6 +424,77 @@ const OpenccWasmFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_openccwasm_free(ptr, 1));
 
+function addToExternrefTable0(obj) {
+    const idx = wasm.__externref_table_alloc();
+    wasm.__wbindgen_externrefs.set(idx, obj);
+    return idx;
+}
+
+function debugString(val) {
+    // primitive types
+    const type = typeof val;
+    if (type == 'number' || type == 'boolean' || val == null) {
+        return  `${val}`;
+    }
+    if (type == 'string') {
+        return `"${val}"`;
+    }
+    if (type == 'symbol') {
+        const description = val.description;
+        if (description == null) {
+            return 'Symbol';
+        } else {
+            return `Symbol(${description})`;
+        }
+    }
+    if (type == 'function') {
+        const name = val.name;
+        if (typeof name == 'string' && name.length > 0) {
+            return `Function(${name})`;
+        } else {
+            return 'Function';
+        }
+    }
+    // objects
+    if (Array.isArray(val)) {
+        const length = val.length;
+        let debug = '[';
+        if (length > 0) {
+            debug += debugString(val[0]);
+        }
+        for(let i = 1; i < length; i++) {
+            debug += ', ' + debugString(val[i]);
+        }
+        debug += ']';
+        return debug;
+    }
+    // Test for built-in
+    const builtInMatches = /\[object ([^\]]+)\]/.exec(toString.call(val));
+    let className;
+    if (builtInMatches && builtInMatches.length > 1) {
+        className = builtInMatches[1];
+    } else {
+        // Failed to match the standard '[object ClassName]'
+        return toString.call(val);
+    }
+    if (className == 'Object') {
+        // we're a user defined class or Object
+        // JSON.stringify avoids problems with cycles, and is generally much
+        // easier than looping through ownProperties of `val`.
+        try {
+            return 'Object(' + JSON.stringify(val) + ')';
+        } catch (_) {
+            return 'Object';
+        }
+    }
+    // errors
+    if (val instanceof Error) {
+        return `${val.name}: ${val.message}\n${val.stack}`;
+    }
+    // TODO we could test for more things here, like `Set`s and `Map`s.
+    return className;
+}
+
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getDataViewMemory0();
@@ -258,6 +531,15 @@ function getUint8ArrayMemory0() {
     return cachedUint8ArrayMemory0;
 }
 
+function handleError(f, args) {
+    try {
+        return f.apply(this, args);
+    } catch (e) {
+        const idx = addToExternrefTable0(e);
+        wasm.__wbindgen_exn_store(idx);
+    }
+}
+
 function isLikeNone(x) {
     return x === undefined || x === null;
 }

package/package.json

@@ -2,7 +2,7 @@
   "name": "@laisuk/opencc-fmmseg-wasm",
   "type": "module",
   "description": "WebAssembly bindings for opencc-fmmseg, a high-performance OpenCC-compatible Simplified/Traditional Chinese converter.",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",