@vef-framework/components 1.0.97 → 1.0.99

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

@@ -1,3 +1,50 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),o=require("react");exports.useFormInitialization=function useFormInitialization(t,n){return o.useMemo((()=>{const o={...n},s={},r=[];for(const n of t){const{rows:t}=n;for(const n of t){const{columns:t}=n;for(const n of t){const{items:t}=n;for(const n of t){const{name:t,defaultValue:i,virtual:a}=n;!e.isNullish(i)&&e.isNullish(o[t])&&(o[t]=i),"Hidden"!==n.type&&e.isFunction(n.onChange)&&(s[t]=n.onChange),!0===a&&r.push(t)}}}}return{mergedInitialValues:o,valueChangeHandlers:s,virtualFieldNames: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');
+
+function useFormInitialization(schema, initialValues) {
+  return react.useMemo(() => {
+    const mergedInitialValues = {
+      ...initialValues
+    };
+    const valueChangeHandlers = {};
+    const virtualFieldNames = [];
+    for (const group of schema) {
+      const { rows } = group;
+      for (const row of rows) {
+        const { columns } = row;
+        for (const column of columns) {
+          const { items } = column;
+          for (const item of items) {
+            const {
+              name,
+              defaultValue,
+              virtual
+            } = item;
+            if (!shared.isNullish(defaultValue) && shared.isNullish(mergedInitialValues[name])) {
+              mergedInitialValues[name] = defaultValue;
+            }
+            if (item.type !== "Hidden" && shared.isFunction(item.onChange)) {
+              valueChangeHandlers[name] = item.onChange;
+            }
+            if (virtual === true) {
+              virtualFieldNames.push(name);
+            }
+          }
+        }
+      }
+    }
+    return {
+      mergedInitialValues,
+      valueChangeHandlers,
+      virtualFieldNames
+    };
+  }, []);
+}
+
+exports.useFormInitialization = useFormInitialization;
 /*! 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-instance.cjs

@@ -1,3 +1,31 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("react"),t=require("../store.cjs");exports.useFormInstance=function useFormInstance(s,u){const[r,o,n,i]=t.useFormStore((e=>[e.form,e.eventBus,e.getValues,e.setValues]));e.useImperativeHandle(s,(()=>({submit:()=>new Promise(((e,t)=>{const handleResult=s=>{o.offSubmitResult(handleResult),s?e():t(s)};o.onSubmitResult(handleResult),r.submit()})),reset:u,getValues:n,setValues: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 react = require('react');
+const store = require('../store.cjs');
+
+function useFormInstance(ref, reset) {
+  const [form, eventBus, getValues, setValues] = store.useFormStore((state) => [state.form, state.eventBus, state.getValues, state.setValues]);
+  react.useImperativeHandle(ref, () => ({
+    submit: () => new Promise((resolve, reject) => {
+      const handleResult = (result) => {
+        eventBus.offSubmitResult(handleResult);
+        if (result) {
+          resolve();
+        } else {
+          reject(result);
+        }
+      };
+      eventBus.onSubmitResult(handleResult);
+      form.submit();
+    }),
+    reset,
+    getValues,
+    setValues
+  }));
+}
+
+exports.useFormInstance = useFormInstance;
 /*! 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-values-change.cjs

@@ -1,3 +1,35 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),r=require("react"),n=require("../store.cjs");exports.useFormValuesChange=function useFormValuesChange(s){const[t,o,u]=n.useFormStore((e=>[e.scene,e.eventBus,e.invokeValueChangeHandlers])),a=r.useMemo((()=>(e,r)=>{o.emitChange(r)}),[o]);return r.useEffect((()=>{if(e.isFunction(s)){const handleChange=e=>{s(e,t)};return o.onChange(handleChange),()=>{o.offChange(handleChange)}}}),[o,s,t]),r.useLayoutEffect((()=>{u()}),[]),{handleValuesChange:a}};
+/*! 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 store = require('../store.cjs');
+
+function useFormValuesChange(onChange) {
+  const [scene, eventBus, invokeValueChangeHandlers] = store.useFormStore((state) => [state.scene, state.eventBus, state.invokeValueChangeHandlers]);
+  const handleValuesChange = react.useMemo(() => (_, values) => {
+    eventBus.emitChange(values);
+  }, [eventBus]);
+  react.useEffect(() => {
+    if (shared.isFunction(onChange)) {
+      const handleChange = (values) => {
+        onChange(values, scene);
+      };
+      eventBus.onChange(handleChange);
+      return () => {
+        eventBus.offChange(handleChange);
+      };
+    }
+  }, [eventBus, onChange, scene]);
+  react.useLayoutEffect(() => {
+    invokeValueChangeHandlers();
+  }, []);
+  return {
+    handleValuesChange
+  };
+}
+
+exports.useFormValuesChange = useFormValuesChange;
 /*! 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-label-width.cjs

@@ -1,3 +1,23 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),t=require("react");exports.useLabelWidth=function useLabelWidth(r,o){return t.useMemo((()=>{if("top"!==r&&o)return(o<60||o>120)&&e.showWarningMessage("The labelWidth of VefForm component must be between 60 and 120, otherwise it will be 60 or 120."),Math.min(Math.max(o,60),120)}),[r,o])};
+/*! 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');
+
+function useLabelWidth(labelPosition, labelWidth) {
+  const labelWidthToUse = react.useMemo(() => {
+    if (labelPosition === "top" || !labelWidth) {
+      return;
+    }
+    if (labelWidth < 60 || labelWidth > 120) {
+      shared.showWarningMessage("The labelWidth of VefForm component must be between 60 and 120, otherwise it will be 60 or 120.");
+    }
+    return Math.min(Math.max(labelWidth, 60), 120);
+  }, [labelPosition, labelWidth]);
+  return labelWidthToUse;
+}
+
+exports.useLabelWidth = useLabelWidth;
 /*! 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/index.cjs

@@ -1,5 +1,179 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("@emotion/react/jsx-runtime"),i=require("@emotion/react"),o=require("@vef-framework/hooks"),s=require("@vef-framework/shared"),t=require("antd"),r=require("react");require("../internal/index.cjs");const n=require("./components/form-actions.cjs"),a=require("./components/form-content.cjs"),u=require("./event.cjs"),l=require("./hooks/use-action-handlers.cjs"),m=require("./hooks/use-form-context.cjs"),c=require("./hooks/use-form-initialization.cjs"),d=require("./hooks/use-form-instance.cjs"),h=require("./hooks/use-form-values-change.cjs"),b=require("./hooks/use-label-width.cjs"),f=require("./store.cjs"),F=require("../internal/utils.cjs"),{useForm:p}=t.Form,v={scrollMode:"if-needed",behavior:"smooth"};const S=r.forwardRef((function VefFormBase({schema:u,labelAlign:c="right",variant:b,showTabs:p=!1,height:S="auto",size:j,disabled:q=!1,onChange:x,submissionButton:g,resetButton:V,submitApi:B,submitTip:C,onBeforeSubmit:k,onSubmit:w,onSubmitSuccess:M,onSubmitFailure:z,onReset:T},y){const[P,R]=m.useFormContextSelector((e=>[e.labelPosition,e.labelWidth])),[W,A,E]=f.useFormStore((e=>[e.form,e.initialValues,e.isLoading])),{handleValuesChange:N}=h.useFormValuesChange(x),{handleReset:H,handleSubmit:I,handleSubmitFailed:$}=l.useActionHandlers({submitApi:B,submitTip:C,onBeforeSubmit:k,onSubmit:w,onSubmitSuccess:M,onSubmitFailure:z,onReset:T});d.useFormInstance(y,H);const D=r.useMemo((()=>{if(R)return{flex:`0 0 ${R}px`}}),[R]),L=r.useMemo((()=>{let e=S;return"full"===S?e="100%":s.isNumber(S)&&(e=`${S}px`),i.css`
-      height: ${e};
-    `}),[S]),U=o.useContextDisabled()||q||E;return e.jsxs(t.Form,{labelWrap:!0,colon:!1,css:L,disabled:U,form:W,initialValues:A,labelAlign:c,labelCol:D,layout:"top"===P?"vertical":"horizontal",scrollToFirstError:v,size:F.convertBasicSizeToUiSize(j),variant:b,onFinish:I,onFinishFailed:$,onValuesChange:N,children:[e.jsx(a.default,{height:S,schema:u,showTabs:!0===p?"switch":p}),e.jsx(n.default,{handleReset:H,resetButton:V,submissionButton:g})]})}));S.displayName="VefFormBase";const j=r.memo(r.forwardRef((function VefFormWrapper({initialValues:i,scene:s,layoutMode:t="responsive",autoExpand:n=!1,labelPosition:a="top",labelWidth:l,...d},h){const{schema:F}=d,[v]=p(),j=o.useSingleton((()=>new u.FormEventBus));o.useUnmount((()=>{j.clear()}));const q=b.useLabelWidth(a,l),x=r.useMemo((()=>({labelPosition:a,labelWidth:q,autoExpand:n,layoutMode:t})),[t,n,a,q]),{mergedInitialValues:g,valueChangeHandlers:V,virtualFieldNames:B}=c.useFormInitialization(F,i),C=r.useMemo((()=>({eventBus:j,form:v,initialValues:g,scene:s,valueChangeHandlers:V,virtualFieldNames:B})),[j,v,g,s,V,B]);return e.jsx(f.FormStoreProvider,{initialState:C,children:e.jsx(m.FormContextProvider,{value:x,children:e.jsx(S,{ref:h,...d})})})})),((e,i)=>s.isDeepEqual(s.omit(e,["initialValues","schema"]),s.omit(i,["initialValues","schema"]))));j.displayName="VefForm",exports.default=j;
+/*! 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 react$1 = require('@emotion/react');
+const hooks = require('@vef-framework/hooks');
+const shared = require('@vef-framework/shared');
+const antd = require('antd');
+const react = require('react');
+require('../internal/index.cjs');
+const formActions = require('./components/form-actions.cjs');
+const formContent = require('./components/form-content.cjs');
+const event = require('./event.cjs');
+const useActionHandlers = require('./hooks/use-action-handlers.cjs');
+const useFormContext = require('./hooks/use-form-context.cjs');
+const useFormInitialization = require('./hooks/use-form-initialization.cjs');
+const useFormInstance = require('./hooks/use-form-instance.cjs');
+const useFormValuesChange = require('./hooks/use-form-values-change.cjs');
+const useLabelWidth = require('./hooks/use-label-width.cjs');
+const store = require('./store.cjs');
+const utils = require('../internal/utils.cjs');
+
+const { useForm } = antd.Form;
+const scrollToFirstErrorOptions = {
+  scrollMode: "if-needed",
+  behavior: "smooth"
+};
+function VefFormBase({
+  schema,
+  labelAlign = "right",
+  variant,
+  showTabs = false,
+  height = "auto",
+  size,
+  disabled = false,
+  onChange,
+  submissionButton,
+  resetButton,
+  submitApi,
+  submitTip,
+  onBeforeSubmit,
+  onSubmit,
+  onSubmitSuccess,
+  onSubmitFailure,
+  onReset
+}, ref) {
+  const [labelPosition, labelWidth] = useFormContext.useFormContextSelector((ctx) => [ctx.labelPosition, ctx.labelWidth]);
+  const [form, initialValues, isLoading] = store.useFormStore((state) => [state.form, state.initialValues, state.isLoading]);
+  const { handleValuesChange } = useFormValuesChange.useFormValuesChange(onChange);
+  const {
+    handleReset,
+    handleSubmit,
+    handleSubmitFailed
+  } = useActionHandlers.useActionHandlers({
+    submitApi,
+    submitTip,
+    onBeforeSubmit,
+    onSubmit,
+    onSubmitSuccess,
+    onSubmitFailure,
+    onReset
+  });
+  useFormInstance.useFormInstance(ref, handleReset);
+  const labelCol = react.useMemo(() => {
+    if (!labelWidth) {
+      return;
+    }
+    return { flex: `0 0 ${labelWidth}px` };
+  }, [labelWidth]);
+  const formStyle = react.useMemo(() => {
+    let heightValue = height;
+    if (height === "full") {
+      heightValue = "100%";
+    } else if (shared.isNumber(height)) {
+      heightValue = `${height}px`;
+    }
+    return react$1.css`
+      height: ${heightValue};
+    `;
+  }, [height]);
+  const contextDisabled = hooks.useContextDisabled();
+  const formDisabled = contextDisabled || disabled || isLoading;
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    antd.Form,
+    {
+      labelWrap: true,
+      colon: false,
+      css: formStyle,
+      disabled: formDisabled,
+      form,
+      initialValues,
+      labelAlign,
+      labelCol,
+      layout: labelPosition === "top" ? "vertical" : "horizontal",
+      scrollToFirstError: scrollToFirstErrorOptions,
+      size: utils.convertBasicSizeToUiSize(size),
+      variant,
+      onFinish: handleSubmit,
+      onFinishFailed: handleSubmitFailed,
+      onValuesChange: handleValuesChange,
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx(
+          formContent.default,
+          {
+            height,
+            schema,
+            showTabs: showTabs === true ? "switch" : showTabs
+          }
+        ),
+        /* @__PURE__ */ jsxRuntime.jsx(
+          formActions.default,
+          {
+            handleReset,
+            resetButton,
+            submissionButton
+          }
+        )
+      ]
+    }
+  );
+}
+const VefFormBaseForwarded = react.forwardRef(VefFormBase);
+VefFormBaseForwarded.displayName = "VefFormBase";
+function VefFormWrapper({
+  initialValues,
+  scene,
+  layoutMode = "responsive",
+  autoExpand = false,
+  labelPosition = "top",
+  labelWidth,
+  ...restProps
+}, ref) {
+  const { schema } = restProps;
+  const [form] = useForm();
+  const eventBus = hooks.useSingleton(() => new event.FormEventBus());
+  hooks.useUnmount(() => {
+    eventBus.clear();
+  });
+  const labelWidthToUse = useLabelWidth.useLabelWidth(labelPosition, labelWidth);
+  const formContext = react.useMemo(() => ({
+    labelPosition,
+    labelWidth: labelWidthToUse,
+    autoExpand,
+    layoutMode
+  }), [layoutMode, autoExpand, labelPosition, labelWidthToUse]);
+  const {
+    mergedInitialValues,
+    valueChangeHandlers,
+    virtualFieldNames
+  } = useFormInitialization.useFormInitialization(schema, initialValues);
+  const initialState = react.useMemo(() => ({
+    eventBus,
+    form,
+    initialValues: mergedInitialValues,
+    scene,
+    valueChangeHandlers,
+    virtualFieldNames
+  }), [eventBus, form, mergedInitialValues, scene, valueChangeHandlers, virtualFieldNames]);
+  return /* @__PURE__ */ jsxRuntime.jsx(store.FormStoreProvider, { initialState, children: /* @__PURE__ */ jsxRuntime.jsx(useFormContext.FormContextProvider, { value: formContext, children: /* @__PURE__ */ jsxRuntime.jsx(
+    VefFormBaseForwarded,
+    {
+      ref,
+      ...restProps
+    }
+  ) }) });
+}
+const VefForm = react.memo(
+  react.forwardRef(VefFormWrapper),
+  (prevProps, nextProps) => shared.isDeepEqual(
+    shared.omit(prevProps, ["initialValues", "schema"]),
+    shared.omit(nextProps, ["initialValues", "schema"])
+  )
+);
+VefForm.displayName = "VefForm";
+
+exports.default = VefForm;
 /*! 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/props.cjs

@@ -1,3 +1,5 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+
 /*! 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/store.cjs

@@ -1,3 +1,72 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vef-framework/shared"),{StoreProvider:s,useStore:t,useStoreApi:o}=e.createComponentStore("Form",(s=>(t,o)=>({...s,invokeValueChangeHandlers(e,s){const{scene:t,valueChangeHandlers:r,initialValues:n,setValues:i}=o(),a=e??n,l=s?new Set(s):null;for(const[e,s]of Object.entries(r))l&&!l.has(e)||s(a[e]??null,{values:a,scene:t,setValues:i})},getValues(){const{form:e,initialValues:s}=o();return e.isFieldsTouched(!0)?s:e.getFieldsValue()},setValues(s){const{form:t,eventBus:r,invokeValueChangeHandlers:n}=o(),i=t.getFieldsValue(),a=Object.keys(s).filter((t=>!e.isDeepEqual(s[t],i[t])));t.setFieldsValue(s);const l=t.getFieldsValue();r.emitChange(l),n(l,a)},isLoading:!1,setIsLoading(e){t({isLoading:e})},showActionButtons:!0,setShowActionButtons(e){t({showActionButtons:e})}})));exports.FormStoreProvider=s,exports.useFormStore=t,exports.useFormStoreApi=o;
+/*! 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 {
+  StoreProvider: FormStoreProvider,
+  useStore: useFormStore,
+  useStoreApi: useFormStoreApi
+} = shared.createComponentStore(
+  "Form",
+  (initialState) => (set, get) => ({
+    ...initialState,
+    invokeValueChangeHandlers(values, keys) {
+      const {
+        scene,
+        valueChangeHandlers,
+        initialValues,
+        setValues
+      } = get();
+      const valuesToUse = values ?? initialValues;
+      const keySet = keys ? new Set(keys) : null;
+      for (const [name, handler] of Object.entries(valueChangeHandlers)) {
+        if (!keySet || keySet.has(name)) {
+          handler(
+            valuesToUse[name] ?? null,
+            {
+              values: valuesToUse,
+              scene,
+              setValues
+            }
+          );
+        }
+      }
+    },
+    getValues() {
+      const { form, initialValues } = get();
+      if (!form.isFieldsTouched(true)) {
+        return form.getFieldsValue();
+      }
+      return initialValues;
+    },
+    setValues(values) {
+      const {
+        form,
+        eventBus,
+        invokeValueChangeHandlers
+      } = get();
+      const previousValues = form.getFieldsValue();
+      const changedKeys = Object.keys(values).filter((key) => !shared.isDeepEqual(values[key], previousValues[key]));
+      form.setFieldsValue(values);
+      const currentValues = form.getFieldsValue();
+      eventBus.emitChange(currentValues);
+      invokeValueChangeHandlers(currentValues, changedKeys);
+    },
+    isLoading: false,
+    setIsLoading(isLoading) {
+      set({ isLoading });
+    },
+    showActionButtons: true,
+    setShowActionButtons(showActionButtons) {
+      set({ showActionButtons });
+    }
+  })
+);
+
+exports.FormStoreProvider = FormStoreProvider;
+exports.useFormStore = useFormStore;
+exports.useFormStoreApi = useFormStoreApi;
 /*! 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/types.cjs

@@ -1,3 +1,5 @@
-/*! VefFramework version: 1.0.97, build time: 2025-03-06T12:24:36.991Z, made by Venus. */
-"use strict";
+/*! VefFramework version: 1.0.99, build time: 2025-03-07T13:41:55.865Z, made by Venus. */
+'use strict';
+
+
 /*! 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 */