@feugene/granularity 0.41.0 → 0.43.0

package/dist/types/components/GrTable/GrTable.vue.d.ts

@@ -131,10 +131,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     fixedLayout: boolean;
     tableMinWidth: undefined;
 }>>> & Readonly<{}>, {
+    caption: string;
     size: GrTableSize;
     emptyText: string;
     loading: boolean;
-    caption: string;
     columnCount: number;
     maxHeight: string | number;
     ariaLabel: string;

package/dist/types/components/GrTabs/GrTabs.vue.d.ts

@@ -88,10 +88,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     variant: GrTabsVariant;
     closable: boolean;
     size: GrTabsSize;
+    activationMode: GrTabsActivationMode;
     emptyText: string;
     orientation: GrTabsOrientation;
     idBase: string;
-    activationMode: GrTabsActivationMode;
 }, {}, {}, {}, 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/components/GrTextarea/GrTextarea.vue.d.ts

@@ -104,14 +104,14 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
+    disabled: boolean;
+    readonly: boolean;
     size: GrTextareaSize;
     clearable: boolean;
-    readonly: boolean;
     name: string;
     invalid: boolean;
     resize: GrTextareaResize;
     id: string;
-    disabled: boolean;
     ariaLabel: string;
     required: boolean;
     placeholder: string;

package/dist/types/components/GrTimeline/GrTimelineItem.vue.d.ts

@@ -48,10 +48,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     variant: string;
     pending: boolean;
 }>>> & Readonly<{}>, {
-    tone: GrTimelineTone;
-    variant: GrTimelineMarkerVariant;
     time: string;
     title: string;
+    tone: GrTimelineTone;
+    variant: GrTimelineMarkerVariant;
     description: string;
     pending: boolean;
     datetime: string;

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

@@ -61,8 +61,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     focusHotkey: string;
     swipeDismiss: boolean;
 }>>> & Readonly<{}>, {
-    width: string | number;
     placement: GrToasterPlacement;
+    width: string | number;
     dismissLabel: string;
     regionLabel: string;
     maxVisible: number;

package/dist/types/components/GrTooltip/GrTooltip.vue.d.ts

@@ -55,11 +55,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>> & Readonly<{
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
-    size: GrTooltipSize;
-    text: string;
     placement: GrTooltipPlacement;
-    open: boolean;
     disabled: boolean;
+    text: string;
+    size: GrTooltipSize;
+    open: boolean;
     offsetPx: number;
     openDelay: number;
     closeDelay: number;

package/dist/types/components/GrTransfer/GrTransfer.vue.d.ts

@@ -0,0 +1,103 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTransferDirection, GrTransferKey, GrTransferSide } from './transferModel';
+export type GrTransferItemKey<T> = string | ((item: T) => GrTransferKey);
+export type GrTransferItemLabel<T> = string | ((item: T) => string);
+export type GrTransferItemFlag<T> = string | ((item: T) => boolean);
+export interface GrTransferProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Каталог целиком: обе панели — одна его раскладка. */
+    items: T[];
+    /** Ключи правой панели **в её порядке**: порядок и есть значение. */
+    modelValue: GrTransferKey[];
+    itemKey?: GrTransferItemKey<T>;
+    itemLabel?: GrTransferItemLabel<T>;
+    itemDisabled?: GrTransferItemFlag<T>;
+    /** Имя левой панели. Это доступное имя её `listbox`, а не украшение. */
+    sourceTitle?: string;
+    /** Имя правой панели. */
+    targetTitle?: string;
+    /** Поле поиска в каждой панели. */
+    searchable?: boolean;
+    /** Свой матчер: встроенный ищет по `itemLabel`, а строка может показывать больше. */
+    filter?: (item: T, query: string) => boolean;
+    /** Правую панель можно переставлять. */
+    sortable?: boolean;
+    /** Перетаскивание строк указателем. Усиление поверх кнопок, а не контракт. */
+    draggable?: boolean;
+    /** Высота панелей: обе одинаковы и прокручиваются внутри себя. */
+    maxHeight?: number | string;
+    size?: GrComponentSize;
+    disabled?: boolean;
+    readonly?: boolean;
+    invalid?: boolean;
+    required?: boolean;
+    ariaLabel?: string;
+}
+export interface GrTransferEmits {
+    (e: 'update:modelValue', value: GrTransferKey[]): void;
+    (e: 'change', value: GrTransferKey[]): void;
+    (e: 'transfer', keys: GrTransferKey[], direction: GrTransferDirection): void;
+    (e: 'search', query: string, side: GrTransferSide): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare const __VLS_export: <TItem extends Record<string, unknown> = Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrTransferProps<TItem> & {
+        onSearch?: ((query: string, side: GrTransferSide) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((value: GrTransferKey[]) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GrTransferKey[]) => any) | undefined;
+        onTransfer?: ((keys: GrTransferKey[], direction: GrTransferDirection) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        focus: () => void;
+        blur: () => void;
+        focusSide: (side: GrTransferSide) => void;
+        transfer: (keys: GrTransferKey[], direction: GrTransferDirection) => undefined;
+        selectAll: (side: GrTransferSide) => void;
+        clearSelection: (side?: GrTransferSide) => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        /** Своя строка. Слот доменный: у соседей `item` — строка списка, здесь тоже. */
+        item?: (props: {
+            item: TItem;
+            side: GrTransferSide;
+            index: number;
+            selected: boolean;
+            disabled: boolean;
+        }) => unknown;
+        /** Своя шапка панели: имя, счётчик, отметка «выбрать всё». */
+        header?: (props: {
+            side: GrTransferSide;
+            title: string;
+            selected: number;
+            total: number;
+            shown: number;
+        }) => unknown;
+        /** Своя колонка кнопок между панелями. */
+        actions?: (props: {
+            toTarget: () => void;
+            toSource: () => void;
+            canToTarget: boolean;
+            canToSource: boolean;
+        }) => unknown;
+        /** Пустая панель. `filtered` — пусто из-за поиска, а не по сути. */
+        empty?: (props: {
+            side: GrTransferSide;
+            filtered: boolean;
+        }) => unknown;
+    };
+    emit: GrTransferEmits;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrTransfer/config.d.ts

@@ -0,0 +1 @@
+export declare const grTransferConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrTransfer">;

package/dist/types/components/GrTransfer/defaults.d.ts

@@ -0,0 +1,15 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrTransfer`, настраиваемые глобально через `componentDefaults`. */
+export interface GrTransferConfigurableProps {
+    size: GrComponentSize;
+    /**
+     * Перетаскивание — усиление поверх кнопок, а не контракт: приложение вправе
+     * выключить его на всё поддерево, и клавиатурный путь от этого не пострадает.
+     */
+    draggable: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrTransfer: GrTransferConfigurableProps;
+    }
+}

package/dist/types/components/GrTransfer/grTransferStyles.d.ts

@@ -0,0 +1,127 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTransferSize = GrComponentSize;
+export declare const transferRootBase = "flex items-stretch gap-4";
+export declare const transferPanelBase = "flex min-w-0 flex-1 flex-col overflow-hidden rounded-[var(--gr-radius-md)] border border-[var(--gr-brd)] bg-[var(--gr-card)]";
+/**
+ * Панель под указателем во время переноса.
+ *
+ * Одной рамки мало: на широком экране она за пределами взгляда, занятого
+ * курсором. Мягкая подложка сообщает «сюда» там, где человек и смотрит.
+ */
+export declare const transferPanelDropClass = "border-[var(--gr-transfer-drop-brd,var(--gr-primary))] bg-[var(--gr-transfer-drop-bg,color-mix(in_srgb,var(--gr-primary)_6%,transparent))]";
+export declare const transferHeaderBase = "flex items-center gap-2 border-b border-[var(--gr-brd)]";
+export declare const transferTitleClass = "min-w-0 flex-1 truncate font-600 text-[var(--gr-fg)]";
+export declare const transferCounterClass = "shrink-0 text-[var(--gr-muted-fg)] tabular-nums";
+export declare const transferSearchBase = "border-b border-[var(--gr-brd)]";
+/**
+ * Список — скроллер, но своего таб-стопа не получает: его строки фокусируемы,
+ * и вторая остановка `Tab` перед ними была бы лишней (приём `GrTabs`).
+ */
+export declare const transferListBase = "relative min-h-0 flex-1 overflow-y-auto";
+export declare const transferOptionBase = "relative flex w-full select-none items-center gap-2 text-start transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-inset";
+/** Строку можно взять — курсор обязан это предложить до нажатия, а не после. */
+export declare const transferOptionGrabClass = "cursor-grab";
+export declare const transferOptionPlainClass = "cursor-pointer";
+export declare const transferOptionStates: {
+    readonly selected: "bg-[var(--gr-transfer-selected-bg,color-mix(in_srgb,var(--gr-primary)_12%,transparent))] text-[var(--gr-fg)]";
+    readonly idle: "text-[var(--gr-fg)] hover:bg-[var(--gr-muted)]";
+    readonly disabled: "cursor-not-allowed bg-[var(--gr-muted)] text-[var(--gr-disabled-fg)]";
+};
+/**
+ * Строка, только что приехавшая из соседней панели.
+ *
+ * Статичный итог перенос уже показывает — строка приходит отмеченной, счётчики
+ * меняются, — но само **движение** ничем не выдано: строки просто возникают.
+ * Короткая подсветка связывает «нажал» и «появилось». Под `prefers-reduced-motion`
+ * её гасит глобальный кламп, и остаётся тот же статичный итог.
+ */
+export declare const transferOptionArrivedClass = "gr-transfer-arrived";
+/**
+ * Место, откуда строку унесли.
+ *
+ * Правило живёт в `<style>` компонента, а не утилитой: цвет текста строки задаёт
+ * класс состояния той же специфичности, и кто победит, решал бы порядок правил в
+ * собранном CSS — та же ловушка, что записана в `grTabsStyles.ts`.
+ */
+export declare const transferOptionDraggingClass = "gr-transfer-vacated";
+/**
+ * Отметка строки декоративна: `GrCheckbox` внутрь `role="option"` вложить
+ * нельзя — его индикатор сам `role="checkbox"` с `tabindex="0"`, то есть ровно
+ * `nested-interactive`. Состояние объявляет `aria-selected` самой строки.
+ */
+export declare const transferMarkBase = "inline-flex shrink-0 items-center justify-center rounded-[var(--gr-radius-sm)] border border-[var(--gr-brd)] bg-[var(--gr-bg)]";
+export declare const transferMarkStates: {
+    readonly selected: "border-[var(--gr-primary)] bg-[var(--gr-primary)] text-[var(--gr-primary-fg)]";
+    readonly idle: "";
+};
+export declare const transferMarkIconClass = "h-3 w-3";
+export declare const transferLabelClass = "min-w-0 flex-1 truncate";
+/**
+ * Место вставки — псевдоэлемент строки-соседа, а не отдельный узел: лишний узел
+ * между строками ломает подсчёт позиций и разделители.
+ */
+export declare const transferIndicatorBeforeClass = "before:absolute before:inset-x-0 before:top-0 before:h-[var(--gr-transfer-indicator-width,3px)] before:rounded-[var(--gr-radius-full)] before:bg-[var(--gr-transfer-indicator,var(--gr-primary))] before:content-empty";
+export declare const transferIndicatorAfterClass = "after:absolute after:inset-x-0 after:bottom-0 after:h-[var(--gr-transfer-indicator-width,3px)] after:rounded-[var(--gr-radius-full)] after:bg-[var(--gr-transfer-indicator,var(--gr-primary))] after:content-empty";
+export declare const transferEmptyClass = "flex h-full items-center justify-center px-4 py-6 text-center text-[var(--gr-muted-fg)]";
+export declare const transferActionsClass = "flex shrink-0 items-center";
+/**
+ * Кнопки перестановки в шапке правой панели. Перестановка обязана быть видимой:
+ * сочетание `Alt` + стрелка её ускоряет, но само по себе неоткрываемо, а на
+ * macOS ещё и неудобно — почти все мета-клавиши там заняты системой.
+ *
+ * Стрелки горизонтальные, потому что порядок — это **последовательность**, а не
+ * положение на экране: правая панель задаёт порядок колонок отчёта или полей
+ * выгрузки, и они читаются слева направо.
+ *
+ * Сочетание при этом остаётся вертикальным (`Alt` + `↑`/`↓`), и расхождение с
+ * иконками намеренное: в Chrome и Firefox под Windows и Linux `Alt` + `←`/`→` —
+ * это «назад/вперёд» в истории браузера. В Safari навигация висит на
+ * `Cmd` + стрелках, то есть там сочетание было бы свободно, — но пакет едет ко
+ * всем, и ориентироваться на одну платформу нельзя.
+ */
+export declare const transferReorderBase = "inline-flex shrink-0 items-center justify-center rounded-[var(--gr-radius-sm)] text-[var(--gr-muted-fg)] transition-colors hover:bg-[var(--gr-muted)] hover:text-[var(--gr-fg)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const transferReorderSizes: Record<GrTransferSize, string>;
+export declare const transferReorderIconClass = "h-3.5 w-3.5";
+export declare function grTransferReorderClass(size: GrTransferSize): string;
+export declare const transferActionIconClass = "h-4 w-4 shrink-0";
+/**
+ * Кнопка без пути наружу остаётся в таб-порядке — нативный `disabled` уронил бы
+ * фокус в тело документа. Показывает она это правилом в `<style>` компонента, а
+ * не утилитой: у `GrButton` свой фон классом той же специфичности, и кто победит,
+ * решал бы порядок в сгенерированном CSS, то есть через раз.
+ */
+export declare const transferActionInertClass = "cursor-not-allowed";
+/**
+ * Предпросмотр переносимого: он и есть ответ на «где сейчас элемент».
+ *
+ * Без него строка оставалась на месте, а за курсором не двигалось ничего — жест
+ * выглядел так, будто ничего не происходит. Узел не ловит указатель
+ * (`pointer-events: none`), иначе он перехватывал бы попадание у самих панелей.
+ */
+export declare const transferGhostClass = "pointer-events-none fixed left-0 top-0 z-10 flex max-w-[16rem] items-center gap-2 rounded-[var(--gr-radius-md)] border border-[var(--gr-brd)] bg-[var(--gr-transfer-ghost-bg,var(--gr-card))] px-3 py-1.5 text-[var(--gr-fg)] shadow-[var(--gr-shadow-2)]";
+export declare const transferGhostLabelClass = "min-w-0 flex-1 truncate text-[length:var(--gr-control-text-sm)] leading-[var(--gr-control-leading-sm)]";
+/** Сколько строк едет разом: одну видно по подписи, остальные — числом. */
+export declare const transferGhostCountClass = "shrink-0 rounded-[var(--gr-radius-full)] bg-[var(--gr-primary)] px-1.5 text-[length:var(--gr-control-text-xs)] leading-[var(--gr-control-leading-xs)] text-[var(--gr-primary-fg)] tabular-nums";
+export declare const transferStatusClass = "sr-only";
+export declare const transferHeaderSizes: Record<GrTransferSize, string>;
+export declare const transferOptionSizes: Record<GrTransferSize, string>;
+export declare const transferMarkSizes: Record<GrTransferSize, string>;
+export declare const transferSearchSizes: Record<GrTransferSize, string>;
+export declare const transferEmptySizes: Record<GrTransferSize, string>;
+export declare const transferActionsSizes: Record<GrTransferSize, string>;
+export interface GrTransferOptionClassOptions {
+    size: GrTransferSize;
+    selected: boolean;
+    disabled: boolean;
+    draggable: boolean;
+    dragging: boolean;
+    arrived: boolean;
+    indicator: 'before' | 'after' | null;
+}
+export declare function grTransferOptionClass(options: GrTransferOptionClassOptions): string;
+export declare function grTransferMarkClass(size: GrTransferSize, selected: boolean): string;
+export declare function grTransferPanelClass(dropActive: boolean): string;
+export declare function grTransferEmptyClass(size: GrTransferSize): string;
+export declare function grTransferHeaderClass(size: GrTransferSize): string;
+export declare function grTransferSearchClass(size: GrTransferSize): string;
+export declare function grTransferActionsClass(size: GrTransferSize): string;

package/dist/types/components/GrTransfer/index.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrTransferComponent from './GrTransfer.vue';
+export { default } from './GrTransfer.vue';
+export { default as GrTransfer } from './GrTransfer.vue';
+export { grTransferConfig } from './config';
+export type { GrTransferConfigurableProps } from './defaults';
+export type { GrTransferEmits, GrTransferProps } from './GrTransfer.vue';
+export type { GrTransferSize } from './grTransferStyles';
+export { grTransferSafelist } from './safelist';
+export type { GrTransferDirection, GrTransferKey, GrTransferSide, } from './transferModel';
+export type GrTransferInstance = ComponentExposed<typeof GrTransferComponent>;

package/dist/types/components/GrTransfer/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grTransferSafelist: string[];

package/dist/types/components/GrTransfer/transferGeometry.d.ts

@@ -0,0 +1,44 @@
+import type { DragSortSpan } from '../../composables/internal/dragSortGeometry';
+import type { GrTransferKey, GrTransferSide } from './transferModel';
+/**
+ * Геометрия переноса между двумя панелями: чистая арифметика, без DOM.
+ *
+ * В jsdom раскладки нет — `getBoundingClientRect` там нули, — поэтому всё, что
+ * решает «куда попал указатель», живёт здесь и проверяется числами. Тот же
+ * довод, что у `dragSortGeometry` и `scrollOverflow`.
+ */
+/** Порог начала жеста. То же число, что у `useDragSort` и у переноса дашборда. */
+export declare const GR_TRANSFER_DRAG_THRESHOLD = 4;
+export interface GrTransferRect {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export interface GrTransferPoint {
+    x: number;
+    y: number;
+}
+export interface GrTransferPanelRects {
+    source: GrTransferRect | null;
+    target: GrTransferRect | null;
+}
+/**
+ * Панель под указателем; `null` — указатель в зазоре или за пределами обеих.
+ *
+ * Считается по прямоугольнику **обёртки панели**, а не по ближайшей строке:
+ * `hitTest` при промахе возвращает ближайший элемент, и указатель над пустой
+ * правой панелью резолвился бы в строку левой.
+ */
+export declare function sideAtPoint(rects: GrTransferPanelRects, point: GrTransferPoint): GrTransferSide | null;
+/**
+ * Перед какой строкой встанет блок; `null` — в конец панели.
+ *
+ * Цель — ключ, а не индекс: индекс пришлось бы пересчитывать после изъятия
+ * блока, и именно ради этого `insertionIndex` в `dragSortGeometry` носит
+ * поправку «элемент временно вынут». Для вставки из чужой панели поправка
+ * вредна — там ничего не вынимается, — поэтому та функция здесь не годится.
+ */
+export declare function dropBefore(keys: readonly GrTransferKey[], spans: readonly DragSortSpan[], position: number): GrTransferKey | null;
+/** Пройден ли порог начала жеста. */
+export declare function passedThreshold(from: GrTransferPoint, to: GrTransferPoint, threshold?: number): boolean;

package/dist/types/components/GrTransfer/transferModel.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Порядок и состав панелей: чистая арифметика над ключами, без DOM и Vue.
+ *
+ * Вынесена отдельно по той же причине, что и `dragSortGeometry`: ошибка здесь
+ * проявляется не исключением, а «строка встала не туда» или «выбор исчез после
+ * перезагрузки каталога» — поймать это можно только тестом на числах и
+ * массивах.
+ */
+export type GrTransferKey = string | number;
+export type GrTransferSide = 'source' | 'target';
+export type GrTransferDirection = 'toTarget' | 'toSource';
+export interface GrTransferSplit<TItem> {
+    /** Каталог минус модель, в порядке `items`. */
+    source: TItem[];
+    /** Отобранное, в порядке **модели**: порядок правой панели и есть значение. */
+    target: TItem[];
+    /** Ключи модели, которым в `items` ничего не соответствует. */
+    unresolved: GrTransferKey[];
+    /** Ключи, встретившиеся в `items` дважды: рисуется первый. */
+    duplicated: GrTransferKey[];
+}
+/**
+ * Ключи без дублей, первый выигрывает.
+ *
+ * Нормализация идёт **на чтение** и наружу сама по себе не эмитится: эмит из
+ * рендера — источник петель обновления. Нормализованный вид уезжает потребителю
+ * при первом же коммите.
+ */
+export declare function normalizeKeys(keys: readonly GrTransferKey[]): GrTransferKey[];
+/**
+ * Раскладка каталога по панелям.
+ *
+ * `target` строится обходом **модели**, а не `items`: порядок правой панели
+ * задаёт пользователь, и он же является значением. `source` — обходом `items`,
+ * потому что порядок каталога принадлежит потребителю.
+ */
+export declare function splitByModel<TItem>(items: readonly TItem[], keyOf: (item: TItem) => GrTransferKey, model: readonly GrTransferKey[]): GrTransferSplit<TItem>;
+/** Ключи в порядке эталонного списка; чего в нём нет — в конец, в порядке входа. */
+export declare function orderedBy(order: readonly GrTransferKey[], keys: Iterable<GrTransferKey>): GrTransferKey[];
+/** Изъятие блока. Вход не мутируется. */
+export declare function removeKeys(order: readonly GrTransferKey[], moving: readonly GrTransferKey[]): GrTransferKey[];
+/**
+ * Вставка блока перед ключом `before`; `null` или ненайденный ключ — в конец.
+ *
+ * Цель выражена ключом, а не индексом, намеренно: индекс пришлось бы
+ * пересчитывать после изъятия блока, и это ровно тот класс off-by-one, из-за
+ * которого `insertionIndex` в `dragSortGeometry` носит поправку «элемент
+ * временно вынут». Здесь поправка не нужна вовсе.
+ */
+export declare function insertKeys(order: readonly GrTransferKey[], moving: readonly GrTransferKey[], before: GrTransferKey | null): GrTransferKey[];
+/**
+ * Куда встанет блок при сдвиге на шаг; `undefined` — двигаться некуда.
+ *
+ * Рассыпанное выделение при сдвиге схлопывается в непрерывный блок: это
+ * предсказуемо и объяснимо, в отличие от попытки двигать каждый кусок
+ * независимо.
+ */
+export declare function stepTarget(order: readonly GrTransferKey[], moving: readonly GrTransferKey[], delta: 1 | -1): GrTransferKey | null | undefined;
+/** Крайняя позиция блока: `-1` — в начало, `1` — в конец. */
+export declare function edgeTarget(order: readonly GrTransferKey[], moving: readonly GrTransferKey[], edge: 'start' | 'end'): GrTransferKey | null | undefined;
+/**
+ * Какая строка останется под фокусом после изъятия.
+ *
+ * Без этого фокус после переноса падает на тело документа, и клавиатурный
+ * сценарий обрывается на первом же шаге — тот же довод, что у `drop()` в
+ * `GrSortableList`.
+ */
+export declare function keyAfterRemoval(visible: readonly GrTransferKey[], removed: readonly GrTransferKey[], focused: GrTransferKey | undefined): GrTransferKey | undefined;

package/dist/types/components/GrTransfer/transferSelection.d.ts

@@ -0,0 +1,36 @@
+import type { GrTransferKey } from './transferModel';
+/**
+ * Алгебра выделения панели: чистая, без DOM и Vue.
+ *
+ * Мультивыбор со `Shift`-диапазоном в пакете появляется впервые, прецедента API
+ * нет — тем важнее, чтобы правила лежали числами в одном месте и проверялись
+ * без монтирования.
+ */
+export type GrTransferSelectMode = 'replace' | 'toggle' | 'range';
+export interface GrTransferSelectIntent {
+    mode: GrTransferSelectMode;
+    /** Диапазон объединяется с текущим выделением, а не заменяет его. */
+    additive: boolean;
+}
+export interface GrTransferSelection {
+    keys: ReadonlySet<GrTransferKey>;
+    /** Опора диапазона. `Shift` её не двигает — иначе диапазон нельзя растянуть. */
+    anchor: GrTransferKey | undefined;
+}
+export declare const emptySelection: GrTransferSelection;
+/** `Shift` сильнее `Ctrl`; их сочетание объединяет диапазон с выделением. */
+export declare function selectIntentFrom(event: Pick<MouseEvent, 'shiftKey' | 'ctrlKey' | 'metaKey'>): GrTransferSelectIntent;
+/**
+ * Новое состояние выделения после жеста по строке `key`.
+ *
+ * Диапазон считается по **видимому** порядку, а не по каталогу: пользователь
+ * растягивает то, что видит, и после фильтра «от сих до сих» обязано значить
+ * то же самое.
+ */
+export declare function applySelect(state: GrTransferSelection, key: GrTransferKey, intent: GrTransferSelectIntent, visible: readonly GrTransferKey[], isSelectable: (key: GrTransferKey) => boolean): GrTransferSelection;
+/** Всё видимое и выбираемое; уже выбрано всё — снять. */
+export declare function toggleAllVisible(state: GrTransferSelection, visible: readonly GrTransferKey[], isSelectable: (key: GrTransferKey) => boolean): GrTransferSelection;
+/** Ключи, которых больше нет в панели. Якорь исчез — забываем и его. */
+export declare function pruneSelection(state: GrTransferSelection, present: readonly GrTransferKey[]): GrTransferSelection;
+/** Состояние отметки «выбрать всё видимое» в шапке панели. */
+export declare function allVisibleState(state: GrTransferSelection, visible: readonly GrTransferKey[], isSelectable: (key: GrTransferKey) => boolean): 'checked' | 'indeterminate' | 'unchecked';

package/dist/types/components/GrTransfer/useTransferDrag.d.ts

@@ -0,0 +1,48 @@
+import type { ShallowRef } from 'vue';
+import type { GrTransferPoint } from './transferGeometry';
+import type { GrTransferKey, GrTransferSide } from './transferModel';
+/** Что тянут: сторона-источник и весь переносимый блок. */
+export interface GrTransferDragSession {
+    side: GrTransferSide;
+    keys: readonly GrTransferKey[];
+}
+/** Куда положат: сторона-приёмник и ключ, перед которым встанет блок. */
+export interface GrTransferDropSpot {
+    side: GrTransferSide;
+    before: GrTransferKey | null;
+}
+export interface UseTransferDragOptions {
+    disabled: () => boolean;
+    /** Ключи панели в порядке показа. */
+    visibleKeys: (side: GrTransferSide) => readonly GrTransferKey[];
+    rowEl: (side: GrTransferSide, key: GrTransferKey) => HTMLElement | null;
+    /** Обёртка панели: по её прямоугольнику выбирается приёмник. */
+    panelEl: (side: GrTransferSide) => HTMLElement | null;
+    /** Скроллер панели: по нему считается автопрокрутка. */
+    scrollerEl: (side: GrTransferSide) => HTMLElement | null;
+    /** Что тянуть: всё выделение, если взялись за выделенную строку, иначе одну. */
+    blockFor: (side: GrTransferSide, key: GrTransferKey) => readonly GrTransferKey[];
+    /** Можно ли ронять обратно в свою панель (перестановка). */
+    allowSameSide: (side: GrTransferSide) => boolean;
+    onDrop: (session: GrTransferDragSession, spot: GrTransferDropSpot) => void;
+    onCancel?: () => void;
+}
+export interface UseTransferDragReturn {
+    session: Readonly<ShallowRef<GrTransferDragSession | null>>;
+    spot: Readonly<ShallowRef<GrTransferDropSpot | null>>;
+    /** Где указатель прямо сейчас: за ним едет предпросмотр переносимого. */
+    pointer: Readonly<ShallowRef<GrTransferPoint>>;
+    /** Был ли жест — чтобы следующий `click` не схлопнул выделение. */
+    consumeClick: () => boolean;
+    startFrom: (side: GrTransferSide, key: GrTransferKey) => (event: PointerEvent) => void;
+    cancel: () => void;
+}
+/**
+ * Перетаскивание между панелями.
+ *
+ * `useDragSort` здесь не подходит: его `resolveTarget` получает попадание, но не
+ * точку указателя, а панель-приёмник определяется прямоугольником под точкой —
+ * `hitTest` при промахе отдаёт ближайшую строку, и указатель над пустой правой
+ * панелью резолвился бы в строку левой.
+ */
+export declare function useTransferDrag(options: UseTransferDragOptions): UseTransferDragReturn;

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

@@ -11,6 +11,7 @@ export declare const granularityDefaultThemes: readonly GranularityThemeName[];
  * `@feugene/granularity/components/<Name>`.
  */
 export declare const granularityComponentConfigs: {
+    GrAffix: GranularComponentDescriptor<"GrAffix">;
     GrAlert: GranularComponentDescriptor<"GrAlert">;
     GrAutocomplete: GranularComponentDescriptor<"GrAutocomplete">;
     GrAvatar: GranularComponentDescriptor<"GrAvatar">;
@@ -21,6 +22,7 @@ export declare const granularityComponentConfigs: {
     GrButton: GranularComponentDescriptor<"GrButton">;
     GrButtonGroup: GranularComponentDescriptor<"GrButtonGroup">;
     GrCard: GranularComponentDescriptor<"GrCard">;
+    GrCarousel: GranularComponentDescriptor<"GrCarousel">;
     GrCheckbox: GranularComponentDescriptor<"GrCheckbox">;
     GrCheckboxGroup: GranularComponentDescriptor<"GrCheckboxGroup">;
     GrChip: GranularComponentDescriptor<"GrChip">;
@@ -85,6 +87,7 @@ export declare const granularityComponentConfigs: {
     GrTimeline: GranularComponentDescriptor<"GrTimeline">;
     GrToaster: GranularComponentDescriptor<"GrToaster">;
     GrTooltip: GranularComponentDescriptor<"GrTooltip">;
+    GrTransfer: GranularComponentDescriptor<"GrTransfer">;
     GrTree: GranularComponentDescriptor<"GrTree">;
     GrTreeSelect: GranularComponentDescriptor<"GrTreeSelect">;
     GrValue: GranularComponentDescriptor<"GrValue">;