@lokascript/i18n 1.0.0

package/src/constants.ts

@@ -0,0 +1,366 @@
+// packages/i18n/src/constants.ts
+
+/**
+ * Shared Constants for i18n Package
+ *
+ * Centralizes keyword definitions to eliminate duplication across
+ * transformer.ts, create-provider.ts, and other modules.
+ */
+
+import type { SemanticRole } from './grammar/types';
+
+// =============================================================================
+// English Modifier → Semantic Role Mappings
+// =============================================================================
+
+/**
+ * Maps English modifier keywords to their semantic roles.
+ * Used by both the grammar transformer and keyword provider.
+ */
+export const ENGLISH_MODIFIER_ROLES: Readonly<Record<string, SemanticRole>> = {
+  to: 'destination',
+  into: 'destination',
+  from: 'source',
+  with: 'style',
+  by: 'quantity',
+  as: 'method',
+  on: 'event',
+  over: 'duration',
+  for: 'duration',
+} as const;
+
+/**
+ * English modifier keywords (derived from ENGLISH_MODIFIER_ROLES)
+ */
+export const ENGLISH_MODIFIERS: Set<string> = new Set([
+  'to',
+  'from',
+  'into',
+  'with',
+  'at',
+  'in',
+  'of',
+  'as',
+  'by',
+  'before',
+  'after',
+  'without',
+]);
+
+// =============================================================================
+// English Commands
+// =============================================================================
+
+/**
+ * English commands - the canonical set that the runtime understands.
+ */
+export const ENGLISH_COMMANDS: Set<string> = new Set([
+  'add',
+  'append',
+  'async',
+  'beep',
+  'break',
+  'call',
+  'continue',
+  'decrement',
+  'default',
+  'exit',
+  'fetch',
+  'for',
+  'get',
+  'go',
+  'halt',
+  'hide',
+  'if',
+  'increment',
+  'install',
+  'js',
+  'log',
+  'make',
+  'measure',
+  'morph',
+  'pick',
+  'process',
+  'push',
+  'put',
+  'remove',
+  'render',
+  'repeat',
+  'replace',
+  'return',
+  'send',
+  'set',
+  'settle',
+  'show',
+  'swap',
+  'take',
+  'tell',
+  'throw',
+  'toggle',
+  'transition',
+  'trigger',
+  'unless',
+  'wait',
+]);
+
+// =============================================================================
+// English Keywords (Non-Commands)
+// =============================================================================
+
+/**
+ * English keywords that are not commands.
+ */
+export const ENGLISH_KEYWORDS: Set<string> = new Set([
+  // Flow control
+  'then',
+  'else',
+  'end',
+  'and',
+  'or',
+  'not',
+  // Conditionals
+  'if',
+  'unless',
+  // Loops
+  'for',
+  'while',
+  'until',
+  'forever',
+  'times',
+  'each',
+  'index',
+  // Prepositions
+  'in',
+  'to',
+  'from',
+  'into',
+  'with',
+  'without',
+  'of',
+  'at',
+  'by',
+  // Conversion
+  'as',
+  // Comparison
+  'matches',
+  'contains',
+  'is',
+  'exists',
+  // Events
+  'on',
+  'when',
+  'every',
+  'event',
+  // Definitions
+  'init',
+  'def',
+  'behavior',
+  // Scope
+  'global',
+  'local',
+  // Articles
+  'the',
+  'a',
+  'an',
+  'first',
+  'last',
+  // Position
+  'start',
+  'before',
+  'after',
+]);
+
+// =============================================================================
+// Universal English Keywords (DOM/HTML Standards)
+// =============================================================================
+
+/**
+ * English keywords that should always be recognized, even in non-English locales.
+ * These are HTML/DOM standard terms that developers worldwide use.
+ */
+export const UNIVERSAL_ENGLISH_KEYWORDS: Set<string> = new Set([
+  // DOM events (HTML spec)
+  'click',
+  'dblclick',
+  'mousedown',
+  'mouseup',
+  'mouseenter',
+  'mouseleave',
+  'mouseover',
+  'mouseout',
+  'mousemove',
+  'keydown',
+  'keyup',
+  'keypress',
+  'focus',
+  'blur',
+  'change',
+  'input',
+  'submit',
+  'reset',
+  'load',
+  'unload',
+  'resize',
+  'scroll',
+  'touchstart',
+  'touchend',
+  'touchmove',
+  'touchcancel',
+  'dragstart',
+  'dragend',
+  'dragenter',
+  'dragleave',
+  'dragover',
+  'drop',
+  'contextmenu',
+  'wheel',
+  'pointerdown',
+  'pointerup',
+  'pointermove',
+  // Common abbreviations
+  'ms',
+  's',
+]);
+
+// =============================================================================
+// Logical Keywords
+// =============================================================================
+
+/**
+ * English logical operator keywords.
+ */
+export const ENGLISH_LOGICAL_KEYWORDS: Set<string> = new Set([
+  'and',
+  'or',
+  'not',
+  'is',
+  'exists',
+  'matches',
+  'contains',
+  'then',
+  'else',
+]);
+
+// =============================================================================
+// Value Keywords
+// =============================================================================
+
+/**
+ * English value keywords.
+ */
+export const ENGLISH_VALUE_KEYWORDS: Set<string> = new Set([
+  'true',
+  'false',
+  'null',
+  'undefined',
+  'it',
+  'me',
+  'my',
+  'result',
+]);
+
+// =============================================================================
+// Expression Keywords
+// =============================================================================
+
+/**
+ * English expression keywords - positional, traversal, and string operations.
+ */
+export const ENGLISH_EXPRESSION_KEYWORDS: Set<string> = new Set([
+  // Positional
+  'first',
+  'last',
+  'next',
+  'previous',
+  'prev',
+  'at',
+  'random',
+  // DOM traversal
+  'closest',
+  'parent',
+  'children',
+  'within',
+  // Emptiness/existence
+  'no',
+  'empty',
+  'some',
+  // String operations (multi-word)
+  'starts with',
+  'ends with',
+]);
+
+// =============================================================================
+// Conditional Keywords
+// =============================================================================
+
+/**
+ * Conditional keywords across languages (for statement type identification).
+ * Includes 'when'/'where' conditional modifiers and their translations.
+ */
+export const CONDITIONAL_KEYWORDS: Set<string> = new Set([
+  // English
+  'if',
+  'unless',
+  'when',
+  'where',
+  // Japanese
+  'もし',
+  '時に',
+  'ときに',
+  'どこで',
+  // Chinese
+  '如果',
+  '当',
+  // Arabic
+  'إذا',
+  'عندما',
+  'حيث',
+  // Spanish
+  'si',
+  'cuando',
+  'donde',
+  // German
+  'wenn',
+  'wann',
+  'wo',
+  // French
+  'quand',
+  'lorsque',
+  'où',
+  // Portuguese
+  'quando',
+  'onde',
+  // Turkish
+  'eğer',
+  'zaman',
+  'nerede',
+  // Indonesian
+  'ketika',
+  'saat',
+  'dimana',
+  // Korean
+  '때',
+  '어디서',
+  // Quechua
+  'maypi',
+  // Swahili
+  'wakati',
+  'wapi',
+]);
+
+/**
+ * "Then" keywords across languages (for conditional parsing).
+ */
+export const THEN_KEYWORDS: Set<string> = new Set([
+  'then',
+  'それから',
+  '那么',
+  'ثم',
+  'entonces',
+  'alors',
+  'dann',
+  'sonra',
+  'lalu',
+  'chayqa',
+  'kisha',
+]);

package/src/dictionaries/ar.ts

@@ -0,0 +1,233 @@
+// packages/i18n/src/dictionaries/ar.ts
+
+import { Dictionary } from '../types';
+
+export const ar: Dictionary = {
+  commands: {
+    // Event handling
+    on: 'على',
+    tell: 'أخبر',
+    trigger: 'تشغيل',
+    send: 'أرسل',
+
+    // DOM manipulation
+    take: 'خذ',
+    put: 'ضع',
+    set: 'اضبط',
+    get: 'احصل',
+    add: 'أضف',
+    remove: 'احذف',
+    toggle: 'بدل',
+    hide: 'اخف',
+    show: 'اظهر',
+
+    // Control flow
+    if: 'إذا',
+    unless: 'إلا إذا',
+    repeat: 'كرر',
+    for: 'لكل',
+    while: 'بينما',
+    until: 'حتى',
+    continue: 'واصل',
+    break: 'توقف',
+    halt: 'أوقف',
+
+    // Async
+    wait: 'انتظر',
+    fetch: 'احضر',
+    call: 'استدع',
+    return: 'ارجع',
+
+    // Other commands
+    make: 'اصنع',
+    log: 'سجل',
+    throw: 'ارم',
+    catch: 'التقط',
+    measure: 'قس',
+    transition: 'انتقال',
+
+    // Data Commands
+    increment: 'زِد',
+    decrement: 'أنقص',
+    bind: 'اربط',
+    default: 'افتراضي',
+    persist: 'احفظ',
+
+    // Navigation Commands
+    go: 'اذهب',
+    pushUrl: 'ادفع رابط',
+    replaceUrl: 'استبدل رابط',
+
+    // Utility Commands
+    copy: 'انسخ',
+    pick: 'اختر',
+    beep: 'صفّر',
+
+    // Advanced Commands
+    js: 'جافاسكربت',
+    async: 'متزامن',
+    render: 'ارسم',
+
+    // Animation Commands
+    swap: 'بدّل',
+    morph: 'حوّل',
+    settle: 'استقر',
+
+    // Content Commands
+    append: 'ألحق',
+
+    // Control Flow
+    exit: 'اخرج',
+
+    // Behaviors
+    install: 'ثبّت',
+  },
+
+  modifiers: {
+    to: 'إلى',
+    from: 'من',
+    into: 'في',
+    with: 'مع',
+    at: 'عند',
+    in: 'في',
+    of: 'من',
+    as: 'كـ',
+    by: 'بواسطة',
+    before: 'قبل',
+    after: 'بعد',
+    over: 'فوق',
+    under: 'تحت',
+    between: 'بين',
+    through: 'عبر',
+    without: 'بدون',
+  },
+
+  events: {
+    click: 'نقر',
+    dblclick: 'نقر مزدوج',
+    mousedown: 'فأرة أسفل',
+    mouseup: 'فأرة أعلى',
+    mouseenter: 'فأرة دخول',
+    mouseleave: 'فأرة خروج',
+    mouseover: 'فأرة فوق',
+    mouseout: 'فأرة خارج',
+    mousemove: 'فأرة تحرك',
+
+    keydown: 'مفتاح أسفل',
+    keyup: 'مفتاح أعلى',
+    keypress: 'مفتاح ضغط',
+
+    focus: 'تركيز',
+    blur: 'ضبابية',
+    change: 'تغيير',
+    input: 'إدخال',
+    submit: 'إرسال',
+    reset: 'إعادة تعيين',
+
+    load: 'تحميل',
+    unload: 'إلغاء تحميل',
+    resize: 'تغيير حجم',
+    scroll: 'تمرير',
+
+    touchstart: 'بداية لمس',
+    touchend: 'نهاية لمس',
+    touchmove: 'تحرك لمس',
+    touchcancel: 'إلغاء لمس',
+  },
+
+  logical: {
+    when: 'عندما',
+    where: 'أين',
+    and: 'و',
+    or: 'أو',
+    not: 'ليس',
+    is: 'هو',
+    exists: 'موجود',
+    matches: 'يطابق',
+    contains: 'يحتوي',
+    includes: 'يشمل',
+    equals: 'يساوي',
+    has: 'لديه', // third-person: he/it has
+    have: 'لدي', // first-person: I have
+    then: 'ثم',
+    else: 'وإلا',
+    otherwise: 'خلاف ذلك',
+    end: 'النهاية',
+  },
+
+  temporal: {
+    seconds: 'ثوانِ',
+    second: 'ثانية',
+    milliseconds: 'ميلي ثانية',
+    millisecond: 'ميلي ثانية',
+    minutes: 'دقائق',
+    minute: 'دقيقة',
+    hours: 'ساعات',
+    hour: 'ساعة',
+    ms: 'م.ث',
+    s: 'ث',
+    min: 'د',
+    h: 'س',
+  },
+
+  values: {
+    true: 'صحيح',
+    false: 'خطأ',
+    null: 'فارغ',
+    undefined: 'غير معرف',
+    it: 'هو',
+    its: 'له', // REVIEW: native speaker
+    me: 'أنا',
+    my: 'لي',
+    myself: 'نفسي',
+    you: 'أنت', // REVIEW: native speaker
+    your: 'لك', // REVIEW: native speaker
+    yourself: 'نفسك', // REVIEW: native speaker
+    element: 'عنصر',
+    target: 'هدف',
+    detail: 'تفاصيل',
+    event: 'حدث',
+    window: 'نافذة',
+    document: 'وثيقة',
+    body: 'جسم',
+    result: 'نتيجة',
+    value: 'قيمة',
+  },
+
+  attributes: {
+    class: 'فئة',
+    classes: 'فئات',
+    style: 'أسلوب',
+    styles: 'أساليب',
+    attribute: 'خاصية',
+    attributes: 'خصائص',
+    property: 'خاصية',
+    properties: 'خصائص',
+  },
+
+  expressions: {
+    // Positional
+    first: 'أول',
+    last: 'آخر',
+    next: 'التالي',
+    previous: 'السابق',
+    prev: 'سابق',
+    at: 'عند',
+    random: 'عشوائي',
+
+    // DOM Traversal
+    closest: 'الأقرب',
+    parent: 'والد',
+    children: 'أطفال',
+    within: 'داخل',
+
+    // Emptiness/Existence
+    no: 'لا يوجد',
+    empty: 'فارغ',
+    some: 'بعض',
+
+    // String operations
+    'starts with': 'يبدأ بـ',
+    'ends with': 'ينتهي بـ',
+  },
+};