@hypen-space/core 0.2.3 → 0.2.4

package/dist/src/engine.browser.js

@@ -31,7 +31,7 @@ class Engine {
   async init(options = {}) {
     if (this.initialized)
       return;
-    const wasmPath = options.wasmPath ?? "/hypen_engine_bg.wasm";
+    const wasmPath = options.wasmPath ?? "https://unpkg.com/@hypen-space/core/wasm-browser/hypen_engine_bg.wasm";
     try {
       const wasmModule = await import("../wasm-browser/hypen_engine.js");
       wasmInit = wasmModule.default;
@@ -127,4 +127,4 @@ export {
 
 export { Engine };
 
-//# debugId=ABF5E4E7E0C79CD064756E2164756E21
+//# debugId=CA54F8DFEBB008F764756E2164756E21

package/dist/src/engine.browser.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/engine.browser.ts"],
   "sourcesContent": [
-    "/**\n * Browser-compatible wrapper around the WASM engine\n * Uses web target for browser environments\n */\n\n// Dynamic import path - will be configured at build time\n// For browser, the WASM needs to be served and initialized explicitly\nlet wasmInit: ((path?: string) => Promise<void>) | null = null;\nlet WasmEngineClass: any = null;\n\nexport type Patch = {\n  type: \"create\" | \"setProp\" | \"setText\" | \"insert\" | \"move\" | \"remove\" | \"attachEvent\" | \"detachEvent\";\n  id?: string;\n  element_type?: string;\n  props?: Record<string, any> | Map<string, any>;\n  name?: string;\n  value?: any;\n  text?: string;\n  parent_id?: string;\n  before_id?: string;\n  event_name?: string;\n};\n\nexport type Action = {\n  name: string;\n  payload?: any;\n  sender?: string;\n};\n\nexport type RenderCallback = (patches: Patch[]) => void;\nexport type ActionHandler = (action: Action) => void | Promise<void>;\n\nexport type ResolvedComponent = {\n  source: string;\n  path: string;\n};\n\nexport type ComponentResolver = (\n  componentName: string,\n  contextPath: string | null\n) => ResolvedComponent | null;\n\nexport interface EngineInitOptions {\n  /** Path to the WASM file (default: \"/hypen_engine_bg.wasm\") */\n  wasmPath?: string;\n}\n\n/**\n * Recursively convert Maps and nested structures to plain objects\n */\nfunction mapToObject(value: any): any {\n  if (value instanceof Map) {\n    const obj: Record<string, any> = {};\n    for (const [key, val] of value.entries()) {\n      obj[key] = mapToObject(val);\n    }\n    return obj;\n  } else if (Array.isArray(value)) {\n    return value.map(mapToObject);\n  } else if (value && typeof value === 'object' && value.constructor === Object) {\n    const obj: Record<string, any> = {};\n    for (const [key, val] of Object.entries(value)) {\n      obj[key] = mapToObject(val);\n    }\n    return obj;\n  }\n  return value;\n}\n\n/**\n * Engine wraps the WASM engine and provides a TypeScript-friendly API\n * Browser version with explicit WASM initialization\n */\nexport class Engine {\n  private wasmEngine: any = null;\n  private initialized = false;\n\n  /**\n   * Initialize the WASM module\n   * @param options - Initialization options including wasmPath\n   */\n  async init(options: EngineInitOptions = {}): Promise<void> {\n    if (this.initialized) return;\n\n    const wasmPath = options.wasmPath ?? \"/hypen_engine_bg.wasm\";\n\n    // Dynamically import the WASM module\n    // This allows the path to be configured at runtime\n    try {\n      const wasmModule: any = await import(\"../wasm-browser/hypen_engine.js\");\n      wasmInit = wasmModule.default;\n      WasmEngineClass = wasmModule.WasmEngine;\n\n      // Initialize WASM with explicit path\n      await wasmInit!(wasmPath);\n\n      this.wasmEngine = new WasmEngineClass();\n      this.initialized = true;\n    } catch (error) {\n      console.error(\"[Hypen] Failed to initialize WASM engine:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Ensure the engine is initialized before operations\n   */\n  private ensureInitialized(): any {\n    if (!this.wasmEngine) {\n      throw new Error(\"Engine not initialized. Call init() first.\");\n    }\n    return this.wasmEngine;\n  }\n\n  /**\n   * Set the render callback that receives patches\n   */\n  setRenderCallback(callback: RenderCallback): void {\n    const engine = this.ensureInitialized();\n    engine.setRenderCallback((patches: Patch[]) => {\n      callback(patches);\n    });\n  }\n\n  /**\n   * Set the component resolver for dynamic component composition\n   */\n  setComponentResolver(resolver: ComponentResolver): void {\n    const engine = this.ensureInitialized();\n    engine.setComponentResolver((componentName: string, contextPath: string | null) => {\n      const result = resolver(componentName, contextPath);\n      return result;\n    });\n  }\n\n  /**\n   * Parse and render Hypen DSL source code\n   */\n  renderSource(source: string): void {\n    const engine = this.ensureInitialized();\n    engine.renderSource(source);\n  }\n\n  /**\n   * Render a lazy component (for lazy route loading)\n   */\n  renderLazyComponent(source: string): void {\n    const engine = this.ensureInitialized();\n    engine.renderLazyComponent(source);\n  }\n\n  /**\n   * Render a component into a specific parent node (subtree rendering)\n   */\n  renderInto(source: string, parentNodeId: string, state: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n    const safeState = JSON.parse(JSON.stringify(state));\n    engine.renderInto(source, parentNodeId, safeState);\n  }\n\n  /**\n   * Notify the engine of state changes\n   */\n  notifyStateChange(paths: string[], currentState: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n\n    const plainObject = JSON.parse(JSON.stringify(currentState));\n    engine.updateState(plainObject);\n\n    if (paths.length > 0) {\n      console.debug(\"[Hypen] State changed:\", paths);\n    }\n  }\n\n  /**\n   * Update state (triggers re-render of affected nodes)\n   * @deprecated Use notifyStateChange instead\n   */\n  updateState(statePatch: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n    const plainObject = JSON.parse(JSON.stringify(statePatch));\n    engine.updateState(plainObject);\n  }\n\n  /**\n   * Dispatch an action\n   */\n  dispatchAction(name: string, payload?: any): void {\n    const engine = this.ensureInitialized();\n    console.log(`[Engine] Action dispatched: ${name}`);\n    engine.dispatchAction(name, payload ?? null);\n  }\n\n  /**\n   * Register an action handler\n   */\n  onAction(actionName: string, handler: ActionHandler): void {\n    const engine = this.ensureInitialized();\n    engine.onAction(actionName, (action: Action) => {\n      const normalizedAction: Action = {\n        ...action,\n        payload: action.payload ? mapToObject(action.payload) : action.payload,\n      };\n      Promise.resolve(handler(normalizedAction)).catch(console.error);\n    });\n  }\n\n  /**\n   * Initialize a module\n   */\n  setModule(\n    name: string,\n    actions: string[],\n    stateKeys: string[],\n    initialState: Record<string, any>\n  ): void {\n    const engine = this.ensureInitialized();\n    engine.setModule(name, actions, stateKeys, initialState);\n  }\n\n  /**\n   * Get the current revision number\n   */\n  getRevision(): bigint {\n    const engine = this.ensureInitialized();\n    return engine.getRevision();\n  }\n\n  /**\n   * Clear the engine tree\n   */\n  clearTree(): void {\n    const engine = this.ensureInitialized();\n    engine.clearTree();\n  }\n\n  /**\n   * Debug method to inspect parsed components\n   */\n  debugParseComponent(source: string): string {\n    const engine = this.ensureInitialized();\n    return engine.debugParseComponent(source);\n  }\n}\n"
+    "/**\n * Browser-compatible wrapper around the WASM engine\n * Uses web target for browser environments\n */\n\n// Dynamic import path - will be configured at build time\n// For browser, the WASM needs to be served and initialized explicitly\nlet wasmInit: ((path?: string) => Promise<void>) | null = null;\nlet WasmEngineClass: any = null;\n\nexport type Patch = {\n  type: \"create\" | \"setProp\" | \"setText\" | \"insert\" | \"move\" | \"remove\" | \"attachEvent\" | \"detachEvent\";\n  id?: string;\n  element_type?: string;\n  props?: Record<string, any> | Map<string, any>;\n  name?: string;\n  value?: any;\n  text?: string;\n  parent_id?: string;\n  before_id?: string;\n  event_name?: string;\n};\n\nexport type Action = {\n  name: string;\n  payload?: any;\n  sender?: string;\n};\n\nexport type RenderCallback = (patches: Patch[]) => void;\nexport type ActionHandler = (action: Action) => void | Promise<void>;\n\nexport type ResolvedComponent = {\n  source: string;\n  path: string;\n};\n\nexport type ComponentResolver = (\n  componentName: string,\n  contextPath: string | null\n) => ResolvedComponent | null;\n\nexport interface EngineInitOptions {\n  /**\n   * Path to the WASM file.\n   * Default: loads from unpkg CDN (https://unpkg.com/@hypen-space/core/wasm-browser/hypen_engine_bg.wasm)\n   * For production, consider serving from your own domain for better performance.\n   */\n  wasmPath?: string;\n}\n\n/**\n * Recursively convert Maps and nested structures to plain objects\n */\nfunction mapToObject(value: any): any {\n  if (value instanceof Map) {\n    const obj: Record<string, any> = {};\n    for (const [key, val] of value.entries()) {\n      obj[key] = mapToObject(val);\n    }\n    return obj;\n  } else if (Array.isArray(value)) {\n    return value.map(mapToObject);\n  } else if (value && typeof value === 'object' && value.constructor === Object) {\n    const obj: Record<string, any> = {};\n    for (const [key, val] of Object.entries(value)) {\n      obj[key] = mapToObject(val);\n    }\n    return obj;\n  }\n  return value;\n}\n\n/**\n * Engine wraps the WASM engine and provides a TypeScript-friendly API\n * Browser version with explicit WASM initialization\n */\nexport class Engine {\n  private wasmEngine: any = null;\n  private initialized = false;\n\n  /**\n   * Initialize the WASM module\n   * @param options - Initialization options including wasmPath\n   */\n  async init(options: EngineInitOptions = {}): Promise<void> {\n    if (this.initialized) return;\n\n    // Default to CDN for zero-config experience\n    const wasmPath = options.wasmPath ??\n      \"https://unpkg.com/@hypen-space/core/wasm-browser/hypen_engine_bg.wasm\";\n\n    // Dynamically import the WASM module\n    // This allows the path to be configured at runtime\n    try {\n      const wasmModule: any = await import(\"../wasm-browser/hypen_engine.js\");\n      wasmInit = wasmModule.default;\n      WasmEngineClass = wasmModule.WasmEngine;\n\n      // Initialize WASM with explicit path\n      await wasmInit!(wasmPath);\n\n      this.wasmEngine = new WasmEngineClass();\n      this.initialized = true;\n    } catch (error) {\n      console.error(\"[Hypen] Failed to initialize WASM engine:\", error);\n      throw error;\n    }\n  }\n\n  /**\n   * Ensure the engine is initialized before operations\n   */\n  private ensureInitialized(): any {\n    if (!this.wasmEngine) {\n      throw new Error(\"Engine not initialized. Call init() first.\");\n    }\n    return this.wasmEngine;\n  }\n\n  /**\n   * Set the render callback that receives patches\n   */\n  setRenderCallback(callback: RenderCallback): void {\n    const engine = this.ensureInitialized();\n    engine.setRenderCallback((patches: Patch[]) => {\n      callback(patches);\n    });\n  }\n\n  /**\n   * Set the component resolver for dynamic component composition\n   */\n  setComponentResolver(resolver: ComponentResolver): void {\n    const engine = this.ensureInitialized();\n    engine.setComponentResolver((componentName: string, contextPath: string | null) => {\n      const result = resolver(componentName, contextPath);\n      return result;\n    });\n  }\n\n  /**\n   * Parse and render Hypen DSL source code\n   */\n  renderSource(source: string): void {\n    const engine = this.ensureInitialized();\n    engine.renderSource(source);\n  }\n\n  /**\n   * Render a lazy component (for lazy route loading)\n   */\n  renderLazyComponent(source: string): void {\n    const engine = this.ensureInitialized();\n    engine.renderLazyComponent(source);\n  }\n\n  /**\n   * Render a component into a specific parent node (subtree rendering)\n   */\n  renderInto(source: string, parentNodeId: string, state: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n    const safeState = JSON.parse(JSON.stringify(state));\n    engine.renderInto(source, parentNodeId, safeState);\n  }\n\n  /**\n   * Notify the engine of state changes\n   */\n  notifyStateChange(paths: string[], currentState: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n\n    const plainObject = JSON.parse(JSON.stringify(currentState));\n    engine.updateState(plainObject);\n\n    if (paths.length > 0) {\n      console.debug(\"[Hypen] State changed:\", paths);\n    }\n  }\n\n  /**\n   * Update state (triggers re-render of affected nodes)\n   * @deprecated Use notifyStateChange instead\n   */\n  updateState(statePatch: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n    const plainObject = JSON.parse(JSON.stringify(statePatch));\n    engine.updateState(plainObject);\n  }\n\n  /**\n   * Dispatch an action\n   */\n  dispatchAction(name: string, payload?: any): void {\n    const engine = this.ensureInitialized();\n    console.log(`[Engine] Action dispatched: ${name}`);\n    engine.dispatchAction(name, payload ?? null);\n  }\n\n  /**\n   * Register an action handler\n   */\n  onAction(actionName: string, handler: ActionHandler): void {\n    const engine = this.ensureInitialized();\n    engine.onAction(actionName, (action: Action) => {\n      const normalizedAction: Action = {\n        ...action,\n        payload: action.payload ? mapToObject(action.payload) : action.payload,\n      };\n      Promise.resolve(handler(normalizedAction)).catch(console.error);\n    });\n  }\n\n  /**\n   * Initialize a module\n   */\n  setModule(\n    name: string,\n    actions: string[],\n    stateKeys: string[],\n    initialState: Record<string, any>\n  ): void {\n    const engine = this.ensureInitialized();\n    engine.setModule(name, actions, stateKeys, initialState);\n  }\n\n  /**\n   * Get the current revision number\n   */\n  getRevision(): bigint {\n    const engine = this.ensureInitialized();\n    return engine.getRevision();\n  }\n\n  /**\n   * Clear the engine tree\n   */\n  clearTree(): void {\n    const engine = this.ensureInitialized();\n    engine.clearTree();\n  }\n\n  /**\n   * Debug method to inspect parsed components\n   */\n  debugParseComponent(source: string): string {\n    const engine = this.ensureInitialized();\n    return engine.debugParseComponent(source);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "ABF5E4E7E0C79CD064756E2164756E21",
+  "mappings": ";;;;;;AAOA,IAAI,WAAsD;AAC1D,IAAI,kBAAuB;AA8C3B,SAAS,WAAW,CAAC,OAAiB;AAAA,EACpC,IAAI,iBAAiB,KAAK;AAAA,IACxB,MAAM,MAA2B,CAAC;AAAA,IAClC,YAAY,KAAK,QAAQ,MAAM,QAAQ,GAAG;AAAA,MACxC,IAAI,OAAO,YAAY,GAAG;AAAA,IAC5B;AAAA,IACA,OAAO;AAAA,EACT,EAAO,SAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,IAC/B,OAAO,MAAM,IAAI,WAAW;AAAA,EAC9B,EAAO,SAAI,SAAS,OAAO,UAAU,YAAY,MAAM,gBAAgB,QAAQ;AAAA,IAC7E,MAAM,MAA2B,CAAC;AAAA,IAClC,YAAY,KAAK,QAAQ,OAAO,QAAQ,KAAK,GAAG;AAAA,MAC9C,IAAI,OAAO,YAAY,GAAG;AAAA,IAC5B;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAAA;AAOF,MAAM,OAAO;AAAA,EACV,aAAkB;AAAA,EAClB,cAAc;AAAA,OAMhB,KAAI,CAAC,UAA6B,CAAC,GAAkB;AAAA,IACzD,IAAI,KAAK;AAAA,MAAa;AAAA,IAGtB,MAAM,WAAW,QAAQ,YACvB;AAAA,IAIF,IAAI;AAAA,MACF,MAAM,aAAkB,MAAa;AAAA,MACrC,WAAW,WAAW;AAAA,MACtB,kBAAkB,WAAW;AAAA,MAG7B,MAAM,SAAU,QAAQ;AAAA,MAExB,KAAK,aAAa,IAAI;AAAA,MACtB,KAAK,cAAc;AAAA,MACnB,OAAO,OAAO;AAAA,MACd,QAAQ,MAAM,6CAA6C,KAAK;AAAA,MAChE,MAAM;AAAA;AAAA;AAAA,EAOF,iBAAiB,GAAQ;AAAA,IAC/B,IAAI,CAAC,KAAK,YAAY;AAAA,MACpB,MAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AAAA,IACA,OAAO,KAAK;AAAA;AAAA,EAMd,iBAAiB,CAAC,UAAgC;AAAA,IAChD,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,kBAAkB,CAAC,YAAqB;AAAA,MAC7C,SAAS,OAAO;AAAA,KACjB;AAAA;AAAA,EAMH,oBAAoB,CAAC,UAAmC;AAAA,IACtD,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,qBAAqB,CAAC,eAAuB,gBAA+B;AAAA,MACjF,MAAM,SAAS,SAAS,eAAe,WAAW;AAAA,MAClD,OAAO;AAAA,KACR;AAAA;AAAA,EAMH,YAAY,CAAC,QAAsB;AAAA,IACjC,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,aAAa,MAAM;AAAA;AAAA,EAM5B,mBAAmB,CAAC,QAAsB;AAAA,IACxC,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,oBAAoB,MAAM;AAAA;AAAA,EAMnC,UAAU,CAAC,QAAgB,cAAsB,OAAkC;AAAA,IACjF,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,MAAM,YAAY,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AAAA,IAClD,OAAO,WAAW,QAAQ,cAAc,SAAS;AAAA;AAAA,EAMnD,iBAAiB,CAAC,OAAiB,cAAyC;AAAA,IAC1E,MAAM,SAAS,KAAK,kBAAkB;AAAA,IAEtC,MAAM,cAAc,KAAK,MAAM,KAAK,UAAU,YAAY,CAAC;AAAA,IAC3D,OAAO,YAAY,WAAW;AAAA,IAE9B,IAAI,MAAM,SAAS,GAAG;AAAA,MACpB,QAAQ,MAAM,0BAA0B,KAAK;AAAA,IAC/C;AAAA;AAAA,EAOF,WAAW,CAAC,YAAuC;AAAA,IACjD,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,MAAM,cAAc,KAAK,MAAM,KAAK,UAAU,UAAU,CAAC;AAAA,IACzD,OAAO,YAAY,WAAW;AAAA;AAAA,EAMhC,cAAc,CAAC,MAAc,SAAqB;AAAA,IAChD,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,QAAQ,IAAI,+BAA+B,MAAM;AAAA,IACjD,OAAO,eAAe,MAAM,WAAW,IAAI;AAAA;AAAA,EAM7C,QAAQ,CAAC,YAAoB,SAA8B;AAAA,IACzD,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,SAAS,YAAY,CAAC,WAAmB;AAAA,MAC9C,MAAM,mBAA2B;AAAA,WAC5B;AAAA,QACH,SAAS,OAAO,UAAU,YAAY,OAAO,OAAO,IAAI,OAAO;AAAA,MACjE;AAAA,MACA,QAAQ,QAAQ,QAAQ,gBAAgB,CAAC,EAAE,MAAM,QAAQ,KAAK;AAAA,KAC/D;AAAA;AAAA,EAMH,SAAS,CACP,MACA,SACA,WACA,cACM;AAAA,IACN,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,UAAU,MAAM,SAAS,WAAW,YAAY;AAAA;AAAA,EAMzD,WAAW,GAAW;AAAA,IACpB,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,OAAO,YAAY;AAAA;AAAA,EAM5B,SAAS,GAAS;AAAA,IAChB,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,UAAU;AAAA;AAAA,EAMnB,mBAAmB,CAAC,QAAwB;AAAA,IAC1C,MAAM,SAAS,KAAK,kBAAkB;AAAA,IACtC,OAAO,OAAO,oBAAoB,MAAM;AAAA;AAE5C;",
+  "debugId": "CA54F8DFEBB008F764756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypen-space/core",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Hypen core engine - Platform-agnostic reactive UI runtime",
   "type": "module",
   "main": "./dist/index.js",

package/src/engine.browser.ts

@@ -41,7 +41,11 @@ export type ComponentResolver = (
 ) => ResolvedComponent | null;
 
 export interface EngineInitOptions {
-  /** Path to the WASM file (default: "/hypen_engine_bg.wasm") */
+  /**
+   * Path to the WASM file.
+   * Default: loads from unpkg CDN (https://unpkg.com/@hypen-space/core/wasm-browser/hypen_engine_bg.wasm)
+   * For production, consider serving from your own domain for better performance.
+   */
   wasmPath?: string;
 }
 
@@ -82,7 +86,9 @@ export class Engine {
   async init(options: EngineInitOptions = {}): Promise<void> {
     if (this.initialized) return;
 
-    const wasmPath = options.wasmPath ?? "/hypen_engine_bg.wasm";
+    // Default to CDN for zero-config experience
+    const wasmPath = options.wasmPath ??
+      "https://unpkg.com/@hypen-space/core/wasm-browser/hypen_engine_bg.wasm";
 
     // Dynamically import the WASM module
     // This allows the path to be configured at runtime