@snabcentr/vue-ui-lib 5.6.1 → 5.7.4

package/dist/src/components/catalog/forms/set-client-price-form-item.vue.d.ts

@@ -1,4 +1,4 @@
-import { CalculationTypeEnum, ICatalogableItem, IPriceCoefficient, IPriceUpdateData } from '@snabcentr/common-lib';
+import { CalculationTypeEnum, ICatalogableItem, IPriceCoefficient, IPriceUpdateData, ProductData } from '@snabcentr/common-lib';
 import { IDisabled, IValidationFeedbackProperties } from '../../../properties';
 /**
  * Компонент "Установка клиентской цены".
@@ -16,6 +16,11 @@ declare const _default: import('vue').DefineComponent<import('../../../propertie
      * Текст для подписи поля.
      */
     label?: string;
+    /**
+     * Опорный товар категории м², по ценам которого рассчитывается стоимость за м².
+     * Если указан для категории, вместе с коэффициентом и процентом отображается поле стоимости за м².
+     */
+    m2ReferenceProduct?: ProductData;
     /**
      * Функция определения коэффициентов, недоступных для установки.
      * Такие коэффициенты отображаются в списке, но отключены (disabled).
@@ -41,6 +46,11 @@ declare const _default: import('vue').DefineComponent<import('../../../propertie
      * Текст для подписи поля.
      */
     label?: string;
+    /**
+     * Опорный товар категории м², по ценам которого рассчитывается стоимость за м².
+     * Если указан для категории, вместе с коэффициентом и процентом отображается поле стоимости за м².
+     */
+    m2ReferenceProduct?: ProductData;
     /**
      * Функция определения коэффициентов, недоступных для установки.
      * Такие коэффициенты отображаются в списке, но отключены (disabled).

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/helpers/currency-helper.d.ts

@@ -0,0 +1,17 @@
+import { ICurrency } from '@snabcentr/common-lib';
+/**
+ * Класс-помощник для работы с валютами.
+ */
+export declare class CurrencyHelper {
+    /**
+     * Возвращает валюту по умолчанию из справочника валют. Справочник загружается при первом обращении, до загрузки и без
+     * подключённого хранилища валюты нет.
+     */
+    static getDefaultCurrency(): ICurrency | undefined;
+    /**
+     * Возвращает точность округления сумм в указанной валюте, а без валюты - в валюте по умолчанию.
+     *
+     * @param currency Валюта суммы.
+     */
+    static getPrecision(currency?: Pick<ICurrency, 'precision'>): number | undefined;
+}

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

@@ -1,9 +1,12 @@
 export * from './app-version-helper';
 export * from './content-helper';
+export * from './currency-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';
+export * from './m2-price-helper';

package/dist/src/helpers/m2-price-helper.d.ts

@@ -0,0 +1,46 @@
+import { ICategory, IPriceCoefficient, ProductData } from '@snabcentr/common-lib';
+/**
+ * Класс-помощник для расчёта цен за м² для категорий, у которых разрешена установка цены исходя из стоимости м².
+ * Цена за м² категории рассчитывается по опорному товару: первому товару основной категории с заполненной шириной или длиной.
+ */
+export declare class M2PriceHelper {
+    /**
+     * Линейный размер товара в миллиметрах, используемый, если у товара не заполнены ширина или длина.
+     */
+    private static readonly defaultLinearSizeMm;
+    /**
+     * Признак, что для категории разрешена установка цены исходя из стоимости м².
+     *
+     * @param category Данные о категории.
+     */
+    static isM2Category(category: ICategory): boolean;
+    /**
+     * Возвращает опорный товар категории м²: первый товар основной категории с заполненной шириной или длиной.
+     * Возвращает `undefined`, если список товаров категории не загружен или такого товара нет.
+     *
+     * @param category Данные о категории.
+     */
+    static findReferenceProduct(category: ICategory): ProductData | undefined;
+    /**
+     * Возвращает площадь товара в м². Если у товара не заполнены ширина или длина, вместо них используется 1 м.
+     *
+     * @param product Данные о товаре.
+     */
+    static getSquare(product: ProductData): number;
+    /**
+     * Переводит стоимость товара в стоимость за м² по площади товара.
+     *
+     * @param cost Стоимость товара.
+     * @param product Данные о товаре.
+     */
+    static toM2Cost(cost: number, product: ProductData): number;
+    /**
+     * Рассчитывает стоимость за м² товара для коэффициента цены с процентом надбавки.
+     * Без коэффициента расчёт ведётся от розничной цены. Возвращает `undefined`, если у товара нет цены для коэффициента.
+     *
+     * @param product Данные о товаре.
+     * @param priceCoefficient Коэффициент цены.
+     * @param increasePercent Процент надбавки к цене коэффициента.
+     */
+    static calculateM2Cost(product: ProductData, priceCoefficient?: IPriceCoefficient, increasePercent?: number): number | undefined;
+}

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

@@ -0,0 +1,126 @@
+/**
+ * Класс-помощник для работы с дробными числами: округление с учётом погрешности дробной арифметики и форматирование сумм.
+ */
+export declare class NumberHelper {
+    /**
+     * Количество знаков после запятой в процентах изменения цены.
+     */
+    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 moneyFormatters;
+    /**
+     * Форматтер площади.
+     */
+    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 Денежная сумма.
+     * @param precision Точность валюты суммы, по умолчанию точность валюты по умолчанию из справочника валют.
+     */
+    static roundMoney(value: number, precision?: number | undefined): number;
+    /**
+     * Возвращает денежную сумму, округлённую до точности валюты в меньшую сторону. Пока точность неизвестна, убирает только
+     * погрешность дробной арифметики.
+     *
+     * @param value Денежная сумма.
+     * @param precision Точность валюты суммы, по умолчанию точность валюты по умолчанию из справочника валют.
+     */
+    static floorMoney(value: number, precision?: number | undefined): 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 | undefined): string;
+    /**
+     * Возвращает процент в виде строки с запятой и не более чем указанным количеством знаков после запятой, без незначащих нулей.
+     *
+     * @param value Процент.
+     * @param fractionDigits Наибольшее количество знаков после запятой, по умолчанию {@link NumberHelper.percentDisplayFractionDigits}.
+     */
+    static formatPercent(value: number, fractionDigits?: number): string;
+    /**
+     * Возвращает площадь в виде строки с разделителями разрядов и не более чем четырьмя знаками после запятой.
+     *
+     * @param value Площадь, м².
+     */
+    static formatArea(value: number): string;
+}

package/package.json

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