@reformer/core 1.1.0-beta.6 → 1.1.0-beta.8

package/dist/core/behavior/behaviors/compute-from.js

@@ -1,84 +0,0 @@
-/**
- * Вычисляемые поля
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/computeFrom
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Автоматически вычисляет значение поля на основе других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param sources - Массив полей-зависимостей
- * @param target - Поле для записи результата
- * @param computeFn - Функция вычисления (принимает объект с именами полей)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Автоматический расчет минимального взноса
- *   computeFrom(
- *     [path.propertyValue],
- *     path.initialPayment,
- *     (values) => values.propertyValue ? values.propertyValue * 0.2 : null,
- *     { debounce: 300 }
- *   );
- *
- *   // Общая стоимость = цена * количество
- *   computeFrom(
- *     [path.price, path.quantity],
- *     path.total,
- *     (values) => values.price * values.quantity
- *   );
- * };
- * ```
- */
-export function computeFrom(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-sources, target, computeFn, options) {
-    const { debounce, condition } = options || {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(target.__path);
-        if (!targetNode)
-            return null;
-        // Разрешаем source узлы
-        const sourceNodes = sources
-            .map((field) => form.getFieldByPath(field.__path))
-            .filter((node) => node !== undefined);
-        if (sourceNodes.length === 0)
-            return null;
-        return effect(() => {
-            // Читаем значения всех source полей
-            const sourceValues = sourceNodes.map((node) => node.value.value);
-            withDebounce(() => {
-                // Проверка условия
-                if (condition) {
-                    const formValue = form.getValue();
-                    if (!condition(formValue))
-                        return;
-                }
-                // Создаем объект с именами полей для computeFn
-                // computeFn ожидает объект вида { fieldName: value, ... }
-                const sourceValuesObject = {};
-                sources.forEach((source, index) => {
-                    // Извлекаем имя поля из пути (последний сегмент)
-                    const fieldName = source.__path.split('.').pop() || source.__path;
-                    sourceValuesObject[fieldName] = sourceValues[index];
-                });
-                // Вычисляем новое значение
-                const computedValue = computeFn(sourceValuesObject);
-                // Устанавливаем значение без триггера событий
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                targetNode.setValue(computedValue, { emitEvent: false });
-            });
-        });
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}

package/dist/core/behavior/behaviors/copy-from.js

@@ -1,64 +0,0 @@
-/**
- * Копирование значений между полями
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/copyFrom
- */
-import { watchField } from './watch-field';
-/**
- * Копирует значения из одного поля/группы в другое при выполнении условия
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param source - Откуда копировать
- * @param target - Куда копировать
- * @param options - Опции копирования
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Копировать адрес регистрации в адрес проживания
- *   copyFrom(path.registrationAddress, path.residenceAddress, {
- *     when: (form) => form.sameAsRegistration === true,
- *     fields: 'all'
- *   });
- * };
- * ```
- */
-export function copyFrom(source, target, options) {
-    const { when, fields = 'all', transform, debounce } = options || {};
-    watchField(source, (sourceValue, ctx) => {
-        // Проверка условия
-        if (when) {
-            const formValue = ctx.form.getValue();
-            if (!when(formValue))
-                return;
-        }
-        // Трансформация значения
-        const value = transform ? transform(sourceValue) : sourceValue;
-        // Получаем target node
-        const targetNode = ctx.form.getFieldByPath(target.__path);
-        if (!targetNode)
-            return;
-        // Копирование
-        if (fields === 'all' || !fields) {
-            targetNode.setValue(value, { emitEvent: false });
-        }
-        else {
-            // Частичное копирование для групп
-            const patch = {};
-            fields.forEach((key) => {
-                if (sourceValue && typeof sourceValue === 'object') {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    patch[key] = sourceValue[key];
-                }
-            });
-            if ('patchValue' in targetNode) {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                targetNode.patchValue(patch);
-            }
-        }
-    }, { debounce });
-}

package/dist/core/behavior/behaviors/enable-when.js

@@ -1,81 +0,0 @@
-/**
- * Условное включение/отключение полей
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/enableWhen
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Условное включение поля на основе значений других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для включения/выключения
- * @param condition - Функция условия (true = enable, false = disable)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Включить поле только для ипотеки
- *   enableWhen(path.propertyValue, (form) => form.loanType === 'mortgage', {
- *     resetOnDisable: true
- *   });
- * };
- * ```
- */
-export function enableWhen(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-field, condition, options) {
-    const { debounce, resetOnDisable = false } = options || {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(field.__path);
-        if (!targetNode)
-            return null;
-        return effect(() => {
-            const formValue = form.value.value;
-            withDebounce(() => {
-                const shouldEnable = condition(formValue);
-                if (shouldEnable) {
-                    targetNode.enable();
-                }
-                else {
-                    targetNode.disable();
-                    if (resetOnDisable) {
-                        targetNode.reset();
-                    }
-                }
-            });
-        });
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}
-/**
- * Условное выключение поля (инверсия enableWhen)
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для выключения
- * @param condition - Функция условия (true = disable, false = enable)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Выключить поле для потребительского кредита
- *   disableWhen(path.propertyValue, (form) => form.loanType === 'consumer');
- * };
- * ```
- */
-export function disableWhen(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-field, condition, options) {
-    // Инвертируем условие
-    enableWhen(field, (form) => !condition(form), options);
-}

package/dist/core/behavior/behaviors/index.js

@@ -1,11 +0,0 @@
-/**
- * Behavior rules
- */
-export { copyFrom } from './copy-from';
-export { enableWhen, disableWhen } from './enable-when';
-export { computeFrom } from './compute-from';
-export { watchField } from './watch-field';
-export { revalidateWhen } from './revalidate-when';
-export { syncFields } from './sync-fields';
-export { resetWhen } from './reset-when';
-export { transformValue, createTransformer, transformers, } from './transform-value';

package/dist/core/behavior/behaviors/reset-when.js

@@ -1,63 +0,0 @@
-/**
- * Условный сброс полей
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/resetWhen
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Условный сброс поля при выполнении условия
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для сброса
- * @param condition - Функция условия (true = reset)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Сбросить поле при изменении типа кредита
- *   resetWhen(path.propertyValue, (form) => form.loanType !== 'mortgage');
- *
- *   // Сбросить с кастомным значением
- *   resetWhen(path.initialPayment, (form) => !form.propertyValue, {
- *     resetValue: 0
- *   });
- *
- *   // Сбросить только если поле было изменено пользователем
- *   resetWhen(path.carPrice, (form) => form.loanType !== 'car', {
- *     onlyIfDirty: true
- *   });
- * };
- * ```
- */
-export function resetWhen(field, condition, options) {
-    const { debounce, resetValue = null, onlyIfDirty = false } = options || {};
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(field.__path);
-        if (!targetNode)
-            return null;
-        return effect(() => {
-            const formValue = form.value.value;
-            withDebounce(() => {
-                const shouldReset = condition(formValue);
-                if (shouldReset) {
-                    // Проверяем onlyIfDirty опцию
-                    if (onlyIfDirty && !targetNode.dirty.value) {
-                        return;
-                    }
-                    // Сбрасываем значение
-                    targetNode.setValue(resetValue);
-                    // Сбрасываем флаги dirty и touched
-                    targetNode.markAsPristine();
-                    targetNode.markAsUntouched();
-                }
-            });
-        });
-    };
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}

package/dist/core/behavior/behaviors/revalidate-when.js

@@ -1,51 +0,0 @@
-/**
- * Перевалидация полей при изменениях
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/revalidateWhen
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Перевалидирует поле при изменении других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param target - Поле для перевалидации
- * @param triggers - Поля-триггеры
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Перевалидировать initialPayment при изменении propertyValue
- *   revalidateWhen(path.initialPayment, [path.propertyValue], {
- *     debounce: 300
- *   });
- * };
- * ```
- */
-export function revalidateWhen(target, triggers, options) {
-    const { debounce } = options || {};
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(target.__path);
-        if (!targetNode)
-            return null;
-        const sourceNodes = triggers
-            .map((field) => form.getFieldByPath(field.__path))
-            .filter((node) => node !== undefined);
-        if (sourceNodes.length === 0)
-            return null;
-        return effect(() => {
-            // Отслеживаем изменения source полей
-            sourceNodes.forEach((node) => node.value.value);
-            withDebounce(() => {
-                // Перезапускаем валидацию target поля
-                targetNode.validate();
-            });
-        });
-    };
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}

package/dist/core/behavior/behaviors/sync-fields.js

@@ -1,66 +0,0 @@
-/**
- * Двусторонняя синхронизация полей
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/syncFields
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Двусторонняя синхронизация двух полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field1 - Первое поле
- * @param field2 - Второе поле
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Синхронизировать два поля
- *   syncFields(path.email, path.emailCopy);
- * };
- * ```
- */
-export function syncFields(field1, field2, options) {
-    const { debounce, transform } = options || {};
-    const handler = (form, _context, withDebounce) => {
-        const sourceNode = form.getFieldByPath(field1.__path);
-        const targetNode = form.getFieldByPath(field2.__path);
-        if (!sourceNode || !targetNode)
-            return null;
-        // Флаг для предотвращения циклических обновлений
-        let isUpdating = false;
-        const dispose1 = effect(() => {
-            const sourceValue = sourceNode.value.value;
-            if (isUpdating)
-                return;
-            withDebounce(() => {
-                isUpdating = true;
-                const finalValue = transform ? transform(sourceValue) : sourceValue;
-                targetNode.setValue(finalValue, { emitEvent: false });
-                isUpdating = false;
-            });
-        });
-        const dispose2 = effect(() => {
-            const targetValue = targetNode.value.value;
-            if (isUpdating)
-                return;
-            withDebounce(() => {
-                isUpdating = true;
-                // Обратная синхронизация (без трансформации)
-                sourceNode.setValue(targetValue, { emitEvent: false });
-                isUpdating = false;
-            });
-        });
-        // Возвращаем комбинированный cleanup
-        return () => {
-            dispose1();
-            dispose2();
-        };
-    };
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}

package/dist/core/behavior/behaviors/transform-value.js

@@ -1,110 +0,0 @@
-/**
- * Трансформация значений полей
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/transformValue
- */
-import { watchField } from './watch-field';
-/**
- * Трансформация значения поля при изменении
- * Позволяет автоматически форматировать или преобразовывать значения
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для трансформации
- * @param transformer - Функция трансформации
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Автоматически переводить текст в верхний регистр
- *   transformValue(path.code, (value) => value?.toUpperCase());
- *
- *   // Форматировать номер телефона
- *   transformValue(path.phone, (value) => {
- *     if (!value) return value;
- *     const digits = value.replace(/\D/g, '');
- *     if (digits.length === 11) {
- *       return `+7 (${digits.slice(1, 4)}) ${digits.slice(4, 7)}-${digits.slice(7, 9)}-${digits.slice(9)}`;
- *     }
- *     return value;
- *   });
- *
- *   // Удалять пробелы из email
- *   transformValue(path.email, (value) => value?.trim().toLowerCase());
- *
- *   // Округлять числа
- *   transformValue(path.amount, (value) => {
- *     return typeof value === 'number' ? Math.round(value) : value;
- *   });
- * };
- * ```
- */
-export function transformValue(field, transformer, options) {
-    const { onUserChangeOnly = false, emitEvent = true, debounce } = options || {};
-    watchField(field, (currentValue, ctx) => {
-        const targetNode = ctx.form.getFieldByPath(field.__path);
-        if (!targetNode)
-            return;
-        // Если нужно трансформировать только при изменении пользователем
-        if (onUserChangeOnly && !targetNode.touched.value) {
-            return;
-        }
-        const transformedValue = transformer(currentValue);
-        // Применяем трансформацию только если значение изменилось
-        if (transformedValue !== currentValue) {
-            targetNode.setValue(transformedValue, { emitEvent });
-        }
-    }, { debounce });
-}
-/**
- * Хелпер для создания переиспользуемых трансформаций
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @example
- * ```typescript
- * // Создаем переиспользуемые трансформеры
- * const toUpperCase = createTransformer<string>((value) => value?.toUpperCase());
- * const toLowerCase = createTransformer<string>((value) => value?.toLowerCase());
- * const trim = createTransformer<string>((value) => value?.trim());
- *
- * // Используем в форме
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   toUpperCase(path.code);
- *   toLowerCase(path.email);
- *   trim(path.username);
- * };
- * ```
- */
-export function createTransformer(transformer, defaultOptions) {
-    return (field, options) => {
-        transformValue(field, transformer, { ...defaultOptions, ...options });
-    };
-}
-/**
- * Готовые трансформеры для частых случаев
- *
- * @group Behaviors
- * @category Behavior Rules
- */
-export const transformers = {
-    /** Перевести в верхний регистр */
-    toUpperCase: createTransformer((value) => value?.toUpperCase()),
-    /** Перевести в нижний регистр */
-    toLowerCase: createTransformer((value) => value?.toLowerCase()),
-    /** Удалить пробелы с краев */
-    trim: createTransformer((value) => value?.trim()),
-    /** Удалить все пробелы */
-    removeSpaces: createTransformer((value) => value?.replace(/\s/g, '')),
-    /** Оставить только цифры */
-    digitsOnly: createTransformer((value) => value?.replace(/\D/g, '')),
-    /** Округлить число */
-    round: createTransformer((value) => typeof value === 'number' ? Math.round(value) : value),
-    /** Округлить до 2 знаков после запятой */
-    roundTo2: createTransformer((value) => typeof value === 'number' ? Math.round(value * 100) / 100 : value),
-};

package/dist/core/behavior/behaviors/watch-field.js

@@ -1,56 +0,0 @@
-/**
- * Отслеживание изменений поля
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/watchField
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Выполняет callback при изменении поля
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для отслеживания
- * @param callback - Функция обратного вызова
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Динамическая загрузка городов при изменении страны
- *   watchField(path.registrationAddress.country, async (country, ctx) => {
- *     if (country) {
- *       const cities = await fetchCities(country);
- *       ctx.updateComponentProps(path.registrationAddress.city, {
- *         options: cities
- *       });
- *     }
- *   });
- * };
- * ```
- */
-export function watchField(field, callback, options) {
-    const { debounce, immediate = false } = options || {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = (form, context, withDebounce) => {
-        const node = form.getFieldByPath(field.__path);
-        if (!node)
-            return null;
-        // Вызвать сразу если immediate: true
-        if (immediate) {
-            const value = node.value.value;
-            callback(value, context);
-        }
-        return effect(() => {
-            const value = node.value.value;
-            withDebounce(() => {
-                callback(value, context);
-            });
-        });
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}