@olddevs/ui 0.0.0-stage → 4.0.0

package/dist/editor/ui/lockableMenu.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Недоступная кнопка меню — `aria-disabled`, а не `disabled`: APG советует
+ * оставлять действия панели фокусируемыми, иначе стрелки перепрыгивают кнопку
+ * молча (как у кнопок Панели, `EditorToolbar`). Тип `MenuButton` атрибута не
+ * знает, а кнопка react-aria передаёт его в DOM.
+ */
+export declare function unavailableProps(unavailable: boolean | undefined): object;
+/**
+ * Меню Панели, которое бывает недоступным (HTML-режим, `aria-disabled`):
+ * управляемый `MenuTrigger`. Недоступная кнопка нажимается — фокус и стрелки у
+ * неё есть, — но меню не открывает, а ставшее недоступным открытое меню
+ * закрывается. Общий каркас «¶», «…», «Выравнивания», «Списков», «+» и
+ * «Таблицы»: `trigger` — пропы `MenuTrigger`, `button` — пропы кнопки меню,
+ * `close` — закрыть меню из кода (выбор не пунктом, а, например, в сетке).
+ *
+ * Отдельным модулем, а не в `FormatMenus.tsx`: каркасом пользуются и меню
+ * фич (таблица), и тянуть ради него форматные меню фича не должна — иначе
+ * общий UI и фича импортируют друг друга (ADR-0060, пункт 14).
+ */
+export declare function useLockableMenu(unavailable: boolean): {
+    trigger: {
+        isOpen: boolean;
+        onOpenChange: (next: boolean) => void;
+    };
+    button: object;
+    close: () => void;
+};
+//# sourceMappingURL=lockableMenu.d.ts.map

package/dist/editor/ui/lockableMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockableMenu.d.ts","sourceRoot":"","sources":["../../../src/editor/ui/lockableMenu.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAEzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,OAAO;;;6BAKzB,OAAO;;;;EAKjC"}

package/dist/editor/ui/lockableMenu.js

@@ -0,0 +1,17 @@
+"use client";
+import { useState } from "react";
+export function unavailableProps(unavailable) {
+    return unavailable ? { "aria-disabled": true } : {};
+}
+export function useLockableMenu(unavailable) {
+    const [open, setOpen] = useState(false);
+    return {
+        trigger: {
+            isOpen: open && !unavailable,
+            onOpenChange: (next) => setOpen(next && !unavailable),
+        },
+        button: unavailableProps(unavailable),
+        close: () => setOpen(false),
+    };
+}
+//# sourceMappingURL=lockableMenu.js.map

package/dist/editor/ui/lockableMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockableMenu.js","sourceRoot":"","sources":["../../../src/editor/ui/lockableMenu.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAQjC,MAAM,UAAU,gBAAgB,CAAC,WAAgC;IAC/D,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAcD,MAAM,UAAU,eAAe,CAAC,WAAoB;IAClD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW;YAC5B,YAAY,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC;SAC/D;QACD,MAAM,EAAE,gBAAgB,CAAC,WAAW,CAAC;QACrC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/editor/ui/rowMarks.d.ts

@@ -0,0 +1,21 @@
+import type { Editor } from "@tiptap/react";
+import type { ComponentType } from "react";
+import type { UiMessages } from "../../i18n/messages.js";
+import { type IconProps } from "../../icons.js";
+import type { Tool } from "../core/tools.js";
+/** Метка-переключатель ряда: кнопка с `aria-pressed` на Панели и в плашке. */
+export interface RowMark {
+    tool: Tool;
+    /** Id строки общей таблицы сочетаний (`shortcuts.ts`) — оттуда подсказка. */
+    id: string;
+    label: (messages: UiMessages["editor"]) => string;
+    icon: ComponentType<IconProps>;
+    run: (editor: Editor) => void;
+    can: (editor: Editor) => boolean;
+    isActive: (editor: Editor) => boolean;
+}
+/** Ряд Метак Панели: B · I. */
+export declare const TOOLBAR_ROW_MARKS: readonly RowMark[];
+/** Ряд Метак плашки меню выделения: B · I · U. */
+export declare const BUBBLE_ROW_MARKS: readonly RowMark[];
+//# sourceMappingURL=rowMarks.d.ts.map

package/dist/editor/ui/rowMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowMarks.d.ts","sourceRoot":"","sources":["../../../src/editor/ui/rowMarks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAuC,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,8EAA8E;AAC9E,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;IAClD,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC/B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AA2CD,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,EAAE,SAAS,OAAO,EAA6B,CAAC;AAE9E,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAA0C,CAAC"}

package/dist/editor/ui/rowMarks.js

@@ -0,0 +1,35 @@
+"use client";
+import { BoldIcon, ItalicIcon, UnderlineIcon } from "../../icons.js";
+const ROW_MARKS = [
+    {
+        tool: "bold",
+        id: "bold",
+        label: (m) => m.bold,
+        icon: BoldIcon,
+        run: (editor) => editor.chain().focus().toggleBold().run(),
+        can: (editor) => editor.can().toggleBold(),
+        isActive: (editor) => editor.isActive("bold"),
+    },
+    {
+        tool: "italic",
+        id: "italic",
+        label: (m) => m.italic,
+        icon: ItalicIcon,
+        run: (editor) => editor.chain().focus().toggleItalic().run(),
+        can: (editor) => editor.can().toggleItalic(),
+        isActive: (editor) => editor.isActive("italic"),
+    },
+    {
+        tool: "underline",
+        id: "underline",
+        label: (m) => m.underline,
+        icon: UnderlineIcon,
+        run: (editor) => editor.chain().focus().toggleUnderline().run(),
+        can: (editor) => editor.can().toggleUnderline(),
+        isActive: (editor) => editor.isActive("underline"),
+    },
+];
+const pick = (ids) => ids.map((id) => ROW_MARKS.find((mark) => mark.id === id));
+export const TOOLBAR_ROW_MARKS = pick(["bold", "italic"]);
+export const BUBBLE_ROW_MARKS = pick(["bold", "italic", "underline"]);
+//# sourceMappingURL=rowMarks.js.map

package/dist/editor/ui/rowMarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowMarks.js","sourceRoot":"","sources":["../../../src/editor/ui/rowMarks.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAwBrF,MAAM,SAAS,GAAuB;IACpC;QACE,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;QACpB,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE;QAC1D,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE;QAC1C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;KAC9C;IACD;QACE,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;QACtB,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE;QAC5D,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE;QAC5C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAChD;IACD;QACE,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS;QACzB,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE;QAC/D,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,EAAE;QAC/C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;KACnD;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,GAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAE,CAAC,CAAC;AAGpG,MAAM,CAAC,MAAM,iBAAiB,GAAuB,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAG9E,MAAM,CAAC,MAAM,gBAAgB,GAAuB,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC"}

package/dist/editor/ui/selectionMenu.d.ts

@@ -0,0 +1,61 @@
+import type { BubbleMenuProps } from "@tiptap/react/menus";
+import { type RefObject } from "react";
+/**
+ * Общее у всего, что всплывает над выделением на `BubbleMenu` Tiptap: у
+ * плавающей Панели (`toolbar="floating"`) и у меню выделения
+ * (`toolbar="bubble"`). Условие показа и позиция у них одни: две
+ * копии разъехались бы молча, и плашка показывалась бы там, где Панель — нет.
+ */
+/**
+ * Условие показа — умолчание `BubbleMenu` плюс два исключения: над
+ * выделенной картинкой стоит её собственная панель (`ImageToolbar`), и меню
+ * форматирования спорило бы с ней за одно место; над выделенным своим Блоком
+ * с Признаком «атом без меню форматирования» (`plainAtom` в spec узла) Меток
+ * не ставят.
+ *
+ * Пустое выделение, пустой текст под выделением, нередактируемое поле и фокус
+ * вне документа и вне самого меню — не показывать.
+ *
+ * ОТКРЫТОЕ ИЗ МЕНЮ — ТОЖЕ «ФОКУС ВНУТРИ». Списки «¶», «…», цвета и сетка эмодзи
+ * живут в портале, вне узла меню, и фокус в них для `focusWithin` — снаружи.
+ * А условие пересчитывается таймером после каждой правки: жирный за миг до
+ * открытия «¶» прятал плашку вместе с кнопкой меню, и Escape возвращал фокус в
+ * никуда. Пока у кнопки внутри меню `aria-expanded="true"` (его ставят и
+ * react-aria, и Radix), человек работает с меню — прятать его нельзя.
+ */
+export declare const showOverSelection: NonNullable<BubbleMenuProps["shouldShow"]>;
+/**
+ * Позиция — над выделением, с переворотом под него у верхнего края окна и
+ * сдвигом от боковых краёв.
+ *
+ * `strategy: "absolute"` (умолчание), а не `fixed`: меню лежит в DOM Редактора
+ * и едет вместе с текстом в любом контейнере прокрутки — в окне, в ящике, в
+ * карточке. `fixed` пересчитывался бы только на прокрутке окна. Цена — предок
+ * с `overflow: hidden` срежет меню у края; на странице компонента это сказано.
+ */
+export declare const SELECTION_MENU_OPTIONS: {
+    readonly placement: "top";
+    readonly offset: 8;
+    readonly flip: true;
+    readonly shift: {
+        readonly padding: 8;
+    };
+};
+/**
+ * Опции плашки с прокруткой области Документа (ADR-0059). Плагин `BubbleMenu`
+ * пересчитывает позицию на прокрутке окна; когда Документ прокручивается
+ * внутри рамки (`maxHeight`, `resizable`), слушать надо его область, иначе
+ * плашка висит на месте, а текст под ней уезжает. Без области — окно.
+ */
+export declare function useSelectionMenuOptions(scrollTarget: HTMLElement | undefined, options?: NonNullable<BubbleMenuProps["options"]>): NonNullable<BubbleMenuProps["options"]>;
+/**
+ * Убрать узел `BubbleMenu` из обхода Tab.
+ *
+ * Плагин ставит своему узлу `tabindex="0"` — ради щелчков по пустому месту
+ * меню, которые иначе сняли бы фокус с документа. Но это лишняя остановка
+ * Tab перед `role="toolbar"`, у которого остановка уже есть. `-1` оставляет
+ * узел фокусируемым щелчком и убирает его из обхода. Эффект родителя идёт
+ * после эффекта `BubbleMenu`, создающего плагин, — значение доживает.
+ */
+export declare function useOutOfTabOrder(ref: RefObject<HTMLElement | null>, dependency: unknown): void;
+//# sourceMappingURL=selectionMenu.d.ts.map

package/dist/editor/ui/selectionMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionMenu.d.ts","sourceRoot":"","sources":["../../../src/editor/ui/selectionMenu.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI3D;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAiBxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;CAKY,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,WAAW,GAAG,SAAS,EACrC,OAAO,GAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAA0B,GACxE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAKzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAI9F"}

package/dist/editor/ui/selectionMenu.js

@@ -0,0 +1,32 @@
+"use client";
+import { NodeSelection, TextSelection } from "@tiptap/pm/state";
+import { useEffect, useMemo } from "react";
+import { focusWithin } from "./focusWithin.js";
+import { isImageSelection } from "../features/image/image.js";
+export const showOverSelection = ({ editor, view, state, from, to, element, }) => {
+    const { selection } = state;
+    if (selection.empty || !editor.isEditable || isImageSelection(selection))
+        return false;
+    if (selection instanceof NodeSelection && selection.node.type.spec.plainAtom === true) {
+        return false;
+    }
+    const emptyText = !state.doc.textBetween(from, to).length && selection instanceof TextSelection;
+    if (emptyText)
+        return false;
+    return focusWithin(view, element) || element.querySelector('[aria-expanded="true"]') !== null;
+};
+export const SELECTION_MENU_OPTIONS = {
+    placement: "top",
+    offset: 8,
+    flip: true,
+    shift: { padding: 8 },
+};
+export function useSelectionMenuOptions(scrollTarget, options = SELECTION_MENU_OPTIONS) {
+    return useMemo(() => (scrollTarget ? { ...options, scrollTarget } : options), [scrollTarget, options]);
+}
+export function useOutOfTabOrder(ref, dependency) {
+    useEffect(() => {
+        ref.current?.setAttribute("tabindex", "-1");
+    }, [ref, dependency]);
+}
+//# sourceMappingURL=selectionMenu.js.map

package/dist/editor/ui/selectionMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionMenu.js","sourceRoot":"","sources":["../../../src/editor/ui/selectionMenu.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AA0B9D,MAAM,CAAC,MAAM,iBAAiB,GAA+C,CAAC,EAC5E,MAAM,EACN,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,EAAE,EACF,OAAO,GACR,EAAE,EAAE;IACH,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC5B,IAAI,SAAS,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,gBAAgB,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvF,IAAI,SAAS,YAAY,aAAa,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS,YAAY,aAAa,CAAC;IAChG,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,wBAAwB,CAAC,KAAK,IAAI,CAAC;AAChG,CAAC,CAAC;AAWF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;CACwB,CAAC;AAQhD,MAAM,UAAU,uBAAuB,CACrC,YAAqC,EACrC,UAAmD,sBAAsB;IAEzE,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAC7D,CAAC,YAAY,EAAE,OAAO,CAAC,CACxB,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,gBAAgB,CAAC,GAAkC,EAAE,UAAmB;IACtF,SAAS,CAAC,GAAG,EAAE;QACb,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/hooks/useFieldDescription.d.ts

@@ -0,0 +1,45 @@
+/** @internal Ставит `FormField`, когда под полем есть подсказка или ошибка. */
+export declare const FieldDescriptionProvider: import("react").Provider<string | undefined>;
+/**
+ * `id` сообщения под полем — для `aria-describedby`.
+ *
+ * @internal Читают поля кита. Потребителю не нужен: он передаёт полю свой
+ * `aria-describedby` пропом, и поле сливает его с этим значением, а не
+ * заменяет.
+ */
+export declare function useFieldDescribedBy(): string | undefined;
+/** @internal Ставит `FormField`, когда под полем есть ошибка. */
+export declare const FieldInvalidProvider: import("react").Provider<boolean>;
+/**
+ * Объявлено ли поле невалидным раскладкой формы.
+ *
+ * @internal Читают поля кита и сливают со своим пропом: явный `aria-invalid` от
+ * потребителя сильнее — он знает про своё поле больше, чем форма.
+ */
+export declare function useFieldInvalid(): boolean;
+/**
+ * Описание поля: СЛИЯНИЕ своего и того, что объявила форма.
+ *
+ * Вытеснение здесь ошибается в обе стороны, и обе встречались в ките:
+ *
+ * - спред `{...rest}` ПОСЛЕ условного — пользовательский `aria-describedby`
+ *   затирал контекстный, и ошибка формы не объявлялась вовсе;
+ * - спред ПЕРЕД условным — контекстный затирал пользовательский, и терялась
+ *   подсказка потребителя.
+ *
+ * Склейка снимает вопрос порядка целиком: оба идентификатора попадают в
+ * атрибут, скринридер читает оба. Приём был расписан в `TextControl` и
+ * `TagInput`, но не вынесен — и пять компонентов, подключённых к контексту
+ * позже, повторили его каждый по-своему.
+ */
+export declare function useDescribedBy(own?: string): string | undefined;
+/** @internal Ставит `FormField` всегда: подпись у него обязательна. */
+export declare const FieldLabelProvider: import("react").Provider<string | undefined>;
+/**
+ * `id` подписи объемлющего `FormField`.
+ *
+ * @internal Читают поля, которые не называются через `<label for>`
+ * (сейчас — `RichTextEditor`). Остальным хватает `htmlFor`.
+ */
+export declare function useFieldLabelId(): string | undefined;
+//# sourceMappingURL=useFieldDescription.d.ts.map

package/dist/hooks/useFieldDescription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldDescription.d.ts","sourceRoot":"","sources":["../../src/hooks/useFieldDescription.ts"],"names":[],"mappings":"AAyBA,+EAA+E;AAC/E,eAAO,MAAM,wBAAwB,8CAAmC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAmBD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,mCAA+B,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAW/D;AAmBD,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,8CAA6B,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD"}

package/dist/hooks/useFieldDescription.js

@@ -0,0 +1,23 @@
+"use client";
+import { createContext, useContext } from "react";
+const FieldDescriptionContext = createContext(undefined);
+export const FieldDescriptionProvider = FieldDescriptionContext.Provider;
+export function useFieldDescribedBy() {
+    return useContext(FieldDescriptionContext);
+}
+const FieldInvalidContext = createContext(false);
+export const FieldInvalidProvider = FieldInvalidContext.Provider;
+export function useFieldInvalid() {
+    return useContext(FieldInvalidContext);
+}
+export function useDescribedBy(own) {
+    const fromField = useContext(FieldDescriptionContext);
+    const ids = `${own ?? ""} ${fromField ?? ""}`.trim().split(/\s+/).filter(Boolean);
+    return ids.length > 0 ? [...new Set(ids)].join(" ") : undefined;
+}
+const FieldLabelContext = createContext(undefined);
+export const FieldLabelProvider = FieldLabelContext.Provider;
+export function useFieldLabelId() {
+    return useContext(FieldLabelContext);
+}
+//# sourceMappingURL=useFieldDescription.js.map

package/dist/hooks/useFieldDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFieldDescription.js","sourceRoot":"","sources":["../../src/hooks/useFieldDescription.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAqBlD,MAAM,uBAAuB,GAAG,aAAa,CAAqB,SAAS,CAAC,CAAC;AAG7E,MAAM,CAAC,MAAM,wBAAwB,GAAG,uBAAuB,CAAC,QAAQ,CAAC;AASzE,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,uBAAuB,CAAC,CAAC;AAC7C,CAAC;AAiBD,MAAM,mBAAmB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AAGjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,QAAQ,CAAC;AAQjE,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC;AAiBD,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAQtD,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,EAAE,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAiBD,MAAM,iBAAiB,GAAG,aAAa,CAAqB,SAAS,CAAC,CAAC;AAGvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,QAAQ,CAAC;AAQ7D,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC"}

package/dist/hooks/useMediaQuery.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Совпадает ли медиазапрос с окном прямо сейчас — и следит за изменением.
+ *
+ * ЭТО НЕ СПОСОБ РАСКЛАДЫВАТЬ СТРАНИЦУ. Показать или спрятать блок по ширине
+ * надо классом (`hidden lg:block`): класс работает с первого кадра и на
+ * сервере, а раскладка, зависящая от JS, до гидратации показывает неверную
+ * (ADR-0018). Хук нужен там, где от ширины зависит не вид, а СОСТАВ или ПОВЕДЕНИЕ
+ * — что смонтировать, сколько месяцев рисовать, закрывать ли ящик по Escape, —
+ * и класс этого не выразит.
+ *
+ * ДО ГИДРАТАЦИИ ХУК ВОЗВРАЩАЕТ `serverValue`, ПО УМОЛЧАНИЮ `false`. Сервер
+ * ширины не знает, и угадывать её значило бы получить расхождение разметки.
+ * `false` — потому что отсчёт mobile-first, как у самого Tailwind: запрос
+ * `min-width` на сервере «ещё не выполнен», и первый кадр всегда узкий. React
+ * при гидратации сам берёт серверное значение, а настоящее подставляет сразу
+ * после — без ошибки расхождения, но с одной перерисовкой. На широком экране
+ * это видимый переход, поэтому всё, что можно выразить классом, выражайте им.
+ *
+ * Нет `matchMedia` вовсе (jsdom, сервер) — тоже `serverValue`: хук не бросает.
+ *
+ * Запрос — строка как есть: `(min-width: 1024px)`. Брейкпойнты кита — штатные
+ * Tailwind 4: `sm` 640, `md` 768, `lg` 1024, `xl` 1280.
+ */
+export declare function useMediaQuery(query: string, serverValue?: boolean): boolean;
+//# sourceMappingURL=useMediaQuery.d.ts.map

package/dist/hooks/useMediaQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,CAkBzE"}

package/dist/hooks/useMediaQuery.js

@@ -0,0 +1,14 @@
+"use client";
+import { useCallback, useSyncExternalStore } from "react";
+export function useMediaQuery(query, serverValue = false) {
+    const subscribe = useCallback((notify) => {
+        if (typeof window.matchMedia !== "function")
+            return () => { };
+        const list = window.matchMedia(query);
+        list.addEventListener("change", notify);
+        return () => list.removeEventListener("change", notify);
+    }, [query]);
+    const getSnapshot = useCallback(() => typeof window.matchMedia === "function" ? window.matchMedia(query).matches : serverValue, [query, serverValue]);
+    return useSyncExternalStore(subscribe, getSnapshot, () => serverValue);
+}
+//# sourceMappingURL=useMediaQuery.js.map

package/dist/hooks/useMediaQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.js","sourceRoot":"","sources":["../../src/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAyB1D,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,WAAW,GAAG,KAAK;IAC9D,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,MAAkB,EAAE,EAAE;QACrB,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAC7B,GAAG,EAAE,CACH,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,EAC1F,CAAC,KAAK,EAAE,WAAW,CAAC,CACrB,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC;AACzE,CAAC"}

package/dist/hooks/useOpenerFocus.d.ts

@@ -0,0 +1,10 @@
+import { type RefObject } from "react";
+export declare function useOpenerFocus(open: boolean, 
+/** Содержимое собственного слоя: фокус внутри него открывшим не считается. */
+contentRef: RefObject<HTMLElement | null>): {
+    /** В `onOpenAutoFocus`: запомнить того, кто открыл. */
+    remember: () => void;
+    /** В `onCloseAutoFocus`: вернуть ему фокус. */
+    restore: (event: Event) => void;
+};
+//# sourceMappingURL=useOpenerFocus.d.ts.map

package/dist/hooks/useOpenerFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOpenerFocus.d.ts","sourceRoot":"","sources":["../../src/hooks/useOpenerFocus.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAiD1D,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO;AACb,8EAA8E;AAC9E,UAAU,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACxC;IACD,uDAAuD;IACvD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,CAyDA"}

package/dist/hooks/useOpenerFocus.js

@@ -0,0 +1,35 @@
+"use client";
+import { useEffect, useRef } from "react";
+function isOpenerCandidate(node, content) {
+    return node instanceof HTMLElement && node !== document.body && !content?.contains(node);
+}
+export function useOpenerFocus(open, contentRef) {
+    const opener = useRef(null);
+    const lastOutside = useRef(null);
+    useEffect(() => {
+        if (open)
+            return;
+        const onFocusIn = (event) => {
+            const el = event.target;
+            if (!isOpenerCandidate(el, contentRef.current))
+                return;
+            lastOutside.current = el;
+        };
+        document.addEventListener("focusin", onFocusIn, true);
+        return () => document.removeEventListener("focusin", onFocusIn, true);
+    }, [open]);
+    return {
+        remember: () => {
+            const active = document.activeElement;
+            opener.current = isOpenerCandidate(active, contentRef.current) ? active : lastOutside.current;
+        },
+        restore: (event) => {
+            const el = opener.current ?? lastOutside.current;
+            if (!el?.isConnected)
+                return;
+            event.preventDefault();
+            el.focus();
+        },
+    };
+}
+//# sourceMappingURL=useOpenerFocus.js.map

package/dist/hooks/useOpenerFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOpenerFocus.js","sourceRoot":"","sources":["../../src/hooks/useOpenerFocus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AA0C1D,SAAS,iBAAiB,CACxB,IAAkC,EAClC,OAA2B;IAE3B,OAAO,IAAI,YAAY,WAAW,IAAI,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAa,EAEb,UAAyC;IAOzC,MAAM,MAAM,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IAqBrD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI;YAAE,OAAO;QACjB,MAAM,SAAS,GAAG,CAAC,KAAiB,EAAE,EAAE;YACtC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;YACxB,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO;YACvD,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC;QAC3B,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC;YACtC,MAAM,CAAC,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;QAChG,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAUjB,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC;YAGjD,IAAI,CAAC,EAAE,EAAE,WAAW;gBAAE,OAAO;YAC7B,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/hooks/useOverlayLayer.d.ts

@@ -0,0 +1,23 @@
+import { type RefObject } from "react";
+/**
+ * Регистрация модального слоя в общем стеке (ADR-0041).
+ *
+ * Хук, а не прямой вызов в каждом компоненте, по двум причинам.
+ *
+ * ПЕРВАЯ — жизненный цикл. Регистрировать надо ИМЕННО В ЭФФЕКТЕ: стек —
+ * модульный, и запись в него из тела компонента была бы побочным действием
+ * рендера. В StrictMode React монтирует, размонтирует и монтирует снова, и
+ * слой, положенный в рендере и снятый уборщиком, обратно уже не попадал —
+ * подложка переставала считать себя верхней и молча переставала закрываться по
+ * Escape. Один правильный цикл лучше четырёх копий.
+ *
+ * ВТОРАЯ — охват. ADR обещает, что в стеке состоят ВСЕ модальные слои кита, и
+ * первая версия обещание не держала: регистрировался один `ModalOverlay`, то
+ * есть стек решал «подложка против подложки» и ничего больше.
+ */
+export declare function useOverlayLayer(open: boolean, 
+/** Узел слоя: по его положению в документе и определяется верхний. */
+nodeRef: RefObject<HTMLElement | null>): {
+    isTopmost: () => boolean;
+};
+//# sourceMappingURL=useOverlayLayer.d.ts.map

package/dist/hooks/useOverlayLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayLayer.d.ts","sourceRoot":"","sources":["../../src/hooks/useOverlayLayer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO;AACb,sEAAsE;AACtE,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GACrC;IAAE,SAAS,EAAE,MAAM,OAAO,CAAA;CAAE,CAgB9B"}

package/dist/hooks/useOverlayLayer.js

@@ -0,0 +1,19 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { pushOverlayLayer } from "../lib/overlay-layer.js";
+export function useOverlayLayer(open, nodeRef) {
+    const layerRef = useRef(null);
+    useEffect(() => {
+        if (!open)
+            return;
+        const layer = pushOverlayLayer();
+        layer.attach(nodeRef.current);
+        layerRef.current = layer;
+        return () => {
+            layer.release();
+            layerRef.current = null;
+        };
+    }, [open, nodeRef]);
+    return { isTopmost: () => layerRef.current?.isTopmost() ?? false };
+}
+//# sourceMappingURL=useOverlayLayer.js.map

package/dist/hooks/useOverlayLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOverlayLayer.js","sourceRoot":"","sources":["../../src/hooks/useOverlayLayer.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkB3D,MAAM,UAAU,eAAe,CAC7B,IAAa,EAEb,OAAsC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAA6C,IAAI,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QACzB,OAAO,GAAG,EAAE;YACV,KAAK,CAAC,OAAO,EAAE,CAAC;YAChB,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAGpB,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,KAAK,EAAE,CAAC;AACrE,CAAC"}

package/dist/hooks/useScrollLock.d.ts

@@ -0,0 +1,3 @@
+/** Блокирует прокрутку страницы, пока `isLocked` истинно. */
+export declare function useScrollLock(isLocked: boolean): void;
+//# sourceMappingURL=useScrollLock.d.ts.map

package/dist/hooks/useScrollLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollLock.ts"],"names":[],"mappings":"AAgEA,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CA0BrD"}

package/dist/hooks/useScrollLock.js

@@ -0,0 +1,52 @@
+"use client";
+import { useEffect, useRef } from "react";
+let lockCount = 0;
+let paddingBeforeLock = "";
+let paddingSetByLock = "";
+function applyLock() {
+    const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+    paddingBeforeLock = document.body.style.paddingRight;
+    document.body.classList.add("scroll-locked");
+    paddingSetByLock = scrollbarWidth > 0 ? `${scrollbarWidth}px` : "";
+    if (paddingSetByLock)
+        document.body.style.paddingRight = paddingSetByLock;
+}
+function removeLock() {
+    document.body.classList.remove("scroll-locked");
+    if (document.body.style.paddingRight === paddingSetByLock) {
+        if (paddingBeforeLock)
+            document.body.style.paddingRight = paddingBeforeLock;
+        else
+            document.body.style.removeProperty("padding-right");
+    }
+    paddingBeforeLock = "";
+    paddingSetByLock = "";
+}
+export function useScrollLock(isLocked) {
+    const wasLocked = useRef(false);
+    useEffect(() => {
+        if (isLocked && !wasLocked.current) {
+            if (lockCount === 0)
+                applyLock();
+            lockCount++;
+            wasLocked.current = true;
+        }
+        else if (!isLocked && wasLocked.current) {
+            lockCount = Math.max(0, lockCount - 1);
+            if (lockCount === 0)
+                removeLock();
+            wasLocked.current = false;
+        }
+    }, [isLocked]);
+    useEffect(() => {
+        return () => {
+            if (wasLocked.current) {
+                lockCount = Math.max(0, lockCount - 1);
+                if (lockCount === 0)
+                    removeLock();
+                wasLocked.current = false;
+            }
+        };
+    }, []);
+}
+//# sourceMappingURL=useScrollLock.js.map

package/dist/hooks/useScrollLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollLock.js","sourceRoot":"","sources":["../../src/hooks/useScrollLock.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAgB1C,IAAI,SAAS,GAAG,CAAC,CAAC;AAclB,IAAI,iBAAiB,GAAG,EAAE,CAAC;AAE3B,IAAI,gBAAgB,GAAG,EAAE,CAAC;AAE1B,SAAS,SAAS;IAGhB,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC;IAChF,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7C,gBAAgB,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,IAAI,gBAAgB;QAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,gBAAgB,CAAC;AAC5E,CAAC;AAED,SAAS,UAAU;IACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAShD,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,KAAK,gBAAgB,EAAE,CAAC;QAC1D,IAAI,iBAAiB;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,iBAAiB,CAAC;;YACvE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IACD,iBAAiB,GAAG,EAAE,CAAC;IACvB,gBAAgB,GAAG,EAAE,CAAC;AACxB,CAAC;AAGD,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,SAAS,KAAK,CAAC;gBAAE,SAAS,EAAE,CAAC;YACjC,SAAS,EAAE,CAAC;YACZ,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC;aAAM,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YAC1C,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;YACvC,IAAI,SAAS,KAAK,CAAC;gBAAE,UAAU,EAAE,CAAC;YAClC,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAIf,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;gBACvC,IAAI,SAAS,KAAK,CAAC;oBAAE,UAAU,EAAE,CAAC;gBAClC,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC"}

package/dist/hooks/useStickyOffset.d.ts

@@ -0,0 +1,53 @@
+export interface StickyOffsetOptions {
+    /**
+     * Имя CSS-переменной, в которой приложение публикует высоту своей верхней
+     * панели. Проп, а не константа: пакет не знает, что у потребителя есть
+     * шапка, как она называется и есть ли она вообще ([ADR-0016]).
+     */
+    offsetVar?: string;
+    /** Смещение, когда переменной нет. Это законное состояние, а не ошибка. */
+    fallback?: string;
+}
+export interface StickyOffset {
+    /**
+     * Вешается на пустой блок нулевой высоты **прямо перед** липким элементом.
+     * Пересечение именно этого блока и означает, что полоса встала на место.
+     *
+     * Callback-ref, а не объект: полоса бывает условной и появляется позже самой
+     * страницы, а эффект на монтировании такой маркер попросту не застаёт.
+     */
+    sentinelRef: (node: HTMLElement | null) => void;
+    /** Полоса прижалась к верхней границе. */
+    isStuck: boolean;
+}
+/**
+ * Приводит опубликованную длину к пикселям.
+ *
+ * `IntersectionObserver` принимает ТОЛЬКО пиксели и проценты и бросает
+ * `SyntaxError` на всём остальном. Значение уходило в `rootMargin` как есть, а
+ * кит нигде не требует от приложения публиковать высоту именно в пикселях:
+ * `--topbar-h: 4rem` роняло полосу и всё поддерево во время коммита.
+ *
+ * Единицы, которые браузер понимает сам, пропускаются без работы; остальные
+ * меряются одноразовым элементом. Мерить приходится в документе — вне его
+ * раскладки нет. Вызывающий обязан отсечь повтор ДО вызова (см. `rawRef`):
+ * замер стоит двух принудительных пересчётов раскладки.
+ *
+ * Пределы, принятые осознанно: `em` меряется относительно шрифта `body`, а не
+ * шапки; отрицательное значение в неизвестных единицах браузер отбрасывает, и
+ * получается `0px` (в пикселях знак сохраняется).
+ */
+export declare function toPixels(value: string, fallback: string): string;
+/**
+ * Липкая полоса: знает, прижалась ли она уже к верхней панели приложения.
+ *
+ * Отсчёт идёт от НАСТОЯЩЕЙ высоты панели, а не от зашитого числа: на узких
+ * экранах шапка ниже, чем на широких, и константа оставляет просвет, сквозь
+ * который видно уезжающий контент. Высоту публикует приложение — в CSS-переменной,
+ * имя которой здесь проп. Решение и отвергнутые варианты — [ADR-0016].
+ *
+ * Потребитель обычно использует `isStuck`, чтобы убрать верхние скругления:
+ * у прижавшейся полосы они приоткрывают фон страницы уголками на стыке.
+ */
+export declare function useStickyOffset({ offsetVar, fallback, }?: StickyOffsetOptions): StickyOffset;
+//# sourceMappingURL=useStickyOffset.d.ts.map

package/dist/hooks/useStickyOffset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStickyOffset.d.ts","sourceRoot":"","sources":["../../src/hooks/useStickyOffset.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAcD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAwB,EACxB,QAAgB,GACjB,GAAE,mBAAwB,GAAG,YAAY,CAmIzC"}