@snabcentr/client-core 3.21.2 → 3.21.3

package/helpers/sc-number-helper.d.ts

@@ -5,10 +5,6 @@ import { TuiNumberFormatSettings } from '@taiga-ui/core';
  * Округляет с учётом погрешности дробной арифметики, считает кратность шагу и задаёт настройки вывода чисел.
  */
 export declare class ScNumberHelper {
-    /**
-     * Количество знаков после запятой в денежных суммах.
-     */
-    static readonly moneyFractionDigits = 2;
     /**
      * Наибольшее количество знаков после запятой в проценте на экране.
      */
@@ -29,10 +25,6 @@ export declare class ScNumberHelper {
      * Допустимая погрешность сравнения дробных чисел.
      */
     static readonly epsilon = 0.000001;
-    /**
-     * Настройки вывода денежных сумм.
-     */
-    static readonly moneyFormat: Partial<TuiNumberFormatSettings>;
     /**
      * Настройки вывода площади.
      */
@@ -46,9 +38,17 @@ export declare class ScNumberHelper {
      */
     static readonly percentFormat: Partial<TuiNumberFormatSettings>;
     /**
-     * Настройки вывода денежных сумм в валютах с точностью больше двух знаков после запятой.
+     * Настройки вывода денежных сумм по точности валюты.
      */
     private static readonly moneyFormatsByPrecision;
+    /**
+     * Точность рубля из справочника валют.
+     */
+    private static rubPrecisionValue?;
+    /**
+     * Точность рубля из справочника валют ({@link ScICurrency.precision}) или undefined, если справочник не загружен.
+     */
+    static get rubPrecision(): number | undefined;
     /**
      * Возвращает количество знаков после запятой в указанном числе с учётом экспоненциальной записи.
      *
@@ -69,11 +69,20 @@ export declare class ScNumberHelper {
      */
     static round(value: number, fractionDigits: number): number;
     /**
-     * Возвращает денежную сумму, округлённую до копеек.
+     * Запоминает точность рубля из справочника валют.
+     *
+     * @param precision Точность рубля ({@link ScICurrency.precision}).
+     */
+    static setRubPrecision(precision: number | undefined): void;
+    /**
+     * Возвращает денежную сумму, округлённую до точности валюты.
+     *
+     * Без известной точности убирает только погрешность дробной арифметики.
      *
      * @param value Денежная сумма.
+     * @param precision Точность валюты суммы ({@link ScICurrency.precision}), по умолчанию точность рубля.
      */
-    static roundMoney(value: number): number;
+    static roundMoney(value: number, precision?: number | undefined): number;
     /**
      * Возвращает географическую координату, округлённую до точности хранения.
      *
@@ -123,22 +132,18 @@ export declare class ScNumberHelper {
      */
     static isMultipleOf(value: number, step: number): boolean;
     /**
-     * Возвращает настройки вывода денежной суммы с учётом точности её валюты.
+     * Возвращает настройки вывода денежной суммы с числом знаков после запятой, равным точности валюты.
      *
-     * @param precision Точность валюты суммы ({@link ScICurrency.precision}),
-     * если она больше двух знаков после запятой.
+     * @param precision Точность валюты суммы ({@link ScICurrency.precision}), по умолчанию точность рубля.
      */
-    static getMoneyFormat(precision?: number): Partial<TuiNumberFormatSettings>;
+    static getMoneyFormat(precision?: number | undefined): Partial<TuiNumberFormatSettings>;
     /**
-     * Возвращает денежную сумму в виде строки с разделителями разрядов.
-     *
-     * Знаков после запятой не меньше двух и не больше, чем задаёт точность валюты.
+     * Возвращает денежную сумму в виде строки с разделителями разрядов и числом знаков после запятой, равным точности валюты.
      *
      * @param value Денежная сумма.
-     * @param precision Точность валюты суммы ({@link ScICurrency.precision}),
-     * если она больше двух знаков после запятой.
+     * @param precision Точность валюты суммы ({@link ScICurrency.precision}), по умолчанию точность рубля.
      */
-    static formatMoney(value: number, precision?: number): string;
+    static formatMoney(value: number, precision?: number | undefined): string;
     /**
      * Возвращает число, в котором отрицательный ноль заменён на ноль.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snabcentr/client-core",
-  "version": "3.21.2",
+  "version": "3.21.3",
   "author": "Snabcentr Ltd.",
   "repository": "https://gitlab.snabcentr.met/web/angular/snabcentr-client-core-lib",
   "license": "Commercial",

package/references/index.d.ts

@@ -1,3 +1,4 @@
 export * from './dto';
 export * from './enums';
 export * from './services';
+export * from './sc-rub-precision.providers';

package/references/sc-rub-precision.providers.d.ts

@@ -0,0 +1,6 @@
+import { EnvironmentProviders } from '@angular/core';
+/**
+ * Возвращает провайдеры загрузки точности рубля из справочника валют при старте приложения.
+ * По этой точности {@link ScNumberHelper} округляет и выводит рублёвые суммы.
+ */
+export declare function provideRubPrecision(): EnvironmentProviders;

package/release_notes.tmp

@@ -1,4 +1,4 @@
-## 3.21.2 (2026-10-05)
+## 3.21.3 (2026-10-05)
 
 No changes.
 

package/user/dto/sc-user.d.ts

@@ -91,7 +91,7 @@ export declare class ScUser {
      */
     get isGuest(): boolean;
     /**
-     * Задолженность по модулю, округлённая до копеек.
+     * Задолженность по модулю, округлённая до точности рубля.
      */
     get absDebt(): number;
 }