@hyperfixi/types-browser 2.0.0

package/dist/semantic-api.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Type definitions for HyperFixi Semantic browser API
+ */
+export type SupportedLanguage = 'en' | 'ja' | 'ar' | 'es' | 'ko' | 'tr' | 'zh' | 'pt' | 'fr' | 'de' | 'id' | 'qu' | 'sw';
+/**
+ * HyperFixi semantic parser API exposed on window.HyperFixiSemantic
+ */
+export interface LokaScriptSemanticAPI {
+    /**
+     * Parse hyperscript in any supported language to semantic representation
+     *
+     * @param code Hyperscript code to parse
+     * @param language Two-letter language code (en, ja, ar, es, ko, tr, zh, pt, fr, de, id, qu, sw)
+     * @returns Parsed semantic node or null
+     */
+    parse(code: string, language: SupportedLanguage): SemanticNode | null;
+    /**
+     * Check if hyperscript can be parsed in a language
+     */
+    canParse(code: string, language: SupportedLanguage): boolean;
+    /**
+     * Parse in any supported language (auto-detect)
+     */
+    parseAny(code: string): SemanticNode | null;
+    /**
+     * Parse explicit syntax
+     */
+    parseExplicit(code: string): any | null;
+    /**
+     * Check if code uses explicit syntax
+     */
+    isExplicitSyntax(code: string): boolean;
+    /**
+     * Translate hyperscript between languages
+     */
+    translate(code: string, fromLanguage: SupportedLanguage, toLanguage: SupportedLanguage): string | null;
+    /**
+     * Get all translations of hyperscript in supported languages
+     */
+    getAllTranslations(code: string, fromLanguage: SupportedLanguage): Record<SupportedLanguage, string>;
+    /**
+     * Round-trip translation validation
+     */
+    roundTrip(code: string, language: SupportedLanguage): boolean;
+    /**
+     * Validate translation accuracy
+     */
+    validateTranslation(original: string, translated: string, fromLang: SupportedLanguage, toLang: SupportedLanguage): boolean;
+    /**
+     * Render semantic node to hyperscript
+     */
+    render(node: SemanticNode, language: SupportedLanguage): string;
+    /**
+     * Render to explicit syntax
+     */
+    renderExplicit(node: SemanticNode): string;
+    /**
+     * Convert to explicit syntax
+     */
+    toExplicit(code: string, language: SupportedLanguage): string | null;
+    /**
+     * Convert from explicit syntax
+     */
+    fromExplicit(code: string, language: SupportedLanguage): string | null;
+    /**
+     * Create semantic analyzer
+     */
+    createSemanticAnalyzer(options?: any): any;
+    /**
+     * Check if semantic result should be used
+     */
+    shouldUseSemanticResult(semanticNode: SemanticNode | null, fallbackNode: any): boolean;
+    /**
+     * Build AST from semantic node
+     */
+    buildAST(node: SemanticNode): any;
+    /**
+     * Tokenize code in a specific language
+     */
+    tokenize(code: string, language: SupportedLanguage): any[];
+    /**
+     * Get tokenizer for a language
+     */
+    getTokenizer(language: SupportedLanguage): any;
+    /**
+     * Check if language is supported
+     */
+    isLanguageSupported(language: string): boolean;
+    /**
+     * Get list of supported language codes
+     */
+    getSupportedLanguages(): SupportedLanguage[];
+    /**
+     * Create CSS selector helper
+     */
+    createSelector(value: string): any;
+    /**
+     * Create literal value helper
+     */
+    createLiteral(value: any): any;
+    /**
+     * Create reference helper
+     */
+    createReference(name: string): any;
+    /**
+     * Create property path helper
+     */
+    createPropertyPath(path: string[]): any;
+    /**
+     * Create command node helper
+     */
+    createCommandNode(command: string, options?: any): any;
+    /**
+     * Create event handler helper
+     */
+    createEventHandler(event: string, options?: any): any;
+    /**
+     * Get command mapper
+     */
+    getCommandMapper(command: string): any;
+    /**
+     * Register command mapper
+     */
+    registerCommandMapper(command: string, mapper: any): void;
+    /**
+     * Package version
+     */
+    VERSION: string;
+    /**
+     * Default confidence threshold
+     */
+    DEFAULT_CONFIDENCE_THRESHOLD: number;
+    /**
+     * High confidence threshold
+     */
+    HIGH_CONFIDENCE_THRESHOLD: number;
+    /**
+     * Language-specific tokenizers
+     */
+    englishTokenizer: any;
+    japaneseTokenizer: any;
+    koreanTokenizer: any;
+    arabicTokenizer: any;
+    spanishTokenizer: any;
+    turkishTokenizer: any;
+    chineseTokenizer: any;
+    portugueseTokenizer: any;
+    frenchTokenizer: any;
+    germanTokenizer: any;
+    indonesianTokenizer: any;
+    quechuaTokenizer: any;
+    swahiliTokenizer: any;
+    /**
+     * Semantic analyzer implementation
+     */
+    SemanticAnalyzerImpl: any;
+    /**
+     * AST Builder class
+     */
+    ASTBuilder: any;
+}
+export interface SemanticNode {
+    action: string;
+    roles: Map<string, SemanticValue>;
+    confidence: number;
+    errors?: ValidationError[];
+    tokens?: any[];
+    [key: string]: any;
+}
+export interface SemanticValue {
+    value: any;
+    type?: string;
+    [key: string]: any;
+}
+export interface ValidationError {
+    message: string;
+    code?: string;
+    [key: string]: any;
+}
+//# sourceMappingURL=semantic-api.d.ts.map

package/dist/semantic-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-api.d.ts","sourceRoot":"","sources":["../src/semantic-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAC;AAET;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,YAAY,GAAG,IAAI,CAAC;IAEtE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAE7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC;IAExC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAExC;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,iBAAiB,EAC/B,UAAU,EAAE,iBAAiB,GAC5B,MAAM,GAAG,IAAI,CAAC;IAEjB;;OAEG;IACH,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,iBAAiB,GAC9B,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAErC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAE9D;;OAEG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAEX;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAEhE;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAAC;IAErE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAAC;IAEvE;;OAEG;IACH,sBAAsB,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAE3C;;OAEG;IACH,uBAAuB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,EAAE,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC;IAEvF;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAAC;IAElC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,GAAG,EAAE,CAAC;IAE3D;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,GAAG,CAAC;IAE/C;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAE/C;;OAEG;IACH,qBAAqB,IAAI,iBAAiB,EAAE,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnC;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IAEnC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAExC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAEvD;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAEtD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC;IAEvC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,4BAA4B,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,yBAAyB,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC;IACtB,iBAAiB,EAAE,GAAG,CAAC;IACvB,eAAe,EAAE,GAAG,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC;IACrB,gBAAgB,EAAE,GAAG,CAAC;IACtB,gBAAgB,EAAE,GAAG,CAAC;IACtB,gBAAgB,EAAE,GAAG,CAAC;IACtB,mBAAmB,EAAE,GAAG,CAAC;IACzB,eAAe,EAAE,GAAG,CAAC;IACrB,eAAe,EAAE,GAAG,CAAC;IACrB,mBAAmB,EAAE,GAAG,CAAC;IACzB,gBAAgB,EAAE,GAAG,CAAC;IACtB,gBAAgB,EAAE,GAAG,CAAC;IAEtB;;OAEG;IACH,oBAAoB,EAAE,GAAG,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,GAAG,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB"}

package/dist/type-guards.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type guards for browser globals
+ */
+import type { LokaScriptCoreAPI } from './core-api';
+import type { LokaScriptSemanticAPI } from './semantic-api';
+import type { LokaScriptI18nAPI } from './i18n-api';
+/**
+ * Check if window.hyperfixi is available and properly typed
+ */
+export declare function isHyperFixiCoreAvailable(obj?: any): obj is LokaScriptCoreAPI;
+/**
+ * Check if window.HyperFixiSemantic is available
+ */
+export declare function isHyperFixiSemanticAvailable(obj?: any): obj is LokaScriptSemanticAPI;
+/**
+ * Check if window.HyperFixiI18n is available
+ */
+export declare function isHyperFixiI18nAvailable(obj?: any): obj is LokaScriptI18nAPI;
+/**
+ * Safe access to window.hyperfixi with type checking
+ */
+export declare function getHyperFixiCore(): LokaScriptCoreAPI | null;
+/**
+ * Safe access to window.LokaScriptSemantic with type checking
+ */
+export declare function getHyperFixiSemantic(): LokaScriptSemanticAPI | null;
+/**
+ * Safe access to window.LokaScriptI18n with type checking
+ */
+export declare function getHyperFixiI18n(): LokaScriptI18nAPI | null;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,iBAAiB,CAO5E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,qBAAqB,CAOpF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,iBAAiB,CAO5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAK3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAK3D"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@hyperfixi/types-browser",
+  "version": "2.0.0",
+  "description": "TypeScript type definitions for LokaScript browser globals",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "hyperfixi",
+    "types",
+    "typescript",
+    "browser",
+    "globals"
+  ],
+  "author": "LokaScript Contributors",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codetalcott/hyperfixi.git",
+    "directory": "packages/types-browser"
+  },
+  "bugs": {
+    "url": "https://github.com/codetalcott/hyperfixi/issues"
+  },
+  "homepage": "https://github.com/codetalcott/hyperfixi/tree/main/packages/types-browser#readme"
+}

package/src/core-api.d.ts

@@ -0,0 +1,280 @@
+/**
+ * Type definitions for @hyperfixi/core browser global (window.hyperfixi)
+ */
+
+export interface LokaScriptCoreAPI {
+  // ==================== API v2 (Recommended) ====================
+
+  /**
+   * Synchronously compile hyperscript code to AST.
+   * Use this for English-only code that needs synchronous compilation.
+   *
+   * @example
+   * ```typescript
+   * const result = hyperfixi.compileSync('toggle .active');
+   * if (result.ok) {
+   *   console.log('Parser used:', result.meta.parser);
+   *   await hyperfixi.execute(result.ast, element);
+   * }
+   * ```
+   *
+   * @since API v2
+   */
+  compileSync(source: string, options?: NewCompileOptions): CompileResult;
+
+  /**
+   * Asynchronously compile hyperscript code (handles all 13 languages).
+   * Use this for multilingual support or when async compilation is acceptable.
+   *
+   * @example
+   * ```typescript
+   * // English
+   * const result = await hyperfixi.compile('toggle .active');
+   *
+   * // Japanese
+   * const result = await hyperfixi.compile('トグル .active', { language: 'ja' });
+   * ```
+   *
+   * @since API v2
+   */
+  compile(source: string, options?: NewCompileOptions): Promise<CompileResult>;
+
+  /**
+   * Compile and execute hyperscript in one step.
+   *
+   * @example
+   * ```typescript
+   * // With context
+   * const ctx = hyperfixi.createContext(element);
+   * await hyperfixi.eval('toggle .active', ctx);
+   *
+   * // With element directly
+   * await hyperfixi.eval('toggle .active', element);
+   * ```
+   *
+   * @since API v2
+   */
+  eval(source: string, contextOrElement?: ExecutionContext | Element): Promise<any>;
+
+  /**
+   * Validate hyperscript syntax and return detailed errors.
+   *
+   * @example
+   * ```typescript
+   * const result = await hyperfixi.validate('toggle .active');
+   * if (result.valid) {
+   *   console.log('Valid syntax');
+   * } else {
+   *   result.errors?.forEach(err => {
+   *     console.error(`Line ${err.line}: ${err.message}`);
+   *   });
+   * }
+   * ```
+   *
+   * @since API v2
+   */
+  validate(source: string, options?: NewCompileOptions): Promise<ValidateResult>;
+
+  /**
+   * Create execution context (unified signature with optional parent).
+   *
+   * @example
+   * ```typescript
+   * // Basic context
+   * const ctx = hyperfixi.createContext(element);
+   *
+   * // Child context
+   * const child = hyperfixi.createContext(element, parentContext);
+   * ```
+   *
+   * @since API v2
+   */
+  createContext(element?: Element | null, parent?: ExecutionContext): ExecutionContext;
+
+  // ==================== API v1 (Deprecated) ====================
+
+  /**
+   * Execute hyperscript on an element
+   */
+  execute(source: string, element?: Element, context?: ExecutionOptions): Promise<void>;
+
+  /**
+   * @deprecated Use `eval()` instead
+   * Run (compile and execute) hyperscript
+   */
+  run(source: string, element?: Element): Promise<void>;
+
+  /**
+   * @deprecated Use `eval()` instead
+   * Alias for run()
+   */
+  evaluate(source: string, element?: Element): Promise<void>;
+
+  /**
+   * Parse hyperscript to AST
+   */
+  parse(source: string): ParseResult;
+
+  /**
+   * Process a DOM node for hyperscript attributes
+   */
+  processNode(node: Node): void;
+
+  /**
+   * Process entire document for hyperscript
+   */
+  process(root?: Document | Element): void;
+
+  /**
+   * @deprecated Use `createContext(element, parent)` instead
+   * Create child execution context
+   */
+  createChildContext(parent: ExecutionContext, element?: Element): ExecutionContext;
+
+  /**
+   * @deprecated Use `validate()` instead
+   * Validate hyperscript syntax
+   */
+  isValidHyperscript(source: string): boolean;
+
+  /**
+   * Get HyperFixi version
+   */
+  version: string;
+
+  /**
+   * Create runtime instance
+   */
+  createRuntime(options?: RuntimeOptions): Runtime;
+}
+
+export interface CompileOptions {
+  strict?: boolean;
+  includeSource?: boolean;
+}
+
+export interface CompilationResult {
+  ast: ASTNode;
+  errors: ParseError[];
+  success: boolean;
+}
+
+export interface ParseResult {
+  ast: ASTNode;
+  tokens: Token[];
+  errors: ParseError[];
+}
+
+export interface ParseError {
+  message: string;
+  position: number;
+  line: number;
+  column: number;
+}
+
+export interface Token {
+  type: string;
+  value: string;
+  position: number;
+  line: number;
+  column: number;
+}
+
+export interface ASTNode {
+  type: string;
+  [key: string]: unknown;
+}
+
+export interface ExecutionOptions {
+  globals?: Record<string, unknown>;
+  locals?: Record<string, unknown>;
+}
+
+export interface ExecutionContext {
+  me: Element | null;
+  you?: Element | null;
+  it?: unknown;
+  result?: unknown;
+  locals: Map<string, unknown>;
+  globals: Map<string, unknown>;
+  target?: Element | EventTarget | null;
+  detail?: unknown;
+}
+
+export interface ContextOptions {
+  element?: Element;
+  globals?: Record<string, unknown>;
+}
+
+export interface RuntimeOptions {
+  strict?: boolean;
+  timeout?: number;
+}
+
+export interface Runtime {
+  execute(ast: ASTNode, context: ExecutionContext): Promise<void>;
+  processCommand(command: ASTNode, context: ExecutionContext): Promise<void>;
+}
+
+// ==================== API v2 Types ====================
+
+/**
+ * Result of compilation (API v2)
+ */
+export interface CompileResult {
+  /** Whether compilation succeeded */
+  ok: boolean;
+  /** Compiled AST (only present if ok=true) */
+  ast?: ASTNode;
+  /** Compilation errors (only present if ok=false) */
+  errors?: CompileError[];
+  /** Compilation metadata */
+  meta: {
+    /** Parser used: semantic or traditional */
+    parser: 'semantic' | 'traditional';
+    /** Confidence score (0-1) if semantic parser was used */
+    confidence?: number;
+    /** Language code */
+    language: string;
+    /** Compilation time in milliseconds */
+    timeMs: number;
+    /** Whether direct path was taken (no fallback) */
+    directPath?: boolean;
+  };
+}
+
+/**
+ * Compilation error (API v2)
+ */
+export interface CompileError {
+  /** Error message */
+  message: string;
+  /** Line number where error occurred */
+  line: number;
+  /** Column number where error occurred */
+  column: number;
+  /** Optional suggestion for fixing the error */
+  suggestion?: string;
+}
+
+/**
+ * Compilation options (API v2)
+ */
+export interface NewCompileOptions {
+  /** Language code (default: 'en') */
+  language?: string;
+  /** Minimum confidence for semantic parsing (0-1, default: 0.5) */
+  confidenceThreshold?: number;
+  /** Force traditional parser, skip semantic analysis */
+  traditional?: boolean;
+}
+
+/**
+ * Validation result (API v2)
+ */
+export interface ValidateResult {
+  /** Whether code is valid */
+  valid: boolean;
+  /** Validation errors (only present if valid=false) */
+  errors?: CompileError[];
+}