@snabcentr/client-core 3.21.0 → 3.21.2

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

package/package.json

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

package/release_notes.tmp

@@ -1,6 +1,4 @@
-## 3.21.0 (2026-09-16)
+## 3.21.2 (2026-10-05)
 
-### changed (1 change)
-
-- [#13636: Доработаны механизмы кэширования ответов при SSR](web_soft/libs/angular/snabcentr-client-core-lib@0ccbbc51fd20fe700e5ab833a1135c4a8eb254a4) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!345))
+No changes.
 

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;
 }