minutool 1.0.18 → 1.0.19

package/dist/index.d.ts

@@ -721,6 +721,11 @@ export declare const isLandscape: () => boolean;
  * 判断一个值是否为数字
  * @param val - 要判断的值
  * @returns 如果是数字返回 true，否则返回 false
+ * @example
+ * isNumberic(123) // true
+ * isNumberic('123.45') // true
+ * isNumberic('-123') // true
+ * isNumberic('210mm') // false
  */
 export declare const isNumberic: (val: any) => boolean;
 
@@ -1220,6 +1225,24 @@ export declare const mutationEffective: (dom: HTMLElement, option: MutationObser
  */
 export declare const nodeIndex: (node: HTMLElement) => number;
 
+/**
+ * 获取对象的键值对数组，代替 Object.entries，如果key是数字，则转换为数字类型
+ * @param obj - 要获取键值对的对象
+ * @returns 键值对数组
+ * @example
+ * objectEntries({ a: 1, b: 2 }) // [['a', 1], ['b', 2]]
+ */
+export declare const objectEntries: <T extends Record<string | number | symbol, any>>(obj: T) => [keyof T, T[keyof T]][];
+
+/**
+ * 从键值对数组创建对象，代替 Object.fromEntries，如果key是数字字符串，则转换为数字类型
+ * @param entries - 键值对数组
+ * @returns 创建的对象
+ * @example
+ * objectFromEntries([['a', 1], ['b', 2]]) // { a: 1, b: 2 }
+ */
+export declare const objectFromEntries: <T extends Record<string | number | symbol, any>>(entries: Iterable<readonly [string | number, T[keyof T]]>) => T;
+
 /**
  * 获取对象指定路径的值
  * @param obj - 对象
@@ -1233,22 +1256,15 @@ export declare const nodeIndex: (node: HTMLElement) => number;
 export declare function objectGet<T = any>(obj: any, path: string, defaultValue?: T): T;
 
 /**
- * 对象属性名转换（根据映射表重命名属性）
- * @param {Record<string, any>} obj - 源对象
- * @param {Record<string, string>} mapping - 属性名映射表
- * @returns {Record<string, any>} 返回转换后的对象
+ * 根据映射关系替换对象的键
+ * @param obj - 要替换键的对象
+ * @param mapping - 键映射关系，例如 { oldKey: 'newKey' }
+ * @returns 替换键后的新对象
  * @example
- * objectKeyMapping({a: 1, b: 2}, {a: 'x'}) // {x: 1, b: 2}
+ * objectKeyReplace({ a: 1, b: 2 }, { a: 'x' }) // { x: 1, b: 2 }
  */
 export declare const objectKeyReplace: (obj: Record<string, any>, mapping: Record<string, string>) => Record<string, any>;
 
-/**
- * 交换对象中的键值对
- * @param {Object} obj
- * @returns
- */
-export declare const objectKeyValSwap: (obj: object) => any;
-
 /**
  * 合并对象
  * @param target - 目标对象
@@ -1269,6 +1285,15 @@ export declare function objectMerge<T extends object>(target: T, ...sources: Par
  */
 export declare function objectSet(obj: any, path: string, value: any): void;
 
+/**
+ * 交换对象中的键值对
+ * @param obj - 要交换键值对的对象
+ * @returns 交换后的对象
+ * @example
+ * objectSwitchKV({a: 1, b: 2}) // {1: 'a', 2: 'b'}
+ */
+export declare const objectSwitchKV: (obj: object) => any;
+
 /**
  * 将对象转换为 URL 查询字符串
  * @param {Record<string, any>} data - 数据对象
@@ -1625,14 +1650,14 @@ export declare const stripSlashes: (str: string) => string;
 export declare const strToPascalCase: (str: string, capitalize_first?: boolean) => string;
 
 /**
- * 兼容方式获取svg的BBox，避免Firefox获取svg尺寸时，额外考虑了父容器的zoom
- * @param {SVGSVGElement} svg
- * @returns {DOMRect}
- * @returns {DOMRect.width} 单位px
- * @returns {DOMRect.height} 单位px
- * @see https://stackoverflow.com/questions/60814803/getboundingbox-of-svg-element-in-firefox
+ * 获取 SVG 的尺寸（像素单位）
+ * 优先级：width/height 属性 > viewBox > getBoundingClientRect
+ * @param {SVGSVGElement} svg - SVG 元素
+ * @returns {DOMRect} 返回包含像素单位的尺寸对象
+ * @returns {number} DOMRect.width - 宽度（像素）
+ * @returns {number} DOMRect.height - 高度（像素）
  */
-export declare const svgGetBBox: (svg: SVGSVGElement) => DOMRect;
+export declare const svgGetDimension: (svg: SVGSVGElement) => [number, number];
 
 /**
  * svg 对象转换为图片对象
@@ -1749,6 +1774,16 @@ export declare function truncate(str: string, length: number, suffix?: string):
  */
 export declare const unescapeHtml: (html: string) => string;
 
+/**
+ * 单位转换工具，支持px、mm、cm、in等常见单位之间的转换
+ * @returns {Number} 转换后的数值（以目标单位为准）
+ */
+export declare const unitConvert: (value: string | number, toUnit: string, extOption?: {
+    dpi?: number;
+    fontSize?: number | null;
+    lineHeight?: number | null;
+}) => number;
+
 /**
  * URL 转 Base64 Data URL 数据缓存
  * @param {string} url - 文件 URL