@gct-paas/core-web 0.1.4-dev.8 → 0.1.5-dev.0

package/es/modules/gct-form/interface/i-controller/form-collapse-pane/form-collapse-pane.controller.d.ts

@@ -0,0 +1,23 @@
+import { IFormCollapsePane } from '../../i-form';
+import { IFormCollapsePaneState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单折叠面板项
+ * @author lingxiaoming
+ * @date 2024-07-14 01:53:49
+ * @export
+ * @interface IFormCollapsePaneController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormCollapsePaneController<M extends IFormCollapsePane = IFormCollapsePane, S extends IFormCollapsePaneState = IFormCollapsePaneState> extends IFormItemBasicController<M, S> {
+    /**
+     * 折叠面板项类型
+     *
+     * @author lingxiaoming
+     * @date 2024-07-14 01:56:56
+     * @type {'collapse-pane'}
+     */
+    type: 'collapse-pane';
+}

package/es/modules/gct-form/interface/i-controller/form-edit-item/form-edit-item.controller.d.ts

@@ -0,0 +1,59 @@
+import { IFormEditItem } from '../../i-form';
+import { IFormEditItemState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单编辑项控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 20:04:55
+ * @export
+ * @interface IFormEditItemController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormEditItemController<M extends IFormEditItem = IFormEditItem, S extends IFormEditItemState = IFormEditItemState> extends IFormItemBasicController<M, S> {
+    /**
+     * 获取值
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 09:04:18
+     * @return {*}  {*}
+     */
+    value: any;
+    /**
+     * 编辑器使用的值(兼容多值处理)
+     *
+     * @author lingxiaoming
+     * @date 2024-07-18 10:37:37
+     * @type {*}
+     */
+    editorValue: any;
+    /**
+     * 项数据键
+     *
+     * @author zhanghanrui
+     * @date 2024-04-03 11:04:21
+     * @type {string}
+     */
+    key: string;
+    /**
+     * 重置表单项值
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 20:04:15
+     */
+    reset(): void;
+    /**
+     * 设置默认值
+     *
+     * @author zhanghanrui
+     * @date 2024-08-06 10:08:15
+     */
+    defaultValue(): void;
+    /**
+     * 失焦
+     *
+     */
+    blur(): void;
+}

package/es/modules/gct-form/interface/i-controller/form-group/form-group.controller.d.ts

@@ -0,0 +1,24 @@
+import { IFormGroup } from '../../i-form';
+import { IFormGroupState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:04
+ * @export
+ * @interface IFormGroupController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormGroupController<M extends IFormGroup = IFormGroup, S extends IFormGroupState = IFormGroupState> extends IFormItemBasicController<M, S> {
+    /**
+     * 分组类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:50
+     * @type {'group'}
+     */
+    type: 'group';
+}

package/es/modules/gct-form/interface/i-controller/form-hidden-item/form-hidden-item.controller.d.ts

@@ -0,0 +1,24 @@
+import { IFormHiddenItem } from '../../i-form';
+import { IFormHiddenItemState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 隐藏表单项控制器，只存在逻辑，不会渲染元素
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:24
+ * @export
+ * @interface IFormHiddenItemController
+ * @extends {IFormEditItemController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormHiddenItemController<M extends IFormHiddenItem = IFormHiddenItem, S extends IFormHiddenItemState = IFormHiddenItemState> extends IFormItemBasicController<M, S> {
+    /**
+     * 隐藏表单项类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:46
+     * @type {'hidden'}
+     */
+    type: 'hidden';
+}

package/es/modules/gct-form/interface/i-controller/form-item/form-item.controller.d.ts

@@ -0,0 +1,40 @@
+import { IFormItem } from '../../i-form';
+import { IDictionaryItem } from '@gct-paas/core';
+import { IFormItemState } from '../../i-state';
+import { IFormEditItemController } from '../form-edit-item/form-edit-item.controller';
+/**
+ * 表单项控制器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:21
+ * @export
+ * @interface IFormItemController
+ * @extends {IFormEditItemController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormItemController<M extends IFormItem = IFormItem, S extends IFormItemState = IFormItemState> extends IFormEditItemController<M, S> {
+    /**
+     * 项类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:59
+     * @type {'item'}
+     */
+    type: 'item';
+    /**
+     * 加载动态代码表
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 21:04:02
+     * @return {*}  {Promise<IDictionaryItem[]>}
+     */
+    loadDictionary(params?: IParams, force?: boolean): Promise<IDictionaryItem[]>;
+    /**
+     * 清空现有代码表
+     *
+     * @author zhanghanrui
+     * @date 2024-04-03 14:04:05
+     */
+    clearDictionary(): void;
+}

package/es/modules/gct-form/interface/i-controller/form-item-basic/form-item-basic.controller.d.ts

@@ -0,0 +1,51 @@
+import { IFormItemBasic } from '../../i-form';
+import { IFormItemBasicState } from '../../i-state';
+/**
+ * 表单项基础接口
+ *
+ * @author zhanghanrui
+ * @date 2024-04-01 14:04:46
+ * @export
+ * @interface IFormItemBasicController
+ */
+export interface IFormItemBasicController<M extends IFormItemBasic = IFormItemBasic, S extends IFormItemBasicState = IFormItemBasicState> {
+    /**
+     * 表单项类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:54
+     * @type {string} 表单项类型具体子实现定义
+     */
+    type: string;
+    /**
+     * 表单数据
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 10:04:48
+     * @type {IData}
+     */
+    readonly data: IData;
+    /**
+     * 表单项模型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:42
+     * @type {IFormItemBasic}
+     */
+    readonly model: M;
+    /**
+     * 表单项状态
+     *
+     * @author zhanghanrui
+     * @date 2024-04-01 14:04:15
+     * @type {IFormItemBasicState}
+     */
+    state: S;
+    /**
+     * 表单销毁调用
+     *
+     * @author zhanghanrui
+     * @date 2024-04-03 16:04:32
+     */
+    destroy(): void;
+}

package/es/modules/gct-form/interface/i-controller/form-line/form-line.controller.d.ts

@@ -0,0 +1,20 @@
+import { IFormLine } from '../../i-form';
+import { IFormLineState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分组
+ *
+ * @export
+ * @interface IFormLineController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormLineController<M extends IFormLine = IFormLine, S extends IFormLineState = IFormLineState> extends IFormItemBasicController<M, S> {
+    /**
+     * 分组类型
+     *
+     * @type {'line'}
+     */
+    type: 'line';
+}

package/es/modules/gct-form/interface/i-controller/form-tab/form-tab.controller.d.ts

@@ -0,0 +1,23 @@
+import { IFormTab } from '../../i-form';
+import { IFormTabState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分页
+ * @author lingxiaoming
+ * @date 2024-07-14 01:53:49
+ * @export
+ * @interface IFormTabController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormTabController<M extends IFormTab = IFormTab, S extends IFormTabState = IFormTabState> extends IFormItemBasicController<M, S> {
+    /**
+     * 分页类型
+     *
+     * @author lingxiaoming
+     * @date 2024-07-14 01:56:56
+     * @type {'tab'}
+     */
+    type: 'tab';
+}

package/es/modules/gct-form/interface/i-controller/form-tab-pane/form-tab-pane.controller.d.ts

@@ -0,0 +1,23 @@
+import { IFormTabPane } from '../../i-form';
+import { IFormTabPaneState } from '../../i-state';
+import { IFormItemBasicController } from '../form-item-basic/form-item-basic.controller';
+/**
+ * 表单分页
+ * @author lingxiaoming
+ * @date 2024-07-14 01:53:49
+ * @export
+ * @interface IFormTabPaneController
+ * @extends {IFormItemBasicController<M, S>}
+ * @template M
+ * @template S
+ */
+export interface IFormTabPaneController<M extends IFormTabPane = IFormTabPane, S extends IFormTabPaneState = IFormTabPaneState> extends IFormItemBasicController<M, S> {
+    /**
+     * 分页pane类型
+     *
+     * @author lingxiaoming
+     * @date 2024-07-14 01:56:56
+     * @type {'tab-pane'}
+     */
+    type: 'tab-pane';
+}

package/es/modules/gct-form/interface/i-controller/index.d.ts

@@ -0,0 +1,13 @@
+export type { IEditFormController } from './edit-form/edit-form.controller';
+export type { IEditorController } from './editor-item/editor-item.controller';
+export type { IFormController } from './form/form.controller';
+export type { IFormCollapsePaneController } from './form-collapse-pane/form-collapse-pane.controller';
+export type { IFormCollapseController } from './form-collapse/form-collapse.controller';
+export type { IFormEditItemController } from './form-edit-item/form-edit-item.controller';
+export type { IFormGroupController } from './form-group/form-group.controller';
+export type { IFormTabController } from './form-tab/form-tab.controller';
+export type { IFormTabPaneController } from './form-tab-pane/form-tab-pane.controller';
+export type { IFormHiddenItemController } from './form-hidden-item/form-hidden-item.controller';
+export type { IFormItemController } from './form-item/form-item.controller';
+export type { IFormItemBasicController } from './form-item-basic/form-item-basic.controller';
+export type { IFormLineController } from './form-line/form-line.controller';

package/es/modules/gct-form/interface/i-editor/i-action-editor.d.ts

@@ -0,0 +1,23 @@
+import { IEditorBasic } from './i-editor-basic';
+import { EditorType } from '../../constants';
+import { IFormController, IFormEditItemController } from '../i-controller';
+export interface IActionEditor extends IEditorBasic {
+    readonly type: EditorType.ACTION;
+    /**
+     * 按钮名称
+     *
+     * @type {string}
+     */
+    label?: string;
+    /**
+     * 按钮图标
+     *
+     * @type {string}
+     */
+    icon?: string;
+    /**
+     * 按钮点击
+     *
+     */
+    click?: (e: MouseEvent, from: IFormController, item: IFormEditItemController, data: IData) => void;
+}

package/es/modules/gct-form/interface/i-editor/i-check-switch.d.ts

@@ -0,0 +1,29 @@
+import { IEditorBasic } from './i-editor-basic';
+import { EditorType } from '../../constants';
+/**
+ * 复选框滑块编辑器
+ *
+ * @author zhanghanrui
+ * @date 2024-04-02 11:04:43
+ * @export
+ * @interface ICheckSwitchEditor
+ * @extends {IEditorBasic}
+ */
+export interface ICheckSwitchEditor extends IEditorBasic {
+    readonly type: EditorType.CHECK_SWITCH;
+    /**
+     * 标签名称
+     *
+     * @author zhanghanrui
+     * @date 2024-08-23 17:08:55
+     * @type {string}
+     */
+    label?: string;
+    /**
+     * 是否是开关
+     * @author lingxiaoming
+     * @date 2024-07-18 06:55:27
+     * @type {boolean}
+     */
+    isSwitch?: boolean;
+}

package/es/modules/gct-form/interface/i-editor/i-checkbox-editor.d.ts

@@ -0,0 +1,11 @@
+import { IEditorBasic } from './i-editor-basic';
+import { EditorType } from '../../constants';
+export interface ICheckboxEditor extends IEditorBasic {
+    readonly type: EditorType.CHECKBOX;
+    /**子项的布局方式 */
+    layout: 'row' | 'column';
+    /**最少选择几项 */
+    minLength?: number;
+    /**是否支持拖拽排序 */
+    isDrag?: boolean;
+}

package/es/modules/gct-form/interface/i-editor/i-color-editor.d.ts

@@ -0,0 +1,13 @@
+import { EditorType } from '../../constants';
+import { IEditorBasic } from './i-editor-basic';
+/**
+ * 颜色选择编辑器模型
+ * @author lingxiaoming
+ * @date 2024-07-17 04:32:52
+ * @export
+ * @interface IColor
+ * @extends {IEditorBasic}
+ */
+export interface IColorEditor extends IEditorBasic {
+    readonly type: EditorType.COLOR;
+}

package/es/modules/gct-form/interface/i-editor/i-date-format-select-editor.d.ts

@@ -0,0 +1,36 @@
+import { IEditorBasic } from './i-editor-basic';
+/**
+ * 级联选择编辑器接口
+ *
+ * @author chitanda
+ * @date 2025-06-23 17:06:28
+ * @export
+ * @interface IDateFormatSelectEditor
+ * @extends {IEditorBasic}
+ */
+export interface IDateFormatSelectEditor extends IEditorBasic {
+    /**
+     * 分割符存储的配置项
+     *
+     * @author chitanda
+     * @date 2025-06-23 19:06:22
+     * @type {string}
+     */
+    separatorKey?: string;
+    /**
+     * 字段类型标识，默认取 key 值
+     *
+     * @author chitanda
+     * @date 2025-06-23 18:06:47
+     * @type {string}
+     */
+    fieldTypeKey?: string;
+    /**
+     * 字段映射类型标识，默认取 mapping_type
+     *
+     * @author chitanda
+     * @date 2025-06-30 13:06:55
+     * @type {string}
+     */
+    mappingTypeKey?: string;
+}

package/es/modules/gct-form/interface/i-editor/i-editor-basic.d.ts

@@ -0,0 +1,134 @@
+import { ClassValue, StyleValue } from 'vue';
+import { IFormEditItemController } from '../i-controller';
+import { IEditorProvider } from '../i-provider';
+import { IFormItem } from '../i-form/i-form-item';
+/**
+ * 编辑器基础接口
+ *
+ * @author zhanghanrui
+ * @date 2024-03-27 09:03:59
+ * @export
+ * @interface IEditorBasic
+ */
+export interface IEditorBasic {
+    /**
+     * 编辑器类型
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 17:04:57
+     * @type {string}
+     */
+    type: string;
+    /**
+     * 输入框占提示位符
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 11:04:14
+     * @type {string}
+     */
+    placeholder?: string;
+    /**
+     * 格式化配置
+     *
+     * @author zhanghanrui
+     * @date 2024-04-08 15:04:01
+     */
+    format?: string | ((data: IData, model: IFormItem, c: IFormEditItemController) => string);
+    /**
+     * 是否只读模式
+     *
+     * @author zhanghanrui
+     * @date 2024-04-08 14:04:48
+     * @type {boolean}
+     */
+    readonly?: boolean;
+    /**
+     * 是否默认为禁用状态
+     *
+     * @author zhanghanrui
+     * @date 2024-04-11 09:04:09
+     * @type {boolean}
+     */
+    disabled?: boolean;
+    /**
+     * 编辑器高度
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 16:04:18
+     * @type {string}
+     */
+    height?: string;
+    /**
+     * 编辑器宽度
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 16:04:22
+     * @type {string}
+     */
+    width?: string;
+    /**
+     * 最大字符或值
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 16:04:35
+     * @type {number}
+     */
+    max?: number;
+    /**
+     * 最小字符或值
+     *
+     * @author zhanghanrui
+     * @date 2024-04-02 16:04:45
+     * @type {number}
+     */
+    min?: number;
+    /**
+     * 额外的编辑器参数
+     *
+     * @author zhanghanrui
+     * @date 2024-03-27 15:03:16
+     * @type {*}
+     */
+    props?: IObject;
+    /**
+     * 定制化编辑器适配器
+     *
+     * @author zhanghanrui
+     * @date 2024-03-27 10:03:25
+     * @type {IEditorProvider}
+     */
+    provider?: IEditorProvider;
+    /**
+     * 代码表标识
+     *
+     * @description 用于从全局获取代码表的标识
+     * @deprecated
+     * @author zhanghanrui
+     * @date 2024-03-27 13:03:47
+     * @type {ICodeList[]}
+     */
+    codeTag?: string;
+    /**
+     * 代码表（数据字典），优先级高于 codeTag
+     *
+     * @deprecated
+     * @author zhanghanrui
+     * @date 2024-04-02 09:04:28
+     * @type {ICodeList}
+     */
+    codeList?: any;
+    /**
+     * 额外的类名
+     * @author lingxiaoming
+     * @date 2024-07-18 01:05:19
+     * @type {*}
+     */
+    class?: ClassValue;
+    /**
+     * 额外行内的样式
+     * @author lingxiaoming
+     * @date 2024-07-18 01:05:33
+     * @type {StyleValue}
+     */
+    style?: StyleValue;
+}

package/es/modules/gct-form/interface/i-editor/i-formula-editor.d.ts

@@ -0,0 +1,22 @@
+import { EditorType } from '../../constants';
+import { IEditorBasic } from './i-editor-basic';
+/**
+ * 公式编辑器
+ *
+ * @author chitanda
+ * @date 2025-11-03 16:11:54
+ * @export
+ * @interface IFormulaEditor
+ * @extends {IEditorBasic}
+ */
+export interface IFormulaEditor extends IEditorBasic {
+    readonly type: EditorType.FORMULA;
+    /**
+     * 公式编辑器配置
+     *
+     * @author chitanda
+     * @date 2025-11-03 16:11:51
+     * @type {IParams}
+     */
+    config: IParams;
+}

package/es/modules/gct-form/interface/i-editor/i-i18n-editor.d.ts

@@ -0,0 +1,38 @@
+import { ITextEditor } from './i-text-editor';
+import { EditorType } from '../../constants';
+/**
+ * 多语言编辑器
+ *
+ * @author chitanda
+ * @date 2025-06-22 16:06:22
+ * @export
+ * @interface II18nEditor
+ * @extends {ITextEditor}
+ */
+export interface II18nEditor extends ITextEditor {
+    readonly type: EditorType.I18N;
+    /**
+     * 多语言配置存储在表单的哪个字段中
+     *
+     * @author chitanda
+     * @date 2025-06-22 16:06:13
+     * @type {string}
+     */
+    cfgKey?: string;
+    /**
+     * 多语言配置的模型键名，用于根据模型名称获取当前的字段模型默认配置
+     *
+     * @author chitanda
+     * @date 2025-06-22 16:06:21
+     * @type {string}
+     */
+    modelKey?: string;
+    /**
+     * 多语言配置的字段键名，用于根据字段名称获取当前的字段默认配置
+     *
+     * @author chitanda
+     * @date 2025-06-22 16:06:39
+     * @type {string}
+     */
+    fieldKey?: string;
+}

package/es/modules/gct-form/interface/i-editor/i-icon-select-editor.d.ts

@@ -0,0 +1,21 @@
+import { EditorType } from '../../constants';
+import { IEditorBasic } from './i-editor-basic';
+/**
+ * 图标选择编辑器
+ *
+ * @author zhanghanrui
+ * @date 2024-07-26 10:07:49
+ * @export
+ * @interface IIconSelectEditor
+ * @extends {IEditorBasic}
+ */
+export interface IIconSelectEditor extends IEditorBasic {
+    readonly type: EditorType.ICON_SELECT;
+    label?: string;
+    size?: number;
+    showColor?: boolean;
+    showBackground?: boolean;
+    defaultIcon?: string;
+    defaultColor?: string;
+    defaultBackground?: string;
+}

package/es/modules/gct-form/interface/i-editor/i-info-editor.d.ts

@@ -0,0 +1,21 @@
+import { EditorType } from '../../constants';
+import { ITextEditor } from './i-text-editor';
+export interface IInfoEditor extends ITextEditor {
+    readonly type: EditorType.INFO;
+    /**
+     * 图标
+     *
+     * @author zhanghanrui
+     * @date 2024-06-06 17:06:39
+     * @type {string}
+     */
+    icon?: string;
+    /**
+     * 呈现内容
+     *
+     * @author zhanghanrui
+     * @date 2024-06-06 17:06:51
+     * @type {string}
+     */
+    content?: string;
+}

package/es/modules/gct-form/interface/i-editor/i-length-unit-editor.d.ts

@@ -0,0 +1,13 @@
+import { EditorType } from '../../constants';
+import { IEditorBasic } from './i-editor-basic';
+/**
+ * 带单位长度字符串编辑器模型
+ * @author lingxiaoming
+ * @date 2024-07-17 04:32:52
+ * @export
+ * @interface ILengthUnit
+ * @extends {IEditorBasic}
+ */
+export interface ILengthUnitEditor extends IEditorBasic {
+    readonly type: EditorType.LENGTH_UNIT;
+}