@geelato/gl-ui-web-arco 0.0.1

package/dist/types/components/gl-entity-form/composables/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * GlEntityForm 组合式函数导出文件
+ * 统一导出所有组合式函数，方便使用和管理
+ */
+export { useFormValidation, validationUtils, ValidateResult } from './useFormValidation';
+export type { UseFormValidationOptions, UseFormValidationReturn, ValidatedError } from './useFormValidation';
+export { useFormCore } from './useFormCore';
+export type { FormItem, UseFormCoreOptions } from './useFormCore';
+export { useFormParams, mixFormParams, isEmptyParams } from './useFormParams';
+export { useEmpty } from './useEmpty';
+export type LayoutType = 'inline' | 'horizontal' | 'vertical';
+export declare const SaveMode: {
+    NORMAL: string;
+    SUB: string;
+    NO_SAVE: string;
+};

package/dist/types/components/gl-entity-form/composables/useEmpty.d.ts

@@ -0,0 +1,9 @@
+import { Ref, ComputedRef } from '../../../../vue/dist/vue.esm-bundler.js';
+export declare const useEmpty: (options: {
+    glIsRuntime?: boolean;
+    dataEmptyShowMode?: string;
+}) => {
+    isLastFetchedDataEmpty: Ref<boolean, boolean>;
+    customEmptyContent: ComputedRef<string>;
+    showCustomEmptyContent: ComputedRef<boolean | "" | undefined>;
+};

package/dist/types/components/gl-entity-form/composables/useFormCore.d.ts

@@ -0,0 +1,560 @@
+import { Ref } from '../../../../vue/dist/vue.esm-bundler.js';
+import { IComponentInstance } from '@geelato/gl-types';
+import { PageProvideProxy } from '@geelato/gl-runtime-core';
+export interface FormItem {
+    fieldName: string;
+    componentInst: IComponentInstance;
+    componentName: string;
+    label: string;
+    value: any;
+    isFormSubTable: boolean;
+    /**
+     * 是否为“外键实体额外字段”
+     *
+     * 场景：GlEntityForm 在加载数据时支持 ref(xxx->yyy) 的写法，把外键实体的字段值一起查出来。
+     * 例如：ref(portOfDischargeId->shortName) shortName
+     * 其中 shortName（alias 或 referenceField）并不是当前表的真实字段，写回/保存会导致后端校验失败或保存异常。
+     *
+     * 因此对这些字段做隔离：
+     * - 组件仍然可以展示/编辑该值
+     * - 但不会写入 formRecord（formRecord 是保存用数据源）
+     * - 统一写入 foreignKeyExtraRecord（独立响应式对象）
+     */
+    isForeignKeyExtra?: boolean;
+    [key: string]: any;
+}
+export interface UseFormCoreOptions {
+    props: any;
+    /** 页面代理对象 */
+    pageProvideProxy: PageProvideProxy;
+    formProvideProxy: any;
+    /** 事件发射器 */
+    emits: any;
+    /** 全局对象 */
+    global: any;
+}
+/**
+ * 表单项管理核心组合式函数
+ * 负责表单项的构建、值设置、数据类型转换等功能
+ */
+export declare function useFormCore(options: UseFormCoreOptions): {
+    formKey: any;
+    entityRecordId: Ref<string, string>;
+    copyEntityRecordId: Ref<string, string>;
+    formItems: Ref<{
+        [x: string]: any;
+        fieldName: string;
+        componentInst: {
+            id: string;
+            __idPrefix?: string | undefined;
+            title?: string | undefined;
+            __subTitle?: string | undefined;
+            __remark?: string | undefined;
+            componentName: string;
+            group?: string | undefined;
+            vModelName?: string | undefined;
+            props: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            };
+            propsExpressions?: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            } | undefined;
+            slots: {
+                [x: string]: any;
+                propsTarget?: string | undefined;
+                propsName?: string | undefined;
+            };
+            slotsExpressions?: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            } | undefined;
+            children: /*elided*/ any[];
+            actions: {
+                id?: string | undefined;
+                eventName: string;
+                name: string;
+                title: string;
+                body?: string | undefined;
+                __commandBlock?: /*elided*/ any | undefined;
+            }[];
+            extra?: /*elided*/ any | undefined;
+            style?: Object | undefined;
+            propsWrapper?: string | undefined;
+            i18n?: {
+                [x: string]: any;
+                'zh-CN': string;
+                'en-US': string;
+            }[] | undefined;
+            value?: string | number | boolean | object | any[] | undefined;
+            disabledDnd?: boolean | undefined;
+            disabledSelect?: boolean | undefined;
+            refId?: string | undefined;
+            refObject?: Object | undefined;
+            _disabled?: boolean | undefined;
+            __isTemplateInst?: boolean | undefined;
+            __isInnerComponent?: boolean | undefined;
+            __isInvokeBlock?: boolean | undefined;
+            __invokeBlockPlaceholder?: string | undefined;
+            __validateError?: any;
+            __dragFlag?: string | undefined;
+            __commandBlock?: /*elided*/ any | undefined;
+            perms?: {
+                r?: number | undefined;
+                w?: number | undefined;
+            } | undefined;
+            __perms?: {
+                r: {
+                    id: string;
+                    name: string;
+                    enabled: number;
+                };
+                w: {
+                    id: string;
+                    name: string;
+                    enabled: number;
+                };
+            } | undefined;
+        };
+        componentName: string;
+        label: string;
+        value: any;
+        isFormSubTable: boolean;
+        isForeignKeyExtra?: boolean | undefined;
+    }[], FormItem[] | {
+        [x: string]: any;
+        fieldName: string;
+        componentInst: {
+            id: string;
+            __idPrefix?: string | undefined;
+            title?: string | undefined;
+            __subTitle?: string | undefined;
+            __remark?: string | undefined;
+            componentName: string;
+            group?: string | undefined;
+            vModelName?: string | undefined;
+            props: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            };
+            propsExpressions?: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            } | undefined;
+            slots: {
+                [x: string]: any;
+                propsTarget?: string | undefined;
+                propsName?: string | undefined;
+            };
+            slotsExpressions?: {
+                [x: string]: any;
+                label?: string | undefined;
+                bindField?: {
+                    appCode: string;
+                    entityName: string;
+                    fieldName: string;
+                } | undefined;
+                placeholder?: string | undefined;
+                description?: string | undefined;
+                _valueExpression?: any;
+                disabled?: boolean | undefined;
+                readonly?: boolean | undefined;
+                unRender?: boolean | undefined;
+                _hidden?: boolean | undefined;
+                rules?: {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                } | {
+                    type?: "string" | "number" | "boolean" | "array" | "object" | "email" | "url" | "ip" | undefined;
+                    required?: boolean | undefined;
+                    message?: string | undefined;
+                    length?: number | undefined;
+                    maxLength?: number | undefined;
+                    minLength?: number | undefined;
+                    match?: RegExp | undefined;
+                    uppercase?: boolean | undefined;
+                    lowercase?: boolean | undefined;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    equal?: number | undefined;
+                    positive?: boolean | undefined;
+                    negative?: boolean | undefined;
+                    true?: boolean | undefined;
+                    false?: boolean | undefined;
+                    includes?: any[] | undefined;
+                    deepEqual?: any;
+                    empty?: boolean | undefined;
+                    hasKeys?: string[] | undefined;
+                    validator?: ((value: any, callback: (error?: string) => void) => void) | undefined;
+                }[] | undefined;
+            } | undefined;
+            children: /*elided*/ any[];
+            actions: {
+                id?: string | undefined;
+                eventName: string;
+                name: string;
+                title: string;
+                body?: string | undefined;
+                __commandBlock?: /*elided*/ any | undefined;
+            }[];
+            extra?: /*elided*/ any | undefined;
+            style?: Object | undefined;
+            propsWrapper?: string | undefined;
+            i18n?: {
+                [x: string]: any;
+                'zh-CN': string;
+                'en-US': string;
+            }[] | undefined;
+            value?: string | number | boolean | object | any[] | undefined;
+            disabledDnd?: boolean | undefined;
+            disabledSelect?: boolean | undefined;
+            refId?: string | undefined;
+            refObject?: Object | undefined;
+            _disabled?: boolean | undefined;
+            __isTemplateInst?: boolean | undefined;
+            __isInnerComponent?: boolean | undefined;
+            __isInvokeBlock?: boolean | undefined;
+            __invokeBlockPlaceholder?: string | undefined;
+            __validateError?: any;
+            __dragFlag?: string | undefined;
+            __commandBlock?: /*elided*/ any | undefined;
+            perms?: {
+                r?: number | undefined;
+                w?: number | undefined;
+            } | undefined;
+            __perms?: {
+                r: {
+                    id: string;
+                    name: string;
+                    enabled: number;
+                };
+                w: {
+                    id: string;
+                    name: string;
+                    enabled: number;
+                };
+            } | undefined;
+        };
+        componentName: string;
+        label: string;
+        value: any;
+        isFormSubTable: boolean;
+        isForeignKeyExtra?: boolean | undefined;
+    }[]>;
+    foreignKeyExtraRecord: Ref<any, any>;
+    subFormInstIds: Ref<string[], string[]>;
+    buildFormItems: () => void;
+    getRecord: () => Ref<any, any>;
+    getForeignKeyExtraRecord: () => Ref<any, any>;
+    updateForm: (record: Record<string, any>, isInit?: boolean) => void;
+    getFieldNames: () => string[];
+    clearFormItems: () => void;
+    checkValidDataEntry: (componentName: string) => boolean;
+    setupValueWatchers: (onChange?: (fieldName: string, newValue: any, oldValue: any) => void) => void;
+    clearValueWatchers: () => void;
+};

package/dist/types/components/gl-entity-form/composables/useFormParams.d.ts

@@ -0,0 +1,30 @@
+import { Param, PageProvideProxy } from '@geelato/gl-runtime-core';
+export declare function useFormParams(options: {
+    props: any;
+    pageProvideProxy: any;
+}): {
+    getFormParams: () => any;
+    resetFormParams: () => any;
+};
+/**
+ *
+ * 取值方式A、通过默认通用关键字form获取的表单值，好处就是在配置打开页面传参时，不需要配置具体表单名，配置方便
+ * 取值方式B、同时支持通过关键字$form来获取表单值
+ * 取值方式C、同时支持通过当前表单绑定的对象实体名称来获取表单值, 比如：il_eco.id,il_eco为实体名称
+ * 取值方式D、同时支持通过组件属性传参，比如：params=[{name: 'id', value: 1}]
+ * 取值方式D，会覆盖方式C、会覆盖B方式，会覆盖A方式
+ * ！！！注意，该方式在同一页面多表单嵌套时，通过form或$form很可能会污染子级表单的值，没法做到精确控制表单传值
+ * @param pageProvideProxy
+ * @param bindEntity
+ * @param params
+ */
+export declare const mixFormParams: (pageProvideProxy: PageProvideProxy, bindEntity?: Record<string, any>, params?: Array<Param>) => {
+    [key: string]: any;
+};
+/**
+ * 检查参数是否为空
+ */
+export declare const isEmptyParams: (params?: {
+    id: string;
+    [key: string]: any;
+}) => boolean;