@lokascript/framework 2.0.0

package/dist/api/index.js

@@ -0,0 +1,2082 @@
+// src/core/types.ts
+function createLiteral(value, dataType) {
+  return dataType ? { type: "literal", value, dataType } : { type: "literal", value };
+}
+function createSelector(value, selectorKind) {
+  return selectorKind ? { type: "selector", value, selectorKind } : { type: "selector", value };
+}
+function createReference(value) {
+  return { type: "reference", value };
+}
+function createPropertyPath(object, property) {
+  return { type: "property-path", object, property };
+}
+
+// src/core/logger.ts
+var DebugLogger = class {
+  constructor(namespace) {
+    this.namespace = namespace;
+    this.enabled = this.checkEnabled();
+  }
+  checkEnabled() {
+    if (typeof process !== "undefined" && process.env) {
+      const DEBUG = process.env.DEBUG || "";
+      return DEBUG === "*" || DEBUG.includes("framework:*") || DEBUG.includes(`framework:${this.namespace}`);
+    }
+    return false;
+  }
+  log(level, message, ...args) {
+    if (!this.enabled) return;
+    const prefix = `[framework:${this.namespace}]`;
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    switch (level) {
+      case "debug":
+        console.debug(`${timestamp} ${prefix} DEBUG:`, message, ...args);
+        break;
+      case "info":
+        console.info(`${timestamp} ${prefix} INFO:`, message, ...args);
+        break;
+      case "warn":
+        console.warn(`${timestamp} ${prefix} WARN:`, message, ...args);
+        break;
+      case "error":
+        console.error(`${timestamp} ${prefix} ERROR:`, message, ...args);
+        break;
+    }
+  }
+  debug(message, ...args) {
+    this.log("debug", message, ...args);
+  }
+  info(message, ...args) {
+    this.log("info", message, ...args);
+  }
+  warn(message, ...args) {
+    this.log("warn", message, ...args);
+  }
+  error(message, ...args) {
+    this.log("error", message, ...args);
+  }
+  /**
+   * Check if logging is enabled for this namespace.
+   */
+  isEnabled() {
+    return this.enabled;
+  }
+  /**
+   * Programmatically enable logging for this namespace.
+   */
+  enable() {
+    this.enabled = true;
+  }
+  /**
+   * Programmatically disable logging for this namespace.
+   */
+  disable() {
+    this.enabled = false;
+  }
+};
+function createLogger(namespace) {
+  return new DebugLogger(namespace);
+}
+
+// src/core/pattern-matching/utils/type-validation.ts
+function isTypeCompatible(actualType, expectedTypes) {
+  if (!expectedTypes || expectedTypes.length === 0) {
+    return true;
+  }
+  if (expectedTypes.includes(actualType)) {
+    return true;
+  }
+  if (expectedTypes.includes("expression")) {
+    return true;
+  }
+  if (actualType === "property-path") {
+    return expectedTypes.some((t) => ["selector", "reference", "expression"].includes(t));
+  }
+  return false;
+}
+
+// src/core/pattern-matching/utils/possessive-keywords.ts
+function getPossessiveReference(profile, keyword) {
+  return profile?.possessive?.keywords?.[keyword];
+}
+
+// src/core/pattern-matching/pattern-matcher.ts
+function isValidReference(_value) {
+  return false;
+}
+var _PatternMatcher = class _PatternMatcher {
+  constructor() {
+    /** Debug logger */
+    this.logger = createLogger("pattern-matcher");
+    /**
+     * Track stem matches for confidence calculation.
+     * This is set during matching and read during confidence calculation.
+     */
+    this.stemMatchCount = 0;
+    this.totalKeywordMatches = 0;
+  }
+  /**
+   * Safely convert a value to lowercase string.
+   * Provides protection against non-string values at runtime.
+   */
+  safeToLowerCase(value) {
+    if (typeof value === "string") {
+      return value.toLowerCase();
+    }
+    if (value === null || value === void 0) {
+      return "";
+    }
+    return String(value).toLowerCase();
+  }
+  /**
+   * Try to match a single pattern against the token stream.
+   * Returns the match result or null if no match.
+   *
+   * @param tokens - Token stream to match against
+   * @param pattern - Pattern to match
+   * @param profile - Optional language profile for possessive handling
+   */
+  matchPattern(tokens, pattern, profile) {
+    const mark = tokens.mark();
+    const captured = /* @__PURE__ */ new Map();
+    this.logger.debug("========================================");
+    this.logger.debug("matchPattern ENTRY");
+    this.logger.debug("Pattern ID:", pattern.id);
+    this.logger.debug("Pattern command:", pattern.command);
+    this.logger.debug("Pattern language:", pattern.language);
+    this.logger.debug("Pattern template:", JSON.stringify(pattern.template, null, 2));
+    if (this.logger.isEnabled()) {
+      const firstTokens = [];
+      for (let i = 0; i < 10; i++) {
+        const t = tokens.peek(i);
+        if (t)
+          firstTokens.push({
+            type: t.type,
+            value: t.value,
+            kind: t.kind
+          });
+        else break;
+      }
+      this.logger.debug("Input tokens (first 10):", firstTokens);
+      this.logger.debug("Profile code:", profile?.code);
+    }
+    this.currentProfile = profile;
+    this.stemMatchCount = 0;
+    this.totalKeywordMatches = 0;
+    this.logger.debug("--- Calling matchTokenSequence ---");
+    this.logger.debug("Pattern tokens to match:", JSON.stringify(pattern.template.tokens, null, 2));
+    const success = this.matchTokenSequence(tokens, pattern.template.tokens, captured);
+    this.logger.debug("matchTokenSequence returned:", success);
+    this.logger.debug(
+      "Captured roles:",
+      Array.from(captured.entries()).map(([k, v]) => [k, JSON.stringify(v)])
+    );
+    if (!success) {
+      this.logger.debug(">>> MATCH FAILED - resetting token position");
+      tokens.reset(mark);
+      return null;
+    }
+    const confidence = this.calculateConfidence(pattern, captured);
+    this.applyExtractionRules(pattern, captured);
+    return {
+      pattern,
+      captured,
+      consumedTokens: tokens.position() - mark.position,
+      confidence
+    };
+  }
+  /**
+   * Try to match multiple patterns, return the best match.
+   *
+   * @param tokens - Token stream to match against
+   * @param patterns - Candidate patterns to try
+   * @param profile - Optional language profile for possessive handling
+   */
+  matchBest(tokens, patterns, profile) {
+    const matches = [];
+    for (const pattern of patterns) {
+      const mark = tokens.mark();
+      const result = this.matchPattern(tokens, pattern, profile);
+      if (result) {
+        matches.push(result);
+      }
+      tokens.reset(mark);
+    }
+    if (matches.length === 0) {
+      return null;
+    }
+    matches.sort((a, b) => {
+      const priorityDiff = b.pattern.priority - a.pattern.priority;
+      if (priorityDiff !== 0) return priorityDiff;
+      const confidenceDiff = b.confidence - a.confidence;
+      if (Math.abs(confidenceDiff) > 1e-3) return confidenceDiff;
+      return b.consumedTokens - a.consumedTokens;
+    });
+    const best = matches[0];
+    this.matchPattern(tokens, best.pattern);
+    return best;
+  }
+  /**
+   * Match a sequence of pattern tokens against the token stream.
+   *
+   * Supports bounded single-step backtracking: if an optional role consumes
+   * a token and the immediately following pattern token fails, the matcher
+   * resets to before the optional role and retries the failed token.
+   */
+  matchTokenSequence(tokens, patternTokens, captured) {
+    const firstPatternToken = patternTokens[0];
+    const patternExpectsConjunction = firstPatternToken?.type === "literal" && (firstPatternToken.value === "and" || firstPatternToken.value === "then" || firstPatternToken.alternatives?.includes("and") || firstPatternToken.alternatives?.includes("then"));
+    if (this.currentProfile?.code === "ar" && !patternExpectsConjunction) {
+      while (tokens.peek()?.kind === "conjunction") {
+        tokens.advance();
+      }
+    }
+    let prevOptionalMark = null;
+    let prevOptionalRole = null;
+    for (let i = 0; i < patternTokens.length; i++) {
+      const patternToken = patternTokens[i];
+      this.logger.debug("  >> Matching pattern token:", JSON.stringify(patternToken, null, 2));
+      const currTok = tokens.peek();
+      this.logger.debug(
+        "  >> Current input token:",
+        currTok ? JSON.stringify({
+          type: currTok.type,
+          value: currTok.value,
+          kind: currTok.kind
+        }) : "EOF"
+      );
+      if (patternToken.type === "role" && patternToken.greedy) {
+        const stopMarkers = this.collectStopMarkers(patternTokens, i + 1);
+        const values = [];
+        while (!tokens.isAtEnd()) {
+          const nextToken = tokens.peek();
+          if (!nextToken) break;
+          if (this.isStopMarker(nextToken, stopMarkers)) break;
+          values.push(nextToken.value);
+          tokens.advance();
+        }
+        if (values.length > 0) {
+          captured.set(patternToken.role, { type: "expression", raw: values.join(" ") });
+          prevOptionalMark = null;
+          prevOptionalRole = null;
+          continue;
+        } else if (patternToken.optional) {
+          continue;
+        } else {
+          return false;
+        }
+      }
+      const isOptionalRole = patternToken.type === "role" && patternToken.optional === true;
+      const markBefore = isOptionalRole ? tokens.mark() : null;
+      const matched = this.matchPatternToken(tokens, patternToken, captured);
+      this.logger.debug("  >> Match result:", matched);
+      if (matched) {
+        if (isOptionalRole) {
+          prevOptionalMark = markBefore;
+          prevOptionalRole = patternToken.role;
+        } else {
+          prevOptionalMark = null;
+          prevOptionalRole = null;
+        }
+        continue;
+      }
+      this.logger.debug("  >> Token match FAILED");
+      if (this.isOptional(patternToken)) {
+        continue;
+      }
+      if (prevOptionalMark && prevOptionalRole) {
+        this.logger.debug("  >> BACKTRACKING: undoing optional role", prevOptionalRole);
+        tokens.reset(prevOptionalMark);
+        captured.delete(prevOptionalRole);
+        prevOptionalMark = null;
+        prevOptionalRole = null;
+        const retryMatched = this.matchPatternToken(tokens, patternToken, captured);
+        this.logger.debug("  >> Backtrack retry result:", retryMatched);
+        if (retryMatched) {
+          continue;
+        }
+      }
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Match a single pattern token against the current position in the stream.
+   */
+  matchPatternToken(tokens, patternToken, captured) {
+    switch (patternToken.type) {
+      case "literal":
+        return this.matchLiteralToken(tokens, patternToken);
+      case "role":
+        return this.matchRoleToken(tokens, patternToken, captured);
+      case "group":
+        return this.matchGroupToken(tokens, patternToken, captured);
+      default:
+        return false;
+    }
+  }
+  /**
+   * Match a literal pattern token (keyword or particle).
+   */
+  matchLiteralToken(tokens, patternToken) {
+    const token = tokens.peek();
+    this.logger.debug("    >>> matchLiteralToken: expecting", patternToken.value);
+    this.logger.debug(
+      "    >>> matchLiteralToken: got token",
+      token ? JSON.stringify({
+        type: token.type,
+        value: token.value,
+        kind: token.kind
+      }) : "null"
+    );
+    if (!token) {
+      this.logger.debug("    >>> matchLiteralToken: FAIL - no token");
+      return false;
+    }
+    const matchType = this.getMatchType(token, patternToken.value);
+    this.logger.debug(
+      "    >>> matchType for",
+      token.value,
+      "vs",
+      patternToken.value,
+      ":",
+      matchType
+    );
+    if (matchType !== "none") {
+      this.totalKeywordMatches++;
+      if (matchType === "stem") {
+        this.stemMatchCount++;
+      }
+      tokens.advance();
+      return true;
+    }
+    if (patternToken.alternatives) {
+      for (const alt of patternToken.alternatives) {
+        const altMatchType = this.getMatchType(token, alt);
+        if (altMatchType !== "none") {
+          this.totalKeywordMatches++;
+          if (altMatchType === "stem") {
+            this.stemMatchCount++;
+          }
+          tokens.advance();
+          return true;
+        }
+      }
+    }
+    return false;
+  }
+  /**
+   * Match a role pattern token (captures a semantic value).
+   * Handles multi-token expressions like:
+   * - 'my value' (possessive keyword + property)
+   * - '#dialog.showModal()' (method call)
+   * - "#element's *opacity" (possessive selector + property)
+   */
+  matchRoleToken(tokens, patternToken, captured) {
+    this.logger.debug("    >>> matchRoleToken ENTRY: capturing role", patternToken.role);
+    this.logger.debug("    >>> matchRoleToken: expected types", patternToken.expectedTypes);
+    this.logger.debug("    >>> matchRoleToken: optional?", patternToken.optional);
+    this.skipNoiseWords(tokens);
+    const token = tokens.peek();
+    this.logger.debug(
+      "    >>> After skipNoiseWords, current token:",
+      token ? JSON.stringify({ value: token.value, kind: token.kind }) : "null"
+    );
+    if (!token) {
+      return patternToken.optional || false;
+    }
+    const possessiveValue = this.tryMatchPossessiveExpression(tokens);
+    if (possessiveValue) {
+      if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+        if (!patternToken.expectedTypes.includes(possessiveValue.type) && !patternToken.expectedTypes.includes("expression")) {
+          return patternToken.optional || false;
+        }
+      }
+      captured.set(patternToken.role, possessiveValue);
+      return true;
+    }
+    const methodCallValue = this.tryMatchMethodCallExpression(tokens);
+    if (methodCallValue) {
+      if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+        if (!patternToken.expectedTypes.includes(methodCallValue.type) && !patternToken.expectedTypes.includes("expression")) {
+          return patternToken.optional || false;
+        }
+      }
+      captured.set(patternToken.role, methodCallValue);
+      return true;
+    }
+    const possessiveSelectorValue = this.tryMatchPossessiveSelectorExpression(tokens);
+    if (possessiveSelectorValue) {
+      if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+        if (!isTypeCompatible(possessiveSelectorValue.type, patternToken.expectedTypes)) {
+          return patternToken.optional || false;
+        }
+      }
+      captured.set(patternToken.role, possessiveSelectorValue);
+      return true;
+    }
+    const propertyAccessValue = this.tryMatchPropertyAccessExpression(tokens);
+    if (propertyAccessValue) {
+      if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+        if (!patternToken.expectedTypes.includes(propertyAccessValue.type) && !patternToken.expectedTypes.includes("expression")) {
+          return patternToken.optional || false;
+        }
+      }
+      captured.set(patternToken.role, propertyAccessValue);
+      return true;
+    }
+    const selectorPropertyValue = this.tryMatchSelectorPropertyExpression(tokens);
+    if (selectorPropertyValue) {
+      if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+        if (!isTypeCompatible(selectorPropertyValue.type, patternToken.expectedTypes)) {
+          return patternToken.optional || false;
+        }
+      }
+      captured.set(patternToken.role, selectorPropertyValue);
+      return true;
+    }
+    this.logger.debug(
+      "    >>> Trying tokenToSemanticValue for token:",
+      token ? JSON.stringify({ value: token.value, kind: token.kind }) : "null"
+    );
+    const value = this.tokenToSemanticValue(token);
+    this.logger.debug(
+      "    >>> tokenToSemanticValue returned:",
+      value ? JSON.stringify(value) : "null"
+    );
+    if (!value) {
+      return patternToken.optional || false;
+    }
+    this.logger.debug(
+      "    >>> Validating type:",
+      value.type,
+      "against expected:",
+      patternToken.expectedTypes
+    );
+    if (patternToken.expectedTypes && patternToken.expectedTypes.length > 0) {
+      if (!isTypeCompatible(value.type, patternToken.expectedTypes)) {
+        this.logger.debug("    >>> TYPE MISMATCH - returning", patternToken.optional || false);
+        return patternToken.optional || false;
+      }
+    }
+    this.logger.debug("    >>> Type validation PASSED");
+    captured.set(patternToken.role, value);
+    tokens.advance();
+    return true;
+  }
+  /**
+   * Try to match a possessive expression like 'my value' or 'its innerHTML'.
+   * Returns the PropertyPathValue if matched, or null if not.
+   */
+  tryMatchPossessiveExpression(tokens) {
+    const token = tokens.peek();
+    if (!token) return null;
+    if (!this.currentProfile) return null;
+    const tokenValue = token.normalized || token.value;
+    const tokenLower = this.safeToLowerCase(tokenValue);
+    const baseRef = getPossessiveReference(this.currentProfile, tokenLower);
+    if (!baseRef) return null;
+    const mark = tokens.mark();
+    tokens.advance();
+    const propertyToken = tokens.peek();
+    if (!propertyToken) {
+      tokens.reset(mark);
+      return null;
+    }
+    if (propertyToken.kind === "identifier" || propertyToken.kind === "keyword" && !this.isStructuralKeyword(propertyToken.value) || propertyToken.kind === "selector" && propertyToken.value.startsWith("*") || propertyToken.kind === "selector" && propertyToken.value.startsWith("@") || propertyToken.kind === "selector" && propertyToken.value.startsWith(".") && /^\.[a-zA-Z_]\w*/.test(propertyToken.value)) {
+      tokens.advance();
+      let propertyName = propertyToken.value;
+      if (propertyToken.kind === "selector" && propertyName.startsWith(".") && /^\.[a-zA-Z_]\w*/.test(propertyName)) {
+        propertyName = propertyName.substring(1);
+      }
+      let chainedProps = propertyName;
+      while (tokens.peek()?.kind === "selector" && tokens.peek().value.startsWith(".") && /^\.[a-zA-Z_]\w*/.test(tokens.peek().value)) {
+        chainedProps += tokens.peek().value;
+        tokens.advance();
+      }
+      const nextPeek = tokens.peek();
+      if (nextPeek?.kind === "literal" && nextPeek.value.startsWith("(")) {
+        chainedProps += nextPeek.value;
+        tokens.advance();
+      }
+      return createPropertyPath(createReference(baseRef), chainedProps);
+    }
+    tokens.reset(mark);
+    return null;
+  }
+  /**
+   * Check if a keyword is a structural keyword (preposition, control flow, etc.)
+   * that shouldn't be consumed as a property name.
+   */
+  isStructuralKeyword(value) {
+    const structural = /* @__PURE__ */ new Set([
+      // Prepositions
+      "into",
+      "in",
+      "to",
+      "from",
+      "at",
+      "by",
+      "with",
+      "without",
+      "before",
+      "after",
+      "of",
+      "as",
+      "on",
+      // Control flow
+      "then",
+      "end",
+      "else",
+      "if",
+      "repeat",
+      "while",
+      "for",
+      // Commands (shouldn't be property names)
+      "toggle",
+      "add",
+      "remove",
+      "put",
+      "set",
+      "show",
+      "hide",
+      "increment",
+      "decrement",
+      "send",
+      "trigger",
+      "call"
+    ]);
+    return structural.has(value.toLowerCase());
+  }
+  /**
+   * Try to match a method call expression like '#dialog.showModal()'.
+   * Pattern: selector + '.' + identifier + '(' + [args] + ')'
+   * Returns an expression value if matched, or null if not.
+   */
+  tryMatchMethodCallExpression(tokens) {
+    const token = tokens.peek();
+    if (!token || token.kind !== "selector") return null;
+    const mark = tokens.mark();
+    tokens.advance();
+    const dotToken = tokens.peek();
+    if (!dotToken || dotToken.kind !== "operator" || dotToken.value !== ".") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    const methodToken = tokens.peek();
+    if (!methodToken || methodToken.kind !== "identifier") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    const openParen = tokens.peek();
+    if (!openParen || openParen.kind !== "punctuation" || openParen.value !== "(") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    const args = [];
+    while (!tokens.isAtEnd() && args.length < _PatternMatcher.MAX_METHOD_ARGS) {
+      const argToken = tokens.peek();
+      if (!argToken) break;
+      if (argToken.kind === "punctuation" && argToken.value === ")") {
+        tokens.advance();
+        break;
+      }
+      if (argToken.kind === "punctuation" && argToken.value === ",") {
+        tokens.advance();
+        continue;
+      }
+      args.push(argToken.value);
+      tokens.advance();
+    }
+    const methodCall = `${token.value}.${methodToken.value}(${args.join(", ")})`;
+    return {
+      type: "expression",
+      raw: methodCall
+    };
+  }
+  /**
+   * Try to match a property access expression like 'userData.name' or 'it.data'.
+   * Pattern: (identifier | keyword) + '.' + identifier [+ '.' + identifier ...]
+   * Returns an expression value if matched, or null if not.
+   */
+  tryMatchPropertyAccessExpression(tokens) {
+    const token = tokens.peek();
+    if (!token) return null;
+    if (token.kind !== "identifier" && token.kind !== "keyword") return null;
+    const mark = tokens.mark();
+    tokens.advance();
+    const dotToken = tokens.peek();
+    if (!dotToken || dotToken.kind !== "operator" || dotToken.value !== ".") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    const propertyToken = tokens.peek();
+    if (!propertyToken || propertyToken.kind !== "identifier") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    let chain = `${token.value}.${propertyToken.value}`;
+    let depth = 1;
+    while (!tokens.isAtEnd() && depth < _PatternMatcher.MAX_PROPERTY_DEPTH) {
+      const nextDot = tokens.peek();
+      if (!nextDot || nextDot.kind !== "operator" || nextDot.value !== ".") {
+        break;
+      }
+      tokens.advance();
+      const nextProp = tokens.peek();
+      if (!nextProp || nextProp.kind !== "identifier") {
+        break;
+      }
+      tokens.advance();
+      chain += `.${nextProp.value}`;
+      depth++;
+    }
+    const openParen = tokens.peek();
+    if (openParen && openParen.kind === "punctuation" && openParen.value === "(") {
+      tokens.advance();
+      const args = [];
+      let argDepth = 0;
+      while (!tokens.isAtEnd() && args.length < _PatternMatcher.MAX_METHOD_ARGS) {
+        const argToken = tokens.peek();
+        if (!argToken) break;
+        if (argToken.kind === "punctuation" && argToken.value === ")") {
+          if (argDepth === 0) {
+            tokens.advance();
+            break;
+          }
+          argDepth--;
+        }
+        if (argToken.kind === "punctuation" && argToken.value === "(") {
+          argDepth++;
+        }
+        if (argToken.kind === "punctuation" && argToken.value === ",") {
+          tokens.advance();
+          continue;
+        }
+        args.push(argToken.value);
+        tokens.advance();
+      }
+      const methodCall = `${chain}(${args.join(", ")})`;
+      return {
+        type: "expression",
+        raw: methodCall
+      };
+    }
+    return {
+      type: "expression",
+      raw: chain
+    };
+  }
+  /**
+   * Try to match a possessive selector expression like "#element's *opacity".
+   * Pattern: selector + "'s" + (selector | identifier)
+   * Returns a property-path value if matched, or null if not.
+   */
+  tryMatchPossessiveSelectorExpression(tokens) {
+    const token = tokens.peek();
+    if (!token || token.kind !== "selector") return null;
+    const mark = tokens.mark();
+    tokens.advance();
+    const possessiveToken = tokens.peek();
+    if (!possessiveToken || possessiveToken.kind !== "punctuation" || possessiveToken.value !== "'s") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    const propertyToken = tokens.peek();
+    if (!propertyToken) {
+      tokens.reset(mark);
+      return null;
+    }
+    if (propertyToken.kind !== "selector" && propertyToken.kind !== "identifier") {
+      tokens.reset(mark);
+      return null;
+    }
+    tokens.advance();
+    return createPropertyPath(createSelector(token.value), propertyToken.value);
+  }
+  /**
+   * Try to match a selector + property expression like "#output.innerText".
+   * This handles cases where the tokenizer produces two selector tokens:
+   * - #output (id selector)
+   * - .innerText (looks like class selector, but is actually property)
+   *
+   * Pattern: id-selector + class-selector-that-is-actually-property
+   * Returns a property-path value if matched, or null if not.
+   */
+  tryMatchSelectorPropertyExpression(tokens) {
+    const token = tokens.peek();
+    if (!token || token.kind !== "selector") return null;
+    if (typeof token.value !== "string" || !token.value.startsWith("#")) return null;
+    const mark = tokens.mark();
+    tokens.advance();
+    const propertyToken = tokens.peek();
+    if (!propertyToken || propertyToken.kind !== "selector") {
+      tokens.reset(mark);
+      return null;
+    }
+    if (!propertyToken.value.startsWith(".")) {
+      tokens.reset(mark);
+      return null;
+    }
+    const peek2 = tokens.peek(1);
+    if (peek2 && peek2.kind === "selector") {
+    }
+    tokens.advance();
+    const propertyName = propertyToken.value.slice(1);
+    return createPropertyPath(createSelector(token.value), propertyName);
+  }
+  /**
+   * Match a group pattern token (optional sequence).
+   * When the group's leading marker isn't at the current position, scans ahead
+   * up to MAX_MARKER_SCAN tokens to find it. This allows unmarked tokens
+   * (e.g., a value like 'hello') to sit between groups without blocking later
+   * marker matches.
+   */
+  matchGroupToken(tokens, patternToken, captured) {
+    const mark = tokens.mark();
+    const capturedBefore = new Set(captured.keys());
+    const success = this.matchTokenSequence(tokens, patternToken.tokens, captured);
+    if (success) return true;
+    tokens.reset(mark);
+    for (const role of captured.keys()) {
+      if (!capturedBefore.has(role)) captured.delete(role);
+    }
+    if (!patternToken.optional) return false;
+    const leadingMarker = this.getGroupLeadingMarker(patternToken);
+    if (leadingMarker) {
+      for (let offset = 1; offset <= _PatternMatcher.MAX_MARKER_SCAN; offset++) {
+        const ahead = tokens.peek(offset);
+        if (!ahead) break;
+        const aheadValue = (ahead.normalized || ahead.value).toLowerCase();
+        if (aheadValue === leadingMarker) {
+          this.logger.debug(
+            "  >> MARKER SCAN: found",
+            leadingMarker,
+            "at offset",
+            offset,
+            "- skipping intervening tokens"
+          );
+          for (let s = 0; s < offset; s++) tokens.advance();
+          const retrySuccess = this.matchTokenSequence(tokens, patternToken.tokens, captured);
+          if (retrySuccess) return true;
+          tokens.reset(mark);
+          for (const role of captured.keys()) {
+            if (!capturedBefore.has(role)) captured.delete(role);
+          }
+          break;
+        }
+      }
+    }
+    return true;
+  }
+  /**
+   * Get the leading marker literal from an optional group.
+   * Returns the lowercase marker value, or null if the group
+   * doesn't start with a literal token (e.g., SOV groups where
+   * the role comes before the marker).
+   */
+  getGroupLeadingMarker(group) {
+    const first = group.tokens[0];
+    if (first?.type === "literal") return first.value.toLowerCase();
+    return null;
+  }
+  /**
+   * Get the type of match for a token against a value.
+   * Used for confidence calculation.
+   */
+  getMatchType(token, value) {
+    if (token.value === value) return "exact";
+    if (token.normalized === value) return "normalized";
+    if (token.stem === value && token.stemConfidence !== void 0 && token.stemConfidence >= 0.7) {
+      return "stem";
+    }
+    if (token.kind === "keyword" && this.safeToLowerCase(token.value) === value.toLowerCase()) {
+      return "case-insensitive";
+    }
+    return "none";
+  }
+  /**
+   * Collect literal values from upcoming pattern tokens that act as stop markers
+   * for greedy role capture. Returns the set of lowercase values.
+   */
+  collectStopMarkers(patternTokens, startIndex) {
+    const markers = /* @__PURE__ */ new Set();
+    for (let j = startIndex; j < patternTokens.length; j++) {
+      const pt = patternTokens[j];
+      if (pt.type === "literal") {
+        markers.add(pt.value.toLowerCase());
+        if (pt.alternatives) {
+          for (const alt of pt.alternatives) {
+            markers.add(alt.toLowerCase());
+          }
+        }
+        break;
+      }
+      if (pt.type === "group") {
+        for (const gt of pt.tokens) {
+          if (gt.type === "literal") {
+            markers.add(gt.value.toLowerCase());
+            if (gt.alternatives) {
+              for (const alt of gt.alternatives) {
+                markers.add(alt.toLowerCase());
+              }
+            }
+            break;
+          }
+        }
+        break;
+      }
+    }
+    return markers;
+  }
+  /**
+   * Check if a token matches any stop marker for greedy capture.
+   */
+  isStopMarker(token, stopMarkers) {
+    if (stopMarkers.size === 0) return false;
+    const value = (token.normalized || token.value).toLowerCase();
+    return stopMarkers.has(value);
+  }
+  /**
+   * Convert a language token to a semantic value.
+   */
+  tokenToSemanticValue(token) {
+    switch (token.kind) {
+      case "selector":
+        return createSelector(token.value);
+      case "literal":
+        return this.parseLiteralValue(token.value);
+      case "keyword":
+        const tokenValue = token.normalized || token.value;
+        const lower = this.safeToLowerCase(tokenValue);
+        if (isValidReference(lower)) {
+          return createReference(lower);
+        }
+        return createLiteral(token.normalized || token.value);
+      case "identifier":
+        if (typeof token.value === "string" && token.value.startsWith(":")) {
+          return createReference(token.value);
+        }
+        const identLower = this.safeToLowerCase(token.value);
+        if (isValidReference(identLower)) {
+          return createReference(identLower);
+        }
+        return { type: "expression", raw: token.value };
+      case "url":
+        return createLiteral(token.value, "string");
+      default:
+        return null;
+    }
+  }
+  /**
+   * Parse a literal value (string, number, boolean).
+   */
+  parseLiteralValue(value) {
+    if (value.startsWith('"') || value.startsWith("'") || value.startsWith("`") || value.startsWith("\u300C")) {
+      const inner = value.slice(1, -1);
+      return createLiteral(inner, "string");
+    }
+    if (value === "true") return createLiteral(true, "boolean");
+    if (value === "false") return createLiteral(false, "boolean");
+    const durationMatch = value.match(/^(\d+(?:\.\d+)?)(ms|s|m|h)?$/);
+    if (durationMatch) {
+      const num2 = parseFloat(durationMatch[1]);
+      const unit = durationMatch[2];
+      if (unit) {
+        return createLiteral(value, "duration");
+      }
+      return createLiteral(num2, "number");
+    }
+    const num = parseFloat(value);
+    if (!isNaN(num)) {
+      return createLiteral(num, "number");
+    }
+    return createLiteral(value, "string");
+  }
+  /**
+   * Apply extraction rules to fill in static values and defaults for missing roles.
+   */
+  applyExtractionRules(pattern, captured) {
+    for (const [role, rule] of Object.entries(pattern.extraction)) {
+      if (!captured.has(role)) {
+        if (rule.value !== void 0) {
+          captured.set(role, { type: "literal", value: rule.value });
+        } else if (rule.default) {
+          captured.set(role, rule.default);
+        }
+      }
+    }
+  }
+  /**
+   * Check if a pattern token is optional.
+   */
+  isOptional(patternToken) {
+    return patternToken.type !== "literal" && patternToken.optional === true;
+  }
+  /**
+   * Calculate confidence score for a match (0-1).
+   *
+   * Confidence is reduced for:
+   * - Stem matches (morphological normalization has inherent uncertainty)
+   * - Missing optional roles (but less penalty if role has a default value)
+   *
+   * Confidence is increased for:
+   * - VSO languages (Arabic) when pattern starts with a verb
+   */
+  calculateConfidence(pattern, captured) {
+    let score = 0;
+    let maxScore = 0;
+    const hasDefault = (role) => {
+      return pattern.extraction?.[role]?.default !== void 0;
+    };
+    for (const token of pattern.template.tokens) {
+      if (token.type === "role") {
+        maxScore += 1;
+        if (captured.has(token.role)) {
+          score += 1;
+        }
+      } else if (token.type === "group") {
+        for (const subToken of token.tokens) {
+          if (subToken.type === "role") {
+            const roleHasDefault = hasDefault(subToken.role);
+            const weight = 0.8;
+            maxScore += weight;
+            if (captured.has(subToken.role)) {
+              score += weight;
+            } else if (roleHasDefault) {
+              score += weight * 0.6;
+            }
+          }
+        }
+      }
+    }
+    let baseConfidence = maxScore > 0 ? score / maxScore : 1;
+    if (this.stemMatchCount > 0 && this.totalKeywordMatches > 0) {
+      const stemPenalty = this.stemMatchCount / this.totalKeywordMatches * 0.15;
+      baseConfidence = Math.max(0.5, baseConfidence - stemPenalty);
+    }
+    const vsoBoost = this.calculateVSOConfidenceBoost(pattern);
+    baseConfidence = Math.min(1, baseConfidence + vsoBoost);
+    const prepositionAdjustment = this.arabicPrepositionDisambiguation(pattern, captured);
+    baseConfidence = Math.max(0, Math.min(1, baseConfidence + prepositionAdjustment));
+    return baseConfidence;
+  }
+  /**
+   * Calculate confidence boost for VSO (Verb-Subject-Object) language patterns.
+   * Arabic naturally uses VSO word order, so patterns that start with a verb
+   * should receive a confidence boost.
+   *
+   * Returns +0.15 confidence boost if:
+   * - Language is Arabic ('ar')
+   * - Pattern's first token is a verb keyword
+   *
+   * @param pattern The language pattern being matched
+   * @returns Confidence boost (0 or 0.15)
+   */
+  calculateVSOConfidenceBoost(pattern) {
+    if (pattern.language !== "ar") {
+      return 0;
+    }
+    const firstToken = pattern.template.tokens[0];
+    if (!firstToken || firstToken.type !== "literal") {
+      return 0;
+    }
+    const ARABIC_VERBS = /* @__PURE__ */ new Set([
+      "\u0628\u062F\u0644",
+      "\u063A\u064A\u0631",
+      "\u0623\u0636\u0641",
+      "\u0623\u0632\u0644",
+      "\u0636\u0639",
+      "\u0627\u062C\u0639\u0644",
+      "\u0639\u064A\u0646",
+      "\u0632\u062F",
+      "\u0627\u0646\u0642\u0635",
+      "\u0633\u062C\u0644",
+      "\u0623\u0638\u0647\u0631",
+      "\u0623\u062E\u0641",
+      "\u0634\u063A\u0644",
+      "\u0623\u0631\u0633\u0644",
+      "\u0631\u0643\u0632",
+      "\u0634\u0648\u0634",
+      "\u062A\u0648\u0642\u0641",
+      "\u0627\u0646\u0633\u062E",
+      "\u0627\u062D\u0630\u0641",
+      "\u0627\u0635\u0646\u0639",
+      "\u0627\u0646\u062A\u0638\u0631",
+      "\u0627\u0646\u062A\u0642\u0627\u0644",
+      "\u0623\u0648"
+    ]);
+    if (ARABIC_VERBS.has(firstToken.value)) {
+      return 0.15;
+    }
+    if (firstToken.alternatives) {
+      for (const alt of firstToken.alternatives) {
+        if (ARABIC_VERBS.has(alt)) {
+          return 0.15;
+        }
+      }
+    }
+    return 0;
+  }
+  /**
+   * Arabic preposition disambiguation for confidence adjustment.
+   *
+   * Different Arabic prepositions are more or less natural for different semantic roles:
+   * - على (on/upon) is preferred for patient/target roles (element selectors)
+   * - إلى (to) is preferred for destination roles
+   * - من (from) is preferred for source roles
+   * - في (in) is preferred for location roles
+   *
+   * This method analyzes the prepositions used with captured semantic roles and
+   * adjusts confidence based on idiomaticity:
+   * - +0.10 for highly idiomatic preposition choices
+   * - -0.10 for less natural preposition choices
+   *
+   * @param pattern The language pattern being matched
+   * @param captured The captured semantic values
+   * @returns Confidence adjustment (-0.10 to +0.10)
+   */
+  arabicPrepositionDisambiguation(pattern, captured) {
+    if (pattern.language !== "ar") {
+      return 0;
+    }
+    let adjustment = 0;
+    const PREFERRED_PREPOSITIONS = {
+      patient: ["\u0639\u0644\u0649"],
+      // element selectors prefer على (on/upon)
+      destination: ["\u0625\u0644\u0649", "\u0627\u0644\u0649"],
+      // destination prefers إلى (to)
+      source: ["\u0645\u0646"],
+      // source prefers من (from)
+      agent: ["\u0645\u0646"],
+      // agent/by prefers من (from/by)
+      manner: ["\u0628"],
+      // manner prefers ب (with/by)
+      style: ["\u0628"],
+      // style prefers ب (with)
+      goal: ["\u0625\u0644\u0649", "\u0627\u0644\u0649"],
+      // target state prefers إلى (to)
+      method: ["\u0628"]
+      // method prefers ب (with/by)
+    };
+    for (const [role, value] of captured.entries()) {
+      const preferred = PREFERRED_PREPOSITIONS[role];
+      if (!preferred || preferred.length === 0) {
+        continue;
+      }
+      const metadata = "metadata" in value ? value.metadata : void 0;
+      if (metadata && typeof metadata.prepositionValue === "string") {
+        const usedPreposition = metadata.prepositionValue;
+        if (preferred.includes(usedPreposition)) {
+          adjustment += 0.1;
+        } else {
+          adjustment -= 0.1;
+        }
+      }
+    }
+    return Math.max(-0.1, Math.min(0.1, adjustment));
+  }
+  /**
+   * Skip noise words like "the" before selectors.
+   * This enables more natural English syntax like "toggle the .active".
+   */
+  skipNoiseWords(tokens) {
+    const token = tokens.peek();
+    if (!token) return;
+    const tokenLower = this.safeToLowerCase(token.value);
+    if (_PatternMatcher.ENGLISH_NOISE_WORDS.has(tokenLower)) {
+      const mark = tokens.mark();
+      tokens.advance();
+      const nextToken = tokens.peek();
+      if (nextToken && nextToken.kind === "selector") {
+        return;
+      }
+      tokens.reset(mark);
+    }
+    if (tokenLower === "class") {
+      tokens.advance();
+    }
+  }
+  /**
+   * Extract event modifiers from the token stream.
+   * Event modifiers are .once, .debounce(N), .throttle(N), .queue(strategy)
+   * that can appear after event names.
+   *
+   * Returns EventModifiers object or undefined if no modifiers found.
+   */
+  extractEventModifiers(tokens) {
+    const modifiers = {};
+    let foundModifier = false;
+    while (!tokens.isAtEnd()) {
+      const token = tokens.peek();
+      if (!token || token.kind !== "event-modifier") {
+        break;
+      }
+      const metadata = token.metadata;
+      if (!metadata) {
+        break;
+      }
+      foundModifier = true;
+      switch (metadata.modifierName) {
+        case "once":
+          modifiers.once = true;
+          break;
+        case "debounce":
+          if (typeof metadata.value === "number") {
+            modifiers.debounce = metadata.value;
+          }
+          break;
+        case "throttle":
+          if (typeof metadata.value === "number") {
+            modifiers.throttle = metadata.value;
+          }
+          break;
+        case "queue":
+          if (metadata.value === "first" || metadata.value === "last" || metadata.value === "all" || metadata.value === "none") {
+            modifiers.queue = metadata.value;
+          }
+          break;
+      }
+      tokens.advance();
+    }
+    return foundModifier ? modifiers : void 0;
+  }
+};
+/** Maximum tokens to scan ahead when looking for a group's leading marker */
+_PatternMatcher.MAX_MARKER_SCAN = 3;
+// ==========================================================================
+// Depth Limits for Expression Parsing (security hardening)
+// ==========================================================================
+/** Maximum depth for nested property access (e.g., a.b.c.d...) */
+_PatternMatcher.MAX_PROPERTY_DEPTH = 10;
+/** Maximum number of arguments in method calls */
+_PatternMatcher.MAX_METHOD_ARGS = 20;
+// ===========================================================================
+// English Idiom Support - Noise Word Handling
+// ===========================================================================
+/**
+ * Noise words that can be skipped in English for more natural syntax.
+ * - "the" before selectors: "toggle the .active" → "toggle .active"
+ * - "class" after class selectors: "add the .visible class" → "add .visible"
+ */
+_PatternMatcher.ENGLISH_NOISE_WORDS = /* @__PURE__ */ new Set(["the", "a", "an"]);
+var PatternMatcher = _PatternMatcher;
+var patternMatcher = new PatternMatcher();
+
+// src/generation/pattern-generator.ts
+var defaultConfig = {
+  basePriority: 100,
+  includeOptionalVariants: true
+};
+function generatePattern(schema, profile, config = defaultConfig) {
+  const id = `${schema.action}-${profile.code}-generated`;
+  const priority = config.basePriority ?? 100;
+  const keyword = profile.keywords[schema.action];
+  if (!keyword) {
+    throw new Error(`No keyword translation for '${schema.action}' in ${profile.code}`);
+  }
+  const tokens = buildTokens(schema, profile, keyword.primary, keyword.alternatives);
+  const extraction = buildExtractionRules(schema, profile);
+  const format = buildFormatString(schema, profile, keyword.primary);
+  return {
+    id,
+    language: profile.code,
+    command: schema.action,
+    priority,
+    template: {
+      format,
+      tokens
+    },
+    extraction
+  };
+}
+function buildTokens(schema, profile, keyword, alternatives) {
+  const tokens = [];
+  const keywordToken = {
+    type: "literal",
+    value: keyword,
+    ...alternatives?.length && { alternatives }
+  };
+  const sortedRoles = sortRolesByWordOrder(schema.roles, profile.wordOrder);
+  if (profile.wordOrder === "SVO") {
+    tokens.push(keywordToken);
+    for (const role of sortedRoles) {
+      addRoleWithMarker(tokens, role, profile);
+    }
+  } else if (profile.wordOrder === "SOV") {
+    for (const role of sortedRoles) {
+      addRoleWithMarker(tokens, role, profile);
+    }
+    tokens.push(keywordToken);
+  } else if (profile.wordOrder === "VSO") {
+    tokens.push(keywordToken);
+    for (const role of sortedRoles) {
+      addRoleWithMarker(tokens, role, profile);
+    }
+  } else {
+    tokens.push(keywordToken);
+    for (const role of sortedRoles) {
+      addRoleWithMarker(tokens, role, profile);
+    }
+  }
+  return tokens;
+}
+function addRoleWithMarker(tokens, roleSpec, profile) {
+  const marker = getMarkerForRole(roleSpec, profile);
+  const isOptional = !roleSpec.required;
+  const roleToken = {
+    type: "role",
+    role: roleSpec.role,
+    optional: isOptional,
+    expectedTypes: roleSpec.expectedTypes,
+    ...roleSpec.greedy && { greedy: true }
+  };
+  if (marker) {
+    const markerInfo = profile.roleMarkers?.[roleSpec.role];
+    const defaultPosition = profile.wordOrder === "SOV" ? "after" : "before";
+    const position = markerInfo?.position ?? defaultPosition;
+    if (isOptional) {
+      if (position === "before") {
+        tokens.push({
+          type: "group",
+          optional: true,
+          tokens: [{ type: "literal", value: marker }, roleToken]
+        });
+      } else {
+        tokens.push({
+          type: "group",
+          optional: true,
+          tokens: [roleToken, { type: "literal", value: marker }]
+        });
+      }
+    } else {
+      if (position === "before") {
+        tokens.push({ type: "literal", value: marker });
+        tokens.push(roleToken);
+      } else {
+        tokens.push(roleToken);
+        tokens.push({ type: "literal", value: marker });
+      }
+    }
+  } else {
+    tokens.push(roleToken);
+  }
+}
+function getMarkerForRole(roleSpec, profile) {
+  if (roleSpec.markerOverride?.[profile.code]) {
+    return roleSpec.markerOverride[profile.code];
+  }
+  return profile.roleMarkers?.[roleSpec.role]?.primary;
+}
+function sortRolesByWordOrder(roles, wordOrder) {
+  const sorted = [...roles];
+  if (wordOrder === "SVO") {
+    sorted.sort((a, b) => (b.svoPosition ?? 0) - (a.svoPosition ?? 0));
+  } else if (wordOrder === "SOV") {
+    sorted.sort((a, b) => (b.sovPosition ?? 0) - (a.sovPosition ?? 0));
+  }
+  return sorted;
+}
+function buildExtractionRules(schema, profile) {
+  const rules = {};
+  for (const roleSpec of schema.roles) {
+    const marker = getMarkerForRole(roleSpec, profile);
+    const rule = {
+      ...roleSpec.default !== void 0 && { default: roleSpec.default },
+      ...marker && { marker }
+    };
+    rules[roleSpec.role] = rule;
+  }
+  return rules;
+}
+function buildFormatString(schema, profile, keyword) {
+  const parts = [];
+  if (profile.wordOrder === "SVO" || profile.wordOrder === "VSO") {
+    parts.push(keyword);
+  }
+  for (const role of schema.roles) {
+    const marker = getMarkerForRole(role, profile);
+    const roleName = `{${role.role}}`;
+    if (marker) {
+      const markerInfo = profile.roleMarkers?.[role.role];
+      if (markerInfo?.position === "after") {
+        parts.push(`${roleName} ${marker}`);
+      } else {
+        parts.push(`${marker} ${roleName}`);
+      }
+    } else {
+      parts.push(roleName);
+    }
+  }
+  if (profile.wordOrder === "SOV") {
+    parts.push(keyword);
+  }
+  return parts.join(" ");
+}
+
+// src/grammar/types.ts
+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;
+}
+
+// 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;
+  }
+};
+
+// src/interfaces/dictionary.ts
+var InMemoryDictionary = class {
+  /**
+   * @param translations - Map of language code to canonical→localized mappings
+   *
+   * @example
+   * new InMemoryDictionary({
+   *   en: { select: 'select', insert: 'insert' },
+   *   es: { select: 'seleccionar', insert: 'insertar' },
+   *   ja: { select: '選択', insert: '挿入' }
+   * })
+   */
+  constructor(translations) {
+    this.translations = translations;
+  }
+  lookup(word, language) {
+    const langDict = this.translations[language];
+    if (!langDict) return void 0;
+    const wordLower = word.toLowerCase();
+    for (const [canonical, localized] of Object.entries(langDict)) {
+      if (localized.toLowerCase() === wordLower) {
+        return canonical;
+      }
+    }
+    return void 0;
+  }
+  translate(canonical, targetLanguage) {
+    return this.translations[targetLanguage]?.[canonical];
+  }
+  getAllTranslations(word, sourceLanguage) {
+    const canonical = this.lookup(word, sourceLanguage);
+    if (!canonical) return {};
+    const result = {};
+    for (const [lang, dict] of Object.entries(this.translations)) {
+      const translation = dict[canonical];
+      if (translation) {
+        result[lang] = translation;
+      }
+    }
+    return result;
+  }
+};
+
+// src/interfaces/profile-provider.ts
+var InMemoryProfileProvider = class {
+  /**
+   * @param profiles - Map of language code to profile
+   *
+   * @example
+   * new InMemoryProfileProvider({
+   *   en: { code: 'en', wordOrder: 'SVO', ... },
+   *   ja: { code: 'ja', wordOrder: 'SOV', ... }
+   * })
+   */
+  constructor(profiles) {
+    this.profiles = profiles;
+  }
+  getProfile(language) {
+    return this.profiles[language];
+  }
+  getSupportedLanguages() {
+    return Object.keys(this.profiles);
+  }
+  hasLanguage(language) {
+    return language in this.profiles;
+  }
+};
+
+// src/api/create-dsl.ts
+var DSLRegistry = class {
+  constructor(config) {
+    this.patterns = /* @__PURE__ */ new Map();
+    this.tokenizers = /* @__PURE__ */ new Map();
+    this.schemas = config.schemas;
+    for (const lang of config.languages) {
+      this.registerLanguage(lang);
+    }
+  }
+  registerLanguage(lang) {
+    this.tokenizers.set(lang.code, lang.tokenizer);
+    const patterns = [];
+    for (const schema of this.schemas) {
+      const pattern = generatePattern(schema, lang.patternProfile);
+      patterns.push(pattern);
+    }
+    this.patterns.set(lang.code, patterns);
+  }
+  getPatterns(language) {
+    return this.patterns.get(language) || [];
+  }
+  getTokenizer(language) {
+    return this.tokenizers.get(language);
+  }
+  getSupportedLanguages() {
+    return Array.from(this.patterns.keys());
+  }
+};
+var MultilingualDSLImpl = class {
+  constructor(config, registry, transformer) {
+    this.registry = registry;
+    this.matcher = new PatternMatcher();
+    this.transformer = transformer;
+    if (config.codeGenerator) {
+      this.codeGenerator = config.codeGenerator;
+    }
+  }
+  parse(input, language) {
+    const result = this.parseWithConfidence(input, language);
+    return result.node;
+  }
+  parseWithConfidence(input, language) {
+    const tokenizer = this.registry.getTokenizer(language);
+    if (!tokenizer) {
+      throw new Error(`No tokenizer registered for language: ${language}`);
+    }
+    const tokens = tokenizer.tokenize(input);
+    const patterns = this.registry.getPatterns(language);
+    const profile = {
+      code: language
+    };
+    for (const pattern of patterns) {
+      const match = this.matcher.matchPattern(tokens, pattern, profile);
+      if (match) {
+        const node = {
+          kind: "command",
+          action: pattern.command,
+          roles: match.captured,
+          metadata: {
+            sourceLanguage: language,
+            sourceText: input,
+            patternId: pattern.id,
+            confidence: match.confidence
+          }
+        };
+        return { node, confidence: match.confidence };
+      }
+    }
+    throw new Error(`No pattern matched for input: ${input}`);
+  }
+  validate(input, language) {
+    try {
+      const result = this.parseWithConfidence(input, language);
+      return {
+        valid: true,
+        node: result.node
+      };
+    } catch (error) {
+      return {
+        valid: false,
+        errors: [error instanceof Error ? error.message : String(error)]
+      };
+    }
+  }
+  translate(input, fromLanguage, toLanguage) {
+    return this.transformer.transform(input, fromLanguage, toLanguage);
+  }
+  compile(input, language) {
+    if (!this.codeGenerator) {
+      return {
+        ok: false,
+        errors: ["No code generator configured for this DSL"]
+      };
+    }
+    try {
+      const result = this.parseWithConfidence(input, language);
+      const code = this.codeGenerator.generate(result.node);
+      return {
+        ok: true,
+        code,
+        node: result.node,
+        metadata: {
+          parser: "semantic",
+          confidence: result.confidence
+        }
+      };
+    } catch (error) {
+      return {
+        ok: false,
+        errors: [error instanceof Error ? error.message : String(error)]
+      };
+    }
+  }
+  getSupportedLanguages() {
+    return this.registry.getSupportedLanguages();
+  }
+};
+function createDefaultDictionary(config) {
+  const translations = {};
+  for (const lang of config.languages) {
+    const keywords = {};
+    for (const [canonical, keywordDef] of Object.entries(lang.patternProfile.keywords)) {
+      keywords[canonical] = keywordDef.primary;
+    }
+    translations[lang.code] = keywords;
+  }
+  return new InMemoryDictionary(translations);
+}
+function createDefaultProfileProvider(config) {
+  const profiles = {};
+  for (const lang of config.languages) {
+    if (lang.grammarProfile) {
+      profiles[lang.code] = lang.grammarProfile;
+    }
+  }
+  return new InMemoryProfileProvider(profiles);
+}
+function createMultilingualDSL(config) {
+  const dictionary = config.dictionary ?? createDefaultDictionary(config);
+  const profileProvider = config.profileProvider ?? createDefaultProfileProvider(config);
+  const transformer = new GrammarTransformer({
+    dictionary,
+    profileProvider
+  });
+  const registry = new DSLRegistry(config);
+  return new MultilingualDSLImpl(config, registry, transformer);
+}
+
+// src/api/domain-registry.ts
+var DomainRegistry = class {
+  constructor() {
+    this.descriptors = /* @__PURE__ */ new Map();
+    this.dslCache = /* @__PURE__ */ new Map();
+    this.rendererCache = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Register a domain.
+   * @throws if a domain with the same name is already registered
+   */
+  register(descriptor) {
+    if (this.descriptors.has(descriptor.name)) {
+      throw new Error(`Domain already registered: ${descriptor.name}`);
+    }
+    this.descriptors.set(descriptor.name, descriptor);
+  }
+  /**
+   * Get all registered domain names.
+   */
+  getDomainNames() {
+    return Array.from(this.descriptors.keys());
+  }
+  /**
+   * Get a specific domain descriptor.
+   */
+  getDescriptor(name) {
+    return this.descriptors.get(name);
+  }
+  /**
+   * Generate MCP tool definitions for all registered domains.
+   */
+  getToolDefinitions() {
+    const tools = [];
+    for (const desc of this.descriptors.values()) {
+      tools.push(...generateToolDefinitions(desc));
+    }
+    return tools;
+  }
+  /**
+   * Check if a tool name belongs to a registered domain.
+   */
+  canHandle(toolName) {
+    const parsed = parseToolName(toolName);
+    if (!parsed) return false;
+    return this.descriptors.has(parsed.domain);
+  }
+  /**
+   * Handle a tool call by dispatching to the appropriate domain.
+   * Returns null if the tool name doesn't match any registered domain.
+   */
+  async handleToolCall(toolName, args) {
+    const parsed = parseToolName(toolName);
+    if (!parsed) return null;
+    const descriptor = this.descriptors.get(parsed.domain);
+    if (!descriptor) return null;
+    try {
+      const dsl = await this.getDSL(descriptor);
+      switch (parsed.operation) {
+        case "parse":
+          return await this.handleParse(descriptor, dsl, args);
+        case "compile":
+          return await this.handleCompile(descriptor, dsl, args);
+        case "validate":
+          return await this.handleValidate(descriptor, dsl, args);
+        case "translate":
+          return await this.handleTranslate(descriptor, dsl, args);
+        default:
+          return jsonResponse({ error: `Unknown operation: ${parsed.operation}` }, true);
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return jsonResponse({ error: `${descriptor.name} tool error: ${message}` }, true);
+    }
+  }
+  /**
+   * Get the DSL instance for a named domain.
+   * Returns null if the domain is not registered.
+   * The DSL is lazily created and cached.
+   */
+  async getDSLForDomain(name) {
+    const descriptor = this.descriptors.get(name);
+    if (!descriptor) return null;
+    return this.getDSL(descriptor);
+  }
+  // ---------------------------------------------------------------------------
+  // Private: DSL/renderer lifecycle
+  // ---------------------------------------------------------------------------
+  async getDSL(descriptor) {
+    const cached = this.dslCache.get(descriptor.name);
+    if (cached) return cached;
+    const dsl = await descriptor.getDSL();
+    this.dslCache.set(descriptor.name, dsl);
+    return dsl;
+  }
+  async getRenderer(descriptor) {
+    if (!descriptor.getRenderer) return null;
+    const cached = this.rendererCache.get(descriptor.name);
+    if (cached) return cached;
+    const renderer = await descriptor.getRenderer();
+    this.rendererCache.set(descriptor.name, renderer);
+    return renderer;
+  }
+  // ---------------------------------------------------------------------------
+  // Private: Tool handlers
+  // ---------------------------------------------------------------------------
+  async handleParse(descriptor, dsl, args) {
+    const input = getString(args, descriptor.inputLabel);
+    if (!input) return missingParam(descriptor.inputLabel);
+    const language = getString(args, "language", "en");
+    const node = dsl.parse(input, language);
+    const roles = {};
+    for (const [key, value] of node.roles) {
+      roles[key] = value;
+    }
+    return jsonResponse({
+      action: node.action,
+      roles,
+      language,
+      [descriptor.inputLabel]: input
+    });
+  }
+  async handleCompile(descriptor, dsl, args) {
+    const input = getString(args, descriptor.inputLabel);
+    if (!input) return missingParam(descriptor.inputLabel);
+    const language = getString(args, "language", "en");
+    const result = dsl.compile(input, language);
+    return jsonResponse({
+      ok: result.ok,
+      code: result.code,
+      errors: result.errors,
+      language,
+      input
+    });
+  }
+  async handleValidate(descriptor, dsl, args) {
+    const input = getString(args, descriptor.inputLabel);
+    if (!input) return missingParam(descriptor.inputLabel);
+    const language = getString(args, "language", "en");
+    const result = dsl.validate(input, language);
+    return jsonResponse({
+      valid: result.valid,
+      errors: result.errors,
+      language,
+      [descriptor.inputLabel]: input
+    });
+  }
+  async handleTranslate(descriptor, dsl, args) {
+    const input = getString(args, descriptor.inputLabel);
+    if (!input) return missingParam(descriptor.inputLabel);
+    const from = getString(args, "from");
+    if (!from) return missingParam("from");
+    const to = getString(args, "to");
+    if (!to) return missingParam("to");
+    const node = dsl.parse(input, from);
+    const compiled = dsl.compile(input, from);
+    let rendered = null;
+    const renderer = await this.getRenderer(descriptor);
+    if (renderer) {
+      try {
+        rendered = typeof renderer === "function" ? renderer(node, to) : renderer.render(node, to);
+      } catch {
+      }
+    }
+    const roles = {};
+    for (const [key, value] of node.roles) {
+      roles[key] = value;
+    }
+    return jsonResponse({
+      input: { [descriptor.inputLabel]: input, language: from },
+      ...rendered != null && { rendered: { text: rendered, language: to } },
+      semantic: { action: node.action, roles },
+      ...compiled.ok && compiled.code != null && { compiled: compiled.code }
+    });
+  }
+};
+function generateToolDefinitions(desc) {
+  const tools = [];
+  const ops = desc.tools ?? ["parse", "compile", "validate", "translate"];
+  const langList = desc.languages.join(", ");
+  for (const op of ops) {
+    switch (op) {
+      case "parse":
+        tools.push({
+          name: `parse_${desc.name}`,
+          description: `Parse a ${desc.description} input into a semantic representation. Supports: ${langList}.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              [desc.inputLabel]: {
+                type: "string",
+                description: desc.inputDescription
+              },
+              language: {
+                type: "string",
+                description: `Language code: ${langList}`,
+                default: "en"
+              }
+            },
+            required: [desc.inputLabel]
+          }
+        });
+        break;
+      case "compile":
+        tools.push({
+          name: `compile_${desc.name}`,
+          description: `Compile a ${desc.description} input to target code. Supports: ${langList}.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              [desc.inputLabel]: {
+                type: "string",
+                description: desc.inputDescription
+              },
+              language: {
+                type: "string",
+                description: `Language code: ${langList}`,
+                default: "en"
+              }
+            },
+            required: [desc.inputLabel]
+          }
+        });
+        break;
+      case "validate":
+        tools.push({
+          name: `validate_${desc.name}`,
+          description: `Validate ${desc.description} syntax. Returns whether it parses successfully and any errors. Supports: ${langList}.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              [desc.inputLabel]: {
+                type: "string",
+                description: `${desc.inputDescription} to validate`
+              },
+              language: {
+                type: "string",
+                description: `Language code: ${langList}`,
+                default: "en"
+              }
+            },
+            required: [desc.inputLabel]
+          }
+        });
+        break;
+      case "translate":
+        tools.push({
+          name: `translate_${desc.name}`,
+          description: `Translate ${desc.description} input between natural languages. Parses in source language and renders in target language.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              [desc.inputLabel]: {
+                type: "string",
+                description: `${desc.inputDescription} to translate`
+              },
+              from: {
+                type: "string",
+                description: `Source language code: ${langList}`
+              },
+              to: {
+                type: "string",
+                description: `Target language code: ${langList}`
+              }
+            },
+            required: [desc.inputLabel, "from", "to"]
+          }
+        });
+        break;
+    }
+  }
+  return tools;
+}
+function parseToolName(name) {
+  const match = name.match(/^(parse|compile|validate|translate)_(.+)$/);
+  if (!match) return null;
+  return { operation: match[1], domain: match[2] };
+}
+function getString(args, name, defaultValue = "") {
+  const value = args[name];
+  return typeof value === "string" ? value : defaultValue;
+}
+function jsonResponse(data, isError) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    ...isError && { isError: true }
+  };
+}
+function missingParam(param) {
+  return jsonResponse({ error: `Missing required parameter: ${param}` }, true);
+}
+
+// src/api/dispatcher.ts
+var COMMENT_PATTERN = /^\s*(\/\/|--|#)/;
+function isSkippableLine(line) {
+  const trimmed = line.trim();
+  return trimmed === "" || COMMENT_PATTERN.test(trimmed);
+}
+var CrossDomainDispatcher = class {
+  constructor(registry, options) {
+    this.registry = registry;
+    this.minConfidence = options?.minConfidence ?? 0.5;
+    this.priority = options?.priority ?? [];
+  }
+  /**
+   * Auto-detect which domain handles the input.
+   * Tries all registered domains and returns the highest-confidence match.
+   * Returns null if no domain matches above minConfidence.
+   */
+  async detect(input, language = "en") {
+    const domainNames = this.registry.getDomainNames();
+    if (domainNames.length === 0) return null;
+    const candidates = [];
+    for (const name of domainNames) {
+      const dsl = await this.registry.getDSLForDomain(name);
+      if (!dsl) continue;
+      try {
+        const { node, confidence } = dsl.parseWithConfidence(input, language);
+        if (confidence >= this.minConfidence) {
+          candidates.push({ domain: name, node, confidence, dsl });
+        }
+      } catch {
+      }
+    }
+    if (candidates.length === 0) return null;
+    candidates.sort((a, b) => {
+      if (b.confidence !== a.confidence) return b.confidence - a.confidence;
+      return this.getPriorityIndex(a.domain) - this.getPriorityIndex(b.domain);
+    });
+    return candidates[0];
+  }
+  /**
+   * Parse multi-line input where each line may belong to a different domain.
+   * Empty lines and comment lines (starting with //, --, or #) are skipped.
+   */
+  async parseComposite(input, language = "en") {
+    const lines = input.split("\n");
+    const statements = [];
+    const errors = [];
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      if (isSkippableLine(line)) continue;
+      const trimmed = line.trim();
+      const result = await this.detect(trimmed, language);
+      if (result) {
+        statements.push({
+          line: i + 1,
+          input: trimmed,
+          domain: result.domain,
+          node: result.node,
+          confidence: result.confidence
+        });
+      } else {
+        errors.push({
+          line: i + 1,
+          input: trimmed,
+          message: "No domain matched this input"
+        });
+      }
+    }
+    return { statements, errors };
+  }
+  /**
+   * Compile input using auto-detected domain.
+   * Returns the compilation result with the domain name.
+   */
+  async compile(input, language = "en") {
+    const detected = await this.detect(input, language);
+    if (!detected) return null;
+    const result = detected.dsl.compile(input, language);
+    return { ...result, domain: detected.domain };
+  }
+  /**
+   * Validate input against all domains, returning the best match.
+   */
+  async validate(input, language = "en") {
+    const detected = await this.detect(input, language);
+    if (!detected) {
+      return { valid: false, errors: ["No domain matched this input"] };
+    }
+    const result = detected.dsl.validate(input, language);
+    return { ...result, domain: detected.domain };
+  }
+  // ---------------------------------------------------------------------------
+  // Private
+  // ---------------------------------------------------------------------------
+  getPriorityIndex(domain) {
+    const idx = this.priority.indexOf(domain);
+    return idx === -1 ? this.priority.length : idx;
+  }
+};
+export {
+  CrossDomainDispatcher,
+  DomainRegistry,
+  createMultilingualDSL
+};
+//# sourceMappingURL=index.js.map