@astral/ui 4.81.0 → 4.83.0

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

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForElement = void 0;
+const constants_1 = require("../../constants");
+const getTargetElement_1 = require("../getTargetElement");
+/**
+ * Дожидается появления элемента highlight-шага в DOM.
+ *
+ * Если элемент уже есть — синхронный resolve. При `timeout <= 0` ожидание
+ * отключено. Иначе подписывается через MutationObserver и resolve при появлении,
+ * либо reject по тайм-ауту.
+ */
+const waitForElement = (stepName, { timeout = constants_1.DEFAULT_WAIT_ELEMENT_TIMEOUT_MS, root = document, } = {}) => new Promise((resolve, reject) => {
+    const existing = (0, getTargetElement_1.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 = (0, getTargetElement_1.getTargetElement)(stepName, root);
+        if (element) {
+            cleanup();
+            resolve(element);
+        }
+    });
+    const cleanup = () => {
+        observer.disconnect();
+        clearTimeout(timer);
+    };
+    observer.observe(observeRoot, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: [constants_1.TOUR_ID_ATTR],
+    });
+    timer = setTimeout(() => {
+        cleanup();
+        reject(new Error(`Элемент шага "${stepName}" не найден за ${timeout}мс. Убедитесь, что на нём навешен data-tour-id через getHighlightProps().`));
+    }, timeout);
+});
+exports.waitForElement = waitForElement;

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

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

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnboardingConfigError = exports.validateTourConfig = void 0;
+var validateTourConfig_1 = require("./validateTourConfig");
+Object.defineProperty(exports, "validateTourConfig", { enumerable: true, get: function () { return validateTourConfig_1.validateTourConfig; } });
+Object.defineProperty(exports, "OnboardingConfigError", { enumerable: true, get: function () { return validateTourConfig_1.OnboardingConfigError; } });

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

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

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnboardingConfigError = exports.validateTourConfig = void 0;
+var validateTourConfig_1 = require("./validateTourConfig");
+Object.defineProperty(exports, "validateTourConfig", { enumerable: true, get: function () { return validateTourConfig_1.validateTourConfig; } });
+Object.defineProperty(exports, "OnboardingConfigError", { enumerable: true, get: function () { return validateTourConfig_1.OnboardingConfigError; } });

package/node/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/node/components/Onboarding/validation/validateTourConfig/validateTourConfig.js

@@ -0,0 +1,80 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTourConfig = exports.OnboardingConfigError = void 0;
+const v = __importStar(require("@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()),
+});
+/**
+ * Ошибка конфигурации тура
+ */
+class OnboardingConfigError extends Error {
+    constructor(errors) {
+        super(`Некорректная конфигурация тура:\n${JSON.stringify(errors, null, 2)}`);
+        this.name = 'OnboardingConfigError';
+    }
+}
+exports.OnboardingConfigError = OnboardingConfigError;
+/**
+ * Проверяет конфигурацию тура и бросает ошибку при нарушениях.
+ * Вызывается при создании тура (в `createTour`).
+ */
+const validateTourConfig = (config) => {
+    const errors = tourConfigSchema(config);
+    if (errors) {
+        throw new OnboardingConfigError(v.toPrettyError(errors));
+    }
+};
+exports.validateTourConfig = validateTourConfig;

package/node/components/TagsList/Tag/Tag.js

@@ -2,11 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tag = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const OverflowTypography_1 = require("../../OverflowTypography");
 const styles_1 = require("./styles");
 const useLogic_1 = require("./useLogic");
 const Tag = (props) => {
     const { onMouseDown } = (0, useLogic_1.useLogic)();
-    const { shrinks, isDisabled, ...restProps } = props;
-    return ((0, jsx_runtime_1.jsx)(styles_1.StyledTag, { "$shrinks": shrinks, color: "grey", variant: "light", disabled: isDisabled, ...restProps, onMouseDown: onMouseDown }));
+    const { shrinks, isDisabled, label, ...restProps } = props;
+    return ((0, jsx_runtime_1.jsx)(styles_1.StyledTag, { "$shrinks": shrinks, color: "grey", variant: "light", disabled: isDisabled, label: (0, jsx_runtime_1.jsx)(OverflowTypography_1.OverflowTypography, { children: label }), ...restProps, onMouseDown: onMouseDown }));
 };
 exports.Tag = Tag;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/ui",
-  "version": "4.81.0",
+  "version": "4.83.0",
   "browser": "./index.js",
   "main": "./node/index.js",
   "dependencies": {
@@ -24,7 +24,8 @@
     "remeda": "^1.61.0",
     "react-pdf": "9.2.1",
     "react-hook-form": "^7.66.1",
-    "focus-trap": "^7.8.0"
+    "focus-trap": "^7.8.0",
+    "use-sync-external-store": "^1.6.0"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0 || ^19.0.0",