@olddevs/ui 0.0.0-stage → 4.0.1

package/dist/components/actions/Toolbar.js

@@ -0,0 +1,98 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef } from "react";
+import { Toolbar as AriaToolbar, SeparatorContext, ToggleButtonGroupContext, } from "react-aria-components";
+import { cn } from "../../lib/cn.js";
+const FOCUSABLE = [
+    "input:not([disabled]):not([type=hidden])",
+    "select:not([disabled])",
+    "textarea:not([disabled])",
+    "button:not([disabled])",
+    "a[href]",
+    "area[href]",
+    "summary",
+    "iframe",
+    "object",
+    "embed",
+    "audio[controls]",
+    "video[controls]",
+    '[contenteditable]:not([contenteditable^="false"])',
+    "[tabindex]:not([disabled])",
+]
+    .map((selector) => `${selector}:not([hidden])`)
+    .join(", ");
+const OWN_HOME_END = [
+    "input:not([type=checkbox]):not([type=radio]):not([type=button]):not([type=submit]):not([type=reset]):not([type=image]):not([type=file]):not([type=color])",
+    "textarea",
+    "select",
+    '[contenteditable=""]',
+    '[contenteditable="true"]',
+    '[role="textbox"]',
+    '[role="searchbox"]',
+    '[role="combobox"]',
+    '[role="slider"]',
+    '[role="spinbutton"]',
+    '[role="listbox"]',
+    '[role="menu"]',
+    '[role="menubar"]',
+    '[role="tablist"]',
+    '[role="grid"]',
+    '[role="treegrid"]',
+    '[role="tree"]',
+].join(", ");
+function isVisible(el) {
+    if (el.closest("[data-react-aria-prevent-focus]"))
+        return false;
+    if (typeof el.checkVisibility === "function")
+        return el.checkVisibility({ visibilityProperty: true });
+    const view = el.ownerDocument.defaultView;
+    if (!view)
+        return true;
+    const { visibility } = view.getComputedStyle(el);
+    if (visibility === "hidden" || visibility === "collapse")
+        return false;
+    for (let node = el; node; node = node.parentElement) {
+        if (node.hidden || view.getComputedStyle(node).display === "none")
+            return false;
+    }
+    return true;
+}
+function actions(toolbar) {
+    return Array.from(toolbar.querySelectorAll(FOCUSABLE)).filter((el) => !el.closest("[inert]") && isVisible(el));
+}
+export const Toolbar = forwardRef(function Toolbar({ orientation = "horizontal", className, children, ...rest }, forwardedRef) {
+    const vertical = orientation === "vertical";
+    const groupContext = useMemo(() => ({ orientation }), [orientation]);
+    const separatorContext = useMemo(() => ({ orientation: vertical ? "horizontal" : "vertical" }), [vertical]);
+    const ref = useRef(null);
+    useImperativeHandle(forwardedRef, () => ref.current, []);
+    useEffect(() => {
+        const toolbar = ref.current;
+        if (!toolbar)
+            return;
+        const onKeyDown = (event) => {
+            if (event.key !== "Home" && event.key !== "End")
+                return;
+            if (event.defaultPrevented ||
+                event.altKey ||
+                event.ctrlKey ||
+                event.metaKey ||
+                event.shiftKey)
+                return;
+            const target = event.target;
+            const owner = target.closest(OWN_HOME_END);
+            if (owner && toolbar.contains(owner))
+                return;
+            const list = actions(toolbar);
+            const next = event.key === "Home" ? list[0] : list[list.length - 1];
+            if (!next)
+                return;
+            event.preventDefault();
+            next.focus();
+        };
+        toolbar.addEventListener("keydown", onKeyDown);
+        return () => toolbar.removeEventListener("keydown", onKeyDown);
+    }, []);
+    return (_jsx(ToggleButtonGroupContext.Provider, { value: groupContext, children: _jsx(SeparatorContext.Provider, { value: separatorContext, children: _jsx(AriaToolbar, { ...rest, orientation: orientation, ref: ref, className: cn("flex gap-1.5", "[&>[role=separator][aria-orientation=vertical]]:h-auto", vertical ? "w-fit flex-col items-start" : "flex-row flex-wrap items-center", className), children: children }) }) }));
+});
+//# sourceMappingURL=Toolbar.js.map

package/dist/components/actions/Toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.js","sourceRoot":"","sources":["../../../src/components/actions/Toolbar.tsx"],"names":[],"mappings":"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"}

package/dist/components/actions/Truncate.d.ts

@@ -0,0 +1,31 @@
+import { type ComponentPropsWithoutRef } from "react";
+export interface TruncateProps extends Omit<ComponentPropsWithoutRef<"span">, "children"> {
+    /** Текст. Строка, а не вёрстка: подсказка показывает то же самое значение. */
+    children: string;
+    /** Сколько строк показывать. `1` — обрезка в строку с многоточием. */
+    lines?: number;
+    /** Сторона, с которой всплывает подсказка с полным текстом. По умолчанию `top`. */
+    side?: "top" | "right" | "bottom" | "left";
+}
+/**
+ * Текст, обрезанный по ширине, с подсказкой полного значения.
+ *
+ * ПОДСКАЗКА ПОЯВЛЯЕТСЯ ТОЛЬКО КОГДА ТЕКСТ ДЕЙСТВИТЕЛЬНО ОБРЕЗАН. Подсказка на
+ * неусечённом тексте — шум: она повторяет то, что и так видно, и приучает её
+ * игнорировать. Обрезанность МЕРЯЕТСЯ (`scrollWidth > clientWidth`), а не
+ * угадывается по длине строки: сколько символов влезло, зависит от ширины
+ * контейнера и шрифта, а не от числа символов.
+ *
+ * Замер повторяется при изменении размеров через `ResizeObserver`: колонка
+ * таблицы, потянутая мышью, меняет обрезанность, не меняя текста.
+ *
+ * ПОЛНОЕ ЗНАЧЕНИЕ ДОСТУПНО С КЛАВИАТУРЫ. Обрезанный текст получает
+ * `tabIndex={0}`, и подсказка открывается по фокусу так же, как по наведению.
+ * Без этого значение было бы доступно только мышью — то есть недоступно вовсе
+ * для того, кто мышью не пользуется.
+ *
+ * Скринридер при этом читает текст ЦЕЛИКОМ и без нашей помощи: обрезка
+ * визуальная, в DOM лежит вся строка.
+ */
+export declare function Truncate({ children, lines, side, className, ...rest }: TruncateProps): import("react").JSX.Element;
+//# sourceMappingURL=Truncate.d.ts.map

package/dist/components/actions/Truncate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Truncate.d.ts","sourceRoot":"","sources":["../../../src/components/actions/Truncate.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA4C,KAAK,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAIhG,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IACvF,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAS,EAAE,IAAY,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,aAAa,+BA4DhG"}

package/dist/components/actions/Truncate.js

@@ -0,0 +1,32 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { cn } from "../../lib/cn.js";
+import { Tooltip } from "../overlays/Tooltip.js";
+export function Truncate({ children, lines = 1, side = "top", className, ...rest }) {
+    const ref = useRef(null);
+    const [truncated, setTruncated] = useState(false);
+    const measure = useCallback(() => {
+        const el = ref.current;
+        if (el == null)
+            return;
+        setTruncated(el.scrollWidth > el.clientWidth || el.scrollHeight > el.clientHeight);
+    }, []);
+    useEffect(() => {
+        measure();
+        const el = ref.current;
+        if (el == null || typeof ResizeObserver === "undefined")
+            return;
+        const observer = new ResizeObserver(measure);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [measure, children, lines, truncated]);
+    const text = (_jsx("span", { ref: ref, tabIndex: truncated ? 0 : undefined, className: cn("focus-visible:outline-accent-strong block min-w-0 focus-visible:outline-2 focus-visible:outline-offset-2", lines === 1
+            ? "truncate"
+            :
+                "[display:-webkit-box] overflow-hidden [-webkit-box-orient:vertical]", className), style: lines === 1 ? undefined : { WebkitLineClamp: lines }, ...rest, children: children }));
+    if (!truncated)
+        return text;
+    return (_jsx(Tooltip, { content: children, side: side, children: text }));
+}
+//# sourceMappingURL=Truncate.js.map

package/dist/components/actions/Truncate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Truncate.js","sourceRoot":"","sources":["../../../src/components/actions/Truncate.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAiC,MAAM,OAAO,CAAC;AAChG,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AA+BjD,MAAM,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,EAAiB;IAC/F,MAAM,GAAG,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,IAAI,IAAI;YAAE,OAAO;QACvB,YAAY,CAAC,EAAE,CAAC,WAAW,GAAG,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;IACrF,CAAC,EAAE,EAAE,CAAC,CAAC;IAWP,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;QACvB,IAAI,EAAE,IAAI,IAAI,IAAI,OAAO,cAAc,KAAK,WAAW;YAAE,OAAO;QAChE,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,CACX,eACE,GAAG,EAAE,GAAG,EAGR,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EACnC,SAAS,EAAE,EAAE,CACX,0GAA0G,EAC1G,KAAK,KAAK,CAAC;YACT,CAAC,CAAC,UAAU;YACZ,CAAC;gBAGC,qEAAqE,EACzE,SAAS,CACV,EACD,KAAK,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,KACvD,IAAI,YAEP,QAAQ,GACJ,CACR,CAAC;IAIF,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,OAAO,CACL,KAAC,OAAO,IAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,YACnC,IAAI,GACG,CACX,CAAC;AACJ,CAAC"}

package/dist/components/app-shell/AppShell.d.ts

@@ -0,0 +1,106 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface AppShellContextValue {
+    /**
+     * Открыть навигацию ящиком. Есть, когда каркас получил `sidebar`. Ширину
+     * экрана каркас не проверяет, поэтому свою кнопку показывают только там, где
+     * колонка скрыта, то есть ниже `md`.
+     */
+    openNavigation?: () => void;
+}
+/**
+ * Доступ к каркасу из своей шапки.
+ *
+ * Публичный, а не внутренний, и это исправление дефекта, а не удобство:
+ * `openNavigation` умел читать только китовый `TopBar`, и потребитель со своей
+ * шапкой получал навигацию, которую ниже `md` **нечем открыть** — колонка
+ * скрыта, ящик открывать некому, предупреждения нет. Молчаливая недостижимость
+ * целого раздела интерфейса.
+ *
+ * Вне `AppShell` возвращает пустой объект: своя шапка проверяет
+ * `openNavigation` на наличие и рисует кнопку только когда та осмысленна.
+ */
+export declare const useAppShell: () => AppShellContextValue;
+export interface AppShellProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    /** Боковая навигация — обычно `SideNav`. */
+    sidebar?: ReactNode;
+    /** Шапка — обычно `TopBar`. */
+    header?: ReactNode;
+    /**
+     * Сообщения уровня приложения над шапкой — обычно один или несколько `Banner`.
+     *
+     * Стоят НАД шапкой, в колонке содержимого: деградация сервиса касается всего
+     * приложения, но боковая навигация остаётся во всю высоту — иначе каркас
+     * пришлось бы разворачивать из строки в колонку целиком ради узла, который
+     * бывает пустым.
+     *
+     * НЕ ЛИПКИЕ, и это решение, а не упущение (ADR-0027).
+     * Шапка остаётся на `top: 0`, а `--topbar-h` продолжает означать ровно её
+     * высоту — контракт липкости (ADR-0016)
+     * и его публикация шапкой (ADR-0019)
+     * не трогаются. Липкая стопка потребовала бы второй переменной смещения, и
+     * всё, что сегодня считает от `--topbar-h` — `SelectionBar`, липкая шапка
+     * `Table`, — обязано было бы прибавлять её высоту.
+     *
+     * Очереди у слота нет: порядок и состав задаёт потребитель.
+     */
+    banners?: ReactNode;
+    /**
+     * Правая область рядом с содержимым: детали, справка, что угодно ещё.
+     *
+     * Безымянный слот без ручки изменения размера — и это решение, а не
+     * недоделка. Ручку размера даёт отдельный компонент `SplitPanel`
+     * (ADR-0018).
+     */
+    aside?: ReactNode;
+    /**
+     * Нижняя панель на узких экранах — обычно `MobileTabBar`; на `md` и шире скрыта.
+     *
+     * Слот даёт панели всё, что принадлежит каркасу, а не ей: прилипание к низу
+     * окна, скрытие на `md` и шире, где есть боковая навигация, высоту в потоке и
+     * отступ `env(safe-area-inset-bottom)` под вырез экрана. Поэтому
+     * `MobileTabBar` своих `fixed`, `md:hidden` и отступа не несёт, а чужая
+     * панель, поставленная сюда, не должна их повторять — отступ вышел бы
+     * двойным.
+     */
+    bottomBar?: ReactNode;
+    /**
+     * Имя переменной, в которую слот `bottomBar` публикует свою высоту (вместе с
+     * отступом под вырез экрана). По умолчанию `--bottombar-h`.
+     *
+     * Парная сторона контракта, как `heightVar` у `TopBar`: то же имя по
+     * умолчанию читают `ContextualSaveBar` и `Toaster` (их проп `offsetVar`), и
+     * они встают над панелью, а не под ней. На `md` и шире панель скрыта и высота
+     * равна `0px`; без слота переменной нет вовсе, и читатели берут запасное `0px`.
+     *
+     * `null` отключает публикацию — когда в документе два каркаса и они не должны
+     * перебивать друг друга.
+     */
+    bottomBarHeightVar?: string | null;
+    /**
+     * Ключ текущего маршрута: при его смене фокус уезжает в `<main>`, а ящик навигации закрывается.
+     *
+     * Проп, а не подписка на роутер: кит не знает, какой это роутер, и что
+     * считать сменой экрана, знает только приложение. Не передан — возврата
+     * фокуса не будет, и это **молчаливая деградация**: ни ошибки, ни
+     * предупреждения не появится, поэтому проп стоит передавать всегда.
+     */
+    routeKey?: string;
+    /** Содержимое страницы — попадает в `<main>`. */
+    children: ReactNode;
+}
+/**
+ * Каркас приложения: навигация слева, шапка сверху, содержимое, опциональные
+ * правая область и нижняя панель.
+ *
+ * СКРОЛЛ ОСТАЁТСЯ У ДОКУМЕНТА, а не у `<main>`. Это не мелочь раскладки: липкие
+ * элементы кита (`SelectionBar`) отсчитывают смещение от высоты шапки, и если
+ * бы содержимое прокручивалось в собственном контейнере, полоса встала бы с
+ * просветом в эту самую высоту. Прежняя оболочка во фронте устроена так же, и
+ * контракт ADR-0016 продолжает работать без оговорок.
+ *
+ * МОБИЛЬНЫЙ РЕЖИМ переключает CSS, а не `matchMedia`: колонка навигации скрыта
+ * классом, ящик показан классом. `matchMedia` в SSR даёт неверный первый кадр,
+ * и пользователь видит скачок раскладки после гидратации (ADR-0018).
+ */
+export declare const AppShell: import("react").ForwardRefExoticComponent<AppShellProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AppShell.d.ts.map

package/dist/components/app-shell/AppShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/components/app-shell/AppShell.tsx"],"names":[],"mappings":"AAEA,OAAO,EAQL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAmBf,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,QAAO,oBAAmD,CAAC;AAEnF,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACtF,4CAA4C;IAC5C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,0GAkInB,CAAC"}

package/dist/components/app-shell/AppShell.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, forwardRef, useContext, useEffect, useId, useRef, useState, } from "react";
+import { useMessages } from "../../i18n/useMessages.js";
+import { BottomBarSlotContext } from "../../lib/bottom-bar-slot.js";
+import { cn } from "../../lib/cn.js";
+import { usePublishedHeight } from "../../lib/published-height.js";
+import { Drawer } from "../overlays/Drawer.js";
+import { NavInOverlayProvider } from "./SideNav.js";
+const AppShellContext = createContext({});
+export const useAppShell = () => useContext(AppShellContext);
+export const AppShell = forwardRef(function AppShell({ sidebar, header, banners, aside, bottomBar, bottomBarHeightVar = "--bottombar-h", routeKey, children, className, ...rest }, ref) {
+    const messages = useMessages();
+    const mainId = useId();
+    const mainRef = useRef(null);
+    const [navOpen, setNavOpen] = useState(false);
+    const lastRouteKey = useRef(routeKey);
+    const bottomBarRef = useRef(null);
+    usePublishedHeight(bottomBarRef, bottomBarHeightVar, bottomBar != null);
+    useEffect(() => {
+        if (lastRouteKey.current === routeKey)
+            return;
+        lastRouteKey.current = routeKey;
+        mainRef.current?.focus({ preventScroll: true });
+    }, [routeKey]);
+    useEffect(() => setNavOpen(false), [routeKey]);
+    return (_jsx(AppShellContext.Provider, { value: { openNavigation: sidebar ? () => setNavOpen(true) : undefined }, children: _jsxs("div", { ref: ref, className: cn("relative flex min-h-dvh", className), ...rest, children: [_jsx("a", { href: `#${mainId}`, className: "focus:bg-bg-1 focus:text-fg-0 focus:outline-accent-strong sr-only focus:not-sr-only focus:absolute focus:top-2 focus:left-2 focus:z-50 focus:rounded-lg focus:px-3 focus:py-2 focus:text-sm focus:outline-2", children: messages.shell.skipToContent }), sidebar != null ? (_jsxs(_Fragment, { children: [_jsx("div", { className: "sticky top-0 hidden h-dvh md:flex", children: sidebar }), _jsx(Drawer, { open: navOpen, onClose: () => setNavOpen(false), side: "left", size: "sm", title: messages.nav.label, children: _jsx(NavInOverlayProvider, { value: true, children: sidebar }) })] })) : null, _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [banners, header, _jsxs("div", { className: "flex min-w-0 flex-1", children: [_jsx("main", { id: mainId, ref: mainRef, tabIndex: -1, className: "min-w-0 flex-1 outline-none", children: children }), aside != null ? _jsx("aside", { className: "shrink-0", children: aside }) : null] }), bottomBar != null ? (_jsx("div", { ref: bottomBarRef, className: "border-line-soft sticky bottom-0 z-40 border-t pb-[env(safe-area-inset-bottom,0px)] md:hidden", children: _jsx(BottomBarSlotContext.Provider, { value: true, children: bottomBar }) })) : null] })] }) }));
+});
+//# sourceMappingURL=AppShell.js.map

package/dist/components/app-shell/AppShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../../src/components/app-shell/AppShell.tsx"],"names":[],"mappings":"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"}

package/dist/components/app-shell/MobileTabBar.d.ts

@@ -0,0 +1,130 @@
+import { type ComponentPropsWithoutRef, type ReactElement, type ReactNode } from "react";
+import type { AccessibleName } from "../../lib/accessible-name.js";
+interface MobileTabBarBaseProps extends Omit<ComponentPropsWithoutRef<"nav">, "aria-label" | "aria-labelledby"> {
+    /** Пункты полосы — обычно `MobileTabBarItem`; делят ширину поровну. */
+    children: ReactNode;
+}
+/**
+ * Имя навигации: `aria-label` или `aria-labelledby`, но не оба (`AccessibleName`).
+ *
+ * Необязательное — `Partial`: не задано ни то ни другое, и имя берётся из
+ * каталога сообщений («Разделы»). Видимой подписи у полосы нет, поэтому и
+ * `label` нет: в ките он значит только видимую подпись.
+ */
+export type MobileTabBarProps = MobileTabBarBaseProps & Partial<AccessibleName>;
+/**
+ * Подложка полосы: в слоте `bottomBar` — с хвостом на высоту выреза, вне слота
+ * — ровно по полосе. Разница и есть контракт, которого jsdom иначе не увидит
+ * (`env()` он не считает), поэтому словарь, а не условие внутри строки: тест
+ * сверяет класс с ним (`docs/conventions.md`, «Что проверяют тесты»).
+ *
+ * @internal Экспорт для теста; из пакета не выходит.
+ */
+export declare const BACKDROP_CLASS: {
+    readonly inSlot: "bg-bg-1 absolute inset-x-0 top-0 bottom-[calc(-1*env(safe-area-inset-bottom,0px))] -z-10";
+    readonly standalone: "bg-bg-1 absolute inset-0 -z-10";
+};
+/**
+ * Нижняя полоса главных разделов для телефона: пункты в ряд, поровну.
+ *
+ * ЧЕГО ЗДЕСЬ НЕТ, И ЭТО РЕШЕНИЕ. Ни `fixed`, ни скрытия на `md` и шире, ни
+ * отступа под вырез экрана: всё это даёт слот `bottomBar` у `AppShell`, и
+ * полоса, повторившая любое из трёх, разошлась бы с каркасом молча — отступ
+ * под вырез, например, оказался бы двойным. Вне `AppShell` полоса — обычная
+ * строка в потоке: положить её можно куда угодно, но тогда прилипание и
+ * скрытие остаются на потребителе.
+ *
+ * ПОДЛОЖКА — токен поверхности кита, без размытия: `backdrop-filter` на
+ * каждом мобильном экране стоит перерисовки при прокрутке, а читаемость
+ * подписей ему не нужна. В слоте `bottomBar` подложка спускается ниже полосы на
+ * высоту выреза: отступ под него добавляет обёртка слота, и подложка,
+ * обрезанная по самой полосе, оставляла бы под ней прозрачную щель, сквозь
+ * которую виден уезжающий контент. Вне слота отступа нет, и подложка ровно по
+ * полосе — иначе на телефоне с вырезом она перекрыла бы то, что стоит под
+ * полосой в потоке. Где стоит полоса, говорит `BottomBarSlotContext`.
+ *
+ * Маршрутизации не знает вовсе, как и `NavItem`: адрес приходит элементом
+ * через `asChild`, текущий пункт — пропом `active` (ADR-0018).
+ */
+export declare const MobileTabBar: import("react").ForwardRefExoticComponent<MobileTabBarProps & import("react").RefAttributes<HTMLElement>>;
+interface MobileTabBarItemBaseProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
+    /**
+     * Подпись пункта — и его доступное имя, целиком, даже когда на экране она
+     * обрезана многоточием.
+     *
+     * Отдельным пропом, а не содержимым, по той же причине, что у `NavItem`:
+     * подпись компонент обязан завернуть сам, а содержимое при `asChild`
+     * принадлежит потомку.
+     */
+    label: ReactNode;
+    /** Иконка над подписью; скрыта от скринридера, к её углу крепится значок `badge`. */
+    icon?: ReactNode;
+    /**
+     * Текущий раздел: `aria-current="page"`.
+     *
+     * Проп, а не вычисление: кит не знает маршрутизатора и правил сравнения
+     * путей (хвостовой слэш, вложенные маршруты, локаль в префиксе). Ошибка тут
+     * выражается не падением, а тихо неподсвеченным пунктом — ADR-0018.
+     * Называется `active`, как у `NavItem`: одна и та же идея в двух пунктах
+     * навигации не должна иметь двух имён. Атрибут `aria-current` ставится от него.
+     */
+    active?: boolean;
+    /**
+     * Вывести пункт дочерним элементом: `next/link`, `<Link>` роутера. Иконка и
+     * подпись уезжают внутрь потомка через `Slottable`, поэтому потомок
+     * передаётся пустым: `<MobileTabBarItem label="…" asChild><Link href="/x" /></MobileTabBarItem>`.
+     */
+    asChild?: boolean;
+    /** Нужен только при `asChild`: там это пустой потомок-ссылка, в который уезжают иконка и подпись. */
+    children?: ReactNode;
+}
+/**
+ * Значок: штатный или свой.
+ *
+ * ШТАТНЫЙ — число, `true` или строка. Число показывает счётчик (больше 99 —
+ * «99+»), `true` — точку «есть новое», строка — короткую надпись в той же
+ * «таблетке» `Badge`. `0`, `false` и пустая строка — ничего: пункт без новостей
+ * не должен носить пустой кружок. Положение, предел и текст для скринридера
+ * здесь решает компонент: у вкладки значок лежит поверх иконки.
+ *
+ * СВОЙ — любой элемент (`<Badge tone="success">`, иконка), встаёт в угол
+ * иконки как есть. Тогда `badgeLabel` ОБЯЗАТЕЛЕН, и это сказано типом: значок
+ * спрятан от скринридера вместе с иконкой, и свой узел без текста звучал бы как
+ * отсутствие значка. Видимое содержимое чужого узла кит прочитать за
+ * потребителя не может — это может быть картинка.
+ */
+export type MobileTabBarItemProps = MobileTabBarItemBaseProps & ({
+    /** Штатный значок: число — счётчик, `true` — точка, строка — короткая надпись; `0`, `false` и пустая строка — без значка. */
+    badge?: number | boolean | string | null;
+    /**
+     * Текст значка для скринридера вместо «Новых: 3» из каталога (или
+     * вместо самой строки), когда значку нужен смысл («3 непрочитанных
+     * сообщения»). Значок на экране остаётся тем же. Обязателен, если
+     * `badge` — свой элемент.
+     */
+    badgeLabel?: string;
+} | {
+    /** Свой значок — любой элемент; встаёт в угол иконки как есть, `badgeLabel` тогда обязателен. */
+    badge: ReactElement;
+    /**
+     * Текст значка для скринридера вместо «Новых: 3» из каталога (или
+     * вместо самой строки), когда значку нужен смысл («3 непрочитанных
+     * сообщения»). Значок на экране остаётся тем же. Обязателен, если
+     * `badge` — свой элемент.
+     */
+    badgeLabel: string;
+});
+/**
+ * Пункт нижней полосы: иконка над подписью, поверх иконки — счётчик.
+ *
+ * ПОДПИСЬ — СТУПЕНЬ `text-caption` (11px) И ОБРЕЗАЕТСЯ МНОГОТОЧИЕМ. Это
+ * измеренный компромисс, а не недосмотр: потребитель замерил, что на 360px
+ * колонка вкладки при пяти пунктах даёт 50px под подпись, а «Библиотека» и
+ * «Расписание» на 11px занимают 64–65px против 58–59px на 10px, — то есть
+ * две подписи из пяти обрезаются, и он держит у себя 10px мимо шкалы. Кит идёт
+ * по шкале; нужна ли полосе своя ступень, решит первое внедрение.
+ * Обрезка вредит глазу, но не слуху: полная подпись остаётся доступным именем.
+ */
+export declare const MobileTabBarItem: import("react").ForwardRefExoticComponent<MobileTabBarItemProps & import("react").RefAttributes<HTMLAnchorElement>>;
+export {};
+//# sourceMappingURL=MobileTabBar.d.ts.map

package/dist/components/app-shell/MobileTabBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileTabBar.d.ts","sourceRoot":"","sources":["../../../src/components/app-shell/MobileTabBar.tsx"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAMnE,UAAU,qBAAsB,SAAQ,IAAI,CAC1C,wBAAwB,CAAC,KAAK,CAAC,EAC/B,YAAY,GAAG,iBAAiB,CACjC;IACC,uEAAuE;IACvE,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;CAIjB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,2GAwBvB,CAAC;AAEH,UAAU,yBAA0B,SAAQ,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IACzF;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,GAC3D,CACI;IACE,6HAA6H;IAC7H,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACD;IACE,iGAAiG;IACjG,KAAK,EAAE,YAAY,CAAC;IACpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CACJ,CAAC;AAgBJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,qHA6G5B,CAAC"}

package/dist/components/app-shell/MobileTabBar.js

@@ -0,0 +1,50 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Slot, Slottable } from "@radix-ui/react-slot";
+import { forwardRef, isValidElement, useContext, } from "react";
+import { useMessages } from "../../i18n/useMessages.js";
+import { BottomBarSlotContext } from "../../lib/bottom-bar-slot.js";
+import { cn } from "../../lib/cn.js";
+import { devWarn } from "../../lib/dev-warn.js";
+import { Badge } from "../content/Badge.js";
+export const BACKDROP_CLASS = {
+    inSlot: "bg-bg-1 absolute inset-x-0 top-0 bottom-[calc(-1*env(safe-area-inset-bottom,0px))] -z-10",
+    standalone: "bg-bg-1 absolute inset-0 -z-10",
+};
+export const MobileTabBar = forwardRef(function MobileTabBar({ "aria-label": ariaLabel, "aria-labelledby": labelledBy, children, className, ...rest }, ref) {
+    const messages = useMessages();
+    const inSlot = useContext(BottomBarSlotContext);
+    return (_jsxs("nav", { ref: ref, "aria-label": labelledBy ? undefined : ariaLabel || messages.mobileTabBar.label, "aria-labelledby": labelledBy || undefined, className: cn("relative isolate flex items-stretch justify-around", className), ...rest, children: [_jsx("div", { "aria-hidden": true, className: inSlot ? BACKDROP_CLASS.inSlot : BACKDROP_CLASS.standalone }), children] }));
+});
+const BASE = "focus-visible:outline-accent-strong text-caption relative flex min-w-0 flex-1 flex-col " +
+    "items-center gap-0.5 px-1 py-2 font-medium no-underline transition-colors " +
+    "focus-visible:outline-2";
+const STATE = {
+    active: "text-accent-strong before:bg-accent-strong before:absolute before:inset-x-3 " +
+        "before:top-0 before:h-0.5 before:rounded-full",
+    idle: "text-fg-2 hover:text-fg-0",
+};
+export const MobileTabBarItem = forwardRef(function MobileTabBarItem({ label, icon, active = false, badge, badgeLabel, asChild = false, children, className, ...rest }, ref) {
+    const messages = useMessages();
+    const slotted = asChild && isValidElement(children);
+    const Comp = slotted ? Slot : "a";
+    const dot = badge === true;
+    const count = typeof badge === "number" && badge > 0 ? badge : null;
+    const text = typeof badge === "string" && badge !== "" ? badge : null;
+    const custom = isValidElement(badge) ? badge : null;
+    const shown = dot || count != null || text != null || custom != null;
+    if (custom && !badgeLabel) {
+        devWarn("MobileTabBarItem: a custom element was passed as `badge` without `badgeLabel`. " +
+            "The badge is hidden from screen readers together with the icon, so it is shown " +
+            "but never announced. Pass `badgeLabel` with what the badge means, e.g. " +
+            '"Needs attention".');
+    }
+    const spoken = badgeLabel ||
+        (count != null
+            ? messages.mobileTabBar.newCount({ count })
+            : dot
+                ? messages.mobileTabBar.new
+                : text);
+    return (_jsxs(Comp, { ref: ref, "aria-current": active ? "page" : undefined, className: cn(BASE, active ? STATE.active : STATE.idle, className), ...rest, children: [icon ? (_jsxs("span", { "aria-hidden": true, className: cn("relative flex shrink-0", active ? "text-accent-strong" : "text-fg-2"), children: [icon, custom ? (_jsx("span", { className: "absolute top-[-2px] -right-1.5 flex", children: custom })) : shown ? (_jsx(Badge, { overlay: true, dot: dot, className: "top-[-2px] -right-1.5", children: count ?? text })) : null] })) : null, _jsxs("span", { className: "flex w-full min-w-0 items-center justify-center gap-1", children: [_jsx("span", { className: "min-w-0 truncate text-center", children: label }), !icon && shown ? (_jsx("span", { "aria-hidden": true, className: "flex shrink-0", children: custom ?? _jsx(Badge, { dot: dot, children: count ?? text }) })) : null] }), shown && spoken ? (_jsxs(_Fragment, { children: [" ", _jsx("span", { className: "sr-only", children: spoken })] })) : null, slotted ? _jsx(Slottable, { children: children }) : asChild ? null : children] }));
+});
+//# sourceMappingURL=MobileTabBar.js.map

package/dist/components/app-shell/MobileTabBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileTabBar.js","sourceRoot":"","sources":["../../../src/components/app-shell/MobileTabBar.tsx"],"names":[],"mappings":"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"}

package/dist/components/app-shell/NavItem.d.ts

@@ -0,0 +1,72 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+/**
+ * Схлопнутость навигации: её задаёт `SideNav`, а читает каждый пункт.
+ *
+ * Контекст, а не проп на пункте, потому что иначе потребитель протаскивал бы
+ * одно и то же значение в каждый из десяти пунктов руками — и однажды забыл бы
+ * в одном. Вне `SideNav` пункт считается развёрнутым: это состояние по
+ * умолчанию, а не признак ошибки.
+ */
+/** @internal Читают `NavItem` и `NavGroup`; частью публичного API не является. */
+export declare const NavCollapsedContext: import("react").Context<boolean>;
+/** @internal Провайдер для `SideNav`; частью публичного API не является. */
+export declare const NavCollapsedProvider: import("react").Provider<boolean>;
+export interface NavItemProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
+    /**
+     * Подпись пункта — и его доступное имя.
+     *
+     * Отдельным пропом, а не содержимым, и причина в схлопнутом режиме: там
+     * подпись прячется от глаз, но обязана остаться для скринридера, то есть
+     * компонент должен её ЗАВЕРНУТЬ. Содержимое при `asChild` принадлежит
+     * потомку, и завернуть его нельзя — у `Button` ровно поэтому подпись при
+     * `asChild` и не оборачивается.
+     */
+    label: ReactNode;
+    /** Иконка слева от подписи; скрыта от скринридера, цвет следует за состоянием `active`. */
+    icon?: ReactNode;
+    /**
+     * Пункт ведёт на текущую страницу: подсвечен и получает `aria-current="page"`.
+     *
+     * Проп, а не вычисление: кит не знает ни маршрутизатора, ни правил сравнения
+     * путей (хвостовой слэш, query, вложенные маршруты, локаль в префиксе). У
+     * каждого маршрутизатора они свои, а ошибка выражается не падением, а тихо
+     * неподсвеченным пунктом. Решение — ADR-0018.
+     */
+    active?: boolean;
+    /** Счётчик или отметка справа от подписи: `Badge`, число, точка. */
+    badge?: ReactNode;
+    /**
+     * Слот горячей клавиши — обычно `Kbd`. Прячется вместе с подписью: в
+     * иконочном режиме показывать сочетание некуда, а озвучивать его в имени
+     * пункта значит удлинять имя ради того, чего на экране нет.
+     */
+    shortcut?: ReactNode;
+    /**
+     * Вывести пункт дочерним элементом: `next/link`, `<Link>` роутера, что угодно
+     * ещё. Иконка и подпись уезжают внутрь потомка через `Slottable`, поэтому
+     * потомок передаётся пустым: `<NavItem label="…" asChild><Link href="/x" /></NavItem>`.
+     */
+    asChild?: boolean;
+    /** Нужен только при `asChild`: там это пустой потомок-ссылка, в который уезжают иконка и подпись. */
+    children?: ReactNode;
+}
+/**
+ * Пункт навигации: иконка, подпись, счётчик и слот горячей клавиши.
+ *
+ * Маршрутизации не знает вовсе — ни адреса, ни того, какой пункт сейчас
+ * открыт. И то и другое приходит снаружи: адрес элементом через `asChild` или
+ * `href`, текущий пункт — пропом `active`.
+ *
+ * В схлопнутом режиме подпись уходит из виду, но остаётся доступным именем, а
+ * рядом появляется подсказка. Прятать её `title`-атрибутом было бы дешевле и
+ * неверно: `title` не показывается при фокусе с клавиатуры и не читается
+ * частью скринридеров.
+ *
+ * ТРЕБОВАНИЕ К ПОТРЕБИТЕЛЮ: схлопнутая навигация обязана стоять внутри
+ * `TooltipProvider` — иначе Radix бросает на первом же пункте. Провайдер здесь
+ * не разворачивается сам по той же причине, по которой его не разворачивает
+ * `Segmented`: он задаёт группировку подсказок на всё приложение, и вложенный
+ * её ломает. В развёрнутом режиме подсказки нет, и требования тоже нет.
+ */
+export declare const NavItem: import("react").ForwardRefExoticComponent<NavItemProps & import("react").RefAttributes<HTMLAnchorElement>>;
+//# sourceMappingURL=NavItem.d.ts.map

package/dist/components/app-shell/NavItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavItem.d.ts","sourceRoot":"","sources":["../../../src/components/app-shell/NavItem.tsx"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf;;;;;;;GAOG;AACH,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,kCAAuB,CAAC;AAExD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,mCAA+B,CAAC;AAEjE,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IACnF;;;;;;;;OAQG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB,2FAA2F;IAC3F,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,4GAqDlB,CAAC"}