@hypen-space/core 0.2.2 → 0.2.4

package/dist/src/app.js

@@ -95,6 +95,7 @@ class HypenModuleInstance {
           console.log(`[ModuleInstance] Action handler completed: ${actionName}`);
         } catch (error) {
           console.error(`[ModuleInstance] Action handler error for ${actionName}:`, error);
+          throw error;
         }
       });
     }
@@ -157,4 +158,4 @@ export {
 
 export { HypenAppBuilder, HypenApp, app, HypenModuleInstance };
 
-//# debugId=220ACA4FDA4DC86164756E2164756E21
+//# debugId=CC570FF56ABF0FB064756E2164756E21

package/dist/src/app.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/app.ts"],
   "sourcesContent": [
-    "/**\n * Hypen App Builder API\n * Implements the stateful module system from RFC-0001\n */\n\nimport type { Action } from \"./engine.js\";\n\n// Interface for engine compatibility (works with both engine.js and engine.browser.js)\nexport interface IEngine {\n  setModule(name: string, actions: string[], stateKeys: string[], initialState: unknown): void;\n  onAction(actionName: string, handler: (action: Action) => void | Promise<void>): void;\n  notifyStateChange(paths: string[], changedValues: Record<string, unknown>): void;\n}\n\nimport { createObservableState, type StateChange, getStateSnapshot } from \"./state.js\";\nimport type { HypenRouter } from \"./router.js\";\nimport type { HypenGlobalContext, ModuleReference } from \"./context.js\";\n\nexport type RouterContext = {\n  root: HypenRouter;\n  current?: HypenRouter;\n  parent?: HypenRouter;\n};\n\nexport type ActionContext = {\n  name: string;\n  payload?: unknown;\n  sender?: string;\n};\n\nexport type ActionNext = {\n  router: HypenRouter; // Direct access to router instance (from nearest parent)\n};\n\nexport type GlobalContext = {\n  getModule: <T = unknown>(id: string) => ModuleReference<T>;\n  hasModule: (id: string) => boolean;\n  getModuleIds: () => string[];\n  getGlobalState: () => Record<string, unknown>;\n  emit: (event: string, payload?: unknown) => void;\n  on: (event: string, handler: (payload?: unknown) => void) => () => void;\n  __router?: unknown; // Internal: router instance for built-in Router component\n};\n\nexport type LifecycleHandler<T> = (\n  state: T,\n  context?: GlobalContext\n) => void | Promise<void>;\n\n/**\n * Action handler context - all parameters available explicitly\n */\nexport interface ActionHandlerContext<T> {\n  action: ActionContext;\n  state: T;\n  next: ActionNext;\n  context: GlobalContext;\n}\n\n/**\n * Action handler - receives all context in a single object\n */\nexport type ActionHandler<T> = (ctx: ActionHandlerContext<T>) => void | Promise<void>;\n\nexport interface HypenModuleDefinition<T = unknown> {\n  name?: string;\n  actions: string[];\n  stateKeys: string[];\n  persist?: boolean;\n  version?: number;\n  initialState: T;\n  handlers: {\n    onCreated?: LifecycleHandler<T>;\n    onAction: Map<string, ActionHandler<T>>;\n    onDestroyed?: LifecycleHandler<T>;\n  };\n}\n\n/**\n * Alias for HypenModuleDefinition for backward compatibility\n */\nexport type HypenModule<T = unknown> = HypenModuleDefinition<T>;\n\n/**\n * Builder for creating Hypen app modules\n */\nexport class HypenAppBuilder<T> {\n  private initialState: T;\n  private options: { persist?: boolean; version?: number; name?: string };\n  private createdHandler?: LifecycleHandler<T>;\n  private actionHandlers: Map<string, ActionHandler<T>> = new Map();\n  private destroyedHandler?: LifecycleHandler<T>;\n\n  constructor(\n    initialState: T,\n    options?: { persist?: boolean; version?: number; name?: string }\n  ) {\n    this.initialState = initialState;\n    this.options = options || {};\n  }\n\n  /**\n   * Register a handler for module creation\n   */\n  onCreated(fn: LifecycleHandler<T>): this {\n    this.createdHandler = fn;\n    return this;\n  }\n\n  /**\n   * Register a handler for a specific action\n   */\n  onAction(name: string, fn: ActionHandler<T>): this {\n    this.actionHandlers.set(name, fn);\n    return this;\n  }\n\n  /**\n   * Register a handler for module destruction\n   */\n  onDestroyed(fn: LifecycleHandler<T>): this {\n    this.destroyedHandler = fn;\n    return this;\n  }\n\n  /**\n   * Build the module definition\n   */\n  build(): HypenModuleDefinition<T> {\n    // Safe way to get keys from initialState\n    const stateKeys = this.initialState !== null && typeof this.initialState === 'object'\n      ? Object.keys(this.initialState)\n      : [];\n\n    return {\n      name: this.options.name,\n      actions: Array.from(this.actionHandlers.keys()),\n      stateKeys,\n      persist: this.options.persist,\n      version: this.options.version,\n      initialState: this.initialState,\n      handlers: {\n        onCreated: this.createdHandler,\n        onAction: this.actionHandlers,\n        onDestroyed: this.destroyedHandler,\n      },\n    };\n  }\n}\n\n/**\n * Hypen App API\n */\nexport class HypenApp {\n  /**\n   * Define the initial state for a module\n   */\n  defineState<T>(\n    initial: T,\n    options?: { persist?: boolean; version?: number; name?: string }\n  ): HypenAppBuilder<T> {\n    return new HypenAppBuilder(initial, options);\n  }\n}\n\n/**\n * The main app instance for creating modules\n */\nexport const app = new HypenApp();\n\n/**\n * Module Instance - manages a running module with typed state\n */\nexport class HypenModuleInstance<T extends object = any> {\n  private engine: IEngine;\n  private definition: HypenModuleDefinition<T>;\n  private state: T;\n  private isDestroyed = false;\n  private routerContext?: RouterContext;\n  private globalContext?: HypenGlobalContext;\n  private stateChangeCallbacks: Array<() => void> = [];\n\n  constructor(\n    engine: IEngine,\n    definition: HypenModuleDefinition<T>,\n    routerContext?: RouterContext,\n    globalContext?: HypenGlobalContext\n  ) {\n    this.engine = engine;\n    this.definition = definition;\n    this.routerContext = routerContext;\n    this.globalContext = globalContext;\n\n    // Create observable state that sends only changed paths and values to engine\n    this.state = createObservableState<T>(definition.initialState as T & object, {\n      onChange: (change: StateChange) => {\n        // Send only the changed paths and their new values (not the whole state)\n        this.engine.notifyStateChange(change.paths, change.newValues);\n        // Notify all registered callbacks\n        this.stateChangeCallbacks.forEach(cb => cb());\n      },\n    });\n\n    // Register with engine (initial state registration)\n    this.engine.setModule(\n      definition.name || \"AnonymousModule\",\n      definition.actions,\n      definition.stateKeys,\n      getStateSnapshot(this.state)\n    );\n\n    // Register action handlers with flexible parameter support\n    for (const [actionName, handler] of definition.handlers.onAction) {\n      console.log(`[ModuleInstance] Registering action handler: ${actionName} for module ${definition.name}`);\n      this.engine.onAction(actionName, async (action: Action) => {\n        console.log(`[ModuleInstance] Action handler fired: ${actionName}`, action);\n\n        const actionCtx: ActionContext = {\n          name: action.name,\n          payload: action.payload,\n          sender: action.sender,\n        };\n\n        const next: ActionNext = {\n          router: this.routerContext?.root || (null as any),\n        };\n\n        const context: GlobalContext | undefined = this.globalContext\n          ? this.createGlobalContextAPI()\n          : undefined;\n\n        try {\n          await handler({\n            action: actionCtx,\n            state: this.state,\n            next,\n            context: context!,\n          });\n          console.log(`[ModuleInstance] Action handler completed: ${actionName}`);\n        } catch (error) {\n          console.error(`[ModuleInstance] Action handler error for ${actionName}:`, error);\n        }\n      });\n    }\n\n    // Call onCreated\n    this.callCreatedHandler();\n  }\n\n  /**\n   * Create the global context API for this module\n   */\n  private createGlobalContextAPI(): GlobalContext {\n    if (!this.globalContext) {\n      throw new Error(\"Global context not available\");\n    }\n\n    const ctx = this.globalContext;\n    const api: GlobalContext = {\n      getModule: (id: string) => ctx.getModule(id),\n      hasModule: (id: string) => ctx.hasModule(id),\n      getModuleIds: () => ctx.getModuleIds(),\n      getGlobalState: () => ctx.getGlobalState(),\n      emit: (event: string, payload?: any) => ctx.emit(event, payload),\n      on: (event: string, handler: (payload?: any) => void) =>\n        ctx.on(event, handler),\n    };\n\n    // Expose router and hypen engine for built-in components (if available)\n    if ((ctx as any).__router) {\n      api.__router = (ctx as any).__router;\n    }\n    if ((ctx as any).__hypenEngine) {\n      (api as any).__hypenEngine = (ctx as any).__hypenEngine;\n    }\n\n    return api;\n  }\n\n  /**\n   * Call the onCreated handler\n   */\n  private async callCreatedHandler(): Promise<void> {\n    if (this.definition.handlers.onCreated) {\n      const context = this.globalContext ? this.createGlobalContextAPI() : undefined;\n      await this.definition.handlers.onCreated(this.state, context);\n    }\n  }\n\n  /**\n   * Register a callback to be notified when state changes\n   */\n  onStateChange(callback: () => void): void {\n    this.stateChangeCallbacks.push(callback);\n  }\n\n  /**\n   * Destroy the module instance\n   */\n  async destroy(): Promise<void> {\n    if (this.isDestroyed) return;\n\n    if (this.definition.handlers.onDestroyed) {\n      await this.definition.handlers.onDestroyed(this.state);\n    }\n\n    this.isDestroyed = true;\n  }\n\n  /**\n   * Get the current state (returns a snapshot)\n   */\n  getState(): T {\n    return getStateSnapshot(this.state);\n  }\n\n  /**\n   * Get the live observable state\n   */\n  getLiveState(): T {\n    return this.state;\n  }\n\n  /**\n   * Update state directly (merges with existing state)\n   */\n  updateState(patch: Partial<T>): void {\n    Object.assign(this.state, patch);\n  }\n}\n"
+    "/**\n * Hypen App Builder API\n * Implements the stateful module system from RFC-0001\n */\n\nimport type { Action } from \"./engine.js\";\n\n// Interface for engine compatibility (works with both engine.js and engine.browser.js)\nexport interface IEngine {\n  setModule(name: string, actions: string[], stateKeys: string[], initialState: unknown): void;\n  onAction(actionName: string, handler: (action: Action) => void | Promise<void>): void;\n  notifyStateChange(paths: string[], changedValues: Record<string, unknown>): void;\n}\n\nimport { createObservableState, type StateChange, getStateSnapshot } from \"./state.js\";\nimport type { HypenRouter } from \"./router.js\";\nimport type { HypenGlobalContext, ModuleReference } from \"./context.js\";\n\nexport type RouterContext = {\n  root: HypenRouter;\n  current?: HypenRouter;\n  parent?: HypenRouter;\n};\n\nexport type ActionContext = {\n  name: string;\n  payload?: unknown;\n  sender?: string;\n};\n\nexport type ActionNext = {\n  router: HypenRouter; // Direct access to router instance (from nearest parent)\n};\n\nexport type GlobalContext = {\n  getModule: <T = unknown>(id: string) => ModuleReference<T>;\n  hasModule: (id: string) => boolean;\n  getModuleIds: () => string[];\n  getGlobalState: () => Record<string, unknown>;\n  emit: (event: string, payload?: unknown) => void;\n  on: (event: string, handler: (payload?: unknown) => void) => () => void;\n  __router?: unknown; // Internal: router instance for built-in Router component\n};\n\nexport type LifecycleHandler<T> = (\n  state: T,\n  context?: GlobalContext\n) => void | Promise<void>;\n\n/**\n * Action handler context - all parameters available explicitly\n */\nexport interface ActionHandlerContext<T> {\n  action: ActionContext;\n  state: T;\n  next: ActionNext;\n  context: GlobalContext;\n}\n\n/**\n * Action handler - receives all context in a single object\n */\nexport type ActionHandler<T> = (ctx: ActionHandlerContext<T>) => void | Promise<void>;\n\nexport interface HypenModuleDefinition<T = unknown> {\n  name?: string;\n  actions: string[];\n  stateKeys: string[];\n  persist?: boolean;\n  version?: number;\n  initialState: T;\n  handlers: {\n    onCreated?: LifecycleHandler<T>;\n    onAction: Map<string, ActionHandler<T>>;\n    onDestroyed?: LifecycleHandler<T>;\n  };\n}\n\n/**\n * Alias for HypenModuleDefinition for backward compatibility\n */\nexport type HypenModule<T = unknown> = HypenModuleDefinition<T>;\n\n/**\n * Builder for creating Hypen app modules\n */\nexport class HypenAppBuilder<T> {\n  private initialState: T;\n  private options: { persist?: boolean; version?: number; name?: string };\n  private createdHandler?: LifecycleHandler<T>;\n  private actionHandlers: Map<string, ActionHandler<T>> = new Map();\n  private destroyedHandler?: LifecycleHandler<T>;\n\n  constructor(\n    initialState: T,\n    options?: { persist?: boolean; version?: number; name?: string }\n  ) {\n    this.initialState = initialState;\n    this.options = options || {};\n  }\n\n  /**\n   * Register a handler for module creation\n   */\n  onCreated(fn: LifecycleHandler<T>): this {\n    this.createdHandler = fn;\n    return this;\n  }\n\n  /**\n   * Register a handler for a specific action\n   */\n  onAction(name: string, fn: ActionHandler<T>): this {\n    this.actionHandlers.set(name, fn);\n    return this;\n  }\n\n  /**\n   * Register a handler for module destruction\n   */\n  onDestroyed(fn: LifecycleHandler<T>): this {\n    this.destroyedHandler = fn;\n    return this;\n  }\n\n  /**\n   * Build the module definition\n   */\n  build(): HypenModuleDefinition<T> {\n    // Safe way to get keys from initialState\n    const stateKeys = this.initialState !== null && typeof this.initialState === 'object'\n      ? Object.keys(this.initialState)\n      : [];\n\n    return {\n      name: this.options.name,\n      actions: Array.from(this.actionHandlers.keys()),\n      stateKeys,\n      persist: this.options.persist,\n      version: this.options.version,\n      initialState: this.initialState,\n      handlers: {\n        onCreated: this.createdHandler,\n        onAction: this.actionHandlers,\n        onDestroyed: this.destroyedHandler,\n      },\n    };\n  }\n}\n\n/**\n * Hypen App API\n */\nexport class HypenApp {\n  /**\n   * Define the initial state for a module\n   */\n  defineState<T>(\n    initial: T,\n    options?: { persist?: boolean; version?: number; name?: string }\n  ): HypenAppBuilder<T> {\n    return new HypenAppBuilder(initial, options);\n  }\n}\n\n/**\n * The main app instance for creating modules\n */\nexport const app = new HypenApp();\n\n/**\n * Module Instance - manages a running module with typed state\n */\nexport class HypenModuleInstance<T extends object = any> {\n  private engine: IEngine;\n  private definition: HypenModuleDefinition<T>;\n  private state: T;\n  private isDestroyed = false;\n  private routerContext?: RouterContext;\n  private globalContext?: HypenGlobalContext;\n  private stateChangeCallbacks: Array<() => void> = [];\n\n  constructor(\n    engine: IEngine,\n    definition: HypenModuleDefinition<T>,\n    routerContext?: RouterContext,\n    globalContext?: HypenGlobalContext\n  ) {\n    this.engine = engine;\n    this.definition = definition;\n    this.routerContext = routerContext;\n    this.globalContext = globalContext;\n\n    // Create observable state that sends only changed paths and values to engine\n    this.state = createObservableState<T>(definition.initialState as T & object, {\n      onChange: (change: StateChange) => {\n        // Send only the changed paths and their new values (not the whole state)\n        this.engine.notifyStateChange(change.paths, change.newValues);\n        // Notify all registered callbacks\n        this.stateChangeCallbacks.forEach(cb => cb());\n      },\n    });\n\n    // Register with engine (initial state registration)\n    this.engine.setModule(\n      definition.name || \"AnonymousModule\",\n      definition.actions,\n      definition.stateKeys,\n      getStateSnapshot(this.state)\n    );\n\n    // Register action handlers with flexible parameter support\n    for (const [actionName, handler] of definition.handlers.onAction) {\n      console.log(`[ModuleInstance] Registering action handler: ${actionName} for module ${definition.name}`);\n      this.engine.onAction(actionName, async (action: Action) => {\n        console.log(`[ModuleInstance] Action handler fired: ${actionName}`, action);\n\n        const actionCtx: ActionContext = {\n          name: action.name,\n          payload: action.payload,\n          sender: action.sender,\n        };\n\n        const next: ActionNext = {\n          router: this.routerContext?.root || (null as any),\n        };\n\n        const context: GlobalContext | undefined = this.globalContext\n          ? this.createGlobalContextAPI()\n          : undefined;\n\n        try {\n          await handler({\n            action: actionCtx,\n            state: this.state,\n            next,\n            context: context!,\n          });\n          console.log(`[ModuleInstance] Action handler completed: ${actionName}`);\n        } catch (error) {\n          console.error(`[ModuleInstance] Action handler error for ${actionName}:`, error);\n          throw error; // Re-throw to allow callers to handle the error\n        }\n      });\n    }\n\n    // Call onCreated\n    this.callCreatedHandler();\n  }\n\n  /**\n   * Create the global context API for this module\n   */\n  private createGlobalContextAPI(): GlobalContext {\n    if (!this.globalContext) {\n      throw new Error(\"Global context not available\");\n    }\n\n    const ctx = this.globalContext;\n    const api: GlobalContext = {\n      getModule: (id: string) => ctx.getModule(id),\n      hasModule: (id: string) => ctx.hasModule(id),\n      getModuleIds: () => ctx.getModuleIds(),\n      getGlobalState: () => ctx.getGlobalState(),\n      emit: (event: string, payload?: any) => ctx.emit(event, payload),\n      on: (event: string, handler: (payload?: any) => void) =>\n        ctx.on(event, handler),\n    };\n\n    // Expose router and hypen engine for built-in components (if available)\n    if ((ctx as any).__router) {\n      api.__router = (ctx as any).__router;\n    }\n    if ((ctx as any).__hypenEngine) {\n      (api as any).__hypenEngine = (ctx as any).__hypenEngine;\n    }\n\n    return api;\n  }\n\n  /**\n   * Call the onCreated handler\n   */\n  private async callCreatedHandler(): Promise<void> {\n    if (this.definition.handlers.onCreated) {\n      const context = this.globalContext ? this.createGlobalContextAPI() : undefined;\n      await this.definition.handlers.onCreated(this.state, context);\n    }\n  }\n\n  /**\n   * Register a callback to be notified when state changes\n   */\n  onStateChange(callback: () => void): void {\n    this.stateChangeCallbacks.push(callback);\n  }\n\n  /**\n   * Destroy the module instance\n   */\n  async destroy(): Promise<void> {\n    if (this.isDestroyed) return;\n\n    if (this.definition.handlers.onDestroyed) {\n      await this.definition.handlers.onDestroyed(this.state);\n    }\n\n    this.isDestroyed = true;\n  }\n\n  /**\n   * Get the current state (returns a snapshot)\n   */\n  getState(): T {\n    return getStateSnapshot(this.state);\n  }\n\n  /**\n   * Get the live observable state\n   */\n  getLiveState(): T {\n    return this.state;\n  }\n\n  /**\n   * Update state directly (merges with existing state)\n   */\n  updateState(patch: Partial<T>): void {\n    Object.assign(this.state, patch);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "220ACA4FDA4DC86164756E2164756E21",
+  "mappings": "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",
+  "debugId": "CC570FF56ABF0FB064756E2164756E21",
   "names": []
 }

package/dist/src/engine.browser.js

@@ -31,9 +31,9 @@ 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/hypen_engine.js");
+      const wasmModule = await import("../wasm-browser/hypen_engine.js");
       wasmInit = wasmModule.default;
       WasmEngineClass = wasmModule.WasmEngine;
       await wasmInit(wasmPath);
@@ -127,4 +127,4 @@ export {
 
 export { Engine };
 
-//# debugId=FB3794C86EF3E0CF64756E2164756E21
+//# 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/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": "FB3794C86EF3E0CF64756E2164756E21",
+  "mappings": "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",
+  "debugId": "CA54F8DFEBB008F764756E2164756E21",
   "names": []
 }

package/dist/src/engine.js

@@ -1,7 +1,7 @@
 import"../chunk-5va59f7m.js";
 
 // src/engine.ts
-import { WasmEngine } from "../wasm/hypen_engine.js";
+import { WasmEngine } from "../wasm-node/hypen_engine.js";
 
 class Engine {
   wasmEngine = null;
@@ -49,7 +49,8 @@ class Engine {
     if (paths.length === 0) {
       return;
     }
-    engine.updateStateSparse(paths, values);
+    const plainValues = JSON.parse(JSON.stringify(values));
+    engine.updateStateSparse(paths, plainValues);
     console.debug("[Hypen] State changed (sparse):", paths);
   }
   notifyStateChangeFull(paths, currentState) {
@@ -98,4 +99,4 @@ export {
 
 export { Engine };
 
-//# debugId=9CDE98592668DEA364756E2164756E21
+//# debugId=D2189D9A62B205BE64756E2164756E21

package/dist/src/engine.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/engine.ts"],
   "sourcesContent": [
-    "/**\n * Low-level wrapper around the WASM engine\n * Node.js / Bundler target\n */\n\n// WASM module types\nimport { WasmEngine } from \"../wasm/hypen_engine.js\";\n\nexport type Patch = {\n  type: \"create\" | \"setProp\" | \"setText\" | \"insert\" | \"move\" | \"remove\" | \"attachEvent\" | \"detachEvent\";\n  id?: string;\n  elementType?: string;\n  props?: Record<string, any>;\n  name?: string;\n  value?: any;\n  text?: string;\n  parentId?: string;\n  beforeId?: string;\n  eventName?: 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\n/**\n * Engine wraps the WASM engine and provides a TypeScript-friendly API\n */\nexport class Engine {\n  private wasmEngine: WasmEngine | null = null;\n  private initialized = false;\n\n  /**\n   * Initialize the WASM module\n   */\n  async init(): Promise<void> {\n    if (this.initialized) return;\n\n    // For bundler target, WASM is auto-initialized\n    this.wasmEngine = new WasmEngine();\n    this.initialized = true;\n  }\n\n  /**\n   * Ensure the engine is initialized before operations\n   */\n  private ensureInitialized(): WasmEngine {\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 using sparse updates\n   */\n  notifyStateChange(paths: string[], values: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n\n    if (paths.length === 0) {\n      return;\n    }\n\n    engine.updateStateSparse(paths, values);\n    console.debug(\"[Hypen] State changed (sparse):\", paths);\n  }\n\n  /**\n   * Notify the engine of state changes using full state replacement\n   * @deprecated Use notifyStateChange with sparse values instead\n   */\n  notifyStateChangeFull(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 (full):\", 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    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      Promise.resolve(handler(action)).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(): number {\n    const engine = this.ensureInitialized();\n    return Number(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 * Low-level wrapper around the WASM engine\n * Node.js / Bundler target\n */\n\n// WASM module types\nimport { WasmEngine } from \"../wasm-node/hypen_engine.js\";\n\nexport type Patch = {\n  type: \"create\" | \"setProp\" | \"setText\" | \"insert\" | \"move\" | \"remove\" | \"attachEvent\" | \"detachEvent\";\n  id?: string;\n  elementType?: string;\n  props?: Record<string, any>;\n  name?: string;\n  value?: any;\n  text?: string;\n  parentId?: string;\n  beforeId?: string;\n  eventName?: 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\n/**\n * Engine wraps the WASM engine and provides a TypeScript-friendly API\n */\nexport class Engine {\n  private wasmEngine: WasmEngine | null = null;\n  private initialized = false;\n\n  /**\n   * Initialize the WASM module\n   */\n  async init(): Promise<void> {\n    if (this.initialized) return;\n\n    // For bundler target, WASM is auto-initialized\n    this.wasmEngine = new WasmEngine();\n    this.initialized = true;\n  }\n\n  /**\n   * Ensure the engine is initialized before operations\n   */\n  private ensureInitialized(): WasmEngine {\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 using sparse updates\n   */\n  notifyStateChange(paths: string[], values: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n\n    if (paths.length === 0) {\n      return;\n    }\n\n    // Clone values to prevent proxy objects from causing issues\n    const plainValues = JSON.parse(JSON.stringify(values));\n    engine.updateStateSparse(paths, plainValues);\n    console.debug(\"[Hypen] State changed (sparse):\", paths);\n  }\n\n  /**\n   * Notify the engine of state changes using full state replacement\n   * @deprecated Use notifyStateChange with sparse values instead\n   */\n  notifyStateChangeFull(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 (full):\", 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    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      Promise.resolve(handler(action)).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(): number {\n    const engine = this.ensureInitialized();\n    return Number(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": "9CDE98592668DEA364756E2164756E21",
+  "mappings": "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",
+  "debugId": "D2189D9A62B205BE64756E2164756E21",
   "names": []
 }

package/dist/src/index.js

@@ -1,18 +1,26 @@
+import {
+  defaultHypenPlugin,
+  hypenPlugin,
+  registerHypenPlugin
+} from "./plugin.js";
+import {
+  Link,
+  Route,
+  Router
+} from "./components/builtin.js";
 import {
   ComponentLoader,
   componentLoader
 } from "./loader.js";
+import {
+  ComponentResolver
+} from "./resolver.js";
 import {
   discoverComponents,
   generateComponentsCode,
   loadDiscoveredComponents,
   watchComponents
 } from "./discovery.js";
-import {
-  Link,
-  Route,
-  Router
-} from "./components/builtin.js";
 import {
   HypenGlobalContext
 } from "./context.js";
@@ -50,10 +58,13 @@ import {
 import"../chunk-5va59f7m.js";
 export {
   watchComponents,
+  registerHypenPlugin,
   loadDiscoveredComponents,
+  hypenPlugin,
   getStateSnapshot,
   generateComponentsCode,
   discoverComponents,
+  defaultHypenPlugin,
   createObservableState,
   createEventEmitter,
   componentLoader,
@@ -71,9 +82,10 @@ export {
   HypenApp,
   Engine,
   ConsoleRenderer,
+  ComponentResolver,
   ComponentLoader,
   Engine2 as BrowserEngine,
   BaseRenderer
 };
 
-//# debugId=239B565865634CFD64756E2164756E21
+//# debugId=24B2260C2FF7056064756E2164756E21

package/dist/src/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "239B565865634CFD64756E2164756E21",
+  "debugId": "24B2260C2FF7056064756E2164756E21",
   "names": []
 }

package/dist/src/plugin.js

@@ -0,0 +1,126 @@
+import"../chunk-5va59f7m.js";
+
+// src/plugin.ts
+import { readFileSync, existsSync } from "fs";
+import { dirname, basename, join, resolve } from "path";
+function findModulePath(hypenPath, patterns) {
+  const dir = dirname(hypenPath);
+  const baseName = basename(hypenPath, ".hypen");
+  const parentDir = dirname(dir);
+  const folderName = basename(dir);
+  for (const pattern of patterns) {
+    let candidatePath = null;
+    switch (pattern) {
+      case "sibling":
+        candidatePath = join(dir, `${baseName}.ts`);
+        break;
+      case "component":
+        if (baseName === "component") {
+          candidatePath = join(dir, "component.ts");
+        }
+        break;
+      case "index":
+        if (baseName === "index") {
+          candidatePath = join(dir, "index.ts");
+        }
+        break;
+    }
+    if (candidatePath && existsSync(candidatePath)) {
+      return candidatePath;
+    }
+  }
+  return null;
+}
+function getComponentName(hypenPath) {
+  const baseName = basename(hypenPath, ".hypen");
+  if (baseName === "component" || baseName === "index") {
+    return basename(dirname(hypenPath));
+  }
+  return baseName;
+}
+function parseImports(text) {
+  const imports = [];
+  const importRegex = /import\s+(?:\{([^}]+)\}|(\w+))\s+from\s+["']([^"']+)["']/g;
+  let match;
+  while ((match = importRegex.exec(text)) !== null) {
+    const [, namedImports, defaultImport, source] = match;
+    if (!source)
+      continue;
+    let names;
+    if (namedImports) {
+      names = namedImports.split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+    } else if (defaultImport) {
+      names = [defaultImport];
+    } else {
+      continue;
+    }
+    imports.push({ names, source });
+  }
+  return imports;
+}
+function removeImports(text) {
+  return text.replace(/import\s+(?:\{[^}]+\}|\w+)\s+from\s+["'][^"']+["']\s*/g, "");
+}
+function hypenPlugin(options = {}) {
+  const { debug = false, patterns = ["sibling", "component", "index"] } = options;
+  const log = debug ? (...args) => console.log("[hypen-plugin]", ...args) : () => {};
+  return {
+    name: "hypen-loader",
+    async setup(build) {
+      build.onLoad({ filter: /\.hypen$/ }, async (args) => {
+        const hypenPath = resolve(args.path);
+        log("Loading:", hypenPath);
+        const templateRaw = readFileSync(hypenPath, "utf-8");
+        const imports = parseImports(templateRaw);
+        const template = removeImports(templateRaw).trim();
+        if (imports.length > 0) {
+          log("Found imports:", imports);
+        }
+        const componentName = getComponentName(hypenPath);
+        log("Component name:", componentName);
+        const modulePath = findModulePath(hypenPath, patterns);
+        log("Module path:", modulePath);
+        let contents;
+        if (modulePath) {
+          const relativeModulePath = modulePath.replace(/\.ts$/, ".js");
+          contents = `
+import _module from "${relativeModulePath}";
+export const module = _module;
+export const template = ${JSON.stringify(template)};
+export const name = ${JSON.stringify(componentName)};
+export default { module: _module, template: ${JSON.stringify(template)}, name: ${JSON.stringify(componentName)} };
+`;
+        } else {
+          log("No module found, creating stateless component");
+          contents = `
+import { app } from "@hypen/core";
+const _module = app.defineState({}).build();
+export const module = _module;
+export const template = ${JSON.stringify(template)};
+export const name = ${JSON.stringify(componentName)};
+export default { module: _module, template: ${JSON.stringify(template)}, name: ${JSON.stringify(componentName)} };
+`;
+        }
+        return {
+          contents,
+          loader: "js"
+        };
+      });
+    }
+  };
+}
+var defaultHypenPlugin = hypenPlugin();
+function registerHypenPlugin(options) {
+  Bun.plugin(hypenPlugin(options));
+}
+var plugin_default = hypenPlugin;
+export {
+  registerHypenPlugin,
+  hypenPlugin,
+  defaultHypenPlugin,
+  plugin_default as default
+};
+
+export { hypenPlugin, defaultHypenPlugin, registerHypenPlugin };
+
+//# debugId=A60E27BFF37A4DE364756E2164756E21

package/dist/src/plugin.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/plugin.ts"],
+  "sourcesContent": [
+    "/**\n * Enhanced Bun Plugin for Hypen\n *\n * Automatically pairs .hypen templates with their TypeScript modules.\n *\n * Usage:\n *   import Counter from \"./Counter.hypen\";\n *   // Returns: { module, template, name: \"Counter\" }\n *\n * Supported conventions:\n *   1. Sibling: Name.ts + Name.hypen\n *   2. Folder: Name/component.ts + Name/component.hypen\n *   3. Index: Name/index.ts + Name/index.hypen\n */\n\nimport type { BunPlugin } from \"bun\";\nimport { readFileSync, existsSync } from \"fs\";\nimport { dirname, basename, join, resolve } from \"path\";\n\nexport interface HypenPluginOptions {\n  /**\n   * Enable debug logging\n   */\n  debug?: boolean;\n\n  /**\n   * Custom patterns for finding module files\n   * Default: [\"sibling\", \"component\", \"index\"]\n   */\n  patterns?: (\"sibling\" | \"component\" | \"index\")[];\n}\n\n/**\n * Find the matching TypeScript module for a .hypen file\n */\nfunction findModulePath(\n  hypenPath: string,\n  patterns: (\"sibling\" | \"component\" | \"index\")[]\n): string | null {\n  const dir = dirname(hypenPath);\n  const baseName = basename(hypenPath, \".hypen\");\n  const parentDir = dirname(dir);\n  const folderName = basename(dir);\n\n  for (const pattern of patterns) {\n    let candidatePath: string | null = null;\n\n    switch (pattern) {\n      case \"sibling\":\n        // Name.hypen -> Name.ts (same directory)\n        candidatePath = join(dir, `${baseName}.ts`);\n        break;\n\n      case \"component\":\n        // Name/component.hypen -> Name/component.ts\n        if (baseName === \"component\") {\n          candidatePath = join(dir, \"component.ts\");\n        }\n        break;\n\n      case \"index\":\n        // Name/index.hypen -> Name/index.ts\n        if (baseName === \"index\") {\n          candidatePath = join(dir, \"index.ts\");\n        }\n        break;\n    }\n\n    if (candidatePath && existsSync(candidatePath)) {\n      return candidatePath;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Determine the component name from the file path\n */\nfunction getComponentName(hypenPath: string): string {\n  const baseName = basename(hypenPath, \".hypen\");\n\n  // If file is component.hypen or index.hypen, use parent folder name\n  if (baseName === \"component\" || baseName === \"index\") {\n    return basename(dirname(hypenPath));\n  }\n\n  // Otherwise use the file name\n  return baseName;\n}\n\n/**\n * Parse import statements from Hypen DSL (for future use)\n */\nfunction parseImports(\n  text: string\n): Array<{ names: string[]; source: string }> {\n  const imports: Array<{ names: string[]; source: string }> = [];\n  const importRegex =\n    /import\\s+(?:\\{([^}]+)\\}|(\\w+))\\s+from\\s+[\"']([^\"']+)[\"']/g;\n\n  let match;\n  while ((match = importRegex.exec(text)) !== null) {\n    const [, namedImports, defaultImport, source] = match;\n\n    if (!source) continue;\n\n    let names: string[];\n    if (namedImports) {\n      names = namedImports\n        .split(\",\")\n        .map((n) => n.trim())\n        .filter((n) => n.length > 0);\n    } else if (defaultImport) {\n      names = [defaultImport];\n    } else {\n      continue;\n    }\n\n    imports.push({ names, source });\n  }\n\n  return imports;\n}\n\n/**\n * Remove import statements from Hypen template\n */\nfunction removeImports(text: string): string {\n  return text.replace(\n    /import\\s+(?:\\{[^}]+\\}|\\w+)\\s+from\\s+[\"'][^\"']+[\"']\\s*/g,\n    \"\"\n  );\n}\n\n/**\n * Create the enhanced Hypen plugin for Bun\n */\nexport function hypenPlugin(options: HypenPluginOptions = {}): BunPlugin {\n  const { debug = false, patterns = [\"sibling\", \"component\", \"index\"] } =\n    options;\n\n  const log = debug\n    ? (...args: unknown[]) => console.log(\"[hypen-plugin]\", ...args)\n    : () => {};\n\n  return {\n    name: \"hypen-loader\",\n    async setup(build) {\n      build.onLoad({ filter: /\\.hypen$/ }, async (args) => {\n        const hypenPath = resolve(args.path);\n        log(\"Loading:\", hypenPath);\n\n        // Read the template\n        const templateRaw = readFileSync(hypenPath, \"utf-8\");\n\n        // Parse and remove imports\n        const imports = parseImports(templateRaw);\n        const template = removeImports(templateRaw).trim();\n\n        if (imports.length > 0) {\n          log(\"Found imports:\", imports);\n        }\n\n        // Get component name\n        const componentName = getComponentName(hypenPath);\n        log(\"Component name:\", componentName);\n\n        // Find matching module\n        const modulePath = findModulePath(hypenPath, patterns);\n        log(\"Module path:\", modulePath);\n\n        let contents: string;\n\n        if (modulePath) {\n          // Has a TypeScript module - import it\n          const relativeModulePath = modulePath.replace(/\\.ts$/, \".js\");\n          contents = `\nimport _module from \"${relativeModulePath}\";\nexport const module = _module;\nexport const template = ${JSON.stringify(template)};\nexport const name = ${JSON.stringify(componentName)};\nexport default { module: _module, template: ${JSON.stringify(template)}, name: ${JSON.stringify(componentName)} };\n`;\n        } else {\n          // No TypeScript module - create stateless component\n          log(\"No module found, creating stateless component\");\n          contents = `\nimport { app } from \"@hypen/core\";\nconst _module = app.defineState({}).build();\nexport const module = _module;\nexport const template = ${JSON.stringify(template)};\nexport const name = ${JSON.stringify(componentName)};\nexport default { module: _module, template: ${JSON.stringify(template)}, name: ${JSON.stringify(componentName)} };\n`;\n        }\n\n        return {\n          contents,\n          loader: \"js\",\n        };\n      });\n    },\n  };\n}\n\n/**\n * Default plugin instance with standard options\n */\nexport const defaultHypenPlugin = hypenPlugin();\n\n/**\n * Register the plugin globally (call this in your preload file)\n */\nexport function registerHypenPlugin(options?: HypenPluginOptions): void {\n  Bun.plugin(hypenPlugin(options));\n}\n\nexport default hypenPlugin;\n"
+  ],
+  "mappings": "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",
+  "debugId": "A60E27BFF37A4DE364756E2164756E21",
+  "names": []
+}

package/dist/src/resolver.js

@@ -0,0 +1,102 @@
+import"../chunk-5va59f7m.js";
+
+// src/resolver.ts
+class ComponentResolver {
+  cache = new Map;
+  options;
+  constructor(options = {}) {
+    this.options = {
+      baseDir: options.baseDir || process.cwd(),
+      cache: options.cache ?? true,
+      customFetch: options.customFetch || this.defaultFetch.bind(this)
+    };
+  }
+  async resolve(importStmt) {
+    const sourcePath = this.getSourcePath(importStmt.source);
+    if (this.options.cache && this.cache.has(sourcePath)) {
+      const cached = this.cache.get(sourcePath);
+      return this.extractComponents(importStmt.clause, cached);
+    }
+    let component;
+    if (importStmt.source.type === "local") {
+      component = await this.resolveLocal(importStmt.source.path);
+    } else {
+      component = await this.resolveUrl(importStmt.source.url);
+    }
+    if (this.options.cache) {
+      this.cache.set(sourcePath, component);
+    }
+    return this.extractComponents(importStmt.clause, component);
+  }
+  async resolveLocal(path) {
+    throw new Error(`Dynamic local component resolution not yet implemented: ${path}
+` + `Please use the build-components.ts script to generate component imports.`);
+  }
+  async resolveUrl(url) {
+    try {
+      const response = await this.options.customFetch(url);
+      const data = JSON.parse(response);
+      if (!data.module || !data.template) {
+        throw new Error(`Invalid component format from ${url}. Expected { module, template }`);
+      }
+      return data;
+    } catch (error) {
+      throw new Error(`Failed to resolve component from ${url}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  async defaultFetch(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    return response.text();
+  }
+  extractComponents(clause, component) {
+    if (clause.type === "default") {
+      return {
+        [clause.name]: component
+      };
+    } else {
+      const result = {};
+      for (const name of clause.names) {
+        result[name] = component;
+      }
+      return result;
+    }
+  }
+  getSourcePath(source) {
+    return source.type === "local" ? source.path : source.url;
+  }
+  clearCache() {
+    this.cache.clear();
+  }
+  static parseImports(text) {
+    const imports = [];
+    const importRegex = /import\s+(?:(\{[^}]*\})|(\w+))\s+from\s+["']([^"']+)["']/g;
+    let match;
+    while ((match = importRegex.exec(text)) !== null) {
+      const [, namedImports, defaultImport, source] = match;
+      if (!source)
+        continue;
+      let clause;
+      if (namedImports) {
+        const names = namedImports.slice(1, -1).split(",").map((n) => n.trim()).filter((n) => n.length > 0);
+        clause = { type: "named", names };
+      } else if (defaultImport) {
+        clause = { type: "default", name: defaultImport };
+      } else {
+        continue;
+      }
+      const sourceObj = source.startsWith("http://") || source.startsWith("https://") ? { type: "url", url: source } : { type: "local", path: source };
+      imports.push({ clause, source: sourceObj });
+    }
+    return imports;
+  }
+}
+export {
+  ComponentResolver
+};
+
+export { ComponentResolver };
+
+//# debugId=8F467B070CF9702464756E2164756E21

package/dist/src/resolver.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/resolver.ts"],
+  "sourcesContent": [
+    "/**\n * Component Resolver\n * Resolves component imports from local paths or web URLs\n */\n\nexport interface ImportStatement {\n  clause: ImportClause;\n  source: ImportSource;\n}\n\nexport type ImportClause =\n  | { type: \"named\"; names: string[] }\n  | { type: \"default\"; name: string };\n\nexport type ImportSource =\n  | { type: \"local\"; path: string }\n  | { type: \"url\"; url: string };\n\nexport interface ComponentDefinition {\n  module: any;\n  template: string;\n}\n\nexport interface ResolverOptions {\n  /**\n   * Base directory for resolving relative local paths\n   * Defaults to current working directory\n   */\n  baseDir?: string;\n\n  /**\n   * Cache resolved components to avoid re-fetching\n   * Defaults to true\n   */\n  cache?: boolean;\n\n  /**\n   * Custom fetch function for URL imports\n   * Useful for adding authentication, custom headers, etc.\n   */\n  customFetch?: (url: string) => Promise<string>;\n}\n\n/**\n * Component Resolver\n * Resolves and loads components from local files or remote URLs\n */\nexport class ComponentResolver {\n  private cache = new Map<string, ComponentDefinition>();\n  private options: Required<ResolverOptions>;\n\n  constructor(options: ResolverOptions = {}) {\n    this.options = {\n      baseDir: options.baseDir || process.cwd(),\n      cache: options.cache ?? true,\n      customFetch: options.customFetch || this.defaultFetch.bind(this),\n    };\n  }\n\n  /**\n   * Resolve a component from an import statement\n   */\n  async resolve(\n    importStmt: ImportStatement\n  ): Promise<Record<string, ComponentDefinition>> {\n    const sourcePath = this.getSourcePath(importStmt.source);\n\n    // Check cache first\n    if (this.options.cache && this.cache.has(sourcePath)) {\n      const cached = this.cache.get(sourcePath)!;\n      return this.extractComponents(importStmt.clause, cached);\n    }\n\n    // Load the component\n    let component: ComponentDefinition;\n    if (importStmt.source.type === \"local\") {\n      component = await this.resolveLocal(importStmt.source.path);\n    } else {\n      component = await this.resolveUrl(importStmt.source.url);\n    }\n\n    // Cache it\n    if (this.options.cache) {\n      this.cache.set(sourcePath, component);\n    }\n\n    return this.extractComponents(importStmt.clause, component);\n  }\n\n  /**\n   * Resolve a component from a local file path\n   */\n  private async resolveLocal(path: string): Promise<ComponentDefinition> {\n    // For local paths, we expect the build system to have already\n    // processed them into the generated components file\n    // This is a fallback for dynamic resolution\n    throw new Error(\n      `Dynamic local component resolution not yet implemented: ${path}\\n` +\n        `Please use the build-components.ts script to generate component imports.`\n    );\n  }\n\n  /**\n   * Resolve a component from a URL\n   */\n  private async resolveUrl(url: string): Promise<ComponentDefinition> {\n    try {\n      const response = await this.options.customFetch(url);\n      const data = JSON.parse(response);\n\n      // Expected format: { module: {...}, template: \"...\" }\n      if (!data.module || !data.template) {\n        throw new Error(\n          `Invalid component format from ${url}. Expected { module, template }`\n        );\n      }\n\n      return data;\n    } catch (error) {\n      throw new Error(\n        `Failed to resolve component from ${url}: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Default fetch implementation\n   */\n  private async defaultFetch(url: string): Promise<string> {\n    const response = await fetch(url);\n    if (!response.ok) {\n      throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n    return response.text();\n  }\n\n  /**\n   * Extract the requested components based on the import clause\n   */\n  private extractComponents(\n    clause: ImportClause,\n    component: ComponentDefinition\n  ): Record<string, ComponentDefinition> {\n    if (clause.type === \"default\") {\n      return {\n        [clause.name]: component,\n      };\n    } else {\n      // Named imports - for now, we only support single exports\n      // In the future, we could support exporting multiple components\n      // from a single file\n      const result: Record<string, ComponentDefinition> = {};\n      for (const name of clause.names) {\n        result[name] = component;\n      }\n      return result;\n    }\n  }\n\n  /**\n   * Get the source path as a string (for caching)\n   */\n  private getSourcePath(source: ImportSource): string {\n    return source.type === \"local\" ? source.path : source.url;\n  }\n\n  /**\n   * Clear the component cache\n   */\n  clearCache(): void {\n    this.cache.clear();\n  }\n\n  /**\n   * Parse import statements from Hypen DSL text\n   * This is a simple parser that extracts import statements\n   */\n  static parseImports(text: string): ImportStatement[] {\n    const imports: ImportStatement[] = [];\n    const importRegex =\n      /import\\s+(?:(\\{[^}]*\\})|(\\w+))\\s+from\\s+[\"']([^\"']+)[\"']/g;\n\n    let match;\n    while ((match = importRegex.exec(text)) !== null) {\n      const [, namedImports, defaultImport, source] = match;\n\n      if (!source) continue;\n\n      let clause: ImportClause;\n      if (namedImports) {\n        // Named imports: { Button, Card }\n        const names = namedImports\n          .slice(1, -1) // Remove { and }\n          .split(\",\")\n          .map((n) => n.trim())\n          .filter((n) => n.length > 0);\n        clause = { type: \"named\", names };\n      } else if (defaultImport) {\n        // Default import: HomePage\n        clause = { type: \"default\", name: defaultImport };\n      } else {\n        continue;\n      }\n\n      // Determine if source is URL or local path\n      const sourceObj: ImportSource = source.startsWith(\"http://\") ||\n        source.startsWith(\"https://\")\n        ? { type: \"url\", url: source }\n        : { type: \"local\", path: source };\n\n      imports.push({ clause, source: sourceObj });\n    }\n\n    return imports;\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "8F467B070CF9702464756E2164756E21",
+  "names": []
+}