@hypen-space/core 0.4.980 → 0.5.2

package/dist/context.js

@@ -1,366 +1,11 @@
-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/events.ts
-var log2 = frameworkLoggers.events;
-
-class TypedEventEmitter {
-  eventBus = new Map;
-  emit(event, payload) {
-    const handlers = this.eventBus.get(event);
-    if (!handlers || handlers.size === 0) {
-      return;
-    }
-    handlers.forEach((handler) => {
-      try {
-        handler(payload);
-      } catch (error) {
-        log2.error(`Error in event handler for "${String(event)}":`, error);
-      }
-    });
-  }
-  on(event, handler) {
-    if (!this.eventBus.has(event)) {
-      this.eventBus.set(event, new Set);
-    }
-    const handlers = this.eventBus.get(event);
-    handlers.add(handler);
-    return () => {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.eventBus.delete(event);
-      }
-    };
-  }
-  once(event, handler) {
-    const wrappedHandler = (payload) => {
-      handler(payload);
-      unsubscribe();
-    };
-    const unsubscribe = this.on(event, wrappedHandler);
-    return unsubscribe;
-  }
-  off(event, handler) {
-    const handlers = this.eventBus.get(event);
-    if (handlers) {
-      handlers.delete(handler);
-      if (handlers.size === 0) {
-        this.eventBus.delete(event);
-      }
-    }
-  }
-  removeAllListeners(event) {
-    this.eventBus.delete(event);
-  }
-  clearAll() {
-    this.eventBus.clear();
-  }
-  listenerCount(event) {
-    return this.eventBus.get(event)?.size ?? 0;
-  }
-  eventNames() {
-    return Array.from(this.eventBus.keys());
-  }
-}
-function createEventEmitter() {
-  return new TypedEventEmitter;
-}
-
-// src/context.ts
-var log3 = frameworkLoggers.context;
-
-class HypenGlobalContext {
-  modules = new Map;
-  typedEvents;
-  constructor() {
-    this.typedEvents = new TypedEventEmitter;
-  }
-  get events() {
-    return this.typedEvents;
-  }
-  registerModule(id, instance) {
-    if (this.modules.has(id)) {
-      log3.warn(`Module "${id}" is already registered. Overwriting.`);
-    }
-    this.modules.set(id, instance);
-    log3.debug(`Registered module: ${id}`);
-  }
-  unregisterModule(id) {
-    this.modules.delete(id);
-    log3.debug(`Unregistered module: ${id}`);
-  }
-  getModule(id) {
-    const module = this.modules.get(id);
-    if (!module) {
-      throw new Error(`Module "${id}" not found. Available modules: ${Array.from(this.modules.keys()).join(", ")}`);
-    }
-    return {
-      state: module.getLiveState(),
-      setState: (patch) => module.updateState(patch),
-      getState: () => module.getState()
-    };
-  }
-  hasModule(id) {
-    return this.modules.has(id);
-  }
-  getModuleIds() {
-    return Array.from(this.modules.keys());
-  }
-  getGlobalState() {
-    const state = {};
-    this.modules.forEach((module, id) => {
-      state[id] = module.getState();
-    });
-    return state;
-  }
-  emit(event, payload) {
-    if (this.typedEvents.listenerCount(event) === 0) {
-      log3.debug(`Event "${event}" emitted but no listeners`);
-      return;
-    }
-    log3.debug(`Emitting event: ${event}`, payload);
-    this.typedEvents.emit(event, payload);
-  }
-  on(event, handler) {
-    log3.debug(`Listening to event: ${event}`);
-    return this.typedEvents.on(event, handler);
-  }
-  off(event, handler) {
-    this.typedEvents.off(event, handler);
-  }
-  clearEvent(event) {
-    this.typedEvents.removeAllListeners(event);
-  }
-  clearAllEvents() {
-    this.typedEvents.clearAll();
-  }
-  debug() {
-    return {
-      modules: this.getModuleIds(),
-      events: this.typedEvents.eventNames(),
-      state: this.getGlobalState()
-    };
-  }
-}
+import {
+  HypenGlobalContext
+} from "./chunk-3zvyth50.js";
+import"./chunk-k12cwfst.js";
+import"./chunk-avchpwhf.js";
+import"./chunk-5gtx3pza.js";
 export {
   HypenGlobalContext
 };
 
-//# debugId=15181C1F85F2427864756E2164756E21
+//# debugId=5DAF4163ED0E772564756E2164756E21

package/dist/context.js.map

@@ -1,12 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/logger.ts", "../src/events.ts", "../src/context.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 * 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\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": "15181C1F85F2427864756E2164756E21",
+  "mappings": "",
+  "debugId": "5DAF4163ED0E772564756E2164756E21",
   "names": []
 }

package/dist/datasource.js

@@ -1,80 +1,9 @@
-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)));
-  }
-}
+import {
+  DataSourceManager
+} from "./chunk-vshdk2pw.js";
+import"./chunk-5gtx3pza.js";
 export {
   DataSourceManager
 };
 
-//# debugId=AF74FE0EA693C3E564756E2164756E21
+//# debugId=75477AE7A7B3A5BA64756E2164756E21

package/dist/datasource.js.map

@@ -1,10 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/datasource.ts"],
+  "sources": [],
   "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",
+  "mappings": "",
+  "debugId": "75477AE7A7B3A5BA64756E2164756E21",
   "names": []
 }