@fast-china/utils 2.1.6 → 2.1.7

package/dist/identity/index.d.mts

@@ -1,77 +0,0 @@
-//#region src/identity/index.d.ts
-/** {@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` 当当前平台存储不可用。
-   */
-  clear: () => void;
-  /**
-   * 按“显式参数、当前内存、持久化值、随机生成值”的优先级取得安装标识。
-   *
-   * @param installationId - 可选 UUID v4；传入时覆盖内存值和当前持久化值。
-   * @returns 已校验并同时写入 `deviceId` 与 `Local` 的 UUID v4。
-   * @throws `TypeError` 当显式参数、内存值或持久化值不是 UUID v4。
-   * @throws `Error` 当当前平台存储不可用。
-   */
-  getOrCreate: (installationId?: string) => string;
-  /**
-   * 读取并校验当前 `cacheKey` 对应的持久化标识。
-   *
-   * @remarks 该方法不修改 `deviceId`，只负责读取；过期记录由 Storage 视为缺失。
-   * @returns 已持久化的 UUID v4；键缺失或过期时返回 `undefined`。
-   * @throws `TypeError` 当持久化值不是字符串或不是 UUID v4。
-   * @throws `Error` 当当前平台存储不可用。
-   */
-  read: () => string | undefined;
-}
-/**
- * 在应用入口配置安装标识使用的 Storage 业务键。
- *
- * @remarks 必须在首次读取 `installationIdentity.cacheKey` 或调用其他安装标识 API 前执行。相同配置
- * 可以幂等重复调用；切换到不同键会抛错，避免同一页面产生分裂状态。
- * @param options - 安装标识配置；省略 `cacheKey` 时使用 `identity:installation-id`。
- * @throws `TypeError` 当 `cacheKey` 不是非空字符串或包含外围空白。
- * @throws `Error` 当安装标识已经使用另一个业务键初始化。
- */
-export declare function configureInstallationIdentity(options?: InstallationIdentityConfiguration): void;
-/**
- * 全局安装标识状态。
- *
- * @remarks Storage 未显式配置时会使用其默认值。生成 UUID 时优先使用 Web Crypto，能力缺失时
- * 回退到 `Math.random()`。该值不是硬件标识、认证凭证或安全边界。
- */
-export declare const installationIdentity: InstallationIdentity;
-/**
- * 返回已有安装标识，否则创建并持久化一个 UUID v4。
- *
- * @param installationId - 可选的显式安装标识；传入时会校验并覆盖当前持久化值。
- * @returns 显式值、内存值、持久化值或新生成值中的最终安装标识。
- * @throws `TypeError` 当显式值或持久化值不是 UUID v4。
- * @throws `Error` 当当前平台存储不可用。
- */
-export declare function getOrCreateInstallationId(installationId?: string): string;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/internal/text.d.mts

@@ -1,15 +0,0 @@
-//#region src/internal/text.d.ts
-/** 解码或解密后的字符串扩展。 */
-interface DecodedTextExtension {
-  /**
-   * 显式把原始文本解析为 JSON 值。
-   *
-   * @remarks 泛型只描述调用方期望的类型，不验证实际 JSON 结构；不可信数据仍需执行运行时校验。
-   * @returns `JSON.parse` 生成的对象、数组、标量或 `null`；文本不是合法 JSON 时返回原始字符串。
-   */
-  parseJson: <Value = any>() => Value;
-}
-/** 可直接作为原始字符串使用，并支持显式 JSON 解析的解码或解密结果。 */
-export type DecodedText = string & DecodedTextExtension;
-//#endregion
-//# sourceMappingURL=text.d.mts.map

package/dist/logger/index.d.mts

@@ -1,90 +0,0 @@
-//#region src/logger/index.d.ts
-/** 日志严重级别，按从低到高排列。 */
-export type LogLevel = "debug" | "log" | "warn" | "error";
-/** 日志输出目标需要实现的最小控制台接口。 */
-export interface LoggerSink {
-  /**
-   * 接收通过级别过滤后的调试参数。
-   * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-   */
-  debug: (...data: unknown[]) => void;
-  /**
-   * 接收通过级别过滤后的普通日志参数；对应 Logger 的 `log` 级别。
-   * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-   */
-  log: (...data: unknown[]) => void;
-  /**
-   * 接收通过级别过滤后的警告参数。
-   * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-   */
-  warn: (...data: unknown[]) => void;
-  /**
-   * 接收通过级别过滤后的错误参数。
-   * @param data - 已格式化的品牌、作用域、消息以及保持原始类型的附加值。
-   */
-  error: (...data: unknown[]) => void;
-}
-/** {@link createLogger} 的不可变配置。 */
-export interface LoggerOptions {
-  /** 最低输出级别，默认 `debug`；低于该优先级的消息不会传给 Sink。 */
-  level?: LogLevel;
-  /** 日志品牌前缀，默认 `Fast`；必须是无外围空白的非空字符串。 */
-  prefix?: string;
-  /** 可注入输出目标，默认当前运行时的 `console`；Logger 不会修改该对象。 */
-  sink?: LoggerSink;
-  /** uni-app App-Plus/HBuilderX 中把附加参数逐条转成单行文本输出，默认 `false`；其他平台忽略。 */
-  uniAppPlusSplit?: boolean;
-}
-/** 配置隔离的轻量日志器。 */
-export interface Logger {
-  /**
-   * 输出指定作用域的调试信息或数据。
-   * @param scope - 模块、组件或业务来源名称。
-   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
-   * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-   */
-  debug: (scope: string, ...content: unknown[]) => void;
-  /**
-   * 输出指定作用域的普通信息或数据。
-   * @param scope - 模块、组件或业务来源名称。
-   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
-   * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-   */
-  log: (scope: string, ...content: unknown[]) => void;
-  /**
-   * 输出指定作用域的警告信息或数据。
-   * @param scope - 模块、组件或业务来源名称。
-   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
-   * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-   */
-  warn: (scope: string, ...content: unknown[]) => void;
-  /**
-   * 输出指定作用域的错误信息或数据。
-   * @param scope - 模块、组件或业务来源名称。
-   * @param content - 可选的消息与附加值；非字符串值保持原始类型。
-   * @throws `TypeError` 或 `RangeError` 当作用域不是无外围空白的非空字符串。
-   */
-  error: (scope: string, ...content: unknown[]) => void;
-}
-/**
- * 创建独立日志器。
- *
- * @remarks 本库其他模块不会自动记录、吞掉或转换异常。日志内容可能进入持久化平台，
- * 调用方不得传入密码、令牌、密钥或完整个人数据。
- * @param options - 级别、前缀、输出目标和 uni-app App-Plus 拆分选项。
- * @returns 不会修改全局控制台或其他日志器配置的新实例。
- * @throws `RangeError` 当级别未知，或前缀、作用域不是有效的非空字符串。
- */
-export declare function createLogger(options?: LoggerOptions): Logger;
-/**
- * 替换默认 {@link logger} 的完整配置。
- *
- * @remarks 已创建的独立 Logger 不受影响；默认 Logger 对象引用保持稳定，并立即转发到新配置。
- * 省略选项会恢复 `createLogger()` 的全部默认值。
- * @param options - 默认 Logger 使用的级别、前缀、输出目标和 uni-app App-Plus 拆分选项。
- */
-export declare function configureLogger(options?: LoggerOptions): void;
-/** 默认使用 `Fast` 前缀和 `debug` 级别、可通过 {@link configureLogger} 配置的便捷日志器。 */
-export declare const logger: Logger;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/number/index.d.mts

@@ -1,89 +0,0 @@
-//#region src/number/index.d.ts
-/** {@link formatBytes} 的格式化选项。 */
-export interface FormatBytesOptions {
-  /** 计量基数。`1000` 生成 SI 单位，`1024` 生成 IEC 单位；默认 `1024`。 */
-  base?: 1000 | 1024;
-  /** 小数位数，范围 0 至 20；默认 `2`。 */
-  decimals?: number;
-  /** `Intl.NumberFormat` 使用的语言；默认固定为 `en-US` 以保证输出稳定。 */
-  locale?: string | readonly string[];
-}
-/**
- * 把数字限制在闭区间内。
- *
- * @param value - 需要限制的数字。
- * @param minimum - 闭区间下界。
- * @param maximum - 闭区间上界。
- * @returns `minimum <= result <= maximum` 的值。
- * @throws `RangeError` 当参数为 `NaN` 或下界大于上界。
- */
-export declare function clamp(value: number, minimum: number, maximum: number): number;
-/**
- * 判断数字是否位于指定区间。
- *
- * @param value - 待检查数字。
- * @param minimum - 包含的下界。
- * @param maximum - 上界。
- * @param includeMaximum - 是否包含上界；默认使用半开区间 `[minimum, maximum)`。
- * @returns 数字满足区间边界时返回 `true`。
- * @throws `RangeError` 当参数为 `NaN` 或下界大于上界。
- */
-export declare function inRange(value: number, minimum: number, maximum: number, includeMaximum?: boolean): boolean;
-/**
- * 按十进制位数四舍五入。
- *
- * @remarks IEEE-754 浮点数仍可能存在不可表示误差；财务金额应使用十进制定点方案。
- * @param value - 有限数字。
- * @param digits - 小数位数；负数表示十位、百位等，范围 -15 至 15。
- * @returns 按 `Math.round` 语义舍入后的数字。
- * @throws `RangeError` 当值非有限或位数超出范围。
- */
-export declare function roundTo(value: number, digits?: number): number;
-/**
- * 对有限数字求和。
- *
- * @param values - 不会被修改的数字数组。
- * @returns 算术和；空数组返回 `0`。
- * @throws `RangeError` 当任一值非有限或累计结果溢出。
- */
-export declare function sum(values: readonly number[]): number;
-/**
- * 计算有限数字的算术平均值。
- *
- * @param values - 不会被修改的数字数组。
- * @returns 空数组或只有稀疏空位的数组返回 `undefined`；空位不参与分母。
- * @throws `RangeError` 当任一值非有限。
- */
-export declare function average(values: readonly number[]): number | undefined;
-/**
- * 在两个数字间做线性插值。
- *
- * @remarks `amount` 不限制在 0 至 1；区间外的值会执行线性外推。
- * @param start - `amount = 0` 时的起点。
- * @param end - `amount = 1` 时的终点。
- * @param amount - 插值或外推比例。
- * @returns 线性计算结果。
- * @throws `RangeError` 当任一参数非有限或结果超出有限数字范围。
- */
-export declare function lerp(start: number, end: number, amount: number): number;
-/**
- * 将非负字节数格式化为 SI 或 IEC 单位。
- *
- * @param bytes - 非负有限字节数。
- * @param options - 基数、小数位和语言选项。
- * @returns 例如 `1.5 KiB`。
- * @throws `RangeError` 当字节数为负或非有限、基数不是 1000/1024、小数位非法，或 Locale 无效。
- */
-export declare function formatBytes(bytes: number, options?: FormatBytesOptions): string;
-/**
- * 在半开区间内生成随机整数。
- *
- * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
- * @param minimum - 包含的安全整数下界。
- * @param maximumExclusive - 不包含的安全整数上界；区间宽度最大为 2^32。
- * @returns 位于 `[minimum, maximumExclusive)` 的随机整数。
- * @throws 参数非法时抛出 `RangeError`。
- */
-export declare function randomInt(minimum: number, maximumExclusive: number): number;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/object/index.d.mts

@@ -1,114 +0,0 @@
-//#region src/object/index.d.ts
-/** URL 查询参数支持的单值类型。 */
-export type QueryPrimitive = bigint | boolean | number | string | null | undefined;
-/** URL 查询参数值；数组使用重复键表示。 */
-export type QueryValue = QueryPrimitive | readonly QueryPrimitive[];
-/** {@link toQueryString} 的序列化选项。 */
-export interface QueryStringOptions {
-  /** 返回非空结果时是否添加 `?`；默认 `false`。 */
-  prefixQuestionMark?: boolean;
-  /** 是否按键的 UTF-16 码元顺序稳定排序；默认保留对象枚举顺序。 */
-  sort?: boolean;
-  /** 空格编码方式；默认遵循表单编码并输出 `+`。 */
-  space?: "percent" | "plus";
-}
-/**
- * 判断值是否是普通对象。
- *
- * @param value - 任意待检查值。
- * @returns 原型为 `Object.prototype` 或 `null` 时返回 `true`。
- */
-export declare function isPlainObject(value: unknown): value is Record<PropertyKey, unknown>;
-/**
- * 安全判断对象是否拥有自己的属性。
- *
- * @remarks 不调用可能被对象覆盖的 `hasOwnProperty`。
- * @param value - 待检查对象。
- * @param key - 字符串、数字或 Symbol 属性键。
- * @returns 属性为对象自有属性时返回 `true`，并收窄键类型。
- */
-export declare function hasOwn<ObjectType extends object, Key extends PropertyKey>(value: ObjectType, key: Key): key is Key & keyof ObjectType;
-/**
- * 递归创建值的深层副本。
- *
- * @remarks 支持循环引用、共享引用、Symbol 键、对象原型、ArrayBuffer、DataView、Date、Map、RegExp、Set 和 TypedArray。
- * Map 的键保持原引用，函数及其他不可克隆值在嵌套位置保持原引用；只复制自有可枚举属性。
- * @param value - 需要深复制的任意值。
- * @returns 与输入类型一致且不共享可克隆嵌套值的新值；原始类型直接返回自身。
- */
-export declare function cloneDeep<Value>(value: Value): Value;
-/**
- * 深度比较两个值是否等价。
- *
- * @remarks 原始值使用 SameValueZero 语义；支持循环引用、数组、对象、ArrayBuffer、DataView、Date、Error、Map、RegExp、Set、Symbol 和 TypedArray。
- * 对象只比较自有可枚举字符串与 Symbol 属性，函数及其他不支持的宿主对象仅在引用相同时相等。
- * @param left - 第一待比较值。
- * @param right - 第二待比较值。
- * @returns 两个值深度等价时返回 `true`。
- */
-export declare function isEqual(left: unknown, right: unknown): boolean;
-/**
- * 从对象中选择指定自有可枚举属性。
- *
- * @remarks 字面量键数组保留精确返回类型；普通 `string[]` 等动态键数组返回 `Partial<Source>`。
- * @param source - 不会被修改的源对象。
- * @param keys - 需要保留的键；不存在的键被忽略。
- * @returns 新对象，保持 `keys` 的遍历顺序。
- */
-export declare function pick<Source extends object, const Keys extends readonly (keyof Source)[]>(source: Source, keys: Keys): Pick<Source, Keys[number]>;
-export declare function pick<Source extends object>(source: Source, keys: readonly PropertyKey[]): Partial<Source>;
-/**
- * 浅复制对象并删除指定属性。
- *
- * @remarks 字面量键数组保留精确返回类型；普通 `string[]` 等动态键数组返回 `Partial<Source>`。
- * @param source - 不会被修改的源对象。
- * @param keys - 需要排除的键。
- * @returns 包含其余自有可枚举字符串与 Symbol 属性的新对象。
- */
-export declare function omit<Source extends object, const Keys extends readonly (keyof Source)[]>(source: Source, keys: Keys): Omit<Source, Keys[number]>;
-export declare function omit<Source extends object>(source: Source, keys: readonly PropertyKey[]): Partial<Source>;
-/**
- * 按条件排除对象的自有可枚举属性。
- *
- * @param source - 不会被修改的源对象。
- * @param predicate - 接收属性值、键和源对象；返回真值时排除该属性。
- * @returns 由未匹配属性组成的新对象。
- */
-export declare function omitBy<Source extends object>(source: Source, predicate: (value: Source[keyof Source], key: keyof Source, source: Source) => unknown): Partial<Source>;
-/**
- * 按条件选择对象的自有可枚举属性。
- *
- * @param source - 不会被修改的源对象。
- * @param predicate - 接收属性值、键和源对象；返回真值时保留该属性。
- * @returns 由匹配属性组成的新对象。
- */
-export declare function pickBy<Source extends object>(source: Source, predicate: (value: Source[keyof Source], key: keyof Source, source: Source) => unknown): Partial<Source>;
-/**
- * 映射对象的自有可枚举属性值。
- *
- * @param source - 不会被修改的源对象。
- * @param mapper - 接收值、键和源对象的映射函数。
- * @returns 保留原键的新对象。
- */
-export declare function mapValues<Source extends object, Result>(source: Source, mapper: (value: Source[keyof Source], key: keyof Source, source: Source) => Result): { [Key in keyof Source]: Result; };
-/**
- * 对自有可枚举属性执行 SameValue 浅比较。
- *
- * @remarks 嵌套对象只比较引用；`NaN` 相等，`0` 与 `-0` 不相等。
- * @param left - 第一对象。
- * @param right - 第二对象。
- * @returns 自有可枚举键集合与对应值均满足 SameValue 时返回 `true`。
- */
-export declare function shallowEqual(left: object, right: object): boolean;
-/**
- * 将对象序列化为标准 URL 查询字符串。
- *
- * @remarks `null` 与 `undefined` 被跳过；数组使用重复键；返回值不会修改输入。
- * @param value - 查询参数对象。
- * @param options - 排序、空格和问号前缀选项。
- * @returns URL 编码后的查询字符串；没有参数时始终返回空字符串。
- * @throws `RangeError` 当参数包含 `NaN` 或无穷数字。
- */
-export declare function toQueryString(value: Readonly<Record<string, QueryValue>>, options?: QueryStringOptions): string;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/storage/index.d.mts

@@ -1,115 +0,0 @@
-//#region src/storage/index.d.ts
-/** Storage 业务值编码器。 */
-export interface StorageCodec {
-  /**
-   * 把已编码文本恢复为业务值。
-   * @param value - 由同一 Codec 的 `encode` 生成并持久化的文本。
-   * @returns 解码后的业务值。
-   * @throws 当文本损坏、格式不受支持或无法反序列化时应抛出错误。
-   */
-  decode: (value: string) => unknown;
-  /**
-   * 把业务值编码为可持久化字符串。
-   * @param value - 调用方传入的业务值。
-   * @returns 可由同一 Codec 的 `decode` 无损恢复的文本。
-   * @throws 当值不受支持或无法序列化时应抛出错误。
-   */
-  encode: (value: unknown) => string;
-}
-/** 程序入口调用 {@link configureStorage} 时使用的全局配置。 */
-export interface StorageConfiguration {
-  /** 自定义值编码器；默认使用严格 JSON Codec，同一应用生命周期内必须保持同一引用。 */
-  codec?: StorageCodec;
-  /** 启用 Base64 可逆混淆；不提供加密、完整性或认证，不能与 `codec` 同时使用。 */
-  crypto?: boolean;
-  /** 返回 Unix 毫秒时间戳的时钟；默认使用 `Date.now`，主要用于 TTL 测试与受控时间源。 */
-  now?: () => number;
-  /** 所有物理键使用的非空命名空间前缀； */
-  prefix?: string;
-}
-/** 单次 Storage 读取配置。 */
-export interface StorageReadOptions {
-  /**
-   * 仅覆盖本次读取使用的 Codec；`true` 使用 Base64 混淆，`false` 使用 JSON，省略时使用全局配置。
-   * 必须与写入该条目时使用的单次设置一致。
-   */
-  crypto?: boolean;
-}
-/** 单次 Storage 写入配置。 */
-export interface StorageWriteOptions extends StorageReadOptions {
-  /** 从写入时刻开始的有效毫秒数；必须是大于 0 的有限数，省略时永久有效。 */
-  ttlMs?: number;
-}
-/** `Local` 与 `Session` 的统一操作接口。 */
-export interface StorageArea {
-  /** 当前全局 Storage 配置的物理键前缀；首次读取会激活默认配置。 */
-  readonly prefix: string;
-  /**
-   * 删除当前命名空间内的全部键，不影响同一后端中的其他应用键。
-   * @throws `Error` 当当前平台后端不可用。
-   */
-  clear: () => void;
-  /**
-   * 获取并解码业务值；已过期记录会在读取时删除。
-   * @param key - 不含全局前缀的非空业务键。
-   * @param options - 可选的单次 Base64 混淆开关；必须与写入时一致。
-   * @returns 解码后的值；未传泛型时静态类型默认为 `string`，键缺失或过期时返回 `undefined`。
-   * @throws 当键非法、包络损坏、Codec 解码失败或后端不可用时抛出错误。
-   */
-  get: <Value = string>(key: string, options?: StorageReadOptions) => Value | undefined;
-  /**
-   * 判断一个可成功读取且未过期的业务键是否存在。
-   * @param key - 不含全局前缀的非空业务键。
-   * @returns 键存在且包络有效时返回 `true`。
-   */
-  has: (key: string) => boolean;
-  /**
-   * 返回当前命名空间内的业务键快照。
-   * @returns 已移除全局前缀并按字典序排列的新数组；不会自动清理过期项。
-   */
-  keys: () => string[];
-  /**
-   * 扫描当前命名空间并删除全部过期记录。
-   * @returns 本次实际删除的记录数量。
-   * @throws 当发现损坏包络或后端不可用时抛出错误。
-   */
-  pruneExpired: () => number;
-  /**
-   * 删除单个业务键；键不存在时保持幂等。
-   * @param key - 不含全局前缀的非空业务键。
-   */
-  remove: (key: string) => void;
-  /**
-   * 删除业务键以指定文本开头的全部条目，范围仍受全局命名空间限制。
-   * @param keyPrefix - 不含全局前缀的非空业务键前缀。
-   */
-  removeByPrefix: (keyPrefix: string) => void;
-  /**
-   * 编码并写入业务值，可附加惰性清理的 TTL。
-   * @param key - 不含全局前缀的非空业务键。
-   * @param value - 必须受当前 Codec 支持的业务值。
-   * @param options - 可选的单次写入 TTL 与 Base64 混淆开关。
-   * @throws 当键、TTL、业务值或后端写入无效时抛出错误。
-   */
-  set: <Value>(key: string, value: Value, options?: StorageWriteOptions) => void;
-}
-/** Base64 混淆 Codec；只隐藏明文外观，不提供加密、完整性或认证。 */
-export declare const base64StorageCodec: StorageCodec;
-/** 浏览器 localStorage 或自动检测的 uni-app Storage 全局业务入口。 */
-export declare const Local: StorageArea;
-/** 浏览器 sessionStorage 的全局业务入口；uni-app 不提供会话存储。 */
-export declare const Session: StorageArea;
-/**
- * 在首次 Storage 操作前可选配置 `Local` 与 `Session`。
- *
- * @remarks 不调用时在首次操作上使用 `fast__`、JSON Codec 与 `Date.now`。首次激活后只允许以完全相同的值和引用重复调用。若检测到
- * 全局 `uni`，则自动使用其同步 Storage 且只启用 `Local`，否则使用浏览器 `localStorage` 与 `sessionStorage`。
- * `crypto: true` 仅恢复旧版 Base64 混淆行为，不能保护敏感数据。
- * @param options - 可选的全局键前缀、Codec、旧版混淆选项与时钟。
- * @throws 配置非法、重复配置冲突或目标平台 Storage 不可用时抛出错误。
- */
-export declare function configureStorage(options?: StorageConfiguration): void;
-/** 返回全局 Storage 是否已经由应用入口配置。 */
-export declare function isStorageConfigured(): boolean;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/string/index.d.mts

@@ -1,141 +0,0 @@
-//#region src/string/index.d.ts
-/** 查询字符串解析结果；重复键保留为数组，不存在的键读取为 `undefined`。 */
-export type ParsedQueryParameters = Record<string, string | string[] | undefined>;
-/** 大小写与字素分割可接受的显式语言；省略时固定使用 `en-US` 以保持输出稳定。 */
-export type StringLocale = string | readonly string[] | undefined;
-/**
- * 重复执行 URI 组件解码，直到值稳定或达到深度上限。
- *
- * @param value - 不包含 URI 路径语义的编码组件。
- * @param maxDepth - 最大解码次数，默认 `10`。
- * @returns 解码稳定或达到上限后的组件文本。
- * @throws `URIError` 当任一层包含非法百分号序列；深度非法时抛出 `RangeError`。
- */
-export declare function decodeURIComponentRepeatedly(value: string, maxDepth?: number): string;
-/**
- * 解析带 `://` 的绝对 URL、`?query` 或纯查询字符串。
- *
- * @remarks 纯查询字符串值中的未编码 `?` 会作为值内容保留；片段标识及其后内容被忽略。
- * @param input - 完整 URL、带前导问号或不带前导问号的查询文本。
- * @returns 重复键对应字符串数组，空值保留为空字符串。
- */
-export declare function parseQueryString(input: string): ParsedQueryParameters;
-/**
- * 判断文本是否为任意合法 JSON 值，包括标量与 `null`。
- *
- * @param value - 待解析文本；纯空白不视为 JSON。
- * @returns `JSON.parse` 能完整解析时返回 `true`。
- */
-export declare function isValidJson(value: string): boolean;
-/**
- * 按大小写边界、连字符、下划线与空白切分单词。
- *
- * @example `XMLHttp_request` 返回 `["XML", "Http", "request"]`。
- * @param value - 待拆分文本。
- * @returns 删除空项、保持输入顺序的单词数组。
- */
-export declare function splitWords(value: string): string[];
-/**
- * 将首个 Unicode 码点转为大写。
- *
- * @param value - 输入文本；空字符串保持为空。
- * @param locale - 显式语言，默认固定为 `en-US`。
- * @returns 首个 Unicode 码点转换后的文本。
- */
-export declare function upperFirst(value: string, locale?: StringLocale): string;
-/**
- * 将首个 Unicode 码点转为小写。
- *
- * @param value - 输入文本；空字符串保持为空。
- * @param locale - 显式语言，默认固定为 `en-US`。
- * @returns 首个 Unicode 码点转换后的文本。
- */
-export declare function lowerFirst(value: string, locale?: StringLocale): string;
-/**
- * 将文本转换为 camelCase。
- *
- * @param value - 由大小写、连字符、下划线或空白分隔的文本。
- * @param locale - 大小写转换使用的语言，默认固定为 `en-US`。
- * @returns camelCase 文本。
- */
-export declare function camelCase(value: string, locale?: StringLocale): string;
-/**
- * 将文本转换为 PascalCase。
- *
- * @param value - 参数语义与 {@link camelCase} 一致。
- * @param locale - 大小写转换使用的显式语言。
- * @returns PascalCase 文本。
- */
-export declare function pascalCase(value: string, locale?: StringLocale): string;
-/**
- * 将文本转换为 kebab-case。
- *
- * @param value - 参数语义与 {@link camelCase} 一致。
- * @param locale - 大小写转换使用的显式语言。
- * @returns kebab-case 文本。
- */
-export declare function kebabCase(value: string, locale?: StringLocale): string;
-/**
- * 按 Unicode 字素簇截断文本，避免拆开 emoji、组合音标或代理对。
- *
- * @param value - 输入文本。
- * @param maxLength - 保留的最大字素簇数量。
- * @param suffix - 被截断时追加的文本，默认单字符省略号 `…`；不计入上限。
- * @param locale - 字素分割语言，默认固定为 `en-US`。
- * @returns 未超限时返回原字符串，否则返回截断内容与后缀。
- * @throws `RangeError` 当 `maxLength` 不是非负安全整数或 Locale 无效；缺少
- * `Intl.Segmenter` 时抛出 `Error`。
- */
-export declare function truncateGraphemes(value: string, maxLength: number, suffix?: string, locale?: StringLocale): string;
-/**
- * 把文本复制到系统剪贴板。
- *
- * @remarks uni-app 使用 `setClipboardData`；浏览器优先使用 Clipboard API，并在该 API 不可用时
- * 回退到 `document.execCommand("copy")`。平台拒绝访问剪贴板时不会静默忽略错误。
- * @param value - 要复制的文本。
- * @returns 复制完成后兑现的 Promise。
- * @throws `Error` 当运行时没有可用的剪贴板能力或复制失败。
- */
-export declare function copy(value: string): Promise<void>;
-/**
- * 生成随机字符串。
- *
- * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
- * @param length - 字符数量，必须是 0 至 1,000,000 的安全整数。
- * @param alphabet - 不得为空、包含重复字符或超过 2^32 个 Unicode 码点。
- * @returns 由 `alphabet` 中 Unicode 码点组成的随机文本。
- * @throws `RangeError` 当长度或字母表非法。
- */
-export declare function randomString(length: number, alphabet?: string): string;
-/**
- * 生成 RFC 4122 version 4 UUID。
- *
- * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
- * 该 UUID 适合普通唯一标识，不应作为安全令牌或秘密。
- * @returns 小写、带连字符的 UUID v4。
- */
-export declare function generateUuidV4(): string;
-/**
- * 判断字符串是否为 RFC 4122 version 4 UUID。
- *
- * @param value - 待验证文本；十六进制字母大小写均可。
- * @returns 版本位与 Variant 位均正确时返回 `true`。
- */
-export declare function isUuidV4(value: string): boolean;
-/**
- * 转义 HTML 文本上下文中的五个特殊字符。
- *
- * @remarks 这不是 HTML 清洗器，不能让不可信文本安全进入 URL、CSS、脚本或属性名上下文。
- * @param value - 将作为 HTML 文本节点内容的字符串。
- * @returns 转义 `&`、`<`、`>`、双引号与单引号后的文本。
- */
-export declare function escapeHtml(value: string): string;
-/**
- * 把连续 Unicode 空白折叠为单个空格并删除两端空白。
- *
- * @param value - 输入文本。
- * @returns 规范化后的文本；全空白输入返回空字符串。
- */
-export declare function normalizeWhitespace(value: string): string;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/vue/breakpoints.d.mts

@@ -1,21 +0,0 @@
-import { ComputedRef, ShallowRef } from "vue";
-//#region src/vue/breakpoints.d.ts
-/** 断点名称与最小视口宽度的映射。 */
-export type Breakpoints<Key extends string = string> = Readonly<Record<Key, number>>;
-/** `useBreakpoints` 返回的断点状态。 */
-export type UseBreakpointsReturn<Key extends string> = Readonly<Record<Key, Readonly<ShallowRef<boolean>>>> & {
-  /** 返回当前命中的最大断点名称。 */
-  active: () => ComputedRef<Key | "">;
-};
-/**
- * 使用原生 Media Query 创建响应式最小宽度断点。
- *
- * @param breakpoints - 断点名称与非负像素宽度的映射。
- * @returns 每个断点的只读状态和当前最大命中断点。
- * @throws `Error` 当浏览器环境中不存在可用于自动清理的 Vue 响应式作用域。
- * @throws `TypeError` 当断点使用保留名称 `active`。
- * @throws `RangeError` 当断点宽度不是非负有限数值。
- */
-export declare function useBreakpoints<Key extends string>(breakpoints: Breakpoints<Key>): UseBreakpointsReturn<Key>;
-//#endregion
-//# sourceMappingURL=breakpoints.d.mts.map