@lokascript/framework 2.0.0

package/dist/grammar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/grammar/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/grammar/index.js

@@ -0,0 +1,391 @@
+// src/grammar/types.ts
+var UNIVERSAL_PATTERNS = {
+  // on click increment #count
+  eventIncrement: {
+    name: "event-increment",
+    roles: ["event", "action", "patient"],
+    english: "on {event} {action} {patient}"
+  },
+  // put X into Y
+  putInto: {
+    name: "put-into",
+    roles: ["action", "patient", "destination"],
+    english: "{action} {patient} into {destination}"
+  },
+  // add .class to element
+  addTo: {
+    name: "add-to",
+    roles: ["action", "patient", "destination"],
+    english: "{action} {patient} to {destination}"
+  },
+  // toggle .class on element
+  toggleOn: {
+    name: "toggle-on",
+    roles: ["action", "patient", "destination"],
+    english: "{action} {patient} on {destination}"
+  },
+  // wait 2 seconds
+  waitDuration: {
+    name: "wait-duration",
+    roles: ["action", "quantity"],
+    english: "{action} {quantity}"
+  },
+  // if condition then ... end
+  conditional: {
+    name: "conditional",
+    roles: ["action", "condition"],
+    english: "{action} {condition} then ... end"
+  },
+  // fetch URL as type
+  fetchAs: {
+    name: "fetch-as",
+    roles: ["action", "source", "method"],
+    english: "{action} {source} as {method}"
+  },
+  // show element with animation
+  showWith: {
+    name: "show-with",
+    roles: ["action", "patient", "style"],
+    english: "{action} {patient} with {style}"
+  },
+  // transition property over duration
+  transitionOver: {
+    name: "transition-over",
+    roles: ["action", "patient", "duration"],
+    english: "{action} {patient} over {duration}"
+  }
+};
+var LANGUAGE_FAMILY_DEFAULTS = {
+  // Germanic (English, German, Dutch)
+  germanic: {
+    wordOrder: "SVO",
+    adpositionType: "preposition",
+    morphology: "fusional",
+    direction: "ltr",
+    canonicalOrder: [
+      "action",
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  },
+  // Romance (Spanish, French, Italian, Portuguese)
+  romance: {
+    wordOrder: "SVO",
+    adpositionType: "preposition",
+    morphology: "fusional",
+    direction: "ltr",
+    canonicalOrder: [
+      "action",
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  },
+  // Japonic (Japanese)
+  japonic: {
+    wordOrder: "SOV",
+    adpositionType: "postposition",
+    morphology: "agglutinative",
+    direction: "ltr",
+    canonicalOrder: [
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style",
+      "action"
+    ]
+  },
+  // Koreanic (Korean)
+  koreanic: {
+    wordOrder: "SOV",
+    adpositionType: "postposition",
+    morphology: "agglutinative",
+    direction: "ltr",
+    canonicalOrder: [
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style",
+      "action"
+    ]
+  },
+  // Turkic (Turkish, Azerbaijani)
+  turkic: {
+    wordOrder: "SOV",
+    adpositionType: "postposition",
+    morphology: "agglutinative",
+    direction: "ltr",
+    canonicalOrder: [
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style",
+      "action"
+    ]
+  },
+  // Sinitic (Chinese, Cantonese)
+  sinitic: {
+    wordOrder: "SVO",
+    // Topic-prominent, flexible
+    adpositionType: "preposition",
+    morphology: "isolating",
+    direction: "ltr",
+    canonicalOrder: [
+      "action",
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  },
+  // Semitic (Arabic, Hebrew)
+  semitic: {
+    wordOrder: "VSO",
+    adpositionType: "preposition",
+    morphology: "fusional",
+    // Root-pattern system
+    direction: "rtl",
+    canonicalOrder: [
+      "action",
+      "agent",
+      "patient",
+      "destination",
+      "source",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  },
+  // Austronesian (Indonesian, Tagalog)
+  austronesian: {
+    wordOrder: "SVO",
+    adpositionType: "preposition",
+    morphology: "agglutinative",
+    direction: "ltr",
+    canonicalOrder: [
+      "action",
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  },
+  // Quechuan (Quechua)
+  quechuan: {
+    wordOrder: "SOV",
+    adpositionType: "postposition",
+    morphology: "agglutinative",
+    // Actually polysynthetic but simplified
+    direction: "ltr",
+    canonicalOrder: [
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style",
+      "action"
+    ]
+  },
+  // Bantu (Swahili)
+  bantu: {
+    wordOrder: "SVO",
+    adpositionType: "preposition",
+    morphology: "agglutinative",
+    direction: "ltr",
+    canonicalOrder: [
+      "action",
+      "patient",
+      "source",
+      "destination",
+      "quantity",
+      "duration",
+      "method",
+      "style"
+    ]
+  }
+};
+function reorderRoles(roles, targetOrder) {
+  const result = [];
+  const usedRoles = /* @__PURE__ */ new Set();
+  for (const role of targetOrder) {
+    const element = roles.get(role);
+    if (element) {
+      result.push(element);
+      usedRoles.add(role);
+    }
+  }
+  for (const [role, element] of roles) {
+    if (!usedRoles.has(role)) {
+      result.push(element);
+    }
+  }
+  return result;
+}
+function insertMarkers(elements, markers, adpositionType) {
+  const result = [];
+  for (const element of elements) {
+    const marker = markers.find((m) => m.role === element.role);
+    if (marker) {
+      if (adpositionType === "preposition") {
+        if (marker.form) result.push(marker.form);
+        result.push(element.translated || element.value);
+      } else if (adpositionType === "postposition") {
+        result.push(element.translated || element.value);
+        if (marker.form) result.push(marker.form);
+      } else {
+        result.push(element.translated || element.value);
+      }
+    } else {
+      result.push(element.translated || element.value);
+    }
+  }
+  return result;
+}
+function joinTokens(tokens) {
+  if (tokens.length === 0) return "";
+  let result = "";
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    const nextToken = tokens[i + 1];
+    const isPrefix = token.endsWith("-");
+    const isSuffix = token.startsWith("-");
+    let displayToken = token;
+    if (isPrefix) displayToken = token.slice(0, -1);
+    if (isSuffix) displayToken = token.substring(1);
+    result += displayToken;
+    if (nextToken) {
+      const nextIsSuffix = nextToken.startsWith("-");
+      if (!isPrefix && !nextIsSuffix) {
+        result += " ";
+      }
+    }
+  }
+  return result;
+}
+function transformStatement(parsed, _sourceProfile, targetProfile) {
+  const reordered = reorderRoles(parsed.roles, targetProfile.canonicalOrder);
+  const withMarkers = insertMarkers(reordered, targetProfile.markers, targetProfile.adpositionType);
+  return joinTokens(withMarkers);
+}
+
+// src/grammar/transformer.ts
+var GrammarTransformer = class {
+  constructor(config) {
+    this.dictionary = config.dictionary;
+    this.profileProvider = config.profileProvider;
+  }
+  /**
+   * Transform a statement from one language to another.
+   *
+   * @param input - Statement in source language
+   * @param fromLanguage - Source language code
+   * @param toLanguage - Target language code
+   * @returns Transformed statement in target language
+   *
+   * @throws Error if profiles not found or translation fails
+   */
+  transform(input, fromLanguage, toLanguage) {
+    const fromProfile = this.profileProvider.getProfile(fromLanguage);
+    const toProfile = this.profileProvider.getProfile(toLanguage);
+    if (!fromProfile) {
+      throw new Error(`No profile found for language: ${fromLanguage}`);
+    }
+    if (!toProfile) {
+      throw new Error(`No profile found for language: ${toLanguage}`);
+    }
+    const parsed = this.parseStatement(input, fromLanguage, fromProfile);
+    const translated = this.translateRoles(parsed, fromLanguage, toLanguage);
+    const reordered = reorderRoles(translated, toProfile.canonicalOrder);
+    const withMarkers = insertMarkers(reordered, toProfile.markers, toProfile.adpositionType);
+    return joinTokens(withMarkers);
+  }
+  /**
+   * Parse statement into semantic roles.
+   * This is a simplified generic parser - DSLs can provide custom parsers.
+   */
+  parseStatement(input, language, profile) {
+    const roles = /* @__PURE__ */ new Map();
+    const tokens = input.split(/\s+/);
+    let i = 0;
+    while (i < tokens.length) {
+      const token = tokens[i];
+      const marker = profile.markers.find((m) => m.form === token);
+      if (marker) {
+        if (i + 1 < tokens.length) {
+          roles.set(marker.role, tokens[i + 1]);
+          i += 2;
+        } else {
+          i++;
+        }
+      } else {
+        const canonical = this.dictionary.lookup(token, language);
+        if (canonical) {
+          roles.set("action", canonical);
+        } else {
+          if (token.startsWith("#") || token.startsWith(".")) {
+            roles.set("patient", token);
+          } else {
+            roles.set("patient", token);
+          }
+        }
+        i++;
+      }
+    }
+    return roles;
+  }
+  /**
+   * Translate roles using injected dictionary.
+   * Returns a Map of ParsedElement objects expected by reorderRoles.
+   */
+  translateRoles(roles, _fromLanguage, toLanguage) {
+    const result = /* @__PURE__ */ new Map();
+    for (const [role, value] of roles) {
+      const translated = this.dictionary.translate(value, toLanguage);
+      result.set(role, {
+        role,
+        value,
+        // Original value
+        translated: translated ?? value
+        // Translated value or original if no translation
+      });
+    }
+    return result;
+  }
+};
+export {
+  GrammarTransformer,
+  LANGUAGE_FAMILY_DEFAULTS,
+  UNIVERSAL_PATTERNS,
+  insertMarkers,
+  joinTokens,
+  reorderRoles,
+  transformStatement
+};
+//# sourceMappingURL=index.js.map

package/dist/grammar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/grammar/types.ts","../../src/grammar/transformer.ts"],"sourcesContent":["/**\n * Generalized Grammar System for Multilingual Hyperscript\n *\n * This system abstracts grammatical patterns across language families,\n * enabling deep multilingual support without per-language hardcoding.\n *\n * Key Linguistic Concepts:\n * - Word Order: SVO, SOV, VSO (and variations)\n * - Adposition Type: Preposition (English) vs Postposition (Japanese/Korean)\n * - Morphology: Isolating (Chinese) vs Agglutinative (Turkish) vs Fusional (Arabic)\n * - Text Direction: LTR vs RTL\n */\n\n// =============================================================================\n// Core Types\n// =============================================================================\n\n/**\n * Semantic roles in hyperscript commands.\n * These are universal across all 13 supported languages - only the surface form changes.\n *\n * ## Core Thematic Roles (from linguistic theory)\n * | Role        | Usage | Purpose                     | Example                   |\n * |-------------|-------|-----------------------------|---------------------------|\n * | action      | 100%  | Command verb                | toggle, put, fetch        |\n * | patient     | 90%   | What is acted upon          | .active, #count           |\n * | destination | 40%   | Where something goes        | into #output, to .class   |\n * | source      | 13%   | Where something comes from  | from #input, from URL     |\n * | event       | 106%  | Trigger events              | click, keydown, submit    |\n * | condition   | 8%    | Boolean expressions         | if x > 5, when visible    |\n * | agent       | 0%    | Who performs action         | Reserved for future use   |\n * | goal        | 1%    | Target value/state          | to 'red' (in transition)  |\n *\n * ## Quantitative Roles (answer \"how much/long\")\n * | Role     | Usage | Purpose        | Example              |\n * |----------|-------|----------------|----------------------|\n * | quantity | 7%    | Numeric amount | by 5, 3 times        |\n * | duration | 1%    | Time span      | for 5 seconds, 500ms |\n *\n * ## Adverbial/Modifier Roles (answer \"how/by what means\")\n * | Role         | Usage | Purpose                   | Example           |\n * |--------------|-------|---------------------------|-------------------|\n * | style        | 2%    | Animation/behavior        | with fade         |\n * | manner       | 2%    | Insertion position        | before, after     |\n * | method       | 1%    | HTTP method/technique     | via POST, as GET  |\n * | responseType | 1%    | Response format           | as json, as html  |\n *\n * ## Control Flow Roles\n * | Role     | Usage | Purpose      | Example               |\n * |----------|-------|--------------|-----------------------|\n * | loopType | 6%    | Loop variant | forever, until, times |\n *\n * ## Design Notes\n * - Low-usage roles (agent, goal, method, responseType) are intentionally kept for:\n *   - Linguistic completeness across all 13 languages\n *   - Future extensibility (AI agents, server-side execution)\n *   - Command-specific semantics (fetch, transition)\n * - Each role has distinct grammatical markers per language (see profiles/index.ts)\n * - Usage percentages based on pattern database analysis\n */\nexport type SemanticRole =\n  // Core thematic roles\n  | 'action' // The command/verb (increment, put, toggle)\n  | 'agent' // Who/what performs action (reserved for future: AI agents, server-side)\n  | 'patient' // What is acted upon (the counter, .active)\n  | 'source' // Origin (from #input, from URL)\n  | 'destination' // Target location (into #output, to .class)\n  | 'goal' // Target value/state (to 'red', to 100)\n  | 'event' // Trigger (click, input, keydown)\n  | 'condition' // Boolean expression (if x > 5)\n  // Quantitative roles\n  | 'quantity' // Numeric amount (by 5, 3 times)\n  | 'duration' // Time span (for 5 seconds, over 500ms)\n  // Adverbial roles\n  | 'responseType' // Response format (as json, as text, as html)\n  | 'method' // HTTP method/technique (via POST, using GET)\n  | 'style' // Visual/behavioral manner (with fade, smoothly)\n  | 'manner' // Insertion position (before, after)\n  // Control flow roles\n  | 'loopType' // Loop variant: forever, times, for, while, until, until-event\n  // Structural roles (for parser control)\n  | 'continues'; // Continuation marker (then-chains)\n\n/**\n * Word order patterns\n * These represent the major typological categories\n */\nexport type WordOrder = 'SVO' | 'SOV' | 'VSO' | 'VOS' | 'OVS' | 'OSV' | 'free';\n\n/**\n * Where grammatical markers appear relative to their noun/verb\n */\nexport type AdpositionType = 'preposition' | 'postposition' | 'circumposition' | 'none';\n\n/**\n * Morphological typology - how words are constructed\n */\nexport type MorphologyType =\n  | 'isolating' // Chinese - no inflection, word order matters\n  | 'agglutinative' // Turkish, Japanese - morphemes stack predictably\n  | 'fusional' // Arabic, Spanish - morphemes blend together\n  | 'polysynthetic'; // Quechua - complex words encode full sentences\n\n/**\n * A grammatical marker (particle, case ending, preposition)\n */\nexport interface GrammaticalMarker {\n  form: string; // The actual text (を, に, to, 的)\n  role: SemanticRole; // What semantic role it marks\n  position: AdpositionType; // Where it appears\n  required: boolean; // Is it mandatory?\n  alternatives?: string[]; // Alternative forms (e.g., 을/를 in Korean)\n}\n\n/**\n * Metadata for preserving line structure during translation.\n * Tracks indentation and blank lines so output maintains the same format.\n */\nexport interface LineMetadata {\n  /** Trimmed line content (empty string for blank lines) */\n  content: string;\n  /** Leading whitespace (tabs/spaces) from original line */\n  originalIndent: string;\n  /** True if the line was empty or whitespace-only */\n  isBlank: boolean;\n}\n\n// =============================================================================\n// Language Profile\n// =============================================================================\n\n/**\n * Complete grammatical profile for a language\n * This captures the essential typological features needed for transformation\n */\nexport interface LanguageProfile {\n  code: string; // ISO 639-1 code\n  name: string; // Native name\n\n  // Typological features\n  wordOrder: WordOrder;\n  adpositionType: AdpositionType;\n  morphology: MorphologyType;\n  direction: 'ltr' | 'rtl';\n\n  // Grammatical markers for each semantic role\n  markers: GrammaticalMarker[];\n\n  // Role ordering - which semantic roles come in what order\n  // E.g., Japanese: ['patient', 'source', 'destination', 'action']\n  // E.g., English: ['action', 'patient', 'source', 'destination']\n  canonicalOrder: SemanticRole[];\n\n  // Special rules\n  rules?: GrammarRule[];\n}\n\n/**\n * Pattern for transforming hyperscript structures\n */\nexport interface GrammarRule {\n  name: string;\n  description: string;\n\n  // Pattern matching (in canonical English form)\n  match: PatternMatcher;\n\n  // How to transform for this language\n  transform: PatternTransform;\n\n  // Priority (higher = checked first)\n  priority: number;\n}\n\n/**\n * Matches a hyperscript pattern\n */\nexport interface PatternMatcher {\n  // Command type(s) this matches\n  commands?: string[];\n\n  // Required semantic roles\n  requiredRoles: SemanticRole[];\n\n  // Optional roles\n  optionalRoles?: SemanticRole[];\n\n  // Custom predicate for complex matching\n  predicate?: (parsed: ParsedStatement) => boolean;\n}\n\n/**\n * Defines how to transform a matched pattern\n */\nexport interface PatternTransform {\n  // Reorder roles for target language\n  roleOrder: SemanticRole[];\n\n  // Insert markers between roles\n  insertMarkers?: boolean;\n\n  // Custom transformation function\n  custom?: (parsed: ParsedStatement, profile: LanguageProfile) => string;\n}\n\n// =============================================================================\n// Parsed Structures\n// =============================================================================\n\n/**\n * A parsed hyperscript statement broken into semantic components\n */\nexport interface ParsedStatement {\n  type: 'event-handler' | 'command' | 'conditional' | 'loop';\n  roles: Map<SemanticRole, ParsedElement>;\n  original: string;\n}\n\n/**\n * A single element with its semantic role\n */\nexport interface ParsedElement {\n  role: SemanticRole;\n  value: string; // Original English value\n  translated?: string; // Translated value\n  isSelector?: boolean; // CSS selector (don't translate)\n  isLiteral?: boolean; // Literal value (don't translate)\n}\n\n// =============================================================================\n// Universal Pattern Templates\n// =============================================================================\n\n/**\n * Universal templates for common hyperscript patterns\n * These define the semantic structure independent of surface form\n */\nexport const UNIVERSAL_PATTERNS = {\n  // on click increment #count\n  eventIncrement: {\n    name: 'event-increment',\n    roles: ['event', 'action', 'patient'] as SemanticRole[],\n    english: 'on {event} {action} {patient}',\n  },\n\n  // put X into Y\n  putInto: {\n    name: 'put-into',\n    roles: ['action', 'patient', 'destination'] as SemanticRole[],\n    english: '{action} {patient} into {destination}',\n  },\n\n  // add .class to element\n  addTo: {\n    name: 'add-to',\n    roles: ['action', 'patient', 'destination'] as SemanticRole[],\n    english: '{action} {patient} to {destination}',\n  },\n\n  // toggle .class on element\n  toggleOn: {\n    name: 'toggle-on',\n    roles: ['action', 'patient', 'destination'] as SemanticRole[],\n    english: '{action} {patient} on {destination}',\n  },\n\n  // wait 2 seconds\n  waitDuration: {\n    name: 'wait-duration',\n    roles: ['action', 'quantity'] as SemanticRole[],\n    english: '{action} {quantity}',\n  },\n\n  // if condition then ... end\n  conditional: {\n    name: 'conditional',\n    roles: ['action', 'condition'] as SemanticRole[],\n    english: '{action} {condition} then ... end',\n  },\n\n  // fetch URL as type\n  fetchAs: {\n    name: 'fetch-as',\n    roles: ['action', 'source', 'method'] as SemanticRole[],\n    english: '{action} {source} as {method}',\n  },\n\n  // show element with animation\n  showWith: {\n    name: 'show-with',\n    roles: ['action', 'patient', 'style'] as SemanticRole[],\n    english: '{action} {patient} with {style}',\n  },\n\n  // transition property over duration\n  transitionOver: {\n    name: 'transition-over',\n    roles: ['action', 'patient', 'duration'] as SemanticRole[],\n    english: '{action} {patient} over {duration}',\n  },\n} as const;\n\n// =============================================================================\n// Language Family Defaults\n// =============================================================================\n\n/**\n * Default profiles for major language families\n * Individual languages inherit and override these\n */\nexport const LANGUAGE_FAMILY_DEFAULTS: Record<string, Partial<LanguageProfile>> = {\n  // Germanic (English, German, Dutch)\n  germanic: {\n    wordOrder: 'SVO',\n    adpositionType: 'preposition',\n    morphology: 'fusional',\n    direction: 'ltr',\n    canonicalOrder: [\n      'action',\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n\n  // Romance (Spanish, French, Italian, Portuguese)\n  romance: {\n    wordOrder: 'SVO',\n    adpositionType: 'preposition',\n    morphology: 'fusional',\n    direction: 'ltr',\n    canonicalOrder: [\n      'action',\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n\n  // Japonic (Japanese)\n  japonic: {\n    wordOrder: 'SOV',\n    adpositionType: 'postposition',\n    morphology: 'agglutinative',\n    direction: 'ltr',\n    canonicalOrder: [\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n      'action',\n    ],\n  },\n\n  // Koreanic (Korean)\n  koreanic: {\n    wordOrder: 'SOV',\n    adpositionType: 'postposition',\n    morphology: 'agglutinative',\n    direction: 'ltr',\n    canonicalOrder: [\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n      'action',\n    ],\n  },\n\n  // Turkic (Turkish, Azerbaijani)\n  turkic: {\n    wordOrder: 'SOV',\n    adpositionType: 'postposition',\n    morphology: 'agglutinative',\n    direction: 'ltr',\n    canonicalOrder: [\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n      'action',\n    ],\n  },\n\n  // Sinitic (Chinese, Cantonese)\n  sinitic: {\n    wordOrder: 'SVO', // Topic-prominent, flexible\n    adpositionType: 'preposition',\n    morphology: 'isolating',\n    direction: 'ltr',\n    canonicalOrder: [\n      'action',\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n\n  // Semitic (Arabic, Hebrew)\n  semitic: {\n    wordOrder: 'VSO',\n    adpositionType: 'preposition',\n    morphology: 'fusional', // Root-pattern system\n    direction: 'rtl',\n    canonicalOrder: [\n      'action',\n      'agent',\n      'patient',\n      'destination',\n      'source',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n\n  // Austronesian (Indonesian, Tagalog)\n  austronesian: {\n    wordOrder: 'SVO',\n    adpositionType: 'preposition',\n    morphology: 'agglutinative',\n    direction: 'ltr',\n    canonicalOrder: [\n      'action',\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n\n  // Quechuan (Quechua)\n  quechuan: {\n    wordOrder: 'SOV',\n    adpositionType: 'postposition',\n    morphology: 'agglutinative', // Actually polysynthetic but simplified\n    direction: 'ltr',\n    canonicalOrder: [\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n      'action',\n    ],\n  },\n\n  // Bantu (Swahili)\n  bantu: {\n    wordOrder: 'SVO',\n    adpositionType: 'preposition',\n    morphology: 'agglutinative',\n    direction: 'ltr',\n    canonicalOrder: [\n      'action',\n      'patient',\n      'source',\n      'destination',\n      'quantity',\n      'duration',\n      'method',\n      'style',\n    ],\n  },\n};\n\n// =============================================================================\n// Transformation Utilities\n// =============================================================================\n\n/**\n * Reorder semantic roles according to target language.\n * Includes a safety net to append any roles present in input\n * but missing from the target order, preventing data loss.\n */\nexport function reorderRoles(\n  roles: Map<SemanticRole, ParsedElement>,\n  targetOrder: SemanticRole[]\n): ParsedElement[] {\n  const result: ParsedElement[] = [];\n  const usedRoles = new Set<SemanticRole>();\n\n  // 1. Add roles that are explicitly in the canonical order\n  for (const role of targetOrder) {\n    const element = roles.get(role);\n    if (element) {\n      result.push(element);\n      usedRoles.add(role);\n    }\n  }\n\n  // 2. Safety Net: Append any roles present in input but missing from target order\n  // This prevents data loss (e.g., if 'manner' or 'instrument' isn't in the profile)\n  for (const [role, element] of roles) {\n    if (!usedRoles.has(role)) {\n      result.push(element);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Insert grammatical markers between elements\n */\nexport function insertMarkers(\n  elements: ParsedElement[],\n  markers: GrammaticalMarker[],\n  adpositionType: AdpositionType\n): string[] {\n  const result: string[] = [];\n\n  for (const element of elements) {\n    const marker = markers.find(m => m.role === element.role);\n\n    if (marker) {\n      if (adpositionType === 'preposition') {\n        // Marker before element: \"to element\"\n        if (marker.form) result.push(marker.form);\n        result.push(element.translated || element.value);\n      } else if (adpositionType === 'postposition') {\n        // Marker after element: \"element を\"\n        result.push(element.translated || element.value);\n        if (marker.form) result.push(marker.form);\n      } else {\n        result.push(element.translated || element.value);\n      }\n    } else {\n      result.push(element.translated || element.value);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Intelligently joins tokens, handling agglutinative suffixes and prefixes.\n *\n * Rules:\n * 1. If a token ends with '-' (prefix marker), no space after it\n * 2. If a token starts with '-' (suffix marker), no space before it\n * 3. Removes the hyphen indicators from the final output\n *\n * Examples:\n * - ['#count', '-ta'] → '#countta' (Quechua accusative suffix)\n * - ['بـ-', 'الماوس'] → 'بـالماوس' (Arabic prefix attachment)\n * - ['value', 'を'] → 'value を' (Japanese particle, normal spacing)\n */\nexport function joinTokens(tokens: string[]): string {\n  if (tokens.length === 0) return '';\n\n  let result = '';\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i];\n    const nextToken = tokens[i + 1];\n\n    // Check if current token is a prefix (ends with -)\n    const isPrefix = token.endsWith('-');\n    // Check if current token is a suffix (starts with -)\n    const isSuffix = token.startsWith('-');\n\n    // Get the display form (strip hyphen markers)\n    let displayToken = token;\n    if (isPrefix) displayToken = token.slice(0, -1);\n    if (isSuffix) displayToken = token.substring(1);\n\n    result += displayToken;\n\n    // Determine if we need a space before the next token\n    if (nextToken) {\n      const nextIsSuffix = nextToken.startsWith('-');\n\n      // Don't add space if:\n      // - Current token is a prefix (ends with -)\n      // - Next token is a suffix (starts with -)\n      if (!isPrefix && !nextIsSuffix) {\n        result += ' ';\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Transform a parsed statement to target language\n */\nexport function transformStatement(\n  parsed: ParsedStatement,\n  _sourceProfile: LanguageProfile,\n  targetProfile: LanguageProfile\n): string {\n  // 1. Reorder roles for target language\n  const reordered = reorderRoles(parsed.roles, targetProfile.canonicalOrder);\n\n  // 2. Insert grammatical markers\n  const withMarkers = insertMarkers(reordered, targetProfile.markers, targetProfile.adpositionType);\n\n  // 3. Join with intelligent spacing for agglutinative languages\n  // (handles suffixes like -ta, prefixes like بـ-, etc.)\n  return joinTokens(withMarkers);\n}\n","/**\n * Grammar Transformer - Dependency Injection Architecture\n *\n * Transforms statements between languages using injected dependencies.\n * This makes the transformer completely domain-agnostic.\n */\n\nimport type { LanguageProfile, ParsedElement, SemanticRole } from './types';\nimport { reorderRoles, insertMarkers, joinTokens } from './types';\nimport type { Dictionary } from '../interfaces/dictionary';\nimport type { ProfileProvider } from '../interfaces/profile-provider';\n\n/**\n * Configuration for grammar transformer.\n */\nexport interface TransformerConfig {\n  /** Dictionary for keyword translation */\n  readonly dictionary: Dictionary;\n\n  /** Profile provider for grammar rules */\n  readonly profileProvider: ProfileProvider;\n}\n\n/**\n * Generic grammar transformer using dependency injection.\n *\n * @example\n * const transformer = new GrammarTransformer({\n *   dictionary: new InMemoryDictionary(translations),\n *   profileProvider: new InMemoryProfileProvider(profiles)\n * });\n *\n * const japanese = transformer.transform('select name from users', 'en', 'ja');\n * // → \"users から name を 選択\"\n */\nexport class GrammarTransformer {\n  private dictionary: Dictionary;\n  private profileProvider: ProfileProvider;\n\n  constructor(config: TransformerConfig) {\n    this.dictionary = config.dictionary;\n    this.profileProvider = config.profileProvider;\n  }\n\n  /**\n   * Transform a statement from one language to another.\n   *\n   * @param input - Statement in source language\n   * @param fromLanguage - Source language code\n   * @param toLanguage - Target language code\n   * @returns Transformed statement in target language\n   *\n   * @throws Error if profiles not found or translation fails\n   */\n  transform(input: string, fromLanguage: string, toLanguage: string): string {\n    // Get language profiles\n    const fromProfile = this.profileProvider.getProfile(fromLanguage);\n    const toProfile = this.profileProvider.getProfile(toLanguage);\n\n    if (!fromProfile) {\n      throw new Error(`No profile found for language: ${fromLanguage}`);\n    }\n    if (!toProfile) {\n      throw new Error(`No profile found for language: ${toLanguage}`);\n    }\n\n    // Parse statement to semantic roles\n    const parsed = this.parseStatement(input, fromLanguage, fromProfile);\n\n    // Translate each word\n    const translated = this.translateRoles(parsed, fromLanguage, toLanguage);\n\n    // Reorder and insert markers\n    const reordered = reorderRoles(translated, toProfile.canonicalOrder);\n\n    const withMarkers = insertMarkers(reordered, toProfile.markers, toProfile.adpositionType);\n\n    return joinTokens(withMarkers);\n  }\n\n  /**\n   * Parse statement into semantic roles.\n   * This is a simplified generic parser - DSLs can provide custom parsers.\n   */\n  private parseStatement(\n    input: string,\n    language: string,\n    profile: LanguageProfile\n  ): Map<SemanticRole, string> {\n    const roles = new Map<SemanticRole, string>();\n    const tokens = input.split(/\\s+/);\n\n    // Simple parsing: extract roles based on markers\n    let i = 0;\n    while (i < tokens.length) {\n      const token = tokens[i];\n\n      // Check if token is a marker\n      const marker = profile.markers.find(m => m.form === token);\n\n      if (marker) {\n        // Next token is the value for this role\n        if (i + 1 < tokens.length) {\n          roles.set(marker.role, tokens[i + 1]);\n          i += 2;\n        } else {\n          i++;\n        }\n      } else {\n        // Look up token in dictionary to find its role\n        const canonical = this.dictionary.lookup(token, language);\n\n        if (canonical) {\n          // Assume it's the action (command keyword)\n          roles.set('action', canonical);\n        } else {\n          // Assume it's a value (selector, identifier, etc.)\n          // Try to guess the role based on syntax\n          if (token.startsWith('#') || token.startsWith('.')) {\n            roles.set('patient', token);\n          } else {\n            // Default to patient for unknown values\n            roles.set('patient', token);\n          }\n        }\n\n        i++;\n      }\n    }\n\n    return roles;\n  }\n\n  /**\n   * Translate roles using injected dictionary.\n   * Returns a Map of ParsedElement objects expected by reorderRoles.\n   */\n  private translateRoles(\n    roles: Map<SemanticRole, string>,\n    _fromLanguage: string,\n    toLanguage: string\n  ): Map<SemanticRole, ParsedElement> {\n    const result = new Map<SemanticRole, ParsedElement>();\n\n    for (const [role, value] of roles) {\n      // Translate using dictionary\n      const translated = this.dictionary.translate(value, toLanguage);\n\n      // Create ParsedElement with role, value, and translated\n      result.set(role, {\n        role,\n        value, // Original value\n        translated: translated ?? value, // Translated value or original if no translation\n      });\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/grammar/transformer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Grammar Transformer - Dependency Injection Architecture
+ *
+ * Transforms statements between languages using injected dependencies.
+ * This makes the transformer completely domain-agnostic.
+ */
+import type { Dictionary } from '../interfaces/dictionary';
+import type { ProfileProvider } from '../interfaces/profile-provider';
+/**
+ * Configuration for grammar transformer.
+ */
+export interface TransformerConfig {
+    /** Dictionary for keyword translation */
+    readonly dictionary: Dictionary;
+    /** Profile provider for grammar rules */
+    readonly profileProvider: ProfileProvider;
+}
+/**
+ * Generic grammar transformer using dependency injection.
+ *
+ * @example
+ * const transformer = new GrammarTransformer({
+ *   dictionary: new InMemoryDictionary(translations),
+ *   profileProvider: new InMemoryProfileProvider(profiles)
+ * });
+ *
+ * const japanese = transformer.transform('select name from users', 'en', 'ja');
+ * // → "users から name を 選択"
+ */
+export declare class GrammarTransformer {
+    private dictionary;
+    private profileProvider;
+    constructor(config: TransformerConfig);
+    /**
+     * Transform a statement from one language to another.
+     *
+     * @param input - Statement in source language
+     * @param fromLanguage - Source language code
+     * @param toLanguage - Target language code
+     * @returns Transformed statement in target language
+     *
+     * @throws Error if profiles not found or translation fails
+     */
+    transform(input: string, fromLanguage: string, toLanguage: string): string;
+    /**
+     * Parse statement into semantic roles.
+     * This is a simplified generic parser - DSLs can provide custom parsers.
+     */
+    private parseStatement;
+    /**
+     * Translate roles using injected dictionary.
+     * Returns a Map of ParsedElement objects expected by reorderRoles.
+     */
+    private translateRoles;
+}
+//# sourceMappingURL=transformer.d.ts.map

package/dist/grammar/transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer.d.ts","sourceRoot":"","sources":["../../src/grammar/transformer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAEhC,yCAAyC;IACzC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,EAAE,iBAAiB;IAKrC;;;;;;;;;OASG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IA0B1E;;;OAGG;IACH,OAAO,CAAC,cAAc;IAiDtB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAqBvB"}