georgian-hyphenation 2.2.3 → 2.2.4

package/README.md

@@ -1,284 +1,398 @@
-# Georgian Language Hyphenation / ქართული ენის დამარცვლა
+# Georgian Language Hyphenation
 
-**Version 2.2.2** (Library) / **2.0.8** (WordPress Plugin)
+[![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)
 
-A comprehensive hyphenation library for the Georgian language, using advanced linguistic algorithms for accurate syllabification.
+**Version 2.2.4** - Browser + Node.js Compatible with Dictionary Support
 
-ქართული ენის სრული დამარცვლის ბიბლიოთეკა, რომელიც იყენებს თანამედროვე ლინგვისტურ ალგორითმებს ზუსტი მარცვლების გამოყოფისთვის.
+ქართული ენის სრული დამარცვლის ბიბლიოთეკა. ვერსია 2.2.4 სრულად თავსებადია როგორც Browser, ისე Node.js გარემოსთან.
 
 ---
 
-## ✨ Features / ფუნქციები
+## ✨ New in v2.2.4
 
-### 🌟 New in v2.2.2 (Documentation Update)
+- 🌐 **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)
 
-* **📝 Corrected Examples**: გამოსწორდა არასწორი მაგალითები დოკუმენტაციაში (მაგ: არასწორი "კლასსი" → წაშლილია).
-* **📚 Python README**: განახლდა Python package-ის README სრული და ზუსტი დოკუმენტაციით.
-* **✅ PyPI Update**: ხელახლა გამოქვეყნდა PyPI-ზე გასწორებული README-ით.
-
-### 🌟 v2.2.1 Features
-
-* **🧹 Automatic Sanitization**: ბიბლიოთეკა ავტომატურად ცნობს და შლის ტექსტში უკვე არსებულ დამარცვლის ნიშნებს (Soft-hyphens) დამუშავებამდე. ეს გამორიცხავს "ორმაგი დამარცვლის" შეცდომას.
-* **📚 Dictionary Integration**: მხარდაჭერილია გამონაკლისების ლექსიკონი (`exceptions.json`), რომელიც პრიორიტეტულია ალგორითმთან შედარებით რთული სიტყვების დამუშავებისას.
-* **⚡ High Performance**: ჰარმონიული ჯგუფების ძებნა ოპტიმიზირებულია `Set` სტრუქტურით, რაც უზრუნველყოფს მყისიერ დამუშავებას (O(1) complexity) დიდ ტექსტებზეც კი.
-* **📦 Modern ESM**: სრული თავსებადობა თანამედროვე JavaScript სტანდარტებთან (`import/export`), რაც აადვილებს ინტეგრაციას Vite, React და Vue პროექტებში.
-
-### 🎓 v2.2 Academic Logic (Linguistic Core)
-
-* **🧠 Phonological Distance Analysis**: ხმოვნებს შორის მანძილის ჭკვიანი გაზომვა ზუსტი დამარცვლისთვის.
-* **🛡️ Anti-Orphan Protection**: ხელს უშლის სიტყვის დასაწყისში ან ბოლოში ერთი ასოს მარტო დატოვებას (მინიმუმ 2 სიმბოლო თითოეულ მხარეს).
-* **🎼 Harmonic Clusters Support**: სპეციალური წესები ქართული ჰარმონიული თანხმოვნებისთვის (მაგ: `ბრ`, `წვ`, `მთ`), რომლებიც დამარცვლისას არ იშლება.
-* **🔄 Hiatus Handling**: ხმოვანთშერწყმის (V-V) სწორი დამუშავება (მაგ: `გა-ა-ნა-ლი-ზა`).
+---
 
-### 🚀 Integration & Flexibility
+## ✨ Features from v2.2.2
 
-* ✅ **Multi-Platform**: ხელმისაწვდომია Python, JavaScript (Node & Browser), WordPress და Browser Extensions პლატფორმებისთვის.
-* ✅ **Universal Formats**: მხარდაჭერილია Soft-hyphen (\u00AD), ვიზუალური ტირე, TeX patterns და Hunspell ფორმატები.
-* ✅ **Zero Dependencies**: ბიბლიოთეკა არის სრულიად დამოუკიდებელი და მსუბუქი (~5KB).
-* ✅ **Punctuation Aware**: ტექსტის დამუშავებისას ინარჩუნებს სასვენ ნიშნებს, ციფრებს და ლათინურ სიმბოლოებს.
+- 🧹 **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
 
 ---
 
-## 🧠 Algorithm Logic / ალგორითმის ლოგიკა
-
-ბიბლიოთეკა იყენებს აკადემიურ ფონოლოგიურ ანალიზს, რომელიც ეფუძნება ხმოვნებს შორის მანძილს და თანხმოვნების ტიპებს. v2.2 ვერსიაში დამატებულია წინასწარი გასუფთავების ფენა (Sanitization).
+## 📦 Installation
+```bash
+npm install georgian-hyphenation
+```
 
-### 1. წინასწარი დამუშავება (Sanitization)
+---
 
-დამარცვლის დაწყებამდე სისტემა ასრულებს შემდეგ ნაბიჯებს:
+## 🚀 Quick Start
 
-* **Cleaning**: ტექსტიდან იშლება ყველა არსებული დამარცვლის სიმბოლო (`\u00AD` ან `-`), რათა თავიდან ავიცილოთ ორმაგი დამარცვლა.
-* **Validation**: მოკლე სიტყვები (4 სიმბოლოზე ნაკლები) და სიტყვები ხმოვნების გარეშე ავტომატურად გამოიტოვება.
+### 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>
+```
 
-### 2. ხმოვანთა მანძილის ანალიზი
+---
 
-ალგორითმი პოულობს ხმოვნების ინდექსებს და ითვლის მანძილს მათ შორის:
+### Node.js (ESM)
+```javascript
+import GeorgianHyphenator from 'georgian-hyphenation';
 
-* **V-V:** იყოფა ხმოვნებს შორის.
+const hyphenator = new GeorgianHyphenator('-'); // Visible hyphen
 
-> მაგალითი: **`გა-ა-ი-ა-რა-ღა`**
+// Hyphenate a word
+console.log(hyphenator.hyphenate('საქართველო')); 
+// Output: "სა-ქარ-თვე-ლო"
 
-* **V-C-V:** იყოფა პირველი ხმოვნის შემდეგ.
+// Load dictionary (optional)
+await hyphenator.loadDefaultLibrary();
 
-> მაგალითი: `მა-მა`, `დე-და`
+// Hyphenate text
+const text = "გამარჯობა, საქართველო მშვენიერი ქვეყანაა!";
+console.log(hyphenator.hyphenateText(text));
+// Output: "გა-მარ-ჯო-ბა, სა-ქარ-თვე-ლო მშვე-ნი-ე-რი ქვე-ყა-ნა-ა!"
+```
 
-* **V-CC-V:** სისტემა ამოწმებს თანხმოვნების ტიპს:
-* **Double Consonants**: თუ გვერდიგვერდ ერთი და იგივე თანხმოვანია, იყოფა მათ შორის (იშვიათია ქართულში).
-* **Harmonic Clusters**: თუ თანხმოვნები ქმნიან ჰარმონიულ წყვილს (მაგ: `ბრ`, `წვ`), ისინი რჩებიან ერთად და მარცვალი წყდება მათ წინ.
-* **Default**: სხვა შემთხვევაში იყოფა პირველი თანხმოვნის შემდეგ.
+---
 
+### Node.js (CommonJS)
+```javascript
+const GeorgianHyphenator = require('georgian-hyphenation');
 
+const hyphenator = new GeorgianHyphenator('-');
+console.log(hyphenator.hyphenate('საქართველო'));
+```
 
-### 3. უსაფრთხოების წესები (Constraints)
+---
 
-* **Anti-Orphan**: მარცვალი არასდროს წყდება ისე, რომ რომელიმე მხარეს დარჩეს მხოლოდ 1 ასო.
-* **Left/Right Min**: დამარცვლა ხდება მხოლოდ მაშინ, თუ ორივე მხარეს მინიმუმ 2 სიმბოლო რჩება (მაგ: `არა` არ დაიყოფა).
+## 📖 API Reference
 
-### მაგალითების ანალიზი:
+### **Constructor**
+```javascript
+new GeorgianHyphenator(hyphenChar = '\u00AD')
+```
 
-| სიტყვა | ანალიზი (ხმოვნებს შორის) | შედეგი | წესი |
-| --- | --- | --- | --- |
-| **საქართველო** | `ა-ქ-რ-ე` (2 თანხმოვანი) | `სა-ქარ-თვე-ლო` | სტანდარტული |
-| **ბარბი** | `ა-რ-ბ-ი` ('რ' წესი) | `ბარ-ბი` | სპეციალური 'რ' წესი |
-| **მწვრთნელი** | `მ-წ-ვ-რ-თ-ნ-ე` | `მწვრთნე-ლი` | ჰარმონიული ჯგუფი |
-| **გაანალიზება** | `ა-ა` (0 თანხმოვანი) | `გა-ა-ნა-ლი-ზე-ბა` | ხმოვანთშერწყმა |
+**Parameters:**
+- `hyphenChar` (string): Character to use for hyphenation
+  - `'\u00AD'` - Soft hyphen (invisible, default)
+  - `'-'` - Regular hyphen (visible)
+  - `'·'` - Middle dot
+  - Any custom character
 
 ---
 
-## 📦 Installation / ინსტალაცია
+### **Methods**
 
-### Python
+#### `hyphenate(word)`
 
-```bash
-pip install georgian-hyphenation
+Hyphenates a single Georgian word.
 
+**Features:**
+- Automatically strips existing hyphens (sanitization)
+- Checks dictionary first (if loaded)
+- Falls back to algorithm
+```javascript
+hyphenator.hyphenate('საქართველო'); // → "სა-ქარ-თვე-ლო"
+hyphenator.hyphenate('ბლოკი');       // → "ბლო-კი" (harmonic cluster)
 ```
 
-### JavaScript (NPM)
+---
 
-```bash
-npm install georgian-hyphenation
+#### `hyphenateText(text)`
 
+Hyphenates entire text while preserving:
+- Punctuation
+- Numbers
+- Latin characters
+- Whitespace
+```javascript
+const text = "საქართველო არის ლამაზი ქვეყანა.";
+hyphenator.hyphenateText(text);
+// → "სა-ქარ-თვე-ლო არის ლა-მა-ზი ქვე-ყა-ნა."
 ```
 
-### Browser Extension
+---
 
-**🦊 Firefox:** [Install from Firefox Add-ons](https://addons.mozilla.org/firefox/addon/georgian-hyphenation/)
+#### `getSyllables(word)`
 
-**🌐 Chrome:** *Coming soon to Chrome Web Store*
+Returns syllables as an array.
+```javascript
+hyphenator.getSyllables('საქართველო');
+// → ['სა', 'ქარ', 'თვე', 'ლო']
+```
 
 ---
 
-## 📚 Documentation / დოკუმენტაცია
+#### `loadDefaultLibrary()` (Async)
 
-### Python API
+Loads the default exception dictionary (150+ words).
 
-```python
-from georgian_hyphenation import GeorgianHyphenator
+**Browser:** Fetches from CDN (`jsdelivr`)  
+**Node.js:** Loads from local `data/exceptions.json`
+```javascript
+await hyphenator.loadDefaultLibrary();
+console.log('Dictionary loaded!');
+```
 
-# Initialize with soft hyphen (default: U+00AD)
-hyphenator = GeorgianHyphenator()
+---
 
-# Hyphenate a word
-word = "საქართველო"
-result = hyphenator.hyphenate(word)
-print(result)  # სა­ქარ­თვე­ლო (with U+00AD soft hyphens)
+#### `loadLibrary(data)`
 
-# Get syllables as a list
-syllables = hyphenator.get_syllables(word)
-print(syllables)  # ['სა', 'ქარ', 'თვე', 'ლო']
+Load custom dictionary.
+```javascript
+hyphenator.loadLibrary({
+  'სპეციალური': 'სპე-ცი-ა-ლუ-რი',
+  'კომპიუტერი': 'კომ-პიუ-ტე-რი'
+});
+```
 
-# Use visible hyphens for display
-visible = GeorgianHyphenator('-')
-print(visible.hyphenate(word))  # სა-ქარ-თვე-ლო
+---
+
+## 🧠 Algorithm Logic
 
-# Hyphenate entire text (preserves punctuation)
-text = "საქართველო არის ლამაზი ქვეყანა."
-print(hyphenator.hyphenate_text(text))
-# Output: სა­ქარ­თვე­ლო არის ლა­მა­ზი ქვე­ყა­ნა.
+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**
 
-## 📚 JavaScript API (v2.2.1+)
+- **V-V (0 consonants)**: Split between vowels
+```javascript
+  'გააკეთა' → 'გა-ა-კე-თა'
+```
 
-v2.2.1 ვერსია სრულად გადასულია **ES Modules (ESM)** სტანდარტზე, რაც უზრუნველყოფს საუკეთესო თავსებადობას თანამედროვე ხელსაწყოებთან (Vite, React, Vue, Next.js) და Node.js-ის ახალ ვერსიებთან.
+- **V-C-V (1 consonant)**: Split after first vowel
+```javascript
+  'მამა' → 'მა-მა'
+```
 
-### ⚙️ ინიციალიზაცია
+- **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
 
-```javascript
-import GeorgianHyphenator from 'georgian-hyphenation';
+### 3. **Harmonic Clusters (62 clusters)**
 
-// ნაგულისხმევი სიმბოლოა Soft-Hyphen (\u00AD)
-const hyphenator = new GeorgianHyphenator();
+These consonant pairs stay together:
+```
+ბლ, ბრ, ბღ, ბზ, გდ, გლ, გმ, გნ, გვ, გზ, გრ, დრ, თლ, თრ, თღ,
+კლ, კმ, კნ, კრ, კვ, მტ, პლ, პრ, ჟღ, რგ, რლ, რმ, სწ, სხ, ტკ, 
+ტპ, ტრ, ფლ, ფრ, ფქ, ფშ, ქლ, ქნ, ქვ, ქრ, ღლ, ღრ, ყლ, ყრ, შთ, 
+შპ, ჩქ, ჩრ, ცლ, ცნ, ცრ, ცვ, ძგ, ძვ, ძღ, წლ, წრ, წნ, წკ, ჭკ, 
+ჭრ, ჭყ, ხლ, ხმ, ხნ, ხვ, ჯგ
+```
 
-// ტესტირებისთვის შეგიძლიათ გამოიყენოთ ხილული ტირე (-)
-const visibleHyphenator = new GeorgianHyphenator('-');
+### 4. **Anti-Orphan Protection**
 
+Minimum 2 characters on each side:
+```javascript
+'არა' → 'არა'    // Not split (would create 1-letter syllable)
+'არაა' → 'ა-რა-ა' // OK to split
 ```
 
-### 🛠 ძირითადი მეთოდები
+---
 
-#### 1. `hyphenate(word)`
+## 🎨 Examples
 
+### Basic Words
 ```javascript
-const result = hyphenator.hyphenate('საქართველო');
-console.log(result); // "სა-ქარ-თვე-ლო"
+hyphenate('საქართველო')  // → სა-ქარ-თვე-ლო
+hyphenate('მთავრობა')     // → მთავ-რო-ბა
+hyphenate('დედაქალაქი')   // → დე-და-ქა-ლა-ქი
+hyphenate('პარლამენტი')   // → პარ-ლა-მენ-ტი
+```
 
+### Harmonic Clusters
+```javascript
+hyphenate('ბლოკი')        // → ბლო-კი  (ბლ stays together)
+hyphenate('კრემი')        // → კრე-მი  (კრ stays together)
+hyphenate('გლეხი')        // → გლე-ხი  (გლ stays together)
+hyphenate('პროგრამა')    // → პროგ-რა-მა (პრ and გრ preserved)
 ```
 
-#### 2. `hyphenateText(text)`
+### V-V Split
+```javascript
+hyphenate('გააკეთა')      // → გა-ა-კე-თა
+hyphenate('გაიარა')       // → გა-ი-ა-რა
+hyphenate('გაანალიზა')    // → გა-ა-ნა-ლი-ზა
+```
 
+### Text Processing
 ```javascript
-const longText = "გამარჯობა, საქართველო მშვენიერი ქვეყანაა!";
-console.log(hyphenator.hyphenateText(longText));
+hyphenateText('საქართველო არის ლამაზი ქვეყანა')
+// → 'სა­ქარ­თვე­ლო არის ლა­მა­ზი ქვე­ყა­ნა' (with soft hyphens)
 
+// Preserves punctuation
+hyphenateText('მთავრობა, პარლამენტი და სასამართლო.')
+// → 'მთავ­რო­ბა, პარ­ლა­მენ­ტი და სა­სა­მარ­თლო.'
 ```
 
-#### 3. `getSyllables(word)`
+---
 
-```javascript
-const syllables = hyphenator.getSyllables('უნივერსიტეტი');
-console.log(syllables); // ["უ", "ნი", "ვერ", "სი", "ტე", "ტი"]
+## 🧪 Testing
 
+Run the test suite:
+```bash
+npm test
 ```
 
-#### 4. `loadDefaultLibrary()` (Async)
+Expected output:
+```
+✅ Test 1: საქართველო → სა-ქარ-თვე-ლო
+✅ Test 2: მთავრობა → მთავ-რო-ბა
+...
+📊 Test Results: 13 passed, 0 failed
+🎉 All tests passed!
+```
 
-```javascript
-await hyphenator.loadDefaultLibrary();
-console.log('ლექსიკონი ჩაიტვირთა');
+---
 
+## 📊 Dictionary
+
+The library includes `data/exceptions.json` with 150+ Georgian words:
+```json
+{
+  "საქართველო": "სა-ქარ-თვე-ლო",
+  "კომპიუტერი": "კომ-პიუ-ტე-რი",
+  "პროგრამა": "პროგ-რა-მა",
+  "ინტერნეტი": "ინ-ტერ-ნე-ტი"
+}
 ```
 
 ---
 
-## 🌐 Browser Usage (CDN / ESM)
+## 📝 Changelog
 
-```html
-<p class="hyphenated" id="content"></p>
+### Version 2.2.4 (2026-01-27)
 
-<script type="module">
-  import GeorgianHyphenator from 'https://cdn.jsdelivr.net/npm/georgian-hyphenation@2.2.2/src/javascript/index.js';
+* 🌐 **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
 
-  async function initializeHyphenator() {
-    const hyphenator = new GeorgianHyphenator('\u00AD');
-    await hyphenator.loadDefaultLibrary();
+### Version 2.2.1 (2026-01-26)
 
-    const text = "საქართველო არის ძალიან ლამაზი ქვეყანა, სადაც ბევრი ისტორიული ძეგლია.";
-    
-    document.getElementById('content').textContent = hyphenator.hyphenateText(text);
-  }
+* 🧹 **Sanitization**: Added `_stripHyphens` for automatic input cleaning
+* ⚡ **Performance**: Converted `harmonicClusters` to `Set` (O(1) lookup)
+* 📦 **ESM**: Full ES Modules support
+* 📚 **Dictionary**: Added `loadDefaultLibrary()` method
 
-  initializeHyphenator();
-</script>
+### 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
 
 ---
 
-## 📊 Examples / მაგალითები
+## 🤝 Contributing
 
-| Word (სიტყვა) | Syllables (მარცვლები) | Hyphenated | TeX Pattern |
-| --- | --- | --- | --- |
-| საქართველო | სა, ქარ, თვე, ლო | სა-ქარ-თვე-ლო | .სა1ქარ1თვე1ლო. |
-| მთავრობა | მთავ, რო, ბა | მთავ-რო-ბა | .მთავ1რო1ბა. |
-| დედაქალაქი | დე, და, ქა, ლა, ქი | დე-და-ქა-ლა-ქი | .დე1და1ქა1ლა1ქი. |
-| ბლოკი | ბლო, კი | ბლო-კი | .ბლო1კი. |
-| კრემი | კრე, მი | კრე-მი | .კრე1მი. |
+Contributions welcome! Please:
 
----
+1. Fork the repository
+2. Create a feature branch
+3. Run tests: `npm test`
+4. Submit a Pull Request
 
-## 📝 Changelog
+---
 
-### Version 2.2.2 (2025-01-27) — Documentation Update 📝
+## 🐛 Bug Reports
 
-* 📝 **README Corrections**: გამოსწორდა არასწორი მაგალითები (მაგ: "კლასსი" → წაშლილია, რადგან არ არსებობს ქართულში).
-* 📚 **Python README**: განახლდა Python package-ის README სრული დოკუმენტაციით და გასწორებული მაგალითებით.
-* ✅ **PyPI v2.2.2**: ხელახლა გამოქვეყნდა PyPI-ზე გასწორებული დოკუმენტაციით.
+Found a bug? [Open an issue](https://github.com/guramzhgamadze/georgian-hyphenation/issues)
 
 ---
 
-### Version 2.2.1 (2025-01-26) — The Modernization Update 🚀
+## 📄 License
 
-* 🧹 **Automatic Sanitization**: დაემატა `_stripHyphens` ფუნქციონალი, რომელიც ავტომატურად ასუფთავებს ტექსტს ძველი დამარცვლის სიმბოლოებისგან.
-* 📦 **ES Modules (ESM)**: ბიბლიოთეკა სრულად გადავიდა თანამედროვე JavaScript სტანდარტზე (`import/export`).
-* 📚 **Async Dictionary Support**: დაემატა `loadDefaultLibrary()` მეთოდი გამონაკლისების ლექსიკონის ავტომატური ჩატვირთვისთვის.
-* ⚡ **Optimization**: ჰარმონიული ჯგუფების ძებნა გადავიდა `Set` სტრუქტურაზე სისწრაფისთვის.
-* 🛠 **Package Improvements**: განახლდა `package.json` კონფიგურაცია (`exports`, `files` whitelist) NPM-ისთვის.
+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:
 
-## 📄 License / ლიცენზია
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-This project is licensed under the MIT License - see the LICENSE file for details.
+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 / კონტაქტი
+## 📧 Contact
 
 **Guram Zhgamadze**
 
-* 🐙 GitHub: [@guramzhgamadze](https://github.com/guramzhgamadze)
-* 📧 Email: guramzhgamadze@gmail.com
-* 🐛 Issues: [Report bugs or request features](https://github.com/guramzhgamadze/georgian-hyphenation/issues)
+- 🐙 GitHub: [@guramzhgamadze](https://github.com/guramzhgamadze)
+- 📧 Email: guramzhgamadze@gmail.com
+- 📦 NPM: [georgian-hyphenation](https://www.npmjs.com/package/georgian-hyphenation)
 
 ---
 
-## 🔗 Links / ლინკები
+## 🔗 Links
 
-* 🐍 **PyPI:** [https://pypi.org/project/georgian-hyphenation/](https://pypi.org/project/georgian-hyphenation/)
-* 📦 **NPM:** [https://www.npmjs.com/package/georgian-hyphenation](https://www.npmjs.com/package/georgian-hyphenation)
-* 🦊 **Firefox:** [https://addons.mozilla.org/firefox/addon/georgian-hyphenation/](https://addons.mozilla.org/firefox/addon/georgian-hyphenation/)
-* 🎨 **Demo:** [https://guramzhgamadze.github.io/georgian-hyphenation/](https://guramzhgamadze.github.io/georgian-hyphenation/)
+- **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
-
-შექმნილია ❤️-ით ქართული ენის საზოგადოებისთვის
-
-🇬🇪 **საქართველო** 🇬🇪
+**Made with ❤️ for the Georgian language community**
 
----
+🇬🇪 **ქართული ენის ციფრული განვითარებისთვის**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "georgian-hyphenation",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "description": "Georgian Language Hyphenation Library - Browser + Node.js compatible",
   "main": "src/javascript/index.js",
   "module": "src/javascript/index.js",
@@ -13,7 +13,7 @@
     "./data/exceptions.json": "./data/exceptions.json"
   },
   "files": [
-    "src/",
+    "src/javascript/",
     "data/",
     "README.md",
     "LICENSE"

package/src/javascript/index.js

@@ -1,5 +1,5 @@
 /**
- * Georgian Hyphenation Library v2.2.3
+ * Georgian Hyphenation Library v2.2.4
  * Browser + Node.js Compatible
  */
 
@@ -54,7 +54,7 @@ export default class GeorgianHyphenator {
     if (typeof window !== 'undefined' && typeof fetch !== 'undefined') {
       try {
         // ✅ სწორი CDN URL - jsdelivr უფრო სანდოა unpkg-ზე
-        const response = await fetch('https://cdn.jsdelivr.net/npm/georgian-hyphenation@2.2.3/data/exceptions.json');
+        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}`);
@@ -64,9 +64,9 @@ export default class GeorgianHyphenator {
         this.loadLibrary(data);
         this.dictionaryLoaded = true;
         
-        console.log(`Georgian Hyphenation v2.2.3: Dictionary loaded (${this.dictionary.size} words)`);
+        console.log(`Georgian Hyphenation v2.2.4: Dictionary loaded (${this.dictionary.size} words)`);
       } catch (error) {
-        console.warn('Georgian Hyphenation v2.2.3: Dictionary not available, using algorithm only');
+        console.warn('Georgian Hyphenation v2.2.4: Dictionary not available, using algorithm only');
         console.warn('Error:', error.message);
       }
     }
@@ -77,9 +77,9 @@ export default class GeorgianHyphenator {
         const data = require('../../data/exceptions.json');
         this.loadLibrary(data);
         this.dictionaryLoaded = true;
-        console.log(`Georgian Hyphenation v2.2.3: Dictionary loaded (${this.dictionary.size} words)`);
+        console.log(`Georgian Hyphenation v2.2.4: Dictionary loaded (${this.dictionary.size} words)`);
       } catch (error) {
-        console.warn('Georgian Hyphenation v2.2.3: Local dictionary not found, using algorithm only');
+        console.warn('Georgian Hyphenation v2.2.4: Local dictionary not found, using algorithm only');
       }
     }
   }