@fast-china/utils 2.1.6 → 2.1.7

package/dist/crypto/index.d.mts

@@ -1,327 +0,0 @@
-import { DecodedText } from "../internal/text.mjs";
-import "crypto-js/pad-ansix923.js";
-//#region src/crypto/index.d.ts
-/** AES 分组密码模式；与 .NET `CipherMode.CBC` 和 `CipherMode.ECB` 对应。 */
-export type AesCipherMode = "CBC" | "ECB";
-/** AES 填充模式；与 .NET `PaddingMode` 中可由 CryptoJS 互操作的成员对应。 */
-export type AesPaddingMode = "None" | "PKCS7" | "Zeros" | "ANSIX923" | "ISO10126";
-/** Web Crypto 导出的 PEM 公私钥对。 */
-export interface PemKeyPair {
-  /** 未加密的 PKCS#8 PEM 私钥，包含标准 `PRIVATE KEY` 头尾和 64 字符换行。 */
-  privateKey: string;
-  /** SubjectPublicKeyInfo PEM 公钥，包含标准 `PUBLIC KEY` 头尾和 64 字符换行。 */
-  publicKey: string;
-}
-/** 本模块支持的 Web Crypto 椭圆曲线。 */
-export type EcNamedCurve = "P-256" | "P-384" | "P-521";
-/**
- * 生成随机字节。
- *
- * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
- * @param length - 0 至 65,536 的安全整数。
- * @returns 新建的 `Uint8Array`。
- * @throws 参数非法时抛出 `RangeError`。
- */
-export declare function GenerateRandomBytes(length: number): Uint8Array;
-/**
- * 以不提前退出的方式比较两个字节数组。
- *
- * @remarks JavaScript 引擎不保证严格常量时间；该函数只避免显式短路，不能替代服务端
- * 密码学库提供的 timing-safe primitive。长度是否相同仍属于可观察信息。
- * @param left - 第一字节序列。
- * @param right - 第二字节序列。
- * @returns 长度和每个字节均相同时返回 `true`。
- */
-export declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
-/**
- * 计算 MD5 摘要并返回小写十六进制文本。
- *
- * @remarks MD5 仅用于非安全的普通校验，不得用于密码、签名或抗碰撞场景。
- * @param value - UTF-8 文本。
- * @returns 32 字符小写十六进制摘要。
- */
-export declare function MD5Encrypt(value: string): string;
-/**
- * 计算 SHA-1 摘要并返回大写十六进制文本。
- *
- * @remarks SHA-1 仅用于非安全的普通校验，不得用于密码、签名或抗碰撞场景。
- * @param value - UTF-8 文本。
- * @returns 40 字符大写十六进制摘要。
- */
-export declare function SHA1Encrypt(value: string): string;
-/**
- * 计算 SHA-256 摘要。
- *
- * @remarks SHA-256 是快速摘要，不适合直接存储或校验密码。
- * @param value - UTF-8 字符串或原始字节。
- * @returns 32 字节摘要。
- * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
- */
-export declare function SHA256Bytes(value: string): Promise<Uint8Array>;
-/**
- * 计算 SHA-256 并格式化为十六进制。
- *
- * @param value - UTF-8 字符串或原始字节。
- * @returns 64 字符大写十六进制文本。
- * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
- */
-export declare function SHA256Encrypt(value: string): Promise<string>;
-/**
- * 计算 SHA-384 摘要。
- *
- * @param value - UTF-8 文本或原始字节。
- * @returns 48 字节摘要。
- */
-export declare function SHA384Bytes(value: string): Promise<Uint8Array>;
-/**
- * 计算 SHA-384 并格式化为十六进制文本。
- *
- * @param value - UTF-8 文本或原始字节。
- * @returns 96 个大写十六进制字符组成的摘要。
- */
-export declare function SHA384Encrypt(value: string): Promise<string>;
-/**
- * 计算 SHA-512 摘要。
- *
- * @param value - UTF-8 文本或原始字节。
- * @returns 64 字节摘要。
- */
-export declare function SHA512Bytes(value: string): Promise<Uint8Array>;
-/**
- * 计算 SHA-512 并格式化为十六进制文本。
- *
- * @param value - UTF-8 文本或原始字节。
- * @returns 128 个大写十六进制字符组成的摘要。
- */
-export declare function SHA512Encrypt(value: string): Promise<string>;
-/**
- * 使用 HMAC-SHA-256 认证文本，并返回十六进制标签。
- *
- * @param value - 要认证的 UTF-8 文本或原始字节。
- * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
- * @returns 64 个小写十六进制字符组成的认证标签。
- */
-export declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
-/**
- * 使用 HMAC-SHA-384 认证文本或字节，并返回十六进制标签。
- *
- * @param value - 要认证的 UTF-8 文本或原始字节。
- * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
- * @returns 96 个小写十六进制字符组成的认证标签。
- */
-export declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
-/**
- * 使用 HMAC-SHA-512 认证文本或字节，并返回十六进制标签。
- *
- * @param value - 要认证的 UTF-8 文本或原始字节。
- * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
- * @returns 128 个小写十六进制字符组成的认证标签。
- */
-export declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
-/**
- * 使用 PBKDF2-HMAC-SHA-256 从密码派生密钥。
- *
- * @param password - 1 至 1,024 UTF-8 字节的密码。
- * @param salt - 至少 8 字节的盐。
- * @param iterations - 迭代次数，范围为 100,000 至 5,000,000。
- * @param outputLength - 输出长度，范围为 1 至 1,024 字节。
- * @returns 指定长度的派生密钥。
- * @throws 参数超过协议边界时抛出 `TypeError` 或 `RangeError`。
- */
-export declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: number, outputLength?: number): Promise<Uint8Array>;
-/**
- * 生成可持久化的随机盐 PBKDF2-HMAC-SHA-256 密码哈希。
- *
- * @param password - 1 至 1,024 UTF-8 字节的密码。
- * @param iterations - 迭代次数，范围为 100,000 至 5,000,000。
- * @returns 包含版本、迭代次数、16 字节随机盐和 32 字节派生密钥的自描述字符串。
- */
-export declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number): Promise<string>;
-/**
- * 验证 {@link HashPasswordPBKDF2SHA256} 生成的密码哈希。
- *
- * @param password - 要验证的密码。
- * @param passwordHash - 自描述的 PBKDF2-HMAC-SHA-256 密码哈希。
- * @returns 格式有效且密码匹配时返回 `true`；格式无效或密码错误时返回 `false`。
- */
-export declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: string): Promise<boolean>;
-/**
- * 使用 RFC 5869 HKDF-SHA-256 派生上下文隔离的密钥材料。
- *
- * @param inputKeyMaterial - 输入密钥材料，例如 ECDH 原始共享秘密。
- * @param salt - 可选盐；空值按 RFC 5869 的零盐语义处理。
- * @param info - 应用、协议和密钥用途上下文。
- * @param outputLength - 输出长度，范围为 1 至 8,160 字节。
- * @returns 与 `salt` 和 `info` 绑定的派生密钥。
- */
-export declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, info?: Uint8Array, outputLength?: number): Promise<Uint8Array>;
-/**
- * 使用 AES-256 对 UTF-8 文本进行分组加密。
- *
- * @remarks 密钥和 IV 分别补字符 `f` 或截断到 32、16 个 UTF-16 Code Unit，与 .NET
- * `AESEncrypt` 保持一致。CBC/ECB 不提供完整性认证，密文可能被篡改。
- * @param dataStr - 要加密的 UTF-8 文本；空白文本返回 `null`。
- * @param key - 非空白的密钥文本。
- * @param vector - 非空白的初始化向量文本；ECB 模式仍要求传入该参数以对齐 .NET 签名。
- * @param cipherMode - AES 分组模式，默认 `CBC`。
- * @param paddingMode - AES 填充模式，默认 `PKCS7`。
- * @returns Base64 密文；输入、密钥或 IV 为空白时返回 `null`。
- * @throws 模式或填充不受支持时抛出 `RangeError`。
- */
-export declare function AESEncrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): string | null;
-/**
- * 使用 AES-256 解密 Base64 分组密文。
- *
- * @remarks 参数归一化规则与 {@link AESEncrypt} 以及 .NET `AESDecrypt` 相同。
- * @param dataStr - Base64 密文；空白文本返回 `null`。
- * @param key - 加密时使用的密钥文本。
- * @param vector - 加密时使用的初始化向量文本。
- * @param cipherMode - AES 分组模式，默认 `CBC`。
- * @param paddingMode - AES 填充模式，默认 `PKCS7`。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串；输入、密钥或 IV 为空白时返回 `null`。
- * @throws 模式、填充、Base64、密钥或密文无效时抛出错误。
- */
-export declare function AESDecrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): DecodedText | null;
-/**
- * 使用 SHA-256 归一化文本密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
- *
- * @remarks 输出与 .NET `AESEncryptAuthenticated` 的 v1 Base64 二进制载荷完全一致。
- * @param plaintext - 要加密的 UTF-8 文本。
- * @param key - 非空的 UTF-8 文本密钥；内部归一化为 32 字节 SHA-256 摘要。
- * @returns Base64 编码的 v1 AES-GCM 认证载荷。
- * @throws 密钥为空或运行时缺少 Web Crypto 时抛出错误。
- */
-export declare function AESEncryptAuthenticated(plaintext: string, key: string): Promise<string>;
-/**
- * 解密并认证 .NET `AESEncryptAuthenticated` 或 {@link AESEncryptAuthenticated} 生成的载荷。
- *
- * @param payload - Base64 编码的 v1 AES-GCM 二进制载荷。
- * @param key - 加密时使用的非空 UTF-8 文本密钥。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
- * @throws 载荷格式无效、密钥错误或认证失败时抛出错误。
- */
-export declare function AESDecryptAuthenticated(payload: string, key: string): Promise<DecodedText>;
-/**
- * 使用 PBKDF2-HMAC-SHA-256 派生密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
- *
- * @remarks 每次调用生成独立 16 字节盐与 12 字节 IV。输出是与 .NET `AESEncryptWithPassword`
- * 一致的 v1 自描述载荷，不应由业务代码手动拆分或修改。密码加密不替代密钥管理。
- * @param plaintext - 原始文本，不进行 JSON 推断；UTF-8 编码后最大 8 MiB。
- * @param password - 1 至 1024 UTF-8 字节的秘密口令。
- * @param iterations - PBKDF2 工作因子，默认 600,000。
- * @returns 认证密文字符串；相同输入每次产生不同结果。
- * @throws 口令非法时抛出 `TypeError` 或 `RangeError`；明文过大时抛出 `RangeError`；
- * 运行时缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
- */
-export declare function AESEncryptWithPassword(plaintext: string, password: string, iterations?: number): Promise<string>;
-/**
- * 解密 {@link AESEncryptWithPassword} 生成的 v1 认证载荷。
- *
- * @param payload - 未修改的 v1 载荷，最大约 16 MiB 文本。
- * @param password - 加密时使用的口令。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
- * @throws 格式或字段非法时抛出 `TypeError`，载荷过大时抛出 `RangeError`，认证或密码
- * 失败及缺少平台能力时抛出 `Error`。
- */
-export declare function AESDecryptWithPassword(payload: string, password: string): Promise<DecodedText>;
-/**
- * 生成可供 RSA-OAEP/SHA-256 与 RSA-PSS/SHA-256 共用的 PEM 密钥对。
- *
- * @param modulusLength - RSA 模数位数，默认 2,048；必须是不小于 2,048 的 256 倍数。
- * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
- * @throws 模数小于 2,048 或不是 256 的倍数时抛出 `RangeError`。
- */
-export declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>;
-/**
- * 使用 RSA-OAEP/SHA-256 公钥加密 UTF-8 文本。
- *
- * @param plaintext - 要加密的 UTF-8 文本；长度必须满足 RSA-OAEP 模数限制。
- * @param publicKeyPem - SubjectPublicKeyInfo PEM 公钥。
- * @returns Base64 编码的 RSA 密文。
- * @throws 公钥格式无效或明文超过 RSA-OAEP 容量时抛出错误。
- */
-export declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promise<string>;
-/**
- * 使用 RSA-OAEP/SHA-256 私钥解密 Base64 密文。
- *
- * @param ciphertext - Base64 编码的 RSA 密文。
- * @param privateKeyPem - 未加密的 PKCS#8 PEM 私钥。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
- * @throws 私钥、Base64 或密文无效时抛出错误。
- */
-export declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Promise<DecodedText>;
-/**
- * 使用 RSA-PSS/SHA-256 私钥签名文本或字节。
- *
- * @param value - 要签名的 UTF-8 文本或原始字节。
- * @param privateKeyPem - 未加密的 PKCS#8 PEM 私钥。
- * @returns Base64 编码的 RSA-PSS 签名；盐长度固定为 32 字节。
- * @throws 私钥格式无效或签名失败时抛出错误。
- */
-export declare function RSASignPSS(value: string, privateKeyPem: string): Promise<string>;
-/**
- * 使用 RSA-PSS/SHA-256 公钥验证 Base64 签名。
- *
- * @param value - 签名时使用的 UTF-8 文本或原始字节。
- * @param signature - Base64 编码的 RSA-PSS 签名。
- * @param publicKeyPem - SubjectPublicKeyInfo PEM 公钥。
- * @returns 签名与内容、公钥匹配时返回 `true`。
- * @throws 公钥或 Base64 格式无效时抛出错误。
- */
-export declare function RSAVerifyPSS(value: string, signature: string, publicKeyPem: string): Promise<boolean>;
-/**
- * 生成 ECDSA PEM 签名密钥对。
- *
- * @param namedCurve - NIST 曲线：P-256、P-384 或 P-521。
- * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
- */
-export declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
-/**
- * 使用 ECDSA 私钥签名文本或字节。
- *
- * @remarks Web Crypto 返回 IEEE P1363 固定字段拼接格式，与 .NET 实现一致。
- * @param value - 要签名的 UTF-8 文本或原始字节。
- * @param privateKeyPem - 未加密的 EC PKCS#8 PEM 私钥。
- * @param namedCurve - 私钥使用的 NIST 曲线。
- * @returns Base64 编码的 IEEE P1363 ECDSA 签名。
- */
-export declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: EcNamedCurve): Promise<string>;
-/**
- * 使用 ECDSA 公钥验证 Base64 签名。
- *
- * @param value - 签名时使用的 UTF-8 文本或原始字节。
- * @param signature - Base64 编码的 IEEE P1363 ECDSA 签名。
- * @param publicKeyPem - EC SubjectPublicKeyInfo PEM 公钥。
- * @param namedCurve - 公钥使用的 NIST 曲线。
- * @returns 签名与内容、公钥和曲线匹配时返回 `true`。
- */
-export declare function ECDSAVerify(value: string, signature: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<boolean>;
-/**
- * 生成 ECDH PEM 密钥协商密钥对。
- *
- * @param namedCurve - NIST 曲线：P-256、P-384 或 P-521。
- * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
- */
-export declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
-/**
- * 使用本方 ECDH 私钥与对方 ECDH 公钥派生共享秘密。
- *
- * @remarks 返回值仍需经过合适的 KDF 后才能作为对称密钥，不应直接长期存储。
- * @param privateKeyPem - 本方未加密的 EC PKCS#8 PEM 私钥。
- * @param publicKeyPem - 对方的 EC SubjectPublicKeyInfo PEM 公钥。
- * @param namedCurve - 双方密钥使用的 NIST 曲线。
- * @returns 曲线字段长度的原始 ECDH 共享秘密。
- */
-export declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
-/**
- * 使用 ECDH 后以 SHA-256 派生共享密钥。
- *
- * @remarks 相比直接使用原始共享秘密，此入口与 .NET `DeriveECDHKeySHA256` 一致并固定输出 32 字节。
- * @param privateKeyPem - 本方未加密的 EC PKCS#8 PEM 私钥。
- * @param publicKeyPem - 对方的 EC SubjectPublicKeyInfo PEM 公钥。
- * @param namedCurve - 双方密钥使用的 NIST 曲线。
- * @returns 32 字节共享密钥。
- */
-export declare function DeriveECDHKeySHA256(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/date/index.d.mts

@@ -1,190 +0,0 @@
-//#region src/date/index.d.ts
-/** 可转换为日期的输入；数字始终按 Unix 毫秒时间戳处理。 */
-export type DateInput = Date | number | string;
-/** {@link formatRelativeTime} 的语言与基准时间选项。 */
-export interface RelativeTimeOptions {
-  /** `Intl.RelativeTimeFormat` 使用的语言；默认固定为 `zh-CN`。 */
-  locale?: string | readonly string[];
-  /** 比较基准，默认当前时间。 */
-  now?: DateInput;
-  /** 是否允许“昨天”“明天”等文本；默认 `auto`。 */
-  numeric?: Intl.RelativeTimeFormatNumeric;
-  /** 输出长度；默认 `long`。 */
-  style?: Intl.RelativeTimeFormatStyle;
-}
-/**
- * 转换并克隆有效日期。
- *
- * @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。
- * @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。
- * @returns 与输入不共享可变状态的新 Date。
- * @throws 输入无效时抛出 `TypeError`。
- */
-export declare function toDate(value: DateInput): Date;
-/**
- * 判断输入能否转换为有效日期。
- *
- * @param value - 任意待检查值。
- * @returns 仅 Date、数字或字符串且时间戳有限时返回 `true`。
- */
-export declare function isValidDate(value: unknown): value is DateInput;
-/**
- * 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。
- *
- * @param value - 有效日期输入。
- * @returns 新建的本地日开始时间。
- * @throws 输入无效时抛出 `TypeError`。
- */
-export declare function startOfDay(value: DateInput): Date;
-/**
- * 返回输入日期所在本地时区日期的 `23:59:59.999`，不修改输入。
- *
- * @param value - 有效日期输入。
- * @returns 新建的本地日结束时间。
- * @throws 输入无效时抛出 `TypeError`。
- */
-export declare function endOfDay(value: DateInput): Date;
-/**
- * 按本地日历增加整数天，不修改输入。
- *
- * @param value - 基准日期。
- * @param amount - 可为负数的安全整数日数。
- * @returns 本地日历运算后的新 Date；夏令时变化可能使实际毫秒差不等于 24 小时。
- * @throws 日期无效时抛出 `TypeError`；数量或结果非法时抛出 `RangeError`。
- */
-export declare function addDays(value: DateInput, amount: number): Date;
-/**
- * 按本地日历增加整数月，并把不存在的日期夹到目标月末。
- *
- * @example 1 月 31 日增加一个月会落在 2 月最后一天。
- * @param value - 基准日期。
- * @param amount - 可为负数的安全整数月数。
- * @returns 月份运算后的新 Date。
- * @throws 日期无效时抛出 `TypeError`；数量或结果非法时抛出 `RangeError`。
- */
-export declare function addMonths(value: DateInput, amount: number): Date;
-/**
- * 按本地日历增加整数年，并沿用 {@link addMonths} 的月末夹取规则。
- *
- * @param value - 基准日期。
- * @param amount - 可为负数的安全整数年数。
- * @returns 年份运算后的新 Date。
- * @throws 日期无效时抛出 `TypeError`；数量或结果非法时抛出 `RangeError`。
- */
-export declare function addYears(value: DateInput, amount: number): Date;
-/**
- * 判断两个输入是否属于同一本地日历日。
- *
- * @param left - 第一日期。
- * @param right - 第二日期。
- * @returns 本地年、月、日均相同时返回 `true`。
- * @throws 任一输入无效时抛出 `TypeError`。
- */
-export declare function isSameDay(left: DateInput, right: DateInput): boolean;
-/**
- * 判断时间是否晚于基准时间。
- *
- * @param value - 待比较时间。
- * @param now - 比较基准，默认调用时的当前时刻。
- * @returns `value` 严格晚于基准时返回 `true`。
- * @throws 任一输入无效时抛出 `TypeError`。
- */
-export declare function isFuture(value: DateInput, now?: DateInput): boolean;
-/**
- * 返回指定基准所在本地日历日的完整闭区间。
- *
- * @param value - 日期基准，默认调用时当前日期。
- * @returns 新建的本地日开始和结束时间二元组。
- * @throws 输入无效时抛出 `TypeError`。
- */
-export declare function getLocalDayBounds(value?: DateInput): [start: Date, end: Date];
-/**
- * 判断日期是否位于包含首尾的时间区间。
- *
- * @param value - 待检查日期。
- * @param start - 包含的起点。
- * @param end - 包含的终点。
- * @returns 时间戳位于闭区间内时返回 `true`。
- * @throws 无效日期抛出 `TypeError`；首尾反向时抛出 `RangeError`。
- */
-export declare function isWithinInterval(value: DateInput, start: DateInput, end: DateInput): boolean;
-/**
- * 使用 `Intl.RelativeTimeFormat` 生成人类可读相对时间。
- *
- * @remarks 秒、分钟、小时、天、周、月和年按固定时长阈值选择；这适合展示，不适合计费或日历运算。
- * @param value - 目标时间。
- * @param options - 语言、样式与比较基准。
- * @returns 由 `Intl.RelativeTimeFormat` 生成的本地化文本。
- * @throws 日期无效时抛出 `TypeError`；Locale 或 Intl 选项非法时抛出 `RangeError`。
- */
-export declare function formatRelativeTime(value: DateInput, options?: RelativeTimeOptions): string;
-/** 日期选择器单日期快捷项。 */
-export interface DateShortcut {
-  /** 面向中文日期选择器的显示文本；调用方可直接用于菜单标签。 */
-  text: string;
-  /**
-   * 计算快捷项对应日期。
-   * @returns 每次调用时基于当前本地时间创建的新 `Date`，调用方可安全修改。
-   */
-  value: () => Date;
-}
-/** 日期选择器范围快捷项。 */
-export interface DateRangeShortcut {
-  /** 面向中文日期范围选择器的显示文本；调用方可直接用于菜单标签。 */
-  text: string;
-  /**
-   * 计算快捷项对应的本地日期范围。
-   * @returns 每次调用时创建的新元组；起点为 `00:00:00.000`，终点为 `23:59:59.999`。
-   */
-  value: () => [start: Date, end: Date];
-}
-/**
- * 把日期转换为固定中文相对时间文本。
- *
- * @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。
- * @param value - Date、时间戳、可解析字符串或空值。
- * @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。
- */
-export declare function formatChineseRelativeTime(value: Date | number | string | null | undefined): string;
-/**
- * 创建从今天到前后一个月日期的完整本地日范围。
- *
- * @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。
- * @returns 每次调用新建的本地日首尾边界。
- */
-export declare function createOneMonthRangeFromToday(towardFuture?: boolean): [start: Date, end: Date];
-/**
- * 判断日期是否晚于调用时的当前时刻。
- *
- * @param time - 待比较日期。
- * @returns 时间戳严格晚于 `Date.now()` 时返回 `true`。
- */
-export declare function isDateAfterNow(time: Date): boolean;
-/**
- * 根据浏览器本地小时返回固定中文问候语。
- *
- * @returns 与当前时段对应的中文欢迎文本。
- */
-export declare function getLocalTimeGreeting(): string;
-/**
- * 创建面向过去或未来的常用完整日期范围快捷项。
- *
- * @param towardFuture - `true` 创建未来范围，默认创建历史范围。
- * @returns 每次求值都会重新读取当前时间的范围快捷项。
- */
-export declare function createDateRangeShortcuts(towardFuture?: boolean): DateRangeShortcut[];
-/**
- * 创建面向过去或未来的常用单日期快捷项。
- *
- * @param towardFuture - `true` 创建未来日期，默认创建历史日期。
- * @returns 每次求值都会重新读取当前时间的单日期快捷项。
- */
-export declare function createDateShortcuts(towardFuture?: boolean): DateShortcut[];
-/**
- * 返回今天的本地零点。
- *
- * @returns 新建的 `00:00:00.000` Date。
- */
-export declare function getStartOfToday(): Date;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/dom/style.d.mts

@@ -1,29 +0,0 @@
-//#region src/dom/style.d.ts
-/** 可序列化为内联 CSS 的单个值。 */
-export type StyleValue = number | string | null | undefined;
-/** camelCase、kebab-case 或 CSS 自定义属性组成的只读样式对象。 */
-export type StyleObject = Readonly<Record<string, StyleValue>>;
-/** 字符串、样式对象、嵌套数组或空值。 */
-export type StyleInput = string | StyleObject | readonly StyleInput[] | null | undefined;
-/**
- * 为数值或纯数字字符串添加 CSS 单位。
- *
- * @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。
- * @param unit - 非零数字使用的单位，默认 `px`。
- * @returns 零统一返回 `"0"`；非数字字符串保持原样。
- * @throws `RangeError` 当数字非有限或单位为空。
- */
-export declare function addCssUnit(value?: string | number | null, unit?: string): string;
-/**
- * 将样式字符串、对象或嵌套数组序列化为内联 CSS。
- *
- * @remarks 本函数只负责结构转换，不是 CSS 安全清洗器。不可信值必须由调用方按照
- * 实际渲染上下文验证，尤其不能允许用户控制属性名、`url()` 或自定义属性内容。
- * 数字不会自动附加单位；需要长度单位时应先调用 {@link addCssUnit}。
- * @param styles - 可嵌套样式输入；后出现的声明由 CSS 层叠规则覆盖先前声明。
- * @returns 以分号结束、以空格分隔的 CSS 声明字符串。
- * @throws `RangeError` 当对象中包含 `NaN` 或无穷数字。
- */
-export declare function serializeStyle(styles: StyleInput): string;
-//#endregion
-//# sourceMappingURL=style.d.mts.map

package/dist/env/index.d.mts

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

package/dist/function/index.d.mts

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