@vef-framework/components 1.0.98 → 1.0.99

package/lib/vef-form/components/form-item.cjs

@@ -1,3 +1,84 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("@emotion/react/jsx-runtime"),r=require("@vef-framework/hooks"),a=require("@vef-framework/shared"),l=require("antd"),s=require("react"),u=require("../hooks/use-computed-values.cjs"),t=require("./form-field.cjs"),{Item:o}=l.Form;const i=s.memo((function VefFormItemBase({item:l,disabled:s}){const{name:i,show:d,disabled:n,label:m,tip:f,rules:c,virtual:b,...p}=l,k=r.useContextDisabled(),[w,V,v,q,y]=u.useComputedValues([{key:"show",rawValue:d,defaultValue:!0},{key:"disabled",rawValue:n,defaultValue:s},{key:"label",rawValue:m},{key:"tip",rawValue:f},{key:"rules",rawValue:c}]);if(!w)return null;const h=a.isArray(y)?y.flatMap((e=>e(l))):void 0;return e.jsx(o,{label:v,name:i,preserve:!1,rules:h,tooltip:q,children:e.jsx(t.default,{componentProps:p,disabled:k||V,label:v,name:i})})}),((e,r)=>e.disabled===r.disabled));exports.default=i;
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const jsxRuntime = require('@emotion/react/jsx-runtime');
+const hooks = require('@vef-framework/hooks');
+const shared = require('@vef-framework/shared');
+const antd = require('antd');
+const react = require('react');
+const useComputedValues = require('../hooks/use-computed-values.cjs');
+const formField = require('./form-field.cjs');
+
+const { Item } = antd.Form;
+function VefFormItemBase({
+  item,
+  disabled
+}) {
+  const {
+    name,
+    show,
+    disabled: itemDisabled,
+    label,
+    tip,
+    rules,
+    virtual: _,
+    ...componentProps
+  } = item;
+  const formDisabled = hooks.useContextDisabled();
+  const [showValue, disabledValue, labelValue, tipValue, rulesValue] = useComputedValues.useComputedValues([
+    {
+      key: "show",
+      rawValue: show,
+      defaultValue: true
+    },
+    {
+      key: "disabled",
+      rawValue: itemDisabled,
+      defaultValue: disabled
+    },
+    {
+      key: "label",
+      rawValue: label
+    },
+    {
+      key: "tip",
+      rawValue: tip
+    },
+    {
+      key: "rules",
+      rawValue: rules
+    }
+  ]);
+  if (!showValue) {
+    return null;
+  }
+  const ruleObjects = shared.isArray(rulesValue) ? rulesValue.flatMap((rule) => rule(item)) : void 0;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    Item,
+    {
+      label: labelValue,
+      name,
+      preserve: false,
+      rules: ruleObjects,
+      tooltip: tipValue,
+      children: /* @__PURE__ */ jsxRuntime.jsx(
+        formField.default,
+        {
+          componentProps,
+          disabled: formDisabled || disabledValue,
+          label: labelValue,
+          name
+        }
+      )
+    }
+  );
+}
+const VefFormItem = react.memo(
+  VefFormItemBase,
+  (prevProps, nextProps) => prevProps.disabled === nextProps.disabled
+);
+
+exports.default = VefFormItem;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/components/form-row.cjs

@@ -1,3 +1,103 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("@emotion/react/jsx-runtime"),s=require("@vef-framework/shared"),o=require("react"),t=require("../../vef-grid/index.cjs"),r=require("../../vef-grid-item/index.cjs"),u=require("../hooks/use-columns-layout.cjs"),a=require("../hooks/use-computed-values.cjs"),i=require("../hooks/use-form-context.cjs"),l=require("./form-hidden-item.cjs"),n=require("./form-item.cjs");const m=o.memo((function VefFormRowBase({rowKey:s,columns:m,disabled:d,autoExpand:c}){const{layoutMode:f,autoExpand:x,labelPosition:p,labelWidth:y}=i.useFormContext(),h="top"===p?240:240+(y??80),[k,j]=o.useMemo((()=>{const e=[],s=[];for(const o of m){const{items:t,...r}=o,u=[];for(const s of t){const{type:o}=s;"Hidden"===o?e.push(s):u.push(s)}u.length>0&&s.push({...r,items:u})}return[e,s]}),[m]),g=a.useComputedValues([...j.map((({key:e,show:s})=>({key:`show-${e}`,rawValue:s,defaultValue:!0}))),...j.map((({key:e,disabled:s})=>({key:`disabled-${e}`,rawValue:s,defaultValue:d})))],!0),q=o.useMemo((()=>m.filter((({key:e})=>g[`show-${e}`]))),[g,m]),b=u.useColumnsLayout(s,q,f,c??x);return e.jsxs(e.Fragment,{children:[k.map((s=>{const{name:o}=s;return e.jsx(l.default,{item:s},o)})),q.length>0&&e.jsx(t.default,{baseWidth:h,gap:[0,"large"],children:q.map((s=>{const o={};if("responsive"===f){const e=b;o.xs=e.xs[s.key],o.sm=e.sm[s.key],o.md=e.md[s.key],o.lg=e.lg[s.key],o.xl=e.xl[s.key],o.xxl=e.xxl[s.key]}else{const e=b;o.span=e[s.key]}return e.jsx(r.default,{...o,children:s.items.map((o=>e.jsx(n.default,{disabled:d||g[`disabled-${s.key}`],item:o},o.name)))},s.key)}))})]})}),((e,o)=>s.isDeepEqual(s.omit(e,["columns"]),s.omit(o,["columns"]))));exports.default=m;
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+
+const jsxRuntime = require('@emotion/react/jsx-runtime');
+const shared = require('@vef-framework/shared');
+const react = require('react');
+const index = require('../../vef-grid/index.cjs');
+const index$1 = require('../../vef-grid-item/index.cjs');
+const useColumnsLayout = require('../hooks/use-columns-layout.cjs');
+const useComputedValues = require('../hooks/use-computed-values.cjs');
+const useFormContext = require('../hooks/use-form-context.cjs');
+const formHiddenItem = require('./form-hidden-item.cjs');
+const formItem = require('./form-item.cjs');
+
+const formItemMinWidth = 240;
+function VefFormRowBase({
+  rowKey,
+  columns,
+  disabled,
+  autoExpand: rowAutoExpand
+}) {
+  const {
+    layoutMode,
+    autoExpand: formAutoExpand,
+    labelPosition,
+    labelWidth
+  } = useFormContext.useFormContext();
+  const formItemMinWidthToUse = labelPosition === "top" ? formItemMinWidth : formItemMinWidth + (labelWidth ?? 80);
+  const [hiddenItems, filteredColumns] = react.useMemo(() => {
+    const hiddenItems2 = [];
+    const filteredColumns2 = [];
+    for (const column of columns) {
+      const { items, ...rest } = column;
+      const filteredItems = [];
+      for (const item of items) {
+        const { type } = item;
+        if (type === "Hidden") {
+          hiddenItems2.push(item);
+        } else {
+          filteredItems.push(item);
+        }
+      }
+      if (filteredItems.length > 0) {
+        filteredColumns2.push({
+          ...rest,
+          items: filteredItems
+        });
+      }
+    }
+    return [hiddenItems2, filteredColumns2];
+  }, [columns]);
+  const computedValues = useComputedValues.useComputedValues(
+    [
+      ...filteredColumns.map(({ key, show }) => ({
+        key: `show-${key}`,
+        rawValue: show,
+        defaultValue: true
+      })),
+      ...filteredColumns.map(({ key, disabled: columnDisabled }) => ({
+        key: `disabled-${key}`,
+        rawValue: columnDisabled,
+        defaultValue: disabled
+      }))
+    ],
+    true
+  );
+  const showedColumns = react.useMemo(() => columns.filter(({ key }) => computedValues[`show-${key}`]), [computedValues, columns]);
+  const layout = useColumnsLayout.useColumnsLayout(rowKey, showedColumns, layoutMode, rowAutoExpand ?? formAutoExpand);
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    hiddenItems.map((item) => {
+      const { name } = item;
+      return /* @__PURE__ */ jsxRuntime.jsx(formHiddenItem.default, { item }, name);
+    }),
+    showedColumns.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(index.default, { baseWidth: formItemMinWidthToUse, gap: [0, "large"], children: showedColumns.map((column) => {
+      const layoutProps = {};
+      if (layoutMode === "responsive") {
+        const columnsLayout = layout;
+        layoutProps.xs = columnsLayout.xs[column.key];
+        layoutProps.sm = columnsLayout.sm[column.key];
+        layoutProps.md = columnsLayout.md[column.key];
+        layoutProps.lg = columnsLayout.lg[column.key];
+        layoutProps.xl = columnsLayout.xl[column.key];
+        layoutProps.xxl = columnsLayout.xxl[column.key];
+      } else {
+        const columnsLayout = layout;
+        layoutProps.span = columnsLayout[column.key];
+      }
+      return /* @__PURE__ */ jsxRuntime.jsx(index$1.default, { ...layoutProps, children: column.items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(formItem.default, { disabled: disabled || computedValues[`disabled-${column.key}`], item }, item.name)) }, column.key);
+    }) })
+  ] });
+}
+const VefFormRow = react.memo(
+  VefFormRowBase,
+  (prevProps, nextProps) => shared.isDeepEqual(
+    shared.omit(prevProps, ["columns"]),
+    shared.omit(nextProps, ["columns"])
+  )
+);
+
+exports.default = VefFormRow;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/event.cjs

@@ -1,3 +1,49 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared");var t,__typeError=e=>{throw TypeError(e)},__privateGet=(e,t,a)=>(((e,t,a)=>{t.has(e)||__typeError("Cannot "+a)})(e,t,"read from private field"),a?a.call(e):t.get(e));const a=Symbol("change"),o=Symbol("submitResult");t=new WeakMap,exports.FormEventBus=class FormEventBus{constructor(){var a,o,r;a=this,o=t,r=e.createEventEmitter(),o.has(a)?__typeError("Cannot add the same private member more than once"):o instanceof WeakSet?o.add(a):o.set(a,r)}clear(){__privateGet(this,t).all.clear()}onChange(e){__privateGet(this,t).on(a,e)}offChange(e){__privateGet(this,t).off(a,e)}emitChange(e){__privateGet(this,t).emit(a,e)}onSubmitResult(e){__privateGet(this,t).on(o,e)}offSubmitResult(e){__privateGet(this,t).off(o,e)}emitSubmitResult(e){__privateGet(this,t).emit(o,e)}};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var _emitter;
+const changeEvent = Symbol("change");
+const submitResultEvent = Symbol("submitResult");
+class FormEventBus {
+  constructor() {
+    /**
+     * The emitter.
+     */
+    __privateAdd(this, _emitter, shared.createEventEmitter());
+  }
+  clear() {
+    __privateGet(this, _emitter).all.clear();
+  }
+  onChange(handler) {
+    __privateGet(this, _emitter).on(changeEvent, handler);
+  }
+  offChange(handler) {
+    __privateGet(this, _emitter).off(changeEvent, handler);
+  }
+  emitChange(value) {
+    __privateGet(this, _emitter).emit(changeEvent, value);
+  }
+  onSubmitResult(handler) {
+    __privateGet(this, _emitter).on(submitResultEvent, handler);
+  }
+  offSubmitResult(handler) {
+    __privateGet(this, _emitter).off(submitResultEvent, handler);
+  }
+  emitSubmitResult(result) {
+    __privateGet(this, _emitter).emit(submitResultEvent, result);
+  }
+}
+_emitter = new WeakMap();
+
+exports.FormEventBus = FormEventBus;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/helper.cjs

@@ -1,3 +1,20 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared");exports.computeValue=function computeValue(r,n,t,i){if(e.isFunction(r)&&!e.isIternalFunction(r))return r(n,t);if(e.isExpression(r)){return e.compileDynamicFn(r,"values","scene",`return ${r.expression}`)(n,t)}return r??i};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+
+function computeValue(value, values, scene, defaultValue) {
+  if (shared.isFunction(value) && !shared.isIternalFunction(value)) {
+    return value(values, scene);
+  }
+  if (shared.isExpression(value)) {
+    const fn = shared.compileDynamicFn(value, "values", "scene", `return ${value.expression}`);
+    return fn(values, scene);
+  }
+  return value ?? defaultValue;
+}
+
+exports.computeValue = computeValue;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/hooks/use-action-handlers.cjs

@@ -1,3 +1,135 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/core"),t=require("@vef-framework/shared"),i=require("react"),s=require("../store.cjs");exports.useActionHandlers=function useActionHandlers({submitApi:o,submitTip:n="提交中...",onBeforeSubmit:r,onSubmit:u,onSubmitSuccess:a,onSubmitFailure:l,onReset:m}){const[c,b,d,p,S,f,w,h]=s.useFormStore((e=>[e.form,e.scene,e.eventBus,e.setIsLoading,e.virtualFieldNames,e.getValues,e.initialValues,e.invokeValueChangeHandlers])),{useApiMutation:F,stubMutationApi:g}=e.useApiContext(),{mutate:v}=F(o??g);if(!t.isFunction(u)&&!o)throw new t.VefError(-1,"'onSubmit' or 'submitApi' prop is required for VefForm component");return{handleReset:i.useCallback((()=>{const e=f();c.resetFields(),h(),d.emitChange(w),m?.(e,b)}),[c,f,m,b,h,w,d]),handleSubmit:i.useMemo((()=>t.isFunction(u)?(o&&console.warn("'submitApi' prop is ignored when 'onSubmit' prop is provided in VefForm component"),async e=>{p(!0);let i=e,s=null;try{const o=t.isFunction(n)?n(e,b):n;s=t.showLoadingMessage(o),t.isFunction(r)&&(i=await r(i,b));const a=t.omit(i,S);await u(a,b),d.emitSubmitResult(!0)}catch(e){throw d.emitSubmitResult(!1),e}finally{p(!1),s?.()}}):async e=>{p(!0);let i=e,s=null;try{const o=t.isFunction(n)?n(e,b):n;s=t.showLoadingMessage(o),t.isFunction(r)&&(i=await r(e,b));const u=t.omit(i,S),l=await v(u);(a??(({message:e})=>{t.showSuccessMessage(e)}))(l,i,b),d.emitSubmitResult(!0)}catch(e){d.emitSubmitResult(!1),l?.(e,i,b)}finally{p(!1),s?.()}}),[u,o,p,n,b,r,S,d,v,a,l]),handleSubmitFailed:i.useCallback((({values:e,errorFields:i})=>{d.emitSubmitResult(!1),l?.(new t.VefError(-1,i.flatMap((e=>e.errors)).join(", ")),e,b)}),[d,l,b])}};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const core = require('@vef-framework/core');
+const shared = require('@vef-framework/shared');
+const react = require('react');
+const store = require('../store.cjs');
+
+function useActionHandlers({
+  submitApi,
+  submitTip = "\u63D0\u4EA4\u4E2D...",
+  onBeforeSubmit,
+  onSubmit,
+  onSubmitSuccess,
+  onSubmitFailure,
+  onReset
+}) {
+  const [
+    form,
+    scene,
+    eventBus,
+    setIsLoading,
+    virtualFieldNames,
+    getValues,
+    initialValues,
+    invokeValueChangeHandlers
+  ] = store.useFormStore((state) => [
+    state.form,
+    state.scene,
+    state.eventBus,
+    state.setIsLoading,
+    state.virtualFieldNames,
+    state.getValues,
+    state.initialValues,
+    state.invokeValueChangeHandlers
+  ]);
+  const { useApiMutation, stubMutationApi } = core.useApiContext();
+  const { mutate } = useApiMutation(submitApi ?? stubMutationApi);
+  if (!shared.isFunction(onSubmit) && !submitApi) {
+    throw new shared.VefError(-1, "'onSubmit' or 'submitApi' prop is required for VefForm component");
+  }
+  const handleReset = react.useCallback(() => {
+    const values = getValues();
+    form.resetFields();
+    invokeValueChangeHandlers();
+    eventBus.emitChange(initialValues);
+    onReset?.(values, scene);
+  }, [
+    form,
+    getValues,
+    onReset,
+    scene,
+    invokeValueChangeHandlers,
+    initialValues,
+    eventBus
+  ]);
+  const handleSubmit = react.useMemo(() => {
+    if (shared.isFunction(onSubmit)) {
+      if (submitApi) {
+        console.warn("'submitApi' prop is ignored when 'onSubmit' prop is provided in VefForm component");
+      }
+      return async (values) => {
+        setIsLoading(true);
+        let valuesToUse = values;
+        let closeLoading = null;
+        try {
+          const submitTipToUse = shared.isFunction(submitTip) ? submitTip(values, scene) : submitTip;
+          closeLoading = shared.showLoadingMessage(submitTipToUse);
+          if (shared.isFunction(onBeforeSubmit)) {
+            valuesToUse = await onBeforeSubmit(valuesToUse, scene);
+          }
+          const valuesToSubmit = shared.omit(valuesToUse, virtualFieldNames);
+          await onSubmit(valuesToSubmit, scene);
+          eventBus.emitSubmitResult(true);
+        } catch (error) {
+          eventBus.emitSubmitResult(false);
+          throw error;
+        } finally {
+          setIsLoading(false);
+          closeLoading?.();
+        }
+      };
+    }
+    return async (values) => {
+      setIsLoading(true);
+      let valuesToUse = values;
+      let closeLoading = null;
+      try {
+        const submitTipToUse = shared.isFunction(submitTip) ? submitTip(values, scene) : submitTip;
+        closeLoading = shared.showLoadingMessage(submitTipToUse);
+        if (shared.isFunction(onBeforeSubmit)) {
+          valuesToUse = await onBeforeSubmit(values, scene);
+        }
+        const toSubmitValues = shared.omit(valuesToUse, virtualFieldNames);
+        const apiResponse = await mutate(toSubmitValues);
+        (onSubmitSuccess ?? (({ message }) => {
+          shared.showSuccessMessage(message);
+        }))(apiResponse, valuesToUse, scene);
+        eventBus.emitSubmitResult(true);
+      } catch (error) {
+        eventBus.emitSubmitResult(false);
+        onSubmitFailure?.(error, valuesToUse, scene);
+      } finally {
+        setIsLoading(false);
+        closeLoading?.();
+      }
+    };
+  }, [
+    onSubmit,
+    submitApi,
+    setIsLoading,
+    submitTip,
+    scene,
+    onBeforeSubmit,
+    virtualFieldNames,
+    eventBus,
+    mutate,
+    onSubmitSuccess,
+    onSubmitFailure
+  ]);
+  const handleSubmitFailed = react.useCallback(({ values, errorFields }) => {
+    eventBus.emitSubmitResult(false);
+    onSubmitFailure?.(new shared.VefError(-1, errorFields.flatMap((field) => field.errors).join(", ")), values, scene);
+  }, [eventBus, onSubmitFailure, scene]);
+  return {
+    handleReset,
+    handleSubmit,
+    handleSubmitFailed
+  };
+}
+
+exports.useActionHandlers = useActionHandlers;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/hooks/use-columns-layout.cjs

@@ -1,3 +1,127 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),s=require("react"),n=24,o=[{breakpoint:"xs",base:n,spans:1},{breakpoint:"sm",base:12,spans:2},{breakpoint:"md",base:8,spans:3},{breakpoint:"lg",base:6,spans:4},{breakpoint:"xl",base:6,spans:4},{breakpoint:"xxl",base:4,spans:6}],t=e.unique(o.map((e=>e.spans)));exports.useColumnsLayout=function useColumnsLayout(a,r,u,l){return s.useMemo((()=>0===r.length?{}:"responsive"===u?function calculateResponsiveLayout(s,n,a){const r=n.reduce(((e,s)=>e+(s.span??1)),0);if(!t.includes(r))throw new e.VefError(-3,`The total spans of the columns of the row [${s}] must be one of the following: ${t.join(", ")}.`);const u=24/r,l={};for(const{breakpoint:e,base:s,spans:t}of o)if(u>=s)l[e]=n.reduce(((e,s)=>(e[s.key]=(s.span??1)*u,e)),{});else{const o={};let r=t,u=null;for(const e of n){const n=e.span??1;r>=n?(o[e.key]=n*s,r-=n,u=e.key):(u&&(a&&(o[u]+=r*s),r=t,u=null),n>t?o[e.key]=24:(o[e.key]=n*s,r-=n,u=e.key)),0===r&&(r=t,u=null)}r>0&&(a&&(o[u]+=r*s),u=null),l[e]=o}return l}(a,r,l):function calculateFixedLayout(s,o){const t=o.reduce(((e,s)=>e+(s.span??1)),0);if(t>n||n%t!=0)throw new e.VefError(-3,`The total spans of the columns of the row [${s}] must be less than or equal to 24 and a divisor of 24.`);const a=n/t;return o.reduce(((e,s)=>(e[s.key]=(s.span??1)*a,e)),{})}(a,r)),[])};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+const react = require('react');
+
+const MAX_SPANS = 24;
+const SPAN_BASES = [
+  {
+    breakpoint: "xs",
+    base: MAX_SPANS,
+    spans: 1
+  },
+  {
+    breakpoint: "sm",
+    base: MAX_SPANS / 2,
+    spans: 2
+  },
+  {
+    breakpoint: "md",
+    base: MAX_SPANS / 3,
+    spans: 3
+  },
+  {
+    breakpoint: "lg",
+    base: MAX_SPANS / 4,
+    spans: 4
+  },
+  {
+    breakpoint: "xl",
+    base: MAX_SPANS / 4,
+    spans: 4
+  },
+  {
+    breakpoint: "xxl",
+    base: MAX_SPANS / 6,
+    spans: 6
+  }
+];
+const ALLOWED_SPANS = shared.unique(SPAN_BASES.map((item) => item.spans));
+function calculateResponsiveLayout(rowKey, columns, autoExpand) {
+  const totalSpans = columns.reduce((acc, column) => acc + (column.span ?? 1), 0);
+  if (!ALLOWED_SPANS.includes(totalSpans)) {
+    throw new shared.VefError(-3, `The total spans of the columns of the row [${rowKey}] must be one of the following: ${ALLOWED_SPANS.join(", ")}.`);
+  }
+  const requiredBase = 24 / totalSpans;
+  const layout = {};
+  for (const {
+    breakpoint,
+    base,
+    spans
+  } of SPAN_BASES) {
+    if (requiredBase >= base) {
+      layout[breakpoint] = columns.reduce((acc, column) => {
+        acc[column.key] = (column.span ?? 1) * requiredBase;
+        return acc;
+      }, {});
+    } else {
+      const map = {};
+      let remainingSpans = spans;
+      let lastColumnKey = null;
+      for (const column of columns) {
+        const requiredSpan = column.span ?? 1;
+        if (remainingSpans >= requiredSpan) {
+          map[column.key] = requiredSpan * base;
+          remainingSpans -= requiredSpan;
+          lastColumnKey = column.key;
+        } else {
+          if (lastColumnKey) {
+            if (autoExpand) {
+              map[lastColumnKey] += remainingSpans * base;
+            }
+            remainingSpans = spans;
+            lastColumnKey = null;
+          }
+          if (requiredSpan > spans) {
+            map[column.key] = 24;
+          } else {
+            map[column.key] = requiredSpan * base;
+            remainingSpans -= requiredSpan;
+            lastColumnKey = column.key;
+          }
+        }
+        if (remainingSpans === 0) {
+          remainingSpans = spans;
+          lastColumnKey = null;
+        }
+      }
+      if (remainingSpans > 0) {
+        if (autoExpand) {
+          map[lastColumnKey] += remainingSpans * base;
+        }
+        lastColumnKey = null;
+      }
+      layout[breakpoint] = map;
+    }
+  }
+  return layout;
+}
+function calculateFixedLayout(rowKey, columns) {
+  const totalSpans = columns.reduce((acc, column) => acc + (column.span ?? 1), 0);
+  if (totalSpans > MAX_SPANS || MAX_SPANS % totalSpans !== 0) {
+    throw new shared.VefError(-3, `The total spans of the columns of the row [${rowKey}] must be less than or equal to ${MAX_SPANS} and a divisor of ${MAX_SPANS}.`);
+  }
+  const base = MAX_SPANS / totalSpans;
+  return columns.reduce((acc, column) => {
+    acc[column.key] = (column.span ?? 1) * base;
+    return acc;
+  }, {});
+}
+function useColumnsLayout(rowKey, columns, layoutMode, autoExpand) {
+  return react.useMemo(() => {
+    if (columns.length === 0) {
+      return {};
+    }
+    if (layoutMode === "responsive") {
+      return calculateResponsiveLayout(rowKey, columns, autoExpand);
+    } else {
+      return calculateFixedLayout(rowKey, columns);
+    }
+  }, []);
+}
+
+exports.useColumnsLayout = useColumnsLayout;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/hooks/use-computed-values.cjs

@@ -1,3 +1,60 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/hooks"),r=require("@vef-framework/shared"),u=require("../helper.cjs"),t=require("../store.cjs");exports.useComputedValues=function useComputedValues(o,s=!1){const[a,n,c]=t.useFormStore((e=>[e.scene,e.eventBus,e.getValues])),l=e.useUpdater(),f=c(),i=e.useDeepMemo((()=>o.reduce(((e,r)=>{const{key:t,rawValue:o,defaultValue:s}=r,n=u.computeValue(o,f,a,s);return e[t]=n,e}),{})),[f,a,o]);return e.useDeepLayoutEffect((()=>{const e=o.filter((({rawValue:e})=>r.isFunctionOrExpression(e)));if(e.length>0){const handleChange=t=>{for(const o of e){const{key:e,rawValue:s,defaultValue:n}=o,c=i[e],f=u.computeValue(s,t,a,n);if(!r.isDeepEqual(f,c)){l();break}}};return n.onChange(handleChange),()=>{n.offChange(handleChange)}}}),[i,n,l,a,o]),s?o.reduce(((e,{key:r})=>(e[r]=i[r],e)),{}):o.map((({key:e})=>i[e]))};
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const hooks = require('@vef-framework/hooks');
+const shared = require('@vef-framework/shared');
+const helper = require('../helper.cjs');
+const store = require('../store.cjs');
+
+function useComputedValues(values, returnAsObject = false) {
+  const [scene, eventBus, getValues] = store.useFormStore((state) => [state.scene, state.eventBus, state.getValues]);
+  const forceUpdate = hooks.useUpdater();
+  const currentValues = getValues();
+  const computedValues = hooks.useDeepMemo(() => values.reduce((acc, it) => {
+    const {
+      key,
+      rawValue,
+      defaultValue
+    } = it;
+    const computedValue = helper.computeValue(rawValue, currentValues, scene, defaultValue);
+    acc[key] = computedValue;
+    return acc;
+  }, {}), [currentValues, scene, values]);
+  hooks.useDeepLayoutEffect(() => {
+    const realComputedValues = values.filter(({ rawValue }) => shared.isFunctionOrExpression(rawValue));
+    const shouldListenChangeEvent = realComputedValues.length > 0;
+    if (shouldListenChangeEvent) {
+      const handleChange = (newValues) => {
+        for (const value of realComputedValues) {
+          const {
+            key,
+            rawValue,
+            defaultValue
+          } = value;
+          const computedValue = computedValues[key];
+          const refreshedValue = helper.computeValue(rawValue, newValues, scene, defaultValue);
+          if (!shared.isDeepEqual(refreshedValue, computedValue)) {
+            forceUpdate();
+            break;
+          }
+        }
+      };
+      eventBus.onChange(handleChange);
+      return () => {
+        eventBus.offChange(handleChange);
+      };
+    }
+  }, [computedValues, eventBus, forceUpdate, scene, values]);
+  if (returnAsObject) {
+    return values.reduce((acc, { key }) => {
+      acc[key] = computedValues[key];
+      return acc;
+    }, {});
+  }
+  return values.map(({ key }) => computedValues[key]);
+}
+
+exports.useComputedValues = useComputedValues;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/lib/vef-form/hooks/use-form-context.cjs

@@ -1,3 +1,21 @@
-/*! VefFramework version: 1.0.98, build time: 2025-03-07T07:45:28.961Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),{useContextSelector:t,useContext:o,ContextProvider:r}=e.createSelectableContext({autoExpand:!0,labelPosition:"top",layoutMode:"responsive"});exports.FormContextProvider=r,exports.useFormContext=o,exports.useFormContextSelector=t;
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const shared = require('@vef-framework/shared');
+
+const {
+  useContextSelector: useFormContextSelector,
+  useContext: useFormContext,
+  ContextProvider: FormContextProvider
+} = shared.createSelectableContext({
+  autoExpand: true,
+  labelPosition: "top",
+  layoutMode: "responsive"
+});
+
+exports.FormContextProvider = FormContextProvider;
+exports.useFormContext = useFormContext;
+exports.useFormContextSelector = useFormContextSelector;
 /*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */