@fast-china/utils 2.1.3 → 2.1.5

package/dist/env/index.d.mts

@@ -1,12 +1,12 @@
 //#region src/env/index.d.ts
 /** 可识别的主要 JavaScript 运行环境。 */
-type RuntimeKind = "browser" | "node" | "unknown" | "worker";
+export type RuntimeKind = "browser" | "node" | "unknown" | "worker";
 /**
  * 判断当前运行时是否具有浏览器 `window` 与 `document`。
  *
  * @returns 两项能力均存在时返回 `true`；不读取 DOM 内容。
  */
-declare function isBrowser(): boolean;
+export declare function isBrowser(): boolean;
 /**
  * 判断当前运行时是否像 Web Worker 且不是 Window。
  *
@@ -14,19 +14,19 @@ declare function isBrowser(): boolean;
  * Worker 中调用它可能抛错，本检测只检查能力存在，不会执行。
  * @returns 具有 `importScripts` 且不是浏览器 Window 时返回 `true`。
  */
-declare function isWebWorker(): boolean;
+export declare function isWebWorker(): boolean;
 /**
  * 判断当前运行时是否暴露 Node.js 版本标记。
  *
  * @returns `process.versions.node` 为字符串时返回 `true`。
  */
-declare function isNode(): boolean;
+export declare function isNode(): boolean;
 /**
  * 判断当前运行时是否暴露 uni-app 的 `uni` 全局对象。
  *
  * @returns 全局属性存在且不为 `undefined` 时返回 `true`；不调用任何平台 API。
  */
-declare function isUniApp(): boolean;
+export declare function isUniApp(): boolean;
 /**
  * 判断当前运行时是否具备本库完整加密 API 所需的 Web Crypto 能力。
  *
@@ -34,14 +34,14 @@ declare function isUniApp(): boolean;
  * 仍会返回 `false`，因为摘要、PBKDF2、AES-GCM、RSA 与 ECC 需要完整的 Web Crypto 能力。
  * @returns 同时提供本库 Web Crypto 功能所需方法时返回 `true`。
  */
-declare function hasWebCrypto(): boolean;
+export declare function hasWebCrypto(): boolean;
 /**
  * 返回当前主要运行环境。
  *
  * @remarks 在使用 DOM 模拟器的 Node.js 进程中优先报告 `browser`，因为可观察能力比宿主进程名称更有用。
  * @returns `browser`、`worker`、`node` 或无法识别时的 `unknown`。
  */
-declare function detectRuntime(): RuntimeKind;
+export declare function detectRuntime(): RuntimeKind;
 /**
  * 基于 User-Agent 启发式判断手机设备。
  *
@@ -49,7 +49,7 @@ declare function detectRuntime(): RuntimeKind;
  * @remarks User-Agent 可以被伪造，不得用于鉴权、安全策略或永久功能分流。
  * @returns 命中手机特征时返回 `true`。
  */
-declare function isMobileUserAgent(userAgent?: string): boolean;
+export declare function isMobileUserAgent(userAgent?: string): boolean;
 /**
  * 基于 User-Agent 与触点数量启发式判断平板设备。
  *
@@ -57,7 +57,6 @@ declare function isMobileUserAgent(userAgent?: string): boolean;
  * @param maxTouchPoints - 用于识别桌面 User-Agent 模式下的 iPadOS，默认读取当前触点数。
  * @returns 命中平板特征时返回 `true`。
  */
-declare function isTabletUserAgent(userAgent?: string, maxTouchPoints?: number): boolean;
+export declare function isTabletUserAgent(userAgent?: string, maxTouchPoints?: number): boolean;
 //#endregion
-export { RuntimeKind, detectRuntime, hasWebCrypto, isBrowser, isMobileUserAgent, isNode, isTabletUserAgent, isUniApp, isWebWorker };
 //# sourceMappingURL=index.d.mts.map

package/dist/env/index.mjs

@@ -1,24 +1,30 @@
+import { runtimeGlobals } from "../internal/runtime.mjs";
 //#region src/env/index.ts
 /**
 * 延迟读取当前 User-Agent。
 *
 * @returns Navigator 不存在或字段类型异常时返回空字符串。
 */
-const currentUserAgent = () => typeof globalThis.navigator?.userAgent === "string" ? globalThis.navigator.userAgent : "";
+const currentUserAgent = () => {
+	const userAgent = runtimeGlobals.navigator?.userAgent;
+	return typeof userAgent === "string" ? userAgent : "";
+};
 /**
 * 延迟读取当前设备报告的最大触点数。
 *
 * @returns Navigator 不存在或字段类型异常时返回 `0`。
 */
-const currentTouchPoints = () => typeof globalThis.navigator?.maxTouchPoints === "number" ? globalThis.navigator.maxTouchPoints : 0;
+const currentTouchPoints = () => {
+	const maxTouchPoints = runtimeGlobals.navigator?.maxTouchPoints;
+	return typeof maxTouchPoints === "number" ? maxTouchPoints : 0;
+};
 /**
 * 判断当前运行时是否具有浏览器 `window` 与 `document`。
 *
 * @returns 两项能力均存在时返回 `true`；不读取 DOM 内容。
 */
 function isBrowser() {
-	const window = globalThis.window;
-	return window !== void 0 && window !== null && window.document !== null && typeof window.document === "object";
+	return runtimeGlobals.window?.document !== void 0;
 }
 /**
 * 判断当前运行时是否像 Web Worker 且不是 Window。
@@ -28,7 +34,7 @@ function isBrowser() {
 * @returns 具有 `importScripts` 且不是浏览器 Window 时返回 `true`。
 */
 function isWebWorker() {
-	return !isBrowser() && typeof Reflect.get(globalThis, "importScripts") === "function";
+	return !isBrowser() && typeof runtimeGlobals.importScripts === "function";
 }
 /**
 * 判断当前运行时是否暴露 Node.js 版本标记。
@@ -36,10 +42,11 @@ function isWebWorker() {
 * @returns `process.versions.node` 为字符串时返回 `true`。
 */
 function isNode() {
-	const process = Reflect.get(globalThis, "process");
+	const process = runtimeGlobals.process;
 	if (typeof process !== "object" && typeof process !== "function" || process === null) return false;
-	const versions = Reflect.get(process, "versions");
-	return (typeof versions === "object" || typeof versions === "function") && versions !== null && typeof Reflect.get(versions, "node") === "string";
+	const versions = process.versions;
+	if (typeof versions !== "object" && typeof versions !== "function" || versions === null) return false;
+	return typeof versions.node === "string";
 }
 /**
 * 判断当前运行时是否暴露 uni-app 的 `uni` 全局对象。
@@ -47,7 +54,7 @@ function isNode() {
 * @returns 全局属性存在且不为 `undefined` 时返回 `true`；不调用任何平台 API。
 */
 function isUniApp() {
-	return Reflect.get(globalThis, "uni") !== void 0;
+	return runtimeGlobals.uni !== void 0;
 }
 /**
 * 判断当前运行时是否具备本库完整加密 API 所需的 Web Crypto 能力。
@@ -57,7 +64,7 @@ function isUniApp() {
 * @returns 同时提供本库 Web Crypto 功能所需方法时返回 `true`。
 */
 function hasWebCrypto() {
-	const crypto = globalThis.crypto;
+	const crypto = runtimeGlobals.crypto;
 	const subtle = crypto?.subtle;
 	return typeof crypto?.getRandomValues === "function" && typeof subtle?.decrypt === "function" && typeof subtle.deriveBits === "function" && typeof subtle.deriveKey === "function" && typeof subtle.digest === "function" && typeof subtle.encrypt === "function" && typeof subtle.exportKey === "function" && typeof subtle.generateKey === "function" && typeof subtle.importKey === "function" && typeof subtle.sign === "function" && typeof subtle.verify === "function";
 }

package/dist/env/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/env/index.ts"],"sourcesContent":["/** 可识别的主要 JavaScript 运行环境。 */\nexport type RuntimeKind = \"browser\" | \"node\" | \"unknown\" | \"worker\";\n\n/**\n * 延迟读取当前 User-Agent。\n *\n * @returns Navigator 不存在或字段类型异常时返回空字符串。\n */\nconst currentUserAgent = (): string => (typeof globalThis.navigator?.userAgent === \"string\" ? globalThis.navigator.userAgent : \"\");\n/**\n * 延迟读取当前设备报告的最大触点数。\n *\n * @returns Navigator 不存在或字段类型异常时返回 `0`。\n */\nconst currentTouchPoints = (): number => (typeof globalThis.navigator?.maxTouchPoints === \"number\" ? globalThis.navigator.maxTouchPoints : 0);\n\n/**\n * 判断当前运行时是否具有浏览器 `window` 与 `document`。\n *\n * @returns 两项能力均存在时返回 `true`；不读取 DOM 内容。\n */\nexport function isBrowser(): boolean {\n\tconst window = globalThis.window;\n\treturn window !== undefined && window !== null && window.document !== null && typeof window.document === \"object\";\n}\n\n/**\n * 判断当前运行时是否像 Web Worker 且不是 Window。\n *\n * @remarks 经典、模块、Shared 与 Service Worker 全局通常都暴露 `importScripts`；模块\n * Worker 中调用它可能抛错，本检测只检查能力存在，不会执行。\n * @returns 具有 `importScripts` 且不是浏览器 Window 时返回 `true`。\n */\nexport function isWebWorker(): boolean {\n\treturn !isBrowser() && typeof Reflect.get(globalThis, \"importScripts\") === \"function\";\n}\n\n/**\n * 判断当前运行时是否暴露 Node.js 版本标记。\n *\n * @returns `process.versions.node` 为字符串时返回 `true`。\n */\nexport function isNode(): boolean {\n\tconst process: unknown = Reflect.get(globalThis, \"process\");\n\tif ((typeof process !== \"object\" && typeof process !== \"function\") || process === null) return false;\n\tconst versions: unknown = Reflect.get(process, \"versions\");\n\treturn (typeof versions === \"object\" || typeof versions === \"function\") && versions !== null && typeof Reflect.get(versions, \"node\") === \"string\";\n}\n\n/**\n * 判断当前运行时是否暴露 uni-app 的 `uni` 全局对象。\n *\n * @returns 全局属性存在且不为 `undefined` 时返回 `true`；不调用任何平台 API。\n */\nexport function isUniApp(): boolean {\n\treturn Reflect.get(globalThis, \"uni\") !== undefined;\n}\n\n/**\n * 判断当前运行时是否具备本库完整加密 API 所需的 Web Crypto 能力。\n *\n * @remarks 普通随机数、随机字符串和 UUID 在缺少 Web Crypto 时可以回退到 `Math.random()`，但本函数\n * 仍会返回 `false`，因为摘要、PBKDF2、AES-GCM、RSA 与 ECC 需要完整的 Web Crypto 能力。\n * @returns 同时提供本库 Web Crypto 功能所需方法时返回 `true`。\n */\nexport function hasWebCrypto(): boolean {\n\tconst crypto = globalThis.crypto;\n\tconst subtle = crypto?.subtle;\n\treturn (\n\t\ttypeof crypto?.getRandomValues === \"function\" &&\n\t\ttypeof subtle?.decrypt === \"function\" &&\n\t\ttypeof subtle.deriveBits === \"function\" &&\n\t\ttypeof subtle.deriveKey === \"function\" &&\n\t\ttypeof subtle.digest === \"function\" &&\n\t\ttypeof subtle.encrypt === \"function\" &&\n\t\ttypeof subtle.exportKey === \"function\" &&\n\t\ttypeof subtle.generateKey === \"function\" &&\n\t\ttypeof subtle.importKey === \"function\" &&\n\t\ttypeof subtle.sign === \"function\" &&\n\t\ttypeof subtle.verify === \"function\"\n\t);\n}\n\n/**\n * 返回当前主要运行环境。\n *\n * @remarks 在使用 DOM 模拟器的 Node.js 进程中优先报告 `browser`，因为可观察能力比宿主进程名称更有用。\n * @returns `browser`、`worker`、`node` 或无法识别时的 `unknown`。\n */\nexport function detectRuntime(): RuntimeKind {\n\tif (isBrowser()) return \"browser\";\n\tif (isWebWorker()) return \"worker\";\n\tif (isNode()) return \"node\";\n\treturn \"unknown\";\n}\n\n/**\n * 基于 User-Agent 启发式判断手机设备。\n *\n * @param userAgent - 默认读取当前 `navigator.userAgent`；平台对象不存在时使用空字符串。\n * @remarks User-Agent 可以被伪造，不得用于鉴权、安全策略或永久功能分流。\n * @returns 命中手机特征时返回 `true`。\n */\nexport function isMobileUserAgent(userAgent: string = currentUserAgent()): boolean {\n\treturn /Mobile|iPhone|Android.*Mobile|Windows Phone/iu.test(userAgent);\n}\n\n/**\n * 基于 User-Agent 与触点数量启发式判断平板设备。\n *\n * @param userAgent - 默认读取当前 User-Agent。\n * @param maxTouchPoints - 用于识别桌面 User-Agent 模式下的 iPadOS，默认读取当前触点数。\n * @returns 命中平板特征时返回 `true`。\n */\nexport function isTabletUserAgent(userAgent: string = currentUserAgent(), maxTouchPoints: number = currentTouchPoints()): boolean {\n\treturn /iPad|Android(?!.*Mobile)|Tablet/iu.test(userAgent) || (/Macintosh/iu.test(userAgent) && maxTouchPoints > 1);\n}\n"],"mappings":";;;;;;AAQA,MAAM,yBAAkC,OAAO,WAAW,WAAW,cAAc,WAAW,WAAW,UAAU,YAAY;;;;;;AAM/H,MAAM,2BAAoC,OAAO,WAAW,WAAW,mBAAmB,WAAW,WAAW,UAAU,iBAAiB;;;;;;AAO3I,SAAgB,YAAqB;CACpC,MAAM,SAAS,WAAW;CAC1B,OAAO,WAAW,KAAA,KAAa,WAAW,QAAQ,OAAO,aAAa,QAAQ,OAAO,OAAO,aAAa;AAC1G;;;;;;;;AASA,SAAgB,cAAuB;CACtC,OAAO,CAAC,UAAU,KAAK,OAAO,QAAQ,IAAI,YAAY,eAAe,MAAM;AAC5E;;;;;;AAOA,SAAgB,SAAkB;CACjC,MAAM,UAAmB,QAAQ,IAAI,YAAY,SAAS;CAC1D,IAAK,OAAO,YAAY,YAAY,OAAO,YAAY,cAAe,YAAY,MAAM,OAAO;CAC/F,MAAM,WAAoB,QAAQ,IAAI,SAAS,UAAU;CACzD,QAAQ,OAAO,aAAa,YAAY,OAAO,aAAa,eAAe,aAAa,QAAQ,OAAO,QAAQ,IAAI,UAAU,MAAM,MAAM;AAC1I;;;;;;AAOA,SAAgB,WAAoB;CACnC,OAAO,QAAQ,IAAI,YAAY,KAAK,MAAM,KAAA;AAC3C;;;;;;;;AASA,SAAgB,eAAwB;CACvC,MAAM,SAAS,WAAW;CAC1B,MAAM,SAAS,QAAQ;CACvB,OACC,OAAO,QAAQ,oBAAoB,cACnC,OAAO,QAAQ,YAAY,cAC3B,OAAO,OAAO,eAAe,cAC7B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,WAAW,cACzB,OAAO,OAAO,YAAY,cAC1B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,gBAAgB,cAC9B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,SAAS,cACvB,OAAO,OAAO,WAAW;AAE3B;;;;;;;AAQA,SAAgB,gBAA6B;CAC5C,IAAI,UAAU,GAAG,OAAO;CACxB,IAAI,YAAY,GAAG,OAAO;CAC1B,IAAI,OAAO,GAAG,OAAO;CACrB,OAAO;AACR;;;;;;;;AASA,SAAgB,kBAAkB,YAAoB,iBAAiB,GAAY;CAClF,OAAO,gDAAgD,KAAK,SAAS;AACtE;;;;;;;;AASA,SAAgB,kBAAkB,YAAoB,iBAAiB,GAAG,iBAAyB,mBAAmB,GAAY;CACjI,OAAO,oCAAoC,KAAK,SAAS,KAAM,cAAc,KAAK,SAAS,KAAK,iBAAiB;AAClH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/env/index.ts"],"sourcesContent":["import { runtimeGlobals } from \"../internal/runtime\";\n\n/** 可识别的主要 JavaScript 运行环境。 */\nexport type RuntimeKind = \"browser\" | \"node\" | \"unknown\" | \"worker\";\n\n/**\n * 延迟读取当前 User-Agent。\n *\n * @returns Navigator 不存在或字段类型异常时返回空字符串。\n */\nconst currentUserAgent = (): string => {\n\tconst userAgent: unknown = runtimeGlobals.navigator?.userAgent;\n\treturn typeof userAgent === \"string\" ? userAgent : \"\";\n};\n/**\n * 延迟读取当前设备报告的最大触点数。\n *\n * @returns Navigator 不存在或字段类型异常时返回 `0`。\n */\nconst currentTouchPoints = (): number => {\n\tconst maxTouchPoints: unknown = runtimeGlobals.navigator?.maxTouchPoints;\n\treturn typeof maxTouchPoints === \"number\" ? maxTouchPoints : 0;\n};\n\n/**\n * 判断当前运行时是否具有浏览器 `window` 与 `document`。\n *\n * @returns 两项能力均存在时返回 `true`；不读取 DOM 内容。\n */\nexport function isBrowser(): boolean {\n\treturn runtimeGlobals.window?.document !== undefined;\n}\n\n/**\n * 判断当前运行时是否像 Web Worker 且不是 Window。\n *\n * @remarks 经典、模块、Shared 与 Service Worker 全局通常都暴露 `importScripts`；模块\n * Worker 中调用它可能抛错，本检测只检查能力存在，不会执行。\n * @returns 具有 `importScripts` 且不是浏览器 Window 时返回 `true`。\n */\nexport function isWebWorker(): boolean {\n\treturn !isBrowser() && typeof runtimeGlobals.importScripts === \"function\";\n}\n\n/**\n * 判断当前运行时是否暴露 Node.js 版本标记。\n *\n * @returns `process.versions.node` 为字符串时返回 `true`。\n */\nexport function isNode(): boolean {\n\tconst process = runtimeGlobals.process;\n\tif ((typeof process !== \"object\" && typeof process !== \"function\") || process === null) return false;\n\tconst versions: unknown = (process as { versions?: unknown }).versions;\n\tif ((typeof versions !== \"object\" && typeof versions !== \"function\") || versions === null) return false;\n\treturn typeof (versions as { node?: unknown }).node === \"string\";\n}\n\n/**\n * 判断当前运行时是否暴露 uni-app 的 `uni` 全局对象。\n *\n * @returns 全局属性存在且不为 `undefined` 时返回 `true`；不调用任何平台 API。\n */\nexport function isUniApp(): boolean {\n\treturn runtimeGlobals.uni !== undefined;\n}\n\n/**\n * 判断当前运行时是否具备本库完整加密 API 所需的 Web Crypto 能力。\n *\n * @remarks 普通随机数、随机字符串和 UUID 在缺少 Web Crypto 时可以回退到 `Math.random()`，但本函数\n * 仍会返回 `false`，因为摘要、PBKDF2、AES-GCM、RSA 与 ECC 需要完整的 Web Crypto 能力。\n * @returns 同时提供本库 Web Crypto 功能所需方法时返回 `true`。\n */\nexport function hasWebCrypto(): boolean {\n\tconst crypto = runtimeGlobals.crypto;\n\tconst subtle = crypto?.subtle;\n\treturn (\n\t\ttypeof crypto?.getRandomValues === \"function\" &&\n\t\ttypeof subtle?.decrypt === \"function\" &&\n\t\ttypeof subtle.deriveBits === \"function\" &&\n\t\ttypeof subtle.deriveKey === \"function\" &&\n\t\ttypeof subtle.digest === \"function\" &&\n\t\ttypeof subtle.encrypt === \"function\" &&\n\t\ttypeof subtle.exportKey === \"function\" &&\n\t\ttypeof subtle.generateKey === \"function\" &&\n\t\ttypeof subtle.importKey === \"function\" &&\n\t\ttypeof subtle.sign === \"function\" &&\n\t\ttypeof subtle.verify === \"function\"\n\t);\n}\n\n/**\n * 返回当前主要运行环境。\n *\n * @remarks 在使用 DOM 模拟器的 Node.js 进程中优先报告 `browser`，因为可观察能力比宿主进程名称更有用。\n * @returns `browser`、`worker`、`node` 或无法识别时的 `unknown`。\n */\nexport function detectRuntime(): RuntimeKind {\n\tif (isBrowser()) return \"browser\";\n\tif (isWebWorker()) return \"worker\";\n\tif (isNode()) return \"node\";\n\treturn \"unknown\";\n}\n\n/**\n * 基于 User-Agent 启发式判断手机设备。\n *\n * @param userAgent - 默认读取当前 `navigator.userAgent`；平台对象不存在时使用空字符串。\n * @remarks User-Agent 可以被伪造，不得用于鉴权、安全策略或永久功能分流。\n * @returns 命中手机特征时返回 `true`。\n */\nexport function isMobileUserAgent(userAgent: string = currentUserAgent()): boolean {\n\treturn /Mobile|iPhone|Android.*Mobile|Windows Phone/iu.test(userAgent);\n}\n\n/**\n * 基于 User-Agent 与触点数量启发式判断平板设备。\n *\n * @param userAgent - 默认读取当前 User-Agent。\n * @param maxTouchPoints - 用于识别桌面 User-Agent 模式下的 iPadOS，默认读取当前触点数。\n * @returns 命中平板特征时返回 `true`。\n */\nexport function isTabletUserAgent(userAgent: string = currentUserAgent(), maxTouchPoints: number = currentTouchPoints()): boolean {\n\treturn /iPad|Android(?!.*Mobile)|Tablet/iu.test(userAgent) || (/Macintosh/iu.test(userAgent) && maxTouchPoints > 1);\n}\n"],"mappings":";;;;;;;AAUA,MAAM,yBAAiC;CACtC,MAAM,YAAqB,eAAe,WAAW;CACrD,OAAO,OAAO,cAAc,WAAW,YAAY;AACpD;;;;;;AAMA,MAAM,2BAAmC;CACxC,MAAM,iBAA0B,eAAe,WAAW;CAC1D,OAAO,OAAO,mBAAmB,WAAW,iBAAiB;AAC9D;;;;;;AAOA,SAAgB,YAAqB;CACpC,OAAO,eAAe,QAAQ,aAAa,KAAA;AAC5C;;;;;;;;AASA,SAAgB,cAAuB;CACtC,OAAO,CAAC,UAAU,KAAK,OAAO,eAAe,kBAAkB;AAChE;;;;;;AAOA,SAAgB,SAAkB;CACjC,MAAM,UAAU,eAAe;CAC/B,IAAK,OAAO,YAAY,YAAY,OAAO,YAAY,cAAe,YAAY,MAAM,OAAO;CAC/F,MAAM,WAAqB,QAAmC;CAC9D,IAAK,OAAO,aAAa,YAAY,OAAO,aAAa,cAAe,aAAa,MAAM,OAAO;CAClG,OAAO,OAAQ,SAAgC,SAAS;AACzD;;;;;;AAOA,SAAgB,WAAoB;CACnC,OAAO,eAAe,QAAQ,KAAA;AAC/B;;;;;;;;AASA,SAAgB,eAAwB;CACvC,MAAM,SAAS,eAAe;CAC9B,MAAM,SAAS,QAAQ;CACvB,OACC,OAAO,QAAQ,oBAAoB,cACnC,OAAO,QAAQ,YAAY,cAC3B,OAAO,OAAO,eAAe,cAC7B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,WAAW,cACzB,OAAO,OAAO,YAAY,cAC1B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,gBAAgB,cAC9B,OAAO,OAAO,cAAc,cAC5B,OAAO,OAAO,SAAS,cACvB,OAAO,OAAO,WAAW;AAE3B;;;;;;;AAQA,SAAgB,gBAA6B;CAC5C,IAAI,UAAU,GAAG,OAAO;CACxB,IAAI,YAAY,GAAG,OAAO;CAC1B,IAAI,OAAO,GAAG,OAAO;CACrB,OAAO;AACR;;;;;;;;AASA,SAAgB,kBAAkB,YAAoB,iBAAiB,GAAY;CAClF,OAAO,gDAAgD,KAAK,SAAS;AACtE;;;;;;;;AASA,SAAgB,kBAAkB,YAAoB,iBAAiB,GAAG,iBAAyB,mBAAmB,GAAY;CACjI,OAAO,oCAAoC,KAAK,SAAS,KAAM,cAAc,KAAK,SAAS,KAAK,iBAAiB;AAClH"}

package/dist/function/index.d.mts

@@ -0,0 +1,13 @@
+//#region src/function/index.d.ts
+/**
+ * 创建最多执行一次并缓存首次结果的函数。
+ *
+ * @remarks 首次成功返回后，后续调用返回同一结果；Promise 会保持引用不变。首次同步抛错时缓存错误，后续调用重新抛出同一错误。
+ * 包装函数使用首次调用时的参数和 `this`，之后传入的参数不会再次执行原函数。
+ * @param callback - 只允许执行一次的函数。
+ * @returns 保持原参数与返回类型的包装函数。
+ * @throws `TypeError` 当 `callback` 不是函数。
+ */
+export declare function once<This, Arguments extends unknown[], Result>(callback: (this: This, ...arguments_: Arguments) => Result): (this: This, ...arguments_: Arguments) => Result;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/function/index.mjs

@@ -0,0 +1,38 @@
+//#region src/function/index.ts
+/**
+* 创建最多执行一次并缓存首次结果的函数。
+*
+* @remarks 首次成功返回后，后续调用返回同一结果；Promise 会保持引用不变。首次同步抛错时缓存错误，后续调用重新抛出同一错误。
+* 包装函数使用首次调用时的参数和 `this`，之后传入的参数不会再次执行原函数。
+* @param callback - 只允许执行一次的函数。
+* @returns 保持原参数与返回类型的包装函数。
+* @throws `TypeError` 当 `callback` 不是函数。
+*/
+function once(callback) {
+	if (typeof callback !== "function") throw new TypeError("`callback` 必须是函数。");
+	let state = { status: "pending" };
+	return function(...arguments_) {
+		switch (state.status) {
+			case "returned": return state.value;
+			case "threw": throw state.error;
+			case "pending": try {
+				const value = callback.apply(this, arguments_);
+				state = {
+					status: "returned",
+					value
+				};
+				return value;
+			} catch (error) {
+				state = {
+					error,
+					status: "threw"
+				};
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+export { once };
+
+//# sourceMappingURL=index.mjs.map

package/dist/function/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/function/index.ts"],"sourcesContent":["/** 函数首次调用前的内部状态。 */\ninterface PendingOnceState {\n\treadonly status: \"pending\";\n}\n\n/** 函数成功返回后的内部状态。 */\ninterface ReturnedOnceState<Result> {\n\treadonly status: \"returned\";\n\treadonly value: Result;\n}\n\n/** 函数同步抛错后的内部状态。 */\ninterface ThrewOnceState {\n\treadonly error: unknown;\n\treadonly status: \"threw\";\n}\n\ntype OnceState<Result> = PendingOnceState | ReturnedOnceState<Result> | ThrewOnceState;\n\n/**\n * 创建最多执行一次并缓存首次结果的函数。\n *\n * @remarks 首次成功返回后，后续调用返回同一结果；Promise 会保持引用不变。首次同步抛错时缓存错误，后续调用重新抛出同一错误。\n * 包装函数使用首次调用时的参数和 `this`，之后传入的参数不会再次执行原函数。\n * @param callback - 只允许执行一次的函数。\n * @returns 保持原参数与返回类型的包装函数。\n * @throws `TypeError` 当 `callback` 不是函数。\n */\nexport function once<This, Arguments extends unknown[], Result>(\n\tcallback: (this: This, ...arguments_: Arguments) => Result\n): (this: This, ...arguments_: Arguments) => Result {\n\tif (typeof callback !== \"function\") throw new TypeError(\"`callback` 必须是函数。\");\n\tlet state: OnceState<Result> = { status: \"pending\" };\n\treturn function (this: This, ...arguments_: Arguments): Result {\n\t\tswitch (state.status) {\n\t\t\tcase \"returned\":\n\t\t\t\treturn state.value;\n\t\t\tcase \"threw\":\n\t\t\t\tthrow state.error;\n\t\t\tcase \"pending\":\n\t\t\t\ttry {\n\t\t\t\t\tconst value = callback.apply(this, arguments_);\n\t\t\t\t\tstate = { status: \"returned\", value };\n\t\t\t\t\treturn value;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tstate = { error, status: \"threw\" };\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t}\n\t};\n}\n"],"mappings":";;;;;;;;;;AA4BA,SAAgB,KACf,UACmD;CACnD,IAAI,OAAO,aAAa,YAAY,MAAM,IAAI,UAAU,mBAAmB;CAC3E,IAAI,QAA2B,EAAE,QAAQ,UAAU;CACnD,OAAO,SAAsB,GAAG,YAA+B;EAC9D,QAAQ,MAAM,QAAd;GACC,KAAK,YACJ,OAAO,MAAM;GACd,KAAK,SACJ,MAAM,MAAM;GACb,KAAK,WACJ,IAAI;IACH,MAAM,QAAQ,SAAS,MAAM,MAAM,UAAU;IAC7C,QAAQ;KAAE,QAAQ;KAAY;IAAM;IACpC,OAAO;GACR,SAAS,OAAO;IACf,QAAQ;KAAE;KAAO,QAAQ;IAAQ;IACjC,MAAM;GACP;EACF;CACD;AACD"}

package/dist/identity/index.d.mts

@@ -1,6 +1,6 @@
 //#region src/identity/index.d.ts
 /** {@link configureInstallationIdentity} 接收的安装标识配置。 */
-interface InstallationIdentityConfiguration {
+export interface InstallationIdentityConfiguration {
   /**
    * `Local` 中使用的业务键，默认 `identity:installation-id`。
    *
@@ -9,7 +9,7 @@ interface InstallationIdentityConfiguration {
   cacheKey?: string;
 }
 /** 浏览器或 uni-app 当前安装实例标识。 */
-interface InstallationIdentity {
+export interface InstallationIdentity {
   /**
    * `Local` 中使用的业务键。
    *
@@ -56,14 +56,14 @@ interface InstallationIdentity {
  * @throws `TypeError` 当 `cacheKey` 不是非空字符串或包含外围空白。
  * @throws `Error` 当安装标识已经使用另一个业务键初始化。
  */
-declare function configureInstallationIdentity(options?: InstallationIdentityConfiguration): void;
+export declare function configureInstallationIdentity(options?: InstallationIdentityConfiguration): void;
 /**
  * 全局安装标识状态。
  *
  * @remarks Storage 未显式配置时会使用其默认值。生成 UUID 时优先使用 Web Crypto，能力缺失时
  * 回退到 `Math.random()`。该值不是硬件标识、认证凭证或安全边界。
  */
-declare const installationIdentity: InstallationIdentity;
+export declare const installationIdentity: InstallationIdentity;
 /**
  * 返回已有安装标识，否则创建并持久化一个 UUID v4。
  *
@@ -72,7 +72,6 @@ declare const installationIdentity: InstallationIdentity;
  * @throws `TypeError` 当显式值或持久化值不是 UUID v4。
  * @throws `Error` 当当前平台存储不可用。
  */
-declare function getOrCreateInstallationId(installationId?: string): string;
+export declare function getOrCreateInstallationId(installationId?: string): string;
 //#endregion
-export { InstallationIdentity, InstallationIdentityConfiguration, configureInstallationIdentity, getOrCreateInstallationId, installationIdentity };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { KeySelector, allEqualBy, chunk, difference, groupBy, hasDuplicatesBy, intersection, partition, removeNullishValues, unique, uniqueBy } from "./array/index.mjs";
+import { KeySelector, allEqualBy, chunk, difference, groupBy, hasDuplicatesBy, intersection, partition, removeNullishValues, symmetricDifference, unique, uniqueBy } from "./array/index.mjs";
 import { AbortOptions, ConcurrentMapOptions, DebouncedFunction, RetryContext, RetryOptions, ThrottledFunction, TimeoutOptions, debounce, mapConcurrent, retry, sleep, throttle, withTimeout } from "./async/index.mjs";
 import { DecodedText } from "./internal/text.mjs";
 import { decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64 } from "./base64/index.mjs";
@@ -7,10 +7,11 @@ import { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt
 import { DateInput, DateRangeShortcut, DateShortcut, RelativeTimeOptions, addDays, addMonths, addYears, createDateRangeShortcuts, createDateShortcuts, createOneMonthRangeFromToday, endOfDay, formatChineseRelativeTime, formatRelativeTime, getLocalDayBounds, getLocalTimeGreeting, getStartOfToday, isDateAfterNow, isFuture, isSameDay, isValidDate, isWithinInterval, startOfDay, toDate } from "./date/index.mjs";
 import { StyleInput, StyleObject, StyleValue, addCssUnit, serializeStyle } from "./dom/style.mjs";
 import { RuntimeKind, detectRuntime, hasWebCrypto, isBrowser, isMobileUserAgent, isNode, isTabletUserAgent, isUniApp, isWebWorker } from "./env/index.mjs";
+import { once } from "./function/index.mjs";
 import { InstallationIdentity, InstallationIdentityConfiguration, configureInstallationIdentity, getOrCreateInstallationId, installationIdentity } from "./identity/index.mjs";
 import { LogLevel, Logger, LoggerOptions, LoggerSink, configureLogger, createLogger, logger } from "./logger/index.mjs";
 import { FormatBytesOptions, average, clamp, formatBytes, inRange, lerp, randomInt, roundTo, sum } from "./number/index.mjs";
-import { QueryPrimitive, QueryStringOptions, QueryValue, hasOwn, isPlainObject, mapValues, omit, pick, shallowEqual, toQueryString } from "./object/index.mjs";
+import { QueryPrimitive, QueryStringOptions, QueryValue, cloneDeep, hasOwn, isEqual, isPlainObject, mapValues, omit, omitBy, pick, pickBy, shallowEqual, toQueryString } from "./object/index.mjs";
 import { Local, Session, StorageArea, StorageCodec, StorageConfiguration, StorageReadOptions, StorageWriteOptions, base64StorageCodec, configureStorage, isStorageConfigured } from "./storage/index.mjs";
 import { ParsedQueryParameters, StringLocale, camelCase, copy, decodeURIComponentRepeatedly, escapeHtml, generateUuidV4, isUuidV4, isValidJson, kebabCase, lowerFirst, normalizeWhitespace, parseQueryString, pascalCase, randomString, splitWords, truncateGraphemes, upperFirst } from "./string/index.mjs";
 import { EmitHandlers, useEmits } from "./vue/emits.mjs";
@@ -22,4 +23,4 @@ import { useRender } from "./vue/render.mjs";
 import { TypedSlots, TypedSlotsDeclaration, makeSlots } from "./vue/slots.mjs";
 import { withDefineType } from "./vue/with.mjs";
 import "./vue/index.mjs";
-export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, AbortOptions, AesCipherMode, AesPaddingMode, AwaitableFunction, ConcurrentMapOptions, DateInput, DateRangeShortcut, DateShortcut, DebouncedFunction, type DecodedText, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, EcNamedCurve, EmitHandlers, FixedTimeEquals, FormatBytesOptions, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Installable, InstallationIdentity, InstallationIdentityConfiguration, KeySelector, Local, LogLevel, Logger, LoggerOptions, LoggerSink, MD5Encrypt, PBKDF2SHA256, ParsedQueryParameters, PemKeyPair, QueryPrimitive, QueryStringOptions, QueryValue, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, RelativeTimeOptions, RetryContext, RetryOptions, RgbColor, RgbaColor, RuntimeKind, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, StorageArea, StorageCodec, StorageConfiguration, StorageReadOptions, StorageWriteOptions, StringLocale, StyleInput, StyleObject, StyleValue, TSXWithInstall, ThrottledFunction, TimeoutOptions, TypedSlots, TypedSlotsDeclaration, VerifyPasswordPBKDF2SHA256, VueInstallValue, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, configureInstallationIdentity, configureLogger, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, parseHexColor, parseQueryString, partition, pascalCase, pick, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useEmits, useExpose, useProps, useRender, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };
+export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, AbortOptions, AesCipherMode, AesPaddingMode, AwaitableFunction, ConcurrentMapOptions, DateInput, DateRangeShortcut, DateShortcut, DebouncedFunction, type DecodedText, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, EcNamedCurve, EmitHandlers, FixedTimeEquals, FormatBytesOptions, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, Installable, InstallationIdentity, InstallationIdentityConfiguration, KeySelector, Local, LogLevel, Logger, LoggerOptions, LoggerSink, MD5Encrypt, PBKDF2SHA256, ParsedQueryParameters, PemKeyPair, QueryPrimitive, QueryStringOptions, QueryValue, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, RelativeTimeOptions, RetryContext, RetryOptions, RgbColor, RgbaColor, RuntimeKind, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, Session, StorageArea, StorageCodec, StorageConfiguration, StorageReadOptions, StorageWriteOptions, StringLocale, StyleInput, StyleObject, StyleValue, TSXWithInstall, ThrottledFunction, TimeoutOptions, TypedSlots, TypedSlotsDeclaration, VerifyPasswordPBKDF2SHA256, VueInstallValue, addCssUnit, addDays, addMonths, addYears, allEqualBy, average, base64StorageCodec, callOptionalFunction, camelCase, chunk, clamp, cloneDeep, configureInstallationIdentity, configureLogger, configureStorage, contrastRatio, copy, createDateRangeShortcuts, createDateShortcuts, createLogger, createOneMonthRangeFromToday, debounce, decodeBase64, decodeBase64Bytes, decodeBase64Url, decodeBase64UrlBytes, decodeLatin1Base64, decodeSecureBase64, decodeURIComponentRepeatedly, definePropType, detectRuntime, difference, encodeBase64, encodeBase64Bytes, encodeBase64Url, encodeBase64UrlBytes, encodeLatin1Base64, encodeSecureBase64, endOfDay, escapeHtml, formatBytes, formatChineseRelativeTime, formatHexColor, formatRelativeTime, generateUuidV4, getLocalDayBounds, getLocalTimeGreeting, getOrCreateInstallationId, getStartOfToday, groupBy, hasDuplicatesBy, hasOwn, hasWebCrypto, inRange, installationIdentity, intersection, isBrowser, isDateAfterNow, isEqual, isFuture, isMobileUserAgent, isNode, isPlainObject, isSameDay, isStorageConfigured, isTabletUserAgent, isUniApp, isUuidV4, isValidDate, isValidJson, isWebWorker, isWithinInterval, kebabCase, lerp, logger, lowerFirst, makeSlots, mapConcurrent, mapValues, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, normalizeWhitespace, omit, omitBy, once, parseHexColor, parseQueryString, partition, pascalCase, pick, pickBy, pickHigherContrastColor, randomInt, randomString, relativeLuminance, removeNullishValues, retry, roundTo, serializeStyle, shallowEqual, sleep, splitWords, startOfDay, sum, symmetricDifference, throttle, toDate, toQueryString, truncateGraphemes, unique, uniqueBy, upperFirst, useEmits, useExpose, useProps, useRender, withDefineType, withInstall, withInstallDirective, withNoopInstall, withTimeout };