vue-formless 0.0.1 → 0.1.0

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("vue"),N=Symbol("vue-formless.formContext");function Y(){const e=l.inject(N,null);if(!e)throw new Error("[vue-formless] useFormContext() must be used inside <FormView>.");return e}function D(e){if(!e)return[];const t=[];let o=0;for(;o<e.length;){if(e[o]==="."){o++;continue}if(e[o]==="["){const n=e.indexOf("]",o+1);if(n===-1)throw new Error(`Invalid path "${e}": unclosed bracket`);const r=e.slice(o+1,n),s=Number(r);if(!Number.isInteger(s)||String(s)!==r||s<0)throw new Error(`Invalid path "${e}": index must be a non-negative integer`);t.push({type:"index",index:s}),o=n+1}else{const n=/^[a-zA-Z_$][a-zA-Z0-9_$]*/.exec(e.slice(o));if(!n)throw new Error(`Invalid path "${e}" at position ${o}`);t.push({type:"key",key:n[0]}),o+=n[0].length}}return t}function Ne(e,t){let o=e;for(const n of t)n.type==="key"?o=o[n.key]:o=o[n.index];return o}function _e(e,t){if(t.type==="key")return e==null||typeof e!="object"||Array.isArray(e)?void 0:e[t.key];if(Array.isArray(e))return e[t.index]}function k(e,t){const o=D(t);if(o.length===0)return;const n=o[o.length-1],r=Ne(e,o.slice(0,-1));return _e(r,n)}function J(e,t,o,n){const r=t[o],s=o===t.length-1;if(r.type==="key"){if(Array.isArray(e))throw new Error(`Cannot set "${r.key}" on an array node`);const i=e!=null&&typeof e=="object"?e:{};return s?{...i,[r.key]:n}:{...i,[r.key]:J(i[r.key],t,o+1,n)}}const u=Array.isArray(e)?[...e]:[];return s?(u[r.index]=n,u):(u[r.index]=J(u[r.index],t,o+1,n),u)}function we(e,t,o){const n=D(t);if(n.length===0)throw new Error("Cannot set an empty prop");return J(e,n,0,o)}function ye(e){return D(e).map(t=>t.type==="key"?t.key:String(t.index)).join(".")}function Me(e,t){let o=null;function n(r,s){o||(o=[],l.nextTick(()=>{if(!o?.length){o=null;return}let u=e();for(const i of o)u=we(u,i.prop,i.value);o=null,t(u)})),o.push({prop:r,value:s})}return{update:n}}const p=24,V={column:1};function Te(e){const t=Math.floor(Number(e));return t===1/0?p:Number.isFinite(t)?Math.min(p,Math.max(1,t)):V.column}function Be(...e){return Te(e.find(t=>t!=null)??V.column)}function Ue(e,t){const o=t>0?t:V.column,n=Math.max(1,Math.floor(p/o));if(e==null||e==="")return n;if(typeof e=="number")return ce(e),e;const r=e.trim();if(r==="max")return p;const s=/^(\d+)x$/.exec(r);if(s){const u=Number(s[1]);if(u<1)throw new Error(`[vue-formless] col:span "${e}" is invalid`);return Math.min(p,u*n)}if(/^\d+$/.test(r)){const u=Number(r);return ce(u),u}throw new Error(`[vue-formless] col:span "${e}" is invalid`)}function ce(e){if(!Number.isInteger(e)||e<1||e>p)throw new Error(`[vue-formless] col:span ${e} must be an integer 1–${p}`)}function We(e){if(e==null||e===""||e==="auto")return"auto";if(e==="start"||e==="end")return e;throw new Error(`[vue-formless] col:place "${String(e)}" is invalid`)}const W=Symbol("vue-formless:layout-view");function Ge(e,t,o={childList:!0}){if(typeof MutationObserver>"u")return;let n=null;function r(u){n?.disconnect(),n=null,u&&(n=new MutationObserver(t),n.observe(u,o))}l.onMounted(()=>r(l.toValue(e)));const s=l.watch(()=>l.toValue(e),r,{flush:"post"});l.onBeforeUnmount(()=>{s(),n?.disconnect(),n=null})}function Ye(e,t=0){const o=l.ref([]);function n(){const r=l.toValue(e);o.value=r?Array.from(r.children):[]}return l.watch(()=>[l.toValue(e),l.toValue(t)],n,{immediate:!0}),Ge(e,n),o}function De(e,t,o){const n=[];if(o==="auto")return e.n+t>p&&(e.n=0),n;if(o==="start")return e.n>0&&(n.push(p-e.n),e.n=0),n;e.n+t>p&&e.n>0&&(n.push(p-e.n),e.n=0);const r=p-e.n-t;return r>0&&(n.push(r),e.n+=r),n}function ze(e){return l.computed(()=>{const t={n:0},o=new Map;for(const n of l.toValue(e)){const r=De(t,n.span,n.place);o.set(n.id,r),t.n+=n.span}return o})}function ge(e){if(e==null||typeof e!="object")return null;if(typeof Element<"u"&&e instanceof Element)return e;const t=e;return U(t.vnode?.el)??U(t.subTree?.el)??U(t.subTree?.component?.vnode?.el)??U(t.$el)}function U(e){if(typeof Element<"u"&&e instanceof Element)return e;if(e&&e.nodeType===8){for(let t=e.nextSibling;t;t=t.nextSibling)if(typeof Element<"u"&&t instanceof Element)return t}return null}const Ke=l.defineComponent({name:"LayoutBlanks",inheritAttrs:!1,props:{is:{type:Object,default:void 0},spans:{type:Array,required:!0}},setup(e){return()=>{if(e.spans.length===0||e.is==null)return null;const t=e.is;return l.createVNode(l.Fragment,null,[e.spans.map((o,n)=>l.createVNode(t,{key:n,span:o},null))])}}}),qe=l.defineComponent({name:"LayoutItem",inheritAttrs:!1,props:{span:{type:[String,Number],default:void 0},place:{type:String,default:void 0}},setup(e,{slots:t}){const o=l.inject(W,null);if(!o)return()=>t.default?.()??null;const{span:n,blanks:r,itemRef:s,Col:u,disabled:i}=o(()=>e.span,()=>e.place);return()=>{if(i.value)return t.default?.()??null;const f=u;return l.createVNode(l.Fragment,null,[l.createVNode(Ke,{is:u,spans:r.value},null),l.createVNode(f,{ref:s,span:n.value},{default:()=>[t.default?.()??null]})])}}}),He=l.defineComponent({name:"LayoutItemPassThrough",inheritAttrs:!1,setup(e,{slots:t}){return()=>t.default?.()??null}});function he(){return l.inject(W,null)?qe:He}function Xe(e){const t=l.ref({});let o=0;return{get value(){return t.value},setup(n,r){const s=String(++o),u=l.computed(()=>Ue(l.toValue(n),l.toValue(e))),i=l.computed(()=>We(l.toValue(r)));return t.value[s]={span:u,place:i,el:null,mounted:!1},l.onMounted(()=>{const f=t.value[s];f&&(f.mounted=!0)}),l.onBeforeUnmount(()=>{delete t.value[s]}),s},span(n){return t.value[n]?.span??0},ref(n,r){const s=t.value[n];if(!s)return;const u=ge(r);s.el!==u&&(s.el=u)}}}function Ze(e,t){const o=new Map(Object.entries(e).filter(([,n])=>n.el).map(([n,r])=>[r.el,{id:n,span:r.span,place:r.place}]));return t.filter(n=>o.has(n)).map(n=>o.get(n))}function Je(e,t){const o=Ye(()=>ge(t.value),()=>Object.keys(e.value).filter(n=>e.value[n].mounted).join(","));return ze(()=>Ze(e.value,o.value))}function ne(e={}){const{Row:t,Col:o}=e;return l.defineComponent({name:"LayoutView",inheritAttrs:!1,props:{disabled:{type:Boolean,default:!1},column:{type:Number,default:void 0}},setup(n,{slots:r,attrs:s}){const u=l.computed(()=>!t||!o||n.disabled),i=Xe(()=>Be(n.column,e.column)),f=l.ref(null),a=Je(i,f);return l.provide(W,(m,g)=>{l.provide(W,null);const w=i.setup(m,g);return{span:l.computed(()=>i.span(w)),blanks:l.computed(()=>a.value.get(w)??[]),itemRef:b=>i.ref(w,b),Col:o,disabled:u}}),()=>{if(u.value)return r.default?.()??null;const m=t;return l.createVNode(m,l.mergeProps({ref:f},s),{default:()=>[r.default?.()??null]})}}})}const Qe=new Set(["item","layout","model","span"]),et=new Set(["component","props","model","prop","item","layout"]);function Q(e){const t={};for(const[o,n]of Object.entries(e))n!==void 0&&(t[o]=n);return t}function oe(e){const t={};for(const[o,n]of Object.entries(e))o==="span"&&n!==void 0&&console.warn("[vue-formless] fl:span is removed; use col:span"),Qe.has(o)||(t[o]=n);return t}function tt(e){const t={};for(const[o,n]of Object.entries(e))!et.has(o)&&n!==void 0&&(t[o]=n);return t}function nt(e){if(e==null||typeof e!="object")return{};const t=e.formless;if(t==null||typeof t!="object")return{};const{model:o,item:n}=t;return Q({model:o,item:n})}function ve(e){const t={};for(const[o,n]of Object.entries(e))!o.startsWith("fl:")||o.length<=3||n===void 0||(t[o.slice(3)]=n);return t}function ot(e,t){const o=new Set;for(const r of t)o.add(r),o.add(`onUpdate:${r}`);const n={};for(const[r,s]of Object.entries(e))o.has(r)||(n[r]=s);return n}function $(e,t){return e==null?{}:Q(typeof e=="function"?e(t)??{}:e)}function z(...e){const t={};for(const o of e)if(o!=null)for(const[n,r]of Object.entries(o))r!==void 0&&(t[n]=r);return t}function rt(e){const t=e.Item?l.markRaw(e.Item):void 0;return(o,n)=>t&&n.item!==!1&&(n.item===!0||(e.isItemEnabled?.()??!0))?l.h(t,z($(e.itemProps,n.fl),n.itemAttrs,n.itemOn),{...n.itemSlots,default:()=>o}):o}function ee(e){return typeof e=="string"?[e]:[...e]}function re(e,t={},o={}){if(o.prop==="")throw new Error(`[vue-formless] fl:prop cannot be an empty string (control "${e}")`);if(t.prop==="")throw new Error(`[vue-formless] prop cannot be an empty string (control "${e}")`);const n=ee(t.model??"modelValue"),r=ee(o.prop!==void 0?o.prop:t.prop??e);if(r.length>n.length)throw new Error(`createFormControls: prop cannot be longer than model (control "${e}": model has ${n.length}, prop has ${r.length})`);if(r.some(s=>s===""))throw new Error(`[vue-formless] prop cannot be an empty string (control "${e}")`);return{models:n,props:r}}function lt(e,t){return e.props.length===1?ye(e.props[0]):t}function be(e,t){const o=e.models.indexOf(t);if(o===-1)throw new Error(`[vue-formless] useFormItem("${t}"): not a v-model port of this control`);const n=e.props[o];if(n===void 0)throw new Error(`[vue-formless] useFormItem("${t}"): port is not bound to a prop`);return{models:[t],props:[n]}}function le(e,t,o){const n={};for(let r=0;r<t.props.length;r++){const s=t.models[r],u=t.props[r];n[s]=k(e,u),n[`onUpdate:${s}`]=i=>{o(u,i)}}return n}const O="item:",q="onItem:",H="fl:",X="row:",Z="col:",st=new Set(["column","gutter"]),ut=new Set(["span","place"]);function fe(e){console.warn(e)}function Ie(e){const t={},o={};for(const n of Object.keys(e)){const r=e[n];r&&(n.startsWith(O)&&n.length>O.length?t[n.slice(O.length)]=r:o[n]=r)}return{itemSlots:t,inputSlots:o}}function Ce(e){const t={},o={};for(const[n,r]of Object.entries(e))n.startsWith(H)&&n.length>H.length?t[n.slice(H.length)]=r:o[n]=r;return{fl:t,rest:o}}function Fe(e){const t={},o={},n={};for(const[r,s]of Object.entries(e))if(r.startsWith(X)&&r.length>X.length){const u=r.slice(X.length);st.has(u)?t[u]=s:fe(`[vue-formless] unknown row:${u} is ignored`)}else if(r.startsWith(Z)&&r.length>Z.length){const u=r.slice(Z.length);ut.has(u)?o[u]=s:fe(`[vue-formless] unknown col:${u} is ignored`)}else n[r]=s;return{row:t,col:o,rest:n}}function me(e){if(e==null||e==="")return;const t=typeof e=="number"?e:Number(e);if(Number.isFinite(t))return t}function Ee(e){const t={},o={},n={};for(const[r,s]of Object.entries(e))r.startsWith(q)&&r.length>q.length?o[it(r.slice(q.length))]=s:r.startsWith(O)&&r.length>O.length?t[r.slice(O.length)]=s:n[r]=s;return{itemAttrs:t,itemOn:o,inputAttrs:n}}function it(e){const t=e.indexOf(":");return t===-1?`on${de(e)}`:`on${de(e.slice(0,t))}:${e.slice(t+1)}`}function de(e){return e&&e.charAt(0).toUpperCase()+e.slice(1)}const Ve=Symbol("vue-formless.controlRuntime");function at(e){l.provide(Ve,e)}const ct={"fl:prop":{type:[String,Array],default:void 0},"col:span":{type:[String,Number],default:void 0},"col:place":{type:String,default:void 0}};function Se(e){return l.defineComponent({name:e?`FormViewItem_${e}`:"FormViewItem",inheritAttrs:!1,props:ct,setup(t,{slots:o,attrs:n}){const r=Y(),s=he(),u=l.inject(Ve,null);if(e!=null&&!u)throw new Error("[vue-formless] useFormItem(port) must be used inside a namespaced control.");return()=>ft(r,s,u,e,o,n,t)}})}const se=Se();function Ae(e){return Y(),e===void 0?se:Se(e)}function ft(e,t,o,n,r,s,u){const{fl:i,rest:f}=Ce(s),{row:a,col:m,rest:g}=Fe(f),w={...i,...ve(u)},{itemAttrs:b,itemOn:v,inputAttrs:S}=Ee(g),I={...b,...S},{itemSlots:y}=Ie(r),d=n==null&&o!=null,C=u["col:span"]??m.span,A=u["col:place"]??m.place,c=o?.getFrame(),L=C??(d?c?.colSpan:void 0),x=A??(d?c?.colPlace:void 0),_=mt(e,o,n,w),M=le(e.model,_.binding,e.update),K=r.default?.({field:M})??null;!d&&(a.column!=null||a.gutter!=null)&&console.warn("[vue-formless] :row:* is ignored on a leaf cell");let F=I,E=v,T=y;d&&c&&(F={...c.itemAttrs,...I},E={...c.itemOn,...v},T={...c.itemSlots,...y});let R,B,P=!1;d&&c&&(R=c.wrapItem,B=c.wrapCol,P=c.extraRow);let h=K;if(P&&c){const j=h;h=l.h(e.LayoutView,{disabled:!e.isLayoutEnabled(),column:c.rowColumn??e.factoryColumn,gutter:c.rowGutter??e.factoryGutter},()=>j)}if(h=e.wrap(h,{item:R===!1?!1:R===!0?!0:void 0,fl:_.fl,itemAttrs:F,itemOn:E,itemSlots:T}),B!==!1){const j=h;h=l.h(t,{span:L,place:x},()=>j)}return h}function mt(e,t,o,n){const r=oe(n);if(t){const a=t.getFrame(),m=o!=null?be(a.binding,o):a.binding,g={...a.fl,...r,controlKey:t.controlKey,binding:m,getValues:()=>m.props.map(w=>k(e.model,w))};return{binding:m,fl:g}}const s=n.prop;if(s==="")throw new Error("[vue-formless] fl:prop cannot be an empty string");const u=typeof s=="string"?s:Array.isArray(s)&&s[0]?String(s[0]):"",i=s===void 0?{models:["modelValue"],props:[]}:re(u||"field",{prop:s}),f={...r,controlKey:u,binding:i,getValues:()=>i.props.map(a=>k(e.model,a))};return{binding:i,fl:f}}function Le(e){const t=e;return t.Item=se,t}const te=0;function dt(e){return new Proxy({},{get(t,o){const n=e.value;if(n==null)return;const r=Reflect.get(n,o,n);return typeof r=="function"?r.bind(n):r},has(t,o){return e.value!=null&&o in e.value}})}const Oe={modelValue:{type:[Object,Array],default:void 0},"fl:layout":{type:Boolean,default:!1},"row:column":{type:Number,default:void 0},"row:gutter":{type:Number,default:void 0},"fl:form":{type:[Boolean,String],default:"auto"},"fl:item":{type:Boolean,default:!0}},ke={"update:modelValue":e=>!0};function G(e){if(e!=null&&typeof e=="object")throw new Error("[vue-formless] fl:layout is boolean only; use :row:column / :row:gutter");return e===!0||e===""}function pt(e,t){return e===!0||e===!1?e:!t}function wt(e){return e==null?!1:"modelValue"in e||"model-value"in e||"onUpdate:modelValue"in e||"onUpdate:model-value"in e}function xe(e){const t=rt({Item:e.Item,itemProps:e.itemProps,isItemEnabled:e.isItemEnabled}),o=e.isItemEnabled??(()=>!0);l.provide(N,l.reactive({get model(){return e.getModel()},update:e.update,wrap:t,isItemEnabled:o,isLayoutEnabled:e.isLayoutEnabled,LayoutView:l.markRaw(e.LayoutView),factoryColumn:e.factoryColumn,factoryGutter:e.factoryGutter}))}function Re(e,t){const o=l.inject(N,null);if(wt(l.getCurrentInstance()?.vnode.props)){const r=Me(e,t);return{getModel:e,update:r.update}}if(o)return{getModel:()=>o.model,update:o.update};throw new Error("[vue-formless] FormView requires v-model unless nested inside another FormView.")}function yt(e){if(e!=null){if(e.Row==null||e.Col==null)throw new Error("[vue-formless] createFormView layout requires both Row and Col.");return{Row:l.markRaw(e.Row),Col:l.markRaw(e.Col),column:e.column,gutter:e.gutter}}}function gt(e={}){const t=yt(e.layout),o=e.form?.component?l.markRaw(e.form.component):void 0,n=e.form?.props,r=e.item?.component?l.markRaw(e.item.component):void 0,s=e.item?.props,u=ne(t?{Row:t.Row,Col:t.Col}:{}),i=t?.column??V.column,f=t?.gutter??te;return Le(l.defineComponent({name:"FormView",inheritAttrs:!1,props:Oe,emits:ke,setup(a,{slots:m,emit:g,attrs:w,expose:b}){const v=l.ref(null);b(dt(v));const S=l.inject(N,null)!=null,{getModel:I,update:y}=Re(()=>a.modelValue,d=>g("update:modelValue",d));return xe({getModel:I,update:y,Item:r,itemProps:s,isItemEnabled:()=>a["fl:item"]!==!1,isLayoutEnabled:()=>G(a["fl:layout"]),LayoutView:u,factoryColumn:i,factoryGutter:f}),()=>{const d=m.default?.()??null,C=G(a["fl:layout"]),A={column:a["row:column"]??i,gutter:a["row:gutter"]??f},c=l.h(u,{disabled:!C,column:A.column,gutter:A.gutter},()=>d),L=o?pt(a["fl:form"],S):!1;if(!o||!L)return c;const x={layout:C,form:L,item:a["fl:item"]!==!1,modelValue:I()};return l.h(o,{ref:v,...z($(n,x),w)},{default:()=>c})}}}))}const pe=ne(),ht=Le(l.defineComponent({name:"FormView",inheritAttrs:!1,props:Oe,emits:ke,setup(e,{slots:t,emit:o}){const{getModel:n,update:r}=Re(()=>e.modelValue,s=>o("update:modelValue",s));return xe({getModel:n,update:r,isLayoutEnabled:()=>G(e["fl:layout"]),LayoutView:pe,factoryColumn:V.column,factoryGutter:te}),()=>l.h(pe,{disabled:!G(e["fl:layout"]),column:e["row:column"]??V.column,gutter:e["row:gutter"]??te},()=>t.default?.()??null)}}));function ue(e){return e&&e.charAt(0).toUpperCase()+e.slice(1)}function vt(e){return e&&e.charAt(0).toLowerCase()+e.slice(1)}function Pe(e,t){if(e==="self"&&t===!1||e===!1&&t==="self")throw new Error('[vue-formless] formless.item "self" conflicts with schema item: false');return e??t}function je(e){const t=e.internalItem==="self";let o;e.tagItem===!0?o=!0:e.tagItem===!1||t||e.internalItem===!1?o=!1:e.internalItem===!0?o=!0:o=e.pageItem;let n=e.pageLayoutOn;t&&e.tagItem!==!0&&(o=!1,n=!1);const r=t&&e.tagItem===!0&&e.pageLayoutOn;return{wrapItem:o,wrapCol:n,extraRow:r,self:t}}const bt={"fl:prop":{type:[String,Array],default:void 0},"fl:item":{type:Boolean,default:void 0},"col:span":{type:[String,Number],default:void 0},"col:place":{type:String,default:void 0},"row:column":{type:Number,default:void 0},"row:gutter":{type:Number,default:void 0}};function It(e,t){const o=Et(e),n={};for(const r of Object.keys(o)){const s=o[r];if(!s)continue;const u=ue(r);n[u]=Ct(r,s,t)}return n}function Ct(e,t,o){const n=nt(t.component),r=n.model??t.model,s=Pe(n.item,t.item);return l.defineComponent({name:`Control_${ue(e)}`,inheritAttrs:!1,props:bt,setup(u,{attrs:i,slots:f}){const a=Y();let m;at({controlKey:e,getFrame:()=>m});const g=Ae();return()=>{const{fl:w,rest:b}=Ce(i),{row:v,col:S,rest:I}=Fe(b),y={...w,...ve(u)},d=re(e,{model:r,prop:t.prop},{prop:y.prop}),C=t.component,{itemSlots:A,inputSlots:c}=Ie(f),{itemAttrs:L,itemOn:x,inputAttrs:_}=Ee(I),M=tt(t),K=y.item===!0?!0:y.item===!1?!1:void 0,F=je({pageItem:a.isItemEnabled(),pageLayoutOn:a.isLayoutEnabled(),internalItem:s,tagItem:K}),E=Ft(a,e,d,M,y),T=z($(o?.props,E),$(t.props,E),ot(_,d.models)),R=le(a.model,d,a.update),B=d.props[0]??e,P=typeof E.label=="string"?E.label:void 0,h=u["col:span"]??S.span,j=u["col:place"]??S.place,ie=me(u["row:column"]??v.column),ae=me(u["row:gutter"]??v.gutter);!F.extraRow&&(ie!=null||ae!=null)&&console.warn("[vue-formless] :row:* is ignored on a leaf control");const $e=C?l.h(C,{...T,...R},c):l.h("div",{class:"vue-formless-control","data-control":e},[P?l.h("label",{class:"vue-formless-control__label"},String(P)):null,String(k(a.model,B)??"")]);return m={fl:{...M,...oe(y)},binding:d,wrapItem:F.wrapItem,wrapCol:F.wrapCol,extraRow:F.extraRow,colSpan:h,colPlace:j,rowColumn:ie,rowGutter:ae,itemAttrs:L,itemOn:x,itemSlots:A},l.h(g,null,()=>$e)}}})}function Ft(e,t,o,n,r){return{...n,...oe(r),controlKey:t,binding:o,getValues:()=>o.props.map(s=>k(e.model,s))}}function Et(e){const t={...e};for(const o of Object.keys(t)){const n=t[o];n&&(t[o]={...n,component:n.component&&typeof n.component=="object"?l.markRaw(n.component):n.component})}return t}exports.DEFAULT_LAYOUT=V;exports.FormView=ht;exports.FormViewItem=se;exports.GRID_TOTAL=p;exports.applyControlBinding=le;exports.bindingForPort=be;exports.camelToPascal=ue;exports.createFormControls=It;exports.createFormView=gt;exports.createLayoutView=ne;exports.formContextKey=N;exports.formItemProp=ye;exports.getIn=k;exports.mergeInternalItem=Pe;exports.overlayProps=z;exports.parsePath=D;exports.pascalToCamel=vt;exports.resolveControlBinding=re;exports.resolveControlShell=je;exports.resolveFormItemProp=lt;exports.resolveProps=$;exports.setIn=we;exports.toBindingList=ee;exports.useFormContext=Y;exports.useFormItem=Ae;exports.useLayoutItem=he;

package/dist/index.d.ts

@@ -1 +1,561 @@
+import { AllowedComponentProps } from 'vue';
+import { Component } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentOptionsBase } from 'vue';
+import { ComponentOptionsMixin } from 'vue';
+import { ComponentProvideOptions } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { DefineComponent } from 'vue';
+import { ExtractPropTypes } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
+import { InjectionKey } from 'vue';
+import { PropType } from 'vue';
+import { PublicProps } from 'vue';
+import { Slot } from 'vue';
+import { VNodeChild } from 'vue';
+import { VNodeProps } from 'vue';
+
+export declare function applyControlBinding(formModel: unknown, binding: ResolvedControlBinding, update: (prop: string, value: unknown) => void): Record<string, unknown>;
+
+/** Slice a multi-port binding to one v-model port (ADR-013 `useFormItem('start')`). */
+export declare function bindingForPort(binding: ResolvedControlBinding, port: string): ResolvedControlBinding;
+
+export declare type CamelToPascal<S extends string> = S extends `${infer F}${infer R}` ? `${Uppercase<F>}${R}` : S;
+
+/** `name` → `Name`, `idCard` → `IdCard` */
+export declare function camelToPascal(key: string): string;
+
+export declare type ColPlace = 'auto' | 'start' | 'end';
+
+/** Author-facing Col width: omit / `'Nx'` / `'max'` / absolute 1–24. */
+export declare type ColSpanSpec = string | number;
+
+/**
+ * Public `$props` of a Vue constructor, functional component, or SFC.
+ * `never` / omitted widgets yield `{}` (`never extends Constructor` is true in TS).
+ */
+export declare type ComponentPublicProps<C> = [C] extends [never] ? {} : [C] extends [undefined] ? {} : C extends abstract new (...args: any) => {
+    $props: infer P;
+} ? P : C extends (props: infer P, ...args: any) => unknown ? P : C extends {
+    $props: infer P;
+} ? P : {};
+
+export declare interface ControlBindingOverrides {
+    prop?: ControlProp;
+}
+
+export declare type ControlItemSetting = boolean | 'self';
+
+export declare type ControlProp = string | readonly string[];
+
+/**
+ * Control identity. Adapter extras (e.g. `label`) via `declare module 'vue-formless'`.
+ * Extra keys become `ItemFl` fields and optional `fl:*` tag props.
+ */
+export declare interface ControlSchema {
+    /**
+     * Input widget only (no FormItem). Receives v-model bindings from formless.
+     * Widget may also declare static `formless: { model, item }`.
+     */
+    component?: Component;
+    /** Input defaults: static object, or derived from the cell snapshot. */
+    props?: HostProps<ItemFl>;
+    /**
+     * v-model names on the widget (ADR-011). Default `'modelValue'`.
+     * Locked with the component; tag cannot override. Prefer widget `formless.model`.
+     */
+    model?: ControlVModel;
+    /**
+     * Location(s) from FormView root (ADR-011). Default: control key.
+     * Overridable via `:fl:prop`. Empty string is illegal.
+     * Nested: `buyers[0].name`, `` `buyers[${$index}].name` ``.
+     */
+    prop?: ControlProp;
+    /**
+     * Outer wrap: FormView default, then this, then tag `:fl:item`.
+     * `'self'`: widget lays out cells via `useFormItem(port)` (ADR-017).
+     */
+    item?: boolean | 'self';
+}
+
+/** Adapter fields on ControlSchema (everything except kernel keys). */
+declare type ControlSchemaExtras = Omit<ControlSchema, ControlSchemaKernelKey>;
+
+/**
+ * Constraint for `createFormControls` only. `component` stays `unknown` so object
+ * literals keep `typeof ElInput` instead of widening to Vue's `Component`.
+ */
+declare type ControlSchemaInput = Omit<ControlSchema, 'component'> & {
+    component?: unknown;
+};
+
+/** Kernel-owned ControlSchema keys. Not extras; tags already have matching `fl:*` where allowed. */
+declare type ControlSchemaKernelKey = 'component' | 'props' | 'model' | 'prop' | 'item';
+
+export declare type ControlVModel = string | readonly string[];
+
+/**
+ * Build a static namespaced control table (ADR-009).
+ * Schema keys are camelCase control names → `<User.TimeRange />`.
+ */
+export declare function createFormControls<const S extends {
+    [K in keyof S]: ControlSchemaInput;
+}>(schema: S, options?: CreateFormControlsOptions): NamespacedControls<S>;
+
+export declare interface CreateFormControlsOptions {
+    /** Defaults for every control in this cluster (static or from the cell snapshot). */
+    props?: HostProps<ItemFl>;
+}
+
+/**
+ * Bind host layout / form / item once; returns a FormView (ADR-008 / ADR-016).
+ *
+ * Host shells stay in this closure. Cells go through `useFormItem` / `FormView.Item`.
+ *
+ * @example
+ * ```ts
+ * export const FormView = createFormView({
+ *   layout: { Row: ElRow, Col: ElCol, column: 2, gutter: 16 },
+ *   form: { component: ElForm, props: (fl) => ({ model: fl.modelValue }) },
+ *   item: { component: ElFormItem, props: toEpItemProps },
+ * })
+ * ```
+ */
+export declare function createFormView(options?: CreateFormViewOptions): FormViewComponent;
+
+export declare interface CreateFormViewOptions {
+    /** Row + Col for hosted grid, plus optional project density. */
+    layout?: FormViewLayoutBind;
+    /** Host form shell. Omit or `:fl:form="false"` skips wrapping. */
+    form?: FormViewHostBind<FormFl>;
+    /** Host item shell. `props` are defaults (static or from the cell snapshot). */
+    item?: FormViewHostBind<ItemFl>;
+}
+
+/**
+ * Bind host Row/Col once. Returns LayoutView.
+ * LayoutItem is not exported; cells call `useLayoutItem()`.
+ */
+export declare function createLayoutView(options?: CreateLayoutViewOptions): Component;
+
+export declare interface CreateLayoutViewOptions {
+    Row?: Component;
+    Col?: Component;
+    column?: number;
+}
+
+/** Kernel column when factory and the LayoutView `column` prop are omitted. */
+export declare const DEFAULT_LAYOUT: {
+    readonly column: 1;
+};
+
+/** Tag attrs: `label?: string` → `'fl:label'?: string`. Always optional (override, not required). */
+declare type FlExtraProps<T> = {
+    [K in keyof T as K extends string ? `fl:${K}` : never]+?: T[K];
+};
+
+export declare interface FormContext {
+    /** Current FormView `modelValue` (parent snapshot; do not mutate). */
+    model: unknown;
+    /** Report a field write; FormView patches and emits `update:modelValue`. */
+    update: (prop: string, value: unknown) => void;
+    /**
+     * FormView-owned Item shell.
+     * Used by `useFormItem` / `FormView.Item`, not by widget authors.
+     */
+    wrap: WrapControl;
+    /** This FormView layer's Item switch. */
+    isItemEnabled: () => boolean;
+    /** This FormView's `:fl:layout` switch (page, not nearest LayoutView). */
+    isLayoutEnabled: () => boolean;
+    /** Factory `createLayoutView` result; reused for gear-4 inner host. */
+    LayoutView: Component;
+    /** `createFormView({ layout })` density; inner extra rows use this, not the page `:row:*`. */
+    factoryColumn: number;
+    factoryGutter: number;
+}
+
+export declare const formContextKey: InjectionKey<FormContext>;
+
+export declare type FormControlComponent<P = {}> = DefineComponent<FormControlProps & P>;
+
+/** Kernel `fl:` / `col:` / `row:` keys on `<User.Xxx />`. Schema extras are prefixed automatically. */
+export declare type FormControlProps = {
+    'fl:prop'?: string | string[];
+    'fl:item'?: boolean;
+    'col:span'?: string | number;
+    'col:place'?: 'auto' | 'start' | 'end';
+    'row:column'?: number;
+    'row:gutter'?: number;
+} & FlExtraProps<ControlSchemaExtras>;
+
+/** Loose schema bag. Prefer inferring `S` from an object literal via `createFormControls`. */
+export declare type FormControlsSchema = Record<string, ControlSchema>;
+
+export declare interface FormFl {
+    layout: boolean;
+    form: boolean;
+    item: boolean;
+    /** FormView write-model; map to the host via `form.props` (e.g. `{ model: fl.modelValue }`). */
+    modelValue: unknown;
+}
+
+export declare type FormFormProp = boolean | 'auto';
+
+/** Dot-notation path for ElFormItem `prop` (e.g. `buyers.0.name`). */
+export declare function formItemProp(prop: string): string;
+
+/** Factory `layout.column` overlay; gutter lives on `FormViewLayoutBind`. */
+export declare type FormLayoutOptions = Pick<FormViewLayoutBind, 'column'>;
+
+/** FormView `:fl:layout` is a boolean switch. Density is factory / `:row:*`. */
+export declare type FormLayoutProp = boolean;
+
+/**
+ * Context-only FormView (no Row/Col/Form/Item). Prefer `createFormView({ layout: { Row, Col } })`.
+ */
+export declare const FormView: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<ExtractPropTypes<    {
+    modelValue: {
+    type: PropType<unknown>;
+    default: undefined;
+    };
+    'fl:layout': {
+    type: PropType<FormLayoutProp>;
+    default: boolean;
+    };
+    'row:column': {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    'row:gutter': {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    'fl:form': {
+    type: PropType<FormFormProp>;
+    default: string;
+    };
+    'fl:item': {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    }>> & Readonly<{
+    "onUpdate:modelValue"?: ((_value: unknown) => any) | undefined;
+    }>, () => VNodeChild, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    'update:modelValue': (_value: unknown) => boolean;
+    }, PublicProps, {
+    modelValue: undefined;
+    'fl:layout': boolean;
+    'row:column': number;
+    'row:gutter': number;
+    'fl:form': FormFormProp;
+    'fl:item': boolean;
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<ExtractPropTypes<    {
+    modelValue: {
+    type: PropType<unknown>;
+    default: undefined;
+    };
+    'fl:layout': {
+    type: PropType<FormLayoutProp>;
+    default: boolean;
+    };
+    'row:column': {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    'row:gutter': {
+    type: NumberConstructor;
+    default: undefined;
+    };
+    'fl:form': {
+    type: PropType<FormFormProp>;
+    default: string;
+    };
+    'fl:item': {
+    type: BooleanConstructor;
+    default: boolean;
+    };
+    }>> & Readonly<{
+    "onUpdate:modelValue"?: ((_value: unknown) => any) | undefined;
+    }>, () => VNodeChild, {}, {}, {}, {
+    modelValue: undefined;
+    'fl:layout': boolean;
+    'row:column': number;
+    'row:gutter': number;
+    'fl:form': FormFormProp;
+    'fl:item': boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<ExtractPropTypes<    {
+modelValue: {
+type: PropType<unknown>;
+default: undefined;
+};
+'fl:layout': {
+type: PropType<FormLayoutProp>;
+default: boolean;
+};
+'row:column': {
+type: NumberConstructor;
+default: undefined;
+};
+'row:gutter': {
+type: NumberConstructor;
+default: undefined;
+};
+'fl:form': {
+type: PropType<FormFormProp>;
+default: string;
+};
+'fl:item': {
+type: BooleanConstructor;
+default: boolean;
+};
+}>> & Readonly<{
+"onUpdate:modelValue"?: ((_value: unknown) => any) | undefined;
+}>, () => VNodeChild, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+'update:modelValue': (_value: unknown) => boolean;
+}, string, {
+modelValue: undefined;
+'fl:layout': boolean;
+'row:column': number;
+'row:gutter': number;
+'fl:form': FormFormProp;
+'fl:item': boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & {
+    Item: typeof FormViewItem;
+};
+
+export declare type FormViewComponent = Component & {
+    Item: typeof FormViewItem;
+};
+
+export declare interface FormViewHostBind<TFl> {
+    component: Component;
+    props?: HostProps<TFl>;
+}
+
+/** Page-level anonymous cell. Same wrap as `useFormItem()`. */
+export declare const FormViewItem: FormViewItemComponent;
+
+declare type FormViewItemComponent = DefineComponent<FormViewItemProps>;
+
+/** Kernel keys on `FormView.Item` / `useFormItem()`. Schema extras are prefixed automatically. */
+export declare type FormViewItemProps = {
+    'fl:prop'?: string | string[];
+    'col:span'?: string | number;
+    'col:place'?: 'auto' | 'start' | 'end';
+} & FlExtraProps<ControlSchemaExtras>;
+
+export declare interface FormViewItemSlotProps {
+    /** `applyControlBinding` result (`modelValue` + `onUpdate:modelValue` for a single leaf). */
+    field: Record<string, unknown>;
+}
+
+export declare interface FormViewLayoutBind {
+    Row: Component;
+    Col: Component;
+    column?: number;
+    gutter?: number;
+}
+
+export declare interface FormViewProps {
+    modelValue?: unknown;
+    /**
+     * Grid hosting switch. Default `false`.
+     * Density: this FormView's factory `layout.column/gutter` plus `:row:column` / `:row:gutter`.
+     * Nested FormView / extra rows do not inherit this instance overlay.
+     */
+    'fl:layout'?: FormLayoutProp;
+    'row:column'?: number;
+    'row:gutter'?: number;
+    /**
+     * Wrap the factory `form`. Default `'auto'`: on at the root, off when nested.
+     * Explicit `true` / `false` win.
+     */
+    'fl:form'?: FormFormProp;
+    /** Wrap the factory `item` per cell (default `true` when `item.component` is bound). */
+    'fl:item'?: boolean;
+}
+
+export declare function getIn(root: unknown, prop: string): unknown;
+
+/** Host Col span modulus (Element / Ant Design 24-grid). */
+export declare const GRID_TOTAL = 24;
+
+/** Static host props, or derived from that layer's snapshot. */
+export declare type HostProps<TFl> = Record<string, unknown> | ((fl: TFl) => Record<string, unknown> | undefined);
+
+/**
+ * Snapshot for `item.props` / control `props` functions.
+ * Kernel wiring + ControlSchema extras. Not passed as a host component prop.
+ */
+export declare type ItemFl = {
+    controlKey: string;
+    binding: ResolvedControlBinding;
+    getValues: () => unknown[];
+    [extra: string]: unknown;
+} & ControlSchemaExtras;
+
+export declare interface LayoutItemProps {
+    span?: ColSpanSpec;
+    place?: ColPlace;
+}
+
+export declare interface LayoutViewProps {
+    disabled?: boolean;
+    column?: number;
+}
+
+declare type LockedKeysForDef<Def> = LockedVModelKeys<SchemaModel<Def> extends ControlVModel | undefined ? SchemaModel<Def> : undefined>;
+
+export declare type LockedVModelKeys<M extends ControlVModel | undefined> = ModelPortNames<M> | `onUpdate:${ModelPortNames<M>}`;
+
+/** Widget `formless.item` vs schema `item`. `'self'` vs `false` is illegal. */
+export declare function mergeInternalItem(widget?: ControlItemSetting, schema?: ControlItemSetting): ControlItemSetting | undefined;
+
+declare type ModelPortNames<M> = [M] extends [undefined] ? 'modelValue' : M extends string ? M : M extends readonly [infer F extends string, ...infer R] ? F | ModelPortNames<R> : 'modelValue';
+
+/**
+ * PascalCase control tags. `S` must not be `Record<string, _>` or `keyof` collapses
+ * to `string` and Volar/TS lose `User.Name` / `User.IdCard` as named keys.
+ * Tag props are `fl:*` plus the widget's public props (v-model ports locked).
+ */
+export declare type NamespacedControls<S> = {
+    [K in keyof S & string as CamelToPascal<K>]: FormControlComponent<WidgetTagProps<S[K]>>;
+};
+
+/** Later layers win. `undefined` does not override. Empty string is a value. */
+export declare function overlayProps(...layers: Array<Record<string, unknown> | undefined>): Record<string, unknown>;
+
+export declare function parsePath(prop: string): PathSegment[];
+
+/** `Name` → `name`, `IdCard` → `idCard` */
+export declare function pascalToCamel(key: string): string;
+
+/**
+ * Parse `prop` location strings: object keys and `[index]` segments.
+ * Examples: `name`, `buyers[0].name`, `[2].title`
+ */
+export declare type PathSegment = {
+    type: 'key';
+    key: string;
+} | {
+    type: 'index';
+    index: number;
+};
+
+export declare function resolveControlBinding(controlKey: string, options?: {
+    model?: ControlVModel;
+    prop?: ControlProp;
+}, overrides?: ControlBindingOverrides): ResolvedControlBinding;
+
+/**
+ * FormView < internal < tag (ADR-017).
+ * Pure `'self'` skips outer Item+Col. `'self'` + explicit tag item true
+ * wraps outer Item (and Col when page layout is on) and asks for an inner Row.
+ * Col follows the Row host only; no control/cell layout switch.
+ */
+export declare function resolveControlShell(input: ResolveControlShellInput): ResolvedControlShell;
+
+declare interface ResolveControlShellInput {
+    pageItem: boolean;
+    pageLayoutOn: boolean;
+    internalItem?: ControlItemSetting;
+    /** Tag `:fl:item`. Omitted ≠ `true`. */
+    tagItem?: boolean;
+}
+
+export declare interface ResolvedControlBinding {
+    models: string[];
+    props: string[];
+}
+
+export declare interface ResolvedControlShell {
+    wrapItem: boolean;
+    wrapCol: boolean;
+    extraRow: boolean;
+    self: boolean;
+}
+
+/**
+ * Optional Element-style encoding: one location → dotted path; several →
+ * control key. Kernel does not put this on Item `fl` — the adapter Item
+ * calls this (or encodes another way) when mapping to host `prop`.
+ */
+export declare function resolveFormItemProp(binding: ResolvedControlBinding, controlKey: string): string;
+
+export declare function resolveProps<TFl>(spec: HostProps<TFl> | undefined, fl: TFl): Record<string, unknown>;
+
+/**
+ * v-model ports locked on the tag (ADR-011). Schema `model` wins;
+ * omitted `model` locks the default `'modelValue'`.
+ * Widened `string[]` is not treated as port names (would Omit every string key).
+ */
+declare type SchemaModel<Def> = Def extends {
+    model: infer M;
+} ? M : undefined;
+
+/** Immutable write at a full `prop` location (`buyers[0].name`). Arrays are cloned. */
+export declare function setIn(root: unknown, prop: string, value: unknown): unknown;
+
+export declare function toBindingList(value: ControlVModel | ControlProp): string[];
+
+export declare function useFormContext(): FormContext;
+
+/**
+ * One cell: LayoutItem? → Item? → (inner LayoutView?) → default slot.
+ * No arg: this control's full binding (factory outer wrap).
+ * Port: slice one v-model mouth.
+ * Outer wrap follows the merged shell (ADR-017); binding stays on the frame.
+ */
+export declare function useFormItem(port?: string): FormViewItemComponent;
+
+/** Nearest LayoutView's cell component; identity when no LayoutView. */
+export declare function useLayoutItem(): Component;
+
+export declare interface WidgetFormless {
+    model?: string | string[];
+    item?: boolean | 'self';
+}
+
+/** Widget props that may appear on `<User.Xxx />` (v-model ports stripped). */
+export declare type WidgetTagProps<Def> = Def extends {
+    component?: infer C;
+} ? [Exclude<C, undefined>] extends [never] ? {} : Omit<ComponentPublicProps<Exclude<C, undefined>>, LockedKeysForDef<Def>> : {};
+
+/** FormView-owned Item shell. Col is owned by LayoutView / useLayoutItem. */
+export declare type WrapControl = (body: VNodeChild, meta: WrapControlMeta) => VNodeChild;
+
+/** Input Control hands to FormView's wrap: Item snapshot + host fallthrough. */
+export declare interface WrapControlMeta {
+    /**
+     * This wrap only. `false` skips Item even when FormView `item` is on.
+     * `true` forces Item even when FormView `item` is off. Omit = follow FormView.
+     */
+    item?: boolean;
+    fl: ItemFl;
+    itemAttrs: Record<string, unknown>;
+    itemOn: Record<string, unknown>;
+    itemSlots: Record<string, Slot>;
+}
+
 export { }
+
+
+declare module 'vue' {
+    interface ComponentCustomOptions {
+        formless?: WidgetFormless;
+    }
+}