a2bei4-utils 1.0.0

package/dist/tree.js

@@ -0,0 +1,95 @@
+/**
+ * 把嵌套树拍平成 `{ [id]: node }` 映射，同时把原 `children` 置为 `null`。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {T[]} data - 嵌套树森林
+ * @param {string} [idKey='id'] - 主键字段
+ * @param {string} [childrenKey='children'] - 子节点字段
+ * @returns {Record<string, T & { [k in typeof childrenKey]: null }>} id→节点的映射表
+ */
+function nestedTree2IdMap(data, idKey = "id", childrenKey = "children") {
+    const retObj = {};
+    function fn(nodes) {
+        if (Array.isArray(nodes) && nodes.length > 0) {
+            nodes.forEach((node) => {
+                retObj[node[idKey]] = { ...node };
+                retObj[node[idKey]][childrenKey] = null;
+
+                fn(node[childrenKey]);
+            });
+        }
+    }
+    fn(data);
+    return retObj;
+}
+
+/**
+ * 把**已包含完整父子关系**的扁平节点列表还原成嵌套树（森林）。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {T[]} nodes - 扁平节点列表（必须包含 id / parentId）
+ * @param {number | string} [parentId=0] - 根节点标识值
+ * @param {Object} [opts] - 字段映射配置
+ * @param {string} [opts.idKey='id'] - 节点主键
+ * @param {string} [opts.parentKey='parentId'] - 父节点外键
+ * @param {string} [opts.childrenKey='children'] - 存放子节点的字段
+ * @returns {(T & { [k in typeof childrenKey]: T[] })[]} 嵌套树森林
+ */
+function flatCompleteTree2NestedTree(nodes, parentId = 0, { idKey = "id", parentKey = "parentId", childrenKey = "children" } = {}) {
+    const map = new Map(); // id -> node
+    const items = []; // 多根森林
+
+    // 1. 初始化：保证每个节点都有 children，并存入 map
+    for (const item of nodes) {
+        const node = { ...item, [childrenKey]: [] };
+        map.set(item[idKey], node);
+    }
+
+    // 2. 建立父子关系
+    for (const item of nodes) {
+        const node = map.get(item[idKey]);
+        const parentIdVal = item[parentKey];
+
+        if (parentIdVal === parentId) {
+            // 根层
+            items.push(node);
+        } else {
+            // 非根层：找到父节点，把自己挂上去
+            const parent = map.get(parentIdVal);
+            if (parent) parent[childrenKey].push(node);
+            // 如果 parent 不存在，说明数据不完整，可自定义处理
+        }
+    }
+
+    return items;
+}
+
+/**
+ * 在嵌套树中按 `id` 递归查找节点，并返回其指定属性值。
+ *
+ * @template T extends Record<PropertyKey, any>
+ * @param {string | number} id - 要查找的 id
+ * @param {T[]} arr - 嵌套树森林
+ * @param {string} [resultKey='name'] - 需要返回的字段
+ * @param {string} [idKey='id'] - 主键字段
+ * @param {string} [childrenKey='children'] - 子节点字段
+ * @returns {any} 找到的值；未找到返回 `undefined`
+ */
+const findObjAttrValueById = function findObjAttrValueByIdFn(id, arr, resultKey = "name", idKey = "id", childrenKey = "children") {
+    if (Array.isArray(arr) && arr.length > 0) {
+        for (let i = 0; i < arr.length; i++) {
+            const item = arr[i];
+            if (item[idKey]?.toString() === id?.toString()) {
+                return item[resultKey];
+            } else if (Array.isArray(item[childrenKey]) && item[childrenKey].length > 0) {
+                const result = findObjAttrValueByIdFn(id, item[childrenKey], resultKey, idKey, childrenKey);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+    }
+};
+
+export { findObjAttrValueById, flatCompleteTree2NestedTree, nestedTree2IdMap };
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sources":["../src/source/tree.js"],"sourcesContent":["/**\n * 把嵌套树拍平成 `{ [id]: node }` 映射，同时把原 `children` 置为 `null`。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {T[]} data - 嵌套树森林\n * @param {string} [idKey='id'] - 主键字段\n * @param {string} [childrenKey='children'] - 子节点字段\n * @returns {Record<string, T & { [k in typeof childrenKey]: null }>} id→节点的映射表\n */\nexport function nestedTree2IdMap(data, idKey = \"id\", childrenKey = \"children\") {\n    const retObj = {};\n    function fn(nodes) {\n        if (Array.isArray(nodes) && nodes.length > 0) {\n            nodes.forEach((node) => {\n                retObj[node[idKey]] = { ...node };\n                retObj[node[idKey]][childrenKey] = null;\n\n                fn(node[childrenKey]);\n            });\n        }\n    }\n    fn(data);\n    return retObj;\n}\n\n/**\n * 把**已包含完整父子关系**的扁平节点列表还原成嵌套树（森林）。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {T[]} nodes - 扁平节点列表（必须包含 id / parentId）\n * @param {number | string} [parentId=0] - 根节点标识值\n * @param {Object} [opts] - 字段映射配置\n * @param {string} [opts.idKey='id'] - 节点主键\n * @param {string} [opts.parentKey='parentId'] - 父节点外键\n * @param {string} [opts.childrenKey='children'] - 存放子节点的字段\n * @returns {(T & { [k in typeof childrenKey]: T[] })[]} 嵌套树森林\n */\nexport function flatCompleteTree2NestedTree(nodes, parentId = 0, { idKey = \"id\", parentKey = \"parentId\", childrenKey = \"children\" } = {}) {\n    const map = new Map(); // id -> node\n    const items = []; // 多根森林\n\n    // 1. 初始化：保证每个节点都有 children，并存入 map\n    for (const item of nodes) {\n        const node = { ...item, [childrenKey]: [] };\n        map.set(item[idKey], node);\n    }\n\n    // 2. 建立父子关系\n    for (const item of nodes) {\n        const node = map.get(item[idKey]);\n        const parentIdVal = item[parentKey];\n\n        if (parentIdVal === parentId) {\n            // 根层\n            items.push(node);\n        } else {\n            // 非根层：找到父节点，把自己挂上去\n            const parent = map.get(parentIdVal);\n            if (parent) parent[childrenKey].push(node);\n            // 如果 parent 不存在，说明数据不完整，可自定义处理\n        }\n    }\n\n    return items;\n}\n\n/**\n * 在嵌套树中按 `id` 递归查找节点，并返回其指定属性值。\n *\n * @template T extends Record<PropertyKey, any>\n * @param {string | number} id - 要查找的 id\n * @param {T[]} arr - 嵌套树森林\n * @param {string} [resultKey='name'] - 需要返回的字段\n * @param {string} [idKey='id'] - 主键字段\n * @param {string} [childrenKey='children'] - 子节点字段\n * @returns {any} 找到的值；未找到返回 `undefined`\n */\nexport const findObjAttrValueById = function findObjAttrValueByIdFn(id, arr, resultKey = \"name\", idKey = \"id\", childrenKey = \"children\") {\n    if (Array.isArray(arr) && arr.length > 0) {\n        for (let i = 0; i < arr.length; i++) {\n            const item = arr[i];\n            if (item[idKey]?.toString() === id?.toString()) {\n                return item[resultKey];\n            } else if (Array.isArray(item[childrenKey]) && item[childrenKey].length > 0) {\n                const result = findObjAttrValueByIdFn(id, item[childrenKey], resultKey, idKey, childrenKey);\n                if (result) {\n                    return result;\n                }\n            }\n        }\n    }\n};\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,146 @@
+{
+  "name": "a2bei4-utils",
+  "version": "1.0.0",
+  "description": "🧰 零依赖、ESM 的 JS 业务工具箱：数组乱序/深浅克隆、防抖节流、URL/query 解析、Date/时长格式化、随机汉字/字母、文件下载、事件总线、UUID/分布式短 ID、树结构互转等 40+ 常用函数 & 类，Tree-Shaking 友好。",
+  "private": false,
+  "type": "module",
+  "main": "dist/a2bei4.utils.cjs.js",
+  "module": "dist/a2bei4.utils.esm.js",
+  "unpkg": "dist/a2bei4.utils.umd.min.js",
+  "jsdelivr": "dist/a2bei4.utils.umd.min.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/a2bei4.utils.esm.js",
+      "require": "./dist/a2bei4.utils.cjs.js"
+    },
+    "./arr": {
+      "types": "./types/arr.d.ts",
+      "import": "./dist/arr.js",
+      "require": "./dist/arr.cjs"
+    },
+    "./browser": {
+      "types": "./types/browser.d.ts",
+      "import": "./dist/browser.js",
+      "require": "./dist/browser.cjs"
+    },
+    "./common": {
+      "types": "./types/common.d.ts",
+      "import": "./dist/common.js",
+      "require": "./dist/common.cjs"
+    },
+    "./date": {
+      "types": "./types/date.d.ts",
+      "import": "./dist/date.js",
+      "require": "./dist/date.cjs"
+    },
+    "./download": {
+      "types": "./types/download.d.ts",
+      "import": "./dist/download.js",
+      "require": "./dist/download.cjs"
+    },
+    "./evt": {
+      "types": "./types/evt.d.ts",
+      "import": "./dist/evt.js",
+      "require": "./dist/evt.cjs"
+    },
+    "./id": {
+      "types": "./types/id.d.ts",
+      "import": "./dist/id.js",
+      "require": "./dist/id.cjs"
+    },
+    "./timer": {
+      "types": "./types/timer.d.ts",
+      "import": "./dist/timer.js",
+      "require": "./dist/timer.cjs"
+    },
+    "./tree": {
+      "types": "./types/tree.d.ts",
+      "import": "./dist/tree.js",
+      "require": "./dist/tree.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "types"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "a2bei4",
+    "xiaodu114",
+    "utils",
+    "utilities",
+    "toolkit",
+    "zero-dependency",
+    "esm",
+    "shuffle",
+    "move-array-item",
+    "deep-clone",
+    "assign-existing",
+    "tree-flat",
+    "tree-nested",
+    "tree-utils",
+    "debounce",
+    "throttle",
+    "random",
+    "random-han",
+    "random-en",
+    "uuid",
+    "guid",
+    "id",
+    "short-id",
+    "nanoid",
+    "date-format",
+    "duration-format",
+    "time-diff",
+    "random-date",
+    "viewport",
+    "download",
+    "download-excel",
+    "download-json",
+    "event-bus",
+    "cross-page",
+    "is-plain-object",
+    "is-promise",
+    "is-blob",
+    "is-date",
+    "is-function",
+    "get-type",
+    "blob-to-text",
+    "read-file",
+    "file-download",
+    "business-utils",
+    "frontend-utils",
+    "daily-helper"
+  ],
+  "license": "MIT",
+  "author": "xiaodu114",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xiaodu114/a2bei4-utils.git"
+  },
+  "homepage": "https://github.com/xiaodu114/a2bei4-utils",
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-node-resolve": "^16.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "prettier": "^3.6.2",
+    "rollup": "^4.52.4",
+    "rollup-plugin-dts": "^6.2.3",
+    "rollup-plugin-filesize": "^10.0.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "update:package": "node scripts/update-package.js",
+    "generate:entry": "node scripts/generate-entry.js",
+    "generate:index": "node scripts/generate-index.js",
+    "prebuild": "pnpm run update:package && pnpm run generate:entry && pnpm run generate:index",
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "format": "prettier --write \"src/**/*.{js,ts,json,md}\""
+  }
+}

package/readme.txt

@@ -0,0 +1,18 @@
+0、首次安装依赖
+pnpm i -D @rollup/plugin-commonjs @rollup/plugin-node-resolve @rollup/plugin-terser prettier rollup rollup-plugin-dts rollup-plugin-filesize typescript
+
+
+-->  官方 npm 仓库地址：https://registry.npmjs.org/
+-->  --registry 显示指定的仓库地址，如：http://192.168.x.x:4873
+
+1、如果没有用户，先注册用户
+pnpm adduser --registry https://registry.npmjs.org/
+
+2、用户登录
+pnpm login --registry https://registry.npmjs.org/
+
+3、发布
+pnpm publish --registry https://registry.npmjs.org/
+
+4、撤销发布
+pnpm unpublish a2bei4-utils --force --registry https://registry.npmjs.org/

package/types/arr.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 使用 Fisher-Yates 算法对数组 **原地** 随机乱序。
+ * @template T
+ * @param {T[]} arr - 要乱序的数组
+ * @returns {T[]} 返回传入的同一数组实例（已乱序）
+ */
+declare function shuffle<T>(arr: T[]): T[];
+/**
+ * 将数组中的元素从 `fromIndex` 移动到 `toIndex`，**原地** 修改并返回该数组。
+ * @template T
+ * @param {T[]} arr - 要操作的数组
+ * @param {number} fromIndex - 原始下标
+ * @param {number} toIndex - 目标下标
+ * @returns {T[]} 返回传入的同一数组实例
+ */
+declare function moveItem<T>(arr: T[], fromIndex: number, toIndex: number): T[];
+
+export { moveItem, shuffle };

package/types/browser.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 视口尺寸对象。
+ * @typedef {Object} ViewportDimensions
+ * @property {number} w 视口宽度，单位像素。
+ * @property {number} h 视口高度，单位像素。
+ */
+/**
+ * 获取当前视口（viewport）的宽高。
+ *
+ * 兼容策略：
+ * 1. 优先使用 `window.innerWidth/innerHeight`（现代浏览器）。
+ * 2. 降级到 `document.documentElement.clientWidth/clientHeight`（IE9+ 及怪异模式）。
+ * 3. 最后降级到 `document.body.clientWidth/clientHeight`（IE6-8 怪异模式）。
+ *
+ * @returns {ViewportDimensions} 包含 `w`（宽度）和 `h`（高度）的对象，单位为像素。
+ *
+ * @example
+ * const { w, h } = getViewportSize();
+ * console.log(`视口尺寸：${w} × ${h}`);
+ */
+declare function getViewportSize(): ViewportDimensions;
+/**
+ * 将当前页面 URL 的 query 部分解析成键值对对象。
+ *
+ * @returns {Record<string, string>} 所有查询参数组成的平凡对象
+ *                                   （同名 key 仅保留最后一项）
+ */
+declare function getAllSearchParams(): Record<string, string>;
+/**
+ * 根据 key 获取当前页面 URL 中的单个查询参数。
+ *
+ * @param {string} key - 要提取的参数名
+ * @returns {string | undefined} 对应参数值；不存在时返回 `undefined`
+ */
+declare function getSearchParam(key: string): string | undefined;
+/**
+ * 视口尺寸对象。
+ */
+type ViewportDimensions = {
+    /**
+     * 视口宽度，单位像素。
+     */
+    w: number;
+    /**
+     * 视口高度，单位像素。
+     */
+    h: number;
+};
+
+export { getAllSearchParams, getSearchParam, getViewportSize };
+export type { ViewportDimensions };

package/types/common.d.ts

@@ -0,0 +1,170 @@
+/**
+ * 返回任意值的运行时类型字符串（小写形式）。
+ *
+ * @param {*} obj 待检测的值
+ * @returns {keyof globalThis|"blob"|"file"|"formdata"|string} 小写类型名
+ */
+declare function getDataType(obj: any): ("undefined" | "globalThis" | "eval" | "parseInt" | "parseFloat" | "isNaN" | "isFinite" | "decodeURI" | "decodeURIComponent" | "encodeURI" | "encodeURIComponent" | "escape" | "unescape" | "NaN" | "Infinity" | "Symbol" | "Object" | "Function" | "String" | "Boolean" | "Number" | "Math" | "Date" | "RegExp" | "Error" | "EvalError" | "RangeError" | "ReferenceError" | "SyntaxError" | "TypeError" | "URIError" | "JSON" | "Array" | "Promise" | "ArrayBuffer" | "DataView" | "Int8Array" | "Uint8Array" | "Uint8ClampedArray" | "Int16Array" | "Uint16Array" | "Int32Array" | "Uint32Array" | "Float32Array" | "Float64Array" | "Intl" | "alert" | "blur" | "cancelIdleCallback" | "captureEvents" | "close" | "confirm" | "focus" | "getComputedStyle" | "getSelection" | "matchMedia" | "moveBy" | "moveTo" | "open" | "postMessage" | "print" | "prompt" | "releaseEvents" | "requestIdleCallback" | "resizeBy" | "resizeTo" | "scroll" | "scrollBy" | "scrollTo" | "stop" | "toString" | "dispatchEvent" | "cancelAnimationFrame" | "requestAnimationFrame" | "atob" | "btoa" | "clearInterval" | "clearTimeout" | "createImageBitmap" | "fetch" | "queueMicrotask" | "reportError" | "setInterval" | "setTimeout" | "structuredClone" | "addEventListener" | "removeEventListener" | "NodeFilter" | "AbortController" | "AbortSignal" | "AbstractRange" | "AnalyserNode" | "Animation" | "AnimationEffect" | "AnimationEvent" | "AnimationPlaybackEvent" | "AnimationTimeline" | "Attr" | "AudioBuffer" | "AudioBufferSourceNode" | "AudioContext" | "AudioData" | "AudioDecoder" | "AudioDestinationNode" | "AudioEncoder" | "AudioListener" | "AudioNode" | "AudioParam" | "AudioParamMap" | "AudioProcessingEvent" | "AudioScheduledSourceNode" | "AudioWorklet" | "AudioWorkletNode" | "AuthenticatorAssertionResponse" | "AuthenticatorAttestationResponse" | "AuthenticatorResponse" | "BarProp" | "BaseAudioContext" | "BeforeUnloadEvent" | "BiquadFilterNode" | "Blob" | "BlobEvent" | "BroadcastChannel" | "ByteLengthQueuingStrategy" | "CDATASection" | "CSPViolationReportBody" | "CSSAnimation" | "CSSConditionRule" | "CSSContainerRule" | "CSSCounterStyleRule" | "CSSFontFaceRule" | "CSSFontFeatureValuesRule" | "CSSFontPaletteValuesRule" | "CSSGroupingRule" | "CSSImageValue" | "CSSImportRule" | "CSSKeyframeRule" | "CSSKeyframesRule" | "CSSKeywordValue" | "CSSLayerBlockRule" | "CSSLayerStatementRule" | "CSSMathClamp" | "CSSMathInvert" | "CSSMathMax" | "CSSMathMin" | "CSSMathNegate" | "CSSMathProduct" | "CSSMathSum" | "CSSMathValue" | "CSSMatrixComponent" | "CSSMediaRule" | "CSSNamespaceRule" | "CSSNestedDeclarations" | "CSSNumericArray" | "CSSNumericValue" | "CSSPageRule" | "CSSPerspective" | "CSSPropertyRule" | "CSSRotate" | "CSSRule" | "CSSRuleList" | "CSSScale" | "CSSScopeRule" | "CSSSkew" | "CSSSkewX" | "CSSSkewY" | "CSSStartingStyleRule" | "CSSStyleDeclaration" | "CSSStyleRule" | "CSSStyleSheet" | "CSSStyleValue" | "CSSSupportsRule" | "CSSTransformComponent" | "CSSTransformValue" | "CSSTransition" | "CSSTranslate" | "CSSUnitValue" | "CSSUnparsedValue" | "CSSVariableReferenceValue" | "CSSViewTransitionRule" | "Cache" | "CacheStorage" | "CanvasCaptureMediaStreamTrack" | "CanvasGradient" | "CanvasPattern" | "CanvasRenderingContext2D" | "CaretPosition" | "ChannelMergerNode" | "ChannelSplitterNode" | "CharacterData" | "Clipboard" | "ClipboardEvent" | "ClipboardItem" | "CloseEvent" | "Comment" | "CompositionEvent" | "CompressionStream" | "ConstantSourceNode" | "ContentVisibilityAutoStateChangeEvent" | "ConvolverNode" | "CookieChangeEvent" | "CookieStore" | "CookieStoreManager" | "CountQueuingStrategy" | "Credential" | "CredentialsContainer" | "Crypto" | "CryptoKey" | "CustomElementRegistry" | "CustomEvent" | "CustomStateSet" | "DOMException" | "DOMImplementation" | "DOMMatrix" | "SVGMatrix" | "WebKitCSSMatrix" | "DOMMatrixReadOnly" | "DOMParser" | "DOMPoint" | "SVGPoint" | "DOMPointReadOnly" | "DOMQuad" | "DOMRect" | "SVGRect" | "DOMRectList" | "DOMRectReadOnly" | "DOMStringList" | "DOMStringMap" | "DOMTokenList" | "DataTransfer" | "DataTransferItem" | "DataTransferItemList" | "DecompressionStream" | "DelayNode" | "DeviceMotionEvent" | "DeviceOrientationEvent" | "Document" | "DocumentFragment" | "DocumentTimeline" | "DocumentType" | "DragEvent" | "DynamicsCompressorNode" | "Element" | "ElementInternals" | "EncodedAudioChunk" | "EncodedVideoChunk" | "ErrorEvent" | "Event" | "EventCounts" | "EventSource" | "EventTarget" | "External" | "File" | "FileList" | "FileReader" | "FileSystem" | "FileSystemDirectoryEntry" | "FileSystemDirectoryHandle" | "FileSystemDirectoryReader" | "FileSystemEntry" | "FileSystemFileEntry" | "FileSystemFileHandle" | "FileSystemHandle" | "FileSystemWritableFileStream" | "FocusEvent" | "FontFace" | "FontFaceSet" | "FontFaceSetLoadEvent" | "FormData" | "FormDataEvent" | "FragmentDirective" | "GainNode" | "Gamepad" | "GamepadButton" | "GamepadEvent" | "GamepadHapticActuator" | "Geolocation" | "GeolocationCoordinates" | "GeolocationPosition" | "GeolocationPositionError" | "HTMLAllCollection" | "HTMLAnchorElement" | "HTMLAreaElement" | "HTMLAudioElement" | "HTMLBRElement" | "HTMLBaseElement" | "HTMLBodyElement" | "HTMLButtonElement" | "HTMLCanvasElement" | "HTMLCollection" | "HTMLDListElement" | "HTMLDataElement" | "HTMLDataListElement" | "HTMLDetailsElement" | "HTMLDialogElement" | "HTMLDirectoryElement" | "HTMLDivElement" | "HTMLDocument" | "HTMLElement" | "HTMLEmbedElement" | "HTMLFieldSetElement" | "HTMLFontElement" | "HTMLFormControlsCollection" | "HTMLFormElement" | "HTMLFrameElement" | "HTMLFrameSetElement" | "HTMLHRElement" | "HTMLHeadElement" | "HTMLHeadingElement" | "HTMLHtmlElement" | "HTMLIFrameElement" | "HTMLImageElement" | "HTMLInputElement" | "HTMLLIElement" | "HTMLLabelElement" | "HTMLLegendElement" | "HTMLLinkElement" | "HTMLMapElement" | "HTMLMarqueeElement" | "HTMLMediaElement" | "HTMLMenuElement" | "HTMLMetaElement" | "HTMLMeterElement" | "HTMLModElement" | "HTMLOListElement" | "HTMLObjectElement" | "HTMLOptGroupElement" | "HTMLOptionElement" | "HTMLOptionsCollection" | "HTMLOutputElement" | "HTMLParagraphElement" | "HTMLParamElement" | "HTMLPictureElement" | "HTMLPreElement" | "HTMLProgressElement" | "HTMLQuoteElement" | "HTMLScriptElement" | "HTMLSelectElement" | "HTMLSlotElement" | "HTMLSourceElement" | "HTMLSpanElement" | "HTMLStyleElement" | "HTMLTableCaptionElement" | "HTMLTableCellElement" | "HTMLTableColElement" | "HTMLTableElement" | "HTMLTableRowElement" | "HTMLTableSectionElement" | "HTMLTemplateElement" | "HTMLTextAreaElement" | "HTMLTimeElement" | "HTMLTitleElement" | "HTMLTrackElement" | "HTMLUListElement" | "HTMLUnknownElement" | "HTMLVideoElement" | "HashChangeEvent" | "Headers" | "Highlight" | "HighlightRegistry" | "History" | "IDBCursor" | "IDBCursorWithValue" | "IDBDatabase" | "IDBFactory" | "IDBIndex" | "IDBKeyRange" | "IDBObjectStore" | "IDBOpenDBRequest" | "IDBRequest" | "IDBTransaction" | "IDBVersionChangeEvent" | "IIRFilterNode" | "IdleDeadline" | "ImageBitmap" | "ImageBitmapRenderingContext" | "ImageCapture" | "ImageData" | "ImageDecoder" | "ImageTrack" | "ImageTrackList" | "InputDeviceInfo" | "InputEvent" | "IntersectionObserver" | "IntersectionObserverEntry" | "KeyboardEvent" | "KeyframeEffect" | "LargestContentfulPaint" | "Location" | "Lock" | "LockManager" | "MIDIAccess" | "MIDIConnectionEvent" | "MIDIInput" | "MIDIInputMap" | "MIDIMessageEvent" | "MIDIOutput" | "MIDIOutputMap" | "MIDIPort" | "MathMLElement" | "MediaCapabilities" | "MediaDeviceInfo" | "MediaDevices" | "MediaElementAudioSourceNode" | "MediaEncryptedEvent" | "MediaError" | "MediaKeyMessageEvent" | "MediaKeySession" | "MediaKeyStatusMap" | "MediaKeySystemAccess" | "MediaKeys" | "MediaList" | "MediaMetadata" | "MediaQueryList" | "MediaQueryListEvent" | "MediaRecorder" | "MediaSession" | "MediaSource" | "MediaSourceHandle" | "MediaStream" | "MediaStreamAudioDestinationNode" | "MediaStreamAudioSourceNode" | "MediaStreamTrack" | "MediaStreamTrackEvent" | "MessageChannel" | "MessageEvent" | "MessagePort" | "MimeType" | "MimeTypeArray" | "MouseEvent" | "MutationObserver" | "MutationRecord" | "NamedNodeMap" | "NavigationActivation" | "NavigationHistoryEntry" | "NavigationPreloadManager" | "Navigator" | "NavigatorLogin" | "Node" | "NodeIterator" | "NodeList" | "Notification" | "OfflineAudioCompletionEvent" | "OfflineAudioContext" | "OffscreenCanvas" | "OffscreenCanvasRenderingContext2D" | "OscillatorNode" | "OverconstrainedError" | "PageRevealEvent" | "PageSwapEvent" | "PageTransitionEvent" | "PannerNode" | "Path2D" | "PaymentAddress" | "PaymentMethodChangeEvent" | "PaymentRequest" | "PaymentRequestUpdateEvent" | "PaymentResponse" | "Performance" | "PerformanceEntry" | "PerformanceEventTiming" | "PerformanceMark" | "PerformanceMeasure" | "PerformanceNavigation" | "PerformanceNavigationTiming" | "PerformanceObserver" | "PerformanceObserverEntryList" | "PerformancePaintTiming" | "PerformanceResourceTiming" | "PerformanceServerTiming" | "PerformanceTiming" | "PeriodicWave" | "PermissionStatus" | "Permissions" | "PictureInPictureEvent" | "PictureInPictureWindow" | "Plugin" | "PluginArray" | "PointerEvent" | "PopStateEvent" | "ProcessingInstruction" | "ProgressEvent" | "PromiseRejectionEvent" | "PublicKeyCredential" | "PushManager" | "PushSubscription" | "PushSubscriptionOptions" | "RTCCertificate" | "RTCDTMFSender" | "RTCDTMFToneChangeEvent" | "RTCDataChannel" | "RTCDataChannelEvent" | "RTCDtlsTransport" | "RTCEncodedAudioFrame" | "RTCEncodedVideoFrame" | "RTCError" | "RTCErrorEvent" | "RTCIceCandidate" | "RTCIceTransport" | "RTCPeerConnection" | "RTCPeerConnectionIceErrorEvent" | "RTCPeerConnectionIceEvent" | "RTCRtpReceiver" | "RTCRtpScriptTransform" | "RTCRtpSender" | "RTCRtpTransceiver" | "RTCSctpTransport" | "RTCSessionDescription" | "RTCStatsReport" | "RTCTrackEvent" | "RadioNodeList" | "Range" | "ReadableByteStreamController" | "ReadableStream" | "ReadableStreamBYOBReader" | "ReadableStreamBYOBRequest" | "ReadableStreamDefaultController" | "ReadableStreamDefaultReader" | "RemotePlayback" | "Report" | "ReportBody" | "ReportingObserver" | "Request" | "ResizeObserver" | "ResizeObserverEntry" | "ResizeObserverSize" | "Response" | "SVGAElement" | "SVGAngle" | "SVGAnimateElement" | "SVGAnimateMotionElement" | "SVGAnimateTransformElement" | "SVGAnimatedAngle" | "SVGAnimatedBoolean" | "SVGAnimatedEnumeration" | "SVGAnimatedInteger" | "SVGAnimatedLength" | "SVGAnimatedLengthList" | "SVGAnimatedNumber" | "SVGAnimatedNumberList" | "SVGAnimatedPreserveAspectRatio" | "SVGAnimatedRect" | "SVGAnimatedString" | "SVGAnimatedTransformList" | "SVGAnimationElement" | "SVGCircleElement" | "SVGClipPathElement" | "SVGComponentTransferFunctionElement" | "SVGDefsElement" | "SVGDescElement" | "SVGElement" | "SVGEllipseElement" | "SVGFEBlendElement" | "SVGFEColorMatrixElement" | "SVGFEComponentTransferElement" | "SVGFECompositeElement" | "SVGFEConvolveMatrixElement" | "SVGFEDiffuseLightingElement" | "SVGFEDisplacementMapElement" | "SVGFEDistantLightElement" | "SVGFEDropShadowElement" | "SVGFEFloodElement" | "SVGFEFuncAElement" | "SVGFEFuncBElement" | "SVGFEFuncGElement" | "SVGFEFuncRElement" | "SVGFEGaussianBlurElement" | "SVGFEImageElement" | "SVGFEMergeElement" | "SVGFEMergeNodeElement" | "SVGFEMorphologyElement" | "SVGFEOffsetElement" | "SVGFEPointLightElement" | "SVGFESpecularLightingElement" | "SVGFESpotLightElement" | "SVGFETileElement" | "SVGFETurbulenceElement" | "SVGFilterElement" | "SVGForeignObjectElement" | "SVGGElement" | "SVGGeometryElement" | "SVGGradientElement" | "SVGGraphicsElement" | "SVGImageElement" | "SVGLength" | "SVGLengthList" | "SVGLineElement" | "SVGLinearGradientElement" | "SVGMPathElement" | "SVGMarkerElement" | "SVGMaskElement" | "SVGMetadataElement" | "SVGNumber" | "SVGNumberList" | "SVGPathElement" | "SVGPatternElement" | "SVGPointList" | "SVGPolygonElement" | "SVGPolylineElement" | "SVGPreserveAspectRatio" | "SVGRadialGradientElement" | "SVGRectElement" | "SVGSVGElement" | "SVGScriptElement" | "SVGSetElement" | "SVGStopElement" | "SVGStringList" | "SVGStyleElement" | "SVGSwitchElement" | "SVGSymbolElement" | "SVGTSpanElement" | "SVGTextContentElement" | "SVGTextElement" | "SVGTextPathElement" | "SVGTextPositioningElement" | "SVGTitleElement" | "SVGTransform" | "SVGTransformList" | "SVGUnitTypes" | "SVGUseElement" | "SVGViewElement" | "Screen" | "ScreenOrientation" | "ScriptProcessorNode" | "SecurityPolicyViolationEvent" | "Selection" | "ServiceWorker" | "ServiceWorkerContainer" | "ServiceWorkerRegistration" | "ShadowRoot" | "SharedWorker" | "SourceBuffer" | "SourceBufferList" | "SpeechRecognitionAlternative" | "SpeechRecognitionResult" | "SpeechRecognitionResultList" | "SpeechSynthesis" | "SpeechSynthesisErrorEvent" | "SpeechSynthesisEvent" | "SpeechSynthesisUtterance" | "SpeechSynthesisVoice" | "StaticRange" | "StereoPannerNode" | "Storage" | "StorageEvent" | "StorageManager" | "StylePropertyMap" | "StylePropertyMapReadOnly" | "StyleSheet" | "StyleSheetList" | "SubmitEvent" | "SubtleCrypto" | "Text" | "TextDecoder" | "TextDecoderStream" | "TextEncoder" | "TextEncoderStream" | "TextEvent" | "TextMetrics" | "TextTrack" | "TextTrackCue" | "TextTrackCueList" | "TextTrackList" | "TimeRanges" | "ToggleEvent" | "Touch" | "TouchEvent" | "TouchList" | "TrackEvent" | "TransformStream" | "TransformStreamDefaultController" | "TransitionEvent" | "TreeWalker" | "UIEvent" | "URL" | "webkitURL" | "URLSearchParams" | "UserActivation" | "VTTCue" | "VTTRegion" | "ValidityState" | "VideoColorSpace" | "VideoDecoder" | "VideoEncoder" | "VideoFrame" | "VideoPlaybackQuality" | "ViewTransition" | "ViewTransitionTypeSet" | "VisualViewport" | "WakeLock" | "WakeLockSentinel" | "WaveShaperNode" | "WebGL2RenderingContext" | "WebGLActiveInfo" | "WebGLBuffer" | "WebGLContextEvent" | "WebGLFramebuffer" | "WebGLProgram" | "WebGLQuery" | "WebGLRenderbuffer" | "WebGLRenderingContext" | "WebGLSampler" | "WebGLShader" | "WebGLShaderPrecisionFormat" | "WebGLSync" | "WebGLTexture" | "WebGLTransformFeedback" | "WebGLUniformLocation" | "WebGLVertexArrayObject" | "WebSocket" | "WebTransport" | "WebTransportBidirectionalStream" | "WebTransportDatagramDuplexStream" | "WebTransportError" | "WheelEvent" | "Window" | "Worker" | "Worklet" | "WritableStream" | "WritableStreamDefaultController" | "WritableStreamDefaultWriter" | "XMLDocument" | "XMLHttpRequest" | "XMLHttpRequestEventTarget" | "XMLHttpRequestUpload" | "XMLSerializer" | "XPathEvaluator" | "XPathExpression" | "XPathResult" | "XSLTProcessor" | "CSS" | "WebAssembly" | "console" | "Audio" | "Image" | "Option" | "clientInformation" | "closed" | "cookieStore" | "customElements" | "devicePixelRatio" | "document" | "event" | "external" | "frameElement" | "frames" | "history" | "innerHeight" | "innerWidth" | "length" | "location" | "locationbar" | "menubar" | "navigator" | "ondevicemotion" | "ondeviceorientation" | "ondeviceorientationabsolute" | "onorientationchange" | "opener" | "orientation" | "originAgentCluster" | "outerHeight" | "outerWidth" | "pageXOffset" | "pageYOffset" | "parent" | "personalbar" | "screen" | "screenLeft" | "screenTop" | "screenX" | "screenY" | "scrollX" | "scrollY" | "scrollbars" | "self" | "speechSynthesis" | "status" | "statusbar" | "toolbar" | "top" | "visualViewport" | "window" | "onabort" | "onanimationcancel" | "onanimationend" | "onanimationiteration" | "onanimationstart" | "onauxclick" | "onbeforeinput" | "onbeforematch" | "onbeforetoggle" | "onblur" | "oncancel" | "oncanplay" | "oncanplaythrough" | "onchange" | "onclick" | "onclose" | "oncontextlost" | "oncontextmenu" | "oncontextrestored" | "oncopy" | "oncuechange" | "oncut" | "ondblclick" | "ondrag" | "ondragend" | "ondragenter" | "ondragleave" | "ondragover" | "ondragstart" | "ondrop" | "ondurationchange" | "onemptied" | "onended" | "onerror" | "onfocus" | "onformdata" | "ongotpointercapture" | "oninput" | "oninvalid" | "onkeydown" | "onkeypress" | "onkeyup" | "onload" | "onloadeddata" | "onloadedmetadata" | "onloadstart" | "onlostpointercapture" | "onmousedown" | "onmouseenter" | "onmouseleave" | "onmousemove" | "onmouseout" | "onmouseover" | "onmouseup" | "onpaste" | "onpause" | "onplay" | "onplaying" | "onpointercancel" | "onpointerdown" | "onpointerenter" | "onpointerleave" | "onpointermove" | "onpointerout" | "onpointerover" | "onpointerrawupdate" | "onpointerup" | "onprogress" | "onratechange" | "onreset" | "onresize" | "onscroll" | "onscrollend" | "onsecuritypolicyviolation" | "onseeked" | "onseeking" | "onselect" | "onselectionchange" | "onselectstart" | "onslotchange" | "onstalled" | "onsubmit" | "onsuspend" | "ontimeupdate" | "ontoggle" | "ontouchcancel" | "ontouchend" | "ontouchmove" | "ontouchstart" | "ontransitioncancel" | "ontransitionend" | "ontransitionrun" | "ontransitionstart" | "onvolumechange" | "onwaiting" | "onwebkitanimationend" | "onwebkitanimationiteration" | "onwebkitanimationstart" | "onwebkittransitionend" | "onwheel" | "onafterprint" | "onbeforeprint" | "onbeforeunload" | "ongamepadconnected" | "ongamepaddisconnected" | "onhashchange" | "onlanguagechange" | "onmessage" | "onmessageerror" | "onoffline" | "ononline" | "onpagehide" | "onpagereveal" | "onpageshow" | "onpageswap" | "onpopstate" | "onrejectionhandled" | "onstorage" | "onunhandledrejection" | "onunload" | "localStorage" | "caches" | "crossOriginIsolated" | "crypto" | "indexedDB" | "isSecureContext" | "origin" | "performance" | "sessionStorage" | "importScripts" | "ActiveXObject" | "WScript" | "WSH" | "Enumerator" | "VBArray" | "Map" | "WeakMap" | "Set" | "WeakSet" | "Iterator" | "Proxy" | "Reflect" | "SharedArrayBuffer" | "Atomics" | "BigInt" | "BigInt64Array" | "BigUint64Array" | "AggregateError" | "WeakRef" | "FinalizationRegistry" | "SuppressedError" | "DisposableStack" | "AsyncDisposableStack" | "Float16Array") | "blob" | "file" | "formdata" | string;
+/**
+ * 判断值是否为原生 Blob（含 File）。
+ *
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Blob}
+ */
+declare function isBlob(obj: any): obj is Blob;
+/**
+ * 判断值是否为**纯粹**的 Object（即 `{}` 或 `new Object()`，不含数组、null、自定义类等）。
+ *
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Record<PropertyKey, any>}
+ */
+declare function isPlainObject(obj: any): obj is Record<PropertyKey, any>;
+/**
+ * 判断值是否为 Promise（含 Promise 子类）。
+ *
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Promise<any>}
+ */
+declare function isPromise(obj: any): obj is Promise<any>;
+/**
+ * 判断值是否为合法 Date 对象（含 Invalid Date 返回 false）。
+ *
+ * @param {*} t - 待检测值
+ * @returns {t is Date}
+ */
+declare function isDate(t: any): t is Date;
+/**
+ * 判断值是否为函数（含异步函数、生成器函数、类）。
+ *
+ * @param {*} obj - 待检测的值
+ * @returns {obj is Function}
+ */
+declare function isFunction(obj: any): obj is Function;
+/**
+ * 判断值是否为**非空**字符串。
+ *
+ * @param {*} obj - 待检测的值
+ * @returns {obj is string}
+ */
+declare function isNonEmptyString(obj: any): obj is string;
+/**
+ * 在闭区间 [min, max] 内生成一个均匀分布的随机整数。
+ * 若 min > max 则自动交换。
+ *
+ * @param {number} min - 整数下界（包含）
+ * @param {number} max - 整数上界（包含）
+ * @returns {number}
+ * @throws {TypeError} 当 min 或 max 不是整数时抛出
+ */
+declare function randomIntInRange(min: number, max: number): number;
+/**
+ * 随机生成一个汉字（可控制范围）。
+ *
+ * @param {boolean} [base=true]  - 是否启用基本区（0x4E00-0x9FA5）
+ * @param {boolean} [extA=false] - 是否启用扩展 A 区（0x3400-0x4DBF）
+ * @param {boolean} [extBH=false] - 是否启用扩展 B~H 区（0x20000-0x2EBEF，代理对）
+ * @returns {string} 单个汉字字符
+ * @throws {RangeError} 未启用任何区段时抛出
+ */
+declare function randomHan(base?: boolean, extA?: boolean, extBH?: boolean): string;
+/**
+ * 随机生成一个英文字母。
+ *
+ * @param {'lower'|'upper'} [type] - 指定大小写；留空则随机
+ * @returns {string} 单个字母
+ */
+declare function randomEnLetter(type?: "lower" | "upper"): string;
+/**
+ * 生成指定长度的随机“中英混合”字符串。
+ *
+ * @param {number} [len=1] - 目标长度（≥1，自动取整）
+ * @param {number} [zhProb=0.5] - 每个位置选择汉字的概率，默认 0.5
+ * @returns {string}
+ */
+declare function randomHanOrEn(len?: number, zhProb?: number): string;
+/**
+ * 创建 debounced（防抖）函数。
+ * - 默认 trailing 触发；当 `leading=true` 时，首次调用或超过等待间隔会立即执行。
+ * - 支持手动取消。
+ *
+ * @template {(...args: any[]) => any} T
+ * @param {T} fn - 要防抖的原始函数
+ * @param {number} wait - 防抖等待时间（毫秒）
+ * @param {boolean} [leading=false] - 是否启用立即执行（leading edge）
+ * @returns {T & { cancel(): void }} 返回经过防抖包装的函数，并附带 `cancel` 方法
+ * @throws {TypeError} 当 `fn` 不是函数时抛出
+ */
+declare function debounce<T extends (...args: any[]) => any>(fn: T, wait: number, leading?: boolean): T & {
+    cancel(): void;
+};
+/**
+ * 创建 throttled（节流）函数。
+ * 支持 leading/trailing 边缘触发，可手动取消。
+ *
+ * @template {(...args: any[]) => any} T
+ * @param {T} fn - 要节流的原始函数
+ * @param {number} wait - 节流间隔（毫秒）
+ * @param {object} [options] - 配置项
+ * @param {boolean} [options.leading=true] - 是否在 leading 边缘执行
+ * @param {boolean} [options.trailing=true] - 是否在 trailing 边缘执行
+ * @returns {T & { cancel(): void }} 返回经过节流包装的函数，并附带 `cancel` 方法
+ * @throws {TypeError} 当 `fn` 不是函数时抛出
+ */
+declare function throttle<T extends (...args: any[]) => any>(fn: T, wait: number, { leading, trailing }?: {
+    leading?: boolean | undefined;
+    trailing?: boolean | undefined;
+}): T & {
+    cancel(): void;
+};
+/**
+ * 利用 JSON 序列化/反序列化实现**深拷贝**。
+ * 注意：会丢失 `undefined`、函数、循环引用、特殊包装对象等。
+ *
+ * @template T
+ * @param {T} obj - 待拷贝的 JSON 兼容值
+ * @returns {T} 深拷贝后的值
+ */
+declare function deepCloneByJSON<T>(obj: T): T;
+/**
+ * **安全**地将源对象中**已存在**的属性赋值到目标对象。
+ * 不会新增键，也不会复制原型链上的属性。
+ *
+ * @template {Record<PropertyKey, any>} T
+ * @param {T} target - 目标对象（将被就地修改）
+ * @param {...Partial<T>} sources - 一个或多个源对象
+ * @returns {T} 修改后的目标对象（即第一个参数本身）
+ *
+ * @example
+ * const defaults = { a: 1, b: 2 };
+ * assignExisting(defaults, { a: 9, c: 99 }); // defaults 变为 { a: 9, b: 2 }
+ */
+declare function assignExisting<T extends Record<PropertyKey, any>>(target: T, ...sources: Partial<T>[]): T;
+/**
+ * 提取任意函数（含箭头函数、普通函数、async、class 构造器）的形参名称列表。
+ * 通过源码正则解析，不支持解构参数、默认参数、剩余参数等复杂语法；
+ * 若出现上述场景将返回空数组或部分名称。
+ *
+ * @param {Function} fn - 目标函数
+ * @returns {string[]} 按声明顺序排列的参数名数组；解析失败时返回空数组
+ *
+ * @example
+ * getFunctionArgNames(function (a, b) {})        // ["a", "b"]
+ * getFunctionArgNames((foo, bar) => {})          // ["foo", "bar"]
+ * getFunctionArgNames(async function x({a} = {}) {}) // [] （解构无法识别）
+ */
+declare function getFunctionArgNames(fn: Function): string[];
+/**
+ * 将 Blob（或 File）读取为文本，并可选择自动执行 `JSON.parse`。
+ * 当 `isParse=true` 且内容非法 JSON 时，会回退为返回原始文本。
+ *
+ * @param {Blob} blob - 待读取的 Blob/File 对象
+ * @param {boolean} [isParse=true] - 是否尝试将结果按 JSON 解析
+ * @returns {Promise<string | any>} 解析后的 JSON 对象或原始文本
+ *
+ * @example
+ * const json = await readBlobAsText(blob);        // 自动 JSON.parse
+ * const text = await readBlobAsText(blob, false); // 仅返回文本
+ */
+declare function readBlobAsText(blob: Blob, isParse?: boolean): Promise<string | any>;
+
+export { assignExisting, debounce, deepCloneByJSON, getDataType, getFunctionArgNames, isBlob, isDate, isFunction, isNonEmptyString, isPlainObject, isPromise, randomEnLetter, randomHan, randomHanOrEn, randomIntInRange, readBlobAsText, throttle };

package/types/date.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 将任意值安全转换为 Date 对象。
+ * - 数字／数字字符串：视为时间戳
+ * - 字符串：尝试按 ISO/RFC 格式解析
+ * - 对象：优先 valueOf()，再 toString()
+ * - null / undefined / 无效值：返回 null
+ *
+ * @param {*} val - 待转换值
+ * @returns {Date | null} 有效 Date 或 null
+ */
+declare function toDate(val: any): Date | null;
+/**
+ * 在闭区间 [date1, date2] 内随机生成一个日期（含首尾）。
+ * 若顺序相反则自动交换。
+ *
+ * @param {Date} date1 - 起始日期
+ * @param {Date} date2 - 结束日期
+ * @returns {Date} 随机日期
+ */
+declare function randomDateInRange(date1: Date, date2: Date): Date;
+/**
+ * 计算两个时间之间的剩余/已过时长（天-时-分-秒），返回带补零的展示对象。
+ *
+ * @param {string|number|Date} originalTime - 原始时间（可转 Date 的任意值）
+ * @param {Date} [currentTime=new Date()] - 基准时间，默认当前
+ * @returns {{days:number,hours:string,minutes:string,seconds:string}}
+ */
+declare function calcTimeDifference(originalTime: string | number | Date, currentTime?: Date): {
+    days: number;
+    hours: string;
+    minutes: string;
+    seconds: string;
+};
+/**
+ * 将总秒数格式化成人类可读的时间段文本。
+ * 固定进制：1 年=365 天，1 月=30 天。
+ *
+ * @param {number} totalSeconds - 非负总秒数
+ * @param {object} [options] - 格式化选项
+ * @param {Partial<{year:string,month:string,day:string,hour:string,minute:string,second:string}>} [options.labels] - 各单位的自定义文本
+ * @param {('year'|'month'|'day'|'hour'|'minute'|'second')} [options.maxUnit] - 最大输出单位
+ * @param {('year'|'month'|'day'|'hour'|'minute'|'second')} [options.minUnit] - 最小输出单位
+ * @param {boolean} [options.showZero] - 是否强制显示 0 秒
+ * @returns {string} 拼接后的时长文本，如“1天 02小时 30分钟”
+ * @throws {TypeError} 当 totalSeconds 为非数字或负数时抛出
+ */
+declare function formatDuration(totalSeconds: number, options?: {
+    labels?: Partial<{
+        year: string;
+        month: string;
+        day: string;
+        hour: string;
+        minute: string;
+        second: string;
+    }> | undefined;
+    maxUnit?: "year" | "month" | "day" | "hour" | "minute" | "second" | undefined;
+    minUnit?: "year" | "month" | "day" | "hour" | "minute" | "second" | undefined;
+    showZero?: boolean | undefined;
+}): string;
+/**
+ * 快捷调用 {@link formatDuration}，最大单位到“天”。
+ *
+ * @param {number} totalSeconds
+ * @param {Omit<Parameters<typeof formatDuration>[1],'maxUnit'>} [options]
+ * @returns {string}
+ */
+declare function formatDurationMaxDay(totalSeconds: number, options?: Omit<Parameters<typeof formatDuration>[1], "maxUnit">): string;
+/**
+ * 快捷调用 {@link formatDuration}，最大单位到“小时”。
+ *
+ * @param {number} totalSeconds
+ * @param {Omit<Parameters<typeof formatDuration>[1],'maxUnit'>} [options]
+ * @returns {string}
+ */
+declare function formatDurationMaxHour(totalSeconds: number, options?: Omit<Parameters<typeof formatDuration>[1], "maxUnit">): string;
+
+export { calcTimeDifference, formatDuration, formatDurationMaxDay, formatDurationMaxHour, randomDateInRange, toDate };