@macrulez/vue-form-schema 0.1.7 → 0.2.0

package/dist/ui-tailwind.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue"),x=require("./MaskEngine-CPr-fSPy.cjs"),F=require("./ValidationEngine-Diz-qTFs.cjs"),D={class:"mb-4"},T=["for"],R={key:0,class:"text-red-400 ml-0.5","aria-hidden":"true"},A=["id"],k=e.defineComponent({__name:"BaseField",props:{field:{},error:{},touched:{type:Boolean}},setup(t){const s=t,o=e.computed(()=>{var a;return!!(s.touched&&((a=s.error)!=null&&a.length))}),c=e.computed(()=>`${s.field.name}-error`),n=e.computed(()=>({"aria-required":s.field.required?"true":void 0,"aria-invalid":o.value?"true":"false","aria-describedby":o.value?c.value:void 0}));return(a,d)=>(e.openBlock(),e.createElementBlock("div",D,[t.field.label?(e.openBlock(),e.createElementBlock("label",{key:0,for:t.field.name,class:"block text-xs font-semibold uppercase tracking-wider text-gray-400 mb-1.5"},[e.createTextVNode(e.toDisplayString(t.field.label)+" ",1),t.field.required?(e.openBlock(),e.createElementBlock("span",R,"*")):e.createCommentVNode("",!0)],8,T)):e.createCommentVNode("",!0),e.renderSlot(a.$slots,"default",e.normalizeProps(e.guardReactiveProps(n.value))),o.value?(e.openBlock(),e.createElementBlock("ul",{key:1,id:c.value,class:"mt-1 space-y-0.5",role:"alert","aria-live":"polite"},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(t.error,(i,m)=>(e.openBlock(),e.createElementBlock("li",{key:m,class:"text-red-400 text-xs"},e.toDisplayString(i),1))),128))],8,A)):e.createCommentVNode("",!0)]))}}),P=["id","type","name","value","placeholder","disabled","required"],B=e.defineComponent({__name:"TextField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.ref(null);let a=null;const d=e.computed(()=>{var i;return!!(o.touched&&((i=o.error)!=null&&i.length))});return e.onMounted(()=>{n.value&&o.field.mask&&(a=x.bindMask(n.value,o.field.mask))}),e.onUnmounted(()=>a==null?void 0:a()),(i,m)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(f=>[e.createElementVNode("input",e.mergeProps({id:t.field.name,ref_key:"inputRef",ref:n,type:t.field.type==="email"?"email":"text",name:t.field.name,value:t.modelValue??"",placeholder:t.field.placeholder,disabled:t.field.disabled===!0,required:t.field.required},f,{class:["w-full rounded-lg border bg-gray-900 px-3 py-2 text-sm text-gray-100 placeholder-gray-500 outline-none transition focus:ring-2 disabled:cursor-not-allowed disabled:opacity-50",d.value?"border-red-500 focus:ring-red-500":"border-gray-700 focus:ring-indigo-500 focus:border-indigo-500"],onInput:m[0]||(m[0]=g=>c("update:modelValue",g.target.value)),onBlur:m[1]||(m[1]=g=>c("blur"))}),null,16,P)]),_:1},8,["field","error","touched"]))}}),L=["id","name","value","placeholder","disabled","required"],V=e.defineComponent({__name:"NumberField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.computed(()=>{var d;return!!(o.touched&&((d=o.error)!=null&&d.length))});function a(d){const i=d.target.value;c("update:modelValue",i===""?null:Number(i))}return(d,i)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(m=>[e.createElementVNode("input",e.mergeProps({id:t.field.name,type:"number",name:t.field.name,value:t.modelValue??"",placeholder:t.field.placeholder,disabled:t.field.disabled===!0,required:t.field.required},m,{class:["w-full rounded-lg border bg-gray-900 px-3 py-2 text-sm text-gray-100 placeholder-gray-500 outline-none transition focus:ring-2 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-red-500 focus:ring-red-500":"border-gray-700 focus:ring-indigo-500 focus:border-indigo-500"],onInput:a,onBlur:i[0]||(i[0]=f=>c("blur"))}),null,16,L)]),_:1},8,["field","error","touched"]))}}),I=["id","name","value","placeholder","disabled","required"],$=e.defineComponent({__name:"TextareaField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.computed(()=>{var a;return!!(o.touched&&((a=o.error)!=null&&a.length))});return(a,d)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(i=>[e.createElementVNode("textarea",e.mergeProps({id:t.field.name,name:t.field.name,value:t.modelValue??"",placeholder:t.field.placeholder,disabled:t.field.disabled===!0,required:t.field.required},i,{class:["w-full resize-y rounded-lg border bg-gray-900 px-3 py-2 text-sm text-gray-100 placeholder-gray-500 outline-none transition focus:ring-2 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-red-500 focus:ring-red-500":"border-gray-700 focus:ring-indigo-500 focus:border-indigo-500"],style:{"min-height":"80px"},onInput:d[0]||(d[0]=m=>c("update:modelValue",m.target.value)),onBlur:d[1]||(d[1]=m=>c("blur"))}),null,16,I)]),_:1},8,["field","error","touched"]))}}),M={key:0,class:"py-2 text-sm text-gray-400"},z=["id","name","disabled","required"],U=["selected"],j=["value","selected"],E=e.defineComponent({__name:"SelectField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.computed(()=>Array.isArray(o.field.options)?o.field.options:[]),a=e.computed(()=>{var i;return!!(o.touched&&((i=o.error)!=null&&i.length))});function d(i){const m=i.target,f=n.value.find(g=>String(g.value)===m.value);c("update:modelValue",(f==null?void 0:f.value)??m.value)}return(i,m)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(f=>[t.field.optionsLoading?(e.openBlock(),e.createElementBlock("div",M,"Loading…")):(e.openBlock(),e.createElementBlock("select",e.mergeProps({key:1,id:t.field.name,name:t.field.name,disabled:t.field.disabled===!0||t.field.optionsLoading,required:t.field.required},f,{class:["w-full rounded-lg border bg-gray-900 px-3 py-2 text-sm text-gray-100 outline-none transition focus:ring-2 disabled:cursor-not-allowed disabled:opacity-50",a.value?"border-red-500 focus:ring-red-500":"border-gray-700 focus:ring-indigo-500 focus:border-indigo-500"],onChange:d,onBlur:m[0]||(m[0]=g=>c("blur"))}),[e.createElementVNode("option",{value:"",disabled:"",selected:t.modelValue===null||t.modelValue===void 0||t.modelValue==="",class:"bg-gray-800"},e.toDisplayString(t.field.placeholder??"Select an option"),9,U),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(n.value,g=>(e.openBlock(),e.createElementBlock("option",{key:String(g.value),value:String(g.value),selected:t.modelValue===g.value,class:"bg-gray-800"},e.toDisplayString(g.label),9,j))),128))],16,z))]),_:1},8,["field","error","touched"]))}}),K={class:"flex cursor-pointer items-center gap-2.5"},O=["id","name","checked","disabled","required","aria-checked"],G={key:0,class:"text-sm text-gray-200"},C=e.defineComponent({__name:"CheckboxField",props:{field:{},modelValue:{type:[Boolean,null]},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=s;return(c,n)=>(e.openBlock(),e.createBlock(k,{field:{...t.field,label:void 0},error:t.error,touched:t.touched},{default:e.withCtx(a=>[e.createElementVNode("label",K,[e.createElementVNode("input",e.mergeProps({id:t.field.name,type:"checkbox",name:t.field.name,checked:!!t.modelValue,disabled:t.field.disabled===!0,required:t.field.required,"aria-checked":t.modelValue?"true":"false"},a,{class:"h-4 w-4 cursor-pointer rounded border-gray-600 bg-gray-900 text-indigo-500 accent-indigo-500 disabled:cursor-not-allowed disabled:opacity-50",onChange:n[0]||(n[0]=d=>o("update:modelValue",d.target.checked)),onBlur:n[1]||(n[1]=d=>o("blur"))}),null,16,O),t.field.label?(e.openBlock(),e.createElementBlock("span",G,e.toDisplayString(t.field.label),1)):e.createCommentVNode("",!0)])]),_:1},8,["field","error","touched"]))}}),H=["aria-required","aria-invalid","aria-describedby"],J={key:0,class:"block text-xs font-semibold uppercase tracking-wider text-gray-400 mb-2"},Q={key:0,class:"text-red-400 ml-0.5","aria-hidden":"true"},W={class:"space-y-2"},X=["name","value","checked","disabled","onChange"],Y={class:"text-sm text-gray-200"},Z=["id"],w=e.defineComponent({__name:"RadioField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.computed(()=>{var i;return!!(o.touched&&((i=o.error)!=null&&i.length))}),a=e.computed(()=>`${o.field.name}-error`),d=e.computed(()=>Array.isArray(o.field.options)?o.field.options:[]);return(i,m)=>(e.openBlock(),e.createElementBlock("fieldset",{class:"mb-4","aria-required":t.field.required?"true":void 0,"aria-invalid":n.value?"true":"false","aria-describedby":n.value?a.value:void 0},[t.field.label?(e.openBlock(),e.createElementBlock("legend",J,[e.createTextVNode(e.toDisplayString(t.field.label)+" ",1),t.field.required?(e.openBlock(),e.createElementBlock("span",Q,"*")):e.createCommentVNode("",!0)])):e.createCommentVNode("",!0),e.createElementVNode("div",W,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(d.value,f=>(e.openBlock(),e.createElementBlock("label",{key:String(f.value),class:"flex cursor-pointer items-center gap-2.5"},[e.createElementVNode("input",{type:"radio",name:t.field.name,value:String(f.value),checked:t.modelValue===f.value,disabled:t.field.disabled===!0,class:"h-4 w-4 cursor-pointer border-gray-600 bg-gray-900 text-indigo-500 accent-indigo-500 disabled:cursor-not-allowed disabled:opacity-50",onChange:g=>c("update:modelValue",f.value),onBlur:m[0]||(m[0]=g=>c("blur"))},null,40,X),e.createElementVNode("span",Y,e.toDisplayString(f.label),1)]))),128))]),n.value?(e.openBlock(),e.createElementBlock("ul",{key:1,id:a.value,class:"mt-1 space-y-0.5",role:"alert","aria-live":"polite"},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(t.error,(f,g)=>(e.openBlock(),e.createElementBlock("li",{key:g,class:"text-red-400 text-xs"},e.toDisplayString(f),1))),128))],8,Z)):e.createCommentVNode("",!0)],8,H))}}),_=["id","name","value","disabled","required"],N=e.defineComponent({__name:"DateField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.computed(()=>{var a;return!!(o.touched&&((a=o.error)!=null&&a.length))});return(a,d)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(i=>[e.createElementVNode("input",e.mergeProps({id:t.field.name,type:"date",name:t.field.name,value:t.modelValue??"",disabled:t.field.disabled===!0,required:t.field.required},i,{class:["w-full rounded-lg border bg-gray-900 px-3 py-2 text-sm text-gray-100 outline-none transition focus:ring-2 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-red-500 focus:ring-red-500":"border-gray-700 focus:ring-indigo-500 focus:border-indigo-500"],onInput:d[0]||(d[0]=m=>c("update:modelValue",m.target.value)),onBlur:d[1]||(d[1]=m=>c("blur"))}),null,16,_)]),_:1},8,["field","error","touched"]))}}),ee=["id","name","accept","multiple","disabled","required"],te={class:"pointer-events-none space-y-1"},oe={class:"text-sm text-gray-300"},re={key:0,class:"text-xs text-gray-500"},le={key:0,class:"mt-2 space-y-1"},ne={class:"truncate text-gray-200"},ae={class:"ml-2 shrink-0 text-xs text-gray-500"},de=["aria-label","onClick"],S=e.defineComponent({__name:"FileField",props:{field:{},modelValue:{},error:{},touched:{type:Boolean}},emits:["update:modelValue","blur"],setup(t,{emit:s}){const o=t,c=s,n=e.ref(!1),a=e.ref(null),d=e.computed(()=>o.modelValue?Array.isArray(o.modelValue)?o.modelValue:[o.modelValue]:[]),i=e.computed(()=>o.field.multiple??!1);function m(l){if(!l||l.length===0){c("update:modelValue",null);return}c("update:modelValue",i.value?Array.from(l):l[0])}function f(l){m(l.target.files),c("blur")}function g(l){var r;n.value=!1,l.preventDefault(),m(((r=l.dataTransfer)==null?void 0:r.files)??null),c("blur")}function h(l){const r=d.value.filter((b,y)=>y!==l);r.length===0?(c("update:modelValue",null),a.value&&(a.value.value="")):c("update:modelValue",i.value?r:r[0])}function v(l){return l<1024?`${l} B`:l<1024*1024?`${(l/1024).toFixed(1)} KB`:`${(l/(1024*1024)).toFixed(1)} MB`}return(l,r)=>(e.openBlock(),e.createBlock(k,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(b=>{var y;return[e.createElementVNode("div",{class:e.normalizeClass(["relative rounded-lg border-2 border-dashed p-6 text-center transition",n.value?"border-indigo-500 bg-indigo-500/10":t.touched&&((y=t.error)!=null&&y.length)?"border-red-500 bg-red-500/5":"border-gray-700 bg-gray-900 hover:border-gray-500"]),onDragover:r[0]||(r[0]=e.withModifiers(u=>n.value=!0,["prevent"])),onDragleave:r[1]||(r[1]=u=>n.value=!1),onDrop:g},[e.createElementVNode("input",e.mergeProps({id:t.field.name,ref_key:"inputRef",ref:a,type:"file",name:t.field.name,accept:t.field.accept,multiple:i.value,disabled:t.field.disabled===!0,required:t.field.required},b,{class:"absolute inset-0 h-full w-full cursor-pointer opacity-0 disabled:cursor-not-allowed",onChange:f}),null,16,ee),e.createElementVNode("div",te,[r[2]||(r[2]=e.createElementVNode("div",{class:"text-2xl"},"📁",-1)),e.createElementVNode("p",oe,e.toDisplayString(n.value?"Drop files here":"Click to upload or drag & drop"),1),t.field.accept?(e.openBlock(),e.createElementBlock("p",re,e.toDisplayString(t.field.accept),1)):e.createCommentVNode("",!0)])],34),d.value.length?(e.openBlock(),e.createElementBlock("ul",le,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(d.value,(u,p)=>(e.openBlock(),e.createElementBlock("li",{key:`${u.name}-${p}`,class:"flex items-center justify-between rounded-lg border border-gray-700 bg-gray-900 px-3 py-2 text-sm"},[e.createElementVNode("span",ne,e.toDisplayString(u.name),1),e.createElementVNode("span",ae,e.toDisplayString(v(u.size)),1),e.createElementVNode("button",{type:"button","aria-label":`Remove ${u.name}`,class:"ml-2 shrink-0 text-gray-500 hover:text-red-400 transition",onClick:ye=>h(p)}," × ",8,de)]))),128))])):e.createCommentVNode("",!0)]}),_:1},8,["field","error","touched"]))}}),ie={class:"mb-4"},ue={key:0,class:"block text-xs font-semibold uppercase tracking-wider text-gray-400 mb-2"},ce={class:"flex-1 space-y-0"},se=["onClick"],q=e.defineComponent({__name:"ArrayField",props:{field:{},form:{},components:{}},setup(t){const s=t,o=x.useRegistry(),c={text:B,email:B,number:V,textarea:$,select:E,checkbox:C,radio:w,date:N};function n(l){var r;return l.component?l.component:((r=s.components)==null?void 0:r[l.type])??o[l.type]??c[l.type]??null}const{rows:a,append:d,remove:i}=x.useFieldArray(s.form,s.field.name);function m(l){return F.getByPath(s.form.values.value,l.name)}function f(l,r){s.form.setField(l.name,r)}function g(l){var b;const r=s.form;(b=r.touchField)==null||b.call(r,l.name)}function h(l){return s.form.errors.value[l.name]??[]}function v(l){return s.form.touched.value[l.name]??!1}return(l,r)=>(e.openBlock(),e.createElementBlock("div",ie,[t.field.label?(e.openBlock(),e.createElementBlock("div",ue,e.toDisplayString(t.field.label),1)):e.createCommentVNode("",!0),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(e.unref(a),b=>(e.openBlock(),e.createElementBlock("div",{key:b.key,class:"mb-2 flex items-start gap-2 rounded-lg border border-gray-700 bg-gray-900 p-3"},[e.createElementVNode("div",ce,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(b.fields,y=>(e.openBlock(),e.createElementBlock(e.Fragment,{key:y.name},[n(y)?(e.openBlock(),e.createBlock(e.resolveDynamicComponent(n(y)),{key:0,field:y,"model-value":m(y),error:h(y),touched:v(y),"onUpdate:modelValue":u=>f(y,u),onBlur:u=>g(y)},null,40,["field","model-value","error","touched","onUpdate:modelValue","onBlur"])):e.createCommentVNode("",!0)],64))),128))]),e.createElementVNode("button",{type:"button",class:"mt-7 shrink-0 rounded px-2 py-1 text-xs text-gray-500 hover:bg-red-500/10 hover:text-red-400 transition",onClick:y=>e.unref(i)(b.index)}," Remove ",8,se)]))),128)),e.createElementVNode("button",{type:"button",class:"mt-1 rounded-lg border border-dashed border-gray-600 px-4 py-2 text-sm text-gray-400 hover:border-indigo-500 hover:text-indigo-400 transition",onClick:r[0]||(r[0]=b=>e.unref(d)())}," + Add row ")]))}}),me={key:1,class:"mb-4 rounded-lg border border-gray-700 p-4"},fe={key:0,class:"px-1 text-xs font-semibold uppercase tracking-wider text-gray-400"},ge=["disabled"],be=e.defineComponent({__name:"TailwindFormRenderer",props:{form:{},components:{},submitLabel:{},fields:{}},emits:["submit"],setup(t,{emit:s}){const o=t,c=x.useRegistry(),n=s,a={text:B,email:B,number:V,textarea:$,select:E,checkbox:C,radio:w,date:N,file:S};function d(r){var b;return r.component?r.component:((b=o.components)==null?void 0:b[r.type])??c[r.type]??a[r.type]??null}function i(r){return F.getByPath(o.form.values.value,r.name)}function m(r,b){o.form.setField(r.name,b)}function f(r){var y;const b=o.form;(y=b.touchField)==null||y.call(b,r.name)}function g(r){return o.form.errors.value[r.name]??[]}function h(r){return o.form.touched.value[r.name]??!1}const v=e.computed(()=>(o.fields??o.form.fields.value).filter(r=>r.visible!==!1));async function l(r){r.preventDefault(),await o.form.submit(),n("submit")}return(r,b)=>{const y=e.resolveComponent("TailwindFormRenderer",!0);return e.openBlock(),e.createElementBlock("form",{novalidate:"",onSubmit:l},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(v.value,u=>(e.openBlock(),e.createElementBlock(e.Fragment,{key:u.name},[r.$slots[`field-${u.name}`]?e.renderSlot(r.$slots,`field-${u.name}`,{key:0,field:u,value:i(u),error:g(u),touched:h(u),setValue:p=>m(u,p),touch:()=>f(u)}):u.type==="group"?(e.openBlock(),e.createElementBlock("fieldset",me,[u.label?(e.openBlock(),e.createElementBlock("legend",fe,e.toDisplayString(u.label),1)):e.createCommentVNode("",!0),u.fields?(e.openBlock(),e.createBlock(y,{key:1,form:t.form,fields:u.fields,components:t.components},null,8,["form","fields","components"])):e.createCommentVNode("",!0)])):u.type==="array"?(e.openBlock(),e.createBlock(q,{key:2,field:u,form:t.form,components:t.components},null,8,["field","form","components"])):d(u)?(e.openBlock(),e.createBlock(e.resolveDynamicComponent(d(u)),{key:3,field:u,"model-value":i(u),error:g(u),touched:h(u),"onUpdate:modelValue":p=>m(u,p),onBlur:p=>f(u)},null,40,["field","model-value","error","touched","onUpdate:modelValue","onBlur"])):e.createCommentVNode("",!0)],64))),128)),e.renderSlot(r.$slots,"submit",{isSubmitting:t.form.isSubmitting.value,isValid:t.form.isValid.value},()=>[e.createElementVNode("button",{type:"submit",disabled:t.form.isSubmitting.value,class:"mt-2 rounded-lg bg-indigo-600 px-5 py-2 text-sm font-medium text-white transition hover:bg-indigo-500 disabled:cursor-not-allowed disabled:opacity-40"},e.toDisplayString(t.submitLabel??"Submit"),9,ge)])],32)}}});exports.TailwindFormRenderer=be;exports.TwArrayField=q;exports.TwCheckboxField=C;exports.TwDateField=N;exports.TwFileField=S;exports.TwNumberField=V;exports.TwRadioField=w;exports.TwSelectField=E;exports.TwTextField=B;exports.TwTextareaField=$;

package/dist/ui-tailwind.d.ts

@@ -0,0 +1,411 @@
+import { Component } from 'vue';
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { ComputedRef } from 'vue';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { Ref } from 'vue';
+
+declare const __VLS_component: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+submitLabel?: string;
+/**
+* Internal: the field list to render. Used by the `group` case to recurse
+* into `field.fields` instead of re-rendering the whole top-level schema
+* (which would recurse into the same group forever). Defaults to the
+* form's top-level fields — not meant to be passed by consumers.
+*/
+fields?: FieldDefinition[];
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+submit: () => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps<{
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+submitLabel?: string;
+/**
+* Internal: the field list to render. Used by the `group` case to recurse
+* into `field.fields` instead of re-rendering the whole top-level schema
+* (which would recurse into the same group forever). Defaults to the
+* form's top-level fields — not meant to be passed by consumers.
+*/
+fields?: FieldDefinition[];
+}>>> & Readonly<{
+onSubmit?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+declare type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_10<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_2<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_3<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_4<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_5<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_6<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_7<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_8<T> = T extends undefined ? never : T;
+
+declare type __VLS_NonUndefinedable_9<T> = T extends undefined ? never : T;
+
+declare function __VLS_template(): Partial<Record<`field-${string}`, (_: {
+    field: FieldDefinition;
+    value: unknown;
+    error: string[];
+    touched: boolean;
+    setValue: (v: unknown) => void;
+    touch: () => void;
+}) => any>> & {
+    submit?(_: {
+        isSubmitting: boolean;
+        isValid: boolean;
+    }): any;
+};
+
+declare type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_10<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_10<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_2<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_2<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_3<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_3<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_4<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_4<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_5<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_5<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_6<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_6<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_7<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_7<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_8<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_8<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_TypePropsToRuntimeProps_9<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: PropType<__VLS_NonUndefinedable_9<T[K]>>;
+    } : {
+        type: PropType<T[K]>;
+        required: true;
+    };
+};
+
+declare type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+declare type AsyncValidatorFn = (value: unknown, values: Record<string, unknown>) => Promise<string | null>;
+
+declare interface FieldDefinition {
+    type: FieldType;
+    /** Dot-path for nested fields, e.g. "address.city" */
+    name: string;
+    label?: string;
+    placeholder?: string;
+    defaultValue?: unknown | ((values: Record<string, unknown>) => unknown);
+    required?: boolean;
+    /** Static or dynamic disabled state */
+    disabled?: boolean | ((values: Record<string, unknown>) => boolean);
+    /** Static or dynamic visibility; string is evaluated as expression */
+    visible?: boolean | string | ((values: Record<string, unknown>) => boolean);
+    validators?: ValidatorFn[];
+    asyncValidators?: AsyncValidatorFn[];
+    mask?: string | MaskConfig;
+    /** For select / radio — static list, sync function, or async function */
+    options?: FieldOption[] | ((values: Record<string, unknown>) => FieldOption[] | Promise<FieldOption[]>);
+    /**
+     * Field names whose values trigger re-fetching of async options.
+     * Only relevant when `options` is an async function.
+     */
+    optionsDeps?: string[];
+    /** Internal: set by useForm when async options are loading. Read-only for consumers. */
+    optionsLoading?: boolean;
+    /** For group and array */
+    fields?: FieldDefinition[];
+    /**
+     * Applied on every setField call before the value is stored.
+     * Use for trimming, type coercion, formatting, etc.
+     */
+    transform?: (value: unknown, values: Record<string, unknown>) => unknown;
+    /**
+     * Applied at submit time to produce the final payload value.
+     * Runs after all validation passes.
+     */
+    parse?: (raw: unknown) => unknown;
+    /**
+     * Custom Vue component to render this field.
+     * Receives FormFieldProps and must emit 'update:modelValue' and 'blur'.
+     */
+    component?: Component | string;
+    /** Accepted file types, e.g. "image/*,.pdf" — passed to <input accept> */
+    accept?: string;
+    /** Allow selecting multiple files */
+    multiple?: boolean;
+    /** Maximum file size in bytes */
+    maxSize?: number;
+    /** Maximum number of files (only relevant when multiple=true) */
+    maxFiles?: number;
+}
+
+declare interface FieldOption {
+    label: string;
+    value: unknown;
+}
+
+declare type FieldType = 'text' | 'number' | 'email' | 'select' | 'checkbox' | 'radio' | 'textarea' | 'date' | 'array' | 'group' | 'file';
+
+declare interface MaskConfig {
+    preset?: MaskPreset;
+    /** Custom mask pattern: '#' = digit, 'A' = letter, other chars are literals */
+    pattern?: string;
+}
+
+declare type MaskPreset = 'phone-ru' | 'phone-eu' | 'date' | 'inn' | 'iban';
+
+export declare const TailwindFormRenderer: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+
+export declare const TwArrayField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_10<{
+field: FieldDefinition;
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_10<{
+field: FieldDefinition;
+form: UseFormReturn;
+components?: Partial<Record<FieldDefinition["type"], Component | string>>;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwCheckboxField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_6<{
+field: FieldDefinition;
+modelValue: boolean | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: boolean) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_6<{
+field: FieldDefinition;
+modelValue: boolean | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwDateField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_8<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_8<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwFileField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_9<{
+field: FieldDefinition;
+modelValue: File | File[] | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: File | File[] | null) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_9<{
+field: FieldDefinition;
+modelValue: File | File[] | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: File | File[] | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwNumberField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_3<{
+field: FieldDefinition;
+modelValue: number | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: number | null) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_3<{
+field: FieldDefinition;
+modelValue: number | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwRadioField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_7<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: unknown) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_7<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwSelectField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_5<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: unknown) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_5<{
+field: FieldDefinition;
+modelValue: unknown;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwTextareaField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_4<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_4<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+export declare const TwTextField: DefineComponent<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_2<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+blur: () => void;
+"update:modelValue": (value: string) => void;
+}, string, PublicProps, Readonly<ExtractPropTypes<__VLS_TypePropsToRuntimeProps_2<{
+field: FieldDefinition;
+modelValue: string | null;
+error?: string[];
+touched?: boolean;
+}>>> & Readonly<{
+onBlur?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
+
+declare interface UseFormReturn<T extends Record<string, unknown> = Record<string, unknown>> {
+    fields: ComputedRef<FieldDefinition[]>;
+    values: Ref<T>;
+    errors: Ref<Record<string, string[]>>;
+    touched: Ref<Record<string, boolean>>;
+    /** Per-field async options loading state */
+    optionsLoading: Ref<Record<string, boolean>>;
+    isDirty: ComputedRef<boolean>;
+    isValid: ComputedRef<boolean>;
+    isSubmitting: Ref<boolean>;
+    submit(): Promise<void>;
+    reset(values?: Partial<T>): void;
+    setField(path: string, value: unknown): void;
+    getField(path: string): unknown;
+}
+
+declare type ValidatorFn = (value: unknown, values: Record<string, unknown>) => string | null;
+
+export { }