@idlebox/common 1.3.14 → 1.3.16

package/lib/function/callbackList.js.map

@@ -1 +1 @@
-{"version":3,"file":"callbackList.js","sourceRoot":"","sources":["../../src/function/callbackList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,0BAAuB;AAQ9C;;GAEG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAA2B,EAAE,CAAC;IAClC,OAAO,GAAY,KAAK,CAAC;IACzB,IAAI,GAAY,KAAK,CAAC;IAEhC;QACC,IAAI,CAAC,GAAG,GAAI,IAAI,CAAC,GAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;SACpD;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAA0B,EAAE,IAAa;QAC5C,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;SAC3D;QACD,IAAI,IAAI,EAAE;YACT,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACzB;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAA0B;QAChC,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC9D;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;YACjB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAG,QAAkB;QACxB,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC9D;QACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAElB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;YAC3B,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM;YACrB,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;SAChB;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,OAAO;QACN,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD"}
+{"version":3,"file":"callbackList.js","sourceRoot":"","sources":["../../src/function/callbackList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,0BAAuB;AAQ9C;;GAEG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAA2B,EAAE,CAAC;IAClC,OAAO,GAAY,KAAK,CAAC;IACzB,IAAI,GAAY,KAAK,CAAC;IAEhC;QACC,IAAI,CAAC,GAAG,GAAI,IAAI,CAAC,GAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;SACpD;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAA0B,EAAE,IAAa;QAC5C,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;SAC3D;QACD,IAAI,IAAI,EAAE;YACT,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACzB;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAA0B;QAChC,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC9D;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;YACjB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACrC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAG,QAAkB;QACxB,IAAI,IAAI,CAAC,OAAO,EAAE;YACjB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;SAC9D;QACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAElB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE;YAC3B,IAAI,IAAI,CAAC,IAAI;gBAAE,MAAM;YACrB,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC;SAChB;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAClB,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,OAAO;QACN,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD"}

package/lib/string/concatType.generated.cjs

@@ -1,4 +1,12 @@
 "use strict";
+/* eslint-disable */
+// @ts-ignore
+/**
+ *
+ *  GENERATED FILE, DO NOT MODIFY
+ *  这是生成的文件，千万不要修改
+ *
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.concatStringType = void 0;
 /* copy */

package/lib/string/concatType.generated.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"concatType.generated.js","sourceRoot":"","sources":["../../src/string/concatType.generated.ts"],"names":[],"mappings":";;;AA2PA,UAAU;AACV,SAAgB,gBAAgB,CAAC,CAAW;IAC3C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC;AAFD,4CAEC"}
+{"version":3,"file":"concatType.generated.js","sourceRoot":"","sources":["../../src/string/concatType.generated.ts"],"names":[],"mappings":";AAAA,oBAAoB;AACpB,aAAa;AACb;;;;;GAKG;;;AA8PH,UAAU;AACV,SAAgB,gBAAgB,CAAC,CAAW;IAC3C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC;AAFD,4CAEC"}

package/lib/string/concatType.generated.js

@@ -1,3 +1,11 @@
+/* eslint-disable */
+// @ts-ignore
+/**
+ *
+ *  GENERATED FILE, DO NOT MODIFY
+ *  这是生成的文件，千万不要修改
+ *
+ */
 /* copy */
 export function concatStringType(a) {
     return a.join('');

package/lib/string/concatType.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"concatType.generated.js","sourceRoot":"","sources":["../../src/string/concatType.generated.ts"],"names":[],"mappings":"AA2PA,UAAU;AACV,MAAM,UAAU,gBAAgB,CAAC,CAAW;IAC3C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC"}
+{"version":3,"file":"concatType.generated.js","sourceRoot":"","sources":["../../src/string/concatType.generated.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,aAAa;AACb;;;;;GAKG;AA8PH,UAAU;AACV,MAAM,UAAU,gBAAgB,CAAC,CAAW;IAC3C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnB,CAAC"}

package/{dist → lib}/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.29.2"
+      "packageVersion": "7.33.6"
     }
   ]
 }

package/lib/{typingHeler/deep.cjs → typingHelper/deep.partial.cjs}

@@ -1,4 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-// TODO: deep required
-//# sourceMappingURL=deep.js.map
+//# sourceMappingURL=deep.partial.js.map

package/lib/typingHelper/deep.partial.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.partial.js","sourceRoot":"","sources":["../../src/typingHelper/deep.partial.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.partial.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deep.partial.js.map

package/lib/typingHelper/deep.partial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.partial.js","sourceRoot":"","sources":["../../src/typingHelper/deep.partial.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.readonly.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deep.readonly.js.map

package/lib/typingHelper/deep.readonly.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.readonly.js","sourceRoot":"","sources":["../../src/typingHelper/deep.readonly.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.readonly.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deep.readonly.js.map

package/lib/typingHelper/deep.readonly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.readonly.js","sourceRoot":"","sources":["../../src/typingHelper/deep.readonly.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.required.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deep.required.js.map

package/lib/typingHelper/deep.required.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.required.js","sourceRoot":"","sources":["../../src/typingHelper/deep.required.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.required.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deep.required.js.map

package/lib/typingHelper/deep.required.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.required.js","sourceRoot":"","sources":["../../src/typingHelper/deep.required.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.writable.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=deep.writable.js.map

package/lib/typingHelper/deep.writable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.writable.js","sourceRoot":"","sources":["../../src/typingHelper/deep.writable.ts"],"names":[],"mappings":""}

package/lib/typingHelper/deep.writable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deep.writable.js.map

package/lib/typingHelper/deep.writable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep.writable.js","sourceRoot":"","sources":["../../src/typingHelper/deep.writable.ts"],"names":[],"mappings":""}

package/lib/typingHelper/literal.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=literal.js.map

package/lib/typingHelper/literal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"literal.js","sourceRoot":"","sources":["../../src/typingHelper/literal.ts"],"names":[],"mappings":""}

package/lib/typingHelper/literal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=literal.js.map

package/lib/typingHelper/literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"literal.js","sourceRoot":"","sources":["../../src/typingHelper/literal.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@idlebox/common",
   "type": "module",
-  "version": "1.3.14",
+  "version": "1.3.16",
   "license": "MIT",
   "main": "./lib/index.generated.cjs",
   "module": "./lib/index.generated.js",
@@ -12,21 +12,20 @@
     },
     "./package.json": "./package.json"
   },
-  "types": "./dist/common-public.d.ts",
+  "types": "./lib/common-public.d.ts",
   "repository": "https://github.com/GongT/baobao",
   "dependencies": {
-    "tslib": "^2.4.0"
+    "tslib": "^2.4.1"
   },
   "devDependencies": {
-    "@build-script/codegen": "^0.0.3",
-    "@build-script/heft-duel-stack": "^1.0.4",
-    "@build-script/single-dog-asset": "^1.0.22",
-    "@build-script/typescript-transformer-dual-package": "^2.0.2",
-    "@idlebox/itypes": "^1.0.3",
-    "@rushstack/heft": "^0.47.2",
-    "local-rig": "^1.0.0",
+    "@rushstack/heft": "^0.48.8",
     "source-map-support": "^0.5.21",
-    "typescript": "^4.7.4"
+    "typescript": "^4.8.4",
+    "@build-script/heft-duel-stack": "1.0.7",
+    "@build-script/single-dog-asset": "1.0.23",
+    "@build-script/codegen": "0.0.6",
+    "local-rig": "1.0.1",
+    "@idlebox/itypes": "1.0.4"
   },
   "monorepo": "rush",
   "jspm": {
@@ -36,7 +35,8 @@
   "scripts": {
     "test": "heft test",
     "lint": "heft build",
-    "build": "heft test",
+    "build": "heft build --production",
+    "build:watch": "heft build --lite",
     "watch": "heft build --watch",
     "clean": "heft clean"
   }

package/src/array/arrayDiff.ts

@@ -0,0 +1,31 @@
+/**
+ * @public
+ */
+export interface IArrayUpdate<T> {
+	add: T[];
+	del: T[];
+	same: T[];
+}
+
+/**
+ * Compare two array, returns the difference from `before` to `after`
+ * @public
+ */
+export function arrayDiff<T>(_before: readonly T[], after: readonly T[]) {
+	const before = _before.slice().sort();
+	const add: T[] = after.slice().sort();
+	const del: T[] = [];
+	const same: T[] = [];
+	next: while (before.length) {
+		const item = before.pop()!;
+		for (let j = add.length - 1; j >= 0; j--) {
+			if (item === add[j]) {
+				same.push(item);
+				add.splice(j, 1);
+				continue next;
+			}
+		}
+		del.push(item);
+	}
+	return { add, del, same };
+}

package/src/array/arraySame.ts

@@ -0,0 +1,15 @@
+/**
+ * is the two array EXACTLY same
+ * @public
+ */
+export function isArraySame<T>(a1: readonly T[], a2: readonly T[]): boolean {
+	if (a1.length !== a2.length) {
+		return false;
+	}
+	for (let i = a1.length - 1; i >= 0; i--) {
+		if (a1[i] !== a2[i]) {
+			return false;
+		}
+	}
+	return true;
+}

package/src/array/arrayUnique.ts

@@ -0,0 +1,50 @@
+/**
+ * Returns a new array without duplicate values
+ * @public
+ */
+export function arrayUnique<T>(arr: readonly T[]): T[] {
+	return arr.filter((item, index) => {
+		return arr.lastIndexOf(item) === index;
+	});
+}
+
+/**
+ * Removes duplicate values from an array
+ * @public
+ */
+export function arrayUniqueReference(arr: any[]): void {
+	for (let index = arr.length - 1; index >= 0; index--) {
+		if (arr.lastIndexOf(arr[index]) !== index) {
+			arr.splice(index, 1);
+		}
+	}
+}
+
+export interface IUniqueIdFactory<T> {
+	(item: T): string;
+}
+
+function defaultFactory(t: any) {
+	return t as string;
+}
+
+/**
+ * Returns a function to be used in <arr>.filter()
+ *
+ * the returned function can use multiple times, it will remember all values inter multiple arrays
+ *
+ * @param {IUniqueIdFactory} idFactory function takes an array element, return it's id to be compare with each other
+ * @public
+ */
+export function uniqueFilter<T>(idFactory: IUniqueIdFactory<T> = defaultFactory) {
+	const seen: { [id: string]: true } = {};
+	return function uniqueFilterInner(item: T): boolean {
+		const id = idFactory(item);
+		if (seen[id]) {
+			return false;
+		} else {
+			seen[id] = true;
+			return true;
+		}
+	};
+}

package/src/array/normalizeArray.ts

@@ -0,0 +1,13 @@
+/**
+ * ensure a value is an array
+ * @public
+ */
+export function normalizeArray<T>(input: T | T[]): T[] {
+	if (input && Array.isArray(input)) {
+		return input;
+	} else if (typeof input !== undefined) {
+		return [input];
+	} else {
+		return [];
+	}
+}

package/src/array/sortAlpha.ts

@@ -0,0 +1,15 @@
+/**
+ * Sort string array alphabet order
+ *
+ * to be used in <arr>.sort()
+ * @public
+ */
+export function sortByString(a: string, b: string): number {
+	if (a === b) {
+		return 0;
+	} else if (a > b) {
+		return 1;
+	} else {
+		return -1;
+	}
+}

package/src/date/consts.ts

@@ -0,0 +1,5 @@
+export const oneSecond = 1000;
+export const oneMinute = 60000;
+export const oneHour = 1440000;
+export const oneDay = 86400000;
+export const oneWeek = 604800000;

package/src/date/isInvalid.ts

@@ -0,0 +1,6 @@
+/**
+ * Check if a date is NaN
+ */
+export function isDateInvalid(date: Date) {
+	return isNaN(date.getTime());
+}

package/src/date/sibling.ts

@@ -0,0 +1,28 @@
+export function nextSecond(d: Date, n = 1) {
+	d.setSeconds(d.getSeconds() + n);
+	return d;
+}
+export function nextMinute(d: Date, n = 1) {
+	d.setMinutes(d.getMinutes() + n);
+	return d;
+}
+export function nextHour(d: Date, n = 1) {
+	d.setHours(d.getHours() + n);
+	return d;
+}
+export function nextDay(d: Date, n = 1) {
+	d.setDate(d.getDate() + n);
+	return d;
+}
+export function nextWeek(d: Date, n = 1) {
+	d.setDate(d.getDate() + n * 7);
+	return d;
+}
+export function nextMonth(d: Date, n = 1) {
+	d.setMonth(d.getMonth() + n);
+	return d;
+}
+export function nextYear(d: Date, n = 1) {
+	d.setFullYear(d.getFullYear() + n);
+	return d;
+}

package/src/date/timeString.ts

@@ -0,0 +1,150 @@
+import { pad2 } from '../string/pad2';
+
+export namespace humanDate {
+	/**
+	 * Format: HH:mm:ss
+	 */
+	export function time(date: Date | string | number) {
+		if (typeof date === 'string') {
+			date = parseInt(date);
+		}
+		date = new Date(date as number);
+		return `${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`;
+	}
+
+	/**
+	 * Format: YYYY-MM-dd
+	 *
+	 * separator can change
+	 */
+	export function date(date: Date | string | number, sp = '-') {
+		if (typeof date === 'string') {
+			date = parseInt(date);
+		}
+		date = new Date(date as number);
+		return `${date.getFullYear()}${sp}${pad2(date.getMonth() + 1)}${sp}${pad2(date.getDate())}`;
+	}
+
+	/**
+	 * Format: YYYY-MM-dd HH:mm:ss
+	 */
+	export function datetime(date: Date | string | number) {
+		if (typeof date === 'string') {
+			date = parseInt(date);
+		}
+		date = new Date(date as number);
+		return (
+			`${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}` +
+			' ' +
+			`${pad2(date.getHours())}:${pad2(date.getMinutes())}:${pad2(date.getSeconds())}`
+		);
+	}
+
+	export interface ITimeFormatter {
+		(s: number): string;
+	}
+
+	export interface IFormatters {
+		s: ITimeFormatter;
+		m: ITimeFormatter;
+		h: ITimeFormatter;
+		d: ITimeFormatter;
+	}
+
+	const formatters: IFormatters = {
+		s(v: number) {
+			return v + 's';
+		},
+		m(v: number) {
+			return v + 'm';
+		},
+		h(v: number) {
+			return v + 'h';
+		},
+		d(v: number) {
+			return v + 'd';
+		},
+	};
+
+	/**
+	 * set format for time delta
+	 */
+	export function setLocaleFormatter(formatter: Partial<IFormatters>) {
+		Object.assign(formatters, formatter);
+	}
+
+	/**
+	 * format time delta (in ms) to string, like: '1d'
+	 * when ms<=0, returns '0s'
+	 *
+	 * format can set by `setLocaleFormatter`
+	 * day is the largest unit
+	 */
+	export function deltaTiny(ms: number) {
+		if (ms <= 0) {
+			return '0s';
+		}
+		if (ms > 86400000) {
+			return formatters.d(Math.floor(ms / 86400000));
+		}
+		if (ms > 3600000) {
+			return formatters.h(Math.floor(ms / 3600000));
+		}
+		if (ms > 60000) {
+			return formatters.m(Math.floor(ms / 60000));
+		}
+		return formatters.s(Math.floor(ms / 1000));
+	}
+
+	/**
+	 * format time delta (in ms) to string, like: '1d10m42s'
+	 * when ms<=0, returns '0s'
+	 *
+	 * format can set by `setLocaleFormatter`
+	 * day is the largest unit
+	 */
+	export function delta(ms: number) {
+		let ret = '';
+		let val = Math.ceil(ms / 1000);
+
+		if (val <= 0) {
+			return '0s';
+		}
+
+		// sec
+		const s = val % 60;
+		val = Math.floor(val / 60);
+		if (s > 0) {
+			ret = formatters.s(s);
+		}
+		if (val === 0) {
+			return ret;
+		}
+
+		// min
+		const m = val % 60;
+		val = Math.floor(val / 60);
+		if (m > 0) {
+			ret = formatters.m(m) + ret;
+		}
+		if (val === 0) {
+			return ret;
+		}
+
+		// hour
+		const h = val % 24;
+		val = Math.floor(val / 24);
+		if (h > 0) {
+			ret = formatters.h(h) + ret;
+		}
+		if (val === 0) {
+			return ret;
+		}
+
+		// day
+		if (val > 0) {
+			ret = formatters.d(h) + ret;
+		}
+		return ret;
+	}
+}

package/src/date/unix.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns ms
+ */
+export function getTimeStamp(date: Date) {
+	return Math.floor(date.getTime() / 1000);
+}
+
+/**
+ * Takes ms
+ */
+export function fromTimeStamp(timestamp: number) {
+	return new Date(1000 * timestamp);
+}

package/src/debugging/serializable.ts

@@ -0,0 +1,146 @@
+declare const window: any;
+declare const EventTarget: any;
+declare const Element: any;
+
+type ScalarTypes =
+	| bigint
+	| number
+	| Number
+	| boolean
+	| Boolean
+	| string
+	| String
+	| symbol
+	| undefined
+	| null
+	| Date
+	| RegExp
+	| Function;
+
+export function isScalar(value: any): value is ScalarTypes {
+	switch (typeof value) {
+		case 'bigint':
+		case 'number':
+		case 'boolean':
+		case 'string':
+		case 'symbol':
+		case 'undefined':
+		case 'function':
+			return true;
+		case 'object':
+			return (
+				value === null ||
+				value instanceof Date ||
+				value instanceof Boolean ||
+				value instanceof String ||
+				value instanceof Number ||
+				value instanceof RegExp
+			);
+		default:
+			return false;
+	}
+}
+
+export enum SerializableKind {
+	Invalid = 0,
+	Primitive,
+	Manual,
+	Other,
+}
+
+export function isSerializable(value: any): SerializableKind {
+	const t = typeof value;
+	switch (t) {
+		case 'bigint':
+		// @ts-expect-error
+		case 'number':
+			if (isNaN(value) || Infinity === value || -Infinity === value) {
+				return SerializableKind.Invalid;
+			}
+		case 'boolean':
+		case 'string':
+		case 'undefined':
+			return SerializableKind.Primitive;
+		case 'object':
+			if (!value) {
+				return SerializableKind.Invalid;
+			}
+			if ('toJSON' in value || Symbol.toPrimitive in value) {
+				return SerializableKind.Manual;
+			}
+			if (
+				value instanceof Map ||
+				value instanceof WeakMap ||
+				value instanceof Set ||
+				value instanceof WeakSet ||
+				value instanceof RegExp ||
+				value instanceof Promise ||
+				value === Math
+			) {
+				return SerializableKind.Invalid;
+			}
+			if (typeof window === 'object') {
+				if (value instanceof EventTarget) {
+					return SerializableKind.Invalid;
+				}
+			}
+			if ('then' in value && typeof value['then'] === 'function') {
+				return SerializableKind.Invalid;
+			}
+
+			return SerializableKind.Other;
+	}
+	return SerializableKind.Invalid;
+}
+
+export function getTypeOf(value: any) {
+	const t = typeof value;
+	switch (t) {
+		case 'bigint':
+		case 'number':
+		case 'boolean':
+		case 'string':
+		case 'symbol':
+		case 'undefined':
+		case 'function':
+			return t;
+	}
+	if (value === null) return 'null';
+	if (value instanceof Promise) return 'Promise';
+	if (value instanceof Error) return 'Error';
+
+	if (typeof window === 'object') {
+		if (value instanceof Element) return 'DOM';
+		if (value instanceof EventTarget) return 'EventTarget';
+	}
+
+	if (value instanceof String) return 'string';
+	if (value instanceof Number) return 'number';
+	if (value instanceof Boolean) return 'boolean';
+	if (value instanceof Date) return 'datetime';
+	if (value instanceof RegExp) return 'regexp';
+
+	return 'unknown';
+}
+
+export function assertSerializable(value: any) {
+	if (!value) return;
+
+	assertSerializableWalker(value, '$');
+}
+
+function assertSerializableWalker(data: any, path: string) {
+	const type = isSerializable(data);
+	if (type === SerializableKind.Invalid) {
+		console.error('在对象中发现不可序列化的数据: 路径为 %s, 可能的类型为: %s\n%j', path, getTypeOf(data), data);
+		throw new TypeError(`对象路径 ${path} 无法序列化`);
+	}
+
+	if (type === SerializableKind.Manual || type === SerializableKind.Primitive) {
+		return;
+	}
+
+	for (const [key, value] of Object.entries(data)) {
+		assertSerializableWalker(value, `${path}/${key}`);
+	}
+}