@lokascript/semantic 1.2.1 → 2.0.0

package/src/bridge.ts

@@ -1,275 +0,0 @@
-/**
- * Runtime Bridge
- *
- * Connects the semantic parser to the LokaScript core runtime.
- * Converts SemanticNodes to the CommandNode format expected by the runtime.
- */
-
-import type { SemanticNode, EventHandlerSemanticNode, SemanticValue } from './types';
-
-// =============================================================================
-// CommandNode Interface (from @lokascript/core)
-// =============================================================================
-
-/**
- * Simplified CommandNode interface matching core runtime expectations.
- * In production, this would import from @lokascript/core.
- */
-interface CommandNode {
-  type: 'command';
-  name: string;
-  args: ExpressionNode[];
-  modifiers?: Record<string, ExpressionNode>;
-  body?: StatementNode[];
-  implicitTarget?: ExpressionNode;
-  isBlocking: boolean;
-  start?: number;
-  end?: number;
-  line?: number;
-  column?: number;
-}
-
-interface EventHandlerNode {
-  type: 'eventHandler';
-  eventName: string;
-  body: StatementNode[];
-  filter?: ExpressionNode;
-  modifiers?: {
-    once?: boolean;
-    debounce?: number;
-    throttle?: number;
-  };
-}
-
-type ExpressionNode = {
-  type: string;
-  [key: string]: unknown;
-};
-
-type StatementNode = CommandNode | EventHandlerNode | ExpressionNode;
-
-// =============================================================================
-// Semantic to Runtime Bridge
-// =============================================================================
-
-/**
- * Convert a SemanticNode to a CommandNode for runtime execution.
- */
-export function toCommandNode(semantic: SemanticNode): CommandNode {
-  const args: ExpressionNode[] = [];
-  const modifiers: Record<string, ExpressionNode> = {};
-
-  // Map semantic roles to CommandNode structure
-  for (const [role, value] of semantic.roles) {
-    const expr = valueToExpression(value);
-
-    switch (role) {
-      // Primary arguments (go into args array)
-      case 'patient':
-        args.push(expr);
-        break;
-
-      // Modifiers (go into modifiers object with preposition keys)
-      case 'destination':
-        // Determine appropriate preposition based on command
-        if (semantic.action === 'put') {
-          modifiers['into'] = expr;
-        } else {
-          modifiers['on'] = expr;
-        }
-        break;
-
-      case 'source':
-        modifiers['from'] = expr;
-        break;
-
-      case 'style':
-      case 'quantity':
-        modifiers['by'] = expr;
-        break;
-
-      case 'method':
-        modifiers['as'] = expr;
-        break;
-
-      case 'condition':
-        modifiers['if'] = expr;
-        break;
-
-      case 'event':
-        // For event handlers, this becomes the event name
-        args.push(expr);
-        break;
-
-      default:
-        // Unknown role - add as modifier
-        modifiers[role] = expr;
-    }
-  }
-
-  const result: CommandNode = {
-    type: 'command',
-    name: semantic.action,
-    args,
-    isBlocking: false,
-    start: semantic.metadata?.sourcePosition?.start ?? 0,
-    end: semantic.metadata?.sourcePosition?.end ?? 0,
-  };
-
-  if (Object.keys(modifiers).length > 0) {
-    result.modifiers = modifiers;
-  }
-
-  return result;
-}
-
-/**
- * Convert a SemanticNode to an EventHandlerNode for runtime execution.
- */
-export function toEventHandlerNode(semantic: EventHandlerSemanticNode): EventHandlerNode {
-  const eventValue = semantic.roles.get('event');
-  const eventName = eventValue ? valueToString(eventValue) : 'click';
-
-  const body: StatementNode[] = semantic.body.map(node => {
-    if (node.kind === 'event-handler') {
-      return toEventHandlerNode(node as EventHandlerSemanticNode);
-    }
-    return toCommandNode(node);
-  });
-
-  const result: EventHandlerNode = {
-    type: 'eventHandler',
-    eventName,
-    body,
-  };
-
-  if (semantic.eventModifiers) {
-    const mods: { once?: boolean; debounce?: number; throttle?: number } = {};
-    if (semantic.eventModifiers.once !== undefined) mods.once = semantic.eventModifiers.once;
-    if (semantic.eventModifiers.debounce !== undefined)
-      mods.debounce = semantic.eventModifiers.debounce;
-    if (semantic.eventModifiers.throttle !== undefined)
-      mods.throttle = semantic.eventModifiers.throttle;
-    if (Object.keys(mods).length > 0) {
-      result.modifiers = mods;
-    }
-  }
-
-  return result;
-}
-
-/**
- * Convert a SemanticNode to the appropriate runtime node type.
- */
-export function toRuntimeNode(semantic: SemanticNode): StatementNode {
-  if (semantic.kind === 'event-handler') {
-    return toEventHandlerNode(semantic as EventHandlerSemanticNode);
-  }
-  return toCommandNode(semantic);
-}
-
-// =============================================================================
-// Helper Functions
-// =============================================================================
-
-/**
- * Convert a SemanticValue to an ExpressionNode.
- */
-function valueToExpression(value: SemanticValue): ExpressionNode {
-  switch (value.type) {
-    case 'literal':
-      return {
-        type: 'literal',
-        value: value.value,
-        dataType: value.dataType,
-      };
-
-    case 'selector':
-      return {
-        type: 'selector',
-        value: value.value,
-        selectorType: value.selectorKind,
-      };
-
-    case 'reference':
-      return {
-        type: 'identifier',
-        name: value.value,
-      };
-
-    case 'property-path':
-      return {
-        type: 'memberExpression',
-        object: valueToExpression(value.object),
-        property: {
-          type: 'identifier',
-          name: value.property,
-        },
-      };
-
-    case 'expression':
-      return {
-        type: 'raw',
-        value: value.raw,
-      };
-  }
-}
-
-/**
- * Convert a SemanticValue to a string.
- */
-function valueToString(value: SemanticValue): string {
-  switch (value.type) {
-    case 'literal':
-      return String(value.value);
-    case 'selector':
-      return value.value;
-    case 'reference':
-      return value.value;
-    case 'property-path':
-      return `${valueToString(value.object)}'s ${value.property}`;
-    case 'expression':
-      return value.raw;
-  }
-}
-
-// =============================================================================
-// Integration API
-// =============================================================================
-
-/**
- * Parse multilingual hyperscript and return a runtime-compatible node.
- *
- * @param input Hyperscript input (any supported language)
- * @param language Source language code
- * @returns Runtime-compatible node
- */
-export function parseToRuntime(input: string, language: string): StatementNode {
-  // Import here to avoid circular dependency
-  const { parse } = require('./parser');
-  const semantic = parse(input, language);
-  return toRuntimeNode(semantic);
-}
-
-/**
- * Parse multilingual hyperscript and execute it.
- * This is a placeholder - actual execution requires the core runtime.
- *
- * @param input Hyperscript input
- * @param language Source language code
- * @param context Execution context (from core runtime)
- */
-export async function parseAndExecute(
-  input: string,
-  language: string,
-  _context: unknown
-): Promise<void> {
-  const node = parseToRuntime(input, language);
-
-  // In production, this would call the core runtime's execute function
-  console.log('Would execute:', JSON.stringify(node, null, 2));
-
-  // Placeholder for actual execution
-  // const runtime = context.runtime;
-  // await runtime.processCommand(node, context);
-}

package/src/generators/event-handler-generator.ts

@@ -1,115 +0,0 @@
-/**
- * Event Handler Pattern Generator
- *
- * Generates event handler patterns from LanguageProfile.eventHandler config.
- * Used for simple SVO languages that don't need complex hand-crafted patterns.
- *
- * Languages using this generator: German, French, Indonesian, Quechua, Swahili
- * Languages with hand-crafted patterns: English, Japanese, Korean, Arabic, Turkish, Spanish, Portuguese, Chinese
- */
-
-import type { LanguagePattern } from '../types';
-import type { LanguageProfile } from './profiles/types';
-
-/**
- * Helper to create a literal token, only including alternatives if defined.
- */
-function literalToken(
-  value: string,
-  alternatives?: string[]
-): { type: 'literal'; value: string; alternatives?: string[] } {
-  if (alternatives && alternatives.length > 0) {
-    return { type: 'literal', value, alternatives };
-  }
-  return { type: 'literal', value };
-}
-
-/**
- * Generate event handler patterns from a language profile's eventHandler config.
- * Returns empty array if the profile doesn't have eventHandler config.
- */
-export function generateEventHandlerPatterns(profile: LanguageProfile): LanguagePattern[] {
-  const eh = profile.eventHandler;
-  if (!eh) return [];
-
-  const patterns: LanguagePattern[] = [];
-  const lang = profile.code;
-
-  // Pattern 1: Standard - "{keyword} {event}"
-  // e.g., "bei click", "sur click"
-  // Only generate if keyword is defined
-  if (eh.keyword) {
-    patterns.push({
-      id: `event-${lang}-standard`,
-      language: lang,
-      command: 'on',
-      priority: 100,
-      template: {
-        format: `${eh.keyword.primary} {event}`,
-        tokens: [
-          literalToken(eh.keyword.primary, eh.keyword.alternatives),
-          { type: 'role', role: 'event' },
-        ],
-      },
-      extraction: {
-        event: { position: 1 },
-      },
-    });
-
-    // Pattern 2: With source - "{keyword} {event} {sourceMarker} {source}"
-    // e.g., "bei click von #button", "sur click de #button"
-    // Only generate if both keyword and sourceMarker are defined
-    if (eh.sourceMarker) {
-      const sourceMarkerValue = eh.sourceMarker.primary;
-      const sourceExtraction: { marker: string; markerAlternatives?: string[] } = {
-        marker: sourceMarkerValue,
-      };
-      if (eh.sourceMarker.alternatives && eh.sourceMarker.alternatives.length > 0) {
-        sourceExtraction.markerAlternatives = eh.sourceMarker.alternatives;
-      }
-
-      patterns.push({
-        id: `event-${lang}-source`,
-        language: lang,
-        command: 'on',
-        priority: 110, // Higher priority for more specific pattern
-        template: {
-          format: `${eh.keyword.primary} {event} ${sourceMarkerValue} {source}`,
-          tokens: [
-            literalToken(eh.keyword.primary, eh.keyword.alternatives),
-            { type: 'role', role: 'event' },
-            literalToken(sourceMarkerValue, eh.sourceMarker.alternatives),
-            { type: 'role', role: 'source' },
-          ],
-        },
-        extraction: {
-          event: { position: 1 },
-          source: sourceExtraction,
-        },
-      });
-    }
-  }
-
-  // Pattern 3: Conditional (if defined) - "{conditionalKeyword} {event}"
-  // e.g., "wenn click", "quand click"
-  if (eh.conditionalKeyword) {
-    patterns.push({
-      id: `event-${lang}-when`,
-      language: lang,
-      command: 'on',
-      priority: 105, // Higher than standard, lower than with-source
-      template: {
-        format: `${eh.conditionalKeyword.primary} {event}`,
-        tokens: [
-          literalToken(eh.conditionalKeyword.primary, eh.conditionalKeyword.alternatives),
-          { type: 'role', role: 'event' },
-        ],
-      },
-      extraction: {
-        event: { position: 1 },
-      },
-    });
-  }
-
-  return patterns;
-}

package/src/patterns/add/ms.ts

@@ -1,30 +0,0 @@
-/**
- * Malay Add Patterns
- *
- * Patterns for parsing "add" command in Malay.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getAddPatternsMs(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for add
-    // Example:
-    // {
-    //   id: 'add-ms-simple',
-    //   language: 'ms',
-    //   command: 'add',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/add/tl.ts

@@ -1,30 +0,0 @@
-/**
- * Tagalog Add Patterns
- *
- * Patterns for parsing "add" command in Tagalog.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getAddPatternsTl(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for add
-    // Example:
-    // {
-    //   id: 'add-tl-simple',
-    //   language: 'tl',
-    //   command: 'add',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/decrement/ms.ts

@@ -1,30 +0,0 @@
-/**
- * Malay Decrement Patterns
- *
- * Patterns for parsing "decrement" command in Malay.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getDecrementPatternsMs(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for decrement
-    // Example:
-    // {
-    //   id: 'decrement-ms-simple',
-    //   language: 'ms',
-    //   command: 'decrement',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/decrement/tl.ts

@@ -1,30 +0,0 @@
-/**
- * Tagalog Decrement Patterns
- *
- * Patterns for parsing "decrement" command in Tagalog.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getDecrementPatternsTl(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for decrement
-    // Example:
-    // {
-    //   id: 'decrement-tl-simple',
-    //   language: 'tl',
-    //   command: 'decrement',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/get/ms.ts

@@ -1,30 +0,0 @@
-/**
- * Malay Get Patterns
- *
- * Patterns for parsing "get" command in Malay.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getGetPatternsMs(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for get
-    // Example:
-    // {
-    //   id: 'get-ms-simple',
-    //   language: 'ms',
-    //   command: 'get',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/get/tl.ts

@@ -1,30 +0,0 @@
-/**
- * Tagalog Get Patterns
- *
- * Patterns for parsing "get" command in Tagalog.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getGetPatternsTl(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for get
-    // Example:
-    // {
-    //   id: 'get-tl-simple',
-    //   language: 'tl',
-    //   command: 'get',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/hide/ms.ts

@@ -1,30 +0,0 @@
-/**
- * Malay Hide Patterns
- *
- * Patterns for parsing "hide" command in Malay.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getHidePatternsMs(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for hide
-    // Example:
-    // {
-    //   id: 'hide-ms-simple',
-    //   language: 'ms',
-    //   command: 'hide',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/hide/tl.ts

@@ -1,30 +0,0 @@
-/**
- * Tagalog Hide Patterns
- *
- * Patterns for parsing "hide" command in Tagalog.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getHidePatternsTl(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for hide
-    // Example:
-    // {
-    //   id: 'hide-tl-simple',
-    //   language: 'tl',
-    //   command: 'hide',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/increment/ms.ts

@@ -1,30 +0,0 @@
-/**
- * Malay Increment Patterns
- *
- * Patterns for parsing "increment" command in Malay.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getIncrementPatternsMs(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for increment
-    // Example:
-    // {
-    //   id: 'increment-ms-simple',
-    //   language: 'ms',
-    //   command: 'increment',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}

package/src/patterns/increment/tl.ts

@@ -1,30 +0,0 @@
-/**
- * Tagalog Increment Patterns
- *
- * Patterns for parsing "increment" command in Tagalog.
- */
-
-import type { LanguagePattern } from '../../types';
-
-export function getIncrementPatternsTl(): LanguagePattern[] {
-  return [
-    // TODO: Add patterns for increment
-    // Example:
-    // {
-    //   id: 'increment-tl-simple',
-    //   language: 'tl',
-    //   command: 'increment',
-    //   priority: 100,
-    //   template: {
-    //     format: 'TODO {patient}',
-    //     tokens: [
-    //       { type: 'literal', value: 'TODO' },
-    //       { type: 'role', role: 'patient' },
-    //     ],
-    //   },
-    //   extraction: {
-    //     patient: { position: 1 },
-    //   },
-    // },
-  ];
-}