@snabcentr/vue-ui-lib 4.24.1 → 4.25.3

package/dist/src/components/buttons/button-with-confirm-action.vue.d.ts

@@ -90,10 +90,10 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<ID
 }> & Readonly<{
     onAccept?: ((closeModalCallback: () => void) => any) | undefined;
 }>, {
+    circle: boolean;
     size: Size;
     disabled: boolean;
     type: Type;
-    circle: boolean;
     dialogTitle: string;
     dialogContent: string;
     disableConfirm: boolean;

package/dist/src/components/buttons/chip-group.vue.d.ts

@@ -0,0 +1,28 @@
+import { IChipGroupItem } from './interfaces/i-chip-group-item';
+/**
+ * Горизонтальная группа круглых кнопок с прокруткой на узком экране.
+ */
+declare const _default: <TKey extends string>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly "onUpdate:modelValue"?: ((value: TKey) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onUpdate:modelValue"> & {
+        /**
+         * Пункты группы.
+         */
+        items: readonly IChipGroupItem<TKey>[];
+        /**
+         * Ключ выбранного пункта.
+         */
+        modelValue: TKey;
+    } & Partial<{}>> & import('vue').PublicProps;
+    expose(exposed: import('vue').ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: (e: "update:modelValue", value: TKey) => void;
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/src/components/buttons/index.d.ts

@@ -1 +1,3 @@
+export * from './interfaces';
 export { default as ScButtonWithConfirmAction } from './button-with-confirm-action.vue';
+export { default as ScChipGroup } from './chip-group.vue';

package/dist/src/components/buttons/interfaces/i-chip-group-item.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Пункт горизонтальной группы круглых кнопок.
+ */
+export interface IChipGroupItem<TKey extends string = string> {
+    /**
+     * Ключ пункта.
+     */
+    readonly key: TKey;
+    /**
+     * Подпись кнопки.
+     */
+    readonly label: string;
+}

package/dist/src/components/buttons/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './i-chip-group-item';

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

@@ -62,9 +62,9 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<IC
         }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             "header:click": (name: string | number, expanded: boolean) => any;
         }, string, {
+            title: string;
             name: string | number;
             disabled: boolean;
-            title: string;
         }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
             beforeCreate?: (() => void) | (() => void)[];
             created?: (() => void) | (() => void)[];
@@ -86,35 +86,35 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<IC
         $nextTick: typeof import('vue').nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
+        title: string;
         name: string | number;
         disabled: boolean;
-        title: string;
     }> & Omit<Readonly<{
         name: string | number;
         title?: string;
         disabled?: boolean;
     }> & Readonly<{
         "onHeader:click"?: ((name: string | number, expanded: boolean) => any) | undefined;
-    }>, "toggle" | "expand" | "collapse" | "expanded" | ("name" | "disabled" | "title")> & import('vue').ShallowUnwrapRef<{
+    }>, "toggle" | "expand" | "collapse" | "expanded" | ("title" | "name" | "disabled")> & import('vue').ShallowUnwrapRef<{
         expand: () => void;
         toggle: () => void;
         collapse: () => void;
         expanded: Readonly<import('vue').Ref<boolean, boolean>>;
     }> & {} & import('vue').ComponentCustomProperties & {} & {
         $slots: Readonly<{
-            arrow: () => void;
-            'pre-arrow': () => void;
-            header: () => void;
-            'sub-header': () => void;
-            'header-extra': () => void;
-            default: () => void;
+            arrow: () => import('vue').VNode[];
+            'pre-arrow': () => import('vue').VNode[];
+            header: () => import('vue').VNode[];
+            'sub-header': () => import('vue').VNode[];
+            'header-extra': () => import('vue').VNode[];
+            default: () => import('vue').VNode[];
         }> & {
-            arrow: () => void;
-            'pre-arrow': () => void;
-            header: () => void;
-            'sub-header': () => void;
-            'header-extra': () => void;
-            default: () => void;
+            arrow: () => import('vue').VNode[];
+            'pre-arrow': () => import('vue').VNode[];
+            header: () => import('vue').VNode[];
+            'sub-header': () => import('vue').VNode[];
+            'header-extra': () => import('vue').VNode[];
+            default: () => import('vue').VNode[];
         };
     }) | null;
 }, HTMLDivElement>, Readonly<{

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

@@ -1,3 +1,4 @@
+import { VNode } from 'vue';
 /**
  * Компонент элемента списка сворачиваемых элементов.
  */
@@ -49,59 +50,59 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
 }> & Readonly<{
     "onHeader:click"?: ((name: string | number, expanded: boolean) => any) | undefined;
 }>, {
+    title: string;
     name: string | number;
     disabled: boolean;
-    title: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, Readonly<{
     /**
      * Значок скрытия и отображения содержимого.
      */
-    arrow: () => void;
+    arrow: () => VNode[];
     /**
      * Зона значков слева от заголовка.
      */
-    'pre-arrow': () => void;
+    'pre-arrow': () => VNode[];
     /**
      * Основной заголовок элемента.
      */
-    header: () => void;
+    header: () => VNode[];
     /**
      * Вспомогательный заголовок под основным.
      */
-    'sub-header': () => void;
+    'sub-header': () => VNode[];
     /**
      * Дополнительное содержимое заголовка справа.
      */
-    'header-extra': () => void;
+    'header-extra': () => VNode[];
     /**
      * Содержимое элемента, отображаемое в развёрнутом состоянии.
      */
-    default: () => void;
+    default: () => VNode[];
 }> & {
     /**
      * Значок скрытия и отображения содержимого.
      */
-    arrow: () => void;
+    arrow: () => VNode[];
     /**
      * Зона значков слева от заголовка.
      */
-    'pre-arrow': () => void;
+    'pre-arrow': () => VNode[];
     /**
      * Основной заголовок элемента.
      */
-    header: () => void;
+    header: () => VNode[];
     /**
      * Вспомогательный заголовок под основным.
      */
-    'sub-header': () => void;
+    'sub-header': () => VNode[];
     /**
      * Дополнительное содержимое заголовка справа.
      */
-    'header-extra': () => void;
+    'header-extra': () => VNode[];
     /**
      * Содержимое элемента, отображаемое в развёрнутом состоянии.
      */
-    default: () => void;
+    default: () => VNode[];
 }>;
 export default _default;
 type __VLS_WithTemplateSlots<T, S> = T & {

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

@@ -13,6 +13,7 @@ export * from './icons';
 export * from './images';
 export * from './inline';
 export * from './inputs';
+export * from './kpi';
 export * from './links';
 export * from './lists';
 export * from './orders';

package/dist/src/components/kpi/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces';
+export { default as ScKpiGrid } from './kpi-grid.vue';

package/dist/src/components/kpi/interfaces/i-kpi-grid-item.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Плашка сетки KPI.
+ */
+export interface IKpiGridItem {
+    /**
+     * Подпись.
+     */
+    readonly label: string;
+    /**
+     * Значение.
+     */
+    readonly value: string;
+    /**
+     * CSS-класс значения.
+     */
+    readonly valueClass: string;
+    /**
+     * Подстрочная подпись.
+     */
+    readonly note: string;
+    /**
+     * CSS-класс подстрочной подписи.
+     */
+    readonly noteClass: string;
+}

package/dist/src/components/kpi/interfaces/index.d.ts

@@ -0,0 +1 @@
+export * from './i-kpi-grid-item';

package/dist/src/components/kpi/kpi-grid.vue.d.ts

@@ -0,0 +1,24 @@
+import { IKpiGridItem } from './interfaces/i-kpi-grid-item';
+/**
+ * Сетка KPI-плашек: подпись, значение и примечание.
+ */
+declare const _default: import('vue').DefineComponent<{
+    /**
+     * Элементы KPI-плашек.
+     */
+    items: readonly IKpiGridItem[];
+    /**
+     * Признак загрузки сводки.
+     */
+    isLoading?: boolean;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Элементы KPI-плашек.
+     */
+    items: readonly IKpiGridItem[];
+    /**
+     * Признак загрузки сводки.
+     */
+    isLoading?: boolean;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/src/components/lists/compact-card-list.vue.d.ts

@@ -0,0 +1,53 @@
+import { IPagination } from '@snabcentr/common-lib';
+/**
+ * Список карточек для узкого экрана: загрузка, пустое состояние и пагинация.
+ */
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
+    /**
+     * Признак загрузки данных.
+     */
+    isLoading: boolean;
+    /**
+     * Признак пустого списка.
+     */
+    isEmpty: boolean;
+    /**
+     * Текст пустого состояния.
+     */
+    emptyDescription: string;
+    /**
+     * Параметры пагинации. Без них список не показывает переключатель страниц.
+     */
+    pagination?: IPagination;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:page": (page: number) => any;
+    "update:pageSize": (pageSize: number) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /**
+     * Признак загрузки данных.
+     */
+    isLoading: boolean;
+    /**
+     * Признак пустого списка.
+     */
+    isEmpty: boolean;
+    /**
+     * Текст пустого состояния.
+     */
+    emptyDescription: string;
+    /**
+     * Параметры пагинации. Без них список не показывает переключатель страниц.
+     */
+    pagination?: IPagination;
+}> & Readonly<{
+    "onUpdate:page"?: ((page: number) => any) | undefined;
+    "onUpdate:pageSize"?: ((pageSize: number) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>, {
+    default?(_: {}): any;
+}>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/src/components/lists/index.d.ts

@@ -1 +1,2 @@
+export { default as ScCompactCardList } from './compact-card-list.vue';
 export { default as ScProductsList } from './products-list.vue';

package/dist/src/components/orders/orders-list.vue.d.ts

@@ -152,11 +152,11 @@ declare const _default: import('vue').DefineComponent<{
 }>, {
     sort: ISortRequestParams[];
     filters: IFilterGroup;
+    pagination: IPagination;
     showAttachedUserColumn: boolean;
     highlightSettings: IOrderHighlightSettings;
     selectable: boolean;
     tableMinWidth: number;
-    pagination: IPagination;
     useCellIndication: boolean;
     enableSorting: boolean;
     refreshInterval: number;

package/dist/src/components/orders/simple/order-item-name.vue.d.ts

@@ -1,4 +1,4 @@
-import { OrderItem } from '@snabcentr/common-lib';
+import { OrderItemBase } from '@snabcentr/common-lib';
 /**
  * Компонент отображения наименования позиции заказа в таблице.
  */
@@ -6,11 +6,30 @@ declare const _default: import('vue').DefineComponent<{
     /**
      * Данные о позиции заказа.
      */
-    item: OrderItem<undefined, string | number>;
+    item: OrderItemBase<undefined, string | number>;
+    /**
+     * Признак отображения артикула товара.
+     */
+    showCode?: boolean;
+    /**
+     * Признак неактивной позиции. Если не задан, позиция считается неактивной, когда она удалена или заменена другой.
+     */
+    inactive?: boolean;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
     /**
      * Данные о позиции заказа.
      */
-    item: OrderItem<undefined, string | number>;
-}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+    item: OrderItemBase<undefined, string | number>;
+    /**
+     * Признак отображения артикула товара.
+     */
+    showCode?: boolean;
+    /**
+     * Признак неактивной позиции. Если не задан, позиция считается неактивной, когда она удалена или заменена другой.
+     */
+    inactive?: boolean;
+}> & Readonly<{}>, {
+    showCode: boolean;
+    inactive: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 export default _default;

package/dist/src/components/orders/simple/order-product-info.vue.d.ts

@@ -26,6 +26,10 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
      * по завершении ввода, и на каждый введённый символ запрос не уходит.
      */
     updateQuantityOnInput?: boolean;
+    /**
+     * Признак неактивной позиции (удалённой или заменённой): такая позиция приглушается и зачёркивается.
+     */
+    inactive?: boolean;
 }, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
     /**
      * Данные о продукте в заказе.
@@ -48,8 +52,13 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
      * по завершении ввода, и на каждый введённый символ запрос не уходит.
      */
     updateQuantityOnInput?: boolean;
+    /**
+     * Признак неактивной позиции (удалённой или заменённой): такая позиция приглушается и зачёркивается.
+     */
+    inactive?: boolean;
 }> & Readonly<{}>, {
     eventEmitter: Emitter<IOrderEmits>;
+    inactive: boolean;
     allowEdit: boolean;
     updateQuantityOnInput: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>, {

package/dist/src/composables/index.d.ts

@@ -1 +1,2 @@
+export * from './use-compact-layout';
 export * from './use-hover-support';

package/dist/src/composables/use-compact-layout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Признак узкого экрана: телефон или планшет.
+ *
+ * На компьютере списки остаются таблицами.
+ */
+export declare function useCompactLayout(): {
+    isCompactLayout: import('vue').ComputedRef<boolean>;
+};

package/dist/src/helpers/app-version-helper.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Добавляет запись о версии приложения в список `.sc-versions-list`.
+ * Если запись с тем же названием приложения уже есть, повторно не добавляет.
+ *
+ * @param appName Отображаемое название приложения.
+ * @param version Версия приложения.
+ * @param releaseDate Дата релиза.
+ */
+export declare function showAppVersion(appName: string, version: string, releaseDate: Date): void;

package/dist/src/helpers/index.d.ts

@@ -1,7 +1,10 @@
+export * from './app-version-helper';
 export * from './content-helper';
 export * from './file-helper';
 export * from './entity-name-helper';
 export * from './input-helper';
+export * from './number-helper';
+export * from './pagination-items-prefix';
 export * from './select-option-helper';
 export * from './validators';
 export * from './product-info-helper';

package/dist/src/helpers/number-helper.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Класс-помощник для работы с дробными числами: округление с учётом погрешности дробной арифметики и форматирование сумм.
+ */
+export declare class NumberHelper {
+    /**
+     * Количество знаков после запятой в денежных суммах.
+     */
+    static readonly moneyFractionDigits = 2;
+    /**
+     * Количество знаков после запятой в процентах изменения цены.
+     */
+    static readonly percentFractionDigits = 5;
+    /**
+     * Наибольшее количество знаков после запятой в проценте на экране.
+     */
+    static readonly percentDisplayFractionDigits = 2;
+    /**
+     * Наибольшее количество знаков после запятой в площади, м².
+     */
+    static readonly areaFractionDigits = 4;
+    /**
+     * Количество знаков после запятой в географических координатах.
+     */
+    static readonly coordinateFractionDigits = 6;
+    /**
+     * Количество значащих цифр, до которого обрезается погрешность дробной арифметики.
+     */
+    static readonly significantDigits = 12;
+    /**
+     * Допустимая погрешность сравнения дробных чисел.
+     */
+    static readonly epsilon = 0.000001;
+    /**
+     * Форматтер денежных сумм.
+     */
+    private static readonly moneyFormatter;
+    /**
+     * Форматтер площади.
+     */
+    private static readonly areaFormatter;
+    /**
+     * Возвращает количество знаков после запятой в указанном числе.
+     *
+     * @param value Число, для которого нужно определить количество знаков после запятой.
+     */
+    static getDecimalsCount(value: number): number;
+    /**
+     * Возвращает число без погрешности дробной арифметики: 2.9999999999999996 превращается в 3, 0.30000000000000004 в 0.3.
+     *
+     * @param value Число с возможной погрешностью.
+     */
+    static normalize(value: number): number;
+    /**
+     * Возвращает произведение значения на шаг, округлённое до точности шага. Убирает погрешность дробной арифметики.
+     *
+     * @param value Множитель, обычно количество.
+     * @param step Шаг с нужной точностью, например длина одного отрезка.
+     */
+    static multiplyByStep(value: number, step: number): number;
+    /**
+     * Возвращает частное от деления значения на шаг без погрешности дробной арифметики.
+     *
+     * @param value Делимое, обычно длина.
+     * @param step Шаг.
+     */
+    static divideByStep(value: number, step: number): number;
+    /**
+     * Возвращает признак того, что значение кратно шагу с учётом погрешности дробной арифметики.
+     *
+     * @param value Значение.
+     * @param step Шаг.
+     */
+    static isMultipleOf(value: number, step: number): boolean;
+    /**
+     * Возвращает признак того, что первое число меньше второго или равно ему с учётом погрешности дробной арифметики.
+     *
+     * @param value Первое число.
+     * @param other Второе число.
+     */
+    static isLessOrEqual(value: number, other: number): boolean;
+    /**
+     * Возвращает географическую координату, округлённую до точности хранения.
+     *
+     * @param value Координата.
+     */
+    static roundCoordinate(value: number): number;
+    /**
+     * Возвращает денежную сумму, округлённую до копеек.
+     *
+     * @param value Денежная сумма.
+     */
+    static roundMoney(value: number): number;
+    /**
+     * Возвращает денежную сумму, округлённую до копеек в меньшую сторону.
+     *
+     * @param value Денежная сумма.
+     */
+    static floorMoney(value: number): number;
+    /**
+     * Возвращает процент, округлённый до указанного количества знаков после запятой.
+     *
+     * @param value Процент.
+     * @param fractionDigits Количество знаков после запятой, по умолчанию {@link NumberHelper.percentFractionDigits}.
+     */
+    static roundPercent(value: number, fractionDigits?: number): number;
+    /**
+     * Возвращает денежную сумму в виде строки с разделителями разрядов и не менее чем двумя знаками после запятой.
+     *
+     * @param value Денежная сумма.
+     * @param precision Точность валюты суммы, если она больше двух знаков после запятой.
+     */
+    static formatMoney(value: number, precision?: number): string;
+    /**
+     * Возвращает процент в виде строки с запятой и не более чем указанным количеством знаков после запятой, без незначащих нулей.
+     *
+     * @param value Процент.
+     * @param fractionDigits Наибольшее количество знаков после запятой, по умолчанию {@link NumberHelper.percentDisplayFractionDigits}.
+     */
+    static formatPercent(value: number, fractionDigits?: number): string;
+    /**
+     * Возвращает площадь в виде строки с разделителями разрядов и не более чем четырьмя знаками после запятой.
+     *
+     * @param value Площадь, м².
+     */
+    static formatArea(value: number): string;
+}

package/dist/src/helpers/pagination-items-prefix.d.ts

@@ -0,0 +1,7 @@
+import { PaginationInfo } from 'naive-ui';
+/**
+ * Подпись с общим числом записей для префикса пагинации Naive UI.
+ *
+ * @param info Состояние пагинации Naive UI.
+ */
+export declare function paginationItemsPrefix(info: PaginationInfo): string;

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "4.24.1",
+    "version": "4.25.3",
     "license": "ISC",
     "scripts": {
         "dev": "vite",
@@ -51,7 +51,7 @@
         "@iconify-json/logos": "^1.2.9",
         "@iconify-json/mdi": "^1.2.3",
         "@iconify-json/tabler": "^1.2.23",
-        "@snabcentr/common-lib": "^2.20.2",
+        "@snabcentr/common-lib": "^2.24.1",
         "@tailwindcss/container-queries": "^0.1.1",
         "date-fns": "^3.6.0",
         "libphonenumber-js": "^1.12.23",