@feugene/granularity 0.13.0 → 0.18.0

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

@@ -1,3 +1,4 @@
+import { type GrPaginationSize } from './grPaginationStyles';
 /**
  * Пропы пагинации.
  *
@@ -22,16 +23,45 @@ export interface GrPaginationProps {
     compact?: boolean;
     /** Показывать поле «перейти к странице» с быстрым переходом по вводу номера. */
     showJumper?: boolean;
+    /** Показывать селект размера страницы. */
+    showPageSize?: boolean;
+    /** Показывать диапазон показанных элементов — «1–20 из 137». Слот `#total` сильнее. */
+    showTotal?: boolean;
     /** i18n-подпись перед полем перехода. По умолчанию — `gr.pagination.jumpTo`. */
     jumperLabel?: string;
+    /**
+     * Имя навигационного лендмарка. По умолчанию — `gr.pagination.label`; задавать
+     * стоит там, где пагинаций на странице несколько и их надо различать.
+     */
+    ariaLabel?: string;
+    /** Гасит всю пагинацию: номера, кнопки, селект размера и поле перехода. */
+    disabled?: boolean;
+    size?: GrPaginationSize;
+}
+export interface GrPaginationEmits {
+    (e: 'update:page', value: number): void;
+    (e: 'update:pageSize', value: number): void;
 }
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPaginationProps>, {
+type __VLS_Slots = {
+    /** Диапазон показанных элементов целиком — вместо строки из локали. */
+    total?: (props: {
+        from: number;
+        to: number;
+        total: number;
+    }) => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPaginationProps>, {
     pageSizes: () => number[];
     siblingCount: number;
     boundaryCount: number;
     compact: boolean;
     showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
     jumperLabel: undefined;
+    ariaLabel: undefined;
+    disabled: boolean;
+    size: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:page": (value: number) => void;
     "update:pageSize": (value: number) => void;
@@ -41,18 +71,29 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     boundaryCount: number;
     compact: boolean;
     showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
     jumperLabel: undefined;
+    ariaLabel: undefined;
+    disabled: boolean;
+    size: undefined;
 }>>> & Readonly<{
     "onUpdate:page"?: ((value: number) => any) | undefined;
     "onUpdate:pageSize"?: ((value: number) => any) | undefined;
 }>, {
+    size: GrPaginationSize;
     compact: boolean;
+    disabled: boolean;
+    ariaLabel: string;
     pageSizes: number[];
     siblingCount: number;
     boundaryCount: number;
     showJumper: boolean;
+    showPageSize: boolean;
+    showTotal: boolean;
     jumperLabel: string;
 }, {}, {}, {}, 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> = {
@@ -68,6 +109,11 @@ type __VLS_WithDefaults<P, D> = {
         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];
 } : {

package/dist/types/src/components/GrPagination/config.d.ts

@@ -1 +1 @@
-export declare const grPaginationConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrPagination">;
+export declare const grPaginationConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrPagination">;

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

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrPagination`, настраиваемые глобально через `componentDefaults`. */
+export interface GrPaginationConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrPagination: GrPaginationConfigurableProps;
+    }
+}

package/dist/types/src/components/GrPagination/grPaginationStyles.d.ts

@@ -0,0 +1,19 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrPaginationSize = GrComponentSize;
+/** Номер страницы и многоточие: одна и та же коробка, чтобы ряд не прыгал. */
+export declare const pageSizes: Record<GrPaginationSize, string>;
+/** Коробка та же, что у номера, но поле́ уже: многоточию не нужен клик-таргет. */
+export declare const ellipsisSizes: Record<GrPaginationSize, string>;
+/** Вспомогательный текст: индикатор «текущая / всего» и подпись у поля перехода. */
+export declare const labelSizes: Record<GrPaginationSize, string>;
+export declare const jumperSizes: Record<GrPaginationSize, string>;
+export declare const rowGaps: Record<GrPaginationSize, string>;
+export declare const pageListGaps: Record<GrPaginationSize, string>;
+export declare const pageSizeSelectWidths: Record<GrPaginationSize, string>;
+/**
+ * Навигационные кнопки берут размер из шкалы `GrButton`, а не из своей: они
+ * обязаны стоять в один ряд с номерами страниц, а высоты у `GrButton`
+ * `xs…lg` — `28/32/40/44px`. На `md` номера страниц ростом `h-8`, поэтому
+ * кнопке достаётся `sm`, а не одноимённый `md`.
+ */
+export declare const navButtonSizes: Record<GrPaginationSize, GrComponentSize>;

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

@@ -1,3 +1,7 @@
 export { default } from './GrPagination.vue';
 export { default as GrPagination, type GrPaginationProps } from './GrPagination.vue';
 export { grPaginationConfig } from './config';
+export type { GrPaginationConfigurableProps } from './defaults';
+export type { GrPaginationSize } from './grPaginationStyles';
+export { grPaginationSafelist } from './safelist';
+export type { GrPaginationEmits } from './GrPagination.vue';

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

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

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

@@ -0,0 +1,161 @@
+import { type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrPopoverRole, type GrPopoverSize } from './grPopoverStyles';
+export interface GrPopoverProps {
+    /**
+     * Открыт ли поповер. Без этого пропа компонент ведёт состояние сам
+     * (uncontrolled), с ним — слушайте `update:open`.
+     */
+    open?: boolean;
+    placement?: UseFloatingPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offsetPx?: number;
+    size?: GrPopoverSize;
+    /** Роль панели. Меняется теми, кто строит поверх примитива своё меню/список. */
+    role?: GrPopoverRole;
+    /**
+     * Модальный режим: фон уходит в `inert`, Tab ходит по кругу внутри панели,
+     * скролл страницы блокируется, а слой встаёт в стек модальным — как окно.
+     * Нужен поповеру с формой или подтверждением внутри: без изоляции фона
+     * пользователь уводит фокус на страницу, к которой поповер и относится.
+     *
+     * В этом режиме фокус переносится в панель независимо от `autoFocus`: фон
+     * недоступен, и слой без фокуса внутри стал бы клавиатурной ловушкой.
+     */
+    modal?: boolean;
+    /** Доступное имя панели. Обязательно для `role="dialog"` без видимого заголовка. */
+    ariaLabel?: string;
+    /** `id` видимого заголовка внутри панели — альтернатива `ariaLabel`. */
+    labelledBy?: string;
+    /**
+     * `manual` — открывать только программно (через `v-model:open`). Нужно для
+     * контекстного меню и подтверждений, где момент открытия решает потребитель.
+     */
+    trigger?: 'click' | 'manual';
+    closeOnEsc?: boolean;
+    closeOnClickOutside?: boolean;
+    /** Закрывать по клику внутри панели — удобно для меню, вредно для формы. */
+    closeOnContentClick?: boolean;
+    /**
+     * Переносить фокус на панель при открытии. Именно на панель, а не на первый
+     * контрол внутри: сфокусировать поле ввода за пользователя — решение
+     * содержимого, а не оболочки.
+     */
+    autoFocus?: boolean;
+    /**
+     * Точечное переопределение точки монтирования. По умолчанию — общий портал
+     * оверлеев (`#gr-portal` либо `portalTarget` из `GrConfigProvider`).
+     */
+    teleportTo?: string | HTMLElement;
+    contentClass?: string;
+    disabled?: boolean;
+}
+export interface GrPopoverEmits {
+    (e: 'update:open', value: boolean): void;
+}
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
+declare var __VLS_1: {
+    open: boolean;
+    toggle: typeof toggle;
+    close: typeof close;
+    triggerProps: {
+        'aria-haspopup': "dialog" | "menu" | "grid" | "listbox" | undefined;
+        'aria-expanded': boolean;
+        'aria-controls': string | undefined;
+        disabled: true | undefined;
+    };
+}, __VLS_15: {
+    close: typeof close;
+};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_1) => any;
+} & {
+    content?: (props: typeof __VLS_15) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPopoverProps>, {
+    open: undefined;
+    placement: string;
+    offsetPx: number;
+    size: undefined;
+    role: string;
+    modal: boolean;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    trigger: string;
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: undefined;
+    contentClass: undefined;
+    disabled: boolean;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrPopoverProps>, {
+    open: undefined;
+    placement: string;
+    offsetPx: number;
+    size: undefined;
+    role: string;
+    modal: boolean;
+    ariaLabel: undefined;
+    labelledBy: undefined;
+    trigger: string;
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: undefined;
+    contentClass: undefined;
+    disabled: boolean;
+}>>> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrPopoverSize;
+    role: GrPopoverRole;
+    modal: boolean;
+    placement: UseFloatingPlacement;
+    open: boolean;
+    disabled: boolean;
+    ariaLabel: string;
+    labelledBy: string;
+    offsetPx: number;
+    trigger: "click" | "manual";
+    closeOnEsc: boolean;
+    closeOnClickOutside: boolean;
+    closeOnContentClick: boolean;
+    autoFocus: boolean;
+    teleportTo: string | HTMLElement;
+    contentClass: string;
+}, {}, {}, {}, 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/src/components/GrPopover/config.d.ts

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

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

@@ -0,0 +1,15 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/**
+ * Пропы `GrPopover`, настраиваемые глобально через `componentDefaults`.
+ *
+ * Только оформление: `open` и обработчики принадлежат конкретному экземпляру и
+ * через конфиг задаваться не должны.
+ */
+export interface GrPopoverConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrPopover: GrPopoverConfigurableProps;
+    }
+}

package/dist/types/src/components/GrPopover/grPopoverStyles.d.ts

@@ -0,0 +1,28 @@
+import type { Placement } from '@floating-ui/dom';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrPopoverSize = GrComponentSize;
+/**
+ * Роль панели.
+ *
+ * `dialog` — произвольный интерактивный контент (значение по умолчанию).
+ * Остальные нужны компонентам, которые строятся поверх этого примитива:
+ * меню (`GrMenu`, `GrContextMenu`), списки, палитры. Роль задаёт потребитель,
+ * потому что клавиатурный паттерн принадлежит ему, а не поповеру.
+ */
+export type GrPopoverRole = 'dialog' | 'menu' | 'listbox' | 'grid' | 'group' | 'none';
+export declare const panelSizes: Record<GrPopoverSize, string>;
+/**
+ * `transform-origin` для scale-анимации: координаты панели уже посчитал
+ * `useFloating`, здесь остаётся направление «роста» относительно триггера.
+ *
+ * Ключ — `resolvedPlacement`, то есть положение **после** `flip`: если снизу не
+ * хватило места и панель перевернуло вверх, origin переворачивается вместе с ней.
+ */
+export declare const originClassByPlacement: Partial<Record<Placement, string>>;
+export declare function grPopoverOriginClass(placement: Placement): string;
+/**
+ * Поверхность панели. `max-w-[min(...)]` не даёт поповеру вылезти за узкий
+ * экран: `useFloating` смещает панель в пределах viewport, но не сужает её.
+ */
+export declare const popoverPanelBaseClass = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-popover)] text-[var(--gr-popover-fg)] shadow-[var(--gr-shadow-2)] max-w-[min(22rem,calc(100vw-1rem))] focus:outline-none";
+export declare function grPopoverPanelClass(size: GrPopoverSize, placement: Placement, extra?: string): string;

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

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrPopoverComponent from './GrPopover.vue';
+export { default } from './GrPopover.vue';
+export { default as GrPopover } from './GrPopover.vue';
+export type { GrPopoverProps } from './GrPopover.vue';
+export { grPopoverConfig } from './config';
+export type { GrPopoverConfigurableProps } from './defaults';
+export type { GrPopoverRole, GrPopoverSize } from './grPopoverStyles';
+export { grPopoverSafelist } from './safelist';
+export type { GrPopoverEmits } from './GrPopover.vue';
+export type GrPopoverInstance = ComponentExposed<typeof GrPopoverComponent>;

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

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

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

@@ -1,25 +1,57 @@
-import { type GrProgressBarTone } from './grStyle';
+import { type GrProgressBarSize, type GrProgressBarTone } from './grStyle';
 /**
- * GrProgressBar — линейный индикатор прогресса.
+ * Пропы {@link GrProgressBar}.
  *
- * @prop value — текущее значение `0..100`; выходящие за границы значения клампятся, `NaN` → `0`.
- * @prop ariaLabel — метка для скринридера (обязательна, если рядом нет видимого заголовка).
- * @prop tone — цветовая тональность заливки (CSS-переменная из `tokens.css`).
+ * Линейный индикатор прогресса: определённый режим по `value` и неопределённый
+ * по `indeterminate`, необязательный слой буфера и подпись значения.
  */
 export interface GrProgressBarProps {
+    /** Текущее значение `0..100`; выходящие за границы клампятся, `NaN` → `0`. */
     value: number;
+    /** Загружено с запасом: слой позади заливки, `0..100`. Не задан — слоя нет. */
+    buffer?: number;
+    /** Прогресс неизвестен: полоса бежит, значение наружу не объявляется. */
+    indeterminate?: boolean;
+    /** Показать значение подписью справа от трека. */
+    showValue?: boolean;
+    /** Свой формат значения. Управляет и подписью, и `aria-valuetext`. */
+    formatValue?: (value: number) => string;
+    /** Метка для скринридера (обязательна, если рядом нет видимого заголовка). */
     ariaLabel?: string;
+    /** Цветовая тональность заливки. */
     tone?: GrProgressBarTone;
+    /** Толщина трека. */
+    size?: GrProgressBarSize;
+    /** Убрать рамку трека: внутри карточки вторая рамка только шумит. */
+    borderless?: boolean;
 }
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrProgressBarProps>, {
+    buffer: undefined;
+    indeterminate: boolean;
+    showValue: boolean;
+    formatValue: undefined;
     ariaLabel: undefined;
     tone: string;
+    size: undefined;
+    borderless: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrProgressBarProps>, {
+    buffer: undefined;
+    indeterminate: boolean;
+    showValue: boolean;
+    formatValue: undefined;
     ariaLabel: undefined;
     tone: string;
+    size: undefined;
+    borderless: undefined;
 }>>> & Readonly<{}>, {
     tone: GrProgressBarTone;
+    size: GrProgressBarSize;
+    borderless: boolean;
     ariaLabel: string;
+    indeterminate: boolean;
+    buffer: number;
+    showValue: boolean;
+    formatValue: (value: number) => string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/GrProgressBar/config.d.ts

@@ -1 +1 @@
-export declare const grProgressBarConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrProgressBar">;
+export declare const grProgressBarConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrProgressBar">;

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

@@ -0,0 +1,11 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrProgressBar`, настраиваемые глобально через `componentDefaults`. */
+export interface GrProgressBarConfigurableProps {
+    size: GrComponentSize;
+    borderless: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrProgressBar: GrProgressBarConfigurableProps;
+    }
+}

package/dist/types/src/components/GrProgressBar/grStyle.d.ts

@@ -1,3 +1,17 @@
+import type { GrComponentSize } from '../shared/sizes';
 import type { GrTone } from '../shared/tones';
 export type GrProgressBarTone = GrTone;
+export type GrProgressBarSize = GrComponentSize;
+/**
+ * Размер линейного индикатора — это толщина трека: ширину задаёт контейнер.
+ */
+export declare const trackSizes: Record<GrProgressBarSize, string>;
+/** Зазор между треком и подписью значения. */
+export declare const rowGaps: Record<GrProgressBarSize, string>;
+export declare const valueTextSizes: Record<GrProgressBarSize, string>;
+/**
+ * Буфер не наследует тон: `-light`-роли есть не у всех восьми тонов, а
+ * нейтральный слой между треком и заливкой читается и без цвета тона.
+ */
+export declare const bufferClass = "bg-[var(--gr-progress-buffer-bg,var(--gr-brd))]";
 export declare function grProgressBarFillClass(tone: GrProgressBarTone): string;

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

@@ -2,4 +2,5 @@ export { default } from './GrProgressBar.vue';
 export { default as GrProgressBar, type GrProgressBarProps } from './GrProgressBar.vue';
 export { grProgressBarConfig } from './config';
 export { grProgressBarSafelist } from './safelist';
-export type { GrProgressBarTone } from './grStyle';
+export type { GrProgressBarConfigurableProps } from './defaults';
+export type { GrProgressBarSize, GrProgressBarTone } from './grStyle';

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

@@ -1,4 +1,8 @@
 export declare const grProgressBarClassTokens: {
     readonly fill: string[];
+    readonly track: string[];
+    readonly gap: string[];
+    readonly value: string[];
+    readonly buffer: string[];
 };
 export declare const grProgressBarSafelist: readonly string[];

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

@@ -0,0 +1,103 @@
+import { type GrProgressCircleShape } from './geometry';
+import { type GrProgressCircleSize, type GrProgressCircleTone } from './grProgressCircleStyles';
+export type { GrProgressCircleShape } from './geometry';
+export type { GrProgressCircleSize, GrProgressCircleTone } from './grProgressCircleStyles';
+/**
+ * Пропы {@link GrProgressCircle}.
+ *
+ * Круговой индикатор: определённый режим по `value`, неопределённый по
+ * `indeterminate`, замкнутое кольцо или дуга-«дашборд».
+ */
+export interface GrProgressCircleProps {
+    /** Текущее значение `0..100`; выходящие за границы клампятся, `NaN` → `0`. */
+    value?: number;
+    /** Прогресс неизвестен: дуга бежит по кругу, значение наружу не объявляется. */
+    indeterminate?: boolean;
+    /** Замкнутое кольцо или дуга с вырезом снизу. */
+    shape?: GrProgressCircleShape;
+    /** Показать значение в центре кольца. Слот по умолчанию сильнее. */
+    showValue?: boolean;
+    /** Свой формат значения. Управляет и подписью, и `aria-valuetext`. */
+    formatValue?: (value: number) => string;
+    /** На завершении — галочка, при `tone="danger"` — крест вместо значения. */
+    statusIcon?: boolean;
+    /** Метка для скринридера (обязательна, если рядом нет видимого заголовка). */
+    ariaLabel?: string;
+    /** Цветовая тональность дуги. */
+    tone?: GrProgressCircleTone;
+    /** Диаметр кольца по шкале пакета. */
+    size?: GrProgressCircleSize;
+    /** Толщина обводки в процентах диаметра. Не задана — по ступени `size`. */
+    thickness?: number;
+    /** Убрать дорожку: поверх картинки пустая часть кольца только шумит. */
+    trackless?: boolean;
+}
+type __VLS_Slots = {
+    /** Содержимое центра вместо значения: иконка, две строки, кнопка отмены. */
+    default?: (props: {
+        value: number;
+    }) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrProgressCircleProps>, {
+    value: number;
+    indeterminate: boolean;
+    showValue: boolean;
+    formatValue: undefined;
+    statusIcon: boolean;
+    ariaLabel: undefined;
+    thickness: undefined;
+    shape: undefined;
+    tone: undefined;
+    size: undefined;
+    trackless: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrProgressCircleProps>, {
+    value: number;
+    indeterminate: boolean;
+    showValue: boolean;
+    formatValue: undefined;
+    statusIcon: boolean;
+    ariaLabel: undefined;
+    thickness: undefined;
+    shape: undefined;
+    tone: undefined;
+    size: undefined;
+    trackless: undefined;
+}>>> & Readonly<{}>, {
+    tone: GrProgressCircleTone;
+    size: GrProgressCircleSize;
+    shape: GrProgressCircleShape;
+    trackless: boolean;
+    value: number;
+    ariaLabel: string;
+    indeterminate: boolean;
+    thickness: number;
+    showValue: boolean;
+    formatValue: (value: number) => string;
+    statusIcon: boolean;
+}, {}, {}, {}, 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/src/components/GrProgressCircle/config.d.ts

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

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

@@ -0,0 +1,18 @@
+import type { GrProgressCircleShape } from './geometry';
+import type { GrProgressCircleSize, GrProgressCircleTone } from './grProgressCircleStyles';
+/**
+ * Пропы `GrProgressCircle`, настраиваемые глобально через `componentDefaults`.
+ *
+ * Только оформление: значение и режим принадлежат конкретному экземпляру.
+ */
+export interface GrProgressCircleConfigurableProps {
+    size: GrProgressCircleSize;
+    tone: GrProgressCircleTone;
+    shape: GrProgressCircleShape;
+    trackless: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrProgressCircle: GrProgressCircleConfigurableProps;
+    }
+}

package/dist/types/src/components/GrProgressCircle/geometry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Геометрия дуги прогресса. Без Vue — проверяется без монтирования.
+ *
+ * Все размеры в единицах `viewBox` 100×100: разметка не зависит от того, каким
+ * `size` кольцо выводится, а масштабирование остаётся делом CSS.
+ */
+export declare const GR_PROGRESS_CIRCLE_SHAPES: readonly ["circle", "dashboard"];
+export type GrProgressCircleShape = typeof GR_PROGRESS_CIRCLE_SHAPES[number];
+/** Сторона `viewBox`; центр — в её половине. */
+export declare const VIEW_BOX = 100;
+export interface GrArcGeometry {
+    /** Радиус с поправкой на толщину: обводка рисуется по обе стороны линии. */
+    radius: number;
+    circumference: number;
+    /** Длина дорожки — вся окружность либо её часть у «дашборда». */
+    arcLength: number;
+    /** `stroke-dasharray` дорожки. */
+    trackDashArray: string;
+    /** `stroke-dasharray` дуги значения. */
+    valueDashArray: string;
+    rotation: number;
+}
+export declare function clampProgress(value: number): number;
+/**
+ * Дуга задаётся одним штрихом нужной длины и заведомо большим пробелом за ним,
+ * а не парой `dasharray` + `dashoffset`: смещение пришлось бы пересчитывать под
+ * каждую форму, и ошибка в нём видна только глазом на конкретной ступени.
+ */
+export declare function arcGeometry(shape: GrProgressCircleShape, thickness: number, value: number): GrArcGeometry;