@vunk/form 2.19.11 → 2.19.13

package/components/form/src/types.d.ts

@@ -1,7 +1,8 @@
 import { __VkfTemplatesDefault } from '@vunk/form/components/templates-default';
 import { __VkfTemplatesLayout } from '@vunk/form/components/templates-layout';
 import { VueComponentPropsType } from '@vunk/shared';
-import { ElCol } from 'element-plus';
+import { ElCol, FormItemProp } from 'element-plus';
+export type OnValidate = (prop: FormItemProp, isValid: boolean, message: string) => any;
 export type LayoutProps = {
     /**
      * 如果开启 props.layout，那么

package/components/form/src/use.d.ts

@@ -0,0 +1,206 @@
+import { AnyFunc } from '@vunk/shared';
+import { FormValidateCallback, FormValidationResult } from 'element-plus';
+export { initFormMitt, type FormEmitter, useFormMitt } from '@vunk/form/composables/form-mitt';
+export declare function initFormRef(props: {
+    elRef: AnyFunc;
+    onAfterValidate?: FormValidateCallback;
+}): {
+    setFormRef: (e: any) => void;
+    formRef: import("vue").ShallowRef<({
+        $: import("vue").ComponentInternalInstance;
+        $data: {};
+        $props: {
+            readonly model?: Record<string, any> | undefined;
+            readonly rules?: import("element-plus").FormRules | undefined;
+            readonly labelPosition?: "left" | "right" | "top" | undefined;
+            readonly requireAsteriskPosition?: "left" | "right" | undefined;
+            readonly labelWidth?: string | number | undefined;
+            readonly labelSuffix?: string | undefined;
+            readonly inline?: boolean | undefined;
+            readonly inlineMessage?: boolean | undefined;
+            readonly statusIcon?: boolean | undefined;
+            readonly showMessage?: boolean | undefined;
+            readonly validateOnRuleChange?: boolean | undefined;
+            readonly hideRequiredAsterisk?: boolean | undefined;
+            readonly scrollToError?: boolean | undefined;
+            readonly scrollIntoViewOptions?: (ScrollIntoViewOptions | boolean) | undefined;
+            readonly size?: import("element-plus").ComponentSize | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined | undefined;
+        } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps;
+        $attrs: import("vue").Attrs;
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import("vue").Slot<any> | undefined;
+        }>;
+        $root: import("vue").ComponentPublicInstance | null;
+        $parent: import("vue").ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: "validate", prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => void;
+        $el: any;
+        $options: import("vue").ComponentOptionsBase<Readonly<import("element-plus").FormProps> & Readonly<{
+            onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined;
+        }>, {
+            validate: (callback?: FormValidateCallback) => FormValidationResult;
+            validateField: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>, callback?: FormValidateCallback) => FormValidationResult;
+            resetFields: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+            clearValidate: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+            scrollToField: (prop: import("element-plus").FormItemProp) => void;
+            getField: (prop: import("element-plus").FormItemProp) => import("element-plus").FormItemContext | undefined;
+            fields: import("vue").Reactive<import("element-plus").FormItemContext[]>;
+            setInitialValues: (initModel: Record<string, any>) => void;
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+            validate: (prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => void;
+        }, string, {
+            labelWidth: string | number;
+            labelPosition: "left" | "right" | "top";
+            requireAsteriskPosition: "left" | "right";
+            labelSuffix: string;
+            showMessage: boolean;
+            validateOnRuleChange: boolean;
+            scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+        }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import("vue").nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import("@vue/reactivity").OnCleanup]) => any : (...args: [any, any, import("@vue/reactivity").OnCleanup]) => any, options?: import("vue").WatchOptions): import("vue").WatchStopHandle;
+    } & Readonly<{
+        labelWidth: string | number;
+        labelPosition: "left" | "right" | "top";
+        requireAsteriskPosition: "left" | "right";
+        labelSuffix: string;
+        showMessage: boolean;
+        validateOnRuleChange: boolean;
+        scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+    }> & Omit<Readonly<import("element-plus").FormProps> & Readonly<{
+        onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined;
+    }>, "labelPosition" | "labelWidth" | "showMessage" | "validate" | "requireAsteriskPosition" | "labelSuffix" | "validateOnRuleChange" | "scrollIntoViewOptions" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "fields" | "setInitialValues"> & {
+        validate: (callback?: FormValidateCallback) => FormValidationResult;
+        validateField: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>, callback?: FormValidateCallback) => FormValidationResult;
+        resetFields: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+        clearValidate: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+        scrollToField: (prop: import("element-plus").FormItemProp) => void;
+        getField: (prop: import("element-plus").FormItemProp) => import("element-plus").FormItemContext | undefined;
+        fields: import("vue").Reactive<import("element-plus").FormItemContext[]>;
+        setInitialValues: (initModel: Record<string, any>) => void;
+    } & {} & import("vue").ComponentCustomProperties & {} & {
+        $slots: {
+            default?: (props: {}) => any;
+        };
+    }) | undefined, ({
+        $: import("vue").ComponentInternalInstance;
+        $data: {};
+        $props: {
+            readonly model?: Record<string, any> | undefined;
+            readonly rules?: import("element-plus").FormRules | undefined;
+            readonly labelPosition?: "left" | "right" | "top" | undefined;
+            readonly requireAsteriskPosition?: "left" | "right" | undefined;
+            readonly labelWidth?: string | number | undefined;
+            readonly labelSuffix?: string | undefined;
+            readonly inline?: boolean | undefined;
+            readonly inlineMessage?: boolean | undefined;
+            readonly statusIcon?: boolean | undefined;
+            readonly showMessage?: boolean | undefined;
+            readonly validateOnRuleChange?: boolean | undefined;
+            readonly hideRequiredAsterisk?: boolean | undefined;
+            readonly scrollToError?: boolean | undefined;
+            readonly scrollIntoViewOptions?: (ScrollIntoViewOptions | boolean) | undefined;
+            readonly size?: import("element-plus").ComponentSize | undefined;
+            readonly disabled?: boolean | undefined;
+            readonly onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined | undefined;
+        } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps;
+        $attrs: import("vue").Attrs;
+        $refs: {
+            [x: string]: unknown;
+        };
+        $slots: Readonly<{
+            [name: string]: import("vue").Slot<any> | undefined;
+        }>;
+        $root: import("vue").ComponentPublicInstance | null;
+        $parent: import("vue").ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: "validate", prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => void;
+        $el: any;
+        $options: import("vue").ComponentOptionsBase<Readonly<import("element-plus").FormProps> & Readonly<{
+            onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined;
+        }>, {
+            validate: (callback?: FormValidateCallback) => FormValidationResult;
+            validateField: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>, callback?: FormValidateCallback) => FormValidationResult;
+            resetFields: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+            clearValidate: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+            scrollToField: (prop: import("element-plus").FormItemProp) => void;
+            getField: (prop: import("element-plus").FormItemProp) => import("element-plus").FormItemContext | undefined;
+            fields: import("vue").Reactive<import("element-plus").FormItemContext[]>;
+            setInitialValues: (initModel: Record<string, any>) => void;
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+            validate: (prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => void;
+        }, string, {
+            labelWidth: string | number;
+            labelPosition: "left" | "right" | "top";
+            requireAsteriskPosition: "left" | "right";
+            labelSuffix: string;
+            showMessage: boolean;
+            validateOnRuleChange: boolean;
+            scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+        }, {}, string, {}, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import("vue").DebuggerEvent) => void) | ((e: import("vue").DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import("vue").ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import("vue").nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import("@vue/reactivity").OnCleanup]) => any : (...args: [any, any, import("@vue/reactivity").OnCleanup]) => any, options?: import("vue").WatchOptions): import("vue").WatchStopHandle;
+    } & Readonly<{
+        labelWidth: string | number;
+        labelPosition: "left" | "right" | "top";
+        requireAsteriskPosition: "left" | "right";
+        labelSuffix: string;
+        showMessage: boolean;
+        validateOnRuleChange: boolean;
+        scrollIntoViewOptions: ScrollIntoViewOptions | boolean;
+    }> & Omit<Readonly<import("element-plus").FormProps> & Readonly<{
+        onValidate?: ((prop: import("element-plus").FormItemProp, isValid: boolean, message: string) => any) | undefined;
+    }>, "labelPosition" | "labelWidth" | "showMessage" | "validate" | "requireAsteriskPosition" | "labelSuffix" | "validateOnRuleChange" | "scrollIntoViewOptions" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "fields" | "setInitialValues"> & {
+        validate: (callback?: FormValidateCallback) => FormValidationResult;
+        validateField: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>, callback?: FormValidateCallback) => FormValidationResult;
+        resetFields: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+        clearValidate: (props?: import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemProp>) => void;
+        scrollToField: (prop: import("element-plus").FormItemProp) => void;
+        getField: (prop: import("element-plus").FormItemProp) => import("element-plus").FormItemContext | undefined;
+        fields: import("vue").Reactive<import("element-plus").FormItemContext[]>;
+        setInitialValues: (initModel: Record<string, any>) => void;
+    } & {} & import("vue").ComponentCustomProperties & {} & {
+        $slots: {
+            default?: (props: {}) => any;
+        };
+    }) | undefined>;
+};

package/components/form-item/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const a=require("element-plus"),h=require("@vunk/core/shared/utils-vue"),e=require("vue"),q=require("@vunk/form/shared/element-plus"),f=require("@vunk/form/composables"),B=require("@vunk/form/composables/element-plus"),v=require("@vunk/core/shared/utils-object"),V=require("@vunk/form/shared/rules"),_=require("../index-DSyxYMB0.js"),I={...a.formItemProps,labelPosition:{type:String,default:void 0},formItemSize:{type:String,default:void 0},formItemSlots:{type:Object,default:void 0},elRef:{type:Function,required:!1},inline:{type:Boolean,default:!1},readonly:{type:Boolean,default:void 0},formItemTip:{type:String,default:void 0},formItemTipClass:null,labelTip:{type:String,default:void 0},information:{type:Boolean,default:!1},prop:null,defaultModelValue:null};Reflect.deleteProperty(I,"size");const m=I,$=h.bindPropsFactory(m),R=Object.freeze(Object.defineProperty({__proto__:null,createBindProps:$,props:m},Symbol.toStringTag,{value:"Module"})),E={key:0,class:"vkf-form-item-label__span"},O={key:2,class:"vkf-form-item-label__actions"},j=e.defineComponent({inheritAttrs:!1,__name:"core",props:{labelTip:{type:String,default:""},formItemTip:{type:String,default:""},formItemTipClass:null,elRef:null,label:null},setup(t){return(o,c)=>(e.openBlock(),e.createBlock(e.unref(a.ElFormItem),e.mergeProps(o.$attrs,{ref:t.elRef,class:["vkf-form-item",{"has-label-actions":o.$slots.labelActions}],label:t.label}),{default:e.withCtx(()=>[e.renderSlot(o.$slots,"before"),e.renderSlot(o.$slots,"default"),e.renderSlot(o.$slots,"after"),t.formItemTip?(e.openBlock(),e.createElementBlock("div",{key:0,class:e.normalizeClass(["vkf-form-item__tip",t.formItemTipClass])},[e.createElementVNode("span",null,e.toDisplayString(t.formItemTip),1)],2)):e.createCommentVNode("",!0)]),label:e.withCtx(n=>[e.renderSlot(o.$slots,"label",e.normalizeProps(e.guardReactiveProps(n)),()=>[t.label?(e.openBlock(),e.createElementBlock("span",E,e.toDisplayString(n.label),1)):e.createCommentVNode("",!0),t.labelTip?(e.openBlock(),e.createBlock(e.unref(a.ElTooltip),{key:1,content:t.labelTip},{default:e.withCtx(()=>[e.createVNode(e.unref(a.ElButton),{text:"",class:"vkf-form-item-label-tip-button"},{default:e.withCtx(()=>[e.createVNode(e.unref(a.ElIcon),null,{default:e.withCtx(()=>[e.createVNode(e.unref(_.warning_default))]),_:1})]),_:1})]),_:1},8,["content"])):e.createCommentVNode("",!0),o.$slots.labelActions?(e.openBlock(),e.createElementBlock("div",O,[e.renderSlot(o.$slots,"labelActions")])):e.createCommentVNode("",!0)])]),error:e.withCtx(n=>[e.renderSlot(o.$slots,"error",e.normalizeProps(e.guardReactiveProps(n)))]),_:3},16,["class","label"]))}}),k=e.defineComponent({name:"VkfFormItem",props:m,setup(t,{slots:o}){const c=q.createFormItemBindProps(t,["rules"]),n=f.useComputedReadonly(t),{tr:i}=B.useLocale(),d=e.ref(),P=e.computed(()=>t.labelPosition),T=f.useComputedLabelPosition(d,P),b=()=>t.label||i("vkf.formItem.defaultField","该字段"),S=l=>{if(l.message)return;l.required&&(l.message=i("vkf.formItem.required","{label}不能为空",{label:b()}));const r=V.PATTERN_OPTIONS.find(y=>y.value===l.pattern);r&&(l.message=i("vkf.formItem.pattern","输入 {label} {pattern}",{label:b(),pattern:r.title}))},g=e.computed(()=>{let l=[];return!t.rules&&t.required&&l.push({required:!0}),v.isPlainObject(t.rules)&&(l=[t.rules]),Array.isArray(t.rules)&&(l=t.rules,t.required&&!t.rules.find(r=>r.required)&&l.push({required:!0})),l=l.filter(r=>{if(r&&v.isPlainObject(r))return Object.keys(r).filter(C=>!C.startsWith("data-")).length>0}),l.forEach(r=>{S(r)}),l}),{getDataValue:s,emitSetData:u}=f.useRendererData();setTimeout(()=>{t.defaultModelValue!==void 0&&t.prop&&(s==null?void 0:s(t.prop))===void 0&&(u==null||u({k:t.prop,v:t.defaultModelValue}))});const p=l=>{d.value=(l==null?void 0:l.$el)??l,typeof t.elRef=="function"&&t.elRef(l)};return()=>e.h(j,{...c.value,"label-position":T.value,elRef:p,class:{"is-readonly":n.value,"vkf-form-item--inline":t.inline,"is-empty-label":!t.label,"is-information":t.information},size:t.formItemSize,rules:g.value,formItemTip:t.formItemTip,formItemTipClass:t.formItemTipClass,labelTip:t.labelTip,label:t.label},{...o,...t.formItemSlots})}}),N=Object.freeze(Object.defineProperty({__proto__:null},Symbol.toStringTag,{value:"Module"}));exports.VkfFormItem=k;exports._VkfFormItemCtx=R;exports.__VkfFormItem=N;exports.default=k;
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const s=require("element-plus"),h=require("@vunk/core/shared/utils-vue"),e=require("vue"),q=require("@vunk/form/shared/element-plus"),u=require("@vunk/form/composables"),B=require("@vunk/form/composables/element-plus"),v=require("@vunk/core/shared/utils-object"),V=require("@vunk/form/shared/rules"),O=require("../index-DSyxYMB0.js"),$=require("@vunk/form/components/collapse-item"),k={...s.formItemProps,labelPosition:{type:String,default:void 0},formItemSize:{type:String,default:void 0},formItemSlots:{type:Object,default:void 0},elRef:{type:Function,required:!1},inline:{type:Boolean,default:!1},readonly:{type:Boolean,default:void 0},formItemTip:{type:String,default:void 0},formItemTipClass:null,labelTip:{type:String,default:void 0},information:{type:Boolean,default:!1},prop:null,defaultModelValue:null};Reflect.deleteProperty(k,"size");const b=k,_=h.bindPropsFactory(b),E=Object.freeze(Object.defineProperty({__proto__:null,createBindProps:_,props:b},Symbol.toStringTag,{value:"Module"})),N={key:0,class:"vkf-form-item-label__span"},R={key:2,class:"vkf-form-item-label__actions"},j=e.defineComponent({inheritAttrs:!1,__name:"core",props:{labelTip:{type:String,default:""},formItemTip:{type:String,default:""},formItemTipClass:null,elRef:null,label:null,prop:null},setup(t){const i=t,{mittOn:f}=u.useFormMitt(),m=$.useCollapseItemContext();return f("afterValidate",({invalidFields:o})=>{if(!o||i.prop==null||!(i.prop in o))return;const r=m;if(!r)return;const n=r.name;if(r.accordion){if(Object.keys(o)[0]===i.prop){if(r.activeNames.includes(n))return;r.handleItemClick(n)}}else{if(r.activeNames.includes(n))return;r.handleItemClick(n)}}),(o,r)=>(e.openBlock(),e.createBlock(e.unref(s.ElFormItem),e.mergeProps(o.$attrs,{prop:t.prop,class:["vkf-form-item",{"has-label-actions":o.$slots.labelActions}],label:t.label}),{default:e.withCtx(()=>[e.renderSlot(o.$slots,"before"),e.renderSlot(o.$slots,"default"),e.renderSlot(o.$slots,"after"),t.formItemTip?(e.openBlock(),e.createElementBlock("div",{key:0,class:e.normalizeClass(["vkf-form-item__tip",t.formItemTipClass])},[e.createElementVNode("span",null,e.toDisplayString(t.formItemTip),1)],2)):e.createCommentVNode("",!0)]),label:e.withCtx(n=>[e.renderSlot(o.$slots,"label",e.normalizeProps(e.guardReactiveProps(n)),()=>[t.label?(e.openBlock(),e.createElementBlock("span",N,e.toDisplayString(n.label),1)):e.createCommentVNode("",!0),t.labelTip?(e.openBlock(),e.createBlock(e.unref(s.ElTooltip),{key:1,content:t.labelTip},{default:e.withCtx(()=>[e.createVNode(e.unref(s.ElButton),{text:"",class:"vkf-form-item-label-tip-button"},{default:e.withCtx(()=>[e.createVNode(e.unref(s.ElIcon),null,{default:e.withCtx(()=>[e.createVNode(e.unref(O.warning_default))]),_:1})]),_:1})]),_:1},8,["content"])):e.createCommentVNode("",!0),o.$slots.labelActions?(e.openBlock(),e.createElementBlock("div",R,[e.renderSlot(o.$slots,"labelActions")])):e.createCommentVNode("",!0)])]),error:e.withCtx(n=>[e.renderSlot(o.$slots,"error",e.normalizeProps(e.guardReactiveProps(n)))]),_:3},16,["prop","class","label"]))}}),C=e.defineComponent({name:"VkfFormItem",props:b,setup(t,{slots:i}){const f=q.createFormItemBindProps(t,["rules"]),m=u.useComputedReadonly(t),{tr:o}=B.useLocale(),r=e.ref(),n=e.computed(()=>t.labelPosition),p=u.useComputedLabelPosition(r,n),y=()=>t.label||o("vkf.formItem.defaultField","该字段"),P=l=>{if(l.message)return;l.required&&(l.message=o("vkf.formItem.required","{label}不能为空",{label:y()}));const a=V.PATTERN_OPTIONS.find(I=>I.value===l.pattern);a&&(l.message=o("vkf.formItem.pattern","输入 {label} {pattern}",{label:y(),pattern:a.title}))},T=e.computed(()=>{let l=[];return!t.rules&&t.required&&l.push({required:!0}),v.isPlainObject(t.rules)&&(l=[t.rules]),Array.isArray(t.rules)&&(l=t.rules,t.required&&!t.rules.find(a=>a.required)&&l.push({required:!0})),l=l.filter(a=>{if(a&&v.isPlainObject(a))return Object.keys(a).filter(g=>!g.startsWith("data-")).length>0}),l.forEach(a=>{P(a)}),l}),{getDataValue:c,emitSetData:d}=u.useRendererData();setTimeout(()=>{t.defaultModelValue!==void 0&&t.prop&&(c==null?void 0:c(t.prop))===void 0&&(d==null||d({k:t.prop,v:t.defaultModelValue}))});const S=l=>{r.value=(l==null?void 0:l.$el)??l,typeof t.elRef=="function"&&t.elRef(l)};return()=>e.h(j,{...f.value,"label-position":p.value,elRef:S,class:{"is-readonly":m.value,"vkf-form-item--inline":t.inline,"is-empty-label":!t.label,"is-information":t.information},size:t.formItemSize,rules:T.value,formItemTip:t.formItemTip,formItemTipClass:t.formItemTipClass,labelTip:t.labelTip,label:t.label},{...i,...t.formItemSlots})}}),z=Object.freeze(Object.defineProperty({__proto__:null},Symbol.toStringTag,{value:"Module"}));exports.VkfFormItem=C;exports._VkfFormItemCtx=E;exports.__VkfFormItem=z;exports.default=C;

package/components/form-item/index.mjs

@@ -1,13 +1,14 @@
-import { formItemProps as q, ElFormItem as z, ElTooltip as j, ElButton as A, ElIcon as M } from "element-plus";
-import { bindPropsFactory as L } from "@vunk/core/shared/utils-vue";
-import { defineComponent as C, openBlock as n, createBlock as p, unref as f, mergeProps as N, withCtx as r, renderSlot as i, normalizeProps as g, guardReactiveProps as P, createElementBlock as c, toDisplayString as S, createCommentVNode as s, createVNode as b, normalizeClass as w, createElementVNode as D, ref as K, computed as _, h as W } from "vue";
-import { createFormItemBindProps as G } from "@vunk/form/shared/element-plus";
-import { useComputedReadonly as H, useComputedLabelPosition as J, useRendererData as Q } from "@vunk/form/composables";
+import { formItemProps as q, ElFormItem as z, ElTooltip as F, ElButton as A, ElIcon as M } from "element-plus";
+import { bindPropsFactory as N } from "@vunk/core/shared/utils-vue";
+import { defineComponent as _, openBlock as f, createBlock as P, unref as m, mergeProps as L, withCtx as i, renderSlot as n, normalizeProps as C, guardReactiveProps as S, createElementBlock as y, toDisplayString as h, createCommentVNode as u, createVNode as I, normalizeClass as w, createElementVNode as K, ref as D, computed as O, h as W } from "vue";
+import { createFormItemBindProps as x } from "@vunk/form/shared/element-plus";
+import { useFormMitt as G, useComputedReadonly as H, useComputedLabelPosition as J, useRendererData as Q } from "@vunk/form/composables";
 import { useLocale as U } from "@vunk/form/composables/element-plus";
-import { isPlainObject as h } from "@vunk/core/shared/utils-object";
+import { isPlainObject as R } from "@vunk/core/shared/utils-object";
 import { PATTERN_OPTIONS as X } from "@vunk/form/shared/rules";
 import { w as Y } from "../index-BCZuzyeO.mjs";
-const R = {
+import { useCollapseItemContext as Z } from "@vunk/form/components/collapse-item";
+const $ = {
   ...q,
   labelPosition: {
     type: String,
@@ -49,18 +50,18 @@ const R = {
   prop: null,
   defaultModelValue: null
 };
-Reflect.deleteProperty(R, "size");
-const y = R, Z = L(y), ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+Reflect.deleteProperty($, "size");
+const v = $, ee = N(v), be = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  createBindProps: Z,
-  props: y
-}, Symbol.toStringTag, { value: "Module" })), x = {
+  createBindProps: ee,
+  props: v
+}, Symbol.toStringTag, { value: "Module" })), te = {
   key: 0,
   class: "vkf-form-item-label__span"
-}, ee = {
+}, le = {
   key: 2,
   class: "vkf-form-item-label__actions"
-}, te = /* @__PURE__ */ C({
+}, oe = /* @__PURE__ */ _({
   inheritAttrs: !1,
   __name: "core",
   props: {
@@ -74,43 +75,59 @@ const y = R, Z = L(y), ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object
     },
     formItemTipClass: null,
     elRef: null,
-    label: null
+    label: null,
+    prop: null
   },
   setup(e) {
-    return (l, v) => (n(), p(f(z), N(l.$attrs, {
-      ref: e.elRef,
+    const s = e, { mittOn: c } = G(), d = Z();
+    return c("afterValidate", ({ invalidFields: l }) => {
+      if (!l || s.prop == null || !(s.prop in l)) return;
+      const o = d;
+      if (!o) return;
+      const r = o.name;
+      if (o.accordion) {
+        if (Object.keys(l)[0] === s.prop) {
+          if (o.activeNames.includes(r)) return;
+          o.handleItemClick(r);
+        }
+      } else {
+        if (o.activeNames.includes(r)) return;
+        o.handleItemClick(r);
+      }
+    }), (l, o) => (f(), P(m(z), L(l.$attrs, {
+      prop: e.prop,
       class: ["vkf-form-item", {
         "has-label-actions": l.$slots.labelActions
       }],
       label: e.label
     }), {
-      default: r(() => [
-        i(l.$slots, "before"),
-        i(l.$slots, "default"),
-        i(l.$slots, "after"),
-        e.formItemTip ? (n(), c("div", {
+      default: i(() => [
+        n(l.$slots, "before"),
+        n(l.$slots, "default"),
+        n(l.$slots, "after"),
+        e.formItemTip ? (f(), y("div", {
           key: 0,
           class: w(["vkf-form-item__tip", e.formItemTipClass])
         }, [
-          D("span", null, S(e.formItemTip), 1)
-        ], 2)) : s("", !0)
+          K("span", null, h(e.formItemTip), 1)
+        ], 2)) : u("", !0)
       ]),
-      label: r((a) => [
-        i(l.$slots, "label", g(P(a)), () => [
-          e.label ? (n(), c("span", x, S(a.label), 1)) : s("", !0),
-          e.labelTip ? (n(), p(f(j), {
+      label: i((r) => [
+        n(l.$slots, "label", C(S(r)), () => [
+          e.label ? (f(), y("span", te, h(r.label), 1)) : u("", !0),
+          e.labelTip ? (f(), P(m(F), {
             key: 1,
             content: e.labelTip
           }, {
-            default: r(() => [
-              b(f(A), {
+            default: i(() => [
+              I(m(A), {
                 text: "",
                 class: "vkf-form-item-label-tip-button"
               }, {
-                default: r(() => [
-                  b(f(M), null, {
-                    default: r(() => [
-                      b(f(Y))
+                default: i(() => [
+                  I(m(M), null, {
+                    default: i(() => [
+                      I(m(Y))
                     ]),
                     _: 1
                   })
@@ -119,88 +136,88 @@ const y = R, Z = L(y), ue = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object
               })
             ]),
             _: 1
-          }, 8, ["content"])) : s("", !0),
-          l.$slots.labelActions ? (n(), c("div", ee, [
-            i(l.$slots, "labelActions")
-          ])) : s("", !0)
+          }, 8, ["content"])) : u("", !0),
+          l.$slots.labelActions ? (f(), y("div", le, [
+            n(l.$slots, "labelActions")
+          ])) : u("", !0)
         ])
       ]),
-      error: r((a) => [
-        i(l.$slots, "error", g(P(a)))
+      error: i((r) => [
+        n(l.$slots, "error", C(S(r)))
       ]),
       _: 3
-    }, 16, ["class", "label"]));
+    }, 16, ["prop", "class", "label"]));
   }
-}), de = /* @__PURE__ */ C({
+}), pe = /* @__PURE__ */ _({
   name: "VkfFormItem",
-  props: y,
+  props: v,
   setup(e, {
-    slots: l
+    slots: s
   }) {
-    const v = G(e, ["rules"]), a = H(e), {
-      tr: m
-    } = U(), I = K(), $ = _(() => e.labelPosition), B = J(I, $), T = () => e.label || m("vkf.formItem.defaultField", "该字段"), E = (t) => {
+    const c = x(e, ["rules"]), d = H(e), {
+      tr: l
+    } = U(), o = D(), r = O(() => e.labelPosition), k = J(o, r), T = () => e.label || l("vkf.formItem.defaultField", "该字段"), B = (t) => {
       if (t.message) return;
-      t.required && (t.message = m("vkf.formItem.required", "{label}不能为空", {
+      t.required && (t.message = l("vkf.formItem.required", "{label}不能为空", {
         label: T()
       }));
-      const o = X.find((k) => k.value === t.pattern);
-      o && (t.message = m("vkf.formItem.pattern", "输入 {label} {pattern}", {
+      const a = X.find((g) => g.value === t.pattern);
+      a && (t.message = l("vkf.formItem.pattern", "输入 {label} {pattern}", {
         label: T(),
-        pattern: o.title
+        pattern: a.title
       }));
-    }, F = _(() => {
+    }, E = O(() => {
       let t = [];
       return !e.rules && e.required && t.push({
         required: !0
-      }), h(e.rules) && (t = [e.rules]), Array.isArray(e.rules) && (t = e.rules, e.required && !e.rules.find((o) => o.required) && t.push({
+      }), R(e.rules) && (t = [e.rules]), Array.isArray(e.rules) && (t = e.rules, e.required && !e.rules.find((a) => a.required) && t.push({
         required: !0
-      })), t = t.filter((o) => {
-        if (o && h(o))
-          return Object.keys(o).filter((V) => !V.startsWith("data-")).length > 0;
-      }), t.forEach((o) => {
-        E(o);
+      })), t = t.filter((a) => {
+        if (a && R(a))
+          return Object.keys(a).filter((j) => !j.startsWith("data-")).length > 0;
+      }), t.forEach((a) => {
+        B(a);
       }), t;
     }), {
-      getDataValue: u,
-      emitSetData: d
+      getDataValue: b,
+      emitSetData: p
     } = Q();
     setTimeout(() => {
-      e.defaultModelValue !== void 0 && e.prop && (u == null ? void 0 : u(e.prop)) === void 0 && (d == null || d({
+      e.defaultModelValue !== void 0 && e.prop && (b == null ? void 0 : b(e.prop)) === void 0 && (p == null || p({
         k: e.prop,
         v: e.defaultModelValue
       }));
     });
-    const O = (t) => {
-      I.value = (t == null ? void 0 : t.$el) ?? t, typeof e.elRef == "function" && e.elRef(t);
+    const V = (t) => {
+      o.value = (t == null ? void 0 : t.$el) ?? t, typeof e.elRef == "function" && e.elRef(t);
     };
-    return () => W(te, {
-      ...v.value,
-      "label-position": B.value,
-      elRef: O,
+    return () => W(oe, {
+      ...c.value,
+      "label-position": k.value,
+      elRef: V,
       class: {
-        "is-readonly": a.value,
+        "is-readonly": d.value,
         "vkf-form-item--inline": e.inline,
         "is-empty-label": !e.label,
         "is-information": e.information
       },
       size: e.formItemSize,
-      rules: F.value,
+      rules: E.value,
       formItemTip: e.formItemTip,
       formItemTipClass: e.formItemTipClass,
       labelTip: e.labelTip,
       label: e.label
     }, {
-      ...l,
+      ...s,
       ...e.formItemSlots
     });
   }
-}), ce = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}), ye = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null
 }, Symbol.toStringTag, { value: "Module" }));
 export {
-  de as VkfFormItem,
-  ue as _VkfFormItemCtx,
-  ce as __VkfFormItem,
-  de as default
+  pe as VkfFormItem,
+  be as _VkfFormItemCtx,
+  ye as __VkfFormItem,
+  pe as default
 };

package/components/form-item/src/core.vue.d.ts

@@ -28,6 +28,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     formItemTipClass: null;
     elRef: null;
     label: null;
+    prop: null;
 }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     labelTip: {
         type: StringConstructor;
@@ -40,6 +41,7 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     formItemTipClass: null;
     elRef: null;
     label: null;
+    prop: null;
 }>> & Readonly<{}>, {
     formItemTip: string;
     labelTip: string;

package/composables/form-mitt/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("vue");function m(t){return{all:t=t||new Map,on:function(n,o){var i=t.get(n);i?i.push(o):t.set(n,[o])},off:function(n,o){var i=t.get(n);i&&(o?i.splice(i.indexOf(o)>>>0,1):t.set(n,[]))},emit:function(n,o){var i=t.get(n);i&&i.slice().map(function(e){e(o)}),(i=t.get("*"))&&i.slice().map(function(e){e(n,o)})}}}const u=Symbol("vkfFormMitt");function c(){const t=m();return r.provide(u,t),t}function f(){const t=r.inject(u,null);return{mittOn:(o,i)=>{if(!t){console.warn("useFormMitt must be used within a VkfForm component");return}t.on(o,i),r.onBeforeUnmount(()=>{t.off(o,i)})},mitt:t}}exports.initFormMitt=c;exports.useFormMitt=f;

package/composables/form-mitt/index.d.ts

@@ -0,0 +1,37 @@
+import { Emitter } from 'mitt';
+export type FormEmitter = Emitter<{
+    afterValidate: {
+        isValid: boolean;
+        invalidFields?: Record<string, {
+            message?: string;
+            fieldValue?: any;
+            field?: string;
+        }[]>;
+    };
+}>;
+export declare function initFormMitt(): FormEmitter;
+export declare function useFormMitt(): {
+    mittOn: {
+        <Key extends "afterValidate">(type: Key, handler: import("mitt").Handler<{
+            afterValidate: {
+                isValid: boolean;
+                invalidFields?: Record<string, {
+                    message?: string;
+                    fieldValue?: any;
+                    field?: string;
+                }[]>;
+            };
+        }[Key]>): void;
+        (type: "*", handler: import("mitt").WildcardHandler<{
+            afterValidate: {
+                isValid: boolean;
+                invalidFields?: Record<string, {
+                    message?: string;
+                    fieldValue?: any;
+                    field?: string;
+                }[]>;
+            };
+        }>): void;
+    };
+    mitt: FormEmitter | null;
+};

package/composables/form-mitt/index.mjs

@@ -0,0 +1,41 @@
+import { provide as m, inject as f, onBeforeUnmount as u } from "vue";
+function c(t) {
+  return { all: t = t || /* @__PURE__ */ new Map(), on: function(n, o) {
+    var i = t.get(n);
+    i ? i.push(o) : t.set(n, [o]);
+  }, off: function(n, o) {
+    var i = t.get(n);
+    i && (o ? i.splice(i.indexOf(o) >>> 0, 1) : t.set(n, []));
+  }, emit: function(n, o) {
+    var i = t.get(n);
+    i && i.slice().map(function(e) {
+      e(o);
+    }), (i = t.get("*")) && i.slice().map(function(e) {
+      e(n, o);
+    });
+  } };
+}
+const r = Symbol("vkfFormMitt");
+function a() {
+  const t = c();
+  return m(r, t), t;
+}
+function l() {
+  const t = f(r, null);
+  return {
+    mittOn: (o, i) => {
+      if (!t) {
+        console.warn("useFormMitt must be used within a VkfForm component");
+        return;
+      }
+      t.on(o, i), u(() => {
+        t.off(o, i);
+      });
+    },
+    mitt: t
+  };
+}
+export {
+  a as initFormMitt,
+  l as useFormMitt
+};

package/composables/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("vue"),C=require("@vunk/shared/function"),M=require("element-plus"),m=require("@vunk/core"),P=(t,n={})=>{a.isRef(t)||(t=a.ref(t));const s={...n,slotsChildren:["default"]};n.slotsChildren&&s.slotsChildren.push(...n.slotsChildren);const e=a.computed(()=>{const c={},g={},I={};function d(T,R=[]){T.forEach((l,h)=>{const i=[...R,h],p={source:l,key:i,nextKey:[...R,h+1],prop:l.prop,id:l.id};c[i.join()]=p,l.prop&&(g[l.prop]=p),l.id&&(I[l.id]=p),l.templateSlots&&(Array.isArray(l.templateSlots)&&(i.push("templateSlots"),d(l.templateSlots,i)),s.slotsChildren.forEach(f=>{Array.isArray(l.templateSlots[f])&&(i.push("templateSlots",f),d(l.templateSlots[f],i))}))})}return d(a.unref(t)),{keyRecord:c,propRecord:g,idRecord:I}});return[t,{manager:e,getManagerInfoByProp:c=>e.value.propRecord[c],getManagerInfoByKey:c=>e.value.keyRecord[c.join()],getManagerInfoById:c=>e.value.idRecord[c]}]},v=()=>a.inject("vkfFormVm",null),E=t=>{const n=v();return a.computed(()=>t.readonly??(n==null?void 0:n.props.readonly)??!1)},D=t=>{const n=a.ref(0),s=a.computed(()=>{n.value;const r=t.value;return r?r.matches(":dir(rtl)")||getComputedStyle(r).direction==="rtl":!1});let e=null;const o=r=>{e==null||e.disconnect(),e=new MutationObserver(()=>{n.value++});let u=r.parentElement;for(;u;)e.observe(u,{attributes:!0,attributeFilter:["dir","style","class"]}),u=u.parentElement};return a.watch(t,r=>{r?o(r):e==null||e.disconnect()},{immediate:!0,flush:"post"}),a.onBeforeUnmount(()=>e==null?void 0:e.disconnect()),s};function j(t,n){const s=D(t),e=a.inject(M.formContextKey,null);return a.computed(()=>{C.noop(t.value);const o=n.value??a.unref(e==null?void 0:e.labelPosition);return o==="start"?s.value?"right":"left":o==="end"?s.value?"left":"right":o})}const S=Symbol("PARENT_KEY"),y=()=>a.inject("vkTemplateInstances",null),k=()=>{const t=y(),n=e=>e==null?void 0:e[S];return{templateInstances:t,getTemplateInstance:e=>{let o=t==null?void 0:t[e];if(o)return o;let r=n(t);for(;r;){if(o=r==null?void 0:r[e],o)return o;r=n(r)}return null},getParent:n}},A=()=>{const t=y(),n=a.shallowReactive({});return n[S]=t,a.provide("vkTemplateInstances",n),n},B=(t,n)=>{const s=a.computed(()=>t.data),r={data:s,emitSetData:u=>{n.emit("setData",{intoUndefined:m.defaultIntoUndefined,...u})},getDataValue:u=>m.getValue(s.value,u,m.defaultIntoUndefined,!0)};return a.provide("vkRendererData",r),r},K=()=>a.inject("vkRendererData",{});exports.initRendererData=B;exports.initTemplateInstances=A;exports.useComputedLabelPosition=j;exports.useComputedReadonly=E;exports.useForm=v;exports.useRendererData=K;exports.useRtl=D;exports.useSourceManager=P;exports.useTemplateInstances=y;exports.useTemplateInstancesContext=k;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("vue"),T=require("@vunk/form/composables/form-mitt"),C=require("@vunk/shared/function"),P=require("element-plus"),m=require("@vunk/core"),j=(t,n={})=>{o.isRef(t)||(t=o.ref(t));const s={...n,slotsChildren:["default"]};n.slotsChildren&&s.slotsChildren.push(...n.slotsChildren);const e=o.computed(()=>{const c={},g={},I={};function d(M,R=[]){M.forEach((u,h)=>{const i=[...R,h],p={source:u,key:i,nextKey:[...R,h+1],prop:u.prop,id:u.id};c[i.join()]=p,u.prop&&(g[u.prop]=p),u.id&&(I[u.id]=p),u.templateSlots&&(Array.isArray(u.templateSlots)&&(i.push("templateSlots"),d(u.templateSlots,i)),s.slotsChildren.forEach(f=>{Array.isArray(u.templateSlots[f])&&(i.push("templateSlots",f),d(u.templateSlots[f],i))}))})}return d(o.unref(t)),{keyRecord:c,propRecord:g,idRecord:I}});return[t,{manager:e,getManagerInfoByProp:c=>e.value.propRecord[c],getManagerInfoByKey:c=>e.value.keyRecord[c.join()],getManagerInfoById:c=>e.value.idRecord[c]}]},v=()=>o.inject("vkfFormVm",null),E=t=>{const n=v();return o.computed(()=>t.readonly??(n==null?void 0:n.props.readonly)??!1)},D=t=>{const n=o.ref(0),s=o.computed(()=>{n.value;const r=t.value;return r?r.matches(":dir(rtl)")||getComputedStyle(r).direction==="rtl":!1});let e=null;const a=r=>{e==null||e.disconnect(),e=new MutationObserver(()=>{n.value++});let l=r.parentElement;for(;l;)e.observe(l,{attributes:!0,attributeFilter:["dir","style","class"]}),l=l.parentElement};return o.watch(t,r=>{r?a(r):e==null||e.disconnect()},{immediate:!0,flush:"post"}),o.onBeforeUnmount(()=>e==null?void 0:e.disconnect()),s};function b(t,n){const s=D(t),e=o.inject(P.formContextKey,null);return o.computed(()=>{C.noop(t.value);const a=n.value??o.unref(e==null?void 0:e.labelPosition);return a==="start"?s.value?"right":"left":a==="end"?s.value?"left":"right":a})}const S=Symbol("PARENT_KEY"),y=()=>o.inject("vkTemplateInstances",null),k=()=>{const t=y(),n=e=>e==null?void 0:e[S];return{templateInstances:t,getTemplateInstance:e=>{let a=t==null?void 0:t[e];if(a)return a;let r=n(t);for(;r;){if(a=r==null?void 0:r[e],a)return a;r=n(r)}return null},getParent:n}},A=()=>{const t=y(),n=o.shallowReactive({});return n[S]=t,o.provide("vkTemplateInstances",n),n},B=(t,n)=>{const s=o.computed(()=>t.data),r={data:s,emitSetData:l=>{n.emit("setData",{intoUndefined:m.defaultIntoUndefined,...l})},getDataValue:l=>m.getValue(s.value,l,m.defaultIntoUndefined,!0)};return o.provide("vkRendererData",r),r},K=()=>o.inject("vkRendererData",{});Object.defineProperty(exports,"useFormMitt",{enumerable:!0,get:()=>T.useFormMitt});exports.initRendererData=B;exports.initTemplateInstances=A;exports.useComputedLabelPosition=b;exports.useComputedReadonly=E;exports.useForm=v;exports.useRendererData=K;exports.useRtl=D;exports.useSourceManager=j;exports.useTemplateInstances=y;exports.useTemplateInstancesContext=k;

package/composables/index.d.ts

@@ -1,5 +1,6 @@
 export * from './useSourceManager';
 export * from './useForm';
+export { useFormMitt } from '@vunk/form/composables/form-mitt';
 export * from './useComputedReadonly';
 export * from './useRtl';
 export * from './useComputedLabelPosition';