@aitianyu.cn/types 0.1.2 → 0.1.3

package/dist/types/security/RSA.d.ts

@@ -4,65 +4,88 @@
 /// <reference types="node" />
 import { RSAKeyPairOptions } from "crypto";
 /**
- * RSA Key formatting type
+ * RSA key output format.
+ * RSA 密钥输出格式。
  *
- * @field pem string formatting key
- * @field der buffer data key
+ * - "pem": PEM-encoded string (Base64 with header/footer lines)
+ * - "der": DER-encoded binary Buffer
+ *
+ * - "pem"：PEM 编码字符串（带页眉/页脚行的 Base64）
+ * - "der"：DER 编码的二进制 Buffer
  */
 export type RSAKeyFormatType = "pem" | "der";
-/** RSA key generation Map */
+/** Maps RSA key format types to their corresponding return value types. / 将 RSA 密钥格式类型映射到对应返回值类型。 */
 export interface RSAKeyGenerationMap {
     pem: string;
     der: Buffer;
 }
-/** RSA Key generation return type */
+/** Helper type that resolves to the correct return type for a given RSA key format. / 解析给定 RSA 密钥格式对应返回类型的帮助类型。 */
 export type RSAKeyGenerationReturnType<K extends RSAKeyFormatType> = RSAKeyGenerationMap[K];
-/** RSA Generation result */
+/**
+ * The result of an RSA key-pair generation operation.
+ * Contains both the private key and the public key in their requested formats.
+ *
+ * RSA 密钥对生成操作的结果。
+ * 包含以所请求格式表示的私钥和公钥。
+ */
 export interface RSAGenerationResult<priKey extends RSAKeyFormatType, pubKey extends RSAKeyFormatType> {
-    /** RSA private key */
+    /** RSA private key in the requested format. / 所请求格式的 RSA 私钥。 */
     privateKey: RSAKeyGenerationReturnType<priKey>;
-    /** RSA public key */
+    /** RSA public key in the requested format. / 所请求格式的 RSA 公钥。 */
     publicKey: RSAKeyGenerationReturnType<pubKey>;
 }
-/** RSA Lib */
+/**
+ * RSA encryption/decryption utility class.
+ * Provides key-pair generation and four directional encryption operations
+ * (public→private, private→public, and their reverses).
+ *
+ * RSA 加密/解密工具类。
+ * 提供密钥对生成及四种方向的加密操作
+ * （公钥→私钥、私钥→公钥，及各自的反向解密）。
+ */
 export declare class RSA {
     /**
-     * To get a new RSA public key and private key
+     * Generate a new RSA public/private key pair.
+     * 生成新的 RSA 公私密钥对。
      *
-     * @param options RSA key generation option
-     * @returns return new RSA key
+     * @param options RSA key generation options (modulus length, format, etc.) / RSA 密钥生成选项（模数长度、格式等）
+     * @returns an object containing the generated private and public keys / 包含生成的私钥和公钥的对象
      */
     static new<priKey extends RSAKeyFormatType = "pem", pubKey extends RSAKeyFormatType = "pem">(options: RSAKeyPairOptions<priKey, pubKey>): RSAGenerationResult<priKey, pubKey>;
     /**
-     * To encode a value with public key, the encoded data can be decoded by private key
+     * Encrypt data using the public key (decryptable with the private key).
+     * 使用公钥加密数据（可用私钥解密）。
      *
-     * @param data input data
-     * @param publicKey encoding public key
-     * @returns return encoded buffer
+     * @param data the plaintext data to encrypt / 要加密的明文数据
+     * @param publicKey the RSA public key / RSA 公钥
+     * @returns the encrypted Buffer / 加密后的 Buffer
      */
     static encodepub(data: globalThis.DataView, publicKey: string | Buffer): Buffer;
     /**
-     * To encode a value with private key, the encoded data can be decoded by public key
+     * Encrypt data using the private key (decryptable with the public key).
+     * 使用私钥加密数据（可用公钥解密）。
      *
-     * @param data input data
-     * @param publicKey encoding private key
-     * @returns return encoded buffer
+     * @param data the plaintext data to encrypt / 要加密的明文数据
+     * @param privateKey the RSA private key / RSA 私钥
+     * @returns the encrypted Buffer / 加密后的 Buffer
      */
     static encodepri(data: globalThis.DataView, privateKey: string | Buffer): Buffer;
     /**
-     * To decode a value with public key, the value is encoded by private key
+     * Decrypt data using the public key (data was encrypted with the private key).
+     * 使用公钥解密数据（数据由私钥加密）。
      *
-     * @param data input data
-     * @param publicKey decoding public key
-     * @returns return decoded buffer
+     * @param data the encrypted data / 加密后的数据
+     * @param publicKey the RSA public key / RSA 公钥
+     * @returns the decrypted Buffer / 解密后的 Buffer
      */
     static decodepub(data: globalThis.DataView, publicKey: string | Buffer): Buffer;
     /**
-     * To decode a value with private key, the value is encoded by public key
+     * Decrypt data using the private key (data was encrypted with the public key).
+     * 使用私钥解密数据（数据由公钥加密）。
      *
-     * @param data input data
-     * @param privateKey decoding private key
-     * @returns return decoded buffer
+     * @param data the encrypted data / 加密后的数据
+     * @param privateKey the RSA private key / RSA 私钥
+     * @returns the decrypted Buffer / 解密后的 Buffer
      */
     static decodepri(data: globalThis.DataView, privateKey: string | Buffer): Buffer;
 }

package/dist/types/security/SHA.d.ts

@@ -3,37 +3,47 @@
 /// <reference types="node" />
 /// <reference types="node" />
 import Stream from "stream";
-/** SHA Lib */
+/**
+ * SHA hash utility class.
+ * Provides SHA-256 and SHA-512 hashing for both buffer/string data and Node.js streams.
+ *
+ * SHA 哈希工具类。
+ * 为缓冲区/字符串数据和 Node.js 流提供 SHA-256 和 SHA-512 哈希计算。
+ */
 export declare class SHA {
     /**
-     * Calculate SHA256 code of data based on specified string encoding.
+     * Calculate the SHA-256 hash of string or Buffer data.
+     * 计算字符串或 Buffer 数据的 SHA-256 哈希值。
      *
-     * @param data source data
-     * @param encoding string encoding type, default encoding type is 'utf-8', only used when data type is string
-     * @returns return the SHA256 code buffer
+     * @param data the source data / 源数据
+     * @param encoding string encoding used when `data` is a string; defaults to "utf-8" / 当 `data` 为字符串时使用的字符串编码，默认为 "utf-8"
+     * @returns the SHA-256 digest as a Buffer / SHA-256 摘要 Buffer
      */
     static sha256(data: string | Buffer, encoding?: NodeJS.BufferEncoding): Buffer;
     /**
-     * Calculate SHA512 code of data based on specified string encoding.
+     * Calculate the SHA-512 hash of string or Buffer data.
+     * 计算字符串或 Buffer 数据的 SHA-512 哈希值。
      *
-     * @param data source data
-     * @param encoding string encoding type, default encoding type is 'utf-8', only used when data type is string
-     * @returns return the SHA256 code buffer
+     * @param data the source data / 源数据
+     * @param encoding string encoding used when `data` is a string; defaults to "utf-8" / 当 `data` 为字符串时使用的字符串编码，默认为 "utf-8"
+     * @returns the SHA-512 digest as a Buffer / SHA-512 摘要 Buffer
      */
     static sha512(data: string | Buffer, encoding?: NodeJS.BufferEncoding): Buffer;
     private static sha;
     /**
-     * Calculate SHA256 code of data based on a stream
+     * Calculate the SHA-256 hash of data provided via a Node.js readable stream.
+     * 通过 Node.js 可读流提供的数据计算 SHA-256 哈希值。
      *
-     * @param stream data stream
-     * @returns return the encoded buffer
+     * @param stream the readable data stream / 可读数据流
+     * @returns a Promise that resolves to the SHA-256 digest Buffer / 解析为 SHA-256 摘要 Buffer 的 Promise
      */
     static stream256(stream: Stream): Promise<Buffer>;
     /**
-     * Calculate SHA512 code of data based on a stream
+     * Calculate the SHA-512 hash of data provided via a Node.js readable stream.
+     * 通过 Node.js 可读流提供的数据计算 SHA-512 哈希值。
      *
-     * @param stream data stream
-     * @returns return the encoded buffer
+     * @param stream the readable data stream / 可读数据流
+     * @returns a Promise that resolves to the SHA-512 digest Buffer / 解析为 SHA-512 摘要 Buffer 的 Promise
      */
     static stream512(stream: Stream): Promise<Buffer>;
     private static streamSHA;

package/dist/types/security/TOTP.d.ts

@@ -1,24 +1,46 @@
 /** @format */
-/** TOTP Lib */
+/**
+ * Time-based One-Time Password (TOTP) utility class.
+ * Implements the TOTP algorithm as defined in RFC 6238.
+ * Compatible with standard authenticator apps (Google Authenticator, Authy, etc.).
+ *
+ * 基于时间的一次性密码（TOTP）工具类。
+ * 实现 RFC 6238 定义的 TOTP 算法。
+ * 与标准认证器应用（Google Authenticator、Authy 等）兼容。
+ */
 export declare class TOTP {
     /**
-     * To generate a new TOTP secret key
+     * Generate a new TOTP secret key encoded in Base32 (RFC4648).
+     * The returned key should be stored securely and associated with a user account.
      *
-     * @returns TOTP secret key
+     * 生成一个以 Base32（RFC4648）编码的新 TOTP 密钥。
+     * 返回的密钥应安全存储并与用户账户关联。
+     *
+     * @returns a Base32-encoded secret key string / Base32 编码的密钥字符串
      */
     static generate(): string;
     /**
-     * Generate TOTP random code
+     * Generate the 6-digit TOTP code for the given secret key and time window.
+     * The default time window is the current 30-second interval (standard TOTP).
+     *
+     * 为给定密钥和时间窗口生成 6 位 TOTP 验证码。
+     * 默认时间窗口为当前的 30 秒间隔（标准 TOTP）。
      *
-     * @param key TOTP secret key
-     * @returns return TOTP random code
+     * @param key the Base32-encoded secret key / Base32 编码的密钥
+     * @param time optional Unix timestamp in milliseconds; defaults to Date.now() / 可选的 Unix 时间戳（毫秒），默认为 Date.now()
+     * @returns a 6-digit OTP string / 6 位一次性密码字符串
      */
     static code(key: string, time?: number): string;
     /**
-     * Generate a key and TOTP register URL from given user
+     * Generate a new TOTP secret and the corresponding otpauth:// URI for QR code scanning.
+     * The URI can be rendered as a QR code so users can add the account to an authenticator app.
+     *
+     * 生成新的 TOTP 密钥及对应的 otpauth:// URI，用于二维码扫描。
+     * 该 URI 可渲染为二维码，方便用户将账户添加到认证器应用。
      *
-     * @param user user name
-     * @returns return the secret key and url
+     * @param user the account username or email / 账户用户名或邮箱
+     * @param project the issuer / service name shown in the authenticator app / 显示在认证器应用中的发行方/服务名称
+     * @returns an object containing the secret key and the otpauth:// URL / 包含密钥和 otpauth:// URL 的对象
      */
     static getUrl(user: string, project?: string): {
         key: string;

package/dist/types/types/AreaCode.d.ts

@@ -1,135 +1,274 @@
 /**@format */
-/** International Area name and its code */
+/**
+ * International locale area codes.
+ * Each member maps a locale identifier (language_Region) to its Windows LCID numeric value.
+ * Used throughout the library to represent language/region settings in a type-safe way.
+ *
+ * 国际语言环境区域码枚举。
+ * 每个成员将语言环境标识符（语言_地区）映射到对应的 Windows LCID 数值。
+ * 在整个库中用于以类型安全的方式表示语言/地区设置。
+ */
 export declare enum AreaCode {
+    /** Unknown / unrecognised locale. / 未知或无法识别的语言环境。 */
     unknown = 0,
+    /** Afrikaans (South Africa) / 南非荷兰语（南非） */
     af_ZA = 1078,
+    /** Albanian (Albania) / 阿尔巴尼亚语（阿尔巴尼亚） */
     sq_AL = 1052,
+    /** Amharic (Amhara) / 阿姆哈拉语（阿姆哈拉） */
     am_AM = 1118,
+    /** Arabic (Algeria) / 阿拉伯语（阿尔及利亚） */
     ar_DZ = 5121,
+    /** Arabic (Bahrain) / 阿拉伯语（巴林） */
     ar_BH = 15361,
+    /** Arabic (Egypt) / 阿拉伯语（埃及） */
     ar_EG = 3073,
+    /** Arabic (Iraq) / 阿拉伯语（伊拉克） */
     ar_IQ = 2049,
+    /** Arabic (Jordan) / 阿拉伯语（约旦） */
     ar_JO = 11265,
+    /** Arabic (Kuwait) / 阿拉伯语（科威特） */
     ar_KW = 13313,
+    /** Arabic (Lebanon) / 阿拉伯语（黎巴嫩） */
     ar_LB = 12289,
+    /** Arabic (Libya) / 阿拉伯语（利比亚） */
     ar_LY = 4097,
+    /** Arabic (Morocco) / 阿拉伯语（摩洛哥） */
     ar_MA = 6145,
+    /** Arabic (Oman) / 阿拉伯语（阿曼） */
     ar_OM = 8193,
+    /** Arabic (Qatar) / 阿拉伯语（卡塔尔） */
     ar_QA = 16385,
+    /** Arabic (Saudi Arabia) / 阿拉伯语（沙特阿拉伯） */
     ar_SA = 1025,
+    /** Arabic (Syria) / 阿拉伯语（叙利亚） */
     ar_SY = 10241,
+    /** Arabic (Tunisia) / 阿拉伯语（突尼斯） */
     ar_TN = 7169,
+    /** Arabic (United Arab Emirates) / 阿拉伯语（阿联酋） */
     ar_AE = 14337,
+    /** Arabic (Yemen) / 阿拉伯语（也门） */
     ar_YE = 9217,
+    /** Armenian (Armenia) / 亚美尼亚语（亚美尼亚） */
     hy_AM = 1067,
+    /** Assamese (India) / 阿萨姆语（印度） */
     as_AS = 1101,
+    /** Azeri — Cyrillic script (Azerbaijan) / 阿塞拜疆语——西里尔字母（阿塞拜疆） */
     az_AZ_Cyrl = 2092,
+    /** Azeri — Latin script (Azerbaijan) / 阿塞拜疆语——拉丁字母（阿塞拜疆） */
     az_AZ_Latn = 2093,
+    /** Basque (Basque Country) / 巴斯克语（巴斯克地区） */
     eu_ES = 1069,
+    /** Belarusian (Belarus) / 白俄罗斯语（白俄罗斯） */
     be_BY = 1059,
+    /** Bulgarian (Bulgaria) / 保加利亚语（保加利亚） */
     bg_BG = 1026,
+    /** Catalan (Catalonia) / 加泰罗尼亚语（加泰罗尼亚） */
     ca_ES = 1027,
+    /** Chinese (Hong Kong SAR) / 中文（香港特别行政区） */
     zh_HK = 3076,
+    /** Chinese (Macao SAR) / 中文（澳门特别行政区） */
     zh_MO = 5124,
+    /** Chinese Simplified (Mainland China) / 简体中文（中国大陆） */
     zh_CN = 2052,
+    /** Chinese (Singapore) / 中文（新加坡） */
     zh_SG = 4100,
+    /** Chinese Traditional (Taiwan) / 繁体中文（台湾） */
     zh_TW = 1028,
+    /** Croatian (Croatia) / 克罗地亚语（克罗地亚） */
     hr_HR = 1050,
+    /** Czech (Czech Republic) / 捷克语（捷克共和国） */
     cd_CZ = 1029,
+    /** Danish (Denmark) / 丹麦语（丹麦） */
     da_DK = 1030,
+    /** Dutch (Belgium) / 荷兰语（比利时） */
     nl_BE = 2067,
+    /** Dutch (Netherlands) / 荷兰语（荷兰） */
     nl_NL = 1043,
+    /** English (Australia) / 英语（澳大利亚） */
     en_AU = 3081,
+    /** English (Belize) / 英语（伯利兹） */
     en_BZ = 10249,
+    /** English (Canada) / 英语（加拿大） */
     en_CA = 4105,
+    /** English (Caribbean) / 英语（加勒比地区） */
     en_CB = 9225,
+    /** English (Ireland) / 英语（爱尔兰） */
     en_IE = 6153,
+    /** English (India) / 英语（印度） */
     en_IN = 16393,
+    /** English (Jamaica) / 英语（牙买加） */
     en_JM = 8201,
+    /** English (New Zealand) / 英语（新西兰） */
     en_NZ = 5129,
+    /** English (Philippines) / 英语（菲律宾） */
     en_PH = 13321,
+    /** English (South Africa) / 英语（南非） */
     en_ZA = 7177,
+    /** English (Trinidad and Tobago) / 英语（特立尼达和多巴哥） */
     en_TT = 11273,
+    /** English (Zimbabwe) / 英语（津巴布韦） */
     en_ZW = 12297,
+    /** English (United States) / 英语（美国） */
     en_US = 1033,
+    /** English (United Kingdom) / 英语（英国） */
     en_UK = 2057,
+    /** Estonian (Estonia) / 爱沙尼亚语（爱沙尼亚） */
     et_EE = 1061,
+    /** Faroese (Faroe Islands) / 法罗语（法罗群岛） */
     fo_FO = 1080,
+    /** Finnish (Finland) / 芬兰语（芬兰） */
     fi_FI = 1035,
+    /** French (Belgium) / 法语（比利时） */
     fr_BE = 2060,
+    /** French (Canada) / 法语（加拿大） */
     fr_CA = 11276,
+    /** French (France) / 法语（法国） */
     fr_FR = 1036,
+    /** French (Luxembourg) / 法语（卢森堡） */
     fr_LU = 5132,
+    /** French (Monaco) / 法语（摩纳哥） */
     fr_MC = 6156,
+    /** French (Switzerland) / 法语（瑞士） */
     fr_CH = 4108,
+    /** Galician (Galicia, Spain) / 加利西亚语（西班牙加利西亚） */
     gl_ES = 1110,
+    /** German (Austria) / 德语（奥地利） */
     de_AT = 3079,
+    /** German (Germany) / 德语（德国） */
     de_DE = 1031,
+    /** German (Liechtenstein) / 德语（列支敦士登） */
     de_LI = 5127,
+    /** German (Luxembourg) / 德语（卢森堡） */
     de_LU = 4103,
+    /** German (Switzerland) / 德语（瑞士） */
     de_CH = 2055,
+    /** Gujarati (India) / 古吉拉特语（印度） */
     gu_IN = 1095,
+    /** Hebrew (Israel) / 希伯来语（以色列） */
     he_IL = 1037,
+    /** Hindi (India) / 印地语（印度） */
     hi_IN = 1081,
+    /** Hungarian (Hungary) / 匈牙利语（匈牙利） */
     hu_HU = 1038,
+    /** Icelandic (Iceland) / 冰岛语（冰岛） */
     is_IS = 1039,
+    /** Indonesian (Indonesia) / 印度尼西亚语（印度尼西亚） */
     id_ID = 1057,
+    /** Italian (Italy) / 意大利语（意大利） */
     it_IT = 1040,
+    /** Italian (Switzerland) / 意大利语（瑞士） */
     it_CH = 2064,
+    /** Japanese (Japan) / 日语（日本） */
     ja_JP = 1041,
+    /** Kannada (India) / 卡纳达语（印度） */
     kn_IN = 1099,
+    /** Kazakh (Kazakhstan) / 哈萨克语（哈萨克斯坦） */
     kk_KZ = 1087,
+    /** Korean (Korea) / 韩语（韩国） */
     ko_KR = 1042,
+    /** Kyrgyz (Kyrgyzstan) / 柯尔克孜语（吉尔吉斯斯坦） */
     ky_KZ = 1088,
+    /** Latvian (Latvia) / 拉脱维亚语（拉脱维亚） */
     lv_LV = 1062,
+    /** Lithuanian (Lithuania) / 立陶宛语（立陶宛） */
     lt_LT = 1063,
+    /** Malay (Brunei) / 马来语（文莱） */
     ms_BN = 2110,
+    /** Malay (Malaysia) / 马来语（马来西亚） */
     ms_MY = 1086,
+    /** Marathi (India) / 马拉地语（印度） */
     mr_IN = 1102,
+    /** Mongolian (Mongolia) / 蒙古语（蒙古国） */
     mn_MN = 2128,
+    /** Norwegian Bokmål (Norway) / 挪威书面语（挪威） */
     nb_NO = 1044,
+    /** Norwegian Nynorsk (Norway) / 挪威新挪威语（挪威） */
     nn_NO = 2068,
+    /** Polish (Poland) / 波兰语（波兰） */
     pl_PL = 1045,
+    /** Portuguese (Brazil) / 葡萄牙语（巴西） */
     pt_BR = 1046,
+    /** Portuguese (Portugal) / 葡萄牙语（葡萄牙） */
     pt_PT = 2070,
+    /** Punjabi (India) / 旁遮普语（印度） */
     pa_IN = 1094,
+    /** Romanian (Moldova) / 罗马尼亚语（摩尔多瓦） */
     ro_MO = 2072,
+    /** Romanian (Romania) / 罗马尼亚语（罗马尼亚） */
     ro_RO = 1048,
+    /** Russian (Russia) / 俄语（俄罗斯） */
     ru_RU = 1049,
+    /** Russian (Moldova) / 俄语（摩尔多瓦） */
     ru_MO = 2073,
+    /** Sanskrit (India) / 梵语（印度） */
     sa_IN = 1103,
+    /** Serbian — Cyrillic script (Serbia) / 塞尔维亚语——西里尔字母（塞尔维亚） */
     sr_SP_Cyrl = 3098,
+    /** Serbian — Latin script (Serbia) / 塞尔维亚语——拉丁字母（塞尔维亚） */
     sr_SP_Latn = 2074,
+    /** Slovak (Slovakia) / 斯洛伐克语（斯洛伐克） */
     sk_SK = 1051,
+    /** Slovenian (Slovenia) / 斯洛文尼亚语（斯洛文尼亚） */
     sl_SI = 1060,
+    /** Spanish (Argentina) / 西班牙语（阿根廷） */
     es_AR = 11274,
+    /** Spanish (Bolivia) / 西班牙语（玻利维亚） */
     es_BO = 16394,
+    /** Spanish (Chile) / 西班牙语（智利） */
     es_CL = 13322,
+    /** Spanish (Colombia) / 西班牙语（哥伦比亚） */
     es_CO = 9226,
+    /** Spanish (Costa Rica) / 西班牙语（哥斯达黎加） */
     es_CR = 5130,
+    /** Spanish (Dominican Republic) / 西班牙语（多米尼加共和国） */
     es_DO = 7178,
+    /** Spanish (Ecuador) / 西班牙语（厄瓜多尔） */
     es_EC = 12298,
+    /** Spanish (El Salvador) / 西班牙语（萨尔瓦多） */
     es_SV = 17418,
+    /** Spanish (Guatemala) / 西班牙语（危地马拉） */
     es_GT = 4106,
+    /** Spanish (Honduras) / 西班牙语（洪都拉斯） */
     es_HN = 18442,
+    /** Spanish (Mexico) / 西班牙语（墨西哥） */
     es_MX = 2058,
+    /** Spanish (Nicaragua) / 西班牙语（尼加拉瓜） */
     es_NI = 19466,
+    /** Spanish (Panama) / 西班牙语（巴拿马） */
     es_PA = 6154,
+    /** Spanish (Paraguay) / 西班牙语（巴拉圭） */
     es_PY = 15370,
+    /** Spanish (Peru) / 西班牙语（秘鲁） */
     es_PE = 10250,
+    /** Spanish (Puerto Rico) / 西班牙语（波多黎各） */
     es_PR = 20490,
+    /** Spanish (Spain, Traditional Sort) / 西班牙语（西班牙，传统排序） */
     es_ES = 1034,
+    /** Spanish (Uruguay) / 西班牙语（乌拉圭） */
     es_UY = 14346,
+    /** Spanish (Venezuela) / 西班牙语（委内瑞拉） */
     es_VE = 8202,
+    /** Swahili (Kenya) / 斯瓦希里语（肯尼亚） */
     sw_KE = 1089,
+    /** Swedish (Finland) / 瑞典语（芬兰） */
     sv_FI = 2077,
+    /** Swedish (Sweden) / 瑞典语（瑞典） */
     sv_SE = 1053,
+    /** Tamil (India) / 泰米尔语（印度） */
     ta_IN = 1097,
+    /** Tatar (Russia) / 鞑靼语（俄罗斯） */
     tt_RU = 1092,
+    /** Telugu (India) / 泰卢固语（印度） */
     te_IN = 1098,
+    /** Thai (Thailand) / 泰语（泰国） */
     th_TH = 1054,
+    /** Turkish (Turkey) / 土耳其语（土耳其） */
     tr_TR = 1055,
+    /** Uzbek — Cyrillic script (Uzbekistan) / 乌兹别克语——西里尔字母（乌兹别克斯坦） */
     uz_UZ_Cyrl = 2115,
+    /** Uzbek — Latin script (Uzbekistan) / 乌兹别克语——拉丁字母（乌兹别克斯坦） */
     uz_UZ_Latn = 1091,
+    /** Vietnamese (Vietnam) / 越南语（越南） */
     vi_VN = 1066
 }

package/dist/types/types/Exception.d.ts

@@ -1,11 +1,25 @@
 /**@format */
-/** Exception base class */
+/**
+ * Base exception class for all aitianyu custom errors.
+ * Extends the built-in Error class and provides a standardized toString output.
+ *
+ * aitianyu 所有自定义异常的基类。
+ * 继承自内置 Error 类，提供标准化的 toString 输出。
+ */
 export declare class Exception extends Error {
+    /**
+     * Create a new Exception instance.
+     * 创建一个新的 Exception 实例。
+     *
+     * @param msg optional error message / 可选的错误信息
+     * @param options optional error options / 可选的错误选项
+     */
     constructor(msg?: string, options?: ErrorOptions);
     /**
-     * Get a string of the Exception object
+     * Get the error message string of this Exception.
+     * 获取当前异常的错误信息字符串。
      *
-     * @returns return an error message
+     * @returns the error message / 错误信息
      */
     toString(): string;
 }