dozy 1.0.63 → 1.0.64

package/dist/index.d.ts

@@ -20,7 +20,8 @@ declare class Dozy {
 declare const dozy: Dozy;
 
 type Any = Items<any>;
-type Null = undefined | null;
+type Null = undefined | null | void;
+declare function isNull<T>(v: T | Null): v is Null;
 type Nullable<T> = T | Null;
 type Items<T> = {
     [x: string]: T;
@@ -87,6 +88,42 @@ declare function errArg(): void;
 declare function errNotLoggedIn(): void;
 declare function err403(): void;
 declare function isNowAroundUtcHour(targetHour: number): boolean;
+/**
+ * 清洗 base64 输入，统一得到“纯 base64”（不含 data URL 前缀）。
+ *
+ * 说明：
+ * - 会移除 `data:*;base64,` 前缀。
+ * - 会移除所有空白字符并 trim。
+ * - 非字符串输入会返回空字符串。
+ *
+ * 返回值约定：
+ * - 一定返回 `string`（不会返回 null/undefined）。
+ */
+declare function $purifyBase64(input: string | null | undefined): string;
+/**
+ * 基于“纯 base64”推断图片 mime 类型。
+ *
+ * 说明：
+ * - 自动支持：jpeg/png/gif/webp/bmp/tiff/avif/heic/x-icon。
+ * - 输入可为纯 base64 或 data URL，内部会先清洗。
+ * - 无法识别时回退为 `image/png`。
+ *
+ * 返回值约定：
+ * - 一定返回非空 mime 字符串（不会返回 null/undefined/空串）。
+ */
+declare function $inferMimeTypeFormPureBase64(pureBase64: string | null | undefined): "image/jpeg" | "image/png" | "image/gif" | "image/webp" | "image/bmp" | "image/tiff" | "image/avif" | "image/heic" | "image/x-icon";
+/**
+ * 将“纯 base64 或 data URL”统一转成标准 data URL。
+ *
+ * 说明：
+ * - 如果输入本来是 data URL，会清洗并标准化后返回。
+ * - 如果输入是纯 base64，会自动推断 mime 并补齐 `data:*;base64,` 前缀。
+ * - 非字符串或空字符串输入返回空字符串。
+ *
+ * 返回值约定：
+ * - 一定返回 `string`（不会返回 null/undefined）。
+ */
+declare function $toDataUrlFromBase64(base64WithDataOrPure: string | null | undefined): string;
 
 declare function web$setPathTarget(s: string): void;
 declare function web$pathStartData(): {
@@ -333,6 +370,6 @@ declare function toRgbString(input: string | Color | any): string | undefined;
  */
 declare function toHslString(input: string | Color | any): string | undefined;
 
-declare const DOZY = "1.0.63";
+declare const DOZY = "1.0.64";
 
-export { $Headers, $Request, $Response, $URL, $URLSearchParams, $arrayFrom, $arrayIsArray, $assign, $capitalize, $checkValidEmailWithUnicode, $clamp, $clearInterval, $clearTimeout, $clone, $compressImage, $copy, $crypto, $date, $decodeBase64ToBinary, $decodeBase64ToUnicode, $deepClone, $defineProperty, $document, $encodeUnicodeToBase64, $entries, $escapeHTML, $fallbackCopy, $fetch, $fileToBase64, $formatDate, $formatWithCommas, $freeze, $genSSF, $getFileType, $getTimeString, $hasKey, $if, $inRange, $inRange2, $is, $isObject, $isPlainClass, $isValidEmailWithUnicode, $isValidOrBriefURL, $jsonParse, $jsonStringify, $keys, $lastIndex, $lindex, $loadOpt, $location, $log, $lplus, $magic, $math, $now, $numberIsFinite, $numberIsNaN, $oc, $open, $parseParams, $promise, $pureText, $randomByte, $replaceHolesWithUndefined, $rmvSlash, $rsValue, $rsetValue, $rvalue, $s, $sc, $setInterval, $setRange, $setTimeout, $stringFromCharCode, $stringFromCodePoint, $stringToRange, $strings, $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, StringObfuscator, type UNumber, __GensDirectives, _res, boxShadow, dozy, enableScaler, err403, errArg, errCode, errContent, errMsg, errNotLoggedIn, errToString, getBrightness, getColorMap, isNowAroundUtcHour, isValidColor, maybeString, registerCustomColor, s, 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, $capitalize, $checkValidEmailWithUnicode, $clamp, $clearInterval, $clearTimeout, $clone, $compressImage, $copy, $crypto, $date, $decodeBase64ToBinary, $decodeBase64ToUnicode, $deepClone, $defineProperty, $document, $encodeUnicodeToBase64, $entries, $escapeHTML, $fallbackCopy, $fetch, $fileToBase64, $formatDate, $formatWithCommas, $freeze, $genSSF, $getFileType, $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, StringObfuscator, type UNumber, __GensDirectives, _res, boxShadow, dozy, enableScaler, err403, errArg, errCode, errContent, errMsg, errNotLoggedIn, errToString, getBrightness, getColorMap, isNowAroundUtcHour, isNull, isValidColor, maybeString, registerCustomColor, s, smallChance, smartParse, smartString, standardIniter, textShadow, toHexString, toHslString, toRgbString, toRgbaArray, web$enableHttpsRedirect, web$enableProdProtector, web$encodeURI, web$pathStartData, web$redirectToDomain, web$setPathTarget, xtrim };