fast-element-plus 2.0.21 → 2.0.22

package/dist/components/table/utils/table.mjs

@@ -4,17 +4,18 @@
 */
 const tableUtil = {
 	/**
-	* 处理无数据情况
-	* @param {String} callValue 需要处理的值
+	* 将非空数组连接为逗号分隔的文本，空数组返回 null；其他值原样返回。
+	* @param callValue - 需要处理的值
 	*/
 	formatValue(callValue) {
 		if (Array.isArray(callValue)) return callValue.length ? callValue.join(` , `) : null;
 		return callValue;
 	},
 	/**
-	* 处理 prop 为多级嵌套的情况(列如: prop:user.name)
-	* @param {Object} row 当前行数据
-	* @param {String} prop 当前 prop
+	* 按点分隔的属性路径读取行数据，例如 user.name。
+	* @param row - 当前行数据
+	* @param prop - 当前 prop
+	* @returns 目标属性值；中间节点不是对象或属性不存在时返回 undefined。
 	*/
 	handleRowAccordingToProp(row, prop) {
 		let value = row;
@@ -25,8 +26,8 @@ const tableUtil = {
 		return value;
 	},
 	/**
-	* 处理 prop，当 prop 为多级嵌套时 ==> 返回最后一级 prop
-	* @param {String} prop 当前 prop
+	* 返回点分隔属性路径的最后一级名称。
+	* @param prop - 当前 prop
 	*/
 	handleProp(prop) {
 		const propArr = prop.split(".");
@@ -34,11 +35,12 @@ const tableUtil = {
 		return propArr.at(-1) ?? prop;
 	},
 	/**
-	* 根据枚举列表查询当需要的数据（如果指定了 label 和 value 的 key值，会自动识别格式化）
-	* @param {String} callValue 当前单元格值
-	* @param {Array} enumData 字典列表
-	* @param {Array} fieldNames 指定 label && value 的 key 值
-	* @param {String} type 过滤类型（目前只有 tag）
+	* 按值匹配枚举项，并读取指定的标签字段或 Tag 类型。
+	* @param callValue - 当前单元格值
+	* @param enumData - 字典列表
+	* @param fieldNames - 标签与值的字段名
+	* @param type - 过滤类型（目前只有 tag）
+	* @returns 匹配项的标签；未匹配时返回 null。查询 Tag 类型时默认返回 info。
 	*/
 	filterEnum(callValue, enumData, fieldNames, type) {
 		const value = fieldNames?.value ?? "value";
@@ -48,7 +50,7 @@ const tableUtil = {
 		return filterData ? filterData[label] : null;
 	},
 	/**
-	* 数组动态排序
+	* 创建按排序条件依次比较行数据的函数，支持点分隔的属性路径。
 	*/
 	arrayDynamicSort(sortList) {
 		return (a, b) => {
@@ -78,7 +80,7 @@ const tableUtil = {
 		};
 	},
 	/**
-	* 设置枚举
+	* 将静态枚举或同步枚举函数的返回值存入映射。
 	*/
 	setEnumMap(columnEnum, prop, enumMap) {
 		if (!columnEnum) return;
@@ -86,7 +88,8 @@ const tableUtil = {
 		else if (Array.isArray(columnEnum)) enumMap.set(prop, columnEnum);
 	},
 	/**
-	* 扁平化 columns
+	* 收集叶子列，并补齐列的 show 默认值与枚举映射。
+	* @remarks 会修改传入列的 show 属性；嵌套子列不继承本次枚举映射参数。
 	*/
 	flatColumns(columns, enumMap) {
 		const flatArr = [];

package/dist/components/table/utils/table.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"table.mjs","names":[],"sources":["../../../../src/components/table/utils/table.ts"],"sourcesContent":["import type { PagedSortInput } from \"../src/page.type\";\nimport type { DefaultRow } from \"../src/table.state\";\nimport type { FaTableColumnCtx, FaTableEnumColumnCtx, FaTableEnumColumnType } from \"../src/table.type\";\n\n/**\n * 表格工具类\n */\nexport const tableUtil = {\n\t/**\n\t * 处理无数据情况\n\t * @param {String} callValue 需要处理的值\n\t */\n\tformatValue(callValue: unknown): unknown {\n\t\t// 如果当前值为数组,使用 / 拼接（根据需求自定义）\n\t\tif (Array.isArray(callValue)) return callValue.length ? callValue.join(` , `) : null;\n\t\treturn callValue;\n\t},\n\t/**\n\t * 处理 prop 为多级嵌套的情况(列如: prop:user.name)\n\t * @param {Object} row 当前行数据\n\t * @param {String} prop 当前 prop\n\t */\n\thandleRowAccordingToProp(row: DefaultRow, prop: string): unknown {\n\t\tlet value: unknown = row;\n\t\tfor (const item of prop.split(\".\")) {\n\t\t\tif (typeof value !== \"object\" || value === null) return undefined;\n\t\t\tvalue = (value as Record<string, unknown>)[item];\n\t\t}\n\t\treturn value;\n\t},\n\t/**\n\t * 处理 prop，当 prop 为多级嵌套时 ==> 返回最后一级 prop\n\t * @param {String} prop 当前 prop\n\t */\n\thandleProp(prop: string): string {\n\t\tconst propArr = prop.split(\".\");\n\t\tif (propArr.length === 1) return prop;\n\t\treturn propArr.at(-1) ?? prop;\n\t},\n\t/**\n\t * 根据枚举列表查询当需要的数据（如果指定了 label 和 value 的 key值，会自动识别格式化）\n\t * @param {String} callValue 当前单元格值\n\t * @param {Array} enumData 字典列表\n\t * @param {Array} fieldNames 指定 label && value 的 key 值\n\t * @param {String} type 过滤类型（目前只有 tag）\n\t */\n\tfilterEnum(callValue: unknown, enumData: FaTableEnumColumnCtx[], fieldNames?: { label: string; value: string }, type?: \"tag\"): unknown {\n\t\tconst value = fieldNames?.value ?? \"value\";\n\t\tconst label = fieldNames?.label ?? \"label\";\n\t\tconst filterData = enumData.find((item) => item[value] === callValue);\n\t\tif (type === \"tag\") {\n\t\t\treturn filterData?.type ?? \"info\";\n\t\t}\n\t\treturn filterData ? filterData[label] : null;\n\t},\n\t/**\n\t * 数组动态排序\n\t */\n\tarrayDynamicSort(sortList: PagedSortInput[]): (a: DefaultRow, b: DefaultRow) => number {\n\t\treturn (a, b) => {\n\t\t\tif (sortList.length > 0) {\n\t\t\t\tfor (const condition of sortList) {\n\t\t\t\t\tconst property = condition.enField;\n\t\t\t\t\tconst order = condition.mode;\n\t\t\t\t\tif (!property) continue;\n\n\t\t\t\t\tconst aValue = this.handleRowAccordingToProp(a, property);\n\t\t\t\t\tconst bValue = this.handleRowAccordingToProp(b, property);\n\n\t\t\t\t\tif (typeof aValue === \"string\" && typeof bValue === \"string\") {\n\t\t\t\t\t\tif (order === \"ascending\") {\n\t\t\t\t\t\t\tconst comparison = aValue.localeCompare(bValue, \"zh-CN\");\n\t\t\t\t\t\t\tif (comparison !== 0) {\n\t\t\t\t\t\t\t\treturn comparison;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else if (order === \"descending\") {\n\t\t\t\t\t\t\tconst comparison = bValue.localeCompare(aValue, \"zh-CN\");\n\t\t\t\t\t\t\tif (comparison !== 0) {\n\t\t\t\t\t\t\t\treturn comparison;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tif (order === \"ascending\") {\n\t\t\t\t\t\t\tif ((aValue as string) < (bValue as string)) return -1;\n\t\t\t\t\t\t\tif ((aValue as string) > (bValue as string)) return 1;\n\t\t\t\t\t\t} else if (order === \"descending\") {\n\t\t\t\t\t\t\tif ((aValue as string) > (bValue as string)) return -1;\n\t\t\t\t\t\t\tif ((aValue as string) < (bValue as string)) return 1;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn 0;\n\t\t};\n\t},\n\t/**\n\t * 设置枚举\n\t */\n\tsetEnumMap(columnEnum: FaTableEnumColumnType, prop: string, enumMap: Map<string, FaTableEnumColumnCtx[]>): void {\n\t\tif (!columnEnum) return;\n\t\tif (typeof columnEnum === \"function\") {\n\t\t\tenumMap.set(prop, columnEnum());\n\t\t} else if (Array.isArray(columnEnum)) {\n\t\t\tenumMap.set(prop, columnEnum);\n\t\t}\n\t},\n\t/**\n\t * 扁平化 columns\n\t */\n\tflatColumns(columns: FaTableColumnCtx[], enumMap?: Map<string, FaTableEnumColumnCtx[]>): FaTableColumnCtx[] {\n\t\tconst flatArr: FaTableColumnCtx[] = [];\n\t\tcolumns.forEach((col) => {\n\t\t\tif (col._children?.length) {\n\t\t\t\tflatArr.push(...this.flatColumns(col._children));\n\t\t\t}\n\n\t\t\tflatArr.push(col);\n\n\t\t\t// 给每一项 column 添加 show && filterEnum 默认属性\n\t\t\tcol.show ??= true;\n\t\t\tlet enumKey = col.prop ?? col.search?.key;\n\n\t\t\tif (col.enum && typeof col.enum === \"string\") {\n\t\t\t\tenumKey = col.enum;\n\t\t\t}\n\n\t\t\t// 设置 enumMap\n\t\t\tif (col.enum && enumKey && enumMap) this.setEnumMap(col.enum, enumKey, enumMap);\n\t\t});\n\t\treturn flatArr.filter((item) => !item._children?.length);\n\t},\n};\n"],"mappings":";;;;AAOA,MAAa,YAAY;;;;;CAKxB,YAAY,WAA6B;EAExC,IAAI,MAAM,QAAQ,SAAS,GAAG,OAAO,UAAU,SAAS,UAAU,KAAK,KAAK,IAAI;EAChF,OAAO;CACR;;;;;;CAMA,yBAAyB,KAAiB,MAAuB;EAChE,IAAI,QAAiB;EACrB,KAAK,MAAM,QAAQ,KAAK,MAAM,GAAG,GAAG;GACnC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;GACxD,QAAS,MAAkC;EAC5C;EACA,OAAO;CACR;;;;;CAKA,WAAW,MAAsB;EAChC,MAAM,UAAU,KAAK,MAAM,GAAG;EAC9B,IAAI,QAAQ,WAAW,GAAG,OAAO;EACjC,OAAO,QAAQ,GAAG,EAAE,KAAK;CAC1B;;;;;;;;CAQA,WAAW,WAAoB,UAAkC,YAA+C,MAAuB;EACtI,MAAM,QAAQ,YAAY,SAAS;EACnC,MAAM,QAAQ,YAAY,SAAS;EACnC,MAAM,aAAa,SAAS,MAAM,SAAS,KAAK,WAAW,SAAS;EACpE,IAAI,SAAS,OACZ,OAAO,YAAY,QAAQ;EAE5B,OAAO,aAAa,WAAW,SAAS;CACzC;;;;CAIA,iBAAiB,UAAsE;EACtF,QAAQ,GAAG,MAAM;GAChB,IAAI,SAAS,SAAS,GACrB,KAAK,MAAM,aAAa,UAAU;IACjC,MAAM,WAAW,UAAU;IAC3B,MAAM,QAAQ,UAAU;IACxB,IAAI,CAAC,UAAU;IAEf,MAAM,SAAS,KAAK,yBAAyB,GAAG,QAAQ;IACxD,MAAM,SAAS,KAAK,yBAAyB,GAAG,QAAQ;IAExD,IAAI,OAAO,WAAW,YAAY,OAAO,WAAW,UAAU;KAC7D,IAAI,UAAU,aAAa;MAC1B,MAAM,aAAa,OAAO,cAAc,QAAQ,OAAO;MACvD,IAAI,eAAe,GAClB,OAAO;KAET,OAAO,IAAI,UAAU,cAAc;MAClC,MAAM,aAAa,OAAO,cAAc,QAAQ,OAAO;MACvD,IAAI,eAAe,GAClB,OAAO;KAET;IACD,OACC,IAAI,UAAU,aAAa;KAC1B,IAAK,SAAqB,QAAmB,OAAO;KACpD,IAAK,SAAqB,QAAmB,OAAO;IACrD,OAAO,IAAI,UAAU,cAAc;KAClC,IAAK,SAAqB,QAAmB,OAAO;KACpD,IAAK,SAAqB,QAAmB,OAAO;IACrD;GAEF;GAGD,OAAO;EACR;CACD;;;;CAIA,WAAW,YAAmC,MAAc,SAAoD;EAC/G,IAAI,CAAC,YAAY;EACjB,IAAI,OAAO,eAAe,YACzB,QAAQ,IAAI,MAAM,WAAW,CAAC;OACxB,IAAI,MAAM,QAAQ,UAAU,GAClC,QAAQ,IAAI,MAAM,UAAU;CAE9B;;;;CAIA,YAAY,SAA6B,SAAmE;EAC3G,MAAM,UAA8B,CAAC;EACrC,QAAQ,SAAS,QAAQ;GACxB,IAAI,IAAI,WAAW,QAClB,QAAQ,KAAK,GAAG,KAAK,YAAY,IAAI,SAAS,CAAC;GAGhD,QAAQ,KAAK,GAAG;GAGhB,IAAI,SAAS;GACb,IAAI,UAAU,IAAI,QAAQ,IAAI,QAAQ;GAEtC,IAAI,IAAI,QAAQ,OAAO,IAAI,SAAS,UACnC,UAAU,IAAI;GAIf,IAAI,IAAI,QAAQ,WAAW,SAAS,KAAK,WAAW,IAAI,MAAM,SAAS,OAAO;EAC/E,CAAC;EACD,OAAO,QAAQ,QAAQ,SAAS,CAAC,KAAK,WAAW,MAAM;CACxD;AACD"}
+{"version":3,"file":"table.mjs","names":[],"sources":["../../../../src/components/table/utils/table.ts"],"sourcesContent":["import type { PagedSortInput } from \"../src/page.type\";\nimport type { DefaultRow } from \"../src/table.state\";\nimport type { FaTableColumnCtx, FaTableEnumColumnCtx, FaTableEnumColumnType } from \"../src/table.type\";\n\n/**\n * 表格工具类\n */\nexport const tableUtil = {\n\t/**\n\t * 将非空数组连接为逗号分隔的文本，空数组返回 null；其他值原样返回。\n\t * @param callValue - 需要处理的值\n\t */\n\tformatValue(callValue: unknown): unknown {\n\t\tif (Array.isArray(callValue)) return callValue.length ? callValue.join(` , `) : null;\n\t\treturn callValue;\n\t},\n\t/**\n\t * 按点分隔的属性路径读取行数据，例如 user.name。\n\t * @param row - 当前行数据\n\t * @param prop - 当前 prop\n\t * @returns 目标属性值；中间节点不是对象或属性不存在时返回 undefined。\n\t */\n\thandleRowAccordingToProp(row: DefaultRow, prop: string): unknown {\n\t\tlet value: unknown = row;\n\t\tfor (const item of prop.split(\".\")) {\n\t\t\tif (typeof value !== \"object\" || value === null) return undefined;\n\t\t\tvalue = (value as Record<string, unknown>)[item];\n\t\t}\n\t\treturn value;\n\t},\n\t/**\n\t * 返回点分隔属性路径的最后一级名称。\n\t * @param prop - 当前 prop\n\t */\n\thandleProp(prop: string): string {\n\t\tconst propArr = prop.split(\".\");\n\t\tif (propArr.length === 1) return prop;\n\t\treturn propArr.at(-1) ?? prop;\n\t},\n\t/**\n\t * 按值匹配枚举项，并读取指定的标签字段或 Tag 类型。\n\t * @param callValue - 当前单元格值\n\t * @param enumData - 字典列表\n\t * @param fieldNames - 标签与值的字段名\n\t * @param type - 过滤类型（目前只有 tag）\n\t * @returns 匹配项的标签；未匹配时返回 null。查询 Tag 类型时默认返回 info。\n\t */\n\tfilterEnum(callValue: unknown, enumData: FaTableEnumColumnCtx[], fieldNames?: { label: string; value: string }, type?: \"tag\"): unknown {\n\t\tconst value = fieldNames?.value ?? \"value\";\n\t\tconst label = fieldNames?.label ?? \"label\";\n\t\tconst filterData = enumData.find((item) => item[value] === callValue);\n\t\tif (type === \"tag\") {\n\t\t\treturn filterData?.type ?? \"info\";\n\t\t}\n\t\treturn filterData ? filterData[label] : null;\n\t},\n\t/**\n\t * 创建按排序条件依次比较行数据的函数，支持点分隔的属性路径。\n\t */\n\tarrayDynamicSort(sortList: PagedSortInput[]): (a: DefaultRow, b: DefaultRow) => number {\n\t\treturn (a, b) => {\n\t\t\tif (sortList.length > 0) {\n\t\t\t\tfor (const condition of sortList) {\n\t\t\t\t\tconst property = condition.enField;\n\t\t\t\t\tconst order = condition.mode;\n\t\t\t\t\tif (!property) continue;\n\n\t\t\t\t\tconst aValue = this.handleRowAccordingToProp(a, property);\n\t\t\t\t\tconst bValue = this.handleRowAccordingToProp(b, property);\n\n\t\t\t\t\tif (typeof aValue === \"string\" && typeof bValue === \"string\") {\n\t\t\t\t\t\tif (order === \"ascending\") {\n\t\t\t\t\t\t\tconst comparison = aValue.localeCompare(bValue, \"zh-CN\");\n\t\t\t\t\t\t\tif (comparison !== 0) {\n\t\t\t\t\t\t\t\treturn comparison;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t} else if (order === \"descending\") {\n\t\t\t\t\t\t\tconst comparison = bValue.localeCompare(aValue, \"zh-CN\");\n\t\t\t\t\t\t\tif (comparison !== 0) {\n\t\t\t\t\t\t\t\treturn comparison;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t} else {\n\t\t\t\t\t\tif (order === \"ascending\") {\n\t\t\t\t\t\t\tif ((aValue as string) < (bValue as string)) return -1;\n\t\t\t\t\t\t\tif ((aValue as string) > (bValue as string)) return 1;\n\t\t\t\t\t\t} else if (order === \"descending\") {\n\t\t\t\t\t\t\tif ((aValue as string) > (bValue as string)) return -1;\n\t\t\t\t\t\t\tif ((aValue as string) < (bValue as string)) return 1;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\treturn 0;\n\t\t};\n\t},\n\t/**\n\t * 将静态枚举或同步枚举函数的返回值存入映射。\n\t */\n\tsetEnumMap(columnEnum: FaTableEnumColumnType, prop: string, enumMap: Map<string, FaTableEnumColumnCtx[]>): void {\n\t\tif (!columnEnum) return;\n\t\tif (typeof columnEnum === \"function\") {\n\t\t\tenumMap.set(prop, columnEnum());\n\t\t} else if (Array.isArray(columnEnum)) {\n\t\t\tenumMap.set(prop, columnEnum);\n\t\t}\n\t},\n\t/**\n\t * 收集叶子列，并补齐列的 show 默认值与枚举映射。\n\t * @remarks 会修改传入列的 show 属性；嵌套子列不继承本次枚举映射参数。\n\t */\n\tflatColumns(columns: FaTableColumnCtx[], enumMap?: Map<string, FaTableEnumColumnCtx[]>): FaTableColumnCtx[] {\n\t\tconst flatArr: FaTableColumnCtx[] = [];\n\t\tcolumns.forEach((col) => {\n\t\t\tif (col._children?.length) {\n\t\t\t\tflatArr.push(...this.flatColumns(col._children));\n\t\t\t}\n\n\t\t\tflatArr.push(col);\n\n\t\t\t// 给每一项 column 添加 show && filterEnum 默认属性\n\t\t\tcol.show ??= true;\n\t\t\tlet enumKey = col.prop ?? col.search?.key;\n\n\t\t\tif (col.enum && typeof col.enum === \"string\") {\n\t\t\t\tenumKey = col.enum;\n\t\t\t}\n\n\t\t\t// 设置 enumMap\n\t\t\tif (col.enum && enumKey && enumMap) this.setEnumMap(col.enum, enumKey, enumMap);\n\t\t});\n\t\treturn flatArr.filter((item) => !item._children?.length);\n\t},\n};\n"],"mappings":";;;;AAOA,MAAa,YAAY;;;;;CAKxB,YAAY,WAA6B;EACxC,IAAI,MAAM,QAAQ,SAAS,GAAG,OAAO,UAAU,SAAS,UAAU,KAAK,KAAK,IAAI;EAChF,OAAO;CACR;;;;;;;CAOA,yBAAyB,KAAiB,MAAuB;EAChE,IAAI,QAAiB;EACrB,KAAK,MAAM,QAAQ,KAAK,MAAM,GAAG,GAAG;GACnC,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO,KAAA;GACxD,QAAS,MAAkC;EAC5C;EACA,OAAO;CACR;;;;;CAKA,WAAW,MAAsB;EAChC,MAAM,UAAU,KAAK,MAAM,GAAG;EAC9B,IAAI,QAAQ,WAAW,GAAG,OAAO;EACjC,OAAO,QAAQ,GAAG,EAAE,KAAK;CAC1B;;;;;;;;;CASA,WAAW,WAAoB,UAAkC,YAA+C,MAAuB;EACtI,MAAM,QAAQ,YAAY,SAAS;EACnC,MAAM,QAAQ,YAAY,SAAS;EACnC,MAAM,aAAa,SAAS,MAAM,SAAS,KAAK,WAAW,SAAS;EACpE,IAAI,SAAS,OACZ,OAAO,YAAY,QAAQ;EAE5B,OAAO,aAAa,WAAW,SAAS;CACzC;;;;CAIA,iBAAiB,UAAsE;EACtF,QAAQ,GAAG,MAAM;GAChB,IAAI,SAAS,SAAS,GACrB,KAAK,MAAM,aAAa,UAAU;IACjC,MAAM,WAAW,UAAU;IAC3B,MAAM,QAAQ,UAAU;IACxB,IAAI,CAAC,UAAU;IAEf,MAAM,SAAS,KAAK,yBAAyB,GAAG,QAAQ;IACxD,MAAM,SAAS,KAAK,yBAAyB,GAAG,QAAQ;IAExD,IAAI,OAAO,WAAW,YAAY,OAAO,WAAW,UAAU;KAC7D,IAAI,UAAU,aAAa;MAC1B,MAAM,aAAa,OAAO,cAAc,QAAQ,OAAO;MACvD,IAAI,eAAe,GAClB,OAAO;KAET,OAAO,IAAI,UAAU,cAAc;MAClC,MAAM,aAAa,OAAO,cAAc,QAAQ,OAAO;MACvD,IAAI,eAAe,GAClB,OAAO;KAET;IACD,OACC,IAAI,UAAU,aAAa;KAC1B,IAAK,SAAqB,QAAmB,OAAO;KACpD,IAAK,SAAqB,QAAmB,OAAO;IACrD,OAAO,IAAI,UAAU,cAAc;KAClC,IAAK,SAAqB,QAAmB,OAAO;KACpD,IAAK,SAAqB,QAAmB,OAAO;IACrD;GAEF;GAGD,OAAO;EACR;CACD;;;;CAIA,WAAW,YAAmC,MAAc,SAAoD;EAC/G,IAAI,CAAC,YAAY;EACjB,IAAI,OAAO,eAAe,YACzB,QAAQ,IAAI,MAAM,WAAW,CAAC;OACxB,IAAI,MAAM,QAAQ,UAAU,GAClC,QAAQ,IAAI,MAAM,UAAU;CAE9B;;;;;CAKA,YAAY,SAA6B,SAAmE;EAC3G,MAAM,UAA8B,CAAC;EACrC,QAAQ,SAAS,QAAQ;GACxB,IAAI,IAAI,WAAW,QAClB,QAAQ,KAAK,GAAG,KAAK,YAAY,IAAI,SAAS,CAAC;GAGhD,QAAQ,KAAK,GAAG;GAGhB,IAAI,SAAS;GACb,IAAI,UAAU,IAAI,QAAQ,IAAI,QAAQ;GAEtC,IAAI,IAAI,QAAQ,OAAO,IAAI,SAAS,UACnC,UAAU,IAAI;GAIf,IAAI,IAAI,QAAQ,WAAW,SAAS,KAAK,WAAW,IAAI,MAAM,SAAS,OAAO;EAC/E,CAAC;EACD,OAAO,QAAQ,QAAQ,SAAS,CAAC,KAAK,WAAW,MAAM;CACxD;AACD"}

package/dist/components/tree/index.d.ts

@@ -7,9 +7,9 @@ export default FaTree;
 export { faTreeProps, faTreeEmits };
 export type { FaTreeSlots } from "./src/tree";
 export type * from "./src/tree.type";
-/** FaTree 暴露的组件实例类型。 */
+/** FaTree 暴露的组件实例类型 */
 export type FaTreeInstance = InstanceType<typeof Tree>;
-/** FaTree 的完整 Props 类型。 */
+/** FaTree 的完整 Props 类型 */
 export type FaTreeProps = ExtractPropTypes<typeof faTreeProps>;
-/** FaTree 的 Emits 类型。 */
+/** FaTree 的 Emits 类型 */
 export type FaTreeEmits = typeof faTreeEmits;

package/dist/components/tree/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["Tree"],"sources":["../../../src/components/tree/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport Tree, { faTreeEmits, faTreeProps } from \"./src/tree\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 支持远程加载、筛选和节点操作的树组件。 */\nexport const FaTree: TSXWithInstall<typeof Tree> = withInstall(Tree);\nexport default FaTree;\n\nexport { faTreeProps, faTreeEmits };\nexport type { FaTreeSlots } from \"./src/tree\";\nexport type * from \"./src/tree.type\";\n\n/** FaTree 暴露的组件实例类型。 */\nexport type FaTreeInstance = InstanceType<typeof Tree>;\n\n/** FaTree 的完整 Props 类型。 */\nexport type FaTreeProps = ExtractPropTypes<typeof faTreeProps>;\n\n/** FaTree 的 Emits 类型。 */\nexport type FaTreeEmits = typeof faTreeEmits;\n"],"mappings":";;;;AAMA,MAAa,SAAsC,YAAYA,YAAI"}
+{"version":3,"file":"index.mjs","names":["Tree"],"sources":["../../../src/components/tree/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport Tree, { faTreeEmits, faTreeProps } from \"./src/tree\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 支持远程加载、筛选和节点操作的树组件。 */\nexport const FaTree: TSXWithInstall<typeof Tree> = withInstall(Tree);\nexport default FaTree;\n\nexport { faTreeProps, faTreeEmits };\nexport type { FaTreeSlots } from \"./src/tree\";\nexport type * from \"./src/tree.type\";\n\n/** FaTree 暴露的组件实例类型 */\nexport type FaTreeInstance = InstanceType<typeof Tree>;\n\n/** FaTree 的完整 Props 类型 */\nexport type FaTreeProps = ExtractPropTypes<typeof faTreeProps>;\n\n/** FaTree 的 Emits 类型 */\nexport type FaTreeEmits = typeof faTreeEmits;\n"],"mappings":";;;;AAMA,MAAa,SAAsC,YAAYA,YAAI"}

package/dist/components/tree/src/tree.props.d.ts

@@ -12,11 +12,11 @@ export interface TreeNode {
 }
 /** 树组件的数据集合。 */
 export type TreeData = TreeNodeData[];
-/** 树节点的唯一键类型。 */
+/** 树节点的唯一键类型 */
 export type TreeKey = string | number;
 /** 树节点的懒加载方法。 */
 export type LoadFunction = (rootNode: TreeNode, loadedCallback: (data: TreeData) => void, stopLoading: () => void) => void;
-/** 树节点字段映射配置。 */
+/** 树节点字段映射配置 */
 export interface TreeOptionProps {
     children?: string;
     label?: string | ((data: TreeNodeData, node: TreeNode) => string);

package/dist/components/tree/src/tree.type.d.ts

@@ -1,6 +1,6 @@
-/** 树组件支持的节点值类型。 */
+/** 树组件支持的节点值类型 */
 export type ElTreeValue = string | number | boolean | object | null;
-/** 树组件标准化后的节点数据。 */
+/** 树组件标准化后的节点数据 */
 export interface ElTreeOutput<T = ElTreeValue, Data = any> {
     /**
      * 显示

package/dist/components/treeSelect/index.d.ts

@@ -6,9 +6,9 @@ export declare const FaTreeSelect: TSXWithInstall<typeof TreeSelect>;
 export default FaTreeSelect;
 export { faTreeSelectProps, faTreeSelectEmits };
 export type { FaTreeSelectSlots } from "./src/treeSelect";
-/** FaTreeSelect 暴露的组件实例类型。 */
+/** FaTreeSelect 暴露的组件实例类型 */
 export type FaTreeSelectInstance = InstanceType<typeof TreeSelect>;
-/** FaTreeSelect 的完整 Props 类型。 */
+/** FaTreeSelect 的完整 Props 类型 */
 export type FaTreeSelectProps = ExtractPropTypes<typeof faTreeSelectProps>;
-/** FaTreeSelect 的 Emits 类型。 */
+/** FaTreeSelect 的 Emits 类型 */
 export type FaTreeSelectEmits = typeof faTreeSelectEmits;

package/dist/components/treeSelect/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["TreeSelect"],"sources":["../../../src/components/treeSelect/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport TreeSelect, { faTreeSelectEmits, faTreeSelectProps } from \"./src/treeSelect\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 组合树结构浏览与选择交互的树选择器组件。 */\nexport const FaTreeSelect: TSXWithInstall<typeof TreeSelect> = withInstall(TreeSelect);\nexport default FaTreeSelect;\n\nexport { faTreeSelectProps, faTreeSelectEmits };\nexport type { FaTreeSelectSlots } from \"./src/treeSelect\";\n\n/** FaTreeSelect 暴露的组件实例类型。 */\nexport type FaTreeSelectInstance = InstanceType<typeof TreeSelect>;\n\n/** FaTreeSelect 的完整 Props 类型。 */\nexport type FaTreeSelectProps = ExtractPropTypes<typeof faTreeSelectProps>;\n\n/** FaTreeSelect 的 Emits 类型。 */\nexport type FaTreeSelectEmits = typeof faTreeSelectEmits;\n"],"mappings":";;;;AAMA,MAAa,eAAkD,YAAYA,kBAAU"}
+{"version":3,"file":"index.mjs","names":["TreeSelect"],"sources":["../../../src/components/treeSelect/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport TreeSelect, { faTreeSelectEmits, faTreeSelectProps } from \"./src/treeSelect\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 组合树结构浏览与选择交互的树选择器组件。 */\nexport const FaTreeSelect: TSXWithInstall<typeof TreeSelect> = withInstall(TreeSelect);\nexport default FaTreeSelect;\n\nexport { faTreeSelectProps, faTreeSelectEmits };\nexport type { FaTreeSelectSlots } from \"./src/treeSelect\";\n\n/** FaTreeSelect 暴露的组件实例类型 */\nexport type FaTreeSelectInstance = InstanceType<typeof TreeSelect>;\n\n/** FaTreeSelect 的完整 Props 类型 */\nexport type FaTreeSelectProps = ExtractPropTypes<typeof faTreeSelectProps>;\n\n/** FaTreeSelect 的 Emits 类型 */\nexport type FaTreeSelectEmits = typeof faTreeSelectEmits;\n"],"mappings":";;;;AAMA,MAAa,eAAkD,YAAYA,kBAAU"}

package/dist/components/treeSelect/src/treeSelect.d.ts

@@ -976,10 +976,10 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     "onNode-drag-over"?: ((draggingNode: import("element-plus/es/components/tree/src/model/node.mjs").default, dropNode: import("element-plus/es/components/tree/src/model/node.mjs").default, evt: DragEvent) => any) | undefined;
 }>, {
     data: ElSelectorOutput<ElSelectorValue, any>[];
-    loading: boolean;
     props: SelectComponentProps;
     offset: number;
     placement: import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (...args: any[]) => "left" | "right" | "top" | "auto" | "bottom" | "auto-start" | "auto-end" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end") | (() => import("element-plus").Placement) | ((new (...args: any[]) => "left" | "right" | "top" | "auto" | "bottom" | "auto-start" | "auto-end" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "right-start" | "right-end" | "left-start" | "left-end") | (() => import("element-plus").Placement) | null)[], import("element-plus").Placement, unknown>;
+    loading: boolean;
     disabled: boolean;
     modelValue: ElSelectorModelValue;
     autocomplete: string;

package/dist/components/upload/index.d.ts

@@ -6,9 +6,9 @@ export declare const FaUpload: TSXWithInstall<typeof Upload>;
 export default FaUpload;
 export { faUploadProps, faUploadEmits };
 export type { FaUploadSlots } from "./src/upload";
-/** FaUpload 暴露的组件实例类型。 */
+/** FaUpload 暴露的组件实例类型 */
 export type FaUploadInstance = InstanceType<typeof Upload>;
-/** FaUpload 的完整 Props 类型。 */
+/** FaUpload 的完整 Props 类型 */
 export type FaUploadProps = ExtractPropTypes<typeof faUploadProps>;
-/** FaUpload 的 Emits 类型。 */
+/** FaUpload 的 Emits 类型 */
 export type FaUploadEmits = typeof faUploadEmits;

package/dist/components/upload/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["Upload"],"sources":["../../../src/components/upload/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport Upload, { faUploadEmits, faUploadProps } from \"./src/upload\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 统一上传校验、进度和文件列表处理的上传组件。 */\nexport const FaUpload: TSXWithInstall<typeof Upload> = withInstall(Upload);\nexport default FaUpload;\n\nexport { faUploadProps, faUploadEmits };\nexport type { FaUploadSlots } from \"./src/upload\";\n\n/** FaUpload 暴露的组件实例类型。 */\nexport type FaUploadInstance = InstanceType<typeof Upload>;\n\n/** FaUpload 的完整 Props 类型。 */\nexport type FaUploadProps = ExtractPropTypes<typeof faUploadProps>;\n\n/** FaUpload 的 Emits 类型。 */\nexport type FaUploadEmits = typeof faUploadEmits;\n"],"mappings":";;;;AAMA,MAAa,WAA0C,YAAYA,cAAM"}
+{"version":3,"file":"index.mjs","names":["Upload"],"sources":["../../../src/components/upload/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport Upload, { faUploadEmits, faUploadProps } from \"./src/upload\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 统一上传校验、进度和文件列表处理的上传组件。 */\nexport const FaUpload: TSXWithInstall<typeof Upload> = withInstall(Upload);\nexport default FaUpload;\n\nexport { faUploadProps, faUploadEmits };\nexport type { FaUploadSlots } from \"./src/upload\";\n\n/** FaUpload 暴露的组件实例类型 */\nexport type FaUploadInstance = InstanceType<typeof Upload>;\n\n/** FaUpload 的完整 Props 类型 */\nexport type FaUploadProps = ExtractPropTypes<typeof faUploadProps>;\n\n/** FaUpload 的 Emits 类型 */\nexport type FaUploadEmits = typeof faUploadEmits;\n"],"mappings":";;;;AAMA,MAAa,WAA0C,YAAYA,cAAM"}

package/dist/components/upload/utils/upload.d.ts

@@ -15,19 +15,24 @@ export declare const uploadUtil: {
     /** 判断文件是否符合 HTML accept 规则。 */
     matchesAccept(file: File, accept?: string): boolean;
     /**
-     * 文件上传
-     * @param url 地址
-     * @param file 文件
-     * @param fileName 文件名称
-     * @param params 参数
+     * 使用 multipart/form-data 上传文件。
+     * @param url - 地址
+     * @param file - 文件
+     * @param fileName - 文件名称
+     * @param params - 附加表单字段
+     * @param request - 请求头、方法与凭据选项
+     * @returns 响应正文文本
+     * @remarks 地址为空、网络失败或 HTTP 状态失败时，返回的 Promise 被拒绝。
      */
     uploadFile(url: string, file: File, fileName: string, params?: UploadData, request?: UploadRequestConfig): Promise<string>;
     /**
-     * 文件上传
-     * @param url 地址
-     * @param file 文件
-     * @param fileName 文件名称
-     * @param params 参数
+     * 通过指定接口上传文件。
+     * @param api - 接收表单数据并返回上传结果的接口
+     * @param file - 文件
+     * @param fileName - 文件名称
+     * @param params - 附加表单字段
+     * @returns 接口返回的上传结果
+     * @remarks 接口未提供或调用失败时，返回的 Promise 被拒绝。
      */
     uploadFileByApi(api: ((formData: FormData) => Promise<string>) | null | undefined, file: File, fileName: string, params?: UploadData): Promise<string>;
 };

package/dist/components/upload/utils/upload.mjs

@@ -41,11 +41,14 @@ const uploadUtil = {
 		});
 	},
 	/**
-	* 文件上传
-	* @param url 地址
-	* @param file 文件
-	* @param fileName 文件名称
-	* @param params 参数
+	* 使用 multipart/form-data 上传文件。
+	* @param url - 地址
+	* @param file - 文件
+	* @param fileName - 文件名称
+	* @param params - 附加表单字段
+	* @param request - 请求头、方法与凭据选项
+	* @returns 响应正文文本
+	* @remarks 地址为空、网络失败或 HTTP 状态失败时，返回的 Promise 被拒绝。
 	*/
 	async uploadFile(url, file, fileName, params, request) {
 		if (!url) {
@@ -77,11 +80,13 @@ const uploadUtil = {
 		}
 	},
 	/**
-	* 文件上传
-	* @param url 地址
-	* @param file 文件
-	* @param fileName 文件名称
-	* @param params 参数
+	* 通过指定接口上传文件。
+	* @param api - 接收表单数据并返回上传结果的接口
+	* @param file - 文件
+	* @param fileName - 文件名称
+	* @param params - 附加表单字段
+	* @returns 接口返回的上传结果
+	* @remarks 接口未提供或调用失败时，返回的 Promise 被拒绝。
 	*/
 	async uploadFileByApi(api, file, fileName, params) {
 		if (!api) {

package/dist/components/upload/utils/upload.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"upload.mjs","names":[],"sources":["../../../../src/components/upload/utils/upload.ts"],"sourcesContent":["import { ElMessage } from \"element-plus\";\nimport { FaMimeType } from \"../../../constants\";\ntype UploadData = Record<string, string | Blob | [string | Blob, string] | string[]>;\n\ninterface UploadRequestConfig {\n\tmethod?: string;\n\theaders?: HeadersInit;\n\twithCredentials?: boolean;\n}\n\n/** 将 Element Plus 上传附加数据写入 FormData。 */\nconst appendUploadData = (formData: FormData, params: UploadData): void => {\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (Array.isArray(value)) {\n\t\t\tif (value.length === 2 && value[0] instanceof Blob && typeof value[1] === \"string\") {\n\t\t\t\tformData.append(key, value[0], value[1]);\n\t\t\t} else {\n\t\t\t\tvalue.forEach((item) => formData.append(key, item));\n\t\t\t}\n\t\t} else {\n\t\t\tformData.append(key, value);\n\t\t}\n\t}\n};\n\nconst FaMimeTypeNames: Record<string, keyof typeof FaMimeType> = {};\n\nfor (const [kName, vAccept] of Object.entries(FaMimeType)) {\n\tvAccept.split(\",\").forEach((tItem) => {\n\t\tFaMimeTypeNames[tItem.trim()] = kName as keyof typeof FaMimeType;\n\t});\n}\n\n/**\n * 上传工具类\n */\nexport const uploadUtil = {\n\t/**\n\t * 识别文件类型\n\t */\n\tdetectFileType(accept: string): string {\n\t\tconst detectTypes = new Set<string>();\n\t\taccept.split(\",\").forEach((mimeType) => {\n\t\t\tconst normalizedMimeType = mimeType.trim();\n\t\t\tif (normalizedMimeType) detectTypes.add(FaMimeTypeNames[normalizedMimeType] ?? normalizedMimeType);\n\t\t});\n\t\treturn Array.from(detectTypes).join(\",\");\n\t},\n\t/** 判断文件是否符合 HTML accept 规则。 */\n\tmatchesAccept(file: File, accept?: string): boolean {\n\t\tif (!accept?.trim()) return true;\n\t\tconst fileName = file.name.toLowerCase();\n\t\tconst fileType = file.type.toLowerCase();\n\t\treturn accept.split(\",\").some((item) => {\n\t\t\tconst rule = item.trim().toLowerCase();\n\t\t\tif (!rule) return false;\n\t\t\tif (rule.startsWith(\".\")) return fileName.endsWith(rule);\n\t\t\tif (rule.endsWith(\"/*\")) return fileType.startsWith(rule.slice(0, -1));\n\t\t\treturn fileType === rule;\n\t\t});\n\t},\n\t/**\n\t * 文件上传\n\t * @param url 地址\n\t * @param file 文件\n\t * @param fileName 文件名称\n\t * @param params 参数\n\t */\n\tasync uploadFile(url: string, file: File, fileName: string, params?: UploadData, request?: UploadRequestConfig): Promise<string> {\n\t\tif (!url) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传地址为空。\");\n\t\t\tElMessage.error(\"文件上传地址为空！\");\n\t\t\tthrow new Error(\"文件上传地址为空！\");\n\t\t}\n\t\tconst formData = new FormData();\n\t\tformData.append(\"file\", file);\n\t\tformData.append(\"fileName\", fileName);\n\t\tif (params) appendUploadData(formData, params);\n\t\ttry {\n\t\t\tconst response = await fetch(url, {\n\t\t\t\theaders: request?.headers,\n\t\t\t\tmethod: request?.method ?? \"POST\",\n\t\t\t\tcredentials: request?.withCredentials ? \"include\" : \"same-origin\",\n\t\t\t\tbody: formData,\n\t\t\t});\n\t\t\tif (!response.ok) {\n\t\t\t\tconsole.error(\"[Fast:uploadUtil]\", `文件上传失败，HTTP 状态码：${response.status.toString()}。`);\n\t\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\t\tthrow new Error(\"文件上传失败！\");\n\t\t\t}\n\t\t\treturn await response.text();\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传失败。\", error);\n\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\tthrow error instanceof Error ? error : new Error(\"文件上传失败！\");\n\t\t}\n\t},\n\t/**\n\t * 文件上传\n\t * @param url 地址\n\t * @param file 文件\n\t * @param fileName 文件名称\n\t * @param params 参数\n\t */\n\tasync uploadFileByApi(\n\t\tapi: ((formData: FormData) => Promise<string>) | null | undefined,\n\t\tfile: File,\n\t\tfileName: string,\n\t\tparams?: UploadData\n\t): Promise<string> {\n\t\tif (!api) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传接口为空。\");\n\t\t\tElMessage.error(\"文件上传接口为空！\");\n\t\t\tthrow new Error(\"文件上传接口为空！\");\n\t\t}\n\t\tconst formData = new FormData();\n\t\tformData.append(\"file\", file);\n\t\tformData.append(\"fileName\", fileName);\n\t\tif (params) appendUploadData(formData, params);\n\t\ttry {\n\t\t\treturn await api(formData);\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传失败。\", error);\n\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\tthrow error instanceof Error ? error : new Error(\"文件上传失败！\");\n\t\t}\n\t},\n};\n"],"mappings":"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"}
+{"version":3,"file":"upload.mjs","names":[],"sources":["../../../../src/components/upload/utils/upload.ts"],"sourcesContent":["import { ElMessage } from \"element-plus\";\nimport { FaMimeType } from \"../../../constants\";\ntype UploadData = Record<string, string | Blob | [string | Blob, string] | string[]>;\n\ninterface UploadRequestConfig {\n\tmethod?: string;\n\theaders?: HeadersInit;\n\twithCredentials?: boolean;\n}\n\n/** 将 Element Plus 上传附加数据写入 FormData。 */\nconst appendUploadData = (formData: FormData, params: UploadData): void => {\n\tfor (const [key, value] of Object.entries(params)) {\n\t\tif (Array.isArray(value)) {\n\t\t\tif (value.length === 2 && value[0] instanceof Blob && typeof value[1] === \"string\") {\n\t\t\t\tformData.append(key, value[0], value[1]);\n\t\t\t} else {\n\t\t\t\tvalue.forEach((item) => formData.append(key, item));\n\t\t\t}\n\t\t} else {\n\t\t\tformData.append(key, value);\n\t\t}\n\t}\n};\n\nconst FaMimeTypeNames: Record<string, keyof typeof FaMimeType> = {};\n\nfor (const [kName, vAccept] of Object.entries(FaMimeType)) {\n\tvAccept.split(\",\").forEach((tItem) => {\n\t\tFaMimeTypeNames[tItem.trim()] = kName as keyof typeof FaMimeType;\n\t});\n}\n\n/**\n * 上传工具类\n */\nexport const uploadUtil = {\n\t/**\n\t * 识别文件类型\n\t */\n\tdetectFileType(accept: string): string {\n\t\tconst detectTypes = new Set<string>();\n\t\taccept.split(\",\").forEach((mimeType) => {\n\t\t\tconst normalizedMimeType = mimeType.trim();\n\t\t\tif (normalizedMimeType) detectTypes.add(FaMimeTypeNames[normalizedMimeType] ?? normalizedMimeType);\n\t\t});\n\t\treturn Array.from(detectTypes).join(\",\");\n\t},\n\t/** 判断文件是否符合 HTML accept 规则。 */\n\tmatchesAccept(file: File, accept?: string): boolean {\n\t\tif (!accept?.trim()) return true;\n\t\tconst fileName = file.name.toLowerCase();\n\t\tconst fileType = file.type.toLowerCase();\n\t\treturn accept.split(\",\").some((item) => {\n\t\t\tconst rule = item.trim().toLowerCase();\n\t\t\tif (!rule) return false;\n\t\t\tif (rule.startsWith(\".\")) return fileName.endsWith(rule);\n\t\t\tif (rule.endsWith(\"/*\")) return fileType.startsWith(rule.slice(0, -1));\n\t\t\treturn fileType === rule;\n\t\t});\n\t},\n\t/**\n\t * 使用 multipart/form-data 上传文件。\n\t * @param url - 地址\n\t * @param file - 文件\n\t * @param fileName - 文件名称\n\t * @param params - 附加表单字段\n\t * @param request - 请求头、方法与凭据选项\n\t * @returns 响应正文文本\n\t * @remarks 地址为空、网络失败或 HTTP 状态失败时，返回的 Promise 被拒绝。\n\t */\n\tasync uploadFile(url: string, file: File, fileName: string, params?: UploadData, request?: UploadRequestConfig): Promise<string> {\n\t\tif (!url) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传地址为空。\");\n\t\t\tElMessage.error(\"文件上传地址为空！\");\n\t\t\tthrow new Error(\"文件上传地址为空！\");\n\t\t}\n\t\tconst formData = new FormData();\n\t\tformData.append(\"file\", file);\n\t\tformData.append(\"fileName\", fileName);\n\t\tif (params) appendUploadData(formData, params);\n\t\ttry {\n\t\t\tconst response = await fetch(url, {\n\t\t\t\theaders: request?.headers,\n\t\t\t\tmethod: request?.method ?? \"POST\",\n\t\t\t\tcredentials: request?.withCredentials ? \"include\" : \"same-origin\",\n\t\t\t\tbody: formData,\n\t\t\t});\n\t\t\tif (!response.ok) {\n\t\t\t\tconsole.error(\"[Fast:uploadUtil]\", `文件上传失败，HTTP 状态码：${response.status.toString()}。`);\n\t\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\t\tthrow new Error(\"文件上传失败！\");\n\t\t\t}\n\t\t\treturn await response.text();\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传失败。\", error);\n\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\tthrow error instanceof Error ? error : new Error(\"文件上传失败！\");\n\t\t}\n\t},\n\t/**\n\t * 通过指定接口上传文件。\n\t * @param api - 接收表单数据并返回上传结果的接口\n\t * @param file - 文件\n\t * @param fileName - 文件名称\n\t * @param params - 附加表单字段\n\t * @returns 接口返回的上传结果\n\t * @remarks 接口未提供或调用失败时，返回的 Promise 被拒绝。\n\t */\n\tasync uploadFileByApi(\n\t\tapi: ((formData: FormData) => Promise<string>) | null | undefined,\n\t\tfile: File,\n\t\tfileName: string,\n\t\tparams?: UploadData\n\t): Promise<string> {\n\t\tif (!api) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传接口为空。\");\n\t\t\tElMessage.error(\"文件上传接口为空！\");\n\t\t\tthrow new Error(\"文件上传接口为空！\");\n\t\t}\n\t\tconst formData = new FormData();\n\t\tformData.append(\"file\", file);\n\t\tformData.append(\"fileName\", fileName);\n\t\tif (params) appendUploadData(formData, params);\n\t\ttry {\n\t\t\treturn await api(formData);\n\t\t} catch (error) {\n\t\t\tconsole.error(\"[Fast:uploadUtil]\", \"文件上传失败。\", error);\n\t\t\tElMessage.error(\"文件上传失败！\");\n\t\t\tthrow error instanceof Error ? error : new Error(\"文件上传失败！\");\n\t\t}\n\t},\n};\n"],"mappings":"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"}

package/dist/components/uploadImage/index.d.ts

@@ -6,9 +6,9 @@ export declare const FaUploadImage: TSXWithInstall<typeof UploadImage>;
 export default FaUploadImage;
 export { faUploadImageProps, faUploadImageEmits };
 export type { FaUploadImageSlots } from "./src/uploadImage";
-/** FaUploadImage 暴露的组件实例类型。 */
+/** FaUploadImage 暴露的组件实例类型 */
 export type FaUploadImageInstance = InstanceType<typeof UploadImage>;
-/** FaUploadImage 的完整 Props 类型。 */
+/** FaUploadImage 的完整 Props 类型 */
 export type FaUploadImageProps = ExtractPropTypes<typeof faUploadImageProps>;
-/** FaUploadImage 的 Emits 类型。 */
+/** FaUploadImage 的 Emits 类型 */
 export type FaUploadImageEmits = typeof faUploadImageEmits;

package/dist/components/uploadImage/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["UploadImage"],"sources":["../../../src/components/uploadImage/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport UploadImage, { faUploadImageEmits, faUploadImageProps } from \"./src/uploadImage\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 支持预览、校验和状态同步的单图片上传组件。 */\nexport const FaUploadImage: TSXWithInstall<typeof UploadImage> = withInstall(UploadImage);\nexport default FaUploadImage;\n\nexport { faUploadImageProps, faUploadImageEmits };\nexport type { FaUploadImageSlots } from \"./src/uploadImage\";\n\n/** FaUploadImage 暴露的组件实例类型。 */\nexport type FaUploadImageInstance = InstanceType<typeof UploadImage>;\n\n/** FaUploadImage 的完整 Props 类型。 */\nexport type FaUploadImageProps = ExtractPropTypes<typeof faUploadImageProps>;\n\n/** FaUploadImage 的 Emits 类型。 */\nexport type FaUploadImageEmits = typeof faUploadImageEmits;\n"],"mappings":";;;;AAMA,MAAa,gBAAoD,YAAYA,mBAAW"}
+{"version":3,"file":"index.mjs","names":["UploadImage"],"sources":["../../../src/components/uploadImage/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport UploadImage, { faUploadImageEmits, faUploadImageProps } from \"./src/uploadImage\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\n\n/** 支持预览、校验和状态同步的单图片上传组件。 */\nexport const FaUploadImage: TSXWithInstall<typeof UploadImage> = withInstall(UploadImage);\nexport default FaUploadImage;\n\nexport { faUploadImageProps, faUploadImageEmits };\nexport type { FaUploadImageSlots } from \"./src/uploadImage\";\n\n/** FaUploadImage 暴露的组件实例类型 */\nexport type FaUploadImageInstance = InstanceType<typeof UploadImage>;\n\n/** FaUploadImage 的完整 Props 类型 */\nexport type FaUploadImageProps = ExtractPropTypes<typeof faUploadImageProps>;\n\n/** FaUploadImage 的 Emits 类型 */\nexport type FaUploadImageEmits = typeof faUploadImageEmits;\n"],"mappings":";;;;AAMA,MAAa,gBAAoD,YAAYA,mBAAW"}

package/dist/components/uploadImages/index.d.ts

@@ -7,9 +7,9 @@ export declare const FaUploadImages: TSXWithInstall<typeof UploadImages>;
 export default FaUploadImages;
 export { faUploadImagesEmits, faUploadImagesProps } from "./src/uploadImages";
 export type { FaUploadImagesSlots } from "./src/uploadImages";
-/** FaUploadImages 暴露的组件实例类型。 */
+/** FaUploadImages 暴露的组件实例类型 */
 export type FaUploadImagesInstance = InstanceType<typeof UploadImages>;
-/** FaUploadImages 的完整 Props 类型。 */
+/** FaUploadImages 的完整 Props 类型 */
 export type FaUploadImagesProps = ExtractPropTypes<typeof faUploadImagesProps>;
-/** FaUploadImages 的 Emits 类型。 */
+/** FaUploadImages 的 Emits 类型 */
 export type FaUploadImagesEmits = typeof faUploadImagesEmits;

package/dist/components/uploadImages/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["UploadImages"],"sources":["../../../src/components/uploadImages/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport UploadImages from \"./src/uploadImages\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\nimport type { faUploadImagesEmits, faUploadImagesProps } from \"./src/uploadImages\";\n\n/** 支持排序、预览、校验和状态同步的多图片上传组件。 */\nexport const FaUploadImages: TSXWithInstall<typeof UploadImages> = withInstall(UploadImages);\nexport default FaUploadImages;\n\nexport { faUploadImagesEmits, faUploadImagesProps } from \"./src/uploadImages\";\nexport type { FaUploadImagesSlots } from \"./src/uploadImages\";\n\n/** FaUploadImages 暴露的组件实例类型。 */\nexport type FaUploadImagesInstance = InstanceType<typeof UploadImages>;\n\n/** FaUploadImages 的完整 Props 类型。 */\nexport type FaUploadImagesProps = ExtractPropTypes<typeof faUploadImagesProps>;\n\n/** FaUploadImages 的 Emits 类型。 */\nexport type FaUploadImagesEmits = typeof faUploadImagesEmits;\n"],"mappings":";;;;AAOA,MAAa,iBAAsD,YAAYA,oBAAY"}
+{"version":3,"file":"index.mjs","names":["UploadImages"],"sources":["../../../src/components/uploadImages/index.ts"],"sourcesContent":["import { withInstall } from \"../../utils\";\nimport UploadImages from \"./src/uploadImages\";\nimport type { ExtractPropTypes } from \"vue\";\nimport type { TSXWithInstall } from \"../../utils\";\nimport type { faUploadImagesEmits, faUploadImagesProps } from \"./src/uploadImages\";\n\n/** 支持排序、预览、校验和状态同步的多图片上传组件。 */\nexport const FaUploadImages: TSXWithInstall<typeof UploadImages> = withInstall(UploadImages);\nexport default FaUploadImages;\n\nexport { faUploadImagesEmits, faUploadImagesProps } from \"./src/uploadImages\";\nexport type { FaUploadImagesSlots } from \"./src/uploadImages\";\n\n/** FaUploadImages 暴露的组件实例类型 */\nexport type FaUploadImagesInstance = InstanceType<typeof UploadImages>;\n\n/** FaUploadImages 的完整 Props 类型 */\nexport type FaUploadImagesProps = ExtractPropTypes<typeof faUploadImagesProps>;\n\n/** FaUploadImages 的 Emits 类型 */\nexport type FaUploadImagesEmits = typeof faUploadImagesEmits;\n"],"mappings":";;;;AAOA,MAAa,iBAAsD,YAAYA,oBAAY"}