@snabcentr/client-core 3.9.1 → 3.11.0

package/package.json

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

package/release_notes.tmp

@@ -1,4 +1,6 @@
-## 3.9.1 (2026-07-21)
+## 3.11.0 (2026-07-22)
 
-No changes.
+### added (1 change)
+
+- [#13612: Добавлены механизмы установки Schema.org для страницы новости и FAQ](web_soft/libs/angular/snabcentr-client-core-lib@d84d698c188c19bf55922fd7ab13f9cbe4d5dab3) ([merge request](web_soft/libs/angular/snabcentr-client-core-lib!331))
 

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

@@ -1,8 +1,10 @@
-import { CollectionPage, Product, WithContext } from 'schema-dts';
+import { CollectionPage, FAQPage, NewsArticle, 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 { ScFaqItem } from '../../frequently-asked-questions/interfaces/sc-i-faq-item';
+import { ScINews } from '../../news/interfaces/sc-i-news';
+import { ScIBreadcrumbItem } from '../interfaces/sc-i-breadcrumb-item';
 import * as i0 from "@angular/core";
 /**
  * Механизмы генерации схем данных Schema.org.
@@ -29,8 +31,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 +42,58 @@ 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>;
+    /**
+     * Генерирует и возвращает схему данных для указанной новости.
+     *
+     * @param news Данные о новости.
+     * @param newsPath Url путь к новости. В пути должен присутствовать шаблон ':id', обозначающий идентификатор новости для подстановки.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
+     */
+    generateForNewsArticle(news: ScINews, newsPath: string, id?: string): WithContext<NewsArticle>;
+    /**
+     * Генерирует и возвращает схему данных FAQPage для страницы с вопросами и ответами.
+     *
+     * @param items Список вопросов и ответов.
+     * @param pagePath Url путь к странице FAQ.
+     * @param pageName Необязательное название страницы.
+     * @param id Необязательный идентификатор сущности для поля `@id` в JSON-LD.
+     */
+    generateForFaqPage(items: ScFaqItem[], pagePath: string, pageName?: string, id?: string): WithContext<FAQPage>;
+    /**
+     * Объединяет несколько JSON-LD сущностей в один документ с `@graph`.
+     *
+     * @param data Массив JSON-LD сущностей для объединения.
+     */
+    merge(data: Array<WithContext<Thing>>): WithContext<Thing>;
+    /**
+     * Формирует PostalAddress из структурированного адреса компании.
+     *
+     * @param address Структурированный адрес компании.
+     */
+    private createPostalAddress;
+    /**
+     * Формирует список ContactPoint для Organization.
+     */
+    private createOrganizationContactPoints;
+    /**
+     * Удаляет HTML-разметку из текста.
+     *
+     * @param html Текст с HTML-разметкой.
+     */
+    private stripHtml;
+    /**
+     * Нормализует дату в формат Schema.org (ISO 8601).
+     *
+     * @param dateValue Дата для нормализации.
+     */
+    private normalizeSchemaDate;
     /**
      * Нормализует дату окончания цены в формат Schema.org (YYYY-MM-DD).
      *
@@ -90,6 +143,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}.
      */
@@ -63,15 +67,17 @@ export declare class ScSeoService {
      * @param resource Ресурс на основе которого необходимо установить мета-теги.
      * @param img Изображение. Если не пришло, то будет установлено значение по умолчанию.
      * @param robots Список robots-тегов для страницы.
+     * @param schemaOrgData Данные Schema.org для встраивания на странице.
      */
-    setFromResource(resource?: ScISeo, img?: string, robots?: RobotsTagType[]): void;
+    setFromResource(resource?: ScISeo, img?: string, robots?: RobotsTagType[], schemaOrgData?: WithContext<Thing>): void;
     /**
      * Устанавливает seo параметры со значением по умолчанию.
      *
      * @param title Заголовок страницы.
      * @param robots Список robots тегов для страницы.
+     * @param schemaOrgData Данные Schema.org для встраивания на странице.
      */
-    setByDefault(title?: string, robots?: RobotsTagType[]): void;
+    setByDefault(title?: string, robots?: RobotsTagType[], schemaOrgData?: WithContext<Thing>): void;
     /**
      * Устанавливает seo параметры со значением по умолчанию. Устанавливает значение "не индексировать" для поисковых роботов.
      *