@hypen-space/core 0.4.980 → 0.5.2

package/dist/chunk-7222131a.js

@@ -0,0 +1,191 @@
+// src/result.ts
+function Ok(value) {
+  return { ok: true, value };
+}
+function Err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok;
+}
+function isErr(result) {
+  return !result.ok;
+}
+async function fromPromise(promise, mapError) {
+  try {
+    const value = await promise;
+    return Ok(value);
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function fromTry(fn, mapError) {
+  try {
+    return Ok(fn());
+  } catch (e) {
+    if (mapError) {
+      return Err(mapError(e));
+    }
+    return Err(e);
+  }
+}
+function map(result, fn) {
+  if (result.ok) {
+    return Ok(fn(result.value));
+  }
+  return result;
+}
+function mapErr(result, fn) {
+  if (!result.ok) {
+    return Err(fn(result.error));
+  }
+  return result;
+}
+function flatMap(result, fn) {
+  if (result.ok) {
+    return fn(result.value);
+  }
+  return result;
+}
+function unwrap(result) {
+  if (result.ok) {
+    return result.value;
+  }
+  throw result.error;
+}
+function unwrapOr(result, defaultValue) {
+  if (result.ok) {
+    return result.value;
+  }
+  return defaultValue;
+}
+function unwrapOrElse(result, fn) {
+  if (result.ok) {
+    return result.value;
+  }
+  return fn(result.error);
+}
+function match(result, handlers) {
+  if (result.ok) {
+    return handlers.ok(result.value);
+  }
+  return handlers.err(result.error);
+}
+function all(results) {
+  const values = [];
+  for (const result of results) {
+    if (!result.ok) {
+      return result;
+    }
+    values.push(result.value);
+  }
+  return Ok(values);
+}
+
+class HypenError extends Error {
+  code;
+  context;
+  cause;
+  constructor(code, message, options) {
+    super(message);
+    this.name = "HypenError";
+    this.code = code;
+    this.context = options?.context;
+    this.cause = options?.cause;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+
+class ActionError extends HypenError {
+  actionName;
+  constructor(actionName, cause) {
+    super("ACTION_ERROR", `Action handler "${actionName}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, {
+      context: { actionName },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ActionError";
+    this.actionName = actionName;
+  }
+}
+
+class ConnectionError extends HypenError {
+  url;
+  attempt;
+  constructor(url, cause, attempt) {
+    super("CONNECTION_ERROR", `Connection to "${url}" failed${attempt ? ` (attempt ${attempt})` : ""}: ${cause instanceof Error ? cause.message : String(cause)}`, {
+      context: { url, attempt },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ConnectionError";
+    this.url = url;
+    this.attempt = attempt;
+  }
+}
+
+class StateError extends HypenError {
+  path;
+  constructor(message, path, cause) {
+    super("STATE_ERROR", message, {
+      context: { path },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "StateError";
+    this.path = path;
+  }
+}
+
+class ParseError extends HypenError {
+  source;
+  constructor(message, source, cause) {
+    super("PARSE_ERROR", message, {
+      context: { source },
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "ParseError";
+    this.source = source;
+  }
+}
+
+class RenderError extends HypenError {
+  constructor(message, cause) {
+    super("RENDER_ERROR", message, {
+      cause: cause instanceof Error ? cause : undefined
+    });
+    this.name = "RenderError";
+  }
+}
+function classifyEngineError(err) {
+  if (err && typeof err === "object" && "message" in err && "type" in err) {
+    const structured = err;
+    switch (structured.type) {
+      case "parseError":
+        return new ParseError(structured.message);
+      case "stateError":
+        return new StateError(structured.message);
+      case "renderError":
+        return new RenderError(structured.message);
+      case "actionError":
+        return new HypenError("ACTION_ERROR", structured.message);
+      default:
+        return new HypenError("UNKNOWN_ERROR", structured.message);
+    }
+  }
+  const message = err instanceof Error ? err.message : String(err);
+  if (message.startsWith("Parse error:")) {
+    return new ParseError(message);
+  }
+  if (message.startsWith("Invalid state:") || message.startsWith("Invalid state patch:")) {
+    return new StateError(message);
+  }
+  if (message.startsWith("Parent node not found:")) {
+    return new RenderError(message);
+  }
+  return new RenderError(message);
+}
+
+export { Ok, Err, isOk, isErr, fromPromise, fromTry, map, mapErr, flatMap, unwrap, unwrapOr, unwrapOrElse, match, all, HypenError, ActionError, ConnectionError, StateError, ParseError, RenderError, classifyEngineError };
+
+//# debugId=9F8516575AF24E2A64756E2164756E21

package/dist/chunk-7222131a.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/result.ts"],
+  "sourcesContent": [
+    "/**\n * Result Type for Error Handling\n *\n * A lightweight Result type for explicit error handling without exceptions.\n * Provides type-safe error propagation and composition.\n */\n\n/**\n * Represents either a successful value or an error\n */\nexport type Result<T, E = Error> =\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: E };\n\n/**\n * Create a successful Result\n */\nexport function Ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\n/**\n * Create a failed Result\n */\nexport function Err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n\n/**\n * Check if a Result is Ok\n */\nexport function isOk<T, E>(result: Result<T, E>): result is { ok: true; value: T } {\n  return result.ok;\n}\n\n/**\n * Check if a Result is Err\n */\nexport function isErr<T, E>(result: Result<T, E>): result is { ok: false; error: E } {\n  return !result.ok;\n}\n\n/**\n * Wrap a Promise in a Result, catching any thrown errors\n */\nexport async function fromPromise<T, E = Error>(\n  promise: Promise<T>,\n  mapError?: (e: unknown) => E\n): Promise<Result<T, E>> {\n  try {\n    const value = await promise;\n    return Ok(value);\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Wrap a synchronous function in a Result, catching any thrown errors\n */\nexport function fromTry<T, E = Error>(\n  fn: () => T,\n  mapError?: (e: unknown) => E\n): Result<T, E> {\n  try {\n    return Ok(fn());\n  } catch (e) {\n    if (mapError) {\n      return Err(mapError(e));\n    }\n    return Err(e as E);\n  }\n}\n\n/**\n * Map over a successful Result value\n */\nexport function map<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => U\n): Result<U, E> {\n  if (result.ok) {\n    return Ok(fn(result.value));\n  }\n  return result;\n}\n\n/**\n * Map over a failed Result error\n */\nexport function mapErr<T, E, F>(\n  result: Result<T, E>,\n  fn: (error: E) => F\n): Result<T, F> {\n  if (!result.ok) {\n    return Err(fn(result.error));\n  }\n  return result;\n}\n\n/**\n * Chain Results together (flatMap)\n */\nexport function flatMap<T, U, E>(\n  result: Result<T, E>,\n  fn: (value: T) => Result<U, E>\n): Result<U, E> {\n  if (result.ok) {\n    return fn(result.value);\n  }\n  return result;\n}\n\n/**\n * Unwrap a Result, throwing if it's an error\n */\nexport function unwrap<T, E>(result: Result<T, E>): T {\n  if (result.ok) {\n    return result.value;\n  }\n  throw result.error;\n}\n\n/**\n * Unwrap a Result with a default value\n */\nexport function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return defaultValue;\n}\n\n/**\n * Unwrap a Result with a lazy default value\n */\nexport function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T {\n  if (result.ok) {\n    return result.value;\n  }\n  return fn(result.error);\n}\n\n/**\n * Match on a Result, providing handlers for both cases\n */\nexport function match<T, E, U>(\n  result: Result<T, E>,\n  handlers: {\n    ok: (value: T) => U;\n    err: (error: E) => U;\n  }\n): U {\n  if (result.ok) {\n    return handlers.ok(result.value);\n  }\n  return handlers.err(result.error);\n}\n\n/**\n * Combine multiple Results into a single Result containing an array\n * Returns the first error encountered, or Ok with all values\n */\nexport function all<T, E>(results: Result<T, E>[]): Result<T[], E> {\n  const values: T[] = [];\n  for (const result of results) {\n    if (!result.ok) {\n      return result;\n    }\n    values.push(result.value);\n  }\n  return Ok(values);\n}\n\n/**\n * Base class for typed errors with context\n */\nexport class HypenError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n  override readonly cause?: Error;\n\n  constructor(\n    code: string,\n    message: string,\n    options?: { context?: Record<string, unknown>; cause?: Error }\n  ) {\n    super(message);\n    this.name = 'HypenError';\n    this.code = code;\n    this.context = options?.context;\n    this.cause = options?.cause;\n\n    // Maintain proper prototype chain\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/**\n * Error thrown when an action handler fails\n */\nexport class ActionError extends HypenError {\n  readonly actionName: string;\n\n  constructor(actionName: string, cause?: unknown) {\n    super(\n      'ACTION_ERROR',\n      `Action handler \"${actionName}\" failed: ${cause instanceof Error ? cause.message : String(cause)}`,\n      {\n        context: { actionName },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ActionError';\n    this.actionName = actionName;\n  }\n}\n\n/**\n * Error thrown when a connection fails\n */\nexport class ConnectionError extends HypenError {\n  readonly url: string;\n  readonly attempt?: number;\n\n  constructor(url: string, cause?: unknown, attempt?: number) {\n    super(\n      'CONNECTION_ERROR',\n      `Connection to \"${url}\" failed${attempt ? ` (attempt ${attempt})` : ''}: ${\n        cause instanceof Error ? cause.message : String(cause)\n      }`,\n      {\n        context: { url, attempt },\n        cause: cause instanceof Error ? cause : undefined,\n      }\n    );\n    this.name = 'ConnectionError';\n    this.url = url;\n    this.attempt = attempt;\n  }\n}\n\n/**\n * Error thrown when state operations fail\n */\nexport class StateError extends HypenError {\n  readonly path?: string;\n\n  constructor(message: string, path?: string, cause?: unknown) {\n    super('STATE_ERROR', message, {\n      context: { path },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'StateError';\n    this.path = path;\n  }\n}\n\n/**\n * Error thrown when parsing Hypen DSL source fails\n */\nexport class ParseError extends HypenError {\n  readonly source?: string;\n\n  constructor(message: string, source?: string, cause?: unknown) {\n    super('PARSE_ERROR', message, {\n      context: { source },\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'ParseError';\n    this.source = source;\n  }\n}\n\n/**\n * Error thrown when rendering fails\n */\nexport class RenderError extends HypenError {\n  constructor(message: string, cause?: unknown) {\n    super('RENDER_ERROR', message, {\n      cause: cause instanceof Error ? cause : undefined,\n    });\n    this.name = 'RenderError';\n  }\n}\n\n/**\n * Classify a WASM engine error string into the appropriate HypenError subclass.\n * The engine returns JsValue error strings with known prefixes.\n */\nexport function classifyEngineError(err: unknown): HypenError {\n  // Handle structured WASM errors: { type: string, message: string }\n  if (err && typeof err === 'object' && 'message' in err && 'type' in err) {\n    const structured = err as { type: string; message: string };\n    switch (structured.type) {\n      case 'parseError': return new ParseError(structured.message);\n      case 'stateError': return new StateError(structured.message);\n      case 'renderError': return new RenderError(structured.message);\n      case 'actionError': return new HypenError('ACTION_ERROR', structured.message);\n      default: return new HypenError('UNKNOWN_ERROR', structured.message);\n    }\n  }\n  const message = err instanceof Error ? err.message : String(err);\n\n  if (message.startsWith('Parse error:')) {\n    return new ParseError(message);\n  }\n  if (message.startsWith('Invalid state:') || message.startsWith('Invalid state patch:')) {\n    return new StateError(message);\n  }\n  if (message.startsWith('Parent node not found:')) {\n    return new RenderError(message);\n  }\n\n  return new RenderError(message);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "9F8516575AF24E2A64756E2164756E21",
+  "names": []
+}

package/dist/chunk-avchpwhf.js

@@ -0,0 +1,200 @@
+// 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")
+};
+
+export { setLogLevel, getLogLevel, configureLogger, enableLogging, disableLogging, setDebugMode, isDebugMode, Logger, createLogger, logger, log, frameworkLoggers };
+
+//# debugId=A67C7BE2E0C2E19B64756E2164756E21

package/dist/chunk-avchpwhf.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/logger.ts"],
+  "sourcesContent": [
+    "/**\n * Configurable Debug Logger\n *\n * Provides environment-aware logging that can be disabled in production.\n * Supports log levels, tagged output, and performance timing.\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\nexport interface LoggerConfig {\n  /** Minimum log level (default: \"debug\" in dev, \"error\" in prod) */\n  level: LogLevel;\n  /** Enable colored output (default: true) */\n  colors: boolean;\n  /** Include timestamps (default: false) */\n  timestamps: boolean;\n  /** Custom log handler (default: console) */\n  handler?: LogHandler;\n}\n\nexport interface LogHandler {\n  debug(tag: string, ...args: unknown[]): void;\n  info(tag: string, ...args: unknown[]): void;\n  warn(tag: string, ...args: unknown[]): void;\n  error(tag: string, ...args: unknown[]): void;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst LOG_LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  none: 4,\n};\n\nconst LOG_LEVEL_COLORS: Record<Exclude<LogLevel, \"none\">, string> = {\n  debug: \"\\x1b[36m\", // Cyan\n  info: \"\\x1b[32m\",  // Green\n  warn: \"\\x1b[33m\",  // Yellow\n  error: \"\\x1b[31m\", // Red\n};\n\nconst RESET_COLOR = \"\\x1b[0m\";\n\n// ============================================================================\n// Global Configuration\n// ============================================================================\n\n/**\n * Detect if running in production environment\n */\nfunction isProduction(): boolean {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env.NODE_ENV === \"production\";\n  }\n  return false;\n}\n\n/**\n * Default configuration\n */\nlet config: LoggerConfig = {\n  level: isProduction() ? \"error\" : \"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"
+  ],
+  "mappings": ";AAmCA,IAAM,kBAA4C;AAAA,EAChD,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AACR;AAEA,IAAM,mBAA8D;AAAA,EAClE,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAEA,IAAM,cAAc;AASpB,SAAS,YAAY,GAAY;AAAA,EAC/B,IAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;AAAA,IACjD,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA;AAMT,IAAI,SAAuB;AAAA,EACzB,OAAO,aAAa,IAAI,UAAU;AAAA,EAClC,QAAQ;AAAA,EACR,YAAY;AACd;AASO,SAAS,WAAW,CAAC,OAAuB;AAAA,EACjD,OAAO,QAAQ;AAAA;AAMV,SAAS,WAAW,GAAa;AAAA,EACtC,OAAO,OAAO;AAAA;AAMT,SAAS,eAAe,CAAC,SAAsC;AAAA,EACpE,SAAS,KAAK,WAAW,QAAQ;AAAA;AAM5B,SAAS,aAAa,GAAS;AAAA,EACpC,OAAO,QAAQ;AAAA;AAMV,SAAS,cAAc,GAAS;AAAA,EACrC,OAAO,QAAQ;AAAA;AAaV,SAAS,YAAY,CAAC,SAAwB;AAAA,EACnD,OAAO,QAAQ,UAAU,UAAU;AAAA;AAM9B,SAAS,WAAW,GAAY;AAAA,EACrC,OAAO,OAAO,UAAU;AAAA;AAO1B,SAAS,SAAS,CAAC,OAA0B;AAAA,EAC3C,OAAO,gBAAgB,UAAU,gBAAgB,OAAO;AAAA;AAG1D,SAAS,SAAS,CAAC,KAAa,OAAyB;AAAA,EACvD,MAAM,YAAY,OAAO,aAAa,GAAG,IAAI,KAAK,EAAE,YAAY,OAAO;AAAA,EAEvE,IAAI,OAAO,UAAU,UAAU,QAAQ;AAAA,IACrC,MAAM,QAAQ,iBAAiB;AAAA,IAC/B,OAAO,GAAG,YAAY,SAAS,OAAO;AAAA,EACxC;AAAA,EAEA,OAAO,GAAG,aAAa;AAAA;AAAA;AAiBlB,MAAM,OAAO;AAAA,EACD;AAAA,EAEjB,WAAW,CAAC,KAAa;AAAA,IACvB,KAAK,MAAM;AAAA;AAAA,EAGb,KAAK,IAAI,MAAuB;AAAA,IAC9B,IAAI,CAAC,UAAU,OAAO;AAAA,MAAG;AAAA,IAEzB,IAAI,OAAO,SAAS;AAAA,MAClB,OAAO,QAAQ,MAAM,KAAK,KAAK,GAAG,IAAI;AAAA,IACxC,EAAO;AAAA,MACL,QAAQ,IAAI,UAAU,KAAK,KAAK,OAAO,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAIrD,IAAI,IAAI,MAAuB;AAAA,IAC7B,IAAI,CAAC,UAAU,MAAM;AAAA,MAAG;AAAA,IAExB,IAAI,OAAO,SAAS;AAAA,MAClB,OAAO,QAAQ,KAAK,KAAK,KAAK,GAAG,IAAI;AAAA,IACvC,EAAO;AAAA,MACL,QAAQ,KAAK,UAAU,KAAK,KAAK,MAAM,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAIrD,IAAI,IAAI,MAAuB;AAAA,IAC7B,IAAI,CAAC,UAAU,MAAM;AAAA,MAAG;AAAA,IAExB,IAAI,OAAO,SAAS;AAAA,MAClB,OAAO,QAAQ,KAAK,KAAK,KAAK,GAAG,IAAI;AAAA,IACvC,EAAO;AAAA,MACL,QAAQ,KAAK,UAAU,KAAK,KAAK,MAAM,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAIrD,KAAK,IAAI,MAAuB;AAAA,IAC9B,IAAI,CAAC,UAAU,OAAO;AAAA,MAAG;AAAA,IAEzB,IAAI,OAAO,SAAS;AAAA,MAClB,OAAO,QAAQ,MAAM,KAAK,KAAK,GAAG,IAAI;AAAA,IACxC,EAAO;AAAA,MACL,QAAQ,MAAM,UAAU,KAAK,KAAK,OAAO,GAAG,GAAG,IAAI;AAAA;AAAA;AAAA,EAOvD,IAAO,CAAC,OAAe,IAAgB;AAAA,IACrC,IAAI,CAAC,UAAU,OAAO,GAAG;AAAA,MACvB,OAAO,GAAG;AAAA,IACZ;AAAA,IAEA,MAAM,QAAQ,YAAY,IAAI;AAAA,IAC9B,IAAI;AAAA,MACF,OAAO,GAAG;AAAA,cACV;AAAA,MACA,MAAM,WAAW,YAAY,IAAI,IAAI;AAAA,MACrC,KAAK,MAAM,GAAG,UAAU,SAAS,QAAQ,CAAC,KAAK;AAAA;AAAA;AAAA,OAO7C,UAAY,CAAC,OAAe,IAAkC;AAAA,IAClE,IAAI,CAAC,UAAU,OAAO,GAAG;AAAA,MACvB,OAAO,GAAG;AAAA,IACZ;AAAA,IAEA,MAAM,QAAQ,YAAY,IAAI;AAAA,IAC9B,IAAI;AAAA,MACF,OAAO,MAAM,GAAG;AAAA,cAChB;AAAA,MACA,MAAM,WAAW,YAAY,IAAI,IAAI;AAAA,MACrC,KAAK,MAAM,GAAG,UAAU,SAAS,QAAQ,CAAC,KAAK;AAAA;AAAA;AAAA,EAOnD,KAAK,CAAC,QAAwB;AAAA,IAC5B,OAAO,IAAI,OAAO,GAAG,KAAK,OAAO,QAAQ;AAAA;AAAA,EAM3C,OAAO,CAAC,cAAuB,MAAuB;AAAA,IACpD,IAAI;AAAA,MAAW,KAAK,MAAM,GAAG,IAAI;AAAA;AAAA,EAGnC,MAAM,CAAC,cAAuB,MAAuB;AAAA,IACnD,IAAI;AAAA,MAAW,KAAK,KAAK,GAAG,IAAI;AAAA;AAAA,EAGlC,OAAO,CAAC,cAAuB,MAAuB;AAAA,IACpD,IAAI;AAAA,MAAW,KAAK,MAAM,GAAG,IAAI;AAAA;AAAA,EAM3B,aAAa,IAAI;AAAA,EAEzB,QAAQ,CAAC,QAAgB,MAAuB;AAAA,IAC9C,IAAI,KAAK,WAAW,IAAI,GAAG;AAAA,MAAG;AAAA,IAC9B,KAAK,WAAW,IAAI,GAAG;AAAA,IACvB,KAAK,KAAK,GAAG,IAAI;AAAA;AAAA,EAGnB,SAAS,CAAC,QAAgB,MAAuB;AAAA,IAC/C,IAAI,KAAK,WAAW,IAAI,GAAG;AAAA,MAAG;AAAA,IAC9B,KAAK,WAAW,IAAI,GAAG;AAAA,IACvB,KAAK,MAAM,GAAG,IAAI;AAAA;AAEtB;AAeO,SAAS,YAAY,CAAC,KAAqB;AAAA,EAChD,OAAO,IAAI,OAAO,GAAG;AAAA;AAUhB,IAAM,SAAS,aAAa,OAAO;AAUnC,IAAM,MAAM;AAAA,EACjB,OAAO,CAAC,QAAgB,SAA0B;AAAA,IAChD,IAAI,CAAC,UAAU,OAAO;AAAA,MAAG;AAAA,IACzB,QAAQ,IAAI,UAAU,KAAK,OAAO,GAAG,GAAG,IAAI;AAAA;AAAA,EAG9C,MAAM,CAAC,QAAgB,SAA0B;AAAA,IAC/C,IAAI,CAAC,UAAU,MAAM;AAAA,MAAG;AAAA,IACxB,QAAQ,KAAK,UAAU,KAAK,MAAM,GAAG,GAAG,IAAI;AAAA;AAAA,EAG9C,MAAM,CAAC,QAAgB,SAA0B;AAAA,IAC/C,IAAI,CAAC,UAAU,MAAM;AAAA,MAAG;AAAA,IACxB,QAAQ,KAAK,UAAU,KAAK,MAAM,GAAG,GAAG,IAAI;AAAA;AAAA,EAG9C,OAAO,CAAC,QAAgB,SAA0B;AAAA,IAChD,IAAI,CAAC,UAAU,OAAO;AAAA,MAAG;AAAA,IACzB,QAAQ,MAAM,UAAU,KAAK,OAAO,GAAG,GAAG,IAAI;AAAA;AAElD;AAMO,IAAM,mBAAmB;AAAA,EAC9B,OAAO,aAAa,OAAO;AAAA,EAC3B,QAAQ,aAAa,QAAQ;AAAA,EAC7B,QAAQ,aAAa,QAAQ;AAAA,EAC7B,OAAO,aAAa,OAAO;AAAA,EAC3B,QAAQ,aAAa,QAAQ;AAAA,EAC7B,QAAQ,aAAa,QAAQ;AAAA,EAC7B,UAAU,aAAa,UAAU;AAAA,EACjC,QAAQ,aAAa,QAAQ;AAAA,EAC7B,WAAW,aAAa,WAAW;AAAA,EACnC,QAAQ,aAAa,QAAQ;AAAA,EAC7B,SAAS,aAAa,SAAS;AAAA,EAC/B,WAAW,aAAa,WAAW;AAAA,EACnC,QAAQ,aAAa,QAAQ;AAAA,EAC7B,QAAQ,aAAa,QAAQ;AAAA,EAC7B,OAAO,aAAa,OAAO;AAC7B;",
+  "debugId": "A67C7BE2E0C2E19B64756E2164756E21",
+  "names": []
+}

package/dist/chunk-ec0tgy9a.js

@@ -0,0 +1,154 @@
+import {
+  frameworkLoggers
+} from "./chunk-avchpwhf.js";
+
+// src/disposable.ts
+var log = 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) {
+        log.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) {
+          log.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();
+  }
+}
+
+export { isDisposable, DisposableStack, disposableListener, disposableTimeout, disposableInterval, disposableWebSocket, disposableAbortController, disposableSubscription, getElementDisposables, disposeElement, hasElementDisposables, DisposableMixin, compositeDisposable, using, usingSync };
+
+//# debugId=506C13B425DB3D8C64756E2164756E21

package/dist/chunk-ec0tgy9a.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/disposable.ts"],
+  "sourcesContent": [
+    "/**\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": "506C13B425DB3D8C64756E2164756E21",
+  "names": []
+}