@polyv/utils 2.0.0-beta.1 → 2.0.0-beta.4

package/README.md

@@ -5,7 +5,7 @@
 ## 安装
 
 ```
-npm install @polyv/utils
+npm install @polyv/utils@next
 ```
 
 NPM 包同时提供了 ES 模块以及 CommonJS 模块，分别位于 `dist/es` 和 `dist/cjs` 两个文件夹。它们使用上的区别和优缺点在于：
@@ -86,19 +86,19 @@ import { Countdown } from '@utils/countdown';
 - Android >= 5 (未测试更低版本)
 
 ## 其他
-- [API 文档（1.6.3）](https://polyv.github.io/fed-common-utils/1.6.3/index.html)
+- [API 文档（1.x）](https://polyv.github.io/fed-common-utils/1.x/index.html)
 - [API 文档（2.x）](https://polyv.github.io/fed-common-utils/2.x/index.html)
 
 ## 2.0.0 版本的变更
 
 2.0.0 与 1.x 相比有较大的变更，如需升级，请参阅下方变更说明：
 
-- 部分功能模块分离为独立的 npm 包：
-  - 原 lang 模块已移除，请使用 [@just4/util](https://www.npmjs.com/package/@just4/util)。
-  - 原 browser 模块已移除，请使用 [@just4/ua-info](https://www.npmjs.com/package/@just4/ua-info)。
-  - 原 cookie 模块已移除，请使用 [@just4/cookie](https://www.npmjs.com/package/@just4/cookie)。
-  - 原 polling 模块已移除，请使用 [@just4/polling](https://www.npmjs.com/package/@just4/polling)。
-  - 原 storage 模块已移除，请使用 [@just4/storage](https://www.npmjs.com/package/@just4/storage)。
+- 模块变更：
+  - 原 lang 模块已移除，可以使用 [@just4/util](https://www.npmjs.com/package/@just4/util) 或 [lodash-es](https://www.npmjs.com/package/lodash-es) 代替。
+  - 原 browser 模块已移除，可以使用 [@just4/ua-info](https://www.npmjs.com/package/@just4/ua-info) 代替。
+  - 原 cookie 模块已移除，可以使用 [@just4/cookie](https://www.npmjs.com/package/@just4/cookie) 代替。
+  - 原 polling 模块已移除，可以使用 [@just4/polling](https://www.npmjs.com/package/@just4/polling) 代替。
+  - 原 storage 模块已移除，可以使用 [@just4/storage](https://www.npmjs.com/package/@just4/storage) 代替。
 - 部分 API 的变更：
   - boolean 模块的 `ynToBool` 支持指定默认值。
   - countdown 模块的 `Countdown` 类增加 `pause` 方法。

package/dist/cjs/boolean.d.ts

@@ -15,10 +15,16 @@ export declare function boolToYN(value: boolean): YOrN;
 /**
  * Y 或者 N 转换为布尔值。
  * @param value Y 或者 N。
+ * @return 布尔值。
+ */
+export declare function ynToBool(value: YOrN): boolean;
+/**
+ * Y 或者 N 转换为布尔值。
+ * @param value Y 或 N 为合法值，其他为非法值。
  * @param defaultValue 当 value 为非法值时的默认值。
  * @return 布尔值。
  */
-export declare function ynToBool(value: YOrN, defaultValue?: YOrN): boolean;
+export declare function ynToBool(value: unknown, defaultValue?: YOrN): boolean;
 /**
  * 检查指定数组元素的值是否都为 Y。
  * @param values 指定数组。

package/dist/cjs/date.d.ts

@@ -20,7 +20,7 @@ export interface FormatSecondsOptions {
     /**
      * 段数，2 或者 3。
      * 为 3 时，格式化样式为「时:分:秒」。
-     * 为 2 时，如果小时为 0，则格式化样式为「分:秒」，否则与段数为 3 时一致。
+     * 为 2 时，格式化样式为「分:秒」。
      */
     segments?: number;
     /**
@@ -35,10 +35,10 @@ export interface FormatSecondsOptions {
  * @return 格式化结果。
  * @example
  * ```javascript
- * formatSeconds(3682); // '01:01:22'
+ * formatSeconds(3682); // '61:22'
  * formatSeconds(82); // '01:22'
  * formatSeconds(82, { segments: 3 }); // '00:01:22'
- * formatSeconds(3682, { digits: 1 }); // '1:1:22'
+ * formatSeconds(3682, { segments: 3, digits: 1 }); // '1:1:22'
  * ```
  */
 export declare function formatSeconds(secs: number, options?: FormatSecondsOptions): string;

package/dist/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=[3600,60,1].map((function(t){var r=Math.floor(e/t),a=r.toString().length;return e%=t,(o+r).slice(-Math.max(a,n))}));return r<3&&!Number(a[0])&&a.shift(),a.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.formatSeconds=exports.formatDate=void 0,exports.formatDate=formatDate,exports.formatSeconds=formatSeconds;

package/dist/es/boolean.d.ts

@@ -15,10 +15,16 @@ export declare function boolToYN(value: boolean): YOrN;
 /**
  * Y 或者 N 转换为布尔值。
  * @param value Y 或者 N。
+ * @return 布尔值。
+ */
+export declare function ynToBool(value: YOrN): boolean;
+/**
+ * Y 或者 N 转换为布尔值。
+ * @param value Y 或 N 为合法值，其他为非法值。
  * @param defaultValue 当 value 为非法值时的默认值。
  * @return 布尔值。
  */
-export declare function ynToBool(value: YOrN, defaultValue?: YOrN): boolean;
+export declare function ynToBool(value: unknown, defaultValue?: YOrN): boolean;
 /**
  * 检查指定数组元素的值是否都为 Y。
  * @param values 指定数组。

package/dist/es/date.d.ts

@@ -20,7 +20,7 @@ export interface FormatSecondsOptions {
     /**
      * 段数，2 或者 3。
      * 为 3 时，格式化样式为「时:分:秒」。
-     * 为 2 时，如果小时为 0，则格式化样式为「分:秒」，否则与段数为 3 时一致。
+     * 为 2 时，格式化样式为「分:秒」。
      */
     segments?: number;
     /**
@@ -35,10 +35,10 @@ export interface FormatSecondsOptions {
  * @return 格式化结果。
  * @example
  * ```javascript
- * formatSeconds(3682); // '01:01:22'
+ * formatSeconds(3682); // '61:22'
  * formatSeconds(82); // '01:22'
  * formatSeconds(82, { segments: 3 }); // '00:01:22'
- * formatSeconds(3682, { digits: 1 }); // '1:1:22'
+ * formatSeconds(3682, { segments: 3, digits: 1 }); // '1:1:22'
  * ```
  */
 export declare function formatSeconds(secs: number, options?: FormatSecondsOptions): string;

package/dist/es/date.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyv/utils",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.4",
   "description": "Utility functions of Polyv frontend development.",
   "keywords": [
     "polyv",