@gukhanmun/wasm 0.3.0-dev.196 → 0.3.0-dev.203

package/dist/index.d.ts

@@ -288,6 +288,48 @@ interface Directives {
    */
   readonly skipAnnotation?: readonly string[];
 }
+/** Policy for ordinary spaces following an eligible stop. */
+type SpaceAfter = "preserve" | "remove" | "single";
+/** Built-in output style; input recognition is independent of this choice. */
+type PunctuationPreset = "preserve" | "modern" | "traditional" | "traditional-vertical";
+/** A single Unicode scalar and its following U+0020 policy. */
+interface StopStyle {
+  /** One Unicode scalar, validated by the shared profile resolver. */
+  readonly mark: string;
+  /** Policy applied only to U+0020 following this stop. */
+  readonly after: SpaceAfter;
+}
+/** Opening and closing Unicode punctuation scalars. */
+interface DelimiterStyle {
+  /** Opening scalar with Unicode category Ps or Pi. */
+  readonly open: string;
+  /** Closing scalar with Unicode category Pe or Pf. */
+  readonly close: string;
+}
+/** Partial overrides; omitted roles inherit, null preserves the role. */
+interface CustomPunctuationProfile {
+  /** Inherited preset, defaulting to preserve. */
+  readonly base?: PunctuationPreset;
+  /** Comma style; omitted inherits, null preserves. */
+  readonly comma?: StopStyle | null;
+  /** Period style; omitted inherits, null preserves. */
+  readonly period?: StopStyle | null;
+  /** Single delimiters; omitted inherits, null preserves. */
+  readonly single?: DelimiterStyle | null;
+  /** Double delimiters; omitted inherits, null preserves. */
+  readonly double?: DelimiterStyle | null;
+}
+/** Fully resolved styles, copied and deeply frozen by each binding. */
+interface ResolvedPunctuationProfile {
+  /** Comma style, or null for preservation. */
+  readonly comma: StopStyle | null;
+  /** Period style, or null for preservation. */
+  readonly period: StopStyle | null;
+  /** Single delimiters, or null for preservation. */
+  readonly single: DelimiterStyle | null;
+  /** Double delimiters, or null for preservation. */
+  readonly double: DelimiterStyle | null;
+}
 /**
  * Full set of options passed to {@link GukhanmunFactory.load} (or the
  * top-level `load` function) to configure a {@link Gukhanmun} instance.
@@ -297,6 +339,8 @@ interface Directives {
  * given, `"ko-kr"` is implicitly used.
  */
 interface GukhanmunOptions {
+  /** Independent output punctuation policy. Defaults to preserve. */
+  readonly punctuation?: PunctuationPreset | CustomPunctuationProfile;
   /**
    * Named configuration preset.  Defaults to `"ko-kr"`.
    *
@@ -480,7 +524,9 @@ interface Gukhanmun {
    * `originalGloss`, which are not meaningfully representable as plain
    * values.
    */
-  readonly options: Readonly<Required<Omit<GukhanmunOptions, "dictionaries" | "directives" | "html" | "originalGloss">>>;
+  readonly options: Readonly<Required<Omit<GukhanmunOptions, "dictionaries" | "directives" | "html" | "originalGloss" | "punctuation">> & {
+    readonly punctuation: ResolvedPunctuationProfile;
+  }>;
 }
 /**
  * Factory interface satisfied by both `@gukhanmun/wasm` and
@@ -617,4 +663,4 @@ declare class GukhanmunError extends Error {
  */
 declare function load(options?: GukhanmunOptions): Promise<Gukhanmun>;
 //#endregion
-export { type ContextWindow, type DictionaryEntry, type DictionarySource, type Directives, type ErrorCode, type FileDictionarySource, type Format, type Gukhanmun, GukhanmunError, type GukhanmunFactory, type GukhanmunOptions, type HanjaVariantSet, type HomophoneDetection, type HtmlOptions, type NumeralStrategy, type OriginalGloss, type Preset, type Recovery, type RenderMode, type Segmentation, load };
+export { type ContextWindow, type CustomPunctuationProfile, type DelimiterStyle, type DictionaryEntry, type DictionarySource, type Directives, type ErrorCode, type FileDictionarySource, type Format, type Gukhanmun, GukhanmunError, type GukhanmunFactory, type GukhanmunOptions, type HanjaVariantSet, type HomophoneDetection, type HtmlOptions, type NumeralStrategy, type OriginalGloss, type Preset, type PunctuationPreset, type Recovery, type RenderMode, type ResolvedPunctuationProfile, type Segmentation, type SpaceAfter, type StopStyle, load };

package/dist/index.js

@@ -200,6 +200,12 @@ function resolveOptions(opts = {}) {
 	const preset = opts.preset ?? "ko-kr";
 	const koKp = preset === "ko-kp";
 	return {
+		punctuation: {
+			comma: null,
+			period: null,
+			single: null,
+			double: null
+		},
 		preset,
 		rendering: opts.rendering ?? "hangul-only",
 		hanjaVariantSet: opts.hanjaVariantSet ?? "as-dictionary",
@@ -241,11 +247,18 @@ async function load(options = {}) {
 	} catch (e) {
 		throw liftError(e);
 	}
-	return new GukhanmunImpl(handle, resolved);
+	const punctuation = JSON.parse(handle.punctuation_profile_json());
+	for (const style of Object.values(punctuation)) if (style != null) Object.freeze(style);
+	Object.freeze(punctuation);
+	return new GukhanmunImpl(handle, {
+		...resolved,
+		punctuation
+	});
 }
 /** Builds the plain-object options passed across the WASM boundary. */
 function buildRawOptions(opts, resolved) {
 	const raw = {
+		punctuationJson: punctuationJson(opts.punctuation),
 		preset: resolved.preset,
 		rendering: resolved.rendering,
 		hanjaVariantSet: resolved.hanjaVariantSet,
@@ -270,5 +283,19 @@ function buildRawOptions(opts, resolved) {
 	};
 	return raw;
 }
+/** Reject ill-formed UTF-16 before a native boundary could replace surrogates. */
+function punctuationJson(value) {
+	try {
+		return JSON.stringify(value === void 0 ? "preserve" : value, (_key, v) => {
+			if (typeof v === "string" && Array.from(v).some((c) => {
+				const code = c.codePointAt(0);
+				return code >= 55296 && code <= 57343;
+			})) throw new Error("Punctuation strings must contain Unicode scalars");
+			return v;
+		});
+	} catch (error) {
+		throw new GukhanmunError("invalid-input", error instanceof Error ? error.message : String(error));
+	}
+}
 //#endregion
 export { GukhanmunError, load };

package/dist/wasm/deno/gukhanmun_wasm.d.ts

@@ -41,6 +41,10 @@ export class WasmGukhanmun {
      * equals the result of a single `convert` call on the concatenated input.
      */
     open_stream(format: any): WasmStream;
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     */
+    punctuation_profile_json(): string;
 }
 
 /**

package/dist/wasm/deno/gukhanmun_wasm.js

@@ -88,6 +88,22 @@ export class WasmGukhanmun {
         }
         return WasmStream.__wrap(ret[0]);
     }
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     * @returns {string}
+     */
+    punctuation_profile_json() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmgukhanmun_punctuation_profile_json(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);
+        }
+    }
 }
 if (Symbol.dispose) WasmGukhanmun.prototype[Symbol.dispose] = WasmGukhanmun.prototype.free;
 

package/dist/wasm/deno/gukhanmun_wasm_bg.wasm.d.ts

@@ -6,6 +6,7 @@ export const __wbg_wasmstream_free: (a: number, b: number) => void;
 export const wasmgukhanmun_convert: (a: number, b: number, c: number, d: any) => [number, number, number, number];
 export const wasmgukhanmun_new: (a: any, b: any) => [number, number, number];
 export const wasmgukhanmun_open_stream: (a: number, b: any) => [number, number, number];
+export const wasmgukhanmun_punctuation_profile_json: (a: number) => [number, number];
 export const wasmstream_finish: (a: number) => [number, number, number, number];
 export const wasmstream_push: (a: number, b: number, c: number) => [number, number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;

package/dist/wasm/nodejs/gukhanmun_wasm.d.ts

@@ -41,6 +41,10 @@ export class WasmGukhanmun {
      * equals the result of a single `convert` call on the concatenated input.
      */
     open_stream(format: any): WasmStream;
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     */
+    punctuation_profile_json(): string;
 }
 
 /**

package/dist/wasm/nodejs/gukhanmun_wasm.js

@@ -88,6 +88,22 @@ class WasmGukhanmun {
         }
         return WasmStream.__wrap(ret[0]);
     }
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     * @returns {string}
+     */
+    punctuation_profile_json() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmgukhanmun_punctuation_profile_json(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);
+        }
+    }
 }
 if (Symbol.dispose) WasmGukhanmun.prototype[Symbol.dispose] = WasmGukhanmun.prototype.free;
 exports.WasmGukhanmun = WasmGukhanmun;

package/dist/wasm/nodejs/gukhanmun_wasm_bg.wasm.d.ts

@@ -6,6 +6,7 @@ export const __wbg_wasmstream_free: (a: number, b: number) => void;
 export const wasmgukhanmun_convert: (a: number, b: number, c: number, d: any) => [number, number, number, number];
 export const wasmgukhanmun_new: (a: any, b: any) => [number, number, number];
 export const wasmgukhanmun_open_stream: (a: number, b: any) => [number, number, number];
+export const wasmgukhanmun_punctuation_profile_json: (a: number) => [number, number];
 export const wasmstream_finish: (a: number) => [number, number, number, number];
 export const wasmstream_push: (a: number, b: number, c: number) => [number, number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;

package/dist/wasm/web/gukhanmun_wasm.d.ts

@@ -41,6 +41,10 @@ export class WasmGukhanmun {
      * equals the result of a single `convert` call on the concatenated input.
      */
     open_stream(format: any): WasmStream;
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     */
+    punctuation_profile_json(): string;
 }
 
 /**
@@ -76,6 +80,7 @@ export interface InitOutput {
     readonly wasmgukhanmun_convert: (a: number, b: number, c: number, d: any) => [number, number, number, number];
     readonly wasmgukhanmun_new: (a: any, b: any) => [number, number, number];
     readonly wasmgukhanmun_open_stream: (a: number, b: any) => [number, number, number];
+    readonly wasmgukhanmun_punctuation_profile_json: (a: number) => [number, number];
     readonly wasmstream_finish: (a: number) => [number, number, number, number];
     readonly wasmstream_push: (a: number, b: number, c: number) => [number, number, number, number];
     readonly __wbindgen_malloc: (a: number, b: number) => number;

package/dist/wasm/web/gukhanmun_wasm.js

@@ -88,6 +88,22 @@ export class WasmGukhanmun {
         }
         return WasmStream.__wrap(ret[0]);
     }
+    /**
+     * Returns the resolved punctuation profile for the public immutable view.
+     * @returns {string}
+     */
+    punctuation_profile_json() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.wasmgukhanmun_punctuation_profile_json(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);
+        }
+    }
 }
 if (Symbol.dispose) WasmGukhanmun.prototype[Symbol.dispose] = WasmGukhanmun.prototype.free;
 

package/dist/wasm/web/gukhanmun_wasm_bg.wasm.d.ts

@@ -6,6 +6,7 @@ export const __wbg_wasmstream_free: (a: number, b: number) => void;
 export const wasmgukhanmun_convert: (a: number, b: number, c: number, d: any) => [number, number, number, number];
 export const wasmgukhanmun_new: (a: any, b: any) => [number, number, number];
 export const wasmgukhanmun_open_stream: (a: number, b: any) => [number, number, number];
+export const wasmgukhanmun_punctuation_profile_json: (a: number) => [number, number];
 export const wasmstream_finish: (a: number) => [number, number, number, number];
 export const wasmstream_push: (a: number, b: number, c: number) => [number, number, number, number];
 export const __wbindgen_malloc: (a: number, b: number) => number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gukhanmun/wasm",
-  "version": "0.3.0-dev.196",
+  "version": "0.3.0-dev.203",
   "description": "WebAssembly implementation of the Gukhanmun hanja-to-hangul converter.",
   "type": "module",
   "exports": {
@@ -45,7 +45,7 @@
     "@gukhanmun/types": "*"
   },
   "devDependencies": {
-    "@gukhanmun/types": "0.3.0-dev.196+0b574b5"
+    "@gukhanmun/types": "0.3.0-dev.203+7b876cb"
   },
   "scripts": {
     "build": "tsdown && node -e \"const fs=require('node:fs'),p=require('node:path');fs.cpSync('wasm','dist/wasm',{recursive:true,force:true,filter:(s)=>p.basename(s)!=='.gitignore'})\""