@lokascript/semantic 1.0.0

package/src/patterns/put/zh.ts

@@ -0,0 +1,62 @@
+/**
+ * Chinese Put Patterns
+ *
+ * Hand-crafted patterns for "put" command.
+ * Chinese: 放置 "你好" 到 #output
+ */
+
+import type { LanguagePattern } from '../../types';
+
+/**
+ * Get Chinese put patterns.
+ */
+export function getPutPatternsZh(): LanguagePattern[] {
+  return [
+    {
+      id: 'put-zh-full',
+      language: 'zh',
+      command: 'put',
+      priority: 100,
+      template: {
+        format: '放置 {patient} 到 {destination}',
+        tokens: [
+          { type: 'literal', value: '放置', alternatives: ['放', '放入', '置入', 'put'] },
+          {
+            type: 'role',
+            role: 'patient',
+            expectedTypes: ['literal', 'selector', 'reference', 'expression'],
+          },
+          { type: 'literal', value: '到', alternatives: ['在', '于', '入'] },
+          { type: 'role', role: 'destination', expectedTypes: ['selector', 'reference'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { position: 3 },
+      },
+    },
+    {
+      id: 'put-zh-ba',
+      language: 'zh',
+      command: 'put',
+      priority: 95,
+      template: {
+        format: '把 {patient} 放到 {destination}',
+        tokens: [
+          { type: 'literal', value: '把' },
+          {
+            type: 'role',
+            role: 'patient',
+            expectedTypes: ['literal', 'selector', 'reference', 'expression'],
+          },
+          { type: 'literal', value: '放到', alternatives: ['放在', '放入'] },
+          { type: 'role', role: 'destination', expectedTypes: ['selector', 'reference'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { position: 3 },
+      },
+    },
+  ];
+}

package/src/patterns/registry.ts

@@ -0,0 +1,163 @@
+/**
+ * Pattern Registry
+ *
+ * Pattern cache and lookup functions for the semantic parser.
+ */
+
+import type { LanguagePattern, ActionType } from '../types';
+import { buildPatternsForLanguage, buildAllPatterns } from './builders';
+
+// =============================================================================
+// Pattern Cache
+// =============================================================================
+
+/**
+ * Pattern cache for performance.
+ * Maps language code to array of patterns for that language.
+ */
+const patternCache = new Map<string, LanguagePattern[]>();
+
+// Lazy all patterns - only built when accessed
+let _allPatterns: LanguagePattern[] | null = null;
+
+/**
+ * Ensure all patterns are built (lazy initialization).
+ */
+function ensureAllPatterns(): LanguagePattern[] {
+  if (_allPatterns === null) {
+    _allPatterns = buildAllPatterns();
+  }
+  return _allPatterns;
+}
+
+// =============================================================================
+// All Patterns (Lazy Getter - for backwards compatibility)
+// =============================================================================
+
+/**
+ * All registered patterns across all languages.
+ * Uses a Proxy to lazily build patterns on first access.
+ * @deprecated Use getPatternsForLanguage() for tree-shaking.
+ */
+export const allPatterns: LanguagePattern[] = new Proxy([] as LanguagePattern[], {
+  get(_target, prop) {
+    const arr = ensureAllPatterns();
+    const value = Reflect.get(arr, prop);
+    // Bind methods to the actual array, not the proxy target
+    if (typeof value === 'function') {
+      return value.bind(arr);
+    }
+    return value;
+  },
+  // Support iteration (for...of, spread operator)
+  ownKeys() {
+    return Reflect.ownKeys(ensureAllPatterns());
+  },
+  getOwnPropertyDescriptor(_target, prop) {
+    return Reflect.getOwnPropertyDescriptor(ensureAllPatterns(), prop);
+  },
+});
+
+// =============================================================================
+// Pattern Lookup
+// =============================================================================
+
+/**
+ * Get all patterns.
+ * @deprecated Use getPatternsForLanguage() for tree-shaking.
+ */
+export function getAllPatterns(): LanguagePattern[] {
+  if (_allPatterns === null) {
+    _allPatterns = buildAllPatterns();
+  }
+  return _allPatterns;
+}
+
+/**
+ * Get all patterns for a specific language.
+ * Uses caching for performance.
+ */
+export function getPatternsForLanguage(language: string): LanguagePattern[] {
+  // Check cache first
+  if (patternCache.has(language)) {
+    return patternCache.get(language)!;
+  }
+
+  // Build patterns for this language
+  const patterns = buildPatternsForLanguage(language);
+  patternCache.set(language, patterns);
+  return patterns;
+}
+
+/**
+ * Get patterns for a specific language and command.
+ */
+export function getPatternsForLanguageAndCommand(
+  language: string,
+  command: ActionType
+): LanguagePattern[] {
+  return getPatternsForLanguage(language)
+    .filter(p => p.command === command)
+    .sort((a, b) => b.priority - a.priority);
+}
+
+/**
+ * Get all supported languages.
+ */
+export function getSupportedLanguages(): string[] {
+  const languages = new Set(allPatterns.map(p => p.language));
+  return Array.from(languages);
+}
+
+/**
+ * Get all supported commands.
+ */
+export function getSupportedCommands(): ActionType[] {
+  const commands = new Set(allPatterns.map(p => p.command));
+  return Array.from(commands) as ActionType[];
+}
+
+/**
+ * Find a pattern by ID.
+ */
+export function getPatternById(id: string): LanguagePattern | undefined {
+  return allPatterns.find(p => p.id === id);
+}
+
+// =============================================================================
+// Pattern Statistics (for debugging/tooling)
+// =============================================================================
+
+export interface PatternStats {
+  totalPatterns: number;
+  byLanguage: Record<string, number>;
+  byCommand: Record<string, number>;
+}
+
+/**
+ * Get statistics about registered patterns.
+ */
+export function getPatternStats(): PatternStats {
+  const byLanguage: Record<string, number> = {};
+  const byCommand: Record<string, number> = {};
+
+  for (const pattern of allPatterns) {
+    byLanguage[pattern.language] = (byLanguage[pattern.language] || 0) + 1;
+    byCommand[pattern.command] = (byCommand[pattern.command] || 0) + 1;
+  }
+
+  return {
+    totalPatterns: allPatterns.length,
+    byLanguage,
+    byCommand,
+  };
+}
+
+/**
+ * Clear the pattern cache.
+ * Useful for testing or when language profiles change.
+ */
+export function clearPatternCache(): void {
+  patternCache.clear();
+  _allPatterns = null;
+}

package/src/patterns/remove/ar.ts

@@ -0,0 +1,71 @@
+/**
+ * Arabic Remove Patterns
+ *
+ * Hand-crafted patterns for "remove" command.
+ * Arabic uses VSO order: احذف {patient} من {target}
+ */
+
+import type { LanguagePattern } from '../../types';
+
+/**
+ * Get Arabic remove patterns.
+ */
+export function getRemovePatternsAr(): LanguagePattern[] {
+  return [
+    {
+      id: 'remove-ar-full',
+      language: 'ar',
+      command: 'remove',
+      priority: 100,
+      template: {
+        format: 'احذف {patient} من {destination}',
+        tokens: [
+          { type: 'literal', value: 'احذف', alternatives: ['أحذف', 'أزل', 'ازل', 'إزالة'] },
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'من' },
+          { type: 'role', role: 'destination' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { marker: 'من' },
+      },
+    },
+    {
+      id: 'remove-ar-simple',
+      language: 'ar',
+      command: 'remove',
+      priority: 90,
+      template: {
+        format: 'احذف {patient}',
+        tokens: [
+          { type: 'literal', value: 'احذف', alternatives: ['أحذف', 'أزل', 'ازل'] },
+          { type: 'role', role: 'patient' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { default: { type: 'reference', value: 'me' } },
+      },
+    },
+    {
+      id: 'remove-ar-with-عن',
+      language: 'ar',
+      command: 'remove',
+      priority: 95,
+      template: {
+        format: 'احذف {patient} عن {destination}',
+        tokens: [
+          { type: 'literal', value: 'احذف', alternatives: ['أحذف'] },
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'عن' },
+          { type: 'role', role: 'destination' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { marker: 'عن' },
+      },
+    },
+  ];
+}

package/src/patterns/remove/bn.ts

@@ -0,0 +1,68 @@
+/**
+ * Bengali Remove Patterns
+ *
+ * Patterns for parsing "remove" command in Bengali.
+ */
+
+import type { LanguagePattern } from '../../types';
+
+export function getRemovePatternsBn(): LanguagePattern[] {
+  return [
+    // Full pattern: .active কে সরান
+    {
+      id: 'remove-bn-full',
+      language: 'bn',
+      command: 'remove',
+      priority: 100,
+      template: {
+        format: '{patient} কে সরান',
+        tokens: [
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'কে' },
+          { type: 'literal', value: 'সরান', alternatives: ['মুছুন'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 0 },
+      },
+    },
+    // Simple pattern: সরান .active
+    {
+      id: 'remove-bn-simple',
+      language: 'bn',
+      command: 'remove',
+      priority: 90,
+      template: {
+        format: 'সরান {patient}',
+        tokens: [
+          { type: 'literal', value: 'সরান', alternatives: ['মুছুন'] },
+          { type: 'role', role: 'patient' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+      },
+    },
+    // With source: #button থেকে .active কে সরান
+    {
+      id: 'remove-bn-with-source',
+      language: 'bn',
+      command: 'remove',
+      priority: 95,
+      template: {
+        format: '{source} থেকে {patient} কে সরান',
+        tokens: [
+          { type: 'role', role: 'source' },
+          { type: 'literal', value: 'থেকে' },
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'কে' },
+          { type: 'literal', value: 'সরান', alternatives: ['মুছুন'] },
+        ],
+      },
+      extraction: {
+        source: { position: 0 },
+        patient: { position: 2 },
+      },
+    },
+  ];
+}

package/src/patterns/remove/hi.ts

@@ -0,0 +1,69 @@
+/**
+ * Hindi Remove Patterns
+ *
+ * Patterns for parsing "remove" command in Hindi.
+ */
+
+import type { LanguagePattern } from '../../types';
+
+export function getRemovePatternsHi(): LanguagePattern[] {
+  return [
+    // Full pattern: .class को #element से हटाएं
+    {
+      id: 'remove-hi-full',
+      language: 'hi',
+      command: 'remove',
+      priority: 100,
+      template: {
+        format: '{patient} को {source} से हटाएं',
+        tokens: [
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'को' },
+          { type: 'role', role: 'source' },
+          { type: 'literal', value: 'से' },
+          { type: 'literal', value: 'हटाएं', alternatives: ['हटा', 'मिटाएं'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 0 },
+        source: { marker: 'से', position: 3 },
+      },
+    },
+    // Simple pattern: .class हटाएं
+    {
+      id: 'remove-hi-simple',
+      language: 'hi',
+      command: 'remove',
+      priority: 90,
+      template: {
+        format: '{patient} हटाएं',
+        tokens: [
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'हटाएं', alternatives: ['हटा', 'मिटाएं'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 0 },
+        source: { default: { type: 'reference', value: 'me' } },
+      },
+    },
+    // Bare pattern: हटाएं .class
+    {
+      id: 'remove-hi-bare',
+      language: 'hi',
+      command: 'remove',
+      priority: 80,
+      template: {
+        format: 'हटाएं {patient}',
+        tokens: [
+          { type: 'literal', value: 'हटाएं', alternatives: ['हटा', 'मिटाएं'] },
+          { type: 'role', role: 'patient' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        source: { default: { type: 'reference', value: 'me' } },
+      },
+    },
+  ];
+}

package/src/patterns/remove/index.ts

@@ -0,0 +1,87 @@
+/**
+ * Remove Command Patterns
+ *
+ * Hand-crafted patterns for "remove" command across languages.
+ *
+ * @generated This file is auto-generated. Do not edit manually.
+ */
+
+import type { LanguagePattern } from '../../types';
+
+import { getRemovePatternsAr } from './ar';
+import { getRemovePatternsBn } from './bn';
+import { getRemovePatternsHi } from './hi';
+import { getRemovePatternsIt } from './it';
+import { getRemovePatternsJa } from './ja';
+import { getRemovePatternsKo } from './ko';
+import { getRemovePatternsMs } from './ms';
+import { getRemovePatternsPl } from './pl';
+import { getRemovePatternsRu } from './ru';
+import { getRemovePatternsTh } from './th';
+import { getRemovePatternsTl } from './tl';
+import { getRemovePatternsTr } from './tr';
+import { getRemovePatternsUk } from './uk';
+import { getRemovePatternsVi } from './vi';
+import { getRemovePatternsZh } from './zh';
+
+/**
+ * Get remove patterns for a specific language.
+ */
+export function getRemovePatternsForLanguage(language: string): LanguagePattern[] {
+  switch (language) {
+    case 'ar':
+      return getRemovePatternsAr();
+    case 'bn':
+      return getRemovePatternsBn();
+    case 'hi':
+      return getRemovePatternsHi();
+    case 'it':
+      return getRemovePatternsIt();
+    case 'ja':
+      return getRemovePatternsJa();
+    case 'ko':
+      return getRemovePatternsKo();
+    case 'ms':
+      return getRemovePatternsMs();
+    case 'pl':
+      return getRemovePatternsPl();
+    case 'ru':
+      return getRemovePatternsRu();
+    case 'th':
+      return getRemovePatternsTh();
+    case 'tl':
+      return getRemovePatternsTl();
+    case 'tr':
+      return getRemovePatternsTr();
+    case 'uk':
+      return getRemovePatternsUk();
+    case 'vi':
+      return getRemovePatternsVi();
+    case 'zh':
+      return getRemovePatternsZh();
+    default:
+      return [];
+  }
+}
+
+// Re-export language-specific getters for tree-shaking
+export { getRemovePatternsAr } from './ar';
+export { getRemovePatternsBn } from './bn';
+export { getRemovePatternsHi } from './hi';
+export { getRemovePatternsIt } from './it';
+export { getRemovePatternsJa } from './ja';
+export { getRemovePatternsKo } from './ko';
+export { getRemovePatternsMs } from './ms';
+export { getRemovePatternsPl } from './pl';
+export { getRemovePatternsRu } from './ru';
+export { getRemovePatternsTh } from './th';
+export { getRemovePatternsTl } from './tl';
+export { getRemovePatternsTr } from './tr';
+export { getRemovePatternsUk } from './uk';
+export { getRemovePatternsVi } from './vi';
+export { getRemovePatternsZh } from './zh';
+
+/**
+ * Languages that have hand-crafted remove patterns.
+ */
+export const removePatternLanguages = ['ar', 'bn', 'hi', 'it', 'ja', 'ko', 'ms', 'pl', 'ru', 'th', 'tl', 'tr', 'uk', 'vi', 'zh'];

package/src/patterns/remove/it.ts

@@ -0,0 +1,69 @@
+/**
+ * Italian Remove Patterns
+ *
+ * Tree-shakeable: Only included when Italian is imported.
+ */
+
+import type { LanguagePattern } from '../../types';
+
+/**
+ * Get Italian remove patterns.
+ */
+export function getRemovePatternsIt(): LanguagePattern[] {
+  return [
+    {
+      id: 'remove-it-full',
+      language: 'it',
+      command: 'remove',
+      priority: 100,
+      template: {
+        format: 'rimuovere {patient} da {target}',
+        tokens: [
+          {
+            type: 'literal',
+            value: 'rimuovere',
+            alternatives: ['rimuovi', 'eliminare', 'togliere', 'remove'],
+          },
+          { type: 'role', role: 'patient' },
+          {
+            type: 'group',
+            optional: true,
+            tokens: [
+              { type: 'literal', value: 'da', alternatives: ['di'] },
+              { type: 'role', role: 'destination' },
+            ],
+          },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: {
+          marker: 'da',
+          markerAlternatives: ['di'],
+          default: { type: 'reference', value: 'me' },
+        },
+      },
+    },
+    {
+      id: 'remove-it-simple',
+      language: 'it',
+      command: 'remove',
+      priority: 90,
+      template: {
+        format: 'rimuovere {patient}',
+        tokens: [
+          {
+            type: 'literal',
+            value: 'rimuovere',
+            alternatives: ['rimuovi', 'eliminare', 'togliere', 'remove'],
+          },
+          { type: 'role', role: 'patient' },
+        ],
+      },
+      extraction: {
+        patient: { position: 1 },
+        destination: { default: { type: 'reference', value: 'me' } },
+      },
+    },
+  ];
+}

package/src/patterns/remove/ja.ts

@@ -0,0 +1,74 @@
+/**
+ * Japanese Remove Patterns
+ *
+ * Hand-crafted patterns for "remove" command.
+ * Japanese uses SOV order: {target} から {patient} を 削除
+ */
+
+import type { LanguagePattern } from '../../types';
+
+/**
+ * Get Japanese remove patterns.
+ */
+export function getRemovePatternsJa(): LanguagePattern[] {
+  return [
+    {
+      id: 'remove-ja-full',
+      language: 'ja',
+      command: 'remove',
+      priority: 100,
+      template: {
+        format: '{destination} から {patient} を 削除',
+        tokens: [
+          { type: 'role', role: 'destination' },
+          { type: 'literal', value: 'から' },
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'を' },
+          { type: 'literal', value: '削除', alternatives: ['削除する', '除去', '取り除く'] },
+        ],
+      },
+      extraction: {
+        destination: { position: 0 },
+        patient: { marker: 'を' },
+      },
+    },
+    {
+      id: 'remove-ja-simple',
+      language: 'ja',
+      command: 'remove',
+      priority: 90,
+      template: {
+        format: '{patient} を 削除',
+        tokens: [
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'を' },
+          { type: 'literal', value: '削除', alternatives: ['削除する', '除去', '取り除く'] },
+        ],
+      },
+      extraction: {
+        patient: { position: 0 },
+        destination: { default: { type: 'reference', value: 'me' } },
+      },
+    },
+    {
+      id: 'remove-ja-possessive',
+      language: 'ja',
+      command: 'remove',
+      priority: 95,
+      template: {
+        format: '{destination} の {patient} を 削除',
+        tokens: [
+          { type: 'role', role: 'destination' },
+          { type: 'literal', value: 'の' },
+          { type: 'role', role: 'patient' },
+          { type: 'literal', value: 'を' },
+          { type: 'literal', value: '削除', alternatives: ['削除する'] },
+        ],
+      },
+      extraction: {
+        destination: { position: 0 },
+        patient: { marker: 'を' },
+      },
+    },
+  ];
+}