@fast-china/utils 2.0.0 → 2.0.2

package/src/env/index.ts

@@ -1,169 +0,0 @@
-/** 可识别的主要 JavaScript 运行环境。 */
-export type RuntimeKind = "browser" | "node" | "unknown" | "worker";
-
-/** 环境检测需要逐项确认的 SubtleCrypto 最小能力集合。 */
-type RuntimeSubtleCrypto = Partial<
-	Pick<SubtleCrypto, "decrypt" | "deriveBits" | "deriveKey" | "digest" | "encrypt" | "exportKey" | "generateKey" | "importKey" | "sign" | "verify">
->;
-
-/** 环境检测读取的 Web Crypto 最小视图。 */
-interface RuntimeEnvironmentCrypto extends Partial<Pick<Crypto, "getRandomValues">> {
-	/** 可选 SubtleCrypto 能力；只有所需方法全部存在时才视为完整 Web Crypto。 */
-	subtle?: RuntimeSubtleCrypto;
-}
-
-/** 环境检测读取的最小 Navigator 视图。 */
-interface RuntimeNavigator {
-	/** 平台报告的最大同时触点数；类型异常时按 `0` 处理。 */
-	maxTouchPoints?: unknown;
-	/** 平台报告的 User-Agent；类型异常时按空字符串处理。 */
-	userAgent?: unknown;
-}
-
-/** 环境检测读取的最小 Node 进程视图。 */
-interface RuntimeProcess {
-	/** 可选运行时版本表。 */
-	versions?: RuntimeVersions;
-}
-
-/** 环境检测读取的最小运行时版本表。 */
-interface RuntimeVersions {
-	/** Node.js 版本文本；存在字符串值时识别为 Node 环境。 */
-	node?: unknown;
-}
-
-/** 环境检测读取的最小 Window 视图。 */
-interface RuntimeWindow {
-	/** DOM 文档标记；只检查是否为非空对象。 */
-	document?: unknown;
-}
-
-/** 可选平台全局对象的结构化视图，避免导入 Node 或 uni-app 全局类型。 */
-interface RuntimeGlobals {
-	/** 可选 Web Crypto 能力；所有方法都在调用前逐项检查，不因对象存在而假定完整实现。 */
-	crypto?: RuntimeEnvironmentCrypto;
-	/** Web Worker 中通常存在的脚本导入函数；只检查其类型，不会在检测阶段调用。 */
-	importScripts?: unknown;
-	/** 浏览器或 WebView 暴露的最小 Navigator 字段；未知类型会被能力读取函数视为缺失。 */
-	navigator?: RuntimeNavigator;
-	/** 工具或测试环境可能暴露的 Node 版本标记；仅用于检测，不代表 Node 属于应用运行时契约。 */
-	process?: RuntimeProcess;
-	/** uni-app 平台标记；Storage 会在调用 `configureStorage` 时读取并校验该全局对象。 */
-	uni?: unknown;
-	/** 浏览器 Window 的最小结构；`document` 只用于能力判定，不在模块导入阶段读取 DOM 内容。 */
-	window?: RuntimeWindow | null;
-}
-
-const runtimeGlobals = globalThis as unknown as RuntimeGlobals;
-
-/**
- * 延迟读取当前 User-Agent。
- *
- * @returns Navigator 不存在或字段类型异常时返回空字符串。
- */
-const currentUserAgent = (): string => (typeof runtimeGlobals.navigator?.userAgent === "string" ? runtimeGlobals.navigator.userAgent : "");
-/**
- * 延迟读取当前设备报告的最大触点数。
- *
- * @returns Navigator 不存在或字段类型异常时返回 `0`。
- */
-const currentTouchPoints = (): number => (typeof runtimeGlobals.navigator?.maxTouchPoints === "number" ? runtimeGlobals.navigator.maxTouchPoints : 0);
-
-/**
- * 判断当前运行时是否具有浏览器 `window` 与 `document`。
- *
- * @returns 两项能力均存在时返回 `true`；不读取 DOM 内容。
- */
-export function isBrowser(): boolean {
-	const window = runtimeGlobals.window;
-	return window !== undefined && window !== null && window.document !== null && typeof window.document === "object";
-}
-
-/**
- * 判断当前运行时是否像 Web Worker 且不是 Window。
- *
- * @remarks 经典、模块、Shared 与 Service Worker 全局通常都暴露 `importScripts`；模块
- * Worker 中调用它可能抛错，本检测只检查能力存在，不会执行。
- * @returns 具有 `importScripts` 且不是浏览器 Window 时返回 `true`。
- */
-export function isWebWorker(): boolean {
-	return !isBrowser() && typeof runtimeGlobals.importScripts === "function";
-}
-
-/**
- * 判断当前运行时是否暴露 Node.js 版本标记。
- *
- * @returns `process.versions.node` 为字符串时返回 `true`。
- */
-export function isNode(): boolean {
-	return typeof runtimeGlobals.process?.versions?.node === "string";
-}
-
-/**
- * 判断当前运行时是否暴露 uni-app 的 `uni` 全局对象。
- *
- * @returns 全局属性存在且不为 `undefined` 时返回 `true`；不调用任何平台 API。
- */
-export function isUniApp(): boolean {
-	return runtimeGlobals.uni !== undefined;
-}
-
-/**
- * 判断当前运行时是否具备本库完整加密 API 所需的 Web Crypto 能力。
- *
- * @remarks 只具有 `getRandomValues` 的平台仍可调用随机数与随机字符串 API，但本函数
- * 会返回 `false`，因为摘要、PBKDF2、AES-GCM、RSA 与 ECC 还需要完整的 `SubtleCrypto` 方法集。
- * @returns 同时提供本库 Web Crypto 功能所需方法时返回 `true`。
- */
-export function hasWebCrypto(): boolean {
-	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"
-	);
-}
-
-/**
- * 返回当前主要运行环境。
- *
- * @remarks 在使用 DOM 模拟器的 Node.js 进程中优先报告 `browser`，因为可观察能力比宿主进程名称更有用。
- * @returns `browser`、`worker`、`node` 或无法识别时的 `unknown`。
- */
-export function detectRuntime(): RuntimeKind {
-	if (isBrowser()) return "browser";
-	if (isWebWorker()) return "worker";
-	if (isNode()) return "node";
-	return "unknown";
-}
-
-/**
- * 基于 User-Agent 启发式判断手机设备。
- *
- * @param userAgent - 默认读取当前 `navigator.userAgent`；平台对象不存在时使用空字符串。
- * @remarks User-Agent 可以被伪造，不得用于鉴权、安全策略或永久功能分流。
- * @returns 命中手机特征时返回 `true`。
- */
-export function isMobileUserAgent(userAgent: string = currentUserAgent()): boolean {
-	return /Mobile|iPhone|Android.*Mobile|Windows Phone/iu.test(userAgent);
-}
-
-/**
- * 基于 User-Agent 与触点数量启发式判断平板设备。
- *
- * @param userAgent - 默认读取当前 User-Agent。
- * @param maxTouchPoints - 用于识别桌面 User-Agent 模式下的 iPadOS，默认读取当前触点数。
- * @returns 命中平板特征时返回 `true`。
- */
-export function isTabletUserAgent(userAgent: string = currentUserAgent(), maxTouchPoints: number = currentTouchPoints()): boolean {
-	return /iPad|Android(?!.*Mobile)|Tablet/iu.test(userAgent) || (/Macintosh/iu.test(userAgent) && maxTouchPoints > 1);
-}

package/src/identity/index.ts

@@ -1,144 +0,0 @@
-import { Local } from "../storage/index.js";
-import { generateUuidV4, isUuidV4 } from "../string/index.js";
-
-const defaultInstallationIdentityStorageKey = "identity:installation-id";
-
-/** {@link configureInstallationIdentity} 接收的安装标识配置。 */
-export interface InstallationIdentityConfiguration {
-	/**
-	 * `Local` 中使用的业务键，默认 `identity:installation-id`。
-	 *
-	 * @remarks 必须是无外围空白的非空字符串，并在首次访问 Identity API 前配置；物理键仍会叠加 Storage 全局前缀。
-	 */
-	cacheKey?: string;
-}
-
-/** 浏览器或 uni-app 当前安装实例标识。 */
-export interface InstallationIdentity {
-	/**
-	 * `Local` 中使用的业务键。
-	 *
-	 * @remarks 首次读取会锁定默认配置；之后不能再切换为其他业务键。
-	 */
-	readonly cacheKey: string;
-	/**
-	 * 当前内存中的安装标识；尚未取得标识或调用 {@link InstallationIdentity.clear clear} 后为空字符串。
-	 *
-	 * @remarks 直接赋值只改变内存，不会校验或持久化；通常应调用 {@link InstallationIdentity.getOrCreate getOrCreate}。
-	 */
-	deviceId: string;
-	/**
-	 * 删除当前 `cacheKey` 对应的持久化标识，并把 `deviceId` 重置为空字符串。
-	 *
-	 * @throws `Error` 当 Storage 尚未配置或当前平台存储不可用。
-	 */
-	clear: () => void;
-	/**
-	 * 按“显式参数、当前内存、持久化值、安全生成值”的优先级取得安装标识。
-	 *
-	 * @param installationId - 可选 UUID v4；传入时覆盖内存值和当前持久化值。
-	 * @returns 已校验并同时写入 `deviceId` 与 `Local` 的 UUID v4。
-	 * @throws `TypeError` 当显式参数、内存值或持久化值不是 UUID v4。
-	 * @throws `Error` 当 Storage 尚未配置，或生成新值时平台缺少 Web Crypto。
-	 */
-	getOrCreate: (installationId?: string) => string;
-	/**
-	 * 读取并校验当前 `cacheKey` 对应的持久化标识。
-	 *
-	 * @remarks 该方法不修改 `deviceId`，只负责读取；过期记录由 Storage 视为缺失。
-	 * @returns 已持久化的 UUID v4；键缺失或过期时返回 `undefined`。
-	 * @throws `TypeError` 当持久化值不是字符串或不是 UUID v4。
-	 * @throws `Error` 当 Storage 尚未配置或当前平台存储不可用。
-	 */
-	read: () => string | undefined;
-}
-
-/**
- * 校验安装标识格式。
- *
- * @param value - 外部传入或从 Storage 读取的候选值。
- * @throws `TypeError` 当值不是 RFC 4122 UUID v4。
- */
-const assertInstallationId = (value: string): void => {
-	if (!isUuidV4(value)) throw new TypeError("Installation Identity values must be RFC 4122 version 4 UUIDs.");
-};
-
-let activeStorageKey: string | undefined;
-
-/**
- * 取得已经锁定的安装标识业务键。
- *
- * @remarks 首次读取会锁定默认值，防止标识已经写入后再切换键而产生两个安装标识。
- * @returns 应用于后续全部 Identity 操作的业务键。
- */
-const getInstallationIdentityStorageKey = (): string => {
-	activeStorageKey ??= defaultInstallationIdentityStorageKey;
-	return activeStorageKey;
-};
-
-/**
- * 在应用入口配置安装标识使用的 Storage 业务键。
- *
- * @remarks 必须在首次读取 `installationIdentity.cacheKey` 或调用其他安装标识 API 前执行。相同配置
- * 可以幂等重复调用；切换到不同键会抛错，避免同一页面产生分裂状态。
- * @param options - 安装标识配置；省略 `cacheKey` 时使用 `identity:installation-id`。
- * @throws `TypeError` 当 `cacheKey` 不是非空字符串或包含外围空白。
- * @throws `Error` 当安装标识已经使用另一个业务键初始化。
- */
-export function configureInstallationIdentity(options: InstallationIdentityConfiguration = {}): void {
-	const cacheKey = options.cacheKey ?? defaultInstallationIdentityStorageKey;
-	if (typeof cacheKey !== "string" || cacheKey.length === 0 || cacheKey.trim() !== cacheKey) {
-		throw new TypeError("Installation Identity cacheKey must be a non-empty string without surrounding whitespace.");
-	}
-	if (activeStorageKey === undefined) {
-		activeStorageKey = cacheKey;
-		return;
-	}
-	if (activeStorageKey !== cacheKey) throw new Error("Installation Identity has already been configured with a different cacheKey.");
-}
-
-/**
- * 全局安装标识状态。
- *
- * @remarks 使用前必须在应用入口调用 `configureStorage()`。默认随机源只使用 Web Crypto，
- * 能力缺失时明确抛错，不回退到 `Math.random()`。该值不是硬件标识、认证凭证或安全边界。
- */
-export const installationIdentity: InstallationIdentity = {
-	get cacheKey(): string {
-		return getInstallationIdentityStorageKey();
-	},
-	deviceId: "",
-	clear(): void {
-		Local.remove(installationIdentity.cacheKey);
-		installationIdentity.deviceId = "";
-	},
-	getOrCreate(installationId?: string): string {
-		const candidate =
-			installationId ??
-			(installationIdentity.deviceId.length > 0 ? installationIdentity.deviceId : installationIdentity.read()) ??
-			generateUuidV4();
-		assertInstallationId(candidate);
-		Local.set(installationIdentity.cacheKey, candidate);
-		installationIdentity.deviceId = candidate;
-		return candidate;
-	},
-	read(): string | undefined {
-		const stored = Local.get(installationIdentity.cacheKey);
-		if (stored === undefined) return undefined;
-		if (typeof stored !== "string") throw new TypeError("The stored identity is corrupted.");
-		assertInstallationId(stored);
-		return stored;
-	},
-};
-
-/**
- * 返回已有安装标识，否则创建并持久化一个安全 UUID v4。
- *
- * @param installationId - 可选的显式安装标识；传入时会校验并覆盖当前持久化值。
- * @returns 显式值、内存值、持久化值或新生成值中的最终安装标识。
- * @throws `TypeError` 当显式值或持久化值不是 UUID v4。
- * @throws `Error` 当 Storage 尚未配置或平台缺少 Web Crypto。
- */
-export function getOrCreateInstallationId(installationId?: string): string {
-	return installationIdentity.getOrCreate(installationId);
-}

package/src/index.ts

@@ -1,20 +0,0 @@
-/**
- * Fast.Utils public API.
- *
- * @packageDocumentation
- */
-export * from "./array/index.js";
-export * from "./async/index.js";
-export * from "./base64/index.js";
-export * from "./color/index.js";
-export * from "./crypto/index.js";
-export * from "./date/index.js";
-export * from "./dom/index.js";
-export * from "./env/index.js";
-export * from "./identity/index.js";
-export * from "./logger/index.js";
-export * from "./number/index.js";
-export * from "./object/index.js";
-export * from "./storage/index.js";
-export * from "./string/index.js";
-export * from "./vue/index.js";

package/src/internal/text.ts

@@ -1,46 +0,0 @@
-/** 延迟访问 Encoding API 时使用的平台全局对象最小视图。 */
-interface RuntimeEncodingGlobals {
-	/** 可选 TextDecoder 构造器；缺失时只允许不依赖文本解码的 API 继续工作。 */
-	TextDecoder?: typeof TextDecoder;
-	/** 可选 TextEncoder 构造器；缺失时只允许纯字节 API 继续工作。 */
-	TextEncoder?: typeof TextEncoder;
-}
-
-const runtimeEncodingGlobals = globalThis as unknown as RuntimeEncodingGlobals;
-
-/**
- * 延迟解析 UTF-8 TextDecoder，确保模块导入阶段不依赖 Encoding API。
- *
- * @returns 启用 Fatal 模式的新解码器，非法 UTF-8 会直接失败。
- * @throws `Error` 当当前平台没有提供 `TextDecoder`。
- */
-export const getTextDecoder = (): TextDecoder => {
-	const TextDecoderConstructor = runtimeEncodingGlobals.TextDecoder;
-	if (typeof TextDecoderConstructor !== "function") {
-		throw new Error("TextDecoder is unavailable in the current runtime.");
-	}
-	return new TextDecoderConstructor("utf-8", { fatal: true });
-};
-
-/**
- * 延迟解析 TextEncoder，让纯字节 API 在缺少 Encoding API 的平台仍可导入。
- *
- * @returns 新建的 UTF-8 编码器。
- * @throws `Error` 当当前平台没有提供 `TextEncoder`。
- */
-export const getTextEncoder = (): TextEncoder => {
-	const TextEncoderConstructor = runtimeEncodingGlobals.TextEncoder;
-	if (typeof TextEncoderConstructor !== "function") {
-		throw new Error("TextEncoder is unavailable in the current runtime.");
-	}
-	return new TextEncoderConstructor();
-};
-
-/**
- * 在确认平台能力后把 JavaScript 字符串编码为 UTF-8。
- *
- * @param value - 待编码文本。
- * @returns 使用独立 ArrayBuffer 的 UTF-8 字节数组。
- * @throws `Error` 当当前平台没有提供 `TextEncoder`。
- */
-export const encodeUtf8 = (value: string): Uint8Array<ArrayBuffer> => getTextEncoder().encode(value);

package/src/logger/index.ts

@@ -1,219 +0,0 @@
-/** 日志严重级别，按从低到高排列。 */
-export type LogLevel = "debug" | "info" | "warn" | "error";
-
-/** 日志输出目标需要实现的最小控制台接口。 */
-export interface LoggerSink {
-	/**
-	 * 接收通过级别过滤后的调试参数。
-	 * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-	 */
-	debug: (...data: unknown[]) => void;
-	/**
-	 * 接收通过级别过滤后的普通信息参数；对应 Logger 的 `info` 级别。
-	 * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-	 */
-	log: (...data: unknown[]) => void;
-	/**
-	 * 接收通过级别过滤后的警告参数。
-	 * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-	 */
-	warn: (...data: unknown[]) => void;
-	/**
-	 * 接收通过级别过滤后的错误参数。
-	 * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-	 */
-	error: (...data: unknown[]) => void;
-}
-
-/** {@link createLogger} 的不可变配置。 */
-export interface LoggerOptions {
-	/** 最低输出级别，默认 `info`；低于该优先级的消息不会传给 Sink。 */
-	level?: LogLevel;
-	/** 日志品牌前缀，默认 `Fast`；必须是无外围空白的非空字符串。 */
-	prefix?: string;
-	/** 可注入输出目标，默认当前运行时的 `console`；Logger 不会修改该对象。 */
-	sink?: LoggerSink;
-	/** uni-app App-Plus/HBuilderX 中把附加参数逐条转成单行文本输出，默认 `false`；其他平台忽略。 */
-	uniAppPlusSplit?: boolean;
-}
-
-/** 配置隔离、无全局可变状态的轻量日志器。 */
-export interface Logger {
-	/**
-	 * 输出指定作用域的调试信息。
-	 * @param scope - 模块、组件或业务来源名称。
-	 * @param message - 主消息文本。
-	 * @param data - 保持原始类型的附加值。
-	 * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-	 */
-	debug: (scope: string, message: string, ...data: unknown[]) => void;
-	/**
-	 * 输出指定作用域的普通信息。
-	 * @param scope - 模块、组件或业务来源名称。
-	 * @param message - 主消息文本。
-	 * @param data - 保持原始类型的附加值。
-	 * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-	 */
-	info: (scope: string, message: string, ...data: unknown[]) => void;
-	/**
-	 * 输出指定作用域的警告信息。
-	 * @param scope - 模块、组件或业务来源名称。
-	 * @param message - 主消息文本。
-	 * @param data - 保持原始类型的附加值。
-	 * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-	 */
-	warn: (scope: string, message: string, ...data: unknown[]) => void;
-	/**
-	 * 输出指定作用域的错误信息。
-	 * @param scope - 模块、组件或业务来源名称。
-	 * @param message - 主消息文本。
-	 * @param data - 保持原始类型的附加值。
-	 * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-	 */
-	error: (scope: string, message: string, ...data: unknown[]) => void;
-}
-
-const levelPriority: Readonly<Record<LogLevel, number>> = {
-	debug: 10,
-	info: 20,
-	warn: 30,
-	error: 40,
-};
-
-/**
- * 判断未知值是否为受支持日志级别。
- *
- * @param value - 待检查配置值。
- * @returns 值是 `debug`、`info`、`warn` 或 `error` 时返回 `true`。
- */
-const isLogLevel = (value: unknown): value is LogLevel => typeof value === "string" && Object.hasOwn(levelPriority, value);
-
-/** uni-app App-Plus 检测所需的平台全局对象最小视图。 */
-interface RuntimeLoggerGlobals {
-	/** App-Plus 原生运行时标记。 */
-	plus?: unknown;
-	/** uni-app 运行时标记。 */
-	uni?: unknown;
-}
-
-const runtimeLoggerGlobals = globalThis as unknown as RuntimeLoggerGlobals;
-
-/**
- * 检测 uni-app App-Plus 日志环境。
- *
- * @returns 全局 `uni` 与 `plus` 同时存在时返回 `true`。
- */
-const isUniAppPlus = (): boolean => {
-	return runtimeLoggerGlobals.uni !== undefined && runtimeLoggerGlobals.plus !== undefined;
-};
-
-/**
- * 把日志附加值转换为适合 HBuilderX 单行输出的文本。
- *
- * @remarks 循环引用会替换为 `[Circular]`，BigInt 保留 `n` 后缀，Error 优先输出堆栈。
- * @param value - 任意日志附加值。
- * @returns 不会因 JSON 序列化失败而中断日志调用的文本。
- */
-const formatSplitValue = (value: unknown): string => {
-	if (typeof value === "string") return value;
-	if (typeof value === "bigint") return `${value.toString()}n`;
-	if (value instanceof Error) return value.stack ?? `${value.name}: ${value.message}`;
-	const visited = new WeakSet();
-	try {
-		const serialized: unknown = JSON.stringify(
-			value,
-			(_key, item: unknown): unknown => {
-				if (typeof item === "bigint") return `${item.toString()}n`;
-				if (typeof item !== "object" || item === null) return item;
-				if (visited.has(item)) return "[Circular]";
-				visited.add(item);
-				return item;
-			},
-			2
-		);
-		return typeof serialized === "string" ? serialized : String(value);
-	} catch {
-		return String(value);
-	}
-};
-
-const defaultConsoleSink: LoggerSink = {
-	debug: (...data): void => {
-		if (typeof console.debug === "function") console.debug(...data);
-		else console.log(...data);
-	},
-	log: (...data): void => {
-		console.log(...data);
-	},
-	warn: (...data): void => {
-		console.warn(...data);
-	},
-	error: (...data): void => {
-		console.error(...data);
-	},
-};
-
-/**
- * 创建独立日志器。
- *
- * @remarks 本库其他模块不会自动记录、吞掉或转换异常。日志内容可能进入持久化平台，
- * 调用方不得传入密码、令牌、密钥或完整个人数据。
- * @param options - 级别、前缀、输出目标和 uni-app App-Plus 拆分选项。
- * @returns 不会修改全局控制台或其他日志器配置的新实例。
- * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。
- */
-export function createLogger(options: LoggerOptions = {}): Logger {
-	const requestedLevel: unknown = options.level ?? "info";
-	const requestedPrefix: unknown = options.prefix ?? "Fast";
-	const sink = options.sink ?? defaultConsoleSink;
-	if (!isLogLevel(requestedLevel)) throw new RangeError(`Unknown logger level: ${String(requestedLevel)}.`);
-	if (typeof requestedPrefix !== "string" || requestedPrefix.length === 0) {
-		throw new RangeError("Logger prefix must be a non-empty string.");
-	}
-	const level = requestedLevel;
-	const prefix = requestedPrefix;
-	const uniAppPlusSplit = options.uniAppPlusSplit ?? false;
-
-	/**
-	 * 应用级别过滤、标题格式和平台输出策略。
-	 *
-	 * @param messageLevel - 本条消息的严重级别。
-	 * @param scope - 模块、组件或业务来源名称。
-	 * @param message - 主消息文本。
-	 * @param data - 保持原始类型的附加值。
-	 * @throws `RangeError` 当作用域不是非空字符串或包含外围空白。
-	 */
-	const write = (messageLevel: LogLevel, scope: string, message: string, data: readonly unknown[]): void => {
-		if (typeof scope !== "string") throw new TypeError("Logger scope must be a string.");
-		if (scope.length === 0 || scope.trim() !== scope) {
-			throw new RangeError("Logger scope must be a non-empty string without surrounding whitespace.");
-		}
-		if (levelPriority[messageLevel] < levelPriority[level]) return;
-		const heading = `[${prefix}:${scope}]`;
-		const sinkMethod: keyof LoggerSink = messageLevel === "info" ? "log" : messageLevel;
-		if (uniAppPlusSplit && isUniAppPlus()) {
-			sink[sinkMethod](`${heading} ${message}`);
-			for (const item of data) sink[sinkMethod](formatSplitValue(item));
-			return;
-		}
-		sink[sinkMethod](heading, message, ...data);
-	};
-
-	return {
-		debug: (scope, message, ...data): void => {
-			write("debug", scope, message, data);
-		},
-		info: (scope, message, ...data): void => {
-			write("info", scope, message, data);
-		},
-		warn: (scope, message, ...data): void => {
-			write("warn", scope, message, data);
-		},
-		error: (scope, message, ...data): void => {
-			write("error", scope, message, data);
-		},
-	};
-}
-
-/** 默认使用 `Fast` 前缀和 `info` 级别的便捷日志器。 */
-export const logger: Logger = createLogger();