@hypen-space/core 0.4.37 → 0.4.39

package/dist/context.js

@@ -22,12 +22,31 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // 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;
 }
@@ -158,70 +177,48 @@ class Logger {
 function createLogger(tag) {
   return new Logger(tag);
 }
-var LOG_LEVEL_ORDER, LOG_LEVEL_COLORS, RESET_COLOR = "\x1B[0m", config, logger, log, frameworkLoggers;
-var init_logger = __esm(() => {
-  LOG_LEVEL_ORDER = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    none: 4
-  };
-  LOG_LEVEL_COLORS = {
-    debug: "\x1B[36m",
-    info: "\x1B[32m",
-    warn: "\x1B[33m",
-    error: "\x1B[31m"
-  };
-  config = {
-    level: isProduction() ? "error" : "info",
-    colors: true,
-    timestamps: false
-  };
-  logger = createLogger("Hypen");
-  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);
-    }
-  };
-  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")
-  };
-});
+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/events.ts
-init_logger();
 var log2 = frameworkLoggers.events;
 
 class TypedEventEmitter {
@@ -287,13 +284,11 @@ function createEventEmitter() {
 }
 
 // src/context.ts
-init_logger();
 var log3 = frameworkLoggers.context;
 
 class HypenGlobalContext {
   modules = new Map;
   typedEvents;
-  legacyEventBus = new Map;
   constructor() {
     this.typedEvents = new TypedEventEmitter;
   }
@@ -336,57 +331,30 @@ class HypenGlobalContext {
     return state;
   }
   emit(event, payload) {
-    const handlers = this.legacyEventBus.get(event);
-    if (!handlers || handlers.size === 0) {
+    if (this.typedEvents.listenerCount(event) === 0) {
       log3.debug(`Event "${event}" emitted but no listeners`);
-    } else {
-      log3.debug(`Emitting event: ${event}`, payload);
-      handlers.forEach((handler) => {
-        try {
-          handler(payload);
-        } catch (error) {
-          log3.error(`Error in event handler for "${event}":`, error);
-        }
-      });
-    }
-    if (this.typedEvents.listenerCount(event) > 0) {
-      this.typedEvents.emit(event, payload);
+      return;
     }
+    log3.debug(`Emitting event: ${event}`, payload);
+    this.typedEvents.emit(event, payload);
   }
   on(event, handler) {
-    if (!this.legacyEventBus.has(event)) {
-      this.legacyEventBus.set(event, new Set);
-    }
-    const handlers = this.legacyEventBus.get(event);
-    handlers.add(handler);
     log3.debug(`Listening to event: ${event}`);
-    return () => {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.legacyEventBus.delete(event);
-      }
-    };
+    return this.typedEvents.on(event, handler);
   }
   off(event, handler) {
-    const handlers = this.legacyEventBus.get(event);
-    if (handlers) {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.legacyEventBus.delete(event);
-      }
-    }
+    this.typedEvents.off(event, handler);
   }
   clearEvent(event) {
-    this.legacyEventBus.delete(event);
+    this.typedEvents.removeAllListeners(event);
   }
   clearAllEvents() {
-    this.legacyEventBus.clear();
+    this.typedEvents.clearAll();
   }
   debug() {
     return {
       modules: this.getModuleIds(),
-      events: Array.from(this.legacyEventBus.keys()),
-      typedEvents: this.typedEvents.eventNames(),
+      events: this.typedEvents.eventNames(),
       state: this.getGlobalState()
     };
   }
@@ -395,4 +363,4 @@ export {
   HypenGlobalContext
 };
 
-//# debugId=8FE23F2EDADEE4C164756E2164756E21
+//# debugId=15181C1F85F2427864756E2164756E21

package/dist/context.js.map

@@ -4,9 +4,9 @@
   "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 * Type-safe Event System\n *\n * Provides strongly-typed event emission and subscription with autocomplete support.\n */\n\nimport { frameworkLoggers } from \"./logger.js\";\n\nconst log = frameworkLoggers.events;\n\nexport type EventHandler<T = unknown> = (payload: T) => void;\n\n/**\n * Type-safe event emitter with generics\n */\nexport class TypedEventEmitter<TEvents extends Record<string, unknown> = Record<string, unknown>> {\n  private eventBus = new Map<keyof TEvents, Set<EventHandler<any>>>();\n\n  /**\n   * Emit an event with type-safe payload\n   */\n  emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void {\n    const handlers = this.eventBus.get(event);\n    if (!handlers || handlers.size === 0) {\n      return;\n    }\n\n    handlers.forEach((handler) => {\n      try {\n        handler(payload);\n      } catch (error) {\n        log.error(`Error in event handler for \"${String(event)}\":`, error);\n      }\n    });\n  }\n\n  /**\n   * Subscribe to an event with type-safe payload\n   * Returns an unsubscribe function\n   */\n  on<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): () => void {\n    if (!this.eventBus.has(event)) {\n      this.eventBus.set(event, new Set());\n    }\n\n    const handlers = this.eventBus.get(event)!;\n    handlers.add(handler);\n\n    // Return unsubscribe function\n    return () => {\n      handlers.delete(handler);\n      if (handlers.size === 0) {\n        this.eventBus.delete(event);\n      }\n    };\n  }\n\n  /**\n   * Subscribe to an event once (auto-unsubscribe after first emit)\n   */\n  once<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): () => void {\n    const wrappedHandler = (payload: TEvents[K]) => {\n      handler(payload);\n      unsubscribe();\n    };\n\n    const unsubscribe = this.on(event, wrappedHandler);\n    return unsubscribe;\n  }\n\n  /**\n   * Unsubscribe a specific handler from an event\n   */\n  off<K extends keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): void {\n    const handlers = this.eventBus.get(event);\n    if (handlers) {\n      handlers.delete(handler);\n      if (handlers.size === 0) {\n        this.eventBus.delete(event);\n      }\n    }\n  }\n\n  /**\n   * Remove all listeners for a specific event\n   */\n  removeAllListeners<K extends keyof TEvents>(event: K): void {\n    this.eventBus.delete(event);\n  }\n\n  /**\n   * Remove all listeners for all events\n   */\n  clearAll(): void {\n    this.eventBus.clear();\n  }\n\n  /**\n   * Get the number of listeners for an event\n   */\n  listenerCount<K extends keyof TEvents>(event: K): number {\n    return this.eventBus.get(event)?.size ?? 0;\n  }\n\n  /**\n   * Get all registered event names\n   */\n  eventNames(): Array<keyof TEvents> {\n    return Array.from(this.eventBus.keys());\n  }\n}\n\n/**\n * Default events for Hypen framework (can be extended by users)\n */\nexport type HypenFrameworkEvents = {\n  'module:created': { moduleId: string };\n  'module:destroyed': { moduleId: string };\n  'route:changed': { from: string | null; to: string };\n  'state:updated': { moduleId: string; paths: string[] };\n  'action:dispatched': { moduleId: string; actionName: string; payload?: unknown };\n  'error': { message: string; error?: Error; context?: string };\n};\n\n/**\n * Create a typed event emitter with custom event map\n */\nexport function createEventEmitter<TEvents extends Record<string, unknown> = HypenFrameworkEvents>(): TypedEventEmitter<TEvents> {\n  return new TypedEventEmitter<TEvents>();\n}\n",
-    "/**\n * Global Context - Cross-module communication and state access\n */\n\nimport type { HypenModuleInstance } from \"./app.js\";\nimport { getStateSnapshot } from \"./state.js\";\nimport { TypedEventEmitter, type HypenFrameworkEvents } from \"./events.js\";\nimport { frameworkLoggers } from \"./logger.js\";\n\nconst log = frameworkLoggers.context;\n\nexport type ModuleReference<T = unknown> = {\n  /**\n   * Live proxy state - mutations are tracked and trigger re-renders.\n   * Use `getState()` for a snapshot if you only need to read values.\n   */\n  state: T;\n  setState: (patch: Partial<T>) => void;\n  /**\n   * Returns a deep-cloned snapshot of the current state.\n   * Unlike `state`, mutations to the returned object are NOT tracked.\n   */\n  getState: () => T;\n};\n\n/**\n * @deprecated Use TypedEventEmitter from events.ts for type-safe events\n */\nexport type EventHandler = (payload?: unknown) => void;\n\n/**\n * Global Context - Provides access to all modules and cross-module communication\n *\n * @template TEvents - Custom event map (extends HypenFrameworkEvents)\n */\nexport class HypenGlobalContext<TEvents extends Record<string, unknown> = HypenFrameworkEvents> {\n  private modules = new Map<string, HypenModuleInstance>();\n  private typedEvents: TypedEventEmitter<TEvents>;\n\n  /**\n   * @deprecated Legacy event bus for backward compatibility\n   */\n  private legacyEventBus = new Map<string, Set<EventHandler>>();\n\n  constructor() {\n    this.typedEvents = new TypedEventEmitter<TEvents>();\n  }\n\n  /**\n   * Get the typed event emitter for type-safe event handling\n   */\n  get events(): TypedEventEmitter<TEvents> {\n    return this.typedEvents;\n  }\n\n  /**\n   * Register a module instance with an ID\n   */\n  registerModule(id: string, instance: HypenModuleInstance) {\n    if (this.modules.has(id)) {\n      log.warn(`Module \"${id}\" is already registered. Overwriting.`);\n    }\n    this.modules.set(id, instance);\n    log.debug(`Registered module: ${id}`);\n  }\n\n  /**\n   * Unregister a module\n   */\n  unregisterModule(id: string) {\n    this.modules.delete(id);\n    log.debug(`Unregistered module: ${id}`);\n  }\n\n  /**\n   * Get a module by ID with type safety\n   */\n  getModule<T = unknown>(id: string): ModuleReference<T> {\n    const module = this.modules.get(id);\n    if (!module) {\n      throw new Error(\n        `Module \"${id}\" not found. Available modules: ${Array.from(this.modules.keys()).join(\", \")}`\n      );\n    }\n\n    return {\n      state: module.getLiveState() as T,\n      setState: (patch: Partial<T>) => module.updateState(patch),\n      getState: () => module.getState() as T,\n    };\n  }\n\n  /**\n   * Check if a module exists\n   */\n  hasModule(id: string): boolean {\n    return this.modules.has(id);\n  }\n\n  /**\n   * Get all registered module IDs\n   */\n  getModuleIds(): string[] {\n    return Array.from(this.modules.keys());\n  }\n\n  /**\n   * Get the entire app state tree (snapshot)\n   */\n  getGlobalState(): Record<string, unknown> {\n    const state: Record<string, unknown> = {};\n    this.modules.forEach((module, id) => {\n      state[id] = module.getState();\n    });\n    return state;\n  }\n\n  /**\n   * Emit an event to the event bus (legacy API for backward compatibility)\n   * @deprecated Use `context.events.emit()` for type-safe events\n   */\n  emit(event: string, payload?: unknown): void {\n    const handlers = this.legacyEventBus.get(event);\n    if (!handlers || handlers.size === 0) {\n      log.debug(`Event \"${event}\" emitted but no listeners`);\n    } else {\n      log.debug(`Emitting event: ${event}`, payload);\n      handlers.forEach((handler) => {\n        try {\n          handler(payload);\n        } catch (error) {\n          log.error(`Error in event handler for \"${event}\":`, error);\n        }\n      });\n    }\n\n    // Also emit to typed event system if the event is registered there\n    if (this.typedEvents.listenerCount(event as keyof TEvents) > 0) {\n      this.typedEvents.emit(event as keyof TEvents, payload as TEvents[keyof TEvents]);\n    }\n  }\n\n  /**\n   * Subscribe to an event (legacy API for backward compatibility)\n   * @deprecated Use `context.events.on()` for type-safe events\n   */\n  on(event: string, handler: EventHandler): () => void {\n    if (!this.legacyEventBus.has(event)) {\n      this.legacyEventBus.set(event, new Set());\n    }\n\n    const handlers = this.legacyEventBus.get(event)!;\n    handlers.add(handler);\n\n    log.debug(`Listening to event: ${event}`);\n\n    // Return unsubscribe function\n    return () => {\n      handlers.delete(handler);\n      if (handlers.size === 0) {\n        this.legacyEventBus.delete(event);\n      }\n    };\n  }\n\n  /**\n   * Unsubscribe from an event (legacy API)\n   * @deprecated Use the unsubscribe function returned by `context.events.on()`\n   */\n  off(event: string, handler: EventHandler): void {\n    const handlers = this.legacyEventBus.get(event);\n    if (handlers) {\n      handlers.delete(handler);\n      if (handlers.size === 0) {\n        this.legacyEventBus.delete(event);\n      }\n    }\n  }\n\n  /**\n   * Clear all event listeners for an event (legacy API)\n   * @deprecated Use `context.events.removeAllListeners()`\n   */\n  clearEvent(event: string): void {\n    this.legacyEventBus.delete(event);\n  }\n\n  /**\n   * Clear all event listeners (legacy API)\n   * @deprecated Use `context.events.clearAll()`\n   */\n  clearAllEvents(): void {\n    this.legacyEventBus.clear();\n  }\n\n  /**\n   * Get debug info about the context\n   */\n  debug(): {\n    modules: string[];\n    events: string[];\n    typedEvents: Array<keyof TEvents>;\n    state: Record<string, unknown>;\n  } {\n    return {\n      modules: this.getModuleIds(),\n      events: Array.from(this.legacyEventBus.keys()),\n      typedEvents: this.typedEvents.eventNames(),\n      state: this.getGlobalState(),\n    };\n  }\n}\n"
+    "/**\n * Global Context - Cross-module communication and state access\n */\n\nimport type { HypenModuleInstance } from \"./app.js\";\nimport { getStateSnapshot } from \"./state.js\";\nimport { TypedEventEmitter, type HypenFrameworkEvents } from \"./events.js\";\nimport { frameworkLoggers } from \"./logger.js\";\n\nconst log = frameworkLoggers.context;\n\nexport type ModuleReference<T = unknown> = {\n  /**\n   * Live proxy state - mutations are tracked and trigger re-renders.\n   * Use `getState()` for a snapshot if you only need to read values.\n   */\n  state: T;\n  setState: (patch: Partial<T>) => void;\n  /**\n   * Returns a deep-cloned snapshot of the current state.\n   * Unlike `state`, mutations to the returned object are NOT tracked.\n   */\n  getState: () => T;\n};\n\nexport type EventHandler = (payload?: unknown) => void;\n\n/**\n * Global Context - Provides access to all modules and cross-module communication\n *\n * @template TEvents - Custom event map (extends HypenFrameworkEvents)\n */\nexport class HypenGlobalContext<TEvents extends Record<string, unknown> = HypenFrameworkEvents> {\n  private modules = new Map<string, HypenModuleInstance>();\n  private typedEvents: TypedEventEmitter<TEvents & Record<string, unknown>>;\n\n  constructor() {\n    this.typedEvents = new TypedEventEmitter<TEvents & Record<string, unknown>>();\n  }\n\n  /**\n   * Get the typed event emitter for type-safe event handling\n   */\n  get events(): TypedEventEmitter<TEvents & Record<string, unknown>> {\n    return this.typedEvents;\n  }\n\n  /**\n   * Register a module instance with an ID\n   */\n  registerModule(id: string, instance: HypenModuleInstance) {\n    if (this.modules.has(id)) {\n      log.warn(`Module \"${id}\" is already registered. Overwriting.`);\n    }\n    this.modules.set(id, instance);\n    log.debug(`Registered module: ${id}`);\n  }\n\n  /**\n   * Unregister a module\n   */\n  unregisterModule(id: string) {\n    this.modules.delete(id);\n    log.debug(`Unregistered module: ${id}`);\n  }\n\n  /**\n   * Get a module by ID with type safety\n   */\n  getModule<T = unknown>(id: string): ModuleReference<T> {\n    const module = this.modules.get(id);\n    if (!module) {\n      throw new Error(\n        `Module \"${id}\" not found. Available modules: ${Array.from(this.modules.keys()).join(\", \")}`\n      );\n    }\n\n    return {\n      state: module.getLiveState() as T,\n      setState: (patch: Partial<T>) => module.updateState(patch),\n      getState: () => module.getState() as T,\n    };\n  }\n\n  /**\n   * Check if a module exists\n   */\n  hasModule(id: string): boolean {\n    return this.modules.has(id);\n  }\n\n  /**\n   * Get all registered module IDs\n   */\n  getModuleIds(): string[] {\n    return Array.from(this.modules.keys());\n  }\n\n  /**\n   * Get the entire app state tree (snapshot)\n   */\n  getGlobalState(): Record<string, unknown> {\n    const state: Record<string, unknown> = {};\n    this.modules.forEach((module, id) => {\n      state[id] = module.getState();\n    });\n    return state;\n  }\n\n  /**\n   * Emit an event. Delegates to the TypedEventEmitter.\n   */\n  emit(event: string, payload?: unknown): void {\n    if (this.typedEvents.listenerCount(event) === 0) {\n      log.debug(`Event \"${event}\" emitted but no listeners`);\n      return;\n    }\n    log.debug(`Emitting event: ${event}`, payload);\n    this.typedEvents.emit(event, payload as TEvents[string]);\n  }\n\n  /**\n   * Subscribe to an event. Delegates to the TypedEventEmitter.\n   * Returns an unsubscribe function.\n   */\n  on(event: string, handler: EventHandler): () => void {\n    log.debug(`Listening to event: ${event}`);\n    return this.typedEvents.on(event, handler);\n  }\n\n  /**\n   * Unsubscribe a specific handler from an event.\n   * Delegates to the TypedEventEmitter.\n   */\n  off(event: string, handler: EventHandler): void {\n    this.typedEvents.off(event, handler);\n  }\n\n  /**\n   * Remove all listeners for a specific event.\n   * Delegates to the TypedEventEmitter.\n   */\n  clearEvent(event: string): void {\n    this.typedEvents.removeAllListeners(event);\n  }\n\n  /**\n   * Remove all listeners for all events.\n   * Delegates to the TypedEventEmitter.\n   */\n  clearAllEvents(): void {\n    this.typedEvents.clearAll();\n  }\n\n  /**\n   * Get debug info about the context\n   */\n  debug(): {\n    modules: string[];\n    events: Array<keyof TEvents | string>;\n    state: Record<string, unknown>;\n  } {\n    return {\n      modules: this.getModuleIds(),\n      events: this.typedEvents.eventNames() as Array<keyof TEvents | string>,\n      state: this.getGlobalState(),\n    };\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "8FE23F2EDADEE4C164756E2164756E21",
+  "mappings": "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",
+  "debugId": "15181C1F85F2427864756E2164756E21",
   "names": []
 }

package/dist/datasource.js

@@ -0,0 +1,80 @@
+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/datasource.ts
+class DataSourceManager {
+  plugins = new Map;
+  configs = new Map;
+  state = new Map;
+  engine;
+  constructor(engine) {
+    this.engine = engine;
+  }
+  async use(plugin, config) {
+    const { name } = plugin;
+    this.state.set(name, {});
+    this.plugins.set(name, plugin);
+    this.configs.set(name, config);
+    await plugin.connect(config, (change) => {
+      const current = this.state.get(name) ?? {};
+      for (const path of change.paths) {
+        if (path in change.values) {
+          current[path] = change.values[path];
+        }
+      }
+      this.state.set(name, current);
+      this.engine.setContext(name, current);
+    });
+  }
+  get(name) {
+    return this.plugins.get(name);
+  }
+  has(name) {
+    return this.plugins.has(name);
+  }
+  getNames() {
+    return Array.from(this.plugins.keys());
+  }
+  getStatus(name) {
+    return this.plugins.get(name)?.status;
+  }
+  async remove(name) {
+    const plugin = this.plugins.get(name);
+    if (plugin) {
+      await plugin.disconnect();
+      this.plugins.delete(name);
+      this.configs.delete(name);
+      this.state.delete(name);
+      this.engine.removeContext(name);
+    }
+  }
+  async disconnectAll() {
+    const names = Array.from(this.plugins.keys());
+    await Promise.all(names.map((name) => this.remove(name)));
+  }
+}
+export {
+  DataSourceManager
+};
+
+//# debugId=AF74FE0EA693C3E564756E2164756E21

package/dist/datasource.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/datasource.ts"],
+  "sourcesContent": [
+    "/**\n * Data Source Plugin System for Hypen\n *\n * Enables live subscription databases (SpacetimeDB, Firebase, Convex, Electric SQL)\n * to push data into the Hypen reactive engine via a unified plugin interface.\n *\n * UI bindings use the `$provider.path` syntax:\n *   - `$spacetime.messages` → SpacetimeDB messages table\n *   - `$firebase.user.profile` → Firebase user profile\n *   - `$convex.tasks` → Convex tasks table\n *\n * @module\n */\n\n// ---------------------------------------------------------------------------\n// Core Types\n// ---------------------------------------------------------------------------\n\n/** Connection status for a data source provider */\nexport type DataSourceStatus =\n  | \"disconnected\"\n  | \"connecting\"\n  | \"connected\"\n  | \"reconnecting\"\n  | \"error\";\n\n/** Describes a subscription to a table or query */\nexport interface DataSourceQuery {\n  /** Table or collection name (e.g., \"messages\", \"users\") */\n  table: string;\n  /** Optional filter criteria */\n  filter?: Record<string, unknown>;\n  /** Optional raw query string (e.g., SQL for SpacetimeDB) */\n  sql?: string;\n}\n\n/** Handle returned by subscribe() — call unsubscribe() to stop receiving updates */\nexport interface DataSourceSubscription {\n  /** Stop receiving updates for this subscription */\n  unsubscribe(): void;\n  /** Current subscription status */\n  status: \"pending\" | \"applied\" | \"error\";\n  /** Error details if status is \"error\" */\n  error?: Error;\n}\n\n/** Describes a batch of changes pushed by a plugin */\nexport interface DataSourceChange {\n  /** Changed paths relative to the provider root (e.g., [\"messages\", \"users\"]) */\n  paths: string[];\n  /** New values at those paths */\n  values: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Plugin Interface\n// ---------------------------------------------------------------------------\n\n/**\n * Interface that all data source plugins must implement.\n *\n * A plugin manages the connection lifecycle and translates database-specific\n * events (row inserts, updates, deletes) into `DataSourceChange` objects that\n * the Hypen engine can consume.\n *\n * @typeParam TConfig - Plugin-specific configuration type\n *\n * @example\n * ```typescript\n * class SpacetimeDBPlugin implements DataSourcePlugin<SpacetimeDBConfig> {\n *   readonly name = \"spacetime\";\n *   status: DataSourceStatus = \"disconnected\";\n *\n *   async connect(config: SpacetimeDBConfig, onChange: (change: DataSourceChange) => void) {\n *     // Connect to SpacetimeDB, subscribe to tables, push changes via onChange\n *   }\n *   // ...\n * }\n * ```\n */\nexport interface DataSourcePlugin<TConfig = unknown> {\n  /** Unique provider name (e.g., \"spacetime\", \"firebase\", \"convex\") */\n  readonly name: string;\n\n  /** Current connection status */\n  status: DataSourceStatus;\n\n  /**\n   * Connect to the data source and begin pushing changes.\n   *\n   * @param config - Plugin-specific configuration\n   * @param onChange - Callback to push data changes into the engine.\n   *   The plugin MUST call this whenever subscribed data changes.\n   */\n  connect(config: TConfig, onChange: (change: DataSourceChange) => void): Promise<void>;\n\n  /**\n   * Subscribe to a specific table or query.\n   * Returns a handle to unsubscribe later.\n   */\n  subscribe(query: DataSourceQuery): DataSourceSubscription;\n\n  /**\n   * Call a remote procedure / reducer / mutation.\n   *\n   * @param method - Method name (e.g., \"sendMessage\" for SpacetimeDB reducer)\n   * @param args - Arguments to pass\n   * @returns The result from the remote call\n   */\n  call(method: string, ...args: unknown[]): Promise<unknown>;\n\n  /**\n   * Disconnect from the data source and clean up all subscriptions.\n   */\n  disconnect(): Promise<void>;\n}\n\n// ---------------------------------------------------------------------------\n// Data Source Manager\n// ---------------------------------------------------------------------------\n\n/** Interface for the engine's data source operations (maps to WASM setContext/removeContext) */\nexport interface IDataSourceEngine {\n  /**\n   * Set (or replace) a named data source context.\n   * Registers the provider, stores the data, and re-renders bound nodes.\n   * Sparse merging should happen at the SDK layer before calling this.\n   */\n  setContext(name: string, data: Record<string, unknown>): void;\n  /**\n   * Remove a data source context entirely.\n   * Drops the provider's state and re-renders bound nodes (they resolve to null).\n   */\n  removeContext(name: string): void;\n}\n\n/**\n * Manages data source plugin lifecycles and bridges them to the Hypen engine.\n *\n * The manager:\n * 1. Registers plugins with the engine (creates state slots)\n * 2. Connects plugins and wires their onChange callbacks to engine updates\n * 3. Manages subscription lifecycles\n * 4. Handles cleanup on disconnect\n *\n * @example\n * ```typescript\n * const manager = new DataSourceManager(engine);\n *\n * // Register and connect a SpacetimeDB plugin\n * await manager.use(new SpacetimeDBPlugin(), {\n *   uri: \"ws://localhost:3000\",\n *   moduleName: \"chat\",\n *   tables: [\"user\", \"message\"],\n * });\n *\n * // Access plugin for mutations\n * await manager.get(\"spacetime\").call(\"sendMessage\", \"Hello!\");\n *\n * // Clean up\n * await manager.disconnectAll();\n * ```\n */\nexport class DataSourceManager {\n  private plugins = new Map<string, DataSourcePlugin>();\n  private configs = new Map<string, unknown>();\n  /** Accumulated state per provider — sparse merging happens here before setContext */\n  private state = new Map<string, Record<string, unknown>>();\n  private engine: IDataSourceEngine;\n\n  constructor(engine: IDataSourceEngine) {\n    this.engine = engine;\n  }\n\n  /**\n   * Register, connect, and start a data source plugin.\n   *\n   * @param plugin - The plugin instance\n   * @param config - Plugin-specific configuration\n   */\n  async use<C>(plugin: DataSourcePlugin<C>, config: C): Promise<void> {\n    const { name } = plugin;\n\n    // Initialize state slot\n    this.state.set(name, {});\n\n    // Store references\n    this.plugins.set(name, plugin as DataSourcePlugin);\n    this.configs.set(name, config);\n\n    // Connect the plugin with an onChange callback that merges sparse data\n    // and pushes the full state via setContext\n    await plugin.connect(config, (change: DataSourceChange) => {\n      // Merge changed paths into the accumulated state\n      const current = this.state.get(name) ?? {};\n      for (const path of change.paths) {\n        if (path in change.values) {\n          current[path] = change.values[path];\n        }\n      }\n      this.state.set(name, current);\n\n      // Push the full merged state to the engine\n      this.engine.setContext(name, current);\n    });\n  }\n\n  /**\n   * Get a registered plugin by name.\n   * Useful for calling mutations: `manager.get(\"spacetime\").call(\"sendMessage\", text)`\n   */\n  get<T extends DataSourcePlugin = DataSourcePlugin>(name: string): T | undefined {\n    return this.plugins.get(name) as T | undefined;\n  }\n\n  /** Check if a plugin is registered */\n  has(name: string): boolean {\n    return this.plugins.has(name);\n  }\n\n  /** Get all registered provider names */\n  getNames(): string[] {\n    return Array.from(this.plugins.keys());\n  }\n\n  /** Get the status of a specific plugin */\n  getStatus(name: string): DataSourceStatus | undefined {\n    return this.plugins.get(name)?.status;\n  }\n\n  /**\n   * Disconnect and remove a specific plugin.\n   */\n  async remove(name: string): Promise<void> {\n    const plugin = this.plugins.get(name);\n    if (plugin) {\n      await plugin.disconnect();\n      this.plugins.delete(name);\n      this.configs.delete(name);\n      this.state.delete(name);\n      this.engine.removeContext(name);\n    }\n  }\n\n  /**\n   * Disconnect all plugins and clean up.\n   */\n  async disconnectAll(): Promise<void> {\n    const names = Array.from(this.plugins.keys());\n    await Promise.all(names.map((name) => this.remove(name)));\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;AAmKO,MAAM,kBAAkB;AAAA,EACrB,UAAU,IAAI;AAAA,EACd,UAAU,IAAI;AAAA,EAEd,QAAQ,IAAI;AAAA,EACZ;AAAA,EAER,WAAW,CAAC,QAA2B;AAAA,IACrC,KAAK,SAAS;AAAA;AAAA,OASV,IAAM,CAAC,QAA6B,QAA0B;AAAA,IAClE,QAAQ,SAAS;AAAA,IAGjB,KAAK,MAAM,IAAI,MAAM,CAAC,CAAC;AAAA,IAGvB,KAAK,QAAQ,IAAI,MAAM,MAA0B;AAAA,IACjD,KAAK,QAAQ,IAAI,MAAM,MAAM;AAAA,IAI7B,MAAM,OAAO,QAAQ,QAAQ,CAAC,WAA6B;AAAA,MAEzD,MAAM,UAAU,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC;AAAA,MACzC,WAAW,QAAQ,OAAO,OAAO;AAAA,QAC/B,IAAI,QAAQ,OAAO,QAAQ;AAAA,UACzB,QAAQ,QAAQ,OAAO,OAAO;AAAA,QAChC;AAAA,MACF;AAAA,MACA,KAAK,MAAM,IAAI,MAAM,OAAO;AAAA,MAG5B,KAAK,OAAO,WAAW,MAAM,OAAO;AAAA,KACrC;AAAA;AAAA,EAOH,GAAkD,CAAC,MAA6B;AAAA,IAC9E,OAAO,KAAK,QAAQ,IAAI,IAAI;AAAA;AAAA,EAI9B,GAAG,CAAC,MAAuB;AAAA,IACzB,OAAO,KAAK,QAAQ,IAAI,IAAI;AAAA;AAAA,EAI9B,QAAQ,GAAa;AAAA,IACnB,OAAO,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC;AAAA;AAAA,EAIvC,SAAS,CAAC,MAA4C;AAAA,IACpD,OAAO,KAAK,QAAQ,IAAI,IAAI,GAAG;AAAA;AAAA,OAM3B,OAAM,CAAC,MAA6B;AAAA,IACxC,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;AAAA,IACpC,IAAI,QAAQ;AAAA,MACV,MAAM,OAAO,WAAW;AAAA,MACxB,KAAK,QAAQ,OAAO,IAAI;AAAA,MACxB,KAAK,QAAQ,OAAO,IAAI;AAAA,MACxB,KAAK,MAAM,OAAO,IAAI;AAAA,MACtB,KAAK,OAAO,cAAc,IAAI;AAAA,IAChC;AAAA;AAAA,OAMI,cAAa,GAAkB;AAAA,IACnC,MAAM,QAAQ,MAAM,KAAK,KAAK,QAAQ,KAAK,CAAC;AAAA,IAC5C,MAAM,QAAQ,IAAI,MAAM,IAAI,CAAC,SAAS,KAAK,OAAO,IAAI,CAAC,CAAC;AAAA;AAE5D;",
+  "debugId": "AF74FE0EA693C3E564756E2164756E21",
+  "names": []
+}

package/dist/disposable.js

@@ -22,12 +22,31 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // 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;
 }
@@ -158,70 +177,48 @@ class Logger {
 function createLogger(tag) {
   return new Logger(tag);
 }
-var LOG_LEVEL_ORDER, LOG_LEVEL_COLORS, RESET_COLOR = "\x1B[0m", config, logger, log, frameworkLoggers;
-var init_logger = __esm(() => {
-  LOG_LEVEL_ORDER = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    none: 4
-  };
-  LOG_LEVEL_COLORS = {
-    debug: "\x1B[36m",
-    info: "\x1B[32m",
-    warn: "\x1B[33m",
-    error: "\x1B[31m"
-  };
-  config = {
-    level: isProduction() ? "error" : "info",
-    colors: true,
-    timestamps: false
-  };
-  logger = createLogger("Hypen");
-  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);
-    }
-  };
-  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")
-  };
-});
+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
-init_logger();
 var log2 = frameworkLoggers.lifecycle;
 function isDisposable(obj) {
   return obj !== null && typeof obj === "object" && "dispose" in obj && typeof obj.dispose === "function";
@@ -385,4 +382,4 @@ export {
   DisposableMixin
 };
 
-//# debugId=3EB92CA6084D365D64756E2164756E21
+//# debugId=188F62A2B00EC44064756E2164756E21