dozy 1.0.81 → 1.0.83

package/dist/index.d.ts

@@ -790,11 +790,29 @@ declare const $crypto: Crypto | undefined;
 
 type ScaleComputer = undefined | ((scaler: Scaler) => number);
 type ScaleIniter = (scaler: Scaler) => void;
+type ScaleResponsiveOptions = {
+    /**
+     * xls 横屏模式下的 base 乘数。
+     *
+     * 默认写成 `960 / 320`，方便直观看出是从 320 基准扩展到 960 基准。
+     */
+    baseMultiplier?: number;
+    /**
+     * xls 横屏模式下的最大宽高比。
+     *
+     * 默认写成 `1 / 0.64`，表示把原先 0.64 的竖屏限制反过来用于横屏。
+     */
+    xlsMaxAspectRatio?: number;
+    /** xls 状态变化时触发，方便业务侧保存状态。 */
+    setXls?: (b: boolean) => void;
+};
 declare class Scaler {
     #private;
     heightElement: HTMLElement;
     widthElement: HTMLElement;
     offsetHorizontal: number;
+    /** 未进入 xls 响应式扩展前的基础内容宽度，setBase 会更新这个值。 */
+    sourceBase: number;
     set base(val: number);
     get base(): number;
     set mainScale(val: number);
@@ -842,10 +860,11 @@ declare function enableScaler(outerContainer: HTMLElement, initer?: ScaleIniter,
  * @param args.setFullScreenWidth 可选回调，用于接收计算后的可用宽度。
  * @param args.setFullContentHeight 可选回调，用于接收缩放后的虚拟内容高度。
  * @param args.setMainScale 可选回调，在主缩放值变化时触发。
- * @param args.offsetHorizontal 可选的水平补偿值。
+ * @param args.offsetHorizontal 可选的水平像素补偿值，默认额外溢出 `8px`（左右各 `4px`）。
  * @param args.heightElement 可选高度测量元素，默认使用 `document.documentElement`。
  * @param args.widthElement 可选宽度测量元素，默认使用 `document.documentElement`。
  * @param args.base 可选基础内容宽度。
+ * @param args.responsive 传入后启用 xls 横屏响应式：宽大于高时切换 base 与 maxAspectRatio，并同步 `html[data-xad-xls]`。
  * @returns 返回一个可供 `enableScaler` 使用的 `ScaleIniter` 函数。
  */
 declare const standardIniter: (args: {
@@ -857,6 +876,7 @@ declare const standardIniter: (args: {
     heightElement?: HTMLElement;
     widthElement?: HTMLElement;
     base?: number;
+    responsive?: ScaleResponsiveOptions;
 }) => ScaleIniter;
 
 declare class StringObfuscator {
@@ -1395,6 +1415,6 @@ declare function toRgbString(input: string | Color | any): string | undefined;
  */
 declare function toHslString(input: string | Color | any): string | undefined;
 
-declare const DOZY = "1.0.81";
+declare const DOZY = "1.0.83";
 
-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 };
+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, type ScaleResponsiveOptions, 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 };