npm - georgian-hyphenation - Versions diffs - 2.2.2 → 2.2.4 - Mend

georgian-hyphenation 2.2.2 → 2.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -3,138 +3,396 @@
 [![NPM version](https://img.shields.io/npm/v/georgian-hyphenation.svg)](https://www.npmjs.com/package/georgian-hyphenation)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![JavaScript](https://img.shields.io/badge/javascript-ESM-yellow.svg)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
+[![Downloads](https://img.shields.io/npm/dm/georgian-hyphenation.svg)](https://www.npmjs.com/package/georgian-hyphenation)
-**Version 2.2.1** - Academic Logic with Automatic Sanitization & Dictionary Support
+**Version 2.2.4** - Browser + Node.js Compatible with Dictionary Support
-ქართული ენის სრული დამარცვლის ბიბლიოთეკა. ვერსია 2.2.1 მოიცავს ავტომატურ გასუფთავებას (Sanitization) და გამონაკლისების ლექსიკონის მხარდაჭერას.
+ქართული ენის სრული დამარცვლის ბიბლიოთეკა. ვერსია 2.2.4 სრულად თავსებადია როგორც Browser, ისე Node.js გარემოსთან.
 ---
-## ✨ New in v2.2.1
+## ✨ New in v2.2.4
-- 🧹 **Automatic Sanitization**: Automatically strips existing soft-hyphens or markers before processing to prevent "double-hyphenation" bugs.
-- 📚 **Dictionary Support**: Integrated exception handling for irregular words.
-- 🚀 **Performance Boost**: Harmonic cluster lookups optimized using `Set` (O(1) complexity).
-- 📦 **Modern ESM Support**: Native support for `import/export` syntax.
+- 🌐 **Full Browser Support**: CDN URL fixed for reliable dictionary loading in browsers
+- 📦 **NPM Package Files**: Added `data/` folder to published package
+- 🔧 **Improved Error Handling**: Better fallback when dictionary is unavailable
+- 📝 **Documentation**: Corrected examples (removed non-existent Georgian words)
 ---
-## 📦 Installation
+## ✨ Features from v2.2.2
+- 🧹 **Automatic Sanitization**: Strips existing soft-hyphens before processing to prevent double-hyphenation
+- 📚 **Dictionary Support**: 150+ exception words for edge cases
+- ⚡ **Performance Boost**: Harmonic cluster lookups optimized using `Set` (O(1) complexity)
+- 📦 **Modern ESM Support**: Native `import/export` syntax
+- 🎯 **Hybrid Engine**: Dictionary-first, Algorithm fallback
+---
+## 📦 Installation
 ```bash
 npm install georgian-hyphenation
 ```
 ---
-## 📖 Usage (Modern JavaScript / ESM)
+## 🚀 Quick Start
+### Browser (CDN)
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <style>
+    .hyphenated {
+      hyphens: manual;
+      -webkit-hyphens: manual;
+      text-align: justify;
+    }
+  </style>
+</head>
+<body>
+  <div class="hyphenated" id="content"></div>
+  <script type="module">
+    import GeorgianHyphenator from 'https://cdn.jsdelivr.net/npm/georgian-hyphenation@2.2.4/src/javascript/index.js';
+    async function initialize() {
+      const hyphenator = new GeorgianHyphenator('\u00AD'); // Soft hyphen
+      // Load dictionary (optional, but recommended)
+      await hyphenator.loadDefaultLibrary();
+      const text = "საქართველო არის ძალიან ლამაზი ქვეყანა, სადაც ბევრი ისტორიული ძეგლია.";
+      document.getElementById('content').textContent = hyphenator.hyphenateText(text);
+    }
+    initialize();
+  </script>
+</body>
+</html>
+```
-### Basic Usage
+---
+### Node.js (ESM)
 ```javascript
 import GeorgianHyphenator from 'georgian-hyphenation';
-const hyphenator = new GeorgianHyphenator('-'); // Use '-' for visible results
+const hyphenator = new GeorgianHyphenator('-'); // Visible hyphen
-// 1. Hyphenate a word
+// Hyphenate a word
 console.log(hyphenator.hyphenate('საქართველო'));
 // Output: "სა-ქარ-თვე-ლო"
-// 2. Automatic Sanitization (New!)
-// If the word already contains hyphens, it cleans them first
-const messyWord = 'სა-ქარ-თვე-ლო';
-console.log(hyphenator.hyphenate(messyWord));
-// Output: "სა-ქარ-თვე-ლო" (Correctly re-processed)
+// Load dictionary (optional)
+await hyphenator.loadDefaultLibrary();
+// Hyphenate text
+const text = "გამარჯობა, საქართველო მშვენიერი ქვეყანაა!";
+console.log(hyphenator.hyphenateText(text));
+// Output: "გა-მარ-ჯო-ბა, სა-ქარ-თვე-ლო მშვე-ნი-ე-რი ქვე-ყა-ნა-ა!"
 ```
-### Loading Exceptions Dictionary
+---
+### Node.js (CommonJS)
 ```javascript
-// Load the built-in dictionary of exceptions
-await hyphenator.loadDefaultLibrary();
+const GeorgianHyphenator = require('georgian-hyphenation');
-console.log(hyphenator.hyphenate('ობიექტი'));
+const hyphenator = new GeorgianHyphenator('-');
+console.log(hyphenator.hyphenate('საქართველო'));
+```
+---
+## 📖 API Reference
+### **Constructor**
+```javascript
+new GeorgianHyphenator(hyphenChar = '\u00AD')
 ```
-### Hyphenate Entire Text
+**Parameters:**
+- `hyphenChar` (string): Character to use for hyphenation
+  - `'\u00AD'` - Soft hyphen (invisible, default)
+  - `'-'` - Regular hyphen (visible)
+  - `'·'` - Middle dot
+  - Any custom character
+---
+### **Methods**
+#### `hyphenate(word)`
+Hyphenates a single Georgian word.
+**Features:**
+- Automatically strips existing hyphens (sanitization)
+- Checks dictionary first (if loaded)
+- Falls back to algorithm
 ```javascript
-const text = "გამარჯობა, საქართველო მშვენიერი ქვეყანაა!";
-console.log(hyphenator.hyphenateText(text));
+hyphenator.hyphenate('საქართველო'); // → "სა-ქარ-თვე-ლო"
+hyphenator.hyphenate('ბლოკი');       // → "ბლო-კი" (harmonic cluster)
+```
+---
+#### `hyphenateText(text)`
+Hyphenates entire text while preserving:
+- Punctuation
+- Numbers
+- Latin characters
+- Whitespace
+```javascript
+const text = "საქართველო არის ლამაზი ქვეყანა.";
+hyphenator.hyphenateText(text);
+// → "სა-ქარ-თვე-ლო არის ლა-მა-ზი ქვე-ყა-ნა."
 ```
 ---
-## 🧠 Algorithm Logic
+#### `getSyllables(word)`
+Returns syllables as an array.
+```javascript
+hyphenator.getSyllables('საქართველო');
+// → ['სა', 'ქარ', 'თვე', 'ლო']
+```
+---
+#### `loadDefaultLibrary()` (Async)
+Loads the default exception dictionary (150+ words).
+**Browser:** Fetches from CDN (`jsdelivr`)
+**Node.js:** Loads from local `data/exceptions.json`
+```javascript
+await hyphenator.loadDefaultLibrary();
+console.log('Dictionary loaded!');
+```
-The v2.2 algorithm continues to use **phonological distance analysis** combined with academic rules:
+---
-1. **V-V (Hiatus)**: Split between vowels → `გა-ა-ნა`
-2. **V-C-V**: Split before consonant → `მა-მა`
-3. **Harmonic Clusters**: Special Georgian clusters (ბრ, წვ, მს) stay together.
-4. **Anti-Orphan**: Minimum 2 characters on each side.
+#### `loadLibrary(data)`
+Load custom dictionary.
+```javascript
+hyphenator.loadLibrary({
+  'სპეციალური': 'სპე-ცი-ა-ლუ-რი',
+  'კომპიუტერი': 'კომ-პიუ-ტე-რი'
+});
+```
 ---
-## 🎨 API Reference
+## 🧠 Algorithm Logic
+The v2.2 algorithm uses **phonological distance analysis** with these rules:
+### 1. **Vowel Distance Analysis**
+```
+საქართველო → vowels at: [1, 3, 5, 7]
+```
+### 2. **Consonant Cluster Rules**
+- **V-V (0 consonants)**: Split between vowels
+```javascript
+  'გააკეთა' → 'გა-ა-კე-თა'
+```
-### `new GeorgianHyphenator(hyphenChar)`
+- **V-C-V (1 consonant)**: Split after first vowel
+```javascript
+  'მამა' → 'მა-მა'
+```
-* **hyphenChar** (string): Character for hyphenation. Default: `\u00AD` (soft-hyphen).
+- **V-CC-V (2+ consonants)**:
+  1. Check for double consonants (gemination) - rare in Georgian
+  2. Check for harmonic clusters (ბლ, გლ, კრ, etc.) - keep together
+  3. Default: split after first consonant
-### `.hyphenate(word)`
+### 3. **Harmonic Clusters (62 clusters)**
+These consonant pairs stay together:
+```
+ბლ, ბრ, ბღ, ბზ, გდ, გლ, გმ, გნ, გვ, გზ, გრ, დრ, თლ, თრ, თღ,
+კლ, კმ, კნ, კრ, კვ, მტ, პლ, პრ, ჟღ, რგ, რლ, რმ, სწ, სხ, ტკ,
+ტპ, ტრ, ფლ, ფრ, ფქ, ფშ, ქლ, ქნ, ქვ, ქრ, ღლ, ღრ, ყლ, ყრ, შთ,
+შპ, ჩქ, ჩრ, ცლ, ცნ, ცრ, ცვ, ძგ, ძვ, ძღ, წლ, წრ, წნ, წკ, ჭკ,
+ჭრ, ჭყ, ხლ, ხმ, ხნ, ხვ, ჯგ
+```
-Hyphenates a single word. Strips existing hyphens first.
+### 4. **Anti-Orphan Protection**
-### `.hyphenateText(text)`
+Minimum 2 characters on each side:
+```javascript
+'არა' → 'არა'    // Not split (would create 1-letter syllable)
+'არაა' → 'ა-რა-ა' // OK to split
+```
-Processes a full string, preserving punctuation and non-Georgian characters.
+---
-### `.loadDefaultLibrary()`
+## 🎨 Examples
-(Async) Fetches or imports the `exceptions.json` data.
+### Basic Words
+```javascript
+hyphenate('საქართველო')  // → სა-ქარ-თვე-ლო
+hyphenate('მთავრობა')     // → მთავ-რო-ბა
+hyphenate('დედაქალაქი')   // → დე-და-ქა-ლა-ქი
+hyphenate('პარლამენტი')   // → პარ-ლა-მენ-ტი
+```
+### Harmonic Clusters
+```javascript
+hyphenate('ბლოკი')        // → ბლო-კი  (ბლ stays together)
+hyphenate('კრემი')        // → კრე-მი  (კრ stays together)
+hyphenate('გლეხი')        // → გლე-ხი  (გლ stays together)
+hyphenate('პროგრამა')    // → პროგ-რა-მა (პრ and გრ preserved)
+```
+### V-V Split
+```javascript
+hyphenate('გააკეთა')      // → გა-ა-კე-თა
+hyphenate('გაიარა')       // → გა-ი-ა-რა
+hyphenate('გაანალიზა')    // → გა-ა-ნა-ლი-ზა
+```
+### Text Processing
+```javascript
+hyphenateText('საქართველო არის ლამაზი ქვეყანა')
+// → 'საქართველო არის ლამაზი ქვეყანა' (with soft hyphens)
+// Preserves punctuation
+hyphenateText('მთავრობა, პარლამენტი და სასამართლო.')
+// → 'მთავრობა, პარლამენტი და სასამართლო.'
+```
 ---
 ## 🧪 Testing
-We use a comprehensive test suite to ensure 98%+ accuracy.
+Run the test suite:
 ```bash
 npm test
+```
+Expected output:
+```
+✅ Test 1: საქართველო → სა-ქარ-თვე-ლო
+✅ Test 2: მთავრობა → მთავ-რო-ბა
+...
+📊 Test Results: 13 passed, 0 failed
+🎉 All tests passed!
+```
+---
+## 📊 Dictionary
+The library includes `data/exceptions.json` with 150+ Georgian words:
+```json
+{
+  "საქართველო": "სა-ქარ-თვე-ლო",
+  "კომპიუტერი": "კომ-პიუ-ტე-რი",
+  "პროგრამა": "პროგ-რა-მა",
+  "ინტერნეტი": "ინ-ტერ-ნე-ტი"
+}
 ```
 ---
 ## 📝 Changelog
-### Version 2.2.1 (Current)
+### Version 2.2.4 (2026-01-27)
+* 🌐 **Browser Fix**: Fixed CDN URL for reliable dictionary loading
+* 📦 **NPM Files**: Added `data/` folder to published package (`files` whitelist)
+* 🔧 **Error Handling**: Improved fallback when dictionary unavailable
+* 📝 **Documentation**: Corrected examples, removed non-existent words
+### Version 2.2.1 (2026-01-26)
+* 🧹 **Sanitization**: Added `_stripHyphens` for automatic input cleaning
+* ⚡ **Performance**: Converted `harmonicClusters` to `Set` (O(1) lookup)
+* 📦 **ESM**: Full ES Modules support
+* 📚 **Dictionary**: Added `loadDefaultLibrary()` method
+### Version 2.0.1 (2026-01-22)
+* 🎓 **Academic Rewrite**: Phonological distance analysis
+* 🛡️ **Anti-Orphan**: Minimum 2 characters on each side
+* 🎼 **Harmonic Clusters**: Georgian-specific consonant groups
+---
+## 🤝 Contributing
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Run tests: `npm test`
+4. Submit a Pull Request
-* Added `_stripHyphens` for input sanitization.
-* Converted `harmonicClusters` to `Set` for high-performance processing.
-* Switched to **ES Modules (ESM)** as default.
-* Added `loadDefaultLibrary` for browser/node dictionary fetching.
+---
-### Version 2.0.1
+## 🐛 Bug Reports
-* Academic logic rewrite.
-* Phonological distance analysis.
+Found a bug? [Open an issue](https://github.com/guramzhgamadze/georgian-hyphenation/issues)
 ---
 ## 📄 License
-MIT License - see [LICENSE.txt](https://www.google.com/search?q=LICENSE.txt) for details.
+MIT License
+Copyright (c) 2025 Guram Zhgamadze
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 ---
 ## 📧 Contact
-**Guram Zhgamadze** - guramzhgamadze@gmail.com
+**Guram Zhgamadze**
+- 🐙 GitHub: [@guramzhgamadze](https://github.com/guramzhgamadze)
+- 📧 Email: guramzhgamadze@gmail.com
+- 📦 NPM: [georgian-hyphenation](https://www.npmjs.com/package/georgian-hyphenation)
+---
+## 🔗 Links
+- **NPM Package:** https://www.npmjs.com/package/georgian-hyphenation
+- **GitHub Repository:** https://github.com/guramzhgamadze/georgian-hyphenation
+- **Demo:** https://guramzhgamadze.github.io/georgian-hyphenation/
+- **PyPI (Python):** https://pypi.org/project/georgian-hyphenation/
+---
+**Made with ❤️ for the Georgian language community**
-```
+🇬🇪 **ქართული ენის ციფრული განვითარებისთვის**

package/package.json CHANGED Viewed

@@ -1,48 +1,43 @@
 {
   "name": "georgian-hyphenation",
-  "version": "2.2.2",
-  "description": "Georgian Language Hyphenation Library v2.2.1 - Academic Logic with Sanitization & Dictionary Support",
-  "type": "module",
+  "version": "2.2.4",
+  "description": "Georgian Language Hyphenation Library - Browser + Node.js compatible",
   "main": "src/javascript/index.js",
-  "types": "src/javascript/index.d.ts",
+  "module": "src/javascript/index.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./src/javascript/index.js",
+      "require": "./src/javascript/index.js"
+    },
+    "./data/exceptions.json": "./data/exceptions.json"
+  },
   "files": [
-    "src/javascript",
-    "data/exceptions.json",
+    "src/javascript/",
+    "data/",
     "README.md",
-    "LICENSE.txt"
+    "LICENSE"
   ],
-  "exports": {
-    ".": "./src/javascript/index.js",
-    "./data/*": "./data/*"
-  },
   "scripts": {
-    "test": "node test-suite.js"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/guramzhgamadze/georgian-hyphenation.git"
+    "test": "node test_javascript.js"
   },
   "keywords": [
     "georgian",
-    "kartuli",
-    "ქართული",
     "hyphenation",
     "syllabification",
+    "kartuli",
     "nlp",
-    "natural-language-processing",
-    "linguistics",
-    "text-processing",
-    "i18n",
-    "localization",
-    "sanitization"
+    "browser",
+    "nodejs"
   ],
   "author": "Guram Zhgamadze <guramzhgamadze@gmail.com>",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/guramzhgamadze/georgian-hyphenation/issues"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/guramzhgamadze/georgian-hyphenation.git"
   },
   "homepage": "https://github.com/guramzhgamadze/georgian-hyphenation#readme",
-  "dependencies": {
-    "georgian-hyphenation": "^2.2.1"
+  "bugs": {
+    "url": "https://github.com/guramzhgamadze/georgian-hyphenation/issues"
   }
-}
+}

package/src/javascript/index.js CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
- * Georgian Hyphenation Library v2.2.1
- * Modernized & Optimized by GitHub Code Architect
+ * Georgian Hyphenation Library v2.2.4
+ * Browser + Node.js Compatible
  */
 export default class GeorgianHyphenator {
@@ -21,6 +21,7 @@ export default class GeorgianHyphenator {
     ]);
     this.dictionary = new Map();
+    this.dictionaryLoaded = false;
   }
   /**
@@ -28,12 +29,13 @@ export default class GeorgianHyphenator {
    */
   _stripHyphens(text) {
     if (!text) return '';
-    // Escape special regex characters
-    const escapedChar = this.hyphenChar.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    const regex = new RegExp(`[\u00AD${escapedChar}]`, 'g');
-    return text.replace(regex, '');
+    // Remove soft hyphens, regular hyphens, and custom hyphen char
+    return text.replace(/[\u00AD\-]/g, '').replace(new RegExp(this.hyphenChar, 'g'), '');
   }
+  /**
+   * ტვირთავს მომხმარებლის dictionary-ს
+   */
   loadLibrary(data) {
     if (data && typeof data === 'object') {
       Object.entries(data).forEach(([word, hyphenated]) => {
@@ -42,43 +44,65 @@ export default class GeorgianHyphenator {
     }
   }
+  /**
+   * ✅ ტვირთავს default dictionary-ს (Browser + Node.js compatible)
+   */
   async loadDefaultLibrary() {
-    // 1. Browser Environment
+    if (this.dictionaryLoaded) return;
+    // Browser Environment
     if (typeof window !== 'undefined' && typeof fetch !== 'undefined') {
       try {
-        const response = await fetch('https://unpkg.com/georgian-hyphenation@2/data/exceptions.json');
-        if (!response.ok) throw new Error("Network response error");
+        // ✅ სწორი CDN URL - jsdelivr უფრო სანდოა unpkg-ზე
+        const response = await fetch('https://cdn.jsdelivr.net/npm/georgian-hyphenation@2.2.4/data/exceptions.json');
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
         const data = await response.json();
         this.loadLibrary(data);
+        this.dictionaryLoaded = true;
+        console.log(`Georgian Hyphenation v2.2.4: Dictionary loaded (${this.dictionary.size} words)`);
       } catch (error) {
-        console.warn("Georgian Hyphenation: Using algorithm only (Fetch failed)");
+        console.warn('Georgian Hyphenation v2.2.4: Dictionary not available, using algorithm only');
+        console.warn('Error:', error.message);
       }
-    }
-    // 2. Node.js Environment (ESM context)
-    else if (typeof process !== 'undefined') {
+    }
+    // Node.js Environment (Dynamic Import)
+    else if (typeof process !== 'undefined' && typeof require !== 'undefined') {
       try {
-        // Node-ში ლოკალური ფაილის წაკითხვა
-        const { default: data } = await import('../../data/exceptions.json', {
-          assert: { type: 'json' }
-        });
+        // Try CommonJS require first
+        const data = require('../../data/exceptions.json');
         this.loadLibrary(data);
+        this.dictionaryLoaded = true;
+        console.log(`Georgian Hyphenation v2.2.4: Dictionary loaded (${this.dictionary.size} words)`);
       } catch (error) {
-        console.warn("Georgian Hyphenation: Local dictionary not found");
+        console.warn('Georgian Hyphenation v2.2.4: Local dictionary not found, using algorithm only');
       }
     }
   }
+  /**
+   * ამარცვლებს ერთ სიტყვას
+   */
   hyphenate(word) {
     const sanitizedWord = this._stripHyphens(word);
     const cleanWord = sanitizedWord.replace(/[.,/#!$%^&*;:{}=\-_`~()]/g, "");
+    // Dictionary check
     if (this.dictionary.has(cleanWord)) {
       return this.dictionary.get(cleanWord).replace(/-/g, this.hyphenChar);
     }
+    // Algorithm fallback
     return this.applyAlgorithm(sanitizedWord);
   }
+  /**
+   * ალგორითმის გამოყენება
+   */
   applyAlgorithm(word) {
     if (word.length < (this.leftMin + this.rightMin)) return word;
@@ -101,6 +125,7 @@ export default class GeorgianHyphenator {
       if (distance === 0 || distance === 1) {
         candidatePos = v1 + 1;
       } else {
+        // Gemination check
         let doubleConsonantIndex = -1;
         for (let j = 0; j < betweenSubstring.length - 1; j++) {
           if (betweenSubstring[j] === betweenSubstring[j + 1]) {
@@ -112,6 +137,7 @@ export default class GeorgianHyphenator {
         if (doubleConsonantIndex !== -1) {
           candidatePos = v1 + 1 + doubleConsonantIndex + 1;
         } else {
+          // Harmonic cluster check
           let breakIndex = -1;
           if (distance >= 2) {
             const lastTwo = betweenSubstring.substring(distance - 2, distance);
@@ -123,6 +149,7 @@ export default class GeorgianHyphenator {
         }
       }
+      // Anti-orphan protection
       if (candidatePos >= this.leftMin && (word.length - candidatePos) >= this.rightMin) {
         insertPoints.push(candidatePos);
       }
@@ -135,10 +162,16 @@ export default class GeorgianHyphenator {
     return result.join('');
   }
+  /**
+   * მარცვლების მიღება მასივის სახით
+   */
   getSyllables(word) {
     return this.hyphenate(word).split(this.hyphenChar);
   }
+  /**
+   * მთელი ტექსტის დამარცვლა
+   */
   hyphenateText(text) {
     if (!text) return '';
     const sanitizedText = this._stripHyphens(text);
@@ -153,15 +186,20 @@ export default class GeorgianHyphenator {
   }
 }
-/** * კროს-პლატფორმული მხარდაჭერა
+/**
+ * ✅ კროს-პლატფორმული Export
  */
-// 1. ბრაუზერისთვის (Global Object)
+// 1. ES Module (Modern)
+// export default GeorgianHyphenator; (already at top)
+// 2. Browser Global (for <script> tag without type="module")
 if (typeof window !== 'undefined') {
   window.GeorgianHyphenator = GeorgianHyphenator;
 }
-// 2. Node.js (CommonJS) - იმ შემთხვევაში თუ ვინმე მაინც require-ს გამოიყენებს
-// (მხოლოდ თუ module.exports არსებობს)
+// 3. Node.js CommonJS (for require())
 if (typeof module !== 'undefined' && module.exports) {
   module.exports = GeorgianHyphenator;
+  module.exports.default = GeorgianHyphenator;
 }