@lokascript/framework 2.0.0

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

@@ -0,0 +1,78 @@
+/**
+ * Command Schema Types
+ *
+ * Defines the structure of DSL commands for pattern generation.
+ * These schemas are language-neutral and describe the semantic structure
+ * of commands rather than their surface syntax.
+ */
+import type { ActionType, SemanticRole, SemanticValue, ExpectedType } from '../core/types';
+/**
+ * Command schema - defines a DSL command's structure.
+ */
+export interface CommandSchema {
+    /** The action type (command name) */
+    readonly action: ActionType;
+    /** Human-readable description */
+    readonly description: string;
+    /** Roles this command accepts */
+    readonly roles: RoleSpec[];
+    /** The primary role (what the command acts on) */
+    readonly primaryRole: SemanticRole;
+    /** Category for grouping (DSL-specific) */
+    readonly category: string;
+    /** Whether this command typically has a body (like event handlers, blocks) */
+    readonly hasBody?: boolean;
+    /** Notes about special handling or usage */
+    readonly notes?: string;
+}
+/**
+ * Role specification - defines a semantic role in a command.
+ */
+export interface RoleSpec {
+    /** The semantic role */
+    readonly role: SemanticRole;
+    /** Description of what this role represents */
+    readonly description: string;
+    /** Whether this role is required */
+    readonly required: boolean;
+    /** Expected value types */
+    readonly expectedTypes: Array<ExpectedType>;
+    /** Default value if not provided */
+    readonly default?: SemanticValue;
+    /** Position hint for SVO languages (higher = earlier) */
+    readonly svoPosition?: number;
+    /** Position hint for SOV languages (higher = earlier) */
+    readonly sovPosition?: number;
+    /**
+     * Override the default role marker for this command.
+     * Maps language code to the marker to use (e.g., { en: 'from', ja: 'から' }).
+     * If not specified, uses the language profile's default roleMarker.
+     */
+    readonly markerOverride?: Record<string, string>;
+    /**
+     * Override the rendering marker separately from parsing.
+     * Used when the parsing grammar differs from rendered output.
+     * Maps language code to the rendering marker.
+     */
+    readonly renderOverride?: Record<string, string>;
+    /**
+     * When true, this role captures all remaining tokens until the next
+     * recognized marker keyword or end of input, joining their values
+     * with spaces into a single ExpressionValue.
+     *
+     * Only meaningful for the last role in a sequence or a role followed
+     * by a marked role. Default: false.
+     */
+    readonly greedy?: boolean;
+}
+/**
+ * Helper to create a command schema with sensible defaults.
+ * Provides defaults for description, category, and primaryRole.
+ */
+export declare function defineCommand(schema: Partial<CommandSchema> & Pick<CommandSchema, 'action' | 'roles'>): CommandSchema;
+/**
+ * Helper to create a role spec with sensible defaults.
+ * Provides default for description.
+ */
+export declare function defineRole(role: Partial<RoleSpec> & Pick<RoleSpec, 'role' | 'required' | 'expectedTypes'>): RoleSpec;
+//# sourceMappingURL=command-schema.d.ts.map

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

@@ -0,0 +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"}

package/dist/schema/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Schema types for defining DSL commands
+ */
+export * from './command-schema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,25 @@
+// src/schema/command-schema.ts
+function defineCommand(schema) {
+  return {
+    description: schema.description || `${schema.action} command`,
+    category: schema.category || "general",
+    primaryRole: schema.primaryRole || schema.roles[0]?.role || "patient",
+    ...schema,
+    action: schema.action,
+    roles: schema.roles
+  };
+}
+function defineRole(role) {
+  return {
+    description: role.description || `${role.role} role`,
+    ...role,
+    role: role.role,
+    required: role.required,
+    expectedTypes: role.expectedTypes
+  };
+}
+export {
+  defineCommand,
+  defineRole
+};
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +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":[]}

package/dist/test-setup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Global test setup for @lokascript/framework
+ * Runs before each test file to provide a clean testing environment
+ */
+/**
+ * Cleanup utility for manual cleanup in tests
+ */
+export declare function cleanupGlobalState(): void;
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmCH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @lokascript/framework/testing — Test utilities for domain packages
+ *
+ * Provides assertion helpers and type guards for testing domain DSLs
+ * built on the framework. Import from '@lokascript/framework/testing'
+ * in test files only (requires vitest as a peer dependency).
+ *
+ * @example
+ * ```typescript
+ * import { expectSemanticNode, isLiteralValue } from '@lokascript/framework/testing';
+ *
+ * test('parses select command', () => {
+ *   const node = dsl.parse('select name from users', 'en');
+ *   expectSemanticNode(node, 'select', { columns: 'name', source: 'users' });
+ * });
+ * ```
+ */
+import type { SemanticNode, CommandSemanticNode, SemanticValue, LiteralValue, SelectorValue, ExpressionValue, ReferenceValue } from '../core/types';
+/**
+ * Assert that a semantic node has the expected action and role values.
+ * Role values can be strings (matched against `value` or `raw`) or full SemanticValue objects.
+ */
+export declare function expectSemanticNode(node: SemanticNode, action: string, roles: Record<string, string | SemanticValue>): void;
+/**
+ * Assert that a value is a literal semantic value with the expected value.
+ */
+export declare function expectLiteralValue(value: SemanticValue | undefined, expectedValue: string | number | boolean): void;
+/**
+ * Assert that a value is a selector semantic value.
+ */
+export declare function expectSelectorValue(value: SemanticValue | undefined, expectedSelector: string, expectedKind?: SelectorValue['selectorKind']): void;
+/**
+ * Assert that a value is an expression semantic value.
+ */
+export declare function expectExpressionValue(value: SemanticValue | undefined, expectedRaw: string): void;
+/**
+ * Assert that a value is a reference semantic value.
+ */
+export declare function expectReferenceValue(value: SemanticValue | undefined, expectedRef: string): void;
+/** Type guard for LiteralValue */
+export declare function isLiteralValue(value: SemanticValue): value is LiteralValue;
+/** Type guard for SelectorValue */
+export declare function isSelectorValue(value: SemanticValue): value is SelectorValue;
+/** Type guard for ExpressionValue */
+export declare function isExpressionValue(value: SemanticValue): value is ExpressionValue;
+/** Type guard for ReferenceValue */
+export declare function isReferenceValue(value: SemanticValue): value is ReferenceValue;
+/** Type guard for CommandSemanticNode */
+export declare function isCommandNode(node: SemanticNode): node is CommandSemanticNode;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,EACf,MAAM,eAAe,CAAC;AAMvB;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC,GAC5C,IAAI,CAoBN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GACvC,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,gBAAgB,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,GAC3C,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAIjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAIhG;AAMD,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,aAAa,CAE5E;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,eAAe,CAEhF;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,cAAc,CAE9E;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,mBAAmB,CAE7E"}