@snabcentr/vue-ui-lib 4.22.0 → 4.22.2

package/dist/src/components/catalog/category-collapse-item.vue.d.ts

@@ -1,4 +1,4 @@
-import { ProductData } from '@snabcentr/common-lib';
+import { CategoryData, ProductData } from '@snabcentr/common-lib';
 import { ICategoryCollapseItemProperties } from '../../catalog/interfaces/properties/i-category-collapse-item-properties';
 /**
  * Компонент элемента сворачиваемого списка категорий.
@@ -16,13 +16,13 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<IC
     showProductEditButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<ProductData>;
     productContextButtonsConfig: (product: ProductData) => Array<import('naive-ui').DropdownOption | import('naive-ui').DropdownGroupOption | import('naive-ui').DropdownDividerOption | import('naive-ui').DropdownRenderOption>;
     isProductItemSelected: import('../..').ButtonStateFunction<ProductData>;
-    isCategoryItemSelected: import('../..').ButtonStates | import('../..').ButtonStateFunction<import('@snabcentr/common-lib').CategoryData>;
-    showCategoryHideForClientButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<import('@snabcentr/common-lib').CategoryData>;
-    showCategoryRequiredButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<import('@snabcentr/common-lib').CategoryData>;
-    showCategoryPinButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<import('@snabcentr/common-lib').CategoryData>;
-    showCategoryEditButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<import('@snabcentr/common-lib').CategoryData>;
-    categoryContextButtonsConfig: (category: import('@snabcentr/common-lib').CategoryData) => Array<import('naive-ui').DropdownOption | import('naive-ui').DropdownGroupOption | import('naive-ui').DropdownDividerOption | import('naive-ui').DropdownRenderOption>;
-    showConfigurator: boolean | ((category: import('@snabcentr/common-lib').CategoryData) => boolean);
+    isCategoryItemSelected: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
+    showCategoryHideForClientButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
+    showCategoryRequiredButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
+    showCategoryPinButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
+    showCategoryEditButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
+    categoryContextButtonsConfig: (category: CategoryData) => Array<import('naive-ui').DropdownOption | import('naive-ui').DropdownGroupOption | import('naive-ui').DropdownDividerOption | import('naive-ui').DropdownRenderOption>;
+    showConfigurator: boolean | ((category: CategoryData) => boolean);
     canShowConfigurator: boolean | (() => boolean);
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     'collapse-item-reference': ({
@@ -101,17 +101,50 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<IC
         collapse: () => void;
         expanded: Readonly<import('vue').Ref<boolean, boolean>>;
     }> & {} & import('vue').ComponentCustomProperties & {} & {
-        $slots: {
-            arrow?(_: {}): any;
-            'pre-arrow'?(_: {}): any;
-            header?(_: {}): any;
-            'sub-header'?(_: {}): any;
-            'header-extra'?(_: {}): any;
-            default?(_: {}): any;
+        $slots: Readonly<{
+            arrow: () => void;
+            'pre-arrow': () => void;
+            header: () => void;
+            'sub-header': () => void;
+            'header-extra': () => void;
+            default: () => void;
+        }> & {
+            arrow: () => void;
+            'pre-arrow': () => void;
+            header: () => void;
+            'sub-header': () => void;
+            'header-extra': () => void;
+            default: () => void;
         };
     }) | null;
-}, HTMLDivElement>, {
-    default?(_: {}): any;
+}, HTMLDivElement>, Readonly<{
+    /**
+     * Содержимое категории.
+     */
+    default: () => void;
+    /**
+     * Дополнительное содержимое заголовка элемента категории.
+     *
+     * @param props Параметры слота.
+     * @param props.categoryItem Данные категории, для которой рендерится блок.
+     */
+    'header-extra': (props: {
+        categoryItem: CategoryData;
+    }) => void;
+}> & {
+    /**
+     * Содержимое категории.
+     */
+    default: () => void;
+    /**
+     * Дополнительное содержимое заголовка элемента категории.
+     *
+     * @param props Параметры слота.
+     * @param props.categoryItem Данные категории, для которой рендерится блок.
+     */
+    'header-extra': (props: {
+        categoryItem: CategoryData;
+    }) => void;
 }>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/src/components/catalog/category-collapse.vue.d.ts

@@ -3,7 +3,7 @@ import { CategoryData, SearchResult } from '@snabcentr/common-lib';
 /**
  * Компонент списка сворачиваемых элементов каталога.
  */
-declare const _default: import('vue').DefineComponent<ICategoryCollapseProperties, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<ICategoryCollapseProperties> & Readonly<{}>, {
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<ICategoryCollapseProperties, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<ICategoryCollapseProperties> & Readonly<{}>, {
     loading: boolean;
     showSlugs: boolean;
     showProperties: boolean;
@@ -22,5 +22,30 @@ declare const _default: import('vue').DefineComponent<ICategoryCollapsePropertie
     showCategoryEditButton: import('../..').ButtonStates | import('../..').ButtonStateFunction<CategoryData>;
     categoryContextButtonsConfig: (category: CategoryData) => Array<import('naive-ui').DropdownOption | import('naive-ui').DropdownGroupOption | import('naive-ui').DropdownDividerOption | import('naive-ui').DropdownRenderOption>;
     client: import('@snabcentr/common-lib').IClient;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>, Readonly<{
+    /**
+     * Дополнительное содержимое заголовка элемента категории.
+     *
+     * @param props Параметры слота.
+     * @param props.categoryItem Данные категории, для которой рендерится блок.
+     */
+    'header-extra': (props: {
+        categoryItem: CategoryData;
+    }) => void;
+}> & {
+    /**
+     * Дополнительное содержимое заголовка элемента категории.
+     *
+     * @param props Параметры слота.
+     * @param props.categoryItem Данные категории, для которой рендерится блок.
+     */
+    'header-extra': (props: {
+        categoryItem: CategoryData;
+    }) => void;
+}>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/collapse/collapse-item.vue.d.ts

@@ -52,13 +52,56 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     name: string | number;
     disabled: boolean;
     title: string;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, {
-    arrow?(_: {}): any;
-    'pre-arrow'?(_: {}): any;
-    header?(_: {}): any;
-    'sub-header'?(_: {}): any;
-    'header-extra'?(_: {}): any;
-    default?(_: {}): any;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, Readonly<{
+    /**
+     * Значок скрытия и отображения содержимого.
+     */
+    arrow: () => void;
+    /**
+     * Зона значков слева от заголовка.
+     */
+    'pre-arrow': () => void;
+    /**
+     * Основной заголовок элемента.
+     */
+    header: () => void;
+    /**
+     * Вспомогательный заголовок под основным.
+     */
+    'sub-header': () => void;
+    /**
+     * Дополнительное содержимое заголовка справа.
+     */
+    'header-extra': () => void;
+    /**
+     * Содержимое элемента, отображаемое в развёрнутом состоянии.
+     */
+    default: () => void;
+}> & {
+    /**
+     * Значок скрытия и отображения содержимого.
+     */
+    arrow: () => void;
+    /**
+     * Зона значков слева от заголовка.
+     */
+    'pre-arrow': () => void;
+    /**
+     * Основной заголовок элемента.
+     */
+    header: () => void;
+    /**
+     * Вспомогательный заголовок под основным.
+     */
+    'sub-header': () => void;
+    /**
+     * Дополнительное содержимое заголовка справа.
+     */
+    'header-extra': () => void;
+    /**
+     * Содержимое элемента, отображаемое в развёрнутом состоянии.
+     */
+    default: () => void;
 }>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

package/dist/src/components/dates/date-range/button-presets.d.ts

@@ -0,0 +1,9 @@
+import { ButtonProps } from 'naive-ui';
+/**
+ * Пресет внешнего вида кнопок быстрого выбора периода: крупные скруглённые кнопки со светлой рамкой.
+ */
+export declare const QUICK_PERIOD_BUTTON_THEME: ButtonProps['themeOverrides'];
+/**
+ * Пресет внешнего вида кнопок листания сеток периода: квадратные кнопки со светлой рамкой.
+ */
+export declare const GRID_ARROW_BUTTON_THEME: ButtonProps['themeOverrides'];

package/dist/src/components/dates/date-range/date-range-dialog.vue.d.ts

@@ -2,7 +2,7 @@ import { IClearable } from '../../../properties/interfaces/i-clearable';
 import { IDateRangeDisabled } from '../../../properties/interfaces/i-date-range-disabled';
 import { IDatePeriod, ILabeledPeriod } from '@snabcentr/common-lib';
 /**
- * Диалог «Выберите период» с сеткой месяцев и стандартными периодами.
+ * Диалог «Выберите период» с быстрым выбором, сеткой месяцев, календарём дней и стандартными периодами.
  */
 declare const _default: import('vue').DefineComponent<IClearable & IDateRangeDisabled & {
     /**

package/dist/src/components/dates/date-range/date-range-helper.d.ts

@@ -1,12 +1,45 @@
-import { IDatePeriod } from '@snabcentr/common-lib';
+import { IDatePeriod, ILabeledPeriod, IStandardPeriod } from '@snabcentr/common-lib';
+import { SelectGroupOption, SelectOption } from 'naive-ui';
 /**
  * Ключ хранилища для последнего выбранного вида диалога выбора периода.
  */
 export declare const DATE_RANGE_DIALOG_MODE_STORAGE_KEY = "date-range.dialog.mode";
+/**
+ * Ключ хранилища для последнего выбранного масштаба сетки диалога выбора периода: по месяцам или по дням.
+ */
+export declare const DATE_RANGE_DIALOG_SCALE_STORAGE_KEY = "date-range.dialog.scale";
+/**
+ * Ключ хранилища для набора периодов быстрого выбора.
+ */
+export declare const DATE_RANGE_QUICK_PERIODS_STORAGE_KEY = "date-range.quick-periods";
+/**
+ * Набор периодов быстрого выбора по умолчанию — ключи стандартных периодов.
+ */
+export declare const DEFAULT_QUICK_PERIOD_KEYS: string[];
 /**
  * Краткие названия месяцев для сеток выбора: заданы явно и не зависят от локали календаря.
  */
 export declare const MONTH_LABELS: string[];
+/**
+ * Полные названия месяцев для заголовков календаря.
+ */
+export declare const MONTH_NAMES: string[];
+/**
+ * Краткие названия дней недели, неделя начинается с понедельника.
+ */
+export declare const WEEKDAY_LABELS: string[];
+/**
+ * Возвращает сквозной индекс календарного дня: число дней от точки отсчёта, без влияния перевода часов.
+ *
+ * @param date Дата.
+ */
+export declare const dayIndex: (date: Date) => number;
+/**
+ * Возвращает начало дня по его сквозному индексу.
+ *
+ * @param index Сквозной индекс дня.
+ */
+export declare const dateFromDayIndex: (index: number) => Date;
 /**
  * Нормализует границы периода: «от» приводится к началу дня, «до» — к концу дня, границы могут быть
  * не заданы по отдельности (полуоткрытый период). Инвертированные границы переставляются местами;
@@ -22,3 +55,17 @@ export declare const normalizePeriod: (from?: Date | null, to?: Date | null, loc
     from?: boolean;
     to?: boolean;
 }) => IDatePeriod;
+/**
+ * Преобразует периоды в опции списка: значение опции — ключ периода, сам период доступен в поле item.
+ *
+ * @param periods Периоды по ключам.
+ */
+export declare const periodsToOptions: (periods: Record<string, ILabeledPeriod>) => SelectOption[];
+/**
+ * Возвращает разделы списка стандартных периодов одной группы: группа «Прочее» разбивается
+ * на разделы с подзаголовками, остальные группы — один раздел без подзаголовка.
+ *
+ * @param periods Стандартные периоды по ключам.
+ * @param groupKey Ключ группы.
+ */
+export declare const standardPeriodSections: (periods: Record<string, IStandardPeriod>, groupKey: string) => SelectGroupOption[];

package/dist/src/components/dates/date-range/day-range-grid.vue.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Календарь дней на несколько месяцев подряд с выбором диапазона двумя кликами, протяжкой или клавиатурой.
+ */
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
+    /**
+     * Начало выбранного периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание выбранного периода.
+     */
+    to?: Date | null;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (value: {
+        from: Date;
+        to: Date;
+    }) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Начало выбранного периода.
+     */
+    from?: Date | null;
+    /**
+     * Окончание выбранного периода.
+     */
+    to?: Date | null;
+}> & Readonly<{
+    onSelect?: ((value: {
+        from: Date;
+        to: Date;
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, {
+    actions?(_: {}): any;
+}>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/dates/date-range/interfaces/i-calendar-month.d.ts

@@ -0,0 +1,18 @@
+import { IDayCell } from './i-day-cell';
+/**
+ * Месяц календарной сетки: заголовок и ячейки дней.
+ */
+export interface ICalendarMonth {
+    /**
+     * Ключ месяца для рендера списка.
+     */
+    key: string;
+    /**
+     * Заголовок месяца, например «Май 2025».
+     */
+    title: string;
+    /**
+     * Ячейки дней: шесть недель по семь дней, начиная с понедельника.
+     */
+    cells: IDayCell[];
+}

package/dist/src/components/dates/date-range/interfaces/i-day-cell.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Ячейка дня в календарной сетке месяца.
+ */
+export interface IDayCell {
+    /**
+     * Сквозной индекс дня.
+     */
+    index: number;
+    /**
+     * Число месяца.
+     */
+    day: number;
+    /**
+     * Признак принадлежности дня показываемому месяцу; дни соседних месяцев заполняют сетку и недоступны для выбора.
+     */
+    isCurrentMonth: boolean;
+    /**
+     * Признак сегодняшнего дня.
+     */
+    isToday: boolean;
+}

package/dist/src/components/dates/date-range/interfaces/i-range-selection.d.ts

@@ -0,0 +1,40 @@
+import { ComputedRef } from 'vue';
+/**
+ * Состояние и обработчики выбора диапазона ячеек сетки по их сквозным индексам.
+ */
+export interface IRangeSelection {
+    /**
+     * Активный подсвечиваемый диапазон: протяжка, затем предпросмотр после первого клика,
+     * затем диапазон из значения периода.
+     */
+    activeRange: ComputedRef<[number, number] | null>;
+    /**
+     * Возвращает положение ячейки в активном диапазоне: граница, середина либо null вне диапазона.
+     *
+     * @param index Сквозной индекс ячейки.
+     */
+    cellPosition(index: number): 'bound' | 'in-range' | null;
+    /**
+     * Обработчик зажатия указателя на ячейке.
+     *
+     * @param index Сквозной индекс ячейки.
+     */
+    pointerDownHandler(index: number): void;
+    /**
+     * Обработчик наведения указателя на ячейку: двигает предпросмотр цепочки; при зажатом указателе
+     * переводит выбор в режим протяжки.
+     *
+     * @param index Сквозной индекс ячейки.
+     */
+    pointerEnterHandler(index: number): void;
+    /**
+     * Обработчик ухода указателя с сетки: снимает предпросмотр наведения.
+     */
+    pointerLeaveHandler(): void;
+    /**
+     * Обработчик выбора ячейки с клавиатуры по логике пары кликов «первый / второй».
+     *
+     * @param index Сквозной индекс ячейки.
+     */
+    selectHandler(index: number): void;
+}

package/dist/src/components/dates/date-range/interfaces/i-standard-period-group-options.d.ts

@@ -0,0 +1,18 @@
+import { SelectGroupOption } from 'naive-ui';
+/**
+ * Группа стандартных периодов с разделами опций для списков выбора.
+ */
+export interface IStandardPeriodGroupOptions {
+    /**
+     * Ключ группы.
+     */
+    key: string;
+    /**
+     * Название группы.
+     */
+    label: string;
+    /**
+     * Разделы группы с опциями периодов.
+     */
+    sections: SelectGroupOption[];
+}

package/dist/src/components/dates/date-range/month-range-grid.vue.d.ts

@@ -1,7 +1,7 @@
 /**
  * Сетка месяцев на три года с выбором диапазона двумя кликами, протяжкой или клавиатурой.
  */
-declare const _default: import('vue').DefineComponent<{
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     /**
      * Начало выбранного периода.
      */
@@ -29,5 +29,12 @@ declare const _default: import('vue').DefineComponent<{
         from: Date;
         to: Date;
     }) => any) | undefined;
-}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, {
+    actions?(_: {}): any;
+}>;
 export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/dates/date-range/quick-periods-settings.vue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Диалог настройки набора периодов быстрого выбора.
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Признак отображения диалога.
+     */
+    show: boolean;
+    /**
+     * Ключи стандартных периодов, показываемых в быстром выборе сейчас, — начальное состояние галочек.
+     */
+    selectedKeys: string[];
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:show": (show: boolean) => any;
+    save: (keys: string[]) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Признак отображения диалога.
+     */
+    show: boolean;
+    /**
+     * Ключи стандартных периодов, показываемых в быстром выборе сейчас, — начальное состояние галочек.
+     */
+    selectedKeys: string[];
+}> & Readonly<{
+    "onUpdate:show"?: ((show: boolean) => any) | undefined;
+    onSave?: ((keys: string[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/src/components/dates/date-range/quick-periods.vue.d.ts

@@ -0,0 +1,30 @@
+import { SelectOption } from 'naive-ui';
+/**
+ * Быстрый выбор периода: строка кнопок выбранных стандартных периодов с настройкой набора.
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Начало текущего периода — для подсветки совпадающего варианта.
+     */
+    from?: Date | null;
+    /**
+     * Окончание текущего периода — для подсветки совпадающего варианта.
+     */
+    to?: Date | null;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    apply: (option: SelectOption) => any;
+    preview: (option?: SelectOption | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Начало текущего периода — для подсветки совпадающего варианта.
+     */
+    from?: Date | null;
+    /**
+     * Окончание текущего периода — для подсветки совпадающего варианта.
+     */
+    to?: Date | null;
+}> & Readonly<{
+    onApply?: ((option: SelectOption) => any) | undefined;
+    onPreview?: ((option?: SelectOption | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/dates/date-range/use-range-selection.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from 'vue';
+import { IRangeSelection } from './interfaces/i-range-selection';
+/**
+ * Выбор диапазона ячеек сетки по сквозным индексам: парой кликов «первый / второй», протяжкой
+ * или с клавиатуры. Первый клик фиксирует якорь и отдаёт черновой диапазон из одной ячейки,
+ * второй — завершает диапазон; отпускание указателя слушается на window, чтобы отпускание
+ * вне сетки не подвешивало выбор.
+ *
+ * @param selectedRange Диапазон из значения периода — подсвечивается, пока нет незавершённого выбора.
+ * @param complete Обработчик завершённого выбора; получает упорядоченные индексы границ.
+ */
+export declare const useRangeSelection: (selectedRange: Ref<[number, number] | null>, complete: (start: number, end: number) => void) => IRangeSelection;

package/dist/src/test/component-test-support.d.ts

@@ -69,6 +69,46 @@ export declare const componentMountOptions: {
                 inheritAttrs: boolean;
                 template: string;
             };
+            IconMdiMagnifyPlusOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiMagnifyMinusOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiCalendarMonthOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiChartBar: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiChartLine: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiChevronLeft: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiChevronRight: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiCogOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiCalendarTodayOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
+            IconMdiCalendarWeekOutline: {
+                inheritAttrs: boolean;
+                template: string;
+            };
         };
     };
 };

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "4.22.0",
+    "version": "4.22.2",
     "license": "ISC",
     "scripts": {
         "dev": "vite",