@snabcentr/client-core 3.22.0 → 3.23.3

package/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './sc-image-helper';
 export * from './sc-units-helper';
 export * from './sc-get-current-route';
+export * from './sc-number-helper';

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

@@ -0,0 +1,153 @@
+import { TuiNumberFormatSettings } from '@taiga-ui/core';
+/**
+ * Класс-помощник для работы с дробными числами.
+ *
+ * Округляет с учётом погрешности дробной арифметики, считает кратность шагу и задаёт настройки вывода чисел.
+ */
+export declare class ScNumberHelper {
+    /**
+     * Наибольшее количество знаков после запятой в проценте на экране.
+     */
+    static readonly percentDisplayFractionDigits = 2;
+    /**
+     * Наибольшее количество знаков после запятой в площади, м².
+     */
+    static readonly areaFractionDigits = 4;
+    /**
+     * Количество знаков после запятой в географических координатах.
+     */
+    static readonly coordinateFractionDigits = 6;
+    /**
+     * Количество значащих цифр, до которого обрезается погрешность дробной арифметики.
+     */
+    static readonly significantDigits = 12;
+    /**
+     * Допустимая погрешность сравнения дробных чисел.
+     */
+    static readonly epsilon = 0.000001;
+    /**
+     * Настройки вывода площади.
+     */
+    static readonly areaFormat: Partial<TuiNumberFormatSettings>;
+    /**
+     * Настройки вывода целых чисел.
+     */
+    static readonly integerFormat: Partial<TuiNumberFormatSettings>;
+    /**
+     * Настройки вывода процентов.
+     */
+    static readonly percentFormat: Partial<TuiNumberFormatSettings>;
+    /**
+     * Настройки вывода денежных сумм по точности валюты.
+     */
+    private static readonly moneyFormatsByPrecision;
+    /**
+     * Точность рубля из справочника валют.
+     */
+    private static rubPrecisionValue?;
+    /**
+     * Точность рубля из справочника валют ({@link ScICurrency.precision}) или undefined, если справочник не загружен.
+     */
+    static get rubPrecision(): number | undefined;
+    /**
+     * Возвращает количество знаков после запятой в указанном числе с учётом экспоненциальной записи.
+     *
+     * @param value Число, для которого нужно определить количество знаков после запятой.
+     */
+    static getDecimalsCount(value: number): number;
+    /**
+     * Возвращает число без погрешности дробной арифметики.
+     *
+     * @param value Число с возможной погрешностью.
+     */
+    static normalize(value: number): number;
+    /**
+     * Возвращает значение, округлённое до указанного количества знаков после запятой.
+     *
+     * @param value Округляемое значение.
+     * @param fractionDigits Количество знаков после запятой.
+     */
+    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, precision?: number | undefined): number;
+    /**
+     * Возвращает географическую координату, округлённую до точности хранения.
+     *
+     * @param value Координата.
+     */
+    static roundCoordinate(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 addStep(value: number, step: number): number;
+    /**
+     * Возвращает остаток от деления значения на шаг без погрешности дробной арифметики.
+     *
+     * @param value Значение.
+     * @param step Шаг.
+     */
+    static remainder(value: number, step: number): number;
+    /**
+     * Возвращает значение, приведённое к ближайшему кратному шагу, с точностью шага.
+     *
+     * @param value Значение.
+     * @param step Шаг.
+     */
+    static snapToStep(value: number, step: number): number;
+    /**
+     * Возвращает признак того, что значение кратно шагу с учётом погрешности дробной арифметики.
+     *
+     * @param value Значение.
+     * @param step Шаг.
+     */
+    static isMultipleOf(value: number, step: number): boolean;
+    /**
+     * Возвращает настройки вывода денежной суммы с числом знаков после запятой, равным точности валюты.
+     *
+     * @param precision Точность валюты суммы ({@link ScICurrency.precision}), по умолчанию точность рубля.
+     */
+    static getMoneyFormat(precision?: number | undefined): Partial<TuiNumberFormatSettings>;
+    /**
+     * Возвращает денежную сумму в виде строки с разделителями разрядов и числом знаков после запятой, равным точности валюты.
+     *
+     * @param value Денежная сумма.
+     * @param precision Точность валюты суммы ({@link ScICurrency.precision}), по умолчанию точность рубля.
+     */
+    static formatMoney(value: number, precision?: number | undefined): string;
+    /**
+     * Возвращает число, в котором отрицательный ноль заменён на ноль.
+     *
+     * @param value Число.
+     */
+    private static withoutNegativeZero;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snabcentr/client-core",
-  "version": "3.22.0",
+  "version": "3.23.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,6 +1,11 @@
-## 3.22.0 (2026-09-28)
+## 3.23.3 (2026-10-05)
 
-### removed (1 change)
+### fixed (1 change)
 
-- [#13702: Удалено направление продаж из оформления заказа](web_soft/libs/angular/snabcentr-client-core-lib@59cf1bd0f2111b764ac833c29c9c4b8711c8e6da) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!348))
+- [#14012: Точность денежных сумм берётся из справочника валют](web_soft/libs/angular/snabcentr-client-core-lib@1a566fa7a37fd6565469886b3e33bce4f828d33a) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!353))
+
+### added (2 changes)
+
+- [#14012: Добавлен помощник для работы с дробными числами и единый формат вывода денежных сумм](web_soft/libs/angular/snabcentr-client-core-lib@dd45c5a44c27cd38b99901916f677a95b5b8d0b1) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!352))
+- [#13830: В разметку Schema.org товаров добавлены политика возврата, бренд и...](web_soft/libs/angular/snabcentr-client-core-lib@beb1a719b94842117d947e2e191e17f486148642) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!351))
 

package/seo/classes/schema-org-factory.d.ts

@@ -82,6 +82,10 @@ export declare class SchemaOrgFactory {
      * Формирует список ContactPoint для Organization.
      */
     private createOrganizationContactPoints;
+    /**
+     * Формирует MerchantReturnPolicy по условиям возврата из данных о компании.
+     */
+    private createMerchantReturnPolicy;
     /**
      * Удаляет HTML-разметку из текста.
      *
@@ -119,6 +123,13 @@ export declare class SchemaOrgFactory {
      * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
      */
     private getCategoryCanonicalUrl;
+    /**
+     * Создаёт Offer о продаже товара.
+     *
+     * @param product Данные о продукте.
+     * @param productUrl Полный URL страницы товара.
+     */
+    private createOffer;
     /**
      * Создаёт элемент списка ItemList с кратким Product для страницы категории.
      *

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

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