Form Schema

Реактивные формы из декларативной схемы (JSON, Zod, Yup или Valibot) для Vue 3. Headless, SSR-совместимая альтернатива VeeValidate / FormKit для форм, которые генерируются динамически или управляются с сервера.

Возможности

• Любой источник схемы — FieldDefinition[], JSON-массив, Zod, Yup, Valibot или стандартная JSON Schema / OpenAPI
• Headless по умолчанию — никаких UI-зависимостей в ядре; подключайте свои компоненты
• Реактивные условия — visible, disabled принимают булево значение, функцию или строковое выражение
• Динамические опции — синхронные и асинхронные функции options с отслеживанием зависимостей (optionsDeps)
• Динамические массивы полей — type: 'array' с composable useFieldArray (append / remove / move / swap)
• Многошаговый визард — useMultiStepForm с валидацией на каждом шаге и MultiStepFormRenderer
• Валидация — синхронные и асинхронные валидаторы, validateMode: 'first' | 'all', validateOn: 'eager'
• Кросс-полевая валидация — валидатор sameAs; валидаторы получают все текущие значения вторым аргументом
• Transform и parse — transform запускается на каждом setField; parse — во время отправки
• Загрузка файлов — type: 'file' с валидаторами fileType, fileSize, fileCount; drag-and-drop UI
• Кастомные компоненты — field.component + реестр компонентов на уровне приложения и поддерева
• Маскирование ввода — телефон (RU/EU), дата, IBAN, ИНН, кастомные паттерны #/A; без внешних зависимостей
• Композиция схем — mergeSchemas, omitFields, pickFields, extendField
• Дискриминированные схемы — discriminatedFields строит visible-связку для набора полей, который целиком переключается по значению дискриминатора, с нативным маппингом z.discriminatedUnion / v.variant
• Вывод типов TypeScript — InferValues<T> отображает литералы схемы в типизированные значения
• Персистентные формы — persist: 'local' | 'session' с SSR-безопасным хранением
• Ошибки валидации с сервера — applyServerErrors отображает форматы Laravel/DRF/flat/кастомный на errors
• Режим отладки — debug: true логирует изменения состояния; useFormDebug возвращает реактивный снапшот
• Тема Tailwind UI — подточка входа vue-form-schema/ui/tailwind с компонентами на utility-классах
• Темы shadcn / PrimeVue / Naive UI — готовые рендереры для популярных библиотек компонентов
• Доступность — aria-required, aria-invalid, aria-describedby, fieldset/legend для radio
• SSR-безопасность — никаких прямых обращений к browser API в ядре
• Tree-shakeable — адаптеры Zod/Yup/Valibot и UI — отдельные точки входа
• Модуль Nuxt — @macrulez/nuxt-vue-form-schema автоимпортирует composables, валидаторы и адаптеры схем
• Vue DevTools — vue-form-schema/devtools добавляет живой инспектор форм + таймлайн, нулевая цена, если не установлен