#Directives

interface Directives {
  
Directives.requireHanja?: string[] | undefinedrequireHanja?:    string[];  // always show hanja in output
  
Directives.requireHangul?: string[] | undefinedrequireHangul?:   string[];  // always show hangul reading (for "original" mode)
  
Directives.skipAnnotation?: string[] | undefinedskipAnnotation?:  string[];  // suppress annotation entirely
}

import { 
function load(options?: GukhanmunOptions): Promise<Gukhanmun>
Creates a Gukhanmun converter with the given options.
Initialises the WASM module on the first call (subsequent calls reuse the
cached module).  Dictionaries supplied via
 
GukhanmunOptions.dictionaries
  are fetched and passed to the Rust
engine as FileDictionarySource values.
Note: unlike the Rust ko-kr preset, the JavaScript preset never includes a
bundled dictionary.  Pass dictionaries: [await stdictFst()] to include the
Standard Korean Language Dictionary.
@paramoptions  - Conversion options.  All fields are optional; defaults match
the ko-kr preset.@returnsA  Gukhanmun instance.@throws{@linkGukhanmunError } on invalid options or dictionary load failure.load } from "@gukhanmun/wasm";
import { 
function stdictFst(): Promise<FileDictionarySource>
Loads the bundled Standard Korean Language Dictionary as a
FileDictionarySource
ready to pass to load({ dictionaries: [...] }).
@returnsA  FileDictionarySource with format: "fst".stdictFst } from "@gukhanmun/stdict-fst";

const 
const g: Gukhanmung = await 
function load(options?: GukhanmunOptions): Promise<Gukhanmun>
Creates a Gukhanmun converter with the given options.
Initialises the WASM module on the first call (subsequent calls reuse the
cached module).  Dictionaries supplied via
 
GukhanmunOptions.dictionaries
  are fetched and passed to the Rust
engine as FileDictionarySource values.
Note: unlike the Rust ko-kr preset, the JavaScript preset never includes a
bundled dictionary.  Pass dictionaries: [await stdictFst()] to include the
Standard Korean Language Dictionary.
@paramoptions  - Conversion options.  All fields are optional; defaults match
the ko-kr preset.@returnsA  Gukhanmun instance.@throws{@linkGukhanmunError } on invalid options or dictionary load failure.load({
  
GukhanmunOptions.dictionaries?: readonly FileDictionarySource[] | undefined
Ordered list of dictionary sources.  Sources are queried in order;
earlier entries take precedence.  When omitted (or empty), only the
fallback Unihan character map is used (no stdict).
Unlike the "ko-kr" Rust preset, JavaScript presets do not
automatically include a bundled dictionary.  To use the Standard Korean
Language Dictionary, add @gukhanmun/stdict-fst or
@gukhanmun/stdict-cdb explicitly.
@seeDictionarySourcedictionaries: [await 
function stdictFst(): Promise<FileDictionarySource>
Loads the bundled Standard Korean Language Dictionary as a
FileDictionarySource
ready to pass to load({ dictionaries: [...] }).
@returnsA  FileDictionarySource with format: "fst".stdictFst()],
  
GukhanmunOptions.directives?: Directives | undefined
Per-hanja rendering directives that override dictionary marks.
@seeDirectivesdirectives: {
    
Directives.requireHanja?: readonly string[] | undefined
Hanja forms that must always be shown with their original hanja
alongside the hangul reading, as if requireHanja were set in the
dictionary.requireHanja:   ["漢", "字"],
    
Directives.requireHangul?: readonly string[] | undefined
Hanja forms that must always be shown with a hangul gloss alongside the
original hanja (relevant for rendering: "original").requireHangul:  ["東"],
    
Directives.skipAnnotation?: readonly string[] | undefined
Hanja forms whose annotation should be suppressed entirely; the renderer
emits only the primary plain text form (hangul or hanja depending on
rendering).skipAnnotation: ["中"],
  },
});