@astral/ui 4.83.0 → 4.84.0

package/_mocks/LoggerMock/LoggerMock.d.ts

@@ -0,0 +1,16 @@
+import { type Logger } from '../../services/Logger';
+/**
+ * Mock логгера для тестов
+ */
+export declare class LoggerMock {
+    configure: Logger['configure'];
+    child: Logger['child'];
+    isLevelEnabled: Logger['isLevelEnabled'];
+    success: Logger['success'];
+    info: Logger['info'];
+    warn: Logger['warn'];
+    debug: Logger['debug'];
+    error: Logger['error'];
+    constructor();
+}
+export declare const createLoggerMock: () => Logger;

package/_mocks/LoggerMock/LoggerMock.js

@@ -0,0 +1,18 @@
+import { vi } from 'vitest';
+/**
+ * Mock логгера для тестов
+ */
+export class LoggerMock {
+    constructor() {
+        this.configure = vi.fn(() => vi.fn());
+        this.child = vi.fn();
+        this.isLevelEnabled = vi.fn(() => false);
+        this.success = vi.fn();
+        this.info = vi.fn();
+        this.warn = vi.fn();
+        this.debug = vi.fn();
+        this.error = vi.fn();
+        vi.mocked(this.child).mockReturnValue(this);
+    }
+}
+export const createLoggerMock = () => new LoggerMock();

package/_mocks/LoggerMock/index.d.ts

@@ -0,0 +1 @@
+export * from './LoggerMock';

package/_mocks/LoggerMock/index.js

@@ -0,0 +1 @@
+export * from './LoggerMock';

package/components/ConfigProvider/ConfigProvider.d.ts

@@ -1,4 +1,5 @@
 import { type ReactElement, type ReactNode } from 'react';
+import { type LogThreshold } from '../../services/Logger';
 import { type LanguageMap } from '../DatePicker/types';
 import { type PlaceholderImageProps } from '../placeholders/Placeholder/Image';
 import { type CaptureException } from '../services/ErrorService';
@@ -138,7 +139,12 @@ export type ConfigProviderProps = Partial<ConfigContextProps> & {
      * Переданный в компонент флаг напрямую имеет приоритет выше
      */
     nextFeatureFlags?: NextFeatureFlagsContextProps;
+    /**
+     * Порог логов ui-kit в консоли. По умолчанию: prod → `error`, dev → `warn`,
+     * test → `silent`. `silent` — выключить полностью.
+     */
+    logLevel?: LogThreshold;
 };
 export declare const ConfigContext: import("react").Context<ConfigContextProps>;
-export declare const ConfigProvider: ({ children, language, datePickerLanguageMap, captureException: captureExceptionProp, emptySymbol, imagesMap, techSup, hidePersonalData, hidePersonalDataClassname, hidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags, }: Partial<ConfigProviderProps>) => import("react/jsx-runtime").JSX.Element;
+export declare const ConfigProvider: ({ children, language, datePickerLanguageMap, captureException: captureExceptionProp, emptySymbol, imagesMap, techSup, hidePersonalData, hidePersonalDataClassname, hidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags, logLevel, }: Partial<ConfigProviderProps>) => import("react/jsx-runtime").JSX.Element;
 export {};

package/components/ConfigProvider/ConfigProvider.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useEffect, useMemo, } from 'react';
+import { createContext, useEffect, } from 'react';
+import { configureLogger } from '../../services/Logger';
 import { russianMap } from '../DatePicker/constants';
 import { ErrorService } from '../services/ErrorService';
 import { NextFeatureFlagsContext, } from './NextFeatureFlagsContext';
@@ -13,6 +14,10 @@ const techSupDefault = {
     phone: '',
     email: '',
 };
+const defaultCaptureException = (error) => {
+    // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
+    console.error(error);
+};
 const defaultHidePersonalDataClassname = 'ym-hide-content sentry-mask';
 const defaultHidePersonalInputDataClassname = 'ym-disable-keys sentry-mask';
 export const ConfigContext = createContext({
@@ -27,20 +32,21 @@ export const ConfigContext = createContext({
     hidePersonalInputDataClassname: defaultHidePersonalInputDataClassname,
     hidePersonalData: true,
 });
-export const ConfigProvider = ({ children, language = 'ru', datePickerLanguageMap = russianMap, captureException: captureExceptionProp, emptySymbol = '—', imagesMap = imagesMapDefault, techSup = techSupDefault, hidePersonalData = true, hidePersonalDataClassname = defaultHidePersonalDataClassname, hidePersonalInputDataClassname = defaultHidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags = {}, }) => {
-    const captureException = 
-    // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
-    captureExceptionProp || ((error) => console.error(error));
-    useMemo(() => {
+export const ConfigProvider = ({ children, language = 'ru', datePickerLanguageMap = russianMap, captureException: captureExceptionProp, emptySymbol = '—', imagesMap = imagesMapDefault, techSup = techSupDefault, hidePersonalData = true, hidePersonalDataClassname = defaultHidePersonalDataClassname, hidePersonalInputDataClassname = defaultHidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags = {}, logLevel, }) => {
+    const captureException = captureExceptionProp ?? defaultCaptureException;
+    useEffect(() => {
         ErrorService.getInstance().init(captureException);
     }, [captureException]);
     useEffect(() => {
-        if (!captureException) {
+        return configureLogger({ level: logLevel });
+    }, [logLevel]);
+    useEffect(() => {
+        if (!captureExceptionProp) {
             // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
             console.warn('ConfigProvider: Необходимо наличие captureException, связанного с сервисом мониторинга ошибок.\n' +
                 'На данный момент все ошибки, отлавливаемые в ErrorBoundary будут выводиться только в консоль');
         }
-    }, []);
+    }, [captureExceptionProp]);
     const components = {
         ...propsComponents,
         layout: {

package/components/DashboardLayout/Header/useLogic/useLogic.d.ts

@@ -5,7 +5,7 @@ export declare const useLogic: ({ profile, menuOrganization }: HeaderProps) => {
     isShowProfile: boolean;
     isMobile: boolean;
     isFocusedMode: boolean;
-    mobileHeaderPriorityFeature: "menuOrg" | "profile";
+    mobileHeaderPriorityFeature: "profile" | "menuOrg";
     isLoading: boolean;
     collapsedIn: boolean;
     onToggleSidebar: (newValue?: boolean | undefined) => void;

package/components/Onboarding/Onboarding.js

@@ -1,3 +1,4 @@
+import { createLogger } from '../../services/Logger';
 import { ErrorService } from '../services/ErrorService';
 import { ActiveStepStore } from './core/ActiveStepStore';
 import { OnboardingTour } from './core/OnboardingTour';
@@ -18,11 +19,20 @@ export class Onboarding {
          * Создаёт тур.
          */
         this.createTour = (tourConfig) => {
+            const logger = createLogger('Onboarding', {
+                context: { tourName: tourConfig.name },
+            });
             // Fail-fast на некорректной конфигурации до сборки тура.
-            validateTourConfig(tourConfig);
+            try {
+                validateTourConfig(tourConfig);
+            }
+            catch (error) {
+                logger.error('Некорректная конфигурация тура', error);
+                throw error;
+            }
             // Ключ хранилища уникален на тур, поэтому стратегия строится на createTour.
-            const progressStorage = new ProgressStorage(this.saveStrategyFactory(tourConfig.name));
-            return new OnboardingTour(tourConfig, progressStorage, this.activeStepStore, this.errorService);
+            const progressStorage = new ProgressStorage(this.saveStrategyFactory(tourConfig.name), logger);
+            return new OnboardingTour(tourConfig, progressStorage, this.activeStepStore, this.errorService, logger);
         };
         /**
          * Закрывает показанный сейчас тур.

package/components/Onboarding/core/ExitController/ExitController.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 export type ExitControllerParams = {
     /**
      * Фактическое закрытие тура. Вызывается только после подтверждения в
@@ -20,8 +21,9 @@ export type ExitControllerParams = {
  */
 export declare class ExitController {
     private readonly params;
+    private readonly logger;
     private confirming;
-    constructor(params: ExitControllerParams);
+    constructor(params: ExitControllerParams, logger: Logger);
     /**
      * Идёт ли запрос подтверждения выхода.
      */

package/components/Onboarding/core/ExitController/ExitController.js

@@ -6,8 +6,9 @@
  * (ConfirmExit); закрытие происходит только по confirm.
  */
 export class ExitController {
-    constructor(params) {
+    constructor(params, logger) {
         this.params = params;
+        this.logger = logger;
         this.confirming = false;
         /**
          * Запрос на закрытие — показывает ConfirmExit. Повторные вызовы во время
@@ -17,6 +18,7 @@ export class ExitController {
             if (this.confirming) {
                 return;
             }
+            this.logger.debug('Запрошен выход из тура, показано подтверждение');
             this.confirming = true;
             this.params.onChange();
         };
@@ -37,6 +39,7 @@ export class ExitController {
             if (!this.confirming) {
                 return;
             }
+            this.logger.debug('Выход из тура отменён');
             this.confirming = false;
             this.params.onChange();
         };

package/components/Onboarding/core/OnboardingTour/OnboardingTour.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 import { type ErrorService } from '../../../services/ErrorService';
 import { type OnboardingTourConfig, type Step, type StepHandles, type TourProgress } from '../../types';
 import { type ActiveStepStore } from '../ActiveStepStore';
@@ -13,6 +14,7 @@ export declare class OnboardingTour<TSteps extends readonly Step[] = readonly St
     private readonly progressStorage;
     private readonly activeStepStore;
     private readonly errorService;
+    private readonly logger;
     private readonly navigator;
     private readonly resolver;
     private readonly stepsController;
@@ -22,7 +24,7 @@ export declare class OnboardingTour<TSteps extends readonly Step[] = readonly St
      * Типобезопасный доступ к шагам по их именам.
      */
     readonly steps: StepHandles<TSteps>;
-    constructor(config: OnboardingTourConfig<TSteps>, progressStorage: ProgressStorage, activeStepStore: ActiveStepStore, errorService: ErrorService);
+    constructor(config: OnboardingTourConfig<TSteps>, progressStorage: ProgressStorage, activeStepStore: ActiveStepStore, errorService: ErrorService, logger: Logger);
     /**
      * Запуск тура с первого шага.
      */

package/components/Onboarding/core/OnboardingTour/OnboardingTour.js

@@ -9,11 +9,12 @@ import { StepsController } from '../StepsController';
  * состояние активного шага в store своего экземпляра онбординга.
  */
 export class OnboardingTour {
-    constructor(config, progressStorage, activeStepStore, errorService) {
+    constructor(config, progressStorage, activeStepStore, errorService, logger) {
         this.config = config;
         this.progressStorage = progressStorage;
         this.activeStepStore = activeStepStore;
         this.errorService = errorService;
+        this.logger = logger;
         this.status = 'idle';
         /**
          * Запуск тура с первого шага.
@@ -21,8 +22,10 @@ export class OnboardingTour {
         this.start = async () => {
             const persisted = await this.progressStorage.load();
             if (persisted?.isDismissed) {
+                this.logger.info('Тур пропущен: ранее закрыт пользователем');
                 return;
             }
+            this.logger.info('Тур запущен');
             this.exitController.reset();
             this.navigator.reset();
             this.enterCurrentStep();
@@ -32,8 +35,10 @@ export class OnboardingTour {
          */
         this.resume = () => {
             if (this.status !== 'waiting-resume') {
+                this.logger.debug('resume проигнорирован: тур не на паузе');
                 return;
             }
+            this.logger.debug('Тур возобновлён после паузы');
             this.status = 'running';
             this.publishStep();
         };
@@ -42,6 +47,7 @@ export class OnboardingTour {
          */
         this.restore = async () => {
             const persisted = await this.progressStorage.load();
+            this.logger.info('Тур восстановлен');
             this.exitController.reset();
             this.navigator.reset();
             // Пройденный тур переигрываем с начала; иначе продолжаем с сохранённого шага.
@@ -148,6 +154,7 @@ export class OnboardingTour {
          */
         this.resetProgress = async () => {
             await this.progressStorage.reset();
+            this.logger.debug('Прогресс тура сброшен');
         };
         /**
          * Возвращает сохранённый прогресс тура
@@ -167,12 +174,14 @@ export class OnboardingTour {
                     isDismissed: true,
                 });
             }
+            this.logger.info('Тур закрыт', { reason });
             this.status = 'idle';
             this.exitController.reset();
             this.releaseStep();
             this.config.onClose?.(reason);
         };
         this.handleError = (error) => {
+            this.logger.error('Ошибка тура', error);
             this.errorService.captureException(error, {
                 place: 'Onboarding',
                 tourName: this.config.name,
@@ -185,17 +194,22 @@ export class OnboardingTour {
         this.resolver = new StepResolver(config);
         this.stepsController = new StepsController(config.steps, (stepName) => this.refreshStep(stepName));
         this.steps = this.stepsController.handles;
-        this.exitController = new ExitController({
+        const exitParams = {
             close: () => this.exit('dismissed'),
             onChange: () => this.publishStep(),
-        });
+        };
+        this.exitController = new ExitController(exitParams, this.logger);
     }
     /**
      * Разрешена ли навигация сейчас: тур показан на экране и владеет активным
      * шагом store
      */
     canNavigate() {
-        return this.status === 'running' && this.activeStepStore.isActiveTour(this);
+        const isNavigable = this.status === 'running' && this.activeStepStore.isActiveTour(this);
+        if (!isNavigable) {
+            this.logger.debug('Навигация проигнорирована: тур неактивен');
+        }
+        return isNavigable;
     }
     /**
      * Переход к текущему шагу. Шаг с `waitForResume` ставит тур в ожидание
@@ -204,16 +218,23 @@ export class OnboardingTour {
     enterCurrentStep() {
         // Показывать нечего: у тура нет ни одного видимого (не-пропущенного) шага.
         if (this.navigator.total === 0) {
+            this.logger.warn('Нет ни одного видимого шага, тур не показан');
             this.status = 'idle';
             this.releaseStep();
             return;
         }
         const step = this.navigator.current;
         if (step.waitForResume) {
+            this.logger.debug('Ожидание resume', { step: step.name });
             this.status = 'waiting-resume';
             this.releaseStep();
             return;
         }
+        this.logger.debug('Показан шаг', {
+            step: step.name,
+            position: this.navigator.position,
+            total: this.navigator.total,
+        });
         this.status = 'running';
         this.publishStep();
     }

package/components/Onboarding/core/ProgressStorage/ProgressStorage.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 import { type SaveStrategy, type TourProgress } from '../../types';
 /**
  * Обёртка над переданной SaveStrategy, изолирующая тур от исключений хранилища
@@ -9,8 +10,9 @@ import { type SaveStrategy, type TourProgress } from '../../types';
  */
 export declare class ProgressStorage {
     private readonly strategy;
+    private readonly logger;
     private saving;
-    constructor(strategy: SaveStrategy);
+    constructor(strategy: SaveStrategy, logger: Logger);
     load(): Promise<TourProgress | null>;
     save(state: TourProgress): Promise<void>;
     /**

package/components/Onboarding/core/ProgressStorage/ProgressStorage.js

@@ -15,8 +15,9 @@ const CLEARED_STATE = {
  * `load()` ждёт текущее сохранение, поэтому читает уже применённое состояние.
  */
 export class ProgressStorage {
-    constructor(strategy) {
+    constructor(strategy, logger) {
         this.strategy = strategy;
+        this.logger = logger;
         this.saving = Promise.resolve();
     }
     async load() {
@@ -25,7 +26,9 @@ export class ProgressStorage {
         try {
             return await this.strategy.load();
         }
-        catch {
+        catch (error) {
+            // Ошибка хранилища не должна ронять тур, но остаётся видимой в логах.
+            this.logger.warn('Ошибка чтения прогресса из хранилища', error);
             return null;
         }
     }
@@ -49,8 +52,9 @@ export class ProgressStorage {
             try {
                 await write();
             }
-            catch {
-                // Ошибка хранилища не должна ронять тур;
+            catch (error) {
+                // Ошибка хранилища не должна ронять тур, но остаётся видимой в логах.
+                this.logger.warn('Ошибка записи прогресса в хранилище', error);
             }
         });
         return this.saving;

package/node/_mocks/LoggerMock/LoggerMock.d.ts

@@ -0,0 +1,16 @@
+import { type Logger } from '../../services/Logger';
+/**
+ * Mock логгера для тестов
+ */
+export declare class LoggerMock {
+    configure: Logger['configure'];
+    child: Logger['child'];
+    isLevelEnabled: Logger['isLevelEnabled'];
+    success: Logger['success'];
+    info: Logger['info'];
+    warn: Logger['warn'];
+    debug: Logger['debug'];
+    error: Logger['error'];
+    constructor();
+}
+export declare const createLoggerMock: () => Logger;

package/node/_mocks/LoggerMock/LoggerMock.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoggerMock = exports.LoggerMock = void 0;
+const vitest_1 = require("vitest");
+/**
+ * Mock логгера для тестов
+ */
+class LoggerMock {
+    constructor() {
+        this.configure = vitest_1.vi.fn(() => vitest_1.vi.fn());
+        this.child = vitest_1.vi.fn();
+        this.isLevelEnabled = vitest_1.vi.fn(() => false);
+        this.success = vitest_1.vi.fn();
+        this.info = vitest_1.vi.fn();
+        this.warn = vitest_1.vi.fn();
+        this.debug = vitest_1.vi.fn();
+        this.error = vitest_1.vi.fn();
+        vitest_1.vi.mocked(this.child).mockReturnValue(this);
+    }
+}
+exports.LoggerMock = LoggerMock;
+const createLoggerMock = () => new LoggerMock();
+exports.createLoggerMock = createLoggerMock;

package/node/_mocks/LoggerMock/index.d.ts

@@ -0,0 +1 @@
+export * from './LoggerMock';

package/node/_mocks/LoggerMock/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./LoggerMock"), exports);

package/node/components/ConfigProvider/ConfigProvider.d.ts

@@ -1,4 +1,5 @@
 import { type ReactElement, type ReactNode } from 'react';
+import { type LogThreshold } from '../../services/Logger';
 import { type LanguageMap } from '../DatePicker/types';
 import { type PlaceholderImageProps } from '../placeholders/Placeholder/Image';
 import { type CaptureException } from '../services/ErrorService';
@@ -138,7 +139,12 @@ export type ConfigProviderProps = Partial<ConfigContextProps> & {
      * Переданный в компонент флаг напрямую имеет приоритет выше
      */
     nextFeatureFlags?: NextFeatureFlagsContextProps;
+    /**
+     * Порог логов ui-kit в консоли. По умолчанию: prod → `error`, dev → `warn`,
+     * test → `silent`. `silent` — выключить полностью.
+     */
+    logLevel?: LogThreshold;
 };
 export declare const ConfigContext: import("react").Context<ConfigContextProps>;
-export declare const ConfigProvider: ({ children, language, datePickerLanguageMap, captureException: captureExceptionProp, emptySymbol, imagesMap, techSup, hidePersonalData, hidePersonalDataClassname, hidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags, }: Partial<ConfigProviderProps>) => import("react/jsx-runtime").JSX.Element;
+export declare const ConfigProvider: ({ children, language, datePickerLanguageMap, captureException: captureExceptionProp, emptySymbol, imagesMap, techSup, hidePersonalData, hidePersonalDataClassname, hidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags, logLevel, }: Partial<ConfigProviderProps>) => import("react/jsx-runtime").JSX.Element;
 export {};

package/node/components/ConfigProvider/ConfigProvider.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigProvider = exports.ConfigContext = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
+const Logger_1 = require("../../services/Logger");
 const constants_1 = require("../DatePicker/constants");
 const ErrorService_1 = require("../services/ErrorService");
 const NextFeatureFlagsContext_1 = require("./NextFeatureFlagsContext");
@@ -16,6 +17,10 @@ const techSupDefault = {
     phone: '',
     email: '',
 };
+const defaultCaptureException = (error) => {
+    // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
+    console.error(error);
+};
 const defaultHidePersonalDataClassname = 'ym-hide-content sentry-mask';
 const defaultHidePersonalInputDataClassname = 'ym-disable-keys sentry-mask';
 exports.ConfigContext = (0, react_1.createContext)({
@@ -30,20 +35,21 @@ exports.ConfigContext = (0, react_1.createContext)({
     hidePersonalInputDataClassname: defaultHidePersonalInputDataClassname,
     hidePersonalData: true,
 });
-const ConfigProvider = ({ children, language = 'ru', datePickerLanguageMap = constants_1.russianMap, captureException: captureExceptionProp, emptySymbol = '—', imagesMap = imagesMapDefault, techSup = techSupDefault, hidePersonalData = true, hidePersonalDataClassname = defaultHidePersonalDataClassname, hidePersonalInputDataClassname = defaultHidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags = {}, }) => {
-    const captureException = 
-    // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
-    captureExceptionProp || ((error) => console.error(error));
-    (0, react_1.useMemo)(() => {
+const ConfigProvider = ({ children, language = 'ru', datePickerLanguageMap = constants_1.russianMap, captureException: captureExceptionProp, emptySymbol = '—', imagesMap = imagesMapDefault, techSup = techSupDefault, hidePersonalData = true, hidePersonalDataClassname = defaultHidePersonalDataClassname, hidePersonalInputDataClassname = defaultHidePersonalInputDataClassname, components: propsComponents, nextFeatureFlags = {}, logLevel, }) => {
+    const captureException = captureExceptionProp ?? defaultCaptureException;
+    (0, react_1.useEffect)(() => {
         ErrorService_1.ErrorService.getInstance().init(captureException);
     }, [captureException]);
     (0, react_1.useEffect)(() => {
-        if (!captureException) {
+        return (0, Logger_1.configureLogger)({ level: logLevel });
+    }, [logLevel]);
+    (0, react_1.useEffect)(() => {
+        if (!captureExceptionProp) {
             // biome-ignore lint/suspicious/noConsole: Ошибка для интеграторов
             console.warn('ConfigProvider: Необходимо наличие captureException, связанного с сервисом мониторинга ошибок.\n' +
                 'На данный момент все ошибки, отлавливаемые в ErrorBoundary будут выводиться только в консоль');
         }
-    }, []);
+    }, [captureExceptionProp]);
     const components = {
         ...propsComponents,
         layout: {

package/node/components/DashboardLayout/Header/useLogic/useLogic.d.ts

@@ -5,7 +5,7 @@ export declare const useLogic: ({ profile, menuOrganization }: HeaderProps) => {
     isShowProfile: boolean;
     isMobile: boolean;
     isFocusedMode: boolean;
-    mobileHeaderPriorityFeature: "menuOrg" | "profile";
+    mobileHeaderPriorityFeature: "profile" | "menuOrg";
     isLoading: boolean;
     collapsedIn: boolean;
     onToggleSidebar: (newValue?: boolean | undefined) => void;

package/node/components/Onboarding/Onboarding.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOnboarding = exports.Onboarding = void 0;
+const Logger_1 = require("../../services/Logger");
 const ErrorService_1 = require("../services/ErrorService");
 const ActiveStepStore_1 = require("./core/ActiveStepStore");
 const OnboardingTour_1 = require("./core/OnboardingTour");
@@ -21,11 +22,20 @@ class Onboarding {
          * Создаёт тур.
          */
         this.createTour = (tourConfig) => {
+            const logger = (0, Logger_1.createLogger)('Onboarding', {
+                context: { tourName: tourConfig.name },
+            });
             // Fail-fast на некорректной конфигурации до сборки тура.
-            (0, validation_1.validateTourConfig)(tourConfig);
+            try {
+                (0, validation_1.validateTourConfig)(tourConfig);
+            }
+            catch (error) {
+                logger.error('Некорректная конфигурация тура', error);
+                throw error;
+            }
             // Ключ хранилища уникален на тур, поэтому стратегия строится на createTour.
-            const progressStorage = new ProgressStorage_1.ProgressStorage(this.saveStrategyFactory(tourConfig.name));
-            return new OnboardingTour_1.OnboardingTour(tourConfig, progressStorage, this.activeStepStore, this.errorService);
+            const progressStorage = new ProgressStorage_1.ProgressStorage(this.saveStrategyFactory(tourConfig.name), logger);
+            return new OnboardingTour_1.OnboardingTour(tourConfig, progressStorage, this.activeStepStore, this.errorService, logger);
         };
         /**
          * Закрывает показанный сейчас тур.

package/node/components/Onboarding/core/ExitController/ExitController.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 export type ExitControllerParams = {
     /**
      * Фактическое закрытие тура. Вызывается только после подтверждения в
@@ -20,8 +21,9 @@ export type ExitControllerParams = {
  */
 export declare class ExitController {
     private readonly params;
+    private readonly logger;
     private confirming;
-    constructor(params: ExitControllerParams);
+    constructor(params: ExitControllerParams, logger: Logger);
     /**
      * Идёт ли запрос подтверждения выхода.
      */

package/node/components/Onboarding/core/ExitController/ExitController.js

@@ -9,8 +9,9 @@ exports.ExitController = void 0;
  * (ConfirmExit); закрытие происходит только по confirm.
  */
 class ExitController {
-    constructor(params) {
+    constructor(params, logger) {
         this.params = params;
+        this.logger = logger;
         this.confirming = false;
         /**
          * Запрос на закрытие — показывает ConfirmExit. Повторные вызовы во время
@@ -20,6 +21,7 @@ class ExitController {
             if (this.confirming) {
                 return;
             }
+            this.logger.debug('Запрошен выход из тура, показано подтверждение');
             this.confirming = true;
             this.params.onChange();
         };
@@ -40,6 +42,7 @@ class ExitController {
             if (!this.confirming) {
                 return;
             }
+            this.logger.debug('Выход из тура отменён');
             this.confirming = false;
             this.params.onChange();
         };

package/node/components/Onboarding/core/OnboardingTour/OnboardingTour.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 import { type ErrorService } from '../../../services/ErrorService';
 import { type OnboardingTourConfig, type Step, type StepHandles, type TourProgress } from '../../types';
 import { type ActiveStepStore } from '../ActiveStepStore';
@@ -13,6 +14,7 @@ export declare class OnboardingTour<TSteps extends readonly Step[] = readonly St
     private readonly progressStorage;
     private readonly activeStepStore;
     private readonly errorService;
+    private readonly logger;
     private readonly navigator;
     private readonly resolver;
     private readonly stepsController;
@@ -22,7 +24,7 @@ export declare class OnboardingTour<TSteps extends readonly Step[] = readonly St
      * Типобезопасный доступ к шагам по их именам.
      */
     readonly steps: StepHandles<TSteps>;
-    constructor(config: OnboardingTourConfig<TSteps>, progressStorage: ProgressStorage, activeStepStore: ActiveStepStore, errorService: ErrorService);
+    constructor(config: OnboardingTourConfig<TSteps>, progressStorage: ProgressStorage, activeStepStore: ActiveStepStore, errorService: ErrorService, logger: Logger);
     /**
      * Запуск тура с первого шага.
      */

package/node/components/Onboarding/core/OnboardingTour/OnboardingTour.js

@@ -12,11 +12,12 @@ const StepsController_1 = require("../StepsController");
  * состояние активного шага в store своего экземпляра онбординга.
  */
 class OnboardingTour {
-    constructor(config, progressStorage, activeStepStore, errorService) {
+    constructor(config, progressStorage, activeStepStore, errorService, logger) {
         this.config = config;
         this.progressStorage = progressStorage;
         this.activeStepStore = activeStepStore;
         this.errorService = errorService;
+        this.logger = logger;
         this.status = 'idle';
         /**
          * Запуск тура с первого шага.
@@ -24,8 +25,10 @@ class OnboardingTour {
         this.start = async () => {
             const persisted = await this.progressStorage.load();
             if (persisted?.isDismissed) {
+                this.logger.info('Тур пропущен: ранее закрыт пользователем');
                 return;
             }
+            this.logger.info('Тур запущен');
             this.exitController.reset();
             this.navigator.reset();
             this.enterCurrentStep();
@@ -35,8 +38,10 @@ class OnboardingTour {
          */
         this.resume = () => {
             if (this.status !== 'waiting-resume') {
+                this.logger.debug('resume проигнорирован: тур не на паузе');
                 return;
             }
+            this.logger.debug('Тур возобновлён после паузы');
             this.status = 'running';
             this.publishStep();
         };
@@ -45,6 +50,7 @@ class OnboardingTour {
          */
         this.restore = async () => {
             const persisted = await this.progressStorage.load();
+            this.logger.info('Тур восстановлен');
             this.exitController.reset();
             this.navigator.reset();
             // Пройденный тур переигрываем с начала; иначе продолжаем с сохранённого шага.
@@ -151,6 +157,7 @@ class OnboardingTour {
          */
         this.resetProgress = async () => {
             await this.progressStorage.reset();
+            this.logger.debug('Прогресс тура сброшен');
         };
         /**
          * Возвращает сохранённый прогресс тура
@@ -170,12 +177,14 @@ class OnboardingTour {
                     isDismissed: true,
                 });
             }
+            this.logger.info('Тур закрыт', { reason });
             this.status = 'idle';
             this.exitController.reset();
             this.releaseStep();
             this.config.onClose?.(reason);
         };
         this.handleError = (error) => {
+            this.logger.error('Ошибка тура', error);
             this.errorService.captureException(error, {
                 place: 'Onboarding',
                 tourName: this.config.name,
@@ -188,17 +197,22 @@ class OnboardingTour {
         this.resolver = new StepResolver_1.StepResolver(config);
         this.stepsController = new StepsController_1.StepsController(config.steps, (stepName) => this.refreshStep(stepName));
         this.steps = this.stepsController.handles;
-        this.exitController = new ExitController_1.ExitController({
+        const exitParams = {
             close: () => this.exit('dismissed'),
             onChange: () => this.publishStep(),
-        });
+        };
+        this.exitController = new ExitController_1.ExitController(exitParams, this.logger);
     }
     /**
      * Разрешена ли навигация сейчас: тур показан на экране и владеет активным
      * шагом store
      */
     canNavigate() {
-        return this.status === 'running' && this.activeStepStore.isActiveTour(this);
+        const isNavigable = this.status === 'running' && this.activeStepStore.isActiveTour(this);
+        if (!isNavigable) {
+            this.logger.debug('Навигация проигнорирована: тур неактивен');
+        }
+        return isNavigable;
     }
     /**
      * Переход к текущему шагу. Шаг с `waitForResume` ставит тур в ожидание
@@ -207,16 +221,23 @@ class OnboardingTour {
     enterCurrentStep() {
         // Показывать нечего: у тура нет ни одного видимого (не-пропущенного) шага.
         if (this.navigator.total === 0) {
+            this.logger.warn('Нет ни одного видимого шага, тур не показан');
             this.status = 'idle';
             this.releaseStep();
             return;
         }
         const step = this.navigator.current;
         if (step.waitForResume) {
+            this.logger.debug('Ожидание resume', { step: step.name });
             this.status = 'waiting-resume';
             this.releaseStep();
             return;
         }
+        this.logger.debug('Показан шаг', {
+            step: step.name,
+            position: this.navigator.position,
+            total: this.navigator.total,
+        });
         this.status = 'running';
         this.publishStep();
     }

package/node/components/Onboarding/core/ProgressStorage/ProgressStorage.d.ts

@@ -1,3 +1,4 @@
+import { type Logger } from '../../../../services/Logger';
 import { type SaveStrategy, type TourProgress } from '../../types';
 /**
  * Обёртка над переданной SaveStrategy, изолирующая тур от исключений хранилища
@@ -9,8 +10,9 @@ import { type SaveStrategy, type TourProgress } from '../../types';
  */
 export declare class ProgressStorage {
     private readonly strategy;
+    private readonly logger;
     private saving;
-    constructor(strategy: SaveStrategy);
+    constructor(strategy: SaveStrategy, logger: Logger);
     load(): Promise<TourProgress | null>;
     save(state: TourProgress): Promise<void>;
     /**

package/node/components/Onboarding/core/ProgressStorage/ProgressStorage.js

@@ -18,8 +18,9 @@ const CLEARED_STATE = {
  * `load()` ждёт текущее сохранение, поэтому читает уже применённое состояние.
  */
 class ProgressStorage {
-    constructor(strategy) {
+    constructor(strategy, logger) {
         this.strategy = strategy;
+        this.logger = logger;
         this.saving = Promise.resolve();
     }
     async load() {
@@ -28,7 +29,9 @@ class ProgressStorage {
         try {
             return await this.strategy.load();
         }
-        catch {
+        catch (error) {
+            // Ошибка хранилища не должна ронять тур, но остаётся видимой в логах.
+            this.logger.warn('Ошибка чтения прогресса из хранилища', error);
             return null;
         }
     }
@@ -52,8 +55,9 @@ class ProgressStorage {
             try {
                 await write();
             }
-            catch {
-                // Ошибка хранилища не должна ронять тур;
+            catch (error) {
+                // Ошибка хранилища не должна ронять тур, но остаётся видимой в логах.
+                this.logger.warn('Ошибка записи прогресса в хранилище', error);
             }
         });
         return this.saving;

package/node/services/Logger/Logger.d.ts

@@ -0,0 +1,45 @@
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export type LogThreshold = LogLevel | 'silent';
+export type LogContext = Readonly<Record<string, unknown>>;
+export type LoggerOptions = {
+    context?: LogContext;
+};
+export type CreateLoggerOptions = LoggerOptions & {
+    name: string;
+    level?: LogThreshold;
+};
+export type ConfigureOptions = {
+    level?: LogThreshold;
+};
+/**
+ * Логгер.
+ * Формат логов: `{пакет}: {иконка} [{scope}]: {сообщение}`.
+ * */
+export declare class Logger {
+    private readonly name;
+    private readonly scope;
+    private readonly context;
+    private readonly parent;
+    private level?;
+    private readonly console;
+    private constructor();
+    static create: ({ name, context, level, }: CreateLoggerOptions) => Logger;
+    /**
+     * Меняет уровень пакета.
+     * Без `level` — сброс к env-дефолту.
+     * Возвращает функцию отмены — вернёт прежний уровень.
+     * */
+    configure: (options?: ConfigureOptions) => () => void;
+    /** Дочерний логгер: добавляет `scope`, наследует уровень корня. */
+    child: (scope: string, options?: LoggerOptions) => Logger;
+    /** Дойдёт ли лог такого уровня до консоли. */
+    isLevelEnabled: (level: LogLevel) => boolean;
+    success: (message: string, ...data: unknown[]) => void;
+    info: (message: string, ...data: unknown[]) => void;
+    warn: (message: string, ...data: unknown[]) => void;
+    debug: (message: string, ...data: unknown[]) => void;
+    error: (message: string, ...data: unknown[]) => void;
+    /** Свой уровень → уровень родителя по цепочке → env-дефолт. */
+    private effectiveLevel;
+    private print;
+}

package/node/services/Logger/Logger.js

@@ -0,0 +1,72 @@
+"use strict";
+// biome-ignore-all lint/suspicious/noConsole: Logger — единственная точка вывода в консоль
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+/** Приоритет уровней. Лог виден, если его приоритет ≤ порога. */
+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}]: {сообщение}`.
+ * */
+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);
+        };
+    }
+}
+exports.Logger = Logger;
+Logger.create = ({ name, context = {}, level, }) => new Logger(name, undefined, { ...context }, null, level);

package/node/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/node/services/Logger/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureLogger = exports.createLogger = exports.Logger = void 0;
+const Logger_1 = require("./Logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+// Корневой логгер пакета @astral/ui.
+const uiLogger = Logger_1.Logger.create({ name: '@astral/ui' });
+/**
+ * Фабрика Logger для `@astral/ui`: сервисы и компоненты получают инстанс через DI.
+ */
+const createLogger = (scope, options) => uiLogger.child(scope, options);
+exports.createLogger = createLogger;
+/**
+ * (Пере)-Настройка логгера пакета `@astral/ui` — вызывает `ConfigProvider`.
+ */
+const configureLogger = (options) => uiLogger.configure(options);
+exports.configureLogger = configureLogger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/ui",
-  "version": "4.83.0",
+  "version": "4.84.0",
   "browser": "./index.js",
   "main": "./node/index.js",
   "dependencies": {

package/services/Logger/Logger.d.ts

@@ -0,0 +1,45 @@
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+export type LogThreshold = LogLevel | 'silent';
+export type LogContext = Readonly<Record<string, unknown>>;
+export type LoggerOptions = {
+    context?: LogContext;
+};
+export type CreateLoggerOptions = LoggerOptions & {
+    name: string;
+    level?: LogThreshold;
+};
+export type ConfigureOptions = {
+    level?: LogThreshold;
+};
+/**
+ * Логгер.
+ * Формат логов: `{пакет}: {иконка} [{scope}]: {сообщение}`.
+ * */
+export declare class Logger {
+    private readonly name;
+    private readonly scope;
+    private readonly context;
+    private readonly parent;
+    private level?;
+    private readonly console;
+    private constructor();
+    static create: ({ name, context, level, }: CreateLoggerOptions) => Logger;
+    /**
+     * Меняет уровень пакета.
+     * Без `level` — сброс к env-дефолту.
+     * Возвращает функцию отмены — вернёт прежний уровень.
+     * */
+    configure: (options?: ConfigureOptions) => () => void;
+    /** Дочерний логгер: добавляет `scope`, наследует уровень корня. */
+    child: (scope: string, options?: LoggerOptions) => Logger;
+    /** Дойдёт ли лог такого уровня до консоли. */
+    isLevelEnabled: (level: LogLevel) => boolean;
+    success: (message: string, ...data: unknown[]) => void;
+    info: (message: string, ...data: unknown[]) => void;
+    warn: (message: string, ...data: unknown[]) => void;
+    debug: (message: string, ...data: unknown[]) => void;
+    error: (message: string, ...data: unknown[]) => void;
+    /** Свой уровень → уровень родителя по цепочке → env-дефолт. */
+    private effectiveLevel;
+    private print;
+}

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);