adaptform 2.0.5 → 2.2.0

package/CHANGELOG.md

@@ -1,6 +1,155 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+[English](CHANGELOG.md) · [Русский](CHANGELOG.ru.md)
+
+All notable changes to AdaptForm are documented here. Version `2.1.0` was published to npm on 2026-10-14.
+
+**[Interactive demo](https://arhimen.github.io/AdaptForm/)** · [Demo source](https://github.com/ArhiMEN/AdaptForm/tree/master/demo) · [Documentation](https://github.com/ArhiMEN/AdaptForm/blob/master/README.md)
+
+## [2.2.0] - Unreleased (source prepared)
+
+### Added — headless form state foundation
+
+- **HF-005:** Specify the field/form lifecycle, cleaned baselines, touched-vs-dirty semantics, snapshots, synchronous batches and compatibility rules in English and Russian. ([state contract](docs/ai/HEADLESS_STATE_CONTRACT.md))
+- **HF-006:** Track cleaned initial values with `Field.isDirty` and `commitBaseline()`, including semantic comparisons of Dates, optional Luxon values, plugin-cleaned values and supported nested structures.
+- **HF-007:** Expose derived `isDirty` and baseline commits on `Form`, `ArrayField` and `ArrayFormField`, including collection membership, order and nested values.
+- **HF-008:** Add `subscribe(listener)`, idempotent unsubscribe, stable immutable `getSnapshot()` and publicly exported `SnapshotValue`, `NodeSnapshot`, `FieldSnapshot`, `FormSnapshot`, `ArrayFieldSnapshot`, `ArrayFormSnapshot` types; no required UI framework or runtime dependencies.
+- **HF-009:** Add synchronous nested `Form.batch(callback)` with coalesced notifications, deferred automatic validation using final parent context and deterministic exception finalization. Completed writes are **not rolled back**.
+- **HF-010:** Propagate changes from children, nested forms and collections to parents; reconcile subscriptions when nodes are removed or replaced and release ownership links when observers leave. ([PR #16](https://github.com/ArhiMEN/AdaptForm/pull/16))
+
+### Fixed
+
+- `ArrayField.remove()/clear()` and `ArrayFormField.remove()/clear()` now defer automatic validation inside `Form.batch()`, while retaining synchronous checks outside a batch and immediate explicit `checkValid()`. Added 34 specific regressions.
+- `Form.allErrors` copies child error arrays rather than mutating or freezing live arrays when global errors and immutable snapshots are combined.
+
+### Compatibility and constraints
+
+- Existing class-based APIs, synchronous validation outside batches, `isTouched`, `isValid`, `reset()` behavior (including existing collection membership), serialization and the optional `adaptform/luxon` entry point are preserved.
+- `commitBaseline()` changes the dirty-comparison reference, **not** the target of `reset()`; after committing a different baseline, reset can leave `isDirty=true`.
+- Snapshots are detached immutable data descriptions, not original mutable objects; custom instances may be opaque. Direct in-place changes to exposed legacy arrays/options and arbitrary Form-property replacement are not automatically observed.
+- No `reinitialize()`, HF-004 collection-reset redesign, HF-011+ dependency graph, async validation, submission lifecycle, UI adapter or performance benchmark is included.
+
+### Verification and release status
+
+- Accepted integration PR [#16](https://github.com/ArhiMEN/AdaptForm/pull/16) passed **563 tests in 27 files**, lint, source/demo type-checks, package/demo builds and dependency audit (0 known vulnerabilities). Independent review and [documentation sync PR #17](https://github.com/ArhiMEN/AdaptForm/pull/17) were merged. The 2.2.0 release candidate requires its **own** successful CI.
+- The separate `tsconfig.test.json` check still has **54 existing diagnostics** and is not reported as passing; an older mapped-type `TS2589` reproduces on 2.1.1 as well. No new diagnostics were established in HF-005–HF-010.
+- **Not published.** The source/manifest is being prepared as `2.2.0`; do not interpret this entry or a GitHub merge as npm publication, a tag or a GitHub Release. The last independently verified npm `latest` was `2.1.0`.
+
+## [2.1.1] - Unreleased (prepared)
+
+### Fixed
+
+- **HF-002:** Defer `ArrayField` collection validation during `Form.setFields(data, false)`; with enabled validation, check the final collection once after all form values are assigned, using the parent form as context. Avoid validation against a transient empty array, while preserving the public `itemsValue` setter and its immediate validation of the completed replacement. ([PR #10](https://github.com/ArhiMEN/AdaptForm/pull/10))
+- **HF-003:** Reject incomplete decimal strings such as `"123."`, `"0."` and `"-123."` on explicit validation, including with `gt`/`ge`/`lt`/`le` bounds. Preserve the editable input, comma normalization, existing format-error messages and complete-number precision checks. ([PR #12](https://github.com/ArhiMEN/AdaptForm/pull/12))
+
+### Tests and verification
+
+- Add the HF-001 lifecycle characterization baseline and update its expectations after the two targeted fixes. ([PR #8](https://github.com/ArhiMEN/AdaptForm/pull/8))
+- The accepted HF-003 branch passed **477 tests in 21 files**, lint, source type-check, package build, package-content verification and npm audit (0 reported vulnerabilities). The 2.1.1 release candidate must pass its own CI before publication.
+
+### Compatibility and release status
+
+- **Intentional behavior change:** trailing-decimal values may still be entered and serialized, but no longer pass `Field.checkAndSetValid()` or `Form.checkValid()`. Applications must validate before submitting; `toJSON()` itself does not validate.
+- Public types, `rawValue`/`valueClear` representations, serialization shapes and the optional Luxon entry point are unchanged. No new runtime dependencies.
+- The separate test type-check `tsconfig.test.json` has **54 existing diagnostics** unchanged by HF-002/HF-003; it is not part of required CI. These are tracked as technical debt, not represented as passing.
+- **Release not yet published.** Version `2.1.1` is being prepared; do not infer npm publication, a GitHub release or a tag from this entry.
+
+## [2.1.0] - 2026-10-14
+
+### Added
+
+- Prepare gated npm publication after successful `master` CI, using the version in `package.json` and either npm Trusted Publisher or a repository-scoped npm secret; activation awaits authentication setup.
+
+- Add English/Russian demo localization with persistent language selection and language-specific documentation links, preserving entered values and validation state.
+- Add complete Russian companion documentation, changelog, release tracking, repository instructions, and license information alongside the English originals.
+
+- Add a browser-based interactive playground covering field validation, conditional requirements, field state, arrays, nested forms, server-error handling, serialization, and input masks.
+- Add a GitHub Actions workflow to build and deploy the playground to GitHub Pages from `v2.1.0` and `master`.
+- Add dedicated demo type-checking and production-build commands, and run both as part of CI.
+- Add automated npm package-content verification to ensure required ESM, CommonJS, and TypeScript declaration files are present while development sources and tests stay out of the published package.
+- Export `ErrorsSchema` from the public package entry point.
+- Infer `Form.fieldsValue` from declared `Field`, `ArrayField`, and `ArrayFormField` properties.
+
+### Changed
+
+- Configure ESLint for TypeScript source, tests, and demo code; run linting and dependency audits in CI on Node.js 22.
+- Upgrade Vitest, Vite, ESLint, and TypeScript lint tooling; pin patched transitive dependency versions and align the lockfile.
+- Replace the machine-specific absolute Vitest alias with a portable project-relative path.
+- Batch direct field values before form-level validation so conditional-required rules can inspect the complete form state without invoking those direct field validators twice.
+- Add `Form.setFields(data, validate?)` and `Field.setRawValue(value, validate?)` for controlled assignment with optional deferred validation.
+- Make reset behavior explicit: field defaults are restored without running custom validators, errors are cleared, and validity remains unset until validation runs again.
+- Clear stale server errors recursively when a new error payload is assigned.
+- Revalidate collections after mutations, avoid hidden repeated validation when reading `ArrayFormField.isValid`, ignore invalid removal indices, and leave collection validity unset after reset until the next check.
+- Improve inferred form-value types, nullable array values, nested form collection types, and JSON serialization return types.
+- Serialize arrays and nested objects as JSON in `FormData`; omit `null`/`undefined`; preserve `Blob`/`File` values; recursively serialize nested JavaScript `Date` values to ISO 8601 strings in JSON output.
+- Rewrite the README to document supported APIs, validation lifecycle, collection options, error mapping, serialization, development commands, and the interactive demo.
+
+### Fixed
+
+- Make string validation deterministic when patterns contain global or sticky regular-expression flags.
+- Reject blank and non-finite values in `NumberType`.
+- Reject numeric decimal values with excess precision instead of silently rounding them; correctly handle `decimalPlaces: 0`.
+- Treat whitespace-only strings as empty and keep constructor defaults untouched.
+- Correct conditional-required validation after bulk form assignment.
+- Refresh array validation after adding items/forms and avoid invalid negative, fractional, or out-of-range removal indices.
+- Fix `ErrorsSchema.forArray()` to honor custom index extractors, apply item-schema mappings and transformers, and support bracket, dotted, and custom index notation.
+- Invoke an `ErrorsSchema` fallback handler only once when it declines an error.
+- Correct regression coverage for a date-time boundary test and add tests for reset state, nested error clearing, assignment batching, nullable arrays, Date serialization, and Blob/File handling.
+
+### Security and maintenance
+
+- Support both array and keyed-object npm pack JSON manifests in the package-content check; require English/Russian package documentation.
+
+- Add `npm audit --audit-level=moderate` to CI and update vulnerable transitive dependency versions using reviewed overrides. The final verified workflow reports zero known vulnerabilities from npm audit; the previous lockfile scan also reported zero.
+- Verify lint, tests, ESM/CJS build, declaration generation, source type-checking, demo type-checking/build, and npm package contents in CI.
+
+### Compatibility notes
+
+- Built-in library validation messages and their language have not been changed in this release. Localization and any structured error-code contract are deferred to a separate coordinated task.
+- PlayLease-specific integration work is explicitly out of scope for this branch.
+- Version `2.1.0` was published manually to npm. No GitHub release or release tag has been created.
+
+## [2.0.5] - 2026-07-22
+
+### Added
+
+- `ErrorsSchema` class for flexible server error parsing and mapping
+- Static error mapping with `staticKey()` for exact key matching
+- Dynamic error mapping with `dynamicKey()` supporting regex patterns and priority
+- `fallback()` handler for unmatched error keys
+- `transformValue()` for normalizing error messages (array to string, removing prefixes, etc.)
+- `parseErrors()` method returning flat `Record<string, string>`
+- `parseErrorsDetailed()` method returning `ParsedError` objects with metadata (sourceKey, matchedBy)
+- `nest()` method for creating prefixed schemas for nested forms
+- `clone()` and `merge()` methods for schema composition and reuse
+- `ErrorsSchema.fromObject()` factory for quick mapping from plain objects
+- `ErrorsSchema.forArray()` factory for array field error patterns
+- Predefined schemas: `DefaultErrorSchema`, `LaravelErrorSchema`, `GraphQLErrorSchema`
+- Priority system for dynamic rules to control matching order
+- Value transformers chain for sequential error message normalization
+- Support for nested error objects with recursive parsing
+- Pydantic-style error format support out of the box
+
+### Changed
+
+- `Form.errors` setter now uses `ErrorsSchema` for intelligent error mapping
+- `Form.errorsShema` property added for per-form error schema configuration
+- `Form.applyErrorToField()` now supports nested field paths (e.g., `accounts.0.email`)
+- `Form.applyNestedError()` handles `ArrayFormField` recursively with proper error context
+- `Form.allErrors` getter now recursively collects errors from nested `ArrayFormField`
+- `Form.reset()` now properly clears all field errors and global errors
+- Error clearing logic improved: setting empty errors object clears all previous errors
+- Global errors are now properly scoped to their target form instance
+- `DefaultErrorsSchema` uses `fallback((key) => key)` for backward compatibility
+
+### Fixed
+
+- Fixed nested error propagation for `ArrayFormField` with out-of-range indices
+- Fixed error context when applying errors to fields inside nested forms
+- Fixed `allErrors` not including errors from nested forms in `ArrayFormField`
+- Fixed global errors not being properly cleared when setting new errors
+- Fixed null/undefined error values causing unexpected behavior
+- Fixed error mapping for array fields (ArrayField) with index-based keys
 
 ## [2.0.0 - 2.0.4] - 2026-05-29
 
@@ -48,4 +197,4 @@ All notable changes to this project will be documented in this file.
 - Global configuration singleton
 - Automatic Luxon dependency (now optional)
 
-[2.0.4]: https://github.com/ArhiMEN/adaptform/releases/tag/v2.0.4
+[2.0.4]: https://github.com/ArhiMEN/adaptform/releases/tag/v2.0.4

package/CHANGELOG.ru.md

@@ -0,0 +1,200 @@
+# История изменений
+
+[English](CHANGELOG.md) · [Русский](CHANGELOG.ru.md)
+
+Здесь описаны все значимые изменения AdaptForm. Версия `2.1.0` опубликована в npm 2026-10-14.
+
+**[Интерактивное демо](https://arhimen.github.io/AdaptForm/?lang=ru)** · [Исходный код демо](https://github.com/ArhiMEN/AdaptForm/tree/master/demo) · [Документация](https://github.com/ArhiMEN/AdaptForm/blob/master/README.ru.md)
+
+## [2.2.0] — Не опубликована (исходники подготовлены)
+
+### Добавлено — фундамент headless-состояний
+
+- **HF-005:** Спецификация жизненного цикла полей и форм, baseline очищенных значений, touched/dirty, snapshots, синхронных batch и совместимости на EN/RU. ([контракт](docs/ai/HEADLESS_STATE_CONTRACT.ru.md))
+- **HF-006:** `Field.isDirty` и `commitBaseline()` с семантическим сравнением Date, необязательного Luxon, данных после плагинов и поддерживаемых вложенных структур.
+- **HF-007:** Производное `isDirty` и фиксация baseline у `Form`, `ArrayField`, `ArrayFormField`: учитываются состав, порядок коллекций и вложенные значения.
+- **HF-008:** `subscribe(listener)`, идемпотентная отписка, стабильный неизменяемый `getSnapshot()` и публичные типы `SnapshotValue`, `NodeSnapshot`, `FieldSnapshot`, `FormSnapshot`, `ArrayFieldSnapshot`, `ArrayFormSnapshot`. Новых обязательных runtime/UI-зависимостей нет.
+- **HF-009:** Синхронный вложенный `Form.batch(callback)` с объединёнными уведомлениями, отложенной автоматической валидацией по итоговым данным и корректным завершением при исключении. Уже выполненные изменения **не откатываются**.
+- **HF-010:** Передача изменений от потомков и коллекций родителю, обновление связей при удалении/замене и очистка владения при отписке. ([PR #16](https://github.com/ArhiMEN/AdaptForm/pull/16))
+
+### Исправлено
+
+- `ArrayField.remove()/clear()` и `ArrayFormField.remove()/clear()` откладывают автоматическую проверку внутри `Form.batch()`, но проверяют синхронно вне batch; явные `checkValid()` остаются немедленными. Добавлено 34 целевых регрессии.
+- `Form.allErrors` копирует массивы ошибок потомков, исключая мутацию и заморозку живых массивов при совмещении глобальных ошибок и snapshots.
+
+### Совместимость и ограничения
+
+- Сохранены прежние class-based API, синхронные проверки вне batch, `isTouched`, `isValid`, поведение `reset()` (включая состав коллекций), сериализация и необязательный `adaptform/luxon`.
+- `commitBaseline()` меняет точку сравнения dirty, **не** цель `reset()`. После фиксации другого baseline сброс может оставить `isDirty=true`.
+- Snapshots — независимые неизменяемые представления, а не исходные изменяемые объекты; пользовательские экземпляры классов могут быть непрозрачными. Прямые мутации прежних массивов/options и произвольная замена свойств Form не перехватываются автоматически.
+- Нет `reinitialize()`, изменения reset коллекций (HF-004), графа зависимостей (HF-011+), асинхронных валидаторов, submit lifecycle, UI-адаптеров или бенчмарков.
+
+### Проверки и выпуск
+
+- Принятый [PR #16](https://github.com/ArhiMEN/AdaptForm/pull/16) прошёл **563 теста в 27 файлах**, lint, проверку типов исходников/демо, сборки библиотеки/демо и аудит (0 известных уязвимостей). Независимое ревью выполнено, [PR #17 с документацией](https://github.com/ArhiMEN/AdaptForm/pull/17) объединён. Для кандидата 2.2.0 требуется **собственный** успешный CI.
+- Отдельная проверка `tsconfig.test.json` сохраняет **54 прежние диагностики** и не объявляется пройденной; старый `TS2589` mapped type воспроизводится также на 2.1.1. Новых диагностик в HF-005–HF-010 не установлено.
+- **Не опубликована.** В исходниках готовится `2.2.0`, но запись changelog или merge в GitHub не равны публикации npm, тегу или GitHub Release. Последняя отдельно проверенная npm-версия `latest` — `2.1.0`.
+
+## [2.1.1] — Не опубликована (подготовка)
+
+### Исправлено
+
+- **HF-002:** Проверка коллекции `ArrayField` откладывается при `Form.setFields(data, false)`. При включённой валидации завершённая коллекция проверяется один раз после присваивания всех полей, с контекстом родительской формы. Промежуточный пустой массив больше не проверяется; публичный setter `itemsValue` сохранён и проверяет итоговую замену немедленно. ([PR #10](https://github.com/ArhiMEN/AdaptForm/pull/10))
+- **HF-003:** Незавершённые десятичные значения, например `"123."`, `"0."` и `"-123."`, отклоняются при явной проверке, в том числе при ограничениях `gt`/`ge`/`lt`/`le`. Ввод остаётся редактируемым; нормализация запятой, существующие сообщения об ошибках формата и точность завершённых чисел сохранены. ([PR #12](https://github.com/ArhiMEN/AdaptForm/pull/12))
+
+### Тесты и проверки
+
+- Добавлены characterization-тесты жизненного цикла HF-001 и обновлены их ожидания после двух исправлений. ([PR #8](https://github.com/ArhiMEN/AdaptForm/pull/8))
+- В принятой ветке HF-003 прошли **477 тестов в 21 файле**, lint, типы исходного кода, сборка, проверка пакета и npm audit (0 известных уязвимостей). Кандидат 2.1.1 должен пройти собственный CI до публикации.
+
+### Совместимость и статус
+
+- **Намеренное изменение поведения:** строки с завершающим десятичным разделителем можно редактировать и сериализовать, но они больше не проходят `Field.checkAndSetValid()` и `Form.checkValid()`. Перед отправкой приложение должно проверить форму; `toJSON()` не запускает проверку.
+- Публичные типы, представления `rawValue`/`valueClear`, формат сериализации и необязательная точка входа Luxon не изменены. Новых обязательных зависимостей нет.
+- Отдельная типизация тестов `tsconfig.test.json` сохраняет **54 ранее существовавшие диагностики** после HF-002/HF-003; она не является обязательным этапом CI и не объявляется успешной.
+- **Версия ещё не опубликована.** `2.1.1` только готовится: эта запись не означает публикацию в npm, создание GitHub Release или тега.
+
+## [2.1.0] — 2026-10-14
+
+### Добавлено
+
+- Подготовлена управляемая публикация в npm после успешного CI для `master` с версией из `package.json` и авторизацией через Trusted Publisher либо секрет репозитория; включение ожидает настройки авторизации.
+
+- Локализация демо на английский и русский с сохранением выбранного языка и ссылками на документацию соответствующего языка; введённые значения и состояние валидации сохраняются.
+- Полные русские версии документации, истории изменений, плана выпуска, журнала статуса, инструкций репозитория и сведений о лицензии рядом с английскими оригиналами.
+
+- Интерактивное демо в браузере: валидация полей, условная обязательность, состояния полей, массивы, вложенные формы, серверные ошибки, сериализация и маски ввода.
+- Workflow GitHub Actions для сборки и публикации демо в GitHub Pages из `v2.1.0` и `master`.
+- Отдельные команды проверки типов и производственной сборки демо, выполняемые в CI.
+- Автоматическая проверка состава npm-пакета: обязательные ESM, CommonJS и декларации TypeScript включены, исходный код разработки и тесты исключены.
+- Экспорт `ErrorsSchema` из публичной точки входа пакета.
+- Вывод типов `Form.fieldsValue` из объявленных свойств `Field`, `ArrayField` и `ArrayFormField`.
+
+### Изменено
+
+- ESLint настроен для TypeScript-кода библиотеки, тестов и демо; lint и аудит зависимостей выполняются в CI на Node.js 22.
+- Обновлены Vitest, Vite, ESLint и инструменты lint для TypeScript; закреплены исправленные транзитивные зависимости и согласован lockfile.
+- Абсолютный путь в псевдониме Vitest заменён переносимым путём относительно проекта.
+- Значения непосредственных полей присваиваются до проверки формы, чтобы условные правила видели полное состояние без двойного запуска валидаторов этих полей.
+- Добавлены `Form.setFields(data, validate?)` и `Field.setRawValue(value, validate?)` для управляемого присваивания с необязательной отложенной валидацией.
+- Уточнён сброс: значения по умолчанию восстанавливаются без вызова пользовательских валидаторов, ошибки очищаются, корректность не определена до следующей проверки.
+- При назначении нового ответа ошибок предыдущие серверные ошибки очищаются рекурсивно.
+- Коллекции проверяются после изменения, чтение `ArrayFormField.isValid` не вызывает скрытую повторную валидацию, некорректные индексы удаления игнорируются, после сброса корректность ожидает новой проверки.
+- Улучшены выведенные типы значений формы, nullable-значения массивов, типы коллекций вложенных форм и результаты JSON-сериализации.
+- Массивы и вложенные объекты кодируются в JSON в `FormData`; `null`/`undefined` пропускаются; `Blob`/`File` сохраняются; вложенные JavaScript `Date` рекурсивно преобразуются в ISO 8601 в JSON.
+- README переписан для описания API, жизненного цикла валидации, параметров коллекций, сопоставления ошибок, сериализации, команд разработки и интерактивного демо.
+
+### Исправлено
+
+- Проверка строк стала детерминированной для регулярных выражений с глобальным или липким флагом.
+- `NumberType` отклоняет пустые и неконечные значения.
+- Десятичные числа с избыточной точностью отклоняются без скрытого округления; `decimalPlaces: 0` обрабатывается корректно.
+- Строки только из пробелов считаются пустыми; значения по умолчанию конструктора сохраняют состояние «не изменено».
+- Исправлена условная обязательность после массового присваивания полей формы.
+- Валидация массива обновляется после добавления элементов/форм; отрицательные, дробные и выходящие за границы индексы удаления игнорируются.
+- `ErrorsSchema.forArray()` учитывает пользовательский извлекатель индекса, правила и преобразования схемы элемента, поддерживает скобочную, точечную и пользовательскую запись индекса.
+- Обработчик fallback в `ErrorsSchema` вызывается только один раз, если он отклоняет ошибку.
+- Исправлен тест граничного времени; добавлены проверки сброса, очистки вложенных ошибок, группового присваивания, nullable-массивов, сериализации Date и обработки Blob/File.
+
+### Безопасность и сопровождение
+
+- Проверка состава пакета поддерживает JSON-манифесты npm pack в виде массива и объекта с ключами; документация пакета обязательна на английском и русском.
+
+- В CI добавлен `npm audit --audit-level=moderate`; уязвимые транзитивные зависимости обновлены проверенными overrides. Последний проверенный workflow сообщает о нуле известных уязвимостей в npm audit; предыдущая проверка lockfile также сообщила о нуле.
+- В CI проверяются lint, тесты, сборка ESM/CJS, декларации, типы библиотеки, типы и сборка демо, состав npm-пакета.
+
+### Совместимость
+
+- Встроенные сообщения валидации библиотеки и их язык в этом выпуске не изменены. Их локализация и контракт структурированных кодов ошибок отложены до отдельной согласованной задачи.
+- Интеграция с PlayLease явно исключена из области этой ветки.
+- Версия `2.1.0` опубликована в npm вручную. Релиз и тег GitHub не создавались.
+
+## [2.0.5] — 2026-07-22
+
+### Добавлено
+
+- Класс `ErrorsSchema` для гибкого разбора и сопоставления серверных ошибок
+- Статическое сопоставление точных ключей через `staticKey()`
+- Динамическое сопоставление через `dynamicKey()` с регулярными выражениями и приоритетом
+- Обработчик `fallback()` для ключей без соответствия
+- `transformValue()` для нормализации сообщений (массив в строку, удаление префиксов и т. п.)
+- Метод `parseErrors()`, возвращающий плоский `Record<string, string>`
+- Метод `parseErrorsDetailed()`, возвращающий объекты `ParsedError` с метаданными (sourceKey, matchedBy)
+- Метод `nest()` для схем с префиксами вложенных форм
+- Методы `clone()` и `merge()` для композиции и повторного использования схем
+- Фабрика `ErrorsSchema.fromObject()` для быстрого сопоставления из обычного объекта
+- Фабрика `ErrorsSchema.forArray()` для шаблонов ошибок массивов полей
+- Готовые схемы: `DefaultErrorSchema`, `LaravelErrorSchema`, `GraphQLErrorSchema`
+- Система приоритетов динамических правил для управления порядком сопоставления
+- Цепочка преобразователей значений для последовательной нормализации сообщений
+- Рекурсивный разбор вложенных объектов ошибок
+- Встроенная поддержка ошибок в формате Pydantic
+
+### Изменено
+
+- Сеттер `Form.errors` использует `ErrorsSchema` для сопоставления ошибок
+- Добавлено свойство `Form.errorsShema` для настройки схемы отдельной формы
+- `Form.applyErrorToField()` поддерживает вложенные пути (например, `accounts.0.email`)
+- `Form.applyNestedError()` рекурсивно обрабатывает `ArrayFormField` с правильным контекстом
+- Геттер `Form.allErrors` рекурсивно собирает ошибки вложенных `ArrayFormField`
+- `Form.reset()` очищает ошибки всех полей и общие ошибки
+- Пустой объект ошибок очищает все ранее применённые ошибки
+- Общие ошибки привязаны к соответствующему экземпляру формы
+- `DefaultErrorsSchema` использует `fallback((key) => key)` для обратной совместимости
+
+### Исправлено
+
+- Передача вложенных ошибок `ArrayFormField` при индексах за границами массива
+- Контекст ошибок при назначении полям вложенных форм
+- Отсутствие ошибок вложенных форм `ArrayFormField` в `allErrors`
+- Неполная очистка общих ошибок при назначении новых
+- Неожиданное поведение при значениях ошибок null/undefined
+- Сопоставление ошибок массивов полей (ArrayField) по индексным ключам
+
+## [2.0.0 - 2.0.4] — 2026-05-29
+
+### Добавлено
+
+- Полная переработка на TypeScript с выводом типов
+- Система плагинов MaskPlugin, FieldPlugin и DecoratorPlugin
+- ArrayField для динамических массивов полей
+- ArrayFormField для массивов вложенных форм
+- Новые типы: DecimalType, DateLuxonType, BooleanType
+- Необязательная интеграция Luxon через экспорт `adaptform/luxon`
+- Маски ввода с гибкой настройкой
+- Условная обязательность полей в зависимости от состояния формы
+- Пользовательские сообщения валидации для всех типов полей
+- Общие ошибки для ответов сервера
+- Сериализация форм (`toJSON()`, `toFormData()`)
+- Экспорты с поддержкой tree shaking для уменьшения сборок
+- Поддержка ESM и CJS
+- Полные декларации TypeScript с корректными типами
+
+### Изменено
+
+- **Полная переработка API** — новая архитектура на основе классов
+- Поля создаются через `new Field(TypeClass, defaultValue, options)`
+- Валидация требует явных объявлений полей в теле класса
+- Система плагинов заменяет прежний механизм middleware
+- Обработка ошибок унифицирована для всех типов полей
+- Методы валидации возвращают массивы строк вместо boolean
+- Интерфейс параметров перестроен для улучшения вывода типов
+
+### Несовместимые изменения
+
+- **Полная переработка относительно v1.x** — обратная совместимость отсутствует
+- Форма должна наследовать базовый класс `Form` и объявлять поля
+- Конструктор поля требует TypeClass первым аргументом
+- `validate()` возвращает `string[]` вместо `boolean`
+- API плагинов полностью переработан
+- Пути импорта изменены для поддержки tree shaking
+- Тип даты Luxon вынесен в отдельную точку входа `adaptform/luxon`
+
+### Удалено
+
+- Прежний API на основе функций
+- Старый механизм middleware для валидации
+- Глобальная конфигурация singleton
+- Автоматическая зависимость от Luxon (теперь необязательна)
+
+[2.0.4]: https://github.com/ArhiMEN/adaptform/releases/tag/v2.0.4

package/LICENSE.md

@@ -18,4 +18,6 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.
+
+[English](LICENSE.md) · [Русский](LICENSE.ru.md)

package/LICENSE.ru.md

@@ -0,0 +1,25 @@
+# Лицензия MIT
+
+Copyright (c) 2025 Stanislav Orlov (ArhiMEN)
+
+Настоящим бесплатно предоставляется разрешение любому лицу, получившему копию
+данного программного обеспечения и соответствующей документации (далее «ПО»),
+использовать ПО без ограничений, включая права на использование, копирование,
+изменение, объединение, публикацию, распространение, сублицензирование и/или
+продажу копий ПО, а также предоставлять такие права лицам, которым передаётся
+ПО, при соблюдении следующих условий:
+
+Указанное выше уведомление об авторских правах и данное уведомление о разрешении
+должны включаться во все копии или существенные части ПО.
+
+ПО ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ
+ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ГАРАНТИИ ПРИГОДНОСТИ ДЛЯ ПРОДАЖИ, СООТВЕТСТВИЯ
+ОПРЕДЕЛЁННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ
+ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ПО ЛЮБЫМ ТРЕБОВАНИЯМ, УЩЕРБУ
+ИЛИ ИНОЙ ОТВЕТСТВЕННОСТИ, ВОЗНИКАЮЩИМ В СИЛУ ДОГОВОРА, ДЕЛИКТА ИЛИ ИНЫМ
+ОБРАЗОМ В СВЯЗИ С ПО, ЕГО ИСПОЛЬЗОВАНИЕМ ИЛИ ИНЫМИ ДЕЙСТВИЯМИ С НИМ.
+
+Это справочный русский перевод. Условия лицензии определяются английским
+оригиналом [LICENSE.md](LICENSE.md).
+
+[English](LICENSE.md) · [Русский](LICENSE.ru.md)