@feugene/granularity 0.16.0 → 0.19.0

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

@@ -0,0 +1,108 @@
+import type { ComputedRef } from 'vue';
+/**
+ * Roving tabindex: группа — одна остановка `Tab`, внутрь заходят стрелками.
+ *
+ * Механика написана в пакете шесть раз (`GrDropdownMenu`, `GrTree`, `GrTabs`,
+ * `GrSegmented`, `GrRadio`, `GrInputTag`) и разошлась не стилистически, а по
+ * существу: у одних кольцо зациклено, у других упирается в края; одни
+ * пропускают выключенные элементы, другие намеренно нет; адресуются то
+ * индексом, то ключом, то значением. Каждое расхождение здесь стало опцией —
+ * поэтому опций много, и это дешевле, чем седьмая копия.
+ *
+ * Осознанно **не** обобщается активация: `Enter`/`Space` и «двигает ли стрелка
+ * выбор» — доменная логика компонента. У `GrSegmented` и `GrRadio` стрелка
+ * меняет значение, у `GrTree` и `GrInputTag` — нет, у `GrTabs` это проп.
+ * Примитив ведёт фокус и отдаёт `onMove`; что делать с переездом, решает
+ * компонент.
+ *
+ * Инвариант «ровно один элемент с `tabindex="0"`» держит `rovingKey`: это
+ * `computed`, а не `ref`, поэтому при смене набора он самокорректируется в
+ * момент чтения. Отдельная нормализация с `watch(..., { flush: 'sync' })`,
+ * как в `GrTree`, больше не нужна.
+ */
+/** Какие стрелки ведут по набору. */
+export type GrRovingOrientation = 'horizontal' | 'vertical' | 'both' | 'grid';
+/** Край набора, в который упёрлось движение. */
+export type GrRovingEdge = 'start' | 'end';
+export interface UseRovingFocusOptions<TKey> {
+    /** Ключи элементов в порядке отображения. Индекс, значение, opaque-ключ — что угодно сравнимое по `===`. */
+    items: () => readonly TKey[];
+    /**
+     * DOM-узел элемента. Массив ref-ов, `Map`, `querySelector` — примитиву
+     * безразлично, знать раскладку обязан компонент.
+     */
+    elementFor: (key: TKey) => HTMLElement | null | undefined;
+    /** Выключен ли элемент. Спрашивается только при `skipDisabled`. */
+    isDisabled?: (key: TKey) => boolean;
+    /** По умолчанию `vertical`. */
+    orientation?: () => GrRovingOrientation;
+    /** Ширина строки для `orientation: 'grid'`. Игнорируется в остальных режимах. */
+    columns?: () => number;
+    /** Замкнуто ли кольцо. По умолчанию `true`. */
+    wrap?: () => boolean;
+    /**
+     * Пропускать выключенные при движении. По умолчанию `false`: в паттерне
+     * `menu` выключенный пункт остаётся в обходе намеренно — `aria-disabled`
+     * оставляет его фокусируемым, чтобы скринридер прочёл, что он есть.
+     */
+    skipDisabled?: () => boolean;
+    /**
+     * Стартовый элемент, когда фокус в группе ещё не был — обычно выбранное
+     * значение.
+     *
+     * **Выключенность здесь не проверяется, и это не упущение.** Проверить её
+     * автоматически по `isDisabled` нельзя: у `GrSegmented` загружающийся сегмент
+     * остановку `Tab` сохраняет, хотя для движения заблокирован, а у `GrRadio`
+     * выключенный переключатель терять её обязан. Условие знает только вызывающий,
+     * поэтому геттер обязан вернуть `undefined` для значения, которое не может
+     * принять фокус. Забыть об этом — значит оставить группу без остановки `Tab`
+     * вовсе: элемент с `tabindex="0"` будет назначен, но отрисует `-1`.
+     */
+    initialKey?: () => TKey | undefined;
+    /**
+     * Позиция переехала — компонент решает, менять ли заодно выбор. Вызывается
+     * **до** переноса фокуса: в `radiogroup` стрелка переносит выбор, и модель
+     * обязана примениться раньше, чем сфокусируется целевой элемент.
+     */
+    onMove?: (key: TKey, previous: TKey | undefined) => void;
+    /**
+     * Движение упёрлось в край при `wrap: false`. Вернул `true` — считаем клавишу
+     * обработанной (кольцо `GrInputTag` так отдаёт фокус полю ввода, календарь —
+     * листает месяц).
+     */
+    onOverflow?: (edge: GrRovingEdge, delta: number) => boolean;
+    /**
+     * Донести элемент до экрана перед фокусом: виртуализация, `scrollIntoView`,
+     * ожидание перерисовки после `onMove`. Вернул промис — фокус ждёт ровно его,
+     * без добавленных примитивом тиков; вернул `undefined` — фокус остаётся
+     * синхронным, чтобы не менять тайминг у компонентов, которые на него
+     * полагаются.
+     */
+    beforeFocus?: (key: TKey) => void | Promise<void>;
+}
+export interface UseRovingFocusReturn<TKey> {
+    /** Элемент, который держит `tabindex="0"`. Никогда не «никто» при непустом наборе. */
+    rovingKey: ComputedRef<TKey | undefined>;
+    /** `0` для роверного элемента, `-1` для всех остальных. */
+    tabindexFor: (key: TKey) => 0 | -1;
+    /** Сделать активным без переноса фокуса — для синхронизации с мышью (`@focus`, `@click`). */
+    setActive: (key: TKey) => void;
+    /**
+     * Забыть явно наведённый фокус: остановка `Tab` возвращается к производной
+     * (`initialKey` → первый доступный). Нужно, когда набор опустел, — иначе
+     * устаревший ключ всплывёт, как только элементы появятся снова.
+     */
+    reset: () => void;
+    /** Сделать активным и перенести фокус. */
+    focusKey: (key: TKey) => Promise<void>;
+    /** Сдвиг на `delta` позиций от текущего. Вернёт `false`, если движение не состоялось. */
+    moveBy: (delta: number) => boolean;
+    /** На край набора (в `grid` — на край текущей строки). */
+    moveToEdge: (edge: GrRovingEdge) => boolean;
+    /**
+     * Стрелки, `Home`, `End` по объявленной ориентации. Возвращает `true`, если
+     * клавиша обработана (с `preventDefault`) — остальное компонент разбирает сам.
+     */
+    handleNavigationKeys: (event: KeyboardEvent) => boolean;
+}
+export declare function useRovingFocus<TKey>(options: UseRovingFocusOptions<TKey>): UseRovingFocusReturn<TKey>;

package/dist/types/src/granular-provider/shared.d.ts

@@ -66,6 +66,7 @@ export declare const granularityComponentConfigs: {
     GrSidebar: GranularComponentDescriptor<"GrSidebar">;
     GrSkeleton: GranularComponentDescriptor<"GrSkeleton">;
     GrSlider: GranularComponentDescriptor<"GrSlider">;
+    GrSortableList: GranularComponentDescriptor<"GrSortableList">;
     GrSplitter: GranularComponentDescriptor<"GrSplitter">;
     GrStatistic: GranularComponentDescriptor<"GrStatistic">;
     GrSwitch: GranularComponentDescriptor<"GrSwitch">;

package/dist/types/src/i18n/messages/en.d.ts

@@ -41,6 +41,7 @@ export declare const en: {
                     drag: string;
                     expand: string;
                     collapse: string;
+                    moved: string;
                 };
                 select: {
                     customValuePlaceholder: string;
@@ -59,6 +60,10 @@ export declare const en: {
                     sortAsc: string;
                     sortDesc: string;
                     sortNone: string;
+                    moveColumn: string;
+                    columnMoved: string;
+                    resizeColumn: string;
+                    columnResized: string;
                 };
                 breadcrumbs: {
                     label: string;
@@ -277,6 +282,16 @@ export declare const en: {
                     control: string;
                     enter: string;
                     escape: string;
+                    tab: string;
+                    backspace: string;
+                    delete: string;
+                    pageUp: string;
+                    pageDown: string;
+                    arrowUp: string;
+                    arrowDown: string;
+                    arrowLeft: string;
+                    arrowRight: string;
+                    then: string;
                 };
                 link: {
                     opensInNewTab: string;
@@ -317,6 +332,15 @@ export declare const en: {
                 emptyState: {
                     title: string;
                 };
+                sortable: {
+                    label: string;
+                    handle: string;
+                    empty: string;
+                    grabbed: string;
+                    moved: string;
+                    dropped: string;
+                    cancelled: string;
+                };
             };
             common: {
                 confirm: string;
@@ -350,6 +374,7 @@ export declare const en: {
                 drag: string;
                 expand: string;
                 collapse: string;
+                moved: string;
             };
             select: {
                 customValuePlaceholder: string;
@@ -368,6 +393,10 @@ export declare const en: {
                 sortAsc: string;
                 sortDesc: string;
                 sortNone: string;
+                moveColumn: string;
+                columnMoved: string;
+                resizeColumn: string;
+                columnResized: string;
             };
             breadcrumbs: {
                 label: string;
@@ -586,6 +615,16 @@ export declare const en: {
                 control: string;
                 enter: string;
                 escape: string;
+                tab: string;
+                backspace: string;
+                delete: string;
+                pageUp: string;
+                pageDown: string;
+                arrowUp: string;
+                arrowDown: string;
+                arrowLeft: string;
+                arrowRight: string;
+                then: string;
             };
             link: {
                 opensInNewTab: string;
@@ -626,6 +665,15 @@ export declare const en: {
             emptyState: {
                 title: string;
             };
+            sortable: {
+                label: string;
+                handle: string;
+                empty: string;
+                grabbed: string;
+                moved: string;
+                dropped: string;
+                cancelled: string;
+            };
         }>;
     };
 };

package/dist/types/src/i18n/messages/es.d.ts

@@ -34,6 +34,7 @@ export declare const es: {
                     drag: string;
                     expand: string;
                     collapse: string;
+                    moved: string;
                 };
                 select: {
                     customValuePlaceholder: string;
@@ -52,6 +53,10 @@ export declare const es: {
                     sortAsc: string;
                     sortDesc: string;
                     sortNone: string;
+                    moveColumn: string;
+                    columnMoved: string;
+                    resizeColumn: string;
+                    columnResized: string;
                 };
                 breadcrumbs: {
                     label: string;
@@ -272,6 +277,16 @@ export declare const es: {
                     control: string;
                     enter: string;
                     escape: string;
+                    tab: string;
+                    backspace: string;
+                    delete: string;
+                    pageUp: string;
+                    pageDown: string;
+                    arrowUp: string;
+                    arrowDown: string;
+                    arrowLeft: string;
+                    arrowRight: string;
+                    then: string;
                 };
                 link: {
                     opensInNewTab: string;
@@ -312,6 +327,15 @@ export declare const es: {
                 emptyState: {
                     title: string;
                 };
+                sortable: {
+                    label: string;
+                    handle: string;
+                    empty: string;
+                    grabbed: string;
+                    moved: string;
+                    dropped: string;
+                    cancelled: string;
+                };
             };
             common: {
                 confirm: string;
@@ -345,6 +369,7 @@ export declare const es: {
                 drag: string;
                 expand: string;
                 collapse: string;
+                moved: string;
             };
             select: {
                 customValuePlaceholder: string;
@@ -363,6 +388,10 @@ export declare const es: {
                 sortAsc: string;
                 sortDesc: string;
                 sortNone: string;
+                moveColumn: string;
+                columnMoved: string;
+                resizeColumn: string;
+                columnResized: string;
             };
             breadcrumbs: {
                 label: string;
@@ -583,6 +612,16 @@ export declare const es: {
                 control: string;
                 enter: string;
                 escape: string;
+                tab: string;
+                backspace: string;
+                delete: string;
+                pageUp: string;
+                pageDown: string;
+                arrowUp: string;
+                arrowDown: string;
+                arrowLeft: string;
+                arrowRight: string;
+                then: string;
             };
             link: {
                 opensInNewTab: string;
@@ -623,6 +662,15 @@ export declare const es: {
             emptyState: {
                 title: string;
             };
+            sortable: {
+                label: string;
+                handle: string;
+                empty: string;
+                grabbed: string;
+                moved: string;
+                dropped: string;
+                cancelled: string;
+            };
         }>;
     };
 };

package/dist/types/src/i18n/messages/ru.d.ts

@@ -34,6 +34,7 @@ export declare const ru: {
                     drag: string;
                     expand: string;
                     collapse: string;
+                    moved: string;
                 };
                 select: {
                     customValuePlaceholder: string;
@@ -52,6 +53,10 @@ export declare const ru: {
                     sortAsc: string;
                     sortDesc: string;
                     sortNone: string;
+                    moveColumn: string;
+                    columnMoved: string;
+                    resizeColumn: string;
+                    columnResized: string;
                 };
                 breadcrumbs: {
                     label: string;
@@ -274,6 +279,16 @@ export declare const ru: {
                     control: string;
                     enter: string;
                     escape: string;
+                    tab: string;
+                    backspace: string;
+                    delete: string;
+                    pageUp: string;
+                    pageDown: string;
+                    arrowUp: string;
+                    arrowDown: string;
+                    arrowLeft: string;
+                    arrowRight: string;
+                    then: string;
                 };
                 link: {
                     opensInNewTab: string;
@@ -314,6 +329,15 @@ export declare const ru: {
                 emptyState: {
                     title: string;
                 };
+                sortable: {
+                    label: string;
+                    handle: string;
+                    empty: string;
+                    grabbed: string;
+                    moved: string;
+                    dropped: string;
+                    cancelled: string;
+                };
             };
             common: {
                 confirm: string;
@@ -347,6 +371,7 @@ export declare const ru: {
                 drag: string;
                 expand: string;
                 collapse: string;
+                moved: string;
             };
             select: {
                 customValuePlaceholder: string;
@@ -365,6 +390,10 @@ export declare const ru: {
                 sortAsc: string;
                 sortDesc: string;
                 sortNone: string;
+                moveColumn: string;
+                columnMoved: string;
+                resizeColumn: string;
+                columnResized: string;
             };
             breadcrumbs: {
                 label: string;
@@ -587,6 +616,16 @@ export declare const ru: {
                 control: string;
                 enter: string;
                 escape: string;
+                tab: string;
+                backspace: string;
+                delete: string;
+                pageUp: string;
+                pageDown: string;
+                arrowUp: string;
+                arrowDown: string;
+                arrowLeft: string;
+                arrowRight: string;
+                then: string;
             };
             link: {
                 opensInNewTab: string;
@@ -627,6 +666,15 @@ export declare const ru: {
             emptyState: {
                 title: string;
             };
+            sortable: {
+                label: string;
+                handle: string;
+                empty: string;
+                grabbed: string;
+                moved: string;
+                dropped: string;
+                cancelled: string;
+            };
         }>;
     };
 };

package/dist/types/src/index.d.ts

@@ -53,6 +53,7 @@ export * from './components/GrSelect';
 export * from './components/GrSidebar';
 export * from './components/GrSkeleton';
 export * from './components/GrSlider';
+export * from './components/GrSortableList';
 export * from './components/GrSplitter';
 export * from './components/GrStatistic';
 export * from './components/GrSwitch';
@@ -73,12 +74,23 @@ export { usePortalTarget } from './composables/usePortalTarget';
 export type { PortalTarget } from './composables/usePortalTarget';
 export { useOverlayLayer } from './composables/useOverlayLayer';
 export type { OverlayLayerHandle, UseOverlayLayerOptions } from './composables/useOverlayLayer';
+export { useRovingFocus } from './composables/useRovingFocus';
+export type { GrRovingEdge, GrRovingOrientation, UseRovingFocusOptions, UseRovingFocusReturn, } from './composables/useRovingFocus';
+export * from './composables/useGrComponentConfig';
+export { useComboboxNavigation } from './composables/useComboboxNavigation';
+export type { UseComboboxNavigationOptions, UseComboboxNavigationReturn, } from './composables/useComboboxNavigation';
+export { useGranularityTranslations } from './composables/useGranularityTranslations';
+export type { GranularityI18nLike } from './composables/useGranularityTranslations';
 export { useFloating } from './composables/useFloating';
 export type { UseFloatingOptions, UseFloatingPlacement, UseFloatingReturn } from './composables/useFloating';
 export { useAnnouncer } from './composables/useAnnouncer';
 export type { GrAnnounceOptions, GrAnnouncer, GrAnnouncerPoliteness } from './composables/useAnnouncer';
 export { useVirtualList } from './composables/useVirtualList';
 export type { GrVirtualAlign, UseVirtualListOptions, UseVirtualListReturn } from './composables/useVirtualList';
+export { useDragGesture } from './composables/useDragGesture';
+export type { UseDragGestureOptions, UseDragGestureReturn } from './composables/useDragGesture';
+export { useDragSort } from './composables/useDragSort';
+export type { DragSortHit, DragSortMode, DragSortOrientation, UseDragSortOptions, UseDragSortReturn, } from './composables/useDragSort';
 export { useGrFormControl } from './composables/useGrFormControl';
 export type { GrFormControlProps, GrFormControlState } from './composables/useGrFormControl';
 export { GRANULARITY_THEME_STATE, granularityThemePlugin, initThemeEarly, useTheme } from './composables/useTheme';

package/dist/types/src/internal/keyboard.d.ts

@@ -21,6 +21,12 @@ export declare function isComposingEvent(event: KeyboardEvent): boolean;
  * typeahead меню обязаны молчать, пока пользователь печатает в поле внутри них.
  */
 export declare function isEditableTarget(target: EventTarget | null): boolean;
+/**
+ * macOS определяем по платформе: от неё зависит, чем является токен `mod` —
+ * Cmd или Ctrl. Живёт здесь, а не рядом с одним потребителем: то же нужно
+ * `GrKbd` (что показать), палитре (что слушать) и директиве `v-hotkey`.
+ */
+export declare function isAppleDevice(): boolean;
 /** Физический код клавиши для латинской буквы или цифры; иначе `null`. */
 export declare function codeForChar(ch: string): string | null;
 export interface EventMatchesKeyOptions {

package/dist/types/src/testing/announcer.d.ts

@@ -0,0 +1,10 @@
+import type { GrAnnouncerPoliteness } from '../composables/useAnnouncer';
+/**
+ * Текст живого региона.
+ *
+ * Ждать здесь обязательно: `announce` пишет в регион **отложенным** макротаском,
+ * и это не деталь реализации, а условие работы. Регион, в котором текст
+ * появился в том же кадре, что и сам регион, часть AT не объявляет вовсе;
+ * поэтому синхронное чтение сразу после действия покажет пустую строку.
+ */
+export declare function announced(politeness?: GrAnnouncerPoliteness): Promise<string>;

package/dist/types/src/testing/context.d.ts

@@ -0,0 +1,36 @@
+import { type Ref } from 'vue';
+import { type GrComponentDefaults, type GrComponentSize } from '../components/GrConfigProvider/context';
+import { type GranularityI18nAdapter, type GranularityI18nParams } from '../i18n/adapter';
+export interface I18nAdapterOptions {
+    /** Перевод по ключу. По умолчанию — сам ключ: видно, что спросили. */
+    t?: (key: string, params?: GranularityI18nParams) => string;
+    te?: (key: string) => boolean;
+    locale?: string | Ref<string>;
+}
+/** Адаптер перевода для теста: словарь или своя функция. */
+export declare function i18nAdapter(options?: I18nAdapterOptions | Record<string, string>): GranularityI18nAdapter;
+export interface GranularityGlobalOptions {
+    size?: GrComponentSize;
+    componentDefaults?: GrComponentDefaults;
+    theme?: string;
+    portalTarget?: string | HTMLElement;
+    /** Адаптер перевода: готовый, словарь `{ ключ: перевод }` или опции `i18nAdapter`. */
+    i18n?: GranularityI18nAdapter | I18nAdapterOptions | Record<string, string>;
+}
+/**
+ * Окружение пакета для монтирования — то, что `<GrConfigProvider>` раздаёт
+ * через `provide`.
+ *
+ * Отдаётся объектом, а не компонентом-обёрткой, намеренно: провайдер тянет за
+ * собой лишний корневой элемент, а искать компонент внутри чужой разметки в
+ * каждом тесте дороже, чем передать `global`. Проверять **сам** провайдер
+ * (`data-gr-config-provider`, тема на корне) этим нельзя и не нужно — для этого
+ * его и монтируют.
+ *
+ * ```ts
+ * mount(GrSelect, { props, global: granularityGlobal({ size: 'sm' }) })
+ * ```
+ */
+export declare function granularityGlobal(options?: GranularityGlobalOptions): {
+    provide: Record<symbol, unknown>;
+};

package/dist/types/src/testing/env.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Уборка между тестами.
+ *
+ * `document.body.innerHTML = ''` сам по себе оставляет пакет в разобранном
+ * состоянии: корень портала и хост живого региона закэшированы модулями, и
+ * после очистки `body` они указывают на узлы **вне документа**. Следующий
+ * монтаж телепортирует туда оверлеи, тест ищет их в документе и не находит —
+ * без единой ошибки в консоли. Очередь тостов переживает размонтирование по
+ * замыслу, поэтому её тоже гасим.
+ */
+export declare function resetGranularityDom(): void;
+export interface StubMatchMediaOptions {
+    /** Ответ на `(prefers-reduced-motion: reduce)`. */
+    reducedMotion?: boolean;
+    /** Ответ на остальные запросы. */
+    matches?: boolean;
+}
+/**
+ * Ответ `matchMedia` — например «пользователь просил меньше движения».
+ *
+ * Не для того, чтобы «не падало»: сам пакет зовёт `matchMedia` опционально и без
+ * него живёт. Нужно, когда проверяется поведение **под** медиазапросом.
+ * Возвращает функцию отката: глобальное состояние обязано уйти вместе с тестом.
+ */
+export declare function stubMatchMedia(options?: StubMatchMediaOptions): () => void;

package/dist/types/src/testing/geometry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Геометрия в jsdom.
+ *
+ * Раскладки в jsdom нет: `getBoundingClientRect` у любого элемента возвращает
+ * нули. Всё, что считает попадание указателя — слайдер, сплиттер, перестановка,
+ * ширины колонок таблицы, — на нулевом прямоугольнике проверять не на чем,
+ * поэтому геометрия задаётся руками.
+ */
+export type MockRect = Partial<Omit<DOMRect, 'toJSON'>>;
+/** Прямоугольник элемента. Незаданные стороны выводятся из заданных. */
+export declare function mockRect(target: Element, rect: MockRect): void;
+export interface StackRectsOptions {
+    /** Размер элемента вдоль оси. */
+    size: number;
+    /** Ось раскладки. По умолчанию вертикальная — так лежат списки и строки. */
+    axis?: 'vertical' | 'horizontal';
+    /** Смещение первого элемента. */
+    start?: number;
+    /** Размер поперёк оси. */
+    cross?: number;
+}
+/** Элементы подряд, встык, без зазоров: строки списка, ячейки шапки, деления шкалы. */
+export declare function stackRects(targets: Iterable<Element>, options: StackRectsOptions): void;

package/dist/types/src/testing/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Тестовые утилиты пакета — `@feugene/granularity/testing`.
+ *
+ * Ни `vitest`, ни `@vue/test-utils` здесь нет и не будет: утилиты отдают данные
+ * и действия над DOM, а монтирует и утверждает потребитель — своим раннером.
+ * Документация: `docs/testing.md`.
+ */
+export { cancelPointer, drag, move, pointer, press, release } from './pointer';
+export { mockRect, type MockRect, stackRects, type StackRectsOptions } from './geometry';
+export { resetGranularityDom, stubMatchMedia, type StubMatchMediaOptions } from './env';
+export { granularityGlobal, type GranularityGlobalOptions, i18nAdapter, type I18nAdapterOptions } from './context';
+export { announced } from './announcer';

package/dist/types/src/testing/pointer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Указательные жесты в тестах.
+ *
+ * Две вещи, которые ломают наивную запись жеста, и обе неочевидны:
+ *
+ * 1. **`pointerdown` идёт в элемент, а `pointermove`/`pointerup`/`pointercancel` — в `window`.**
+ *    Так слушает `useDragGesture` (и всё, что на нём стоит: слайдер, сплиттер,
+ *    перестановка, смахивание тоста): нажатие приходит от разметки, а движение
+ *    ловится глобально, иначе жест обрывался бы на выходе курсора за элемент.
+ *    Тест, отправивший движение в тот же элемент, ничего не проверяет — и молча.
+ * 2. **`PointerEvent` в jsdom нет**, а `wrapper.trigger('pointerdown', { clientY })`
+ *    падает на попытке записать `clientY`. Поэтому события собираются
+ *    `MouseEvent`-ом и отправляются через `dispatchEvent`.
+ *
+ * Плюс `button: 0` по умолчанию: жест игнорирует неосновную кнопку, и без этого
+ * «перетаскивание» в тесте не начинается вовсе.
+ */
+/** Событие указателя: `MouseEvent`, потому что `PointerEvent` в jsdom не реализован. */
+export declare function pointer(type: string, init?: MouseEventInit): MouseEvent;
+/** Нажатие: единственное событие жеста, которое адресуется элементу. */
+export declare function press(target: Element, init?: MouseEventInit): void;
+export declare function move(init?: MouseEventInit): void;
+export declare function release(init?: MouseEventInit): void;
+/**
+ * Обрыв жеста: система забрала указатель (системный жест, звонок, потеря окна).
+ * Отдельная ветка поведения у всех потребителей — смахивание возвращает тост,
+ * перестановка откатывает порядок, — поэтому проверяется отдельно от `release`.
+ */
+export declare function cancelPointer(init?: MouseEventInit): void;
+/** Жест целиком: нажали на элементе, провели, отпустили. */
+export declare function drag(target: Element, from: MouseEventInit, to: MouseEventInit): void;

package/dist/types/src/theme/apply.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Подключение темы в рантайме — `@feugene/granularity/theme/apply`.
+ *
+ * Отдельный подпуть от `@feugene/granularity/theme` не по вкусу, а по весу:
+ * там справочник токенов (сотня килобайт данных), нужный, чтобы тему
+ * **собрать**. Чтобы её **подключить**, не нужно ничего, кроме готовой строки,
+ * — и приложению незачем платить за первое, если оно делает второе.
+ *
+ * Штатный путь всё же другой: собрать тему на сборке и отдать браузеру обычный
+ * CSS-файл. Этот модуль — для случаев, когда тема появляется только в браузере:
+ * редактор тем, превью, тема из пользовательских настроек.
+ */
+export interface ApplyThemeOptions {
+    /**
+     * Имя, под которым тема живёт в документе. Повторный вызов с тем же именем
+     * заменяет её содержимое, а не добавляет второй `<style>`: иначе редактор
+     * темы за минуту работы оставил бы в `<head>` сотню слоёв, и побеждал бы
+     * последний — то есть результат зависел бы от истории правок.
+     */
+    name?: string;
+    /** Куда вставлять. По умолчанию `document.head`. */
+    target?: HTMLElement | null;
+}
+/** Подключает CSS темы и возвращает функцию, которая его снимает. */
+export declare function applyTheme(css: string, options?: ApplyThemeOptions): () => void;
+/** Снимает тему, подключённую `applyTheme`. */
+export declare function removeTheme(name?: string, target?: HTMLElement | null): void;