@fast-china/utils 2.1.3 → 2.1.5

package/dist/color/index.d.mts

@@ -1,6 +1,6 @@
 //#region src/color/index.d.ts
 /** 0 至 255 范围的 RGB 颜色。 */
-interface RgbColor {
+export interface RgbColor {
   /** 蓝色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */
   blue: number;
   /** 绿色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */
@@ -9,7 +9,7 @@ interface RgbColor {
   red: number;
 }
 /** 带 0 至 1 Alpha 通道的 RGB 颜色。 */
-interface RgbaColor extends RgbColor {
+export interface RgbaColor extends RgbColor {
   /** 不透明度；必须是闭区间 `[0, 1]` 内的有限数，`0` 完全透明，`1` 完全不透明。 */
   alpha: number;
 }
@@ -20,7 +20,7 @@ interface RgbaColor extends RgbColor {
  * @returns 标准化的 RGBA 对象；省略 Alpha 时为 1。
  * @throws 输入非法时抛出 `TypeError`。
  */
-declare function parseHexColor(value: string): RgbaColor;
+export declare function parseHexColor(value: string): RgbaColor;
 /**
  * 把 RGB 或 RGBA 对象格式化为小写十六进制颜色。
  *
@@ -29,7 +29,7 @@ declare function parseHexColor(value: string): RgbaColor;
  * @returns 小写 `#rrggbb` 或 `#rrggbbaa` 文本。
  * @throws 通道或 Alpha 非法时抛出 `RangeError`。
  */
-declare function formatHexColor(color: RgbColor | RgbaColor, includeAlpha?: boolean): string;
+export declare function formatHexColor(color: RgbColor | RgbaColor, includeAlpha?: boolean): string;
 /**
  * 线性混合两种十六进制颜色，包括 Alpha 通道。
  *
@@ -39,7 +39,7 @@ declare function formatHexColor(color: RgbColor | RgbaColor, includeAlpha?: bool
  * @returns 小写十六进制颜色；任一输入含透明度时保留 Alpha。
  * @throws 颜色非法时抛出 `TypeError`；比例非法时抛出 `RangeError`。
  */
-declare function mixHexColors(first: string, second: string, amount: number): string;
+export declare function mixHexColors(first: string, second: string, amount: number): string;
 /**
  * 按比例向黑色混合。
  *
@@ -47,7 +47,7 @@ declare function mixHexColors(first: string, second: string, amount: number): st
  * @param amount - 0 至 1 的混合比例。
  * @returns 混入黑色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。
  */
-declare function mixHexColorWithBlack(color: string, amount: number): string;
+export declare function mixHexColorWithBlack(color: string, amount: number): string;
 /**
  * 按比例向白色混合。
  *
@@ -55,7 +55,7 @@ declare function mixHexColorWithBlack(color: string, amount: number): string;
  * @param amount - 0 至 1 的混合比例。
  * @returns 混入白色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。
  */
-declare function mixHexColorWithWhite(color: string, amount: number): string;
+export declare function mixHexColorWithWhite(color: string, amount: number): string;
 /**
  * 计算 WCAG sRGB 相对亮度。
  *
@@ -64,7 +64,7 @@ declare function mixHexColorWithWhite(color: string, amount: number): string;
  * @returns 0 至 1 的相对亮度。
  * @throws 输入非法时抛出 `TypeError`。
  */
-declare function relativeLuminance(color: string): number;
+export declare function relativeLuminance(color: string): number;
 /**
  * 计算两种不透明颜色的 WCAG 对比度，范围 1 至 21。
  *
@@ -74,7 +74,7 @@ declare function relativeLuminance(color: string): number;
  * @returns 较亮颜色与较暗颜色的对比度。
  * @throws 输入非法时抛出 `TypeError`。
  */
-declare function contrastRatio(first: string, second: string): number;
+export declare function contrastRatio(first: string, second: string): number;
 /**
  * 从两个候选颜色中选择与背景对比度更高的一项。
  *
@@ -84,7 +84,6 @@ declare function contrastRatio(first: string, second: string): number;
  * @returns 对比度较高的原始候选字符串；相同时返回 `first`。
  * @throws 任一颜色非法时抛出 `TypeError`。
  */
-declare function pickHigherContrastColor(background: string, first?: string, second?: string): string;
+export declare function pickHigherContrastColor(background: string, first?: string, second?: string): string;
 //#endregion
-export { RgbColor, RgbaColor, contrastRatio, formatHexColor, mixHexColorWithBlack, mixHexColorWithWhite, mixHexColors, parseHexColor, pickHigherContrastColor, relativeLuminance };
 //# sourceMappingURL=index.d.mts.map

package/dist/color/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/color/index.ts"],"sourcesContent":["/** 0 至 255 范围的 RGB 颜色。 */\nexport interface RgbColor {\n\t/** 蓝色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tblue: number;\n\t/** 绿色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tgreen: number;\n\t/** 红色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tred: number;\n}\n\n/** 带 0 至 1 Alpha 通道的 RGB 颜色。 */\nexport interface RgbaColor extends RgbColor {\n\t/** 不透明度；必须是闭区间 `[0, 1]` 内的有限数，`0` 完全透明，`1` 完全不透明。 */\n\talpha: number;\n}\n\n/**\n * 校验 RGB 颜色通道。\n *\n * @param value - 待校验通道值。\n * @param channel - 用于错误消息的通道名称。\n * @throws `RangeError` 当值非有限或超出 0 至 255。\n */\nconst assertRgbChannel = (value: number, channel: string): void => {\n\tif (!Number.isFinite(value) || value < 0 || value > 255) {\n\t\tthrow new RangeError(`\\`${channel}\\` 必须是 0 到 255 之间的有限数。`);\n\t}\n};\n\n/**\n * 校验透明度通道。\n *\n * @param value - 待校验 Alpha 值。\n * @throws `RangeError` 当值非有限或超出闭区间 `[0, 1]`。\n */\nconst assertAlpha = (value: number): void => {\n\tif (!Number.isFinite(value) || value < 0 || value > 1) {\n\t\tthrow new RangeError(\"`alpha` 必须是 0 到 1 之间的有限数。\");\n\t}\n};\n\n/**\n * 规范化十六进制颜色文本。\n *\n * @param value - 可带 `#` 的 3、4、6 或 8 位颜色文本。\n * @returns 不带 `#` 的 6 或 8 位文本。\n * @throws `TypeError` 当长度或字符不符合十六进制颜色格式。\n */\nconst normalizeHexColor = (value: string): string => {\n\tconst normalized = value.startsWith(\"#\") ? value.slice(1) : value;\n\tif (![3, 4, 6, 8].includes(normalized.length) || !/^[\\dA-F]+$/iu.test(normalized)) {\n\t\tthrow new TypeError(\"十六进制颜色必须包含 3、4、6 或 8 个十六进制字符。\");\n\t}\n\treturn normalized.length <= 4 ? Array.from(normalized, (character) => `${character}${character}`).join(\"\") : normalized;\n};\n\n/**\n * 格式化单个颜色通道。\n *\n * @param value - 已校验的 0 至 255 通道值。\n * @returns 舍入后的两位小写十六进制文本。\n */\nconst formatHexChannel = (value: number): string => Math.round(value).toString(16).padStart(2, \"0\");\n\n/**\n * 解析可带可不带 `#` 的 `rgb`、`rgba`、`rrggbb` 或 `rrggbbaa`。\n *\n * @param value - 十六进制颜色文本。\n * @returns 标准化的 RGBA 对象；省略 Alpha 时为 1。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function parseHexColor(value: string): RgbaColor {\n\tconst normalized = normalizeHexColor(value);\n\treturn {\n\t\tred: Number.parseInt(normalized.slice(0, 2), 16),\n\t\tgreen: Number.parseInt(normalized.slice(2, 4), 16),\n\t\tblue: Number.parseInt(normalized.slice(4, 6), 16),\n\t\talpha: normalized.length === 8 ? Number.parseInt(normalized.slice(6, 8), 16) / 255 : 1,\n\t};\n}\n\n/**\n * 把 RGB 或 RGBA 对象格式化为小写十六进制颜色。\n *\n * @param color - 颜色通道；RGB 会四舍五入到最近整数。\n * @param includeAlpha - 是否输出 Alpha；默认只在传入 Alpha 且小于 1 时输出。\n * @returns 小写 `#rrggbb` 或 `#rrggbbaa` 文本。\n * @throws 通道或 Alpha 非法时抛出 `RangeError`。\n */\nexport function formatHexColor(color: RgbColor | RgbaColor, includeAlpha: boolean = \"alpha\" in color && color.alpha < 1): string {\n\tassertRgbChannel(color.red, \"red\");\n\tassertRgbChannel(color.green, \"green\");\n\tassertRgbChannel(color.blue, \"blue\");\n\tconst alpha = \"alpha\" in color ? color.alpha : 1;\n\tassertAlpha(alpha);\n\tconst rgb = `${formatHexChannel(color.red)}${formatHexChannel(color.green)}${formatHexChannel(color.blue)}`;\n\treturn `#${rgb}${includeAlpha ? formatHexChannel(alpha * 255) : \"\"}`;\n}\n\n/**\n * 线性混合两种十六进制颜色，包括 Alpha 通道。\n *\n * @param first - `amount = 0` 时的颜色。\n * @param second - `amount = 1` 时的颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 小写十六进制颜色；任一输入含透明度时保留 Alpha。\n * @throws 颜色非法时抛出 `TypeError`；比例非法时抛出 `RangeError`。\n */\nexport function mixHexColors(first: string, second: string, amount: number): string {\n\tif (!Number.isFinite(amount) || amount < 0 || amount > 1) {\n\t\tthrow new RangeError(\"`amount` 必须是 0 到 1 之间的有限数。\");\n\t}\n\tconst left = parseHexColor(first);\n\tconst right = parseHexColor(second);\n\t/**\n\t * 在单个 RGBA 通道上执行与外层相同权重的线性混合。\n\t *\n\t * @param start - 第一个颜色的通道值。\n\t * @param end - 第二个颜色的通道值。\n\t * @returns 按外层 `amount` 线性混合后的通道值。\n\t */\n\tconst mix = (start: number, end: number): number => start + (end - start) * amount;\n\treturn formatHexColor(\n\t\t{\n\t\t\tred: mix(left.red, right.red),\n\t\t\tgreen: mix(left.green, right.green),\n\t\t\tblue: mix(left.blue, right.blue),\n\t\t\talpha: mix(left.alpha, right.alpha),\n\t\t},\n\t\tleft.alpha < 1 || right.alpha < 1\n\t);\n}\n\n/**\n * 按比例向黑色混合。\n *\n * @param color - 合法十六进制颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 混入黑色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。\n */\nexport function mixHexColorWithBlack(color: string, amount: number): string {\n\treturn mixHexColors(color, \"#000000\", amount);\n}\n\n/**\n * 按比例向白色混合。\n *\n * @param color - 合法十六进制颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 混入白色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。\n */\nexport function mixHexColorWithWhite(color: string, amount: number): string {\n\treturn mixHexColors(color, \"#ffffff\", amount);\n}\n\n/**\n * 按 WCAG sRGB 转换曲线线性化颜色通道。\n *\n * @param channel - 已校验的 0 至 255 通道值。\n * @returns 0 至 1 的线性光值。\n */\nconst linearizeSrgbChannel = (channel: number): number => {\n\tconst value = channel / 255;\n\treturn value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n};\n\n/**\n * 计算 WCAG sRGB 相对亮度。\n *\n * @remarks Alpha 通道不会参与计算；半透明颜色应先与实际背景混合。\n * @param color - 合法十六进制颜色。\n * @returns 0 至 1 的相对亮度。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function relativeLuminance(color: string): number {\n\tconst { red, green, blue } = parseHexColor(color);\n\treturn 0.2126 * linearizeSrgbChannel(red) + 0.7152 * linearizeSrgbChannel(green) + 0.0722 * linearizeSrgbChannel(blue);\n}\n\n/**\n * 计算两种不透明颜色的 WCAG 对比度，范围 1 至 21。\n *\n * @remarks 返回比值本身，不代表特定字号或 WCAG 等级必然通过。\n * @param first - 第一种十六进制颜色。\n * @param second - 第二种十六进制颜色。\n * @returns 较亮颜色与较暗颜色的对比度。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function contrastRatio(first: string, second: string): number {\n\tconst firstLuminance = relativeLuminance(first);\n\tconst secondLuminance = relativeLuminance(second);\n\tconst lighter = Math.max(firstLuminance, secondLuminance);\n\tconst darker = Math.min(firstLuminance, secondLuminance);\n\treturn (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * 从两个候选颜色中选择与背景对比度更高的一项。\n *\n * @param background - 实际不透明背景色。\n * @param first - 第一候选，默认黑色。\n * @param second - 第二候选，默认白色。\n * @returns 对比度较高的原始候选字符串；相同时返回 `first`。\n * @throws 任一颜色非法时抛出 `TypeError`。\n */\nexport function pickHigherContrastColor(background: string, first = \"#000000\", second = \"#ffffff\"): string {\n\treturn contrastRatio(background, first) >= contrastRatio(background, second) ? first : second;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/color/index.ts"],"sourcesContent":["/** 0 至 255 范围的 RGB 颜色。 */\nexport interface RgbColor {\n\t/** 蓝色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tblue: number;\n\t/** 绿色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tgreen: number;\n\t/** 红色通道；必须是闭区间 `[0, 255]` 内的有限数，格式化时舍入到整数。 */\n\tred: number;\n}\n\n/** 带 0 至 1 Alpha 通道的 RGB 颜色。 */\nexport interface RgbaColor extends RgbColor {\n\t/** 不透明度；必须是闭区间 `[0, 1]` 内的有限数，`0` 完全透明，`1` 完全不透明。 */\n\talpha: number;\n}\n\n/**\n * 校验 RGB 颜色通道。\n *\n * @param value - 待校验通道值。\n * @param channel - 用于错误消息的通道名称。\n * @throws `RangeError` 当值非有限或超出 0 至 255。\n */\nconst assertRgbChannel = (value: number, channel: string): void => {\n\tif (!Number.isFinite(value) || value < 0 || value > 255) {\n\t\tthrow new RangeError(`\\`${channel}\\` 必须是 0 到 255 之间的有限数。`);\n\t}\n};\n\n/**\n * 校验透明度通道。\n *\n * @param value - 待校验 Alpha 值。\n * @throws `RangeError` 当值非有限或超出闭区间 `[0, 1]`。\n */\nconst assertAlpha = (value: number): void => {\n\tif (!Number.isFinite(value) || value < 0 || value > 1) {\n\t\tthrow new RangeError(\"`alpha` 必须是 0 到 1 之间的有限数。\");\n\t}\n};\n\n/**\n * 规范化十六进制颜色文本。\n *\n * @param value - 可带 `#` 的 3、4、6 或 8 位颜色文本。\n * @returns 不带 `#` 的 6 或 8 位文本。\n * @throws `TypeError` 当长度或字符不符合十六进制颜色格式。\n */\nconst normalizeHexColor = (value: string): string => {\n\tconst normalized = value.startsWith(\"#\") ? value.slice(1) : value;\n\tif (![3, 4, 6, 8].includes(normalized.length) || !/^[\\dA-F]+$/iu.test(normalized)) {\n\t\tthrow new TypeError(\"十六进制颜色必须包含 3、4、6 或 8 个十六进制字符。\");\n\t}\n\treturn normalized.length <= 4 ? Array.from(normalized, (character) => `${character}${character}`).join(\"\") : normalized;\n};\n\n/**\n * 格式化单个颜色通道。\n *\n * @param value - 已校验的 0 至 255 通道值。\n * @returns 舍入后的两位小写十六进制文本。\n */\nconst formatHexChannel = (value: number): string => Math.round(value).toString(16).padStart(2, \"0\");\n\n/**\n * 解析可带可不带 `#` 的 `rgb`、`rgba`、`rrggbb` 或 `rrggbbaa`。\n *\n * @param value - 十六进制颜色文本。\n * @returns 标准化的 RGBA 对象；省略 Alpha 时为 1。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function parseHexColor(value: string): RgbaColor {\n\tconst normalized = normalizeHexColor(value);\n\treturn {\n\t\tred: Number.parseInt(normalized.slice(0, 2), 16),\n\t\tgreen: Number.parseInt(normalized.slice(2, 4), 16),\n\t\tblue: Number.parseInt(normalized.slice(4, 6), 16),\n\t\talpha: normalized.length === 8 ? Number.parseInt(normalized.slice(6, 8), 16) / 255 : 1,\n\t};\n}\n\n/**\n * 把 RGB 或 RGBA 对象格式化为小写十六进制颜色。\n *\n * @param color - 颜色通道；RGB 会四舍五入到最近整数。\n * @param includeAlpha - 是否输出 Alpha；默认只在传入 Alpha 且小于 1 时输出。\n * @returns 小写 `#rrggbb` 或 `#rrggbbaa` 文本。\n * @throws 通道或 Alpha 非法时抛出 `RangeError`。\n */\nexport function formatHexColor(color: RgbColor | RgbaColor, includeAlpha: boolean = \"alpha\" in color && color.alpha < 1): string {\n\tassertRgbChannel(color.red, \"red\");\n\tassertRgbChannel(color.green, \"green\");\n\tassertRgbChannel(color.blue, \"blue\");\n\tconst alpha = \"alpha\" in color ? color.alpha : 1;\n\tassertAlpha(alpha);\n\tconst rgb = `${formatHexChannel(color.red)}${formatHexChannel(color.green)}${formatHexChannel(color.blue)}`;\n\treturn `#${rgb}${includeAlpha ? formatHexChannel(alpha * 255) : \"\"}`;\n}\n\n/**\n * 线性混合两种十六进制颜色，包括 Alpha 通道。\n *\n * @param first - `amount = 0` 时的颜色。\n * @param second - `amount = 1` 时的颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 小写十六进制颜色；任一输入含透明度时保留 Alpha。\n * @throws 颜色非法时抛出 `TypeError`；比例非法时抛出 `RangeError`。\n */\nexport function mixHexColors(first: string, second: string, amount: number): string {\n\tif (!Number.isFinite(amount) || amount < 0 || amount > 1) {\n\t\tthrow new RangeError(\"`amount` 必须是 0 到 1 之间的有限数。\");\n\t}\n\tconst left = parseHexColor(first);\n\tconst right = parseHexColor(second);\n\t/**\n\t * 在单个 RGBA 通道上执行与外层相同权重的线性混合。\n\t *\n\t * @param start - 第一个颜色的通道值。\n\t * @param end - 第二个颜色的通道值。\n\t * @returns 按外层 `amount` 线性混合后的通道值。\n\t */\n\tconst mix = (start: number, end: number) => start + (end - start) * amount;\n\treturn formatHexColor(\n\t\t{\n\t\t\tred: mix(left.red, right.red),\n\t\t\tgreen: mix(left.green, right.green),\n\t\t\tblue: mix(left.blue, right.blue),\n\t\t\talpha: mix(left.alpha, right.alpha),\n\t\t},\n\t\tleft.alpha < 1 || right.alpha < 1\n\t);\n}\n\n/**\n * 按比例向黑色混合。\n *\n * @param color - 合法十六进制颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 混入黑色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。\n */\nexport function mixHexColorWithBlack(color: string, amount: number): string {\n\treturn mixHexColors(color, \"#000000\", amount);\n}\n\n/**\n * 按比例向白色混合。\n *\n * @param color - 合法十六进制颜色。\n * @param amount - 0 至 1 的混合比例。\n * @returns 混入白色后的十六进制颜色；参数与异常语义见 {@link mixHexColors}。\n */\nexport function mixHexColorWithWhite(color: string, amount: number): string {\n\treturn mixHexColors(color, \"#ffffff\", amount);\n}\n\n/**\n * 按 WCAG sRGB 转换曲线线性化颜色通道。\n *\n * @param channel - 已校验的 0 至 255 通道值。\n * @returns 0 至 1 的线性光值。\n */\nconst linearizeSrgbChannel = (channel: number): number => {\n\tconst value = channel / 255;\n\treturn value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n};\n\n/**\n * 计算 WCAG sRGB 相对亮度。\n *\n * @remarks Alpha 通道不会参与计算；半透明颜色应先与实际背景混合。\n * @param color - 合法十六进制颜色。\n * @returns 0 至 1 的相对亮度。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function relativeLuminance(color: string): number {\n\tconst { red, green, blue } = parseHexColor(color);\n\treturn 0.2126 * linearizeSrgbChannel(red) + 0.7152 * linearizeSrgbChannel(green) + 0.0722 * linearizeSrgbChannel(blue);\n}\n\n/**\n * 计算两种不透明颜色的 WCAG 对比度，范围 1 至 21。\n *\n * @remarks 返回比值本身，不代表特定字号或 WCAG 等级必然通过。\n * @param first - 第一种十六进制颜色。\n * @param second - 第二种十六进制颜色。\n * @returns 较亮颜色与较暗颜色的对比度。\n * @throws 输入非法时抛出 `TypeError`。\n */\nexport function contrastRatio(first: string, second: string): number {\n\tconst firstLuminance = relativeLuminance(first);\n\tconst secondLuminance = relativeLuminance(second);\n\tconst lighter = Math.max(firstLuminance, secondLuminance);\n\tconst darker = Math.min(firstLuminance, secondLuminance);\n\treturn (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * 从两个候选颜色中选择与背景对比度更高的一项。\n *\n * @param background - 实际不透明背景色。\n * @param first - 第一候选，默认黑色。\n * @param second - 第二候选，默认白色。\n * @returns 对比度较高的原始候选字符串；相同时返回 `first`。\n * @throws 任一颜色非法时抛出 `TypeError`。\n */\nexport function pickHigherContrastColor(background: string, first = \"#000000\", second = \"#ffffff\"): string {\n\treturn contrastRatio(background, first) >= contrastRatio(background, second) ? first : second;\n}\n"],"mappings":"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"}

package/dist/crypto/index.d.mts

@@ -2,18 +2,18 @@ import { DecodedText } from "../internal/text.mjs";
 import "crypto-js/pad-ansix923.js";
 //#region src/crypto/index.d.ts
 /** AES 分组密码模式；与 .NET `CipherMode.CBC` 和 `CipherMode.ECB` 对应。 */
-type AesCipherMode = "CBC" | "ECB";
+export type AesCipherMode = "CBC" | "ECB";
 /** AES 填充模式；与 .NET `PaddingMode` 中可由 CryptoJS 互操作的成员对应。 */
-type AesPaddingMode = "None" | "PKCS7" | "Zeros" | "ANSIX923" | "ISO10126";
+export type AesPaddingMode = "None" | "PKCS7" | "Zeros" | "ANSIX923" | "ISO10126";
 /** Web Crypto 导出的 PEM 公私钥对。 */
-interface PemKeyPair {
+export interface PemKeyPair {
   /** 未加密的 PKCS#8 PEM 私钥，包含标准 `PRIVATE KEY` 头尾和 64 字符换行。 */
   privateKey: string;
   /** SubjectPublicKeyInfo PEM 公钥，包含标准 `PUBLIC KEY` 头尾和 64 字符换行。 */
   publicKey: string;
 }
 /** 本模块支持的 Web Crypto 椭圆曲线。 */
-type EcNamedCurve = "P-256" | "P-384" | "P-521";
+export type EcNamedCurve = "P-256" | "P-384" | "P-521";
 /**
  * 生成随机字节。
  *
@@ -22,7 +22,7 @@ type EcNamedCurve = "P-256" | "P-384" | "P-521";
  * @returns 新建的 `Uint8Array`。
  * @throws 参数非法时抛出 `RangeError`。
  */
-declare function GenerateRandomBytes(length: number): Uint8Array;
+export declare function GenerateRandomBytes(length: number): Uint8Array;
 /**
  * 以不提前退出的方式比较两个字节数组。
  *
@@ -32,7 +32,7 @@ declare function GenerateRandomBytes(length: number): Uint8Array;
  * @param right - 第二字节序列。
  * @returns 长度和每个字节均相同时返回 `true`。
  */
-declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
+export declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
 /**
  * 计算 MD5 摘要并返回小写十六进制文本。
  *
@@ -40,7 +40,7 @@ declare function FixedTimeEquals(left: Uint8Array, right: Uint8Array): boolean;
  * @param value - UTF-8 文本。
  * @returns 32 字符小写十六进制摘要。
  */
-declare function MD5Encrypt(value: string): string;
+export declare function MD5Encrypt(value: string): string;
 /**
  * 计算 SHA-1 摘要并返回大写十六进制文本。
  *
@@ -48,7 +48,7 @@ declare function MD5Encrypt(value: string): string;
  * @param value - UTF-8 文本。
  * @returns 40 字符大写十六进制摘要。
  */
-declare function SHA1Encrypt(value: string): string;
+export declare function SHA1Encrypt(value: string): string;
 /**
  * 计算 SHA-256 摘要。
  *
@@ -57,7 +57,7 @@ declare function SHA1Encrypt(value: string): string;
  * @returns 32 字节摘要。
  * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function SHA256Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA256Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-256 并格式化为十六进制。
  *
@@ -65,35 +65,35 @@ declare function SHA256Bytes(value: string): Promise<Uint8Array>;
  * @returns 64 字符大写十六进制文本。
  * @throws 缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function SHA256Encrypt(value: string): Promise<string>;
+export declare function SHA256Encrypt(value: string): Promise<string>;
 /**
  * 计算 SHA-384 摘要。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 48 字节摘要。
  */
-declare function SHA384Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA384Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-384 并格式化为十六进制文本。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 96 个大写十六进制字符组成的摘要。
  */
-declare function SHA384Encrypt(value: string): Promise<string>;
+export declare function SHA384Encrypt(value: string): Promise<string>;
 /**
  * 计算 SHA-512 摘要。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 64 字节摘要。
  */
-declare function SHA512Bytes(value: string): Promise<Uint8Array>;
+export declare function SHA512Bytes(value: string): Promise<Uint8Array>;
 /**
  * 计算 SHA-512 并格式化为十六进制文本。
  *
  * @param value - UTF-8 文本或原始字节。
  * @returns 128 个大写十六进制字符组成的摘要。
  */
-declare function SHA512Encrypt(value: string): Promise<string>;
+export declare function SHA512Encrypt(value: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-256 认证文本，并返回十六进制标签。
  *
@@ -101,7 +101,7 @@ declare function SHA512Encrypt(value: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 64 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-384 认证文本或字节，并返回十六进制标签。
  *
@@ -109,7 +109,7 @@ declare function HMACSHA256Encrypt(value: string, key: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 96 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 HMAC-SHA-512 认证文本或字节，并返回十六进制标签。
  *
@@ -117,7 +117,7 @@ declare function HMACSHA384Encrypt(value: string, key: string): Promise<string>;
  * @param key - 非空的 UTF-8 文本密钥或原始密钥字节。
  * @returns 128 个小写十六进制字符组成的认证标签。
  */
-declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
+export declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
 /**
  * 使用 PBKDF2-HMAC-SHA-256 从密码派生密钥。
  *
@@ -128,7 +128,7 @@ declare function HMACSHA512Encrypt(value: string, key: string): Promise<string>;
  * @returns 指定长度的派生密钥。
  * @throws 参数超过协议边界时抛出 `TypeError` 或 `RangeError`。
  */
-declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: number, outputLength?: number): Promise<Uint8Array>;
+export declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: number, outputLength?: number): Promise<Uint8Array>;
 /**
  * 生成可持久化的随机盐 PBKDF2-HMAC-SHA-256 密码哈希。
  *
@@ -136,7 +136,7 @@ declare function PBKDF2SHA256(password: string, salt: Uint8Array, iterations?: n
  * @param iterations - 迭代次数，范围为 100,000 至 5,000,000。
  * @returns 包含版本、迭代次数、16 字节随机盐和 32 字节派生密钥的自描述字符串。
  */
-declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number): Promise<string>;
+export declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number): Promise<string>;
 /**
  * 验证 {@link HashPasswordPBKDF2SHA256} 生成的密码哈希。
  *
@@ -144,7 +144,7 @@ declare function HashPasswordPBKDF2SHA256(password: string, iterations?: number)
  * @param passwordHash - 自描述的 PBKDF2-HMAC-SHA-256 密码哈希。
  * @returns 格式有效且密码匹配时返回 `true`；格式无效或密码错误时返回 `false`。
  */
-declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: string): Promise<boolean>;
+export declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: string): Promise<boolean>;
 /**
  * 使用 RFC 5869 HKDF-SHA-256 派生上下文隔离的密钥材料。
  *
@@ -154,7 +154,7 @@ declare function VerifyPasswordPBKDF2SHA256(password: string, passwordHash: stri
  * @param outputLength - 输出长度，范围为 1 至 8,160 字节。
  * @returns 与 `salt` 和 `info` 绑定的派生密钥。
  */
-declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, info?: Uint8Array, outputLength?: number): Promise<Uint8Array>;
+export declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, info?: Uint8Array, outputLength?: number): Promise<Uint8Array>;
 /**
  * 使用 AES-256 对 UTF-8 文本进行分组加密。
  *
@@ -168,7 +168,7 @@ declare function HKDFSHA256(inputKeyMaterial: Uint8Array, salt?: Uint8Array, inf
  * @returns Base64 密文；输入、密钥或 IV 为空白时返回 `null`。
  * @throws 模式或填充不受支持时抛出 `RangeError`。
  */
-declare function AESEncrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): string | null;
+export declare function AESEncrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): string | null;
 /**
  * 使用 AES-256 解密 Base64 分组密文。
  *
@@ -181,7 +181,7 @@ declare function AESEncrypt(dataStr: string, key: string, vector: string, cipher
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串；输入、密钥或 IV 为空白时返回 `null`。
  * @throws 模式、填充、Base64、密钥或密文无效时抛出错误。
  */
-declare function AESDecrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): DecodedText | null;
+export declare function AESDecrypt(dataStr: string, key: string, vector: string, cipherMode?: AesCipherMode, paddingMode?: AesPaddingMode): DecodedText | null;
 /**
  * 使用 SHA-256 归一化文本密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
  *
@@ -191,7 +191,7 @@ declare function AESDecrypt(dataStr: string, key: string, vector: string, cipher
  * @returns Base64 编码的 v1 AES-GCM 认证载荷。
  * @throws 密钥为空或运行时缺少 Web Crypto 时抛出错误。
  */
-declare function AESEncryptAuthenticated(plaintext: string, key: string): Promise<string>;
+export declare function AESEncryptAuthenticated(plaintext: string, key: string): Promise<string>;
 /**
  * 解密并认证 .NET `AESEncryptAuthenticated` 或 {@link AESEncryptAuthenticated} 生成的载荷。
  *
@@ -200,7 +200,7 @@ declare function AESEncryptAuthenticated(plaintext: string, key: string): Promis
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
  * @throws 载荷格式无效、密钥错误或认证失败时抛出错误。
  */
-declare function AESDecryptAuthenticated(payload: string, key: string): Promise<DecodedText>;
+export declare function AESDecryptAuthenticated(payload: string, key: string): Promise<DecodedText>;
 /**
  * 使用 PBKDF2-HMAC-SHA-256 派生密钥，再以 AES-256-GCM 认证加密 UTF-8 文本。
  *
@@ -213,7 +213,7 @@ declare function AESDecryptAuthenticated(payload: string, key: string): Promise<
  * @throws 口令非法时抛出 `TypeError` 或 `RangeError`；明文过大时抛出 `RangeError`；
  * 运行时缺少 Web Crypto 或 Encoding API 时抛出 `Error`。
  */
-declare function AESEncryptWithPassword(plaintext: string, password: string, iterations?: number): Promise<string>;
+export declare function AESEncryptWithPassword(plaintext: string, password: string, iterations?: number): Promise<string>;
 /**
  * 解密 {@link AESEncryptWithPassword} 生成的 v1 认证载荷。
  *
@@ -223,7 +223,7 @@ declare function AESEncryptWithPassword(plaintext: string, password: string, ite
  * @throws 格式或字段非法时抛出 `TypeError`，载荷过大时抛出 `RangeError`，认证或密码
  * 失败及缺少平台能力时抛出 `Error`。
  */
-declare function AESDecryptWithPassword(payload: string, password: string): Promise<DecodedText>;
+export declare function AESDecryptWithPassword(payload: string, password: string): Promise<DecodedText>;
 /**
  * 生成可供 RSA-OAEP/SHA-256 与 RSA-PSS/SHA-256 共用的 PEM 密钥对。
  *
@@ -231,7 +231,7 @@ declare function AESDecryptWithPassword(payload: string, password: string): Prom
  * @returns 未加密 PKCS#8 私钥和 SubjectPublicKeyInfo 公钥组成的 PEM 密钥对。
  * @throws 模数小于 2,048 或不是 256 的倍数时抛出 `RangeError`。
  */
-declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>;
+export declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>;
 /**
  * 使用 RSA-OAEP/SHA-256 公钥加密 UTF-8 文本。
  *
@@ -240,7 +240,7 @@ declare function GenerateRSAKeyPair(modulusLength?: number): Promise<PemKeyPair>
  * @returns Base64 编码的 RSA 密文。
  * @throws 公钥格式无效或明文超过 RSA-OAEP 容量时抛出错误。
  */
-declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promise<string>;
+export declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promise<string>;
 /**
  * 使用 RSA-OAEP/SHA-256 私钥解密 Base64 密文。
  *
@@ -249,7 +249,7 @@ declare function RSAEncryptOAEP(plaintext: string, publicKeyPem: string): Promis
  * @returns 可直接使用或显式调用 `.parseJson<Value>()` 的原始 UTF-8 字符串。
  * @throws 私钥、Base64 或密文无效时抛出错误。
  */
-declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Promise<DecodedText>;
+export declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Promise<DecodedText>;
 /**
  * 使用 RSA-PSS/SHA-256 私钥签名文本或字节。
  *
@@ -258,7 +258,7 @@ declare function RSADecryptOAEP(ciphertext: string, privateKeyPem: string): Prom
  * @returns Base64 编码的 RSA-PSS 签名；盐长度固定为 32 字节。
  * @throws 私钥格式无效或签名失败时抛出错误。
  */
-declare function RSASignPSS(value: string, privateKeyPem: string): Promise<string>;
+export declare function RSASignPSS(value: string, privateKeyPem: string): Promise<string>;
 /**
  * 使用 RSA-PSS/SHA-256 公钥验证 Base64 签名。
  *
@@ -268,14 +268,14 @@ declare function RSASignPSS(value: string, privateKeyPem: string): Promise<strin
  * @returns 签名与内容、公钥匹配时返回 `true`。
  * @throws 公钥或 Base64 格式无效时抛出错误。
  */
-declare function RSAVerifyPSS(value: string, signature: string, publicKeyPem: string): Promise<boolean>;
+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 密钥对。
  */
-declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
+export declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
 /**
  * 使用 ECDSA 私钥签名文本或字节。
  *
@@ -285,7 +285,7 @@ declare function GenerateECDSAKeyPair(namedCurve?: EcNamedCurve): Promise<PemKey
  * @param namedCurve - 私钥使用的 NIST 曲线。
  * @returns Base64 编码的 IEEE P1363 ECDSA 签名。
  */
-declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: EcNamedCurve): Promise<string>;
+export declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: EcNamedCurve): Promise<string>;
 /**
  * 使用 ECDSA 公钥验证 Base64 签名。
  *
@@ -295,14 +295,14 @@ declare function ECDSASign(value: string, privateKeyPem: string, namedCurve?: Ec
  * @param namedCurve - 公钥使用的 NIST 曲线。
  * @returns 签名与内容、公钥和曲线匹配时返回 `true`。
  */
-declare function ECDSAVerify(value: string, signature: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<boolean>;
+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 密钥对。
  */
-declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
+export declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyPair>;
 /**
  * 使用本方 ECDH 私钥与对方 ECDH 公钥派生共享秘密。
  *
@@ -312,7 +312,7 @@ declare function GenerateECDHKeyPair(namedCurve?: EcNamedCurve): Promise<PemKeyP
  * @param namedCurve - 双方密钥使用的 NIST 曲线。
  * @returns 曲线字段长度的原始 ECDH 共享秘密。
  */
-declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
+export declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
 /**
  * 使用 ECDH 后以 SHA-256 派生共享密钥。
  *
@@ -322,7 +322,6 @@ declare function DeriveECDHSecret(privateKeyPem: string, publicKeyPem: string, n
  * @param namedCurve - 双方密钥使用的 NIST 曲线。
  * @returns 32 字节共享密钥。
  */
-declare function DeriveECDHKeySHA256(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
+export declare function DeriveECDHKeySHA256(privateKeyPem: string, publicKeyPem: string, namedCurve?: EcNamedCurve): Promise<Uint8Array>;
 //#endregion
-export { AESDecrypt, AESDecryptAuthenticated, AESDecryptWithPassword, AESEncrypt, AESEncryptAuthenticated, AESEncryptWithPassword, AesCipherMode, AesPaddingMode, DeriveECDHKeySHA256, DeriveECDHSecret, ECDSASign, ECDSAVerify, EcNamedCurve, FixedTimeEquals, GenerateECDHKeyPair, GenerateECDSAKeyPair, GenerateRSAKeyPair, GenerateRandomBytes, HKDFSHA256, HMACSHA256Encrypt, HMACSHA384Encrypt, HMACSHA512Encrypt, HashPasswordPBKDF2SHA256, MD5Encrypt, PBKDF2SHA256, PemKeyPair, RSADecryptOAEP, RSAEncryptOAEP, RSASignPSS, RSAVerifyPSS, SHA1Encrypt, SHA256Bytes, SHA256Encrypt, SHA384Bytes, SHA384Encrypt, SHA512Bytes, SHA512Encrypt, VerifyPasswordPBKDF2SHA256 };
 //# sourceMappingURL=index.d.mts.map

package/dist/crypto/index.mjs

@@ -1,4 +1,5 @@
 import { createDecodedText, encodeUtf8, getTextDecoder } from "../internal/text.mjs";
+import { runtimeGlobals } from "../internal/runtime.mjs";
 import { decodeBase64Bytes, decodeBase64UrlBytes, encodeBase64Bytes, encodeBase64UrlBytes } from "../base64/index.mjs";
 import AES from "crypto-js/aes.js";
 import CryptoCore from "crypto-js/core.js";
@@ -31,6 +32,10 @@ const encryptedPayloadPrefix = "FAST-AES-256-GCM-V1";
 const passwordHashPrefix = "FAST-PBKDF2-SHA256-V1";
 /** 直接 AES-GCM 密钥加密载荷的协议版本。 */
 const authenticatedAesPayloadVersion = 1;
+/** 校验 JavaScript 调用方传入的 AES 分组模式。 */
+const assertAesCipherMode = (value) => {
+	if (value !== "CBC" && value !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+};
 /**
 * 获取本模块非随机 API 所需的完整 Web Crypto 能力。
 *
@@ -38,7 +43,7 @@ const authenticatedAesPayloadVersion = 1;
 * @throws `Error` 当任一必要 SubtleCrypto 方法缺失。
 */
 const requireWebCrypto = () => {
-	const crypto = globalThis.crypto;
+	const crypto = runtimeGlobals.crypto;
 	const subtle = crypto?.subtle;
 	if (typeof subtle?.decrypt !== "function" || typeof subtle.deriveBits !== "function" || typeof subtle.deriveKey !== "function" || typeof subtle.digest !== "function" || typeof subtle.encrypt !== "function" || typeof subtle.exportKey !== "function" || typeof subtle.generateKey !== "function" || typeof subtle.importKey !== "function" || typeof subtle.sign !== "function" || typeof subtle.verify !== "function") throw new Error("当前运行环境不支持 Web Crypto SubtleCrypto。");
 	return crypto;
@@ -173,7 +178,7 @@ const computeHmacBytes = async (value, key, hash) => {
 function GenerateRandomBytes(length) {
 	if (!Number.isSafeInteger(length) || length < 0 || length > 65536) throw new RangeError("`length` 必须是 0 到 65,536 之间的安全整数。");
 	const bytes = new Uint8Array(length);
-	const crypto = globalThis.crypto;
+	const crypto = runtimeGlobals.crypto;
 	if (typeof crypto?.getRandomValues === "function") return crypto.getRandomValues(bytes);
 	for (let index = 0; index < bytes.length; index += 1) bytes[index] = Math.floor(Math.random() * 256);
 	return bytes;
@@ -400,7 +405,7 @@ async function HKDFSHA256(inputKeyMaterial, salt = /* @__PURE__ */ new Uint8Arra
 */
 function AESEncrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKCS7") {
 	if (dataStr.trim().length === 0 || key.trim().length === 0 || vector.trim().length === 0) return null;
-	if (cipherMode !== "CBC" && cipherMode !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+	assertAesCipherMode(cipherMode);
 	let padding = Pkcs7;
 	switch (paddingMode) {
 		case "None":
@@ -444,7 +449,7 @@ function AESEncrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKC
 */
 function AESDecrypt(dataStr, key, vector, cipherMode = "CBC", paddingMode = "PKCS7") {
 	if (dataStr.trim().length === 0 || key.trim().length === 0 || vector.trim().length === 0) return null;
-	if (cipherMode !== "CBC" && cipherMode !== "ECB") throw new RangeError("`cipherMode` 必须是 `CBC` 或 `ECB`。");
+	assertAesCipherMode(cipherMode);
 	let padding = Pkcs7;
 	switch (paddingMode) {
 		case "None":