@rb-games/core 0.1.1 → 0.1.2

package/dist/chunk-5BLUF2HG.js

@@ -0,0 +1,25 @@
+// utils/ObjectUtils.ts
+function getNestedValue(obj, path) {
+  return path.split(".").reduce((current, key) => current == null ? void 0 : current[key], obj);
+}
+function setNestedValue(obj, path, value) {
+  const keys = path.split(".");
+  const lastKey = keys.pop();
+  const target = keys.reduce((current, key) => {
+    if (current[key] === void 0 || current[key] === null) {
+      current[key] = {};
+    }
+    return current[key];
+  }, obj);
+  target[lastKey] = value;
+}
+function hasNestedProperty(obj, path) {
+  return getNestedValue(obj, path) !== void 0;
+}
+function deepClone(obj) {
+  return structuredClone(obj);
+}
+
+export { deepClone, getNestedValue, hasNestedProperty, setNestedValue };
+//# sourceMappingURL=chunk-5BLUF2HG.js.map
+//# sourceMappingURL=chunk-5BLUF2HG.js.map

package/dist/chunk-5BLUF2HG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../utils/ObjectUtils.ts"],"names":[],"mappings":";AAkBO,SAAS,cAAA,CAAe,KAAU,IAAA,EAAmB;AAC1D,EAAA,OAAO,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA,CAAE,MAAA,CAAO,CAAC,OAAA,EAAS,GAAA,KAAQ,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAU,GAAA,CAAA,EAAM,GAAG,CAAA;AACrE;AAiBO,SAAS,cAAA,CAAe,GAAA,EAAU,IAAA,EAAc,KAAA,EAAkB;AACvE,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAG,CAAA;AAC3B,EAAA,MAAM,OAAA,GAAU,KAAK,GAAA,EAAI;AACzB,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,CAAO,CAAC,SAAS,GAAA,KAAQ;AAC3C,IAAA,IAAI,QAAQ,GAAG,CAAA,KAAM,UAAa,OAAA,CAAQ,GAAG,MAAM,IAAA,EAAM;AACvD,MAAA,OAAA,CAAQ,GAAG,IAAI,EAAC;AAAA,IAClB;AACA,IAAA,OAAO,QAAQ,GAAG,CAAA;AAAA,EACpB,GAAG,GAAG,CAAA;AACN,EAAA,MAAA,CAAO,OAAO,CAAA,GAAI,KAAA;AACpB;AAgBO,SAAS,iBAAA,CAAkB,KAAU,IAAA,EAAuB;AACjE,EAAA,OAAO,cAAA,CAAe,GAAA,EAAK,IAAI,CAAA,KAAM,MAAA;AACvC;AAeO,SAAS,UAAa,GAAA,EAAW;AACtC,EAAA,OAAO,gBAAgB,GAAG,CAAA;AAC5B","file":"chunk-5BLUF2HG.js","sourcesContent":["/**\n * Utility functions for object manipulation and property access.\n */\n\n/**\n * Gets a nested property value from an object using a dot-separated path.\n * \n * @param obj - The source object\n * @param path - Dot-separated path to the nested property (e.g., 'user.profile.name')\n * @returns The value at the specified path, or undefined if any part of the path doesn't exist\n * \n * @example\n * ```typescript\n * const obj = { user: { profile: { name: 'John' } } };\n * const name = getNestedValue(obj, 'user.profile.name'); // Returns 'John'\n * const age = getNestedValue(obj, 'user.profile.age'); // Returns undefined\n * ```\n */\nexport function getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj);\n}\n\n/**\n * Sets a nested property value in an object using a dot-separated path.\n * Creates intermediate objects if they don't exist.\n * \n * @param obj - The target object\n * @param path - Dot-separated path to the nested property (e.g., 'user.profile.name')\n * @param value - The value to set\n * \n * @example\n * ```typescript\n * const obj = {};\n * setNestedValue(obj, 'user.profile.name', 'John');\n * // Result: { user: { profile: { name: 'John' } } }\n * ```\n */\nexport function setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.');\n  const lastKey = keys.pop()!;\n  const target = keys.reduce((current, key) => {\n    if (current[key] === undefined || current[key] === null) {\n      current[key] = {};\n    }\n    return current[key];\n  }, obj);\n  target[lastKey] = value;\n}\n\n/**\n * Checks if a nested property exists in an object using a dot-separated path.\n * \n * @param obj - The object to check\n * @param path - Dot-separated path to the nested property\n * @returns true if the property exists, false otherwise\n * \n * @example\n * ```typescript\n * const obj = { user: { profile: { name: 'John' } } };\n * const hasName = hasNestedProperty(obj, 'user.profile.name'); // Returns true\n * const hasAge = hasNestedProperty(obj, 'user.profile.age'); // Returns false\n * ```\n */\nexport function hasNestedProperty(obj: any, path: string): boolean {\n  return getNestedValue(obj, path) !== undefined;\n}\n\n/**\n * Deep clones an object using structured cloning.\n * \n * @param obj - The object to clone\n * @returns A deep copy of the object\n * \n * @example\n * ```typescript\n * const original = { user: { profile: { name: 'John' } } };\n * const cloned = deepClone(original);\n * cloned.user.profile.name = 'Jane'; // Doesn't affect original\n * ```\n */\nexport function deepClone<T>(obj: T): T {\n  return structuredClone(obj);\n}"]}

package/dist/chunk-DOHQE2YZ.js

@@ -0,0 +1,392 @@
+// utils/Logger.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["ERROR"] = 0] = "ERROR";
+  LogLevel2[LogLevel2["WARN"] = 1] = "WARN";
+  LogLevel2[LogLevel2["INFO"] = 2] = "INFO";
+  LogLevel2[LogLevel2["DEBUG"] = 3] = "DEBUG";
+  LogLevel2[LogLevel2["TRACE"] = 4] = "TRACE";
+  return LogLevel2;
+})(LogLevel || {});
+var Logger = class _Logger {
+  static instance;
+  config;
+  // Terminal colors (for Node.js environment)
+  terminalColors = {
+    reset: "\x1B[0m",
+    red: "\x1B[31m",
+    yellow: "\x1B[33m",
+    blue: "\x1B[34m",
+    green: "\x1B[32m",
+    gray: "\x1B[90m",
+    cyan: "\x1B[36m",
+    magenta: "\x1B[35m",
+    white: "\x1B[37m"
+  };
+  // Browser console colors (using CSS)
+  browserColors = {
+    timestamp: "color: gray",
+    context: "color: cyan; font-weight: bold",
+    message: "color: white",
+    error: "color: red; font-weight: bold",
+    warn: "color: orange; font-weight: bold",
+    info: "color: dodgerblue; font-weight: bold",
+    debug: "color: green",
+    trace: "color: gray"
+  };
+  levelLabels = {
+    [0 /* ERROR */]: "ERROR",
+    [1 /* WARN */]: "WARN",
+    [2 /* INFO */]: "INFO",
+    [3 /* DEBUG */]: "DEBUG",
+    [4 /* TRACE */]: "TRACE"
+  };
+  levelColors = {
+    [0 /* ERROR */]: this.terminalColors.red,
+    [1 /* WARN */]: this.terminalColors.yellow,
+    [2 /* INFO */]: this.terminalColors.blue,
+    [3 /* DEBUG */]: this.terminalColors.green,
+    [4 /* TRACE */]: this.terminalColors.gray
+  };
+  levelBrowserColors = {
+    [0 /* ERROR */]: this.browserColors.error,
+    [1 /* WARN */]: this.browserColors.warn,
+    [2 /* INFO */]: this.browserColors.info,
+    [3 /* DEBUG */]: this.browserColors.debug,
+    [4 /* TRACE */]: this.browserColors.trace
+  };
+  /**
+   * Private constructor for singleton pattern
+   */
+  constructor() {
+    var _a;
+    this.config = {
+      level: 3 /* DEBUG */,
+      // Default log level
+      enabled: true,
+      // Logging enabled by default
+      showTimestamp: false,
+      // Show timestamps by default
+      showColors: true
+      // Show colors by default
+    };
+    if ((_a = import.meta.env) == null ? void 0 : _a.DEV) {
+      console.warn(
+        "[Logger] For better debugging experience, add Logger.ts to DevTools ignore list:\nDevTools \u2192 Settings (F1) \u2192 Ignore List \u2192 Add pattern: /Logger\\.ts$"
+      );
+    }
+  }
+  /**
+   * Get the singleton instance of the Logger
+   */
+  static getInstance() {
+    if (!_Logger.instance) {
+      _Logger.instance = new _Logger();
+    }
+    return _Logger.instance;
+  }
+  /**
+   * Configure the logger
+   * @param config Configuration options
+   */
+  configure(config) {
+    this.config = { ...this.config, ...config };
+  }
+  /**
+   * Enable or disable logging
+   * @param enabled Whether logging is enabled
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+  /**
+   * Set the log level
+   * @param level The log level to set
+   */
+  setLevel(level) {
+    this.config.level = level;
+  }
+  /**
+   * Get the current log level
+   */
+  getLevel() {
+    return this.config.level;
+  }
+  /**
+   * Log an error message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  error(message, ...args) {
+    this.log(0 /* ERROR */, message, ...args);
+  }
+  /**
+   * Log a warning message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  warn(message, ...args) {
+    this.log(1 /* WARN */, message, ...args);
+  }
+  /**
+   * Log an info message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  info(message, ...args) {
+    this.log(2 /* INFO */, message, ...args);
+  }
+  /**
+   * Log a debug message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  debug(message, ...args) {
+    this.log(3 /* DEBUG */, message, ...args);
+  }
+  /**
+   * Log a trace message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  trace(message, ...args) {
+    this.log(4 /* TRACE */, message, ...args);
+  }
+  /**
+   * Log a message with a specific log level
+   * @param level The log level
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  log(level, message, ...args) {
+    if (!this.config.enabled || level > this.config.level) {
+      return;
+    }
+    if (!this.shouldLogMessage(message)) {
+      return;
+    }
+    const isBrowser = typeof window !== "undefined";
+    if (isBrowser && this.config.showColors) {
+      this.logBrowser(level, message, ...args);
+    } else {
+      this.logTerminal(level, message, ...args);
+    }
+  }
+  extractContext(message) {
+    const contextMatch = message.match(/^\[([^\]]+)\]\s(.*)$/);
+    if (!contextMatch) {
+      return {
+        context: "",
+        messageContent: message
+      };
+    }
+    return {
+      context: contextMatch[1],
+      messageContent: contextMatch[2]
+    };
+  }
+  matchesFilter(value, matchers) {
+    if (!(matchers == null ? void 0 : matchers.length)) {
+      return false;
+    }
+    return matchers.some((matcher) => {
+      if (typeof matcher === "string") {
+        return value.includes(matcher);
+      }
+      matcher.lastIndex = 0;
+      return matcher.test(value);
+    });
+  }
+  shouldLogMessage(message) {
+    var _a, _b;
+    const filter = this.config.filter;
+    if (!filter) {
+      return true;
+    }
+    const hasFilters = Boolean(((_a = filter.contexts) == null ? void 0 : _a.length) || ((_b = filter.messages) == null ? void 0 : _b.length));
+    if (!hasFilters) {
+      return true;
+    }
+    const { context, messageContent } = this.extractContext(message);
+    const contextMatches = this.matchesFilter(context, filter.contexts);
+    const messageMatches = this.matchesFilter(messageContent, filter.messages);
+    const matches = contextMatches || messageMatches;
+    return filter.mode === "exclude" ? !matches : matches;
+  }
+  /**
+   * Log a message in terminal/node environment
+   */
+  logTerminal(level, message, ...args) {
+    let timestamp = "";
+    let levelStr = "";
+    let contextPart = "";
+    const contextMatch = message.match(/^\[([^\]]+)\]\s(.*)$/);
+    let messageContent = message;
+    if (contextMatch) {
+      contextPart = `[${contextMatch[1]}] `;
+      messageContent = contextMatch[2];
+    }
+    if (this.config.showTimestamp) {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      timestamp = `[${now}] `;
+    }
+    levelStr = `[${this.levelLabels[level]}] `;
+    if (this.config.showColors) {
+      const levelColor = this.levelColors[level];
+      const contextColor = this.terminalColors.cyan;
+      const timestampColor = this.terminalColors.gray;
+      const messageColor = this.terminalColors.white;
+      timestamp = `${timestampColor}${timestamp}${this.terminalColors.reset}`;
+      levelStr = `${levelColor}${levelStr}${this.terminalColors.reset}`;
+      if (contextPart) {
+        contextPart = `${contextColor}${contextPart}${this.terminalColors.reset}`;
+      }
+      messageContent = `${messageColor}${messageContent}${this.terminalColors.reset}`;
+    }
+    const formattedMessage = timestamp + levelStr + contextPart + messageContent;
+    switch (level) {
+      case 0 /* ERROR */:
+        console.error(formattedMessage, ...args);
+        break;
+      case 1 /* WARN */:
+        console.warn(formattedMessage, ...args);
+        break;
+      case 2 /* INFO */:
+        console.info(formattedMessage, ...args);
+        break;
+      case 3 /* DEBUG */:
+      case 4 /* TRACE */:
+      default:
+        console.log(formattedMessage, ...args);
+        break;
+    }
+  }
+  /**
+   * Log a message in browser environment with CSS styling
+   */
+  logBrowser(level, message, ...args) {
+    const contextMatch = message.match(/^\[([^\]]+)\]\s(.*)$/);
+    let context = "";
+    let messageContent = message;
+    if (contextMatch) {
+      context = contextMatch[1];
+      messageContent = contextMatch[2];
+    }
+    let format = "";
+    const formatArgs = [];
+    if (this.config.showTimestamp) {
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      format += "%c[" + now + "] ";
+      formatArgs.push(this.browserColors.timestamp);
+    }
+    format += "%c[" + this.levelLabels[level] + "] ";
+    formatArgs.push(this.levelBrowserColors[level]);
+    if (context) {
+      format += "%c[" + context + "] ";
+      formatArgs.push(this.browserColors.context);
+    }
+    format += "%c" + messageContent;
+    formatArgs.push(this.browserColors.message);
+    switch (level) {
+      case 0 /* ERROR */:
+        console.error(format, ...formatArgs, ...args);
+        break;
+      case 1 /* WARN */:
+        console.warn(format, ...formatArgs, ...args);
+        break;
+      case 2 /* INFO */:
+        console.info(format, ...formatArgs, ...args);
+        break;
+      case 3 /* DEBUG */:
+      case 4 /* TRACE */:
+      default:
+        console.log(format, ...formatArgs, ...args);
+        break;
+    }
+  }
+  /**
+   * Creates a context-specific logger.
+   *
+   * Context loggers automatically prefix all log messages with a context tag.
+   * Commonly used in plugins and classes to identify log sources.
+   *
+   * @param context - Context name (e.g., 'MyPlugin', 'SceneManager')
+   * @returns ContextLogger instance
+   *
+   * @example
+   * ```typescript
+   * class DisplayPlugin {
+   *   private logger = logger.createContextLogger('DisplayPlugin');
+   *
+   *   initialize() {
+   *     this.logger.info('Initializing display');
+   *     // Output: [INFO] [DisplayPlugin] Initializing display
+   *   }
+   * }
+   * ```
+   */
+  createContextLogger(context) {
+    return new ContextLogger(this, context);
+  }
+};
+var ContextLogger = class {
+  logger;
+  context;
+  constructor(logger2, context) {
+    this.logger = logger2;
+    this.context = context;
+  }
+  /**
+   * Log an error message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  error(message, ...args) {
+    this.logger.error(`[${this.context}] ${message}`, ...args);
+  }
+  /**
+   * Log a warning message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  warn(message, ...args) {
+    this.logger.warn(`[${this.context}] ${message}`, ...args);
+  }
+  /**
+   * Log an info message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  info(message, ...args) {
+    this.logger.info(`[${this.context}] ${message}`, ...args);
+  }
+  /**
+   * Log a debug message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  debug(message, ...args) {
+    this.logger.debug(`[${this.context}] ${message}`, ...args);
+  }
+  /**
+   * Log a trace message
+   * @param message The message to log
+   * @param args Additional arguments to log
+   */
+  trace(message, ...args) {
+    this.logger.trace(`[${this.context}] ${message}`, ...args);
+  }
+};
+var logger = Logger.getInstance();
+var contextLoggers = /* @__PURE__ */ new Map();
+function getLogger(context) {
+  let cached = contextLoggers.get(context);
+  if (!cached) {
+    cached = new ContextLogger(logger, context);
+    contextLoggers.set(context, cached);
+  }
+  return cached;
+}
+
+export { ContextLogger, LogLevel, Logger, getLogger, logger };
+//# sourceMappingURL=chunk-DOHQE2YZ.js.map
+//# sourceMappingURL=chunk-DOHQE2YZ.js.map

package/dist/chunk-DOHQE2YZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../utils/Logger.ts"],"names":["LogLevel","logger"],"mappings":"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","file":"chunk-DOHQE2YZ.js","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Log levels for filtering log output.\n *\n * Lower numeric values have higher priority.\n * Setting a log level will show that level and all higher priority levels.\n *\n * @example\n * ```typescript\n * // Set to INFO level\n * logger.setLevel(LogLevel.INFO);\n * // Will show: ERROR, WARN, INFO\n * // Will hide: DEBUG, TRACE\n * ```\n *\n * @public\n */\nexport enum LogLevel {\n  /** Critical errors (always shown) */\n  ERROR = 0,\n  /** Warnings (shown at WARN level and above) */\n  WARN = 1,\n  /** Informational messages (shown at INFO level and above) */\n  INFO = 2,\n  /** Debug messages (shown at DEBUG level and above) */\n  DEBUG = 3,\n  /** Trace messages (most verbose, shown only at TRACE level) */\n  TRACE = 4,\n}\n\nexport type LoggerFilterMatcher = string | RegExp;\n\nexport interface LoggerFilterConfig {\n  contexts?: LoggerFilterMatcher[];\n  messages?: LoggerFilterMatcher[];\n  mode?: 'include' | 'exclude';\n}\n\n/**\n * Configuration options for the Logger.\n *\n * @public\n */\nexport interface LoggerConfig {\n  /** Minimum log level to display */\n  level: LogLevel;\n  /** Whether logging is enabled */\n  enabled: boolean;\n  /** Whether to show timestamps in logs */\n  showTimestamp: boolean;\n  /** Whether to show colors in logs */\n  showColors: boolean;\n  filter?: LoggerFilterConfig;\n}\n\n/**\n * Singleton logger for centralized logging.\n *\n * Logger provides a unified logging system with:\n * - Multiple log levels (ERROR, WARN, INFO, DEBUG, TRACE)\n * - Colored output (browser and terminal)\n * - Timestamps\n * - Context-based sub-loggers\n * - Environment detection (browser vs Node.js)\n *\n * ## Features\n *\n * - **Singleton Pattern**: Single instance across the application\n * - **Log Levels**: Filter logs by severity\n * - **Colored Output**: CSS colors in browser, ANSI colors in terminal\n * - **Context Loggers**: Create sub-loggers with context prefixes\n * - **Timestamps**: Optional ISO timestamp display\n * - **Environment Aware**: Automatically detects browser vs Node.js\n *\n * ## Log Levels\n *\n * - **ERROR** (0): Critical errors\n * - **WARN** (1): Warnings\n * - **INFO** (2): Informational messages (default)\n * - **DEBUG** (3): Debug information\n * - **TRACE** (4): Detailed trace information\n *\n * @example\n * Basic usage:\n * ```typescript\n * import { logger, LogLevel } from '@rb-games/core/utils';\n *\n * // Configure logger\n * logger.configure({\n *   level: LogLevel.DEBUG,\n *   showTimestamp: true,\n *   showColors: true\n * });\n *\n * // Log messages\n * logger.error('Critical error occurred');\n * logger.warn('This is a warning');\n * logger.info('Application started');\n * logger.debug('Debug information', { data: 'value' });\n * logger.trace('Detailed trace');\n * ```\n *\n * @example\n * Context loggers (used in plugins):\n * ```typescript\n * class MyPlugin {\n *   private logger = logger.createContextLogger('MyPlugin');\n *\n *   initialize() {\n *     this.logger.info('Plugin initialized');\n *     // Output: [2024-01-01T12:00:00.000Z] [INFO] [MyPlugin] Plugin initialized\n *   }\n *\n *   doSomething() {\n *     this.logger.debug('Doing something', { value: 42 });\n *     // Output: [2024-01-01T12:00:00.000Z] [DEBUG] [MyPlugin] Doing something { value: 42 }\n *   }\n * }\n * ```\n *\n * @example\n * Production configuration:\n * ```typescript\n * // In production, only show errors and warnings\n * if (process.env.NODE_ENV === 'production') {\n *   logger.setLevel(LogLevel.WARN);\n * } else {\n *   logger.setLevel(LogLevel.DEBUG);\n * }\n * ```\n *\n * @example\n * Disable logging:\n * ```typescript\n * logger.setEnabled(false);\n * ```\n *\n * @category Utils\n * @public\n */\nexport class Logger {\n  private static instance: Logger;\n  private config: LoggerConfig;\n\n  // Terminal colors (for Node.js environment)\n  private readonly terminalColors = {\n    reset: '\\x1b[0m',\n    red: '\\x1b[31m',\n    yellow: '\\x1b[33m',\n    blue: '\\x1b[34m',\n    green: '\\x1b[32m',\n    gray: '\\x1b[90m',\n    cyan: '\\x1b[36m',\n    magenta: '\\x1b[35m',\n    white: '\\x1b[37m',\n  };\n\n  // Browser console colors (using CSS)\n  private readonly browserColors = {\n    timestamp: 'color: gray',\n    context: 'color: cyan; font-weight: bold',\n    message: 'color: white',\n    error: 'color: red; font-weight: bold',\n    warn: 'color: orange; font-weight: bold',\n    info: 'color: dodgerblue; font-weight: bold',\n    debug: 'color: green',\n    trace: 'color: gray',\n  };\n\n  private readonly levelLabels = {\n    [LogLevel.ERROR]: 'ERROR',\n    [LogLevel.WARN]: 'WARN',\n    [LogLevel.INFO]: 'INFO',\n    [LogLevel.DEBUG]: 'DEBUG',\n    [LogLevel.TRACE]: 'TRACE',\n  };\n\n  private readonly levelColors = {\n    [LogLevel.ERROR]: this.terminalColors.red,\n    [LogLevel.WARN]: this.terminalColors.yellow,\n    [LogLevel.INFO]: this.terminalColors.blue,\n    [LogLevel.DEBUG]: this.terminalColors.green,\n    [LogLevel.TRACE]: this.terminalColors.gray,\n  };\n\n  private readonly levelBrowserColors = {\n    [LogLevel.ERROR]: this.browserColors.error,\n    [LogLevel.WARN]: this.browserColors.warn,\n    [LogLevel.INFO]: this.browserColors.info,\n    [LogLevel.DEBUG]: this.browserColors.debug,\n    [LogLevel.TRACE]: this.browserColors.trace,\n  };\n\n  /**\n   * Private constructor for singleton pattern\n   */\n  private constructor() {\n    // Default configuration\n    this.config = {\n      level: LogLevel.DEBUG, // Default log level\n      enabled: true, // Logging enabled by default\n      showTimestamp: false, // Show timestamps by default\n      showColors: true, // Show colors by default\n    };\n\n    if ((import.meta as { env?: { DEV?: boolean } }).env?.DEV) {\n      console.warn(\n        '[Logger] For better debugging experience, add Logger.ts to DevTools ignore list:\\n' +\n          'DevTools → Settings (F1) → Ignore List → Add pattern: /Logger\\\\.ts$',\n      );\n    }\n  }\n\n  /**\n   * Get the singleton instance of the Logger\n   */\n  public static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n    return Logger.instance;\n  }\n\n  /**\n   * Configure the logger\n   * @param config Configuration options\n   */\n  public configure(config: Partial<LoggerConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n\n  /**\n   * Enable or disable logging\n   * @param enabled Whether logging is enabled\n   */\n  public setEnabled(enabled: boolean): void {\n    this.config.enabled = enabled;\n  }\n\n  /**\n   * Set the log level\n   * @param level The log level to set\n   */\n  public setLevel(level: LogLevel): void {\n    this.config.level = level;\n  }\n\n  /**\n   * Get the current log level\n   */\n  public getLevel(): LogLevel {\n    return this.config.level;\n  }\n\n  /**\n   * Log an error message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public error(message: string, ...args: any[]): void {\n    this.log(LogLevel.ERROR, message, ...args);\n  }\n\n  /**\n   * Log a warning message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public warn(message: string, ...args: any[]): void {\n    this.log(LogLevel.WARN, message, ...args);\n  }\n\n  /**\n   * Log an info message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public info(message: string, ...args: any[]): void {\n    this.log(LogLevel.INFO, message, ...args);\n  }\n\n  /**\n   * Log a debug message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public debug(message: string, ...args: any[]): void {\n    this.log(LogLevel.DEBUG, message, ...args);\n  }\n\n  /**\n   * Log a trace message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public trace(message: string, ...args: any[]): void {\n    this.log(LogLevel.TRACE, message, ...args);\n  }\n\n  /**\n   * Log a message with a specific log level\n   * @param level The log level\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  private log(level: LogLevel, message: string, ...args: any[]): void {\n    // Only log if enabled and the log level is sufficient\n    if (!this.config.enabled || level > this.config.level) {\n      return;\n    }\n\n    if (!this.shouldLogMessage(message)) {\n      return;\n    }\n\n    // Check if we're in a browser environment\n    const isBrowser = typeof window !== 'undefined';\n\n    if (isBrowser && this.config.showColors) {\n      this.logBrowser(level, message, ...args);\n    } else {\n      this.logTerminal(level, message, ...args);\n    }\n  }\n\n  private extractContext(message: string): { context: string; messageContent: string } {\n    const contextMatch = message.match(/^\\[([^\\]]+)\\]\\s(.*)$/);\n\n    if (!contextMatch) {\n      return {\n        context: '',\n        messageContent: message,\n      };\n    }\n\n    return {\n      context: contextMatch[1],\n      messageContent: contextMatch[2],\n    };\n  }\n\n  private matchesFilter(value: string, matchers?: LoggerFilterMatcher[]): boolean {\n    if (!matchers?.length) {\n      return false;\n    }\n\n    return matchers.some((matcher) => {\n      if (typeof matcher === 'string') {\n        return value.includes(matcher);\n      }\n\n      matcher.lastIndex = 0;\n      return matcher.test(value);\n    });\n  }\n\n  private shouldLogMessage(message: string): boolean {\n    const filter = this.config.filter;\n\n    if (!filter) {\n      return true;\n    }\n\n    const hasFilters = Boolean(filter.contexts?.length || filter.messages?.length);\n\n    if (!hasFilters) {\n      return true;\n    }\n\n    const { context, messageContent } = this.extractContext(message);\n    const contextMatches = this.matchesFilter(context, filter.contexts);\n    const messageMatches = this.matchesFilter(messageContent, filter.messages);\n    const matches = contextMatches || messageMatches;\n\n    return filter.mode === 'exclude' ? !matches : matches;\n  }\n\n  /**\n   * Log a message in terminal/node environment\n   */\n  private logTerminal(level: LogLevel, message: string, ...args: any[]): void {\n    // Prepare log prefix\n    let timestamp = '';\n    let levelStr = '';\n    let contextPart = '';\n\n    // Extract context if present\n    const contextMatch = message.match(/^\\[([^\\]]+)\\]\\s(.*)$/);\n    let messageContent = message;\n\n    if (contextMatch) {\n      contextPart = `[${contextMatch[1]}] `;\n      messageContent = contextMatch[2];\n    }\n\n    // Add timestamp if enabled\n    if (this.config.showTimestamp) {\n      const now = new Date().toISOString();\n      timestamp = `[${now}] `;\n    }\n\n    // Add log level\n    levelStr = `[${this.levelLabels[level]}] `;\n\n    // Format with colors if enabled\n    if (this.config.showColors) {\n      const levelColor = this.levelColors[level];\n      const contextColor = this.terminalColors.cyan;\n      const timestampColor = this.terminalColors.gray;\n      const messageColor = this.terminalColors.white;\n\n      timestamp = `${timestampColor}${timestamp}${this.terminalColors.reset}`;\n      levelStr = `${levelColor}${levelStr}${this.terminalColors.reset}`;\n\n      if (contextPart) {\n        contextPart = `${contextColor}${contextPart}${this.terminalColors.reset}`;\n      }\n\n      messageContent = `${messageColor}${messageContent}${this.terminalColors.reset}`;\n    }\n\n    const formattedMessage = timestamp + levelStr + contextPart + messageContent;\n\n    // Log with console methods based on level\n    switch (level) {\n      case LogLevel.ERROR:\n        console.error(formattedMessage, ...args);\n        break;\n      case LogLevel.WARN:\n        console.warn(formattedMessage, ...args);\n        break;\n      case LogLevel.INFO:\n        console.info(formattedMessage, ...args);\n        break;\n      case LogLevel.DEBUG:\n      case LogLevel.TRACE:\n      default:\n        console.log(formattedMessage, ...args);\n        break;\n    }\n  }\n\n  /**\n   * Log a message in browser environment with CSS styling\n   */\n  private logBrowser(level: LogLevel, message: string, ...args: any[]): void {\n    // Extract context if present\n    const contextMatch = message.match(/^\\[([^\\]]+)\\]\\s(.*)$/);\n    let context = '';\n    let messageContent = message;\n\n    if (contextMatch) {\n      context = contextMatch[1];\n      messageContent = contextMatch[2];\n    }\n\n    // Create CSS styled format string\n    let format = '';\n    const formatArgs: string[] = [];\n\n    // Add timestamp if enabled\n    if (this.config.showTimestamp) {\n      const now = new Date().toISOString();\n      format += '%c[' + now + '] ';\n      formatArgs.push(this.browserColors.timestamp);\n    }\n\n    // Add log level with style\n    format += '%c[' + this.levelLabels[level] + '] ';\n    formatArgs.push(this.levelBrowserColors[level]);\n\n    // Add context if present\n    if (context) {\n      format += '%c[' + context + '] ';\n      formatArgs.push(this.browserColors.context);\n    }\n\n    // Add the actual message\n    format += '%c' + messageContent;\n    formatArgs.push(this.browserColors.message);\n\n    // Log with console methods based on level\n    switch (level) {\n      case LogLevel.ERROR:\n        console.error(format, ...formatArgs, ...args);\n        break;\n      case LogLevel.WARN:\n        console.warn(format, ...formatArgs, ...args);\n        break;\n      case LogLevel.INFO:\n        console.info(format, ...formatArgs, ...args);\n        break;\n      case LogLevel.DEBUG:\n      case LogLevel.TRACE:\n      default:\n        console.log(format, ...formatArgs, ...args);\n        break;\n    }\n  }\n\n  /**\n   * Creates a context-specific logger.\n   *\n   * Context loggers automatically prefix all log messages with a context tag.\n   * Commonly used in plugins and classes to identify log sources.\n   *\n   * @param context - Context name (e.g., 'MyPlugin', 'SceneManager')\n   * @returns ContextLogger instance\n   *\n   * @example\n   * ```typescript\n   * class DisplayPlugin {\n   *   private logger = logger.createContextLogger('DisplayPlugin');\n   *\n   *   initialize() {\n   *     this.logger.info('Initializing display');\n   *     // Output: [INFO] [DisplayPlugin] Initializing display\n   *   }\n   * }\n   * ```\n   */\n  public createContextLogger(context: string): ContextLogger {\n    return new ContextLogger(this, context);\n  }\n}\n\n/**\n * Context-specific logger that prefixes all messages.\n *\n * ContextLogger wraps the main Logger and automatically adds a context prefix\n * to all log messages. This makes it easy to identify which component or plugin\n * generated a log message.\n *\n * ## Usage\n *\n * Create context loggers using `logger.createContextLogger(context)`.\n * All log methods (error, warn, info, debug, trace) are available.\n *\n * @example\n * ```typescript\n * class ResourcePlugin {\n *   private logger = logger.createContextLogger('ResourcePlugin');\n *\n *   async loadAssets() {\n *     this.logger.info('Loading assets...');\n *     // Output: [INFO] [ResourcePlugin] Loading assets...\n *\n *     try {\n *       await this.load();\n *       this.logger.info('Assets loaded successfully');\n *     } catch (error) {\n *       this.logger.error('Failed to load assets', error);\n *     }\n *   }\n * }\n * ```\n *\n * @category Utils\n * @public\n */\nexport class ContextLogger {\n  private logger: Logger;\n  private context: string;\n\n  constructor(logger: Logger, context: string) {\n    this.logger = logger;\n    this.context = context;\n  }\n\n  /**\n   * Log an error message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public error(message: string, ...args: any[]): void {\n    this.logger.error(`[${this.context}] ${message}`, ...args);\n  }\n\n  /**\n   * Log a warning message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public warn(message: string, ...args: any[]): void {\n    this.logger.warn(`[${this.context}] ${message}`, ...args);\n  }\n\n  /**\n   * Log an info message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public info(message: string, ...args: any[]): void {\n    this.logger.info(`[${this.context}] ${message}`, ...args);\n  }\n\n  /**\n   * Log a debug message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public debug(message: string, ...args: any[]): void {\n    this.logger.debug(`[${this.context}] ${message}`, ...args);\n  }\n\n  /**\n   * Log a trace message\n   * @param message The message to log\n   * @param args Additional arguments to log\n   */\n  public trace(message: string, ...args: any[]): void {\n    this.logger.trace(`[${this.context}] ${message}`, ...args);\n  }\n}\n\n// Export a default instance for convenience\nexport const logger = Logger.getInstance();\n\n// Cached context loggers for inline usage\nconst contextLoggers = new Map<string, ContextLogger>();\n\n/**\n * Get or create a cached context logger.\n * Same context string always returns the same instance.\n *\n * Preferred over class property pattern for easier tree-shaking\n * and production stripping.\n *\n * @param context - Context name (e.g., 'MyPlugin', 'SceneManager')\n * @returns Cached ContextLogger instance\n *\n * @example\n * ```typescript\n * import { getLogger } from '@rb-games/core/utils';\n *\n * // No class property needed - use inline\n * getLogger('MyClass').info('message');\n * getLogger('MyClass').debug('data', { x: 1 });\n * ```\n */\nexport function getLogger(context: string): ContextLogger {\n  let cached = contextLoggers.get(context);\n  if (!cached) {\n    cached = new ContextLogger(logger, context);\n    contextLoggers.set(context, cached);\n  }\n  return cached;\n}\n"]}