dozy 1.0.77 → 1.0.79

package/dist/index.d.ts

@@ -552,17 +552,35 @@ declare function isNowAroundUtcHour(targetHour: number): boolean;
  */
 declare function $purifyBase64(input: string | Null): string | null;
 /**
- * 基于“纯 base64”推断图片 mime 类型。
+ * 基于“纯 base64”推断文件 mime 类型。
  *
  * 说明：
- * - 自动支持：jpeg/png/gif/webp/bmp/tiff/avif/heic/x-icon。
+ * - 图片：jpeg/png/gif/webp/bmp/tiff/avif/heic/x-icon/svg+xml。
+ * - 音频：mpeg(mp3)/wav/ogg/flac/aac/m4a。
+ * - 视频：mp4/webm/quicktime(mov)/x-msvideo(avi)/x-matroska(mkv)。
+ * - 文档：pdf/msword(doc)/vnd.ms-excel(xls)/vnd.ms-powerpoint(ppt)/
+ *        vnd.openxmlformats-officedocument.*(docx/xlsx/pptx)。
+ * - 压缩包：zip/x-rar-compressed/x-7z-compressed/gzip/x-tar。
+ * - 其它：xml。
  * - 输入可为纯 base64 或 data URL，内部会先清洗。
- * - 无法识别时回退为 `image/png`。
+ * - 无法识别时回退为 `application/octet-stream`。
  *
  * 返回值约定：
  * - 一定返回非空 mime 字符串（不会返回 null/undefined/空串）。
  */
-declare function $inferMimeTypeFormPureBase64(pureBase64: string | Null): "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/bmp" | "image/tiff" | "image/avif" | "image/heic" | "image/x-icon";
+declare function $inferMimeTypeFormPureBase64(pureBase64: string | Null): "application/xml" | "image/svg+xml" | "application/octet-stream" | "image/jpeg" | "image/png" | "image/gif" | "image/bmp" | "image/tiff" | "image/x-icon" | "image/webp" | "audio/wav" | "video/x-msvideo" | "image/avif" | "image/heic" | "video/quicktime" | "audio/mp4" | "video/mp4" | "video/webm" | "video/x-matroska" | "audio/ogg" | "audio/flac" | "audio/mpeg" | "audio/aac" | "application/pdf" | "application/x-cfb" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/zip" | "application/x-rar-compressed" | "application/x-7z-compressed" | "application/gzip" | "application/x-tar";
+/**
+ * 基于“纯 base64”推断文件后缀。
+ *
+ * 说明：
+ * - 覆盖 `$inferMimeTypeFormPureBase64` 支持的全部类型。
+ * - 输入可为纯 base64 或 data URL，内部会先清洗。
+ * - 无法识别时回退为 `bin`。
+ *
+ * 返回值约定：
+ * - 一定返回非空后缀字符串（不含点号，不会返回 null/undefined/空串）。
+ */
+declare function $inferExtensionFormPureBase64(pureBase64: string | Null): "xml" | "jpg" | "png" | "gif" | "bmp" | "svg" | "webp" | "mp3" | "wav" | "ogg" | "aac" | "flac" | "m4a" | "mp4" | "webm" | "mov" | "avi" | "mkv" | "avif" | "heic" | "tiff" | "ico" | "pdf" | "doc" | "docx" | "xlsx" | "pptx" | "zip" | "rar" | "7z" | "gz" | "tar" | "bin";
 /**
  * 将“纯 base64 或 data URL”统一转成标准 data URL。
  *
@@ -887,7 +905,7 @@ declare class StringObfuscator {
 }
 
 /**
- * StoreRepo - GitHub 仓库内容存储类
+ * RepoStore - GitHub 仓库内容存储类
  *
  * 基于 Octokit 实现的 GitHub 仓库文件操作类，支持文件的增删改查、JSON 序列化存储、
  * 目录列表等功能。所有操作都通过 GitHub REST API v3 的 Contents API 完成。
@@ -900,7 +918,7 @@ declare class StringObfuscator {
  *
  * @example
  * ```typescript
- * const repo = new StoreRepo('github-token', 'username', 'repo-name')
+ * const repo = new RepoStore('github-token', 'username', 'repo-name')
  *
  * // 存储 JSON 数据
  * await repo.putJson('data/config.json', { key: 'value' })
@@ -912,7 +930,7 @@ declare class StringObfuscator {
  * const files = await repo.list('data')
  * ```
  */
-declare class StoreRepo {
+declare class RepoStore {
     /**
      * Octokit 实例，用于与 GitHub API 交互
      * @internal
@@ -951,7 +969,7 @@ declare class StoreRepo {
      *
      * @example
      * ```typescript
-     * class EncryptedStoreRepo extends StoreRepo {
+     * class EncryptedRepoStore extends RepoStore {
      *   _prind(content: string, en: boolean) {
      *     return en ? encrypt(content) : decrypt(content)
      *   }
@@ -974,7 +992,7 @@ declare class StoreRepo {
      *
      * @example
      * ```typescript
-     * class PrefixedStoreRepo extends StoreRepo {
+     * class PrefixedRepoStore extends RepoStore {
      *   path(path: string) {
      *     return `data/${path}`
      *   }
@@ -1055,7 +1073,7 @@ declare class StoreRepo {
      *
      * @example
      * ```typescript
-     * class CustomMsgStoreRepo extends StoreRepo {
+     * class CustomMsgRepoStore extends RepoStore {
      *   msg() {
      *     return `Update at ${new Date().toISOString()}`
      *   }
@@ -1252,7 +1270,7 @@ declare class StoreRepo {
         type: any;
     }[] | undefined>;
     /**
-     * 创建 StoreRepo 实例
+     * 创建 RepoStore 实例
      *
      * @param x0 - GitHub Personal Access Token（个人访问令牌）
      *   - 需要具有对目标仓库的读写权限
@@ -1268,14 +1286,14 @@ declare class StoreRepo {
      * @example
      * ```typescript
      * // 基本用法
-     * const repo = new StoreRepo(
+     * const repo = new RepoStore(
      *   'ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // GitHub Token
      *   'myusername',                                // 所有者
      *   'my-repo'                                    // 仓库名
      * )
      *
      * // 组织仓库
-     * const orgRepo = new StoreRepo(
+     * const orgRepo = new RepoStore(
      *   process.env.GITHUB_TOKEN,
      *   'my-organization',
      *   'org-repo'
@@ -1377,6 +1395,6 @@ declare function toRgbString(input: string | Color | any): string | undefined;
  */
 declare function toHslString(input: string | Color | any): string | undefined;
 
-declare const DOZY = "1.0.77";
+declare const DOZY = "1.0.79";
 
-export { $Headers, $Request, $Response, $URL, $URLSearchParams, $arrayFrom, $arrayIsArray, $assign, $backgroundColor, $borderColor, $capitalize, $checkValidEmailWithUnicode, $clamp, $clearInterval, $clearTimeout, $clone, $compressImage, $compressImageBase64, $compressImageDefaultOptions, $copy, $crypto, $date, $decodeBase64ToBinary, $decodeBase64ToUnicode, $deepClone, $defineProperty, $document, $encodeUnicodeToBase64, $entries, $escapeHTML, $fallbackCopy, $fetch, $fileToBase64, $formatDate, $formatPoints, $formatPointsWithChange, $formatWithCommas, $freeze, $genSSF, $getFileType, $getHue, $getTimeString, $hasKey, $if, $inRange, $inRange2, $inferMimeTypeFormPureBase64, $is, $isObject, $isPlainClass, $isValidEmailWithUnicode, $isValidOrBriefURL, $jsonParse, $jsonStringify, $keys, $lastIndex, $lindex, $loadOpt, $location, $log, $lplus, $magic, $math, $now, $numberIsFinite, $numberIsNaN, $oc, $open, $parseParams, $promise, $pureText, $purifyBase64, $randomByte, $replaceHolesWithUndefined, $rmvSlash, $rsValue, $rsetValue, $rvalue, $s, $sc, $setInterval, $setRange, $setTimeout, $stringFromCharCode, $stringFromCodePoint, $stringToRange, $strings, $toDataUrlFromBase64, $validName, $values, $window, type Any, type Atoa, type Coord, type Coord3, DOZY, type DozyConfig, type DozyConfigItem, type FileType, Gens, type Hel, type IOpt, type Items, type Null, type Nullable, RainbowGen, type ScaleComputer, type ScaleIniter, StoreRepo, StringObfuscator, type UNumber, __GensDirectives, _res, boxShadow, dozy, enableScaler, err403, errArg, errCode, errContent, errMsg, errNotLoggedIn, errToString, getBrightness, getColorMap, isNowAroundUtcHour, isNull, isValidColor, maybeString, registerCustomColor, s, shanghaiDateFormatter, smallChance, smartParse, smartString, standardIniter, textShadow, toHexString, toHslString, toRgbString, toRgbaArray, web$enableHttpsRedirect, web$enableProdProtector, web$encodeURI, web$pathStartData, web$redirectToDomain, web$setPathTarget, xtrim };
+export { $Headers, $Request, $Response, $URL, $URLSearchParams, $arrayFrom, $arrayIsArray, $assign, $backgroundColor, $borderColor, $capitalize, $checkValidEmailWithUnicode, $clamp, $clearInterval, $clearTimeout, $clone, $compressImage, $compressImageBase64, $compressImageDefaultOptions, $copy, $crypto, $date, $decodeBase64ToBinary, $decodeBase64ToUnicode, $deepClone, $defineProperty, $document, $encodeUnicodeToBase64, $entries, $escapeHTML, $fallbackCopy, $fetch, $fileToBase64, $formatDate, $formatPoints, $formatPointsWithChange, $formatWithCommas, $freeze, $genSSF, $getFileType, $getHue, $getTimeString, $hasKey, $if, $inRange, $inRange2, $inferExtensionFormPureBase64, $inferMimeTypeFormPureBase64, $is, $isObject, $isPlainClass, $isValidEmailWithUnicode, $isValidOrBriefURL, $jsonParse, $jsonStringify, $keys, $lastIndex, $lindex, $loadOpt, $location, $log, $lplus, $magic, $math, $now, $numberIsFinite, $numberIsNaN, $oc, $open, $parseParams, $promise, $pureText, $purifyBase64, $randomByte, $replaceHolesWithUndefined, $rmvSlash, $rsValue, $rsetValue, $rvalue, $s, $sc, $setInterval, $setRange, $setTimeout, $stringFromCharCode, $stringFromCodePoint, $stringToRange, $strings, $toDataUrlFromBase64, $validName, $values, $window, type Any, type Atoa, type Coord, type Coord3, DOZY, type DozyConfig, type DozyConfigItem, type FileType, Gens, type Hel, type IOpt, type Items, type Null, type Nullable, RainbowGen, RepoStore, type ScaleComputer, type ScaleIniter, StringObfuscator, type UNumber, __GensDirectives, _res, boxShadow, dozy, enableScaler, err403, errArg, errCode, errContent, errMsg, errNotLoggedIn, errToString, getBrightness, getColorMap, isNowAroundUtcHour, isNull, isValidColor, maybeString, registerCustomColor, s, shanghaiDateFormatter, smallChance, smartParse, smartString, standardIniter, textShadow, toHexString, toHslString, toRgbString, toRgbaArray, web$enableHttpsRedirect, web$enableProdProtector, web$encodeURI, web$pathStartData, web$redirectToDomain, web$setPathTarget, xtrim };