@hypen-space/core 0.4.38 → 0.4.39

package/dist/result.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/result.ts"],
   "sourcesContent": [
-    "/**\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 * 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  // Handle structured WASM errors: { type: string, message: string }\n  if (err && typeof err === 'object' && 'message' in err && 'type' in err) {\n    const structured = err as { type: string; message: string };\n    switch (structured.type) {\n      case 'parseError': return new ParseError(structured.message);\n      case 'stateError': return new StateError(structured.message);\n      case 'renderError': return new RenderError(structured.message);\n      case 'actionError': return new HypenError('ACTION_ERROR', structured.message);\n      default: return new HypenError('UNKNOWN_ERROR', structured.message);\n    }\n  }\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"
   ],
-  "mappings": "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",
-  "debugId": "F2BF3B8699578CF464756E2164756E21",
+  "mappings": "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",
+  "debugId": "BD46F61C1A9D179B64756E2164756E21",
   "names": []
 }

package/dist/retry.js

@@ -181,6 +181,21 @@ class RenderError extends HypenError {
   }
 }
 function classifyEngineError(err) {
+  if (err && typeof err === "object" && "message" in err && "type" in err) {
+    const structured = err;
+    switch (structured.type) {
+      case "parseError":
+        return new ParseError(structured.message);
+      case "stateError":
+        return new StateError(structured.message);
+      case "renderError":
+        return new RenderError(structured.message);
+      case "actionError":
+        return new HypenError("ACTION_ERROR", structured.message);
+      default:
+        return new HypenError("UNKNOWN_ERROR", structured.message);
+    }
+  }
   const message = err instanceof Error ? err.message : String(err);
   if (message.startsWith("Parse error:")) {
     return new ParseError(message);
@@ -326,4 +341,4 @@ export {
   RetryConditions
 };
 
-//# debugId=6E3ECD6C85AD305C64756E2164756E21
+//# debugId=D29176158ABD41D764756E2164756E21

package/dist/retry.js.map

@@ -2,10 +2,10 @@
   "version": 3,
   "sources": ["../src/result.ts", "../src/retry.ts"],
   "sourcesContent": [
-    "/**\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 * 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  // Handle structured WASM errors: { type: string, message: string }\n  if (err && typeof err === 'object' && 'message' in err && 'type' in err) {\n    const structured = err as { type: string; message: string };\n    switch (structured.type) {\n      case 'parseError': return new ParseError(structured.message);\n      case 'stateError': return new StateError(structured.message);\n      case 'renderError': return new RenderError(structured.message);\n      case 'actionError': return new HypenError('ACTION_ERROR', structured.message);\n      default: return new HypenError('UNKNOWN_ERROR', structured.message);\n    }\n  }\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 * Retry Utility for Network Operations\n *\n * Provides configurable retry logic with exponential/linear backoff\n * for handling transient failures in network operations.\n */\n\nimport { type Result, Ok, Err } from \"./result.js\";\n\n/**\n * Options for retry behavior\n */\nexport interface RetryOptions {\n  /** Maximum number of attempts (default: 3) */\n  maxAttempts?: number;\n  /** Initial delay in milliseconds (default: 1000) */\n  delayMs?: number;\n  /** Backoff strategy (default: 'exponential') */\n  backoff?: \"linear\" | \"exponential\" | \"none\";\n  /** Maximum delay cap in milliseconds (default: 30000) */\n  maxDelayMs?: number;\n  /** Jitter factor 0-1 to randomize delays (default: 0.1) */\n  jitter?: number;\n  /** Callback on each retry attempt */\n  onRetry?: (attempt: number, error: Error, nextDelayMs: number) => void;\n  /** Optional predicate to determine if error is retryable */\n  shouldRetry?: (error: Error) => boolean;\n  /** AbortSignal for cancellation */\n  signal?: AbortSignal;\n}\n\n/**\n * Default retry options\n */\nconst DEFAULT_OPTIONS: Required<Omit<RetryOptions, \"onRetry\" | \"shouldRetry\" | \"signal\">> = {\n  maxAttempts: 3,\n  delayMs: 1000,\n  backoff: \"exponential\",\n  maxDelayMs: 30000,\n  jitter: 0.1,\n};\n\n/**\n * Calculate delay for a given attempt\n */\nfunction calculateDelay(\n  attempt: number,\n  options: Required<Omit<RetryOptions, \"onRetry\" | \"shouldRetry\" | \"signal\">>\n): number {\n  let delay: number;\n\n  switch (options.backoff) {\n    case \"exponential\":\n      // 2^(attempt-1) * delayMs: 1x, 2x, 4x, 8x...\n      delay = options.delayMs * Math.pow(2, attempt - 1);\n      break;\n    case \"linear\":\n      // attempt * delayMs: 1x, 2x, 3x, 4x...\n      delay = options.delayMs * attempt;\n      break;\n    case \"none\":\n      delay = options.delayMs;\n      break;\n  }\n\n  // Apply jitter (randomize ±jitter%)\n  if (options.jitter > 0) {\n    const jitterRange = delay * options.jitter;\n    delay += (Math.random() * 2 - 1) * jitterRange;\n  }\n\n  // Cap at maxDelayMs\n  return Math.min(delay, options.maxDelayMs);\n}\n\n/**\n * Sleep for a given duration, respecting abort signal\n */\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"Retry aborted\"));\n      return;\n    }\n\n    const timeoutId = setTimeout(resolve, ms);\n\n    signal?.addEventListener(\"abort\", () => {\n      clearTimeout(timeoutId);\n      reject(new Error(\"Retry aborted\"));\n    });\n  });\n}\n\n/**\n * Retry a function with configurable backoff\n *\n * @example\n * ```typescript\n * // Basic usage\n * const result = await retry(() => fetch('/api/data'));\n *\n * // With options\n * const result = await retry(\n *   () => fetch('/api/data'),\n *   {\n *     maxAttempts: 5,\n *     delayMs: 2000,\n *     backoff: 'exponential',\n *     onRetry: (n, err) => console.log(`Attempt ${n} failed: ${err.message}`)\n *   }\n * );\n * ```\n */\nexport async function retry<T>(\n  fn: () => T | Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  let lastError: Error = new Error(\"No attempts made\");\n\n  for (let attempt = 1; attempt <= opts.maxAttempts; attempt++) {\n    try {\n      // Check for abort before each attempt\n      if (opts.signal?.aborted) {\n        throw new Error(\"Retry aborted\");\n      }\n\n      return await fn();\n    } catch (e) {\n      lastError = e instanceof Error ? e : new Error(String(e));\n\n      // Check if we should retry this error\n      if (opts.shouldRetry && !opts.shouldRetry(lastError)) {\n        throw lastError;\n      }\n\n      // If this was the last attempt, don't wait\n      if (attempt === opts.maxAttempts) {\n        break;\n      }\n\n      // Calculate delay and notify\n      const delayMs = calculateDelay(attempt, opts);\n      opts.onRetry?.(attempt, lastError, delayMs);\n\n      // Wait before next attempt\n      await sleep(delayMs, opts.signal);\n    }\n  }\n\n  throw lastError;\n}\n\n/**\n * Retry a function, returning a Result instead of throwing\n *\n * @example\n * ```typescript\n * const result = await retryResult(() => fetch('/api/data'));\n * if (result.ok) {\n *   console.log('Success:', result.value);\n * } else {\n *   console.error('All retries failed:', result.error);\n * }\n * ```\n */\nexport async function retryResult<T>(\n  fn: () => T | Promise<T>,\n  options: RetryOptions = {}\n): Promise<Result<T, Error>> {\n  try {\n    const value = await retry(fn, options);\n    return Ok(value);\n  } catch (e) {\n    return Err(e instanceof Error ? e : new Error(String(e)));\n  }\n}\n\n/**\n * Create a retryable version of a function\n *\n * @example\n * ```typescript\n * const fetchWithRetry = withRetry(\n *   (url: string) => fetch(url),\n *   { maxAttempts: 3 }\n * );\n *\n * const response = await fetchWithRetry('/api/data');\n * ```\n */\nexport function withRetry<TArgs extends unknown[], TReturn>(\n  fn: (...args: TArgs) => TReturn | Promise<TReturn>,\n  options: RetryOptions = {}\n): (...args: TArgs) => Promise<TReturn> {\n  return (...args: TArgs) => retry(() => fn(...args), options);\n}\n\n/**\n * Predefined retry conditions\n */\nexport const RetryConditions = {\n  /**\n   * Retry on network errors (fetch failures, timeouts)\n   */\n  networkErrors: (error: Error): boolean => {\n    const message = error.message.toLowerCase();\n    return (\n      message.includes(\"network\") ||\n      message.includes(\"fetch\") ||\n      message.includes(\"timeout\") ||\n      message.includes(\"econnrefused\") ||\n      message.includes(\"econnreset\") ||\n      message.includes(\"socket\")\n    );\n  },\n\n  /**\n   * Retry on specific HTTP status codes (from fetch Response)\n   */\n  httpRetryable: (error: Error & { status?: number }): boolean => {\n    const status = error.status;\n    if (!status) return false;\n    // Retry on 408, 429, 500, 502, 503, 504\n    return [408, 429, 500, 502, 503, 504].includes(status);\n  },\n\n  /**\n   * Retry on transient WebSocket errors\n   */\n  websocketErrors: (error: Error): boolean => {\n    const message = error.message.toLowerCase();\n    return (\n      message.includes(\"websocket\") ||\n      message.includes(\"connection\") ||\n      message.includes(\"close\")\n    );\n  },\n\n  /**\n   * Combine multiple conditions (retry if any match)\n   */\n  any:\n    (...conditions: Array<(error: Error) => boolean>) =>\n    (error: Error): boolean =>\n      conditions.some((c) => c(error)),\n\n  /**\n   * Combine multiple conditions (retry if all match)\n   */\n  all:\n    (...conditions: Array<(error: Error) => boolean>) =>\n    (error: Error): boolean =>\n      conditions.every((c) => c(error)),\n};\n\n/**\n * Preset configurations for common use cases\n */\nexport const RetryPresets = {\n  /**\n   * Aggressive retry for critical operations\n   */\n  aggressive: {\n    maxAttempts: 10,\n    delayMs: 500,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 60000,\n    jitter: 0.2,\n  },\n\n  /**\n   * Conservative retry for non-critical operations\n   */\n  conservative: {\n    maxAttempts: 3,\n    delayMs: 2000,\n    backoff: \"linear\" as const,\n    maxDelayMs: 10000,\n    jitter: 0.1,\n  },\n\n  /**\n   * Fast retry for local operations (short delays)\n   */\n  fast: {\n    maxAttempts: 5,\n    delayMs: 100,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 2000,\n    jitter: 0,\n  },\n\n  /**\n   * WebSocket reconnection preset\n   */\n  websocket: {\n    maxAttempts: 10,\n    delayMs: 1000,\n    backoff: \"exponential\" as const,\n    maxDelayMs: 30000,\n    jitter: 0.1,\n    shouldRetry: RetryConditions.websocketErrors,\n  },\n};\n"
   ],
-  "mappings": "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",
-  "debugId": "6E3ECD6C85AD305C64756E2164756E21",
+  "mappings": "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",
+  "debugId": "D29176158ABD41D764756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypen-space/core",
-  "version": "0.4.38",
+  "version": "0.4.39",
   "description": "Hypen core - Platform-agnostic reactive UI runtime (types, state, router, events)",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/builtin.ts

@@ -8,6 +8,81 @@ import { frameworkLoggers } from "../logger.js";
 
 const log = frameworkLoggers.router;
 
+/**
+ * Interface for the engine methods needed by route visibility updates
+ */
+export interface RouteEngine {
+  renderLazyRoute(path: string, component: string, element: HTMLElement): Promise<void>;
+  getState(): Record<string, unknown>;
+}
+
+/**
+ * Update route visibility based on the current path.
+ * Shows the matching route element and hides all others.
+ * For lazy routes (or routes without content), triggers rendering via the engine.
+ *
+ * @param currentPath - The path to match against route elements
+ * @param engine - Optional engine for lazy route rendering
+ * @param doc - Document to query for route elements (defaults to global document)
+ */
+export async function updateRouteVisibility(
+  currentPath: string,
+  engine?: RouteEngine,
+  doc?: Document
+): Promise<void> {
+  const targetDoc = doc ?? document;
+  const routeElements = targetDoc.querySelectorAll(
+    '[data-hypen-type="route"]'
+  );
+
+  let matchFound = false;
+
+  for (let index = 0; index < routeElements.length; index++) {
+    const routeEl = routeElements[index];
+    const htmlEl = routeEl as HTMLElement;
+    const routePath = htmlEl.dataset.routePath || "/";
+
+    // Simple path matching (exact match for now)
+    const isMatch = routePath === currentPath;
+
+    // Only show the matching route, hide all others
+    htmlEl.style.display = isMatch ? "flex" : "none";
+
+    if (isMatch) {
+      matchFound = true;
+
+      // Check if this route needs to be rendered
+      const componentName = htmlEl.dataset.routeComponent;
+      const isLazy = htmlEl.dataset.routeLazy === "true";
+      const hasContent = htmlEl.children.length > 0;
+
+      // Always re-render lazy routes; render non-lazy only if they have no content
+      const shouldRender = componentName && engine && (isLazy || !hasContent);
+
+      if (shouldRender) {
+        try {
+          await engine.renderLazyRoute(
+            routePath,
+            componentName,
+            htmlEl
+          );
+        } catch (err) {
+          log.error(`Failed to render route ${routePath}:`, err);
+        }
+      }
+    }
+  }
+
+  if (!matchFound) {
+    log.warn(
+      `No route matched path: ${currentPath}. Available routes:`,
+      Array.from(routeElements).map(
+        (el: Element) => (el as HTMLElement).dataset.routePath
+      )
+    );
+  }
+}
+
 /**
  * Router Component
  * Automatically matches routes and renders the appropriate child Route
@@ -42,64 +117,11 @@ export const Router = app
     }
 
     // Get access to the Hypen engine for lazy rendering
-    const hypenEngine = (context as any).__hypenEngine;
-
-    // Function to render only the matching route
-    const updateRouteVisibility = async (currentPath: string) => {
-      // Find all Route elements in the DOM
-      const routeElements = document.querySelectorAll(
-        '[data-hypen-type="route"]'
-      );
-
-      let matchFound = false;
-
-      for (let index = 0; index < routeElements.length; index++) {
-        const routeEl = routeElements[index];
-        const htmlEl = routeEl as HTMLElement;
-        const routePath = htmlEl.dataset.routePath || "/";
-
-        // Simple path matching (exact match for now)
-        const isMatch = routePath === currentPath;
-
-        // Only show the matching route, hide all others
-        htmlEl.style.display = isMatch ? "flex" : "none";
-
-        if (isMatch) {
-          matchFound = true;
-
-          // Check if this route needs to be rendered
-          const componentName = htmlEl.dataset.routeComponent;
-          const isLazy = htmlEl.dataset.routeLazy === "true";
-          const hasContent = htmlEl.children.length > 0;
-
-          // Render if route has no content and has a component name
-          if (componentName && !hasContent && hypenEngine) {
-            try {
-              await hypenEngine.renderLazyRoute(
-                routePath,
-                componentName,
-                htmlEl
-              );
-            } catch (err) {
-              log.error(`Failed to render route ${routePath}:`, err);
-            }
-          }
-        }
-      }
-
-      if (!matchFound) {
-        log.warn(
-          `No route matched path: ${currentPath}. Available routes:`,
-          Array.from(routeElements).map(
-            (el: Element) => (el as HTMLElement).dataset.routePath
-          )
-        );
-      }
-    };
+    const hypenEngine = (context as any).__hypenEngine as RouteEngine | undefined;
 
     // Initial route visibility (after DOM is ready)
     setTimeout(() => {
-      updateRouteVisibility(state.currentPath);
+      updateRouteVisibility(state.currentPath, hypenEngine);
     }, 100);
 
     router.onNavigate((routeState) => {
@@ -107,7 +129,7 @@ export const Router = app
       state.routeParams = routeState.params;
 
       // Update route visibility when path changes
-      updateRouteVisibility(routeState.currentPath);
+      updateRouteVisibility(routeState.currentPath, hypenEngine);
     });
   })
   .build();

package/src/context.ts

@@ -23,9 +23,6 @@ export type ModuleReference<T = unknown> = {
   getState: () => T;
 };
 
-/**
- * @deprecated Use TypedEventEmitter from events.ts for type-safe events
- */
 export type EventHandler = (payload?: unknown) => void;
 
 /**
@@ -35,21 +32,16 @@ export type EventHandler = (payload?: unknown) => void;
  */
 export class HypenGlobalContext<TEvents extends Record<string, unknown> = HypenFrameworkEvents> {
   private modules = new Map<string, HypenModuleInstance>();
-  private typedEvents: TypedEventEmitter<TEvents>;
-
-  /**
-   * @deprecated Legacy event bus for backward compatibility
-   */
-  private legacyEventBus = new Map<string, Set<EventHandler>>();
+  private typedEvents: TypedEventEmitter<TEvents & Record<string, unknown>>;
 
   constructor() {
-    this.typedEvents = new TypedEventEmitter<TEvents>();
+    this.typedEvents = new TypedEventEmitter<TEvents & Record<string, unknown>>();
   }
 
   /**
    * Get the typed event emitter for type-safe event handling
    */
-  get events(): TypedEventEmitter<TEvents> {
+  get events(): TypedEventEmitter<TEvents & Record<string, unknown>> {
     return this.typedEvents;
   }
 
@@ -116,81 +108,48 @@ export class HypenGlobalContext<TEvents extends Record<string, unknown> = HypenF
   }
 
   /**
-   * Emit an event to the event bus (legacy API for backward compatibility)
-   * @deprecated Use `context.events.emit()` for type-safe events
+   * Emit an event. Delegates to the TypedEventEmitter.
    */
   emit(event: string, payload?: unknown): void {
-    const handlers = this.legacyEventBus.get(event);
-    if (!handlers || handlers.size === 0) {
+    if (this.typedEvents.listenerCount(event) === 0) {
       log.debug(`Event "${event}" emitted but no listeners`);
-    } else {
-      log.debug(`Emitting event: ${event}`, payload);
-      handlers.forEach((handler) => {
-        try {
-          handler(payload);
-        } catch (error) {
-          log.error(`Error in event handler for "${event}":`, error);
-        }
-      });
-    }
-
-    // Also emit to typed event system if the event is registered there
-    if (this.typedEvents.listenerCount(event as keyof TEvents) > 0) {
-      this.typedEvents.emit(event as keyof TEvents, payload as TEvents[keyof TEvents]);
+      return;
     }
+    log.debug(`Emitting event: ${event}`, payload);
+    this.typedEvents.emit(event, payload as TEvents[string]);
   }
 
   /**
-   * Subscribe to an event (legacy API for backward compatibility)
-   * @deprecated Use `context.events.on()` for type-safe events
+   * Subscribe to an event. Delegates to the TypedEventEmitter.
+   * Returns an unsubscribe function.
    */
   on(event: string, handler: EventHandler): () => void {
-    if (!this.legacyEventBus.has(event)) {
-      this.legacyEventBus.set(event, new Set());
-    }
-
-    const handlers = this.legacyEventBus.get(event)!;
-    handlers.add(handler);
-
     log.debug(`Listening to event: ${event}`);
-
-    // Return unsubscribe function
-    return () => {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.legacyEventBus.delete(event);
-      }
-    };
+    return this.typedEvents.on(event, handler);
   }
 
   /**
-   * Unsubscribe from an event (legacy API)
-   * @deprecated Use the unsubscribe function returned by `context.events.on()`
+   * Unsubscribe a specific handler from an event.
+   * Delegates to the TypedEventEmitter.
    */
   off(event: string, handler: EventHandler): void {
-    const handlers = this.legacyEventBus.get(event);
-    if (handlers) {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.legacyEventBus.delete(event);
-      }
-    }
+    this.typedEvents.off(event, handler);
   }
 
   /**
-   * Clear all event listeners for an event (legacy API)
-   * @deprecated Use `context.events.removeAllListeners()`
+   * Remove all listeners for a specific event.
+   * Delegates to the TypedEventEmitter.
    */
   clearEvent(event: string): void {
-    this.legacyEventBus.delete(event);
+    this.typedEvents.removeAllListeners(event);
   }
 
   /**
-   * Clear all event listeners (legacy API)
-   * @deprecated Use `context.events.clearAll()`
+   * Remove all listeners for all events.
+   * Delegates to the TypedEventEmitter.
    */
   clearAllEvents(): void {
-    this.legacyEventBus.clear();
+    this.typedEvents.clearAll();
   }
 
   /**
@@ -198,14 +157,12 @@ export class HypenGlobalContext<TEvents extends Record<string, unknown> = HypenF
    */
   debug(): {
     modules: string[];
-    events: string[];
-    typedEvents: Array<keyof TEvents>;
+    events: Array<keyof TEvents | string>;
     state: Record<string, unknown>;
   } {
     return {
       modules: this.getModuleIds(),
-      events: Array.from(this.legacyEventBus.keys()),
-      typedEvents: this.typedEvents.eventNames(),
+      events: this.typedEvents.eventNames() as Array<keyof TEvents | string>,
       state: this.getGlobalState(),
     };
   }

package/src/result.ts

@@ -292,6 +292,17 @@ export class RenderError extends HypenError {
  * The engine returns JsValue error strings with known prefixes.
  */
 export function classifyEngineError(err: unknown): HypenError {
+  // Handle structured WASM errors: { type: string, message: string }
+  if (err && typeof err === 'object' && 'message' in err && 'type' in err) {
+    const structured = err as { type: string; message: string };
+    switch (structured.type) {
+      case 'parseError': return new ParseError(structured.message);
+      case 'stateError': return new StateError(structured.message);
+      case 'renderError': return new RenderError(structured.message);
+      case 'actionError': return new HypenError('ACTION_ERROR', structured.message);
+      default: return new HypenError('UNKNOWN_ERROR', structured.message);
+    }
+  }
   const message = err instanceof Error ? err.message : String(err);
 
   if (message.startsWith('Parse error:')) {