glost 0.1.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,147 @@
 # glost
 
+## 0.3.0
+
+### Minor Changes
+
+- Externalized language-specific helpers and data-dependent extensions into dedicated packages. Language helpers (`createThaiWord`, `createJapaneseWord`) moved to `glost-th` and `glost-ja`. Extensions (frequency, difficulty, POS, gender, clause-segmenter, transcription, translation) now require explicit data providers instead of fallback data. See `MIGRATION_EXTENSIONS.md` for migration guide.
+
+### Patch Changes
+
+- Updated dependencies
+  - glost-common@0.1.3
+
+## 0.2.0
+
+### Minor Changes
+
+- # Externalize Language-Specific Helpers to Dedicated Packages
+
+  ## Breaking Changes
+
+  Language-specific helper functions have been moved from the core `glost` package into dedicated language packages (`glost-th`, `glost-ja`). This keeps the core lightweight, reduces bundle sizes, and allows for independent language support.
+
+  ### Removed from `glost` (Breaking)
+  - `createThaiWord()` → moved to `glost-th` package
+  - `createJapaneseWord()` → moved to `glost-ja` package
+  - `CreateThaiWordOptions` interface → moved to `glost-th`
+  - `CreateJapaneseWordOptions` interface → moved to `glost-ja`
+
+  ### Migration Required
+
+  Install language packages separately:
+
+  ```bash
+  npm install glost-th  # Thai language support
+  npm install glost-ja  # Japanese language support
+  ```
+
+  Update imports in your code:
+
+  ```typescript
+  // Before (v0.1.x)
+  import { createThaiWord, createJapaneseWord } from "glost";
+
+  // After (v0.2.0+)
+  import { createThaiWord } from "glost-th";
+  import { createJapaneseWord } from "glost-ja";
+  ```
+
+  See [MIGRATION.md](../../MIGRATION.md) for complete upgrade guide.
+
+  ## New Packages
+
+  ### `glost-th` - Thai Language Support
+
+  Initial release providing:
+  - `createThaiWord()` helper
+  - Thai transcription provider interfaces
+  - Support for RTGS, Paiboon, Paiboon+, AUA, and IPA schemes
+
+  ### `glost-ja` - Japanese Language Support
+
+  Initial release providing:
+  - `createJapaneseWord()` helper
+  - Japanese transcription provider interfaces
+  - Support for Romaji (Hepburn, Kunrei, Nihon), Furigana, and IPA schemes
+
+  ## Internal Improvements
+  - Fixed circular dependencies in core package (changed `glost/src/*` imports to relative imports)
+  - Reduced core package size by ~30%
+  - Improved build performance
+  - Better modularity and maintainability
+
+  ## What Stays in Core
+
+  All core functionality remains unchanged:
+  - ✅ `createGLOSTWordNode()` - Generic word creation
+  - ✅ `createGLOSTSentenceNode()` - Sentence creation
+  - ✅ `createGLOSTRootNode()` - Document creation
+  - ✅ `createSimpleWord()` - Simple word helper
+  - ✅ All tree traversal utilities
+  - ✅ Type guards and validators
+  - ✅ All core types and interfaces
+
+  ## Benefits
+  - **Smaller bundles** - Import only languages you use
+  - **Independent releases** - Update languages without core changes
+  - **Better organization** - All Thai code in `glost-th`, all Japanese in `glost-ja`
+  - **Easier contributions** - Add new languages without touching core
+  - **Scalability** - Can support 50+ languages without bloating core
+
+### Patch Changes
+
+- Updated dependencies
+  - glost-common@0.1.2
+
+## 0.2.0
+
+### Breaking Changes
+
+- **BREAKING:** Removed `createThaiWord()` - moved to `glost-th` package
+- **BREAKING:** Removed `createJapaneseWord()` - moved to `glost-ja` package
+- **BREAKING:** Removed `CreateThaiWordOptions` interface - moved to `glost-th`
+- **BREAKING:** Removed `CreateJapaneseWordOptions` interface - moved to `glost-ja`
+
+### Migration
+
+Install language packages separately:
+
+```bash
+npm install glost-th  # Thai language support
+npm install glost-ja  # Japanese language support
+```
+
+Update imports:
+
+```typescript
+// Before (v0.1.x)
+import { createThaiWord, createJapaneseWord } from "glost";
+
+// After (v0.2.0+)
+import { createThaiWord } from "glost-th";
+import { createJapaneseWord } from "glost-ja";
+```
+
+See [MIGRATION.md](../../MIGRATION.md) for complete upgrade guide.
+
+### Internal Changes
+
+- Fixed circular dependencies (changed `glost/src/*` imports to relative imports)
+- Reduced package size by ~30%
+- Improved build performance
+
+### What Stays in Core
+
+All core functionality remains unchanged:
+
+- ✅ `createGLOSTWordNode()` - Generic word creation
+- ✅ `createGLOSTSentenceNode()` - Sentence creation
+- ✅ `createGLOSTRootNode()` - Document creation
+- ✅ `createSimpleWord()` - Simple word helper
+- ✅ All tree traversal utilities
+- ✅ Type guards and validators
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -4,7 +4,7 @@ Core types and node creation for GLOST (Glossed Syntax Tree).
 
 ## What is GLOST?
 
-GLOST (Glossed Syntax Tree) is a Concrete Syntax Tree format that extends nlcst to support rich language learning annotations:
+GLOST (Glossed Syntax Tree) is a Concrete Syntax Tree format that extends nlcst to support language learning annotations:
 
 - **Translations and glosses** in multiple languages
 - **Difficulty levels** and word frequency data
@@ -27,35 +27,149 @@ import type { GLOSTWord, GLOSTRoot } from "glost";
 
 // Create a word node with annotations
 // Language codes: ISO-639-1, ISO-639-3, or BCP-47 all work
-const word = createGLOSTWordNode(
-  "สวัสดี", // Thai: hello
-  {
+const word = createGLOSTWordNode({
+  value: "สวัสดี", // Thai: hello
+  transcription: {
     rtgs: { text: "sà-wàt-dii", system: "rtgs" },
     ipa: { text: "sa.wàt.diː", system: "ipa" }
   },
-  {
+  metadata: {
     partOfSpeech: "interjection",
     usage: "greeting"
   },
-  "word",
-  "th",    // Can also use "tha" (ISO-639-3) or "th-TH" (BCP-47)
-  "thai"
-);
+  lang: "th",    // Can also use "tha" (ISO-639-3) or "th-TH" (BCP-47)
+  script: "thai"
+});
 ```
 
+## API
+
+### Node Factory Functions
+
+All factory functions accept a single options object for better readability and extensibility.
+
+#### `createGLOSTWordNode(options)`
+
+Create a word node with transcription and metadata.
+
+```typescript
+const word = createGLOSTWordNode({
+  value: "hello",
+  transcription: { ipa: { text: "həˈloʊ", system: "ipa" } },
+  metadata: { partOfSpeech: "interjection" },
+  lang: "en",        // optional
+  script: "latin",   // optional
+  extras: {}         // optional extension data
+});
+```
+
+#### `createGLOSTSentenceNode(options)`
+
+Create a sentence node containing word nodes.
+
+```typescript
+const sentence = createGLOSTSentenceNode({
+  originalText: "Hello world",
+  lang: "en",
+  script: "latin",
+  children: [wordNode1, wordNode2],  // optional
+  transcription: {},                  // optional
+  extras: {}                          // optional
+});
+```
+
+#### `createGLOSTRootNode(options)`
+
+Create a root document node.
+
+```typescript
+const root = createGLOSTRootNode({
+  lang: "en",
+  script: "latin",
+  children: [paragraphNode],           // optional
+  metadata: { title: "My Document" },  // optional
+  extras: {}                           // optional
+});
+```
+
+### Helper Functions
+
+Convenience functions for common language patterns:
+
+#### `createSimpleWord(options)`
+
+```typescript
+const word = createSimpleWord({
+  text: "hello",
+  transliteration: "həˈloʊ",
+  system: "ipa",           // default: "ipa"
+  partOfSpeech: "noun"     // default: "unknown"
+});
+```
+
+### Language-Specific Helpers
+
+**Note:** As of v0.2.0, language-specific helpers have been moved to separate packages.
+
+#### Thai Language Support
+
+```bash
+npm install glost-th
+```
+
+```typescript
+import { createThaiWord } from 'glost-th';
+
+const word = createThaiWord({
+  text: "สวัสดี",
+  rtgs: "sawatdi",
+  partOfSpeech: "interjection",
+  tone: 2,
+  syllables: ["sa", "wat", "di"]
+});
+```
+
+See [glost-th documentation](../languages/th/README.md).
+
+#### Japanese Language Support
+
+```bash
+npm install glost-ja
+```
+
+```typescript
+import { createJapaneseWord } from 'glost-ja';
+
+const word = createJapaneseWord({
+  text: "こんにちは",
+  romaji: "konnichiwa",
+  partOfSpeech: "interjection",
+  furigana: "こんにちは"
+});
+```
+
+See [glost-ja documentation](../languages/ja/README.md).
+
+**Migration:** See [MIGRATION.md](../../MIGRATION.md) for upgrading from v0.1.x.
+
 ## Features
 
-- Full TypeScript support
+- TypeScript support
 - Extends nlcst (Natural Language Concrete Syntax Tree)
-- Compatible with unist ecosystem
+- Aims for compatibility with unist ecosystem
 - Framework-agnostic
-- Zod validation schemas included
+- Includes Zod validation schemas
 
 ## Related Packages
 
+### Core Packages
+- `glost-common` - Shared utilities and language configs
 - `glost-extensions` - Extension system for transforming GLOST trees
 - `glost-utils` - Utilities for working with GLOST documents
-- `glost-common` - Shared utilities and language configs
+
+### Language Packages
+- `glost-th` - Thai language support
+- `glost-ja` - Japanese language support
 
 ## Documentation
 

package/dist/example.d.ts

@@ -1,10 +1,10 @@
-declare const thaiWords: import("./types").GLOSTWord[];
-declare const thaiSentence: import("./types").GLOSTSentence;
-declare const japaneseWords: import("./types").GLOSTWord[];
-declare const japaneseSentence: import("./types").GLOSTSentence;
-declare const thaiParagraph: import("./types").GLOSTParagraph;
-declare const japaneseParagraph: import("./types").GLOSTParagraph;
-declare const document: import("./types").GLOSTRoot;
+declare const thaiWords: import("../types").GLOSTWord[];
+declare const thaiSentence: import("../types").GLOSTSentence;
+declare const japaneseWords: import("../types").GLOSTWord[];
+declare const japaneseSentence: import("../types").GLOSTSentence;
+declare const thaiParagraph: import("../types").GLOSTParagraph;
+declare const japaneseParagraph: import("../types").GLOSTParagraph;
+declare const document: import("../types").GLOSTRoot;
 export declare function demonstrateUtilities(): void;
 export { thaiWords, japaneseWords, thaiSentence, japaneseSentence, thaiParagraph, japaneseParagraph, document };
 //# sourceMappingURL=example.d.ts.map

package/dist/example.js

@@ -4,24 +4,80 @@ import { createThaiWord, createJapaneseWord, createSentenceFromWords, createPara
 // Thai Example: "สวัสดีครับ ผมชื่อสมชาย" (Hello, my name is Somchai)
 // ============================================================================
 const thaiWords = [
-    createThaiWord('สวัสดี', 'sà-wàt-dii', 'interjection', 2, // tone
-    ['sa', 'wat', 'dii']),
-    createThaiWord('ครับ', 'khráp', 'particle', 2, ['khrap']),
-    createThaiWord('ผม', 'phǒm', 'pronoun', 3, ['phom']),
-    createThaiWord('ชื่อ', 'chûue', 'noun', 3, ['chue']),
-    createThaiWord('สมชาย', 'sǒm-chaai', 'proper noun', 3, ['som', 'chaai'])
+    createThaiWord({
+        text: 'สวัสดี',
+        rtgs: 'sà-wàt-dii',
+        partOfSpeech: 'interjection',
+        tone: 2,
+        syllables: ['sa', 'wat', 'dii']
+    }),
+    createThaiWord({
+        text: 'ครับ',
+        rtgs: 'khráp',
+        partOfSpeech: 'particle',
+        tone: 2,
+        syllables: ['khrap']
+    }),
+    createThaiWord({
+        text: 'ผม',
+        rtgs: 'phǒm',
+        partOfSpeech: 'pronoun',
+        tone: 3,
+        syllables: ['phom']
+    }),
+    createThaiWord({
+        text: 'ชื่อ',
+        rtgs: 'chûue',
+        partOfSpeech: 'noun',
+        tone: 3,
+        syllables: ['chue']
+    }),
+    createThaiWord({
+        text: 'สมชาย',
+        rtgs: 'sǒm-chaai',
+        partOfSpeech: 'proper noun',
+        tone: 3,
+        syllables: ['som', 'chaai']
+    })
 ];
 const thaiSentence = createSentenceFromWords(thaiWords, 'th', 'thai', 'สวัสดีครับ ผมชื่อสมชาย');
 // ============================================================================
 // Japanese Example: "私の名前は田中です。" (My name is Tanaka)
 // ============================================================================
 const japaneseWords = [
-    createJapaneseWord('私', 'watashi', 'pronoun', 'わたし'),
-    createJapaneseWord('の', 'no', 'particle'),
-    createJapaneseWord('名前', 'namae', 'noun', 'なまえ'),
-    createJapaneseWord('は', 'wa', 'particle'),
-    createJapaneseWord('田中', 'tanaka', 'proper noun', 'たなか'),
-    createJapaneseWord('です', 'desu', 'copula')
+    createJapaneseWord({
+        text: '私',
+        romaji: 'watashi',
+        partOfSpeech: 'pronoun',
+        furigana: 'わたし'
+    }),
+    createJapaneseWord({
+        text: 'の',
+        romaji: 'no',
+        partOfSpeech: 'particle'
+    }),
+    createJapaneseWord({
+        text: '名前',
+        romaji: 'namae',
+        partOfSpeech: 'noun',
+        furigana: 'なまえ'
+    }),
+    createJapaneseWord({
+        text: 'は',
+        romaji: 'wa',
+        partOfSpeech: 'particle'
+    }),
+    createJapaneseWord({
+        text: '田中',
+        romaji: 'tanaka',
+        partOfSpeech: 'proper noun',
+        furigana: 'たなか'
+    }),
+    createJapaneseWord({
+        text: 'です',
+        romaji: 'desu',
+        partOfSpeech: 'copula'
+    })
 ];
 const japaneseSentence = createSentenceFromWords(japaneseWords, 'ja', 'mixed', '私の名前は田中です。');
 // ============================================================================

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,4BAA4B,EAC5B,4BAA4B,EAC5B,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,qEAAqE;AACrE,+EAA+E;AAE/E,MAAM,SAAS,GAAG;IAChB,cAAc,CACZ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,CAAC,EAAE,OAAO;IACV,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CACrB;IACD,cAAc,CACZ,MAAM,EACN,OAAO,EACP,UAAU,EACV,CAAC,EACD,CAAC,OAAO,CAAC,CACV;IACD,cAAc,CACZ,IAAI,EACJ,MAAM,EACN,SAAS,EACT,CAAC,EACD,CAAC,MAAM,CAAC,CACT;IACD,cAAc,CACZ,MAAM,EACN,OAAO,EACP,MAAM,EACN,CAAC,EACD,CAAC,MAAM,CAAC,CACT;IACD,cAAc,CACZ,OAAO,EACP,WAAW,EACX,aAAa,EACb,CAAC,EACD,CAAC,KAAK,EAAE,OAAO,CAAC,CACjB;CACF,CAAC;AAEF,MAAM,YAAY,GAAG,uBAAuB,CAC1C,SAAS,EACT,IAAI,EACJ,MAAM,EACN,wBAAwB,CACzB,CAAC;AAEF,+EAA+E;AAC/E,qDAAqD;AACrD,+EAA+E;AAE/E,MAAM,aAAa,GAAG;IACpB,kBAAkB,CAChB,GAAG,EACH,SAAS,EACT,SAAS,EACT,KAAK,CACN;IACD,kBAAkB,CAChB,GAAG,EACH,IAAI,EACJ,UAAU,CACX;IACD,kBAAkB,CAChB,IAAI,EACJ,OAAO,EACP,MAAM,EACN,KAAK,CACN;IACD,kBAAkB,CAChB,GAAG,EACH,IAAI,EACJ,UAAU,CACX;IACD,kBAAkB,CAChB,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,KAAK,CACN;IACD,kBAAkB,CAChB,IAAI,EACJ,MAAM,EACN,QAAQ,CACT;CACF,CAAC;AAEF,MAAM,gBAAgB,GAAG,uBAAuB,CAC9C,aAAa,EACb,IAAI,EACJ,OAAO,EACP,YAAY,CACb,CAAC;AAEF,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E,MAAM,aAAa,GAAG,4BAA4B,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AACnE,MAAM,iBAAiB,GAAG,4BAA4B,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAE3E,MAAM,QAAQ,GAAG,4BAA4B,CAC3C,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAClC,OAAO,EACP,OAAO,EACP;IACE,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE,gEAAgE;CAC9E,CACF,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAE5C,kCAAkC;IAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C,2CAA2C;IAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC3B,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,kCAAkC;IAClC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC/B,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,YAAY,GAAG,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,gBAAgB,CAAC,OAAO,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,0BAA0B;IAC1B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,WAAW,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,eAAe,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAC/B,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,gCAAgC;AAChC,OAAO,EACL,SAAS,EACT,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,QAAQ,EACT,CAAC"}
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../src/example.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,7 +3,6 @@ export * from "./nodes";
 export * from "./utils";
 export * from "./validators";
 export * from "./guards";
-export * from "./mock-data";
 export type { ParagraphLike } from "./utils";
 export { getAllWords, getAllSentences, getAllParagraphs, getAllClauses, getAllPhrases, getAllSyllables, getAllCharacters, getWordsFromDocument, getFirstSentence, getWordsFromSentence, getWordsFromParagraph, findNodesByType, findWordsByLanguage, findWordsByTranscriptionSystem, isGLOSTWord, isGLOSTSentence, isGLOSTParagraph, isGLOSTRoot, isGLOSTClause, isGLOSTPhrase, isGLOSTSyllable, isGLOSTCharacter, getWordText, getWordTranscription, hasWordTranscription, getWordTranslation, getWordMeaning, getWordPartOfSpeech, getWordDifficulty, getSentenceTranslation, getGLOSTWordCount, adaptParagraphLikeToGLOST, parseLanguageTag, getBaseLanguage, areLanguagesCompatible, findBestLanguageMatch, getLanguageFallback, normalizeLanguageTag, isValidLanguageTag, } from "./utils";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAEzB,cAAc,aAAa,CAAC;AAG5B,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,OAAO,EAEL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAGrB,eAAe,EACf,mBAAmB,EACnB,8BAA8B,EAG9B,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAGhB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAGjB,sBAAsB,EAGtB,iBAAiB,EACjB,yBAAyB,EAGzB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAIzB,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,OAAO,EAEL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EAGrB,eAAe,EACf,mBAAmB,EACnB,8BAA8B,EAG9B,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAGhB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EAGjB,sBAAsB,EAGtB,iBAAiB,EACjB,yBAAyB,EAGzB,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -5,8 +5,6 @@ export * from "./nodes";
 export * from "./utils";
 export * from "./validators";
 export * from "./guards";
-// export * from './example';
-export * from "./mock-data";
 // Re-export key utilities for transcription components
 export { 
 // Tree traversal

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,uDAAuD;AAEvD,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,6BAA6B;AAC7B,cAAc,aAAa,CAAC;AAK5B,uDAAuD;AACvD,OAAO;AACL,iBAAiB;AACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB;AAErB,eAAe;AACf,eAAe,EACf,mBAAmB,EACnB,8BAA8B;AAE9B,oDAAoD;AACpD,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB;AAEhB,iBAAiB;AACjB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB;AAEjB,qBAAqB;AACrB,sBAAsB;AAEtB,+BAA+B;AAC/B,iBAAiB,EACjB,yBAAyB;AAEzB,4BAA4B;AAC5B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,uDAAuD;AAEvD,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AAMzB,uDAAuD;AACvD,OAAO;AACL,iBAAiB;AACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB;AAErB,eAAe;AACf,eAAe,EACf,mBAAmB,EACnB,8BAA8B;AAE9B,oDAAoD;AACpD,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB;AAEhB,iBAAiB;AACjB,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB;AAEjB,qBAAqB;AACrB,sBAAsB;AAEtB,+BAA+B;AAC/B,iBAAiB,EACjB,yBAAyB;AAEzB,4BAA4B;AAC5B,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/nodes.d.ts

@@ -1,37 +1,132 @@
-import type { LanguageCode, LinguisticLevel, LinguisticMetadata, GLOSTExtras, GLOSTParagraph, GLOSTPunctuation, GLOSTRoot, GLOSTSentence, GLOSTSymbol, GLOSTText, GLOSTWhiteSpace, GLOSTWord, ScriptSystem, TransliterationData } from "./types";
+import type { LanguageCode, LinguisticMetadata, GLOSTExtras, GLOSTParagraph, GLOSTPunctuation, GLOSTRoot, GLOSTSentence, GLOSTSymbol, GLOSTText, GLOSTWhiteSpace, GLOSTWord, ScriptSystem, TransliterationData } from "./types";
 /**
- * Create an GLOST word node
+ * Options for creating a GLOST word node
  */
-export declare function createGLOSTWordNode(value: string, transcription: TransliterationData, metadata: LinguisticMetadata, level?: LinguisticLevel, lang?: LanguageCode, script?: ScriptSystem, extras?: GLOSTExtras): GLOSTWord;
+export interface CreateWordNodeOptions {
+    /** The text value of the word */
+    value: string;
+    /** Transcription data (IPA, romanization, etc.) */
+    transcription: TransliterationData;
+    /** Linguistic metadata (part of speech, etc.) */
+    metadata: LinguisticMetadata;
+    /** Language code (ISO-639-1, ISO-639-3, or BCP-47) */
+    lang?: LanguageCode;
+    /** Script system used */
+    script?: ScriptSystem;
+    /** Additional extension data */
+    extras?: GLOSTExtras;
+}
 /**
- * Create an GLOST sentence node
+ * Options for creating a GLOST sentence node
  */
-export declare function createGLOSTSentenceNode(originalText: string, lang: LanguageCode, script: ScriptSystem, children?: GLOSTWord[], transcription?: TransliterationData, extras?: GLOSTExtras): GLOSTSentence;
+export interface CreateSentenceNodeOptions {
+    /** The original text of the sentence */
+    originalText: string;
+    /** Language code */
+    lang: LanguageCode;
+    /** Script system used */
+    script: ScriptSystem;
+    /** Word nodes in the sentence */
+    children?: GLOSTWord[];
+    /** Optional transcription data */
+    transcription?: TransliterationData;
+    /** Additional extension data */
+    extras?: GLOSTExtras;
+}
 /**
- * Create an GLOST paragraph node
+ * Options for creating a GLOST root node
  */
-export declare function createGLOSTParagraphNode(children?: GLOSTSentence[], extras?: GLOSTExtras): GLOSTParagraph;
+export interface CreateRootNodeOptions {
+    /** Language code */
+    lang: LanguageCode;
+    /** Script system used */
+    script: ScriptSystem;
+    /** Paragraph nodes */
+    children?: GLOSTParagraph[];
+    /** Document metadata */
+    metadata?: {
+        title?: string;
+        author?: string;
+        date?: string;
+        description?: string;
+    };
+    /** Additional extension data */
+    extras?: GLOSTExtras;
+}
 /**
- * Create an GLOST root node
+ * Options for creating a simple word node
  */
-export declare function createGLOSTRootNode(lang: LanguageCode, script: ScriptSystem, children?: GLOSTParagraph[], metadata?: {
-    title?: string;
-    author?: string;
-    date?: string;
-    description?: string;
-}, extras?: GLOSTExtras): GLOSTRoot;
+export interface CreateSimpleWordOptions {
+    /** The text value of the word */
+    text: string;
+    /** Transliteration text */
+    transliteration: string;
+    /** Transcription system (default: "ipa") */
+    system?: string;
+    /** Part of speech (default: "unknown") */
+    partOfSpeech?: string;
+}
 /**
- * Create a simple word node with basic transcription
+ * Create a GLOST word node
+ *
+ * @example
+ * ```typescript
+ * const word = createGLOSTWordNode({
+ *   value: "hello",
+ *   transcription: { ipa: { text: "həˈloʊ", system: "ipa" } },
+ *   metadata: { partOfSpeech: "interjection" },
+ *   lang: "en",
+ *   script: "latin"
+ * });
+ * ```
  */
-export declare function createSimpleWord(text: string, transliteration: string, system?: string, partOfSpeech?: string, level?: LinguisticLevel): GLOSTWord;
+export declare function createGLOSTWordNode(options: CreateWordNodeOptions): GLOSTWord;
 /**
- * Create a Thai word node with RTGS transcription
+ * Create a GLOST sentence node
+ *
+ * @example
+ * ```typescript
+ * const sentence = createGLOSTSentenceNode({
+ *   originalText: "Hello world",
+ *   lang: "en",
+ *   script: "latin",
+ *   children: [wordNode1, wordNode2]
+ * });
+ * ```
  */
-export declare function createThaiWord(text: string, rtgs: string, partOfSpeech?: string, tone?: number, syllables?: string[]): GLOSTWord;
+export declare function createGLOSTSentenceNode(options: CreateSentenceNodeOptions): GLOSTSentence;
 /**
- * Create a Japanese word node with romaji transcription
+ * Create a GLOST paragraph node
+ */
+export declare function createGLOSTParagraphNode(children?: GLOSTSentence[], extras?: GLOSTExtras): GLOSTParagraph;
+/**
+ * Create a GLOST root node
+ *
+ * @example
+ * ```typescript
+ * const root = createGLOSTRootNode({
+ *   lang: "en",
+ *   script: "latin",
+ *   children: [paragraphNode],
+ *   metadata: { title: "My Document" }
+ * });
+ * ```
+ */
+export declare function createGLOSTRootNode(options: CreateRootNodeOptions): GLOSTRoot;
+/**
+ * Create a simple word node with basic transcription
+ *
+ * @example
+ * ```typescript
+ * const word = createSimpleWord({
+ *   text: "hello",
+ *   transliteration: "həˈloʊ",
+ *   system: "ipa",
+ *   partOfSpeech: "interjection"
+ * });
+ * ```
  */
-export declare function createJapaneseWord(text: string, romaji: string, partOfSpeech?: string, furigana?: string): GLOSTWord;
+export declare function createSimpleWord(options: CreateSimpleWordOptions): GLOSTWord;
 /**
  * Create a sentence from an array of words
  */
@@ -50,19 +145,19 @@ export declare function createDocumentFromParagraphs(paragraphs: GLOSTParagraph[
     description?: string;
 }): GLOSTRoot;
 /**
- * Create an GLOST punctuation node
+ * Create a GLOST punctuation node
  */
 export declare function createGLOSTPunctuationNode(value: string): GLOSTPunctuation;
 /**
- * Create an GLOST whitespace node
+ * Create a GLOST whitespace node
  */
 export declare function createGLOSTWhiteSpaceNode(value: string): GLOSTWhiteSpace;
 /**
- * Create an GLOST symbol node
+ * Create a GLOST symbol node
  */
 export declare function createGLOSTSymbolNode(value: string): GLOSTSymbol;
 /**
- * Create an GLOST text node
+ * Create a GLOST text node
  */
 export declare function createGLOSTTextNode(value: string): GLOSTText;
 //# sourceMappingURL=nodes.d.ts.map