@feugene/granularity 0.16.0 → 0.19.0

package/dist/types/src/components/GrTimeline/grTimelineStyles.d.ts

@@ -27,7 +27,7 @@ export declare const markerFilledToneClass: Record<GrTimelineTone, string>;
 /** Полая точка: обводка тоном, середина — фон страницы, чтобы ось не просвечивала. */
 export declare const markerOutlinedToneClass: Record<GrTimelineTone, string>;
 export declare const markerBaseClass = "block shrink-0 rounded-[var(--gr-radius-full)]";
-export declare const timeClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]";
+export declare const timeClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)] tabular-nums";
 export declare const titleClass = "text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] font-600 text-[var(--gr-fg)]";
 export declare const descriptionClass = "mt-0.5 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)]";
 export declare const groupTitleClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] font-600 uppercase tracking-wide text-[var(--gr-muted-fg)]";

package/dist/types/src/components/GrToaster/GrToaster.vue.d.ts

@@ -20,6 +20,11 @@ export interface GrToasterProps {
      * `F6` — рекомендация APG для перехода между «регионами» страницы.
      */
     focusHotkey?: string | false;
+    /**
+     * Смахивание тоста к своему краю экрана. Клавиатурный эквивалент — `Delete`
+     * и `Backspace` на сфокусированном тосте — остаётся и при выключенном жесте.
+     */
+    swipeDismiss?: boolean;
 }
 /**
  * Слот `actions` полностью заменяет дефолтные action-кнопки тоста. Получает сам
@@ -44,6 +49,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     regionLabel: undefined;
     width: undefined;
     focusHotkey: string;
+    swipeDismiss: boolean;
 }>>, {
     focus: typeof focus;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
@@ -53,6 +59,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     regionLabel: undefined;
     width: undefined;
     focusHotkey: string;
+    swipeDismiss: boolean;
 }>>> & Readonly<{}>, {
     width: string | number;
     placement: GrToasterPlacement;
@@ -60,6 +67,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     regionLabel: string;
     maxVisible: number;
     focusHotkey: string | false;
+    swipeDismiss: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/types/src/components/GrToaster/grToasterStyles.d.ts

@@ -1,2 +1,29 @@
 export type GrToasterPlacement = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 export declare const PLACEMENT_CLASS: Record<GrToasterPlacement, string>;
+/**
+ * Куда смахивается тост: к своему краю экрана. Стек у правого края уходит
+ * вправо, у левого — влево; смахивание «вглубь экрана» читалось бы как попытка
+ * достать что-то из-под тоста, а не выбросить его.
+ */
+export declare const SWIPE_DIRECTION: Record<GrToasterPlacement, 1 | -1>;
+/** Доля ширины тоста, после которой отпускание закрывает, а не возвращает. */
+export declare const SWIPE_THRESHOLD_RATIO = 0.25;
+/** Нижняя граница порога: на узком стеке четверть ширины слишком мала. */
+export declare const SWIPE_THRESHOLD_MIN_PX = 56;
+/**
+ * Сопротивление движению не в свою сторону. Жест остаётся живым — тост едет за
+ * пальцем, — но закрыть его «наоборот» нельзя: это была бы вторая, неочевидная
+ * дорога к тому же действию.
+ */
+export declare const SWIPE_RESISTANCE = 4;
+/**
+ * Куда уезжает отпущенный тост. Заведомо дальше своей ширины: он должен уйти
+ * за край экрана, а не остановиться на полпути.
+ */
+export declare const SWIPE_FLY_OUT_PX = 600;
+/**
+ * Смещение, на котором тост становится полностью прозрачным, — вдвое дальше
+ * порога. К моменту закрытия он уже наполовину растворён, и уход не выглядит
+ * мгновенным исчезновением.
+ */
+export declare function swipeOpacity(offset: number, threshold: number): number;

package/dist/types/src/components/GrTooltip/defaults.d.ts

@@ -3,7 +3,7 @@ import type { GrComponentSize } from '../GrConfigProvider/context';
 export interface GrTooltipConfigurableProps {
     size: GrComponentSize;
 }
-declare module '../GrConfigProvider/context' {
+declare module '../../composables/useGrComponentConfig' {
     interface GrComponentDefaultsRegistry {
         GrTooltip: GrTooltipConfigurableProps;
     }

package/dist/types/src/components/GrTree/defaults.d.ts

@@ -3,7 +3,7 @@ import type { GrComponentSize } from '../GrConfigProvider/context';
 export interface GrTreeConfigurableProps {
     size: GrComponentSize;
 }
-declare module '../GrConfigProvider/context' {
+declare module '../../composables/useGrComponentConfig' {
     interface GrComponentDefaultsRegistry {
         GrTree: GrTreeConfigurableProps;
     }

package/dist/types/src/components/GrTree/grTreeInteractionContext.d.ts

@@ -20,7 +20,6 @@ export type GrTreeInteractionEmitters<T> = {
 export type GrTreeInteractionContext<T> = {
     hoveredKey: Ref<GrTreeKey | undefined>;
     /** Клавиша узла, держащего roving-фокус (единственный tabindex=0 во всём дереве). */
-    focusedKey: Ref<GrTreeKey | undefined>;
     /**
      * Реестр DOM-узлов строк, общий на все уровни дерева. Нужен клавиатуре: без
      * него каждое нажатие стрелки обходило бы весь DOM поддерева в поисках

package/dist/types/src/components/GrTree/grTreeProps.d.ts

@@ -1,4 +1,4 @@
-import type { HTMLAttributes } from 'vue';
+import type { Component, HTMLAttributes } from 'vue';
 import type { GrTreeSize } from './grTreeStyles';
 import type { GrTreeAllowDropType, GrTreeKey, GrTreeNode } from './grTreeTypes';
 export type NodeKeyProp<T extends object> = Extract<keyof T, string>;
@@ -71,8 +71,14 @@ export type GrTreeViewProps<T extends object> = {
     /** Максимальная высота дерева со своим скроллером. Число — пиксели. */
     maxHeight?: number | string;
     highlightCurrent?: boolean;
-    expandIcon?: string;
-    collapseIcon?: string;
+    /**
+     * Иконка свёрнутого узла: Vue-компонент либо класс иконки вашей UnoCSS-сборки
+     * (`'i-lucide-plus'` — тогда нужен ваш `presetIcons`, см. `docs/installation.md`).
+     * Не задана — встроенная стрелка.
+     */
+    expandIcon?: string | Component;
+    /** Иконка раскрытого узла. Не задана — та же встроенная стрелка, повёрнутая. */
+    collapseIcon?: string | Component;
     toggleIconRotate?: boolean;
     branchLine?: boolean;
     branchLineColor?: GrTreeBranchLineColor<T>;
@@ -96,7 +102,8 @@ export type GrTreeInteractionProps<T extends object> = {
     /** На каждом уровне раскрыт максимум один узел. */
     accordion?: boolean;
     draggable?: boolean;
-    dragHandleIcon?: string;
+    /** Иконка ручки переноса: компонент, класс иконки или ничего — тогда встроенная. */
+    dragHandleIcon?: string | Component;
     allowDrop?: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, type: GrTreeAllowDropType) => boolean;
     allowDrag?: (draggingNode: GrTreeNode<T>) => boolean;
 };

package/dist/types/src/components/GrTree/safelist.d.ts

@@ -1 +1 @@
-export declare const grTreeSafelist: readonly ["i-lucide-chevron-right", "i-lucide-grip-vertical"];
+export declare const grTreeSafelist: readonly [];

package/dist/types/src/components/GrTreeSelect/defaults.d.ts

@@ -3,7 +3,7 @@ import type { GrComponentSize } from '../GrConfigProvider/context';
 export interface GrTreeSelectConfigurableProps {
     size: GrComponentSize;
 }
-declare module '../GrConfigProvider/context' {
+declare module '../../composables/useGrComponentConfig' {
     interface GrComponentDefaultsRegistry {
         GrTreeSelect: GrTreeSelectConfigurableProps;
     }

package/dist/types/src/components/shared/hotkey.d.ts

@@ -10,6 +10,10 @@
  * а палитра в закрытом состоянии не рендерит ничего. Поэтому здесь — свой
  * матчер на `window`, с тем же синтаксисом комбинаций плюс токен `mod`.
  */
+import { type HotkeyKeyView } from './hotkeyTokens';
+export { isAppleDevice } from '../../internal/keyboard';
+export { findKbdToken, GR_KBD_TOKENS } from './hotkeyTokens';
+export type { GrKbdKeyName, GrKbdTokenGroup, GrKbdTokenSpec, HotkeyKeyView } from './hotkeyTokens';
 export type ParsedCommandHotkey = {
     key: string;
     ctrl: boolean;
@@ -20,25 +24,13 @@ export type ParsedCommandHotkey = {
     mod: boolean;
 };
 export declare function parseCommandHotkey(combo: string): ParsedCommandHotkey | null;
-/** macOS определяем по платформе — от неё зависит, чем является `mod`. */
-export declare function isAppleDevice(): boolean;
 export declare function matchesCommandHotkey(event: KeyboardEvent, hotkey: ParsedCommandHotkey, apple?: boolean): boolean;
 /** Человекочитаемые клавиши для подсказки в поле ввода (`⌘` / `Ctrl`). */
 export declare function formatCommandHotkey(hotkey: ParsedCommandHotkey, apple?: boolean): string[];
-/** Одна клавиша в человекочитаемом виде. */
-export interface HotkeyKeyView {
-    /** Что видно на экране: символ (`⌘`) или слово (`Ctrl`). */
-    label: string;
-    /**
-     * Ключ читаемого имени (`gr.kbd.<name>`) для символьных клавиш. У `K` или
-     * `Ctrl` его нет — они и так читаются вслух.
-     */
-    name?: 'command' | 'option' | 'shift' | 'control' | 'enter' | 'escape';
-}
 /**
- * Токен → то, что видит пользователь. `mod` зависит от платформы: на macOS это
- * Cmd, на остальных — Ctrl. Символы отдаются вместе с ключом читаемого имени:
- * `⌘` без имени диктор произносит как «знак места интереса».
+ * Токен → то, что видит пользователь. Каталог общий с витриной и докой
+ * (`hotkeyTokens.ts`): цепочка `if` расходилась бы со списком, который читает
+ * потребитель.
  */
 export declare function formatHotkeyToken(token: string, apple: boolean): HotkeyKeyView;
 export declare function formatHotkeyTokens(tokens: readonly string[], apple: boolean): HotkeyKeyView[];

package/dist/types/src/components/shared/hotkeyTokens.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Каталог клавиш, которые понимает `keys` у `GrKbd`.
+ *
+ * Таблица, а не цепочка `if`, по двум причинам: во-первых, список — часть
+ * публичного контракта (потребителю нужно знать, что можно написать), и
+ * витрина показывает именно его, а не свою копию; во-вторых, копия в демо или
+ * в доке разошлась бы с форматтером молча.
+ */
+/** Ключи читаемых имён — `gr.kbd.<name>`. */
+export type GrKbdKeyName = 'command' | 'option' | 'shift' | 'control' | 'enter' | 'escape' | 'tab' | 'backspace' | 'delete' | 'pageUp' | 'pageDown' | 'arrowUp' | 'arrowDown' | 'arrowLeft' | 'arrowRight';
+/** Одна клавиша в человекочитаемом виде. */
+export interface HotkeyKeyView {
+    /** Что видно на экране: символ (`⌘`) или слово (`Ctrl`). */
+    label: string;
+    /**
+     * Ключ читаемого имени (`gr.kbd.<name>`) для символьных клавиш. У `K` или
+     * `Ctrl` его нет — они и так читаются вслух.
+     */
+    name?: GrKbdKeyName;
+    /** Символ (`⌘`, `↑`) или слово (`Ctrl`, `Esc`): от этого зависит склейка в одной плашке. */
+    symbol?: boolean;
+}
+/** Смысловая группа — ею витрина и дока раскладывают каталог. */
+export type GrKbdTokenGroup = 'modifier' | 'editing' | 'navigation';
+export interface GrKbdTokenSpec {
+    /** Канонический токен: его пишут в `keys`. */
+    token: string;
+    /** Что ещё принимается — синонимы и сам глиф. */
+    aliases: readonly string[];
+    group: GrKbdTokenGroup;
+    /** Вид на macOS и на остальных платформах. */
+    apple: HotkeyKeyView;
+    other: HotkeyKeyView;
+}
+export declare const GR_KBD_TOKENS: readonly GrKbdTokenSpec[];
+/** Токен или его синоним — в описание клавиши. Регистр не важен, глиф тоже принимается. */
+export declare function findKbdToken(token: string): GrKbdTokenSpec | undefined;

package/dist/types/src/components/shared/icon.d.ts

@@ -0,0 +1,13 @@
+import type { Component } from 'vue';
+/**
+ * Иконку компонент получает двумя способами, и рисуются они разными тегами.
+ *
+ * Vue-компонент пакет рисует сам — он ни от чего не зависит. Класс иконки
+ * (`i-lucide-*`) генерирует не пакет, а UnoCSS-сборка приложения: без своего
+ * `presetIcons` потребитель получит пустое место вместо картинки
+ * (`docs/installation.md`). Поэтому класс уезжает в `:class` пустого `span`,
+ * а компонент — в `:is`.
+ */
+export declare function iconTag(icon: string | Component | undefined, fallback?: string | Component): string | Component;
+/** Класс иконки, если она задана строкой; для компонента классов нет. */
+export declare function iconClass(icon: string | Component | undefined): string;

package/dist/types/src/composables/internal/dragSortGeometry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Геометрия перестановки: чистая арифметика без DOM и без реактивности.
+ *
+ * Вынесена отдельно, потому что ошибка здесь проявляется не исключением, а
+ * «элемент встал не туда» — поймать это можно только тестом на числах.
+ * Композабл `useDragSort` сводит `DOMRect` к отрезкам вдоль оси и зовёт эти
+ * функции; какой смысл у попадания, решает уже компонент.
+ */
+/** Отрезок, занимаемый элементом вдоль оси переноса. */
+export interface DragSortSpan {
+    start: number;
+    end: number;
+}
+export interface DragSortHitResult {
+    /** Индекс элемента в переданном наборе. */
+    index: number;
+    /** Доля вдоль элемента: 0 — его начало, 1 — конец. */
+    fraction: number;
+}
+/**
+ * Какой элемент под указателем и в каком месте его.
+ *
+ * Промах не отбрасывается: между строками есть зазоры, а курсор уезжает за
+ * край списка — и в обоих случаях перенос обязан продолжать показывать
+ * ближайшую цель, иначе индикатор мигает на каждом пикселе между строками.
+ *
+ * Вырожденный отрезок (нулевая высота строки) даёт `fraction: 0` — цель
+ * остаётся детерминированной, а не зависящей от направления подхода.
+ */
+export declare function hitTest(spans: readonly DragSortSpan[], position: number): DragSortHitResult | null;
+/**
+ * Куда встанет элемент, если отпустить сейчас.
+ *
+ * Верхняя половина строки — «до неё», нижняя — «после». Индекс возвращается
+ * **в терминах итогового массива**, то есть уже с поправкой на то, что
+ * перетаскиваемый элемент из него временно вынут: без поправки перенос вниз
+ * на одну позицию не двигал бы ничего.
+ */
+export declare function insertionIndex(hit: DragSortHitResult, from: number, count: number): number;
+export interface AutoScrollOptions {
+    /** Ширина чувствительной полосы у каждого края, px. По умолчанию 32. */
+    zone?: number;
+    /** Скорость на самом краю, px за кадр. По умолчанию 12. */
+    speed?: number;
+}
+/**
+ * На сколько прокрутить контейнер за кадр: отрицательное — к началу.
+ *
+ * Скорость растёт линейно по мере приближения к краю, а не включается
+ * ступенькой: ступенька на длинном списке ощущается как рывок и промахивается
+ * мимо цели.
+ */
+export declare function autoScrollDelta(viewport: DragSortSpan, position: number, options?: AutoScrollOptions): number;
+/**
+ * Перестановка без мутации входа: массив потребителя остаётся нетронутым,
+ * наружу уходит новый. `v-model` с мутацией исходного набора ломает и
+ * сравнение «было — стало», и историю в сторе потребителя.
+ */
+export declare function moveItem<T>(items: readonly T[], from: number, to: number): T[];

package/dist/types/src/composables/internal/overlayStack.d.ts

@@ -10,6 +10,9 @@
  *  - **`inert`** → ставится на модальные слои ниже последнего **модального**.
  *    Немодальный слой сверху модалку не понижает: иначе окно ушло бы в `inert`
  *    вместе со своим же открытым дропдауном и перестало отвечать.
+ *  - **высота** → `openModalCount()` поднимает floating-панель над окном, из
+ *    которого её открыли: телепортированная панель лежит рядом с корнем окна,
+ *    и статический `z-index` дропдауна оставлял её под ним.
  *
  * Вести эти две вершины в двух независимых реестрах нельзя: реестры описывают
  * один и тот же порядок и расходятся молча — достаточно оверлея, который
@@ -56,5 +59,13 @@ export declare function layerRootsAbove(id: number): HTMLElement[];
 export declare function allLayerRoots(): HTMLElement[];
 /** Сколько слоёв открыто. Для тестов и диагностики. */
 export declare function overlayStackSize(): number;
+/**
+ * Сколько **модальных** слоёв открыто прямо сейчас.
+ *
+ * Читает `useFloating`, когда считает высоту панели: панель телепортирована в
+ * общий портал и лежит рядом с корнем окна, а не внутри него, поэтому свой
+ * стек-контекст её не спасает — высоту приходится брать из порядка слоёв.
+ */
+export declare function openModalCount(): number;
 /** Тестовая/служебная очистка стека. */
 export declare function resetOverlayStack(): void;

package/dist/types/src/composables/useDragGesture.d.ts

@@ -0,0 +1,63 @@
+import type { Ref } from 'vue';
+/**
+ * Скелет указательного жеста: нажал, повёл, отпустил.
+ *
+ * Механика написана в пакете дважды дословно (`GrSlider`, `GrSplitter`) и
+ * ещё раз иначе (`GrImageViewer`), а следующие потребители известны заранее —
+ * swipe у `GrToaster`, перенос узла в `GrTree`, ресайз колонок `GrDataTable`.
+ * Дублируется при этом не разметка, а **правило**: оборванный жест не
+ * коммитит. Живя в двух копиях, оно разъезжается молча.
+ *
+ * Слушатели вешаются на `window`, а не на элемент: указатель уходит за
+ * границы дорожки и разделителя постоянно, и жест обязан это переживать.
+ * Захват (`setPointerCapture`) дал бы то же самое, но привязал бы жест к
+ * живому DOM-узлу — а он в середине жеста может перерисоваться.
+ *
+ * У жеста **два разных исхода**, и это главное, ради чего примитив заведён:
+ * `pointerup` — завершение (значение коммитится), `pointercancel` — обрыв
+ * (браузер забрал указатель: системный жест, скролл, потеря окна), и тогда
+ * состояние возвращается к тому, что было до нажатия.
+ *
+ * Осознанно **не** делает:
+ * - не вызывает `preventDefault` — в слайдере и сплиттере это гашение
+ *   выделения текста, а в панорамировании картинки помешало бы; строка
+ *   дешевле опции, меняющей поведение невидимо;
+ * - не считает координаты и дельты — это доменная арифметика компонента;
+ * - не знает про порог начала жеста: он нужен сортировке, где нажатие ещё не
+ *   означает перенос, и появится вместе с ней.
+ *
+ * ```ts
+ * const drag = useDragGesture({
+ *   disabled: () => isDisabled.value,
+ *   onStart: (event) => { activeThumb.value = nearestThumb(event) },
+ *   onMove: (event) => setValue(valueFromPointer(event), false),
+ *   onEnd: () => commit(),
+ *   onCancel: () => rollback(),
+ * })
+ *
+ * <div @pointerdown="drag.start" />
+ * ```
+ */
+export interface UseDragGestureOptions {
+    /** Жест не начинается: `disabled` / `readonly`. */
+    disabled?: () => boolean;
+    /**
+     * Нажатие прошло проверки. Вернуть `false` — жест не начинать: так
+     * отсеивается попадание мимо цели, когда `disabled` тут ни при чём.
+     */
+    onStart?: (event: PointerEvent) => boolean | void;
+    onMove: (event: PointerEvent) => void;
+    /** Жест завершён отпусканием: значение коммитится. */
+    onEnd?: (event?: PointerEvent) => void;
+    /** Жест оборван: откат к состоянию до нажатия. */
+    onCancel?: () => void;
+}
+export interface UseDragGestureReturn {
+    /** Идёт ли жест. Менять снаружи не нужно — состоянием владеет примитив. */
+    isDragging: Ref<boolean>;
+    /** Вешается на `@pointerdown` цели. */
+    start: (event: PointerEvent) => void;
+    /** Принудительное завершение. По умолчанию — как обрыв, без коммита. */
+    stop: (commit?: boolean) => void;
+}
+export declare function useDragGesture(options: UseDragGestureOptions): UseDragGestureReturn;

package/dist/types/src/composables/useDragSort.d.ts

@@ -0,0 +1,80 @@
+import type { Ref } from 'vue';
+/**
+ * Модель перестановки: перенос элемента указателем и с клавиатуры.
+ *
+ * Композабл владеет **механикой** — сессией жеста поверх `useDragGesture`,
+ * порогом начала, попаданием в элемент, автопрокруткой у краёв и состоянием
+ * переноса. **Смысл** остаётся у компонента: что считать целью (индекс вставки
+ * у списка, «до / внутрь / после» у дерева), какими клавишами это делается и
+ * что сказать в живой регион.
+ *
+ * Граница проведена так не из вкуса: у списка цель переноса — число, у дерева —
+ * пара «узел и зона», а `Space` в дереве уже занят чекбоксом. Общая у них
+ * механика, а не семантика; обобщать семантику значило бы завести опцию на
+ * каждое расхождение.
+ *
+ * Данные композабл не меняет: он сообщает «источник и цель», перестановку
+ * делает потребитель (`moveItem` из `internal/dragSortGeometry` — если она
+ * обычная).
+ *
+ * ```ts
+ * const sort = useDragSort<string, number>({
+ *   items: () => keys.value,
+ *   elementFor: key => rowEls.get(key),
+ *   scroller: () => scrollerEl.value,
+ *   resolveTarget: (hit, source) => insertionIndex(hit, indexOf(source), keys.value.length),
+ *   onDrop: (source, to) => emit('move', indexOf(source), to),
+ * })
+ * ```
+ */
+export type DragSortOrientation = 'vertical' | 'horizontal';
+/** Чем ведётся перенос: указателем или с клавиатуры. */
+export type DragSortMode = 'pointer' | 'keyboard';
+export interface DragSortHit<TKey> {
+    key: TKey;
+    index: number;
+    /** Доля вдоль элемента: 0 — начало, 1 — конец. Зоны нарезает компонент. */
+    fraction: number;
+}
+export interface UseDragSortOptions<TKey, TTarget> {
+    items: () => readonly TKey[];
+    elementFor: (key: TKey) => HTMLElement | null | undefined;
+    /** По умолчанию `vertical`. */
+    orientation?: () => DragSortOrientation;
+    /** Скроллер для автопрокрутки у краёв. Не задан — автопрокрутки нет. */
+    scroller?: () => HTMLElement | null | undefined;
+    disabled?: () => boolean;
+    canDrag?: (key: TKey) => boolean;
+    /** Сдвиг, после которого нажатие становится переносом. По умолчанию 4px. */
+    threshold?: () => number;
+    /**
+     * Попадание указателя → цель переноса. `null` — сюда положить нельзя.
+     *
+     * Третьим аргументом приходит прежняя цель: цели сравниваются по ссылке, и
+     * объектной цели (как «узел плюс зона» у дерева) стоит вернуть **ту же**
+     * ссылку, пока смысл не изменился, — иначе подсветка и объявления будут
+     * дёргаться на каждом движении указателя.
+     */
+    resolveTarget: (hit: DragSortHit<TKey>, source: TKey, previous: TTarget | null) => TTarget | null;
+    /** Перенос состоялся. */
+    onDrop: (source: TKey, target: TTarget) => void;
+    /** Состояние изменилось: подсветка строк и объявления — на этом. */
+    onUpdate?: (source: TKey | null, target: TTarget | null, mode: DragSortMode | null) => void;
+}
+export interface UseDragSortReturn<TKey, TTarget> {
+    source: Ref<TKey | null>;
+    target: Ref<TTarget | null>;
+    mode: Ref<DragSortMode | null>;
+    isActive: Ref<boolean>;
+    /** Вешается на `@pointerdown` ручки или строки. */
+    startFrom: (key: TKey) => (event: PointerEvent) => void;
+    /** Клавиатурный перенос: взять элемент. */
+    grab: (key: TKey) => void;
+    /** Клавиатурный перенос: назначить цель (двигать ведёт компонент). */
+    setTarget: (target: TTarget | null) => void;
+    /** Положить: если цель есть — состоится `onDrop`. */
+    drop: () => void;
+    /** Отменить: ничего не переносится. */
+    cancel: () => void;
+}
+export declare function useDragSort<TKey, TTarget>(options: UseDragSortOptions<TKey, TTarget>): UseDragSortReturn<TKey, TTarget>;

package/dist/types/src/composables/useFloating.d.ts

@@ -21,7 +21,11 @@ export interface UseFloatingOptions {
      * - функция-геттер — как и `placement`, для реактивной зависимости от пропа.
      */
     matchWidth?: boolean | 'min' | (() => boolean | 'min');
-    /** CSS-переменная шкалы слоёв (см. `styles/tokens.css`). По умолчанию `--gr-z-dropdown`. */
+    /**
+     * CSS-переменная шкалы слоёв (см. `styles/tokens.css`). По умолчанию
+     * `--gr-z-dropdown`. Действует, пока панель открыта вне модального окна: над
+     * окном высоту задаёт стек слоёв (см. {@link floatingZIndex}).
+     */
     zIndexVar?: string;
 }
 export interface UseFloatingReturn {

package/dist/types/src/composables/useGrComponentConfig.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Чтение дефолтов `GrConfigProvider` — публичной точкой входа.
+ *
+ * Сами функции живут в `components/GrConfigProvider/context.ts` и оттуда же
+ * реэкспортируются барrelем компонента. Отдельный субпуть нужен пакетам-
+ * компаньонам: импорт из `components/GrConfigProvider` виден `granular doctor`
+ * как ребро графа компонентов, и он справедливо требует объявить зависимость.
+ * Объявлять её нельзя — композабл ничего не рендерит, а объявление притащило
+ * бы потребителю весь CSS и safelist провайдера. Импорт из `composables/*`
+ * ребра не создаёт.
+ */
+export { resolveGrConfig, useGrComponentDefaults, useGrComponentProp, useGrComponentSize, useGrConfig, useGrThemeAttrs, } from '../components/GrConfigProvider/context';
+export type { GrConfigContext, GrConfigSource, GrConfigurableComponent, UseGrComponentSizeOptions, } from '../components/GrConfigProvider/context';
+/**
+ * Открытый реестр компонентов, у которых есть настраиваемые через конфиг пропы.
+ *
+ * Объявление живёт здесь, а не в `GrConfigProvider/context`, потому что это
+ * **точка расширения**: компонент дополняет реестр из своей папки через
+ * declaration merging, и то же самое обязан уметь companion-пакет. Дополнять
+ * можно только тот модуль, который тип объявляет; через реэкспорт-баррель
+ * слияние работает лишь до первой чужой аугментации, а дальше молча
+ * отваливается — типы расходятся с рантаймом, ошибки нет.
+ *
+ * ```ts
+ * // GrButton/defaults.ts
+ * declare module '../../composables/useGrComponentConfig' {
+ *   interface GrComponentDefaultsRegistry {
+ *     GrButton: GrButtonConfigurableProps
+ *   }
+ * }
+ * ```
+ *
+ * Companion-пакет пишет тот же блок с публичным именем модуля
+ * `@feugene/granularity/composables/useGrComponentConfig`.
+ *
+ * Реестр пуст по умолчанию и состоит ровно из тех компонентов, которые попали
+ * в граф типов потребителя: импортировали только `GrButton` — в
+ * `componentDefaults` типизирована только кнопка.
+ */
+export interface GrComponentDefaultsRegistry {
+}

package/dist/types/src/composables/useGranularityTranslations.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Публичная точка входа к строкам пакета.
+ *
+ * Реализация живёт в `internal/granularityI18n.ts` и остаётся внутренней: там
+ * же `resolveGranularityI18n` — резолвер адаптера для кода вне `setup`, который
+ * публичным контрактом не является. Наружу выходит только то, что нужно
+ * потребителю и companion-пакетам: сам композабл и тип адаптера.
+ *
+ * Файл-фасад, а не переезд: `internal/granularityI18n` импортируют 55 файлов
+ * пакета, и переписывание путей ради смены директории — риск без выгоды.
+ */
+export { useGranularityTranslations } from '../internal/granularityI18n';
+export type { GranularityI18nLike } from '../internal/granularityI18n';