@macrulez/vue-form-schema 0.1.7 → 0.2.0

package/dist/ui-shadcn.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 space-y-1.5"},R=["for"],A={key:0,class:"text-destructive ml-0.5","aria-hidden":"true"},P=["id"],g=e.defineComponent({__name:"BaseField",props:{field:{},error:{},touched:{type:Boolean}},setup(t){const s=t,o=e.computed(()=>{var d;return!!(s.touched&&((d=s.error)!=null&&d.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(d,i)=>(e.openBlock(),e.createElementBlock("div",D,[t.field.label?(e.openBlock(),e.createElementBlock("label",{key:0,for:t.field.name,class:"text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"},[e.createTextVNode(e.toDisplayString(t.field.label)+" ",1),t.field.required?(e.openBlock(),e.createElementBlock("span",A,"*")):e.createCommentVNode("",!0)],8,R)):e.createCommentVNode("",!0),e.renderSlot(d.$slots,"default",e.normalizeProps(e.guardReactiveProps(n.value))),o.value?(e.openBlock(),e.createElementBlock("ul",{key:1,id:c.value,class:"space-y-0.5",role:"alert","aria-live":"polite"},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(t.error,(a,m)=>(e.openBlock(),e.createElementBlock("li",{key:m,class:"text-destructive text-sm font-medium"},e.toDisplayString(a),1))),128))],8,P)):e.createCommentVNode("",!0)]))}}),L=["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 d=null;const i=e.computed(()=>{var a;return!!(o.touched&&((a=o.error)!=null&&a.length))});return e.onMounted(()=>{n.value&&o.field.mask&&(d=x.bindMask(n.value,o.field.mask))}),e.onUnmounted(()=>d==null?void 0:d()),(a,m)=>(e.openBlock(),e.createBlock(g,{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:["border-input placeholder:text-muted-foreground focus-visible:ring-ring flex h-9 w-full rounded-md border bg-transparent px-3 py-1 text-sm shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",i.value?"border-destructive focus-visible:ring-destructive":""],onInput:m[0]||(m[0]=b=>c("update:modelValue",b.target.value)),onBlur:m[1]||(m[1]=b=>c("blur"))}),null,16,L)]),_:1},8,["field","error","touched"]))}}),T=["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 i;return!!(o.touched&&((i=o.error)!=null&&i.length))});function d(i){const a=i.target.value;c("update:modelValue",a===""?null:Number(a))}return(i,a)=>(e.openBlock(),e.createBlock(g,{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:["border-input placeholder:text-muted-foreground focus-visible:ring-ring flex h-9 w-full rounded-md border bg-transparent px-3 py-1 text-sm shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-destructive focus-visible:ring-destructive":""],onInput:d,onBlur:a[0]||(a[0]=f=>c("blur"))}),null,16,T)]),_: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 d;return!!(o.touched&&((d=o.error)!=null&&d.length))});return(d,i)=>(e.openBlock(),e.createBlock(g,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(a=>[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},a,{class:["border-input placeholder:text-muted-foreground focus-visible:ring-ring flex min-h-[70px] w-full resize-y rounded-md border bg-transparent px-3 py-2 text-sm shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-destructive focus-visible:ring-destructive":""],onInput:i[0]||(i[0]=m=>c("update:modelValue",m.target.value)),onBlur:i[1]||(i[1]=m=>c("blur"))}),null,16,I)]),_:1},8,["field","error","touched"]))}}),M={key:0,class:"text-muted-foreground py-2 text-sm"},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:[]),d=e.computed(()=>{var a;return!!(o.touched&&((a=o.error)!=null&&a.length))});function i(a){const m=a.target,f=n.value.find(b=>String(b.value)===m.value);c("update:modelValue",(f==null?void 0:f.value)??m.value)}return(a,m)=>(e.openBlock(),e.createBlock(g,{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:["border-input focus-visible:ring-ring flex h-9 w-full rounded-md border bg-transparent px-3 py-1 text-sm shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",d.value?"border-destructive focus-visible:ring-destructive":""],onChange:i,onBlur:m[0]||(m[0]=b=>c("blur"))}),[e.createElementVNode("option",{value:"",disabled:"",selected:t.modelValue===null||t.modelValue===void 0||t.modelValue===""},e.toDisplayString(t.field.placeholder??"Select an option"),9,U),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(n.value,b=>(e.openBlock(),e.createElementBlock("option",{key:String(b.value),value:String(b.value),selected:t.modelValue===b.value},e.toDisplayString(b.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 leading-none"},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(g,{field:{...t.field,label:void 0},error:t.error,touched:t.touched},{default:e.withCtx(d=>[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"},d,{class:"border-primary text-primary focus-visible:ring-ring peer h-4 w-4 shrink-0 cursor-pointer rounded-sm border shadow focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",onChange:n[0]||(n[0]=i=>o("update:modelValue",i.target.checked)),onBlur:n[1]||(n[1]=i=>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:"text-sm font-medium leading-none"},Q={key:0,class:"text-destructive ml-0.5","aria-hidden":"true"},W={class:"space-y-2"},X=["name","value","checked","disabled","onChange"],Y={class:"text-sm leading-none"},Z=["id"],S=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 a;return!!(o.touched&&((a=o.error)!=null&&a.length))}),d=e.computed(()=>`${o.field.name}-error`),i=e.computed(()=>Array.isArray(o.field.options)?o.field.options:[]);return(a,m)=>(e.openBlock(),e.createElementBlock("fieldset",{class:"mb-4 space-y-2","aria-required":t.field.required?"true":void 0,"aria-invalid":n.value?"true":"false","aria-describedby":n.value?d.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(i.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:"border-primary text-primary focus-visible:ring-ring h-4 w-4 cursor-pointer focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",onChange:b=>c("update:modelValue",f.value),onBlur:m[0]||(m[0]=b=>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:d.value,class:"space-y-0.5",role:"alert","aria-live":"polite"},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(t.error,(f,b)=>(e.openBlock(),e.createElementBlock("li",{key:b,class:"text-destructive text-sm font-medium"},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 d;return!!(o.touched&&((d=o.error)!=null&&d.length))});return(d,i)=>(e.openBlock(),e.createBlock(g,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(a=>[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},a,{class:["border-input focus-visible:ring-ring flex h-9 w-full rounded-md border bg-transparent px-3 py-1 text-sm shadow-sm transition-colors focus-visible:outline-none focus-visible:ring-1 disabled:cursor-not-allowed disabled:opacity-50",n.value?"border-destructive focus-visible:ring-destructive":""],onInput:i[0]||(i[0]=m=>c("update:modelValue",m.target.value)),onBlur:i[1]||(i[1]=m=>c("blur"))}),null,16,_)]),_:1},8,["field","error","touched"]))}}),ee=["id","name","accept","multiple","disabled","required"],te={class:"text-muted-foreground pointer-events-none space-y-1 text-sm"},oe={key:0,class:"text-xs"},le={key:0,class:"mt-2 space-y-1"},re={class:"truncate"},ne={class:"text-muted-foreground ml-2 shrink-0 text-xs"},de=["aria-label","onClick"],w=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),d=e.ref(null),i=e.computed(()=>o.modelValue?Array.isArray(o.modelValue)?o.modelValue:[o.modelValue]:[]),a=e.computed(()=>o.field.multiple??!1);function m(r){if(!r||r.length===0){c("update:modelValue",null);return}c("update:modelValue",a.value?Array.from(r):r[0])}function f(r){m(r.target.files),c("blur")}function b(r){var l;n.value=!1,r.preventDefault(),m(((l=r.dataTransfer)==null?void 0:l.files)??null),c("blur")}function k(r){const l=i.value.filter((v,p)=>p!==r);l.length===0?(c("update:modelValue",null),d.value&&(d.value.value="")):c("update:modelValue",a.value?l:l[0])}function y(r){return r<1024?`${r} B`:r<1024*1024?`${(r/1024).toFixed(1)} KB`:`${(r/(1024*1024)).toFixed(1)} MB`}return(r,l)=>(e.openBlock(),e.createBlock(g,{field:t.field,error:t.error,touched:t.touched},{default:e.withCtx(v=>{var p;return[e.createElementVNode("div",{class:e.normalizeClass(["border-input relative rounded-md border border-dashed p-6 text-center transition-colors",n.value?"border-ring bg-accent":t.touched&&((p=t.error)!=null&&p.length)?"border-destructive":"hover:border-ring/60"]),onDragover:l[0]||(l[0]=e.withModifiers(u=>n.value=!0,["prevent"])),onDragleave:l[1]||(l[1]=u=>n.value=!1),onDrop:b},[e.createElementVNode("input",e.mergeProps({id:t.field.name,ref_key:"inputRef",ref:d,type:"file",name:t.field.name,accept:t.field.accept,multiple:a.value,disabled:t.field.disabled===!0,required:t.field.required},v,{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,[e.createElementVNode("p",null,e.toDisplayString(n.value?"Drop files here":"Click to upload or drag & drop"),1),t.field.accept?(e.openBlock(),e.createElementBlock("p",oe,e.toDisplayString(t.field.accept),1)):e.createCommentVNode("",!0)])],34),i.value.length?(e.openBlock(),e.createElementBlock("ul",le,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(i.value,(u,h)=>(e.openBlock(),e.createElementBlock("li",{key:`${u.name}-${h}`,class:"border-input flex items-center justify-between rounded-md border px-3 py-2 text-sm"},[e.createElementVNode("span",re,e.toDisplayString(u.name),1),e.createElementVNode("span",ne,e.toDisplayString(y(u.size)),1),e.createElementVNode("button",{type:"button","aria-label":`Remove ${u.name}`,class:"text-muted-foreground hover:text-destructive ml-2 shrink-0 transition-colors",onClick:ve=>k(h)}," × ",8,de)]))),128))])):e.createCommentVNode("",!0)]}),_:1},8,["field","error","touched"]))}}),ie={class:"mb-4"},ae={key:0,class:"mb-2 text-sm font-medium leading-none"},ue={class:"flex-1 space-y-0"},ce=["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:S,date:N};function n(r){var l;return r.component?r.component:((l=s.components)==null?void 0:l[r.type])??o[r.type]??c[r.type]??null}const{rows:d,append:i,remove:a}=x.useFieldArray(s.form,s.field.name);function m(r){return F.getByPath(s.form.values.value,r.name)}function f(r,l){s.form.setField(r.name,l)}function b(r){var v;const l=s.form;(v=l.touchField)==null||v.call(l,r.name)}function k(r){return s.form.errors.value[r.name]??[]}function y(r){return s.form.touched.value[r.name]??!1}return(r,l)=>(e.openBlock(),e.createElementBlock("div",ie,[t.field.label?(e.openBlock(),e.createElementBlock("div",ae,e.toDisplayString(t.field.label),1)):e.createCommentVNode("",!0),(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(e.unref(d),v=>(e.openBlock(),e.createElementBlock("div",{key:v.key,class:"border-input bg-card mb-2 flex items-start gap-2 rounded-md border p-3"},[e.createElementVNode("div",ue,[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(v.fields,p=>(e.openBlock(),e.createElementBlock(e.Fragment,{key:p.name},[n(p)?(e.openBlock(),e.createBlock(e.resolveDynamicComponent(n(p)),{key:0,field:p,"model-value":m(p),error:k(p),touched:y(p),"onUpdate:modelValue":u=>f(p,u),onBlur:u=>b(p)},null,40,["field","model-value","error","touched","onUpdate:modelValue","onBlur"])):e.createCommentVNode("",!0)],64))),128))]),e.createElementVNode("button",{type:"button",class:"text-muted-foreground hover:text-destructive mt-7 shrink-0 rounded px-2 py-1 text-xs transition-colors",onClick:p=>e.unref(a)(v.index)}," Remove ",8,ce)]))),128)),e.createElementVNode("button",{type:"button",class:"border-input hover:border-ring hover:text-foreground text-muted-foreground mt-1 rounded-md border border-dashed px-4 py-2 text-sm transition-colors",onClick:l[0]||(l[0]=v=>e.unref(i)())}," + Add row ")]))}}),se={key:1,class:"border-input mb-4 rounded-md border p-4"},me={key:0,class:"px-1 text-sm font-medium leading-none"},fe=["disabled"],be=e.defineComponent({__name:"ShadcnFormRenderer",props:{form:{},components:{},submitLabel:{},fields:{}},emits:["submit"],setup(t,{emit:s}){const o=t,c=x.useRegistry(),n=s,d={text:B,email:B,number:V,textarea:$,select:E,checkbox:C,radio:S,date:N,file:w};function i(l){var v;return l.component?l.component:((v=o.components)==null?void 0:v[l.type])??c[l.type]??d[l.type]??null}function a(l){return F.getByPath(o.form.values.value,l.name)}function m(l,v){o.form.setField(l.name,v)}function f(l){var p;const v=o.form;(p=v.touchField)==null||p.call(v,l.name)}function b(l){return o.form.errors.value[l.name]??[]}function k(l){return o.form.touched.value[l.name]??!1}const y=e.computed(()=>(o.fields??o.form.fields.value).filter(l=>l.visible!==!1));async function r(l){l.preventDefault(),await o.form.submit(),n("submit")}return(l,v)=>{const p=e.resolveComponent("ShadcnFormRenderer",!0);return e.openBlock(),e.createElementBlock("form",{novalidate:"",onSubmit:r},[(e.openBlock(!0),e.createElementBlock(e.Fragment,null,e.renderList(y.value,u=>(e.openBlock(),e.createElementBlock(e.Fragment,{key:u.name},[l.$slots[`field-${u.name}`]?e.renderSlot(l.$slots,`field-${u.name}`,{key:0,field:u,value:a(u),error:b(u),touched:k(u),setValue:h=>m(u,h),touch:()=>f(u)}):u.type==="group"?(e.openBlock(),e.createElementBlock("fieldset",se,[u.label?(e.openBlock(),e.createElementBlock("legend",me,e.toDisplayString(u.label),1)):e.createCommentVNode("",!0),u.fields?(e.openBlock(),e.createBlock(p,{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"])):i(u)?(e.openBlock(),e.createBlock(e.resolveDynamicComponent(i(u)),{key:3,field:u,"model-value":a(u),error:b(u),touched:k(u),"onUpdate:modelValue":h=>m(u,h),onBlur:h=>f(u)},null,40,["field","model-value","error","touched","onUpdate:modelValue","onBlur"])):e.createCommentVNode("",!0)],64))),128)),e.renderSlot(l.$slots,"submit",{isSubmitting:t.form.isSubmitting.value,isValid:t.form.isValid.value},()=>[e.createElementVNode("button",{type:"submit",disabled:t.form.isSubmitting.value,class:"bg-primary text-primary-foreground hover:bg-primary/90 mt-2 inline-flex h-9 items-center justify-center rounded-md px-4 py-2 text-sm font-medium shadow transition-colors disabled:pointer-events-none disabled:opacity-50"},e.toDisplayString(t.submitLabel??"Submit"),9,fe)])],32)}}});exports.ShArrayField=q;exports.ShCheckboxField=C;exports.ShDateField=N;exports.ShFileField=w;exports.ShNumberField=V;exports.ShRadioField=S;exports.ShSelectField=E;exports.ShTextField=B;exports.ShTextareaField=$;exports.ShadcnFormRenderer=be;

package/dist/ui-shadcn.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 ShadcnFormRenderer: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+
+export declare const ShArrayField: 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 ShCheckboxField: 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 ShDateField: 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 ShFileField: 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 ShNumberField: 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 ShRadioField: 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 ShSelectField: 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 ShTextareaField: 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 ShTextField: 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 { }