@astrolimit/fc-utils 25.12.18

package/dist/index.d.ts

@@ -0,0 +1,157 @@
+//#region src/debounce.d.ts
+/**
+ * 防抖函数工具
+ * 在指定时间内只执行最后一次函数调用
+ */
+/**
+ * 防抖函数
+ * @param fn - 要防抖的函数
+ * @param wait - 等待时间（毫秒）
+ * @returns 防抖后的函数
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number): (...args: Parameters<T>) => void;
+//#endregion
+//#region src/toarray.d.ts
+declare function toArray(value: any): any[];
+//#endregion
+//#region src/tostring.d.ts
+/**
+ * 转换为字符串工具
+ * 将值转换为字符串表示
+ */
+/**
+ * 将值转换为字符串
+ * @param val - 要转换的值
+ * @returns 字符串表示
+ */
+declare function toString(val: any): string;
+//#endregion
+//#region src/topromise.d.ts
+declare function toPromise(value: any): any;
+//#endregion
+//#region src/toline.d.ts
+declare function toLine(name: string): string;
+//#endregion
+//#region src/todate.d.ts
+declare function toDate(timeStamp: number | string | Date): string | number | Date;
+//#endregion
+//#region src/deepextend.d.ts
+/**
+ * 深度扩展对象
+ * @param origin - 源对象
+ * @param target - 目标对象，默认为空对象
+ * @param mode - 模式：true 表示使用 getRule，false 表示使用 _clone，undefined 表示普通模式
+ * @returns 扩展后的对象
+ */
+declare function deepExtend<T extends Record<string, any> | any[]>(origin: T, target?: any, mode?: boolean): T;
+/**
+ * 深度复制对象
+ * @param value - 要复制的值
+ * @returns 复制后的值
+ */
+declare function deepCopy<T>(value: T): T;
+/**
+ * 深度扩展多个对象
+ * @param origin - 源对象
+ * @param lst - 要扩展的对象列表
+ * @returns 扩展后的对象
+ */
+declare function deepExtendArgs<T extends Record<string, any> | any[]>(origin: T, ...lst: any[]): T;
+//#endregion
+//#region src/extend.d.ts
+declare function extend(): any;
+declare function copy<T>(obj: T): T;
+//#endregion
+//#region src/json.d.ts
+declare function toJson(obj: Record<string | number, any>, space: number): string;
+declare function parseFn(fn: string, mode: boolean): any;
+declare function parseJson(json: string, mode: boolean): any;
+//#endregion
+//#region src/modify.d.ts
+declare function $set<T extends Record<string, any>, K extends keyof T>(target: T, field: K, value: T[K]): void;
+declare function $del<T extends Record<string, any>, K extends keyof T>(target: T, field: K): void;
+//#endregion
+//#region src/type.d.ts
+/**
+ * 类型检查工具
+ * 提供各种类型判断方法
+ */
+declare const is: {
+  readonly availStr: (val: any) => boolean;
+  /**
+   * 检查参数是否为指定类型
+   */
+  readonly type: (arg: any, type: string) => boolean;
+  /**
+   * 检查值是否为 undefined 或 null
+   */
+  readonly Nil: (v: any) => boolean;
+  /**
+   * 检查值是否为 undefined 或 null
+   */
+  readonly Undef: (v: any) => boolean;
+  /**
+   * 检查是否为 DOM 元素
+   */
+  readonly Element: (arg: any) => boolean;
+  /**
+   * 检查是否为非空数组
+   */
+  readonly trueArray: (data: any) => boolean;
+  /**
+   * 检查是否为函数
+   */
+  readonly Function: (v: any) => boolean;
+  /**
+   * 获取值的类型名称
+   */
+  readonly getType: (v: any) => string;
+  /**
+   * 检查值是否为空
+   */
+  readonly empty: (value: any) => boolean;
+  readonly Date: (arg: any) => boolean;
+  readonly Object: (arg: any) => boolean;
+  readonly String: (arg: any) => boolean;
+  readonly Boolean: (arg: any) => boolean;
+  readonly Array: (arg: any) => boolean;
+  readonly Number: (arg: any) => boolean;
+};
+/**
+ * 检查对象是否具有指定属性
+ * @param rule - 要检查的对象
+ * @param k - 属性名
+ * @returns 是否具有该属性
+ */
+declare function hasProperty(rule: any, k: string): boolean;
+//#endregion
+//#region src/unique.d.ts
+declare function uniqueId(): string;
+declare function shortKey(): string;
+//#endregion
+//#region src/slot.d.ts
+declare function getSlot(slots: Record<string, any>, exclude: string[]): Record<string, any>;
+//#endregion
+//#region src/deepset.d.ts
+declare function deepSet<T extends Record<string, any>>(data: T, idx: string, val: any): T;
+//#endregion
+//#region src/mitt.d.ts
+interface IHandler {
+  (...args: any[]): void;
+  _once?: boolean;
+}
+declare function Mitt<T extends string>(all: Map<T | "*", Array<IHandler>>): {
+  readonly $on: (type: T, handler: IHandler) => void;
+  readonly $once: (type: T, handler: IHandler) => void;
+  readonly $off: (type: T, handler: IHandler) => void;
+  readonly $emit: (type: T, ...args: any[]) => void;
+};
+//#endregion
+//#region src/tocase.d.ts
+declare function toCase(str: string): string;
+declare function lower(str: string): string;
+//#endregion
+//#region src/mergeprops.d.ts
+declare const mergeProps: (objects: Array<Record<string, any>>, initial?: Record<string, any>, opt?: Record<string, any>) => Record<string, any>;
+//#endregion
+export { $del, $set, Mitt, copy, debounce, deepCopy, deepExtend, deepExtendArgs, deepSet, extend, getSlot, hasProperty, is, lower, mergeProps, parseFn, parseJson, shortKey, toArray, toCase, toDate, toJson, toLine, toPromise, toString, uniqueId };

package/dist/index.js

@@ -0,0 +1,452 @@
+import { isString } from "lodash-es";
+import dayjs from "dayjs";
+
+//#region src/debounce.ts
+/**
+* 防抖函数工具
+* 在指定时间内只执行最后一次函数调用
+*/
+/**
+* 防抖函数
+* @param fn - 要防抖的函数
+* @param wait - 等待时间（毫秒）
+* @returns 防抖后的函数
+*/
+function debounce(fn, wait) {
+	let timeout = null;
+	return function(...arg) {
+		if (timeout !== null) clearTimeout(timeout);
+		timeout = setTimeout(() => fn.call(this, ...arg), wait);
+	};
+}
+
+//#endregion
+//#region src/toarray.ts
+function toArray(value) {
+	return Array.isArray(value) ? value : [
+		null,
+		void 0,
+		""
+	].indexOf(value) > -1 ? [] : [value];
+}
+
+//#endregion
+//#region src/tostring.ts
+/**
+* 转换为字符串工具
+* 将值转换为字符串表示
+*/
+/**
+* 将值转换为字符串
+* @param val - 要转换的值
+* @returns 字符串表示
+*/
+function toString(val) {
+	return val == null ? "" : typeof val === "object" ? JSON.stringify(val, null, 2) : String(val);
+}
+
+//#endregion
+//#region src/topromise.ts
+function isPromise(value) {
+	return value && typeof value === "object" && typeof value.then === "function";
+}
+function toPromise(value) {
+	if (isPromise(value)) return value;
+	return Promise.resolve(value);
+}
+
+//#endregion
+//#region src/toline.ts
+function toLine(name) {
+	let line = name.replace(/([A-Z])/g, "-$1").toLocaleLowerCase();
+	if (line.indexOf("-") === 0) line = line.substr(1);
+	return line;
+}
+
+//#endregion
+//#region src/type.ts
+/**
+* 类型检查工具
+* 提供各种类型判断方法
+*/
+const is = {
+	availStr(val) {
+		return isString(val) && val.trim() != "";
+	},
+	type(arg, type) {
+		return Object.prototype.toString.call(arg) === "[object " + type + "]";
+	},
+	Nil(v) {
+		return v === null || v === void 0;
+	},
+	Undef(v) {
+		return v === void 0 || v === null;
+	},
+	Element(arg) {
+		return typeof arg === "object" && arg !== null && arg.nodeType === 1 && !is.Object(arg);
+	},
+	trueArray(data) {
+		return Array.isArray(data) && data.length > 0;
+	},
+	Function(v) {
+		const type = this.getType(v);
+		return type === "Function" || type === "AsyncFunction";
+	},
+	getType(v) {
+		const str = Object.prototype.toString.call(v);
+		const match = /^\[object (.*)\]$/.exec(str);
+		return match ? match[1] : "";
+	},
+	empty(value) {
+		if (value === void 0 || value === null) return true;
+		if (Array.isArray(value) && !value.length) return true;
+		return typeof value === "string" && !value;
+	},
+	Date(arg) {
+		return is.type(arg, "Date");
+	},
+	Object(arg) {
+		return is.type(arg, "Object");
+	},
+	String(arg) {
+		return is.type(arg, "String");
+	},
+	Boolean(arg) {
+		return is.type(arg, "Boolean");
+	},
+	Array(arg) {
+		return is.type(arg, "Array");
+	},
+	Number(arg) {
+		return is.type(arg, "Number");
+	}
+};
+/**
+* 检查对象是否具有指定属性
+* @param rule - 要检查的对象
+* @param k - 属性名
+* @returns 是否具有该属性
+*/
+function hasProperty(rule, k) {
+	return {}.hasOwnProperty.call(rule, k);
+}
+var type_default = is;
+
+//#endregion
+//#region src/todate.ts
+function toDate(timeStamp) {
+	if (type_default.Date(timeStamp)) return timeStamp;
+	else {
+		let date = new Date(timeStamp);
+		return date.toString() === "Invalid Date" ? timeStamp : date;
+	}
+}
+
+//#endregion
+//#region src/modify.ts
+function $set(target, field, value) {
+	target[field] = value;
+}
+function $del(target, field) {
+	delete target[field];
+}
+
+//#endregion
+//#region src/deepextend.ts
+/**
+* 深度扩展对象
+* @param origin - 源对象
+* @param target - 目标对象，默认为空对象
+* @param mode - 模式：true 表示使用 getRule，false 表示使用 _clone，undefined 表示普通模式
+* @returns 扩展后的对象
+*/
+function deepExtend(origin, target = {}, mode) {
+	let isArr = false;
+	const originObj = origin;
+	for (const key in target) if (Object.prototype.hasOwnProperty.call(target, key)) {
+		let clone = target[key];
+		const isObject = typeof clone === "object" && clone !== null && !Array.isArray(clone);
+		if ((isArr = Array.isArray(clone)) || isObject) {
+			const nst = originObj[key] === void 0;
+			if (isArr) {
+				isArr = false;
+				if (nst) $set(originObj, key, []);
+			} else if (clone._clone && mode !== void 0) if (mode) {
+				clone = clone.getRule?.();
+				if (nst) $set(originObj, key, {});
+			} else {
+				$set(originObj, key, clone._clone());
+				continue;
+			}
+			else if (nst) $set(originObj, key, {});
+			originObj[key] = deepExtend(originObj[key], clone, mode);
+		} else {
+			$set(originObj, key, clone);
+			if (!type_default.Undef(clone)) {
+				if (!type_default.Undef(clone.__json)) originObj[key].__json = clone.__json;
+				if (!type_default.Undef(clone.__origin)) originObj[key].__origin = clone.__origin;
+			}
+		}
+	}
+	return mode !== void 0 && Array.isArray(origin) ? origin.filter((v) => !v || !v.__ctrl) : origin;
+}
+/**
+* 深度复制对象
+* @param value - 要复制的值
+* @returns 复制后的值
+*/
+function deepCopy(value) {
+	return deepExtend({}, { value }).value;
+}
+/**
+* 深度扩展多个对象
+* @param origin - 源对象
+* @param lst - 要扩展的对象列表
+* @returns 扩展后的对象
+*/
+function deepExtendArgs(origin, ...lst) {
+	lst.forEach((target) => {
+		origin = deepExtend(origin, target);
+	});
+	return origin;
+}
+
+//#endregion
+//#region src/extend.ts
+const _extends = Object.assign || function(a) {
+	for (let b, c = 1; c < arguments.length; c++) for (let d in b = arguments[c], b) Object.prototype.hasOwnProperty.call(b, d) && $set(a, d, b[d]);
+	return a;
+};
+function extend() {
+	return _extends.apply(this, arguments);
+}
+function copy(obj) {
+	if (typeof obj !== "object" || obj === null) return obj;
+	return obj instanceof Array ? [...obj] : { ...obj };
+}
+
+//#endregion
+//#region src/console.ts
+/**
+* 格式化消息
+* @param type - 消息类型
+* @param msg - 消息内容
+* @param rule - 规则对象（可选）
+* @returns 格式化后的消息字符串
+*/
+function format(type, msg, rule) {
+	return `[form-create ${type}]: ${msg}` + (rule ? "\n\nrule: " + JSON.stringify(rule.getRule ? rule.getRule() : rule) : "");
+}
+/**
+* 输出错误信息
+* @param msg - 错误消息
+* @param rule - 规则对象（可选）
+*/
+function err(msg, rule) {
+	console.error(format("err", msg, rule));
+}
+
+//#endregion
+//#region src/json.ts
+const PREFIX = "[[FORM-CREATE-PREFIX-";
+const SUFFIX = "-FORM-CREATE-SUFFIX]]";
+function toJson(obj, space) {
+	return JSON.stringify(deepExtend(Array.isArray(obj) ? [] : {}, obj, true), function(key, val) {
+		if (val && val._isVue === true) return void 0;
+		if (typeof val !== "function") return val;
+		if (val.__json) return val.__json;
+		if (val.__origin) val = val.__origin;
+		if (val.__emit) return void 0;
+		return PREFIX + val + SUFFIX;
+	}, space);
+}
+function makeFn(fn) {
+	return new Function("return " + fn)();
+}
+function parseFn(fn, mode) {
+	if (fn && type_default.String(fn) && fn.length > 4) {
+		let v = fn.trim();
+		let flag = false;
+		try {
+			if (v.indexOf(SUFFIX) > 0 && v.indexOf(PREFIX) === 0) {
+				v = v.replace(SUFFIX, "").replace(PREFIX, "");
+				flag = true;
+			} else if (v.indexOf("$FN:") === 0) {
+				v = v.substring(4);
+				flag = true;
+			} else if (v.indexOf("$EXEC:") === 0) {
+				v = v.substring(6);
+				flag = true;
+			} else if (v.indexOf("$GLOBAL:") === 0) {
+				const name = v.substring(8);
+				v = function(...args) {
+					const callback = args[0].api.getGlobalEvent(name);
+					if (callback) return callback.call(this, ...args);
+				};
+				v.__json = fn;
+				v.__inject = true;
+				return v;
+			} else if (v.indexOf("$FNX:") === 0) {
+				v = makeFn("function($inject){\n" + v.substring(5) + "\n}");
+				v.__json = fn;
+				v.__inject = true;
+				return v;
+			} else if (!mode && v.indexOf("function ") === 0 && v !== "function ") flag = true;
+			else if (!mode && v.indexOf("function(") === 0 && v !== "function(") flag = true;
+			if (!flag) return fn;
+			let val;
+			try {
+				val = makeFn(v);
+			} catch (e) {
+				val = makeFn("function " + v);
+			}
+			val.__json = fn;
+			return val;
+		} catch (e) {
+			err(`解析失败:${v}\n\nerr: ${e}`);
+			return;
+		}
+	}
+	return fn;
+}
+function parseJson(json, mode) {
+	return JSON.parse(json, function(k, v) {
+		if (type_default.Undef(v) || !v.indexOf) return v;
+		return parseFn(v, mode);
+	});
+}
+
+//#endregion
+//#region src/unique.ts
+var NumIdSingleton = class NumIdSingleton {
+	static _value = 36;
+	get value() {
+		NumIdSingleton._value = NumIdSingleton._value + 1;
+		if (NumIdSingleton._value > 1200) NumIdSingleton._value = 36;
+		return NumIdSingleton._value.toString(36);
+	}
+};
+const numId = new NumIdSingleton();
+let id = 0;
+function uniqueId() {
+	const num = 370 + ++id;
+	return "F" + Math.random().toString(36).substr(3, 3) + Number(`${Date.now()}`).toString(36) + num.toString(36) + "c";
+}
+function shortKey() {
+	return Number(`${dayjs().diff(dayjs("2025-01-01"), "millisecond")}`).toString(36) + numId.value;
+}
+
+//#endregion
+//#region src/slot.ts
+function getSlot(slots, exclude) {
+	return Object.keys(slots).reduce((lst, name) => {
+		if (!exclude || exclude.indexOf(name) === -1) lst[name] = slots[name];
+		return lst;
+	}, {});
+}
+
+//#endregion
+//#region src/deepset.ts
+function deepSet(data, idx, val) {
+	let _data = data, to;
+	(idx || "").split(".").forEach((v) => {
+		if (to) {
+			if (!_data[to] || typeof _data[to] != "object") _data[to] = {};
+			_data = _data[to];
+		}
+		to = v;
+	});
+	_data[to] = val;
+	return _data;
+}
+
+//#endregion
+//#region src/mitt.ts
+function Mitt(all) {
+	all = all || /* @__PURE__ */ new Map();
+	const mitt = {
+		$on(type, handler) {
+			const handlers = all.get(type);
+			if (!(handlers && handlers.push(handler))) all.set(type, [handler]);
+		},
+		$once(type, handler) {
+			handler._once = true;
+			mitt.$on(type, handler);
+		},
+		$off(type, handler) {
+			const handlers = all.get(type);
+			if (handlers) handlers.splice(handlers.indexOf(handler) >>> 0, 1);
+		},
+		$emit(type, ...args) {
+			(all.get(type) || []).slice().map((handler) => {
+				if (handler._once) {
+					mitt.$off(type, handler);
+					delete handler._once;
+				}
+				handler(...args);
+			});
+			(all.get("*") || []).slice().map((handler) => {
+				handler(type, args);
+			});
+		}
+	};
+	return mitt;
+}
+
+//#endregion
+//#region src/tocase.ts
+function toCase(str) {
+	return lower(str.replace(/(-[a-z])/g, function(v) {
+		return v.replace("-", "").toLocaleUpperCase();
+	}));
+}
+function lower(str) {
+	return str.replace(str[0], str[0].toLowerCase());
+}
+
+//#endregion
+//#region src/mergeprops.ts
+const normalMerge = ["props"];
+const toArrayMerge = [
+	"class",
+	"style",
+	"directives"
+];
+const functionalMerge = ["on", "hook"];
+const mergeProps = (objects, initial = {}, opt = {}) => {
+	const _normalMerge = [...normalMerge, ...opt["normal"] || []];
+	const _toArrayMerge = [...toArrayMerge, ...opt["array"] || []];
+	const _functionalMerge = [...functionalMerge, ...opt["functional"] || []];
+	const propsMerge = opt["props"] || [];
+	return objects.reduce((a, b) => {
+		for (const key in b) if (a[key]) if (propsMerge.indexOf(key) > -1) a[key] = mergeProps([b[key]], a[key]);
+		else if (_normalMerge.indexOf(key) > -1) a[key] = {
+			...a[key],
+			...b[key]
+		};
+		else if (_toArrayMerge.indexOf(key) > -1) {
+			const arrA = a[key] instanceof Array ? a[key] : [a[key]];
+			const arrB = b[key] instanceof Array ? b[key] : [b[key]];
+			a[key] = [...arrA, ...arrB];
+		} else if (_functionalMerge.indexOf(key) > -1) for (const event in b[key]) if (a[key][event]) {
+			const arrA = a[key][event] instanceof Array ? a[key][event] : [a[key][event]];
+			const arrB = b[key][event] instanceof Array ? b[key][event] : [b[key][event]];
+			a[key][event] = [...arrA, ...arrB];
+		} else a[key][event] = b[key][event];
+		else if (key === "hook") for (let hook in b[key]) if (a[key][hook]) a[key][hook] = mergeFn(a[key][hook], b[key][hook]);
+		else a[key][hook] = b[key][hook];
+		else a[key] = b[key];
+		else if (_normalMerge.indexOf(key) > -1 || _functionalMerge.indexOf(key) > -1 || propsMerge.indexOf(key) > -1) a[key] = { ...b[key] };
+		else if (_toArrayMerge.indexOf(key) > -1) a[key] = b[key] instanceof Array ? [...b[key]] : typeof b[key] === "object" ? { ...b[key] } : b[key];
+		else a[key] = b[key];
+		return a;
+	}, initial);
+};
+const mergeFn = (fn1, fn2) => function() {
+	fn1 && fn1.apply(this, arguments);
+	fn2 && fn2.apply(this, arguments);
+};
+var mergeprops_default = mergeProps;
+
+//#endregion
+export { $del, $set, Mitt, copy, debounce, deepCopy, deepExtend, deepExtendArgs, deepSet, extend, getSlot, hasProperty, type_default as is, lower, mergeprops_default as mergeProps, parseFn, parseJson, shortKey, toArray, toCase, toDate, toJson, toLine, toPromise, toString, uniqueId };

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@astrolimit/fc-utils",
+  "version": "25.12.018",
+  "description": "",
+  "type": "module",
+  "license": "SFR",
+  "author": "Jack Lee",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "peerDependencies": {
+    "change-case": "^5.4.4",
+    "dayjs": "^1.11.0",
+    "lodash-es": "^4.17.21"
+  }
+}

package/readme.md

@@ -0,0 +1,6 @@
+# 对@form-create/utils的重新打包
+
+## 安装
+```bash
+pnpm i @astrolimit/fc-utils
+```