@astral/ui 4.82.0 → 4.84.0

package/components/Onboarding/utils/geometry/overlayPath/overlayPath.js

@@ -0,0 +1,29 @@
+/**
+ * SVG-путь скруглённой области (по часовой стрелке).
+ */
+const roundedRectPath = (rect, radius) => {
+    const r = Math.max(0, Math.min(radius, rect.width / 2, rect.height / 2));
+    const { x, y, width, height } = rect;
+    return [
+        `M${x + r},${y}`,
+        `H${x + width - r}`,
+        `A${r},${r} 0 0 1 ${x + width},${y + r}`,
+        `V${y + height - r}`,
+        `A${r},${r} 0 0 1 ${x + width - r},${y + height}`,
+        `H${x + r}`,
+        `A${r},${r} 0 0 1 ${x},${y + height - r}`,
+        `V${y + r}`,
+        `A${r},${r} 0 0 1 ${x + r},${y}`,
+        'Z',
+    ].join(' ');
+};
+/**
+ * SVG-путь overlay: viewport + hole-отверстие.
+ */
+export const buildOverlayPath = (viewport, hole, radius) => {
+    const outer = `M0,0 H${viewport.width} V${viewport.height} H0 Z`;
+    if (!hole) {
+        return outer;
+    }
+    return `${outer} ${roundedRectPath(hole, radius)}`;
+};

package/components/Onboarding/utils/geometry/parseOffset/index.d.ts

@@ -0,0 +1 @@
+export { parseOffset } from './parseOffset';

package/components/Onboarding/utils/geometry/parseOffset/index.js

@@ -0,0 +1 @@
+export { parseOffset } from './parseOffset';

package/components/Onboarding/utils/geometry/parseOffset/parseOffset.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Парсит `highlightOffset` вида `'4px'` в число.
+ */
+export declare const parseOffset: (offset?: `${number}px`) => number;

package/components/Onboarding/utils/geometry/parseOffset/parseOffset.js

@@ -0,0 +1,5 @@
+import { DEFAULT_HIGHLIGHT_PADDING } from '../../../constants';
+/**
+ * Парсит `highlightOffset` вида `'4px'` в число.
+ */
+export const parseOffset = (offset) => offset ? Number.parseFloat(offset) : DEFAULT_HIGHLIGHT_PADDING;

package/components/Onboarding/utils/geometry/rect/index.d.ts

@@ -0,0 +1,2 @@
+export { clampToScrollParents, clampToViewport, inflateRect, isSameRect, rectFromDomRect, } from './rect';
+export type { Rect } from './rect';

package/components/Onboarding/utils/geometry/rect/index.js

@@ -0,0 +1 @@
+export { clampToScrollParents, clampToViewport, inflateRect, isSameRect, rectFromDomRect, } from './rect';

package/components/Onboarding/utils/geometry/rect/rect.d.ts

@@ -0,0 +1,34 @@
+import { type Viewport } from '../viewport';
+/**
+ * Область hole/элемента в координатах viewport.
+ */
+export type Rect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * Приводит нативный `DOMRect` к нашему `Rect` (только позиция и размеры).
+ */
+export declare const rectFromDomRect: (domRect: DOMRect) => Rect;
+/**
+ * Равны ли области покомпонентно.
+ */
+export declare const isSameRect: (a: Rect | null, b: Rect) => boolean;
+/**
+ * Расширяет область на padding во все стороны.
+ */
+export declare const inflateRect: (rect: Rect, padding: number) => Rect;
+/**
+ * Обрезает область hole по границам viewport.
+ */
+export declare const clampToViewport: (rect: Rect, viewport: Viewport) => Rect;
+export declare const isViewportSizedRect: (rect: Rect, viewport: Viewport) => boolean;
+/**
+ * Обрезает область элемента видимой областью каждого scroll-предка.
+ * Если элемент лежит во вложенном scroll-контейнере и частично уехал за его
+ * границу — и hole overlay, и якорь popover считаются уже по видимой
+ * части, а не по полной области элемента.
+ */
+export declare const clampToScrollParents: (rect: Rect, scrollParents: readonly Rect[], viewport: Viewport) => Rect;

package/components/Onboarding/utils/geometry/rect/rect.js

@@ -0,0 +1,60 @@
+/**
+ * Приводит нативный `DOMRect` к нашему `Rect` (только позиция и размеры).
+ */
+export const rectFromDomRect = (domRect) => ({
+    x: domRect.left,
+    y: domRect.top,
+    width: domRect.width,
+    height: domRect.height,
+});
+/**
+ * Равны ли области покомпонентно.
+ */
+export const isSameRect = (a, b) => a !== null &&
+    a.x === b.x &&
+    a.y === b.y &&
+    a.width === b.width &&
+    a.height === b.height;
+/**
+ * Расширяет область на padding во все стороны.
+ */
+export const inflateRect = (rect, padding) => ({
+    x: rect.x - padding,
+    y: rect.y - padding,
+    width: rect.width + padding * 2,
+    height: rect.height + padding * 2,
+});
+/**
+ * Пересечение двух областей. Не пересекаются — ширина/высота 0.
+ */
+const intersectRect = (a, b) => {
+    const x = Math.max(a.x, b.x);
+    const y = Math.max(a.y, b.y);
+    const right = Math.min(a.x + a.width, b.x + b.width);
+    const bottom = Math.min(a.y + a.height, b.y + b.height);
+    return {
+        x,
+        y,
+        width: Math.max(0, right - x),
+        height: Math.max(0, bottom - y),
+    };
+};
+/**
+ * Обрезает область hole по границам viewport.
+ */
+export const clampToViewport = (rect, viewport) => intersectRect(rect, {
+    x: 0,
+    y: 0,
+    width: viewport.width,
+    height: viewport.height,
+});
+export const isViewportSizedRect = (rect, viewport) => rect.width >= viewport.width - 1 && rect.height >= viewport.height - 1;
+/**
+ * Обрезает область элемента видимой областью каждого scroll-предка.
+ * Если элемент лежит во вложенном scroll-контейнере и частично уехал за его
+ * границу — и hole overlay, и якорь popover считаются уже по видимой
+ * части, а не по полной области элемента.
+ */
+export const clampToScrollParents = (rect, scrollParents, viewport) => scrollParents
+    .filter((parent) => !isViewportSizedRect(parent, viewport))
+    .reduce(intersectRect, rect);

package/components/Onboarding/utils/geometry/viewport/index.d.ts

@@ -0,0 +1,2 @@
+export { getViewport } from './viewport';
+export type { Viewport } from './viewport';

package/components/Onboarding/utils/geometry/viewport/index.js

@@ -0,0 +1 @@
+export { getViewport } from './viewport';

package/components/Onboarding/utils/geometry/viewport/viewport.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Размеры viewport.
+ */
+export type Viewport = {
+    width: number;
+    height: number;
+};
+/**
+ * Текущие размеры viewport.
+ *
+ * Именно `documentElement.clientWidth/Height`, а не `window.innerWidth/Height`:
+ * inner-размеры включают полосы прокрутки окна.
+ */
+export declare const getViewport: () => Viewport;

package/components/Onboarding/utils/geometry/viewport/viewport.js

@@ -0,0 +1,10 @@
+/**
+ * Текущие размеры viewport.
+ *
+ * Именно `documentElement.clientWidth/Height`, а не `window.innerWidth/Height`:
+ * inner-размеры включают полосы прокрутки окна.
+ */
+export const getViewport = () => ({
+    width: document.documentElement.clientWidth,
+    height: document.documentElement.clientHeight,
+});

package/components/Onboarding/utils/getScrollParents/getScrollParents.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Возвращает цепочку scroll-предков элемента (от ближайшего к корню).
+ *
+ * Нужна, чтобы прокручивать вложенные контейнеры и слушать их `scroll`
+ * для синхронизации hole overlay.
+ */
+export declare const getScrollParents: (element: Element | null) => HTMLElement[];

package/components/Onboarding/utils/getScrollParents/getScrollParents.js

@@ -0,0 +1,24 @@
+/**
+ * Является ли элемент scroll-контейнером.
+ */
+const isScrollable = (element) => {
+    const { overflow, overflowX, overflowY } = getComputedStyle(element);
+    return /(auto|scroll|overlay)/.test(`${overflow}${overflowX}${overflowY}`);
+};
+/**
+ * Возвращает цепочку scroll-предков элемента (от ближайшего к корню).
+ *
+ * Нужна, чтобы прокручивать вложенные контейнеры и слушать их `scroll`
+ * для синхронизации hole overlay.
+ */
+export const getScrollParents = (element) => {
+    const parents = [];
+    let node = element?.parentElement ?? null;
+    while (node && node !== document.body && node !== document.documentElement) {
+        if (isScrollable(node)) {
+            parents.push(node);
+        }
+        node = node.parentElement;
+    }
+    return parents;
+};

package/components/Onboarding/utils/getScrollParents/index.d.ts

@@ -0,0 +1 @@
+export { getScrollParents } from './getScrollParents';

package/components/Onboarding/utils/getScrollParents/index.js

@@ -0,0 +1 @@
+export { getScrollParents } from './getScrollParents';

package/components/Onboarding/utils/getTargetElement/getTargetElement.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Находит элемент highlight-шага по `[data-tour-id="<stepName>"]`.
+ */
+export declare const getTargetElement: (stepName: string, root?: ParentNode) => HTMLElement | null;

package/components/Onboarding/utils/getTargetElement/getTargetElement.js

@@ -0,0 +1,9 @@
+import { TOUR_ID_ATTR } from '../../constants';
+/**
+ * Экранирует значение для безопасной подстановки в CSS-селектор атрибута.
+ */
+const escapeAttrValue = (value) => value.replace(/["\\]/g, '\\$&');
+/**
+ * Находит элемент highlight-шага по `[data-tour-id="<stepName>"]`.
+ */
+export const getTargetElement = (stepName, root = document) => root.querySelector(`[${TOUR_ID_ATTR}="${escapeAttrValue(stepName)}"]`);

package/components/Onboarding/utils/getTargetElement/index.d.ts

@@ -0,0 +1 @@
+export { getTargetElement } from './getTargetElement';

package/components/Onboarding/utils/getTargetElement/index.js

@@ -0,0 +1 @@
+export { getTargetElement } from './getTargetElement';

package/components/Onboarding/utils/observeRemoval/index.d.ts

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

package/components/Onboarding/utils/observeRemoval/index.js

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

package/components/Onboarding/utils/observeRemoval/observeRemoval.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Следит за удалением элемента из DOM (размонтирование, условный render).
+ */
+export declare const observeRemoval: (element: HTMLElement, onRemoved: () => void) => VoidFunction;

package/components/Onboarding/utils/observeRemoval/observeRemoval.js

@@ -0,0 +1,13 @@
+/**
+ * Следит за удалением элемента из DOM (размонтирование, условный render).
+ */
+export const observeRemoval = (element, onRemoved) => {
+    const observer = new MutationObserver(() => {
+        if (!element.isConnected) {
+            observer.disconnect();
+            onRemoved();
+        }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    return () => observer.disconnect();
+};

package/components/Onboarding/utils/scrollIntoView/index.d.ts

@@ -0,0 +1 @@
+export { scrollIntoView } from './scrollIntoView';

package/components/Onboarding/utils/scrollIntoView/index.js

@@ -0,0 +1 @@
+export { scrollIntoView } from './scrollIntoView';

package/components/Onboarding/utils/scrollIntoView/scrollIntoView.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Доводит элемент highlight-шага до центра viewport и ждёт, пока прокрутка
+ * реально доедет.
+ *
+ * Зачем: цель может быть за пределами экрана или внутри прокрученного
+ * контейнера — её надо показать, прежде чем подсвечивать. Нативный
+ * `scrollIntoView` сам прокручивает всю цепочку вложенных scroll-контейнеров.
+ *
+ * Почему ждём: прокрутка плавная (анимированная), позиция элемента меняется
+ * кадр за кадром. Дожидаемся её стабилизации, чтобы hole overlay и popover встали
+ * по финальной позиции, а не по промежуточной «едущей».
+ */
+export declare const scrollIntoView: (element: HTMLElement, behavior?: ScrollBehavior) => Promise<void>;

package/components/Onboarding/utils/scrollIntoView/scrollIntoView.js

@@ -0,0 +1,85 @@
+import { SCROLL_BEHAVIOR } from '../../constants';
+import { getViewport } from '../geometry';
+import { getScrollParents } from '../getScrollParents';
+/**
+ * Сколько кадров подряд позиция не меняется, чтобы счесть прокрутку стабилизировавшейся.
+ */
+const STABLE_FRAMES = 3;
+/**
+ * Предохранитель: если позиция так и не стабилизировалась (постоянные
+ * layout-сдвиги), делаем resolve по тайм-ауту, чтобы Promise не завис и тур не застрял.
+ */
+const SETTLE_TIMEOUT_MS = 1000;
+/**
+ * Дожидается окончания плавной прокрутки.
+ *
+ * У браузера нет надёжного сигнала «плавная прокрутка доехала».
+ * Поэтому отслеживаем позицию элемента покадрово и считаем прокрутку
+ * законченной, когда `top` перестаёт меняться 3 кадра
+ * подряд — либо когда срабатывает предохранитель 1000мс.
+ */
+const waitForScrollSettle = (element) => new Promise((resolve) => {
+    let raf = 0;
+    let stableFrames = 0;
+    let prevTop = Number.NaN;
+    const timer = setTimeout(() => {
+        cancelAnimationFrame(raf);
+        resolve();
+    }, SETTLE_TIMEOUT_MS);
+    const tick = () => {
+        const { top } = element.getBoundingClientRect();
+        // Позиция не изменилась за кадр — копим «стабильные» кадры; дёрнулась —
+        // сбрасываем счётчик и запоминаем новую позицию.
+        if (top === prevTop) {
+            stableFrames += 1;
+        }
+        else {
+            stableFrames = 0;
+            prevTop = top;
+        }
+        // Достаточно кадров без движения → анимация закончилась.
+        if (stableFrames >= STABLE_FRAMES) {
+            clearTimeout(timer);
+            resolve();
+            return;
+        }
+        raf = requestAnimationFrame(tick);
+    };
+    raf = requestAnimationFrame(tick);
+});
+/**
+ * Элемент целиком видим: помещается и во viewport, и в рамки каждого своего
+ * scroll-предка.
+ */
+const isFullyVisible = (element) => {
+    const rect = element.getBoundingClientRect();
+    const { width, height } = getViewport();
+    const viewport = new DOMRect(0, 0, width, height);
+    const frames = [
+        viewport,
+        ...getScrollParents(element).map((parent) => parent.getBoundingClientRect()),
+    ];
+    return frames.every((frame) => rect.top >= frame.top &&
+        rect.left >= frame.left &&
+        rect.bottom <= frame.bottom &&
+        rect.right <= frame.right);
+};
+/**
+ * Доводит элемент highlight-шага до центра viewport и ждёт, пока прокрутка
+ * реально доедет.
+ *
+ * Зачем: цель может быть за пределами экрана или внутри прокрученного
+ * контейнера — её надо показать, прежде чем подсвечивать. Нативный
+ * `scrollIntoView` сам прокручивает всю цепочку вложенных scroll-контейнеров.
+ *
+ * Почему ждём: прокрутка плавная (анимированная), позиция элемента меняется
+ * кадр за кадром. Дожидаемся её стабилизации, чтобы hole overlay и popover встали
+ * по финальной позиции, а не по промежуточной «едущей».
+ */
+export const scrollIntoView = async (element, behavior = SCROLL_BEHAVIOR) => {
+    if (isFullyVisible(element)) {
+        return;
+    }
+    element.scrollIntoView({ behavior, block: 'center', inline: 'center' });
+    await waitForScrollSettle(element);
+};

package/components/Onboarding/utils/waitForElement/index.d.ts

@@ -0,0 +1,2 @@
+export { waitForElement } from './waitForElement';
+export type { WaitForElementOptions } from './waitForElement';

package/components/Onboarding/utils/waitForElement/index.js

@@ -0,0 +1 @@
+export { waitForElement } from './waitForElement';

package/components/Onboarding/utils/waitForElement/waitForElement.d.ts

@@ -0,0 +1,21 @@
+export type WaitForElementOptions = {
+    /**
+     * Тайм-аут ожидания, мс. `0` — не ждём: проверяем DOM синхронно и, если
+     * элемента нет, сразу делаем reject.
+     * @default 0
+     */
+    timeout?: number;
+    /**
+     * Корень для поиска и наблюдения за DOM.
+     * @default document
+     */
+    root?: Document | HTMLElement;
+};
+/**
+ * Дожидается появления элемента highlight-шага в DOM.
+ *
+ * Если элемент уже есть — синхронный resolve. При `timeout <= 0` ожидание
+ * отключено. Иначе подписывается через MutationObserver и resolve при появлении,
+ * либо reject по тайм-ауту.
+ */
+export declare const waitForElement: (stepName: string, { timeout, root, }?: WaitForElementOptions) => Promise<HTMLElement>;

package/components/Onboarding/utils/waitForElement/waitForElement.js

@@ -0,0 +1,45 @@
+import { DEFAULT_WAIT_ELEMENT_TIMEOUT_MS, TOUR_ID_ATTR } from '../../constants';
+import { getTargetElement } from '../getTargetElement';
+/**
+ * Дожидается появления элемента highlight-шага в DOM.
+ *
+ * Если элемент уже есть — синхронный resolve. При `timeout <= 0` ожидание
+ * отключено. Иначе подписывается через MutationObserver и resolve при появлении,
+ * либо reject по тайм-ауту.
+ */
+export const waitForElement = (stepName, { timeout = DEFAULT_WAIT_ELEMENT_TIMEOUT_MS, root = document, } = {}) => new Promise((resolve, reject) => {
+    const existing = getTargetElement(stepName, root);
+    if (existing) {
+        resolve(existing);
+        return;
+    }
+    // Ожидание отключено (по умолчанию): элемента в DOM нет — ждать нечего,
+    // делаем reject сразу, не подписываясь на мутации.
+    if (timeout <= 0) {
+        reject(new Error(`Элемент шага "${stepName}" не найден в DOM, а ожидание отключено (waitForTimeout=0). Навесьте data-tour-id через getHighlightProps() либо задайте waitForTimeout, если элемент появляется асинхронно.`));
+        return;
+    }
+    const observeRoot = root instanceof Document ? root.body : root;
+    let timer;
+    const observer = new MutationObserver(() => {
+        const element = getTargetElement(stepName, root);
+        if (element) {
+            cleanup();
+            resolve(element);
+        }
+    });
+    const cleanup = () => {
+        observer.disconnect();
+        clearTimeout(timer);
+    };
+    observer.observe(observeRoot, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: [TOUR_ID_ATTR],
+    });
+    timer = setTimeout(() => {
+        cleanup();
+        reject(new Error(`Элемент шага "${stepName}" не найден за ${timeout}мс. Убедитесь, что на нём навешен data-tour-id через getHighlightProps().`));
+    }, timeout);
+});

package/components/Onboarding/validation/index.d.ts

@@ -0,0 +1 @@
+export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';

package/components/Onboarding/validation/index.js

@@ -0,0 +1 @@
+export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';

package/components/Onboarding/validation/validateTourConfig/index.d.ts

@@ -0,0 +1 @@
+export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';

package/components/Onboarding/validation/validateTourConfig/index.js

@@ -0,0 +1 @@
+export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';

package/components/Onboarding/validation/validateTourConfig/validateTourConfig.d.ts

@@ -0,0 +1,12 @@
+import { type OnboardingTourConfig, type Step } from '../../types';
+/**
+ * Ошибка конфигурации тура
+ */
+export declare class OnboardingConfigError extends Error {
+    constructor(errors: unknown);
+}
+/**
+ * Проверяет конфигурацию тура и бросает ошибку при нарушениях.
+ * Вызывается при создании тура (в `createTour`).
+ */
+export declare const validateTourConfig: <TSteps extends readonly Step[]>(config: OnboardingTourConfig<TSteps>) => void;

package/components/Onboarding/validation/validateTourConfig/validateTourConfig.js

@@ -0,0 +1,52 @@
+import * as v from '@astral/validations';
+/**
+ * Имя шага в camelCase.
+ * Гарантирует доступ `tour.steps.stepName` и чистый `data-tour-id`.
+ */
+const CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
+/**
+ * Правило: имена шагов уникальны в рамках тура.
+ */
+const uniqueStepName = () => v.createRule((steps, ctx) => {
+    const seenNames = new Set();
+    for (const { name } of steps) {
+        if (seenNames.has(name)) {
+            return ctx.createError({
+                code: 'DUPLICATE_STEP_NAME',
+                message: `Имя шага «${name}» не уникально`,
+            });
+        }
+        seenNames.add(name);
+    }
+    return undefined;
+});
+/**
+ * Схема валидации конфигурации тура.
+ */
+const tourConfigSchema = v.object({
+    name: v.string(v.min(1)),
+    steps: v.array(v.min(1), v.arrayItem(v.object({
+        name: v.string(v.min(1), v.pattern(CAMEL_CASE, {
+            message: 'Имя шага должно быть в camelCase',
+        })),
+    })), uniqueStepName()),
+});
+/**
+ * Ошибка конфигурации тура
+ */
+export class OnboardingConfigError extends Error {
+    constructor(errors) {
+        super(`Некорректная конфигурация тура:\n${JSON.stringify(errors, null, 2)}`);
+        this.name = 'OnboardingConfigError';
+    }
+}
+/**
+ * Проверяет конфигурацию тура и бросает ошибку при нарушениях.
+ * Вызывается при создании тура (в `createTour`).
+ */
+export const validateTourConfig = (config) => {
+    const errors = tourConfigSchema(config);
+    if (errors) {
+        throw new OnboardingConfigError(v.toPrettyError(errors));
+    }
+};

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 {};