@feugene/granularity 0.20.0 → 0.21.0

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

@@ -9,9 +9,17 @@ export type { GrFormFileRule, GrFormRule, GrFormRules, GrFormTrigger, GrFormVali
  * template ref (`validate` / `validateField` / `clearValidate` / `resetFields` /
  * `scrollToField`).
  */
-export interface GrFormProps {
-    /** Реактивный объект данных формы. Поля адресуются по `name` (`GrFormField`), в т.ч. dot-path. */
-    model: Record<string, unknown>;
+export interface GrFormProps<TModel extends object = Record<string, unknown>> {
+    /**
+     * Реактивный объект данных формы. Поля адресуются по `name` (`GrFormField`),
+     * в т.ч. dot-path.
+     *
+     * Тип дженерик, а не `Record<string, unknown>`: моделью бывает объект чужой
+     * библиотеки (`useForm` Inertia, стор), у которого рядом с полями лежат
+     * собственные методы. Под словарь он не подходит, и потребителю пришлось бы
+     * приводить его через `as unknown as` в каждой форме.
+     */
+    model: TModel;
     /** Правила валидации по имени поля: `{ email: [{ required: true, type: 'email' }] }`. */
     rules?: GrFormRules;
     /** Валидировать поле при потере фокуса. */
@@ -27,9 +35,9 @@ export interface GrFormProps {
      */
     disabled?: boolean;
 }
-export interface GrFormEmits {
+export interface GrFormEmits<TModel extends object = Record<string, unknown>> {
     /** Форма прошла валидацию по submit. Отдаёт `model`. */
-    (e: 'submit', model: Record<string, unknown>): void;
+    (e: 'submit', model: TModel): void;
     /** Результат валидации одного поля. */
     (e: 'validate', name: string, valid: boolean, message: string | undefined): void;
     /**
@@ -38,90 +46,43 @@ export interface GrFormEmits {
      */
     (e: 'invalid', errors: Record<string, string>): void;
 }
-declare function validateField(name: string, trigger?: GrFormTrigger): Promise<boolean>;
-declare function validate(): Promise<boolean>;
-declare function clearValidate(names?: string | string[]): void;
-/**
- * Переснять «исходное» состояние. Нужен формам редактирования: модель там
- * наполняется после ответа сервера, а снимок в `setup` фиксировал пустой
- * объект — и `resetFields()` возвращал не «как было при загрузке», а пустоту.
- */
-declare function setSnapshot(model?: Record<string, unknown>): void;
-declare function resetFields(names?: string | string[]): void;
-declare function scrollToField(name: string): void;
-declare var __VLS_1: {
-    validate: typeof validate;
-    errors: Record<string, string | undefined>;
-    isDirty: boolean;
-    isValid: boolean;
-    validatingFields: Set<string> & Omit<Set<string>, keyof Set<any>>;
-    resetFields: typeof resetFields;
-    setSnapshot: typeof setSnapshot;
-};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+declare const __VLS_export: <TModel extends object = 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<GrFormProps<TModel> & {
+        onSubmit?: ((model: TModel) => any) | undefined;
+        onInvalid?: ((errors: Record<string, string>) => any) | undefined;
+        onValidate?: ((name: string, valid: boolean, message: string | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        validate: () => Promise<boolean>;
+        validateField: (name: string, trigger?: GrFormTrigger) => Promise<boolean>;
+        clearValidate: (names?: string | string[]) => void;
+        resetFields: (names?: string | string[]) => void;
+        scrollToField: (name: string) => void;
+        setSnapshot: (model?: Record<string, unknown>) => void;
+        isDirty: import("vue").ComputedRef<boolean>;
+        isValid: import("vue").ComputedRef<boolean>;
+        validatingFields: import("vue").ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
+    }>) => void;
+    attrs: any;
+    slots: {
+        default?: (props: {
+            validate: () => Promise<boolean>;
+            errors: Record<string, string | undefined>;
+            isDirty: boolean;
+            isValid: boolean;
+            validatingFields: Set<string> & Omit<Set<string>, keyof Set<any>>;
+            resetFields: (names?: string | string[]) => void;
+            setSnapshot: (model?: Record<string, unknown>) => void;
+        }) => any;
+    };
+    emit: GrFormEmits<TModel>;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormProps>, {
-    rules: undefined;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: boolean;
-    scrollBehavior: string;
-    disabled: boolean;
-}>>, {
-    validate: typeof validate;
-    validateField: typeof validateField;
-    clearValidate: typeof clearValidate;
-    resetFields: typeof resetFields;
-    scrollToField: typeof scrollToField;
-    setSnapshot: typeof setSnapshot;
-    isDirty: import("vue").ComputedRef<boolean>;
-    isValid: import("vue").ComputedRef<boolean>;
-    validatingFields: import("vue").ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    submit: (model: Record<string, unknown>) => void;
-    validate: (name: string, valid: boolean, message: string | undefined) => void;
-    invalid: (errors: Record<string, string>) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormProps>, {
-    rules: undefined;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: boolean;
-    scrollBehavior: string;
-    disabled: boolean;
-}>>> & Readonly<{
-    onSubmit?: ((model: Record<string, unknown>) => any) | undefined;
-    onInvalid?: ((errors: Record<string, string>) => any) | undefined;
-    onValidate?: ((name: string, valid: boolean, message: string | undefined) => any) | undefined;
-}>, {
-    scrollBehavior: ScrollBehavior;
-    disabled: boolean;
-    rules: GrFormRules;
-    validateOnBlur: boolean;
-    validateOnChange: boolean;
-    scrollToError: 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];
 } : {

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

@@ -81,6 +81,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     labelClass: undefined;
 }>>> & Readonly<{}>, {
     size: GrFormFieldSize;
+    labelWidth: string | number;
     labelPosition: GrFormFieldLabelPosition;
     readonly: boolean;
     label: string;
@@ -88,11 +89,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     error: string | string[];
     disabled: boolean;
     required: boolean;
+    labelClass: LabelClass;
     forId: string;
     hint: string;
     showMessage: boolean;
-    labelWidth: string | number;
-    labelClass: LabelClass;
 }, {}, {}, {}, 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/GrImageViewer/GrImageViewer.vue.d.ts

@@ -218,9 +218,9 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
         index: number;
     }) => any) | undefined;
 }>, {
+    emptyText: string;
     zIndexVar: string;
     ariaLabel: string;
-    emptyText: string;
     closeLabel: string;
     showProgress: boolean;
     initialIndex: number;

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

@@ -152,12 +152,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>, {
     size: GrInputSize;
     clearable: boolean;
+    loading: boolean;
     readonly: boolean;
     type: "text" | "email" | "password" | "number" | "search" | "tel" | "url";
     name: string;
     invalid: boolean;
     id: string;
-    loading: boolean;
     textAlign: GrInputTextAlign;
     disabled: boolean;
     required: boolean;

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

@@ -164,12 +164,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>, {
     size: GrInputTagSize;
     clearable: boolean;
+    loading: boolean;
     trim: boolean;
     readonly: boolean;
     name: string;
     invalid: boolean;
     max: number;
-    loading: boolean;
     disabled: boolean;
     tagTone: GrBadgeTone;
     tagDark: boolean;

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

@@ -187,8 +187,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     inputmode: "search" | "text" | "none" | "email" | "tel" | "url" | "numeric" | "decimal";
     state: GrNumberInputState;
     locale: string;
-    decimalSeparator: string;
     precision: number;
+    decimalSeparator: string;
     useGrouping: boolean;
     controls: boolean;
     controlsDirection: GrNumberInputControlsDirection;

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

@@ -136,12 +136,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tone: GrRatingTone;
     size: GrRatingSize;
     clearable: boolean;
+    compact: boolean;
     icon: string | Component;
     readonly: boolean;
     name: string;
     invalid: boolean;
     max: number;
-    compact: boolean;
     disabled: boolean;
     required: boolean;
     ariaLabel: string;

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

@@ -23,7 +23,7 @@ export interface GrSegmentedProps {
     invalid?: boolean;
     /** Обязательное поле (`aria-required`). */
     required?: boolean;
-    /** Имя скрытых radio-inputs для интеграции с нативной формой. */
+    /** Имя скрытого поля, которым выбранное значение уходит в нативную форму. */
     name?: string;
     ariaLabel?: string;
 }

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

@@ -123,18 +123,18 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>, {
     tone: GrStatisticTone;
     size: GrStatisticSize;
+    loading: boolean;
     title: string;
     icon: string | Component;
     animate: boolean;
     href: string;
-    loading: boolean;
     prefix: string;
     suffix: string;
     as: string | Component;
     clickable: boolean;
     locale: string;
-    decimalSeparator: string;
     precision: number;
+    decimalSeparator: string;
     groupSeparator: string;
     trend: GrStatisticTrend;
     trendText: string;

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

@@ -89,12 +89,12 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>, {
     size: GrSwitchSize;
     labelPosition: GrSwitchLabelPosition;
+    loading: boolean;
     value: string;
     readonly: boolean;
     form: string;
     name: string;
     invalid: boolean;
-    loading: boolean;
     disabled: boolean;
     required: boolean;
     ariaLabel: string;

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

@@ -132,14 +132,14 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tableMinWidth: undefined;
 }>>> & Readonly<{}>, {
     size: GrTableSize;
-    caption: string;
+    emptyText: string;
     loading: boolean;
+    caption: string;
     columnCount: number;
     maxHeight: string | number;
     ariaLabel: string;
     empty: boolean;
     hoverable: boolean;
-    emptyText: string;
     ariaLabelledby: string;
     regionLabel: string;
     loadingRows: number;

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

@@ -88,8 +88,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     variant: GrTabsVariant;
     closable: boolean;
     size: GrTabsSize;
-    orientation: GrTabsOrientation;
     emptyText: string;
+    orientation: GrTabsOrientation;
     idBase: string;
     activationMode: GrTabsActivationMode;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

@@ -14,8 +14,8 @@ export interface GrTimelineItemProps {
     /** Заполненная точка — событие случилось, полая — запланировано. */
     variant?: GrTimelineMarkerVariant;
     /**
-     * Событие ещё не произошло: точка полая, а отрезок оси **после** неё —
-     * пунктирный. Перебивает `variant`.
+     * Событие ещё не произошло: точка полая, а ось пунктирна начиная с участка,
+     * **ведущего** к нему, — непройденный путь. Перебивает `variant`.
      */
     pending?: boolean;
 }
@@ -50,8 +50,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
 }>>> & Readonly<{}>, {
     tone: GrTimelineTone;
     variant: GrTimelineMarkerVariant;
-    title: string;
     time: string;
+    title: string;
     description: string;
     pending: boolean;
     datetime: string;

package/dist/types/components/shared/sizes.d.ts

@@ -26,5 +26,9 @@ export type GrOverlaySize = typeof GR_OVERLAY_SIZES[number];
  */
 export declare const GR_CONTROL_STATES: readonly ["default", "success", "warning", "danger"];
 export type GrControlState = typeof GR_CONTROL_STATES[number];
-/** Размер контрола с escape-hatch в пиксели: только `GrAvatar` и `GrIcon`. */
+/**
+ * Размер с escape-hatch в пиксели. Берут его трое: `GrAvatar` и `GrIcon`
+ * (исторический произвольный диаметр) и `GrFilePreview` (ширина плитки: лента
+ * вложений в четыре ступени не укладывается).
+ */
 export type GrSizeWithPx = GrComponentSize | number;

package/dist/types/composables/useToast.d.ts

@@ -30,6 +30,15 @@ export type ToastInput = {
     action?: ToastAction;
     /** Несколько action-кнопок в теле тоста. Рендерятся после `action`. */
     actions?: ToastAction[];
+    /**
+     * Схлопывать повтор: `push` с уже занятым ключом обновляет **живой** тост
+     * и перезапускает его автозакрытие вместо того, чтобы завести второй.
+     *
+     * Ключ действует только пока тост на экране. Это не то же самое, что помнить
+     * последнее показанное: повтор действия с тем же текстом обязан показаться
+     * снова, иначе второе «Сохранено» пропадёт молча.
+     */
+    dedupeKey?: string;
 };
 /**
  * Сообщения для `promise`. Строка — шорткат для `{ title }`; функция получает
@@ -51,6 +60,8 @@ export type Toast = {
     action?: ToastAction;
     /** Несколько action-кнопок в теле тоста. */
     actions?: ToastAction[];
+    /** Ключ схлопывания повторов, если тост создан с ним. */
+    dedupeKey?: string;
 };
 type ToastTimer = {
     handle: number | null;

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

@@ -23,12 +23,15 @@ export declare const granularityComponentConfigs: {
     GrCard: GranularComponentDescriptor<"GrCard">;
     GrCheckbox: GranularComponentDescriptor<"GrCheckbox">;
     GrCheckboxGroup: GranularComponentDescriptor<"GrCheckboxGroup">;
+    GrCodeBlock: GranularComponentDescriptor<"GrCodeBlock">;
     GrCollapse: GranularComponentDescriptor<"GrCollapse">;
     GrColorPicker: GranularComponentDescriptor<"GrColorPicker">;
     GrCommandPalette: GranularComponentDescriptor<"GrCommandPalette">;
     GrConfigProvider: GranularComponentDescriptor<"GrConfigProvider">;
     GrConfirmDialog: GranularComponentDescriptor<"GrConfirmDialog">;
     GrDataTable: GranularComponentDescriptor<"GrDataTable">;
+    GrDelta: GranularComponentDescriptor<"GrDelta">;
+    GrDescriptionList: GranularComponentDescriptor<"GrDescriptionList">;
     GrDialog: GranularComponentDescriptor<"GrDialog">;
     GrDialogService: GranularComponentDescriptor<"GrDialogService">;
     GrDivider: GranularComponentDescriptor<"GrDivider">;
@@ -36,6 +39,7 @@ export declare const granularityComponentConfigs: {
     GrDropdown: GranularComponentDescriptor<"GrDropdown">;
     GrDropdownMenu: GranularComponentDescriptor<"GrDropdownMenu">;
     GrEmptyState: GranularComponentDescriptor<"GrEmptyState">;
+    GrFilePreview: GranularComponentDescriptor<"GrFilePreview">;
     GrFileUpload: GranularComponentDescriptor<"GrFileUpload">;
     GrForm: GranularComponentDescriptor<"GrForm">;
     GrFormField: GranularComponentDescriptor<"GrFormField">;

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

@@ -341,6 +341,11 @@ export declare const en: {
                     dropped: string;
                     cancelled: string;
                 };
+                codeBlock: {
+                    copy: string;
+                    copied: string;
+                    copyFailed: string;
+                };
             };
             common: {
                 confirm: string;
@@ -674,6 +679,11 @@ export declare const en: {
                 dropped: string;
                 cancelled: string;
             };
+            codeBlock: {
+                copy: string;
+                copied: string;
+                copyFailed: string;
+            };
         }>;
     };
 };

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

@@ -336,6 +336,11 @@ export declare const es: {
                     dropped: string;
                     cancelled: string;
                 };
+                codeBlock: {
+                    copy: string;
+                    copied: string;
+                    copyFailed: string;
+                };
             };
             common: {
                 confirm: string;
@@ -671,6 +676,11 @@ export declare const es: {
                 dropped: string;
                 cancelled: string;
             };
+            codeBlock: {
+                copy: string;
+                copied: string;
+                copyFailed: string;
+            };
         }>;
     };
 };

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

@@ -338,6 +338,11 @@ export declare const ru: {
                     dropped: string;
                     cancelled: string;
                 };
+                codeBlock: {
+                    copy: string;
+                    copied: string;
+                    copyFailed: string;
+                };
             };
             common: {
                 confirm: string;
@@ -675,6 +680,11 @@ export declare const ru: {
                 dropped: string;
                 cancelled: string;
             };
+            codeBlock: {
+                copy: string;
+                copied: string;
+                copyFailed: string;
+            };
         }>;
     };
 };

package/dist/types/index.d.ts

@@ -10,12 +10,15 @@ export * from './components/GrButtonGroup';
 export * from './components/GrCard';
 export * from './components/GrCheckbox';
 export * from './components/GrCheckboxGroup';
+export * from './components/GrCodeBlock';
 export * from './components/GrCollapse';
 export * from './components/GrColorPicker';
 export * from './components/GrCommandPalette';
 export * from './components/GrConfigProvider';
 export * from './components/GrConfirmDialog';
 export * from './components/GrDataTable';
+export * from './components/GrDelta';
+export * from './components/GrDescriptionList';
 export * from './components/GrDialog';
 export * from './components/GrDialogService';
 export * from './components/GrDivider';
@@ -23,6 +26,7 @@ export * from './components/GrDrawer';
 export * from './components/GrDropdown';
 export * from './components/GrDropdownMenu';
 export * from './components/GrEmptyState';
+export * from './components/GrFilePreview';
 export * from './components/GrFileUpload';
 export * from './components/GrForm';
 export * from './components/GrFormField';