@hypen-space/core 0.4.3 → 0.4.5

package/dist/engine.js.map

@@ -1,11 +1,12 @@
 {
   "version": 3,
-  "sources": ["../src/logger.ts", "../src/engine.ts"],
+  "sources": ["../src/logger.ts", "../src/result.ts", "../src/engine.ts"],
   "sourcesContent": [
     "/**\n * Configurable Debug Logger\n *\n * Provides environment-aware logging that can be disabled in production.\n * Supports log levels, tagged output, and performance timing.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\nexport interface LoggerConfig {\n  /** Minimum log level (default: \"debug\" in dev, \"error\" in prod) */\n  level: LogLevel;\n  /** Enable colored output (default: true) */\n  colors: boolean;\n  /** Include timestamps (default: false) */\n  timestamps: boolean;\n  /** Custom log handler (default: console) */\n  handler?: LogHandler;\n}\n\nexport interface LogHandler {\n  debug(tag: string, ...args: unknown[]): void;\n  info(tag: string, ...args: unknown[]): void;\n  warn(tag: string, ...args: unknown[]): void;\n  error(tag: string, ...args: unknown[]): void;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst LOG_LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  none: 4,\n};\n\nconst LOG_LEVEL_COLORS: Record<Exclude<LogLevel, \"none\">, string> = {\n  debug: \"\\x1b[36m\", // Cyan\n  info: \"\\x1b[32m\",  // Green\n  warn: \"\\x1b[33m\",  // Yellow\n  error: \"\\x1b[31m\", // Red\n};\n\nconst RESET_COLOR = \"\\x1b[0m\";\n\n// ============================================================================\n// Global Configuration\n// ============================================================================\n\n/**\n * Detect if running in production environment\n */\nfunction isProduction(): boolean {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env.NODE_ENV === \"production\";\n  }\n  return false;\n}\n\n/**\n * Default configuration\n */\nlet config: LoggerConfig = {\n  level: isProduction() ? \"error\" : \"debug\",\n  colors: true,\n  timestamps: false,\n};\n\n// ============================================================================\n// Configuration API\n// ============================================================================\n\n/**\n * Set the global log level\n */\nexport function setLogLevel(level: LogLevel): void {\n  config.level = level;\n}\n\n/**\n * Get the current log level\n */\nexport function getLogLevel(): LogLevel {\n  return config.level;\n}\n\n/**\n * Configure the logger\n */\nexport function configureLogger(options: Partial<LoggerConfig>): void {\n  config = { ...config, ...options };\n}\n\n/**\n * Enable all logging (sets level to \"debug\")\n */\nexport function enableLogging(): void {\n  config.level = \"debug\";\n}\n\n/**\n * Disable all logging (sets level to \"none\")\n */\nexport function disableLogging(): void {\n  config.level = \"none\";\n}\n\n/**\n * Enable debug mode - alias for enableLogging()\n * Call this at app startup to see all debug logs\n *\n * @example\n * ```typescript\n * import { setDebugMode } from \"@hypen-space/core\";\n * setDebugMode(true);\n * ```\n */\nexport function setDebugMode(enabled: boolean): void {\n  config.level = enabled ? \"debug\" : \"error\";\n}\n\n/**\n * Check if debug mode is enabled\n */\nexport function isDebugMode(): boolean {\n  return config.level === \"debug\";\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\nfunction shouldLog(level: LogLevel): boolean {\n  return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[config.level];\n}\n\nfunction formatTag(tag: string, level: LogLevel): string {\n  const timestamp = config.timestamps ? `${new Date().toISOString()} ` : \"\";\n\n  if (config.colors && level !== \"none\") {\n    const color = LOG_LEVEL_COLORS[level as Exclude<LogLevel, \"none\">];\n    return `${timestamp}${color}[${tag}]${RESET_COLOR}`;\n  }\n\n  return `${timestamp}[${tag}]`;\n}\n\n// ============================================================================\n// Logger Class\n// ============================================================================\n\n/**\n * Tagged logger instance\n *\n * @example\n * ```typescript\n * const log = createLogger(\"MyComponent\");\n * log.debug(\"initialized with\", { props });\n * log.error(\"failed to load\", error);\n * ```\n */\nexport class Logger {\n  private readonly tag: string;\n\n  constructor(tag: string) {\n    this.tag = tag;\n  }\n\n  debug(...args: unknown[]): void {\n    if (!shouldLog(\"debug\")) return;\n\n    if (config.handler) {\n      config.handler.debug(this.tag, ...args);\n    } else {\n      console.log(formatTag(this.tag, \"debug\"), ...args);\n    }\n  }\n\n  info(...args: unknown[]): void {\n    if (!shouldLog(\"info\")) return;\n\n    if (config.handler) {\n      config.handler.info(this.tag, ...args);\n    } else {\n      console.info(formatTag(this.tag, \"info\"), ...args);\n    }\n  }\n\n  warn(...args: unknown[]): void {\n    if (!shouldLog(\"warn\")) return;\n\n    if (config.handler) {\n      config.handler.warn(this.tag, ...args);\n    } else {\n      console.warn(formatTag(this.tag, \"warn\"), ...args);\n    }\n  }\n\n  error(...args: unknown[]): void {\n    if (!shouldLog(\"error\")) return;\n\n    if (config.handler) {\n      config.handler.error(this.tag, ...args);\n    } else {\n      console.error(formatTag(this.tag, \"error\"), ...args);\n    }\n  }\n\n  /**\n   * Time a function execution\n   */\n  time<T>(label: string, fn: () => T): T {\n    if (!shouldLog(\"debug\")) {\n      return fn();\n    }\n\n    const start = performance.now();\n    try {\n      return fn();\n    } finally {\n      const duration = performance.now() - start;\n      this.debug(`${label}: ${duration.toFixed(2)}ms`);\n    }\n  }\n\n  /**\n   * Time an async function execution\n   */\n  async timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T> {\n    if (!shouldLog(\"debug\")) {\n      return fn();\n    }\n\n    const start = performance.now();\n    try {\n      return await fn();\n    } finally {\n      const duration = performance.now() - start;\n      this.debug(`${label}: ${duration.toFixed(2)}ms`);\n    }\n  }\n\n  /**\n   * Create a child logger with additional context\n   */\n  child(subTag: string): Logger {\n    return new Logger(`${this.tag}:${subTag}`);\n  }\n\n  /**\n   * Conditionally log based on a condition\n   */\n  debugIf(condition: boolean, ...args: unknown[]): void {\n    if (condition) this.debug(...args);\n  }\n\n  warnIf(condition: boolean, ...args: unknown[]): void {\n    if (condition) this.warn(...args);\n  }\n\n  errorIf(condition: boolean, ...args: unknown[]): void {\n    if (condition) this.error(...args);\n  }\n\n  /**\n   * Log once (useful for deprecation warnings)\n   */\n  private loggedOnce = new Set<string>();\n\n  warnOnce(key: string, ...args: unknown[]): void {\n    if (this.loggedOnce.has(key)) return;\n    this.loggedOnce.add(key);\n    this.warn(...args);\n  }\n\n  debugOnce(key: string, ...args: unknown[]): void {\n    if (this.loggedOnce.has(key)) return;\n    this.loggedOnce.add(key);\n    this.debug(...args);\n  }\n}\n\n// ============================================================================\n// Factory Functions\n// ============================================================================\n\n/**\n * Create a tagged logger\n *\n * @example\n * ```typescript\n * const log = createLogger(\"Router\");\n * log.info(\"navigating to\", path);\n * ```\n */\nexport function createLogger(tag: string): Logger {\n  return new Logger(tag);\n}\n\n// ============================================================================\n// Default Logger Instance\n// ============================================================================\n\n/**\n * Default logger for general use\n */\nexport const logger = createLogger(\"Hypen\");\n\n// ============================================================================\n// Shorthand Functions (untagged)\n// ============================================================================\n\n/**\n * Shorthand logging functions for quick use\n * Prefer createLogger() for component-specific logging\n */\nexport const log = {\n  debug: (tag: string, ...args: unknown[]): void => {\n    if (!shouldLog(\"debug\")) return;\n    console.log(formatTag(tag, \"debug\"), ...args);\n  },\n\n  info: (tag: string, ...args: unknown[]): void => {\n    if (!shouldLog(\"info\")) return;\n    console.info(formatTag(tag, \"info\"), ...args);\n  },\n\n  warn: (tag: string, ...args: unknown[]): void => {\n    if (!shouldLog(\"warn\")) return;\n    console.warn(formatTag(tag, \"warn\"), ...args);\n  },\n\n  error: (tag: string, ...args: unknown[]): void => {\n    if (!shouldLog(\"error\")) return;\n    console.error(formatTag(tag, \"error\"), ...args);\n  },\n};\n\n// ============================================================================\n// Predefined Loggers for Framework Components\n// ============================================================================\n\nexport const frameworkLoggers = {\n  hypen: createLogger(\"Hypen\"),\n  engine: createLogger(\"Engine\"),\n  router: createLogger(\"Router\"),\n  state: createLogger(\"State\"),\n  events: createLogger(\"Events\"),\n  remote: createLogger(\"Remote\"),\n  renderer: createLogger(\"Renderer\"),\n  module: createLogger(\"Module\"),\n  lifecycle: createLogger(\"Lifecycle\"),\n  loader: createLogger(\"Loader\"),\n  context: createLogger(\"Context\"),\n  discovery: createLogger(\"Discovery\"),\n  plugin: createLogger(\"Plugin\"),\n  canvas: createLogger(\"Canvas\"),\n  debug: createLogger(\"Debug\"),\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\";\nimport { frameworkLoggers } from \"./logger.js\";\nimport type { Patch, Action, RenderCallback, ActionHandler, ResolvedComponent, ComponentResolver } from \"./types.js\";\n\n// Re-export types so existing consumers of \"./engine.js\" still work\nexport type { Patch, Action, RenderCallback, ActionHandler, ResolvedComponent, ComponentResolver } from \"./types.js\";\n\nconst log = frameworkLoggers.engine;\n\n/**\n * Unwrap proxy objects to plain values for WASM serialization.\n * Uses structuredClone when available (Node 17+, Bun, modern browsers),\n * falls back to JSON round-trip for proxy objects or older environments.\n */\nfunction unwrapForWasm<T>(value: T): T {\n  // Fast path: primitives don't need cloning\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n\n  // Check if the object has a snapshot method (our proxy convention)\n  if (typeof (value as any).__getSnapshot === 'function') {\n    return (value as any).__getSnapshot() as T;\n  }\n\n  // Try structuredClone first (fastest for plain objects)\n  try {\n    return structuredClone(value);\n  } catch {\n    // Fallback for proxy objects or unsupported types\n    return JSON.parse(JSON.stringify(value));\n  }\n}\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    engine.renderInto(source, parentNodeId, unwrapForWasm(state));\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, unwrapForWasm(values));\n    log.debug(\"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    engine.updateState(unwrapForWasm(currentState));\n\n    if (paths.length > 0) {\n      log.debug(\"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    engine.updateState(unwrapForWasm(statePatch));\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((err) => log.error(\"Action handler error:\", err));\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 * Result Type for Error Handling\n *\n * A lightweight Result type for explicit error handling without exceptions.\n * Provides type-safe error propagation and composition.\n */\n\n/**\n * Represents either a successful value or an error\n */\nexport type Result<T, E = Error> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Create a successful Result\n */\nexport function Ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Create a failed Result\n */\nexport function Err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n\n/**\n * Check if a Result is Ok\n */\nexport function isOk<T, E>(result: Result<T, E>): result is { ok: true; value: T } {\n  return result.ok;\n}\n\n/**\n * Check if a Result is Err\n */\nexport function isErr<T, E>(result: Result<T, E>): result is { ok: false; error: E } {\n  return !result.ok;\n}\n\n/**\n * Wrap a Promise in a Result, catching any thrown errors\n */\nexport async function fromPromise<T, E = Error>(\n  promise: Promise<T>,\n  mapError?: (e: unknown) => E\n): Promise<Result<T, E>> {\n  try {\n    const value = await promise;\n    return Ok(value);\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Wrap a synchronous function in a Result, catching any thrown errors\n */\nexport function fromTry<T, E = Error>(\n  fn: () => T,\n  mapError?: (e: unknown) => E\n): Result<T, E> {\n  try {\n    return Ok(fn());\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Map over a successful Result value\n */\nexport function map<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => U\n): Result<U, E> {\n  if (result.ok) {\n    return Ok(fn(result.value));\n  }\n  return result;\n}\n\n/**\n * Map over a failed Result error\n */\nexport function mapErr<T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => F\n): Result<T, F> {\n  if (!result.ok) {\n    return Err(fn(result.error));\n  }\n  return result;\n}\n\n/**\n * Chain Results together (flatMap)\n */\nexport function flatMap<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, E>\n): Result<U, E> {\n  if (result.ok) {\n    return fn(result.value);\n  }\n  return result;\n}\n\n/**\n * Unwrap a Result, throwing if it's an error\n */\nexport function unwrap<T, E>(result: Result<T, E>): T {\n  if (result.ok) {\n    return result.value;\n  }\n  throw result.error;\n}\n\n/**\n * Unwrap a Result with a default value\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return defaultValue;\n}\n\n/**\n * Unwrap a Result with a lazy default value\n */\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return fn(result.error);\n}\n\n/**\n * Match on a Result, providing handlers for both cases\n */\nexport function match<T, E, U>(\n  result: Result<T, E>,\n  handlers: {\n    ok: (value: T) => U;\n    err: (error: E) => U;\n  }\n): U {\n  if (result.ok) {\n    return handlers.ok(result.value);\n  }\n  return handlers.err(result.error);\n}\n\n/**\n * Combine multiple Results into a single Result containing an array\n * Returns the first error encountered, or Ok with all values\n */\nexport function all<T, E>(results: Result<T, E>[]): Result<T[], E> {\n  const values: T[] = [];\n  for (const result of results) {\n    if (!result.ok) {\n      return result;\n    }\n    values.push(result.value);\n  }\n  return Ok(values);\n}\n\n/**\n * Base class for typed errors with context\n */\nexport class HypenError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: Error;\n\n  constructor(\n    code: string,\n    message: string,\n    options?: { context?: Record<string, unknown>; cause?: Error }\n  ) {\n    super(message);\n    this.name = 'HypenError';\n    this.code = code;\n    this.context = options?.context;\n    this.cause = options?.cause;\n\n    // Maintain proper prototype chain\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when an action handler fails\n */\nexport class ActionError extends HypenError {\n  readonly actionName: string;\n\n  constructor(actionName: string, cause?: unknown) {\n    super(\n      'ACTION_ERROR',\n      `Action handler \"${actionName}\" failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n      {\n        context: { actionName },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ActionError';\n    this.actionName = actionName;\n  }\n}\n\n/**\n * Error thrown when a connection fails\n */\nexport class ConnectionError extends HypenError {\n  readonly url: string;\n  readonly attempt?: number;\n\n  constructor(url: string, cause?: unknown, attempt?: number) {\n    super(\n      'CONNECTION_ERROR',\n      `Connection to \"${url}\" failed${attempt ? ` (attempt ${attempt})` : ''}: ${\n        cause instanceof Error ? cause.message : String(cause)\n      }`,\n      {\n        context: { url, attempt },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ConnectionError';\n    this.url = url;\n    this.attempt = attempt;\n  }\n}\n\n/**\n * Error thrown when state operations fail\n */\nexport class StateError extends HypenError {\n  readonly path?: string;\n\n  constructor(message: string, path?: string, cause?: unknown) {\n    super('STATE_ERROR', message, {\n      context: { path },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'StateError';\n    this.path = path;\n  }\n}\n\n/**\n * Error thrown when parsing Hypen DSL source fails\n */\nexport class ParseError extends HypenError {\n  readonly source?: string;\n\n  constructor(message: string, source?: string, cause?: unknown) {\n    super('PARSE_ERROR', message, {\n      context: { source },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'ParseError';\n    this.source = source;\n  }\n}\n\n/**\n * Error thrown when rendering fails\n */\nexport class RenderError extends HypenError {\n  constructor(message: string, cause?: unknown) {\n    super('RENDER_ERROR', message, {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'RenderError';\n  }\n}\n\n/**\n * Classify a WASM engine error string into the appropriate HypenError subclass.\n * The engine returns JsValue error strings with known prefixes.\n */\nexport function classifyEngineError(err: unknown): HypenError {\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (message.startsWith('Parse error:')) {\n    return new ParseError(message);\n  }\n  if (message.startsWith('Invalid state:') || message.startsWith('Invalid state patch:')) {\n    return new StateError(message);\n  }\n  if (message.startsWith('Parent node not found:')) {\n    return new RenderError(message);\n  }\n\n  return new RenderError(message);\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\";\nimport { frameworkLoggers } from \"./logger.js\";\nimport { classifyEngineError } from \"./result.js\";\nimport type { Patch, Action, RenderCallback, ActionHandler, ResolvedComponent, ComponentResolver } from \"./types.js\";\n\n// Re-export types so existing consumers of \"./engine.js\" still work\nexport type { Patch, Action, RenderCallback, ActionHandler, ResolvedComponent, ComponentResolver } from \"./types.js\";\n\nconst log = frameworkLoggers.engine;\n\n/**\n * Unwrap proxy objects to plain values for WASM serialization.\n * Uses structuredClone when available (Node 17+, Bun, modern browsers),\n * falls back to JSON round-trip for proxy objects or older environments.\n */\nfunction unwrapForWasm<T>(value: T): T {\n  // Fast path: primitives don't need cloning\n  if (value === null || typeof value !== 'object') {\n    return value;\n  }\n\n  // Check if the object has a snapshot method (our proxy convention)\n  if (typeof (value as any).__getSnapshot === 'function') {\n    return (value as any).__getSnapshot() as T;\n  }\n\n  // Try structuredClone first (fastest for plain objects)\n  try {\n    return structuredClone(value);\n  } catch {\n    // Fallback for proxy objects or unsupported types\n    return JSON.parse(JSON.stringify(value));\n  }\n}\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   * @throws {ParseError} if the source fails to parse\n   * @throws {RenderError} if rendering fails\n   */\n  renderSource(source: string): void {\n    const engine = this.ensureInitialized();\n    try {\n      engine.renderSource(source);\n    } catch (err) {\n      throw classifyEngineError(err);\n    }\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   * @throws {ParseError} if the source fails to parse\n   * @throws {RenderError} if the parent node is not found or rendering fails\n   */\n  renderInto(source: string, parentNodeId: string, state: Record<string, any>): void {\n    const engine = this.ensureInitialized();\n    try {\n      engine.renderInto(source, parentNodeId, unwrapForWasm(state));\n    } catch (err) {\n      throw classifyEngineError(err);\n    }\n  }\n\n  /**\n   * Notify the engine of state changes using sparse updates\n   * @throws {StateError} if the state patch is invalid\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    try {\n      engine.updateStateSparse(paths, unwrapForWasm(values));\n    } catch (err) {\n      throw classifyEngineError(err);\n    }\n    log.debug(\"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    engine.updateState(unwrapForWasm(currentState));\n\n    if (paths.length > 0) {\n      log.debug(\"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    engine.updateState(unwrapForWasm(statePatch));\n  }\n\n  /**\n   * Dispatch an action\n   * @throws {HypenError} if the action dispatch fails\n   */\n  dispatchAction(name: string, payload?: any): void {\n    const engine = this.ensureInitialized();\n    try {\n      engine.dispatchAction(name, payload ?? null);\n    } catch (err) {\n      throw classifyEngineError(err);\n    }\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((err) => log.error(\"Action handler error:\", err));\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": "1B7D1FF1C58FF0C664756E2164756E21",
+  "mappings": "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",
+  "debugId": "300F3F54546AE21864756E2164756E21",
   "names": []
 }

package/dist/index.browser.d.ts

@@ -5,7 +5,7 @@
  */
 export type { Patch, Action, RenderCallback, ActionHandler as EngineActionHandler, ResolvedComponent, ComponentResolver, } from "./types.js";
 export { app, HypenApp, HypenAppBuilder, HypenModuleInstance } from "./app.js";
-export type { IEngine, RouterContext, ActionContext, ActionNext, GlobalContext, LifecycleHandler, ActionHandlerContext, ActionHandler, HypenModuleDefinition, HypenModule, } from "./app.js";
+export type { IEngine, ActionContext, GlobalContext, LifecycleHandler, ActionHandlerContext, ActionHandler, HypenModuleDefinition, HypenModule, } from "./app.js";
 export { createObservableState, batchStateUpdates, getStateSnapshot, } from "./state.js";
 export type { StatePath, StateChange, StateObserverOptions, } from "./state.js";
 export { BaseRenderer, ConsoleRenderer } from "./renderer.js";

package/dist/index.browser.js

@@ -361,7 +361,20 @@ function all(results) {
   }
   return Ok(values);
 }
-var HypenError, ActionError, ConnectionError, StateError;
+function classifyEngineError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.startsWith("Parse error:")) {
+    return new ParseError(message);
+  }
+  if (message.startsWith("Invalid state:") || message.startsWith("Invalid state patch:")) {
+    return new StateError(message);
+  }
+  if (message.startsWith("Parent node not found:")) {
+    return new RenderError(message);
+  }
+  return new RenderError(message);
+}
+var HypenError, ActionError, ConnectionError, StateError, ParseError, RenderError;
 var init_result = __esm(() => {
   HypenError = class HypenError extends Error {
     code;
@@ -411,6 +424,25 @@ var init_result = __esm(() => {
       this.path = path;
     }
   };
+  ParseError = class ParseError extends HypenError {
+    source;
+    constructor(message, source, cause) {
+      super("PARSE_ERROR", message, {
+        context: { source },
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "ParseError";
+      this.source = source;
+    }
+  };
+  RenderError = class RenderError extends HypenError {
+    constructor(message, cause) {
+      super("RENDER_ERROR", message, {
+        cause: cause instanceof Error ? cause : undefined
+      });
+      this.name = "RenderError";
+    }
+  };
 });
 
 // src/logger.ts
@@ -632,9 +664,11 @@ class HypenAppBuilder {
   expireHandler;
   errorHandler;
   template;
-  constructor(initialState, options) {
+  _registry;
+  constructor(initialState, options, registry) {
     this.initialState = initialState;
     this.options = options || {};
+    this._registry = registry;
   }
   onCreated(fn) {
     this.createdHandler = fn;
@@ -670,7 +704,7 @@ class HypenAppBuilder {
   }
   build() {
     const stateKeys = this.initialState !== null && typeof this.initialState === "object" ? Object.keys(this.initialState) : [];
-    return {
+    const definition = {
       name: this.options.name,
       actions: Array.from(this.actionHandlers.keys()),
       stateKeys,
@@ -688,12 +722,46 @@ class HypenAppBuilder {
         onError: this.errorHandler
       }
     };
+    if (this.options.name && this._registry) {
+      this._registry.set(this.options.name, definition);
+    }
+    return definition;
   }
 }
 
 class HypenApp {
+  _registry = new Map;
   defineState(initial, options) {
-    return new HypenAppBuilder(initial, options);
+    return new HypenAppBuilder(initial, options, this._registry);
+  }
+  module(name) {
+    const registry = this._registry;
+    return {
+      defineState: (initial, options) => {
+        return new HypenAppBuilder(initial, { ...options, name }, registry);
+      }
+    };
+  }
+  get(name) {
+    return this._registry.get(name);
+  }
+  has(name) {
+    return this._registry.has(name);
+  }
+  get components() {
+    return this._registry;
+  }
+  getNames() {
+    return Array.from(this._registry.keys());
+  }
+  get size() {
+    return this._registry.size;
+  }
+  unregister(name) {
+    this._registry.delete(name);
+  }
+  clear() {
+    this._registry.clear();
   }
 }
 
@@ -702,13 +770,13 @@ class HypenModuleInstance {
   definition;
   state;
   isDestroyed = false;
-  routerContext;
+  router;
   globalContext;
   stateChangeCallbacks = [];
-  constructor(engine, definition, routerContext, globalContext) {
+  constructor(engine, definition, router, globalContext) {
     this.engine = engine;
     this.definition = definition;
-    this.routerContext = routerContext;
+    this.router = router ?? null;
     this.globalContext = globalContext;
     const statePrefix = (definition.name || "").toLowerCase();
     this.state = createObservableState(definition.initialState, {
@@ -730,14 +798,10 @@ class HypenModuleInstance {
           payload: action.payload,
           sender: action.sender
         };
-        const next = {
-          router: this.routerContext?.root || null
-        };
         const context = this.globalContext ? this.createGlobalContextAPI() : undefined;
         const result = await this.executeAction(actionName, handler, {
           action: actionCtx,
           state: this.state,
-          next,
           context
         });
         if (!result.ok) {
@@ -750,6 +814,21 @@ class HypenModuleInstance {
         }
       });
     }
+    this.engine.onAction("__hypen_bind", (action) => {
+      const payload = action.payload;
+      if (!payload?.path)
+        return;
+      const segments = payload.path.split(".");
+      let target = this.state;
+      for (let i = 0;i < segments.length - 1; i++) {
+        const seg = segments[i];
+        target = target?.[seg];
+        if (target == null)
+          return;
+      }
+      const lastSeg = segments[segments.length - 1];
+      target[lastSeg] = payload.value;
+    });
     this.callCreatedHandler();
   }
   createGlobalContextAPI() {
@@ -763,11 +842,9 @@ class HypenModuleInstance {
       getModuleIds: () => ctx.getModuleIds(),
       getGlobalState: () => ctx.getGlobalState(),
       emit: (event, payload) => ctx.emit(event, payload),
-      on: (event, handler) => ctx.on(event, handler)
+      on: (event, handler) => ctx.on(event, handler),
+      router: this.router
     };
-    if (ctx.__router) {
-      api.__router = ctx.__router;
-    }
     if (ctx.__hypenEngine) {
       api.__hypenEngine = ctx.__hypenEngine;
     }
@@ -818,7 +895,15 @@ class HypenModuleInstance {
   async callCreatedHandler() {
     if (this.definition.handlers.onCreated) {
       const context = this.globalContext ? this.createGlobalContextAPI() : undefined;
-      await this.definition.handlers.onCreated(this.state, context);
+      try {
+        await this.definition.handlers.onCreated(this.state, context);
+      } catch (e) {
+        const error = e instanceof HypenError ? e : new ActionError("onCreated", e);
+        const shouldRethrow = await this.handleError(error, { lifecycle: "created" });
+        if (shouldRethrow) {
+          throw error;
+        }
+      }
     }
   }
   onStateChange(callback) {
@@ -828,7 +913,15 @@ class HypenModuleInstance {
     if (this.isDestroyed)
       return;
     if (this.definition.handlers.onDestroyed) {
-      await this.definition.handlers.onDestroyed(this.state);
+      try {
+        await this.definition.handlers.onDestroyed(this.state);
+      } catch (e) {
+        const error = e instanceof HypenError ? e : new ActionError("onDestroyed", e);
+        const shouldRethrow = await this.handleError(error, { lifecycle: "destroyed" });
+        if (shouldRethrow) {
+          throw error;
+        }
+      }
     }
     this.isDestroyed = true;
   }
@@ -1841,4 +1934,4 @@ export {
   BaseRenderer
 };
 
-//# debugId=9E4501F170B224D064756E2164756E21
+//# debugId=60758C2F2D9B92CA64756E2164756E21