@lokascript/framework 2.0.0 → 2.1.0

package/dist/core/types.d.ts

@@ -40,7 +40,7 @@ export type SemanticRole = string;
  * A semantic value represents a typed piece of data in a semantic node.
  * Values are language-neutral - they capture what something IS, not how it's written.
  */
-export type SemanticValue = LiteralValue | SelectorValue | ReferenceValue | PropertyPathValue | ExpressionValue;
+export type SemanticValue = LiteralValue | SelectorValue | ReferenceValue | PropertyPathValue | ExpressionValue | FlagValue;
 /**
  * Expected value types for role tokens.
  * Shared between RoleSpec (command-schemas) and RolePatternToken.
@@ -70,6 +70,40 @@ export interface ExpressionValue {
     /** Raw expression string for complex expressions that need further parsing */
     readonly raw: string;
 }
+/**
+ * A boolean flag value — present (+flag) or negated (~flag).
+ * Used in declarative domains for no-value attributes like primary-key, not-null.
+ */
+export interface FlagValue {
+    readonly type: 'flag';
+    readonly name: string;
+    readonly enabled: boolean;
+}
+/** A metadata annotation on a node (v1.2). */
+export interface Annotation {
+    readonly name: string;
+    readonly value?: string;
+}
+/**
+ * A type constraint diagnostic attached to a node (v1.2).
+ *
+ * Named `ProtocolDiagnostic` to avoid collision with the framework's own
+ * `Diagnostic` type (which has `severity: 'error' | 'warning' | 'info'`
+ * and `suggestion?: string`).
+ */
+export interface ProtocolDiagnostic {
+    readonly level: 'error' | 'warning';
+    readonly role: string;
+    readonly message: string;
+    readonly code: string;
+}
+/** Async coordination variant (v1.2). */
+export type AsyncVariant = 'all' | 'race';
+/** A single arm in a match command (v1.2). */
+export interface MatchArm {
+    readonly pattern: SemanticValue;
+    readonly body: SemanticNode[];
+}
 /**
  * Base interface for all semantic nodes.
  * Semantic nodes capture the MEANING of DSL constructs.
@@ -79,6 +113,10 @@ export interface SemanticNode {
     readonly action: ActionType;
     readonly roles: ReadonlyMap<SemanticRole, SemanticValue>;
     readonly metadata?: SemanticMetadata;
+    /** Metadata annotations (v1.2). */
+    readonly annotations?: readonly Annotation[];
+    /** Type constraint diagnostics (v1.2). */
+    readonly diagnostics?: readonly ProtocolDiagnostic[];
 }
 /**
  * Metadata about the source of a semantic node.
@@ -107,9 +145,27 @@ export interface SourcePosition {
 }
 /**
  * A command semantic node - represents a single DSL command.
+ *
+ * v1.2 adds optional fields for try/catch/finally, async coordination (all/race),
+ * and pattern matching (match/arms). These are encoded as fields on command nodes
+ * (matching the protocol wire format) rather than new node kinds.
  */
 export interface CommandSemanticNode extends SemanticNode {
     readonly kind: 'command';
+    /** try body — commands to execute in the try block (v1.2). */
+    readonly body?: readonly SemanticNode[];
+    /** catch branch — commands to execute on error (v1.2). */
+    readonly catchBranch?: readonly SemanticNode[];
+    /** finally branch — cleanup commands that always execute (v1.2). */
+    readonly finallyBranch?: readonly SemanticNode[];
+    /** Async coordination variant: all (wait for all) or race (first wins) (v1.2). */
+    readonly asyncVariant?: AsyncVariant;
+    /** Async body — concurrent commands for all/race (v1.2). */
+    readonly asyncBody?: readonly SemanticNode[];
+    /** Match arms — pattern/body pairs for match command (v1.2). */
+    readonly arms?: readonly MatchArm[];
+    /** Default arm — executed when no match arm matches (v1.2). */
+    readonly defaultArm?: readonly SemanticNode[];
 }
 /**
  * An event handler semantic node - represents trigger-based commands.
@@ -143,7 +199,7 @@ export interface ConditionalSemanticNode extends SemanticNode {
 export interface CompoundSemanticNode extends SemanticNode {
     readonly kind: 'compound';
     readonly statements: SemanticNode[];
-    readonly chainType: 'then' | 'and' | 'async' | 'sequential';
+    readonly chainType: 'then' | 'and' | 'async' | 'sequential' | 'pipe';
 }
 /**
  * Loop variant discriminant for different loop types.
@@ -340,6 +396,10 @@ export declare function createPropertyPath(object: SemanticValue, property: stri
  * Create an expression value
  */
 export declare function createExpression(raw: string): ExpressionValue;
+/**
+ * Create a boolean flag value (+flag or ~flag)
+ */
+export declare function createFlag(name: string, enabled?: boolean): FlagValue;
 /**
  * Create a command semantic node
  */
@@ -379,4 +439,22 @@ export declare function extractRoleValue(node: SemanticNode, role: string): stri
  * Create a loop semantic node
  */
 export declare function createLoopNode(action: ActionType, roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>, loopVariant: LoopVariant, body: SemanticNode[], loopVariable?: string, indexVariable?: string, metadata?: SemanticMetadata): LoopSemanticNode;
+/**
+ * Create a try/catch/finally command node (v1.2).
+ */
+export declare function createTryNode(body: SemanticNode[], catchBranch?: SemanticNode[], finallyBranch?: SemanticNode[], metadata?: SemanticMetadata): CommandSemanticNode;
+/**
+ * Create an async coordination (all/race) command node (v1.2).
+ */
+export declare function createAsyncNode(variant: AsyncVariant, asyncBody: SemanticNode[], metadata?: SemanticMetadata): CommandSemanticNode;
+/**
+ * Create a match command node with pattern arms (v1.2).
+ */
+export declare function createMatchNode(roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>, arms: MatchArm[], defaultArm?: SemanticNode[], metadata?: SemanticMetadata): CommandSemanticNode;
+/** Wire format envelope with version metadata (v1.2). */
+export interface LSEEnvelope {
+    readonly lseVersion: string;
+    readonly features?: readonly string[];
+    readonly nodes: readonly SemanticNode[];
+}
 //# sourceMappingURL=types.d.ts.map

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":"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"}

package/dist/core/types.js

@@ -14,6 +14,9 @@ function createPropertyPath(object, property) {
 function createExpression(raw) {
   return { type: "expression", raw };
 }
+function createFlag(name, enabled = true) {
+  return { type: "flag", name, enabled };
+}
 function createCommandNode(action, roles, metadata) {
   const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));
   const node = {
@@ -65,6 +68,7 @@ function createCompoundNode(statements, chainType = "sequential", metadata) {
   return metadata ? { ...base, metadata } : base;
 }
 function extractValue(value) {
+  if (value.type === "flag") return value.name;
   if ("raw" in value && value.raw !== void 0) return String(value.raw);
   if ("value" in value && value.value !== void 0) return String(value.value);
   if (value.type === "property-path") return `${extractValue(value.object)}.${value.property}`;
@@ -91,17 +95,53 @@ function createLoopNode(action, roles, loopVariant, body, loopVariable, indexVar
     ...metadata && { metadata }
   };
 }
+function createTryNode(body, catchBranch, finallyBranch, metadata) {
+  return {
+    kind: "command",
+    action: "try",
+    roles: /* @__PURE__ */ new Map(),
+    body,
+    ...catchBranch && catchBranch.length > 0 ? { catchBranch } : {},
+    ...finallyBranch && finallyBranch.length > 0 ? { finallyBranch } : {},
+    ...metadata ? { metadata } : {}
+  };
+}
+function createAsyncNode(variant, asyncBody, metadata) {
+  return {
+    kind: "command",
+    action: variant,
+    roles: /* @__PURE__ */ new Map(),
+    asyncVariant: variant,
+    asyncBody,
+    ...metadata ? { metadata } : {}
+  };
+}
+function createMatchNode(roles, arms, defaultArm, metadata) {
+  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));
+  return {
+    kind: "command",
+    action: "match",
+    roles: rolesMap,
+    arms,
+    ...defaultArm && defaultArm.length > 0 ? { defaultArm } : {},
+    ...metadata ? { metadata } : {}
+  };
+}
 export {
+  createAsyncNode,
   createCommandNode,
   createCompoundNode,
   createConditionalNode,
   createEventHandlerNode,
   createExpression,
+  createFlag,
   createLiteral,
   createLoopNode,
+  createMatchNode,
   createPropertyPath,
   createReference,
   createSelector,
+  createTryNode,
   extractRoleValue,
   extractValue
 };

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * Generic Semantic Types for Multilingual DSLs\n *\n * This module defines the canonical semantic representation that all languages\n * parse to and render from. The semantic layer is language-neutral - it captures\n * the MEANING of DSL commands independent of surface syntax.\n *\n * These types are domain-agnostic - they work for any DSL (SQL, animations, etc.)\n */\n\n// =============================================================================\n// Action Types (Generic)\n// =============================================================================\n\n/**\n * Action type represents the command/operation in a DSL.\n * This is generic - each DSL defines its own set of actions.\n *\n * Examples:\n * - Hyperscript: 'toggle', 'add', 'remove', 'fetch'\n * - SQL: 'select', 'insert', 'update', 'delete'\n * - Animation: 'animate', 'fade', 'slide', 'rotate'\n */\nexport type ActionType = string;\n\n/**\n * Semantic role represents the grammatical function of a part of a command.\n * This is generic - each DSL can define its own roles, though common ones include:\n *\n * Common roles across DSLs:\n * - action: The verb/command\n * - patient: What is being acted upon\n * - destination: Where something goes\n * - source: Where something comes from\n * - condition: Boolean expressions\n * - quantity: Numeric amounts\n * - duration: Time spans\n *\n * Examples:\n * - Hyperscript: 'patient', 'destination', 'source', 'event', 'style'\n * - SQL: 'columns', 'table', 'condition', 'orderBy', 'limit'\n * - Animation: 'target', 'duration', 'easing', 'delay'\n */\nexport type SemanticRole = string;\n\n// =============================================================================\n// Semantic Values\n// =============================================================================\n\n/**\n * A semantic value represents a typed piece of data in a semantic node.\n * Values are language-neutral - they capture what something IS, not how it's written.\n */\nexport type SemanticValue =\n  | LiteralValue\n  | SelectorValue\n  | ReferenceValue\n  | PropertyPathValue\n  | ExpressionValue;\n\n/**\n * Expected value types for role tokens.\n * Shared between RoleSpec (command-schemas) and RolePatternToken.\n */\nexport type ExpectedType = SemanticValue['type'];\n\nexport interface LiteralValue {\n  readonly type: 'literal';\n  readonly value: string | number | boolean;\n  readonly dataType?: 'string' | 'number' | 'boolean' | 'duration';\n}\n\nexport interface SelectorValue {\n  readonly type: 'selector';\n  readonly value: string; // The selector: #id, .class, [attr], table-name, etc.\n  readonly selectorKind?: 'id' | 'class' | 'attribute' | 'element' | 'complex' | 'identifier';\n}\n\nexport interface ReferenceValue {\n  readonly type: 'reference';\n  readonly value: string; // Generic reference name (DSL-specific)\n}\n\nexport interface PropertyPathValue {\n  readonly type: 'property-path';\n  readonly object: SemanticValue;\n  readonly property: string;\n}\n\nexport interface ExpressionValue {\n  readonly type: 'expression';\n  /** Raw expression string for complex expressions that need further parsing */\n  readonly raw: string;\n}\n\n// =============================================================================\n// Semantic Nodes\n// =============================================================================\n\n/**\n * Base interface for all semantic nodes.\n * Semantic nodes capture the MEANING of DSL constructs.\n */\nexport interface SemanticNode {\n  readonly kind: 'command' | 'event-handler' | 'conditional' | 'compound' | 'loop';\n  readonly action: ActionType;\n  readonly roles: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly metadata?: SemanticMetadata;\n}\n\n/**\n * Metadata about the source of a semantic node.\n * Useful for debugging, error messages, and round-trip conversion.\n */\nexport interface SemanticMetadata {\n  readonly sourceLanguage?: string;\n  readonly sourceText?: string;\n  readonly sourcePosition?: SourcePosition;\n  readonly patternId?: string;\n  /**\n   * Confidence score for the parse (0-1).\n   * Higher values indicate more certain matches.\n   * - 1.0: Exact match with all roles captured\n   * - 0.8-0.99: High confidence with minor uncertainty\n   * - 0.6-0.8: Medium confidence (normalization, defaults applied)\n   * - <0.6: Low confidence (may need fallback)\n   */\n  readonly confidence?: number;\n}\n\nexport interface SourcePosition {\n  readonly start: number;\n  readonly end: number;\n  readonly line?: number;\n  readonly column?: number;\n}\n\n/**\n * A command semantic node - represents a single DSL command.\n */\nexport interface CommandSemanticNode extends SemanticNode {\n  readonly kind: 'command';\n}\n\n/**\n * An event handler semantic node - represents trigger-based commands.\n * E.g., \"on click [commands]\" in hyperscript, or \"when condition [commands]\" in other DSLs.\n */\nexport interface EventHandlerSemanticNode extends SemanticNode {\n  readonly kind: 'event-handler';\n  readonly body: SemanticNode[];\n  readonly eventModifiers?: EventModifiers;\n  readonly additionalEvents?: readonly SemanticValue[];\n  readonly parameterNames?: readonly string[];\n}\n\nexport interface EventModifiers {\n  readonly once?: boolean;\n  readonly debounce?: number;\n  readonly throttle?: number;\n  readonly queue?: 'first' | 'last' | 'all' | 'none';\n  readonly from?: SemanticValue;\n}\n\n/**\n * A conditional semantic node - represents \"if [condition] then [body] else [body]\".\n */\nexport interface ConditionalSemanticNode extends SemanticNode {\n  readonly kind: 'conditional';\n  readonly thenBranch: SemanticNode[];\n  readonly elseBranch?: SemanticNode[];\n}\n\n/**\n * A compound semantic node - represents multiple chained statements.\n */\nexport interface CompoundSemanticNode extends SemanticNode {\n  readonly kind: 'compound';\n  readonly statements: SemanticNode[];\n  readonly chainType: 'then' | 'and' | 'async' | 'sequential';\n}\n\n/**\n * Loop variant discriminant for different loop types.\n */\nexport type LoopVariant = 'forever' | 'times' | 'for' | 'while' | 'until';\n\n/**\n * A loop semantic node - represents repeat/for/while loops.\n */\nexport interface LoopSemanticNode extends SemanticNode {\n  readonly kind: 'loop';\n  readonly loopVariant: LoopVariant;\n  readonly body: SemanticNode[];\n  readonly loopVariable?: string;\n  readonly indexVariable?: string;\n}\n\n// =============================================================================\n// Tokenization Types\n// =============================================================================\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  /** Normalized form from explicit keyword map */\n  readonly normalized?: string;\n  /** Morphologically normalized stem */\n  readonly stem?: string;\n  /** Confidence in the morphological stem (0.0-1.0) */\n  readonly stemConfidence?: number;\n  /** Additional metadata for specific token types */\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\n  /** Look at token at current position + offset without consuming */\n  peek(offset?: number): LanguageToken | null;\n\n  /** Consume and return current token, advance position */\n  advance(): LanguageToken;\n\n  /** Check if we've consumed all tokens */\n  isAtEnd(): boolean;\n\n  /** Save current position for backtracking */\n  mark(): StreamMark;\n\n  /** Restore to a saved position */\n  reset(mark: StreamMark): void;\n\n  /** Get current position */\n  position(): number;\n}\n\n/**\n * Stream mark for backtracking during parsing.\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\n  /** Convert input string to token stream */\n  tokenize(input: string): TokenStream;\n\n  /** Classify a single token */\n  classifyToken(token: string): TokenKind;\n}\n\n// =============================================================================\n// Pattern Matching Types\n// =============================================================================\n\n/**\n * A language pattern defines how a semantic structure appears in a specific language.\n */\nexport interface LanguagePattern {\n  /** Unique identifier for this pattern */\n  readonly id: string;\n  /** ISO 639-1 language code */\n  readonly language: string;\n  /** Which command this pattern matches */\n  readonly command: ActionType;\n  /** Priority for disambiguation (higher = checked first) */\n  readonly priority: number;\n  /** The pattern template with role placeholders */\n  readonly template: PatternTemplate;\n  /** Rules for extracting semantic roles from matched tokens */\n  readonly extraction: ExtractionRules;\n  /** Optional constraints on when this pattern applies */\n  readonly constraints?: PatternConstraints;\n}\n\n/**\n * Pattern template - defines expected token sequence.\n */\nexport interface PatternTemplate {\n  /** Human-readable template string */\n  readonly format: string;\n  /** Parsed token sequence for matching */\n  readonly tokens: PatternToken[];\n}\n\n/**\n * Pattern token - literal, role placeholder, or group.\n */\nexport type PatternToken = LiteralPatternToken | RolePatternToken | GroupPatternToken;\n\nexport interface LiteralPatternToken {\n  readonly type: 'literal';\n  readonly value: string;\n  /** Alternative spellings/forms that also match */\n  readonly alternatives?: string[];\n}\n\nexport interface RolePatternToken {\n  readonly type: 'role';\n  readonly role: SemanticRole;\n  readonly optional?: boolean;\n  /** Expected value types (for validation) */\n  readonly expectedTypes?: Array<ExpectedType>;\n  /** When true, captures all remaining tokens until next marker or end */\n  readonly greedy?: boolean;\n}\n\nexport interface GroupPatternToken {\n  readonly type: 'group';\n  readonly tokens: PatternToken[];\n  readonly optional?: boolean;\n}\n\n/**\n * Rules for extracting semantic values from matched tokens.\n */\nexport interface ExtractionRules {\n  readonly [role: string]: ExtractionRule;\n}\n\nexport interface ExtractionRule {\n  /** Position-based extraction (0-indexed from pattern start) */\n  readonly position?: number;\n  /** Marker-based extraction (find value after this marker) */\n  readonly marker?: string;\n  /** Alternative markers that also work */\n  readonly markerAlternatives?: string[];\n  /** Transform the extracted value */\n  readonly transform?: (raw: string) => SemanticValue;\n  /** Default value if not found (for optional roles) */\n  readonly default?: SemanticValue;\n  /** Static value extraction */\n  readonly value?: string;\n  /** Extract value from a pattern role by name */\n  readonly fromRole?: string;\n}\n\n/**\n * Additional constraints on pattern applicability.\n */\nexport interface PatternConstraints {\n  /** Required roles that must be present */\n  readonly requiredRoles?: SemanticRole[];\n  /** Roles that must NOT be present */\n  readonly forbiddenRoles?: SemanticRole[];\n  /** Valid selector types for the patient role */\n  readonly validPatientTypes?: Array<SelectorValue['selectorKind']>;\n  /** Pattern IDs this conflicts with */\n  readonly conflictsWith?: string[];\n}\n\n/**\n * Result of matching a pattern against tokens.\n */\nexport interface PatternMatchResult {\n  readonly pattern: LanguagePattern;\n  readonly captured: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly consumedTokens: number;\n  readonly confidence: number; // 0-1, how well the pattern matched\n}\n\n/**\n * Error when pattern matching fails.\n */\nexport interface PatternMatchError {\n  readonly message: string;\n  readonly position: SourcePosition;\n  readonly expectedPatterns?: string[];\n  readonly partialMatch?: Partial<PatternMatchResult>;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Create a literal value\n */\nexport function createLiteral(\n  value: string | number | boolean,\n  dataType?: 'string' | 'number' | 'boolean' | 'duration'\n): LiteralValue {\n  return dataType ? { type: 'literal', value, dataType } : { type: 'literal', value };\n}\n\n/**\n * Create a selector value\n */\nexport function createSelector(\n  value: string,\n  selectorKind?: SelectorValue['selectorKind']\n): SelectorValue {\n  return selectorKind ? { type: 'selector', value, selectorKind } : { type: 'selector', value };\n}\n\n/**\n * Create a reference value\n */\nexport function createReference(value: string): ReferenceValue {\n  return { type: 'reference', value };\n}\n\n/**\n * Create a property path value\n */\nexport function createPropertyPath(object: SemanticValue, property: string): PropertyPathValue {\n  return { type: 'property-path', object, property };\n}\n\n/**\n * Create an expression value\n */\nexport function createExpression(raw: string): ExpressionValue {\n  return { type: 'expression', raw };\n}\n\n/**\n * Create a command semantic node\n */\nexport function createCommandNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  metadata?: SemanticMetadata\n): CommandSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const node: CommandSemanticNode = {\n    kind: 'command',\n    action,\n    roles: rolesMap,\n  };\n  if (metadata) {\n    return { ...node, metadata };\n  }\n  return node;\n}\n\n/**\n * Create an event handler semantic node\n */\nexport function createEventHandlerNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  body: SemanticNode[],\n  metadata?: SemanticMetadata,\n  eventModifiers?: EventModifiers\n): EventHandlerSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'event-handler' as const,\n    action,\n    roles: rolesMap,\n    body,\n  };\n  return {\n    ...base,\n    ...(eventModifiers && { eventModifiers }),\n    ...(metadata && { metadata }),\n  };\n}\n\n/**\n * Create a conditional semantic node\n */\nexport function createConditionalNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  thenBranch: SemanticNode[],\n  elseBranch?: SemanticNode[],\n  metadata?: SemanticMetadata\n): ConditionalSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'conditional' as const,\n    action,\n    roles: rolesMap,\n    thenBranch,\n  };\n  return {\n    ...base,\n    ...(elseBranch && { elseBranch }),\n    ...(metadata && { metadata }),\n  };\n}\n\n/**\n * Create a compound semantic node\n */\nexport function createCompoundNode(\n  statements: SemanticNode[],\n  chainType: CompoundSemanticNode['chainType'] = 'sequential',\n  metadata?: SemanticMetadata\n): CompoundSemanticNode {\n  const base = {\n    kind: 'compound' as const,\n    action: 'compound' as const,\n    roles: new Map(),\n    statements,\n    chainType,\n  };\n  return metadata ? { ...base, metadata } : base;\n}\n\n/**\n * Extract a string value from a SemanticValue.\n *\n * Handles all value types in the SemanticValue union:\n * - ExpressionValue: returns `raw`\n * - LiteralValue/SelectorValue/ReferenceValue: returns `value` as string\n * - PropertyPathValue: returns `object.property` path\n *\n * This is the standard way to get a display string from any semantic value,\n * eliminating the need for `as any` casts in domain code generators.\n */\nexport function extractValue(value: SemanticValue): string {\n  if ('raw' in value && value.raw !== undefined) return String(value.raw);\n  if ('value' in value && value.value !== undefined) return String(value.value);\n  if (value.type === 'property-path') return `${extractValue(value.object)}.${value.property}`;\n  return '';\n}\n\n/**\n * Extract a string value from a named role on a SemanticNode.\n *\n * Convenience wrapper: looks up the role, returns empty string if missing.\n * Eliminates the common `const x = node.roles.get('role'); const val = x ? extractValue(x as any) : '';` pattern.\n */\nexport function extractRoleValue(node: SemanticNode, role: string): string {\n  const value = node.roles.get(role);\n  if (!value) return '';\n  return extractValue(value);\n}\n\n/**\n * Create a loop semantic node\n */\nexport function createLoopNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  loopVariant: LoopVariant,\n  body: SemanticNode[],\n  loopVariable?: string,\n  indexVariable?: string,\n  metadata?: SemanticMetadata\n): LoopSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'loop' as const,\n    action,\n    roles: rolesMap,\n    loopVariant,\n    body,\n  };\n  return {\n    ...base,\n    ...(loopVariable && { loopVariable }),\n    ...(indexVariable && { indexVariable }),\n    ...(metadata && { metadata }),\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * Generic Semantic Types for Multilingual DSLs\n *\n * This module defines the canonical semantic representation that all languages\n * parse to and render from. The semantic layer is language-neutral - it captures\n * the MEANING of DSL commands independent of surface syntax.\n *\n * These types are domain-agnostic - they work for any DSL (SQL, animations, etc.)\n */\n\n// =============================================================================\n// Action Types (Generic)\n// =============================================================================\n\n/**\n * Action type represents the command/operation in a DSL.\n * This is generic - each DSL defines its own set of actions.\n *\n * Examples:\n * - Hyperscript: 'toggle', 'add', 'remove', 'fetch'\n * - SQL: 'select', 'insert', 'update', 'delete'\n * - Animation: 'animate', 'fade', 'slide', 'rotate'\n */\nexport type ActionType = string;\n\n/**\n * Semantic role represents the grammatical function of a part of a command.\n * This is generic - each DSL can define its own roles, though common ones include:\n *\n * Common roles across DSLs:\n * - action: The verb/command\n * - patient: What is being acted upon\n * - destination: Where something goes\n * - source: Where something comes from\n * - condition: Boolean expressions\n * - quantity: Numeric amounts\n * - duration: Time spans\n *\n * Examples:\n * - Hyperscript: 'patient', 'destination', 'source', 'event', 'style'\n * - SQL: 'columns', 'table', 'condition', 'orderBy', 'limit'\n * - Animation: 'target', 'duration', 'easing', 'delay'\n */\nexport type SemanticRole = string;\n\n// =============================================================================\n// Semantic Values\n// =============================================================================\n\n/**\n * A semantic value represents a typed piece of data in a semantic node.\n * Values are language-neutral - they capture what something IS, not how it's written.\n */\nexport type SemanticValue =\n  | LiteralValue\n  | SelectorValue\n  | ReferenceValue\n  | PropertyPathValue\n  | ExpressionValue\n  | FlagValue;\n\n/**\n * Expected value types for role tokens.\n * Shared between RoleSpec (command-schemas) and RolePatternToken.\n */\nexport type ExpectedType = SemanticValue['type'];\n\nexport interface LiteralValue {\n  readonly type: 'literal';\n  readonly value: string | number | boolean;\n  readonly dataType?: 'string' | 'number' | 'boolean' | 'duration';\n}\n\nexport interface SelectorValue {\n  readonly type: 'selector';\n  readonly value: string; // The selector: #id, .class, [attr], table-name, etc.\n  readonly selectorKind?: 'id' | 'class' | 'attribute' | 'element' | 'complex' | 'identifier';\n}\n\nexport interface ReferenceValue {\n  readonly type: 'reference';\n  readonly value: string; // Generic reference name (DSL-specific)\n}\n\nexport interface PropertyPathValue {\n  readonly type: 'property-path';\n  readonly object: SemanticValue;\n  readonly property: string;\n}\n\nexport interface ExpressionValue {\n  readonly type: 'expression';\n  /** Raw expression string for complex expressions that need further parsing */\n  readonly raw: string;\n}\n\n/**\n * A boolean flag value — present (+flag) or negated (~flag).\n * Used in declarative domains for no-value attributes like primary-key, not-null.\n */\nexport interface FlagValue {\n  readonly type: 'flag';\n  readonly name: string;\n  readonly enabled: boolean;\n}\n\n// =============================================================================\n// Annotations & Diagnostics (v1.2)\n// =============================================================================\n\n/** A metadata annotation on a node (v1.2). */\nexport interface Annotation {\n  readonly name: string;\n  readonly value?: string;\n}\n\n/**\n * A type constraint diagnostic attached to a node (v1.2).\n *\n * Named `ProtocolDiagnostic` to avoid collision with the framework's own\n * `Diagnostic` type (which has `severity: 'error' | 'warning' | 'info'`\n * and `suggestion?: string`).\n */\nexport interface ProtocolDiagnostic {\n  readonly level: 'error' | 'warning';\n  readonly role: string;\n  readonly message: string;\n  readonly code: string;\n}\n\n/** Async coordination variant (v1.2). */\nexport type AsyncVariant = 'all' | 'race';\n\n/** A single arm in a match command (v1.2). */\nexport interface MatchArm {\n  readonly pattern: SemanticValue;\n  readonly body: SemanticNode[];\n}\n\n// =============================================================================\n// Semantic Nodes\n// =============================================================================\n\n/**\n * Base interface for all semantic nodes.\n * Semantic nodes capture the MEANING of DSL constructs.\n */\nexport interface SemanticNode {\n  readonly kind: 'command' | 'event-handler' | 'conditional' | 'compound' | 'loop';\n  readonly action: ActionType;\n  readonly roles: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly metadata?: SemanticMetadata;\n  /** Metadata annotations (v1.2). */\n  readonly annotations?: readonly Annotation[];\n  /** Type constraint diagnostics (v1.2). */\n  readonly diagnostics?: readonly ProtocolDiagnostic[];\n}\n\n/**\n * Metadata about the source of a semantic node.\n * Useful for debugging, error messages, and round-trip conversion.\n */\nexport interface SemanticMetadata {\n  readonly sourceLanguage?: string;\n  readonly sourceText?: string;\n  readonly sourcePosition?: SourcePosition;\n  readonly patternId?: string;\n  /**\n   * Confidence score for the parse (0-1).\n   * Higher values indicate more certain matches.\n   * - 1.0: Exact match with all roles captured\n   * - 0.8-0.99: High confidence with minor uncertainty\n   * - 0.6-0.8: Medium confidence (normalization, defaults applied)\n   * - <0.6: Low confidence (may need fallback)\n   */\n  readonly confidence?: number;\n}\n\nexport interface SourcePosition {\n  readonly start: number;\n  readonly end: number;\n  readonly line?: number;\n  readonly column?: number;\n}\n\n/**\n * A command semantic node - represents a single DSL command.\n *\n * v1.2 adds optional fields for try/catch/finally, async coordination (all/race),\n * and pattern matching (match/arms). These are encoded as fields on command nodes\n * (matching the protocol wire format) rather than new node kinds.\n */\nexport interface CommandSemanticNode extends SemanticNode {\n  readonly kind: 'command';\n  /** try body — commands to execute in the try block (v1.2). */\n  readonly body?: readonly SemanticNode[];\n  /** catch branch — commands to execute on error (v1.2). */\n  readonly catchBranch?: readonly SemanticNode[];\n  /** finally branch — cleanup commands that always execute (v1.2). */\n  readonly finallyBranch?: readonly SemanticNode[];\n  /** Async coordination variant: all (wait for all) or race (first wins) (v1.2). */\n  readonly asyncVariant?: AsyncVariant;\n  /** Async body — concurrent commands for all/race (v1.2). */\n  readonly asyncBody?: readonly SemanticNode[];\n  /** Match arms — pattern/body pairs for match command (v1.2). */\n  readonly arms?: readonly MatchArm[];\n  /** Default arm — executed when no match arm matches (v1.2). */\n  readonly defaultArm?: readonly SemanticNode[];\n}\n\n/**\n * An event handler semantic node - represents trigger-based commands.\n * E.g., \"on click [commands]\" in hyperscript, or \"when condition [commands]\" in other DSLs.\n */\nexport interface EventHandlerSemanticNode extends SemanticNode {\n  readonly kind: 'event-handler';\n  readonly body: SemanticNode[];\n  readonly eventModifiers?: EventModifiers;\n  readonly additionalEvents?: readonly SemanticValue[];\n  readonly parameterNames?: readonly string[];\n}\n\nexport interface EventModifiers {\n  readonly once?: boolean;\n  readonly debounce?: number;\n  readonly throttle?: number;\n  readonly queue?: 'first' | 'last' | 'all' | 'none';\n  readonly from?: SemanticValue;\n}\n\n/**\n * A conditional semantic node - represents \"if [condition] then [body] else [body]\".\n */\nexport interface ConditionalSemanticNode extends SemanticNode {\n  readonly kind: 'conditional';\n  readonly thenBranch: SemanticNode[];\n  readonly elseBranch?: SemanticNode[];\n}\n\n/**\n * A compound semantic node - represents multiple chained statements.\n */\nexport interface CompoundSemanticNode extends SemanticNode {\n  readonly kind: 'compound';\n  readonly statements: SemanticNode[];\n  readonly chainType: 'then' | 'and' | 'async' | 'sequential' | 'pipe';\n}\n\n/**\n * Loop variant discriminant for different loop types.\n */\nexport type LoopVariant = 'forever' | 'times' | 'for' | 'while' | 'until';\n\n/**\n * A loop semantic node - represents repeat/for/while loops.\n */\nexport interface LoopSemanticNode extends SemanticNode {\n  readonly kind: 'loop';\n  readonly loopVariant: LoopVariant;\n  readonly body: SemanticNode[];\n  readonly loopVariable?: string;\n  readonly indexVariable?: string;\n}\n\n// =============================================================================\n// Tokenization Types\n// =============================================================================\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  /** Normalized form from explicit keyword map */\n  readonly normalized?: string;\n  /** Morphologically normalized stem */\n  readonly stem?: string;\n  /** Confidence in the morphological stem (0.0-1.0) */\n  readonly stemConfidence?: number;\n  /** Additional metadata for specific token types */\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\n  /** Look at token at current position + offset without consuming */\n  peek(offset?: number): LanguageToken | null;\n\n  /** Consume and return current token, advance position */\n  advance(): LanguageToken;\n\n  /** Check if we've consumed all tokens */\n  isAtEnd(): boolean;\n\n  /** Save current position for backtracking */\n  mark(): StreamMark;\n\n  /** Restore to a saved position */\n  reset(mark: StreamMark): void;\n\n  /** Get current position */\n  position(): number;\n}\n\n/**\n * Stream mark for backtracking during parsing.\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\n  /** Convert input string to token stream */\n  tokenize(input: string): TokenStream;\n\n  /** Classify a single token */\n  classifyToken(token: string): TokenKind;\n}\n\n// =============================================================================\n// Pattern Matching Types\n// =============================================================================\n\n/**\n * A language pattern defines how a semantic structure appears in a specific language.\n */\nexport interface LanguagePattern {\n  /** Unique identifier for this pattern */\n  readonly id: string;\n  /** ISO 639-1 language code */\n  readonly language: string;\n  /** Which command this pattern matches */\n  readonly command: ActionType;\n  /** Priority for disambiguation (higher = checked first) */\n  readonly priority: number;\n  /** The pattern template with role placeholders */\n  readonly template: PatternTemplate;\n  /** Rules for extracting semantic roles from matched tokens */\n  readonly extraction: ExtractionRules;\n  /** Optional constraints on when this pattern applies */\n  readonly constraints?: PatternConstraints;\n}\n\n/**\n * Pattern template - defines expected token sequence.\n */\nexport interface PatternTemplate {\n  /** Human-readable template string */\n  readonly format: string;\n  /** Parsed token sequence for matching */\n  readonly tokens: PatternToken[];\n}\n\n/**\n * Pattern token - literal, role placeholder, or group.\n */\nexport type PatternToken = LiteralPatternToken | RolePatternToken | GroupPatternToken;\n\nexport interface LiteralPatternToken {\n  readonly type: 'literal';\n  readonly value: string;\n  /** Alternative spellings/forms that also match */\n  readonly alternatives?: string[];\n}\n\nexport interface RolePatternToken {\n  readonly type: 'role';\n  readonly role: SemanticRole;\n  readonly optional?: boolean;\n  /** Expected value types (for validation) */\n  readonly expectedTypes?: Array<ExpectedType>;\n  /** When true, captures all remaining tokens until next marker or end */\n  readonly greedy?: boolean;\n}\n\nexport interface GroupPatternToken {\n  readonly type: 'group';\n  readonly tokens: PatternToken[];\n  readonly optional?: boolean;\n}\n\n/**\n * Rules for extracting semantic values from matched tokens.\n */\nexport interface ExtractionRules {\n  readonly [role: string]: ExtractionRule;\n}\n\nexport interface ExtractionRule {\n  /** Position-based extraction (0-indexed from pattern start) */\n  readonly position?: number;\n  /** Marker-based extraction (find value after this marker) */\n  readonly marker?: string;\n  /** Alternative markers that also work */\n  readonly markerAlternatives?: string[];\n  /** Transform the extracted value */\n  readonly transform?: (raw: string) => SemanticValue;\n  /** Default value if not found (for optional roles) */\n  readonly default?: SemanticValue;\n  /** Static value extraction */\n  readonly value?: string;\n  /** Extract value from a pattern role by name */\n  readonly fromRole?: string;\n}\n\n/**\n * Additional constraints on pattern applicability.\n */\nexport interface PatternConstraints {\n  /** Required roles that must be present */\n  readonly requiredRoles?: SemanticRole[];\n  /** Roles that must NOT be present */\n  readonly forbiddenRoles?: SemanticRole[];\n  /** Valid selector types for the patient role */\n  readonly validPatientTypes?: Array<SelectorValue['selectorKind']>;\n  /** Pattern IDs this conflicts with */\n  readonly conflictsWith?: string[];\n}\n\n/**\n * Result of matching a pattern against tokens.\n */\nexport interface PatternMatchResult {\n  readonly pattern: LanguagePattern;\n  readonly captured: ReadonlyMap<SemanticRole, SemanticValue>;\n  readonly consumedTokens: number;\n  readonly confidence: number; // 0-1, how well the pattern matched\n}\n\n/**\n * Error when pattern matching fails.\n */\nexport interface PatternMatchError {\n  readonly message: string;\n  readonly position: SourcePosition;\n  readonly expectedPatterns?: string[];\n  readonly partialMatch?: Partial<PatternMatchResult>;\n}\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Create a literal value\n */\nexport function createLiteral(\n  value: string | number | boolean,\n  dataType?: 'string' | 'number' | 'boolean' | 'duration'\n): LiteralValue {\n  return dataType ? { type: 'literal', value, dataType } : { type: 'literal', value };\n}\n\n/**\n * Create a selector value\n */\nexport function createSelector(\n  value: string,\n  selectorKind?: SelectorValue['selectorKind']\n): SelectorValue {\n  return selectorKind ? { type: 'selector', value, selectorKind } : { type: 'selector', value };\n}\n\n/**\n * Create a reference value\n */\nexport function createReference(value: string): ReferenceValue {\n  return { type: 'reference', value };\n}\n\n/**\n * Create a property path value\n */\nexport function createPropertyPath(object: SemanticValue, property: string): PropertyPathValue {\n  return { type: 'property-path', object, property };\n}\n\n/**\n * Create an expression value\n */\nexport function createExpression(raw: string): ExpressionValue {\n  return { type: 'expression', raw };\n}\n\n/**\n * Create a boolean flag value (+flag or ~flag)\n */\nexport function createFlag(name: string, enabled: boolean = true): FlagValue {\n  return { type: 'flag', name, enabled };\n}\n\n/**\n * Create a command semantic node\n */\nexport function createCommandNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  metadata?: SemanticMetadata\n): CommandSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const node: CommandSemanticNode = {\n    kind: 'command',\n    action,\n    roles: rolesMap,\n  };\n  if (metadata) {\n    return { ...node, metadata };\n  }\n  return node;\n}\n\n/**\n * Create an event handler semantic node\n */\nexport function createEventHandlerNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  body: SemanticNode[],\n  metadata?: SemanticMetadata,\n  eventModifiers?: EventModifiers\n): EventHandlerSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'event-handler' as const,\n    action,\n    roles: rolesMap,\n    body,\n  };\n  return {\n    ...base,\n    ...(eventModifiers && { eventModifiers }),\n    ...(metadata && { metadata }),\n  };\n}\n\n/**\n * Create a conditional semantic node\n */\nexport function createConditionalNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  thenBranch: SemanticNode[],\n  elseBranch?: SemanticNode[],\n  metadata?: SemanticMetadata\n): ConditionalSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'conditional' as const,\n    action,\n    roles: rolesMap,\n    thenBranch,\n  };\n  return {\n    ...base,\n    ...(elseBranch && { elseBranch }),\n    ...(metadata && { metadata }),\n  };\n}\n\n/**\n * Create a compound semantic node\n */\nexport function createCompoundNode(\n  statements: SemanticNode[],\n  chainType: CompoundSemanticNode['chainType'] = 'sequential',\n  metadata?: SemanticMetadata\n): CompoundSemanticNode {\n  const base = {\n    kind: 'compound' as const,\n    action: 'compound' as const,\n    roles: new Map(),\n    statements,\n    chainType,\n  };\n  return metadata ? { ...base, metadata } : base;\n}\n\n/**\n * Extract a string value from a SemanticValue.\n *\n * Handles all value types in the SemanticValue union:\n * - ExpressionValue: returns `raw`\n * - LiteralValue/SelectorValue/ReferenceValue: returns `value` as string\n * - PropertyPathValue: returns `object.property` path\n *\n * This is the standard way to get a display string from any semantic value,\n * eliminating the need for `as any` casts in domain code generators.\n */\nexport function extractValue(value: SemanticValue): string {\n  if (value.type === 'flag') return value.name;\n  if ('raw' in value && value.raw !== undefined) return String(value.raw);\n  if ('value' in value && value.value !== undefined) return String(value.value);\n  if (value.type === 'property-path') return `${extractValue(value.object)}.${value.property}`;\n  return '';\n}\n\n/**\n * Extract a string value from a named role on a SemanticNode.\n *\n * Convenience wrapper: looks up the role, returns empty string if missing.\n * Eliminates the common `const x = node.roles.get('role'); const val = x ? extractValue(x as any) : '';` pattern.\n */\nexport function extractRoleValue(node: SemanticNode, role: string): string {\n  const value = node.roles.get(role);\n  if (!value) return '';\n  return extractValue(value);\n}\n\n/**\n * Create a loop semantic node\n */\nexport function createLoopNode(\n  action: ActionType,\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  loopVariant: LoopVariant,\n  body: SemanticNode[],\n  loopVariable?: string,\n  indexVariable?: string,\n  metadata?: SemanticMetadata\n): LoopSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  const base = {\n    kind: 'loop' as const,\n    action,\n    roles: rolesMap,\n    loopVariant,\n    body,\n  };\n  return {\n    ...base,\n    ...(loopVariable && { loopVariable }),\n    ...(indexVariable && { indexVariable }),\n    ...(metadata && { metadata }),\n  };\n}\n\n// =============================================================================\n// v1.2 Factory Helpers\n// =============================================================================\n\n/**\n * Create a try/catch/finally command node (v1.2).\n */\nexport function createTryNode(\n  body: SemanticNode[],\n  catchBranch?: SemanticNode[],\n  finallyBranch?: SemanticNode[],\n  metadata?: SemanticMetadata\n): CommandSemanticNode {\n  return {\n    kind: 'command',\n    action: 'try',\n    roles: new Map(),\n    body,\n    ...(catchBranch && catchBranch.length > 0 ? { catchBranch } : {}),\n    ...(finallyBranch && finallyBranch.length > 0 ? { finallyBranch } : {}),\n    ...(metadata ? { metadata } : {}),\n  };\n}\n\n/**\n * Create an async coordination (all/race) command node (v1.2).\n */\nexport function createAsyncNode(\n  variant: AsyncVariant,\n  asyncBody: SemanticNode[],\n  metadata?: SemanticMetadata\n): CommandSemanticNode {\n  return {\n    kind: 'command',\n    action: variant,\n    roles: new Map(),\n    asyncVariant: variant,\n    asyncBody,\n    ...(metadata ? { metadata } : {}),\n  };\n}\n\n/**\n * Create a match command node with pattern arms (v1.2).\n */\nexport function createMatchNode(\n  roles: Record<SemanticRole, SemanticValue> | Map<SemanticRole, SemanticValue>,\n  arms: MatchArm[],\n  defaultArm?: SemanticNode[],\n  metadata?: SemanticMetadata\n): CommandSemanticNode {\n  const rolesMap = roles instanceof Map ? roles : new Map(Object.entries(roles));\n  return {\n    kind: 'command',\n    action: 'match',\n    roles: rolesMap,\n    arms,\n    ...(defaultArm && defaultArm.length > 0 ? { defaultArm } : {}),\n    ...(metadata ? { metadata } : {}),\n  };\n}\n\n/** Wire format envelope with version metadata (v1.2). */\nexport interface LSEEnvelope {\n  readonly lseVersion: string;\n  readonly features?: readonly string[];\n  readonly nodes: readonly SemanticNode[];\n}\n"],"mappings":"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","names":[]}

package/dist/feedback/confidence-gate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Confidence-Aware Disambiguation
+ *
+ * When parse confidence is borderline (between low and high thresholds),
+ * generates a disambiguation request with alternative interpretations
+ * instead of blindly accepting or rejecting.
+ */
+import type { SemanticNode } from '../core/types';
+import type { DisambiguationRequest } from './types';
+/**
+ * Check whether a confidence score falls in the disambiguation range.
+ *
+ * @returns true if the confidence is ambiguous (between low and high thresholds)
+ */
+export declare function needsDisambiguation(confidence: number, low?: number, high?: number): boolean;
+/**
+ * Build a disambiguation request from candidate interpretations.
+ *
+ * @param input - The original ambiguous input
+ * @param candidates - Alternative interpretations with confidence scores
+ */
+export declare function buildDisambiguation(input: string, candidates: ReadonlyArray<{
+    action: string;
+    confidence: number;
+    node: SemanticNode;
+    description?: string;
+}>): DisambiguationRequest;
+//# sourceMappingURL=confidence-gate.d.ts.map

package/dist/feedback/confidence-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-gate.d.ts","sourceRoot":"","sources":["../../src/feedback/confidence-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAA2B,MAAM,SAAS,CAAC;AAM9E;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAY,EACjB,IAAI,GAAE,MAAY,GACjB,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,GACD,qBAAqB,CA0BvB"}

package/dist/feedback/feedback-formatter.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Feedback Formatter
+ *
+ * Maps diagnostics to machine-actionable LSEFeedback with hints,
+ * corrected examples, and schema context. Enables LLMs to self-correct
+ * based on structured error information.
+ */
+import type { Diagnostic } from '../generation/diagnostics';
+import type { SchemaLookup } from '../ir/types';
+import type { LSEFeedback } from './types';
+/**
+ * Build structured feedback from diagnostics and optional schema context.
+ *
+ * @param input - The original input text
+ * @param inputFormat - Format of the input
+ * @param diagnostics - Error diagnostics from validation/parsing
+ * @param schemaLookup - Optional schema lookup for generating hints and corrections
+ * @param action - The attempted command action (if identifiable)
+ */
+export declare function buildFeedback(input: string, inputFormat: 'explicit' | 'json' | 'natural', diagnostics: readonly Diagnostic[], schemaLookup?: SchemaLookup, action?: string): LSEFeedback;
+//# sourceMappingURL=feedback-formatter.d.ts.map

package/dist/feedback/feedback-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-formatter.d.ts","sourceRoot":"","sources":["../../src/feedback/feedback-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAmC,MAAM,aAAa,CAAC;AAGjF,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,SAAS,CAAC;AAMxE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,EAC5C,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,YAAY,CAAC,EAAE,YAAY,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CA0Bb"}

package/dist/feedback/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Feedback Loop
+ *
+ * Structured error feedback, confidence-aware disambiguation,
+ * and pattern hit-rate tracking for the LLM ↔ LSE integration.
+ */
+export type { LSEFeedback, FeedbackDiagnostic, FixType, DisambiguationRequest, DisambiguationCandidate, PatternEvent, HitRate, PatternTrackerSummary, TopFailure, } from './types';
+export { buildFeedback } from './feedback-formatter';
+export { needsDisambiguation, buildDisambiguation } from './confidence-gate';
+export { PatternTracker } from './pattern-tracker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,OAAO,EACP,qBAAqB,EACrB,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/feedback/pattern-tracker.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Pattern Hit-Rate Tracker
+ *
+ * Records pattern events in a ring buffer and computes hit-rate
+ * statistics by command, language, and diagnostic code. Patterns
+ * with high rejected/attempts ratios indicate miscalibrated confidence.
+ */
+import type { PatternEvent, HitRate, PatternTrackerSummary, TopFailure } from './types';
+export declare class PatternTracker {
+    private events;
+    private readonly maxEvents;
+    constructor(maxEvents?: number);
+    /**
+     * Record a pattern event.
+     */
+    record(event: PatternEvent): void;
+    /**
+     * Get hit rate by command action.
+     */
+    getHitRateByCommand(): Record<string, HitRate>;
+    /**
+     * Get hit rate by language.
+     */
+    getHitRateByLanguage(): Record<string, HitRate>;
+    /**
+     * Get the most frequent failure diagnostic codes.
+     */
+    getTopFailures(limit?: number): TopFailure[];
+    /**
+     * Get a complete summary of tracking data.
+     */
+    getSummary(): PatternTrackerSummary;
+    /**
+     * Export all events as JSONL.
+     */
+    exportJSONL(): string;
+    /**
+     * Get the number of recorded events.
+     */
+    get size(): number;
+    /**
+     * Clear all events.
+     */
+    clear(): void;
+    private computeHitRate;
+}
+//# sourceMappingURL=pattern-tracker.d.ts.map

package/dist/feedback/pattern-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-tracker.d.ts","sourceRoot":"","sources":["../../src/feedback/pattern-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAMxF,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,GAAE,MAAa;IAIpC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAQjC;;OAEG;IACH,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI9C;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI/C;;OAEG;IACH,cAAc,CAAC,KAAK,GAAE,MAAW,GAAG,UAAU,EAAE;IAuBhD;;OAEG;IACH,UAAU,IAAI,qBAAqB;IAenC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,cAAc;CAuBvB"}

package/dist/feedback/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Feedback Loop Types
+ *
+ * Types for structured error feedback, confidence-aware disambiguation,
+ * and pattern hit-rate tracking in the LLM ↔ LSE integration.
+ */
+import type { SemanticJSON } from '../ir/types';
+/**
+ * Structured feedback for an LSE validation attempt.
+ */
+export interface LSEFeedback {
+    /** Whether the input was accepted (no errors) */
+    readonly accepted: boolean;
+    /** The original input */
+    readonly input: {
+        readonly format: 'explicit' | 'json' | 'natural';
+        readonly text: string;
+    };
+    /** Machine-actionable diagnostics */
+    readonly diagnostics: readonly FeedbackDiagnostic[];
+    /** Human-readable hints for retrying */
+    readonly hints: readonly string[];
+    /** Valid schema structure for the attempted command (if identifiable) */
+    readonly schema?: {
+        readonly action: string;
+        readonly requiredRoles: readonly string[];
+        readonly optionalRoles: readonly string[];
+        readonly roleDescriptions: Readonly<Record<string, string>>;
+    };
+    /** Corrected example (if fixable) */
+    readonly correctedExample?: {
+        readonly explicit: string;
+        readonly json: SemanticJSON;
+    };
+}
+/**
+ * A single diagnostic with machine-actionable fix type.
+ */
+export interface FeedbackDiagnostic {
+    readonly severity: 'error' | 'warning' | 'info';
+    readonly code: string;
+    readonly message: string;
+    readonly suggestion?: string;
+    readonly fixType?: FixType;
+}
+/**
+ * Machine-actionable fix type for LLM retry logic.
+ */
+export type FixType = 'missing_role' | 'invalid_type' | 'unknown_command' | 'unknown_role' | 'syntax_error';
+/**
+ * A disambiguation request presented when confidence is borderline.
+ */
+export interface DisambiguationRequest {
+    /** The original input that was ambiguous */
+    readonly input: string;
+    /** Candidate interpretations ranked by confidence */
+    readonly candidates: readonly DisambiguationCandidate[];
+    /** Human/LLM-readable disambiguation prompt */
+    readonly question: string;
+}
+/**
+ * A single candidate interpretation.
+ */
+export interface DisambiguationCandidate {
+    /** Command action */
+    readonly action: string;
+    /** Confidence score */
+    readonly confidence: number;
+    /** Canonical LSE for this interpretation */
+    readonly explicit: string;
+    /** Human-readable description */
+    readonly description: string;
+}
+/**
+ * A single pattern event for hit-rate tracking.
+ */
+export interface PatternEvent {
+    readonly timestamp: number;
+    readonly domain: string;
+    readonly action: string;
+    readonly language: string;
+    readonly inputFormat: 'explicit' | 'json' | 'natural';
+    readonly confidence: number;
+    readonly outcome: 'accepted' | 'rejected' | 'disambiguated';
+    readonly diagnosticCodes?: readonly string[];
+}
+/**
+ * Hit-rate statistics for a category.
+ */
+export interface HitRate {
+    readonly attempts: number;
+    readonly successes: number;
+    readonly rate: number;
+}
+/**
+ * Summary of pattern tracking data.
+ */
+export interface PatternTrackerSummary {
+    readonly totalEvents: number;
+    readonly byOutcome: Readonly<Record<string, number>>;
+    readonly byCommand: Readonly<Record<string, HitRate>>;
+    readonly byLanguage: Readonly<Record<string, HitRate>>;
+    readonly topFailures: readonly TopFailure[];
+}
+/**
+ * A frequently failing diagnostic code.
+ */
+export interface TopFailure {
+    readonly code: string;
+    readonly count: number;
+    readonly actions: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/feedback/types.ts"],"names":[],"mappings":"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"}

package/dist/generation/index.js

@@ -69,7 +69,7 @@ function addRoleWithMarker(tokens, roleSpec, profile) {
   if (marker) {
     const markerInfo = profile.roleMarkers?.[roleSpec.role];
     const defaultPosition = profile.wordOrder === "SOV" ? "after" : "before";
-    const position = markerInfo?.position ?? defaultPosition;
+    const position = roleSpec.markerPosition ?? markerInfo?.position ?? defaultPosition;
     if (isOptional) {
       if (position === "before") {
         tokens.push({
@@ -156,6 +156,7 @@ function generatePatternVariants(schema, profile, config = defaultConfig) {
 
 // src/core/types.ts
 function extractValue(value) {
+  if (value.type === "flag") return value.name;
   if ("raw" in value && value.raw !== void 0) return String(value.raw);
   if ("value" in value && value.value !== void 0) return String(value.value);
   if (value.type === "property-path") return `${extractValue(value.object)}.${value.property}`;