@lokascript/semantic 1.2.1 → 2.0.0

package/dist/types/unified-profile.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Unified Language Profile
+ *
+ * Combines parsing-focused features (from semantic) with generation-focused
+ * features (from i18n) into a single profile structure.
+ *
+ * This enables:
+ * - Single source of truth for language configuration
+ * - Bidirectional conversion: parse (natural → semantic) and render (semantic → natural)
+ * - Consistent language support across packages
+ */
+import type { SemanticRole, WordOrder, AdpositionType, MorphologyType, GrammaticalMarker } from './grammar-types';
+/**
+ * How grammatical relationships are marked (unified from both packages).
+ *
+ * Maps to i18n's AdpositionType:
+ * - preposition → 'preposition'
+ * - postposition → 'postposition'
+ * - particle → 'postposition' (particles are typically postpositional)
+ * - case-suffix → 'postposition' (suffixes attach after)
+ */
+export type MarkingStrategy = 'preposition' | 'postposition' | 'particle' | 'case-suffix';
+/**
+ * A grammatical marker for a semantic role.
+ * Unified from both packages' marker types.
+ */
+export interface UnifiedRoleMarker {
+    /** Primary marker form */
+    readonly primary: string;
+    /** Alternative forms (conjugations, vowel harmony variants) */
+    readonly alternatives?: string[];
+    /** Position relative to the role value */
+    readonly position: 'before' | 'after';
+    /** Whether this marker is required */
+    readonly required?: boolean;
+}
+/**
+ * Verb form configuration for a language.
+ */
+export interface VerbConfig {
+    /** Position of verb in the sentence */
+    readonly position: 'start' | 'end' | 'second';
+    /** Common verb suffixes/conjugations to recognize */
+    readonly suffixes?: string[];
+    /** Whether the language commonly drops subjects */
+    readonly subjectDrop?: boolean;
+}
+/**
+ * Translation of a command keyword.
+ */
+export interface KeywordTranslation {
+    /** Primary translation */
+    readonly primary: string;
+    /** Alternative forms (conjugations, synonyms) */
+    readonly alternatives?: string[];
+    /** Normalized form for matching */
+    readonly normalized?: string;
+}
+/**
+ * Special tokenization configuration.
+ */
+export interface TokenizationConfig {
+    /** Particles to recognize (for particle languages) */
+    readonly particles?: string[];
+    /** Prefixes to recognize (for prefixing languages) */
+    readonly prefixes?: string[];
+    /** Word boundary detection strategy */
+    readonly boundaryStrategy?: 'space' | 'particle' | 'character';
+}
+/**
+ * Unified Language Profile
+ *
+ * Combines all fields needed for both parsing and generation:
+ *
+ * **Shared fields:**
+ * - code, name, nativeName, direction, wordOrder
+ *
+ * **Parsing fields (from semantic):**
+ * - keywords: Command keyword translations
+ * - verb: Verb position and conjugation info
+ * - tokenization: Language-specific tokenization
+ * - usesSpaces: Word boundary info
+ *
+ * **Generation fields (from i18n):**
+ * - morphology: Morphological type for transformation
+ * - canonicalOrder: Role ordering for output
+ * - markers: Grammatical markers for roles
+ */
+export interface UnifiedLanguageProfile {
+    /** ISO 639-1 language code */
+    readonly code: string;
+    /** Human-readable language name */
+    readonly name: string;
+    /** Native language name */
+    readonly nativeName: string;
+    /** Text direction */
+    readonly direction: 'ltr' | 'rtl';
+    /** Primary word order (SVO, SOV, VSO, etc.) */
+    readonly wordOrder: WordOrder;
+    /** How grammatical roles are marked */
+    readonly markingStrategy: MarkingStrategy;
+    /** Morphological typology */
+    readonly morphology: MorphologyType;
+    /** Whether the language uses spaces between words */
+    readonly usesSpaces: boolean;
+    /** Markers for each semantic role */
+    readonly roleMarkers: Partial<Record<SemanticRole, UnifiedRoleMarker>>;
+    /** Canonical role order for generation */
+    readonly canonicalOrder: SemanticRole[];
+    /** Verb configuration */
+    readonly verb: VerbConfig;
+    /** Command keyword translations */
+    readonly keywords: Record<string, KeywordTranslation>;
+    /** Special tokenization configuration */
+    readonly tokenization?: TokenizationConfig;
+    /** Special transformation rules */
+    readonly rules?: GrammarRule[];
+}
+/**
+ * Grammar rule for special transformations.
+ * (Imported from i18n for consistency)
+ */
+export interface GrammarRule {
+    name: string;
+    description: string;
+    match: PatternMatcher;
+    transform: PatternTransform;
+    priority: number;
+}
+export interface PatternMatcher {
+    commands?: string[];
+    requiredRoles: SemanticRole[];
+    optionalRoles?: SemanticRole[];
+    predicate?: (parsed: unknown) => boolean;
+}
+export interface PatternTransform {
+    roleOrder: SemanticRole[];
+    insertMarkers?: boolean;
+    custom?: (parsed: unknown, profile: UnifiedLanguageProfile) => string;
+}
+/**
+ * Convert marking strategy to AdpositionType for i18n compatibility.
+ */
+export declare function markingStrategyToAdpositionType(strategy: MarkingStrategy): AdpositionType;
+/**
+ * Convert UnifiedRoleMarker to GrammaticalMarker for i18n compatibility.
+ */
+export declare function toGrammaticalMarker(role: SemanticRole, marker: UnifiedRoleMarker, strategy: MarkingStrategy): GrammaticalMarker;
+/**
+ * Convert UnifiedLanguageProfile to i18n LanguageProfile.
+ * This enables using unified profiles with existing i18n code.
+ */
+export declare function toI18nProfile(unified: UnifiedLanguageProfile): {
+    code: string;
+    name: string;
+    wordOrder: WordOrder;
+    adpositionType: AdpositionType;
+    morphology: MorphologyType;
+    direction: 'ltr' | 'rtl';
+    markers: GrammaticalMarker[];
+    canonicalOrder: SemanticRole[];
+};
+/**
+ * Check if an object is a UnifiedLanguageProfile.
+ */
+export declare function isUnifiedProfile(obj: unknown): obj is UnifiedLanguageProfile;
+//# sourceMappingURL=unified-profile.d.ts.map

package/dist/types/unified-profile.d.ts.map

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

package/dist/types.d.ts

@@ -0,0 +1,401 @@
+/**
+ * Semantic-First Multilingual Hyperscript Types
+ *
+ * This module defines the canonical semantic representation that all languages
+ * parse to and render from. The semantic layer is language-neutral - it captures
+ * the MEANING of hyperscript commands independent of surface syntax.
+ */
+export type { SemanticRole, WordOrder, AdpositionType, MorphologyType, GrammaticalMarker, LanguageProfile, } from './types/grammar-types';
+import type { SemanticRole } from './types/grammar-types';
+/**
+ * Canonical action names (English-based internally, but not visible to users)
+ * These map to hyperscript commands and are used in the semantic AST.
+ */
+export type ActionType = 'toggle' | 'add' | 'remove' | 'put' | 'append' | 'prepend' | 'take' | 'make' | 'clone' | 'swap' | 'morph' | 'set' | 'get' | 'increment' | 'decrement' | 'log' | 'copy' | 'pick' | 'beep' | 'show' | 'hide' | 'transition' | 'on' | 'trigger' | 'send' | 'focus' | 'blur' | 'go' | 'wait' | 'fetch' | 'settle' | 'measure' | 'install' | 'if' | 'unless' | 'else' | 'repeat' | 'for' | 'while' | 'continue' | 'break' | 'exit' | 'halt' | 'throw' | 'call' | 'return' | 'render' | 'js' | 'async' | 'tell' | 'default' | 'init' | 'behavior' | 'compound';
+/**
+ * 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;
+/**
+ * Expected value types for role tokens.
+ * Shared between RoleSpec (command-schemas) and RolePatternToken.
+ */
+export type ExpectedType = SemanticValue['type'];
+export interface LiteralValue {
+    readonly type: 'literal';
+    readonly value: string | number | boolean;
+    readonly dataType?: 'string' | 'number' | 'boolean' | 'duration';
+}
+export interface SelectorValue {
+    readonly type: 'selector';
+    readonly value: string;
+    readonly selectorKind: 'id' | 'class' | 'attribute' | 'element' | 'complex';
+}
+export interface ReferenceValue {
+    readonly type: 'reference';
+    readonly value: 'me' | 'you' | 'it' | 'result' | 'event' | 'target' | 'body';
+}
+export interface PropertyPathValue {
+    readonly type: 'property-path';
+    readonly object: SemanticValue;
+    readonly property: string;
+}
+export interface ExpressionValue {
+    readonly type: 'expression';
+    /** Raw expression string for complex expressions that need further parsing */
+    readonly raw: string;
+}
+/**
+ * Base interface for all semantic nodes.
+ * Semantic nodes capture the MEANING of hyperscript constructs.
+ */
+export interface SemanticNode {
+    readonly kind: 'command' | 'event-handler' | 'conditional' | 'compound' | 'loop';
+    readonly action: ActionType;
+    readonly roles: ReadonlyMap<SemanticRole, SemanticValue>;
+    readonly metadata?: SemanticMetadata;
+}
+/**
+ * Metadata about the source of a semantic node.
+ * Useful for debugging, error messages, and round-trip conversion.
+ */
+export interface SemanticMetadata {
+    readonly sourceLanguage?: string;
+    readonly sourceText?: string;
+    readonly sourcePosition?: SourcePosition;
+    readonly patternId?: string;
+    /**
+     * Confidence score for the parse (0-1).
+     * Higher values indicate more certain matches.
+     * - 1.0: Exact match with all roles captured
+     * - 0.8-0.99: High confidence with minor uncertainty (stem matching, optional roles)
+     * - 0.6-0.8: Medium confidence (morphological normalization, defaults applied)
+     * - <0.6: Low confidence (may need fallback to traditional parser)
+     */
+    readonly confidence?: number;
+}
+export interface SourcePosition {
+    readonly start: number;
+    readonly end: number;
+    readonly line?: number;
+    readonly column?: number;
+}
+/**
+ * A command semantic node - represents a single hyperscript command.
+ */
+export interface CommandSemanticNode extends SemanticNode {
+    readonly kind: 'command';
+}
+/**
+ * An event handler semantic node - represents "on [event] [commands]".
+ */
+export interface EventHandlerSemanticNode extends SemanticNode {
+    readonly kind: 'event-handler';
+    readonly action: 'on';
+    readonly body: SemanticNode[];
+    readonly eventModifiers?: EventModifiers;
+    /**
+     * Additional events for multi-event handlers (e.g., "on click or keydown").
+     * The primary event is in the 'event' role; these are the additional "or" events.
+     */
+    readonly additionalEvents?: readonly SemanticValue[];
+    /**
+     * Event parameter names for destructuring.
+     * E.g., for "on click(clientX, clientY)", this would be ['clientX', 'clientY']
+     */
+    readonly parameterNames?: readonly string[];
+}
+export interface EventModifiers {
+    readonly once?: boolean;
+    readonly debounce?: number;
+    readonly throttle?: number;
+    readonly queue?: 'first' | 'last' | 'all' | 'none';
+    readonly from?: SemanticValue;
+}
+/**
+ * A conditional semantic node - represents "if [condition] then [body] else [body]".
+ */
+export interface ConditionalSemanticNode extends SemanticNode {
+    readonly kind: 'conditional';
+    readonly action: 'if';
+    readonly thenBranch: SemanticNode[];
+    readonly elseBranch?: SemanticNode[];
+}
+/**
+ * A compound semantic node - represents multiple chained statements.
+ */
+export interface CompoundSemanticNode extends SemanticNode {
+    readonly kind: 'compound';
+    readonly statements: SemanticNode[];
+    readonly chainType: 'then' | 'and' | 'async';
+}
+/**
+ * Loop variant discriminant for different loop types.
+ */
+export type LoopVariant = 'forever' | 'times' | 'for' | 'while' | 'until';
+/**
+ * A loop semantic node - represents repeat/for/while loops.
+ */
+export interface LoopSemanticNode extends SemanticNode {
+    readonly kind: 'loop';
+    readonly action: 'repeat' | 'for' | 'while';
+    /** The type of loop (forever, times, for, while, until) */
+    readonly loopVariant: LoopVariant;
+    /** Commands to execute in each iteration */
+    readonly body: SemanticNode[];
+    /** Loop variable name for 'for' loops (e.g., 'item' in 'for item in list') */
+    readonly loopVariable?: string;
+    /** Index variable name if specified (e.g., 'i' in 'for item with index i') */
+    readonly indexVariable?: string;
+}
+/**
+ * A pattern defines how a semantic structure appears in a specific language.
+ * Patterns enable bidirectional conversion: parse (natural → semantic) and
+ * render (semantic → natural).
+ */
+export interface LanguagePattern {
+    /** Unique identifier for this pattern */
+    readonly id: string;
+    /** ISO 639-1 language code */
+    readonly language: string;
+    /** Which command this pattern matches */
+    readonly command: ActionType;
+    /** Priority for disambiguation (higher = checked first) */
+    readonly priority: number;
+    /** The pattern template with role placeholders */
+    readonly template: PatternTemplate;
+    /** Rules for extracting semantic roles from matched tokens */
+    readonly extraction: ExtractionRules;
+    /** Optional constraints on when this pattern applies */
+    readonly constraints?: PatternConstraints;
+}
+/**
+ * A pattern template defines the expected token sequence.
+ *
+ * Template syntax:
+ * - Literal tokens: "toggle", "を", "على"
+ * - Role placeholders: {patient}, {target}, {destination}
+ * - Optional groups: [on {target}]
+ * - Alternatives in extraction (not in template string)
+ *
+ * Example templates:
+ * - English: "toggle {patient} [on {target}]"
+ * - Japanese: "{target} の {patient} を 切り替え"
+ * - Arabic: "بدّل {patient} [على {target}]"
+ */
+export interface PatternTemplate {
+    /** Human-readable template string */
+    readonly format: string;
+    /** Parsed token sequence for matching */
+    readonly tokens: PatternToken[];
+}
+export type PatternToken = LiteralPatternToken | RolePatternToken | GroupPatternToken;
+export interface LiteralPatternToken {
+    readonly type: 'literal';
+    readonly value: string;
+    /** Alternative spellings/forms that also match */
+    readonly alternatives?: string[];
+}
+export interface RolePatternToken {
+    readonly type: 'role';
+    readonly role: SemanticRole;
+    readonly optional?: boolean;
+    /** Expected value types (for validation) */
+    readonly expectedTypes?: Array<ExpectedType>;
+}
+export interface GroupPatternToken {
+    readonly type: 'group';
+    readonly tokens: PatternToken[];
+    readonly optional?: boolean;
+}
+/**
+ * Rules for extracting semantic values from matched tokens.
+ */
+export interface ExtractionRules {
+    readonly [role: string]: ExtractionRule;
+}
+export interface ExtractionRule {
+    /** Position-based extraction (0-indexed from pattern start) */
+    readonly position?: number;
+    /** Marker-based extraction (find value after this marker) */
+    readonly marker?: string;
+    /** Alternative markers that also work */
+    readonly markerAlternatives?: string[];
+    /** Transform the extracted value */
+    readonly transform?: (raw: string) => SemanticValue;
+    /** Default value if not found (for optional roles) */
+    readonly default?: SemanticValue;
+    /** Static value extraction (for event handler wrapped commands) */
+    readonly value?: string;
+    /** Extract value from a pattern role by name */
+    readonly fromRole?: string;
+}
+/**
+ * Additional constraints on pattern applicability.
+ */
+export interface PatternConstraints {
+    /** Required roles that must be present */
+    readonly requiredRoles?: SemanticRole[];
+    /** Roles that must NOT be present */
+    readonly forbiddenRoles?: SemanticRole[];
+    /** Valid selector types for the patient role */
+    readonly validPatientTypes?: Array<SelectorValue['selectorKind']>;
+    /** Pattern IDs this conflicts with */
+    readonly conflictsWith?: string[];
+}
+/**
+ * A token from language-specific tokenization.
+ */
+export interface LanguageToken {
+    readonly value: string;
+    readonly kind: TokenKind;
+    readonly position: SourcePosition;
+    /** Normalized form from explicit keyword map (e.g., 切り替え → toggle) */
+    readonly normalized?: string;
+    /** Morphologically normalized stem (e.g., 切り替えた → 切り替え) */
+    readonly stem?: string;
+    /** Confidence in the morphological stem (0.0-1.0) */
+    readonly stemConfidence?: number;
+    /** Additional metadata for specific token types (e.g., event modifier data) */
+    readonly metadata?: Record<string, unknown>;
+}
+export type TokenKind = 'keyword' | 'selector' | 'literal' | 'particle' | 'conjunction' | 'event-modifier' | 'identifier' | 'operator' | 'punctuation' | 'url';
+/**
+ * A stream of tokens with navigation capabilities.
+ */
+export interface TokenStream {
+    readonly tokens: readonly LanguageToken[];
+    readonly language: string;
+    /** Look at token at current position + offset without consuming */
+    peek(offset?: number): LanguageToken | null;
+    /** Consume and return current token, advance position */
+    advance(): LanguageToken;
+    /** Check if we've consumed all tokens */
+    isAtEnd(): boolean;
+    /** Save current position for backtracking */
+    mark(): StreamMark;
+    /** Restore to a saved position */
+    reset(mark: StreamMark): void;
+    /** Get current position */
+    position(): number;
+}
+export interface StreamMark {
+    readonly position: number;
+}
+/**
+ * Result of successfully matching a pattern.
+ */
+export interface PatternMatchResult {
+    readonly pattern: LanguagePattern;
+    readonly captured: ReadonlyMap<SemanticRole, SemanticValue>;
+    readonly consumedTokens: number;
+    readonly confidence: number;
+}
+/**
+ * Error when pattern matching fails.
+ */
+export interface PatternMatchError {
+    readonly message: string;
+    readonly position: SourcePosition;
+    readonly expectedPatterns?: string[];
+    readonly partialMatch?: Partial<PatternMatchResult>;
+}
+/**
+ * Language-specific tokenizer interface.
+ * Each language implements its own tokenizer to handle:
+ * - Word boundaries (spaces for English, particles for Japanese)
+ * - Character sets (ASCII, CJK, Arabic, etc.)
+ * - Special markers (particles, prefixes, suffixes)
+ */
+export interface LanguageTokenizer {
+    readonly language: string;
+    readonly direction: 'ltr' | 'rtl';
+    /** Convert input string to token stream */
+    tokenize(input: string): TokenStream;
+    /** Classify a single token */
+    classifyToken(token: string): TokenKind;
+}
+/**
+ * Main parser interface - converts natural language to semantic nodes.
+ */
+export interface SemanticParser {
+    /** Parse input in specified language to semantic node */
+    parse(input: string, language: string): SemanticNode;
+    /** Check if input can be parsed in the specified language */
+    canParse(input: string, language: string): boolean;
+    /** Get all supported languages */
+    supportedLanguages(): string[];
+}
+/**
+ * Renderer interface - converts semantic nodes to natural language.
+ */
+export interface SemanticRenderer {
+    /** Render semantic node in specified language */
+    render(node: SemanticNode, language: string): string;
+    /** Render semantic node in explicit mode */
+    renderExplicit(node: SemanticNode): string;
+    /** Get all supported languages */
+    supportedLanguages(): string[];
+}
+/**
+ * Create a selector semantic value from a CSS selector string.
+ */
+export declare function createSelector(value: string): SelectorValue;
+/**
+ * Create a literal semantic value.
+ */
+export declare function createLiteral(value: string | number | boolean, dataType?: LiteralValue['dataType']): LiteralValue;
+export declare function isValidReference(value: string): value is ReferenceValue['value'];
+/**
+ * Create a reference semantic value.
+ */
+export declare function createReference(value: ReferenceValue['value']): ReferenceValue;
+/**
+ * Create a property path semantic value.
+ */
+export declare function createPropertyPath(object: SemanticValue, property: string): PropertyPathValue;
+/**
+ * Create a semantic node with the given action and roles.
+ */
+export declare function createCommandNode(action: ActionType, roles: Record<string, SemanticValue>, metadata?: SemanticMetadata): CommandSemanticNode;
+/**
+ * Create an event handler semantic node.
+ */
+export declare function createEventHandler(event: SemanticValue, body: SemanticNode[], modifiers?: EventModifiers, metadata?: SemanticMetadata, parameterNames?: string[], additionalEvents?: SemanticValue[]): EventHandlerSemanticNode;
+/**
+ * Create a compound semantic node (for chained statements).
+ */
+export declare function createCompoundNode(statements: SemanticNode[], chainType?: 'then' | 'and' | 'async', metadata?: SemanticMetadata): CompoundSemanticNode;
+/**
+ * Create a conditional semantic node (if/else).
+ */
+export declare function createConditionalNode(condition: SemanticValue, thenBranch: SemanticNode[], elseBranch?: SemanticNode[], metadata?: SemanticMetadata): ConditionalSemanticNode;
+/**
+ * Create a loop semantic node.
+ */
+export declare function createLoopNode(action: 'repeat' | 'for' | 'while', loopVariant: LoopVariant, roles: Record<string, SemanticValue>, body: SemanticNode[], options?: {
+    loopVariable?: string;
+    indexVariable?: string;
+    metadata?: SemanticMetadata;
+}): LoopSemanticNode;
+/**
+ * Argument with semantic role attached.
+ */
+export type SemanticArgument = SemanticValue & {
+    role?: SemanticRole;
+};
+/**
+ * Result of semantic parsing (used by command validator).
+ */
+export interface SemanticParseResult {
+    /** The action/command type */
+    readonly action: ActionType;
+    /** Confidence score (0-1) */
+    readonly confidence: number;
+    /** Source language code */
+    readonly language: string;
+    /** Parsed arguments with roles */
+    readonly arguments: SemanticArgument[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,YAAY,EACZ,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAElB,QAAQ,GACR,KAAK,GACL,QAAQ,GAER,KAAK,GACL,QAAQ,GACR,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GAEP,KAAK,GACL,KAAK,GACL,WAAW,GACX,WAAW,GACX,KAAK,GACL,MAAM,GACN,MAAM,GACN,MAAM,GAEN,MAAM,GACN,MAAM,GACN,YAAY,GAEZ,IAAI,GACJ,SAAS,GACT,MAAM,GAEN,OAAO,GACP,MAAM,GAEN,IAAI,GAEJ,MAAM,GACN,OAAO,GACP,QAAQ,GAER,SAAS,GAET,SAAS,GAET,IAAI,GACJ,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,KAAK,GACL,OAAO,GACP,UAAU,GACV,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GAER,QAAQ,GAER,IAAI,GACJ,OAAO,GACP,MAAM,GACN,SAAS,GACT,MAAM,GACN,UAAU,GAEV,UAAU,CAAC;AAMf;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;CAC7E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC9E;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;IACjF,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,OAAO,GACP,KAAK,GACL,OAAO,GACP,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IAC5C,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAE7B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEnC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAErC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEtF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;IACpD,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IACzC,gDAAgD;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAClE,sCAAsC;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,aAAa,GACb,gBAAgB,GAChB,YAAY,GACZ,UAAU,GACV,aAAa,GACb,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,mEAAmE;IACnE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAC;IAE5C,yDAAyD;IACzD,OAAO,IAAI,aAAa,CAAC;IAEzB,yCAAyC;IACzC,OAAO,IAAI,OAAO,CAAC;IAEnB,6CAA6C;IAC7C,IAAI,IAAI,UAAU,CAAC;IAEnB,kCAAkC;IAClC,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAE9B,2BAA2B;IAC3B,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACrD;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAElC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;IAErC,8BAA8B;IAC9B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAErD,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAEnD,kCAAkC;IAClC,kBAAkB,IAAI,MAAM,EAAE,CAAC;CAChC;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAErD,4CAA4C;IAC5C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAE3C,kCAAkC;IAClC,kBAAkB,IAAI,MAAM,EAAE,CAAC;CAChC;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAc3D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAChC,QAAQ,CAAC,EAAE,YAAY,CAAC,UAAU,CAAC,GAClC,YAAY,CAMd;AAeD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAAC,OAAO,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,cAAc,CAE9E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAE7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,mBAAmB,CAUrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,YAAY,EAAE,EACpB,SAAS,CAAC,EAAE,cAAc,EAC1B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,EACzB,gBAAgB,CAAC,EAAE,aAAa,EAAE,GACjC,wBAAwB,CAyB1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,YAAY,EAAE,EAC1B,SAAS,GAAE,MAAM,GAAG,KAAK,GAAG,OAAgB,EAC5C,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,oBAAoB,CAYtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,YAAY,EAAE,EAC1B,UAAU,CAAC,EAAE,YAAY,EAAE,EAC3B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,uBAAuB,CAiBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,EAClC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,IAAI,EAAE,YAAY,EAAE,EACpB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B,GACA,gBAAgB,CAoBlB;AAMD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CACxC"}

package/dist/utils/confidence-calculator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Confidence Calculator Utility
+ *
+ * Provides standalone confidence calculation for translations.
+ * Exposes the pattern matcher's confidence scoring for use in scripts.
+ */
+import type { SemanticNode, ActionType } from '../types';
+export interface ConfidenceResult {
+    /** Confidence score from 0-1 */
+    confidence: number;
+    /** Whether the input parsed successfully */
+    parseSuccess: boolean;
+    /** Pattern ID that matched, if any */
+    patternId?: string;
+    /** The action type (command) that was parsed */
+    action?: ActionType;
+    /** Number of tokens consumed during matching */
+    tokensConsumed?: number;
+    /** Error message if parsing failed */
+    error?: string;
+}
+/**
+ * Calculate confidence score for a hyperscript translation.
+ *
+ * Uses the pattern matcher to determine how well the input matches
+ * available patterns for the given language.
+ *
+ * @param hyperscript - The hyperscript code to analyze
+ * @param language - The language code (e.g., 'ja', 'es', 'en')
+ * @returns Confidence result with score and match details
+ */
+export declare function calculateTranslationConfidence(hyperscript: string, language: string): ConfidenceResult;
+export interface ParseWithConfidenceResult {
+    node: SemanticNode | null;
+    confidence: number;
+    error: string | undefined;
+}
+/**
+ * Calculate confidence and parse to a semantic node in one call.
+ * Returns both the parsed node and the confidence score.
+ */
+export declare function parseWithConfidence(hyperscript: string, language: string): ParseWithConfidenceResult;
+//# sourceMappingURL=confidence-calculator.d.ts.map

package/dist/utils/confidence-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence-calculator.d.ts","sourceRoot":"","sources":["../../src/utils/confidence-calculator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,gBAAgB,CA8DlB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,yBAAyB,CA6B3B"}