@escapenavigator/hooks 2.0.45 → 2.0.46

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './consent-checkboxes';
 export * from './functional-popover';
 export * from './input-tel';
 export * from './lazy-with-retry';
+export * from './lead-form';
 export * from './players-and-variation-picker';
 export * from './use-debounced-value';
 export * from './use-localstore-state';

package/dist/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./consent-checkboxes"), exports);
 __exportStar(require("./functional-popover"), exports);
 __exportStar(require("./input-tel"), exports);
 __exportStar(require("./lazy-with-retry"), exports);
+__exportStar(require("./lead-form"), exports);
 __exportStar(require("./players-and-variation-picker"), exports);
 __exportStar(require("./use-debounced-value"), exports);
 __exportStar(require("./use-localstore-state"), exports);

package/dist/lead-form/index.d.ts

@@ -0,0 +1,6 @@
+export { LeadField } from './lead-field';
+export type { LeadFormSubmit, LeadFormSubmitPayload, LeadFormSubmitResult } from './lead-form';
+export { LeadForm } from './lead-form';
+export type { LeadFieldValue, LeadFormPrefill, LeadFormValues } from './lib';
+export { buildAnswers, buildInitialValues, isVisible, localized, validate } from './lib';
+export { useLeadT } from './use-lead-t';

package/dist/lead-form/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLeadT = exports.validate = exports.localized = exports.isVisible = exports.buildInitialValues = exports.buildAnswers = exports.LeadForm = exports.LeadField = void 0;
+var lead_field_1 = require("./lead-field");
+Object.defineProperty(exports, "LeadField", { enumerable: true, get: function () { return lead_field_1.LeadField; } });
+var lead_form_1 = require("./lead-form");
+Object.defineProperty(exports, "LeadForm", { enumerable: true, get: function () { return lead_form_1.LeadForm; } });
+var lib_1 = require("./lib");
+Object.defineProperty(exports, "buildAnswers", { enumerable: true, get: function () { return lib_1.buildAnswers; } });
+Object.defineProperty(exports, "buildInitialValues", { enumerable: true, get: function () { return lib_1.buildInitialValues; } });
+Object.defineProperty(exports, "isVisible", { enumerable: true, get: function () { return lib_1.isVisible; } });
+Object.defineProperty(exports, "localized", { enumerable: true, get: function () { return lib_1.localized; } });
+Object.defineProperty(exports, "validate", { enumerable: true, get: function () { return lib_1.validate; } });
+var use_lead_t_1 = require("./use-lead-t");
+Object.defineProperty(exports, "useLeadT", { enumerable: true, get: function () { return use_lead_t_1.useLeadT; } });

package/dist/lead-form/lead-field.d.ts

@@ -0,0 +1,18 @@
+import { LeadFormField } from '@escapenavigator/types/dist/lead/lead-form-field.type';
+import { PublicLeadFormReferenceRO } from '@escapenavigator/types/dist/lead/public/public-lead-form.ro';
+import { CountriesEnum } from '@escapenavigator/types/dist/shared/enum/countries.enum';
+import React from 'react';
+import { LeadFieldValue } from './lib';
+type Props = {
+    field: LeadFormField;
+    value: LeadFieldValue;
+    error?: string;
+    language: string;
+    profileCountry: CountriesEnum;
+    questrooms: PublicLeadFormReferenceRO[];
+    locations: PublicLeadFormReferenceRO[];
+    onChange: (value: LeadFieldValue) => void;
+    onPhoneValidChange: (valid: boolean) => void;
+};
+export declare const LeadField: React.FC<Props>;
+export {};

package/dist/lead-form/lead-field.js

@@ -0,0 +1,105 @@
+"use strict";
+/* eslint-disable import/no-extraneous-dependencies */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeadField = void 0;
+const MinusM_1 = __importDefault(require("@alphakits/icons/dist/MinusM"));
+const PlusM_1 = __importDefault(require("@alphakits/icons/dist/PlusM"));
+const ui_1 = require("@alphakits/ui");
+const lead_field_type_enum_1 = require("@escapenavigator/types/dist/lead/enums/lead-field-type.enum");
+const react_1 = __importDefault(require("react"));
+const input_tel_1 = require("../input-tel");
+const index_module_css_1 = __importDefault(require("./index.module.css"));
+const lib_1 = require("./lib");
+const use_lead_t_1 = require("./use-lead-t");
+const TIME_STEP_MINUTES = 30;
+/** Слоты выбора времени: клиенту хватает получаса, а свободный ввод он ломает. */
+const buildTimeOptions = () => {
+    const out = [];
+    for (let minutes = 0; minutes < 24 * 60; minutes += TIME_STEP_MINUTES) {
+        const value = `${String(Math.floor(minutes / 60)).padStart(2, '0')}:${String(minutes % 60).padStart(2, '0')}`;
+        out.push({ key: value, content: value });
+    }
+    return out;
+};
+const TIME_OPTIONS = buildTimeOptions();
+const LeadField = ({ field, value, error, language, profileCountry, questrooms, locations, onChange, onPhoneValidChange, }) => {
+    var _a, _b;
+    const t = (0, use_lead_t_1.useLeadT)();
+    const title = (0, lib_1.fieldTitle)(field, language);
+    const label = field.required ? `${title} *` : title;
+    const placeholder = (0, lib_1.fieldText)(field, language, 'placeholder');
+    const description = (0, lib_1.fieldText)(field, language, 'description');
+    const hint = description ? (react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', color: 'secondary' }, description)) : null;
+    const withHint = (control) => {
+        if (!hint)
+            return control;
+        return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 4 },
+            control,
+            hint));
+    };
+    const activeOptions = (field.options || []).filter((option) => option.active !== false);
+    const referenceOptions = (items) => items.map((item) => ({ key: String(item.id), content: item.title }));
+    switch (field.type) {
+        case lead_field_type_enum_1.LeadFieldTypeEnum.PHONE:
+            return withHint(react_1.default.createElement(input_tel_1.InputTel, { label: label, value: String(value || ''), profileCountry: profileCountry, locale: language, widgetMode: true, error: error, onChange: (payload) => {
+                    onChange(payload.phone);
+                    onPhoneValidChange(payload.isValid);
+                } }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.TEXTAREA:
+            return withHint(react_1.default.createElement(ui_1.Textarea, { block: true, maxLength: 1000, label: label, placeholder: placeholder, value: String(value || ''), error: error, onChange: (_e, payload) => onChange(payload.value) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.DATE:
+            return withHint(react_1.default.createElement(ui_1.CalendarInput, { block: true, label: label, lang: language, value: String(value || ''), error: error, onChange: (_e, payload) => onChange(payload.value) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.TIME:
+            return withHint(react_1.default.createElement(ui_1.Select, { block: true, optionsListWidth: 'field', label: label, options: TIME_OPTIONS, selected: String(value || ''), error: error, onChange: ({ selected }) => onChange(selected === null || selected === void 0 ? void 0 : selected.key) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.GUESTS: {
+            const min = (_a = field.min) !== null && _a !== void 0 ? _a : 1;
+            const max = (_b = field.max) !== null && _b !== void 0 ? _b : 30;
+            const current = typeof value === 'number' ? value : min;
+            return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 8 },
+                react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', weight: 'medium' }, label),
+                react_1.default.createElement("div", { className: index_module_css_1.default.stepper },
+                    react_1.default.createElement("button", { type: 'button', className: index_module_css_1.default.stepperButton, "aria-label": t('lead.guestsMinus'), disabled: current <= min, onClick: () => onChange(Math.max(min, current - 1)) },
+                        react_1.default.createElement(MinusM_1.default, null)),
+                    react_1.default.createElement("span", { className: index_module_css_1.default.stepperValue }, current),
+                    react_1.default.createElement("button", { type: 'button', className: index_module_css_1.default.stepperButton, "aria-label": t('lead.guestsPlus'), disabled: current >= max, onClick: () => onChange(Math.min(max, current + 1)) },
+                        react_1.default.createElement(PlusM_1.default, null))),
+                hint));
+        }
+        case lead_field_type_enum_1.LeadFieldTypeEnum.NUMBER:
+            return withHint(react_1.default.createElement(ui_1.Input, { block: true, label: label, placeholder: placeholder, inputMode: 'numeric', value: value === undefined ? '' : String(value), error: error, onChange: (_e, payload) => onChange(payload.value.replace(/\D/g, '') || undefined) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.SELECT:
+            return withHint(react_1.default.createElement(ui_1.Select, { block: true, allowUnselect: !field.required, optionsListWidth: 'field', label: label, placeholder: placeholder, options: activeOptions.map((option) => ({
+                    key: option.id,
+                    content: (0, lib_1.optionLabel)(option, language, option.id),
+                })), selected: String(value || ''), error: error, onChange: ({ selected }) => onChange(selected === null || selected === void 0 ? void 0 : selected.key) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.RADIO:
+            return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 8 },
+                react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', weight: 'medium' }, label),
+                activeOptions.map((option) => (react_1.default.createElement(ui_1.Radio, { key: option.id, label: (0, lib_1.optionLabel)(option, language, option.id), checked: value === option.id, onChange: () => onChange(option.id) }))),
+                hint,
+                !!error && (react_1.default.createElement(ui_1.Typography.Text, { view: 'caps', color: 'negative' }, error))));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.CHECKBOX: {
+            const selected = Array.isArray(value) ? value : [];
+            return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 8 },
+                react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', weight: 'medium' }, label),
+                activeOptions.map((option) => (react_1.default.createElement(ui_1.Checkbox, { key: option.id, label: (0, lib_1.optionLabel)(option, language, option.id), checked: selected.includes(option.id), onChange: () => onChange(selected.includes(option.id)
+                        ? selected.filter((item) => item !== option.id)
+                        : [...selected, option.id]) }))),
+                hint,
+                !!error && (react_1.default.createElement(ui_1.Typography.Text, { view: 'caps', color: 'negative' }, error))));
+        }
+        case lead_field_type_enum_1.LeadFieldTypeEnum.QUESTROOM:
+        case lead_field_type_enum_1.LeadFieldTypeEnum.LOCATION:
+            return withHint(react_1.default.createElement(ui_1.Select, { block: true, allowUnselect: !field.required, optionsListWidth: 'field', label: label, placeholder: placeholder, options: referenceOptions(field.type === lead_field_type_enum_1.LeadFieldTypeEnum.QUESTROOM ? questrooms : locations), selected: String(value || ''), error: error, onChange: ({ selected }) => onChange(selected === null || selected === void 0 ? void 0 : selected.key) }));
+        case lead_field_type_enum_1.LeadFieldTypeEnum.CONSENT:
+            return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 4 },
+                react_1.default.createElement(ui_1.Checkbox, { size: 's', align: 'start', block: true, label: react_1.default.createElement(ui_1.Typography.Text, { view: 'caps', color: 'secondary' }, title), hint: description, checked: value === true, onChange: (_e, payload) => onChange(!!(payload === null || payload === void 0 ? void 0 : payload.checked)) }),
+                !!error && (react_1.default.createElement(ui_1.Typography.Text, { view: 'caps', color: 'negative' }, error))));
+        default:
+            return withHint(react_1.default.createElement(ui_1.Input, { block: true, label: label, placeholder: placeholder, spellCheck: false, type: field.type === lead_field_type_enum_1.LeadFieldTypeEnum.EMAIL ? 'email' : 'text', value: String(value || ''), error: error, onChange: (_e, payload) => onChange(payload.value) }));
+    }
+};
+exports.LeadField = LeadField;

package/dist/lead-form/lead-form.d.ts

@@ -0,0 +1,44 @@
+import { LeadSourceEnum } from '@escapenavigator/types/dist/lead/enums/lead-source.enum';
+import { PublicLeadFormRO } from '@escapenavigator/types/dist/lead/public/public-lead-form.ro';
+import { SubmitLeadAnswerDto } from '@escapenavigator/types/dist/lead/public/submit-lead.dto';
+import { SubmitLeadRO } from '@escapenavigator/types/dist/lead/public/submit-lead.ro';
+import { CountriesEnum } from '@escapenavigator/types/dist/shared/enum/countries.enum';
+import React from 'react';
+import { LeadFormPrefill } from './lib';
+export type LeadFormSubmitPayload = {
+    formId: number;
+    answers: SubmitLeadAnswerDto[];
+    source: LeadSourceEnum;
+    trap?: string;
+};
+/**
+ * Отправку делает вызывающая сторона: из виджета заявка уходит с
+ * widget-токеном, со standalone-страницы — по uuid формы. `null` или
+ * ответ без `data` — обработанная ошибка. `error.message` с бэка нужна,
+ * чтобы показать лимит запросов отдельно от общего сбоя.
+ */
+export type LeadFormSubmitResult = {
+    data?: SubmitLeadRO;
+    error?: {
+        message?: string;
+    };
+};
+export type LeadFormSubmit = (payload: LeadFormSubmitPayload) => Promise<LeadFormSubmitResult | null>;
+type Props = {
+    form: PublicLeadFormRO;
+    source: LeadSourceEnum;
+    language: string;
+    profileCountry: CountriesEnum;
+    submit: LeadFormSubmit;
+    /** Что клиент уже выбрал до формы — подставляем по роли поля. */
+    prefill?: LeadFormPrefill;
+    /** Контекст выбора (пакет, дата, гости) — уходит в комментарий заявки. */
+    contextNote?: string;
+    /** Шапку рисует контейнер, если у него своя (модалка, страница). */
+    withHeader?: boolean;
+    /** Что делать после успеха: модалка закрывается, страница остаётся. */
+    onDone?: () => void;
+    doneLabel?: string;
+};
+export declare const LeadForm: React.FC<Props>;
+export {};

package/dist/lead-form/lead-form.js

@@ -0,0 +1,125 @@
+"use strict";
+/* eslint-disable import/no-extraneous-dependencies */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeadForm = void 0;
+const CheckmarkCircleFillM_1 = __importDefault(require("@alphakits/icons/dist/CheckmarkCircleFillM"));
+const ui_1 = require("@alphakits/ui");
+const react_1 = __importStar(require("react"));
+const index_module_css_1 = __importDefault(require("./index.module.css"));
+const lead_field_1 = require("./lead-field");
+const lib_1 = require("./lib");
+const use_lead_t_1 = require("./use-lead-t");
+const LeadForm = ({ form, source, language, profileCountry, submit, prefill, contextNote, withHeader = true, onDone, doneLabel, }) => {
+    const t = (0, use_lead_t_1.useLeadT)();
+    const [values, setValues] = (0, react_1.useState)(() => (0, lib_1.buildInitialValues)(form, prefill));
+    const [errors, setErrors] = (0, react_1.useState)({});
+    const [formError, setFormError] = (0, react_1.useState)();
+    const [phoneValid, setPhoneValid] = (0, react_1.useState)(false);
+    const [sending, setSending] = (0, react_1.useState)(false);
+    const [success, setSuccess] = (0, react_1.useState)();
+    // Honeypot: настоящий человек скрытое поле не увидит и не заполнит.
+    const [trap, setTrap] = (0, react_1.useState)('');
+    const setValue = (fieldId, value) => {
+        setValues((prev) => (Object.assign(Object.assign({}, prev), { [fieldId]: value })));
+        setErrors((prev) => (prev[fieldId] ? Object.assign(Object.assign({}, prev), { [fieldId]: '' }) : prev));
+        setFormError(undefined);
+    };
+    const handleSubmit = () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        if (sending)
+            return;
+        const result = (0, lib_1.validate)({ form, values, phoneValid, t });
+        if (Object.keys(result.errors).length || result.formError) {
+            setErrors(result.errors);
+            setFormError(result.formError);
+            return;
+        }
+        setSending(true);
+        setFormError(undefined);
+        const response = yield submit({
+            formId: form.id,
+            answers: (0, lib_1.buildAnswers)(form, values, contextNote),
+            source,
+            trap: trap || undefined,
+        });
+        setSending(false);
+        if (!(response === null || response === void 0 ? void 0 : response.data)) {
+            setFormError(/too many/i.test(((_a = response === null || response === void 0 ? void 0 : response.error) === null || _a === void 0 ? void 0 : _a.message) || '')
+                ? t('lead.tooManyRequests')
+                : t('lead.failed'));
+            return;
+        }
+        setSuccess(response.data);
+    });
+    if (success) {
+        return (react_1.default.createElement("div", { className: index_module_css_1.default.success },
+            react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 16 },
+                react_1.default.createElement("span", { className: index_module_css_1.default.successIcon },
+                    react_1.default.createElement(CheckmarkCircleFillM_1.default, null)),
+                react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 4 },
+                    react_1.default.createElement(ui_1.Typography.Title, { tag: 'div', view: 'xsmall', weight: 'bold' }, (0, lib_1.localized)(success.successTitle, language) || t('lead.successTitle')),
+                    react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', color: 'secondary' }, (0, lib_1.localized)(success.successDescription, language) ||
+                        t('lead.successText'))),
+                !!onDone && (react_1.default.createElement(ui_1.Button, { view: 'primary', size: 's', block: true, onClick: onDone }, doneLabel || t('lead.close'))))));
+    }
+    const title = (0, lib_1.localized)(form.clientTitle, language) || t('lead.title');
+    const description = (0, lib_1.localized)(form.description, language);
+    return (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 16 },
+        withHeader && (react_1.default.createElement(ui_1.FlexColumns, { columns: 1, gr: 4 },
+            react_1.default.createElement(ui_1.Typography.Title, { tag: 'div', view: 'xsmall', weight: 'bold' }, title),
+            !!description && (react_1.default.createElement(ui_1.Typography.Text, { view: 'primary-small', color: 'secondary' }, description)))),
+        !!formError && react_1.default.createElement(ui_1.ToastPlate, { view: 'negative' }, formError),
+        form.fields
+            .filter((field) => (0, lib_1.isVisible)(field, values))
+            .map((field) => (react_1.default.createElement(lead_field_1.LeadField, { key: field.id, field: field, value: values[field.id], error: errors[field.id], language: language, profileCountry: profileCountry, questrooms: form.questrooms, locations: form.locations, onChange: (value) => setValue(field.id, value), onPhoneValidChange: setPhoneValid }))),
+        react_1.default.createElement("input", { className: index_module_css_1.default.trap, tabIndex: -1, autoComplete: 'off', "aria-hidden": 'true', value: trap, onChange: (event) => setTrap(event.target.value) }),
+        react_1.default.createElement(ui_1.Button, { view: 'primary', size: 's', block: true, loading: sending, onClick: handleSubmit }, sending
+            ? t('lead.sending')
+            : (0, lib_1.localized)(form.submitLabel, language) || t('lead.submit'))));
+};
+exports.LeadForm = LeadForm;

package/dist/lead-form/lib.d.ts

@@ -0,0 +1,56 @@
+import { LeadFieldMappingEnum } from '@escapenavigator/types/dist/lead/enums/lead-field-mapping.enum';
+import { LeadFieldTypeEnum } from '@escapenavigator/types/dist/lead/enums/lead-field-type.enum';
+import { LeadFormField } from '@escapenavigator/types/dist/lead/lead-form-field.type';
+import { PublicLeadFormRO } from '@escapenavigator/types/dist/lead/public/public-lead-form.ro';
+import { SubmitLeadAnswerDto } from '@escapenavigator/types/dist/lead/public/submit-lead.dto';
+import { LocalizedString } from '@escapenavigator/types/dist/shared/localized-string.type';
+export type LeadFieldValue = string | number | boolean | string[] | undefined;
+export type LeadFormValues = Record<string, LeadFieldValue>;
+/**
+ * Текст на языке виджета. Площадка могла не перевести форму на все языки —
+ * откатываемся на английский, потом на любой заполненный: пустой заголовок
+ * хуже чужого языка.
+ */
+export declare const localized: (source: LocalizedString | undefined, language: string) => string;
+export declare const fieldTitle: (field: LeadFormField, language: string) => string;
+export declare const fieldText: (field: LeadFormField, language: string, key: "placeholder" | "description") => string;
+export declare const optionLabel: (option: {
+    i18n: LocalizedString;
+}, language: string, fallback: string) => string;
+export declare const isMultiple: (type: LeadFieldTypeEnum) => boolean;
+/**
+ * Поле скрыто, пока в управляющем поле не выбран нужный вариант. Скрытое
+ * поле не валидируется и не попадает в ответы — иначе обязательная
+ * «уточните какой квест» блокировала бы отправку у всех остальных.
+ */
+export declare const isVisible: (field: LeadFormField, values: LeadFormValues) => boolean;
+/**
+ * Предзаполнение по смысловой роли поля, а не по его id: форма настраивается
+ * площадкой, и id полей у каждой свои. Роль (`mapsTo`) стабильна — по ней
+ * заявка из пакетов подставляет уже выбранную дату и число гостей.
+ */
+export type LeadFormPrefill = Partial<Record<LeadFieldMappingEnum, LeadFieldValue>>;
+export declare const buildInitialValues: (form: PublicLeadFormRO, prefill?: LeadFormPrefill) => LeadFormValues;
+type ValidateContext = {
+    form: PublicLeadFormRO;
+    values: LeadFormValues;
+    /** `InputTel` сам знает, валиден ли номер для выбранной страны. */
+    phoneValid: boolean;
+    t: (key: string) => string;
+};
+/**
+ * Валидация на клиенте — это про удобство: сервер всё равно перепроверит
+ * обязательность и наличие канала связи. Возвращаем ошибки по id поля плюс
+ * общую ошибку формы.
+ */
+export declare const validate: ({ form, values, phoneValid, t, }: ValidateContext) => {
+    errors: Record<string, string>;
+    formError?: string;
+};
+/**
+ * `contextNote` — то, что клиент уже выбрал до формы (пакет, дата, гости).
+ * Дописываем его в комментарий, а не в отдельное поле: у формы площадки
+ * такого поля может не быть, а менеджеру этот контекст нужен в карточке.
+ */
+export declare const buildAnswers: (form: PublicLeadFormRO, values: LeadFormValues, contextNote?: string) => SubmitLeadAnswerDto[];
+export {};

package/dist/lead-form/lib.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAnswers = exports.validate = exports.buildInitialValues = exports.isVisible = exports.isMultiple = exports.optionLabel = exports.fieldText = exports.fieldTitle = exports.localized = void 0;
+const lead_field_mapping_enum_1 = require("@escapenavigator/types/dist/lead/enums/lead-field-mapping.enum");
+const lead_field_type_enum_1 = require("@escapenavigator/types/dist/lead/enums/lead-field-type.enum");
+const languages_enum_1 = require("@escapenavigator/types/dist/shared/enum/languages.enum");
+/**
+ * Текст на языке виджета. Площадка могла не перевести форму на все языки —
+ * откатываемся на английский, потом на любой заполненный: пустой заголовок
+ * хуже чужого языка.
+ */
+const localized = (source, language) => {
+    if (!source)
+        return '';
+    const exact = source[language];
+    if (exact === null || exact === void 0 ? void 0 : exact.trim())
+        return exact;
+    const fallback = source[languages_enum_1.Languages.EN];
+    if (fallback === null || fallback === void 0 ? void 0 : fallback.trim())
+        return fallback;
+    return Object.values(source).find((value) => value === null || value === void 0 ? void 0 : value.trim()) || '';
+};
+exports.localized = localized;
+const fieldTitle = (field, language) => {
+    var _a, _b, _c, _d;
+    const i18n = ((_a = field.i18n) === null || _a === void 0 ? void 0 : _a[language]) || ((_b = field.i18n) === null || _b === void 0 ? void 0 : _b[languages_enum_1.Languages.EN]);
+    if ((_c = i18n === null || i18n === void 0 ? void 0 : i18n.title) === null || _c === void 0 ? void 0 : _c.trim())
+        return i18n.title;
+    return ((_d = Object.values(field.i18n || {}).find((item) => { var _a; return (_a = item === null || item === void 0 ? void 0 : item.title) === null || _a === void 0 ? void 0 : _a.trim(); })) === null || _d === void 0 ? void 0 : _d.title) || '';
+};
+exports.fieldTitle = fieldTitle;
+const fieldText = (field, language, key) => {
+    var _a, _b;
+    const i18n = ((_a = field.i18n) === null || _a === void 0 ? void 0 : _a[language]) || ((_b = field.i18n) === null || _b === void 0 ? void 0 : _b[languages_enum_1.Languages.EN]);
+    return (i18n === null || i18n === void 0 ? void 0 : i18n[key]) || '';
+};
+exports.fieldText = fieldText;
+const optionLabel = (option, language, fallback) => (0, exports.localized)(option.i18n, language) || fallback;
+exports.optionLabel = optionLabel;
+const MULTI_TYPES = [lead_field_type_enum_1.LeadFieldTypeEnum.CHECKBOX];
+const isMultiple = (type) => MULTI_TYPES.includes(type);
+exports.isMultiple = isMultiple;
+/**
+ * Поле скрыто, пока в управляющем поле не выбран нужный вариант. Скрытое
+ * поле не валидируется и не попадает в ответы — иначе обязательная
+ * «уточните какой квест» блокировала бы отправку у всех остальных.
+ */
+const isVisible = (field, values) => {
+    const condition = field.conditional;
+    if (!(condition === null || condition === void 0 ? void 0 : condition.fieldId))
+        return true;
+    const parentValue = values[condition.fieldId];
+    if (!condition.optionId) {
+        return Array.isArray(parentValue) ? parentValue.length > 0 : !!parentValue;
+    }
+    if (Array.isArray(parentValue))
+        return parentValue.includes(condition.optionId);
+    return parentValue === condition.optionId;
+};
+exports.isVisible = isVisible;
+const buildInitialValues = (form, prefill) => {
+    var _a;
+    const values = {};
+    for (const field of form.fields) {
+        const prefilled = field.mapsTo ? prefill === null || prefill === void 0 ? void 0 : prefill[field.mapsTo] : undefined;
+        if (prefilled !== undefined && prefilled !== '') {
+            values[field.id] = prefilled;
+            continue;
+        }
+        if (field.type === lead_field_type_enum_1.LeadFieldTypeEnum.CONSENT) {
+            values[field.id] = false;
+            continue;
+        }
+        if ((0, exports.isMultiple)(field.type)) {
+            values[field.id] = [];
+            continue;
+        }
+        // У степпера гостей всегда есть значение: пустое поле «сколько вас»
+        // клиент чаще пропускает, чем заполняет.
+        if (field.type === lead_field_type_enum_1.LeadFieldTypeEnum.GUESTS) {
+            values[field.id] = (_a = field.min) !== null && _a !== void 0 ? _a : 2;
+            continue;
+        }
+        values[field.id] = '';
+    }
+    return values;
+};
+exports.buildInitialValues = buildInitialValues;
+const isEmpty = (value) => {
+    if (Array.isArray(value))
+        return !value.length;
+    if (typeof value === 'boolean')
+        return !value;
+    if (typeof value === 'number')
+        return false;
+    return !(value === null || value === void 0 ? void 0 : value.trim());
+};
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
+/**
+ * Валидация на клиенте — это про удобство: сервер всё равно перепроверит
+ * обязательность и наличие канала связи. Возвращаем ошибки по id поля плюс
+ * общую ошибку формы.
+ */
+const validate = ({ form, values, phoneValid, t, }) => {
+    const errors = {};
+    let hasPhone = false;
+    let hasEmail = false;
+    for (const field of form.fields) {
+        if (!(0, exports.isVisible)(field, values))
+            continue;
+        const value = values[field.id];
+        const empty = isEmpty(value);
+        if (field.required && empty) {
+            errors[field.id] = t('lead.required');
+            continue;
+        }
+        if (empty)
+            continue;
+        if (field.type === lead_field_type_enum_1.LeadFieldTypeEnum.PHONE) {
+            if (!phoneValid) {
+                errors[field.id] = t('lead.invalidPhone');
+                continue;
+            }
+            hasPhone = true;
+        }
+        if (field.type === lead_field_type_enum_1.LeadFieldTypeEnum.EMAIL) {
+            if (!EMAIL_RE.test(String(value).trim())) {
+                errors[field.id] = t('lead.invalidEmail');
+                continue;
+            }
+            hasEmail = true;
+        }
+    }
+    // Заявку без телефона и почты обработать нельзя — бэкенд её отклонит,
+    // так что честнее сказать это до отправки.
+    const formError = !hasPhone && !hasEmail && !Object.keys(errors).length ? t('lead.needContact') : undefined;
+    return { errors, formError };
+};
+exports.validate = validate;
+/**
+ * `contextNote` — то, что клиент уже выбрал до формы (пакет, дата, гости).
+ * Дописываем его в комментарий, а не в отдельное поле: у формы площадки
+ * такого поля может не быть, а менеджеру этот контекст нужен в карточке.
+ */
+const buildAnswers = (form, values, contextNote) => {
+    const commentField = form.fields.find((field) => field.mapsTo === lead_field_mapping_enum_1.LeadFieldMappingEnum.COMMENT && (0, exports.isVisible)(field, values));
+    return form.fields
+        .filter((field) => (0, exports.isVisible)(field, values))
+        .map((field) => {
+        const value = normalizeValue(values[field.id]);
+        if (!contextNote || field.id !== (commentField === null || commentField === void 0 ? void 0 : commentField.id)) {
+            return { fieldId: field.id, value };
+        }
+        return {
+            fieldId: field.id,
+            value: value ? `${contextNote}\n${value}` : contextNote,
+        };
+    })
+        .filter((answer) => answer.value !== undefined);
+};
+exports.buildAnswers = buildAnswers;
+const normalizeValue = (value) => {
+    if (value === undefined || value === null)
+        return undefined;
+    if (Array.isArray(value))
+        return value.length ? value : undefined;
+    if (typeof value === 'string')
+        return value.trim() || undefined;
+    return value;
+};

package/dist/lead-form/use-lead-t.d.ts

@@ -0,0 +1,2 @@
+import { TOptions } from 'i18next';
+export declare const useLeadT: () => (key: string, options?: TOptions) => string;

package/dist/lead-form/use-lead-t.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useLeadT = void 0;
+const react_1 = require("react");
+const react_i18next_1 = require("react-i18next");
+/**
+ * Тексты формы заявки: часть приходит из настроек площадки (заголовок,
+ * подписи полей), но служебные строки — наши. Пока ключи не заведены в
+ * translations-сервисе, держим английские дефолты рядом с UI — ровно как
+ * в витрине пакетов (`use-package-t`).
+ */
+const DEFAULTS = {
+    'lead.title': 'Leave a request',
+    'lead.hint': 'Tell us what you need and we will call you back.',
+    'lead.submit': 'Send',
+    'lead.sending': 'Sending…',
+    'lead.successTitle': 'Thank you!',
+    'lead.successText': 'We have got your request and will contact you shortly.',
+    'lead.required': 'Please fill in this field',
+    'lead.invalidPhone': 'Enter a valid phone number',
+    'lead.invalidEmail': 'Enter a valid email',
+    'lead.needContact': 'Leave a phone number or an email so we can reach you',
+    'lead.failed': 'Failed to send the request, please try again',
+    'lead.tooManyRequests': 'Too many requests. Please try again later.',
+    'lead.unavailable': 'The request form is not available right now',
+    'lead.guestsMinus': 'One guest less',
+    'lead.guestsPlus': 'One guest more',
+    'lead.close': 'Close',
+    'lead.another': 'Send another request',
+    // Кнопка «оставить заявку» рядом с расписанием.
+    'lead.ctaTitle': 'Cannot find a suitable time?',
+    'lead.ctaHint': 'Leave a request and we will arrange the booking for you',
+    'lead.ctaButton': 'Leave a request',
+    // Та же кнопка в витрине сертификатов: про время говорить нельзя.
+    'lead.certCtaTitle': 'Need help with a gift?',
+    'lead.certCtaHint': 'Leave a request and we will pick a certificate for you',
+};
+const useLeadT = () => {
+    const { t } = (0, react_i18next_1.useTranslation)();
+    return (0, react_1.useCallback)((key, options) => { var _a; return t(key, Object.assign({ defaultValue: (_a = DEFAULTS[key]) !== null && _a !== void 0 ? _a : key }, options)); }, [t]);
+};
+exports.useLeadT = useLeadT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/hooks",
-  "version": "2.0.45",
+  "version": "2.0.46",
   "publishConfig": {
     "access": "public"
   },
@@ -14,9 +14,9 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/services": "^2.0.45",
-    "@escapenavigator/types": "^2.0.43",
-    "@escapenavigator/utils": "^2.0.45",
+    "@escapenavigator/services": "^2.0.46",
+    "@escapenavigator/types": "^2.0.44",
+    "@escapenavigator/utils": "^2.0.46",
     "libphonenumber-js": "^1.12.24",
     "react": "19.2.6",
     "react-phone-input-2": "^2.15.1"
@@ -32,5 +32,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "b5ab364dee021328bca9464dc4f9bd56774bcb52"
+  "gitHead": "1a84aa81dd428759ad51821e8095fd0b80b7cc62"
 }