@snabcentr/vue-ui-lib 4.25.3 → 4.26.0

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,5 +1,6 @@
 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';

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

@@ -2,10 +2,6 @@
  * Класс-помощник для работы с дробными числами: округление с учётом погрешности дробной арифметики и форматирование сумм.
  */
 export declare class NumberHelper {
-    /**
-     * Количество знаков после запятой в денежных суммах.
-     */
-    static readonly moneyFractionDigits = 2;
     /**
      * Количество знаков после запятой в процентах изменения цены.
      */
@@ -31,9 +27,9 @@ export declare class NumberHelper {
      */
     static readonly epsilon = 0.000001;
     /**
-     * Форматтер денежных сумм.
+     * Форматтеры денежных сумм по точности валюты.
      */
-    private static readonly moneyFormatter;
+    private static readonly moneyFormatters;
     /**
      * Форматтер площади.
      */
@@ -85,17 +81,20 @@ export declare class NumberHelper {
      */
     static roundCoordinate(value: number): number;
     /**
-     * Возвращает денежную сумму, округлённую до копеек.
+     * Возвращает денежную сумму, округлённую до точности валюты. Пока точность неизвестна, убирает только погрешность дробной арифметики.
      *
      * @param value Денежная сумма.
+     * @param precision Точность валюты суммы, по умолчанию точность валюты по умолчанию из справочника валют.
      */
-    static roundMoney(value: number): number;
+    static roundMoney(value: number, precision?: number | undefined): number;
     /**
-     * Возвращает денежную сумму, округлённую до копеек в меньшую сторону.
+     * Возвращает денежную сумму, округлённую до точности валюты в меньшую сторону. Пока точность неизвестна, убирает только
+     * погрешность дробной арифметики.
      *
      * @param value Денежная сумма.
+     * @param precision Точность валюты суммы, по умолчанию точность валюты по умолчанию из справочника валют.
      */
-    static floorMoney(value: number): number;
+    static floorMoney(value: number, precision?: number | undefined): number;
     /**
      * Возвращает процент, округлённый до указанного количества знаков после запятой.
      *
@@ -104,12 +103,13 @@ export declare class NumberHelper {
      */
     static roundPercent(value: number, fractionDigits?: number): number;
     /**
-     * Возвращает денежную сумму в виде строки с разделителями разрядов и не менее чем двумя знаками после запятой.
+     * Возвращает денежную сумму в виде строки с разделителями разрядов и количеством знаков после запятой по точности валюты.
+     * Пока точность неизвестна, выводит сумму без незначащих нулей.
      *
      * @param value Денежная сумма.
-     * @param precision Точность валюты суммы, если она больше двух знаков после запятой.
+     * @param precision Точность валюты суммы, по умолчанию точность валюты по умолчанию из справочника валют.
      */
-    static formatMoney(value: number, precision?: number): string;
+    static formatMoney(value: number, precision?: number | undefined): string;
     /**
      * Возвращает процент в виде строки с запятой и не более чем указанным количеством знаков после запятой, без незначащих нулей.
      *

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "4.25.3",
+    "version": "4.26.0",
     "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.24.1",
+        "@snabcentr/common-lib": "^2.25.0",
         "@tailwindcss/container-queries": "^0.1.1",
         "date-fns": "^3.6.0",
         "libphonenumber-js": "^1.12.23",