@astral/ui 4.82.0 → 4.84.0

package/services/Logger/Logger.js

@@ -0,0 +1,68 @@
+// biome-ignore-all lint/suspicious/noConsole: Logger — единственная точка вывода в консоль
+/** Приоритет уровней. Лог виден, если его приоритет ≤ порога. */
+const LOG_LEVEL_PRIORITY = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+/** Порог по умолчанию для каждого окружения. */
+const DEFAULT_LOG_LEVEL_BY_ENV = {
+    production: 'error',
+    test: 'silent',
+    development: 'warn',
+};
+/** Порог для текущего окружения. */
+const getEnvLevel = () => DEFAULT_LOG_LEVEL_BY_ENV[process.env.NODE_ENV ?? 'development'] ?? 'warn';
+/**
+ * Логгер.
+ * Формат логов: `{пакет}: {иконка} [{scope}]: {сообщение}`.
+ * */
+export class Logger {
+    constructor(name, scope, context, parent, level, console = globalThis.console) {
+        this.name = name;
+        this.scope = scope;
+        this.context = context;
+        this.parent = parent;
+        this.level = level;
+        this.console = console;
+        /**
+         * Меняет уровень пакета.
+         * Без `level` — сброс к env-дефолту.
+         * Возвращает функцию отмены — вернёт прежний уровень.
+         * */
+        this.configure = (options = {}) => {
+            const previousLevel = this.level;
+            this.level = options.level;
+            return () => {
+                this.level = previousLevel;
+            };
+        };
+        /** Дочерний логгер: добавляет `scope`, наследует уровень корня. */
+        this.child = (scope, options) => {
+            return new Logger(this.name, 
+            // склеиваем scope: `Onboarding` → `Onboarding Tour`.
+            this.scope ? `${this.scope} ${scope}` : scope, { ...this.context, ...options?.context }, this, undefined, this.console);
+        };
+        /** Дойдёт ли лог такого уровня до консоли. */
+        this.isLevelEnabled = (level) => LOG_LEVEL_PRIORITY[level] <= LOG_LEVEL_PRIORITY[this.effectiveLevel()];
+        this.success = (message, ...data) => this.print('info', '✅', this.console.log, message, data);
+        this.info = (message, ...data) => this.print('info', 'ℹ️', this.console.log, message, data);
+        this.warn = (message, ...data) => this.print('warn', '⚠️', this.console.warn, message, data);
+        this.debug = (message, ...data) => this.print('debug', '🐞', this.console.log, message, data);
+        this.error = (message, ...data) => this.print('error', '❌', this.console.error, message, data);
+        /** Свой уровень → уровень родителя по цепочке → env-дефолт. */
+        this.effectiveLevel = () => this.level ?? this.parent?.effectiveLevel() ?? getEnvLevel();
+        this.print = (level, icon, sink, message, data) => {
+            if (!this.isLevelEnabled(level)) {
+                return;
+            }
+            const prefix = this.name ? `${this.name}: ` : '';
+            const scope = this.scope ? ` [${this.scope}]:` : '';
+            const withContext = Object.keys(this.context).length === 0 ? data : [...data, this.context];
+            sink(`${prefix}${icon}${scope} ${message}`, ...withContext);
+        };
+    }
+}
+Logger.create = ({ name, context = {}, level, }) => new Logger(name, undefined, { ...context }, null, level);

package/services/Logger/index.d.ts

@@ -0,0 +1,10 @@
+import { Logger, type ConfigureOptions, type CreateLoggerOptions, type LogContext, type LoggerOptions, type LogLevel, type LogThreshold } from './Logger';
+export { Logger, type ConfigureOptions, type CreateLoggerOptions, type LogContext, type LoggerOptions, type LogLevel, type LogThreshold, };
+/**
+ * Фабрика Logger для `@astral/ui`: сервисы и компоненты получают инстанс через DI.
+ */
+export declare const createLogger: (scope: string, options?: LoggerOptions) => Logger;
+/**
+ * (Пере)-Настройка логгера пакета `@astral/ui` — вызывает `ConfigProvider`.
+ */
+export declare const configureLogger: (options?: ConfigureOptions) => () => void;

package/services/Logger/index.js

@@ -0,0 +1,12 @@
+import { Logger, } from './Logger';
+export { Logger, };
+// Корневой логгер пакета @astral/ui.
+const uiLogger = Logger.create({ name: '@astral/ui' });
+/**
+ * Фабрика Logger для `@astral/ui`: сервисы и компоненты получают инстанс через DI.
+ */
+export const createLogger = (scope, options) => uiLogger.child(scope, options);
+/**
+ * (Пере)-Настройка логгера пакета `@astral/ui` — вызывает `ConfigProvider`.
+ */
+export const configureLogger = (options) => uiLogger.configure(options);