@lokascript/framework 2.0.0 → 2.1.0

package/dist/prompts/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LLM Prompt Generation
+ *
+ * Auto-generates system prompts from CommandSchema[] for teaching LLMs
+ * to output valid LokaScript Explicit Syntax.
+ */
+export type { PromptGeneratorConfig, GeneratedPrompt, PromptSection, PromptMetadata, } from './types';
+export { generatePrompt, generateExamples, generateProtocolReference } from './prompt-generator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/prompts/prompt-generator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * LLM Prompt Generator
+ *
+ * Auto-generates LLM system prompts from CommandSchema[]. Given a set of
+ * domain schemas, produces a structured markdown prompt that teaches LLMs
+ * to output valid LSE bracket syntax and/or LLM-simplified JSON.
+ *
+ * The generated prompt includes:
+ * - Protocol overview (LSE syntax summary)
+ * - Value type reference
+ * - Per-command documentation with role descriptions
+ * - Synthetic examples in both formats
+ * - Output format specification
+ * - Error recovery instructions
+ */
+import type { CommandSchema } from '../schema/command-schema';
+import type { SemanticJSON } from '../ir/types';
+import type { PromptGeneratorConfig, GeneratedPrompt } from './types';
+/**
+ * Generate an LLM system prompt from domain command schemas.
+ *
+ * @example
+ * ```typescript
+ * import { generatePrompt } from '@lokascript/framework';
+ * import { allSchemas } from '@lokascript/domain-flow';
+ *
+ * const prompt = generatePrompt({
+ *   domain: 'flow',
+ *   description: 'Reactive data flow pipelines',
+ *   schemas: allSchemas,
+ * });
+ *
+ * console.log(prompt.text); // Full markdown system prompt
+ * ```
+ */
+export declare function generatePrompt(config: PromptGeneratorConfig): GeneratedPrompt;
+/**
+ * Generate synthetic LSE examples from a single command schema.
+ * Used by both the prompt generator and training data synthesizer.
+ */
+export declare function generateExamples(schema: CommandSchema, count?: number): Array<{
+    explicit: string;
+    json: SemanticJSON;
+}>;
+/**
+ * Generate a condensed LSE protocol reference (for MCP resources).
+ */
+export declare function generateProtocolReference(): string;
+//# sourceMappingURL=prompt-generator.d.ts.map

package/dist/prompts/prompt-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-generator.d.ts","sourceRoot":"","sources":["../../src/prompts/prompt-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAGnE,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EAGhB,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe,CA+B7E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,KAAK,GAAE,MAAU,GAChB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CA0CjD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAIlD"}

package/dist/prompts/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * LLM Prompt Generation Types
+ *
+ * Types for auto-generating LLM system prompts from CommandSchema[].
+ * The prompt generator reads domain schemas and produces markdown
+ * instructions that teach LLMs to output valid LSE bracket syntax
+ * and/or LLM-simplified JSON.
+ */
+import type { CommandSchema } from '../schema/command-schema';
+/**
+ * Configuration for generating an LLM system prompt from domain schemas.
+ */
+export interface PromptGeneratorConfig {
+    /** Domain identifier (e.g., 'flow', 'sql', 'bdd') */
+    readonly domain: string;
+    /** Human-readable domain description */
+    readonly description: string;
+    /** Command schemas to document */
+    readonly schemas: readonly CommandSchema[];
+    /** What output format to teach the LLM. Default: 'both' */
+    readonly outputFormat?: 'explicit' | 'json' | 'both';
+    /** Number of examples to generate per command. Default: 2 */
+    readonly examplesPerCommand?: number;
+    /** Approximate token budget for truncation. Default: no limit */
+    readonly maxTokens?: number;
+}
+/**
+ * Section of a generated prompt, for partial inclusion.
+ */
+export interface PromptSection {
+    /** Section identifier */
+    readonly id: string;
+    /** Human-readable title */
+    readonly title: string;
+    /** Markdown content */
+    readonly content: string;
+    /** Approximate token count (chars / 4 heuristic) */
+    readonly approximateTokens: number;
+}
+/**
+ * A complete generated system prompt with metadata.
+ */
+export interface GeneratedPrompt {
+    /** Full system prompt as markdown */
+    readonly text: string;
+    /** Individual sections for partial inclusion */
+    readonly sections: PromptSection[];
+    /** Metadata about the generated prompt */
+    readonly metadata: PromptMetadata;
+}
+/**
+ * Metadata about a generated prompt.
+ */
+export interface PromptMetadata {
+    /** Domain the prompt was generated for */
+    readonly domain: string;
+    /** Number of commands documented */
+    readonly commandCount: number;
+    /** Total number of roles across all commands */
+    readonly roleCount: number;
+    /** Approximate token count (chars / 4 heuristic) */
+    readonly approximateTokens: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/prompts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAE3C,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAErD,6DAA6D;IAC7D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAErC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,uBAAuB;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAEnC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC"}

package/dist/schema/command-schema.d.ts

@@ -55,6 +55,14 @@ export interface RoleSpec {
      * Maps language code to the rendering marker.
      */
     readonly renderOverride?: Record<string, string>;
+    /**
+     * Override the marker position for this role in the generated pattern.
+     * 'before' = marker precedes the role value (preposition: "set X").
+     * 'after'  = marker follows the role value (postposition: "X から").
+     * If not set, falls back to the language profile's roleMarkers position,
+     * then to the word-order default (SOV='after', else='before').
+     */
+    readonly markerPosition?: 'before' | 'after';
     /**
      * When true, this role captures all remaining tokens until the next
      * recognized marker keyword or end of input, joining their values
@@ -64,6 +72,15 @@ export interface RoleSpec {
      * by a marked role. Default: false.
      */
     readonly greedy?: boolean;
+    /**
+     * Restricts which selector subtypes are valid for this role (v1.2).
+     * Only meaningful when expectedTypes includes 'selector'.
+     * If omitted, all selector kinds are accepted.
+     *
+     * Example: `selectorKinds: ['class', 'attribute']` means only `.class`
+     * and `[attr]` selectors are valid, not `#id` or `*wildcard`.
+     */
+    readonly selectorKinds?: ReadonlyArray<'id' | 'class' | 'attribute' | 'element' | 'complex'>;
 }
 /**
  * Helper to create a command schema with sensible defaults.

package/dist/schema/command-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-schema.d.ts","sourceRoot":"","sources":["../../src/schema/command-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE3B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAE5C,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAEjC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,GACvE,aAAa,CASf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC,GAC9E,QAAQ,CAQV"}
+{"version":3,"file":"command-schema.d.ts","sourceRoot":"","sources":["../../src/schema/command-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAE3B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAEnC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B,2BAA2B;IAC3B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAE5C,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAEjC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE7C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;CAC9F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC,GACvE,aAAa,CASf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,eAAe,CAAC,GAC9E,QAAQ,CAQV"}

package/dist/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schema/command-schema.ts"],"sourcesContent":["/**\n * Command Schema Types\n *\n * Defines the structure of DSL commands for pattern generation.\n * These schemas are language-neutral and describe the semantic structure\n * of commands rather than their surface syntax.\n */\n\nimport type { ActionType, SemanticRole, SemanticValue, ExpectedType } from '../core/types';\n\n/**\n * Command schema - defines a DSL command's structure.\n */\nexport interface CommandSchema {\n  /** The action type (command name) */\n  readonly action: ActionType;\n\n  /** Human-readable description */\n  readonly description: string;\n\n  /** Roles this command accepts */\n  readonly roles: RoleSpec[];\n\n  /** The primary role (what the command acts on) */\n  readonly primaryRole: SemanticRole;\n\n  /** Category for grouping (DSL-specific) */\n  readonly category: string;\n\n  /** Whether this command typically has a body (like event handlers, blocks) */\n  readonly hasBody?: boolean;\n\n  /** Notes about special handling or usage */\n  readonly notes?: string;\n}\n\n/**\n * Role specification - defines a semantic role in a command.\n */\nexport interface RoleSpec {\n  /** The semantic role */\n  readonly role: SemanticRole;\n\n  /** Description of what this role represents */\n  readonly description: string;\n\n  /** Whether this role is required */\n  readonly required: boolean;\n\n  /** Expected value types */\n  readonly expectedTypes: Array<ExpectedType>;\n\n  /** Default value if not provided */\n  readonly default?: SemanticValue;\n\n  /** Position hint for SVO languages (higher = earlier) */\n  readonly svoPosition?: number;\n\n  /** Position hint for SOV languages (higher = earlier) */\n  readonly sovPosition?: number;\n\n  /**\n   * Override the default role marker for this command.\n   * Maps language code to the marker to use (e.g., { en: 'from', ja: 'から' }).\n   * If not specified, uses the language profile's default roleMarker.\n   */\n  readonly markerOverride?: Record<string, string>;\n\n  /**\n   * Override the rendering marker separately from parsing.\n   * Used when the parsing grammar differs from rendered output.\n   * Maps language code to the rendering marker.\n   */\n  readonly renderOverride?: Record<string, string>;\n\n  /**\n   * When true, this role captures all remaining tokens until the next\n   * recognized marker keyword or end of input, joining their values\n   * with spaces into a single ExpressionValue.\n   *\n   * Only meaningful for the last role in a sequence or a role followed\n   * by a marked role. Default: false.\n   */\n  readonly greedy?: boolean;\n}\n\n/**\n * Helper to create a command schema with sensible defaults.\n * Provides defaults for description, category, and primaryRole.\n */\nexport function defineCommand(\n  schema: Partial<CommandSchema> & Pick<CommandSchema, 'action' | 'roles'>\n): CommandSchema {\n  return {\n    description: schema.description || `${schema.action} command`,\n    category: schema.category || 'general',\n    primaryRole: schema.primaryRole || schema.roles[0]?.role || 'patient',\n    ...schema,\n    action: schema.action,\n    roles: schema.roles,\n  } as CommandSchema;\n}\n\n/**\n * Helper to create a role spec with sensible defaults.\n * Provides default for description.\n */\nexport function defineRole(\n  role: Partial<RoleSpec> & Pick<RoleSpec, 'role' | 'required' | 'expectedTypes'>\n): RoleSpec {\n  return {\n    description: role.description || `${role.role} role`,\n    ...role,\n    role: role.role,\n    required: role.required,\n    expectedTypes: role.expectedTypes,\n  };\n}\n"],"mappings":";AA0FO,SAAS,cACd,QACe;AACf,SAAO;AAAA,IACL,aAAa,OAAO,eAAe,GAAG,OAAO,MAAM;AAAA,IACnD,UAAU,OAAO,YAAY;AAAA,IAC7B,aAAa,OAAO,eAAe,OAAO,MAAM,CAAC,GAAG,QAAQ;AAAA,IAC5D,GAAG;AAAA,IACH,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,EAChB;AACF;AAMO,SAAS,WACd,MACU;AACV,SAAO;AAAA,IACL,aAAa,KAAK,eAAe,GAAG,KAAK,IAAI;AAAA,IAC7C,GAAG;AAAA,IACH,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,IACf,eAAe,KAAK;AAAA,EACtB;AACF;","names":[]}
+{"version":3,"sources":["../../src/schema/command-schema.ts"],"sourcesContent":["/**\n * Command Schema Types\n *\n * Defines the structure of DSL commands for pattern generation.\n * These schemas are language-neutral and describe the semantic structure\n * of commands rather than their surface syntax.\n */\n\nimport type { ActionType, SemanticRole, SemanticValue, ExpectedType } from '../core/types';\n\n/**\n * Command schema - defines a DSL command's structure.\n */\nexport interface CommandSchema {\n  /** The action type (command name) */\n  readonly action: ActionType;\n\n  /** Human-readable description */\n  readonly description: string;\n\n  /** Roles this command accepts */\n  readonly roles: RoleSpec[];\n\n  /** The primary role (what the command acts on) */\n  readonly primaryRole: SemanticRole;\n\n  /** Category for grouping (DSL-specific) */\n  readonly category: string;\n\n  /** Whether this command typically has a body (like event handlers, blocks) */\n  readonly hasBody?: boolean;\n\n  /** Notes about special handling or usage */\n  readonly notes?: string;\n}\n\n/**\n * Role specification - defines a semantic role in a command.\n */\nexport interface RoleSpec {\n  /** The semantic role */\n  readonly role: SemanticRole;\n\n  /** Description of what this role represents */\n  readonly description: string;\n\n  /** Whether this role is required */\n  readonly required: boolean;\n\n  /** Expected value types */\n  readonly expectedTypes: Array<ExpectedType>;\n\n  /** Default value if not provided */\n  readonly default?: SemanticValue;\n\n  /** Position hint for SVO languages (higher = earlier) */\n  readonly svoPosition?: number;\n\n  /** Position hint for SOV languages (higher = earlier) */\n  readonly sovPosition?: number;\n\n  /**\n   * Override the default role marker for this command.\n   * Maps language code to the marker to use (e.g., { en: 'from', ja: 'から' }).\n   * If not specified, uses the language profile's default roleMarker.\n   */\n  readonly markerOverride?: Record<string, string>;\n\n  /**\n   * Override the rendering marker separately from parsing.\n   * Used when the parsing grammar differs from rendered output.\n   * Maps language code to the rendering marker.\n   */\n  readonly renderOverride?: Record<string, string>;\n\n  /**\n   * Override the marker position for this role in the generated pattern.\n   * 'before' = marker precedes the role value (preposition: \"set X\").\n   * 'after'  = marker follows the role value (postposition: \"X から\").\n   * If not set, falls back to the language profile's roleMarkers position,\n   * then to the word-order default (SOV='after', else='before').\n   */\n  readonly markerPosition?: 'before' | 'after';\n\n  /**\n   * When true, this role captures all remaining tokens until the next\n   * recognized marker keyword or end of input, joining their values\n   * with spaces into a single ExpressionValue.\n   *\n   * Only meaningful for the last role in a sequence or a role followed\n   * by a marked role. Default: false.\n   */\n  readonly greedy?: boolean;\n\n  /**\n   * Restricts which selector subtypes are valid for this role (v1.2).\n   * Only meaningful when expectedTypes includes 'selector'.\n   * If omitted, all selector kinds are accepted.\n   *\n   * Example: `selectorKinds: ['class', 'attribute']` means only `.class`\n   * and `[attr]` selectors are valid, not `#id` or `*wildcard`.\n   */\n  readonly selectorKinds?: ReadonlyArray<'id' | 'class' | 'attribute' | 'element' | 'complex'>;\n}\n\n/**\n * Helper to create a command schema with sensible defaults.\n * Provides defaults for description, category, and primaryRole.\n */\nexport function defineCommand(\n  schema: Partial<CommandSchema> & Pick<CommandSchema, 'action' | 'roles'>\n): CommandSchema {\n  return {\n    description: schema.description || `${schema.action} command`,\n    category: schema.category || 'general',\n    primaryRole: schema.primaryRole || schema.roles[0]?.role || 'patient',\n    ...schema,\n    action: schema.action,\n    roles: schema.roles,\n  } as CommandSchema;\n}\n\n/**\n * Helper to create a role spec with sensible defaults.\n * Provides default for description.\n */\nexport function defineRole(\n  role: Partial<RoleSpec> & Pick<RoleSpec, 'role' | 'required' | 'expectedTypes'>\n): RoleSpec {\n  return {\n    description: role.description || `${role.role} role`,\n    ...role,\n    role: role.role,\n    required: role.required,\n    expectedTypes: role.expectedTypes,\n  };\n}\n"],"mappings":";AA6GO,SAAS,cACd,QACe;AACf,SAAO;AAAA,IACL,aAAa,OAAO,eAAe,GAAG,OAAO,MAAM;AAAA,IACnD,UAAU,OAAO,YAAY;AAAA,IAC7B,aAAa,OAAO,eAAe,OAAO,MAAM,CAAC,GAAG,QAAQ;AAAA,IAC5D,GAAG;AAAA,IACH,QAAQ,OAAO;AAAA,IACf,OAAO,OAAO;AAAA,EAChB;AACF;AAMO,SAAS,WACd,MACU;AACV,SAAO;AAAA,IACL,aAAa,KAAK,eAAe,GAAG,KAAK,IAAI;AAAA,IAC7C,GAAG;AAAA,IACH,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,IACf,eAAe,KAAK;AAAA,EACtB;AACF;","names":[]}

package/dist/testing/index.js

@@ -1759,6 +1759,9 @@ function printProps(keys2, props, config2, indentation, depth, refs, printer2) {
   const colors = config2.colors;
   return keys2.map((key) => {
     const value = props[key];
+    if (typeof value === "string" && value[0] === "_" && value.startsWith("__vitest_") && value.match(/__vitest_\d+__/)) {
+      return "";
+    }
     let printed = printer2(value, config2, indentationNext, depth, refs);
     if (typeof value !== "string") {
       if (printed.includes("\n")) {