@reformer/core 1.1.0 → 2.0.0-beta.3

package/dist/hooks/useFormControlValue.d.ts

@@ -0,0 +1,167 @@
+import type { FieldNode } from '../core/nodes/field-node';
+import type { FormValue } from '../core/types';
+/**
+ * React-хук для подписки только на значение поля.
+ *
+ * Оптимизированная версия {@link useFormControl}, которая подписывается
+ * только на сигнал `value`. Компонент не будет ре-рендериться при изменении
+ * `errors`, `touched`, `valid` и других свойств состояния.
+ *
+ * ## Когда использовать
+ *
+ * - **Условный рендеринг** на основе значения другого поля
+ * - **Вычисляемые значения** зависящие от значения поля
+ * - **Read-only отображение** значения без интерактивности
+ * - **Оптимизация производительности** когда не нужны другие свойства состояния
+ *
+ * ## Когда НЕ использовать
+ *
+ * Если компоненту нужны `errors`, `touched`, `disabled` или другие свойства -
+ * используйте {@link useFormControl}. Множественные подписки на один контрол
+ * через разные хуки менее эффективны, чем одна подписка через `useFormControl`.
+ *
+ * @typeParam T - Тип значения поля
+ * @param control - FieldNode для подписки на значение
+ * @returns Текущее значение поля
+ *
+ * @example Условный рендеринг секции
+ * ```tsx
+ * import { useFormControlValue } from '@reformer/core';
+ *
+ * interface FormFields {
+ *   hasShipping: FieldNode<boolean>;
+ *   shippingAddress: GroupNode<AddressFields>;
+ * }
+ *
+ * function ShippingSection({ form }: { form: FormFields }) {
+ *   // Подписка только на значение checkbox
+ *   const hasShipping = useFormControlValue(form.hasShipping);
+ *
+ *   if (!hasShipping) {
+ *     return null;
+ *   }
+ *
+ *   return (
+ *     <div className="shipping-section">
+ *       <h3>Shipping Address</h3>
+ *       <AddressForm control={form.shippingAddress} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example Динамические опции на основе другого поля
+ * ```tsx
+ * interface FormFields {
+ *   country: FieldNode<string>;
+ *   city: FieldNode<string>;
+ * }
+ *
+ * function CitySelect({ form }: { form: FormFields }) {
+ *   const country = useFormControlValue(form.country);
+ *   const { value, disabled } = useFormControl(form.city);
+ *
+ *   // Получаем города для выбранной страны
+ *   const cities = useMemo(() => getCitiesForCountry(country), [country]);
+ *
+ *   // Сбрасываем город при смене страны
+ *   useEffect(() => {
+ *     form.city.setValue('');
+ *   }, [country, form.city]);
+ *
+ *   return (
+ *     <select
+ *       value={value}
+ *       disabled={disabled || !country}
+ *       onChange={e => form.city.setValue(e.target.value)}
+ *     >
+ *       <option value="">Select city...</option>
+ *       {cities.map(city => (
+ *         <option key={city.id} value={city.id}>{city.name}</option>
+ *       ))}
+ *     </select>
+ *   );
+ * }
+ * ```
+ *
+ * @example Отображение суммы в реальном времени
+ * ```tsx
+ * interface OrderItem {
+ *   quantity: FieldNode<number>;
+ *   price: FieldNode<number>;
+ * }
+ *
+ * function OrderTotal({ items }: { items: ArrayNode<OrderItem> }) {
+ *   // Для каждого элемента получаем только значения
+ *   const quantities = items.map(item => useFormControlValue(item.controls.quantity));
+ *   const prices = items.map(item => useFormControlValue(item.controls.price));
+ *
+ *   const total = quantities.reduce((sum, qty, i) => sum + qty * prices[i], 0);
+ *
+ *   return (
+ *     <div className="order-total">
+ *       <strong>Total: ${total.toFixed(2)}</strong>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example Preview значения
+ * ```tsx
+ * interface MarkdownEditorProps {
+ *   control: FieldNode<string>;
+ * }
+ *
+ * function MarkdownPreview({ control }: MarkdownEditorProps) {
+ *   // Подписка только на значение для preview
+ *   const markdown = useFormControlValue(control);
+ *
+ *   const html = useMemo(() => marked(markdown), [markdown]);
+ *
+ *   return (
+ *     <div
+ *       className="markdown-preview"
+ *       dangerouslySetInnerHTML={{ __html: html }}
+ *     />
+ *   );
+ * }
+ *
+ * // Основной редактор использует useFormControl для полного состояния
+ * function MarkdownEditor({ control }: MarkdownEditorProps) {
+ *   const { value, shouldShowError, errors } = useFormControl(control);
+ *
+ *   return (
+ *     <div className="editor-container">
+ *       <textarea
+ *         value={value}
+ *         onChange={e => control.setValue(e.target.value)}
+ *       />
+ *       {shouldShowError && <span className="error">{errors[0]?.message}</span>}
+ *
+ *       {/* Preview обновляется только при изменении value *}
+ *       <MarkdownPreview control={control} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @example Счётчик символов
+ * ```tsx
+ * function CharacterCounter({ control, max }: { control: FieldNode<string>; max: number }) {
+ *   const value = useFormControlValue(control);
+ *   const remaining = max - value.length;
+ *
+ *   return (
+ *     <span className={remaining < 20 ? 'warning' : ''}>
+ *       {remaining} characters remaining
+ *     </span>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link useFormControl} - для полного состояния поля
+ * @see {@link FieldNode} - тип контрола поля
+ *
+ * @group React Hooks
+ */
+export declare function useFormControlValue<T extends FormValue>(control: FieldNode<T>): T;

package/dist/hooks/useSignalSubscription.d.ts

@@ -0,0 +1,17 @@
+import { type Signal } from '@preact/signals-core';
+/** @internal */
+export type SignalMap = Record<string, Signal<unknown>>;
+/** @internal */
+export type ExtractSignalValues<T extends SignalMap> = {
+    [K in keyof T]: T[K] extends Signal<infer V> ? V : never;
+};
+/** @internal */
+export interface SignalConfig<K extends string> {
+    key: K;
+    useShallowArrayEqual?: boolean;
+}
+/**
+ * Хук для подписки на набор сигналов с кешированием
+ * @internal
+ */
+export declare function useSignalSubscription<TSignals extends SignalMap, TSnapshot extends ExtractSignalValues<TSignals>>(signals: TSignals, configs: SignalConfig<Extract<keyof TSignals, string>>[], buildSnapshot: (values: ExtractSignalValues<TSignals>) => TSnapshot): TSnapshot;

package/dist/index.d.ts

@@ -6,5 +6,10 @@ export { FieldNode } from './core/nodes/field-node';
 export { GroupNode } from './core/nodes/group-node';
 export { ArrayNode } from './core/nodes/array-node';
 export type { SetValueOptions } from './core/nodes/form-node';
-export { useFormControl, useFormControlValue } from './hooks/useFormControl';
+export { useFormControl } from './hooks/useFormControl';
+export { useFormControlValue } from './hooks/useFormControlValue';
+export type { FieldControlState, ArrayControlState } from './hooks/types';
 export type { BehaviorSchemaFn } from './core/behavior/types';
+export { validateForm } from './core/validation/validate-form';
+export * as behaviors from './core/behavior';
+export * as validators from './core/validation';