@fast-china/utils 2.1.6 → 2.1.8

package/dist/async/index.d.mts

@@ -1,145 +0,0 @@
-//#region src/async/index.d.ts
-/** 统一同步返回值与 PromiseLike 返回值的内部回调签名。 */
-type AsyncCallback<Arguments extends unknown[], Result> = (...arguments_: Arguments) => Result | PromiseLike<Result>;
-/** 可接收取消信号的通用选项。 */
-export interface AbortOptions {
-  /** 已取消时立即失败；运行期间取消时停止等待并拒绝 Promise。 */
-  signal?: AbortSignal;
-}
-/** {@link withTimeout} 的行为选项。 */
-export interface TimeoutOptions extends AbortOptions {
-  /** 超时时使用的开发者消息。 */
-  message?: string;
-}
-/** 每次重试操作接收的上下文。 */
-export interface RetryContext {
-  /** 从 1 开始的当前尝试次数。 */
-  attempt: number;
-  /** 调用方提供的取消信号。 */
-  signal?: AbortSignal;
-}
-/** {@link retry} 的策略选项。 */
-export interface RetryOptions extends AbortOptions {
-  /** 最大尝试次数，包含首次调用；默认 `3`。 */
-  attempts?: number;
-  /** 首次重试前的等待毫秒数，最大 2,147,483,647；默认 `200`。 */
-  delayMs?: number;
-  /** 每次失败后的退避倍数，必须不小于 1；默认 `2`。 */
-  factor?: number;
-  /** 单次等待上限，最大 2,147,483,647；默认 `30_000` 毫秒。 */
-  maxDelayMs?: number;
-  /**
-   * 决定当前失败后是否继续下一次尝试；默认重试所有尚未到达上限的错误。
-   * @param error - 当前操作抛出或拒绝的原始值。
-   * @param context - 当前尝试次数和调用方取消信号。
-   * @returns `false` 时立即原样抛出当前错误；支持同步值或 PromiseLike。
-   */
-  shouldRetry?: (error: unknown, context: RetryContext) => boolean | PromiseLike<boolean>;
-}
-/** {@link mapConcurrent} 的执行选项。 */
-export interface ConcurrentMapOptions {
-  /** 已取消时停止调度新任务；已经开始的映射器需要自行响应同一信号。 */
-  signal?: AbortSignal;
-}
-/** Promise 感知的防抖函数。 */
-export interface DebouncedFunction<Arguments extends unknown[], Result> {
-  /**
-   * 调度一次调用；同一等待窗口内的调用共享最后一组参数对应的结果。
-   * @param arguments_ - 传给原始回调的参数；后续调用会覆盖尚未执行批次保存的参数。
-   * @returns 当前批次的独立 Promise，最终与共享回调结果保持相同状态。
-   */
-  (...arguments_: Arguments): Promise<Result>;
-  /**
-   * 取消尚未执行的批次，并拒绝该批次的所有 Promise。
-   * @param reason - 可选拒绝原因；省略时使用内部取消错误。
-   */
-  cancel: (reason?: unknown) => void;
-  /**
-   * 立即执行待处理批次，不创建第二次回调执行。
-   * @returns 待处理批次的共享执行 Promise；没有批次时返回 `undefined`。
-   */
-  flush: () => Promise<Result> | undefined;
-  /** @returns 当前存在尚未开始的批次时返回 `true`；正在执行但没有等待批次时返回 `false`。 */
-  pending: () => boolean;
-}
-/** Promise 感知的前缘节流函数。 */
-export interface ThrottledFunction<Arguments extends unknown[], Result> {
-  /**
-   * 在空闲时立即调用原始回调；执行期和冷却期内的调用共享首次调用的 Promise。
-   * @param arguments_ - 仅窗口内首次调用的参数会传给原始回调。
-   * @returns 当前执行窗口共享的 Promise。
-   */
-  (...arguments_: Arguments): Promise<Result>;
-  /** 提前结束冷却期；已经开始的操作不会被取消，结束前仍禁止并发重入。 */
-  cancel: () => void;
-  /** @returns 原始回调正在执行或计时器仍处于冷却期时返回 `true`。 */
-  pending: () => boolean;
-}
-/**
- * 等待指定时间，并支持 `AbortSignal`。
- *
- * @param milliseconds - 0 至 2,147,483,647 的有限毫秒数。
- * @param options - 可选取消信号。
- * @returns 到期后完成的 Promise。
- * @throws 取消时抛出名称为 `AbortError` 的 `Error`；参数非法时抛出 `RangeError`。
- */
-export declare function sleep(milliseconds: number, options?: AbortOptions): Promise<void>;
-/**
- * 为 Promise 增加等待上限。
- *
- * @remarks 超时或取消只停止等待，不能自动取消底层操作；需要真正取消时应同时把
- * 同一个 `AbortSignal` 传给底层 API。
- * @param promise - 需要等待的 Promise 或 PromiseLike。
- * @param timeoutMs - 0 至 2,147,483,647 的有限等待时间。
- * @param options - 取消信号与自定义消息。
- * @returns 底层 Promise 的结果。
- * @throws 超时抛出 `Error`，取消时抛出名称为 `AbortError` 的 `Error`；等待时间非法时抛出 `RangeError`。
- */
-export declare function withTimeout<Result>(promise: PromiseLike<Result>, timeoutMs: number, options?: TimeoutOptions): Promise<Result>;
-/**
- * 使用有上限的指数退避重试操作。
- *
- * @typeParam Result - 操作结果类型。
- * @param operation - 每次尝试都会调用的函数；`attempt` 从 1 开始。
- * @param options - 尝试次数、退避和取消策略。
- * @returns 首次成功结果。
- * @throws 最后一次操作错误、`shouldRetry` 错误或名称为 `AbortError` 的取消错误；策略参数非法时抛出 `RangeError`。
- */
-export declare function retry<Result>(operation: (context: RetryContext) => Result | PromiseLike<Result>, options?: RetryOptions): Promise<Awaited<Result>>;
-/**
- * 以固定并发度映射数组，并保持结果顺序。
- *
- * @remarks 任一映射失败后不会再调度新项目，但已经开始的映射无法自动取消；映射器
- * 应使用传入的 `signal` 取消底层工作。
- * @param items - 不会被修改的输入数组。
- * @param concurrency - 同时运行的最大任务数，必须为正安全整数。
- * @param mapper - 接收项目、索引和取消信号的映射函数。
- * @param options - 可选取消信号。
- * @returns 与输入长度和顺序一致的结果数组；稀疏空位保持为空位且不会调用映射器。
- * @throws `RangeError` 当 `concurrency` 不是正安全整数；取消时抛出名称为 `AbortError` 的 `Error`。
- */
-export declare function mapConcurrent<Item, Result>(items: readonly Item[], concurrency: number, mapper: (item: Item, index: number, signal: AbortSignal | undefined) => Result | PromiseLike<Result>, options?: ConcurrentMapOptions): Promise<Awaited<Result>[]>;
-/**
- * 创建 Promise 感知的防抖函数。
- *
- * @remarks 同一窗口内的所有调用都会等待最后一组参数对应的执行结果；回调错误会原样
- * 拒绝该批次的全部调用，不会留下永久 pending 的 Promise。
- * @param callback - 同步或异步回调。
- * @param delayMs - 0 至 2,147,483,647 的有限等待时间，默认 300 毫秒。
- * @returns 具有取消、立即执行和状态方法的防抖函数。
- * @throws `RangeError` 当延迟不在平台计时器支持范围内。
- */
-export declare function debounce<Arguments extends unknown[], Result>(callback: AsyncCallback<Arguments, Result>, delayMs?: number): DebouncedFunction<Arguments, Awaited<Result>>;
-/**
- * 创建 Promise 感知的前缘节流函数。
- *
- * @remarks 窗口内的调用共享首次调用结果。若回调执行时间超过窗口，后续调用仍会等待
- * 当前回调，避免异步操作重入；该函数不安排尾缘调用。
- * @param callback - 同步或异步回调。
- * @param delayMs - 0 至 2,147,483,647 的有限冷却时间，默认 300 毫秒。
- * @returns 具有取消和状态方法的前缘节流函数。
- * @throws `RangeError` 当延迟不在平台计时器支持范围内。
- */
-export declare function throttle<Arguments extends unknown[], Result>(callback: AsyncCallback<Arguments, Result>, delayMs?: number): ThrottledFunction<Arguments, Awaited<Result>>;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

package/dist/base64/index.d.mts

@@ -1,106 +0,0 @@
-import { DecodedText } from "../internal/text.mjs";
-//#region src/base64/index.d.ts
-/**
- * 将任意字节编码为标准 Base64。
- *
- * @param bytes - 不会被修改的字节序列。
- * @returns 带标准 `=` 填充的 Base64 文本。
- */
-export declare function encodeBase64Bytes(bytes: Uint8Array): string;
-/**
- * 解码标准 Base64。
- *
- * @remarks 允许省略填充和包含 ASCII 空白，但拒绝非规范尾部位。
- * @param value - Base64 文本。
- * @returns 新建的字节数组。
- * @throws 输入非法时抛出 `TypeError`。
- */
-export declare function decodeBase64Bytes(value: string): Uint8Array;
-/**
- * 将 UTF-8 文本编码为标准 Base64。
- *
- * @param value - 任意 Unicode 字符串。
- * @returns 带标准填充的 Base64 文本。
- * @throws 缺少 Encoding API 时抛出 `Error`。
- */
-export declare function encodeBase64(value: string): string;
-/**
- * 将标准 Base64 解码为 UTF-8 文本。
- *
- * @param value - Base64 文本。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 Unicode 字符串。
- * @throws Base64 或 UTF-8 非法时抛出 `TypeError`；缺少 Encoding API 时抛出 `Error`。
- */
-export declare function decodeBase64(value: string): DecodedText;
-/**
- * 将任意字节编码为无填充 Base64URL。
- *
- * @param bytes - 不会被修改的字节序列。
- * @returns 仅使用 URL 安全字母表的文本。
- */
-export declare function encodeBase64UrlBytes(bytes: Uint8Array): string;
-/**
- * 解码 Base64URL 字节。
- *
- * @remarks 接受带填充和无填充形式，不接受空白或标准 Base64 的 `+`、`/`。
- * @param value - Base64URL 文本。
- * @returns 新建的字节数组。
- * @throws 输入非法时抛出 `TypeError`。
- */
-export declare function decodeBase64UrlBytes(value: string): Uint8Array;
-/**
- * 将 UTF-8 文本编码为无填充 Base64URL。
- *
- * @param value - 任意 Unicode 字符串。
- * @returns 仅使用 URL 安全字母表的文本。
- * @throws 缺少 Encoding API 时抛出 `Error`。
- */
-export declare function encodeBase64Url(value: string): string;
-/**
- * 将 Base64URL 解码为 UTF-8 文本。
- *
- * @param value - 带填充或无填充的 Base64URL 文本。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 Unicode 字符串。
- * @throws Base64URL 或 UTF-8 非法时抛出 `TypeError`；缺少 Encoding API 时抛出 `Error`。
- */
-export declare function decodeBase64Url(value: string): DecodedText;
-/**
- * 把 Latin-1 文本编码为标准 Base64。
- *
- * @param value - 每个 UTF-16 码元都必须位于 0–255 的文本。
- * @returns 带标准填充的 Base64 文本。
- * @throws `TypeError` 当文本包含 Latin-1 范围外的码元。
- */
-export declare function encodeLatin1Base64(value: string): string;
-/**
- * 把标准 Base64 解码为 Latin-1 文本。
- *
- * @param value - 标准 Base64 文本；允许 ASCII 空白和省略尾部填充。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的 Latin-1 原始字符串。
- * @throws `TypeError` 当 Base64 格式或尾部位非法。
- */
-export declare function decodeLatin1Base64(value: string): DecodedText;
-/**
- * 使用固定字典和随机前缀编码文本。
- *
- * @remarks 给定相同的 6 字符前缀时，默认输出与旧有效载荷逐字符兼容。旧字典在 101–124 字符载荷中引用越界；这里复制末字符作为单字符回退，
- * 使旧删除字典流程仍能解码。传入 `0` 会同时关闭随机前缀与字典插入。
- * 该格式只是可逆编码，不提供加密、完整性或身份认证。
- * @param value - 任意可由 `encodeURIComponent` 处理的 Unicode 文本。
- * @param prefixLength - 随机字母前缀长度；默认 `6`。
- * @returns 带随机前缀和兼容字典字符的 Base64 文本；空输入返回空字符串。
- * @throws `RangeError` 当前缀长度不是非负安全整数；输入包含孤立代理项时保留平台错误。
- */
-export declare function encodeSecureBase64(value: string, prefixLength?: number): string;
-/**
- * 解码 {@link encodeSecureBase64} 生成的 SecureBase64 兼容格式。
- *
- * @param value - SecureBase64 文本；必须使用与编码时相同的前缀长度。
- * @param prefixLength - 需要移除的前缀长度；默认 `6`，传入 `0` 时不移除字典字符。
- * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 Unicode 字符串；空输入返回空字符串。
- * @throws `RangeError` 当前缀长度不是非负安全整数；载荷、Base64 或 URI 编码非法时抛出 `TypeError` 或 `URIError`。
- */
-export declare function decodeSecureBase64(value: string, prefixLength?: number): DecodedText;
-//#endregion
-export type { DecodedText };
-//# sourceMappingURL=index.d.mts.map

package/dist/color/index.d.mts

@@ -1,89 +0,0 @@
-//#region src/color/index.d.ts
-/** 0 至 255 范围的 RGB 颜色。 */
-export interface RgbColor {
-  /** 蓝色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */
-  blue: number;
-  /** 绿色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */
-  green: number;
-  /** 红色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */
-  red: number;
-}
-/** 带 0 至 1 Alpha 通道的 RGB 颜色。 */
-export interface RgbaColor extends RgbColor {
-  /** 不透明度；必须是闭区间 `[0, 1]` 内的有限数，`0` 完全透明，`1` 完全不透明。 */
-  alpha: number;
-}
-/**
- * 解析可带可不带 `#` 的 `rgb`、`rgba`、`rrggbb` 或 `rrggbbaa`。
- *
- * @param value - 十六进制颜色文本。
- * @returns 标准化的 RGBA 对象；省略 Alpha 时为 1。
- * @throws 输入非法时抛出 `TypeError`。
- */
-export declare function parseHexColor(value: string): RgbaColor;
-/**
- * 把 RGB 或 RGBA 对象格式化为小写十六进制颜色。
- *
- * @param color - 颜色通道；RGB 会四舍五入到最近整数。
- * @param includeAlpha - 是否输出 Alpha；默认只在传入 Alpha 且小于 1 时输出。
- * @returns 小写 `#rrggbb` 或 `#rrggbbaa` 文本。
- * @throws 通道或 Alpha 非法时抛出 `RangeError`。
- */
-export declare function formatHexColor(color: RgbColor | RgbaColor, includeAlpha?: boolean): string;
-/**
- * 线性混合两种十六进制颜色，包括 Alpha 通道。
- *
- * @param first - `amount = 0` 时的颜色。
- * @param second - `amount = 1` 时的颜色。
- * @param amount - 0 至 1 的混合比例。
- * @returns 小写十六进制颜色；任一输入含透明度时保留 Alpha。
- * @throws 颜色非法时抛出 `TypeError`；比例非法时抛出 `RangeError`。
- */
-export declare function mixHexColors(first: string, second: string, amount: number): string;
-/**
- * 按比例向黑色混合。
- *
- * @param color - 合法十六进制颜色。
- * @param amount - 0 至 1 的混合比例。
- * @returns 混入黑色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。
- */
-export declare function mixHexColorWithBlack(color: string, amount: number): string;
-/**
- * 按比例向白色混合。
- *
- * @param color - 合法十六进制颜色。
- * @param amount - 0 至 1 的混合比例。
- * @returns 混入白色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。
- */
-export declare function mixHexColorWithWhite(color: string, amount: number): string;
-/**
- * 计算 WCAG sRGB 相对亮度。
- *
- * @remarks Alpha 通道不会参与计算；半透明颜色应先与实际背景混合。
- * @param color - 合法十六进制颜色。
- * @returns 0 至 1 的相对亮度。
- * @throws 输入非法时抛出 `TypeError`。
- */
-export declare function relativeLuminance(color: string): number;
-/**
- * 计算两种不透明颜色的 WCAG 对比度，范围 1 至 21。
- *
- * @remarks 返回比值本身，不代表特定字号或 WCAG 等级必然通过。
- * @param first - 第一种十六进制颜色。
- * @param second - 第二种十六进制颜色。
- * @returns 较亮颜色与较暗颜色的对比度。
- * @throws 输入非法时抛出 `TypeError`。
- */
-export declare function contrastRatio(first: string, second: string): number;
-/**
- * 从两个候选颜色中选择与背景对比度更高的一项。
- *
- * @param background - 实际不透明背景色。
- * @param first - 第一候选，默认黑色。
- * @param second - 第二候选，默认白色。
- * @returns 对比度较高的原始候选字符串；相同时返回 `first`。
- * @throws 任一颜色非法时抛出 `TypeError`。
- */
-export declare function pickHigherContrastColor(background: string, first?: string, second?: string): string;
-//#endregion
-//# sourceMappingURL=index.d.mts.map

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