@snabcentr/client-core 4.7.1 → 4.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snabcentr/client-core",
-  "version": "4.7.1",
+  "version": "4.10.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 @@
-## 4.7.1 (2026-07-02)
+## 4.10.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/types/snabcentr-client-core.d.ts

@@ -4,7 +4,7 @@ import { InjectionToken, EventEmitter, Type, ClassProvider, ValueProvider, Provi
 import { HttpRequest, HttpClient, HttpParams, HttpContextToken, HttpHandlerFn, HttpEvent, HttpContext } from '@angular/common/http';
 import * as _snabcentr_client_core from '@snabcentr/client-core';
 import { Router, ActivatedRouteSnapshot, UrlTree, CanActivateFn, ActivatedRoute } from '@angular/router';
-import { WithContext, Product, CollectionPage, Thing } from 'schema-dts';
+import { WithContext, Product, CollectionPage, Organization, NewsArticle, FAQPage, Thing } from 'schema-dts';
 
 /**
  * Статусы состояния запроса.
@@ -572,7 +572,32 @@ interface ScICompanyBaseInfo {
     /**
      * Адрес компании.
      */
-    readonly address: string;
+    readonly address: {
+        /**
+         * Страна.
+         */
+        readonly country: string;
+        /**
+         * Регион.
+         */
+        readonly region: string;
+        /**
+         * Населенный пункт.
+         */
+        readonly locality: string;
+        /**
+         * Улица, дом, корпус, строение и т. п. (то есть адрес с точностью до здания).
+         */
+        readonly streetAddress: string;
+        /**
+         * Подъезд, этаж, офис и т. п. (то есть сведения о местонахождении внутри здания), название торгового или бизнес-центра, а также любое описание, не являющееся точным адресом.
+         */
+        readonly extendedAddress?: string;
+        /**
+         * Почтовый индекс.
+         */
+        readonly postalCode: string;
+    };
     /**
      * Юридический адрес компании.
      */
@@ -9293,8 +9318,9 @@ 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>;
     /**
      * Генерирует и возвращает схему данных для указанного продукта.
      *
@@ -9303,8 +9329,58 @@ 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[], 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 Дата для нормализации.
      */
-    generateForCategoryItem(category: ScICategory | ScIVirtualCategory, products: ScIProduct[], categoryPath: string, productPath: string, breadcrumbs: ScIBreadcrumbItem[]): WithContext<CollectionPage>;
+    private normalizeSchemaDate;
     /**
      * Нормализует дату окончания цены в формат Schema.org (YYYY-MM-DD).
      *
@@ -9354,6 +9430,14 @@ 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>;
 }
@@ -9407,6 +9491,10 @@ declare class ScSeoService {
      * Объект {@link Document}, предоставляющий доступ к DOM страницы.
      */
     private readonly document;
+    /**
+     * Фабрика для создания данных Schema.org.
+     */
+    private readonly schemaOrgFactory;
     /**
      * Фабрика для создания экземпляров {@link Renderer2}.
      */
@@ -9421,15 +9509,17 @@ 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 параметры со значением по умолчанию. Устанавливает значение "не индексировать" для поисковых роботов.
      *