From 257805a2fa2d5484c0d307805a6643ed3de047f2 Mon Sep 17 00:00:00 2001 From: funjia <13429193897@163.com> Date: Fri, 25 Sep 2026 03:20:06 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E4=BA=A7=E7=89=A9=E6=9B=B4=E6=96=B0=20?= =?UTF-8?q?v1.4.0=EF=BC=8C=E6=96=B0=E5=A2=9E=20UmRemoteClass?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 同步源码仓库 FunjiaUI_Vue 的 v1.4.0 构建产物。 - 新增 UmRemoteClass(index.vue.d.ts / remoteScript.d.ts 类型声明) - funjiaui.es.js / cjs.js / umd.js / index.d.ts / style.css 全量重建 - package.json:版本 1.3.1 → 1.4.0;files 白名单补上 UmRemoteClass (漏了它的话,按 npm 发布时新组件的类型声明不会进包) - peerDependencies 未变:vue / element-plus / @element-plus/icons-vue 其余组件声明文件的改动来自本次重新生成(dts 输出格式化差异),行为未变。 --- README.md | 1 + UmRemoteClass/index.vue.d.ts | 415 +++++++++++++++++++++++++ UmRemoteClass/remoteScript.d.ts | 46 +++ UmTable/UmByClass.vue.d.ts | 2 +- UmTable/UmByClassEnhance.vue.d.ts | 4 +- funjiaui.cjs.js | 6 +- funjiaui.es.js | 501 ++++++++++++++++++++---------- funjiaui.umd.js | 6 +- index.d.ts | 2 + package.json | 3 +- style.css | 2 +- 11 files changed, 814 insertions(+), 174 deletions(-) create mode 100644 UmRemoteClass/index.vue.d.ts create mode 100644 UmRemoteClass/remoteScript.d.ts diff --git a/README.md b/README.md index 906d6e9..1362a7f 100644 --- a/README.md +++ b/README.md @@ -45,6 +45,7 @@ UMD 方式(挂到 `window.funjiaUI`): | 版本 | 说明 | | --- | --- | +| 1.4.0 | 新增 **`UmRemoteClass`**:运行时加载远端脚本、取 `window` 上的配置类并交给表格渲染,配套导出框架无关的脚本加载器(`loadRemoteScript` / `resolveScriptUrl` / `toGlobalKey` 等)。**刻意不依赖 vue-router**,peerDependencies 未变 | | 1.3.1 | 修复**编辑弹窗「点确定没反应」**:表单 vnode 改由 `render()` 创建,避免 Vue 3.5 在渲染外重算 computed 导致字符串 ref 失去 owner、`$refs.formRef` 为 null | | 1.3.0 | 新增**列冻结**(`fixed: "left" \| "right"`、操作列 `operateFixed`),体检新增两条冻结相关规则;顺带修复 `sort: 0` 被当成 `1` 的排序缺陷 | | 1.2.0 | 内核层重构(core/)、类型统一、编辑链路修复、配置体检、UMD 全局名修正为 `funjiaUI` | diff --git a/UmRemoteClass/index.vue.d.ts b/UmRemoteClass/index.vue.d.ts new file mode 100644 index 0000000..048aef3 --- /dev/null +++ b/UmRemoteClass/index.vue.d.ts @@ -0,0 +1,415 @@ +declare const _sfc_main: import("vue").DefineComponent<{ + src: { + type: StringConstructor; + required: false; + }; + baseUrl: { + type: StringConstructor; + required: false; + default: string; + }; + path: { + type: StringConstructor; + required: false; + }; + name: { + type: StringConstructor; + required: false; + }; + globalKey: { + type: StringConstructor; + required: false; + }; + data: { + type: ArrayConstructor; + required: false; + default: () => never[]; + }; + otherParams: { + type: null; + required: false; + }; + formData: { + type: null; + required: false; + }; + isExpand: { + type: BooleanConstructor; + required: false; + default: boolean; + }; + expandTemplate: { + type: null; + required: false; + }; + retryText: { + type: StringConstructor; + required: false; + default: string; + }; +}, { + props: any; + emit: { + (e: "loaded", target: any): void; + (e: "error", error: unknown): void; + (e: "dataChange", data: any): void; + (e: "fire", key: string, value: any, data: any): void; + }; + viewModel: any; + loadError: import("vue").Ref; + loadErrorHint: import("vue").Ref; + fail: (title: string, hint: string, error?: unknown) => void; + resolveUrl: () => string; + resolveKey: () => string; + load: () => Promise; + onDataChange: (payload: any) => void; + onFire: (key: string, value: any, data: any) => void; + ElAlert: import("element-plus/es/utils").SFCWithInstall; + readonly description: import("element-plus/es/utils").BuildPropReturn; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly closable: import("element-plus/es/utils").BuildPropReturn; + readonly closeText: import("element-plus/es/utils").BuildPropReturn; + readonly showIcon: BooleanConstructor; + readonly center: BooleanConstructor; + readonly effect: import("element-plus/es/utils").BuildPropReturn; + }, { + Close: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, import("vue").EmitsOptions, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly>, {}>; + props: Readonly; + readonly description: import("element-plus/es/utils").BuildPropReturn; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly closable: import("element-plus/es/utils").BuildPropReturn; + readonly closeText: import("element-plus/es/utils").BuildPropReturn; + readonly showIcon: BooleanConstructor; + readonly center: BooleanConstructor; + readonly effect: import("element-plus/es/utils").BuildPropReturn; + }>> & { + onClose?: ((evt: MouseEvent) => any) | undefined; + }>>; + emit: (event: "close", evt: MouseEvent) => void; + slots: Readonly<{ + [name: string]: import("vue").Slot | undefined; + }>; + ns: { + namespace: import("vue").ComputedRef; + b: (blockSuffix?: string | undefined) => string; + e: (element?: string | undefined) => string; + m: (modifier?: string | undefined) => string; + be: (blockSuffix?: string | undefined, element?: string | undefined) => string; + em: (element?: string | undefined, modifier?: string | undefined) => string; + bm: (blockSuffix?: string | undefined, modifier?: string | undefined) => string; + bem: (blockSuffix?: string | undefined, element?: string | undefined, modifier?: string | undefined) => string; + is: { + (name: string, state: boolean | undefined): string; + (name: string): string; + }; + }; + visible: import("vue").Ref; + iconComponent: import("vue").ComputedRef>, {}>>; + isBigIcon: import("vue").ComputedRef; + isBoldTitle: import("vue").ComputedRef; + close: (evt: MouseEvent) => void; + ElIcon: import("element-plus/es/utils").SFCWithInstall, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }, { + props: Readonly, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }>> & { + [x: `on${string}`]: ((...args: any[]) => any) | ((...args: unknown[]) => any) | undefined; + }>>; + ns: { + namespace: import("vue").ComputedRef; + b: (blockSuffix?: string | undefined) => string; + e: (element?: string | undefined) => string; + m: (modifier?: string | undefined) => string; + be: (blockSuffix?: string | undefined, element?: string | undefined) => string; + em: (element?: string | undefined, modifier?: string | undefined) => string; + bm: (blockSuffix?: string | undefined, modifier?: string | undefined) => string; + bem: (blockSuffix?: string | undefined, element?: string | undefined, modifier?: string | undefined) => string; + is: { + (name: string, state: boolean | undefined): string; + (name: string): string; + }; + }; + style: import("vue").ComputedRef; + }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }>>, { + size: import("element-plus/es/utils").BuildPropType, unknown, unknown>; + color: string; + }>> & Record; + }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, { + close: (evt: MouseEvent) => boolean; + }, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly; + readonly description: import("element-plus/es/utils").BuildPropReturn; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly closable: import("element-plus/es/utils").BuildPropReturn; + readonly closeText: import("element-plus/es/utils").BuildPropReturn; + readonly showIcon: BooleanConstructor; + readonly center: BooleanConstructor; + readonly effect: import("element-plus/es/utils").BuildPropReturn; + }>> & { + onClose?: ((evt: MouseEvent) => any) | undefined; + }, { + type: import("element-plus/es/utils").BuildPropType; + closable: import("element-plus/es/utils").BuildPropType; + title: string; + description: string; + closeText: string; + effect: import("element-plus/es/utils").BuildPropType; + showIcon: boolean; + center: boolean; + }>> & Record; + ElButton: import("element-plus/es/utils").SFCWithInstall; + readonly disabled: BooleanConstructor; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly icon: import("element-plus/es/utils").BuildPropReturn>, "", unknown, unknown, unknown>; + readonly nativeType: import("element-plus/es/utils").BuildPropReturn; + readonly loading: BooleanConstructor; + readonly loadingIcon: import("element-plus/es/utils").BuildPropReturn>, () => import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, import("vue").EmitsOptions, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly>, {}>, unknown, unknown, unknown>; + readonly plain: BooleanConstructor; + readonly autofocus: BooleanConstructor; + readonly round: BooleanConstructor; + readonly circle: BooleanConstructor; + readonly color: StringConstructor; + readonly dark: BooleanConstructor; + readonly autoInsertSpace: import("element-plus/es/utils").BuildPropReturn; + }, { + props: Readonly; + readonly disabled: BooleanConstructor; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly icon: import("element-plus/es/utils").BuildPropReturn>, "", unknown, unknown, unknown>; + readonly nativeType: import("element-plus/es/utils").BuildPropReturn; + readonly loading: BooleanConstructor; + readonly loadingIcon: import("element-plus/es/utils").BuildPropReturn>, () => import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, import("vue").EmitsOptions, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly>, {}>, unknown, unknown, unknown>; + readonly plain: BooleanConstructor; + readonly autofocus: BooleanConstructor; + readonly round: BooleanConstructor; + readonly circle: BooleanConstructor; + readonly color: StringConstructor; + readonly dark: BooleanConstructor; + readonly autoInsertSpace: import("element-plus/es/utils").BuildPropReturn; + }>> & { + onClick?: ((evt: MouseEvent) => any) | undefined; + }>>; + emit: (event: "click", evt: MouseEvent) => void; + slots: Readonly<{ + [name: string]: import("vue").Slot | undefined; + }>; + buttonGroupContext: import("element-plus").ButtonGroupContext | undefined; + globalConfig: import("vue").Ref; + ns: { + namespace: import("vue").ComputedRef; + b: (blockSuffix?: string | undefined) => string; + e: (element?: string | undefined) => string; + m: (modifier?: string | undefined) => string; + be: (blockSuffix?: string | undefined, element?: string | undefined) => string; + em: (element?: string | undefined, modifier?: string | undefined) => string; + bm: (blockSuffix?: string | undefined, modifier?: string | undefined) => string; + bem: (blockSuffix?: string | undefined, element?: string | undefined, modifier?: string | undefined) => string; + is: { + (name: string, state: boolean | undefined): string; + (name: string): string; + }; + }; + form: import("element-plus").FormContext | undefined; + _size: import("vue").ComputedRef<"" | "default" | "small" | "large">; + _disabled: import("vue").ComputedRef; + _ref: import("vue").Ref; + _type: import("vue").ComputedRef<"" | "default" | "primary" | "success" | "warning" | "info" | "danger" | "text">; + autoInsertSpace: import("vue").ComputedRef>; + shouldAddSpace: import("vue").ComputedRef; + buttonStyle: import("vue").ComputedRef>; + handleClick: (evt: MouseEvent) => void; + ElIcon: import("element-plus/es/utils").SFCWithInstall, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }, { + props: Readonly, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }>> & { + [x: `on${string}`]: ((...args: any[]) => any) | ((...args: unknown[]) => any) | undefined; + }>>; + ns: { + namespace: import("vue").ComputedRef; + b: (blockSuffix?: string | undefined) => string; + e: (element?: string | undefined) => string; + m: (modifier?: string | undefined) => string; + be: (blockSuffix?: string | undefined, element?: string | undefined) => string; + em: (element?: string | undefined, modifier?: string | undefined) => string; + bm: (blockSuffix?: string | undefined, modifier?: string | undefined) => string; + bem: (blockSuffix?: string | undefined, element?: string | undefined, modifier?: string | undefined) => string; + is: { + (name: string, state: boolean | undefined): string; + (name: string): string; + }; + }; + style: import("vue").ComputedRef; + }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly, unknown, unknown, unknown, unknown>; + readonly color: import("element-plus/es/utils").BuildPropReturn; + }>>, { + size: import("element-plus/es/utils").BuildPropType, unknown, unknown>; + color: string; + }>> & Record; + }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, { + click: (evt: MouseEvent) => boolean; + }, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly; + readonly disabled: BooleanConstructor; + readonly type: import("element-plus/es/utils").BuildPropReturn; + readonly icon: import("element-plus/es/utils").BuildPropReturn>, "", unknown, unknown, unknown>; + readonly nativeType: import("element-plus/es/utils").BuildPropReturn; + readonly loading: BooleanConstructor; + readonly loadingIcon: import("element-plus/es/utils").BuildPropReturn>, () => import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, import("vue").EmitsOptions, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly>, {}>, unknown, unknown, unknown>; + readonly plain: BooleanConstructor; + readonly autofocus: BooleanConstructor; + readonly round: BooleanConstructor; + readonly circle: BooleanConstructor; + readonly color: StringConstructor; + readonly dark: BooleanConstructor; + readonly autoInsertSpace: import("element-plus/es/utils").BuildPropReturn; + }>> & { + onClick?: ((evt: MouseEvent) => any) | undefined; + }, { + type: import("element-plus/es/utils").BuildPropType; + icon: import("element-plus/es/utils").BuildPropType>, unknown, unknown>; + nativeType: import("element-plus/es/utils").BuildPropType; + loadingIcon: import("element-plus/es/utils").BuildPropType>, unknown, unknown>; + autoInsertSpace: import("element-plus/es/utils").BuildPropType; + size: import("element-plus/es/utils").BuildPropType; + disabled: boolean; + loading: boolean; + plain: boolean; + autofocus: boolean; + round: boolean; + circle: boolean; + dark: boolean; + }>> & { + ButtonGroup: import("vue").DefineComponent<{ + readonly size: import("element-plus/es/utils").BuildPropReturn; + readonly type: import("element-plus/es/utils").BuildPropReturn; + }, { + props: Readonly; + readonly type: import("element-plus/es/utils").BuildPropReturn; + }>> & { + [x: `on${string}`]: ((...args: any[]) => any) | ((...args: unknown[]) => any) | undefined; + }>>; + ns: { + namespace: import("vue").ComputedRef; + b: (blockSuffix?: string | undefined) => string; + e: (element?: string | undefined) => string; + m: (modifier?: string | undefined) => string; + be: (blockSuffix?: string | undefined, element?: string | undefined) => string; + em: (element?: string | undefined, modifier?: string | undefined) => string; + bm: (blockSuffix?: string | undefined, modifier?: string | undefined) => string; + bem: (blockSuffix?: string | undefined, element?: string | undefined, modifier?: string | undefined) => string; + is: { + (name: string, state: boolean | undefined): string; + (name: string): string; + }; + }; + }, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, Record, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly; + readonly type: import("element-plus/es/utils").BuildPropReturn; + }>>, { + type: import("element-plus/es/utils").BuildPropType; + size: import("element-plus/es/utils").BuildPropType; + }>; + }; + UmByClassEnhance: import("vue").DefineComponent<{ + target: any; + data: any[]; + class?: string | undefined; + otherParams?: any; + formData?: any; + isExpand?: boolean | undefined; + expandTemplate?: any; + }, any, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, import("vue").EmitsOptions, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<{ + target: any; + data: any[]; + class?: string | undefined; + otherParams?: any; + formData?: any; + isExpand?: boolean | undefined; + expandTemplate?: any; + }>, { + otherParams: any; + formData: any; + expandTemplate: any; + target: any; + }>; +}, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("loaded" | "error" | "dataChange" | "fire")[], "loaded" | "error" | "dataChange" | "fire", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly never[]; + }; + otherParams: { + type: null; + required: false; + }; + formData: { + type: null; + required: false; + }; + isExpand: { + type: BooleanConstructor; + required: false; + default: boolean; + }; + expandTemplate: { + type: null; + required: false; + }; + retryText: { + type: StringConstructor; + required: false; + default: string; + }; +}>> & { + onLoaded?: ((...args: any[]) => any) | undefined; + onError?: ((...args: any[]) => any) | undefined; + onDataChange?: ((...args: any[]) => any) | undefined; + onFire?: ((...args: any[]) => any) | undefined; +}, { + data: unknown[]; + baseUrl: string; + isExpand: boolean; + retryText: string; +}>; +export default _sfc_main; diff --git a/UmRemoteClass/remoteScript.d.ts b/UmRemoteClass/remoteScript.d.ts new file mode 100644 index 0000000..087ae84 --- /dev/null +++ b/UmRemoteClass/remoteScript.d.ts @@ -0,0 +1,46 @@ +/** + * 远程脚本加载器(框架无关)。 + * + * 用途:把一段**运行时才拿到**的 IIFE 脚本加载进页面。典型消费方式是 + * 「脚本把配置类挂到 window 上,宿主组件取出来交给表格渲染」。 + * + * ## 三条用血换来的约定 + * + * 1. **缓存 key 必须是 `url`,不能是业务上的名字。** + * 脚本内容由 url 决定。若用名字做 key,就会出现「改了 url、名字没变」 + * 时命中旧 Promise、新脚本**永远不会加载**的情况,而且完全静默。 + * 2. **加载失败必须把条目从缓存里摘掉。** + * 否则重试永远拿到那个失败的 Promise,表现为「怎么点都没反应」。 + * 3. **url 里的文件名要过白名单。** + * 它最终会被拼进 `script.src`,是本模块唯一的注入面。 + * + * 本模块不依赖 vue,可单独在任意环境使用,也便于写单测。 + */ +/** 脚本文件名白名单:字母 / 数字 / 点 / 下划线 / 短横线 */ +export declare const SAFE_SCRIPT_PATH: RegExp; +/** + * 拼接脚本地址:`baseUrl + "/" + path + ".js"`。 + * + * `path` 不允许出现路径分隔符(`/`、`\`)或 `..`,避免越出 `baseUrl` 指定的目录。 + * 校验不过直接抛错,由调用方决定怎么呈现 —— 不要静默降级成一个错误的地址。 + */ +export declare const resolveScriptUrl: (baseUrl: string, path: string) => string; +/** + * 加载脚本。同一个 url 只会真正插入一次 `