@pawover/kit 0.0.0-beta.9 → 0.1.0

package/packages/utils/dist/index.d.ts

@@ -0,0 +1,4884 @@
+//#region src/array/index.type.d.ts
+type MatchFunction<T, R = unknown> = (row: T, index: number) => R;
+//#endregion
+//#region src/array/arrayUtil.d.ts
+/**
+ * 数组工具类
+ */
+declare class ArrayUtil {
+  /**
+   * 构造数组
+   * @param candidate 待构造项
+   * @param checkEmpty 是否检查 `undefined` 和 `null`，默认为 `true`
+   * @returns 构造后的数组
+   * @example
+   * ```ts
+   * // 重载 1: checkEmpty = true (默认)
+   * ArrayUtil.cast(1); // [1]
+   * ArrayUtil.cast(null); // []
+   *
+   * // 重载 2: checkEmpty = false
+   * ArrayUtil.cast(null, false); // [null]
+   *
+   * // 通用场景
+   * ArrayUtil.cast([1, 2]); // [1, 2]
+   * ArrayUtil.cast(undefined); // []
+   * ```
+   */
+  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: true): NonNullable<T>[];
+  static cast<T>(candidate: T | T[] | null | undefined, checkEmpty?: false): T[];
+  /**
+   * 获取数组第一项
+   *
+   * @param initialList 初始数组
+   * @param fallback 回退值
+   * @returns 数组第一项，如果为空则返回回退值
+   * @example
+   * ```ts
+   * // 重载 1: 无 fallback
+   * ArrayUtil.first([1, 2]); // 1
+   * ArrayUtil.first([]); // undefined
+   *
+   * // 重载 2: 有 fallback
+   * ArrayUtil.first([], 0); // 0
+   * ```
+   */
+  static first<T>(initialList: readonly T[]): T | undefined;
+  static first<T>(initialList: readonly T[], fallback: T): T;
+  /**
+   * 获取数组最后一项
+   *
+   * @param initialList 初始数组
+   * @param fallback 回退值
+   * @returns 数组最后一项，如果为空则返回回退值
+   * @example
+   * ```ts
+   * // 重载 1: 无 fallback
+   * ArrayUtil.last([1, 2, 3]); // 3
+   * ArrayUtil.last([]); // undefined
+   *
+   * // 重载 2: 有 fallback
+   * ArrayUtil.last([], 0); // 0
+   * ```
+   */
+  static last<T>(initialList: readonly T[]): T | undefined;
+  static last<T>(initialList: readonly T[], fallback: T): T;
+  /**
+   * 数组竞选
+   * - 返回在匹配函数的比较条件中获胜的最终项目，适用于更复杂的最小值/最大值计算
+   *
+   * @param initialList 数组
+   * @param match 匹配函数
+   * @returns 获胜的元素，如果数组为空或参数无效则返回 `null`
+   * @example
+   * ```ts
+   * const list = [1, 10, 5];
+   * ArrayUtil.compete(list, (a, b) => (a > b ? a : b)); // 10
+   * ArrayUtil.compete(list, (a, b) => (a < b ? a : b)); // 1
+   * ```
+   */
+  static compete<T>(initialList: readonly T[], match: (a: T, b: T, index: number) => T): T | null;
+  /**
+   * 统计数组的项目出现次数
+   * - 通过给定的标识符匹配函数，返回一个对象，其中键是回调函数返回的 key 值，每个值是一个整数，表示该 key 出现的次数
+   *
+   * @param initialList 初始数组
+   * @param match 匹配函数
+   * @returns 统计对象
+   * @example
+   * ```ts
+   * const list = ["a", "b", "a", "c"];
+   * ArrayUtil.count(list, (x) => x); // { a: 2, b: 1, c: 1 }
+   *
+   * const users = [{ id: 1, group: "A" }, { id: 2, group: "B" }, { id: 3, group: "A" }];
+   * ArrayUtil.count(users, (u) => u.group); // { A: 2, B: 1 }
+   * ```
+   */
+  static count<T, K extends PropertyKey>(initialList: readonly T[], match: MatchFunction<T, K>): Record<string, number>;
+  /**
+   * 获取数组差集
+   * - 返回在 `initialList` 中存在，但在 `diffList` 中不存在的元素
+   *
+   * @param initialList 初始数组
+   * @param diffList 对比数组
+   * @param match 匹配函数
+   * @returns 差集数组
+   * @example
+   * ```ts
+   * ArrayUtil.difference([1, 2, 3], [2, 3, 4]); // [1]
+   * ArrayUtil.difference([{ id: 1 }, { id: 2 }], [{ id: 2 }], (x) => x.id); // [{ id: 1 }]
+   * ```
+   */
+  static difference<T>(initialList: readonly T[], diffList: readonly T[], match?: (row: T, index: number) => unknown): T[];
+  /**
+   * 获取数组交集
+   * - 返回在 `initialList` 和 `diffList` 中都存在的元素
+   *
+   * @param initialList 初始数组
+   * @param diffList 对比数组
+   * @param match 匹配函数
+   * @returns 交集数组
+   * @example
+   * ```ts
+   * // 重载 1: 按元素本身比较
+   * ArrayUtil.intersection([1, 2], [2, 3]); // [2]
+   *
+   * // 重载 2: 按 match 结果比较
+   * ArrayUtil.intersection([{ id: 1 }, { id: 2 }], [{ id: 2 }], (x) => x.id); // [{ id: 2 }]
+   * ```
+   */
+  static intersection<T>(initialList: readonly T[], diffList: readonly T[]): T[];
+  static intersection<T, D = T>(initialList: readonly T[], diffList: readonly D[], match: MatchFunction<T>): T[];
+  /**
+   * 数组合并
+   * - 如果未提供 `match` 函数，则合并两个数组并去重（Union）
+   * - 如果提供了 `match` 函数，则仅更新 `initialList` 中匹配到的项（Left Join Update），不会追加 `mergeList` 中新增的项
+   *
+   * @param initialList 初始数组
+   * @param mergeList 待合并数组
+   * @param match 匹配函数
+   * @returns 合并后的数组
+   * @example
+   * ```ts
+   * // 重载 1: 基础合并去重
+   * ArrayUtil.merge([1, 2], [2, 3]); // [1, 2, 3]
+   * ArrayUtil.merge([], [1, 2, 3]); // [1, 2, 3]
+   *
+   * // 重载 2: 按条件更新
+   * const source = [{ id: 1, val: "a" }, { id: 2, val: "b" }];
+   * const update = [{ id: 2, val: "new" }, { id: 3, val: "c" }];
+   * ArrayUtil.merge(source, update, (x) => x.id); // [{ id: 1, val: "a" }, { id: 2, val: "new" }] -> id:3 被忽略
+   * ```
+   */
+  static merge<T>(initialList: readonly T[], mergeList: readonly T[]): T[];
+  static merge<T, D = T>(initialList: readonly T[], mergeList: readonly D[], match: MatchFunction<T>): T[];
+  /**
+   * 数组选择
+   * - 一次性应用 `filter` 和 `map` 操作
+   *
+   * @param initialList 初始数组
+   * @param filter filter 函数
+   * @param mapper map 函数
+   * @returns 处理后的新数组
+   * @example
+   * ```ts
+   * const list = [1, 2, 3, 4];
+   *
+   * // 重载 1: 仅过滤
+   * ArrayUtil.pick(list, (n) => n % 2 === 0); // [2, 4]
+   *
+   * // 重载 2: 过滤 + 映射
+   * ArrayUtil.pick(list, (n) => n % 2 === 0, (n) => n * 2); // [4, 8]
+   * ```
+   */
+  static pick<const T>(initialList: readonly T[], filter: (row: T, index: number) => boolean): T[];
+  static pick<const T, K = T>(initialList: readonly T[], filter: (row: T, index: number) => boolean, mapper: (row: T, index: number) => K): K[];
+  /**
+   * 数组项替换
+   * - 在给定的数组中，替换符合匹配函数结果的项目
+   * - 只替换第一个匹配项
+   *
+   * @param initialList 初始数组
+   * @param newItem 替换项
+   * @param match 匹配函数
+   * @returns 替换后的新数组
+   * @example
+   * ```ts
+   * // 重载 1/2: newItem 与数组元素类型兼容
+   * ArrayUtil.replace([1, 2, 3], 4, (n) => n === 2); // [1, 4, 3]
+   *
+   * // 重载 3: newItem 可扩展为新类型
+   * ArrayUtil.replace([1, 2, 3], "X", (n) => n === 2); // [1, "X", 3]
+   * ```
+   */
+  static replace<const T>(initialList: readonly T[], newItem: T, match: MatchFunction<T, boolean>): T[];
+  static replace<const T, K extends T>(initialList: readonly T[], newItem: K, match: MatchFunction<T, boolean>): T[];
+  static replace<const T, K>(initialList: readonly T[], newItem: K, match: MatchFunction<T, boolean>): (T | K)[];
+  /**
+   * 数组项替换并移动
+   * - 在给定的数组中，替换并移动符合匹配函数结果的项目
+   * - 只替换和移动第一个匹配项
+   * - 未匹配时，根据 `position` 在指定位置插入 `newItem`
+   *
+   * @param initialList 初始数组
+   * @param newItem 替换项
+   * @param match 匹配函数
+   * @param position 移动位置，可选 `start` | `end` | 索引位置， 默认为 `end`
+   * @returns
+   * @example
+   * ```ts
+   * ArrayUtil.replaceMove([1, 2, 3, 4], 5, (n) => n === 2, 0); // [5, 1, 3, 4]
+   * ArrayUtil.replaceMove([1, 2, 3, 4], 5, (n) => n === 2, 2); // [1, 3, 5, 4]
+   * ArrayUtil.replaceMove([1, 2, 3, 4], 5, (n) => n === 2, "start"); // [5, 1, 3, 4]
+   * ArrayUtil.replaceMove([1, 2, 3, 4], 5, (n) => n === 2); // [1, 3, 4, 5]
+   * ```
+   */
+  static replaceMove<const T>(initialList: readonly T[], newItem: T, match: MatchFunction<T, boolean>, position?: "start" | "end" | number): T[];
+  /**
+   * 数组切分
+   * - 将数组以指定的长度切分后，组合在高维数组中
+   *
+   * @param initialList 初始数组
+   * @param size 分割尺寸，默认 `10`
+   * @returns 切分后的二维数组
+   * @example
+   * ```ts
+   * ArrayUtil.split([1, 2, 3, 4, 5], 2); // [[1, 2], [3, 4], [5]]
+   * ```
+   */
+  static split<T>(initialList: readonly T[], size?: number): T[][];
+  /**
+   * 数组分组过滤
+   * - 给定一个数组和一个条件，返回一个由两个数组组成的元组，其中第一个数组包含所有满足条件的项，第二个数组包含所有不满足条件的项
+   *
+   * @param initialList 初始数组
+   * @param match 条件匹配函数
+   * @returns [满足条件的项[], 不满足条件的项[]]
+   * @example
+   * ```ts
+   * ArrayUtil.fork([1, 2, 3, 4], (n) => n % 2 === 0); // [[2, 4], [1, 3]]
+   * ```
+   */
+  static fork<T>(initialList: readonly T[], match: MatchFunction<T, boolean>): [T[], T[]];
+  /**
+   * 数组解压
+   * - `ArrayUtil.zip` 的反向操作
+   *
+   * @param arrayList 压缩后的数组
+   * @returns 解压后的二维数组
+   * @example
+   * ```ts
+   * ArrayUtil.unzip([[1, "a"], [2, "b"]]); // [[1, 2], ["a", "b"]]
+   * ```
+   */
+  static unzip<T>(arrayList: readonly (readonly T[])[]): T[][];
+  /**
+   * 数组压缩
+   * - 将多个数组的元素按索引组合成元组
+   *
+   * @param arrays 多个数组
+   * @returns 压缩后的元组数组
+   * @example
+   * ```ts
+   * // 重载 1: 两个数组
+   * ArrayUtil.zip([1, 2], ["a", "b"]); // [[1, "a"], [2, "b"]]
+   *
+   * // 重载 2: 三个数组
+   * ArrayUtil.zip([1, 2], ["a", "b"], [true, false]); // [[1, "a", true], [2, "b", false]]
+   *
+   * // 重载 3: 四个数组
+   * ArrayUtil.zip([1], ["a"], [true], ["x"]); // [[1, "a", true, "x"]]
+   *
+   * // 重载 4: 五个数组
+   * ArrayUtil.zip([1], ["a"], [true], ["x"], [9]); // [[1, "a", true, "x", 9]]
+   *
+   * // 重载 5: 空参数
+   * ArrayUtil.zip(); // []
+   * ```
+   */
+  static zip<T1, T2, T3, T4, T5>(array1: readonly T1[], array2: readonly T2[], array3: readonly T3[], array4: readonly T4[], array5: readonly T5[]): [T1, T2, T3, T4, T5][];
+  static zip<T1, T2, T3, T4>(array1: readonly T1[], array2: readonly T2[], array3: readonly T3[], array4: readonly T4[]): [T1, T2, T3, T4][];
+  static zip<T1, T2, T3>(array1: readonly T1[], array2: readonly T2[], array3: readonly T3[]): [T1, T2, T3][];
+  static zip<T1, T2>(array1: readonly T1[], array2: readonly T2[]): [T1, T2][];
+  static zip(): [];
+  /**
+   * 数组压缩为对象
+   * - 将键数组和值（数组、函数或静态值）组合成对象
+   *
+   * @param keys 键数组
+   * @param values 值数组、生成值的函数或静态值
+   * @returns 生成的对象
+   * @example
+   * ```ts
+   * // 重载 1: 传值数组
+   * ArrayUtil.zipToObject(["a", "b"], [1, 2]); // { a: 1, b: 2 }
+   *
+   * // 重载 2: 传生成函数
+   * ArrayUtil.zipToObject(["a", "b"], (k, i) => k + i); // { a: "a0", b: "b1" }
+   *
+   * // 重载 3: 传静态值
+   * ArrayUtil.zipToObject(["a", "b"], 1); // { a: 1, b: 1 }
+   * ```
+   */
+  static zipToObject<const K extends PropertyKey, const V>(keys: readonly K[], array: readonly V[]): Record<K, V>;
+  static zipToObject<const K extends PropertyKey, const V>(keys: readonly K[], match: MatchFunction<K, V>): Record<K, V>;
+  static zipToObject<const K extends PropertyKey, const V>(keys: readonly K[], value: V): Record<K, V>;
+}
+//#endregion
+//#region src/dateTime/dateTimeUtil.d.ts
+/**
+ * 日期工具类
+ */
+declare class DateTimeUtil {
+  /**
+   * 每秒的毫秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.MILLISECONDS_PER_SECOND; // 1000
+   * ```
+   */
+  static readonly MILLISECONDS_PER_SECOND: number;
+  /**
+   * 每分钟的秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_MINUTE; // 60
+   * ```
+   */
+  static readonly SECOND_PER_MINUTE: number;
+  /**
+   * 每小时的分钟数
+   * @example
+   * ```ts
+   * DateTimeUtil.MINUTE_PER_HOUR; // 60
+   * ```
+   */
+  static readonly MINUTE_PER_HOUR: number;
+  /**
+   * 每小时的秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_HOUR; // 3600
+   * ```
+   */
+  static readonly SECOND_PER_HOUR: number;
+  /**
+   * 每天小时数
+   * @example
+   * ```ts
+   * DateTimeUtil.HOUR_PER_DAY; // 24
+   * ```
+   */
+  static readonly HOUR_PER_DAY: number;
+  /**
+   * 每天秒数
+   * @example
+   * ```ts
+   * DateTimeUtil.SECOND_PER_DAY; // 86400
+   * ```
+   */
+  static readonly SECOND_PER_DAY: number;
+  /**
+   * 每周天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_WEEK; // 7
+   * ```
+   */
+  static readonly DAY_PER_WEEK: number;
+  /**
+   * 每月天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_MONTH; // 30
+   * ```
+   */
+  static readonly DAY_PER_MONTH: number;
+  /**
+   * 每年天数
+   * @example
+   * ```ts
+   * DateTimeUtil.DAY_PER_YEAR; // 365
+   * ```
+   */
+  static readonly DAY_PER_YEAR: number;
+  /**
+   * 每年月数
+   * @example
+   * ```ts
+   * DateTimeUtil.MONTH_PER_YEAR; // 12
+   * ```
+   */
+  static readonly MONTH_PER_YEAR: number;
+  /**
+   * 每年平均周
+   * @example
+   * ```ts
+   * DateTimeUtil.WEEK_PER_YEAR; // 52
+   * ```
+   */
+  static readonly WEEK_PER_YEAR: number;
+  /**
+   * 每月平均周
+   * @example
+   * ```ts
+   * DateTimeUtil.WEEK_PER_MONTH; // 4
+   * ```
+   */
+  static readonly WEEK_PER_MONTH: number;
+  /**
+   * 常用时间格式模板集合
+   *
+   * @example
+   * ```ts
+   * DateTimeUtil.FORMAT.ISO_DATE; // "yyyy-MM-dd"
+   * DateTimeUtil.FORMAT.CN_DATE_TIME; // "yyyy年MM月dd日 HH时mm分ss秒"
+   * ```
+   */
+  static readonly FORMAT: {
+    readonly ISO_DATE: "yyyy-MM-dd";
+    readonly ISO_TIME: "HH:mm:ss";
+    readonly ISO_DATE_TIME: "yyyy-MM-dd HH:mm:ss";
+    readonly ISO_DATE_TIME_MS: "yyyy-MM-dd HH:mm:ss.SSS";
+    readonly ISO_DATETIME_TZ: "yyyy-MM-dd'T'HH:mm:ssXXX";
+    readonly ISO_DATETIME_TZ_MS: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX";
+    readonly US_DATE: "MM/dd/yyyy";
+    readonly US_DATE_TIME: "MM/dd/yyyy HH:mm:ss";
+    readonly US_DATE_SHORT_YEAR: "MM/dd/yy";
+    readonly EU_DATE: "dd/MM/yyyy";
+    readonly EU_DATE_TIME: "dd/MM/yyyy HH:mm:ss";
+    readonly CN_DATE: "yyyy年MM月dd日";
+    readonly CN_DATE_TIME: "yyyy年MM月dd日 HH时mm分ss秒";
+    readonly CN_DATE_WEEKDAY: "yyyy年MM月dd日 EEE";
+    readonly CN_WEEKDAY_FULL: "EEEE";
+    readonly SHORT_DATE: "yy-MM-dd";
+    readonly SHORT_DATE_SLASH: "yy/MM/dd";
+    readonly MONTH_DAY: "MM-dd";
+    readonly MONTH_DAY_CN: "MM月dd日";
+    readonly DATE_WITH_WEEKDAY_SHORT: "yyyy-MM-dd (EEE)";
+    readonly DATE_WITH_WEEKDAY_FULL: "yyyy-MM-dd (EEEE)";
+    readonly TIME_24: "HH:mm:ss";
+    readonly TIME_24_NO_SEC: "HH:mm";
+    readonly TIME_12: "hh:mm:ss a";
+    readonly TIME_12_NO_SEC: "hh:mm a";
+    readonly TIMESTAMP: "yyyyMMddHHmmss";
+    readonly TIMESTAMP_MS: "yyyyMMddHHmmssSSS";
+    readonly RFC2822: "EEE, dd MMM yyyy HH:mm:ss xxx";
+    readonly READABLE_DATE: "MMM dd, yyyy";
+    readonly READABLE_DATE_TIME: "MMM dd, yyyy HH:mm";
+    readonly COMPACT_DATETIME: "yyyyMMdd_HHmmss";
+  };
+  /**
+   * 获取当前时区信息
+   *
+   * @returns 时区信息对象 (UTC偏移和时区名称)
+   * @example
+   * ```ts
+   * DateTimeUtil.getTimeZone(); // { UTC: "UTC+8", timeZone: "Asia/Shanghai" }
+   * ```
+   */
+  static getTimeZone(): {
+    UTC: string;
+    timeZone: string;
+  };
+}
+//#endregion
+//#region src/env/envUtil.d.ts
+/**
+ * 环境检查工具类
+ */
+declare class EnvUtil {
+  private static readonly _isBrowser;
+  private static readonly _isWebWorker;
+  private static readonly _isReactNative;
+  /**
+   * 检测是否处于浏览器环境
+   *
+   * @returns 是否为浏览器环境
+   * @example
+   * ```ts
+   * EnvUtil.isBrowser(); // true: 浏览器, false: Node.js
+   * ```
+   */
+  static isBrowser(): boolean;
+  /**
+   * 检测是否处于 Web Worker 环境
+   *
+   * @returns 是否为 Web Worker 环境
+   * @example
+   * ```ts
+   * EnvUtil.isWebWorker(); // true: Worker, false: 主线程/Node.js
+   * ```
+   */
+  static isWebWorker(): boolean;
+  /**
+   * 检测是否处于 React Native 环境
+   *
+   * @returns 是否为 React Native 环境
+   * @example
+   * ```ts
+   * EnvUtil.isReactNative(); // true: React Native, false: Web/Node.js
+   * ```
+   */
+  static isReactNative(): boolean;
+  /**
+   * 检查是否在 iframe 环境中
+   *
+   * @returns 是否在 iframe 中
+   * @example
+   * ```ts
+   * EnvUtil.isIframe(); // true: 当前页面在 iframe 中
+   * ```
+   */
+  static isIframe(): boolean;
+  /**
+   * 检测当前设备是否为桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为桌面设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 1920
+   * EnvUtil.isDesktop(); // true
+   *
+   * // 自定义阈值
+   * EnvUtil.isDesktop(1440, 13); // 更严格的桌面检测
+   * ```
+   */
+  static isDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为 Windows 桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 Windows 桌面设备
+   * @example
+   * ```ts
+   * // UA contains Windows
+   * EnvUtil.isWindowsDesktop(); // true
+   * ```
+   */
+  static isWindowsDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为 macOS 桌面设备
+   *
+   * @param minWidth - 桌面设备最小宽度（默认 1200px）
+   * @param minScreenSize - 桌面设备最小屏幕尺寸（默认 10英寸）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 macOS 桌面设备
+   * @example
+   * ```ts
+   * // UA contains Macintosh
+   * EnvUtil.isMacOSDesktop(); // true
+   * ```
+   */
+  static isMacOSDesktop(minWidth?: number, minScreenSize?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为移动设备
+   *
+   * @param maxWidth - 移动设备最大宽度（默认 768px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为移动设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 500
+   * EnvUtil.isMobile(); // true
+   * ```
+   */
+  static isMobile(maxWidth?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为IOS移动设备
+   *
+   * @param maxWidth - 移动设备最大宽度（默认 768px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为 iOS 移动设备 (iPhone/iPod)
+   * @example
+   * ```ts
+   * // UA contains iPhone
+   * EnvUtil.isIOSMobile(); // true
+   * ```
+   */
+  static isIOSMobile(maxWidth?: number, dpi?: number): boolean;
+  /**
+   * 检测当前设备是否为平板
+   *
+   * @param minWidth - 平板最小宽度（默认 768px）
+   * @param maxWidth - 平板最大宽度（默认 1200px）
+   * @param dpi - 标准 DPI 基准（默认 160）
+   * @returns 是否为平板设备
+   * @example
+   * ```ts
+   * // 假设 window.innerWidth = 1000
+   * EnvUtil.isTablet(); // true
+   * ```
+   */
+  static isTablet(minWidth?: number, maxWidth?: number, dpi?: number): boolean;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/@pawover+types@0.0.2_@types+react@19.2.15_typescript@6.0.3/node_modules/@pawover/types/dist/index.d.ts
+//#endregion
+//#region src/global.d.ts
+/** 任意对象类型 */
+type AnyObject<K extends PropertyKey = PropertyKey, T = any> = Record<K, T>;
+/** 普通对象类型 */
+type PlainObject<K extends PropertyKey = PropertyKey, T = unknown> = Record<K, T>;
+/** 描述树类型 */
+type TreeLike<T extends AnyObject, CK extends string = "children"> = T & Record<CK, TreeLike<T, CK>[]>;
+/** 描述函数类型 */
+type AnyFunction<P extends any[] = any[], R = any> = (...arg: P) => R;
+/** 描述异步函数类型 */
+type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promise<R>;
+/** 描述生成器函数类型 */
+type AnyGeneratorFunction<P extends any[] = any[], T = any, R = any, N = any> = (...args: P) => Generator<T, R, N>;
+/** 描述异步生成器函数类型 */
+type AnyAsyncGeneratorFunction<P extends any[] = any[], T = any, R = any, N = any> = (...args: P) => AsyncGenerator<T, R, N>;
+/** 描述无返回值函数 */
+//#endregion
+//#region src/function/functionUtil.d.ts
+/**
+ * 函数工具类
+ */
+declare class FunctionUtil {
+  /**
+   *将 Promise 转换为 `[err, result]` 格式，方便 async/await 错误处理
+   *
+   * @param promise 待处理的 Promise
+   * @param errorExt 附加到 error 对象的扩展信息（注意：如果原 error 是 Error 实例，扩展属性可能会覆盖或无法正确合并非枚举属性）
+   * @returns `[err, null]` 或 `[null, data]`
+   * @example
+   * ```ts
+   * const [err, data] = await FunctionUtil.to(someAsyncFunc());
+   * ```
+   */
+  static to<T, U = Error>(promise: Readonly<Promise<T>>, errorExt?: PlainObject): Promise<[U, undefined] | [null, T]>;
+  /**
+   * 将 Arguments 对象转换为数组
+   *
+   * ⚠️ 注意：TypeScript 官方推荐使用 rest parameters (...args) 替代 arguments
+   * 本函数仅用于处理遗留代码或特殊场景（如装饰器中需保留 this 绑定）
+   *
+   * @param args Arguments 对象（必须为类数组对象）
+   * @param start 起始索引（可选，默认为 0）
+   * @returns 转换后的数组，元素类型为 T
+   *
+   * @throws TypeError 如果 args 为 null 或 undefined
+   *
+   * @example
+   * ```ts
+   * // 遗留代码场景
+   * function legacyFn(a: number, b: string) {
+   *   const argsArray = FunctionUtil.toArgs(arguments);
+   *   // argsArray: unknown[]
+   * }
+   *
+   * // 现代替代方案（推荐）
+   * function modernFn(a: number, b: string, ...rest: unknown[]) {
+   *   // rest 已经是数组，无需 toArgs
+   * }
+   *
+   * // 参数截取
+   * function skipFirst(...args: unknown[]) {
+   *   const rest = FunctionUtil.toArgs(arguments, 1);
+   *   // rest: unknown[]，跳过第一个参数
+   * }
+   * ```
+   */
+  static toArgs<T = unknown>(args: IArguments, start?: number | undefined): T[];
+  /**
+   * 将同步或异步函数统一包装为 Promise
+   * - 自动捕获同步异常
+   *
+   * @param fn 返回值可为同步值或 Promise 的函数
+   * @returns 标准化的 Promise
+   *
+   * @example
+   * ```ts
+   * // 同步函数
+   * FunctionUtil.toPromise(() => 42).then(v => console.log(v)); // 42
+   *
+   * // 异步函数
+   * FunctionUtil.toPromise(async () => await fetchData()).then(data => ...);
+   *
+   * // 异常处理
+   * FunctionUtil.toPromise(() => { throw new Error('fail'); }).catch(err => console.error(err)); // 捕获同步异常
+   * ```
+   */
+  static toPromise<T>(fn: () => T | Promise<T>): Promise<T>;
+}
+//#endregion
+//#region src/mime/mimeUtil.d.ts
+/**
+ * MIME 工具类
+ */
+declare class MimeUtil {
+  /**
+   * 标准 MIME 类型常量，用于文件类型标识和 HTTP Content-Type 头部
+   * 基于 IANA 注册标准和浏览器兼容性验证
+   */
+  static readonly MIME: {
+    /** 普通文本文件 */readonly TEXT: "text/plain"; /** 超文本标记语言文档 */
+    readonly HTML: "text/html"; /** 层叠样式表文件 */
+    readonly CSS: "text/css"; /** 逗号分隔值文件（表格数据） */
+    readonly CSV: "text/csv"; /** 制表符分隔值文件 */
+    readonly TSV: "text/tab-separated-values"; /** XML 文档 */
+    readonly XML: "text/xml"; /** XHTML 文档（XML 严格格式的 HTML） */
+    readonly XHTML: "application/xhtml+xml"; /** JavaScript 文件 */
+    readonly JS: "text/javascript"; /** TypeScript 文件 */
+    readonly TS: "text/typescript"; /** Python 文件 */
+    readonly PY: "text/x-python"; /** Shell 脚本 (.sh) */
+    readonly SH: "text/x-sh"; /** C 语言源文件 */
+    readonly C: "text/x-c"; /** C++ 源文件 */
+    readonly CPP: "text/x-c++"; /** C# 源文件 */
+    readonly CSHARP: "text/x-csharp"; /** Java 源文件 */
+    readonly JAVA: "text/x-java"; /** Go 源文件 */
+    readonly GO: "text/x-go"; /** Rust 源文件 */
+    readonly RUST: "text/x-rust"; /** PHP 文件 */
+    readonly PHP: "text/x-php"; /** Ruby 文件 */
+    readonly RUBY: "text/x-ruby"; /** Swift 源文件 */
+    readonly SWIFT: "text/x-swift"; /** YAML 文档 */
+    readonly YAML: "text/vnd.yaml"; /** TOML 文档 */
+    readonly TOML: "text/x-toml"; /** SQL 脚本 */
+    readonly SQL: "text/x-sql"; /** Markdown 格式文档 */
+    readonly MARKDOWN: "text/markdown"; /** 富文本格式文档（.rtf） */
+    readonly RTF: "application/rtf"; /** iCalendar 日历格式（.ics） */
+    readonly CALENDAR: "text/calendar"; /** JPEG 图像（.jpg/.jpeg） */
+    readonly JPEG: "image/jpeg"; /** PNG 图像（无损压缩，支持透明） */
+    readonly PNG: "image/png"; /** GIF 图像（支持动画） */
+    readonly GIF: "image/gif"; /** Windows 位图（.bmp） */
+    readonly BMP: "image/bmp"; /** SVG 向量图形（.svg） */
+    readonly SVG: "image/svg+xml"; /** APNG 动态图像（.apng） */
+    readonly APNG: "image/apng"; /** AVIF 图像（高效压缩） */
+    readonly AVIF: "image/avif"; /** 图标文件格式（.ico） */
+    readonly ICO: "image/vnd.microsoft.icon"; /** WebP 图像（高效压缩） */
+    readonly WEBP: "image/webp"; /** TIFF 图像（.tif/.tiff） */
+    readonly TIFF: "image/tiff"; /** HEIC 图像（高效编码） */
+    readonly HEIC: "image/heic"; /** Adobe Photoshop 文件（.psd） */
+    readonly PSD: "image/vnd.adobe.photoshop"; /** MP3 音频（.mp3） */
+    readonly MP3: "audio/mpeg"; /** AAC 音频（.aac） */
+    readonly AAC: "audio/aac"; /** MIDI 音乐文件（.mid/.midi） */
+    readonly MIDI: "audio/midi"; /** OGG 音频（.oga） */
+    readonly OGG_AUDIO: "audio/ogg"; /** Opus 音频（.opus） */
+    readonly OPUS: "audio/opus"; /** WAV 音频（.wav） */
+    readonly WAV: "audio/wav"; /** RealAudio 音频（.ra/.ram） */
+    readonly REAL_AUDIO: "audio/x-pn-realaudio"; /** MP4 视频（.mp4） */
+    readonly MP4: "video/mp4"; /** MPEG 视频（.mpeg/.mpg） */
+    readonly MPEG: "video/mpeg"; /** OGG 视频（.ogv） */
+    readonly OGG_VIDEO: "video/ogg"; /** AVI 视频（.avi） */
+    readonly AVI: "video/x-msvideo"; /** 3GPP 视频（.3gp） */
+    readonly THREE_GPP: "video/3gpp"; /** 3GPP2 视频（.3g2） */
+    readonly THREE_GPP2: "video/3gpp2"; /** WebM 视频（.webm） */
+    readonly WEBM: "video/webm"; /** PDF 文档 */
+    readonly PDF: "application/pdf"; /** Word 97-2003 文档（.doc） */
+    readonly DOC: "application/msword"; /** Word 2007+ 文档（.docx） */
+    readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; /** Excel 2007+ 工作簿（.xlsx） */
+    readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"; /** 启用宏的Excel工作簿（.xlsm） */
+    readonly XLSM: "application/vnd.ms-excel.sheet.macroEnabled.12"; /** Excel模板文件（.xltx） */
+    readonly XLTX: "application/vnd.openxmlformats-officedocument.spreadsheetml.template"; /** PowerPoint 2007+ 演示文稿（.pptx） */
+    readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation"; /** PowerPoint 97-2003 演示文稿（.ppt） */
+    readonly PPT: "application/vnd.ms-powerpoint"; /** OpenDocument 文本文档（.odt） */
+    readonly ODT: "application/vnd.oasis.opendocument.text"; /** OpenDocument 表格文档（.ods） */
+    readonly ODS: "application/vnd.oasis.opendocument.spreadsheet"; /** OpenDocument 演示文稿（.odp） */
+    readonly ODP: "application/vnd.oasis.opendocument.presentation"; /** EPUB 电子书（.epub） */
+    readonly EPUB: "application/epub+zip"; /** Kindle 电子书（.azw） */
+    readonly AZW: "application/vnd.amazon.ebook"; /** ZIP 压缩文件（.zip） */
+    readonly ZIP: "application/zip"; /** GZIP 压缩文件（.gz） */
+    readonly GZIP: "application/gzip"; /** GZIP 压缩文件（旧格式） */
+    readonly X_GZIP: "application/x-gzip"; /** TAR 归档文件（.tar） */
+    readonly TAR: "application/x-tar"; /** BZip 归档（.bz） */
+    readonly BZIP: "application/x-bzip"; /** BZip2 归档（.bz2） */
+    readonly BZIP2: "application/x-bzip2"; /** 7-Zip 压缩文件（.7z） */
+    readonly SEVEN_Z: "application/x-7z-compressed"; /** RAR 压缩文件（.rar） */
+    readonly RAR: "application/vnd.rar"; /** 通用二进制数据（默认类型） */
+    readonly OCTET_STREAM: "application/octet-stream"; /** JSON 数据格式（.json） */
+    readonly JSON: "application/json"; /** JSON-LD 格式（.jsonld） */
+    readonly LD_JSON: "application/ld+json"; /** Java 归档文件（.jar） */
+    readonly JAR: "application/java-archive"; /** WebAssembly 二进制指令格式（.wasm） */
+    readonly WASM: "application/wasm"; /** MS 嵌入式 OpenType 字体（.eot） */
+    readonly EOT: "application/vnd.ms-fontobject"; /** OpenType 字体（.otf） */
+    readonly OTF: "font/otf"; /** WOFF 字体（.woff） */
+    readonly WOFF: "font/woff"; /** WOFF2 字体（.woff2） */
+    readonly WOFF2: "font/woff2"; /** TrueType 字体（.ttf） */
+    readonly TTF: "font/ttf"; /** Excel 97-2003 工作簿（.xls） */
+    readonly XLS: "application/vnd.ms-excel"; /** Microsoft XPS 文档（.xps） */
+    readonly XPS: "application/vnd.ms-xpsdocument"; /** Word 启用宏文档（.docm） */
+    readonly DOCM: "application/vnd.ms-word.document.macroEnabled.12";
+  };
+}
+//#endregion
+//#region src/number/numberUtil.d.ts
+/**
+ * 数字工具类
+ */
+declare class NumberUtil {
+  /**
+   * 数字区间检查函数
+   *
+   * @param input 待检查数字
+   * @param interval 由两个数字组成的元组 [left, right]
+   * @param includeLeft 是否包含左边界（默认 true）
+   * @param includeRight 是否包含右边界（默认 false）
+   * @returns 是否在区间内
+   * @example
+   * ```ts
+   * NumberUtil.within(5, [1, 10]); // true
+   * NumberUtil.within(1, [1, 10], false); // false
+   * ```
+   */
+  static within(input: number, interval: [number, number], includeLeft?: boolean, includeRight?: boolean): boolean;
+}
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/typed-array.d.ts
+/**
+Matches any [typed array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray), like `Uint8Array` or `Float64Array`.
+
+@category Array
+*/
+type TypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/characters.d.ts
+/**
+Matches any digit as a string ('0'-'9').
+
+@example
+```
+import type {DigitCharacter} from 'type-fest';
+
+const a: DigitCharacter = '0'; // Valid
+// @ts-expect-error
+const b: DigitCharacter = 0; // Invalid
+```
+
+@category Type
+*/
+type DigitCharacter = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-to-intersection.d.ts
+/**
+Convert a union type to an intersection type.
+
+Inspired by [this Stack Overflow answer](https://stackoverflow.com/a/50375286/2172153).
+
+@example
+```
+import type {UnionToIntersection} from 'type-fest';
+
+type Union = {the(): void} | {great(arg: string): void} | {escape: boolean};
+
+type Intersection = UnionToIntersection<Union>;
+//=> {the(): void} & {great(arg: string): void} & {escape: boolean}
+```
+
+@category Type
+*/
+type UnionToIntersection<Union> = (// `extends unknown` is always going to be the case and is used to convert the
+// `Union` into a [distributive conditional
+// type](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).
+Union extends unknown // The union type is used as the only argument to a function since the union
+// of function arguments is an intersection.
+? (distributedUnion: Union) => void // This won't happen.
+: never // Infer the `Intersection` type since TypeScript represents the positional
+// arguments of unions of functions as an intersection of the union.
+) extends ((mergedIntersection: infer Intersection) => void) // The `& Union` is to ensure result of `UnionToIntersection<A | B>` is always assignable to `A | B`
+? Intersection & Union : never;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/keys-of-union.d.ts
+/**
+Create a union of all keys from a given type, even those exclusive to specific union members.
+
+Unlike the native `keyof` keyword, which returns keys present in **all** union members, this type returns keys from **any** member.
+
+@link https://stackoverflow.com/a/49402091
+
+@example
+```
+import type {KeysOfUnion} from 'type-fest';
+
+type A = {
+	common: string;
+	a: number;
+};
+
+type B = {
+	common: string;
+	b: string;
+};
+
+type C = {
+	common: string;
+	c: boolean;
+};
+
+type Union = A | B | C;
+
+type CommonKeys = keyof Union;
+//=> 'common'
+
+type AllKeys = KeysOfUnion<Union>;
+//=> 'common' | 'a' | 'b' | 'c'
+```
+
+@category Object
+*/
+type KeysOfUnion<ObjectType> = // Hack to fix https://github.com/sindresorhus/type-fest/issues/1008
+keyof UnionToIntersection<ObjectType extends unknown ? Record<keyof ObjectType, never> : never>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-any.d.ts
+/**
+Returns a boolean for whether the given type is `any`.
+
+@link https://stackoverflow.com/a/49928360/1490091
+
+Useful in type utilities, such as disallowing `any`s to be passed to a function.
+
+@example
+```
+import type {IsAny} from 'type-fest';
+
+const typedObject = {a: 1, b: 2} as const;
+const anyObject: any = {a: 1, b: 2};
+
+function get<O extends (IsAny<O> extends true ? {} : Record<string, number>), K extends keyof O = keyof O>(object: O, key: K) {
+	return object[key];
+}
+
+const typedA = get(typedObject, 'a');
+//=> 1
+
+const anyA = get(anyObject, 'a');
+//=> any
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsAny<T> = 0 extends 1 & NoInfer<T> ? true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-optional-key-of.d.ts
+/**
+Returns a boolean for whether the given key is an optional key of type.
+
+This is useful when writing utility types or schema validators that need to differentiate `optional` keys.
+
+@example
+```
+import type {IsOptionalKeyOf} from 'type-fest';
+
+type User = {
+	name: string;
+	surname: string;
+
+	luckyNumber?: number;
+};
+
+type Admin = {
+	name: string;
+	surname?: string;
+};
+
+type T1 = IsOptionalKeyOf<User, 'luckyNumber'>;
+//=> true
+
+type T2 = IsOptionalKeyOf<User, 'name'>;
+//=> false
+
+type T3 = IsOptionalKeyOf<User, 'name' | 'luckyNumber'>;
+//=> boolean
+
+type T4 = IsOptionalKeyOf<User | Admin, 'name'>;
+//=> false
+
+type T5 = IsOptionalKeyOf<User | Admin, 'surname'>;
+//=> boolean
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsOptionalKeyOf<Type extends object, Key extends keyof Type> = IsAny<Type | Key> extends true ? never : Key extends keyof Type ? Type extends Record<Key, Type[Key]> ? false : true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/optional-keys-of.d.ts
+/**
+Extract all optional keys from the given type.
+
+This is useful when you want to create a new type that contains different type values for the optional keys only.
+
+@example
+```
+import type {OptionalKeysOf, Except} from 'type-fest';
+
+type User = {
+	name: string;
+	surname: string;
+
+	luckyNumber?: number;
+};
+
+const REMOVE_FIELD = Symbol('remove field symbol');
+type UpdateOperation<Entity extends object> = Except<Partial<Entity>, OptionalKeysOf<Entity>> & {
+	[Key in OptionalKeysOf<Entity>]?: Entity[Key] | typeof REMOVE_FIELD;
+};
+
+const update1: UpdateOperation<User> = {
+	name: 'Alice',
+};
+
+const update2: UpdateOperation<User> = {
+	name: 'Bob',
+	luckyNumber: REMOVE_FIELD,
+};
+```
+
+@category Utilities
+*/
+type OptionalKeysOf<Type extends object> = Type extends unknown // For distributing `Type`
+? (keyof { [Key in keyof Type as IsOptionalKeyOf<Type, Key> extends false ? never : Key]: never }) & keyof Type // Intersect with `keyof Type` to ensure result of `OptionalKeysOf<Type>` is always assignable to `keyof Type`
+: never;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/required-keys-of.d.ts
+/**
+Extract all required keys from the given type.
+
+This is useful when you want to create a new type that contains different type values for the required keys only or use the list of keys for validation purposes, etc...
+
+@example
+```
+import type {RequiredKeysOf} from 'type-fest';
+
+declare function createValidation<
+	Entity extends object,
+	Key extends RequiredKeysOf<Entity> = RequiredKeysOf<Entity>,
+>(field: Key, validator: (value: Entity[Key]) => boolean): (entity: Entity) => boolean;
+
+type User = {
+	name: string;
+	surname: string;
+	luckyNumber?: number;
+};
+
+const validator1 = createValidation<User>('name', value => value.length < 25);
+const validator2 = createValidation<User>('surname', value => value.length < 25);
+
+// @ts-expect-error
+const validator3 = createValidation<User>('luckyNumber', value => value > 0);
+// Error: Argument of type '"luckyNumber"' is not assignable to parameter of type '"name" | "surname"'.
+```
+
+@category Utilities
+*/
+type RequiredKeysOf<Type extends object> = Type extends unknown // For distributing `Type`
+? Exclude<keyof Type, OptionalKeysOf<Type>> : never;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-never.d.ts
+/**
+Returns a boolean for whether the given type is `never`.
+
+@link https://github.com/microsoft/TypeScript/issues/31751#issuecomment-498526919
+@link https://stackoverflow.com/a/53984913/10292952
+@link https://www.zhenghao.io/posts/ts-never
+
+Useful in type utilities, such as checking if something does not occur.
+
+@example
+```
+import type {IsNever, And} from 'type-fest';
+
+type A = IsNever<never>;
+//=> true
+
+type B = IsNever<any>;
+//=> false
+
+type C = IsNever<unknown>;
+//=> false
+
+type D = IsNever<never[]>;
+//=> false
+
+type E = IsNever<object>;
+//=> false
+
+type F = IsNever<string>;
+//=> false
+```
+
+@example
+```
+import type {IsNever} from 'type-fest';
+
+type IsTrue<T> = T extends true ? true : false;
+
+// When a distributive conditional is instantiated with `never`, the entire conditional results in `never`.
+type A = IsTrue<never>;
+//=> never
+
+// If you don't want that behaviour, you can explicitly add an `IsNever` check before the distributive conditional.
+type IsTrueFixed<T> =
+	IsNever<T> extends true ? false : T extends true ? true : false;
+
+type B = IsTrueFixed<never>;
+//=> false
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsNever<T> = [T] extends [never] ? true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/if.d.ts
+/**
+An if-else-like type that resolves depending on whether the given `boolean` type is `true` or `false`.
+
+Use-cases:
+- You can use this in combination with `Is*` types to create an if-else-like experience. For example, `If<IsAny<any>, 'is any', 'not any'>`.
+
+Note:
+- Returns a union of if branch and else branch if the given type is `boolean` or `any`. For example, `If<boolean, 'Y', 'N'>` will return `'Y' | 'N'`.
+- Returns the else branch if the given type is `never`. For example, `If<never, 'Y', 'N'>` will return `'N'`.
+
+@example
+```
+import type {If} from 'type-fest';
+
+type A = If<true, 'yes', 'no'>;
+//=> 'yes'
+
+type B = If<false, 'yes', 'no'>;
+//=> 'no'
+
+type C = If<boolean, 'yes', 'no'>;
+//=> 'yes' | 'no'
+
+type D = If<any, 'yes', 'no'>;
+//=> 'yes' | 'no'
+
+type E = If<never, 'yes', 'no'>;
+//=> 'no'
+```
+
+@example
+```
+import type {If, IsAny, IsNever} from 'type-fest';
+
+type A = If<IsAny<unknown>, 'is any', 'not any'>;
+//=> 'not any'
+
+type B = If<IsNever<never>, 'is never', 'not never'>;
+//=> 'is never'
+```
+
+@example
+```
+import type {If, IsEqual} from 'type-fest';
+
+type IfEqual<T, U, IfBranch, ElseBranch> = If<IsEqual<T, U>, IfBranch, ElseBranch>;
+
+type A = IfEqual<string, string, 'equal', 'not equal'>;
+//=> 'equal'
+
+type B = IfEqual<string, number, 'equal', 'not equal'>;
+//=> 'not equal'
+```
+
+Note: Sometimes using the `If` type can make an implementation non–tail-recursive, which can impact performance. In such cases, it’s better to use a conditional directly. Refer to the following example:
+
+@example
+```
+import type {If, IsEqual, StringRepeat} from 'type-fest';
+
+type HundredZeroes = StringRepeat<'0', 100>;
+
+// The following implementation is not tail recursive
+type Includes<S extends string, Char extends string> =
+	S extends `${infer First}${infer Rest}`
+		? If<IsEqual<First, Char>,
+			'found',
+			Includes<Rest, Char>>
+		: 'not found';
+
+// Hence, instantiations with long strings will fail
+// @ts-expect-error
+type Fails = Includes<HundredZeroes, '1'>;
+//           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Error: Type instantiation is excessively deep and possibly infinite.
+
+// However, if we use a simple conditional instead of `If`, the implementation becomes tail-recursive
+type IncludesWithoutIf<S extends string, Char extends string> =
+	S extends `${infer First}${infer Rest}`
+		? IsEqual<First, Char> extends true
+			? 'found'
+			: IncludesWithoutIf<Rest, Char>
+		: 'not found';
+
+// Now, instantiations with long strings will work
+type Works = IncludesWithoutIf<HundredZeroes, '1'>;
+//=> 'not found'
+```
+
+@category Type Guard
+@category Utilities
+*/
+type If<Type extends boolean, IfBranch, ElseBranch> = IsNever<Type> extends true ? ElseBranch : Type extends true ? IfBranch : ElseBranch;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/unknown-array.d.ts
+/**
+Represents an array with `unknown` value.
+
+Use case: You want a type that all arrays can be assigned to, but you don't care about the value.
+
+@example
+```
+import type {UnknownArray} from 'type-fest';
+
+type IsArray<T> = T extends UnknownArray ? true : false;
+
+type A = IsArray<['foo']>;
+//=> true
+
+type B = IsArray<readonly number[]>;
+//=> true
+
+type C = IsArray<string>;
+//=> false
+```
+
+@category Type
+@category Array
+*/
+type UnknownArray = readonly unknown[];
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/type.d.ts
+/**
+Returns a boolean for whether A is false.
+
+@example
+```
+type A = Not<true>;
+//=> false
+
+type B = Not<false>;
+//=> true
+```
+*/
+type Not<A extends boolean> = A extends true ? false : A extends false ? true : never;
+/**
+An if-else-like type that resolves depending on whether the given type is `any` or `never`.
+
+@example
+```
+// When `T` is a NOT `any` or `never` (like `string`) => Returns `IfNotAnyOrNever` branch
+type A = IfNotAnyOrNever<string, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+//=> 'VALID'
+
+// When `T` is `any` => Returns `IfAny` branch
+type B = IfNotAnyOrNever<any, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+//=> 'IS_ANY'
+
+// When `T` is `never` => Returns `IfNever` branch
+type C = IfNotAnyOrNever<never, 'VALID', 'IS_ANY', 'IS_NEVER'>;
+//=> 'IS_NEVER'
+```
+
+Note: Wrapping a tail-recursive type with `IfNotAnyOrNever` makes the implementation non-tail-recursive. To fix this, move the recursion into a helper type. Refer to the following example:
+
+@example
+```ts
+import type {StringRepeat} from 'type-fest';
+
+type NineHundredNinetyNineSpaces = StringRepeat<' ', 999>;
+
+// The following implementation is not tail recursive
+type TrimLeft<S extends string> = IfNotAnyOrNever<S, S extends ` ${infer R}` ? TrimLeft<R> : S>;
+
+// Hence, instantiations with long strings will fail
+// @ts-expect-error
+type T1 = TrimLeft<NineHundredNinetyNineSpaces>;
+//        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+// Error: Type instantiation is excessively deep and possibly infinite.
+
+// To fix this, move the recursion into a helper type
+type TrimLeftOptimised<S extends string> = IfNotAnyOrNever<S, _TrimLeftOptimised<S>>;
+
+type _TrimLeftOptimised<S extends string> = S extends ` ${infer R}` ? _TrimLeftOptimised<R> : S;
+
+type T2 = TrimLeftOptimised<NineHundredNinetyNineSpaces>;
+//=> ''
+```
+*/
+type IfNotAnyOrNever<T, IfNotAnyOrNever, IfAny = any, IfNever = never> = If<IsAny<T>, IfAny, If<IsNever<T>, IfNever, IfNotAnyOrNever>>;
+/**
+Indicates the value of `exactOptionalPropertyTypes` compiler option.
+*/
+type IsExactOptionalPropertyTypesEnabled = [(string | undefined)?] extends [string?] ? false : true;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/array.d.ts
+/**
+Transforms a tuple type by replacing it's rest element with a single element that has the same type as the rest element, while keeping all the non-rest elements intact.
+
+@example
+```
+type A = CollapseRestElement<[string, string, ...number[]]>;
+//=> [string, string, number]
+
+type B = CollapseRestElement<[...string[], number, number]>;
+//=> [string, number, number]
+
+type C = CollapseRestElement<[string, string, ...Array<number | bigint>]>;
+//=> [string, string, number | bigint]
+
+type D = CollapseRestElement<[string, number]>;
+//=> [string, number]
+```
+
+Note: Optional modifiers (`?`) are removed from elements unless the `exactOptionalPropertyTypes` compiler option is disabled. When disabled, there's an additional `| undefined` for optional elements.
+
+@example
+```
+// `exactOptionalPropertyTypes` enabled
+type A = CollapseRestElement<[string?, string?, ...number[]]>;
+//=> [string, string, number]
+
+// `exactOptionalPropertyTypes` disabled
+type B = CollapseRestElement<[string?, string?, ...number[]]>;
+//=> [string | undefined, string | undefined, number]
+```
+*/
+type CollapseRestElement<TArray extends UnknownArray> = IfNotAnyOrNever<TArray, _CollapseRestElement<TArray>>;
+type _CollapseRestElement<TArray extends UnknownArray, ForwardAccumulator extends UnknownArray = [], BackwardAccumulator extends UnknownArray = []> = TArray extends UnknownArray // For distributing `TArray`
+? keyof TArray & `${number}` extends never // Enters this branch, if `TArray` is empty (e.g., []),
+// or `TArray` contains no non-rest elements preceding the rest element (e.g., `[...string[]]` or `[...string[], string]`).
+? TArray extends readonly [...infer Rest, infer Last] ? _CollapseRestElement<Rest, ForwardAccumulator, [Last, ...BackwardAccumulator]> // Accumulate elements that are present after the rest element.
+: TArray extends readonly [] ? [...ForwardAccumulator, ...BackwardAccumulator] : [...ForwardAccumulator, TArray[number], ...BackwardAccumulator] // Add the rest element between the accumulated elements.
+: TArray extends readonly [(infer First)?, ...infer Rest] ? _CollapseRestElement<Rest, [...ForwardAccumulator, '0' extends OptionalKeysOf<TArray> ? If<IsExactOptionalPropertyTypesEnabled, First, First | undefined> // Add `| undefined` for optional elements, if `exactOptionalPropertyTypes` is disabled.
+: First], BackwardAccumulator> : never // Should never happen, since `[(infer First)?, ...infer Rest]` is a top-type for arrays.
+: never; // Should never happen
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/numeric.d.ts
+type _Numeric = number | bigint;
+type Zero = 0 | 0n;
+/**
+Matches the hidden `Infinity` type.
+
+Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/32277) if you want to have this type as a built-in in TypeScript.
+
+@see {@link NegativeInfinity}
+
+@category Numeric
+*/
+// See https://github.com/microsoft/TypeScript/issues/31752
+// eslint-disable-next-line no-loss-of-precision
+/**
+A negative `number`/`bigint` (`-∞ < x < 0`)
+
+Use-case: Validating and documenting parameters.
+
+@see {@link NegativeInteger}
+@see {@link NonNegative}
+
+@category Numeric
+*/
+type Negative<T extends _Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never;
+/**
+Returns a boolean for whether the given number is a negative number.
+
+@see {@link Negative}
+
+@example
+```
+import type {IsNegative} from 'type-fest';
+
+type ShouldBeFalse = IsNegative<1>;
+type ShouldBeTrue = IsNegative<-1>;
+```
+
+@category Numeric
+*/
+type IsNegative<T extends _Numeric> = T extends Negative<T> ? true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/tagged-tag@1.0.0/node_modules/tagged-tag/index.d.ts
+declare const tag: unique symbol;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/tagged.d.ts
+// eslint-disable-next-line type-fest/require-exported-types
+type TagContainer<Token> = {
+  readonly [tag]: Token;
+};
+type Tag<Token extends PropertyKey, TagMetadata> = TagContainer<{ [K in Token]: TagMetadata }>;
+/**
+Create a [tagged type](https://medium.com/@KevinBGreene/surviving-the-typescript-ecosystem-branding-and-type-tagging-6cf6e516523d) that can support [multiple tags](https://github.com/sindresorhus/type-fest/issues/665) and [per-tag metadata](https://medium.com/@ethanresnick/advanced-typescript-tagged-types-improved-with-type-level-metadata-5072fc125fcf).
+
+A type returned by `Tagged` can be passed to `Tagged` again, to create a type with multiple tags.
+
+A tag's name is usually a string (and must be a string, number, or symbol), but each application of a tag can also contain an arbitrary type as its "metadata". See {@link GetTagMetadata} for examples and explanation.
+
+A type `A` returned by `Tagged` is assignable to another type `B` returned by `Tagged` if and only if:
+  - the underlying (untagged) type of `A` is assignable to the underlying type of `B`;
+	- `A` contains at least all the tags `B` has;
+	- and the metadata type for each of `A`'s tags is assignable to the metadata type of `B`'s corresponding tag.
+
+There have been several discussions about adding similar features to TypeScript. Unfortunately, nothing has (yet) moved forward:
+	- [Microsoft/TypeScript#202](https://github.com/microsoft/TypeScript/issues/202)
+	- [Microsoft/TypeScript#4895](https://github.com/microsoft/TypeScript/issues/4895)
+	- [Microsoft/TypeScript#33290](https://github.com/microsoft/TypeScript/pull/33290)
+
+@example
+```
+import type {Tagged} from 'type-fest';
+
+type AccountNumber = Tagged<number, 'AccountNumber'>;
+type AccountBalance = Tagged<number, 'AccountBalance'>;
+
+function createAccountNumber(): AccountNumber {
+	// As you can see, casting from a `number` (the underlying type being tagged) is allowed.
+	return 2 as AccountNumber;
+}
+
+declare function getMoneyForAccount(accountNumber: AccountNumber): AccountBalance;
+
+// This will compile successfully.
+getMoneyForAccount(createAccountNumber());
+
+// But this won't, because it has to be explicitly passed as an `AccountNumber` type!
+// Critically, you could not accidentally use an `AccountBalance` as an `AccountNumber`.
+// @ts-expect-error
+getMoneyForAccount(2);
+
+// You can also use tagged values like their underlying, untagged type.
+// I.e., this will compile successfully because an `AccountNumber` can be used as a regular `number`.
+// In this sense, the underlying base type is not hidden, which differentiates tagged types from opaque types in other languages.
+const accountNumber = createAccountNumber() + 2;
+```
+
+@example
+```
+import type {Tagged} from 'type-fest';
+
+// You can apply multiple tags to a type by using `Tagged` repeatedly.
+type Url = Tagged<string, 'URL'>;
+type SpecialCacheKey = Tagged<Url, 'SpecialCacheKey'>;
+
+// You can also pass a union of tag names, so this is equivalent to the above, although it doesn't give you the ability to assign distinct metadata to each tag.
+type SpecialCacheKey2 = Tagged<string, 'URL' | 'SpecialCacheKey'>;
+```
+
+@category Type
+*/
+type Tagged<Type, TagName extends PropertyKey, TagMetadata = never> = Type & Tag<TagName, TagMetadata>;
+/**
+Get the untagged portion of a tagged type created with `Tagged`.
+
+Why is this necessary?
+
+1. Use a `Tagged` type as object keys
+2. Prevent TS4058 error: "Return type of exported function has or is using name X from external module Y but cannot be named"
+
+@example
+```
+import type {Tagged, UnwrapTagged} from 'type-fest';
+
+type AccountType = Tagged<'SAVINGS' | 'CHECKING', 'AccountType'>;
+
+const moneyByAccountType: Record<UnwrapTagged<AccountType>, number> = {
+	SAVINGS: 99,
+	CHECKING: 0.1,
+};
+
+// Without UnwrapTagged, the following expression would throw a type error.
+const money = moneyByAccountType.SAVINGS; // TS error: Property 'SAVINGS' does not exist
+
+// Attempting to pass a non-Tagged type to UnwrapTagged will raise a type error.
+// @ts-expect-error
+type WontWork = UnwrapTagged<string>;
+```
+
+@category Type
+*/
+type UnwrapTagged<TaggedType extends Tag<PropertyKey, any>> = RemoveAllTags<TaggedType>;
+type RemoveAllTags<T> = T extends Tag<PropertyKey, any> ? { [ThisTag in keyof T[typeof tag]]: T extends Tagged<infer Type, ThisTag, T[typeof tag][ThisTag]> ? RemoveAllTags<Type> : never }[keyof T[typeof tag]] : T;
+/**
+Note: The `Opaque` type is deprecated in favor of `Tagged`.
+
+Attach a "tag" to an arbitrary type. This allows you to create distinct types, that aren't assignable to one another, for runtime values that would otherwise have the same type. (See examples.)
+
+The generic type parameters can be anything.
+
+Note that `Opaque` is somewhat of a misnomer here, in that, unlike [some alternative implementations](https://github.com/microsoft/TypeScript/issues/4895#issuecomment-425132582), the original, untagged type is not actually hidden. (E.g., functions that accept the untagged type can still be called with the "opaque" version -- but not vice-versa.)
+
+Also note that this implementation is limited to a single tag. If you want to allow multiple tags, use `Tagged` instead.
+
+[Read more about tagged types.](https://medium.com/@KevinBGreene/surviving-the-typescript-ecosystem-branding-and-type-tagging-6cf6e516523d)
+
+There have been several discussions about adding similar features to TypeScript. Unfortunately, nothing has (yet) moved forward:
+	- [Microsoft/TypeScript#202](https://github.com/microsoft/TypeScript/issues/202)
+	- [Microsoft/TypeScript#15408](https://github.com/Microsoft/TypeScript/issues/15408)
+	- [Microsoft/TypeScript#15807](https://github.com/Microsoft/TypeScript/issues/15807)
+
+@example
+```
+import type {Opaque} from 'type-fest';
+
+type AccountNumber = Opaque<number, 'AccountNumber'>;
+type AccountBalance = Opaque<number, 'AccountBalance'>;
+
+// The `Token` parameter allows the compiler to differentiate between types, whereas "unknown" will not. For example, consider the following structures:
+type ThingOne = Opaque<string>;
+type ThingTwo = Opaque<string>;
+
+// To the compiler, these types are allowed to be cast to each other as they have the same underlying type. They are both `string & { __opaque__: unknown }`.
+// To avoid this behaviour, you would instead pass the "Token" parameter, like so.
+type NewThingOne = Opaque<string, 'ThingOne'>;
+type NewThingTwo = Opaque<string, 'ThingTwo'>;
+
+// Now they're completely separate types, so the following will fail to compile.
+function createNewThingOne(): NewThingOne {
+	// As you can see, casting from a string is still allowed. However, you may not cast NewThingOne to NewThingTwo, and vice versa.
+	return 'new thing one' as NewThingOne;
+}
+
+// This will fail to compile, as they are fundamentally different types.
+// @ts-expect-error
+const thingTwo = createNewThingOne() as NewThingTwo;
+
+// Here's another example of opaque typing.
+function createAccountNumber(): AccountNumber {
+	return 2 as AccountNumber;
+}
+
+declare function getMoneyForAccount(accountNumber: AccountNumber): AccountBalance;
+
+// This will compile successfully.
+getMoneyForAccount(createAccountNumber());
+
+// But this won't, because it has to be explicitly passed as an `AccountNumber` type.
+// @ts-expect-error
+getMoneyForAccount(2);
+
+// You can use opaque values like they aren't opaque too.
+const accountNumber = createAccountNumber();
+
+// This will compile successfully.
+const newAccountNumber = accountNumber + 2;
+
+// As a side note, you can (and should) use recursive types for your opaque types to make them stronger and hopefully easier to type.
+type Person = {
+	id: Opaque<number, Person>;
+	name: string;
+};
+```
+
+@category Type
+@deprecated Use {@link Tagged} instead
+*/
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-literal.d.ts
+/**
+Returns a boolean for whether the given type is a `string` [literal type](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#literal-types).
+
+Useful for:
+	- providing strongly-typed string manipulation functions
+	- constraining strings to be a string literal
+	- type utilities, such as when constructing parsers and ASTs
+
+The implementation of this type is inspired by the trick mentioned in this [StackOverflow answer](https://stackoverflow.com/a/68261113/420747).
+
+@example
+```
+import type {IsStringLiteral} from 'type-fest';
+
+type CapitalizedString<T extends string> = IsStringLiteral<T> extends true ? Capitalize<T> : string;
+
+// https://github.com/yankeeinlondon/native-dash/blob/master/src/capitalize.ts
+function capitalize<T extends Readonly<string>>(input: T): CapitalizedString<T> {
+	return (input.slice(0, 1).toUpperCase() + input.slice(1)) as CapitalizedString<T>;
+}
+
+const output = capitalize('hello, world!');
+//=> 'Hello, world!'
+```
+
+@example
+```
+// String types with infinite set of possible values return `false`.
+
+import type {IsStringLiteral} from 'type-fest';
+
+type AllUppercaseStrings = IsStringLiteral<Uppercase<string>>;
+//=> false
+
+type StringsStartingWithOn = IsStringLiteral<`on${string}`>;
+//=> false
+
+// This behaviour is particularly useful in string manipulation utilities, as infinite string types often require separate handling.
+
+type Length<S extends string, Counter extends never[] = []> =
+	IsStringLiteral<S> extends false
+		? number // return `number` for infinite string types
+		: S extends `${string}${infer Tail}`
+			? Length<Tail, [...Counter, never]>
+			: Counter['length'];
+
+type L1 = Length<Lowercase<string>>;
+//=> number
+
+type L2 = Length<`${number}`>;
+//=> number
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsStringLiteral<S> = IfNotAnyOrNever<S, _IsStringLiteral<CollapseLiterals<S extends TagContainer<any> ? UnwrapTagged<S> : S>>, false, false>;
+type _IsStringLiteral<S> = // If `T` is an infinite string type (e.g., `on${string}`), `Record<T, never>` produces an index signature,
+// and since `{}` extends index signatures, the result becomes `false`.
+S extends string ? {} extends Record<S, never> ? false : true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/tuple-of.d.ts
+/**
+Create a tuple type of the specified length with elements of the specified type.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type RGB = TupleOf<3, number>;
+//=> [number, number, number]
+
+type Line = TupleOf<2, {x: number; y: number}>;
+//=> [{x: number; y: number}, {x: number; y: number}]
+
+type TicTacToeBoard = TupleOf<3, TupleOf<3, 'X' | 'O' | null>>;
+//=> [['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null], ['X' | 'O' | null, 'X' | 'O' | null, 'X' | 'O' | null]]
+```
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type Range<Start extends number, End extends number> = Exclude<keyof TupleOf<End>, keyof TupleOf<Start>>;
+
+type ZeroToFour = Range<0, 5>;
+//=> '0' | '1' | '2' | '3' | '4'
+
+type ThreeToEight = Range<3, 9>;
+//=> '3' | '4' | '5' | '6' | '7' | '8'
+```
+
+Note: If the specified length is the non-literal `number` type, the result will not be a tuple but a regular array.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type StringArray = TupleOf<number, string>;
+//=> string[]
+```
+
+Note: If the type for elements is not specified, it will default to `unknown`.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type UnknownTriplet = TupleOf<3>;
+//=> [unknown, unknown, unknown]
+```
+
+Note: If the specified length is negative, the result will be an empty tuple.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type EmptyTuple = TupleOf<-3, string>;
+//=> []
+```
+
+Note: If the specified length has a decimal part, the decimal part will be ignored.
+
+@example
+```
+import type {TupleOf} from 'type-fest';
+
+type DecimalLength = TupleOf<3.5, string>;
+//=> [string, string, string]
+```
+
+Note: If you need a readonly tuple, simply wrap this type with `Readonly`, for example, to create `readonly [number, number, number]` use `Readonly<TupleOf<3, number>>`.
+
+@category Array
+*/
+type TupleOf<Length extends number, Fill = unknown> = IfNotAnyOrNever<Length, _TupleOf<If<IsNegative<Length>, 0, Length>, Fill>, Fill[], []>;
+type _TupleOf<Length extends number, Fill> = number extends Length ? Fill[] : BuildTupleDigitByDigit<`${Length}`, Fill>;
+type BuildTupleDigitByDigit<Length extends string, Fill, Accumulator extends UnknownArray = []> = Length extends `${infer First extends DigitCharacter}${infer Rest}` ? BuildTupleDigitByDigit<Rest, Fill, [...RepeatTupleTenTimes<Accumulator>, ...DigitTupleOf<First, Fill>]> : Accumulator;
+type RepeatTupleTenTimes<Tuple extends UnknownArray> = [...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple, ...Tuple];
+type DigitTupleOf<Digit extends DigitCharacter, Fill> = [[], [Fill], [Fill, Fill], [Fill, Fill, Fill], [Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill], [Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill, Fill]][Digit];
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/simplify.d.ts
+/**
+Useful to flatten the type output to improve type hints shown in editors. And also to transform an interface into a type to aide with assignability.
+
+@example
+```
+import type {Simplify} from 'type-fest';
+
+type PositionProps = {
+	top: number;
+	left: number;
+};
+
+type SizeProps = {
+	width: number;
+	height: number;
+};
+
+// In your editor, hovering over `Props` will show a flattened object with all the properties.
+type Props = Simplify<PositionProps & SizeProps>;
+```
+
+Sometimes it is desired to pass a value as a function argument that has a different type. At first inspection it may seem assignable, and then you discover it is not because the `value`'s type definition was defined as an interface. In the following example, `fn` requires an argument of type `Record<string, unknown>`. If the value is defined as a literal, then it is assignable. And if the `value` is defined as type using the `Simplify` utility the value is assignable.  But if the `value` is defined as an interface, it is not assignable because the interface is not sealed and elsewhere a non-string property could be added to the interface.
+
+If the type definition must be an interface (perhaps it was defined in a third-party npm package), then the `value` can be defined as `const value: Simplify<SomeInterface> = ...`. Then `value` will be assignable to the `fn` argument.  Or the `value` can be cast as `Simplify<SomeInterface>` if you can't re-declare the `value`.
+
+@example
+```
+import type {Simplify} from 'type-fest';
+
+interface SomeInterface {
+	foo: number;
+	bar?: string;
+	baz: number | undefined;
+}
+
+type SomeType = {
+	foo: number;
+	bar?: string;
+	baz: number | undefined;
+};
+
+const literal = {foo: 123, bar: 'hello', baz: 456};
+const someType: SomeType = literal;
+const someInterface: SomeInterface = literal;
+
+declare function fn(object: Record<string, unknown>): void;
+
+fn(literal); // Good: literal object type is sealed
+fn(someType); // Good: type is sealed
+// @ts-expect-error
+fn(someInterface); // Error: Index signature for type 'string' is missing in type 'someInterface'. Because `interface` can be re-opened
+fn(someInterface as Simplify<SomeInterface>); // Good: transform an `interface` into a `type`
+```
+
+@link https://github.com/microsoft/TypeScript/issues/15300
+@see {@link SimplifyDeep}
+@category Object
+*/
+type Simplify<T> = { [KeyType in keyof T]: T[KeyType] } & {};
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/is-equal.d.ts
+/**
+Returns a boolean for whether the two given types are equal.
+
+@link https://github.com/microsoft/TypeScript/issues/27024#issuecomment-421529650
+@link https://stackoverflow.com/questions/68961864/how-does-the-equals-work-in-typescript/68963796#68963796
+
+Use-cases:
+- If you want to make a conditional branch based on the result of a comparison of two types.
+
+@example
+```
+import type {IsEqual} from 'type-fest';
+
+// This type returns a boolean for whether the given array includes the given item.
+// `IsEqual` is used to compare the given array at position 0 and the given item and then return true if they are equal.
+type Includes<Value extends readonly any[], Item> =
+	Value extends readonly [Value[0], ...infer rest]
+		? IsEqual<Value[0], Item> extends true
+			? true
+			: Includes<rest, Item>
+		: false;
+```
+
+@category Type Guard
+@category Utilities
+*/
+type IsEqual<A, B> = [A] extends [B] ? [B] extends [A] ? _IsEqual<A, B> : false : false;
+// This version fails the `equalWrappedTupleIntersectionToBeNeverAndNeverExpanded` test in `test-d/is-equal.ts`.
+type _IsEqual<A, B> = (<G>() => G extends A & G | G ? 1 : 2) extends (<G>() => G extends B & G | G ? 1 : 2) ? true : false;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/omit-index-signature.d.ts
+/**
+Omit any index signatures from the given object type, leaving only explicitly defined properties.
+
+This is the counterpart of `PickIndexSignature`.
+
+Use-cases:
+- Remove overly permissive signatures from third-party types.
+
+This type was taken from this [StackOverflow answer](https://stackoverflow.com/a/68261113/420747).
+
+It relies on the fact that an empty object (`{}`) is assignable to an object with just an index signature, like `Record<string, unknown>`, but not to an object with explicitly defined keys, like `Record<'foo' | 'bar', unknown>`.
+
+(The actual value type, `unknown`, is irrelevant and could be any type. Only the key type matters.)
+
+```
+const indexed: Record<string, unknown> = {}; // Allowed
+
+// @ts-expect-error
+const keyed: Record<'foo', unknown> = {}; // Error
+// TS2739: Type '{}' is missing the following properties from type 'Record<"foo" | "bar", unknown>': foo, bar
+```
+
+Instead of causing a type error like the above, you can also use a [conditional type](https://www.typescriptlang.org/docs/handbook/2/conditional-types.html) to test whether a type is assignable to another:
+
+```
+type Indexed = {} extends Record<string, unknown>
+	? '✅ `{}` is assignable to `Record<string, unknown>`'
+	: '❌ `{}` is NOT assignable to `Record<string, unknown>`';
+
+type IndexedResult = Indexed;
+//=> '✅ `{}` is assignable to `Record<string, unknown>`'
+
+type Keyed = {} extends Record<'foo' | 'bar', unknown>
+	? '✅ `{}` is assignable to `Record<\'foo\' | \'bar\', unknown>`'
+	: '❌ `{}` is NOT assignable to `Record<\'foo\' | \'bar\', unknown>`';
+
+type KeyedResult = Keyed;
+//=> '❌ `{}` is NOT assignable to `Record<\'foo\' | \'bar\', unknown>`'
+```
+
+Using a [mapped type](https://www.typescriptlang.org/docs/handbook/2/mapped-types.html#further-exploration), you can then check for each `KeyType` of `ObjectType`...
+
+```
+type OmitIndexSignature<ObjectType> = {
+	[KeyType in keyof ObjectType // Map each key of `ObjectType`...
+	]: ObjectType[KeyType]; // ...to its original value, i.e. `OmitIndexSignature<Foo> == Foo`.
+};
+```
+
+...whether an empty object (`{}`) would be assignable to an object with that `KeyType` (`Record<KeyType, unknown>`)...
+
+```
+type OmitIndexSignature<ObjectType> = {
+	[KeyType in keyof ObjectType
+	// Is `{}` assignable to `Record<KeyType, unknown>`?
+	as {} extends Record<KeyType, unknown>
+		? never // ✅ `{}` is assignable to `Record<KeyType, unknown>`
+		: KeyType // ❌ `{}` is NOT assignable to `Record<KeyType, unknown>`
+	]: ObjectType[KeyType];
+};
+```
+
+If `{}` is assignable, it means that `KeyType` is an index signature and we want to remove it. If it is not assignable, `KeyType` is a "real" key and we want to keep it.
+
+@example
+```
+import type {OmitIndexSignature} from 'type-fest';
+
+type Example = {
+	// These index signatures will be removed.
+	[x: string]: any;
+	[x: number]: any;
+	[x: symbol]: any;
+	[x: `head-${string}`]: string;
+	[x: `${string}-tail`]: string;
+	[x: `head-${string}-tail`]: string;
+	[x: `${bigint}`]: string;
+	[x: `embedded-${number}`]: string;
+
+	// These explicitly defined keys will remain.
+	foo: 'bar';
+	qux?: 'baz';
+};
+
+type ExampleWithoutIndexSignatures = OmitIndexSignature<Example>;
+//=> {foo: 'bar'; qux?: 'baz'}
+```
+
+@see {@link PickIndexSignature}
+@category Object
+*/
+type OmitIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? never : KeyType]: ObjectType[KeyType] };
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/pick-index-signature.d.ts
+/**
+Pick only index signatures from the given object type, leaving out all explicitly defined properties.
+
+This is the counterpart of `OmitIndexSignature`.
+
+@example
+```
+import type {PickIndexSignature} from 'type-fest';
+
+declare const symbolKey: unique symbol;
+
+type Example = {
+	// These index signatures will remain.
+	[x: string]: unknown;
+	[x: number]: unknown;
+	[x: symbol]: unknown;
+	[x: `head-${string}`]: string;
+	[x: `${string}-tail`]: string;
+	[x: `head-${string}-tail`]: string;
+	[x: `${bigint}`]: string;
+	[x: `embedded-${number}`]: string;
+
+	// These explicitly defined keys will be removed.
+	['kebab-case-key']: string;
+	[symbolKey]: string;
+	foo: 'bar';
+	qux?: 'baz';
+};
+
+type ExampleIndexSignature = PickIndexSignature<Example>;
+// {
+// 	[x: string]: unknown;
+// 	[x: number]: unknown;
+// 	[x: symbol]: unknown;
+// 	[x: `head-${string}`]: string;
+// 	[x: `${string}-tail`]: string;
+// 	[x: `head-${string}-tail`]: string;
+// 	[x: `${bigint}`]: string;
+// 	[x: `embedded-${number}`]: string;
+// }
+```
+
+@see {@link OmitIndexSignature}
+@category Object
+*/
+type PickIndexSignature<ObjectType> = { [KeyType in keyof ObjectType as {} extends Record<KeyType, unknown> ? KeyType : never]: ObjectType[KeyType] };
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/merge.d.ts
+// Merges two objects without worrying about index signatures.
+type SimpleMerge<Destination, Source> = Simplify<{ [Key in keyof Destination as Key extends keyof Source ? never : Key]: Destination[Key] } & Source>;
+/**
+Merge two types into a new type. Keys of the second type overrides keys of the first type.
+
+This is different from the TypeScript `&` (intersection) operator. With `&`, conflicting property types are intersected, which often results in `never`. For example, `{a: string} & {a: number}` makes `a` become `string & number`, which resolves to `never`. With `Merge`, the second type's keys cleanly override the first, so `Merge<{a: string}, {a: number}>` gives `{a: number}` as expected. `Merge` also produces a flattened type (via `Simplify`), making it more readable in IDE tooltips compared to `A & B`.
+
+@example
+```
+import type {Merge} from 'type-fest';
+
+type Foo = {
+	a: string;
+	b: number;
+};
+
+type Bar = {
+	a: number; // Conflicts with Foo['a']
+	c: boolean;
+};
+
+// With `&`, `a` becomes `string & number` which is `never`. Not what you want.
+type WithIntersection = (Foo & Bar)['a'];
+//=> never
+
+// With `Merge`, `a` is cleanly overridden to `number`.
+type WithMerge = Merge<Foo, Bar>['a'];
+//=> number
+```
+
+@example
+```
+import type {Merge} from 'type-fest';
+
+type Foo = {
+	[x: string]: unknown;
+	[x: number]: unknown;
+	foo: string;
+	bar: symbol;
+};
+
+type Bar = {
+	[x: number]: number;
+	[x: symbol]: unknown;
+	bar: Date;
+	baz: boolean;
+};
+
+export type FooBar = Merge<Foo, Bar>;
+//=> {
+// 	[x: string]: unknown;
+// 	[x: number]: number;
+// 	[x: symbol]: unknown;
+// 	foo: string;
+// 	bar: Date;
+// 	baz: boolean;
+// }
+```
+
+Note: If you want a merge type that more accurately reflects the runtime behavior of object spread or `Object.assign`, refer to the {@link ObjectMerge} type.
+
+@see {@link ObjectMerge}
+@category Object
+*/
+type Merge<Destination, Source> = Destination extends unknown // For distributing `Destination`
+? Source extends unknown // For distributing `Source`
+? If<IsEqual<Destination, Source>, Destination, _Merge<Destination, Source>> : never // Should never happen
+: never;
+// Should never happen
+type _Merge<Destination, Source> = Simplify<SimpleMerge<PickIndexSignature<Destination>, PickIndexSignature<Source>> & SimpleMerge<OmitIndexSignature<Destination>, OmitIndexSignature<Source>>>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/internal/object.d.ts
+/**
+Works similar to the built-in `Pick` utility type, except for the following differences:
+- Distributes over union types and allows picking keys from any member of the union type.
+- Primitives types are returned as-is.
+- Picks all keys if `Keys` is `any`.
+- Doesn't pick `number` from a `string` index signature.
+
+@example
+```
+type ImageUpload = {
+	url: string;
+	size: number;
+	thumbnailUrl: string;
+};
+
+type VideoUpload = {
+	url: string;
+	duration: number;
+	encodingFormat: string;
+};
+
+// Distributes over union types and allows picking keys from any member of the union type
+type MediaDisplay = HomomorphicPick<ImageUpload | VideoUpload, "url" | "size" | "duration">;
+//=> {url: string; size: number} | {url: string; duration: number}
+
+// Primitive types are returned as-is
+type Primitive = HomomorphicPick<string | number, 'toUpperCase' | 'toString'>;
+//=> string | number
+
+// Picks all keys if `Keys` is `any`
+type Any = HomomorphicPick<{a: 1; b: 2} | {c: 3}, any>;
+//=> {a: 1; b: 2} | {c: 3}
+
+// Doesn't pick `number` from a `string` index signature
+type IndexSignature = HomomorphicPick<{[k: string]: unknown}, number>;
+//=> {}
+*/
+type HomomorphicPick<T, Keys extends KeysOfUnion<T>> = { [P in keyof T as Extract<P, Keys>]: T[P] };
+/**
+Merges user specified options with default options.
+
+@example
+```
+type PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};
+type DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: false};
+type SpecifiedOptions = {leavesOnly: true};
+
+type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;
+//=> {maxRecursionDepth: 10; leavesOnly: true}
+```
+
+@example
+```
+// Complains if default values are not provided for optional options
+
+type PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};
+type DefaultPathsOptions = {maxRecursionDepth: 10};
+type SpecifiedOptions = {};
+
+type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;
+//                                              ~~~~~~~~~~~~~~~~~~~
+// Property 'leavesOnly' is missing in type 'DefaultPathsOptions' but required in type '{ maxRecursionDepth: number; leavesOnly: boolean; }'.
+```
+
+@example
+```
+// Complains if an option's default type does not conform to the expected type
+
+type PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};
+type DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: 'no'};
+type SpecifiedOptions = {};
+
+type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;
+//                                              ~~~~~~~~~~~~~~~~~~~
+// Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.
+```
+
+@example
+```
+// Complains if an option's specified type does not conform to the expected type
+
+type PathsOptions = {maxRecursionDepth?: number; leavesOnly?: boolean};
+type DefaultPathsOptions = {maxRecursionDepth: 10; leavesOnly: false};
+type SpecifiedOptions = {leavesOnly: 'yes'};
+
+type Result = ApplyDefaultOptions<PathsOptions, DefaultPathsOptions, SpecifiedOptions>;
+//                                                                   ~~~~~~~~~~~~~~~~
+// Types of property 'leavesOnly' are incompatible. Type 'string' is not assignable to type 'boolean'.
+```
+*/
+type ApplyDefaultOptions<Options extends object, Defaults extends Simplify<Omit<Required<Options>, RequiredKeysOf<Options>> & Partial<Record<RequiredKeysOf<Options>, never>>>, SpecifiedOptions extends Options> = _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> extends infer Result extends Required<Options> // `extends Required<Options>` ensures that `ApplyDefaultOptions<SomeOption, ...>` is always assignable to `Required<SomeOption>`
+? Result : never;
+type _ApplyDefaultOptions<Options, Defaults, SpecifiedOptions> = If<IsAny<SpecifiedOptions>, Defaults, If<IsNever<SpecifiedOptions>, Defaults, Merge<Defaults, { [Key in keyof SpecifiedOptions as undefined extends Required<Options>[Key & keyof Options] ? Key : undefined extends SpecifiedOptions[Key] ? never : Key]: SpecifiedOptions[Key] }>>>;
+/**
+Collapses literal types in a union into their corresponding primitive types, when possible. For example, `CollapseLiterals<'foo' | 'bar' | (string & {})>` returns `string`.
+
+Note: This doesn't collapse literals within tagged types. For example, `CollapseLiterals<Tagged<'foo' | (string & {}), 'Tag'>>` returns `("foo" & Tag<"Tag", never>) | (string & Tag<"Tag", never>)` and not `string & Tag<"Tag", never>`.
+
+Use-case: For collapsing unions created using {@link LiteralUnion}.
+
+@example
+```
+import type {LiteralUnion} from 'type-fest';
+
+type A = CollapseLiterals<'foo' | 'bar' | (string & {})>;
+//=> string
+
+type B = CollapseLiterals<LiteralUnion<1 | 2 | 3, number>>;
+//=> number
+
+type C = CollapseLiterals<LiteralUnion<'onClick' | 'onChange', `on${string}`>>;
+//=> `on${string}`
+
+type D = CollapseLiterals<'click' | 'change' | (`on${string}` & {})>;
+//=> 'click' | 'change' | `on${string}`
+
+type E = CollapseLiterals<LiteralUnion<'foo' | 'bar', string> | null | undefined>;
+//=> string | null | undefined
+```
+*/
+type CollapseLiterals<T> = {} extends T ? T : T extends infer U & {} ? U : T;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/some-extend.d.ts
+/**
+@see {@link SomeExtend}
+*/
+type SomeExtendOptions = {
+  /**
+  Consider `never` elements to match the target type only if the target type itself is `never` (or `any`).
+  	- When set to `true` (default), `never` is _not_ treated as a bottom type, instead, it is treated as a type that matches only itself (or `any`).
+  - When set to `false`, `never` is treated as a bottom type, and behaves as it normally would.
+  	@default true
+  	@example
+  ```
+  import type {SomeExtend} from 'type-fest';
+  	type A = SomeExtend<[1, 2, never], string, {strictNever: true}>;
+  //=> false
+  	type B = SomeExtend<[1, 2, never], string, {strictNever: false}>;
+  //=> true
+  	type C = SomeExtend<[1, never], never, {strictNever: true}>;
+  //=> true
+  	type D = SomeExtend<[1, never], never, {strictNever: false}>;
+  //=> true
+  	type E = SomeExtend<[never], any, {strictNever: true}>;
+  //=> true
+  	type F = SomeExtend<[never], any, {strictNever: false}>;
+  //=> true
+  ```
+  */
+  strictNever?: boolean;
+};
+type DefaultSomeExtendOptions = {
+  strictNever: true;
+};
+/**
+Returns a boolean for whether some element in an array type extends another type.
+
+@example
+```
+import type {SomeExtend} from 'type-fest';
+
+type A = SomeExtend<['1', '2', 3], number>;
+//=> true
+
+type B = SomeExtend<[1, 2, 3], string>;
+//=> false
+
+type C = SomeExtend<[string, number | string], number>;
+//=> boolean
+
+type D = SomeExtend<[true, boolean, true], false>;
+//=> boolean
+```
+
+Note: Behaviour of optional elements depend on the `exactOptionalPropertyTypes` compiler option. When the option is disabled, the target type must include `undefined` for a successful match.
+
+```
+// @exactOptionalPropertyTypes: true
+import type {SomeExtend} from 'type-fest';
+
+type A = SomeExtend<[1?, 2?, '3'?], string>;
+//=> true
+```
+
+```
+// @exactOptionalPropertyTypes: false
+import type {SomeExtend} from 'type-fest';
+
+type A = SomeExtend<[1?, 2?, '3'?], string>;
+//=> boolean
+
+type B = SomeExtend<[1?, 2?, '3'?], string | undefined>;
+//=> true
+```
+
+@see {@link SomeExtendOptions}
+
+@category Utilities
+@category Array
+*/
+type SomeExtend<TArray extends UnknownArray, Type, Options extends SomeExtendOptions = {}> = _SomeExtend<CollapseRestElement<TArray>, Type, ApplyDefaultOptions<SomeExtendOptions, DefaultSomeExtendOptions, Options>>;
+type _SomeExtend<TArray extends UnknownArray, Type, Options extends Required<SomeExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, return `true`.
+? true : _SomeExtend<Rest, Type, Options> : First extends Type ? true : _SomeExtend<Rest, Type, Options> : false, false, false>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/or-all.d.ts
+/**
+Returns a boolean for whether any of the given elements is `true`.
+
+Use-cases:
+- Check if at least one condition in a list of booleans is met.
+
+@example
+```
+import type {OrAll} from 'type-fest';
+
+type FFT = OrAll<[false, false, true]>;
+//=> true
+
+type FFF = OrAll<[false, false, false]>;
+//=> false
+```
+
+Note: When `boolean` is passed as an element, it is distributed into separate cases, and the final result is a union of those cases.
+For example, `OrAll<[false, boolean]>` expands to `OrAll<[false, true]> | OrAll<[false, false]>`, which simplifies to `true | false` (i.e., `boolean`).
+
+@example
+```
+import type {OrAll} from 'type-fest';
+
+type A = OrAll<[false, boolean]>;
+//=> boolean
+
+type B = OrAll<[true, boolean]>;
+//=> true
+```
+
+Note: If `never` is passed as an element, it is treated as `false` and the result is computed accordingly.
+
+@example
+```
+import type {OrAll} from 'type-fest';
+
+type A = OrAll<[never, never, true]>;
+//=> true
+
+type B = OrAll<[never, never, false]>;
+//=> false
+
+type C = OrAll<[never, never, never]>;
+//=> false
+
+type D = OrAll<[never, never, boolean]>;
+//=> boolean
+```
+
+Note: If `any` is passed as an element, it is treated as `boolean` and the result is computed accordingly.
+
+@example
+```
+import type {OrAll} from 'type-fest';
+
+type A = OrAll<[false, any]>;
+//=> boolean
+
+type B = OrAll<[true, any]>;
+//=> true
+```
+
+Note: `OrAll<[]>` evaluates to `false` because there are no `true` elements in an empty tuple. See [Wikipedia: Clause (logic) > Empty clauses](https://en.wikipedia.org/wiki/Clause_(logic)#Empty_clauses:~:text=The%20truth%20evaluation%20of%20an%20empty%20disjunctive%20clause%20is%20always%20false.).
+
+@see {@link Or}
+@see {@link AndAll}
+*/
+type OrAll<T extends readonly boolean[]> = SomeExtend<T, true>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/or.d.ts
+/**
+Returns a boolean for whether either of two given types is `true`.
+
+Use-case: Constructing complex conditional types where at least one condition must be satisfied.
+
+@example
+```
+import type {Or} from 'type-fest';
+
+type TT = Or<true, true>;
+//=> true
+
+type TF = Or<true, false>;
+//=> true
+
+type FT = Or<false, true>;
+//=> true
+
+type FF = Or<false, false>;
+//=> false
+```
+
+Note: When `boolean` is passed as an argument, it is distributed into separate cases, and the final result is a union of those cases.
+For example, `Or<false, boolean>` expands to `Or<false, true> | Or<false, false>`, which simplifies to `true | false` (i.e., `boolean`).
+
+@example
+```
+import type {Or} from 'type-fest';
+
+type A = Or<false, boolean>;
+//=> boolean
+
+type B = Or<boolean, false>;
+//=> boolean
+
+type C = Or<true, boolean>;
+//=> true
+
+type D = Or<boolean, true>;
+//=> true
+
+type E = Or<boolean, boolean>;
+//=> boolean
+```
+
+Note: If `never` is passed as an argument, it is treated as `false` and the result is computed accordingly.
+
+@example
+```
+import type {Or} from 'type-fest';
+
+type A = Or<true, never>;
+//=> true
+
+type B = Or<never, true>;
+//=> true
+
+type C = Or<false, never>;
+//=> false
+
+type D = Or<never, false>;
+//=> false
+
+type E = Or<boolean, never>;
+//=> boolean
+
+type F = Or<never, boolean>;
+//=> boolean
+
+type G = Or<never, never>;
+//=> false
+```
+
+@see {@link OrAll}
+@see {@link And}
+@see {@link Xor}
+*/
+type Or<A extends boolean, B extends boolean> = OrAll<[A, B]>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/all-extend.d.ts
+/**
+@see {@link AllExtend}
+*/
+type AllExtendOptions = {
+  /**
+  Consider `never` elements to match the target type only if the target type itself is `never` (or `any`).
+  	- When set to `true` (default), `never` is _not_ treated as a bottom type, instead, it is treated as a type that matches only itself (or `any`).
+  - When set to `false`, `never` is treated as a bottom type, and behaves as it normally would.
+  	@default true
+  	@example
+  ```
+  import type {AllExtend} from 'type-fest';
+  	type A = AllExtend<[1, 2, never], number, {strictNever: true}>;
+  //=> false
+  	type B = AllExtend<[1, 2, never], number, {strictNever: false}>;
+  //=> true
+  	type C = AllExtend<[never, never], never, {strictNever: true}>;
+  //=> true
+  	type D = AllExtend<[never, never], never, {strictNever: false}>;
+  //=> true
+  	type E = AllExtend<['a', 'b', never], any, {strictNever: true}>;
+  //=> true
+  	type F = AllExtend<['a', 'b', never], any, {strictNever: false}>;
+  //=> true
+  	type G = AllExtend<[never, 1], never, {strictNever: true}>;
+  //=> false
+  	type H = AllExtend<[never, 1], never, {strictNever: false}>;
+  //=> false
+  ```
+  */
+  strictNever?: boolean;
+};
+type DefaultAllExtendOptions = {
+  strictNever: true;
+};
+/**
+Returns a boolean for whether every element in an array type extends another type.
+
+@example
+```
+import type {AllExtend} from 'type-fest';
+
+type A = AllExtend<[1, 2, 3], number>;
+//=> true
+
+type B = AllExtend<[1, 2, '3'], number>;
+//=> false
+
+type C = AllExtend<[number, number | string], number>;
+//=> boolean
+
+type D = AllExtend<[true, boolean, true], true>;
+//=> boolean
+```
+
+Note: Behaviour of optional elements depend on the `exactOptionalPropertyTypes` compiler option. When the option is disabled, the target type must include `undefined` for a successful match.
+
+```
+// @exactOptionalPropertyTypes: true
+import type {AllExtend} from 'type-fest';
+
+type A = AllExtend<[1?, 2?, 3?], number>;
+//=> true
+```
+
+```
+// @exactOptionalPropertyTypes: false
+import type {AllExtend} from 'type-fest';
+
+type A = AllExtend<[1?, 2?, 3?], number>;
+//=> boolean
+
+type B = AllExtend<[1?, 2?, 3?], number | undefined>;
+//=> true
+```
+
+@see {@link AllExtendOptions}
+
+@category Utilities
+@category Array
+*/
+type AllExtend<TArray extends UnknownArray, Type, Options extends AllExtendOptions = {}> = _AllExtend<CollapseRestElement<TArray>, Type, ApplyDefaultOptions<AllExtendOptions, DefaultAllExtendOptions, Options>>;
+type _AllExtend<TArray extends UnknownArray, Type, Options extends Required<AllExtendOptions>> = IfNotAnyOrNever<TArray, TArray extends readonly [infer First, ...infer Rest] ? IsNever<First> extends true ? Or<Or<IsNever<Type>, IsAny<Type>>, Not<Options['strictNever']>> extends true // If target `Type` is also `never`, or is `any`, or `strictNever` is disabled, recurse further.
+? _AllExtend<Rest, Type, Options> : false : First extends Type ? _AllExtend<Rest, Type, Options> : false : true, false, false>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/and-all.d.ts
+/**
+Returns a boolean for whether all of the given elements are `true`.
+
+Use-cases:
+- Check if all conditions in a list of booleans are met.
+
+@example
+```
+import type {AndAll} from 'type-fest';
+
+type TTT = AndAll<[true, true, true]>;
+//=> true
+
+type TTF = AndAll<[true, true, false]>;
+//=> false
+
+type TFT = AndAll<[true, false, true]>;
+//=> false
+```
+
+Note: When `boolean` is passed as an element, it is distributed into separate cases, and the final result is a union of those cases.
+For example, `AndAll<[true, boolean]>` expands to `AndAll<[true, true]> | AndAll<[true, false]>`, which simplifies to `true | false` (i.e., `boolean`).
+
+@example
+```
+import type {AndAll} from 'type-fest';
+
+type A = AndAll<[true, boolean]>;
+//=> boolean
+
+type B = AndAll<[false, boolean]>;
+//=> false
+```
+
+Note: If any of the elements is `never`, the result becomes `false`.
+
+@example
+```
+import type {AndAll} from 'type-fest';
+
+type A = AndAll<[true, true, never]>;
+//=> false
+
+type B = AndAll<[false, never, never]>;
+//=> false
+
+type C = AndAll<[never, never, never]>;
+//=> false
+
+type D = AndAll<[boolean, true, never]>;
+//=> false
+```
+
+Note: If `any` is passed as an element, it is treated as `boolean` and the result is computed accordingly.
+
+@example
+```
+import type {AndAll} from 'type-fest';
+
+type A = AndAll<[false, any]>;
+//=> false
+
+type B = AndAll<[true, any]>;
+//=> boolean
+```
+
+Note: `AndAll<[]>` evaluates to `true` due to the concept of [vacuous truth](https://en.wikipedia.org/wiki/Logical_conjunction#:~:text=In%20keeping%20with%20the%20concept%20of%20vacuous%20truth%2C%20when%20conjunction%20is%20defined%20as%20an%20operator%20or%20function%20of%20arbitrary%20arity%2C%20the%20empty%20conjunction%20(AND%2Ding%20over%20an%20empty%20set%20of%20operands)%20is%20often%20defined%20as%20having%20the%20result%20true.), i.e., there are no `false` elements in an empty tuple.
+
+@see {@link And}
+@see {@link OrAll}
+*/
+type AndAll<T extends readonly boolean[]> = AllExtend<T, true>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/and.d.ts
+/**
+Returns a boolean for whether two given types are both `true`.
+
+Use-case: Constructing complex conditional types where multiple conditions must be satisfied.
+
+@example
+```
+import type {And} from 'type-fest';
+
+type TT = And<true, true>;
+//=> true
+
+type TF = And<true, false>;
+//=> false
+
+type FT = And<false, true>;
+//=> false
+
+type FF = And<false, false>;
+//=> false
+```
+
+Note: When `boolean` is passed as an argument, it is distributed into separate cases, and the final result is a union of those cases.
+For example, `And<true, boolean>` expands to `And<true, true> | And<true, false>`, which simplifies to `true | false` (i.e., `boolean`).
+
+@example
+```
+import type {And} from 'type-fest';
+
+type A = And<true, boolean>;
+//=> boolean
+
+type B = And<boolean, true>;
+//=> boolean
+
+type C = And<false, boolean>;
+//=> false
+
+type D = And<boolean, false>;
+//=> false
+
+type E = And<boolean, boolean>;
+//=> boolean
+```
+
+Note: If either of the types is `never`, the result becomes `false`.
+
+@example
+```
+import type {And} from 'type-fest';
+
+type A = And<true, never>;
+//=> false
+
+type B = And<never, true>;
+//=> false
+
+type C = And<false, never>;
+//=> false
+
+type D = And<never, false>;
+//=> false
+
+type E = And<boolean, never>;
+//=> false
+
+type F = And<never, boolean>;
+//=> false
+
+type G = And<never, never>;
+//=> false
+```
+
+@see {@link AndAll}
+@see {@link Or}
+@see {@link Xor}
+*/
+type And<A extends boolean, B extends boolean> = AndAll<[A, B]>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/except.d.ts
+/**
+Filter out keys from an object.
+
+Returns `never` if `Exclude` is strictly equal to `Key`.
+Returns `never` if `Key` extends `Exclude`.
+Returns `Key` otherwise.
+
+@example
+```
+type Filtered = Filter<'foo', 'foo'>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', string>;
+//=> never
+```
+
+@example
+```
+type Filtered = Filter<'bar', 'foo'>;
+//=> 'bar'
+```
+
+@see {Except}
+*/
+type Filter<KeyType, ExcludeType> = IsEqual<KeyType, ExcludeType> extends true ? never : (KeyType extends ExcludeType ? never : KeyType);
+type ExceptOptions = {
+  /**
+  Disallow assigning non-specified properties.
+  	Note that any omitted properties in the resulting type will be present in autocomplete as `undefined`.
+  	@default false
+  */
+  requireExactProps?: boolean;
+};
+type DefaultExceptOptions = {
+  requireExactProps: false;
+};
+/**
+Create a type from an object type without certain keys.
+
+We recommend setting the `requireExactProps` option to `true`.
+
+This type is a stricter version of [`Omit`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-5.html#the-omit-helper-type). The `Omit` type does not restrict the omitted keys to be keys present on the given type, while `Except` does. The benefits of a stricter type are avoiding typos and allowing the compiler to pick up on rename refactors automatically.
+
+This type was proposed to the TypeScript team, which declined it, saying they prefer that libraries implement stricter versions of the built-in types ([microsoft/TypeScript#30825](https://github.com/microsoft/TypeScript/issues/30825#issuecomment-523668235)).
+
+@example
+```
+import type {Except} from 'type-fest';
+
+type Foo = {
+	a: number;
+	b: string;
+};
+
+type FooWithoutA = Except<Foo, 'a'>;
+//=> {b: string}
+
+// @ts-expect-error
+const fooWithoutA: FooWithoutA = {a: 1, b: '2'};
+// errors: 'a' does not exist in type '{ b: string; }'
+
+type FooWithoutB = Except<Foo, 'b', {requireExactProps: true}>;
+//=> {a: number} & Partial<Record<'b', never>>
+
+// @ts-expect-error
+const fooWithoutB: FooWithoutB = {a: 1, b: '2'};
+// errors at 'b': Type 'string' is not assignable to type 'undefined'.
+
+// The `Omit` utility type doesn't work when omitting specific keys from objects containing index signatures.
+
+// Consider the following example:
+
+type UserData = {
+	[metadata: string]: string;
+	email: string;
+	name: string;
+	role: 'admin' | 'user';
+};
+
+// `Omit` clearly doesn't behave as expected in this case:
+type PostPayload = Omit<UserData, 'email'>;
+//=> {[x: string]: string; [x: number]: string}
+
+// In situations like this, `Except` works better.
+// It simply removes the `email` key while preserving all the other keys.
+type PostPayloadFixed = Except<UserData, 'email'>;
+//=> {[x: string]: string; name: string; role: 'admin' | 'user'}
+```
+
+@category Object
+*/
+type Except<ObjectType, KeysType extends keyof ObjectType, Options extends ExceptOptions = {}> = _Except<ObjectType, KeysType, ApplyDefaultOptions<ExceptOptions, DefaultExceptOptions, Options>>;
+type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Required<ExceptOptions>> = { [KeyType in keyof ObjectType as Filter<KeyType, KeysType>]: ObjectType[KeyType] } & (Options['requireExactProps'] extends true ? Partial<Record<KeysType, never>> : {});
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/exclude-exactly.d.ts
+/**
+A stricter version of `Exclude<T, U>` that excludes types only when they are exactly identical.
+
+@example
+```
+import type {ExcludeExactly} from 'type-fest';
+
+type TestExclude1 = Exclude<'a' | 'b' | 'c' | 1 | 2 | 3, string>;
+//=> 1 | 2 | 3
+
+type TestExcludeExactly1 = ExcludeExactly<'a' | 'b' | 'c' | 1 | 2 | 3, string>;
+//=> 'a' | 'b' | 'c' | 1 | 2 | 3
+
+type TestExclude2 = Exclude<'a' | 'b' | 'c' | 1 | 2 | 3, any>;
+//=> never
+
+type TestExcludeExactly2 = ExcludeExactly<'a' | 'b' | 'c' | 1 | 2 | 3, any>;
+//=> 'a' | 'b' | 'c' | 1 | 2 | 3
+
+type TestExclude3 = Exclude<{a: string} | {a: string; b: string}, {a: string}>;
+//=> never
+
+type TestExcludeExactly3 = ExcludeExactly<{a: string} | {a: string; b: string}, {a: string}>;
+//=> {a: string; b: string}
+```
+
+@category Improved Built-in
+*/
+type ExcludeExactly<Union, Delete> = IfNotAnyOrNever<Union, _ExcludeExactly<Union, Delete>, // If `Union` is `any`, then if `Delete` is `any`, return `never`, else return `Union`.
+If<IsAny<Delete>, never, Union>, // If `Union` is `never`, then if `Delete` is `never`, return `never`, else return `Union`.
+If<IsNever<Delete>, never, Union>>;
+type _ExcludeExactly<Union, Delete> = IfNotAnyOrNever<Delete, Union extends unknown // For distributing `Union`
+? [Delete extends unknown // For distributing `Delete`
+? If<IsEqual<Union, Delete>, true, never> : never] extends [never] ? Union : never : never, // If `Delete` is `any` or `never`, then return `Union`,
+// because `Union` cannot be `any` or `never` here.
+Union, Union>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-member.d.ts
+/**
+Returns an arbitrary member of a union type.
+
+Use-cases:
+- Implementing recursive type functions that accept a union type.
+
+@example
+```
+import type {UnionMember, IsNever} from 'type-fest';
+
+type UnionLength<T, Acc extends any[] = []> =
+	UnionMember<T> extends infer Member
+		? IsNever<Member> extends false
+			? UnionLength<Exclude<T, Member>, [...Acc, Member]>
+			: Acc['length']
+		: never;
+
+type T1 = UnionLength<'foo' | 'bar' | 'baz'>;
+//=> 3
+
+type T2 = UnionLength<{a: string}>;
+//=> 1
+```
+
+- Picking an arbitrary member from a union
+
+@example
+```
+import type {UnionMember, Primitive, LiteralToPrimitive} from 'type-fest';
+
+type IsHomogenous<T extends Primitive> = [T] extends [LiteralToPrimitive<UnionMember<T>>] ? true : false;
+
+type T1 = IsHomogenous<1 | 2 | 3 | 4>;
+//=> true
+
+type T2 = IsHomogenous<'foo' | 'bar'>;
+//=> true
+
+type T3 = IsHomogenous<'foo' | 'bar' | 1>;
+//=> false
+```
+
+Returns `never` when the input is `never`.
+
+@example
+```
+import type {UnionMember} from 'type-fest';
+
+type LastNever = UnionMember<never>;
+//=> never
+```
+
+@category Type
+*/
+type UnionMember<T> = IsNever<T> extends true ? never : UnionToIntersection<T extends any ? () => T : never> extends (() => (infer R)) ? R : never;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/union-to-tuple.d.ts
+/**
+Convert a union type into an unordered tuple type of its elements.
+
+"Unordered" means the elements of the tuple are not guaranteed to be in the same order as in the union type. The arrangement can appear random and may change at any time.
+
+This can be useful when you have objects with a finite set of keys and want a type defining only the allowed keys, but do not want to repeat yourself.
+
+@example
+```
+import type {UnionToTuple} from 'type-fest';
+
+type Numbers = 1 | 2 | 3;
+type NumbersTuple = UnionToTuple<Numbers>;
+//=> [1, 2, 3]
+```
+
+@example
+```
+import type {UnionToTuple} from 'type-fest';
+
+const pets = {
+	dog: '🐶',
+	cat: '🐱',
+	snake: '🐍',
+};
+
+type Pet = keyof typeof pets;
+//=> 'dog' | 'cat' | 'snake'
+
+const petList = Object.keys(pets) as UnionToTuple<Pet>;
+//=> ['dog', 'cat', 'snake']
+```
+
+@category Array
+*/
+type UnionToTuple<Union> = _UnionToTuple<Union> extends infer Result extends UnknownArray ? Result : never;
+// Nudges the compiler that `UnionToTuple` always yields an array.
+type _UnionToTuple<Union, Accumulator extends UnknownArray = [], Member = UnionMember<Union>> = IsNever<Union> extends true ? Accumulator : _UnionToTuple<ExcludeExactly<Union, Member>, [Member, ...Accumulator]>;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/set-optional.d.ts
+/**
+Create a type that makes the given keys optional, while keeping the remaining keys as is.
+
+Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
+
+@example
+```
+import type {SetOptional} from 'type-fest';
+
+type Foo = {
+	a: number;
+	b?: string;
+	c: boolean;
+};
+
+type SomeOptional = SetOptional<Foo, 'b' | 'c'>;
+//=> {a: number; b?: string; c?: boolean}
+```
+
+@category Object
+*/
+type SetOptional<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetOptional<BaseType, Keys>;
+type _SetOptional<BaseType, Keys extends keyof BaseType> = BaseType extends unknown // To distribute `BaseType` when it's a union type.
+? Simplify< // Pick just the keys that are readonly from the base type.
+Except<BaseType, Keys> // Pick the keys that should be mutable from the base type and make them mutable.
+& Partial<HomomorphicPick<BaseType, Keys>>> : never;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/value-of.d.ts
+/**
+Create a union of the given object's values, and optionally specify which keys to get the values from.
+
+Please upvote [this issue](https://github.com/microsoft/TypeScript/issues/31438) if you want to have this type as a built-in in TypeScript.
+
+@example
+```
+import type {ValueOf} from 'type-fest';
+
+type A = ValueOf<{id: number; name: string; active: boolean}>;
+//=> string | number | boolean
+
+type B = ValueOf<{id: number; name: string; active: boolean}, 'name'>;
+//=> string
+
+type C = ValueOf<{id: number; name: string; active: boolean}, 'id' | 'name'>;
+//=> string | number
+```
+
+@category Object
+*/
+type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/split.d.ts
+/**
+Split options.
+
+@see {@link Split}
+*/
+type SplitOptions = {
+  /**
+  When enabled, instantiations with non-literal string types (e.g., `string`, `Uppercase<string>`, `on${string}`) simply return back `string[]` without performing any splitting, as the exact structure cannot be statically determined.
+  	@default true
+  	@example
+  ```ts
+  import type {Split} from 'type-fest';
+  	type Example1 = Split<`foo.${string}.bar`, '.', {strictLiteralChecks: false}>;
+  //=> ['foo', string, 'bar']
+  	type Example2 = Split<`foo.${string}`, '.', {strictLiteralChecks: true}>;
+  //=> string[]
+  	type Example3 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: false}>;
+  //=> ['foo', 'r', 'z']
+  	type Example4 = Split<'foobarbaz', `b${string}`, {strictLiteralChecks: true}>;
+  //=> string[]
+  ```
+  */
+  strictLiteralChecks?: boolean;
+};
+type DefaultSplitOptions = {
+  strictLiteralChecks: true;
+};
+/**
+Represents an array of strings split using a given character or character set.
+
+Use-case: Defining the return type of a method like `String.prototype.split`.
+
+@example
+```
+import type {Split} from 'type-fest';
+
+declare function split<S extends string, D extends string>(string: S, separator: D): Split<S, D>;
+
+type Item = 'foo' | 'bar' | 'baz' | 'waldo';
+const items = 'foo,bar,baz,waldo';
+const array: Item[] = split(items, ',');
+```
+
+@see {@link SplitOptions}
+
+@category String
+@category Template literal
+*/
+type Split<S extends string, Delimiter extends string, Options extends SplitOptions = {}> = SplitHelper<S, Delimiter, ApplyDefaultOptions<SplitOptions, DefaultSplitOptions, Options>>;
+type SplitHelper<S extends string, Delimiter extends string, Options extends Required<SplitOptions>, Accumulator extends string[] = []> = S extends string // For distributing `S`
+? Delimiter extends string // For distributing `Delimiter`
+// If `strictLiteralChecks` is `false` OR `S` and `Delimiter` both are string literals, then perform the split
+? Or<Not<Options['strictLiteralChecks']>, And<IsStringLiteral<S>, IsStringLiteral<Delimiter>>> extends true ? S extends `${infer Head}${Delimiter}${infer Tail}` ? SplitHelper<Tail, Delimiter, Options, [...Accumulator, Head]> : Delimiter extends '' ? S extends '' ? Accumulator : [...Accumulator, S] : [...Accumulator, S] // Otherwise, return `string[]`
+: string[] : never // Should never happen
+: never; // Should never happen
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.7.0/node_modules/type-fest/source/replace.d.ts
+type ReplaceOptions = {
+  all?: boolean;
+};
+type DefaultReplaceOptions = {
+  all: false;
+};
+/**
+Represents a string with some or all matches replaced by a replacement.
+
+Use-case:
+- `kebab-case-path` to `dotted.path.notation`
+- Changing date/time format: `01-08-2042` → `01/08/2042`
+- Manipulation of type properties, for example, removal of prefixes
+
+@example
+```
+import type {Replace} from 'type-fest';
+
+declare function replace<
+	Input extends string,
+	Search extends string,
+	Replacement extends string,
+>(
+	input: Input,
+	search: Search,
+	replacement: Replacement,
+): Replace<Input, Search, Replacement>;
+
+declare function replaceAll<
+	Input extends string,
+	Search extends string,
+	Replacement extends string,
+>(
+	input: Input,
+	search: Search,
+	replacement: Replacement,
+): Replace<Input, Search, Replacement, {all: true}>;
+
+// The return type is the exact string literal, not just `string`.
+
+replace('hello ?', '?', '🦄');
+//=> 'hello 🦄'
+
+replace('hello ??', '?', '❓');
+//=> 'hello ❓?'
+
+replaceAll('10:42:00', ':', '-');
+//=> '10-42-00'
+
+replaceAll('__userName__', '__', '');
+//=> 'userName'
+
+replaceAll('My Cool Title', ' ', '');
+//=> 'MyCoolTitle'
+```
+
+@category String
+@category Template literal
+*/
+type Replace<Input extends string, Search extends string, Replacement extends string, Options extends ReplaceOptions = {}> = _Replace<Input, Search, Replacement, ApplyDefaultOptions<ReplaceOptions, DefaultReplaceOptions, Options>>;
+type _Replace<Input extends string, Search extends string, Replacement extends string, Options extends Required<ReplaceOptions>, Accumulator extends string = ''> = Search extends string // For distributing `Search`
+? Replacement extends string // For distributing `Replacement`
+? Input extends `${infer Head}${Search}${infer Tail}` ? Options['all'] extends true ? _Replace<Tail, Search, Replacement, Options, `${Accumulator}${Head}${Replacement}`> : `${Head}${Replacement}${Tail}` : `${Accumulator}${Input}` : never : never;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/List.d.ts
+/**
+ * A [[List]]
+ * @param A its type
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * type list0 = [1, 2, 3]
+ * type list1 = number[]
+ * ```
+ */
+declare type List<A = any> = ReadonlyArray<A>;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Any/Cast.d.ts
+/**
+ * Ask TS to re-check that `A1` extends `A2`.
+ * And if it fails, `A2` will be enforced anyway.
+ * Can also be used to add constraints on parameters.
+ * @param A1 to check against
+ * @param A2 to cast to
+ * @returns `A1 | A2`
+ * @example
+ * ```ts
+ * import {A} from 'ts-toolbelt'
+ *
+ * type test0 = A.Cast<'42', string> // '42'
+ * type test1 = A.Cast<'42', number> // number
+ * ```
+ */
+declare type Cast<A1 extends any, A2 extends any> = A1 extends A2 ? A1 : A2;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Any/Extends.d.ts
+/**
+ * Check whether `A1` is part of `A2` or not. The difference with
+ * `extends` is that it forces a [[Boolean]] return.
+ * @param A1
+ * @param A2
+ * @returns [[Boolean]]
+ * @example
+ * ```ts
+ * import {A} from 'ts-toolbelt'
+ *
+ * type test0 = A.Extends<'a' | 'b', 'b'> // Boolean
+ * type test1 = A.Extends<'a', 'a' | 'b'> // True
+ *
+ * type test2 = A.Extends<{a: string}, {a: any}>      // True
+ * type test3 = A.Extends<{a: any}, {a: any, b: any}> // False
+ *
+ * type test4 = A.Extends<never, never> // False
+ * /// Nothing cannot extend nothing, use `A.Equals`
+ * ```
+ */
+declare type Extends<A1 extends any, A2 extends any> = [A1] extends [never] ? 0 : A1 extends A2 ? 1 : 0;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Iteration/Iteration.d.ts
+/**
+ * An entry of `IterationMap`
+ */
+declare type Iteration = [value: number, sign: '-' | '0' | '+', prev: keyof IterationMap, next: keyof IterationMap, oppo: keyof IterationMap];
+declare type IterationMap = {
+  '__': [number, '-' | '0' | '+', '__', '__', '__'];
+  '-100': [-100, '-', '__', '-99', '100'];
+  '-99': [-99, '-', '-100', '-98', '99'];
+  '-98': [-98, '-', '-99', '-97', '98'];
+  '-97': [-97, '-', '-98', '-96', '97'];
+  '-96': [-96, '-', '-97', '-95', '96'];
+  '-95': [-95, '-', '-96', '-94', '95'];
+  '-94': [-94, '-', '-95', '-93', '94'];
+  '-93': [-93, '-', '-94', '-92', '93'];
+  '-92': [-92, '-', '-93', '-91', '92'];
+  '-91': [-91, '-', '-92', '-90', '91'];
+  '-90': [-90, '-', '-91', '-89', '90'];
+  '-89': [-89, '-', '-90', '-88', '89'];
+  '-88': [-88, '-', '-89', '-87', '88'];
+  '-87': [-87, '-', '-88', '-86', '87'];
+  '-86': [-86, '-', '-87', '-85', '86'];
+  '-85': [-85, '-', '-86', '-84', '85'];
+  '-84': [-84, '-', '-85', '-83', '84'];
+  '-83': [-83, '-', '-84', '-82', '83'];
+  '-82': [-82, '-', '-83', '-81', '82'];
+  '-81': [-81, '-', '-82', '-80', '81'];
+  '-80': [-80, '-', '-81', '-79', '80'];
+  '-79': [-79, '-', '-80', '-78', '79'];
+  '-78': [-78, '-', '-79', '-77', '78'];
+  '-77': [-77, '-', '-78', '-76', '77'];
+  '-76': [-76, '-', '-77', '-75', '76'];
+  '-75': [-75, '-', '-76', '-74', '75'];
+  '-74': [-74, '-', '-75', '-73', '74'];
+  '-73': [-73, '-', '-74', '-72', '73'];
+  '-72': [-72, '-', '-73', '-71', '72'];
+  '-71': [-71, '-', '-72', '-70', '71'];
+  '-70': [-70, '-', '-71', '-69', '70'];
+  '-69': [-69, '-', '-70', '-68', '69'];
+  '-68': [-68, '-', '-69', '-67', '68'];
+  '-67': [-67, '-', '-68', '-66', '67'];
+  '-66': [-66, '-', '-67', '-65', '66'];
+  '-65': [-65, '-', '-66', '-64', '65'];
+  '-64': [-64, '-', '-65', '-63', '64'];
+  '-63': [-63, '-', '-64', '-62', '63'];
+  '-62': [-62, '-', '-63', '-61', '62'];
+  '-61': [-61, '-', '-62', '-60', '61'];
+  '-60': [-60, '-', '-61', '-59', '60'];
+  '-59': [-59, '-', '-60', '-58', '59'];
+  '-58': [-58, '-', '-59', '-57', '58'];
+  '-57': [-57, '-', '-58', '-56', '57'];
+  '-56': [-56, '-', '-57', '-55', '56'];
+  '-55': [-55, '-', '-56', '-54', '55'];
+  '-54': [-54, '-', '-55', '-53', '54'];
+  '-53': [-53, '-', '-54', '-52', '53'];
+  '-52': [-52, '-', '-53', '-51', '52'];
+  '-51': [-51, '-', '-52', '-50', '51'];
+  '-50': [-50, '-', '-51', '-49', '50'];
+  '-49': [-49, '-', '-50', '-48', '49'];
+  '-48': [-48, '-', '-49', '-47', '48'];
+  '-47': [-47, '-', '-48', '-46', '47'];
+  '-46': [-46, '-', '-47', '-45', '46'];
+  '-45': [-45, '-', '-46', '-44', '45'];
+  '-44': [-44, '-', '-45', '-43', '44'];
+  '-43': [-43, '-', '-44', '-42', '43'];
+  '-42': [-42, '-', '-43', '-41', '42'];
+  '-41': [-41, '-', '-42', '-40', '41'];
+  '-40': [-40, '-', '-41', '-39', '40'];
+  '-39': [-39, '-', '-40', '-38', '39'];
+  '-38': [-38, '-', '-39', '-37', '38'];
+  '-37': [-37, '-', '-38', '-36', '37'];
+  '-36': [-36, '-', '-37', '-35', '36'];
+  '-35': [-35, '-', '-36', '-34', '35'];
+  '-34': [-34, '-', '-35', '-33', '34'];
+  '-33': [-33, '-', '-34', '-32', '33'];
+  '-32': [-32, '-', '-33', '-31', '32'];
+  '-31': [-31, '-', '-32', '-30', '31'];
+  '-30': [-30, '-', '-31', '-29', '30'];
+  '-29': [-29, '-', '-30', '-28', '29'];
+  '-28': [-28, '-', '-29', '-27', '28'];
+  '-27': [-27, '-', '-28', '-26', '27'];
+  '-26': [-26, '-', '-27', '-25', '26'];
+  '-25': [-25, '-', '-26', '-24', '25'];
+  '-24': [-24, '-', '-25', '-23', '24'];
+  '-23': [-23, '-', '-24', '-22', '23'];
+  '-22': [-22, '-', '-23', '-21', '22'];
+  '-21': [-21, '-', '-22', '-20', '21'];
+  '-20': [-20, '-', '-21', '-19', '20'];
+  '-19': [-19, '-', '-20', '-18', '19'];
+  '-18': [-18, '-', '-19', '-17', '18'];
+  '-17': [-17, '-', '-18', '-16', '17'];
+  '-16': [-16, '-', '-17', '-15', '16'];
+  '-15': [-15, '-', '-16', '-14', '15'];
+  '-14': [-14, '-', '-15', '-13', '14'];
+  '-13': [-13, '-', '-14', '-12', '13'];
+  '-12': [-12, '-', '-13', '-11', '12'];
+  '-11': [-11, '-', '-12', '-10', '11'];
+  '-10': [-10, '-', '-11', '-9', '10'];
+  '-9': [-9, '-', '-10', '-8', '9'];
+  '-8': [-8, '-', '-9', '-7', '8'];
+  '-7': [-7, '-', '-8', '-6', '7'];
+  '-6': [-6, '-', '-7', '-5', '6'];
+  '-5': [-5, '-', '-6', '-4', '5'];
+  '-4': [-4, '-', '-5', '-3', '4'];
+  '-3': [-3, '-', '-4', '-2', '3'];
+  '-2': [-2, '-', '-3', '-1', '2'];
+  '-1': [-1, '-', '-2', '0', '1'];
+  '0': [0, '0', '-1', '1', '0'];
+  '1': [1, '+', '0', '2', '-1'];
+  '2': [2, '+', '1', '3', '-2'];
+  '3': [3, '+', '2', '4', '-3'];
+  '4': [4, '+', '3', '5', '-4'];
+  '5': [5, '+', '4', '6', '-5'];
+  '6': [6, '+', '5', '7', '-6'];
+  '7': [7, '+', '6', '8', '-7'];
+  '8': [8, '+', '7', '9', '-8'];
+  '9': [9, '+', '8', '10', '-9'];
+  '10': [10, '+', '9', '11', '-10'];
+  '11': [11, '+', '10', '12', '-11'];
+  '12': [12, '+', '11', '13', '-12'];
+  '13': [13, '+', '12', '14', '-13'];
+  '14': [14, '+', '13', '15', '-14'];
+  '15': [15, '+', '14', '16', '-15'];
+  '16': [16, '+', '15', '17', '-16'];
+  '17': [17, '+', '16', '18', '-17'];
+  '18': [18, '+', '17', '19', '-18'];
+  '19': [19, '+', '18', '20', '-19'];
+  '20': [20, '+', '19', '21', '-20'];
+  '21': [21, '+', '20', '22', '-21'];
+  '22': [22, '+', '21', '23', '-22'];
+  '23': [23, '+', '22', '24', '-23'];
+  '24': [24, '+', '23', '25', '-24'];
+  '25': [25, '+', '24', '26', '-25'];
+  '26': [26, '+', '25', '27', '-26'];
+  '27': [27, '+', '26', '28', '-27'];
+  '28': [28, '+', '27', '29', '-28'];
+  '29': [29, '+', '28', '30', '-29'];
+  '30': [30, '+', '29', '31', '-30'];
+  '31': [31, '+', '30', '32', '-31'];
+  '32': [32, '+', '31', '33', '-32'];
+  '33': [33, '+', '32', '34', '-33'];
+  '34': [34, '+', '33', '35', '-34'];
+  '35': [35, '+', '34', '36', '-35'];
+  '36': [36, '+', '35', '37', '-36'];
+  '37': [37, '+', '36', '38', '-37'];
+  '38': [38, '+', '37', '39', '-38'];
+  '39': [39, '+', '38', '40', '-39'];
+  '40': [40, '+', '39', '41', '-40'];
+  '41': [41, '+', '40', '42', '-41'];
+  '42': [42, '+', '41', '43', '-42'];
+  '43': [43, '+', '42', '44', '-43'];
+  '44': [44, '+', '43', '45', '-44'];
+  '45': [45, '+', '44', '46', '-45'];
+  '46': [46, '+', '45', '47', '-46'];
+  '47': [47, '+', '46', '48', '-47'];
+  '48': [48, '+', '47', '49', '-48'];
+  '49': [49, '+', '48', '50', '-49'];
+  '50': [50, '+', '49', '51', '-50'];
+  '51': [51, '+', '50', '52', '-51'];
+  '52': [52, '+', '51', '53', '-52'];
+  '53': [53, '+', '52', '54', '-53'];
+  '54': [54, '+', '53', '55', '-54'];
+  '55': [55, '+', '54', '56', '-55'];
+  '56': [56, '+', '55', '57', '-56'];
+  '57': [57, '+', '56', '58', '-57'];
+  '58': [58, '+', '57', '59', '-58'];
+  '59': [59, '+', '58', '60', '-59'];
+  '60': [60, '+', '59', '61', '-60'];
+  '61': [61, '+', '60', '62', '-61'];
+  '62': [62, '+', '61', '63', '-62'];
+  '63': [63, '+', '62', '64', '-63'];
+  '64': [64, '+', '63', '65', '-64'];
+  '65': [65, '+', '64', '66', '-65'];
+  '66': [66, '+', '65', '67', '-66'];
+  '67': [67, '+', '66', '68', '-67'];
+  '68': [68, '+', '67', '69', '-68'];
+  '69': [69, '+', '68', '70', '-69'];
+  '70': [70, '+', '69', '71', '-70'];
+  '71': [71, '+', '70', '72', '-71'];
+  '72': [72, '+', '71', '73', '-72'];
+  '73': [73, '+', '72', '74', '-73'];
+  '74': [74, '+', '73', '75', '-74'];
+  '75': [75, '+', '74', '76', '-75'];
+  '76': [76, '+', '75', '77', '-76'];
+  '77': [77, '+', '76', '78', '-77'];
+  '78': [78, '+', '77', '79', '-78'];
+  '79': [79, '+', '78', '80', '-79'];
+  '80': [80, '+', '79', '81', '-80'];
+  '81': [81, '+', '80', '82', '-81'];
+  '82': [82, '+', '81', '83', '-82'];
+  '83': [83, '+', '82', '84', '-83'];
+  '84': [84, '+', '83', '85', '-84'];
+  '85': [85, '+', '84', '86', '-85'];
+  '86': [86, '+', '85', '87', '-86'];
+  '87': [87, '+', '86', '88', '-87'];
+  '88': [88, '+', '87', '89', '-88'];
+  '89': [89, '+', '88', '90', '-89'];
+  '90': [90, '+', '89', '91', '-90'];
+  '91': [91, '+', '90', '92', '-91'];
+  '92': [92, '+', '91', '93', '-92'];
+  '93': [93, '+', '92', '94', '-93'];
+  '94': [94, '+', '93', '95', '-94'];
+  '95': [95, '+', '94', '96', '-95'];
+  '96': [96, '+', '95', '97', '-96'];
+  '97': [97, '+', '96', '98', '-97'];
+  '98': [98, '+', '97', '99', '-98'];
+  '99': [99, '+', '98', '100', '-99'];
+  '100': [100, '+', '99', '__', '-100'];
+};
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Iteration/Prev.d.ts
+/**
+ * Move `I`'s position backwards
+ * @param I to move
+ * @returns [[Iteration]]
+ * @example
+ * ```ts
+ * import {I} from 'ts-toolbelt'
+ *
+ * type i = I.IterationOf<'20'>
+ *
+ * type test0 = I.Pos<i>         // 20
+ * type test1 = I.Pos<I.Prev<i>> // 19
+ * ```
+ */
+declare type Prev<I extends Iteration> = IterationMap[I[2]];
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Iteration/IterationOf.d.ts
+/**
+ * Transform a number into an [[Iteration]]
+ * (to use [[Prev]], [[Next]], & [[Pos]])
+ * @param N to transform
+ * @returns [[Iteration]]
+ * @example
+ * ```ts
+ * import {I} from 'ts-toolbelt'
+ *
+ * type i = I.IterationOf<0> // ["-1", "1", "0", 0, "0"]
+ *
+ * type next = I.Next<i>       // ["0", "2", "1", 1, "+"]
+ * type prev = I.Prev<i>       // ["-2", "0", "-1", -1, "-"]
+ *
+ * type nnext = I.Pos<next>    // +1
+ * type nprev = I.Pos<prev>    // -1
+ * ```
+ */
+declare type IterationOf<N extends number> = `${N}` extends keyof IterationMap ? IterationMap[`${N}`] : IterationMap['__'];
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Iteration/Pos.d.ts
+/**
+ * Get the position of `I` (**number**)
+ * @param I to query
+ * @returns `number`
+ * @example
+ * ```ts
+ * import {I} from 'ts-toolbelt'
+ *
+ * type i = I.IterationOf<'20'>
+ *
+ * type test0 = I.Pos<i>         // 20
+ * type test1 = I.Pos<I.Next<i>> // 21
+ * ```
+ */
+declare type Pos<I extends Iteration> = I[0];
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/Tail.d.ts
+/**
+ * Remove the first item out of a [[List]]
+ * @param L
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * ```
+ */
+declare type Tail$1<L extends List> = L extends readonly [] ? L : L extends readonly [any?, ...infer LTail] ? LTail : L;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Object/Overwrite.d.ts
+/**
+ * Update the fields of `O` with the ones of `O1`
+ * (only the existing fields will be updated)
+ * @param O to update
+ * @param O1 to update with
+ * @returns [[Object]]
+ * @example
+ * ```ts
+ * ```
+ */
+declare type Overwrite<O extends object, O1 extends object> = { [K in keyof O]: K extends keyof O1 ? O1[K] : O[K] } & {};
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/_Internal.d.ts
+/**
+ * Remove `?` & `readonly` from a [[List]]
+ */
+declare type Naked<L extends List> = Overwrite<Required<L>, L>;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/Prepend.d.ts
+/**
+ * Add an element `A` at the beginning of `L`
+ * @param L to append to
+ * @param A to be added to
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * ```
+ */
+declare type Prepend<L extends List, A extends any> = [A, ...L];
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/Iteration/_Internal.d.ts
+/**
+ * Describes how to perform iterations
+ */
+declare type Way = '->' | '<-';
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/Append.d.ts
+/**
+ * Add an element `A` at the end of `L`.
+ * @param L to append to
+ * @param A to be added to
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * import {L} from 'ts-toolbelt'
+ *
+ * type test0 = L.Append<[1, 2, 3], 4> // [1, 2, 3, 4]
+ * type test1 = L.Append<[], 'a'> // ['a']
+ * type test2 = L.Append<readonly ['a', 'b'], 'c'> // ['a', 'b', 'c']
+ * type test3 = L.Append<[1, 2], [3, 4]> // [1, 2, [3, 4]]
+ * ```
+ */
+declare type Append<L extends List, A extends any> = [...L, A];
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/Drop.d.ts
+/**
+ * @hidden
+ */
+declare type DropForth<L extends List, N extends Iteration> = {
+  0: DropForth<Tail$1<L>, Prev<N>>;
+  1: L;
+}[Extends<0, Pos<N>>];
+/**
+ * @hidden
+ */
+declare type DropBack<L extends List, N extends Iteration, I extends Iteration = Prev<N>, LN extends List = []> = {
+  0: DropBack<L, N, Prev<I>, Prepend<LN, L[Pos<I>]>>;
+  1: LN;
+}[Extends<-1, Pos<I>>];
+/**
+ * @hidden
+ */
+declare type __Drop<L extends List, N extends Iteration, way extends Way> = {
+  '->': DropForth<L, N>;
+  '<-': DropBack<L, N>;
+}[way];
+/**
+ * @hidden
+ */
+declare type _Drop<L extends List, N extends number, way extends Way = '->'> = __Drop<Naked<L>, IterationOf<N>, way> extends infer X ? Cast<X, List> : never;
+/**
+ * Remove `N` entries out of `L`
+ * @param L to remove from
+ * @param N to remove out
+ * @param way (?=`'->'`) from front: '->', from end: '<-'
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * ```
+ */
+declare type Drop<L extends List, N extends number, way extends Way = '->'> = L extends unknown ? N extends unknown ? _Drop<L, N, way> : never : never;
+//#endregion
+//#region ../../node_modules/.pnpm/ts-toolbelt@9.6.0/node_modules/ts-toolbelt/out/List/Take.d.ts
+/**
+ * starts in reverse from `N` till `N` = 0
+ * @hidden
+ */
+declare type TakeForth<L extends List, N extends Iteration, I extends Iteration = Prev<N>, LN extends List = []> = {
+  0: TakeForth<L, N, Prev<I>, Prepend<LN, L[Pos<I>]>>;
+  1: LN;
+}[Extends<-1, Pos<I>>];
+/**
+ * starts in reverse from the end till `N` = 0
+ * @hidden
+ */
+declare type TakeBack<L extends List, N extends Iteration> = {
+  0: TakeBack<Tail$1<L>, Prev<N>>;
+  1: L;
+}[Extends<0, Pos<N>>];
+/**
+ * @hidden
+ */
+declare type __Take<L extends List, N extends Iteration, way extends Way> = {
+  '->': TakeForth<L, N>;
+  '<-': TakeBack<L, N>;
+}[way];
+/**
+ * @hidden
+ */
+declare type _Take<L extends List, N extends number, way extends Way = '->'> = __Take<L, IterationOf<N>, way> extends infer X ? Cast<X, List> : never;
+/**
+ * Extract `N` entries out of `L`
+ * @param L to extract from
+ * @param N to extract out
+ * @param way (?=`'->'`) to extract from end
+ * @returns [[List]]
+ * @example
+ * ```ts
+ * ```
+ */
+declare type Take<L extends List, N extends number, way extends Way = '->'> = L extends unknown ? N extends unknown ? _Take<L, N, way> : never : never;
+//#endregion
+//#region src/object/index.type.d.ts
+type Range<Start extends number, End extends number> = Exclude<keyof TupleOf<End>, keyof TupleOf<Start>>;
+type AnyArray<A = any> = readonly A[];
+type TupleToEntries<A extends readonly unknown[]> = If<IsAny<A>, unknown, { [Key in keyof A]: [Key, A[Key]] }>;
+type Groups<L extends AnyArray, LN extends AnyArray = [], D extends number[] = []> = D["length"] extends 40 ? LN : {
+  0: Groups<Drop<L, 1>, Append<LN, [`${LN["length"]}`, Take<L, 1>]>, [...D, 0]>;
+  1: LN;
+}[Extends<L, AnyArray<never>>];
+type TupleToGroups<L extends AnyArray> = Groups<L> extends infer X ? Cast<X, AnyArray> : never;
+type Crush<T> = T extends readonly (infer U)[] ? Record<string, U extends object ? unknown : U> : Simplify<UnionToIntersection<keyof T extends infer Prop ? Prop extends keyof T ? T[Prop] extends infer Value ? ([Extract<Value, object>] extends [never] ? never : Record<string, unknown>) | ([Exclude<Value, object>] extends [never] ? never : [Extract<Value, object>] extends [never] ? { [P in Prop]: Value } : Record<string, unknown>) : never : never : never>>;
+type IntersectOf<U> = (U extends unknown ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+type ComputeRaw<A> = A extends AnyFunction ? A : { [K in keyof A]: A[K] } & unknown;
+type _Invert<O extends Record<PropertyKey, PropertyKey>> = ComputeRaw<IntersectOf<{ [K in keyof O]: Record<O[K], K> }[keyof O]>>;
+type Invert<O extends Record<keyof O, PropertyKey>> = O extends unknown ? _Invert<O> : never;
+//#endregion
+//#region src/object/objectUtil.d.ts
+/**
+ * 对象工具类
+ */
+declare class ObjectUtil {
+  /**
+   * 返回对象可枚举属性和方法的名称
+   * - `Object.keys` 始终返回 `string[]` 类型，此函数可以返回具体类型
+   *
+   * @param value 对象
+   * @returns 键数组
+   * @example
+   * ```ts
+   * // 重载 1: string
+   * ObjectUtil.keys("abc"); // ["0", "1", "2"]
+   *
+   * // 重载 2: ArrayLike
+   * ObjectUtil.keys([10, 20]); // ["0", "1"]
+   *
+   * // 重载 3: PlainObject
+   * ObjectUtil.keys({ a: 1, b: 2 }); // ["a", "b"]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.keys(anyObj); // ["x", "y"]
+   * ```
+   */
+  static keys<const S extends string>(string: S): UnionToTuple<Range<0, Split<S, "">["length"]>>;
+  static keys<const A extends ArrayLike<unknown>>(array: A): UnionToTuple<Range<0, A["length"]>>;
+  static keys<O extends PlainObject>(plainObject: O): `${Extract<keyof O, string | number>}`[];
+  static keys<O extends AnyObject>(anyObject: O): `${Extract<keyof O, string | number>}`[];
+  /**
+   * 返回对象可枚举属性的值的数组
+   *
+   * @param value 对象
+   * @returns 值数组
+   * @example
+   * ```ts
+   * // 重载 1: string
+   * ObjectUtil.values("abc"); // ["a", "b", "c"]
+   *
+   * // 重载 2: ArrayLike
+   * ObjectUtil.values([10, 20]); // [10, 20]
+   *
+   * // 重载 3: PlainObject
+   * ObjectUtil.values({ a: 1, b: 2 }); // [1, 2]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.values(anyObj); // [1, 2]
+   * ```
+   */
+  static values<S extends string>(string: S): Split<S, "">;
+  static values<A extends ArrayLike<unknown>>(array: A): A;
+  static values<O extends PlainObject>(plainObject: O): O[keyof O][];
+  static values<O extends AnyObject>(anyObject: O): O[keyof O][];
+  /**
+   * 返回对象的可枚举属性的键/值数组
+   *
+   * @param value 对象
+   * @returns 键值对数组
+   * @example
+   * ```ts
+   * // 重载 1: string
+   * ObjectUtil.entries("ab"); // [["0", "a"], ["1", "b"]]
+   *
+   * // 重载 2: readonly array
+   * ObjectUtil.entries([10, 20] as const); // [["0", 10], ["1", 20]]
+   *
+   * // 重载 3: PlainObject
+   * ObjectUtil.entries({ a: 1 }); // [["a", 1]]
+   *
+   * // 重载 4: AnyObject
+   * const anyObj = { x: 1 } as Record<string, unknown>;
+   * ObjectUtil.entries(anyObj); // [["x", 1]]
+   * ```
+   */
+  static entries<const S extends string>(string: S): TupleToEntries<Split<S, "">>;
+  static entries<const A extends readonly unknown[]>(array: A): TupleToGroups<A>;
+  static entries<const O extends PlainObject>(plainObject: O): [`${keyof Except<O, symbol>}`, O[keyof Except<O, symbol>]][];
+  static entries<const O extends AnyObject>(anyObject: O): [`${keyof Except<O, symbol>}`, O[keyof Except<O, symbol>]][];
+  /**
+   * 映射对象条目
+   * - 将对象的键值对映射为新的键值对
+   *
+   * @param plainObject 对象
+   * @param toEntry 映射函数
+   * @returns 映射后的新对象
+   * @example
+   * ```ts
+   * const obj = { a: 1, b: 2 };
+   *
+   * ObjectUtil.entriesMap(obj, (k, v) => [k, v * 2]); // { a: 2, b: 4 }
+   *
+   * ObjectUtil.entriesMap(obj, (k, v) => [`prefix_${String(k)}`, `${v}x`]); // { prefix_a: "1x", prefix_b: "2x" }
+   * ```
+   */
+  static entriesMap<O extends PlainObject, NK extends PropertyKey, NV>(plainObject: O, toEntry: (key: keyof O, value: O[keyof O]) => [NK, NV]): PlainObject<NK, NV>;
+  /**
+   * 选取对象的指定属性
+   *
+   * @param plainObject 对象
+   * @param keys 要选取的属性键数组
+   * @returns 包含指定属性的新对象
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * ObjectUtil.pick({ a: 1, b: 2 }, ["a"]); // { a: 1 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.pick(anyObj, ["x"]); // { x: 1 }
+   * ```
+   */
+  static pick<O extends PlainObject, K extends keyof O>(plainObject: O, keys: readonly K[]): Pick<O, K>;
+  static pick<O extends AnyObject, K extends keyof O>(anyObject: O, keys: readonly K[]): Pick<O, K>;
+  /**
+   * 排除对象的指定属性
+   *
+   * @param plainObject 对象
+   * @param keys 要排除的属性键数组
+   * @returns 排除指定属性后的新对象
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * ObjectUtil.omit({ a: 1, b: 2 }, ["a"]); // { b: 2 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: 1, y: 2 } as Record<string, unknown>;
+   * ObjectUtil.omit(anyObj, ["x"]); // { y: 2 }
+   * ```
+   */
+  static omit<O extends PlainObject, K extends keyof O>(plainObject: O, keys: readonly K[]): Omit<O, K>;
+  static omit<O extends AnyObject, K extends keyof O>(anyObject: O, keys: readonly K[]): PlainObject;
+  /**
+   * 尽可能地交换对象的键和值
+   *
+   * @param obj 对象
+   * @returns 键值互换后的对象
+   * @example
+   * ```ts
+   * // 重载 1: Record<keyof O, PropertyKey>
+   * const obj = { a: "1", b: 2 };
+   * ObjectUtil.invert(obj); // { "1": "a", 2: "b" }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { x: Symbol.for("s"), y: true } as Record<string, unknown>;
+   * ObjectUtil.invert(anyObj); // { [Symbol.for("s")]: "x" }
+   * ```
+   */
+  static invert<const O extends Record<keyof O, PropertyKey>>(plainObject: O): Invert<O>;
+  static invert<const O extends AnyObject>(anyObject: O): Invert<O>;
+  /**
+   * 压平对象
+   * - 将多层级的对象转换为单层级的对象，键名使用点号连接
+   *
+   * @param plainObject 平面对象
+   * @returns 压平后的对象
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * const plainObj = { a: { b: 1 } };
+   * ObjectUtil.crush(plainObj); // { "a.b": 1 }
+   *
+   * // 重载 2: AnyObject
+   * const anyObj = { list: [{ id: 1 }] } as Record<string, unknown>;
+   * ObjectUtil.crush(anyObj); // { "list.0.id": 1 }
+   * ```
+   */
+  static crush<T extends PlainObject>(plainObject: T): Crush<T>;
+  static crush<T extends AnyObject>(anyObject: T): Crush<T>;
+  /**
+   * 获取所有枚举成员的键
+   *
+   * @param enumeration 枚举对象
+   * @returns 键数组
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumKeys(StringEnum); // ["A", "B"]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumKeys(anyEnum); // ["A", "B"]
+   * ```
+   */
+  static enumKeys<E extends PlainObject>(enumeration: E): (keyof E)[];
+  static enumKeys<E extends AnyObject>(enumeration: E): (keyof E)[];
+  /**
+   * 获取所有枚举成员的值
+   *
+   * @param enumeration 枚举对象
+   * @returns 值数组
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumValues(StringEnum); // ["a", "b"]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumValues(anyEnum); // [0, 1]
+   * ```
+   */
+  static enumValues<E extends PlainObject>(enumeration: E): UnionToTuple<ValueOf<E>>;
+  static enumValues<E extends AnyObject>(enumeration: E): UnionToTuple<ValueOf<E>>;
+  /**
+   * 获取所有枚举成员的键/值数组
+   *
+   * @param enumeration 枚举对象
+   * @returns 键值对数组
+   * @example
+   * ```ts
+   * // 重载 1: PlainObject
+   * enum StringEnum { A = "a", B = "b" }
+   * ObjectUtil.enumEntries(StringEnum); // [["A", "a"], ["B", "b"]]
+   *
+   * // 重载 2: AnyObject
+   * enum NumberEnum { A, B }
+   * const anyEnum = NumberEnum as Record<string, unknown>;
+   * ObjectUtil.enumEntries(anyEnum); // [["A", 0], ["B", 1]]
+   * ```
+   */
+  static enumEntries<E extends PlainObject>(enumeration: E): [keyof E, E[keyof E]][];
+  static enumEntries<E extends AnyObject>(enumeration: E): [keyof E, E[keyof E]][];
+}
+//#endregion
+//#region src/string/stringUtil.d.ts
+/**
+ * 字符串工具类
+ */
+declare class StringUtil {
+  /**
+   * 从字符串中提取数字字符串
+   * - 移除非数字字符，保留符号和小数点
+   *
+   * @param input 待处理字符串
+   * @returns 提取出的数字字符串
+   * @example
+   * ```ts
+   * StringUtil.toNumber("$1,234.56"); // "1234.56"
+   * StringUtil.toNumber("abc-123"); // "-123"
+   * ```
+   */
+  static toNumber(input: string): string;
+  /**
+   * 将字符串转换为小写
+   * - 将字符串字面量类型转换为其小写形式
+   * - 当输入无效时，返回空字符串
+   *
+   * @param input 待处理字符串
+   * @returns 转换后的小写字符串类型，如果输入无效则返回空字符串类型 ""
+   * @example
+   * ```ts
+   * // 重载 1: 输入 string
+   * StringUtil.toLowerCase("HELLO"); // "hello"
+   *
+   * // 重载 2: 输入 unknown
+   * StringUtil.toLowerCase(null); // ""
+   * ```
+   */
+  static toLowerCase<const T extends string>(input: T): Lowercase<T>;
+  static toLowerCase(input: unknown): "";
+  /**
+   * 将字符串转换为大写
+   * - 将字符串字面量类型转换为其大写形式
+   * - 当输入无效时，返回空字符串
+   *
+   * @param input 待处理字符串
+   * @returns 转换后的大写字符串，如果输入无效则返回空字符串
+   * @example
+   * ```ts
+   * // 重载 1: 输入 string
+   * StringUtil.toUpperCase("hello"); // "HELLO"
+   *
+   * // 重载 2: 输入 unknown
+   * StringUtil.toUpperCase(null); // ""
+   * ```
+   */
+  static toUpperCase<const T extends string>(input: T): Uppercase<T>;
+  static toUpperCase(input: unknown): "";
+  /**
+   * 字符串首字母大小写
+   * - 包含非西欧字母字符时，不处理
+   * - 纯字母且全大写时，不处理
+   * - 纯字母且非全大写时，首字母小写，其余保留
+   * - 纯字母且非全大写时，首字母大写，其余保留
+   *
+   * @param input 待处理字符串
+   * @param caseType 大小写类型
+   * @returns 处理后的字符串
+   * @example
+   * ```ts
+   * StringUtil.toInitialCase("Hello", "lower"); // "hello"
+   * StringUtil.toInitialCase("hello", "upper"); // "Hello"
+   * ```
+   */
+  static toInitialCase(input: string, caseType?: "lower" | "upper" | undefined): string;
+  /**
+   * 将路径转换为 POSIX 风格
+   * - 统一使用正斜杠 (/)
+   * - 可选移除 Windows 盘符 (如 C:)
+   * - 可选移除开头的斜杠
+   * - 规范化连续斜杠为单个斜杠
+   *
+   * @param input 待处理字符串
+   * @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`。如果移除了盘符，路径通常会以 / 开头，此参数可控制是否保留该 /
+   * @returns 转换后的路径，如果输入无效则返回空字符串
+   *
+   * @example
+   * ```ts
+   * StringUtil.toPosix("C:\\Windows\\System32"); // 默认: "/Windows/System32" (移除了 C: 并标准化)
+   *
+   * StringUtil.toPosix("C:\\Windows\\System32", true); // 移除开头斜杠: "Windows/System32"
+   *
+   * StringUtil.toPosix("\\\\server\\share\\file.txt"); // UNC 路径: "/server/share/file.txt"
+   *
+   * StringUtil.toPosix("folder\\subfolder\\file.txt"); // 相对路径: "folder/subfolder/file.txt"
+   * ```
+   */
+  static toPosix(input: string | null | undefined, removeLeadingSlash?: boolean): string;
+  /**
+   * 处理 JSON 字符串
+   *
+   * @param input 待处理字符串
+   * @param fallback 回退值
+   * @returns 解析后的对象 或 回退值
+   * @example
+   * ```ts
+   * // 重载 1: 无 fallback
+   * StringUtil.toJson<{ a: number }>("{\"a\":1}"); // { a: 1 }
+   * StringUtil.toJson("invalid"); // undefined
+   *
+   * // 重载 2: 有 fallback
+   * StringUtil.toJson<{ a: number }>("invalid", { a: 0 }); // { a: 0 }
+   * ```
+   */
+  static toJson<D extends AnyObject = AnyObject>(input: string | null | undefined): D | undefined;
+  static toJson<D extends AnyObject = AnyObject>(input: string | null | undefined, fallback: D): D;
+  /**
+   * 字符串分割为数组
+   * - 按指定分隔符分割字符串，并转换类型
+   *
+   * @param input 待处理字符串
+   * @param valueType 数组中每一项的类型，默认为 "number"
+   * @param splitSymbol 分隔符，默认为 `,`
+   * @returns 分割后的数组
+   * @example
+   * ```ts
+   * // 重载 1: valueType = "number" (默认)
+   * StringUtil.toValues("1,2,3"); // [1, 2, 3]
+   *
+   * // 重载 2: valueType = "string"
+   * StringUtil.toValues("a-b-c", "string", "-"); // ["a", "b", "c"]
+   * ```
+   */
+  static toValues(input: string | null | undefined, valueType?: "number" | undefined, splitSymbol?: string | undefined): number[];
+  static toValues(input: string | null | undefined, valueType: "string", splitSymbol?: string | undefined): string[];
+  /**
+   * 从字符串中裁切掉所有的前缀和后缀字符
+   *
+   * @param input 待处理字符串
+   * @param charsToTrim 裁切字符，默认为 `" "`
+   * @returns 裁切后的字符串
+   * @example
+   * ```ts
+   * StringUtil.trim("  hello  "); // "hello"
+   * StringUtil.trim("__hello__", "_"); // "hello"
+   * ```
+   */
+  static trim(input: string | null | undefined, charsToTrim?: string): string;
+  /**
+   * 截取字符串
+   * - 支持自定义省略符，不会截断在汉字中间（因为JS字符串本身按字符处理）
+   *
+   * @param input 待处理字符串
+   * @param maxLength 最大长度 (包含省略符)
+   * @param ellipsis 省略符，默认为 `...`
+   * @returns 截取后的字符串
+   * @example
+   * ```ts
+   * StringUtil.truncate("hello world", 8); // "hello..."
+   * ```
+   */
+  static truncate(input: string, maxLength: number, ellipsis?: string): string;
+  /**
+   * 字符串模板替换
+   * - 使用对象的属性值替换字符串中的 {{key}} 模板
+   *
+   * @param input 待处理字符串
+   * @param template 模板对象
+   * @param regex 模板匹配正则 (默认: `\{\{(.+?)\}\}`)
+   * @returns 替换后的字符串
+   * @example
+   * ```ts
+   * StringUtil.template("Hello {{name}}", { name: "World" }); // "Hello World"
+   * ```
+   */
+  static template(input: string, template: PlainObject, regex?: RegExp): string;
+  /**
+   * 字符串替换
+   * - 替换第一个匹配项
+   *
+   * @param input 待处理字符串
+   * @param search 匹配项
+   * @param replacement 替换项
+   * @returns 替换后的字符串
+   * @example
+   * ```ts
+   * StringUtil.replace("hello world", "world", "context"); // "hello context"
+   * ```
+   */
+  static replace<I extends string, S extends string, R extends string>(input: I, search: S, replacement: R): Replace<I, S, R>;
+}
+//#endregion
+//#region src/theme/themeUtil.d.ts
+/**
+ * 主题工具类
+ */
+declare class ThemeUtil {
+  /**
+   * 固定主题类型（仅亮色/暗色）
+   *
+   * @example
+   * ```ts
+   * ThemeUtil.THEME.LIGHT; // "light"
+   * ThemeUtil.THEME.DARK; // "dark"
+   * ```
+   */
+  static readonly THEME: {
+    readonly LIGHT: "light";
+    readonly DARK: "dark";
+  };
+  /**
+   * 主题模式（支持跟随系统）
+   *
+   * @example
+   * ```ts
+   * ThemeUtil.THEME_MODE.SYSTEM; // "system"
+   * ThemeUtil.THEME_MODE.DARK; // "dark"
+   * ```
+   */
+  static readonly THEME_MODE: {
+    readonly LIGHT: "light";
+    readonly DARK: "dark";
+    readonly SYSTEM: "system";
+  };
+}
+//#endregion
+//#region src/theme/index.type.d.ts
+type THEME_TYPE = ValueOf<typeof ThemeUtil.THEME>;
+type THEME_MODE_TYPE = ValueOf<typeof ThemeUtil.THEME_MODE>;
+//#endregion
+//#region src/tree/index.type.d.ts
+type RowKey = "id";
+type ParentIdKey = "parentId";
+type ChildrenKey = "children";
+type Strategy = "pre" | "post" | "breadth";
+interface BaseCallbackMeta<T> {
+  depth: number;
+  parents?: T[] | undefined;
+}
+interface BaseOptions<T, CK extends string> {
+  childrenKey?: CK;
+  strategy?: Strategy;
+  getChildrenKey?: ((row: T, meta: BaseCallbackMeta<T>) => CK) | undefined;
+}
+interface RowsToTreeOptions<RK extends string = RowKey, PK extends string = ParentIdKey, CK extends string = ChildrenKey> {
+  rowKey?: RK;
+  parentIdKey?: PK;
+  childrenKey?: CK;
+}
+type TreeToRowsOptions<T extends AnyObject, CK extends string = ChildrenKey> = TreeForeachOptions<T, CK>;
+type TreeFindOptions<T extends AnyObject, CK extends string = ChildrenKey> = BaseOptions<T, CK>;
+type TreeFindCallback<T extends AnyObject> = (row: T, meta: BaseCallbackMeta<T>) => boolean;
+type TreeForeachOptions<T extends AnyObject, CK extends string = ChildrenKey> = BaseOptions<T, CK>;
+type TreeForeachCallback<T extends AnyObject> = (row: T, meta: BaseCallbackMeta<T>) => void;
+type TreeFilterOptions<T extends AnyObject, CK extends string = ChildrenKey> = BaseOptions<T, CK>;
+type TreeFilterCallback<T extends AnyObject> = (row: T, meta: BaseCallbackMeta<T>) => boolean;
+type TreeMapOptions<T extends AnyObject, CK extends string> = BaseOptions<T, CK>;
+type TreeMapCallback<R extends AnyObject, T extends AnyObject> = (row: T, meta: BaseCallbackMeta<T>) => R;
+//#endregion
+//#region src/tree/treeUtil.d.ts
+/**
+ * 树结构工具类
+ */
+declare class TreeUtil {
+  /**
+   * 行结构 转 树结构
+   * - 将平铺的数组转换为树形结构
+   *
+   * @param rows 行数据数组
+   * @param options 配置项
+   * @returns 树结构数组
+   * @example
+   * ```ts
+   * const rows = [
+   *   { id: 1, parentId: null },
+   *   { id: 2, parentId: 1 },
+   * ];
+   * TreeUtil.rowsToTree(rows); // [{ id: 1, parentId: null, children: [{ id: 2, parentId: 1 }] }]
+   * ```
+   */
+  static rowsToTree<T extends AnyObject = AnyObject, CK extends string = ChildrenKey, R = TreeLike<T, CK>, RK extends string = RowKey, PK extends string = ParentIdKey>(rows: T[], options?: RowsToTreeOptions<RK, PK, CK> | undefined): R[];
+  /**
+   * 树结构 转 行结构
+   * - 将树形结构扁平化为数组
+   *
+   * @param tree 树结构数据 (单个节点或节点数组)
+   * @param options 配置项
+   * @returns 扁平化后的数组
+   * @example
+   * ```ts
+   * const tree = [{ id: 1, children: [{ id: 2 }] }];
+   * TreeUtil.treeToRows(tree); // [{ id: 1, children: undefined }, { id: 2, children: undefined }]
+   * ```
+   */
+  static treeToRows<T extends AnyObject, CK extends string = ChildrenKey, R extends AnyObject = SetOptional<T, CK>>(tree: T | T[], options?: TreeToRowsOptions<T, CK>): R[];
+  /**
+   * 遍历树节点
+   *
+   * @param tree 树结构数据
+   * @param callback 回调函数
+   * @param options 配置项
+   * @example
+   * ```ts
+   * const tree = [{ id: 1, children: [{ id: 2 }] }];
+   * const ids: number[] = [];
+   * TreeUtil.forEach(tree, (node) => ids.push(node.id)); // ids: [1, 2] (pre-order default)
+   * ```
+   */
+  static forEach<T extends AnyObject, CK extends string = ChildrenKey>(tree: T | T[], callback: TreeForeachCallback<T>, options?: TreeForeachOptions<T, CK>): void;
+  /**
+   * 查找树节点
+   * - 返回第一个回调返回 true 的节点
+   *
+   * @param tree 树结构数据
+   * @param callback 回调函数
+   * @param options 配置项
+   * @returns 找到的节点，未找到则返回 undefined
+   * @example
+   * ```ts
+   * const tree = [{ id: 1, children: [{ id: 2 }] }];
+   * TreeUtil.find(tree, (node) => node.id === 2); // { id: 2, ... }
+   * ```
+   */
+  static find<T extends AnyObject, CK extends string = ChildrenKey>(tree: T | T[], callback: TreeFindCallback<T>, options?: TreeFindOptions<T, CK>): T | undefined;
+  /**
+   * 过滤树节点
+   * - 返回新的树结构，包含所有回调返回 true 的节点
+   * - 如果父节点被过滤，则其子节点也会被过滤 (pre 策略下)
+   *
+   * @param tree 树结构数据
+   * @param callback 回调函数
+   * @param options 配置项 (childrenKey, strategy等)
+   * @returns 过滤后的树结构数组
+   * @example
+   * ```ts
+   * const tree = [{ id: 1, visible: true, children: [{ id: 2, visible: false }] }];
+   *
+   * // 重载 1: 传入树数组
+   * TreeUtil.filter(tree, (node) => node.visible); // [{ id: 1, visible: true, children: [] }]
+   *
+   * // 重载 2: 传入单个树节点
+   * TreeUtil.filter(tree[0], (node) => node.visible); // { id: 1, visible: true, children: [] }
+   * ```
+   */
+  static filter<T extends AnyObject, CK extends string = ChildrenKey>(tree: T[], callback: TreeFilterCallback<T>, options?: TreeFilterOptions<T, CK>): T[];
+  static filter<T extends AnyObject, CK extends string = ChildrenKey>(tree: T, callback: TreeFilterCallback<T>, options?: TreeFilterOptions<T, CK>): T;
+  /**
+   * 映射树节点
+   * - 返回新的树结构，保持层级关系
+   *
+   * @param tree 树结构数据
+   * @param callback 回调函数 (返回映射后的节点内容)
+   * @param options 配置项
+   * @returns 映射后的树结构数组
+   * @example
+   * ```ts
+   * const tree = [{ id: 1, val: 10, children: [{ id: 2, val: 20 }] }];
+   *
+   * // 重载 1: 传入树数组
+   * TreeUtil.map(tree, (node) => ({ ...node, val: node.val * 2 }));
+   * // [{ id: 1, val: 20, children: [{ id: 2, val: 40 }] }]
+   *
+   * // 重载 2: 传入单个树节点
+   * TreeUtil.map(tree[0], (node) => ({ ...node, val: node.val * 2 }));
+   * // { id: 1, val: 20, children: [{ id: 2, val: 40 }] }
+   * ```
+   */
+  static map<R extends AnyObject, T extends AnyObject, CK extends string = ChildrenKey>(tree: T[], callback: TreeMapCallback<R, T>, options?: TreeMapOptions<T, CK>): TreeLike<R, CK>[];
+  static map<R extends AnyObject, T extends AnyObject, CK extends string = ChildrenKey>(tree: T, callback: TreeMapCallback<R, T>, options?: TreeMapOptions<T, CK>): TreeLike<R, CK>;
+}
+//#endregion
+//#region src/type/index.type.d.ts
+interface Class<T, Arguments extends unknown[] = unknown[]> {
+  new (...arguments_: Arguments): T;
+  prototype: Pick<T, keyof T>;
+}
+//#endregion
+//#region src/type/typeUtil.d.ts
+/**
+ * 类型工具类
+ */
+declare class TypeUtil {
+  private static readonly PROTOTYPE_TAGS;
+  private static readonly TYPED_ARRAY_TAGS;
+  /**
+   * 获取值的 [[Prototype]] 标签
+   *
+   * @param value - 任意 JavaScript 值
+   * @returns 标准化的类型标签字符串
+   */
+  private static getPrototypeString;
+  private static isConstructable;
+  /**
+   * 检查 value 是否为 string 类型
+   *
+   * @param value 待检查值
+   * @param checkEmpty 是否检查空字符串
+   * @returns 是否为字符串
+   * @example
+   * ```ts
+   * TypeUtil.isString("abc"); // true
+   * TypeUtil.isString(""); // true
+   * TypeUtil.isString("", true); // false
+   * ```
+   */
+  static isString(value: unknown, checkEmpty?: boolean): value is string;
+  /**
+   * 检查 value 是否为 number 类型
+   * - 默认会调用 `TypeUtil.isNaN`（内部基于 `Number.isNaN`）过滤掉 `NaN`
+   *
+   * @param value 待检查值
+   * @param checkNaN 是否检查 `NaN`，默认为 `true`
+   * @returns 是否为 number
+   * @example
+   * ```ts
+   * TypeUtil.isNumber(1); // true
+   * TypeUtil.isNumber(NaN); // false (default)
+   * TypeUtil.isNumber(NaN, false); // true
+   * ```
+   */
+  static isNumber(value: unknown, checkNaN?: boolean): value is number;
+  /**
+   * 检查 value 是否为 NaN
+   * - 禁止使用全局 `isNaN`，其会先进行隐式数字转换，可能导致误判（例如 `isNaN("foo") === true`）
+   * - 使用 `Number.isNaN` 仅在值本身就是 `NaN` 时返回 `true`，语义更严格且更安全
+   *
+   * @param value 待检查值
+   * @returns 是否为 NaN
+   * @example
+   * ```ts
+   * TypeUtil.isNaN(NaN); // true
+   * ```
+   */
+  static isNaN(value: unknown): value is number;
+  /**
+   * 检查 value 是否为整数
+   *
+   * @param value 待检查值
+   * @param checkSafe 是否附加安全整数检查
+   * @returns 是否为整数
+   * @example
+   * ```ts
+   * TypeUtil.isInteger(1); // true
+   * TypeUtil.isInteger(1.1); // false
+   * ```
+   */
+  static isInteger(value: unknown, checkSafe?: boolean): value is number;
+  /**
+   * 检查 value 是否为正整数
+   * - 此函数中 `0` 不被视为正整数
+   *
+   * @param value 待检查值
+   * @param checkSafe 是否附加安全整数检查
+   * @example
+   * ```ts
+   * TypeUtil.isPositiveInteger(1); // true
+   * TypeUtil.isPositiveInteger(0); // false
+   * ```
+   */
+  static isPositiveInteger(value: unknown, checkSafe?: boolean): value is number;
+  /**
+   * 检查 value 是否为负整数
+   * - 此函数中 `0` 不被视为负整数
+   *
+   * @param value 待检查值
+   * @param checkSafe 是否附加安全整数检查
+   * @example
+   * ```ts
+   * TypeUtil.isNegativeInteger(-1); // true
+   * TypeUtil.isNegativeInteger(0); // false
+   * ```
+   */
+  static isNegativeInteger(value: unknown, checkSafe?: boolean): value is number;
+  /**
+   * 检查 value 是否为 Infinity
+   * - 排除 `NaN`
+   *
+   * @param value 待检查值
+   * @example
+   * ```ts
+   * TypeUtil.isInfinity(Infinity); // true
+   * TypeUtil.isInfinity(1); // false
+   * ```
+   */
+  static isInfinity(value: unknown): value is number;
+  /**
+   * 检查 value 是否类似 Infinity
+   * - 排除 `NaN`
+   *
+   * @param value 待检查值
+   * @example
+   * ```ts
+   * TypeUtil.isInfinityLike("Infinity"); // true
+   * TypeUtil.isInfinityLike("123"); // false
+   * ```
+   */
+  static isInfinityLike(value: unknown): boolean;
+  /**
+   * 检查 value 是否为 Boolean
+   * @param value 待检查值
+   * @returns 是否为 Boolean
+   * @example
+   * ```ts
+   * TypeUtil.isBoolean(false); // true
+   * ```
+   */
+  static isBoolean(value: unknown): value is boolean;
+  /**
+   * 检查 value 是否为 BigInt
+   * @param value 待检查值
+   * @returns 是否为 BigInt
+   * @example
+   * ```ts
+   * TypeUtil.isBigInt(1n); // true
+   * ```
+   */
+  static isBigInt(value: unknown): value is bigint;
+  /**
+   * 检查 value 是否为 Symbol
+   * @param value 待检查值
+   * @returns 是否为 Symbol
+   * @example
+   * ```ts
+   * TypeUtil.isSymbol(Symbol("a")); // true
+   * ```
+   */
+  static isSymbol(value: unknown): value is symbol;
+  /**
+   * 检查 value 是否为 undefined
+   * @param value 待检查值
+   * @returns 是否为 undefined
+   * @example
+   * ```ts
+   * TypeUtil.isUndefined(undefined); // true
+   * ```
+   */
+  static isUndefined(value: unknown): value is undefined;
+  /**
+   * 检查 value 是否为 null
+   * @param value 待检查值
+   * @returns 是否为 null
+   * @example
+   * ```ts
+   * TypeUtil.isNull(null); // true
+   * ```
+   */
+  static isNull(value: unknown): value is null;
+  /**
+   * 检查 value 是否为 Function
+   * @param value 待检查值
+   * @returns 是否为 Function
+   * @example
+   * ```ts
+   * TypeUtil.isFunction(() => {}); // true
+   * ```
+   */
+  static isFunction(value: unknown): value is AnyFunction;
+  /**
+   * 检查 value 是否为 AsyncFunction
+   * @param value 待检查值
+   * @returns 是否为 AsyncFunction
+   * @example
+   * ```ts
+   * TypeUtil.isAsyncFunction(async () => {}); // true
+   * ```
+   */
+  static isAsyncFunction(value: unknown): value is AnyAsyncFunction;
+  /**
+   * 检查 value 是否为 GeneratorFunction
+   * @param value 待检查值
+   * @returns 是否为 GeneratorFunction
+   * @example
+   * ```ts
+   * TypeUtil.isGeneratorFunction(function * a () {}); // true
+   * ```
+   */
+  static isGeneratorFunction(value: unknown): value is AnyGeneratorFunction;
+  /**
+   * 检查 value 是否为 AsyncGeneratorFunction
+   * @param value 待检查值
+   * @returns 是否为 AsyncGeneratorFunction
+   * @example
+   * ```ts
+   * TypeUtil.isAsyncGeneratorFunction(async function * a () {}); // true
+   * ```
+   */
+  static isAsyncGeneratorFunction(value: unknown): value is AnyAsyncGeneratorFunction;
+  /**
+   * 检查 value 是否为 Promise
+   * @param value 待检查值
+   * @returns 是否为 Promise
+   * @example
+   * ```ts
+   * TypeUtil.isPromise(Promise.resolve(1)); // true
+   * ```
+   */
+  static isPromise(value: unknown): value is Promise<unknown>;
+  /**
+   * 检查 value 是否为 PromiseLike
+   * - 可识别拥有 then 方法的非 Promise 对象
+   * @param value 待检查值
+   * @returns 是否为 PromiseLike
+   * @example
+   * ```ts
+   * TypeUtil.isPromiseLike({ then: () => {} }); // true
+   * ```
+   */
+  static isPromiseLike(value: unknown): value is PromiseLike<unknown>;
+  /**
+   * 判断是否为普通对象类型
+   * - 可选是否检查原型为 `Object.prototype`，防止原型链污染
+   *
+   * @param value 待检查值
+   * @param prototypeCheck 是否进行原型检查，默认 `true`
+   * @returns 是否为 Plain Object (当 checkPrototype=true) 或 object
+   * @example
+   * ```ts
+   * TypeUtil.isObject({}); // true
+   * TypeUtil.isObject([]); // false
+   * TypeUtil.isObject(new Date()); // false
+   * TypeUtil.isObject(new Date(), false); // true
+   * TypeUtil.isObject(Object.create(null)) // false
+   * TypeUtil.isObject(Object.create(null), false) // true
+   * ```
+   */
+  static isObject(value: unknown, prototypeCheck?: boolean): value is Record<PropertyKey, unknown>;
+  /**
+   * 判断一个对象是否为有效的枚举
+   * - 枚举成员不能为空
+   * - 枚举成员的键不能具有数值名
+   * - 枚举成员的值必须类型一致且为 `string` 或 `number` 类型
+   * - 枚举成员的值不能重复
+   * - 枚举成员的值必须全部为双向映射或非双向映射
+   *
+   * @param enumeration 待检查值
+   * @returns [是否为有效的枚举, 是否为双向枚举]
+   * @example
+   * ```ts
+   * enum A { X, Y }
+   * TypeUtil.isEnumeration(A); // [true, true]
+   * ```
+   */
+  static isEnumeration(enumeration: PlainObject): [boolean, boolean];
+  /**
+   * 检查 value 是否为 Class
+   *
+   * @param value 待检查值
+   * @returns 是否为 Class
+   * @example
+   * ```ts
+   * class A {}
+   * TypeUtil.isClass(A); // true
+   * TypeUtil.isClass(() => {}); // false
+   * ```
+   */
+  static isClass(value: unknown): value is Class<AnyObject>;
+  /**
+   * 检查 value 是否为数组
+   *
+   * @param value 待检查值
+   * @returns 是否为数组
+   * @example
+   * ```ts
+   * TypeUtil.isArray([]); // true
+   * ```
+   */
+  static isArray(value: unknown): value is unknown[];
+  /**
+   * 检查 value 是否为 TypedArray
+   *
+   * @param value 待检查值
+   * @returns 是否为 TypedArray
+   * @example
+   * ```ts
+   * TypeUtil.isTypedArray(new Int8Array()); // true
+   * ```
+   */
+  static isTypedArray(value: unknown): value is TypedArray;
+  /**
+   * 检查 value 是否为 Map
+   * @param value 待检查值
+   * @returns 是否为 Map
+   * @example
+   * ```ts
+   * TypeUtil.isMap(new Map()); // true
+   * ```
+   */
+  static isMap(value: unknown): value is Map<unknown, unknown>;
+  /**
+   * 检查 value 是否为 WeakMap
+   * @param value 待检查值
+   * @returns 是否为 WeakMap
+   * @example
+   * ```ts
+   * TypeUtil.isWeakMap(new WeakMap()); // true
+   * ```
+   */
+  static isWeakMap(value: unknown): value is WeakMap<AnyObject, unknown>;
+  /**
+   * 检查 value 是否为 Set
+   * @param value 待检查值
+   * @returns 是否为 Set
+   * @example
+   * ```ts
+   * TypeUtil.isSet(new Set()); // true
+   * ```
+   */
+  static isSet(value: unknown): value is Set<unknown>;
+  /**
+   * 检查 value 是否为 WeakSet
+   * @param value 待检查值
+   * @returns 是否为 WeakSet
+   * @example
+   * ```ts
+   * TypeUtil.isWeakSet(new WeakSet()); // true
+   * ```
+   */
+  static isWeakSet(value: unknown): value is WeakSet<AnyObject>;
+  /**
+   * 检查 value 是否为 Blob
+   * @param value 待检查值
+   * @returns 是否为 Blob
+   * @example
+   * ```ts
+   * TypeUtil.isBlob(new Blob(["a"])); // true
+   * ```
+   */
+  static isBlob(value: unknown): value is Blob;
+  /**
+   * 检查 value 是否为 File
+   * @param value 待检查值
+   * @returns 是否为 File
+   * @example
+   * ```ts
+   * TypeUtil.isFile(new File(["a"], "a.txt")); // true
+   * ```
+   */
+  static isFile(value: unknown): value is File;
+  /**
+   * 检查 value 是否为 ReadableStream
+   * - Uses `Object.prototype.toString` where supported (modern browsers, Node.js ≥18).
+   * - Falls back to duck-typing in older environments.
+   * - Resistant to basic forgery, but not 100% secure in all polyfill scenarios.
+   * - ⚠️ Note: In older Node.js (<18) or with non-compliant polyfills, this may return false positives or negatives.
+   *
+   * @param value 待检查值
+   * @returns 是否为 ReadableStream
+   * @example
+   * ```ts
+   * TypeUtil.isReadableStream(new ReadableStream()); // true
+   * ```
+   */
+  static isReadableStream(value: unknown): value is ReadableStream;
+  /**
+   * 检查 value 是否为 Window
+   * @param value 待检查值
+   * @returns 是否为 Window
+   * @example
+   * ```ts
+   * TypeUtil.isWindow(window); // true
+   * ```
+   */
+  static isWindow(value: unknown): value is Window;
+  /**
+   * 检查 value 是否为 HTMLIFrameElement
+   * @param value 待检查值
+   * @returns 是否为 HTMLIFrameElement
+   * @example
+   * ```ts
+   * TypeUtil.isIframe(document.createElement("iframe")); // true
+   * ```
+   */
+  static isIframe(value: unknown): value is HTMLIFrameElement;
+  /**
+   * 检查 value 是否为 Date 对象
+   *
+   * @param value 待检查值
+   * @param invalidCheck 是否要求日期有效（非 Invalid Date）。默认 true
+   *   - true: 仅当是有效 Date 对象时返回 true（排除 new Date('invalid')）
+   *   - false: 只要 [[Prototype]] 是 Date 即返回 true（包含 Invalid Date）
+   * @returns 是否为 Date 对象，根据 invalidCheck 返回不同语义的 Date 判定
+   *
+   * @example
+   * ```ts
+   * TypeUtil.isDate(new Date()); // true
+   * TypeUtil.isDate(new Date('invalid')); // false
+   * TypeUtil.isDate(new Date('invalid'), false); // true
+   * TypeUtil.isDate(null); // false
+   * TypeUtil.isDate({}); // false
+   * ```
+   */
+  static isDate(value: unknown, invalidCheck?: boolean): value is Date;
+  /**
+   * 检查 value 是否为 Error 对象
+   * @param value 待检查值
+   * @returns 是否为 Error
+   * @example
+   * ```ts
+   * TypeUtil.isError(new Error("x")); // true
+   * ```
+   */
+  static isError(value: unknown): value is Error;
+  /**
+   * 检查 value 是否为 RegExp
+   * @param value 待检查值
+   * @returns 是否为 RegExp
+   * @example
+   * ```ts
+   * TypeUtil.isRegExp(/a/); // true
+   * ```
+   */
+  static isRegExp(value: unknown): value is RegExp;
+  /**
+   * 检查 value 是否为 WebSocket
+   * @param value 待检查值
+   * @returns 是否为 WebSocket
+   * @example
+   * ```ts
+   * TypeUtil.isWebSocket(new WebSocket("wss://echo.websocket.events")); // true
+   * ```
+   */
+  static isWebSocket(value: unknown): value is WebSocket;
+  /**
+   * 检查 value 是否为 URLSearchParams
+   * @param value 待检查值
+   * @returns 是否为 URLSearchParams
+   * @example
+   * ```ts
+   * TypeUtil.isURLSearchParams(new URLSearchParams("a=1")); // true
+   * ```
+   */
+  static isURLSearchParams(value: unknown): value is URLSearchParams;
+  /**
+   * 检查 value 是否为 AbortSignal
+   * @param value 待检查值
+   * @returns 是否为 AbortSignal
+   * @example
+   * ```ts
+   * TypeUtil.isAbortSignal(new AbortController().signal); // true
+   * ```
+   */
+  static isAbortSignal(value: unknown): value is AbortSignal;
+  /**
+   * 检查 value 是否为可迭代对象 (Iterable)
+   * @param value 待检查值
+   * @returns 是否为 Iterable
+   * @example
+   * ```ts
+   * TypeUtil.isIterable([1, 2]); // true
+   * ```
+   */
+  static isIterable(value: unknown): value is {
+    [Symbol.iterator]: () => Iterator<unknown>;
+  };
+  /**
+   * 检查 value 是否为 Falsy 值 (false, 0, "", null, undefined, NaN)
+   * @param value 待检查值
+   * @returns 是否为 Falsy
+   * @example
+   * ```ts
+   * TypeUtil.isFalsy(0); // true
+   * ```
+   */
+  static isFalsy(value: unknown): value is false | 0 | "" | null | undefined;
+  /**
+   * 检查 value 是否为 FalsyLike 值
+   * - 包含字符串形式的 `"null"`、`"undefined"`、`"false"`、`"0"` 等
+   *
+   * @param value 待检查值
+   * @returns 是否为 FalsyLike
+   * @example
+   * ```ts
+   * TypeUtil.isFalsyLike("false"); // true
+   * TypeUtil.isFalsyLike("hello"); // false
+   * ```
+   */
+  static isFalsyLike(value: unknown): boolean;
+}
+//#endregion
+//#region src/validate/validateUtil.d.ts
+/**
+ * 验证工具类
+ */
+declare class ValidateUtil {
+  static _phone: RegExp;
+  /**
+   * 验证是否为手机号码
+   * @example
+   * ```ts
+   * ValidateUtil.isPhone("13800138000"); // true
+   * ```
+   */
+  static isPhone(input: string): boolean;
+  static _telephone: RegExp;
+  /**
+   * 验证是否为固定电话
+   * @example
+   * ```ts
+   * ValidateUtil.isTelephone("010-12345678"); // true
+   * ```
+   */
+  static isTelephone(input: string): boolean;
+  static _IMEI: RegExp;
+  /**
+   * 验证是否为移动设备识别码
+   * @example
+   * ```ts
+   * ValidateUtil.isIMEI("490154203237518"); // true
+   * ```
+   */
+  static isIMEI(input: string): boolean;
+  static _email: RegExp;
+  /**
+   * 验证是否为电子邮箱
+   * @example
+   * ```ts
+   * ValidateUtil.isEmail("dev@example.com"); // true
+   * ```
+   */
+  static isEmail(input: string): boolean;
+  static _link: RegExp;
+  /**
+   * 验证是否为 http(s) 链接
+   * @example
+   * ```ts
+   * ValidateUtil.isHttpLink("https://example.com/path"); // true
+   * ```
+   */
+  static isHttpLink(input: string): boolean;
+  static _portLink: RegExp;
+  /**
+   * 验证是否为端口号链接
+   * @example
+   * ```ts
+   * ValidateUtil.isPortLink("http://example.com:8080"); // true
+   * ```
+   */
+  static isPortLink(input: string): boolean;
+  static _thunderLink: RegExp;
+  /**
+   * 验证是否为迅雷链接
+   * @example
+   * ```ts
+   * ValidateUtil.isThunderLink("thunder://QUFodHRwOi8vZXhhbXBsZS5jb20vZmlsZQ=="); // true
+   * ```
+   */
+  static isThunderLink(input: string): boolean;
+  static _uscc: RegExp;
+  /**
+   * 验证是否为统一社会信用代码
+   * @example
+   * ```ts
+   * ValidateUtil.isUSCC("91350100M000100Y43"); // true
+   * ```
+   */
+  static isUSCC(input: string): boolean;
+  static _usccs: RegExp;
+  /**
+   * 验证是否为统一社会信用代码 - 15位/18位/20位数字/字母
+   * @example
+   * ```ts
+   * ValidateUtil.isUSCCS("91350100M000100Y43"); // true
+   * ```
+   */
+  static isUSCCS(input: string): boolean;
+  static _dirPathWindows: RegExp;
+  /**
+   * 验证是否为 Windows 系统文件夹路径
+   * @example
+   * ```ts
+   * ValidateUtil.isDirPathWindows("C:\\Users\\pawover\\"); // true
+   * ```
+   */
+  static isDirPathWindows(input: string): boolean;
+  static _filePathWindows: RegExp;
+  /**
+   * 验证是否为 Windows 系统文件路径
+   * @example
+   * ```ts
+   * ValidateUtil.isFilePathWindows("C:\\Users\\pawover\\a.txt"); // true
+   * ```
+   */
+  static isFilePathWindows(input: string): boolean;
+  static _dirPathLinux: RegExp;
+  /**
+   * 验证是否为 Linux 系统文件夹路径
+   * @example
+   * ```ts
+   * ValidateUtil.isDirPathLinux("/usr/local/"); // true
+   * ```
+   */
+  static isDirPathLinux(input: string): boolean;
+  static _filePathLinux: RegExp;
+  /**
+   * 验证是否为 Linux 系统文件路径
+   * @example
+   * ```ts
+   * ValidateUtil.isFilePathLinux("/usr/local/bin/node"); // true
+   * ```
+   */
+  static isFilePathLinux(input: string): boolean;
+  static _EVCarNumber: RegExp;
+  /**
+   * 验证是否为新能源车牌号
+   * @example
+   * ```ts
+   * ValidateUtil.isEVCarNumber("粤AD12345"); // true
+   * ```
+   */
+  static isEVCarNumber(input: string): boolean;
+  static _GVCarNumber: RegExp;
+  /**
+   * 验证是否为燃油车车牌号
+   * @example
+   * ```ts
+   * ValidateUtil.isGVCarNumber("粤B12345"); // true
+   * ```
+   */
+  static isGVCarNumber(input: string): boolean;
+  static _chineseName: RegExp;
+  /**
+   * 验证是否为中文姓名
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseName("张三"); // true
+   * ```
+   */
+  static isChineseName(input: string): boolean;
+  static _chineseId: RegExp;
+  /**
+   * 验证是否为中国身份证号
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseID("11010519491231002X"); // true
+   * ```
+   */
+  static isChineseID(input: string): boolean;
+  static _chineseProvince: RegExp;
+  /**
+   * 验证是否为中国省份
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseProvince("浙江"); // true
+   * ```
+   */
+  static isChineseProvince(input: string): boolean;
+  static _chineseNation: RegExp;
+  /**
+   * 验证是否为中华民族
+   * @example
+   * ```ts
+   * ValidateUtil.isChineseNation("汉族"); // true
+   * ```
+   */
+  static isChineseNation(input: string): boolean;
+  static _letter: RegExp;
+  /**
+   * 验证是否只包含字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetter("abcDEF"); // true
+   * ```
+   */
+  static isLetter(input: string): boolean;
+  static _letterLowercase: RegExp;
+  /**
+   * 验证是否只包含小写字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterLowercase("abc"); // true
+   * ```
+   */
+  static isLetterLowercase(input: string): boolean;
+  static _letterUppercase: RegExp;
+  /**
+   * 验证是否只包含大写字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterUppercase("ABC"); // true
+   * ```
+   */
+  static isLetterUppercase(input: string): boolean;
+  static _letterOmit: RegExp;
+  /**
+   * 验证是否不包含字母
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterOmit("123_-"); // true
+   * ```
+   */
+  static isLetterOmit(input: string): boolean;
+  static _LetterAndNumber: RegExp;
+  /**
+   * 验证是否为数字和字母组合
+   * @example
+   * ```ts
+   * ValidateUtil.isLetterAndNumber("A1B2"); // true
+   * ```
+   */
+  static isLetterAndNumber(input: string): boolean;
+  static _signedFloat: RegExp;
+  /**
+   * 验证是否为有符号浮点数
+   * @example
+   * ```ts
+   * ValidateUtil.isSignedFloat("-12.34"); // true
+   * ```
+   */
+  static isSignedFloat(input: string): boolean;
+  static _unsignedFloat: RegExp;
+  /**
+   * 验证是否为无符号浮点数
+   * @example
+   * ```ts
+   * ValidateUtil.isUnsignedFloat("12.34"); // true
+   * ```
+   */
+  static isUnsignedFloat(input: string): boolean;
+  static _signedInteger: RegExp;
+  /**
+   * 验证是否为有符号整数
+   * @example
+   * ```ts
+   * ValidateUtil.isSignedInteger("-12"); // true
+   * ```
+   */
+  static isSignedInteger(input: string): boolean;
+  static _unsignedInteger: RegExp;
+  /**
+   * 验证是否为无符号整数
+   * @example
+   * ```ts
+   * ValidateUtil.isUnsignedInteger("12"); // true
+   * ```
+   */
+  static isUnsignedInteger(input: string): boolean;
+  static _spaceInclude: RegExp;
+  /**
+   * 验证是否包含空格
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceInclude("a b"); // true
+   * ```
+   */
+  static isSpaceInclude(input: string): boolean;
+  static _spaceStart: RegExp;
+  /**
+   * 验证是否以空格开头
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceStart(" abc"); // true
+   * ```
+   */
+  static isSpaceStart(input: string): boolean;
+  static _spaceEnd: RegExp;
+  /**
+   * 验证是否以空格结尾
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceEnd("abc "); // true
+   * ```
+   */
+  static isSpaceEnd(input: string): boolean;
+  /**
+   * 验证是否以空格开头或结尾
+   * @example
+   * ```ts
+   * ValidateUtil.isSpaceStartOrEnd(" abc"); // true
+   * ```
+   */
+  static isSpaceStartOrEnd(input: string): boolean;
+}
+//#endregion
+export { ArrayUtil, DateTimeUtil, EnvUtil, FunctionUtil, MimeUtil, NumberUtil, ObjectUtil, StringUtil, type THEME_MODE_TYPE, type THEME_TYPE, ThemeUtil, TreeUtil, TypeUtil, ValidateUtil };