@lokascript/semantic 1.3.0 → 2.0.0

package/dist/__test-utils__/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Type-safe test utilities for semantic package
+ * Central export for semantic test helper functions and types
+ */
+export * from './test-helpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/__test-utils__/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,gBAAgB,CAAC"}

package/dist/__test-utils__/test-helpers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Semantic Test Helpers
+ *
+ * Placeholder module for semantic package test utilities.
+ */
+export { parse, canParse, render, renderExplicit, translate } from '../parser/semantic-parser';
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/__test-utils__/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/__test-utils__/test-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/__types__/test-helpers.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Type-safe test helpers for semantic parsing
+ * Provides properly typed interfaces for test assertions on semantic nodes
+ */
+import type { SemanticRole } from '../types';
+/**
+ * Semantic node result for testing
+ */
+export interface SemanticNodeResult {
+    action: string;
+    roles: Map<SemanticRole, SemanticValue>;
+    confidence: number;
+    errors?: ValidationError[];
+    tokens?: unknown[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Semantic value in role maps
+ */
+export interface SemanticValue {
+    value: unknown;
+    type?: string;
+    raw?: string;
+    [key: string]: unknown;
+}
+/**
+ * Validation error from semantic parsing
+ */
+export interface ValidationError {
+    message: string;
+    code?: string;
+    position?: number;
+    [key: string]: unknown;
+}
+/**
+ * Type-safe role accessor for semantic nodes
+ */
+export interface RoleAccessor<T extends string = SemanticRole> {
+    get(role: T): SemanticValue | undefined;
+    has(role: T): boolean;
+    keys(): T[];
+    values(): SemanticValue[];
+    entries(): Array<[T, SemanticValue]>;
+}
+/**
+ * Create a type-safe role accessor from a Map
+ */
+export declare function createRoleAccessor<T extends string = SemanticRole>(roles: Map<T, SemanticValue>): RoleAccessor<T>;
+/**
+ * Type guard to check if a value is a SemanticNodeResult
+ */
+export declare function isSemanticNodeResult(value: unknown): value is SemanticNodeResult;
+/**
+ * Assert that a value is a SemanticNodeResult
+ */
+export declare function assertSemanticNodeResult(value: unknown): asserts value is SemanticNodeResult;
+/**
+ * Type-safe role value extractor
+ */
+export declare function getRoleValue<T = unknown>(node: SemanticNodeResult, role: SemanticRole): T | undefined;
+/**
+ * Assert that a role exists on a semantic node
+ */
+export declare function assertNodeHasRole(node: SemanticNodeResult, role: SemanticRole): asserts node is SemanticNodeResult & {
+    roles: Map<SemanticRole, SemanticValue>;
+};
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/__types__/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/__types__/test-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,YAAY;IAC3D,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,aAAa,GAAG,SAAS,CAAC;IACxC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;IACtB,IAAI,IAAI,CAAC,EAAE,CAAC;IACZ,MAAM,IAAI,aAAa,EAAE,CAAC;IAC1B,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,YAAY,EAChE,KAAK,EAAE,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,GAC3B,YAAY,CAAC,CAAC,CAAC,CAkBjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAWhF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAI5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EACtC,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,YAAY,GACjB,CAAC,GAAG,SAAS,CAGf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,IAAI,kBAAkB,GAAG;IAAE,KAAK,EAAE,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;CAAE,CAIlF"}

package/dist/analysis/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Semantic Static Analysis
+ *
+ * Analyzes semantic nodes for potential issues:
+ * - Conflicting actions on same trigger
+ * - Accessibility problems (hover-only interactions)
+ * - Performance concerns (high-frequency triggers)
+ * - Invalid role combinations
+ *
+ * Can be used:
+ * - Standalone: analyze(input, lang)
+ * - Dev mode: Enabled via config, auto-warns on parse
+ * - Build time: Integrate with bundlers
+ */
+import type { SemanticNode, SemanticRole } from '../types';
+export type WarningSeverity = 'error' | 'warning' | 'info';
+export type WarningCode = 'HOVER_ONLY_INTERACTION' | 'HIGH_FREQUENCY_TRIGGER' | 'MISSING_REQUIRED_ROLE' | 'INVALID_ROLE_FOR_COMMAND' | 'CONFLICTING_ACTIONS' | 'UNREACHABLE_BEHAVIOR' | 'POTENTIAL_RACE_CONDITION';
+export interface AnalysisWarning {
+    code: WarningCode;
+    severity: WarningSeverity;
+    message: string;
+    suggestion?: string;
+    location?: {
+        input: string;
+        role?: SemanticRole;
+    };
+}
+export interface AnalysisResult {
+    valid: boolean;
+    warnings: AnalysisWarning[];
+    node: SemanticNode | null;
+}
+export interface AnalysisConfig {
+    /** Enable accessibility checks (default: true) */
+    accessibility?: boolean;
+    /** Enable performance checks (default: true) */
+    performance?: boolean;
+    /** Enable schema validation (default: true) */
+    schema?: boolean;
+    /** Treat warnings as errors (default: false) */
+    strict?: boolean;
+}
+/**
+ * Check for hover-only interactions (accessibility issue).
+ */
+declare function checkAccessibility(node: SemanticNode, input: string): AnalysisWarning[];
+/**
+ * Check for high-frequency events without throttling.
+ */
+declare function checkPerformance(node: SemanticNode, input: string): AnalysisWarning[];
+/**
+ * Validate role combinations against command schema.
+ */
+declare function checkSchema(node: SemanticNode, input: string): AnalysisWarning[];
+/**
+ * Analyze multiple nodes together to detect conflicts.
+ */
+export declare function analyzeMultiple(nodes: SemanticNode[], _config?: AnalysisConfig): AnalysisWarning[];
+/**
+ * Analyze a single hyperscript input for potential issues.
+ *
+ * @param input - The hyperscript text to analyze
+ * @param lang - The language of the input (default: 'en')
+ * @param config - Analysis configuration
+ * @returns Analysis result with warnings
+ *
+ * @example
+ * ```typescript
+ * const result = analyze('on hover show .tooltip', 'en');
+ * // result.warnings[0].code === 'HOVER_ONLY_INTERACTION'
+ * ```
+ */
+export declare function analyze(input: string, lang?: string, config?: AnalysisConfig): AnalysisResult;
+/**
+ * Analyze multiple hyperscript inputs together.
+ *
+ * @param inputs - Array of hyperscript texts
+ * @param lang - The language of the inputs
+ * @param config - Analysis configuration
+ * @returns Combined analysis result
+ */
+export declare function analyzeAll(inputs: string[], lang?: string, config?: AnalysisConfig): AnalysisResult;
+/**
+ * Enable dev mode analysis.
+ * When enabled, every parse() call will run analysis and log warnings.
+ */
+export declare function enableDevMode(config?: AnalysisConfig): void;
+/**
+ * Disable dev mode analysis.
+ */
+export declare function disableDevMode(): void;
+/**
+ * Check if dev mode is enabled.
+ */
+export declare function isDevModeEnabled(): boolean;
+/**
+ * Get current dev mode config.
+ */
+export declare function getDevModeConfig(): AnalysisConfig;
+/**
+ * Run dev mode analysis if enabled.
+ * Called internally by parser when dev mode is on.
+ */
+export declare function devModeAnalyze(input: string, lang: string, node: SemanticNode | null): void;
+export { checkAccessibility, checkPerformance, checkSchema };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAQ3D,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,WAAW,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,uBAAuB,GACvB,0BAA0B,GAC1B,qBAAqB,GACrB,sBAAsB,GACtB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,YAAY,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA8BD;;GAEG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAsBhF;AAED;;GAEG;AACH,iBAAS,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CAwB9E;AAED;;GAEG;AACH,iBAAS,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE,CA2CzE;AAwBD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,cAAmB,GAC3B,eAAe,EAAE,CA4EnB;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAa,EACnB,MAAM,GAAE,cAAmB,GAC1B,cAAc,CA8ChB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,GAAE,MAAa,EACnB,MAAM,GAAE,cAAmB,GAC1B,cAAc,CA0BhB;AASD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,cAAmB,GAAG,IAAI,CAG/D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAEjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAqB3F;AAMD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC"}

package/dist/ast-builder/command-mappers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Command-specific AST Mappers
+ *
+ * Each command can have a custom mapper that knows how to convert
+ * its semantic roles to the appropriate AST structure.
+ */
+import type { CommandSemanticNode, ActionType } from '../types';
+import type { ASTBuilder, CommandNode } from './index';
+/**
+ * Result from command mapping, including the AST and any warnings.
+ */
+export interface CommandMapperResult {
+    ast: CommandNode;
+    warnings: string[];
+}
+/**
+ * Interface for command-specific AST mappers.
+ */
+export interface CommandMapper {
+    /**
+     * The action type this mapper handles.
+     */
+    readonly action: ActionType;
+    /**
+     * Convert a CommandSemanticNode to a CommandNode.
+     *
+     * @param node - The semantic command node
+     * @param builder - The AST builder (for recursive building if needed)
+     * @returns The AST command node with any warnings, or just the AST node for backward compatibility
+     */
+    toAST(node: CommandSemanticNode, builder: ASTBuilder): CommandMapperResult | CommandNode;
+}
+/**
+ * Get the command mapper for an action type.
+ *
+ * @param action - The action type
+ * @returns The mapper, or undefined if no specific mapper exists
+ */
+export declare function getCommandMapper(action: ActionType): CommandMapper | undefined;
+/**
+ * Register a custom command mapper.
+ *
+ * @param mapper - The command mapper to register
+ */
+export declare function registerCommandMapper(mapper: CommandMapper): void;
+/**
+ * Get all registered command mappers.
+ */
+export declare function getRegisteredMappers(): Map<ActionType, CommandMapper>;
+//# sourceMappingURL=command-mappers.d.ts.map

package/dist/ast-builder/command-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-mappers.d.ts","sourceRoot":"","sources":["../../src/ast-builder/command-mappers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAA+B,MAAM,UAAU,CAAC;AAE7F,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,UAAU,GAAG,mBAAmB,GAAG,WAAW,CAAC;CAC1F;AAmjCD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,UAAU,EAAE,aAAa,CAAC,CAErE"}

package/dist/ast-builder/expression-parser/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Expression Parser
+ *
+ * Internal expression parser for the semantic AST builder.
+ * Parses raw expression strings into AST nodes when semantic values
+ * cannot be directly converted.
+ *
+ * @internal
+ */
+export type { ExpressionNode, LiteralNode, TemplateLiteralNode, SelectorNode, SelectorKind, ContextReferenceNode, ContextType, IdentifierNode, PropertyAccessNode, MemberExpressionNode, PossessiveExpressionNode, BinaryExpressionNode, UnaryExpressionNode, CallExpressionNode, ArrayLiteralNode, ObjectLiteralNode, ObjectPropertyNode, TimeExpressionNode, ErrorNode, AnyExpressionNode, ExpressionParseResult, } from './types';
+export { tokenize, TokenType } from './tokenizer';
+export type { Token } from './tokenizer';
+export { ExpressionParser, parseExpression } from './parser';
+//# sourceMappingURL=index.d.ts.map

package/dist/ast-builder/expression-parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ast-builder/expression-parser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/ast-builder/expression-parser/parser.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Expression Parser
+ *
+ * Parses expression tokens into AST nodes.
+ * Uses recursive descent parsing with operator precedence.
+ */
+import type { ExpressionParseResult } from './types';
+export declare class ExpressionParser {
+    private tokens;
+    private current;
+    parse(input: string): ExpressionParseResult;
+    private peek;
+    private previous;
+    private isAtEnd;
+    private advance;
+    private check;
+    private checkValue;
+    private match;
+    private parseExpression;
+    private parseOr;
+    private parseAnd;
+    private parseEquality;
+    private parseComparison;
+    private parseAddition;
+    private parseMultiplication;
+    private parseUnary;
+    private parsePostfix;
+    private parsePrimary;
+    private parseArguments;
+    private parseArrayLiteral;
+    private parseObjectLiteral;
+    private parseTimeExpression;
+    private createLiteral;
+    private createSelector;
+    private createContextReference;
+    private createIdentifier;
+    private createPropertyAccess;
+    private createPossessiveExpression;
+    private createBinaryExpression;
+    private createUnaryExpression;
+    private createCallExpression;
+}
+/**
+ * Parse an expression string into an AST node.
+ *
+ * @param input - The expression string to parse
+ * @returns The parse result with success status and node or error
+ */
+export declare function parseExpression(input: string): ExpressionParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/ast-builder/expression-parser/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/ast-builder/expression-parser/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAeV,qBAAqB,EAGtB,MAAM,SAAS,CAAC;AAMjB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAK;IAEpB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB;IAuB3C,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,YAAY;IA4CpB,OAAO,CAAC,YAAY;IAkGpB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,kBAAkB;IAwC1B,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,oBAAoB;CAS7B;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAGpE"}

package/dist/ast-builder/expression-parser/tokenizer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Expression Tokenizer
+ *
+ * Tokenizes expression strings into tokens for parsing.
+ * Focused on expression-level constructs, not full hyperscript syntax.
+ */
+export declare enum TokenType {
+    NUMBER = "NUMBER",
+    STRING = "STRING",
+    BOOLEAN = "BOOLEAN",
+    TEMPLATE_LITERAL = "TEMPLATE_LITERAL",
+    ID_SELECTOR = "ID_SELECTOR",
+    CLASS_SELECTOR = "CLASS_SELECTOR",
+    ATTRIBUTE_SELECTOR = "ATTRIBUTE_SELECTOR",
+    QUERY_SELECTOR = "QUERY_SELECTOR",
+    CONTEXT_VAR = "CONTEXT_VAR",
+    IDENTIFIER = "IDENTIFIER",
+    OPERATOR = "OPERATOR",
+    COMPARISON = "COMPARISON",
+    LOGICAL = "LOGICAL",
+    POSSESSIVE = "POSSESSIVE",
+    LPAREN = "LPAREN",
+    RPAREN = "RPAREN",
+    LBRACKET = "LBRACKET",
+    RBRACKET = "RBRACKET",
+    LBRACE = "LBRACE",
+    RBRACE = "RBRACE",
+    COMMA = "COMMA",
+    DOT = "DOT",
+    COLON = "COLON",
+    TIME_EXPRESSION = "TIME_EXPRESSION",
+    EOF = "EOF",
+    ERROR = "ERROR"
+}
+export interface Token {
+    type: TokenType;
+    value: string;
+    start: number;
+    end: number;
+    line?: number;
+    column?: number;
+}
+export declare function tokenize(input: string): Token[];
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/ast-builder/expression-parser/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../src/ast-builder/expression-parser/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,oBAAY,SAAS;IAEnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IAGrC,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,cAAc,mBAAmB;IAGjC,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IAGzB,QAAQ,aAAa;IACrB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,UAAU,eAAe;IAGzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,KAAK,UAAU;IAGf,eAAe,oBAAoB;IACnC,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA6CD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,CAkS/C"}

package/dist/ast-builder/expression-parser/types.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Expression Parser Types
+ *
+ * Defines AST node types for expressions that can be shared between
+ * the semantic package (AST building) and core package (runtime).
+ *
+ * These types are intentionally minimal and focused on expressions only.
+ */
+/**
+ * Base interface for all expression AST nodes
+ */
+export interface ExpressionNode {
+    readonly type: string;
+    readonly start?: number | undefined;
+    readonly end?: number | undefined;
+    readonly line?: number | undefined;
+    readonly column?: number | undefined;
+}
+export interface LiteralNode extends ExpressionNode {
+    readonly type: 'literal';
+    readonly value: string | number | boolean | null | undefined;
+    readonly raw?: string | undefined;
+    readonly dataType?: 'string' | 'number' | 'boolean' | 'null' | 'undefined' | 'duration' | undefined;
+}
+export interface TemplateLiteralNode extends ExpressionNode {
+    readonly type: 'templateLiteral';
+    readonly value: string;
+}
+export type SelectorKind = 'id' | 'class' | 'attribute' | 'element' | 'query' | 'complex';
+export interface SelectorNode extends ExpressionNode {
+    readonly type: 'selector' | 'cssSelector' | 'idRef' | 'classRef';
+    readonly value?: string;
+    readonly selector?: string;
+    readonly selectorType?: SelectorKind;
+}
+export type ContextType = 'me' | 'you' | 'it' | 'its' | 'my' | 'your' | 'result' | 'event' | 'target' | 'body' | 'detail';
+export interface ContextReferenceNode extends ExpressionNode {
+    readonly type: 'contextReference' | 'symbol';
+    readonly contextType?: ContextType;
+    readonly name?: string;
+}
+export interface IdentifierNode extends ExpressionNode {
+    readonly type: 'identifier';
+    readonly name: string;
+    readonly scope?: 'local' | 'global' | 'element';
+}
+export interface PropertyAccessNode extends ExpressionNode {
+    readonly type: 'propertyAccess';
+    readonly object: ExpressionNode;
+    readonly property: string;
+}
+export interface MemberExpressionNode extends ExpressionNode {
+    readonly type: 'memberExpression';
+    readonly object: ExpressionNode;
+    readonly property: ExpressionNode;
+    readonly computed?: boolean;
+}
+export interface PossessiveExpressionNode extends ExpressionNode {
+    readonly type: 'possessiveExpression';
+    readonly object: ExpressionNode;
+    readonly property: ExpressionNode | string;
+}
+export interface BinaryExpressionNode extends ExpressionNode {
+    readonly type: 'binaryExpression';
+    readonly operator: string;
+    readonly left: ExpressionNode;
+    readonly right: ExpressionNode;
+}
+export interface UnaryExpressionNode extends ExpressionNode {
+    readonly type: 'unaryExpression';
+    readonly operator: string;
+    readonly operand: ExpressionNode;
+    readonly prefix?: boolean;
+}
+export interface CallExpressionNode extends ExpressionNode {
+    readonly type: 'callExpression' | 'functionCall';
+    readonly callee: ExpressionNode | string;
+    readonly arguments: ExpressionNode[];
+}
+export interface ArrayLiteralNode extends ExpressionNode {
+    readonly type: 'arrayLiteral';
+    readonly elements: ExpressionNode[];
+}
+export interface ObjectLiteralNode extends ExpressionNode {
+    readonly type: 'objectLiteral';
+    readonly properties: ObjectPropertyNode[];
+}
+export interface ObjectPropertyNode extends ExpressionNode {
+    readonly type: 'objectProperty';
+    readonly key: string | ExpressionNode;
+    readonly value: ExpressionNode;
+    readonly computed?: boolean;
+}
+export interface TimeExpressionNode extends ExpressionNode {
+    readonly type: 'timeExpression';
+    readonly value: number;
+    readonly unit: 'ms' | 's' | 'seconds' | 'milliseconds' | 'minutes' | 'hours';
+    readonly raw?: string | undefined;
+}
+export interface ErrorNode extends ExpressionNode {
+    readonly type: 'error';
+    readonly message?: string;
+}
+export type AnyExpressionNode = LiteralNode | TemplateLiteralNode | SelectorNode | ContextReferenceNode | IdentifierNode | PropertyAccessNode | MemberExpressionNode | PossessiveExpressionNode | BinaryExpressionNode | UnaryExpressionNode | CallExpressionNode | ArrayLiteralNode | ObjectLiteralNode | TimeExpressionNode | ErrorNode;
+export interface ExpressionParseResult {
+    readonly success: boolean;
+    readonly node?: ExpressionNode;
+    readonly error?: string;
+    readonly consumed?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ast-builder/expression-parser/types.d.ts.map

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