altum 0.0.2 → 0.0.4

package/docs/THEMING.md

@@ -91,8 +91,6 @@ return (
 | `--altum-g-font-size-3xl` | 24px | Display (`Title` h2) |
 | `--altum-g-font-size-4xl` | 32px | Display (`Title` h1) |
 | `--altum-g-font-weight-normal` … `--altum-g-font-weight-bold` | 400–700 | Начертания |
-| `--altum-g-line-height-snug` / `--altum-g-line-height-relaxed` | → xs / base | Алиасы |
-
 В компонентах: `font-size: var(--altum-g-font-size-sm); line-height: var(--altum-g-line-height-sm);`.
 
 ### Диалог / список / опция
@@ -124,13 +122,13 @@ return (
 | `--altum-toggle-task-check-height` | 7px | Высота галочки в режиме task |
 | `--altum-toggle-radio-dot*` | sm/md/lg | Размер внутренней точки Radio |
 | `--altum-toggle-align-nudge` | `0.15em` | Оптическое выравнивание бокса тоггла относительно лейбла |
-| `--altum-rating-size-sm` / `md` / `lg` | 16 / 22 / 28 | Размер SVG-звезды Rating |
+| `--altum-rating-size-sm` / `md` / `lg` | 16 / 22 / 28 | Размер звезды Rating |
 | `--altum-command-palette-max-width` / `height` | 560 / 520 | Ограничение панели CommandPalette |
 | `--altum-button-group-item-min-sm` / `md` / `lg` | space-6 / 7 / 8 | Мин. ширина ButtonGroup.Item |
 | `--altum-focus-ring-width` | 2px | Толщина outline-фокуса (навигация / тогглы / выбор) |
 | `--altum-focus-ring-offset` | light 1px / dark 2px | Смещение outline-фокуса (согласовано с зазором кольца кнопки) |
 | `--altum-focus-ring-color` | light → `--altum-color-input-border-focus`; dark `rgba(248,250,252,0.55)` | Общий цвет outline-фокуса (в dark — светлая hairline, не заливка CTA) |
-| `--altum-button-focus-inner` / `--altum-button-focus-outer` | light 1px / 3px; dark 2px / 4px | Ширины двойного кольца кнопки (алиасы `--altum-color-button-focus-*`) |
+| `--altum-button-focus-inner` / `--altum-button-focus-outer` | light 1px / 3px; dark 2px / 4px | Ширины двойного кольца кнопки |
 | `--altum-opacity-disabled` | 0.5 | Отключённые контролы; **Button** — та же заливка × opacity |
 | `--altum-field-disabled-opacity` | 0.8 | Chrome отключённого поля (текст остаётся читаемым) |
 | `--altum-field-label-gap` / `--altum-field-message-gap` | `--altum-g-space-1` | Зазор внешнего лейбла / helper+ошибка |
@@ -177,7 +175,7 @@ return (
 | Переменная | По умолчанию | Кто использует |
 |------------|--------------|----------------|
 | `--altum-g-z-below` | `-1` | Линия-коннектор Steps |
-| `--altum-g-z-raised` | `1` | Слайдер SegmentedControl |
+| `--altum-g-z-raised` | `1` | Слайдер ButtonGroup / SegmentedControl |
 | `--altum-g-z-raised-above` | `2` | Контент кнопки, контролы NumberField |
 | `--altum-g-z-control` | `5` | Бегунок Slider |
 | `--altum-g-z-local` | `10` | Badge, липкий заголовок таблицы, маска TextField |
@@ -195,7 +193,7 @@ return (
 |---------|---------|------------|
 | `tooltip` | `--altum-g-z-tooltip` | `--altum-overlay-offset-tooltip` (8px) |
 | `popover` | `--altum-g-z-dropdown` | `--altum-overlay-offset-popover` (8px) |
-| `dropdown` | `--altum-g-z-dropdown` | `--altum-overlay-offset-dropdown` (4px) |
+| `dropdown` | `--altum-g-z-dropdown` | `--altum-overlay-offset-dropdown` (8px) |
 | `modal` | `--altum-g-z-modal` | — |
 | `sheet` | `--altum-g-z-overlay` | — |
 | `lightbox` | `--altum-g-z-lightbox` | — |
@@ -216,7 +214,7 @@ return (
 
 ### Тонированный (`--altum-color-brand-tint-*`)
 
-Приглушённый акцентный вариант (Apple-style Tinted / Light): заливка ~16% от акцента, текст остаётся ярким и контрастным. Используется в `Button` / `Chip` / `SegmentedControl` с `variant="tinted"`.
+Приглушённый акцентный вариант (Apple-style Tinted / Light): заливка ~16% от акцента, текст остаётся ярким и контрастным. Pressed заметно плотнее hover. Используется в `Button` / `Chip` / `SegmentedControl` с `variant="tinted"`.
 
 | Переменная | Назначение |
 |------------|------------|
@@ -227,7 +225,7 @@ return (
 | `--altum-color-brand-tint-border` | Рамка |
 | `--altum-color-button-border-tinted` | Рамка кнопки |
 
-Светлая заливка деструктивной кнопки использует `--altum-color-danger-bg-solid: #b91c1c` (WCAG AA с белым текстом).
+Светлая заливка деструктивной кнопки — mix red-700 со slate (`--altum-color-danger-bg-solid`), тот же регистр пыли, что статусы; AA на белом тексте.
 
 ### Вторичный (`--altum-color-surface`, `--altum-color-border`)
 
@@ -236,7 +234,7 @@ return (
 | Переменная | Назначение |
 |------------|------------|
 | `--altum-color-surface` | Фон поверхности (карточка) |
-| `--altum-color-surface-elevated` | На ступень выше surface (`Box` `elevated`; dark: `#1a1e27`) |
+| `--altum-color-surface-elevated` | На ступень выше surface (`Box` `elevated`; dark: `#262628`) |
 | `--altum-color-border` | Рамки |
 | `--altum-color-text-secondary` | Приглушённый текст |
 
@@ -256,32 +254,32 @@ TextField, Checkbox (`mode="task"`), Switch, Radio. Примитивы — ис
 
 | Переменная | Назначение |
 |------------|------------|
-| `--altum-color-input-bg` | Фон поля (dark: overlay `#242c3f`, не surface) |
+| `--altum-color-input-bg` | Фон поля (dark: overlay `#2b2b2e`, не surface) |
 | `--altum-color-input-text` | Текст поля |
 | `--altum-color-input-border` | Рамка по умолчанию |
 | `--altum-color-input-border-focus` | Рамка в фокусе |
-| `--altum-color-muted` | Плавающий лейбл (light: `#64748b`, dark: `#a3b0c2`) |
+| `--altum-color-muted` | Плавающий лейбл (light: `#64748b`, dark: `#A8A8B3`) |
 | `--altum-color-control-bg` | Фон checkbox/radio |
 | `--altum-color-control-bg-checked` | Состояние checked |
 | `--altum-color-control-text-color` | Текст лейбла контрола |
 
 ### Chrome элементов (`--altum-field-*`, `--altum-color-button-*`, `--altum-color-chip-*`, `--altum-color-segmented-*`, `--altum-color-panel-*`, `--altum-type-*`, `--altum-color-link-*`)
 
-Компоненты читают токены **элементов**. Значения по умолчанию — алиасы примитивов выше. Адаптивные варианты `Box` (`outlined` / `elevated` / `tinted` / `secondary` / `muted` / `glass` / `overlay`) переопределяют кнопки, чипы и панели для потомков через CSS-каскад. Поля и тогглы в dark оставляют глобальный overlay-fill (lift над карточкой); `overlay` по-прежнему даёт frosted chrome.
+Компоненты читают токены **элементов**. Значения по умолчанию — алиасы примитивов выше. `Box` красит только себя: вложенные кнопки, чипы, поля и текст остаются на этой глобальной палитре на любой заливке.
 
 | Группа | Примеры |
 |--------|---------|
 | Поле | `--altum-color-field-bg`, `--altum-color-field-border`, `--altum-color-border-hover`, `--altum-color-field-text`, `--altum-field-label` |
 | Кнопка (secondary / tinted / ghost) | `--altum-color-button-secondary-bg`, `--altum-color-button-tinted-border`, `--altum-color-button-ghost-text` (muted, не secondary), `--altum-color-button-ghost-hover-bg` |
 | Chip | `--altum-color-chip-secondary-bg`, `--altum-color-chip-tinted-text` |
-| Segmented | `--altum-color-segmented-*` (алиасы на `--altum-color-button-*`); primary active: `--altum-color-segmented-primary-slider-bg` (в dark контрастнее трека) |
+| Segmented | `--altum-color-segmented-*`: колодец (`*-track-bg`) + приглушённый thumb (`*-slider-bg`, `--altum-color-segmented-slider-shadow`). Один thumb на secondary / tinted / ghost |
 | Панель | `--altum-color-panel-bg`, `--altum-color-panel-border`, `--altum-color-panel-bg-hover` |
-| Типографика | `--altum-color-type`, `--altum-color-type-secondary`, `--altum-color-type-muted` (`Title` / `Text`) |
+| Типографика | `--altum-color-type`, `--altum-color-type-secondary`, `--altum-color-type-tertiary`, `--altum-color-type-muted` (`Title` / `Text`) |
 | Ссылка | `--altum-color-link-color`, `--altum-color-link-secondary`, `--altum-color-link-muted`, `--altum-color-link-danger`, `--altum-color-link-focus-ring` |
 | Tooltip | `--altum-color-tooltip-bg` / `--altum-color-tooltip-fg` (инверсия ink, не brand-кнопка) |
 | Индикатор Tabs / Pagination | `--altum-color-tabs-indicator` |
 
-Primary- и danger-кнопки остаются на `--altum-color-brand-*` / `--altum-color-danger-*` (Box их не перемапливает). Ремап типографики/ссылок сильнее всего на `tinted` и `overlay`.
+Primary- и danger-кнопки остаются на `--altum-color-brand-*` / `--altum-color-danger-*`.
 
 ### Поверхности
 
@@ -292,7 +290,7 @@ Primary- и danger-кнопки остаются на `--altum-color-brand-*` /
 | `--altum-color-dropdown-bg` | Modal / Sheet / выпадающие панели (dark: elevated, не overlay полей) |
 | `--altum-color-option-hover` | Фоны при наведении |
 | `--altum-color-selection-fill` / `--altum-color-selection-fill-fg` / `--altum-color-selection-fill-emphasis` | Акцентный выбранный chrome (Segmented primary, Chip primary/tinted active) |
-| `--altum-color-selection-neutral-fill` / `--altum-color-selection-neutral-border` / `--altum-color-selection-neutral-slider` | Мягкий выбранный chrome (Segmented secondary, Chip secondary active) |
+| `--altum-color-selection-neutral-fill` / `--altum-color-selection-neutral-border` / `--altum-color-selection-neutral-slider` | Мягкий выбранный chrome: Chip secondary active; slider — приподнятый thumb Segmented / ButtonGroup |
 | `--altum-color-empty-icon` | Чернила иллюстрации EmptyState (`--altum-color-text-secondary`) |
 
 ## Тёмная тема
@@ -315,4 +313,4 @@ const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
 <ThemeProvider initialTheme={prefersDark ? 'dark' : 'light'} />
 ```
 
-Тёмная primary — плотный steel (`--altum-color-brand: #4e6480`, hover `#5d7694`, текст `--altum-g-color-slate-50`), без инверсии светлой заливки и без мытого `#6b7f98` на CTA. Ссылки в dark — `--altum-color-link-color` `#cbd5e1` (ярче Ghost/muted `#a3b0c2`); `Button` `link` / `Link` — idle underline 1px при ~45% currentColor, полная на hover. Ghost — muted, метрика кнопки, hover-смывка. Лестница поверхностей: canvas `--altum-color-bg` `#11151c` (navy) → surface `#151920` → elevated / диалоги `#1a1e27` (приглушённый холодный серо-navy) → overlay/поля `#242c3f`; hover опции `#2f374d`; pressed `--altum-color-surface-active` `#11151a`. Скрам оверлея — navy `rgba(11, 15, 24, 0.72)`, не чистый чёрный. Инпут — заливка overlay `#242c3f` (не surface; поле ≠ карточка), idle-рамка `color-mix(#ffffff 26%)`; фокус поля — `--altum-color-input-border-focus` (`#6b7f98`). Кольцо Tab — `--altum-focus-ring-color` `rgba(248,250,252,0.55)` 2px / offset 2px, не steel-заливка. Tinted — смывка `#94a3b8` ~22%, текст `#cbd5e1`. Статусы в dark — чуть чище пыль (success `#53b689`, info `#6594be`, warning `#d1a54e`, error `#cf7379`); Alert / Chip — mix 14% на surface + hairline 26%, fg = пигмент; hover чипа — `--altum-color-status-*-bg-hover` на surface. Danger secondary / tinted в dark — едва тёплый подтон на surface (~9–16%), не twin обычного secondary и не неон. Выбранная строка / день — `--altum-color-selection-fill` (brand 42% на overlay), светлые чернила. Tooltip — `--altum-color-tooltip-bg` `#293244`, не brand-кнопка. Рамки Checkbox / Radio — `--altum-color-control-border` → `--altum-color-input-border`; галочка на заливке — `#f1f5f9`. Overlay close — ghost без диска.
+Тёмная primary — плотный steel (`--altum-color-brand: #4e6480`, hover `#5d7694`, текст `--altum-g-color-slate-50`), без инверсии светлой заливки и без мытого `#6b7f98` на CTA. Ссылки в dark — `--altum-color-link-color` `#9aafc4` (steel, не почти-белый; Ghost/лейбл muted `#A8A8B3`, secondary `#C5C9D1`); `Button` `link` / `Link` — idle underline 1px при ~72% currentColor, полная на hover. Ghost — muted, без линии, метрика кнопки, hover-смывка. Лестница поверхностей: canvas `--altum-color-bg` `#141416` (нейтральный charcoal в климате steel) → surface `#1f1f22` → elevated / диалоги `#262628` → overlay/поля `#2b2b2e`; hover опции `#2d2d30`; pressed `--altum-color-surface-active` `#1a1a1c`. Скрам оверлея — `rgba(10, 10, 12, 0.72)`, не чистый чёрный. Контролы на оверлее — `--altum-overlay-control-bg` → input-bg, рамка → input-border, hover → option-hover. Инпут — заливка overlay `#2b2b2e` (не surface; поле ≠ карточка), idle-рамка `color-mix(#ffffff 17%)`; фокус поля — `--altum-color-input-border-focus` (`#6b7f98`). Кольцо Tab — `--altum-focus-ring-color` `rgba(248,250,252,0.72)` 2px / offset 2px, не steel-заливка. Tinted — mix brand на surface (~26 / 34 / 54% idle / hover / pressed), текст `#c8d3e4`. Статусы в dark — пыль без неона (success `#53b689`, info `#5b8cba`, warning `#c4a05e`, error `#cf7379`); Alert / Chip — mix 14% на surface + hairline 26%, fg = пигмент; hover чипа — `--altum-color-status-*-bg-hover` на surface. Danger fill в dark — пыльная роза `#8f4e53` (тот же hue, что error). Danger secondary / tinted в dark — едва тёплый подтон на surface (~9–16%), не twin обычного secondary и не неон. Выбранная строка / день — `--altum-color-selection-fill` (brand 42% на overlay), светлые чернила. Tooltip — `--altum-color-tooltip-bg` `#303033`, не brand-кнопка. Рамки Checkbox / Radio — `--altum-color-control-border` → `--altum-color-input-border`; галочка на заливке — `#f1f5f9`. Overlay close — ghost без диска. Вторичный текст `#C5C9D1`; лейблы / Ghost / muted `#A8A8B3`; `Text` tertiary / muted `#8C8C99`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "altum",
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"description": "Библиотека React + TypeScript UI-компонентов: CSS Modules, токены ThemeProvider, адаптация overlay/sheet.",
 	"license": "MIT",
 	"author": "Alexander <azeeson@gmail.com>",

package/types/entries/hooks.d.ts

@@ -1,255 +1,69 @@
 import * as react from 'react';
 import { RefObject, PointerEvent, MouseEvent as MouseEvent$1 } from 'react';
 
-/**
- * Опции хука `useOutsideClick`.
- */
 interface UseOutsideClickOptions {
-    /** Подписываться только пока `true` (`true` по умолчанию) */
     enabled?: boolean;
 }
 type OutsideClickTarget = RefObject<HTMLElement | null>;
-/**
- * Вызывает callback при mousedown/touchstart вне одного или нескольких ref.
- * Игнорирует клики, пока активен «suppress overlay dismiss» (см. `overlayDismiss`).
- * Подписка снимается при `enabled: false` и при размонтировании.
- *
- * @param refs - Контейнер(ы), клик внутри которых не считается «снаружи».
- * @param callback - Обработчик внешнего клика.
- * @param options.enabled - Выключить слушатели без размонтирования.
- *
- * @returns Ничего — подписка на mousedown/touchstart вне ref.
- *
- * @example
- * const panelRef = useRef<HTMLDivElement>(null);
- * useOutsideClick(panelRef, () => setOpen(false), {enabled: open});
- */
 declare function useOutsideClick(refs: OutsideClickTarget | OutsideClickTarget[], callback: (event: MouseEvent | TouchEvent) => void, options?: UseOutsideClickOptions): void;
 
-/**
- * Публичный тип `DocumentKeyDownTarget`.
- */
 type DocumentKeyDownTarget = 'document' | 'window';
-/**
- * Опции хука `useDocumentKeyDown`.
- */
 interface UseDocumentKeyDownOptions {
-    /** Слушать события только пока `true` (`true` по умолчанию) */
     enabled?: boolean;
-    /** `document` или `window` — где вешать `keydown` (`document` по умолчанию) */
     target?: DocumentKeyDownTarget;
 }
-/**
- * Подписка на глобальный `keydown` с актуальным handler через ref
- * (не нужно мемоизировать handler ради стабильности подписки).
- *
- * @param handler - Обработчик клавиатуры.
- * @param options - `enabled` / `target`.
- *
- * @returns Ничего — подписка на глобальный keydown.
- *
- * @example
- * useDocumentKeyDown((event) => {
- *   if (event.key === 'ArrowDown') moveFocus(1);
- * }, {enabled: isOpen});
- */
 declare function useDocumentKeyDown(handler: (event: KeyboardEvent) => void, options?: UseDocumentKeyDownOptions): void;
 
-/**
- * Опции хука `useEscapeKey`.
- */
 interface UseEscapeKeyOptions {
     enabled?: boolean;
     target?: DocumentKeyDownTarget;
-    /**
-     * Участвовать в стеке overlay: Escape закрывает только верхний слой.
-     * @default true
-     */
     layered?: boolean;
 }
-/**
- * Вызывает `onEscape` на клавишу Escape (с `preventDefault`).
- * При `layered` (дефолт) закрывается только верхний overlay в стеке.
- *
- * @param onEscape - Действие закрытия.
- * @param options.enabled - Пока `false`, слушатель не активен.
- *
- * @example
- * useEscapeKey(() => setOpen(false), {enabled: open});
- */
 declare function useEscapeKey(onEscape: () => void, options?: UseEscapeKeyOptions): void;
 
-/**
- * Блокирует scroll `document.body` со счётчиком вложений
- * (несколько Modal / Sheet / ImageCrop одновременно).
- * Снимает lock при `locked === false` и при размонтировании.
- *
- * @param locked - Активна ли блокировка для этого экземпляра.
- *
- * @returns Ничего — lock scroll на document.body.
- *
- * @example
- * useBodyScrollLock(isOpen);
- */
 declare function useBodyScrollLock(locked: boolean): void;
 
-/**
- * Контролируемое / неконтролируемое состояние для компонентов с опциональными `value` + `defaultValue`.
- *
- * @returns `[value, setValue, isControlled]`
- */
 declare function useControlledState<T>(controlled: T | undefined, defaultValue: T): [T, (next: T) => void, boolean];
-/**
- * Контролируемое / неконтролируемое состояние с колбэком при изменении (onChange / onOpenChange).
- */
 declare function useControlledStateWithCallback<T>(controlled: T | undefined, defaultValue: T, onChange?: (next: T) => void): [T, (next: T) => void, boolean];
 
-/**
- * Опции хука `useOverlay`.
- */
+declare function useNow(intervalMs: number): Date;
+
 interface UseOverlayOptions {
-    /** Overlay открыт. */
     open: boolean;
-    /** Закрытие по Escape. @default true */
     closeOnEscape?: boolean;
-    /** Блокировать scroll body. @default true */
     lockScroll?: boolean;
-    /** Корень портала для inert фона. */
     rootRef?: RefObject<HTMLElement | null>;
-    /** Возврат фокуса при закрытии. @default true */
     restoreFocus?: boolean;
 }
-/**
- * Композиция overlay-паттерна: scroll lock + Escape + inert + restore focus.
- * Используется в Modal, Sheet, CommandPalette, ImageLightbox, ImageCrop.
- */
 declare function useOverlay(onClose: () => void, { open, closeOnEscape, lockScroll, rootRef: rootRefProp, restoreFocus, }: UseOverlayOptions): void;
 
-/**
- * Сохраняет фокус при активации (в `useLayoutEffect` — до ловушек в `useEffect`)
- * и возвращает его только при переходе `true` → `false`.
- * Используйте для overlay, где FocusTrap сам restore не делает.
- *
- * @param active - Панель открыта.
- *
- * @returns Ничего — сохранение и возврат фокуса.
- *
- * @example
- * useFocusRestore(isOpen);
- */
 declare function useFocusRestore(active: boolean): void;
 
-/**
- * Помечает соседние узлы родителя `rootRef` как `inert`,
- * пока overlay-панель открыта (фон недоступен для фокуса / AT).
- * Снимает `inert` при деактивации / размонтировании (если атрибут ставил этот хук).
- *
- * @param active - Панель открыта.
- * @param rootRef - Корень портала панели (sibling'и получают `inert`).
- *
- * @returns Ничего — атрибут inert на соседних узлах.
- *
- * @example
- * useInertSiblings(isOpen, portalRootRef);
- */
 declare function useInertSiblings(active: boolean, rootRef: RefObject<HTMLElement | null>): void;
 
-/**
- * Опции хука `useOverlayPanel`.
- */
 interface UseOverlayPanelOptions {
     active: boolean;
-    /** Корень портала панели (sibling'и родителя получат `inert`) */
     rootRef: RefObject<HTMLElement | null>;
-    /**
-     * Возврат фокуса при закрытии.
-     * Выключайте, если restore уже делает FocusTrap / useFocusTrap.
-     * @default true
-     */
     restoreFocus?: boolean;
 }
-/**
- * Единый паттерн для overlay-панелей: inert фона + опционально restore focus.
- * Комбинирует `useInertSiblings` и `useFocusRestore`.
- *
- * @param options.active - Панель открыта.
- * @param options.rootRef - Корень портала.
- * @param options.restoreFocus - Возврат фокуса при закрытии (`true` по умолчанию).
- *
- * @returns Ничего — inert фона и опциональный restore focus.
- *
- * @example
- * useOverlayPanel({active: isOpen, rootRef, restoreFocus: true});
- */
 declare function useOverlayPanel({ active, rootRef, restoreFocus, }: UseOverlayPanelOptions): void;
 
-/**
- * Опции хука `useFocusTrap`.
- */
 interface UseFocusTrapOptions {
     active: boolean;
-    /** Контейнер, внутри которого крутится Tab */
     containerRef: RefObject<HTMLElement | null>;
-    /** Элемент для начального фокуса (иначе — первый focusable) */
     initialFocusRef?: RefObject<HTMLElement | null>;
-    /** Куда вернуть фокус при деактивации (иначе — элемент до активации) */
     returnFocusRef?: RefObject<HTMLElement | null>;
-    /**
-     * Возвращать фокус при деактивации.
-     * Выключайте, если restore делает `useOverlayPanel` / `useFocusRestore`.
-     * @default true
-     */
     restoreFocus?: boolean;
-    /** Escape внутри ловушки */
     onEscape?: () => void;
 }
-/**
- * Ловушка фокуса без обёртки-компонента: Tab циклится внутри `containerRef`.
- * Подходит для уже существующего DOM (CommandPalette, кастомные панели).
- * Escape опционально через `onEscape`.
- *
- * @param options - `active`, `containerRef`, focus refs, `restoreFocus`, `onEscape`.
- *
- * @returns Ничего — ловушка Tab и опциональный Escape.
- *
- * @example
- * useFocusTrap({
- *   active: open,
- *   containerRef,
- *   initialFocusRef: inputRef,
- *   onEscape: () => setOpen(false),
- * });
- */
 declare function useFocusTrap({ active, containerRef, initialFocusRef, returnFocusRef, restoreFocus, onEscape, }: UseFocusTrapOptions): void;
 
-/**
- * Media query для «мобильной» ширины (breakpoint 768px).
- * Используйте с `useMediaQuery(MOBILE_MEDIA_QUERY)`.
- */
 declare const MOBILE_MEDIA_QUERY = "(max-width: 768px)";
-/**
- * Подписка на CSS media query через `matchMedia`.
- * На SSR / первом кадре может быть `false`, пока нет `window`.
- *
- * @param query - Строка media query (например `(min-width: 1024px)`).
- * @returns `true`, если query сейчас совпадает.
- *
- * @example
- * const isMobile = useMediaQuery(MOBILE_MEDIA_QUERY);
- * if (isMobile) return <Sheet />;
- */
 declare function useMediaQuery(query: string): boolean;
 
 interface UseLongPressOptions {
-    /** Задержка до срабатывания, мс. @default 500 */
     delay?: number;
-    /** Не запускать long-press. */
     disabled?: boolean;
-    /**
-     * Смещение (px), после которого жест отменяется.
-     * Слушается на `window`, чтобы срабатывать даже при nested touch/swipe.
-     * @default 10
-     */
     moveThreshold?: number;
 }
 interface UseLongPressHandlers {
@@ -258,62 +72,26 @@ interface UseLongPressHandlers {
     onPointerCancel: (event: PointerEvent) => void;
     onContextMenu: (event: MouseEvent$1) => void;
     onClick: (event: MouseEvent$1) => void;
-    /** Сбросить таймер (например, при начале горизонтального свайпа). */
     cancel: () => void;
 }
-/**
- * Long-press (удержание): вызывает `onLongPress` после `delay` мс.
- * Движение отслеживается на `window` (pointer + touch), чтобы nested
- * `touchmove` / `preventDefault` у свайпа не оставляли таймер живым.
- * После срабатывания подавляет следующий `click` (capture + `onClick`).
- */
 declare function useLongPress(onLongPress: () => void, options?: UseLongPressOptions): UseLongPressHandlers;
 
-/** CSS media query для `prefers-reduced-motion: reduce`. */
 declare const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
-/**
- * Отслеживает системную настройку «уменьшить движение».
- * Подписывается на `matchMedia` через `useMediaQuery`.
- *
- * @returns `true`, если пользователь просит уменьшить анимации.
- *
- * @example
- * const reduceMotion = usePrefersReducedMotion();
- * <motion.div animate={reduceMotion ? false : {opacity: 1}} />
- */
 declare function usePrefersReducedMotion(): boolean;
 
-/**
- * Правила валидации поля формы для `useForm.register`.
- * При нескольких правилах ошибка берётся по приоритету: required → pattern → validate.
- */
+declare function usePresence(open: boolean, durationMs: number): {
+    shouldRender: boolean;
+    presented: boolean;
+};
+
 interface ValidationRules {
-    /** Текст ошибки, если значение пустое (`undefined` / `null` / `''`; `0` — не пустое) */
     required?: string;
     pattern?: {
         value: RegExp;
         message: string;
     };
-    /**
-     * Верните строку ошибки, `true` (ок) или `false`.
-     * `false` — провал: текст `required`, иначе `'Invalid'`.
-     */
     validate?: (val: unknown) => string | boolean;
 }
-/**
- * Лёгкий хелпер контролируемых форм: хранит values/errors и фабрику `register`.
- * Не делает submit — только локальный стейт и валидацию на change.
- *
- * @template T - Форма как объект полей (ключи → значения).
- * @param initialValues - Начальные значения; ключи = имена полей.
- * @returns `values`, `errors`, `register`, `hasErrors`, `setValues`.
- *
- * @example
- * import {useForm} from 'altum/hooks';
- *
- * const {values, errors, register, hasErrors} = useForm({email: ''});
- * <TextField {...register('email', {required: 'Обязательно'})} error={errors.email} />
- */
 declare function useForm<T extends Record<string, unknown>>(initialValues: T): {
     values: T;
     errors: Record<string, string>;
@@ -325,5 +103,5 @@ declare function useForm<T extends Record<string, unknown>>(initialValues: T): {
     setValues: react.Dispatch<react.SetStateAction<T>>;
 };
 
-export { MOBILE_MEDIA_QUERY, REDUCED_MOTION_QUERY, useBodyScrollLock, useControlledState, useControlledStateWithCallback, useDocumentKeyDown, useEscapeKey, useFocusRestore, useFocusTrap, useForm, useInertSiblings, useLongPress, useMediaQuery, useOutsideClick, useOverlay, useOverlayPanel, usePrefersReducedMotion };
+export { MOBILE_MEDIA_QUERY, REDUCED_MOTION_QUERY, useBodyScrollLock, useControlledState, useControlledStateWithCallback, useDocumentKeyDown, useEscapeKey, useFocusRestore, useFocusTrap, useForm, useInertSiblings, useLongPress, useMediaQuery, useNow, useOutsideClick, useOverlay, useOverlayPanel, usePrefersReducedMotion, usePresence };
 export type { DocumentKeyDownTarget, UseDocumentKeyDownOptions, UseEscapeKeyOptions, UseFocusTrapOptions, UseLongPressHandlers, UseLongPressOptions, UseOutsideClickOptions, UseOverlayOptions, UseOverlayPanelOptions, ValidationRules };