@lokascript/framework 4.7.0 → 5.0.0

package/dist/core/matching/index.d.ts

@@ -9,4 +9,6 @@ export type { ConfidenceBreakdown, ConfidenceContext, ConfidenceModel } from './
 export { StockValueReader, createStockReader, greedyStopMarkers, readGreedy } from './stock-reader';
 export { readRoleValue, type ReadingProfile } from './stock-reading';
 export { stockConfidenceModel } from './stock-confidence';
+export * from './type-validation';
+export * from './possessive-keywords';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/matching/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/matching/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/core/matching/possessive-keywords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"possessive-keywords.d.ts","sourceRoot":"","sources":["../../../src/core/matching/possessive-keywords.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC5C,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}

package/dist/core/matching/stock-confidence.d.ts

@@ -1,8 +1,7 @@
 /**
- * The stock confidence model: how framework's old matcher scored a domain
- * pattern's match (`core/pattern-matching/`), moved here as a `ConfidenceModel`
- * for the matcher's skeleton (domains rethink Phase 4.7); the old matcher calls
- * it too until Phase 6.
+ * The stock confidence model: how framework's first matcher scored a domain
+ * pattern's match, moved here as a `ConfidenceModel` for the matcher's
+ * skeleton (domains rethink Phase 4.7).
  *
  * Role coverage (a required slot 1, an optional one 0.8, an absent optional one
  * with a default 60% of that), a stem-match penalty (up to 15%, floor 0.5), and

package/dist/core/matching/stock-confidence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stock-confidence.d.ts","sourceRoot":"","sources":["../../../src/core/matching/stock-confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAA0C,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4NlG,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,eAGlC,CAAC"}
+{"version":3,"file":"stock-confidence.d.ts","sourceRoot":"","sources":["../../../src/core/matching/stock-confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAA0C,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA4NlG,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,EAAE,eAGlC,CAAC"}

package/dist/core/matching/stock-reader.d.ts

@@ -7,13 +7,18 @@
  * - A **greedy** slot (`RoleSpec.greedy`: a SQL condition, a column list) reads
  *   every token up to the next marker the pattern still owes, or the end, as
  *   one expression (`readGreedy`).
+ * - A slot with a **word list** (`RoleSpec.words`: behaviorspec's interaction,
+ *   voice's thing to close) reads only one of its words, compared lower-cased
+ *   by value or normalized form; any other word leaves the slot unread.
  * - Any other slot reads one value (`readRoleValue`, the old matcher's reading):
  *   a selector, a quoted string, a number, a boolean, a duration, a URL, an
  *   identifier, or one of the multi-token forms it knows (`user.name`,
  *   `#dialog.showModal()`), checked against the slot's expected types.
  * - A **required** slot reads nothing where the stream is at the marker the
  *   pattern wants next (the old matcher's guard against an SOV marker taken as
- *   a value). Where a required slot finds nothing to read, and the optional,
+ *   a value). An **optional** one reads nothing at any marker the rest of the
+ *   pattern owes, through its optional groups (behaviorspec `when user types
+ *   into #search`, whose typed text is optional and has no marker). Where a required slot finds nothing to read, and the optional,
  *   marker-less slot just before it read a value with nothing read since, that
  *   value is given back and the required slot reads again (the old matcher's
  *   backtrack: behaviorspec `when clicks`, where the optional actor took
@@ -37,6 +42,8 @@ export declare function greedyStopMarkers(rest: readonly PatternToken[]): Set<st
  */
 export declare function readGreedy(tokens: TokenStream, stopMarkers: ReadonlySet<string>): SemanticValue | null;
 /** The stock reader, for a matcher whose profiles it may consult (possessive words). */
+/** Whether `token` is one of a slot's `words`, by value or normalized form, lower-cased. */
+export declare function isListedWord(token: LanguageToken | null, words: readonly string[]): boolean;
 export declare class StockValueReader implements ValueReader {
     private readonly view;
     private readonly profiles;

package/dist/core/matching/stock-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stock-reader.d.ts","sourceRoot":"","sources":["../../../src/core/matching/stock-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAqB5E;AASD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,aAAa,GAAG,IAAI,CAStB;AAED,wFAAwF;AACxF,qBAAa,gBAAiB,YAAW,WAAW;IAMhD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,yGAAyG;IACzG,OAAO,CAAC,YAAY,CAAqE;gBAGtE,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM;IAG1E,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAK5C,QAAQ,CACN,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,EAC1C,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO;IAwBV,6FAA6F;IAC7F,OAAO,CAAC,QAAQ;IAwBhB,WAAW,CACT,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO;IAWV,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CAG1C;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM,GACtD,CAAC,IAAI,EAAE,SAAS,KAAK,WAAW,CAElC"}
+{"version":3,"file":"stock-reader.d.ts","sourceRoot":"","sources":["../../../src/core/matching/stock-reader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAEV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACZ,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAqB5E;AASD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,aAAa,GAAG,IAAI,CAStB;AAED,wFAAwF;AACxF,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI3F;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAMhD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,yGAAyG;IACzG,OAAO,CAAC,YAAY,CAAqE;gBAGtE,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM;IAG1E,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAK5C,QAAQ,CACN,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,EAC1C,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO;IAwBV,6FAA6F;IAC7F,OAAO,CAAC,QAAQ;IA+BhB,WAAW,CACT,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,OAAO;IAWV,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;CAG1C;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAM,GACtD,CAAC,IAAI,EAAE,SAAS,KAAK,WAAW,CAElC"}

package/dist/core/matching/stock-reading.d.ts

@@ -1,8 +1,8 @@
 /**
- * Reading a domain value at a role slot: the value reading framework's old
- * matcher (`core/pattern-matching/`) did, moved here so the stock reader on the
- * matcher's skeleton (`stock-reader.ts`, domains rethink Phase 4.7) and the old
- * matcher run the same code until Phase 6 deletes the old one.
+ * Reading a domain value at a role slot: the value reading framework's first
+ * matcher did, moved here for the stock reader on the matcher's skeleton
+ * (`stock-reader.ts`, domains rethink Phase 4.7). The first matcher was
+ * deleted in 5.0 (Phase 6).
  *
  * In order: an English noise word before a selector (`the`), then the
  * multi-token forms (a possessive, `my value`; a method call,

package/dist/core/{pattern-matching/utils → matching}/type-validation.d.ts

@@ -4,7 +4,7 @@
  * Shared utilities for validating semantic value types against expected types.
  * Used by pattern-matcher to validate captured role values.
  */
-import type { SemanticValue } from '../../types';
+import type { SemanticValue } from '../types';
 /**
  * Semantic value type strings.
  */

package/dist/core/matching/type-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-validation.d.ts","sourceRoot":"","sources":["../../../src/core/matching/type-validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,iBAAiB,GAAG,MAAM,EACtC,aAAa,EAAE,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,GAC5C,OAAO,CAsBT;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,GAC7C,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGzD"}

package/dist/core/types.d.ts

@@ -88,6 +88,11 @@ export interface RolePatternToken {
     readonly optional?: boolean;
     readonly expectedTypes?: Array<ExpectedType>;
     readonly greedy?: boolean;
+    /**
+     * The words the slot reads, from the schema's `RoleSpec.words` for the pattern's language (its
+     * `'*'` list and the language's own): the stock reader reads the slot only from one of them.
+     */
+    readonly words?: readonly string[];
     /**
      * Mirrors the schema's `RoleSpec.valueShape`: the slot's surface form is
      * unambiguous on its own. Carried onto the pattern token because the value

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,gBAAgB,EAChB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,aAAa,GACb,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,aAAa,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC;IACnB,IAAI,IAAI,UAAU,CAAC;IACnB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IACrC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,IAAI,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACrD"}

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * Core Types — re-exported from @lokascript/intent + framework-specific extensions\n *\n * The universal semantic types (SemanticNode, SemanticValue, etc.) now live in\n * @lokascript/intent and are re-exported here for backward compatibility.\n *\n * Framework-specific types (tokenization, pattern matching) are defined below.\n */\n\n// =============================================================================\n// Re-export everything from @lokascript/intent\n// =============================================================================\n\nexport type {\n  ActionType,\n  SemanticRole,\n  SemanticValue,\n  ExpectedType,\n  LiteralValue,\n  SelectorValue,\n  ReferenceValue,\n  PropertyPathValue,\n  ExpressionValue,\n  FlagValue,\n  Annotation,\n  ProtocolDiagnostic,\n  AsyncVariant,\n  MatchArm,\n  SemanticNode,\n  SemanticMetadata,\n  SourcePosition,\n  CommandSemanticNode,\n  EventHandlerSemanticNode,\n  EventModifiers,\n  ConditionalSemanticNode,\n  CompoundSemanticNode,\n  LoopVariant,\n  LoopSemanticNode,\n  LSEEnvelope,\n} from '@lokascript/intent';\n\nexport {\n  createLiteral,\n  createSelector,\n  createReference,\n  createPropertyPath,\n  createExpression,\n  createFlag,\n  createCommandNode,\n  createEventHandlerNode,\n  createConditionalNode,\n  createCompoundNode,\n  createLoopNode,\n  createTryNode,\n  createAsyncNode,\n  createMatchNode,\n  extractValue,\n  extractRoleValue,\n  getRoleValue,\n} from '@lokascript/intent';\n\n// =============================================================================\n// Framework-specific types (multilingual DSL infrastructure)\n// =============================================================================\n\nimport type {\n  ActionType,\n  SemanticRole,\n  SemanticValue,\n  SelectorValue,\n  ExpectedType,\n  SourcePosition,\n} from '@lokascript/intent';\n\n/**\n * Token kind - categorizes what type of token this is.\n */\nexport type TokenKind =\n  | 'keyword' // Command or modifier keyword\n  | 'selector' // CSS selector or identifier (#id, .class, table-name)\n  | 'literal' // String or number literal\n  | 'particle' // Grammatical particle (を, に, من)\n  | 'conjunction' // Grammatical conjunction\n  | 'event-modifier' // Event modifier (.once, .debounce(300))\n  | 'identifier' // Generic identifier\n  | 'operator' // Operators (., +, -, etc.)\n  | 'punctuation' // Punctuation (parentheses, etc.)\n  | 'url'; // URL or path\n\n/**\n * A language token - the result of tokenization.\n */\nexport interface LanguageToken {\n  readonly value: string;\n  readonly kind: TokenKind;\n  readonly position: SourcePosition;\n  readonly normalized?: string;\n  readonly stem?: string;\n  readonly stemConfidence?: number;\n  readonly metadata?: Record<string, unknown>;\n}\n\n/**\n * Token stream - provides sequential access to tokens with backtracking.\n */\nexport interface TokenStream {\n  readonly tokens: readonly LanguageToken[];\n  readonly language: string;\n  peek(offset?: number): LanguageToken | null;\n  advance(): LanguageToken;\n  isAtEnd(): boolean;\n  mark(): StreamMark;\n  reset(mark: StreamMark): void;\n  position(): number;\n}\n\nexport interface StreamMark {\n  readonly position: number;\n}\n\n/**\n * Language tokenizer interface - converts text to tokens.\n */\nexport interface LanguageTokenizer {\n  readonly language: string;\n  readonly direction: 'ltr' | 'rtl';\n  tokenize(input: string): TokenStream;\n  classifyToken(token: string): TokenKind;\n}\n\n// =============================================================================\n// Pattern Matching Types\n// =============================================================================\n\nexport interface LanguagePattern {\n  readonly id: string;\n  readonly language: string;\n  readonly command: ActionType;\n  readonly priority: number;\n  readonly template: PatternTemplate;\n  readonly extraction: ExtractionRules;\n  readonly constraints?: PatternConstraints;\n  /**\n   * The pattern reads a form the renderer does not write by choosing it\n   * (hyperscript's wait `esperar evento {event}`: the renderer writes the event\n   * word itself, before a name no table knows). The renderer skips it.\n   */\n  readonly parseOnly?: boolean;\n}\n\nexport interface PatternTemplate {\n  readonly format: string;\n  readonly tokens: PatternToken[];\n}\n\nexport type PatternToken = LiteralPatternToken | RolePatternToken | GroupPatternToken;\n\nexport interface LiteralPatternToken {\n  readonly type: 'literal';\n  readonly value: string;\n  readonly alternatives?: string[];\n  /**\n   * Parse-only marker: the matcher still consumes this literal, but the\n   * renderer skips it. Set when a role declares `renderOverride: { <lang>: '' }`\n   * (hyperscript's fetch `from`: required to PARSE `fetch from /api`, absent from\n   * the render, since `fetch from \"/api\"` is not canonical _hyperscript).\n   */\n  readonly renderSuppress?: boolean;\n}\n\nexport interface RolePatternToken {\n  readonly type: 'role';\n  readonly role: SemanticRole;\n  readonly optional?: boolean;\n  readonly expectedTypes?: Array<ExpectedType>;\n  readonly greedy?: boolean;\n  /**\n   * Mirrors the schema's `RoleSpec.valueShape`: the slot's surface form is\n   * unambiguous on its own. Carried onto the pattern token because the value\n   * reader needs it too, not just the confidence model (hyperscript's\n   * `'keyword'` slots hold a fixed keyword phrase and are exempt from the\n   * trailing-slot verb guard).\n   */\n  readonly valueShape?: 'time' | 'reference' | 'keyword' | 'object' | 'clause' | 'list';\n}\n\nexport interface GroupPatternToken {\n  readonly type: 'group';\n  readonly tokens: PatternToken[];\n  readonly optional?: boolean;\n  /**\n   * The group is optional for PARSING but belongs in canonical output: the\n   * marker-only groups a profile's optional case markers produce (Turkish case\n   * suffixes may be dropped colloquially, so the parse accepts both forms).\n   * The matcher's skeleton also requires such a group's marker after a role it\n   * captures (`MatchSkeleton`).\n   */\n  readonly renderRequired?: boolean;\n}\n\nexport interface ExtractionRules {\n  readonly [role: string]: ExtractionRule;\n}\n\nexport interface ExtractionRule {\n  readonly position?: number;\n  readonly marker?: string;\n  readonly markerAlternatives?: string[];\n  readonly transform?: (raw: string) => SemanticValue;\n  readonly default?: SemanticValue;\n  readonly value?: string;\n  /**\n   * The static `value` is an expression, as the English parse types the word\n   * (hyperscript's `go back` destination), not a literal.\n   */\n  readonly valueIsExpression?: true;\n  readonly fromRole?: string;\n}\n\nexport interface PatternConstraints {\n  readonly requiredRoles?: SemanticRole[];\n  readonly forbiddenRoles?: SemanticRole[];\n  readonly validPatientTypes?: Array<SelectorValue['selectorKind']>;\n  readonly conflictsWith?: string[];\n}\n\nexport interface PatternMatchResult {\n  readonly pattern: LanguagePattern;\n  readonly captured: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly consumedTokens: number;\n  readonly confidence: number;\n  /**\n   * Stream index at which each captured role's value STARTED, for callers that\n   * need to re-read a slot's own span rather than the tail after it. Populated\n   * on the same success path as `captured` (`MatchSkeleton`), so a role left\n   * behind by a rolled-back group survives in both maps or in neither.\n   */\n  readonly roleStarts?: ReadonlyMap<SemanticRole, number>;\n  /**\n   * A source phrase hyperscript's reader found in an event HEAD (`from #btn`\n   * right after the event) rather than in a pattern slot: kept out of\n   * `captured`, so a fused pattern's own source group can neither overwrite it\n   * nor be overwritten (`ValueReader.resultFields`).\n   */\n  readonly eventSource?: SemanticValue;\n}\n\nexport interface PatternMatchError {\n  readonly message: string;\n  readonly position: SourcePosition;\n  readonly expectedPatterns?: string[];\n  readonly partialMatch?: Partial<PatternMatchResult>;\n}\n"],"mappings":";AAyCA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * Core Types — re-exported from @lokascript/intent + framework-specific extensions\n *\n * The universal semantic types (SemanticNode, SemanticValue, etc.) now live in\n * @lokascript/intent and are re-exported here for backward compatibility.\n *\n * Framework-specific types (tokenization, pattern matching) are defined below.\n */\n\n// =============================================================================\n// Re-export everything from @lokascript/intent\n// =============================================================================\n\nexport type {\n  ActionType,\n  SemanticRole,\n  SemanticValue,\n  ExpectedType,\n  LiteralValue,\n  SelectorValue,\n  ReferenceValue,\n  PropertyPathValue,\n  ExpressionValue,\n  FlagValue,\n  Annotation,\n  ProtocolDiagnostic,\n  AsyncVariant,\n  MatchArm,\n  SemanticNode,\n  SemanticMetadata,\n  SourcePosition,\n  CommandSemanticNode,\n  EventHandlerSemanticNode,\n  EventModifiers,\n  ConditionalSemanticNode,\n  CompoundSemanticNode,\n  LoopVariant,\n  LoopSemanticNode,\n  LSEEnvelope,\n} from '@lokascript/intent';\n\nexport {\n  createLiteral,\n  createSelector,\n  createReference,\n  createPropertyPath,\n  createExpression,\n  createFlag,\n  createCommandNode,\n  createEventHandlerNode,\n  createConditionalNode,\n  createCompoundNode,\n  createLoopNode,\n  createTryNode,\n  createAsyncNode,\n  createMatchNode,\n  extractValue,\n  extractRoleValue,\n  getRoleValue,\n} from '@lokascript/intent';\n\n// =============================================================================\n// Framework-specific types (multilingual DSL infrastructure)\n// =============================================================================\n\nimport type {\n  ActionType,\n  SemanticRole,\n  SemanticValue,\n  SelectorValue,\n  ExpectedType,\n  SourcePosition,\n} from '@lokascript/intent';\n\n/**\n * Token kind - categorizes what type of token this is.\n */\nexport type TokenKind =\n  | 'keyword' // Command or modifier keyword\n  | 'selector' // CSS selector or identifier (#id, .class, table-name)\n  | 'literal' // String or number literal\n  | 'particle' // Grammatical particle (を, に, من)\n  | 'conjunction' // Grammatical conjunction\n  | 'event-modifier' // Event modifier (.once, .debounce(300))\n  | 'identifier' // Generic identifier\n  | 'operator' // Operators (., +, -, etc.)\n  | 'punctuation' // Punctuation (parentheses, etc.)\n  | 'url'; // URL or path\n\n/**\n * A language token - the result of tokenization.\n */\nexport interface LanguageToken {\n  readonly value: string;\n  readonly kind: TokenKind;\n  readonly position: SourcePosition;\n  readonly normalized?: string;\n  readonly stem?: string;\n  readonly stemConfidence?: number;\n  readonly metadata?: Record<string, unknown>;\n}\n\n/**\n * Token stream - provides sequential access to tokens with backtracking.\n */\nexport interface TokenStream {\n  readonly tokens: readonly LanguageToken[];\n  readonly language: string;\n  peek(offset?: number): LanguageToken | null;\n  advance(): LanguageToken;\n  isAtEnd(): boolean;\n  mark(): StreamMark;\n  reset(mark: StreamMark): void;\n  position(): number;\n}\n\nexport interface StreamMark {\n  readonly position: number;\n}\n\n/**\n * Language tokenizer interface - converts text to tokens.\n */\nexport interface LanguageTokenizer {\n  readonly language: string;\n  readonly direction: 'ltr' | 'rtl';\n  tokenize(input: string): TokenStream;\n  classifyToken(token: string): TokenKind;\n}\n\n// =============================================================================\n// Pattern Matching Types\n// =============================================================================\n\nexport interface LanguagePattern {\n  readonly id: string;\n  readonly language: string;\n  readonly command: ActionType;\n  readonly priority: number;\n  readonly template: PatternTemplate;\n  readonly extraction: ExtractionRules;\n  readonly constraints?: PatternConstraints;\n  /**\n   * The pattern reads a form the renderer does not write by choosing it\n   * (hyperscript's wait `esperar evento {event}`: the renderer writes the event\n   * word itself, before a name no table knows). The renderer skips it.\n   */\n  readonly parseOnly?: boolean;\n}\n\nexport interface PatternTemplate {\n  readonly format: string;\n  readonly tokens: PatternToken[];\n}\n\nexport type PatternToken = LiteralPatternToken | RolePatternToken | GroupPatternToken;\n\nexport interface LiteralPatternToken {\n  readonly type: 'literal';\n  readonly value: string;\n  readonly alternatives?: string[];\n  /**\n   * Parse-only marker: the matcher still consumes this literal, but the\n   * renderer skips it. Set when a role declares `renderOverride: { <lang>: '' }`\n   * (hyperscript's fetch `from`: required to PARSE `fetch from /api`, absent from\n   * the render, since `fetch from \"/api\"` is not canonical _hyperscript).\n   */\n  readonly renderSuppress?: boolean;\n}\n\nexport interface RolePatternToken {\n  readonly type: 'role';\n  readonly role: SemanticRole;\n  readonly optional?: boolean;\n  readonly expectedTypes?: Array<ExpectedType>;\n  readonly greedy?: boolean;\n  /**\n   * The words the slot reads, from the schema's `RoleSpec.words` for the pattern's language (its\n   * `'*'` list and the language's own): the stock reader reads the slot only from one of them.\n   */\n  readonly words?: readonly string[];\n  /**\n   * Mirrors the schema's `RoleSpec.valueShape`: the slot's surface form is\n   * unambiguous on its own. Carried onto the pattern token because the value\n   * reader needs it too, not just the confidence model (hyperscript's\n   * `'keyword'` slots hold a fixed keyword phrase and are exempt from the\n   * trailing-slot verb guard).\n   */\n  readonly valueShape?: 'time' | 'reference' | 'keyword' | 'object' | 'clause' | 'list';\n}\n\nexport interface GroupPatternToken {\n  readonly type: 'group';\n  readonly tokens: PatternToken[];\n  readonly optional?: boolean;\n  /**\n   * The group is optional for PARSING but belongs in canonical output: the\n   * marker-only groups a profile's optional case markers produce (Turkish case\n   * suffixes may be dropped colloquially, so the parse accepts both forms).\n   * The matcher's skeleton also requires such a group's marker after a role it\n   * captures (`MatchSkeleton`).\n   */\n  readonly renderRequired?: boolean;\n}\n\nexport interface ExtractionRules {\n  readonly [role: string]: ExtractionRule;\n}\n\nexport interface ExtractionRule {\n  readonly position?: number;\n  readonly marker?: string;\n  readonly markerAlternatives?: string[];\n  readonly transform?: (raw: string) => SemanticValue;\n  readonly default?: SemanticValue;\n  readonly value?: string;\n  /**\n   * The static `value` is an expression, as the English parse types the word\n   * (hyperscript's `go back` destination), not a literal.\n   */\n  readonly valueIsExpression?: true;\n  readonly fromRole?: string;\n}\n\nexport interface PatternConstraints {\n  readonly requiredRoles?: SemanticRole[];\n  readonly forbiddenRoles?: SemanticRole[];\n  readonly validPatientTypes?: Array<SelectorValue['selectorKind']>;\n  readonly conflictsWith?: string[];\n}\n\nexport interface PatternMatchResult {\n  readonly pattern: LanguagePattern;\n  readonly captured: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly consumedTokens: number;\n  readonly confidence: number;\n  /**\n   * Stream index at which each captured role's value STARTED, for callers that\n   * need to re-read a slot's own span rather than the tail after it. Populated\n   * on the same success path as `captured` (`MatchSkeleton`), so a role left\n   * behind by a rolled-back group survives in both maps or in neither.\n   */\n  readonly roleStarts?: ReadonlyMap<SemanticRole, number>;\n  /**\n   * A source phrase hyperscript's reader found in an event HEAD (`from #btn`\n   * right after the event) rather than in a pattern slot: kept out of\n   * `captured`, so a fused pattern's own source group can neither overwrite it\n   * nor be overwritten (`ValueReader.resultFields`).\n   */\n  readonly eventSource?: SemanticValue;\n}\n\nexport interface PatternMatchError {\n  readonly message: string;\n  readonly position: SourcePosition;\n  readonly expectedPatterns?: string[];\n  readonly partialMatch?: Partial<PatternMatchResult>;\n}\n"],"mappings":";AAyCA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/generation/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Pattern generation, rendering, and diagnostics
  */
-export * from './pattern-generator';
+export * from './profile';
 export * from './renderer';
 export * from './diagnostics';
 export * from './schema-patterns';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}

package/dist/generation/index.js

@@ -1,110 +1,4 @@
-// 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") {
-    const preVerb = [];
-    const postVerb = [];
-    for (const role of sortedRoles) {
-      addRoleWithMarker(role.sovSlot === "postVerb" ? postVerb : preVerb, role, profile);
-    }
-    tokens.push(...preVerb, keywordToken, ...postVerb);
-  } 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 = roleSpec.markerPosition ?? 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;
-}
+// src/generation/profile.ts
 function sortRolesByWordOrder(roles, wordOrder) {
   const sorted = [...roles];
   if (wordOrder === "SVO") {
@@ -114,47 +8,6 @@ function sortRolesByWordOrder(roles, wordOrder) {
   }
   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 isSOV = profile.wordOrder === "SOV";
-  const preVerb = [];
-  const postVerb = [];
-  const sortedRoles = sortRolesByWordOrder(schema.roles, profile.wordOrder);
-  for (const role of sortedRoles) {
-    const marker = getMarkerForRole(role, profile);
-    const roleName = `{${role.role}}`;
-    const bucket = isSOV && role.sovSlot === "postVerb" ? postVerb : preVerb;
-    if (marker) {
-      const markerInfo = profile.roleMarkers?.[role.role];
-      if (markerInfo?.position === "after") {
-        bucket.push(`${roleName} ${marker}`);
-      } else {
-        bucket.push(`${marker} ${roleName}`);
-      }
-    } else {
-      bucket.push(roleName);
-    }
-  }
-  return (isSOV ? [...preVerb, keyword, ...postVerb] : [keyword, ...preVerb, ...postVerb]).join(
-    " "
-  );
-}
-function generatePatternVariants(schema, profile, config = defaultConfig) {
-  const patterns = [];
-  patterns.push(generatePattern(schema, profile, config));
-  return patterns;
-}
 
 // src/core/types.ts
 import {
@@ -296,10 +149,10 @@ import { createDiagnosticCollector, fromError, filterBySeverity } from "@lokascr
 // src/generation/schema-patterns.ts
 function createSchemaPatternGenerator(grammar) {
   return {
-    generatePattern: (schema, profile, config) => generatePattern2(grammar, schema, profile, config),
+    generatePattern: (schema, profile, config) => generatePattern(grammar, schema, profile, config),
     generateSimplePattern: (schema, profile, config) => generateSimplePattern(grammar, schema, profile, config),
     generateVerbFirstPattern: (schema, profile, config) => generateVerbFirstPattern(schema, profile, config),
-    generatePatternVariants: (schema, profile, config) => generatePatternVariants2(grammar, schema, profile, config),
+    generatePatternVariants: (schema, profile, config) => generatePatternVariants(grammar, schema, profile, config),
     buildRoleToken
   };
 }
@@ -349,21 +202,21 @@ function schemaMarkerAlternatives(roleSpec, languageCode, marker) {
   const alternatives = [.../* @__PURE__ */ new Set([...legacy, ...variants])].filter((a) => a && a !== marker);
   return alternatives.length ? alternatives : void 0;
 }
-var defaultConfig2 = {
+var defaultConfig = {
   basePriority: 100,
   generateSimpleVariants: true,
   generateAlternatives: true
 };
-function generatePattern2(grammar, schema, profile, config = defaultConfig2) {
+function generatePattern(grammar, 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 = buildTokens2(grammar, schema, profile, keyword);
+  const tokens = buildTokens(grammar, schema, profile, keyword);
   const extraction = buildExtractionRulesWithDefaults(schema, profile);
-  const format = buildFormatString2(grammar, schema, profile, keyword);
+  const format = buildFormatString(grammar, schema, profile, keyword);
   return {
     id,
     language: profile.code,
@@ -376,7 +229,7 @@ function generatePattern2(grammar, schema, profile, config = defaultConfig2) {
     extraction
   };
 }
-function generateSimplePattern(grammar, schema, profile, config = defaultConfig2) {
+function generateSimplePattern(grammar, schema, profile, config = defaultConfig) {
   const optionalRoles = schema.roles.filter((r) => !r.required);
   if (optionalRoles.length === 0) {
     return null;
@@ -386,7 +239,7 @@ function generateSimplePattern(grammar, schema, profile, config = defaultConfig2
     ...schema,
     roles: requiredRoles
   };
-  const pattern = generatePattern2(grammar, simpleSchema, profile, config);
+  const pattern = generatePattern(grammar, simpleSchema, profile, config);
   return {
     ...pattern,
     id: `${schema.action}-${profile.code}-generated-simple`,
@@ -395,7 +248,7 @@ function generateSimplePattern(grammar, schema, profile, config = defaultConfig2
     extraction: buildExtractionRulesWithDefaults(schema, profile)
   };
 }
-function generateVerbFirstPattern(schema, profile, config = defaultConfig2) {
+function generateVerbFirstPattern(schema, profile, config = defaultConfig) {
   if (profile.wordOrder !== "SOV") return null;
   const requiredRoles = schema.roles.filter((r) => r.required);
   if (requiredRoles.length !== 1) return null;
@@ -404,11 +257,13 @@ function generateVerbFirstPattern(schema, profile, config = defaultConfig2) {
   const verbToken = keyword.alternatives ? { type: "literal", value: keyword.primary, alternatives: keyword.alternatives } : { type: "literal", value: keyword.primary };
   const roleTokens = requiredRoles.flatMap((r) => {
     const prefix = r.valuePrefixLiteral?.[profile.code];
+    const words = wordsFor(r, profile.code);
     const roleToken = {
       type: "role",
       role: r.role,
       optional: false,
-      expectedTypes: r.expectedTypes
+      expectedTypes: r.expectedTypes,
+      ...words ? { words } : {}
     };
     return prefix ? [{ type: "literal", value: prefix }, roleToken] : [roleToken];
   });
@@ -426,11 +281,11 @@ function generateVerbFirstPattern(schema, profile, config = defaultConfig2) {
     extraction: buildExtractionRulesWithDefaults(schema, profile)
   };
 }
-function generatePatternVariants2(grammar, schema, profile, config = defaultConfig2) {
+function generatePatternVariants(grammar, schema, profile, config = defaultConfig) {
   const patterns = [];
   const full = schema;
   schema = withoutVariantOnlyRoles(schema);
-  patterns.push(generatePattern2(grammar, schema, profile, config));
+  patterns.push(generatePattern(grammar, schema, profile, config));
   if (config.generateSimpleVariants) {
     const simple = generateSimplePattern(grammar, schema, profile, config);
     if (simple) {
@@ -442,7 +297,7 @@ function generatePatternVariants2(grammar, schema, profile, config = defaultConf
       ...schema,
       roles: schema.roles.filter((r) => r.role !== omitted)
     };
-    const variant = generatePattern2(grammar, variantSchema, profile, config);
+    const variant = generatePattern(grammar, variantSchema, profile, config);
     patterns.push({
       ...variant,
       id: `${schema.action}-${profile.code}-generated-no-${omitted}`,
@@ -457,7 +312,7 @@ function generatePatternVariants2(grammar, schema, profile, config = defaultConf
         (r) => r.role === widen.role ? { ...r, expectedTypes: [...widen.types] } : r
       )
     };
-    const main = generatePattern2(grammar, cloneSchema, profile, config);
+    const main = generatePattern(grammar, cloneSchema, profile, config);
     patterns.push({
       ...main,
       id: `${schema.action}-${profile.code}-generated-${widen.idSuffix}`,
@@ -472,7 +327,7 @@ function generatePatternVariants2(grammar, schema, profile, config = defaultConf
         return r.role === v.widen?.role ? { ...required, expectedTypes: [...v.widen.types] } : required;
       })
     };
-    const variant = generatePattern2(grammar, variantSchema, profile, config);
+    const variant = generatePattern(grammar, variantSchema, profile, config);
     patterns.push({
       ...variant,
       id: `${schema.action}-${profile.code}-generated-${v.idSuffix}`,
@@ -497,7 +352,7 @@ function generatePatternVariants2(grammar, schema, profile, config = defaultConf
     };
     const delta = v.priorityDelta ?? 5;
     const carrier = v.methodCarrier ? { [v.methodCarrier]: { value: literal } } : {};
-    const main = generatePattern2(grammar, cloneSchema, profile, config);
+    const main = generatePattern(grammar, cloneSchema, profile, config);
     patterns.push({
       ...main,
       id: `${schema.action}-${profile.code}-generated-${v.idSuffix}`,
@@ -518,7 +373,7 @@ function generatePatternVariants2(grammar, schema, profile, config = defaultConf
   }
   return patterns;
 }
-function buildTokens2(grammar, schema, profile, keyword) {
+function buildTokens(grammar, schema, profile, keyword) {
   const tokens = [];
   const verbToken = keyword.alternatives ? { type: "literal", value: keyword.primary, alternatives: keyword.alternatives } : { type: "literal", value: keyword.primary };
   const postVerbRoles = profile.wordOrder === "SOV" ? schema.roles.filter((r) => r.sovSlot === "postVerb") : [];
@@ -578,11 +433,17 @@ function buildRoleTokens(grammar, schema, profile) {
   }
   return tokens;
 }
+function wordsFor(roleSpec, language) {
+  if (!roleSpec.words) return void 0;
+  const words = [...roleSpec.words["*"] ?? [], ...roleSpec.words[language] ?? []];
+  return words.length > 0 ? words : void 0;
+}
 function buildRoleToken(roleSpec, profile) {
   const tokens = [];
   const overrideMarker = roleSpec.markerOverride?.[profile.code];
   const defaultMarker = profile.roleMarkers[roleSpec.role];
   const suppressMarker = roleSpec.renderOverride?.[profile.code] === "";
+  const words = wordsFor(roleSpec, profile.code);
   const roleValueToken = {
     type: "role",
     role: roleSpec.role,
@@ -594,7 +455,9 @@ function buildRoleToken(roleSpec, profile) {
     ...roleSpec.valueShape !== void 0 ? { valueShape: roleSpec.valueShape } : {},
     // A greedy role reads up to the next marker the pattern owes (a domain's
     // SQL condition); its value reader does the reading.
-    ...roleSpec.greedy ? { greedy: true } : {}
+    ...roleSpec.greedy ? { greedy: true } : {},
+    // A role with a word list reads only one of its words.
+    ...words ? { words } : {}
   };
   const prefixLiteral = roleSpec.valuePrefixLiteral?.[profile.code];
   const pushPrefixed = () => {
@@ -664,7 +527,7 @@ function buildRoleToken(roleSpec, profile) {
   }
   return tokens;
 }
-function buildExtractionRules2(schema, profile) {
+function buildExtractionRules(schema, profile) {
   const rules = {};
   for (const roleSpec of schema.roles) {
     const overrideMarker = roleSpec.markerOverride?.[profile.code];
@@ -694,7 +557,7 @@ function buildExtractionRules2(schema, profile) {
   return rules;
 }
 function buildExtractionRulesWithDefaults(schema, profile) {
-  const baseRules = buildExtractionRules2(schema, profile);
+  const baseRules = buildExtractionRules(schema, profile);
   const rules = {};
   for (const roleSpec of schema.roles) {
     const baseRule = baseRules[roleSpec.role] || {};
@@ -706,7 +569,7 @@ function buildExtractionRulesWithDefaults(schema, profile) {
   }
   return rules;
 }
-function buildFormatString2(grammar, schema, profile, keyword) {
+function buildFormatString(grammar, schema, profile, keyword) {
   const parts = [];
   const sortedRoles = sortRolesByPosition(schema.roles, profile.wordOrder, grammar.positionOrder);
   const roleParts = sortedRoles.map((roleSpec) => {
@@ -877,8 +740,6 @@ export {
   detectWordOrders,
   filterBySeverity,
   fromError,
-  generatePattern,
-  generatePatternVariants,
   legacyMarkerAlternatives,
   lookupKeyword,
   lookupMarker,