@lokascript/framework 2.5.1 → 2.7.0

package/dist/index.cjs

@@ -47,7 +47,10 @@ __export(index_exports, {
   WhitespaceExtractor: () => WhitespaceExtractor,
   accumulateBlocks: () => accumulateBlocks,
   buildDisambiguation: () => buildDisambiguation,
+  buildDomainTokenizer: () => buildDomainTokenizer,
   buildFeedback: () => buildFeedback,
+  buildLanguageConfig: () => buildLanguageConfig,
+  buildPatternProfile: () => buildPatternProfile,
   buildPhrase: () => buildPhrase,
   buildTablesFromProfiles: () => buildTablesFromProfiles,
   combineClassifiers: () => combineClassifiers,
@@ -78,6 +81,7 @@ __export(index_exports, {
   createUnicodeRangeClassifier: () => createUnicodeRangeClassifier,
   defineCommand: () => import_intent6.defineCommand,
   defineRole: () => import_intent6.defineRole,
+  deriveRoleMarkers: () => deriveRoleMarkers,
   detectWordOrders: () => detectWordOrders,
   extractCssSelector: () => extractCssSelector,
   extractNumber: () => extractNumber,
@@ -2051,7 +2055,8 @@ function createTokenizerContext(tokenizer) {
     direction: tokenizer.direction,
     lookupKeyword: tokenizer.lookupKeyword.bind(tokenizer),
     isKeyword: tokenizer.isKeyword.bind(tokenizer),
-    isKeywordStart: tokenizer.isKeywordStart.bind(tokenizer)
+    isKeywordStart: tokenizer.isKeywordStart.bind(tokenizer),
+    ...tokenizer.isKeywordStartAtBoundary ? { isKeywordStartAtBoundary: tokenizer.isKeywordStartAtBoundary.bind(tokenizer) } : {}
   };
   if (tokenizer.normalizer) {
     return { ...ctx, normalizer: tokenizer.normalizer };
@@ -5007,36 +5012,96 @@ function withDefaultExtractors(tokenizer) {
   return tokenizer;
 }
 
-// src/core/tokenization/char-classifiers.ts
-function createUnicodeRangeClassifier(ranges) {
-  return (char) => {
-    const code = char.charCodeAt(0);
-    return ranges.some(([start, end]) => code >= start && code <= end);
-  };
-}
-function combineClassifiers(...classifiers) {
-  return (char) => classifiers.some((fn) => fn(char));
-}
-function createLatinCharClassifiers(letterPattern) {
-  const isLetter = (char) => letterPattern.test(char);
-  const isIdentifierChar = (char) => isLetter(char) || /[0-9_-]/.test(char);
-  return { isLetter, isIdentifierChar };
-}
-
 // src/core/tokenization/base-tokenizer.ts
 var SIMPLE_TOKENIZER_OPERATOR_SET = new Set(DEFAULT_OPERATORS);
+var MARKER_CONCEPT_NORMALIZEDS = /* @__PURE__ */ new Set([
+  // Role-marker role names (profile.roleMarkers normalizeds)
+  "patient",
+  "destination",
+  "source",
+  "style",
+  "event",
+  "eventMarker",
+  "agent",
+  "goal",
+  "manner",
+  // Prepositional / positional modifier concepts matched via the role mechanism
+  // (profile.keywords "Modifiers"). `before`/`after`/`until` are intentionally
+  // NOT here — they are pattern literals (see the note above).
+  "into",
+  "from",
+  "to",
+  "with",
+  "at",
+  "of",
+  "as",
+  "by",
+  "in",
+  "on",
+  "over",
+  "under",
+  "between",
+  "through",
+  "without"
+]);
+var ENGLISH_DOM_EVENT_NAMES = [
+  "click",
+  "dblclick",
+  "input",
+  "change",
+  "submit",
+  "keydown",
+  "keyup",
+  "keypress",
+  "mousedown",
+  "mouseup",
+  "mouseover",
+  "mouseout",
+  "mouseenter",
+  "mouseleave",
+  "mousemove",
+  "pointerdown",
+  "pointerup",
+  "pointermove",
+  "focus",
+  "blur",
+  "load",
+  "resize",
+  "scroll"
+];
 var _BaseTokenizer = class _BaseTokenizer {
   constructor() {
     /** Keywords derived from profile, sorted longest-first for greedy matching */
     this.profileKeywords = [];
+    /**
+     * Space-containing profile keywords (multi-word phrases), longest-first.
+     * Used by `tryMultiWordKeyword` so natural spaced forms (hi `मेल खाता`,
+     * vi `chuyển đổi`, es `tecla abajo`, …) tokenize as ONE keyword — the
+     * profile-driven replacement for the per-language hardcoded compound lists.
+     * Empty for no-space (CJK) languages, so they are unaffected.
+     */
+    this.multiWordKeywords = [];
     /** Map for O(1) keyword lookups by lowercase native word */
     this.profileKeywordMap = /* @__PURE__ */ new Map();
+    /**
+     * The raw EXTRAS list passed to initializeKeywordsFromProfile, kept pre-dedup.
+     * The keyword map is keyed by native word with last-wins insertion, so a
+     * duplicate native word inside the extras silently shadows the earlier entry
+     * (e.g. a `nächste→closest` entry shadowing `nächste→next` broke German
+     * positional expressions). Exposed so consistency tests can detect such
+     * intra-extras collisions, which are invisible in the deduplicated map.
+     */
+    this.rawExtraEntries = [];
     /**
      * Pluggable value extractors for domain-specific syntax.
      * When registered, BaseTokenizer will use extractor-based tokenization instead of legacy methods.
      */
     this.extractors = [];
   }
+  /** Raw extras as passed in, pre-dedup — for consistency tests. */
+  getExtraKeywordEntries() {
+    return this.rawExtraEntries;
+  }
   /**
    * Tokenize input string to token stream.
    * Delegates to extractor-based tokenization if extractors are registered,
@@ -5105,6 +5170,12 @@ var _BaseTokenizer = class _BaseTokenizer {
         pos++;
       }
       if (pos >= input.length) break;
+      const multiWord = this.tryMultiWordKeyword(input, pos);
+      if (multiWord) {
+        tokens.push(multiWord);
+        pos = multiWord.position.end;
+        continue;
+      }
       let extracted = false;
       for (const extractor of this.extractors) {
         if (extractor.canExtract(input, pos)) {
@@ -5204,6 +5275,7 @@ var _BaseTokenizer = class _BaseTokenizer {
    */
   initializeKeywordsFromProfile(profile, extras = []) {
     const keywordMap = /* @__PURE__ */ new Map();
+    this.rawExtraEntries = extras;
     if (profile.keywords) {
       for (const [normalized2, translation] of Object.entries(profile.keywords)) {
         keywordMap.set(translation.primary, {
@@ -5247,12 +5319,20 @@ var _BaseTokenizer = class _BaseTokenizer {
         keywordMap.set(native, { native, normalized: normalized2 });
       }
     }
+    for (const evt of ENGLISH_DOM_EVENT_NAMES) {
+      if (!keywordMap.has(evt)) {
+        keywordMap.set(evt, { native: evt, normalized: evt });
+      }
+    }
     for (const extra of extras) {
       keywordMap.set(extra.native, extra);
     }
     this.profileKeywords = Array.from(keywordMap.values()).sort(
       (a, b) => b.native.length - a.native.length
     );
+    this.multiWordKeywords = this.profileKeywords.filter(
+      (k) => k.native.includes(" ") && !MARKER_CONCEPT_NORMALIZEDS.has(k.normalized)
+    );
     this.profileKeywordMap = /* @__PURE__ */ new Map();
     for (const keyword of this.profileKeywords) {
       this.profileKeywordMap.set(keyword.native.toLowerCase(), keyword);
@@ -5294,6 +5374,35 @@ var _BaseTokenizer = class _BaseTokenizer {
     }
     return null;
   }
+  /**
+   * Match the longest multi-word (space-containing) profile keyword at `pos`,
+   * requiring the match to end at a word boundary. The profile-driven
+   * counterpart of the per-language hardcoded compound lists (the hindi and
+   * vietnamese keyword extractors). Returns a keyword token (with the normalized
+   * form) or null. Case-sensitive against the stored native form, mirroring
+   * `tryProfileKeyword`/`isKeywordStart` (the i18n dicts emit a fixed surface
+   * case). No-op when `multiWordKeywords` is empty (no-space/CJK languages).
+   *
+   * @param input - Input string
+   * @param pos - Current position (must be a token-start boundary)
+   * @param isWordChar - End-boundary predicate (defaults to Unicode letter/digit/_)
+   */
+  tryMultiWordKeyword(input, pos, isWordChar = (ch) => /[\p{L}\p{N}_]/u.test(ch)) {
+    if (this.multiWordKeywords.length === 0) return null;
+    const rest = input.slice(pos);
+    for (const entry of this.multiWordKeywords) {
+      if (!rest.startsWith(entry.native)) continue;
+      const after = input[pos + entry.native.length];
+      if (after !== void 0 && isWordChar(after)) continue;
+      return createToken(
+        entry.native,
+        "keyword",
+        createPosition(pos, pos + entry.native.length),
+        entry.normalized
+      );
+    }
+    return null;
+  }
   /**
    * Check if the remaining input starts with any known keyword.
    * Useful for non-space languages to detect word boundaries.
@@ -5306,6 +5415,32 @@ var _BaseTokenizer = class _BaseTokenizer {
     const remaining = input.slice(pos);
     return this.profileKeywords.some((entry) => remaining.startsWith(entry.native));
   }
+  /**
+   * Check if a known keyword starts at the given position AND ends at a word
+   * boundary (end of input or a non-word character).
+   *
+   * Space-delimited languages must use this (not `isKeywordStart`) for
+   * word-walk break checks: the keyword table includes English canonical
+   * fallbacks (me, it, you, …), so a raw `startsWith` check splits any native
+   * word with an embedded fallback mid-word (e.g. Quechua ñit'iy contains
+   * "it"). CJK/no-space tokenizers rely on mid-text keyword starts and must
+   * keep using `isKeywordStart`.
+   *
+   * @param input - Input string
+   * @param pos - Current position
+   * @param isWordChar - Language-specific word-character predicate; pass the
+   *   tokenizer's letter classifier so e.g. the Quechua glottal apostrophe
+   *   counts as part of a word. Defaults to Unicode letters/digits/underscore.
+   * @returns true if a keyword starts here and is not followed by a word char
+   */
+  isKeywordStartAtBoundary(input, pos, isWordChar = (ch) => /[\p{L}\p{N}_]/u.test(ch)) {
+    const remaining = input.slice(pos);
+    return this.profileKeywords.some((entry) => {
+      if (!remaining.startsWith(entry.native)) return false;
+      const after = input[pos + entry.native.length];
+      return after === void 0 || !isWordChar(after);
+    });
+  }
   /**
    * Look up a keyword by native word (case-insensitive).
    * O(1) lookup using the keyword map.
@@ -5638,6 +5773,119 @@ function createSimpleTokenizer(config) {
   return new SimpleTokenizer();
 }
 
+// src/multilingual/builders.ts
+function mergeRoleMarkers(slice, vocab) {
+  const merged = {};
+  const add = (role, marker) => {
+    if (!marker?.primary) {
+      delete merged[role];
+      return;
+    }
+    merged[role] = {
+      primary: marker.primary,
+      ...marker.alternatives?.length && { alternatives: [...marker.alternatives] },
+      ...marker.position && { position: marker.position }
+    };
+  };
+  for (const [role, marker] of Object.entries(slice.roleMarkers ?? {})) add(role, marker);
+  for (const [role, marker] of Object.entries(vocab.roleMarkerOverrides ?? {})) add(role, marker);
+  return merged;
+}
+function buildPatternProfile(slice, vocab) {
+  const keywords = {};
+  for (const [action, translation] of Object.entries(vocab.keywords)) {
+    keywords[action] = {
+      primary: translation.primary,
+      ...translation.alternatives?.length && { alternatives: [...translation.alternatives] }
+    };
+  }
+  const roleMarkers = mergeRoleMarkers(slice, vocab);
+  return {
+    code: slice.code,
+    wordOrder: slice.wordOrder,
+    keywords,
+    ...Object.keys(roleMarkers).length > 0 && { roleMarkers }
+  };
+}
+function defaultCaseInsensitive(script) {
+  return script === void 0 || script === "latin" || script === "cyrillic";
+}
+function buildDomainTokenizer(slice, vocab, options = {}) {
+  const roleMarkers = mergeRoleMarkers(slice, vocab);
+  const keywords = /* @__PURE__ */ new Set();
+  for (const translation of Object.values(vocab.keywords)) {
+    keywords.add(translation.primary);
+    for (const alt of translation.alternatives ?? []) keywords.add(alt);
+  }
+  for (const marker of Object.values(roleMarkers)) {
+    keywords.add(marker.primary);
+    for (const alt of marker.alternatives ?? []) keywords.add(alt);
+  }
+  for (const particle of slice.tokenization?.particles ?? []) keywords.add(particle);
+  for (const extra of vocab.tokenizerKeywords ?? []) keywords.add(extra);
+  const profileKeywords = {};
+  for (const [action, translation] of Object.entries(vocab.keywords)) {
+    profileKeywords[action] = {
+      primary: translation.primary,
+      ...translation.alternatives?.length && { alternatives: [...translation.alternatives] },
+      normalized: translation.normalized ?? action
+    };
+  }
+  const keywordProfile = {
+    keywords: profileKeywords,
+    ...Object.keys(roleMarkers).length > 0 && { roleMarkers }
+  };
+  const customExtractors = [
+    ...options.customExtractors ?? [],
+    ...slice.script === "latin" ? [new LatinExtendedIdentifierExtractor()] : []
+  ];
+  return createSimpleTokenizer({
+    language: slice.code,
+    direction: slice.direction ?? "ltr",
+    keywords: [...keywords],
+    ...vocab.keywordExtras?.length && { keywordExtras: vocab.keywordExtras.map((e) => ({ ...e })) },
+    keywordProfile,
+    includeOperators: options.includeOperators ?? false,
+    caseInsensitive: options.caseInsensitive ?? defaultCaseInsensitive(slice.script),
+    ...customExtractors.length > 0 && { customExtractors }
+  });
+}
+function buildLanguageConfig(slice, vocab, meta = {}) {
+  const name = meta.name ?? slice.name ?? slice.code;
+  return {
+    code: slice.code,
+    name,
+    nativeName: meta.nativeName ?? slice.nativeName ?? name,
+    tokenizer: meta.tokenizer ?? buildDomainTokenizer(slice, vocab, meta.tokenizerOptions),
+    patternProfile: buildPatternProfile(slice, vocab),
+    ...meta.grammarProfile && { grammarProfile: meta.grammarProfile }
+  };
+}
+function deriveRoleMarkers(slice, roleMapping) {
+  const derived = {};
+  for (const [domainRole, semanticRole] of Object.entries(roleMapping)) {
+    const marker = slice.roleMarkers?.[semanticRole];
+    if (marker?.primary) derived[domainRole] = marker.primary;
+  }
+  return derived;
+}
+
+// src/core/tokenization/char-classifiers.ts
+function createUnicodeRangeClassifier(ranges) {
+  return (char) => {
+    const code = char.charCodeAt(0);
+    return ranges.some(([start, end]) => code >= start && code <= end);
+  };
+}
+function combineClassifiers(...classifiers) {
+  return (char) => classifiers.some((fn) => fn(char));
+}
+function createLatinCharClassifiers(letterPattern) {
+  const isLetter = (char) => letterPattern.test(char);
+  const isIdentifierChar = (char) => isLetter(char) || /[0-9_-]/.test(char);
+  return { isLetter, isIdentifierChar };
+}
+
 // src/core/tokenization/morphology/types.ts
 function noChange(word) {
   return { stem: word, confidence: 1 };
@@ -6204,7 +6452,10 @@ function accumulateIndented(statements, config) {
   WhitespaceExtractor,
   accumulateBlocks,
   buildDisambiguation,
+  buildDomainTokenizer,
   buildFeedback,
+  buildLanguageConfig,
+  buildPatternProfile,
   buildPhrase,
   buildTablesFromProfiles,
   combineClassifiers,
@@ -6235,6 +6486,7 @@ function accumulateIndented(statements, config) {
   createUnicodeRangeClassifier,
   defineCommand,
   defineRole,
+  deriveRoleMarkers,
   detectWordOrders,
   extractCssSelector,
   extractNumber,