@hyperfixi/types-browser 3.3.0 → 4.0.0

package/dist/globals.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Global type augmentation for HyperFixi and LokaScript browser APIs
+ *
+ * This file augments the Window and globalThis interfaces to include
+ * HyperFixi and LokaScript global variables, providing IDE autocomplete and type safety.
+ */
+import type { HyperfixiAPI } from './core-api';
+import type { LokaScriptSemanticAPI } from './semantic-api';
+import type { LokaScriptI18nAPI } from './i18n-api';
+declare global {
+    /**
+     * Window interface augmentation
+     */
+    interface Window {
+        /**
+         * The hyperscript engine (`@hyperfixi/engine`'s public object).
+         *
+         * Loaded from: hyperfixi-hs.js (or hyperfixi.js, the same file under `@hyperfixi/core`'s name)
+         *
+         * @example
+         * ```typescript
+         * window.hyperfixi.evaluate('add .highlight to me', { me: document.body })
+         * window.hyperfixi.parse('on click toggle .active').errors // []
+         * ```
+         */
+        hyperfixi: HyperfixiAPI;
+        /**
+         * The same object as `window.hyperfixi`, under upstream `_hyperscript`'s name — set by
+         * hyperfixi-hs.js, and by upstream `_hyperscript` itself.
+         *
+         * @example
+         * ```typescript
+         * window._hyperscript.processNode(document.body)
+         * ```
+         */
+        _hyperscript: HyperfixiAPI;
+        /**
+         * LokaScript Semantic - Multilingual semantic parsing (24 languages)
+         *
+         * Loaded from: lokascript-semantic.browser.global.js
+         *
+         * @example
+         * ```typescript
+         * const result = window.LokaScriptSemantic.parse('トグル .active', 'ja')
+         * const korean = window.LokaScriptSemantic.translate('toggle .active', 'en', 'ko')
+         * ```
+         */
+        LokaScriptSemantic: LokaScriptSemanticAPI;
+        /**
+         * LokaScript I18n - per-language vocabulary and word-order profiles (24 languages).
+         * Translation is `window.LokaScriptSemantic.translate`.
+         *
+         * Loaded from: lokascript-i18n.min.js
+         *
+         * @example
+         * ```typescript
+         * window.LokaScriptI18n.getProfile('ja')?.wordOrder // 'SOV'
+         * ```
+         */
+        LokaScriptI18n: LokaScriptI18nAPI;
+    }
+    /**
+     * globalThis interface augmentation (same as Window for browser contexts)
+     */
+    var hyperfixi: HyperfixiAPI;
+    var _hyperscript: HyperfixiAPI;
+    var LokaScriptSemantic: LokaScriptSemanticAPI;
+    var LokaScriptI18n: LokaScriptI18nAPI;
+}
+export {};
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,CAAC,MAAM,CAAC;IACb;;OAEG;IACH,UAAU,MAAM;QACd;;;;;;;;;;WAUG;QACH,SAAS,EAAE,YAAY,CAAC;QAExB;;;;;;;;WAQG;QACH,YAAY,EAAE,YAAY,CAAC;QAE3B;;;;;;;;;;WAUG;QACH,kBAAkB,EAAE,qBAAqB,CAAC;QAE1C;;;;;;;;;;WAUG;QACH,cAAc,EAAE,iBAAiB,CAAC;KACnC;IAED;;OAEG;IACH,IAAI,SAAS,EAAE,YAAY,CAAC;IAC5B,IAAI,YAAY,EAAE,YAAY,CAAC;IAC/B,IAAI,kBAAkB,EAAE,qBAAqB,CAAC;IAC9C,IAAI,cAAc,EAAE,iBAAiB,CAAC;CACvC;AAGD,OAAO,EAAE,CAAC"}

package/dist/index.d.ts

@@ -31,26 +31,26 @@
  *
  * ### Using window.hyperfixi
  * ```typescript
- * // window.hyperfixi is now fully typed
- * const result = await window.hyperfixi.execute('toggle .active')
- * window.evalHyperScript('toggle .active')
+ * // window.hyperfixi (and window._hyperscript, the same object) is fully typed
+ * window.hyperfixi.evaluate('toggle .active on me', { me: button })
+ * window.hyperfixi.parse('on click toggle .active').errors // []
  * ```
  *
- * ### Using window.HyperFixiSemantic
+ * ### Using window.LokaScriptSemantic
  * ```typescript
- * if (window.HyperFixiSemantic) {
- *   const node = window.HyperFixiSemantic.parse('toggle .active', 'en')
- *   const japanese = window.HyperFixiSemantic.translate('toggle .active', 'en', 'ja')
+ * if (window.LokaScriptSemantic) {
+ *   const node = window.LokaScriptSemantic.parse('toggle .active', 'en')
+ *   const japanese = window.LokaScriptSemantic.translate('toggle .active', 'en', 'ja')
  * }
  * ```
  *
  * ### Using Type Guards
  * ```typescript
- * import { isHyperFixiCoreAvailable, getHyperFixiCore } from '@hyperfixi/types-browser'
+ * import { getHyperFixiCore } from '@hyperfixi/types-browser'
  *
  * const hyperfixi = getHyperFixiCore()
  * if (hyperfixi) {
- *   hyperfixi.execute('toggle .active')
+ *   hyperfixi.evaluate('toggle .active on me', { me: button })
  * }
  * ```
  */

package/dist/type-guards.d.ts

@@ -1,13 +1,14 @@
 /**
  * Type guards for browser globals
  */
-import type { LokaScriptCoreAPI } from './core-api';
+import type { HyperfixiAPI } from './core-api';
 import type { LokaScriptSemanticAPI } from './semantic-api';
 import type { LokaScriptI18nAPI } from './i18n-api';
 /**
- * Check if window.hyperfixi is available and properly typed
+ * Check that a value is the hyperscript host (`window.hyperfixi` / `window._hyperscript`):
+ * callable, with `evaluate` and `processNode`.
  */
-export declare function isHyperFixiCoreAvailable(obj?: any): obj is LokaScriptCoreAPI;
+export declare function isHyperFixiCoreAvailable(obj?: any): obj is HyperfixiAPI;
 /**
  * Check if window.HyperFixiSemantic is available
  */
@@ -19,7 +20,7 @@ export declare function isHyperFixiI18nAvailable(obj?: any): obj is LokaScriptI1
 /**
  * Safe access to window.hyperfixi with type checking
  */
-export declare function getHyperFixiCore(): LokaScriptCoreAPI | null;
+export declare function getHyperFixiCore(): HyperfixiAPI | null;
 /**
  * Safe access to window.LokaScriptSemantic with type checking
  */

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

@@ -1 +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,CAU5E;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"}
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../src/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAMvE;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,CAU5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAKtD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,GAAG,IAAI,CAKnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,GAAG,IAAI,CAK3D"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hyperfixi/types-browser",
-  "version": "3.3.0",
-  "description": "TypeScript type definitions for LokaScript browser globals",
+  "version": "4.0.0",
+  "description": "TypeScript definitions for the hyperfixi browser globals: window.hyperfixi / window._hyperscript (the engine), LokaScriptSemantic, LokaScriptI18n",
   "type": "module",
   "types": "dist/index.d.ts",
   "exports": {
@@ -18,7 +18,7 @@
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit -p tsconfig.check.json"
   },
   "keywords": [
     "hyperfixi",
@@ -30,6 +30,7 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "devDependencies": {
+    "@hyperfixi/engine": "^4.0.0",
     "typescript": "^5.8.3"
   },
   "publishConfig": {

package/src/core-api.ts

@@ -1,256 +1,150 @@
 /**
- * Type definitions for HyperFixi Core browser API
+ * Type definitions for the hyperscript host on `window.hyperfixi` and `window._hyperscript`.
+ *
+ * Both globals are one object: `@hyperfixi/engine`'s public API, which the engine's
+ * `hyperfixi-hs.js` installs, and which `@hyperfixi/core` ships as `hyperfixi.js` (the same
+ * file, since Phase C3 of the engine cutover). It is shaped like upstream `_hyperscript`'s
+ * public object, so upstream plugins can use it, plus one hook upstream lacks
+ * (`addSourceTransform`). `test/engine-api.check.ts` checks the engine's own `api` against
+ * this interface, so the two cannot drift apart.
+ *
+ * (Until then `hyperfixi.js` was core's own bundle, and `window.hyperfixi` had core's API:
+ * `compile`, `compileSync`, `execute`, `createContext`, `evalHyperScript`, … — none of which
+ * the engine has. Those types are gone; see `HyperfixiAPI` for what replaced each.)
  */
 
-/**
- * HyperFixi core API exposed on window.hyperfixi
- */
-export interface LokaScriptCoreAPI {
-  // ==================== API v2 (Recommended) ====================
-
-  /**
-   * Synchronously compile hyperscript code to AST (API v2).
-   * @since API v2
-   */
-  compileSync(code: string, options?: NewCompileOptions): CompileResult;
-
-  /**
-   * Asynchronously compile hyperscript code (handles all 13 languages) (API v2).
-   * @since API v2
-   */
-  compile(code: string, options?: NewCompileOptions): Promise<CompileResult>;
-
-  /**
-   * Compile and execute hyperscript in one step (API v2).
-   * @since API v2
-   */
-  eval(code: string, contextOrElement?: any): Promise<any>;
-
-  /**
-   * Validate hyperscript syntax and return detailed errors (API v2).
-   * @since API v2
-   */
-  validate(code: string, options?: NewCompileOptions): Promise<ValidateResult>;
-
-  /**
-   * Create execution context with optional parent (unified signature, API v2).
-   * @since API v2
-   */
-  createContext(element?: Element | null, parent?: any): any;
-
-  // ==================== API v1 (Deprecated) ====================
-
-  /**
-   * Evaluate hyperscript string directly
-   */
-  evalHyperScript(code: string, element?: Element): any;
-
-  /**
-   * Async evaluation of hyperscript
-   */
-  evalHyperScriptAsync(code: string, element?: Element): Promise<any>;
-
-  /**
-   * Smart evaluation with automatic context detection
-   */
-  evalHyperScriptSmart(code: string): Promise<any>;
-
-  /**
-   * Compile multilingual hyperscript code
-   * @deprecated Use compile() with options.language instead
-   */
-  compileMultilingual(code: string, language: string, options?: CompileOptions): CompilationResult;
-
-  /**
-   * Execute hyperscript code
-   */
-  execute(code: string, element?: Element, options?: ExecuteOptions): Promise<any>;
-
-  /**
-   * Run hyperscript code (alias for execute)
-   * @deprecated Use eval() instead
-   */
-  run(code: string, element?: Element, options?: ExecuteOptions): Promise<any>;
-
-  /**
-   * Create child execution context
-   * @deprecated Use createContext(element, parent) instead
-   */
-  createChildContext(parent: any, element?: Element): any;
-
-  /**
-   * Validate hyperscript syntax (returns boolean)
-   * @deprecated Use validate() instead (returns detailed result)
-   */
-  isValidHyperscript(code: string): boolean;
-
-  /**
-   * Create runtime instance
-   */
-  createRuntime(options?: RuntimeOptions): any;
-
-  /**
-   * Process DOM node
-   */
-  processNode(node: Node): void;
-
-  /**
-   * Process DOM node (alias)
-   */
-  process(node: Node): void;
-
-  /**
-   * Tokenize hyperscript code
-   */
-  tokenize(code: string): any[];
-
-  /**
-   * Low-level parser access
-   */
-  Parser: any;
-
-  /**
-   * Low-level runtime access
-   */
-  Runtime: any;
+/** The context `evaluate` runs its source in. Every field is optional. */
+export interface HyperscriptContext {
+  /** What `me` / `my` / `I` refer to (default: `document.body`). */
+  me?: unknown;
+  you?: unknown;
+  /** `it` / `result`. */
+  result?: unknown;
+  event?: unknown;
+  target?: unknown;
+  detail?: unknown;
+  sender?: unknown;
+  body?: unknown;
+  /** Local variables, by name. */
+  locals?: Record<string, unknown>;
+}
 
-  /**
-   * Attribute processor
-   */
-  attributeProcessor: any;
+/** The token a parse error points at. */
+export interface HyperscriptToken {
+  type: string;
+  value: string;
+  /** Offsets into the source. */
+  start: number;
+  end: number;
+  /** 1-based line, 0-based column. */
+  line: number;
+  column: number;
+}
 
-  /**
-   * Debug utilities
-   */
-  debug: {
-    enableDebugLogging(): void;
-    disableDebugLogging(): void;
-  };
+/** A grammar error, as `parse` reports it and as the `hyperscript:parse-error` event carries it. */
+export interface HyperscriptParseError {
+  message: string;
+  token: HyperscriptToken;
+  source: string;
+  /** The words the parser would have accepted, when it knows. */
+  expected?: string[];
+  /** What the author wrote, when a source transform rewrote the script before it was parsed. */
+  written?: string;
+}
 
-  /**
-   * Style batcher utility
-   */
-  styleBatcher: any;
+/** `parse`'s result: the parsed node in upstream's shape, with its `errors` (empty when it parsed). */
+export interface HyperscriptParseResult {
+  errors: HyperscriptParseError[];
+}
 
-  /**
-   * Object pool utility
-   */
-  ObjectPool: any;
+/** A root `processNode` initialises: hooks receive it before and after. */
+export type HyperscriptProcessRoot = Element | Document | DocumentFragment;
 
-  /**
-   * Semantic parsing utilities
-   */
-  semantic?: {
-    parse(code: string, language: string): any;
-    translate(code: string, fromLang: string, toLang: string): string | null;
-    buildAST(node: any): any;
+/**
+ * A plugin's rewrite of a script, applied as the script is read; the element keeps the text its
+ * author wrote. Return nothing to leave the script as it is.
+ */
+export type HyperscriptSourceTransform = (
+  source: string,
+  element: Element
+) => string | null | undefined;
+
+/** `config`: upstream's settings, and the table `as <Name>` conversions read. */
+export interface HyperscriptConfig {
+  /** Attributes that hold a script (default `'_, script, data-script'`). */
+  attributes: string;
+  defaultTransition: string;
+  disableSelector: string;
+  /** The strategy `hide` / `show` / `toggle` use when none is named (`display` if unset). */
+  defaultHideShowStrategy?: string;
+  /** Extra strategies, by name. */
+  hideShowStrategies: Record<
+    string,
+    (op: 'hide' | 'show' | 'toggle', elt: HTMLElement, arg?: string) => void
+  >;
+  /** `fetch` throws when the response status matches one of these. */
+  fetchThrowsOn: RegExp[];
+  /** `as <Name>` conversions, by name; `dynamicResolvers` handle names with arguments. */
+  conversions: Record<string, (value: unknown) => unknown> & {
+    dynamicResolvers: ((name: string, value: unknown) => unknown)[];
   };
+}
 
-  /**
-   * Semantic debug utilities
-   */
-  semanticDebug?: any;
+/**
+ * `window.hyperfixi` / `window._hyperscript`. Callable: `hyperfixi(source, context?)` is
+ * `hyperfixi.evaluate(source, context?)`.
+ *
+ * Replacing core 3.x's API: `compileSync(code)` → `parse(code).errors`;
+ * `eval(code, element)` / `execute(code, element)` → `evaluate(code, { me: element })`;
+ * `processNode(node)` is unchanged; `compile(code, { language })` → load
+ * `@lokascript/hyperscript-adapter` beside a semantic bundle, which translates each script as
+ * the engine reads it.
+ */
+export interface HyperfixiAPI {
+  (source: string, context?: HyperscriptContext): unknown;
 
   /**
-   * Version string
+   * Run source: commands, features (installed on `document.body`) or one expression.
+   * Synchronous unless the source itself waits on something; then it returns a promise.
+   * A parse error throws.
    */
-  version: string;
-}
+  evaluate(source: string, context?: HyperscriptContext): unknown;
 
-export interface CompileOptions {
-  language?: string;
-  strict?: boolean;
-  [key: string]: any;
-}
+  /** Parse without running. A grammar error is reported in `errors`; a tokenizer error throws. */
+  parse(source: string): HyperscriptParseResult;
 
-export interface CompilationResult {
-  success: boolean;
-  code?: any;
-  error?: Error;
-  [key: string]: any;
-}
+  /** Initialise every scripted element under a node; elements already initialised are skipped. */
+  process(node: unknown): void;
 
-export interface ExecuteOptions {
-  context?: any;
-  element?: Element;
-  [key: string]: any;
-}
+  /** Upstream's older name for `process`. */
+  processNode(node: unknown): void;
 
-export interface ContextOptions {
-  element?: Element;
-  globals?: Record<string, any>;
-  [key: string]: any;
-}
+  /** Remove everything an element's script installed: listeners, observers, timers, state. */
+  cleanup(element: Element): void;
 
-export interface RuntimeOptions {
-  [key: string]: any;
-}
+  config: HyperscriptConfig;
 
-export type EvalHyperScriptFunction = (code: string, element?: Element) => any;
+  /** `use(plugin)`: the plugin receives this object (upstream's plugin API). */
+  use(plugin: (hyperscript: unknown) => void): void;
 
-export type EvalHyperScriptAsyncFunction = (code: string, element?: Element) => Promise<any>;
+  addBeforeProcessHook(hook: (root: HyperscriptProcessRoot) => void): void;
 
-export type EvalHyperScriptSmartFunction = (code: string) => Promise<any>;
+  addAfterProcessHook(hook: (root: HyperscriptProcessRoot) => void): void;
 
-// ==================== API v2 Types ====================
+  /** Not in upstream: rewrite a script as it is read, leaving the attribute as written. */
+  addSourceTransform(transform: HyperscriptSourceTransform): void;
 
-/**
- * Compilation result (API v2)
- */
-export interface CompileResult {
-  /** Whether compilation succeeded */
-  ok: boolean;
-  /** Compiled AST (only present if ok=true) */
-  ast?: any;
-  /** 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;
+  /** The part of upstream's `internals` that pages and tests reach for. */
+  internals: {
+    runtime: {
+      cleanup(element: Element): void;
+      processNode(node: unknown): void;
+    };
   };
-}
 
-/**
- * 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;
+  /** The engine's package version (`'dev'` when built from source without one). */
+  version: string;
 }
 
-/**
- * Validation result (API v2)
- */
-export interface ValidateResult {
-  /** Whether code is valid */
-  valid: boolean;
-  /** Validation errors (only present if valid=false) */
-  errors?: CompileError[];
-}
+/** @deprecated The 3.x name; `window.hyperfixi` is a {@link HyperfixiAPI} since 4.0. */
+export type LokaScriptCoreAPI = HyperfixiAPI;

package/src/{globals.d.ts → globals.ts}

@@ -5,7 +5,7 @@
  * HyperFixi and LokaScript global variables, providing IDE autocomplete and type safety.
  */
 
-import type { LokaScriptCoreAPI } from './core-api';
+import type { HyperfixiAPI } from './core-api';
 import type { LokaScriptSemanticAPI } from './semantic-api';
 import type { LokaScriptI18nAPI } from './i18n-api';
 
@@ -15,34 +15,28 @@ declare global {
    */
   interface Window {
     /**
-     * HyperFixi - Modern hyperscript engine with fixi/htmx integration
+     * The hyperscript engine (`@hyperfixi/engine`'s public object).
      *
-     * Loaded from: hyperfixi.js or hyperfixi-hx.js
+     * Loaded from: hyperfixi-hs.js (or hyperfixi.js, the same file under `@hyperfixi/core`'s name)
      *
      * @example
      * ```typescript
-     * window.hyperfixi.execute('toggle .active', document.body)
-     * window.hyperfixi.compile('on click add .highlight')
+     * window.hyperfixi.evaluate('add .highlight to me', { me: document.body })
+     * window.hyperfixi.parse('on click toggle .active').errors // []
      * ```
      */
-    hyperfixi: LokaScriptCoreAPI;
+    hyperfixi: HyperfixiAPI;
 
     /**
-     * @deprecated Use `hyperfixi` instead. Will be removed in v3.0.0.
-     *
-     * Loaded from: hyperfixi.js (backward-compat alias)
-     */
-    lokascript: LokaScriptCoreAPI;
-
-    /**
-     * Compatibility alias for official _hyperscript API compatibility
+     * The same object as `window.hyperfixi`, under upstream `_hyperscript`'s name — set by
+     * hyperfixi-hs.js, and by upstream `_hyperscript` itself.
      *
      * @example
      * ```typescript
-     * window._hyperscript.compile('on click toggle .active')
+     * window._hyperscript.processNode(document.body)
      * ```
      */
-    _hyperscript: LokaScriptCoreAPI;
+    _hyperscript: HyperfixiAPI;
 
     /**
      * LokaScript Semantic - Multilingual semantic parsing (24 languages)
@@ -58,14 +52,14 @@ declare global {
     LokaScriptSemantic: LokaScriptSemanticAPI;
 
     /**
-     * LokaScript I18n - Grammar transformation for natural language word order
+     * LokaScript I18n - per-language vocabulary and word-order profiles (24 languages).
+     * Translation is `window.LokaScriptSemantic.translate`.
      *
      * Loaded from: lokascript-i18n.min.js
      *
      * @example
      * ```typescript
-     * const japanese = window.LokaScriptI18n.translate('on click toggle .active', 'en', 'ja')
-     * // Result: 'クリック で .active を 切り替え' (SOV word order)
+     * window.LokaScriptI18n.getProfile('ja')?.wordOrder // 'SOV'
      * ```
      */
     LokaScriptI18n: LokaScriptI18nAPI;
@@ -74,9 +68,8 @@ declare global {
   /**
    * globalThis interface augmentation (same as Window for browser contexts)
    */
-  var hyperfixi: LokaScriptCoreAPI;
-  var lokascript: LokaScriptCoreAPI;
-  var _hyperscript: LokaScriptCoreAPI;
+  var hyperfixi: HyperfixiAPI;
+  var _hyperscript: HyperfixiAPI;
   var LokaScriptSemantic: LokaScriptSemanticAPI;
   var LokaScriptI18n: LokaScriptI18nAPI;
 }

package/src/i18n-api.ts

@@ -11,7 +11,7 @@ export interface LokaScriptI18nAPI {
   // The global keeps its DICTIONARIES, keyword providers, locale manager,
   // direct mappings and grammar PROFILES — everything that was not the
   // transformer. Translation is `@lokascript/semantic`'s job; in the browser
-  // that is `hyperfixi.translate` from the multilingual bundle.
+  // that is `LokaScriptSemantic.translate` (every semantic browser bundle has it).
 
   /**
    * Get supported locales for grammar transformation