@lokascript/i18n 1.3.0 → 2.1.0

package/src/dictionaries/index.ts

@@ -1,175 +1,92 @@
 /**
  * Dictionary Index
  *
- * Exports dictionaries for all supported languages.
+ * Exports dictionaries for all 22 supported languages.
+ * Each dictionary maps English canonical keywords to locale-specific translations
+ * across 8 categories: commands, modifiers, events, logical, temporal, values,
+ * attributes, and expressions.
  *
- * Strategy: Dictionaries are derived from semantic profiles where possible,
- * with fallbacks to manual definitions for categories not in profiles
- * (events, temporal, some values, attributes).
- *
- * The semantic package's language profiles are the single source of truth
- * for command/modifier/logical keyword translations.
- *
- * TRANSITION NOTE: Currently using full legacy overrides to preserve
- * backward compatibility. Once profiles and dictionaries are synchronized,
- * the legacy overrides can be reduced to only non-profile categories.
+ * Derivation utilities (deriveFromProfile, createEnglishDictionary) are available
+ * for generating dictionaries from semantic language profiles. See ./derive.ts.
  */
 
 import { Dictionary } from '../types';
 
-// NOTE: Derivation infrastructure is ready but not yet active.
-// The languageProfiles from @lokascript/semantic can be used with deriveFromProfile()
-// once we're ready to transition away from legacy dictionaries.
-// See ./derive.ts for the derivation utilities.
-
-// Import legacy dictionaries for overrides
-// These provide backward compatibility during the transition period
-import { en as enLegacy } from './en';
-import { es as esLegacy } from './es';
-import { ko as koLegacy } from './ko';
-import { zh as zhLegacy } from './zh';
-import { fr as frLegacy } from './fr';
-import { de as deLegacy } from './de';
-import { ja as jaLegacy } from './ja';
-import { ar as arLegacy } from './ar';
-import { tr as trLegacy } from './tr';
-import { id as idLegacy } from './id';
-import { qu as quLegacy } from './qu';
-import { sw as swLegacy } from './sw';
-import { pt as ptLegacy } from './pt';
-import { it as itLegacy } from './it';
-import { vi as viLegacy } from './vi';
-import { pl as plLegacy } from './pl';
-import { russianDictionary as ruLegacy } from './ru';
-import { ukrainianDictionary as ukLegacy } from './uk';
-import { hindiDictionary as hiLegacy } from './hi';
-import { bengaliDictionary as bnLegacy } from './bn';
-import { thaiDictionary as thLegacy } from './th';
-import { malayDictionary as msLegacy } from './ms';
-import { tagalogDictionary as tlLegacy } from './tl';
+// Import per-language dictionaries
+import { en as enDict } from './en';
+import { es as esDict } from './es';
+import { ko as koDict } from './ko';
+import { zh as zhDict } from './zh';
+import { fr as frDict } from './fr';
+import { de as deDict } from './de';
+import { ja as jaDict } from './ja';
+import { ar as arDict } from './ar';
+import { tr as trDict } from './tr';
+import { id as idDict } from './id';
+import { qu as quDict } from './qu';
+import { sw as swDict } from './sw';
+import { pt as ptDict } from './pt';
+import { it as itDict } from './it';
+import { vi as viDict } from './vi';
+import { pl as plDict } from './pl';
+import { russianDictionary as ruDict } from './ru';
+import { ukrainianDictionary as ukDict } from './uk';
+import { hindiDictionary as hiDict } from './hi';
+import { bengaliDictionary as bnDict } from './bn';
+import { thaiDictionary as thDict } from './th';
+import { malayDictionary as msDict } from './ms';
+import { tagalogDictionary as tlDict } from './tl';
 
 // =============================================================================
-// Derived Dictionaries with Legacy Overrides
+// Dictionary Exports
 // =============================================================================
 
-// For backward compatibility, we use full legacy overrides.
-// This ensures no translation changes while establishing the derivation infrastructure.
-// Future: Reduce overrides to only non-profile categories as profiles are synchronized.
-
-/**
- * English dictionary - uses legacy values for full compatibility.
- */
-export const en: Dictionary = enLegacy;
-
-/**
- * Spanish dictionary - legacy overrides for compatibility.
- */
-export const es: Dictionary = esLegacy;
-
-/**
- * Japanese dictionary - legacy overrides for compatibility.
- */
-export const ja: Dictionary = jaLegacy;
-
-/**
- * Korean dictionary - legacy overrides for compatibility.
- */
-export const ko: Dictionary = koLegacy;
-
-/**
- * Chinese dictionary - legacy overrides for compatibility.
- */
-export const zh: Dictionary = zhLegacy;
-
-/**
- * French dictionary - legacy overrides for compatibility.
- */
-export const fr: Dictionary = frLegacy;
-
-/**
- * German dictionary - legacy overrides for compatibility.
- */
-export const de: Dictionary = deLegacy;
-
-/**
- * Arabic dictionary - legacy overrides for compatibility.
- */
-export const ar: Dictionary = arLegacy;
-
-/**
- * Turkish dictionary - legacy overrides for compatibility.
- */
-export const tr: Dictionary = trLegacy;
-
-/**
- * Indonesian dictionary - legacy overrides for compatibility.
- */
-export const id: Dictionary = idLegacy;
-
-/**
- * Portuguese dictionary - legacy overrides for compatibility.
- */
-export const pt: Dictionary = ptLegacy;
-
-/**
- * Quechua dictionary - legacy overrides for compatibility.
- */
-export const qu: Dictionary = quLegacy;
-
-/**
- * Swahili dictionary - legacy overrides for compatibility.
- */
-export const sw: Dictionary = swLegacy;
-
-/**
- * Italian dictionary - legacy overrides for compatibility.
- */
-export const it: Dictionary = itLegacy;
-
-/**
- * Vietnamese dictionary - legacy overrides for compatibility.
- */
-export const vi: Dictionary = viLegacy;
-
-/**
- * Polish dictionary - legacy overrides for compatibility.
- */
-export const pl: Dictionary = plLegacy;
-
-/**
- * Russian dictionary - legacy overrides for compatibility.
- */
-export const ru: Dictionary = ruLegacy;
-
-/**
- * Ukrainian dictionary - legacy overrides for compatibility.
- */
-export const uk: Dictionary = ukLegacy;
-
-/**
- * Hindi dictionary - legacy overrides for compatibility.
- */
-export const hi: Dictionary = hiLegacy;
-
-/**
- * Bengali dictionary - legacy overrides for compatibility.
- */
-export const bn: Dictionary = bnLegacy;
-
-/**
- * Thai dictionary - legacy overrides for compatibility.
- */
-export const th: Dictionary = thLegacy;
-
-/**
- * Malay dictionary - legacy overrides for compatibility.
- */
-export const ms: Dictionary = msLegacy;
-
-/**
- * Tagalog dictionary - legacy overrides for compatibility.
- */
-export const tl: Dictionary = tlLegacy;
+/** English dictionary */
+export const en: Dictionary = enDict;
+/** Spanish dictionary */
+export const es: Dictionary = esDict;
+/** Japanese dictionary */
+export const ja: Dictionary = jaDict;
+/** Korean dictionary */
+export const ko: Dictionary = koDict;
+/** Chinese dictionary */
+export const zh: Dictionary = zhDict;
+/** French dictionary */
+export const fr: Dictionary = frDict;
+/** German dictionary */
+export const de: Dictionary = deDict;
+/** Arabic dictionary */
+export const ar: Dictionary = arDict;
+/** Turkish dictionary */
+export const tr: Dictionary = trDict;
+/** Indonesian dictionary */
+export const id: Dictionary = idDict;
+/** Portuguese dictionary */
+export const pt: Dictionary = ptDict;
+/** Quechua dictionary */
+export const qu: Dictionary = quDict;
+/** Swahili dictionary */
+export const sw: Dictionary = swDict;
+/** Italian dictionary */
+export const it: Dictionary = itDict;
+/** Vietnamese dictionary */
+export const vi: Dictionary = viDict;
+/** Polish dictionary */
+export const pl: Dictionary = plDict;
+/** Russian dictionary */
+export const ru: Dictionary = ruDict;
+/** Ukrainian dictionary */
+export const uk: Dictionary = ukDict;
+/** Hindi dictionary */
+export const hi: Dictionary = hiDict;
+/** Bengali dictionary */
+export const bn: Dictionary = bnDict;
+/** Thai dictionary */
+export const th: Dictionary = thDict;
+/** Malay dictionary */
+export const ms: Dictionary = msDict;
+/** Tagalog dictionary */
+export const tl: Dictionary = tlDict;
 
 // =============================================================================
 // Dictionary Registry
@@ -228,11 +145,10 @@ export const getDictionary = (locale: string, fallback: string = 'en'): Dictiona
 };
 
 // =============================================================================
-// Derivation Utilities (for future use)
+// Derivation Utilities
 // =============================================================================
 
 /**
- * Re-export derivation utilities for external use.
- * These can be used to derive dictionaries from profiles when ready.
+ * Re-export derivation utilities for generating dictionaries from semantic profiles.
  */
 export { deriveFromProfile, createEnglishDictionary, validateDictionary } from './derive';

package/src/dictionaries/it.ts

@@ -49,9 +49,7 @@ export const it: Dictionary = {
     // Data Commands
     increment: 'incrementare',
     decrement: 'decrementare',
-    bind: 'vincolare',
     default: 'predefinito',
-    persist: 'persistere',
 
     // Navigation Commands
     go: 'andare',

package/src/dictionaries/ja.ts

@@ -49,9 +49,7 @@ export const ja: Dictionary = {
     // Data Commands
     increment: '増加',
     decrement: '減少',
-    bind: '結合',
     default: '既定',
-    persist: '永続化',
 
     // Navigation Commands
     go: '移動',

package/src/dictionaries/ko.ts

@@ -49,9 +49,7 @@ export const ko: Dictionary = {
     // Data Commands
     increment: '증가',
     decrement: '감소',
-    bind: '바인드',
     default: '기본값',
-    persist: '유지',
 
     // Navigation Commands
     go: '이동',

package/src/dictionaries/ms.ts

@@ -54,9 +54,7 @@ export const malayDictionary: Dictionary = {
     // Data Commands
     increment: 'tambah_satu',
     decrement: 'kurang_satu',
-    bind: 'ikat',
     default: 'lalai',
-    persist: 'kekal',
 
     // Navigation Commands
     go: 'pergi',

package/src/dictionaries/pl.ts

@@ -55,9 +55,7 @@ export const pl: Dictionary = {
     // Data Commands
     increment: 'zwiększ',
     decrement: 'zmniejsz',
-    bind: 'powiąż',
     default: 'domyślnie',
-    persist: 'zachowaj',
 
     // Navigation Commands
     go: 'idź',

package/src/dictionaries/pt.ts

@@ -53,9 +53,7 @@ export const pt: Dictionary = {
     // Data Commands
     increment: 'incrementar',
     decrement: 'decrementar',
-    bind: 'vincular',
     default: 'padrão',
-    persist: 'persistir',
 
     // Navigation Commands
     go: 'ir',

package/src/dictionaries/qu.ts

@@ -49,9 +49,7 @@ export const qu: Dictionary = {
     // Data Commands
     increment: 'yapay',
     decrement: 'pisiyachiy',
-    bind: 'watay',
     default: 'ñawpaq_kaq',
-    persist: 'waqaychay',
 
     // Navigation Commands
     go: 'riy',

package/src/dictionaries/ru.ts

@@ -54,9 +54,7 @@ export const russianDictionary: Dictionary = {
     // Data Commands
     increment: 'увеличить',
     decrement: 'уменьшить',
-    bind: 'связать',
     default: 'по_умолчанию',
-    persist: 'сохранить',
 
     // Navigation Commands
     go: 'перейти',

package/src/dictionaries/sw.ts

@@ -49,9 +49,7 @@ export const sw: Dictionary = {
     // Data Commands
     increment: 'ongeza',
     decrement: 'punguza',
-    bind: 'funga',
     default: 'msingi',
-    persist: 'hifadhi',
 
     // Navigation Commands
     go: 'nenda',

package/src/dictionaries/tl.ts

@@ -54,9 +54,7 @@ export const tagalogDictionary: Dictionary = {
     // Data Commands
     increment: 'dagdagan',
     decrement: 'bawasan',
-    bind: 'itali',
     default: 'pamantayan',
-    persist: 'panatilihin',
 
     // Navigation Commands
     go: 'pumunta',

package/src/dictionaries/tr.ts

@@ -49,9 +49,7 @@ export const tr: Dictionary = {
     // Data Commands
     increment: 'artır',
     decrement: 'azalt',
-    bind: 'bağla',
     default: 'varsayılan',
-    persist: 'kalıcı',
 
     // Navigation Commands
     go: 'git',

package/src/dictionaries/uk.ts

@@ -54,9 +54,7 @@ export const ukrainianDictionary: Dictionary = {
     // Data Commands
     increment: 'збільшити',
     decrement: 'зменшити',
-    bind: "прив'язати",
     default: 'за_замовчуванням',
-    persist: 'зберегти',
 
     // Navigation Commands
     go: 'перейти',

package/src/dictionaries/vi.ts

@@ -49,9 +49,7 @@ export const vi: Dictionary = {
     // Data Commands
     increment: 'tăng',
     decrement: 'giảm',
-    bind: 'ràng buộc',
     default: 'mặc định',
-    persist: 'duy trì',
 
     // Navigation Commands
     go: 'đi đến',

package/src/dictionaries/zh.ts

@@ -49,9 +49,7 @@ export const zh: Dictionary = {
     // Data Commands
     increment: '增加',
     decrement: '减少',
-    bind: '绑定',
     default: '默认',
-    persist: '持久化',
 
     // Navigation Commands
     go: '前往',

package/src/grammar/direct-mappings.ts

@@ -197,9 +197,7 @@ export const esPtMapping: DirectMapping = {
     transición: 'transição', // transition
     incrementar: 'incrementar', // increment
     decrementar: 'decrementar', // decrement
-    vincular: 'vincular', // bind
     predeterminar: 'padrão', // default
-    persistir: 'persistir', // persist
     ir: 'ir', // go
     copiar: 'copiar', // copy
     escoger: 'escolher', // pick

package/src/grammar/grammar.test.ts

@@ -1052,3 +1052,101 @@ describe('Has/Have Operator Translations', () => {
     }
   });
 });
+
+// =============================================================================
+// Possessive Dot Notation Translation Tests
+// =============================================================================
+
+describe('Possessive Dot Notation Translation', () => {
+  describe('my.property patterns across languages', () => {
+    it('should translate my.textContent to Spanish', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('mi.textContent');
+      expect(result).not.toContain('my.textContent');
+    });
+
+    it('should translate my.textContent to Japanese', () => {
+      const transformer = new GrammarTransformer('en', 'ja');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('私の.textContent');
+    });
+
+    it('should translate my.textContent to German', () => {
+      const transformer = new GrammarTransformer('en', 'de');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('mein.textContent');
+    });
+
+    it('should translate my.textContent to Korean', () => {
+      const transformer = new GrammarTransformer('en', 'ko');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('내.textContent');
+    });
+
+    it('should translate my.textContent to Chinese', () => {
+      const transformer = new GrammarTransformer('en', 'zh');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('我的.textContent');
+    });
+
+    it('should translate my.textContent to Turkish', () => {
+      const transformer = new GrammarTransformer('en', 'tr');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('benim.textContent');
+    });
+
+    it('should translate my.textContent to Arabic', () => {
+      const transformer = new GrammarTransformer('en', 'ar');
+      const result = transformer.transform('set my.textContent to "Done!"');
+      expect(result).toContain('لي.textContent');
+    });
+  });
+
+  describe('its.property and your.property patterns', () => {
+    it('should translate its.value to Spanish', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('get its.value');
+      expect(result).toContain('su.value');
+    });
+
+    it('should translate your.name to Spanish', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('log your.name');
+      expect(result).toContain('tu.name');
+    });
+  });
+
+  describe('pronoun dot notation (me., it., you.)', () => {
+    it('should translate me.textContent to Spanish', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('set me.textContent to "Done!"');
+      expect(result).toContain('mi.textContent');
+    });
+  });
+
+  describe('optional chaining (?.)', () => {
+    it('should translate my?.textContent to Spanish', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('log my?.textContent');
+      expect(result).toContain('mi?.textContent');
+    });
+  });
+
+  describe('chained access', () => {
+    it('should only translate the possessive prefix in my.value.toUpperCase()', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('put my.value.toUpperCase() into #output');
+      expect(result).toContain('mi.value.toUpperCase()');
+    });
+  });
+
+  describe('backward compatibility', () => {
+    it('should still translate space-separated possessives', () => {
+      const transformer = new GrammarTransformer('en', 'es');
+      const result = transformer.transform('set my textContent to "Done!"');
+      expect(result).toContain('mi');
+      expect(result).not.toMatch(/\bmy\b/);
+    });
+  });
+});

package/src/grammar/index.ts

@@ -37,6 +37,15 @@ export {
   indonesianProfile,
   quechuaProfile,
   swahiliProfile,
+  bengaliProfile,
+  italianProfile,
+  russianProfile,
+  ukrainianProfile,
+  vietnameseProfile,
+  hindiProfile,
+  tagalogProfile,
+  thaiProfile,
+  polishProfile,
 } from './profiles';
 
 // Direct language-pair translation