@feugene/granularity 0.18.0 → 0.20.0

package/dist/types/components/GrStatistic/grStatisticStyles.d.ts

@@ -0,0 +1,36 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
+export type GrStatisticSize = GrComponentSize;
+export type GrStatisticTone = GrTone;
+/** Направление динамики показателя. */
+export type GrStatisticTrend = 'up' | 'down' | 'flat';
+/**
+ * Кастомизация через CSS-переменные:
+ *
+ * - `--gr-statistic-value-color` — цвет значения (по умолчанию — из `tone`).
+ * - `--gr-statistic-title-color` — цвет подписи показателя.
+ */
+export declare const statisticTitleSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticValueSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticAffixSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticPlaceholderHeightBySize: Record<GrStatisticSize, string>;
+export declare const statisticTrendSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticValueClassByTone: Record<GrStatisticTone, string>;
+export declare const statisticTrendClassByTrend: Record<GrStatisticTrend, string>;
+export declare const statisticTitleClass = "font-medium tracking-wide text-[var(--gr-statistic-title-color,var(--gr-muted-fg))]";
+export declare const statisticRootBase = "flex items-start gap-3 text-left";
+/**
+ * Показатель-ссылка или показатель-кнопка. Своей заливки не получает: плитка
+ * дашборда обычно уже лежит в `GrCard`, и вторая поверхность спорила бы с ней.
+ * Видимость интерактивности держат курсор, фокус-кольцо и подсветка подписи.
+ */
+export declare const statisticRootInteractiveClass = "w-full cursor-pointer rounded-[var(--gr-radius-md)] transition-colors hover:bg-[var(--gr-muted)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare function statisticRootClass(options: {
+    interactive: boolean;
+}): string;
+/** `tabular-nums` держит ширину строки при переборе чисел и при смене значения. */
+export declare const statisticValueTypographyClass = "font-semibold tabular-nums";
+export declare function statisticValueClass(options: {
+    size: GrStatisticSize;
+    tone: GrStatisticTone;
+}): string;

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

@@ -0,0 +1,7 @@
+export { default } from './GrTabPanels.vue';
+export { default as GrTabPanels } from './GrTabPanels.vue';
+export { default as GrTabPanel } from './GrTabPanel.vue';
+export type { GrTabPanelsContext } from './context';
+export { grTabPanelsConfig } from './config';
+export type { GrTabPanelsProps } from './GrTabPanels.vue';
+export type { GrTabPanelProps } from './GrTabPanel.vue';

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

@@ -0,0 +1,121 @@
+import { type Component } from 'vue';
+import { type GrTabsOrientation, type GrTabsSize, type GrTabsVariant } from './grTabsStyles';
+export interface GrTab {
+    value: string;
+    label: string;
+    badge?: string;
+    /**
+     * Иконка слева от подписи: Vue-компонент либо класс иконки вашей UnoCSS-сборки
+     * (`'i-lucide-user'` — тогда нужен ваш `presetIcons`, см. `docs/installation.md`).
+     */
+    icon?: string | Component;
+    disabled?: boolean;
+    /** Перекрывает `closable` ряда в обе стороны: закрепить вкладку или закрыть одну её. */
+    closable?: boolean;
+}
+export interface GrTabsProps {
+    modelValue: string;
+    tabs: GrTab[];
+    /**
+     * База id для ARIA-связки с `GrTabPanels`. Если задана, каждая вкладка
+     * получает `id="<idBase>-tab-<value>"` и `aria-controls="<idBase>-panel-<value>"`.
+     * Передайте тот же `idBase` в `GrTabPanels`, чтобы связать `tab`↔`tabpanel`.
+     */
+    idBase?: string;
+    size?: GrTabsSize;
+    /** Вид ряда: обойма с таблетками или ряд с подчёркиванием. */
+    variant?: GrTabsVariant;
+    /**
+     * `automatic` (по умолчанию) — стрелка сразу переключает вкладку;
+     * `manual` — стрелка двигает только фокус, выбор подтверждается
+     * `Enter`/`Space`. Второй режим для вкладок с тяжёлой загрузкой: перебор
+     * стрелками иначе тянет каждую панель.
+     */
+    activationMode?: GrTabsActivationMode;
+    /** Горизонтальный (по умолчанию) или вертикальный список вкладок. */
+    orientation?: GrTabsOrientation;
+    /**
+     * Крестик на вкладках и закрытие по `Delete`/`Backspace`. Точечно снимается
+     * `closable: false` у самой вкладки.
+     */
+    closable?: boolean;
+    /** Текст, когда список вкладок пуст. Слот `#empty` сильнее. */
+    emptyText?: string;
+}
+export interface GrTabsEmits {
+    (e: 'update:modelValue', value: string): void;
+    /**
+     * Просьба закрыть вкладку. Компонент список не трогает: `tabs` — проп, и
+     * закрытие может не состояться («сохранить изменения?»).
+     */
+    (e: 'close', value: string): void;
+}
+export type GrTabsActivationMode = 'automatic' | 'manual';
+export type { GrTabsOrientation, GrTabsVariant } from './grTabsStyles';
+type __VLS_Slots = {
+    /** Содержимое вкладки целиком — вместо подписи, иконки и счётчика. Крестик остаётся. */
+    tab?: (props: {
+        tab: GrTab;
+        active: boolean;
+        disabled: boolean;
+    }) => unknown;
+    /** Пустой ряд — вместо текста из локали. */
+    empty?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabsProps>, {
+    idBase: undefined;
+    size: undefined;
+    variant: undefined;
+    activationMode: string;
+    orientation: string;
+    closable: boolean;
+    emptyText: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string) => void;
+    close: (value: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabsProps>, {
+    idBase: undefined;
+    size: undefined;
+    variant: undefined;
+    activationMode: string;
+    orientation: string;
+    closable: boolean;
+    emptyText: undefined;
+}>>> & Readonly<{
+    onClose?: ((value: string) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {
+    variant: GrTabsVariant;
+    closable: boolean;
+    size: GrTabsSize;
+    orientation: GrTabsOrientation;
+    emptyText: string;
+    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;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+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/GrTabs/index.d.ts

@@ -0,0 +1,8 @@
+export { default } from './GrTabs.vue';
+export { default as GrTabs } from './GrTabs.vue';
+export type { GrTab, GrTabsProps } from './GrTabs.vue';
+export { grTabsConfig } from './config';
+export type { GrTabsConfigurableProps } from './defaults';
+export type { GrTabsOrientation, GrTabsSize, GrTabsVariant } from './grTabsStyles';
+export { grTabsSafelist } from './safelist';
+export type { GrTabsEmits } from './GrTabs.vue';

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

@@ -0,0 +1,10 @@
+export { default } from './GrTimeline.vue';
+export { default as GrTimeline } from './GrTimeline.vue';
+export type { GrTimelineDensity, GrTimelineGroupBy, GrTimelineLayout, GrTimelineOrientation, GrTimelineProps, } from './GrTimeline.vue';
+export { default as GrTimelineItem } from './GrTimelineItem.vue';
+export type { GrTimelineItemProps, GrTimelineMarkerVariant, GrTimelineTone, } from './GrTimelineItem.vue';
+export { grTimelineConfig } from './config';
+export type { GrTimelineHeadingLevel } from './grTimelineContext';
+export { grTimelineSafelist } from './safelist';
+export type { GrTimelineEntry, GrTimelineGroup } from './timelineGroups';
+export type { GrTimelineConfigurableProps } from './defaults';

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

@@ -0,0 +1,119 @@
+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>;
+export type GrTreePropsMap = {
+    children?: string;
+    label?: string;
+    /** Поле данных «узел — лист». Нужно ленивому режиму: детей ещё нет, а раскрывать нечего. */
+    isLeaf?: string;
+};
+export type GrTreeFilterNodeMethod<T extends object = any> = (value: string, data: T, node?: GrTreeNode<T>) => boolean;
+export type GrTreeBranchLineColor<T extends object = any> = string | ((node: GrTreeNode<T>) => string | undefined | null);
+export type GrTreeVisibleRow<T extends object> = {
+    node: GrTreeNode<T>;
+    isExpanded: boolean;
+    isLeaf: boolean;
+    isMatched: boolean;
+    /**
+     * Место узла среди соседей. В плоском DOM группы нет, поэтому структуру
+     * дерева диктору сообщают `aria-level` + `aria-posinset` + `aria-setsize`.
+     */
+    posInSet: number;
+    setSize: number;
+    /** Идёт ли сейчас ленивая загрузка детей этого узла. */
+    isLoading: boolean;
+    /** Цвета направляющих для уровней предков (пусто, если `branchLine` выключен). */
+    branchColors: string[];
+};
+export type GrTreeClassValue = HTMLAttributes['class'];
+export type GrTreeNodeClass<T extends object> = GrTreeClassValue | ((row: GrTreeVisibleRow<T>) => GrTreeClassValue);
+export type GrTreeDataProps<T extends object> = {
+    data: T[];
+    props?: GrTreePropsMap;
+    nodeKey?: NodeKeyProp<T> | 'id';
+    defaultExpandedKeys?: GrTreeKey[];
+    /**
+     * Раскрывать узлы, как только они появились в данных. Уже свёрнутое руками
+     * не раскрывается обратно на каждом обновлении `data`.
+     */
+    defaultExpandAll?: boolean;
+    filterNodeMethod?: GrTreeFilterNodeMethod<T>;
+    /**
+     * Ленивый режим: дети ветки приходят по её раскрытию через `load`.
+     * Узел считается разворачиваемым, пока не доказано обратное — полем `isLeaf`
+     * из карты `props`.
+     */
+    lazy?: boolean;
+    /** Загрузчик ветки. `resolve` дописывает детей в данные узла. */
+    load?: GrTreeLoad<T>;
+};
+export type GrTreeLoad<T extends object = any> = (node: GrTreeNode<T>, resolve: (children: T[]) => void) => void;
+export type GrTreeViewProps<T extends object> = {
+    /** Размер строки: высота, отступы, иконки и кегль подписи. */
+    size?: GrTreeSize;
+    /** Шаг отступа уровня в пикселях. `0` — значение из темы (`--gr-tree-indent-step`). */
+    indent?: number;
+    /**
+     * Виртуализация: в DOM живёт только окно вокруг вьюпорта.
+     *
+     * Требует `maxHeight` — без ограниченной высоты окна прокрутки не существует;
+     * скроллером в этом режиме становится сам корень дерева.
+     *
+     * Включается осознанно: на списке в сотню узлов выигрыша нет, а в DOM остаётся
+     * только окно — вместе с ним меняется и то, что находит `querySelector`
+     * потребителя.
+     *
+     * Ограничение: перетаскивание работает по отрисованным строкам — уронить узел
+     * на тот, которого нет на экране, нельзя.
+     */
+    virtual?: boolean;
+    /** Максимальная высота дерева со своим скроллером. Число — пиксели. */
+    maxHeight?: number | string;
+    highlightCurrent?: boolean;
+    /**
+     * Иконка свёрнутого узла: Vue-компонент либо класс иконки вашей UnoCSS-сборки
+     * (`'i-lucide-plus'` — тогда нужен ваш `presetIcons`, см. `docs/installation.md`).
+     * Не задана — встроенная стрелка.
+     */
+    expandIcon?: string | Component;
+    /** Иконка раскрытого узла. Не задана — та же встроенная стрелка, повёрнутая. */
+    collapseIcon?: string | Component;
+    toggleIconRotate?: boolean;
+    branchLine?: boolean;
+    branchLineColor?: GrTreeBranchLineColor<T>;
+    branchLineActiveColor?: GrTreeBranchLineColor<T>;
+    rowClass?: GrTreeNodeClass<T>;
+    dragHandleClass?: GrTreeNodeClass<T>;
+    toggleClass?: GrTreeNodeClass<T>;
+    toggleIconClass?: GrTreeNodeClass<T>;
+    toggleSpacerClass?: GrTreeNodeClass<T>;
+    contentClass?: GrTreeNodeClass<T>;
+    /** i18n-метка кнопки "Перетащить" (default: 'Drag'). */
+    dragLabel?: string;
+    /** i18n-метка кнопки "Развернуть" (default: 'Expand'). */
+    expandLabel?: string;
+    /** i18n-метка кнопки "Свернуть" (default: 'Collapse'). */
+    collapseLabel?: string;
+};
+export type GrTreeInteractionProps<T extends object> = {
+    /** Клик по строке раскрывает/сворачивает узел, а не только выбирает его. */
+    expandOnClickNode?: boolean;
+    /** На каждом уровне раскрыт максимум один узел. */
+    accordion?: boolean;
+    draggable?: boolean;
+    /** Иконка ручки переноса: компонент, класс иконки или ничего — тогда встроенная. */
+    dragHandleIcon?: string | Component;
+    allowDrop?: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, type: GrTreeAllowDropType) => boolean;
+    allowDrag?: (draggingNode: GrTreeNode<T>) => boolean;
+};
+export type GrTreeSelectionProps = {
+    /** Чекбоксы у узлов: множественный выбор поверх дерева. */
+    showCheckbox?: boolean;
+    /** Отмеченные ключи (`v-model:checked-keys`). */
+    checkedKeys?: GrTreeKey[];
+    defaultCheckedKeys?: GrTreeKey[];
+    /** Не связывать родителей и детей: каждый узел отмечается сам по себе. */
+    checkStrictly?: boolean;
+};
+export type GrTreeProps<T extends object> = GrTreeDataProps<T> & GrTreeViewProps<T> & GrTreeSelectionProps & GrTreeInteractionProps<T>;

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

@@ -0,0 +1 @@
+export declare const grTreeSafelist: readonly [];

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

@@ -0,0 +1,63 @@
+import { type GrTreeNode } from '../GrTree';
+import type { GrTreeSelectModelValue, GrTreeSelectProps } from './grTreeSelectTypes';
+export interface GrTreeSelectEmits<T extends Record<string, any> = any> {
+    (e: 'update:modelValue', value: GrTreeSelectModelValue): void;
+    (e: 'change', value: GrTreeSelectModelValue): void;
+    /** Панель открылась/закрылась (`v-model:open`). */
+    (e: 'update:open', value: boolean): void;
+    (e: 'clear'): void;
+    (e: 'nodeClick', data: T, node: GrTreeNode<T>): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare const __VLS_export: <T extends Record<string, any> = any>(__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<GrTreeSelectProps<T> & {
+        onClear?: (() => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((value: GrTreeSelectModelValue) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: GrTreeSelectModelValue) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
+        onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        focus: () => void;
+        blur: () => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        /** Рендер значения внутри триггера (вместо дефолтного текста). */
+        value?: (props: {
+            value: GrTreeSelectModelValue;
+            labels: string[];
+            displayValue: string;
+            pathLabels?: string[];
+        }) => any;
+        /** Рендер строки дерева. */
+        node?: (props: {
+            node: GrTreeNode<T>;
+            data: T;
+            selected: boolean;
+        }) => any;
+        /** Содержимое пустого состояния (когда нет данных). */
+        empty?: () => any;
+        /** Содержимое панели, пока данные едут. */
+        loading?: () => any;
+        /** Аддон слева от значения: иконка, код валюты, метка. */
+        prefix?: () => any;
+        /** Аддон справа от значения, перед крестиком и шевроном. */
+        suffix?: () => any;
+    };
+    emit: GrTreeSelectEmits<T>;
+}>) => 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/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/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/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/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/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/testing/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Тестовые утилиты пакета — `@feugene/granularity/testing`.
+ *
+ * Ни `vitest`, ни `@vue/test-utils` здесь нет и не будет: утилиты отдают данные
+ * и действия над DOM, а монтирует и утверждает потребитель — своим раннером.
+ * Документация: `docs/testing.md`.
+ */
+export { cancelPointer, drag, move, pointer, press, release } from './pointer';
+export { composingKeydown, keyboardEvent, type KeyboardEventOptions, keydown } from './keyboard';
+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/testing/keyboard.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Клавиатурные события в тестах.
+ *
+ * Существует ради одного флага: **`isComposing` не переживает
+ * `wrapper.trigger('keydown', …)`**. `@vue/test-utils` собирает событие из
+ * переданного объекта, но `isComposing` — свойство только для чтения на
+ * `KeyboardEvent`, и присвоение молча теряется. Тест «Enter во время
+ * IME-композиции ничего не коммитит» при такой записи проверяет обычный Enter,
+ * то есть зеленеет на сломанном коде.
+ *
+ * Пакет читает флаг через `isComposingEvent` (`src/internal/keyboard.ts`) —
+ * `event.isComposing || event.keyCode === 229`, потому что Safari до 16.4 не
+ * ставил первое. Генератор ставит оба, иначе тест проверял бы половину предиката.
+ *
+ * Композиция — это не экзотика: пока пользователь набирает 日本語, 한국어 или
+ * что угодно через IME, `Enter` подтверждает **выбор иероглифа**, а не действие
+ * виджета. Компонент, который на нём выберет опцию или отправит форму, у такого
+ * пользователя неработоспособен.
+ */
+export type KeyboardEventOptions = KeyboardEventInit & {
+    key: string;
+};
+/** Клавиатурное событие с разумными умолчаниями (всплывает, отменяемо). */
+export declare function keyboardEvent(type: string, init: KeyboardEventOptions): KeyboardEvent;
+/** Нажатие клавиши в элемент. */
+export declare function keydown(target: Element, key: string, init?: KeyboardEventInit): KeyboardEvent;
+/**
+ * Нажатие во время IME-композиции. Отдельная функция, а не флаг у `keydown`:
+ * из имени в тесте видно, что проверяется, а `keyCode: 229` не приходится
+ * помнить на каждом вызове.
+ */
+export declare function composingKeydown(target: Element, key: string, init?: KeyboardEventInit): KeyboardEvent;

package/dist/types/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/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;

package/dist/types/theme/color.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Цветовая математика пакета — один источник на всех.
+ *
+ * Одну и ту же формулу считают три разных потребителя: генератор токенов
+ * (фолбэки `@supports not (color-mix)`), композиция тем (`extendTheme`, `tone`)
+ * и гейты контраста. Расхождение здесь не абстрактно: фолбэки уже жили
+ * отдельной копией из сорока хексов, которые обязаны были совпадать с живым
+ * `color-mix` до байта, и не совпадали.
+ *
+ * Модуль читает и генератор (`scripts/generate-tokens.mjs`, запускается
+ * `node --experimental-strip-types`), поэтому синтаксис здесь только стираемый:
+ * ни `enum`, ни `namespace`, ни параметров-свойств в конструкторах.
+ */
+export type Rgb = [number, number, number];
+export declare function parseHex(value: string): Rgb;
+export declare function toHex(channels: Rgb): string;
+/**
+ * `color-mix(in srgb, base <amount>%, other)` для непрозрачных цветов — это
+ * линейная интерполяция в gamma-кодированном sRGB, то есть ровно то, что делает
+ * браузер. Поэтому посчитанный здесь фолбэк совпадает с живым `color-mix`.
+ */
+export declare function mixSrgb(baseHex: string, otherHex: string, amount: number): string;
+export declare function luminance(color: string | Rgb): number;
+/** Отношение контраста по WCAG 2.1: от 1 (одинаковые) до 21 (чёрное на белом). */
+export declare function contrast(foreground: string | Rgb, background: string | Rgb): number;
+/**
+ * Воспринимаемое расстояние между цветами (ΔE, CIE76).
+ *
+ * Контраст отвечает на вопрос «читается ли текст», а этот — на вопрос
+ * «различит ли человек два тона рядом». Порог заметности около 2.3; всё, что
+ * ниже, для глаза один цвет, каким бы разным ни выглядел hex.
+ */
+export declare function deltaE(first: string | Rgb, second: string | Rgb): number;
+/** Цвет — это hex, а не `var()`/`rgb()`: производные и контраст считаются только по нему. */
+export declare function isHex(value: string): boolean;