@tachybase/client 0.23.8-alpha.21 → 0.23.8-alpha.22

package/lib/schema-component/antd/form-item/__tests__/hooks/useSpecialCase.test.mjs

@@ -0,0 +1,33 @@
+import * as __WEBPACK_EXTERNAL_MODULE__hooks_useSpecialCase_mjs__ from "../../hooks/useSpecialCase.mjs";
+
+;// CONCATENATED MODULE: external "../../hooks/useSpecialCase.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/__tests__/hooks/useSpecialCase.test.ts?__rslib_entry__
+
+describe('transformValue', ()=>{
+    it('value is an array', ()=>{
+        const value = [
+            {
+                a: 3
+            },
+            {
+                a: 4
+            }
+        ];
+        const deps = {
+            field: {
+                value: [
+                    {
+                        a: 1,
+                        b: 11
+                    }
+                ]
+            },
+            subFieldSchema: {
+                name: 'a'
+            }
+        };
+        expect((0,__WEBPACK_EXTERNAL_MODULE__hooks_useSpecialCase_mjs__.transformValue)(value, deps)).toMatchInlineSnapshot('\n      [\n        {\n          "a": {\n            "a": 3,\n          },\n          "b": 11,\n        },\n        {\n          "__notFromDatabase": true,\n          "a": {\n            "a": 4,\n          },\n          "b": 11,\n        },\n      ]\n    ');
+    });
+});
+

package/lib/schema-component/antd/form-item/__tests__/utils.test.mjs

@@ -0,0 +1,71 @@
+import * as __WEBPACK_EXTERNAL_MODULE__utils_mjs__ from "../utils.mjs";
+
+;// CONCATENATED MODULE: external "../utils.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/__tests__/utils.test.ts?__rslib_entry__
+
+describe('isFieldValueEmpty', ()=>{
+    it('should return true for empty array', ()=>{
+        const value = [];
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(true);
+    });
+    it('should return true for array with empty objects', ()=>{
+        const value = [
+            {
+                name: null
+            },
+            {
+                name: undefined
+            }
+        ];
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(true);
+    });
+    it('should return false for array with non-empty objects', ()=>{
+        const value = [
+            {
+                name: 'John'
+            },
+            {
+                name: 'Doe'
+            }
+        ];
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(false);
+    });
+    it('should return true for empty object', ()=>{
+        const value = {};
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(true);
+    });
+    it('should return true for object with null value', ()=>{
+        const value = {
+            name: null
+        };
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(true);
+    });
+    it('should return true for object with undefined value', ()=>{
+        const value = {
+            name: undefined
+        };
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(true);
+    });
+    it('should return false for object with non-empty value', ()=>{
+        const value = {
+            name: 'John'
+        };
+        const targetKey = 'name';
+        const result = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isFieldValueEmpty)(value, targetKey);
+        expect(result).toBe(false);
+    });
+});
+

package/lib/schema-component/antd/form-item/demos/demo1.mjs

@@ -0,0 +1,56 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__ from "react/jsx-runtime";
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_client__ from "@tachybase/client";
+import * as __WEBPACK_EXTERNAL_MODULE__testUtils_index_mjs__ from "../../../../testUtils/index.mjs";
+
+;// CONCATENATED MODULE: external "react/jsx-runtime"
+
+;// CONCATENATED MODULE: external "react"
+
+;// CONCATENATED MODULE: external "@tachybase/client"
+
+;// CONCATENATED MODULE: external "../../../../testUtils/index.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/demos/demo1.tsx?__rslib_entry__
+
+
+
+
+const { apiClient, mockRequest } = (0,__WEBPACK_EXTERNAL_MODULE__testUtils_index_mjs__.mockAPIClient)();
+mockRequest.onGet('/auth:check').reply(()=>{
+    return [
+        200,
+        {
+            data: {}
+        }
+    ];
+});
+const schema = {
+    type: 'object',
+    properties: {
+        input: {
+            type: 'string',
+            title: 'title',
+            'x-decorator': 'FormItem',
+            'x-component': 'Input'
+        }
+    }
+};
+/* ESM default export */ const demo1_rslib_entry_ = ((()=>{
+    return /*#__PURE__*/ (0,__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__.jsx)(__WEBPACK_EXTERNAL_MODULE__tachybase_client__.APIClientProvider, {
+        apiClient: apiClient,
+        children: /*#__PURE__*/ (0,__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__.jsx)(__WEBPACK_EXTERNAL_MODULE__tachybase_client__.CurrentUserProvider, {
+            children: /*#__PURE__*/ (0,__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__.jsx)(__WEBPACK_EXTERNAL_MODULE__tachybase_client__.FormProvider, {
+                children: /*#__PURE__*/ (0,__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime__.jsx)(__WEBPACK_EXTERNAL_MODULE__tachybase_client__.SchemaComponent, {
+                    components: {
+                        FormItem: __WEBPACK_EXTERNAL_MODULE__tachybase_client__.FormItem,
+                        Input: __WEBPACK_EXTERNAL_MODULE__tachybase_client__.Input
+                    },
+                    schema: schema
+                })
+            })
+        })
+    });
+}));
+
+export { demo1_rslib_entry_ as default };

package/lib/schema-component/antd/form-item/hooks/useLazyLoadDisplayAssociationFieldsOfForm.mjs

@@ -0,0 +1,135 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_schema__ from "@tachybase/schema";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_utils_client__ from "@tachybase/utils/client";
+import * as __WEBPACK_EXTERNAL_MODULE_lodash__ from "lodash";
+import * as __WEBPACK_EXTERNAL_MODULE__block_provider_hooks_index_mjs__ from "../../../../block-provider/hooks/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__ from "../../../../collection-manager/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__data_source_collection_record_CollectionRecordProvider_mjs__ from "../../../../data-source/collection-record/CollectionRecordProvider.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__flag_provider_index_mjs__ from "../../../../flag-provider/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_index_mjs__ from "../../../../variables/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_utils_transformVariableValue_mjs__ from "../../../../variables/utils/transformVariableValue.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__association_field_hooks_mjs__ from "../../association-field/hooks.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__utils_mjs__ from "../utils.mjs";
+
+;// CONCATENATED MODULE: external "react"
+
+;// CONCATENATED MODULE: external "@tachybase/schema"
+
+;// CONCATENATED MODULE: external "@tachybase/utils/client"
+
+;// CONCATENATED MODULE: external "lodash"
+
+;// CONCATENATED MODULE: external "../../../../block-provider/hooks/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../collection-manager/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../data-source/collection-record/CollectionRecordProvider.mjs"
+
+;// CONCATENATED MODULE: external "../../../../flag-provider/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/utils/transformVariableValue.mjs"
+
+;// CONCATENATED MODULE: external "../../association-field/hooks.mjs"
+
+;// CONCATENATED MODULE: external "../utils.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/hooks/useLazyLoadDisplayAssociationFieldsOfForm.ts?__rslib_entry__
+
+
+
+
+
+
+
+
+
+
+
+
+/**
+ * 用于懒加载 Form 卡片中只用于展示的关联字段的值
+ *
+ * - 在表单卡片中，有一个 Display association fields 的选项，这里面的字段，只是为了显示出相应的值，不可更改
+ * - 这里就是加载这些字段值的地方
+ */ const useLazyLoadDisplayAssociationFieldsOfForm = ()=>{
+    var _sourceCollectionFieldRef_current;
+    const { name } = (0,__WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__.useCollection_deprecated)();
+    const { getCollectionJoinField } = (0,__WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__.useCollectionManager_deprecated)();
+    const form = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useForm)();
+    const recordData = (0,__WEBPACK_EXTERNAL_MODULE__data_source_collection_record_CollectionRecordProvider_mjs__.useCollectionRecordData)();
+    const fieldSchema = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useFieldSchema)();
+    const variables = (0,__WEBPACK_EXTERNAL_MODULE__variables_index_mjs__.useVariables)();
+    const field = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useField)();
+    const { formValue: subFormValue } = (0,__WEBPACK_EXTERNAL_MODULE__association_field_hooks_mjs__.useSubFormValue)();
+    const { isInSubForm, isInSubTable } = (0,__WEBPACK_EXTERNAL_MODULE__flag_provider_index_mjs__.useFlag)() || {};
+    const { getAssociationAppends } = (0,__WEBPACK_EXTERNAL_MODULE__block_provider_hooks_index_mjs__.useAssociationNames)();
+    const schemaName = fieldSchema.name.toString();
+    const formValue = __WEBPACK_EXTERNAL_MODULE_lodash__["default"].cloneDeep(isInSubForm || isInSubTable ? subFormValue : form.values);
+    const collectionFieldRef = (0,__WEBPACK_EXTERNAL_MODULE_react__.useRef)(null);
+    const sourceCollectionFieldRef = (0,__WEBPACK_EXTERNAL_MODULE_react__.useRef)(null);
+    // 是否已经预加载了数据（通过 appends 的形式）
+    const hasPreloadData = (0,__WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>hasPreload(recordData, schemaName), [
+        recordData,
+        schemaName
+    ]);
+    if (collectionFieldRef.current == null && (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isDisplayField)(schemaName)) {
+        collectionFieldRef.current = getCollectionJoinField("".concat(name, ".").concat(schemaName));
+    }
+    if (sourceCollectionFieldRef.current == null && (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isDisplayField)(schemaName)) {
+        sourceCollectionFieldRef.current = getCollectionJoinField("".concat(name, ".").concat(schemaName.split('.')[0]));
+    }
+    const sourceKeyValue = (0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isDisplayField)(schemaName) && sourceCollectionFieldRef.current ? __WEBPACK_EXTERNAL_MODULE_lodash__["default"].get(formValue, "".concat(schemaName.split('.')[0], ".").concat(((_sourceCollectionFieldRef_current = sourceCollectionFieldRef.current) === null || _sourceCollectionFieldRef_current === void 0 ? void 0 : _sourceCollectionFieldRef_current.targetKey) || 'id')) : undefined;
+    (0,__WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        // 如果 schemaName 中是以 `.` 分割的，说明是一个关联字段，需要去获取关联字段的值；
+        // 在数据表管理页面，也存在 `a.b` 之类的 schema name，其 collectionName 为 fields，所以在这里排除一下 `name === 'fields'` 的情况
+        if (!(0,__WEBPACK_EXTERNAL_MODULE__utils_mjs__.isDisplayField)(schemaName) || !variables || name === 'fields' || !collectionFieldRef.current || hasPreloadData) {
+            return;
+        }
+        if (__WEBPACK_EXTERNAL_MODULE_lodash__["default"].isEmpty(formValue)) {
+            return;
+        }
+        const formVariable = {
+            name: '$nForm',
+            ctx: formValue,
+            collectionName: name
+        };
+        const variableString = "{{ $nForm.".concat(schemaName, " }}");
+        // 如果关系字段的 id 为空，则说明请求的数据还没有返回，此时还不能去解析变量
+        if (sourceKeyValue == null) {
+            return;
+        }
+        const { appends } = getAssociationAppends();
+        variables.parseVariable(variableString, formVariable, {
+            appends
+        }).then((value)=>{
+            (0,__WEBPACK_EXTERNAL_MODULE__tachybase_utils_client__.nextTick)(()=>{
+                const result = (0,__WEBPACK_EXTERNAL_MODULE__variables_utils_transformVariableValue_mjs__.transformVariableValue)(value, {
+                    targetCollectionField: collectionFieldRef.current
+                });
+                if (__WEBPACK_EXTERNAL_MODULE_lodash__["default"].isEmpty(result) && !__WEBPACK_EXTERNAL_MODULE_lodash__["default"].isNumber(result)) {
+                    field.value = null;
+                } else {
+                    field.value = result;
+                }
+            });
+        }).catch((err)=>{
+            console.error(err);
+        });
+    }, [
+        sourceKeyValue
+    ]);
+};
+/* ESM default export */ const useLazyLoadDisplayAssociationFieldsOfForm_rslib_entry_ = (useLazyLoadDisplayAssociationFieldsOfForm);
+/**
+ * 数据是否已被预加载
+ * @param record
+ * @param path
+ * @returns
+ */ function hasPreload(record, path) {
+    const value = __WEBPACK_EXTERNAL_MODULE_lodash__["default"].get(record, path);
+    return value != null && JSON.stringify(value) !== '[{}]' && JSON.stringify(value) !== '{}';
+}
+
+export { useLazyLoadDisplayAssociationFieldsOfForm_rslib_entry_ as default };

package/lib/schema-component/antd/form-item/hooks/useParseDefaultValue.mjs

@@ -0,0 +1,164 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_schema__ from "@tachybase/schema";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_utils_client__ from "@tachybase/utils/client";
+import * as __WEBPACK_EXTERNAL_MODULE_lodash__ from "lodash";
+import * as __WEBPACK_EXTERNAL_MODULE__record_provider_index_mjs__ from "../../../../record-provider/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__ from "../../../../collection-manager/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__data_source_collection_record_CollectionRecordProvider_mjs__ from "../../../../data-source/collection-record/CollectionRecordProvider.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__flag_provider_index_mjs__ from "../../../../flag-provider/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_index_mjs__ from "../../../../variables/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_utils_getPath_mjs__ from "../../../../variables/utils/getPath.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_utils_getVariableName_mjs__ from "../../../../variables/utils/getVariableName.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_utils_isVariable_mjs__ from "../../../../variables/utils/isVariable.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__variables_utils_transformVariableValue_mjs__ from "../../../../variables/utils/transformVariableValue.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__association_field_util_mjs__ from "../../association-field/util.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__useSpecialCase_mjs__ from "./useSpecialCase.mjs";
+
+;// CONCATENATED MODULE: external "react"
+
+;// CONCATENATED MODULE: external "@tachybase/schema"
+
+;// CONCATENATED MODULE: external "@tachybase/utils/client"
+
+;// CONCATENATED MODULE: external "lodash"
+
+;// CONCATENATED MODULE: external "../../../../record-provider/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../collection-manager/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../data-source/collection-record/CollectionRecordProvider.mjs"
+
+;// CONCATENATED MODULE: external "../../../../flag-provider/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/utils/getPath.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/utils/getVariableName.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/utils/isVariable.mjs"
+
+;// CONCATENATED MODULE: external "../../../../variables/utils/transformVariableValue.mjs"
+
+;// CONCATENATED MODULE: external "../../association-field/util.mjs"
+
+;// CONCATENATED MODULE: external "./useSpecialCase.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/hooks/useParseDefaultValue.ts?__rslib_entry__
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+/**
+ * 用于解析并设置 FormItem 的默认值
+ */ const useParseDefaultValue = ()=>{
+    const field = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useField)();
+    const fieldSchema = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useFieldSchema)();
+    const variables = (0,__WEBPACK_EXTERNAL_MODULE__variables_index_mjs__.useVariables)();
+    const localVariables = (0,__WEBPACK_EXTERNAL_MODULE__variables_index_mjs__.useLocalVariables)();
+    const recordV2 = (0,__WEBPACK_EXTERNAL_MODULE__data_source_collection_record_CollectionRecordProvider_mjs__.useCollectionRecord)();
+    const { isInAssignFieldValues, isInSetDefaultValueDialog, isInFormDataTemplate, isInSubTable, isInSubForm } = (0,__WEBPACK_EXTERNAL_MODULE__flag_provider_index_mjs__.useFlag)() || {};
+    const { getField } = (0,__WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__.useCollection_deprecated)();
+    const { isSpecialCase, setDefaultValue } = (0,__WEBPACK_EXTERNAL_MODULE__useSpecialCase_mjs__.useSpecialCase)();
+    const index = (0,__WEBPACK_EXTERNAL_MODULE__record_provider_index_mjs__.useRecordIndex)();
+    /**
+   * name: 如 $user
+   */ const findVariable = (0,__WEBPACK_EXTERNAL_MODULE_react__.useCallback)((name)=>{
+        let result = variables === null || variables === void 0 ? void 0 : variables.getVariable(name);
+        if (!result) {
+            result = localVariables.find((item)=>item.name === name);
+        }
+        return result;
+    }, [
+        localVariables,
+        variables
+    ]);
+    (0,__WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        if (fieldSchema.default == null || isInSetDefaultValueDialog || isInFormDataTemplate || (0,__WEBPACK_EXTERNAL_MODULE__association_field_util_mjs__.isSubMode)(fieldSchema) || !(recordV2 === null || recordV2 === void 0 ? void 0 : recordV2.isNew) && !isInAssignFieldValues) {
+            return;
+        }
+        const _run = async function() {
+            let { forceUpdate = false } = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
+            // 如果默认值是一个变量，则需要解析之后再显示出来
+            if (variables && field && ((0,__WEBPACK_EXTERNAL_MODULE__variables_utils_isVariable_mjs__.isVariable)(fieldSchema.default) && field.value == null || field.value === fieldSchema.default || forceUpdate)) {
+                // 一个变量字符串如果显示出来会比较奇怪
+                if ((0,__WEBPACK_EXTERNAL_MODULE__variables_utils_isVariable_mjs__.isVariable)(field.value)) {
+                    await field.reset({
+                        forceClear: true
+                    });
+                }
+                field.loading = true;
+                const collectionField = !fieldSchema.name.toString().includes('.') && getField(fieldSchema.name);
+                if (false) {}
+                const value = (0,__WEBPACK_EXTERNAL_MODULE__variables_utils_transformVariableValue_mjs__.transformVariableValue)(await variables.parseVariable(fieldSchema.default, localVariables), {
+                    targetCollectionField: collectionField
+                });
+                if (value == null || value === '') {
+                    // fix
+                    field.setInitialValue(null);
+                    await field.reset({
+                        forceClear: true
+                    });
+                } else if (isSpecialCase()) {
+                    // 只需要设置一次就可以了
+                    if (index === 0) {
+                        setDefaultValue(value);
+                    }
+                } else {
+                    field.setInitialValue(value);
+                }
+                field.loading = false;
+            // 如果不是一个有效的变量字符串（如：`{{ $user.name }}`）却依然包含 `{{` 和 `}}`，
+            // 则可以断定是一个需要 compile（`useCompile` 返回的函数） 的字符串，这样的字符串会由 formily 自动解析，无需在这里赋值
+            } else if (!/\{\{.+\}\}/g.test(fieldSchema.default) && field.setInitialValue) {
+                field.setInitialValue(fieldSchema.default);
+            }
+        };
+        // 使用防抖，提高性能和用户体验
+        const run = __WEBPACK_EXTERNAL_MODULE_lodash__["default"].debounce(_run, __WEBPACK_EXTERNAL_MODULE__variables_index_mjs__.DEBOUNCE_WAIT);
+        if ((0,__WEBPACK_EXTERNAL_MODULE__variables_utils_isVariable_mjs__.isVariable)(fieldSchema.default)) {
+            const variableName = (0,__WEBPACK_EXTERNAL_MODULE__variables_utils_getVariableName_mjs__.getVariableName)(fieldSchema.default);
+            const variable = findVariable(variableName);
+            if (!variable) {
+                return console.error("useParseDefaultValue: can not find variable ".concat(variableName));
+            }
+            _run();
+            // 实现联动的效果，当依赖的变量变化时（如 `$nForm` 变量），重新解析默认值
+            const dispose = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.reaction)(()=>{
+                const obj = {
+                    [variableName]: (variable === null || variable === void 0 ? void 0 : variable.ctx) || {}
+                };
+                const path = (0,__WEBPACK_EXTERNAL_MODULE__variables_utils_getPath_mjs__.getPath)(fieldSchema.default);
+                const value = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_utils_client__.getValuesByPath)(obj, path);
+                if (value === undefined) {
+                    // 返回一个随机值，确保能触发 run 函数
+                    return Math.random();
+                }
+                return value;
+            }, ()=>run({
+                    forceUpdate: true
+                }));
+            return dispose;
+        } else if (field.value == null && (isInSubTable || isInSubForm)) {
+            // 解决子表格（或子表单）中新增一行数据时，默认值不生效的问题
+            field.setValue(fieldSchema.default);
+        }
+    }, [
+        fieldSchema.default,
+        localVariables
+    ]);
+};
+/* ESM default export */ const useParseDefaultValue_rslib_entry_ = (useParseDefaultValue);
+
+export { useParseDefaultValue_rslib_entry_ as default };

package/lib/schema-component/antd/form-item/hooks/useSpecialCase.mjs

@@ -0,0 +1,182 @@
+import * as __WEBPACK_EXTERNAL_MODULE_react__ from "react";
+import * as __WEBPACK_EXTERNAL_MODULE__tachybase_schema__ from "@tachybase/schema";
+import * as __WEBPACK_EXTERNAL_MODULE_lodash__ from "lodash";
+import * as __WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__ from "../../../../collection-manager/index.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__data_source_collection_record_isNewRecord_mjs__ from "../../../../data-source/collection-record/isNewRecord.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__association_field_util_mjs__ from "../../association-field/util.mjs";
+
+;// CONCATENATED MODULE: external "react"
+
+;// CONCATENATED MODULE: external "@tachybase/schema"
+
+;// CONCATENATED MODULE: external "lodash"
+
+;// CONCATENATED MODULE: external "../../../../collection-manager/index.mjs"
+
+;// CONCATENATED MODULE: external "../../../../data-source/collection-record/isNewRecord.mjs"
+
+;// CONCATENATED MODULE: external "../../association-field/util.mjs"
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/hooks/useSpecialCase.ts?__rslib_entry__
+
+
+
+
+
+
+/**
+ * #### 处理 `子表单` 和 `子表格` 中的特殊情况
+ *
+ * - 提供一个判断当前是否是特殊情况的方法
+ * - 提供一个设置默认值的方法
+ */ const useSpecialCase = ()=>{
+    const form = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useForm)();
+    const fieldSchema = (0,__WEBPACK_EXTERNAL_MODULE__tachybase_schema__.useFieldSchema)();
+    const { getField } = (0,__WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__.useCollection_deprecated)();
+    const { getCollectionField } = (0,__WEBPACK_EXTERNAL_MODULE__collection_manager_index_mjs__.useCollectionManager_deprecated)();
+    const collectionField = (0,__WEBPACK_EXTERNAL_MODULE_react__.useMemo)(()=>{
+        return getField(fieldSchema.name);
+    }, [
+        fieldSchema.name,
+        getField
+    ]);
+    const isSpecialCase = (0,__WEBPACK_EXTERNAL_MODULE_react__.useCallback)(()=>{
+        return isSpecialCaseField({
+            collectionField,
+            fieldSchema,
+            getCollectionField
+        });
+    }, [
+        collectionField,
+        fieldSchema,
+        getCollectionField
+    ]);
+    const setDefaultValue = (0,__WEBPACK_EXTERNAL_MODULE_react__.useCallback)((value)=>{
+        const parentFieldSchema = getParentFieldSchema(fieldSchema);
+        if (parentFieldSchema) {
+            const parentField = form.query(parentFieldSchema.name).take();
+            if (parentField) {
+                parentField.setInitialValue(transformValue(value, {
+                    field: parentField,
+                    subFieldSchema: fieldSchema
+                }));
+            }
+        }
+    }, [
+        fieldSchema,
+        form
+    ]);
+    return {
+        /**
+     * 特殊情况指的是：当前字段是 `对一` 字段且存在于 `对多` 字段的 `子表格` 或 `子表单` 中
+     */ isSpecialCase,
+        setDefaultValue
+    };
+};
+/**
+ * 通过存在于 `子表格` 和 `子表单` 中的字段，获取父级字段的 fieldSchema
+ * @param fieldSchema
+ */ function getParentFieldSchema(fieldSchema) {
+    while(fieldSchema === null || fieldSchema === void 0 ? void 0 : fieldSchema.parent){
+        fieldSchema = fieldSchema.parent;
+        if ((0,__WEBPACK_EXTERNAL_MODULE__association_field_util_mjs__.isSubMode)(fieldSchema)) {
+            return fieldSchema;
+        }
+    }
+    return fieldSchema;
+}
+/**
+ * 特殊情况指的是：当前字段是 `对一` 字段且存在于 `对多` 字段的 `子表格` 或 `子表单` 中
+ * @returns
+ */ function isSpecialCaseField(param) {
+    let { collectionField, fieldSchema, getCollectionField } = param;
+    if (collectionField && [
+        'hasOne',
+        'belongsTo'
+    ].includes(collectionField.type) && fieldSchema) {
+        const parentFieldSchema = getParentFieldSchema(fieldSchema);
+        if (parentFieldSchema && parentFieldSchema['x-collection-field']) {
+            const parentCollectionField = getCollectionField(parentFieldSchema['x-collection-field']);
+            if ([
+                'hasMany',
+                'belongsToMany'
+            ].includes(parentCollectionField === null || parentCollectionField === void 0 ? void 0 : parentCollectionField.type)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * 将 `对多` 字段的子表单或子表格中的 `对一` 字段的值转换成 `对多` 字段的值
+ * @param value `子表单` 和 `子表格` 中的 `对一` 字段的经过解析之后的变量的值
+ * @param deps
+ * @returns
+ */ function transformValue(value, deps) {
+    const { field, subFieldSchema } = deps;
+    const oldValues = field.value;
+    let newValues = null;
+    if (Array.isArray(value)) {
+        newValues = value.map((item)=>{
+            return {
+                [subFieldSchema.name]: item
+            };
+        });
+    } else {
+        newValues = [
+            {
+                [subFieldSchema.name]: value
+            }
+        ];
+    }
+    const result = __WEBPACK_EXTERNAL_MODULE_lodash__["default"].assignWith([
+        ...oldValues
+    ], newValues, (oldValue, newValue)=>{
+        if (!oldValue && newValue) {
+            // 用于标记这个值不是从数据库中获取的
+            newValue.__notFromDatabase = true;
+        }
+        // 之所以取第一个值，是因为 `对一` 字段的默认值可能是异步的，导致会赋默认值值会晚于普通字段，导致普通字段的值会被覆盖
+        return __WEBPACK_EXTERNAL_MODULE_lodash__["default"].assign({
+            ...oldValues[0]
+        }, newValue);
+    });
+    return result;
+}
+/**
+ * 判断一个 record 是否是从数据库中获取的，如果是则返回 true，否则返回 false
+ * @param value useRecord  返回的值
+ * @returns boolean
+ */ function isFromDatabase(value) {
+    if (!value) {
+        return false;
+    }
+    return !value.__notFromDatabase;
+}
+/**
+ * 解决 `子表格` 中的 “一对多/多对一” 字段的默认值问题。
+ *
+ * 问题：如果子表格是空的，会导致默认值不会被设置，这是因为子表格中没有 FormItem 渲染，而设置默认值的逻辑就在 FormItem 中。
+ *
+ * 解决方法：
+ * 1. 如果子表格是空的，就设置一个值，这样会渲染出 FormItem。
+ * 2. 在 FormItem 中会设置默认值。
+ * 3. 如果子表格中没有设置默认值，就会再把子表格重置为空。
+ * @param param0
+ */ const useSubTableSpecialCase = (param)=>{
+    let { field } = param;
+    (0,__WEBPACK_EXTERNAL_MODULE_react__.useEffect)(()=>{
+        if (__WEBPACK_EXTERNAL_MODULE_lodash__["default"].isEmpty(field.value)) {
+            const value = field.value;
+            field.value = [
+                (0,__WEBPACK_EXTERNAL_MODULE__data_source_collection_record_isNewRecord_mjs__.markRecordAsNew)({})
+            ];
+            // 因为默认值的解析是异步的，所以下面的代码会优先于默认值的设置，这样就防止了设置完默认值后又被清空的问题
+            setTimeout(()=>{
+                field.value = value;
+            });
+        }
+    }, []);
+};
+
+export { getParentFieldSchema, isFromDatabase, isSpecialCaseField, transformValue, useSpecialCase, useSubTableSpecialCase };

package/lib/schema-component/antd/form-item/index.mjs

@@ -0,0 +1,11 @@
+export * from "./FormItem.mjs";
+export * from "./FormItem.Settings.mjs";
+export * from "./FormItem.FilterFormSettings.mjs";
+export * from "./SchemaSettingOptions.mjs";
+
+;// CONCATENATED MODULE: ./packages/client/src/schema-component/antd/form-item/index.tsx?__rslib_entry__
+
+
+
+
+