denwa-web-shared 1.0.60 → 1.0.61

package/dist/src/server/lib/utils.d.ts

@@ -0,0 +1,253 @@
+import { IPaginate, IPreparedServerImageWithAlt, PaginationResult } from '../types';
+import { PictureData } from '../types/picture-data';
+/**
+ * @description Хелпер для генерации путей к адаптивным статичным изображениям (PictureData)
+ * @param basePath - Базовый путь к директории (например, '/compressed/cta')
+ * @param filename - Имя файла без расширения (например, 'cta-arrow')
+ * @param ext - Расширение исходного fallback-файла (по умолчанию 'jpg')
+ * @return Объект PictureData со всеми нужными форматами
+ */
+export declare const getImageData: (basePath: string, filename: string, ext: "jpg" | "png" | "jpeg") => PictureData;
+/**
+ * @description Получить Intl для нужного языка
+ * @param locale - Локаль
+ * @param options - Опции
+ */
+export declare const getNumberFormatter: (locale: string, options?: Intl.NumberFormatOptions) => Intl.NumberFormat;
+/**
+ * @description Получить Intl даты для нужного языка
+ * @param locale - Локаль
+ * @param options - Опции
+ */
+export declare const getDateFormatter: (locale: string, options?: Intl.DateTimeFormatOptions) => Intl.DateTimeFormat;
+/**
+ * @description Получить значение по ключу
+ * @param obj - Объект
+ * @param key - Ключ
+ */
+export declare const getByKey: <T extends object, K extends keyof T>(obj: T, key: K | string) => T[K] | undefined;
+/**
+ * @description Преобразует value у инпута в поле маски телефона
+ * @param eventValue - исходное значение инпута
+ * @response Возвращает либо обработанную строку, либо пустую строку
+ * @example
+ * 79881234567 -> +79881234567
+ * 89881234567 -> +79881234567
+ * 19881234567 -> +19881234567
+ * 8 (988) 505-42-19 -> +79885054219
+ */
+export declare const convertPhoneMask: (eventValue: string) => string;
+/**
+ * @description Получить корректный поддомен из адреса хоста
+ * @param host - url хоста
+ * @param SUB_DOMAIN - Объект ключ-значение со списком поддоменов
+ */
+export declare const getSubdomain: (host: string, SUB_DOMAIN: Record<string, string>) => string;
+/**
+ * @description Заменяет текст по маске {{}}
+ * @param text - Исходный текст
+ * @param subdomain - Значение города, которое подставится
+ * @param SUBDOMAIN_NAME - Объект ключ-значение со списком поддоменов
+ * @param SUBDOMAIN_MASK - Объект ключ-значение со списком масок поддоменов
+ * @return Обновленная строка
+ */
+export declare const updateTextByTemplate: ({ text, subdomain, SUBDOMAIN_NAME, SUBDOMAIN_MASK, }: {
+    text: string;
+    subdomain?: string;
+    SUBDOMAIN_NAME?: Record<string, {
+        name: string;
+        declination: string;
+        region: string;
+        regionDeclination: string;
+    }>;
+    SUBDOMAIN_MASK?: {
+        CITY: string;
+        CITY_DECL: string;
+        CITY_REGION: string;
+        CITY_REGION_DECL: string;
+    };
+}) => string;
+/**
+ * @description Заменят мета текст по маске, переданный напрямую
+ * @param subdomain - Поддомен
+ * @param metaData - Объект с title, descrption, keywords
+ * @param host - Хост сайта
+ * @param lang - Объект для локализации
+ * @param isSubdomain - Нужны ли поддомены в адресе хоста
+ * @param SUBDOMAIN_NAME - Объект ключ-значение со списком поддоменов
+ * @param SUBDOMAIN_MASK - Объект ключ-значение со списком масок поддоменов
+ * @param DEFAULT_SEO_TEXT - Объект ключ-значение со списком масок поддоменов
+ * @return Объект с мета тегами
+ */
+export declare const prepareLocalMetaData: <T extends object>({ subdomain, metaData, host, lang, isSubdomain, SUBDOMAIN_NAME, SUBDOMAIN_MASK, DEFAULT_SEO_TEXT, }: {
+    subdomain?: string;
+    metaData: {
+        title: string;
+        description: string;
+        keywords: string;
+        canonical?: string;
+    };
+    host: string;
+    lang?: {
+        locale: string;
+        locales: string[];
+        defaultLocale: string;
+        route: string;
+        city?: string;
+    };
+    isSubdomain?: boolean;
+    SUBDOMAIN_NAME?: Record<string, {
+        name: string;
+        declination: string;
+        region: string;
+        regionDeclination: string;
+    }>;
+    SUBDOMAIN_MASK?: {
+        CITY: string;
+        CITY_DECL: string;
+        CITY_REGION: string;
+        CITY_REGION_DECL: string;
+    };
+    DEFAULT_SEO_TEXT: {
+        title: string;
+        description: string;
+        keywords: string;
+    };
+}) => T;
+/**
+ * @description Превращает строку формата /catalog/price-from__1000--price-to__5000 в { price-from: '1000', price-to: '5000' }
+ * @param input - изначальная строка
+ * @return Объект с парами ключ-значение
+ */
+export declare const parseStringToKeyValue: <T extends object>(input: string) => T;
+/**
+ * @description Конвентирует цвет из enum в строку
+ * @param color1 - цвет 1
+ * @param color2 - цвет 2
+ * @param notFoundText - текст при отсутствии цвета
+ * @param COLORS_NAMES - Объект ключ-значение со списком названий цветов
+ * @return Строка с названием цветов
+ */
+export declare const prepareColor: ({ color1, color2, notFoundText, COLORS_NAMES, }: {
+    color1: string;
+    color2?: string | null;
+    notFoundText: string;
+    COLORS_NAMES: Record<string, string>;
+}) => string;
+/**
+ * @description Подготавливает серверную пагинацию для клиента
+ * @param pagination - Серверная пагинация
+ * @param baseUrl - Url страницы
+ * @param initialParams - Параметры url
+ */
+export declare const generatePaginationArray: (pagination: IPaginate | null, baseUrl: string, initialParams: Record<string, string>) => PaginationResult;
+/**
+ * @description Превращение массива в объект ключ-значение
+ * @param arr - Массив
+ */
+export declare const arrayToKeyValueObject: <T extends string>(arr: T[]) => Record<T, T>;
+/**
+ * @description Подготовка номера страницы, полученной из query параметров
+ * @param page - Номер страницы
+ */
+export declare const preparePageParam: (page: string | number | undefined) => number;
+/**
+ * @description Проверка html на пустоту
+ * @param html - Html разметка редактора
+ */
+export declare const isNotEmptyHtml: (html: string | null | undefined) => boolean;
+/**
+ * @description Подстановка города в путь ссылки
+ * @param city - Город
+ * @param href - Ссылка
+ */
+export declare const createCityLink: (city: string, href: string) => string;
+/**
+ * @description Получить текстовое поле по локали
+ * @param locale - Локаль. Пример ru
+ * @param field - Пример text1
+ * @param data - Объект с полями. К примеру text1RU и text1EN
+ * @result - Текст поля
+ */
+export declare const getLocaleField: ({ locale, field, data, }: {
+    locale: string;
+    field: string;
+    data?: object | null;
+}) => string;
+/**
+ * @description Проверка user agent на бота
+ * @param userAgent - user agent
+ * @result - boolean
+ */
+export declare const isBotUserAgent: (userAgent: string) => boolean;
+/**
+ * Генерирует приятный цвет для заглушек фотографий карточек
+ * @param seed - Необязательное число или строка для предсказуемой генерации цвета
+ * @returns Цвет в формате HEX (#RRGGBB)
+ */
+export declare const generatePlaceholderColor: (seed?: number | string) => string;
+/**
+ * Конвертирует цвет из формата HSL в HEX
+ * @param h - Оттенок (0-360)
+ * @param s - Насыщенность (0-100)
+ * @param l - Яркость (0-100)
+ * @returns Цвет в формате HEX (#RRGGBB)
+ */
+export declare const hslToHex: (h: number, s: number, l: number) => string;
+/**
+ * Преобразует UUID в короткий ID
+ * @param {string} uuid - UUID v4 строка (с дефисами или без)
+ * @param {number} length - нужная длина (по умолчанию 18)
+ * @returns {string} короткий ID без дефисов
+ */
+export declare const uuidToStringId: (uuid: string, length?: number) => string;
+/**
+ * Преобразует UUID в числовой ID
+ * @param {string} uuid - UUID v4 строка (с дефисами или без)
+ * @param {number} maxDigits - максимальное количество цифр в результате (по умолчанию 18)
+ * @returns {string} числовой ID в виде строки
+ */
+export declare const uuidToNumericId: (uuid: string, maxDigits?: number) => string;
+/**
+ * @description Экранирует XML-специальные символы в строке.
+ * @param str - Строка
+ */
+export declare const escapeXml: (str: string) => string;
+/**
+ * @description Генерирует XML-фид для яндекс товаров.
+ * @param shopName - Название магазина
+ * @param shopCompany - Компания
+ * @param delivery - Доставка
+ * @param categoriesData - Категории
+ * @param offersData - Товары
+ * @param host - Хост
+ * @response Готовый xml фид товаров
+ */
+export declare const generateYandexFeedXML: ({ shopName, shopCompany, delivery, categoriesData, offersData, host, }: {
+    shopName: string;
+    shopCompany: string;
+    host: string;
+    delivery: boolean;
+    categoriesData: {
+        id: string | number;
+        name: string;
+        parentId?: string | number;
+    }[];
+    offersData: {
+        id: string | number;
+        categoryId: string | number;
+        name: string;
+        vendor: string;
+        vendorCode?: string | null;
+        description: string;
+        href: string;
+        images: IPreparedServerImageWithAlt[];
+        price: number;
+        pickup: boolean;
+        isPopular?: boolean;
+        params?: {
+            name: string;
+            value: string;
+        }[];
+    }[];
+}) => string;

package/dist/src/server/schemas/index.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const responseSchema: z.ZodObject<{
+    statusCode: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    messages: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    data: z.ZodNullable<z.ZodOptional<z.ZodAny>>;
+    error: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        statusCode: z.ZodNumber;
+        message: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        messages: z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>>;
+    response: z.ZodNullable<z.ZodOptional<z.ZodAny>>;
+}, z.core.$strip>;
+export declare const serverImageSchema: z.ZodObject<{
+    altRU: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    altEN: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    altAR: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    name: z.ZodString;
+    originalFileExtension: z.ZodString;
+    fileExtensions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    prefixes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    folder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const serverFileSchema: z.ZodObject<{
+    name: z.ZodString;
+    fullName: z.ZodString;
+    extension: z.ZodString;
+    entityId: z.ZodString;
+    fullPathExample: z.ZodString;
+    folder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/src/server/types/index.d.ts

@@ -0,0 +1,70 @@
+export interface IServerImage {
+    altRU?: string;
+    altEN?: string;
+    altAR?: string;
+    name: string;
+    originalFileExtension: string;
+    entityId: string;
+    fullPathExample: string;
+    folder?: string;
+    prefixes?: string[];
+    fileExtensions?: string[];
+}
+export interface IServerFile {
+    name: string;
+    fullName: string;
+    extension: string;
+    entityId: string;
+    fullPathExample: string;
+    folder?: string;
+}
+export interface IPreparedServerImage {
+    image1x: string;
+    image2x: string;
+    image1xWebp: string;
+    image2xWebp: string;
+    image1xAvif: string;
+    image2xAvif: string;
+    mobileImage1x?: string;
+    mobileImage2x?: string;
+    mobileImage1xWebp?: string;
+    mobileImage2xWebp?: string;
+    mobileImage1xAvif?: string;
+    mobileImage2xAvif?: string;
+    altRU?: string;
+    altEN?: string;
+    altAR?: string;
+    type: ImageType;
+}
+export interface IPreparedServerImageWithAlt extends IPreparedServerImage {
+    alt?: string;
+}
+export type ImageType = 'image/png' | 'image/jpeg';
+export interface IPaginate {
+    page: number;
+    pages: number;
+    previous?: number;
+    next?: number;
+    count: number;
+    limit: number;
+}
+export interface PaginationButton {
+    label: string;
+    href: string;
+    isActive: boolean;
+}
+export interface PaginationResult {
+    buttons: PaginationButton[];
+    firstPage?: PaginationButton;
+    lastPage?: PaginationButton;
+}
+export type GetErrorType = ({ error, message }: {
+    error?: unknown;
+    message?: string;
+}) => void;
+export type CityNamesType = Record<string, {
+    name: string;
+    declination: string;
+    region: string;
+    regionDeclination: string;
+}>;

package/dist/src/server/types/picture-data.d.ts

@@ -0,0 +1,14 @@
+export interface PictureData {
+    image1x: string;
+    image2x: string;
+    image1xWebp: string;
+    image2xWebp: string;
+    image1xAvif: string;
+    image2xAvif: string;
+    mobileImage1x: string;
+    mobileImage2x: string;
+    mobileImage1xWebp: string;
+    mobileImage2xWebp: string;
+    mobileImage1xAvif: string;
+    mobileImage2xAvif: string;
+}

package/dist/src/server/ui/container.d.ts

@@ -0,0 +1,5 @@
+import { FC, HTMLAttributes } from '../../../node_modules/react';
+export interface ContainerProps extends HTMLAttributes<HTMLDivElement> {
+    variant?: 'default' | 'large';
+}
+export declare const Container: FC<ContainerProps>;

package/dist/src/server/ui/image.d.ts

@@ -0,0 +1,25 @@
+import { DetailedHTMLProps, FC, HTMLAttributes, ImgHTMLAttributes } from '../../../node_modules/react';
+import { ImageType } from '../types';
+export interface BasePictureProps extends DetailedHTMLProps<HTMLAttributes<HTMLPictureElement>, HTMLPictureElement> {
+    imgProps?: DetailedHTMLProps<ImgHTMLAttributes<HTMLImageElement>, HTMLImageElement>;
+    data: PictureData | undefined;
+    type: ImageType | undefined;
+    alt: string;
+    mobileMaxWidth?: number;
+    loading?: 'eager' | 'lazy';
+}
+export interface PictureData {
+    image1x: string | undefined;
+    image2x?: string;
+    image1xWebp?: string;
+    image2xWebp?: string;
+    image1xAvif?: string;
+    image2xAvif?: string;
+    mobileImage1x?: string;
+    mobileImage2x?: string;
+    mobileImage1xWebp?: string;
+    mobileImage2xWebp?: string;
+    mobileImage1xAvif?: string;
+    mobileImage2xAvif?: string;
+}
+export declare const BasePicture: FC<BasePictureProps>;

package/dist/src/server/ui/index.d.ts

@@ -0,0 +1,3 @@
+export * from './image';
+export * from './video';
+export * from './container';

package/dist/src/server/ui/video.d.ts

@@ -0,0 +1,2 @@
+import { FC, VideoHTMLAttributes } from '../../../node_modules/react';
+export declare const Video: FC<VideoHTMLAttributes<HTMLVideoElement>>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "denwa-web-shared",
   "private": false,
-  "version": "1.0.60",
+  "version": "1.0.61",
   "type": "module",
   "author": "Denwa",
   "main": "dist/denwa-web-shared.cjs.js",
@@ -51,39 +51,42 @@
     "react-dom": ">=17.0.0"
   },
   "dependencies": {
+    "axios": "^1.16.1",
     "clsx": "^2.1.1",
-    "motion": "^12.38.0",
+    "motion": "^12.40.0",
+    "openapi-typescript-helpers": "^0.1.0",
+    "query-string": "^9.4.0",
     "react-use": "^17.6.0",
-    "tailwind-merge": "^3.3.1",
-    "zod": "^4.1.5"
+    "tailwind-merge": "^3.6.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.28.0",
-    "@tanstack/intent": "^0.0.36",
-    "@types/react": "^19.1.6",
-    "@types/react-dom": "^19.1.6",
-    "@vitejs/plugin-react-swc": "^3.10.1",
-    "autoprefixer": "^10.4.21",
-    "eslint": "^9.28.0",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.4.1",
-    "eslint-plugin-react-hooks": "^5.2.0",
-    "eslint-plugin-react-refresh": "^0.4.20",
-    "globals": "^16.2.0",
-    "postcss": "^8.5.4",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@tanstack/intent": "^0.0.41",
+    "@types/react": "^19.2.15",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react-swc": "^4.3.1",
+    "autoprefixer": "^10.5.0",
+    "eslint": "^10.4.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.6",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "globals": "^17.6.0",
+    "postcss": "^8.5.15",
     "postcss-cli": "^11.0.1",
-    "postcss-custom-media": "^11.0.6",
-    "postcss-import": "^16.1.0",
-    "postcss-nesting": "^13.0.1",
-    "prettier": "^3.5.3",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "postcss-custom-media": "^12.0.1",
+    "postcss-import": "^16.1.1",
+    "postcss-nesting": "^14.0.0",
+    "prettier": "^3.8.3",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
     "standard-version": "^9.5.0",
-    "typescript": "~5.8.3",
-    "typescript-eslint": "^8.33.1",
-    "vite": "^6.3.5",
-    "vite-plugin-dts": "^4.5.4"
+    "typescript": "~6.0.3",
+    "typescript-eslint": "^8.60.0",
+    "vite": "^8.0.14",
+    "vite-plugin-dts": "^5.0.1"
   },
   "keywords": [
     "tanstack-intent"