minutool 1.0.15 → 1.0.16

package/dist/index.d.ts

@@ -174,6 +174,16 @@ export declare const buildHtmlHidden: (maps: Record<string, any>) => string;
  */
 export declare const buildStyleVars: (vars: Record<string, number | string | undefined>) => Record<string, string>;
 
+/**
+ * 计算剩余时间，单位为毫秒
+ * @param progress 当前进度
+ * @param total 总进度
+ * @param startTime 开始时间（毫秒时间戳）
+ * @returns 剩余时间，单位毫秒
+ * @description 根据当前进度、总进度和已用时间估算剩余时间。公式为：剩余时间 = (已用时间 / 当前进度) * (总进度 - 当前进度)。如果当前进度为0，则返回Infinity。
+ */
+export declare const calcRemainingMSecs: (progress: number, total: number, startTime: number) => number;
+
 /**
  * 驼峰命名转换
  * @param str - 输入字符串
@@ -207,9 +217,6 @@ export declare const convertMinutesToTimezoneOffsetStr: (offsetMinutes: number)
 
 /**
  * 倒计时函数（该方法采用 setTimeout 方式，不够精准）
- * @param {number} timeout - 倒计时总秒数
- * @param {Function} [tickFunc] - 每秒回调函数，接收剩余秒数作为参数
- * @param {Function} [onFinish] - 倒计时结束回调函数
  * @returns {void}
  * @example
  * countDown(10, (sec) => console.log(sec), () => console.log('done'))
@@ -443,23 +450,17 @@ export declare const fileToBase64DataUri: (file: File | Blob | string) => Promis
 
 /**
  * 通过选择器查找子节点（强制添加 :scope 来约束必须是子节点）
- * @param {string|HTMLElement|HTMLElement[]|NodeList|HTMLCollection} selector - 选择器或 DOM 元素
- * @param {Document|HTMLElement} [parent=document] - 父节点，默认为 document
- * @returns {HTMLElement[]} 返回查找到的所有元素数组
  * @example
  * findAll('.item', container)
  */
-export declare const findAll: (selector: string | HTMLElement | HTMLElement[] | NodeList | HTMLCollection, parent?: Document | HTMLElement) => HTMLElement[];
+export declare const findAll: (selector: string | Element | Element[], parent?: Document | DocumentFragment | Element) => Element[];
 
 /**
  * 通过选择器查找单个节点
- * @param {string|HTMLElement} selector - 选择器，如果是 HTMLElement，则直接返回
- * @param {Document|HTMLElement} [parent=document] - 父节点，默认为 document
- * @returns {HTMLElement} 返回查找到的元素
  * @example
  * findOne('.item')
  */
-export declare const findOne: (selector: string | HTMLElement, parent?: Document | HTMLElement) => HTMLElement;
+export declare const findOne: (selector: string | Element, parent?: Document | DocumentFragment | Element) => Element | null;
 
 /**
  * 修复基本 URL（将相对路径转换为绝对 URL）
@@ -587,6 +588,7 @@ export declare const guid: (prefix?: string) => string;
 
 /**
  * 隐藏节点（通过设置 display:none 方式）
+ * 注：只有 HTMLElement 才有 style 属性，其他类型的 Node 没有，因此需要断言为 HTMLElement
  * @param {HTMLElement|string} dom - DOM 元素或选择器
  * @returns {void}
  * @example
@@ -1178,8 +1180,6 @@ export declare const MONTH_NOW: number;
 
 /**
  * 毫秒转换为“时分秒前”格式
- * @param {number} ms - 毫秒数
- * @returns {string} 返回格式化后的字符串
  * @example
  * msToHMS(3661000) // '1小时0分钟1秒前'
  */
@@ -1517,6 +1517,7 @@ export declare const setCookie: (name: string, value: string, days: number, path
 
 /**
  * 显示节点（通过设置 display 为空方式）
+ * 注：只有 HTMLElement 才有 style 属性，其他类型的 Node 没有，因此需要断言为 HTMLElement
  * @param {HTMLElement|string} dom - DOM 元素或选择器
  * @returns {void}
  * @example
@@ -1621,6 +1622,15 @@ export declare const throttle: (fn: Function, intervalMiSec: number) => Function
  */
 export declare const throttleEffect: (fn: Function, intervalMiSec: number) => Function;
 
+/**
+ * 将时间戳转换为本地时间的日期时间字符串（YYYY-MM-DDTHH:mm），
+ * 一般用于填充到 input[type="datetime-local"] 的 value 属性中
+ * @param timestamp 时间戳，可以是数字、字符串或 Date 对象
+ * @param includeSec 是否包含秒，默认为 false，如果为 true 则返回的字符串格式为 YYYY-MM-DDTHH:mm:ss
+ * @returns 本地时间的日期时间字符串，格式为 YYYY-MM-DDTHH:mm:ss（如果 includeSec 参数为 true 则包含秒）
+ */
+export declare const timestampToDateTimeLocal: (timestamp: number | string | Date, includeSec?: boolean) => string;
+
 /**
  * 禁用启用元素切换
  * @param {String|Node} el