@hh.ru/magritte-ui-nav-bar 1.0.1

package/internal/utils.js

@@ -0,0 +1,359 @@
+import './../index.css';
+import { useRef, useLayoutEffect } from 'react';
+
+const lerp = (from, to, progress) => from + (to - from) * progress;
+const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
+/**
+ * Создаёт функцию преобразования значений из одного числового интервала (домен) в другой (образ).
+ *
+ * @param domain Интервал входных значений [min, max].
+ * @param image Интервал выходных значений [min, max].
+ *
+ * @returns Функция, принимающая число из диапазона `domain`, преобразующая его в диапазон `image`
+ *          с линейной интерполяцией.
+ */
+const remap = (domain, image) => {
+    const domainRange = domain[1] - domain[0];
+    const imageRange = image[1] - image[0];
+    const min = Math.min(...image);
+    const max = Math.max(...image);
+    if (domainRange === 0) {
+        return () => image[0];
+    }
+    const a = imageRange / domainRange;
+    const b = image[0] - a * domain[0];
+    return (value) => clamp(a * value + b, min, max);
+};
+const useInitOnce = (fn) => {
+    const ref = useRef(null);
+    if (ref.current === null) {
+        ref.current = fn();
+    }
+    return ref.current;
+};
+/**
+ * Возвращает «одноразовый» планировщик, который выполнит `fn` в следующем
+ * тике **микрозадач** (через `Promise.resolve().then(...)`). Повторные вызовы
+ * до момента выполнения схлопываются в один запуск.
+ *
+ * Семантика:
+ * - Первый вызов ставит `fn` в очередь микрозадач; последующие вызовы до
+ *   выполнения игнорируются.
+ * - После выполнения `fn` «засов» снимается — можно планировать снова.
+ * - Ошибки из `fn` перебрасываются в следующий макротик (через `setTimeout`),
+ *   чтобы они были видны в DevTools и не превращались в «unhandled rejection».
+ *
+ * Когда использовать:
+ * - Нужно объединить множество синхронных триггеров в одно действие,
+ *   выполнив его **раньше таймеров/`requestAnimationFrame`**.
+ * - Не требуется ожидать стабилизации DOM/лейаута (микрозадачи идут до кадра).
+ *
+ * @param fn — колбэк, который будет выполнен в следующем тике микрозадач.
+ * @returns Функция-триггер: вызов ставит `fn` в очередь 1 раз на тик микрозадач.
+ *
+ * @example
+ * const trigger = scheduleMicro(recompute);
+ * trigger(); // запланирован один запуск
+ * trigger(); // проигнорирован (уже запланировано)
+ * // `recompute` выполнится один раз на следующем тике микрозадач
+ */
+const scheduleMicro = (fn) => {
+    let scheduled = false;
+    return () => {
+        if (scheduled) {
+            return;
+        }
+        scheduled = true;
+        Promise.resolve()
+            .then(() => {
+            scheduled = false;
+            fn();
+        })
+            .catch((err) => setTimeout(() => {
+            throw err;
+        }, 0));
+    };
+};
+/**
+ * Возвращает «одноразовый» планировщик, который выполнит `fn` в следующем
+ * тике **макрозадач** (через `setTimeout(0)`). Повторные вызовы до момента
+ * выполнения схлопываются в один запуск.
+ *
+ * Семантика:
+ * - Первый вызов ставит `fn` в `setTimeout`; последующие вызовы до выполнения
+ *   игнорируются.
+ * - После выполнения `fn` «засов» снимается — можно планировать снова.
+ * - Ошибки из `fn` всплывут как непойманные ошибки из обработчика таймера.
+ *
+ * Когда использовать:
+ * - Нужно отложить выполнение **после** опустошения очереди микрозадач
+ *   (т.е. позже, чем `scheduleMicro`), часто позволяя браузеру между делом
+ *   подготовить кадр/перерисовку.
+ *
+ * @param fn — колбэк, который будет выполнен в следующем тике макрозадач.
+ * @returns Функция-триггер: вызов ставит `fn` в очередь 1 раз на тик таймера.
+ *
+ * @example
+ * const trigger = scheduleMacro(flushQueue);
+ * trigger(); // запланирован один таймер
+ * trigger(); // проигнорирован до выполнения `flushQueue`
+ */
+const scheduleMacro = (fn) => {
+    let scheduled = false;
+    const scheduledFn = () => {
+        if (scheduled) {
+            return;
+        }
+        scheduled = true;
+        setTimeout(() => {
+            scheduled = false;
+            fn();
+        });
+    };
+    return scheduledFn;
+};
+/**
+ * Планировщик для «сбора метрик» на основе микрозадач: откладывает выполнение `fn`
+ * до момента, когда серия частых вызовов завершится, и запускает `fn` ровно один раз.
+ *
+ * Идея:
+ * - Первый вызов добавляет «запас» из двух тиков микрозадач; каждый следующий
+ *   в ту же серию добавляет ещё +1.
+ * - Единый «дренирующий» цикл (один на серию) уменьшает счётчик на каждом тике
+ *   микрозадач; когда счётчик достигает нуля — выполняется `fn`.
+ * - Повторные вызовы не создают параллельных циклов; `fn` не вызывается несколько раз.
+ * - Ошибки из `fn` перебрасываются в макрозадачу (`setTimeout`), чтобы их было видно
+ *   в DevTools и они не становились unhandled rejection.
+ *
+ * Когда использовать:
+ * - Нужна коалесценция множественных триггеров (Promises, ResizeObserver и т.п.)
+ *   с запуском «после того, как всё успокоилось», чтобы измерить DOM/пересчитать
+ *   лейаут/агрегировать состояние один раз.
+ *
+ * Гарантии и нюансы:
+ * - Гарантируется минимум два тика микрозадач после первого вызова (даёт времени
+ *   промисам/микроочереди завершиться).
+ * - Работает как эвристика «дождаться затишья» на уровне микрозадач, без перехода
+ *   в макрозадачи/таймеры (сам `fn` всё равно выполняется в микрозадаче).
+ *
+ * @param fn — колбэк, который будет выполнен один раз после завершения серии вызовов.
+ * @returns Триггер; его можно вызывать многократно — `fn` запустится один раз,
+ *          когда внутренний счётчик дойдёт до нуля.
+ */
+const scheduleGatherMetrics = (fn) => {
+    let callsCount = 0;
+    let draining = false;
+    const step = () => Promise.resolve()
+        .then(() => {
+        if (callsCount > 0) {
+            callsCount -= 1;
+            if (callsCount > 0) {
+                void step();
+                return;
+            }
+            draining = false;
+            fn();
+            return;
+        }
+        draining = false;
+    })
+        .catch((err) => setTimeout(() => {
+        throw err;
+    }, 0));
+    return () => {
+        callsCount += callsCount === 0 ? 2 : 1;
+        if (!draining) {
+            draining = true;
+            void step();
+        }
+    };
+};
+/**
+ * Хук для получения "живой" ссылки (`ref`) на актуальное значение.
+ *
+ * В отличие от обычного `useRef(initialValue)`, где `.current` инициализируется
+ * только один раз и далее меняется вручную, `useActualRef` автоматически
+ * обновляет `.current` при каждом рендере на основе переданного `value`.
+ *
+ * Зачем это нужно:
+ * - Когда в коллбэках или подписках нужно иметь доступ к самому свежему значению
+ *   пропса или состояния, но при этом не хочется пересоздавать замыкания.
+ * - Позволяет избежать проблем со "старыми" значениями внутри `useCallback`,
+ *   `useEffect` и обработчиков событий.
+ *
+ * @param value Актуальное значение, которое должно быть доступно через `.current`.
+ *
+ * @returns `ref`-объект (`MutableRefObject<T>`), чьё свойство `.current` всегда
+ *          указывает на последнее переданное `value`.
+ */
+const useActualRef = (value) => {
+    const valueRef = useRef(value);
+    valueRef.current = value;
+    return valueRef;
+};
+/**
+ * Подписывает трансформацию на изменения исходного `MotionValue` **и** внешнего хранилища ключевых подписок.
+ *
+ * В отличие от `useTransform` из motion, этот хук не создает новый `MotionValue`.
+ * Вместо этого он вызывает пользовательскую `transformFn(arg, value)` при любом изменении:
+ *  - исходного `originalValue`, и/или
+ *  - значений во внешнем хранилище `store` по указанным `keys`.
+ *
+ * `transformFn` обычно внутри делает `.set(...)` у одного или нескольких целевых `MotionValue`.
+ *
+ * @template T Тип значения исходного `MotionValue`.
+ * @template K Тип ключей внешнего хранилища (строка | число | символ).
+ * @template V Тип агрегированного значения, извлекаемого из хранилища и передаваемого в `transformFn`.
+ *
+ * @param {MotionValue<T>} originalValue
+ * Исходный `MotionValue`, изменения которого инициируют трансформацию.
+ *
+ * @param {KeyedSubscriptions<K> | (() => KeyedSubscriptions<K>)} store
+ * Внешнее хранилище с подписками. Может быть самим объектом или фабрикой.
+ * Если передана функция, хук пересоздает подписки при событии `onDestroy`.
+ *
+ * @param {K[]} keys
+ * Набор ключей хранилища, на изменения которых нужно реагировать.
+ * Равенство `keys` проверяется по количеству и составу; изменение порядка не важно.
+ * Изменение этого набора вызывает пересоздание подписок подписок.
+ *
+ * @param {() => V} valueExtractor
+ * Функция, синхронно извлекающая/агрегирующая данные из хранилища
+ * для передачи первым аргументом в `transformFn`.
+ *
+ * @param {(arg: V, value: T) => void} transformFn
+ * Функция-трансформация. Вызывается при каждом триггере с
+ * `arg = valueExtractor()` и `value = originalValue.get()`. Обычно внутри вызывает `someMotionValue.set(...)`.
+ *
+ * @example
+ * ```tsx
+ * import { motion, useMotionValue } from "motion/react";
+ *
+ * const store: KeyedSubscriptions<"width" | "height"> = createKeyedStore();
+ *
+ * export function Example() {
+ *   const x = useMotionValue(0);          // исходный драйвер
+ *   const y = useMotionValue(0);          // целевой MotionValue
+ *
+ *   useStoreSyncedTransform(
+ *     x,
+ *     store,
+ *     ["width", "height"],
+ *     () => ({
+ *       w: store.get("width"),
+ *       h: store.get("height"),
+ *     }),
+ *     ({ w, h }, xVal) => {
+ *       // пример простой зависимости
+ *       const mapped = (xVal / Math.max(w, 1)) * h;
+ *       y.set(mapped);
+ *     }
+ *   );
+ *
+ *   return <motion.div style={{ x, y }} />;
+ * }
+ * ```
+ */
+const useStoreSyncedTransform = (originalValue, store, keys, valueExtractor, transformFn) => {
+    const valueExtractorRef = useActualRef(valueExtractor);
+    const extractedValueRef = useActualRef(valueExtractor());
+    const transformFnRef = useActualRef(transformFn);
+    const originalValueRef = useActualRef(originalValue);
+    const transform = useInitOnce(() => () => transformFnRef.current(extractedValueRef.current, originalValueRef.current.get()));
+    const observedKeysRef = useRef(null);
+    let observedKeys = observedKeysRef.current;
+    const isKeysChanged = observedKeys === null || keys.length !== observedKeys.size || keys.some((k) => !observedKeys?.has(k));
+    if (isKeysChanged) {
+        observedKeys = new Set(keys);
+        observedKeysRef.current = observedKeys;
+    }
+    useLayoutEffect(() => {
+        const unsubscribeStore = store.onChange(observedKeys ? [...observedKeys] : [], () => {
+            extractedValueRef.current = valueExtractorRef.current();
+            transform();
+        });
+        const unsubscribeValue = originalValue.on('change', transform);
+        return () => {
+            unsubscribeStore();
+            unsubscribeValue();
+        };
+    }, [store, observedKeys, originalValue, extractedValueRef, valueExtractorRef, transform]);
+    useLayoutEffect(() => {
+        transform();
+    }, [valueExtractor, extractedValueRef, transformFn, transform]);
+};
+const SCROLLABLE = ['auto', 'scroll'];
+const findScrollContainer = (element) => {
+    let parentElement = element.parentElement;
+    while (parentElement !== null) {
+        const { overflowY } = window.getComputedStyle(parentElement);
+        if (SCROLLABLE.includes(overflowY)) {
+            return { eventsProvider: parentElement, infoProvider: parentElement, mode: 'element' };
+        }
+        parentElement = parentElement.parentElement;
+    }
+    return {
+        eventsProvider: window,
+        infoProvider: document.scrollingElement || document.documentElement,
+        mode: 'window',
+    };
+};
+const isDOMRectsEqual = (a, b) => a === b || (a !== null && b !== null && a.x === b.x && a.y === b.y && a.height === b.height && a.width === b.width);
+const MAX_SCALE_RATIO = 2;
+const AXIS_SIZE_MULTIPLIER = {
+    left: 0,
+    center: 0.5,
+    right: 1,
+    top: 0,
+    bottom: 1,
+};
+const calcMorphParams = (start, end, sizeAxis, horizontalPositionAlign, verticalPositionAlign) => {
+    if (start === null || end === null) {
+        return {
+            deltaX: 0,
+            deltaY: 0,
+            scaleX: 1,
+            scaleY: 1,
+        };
+    }
+    let axis = sizeAxis;
+    let scaleX = end.width / start.width;
+    let scaleY = end.height / start.height;
+    if (sizeAxis === 'auto') {
+        const ratio = Math.max(scaleX, scaleY) / Math.min(scaleX, scaleY);
+        if (ratio > MAX_SCALE_RATIO) {
+            const absScaleX = scaleX < 1 ? 1 / scaleX : scaleX;
+            const absScaleY = scaleY < 1 ? 1 / scaleY : scaleY;
+            axis = absScaleX < absScaleY ? 'horizontal' : 'vertical';
+        }
+    }
+    scaleX = axis === 'vertical' ? scaleY : scaleX;
+    scaleY = axis === 'horizontal' ? scaleX : scaleY;
+    const startX = start.x + start.width * AXIS_SIZE_MULTIPLIER[horizontalPositionAlign];
+    const endX = end.x + end.width * AXIS_SIZE_MULTIPLIER[horizontalPositionAlign];
+    const startY = start.y + start.height * AXIS_SIZE_MULTIPLIER[verticalPositionAlign];
+    const endY = end.y + end.height * AXIS_SIZE_MULTIPLIER[verticalPositionAlign];
+    const deltaX = endX - startX;
+    const deltaY = endY - startY;
+    return {
+        deltaX,
+        deltaY,
+        scaleX,
+        scaleY,
+    };
+};
+const getRelativeOffset = (scrollAdapter, element) => {
+    if (!scrollAdapter.scrollContainer.current || !element) {
+        return 0;
+    }
+    const container = scrollAdapter.scrollContainer.current;
+    const containerTop = container === document.documentElement ? 0 : container.getBoundingClientRect().top;
+    const scroll = scrollAdapter.getScrollTop();
+    scrollAdapter.setScrollTop(0);
+    const elementTop = element.getBoundingClientRect().top;
+    scrollAdapter.setScrollTop(scroll);
+    return elementTop - containerTop;
+};
+
+export { calcMorphParams, clamp, findScrollContainer, getRelativeOffset, isDOMRectsEqual, lerp, remap, scheduleGatherMetrics, scheduleMacro, scheduleMicro, useActualRef, useInitOnce, useStoreSyncedTransform };
+//# sourceMappingURL=utils.js.map

package/internal/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../src/internal/utils.ts"],"sourcesContent":["import { type MutableRefObject, useLayoutEffect, useRef } from 'react';\nimport type { MotionValue } from 'motion';\n\nimport { KeyedSubscriptions } from '@hh.ru/magritte-ui-nav-bar/internal/KeyedSubscriptions';\nimport { ScrollAdapter } from '@hh.ru/magritte-ui-nav-bar/internal/useScrollAdapter';\n\nexport const lerp = (from: number, to: number, progress: number): number => from + (to - from) * progress;\nexport const clamp = (value: number, min: number, max: number): number => Math.min(max, Math.max(min, value));\n\n/**\n * Создаёт функцию преобразования значений из одного числового интервала (домен) в другой (образ).\n *\n * @param domain Интервал входных значений [min, max].\n * @param image Интервал выходных значений [min, max].\n *\n * @returns Функция, принимающая число из диапазона `domain`, преобразующая его в диапазон `image`\n *          с линейной интерполяцией.\n */\nexport const remap = (domain: [number, number], image: [number, number]) => {\n    const domainRange = domain[1] - domain[0];\n    const imageRange = image[1] - image[0];\n    const min = Math.min(...image);\n    const max = Math.max(...image);\n\n    if (domainRange === 0) {\n        return () => image[0];\n    }\n\n    const a = imageRange / domainRange;\n    const b = image[0] - a * domain[0];\n\n    return (value: number): number => clamp(a * value + b, min, max);\n};\n\nexport const useInitOnce = <T>(fn: () => T): T => {\n    const ref = useRef<T | null>(null);\n    if (ref.current === null) {\n        ref.current = fn();\n    }\n    return ref.current;\n};\n\n/**\n * Возвращает «одноразовый» планировщик, который выполнит `fn` в следующем\n * тике **микрозадач** (через `Promise.resolve().then(...)`). Повторные вызовы\n * до момента выполнения схлопываются в один запуск.\n *\n * Семантика:\n * - Первый вызов ставит `fn` в очередь микрозадач; последующие вызовы до\n *   выполнения игнорируются.\n * - После выполнения `fn` «засов» снимается — можно планировать снова.\n * - Ошибки из `fn` перебрасываются в следующий макротик (через `setTimeout`),\n *   чтобы они были видны в DevTools и не превращались в «unhandled rejection».\n *\n * Когда использовать:\n * - Нужно объединить множество синхронных триггеров в одно действие,\n *   выполнив его **раньше таймеров/`requestAnimationFrame`**.\n * - Не требуется ожидать стабилизации DOM/лейаута (микрозадачи идут до кадра).\n *\n * @param fn — колбэк, который будет выполнен в следующем тике микрозадач.\n * @returns Функция-триггер: вызов ставит `fn` в очередь 1 раз на тик микрозадач.\n *\n * @example\n * const trigger = scheduleMicro(recompute);\n * trigger(); // запланирован один запуск\n * trigger(); // проигнорирован (уже запланировано)\n * // `recompute` выполнится один раз на следующем тике микрозадач\n */\nexport const scheduleMicro = (fn: VoidFunction) => {\n    let scheduled = false;\n    return (): void => {\n        if (scheduled) {\n            return;\n        }\n        scheduled = true;\n        Promise.resolve()\n            .then(() => {\n                scheduled = false;\n                fn();\n            })\n            .catch((err) =>\n                setTimeout(() => {\n                    throw err;\n                }, 0)\n            );\n    };\n};\n\n/**\n * Возвращает «одноразовый» планировщик, который выполнит `fn` в следующем\n * тике **макрозадач** (через `setTimeout(0)`). Повторные вызовы до момента\n * выполнения схлопываются в один запуск.\n *\n * Семантика:\n * - Первый вызов ставит `fn` в `setTimeout`; последующие вызовы до выполнения\n *   игнорируются.\n * - После выполнения `fn` «засов» снимается — можно планировать снова.\n * - Ошибки из `fn` всплывут как непойманные ошибки из обработчика таймера.\n *\n * Когда использовать:\n * - Нужно отложить выполнение **после** опустошения очереди микрозадач\n *   (т.е. позже, чем `scheduleMicro`), часто позволяя браузеру между делом\n *   подготовить кадр/перерисовку.\n *\n * @param fn — колбэк, который будет выполнен в следующем тике макрозадач.\n * @returns Функция-триггер: вызов ставит `fn` в очередь 1 раз на тик таймера.\n *\n * @example\n * const trigger = scheduleMacro(flushQueue);\n * trigger(); // запланирован один таймер\n * trigger(); // проигнорирован до выполнения `flushQueue`\n */\nexport const scheduleMacro = (fn: VoidFunction): VoidFunction => {\n    let scheduled = false;\n    const scheduledFn = () => {\n        if (scheduled) {\n            return;\n        }\n        scheduled = true;\n        setTimeout(() => {\n            scheduled = false;\n            fn();\n        });\n    };\n    return scheduledFn;\n};\n\n/**\n * Планировщик для «сбора метрик» на основе микрозадач: откладывает выполнение `fn`\n * до момента, когда серия частых вызовов завершится, и запускает `fn` ровно один раз.\n *\n * Идея:\n * - Первый вызов добавляет «запас» из двух тиков микрозадач; каждый следующий\n *   в ту же серию добавляет ещё +1.\n * - Единый «дренирующий» цикл (один на серию) уменьшает счётчик на каждом тике\n *   микрозадач; когда счётчик достигает нуля — выполняется `fn`.\n * - Повторные вызовы не создают параллельных циклов; `fn` не вызывается несколько раз.\n * - Ошибки из `fn` перебрасываются в макрозадачу (`setTimeout`), чтобы их было видно\n *   в DevTools и они не становились unhandled rejection.\n *\n * Когда использовать:\n * - Нужна коалесценция множественных триггеров (Promises, ResizeObserver и т.п.)\n *   с запуском «после того, как всё успокоилось», чтобы измерить DOM/пересчитать\n *   лейаут/агрегировать состояние один раз.\n *\n * Гарантии и нюансы:\n * - Гарантируется минимум два тика микрозадач после первого вызова (даёт времени\n *   промисам/микроочереди завершиться).\n * - Работает как эвристика «дождаться затишья» на уровне микрозадач, без перехода\n *   в макрозадачи/таймеры (сам `fn` всё равно выполняется в микрозадаче).\n *\n * @param fn — колбэк, который будет выполнен один раз после завершения серии вызовов.\n * @returns Триггер; его можно вызывать многократно — `fn` запустится один раз,\n *          когда внутренний счётчик дойдёт до нуля.\n */\nexport const scheduleGatherMetrics = (fn: VoidFunction): VoidFunction => {\n    let callsCount = 0;\n    let draining = false;\n\n    const step = () =>\n        Promise.resolve()\n            .then(() => {\n                if (callsCount > 0) {\n                    callsCount -= 1;\n                    if (callsCount > 0) {\n                        void step();\n                        return;\n                    }\n                    draining = false;\n                    fn();\n                    return;\n                }\n                draining = false;\n            })\n            .catch((err) =>\n                setTimeout(() => {\n                    throw err;\n                }, 0)\n            );\n\n    return () => {\n        callsCount += callsCount === 0 ? 2 : 1;\n        if (!draining) {\n            draining = true;\n            void step();\n        }\n    };\n};\n\n/**\n * Хук для получения \"живой\" ссылки (`ref`) на актуальное значение.\n *\n * В отличие от обычного `useRef(initialValue)`, где `.current` инициализируется\n * только один раз и далее меняется вручную, `useActualRef` автоматически\n * обновляет `.current` при каждом рендере на основе переданного `value`.\n *\n * Зачем это нужно:\n * - Когда в коллбэках или подписках нужно иметь доступ к самому свежему значению\n *   пропса или состояния, но при этом не хочется пересоздавать замыкания.\n * - Позволяет избежать проблем со \"старыми\" значениями внутри `useCallback`,\n *   `useEffect` и обработчиков событий.\n *\n * @param value Актуальное значение, которое должно быть доступно через `.current`.\n *\n * @returns `ref`-объект (`MutableRefObject<T>`), чьё свойство `.current` всегда\n *          указывает на последнее переданное `value`.\n */\nexport const useActualRef = <T>(value: T): MutableRefObject<T> => {\n    const valueRef = useRef(value);\n    valueRef.current = value;\n    return valueRef;\n};\n\n/**\n * Подписывает трансформацию на изменения исходного `MotionValue` **и** внешнего хранилища ключевых подписок.\n *\n * В отличие от `useTransform` из motion, этот хук не создает новый `MotionValue`.\n * Вместо этого он вызывает пользовательскую `transformFn(arg, value)` при любом изменении:\n *  - исходного `originalValue`, и/или\n *  - значений во внешнем хранилище `store` по указанным `keys`.\n *\n * `transformFn` обычно внутри делает `.set(...)` у одного или нескольких целевых `MotionValue`.\n *\n * @template T Тип значения исходного `MotionValue`.\n * @template K Тип ключей внешнего хранилища (строка | число | символ).\n * @template V Тип агрегированного значения, извлекаемого из хранилища и передаваемого в `transformFn`.\n *\n * @param {MotionValue<T>} originalValue\n * Исходный `MotionValue`, изменения которого инициируют трансформацию.\n *\n * @param {KeyedSubscriptions<K> | (() => KeyedSubscriptions<K>)} store\n * Внешнее хранилище с подписками. Может быть самим объектом или фабрикой.\n * Если передана функция, хук пересоздает подписки при событии `onDestroy`.\n *\n * @param {K[]} keys\n * Набор ключей хранилища, на изменения которых нужно реагировать.\n * Равенство `keys` проверяется по количеству и составу; изменение порядка не важно.\n * Изменение этого набора вызывает пересоздание подписок подписок.\n *\n * @param {() => V} valueExtractor\n * Функция, синхронно извлекающая/агрегирующая данные из хранилища\n * для передачи первым аргументом в `transformFn`.\n *\n * @param {(arg: V, value: T) => void} transformFn\n * Функция-трансформация. Вызывается при каждом триггере с\n * `arg = valueExtractor()` и `value = originalValue.get()`. Обычно внутри вызывает `someMotionValue.set(...)`.\n *\n * @example\n * ```tsx\n * import { motion, useMotionValue } from \"motion/react\";\n *\n * const store: KeyedSubscriptions<\"width\" | \"height\"> = createKeyedStore();\n *\n * export function Example() {\n *   const x = useMotionValue(0);          // исходный драйвер\n *   const y = useMotionValue(0);          // целевой MotionValue\n *\n *   useStoreSyncedTransform(\n *     x,\n *     store,\n *     [\"width\", \"height\"],\n *     () => ({\n *       w: store.get(\"width\"),\n *       h: store.get(\"height\"),\n *     }),\n *     ({ w, h }, xVal) => {\n *       // пример простой зависимости\n *       const mapped = (xVal / Math.max(w, 1)) * h;\n *       y.set(mapped);\n *     }\n *   );\n *\n *   return <motion.div style={{ x, y }} />;\n * }\n * ```\n */\nexport const useStoreSyncedTransform = <T, K extends PropertyKey, V>(\n    originalValue: MotionValue<T>,\n    store: KeyedSubscriptions<K>,\n    keys: K[],\n    valueExtractor: () => V,\n    transformFn: (arg: V, value: T) => void\n): void => {\n    const valueExtractorRef = useActualRef(valueExtractor);\n    const extractedValueRef = useActualRef(valueExtractor());\n    const transformFnRef = useActualRef(transformFn);\n    const originalValueRef = useActualRef(originalValue);\n    const transform = useInitOnce(\n        () => () => transformFnRef.current(extractedValueRef.current, originalValueRef.current.get())\n    );\n\n    const observedKeysRef = useRef<Set<K> | null>(null);\n    let observedKeys = observedKeysRef.current;\n    const isKeysChanged =\n        observedKeys === null || keys.length !== observedKeys.size || keys.some((k) => !observedKeys?.has(k));\n\n    if (isKeysChanged) {\n        observedKeys = new Set(keys);\n        observedKeysRef.current = observedKeys;\n    }\n\n    useLayoutEffect(() => {\n        const unsubscribeStore = store.onChange(observedKeys ? [...observedKeys] : [], () => {\n            extractedValueRef.current = valueExtractorRef.current();\n            transform();\n        });\n        const unsubscribeValue = originalValue.on('change', transform);\n\n        return () => {\n            unsubscribeStore();\n            unsubscribeValue();\n        };\n    }, [store, observedKeys, originalValue, extractedValueRef, valueExtractorRef, transform]);\n\n    useLayoutEffect(() => {\n        transform();\n    }, [valueExtractor, extractedValueRef, transformFn, transform]);\n};\n\nconst SCROLLABLE = ['auto', 'scroll'];\nexport const findScrollContainer = (\n    element: HTMLElement\n):\n    | { eventsProvider: HTMLElement; infoProvider: HTMLElement; mode: 'element' }\n    | { eventsProvider: Window; infoProvider: Element; mode: 'window' } => {\n    let parentElement = element.parentElement;\n    while (parentElement !== null) {\n        const { overflowY } = window.getComputedStyle(parentElement);\n        if (SCROLLABLE.includes(overflowY)) {\n            return { eventsProvider: parentElement, infoProvider: parentElement, mode: 'element' };\n        }\n        parentElement = parentElement.parentElement;\n    }\n\n    return {\n        eventsProvider: window,\n        infoProvider: document.scrollingElement || document.documentElement,\n        mode: 'window',\n    };\n};\n\nexport const isDOMRectsEqual = (a: DOMRectReadOnly | null, b: DOMRectReadOnly | null): boolean =>\n    a === b || (a !== null && b !== null && a.x === b.x && a.y === b.y && a.height === b.height && a.width === b.width);\n\nexport interface MorphSetup {\n    start: DOMRectReadOnly;\n    end: DOMRectReadOnly;\n    containerStart: DOMRectReadOnly;\n    containerEnd: DOMRectReadOnly;\n}\n\nexport type SizeAxis = 'vertical' | 'horizontal' | 'both' | 'auto';\nexport type HorizontalAlign = 'left' | 'right' | 'center';\nexport type VerticalAlign = 'top' | 'bottom' | 'center';\n\nconst MAX_SCALE_RATIO = 2;\nconst AXIS_SIZE_MULTIPLIER = {\n    left: 0,\n    center: 0.5,\n    right: 1,\n    top: 0,\n    bottom: 1,\n} as const;\n\nexport const calcMorphParams = (\n    start: DOMRectReadOnly | null,\n    end: DOMRectReadOnly | null,\n    sizeAxis: SizeAxis,\n    horizontalPositionAlign: HorizontalAlign,\n    verticalPositionAlign: VerticalAlign\n): { deltaX: number; deltaY: number; scaleX: number; scaleY: number } => {\n    if (start === null || end === null) {\n        return {\n            deltaX: 0,\n            deltaY: 0,\n            scaleX: 1,\n            scaleY: 1,\n        };\n    }\n\n    let axis = sizeAxis;\n    let scaleX = end.width / start.width;\n    let scaleY = end.height / start.height;\n\n    if (sizeAxis === 'auto') {\n        const ratio = Math.max(scaleX, scaleY) / Math.min(scaleX, scaleY);\n        if (ratio > MAX_SCALE_RATIO) {\n            const absScaleX = scaleX < 1 ? 1 / scaleX : scaleX;\n            const absScaleY = scaleY < 1 ? 1 / scaleY : scaleY;\n            axis = absScaleX < absScaleY ? 'horizontal' : 'vertical';\n        }\n    }\n\n    scaleX = axis === 'vertical' ? scaleY : scaleX;\n    scaleY = axis === 'horizontal' ? scaleX : scaleY;\n\n    const startX = start.x + start.width * AXIS_SIZE_MULTIPLIER[horizontalPositionAlign];\n    const endX = end.x + end.width * AXIS_SIZE_MULTIPLIER[horizontalPositionAlign];\n    const startY = start.y + start.height * AXIS_SIZE_MULTIPLIER[verticalPositionAlign];\n    const endY = end.y + end.height * AXIS_SIZE_MULTIPLIER[verticalPositionAlign];\n\n    const deltaX = endX - startX;\n    const deltaY = endY - startY;\n\n    return {\n        deltaX,\n        deltaY,\n        scaleX,\n        scaleY,\n    };\n};\n\nexport const getRelativeOffset = (scrollAdapter: ScrollAdapter, element: HTMLElement | null): number => {\n    if (!scrollAdapter.scrollContainer.current || !element) {\n        return 0;\n    }\n\n    const container = scrollAdapter.scrollContainer.current;\n    const containerTop = container === document.documentElement ? 0 : container.getBoundingClientRect().top;\n    const scroll = scrollAdapter.getScrollTop();\n    scrollAdapter.setScrollTop(0);\n    const elementTop = element.getBoundingClientRect().top;\n    scrollAdapter.setScrollTop(scroll);\n\n    return elementTop - containerTop;\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@hh.ru/magritte-ui-nav-bar",
+  "version": "1.0.1",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "sideEffects": [
+    "index.css"
+  ],
+  "scripts": {
+    "build": "yarn root:build $(pwd)",
+    "build-test-branch": "yarn root:build-test-branch $(pwd)",
+    "prepack": "yarn root:prepack $(pwd)",
+    "postpublish": "yarn root:postpublish $(pwd)",
+    "stylelint-check": "yarn root:stylelint-check $(pwd)",
+    "eslint-check": "yarn root:eslint-check $(pwd)",
+    "ts-config": "yarn root:ts-config $(pwd)",
+    "ts-check": "yarn root:ts-check $(pwd)",
+    "test": "yarn root:test $(pwd)",
+    "watch": "yarn root:watch $(pwd)"
+  },
+  "peerDependencies": {
+    "classnames": ">=2.3.2",
+    "motion": "^12.23.12",
+    "react": ">=18.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@hh.ru/magritte-common-use-when-font-loaded": "1.0.12",
+    "@hh.ru/magritte-design-tokens": "23.2.2",
+    "@hh.ru/magritte-internal-custom-scroll": "2.0.0",
+    "@hh.ru/magritte-ui-divider": "3.0.6",
+    "@hh.ru/magritte-ui-icon": "13.1.0",
+    "@hh.ru/magritte-ui-layer": "3.0.4"
+  },
+  "gitHead": "b01f070fc5e24a45a987ba451165c2f90733a37e"
+}

package/public/Actions.d.ts

@@ -0,0 +1,26 @@
+import { type PropsWithChildren, type FC, type ReactNode } from 'react';
+export interface ActionsProps {
+    /**
+     * Контент левого слота
+     */
+    left?: ReactNode | ReactNode[];
+    /**
+     * Контент правого слота
+     */
+    right?: ReactNode | ReactNode[];
+    /**
+     * Контент центрального слота
+     */
+    children?: ReactNode;
+    /**
+     * Включает центрирование контента центрального слота относительно всего компонента.
+     */
+    centered?: boolean;
+    /**
+     * Управляет автоматическим оборачиванием всего контента в компоненты <Morph />.
+     * По умолчанию включен, но может быть отключен если требуется более сложное описание анимации
+     * чем используется по умолчанию.
+     */
+    autoMorph?: boolean;
+}
+export declare const Actions: FC<PropsWithChildren<ActionsProps>>;

package/public/Actions.js

@@ -0,0 +1,47 @@
+import './../index.css';
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { isValidElement, Fragment, Children } from 'react';
+import classNames from 'classnames';
+import { isIconElement } from '@hh.ru/magritte-ui-icon';
+import { EnvironmentFingerprintNode } from './EnvironmentFingerprintNode.js';
+import { Morph } from './Morph.js';
+import { useAnimationStage } from './Stage.js';
+import { s as styles } from '../NavBar-CrD8CEWb.js';
+import '../internal/MetricsProvider.js';
+import '../internal/utils.js';
+import 'motion/react';
+import '../internal/MorphStore.js';
+import '../internal/KeyedSubscriptions.js';
+import '../internal/PaneStore.js';
+import 'motion';
+import '@hh.ru/magritte-ui-divider';
+import '@hh.ru/magritte-ui-layer';
+import '../internal/ProgressiveBlur.js';
+import '../internal/useAnimationRanges.js';
+import '../internal/useBindScrollToAnimationProgress.js';
+import '../internal/useDivider.js';
+import '../internal/useNavBarMetrics.js';
+import '../internal/useResetFocus.js';
+import '../internal/useScrollAdapter.js';
+import '@hh.ru/magritte-internal-custom-scroll';
+import '../internal/useSnapScroll.js';
+import '../internal/useSyncMotionValue.js';
+
+const wrapToMorph = (node, isRight) => {
+    const arr = isValidElement(node) && node.type === Fragment
+        ? Children.toArray(node.props.children)
+        : Children.toArray(node);
+    return arr.map((node, index) => (jsx(Morph, { className: isIconElement(node) ? styles.actionsIconMorph : '', id: `actions-component-${isRight ? 'right' : 'left'}-slot-item-${isRight ? arr.length - index : index}`, children: node }, index)));
+};
+const Actions = ({ children, left, right, centered = false, autoMorph = true, }) => {
+    const stage = useAnimationStage();
+    return (jsxs("div", { className: classNames(styles.actionsContainer, {
+            [styles.actionsStartStage]: stage === 'start',
+            [styles.actionsEndStage]: stage === 'end',
+            [styles.actionsOnlyStage]: stage === 'only',
+            [styles.actionsNoChildren]: !children,
+        }), children: [!!left && (jsxs("div", { className: styles.actionsLeftSlot, children: [jsx(EnvironmentFingerprintNode, { className: styles.actionsSideSlotContent, children: autoMorph && stage !== 'only' ? wrapToMorph(left, false) : left }), centered && (jsx("div", { className: styles.actionsSideSlotContentClone, "aria-hidden": "true", children: right }))] })), (!!children || !left || !right) && (jsx("div", { className: classNames(styles.actionsCenterSlot, { [styles.actionsCenterSlotCentered]: centered }), children: children })), !!right && (jsxs("div", { className: styles.actionsRightSlot, children: [jsx(EnvironmentFingerprintNode, { className: styles.actionsSideSlotContent, children: autoMorph && stage !== 'only' ? wrapToMorph(right, true) : right }), centered && (jsx("div", { className: styles.actionsSideSlotContentClone, "aria-hidden": "true", children: left }))] }))] }));
+};
+
+export { Actions };
+//# sourceMappingURL=Actions.js.map

package/public/Actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actions.js","sources":["../../src/public/Actions.tsx"],"sourcesContent":["import {\n    Children,\n    Fragment,\n    isValidElement,\n    type JSXElementConstructor,\n    type PropsWithChildren,\n    type ReactElement,\n    type FC,\n    type ReactNode,\n} from 'react';\nimport classNames from 'classnames';\n\nimport { isIconElement } from '@hh.ru/magritte-ui-icon';\nimport { EnvironmentFingerprintNode } from '@hh.ru/magritte-ui-nav-bar/public/EnvironmentFingerprintNode';\nimport { Morph } from '@hh.ru/magritte-ui-nav-bar/public/Morph';\nimport { useAnimationStage } from '@hh.ru/magritte-ui-nav-bar/public/Stage';\n\nimport styles from './nav-bar.less';\n\nexport interface ActionsProps {\n    /**\n     * Контент левого слота\n     */\n    left?: ReactNode | ReactNode[];\n    /**\n     * Контент правого слота\n     */\n    right?: ReactNode | ReactNode[];\n    /**\n     * Контент центрального слота\n     */\n    children?: ReactNode;\n    /**\n     * Включает центрирование контента центрального слота относительно всего компонента.\n     */\n    centered?: boolean;\n    /**\n     * Управляет автоматическим оборачиванием всего контента в компоненты <Morph />.\n     * По умолчанию включен, но может быть отключен если требуется более сложное описание анимации\n     * чем используется по умолчанию.\n     */\n    autoMorph?: boolean;\n}\n\nconst wrapToMorph = (node: ReactNode | ReactNode[], isRight: boolean) => {\n    const arr =\n        isValidElement(node) && node.type === Fragment\n            ? Children.toArray(\n                  (node as ReactElement<PropsWithChildren, JSXElementConstructor<PropsWithChildren>>).props.children\n              )\n            : Children.toArray(node);\n\n    return arr.map((node, index) => (\n        <Morph\n            className={isIconElement(node) ? styles.actionsIconMorph : ''}\n            id={`actions-component-${isRight ? 'right' : 'left'}-slot-item-${isRight ? arr.length - index : index}`}\n            key={index}\n        >\n            {node}\n        </Morph>\n    ));\n};\n\nexport const Actions: FC<PropsWithChildren<ActionsProps>> = ({\n    children,\n    left,\n    right,\n    centered = false,\n    autoMorph = true,\n}) => {\n    const stage = useAnimationStage();\n    return (\n        <div\n            className={classNames(styles.actionsContainer, {\n                [styles.actionsStartStage]: stage === 'start',\n                [styles.actionsEndStage]: stage === 'end',\n                [styles.actionsOnlyStage]: stage === 'only',\n                [styles.actionsNoChildren]: !children,\n            })}\n        >\n            {!!left && (\n                <div className={styles.actionsLeftSlot}>\n                    <EnvironmentFingerprintNode className={styles.actionsSideSlotContent}>\n                        {autoMorph && stage !== 'only' ? wrapToMorph(left, false) : left}\n                    </EnvironmentFingerprintNode>\n                    {centered && (\n                        <div className={styles.actionsSideSlotContentClone} aria-hidden=\"true\">\n                            {right}\n                        </div>\n                    )}\n                </div>\n            )}\n\n            {(!!children || !left || !right) && (\n                <div className={classNames(styles.actionsCenterSlot, { [styles.actionsCenterSlotCentered]: centered })}>\n                    {children}\n                </div>\n            )}\n\n            {!!right && (\n                <div className={styles.actionsRightSlot}>\n                    <EnvironmentFingerprintNode className={styles.actionsSideSlotContent}>\n                        {autoMorph && stage !== 'only' ? wrapToMorph(right, true) : right}\n                    </EnvironmentFingerprintNode>\n                    {centered && (\n                        <div className={styles.actionsSideSlotContentClone} aria-hidden=\"true\">\n                            {left}\n                        </div>\n                    )}\n                </div>\n            )}\n        </div>\n    );\n};\n"],"names":["_jsx","_jsxs"],"mappings":"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"}

package/public/EnvironmentFingerprintNode.d.ts

@@ -0,0 +1,7 @@
+import { type HTMLAttributes, type PropsWithChildren, type FC } from 'react';
+export type EnvironmentFingerprintNodeProps = PropsWithChildren<HTMLAttributes<HTMLDivElement>>;
+export declare const EnvironmentFingerprintNode: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    children?: import("react").ReactNode | undefined;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export declare const EnvironmentFingerprintProvider: FC<PropsWithChildren>;
+export declare const useEnvironmentFingerprint: (onChange: VoidFunction) => void;

package/public/EnvironmentFingerprintNode.js

@@ -0,0 +1,70 @@
+import './../index.css';
+import { jsx } from 'react/jsx-runtime';
+import { createContext, forwardRef, useContext, useRef, useCallback, useLayoutEffect } from 'react';
+import { useMeasureFingerprint } from '../internal/MetricsProvider.js';
+import { isDOMRectsEqual, useInitOnce, useActualRef, scheduleMicro } from '../internal/utils.js';
+
+const FingerprintContext = createContext(null);
+const EnvironmentFingerprintNode = forwardRef(({ children, ...rest }, ref) => {
+    const ctx = useContext(FingerprintContext);
+    if (!ctx) {
+        throw new Error('EnvironmentFingerprintNode must be used inside EnvironmentFingerprintProvider');
+    }
+    const rootRef = useRef();
+    const rootRefCallback = useCallback((element) => {
+        rootRef.current = element;
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+        !!ref && (typeof ref === 'function' ? ref(element) : (ref.current = element));
+    }, [ref]);
+    const rectRef = useRef(null);
+    useMeasureFingerprint(rootRef, (rect) => {
+        if (!isDOMRectsEqual(rect, rectRef.current)) {
+            rectRef.current = rect;
+            ctx.notify();
+        }
+    });
+    return (jsx("div", { ref: rootRefCallback, ...rest, children: children }));
+});
+EnvironmentFingerprintNode.displayName = 'EnvironmentFingerprintNode';
+const EnvironmentFingerprintProvider = ({ children }) => {
+    const contextValue = useInitOnce(() => {
+        const callbacks = new Set();
+        // Ожидаем что изменения по фингерпринтам могут прилетать не чаще одного раза за тик
+        // (потому что они генерятся только ResizeObserver). При этом элементов может измениться сразу несколько,
+        // каждый коллбек нам нужно вызвать только один раз. Есть два варианта этого добиться:
+        // - обернуть вызов коллбеков в schedule, но тогда они вызовутся не синхронно, а в следующей микротаске
+        // - добавить флаг который предотвращает повторную нотификацию в тике и вызвать коллбеки синхронно
+        // Синхронный вызов коллбеков позволяет эффективнее снимать метрики в одном цикле измерений,
+        // поэтому выбран этот вариант - синхронизация через флаг.
+        let notified = false;
+        const resetNotified = scheduleMicro(() => (notified = false));
+        return {
+            registerCallback: (cb) => {
+                callbacks.add(cb);
+                return () => callbacks.delete(cb);
+            },
+            notify: () => {
+                if (notified) {
+                    return;
+                }
+                notified = true;
+                resetNotified();
+                callbacks.forEach((cb) => cb());
+            },
+        };
+    });
+    return jsx(FingerprintContext.Provider, { value: contextValue, children: children });
+};
+EnvironmentFingerprintProvider.displayName = 'EnvironmentFingerprintProvider';
+const useEnvironmentFingerprint = (onChange) => {
+    const ctx = useContext(FingerprintContext);
+    const onChangeRef = useActualRef(onChange);
+    const callback = useInitOnce(() => () => onChangeRef.current());
+    if (!ctx) {
+        throw new Error('useEnvironmentFingerprint must be used inside EnvironmentFingerprintProvider');
+    }
+    useLayoutEffect(() => ctx.registerCallback(callback), [ctx, callback]);
+};
+
+export { EnvironmentFingerprintNode, EnvironmentFingerprintProvider, useEnvironmentFingerprint };
+//# sourceMappingURL=EnvironmentFingerprintNode.js.map