@hypen-space/core 0.4.956 → 0.5.2

package/dist/disposable.js

@@ -1,369 +1,22 @@
-var __defProp = Object.defineProperty;
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: __exportSetter.bind(all, name)
-    });
-};
-var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
-// src/logger.ts
-var LOG_LEVEL_ORDER = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  none: 4
-};
-var LOG_LEVEL_COLORS = {
-  debug: "\x1B[36m",
-  info: "\x1B[32m",
-  warn: "\x1B[33m",
-  error: "\x1B[31m"
-};
-var RESET_COLOR = "\x1B[0m";
-function isProduction() {
-  if (typeof process !== "undefined" && process.env) {
-    return false;
-  }
-  return false;
-}
-var config = {
-  level: isProduction() ? "error" : "info",
-  colors: true,
-  timestamps: false
-};
-function setLogLevel(level) {
-  config.level = level;
-}
-function getLogLevel() {
-  return config.level;
-}
-function configureLogger(options) {
-  config = { ...config, ...options };
-}
-function enableLogging() {
-  config.level = "debug";
-}
-function disableLogging() {
-  config.level = "none";
-}
-function setDebugMode(enabled) {
-  config.level = enabled ? "debug" : "error";
-}
-function isDebugMode() {
-  return config.level === "debug";
-}
-function shouldLog(level) {
-  return LOG_LEVEL_ORDER[level] >= LOG_LEVEL_ORDER[config.level];
-}
-function formatTag(tag, level) {
-  const timestamp = config.timestamps ? `${new Date().toISOString()} ` : "";
-  if (config.colors && level !== "none") {
-    const color = LOG_LEVEL_COLORS[level];
-    return `${timestamp}${color}[${tag}]${RESET_COLOR}`;
-  }
-  return `${timestamp}[${tag}]`;
-}
-
-class Logger {
-  tag;
-  constructor(tag) {
-    this.tag = tag;
-  }
-  debug(...args) {
-    if (!shouldLog("debug"))
-      return;
-    if (config.handler) {
-      config.handler.debug(this.tag, ...args);
-    } else {
-      console.log(formatTag(this.tag, "debug"), ...args);
-    }
-  }
-  info(...args) {
-    if (!shouldLog("info"))
-      return;
-    if (config.handler) {
-      config.handler.info(this.tag, ...args);
-    } else {
-      console.info(formatTag(this.tag, "info"), ...args);
-    }
-  }
-  warn(...args) {
-    if (!shouldLog("warn"))
-      return;
-    if (config.handler) {
-      config.handler.warn(this.tag, ...args);
-    } else {
-      console.warn(formatTag(this.tag, "warn"), ...args);
-    }
-  }
-  error(...args) {
-    if (!shouldLog("error"))
-      return;
-    if (config.handler) {
-      config.handler.error(this.tag, ...args);
-    } else {
-      console.error(formatTag(this.tag, "error"), ...args);
-    }
-  }
-  time(label, fn) {
-    if (!shouldLog("debug")) {
-      return fn();
-    }
-    const start = performance.now();
-    try {
-      return fn();
-    } finally {
-      const duration = performance.now() - start;
-      this.debug(`${label}: ${duration.toFixed(2)}ms`);
-    }
-  }
-  async timeAsync(label, fn) {
-    if (!shouldLog("debug")) {
-      return fn();
-    }
-    const start = performance.now();
-    try {
-      return await fn();
-    } finally {
-      const duration = performance.now() - start;
-      this.debug(`${label}: ${duration.toFixed(2)}ms`);
-    }
-  }
-  child(subTag) {
-    return new Logger(`${this.tag}:${subTag}`);
-  }
-  debugIf(condition, ...args) {
-    if (condition)
-      this.debug(...args);
-  }
-  warnIf(condition, ...args) {
-    if (condition)
-      this.warn(...args);
-  }
-  errorIf(condition, ...args) {
-    if (condition)
-      this.error(...args);
-  }
-  loggedOnce = new Set;
-  warnOnce(key, ...args) {
-    if (this.loggedOnce.has(key))
-      return;
-    this.loggedOnce.add(key);
-    this.warn(...args);
-  }
-  debugOnce(key, ...args) {
-    if (this.loggedOnce.has(key))
-      return;
-    this.loggedOnce.add(key);
-    this.debug(...args);
-  }
-}
-function createLogger(tag) {
-  return new Logger(tag);
-}
-var logger = createLogger("Hypen");
-var log = {
-  debug: (tag, ...args) => {
-    if (!shouldLog("debug"))
-      return;
-    console.log(formatTag(tag, "debug"), ...args);
-  },
-  info: (tag, ...args) => {
-    if (!shouldLog("info"))
-      return;
-    console.info(formatTag(tag, "info"), ...args);
-  },
-  warn: (tag, ...args) => {
-    if (!shouldLog("warn"))
-      return;
-    console.warn(formatTag(tag, "warn"), ...args);
-  },
-  error: (tag, ...args) => {
-    if (!shouldLog("error"))
-      return;
-    console.error(formatTag(tag, "error"), ...args);
-  }
-};
-var frameworkLoggers = {
-  hypen: createLogger("Hypen"),
-  engine: createLogger("Engine"),
-  router: createLogger("Router"),
-  state: createLogger("State"),
-  events: createLogger("Events"),
-  remote: createLogger("Remote"),
-  renderer: createLogger("Renderer"),
-  module: createLogger("Module"),
-  lifecycle: createLogger("Lifecycle"),
-  loader: createLogger("Loader"),
-  context: createLogger("Context"),
-  discovery: createLogger("Discovery"),
-  plugin: createLogger("Plugin"),
-  canvas: createLogger("Canvas"),
-  debug: createLogger("Debug")
-};
-
-// src/disposable.ts
-var log2 = frameworkLoggers.lifecycle;
-function isDisposable(obj) {
-  return obj !== null && typeof obj === "object" && "dispose" in obj && typeof obj.dispose === "function";
-}
-
-class DisposableStack {
-  stack = [];
-  disposed = false;
-  add(disposable) {
-    if (this.disposed) {
-      disposable.dispose();
-      return disposable;
-    }
-    this.stack.push(disposable);
-    return disposable;
-  }
-  addCallback(callback) {
-    this.add({ dispose: callback });
-  }
-  addValue(value, dispose) {
-    this.add({ dispose: () => dispose(value) });
-    return value;
-  }
-  dispose() {
-    if (this.disposed)
-      return;
-    this.disposed = true;
-    while (this.stack.length > 0) {
-      const item = this.stack.pop();
-      try {
-        item.dispose();
-      } catch (error) {
-        log2.error("Error during dispose:", error);
-      }
-    }
-  }
-  get isDisposed() {
-    return this.disposed;
-  }
-  get size() {
-    return this.stack.length;
-  }
-}
-function disposableListener(target, event, handler, options) {
-  target.addEventListener(event, handler, options);
-  return {
-    dispose: () => target.removeEventListener(event, handler, options)
-  };
-}
-function disposableTimeout(callback, ms) {
-  const id = setTimeout(callback, ms);
-  return {
-    id,
-    dispose: () => clearTimeout(id)
-  };
-}
-function disposableInterval(callback, ms) {
-  const id = setInterval(callback, ms);
-  return {
-    id,
-    dispose: () => clearInterval(id)
-  };
-}
-function disposableWebSocket(ws) {
-  return {
-    dispose: () => {
-      if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
-        ws.close();
-      }
-    }
-  };
-}
-function disposableAbortController() {
-  const controller = new AbortController;
-  return {
-    controller,
-    signal: controller.signal,
-    dispose: () => controller.abort()
-  };
-}
-function disposableSubscription(unsubscribe) {
-  return { dispose: unsubscribe };
-}
-var ELEMENT_DISPOSABLES = Symbol("hypen.disposables");
-function getElementDisposables(element) {
-  const existing = element[ELEMENT_DISPOSABLES];
-  if (existing instanceof DisposableStack) {
-    return existing;
-  }
-  const stack = new DisposableStack;
-  element[ELEMENT_DISPOSABLES] = stack;
-  return stack;
-}
-function disposeElement(element) {
-  const stack = element[ELEMENT_DISPOSABLES];
-  if (stack instanceof DisposableStack) {
-    stack.dispose();
-    delete element[ELEMENT_DISPOSABLES];
-  }
-}
-function hasElementDisposables(element) {
-  return element[ELEMENT_DISPOSABLES] instanceof DisposableStack;
-}
-
-class DisposableMixin {
-  disposables = new DisposableStack;
-  track(disposable) {
-    return this.disposables.add(disposable);
-  }
-  onDispose(callback) {
-    this.disposables.addCallback(callback);
-  }
-  dispose() {
-    this.disposables.dispose();
-  }
-}
-function compositeDisposable(...disposables) {
-  return {
-    dispose: () => {
-      for (const d of disposables) {
-        try {
-          d.dispose();
-        } catch (error) {
-          log2.error("Error during dispose:", error);
-        }
-      }
-    }
-  };
-}
-async function using(resource, fn) {
-  const r = typeof resource === "function" ? resource() : resource;
-  try {
-    return await fn(r);
-  } finally {
-    r.dispose();
-  }
-}
-function usingSync(resource, fn) {
-  const r = typeof resource === "function" ? resource() : resource;
-  try {
-    return fn(r);
-  } finally {
-    r.dispose();
-  }
-}
+import {
+  DisposableMixin,
+  DisposableStack,
+  compositeDisposable,
+  disposableAbortController,
+  disposableInterval,
+  disposableListener,
+  disposableSubscription,
+  disposableTimeout,
+  disposableWebSocket,
+  disposeElement,
+  getElementDisposables,
+  hasElementDisposables,
+  isDisposable,
+  using,
+  usingSync
+} from "./chunk-ec0tgy9a.js";
+import"./chunk-avchpwhf.js";
+import"./chunk-5gtx3pza.js";
 export {
   usingSync,
   using,
@@ -382,4 +35,4 @@ export {
   DisposableMixin
 };
 
-//# debugId=188F62A2B00EC44064756E2164756E21
+//# debugId=EE0648936A38884E64756E2164756E21

package/dist/disposable.js.map

@@ -1,11 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/logger.ts", "../src/disposable.ts"],
+  "sources": [],
   "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\" : \"info\",\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 * Disposable Pattern for Resource Management\n *\n * Provides a consistent way to manage and clean up resources like\n * event listeners, timers, WebSocket connections, etc.\n */\n\nimport { frameworkLoggers } from \"./logger.js\";\n\nconst log = frameworkLoggers.lifecycle;\n\n/**\n * Interface for objects that can be disposed\n */\nexport interface Disposable {\n  dispose(): void;\n}\n\n/**\n * Check if an object is Disposable\n */\nexport function isDisposable(obj: unknown): obj is Disposable {\n  return (\n    obj !== null &&\n    typeof obj === 'object' &&\n    'dispose' in obj &&\n    typeof (obj as Disposable).dispose === 'function'\n  );\n}\n\n/**\n * A stack of disposables that are disposed in LIFO order\n */\nexport class DisposableStack implements Disposable {\n  private stack: Disposable[] = [];\n  private disposed = false;\n\n  /**\n   * Add a disposable to the stack and return it\n   */\n  add<T extends Disposable>(disposable: T): T {\n    if (this.disposed) {\n      // If already disposed, immediately dispose the new item\n      disposable.dispose();\n      return disposable;\n    }\n    this.stack.push(disposable);\n    return disposable;\n  }\n\n  /**\n   * Add a cleanup callback to the stack\n   */\n  addCallback(callback: () => void): void {\n    this.add({ dispose: callback });\n  }\n\n  /**\n   * Add a value with a custom dispose function\n   */\n  addValue<T>(value: T, dispose: (value: T) => void): T {\n    this.add({ dispose: () => dispose(value) });\n    return value;\n  }\n\n  /**\n   * Dispose all items in reverse order (LIFO)\n   */\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n\n    while (this.stack.length > 0) {\n      const item = this.stack.pop()!;\n      try {\n        item.dispose();\n      } catch (error) {\n        // Log but continue disposing other items\n        log.error('Error during dispose:', error);\n      }\n    }\n  }\n\n  /**\n   * Check if this stack has been disposed\n   */\n  get isDisposed(): boolean {\n    return this.disposed;\n  }\n\n  /**\n   * Get the number of items in the stack\n   */\n  get size(): number {\n    return this.stack.length;\n  }\n}\n\n/**\n * Create a disposable from an event listener\n */\nexport function disposableListener(\n  target: EventTarget,\n  event: string,\n  handler: EventListenerOrEventListenerObject,\n  options?: AddEventListenerOptions\n): Disposable {\n  target.addEventListener(event, handler, options);\n  return {\n    dispose: () => target.removeEventListener(event, handler, options),\n  };\n}\n\n/**\n * Create a disposable from a timeout\n */\nexport function disposableTimeout(\n  callback: () => void,\n  ms: number\n): Disposable & { id: ReturnType<typeof setTimeout> } {\n  const id = setTimeout(callback, ms);\n  return {\n    id,\n    dispose: () => clearTimeout(id),\n  };\n}\n\n/**\n * Create a disposable from an interval\n */\nexport function disposableInterval(\n  callback: () => void,\n  ms: number\n): Disposable & { id: ReturnType<typeof setInterval> } {\n  const id = setInterval(callback, ms);\n  return {\n    id,\n    dispose: () => clearInterval(id),\n  };\n}\n\n/**\n * Create a disposable from a WebSocket\n */\nexport function disposableWebSocket(ws: WebSocket): Disposable {\n  return {\n    dispose: () => {\n      if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {\n        ws.close();\n      }\n    },\n  };\n}\n\n/**\n * Create a disposable from an AbortController\n */\nexport function disposableAbortController(): Disposable & { controller: AbortController; signal: AbortSignal } {\n  const controller = new AbortController();\n  return {\n    controller,\n    signal: controller.signal,\n    dispose: () => controller.abort(),\n  };\n}\n\n/**\n * Create a disposable subscription (for event emitters, observables, etc.)\n */\nexport function disposableSubscription(unsubscribe: () => void): Disposable {\n  return { dispose: unsubscribe };\n}\n\n/**\n * Symbol used to store disposables on DOM elements\n */\nconst ELEMENT_DISPOSABLES = Symbol('hypen.disposables');\n\n/**\n * Get or create a DisposableStack for an HTML element\n */\nexport function getElementDisposables(element: HTMLElement): DisposableStack {\n  const existing = (element as any)[ELEMENT_DISPOSABLES];\n  if (existing instanceof DisposableStack) {\n    return existing;\n  }\n  const stack = new DisposableStack();\n  (element as any)[ELEMENT_DISPOSABLES] = stack;\n  return stack;\n}\n\n/**\n * Dispose all disposables attached to an element\n */\nexport function disposeElement(element: HTMLElement): void {\n  const stack = (element as any)[ELEMENT_DISPOSABLES];\n  if (stack instanceof DisposableStack) {\n    stack.dispose();\n    delete (element as any)[ELEMENT_DISPOSABLES];\n  }\n}\n\n/**\n * Check if an element has disposables\n */\nexport function hasElementDisposables(element: HTMLElement): boolean {\n  return (element as any)[ELEMENT_DISPOSABLES] instanceof DisposableStack;\n}\n\n/**\n * Decorator/helper to make a class disposable\n * Tracks all resources and disposes them when dispose() is called\n */\nexport class DisposableMixin {\n  protected disposables = new DisposableStack();\n\n  /**\n   * Register a disposable to be cleaned up\n   */\n  protected track<T extends Disposable>(disposable: T): T {\n    return this.disposables.add(disposable);\n  }\n\n  /**\n   * Register a cleanup callback\n   */\n  protected onDispose(callback: () => void): void {\n    this.disposables.addCallback(callback);\n  }\n\n  /**\n   * Dispose all tracked resources\n   */\n  dispose(): void {\n    this.disposables.dispose();\n  }\n}\n\n/**\n * Create a composite disposable that disposes multiple items together\n */\nexport function compositeDisposable(...disposables: Disposable[]): Disposable {\n  return {\n    dispose: () => {\n      for (const d of disposables) {\n        try {\n          d.dispose();\n        } catch (error) {\n          log.error('Error during dispose:', error);\n        }\n      }\n    },\n  };\n}\n\n/**\n * Run a function with automatic cleanup on exit\n * Similar to Python's context managers or C#'s using statement\n */\nexport async function using<T extends Disposable, R>(\n  resource: T | (() => T),\n  fn: (resource: T) => R | Promise<R>\n): Promise<R> {\n  const r = typeof resource === 'function' ? resource() : resource;\n  try {\n    return await fn(r);\n  } finally {\n    r.dispose();\n  }\n}\n\n/**\n * Synchronous version of using()\n */\nexport function usingSync<T extends Disposable, R>(\n  resource: T | (() => T),\n  fn: (resource: T) => R\n): R {\n  const r = typeof resource === 'function' ? resource() : resource;\n  try {\n    return fn(r);\n  } finally {\n    r.dispose();\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "188F62A2B00EC44064756E2164756E21",
+  "mappings": "",
+  "debugId": "EE0648936A38884E64756E2164756E21",
   "names": []
 }

package/dist/engine-base.d.ts

@@ -44,6 +44,15 @@ import type { Action, RenderCallback, ActionHandler, ComponentResolver } from ".
 export declare abstract class BaseEngine {
     protected wasmEngine: any;
     protected initialized: boolean;
+    /**
+     * Component names the resolver was asked for and returned `null` on — i.e.
+     * names that are neither a registered primitive (the engine checks those
+     * first and never consults the resolver for them) nor resolvable to a
+     * template. Each such name produces an opaque `Create` patch the renderer
+     * drops. Tracked so a miss is warned about once and can be asserted on in
+     * tests. See `getUnresolvedComponents`.
+     */
+    private unresolvedComponents;
     /**
      * Initialize the WASM module. Platform-specific.
      *
@@ -71,8 +80,23 @@ export declare abstract class BaseEngine {
     setRenderCallback(callback: RenderCallback): void;
     /**
      * Set the component resolver for dynamic component composition.
+     *
+     * The resolver is wrapped to detect "resolver misses": the engine only
+     * consults the resolver for element types that are NOT registered
+     * primitives, so a `null` return means the name resolves to nothing and
+     * the engine will emit an opaque `Create` the renderer silently drops
+     * (e.g. an anonymous component that never got registered). The first miss
+     * for each unique name is logged with actionable guidance; every miss is
+     * recorded for `getUnresolvedComponents()` / test assertions.
      */
     setComponentResolver(resolver: ComponentResolver): void;
+    /**
+     * Names the component resolver has been asked for and failed to resolve
+     * this session (see `setComponentResolver`). Useful as a CI / smoke-test
+     * assertion — an empty array means every referenced component resolved to
+     * a primitive or a template.
+     */
+    getUnresolvedComponents(): string[];
     /**
      * Parse and render Hypen DSL source code.
      * @throws {ParseError} if the source fails to parse
@@ -122,8 +146,20 @@ export declare abstract class BaseEngine {
     onAction(actionName: string, handler: ActionHandler): void;
     /**
      * Platform hook: normalize an incoming action before the user handler
-     * sees it. Default identity; subclasses can override to unwrap native
-     * values (e.g. browser Maps in action payloads).
+     * sees it.
+     *
+     * The default converts any `Map` instances in the payload into plain
+     * objects (deeply). This is the landmine the wasm-bindgen **web** target
+     * sets: it returns structured action payloads as JS `Map`s, so a handler
+     * reading `payload.to` gets `undefined` and `@router.push, to: "/x"`
+     * silently no-ops. Every consumer of the web-target WASM — the browser
+     * engine, a Cloudflare `CFEngine`, any future runtime — inherits the fix
+     * here instead of rediscovering it.
+     *
+     * The wasm-bindgen **bundler** (node) target already returns plain
+     * objects, so for it this is a harmless deep walk. Subclasses on that
+     * target may override with an identity to skip the walk (see
+     * `@hypen-space/server`).
      */
     protected normalizeAction(action: Action): Action;
     /**