@lokascript/i18n 1.3.0 → 2.0.0

package/src/grammar/transformer.ts

@@ -19,70 +19,22 @@ import { getProfile, profiles } from './profiles';
 import { hasDirectMapping, getDirectMapping } from './direct-mappings';
 import { dictionaries } from '../dictionaries';
 import { findInDictionary, translateFromEnglish } from '../types';
-import { ENGLISH_MODIFIER_ROLES, CONDITIONAL_KEYWORDS, THEN_KEYWORDS } from '../constants';
+import {
+  ENGLISH_MODIFIER_ROLES,
+  ENGLISH_COMMANDS,
+  CONDITIONAL_KEYWORDS,
+  THEN_KEYWORDS,
+} from '../constants';
 
 // =============================================================================
 // Compound Statement Handling
 // =============================================================================
 
-/**
- * English commands that can start a new statement.
- * Used to detect command boundaries in space-chained statements.
- */
-const COMMAND_KEYWORDS = 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',
-]);
-
 /**
  * Get all command keywords including translated ones for a locale.
  */
 function getCommandKeywordsForLocale(locale: string): Set<string> {
-  const keywords = new Set(COMMAND_KEYWORDS);
+  const keywords = new Set(ENGLISH_COMMANDS);
 
   // Add translated command keywords from dictionaries
   const dict = dictionaries[locale];
@@ -119,7 +71,7 @@ function splitCompoundStatement(input: string, sourceLocale: string): string[] {
 
   // If we have multiple lines, treat each as a separate part
   // (but still need to handle "then" within each line)
-  let parts: string[] = [];
+  const parts: string[] = [];
 
   for (const line of lines) {
     const lineParts = splitOnThen(line, sourceLocale);
@@ -298,6 +250,21 @@ function reconstructWithLineStructure(
  * - "on <event> <command>" stays together (event handler with first command)
  * - Modifiers like "to", "from" don't trigger splits
  */
+/** Modifier keywords that should not trigger command boundary splits */
+const BOUNDARY_MODIFIERS = new Set([
+  'to',
+  'into',
+  'from',
+  'with',
+  'by',
+  'as',
+  'at',
+  'in',
+  'on',
+  'of',
+  'over',
+]);
+
 function splitOnCommandBoundaries(input: string, sourceLocale: string): string[] {
   const commandKeywords = getCommandKeywordsForLocale(sourceLocale);
   const tokens = input.split(/\s+/);
@@ -325,21 +292,6 @@ function splitOnCommandBoundaries(input: string, sourceLocale: string): string[]
       const prevToken = currentPart[currentPart.length - 1];
       const prevLower = prevToken.toLowerCase();
 
-      // Don't split if the previous token is a modifier like "to", "from", "by", etc.
-      const modifiers = new Set([
-        'to',
-        'into',
-        'from',
-        'with',
-        'by',
-        'as',
-        'at',
-        'in',
-        'on',
-        'of',
-        'over',
-      ]);
-
       // For event handlers: don't split before the first command
       // E.g., "on click wait 1s" should stay together
       if (!seenFirstCommand) {
@@ -349,7 +301,7 @@ function splitOnCommandBoundaries(input: string, sourceLocale: string): string[]
         continue;
       }
 
-      if (!modifiers.has(prevLower) && !commandKeywords.has(prevLower)) {
+      if (!BOUNDARY_MODIFIERS.has(prevLower) && !commandKeywords.has(prevLower)) {
         // This looks like a command boundary - save current part and start new one
         parts.push(currentPart.join(' '));
         currentPart = [token];
@@ -693,7 +645,28 @@ function parseEventHandler(tokens: string[], profile: LanguageProfile): ParsedSt
     startIndex++;
   }
 
-  // Next token is typically the action
+  // Check for event source modifier before the action (e.g., "from #source" in "on input from #firstName set ...")
+  // Only handle 'from' (event source) — other modifiers like circumfix markers (Chinese 时) should not be consumed.
+  if (tokens[startIndex] && tokens[startIndex].toLowerCase() === 'from' && tokens[startIndex + 1]) {
+    startIndex++; // skip 'from'
+    // Collect source value tokens until a command keyword is found
+    const sourceValue: string[] = [];
+    while (tokens[startIndex]) {
+      if (ENGLISH_COMMANDS.has(tokens[startIndex].toLowerCase())) break;
+      sourceValue.push(tokens[startIndex]);
+      startIndex++;
+    }
+    if (sourceValue.length > 0) {
+      const value = sourceValue.join(' ');
+      roles.set('source', {
+        role: 'source',
+        value,
+        isSelector: /^[#.<@]/.test(value),
+      });
+    }
+  }
+
+  // Next token is the action (command verb)
   if (tokens[startIndex]) {
     roles.set('action', {
       role: 'action',
@@ -948,10 +921,77 @@ function translatePossessive(token: string, sourceLocale: string, targetLocale:
   }
 }
 
+// =============================================================================
+// Possessive Dot Notation
+// =============================================================================
+
+/**
+ * Regex to match possessive dot notation patterns.
+ * Matches: my.prop, its.prop, your.prop, me.prop, it.prop, you.prop
+ * Also matches optional chaining: my?.prop, me?.prop, etc.
+ */
+const POSSESSIVE_DOT_REGEX = /^(my|its|your|me|it|you)(\??\..+)$/i;
+
+/**
+ * Map pronoun forms to possessive adjective forms for dictionary lookup.
+ */
+const POSSESSIVE_DOT_PRONOUNS: Record<string, string> = {
+  me: 'my',
+  it: 'its',
+  you: 'your',
+  my: 'my',
+  its: 'its',
+  your: 'your',
+};
+
+/**
+ * Translate possessive dot notation like my.textContent → mi.textContent.
+ * Handles both possessive adjective forms (my, its, your) and pronoun forms (me, it, you).
+ * Also handles optional chaining (my?.prop).
+ * Returns null if the value doesn't match or no translation is available.
+ */
+function translatePossessiveDotNotation(
+  value: string,
+  sourceLocale: string,
+  targetLocale: string
+): string | null {
+  const match = value.match(POSSESSIVE_DOT_REGEX);
+  if (!match) return null;
+
+  const possessiveWord = match[1].toLowerCase();
+  const propertySuffix = match[2]; // ".textContent" or "?.textContent"
+
+  // Normalize to possessive adjective form for dictionary lookup
+  const possessiveKey = POSSESSIVE_DOT_PRONOUNS[possessiveWord] || possessiveWord;
+  const translated = translateWord(possessiveKey, sourceLocale, targetLocale);
+
+  // Skip if translation is multi-word (can't prefix dot notation)
+  if (translated.includes(' ')) return null;
+
+  if (translated !== possessiveKey) {
+    return translated + propertySuffix;
+  }
+
+  // Try original pronoun form if different from possessive key
+  if (possessiveWord !== possessiveKey) {
+    const alt = translateWord(possessiveWord, sourceLocale, targetLocale);
+    if (alt !== possessiveWord && !alt.includes(' ')) {
+      return alt + propertySuffix;
+    }
+  }
+
+  return null;
+}
+
+// =============================================================================
+// Multi-Word Value Translation
+// =============================================================================
+
 /**
  * Translate a multi-word value, translating each word individually.
  * Handles possessives like "my value" → "mi valor" in Spanish.
  * Also handles 's possessive syntax like "me's value" → "mi valor".
+ * Also handles possessive dot notation like "my.textContent" → "mi.textContent".
  */
 function translateMultiWordValue(
   value: string,
@@ -964,6 +1004,10 @@ function translateMultiWordValue(
     if (value.includes("'s")) {
       return translatePossessive(value, sourceLocale, targetLocale);
     }
+    // Check for possessive dot notation (my.prop, its.prop, me.prop, etc.)
+    const dotResult = translatePossessiveDotNotation(value, sourceLocale, targetLocale);
+    if (dotResult !== null) return dotResult;
+
     return translateWord(value, sourceLocale, targetLocale);
   }
 
@@ -1020,6 +1064,14 @@ function translateMultiWordValue(
       continue;
     }
 
+    // Check for possessive dot notation (my.prop, its.prop, me.prop, etc.)
+    const dotResult = translatePossessiveDotNotation(word, sourceLocale, targetLocale);
+    if (dotResult !== null) {
+      translated.push(dotResult);
+      i++;
+      continue;
+    }
+
     translated.push(translateWord(word, sourceLocale, targetLocale));
     i++;
   }

package/src/index.ts

@@ -53,6 +53,16 @@ export {
   qu,
   sw,
   pt,
+  it,
+  vi,
+  pl,
+  ru,
+  uk,
+  hi,
+  bn,
+  th,
+  ms,
+  tl,
   supportedLocales,
   isLocaleSupported,
   getDictionary,
@@ -95,6 +105,26 @@ export {
   swDictionary,
   ptKeywords,
   ptDictionary,
+  itKeywords,
+  itDictionary,
+  viKeywords,
+  viDictionary,
+  plKeywords,
+  plDictionary,
+  ruKeywords,
+  ruDictionary,
+  ukKeywords,
+  ukDictionary,
+  hiKeywords,
+  hiDictionary,
+  bnKeywords,
+  bnDictionary,
+  thKeywords,
+  thDictionary,
+  msKeywords,
+  msDictionary,
+  tlKeywords,
+  tlDictionary,
   // Locale management
   LocaleManager,
   detectBrowserLocale,

package/src/parser/ar.ts

@@ -26,7 +26,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { arKeywords } from '@lokascript/i18n/parser/ar';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: arKeywords });
  * parser.parse('على نقر بدل .active');

package/src/parser/bn.ts

@@ -0,0 +1,9 @@
+import { bn } from '../dictionaries/bn';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const bnKeywords: KeywordProvider = createKeywordProvider(bn, 'bn', {
+  allowEnglishFallback: true,
+});
+
+export { bn as bnDictionary } from '../dictionaries/bn';

package/src/parser/de.ts

@@ -22,7 +22,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { deKeywords } from '@lokascript/i18n/parser/de';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: deKeywords });
  * parser.parse('bei klick umschalten .active');

package/src/parser/es.ts

@@ -17,7 +17,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n/parser/es';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: esKeywords });
  * parser.parse('en clic alternar .active');

package/src/parser/fr.ts

@@ -17,7 +17,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { frKeywords } from '@lokascript/i18n/parser/fr';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: frKeywords });
  * parser.parse('sur clic basculer .active');

package/src/parser/hi.ts

@@ -0,0 +1,9 @@
+import { hindiDictionary } from '../dictionaries/hi';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const hiKeywords: KeywordProvider = createKeywordProvider(hindiDictionary, 'hi', {
+  allowEnglishFallback: true,
+});
+
+export { hindiDictionary as hiDictionary } from '../dictionaries/hi';

package/src/parser/id.ts

@@ -20,7 +20,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { idKeywords } from '@lokascript/i18n/parser/id';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: idKeywords });
  * parser.parse('pada klik ganti .active');

package/src/parser/index.ts

@@ -45,6 +45,16 @@ export { idKeywords, idDictionary } from './id';
 export { quKeywords, quDictionary } from './qu';
 export { swKeywords, swDictionary } from './sw';
 export { ptKeywords, ptDictionary } from './pt';
+export { itKeywords, itDictionary } from './it';
+export { viKeywords, viDictionary } from './vi';
+export { plKeywords, plDictionary } from './pl';
+export { ruKeywords, ruDictionary } from './ru';
+export { ukKeywords, ukDictionary } from './uk';
+export { hiKeywords, hiDictionary } from './hi';
+export { bnKeywords, bnDictionary } from './bn';
+export { thKeywords, thDictionary } from './th';
+export { msKeywords, msDictionary } from './ms';
+export { tlKeywords, tlDictionary } from './tl';
 
 // Locale management
 export { LocaleManager, detectBrowserLocale } from './locale-manager';

package/src/parser/it.ts

@@ -0,0 +1,9 @@
+import { it } from '../dictionaries/it';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const itKeywords: KeywordProvider = createKeywordProvider(it, 'it', {
+  allowEnglishFallback: true,
+});
+
+export { it as itDictionary } from '../dictionaries/it';

package/src/parser/ja.ts

@@ -22,7 +22,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { jaKeywords } from '@lokascript/i18n/parser/ja';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: jaKeywords });
  * parser.parse('クリック で 切り替え .active');

package/src/parser/ko.ts

@@ -23,7 +23,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { koKeywords } from '@lokascript/i18n/parser/ko';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: koKeywords });
  * parser.parse('에 클릭 토글 .active');

package/src/parser/locale-manager.ts

@@ -169,7 +169,7 @@ export class LocaleManager {
  * @example
  * ```typescript
  * import { detectBrowserLocale } from '@lokascript/i18n/parser';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * // Auto-detect and use browser locale
  * const parser = new Parser({ keywords: detectBrowserLocale() });

package/src/parser/ms.ts

@@ -0,0 +1,9 @@
+import { ms } from '../dictionaries/ms';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const msKeywords: KeywordProvider = createKeywordProvider(ms, 'ms', {
+  allowEnglishFallback: true,
+});
+
+export { ms as msDictionary } from '../dictionaries/ms';

package/src/parser/pl.ts

@@ -0,0 +1,9 @@
+import { pl } from '../dictionaries/pl';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const plKeywords: KeywordProvider = createKeywordProvider(pl, 'pl', {
+  allowEnglishFallback: true,
+});
+
+export { pl as plDictionary } from '../dictionaries/pl';

package/src/parser/pt.ts

@@ -23,7 +23,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { ptKeywords } from '@lokascript/i18n/parser/pt';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: ptKeywords });
  * parser.parse('em clique alternar .active');

package/src/parser/qu.ts

@@ -23,7 +23,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { quKeywords } from '@lokascript/i18n/parser/qu';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: quKeywords });
  * parser.parse('ñitiy-pi yapay #count-ta');

package/src/parser/ru.ts

@@ -0,0 +1,9 @@
+import { russianDictionary } from '../dictionaries/ru';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const ruKeywords: KeywordProvider = createKeywordProvider(russianDictionary, 'ru', {
+  allowEnglishFallback: true,
+});
+
+export { russianDictionary as ruDictionary } from '../dictionaries/ru';

package/src/parser/sw.ts

@@ -23,7 +23,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { swKeywords } from '@lokascript/i18n/parser/sw';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: swKeywords });
  * parser.parse('kwenye bonyeza badilisha .active');

package/src/parser/th.ts

@@ -0,0 +1,9 @@
+import { th } from '../dictionaries/th';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const thKeywords: KeywordProvider = createKeywordProvider(th, 'th', {
+  allowEnglishFallback: true,
+});
+
+export { th as thDictionary } from '../dictionaries/th';

package/src/parser/tl.ts

@@ -0,0 +1,9 @@
+import { tl } from '../dictionaries/tl';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const tlKeywords: KeywordProvider = createKeywordProvider(tl, 'tl', {
+  allowEnglishFallback: true,
+});
+
+export { tl as tlDictionary } from '../dictionaries/tl';

package/src/parser/tr.ts

@@ -24,7 +24,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { trKeywords } from '@lokascript/i18n/parser/tr';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: trKeywords });
  * parser.parse('üzerinde tıklama değiştir .active');

package/src/parser/uk.ts

@@ -0,0 +1,9 @@
+import { ukrainianDictionary } from '../dictionaries/uk';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const ukKeywords: KeywordProvider = createKeywordProvider(ukrainianDictionary, 'uk', {
+  allowEnglishFallback: true,
+});
+
+export { ukrainianDictionary as ukDictionary } from '../dictionaries/uk';

package/src/parser/vi.ts

@@ -0,0 +1,9 @@
+import { vi } from '../dictionaries/vi';
+import { createKeywordProvider } from './create-provider';
+import type { KeywordProvider } from './types';
+
+export const viKeywords: KeywordProvider = createKeywordProvider(vi, 'vi', {
+  allowEnglishFallback: true,
+});
+
+export { vi as viDictionary } from '../dictionaries/vi';

package/src/parser/zh.ts

@@ -24,7 +24,7 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { zhKeywords } from '@lokascript/i18n/parser/zh';
- * import { Parser } from '@lokascript/core';
+ * import { Parser } from '@hyperfixi/core';
  *
  * const parser = new Parser({ keywords: zhKeywords });
  * parser.parse('当 点击 切换 .active');