@reformer/core 11.0.0-beta.5 → 11.0.0-beta.7

package/dist/validators.js

@@ -1,56 +1,52 @@
-import { required as z } from "./validators/required.js";
-import { min as y } from "./validators/min.js";
-import { max as b } from "./validators/max.js";
-import { minLength as L } from "./validators/min-length.js";
-import { maxLength as D } from "./validators/max-length.js";
-import { email as T } from "./validators/email.js";
-import { pattern as w } from "./validators/pattern.js";
-import { url as k } from "./validators/url.js";
-import { phone as B } from "./validators/phone.js";
-import { isNumber as Z } from "./validators/is-number.js";
-import { integer as G } from "./validators/integer.js";
-import { multipleOf as I } from "./validators/multiple-of.js";
-import { nonNegative as K } from "./validators/non-negative.js";
-import { nonZero as P } from "./validators/non-zero.js";
-import { isDate as R } from "./validators/is-date.js";
-import { minDate as V } from "./validators/min-date.js";
-import { maxDate as Y } from "./validators/max-date.js";
-import { pastDate as $ } from "./validators/past-date.js";
-import { futureDate as ee } from "./validators/future-date.js";
-import { minAge as ne } from "./validators/min-age.js";
-import { maxAge as ie } from "./validators/max-age.js";
+import { required as d } from "./validators/required.js";
+import { min as b } from "./validators/min.js";
+import { max as L } from "./validators/max.js";
+import { minLength as D } from "./validators/min-length.js";
+import { maxLength as T } from "./validators/max-length.js";
+import { email as w } from "./validators/email.js";
+import { pattern as k } from "./validators/pattern.js";
+import { url as B } from "./validators/url.js";
+import { phone as O } from "./validators/phone.js";
+import { isNumber as G } from "./validators/is-number.js";
+import { integer as I } from "./validators/integer.js";
+import { multipleOf as K } from "./validators/multiple-of.js";
+import { nonNegative as P } from "./validators/non-negative.js";
+import { nonZero as R } from "./validators/non-zero.js";
+import { isDate as V } from "./validators/is-date.js";
+import { minDate as Y } from "./validators/min-date.js";
+import { maxDate as $ } from "./validators/max-date.js";
+import { pastDate as ee } from "./validators/past-date.js";
+import { futureDate as ne } from "./validators/future-date.js";
+import { minAge as ie } from "./validators/min-age.js";
+import { maxAge as le } from "./validators/max-age.js";
+import { v as l } from "./validation-error-B-U3RsV0.js";
 function s(r) {
   if (typeof r != "object" || r === null) return !1;
   const t = r;
   return !(typeof t.name != "string" || t.size !== void 0 && typeof t.size != "number" || t.type !== void 0 && typeof t.type != "string");
 }
-function o(r) {
+function f(r) {
   return Array.isArray(r) ? r.filter(s) : s(r) ? [r] : null;
 }
-function u(r, t) {
-  const e = t.split(",").map((l) => l.trim().toLowerCase()).filter(Boolean);
+function m(r, t) {
+  const e = t.split(",").map((o) => o.trim().toLowerCase()).filter(Boolean);
   if (e.length === 0) return !0;
   const n = r.name.toLowerCase(), i = (r.type ?? "").toLowerCase();
-  return e.some((l) => l.startsWith(".") ? n.endsWith(l) : l.endsWith("/*") ? i.startsWith(l.slice(0, -1)) : l.includes("/") ? i === l : !1);
+  return e.some((o) => o.startsWith(".") ? n.endsWith(o) : o.endsWith("/*") ? i.startsWith(o.slice(0, -1)) : o.includes("/") ? i === o : !1);
 }
-function m(r, t) {
+function c(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
+    const n = f(e);
     if (n === null || n.length === 0) return null;
     for (const i of n)
       if (typeof i.size == "number" && i.size > r)
-        return {
-          code: "maxFileSize",
-          message: t?.message ?? "invalid",
-          params: {
-            maxFileSize: r,
-            fileName: i.name,
-            actualSize: i.size,
-            ...t?.params
-          }
-        };
+        return l("maxFileSize", t, {
+          maxFileSize: r,
+          fileName: i.name,
+          actualSize: i.size
+        });
     return null;
   };
 }
@@ -58,109 +54,91 @@ function a(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
+    const n = f(e);
     if (n === null || n.length === 0) return null;
     for (const i of n)
       if (typeof i.size == "number" && i.size < r)
-        return {
-          code: "minFileSize",
-          message: t?.message ?? "invalid",
-          params: {
-            minFileSize: r,
-            fileName: i.name,
-            actualSize: i.size,
-            ...t?.params
-          }
-        };
+        return l("minFileSize", t, {
+          minFileSize: r,
+          fileName: i.name,
+          actualSize: i.size
+        });
     return null;
   };
 }
-function p(r, t) {
+function x(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
+    const n = f(e);
     if (n === null || n.length === 0) return null;
     for (const i of n)
-      if (!u(i, r))
-        return {
-          code: "fileType",
-          message: t?.message ?? "invalid",
-          params: { accept: r, fileName: i.name, ...t?.params }
-        };
+      if (!m(i, r))
+        return l("fileType", t, { accept: r, fileName: i.name });
     return null;
   };
 }
-function c(r, t) {
+function g(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
-    return n === null || n.length === 0 ? null : n.length > r ? {
-      code: "maxFiles",
-      message: t?.message ?? "invalid",
-      params: { maxFiles: r, actualCount: n.length, ...t?.params }
-    } : null;
+    const n = f(e);
+    return n === null || n.length === 0 ? null : n.length > r ? l("maxFiles", t, { maxFiles: r, actualCount: n.length }) : null;
   };
 }
-function x(r, t) {
+function h(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
-    return n === null || n.length === 0 ? null : n.length < r ? {
-      code: "minFiles",
-      message: t?.message ?? "invalid",
-      params: { minFiles: r, actualCount: n.length, ...t?.params }
-    } : null;
+    const n = f(e);
+    return n === null || n.length === 0 ? null : n.length < r ? l("minFiles", t, { minFiles: r, actualCount: n.length }) : null;
   };
 }
-function g(r, t) {
+function z(r, t) {
   return (e) => {
     if (e == null || e === "")
       return null;
-    const n = o(e);
+    const n = f(e);
     if (n === null || n.length === 0) return null;
     const i = n.reduce(
-      (l, f) => l + (typeof f.size == "number" ? f.size : 0),
+      (o, u) => o + (typeof u.size == "number" ? u.size : 0),
       0
     );
-    return i > r ? {
-      code: "maxTotalFileSize",
-      message: t?.message ?? "invalid",
-      params: { maxTotalFileSize: r, actualTotal: i, ...t?.params }
-    } : null;
+    return i > r ? l("maxTotalFileSize", t, {
+      maxTotalFileSize: r,
+      actualTotal: i
+    }) : null;
   };
 }
 export {
-  T as email,
-  p as fileType,
-  ee as futureDate,
-  G as integer,
-  R as isDate,
+  w as email,
+  x as fileType,
+  ne as futureDate,
+  I as integer,
+  V as isDate,
   s as isFileLike,
-  Z as isNumber,
-  u as matchesFileAccept,
-  b as max,
-  ie as maxAge,
-  Y as maxDate,
-  m as maxFileSize,
-  c as maxFiles,
-  D as maxLength,
-  g as maxTotalFileSize,
-  y as min,
-  ne as minAge,
-  V as minDate,
+  G as isNumber,
+  m as matchesFileAccept,
+  L as max,
+  le as maxAge,
+  $ as maxDate,
+  c as maxFileSize,
+  g as maxFiles,
+  T as maxLength,
+  z as maxTotalFileSize,
+  b as min,
+  ie as minAge,
+  Y as minDate,
   a as minFileSize,
-  x as minFiles,
-  L as minLength,
-  I as multipleOf,
-  K as nonNegative,
-  P as nonZero,
-  $ as pastDate,
-  w as pattern,
-  B as phone,
-  z as required,
-  o as toFileArray,
-  k as url
+  h as minFiles,
+  D as minLength,
+  K as multipleOf,
+  P as nonNegative,
+  R as nonZero,
+  ee as pastDate,
+  k as pattern,
+  O as phone,
+  d as required,
+  f as toFileArray,
+  B as url
 };

package/docs/llms/02-quick-start.md

@@ -18,7 +18,7 @@
 import { createCoreForm, createModel, useFormBundle, type FormProxy } from '@reformer/core';
 import { defineValidationSchema, validate, validateModel } from '@reformer/core/validation';
 import { required, email } from '@reformer/core/validators';
-import { FormField, InputField, Button } from '@reformer/ui-kit';
+import { FormField, Input, Button } from '@reformer/ui-kit';
 
 // 1. Define form type as `type` alias (not `interface` — see Recipe 2)
 type ContactForm = {
@@ -34,12 +34,12 @@ const model = createModel<ContactForm>({ name: '', email: '' });
 const schema = {
   name: {
     value: model.$.name,
-    component: InputField,
+    component: Input,
     componentProps: { label: 'Name', placeholder: 'Your name' },
   },
   email: {
     value: model.$.email,
-    component: InputField,
+    component: Input,
     componentProps: { label: 'Email', type: 'email' },
   },
 };
@@ -113,14 +113,14 @@ const model = createModel<MyForm>({ properties: [] });
 const propertyItem = (item: FormModel<PropertyItem>) => ({
   type: {
     value: item.$.type,
-    component: SelectField,
+    component: SelectAsync,
     componentProps: { label: 'Тип', options: [/* ... */] },
   },
-  description: { value: item.$.description, component: TextareaField, componentProps: { label: 'Описание' } },
+  description: { value: item.$.description, component: Textarea, componentProps: { label: 'Описание' } },
   estimatedValue: {
     value: item.$.estimatedValue,
-    component: InputField,
-    componentProps: { label: 'Стоимость', type: 'number' },
+    component: InputNumber,
+    componentProps: { label: 'Стоимость' },
   },
 });
 

package/docs/llms/03-api-signatures.md

@@ -57,6 +57,12 @@ minAge(years: number, options?: { message?: string })
 maxAge(years: number, options?: { message?: string })
 ```
 
+Кроме `message`, каждое правило принимает `messageKey` (ключ словаря приложения) и `params`.
+Без `message` правило кладёт в ошибку пустую строку, а текст при отображении берётся из словаря
+локали по коду (`validation.<code>`): «Обязательное поле» под русской локалью, английская фраза без
+провайдера. Явное `message` важнее словаря, но языком не переключается; для локализуемого текста —
+`messageKey`. Подробно — [34-i18n.md](./34-i18n.md).
+
 Использование: layout-дерево `createForm` привязывает поля к сигналам, правила живут отдельной
 `ValidationSchema` и гоняются раннером `validateModel` по требованию.
 
@@ -65,16 +71,16 @@ import { createModel, createForm } from '@reformer/core';
 import { defineValidationSchema, validate, validateModel } from '@reformer/core/validation';
 import { required, min, max, email } from '@reformer/core/validators';
 
-type Loan = { email: string; age: number; amount: number };
-const model = createModel<Loan>({ email: '', age: 0, amount: 0 });
+type Loan = { email: string; age: number | null; amount: number | null };
+const model = createModel<Loan>({ email: '', age: null, amount: null });
 
 // layout-схема createForm НЕ несёт validators — только привязка поля к сигналу + компонент
 const form = createForm({
   model,
   schema: {
-    email:  { value: model.$.email,  component: InputField },
-    age:    { value: model.$.age,    component: InputField },
-    amount: { value: model.$.amount, component: InputField },
+    email:  { value: model.$.email,  component: Input },
+    age:    { value: model.$.age,    component: InputNumber },
+    amount: { value: model.$.amount, component: InputNumber },
   },
 });
 

package/docs/llms/05-common-mistakes.md

@@ -93,7 +93,7 @@ computeFrom([model.$.price, model.$.quantity], model.$.total, (price, qty) => pr
 ```typescript
 // ❌ WRONG - дерево { value, validators } и позиционная строка удалены
 const schema = {
-  email: { value: model.$.email, component: InputField, validators: [required(), email()] },
+  email: { value: model.$.email, component: Input, validators: [required(), email()] },
 };
 validate(path.email, required(), 'Email is required'); // старая сигнатура validate() — удалена
 

package/docs/llms/09-formschema.md

@@ -10,7 +10,7 @@ layout-схеме НЕТ — правила живут в отдельной с
 ```typescript
 {
   value: model.$.fieldName,   // сигнал модели (PathAwareSignal) — обязателен
-  component: InputField,           // React-компонент
+  component: Input,           // React-компонент
   componentProps?: object,    // пропсы (label, placeholder, options, type, ...)
   disabled?: boolean,
   updateOn?: 'change' | 'blur' | 'submit',
@@ -28,7 +28,7 @@ layout-схеме НЕТ — правила живут в отдельной с
 import { createModel, createForm } from '@reformer/core';
 import { defineValidationSchema, validate } from '@reformer/core/validation';
 import { required } from '@reformer/core/validators';
-import { InputField, SelectField, CheckboxField } from '@reformer/ui-kit';
+import { Input, InputNumber, SelectAsync, CheckboxWithLabel } from '@reformer/ui-kit';
 
 const model = createModel<MyForm>({ name: '', age: null, agree: false, status: 'active' });
 
@@ -40,22 +40,22 @@ const myValidation = defineValidationSchema<MyForm>(({ model }) => {
 const schema = {
   name: {
     value: model.$.name,
-    component: InputField,
+    component: Input,
     componentProps: { label: 'Name', placeholder: 'Enter name' },
   },
   age: {
     value: model.$.age,
-    component: InputField,
-    componentProps: { type: 'number', label: 'Age' },
+    component: InputNumber,
+    componentProps: { label: 'Age' },
   },
   agree: {
     value: model.$.agree,
-    component: CheckboxField,
+    component: CheckboxWithLabel,
     componentProps: { label: 'I agree to terms' },
   },
   status: {
     value: model.$.status,
-    component: SelectField,
+    component: SelectAsync,
     componentProps: {
       label: 'Status',
       options: [
@@ -79,9 +79,9 @@ const form = createForm<MyForm>({ model, schema });
 import type { FormModel } from '@reformer/core';
 
 const addressNodes = (m: FormModel<Address>) => ({
-  street: { value: m.$.street, component: InputField, componentProps: { label: 'Street' } },
-  city:   { value: m.$.city,   component: InputField, componentProps: { label: 'City' } },
-  zip:    { value: m.$.zip,    component: InputField, componentProps: { label: 'ZIP' } },
+  street: { value: m.$.street, component: Input, componentProps: { label: 'Street' } },
+  city:   { value: m.$.city,   component: Input, componentProps: { label: 'City' } },
+  zip:    { value: m.$.zip,    component: Input, componentProps: { label: 'ZIP' } },
 });
 
 const schema = {
@@ -98,8 +98,8 @@ const schema = {
 import type { FormModel } from '@reformer/core';
 
 const itemSchema = (item: FormModel<Item>) => ({
-  id:   { value: item.$.id,   component: InputField, componentProps: { label: 'ID' } },
-  name: { value: item.$.name, component: InputField, componentProps: { label: 'Name' } },
+  id:   { value: item.$.id,   component: Input, componentProps: { label: 'ID' } },
+  name: { value: item.$.name, component: Input, componentProps: { label: 'Name' } },
 });
 
 const schema = {

package/docs/llms/10-arrays.md

@@ -7,7 +7,7 @@
 
 ```typescript
 import { createModel, createForm, type FormModel } from '@reformer/core';
-import { InputField } from '@reformer/ui-kit';
+import { Input, InputNumber } from '@reformer/ui-kit';
 
 type Item = { id: string; name: string; price: number };
 type MyForm = { items: Item[] };
@@ -16,9 +16,9 @@ const model = createModel<MyForm>({ items: [] });
 
 // под-схема одного элемента (item.$.field — сигнал под-модели)
 const itemSchema = (item: FormModel<Item>) => ({
-  id:    { value: item.$.id,    component: InputField },
-  name:  { value: item.$.name,  component: InputField },
-  price: { value: item.$.price, component: InputField, componentProps: { type: 'number' } },
+  id:    { value: item.$.id,    component: Input },
+  name:  { value: item.$.name,  component: Input },
+  price: { value: item.$.price, component: InputNumber },
 });
 
 const schema = {
@@ -32,6 +32,36 @@ const form = createForm<MyForm>({ model, schema });
 > он не совместим с `Record<string, FormValue>` и `ArrayNode<Item>` его отвергнет.
 > См. `30-type-safety-recipes.md`.
 
+### Массив как ОДНО значение поля
+
+Массив бывает не набором под-форм, а одним значением: мультивыбор, теги, список файлов. Чем он
+является, решает **схема**, а не данные: `{ array, item }` — набор под-форм, а узел поля
+`{ value: model.$.<путь>, component }` — одно значение. Массив, к которому в схеме ничего не
+привязано, в форму не попадает.
+
+```typescript
+type MyForm = { tags: string[] };
+
+const model = createModel<MyForm>({ tags: [] });
+
+const schema = {
+  tags: { value: model.$.tags, component: SelectMulti }, // поле над массивом целиком
+};
+const form = createForm<MyForm>({ model, schema });
+
+form.tags.setValue(['a', 'b']); // FieldNode<string[]>
+model.$.tags.value = ['c']; // ручка значения: заменяет массив целиком
+validate(model.$.tags, [required(), maxLength(3)]); // правило получает массив
+```
+
+- `model.$.<массив>` — записываемая ручка значения (`PathAwareSignal`): подходит для `value:` в
+  схеме, `validate`/`cross`, `enableWhen`/`copyFrom` и для `model.signalAt(path)`.
+- Узел-массив хранит только массив: запись `null`/`undefined` даёт `[]`. Нужно отличать «не
+  выбирали» от «выбрали ничего» — объявляй поле `T[] | null` с начальным `null`: в рантайме это
+  лист, и привязывается он так же.
+- Запись в узел-ГРУППУ (`model.$.<группа>.value = …`) — ошибка: группа пишется по полям или через
+  `model.patch(...)`.
+
 ### Один массив — три слоя (три разных движка)
 
 Одна и та же коллекция описывается **тремя разными формами** — по одной на движок. Их легко

package/docs/llms/14-extended-mistakes.md

@@ -71,7 +71,7 @@ import { revalidateWhen, type ValidationError } from '@reformer/core';
 // ❌ старое (УДАЛЕНО): дерево { value, validators }, ModelValidator (value, scope, root), validateFormModel
 const legacyRule: ModelValidator<number, unknown, Form> = (_value, _scope, root) =>
   root.field1 > root.field2 ? { code: 'error', message: 'Invalid' } : null;
-const legacySchema = { field1: { value: model.$.field1, component: InputField, validators: [legacyRule] } };
+const legacySchema = { field1: { value: model.$.field1, component: Input, validators: [legacyRule] } };
 validateFormModel(model, legacySchema);
 
 // ✅ новое: cross-правило — обычная функция над снапшотом (model.get()), не читает scope/root

package/docs/llms/15-project-structure.md

@@ -2,11 +2,13 @@
 
 One form is one module folder. **Default layout — flat minimalist:** every concern is a single
 file at the module root, and the whole form (entry + all wizard steps inline) lives in one
-`index.tsx`. Filenames are flat with no prefix — **the dot-prefix (`form.` / `renderer.`) is
-carried only by `schema` and `behavior`**, the two concerns that have both a model-layer and a
-render-layer version (`form.schema.ts` / `form.behavior.ts` here; renderer slices add
-`renderer.schema.*` / `renderer.behavior.ts`). No `lib/` / `schema/` / `components/steps/`
-nesting until the form grows (see "Scaling up" below). Arrays are declared in `form.schema.ts`
+`index.tsx`. Naming rule: **`form.<role>` is a form artefact, the suffix names its role** —
+`form.schema.*` (layout), `form.behavior.ts` (model behavior), `form.render.ts` (render-layer
+behavior, renderer targets only), `form.validation.ts` (validation rules); every other file has
+no prefix. A wizard may instead keep each
+step's code in `steps/<slug>/` (same file names inside) with a `steps/index.ts` aggregator. The old
+`renderer.schema.*` / `renderer.behavior.ts` / `renderer.wizard.tsx` / `validation.ts` names still
+work with a warning. No `lib/` / `schema/` / `components/` nesting until the form grows (see "Scaling up" below). Arrays are declared in `form.schema.ts`
 and rendered with `FormArraySection` — no per-step component files.
 
 ```
@@ -20,13 +22,13 @@ src/
 │       ├── model.ts              # createModel + initial values + empty-array-element factories
 │       ├── form.schema.ts        # FormSchema: { value: model.$.x, component, componentProps }
 │       ├── form.behavior.ts      # defineFormBehavior: compute / enableWhen / hideWhen / copyFrom / onChange
-│       ├── validation.ts         # ALL validation → { validateStep, validateAll }
+│       ├── form.validation.ts    # ALL validation → { validateStep, validateAll }
 │       ├── data-sources.ts       # options + async loaders (dataSources)
 │       └── api.ts                # submit + prefill/load
 ```
 
 Rule of thumb: **one concern → one file at the module root; the whole component tree (all steps) →
-`index.tsx`; validation is a single `validation.ts`.** This is the working default for
+`index.tsx`; validation is a single `form.validation.ts`.** This is the working default for
 almost every form — reach for folders only when a file stops fitting on a screen.
 
 ### Key Files
@@ -47,7 +49,7 @@ export const createCreditApplicationModel = (): FormModel<CreditApplicationForm>
 // forms/credit-application/form.schema.ts
 import type { FormModel } from '@reformer/core';
 export const creditApplicationSchema = (model: FormModel<CreditApplicationForm>) => ({
-  loanType: { value: model.$.loanType, component: SelectField, componentProps: { /* ... */ } },
+  loanType: { value: model.$.loanType, component: SelectAsync, componentProps: { /* ... */ } },
   personalData: personalDataNodes(model.$.personalData),
   properties: { array: model.properties, item: propertyItem },
 });
@@ -95,7 +97,7 @@ forms/
     ├── schema/                   # The form definition
     │   ├── model.ts             # createModel factory + initial values + array-element factories
     │   ├── form.schema.ts       # schema builder (model) => tree ({ value: model.$.x, component })
-    │   ├── validation.ts        # defineValidationSchema + validateModel config ({ validateStep, validateAll })
+    │   ├── form.validation.ts   # defineValidationSchema + validateModel config ({ validateStep, validateAll })
     │   ├── form.behavior.ts     # defineFormBehavior(...)
     │   └── create-form.ts       # Assembly: createCoreForm({ model, schema, behavior, validation })
     │
@@ -107,7 +109,7 @@ forms/
 
 Rule of thumb for this layout: **domain raw material → `lib/`; anything describing the form →
 `schema/`; React layout → `components/`; root = entry + `index.ts`.** In very large forms you
-may co-locate each step's `form.schema.ts` / `validation.ts` / `form.behavior.ts` inside its
+may co-locate each step's `form.schema.ts` / `form.validation.ts` / `form.behavior.ts` inside its
 `steps/[Step]/` folder, keeping only the shared `model` and cross-step rules in `schema/` — see
 the guide below.
 
@@ -123,8 +125,8 @@ the guide below.
 > when registering the MCP server to choose which structure the generators lead with. Default
 > is `minimalist`.
 
-> Cross-target variants (renderer-react `renderer.schema.ts` + `renderer.behavior.ts` /
-> renderer-json `renderer.schema.ts` + `renderer.behavior.ts` + `registry.ts`, plus an optional
-> `renderer.wizard.tsx` shim), the `.tsx` / `.json` schema variants, the centralized-vs-co-located
+> Cross-target variants (renderer-react `form.schema.ts` + `form.render.ts` /
+> renderer-json `form.schema.ts` + `form.render.ts` + `registry.ts`, plus an optional
+> `wizard.tsx` shim), the `.tsx` / `.json` schema variants, the centralized-vs-co-located
 > choice, and the full reuse map live in the **form-directory-layout** guide (`@reformer/mcp`) —
 > `find_recipe directory-layout`.