@lokascript/i18n 3.1.1 → 3.3.0

package/README.md

@@ -2,6 +2,8 @@
 
 Comprehensive internationalization (i18n) support for LokaScript and \_hyperscript applications.
 
+> **This package no longer translates code.** Its grammar transformer was retired on 2026-08-28 (#1001). To translate hyperscript between languages, use [`@lokascript/semantic`](https://www.npmjs.com/package/@lokascript/semantic): `translate(code, from, to)` or `render(parse(code, from), to)`. `@lokascript/i18n` provides the per-language vocabulary — dictionaries, keyword providers, locale utilities and word-order profiles.
+
 ## Installation
 
 ```bash
@@ -15,7 +17,7 @@ npm install @lokascript/i18n
 - **⚡ SSR Integration**: Server-side rendering with locale detection, SEO optimization, and hydration support
 - **📊 Pluralization**: CLDR-compliant pluralization rules for complex languages (Russian, Arabic, etc.)
 - **💰 Formatting**: Locale-aware number, date, currency, and unit formatting with fallbacks
-- **🛠️ Build Tool Integration**: Vite and Webpack plugins for build-time translation
+- **🛠️ Build Tool Integration**: Vite and Webpack plugins for build-time keyword substitution
 - **🔍 Language Detection**: Automatically detect the language of hyperscript code from content
 - **✅ Validation**: Comprehensive dictionary validation with coverage reports and warnings
 - **🎯 Type Safety**: Full TypeScript support with comprehensive type definitions
@@ -26,42 +28,44 @@ npm install @lokascript/i18n
 
 LokaScript has two packages for multilingual support with different purposes:
 
-| Package                  | Purpose                                      | Use Case                                             |
-| ------------------------ | -------------------------------------------- | ---------------------------------------------------- |
-| **@lokascript/semantic** | Parse code written in any language → execute | Users **write** hyperscript in their native language |
-| **@lokascript/i18n**     | Transform code between languages             | **Translate** code examples for docs/teaching        |
+| Package                  | Purpose                                                            | Use Case                                                                 |
+| ------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| **@lokascript/semantic** | Parse code written in any language → execute; translate it         | Users **write** hyperscript in their native language; **translate** code |
+| **@lokascript/i18n**     | Per-language vocabulary: dictionaries, keyword providers, profiles | Tools and runtimes that need the **words** of each language              |
 
 **Use @lokascript/semantic** when your users will write hyperscript in their native language. It parses multilingual input directly into executable AST nodes with native idiom support (e.g., Japanese conditionals like `クリックしたら`).
 
-**Use @lokascript/i18n** (this package) when you need to translate code examples between languages for documentation, tutorials, or teaching materials. It transforms existing code for display purposes—showing learners how the same logic looks in different languages.
+**Use @lokascript/semantic** too when you need to translate code examples between languages for documentation, tutorials, or teaching materials. It parses the code and renders it in the target language's own word order.
 
 Example workflow for documentation:
 
 ```typescript
+import { translate } from '@lokascript/semantic';
+
 // You have English examples in your docs
-const english = 'on click toggle .active';
+const english = 'toggle .active';
 
 // Translate to show Japanese readers the equivalent
-const japanese = translator.translate(english, { from: 'en', to: 'ja' });
-// → "クリック で .active を 切り替え"
+const japanese = translate(english, 'en', 'ja');
+// → ".active を 切り替え"
 ```
 
+**Use @lokascript/i18n** (this package) for the vocabulary itself: keyword dictionaries, keyword providers for parsers and editors, locale detection and formatting, and the word-order profiles.
+
 ## Quick Start
 
-### Basic Translation
+### Keyword Substitution
+
+`HyperscriptTranslator` (and the ready-made `defaultTranslator`) swaps keywords word-for-word using the dictionaries. It does not parse the code or reorder words, so its output is not a faithful translation — for that, use `@lokascript/semantic`'s `translate`.
 
 ```typescript
 import { HyperscriptTranslator } from '@lokascript/i18n';
 
-const translator = new HyperscriptTranslator({ locale: 'es' });
-
-// Translate from Spanish to English
-const english = translator.translate('en clic alternar .activo', { to: 'en' });
-// Result: "on click toggle .activo"
+const translator = new HyperscriptTranslator({ locale: 'en' });
 
-// Translate from English to Korean
+// Swap English keywords for Korean ones, in place
 const korean = translator.translate('on click toggle .active', { from: 'en', to: 'ko' });
-// Result: "클릭 토글 .active"
+// Result: "에 클릭 토글 .active" (keywords substituted; English word order kept)
 ```
 
 ### Language Detection
@@ -73,6 +77,8 @@ const detectedLocale = translator.detectLanguage('si verdadero entonces registra
 
 ### Build Tool Integration
 
+Both plugins run `HyperscriptTranslator` over hyperscript attributes at build time, so they substitute keywords; they do not translate.
+
 #### Vite
 
 ```typescript
@@ -123,6 +129,17 @@ module.exports = {
 | Indonesian | `id` | ✅ Complete | SVO        | Agglutinative support                      |
 | Quechua    | `qu` | ✅ Complete | SOV        | Agglutinative support                      |
 | Swahili    | `sw` | ✅ Complete | SVO        | Noun class system                          |
+| Bengali    | `bn` | ✅ Complete | SOV        | —                                          |
+| Hebrew     | `he` | ✅ Complete | SVO        | RTL support                                |
+| Hindi      | `hi` | ✅ Complete | SOV        | —                                          |
+| Italian    | `it` | ✅ Complete | SVO        | Pluralization                              |
+| Malay      | `ms` | ✅ Complete | SVO        | —                                          |
+| Polish     | `pl` | ✅ Complete | SVO        | Pluralization                              |
+| Russian    | `ru` | ✅ Complete | SVO        | Pluralization                              |
+| Tagalog    | `tl` | ✅ Complete | VSO        | —                                          |
+| Thai       | `th` | ✅ Complete | SVO        | —                                          |
+| Ukrainian  | `uk` | ✅ Complete | SVO        | —                                          |
+| Vietnamese | `vi` | ✅ Complete | SVO        | —                                          |
 
 ## API Reference
 
@@ -132,7 +149,7 @@ module.exports = {
 class HyperscriptTranslator {
   constructor(config: I18nConfig);
 
-  // Translate hyperscript text
+  // Substitute keywords word-for-word (no parsing, no reordering)
   translate(text: string, options: TranslationOptions): string;
 
   // Get detailed translation with token information
@@ -211,33 +228,6 @@ const translator = new HyperscriptTranslator({
 });
 ```
 
-### LSP Integration
-
-```typescript
-import { I18nLanguageProvider } from '@lokascript/i18n/lsp';
-
-const provider = new I18nLanguageProvider('es');
-
-// Get completions
-const completions = await provider.provideCompletions(document, position);
-
-// Get hover information
-const hover = await provider.provideHover(document, position);
-```
-
-### CLI Usage
-
-```bash
-# Install globally
-npm install -g @lokascript/i18n
-
-# Translate a file
-lokascript-translate input.html output.html --from es --to en
-
-# Translate a directory
-lokascript-translate src/ dist/ --from es --to en
-```
-
 ## Contributing
 
 We welcome contributions, especially new language dictionaries!

package/dist/browser.cjs

@@ -556,7 +556,8 @@ var es = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "h"
+    h: "h",
+    times: "veces"
   },
   values: {
     true: "verdadero",
@@ -777,7 +778,8 @@ var ja = {
     ms: "ms",
     s: "\u79D2",
     min: "\u5206",
-    h: "\u6642"
+    h: "\u6642",
+    times: "\u56DE"
   },
   values: {
     true: "\u771F",
@@ -996,7 +998,8 @@ var fr = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "h"
+    h: "h",
+    times: "fois"
   },
   values: {
     true: "vrai",
@@ -1226,7 +1229,8 @@ var de = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "std"
+    h: "std",
+    times: "mal"
   },
   values: {
     true: "wahr",
@@ -1450,12 +1454,13 @@ var ar = {
     ms: "\u0645.\u062B",
     s: "\u062B",
     min: "\u062F",
-    h: "\u0633"
+    h: "\u0633",
+    times: "\u0645\u0631\u0627\u062A"
   },
   values: {
     true: "\u0635\u062D\u064A\u062D",
     false: "\u062E\u0637\u0623",
-    null: "\u0641\u0627\u0631\u063A",
+    null: "null",
     undefined: "\u063A\u064A\u0631 \u0645\u0639\u0631\u0641",
     it: "\u0647\u0648",
     its: "\u0644\u0647",
@@ -1670,7 +1675,8 @@ var ko = {
     ms: "ms",
     s: "\uCD08",
     min: "\uBD84",
-    h: "\uC2DC"
+    h: "\uC2DC",
+    times: "\uBC88"
   },
   values: {
     true: "\uCC38",
@@ -1898,7 +1904,8 @@ var zh = {
     ms: "\u6BEB\u79D2",
     s: "\u79D2",
     min: "\u5206",
-    h: "\u65F6"
+    h: "\u65F6",
+    times: "\u6B21"
   },
   values: {
     true: "\u771F",
@@ -2100,7 +2107,9 @@ var tr = {
     exists: "var",
     matches: "e\u015Fle\u015Fir",
     contains: "i\xE7erir",
-    includes: "dahil",
+    // `includes` takes `contains`' word: both engines read them as one operator,
+    // and `dahil` is `inclusive` (pick's range word), which the reader takes it for.
+    includes: "i\xE7erir",
     equals: "e\u015Fittir",
     has: "var",
     have: "var",
@@ -2123,12 +2132,13 @@ var tr = {
     ms: "ms",
     s: "s",
     min: "dk",
-    h: "sa"
+    h: "sa",
+    times: "kez"
   },
   values: {
     true: "do\u011Fru",
     false: "yanl\u0131\u015F",
-    null: "bo\u015F",
+    null: "null",
     undefined: "tan\u0131ms\u0131z",
     it: "o",
     its: "onun",
@@ -2362,12 +2372,13 @@ var id = {
     ms: "ms",
     s: "d",
     min: "mnt",
-    h: "j"
+    h: "j",
+    times: "kali"
   },
   values: {
     true: "benar",
     false: "salah",
-    null: "kosong",
+    null: "null",
     undefined: "tidak_terdefinisi",
     it: "itu",
     its: "miliknya",
@@ -2579,7 +2590,7 @@ var qu = {
   logical: {
     when: "maykama",
     where: "maypi",
-    and: "chaymanta",
+    and: "hinallataq",
     or: "utaq",
     not: "mana",
     is: "kanqa",
@@ -2613,12 +2624,13 @@ var qu = {
     ms: "ms",
     s: "s",
     min: "m",
-    h: "h"
+    h: "h",
+    times: "kuti"
   },
   values: {
     true: "cheqaq",
     false: "llulla",
-    null: "chusaq",
+    null: "null",
     undefined: "mana_riqsisqa",
     it: "chay",
     its: "chaypaq",
@@ -2858,12 +2870,13 @@ var sw = {
     ms: "ms",
     s: "s",
     min: "dk",
-    h: "sa"
+    h: "sa",
+    times: "mara"
   },
   values: {
     true: "kweli",
     false: "uongo",
-    null: "tupu",
+    null: "null",
     undefined: "haijafafanuliwa",
     it: "hiyo",
     its: "yake",
@@ -3089,7 +3102,8 @@ var pt = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "h"
+    h: "h",
+    times: "vezes"
   },
   values: {
     true: "verdadeiro",
@@ -3307,7 +3321,8 @@ var it = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "h"
+    h: "h",
+    times: "volte"
   },
   values: {
     true: "vero",
@@ -3752,7 +3767,8 @@ var pl = {
     ms: "ms",
     s: "s",
     min: "min",
-    h: "godz"
+    h: "godz",
+    times: "razy"
   },
   values: {
     true: "prawda",
@@ -3986,7 +4002,8 @@ var russianDictionary = {
     forever: "\u0432\u0441\u0435\u0433\u0434\u0430",
     once: "\u043E\u0434\u043D\u0430\u0436\u0434\u044B",
     every: "\u043A\u0430\u0436\u0434\u044B\u0439",
-    until: "\u0434\u043E"
+    until: "\u0434\u043E",
+    times: "\u0440\u0430\u0437"
   },
   values: {
     true: "\u0438\u0441\u0442\u0438\u043D\u0430",
@@ -4233,7 +4250,8 @@ var ukrainianDictionary = {
     forever: "\u0437\u0430\u0432\u0436\u0434\u0438",
     once: "\u043E\u0434\u0438\u043D_\u0440\u0430\u0437",
     every: "\u043A\u043E\u0436\u043D\u0438\u0439",
-    until: "\u0434\u043E"
+    until: "\u0434\u043E",
+    times: "\u0440\u0430\u0437\u0456\u0432"
   },
   values: {
     true: "\u0456\u0441\u0442\u0438\u043D\u0430",
@@ -4478,12 +4496,13 @@ var hindiDictionary = {
     forever: "\u0939\u092E\u0947\u0936\u093E",
     once: "\u090F\u0915_\u092C\u093E\u0930",
     every: "\u0939\u0930",
-    until: "\u0924\u0915"
+    until: "\u0924\u0915",
+    times: "\u092C\u093E\u0930"
   },
   values: {
     true: "\u0938\u091A",
     false: "\u091D\u0942\u0920",
-    null: "\u0916\u093E\u0932\u0940",
+    null: "null",
     undefined: "\u0905\u092A\u0930\u093F\u092D\u093E\u0937\u093F\u0924",
     it: "\u092F\u0939",
     its: "\u0907\u0938\u0915\u093E",
@@ -4540,7 +4559,7 @@ var hindiDictionary = {
     parent: "\u092E\u0942\u0932",
     children: "\u092C\u091A\u094D\u091A\u0947",
     within: "\u0915\u0947_\u0905\u0902\u0926\u0930",
-    no: "\u0928\u0939\u0940\u0902",
+    no: "\u0915\u094B\u0908 \u0928\u0939\u0940\u0902",
     empty: "\u0916\u093E\u0932\u0940",
     some: "\u0915\u0941\u091B",
     "starts with": "\u0938\u0947_\u0936\u0941\u0930\u0942",
@@ -4870,7 +4889,7 @@ var thaiDictionary = {
     empty: "\u0E27\u0E48\u0E32\u0E07",
     true: "\u0E08\u0E23\u0E34\u0E07",
     false: "\u0E40\u0E17\u0E47\u0E08",
-    null: "\u0E27\u0E48\u0E32\u0E07",
+    null: "null",
     undefined: "\u0E44\u0E21\u0E48\u0E01\u0E33\u0E2B\u0E19\u0E14",
     end: "\u0E08\u0E1A",
     then: "\u0E41\u0E25\u0E49\u0E27",
@@ -5322,7 +5341,9 @@ var tagalogDictionary = {
     exists: "may",
     matches: "tumutugma",
     contains: "naglalaman",
-    includes: "kasama",
+    // `includes` takes `contains`' word: both engines read them as one operator,
+    // and `kasama` is `inclusive` (pick's range word), which the reader takes it for.
+    includes: "naglalaman",
     equals: "katumbas",
     has: "may",
     have: "may",
@@ -5512,7 +5533,9 @@ var he = {
     when: "\u05DB\u05D0\u05E9\u05E8",
     where: "\u05D0\u05D9\u05E4\u05D4"
   },
-  temporal: {},
+  temporal: {
+    times: "\u05E4\u05E2\u05DE\u05D9\u05DD"
+  },
   values: {
     body: "\u05D2\u05D5\u05E3",
     event: "\u05D0\u05D9\u05E8\u05D5\u05E2",