@snabcentr/client-core 3.8.1 → 3.10.0

package/package.json

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

package/release_notes.tmp

@@ -1,6 +1,6 @@
-## 3.8.1 (2026-06-24)
+## 3.10.0 (2026-07-21)
 
-### fixed (1 change)
+### changed (1 change)
 
-- [#13182: Исправлен редирект на родительскую категорию в браузере](web_soft/libs/angular/snabcentr-client-core-lib@7f0b85f97991cf63d7d894161c6ff530efa4c7b1) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!324))
+- [#13612: Доработаны механизмы генерации Schema.org](web_soft/libs/angular/snabcentr-client-core-lib@ea02b4da7cd9e846540ec8a54d265f7e0d2fe7a0) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!330))
 

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

@@ -1,8 +1,8 @@
-import { CollectionPage, Product, WithContext } from 'schema-dts';
+import { CollectionPage, Organization, Product, Thing, WithContext } from 'schema-dts';
 import { ScICategory } from '../../catalog/interfaces/sc-i-category';
 import { ScIProduct } from '../../catalog/interfaces/sc-i-product';
 import { ScIVirtualCategory } from '../../catalog/interfaces/sc-i-virtual-category';
-import { ScIBreadcrumbItem } from '../interfaces';
+import { ScIBreadcrumbItem } from '../interfaces/sc-i-breadcrumb-item';
 import * as i0 from "@angular/core";
 /**
  * Механизмы генерации схем данных Schema.org.
@@ -29,8 +29,9 @@ export declare class SchemaOrgFactory {
      *
      * @param product Данные о продукте.
      * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
      */
-    generateForProductItem(product: ScIProduct, productPath: string): WithContext<Product>;
+    generateForProductItem(product: ScIProduct, productPath: string, id?: string): WithContext<Product>;
     /**
      * Генерирует и возвращает схему данных для указанного продукта.
      *
@@ -39,8 +40,29 @@ export declare class SchemaOrgFactory {
      * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
      * @param productPath Url путь к товару. В пути должен присутствовать шаблон ':id', обозначающий идентификатор товара для подстановки.
      * @param breadcrumbs Данные о хлебных крошках для категории.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
      */
-    generateForCategoryItem(category: ScICategory | ScIVirtualCategory, products: ScIProduct[], categoryPath: string, productPath: string, breadcrumbs: ScIBreadcrumbItem[]): WithContext<CollectionPage>;
+    generateForCategoryItem(category: ScICategory | ScIVirtualCategory, products: ScIProduct[], categoryPath: string, productPath: string, breadcrumbs: ScIBreadcrumbItem[], id?: string): WithContext<CollectionPage>;
+    /**
+     * Генерирует и возвращает схему данных OnlineStore на основе данных компании из окружения.
+     */
+    generateForOrganization(): WithContext<Organization>;
+    /**
+     * Объединяет несколько JSON-LD сущностей в один документ с `@graph`.
+     *
+     * @param data Массив JSON-LD сущностей для объединения.
+     */
+    merge(data: Array<WithContext<Thing>>): WithContext<Thing>;
+    /**
+     * Формирует PostalAddress из структурированного адреса компании.
+     *
+     * @param address Структурированный адрес компании.
+     */
+    private createPostalAddress;
+    /**
+     * Формирует список ContactPoint для Organization.
+     */
+    private createOrganizationContactPoints;
     /**
      * Нормализует дату окончания цены в формат Schema.org (YYYY-MM-DD).
      *
@@ -90,6 +112,14 @@ export declare class SchemaOrgFactory {
      * @param categoryPath Url путь к категориям товаров. В пути должен присутствовать шаблон ':id', обозначающий идентификатор категории для подстановки.
      */
     private createCatalogBreadcrumbsList;
+    /**
+     * Создаёт элемент BreadcrumbList в формате, рекомендованном Schema.org.
+     *
+     * @param position Позиция элемента в цепочке.
+     * @param name Название элемента.
+     * @param url URL элемента.
+     */
+    private createBreadcrumbListItem;
     static ɵfac: i0.ɵɵFactoryDeclaration<SchemaOrgFactory, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<SchemaOrgFactory>;
 }

package/seo/services/sc-seo.service.d.ts

@@ -49,6 +49,10 @@ export declare class ScSeoService {
      * Объект {@link Document}, предоставляющий доступ к DOM страницы.
      */
     private readonly document;
+    /**
+     * Фабрика для создания данных Schema.org.
+     */
+    private readonly schemaOrgFactory;
     /**
      * Фабрика для создания экземпляров {@link Renderer2}.
      */