@lokascript/framework 2.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 LokaScript Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# @lokascript/framework
+
+> **Generic framework for building multilingual domain-specific languages (DSLs)**
+
+Build DSLs that work in 24+ human languages with semantic parsing, pattern generation, and grammar transformation.
+
+## Features
+
+- **🌍 Multilingual**: Support 24+ languages out of the box (English, Japanese, Spanish, Arabic, etc.)
+- **🧠 Semantic Parsing**: Parse natural language commands into language-neutral semantic representations
+- **🔄 Grammar Transformation**: Automatically handle word order (SVO/SOV/VSO) and grammatical markers
+- **📦 Zero Dependencies**: Pure TypeScript, no runtime dependencies
+- **🎯 Type-Safe**: Full TypeScript support with generic types
+- **🔌 Extensible**: Custom roles, value types, and transformation rules
+- **⚡ Fast**: Efficient pattern matching and caching
+
+## Installation
+
+```bash
+npm install @lokascript/framework
+```
+
+## Quick Start
+
+```typescript
+import { createMultilingualDSL } from '@lokascript/framework';
+
+// Define your DSL's commands
+const selectCommand = {
+  action: 'select',
+  primaryRole: 'columns',
+  roles: [
+    { role: 'columns', required: true, expectedTypes: ['expression'] },
+    { role: 'source', required: true, expectedTypes: ['literal'] },
+  ],
+};
+
+// Create your DSL instance
+const sqlDSL = createMultilingualDSL({
+  schemas: [selectCommand],
+  languages: [
+    {
+      code: 'en',
+      profile: { wordOrder: 'SVO', keywords: { select: 'select' } },
+      tokenizer: new EnglishTokenizer(),
+    },
+  ],
+});
+
+// Use your DSL
+const node = sqlDSL.parse('select name from users', 'en');
+// → { action: 'select', roles: { columns: 'name', source: 'users' } }
+```
+
+## Core Concepts
+
+### Semantic Roles
+
+Commands are represented as **semantic roles** rather than positional arguments:
+
+```typescript
+// Traditional (positional)
+command('toggle', '.active', '#button');
+
+// Semantic (role-based)
+{
+  action: 'toggle',
+  roles: {
+    patient: '.active',      // What is being acted upon
+    destination: '#button'   // Where it's being toggled
+  }
+}
+```
+
+This enables:
+
+- Language-independent meaning
+- Automatic word order transformation
+- Clear intent for code generation
+
+### Word Order Transformation
+
+The framework automatically handles different word orders:
+
+```typescript
+// English (SVO): Subject-Verb-Object
+'toggle .active on #button';
+
+// Japanese (SOV): Subject-Object-Verb
+'#button の .active を トグル';
+
+// Arabic (VSO): Verb-Subject-Object
+'بدّل .active على #button';
+
+// All parse to the same semantic representation!
+```
+
+### Pattern Generation
+
+Instead of writing patterns by hand, define schemas and let the framework generate patterns:
+
+```typescript
+// Define once
+const schema = {
+  action: 'select',
+  roles: [
+    { role: 'columns', required: true },
+    { role: 'source', required: true, markerOverride: { en: 'from', ja: 'から' } },
+  ],
+};
+
+// Framework generates patterns for all languages automatically
+// English: "select [columns] from [source]"
+// Japanese: "[source] から [columns] を 選択"
+```
+
+## Documentation
+
+- [API Reference](./docs/API.md)
+- [Language Profiles](./docs/LANGUAGE_PROFILES.md)
+- [Grammar Transformation](./docs/GRAMMAR.md)
+- [Examples](./examples/)
+
+## Examples
+
+- [SQL DSL](./examples/sql-dsl/) - Query language in English + Spanish
+- [Animation DSL](./examples/animation-dsl/) - Animation commands in English + Japanese
+- [Form Validation DSL](./examples/validation-dsl/) - Validation rules
+
+## Status
+
+🚧 **Alpha** - API is stable but may change before 1.0.0
+
+Currently extracted from [HyperFixi/LokaScript](https://github.com/codetalcott/hyperfixi), a production-tested multilingual hyperscript implementation with:
+
+- 8100+ tests passing
+- 24 languages supported
+- Used in real applications
+
+## License
+
+MIT © LokaScript Contributors

package/dist/aot/aot-orchestrator.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Generalized AOT Orchestrator
+ *
+ * Coordinates scan → parse → compile → collect for any domain.
+ * Each domain provides a DomainCompilationBackend (DSL + CodeGenerator + scan config),
+ * and the orchestrator handles the rest.
+ *
+ * @example
+ * ```typescript
+ * import { AOTOrchestrator } from '@lokascript/framework';
+ *
+ * const orchestrator = new AOTOrchestrator();
+ *
+ * orchestrator.registerBackend({
+ *   domain: 'sql',
+ *   dsl: createSQLDSL(),
+ *   codeGenerator: sqlCodeGenerator,
+ *   scanConfig: {
+ *     domain: 'sql',
+ *     attributes: ['data-sql'],
+ *     scriptTypes: ['text/sql-dsl'],
+ *   },
+ * });
+ *
+ * const result = await orchestrator.compileFiles(
+ *   ['index.html', 'about.html'],
+ *   (path) => fs.promises.readFile(path, 'utf-8')
+ * );
+ * ```
+ */
+import type { MultilingualDSL, CodeGenerator } from '../api/create-dsl';
+import type { DomainScanConfig, ExtractedSnippet, CompiledSnippet, AOTBatchResult, GeneralizedAOTOptions, OutputOptions } from './types';
+/**
+ * Per-domain compilation backend.
+ * Provides everything needed to scan, parse, and compile a domain's syntax.
+ */
+export interface DomainCompilationBackend {
+    /** Domain name (must match scanConfig.domain) */
+    readonly domain: string;
+    /** The DSL instance for parsing and compilation */
+    readonly dsl: MultilingualDSL;
+    /** Code generator for producing target code from semantic nodes */
+    readonly codeGenerator: CodeGenerator;
+    /** Scan configuration declaring HTML attribute patterns */
+    readonly scanConfig: DomainScanConfig;
+}
+/**
+ * Generalized AOT orchestrator for any domain.
+ */
+export declare class AOTOrchestrator {
+    private backends;
+    private options;
+    constructor(options?: GeneralizedAOTOptions);
+    /**
+     * Register a domain compilation backend.
+     * @throws if a backend with the same domain name is already registered
+     */
+    registerBackend(backend: DomainCompilationBackend): void;
+    /**
+     * Scan source files and compile all domain snippets.
+     */
+    compileFiles(files: string[], readFile: (path: string) => Promise<string>): Promise<AOTBatchResult>;
+    /**
+     * Compile a single extracted snippet.
+     * Returns the compiled result or an error object.
+     */
+    compileSnippet(snippet: ExtractedSnippet): CompiledSnippet | {
+        error: string;
+    };
+    /**
+     * Generate combined output from compilation results.
+     */
+    generateOutput(result: AOTBatchResult, options?: OutputOptions): string;
+}
+//# sourceMappingURL=aot-orchestrator.d.ts.map

package/dist/aot/aot-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aot-orchestrator.d.ts","sourceRoot":"","sources":["../../src/aot/aot-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,aAAa,EACd,MAAM,SAAS,CAAC;AAOjB;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;CACvC;AAMD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,OAAO,CAAkC;gBAErC,OAAO,CAAC,EAAE,qBAAqB;IAQ3C;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAOxD;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC1C,OAAO,CAAC,cAAc,CAAC;IA+C1B;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE;IAyB9E;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;CA6DxE"}

package/dist/aot/domain-scanner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Domain-Aware Scanner
+ *
+ * Extracts DSL snippets from HTML/template files based on domain-declared
+ * attribute patterns and script types. Unlike the hyperscript-specific
+ * HTMLScanner, this scanner is configured dynamically from DomainScanConfig.
+ */
+import type { DomainScanConfig, ExtractedSnippet } from './types';
+/**
+ * Scans HTML/template files for domain-specific snippets.
+ *
+ * Configured by DomainScanConfig objects, each declaring which
+ * HTML attributes and script types a domain uses.
+ */
+export declare class DomainAwareScanner {
+    private configs;
+    constructor(configs: readonly DomainScanConfig[]);
+    /**
+     * Extract all domain snippets from an HTML source string.
+     */
+    extract(source: string, filename: string): ExtractedSnippet[];
+    /**
+     * Extract snippets from multiple files.
+     */
+    extractFromFiles(files: string[], readFile: (path: string) => Promise<string>): Promise<ExtractedSnippet[]>;
+}
+//# sourceMappingURL=domain-scanner.d.ts.map

package/dist/aot/domain-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-scanner.d.ts","sourceRoot":"","sources":["../../src/aot/domain-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAyElE;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA8B;gBAEjC,OAAO,EAAE,SAAS,gBAAgB,EAAE;IAIhD;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE;IA2D7D;;OAEG;IACG,gBAAgB,CACpB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC1C,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAe/B"}

package/dist/aot/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generalized AOT compilation for any domain.
+ */
+export * from './types';
+export { DomainAwareScanner } from './domain-scanner';
+export { AOTOrchestrator } from './aot-orchestrator';
+export type { DomainCompilationBackend } from './aot-orchestrator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/aot/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Generalized AOT Type Definitions
+ *
+ * Types for the domain-agnostic Ahead-of-Time compilation system.
+ * Any domain that provides a MultilingualDSL and CodeGenerator can use this.
+ */
+/**
+ * How a domain declares its HTML attribute patterns for scanning.
+ */
+export interface DomainScanConfig {
+    /** Domain name (should match DomainDescriptor.name) */
+    readonly domain: string;
+    /** Attribute names to scan for (e.g., ['data-sql', '_sql']) */
+    readonly attributes: readonly string[];
+    /** Script tag types to scan for (e.g., ['text/sql-dsl']) */
+    readonly scriptTypes?: readonly string[];
+    /** Default language when not specified on element (default: 'en') */
+    readonly defaultLanguage?: string;
+}
+/**
+ * A snippet extracted from a source file, tagged with its domain.
+ */
+export interface ExtractedSnippet {
+    /** Domain this snippet belongs to */
+    readonly domain: string;
+    /** The DSL code */
+    readonly code: string;
+    /** Language code (from element's lang attribute or default) */
+    readonly language: string;
+    /** Source file path */
+    readonly file: string;
+    /** Line number in source file (1-based) */
+    readonly line: number;
+    /** Column number in source file (1-based) */
+    readonly column: number;
+    /** Element ID if available */
+    readonly elementId?: string;
+    /** CSS selector for the element */
+    readonly elementSelector?: string;
+}
+/**
+ * Result of compiling a single snippet.
+ */
+export interface CompiledSnippet {
+    /** Domain that compiled this snippet */
+    readonly domain: string;
+    /** Original source code */
+    readonly source: string;
+    /** Compiled output */
+    readonly compiled: string;
+    /** Source language */
+    readonly language: string;
+    /** Source file path */
+    readonly file: string;
+    /** Line number in source file */
+    readonly line: number;
+}
+/**
+ * Result of batch-compiling all snippets from a project.
+ */
+export interface AOTBatchResult {
+    /** Successfully compiled snippets */
+    readonly compiled: readonly CompiledSnippet[];
+    /** Snippets that failed compilation */
+    readonly errors: ReadonlyArray<{
+        readonly domain: string;
+        readonly source: string;
+        readonly file: string;
+        readonly line: number;
+        readonly message: string;
+    }>;
+    /** Summary statistics */
+    readonly stats: {
+        readonly totalSnippets: number;
+        readonly compiledCount: number;
+        readonly errorCount: number;
+        /** Number of snippets per domain */
+        readonly domainBreakdown: Record<string, number>;
+    };
+}
+/**
+ * Options for the generalized AOT compiler.
+ */
+export interface GeneralizedAOTOptions {
+    /** Minimum confidence for semantic parsing (default: 0.7) */
+    readonly confidenceThreshold?: number;
+    /** Continue compiling other snippets on individual errors (default: true) */
+    readonly continueOnError?: boolean;
+    /** Debug mode — log extraction and compilation details */
+    readonly debug?: boolean;
+}
+/**
+ * Options for generating combined output.
+ */
+export interface OutputOptions {
+    /** Module format (default: 'esm') */
+    readonly format?: 'esm' | 'cjs' | 'iife';
+    /** Include source location comments (default: true) */
+    readonly includeComments?: boolean;
+    /** Group output by domain (default: true) */
+    readonly groupByDomain?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/api/create-dsl.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Main API for creating multilingual DSLs
+ */
+import type { SemanticNode, LanguageTokenizer, LanguagePattern } from '../core/types';
+import type { CommandSchema } from '../schema';
+import { type PatternGenLanguageProfile } from '../generation/pattern-generator';
+import { type LanguageProfile as GrammarProfile } from '../grammar';
+import { type Dictionary, type ProfileProvider, type ValueExtractor } from '../interfaces';
+/**
+ * Language configuration for a DSL.
+ */
+export interface LanguageConfig {
+    /** ISO 639-1 language code */
+    readonly code: string;
+    /** English name of the language */
+    readonly name: string;
+    /** Native name of the language */
+    readonly nativeName: string;
+    /** Language tokenizer */
+    readonly tokenizer: LanguageTokenizer;
+    /** Language profile for pattern generation */
+    readonly patternProfile: PatternGenLanguageProfile;
+    /** Language profile for grammar transformation (optional) */
+    readonly grammarProfile?: GrammarProfile;
+}
+/**
+ * Code generator function that transforms semantic AST to target code.
+ */
+export interface CodeGenerator {
+    generate(node: SemanticNode): string;
+}
+/**
+ * DSL configuration with dependency injection support.
+ */
+export interface DSLConfig {
+    /** DSL name (for debugging/documentation) */
+    readonly name?: string;
+    /** Command schemas defining the DSL grammar */
+    readonly schemas: readonly CommandSchema[];
+    /** Language configurations */
+    readonly languages: readonly LanguageConfig[];
+    /** Dictionary for keyword translation (default: built from language configs) */
+    readonly dictionary?: Dictionary;
+    /** Profile provider for grammar transformation (default: built from language configs) */
+    readonly profileProvider?: ProfileProvider;
+    /** Value extractors for tokenization (default: generic extractors) */
+    readonly valueExtractors?: ValueExtractor[];
+    /** Code generator for compilation (default: none) */
+    readonly codeGenerator?: CodeGenerator;
+    /** Auto-generate patterns from schemas (default: true) */
+    readonly generatePatterns?: boolean;
+    /** Custom patterns to supplement generated ones */
+    readonly customPatterns?: LanguagePattern[];
+}
+/**
+ * Validation result.
+ */
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly node?: SemanticNode;
+    readonly errors?: string[];
+}
+/**
+ * Compilation result.
+ */
+export interface CompileResult {
+    readonly ok: boolean;
+    readonly code?: string;
+    readonly errors?: string[];
+    readonly node?: SemanticNode;
+    readonly metadata?: {
+        readonly parser: string;
+        readonly confidence: number;
+    };
+}
+/**
+ * Main multilingual DSL interface.
+ */
+export interface MultilingualDSL {
+    parse(input: string, language: string): SemanticNode;
+    parseWithConfidence(input: string, language: string): {
+        node: SemanticNode;
+        confidence: number;
+    };
+    validate(input: string, language: string): ValidationResult;
+    compile(input: string, language: string): CompileResult;
+    translate(input: string, fromLanguage: string, toLanguage: string): string;
+    getSupportedLanguages(): string[];
+}
+export declare function createMultilingualDSL(config: DSLConfig): MultilingualDSL;
+//# sourceMappingURL=create-dsl.d.ts.map

package/dist/api/create-dsl.d.ts.map

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

package/dist/api/dispatcher.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Cross-Domain Dispatcher
+ *
+ * Routes natural-language input to the correct domain by trying all registered
+ * domains and picking the highest-confidence match. Supports auto-detection,
+ * composite multi-line parsing, and confidence-based routing.
+ *
+ * @example
+ * ```typescript
+ * import { DomainRegistry, CrossDomainDispatcher } from '@lokascript/framework';
+ *
+ * const registry = new DomainRegistry();
+ * registry.register(sqlDescriptor);
+ * registry.register(bddDescriptor);
+ *
+ * const dispatcher = new CrossDomainDispatcher(registry);
+ *
+ * // Auto-detect which domain handles the input
+ * const result = await dispatcher.detect('select name from users', 'en');
+ * // → { domain: 'sql', node: ..., confidence: 0.95, dsl: ... }
+ *
+ * // Parse multi-line input across domains
+ * const composite = await dispatcher.parseComposite(`
+ *   select name from users
+ *   given page http://localhost
+ * `, 'en');
+ * ```
+ */
+import type { SemanticNode } from '../core/types';
+import type { MultilingualDSL, CompileResult, ValidationResult } from './create-dsl';
+import { DomainRegistry } from './domain-registry';
+/** Result of domain auto-detection */
+export interface DispatchResult {
+    /** The domain that matched */
+    readonly domain: string;
+    /** Parsed semantic node */
+    readonly node: SemanticNode;
+    /** Confidence score (0-1) */
+    readonly confidence: number;
+    /** The DSL instance that parsed it */
+    readonly dsl: MultilingualDSL;
+}
+/** A single statement in a composite parse result */
+export interface CompositeStatement {
+    readonly line: number;
+    readonly input: string;
+    readonly domain: string;
+    readonly node: SemanticNode;
+    readonly confidence: number;
+}
+/** An error from a composite parse */
+export interface CompositeError {
+    readonly line: number;
+    readonly input: string;
+    readonly message: string;
+}
+/** Result of multi-domain composite parsing */
+export interface CompositeParseResult {
+    /** Successfully parsed statements */
+    readonly statements: readonly CompositeStatement[];
+    /** Lines that could not be matched to any domain */
+    readonly errors: readonly CompositeError[];
+}
+/** Dispatcher configuration options */
+export interface DispatcherOptions {
+    /** Minimum confidence to accept a match (default: 0.5) */
+    readonly minConfidence?: number;
+    /** Domain priority order — earlier domains win on confidence ties */
+    readonly priority?: readonly string[];
+}
+/**
+ * Dispatcher that routes input to the correct domain by confidence scoring.
+ *
+ * Built on top of DomainRegistry — uses registered domains' DSL instances
+ * to try parsing input and picks the highest-confidence match.
+ */
+export declare class CrossDomainDispatcher {
+    private registry;
+    private minConfidence;
+    private priority;
+    constructor(registry: DomainRegistry, options?: DispatcherOptions);
+    /**
+     * Auto-detect which domain handles the input.
+     * Tries all registered domains and returns the highest-confidence match.
+     * Returns null if no domain matches above minConfidence.
+     */
+    detect(input: string, language?: string): Promise<DispatchResult | null>;
+    /**
+     * Parse multi-line input where each line may belong to a different domain.
+     * Empty lines and comment lines (starting with //, --, or #) are skipped.
+     */
+    parseComposite(input: string, language?: string): Promise<CompositeParseResult>;
+    /**
+     * Compile input using auto-detected domain.
+     * Returns the compilation result with the domain name.
+     */
+    compile(input: string, language?: string): Promise<(CompileResult & {
+        domain: string;
+    }) | null>;
+    /**
+     * Validate input against all domains, returning the best match.
+     */
+    validate(input: string, language?: string): Promise<ValidationResult & {
+        domain?: string;
+    }>;
+    private getPriorityIndex;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/api/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/api/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMnD,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAED,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACnD,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAiBD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAoB;gBAExB,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAMjE;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA+B5E;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgCnF;;;OAGG;IACG,OAAO,CACX,KAAK,EAAE,MAAM,EACb,QAAQ,SAAO,GACd,OAAO,CAAC,CAAC,aAAa,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAQvD;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,OAAO,CAAC,gBAAgB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAc/F,OAAO,CAAC,gBAAgB;CAIzB"}