@idlebox/common 1.3.15 → 1.3.17

package/src/reflection/methods/memorize.ts

@@ -0,0 +1,33 @@
+export const memorizeValueSymbol = Symbol('@gongt/memorizeValue');
+
+/**
+ * Decorate class method/getter
+ *
+ * remember first return value of method/getter, directlly return memorized value when call it again
+ */
+export const memo: MethodDecorator = <T>(
+	_target: Object,
+	propertyKey: string | symbol,
+	descriptor: TypedPropertyDescriptor<T>
+) => {
+	const original: Function = (descriptor.value ? descriptor.value : descriptor.get) as any;
+	if (descriptor.set || typeof original !== 'function') {
+		throw new TypeError('@memo should only use on method, or getter. Not property and setter.');
+	}
+
+	if (descriptor.get) {
+		descriptor.get = function memo_getter(this: any) {
+			const value = original.call(this, arguments);
+			Object.defineProperty(this, propertyKey, { value });
+			return value;
+		};
+	} else {
+		descriptor.value = function memo_method(this: any) {
+			const value = original.call(this, arguments);
+			Object.defineProperty(this, propertyKey, { value: () => value });
+			return value;
+		} as any;
+	}
+
+	return descriptor;
+};

package/src/string/castCase.ts

@@ -0,0 +1,44 @@
+/** @public */
+export function camelCase(str: string) {
+	return str.replace(/[-.\/_][a-z]/g, (s) => {
+		return s[1].toUpperCase();
+	});
+}
+
+/**
+ * Uppercase first char
+ * @public
+ */
+export function ucfirst<T extends string>(str: T): Capitalize<T> {
+	return <any>(str[0].toUpperCase() + str.slice(1));
+}
+
+/**
+ * lowercase first char
+ * @public
+ */
+export function lcfirst<T extends string>(str: T): Uncapitalize<T> {
+	return <any>(str[0].toLowerCase() + str.slice(1));
+}
+
+/** @public */
+export function linux_case(str: string) {
+	return str
+		.replace(/^[A-Z]/, (s) => {
+			return s.toLowerCase();
+		})
+		.replace(/[A-Z]/g, (s) => {
+			return '_' + s.toLowerCase();
+		});
+}
+
+/** @public */
+export function linux_case_hyphen(str: string) {
+	return str
+		.replace(/^[A-Z]/, (s) => {
+			return s.toLowerCase();
+		})
+		.replace(/[A-Z]/g, (s) => {
+			return '-' + s.toLowerCase();
+		});
+}

package/src/string/concatType.generated.ts

@@ -0,0 +1,265 @@
+/* eslint-disable */
+// @ts-ignore
+/**
+ * 
+ *  GENERATED FILE, DO NOT MODIFY
+ *  这是生成的文件，千万不要修改
+ * 
+ */
+
+
+export function concatStringType<T0 extends string>(
+	t0: T0
+): `${T0}`;
+export function concatStringType<T0 extends string, T1 extends string>(
+	t0: T0,
+	t1: T1
+): `${T0}${T1}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2
+): `${T0}${T1}${T2}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3
+): `${T0}${T1}${T2}${T3}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4
+): `${T0}${T1}${T2}${T3}${T4}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5
+): `${T0}${T1}${T2}${T3}${T4}${T5}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string, T15 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14,
+	t15: T15
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}${T15}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string, T15 extends string, T16 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14,
+	t15: T15,
+	t16: T16
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}${T15}${T16}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string, T15 extends string, T16 extends string, T17 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14,
+	t15: T15,
+	t16: T16,
+	t17: T17
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}${T15}${T16}${T17}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string, T15 extends string, T16 extends string, T17 extends string, T18 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14,
+	t15: T15,
+	t16: T16,
+	t17: T17,
+	t18: T18
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}${T15}${T16}${T17}${T18}`;
+export function concatStringType<T0 extends string, T1 extends string, T2 extends string, T3 extends string, T4 extends string, T5 extends string, T6 extends string, T7 extends string, T8 extends string, T9 extends string, T10 extends string, T11 extends string, T12 extends string, T13 extends string, T14 extends string, T15 extends string, T16 extends string, T17 extends string, T18 extends string, T19 extends string>(
+	t0: T0,
+	t1: T1,
+	t2: T2,
+	t3: T3,
+	t4: T4,
+	t5: T5,
+	t6: T6,
+	t7: T7,
+	t8: T8,
+	t9: T9,
+	t10: T10,
+	t11: T11,
+	t12: T12,
+	t13: T13,
+	t14: T14,
+	t15: T15,
+	t16: T16,
+	t17: T17,
+	t18: T18,
+	t19: T19
+): `${T0}${T1}${T2}${T3}${T4}${T5}${T6}${T7}${T8}${T9}${T10}${T11}${T12}${T13}${T14}${T15}${T16}${T17}${T18}${T19}`;
+
+/* copy */
+export function concatStringType(a: string[]): string {
+	return a.join('');
+}

package/src/string/concatType.generator.ts

@@ -0,0 +1,31 @@
+import { readFileSync } from 'fs';
+
+/* copy */
+export function concatStringType(a: string[]): string {
+	return a.join('');
+}
+/* copy end */
+
+export function generate() {
+	let content = '';
+	const typeList = [];
+	const argList = [];
+	const returnList = [];
+	for (let i = 0; i < 20; i++) {
+		typeList.push(`T${i} extends string`);
+		argList.push(`t${i}: T${i}`);
+		returnList.push(`\${T${i}}`);
+
+		const type = typeList.join(', ');
+		const arg = argList.join(',\n\t');
+		const ret = returnList.join('');
+		content += `export function concatStringType<${type}>(\n\t${arg}\n): \`${ret}\`;\n`;
+	}
+
+	const full: string = readFileSync(__filename, 'utf-8');
+	const lines = full.split('\n');
+	content += '\n';
+	content += lines.slice(lines.indexOf('/* copy */'), lines.indexOf('/* copy end */')).join('\n');
+
+	return content;
+}

package/src/string/escapeRegexp.ts

@@ -0,0 +1,4 @@
+/** @public */
+export function escapeRegExp(str: string) {
+	return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, '\\$&');
+}

package/src/string/pad2.ts

@@ -0,0 +1,11 @@
+/**
+ * Pad number to two digits string, used in time format
+ * @public
+ */
+export function pad2(s: number) {
+	if (s < 10) {
+		return '0' + s;
+	} else {
+		return '' + s;
+	}
+}

package/src/string/sizeString.ts

@@ -0,0 +1,52 @@
+/**
+ * Convert bytes to largest unit, with SI prefix unit (1000), eg: 211.293GB
+ * @public
+ */
+export function humanSizeSI(bytes: number, fixed = 2) {
+	if (bytes < 0) {
+		return '<0B';
+	} else if (bytes < 1000) {
+		return bytes + 'B';
+	} else if (bytes < 1000000) {
+		return (bytes / 1000).toFixed(fixed) + 'KiB';
+	} else if (bytes < 1000000000) {
+		return (bytes / 1000000).toFixed(fixed) + 'MiB';
+	} else if (bytes < 1000000000000) {
+		return (bytes / 1000000000).toFixed(fixed) + 'GiB';
+	} else if (bytes < 1000000000000000) {
+		return (bytes / 1000000000000).toFixed(fixed) + 'TiB';
+	} else {
+		return (bytes / 1000000000000000).toFixed(fixed) + 'PiB';
+	}
+}
+
+/**
+ * Convert bytes to largest unit, with binary prefix unit (1024), eg: 211.293GiB
+ * @public
+ */
+export function humanSize(bytes: number, fixed = 2) {
+	if (bytes < 0) {
+		return '<0B';
+	} else if (bytes < 1024) {
+		return bytes + 'B';
+	} else if (bytes < 1048576) {
+		// 1024 * 1024
+		return (bytes / 1024).toFixed(fixed) + 'KiB';
+	} else if (bytes < 1073741824) {
+		// 1024 * 1024 * 1024
+		return (bytes / 1048576).toFixed(fixed) + 'MiB';
+	} else if (bytes < 1099511627776) {
+		// 1024 * 1024 * 1024 * 1024
+		return (bytes / 1073741824).toFixed(fixed) + 'GiB';
+	} else if (bytes < 1125899906842624) {
+		// 1024 * 1024 * 1024 * 1024 * 1024
+		return (bytes / 1099511627776).toFixed(fixed) + 'TiB';
+	} else {
+		return (bytes / 1125899906842624).toFixed(fixed) + 'PiB';
+	}
+}
+
+/** @deprecated */
+export function humanSpeed(bps: number) {
+	return humanSize(bps) + '/s';
+}

package/src/tsconfig.json

@@ -0,0 +1,14 @@
+{
+	"extends": "local-rig/profiles/default/tsconfig.json",
+	"compilerOptions": {
+		"typeRoots": ["./node_modules/@types", "./node_modules"],
+		"tsBuildInfoFile": "../temp/tsbuildinfo.json",
+		"outDir": "../lib",
+		"declarationDir": "../temp/dts",
+		"rootDir": "./",
+
+		"types": ["@idlebox/itypes"]
+	},
+	"include": ["**/*.ts"],
+	"exclude": ["**/*.generator.ts"]
+}

package/src/typingHelper/deep.partial.ts

@@ -0,0 +1,16 @@
+import { Primitive } from './literal';
+
+export type DeepPartial<T> = T extends Primitive
+	? T
+	: T extends ReadonlyArray<infer U>
+	? DeepPartialArray<U>
+	: T extends ReadonlyMap<infer K, infer V>
+	? DeepPartialMap<K, V>
+	: T extends ReadonlySet<infer M>
+	? DeepPartialSet<M>
+	: DeepPartialObject<T>;
+
+type DeepPartialArray<T> = Array<DeepPartial<T>>;
+type DeepPartialMap<K, V> = Map<DeepPartial<K>, DeepPartial<V>>;
+type DeepPartialSet<T> = Set<DeepPartial<T>>;
+type DeepPartialObject<T> = { [K in keyof T]?: DeepPartial<T[K]> };

package/src/typingHelper/deep.readonly.ts

@@ -0,0 +1,16 @@
+import { Primitive } from './literal';
+
+export type DeepReadonly<T> = T extends Primitive
+	? T
+	: T extends Array<infer U>
+	? DeepReadonlyArray<U>
+	: T extends Map<infer K, infer V>
+	? DeepReadonlyMap<K, V>
+	: T extends Set<infer M>
+	? DeepReadonlySet<M>
+	: DeepReadonlyObject<T>;
+
+type DeepReadonlyArray<T> = ReadonlyArray<DeepReadonly<T>>;
+type DeepReadonlyMap<K, V> = ReadonlyMap<DeepReadonly<K>, DeepReadonly<V>>;
+type DeepReadonlySet<T> = ReadonlySet<DeepReadonly<T>>;
+type DeepReadonlyObject<T> = { readonly [K in keyof T]: DeepReadonly<T[K]> };

package/src/typingHelper/deep.required.ts

@@ -0,0 +1,16 @@
+import { Primitive } from './literal';
+
+export type DeepNonNullable<T> = T extends Primitive
+	? T
+	: T extends ReadonlyArray<infer U> | Array<infer U>
+	? DeepNonNullableArray<U>
+	: T extends ReadonlyMap<infer K, infer V> | Map<infer K, infer V>
+	? DeepNonNullableMap<K, V>
+	: T extends ReadonlySet<infer M>
+	? DeepNonNullableSet<M>
+	: DeepNonNullableObject<T>;
+
+type DeepNonNullableArray<T> = Array<DeepNonNullable<T>>;
+type DeepNonNullableMap<K, V> = Map<DeepNonNullable<K>, DeepNonNullable<V>>;
+type DeepNonNullableSet<T> = Set<DeepNonNullable<T>>;
+type DeepNonNullableObject<T> = { [K in keyof T]-?: NonNullable<T[K]> };

package/src/typingHelper/deep.writable.ts

@@ -0,0 +1,16 @@
+import { Primitive } from './literal';
+
+export type DeepWriteable<T> = T extends Primitive
+	? T
+	: T extends ReadonlyArray<infer U>
+	? DeepWriteableArray<U>
+	: T extends ReadonlyMap<infer K, infer V>
+	? DeepWriteableMap<K, V>
+	: T extends ReadonlySet<infer M>
+	? DeepWriteableSet<M>
+	: DeepWriteableObject<T>;
+
+type DeepWriteableArray<T> = Array<DeepWriteable<T>>;
+type DeepWriteableMap<K, V> = Map<DeepWriteable<K>, DeepWriteable<V>>;
+type DeepWriteableSet<T> = Set<DeepWriteable<T>>;
+type DeepWriteableObject<T> = { -readonly [K in keyof T]: DeepWriteable<T[K]> };

package/src/typingHelper/literal.ts

@@ -0,0 +1 @@
+export type Primitive = undefined | null | boolean | string | number | Function | bigint;