@gukhanmun/types 0.3.0-dev.185 → 0.3.0-dev.203

package/dist/index.d.ts

@@ -287,6 +287,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.
@@ -296,6 +338,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"`.
    *
@@ -398,7 +442,9 @@ interface GukhanmunOptions {
    * Korean Language Dictionary*, add `@gukhanmun/stdict-fst` or
    * `@gukhanmun/stdict-cdb` explicitly.  To use Open Korean Dictionary
    * categories, add `@gukhanmun/opendict-fst` or
-   * `@gukhanmun/opendict-cdb` explicitly.
+   * `@gukhanmun/opendict-cdb` explicitly. For NIKL loanword examples, load
+   * `@gukhanmun/loanwords-fst` or `@gukhanmun/loanwords-cdb`. Put user
+   * dictionaries first, then loanwords, then the preset dictionaries.
    *
    * @see {@link DictionarySource}
    */
@@ -477,7 +523,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
@@ -576,4 +624,4 @@ declare class GukhanmunError extends Error {
   }[];
 }
 //#endregion
-export { ContextWindow, DictionaryEntry, DictionarySource, Directives, ErrorCode, FileDictionarySource, Format, Gukhanmun, GukhanmunError, GukhanmunFactory, GukhanmunOptions, HanjaVariantSet, HomophoneDetection, HtmlOptions, NumeralStrategy, OriginalGloss, Preset, Recovery, RenderMode, Segmentation, load };
+export { ContextWindow, CustomPunctuationProfile, DelimiterStyle, DictionaryEntry, DictionarySource, Directives, ErrorCode, FileDictionarySource, Format, Gukhanmun, GukhanmunError, GukhanmunFactory, GukhanmunOptions, HanjaVariantSet, HomophoneDetection, HtmlOptions, NumeralStrategy, OriginalGloss, Preset, PunctuationPreset, Recovery, RenderMode, ResolvedPunctuationProfile, Segmentation, SpaceAfter, StopStyle, load };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gukhanmun/types",
-  "version": "0.3.0-dev.185",
+  "version": "0.3.0-dev.203",
   "description": "TypeScript API contract for Gukhanmun (type declarations only, no runtime code).",
   "type": "module",
   "exports": {