@lokascript/i18n 2.3.0 → 2.4.0

package/src/dictionaries/uk.ts

@@ -1,21 +1,14 @@
-/**
- * Ukrainian Dictionary
- *
- * Translations for Ukrainian language support.
- * Uses infinitive verbs (common in software UIs).
- */
+// Generated/merged from semantic profiles — hand-written entries are preserved
+// To add derived entries, update the semantic profile and run: npm run generate:language-assets
 
 import { Dictionary } from '../types';
 
 export const ukrainianDictionary: Dictionary = {
   commands: {
-    // Event handling
     on: 'при',
     tell: 'сказати',
     trigger: 'викликати',
     send: 'надіслати',
-
-    // DOM manipulation
     take: 'взяти',
     put: 'покласти',
     set: 'встановити',
@@ -25,8 +18,6 @@ export const ukrainianDictionary: Dictionary = {
     toggle: 'перемкнути',
     hide: 'сховати',
     show: 'показати',
-
-    // Control flow
     if: 'якщо',
     unless: 'якщо_не',
     repeat: 'повторити',
@@ -36,65 +27,46 @@ export const ukrainianDictionary: Dictionary = {
     continue: 'продовжити',
     break: 'перервати',
     halt: 'зупинити',
-
-    // Async
     wait: 'чекати',
     fetch: 'завантажити',
     call: 'викликати',
     return: 'повернути',
-
-    // Other commands
     make: 'створити',
     log: 'записати',
     throw: 'кинути',
     catch: 'зловити',
     measure: 'виміряти',
     transition: 'анімувати',
-
-    // Data Commands
     increment: 'збільшити',
     decrement: 'зменшити',
     default: 'за_замовчуванням',
-
-    // Navigation Commands
     go: 'перейти',
     pushUrl: 'додати_url',
     replaceUrl: 'замінити_url',
-
-    // Utility Commands
     copy: 'копіювати',
     pick: 'вибрати',
     beep: 'звук',
-
-    // Advanced Commands
     js: 'js',
     async: 'асинхронно',
     render: 'відобразити',
-
-    // Animation Commands
     swap: 'поміняти',
     morph: 'трансформувати',
     settle: 'стабілізувати',
-
-    // Content Commands
     append: 'додати_в_кінець',
-
-    // Control Flow
     exit: 'вийти',
     else: 'інакше',
-
-    // Behaviors
     install: 'встановити',
     init: 'ініціалізувати',
     behavior: 'поведінка',
-
-    // Focus
     focus: 'сфокусувати',
     blur: 'розфокусувати',
-
-    // Clone
     clone: 'клонувати',
     prepend: 'додати_на_початок',
+    breakpoint: 'точка-зупинки',
+    clear: 'очистити',
+    close: 'закрити',
+    open: 'відкрити',
+    select: 'вибрати',
   },
 
   modifiers: {
@@ -127,23 +99,19 @@ export const ukrainianDictionary: Dictionary = {
     mouseover: 'наведення',
     mouseout: 'відведення',
     mousemove: 'рух_миші',
-
     keydown: 'клавіша_вниз',
     keyup: 'клавіша_вгору',
     keypress: 'натискання_клавіші',
-
     focus: 'фокус',
     blur: 'розфокус',
     change: 'зміна',
     input: 'введення',
     submit: 'надсилання',
     reset: 'скидання',
-
     load: 'завантаження',
     unload: 'вивантаження',
     resize: 'зміна_розміру',
     scroll: 'прокрутка',
-
     touchstart: 'дотик_початок',
     touchend: 'дотик_кінець',
     touchmove: 'дотик_рух',
@@ -166,8 +134,10 @@ export const ukrainianDictionary: Dictionary = {
     else: 'інакше',
     otherwise: 'в_іншому_випадку',
     end: 'кінець',
-    has: 'має', // third-person: він/вона має
-    have: 'маю', // first-person: я маю
+    live: 'живий',
+    changes: 'змінюється',
+    has: 'має',
+    have: 'маю',
     isNot: 'не_є',
     empty: 'порожній',
   },
@@ -241,7 +211,6 @@ export const ukrainianDictionary: Dictionary = {
   },
 
   expressions: {
-    // Positional
     first: 'перший',
     last: 'останній',
     next: 'наступний',
@@ -249,20 +218,21 @@ export const ukrainianDictionary: Dictionary = {
     prev: 'попер',
     at: 'в',
     random: 'випадковий',
-
-    // DOM Traversal
     closest: 'найближчий',
     parent: 'батьківський',
     children: 'діти',
     within: 'всередині',
-
-    // Emptiness/Existence
     no: 'ні',
     empty: 'порожній',
     some: 'деякі',
-
-    // String operations
     'starts with': 'починається_з',
     'ends with': 'закінчується_на',
+    'ignoring case': 'без_урахування_регістру',
+    'sorted by': 'відсортовано_за',
+    'mapped to': 'перетворено_на',
+    'split by': 'розділено_за',
+    'joined by': "об'єднано_через",
   },
 };
+
+export const uk = ukrainianDictionary;

package/src/dictionaries/vi.ts

@@ -62,6 +62,11 @@ export const vi: Dictionary = {
     clone: 'sao chép',
     prepend: 'thêm đầu',
     else: 'không thì',
+    breakpoint: 'điểm-dừng',
+    clear: 'xóa',
+    close: 'đóng',
+    open: 'mở',
+    select: 'chọn',
   },
 
   modifiers: {
@@ -79,6 +84,7 @@ export const vi: Dictionary = {
     in: 'trong',
     at: 'tại',
     of: 'của',
+    between: 'giữa',
     the: '',
     times: 'lần',
   },
@@ -98,6 +104,7 @@ export const vi: Dictionary = {
     mouseleave: 'chuột rời',
     focus: 'tập trung',
     blur: 'mất tập trung',
+    reset: 'đặt-lại',
     load: 'tải',
     scroll: 'cuộn',
     resize: 'đổi kích thước',
@@ -123,6 +130,8 @@ export const vi: Dictionary = {
     else: 'không thì',
     end: 'kết thúc',
     then: 'rồi',
+    live: 'trực tiếp',
+    changes: 'thay đổi',
   },
 
   temporal: {
@@ -191,5 +200,13 @@ export const vi: Dictionary = {
     parent: 'cha',
     children: 'con',
     closest: 'gần nhất',
+    empty: 'làm-rỗng',
+    'starts with': 'bắt đầu bằng',
+    'ends with': 'kết thúc bằng',
+    'ignoring case': 'không phân biệt hoa thường',
+    'sorted by': 'sắp xếp theo',
+    'mapped to': 'ánh xạ thành',
+    'split by': 'tách bởi',
+    'joined by': 'nối bởi',
   },
 };

package/src/dictionaries/zh.ts

@@ -1,16 +1,14 @@
-// packages/i18n/src/dictionaries/zh.ts
+// Generated/merged from semantic profiles — hand-written entries are preserved
+// To add derived entries, update the semantic profile and run: npm run generate:language-assets
 
 import { Dictionary } from '../types';
 
 export const zh: Dictionary = {
   commands: {
-    // Event handling
     on: '当',
     tell: '告诉',
     trigger: '触发',
     send: '发送',
-
-    // DOM manipulation
     take: '获取',
     put: '放置',
     set: '设置',
@@ -20,8 +18,6 @@ export const zh: Dictionary = {
     toggle: '切换',
     hide: '隐藏',
     show: '显示',
-
-    // Control flow
     if: '如果',
     unless: '除非',
     repeat: '重复',
@@ -31,54 +27,41 @@ export const zh: Dictionary = {
     continue: '继续',
     break: '中断',
     halt: '停止',
-
-    // Async
     wait: '等待',
     fetch: '获取',
     call: '调用',
     return: '返回',
-
-    // Other commands
     make: '制作',
     log: '日志',
     throw: '抛出',
     catch: '捕获',
     measure: '测量',
     transition: '过渡',
-
-    // Data Commands
     increment: '增加',
     decrement: '减少',
     default: '默认',
-
-    // Navigation Commands
     go: '前往',
     pushUrl: '推送网址',
     replaceUrl: '替换网址',
-
-    // Utility Commands
     copy: '复制',
     pick: '选取',
     beep: '蜂鸣',
-
-    // Advanced Commands
     js: 'JS执行',
     async: '异步',
     render: '渲染',
-
-    // Animation Commands
     swap: '交换',
     morph: '变形',
     settle: '稳定',
-
-    // Content Commands
     append: '追加',
-
-    // Control Flow
     exit: '退出',
-
-    // Behaviors
     install: '安装',
+    breakpoint: '断点',
+    clear: '清除',
+    close: '关闭',
+    open: '打开',
+    select: '选择',
+    clone: '克隆',
+    prepend: '前置',
   },
 
   modifiers: {
@@ -110,23 +93,19 @@ export const zh: Dictionary = {
     mouseover: '鼠标悬停',
     mouseout: '鼠标移出',
     mousemove: '鼠标移动',
-
     keydown: '按键按下',
     keyup: '按键抬起',
     keypress: '按键',
-
     focus: '聚焦',
     blur: '失焦',
     change: '改变',
     input: '输入',
     submit: '提交',
     reset: '重置',
-
     load: '加载',
     unload: '卸载',
     resize: '调整大小',
     scroll: '滚动',
-
     touchstart: '触摸开始',
     touchend: '触摸结束',
     touchmove: '触摸移动',
@@ -145,12 +124,14 @@ export const zh: Dictionary = {
     contains: '包含',
     includes: '包括',
     equals: '等于',
-    has: '有', // universal "have"
-    have: '有', // same character for first/third person
+    has: '有',
+    have: '有',
     then: '那么',
     else: '否则',
     otherwise: '要不然',
     end: '结束',
+    live: '实时',
+    changes: '改变时',
   },
 
   temporal: {
@@ -174,13 +155,13 @@ export const zh: Dictionary = {
     null: '空',
     undefined: '未定义',
     it: '它',
-    its: '它的', // REVIEW: native speaker
+    its: '它的',
     me: '我',
     my: '我的',
     myself: '我自己',
-    you: '你', // REVIEW: native speaker
-    your: '你的', // REVIEW: native speaker
-    yourself: '你自己', // REVIEW: native speaker
+    you: '你',
+    your: '你的',
+    yourself: '你自己',
     element: '元素',
     target: '目标',
     detail: '详情',
@@ -204,7 +185,6 @@ export const zh: Dictionary = {
   },
 
   expressions: {
-    // Positional
     first: '第一个',
     last: '最后一个',
     next: '下一个',
@@ -212,20 +192,19 @@ export const zh: Dictionary = {
     prev: '上个',
     at: '在',
     random: '随机',
-
-    // DOM Traversal
     closest: '最近的',
     parent: '父级',
     children: '子级',
     within: '之内',
-
-    // Emptiness/Existence
     no: '没有',
     empty: '空的',
     some: '一些',
-
-    // String operations
     'starts with': '以开头',
     'ends with': '以结尾',
+    'ignoring case': '忽略大小写',
+    'sorted by': '按_排序',
+    'mapped to': '映射为',
+    'split by': '按_分割',
+    'joined by': '用_连接',
   },
 };

package/src/grammar/grammar.test.ts

@@ -40,30 +40,37 @@ import type { ParsedElement, SemanticRole } from './types';
 describe('Language Profiles', () => {
   it('should have profiles for all supported locales', () => {
     const locales = getSupportedLocales();
-    expect(locales).toContain('en');
-    expect(locales).toContain('ja');
-    expect(locales).toContain('ko');
-    expect(locales).toContain('zh');
-    expect(locales).toContain('ar');
-    expect(locales).toContain('tr');
-    expect(locales).toContain('es');
-    expect(locales).toContain('de');
-    expect(locales).toContain('fr');
-    expect(locales).toContain('pt');
-    expect(locales).toContain('id');
-    expect(locales).toContain('qu');
-    expect(locales).toContain('sw');
-    expect(locales).toContain('bn');
-    // New languages added
-    expect(locales).toContain('it');
-    expect(locales).toContain('ru');
-    expect(locales).toContain('uk');
-    expect(locales).toContain('vi');
-    expect(locales).toContain('hi');
-    expect(locales).toContain('tl');
-    expect(locales).toContain('th');
-    expect(locales).toContain('pl');
-    expect(locales.length).toBe(22);
+    // Explicit expected list — when adding a profile, append it here so the
+    // count assertion stays meaningful without becoming a magic number.
+    const expectedLocales = [
+      'en',
+      'ja',
+      'ko',
+      'zh',
+      'ar',
+      'tr',
+      'es',
+      'de',
+      'fr',
+      'pt',
+      'id',
+      'qu',
+      'sw',
+      'bn',
+      'it',
+      'ru',
+      'uk',
+      'vi',
+      'hi',
+      'tl',
+      'th',
+      'pl',
+      'he',
+    ];
+    for (const code of expectedLocales) {
+      expect(locales, `missing profile: ${code}`).toContain(code);
+    }
+    expect(locales.length).toBe(expectedLocales.length);
   });
 
   it('should return undefined for unknown locales', () => {
@@ -1149,4 +1156,116 @@ describe('Possessive Dot Notation Translation', () => {
       expect(result).not.toMatch(/\bmy\b/);
     });
   });
+
+  // ──── Reactive `live` block scope ────
+  // Before this fix, the splitter cut between `live` and the body's
+  // first command keyword, then the join logic re-inserted the target
+  // language's `then` keyword between them. E.g.
+  //   `live put X into me end` (en→de) became
+  //   `live dann setzen X zu ich ende` (spurious `dann`).
+  // The fix tracks block depth from `live` to its matching `end` and
+  // suppresses splits inside that scope.
+  describe('live block does not spuriously inject "then"', () => {
+    const cases: Array<[string, string, RegExp]> = [
+      // [target lang, input, banned pattern]
+      ['de', 'live put $count into me end', /\bdann\b/i],
+      ['es', 'live put $count into me end', /\bentonces\b/i],
+      ['ja', 'live put $count into me end', /それから/],
+      ['tr', 'live put $count into me end', /\bsonra\b/i],
+      ['it', 'live put $count into me end', /\ballora\b/i],
+      ['ru', 'live put $count into me end', /\bзатем\b/i],
+      ['vi', 'live put $count into me end', /\brồi\b/i],
+    ];
+
+    for (const [target, input, banned] of cases) {
+      it(`(${target}) does not inject "then" inside the body`, () => {
+        const transformer = new GrammarTransformer('en', target);
+        const result = transformer.transform(input);
+        expect(result, `unexpected ${banned} in: ${result}`).not.toMatch(banned);
+      });
+    }
+
+    it('keeps live body as one unit — no `live then` artifact', () => {
+      const transformer = new GrammarTransformer('en', 'en');
+      const result = transformer.transform('live put $count into me end');
+      expect(result).not.toMatch(/live\s+then\b/i);
+      expect(result).toMatch(/^live\b/);
+      expect(result).toMatch(/\bend$/);
+    });
+
+    it('still splits on explicit "then" OUTSIDE the live block', () => {
+      // Legitimate `then`-based chains MUST still split.
+      const transformer = new GrammarTransformer('en', 'de');
+      const result = transformer.transform('live put $x into me end then toggle .active');
+      // German "then" = "dann" — appears exactly once (between block + toggle).
+      const occurrences = (result.match(/\bdann\b/gi) || []).length;
+      expect(occurrences).toBe(1);
+    });
+  });
+
+  // ──── Block extraction for `when`, `unless`, and SOV `live` ────
+  // Block-syntactic tokens are pulled out before parseStatement so
+  // they don't end up as command verbs (`live` → action role) or get
+  // swept into role values (`end` → destination tail). The body
+  // recurses through the regular pipeline, which keeps SOV reorder
+  // working *inside* the body without disturbing the block frame.
+  describe('reactive blocks — when/unless/live block extraction', () => {
+    it('`when X changes Y` does not truncate — body is translated (en→de)', () => {
+      const t = new GrammarTransformer('en', 'de');
+      const result = t.transform('when $count changes log $count');
+      // Pre-fix output was just `wenn` (parseConditional returned only
+      // the action role). Now we should see head + body translated.
+      expect(result.length).toBeGreaterThan('wenn'.length + 5);
+      expect(result).toMatch(/wenn/i);
+      expect(result).toMatch(/protokolliere|log/i);
+      expect(result).toMatch(/ändert|changes/i);
+    });
+
+    it('`unless X Y` does not truncate — body is translated (en→de)', () => {
+      const t = new GrammarTransformer('en', 'de');
+      const result = t.transform('unless $disabled add .ready to me');
+      expect(result.length).toBeGreaterThan('wennnicht'.length + 5);
+      expect(result).toMatch(/wennnicht|unless/i);
+      expect(result).toMatch(/hinzufüg|add/i);
+    });
+
+    it('`live X end` keeps live at start and end at end (SOV: ja)', () => {
+      const t = new GrammarTransformer('en', 'ja');
+      const result = t.transform('live put $count into me end');
+      // Block frame: head first, tail last. Pre-fix the SOV reorder
+      // dragged `live` to the end as if it were the action verb.
+      expect(result).toMatch(/^(live|ライブ)/);
+      expect(result).toMatch(/(end|終わり)$/);
+      // SOV reorder applies inside the body — destination marker に
+      // should appear, indicating `me` was reordered with its postposition.
+      expect(result).toMatch(/に/);
+    });
+
+    it('`live X end` keeps live at start and end at end (SOV: tr)', () => {
+      const t = new GrammarTransformer('en', 'tr');
+      const result = t.transform('live put $count into me end');
+      expect(result).toMatch(/^(live|canlı)/i);
+      expect(result).toMatch(/(end|son)$/i);
+    });
+
+    it('regression: `if X then Y end` still works (no block extraction)', () => {
+      // `if` is intentionally not a BLOCK_HEAD_KEYWORD — splitOnThen +
+      // parseConditional already handle it. Verify we didn't regress.
+      const t = new GrammarTransformer('en', 'de');
+      const result = t.transform('if $x then increment $count end');
+      expect(result).toMatch(/wenn|if/i);
+      expect(result).toMatch(/dann|then/i);
+      expect(result).toMatch(/erhöh|increment/i);
+    });
+
+    it('regression: `live X end then toggle .y` — exactly one "then" connector', () => {
+      // Splitter must still recognize the `then` *outside* the live
+      // block as a statement boundary, even now that we route blocks
+      // around parseStatement.
+      const t = new GrammarTransformer('en', 'de');
+      const result = t.transform('live put $x into me end then toggle .active');
+      const danns = (result.match(/\bdann\b/gi) || []).length;
+      expect(danns).toBe(1);
+    });
+  });
 });

package/src/grammar/index.ts

@@ -46,6 +46,7 @@ export {
   tagalogProfile,
   thaiProfile,
   polishProfile,
+  hebrewProfile,
 } from './profiles';
 
 // Direct language-pair translation

package/src/grammar/profiles/index.ts

@@ -826,6 +826,36 @@ export const polishProfile: LanguageProfile = {
   ],
 };
 
+// =============================================================================
+// Hebrew (SVO, RTL, Prepositions)
+// =============================================================================
+
+export const hebrewProfile: LanguageProfile = {
+  code: 'he',
+  name: 'עברית',
+
+  wordOrder: 'SVO', // Modern Hebrew is predominantly SVO (Biblical Hebrew was VSO)
+  adpositionType: 'preposition',
+  morphology: 'fusional', // Root-and-pattern (Semitic), like Arabic
+  direction: 'rtl',
+
+  canonicalOrder: ['event', 'action', 'patient', 'destination'],
+
+  // Hebrew uses single-letter prefix prepositions (ב, ל, מ, כ) that attach to
+  // the following word. For tokenization we treat them as spaced forms.
+  markers: [
+    { form: 'ב', role: 'event', position: 'preposition', required: true },
+    { form: 'על', role: 'destination', position: 'preposition', required: false },
+    { form: 'אל', role: 'destination', position: 'preposition', required: false },
+    { form: 'ל', role: 'destination', position: 'preposition', required: false },
+    { form: 'את', role: 'patient', position: 'preposition', required: false }, // Direct object marker
+    { form: 'מ', role: 'source', position: 'preposition', required: false },
+    { form: 'מן', role: 'source', position: 'preposition', required: false },
+    { form: 'עם', role: 'style', position: 'preposition', required: false },
+    { form: 'כ', role: 'method', position: 'preposition', required: false },
+  ],
+};
+
 // =============================================================================
 // Profile Registry
 // =============================================================================
@@ -854,6 +884,7 @@ export const profiles: Record<string, LanguageProfile> = {
   tl: tagalogProfile,
   th: thaiProfile,
   pl: polishProfile,
+  he: hebrewProfile,
 };
 
 export function getProfile(locale: string): LanguageProfile | undefined {