@polyv/utils 2.7.0 → 2.9.0-beta.1

package/cjs/boolean.d.ts

@@ -5,7 +5,7 @@
 /**
  * Y 或者 N。
  */
-export declare type YOrN = 'Y' | 'N';
+export type YOrN = 'Y' | 'N';
 /**
  * 布尔值转换为 Y 或者 N。
  * @param value 布尔值。

package/cjs/boolean.js

@@ -1 +1 @@
-"use strict";function boolToYN(o){if("boolean"!=typeof o)throw new Error("The value argument must be a boolean type");return o?"Y":"N"}function ynToBool(o,e){var r=String(o).toUpperCase();if("Y"!==r&&"N"!==r){if(null==e)throw new Error('The value argument must be "Y" or "N"');r=String(e).toUpperCase()}return"Y"===r}function allY(o){return o.every((function(o){return ynToBool(o)}))}function someY(o){return o.some((function(o){return ynToBool(o)}))}function allN(o){return o.every((function(o){return!ynToBool(o)}))}function someN(o){return o.some((function(o){return!ynToBool(o)}))}Object.defineProperty(exports,"__esModule",{value:!0}),exports.someN=exports.allN=exports.someY=exports.allY=exports.ynToBool=exports.boolToYN=void 0,exports.boolToYN=boolToYN,exports.ynToBool=ynToBool,exports.allY=allY,exports.someY=someY,exports.allN=allN,exports.someN=someN;
+"use strict";function boolToYN(o){if("boolean"!=typeof o)throw new Error("The value argument must be a boolean type");return o?"Y":"N"}function ynToBool(o,e){var r=String(o).toUpperCase();if("Y"!==r&&"N"!==r){if(null==e)throw new Error('The value argument must be "Y" or "N"');r=String(e).toUpperCase()}return"Y"===r}function allY(o){return o.every((function(o){return ynToBool(o)}))}function someY(o){return o.some((function(o){return ynToBool(o)}))}function allN(o){return o.every((function(o){return!ynToBool(o)}))}function someN(o){return o.some((function(o){return!ynToBool(o)}))}Object.defineProperty(exports,"__esModule",{value:!0}),exports.boolToYN=boolToYN,exports.ynToBool=ynToBool,exports.allY=allY,exports.someY=someY,exports.allN=allN,exports.someN=someN;

package/cjs/browser.d.ts

@@ -1,15 +1,24 @@
 /**
- * 判断当前浏览器是否运行在移动设备上（User-Agent 识别为主，特征判断为辅）。
+ * 本模块提供浏览器特性检测相关方法。
+ * @packageDocumentation
+ */
+/**
+ * 检测当前浏览器是否运行在移动设备上（User-Agent 识别为主，特征判断为辅）。
  * @returns 当前浏览器是否运行在移动设备上。
  */
 export declare function isMobile(): boolean;
 /**
- * 判断当前浏览器是否为傲游浏览器。
+ * 检测当前浏览器是否具备移动设备特征（特征判断为主，User-Agent 识别为辅）。
+ * @returns 当前浏览器是否具备移动设备特征。
+ */
+export declare function hasMobileFeature(): boolean;
+/**
+ * 检测当前浏览器是否为傲游浏览器。
  * @returns 当前浏览器是否为傲游浏览器。
  */
-export declare function isMaxthon(): any;
+export declare function isMaxthon(): boolean;
 /**
- * 判断当前浏览器是否支持通过 MSE 播放 H264 视频。
+ * 检测当前浏览器是否支持通过 MSE 播放 H264 视频。
  * @returns 当前浏览器是否支持通过 MSE 播放 H264 视频。
  */
 export declare function supportMSEH264(): boolean;

package/cjs/browser.js

@@ -1 +1 @@
-"use strict";function isMobile(){var o=navigator.userAgent;return!!(/mobile|android/i.test(o)||/\bMacintosh\b/.test(o)&&navigator.maxTouchPoints)||!/\b(Windows\sNT|Macintosh|x86(_(32|64))?|amd64|i[1-6]86)\b/.test(o)&&"onorientationchange"in window}function isMaxthon(){var o=navigator.userAgent;if(/\bMaxthon\b/i.test(o))return!0;if("maxthon"in window){var t=window.maxthon;return"function"==typeof t.IsMaxthon&&t.IsMaxthon()}return!1}function supportMSEH264(){var o=window.MediaSource;return o&&"function"==typeof o.isTypeSupported&&o.isTypeSupported('video/mp4; codecs="avc1.42E01E,mp4a.40.2"')}Object.defineProperty(exports,"__esModule",{value:!0}),exports.supportMSEH264=exports.isMaxthon=exports.isMobile=void 0,exports.isMobile=isMobile,exports.isMaxthon=isMaxthon,exports.supportMSEH264=supportMSEH264;
+"use strict";function isMobile(){var t=navigator.userAgent;return!!/mobile|android/i.test(t)||!/\b(Windows\sNT|Macintosh|x86(_(32|64))?|amd64|i[1-6]86)\b/.test(t)&&("onorientationchange"in window&&"number"==typeof window.orientation)}function hasMobileFeature(){var t=navigator.platform;return"onorientationchange"in window&&"number"==typeof window.orientation||(!!/^(iPhone|iPod|iPad)/.test(t)||"Win32"!==t&&!/^Linux\s*(x86|i686)/.test(t)&&("MacIntel"===t||"Macintosh"===t?navigator.maxTouchPoints>0:"function"==typeof matchMedia&&(matchMedia("(hover: none)").matches&&matchMedia("(pointer: coarse)").matches&&!matchMedia("(pointer: fine)").matches)))}function isMaxthon(){var t=navigator.userAgent;if(/\bMaxthon\b/i.test(t))return!0;if("maxthon"in window){var e=window.maxthon;return"function"==typeof e.IsMaxthon&&e.IsMaxthon()}return!1}function supportMSEH264(){var t=window.MediaSource;return t&&"function"==typeof t.isTypeSupported&&t.isTypeSupported('video/mp4; codecs="avc1.42E01E,mp4a.40.2"')}Object.defineProperty(exports,"__esModule",{value:!0}),exports.isMobile=isMobile,exports.hasMobileFeature=hasMobileFeature,exports.isMaxthon=isMaxthon,exports.supportMSEH264=supportMSEH264;

package/cjs/countdown.d.ts

@@ -70,7 +70,7 @@ export declare class Countdown {
     protected _timerId?: number;
     /**
      * 倒计时类构造函数。
-     * @param secs 倒计时总秒数。
+     * @param totalSecs 倒计时总秒数。
      * @param cb 剩余时长的回调函数，正常情况下大概 1 秒回调一次。
      */
     constructor(totalSecs: number, cb: ICountdownCallback);

package/cjs/date.js

@@ -1 +1 @@
-"use strict";function ensureDate(e){return"object"!=typeof e&&(e=new Date(e)),e}function formatDate(e,t){var r={Y:(e=ensureDate(e)).getFullYear(),M:e.getMonth()+1,D:e.getDate(),h:e.getHours(),m:e.getMinutes(),s:e.getSeconds()};return t.replace(/([YMDhms])\1*/g,(function(e){var t=r[e[0]].toString(),n=e.length;return n>t.length&&(t=new Array(n-t.length+1).join("0")+t),t}))}function formatSeconds(e,t){if(void 0===t&&(t={segments:2,digits:2}),e=Number(e),isNaN(e)||e<0)throw new Error('"secs" must be a positive integer');var r=0|(t.segments||2),n=0|(t.digits||2);n=Math.max(1,n),-1===[2,3].indexOf(r)&&(r=2);var o=new Array(n+1).join("0"),a=[60,1];return 3===t.segments&&a.unshift(3600),a.map((function(t){var r=Math.floor(e/t),a=r.toString().length;return e%=t,(o+r).slice(-Math.max(a,n))})).join(":")}Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatSeconds=exports.formatDate=void 0,exports.formatDate=formatDate,exports.formatSeconds=formatSeconds;
+"use strict";function ensureDate(e){return"object"!=typeof e&&(e=new Date(e)),e}function formatDate(e,t){var r={Y:(e=ensureDate(e)).getFullYear(),M:e.getMonth()+1,D:e.getDate(),h:e.getHours(),m:e.getMinutes(),s:e.getSeconds()};return t.replace(/([YMDhms])\1*/g,(function(e){var t=r[e[0]].toString(),n=e.length;return n>t.length&&(t=new Array(n-t.length+1).join("0")+t),t}))}function formatSeconds(e,t){if(void 0===t&&(t={segments:2,digits:2}),e=Number(e),isNaN(e)||e<0)throw new Error('"secs" must be a positive integer');var r=0|(t.segments||2),n=0|(t.digits||2);n=Math.max(1,n),-1===[2,3].indexOf(r)&&(r=2);var o=new Array(n+1).join("0"),a=[60,1];return 3===t.segments&&a.unshift(3600),a.map((function(t){var r=Math.floor(e/t),a=r.toString().length;return e%=t,(o+r).slice(-Math.max(a,n))})).join(":")}Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatDate=formatDate,exports.formatSeconds=formatSeconds;

package/cjs/event.d.ts

@@ -59,15 +59,15 @@
 /**
  * 事件类型
  */
-export declare type EventType = number | string | symbol;
+export type EventType = number | string | symbol;
 /**
  * 事件参数关系类型
  */
-export declare type EventRelationsType = Record<EventType, unknown>;
+export type EventRelationsType = Record<EventType, unknown>;
 /**
  * 事件回调函数类型
  */
-export declare type EventHandler<Relations extends EventRelationsType, E extends EventType> = (params: Relations[E]) => unknown;
+export type EventHandler<Relations extends EventRelationsType, E extends EventType> = (params: Relations[E]) => unknown;
 export declare class EventEmitter<Relations extends EventRelationsType = EventRelationsType, Events extends EventType = string> {
     /**
      * 事件回调存储器

package/cjs/file.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 本模块提供文件处理相关方法。
+ * @packageDocumentation
+ */
+/**
+ * 文件体积单位。
+ */
+export declare enum FileSizeUnit {
+    B = "B",
+    KB = "KB",
+    MB = "MB",
+    GB = "GB",
+    TB = "TB"
+}
+/**
+ * 文件体积转换选项。
+ */
+export interface FileSizeConversionOptions {
+    /**
+     * 目标单位。
+     */
+    unit: FileSizeUnit;
+    /**
+     * 是否允许纯小数。
+     * 如果不允许，则在保证转换目标值大于 1 的前提下，以距离目标单位最近的单位进行转换。
+     * 默认为允许。
+     */
+    allowPureDecimal?: boolean;
+}
+/**
+ * 文件体积转换结果。
+ */
+export interface FileSizeConversionResult {
+    /**
+     * 转过结果的值。
+     */
+    value: number;
+    /**
+     * 转换结果的单位。
+     */
+    unit: FileSizeUnit;
+}
+/**
+ * 转换文件体积。
+ * @param sizeInBytes 以字节为单位的文件体积值。
+ * @param options 转换选项。
+ * @returns 转换结果。
+ */
+export declare function convertFileSize(sizeInBytes: number, options: FileSizeUnit | FileSizeConversionOptions): FileSizeConversionResult;

package/cjs/file.js

@@ -0,0 +1 @@
+"use strict";var FileSizeUnit;function convertFileSize(e,i){var t="object"==typeof i?Object.assign({},i):{unit:i};if(!t.unit)throw new Error("Please specify file size unit");var n=[FileSizeUnit.B,FileSizeUnit.KB,FileSizeUnit.MB,FileSizeUnit.GB,FileSizeUnit.TB],l={value:e,unit:t.unit};return n.some((function(i,r){var o=e/Math.pow(1024,r);return!1===t.allowPureDecimal&&o<1||(l.value=o,l.unit=i,t.unit===i||r===n.length)})),l}Object.defineProperty(exports,"__esModule",{value:!0}),exports.FileSizeUnit=void 0,exports.convertFileSize=convertFileSize,function(e){e.B="B",e.KB="KB",e.MB="MB",e.GB="GB",e.TB="TB"}(FileSizeUnit||(exports.FileSizeUnit=FileSizeUnit={}));

package/cjs/image.js

@@ -1 +1 @@
-"use strict";function supportWebP(){var A=document.createElement("canvas");if(A.getContext&&A.getContext("2d")){var e="image/webp";return 0===A.toDataURL(e).indexOf("data:"+e)}return!1}function supportAVIF(){return new Promise((function(A){var e=new Image;e.src="data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAAB0AAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAIAAAACAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQ0MAAAAABNjb2xybmNseAACAAIAAYAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAACVtZGF0EgAKCBgANogQEAwgMg8f8D///8WfhwB8+ErK42A=",e.onerror=function(){A(!1)},e.onload=function(){A(!0)},setTimeout((function(){A(!1)}),1e3)}))}function ossCompress(A,e){var s=document.createElement("a");s.href=A;var t=s.search,o=s.hostname.toLowerCase();if(-1===["liveimages.videocc.net","vod-assets.videocc.net"].indexOf(o)||/(?:\?|&)x-oss-process(?:=|&|$)/.test(t))return A;var r="";return null==e.width&&null==e.height||(r+="/resize",e.width&&(r+=",w_"+e.width),e.height&&(r+=",h_"+e.height),r+=",limit_1"),e.allowAVIF?r+="/format,avif":e.allowWebP&&(r+="/format,webp"),r&&(r="x-oss-process=image"+r,A+=(-1===A.indexOf("?")?"?":"&")+r),A}function compressHTMLImgs(A,e){return A?A.replace(/(<img.*?\ssrc=)(["']?)(.+?)\2(.*?>)/gi,(function(A,s,t,o,r){return s+'"'+ossCompress(o,e)+'" data-src="'+o+'"'+r})):""}Object.defineProperty(exports,"__esModule",{value:!0}),exports.compressHTMLImgs=exports.ossCompress=exports.supportAVIF=exports.supportWebP=void 0,exports.supportWebP=supportWebP,exports.supportAVIF=supportAVIF,exports.ossCompress=ossCompress,exports.compressHTMLImgs=compressHTMLImgs;
+"use strict";function supportWebP(){var A=document.createElement("canvas");if(A.getContext&&A.getContext("2d")){var e="image/webp";return 0===A.toDataURL(e).indexOf("data:"+e)}return!1}function supportAVIF(){return new Promise((function(A){var e=new Image;e.src="data:image/avif;base64,AAAAIGZ0eXBhdmlmAAAAAGF2aWZtaWYxbWlhZk1BMUIAAADybWV0YQAAAAAAAAAoaGRscgAAAAAAAAAAcGljdAAAAAAAAAAAAAAAAGxpYmF2aWYAAAAADnBpdG0AAAAAAAEAAAAeaWxvYwAAAABEAAABAAEAAAABAAABGgAAAB0AAAAoaWluZgAAAAAAAQAAABppbmZlAgAAAAABAABhdjAxQ29sb3IAAAAAamlwcnAAAABLaXBjbwAAABRpc3BlAAAAAAAAAAIAAAACAAAAEHBpeGkAAAAAAwgICAAAAAxhdjFDgQ0MAAAAABNjb2xybmNseAACAAIAAYAAAAAXaXBtYQAAAAAAAAABAAEEAQKDBAAAACVtZGF0EgAKCBgANogQEAwgMg8f8D///8WfhwB8+ErK42A=",e.onerror=function(){A(!1)},e.onload=function(){A(!0)},setTimeout((function(){A(!1)}),1e3)}))}function ossCompress(A,e){var t=document.createElement("a");t.href=A;var s=t.search,o=t.hostname.toLowerCase();if(-1===["liveimages.videocc.net","vod-assets.videocc.net"].indexOf(o)||/(?:\?|&)x-oss-process(?:=|&|$)/.test(s))return A;var r="";return null==e.width&&null==e.height||(r+="/resize",e.width&&(r+=",w_"+e.width),e.height&&(r+=",h_"+e.height),r+=",limit_1"),e.allowAVIF?r+="/format,avif":e.allowWebP&&(r+="/format,webp"),r&&(r="x-oss-process=image"+r,A+=(-1===A.indexOf("?")?"?":"&")+r),A}function compressHTMLImgs(A,e){return A?A.replace(/(<img.*?\ssrc=)(["']?)(.+?)\2(.*?>)/gi,(function(A,t,s,o,r){return t+'"'+ossCompress(o,e)+'" data-src="'+o+'"'+r})):""}Object.defineProperty(exports,"__esModule",{value:!0}),exports.supportWebP=supportWebP,exports.supportAVIF=supportAVIF,exports.ossCompress=ossCompress,exports.compressHTMLImgs=compressHTMLImgs;

package/cjs/json.js

@@ -1 +1 @@
-"use strict";function cloneJSON(e){return null==e?e:JSON.parse(JSON.stringify(e))}function tryParseJSON(e,r){var t;try{t=JSON.parse(e)}catch(e){t="function"==typeof r?r(e):r}return t}Object.defineProperty(exports,"__esModule",{value:!0}),exports.tryParseJSON=exports.cloneJSON=void 0,exports.cloneJSON=cloneJSON,exports.tryParseJSON=tryParseJSON;
+"use strict";function cloneJSON(e){return null==e?e:JSON.parse(JSON.stringify(e))}function tryParseJSON(e,r){var t;try{t=JSON.parse(e)}catch(e){t="function"==typeof r?r(e):r}return t}Object.defineProperty(exports,"__esModule",{value:!0}),exports.cloneJSON=cloneJSON,exports.tryParseJSON=tryParseJSON;

package/cjs/net.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.normalizeProtocol=exports.removeProtocol=exports.changeProtocol=exports.startsWithProtocol=void 0;var reProtocol=/^(?:([a-z]+):)?\/{2,3}/i;function startsWithProtocol(o,t){var r=reProtocol.test(o);if(r&&t){for(var e=(RegExp.$1||"").toLowerCase(),c=t.length-1;c>=0;c--)if(e===t[c].toLowerCase())return!0;return!1}return r}function changeProtocol(o,t){return reProtocol.test(t)||(t+="://"),startsWithProtocol(o)?o.replace(reProtocol,t):t+o}function removeProtocol(o){return o.replace(reProtocol,"")}function normalizeProtocol(o){return changeProtocol(o,"http:"===window.location.protocol?"http":"https")}exports.startsWithProtocol=startsWithProtocol,exports.changeProtocol=changeProtocol,exports.removeProtocol=removeProtocol,exports.normalizeProtocol=normalizeProtocol;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.startsWithProtocol=startsWithProtocol,exports.changeProtocol=changeProtocol,exports.removeProtocol=removeProtocol,exports.normalizeProtocol=normalizeProtocol;var reProtocol=/^(?:([a-z]+):)?\/{2,3}/i;function startsWithProtocol(o,t){var r=reProtocol.test(o);if(r&&t){for(var e=(RegExp.$1||"").toLowerCase(),c=t.length-1;c>=0;c--)if(e===t[c].toLowerCase())return!0;return!1}return r}function changeProtocol(o,t){return reProtocol.test(t)||(t+="://"),startsWithProtocol(o)?o.replace(reProtocol,t):t+o}function removeProtocol(o){return o.replace(reProtocol,"")}function normalizeProtocol(o){return changeProtocol(o,"http:"===window.location.protocol?"http":"https")}

package/cjs/string.d.ts

@@ -91,8 +91,8 @@ export declare function randomStr(length: number, prefix?: string): string;
 export declare function uuidV4(): string;
 /**
  * 版本号对比。
- * @param versionA 待比较版本 A。
- * @param versionB 待比较版本 B。
+ * @param verA 待比较版本 A。
+ * @param verB 待比较版本 B。
  * @return 大于 0 时，表示版本 A 大于版本 B；
  *   小于 0 时，表示版本 B 大于版本 A；
  *   等于 0 时，表示两个版本号一致。

package/cjs/string.js

@@ -1 +1 @@
-"use strict";function strLen(e,n){var r,t;"number"==typeof n?n={enLen:1,nonEnLen:n}:((n=n||{}).enLen=null!==(r=n.enLen)&&void 0!==r?r:1,n.nonEnLen=null!==(t=n.nonEnLen)&&void 0!==t?t:2);for(var o=0,s=e.length-1;s>=0;s--)o+=e.charCodeAt(s)>255?n.nonEnLen||0:n.enLen||0;return o}function cutStr(e,n,r){(r=r||{}).enLen=Number(r.enLen)||1,r.nonEnLen=Number(r.nonEnLen)||2,r.ellipsis=r.ellipsis||"...";var t=strLen(e=String(e),r);if(t<=n)return e;n-=strLen(r.ellipsis,r);for(var o="",s=-1;n>0&&++s<t;)(n-=e.charCodeAt(s)>255?r.nonEnLen:r.enLen)>=0&&(o+=e.charAt(s));return o+=r.ellipsis}Object.defineProperty(exports,"__esModule",{value:!0}),exports.compareVersions=exports.uuidV4=exports.randomStr=exports.nl2br=exports.removeTags=exports.unescapeHTML=exports.escapeHTML=exports.cutStr=exports.strLen=void 0,exports.strLen=strLen,exports.cutStr=cutStr;var htmlChars=['"',"'","&","<",">"],htmlEntities=["&quot;","&#39;","&amp;","&lt;","&gt;"],charsToEntities=Object.create(null),entitiesToChars=Object.create(null);htmlChars.forEach((function(e,n){charsToEntities[e]=htmlEntities[n],entitiesToChars[htmlEntities[n]]=e}));var reHTMLChars=new RegExp("["+htmlChars.join("")+"]","g"),reHTMLEntities=new RegExp("("+htmlEntities.join("|")+")","g");function escapeHTML(e){return null==e?e:String(e).replace(reHTMLChars,(function(e){return charsToEntities[e]}))}function unescapeHTML(e){return null==e?e:String(e).replace(reHTMLEntities,(function(e){return entitiesToChars[e]}))}function removeTags(e){return null==e?"":String(e).replace(/<.+?>/g,"")}function nl2br(e){return null==e?e:String(e).replace(/\r?\n/g,"<br />")}function randomStr(e,n){if(!(e|=0)||e<0)throw new Error('"length" must be a number greater than 0');var r="";do{r+=Math.random().toString(36).substr(2)}while(r.length<e);return r=r.substr(0,e),null!=n&&(r=n+r),r}function uuidV4(){var e=Date.now();return"undefined"!=typeof performance&&"function"==typeof performance.now&&(e+=performance.now()),"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,(function(n){var r=(e+16*Math.random())%16|0;return e=Math.floor(e/16),("x"===n?r:3&r|8).toString(16)}))}function compareVersions(e,n){if(!e||!n)throw new Error("Please specify both verA and verB");for(var r=/(\.0+)+$/,t=String(e).replace(r,"").split("."),o=String(n).replace(r,"").split("."),s=Math.min(t.length,o.length),i=0;i<s;i++){var a=parseInt(t[i])-parseInt(o[i]);if(a)return a}return t.length-o.length}exports.escapeHTML=escapeHTML,exports.unescapeHTML=unescapeHTML,exports.removeTags=removeTags,exports.nl2br=nl2br,exports.randomStr=randomStr,exports.uuidV4=uuidV4,exports.compareVersions=compareVersions;
+"use strict";function strLen(e,n){var r,t;"number"==typeof n?n={enLen:1,nonEnLen:n}:((n=n||{}).enLen=null!==(r=n.enLen)&&void 0!==r?r:1,n.nonEnLen=null!==(t=n.nonEnLen)&&void 0!==t?t:2);for(var o=0,i=e.length-1;i>=0;i--)o+=e.charCodeAt(i)>255?n.nonEnLen||0:n.enLen||0;return o}function cutStr(e,n,r){(r=r||{}).enLen=Number(r.enLen)||1,r.nonEnLen=Number(r.nonEnLen)||2,r.ellipsis=r.ellipsis||"...";var t=strLen(e=String(e),r);if(t<=n)return e;n-=strLen(r.ellipsis,r);for(var o="",i=-1;n>0&&++i<t;)(n-=e.charCodeAt(i)>255?r.nonEnLen:r.enLen)>=0&&(o+=e.charAt(i));return o+=r.ellipsis}Object.defineProperty(exports,"__esModule",{value:!0}),exports.strLen=strLen,exports.cutStr=cutStr,exports.escapeHTML=escapeHTML,exports.unescapeHTML=unescapeHTML,exports.removeTags=removeTags,exports.nl2br=nl2br,exports.randomStr=randomStr,exports.uuidV4=uuidV4,exports.compareVersions=compareVersions;var htmlChars=['"',"'","&","<",">"],htmlEntities=["&quot;","&#39;","&amp;","&lt;","&gt;"],charsToEntities=Object.create(null),entitiesToChars=Object.create(null);htmlChars.forEach((function(e,n){charsToEntities[e]=htmlEntities[n],entitiesToChars[htmlEntities[n]]=e}));var reHTMLChars=new RegExp("["+htmlChars.join("")+"]","g"),reHTMLEntities=new RegExp("("+htmlEntities.join("|")+")","g");function escapeHTML(e){return null==e?e:String(e).replace(reHTMLChars,(function(e){return charsToEntities[e]}))}function unescapeHTML(e){return null==e?e:String(e).replace(reHTMLEntities,(function(e){return entitiesToChars[e]}))}function removeTags(e){return null==e?"":String(e).replace(/<.+?>/g,"")}function nl2br(e){return null==e?e:String(e).replace(/\r?\n/g,"<br />")}function randomStr(e,n){if(!(e|=0)||e<0)throw new Error('"length" must be a number greater than 0');var r="";do{r+=Math.random().toString(36).substr(2)}while(r.length<e);return r=r.substr(0,e),null!=n&&(r=n+r),r}function uuidV4(){var e=Date.now();return"undefined"!=typeof performance&&"function"==typeof performance.now&&(e+=performance.now()),"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,(function(n){var r=(e+16*Math.random())%16|0;return e=Math.floor(e/16),("x"===n?r:3&r|8).toString(16)}))}function compareVersions(e,n){if(!e||!n)throw new Error("Please specify both verA and verB");for(var r=/(\.0+)+$/,t=String(e).replace(r,"").split("."),o=String(n).replace(r,"").split("."),i=Math.min(t.length,o.length),s=0;s<i;s++){var a=parseInt(t[s])-parseInt(o[s]);if(a)return a}return t.length-o.length}

package/cjs/validate.js

@@ -1 +1 @@
-"use strict";function isChsPhoneNO(e){return/^1[3-9]\d{9}$/.test(e)}function isPhoneNO(e,s){return void 0===s&&(s="+86"),"+86"===s?isChsPhoneNO(e):/^\d{5,20}$/.test(e)}function isEmail(e){if(/^[\w-]+(?:\.[\w-]+)*@[\w-]+(?:\.[\w-]+)*\.[a-zA-Z]{2,}$/.test(e)){for(var s=e.replace("@",".").split("."),t=s.length-1;t>=0;t--)if(/^[-_]/.test(s[t])||/[_-]$/.test(s[t]))return!1;return!0}return!1}Object.defineProperty(exports,"__esModule",{value:!0}),exports.isEmail=exports.isPhoneNO=exports.isChsPhoneNO=void 0,exports.isChsPhoneNO=isChsPhoneNO,exports.isPhoneNO=isPhoneNO,exports.isEmail=isEmail;
+"use strict";function isChsPhoneNO(e){return/^1[3-9]\d{9}$/.test(e)}function isPhoneNO(e,t){return void 0===t&&(t="+86"),"+86"===t?isChsPhoneNO(e):/^\d{5,20}$/.test(e)}function isEmail(e){if(/^[\w-]+(?:\.[\w-]+)*@[\w-]+(?:\.[\w-]+)*\.[a-zA-Z]{2,}$/.test(e)){for(var t=e.replace("@",".").split("."),s=t.length-1;s>=0;s--)if(/^[-_]/.test(t[s])||/[_-]$/.test(t[s]))return!1;return!0}return!1}Object.defineProperty(exports,"__esModule",{value:!0}),exports.isChsPhoneNO=isChsPhoneNO,exports.isPhoneNO=isPhoneNO,exports.isEmail=isEmail;

package/es/boolean.d.ts

@@ -5,7 +5,7 @@
 /**
  * Y 或者 N。
  */
-export declare type YOrN = 'Y' | 'N';
+export type YOrN = 'Y' | 'N';
 /**
  * 布尔值转换为 Y 或者 N。
  * @param value 布尔值。

package/es/browser.d.ts

@@ -1,15 +1,24 @@
 /**
- * 判断当前浏览器是否运行在移动设备上（User-Agent 识别为主，特征判断为辅）。
+ * 本模块提供浏览器特性检测相关方法。
+ * @packageDocumentation
+ */
+/**
+ * 检测当前浏览器是否运行在移动设备上（User-Agent 识别为主，特征判断为辅）。
  * @returns 当前浏览器是否运行在移动设备上。
  */
 export declare function isMobile(): boolean;
 /**
- * 判断当前浏览器是否为傲游浏览器。
+ * 检测当前浏览器是否具备移动设备特征（特征判断为主，User-Agent 识别为辅）。
+ * @returns 当前浏览器是否具备移动设备特征。
+ */
+export declare function hasMobileFeature(): boolean;
+/**
+ * 检测当前浏览器是否为傲游浏览器。
  * @returns 当前浏览器是否为傲游浏览器。
  */
-export declare function isMaxthon(): any;
+export declare function isMaxthon(): boolean;
 /**
- * 判断当前浏览器是否支持通过 MSE 播放 H264 视频。
+ * 检测当前浏览器是否支持通过 MSE 播放 H264 视频。
  * @returns 当前浏览器是否支持通过 MSE 播放 H264 视频。
  */
 export declare function supportMSEH264(): boolean;

package/es/browser.js

@@ -1 +1 @@
-export function isMobile(){const t=navigator.userAgent;return!!(/mobile|android/i.test(t)||/\bMacintosh\b/.test(t)&&navigator.maxTouchPoints)||!/\b(Windows\sNT|Macintosh|x86(_(32|64))?|amd64|i[1-6]86)\b/.test(t)&&"onorientationchange"in window}export function isMaxthon(){const t=navigator.userAgent;if(/\bMaxthon\b/i.test(t))return!0;if("maxthon"in window){const t=window.maxthon;return"function"==typeof t.IsMaxthon&&t.IsMaxthon()}return!1}export function supportMSEH264(){const t=window.MediaSource;return t&&"function"==typeof t.isTypeSupported&&t.isTypeSupported('video/mp4; codecs="avc1.42E01E,mp4a.40.2"')}
+export function isMobile(){const n=navigator.userAgent;return!!/mobile|android/i.test(n)||!/\b(Windows\sNT|Macintosh|x86(_(32|64))?|amd64|i[1-6]86)\b/.test(n)&&("onorientationchange"in window&&"number"==typeof window.orientation)}export function hasMobileFeature(){const n=navigator.platform;return"onorientationchange"in window&&"number"==typeof window.orientation||(!!/^(iPhone|iPod|iPad)/.test(n)||"Win32"!==n&&!/^Linux\s*(x86|i686)/.test(n)&&("MacIntel"===n||"Macintosh"===n?navigator.maxTouchPoints>0:"function"==typeof matchMedia&&(matchMedia("(hover: none)").matches&&matchMedia("(pointer: coarse)").matches&&!matchMedia("(pointer: fine)").matches)))}export function isMaxthon(){const n=navigator.userAgent;if(/\bMaxthon\b/i.test(n))return!0;if("maxthon"in window){const n=window.maxthon;return"function"==typeof n.IsMaxthon&&n.IsMaxthon()}return!1}export function supportMSEH264(){const n=window.MediaSource;return n&&"function"==typeof n.isTypeSupported&&n.isTypeSupported('video/mp4; codecs="avc1.42E01E,mp4a.40.2"')}

package/es/countdown.d.ts

@@ -70,7 +70,7 @@ export declare class Countdown {
     protected _timerId?: number;
     /**
      * 倒计时类构造函数。
-     * @param secs 倒计时总秒数。
+     * @param totalSecs 倒计时总秒数。
      * @param cb 剩余时长的回调函数，正常情况下大概 1 秒回调一次。
      */
     constructor(totalSecs: number, cb: ICountdownCallback);

package/es/event.d.ts

@@ -59,15 +59,15 @@
 /**
  * 事件类型
  */
-export declare type EventType = number | string | symbol;
+export type EventType = number | string | symbol;
 /**
  * 事件参数关系类型
  */
-export declare type EventRelationsType = Record<EventType, unknown>;
+export type EventRelationsType = Record<EventType, unknown>;
 /**
  * 事件回调函数类型
  */
-export declare type EventHandler<Relations extends EventRelationsType, E extends EventType> = (params: Relations[E]) => unknown;
+export type EventHandler<Relations extends EventRelationsType, E extends EventType> = (params: Relations[E]) => unknown;
 export declare class EventEmitter<Relations extends EventRelationsType = EventRelationsType, Events extends EventType = string> {
     /**
      * 事件回调存储器

package/es/file.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 本模块提供文件处理相关方法。
+ * @packageDocumentation
+ */
+/**
+ * 文件体积单位。
+ */
+export declare enum FileSizeUnit {
+    B = "B",
+    KB = "KB",
+    MB = "MB",
+    GB = "GB",
+    TB = "TB"
+}
+/**
+ * 文件体积转换选项。
+ */
+export interface FileSizeConversionOptions {
+    /**
+     * 目标单位。
+     */
+    unit: FileSizeUnit;
+    /**
+     * 是否允许纯小数。
+     * 如果不允许，则在保证转换目标值大于 1 的前提下，以距离目标单位最近的单位进行转换。
+     * 默认为允许。
+     */
+    allowPureDecimal?: boolean;
+}
+/**
+ * 文件体积转换结果。
+ */
+export interface FileSizeConversionResult {
+    /**
+     * 转过结果的值。
+     */
+    value: number;
+    /**
+     * 转换结果的单位。
+     */
+    unit: FileSizeUnit;
+}
+/**
+ * 转换文件体积。
+ * @param sizeInBytes 以字节为单位的文件体积值。
+ * @param options 转换选项。
+ * @returns 转换结果。
+ */
+export declare function convertFileSize(sizeInBytes: number, options: FileSizeUnit | FileSizeConversionOptions): FileSizeConversionResult;

package/es/file.js

@@ -0,0 +1 @@
+export var FileSizeUnit;!function(i){i.B="B",i.KB="KB",i.MB="MB",i.GB="GB",i.TB="TB"}(FileSizeUnit||(FileSizeUnit={}));export function convertFileSize(i,e){const t="object"==typeof e?Object.assign({},e):{unit:e};if(!t.unit)throw new Error("Please specify file size unit");const n=[FileSizeUnit.B,FileSizeUnit.KB,FileSizeUnit.MB,FileSizeUnit.GB,FileSizeUnit.TB],l={value:i,unit:t.unit};return n.some(((e,o)=>{const B=i/Math.pow(1024,o);return!1===t.allowPureDecimal&&B<1||(l.value=B,l.unit=e,t.unit===e||o===n.length)})),l}

package/es/string.d.ts

@@ -91,8 +91,8 @@ export declare function randomStr(length: number, prefix?: string): string;
 export declare function uuidV4(): string;
 /**
  * 版本号对比。
- * @param versionA 待比较版本 A。
- * @param versionB 待比较版本 B。
+ * @param verA 待比较版本 A。
+ * @param verB 待比较版本 B。
  * @return 大于 0 时，表示版本 A 大于版本 B；
  *   小于 0 时，表示版本 B 大于版本 A；
  *   等于 0 时，表示两个版本号一致。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyv/utils",
-  "version": "2.7.0",
+  "version": "2.9.0-beta.1",
   "description": "Utility functions of Polyv frontend development.",
   "keywords": [
     "polyv",
@@ -18,8 +18,7 @@
   },
   "homepage": "https://polyv.github.io/fed-common-utils/index.html",
   "engines": {
-    "node": ">=10.0.0"
+    "node": ">=20.0.0"
   },
-  "dependencies": {},
   "miniprogram": "./"
 }