@ntnyq/utils 0.9.2 → 0.11.0

package/dist/index.d.ts

@@ -9,13 +9,26 @@ declare function noop(): void;
 declare const NOOP: typeof noop;
 //#endregion
 //#region src/fn/once.d.ts
+/**
+* Creates a function that is restricted to invoking `func` once. Repeat calls to the function return `false`.
+*
+* @param func - The function to restrict.
+* @returns A new function that returns `true` when `func` is invoked for the first time and `false` on subsequent calls.
+*
+* @example
+*
+* ```ts
+* const initialize = once(() => {
+*   console.log('Initialized')
+* })
+*
+* initialize() // Logs: 'Initialized', returns true
+* ```
+*/
 declare function once<T extends unknown[]>(func: (...args: T) => void): (this: unknown, ...args: T) => boolean;
 //#endregion
 //#region src/is/dom.d.ts
 /**
-* @file is/dom.ts
-*/
-/**
 * Check if given value is an HTMLElement
 * @param value - The value to check
 * @returns True if the value is an HTMLElement, false otherwise
@@ -104,7 +117,7 @@ type Nullable<T> = T | null;
 /**
 * Overwrite some keys type
 */
-type Overwrite<T, U> = Pick<T, Exclude<keyof T, keyof U>> & U;
+type Overwrite<T, U$1> = Pick<T, Exclude<keyof T, keyof U$1>> & U$1;
 /**
 * Prettify object type
 */
@@ -136,7 +149,7 @@ type LiteralUnion<Union extends Base, Base = string> = Union | (Base & {
 /**
 * @see {@link TODO:}
 */
-type Merge<T, U> = keyof T & keyof U extends never ? T & U : Omit<T, keyof T & keyof U> & U;
+type Merge<T, U$1> = keyof T & keyof U$1 extends never ? T & U$1 : Omit<T, keyof T & keyof U$1> & U$1;
 /**
 * Non empty object `{}`
 */
@@ -190,16 +203,13 @@ declare function isElementVisibleInViewport(element: HTMLElement, targetWindow?:
 //#endregion
 //#region src/env/isBrowser.d.ts
 /**
-* @file env.ts
-*/
-/**
 * Checks if the code is running in a browser
 *
-* @returns boolean - true if the code is running in a browser
+* @returns true if the code is running in a browser
 */
 declare function isBrowser(): boolean;
 //#endregion
-//#region src/file/removeExtension.d.ts
+//#region src/file/extension.d.ts
 /**
 * Removes the file extension from a filename.
 *
@@ -207,6 +217,12 @@ declare function isBrowser(): boolean;
 * @returns The filename without the extension.
 */
 declare function removeFileExtension(filename: string): string;
+/**
+* Gets the file extension from a filename.
+* @param filePath - The filePath to get the extension from.
+* @returns The file extension, or undefined if there is none.
+*/
+declare function getFileExtension(filePath?: string): string | undefined;
 //#endregion
 //#region src/html/escape.d.ts
 /**
@@ -434,6 +450,15 @@ declare function last<T>(array: readonly T[]): T | undefined;
 */
 declare function chunk<T>(array: T[], size: number): T[][];
 //#endregion
+//#region src/array/remove.d.ts
+/**
+* Remove given item from an array
+* @param array - given array
+* @param value - item to be removed
+* @returns true if item was removed, otherwise false
+*/
+declare function remove<T>(array: T[], value: T): boolean;
+//#endregion
 //#region src/array/unique.d.ts
 /**
 * Returns a new array with unique values.
@@ -449,6 +474,15 @@ declare function unique<T>(array: T[]): T[];
 */
 declare function uniqueBy<T>(array: T[], equalFn: (a: T, b: T) => boolean): T[];
 //#endregion
+//#region src/array/shuffle.d.ts
+/**
+* Fisher–Yates shuffle
+*
+* @param array - array to shuffle
+* @returns shuffled array
+*/
+declare function shuffle<T>(array: T[]): T[];
+//#endregion
 //#region src/array/toArray.d.ts
 /**
 * Converts a value to an array.
@@ -593,7 +627,7 @@ declare function interopDefault<T>(mod: Awaitable<T>): Promise<InteropModuleDefa
 * // => {}
 * ```
 */
-declare function resolveSubOptions<T extends Record<string, any>, K extends keyof T>(options: T, key: K): Partial<ResolvedOptions<T[K]>>;
+declare function resolveSubOptions<T extends Record<string, any>, K$1 extends keyof T>(options: T, key: K$1): Partial<ResolvedOptions<T[K$1]>>;
 //#endregion
 //#region src/number/random.d.ts
 interface RamdomNumberOptions {
@@ -655,10 +689,10 @@ interface ToIntegerOptions {
 declare function toInteger(value: unknown, options?: ToIntegerOptions): number;
 //#endregion
 //#region src/object/omit.d.ts
-declare function omit<T, K extends keyof T>(object: T, ...keys: K[]): Omit<T, K>;
+declare function omit<T, K$1 extends keyof T>(object: T, ...keys: K$1[]): Omit<T, K$1>;
 //#endregion
 //#region src/object/pick.d.ts
-declare function pick<T, K extends keyof T>(object: T, keys: K[]): Pick<T, K>;
+declare function pick<T, K$1 extends keyof T>(object: T, keys: K$1[]): Pick<T, K$1>;
 //#endregion
 //#region src/object/clean.d.ts
 interface CleanObjectOptions {
@@ -728,6 +762,17 @@ declare function cleanObject<T extends object>(obj: T, options?: CleanObjectOpti
 */
 declare function hasOwn<T>(object: T, key: PropertyKey): boolean;
 //#endregion
+//#region src/object/isKeyOf.d.ts
+/**
+* Type guard for any key, `k`
+* marks `k` as a key of `T` if `k` is a key of `T`
+*
+* @param obj - object to query for key
+* @param k - key to check for
+* @returns true if `k` is a key of `T`
+*/
+declare function isKeyOf<T extends object>(obj: T, k: keyof T): k is keyof T;
+//#endregion
 //#region src/object/sortObject.d.ts
 interface SortObjectOptions {
   /**
@@ -745,6 +790,15 @@ interface SortObjectOptions {
 */
 declare function sortObject<T extends Record<string, any>>(obj: T, options?: SortObjectOptions): T;
 //#endregion
+//#region src/object/isPlainObject.d.ts
+/**
+* Check if a value is a plain object (not an array, Date, RegExp, Map, Set, etc.)
+*
+* @param value - Checked value
+* @copyright {@link https://github.com/sindresorhus/is/blob/main/source/index.ts}
+*/
+declare function isPlainObject<Value = unknown>(value: unknown): value is Record<PropertyKey, Value>;
+//#endregion
 //#region src/string/pad.d.ts
 interface CreatePadStringOptions {
   length: number;
@@ -774,6 +828,12 @@ declare function join(array: JoinableValue[], options?: JoinOptions): string;
 */
 declare function slash(input: string): string;
 //#endregion
+//#region src/string/escape.d.ts
+/**
+* @copyright {@link https://github.com/sindresorhus/escape-string-regexp}
+*/
+declare function escapeStringRegexp(value: string): string;
+//#endregion
 //#region src/string/random.d.ts
 /**
 * randome a string useing given chars
@@ -845,7 +905,30 @@ declare function getStringSimilarity(str1: string, str2: string, options?: GetSt
 * Special chars
 */
 declare const SPECIAL_CHAR: {
+  /**
+  * 中文顿号
+  */
+  chineseComma: string;
+  /**
+  * 英文逗号
+  */
+  englishComma: string;
+  /**
+  * 英文句号
+  */
+  englishPeriod: string;
+  /**
+  * 连接符
+  */
+  hyphen: string;
+  /**
+  * 换行
+  */
   newline: string;
+  /**
+  * 空格
+  */
+  whitespace: string;
 };
 //#endregion
 //#region src/constants/regexp.d.ts
@@ -864,4 +947,4 @@ declare const RE_LINE_COMMENT: RegExp;
 */
 declare const RE_BLOCK_COMMENT: RegExp;
 //#endregion
-export { AnyFn, Arrayable, Awaitable, Callable, CleanObjectOptions, Color, CreatePadStringOptions, DeepRequired, ElementOf, GetStringSimilarityOptions, InteropModuleDefault, JsonArray, JsonObject, JsonPrimitive, JsonValue, LiteralUnion, MayBe, Merge, NOOP, NonEmptyObject, NonEmptyString, Nullable, OpenExternalURLOptions, Overwrite, Prettify, PrettifyV2, Primitive, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, RamdomNumberOptions, ResolvedOptions, SPECIAL_CHAR, STORAGE_UNITS, SortObjectOptions, StorageUnit, TIME_UNITS, ThrottleDebounceOptions, TimeUnit, ToIntegerOptions, UrlString, ValueOf, Whitespace, at, cAF, chunk, clamp, cleanObject, convertFromBytes, convertFromMilliseconds, convertStorageUnit, convertTimeUnit, convertToBytes, convertToMilliseconds, createPadString, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBlob, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFile, isFormData, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isUrlString, isWhitespaceString, isZero, join, last, mergeArrayable, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, removeFileExtension, resolveSubOptions, scrollElementIntoView, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce };
+export { AnyFn, Arrayable, Awaitable, Callable, CleanObjectOptions, Color, CreatePadStringOptions, DeepRequired, ElementOf, GetStringSimilarityOptions, InteropModuleDefault, JsonArray, JsonObject, JsonPrimitive, JsonValue, LiteralUnion, MayBe, Merge, NOOP, NonEmptyObject, NonEmptyString, Nullable, OpenExternalURLOptions, Overwrite, Prettify, PrettifyV2, Primitive, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, RamdomNumberOptions, ResolvedOptions, SPECIAL_CHAR, STORAGE_UNITS, SortObjectOptions, StorageUnit, TIME_UNITS, ThrottleDebounceOptions, TimeUnit, ToIntegerOptions, UrlString, ValueOf, Whitespace, at, cAF, chunk, clamp, cleanObject, convertFromBytes, convertFromMilliseconds, convertStorageUnit, convertTimeUnit, convertToBytes, convertToMilliseconds, createPadString, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, escapeStringRegexp, flattenArrayable, getFileExtension, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBlob, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFile, isFormData, isFunction, isHTMLElement, isInteger, isIterable, isKeyOf, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isUrlString, isWhitespaceString, isZero, join, last, mergeArrayable, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, remove, removeFileExtension, resolveSubOptions, scrollElementIntoView, shuffle, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce };

package/dist/index.js

@@ -10,6 +10,22 @@ const NOOP = noop;
 
 //#endregion
 //#region src/fn/once.ts
+/**
+* Creates a function that is restricted to invoking `func` once. Repeat calls to the function return `false`.
+*
+* @param func - The function to restrict.
+* @returns A new function that returns `true` when `func` is invoked for the first time and `false` on subsequent calls.
+*
+* @example
+*
+* ```ts
+* const initialize = once(() => {
+*   console.log('Initialized')
+* })
+*
+* initialize() // Logs: 'Initialized', returns true
+* ```
+*/
 function once(func) {
 	let called = false;
 	return function(...args) {
@@ -20,6 +36,17 @@ function once(func) {
 	};
 }
 
+//#endregion
+//#region src/env/isBrowser.ts
+/**
+* Checks if the code is running in a browser
+*
+* @returns true if the code is running in a browser
+*/
+function isBrowser() {
+	return typeof document !== "undefined" && typeof window !== "undefined" && typeof navigator !== "undefined" && window === self;
+}
+
 //#endregion
 //#region src/is/dom.ts
 /**
@@ -31,6 +58,7 @@ function once(func) {
 * @returns True if the value is an HTMLElement, false otherwise
 */
 function isHTMLElement(value) {
+	if (!isBrowser()) return false;
 	return typeof value === "object" && value !== null && "nodeType" in value && value.nodeType === Node.ELEMENT_NODE && value instanceof HTMLElement;
 }
 
@@ -164,9 +192,7 @@ function isUrlString(value) {
 * check if two values are deeply equal
 */
 function isDeepEqual(value1, value2) {
-	const type1 = getObjectType(value1);
-	const type2 = getObjectType(value2);
-	if (type1 !== type2) return false;
+	if (getObjectType(value1) !== getObjectType(value2)) return false;
 	if (isArray(value1) && isArray(value2)) {
 		if (value1.length !== value2.length) return false;
 		return value1.every((item, index) => isDeepEqual(item, value2[index]));
@@ -189,7 +215,7 @@ function isDeepEqual(value1, value2) {
 */
 function scrollElementIntoView(element, options = {}) {
 	const body = document.body;
-	const { parent = body,...scrollIntoViewOptions } = options;
+	const { parent = body, ...scrollIntoViewOptions } = options;
 	if (parent === body) {
 		parent.scrollIntoView(scrollIntoViewOptions);
 		return;
@@ -227,21 +253,7 @@ function isElementVisibleInViewport(element, targetWindow = window) {
 }
 
 //#endregion
-//#region src/env/isBrowser.ts
-/**
-* @file env.ts
-*/
-/**
-* Checks if the code is running in a browser
-*
-* @returns boolean - true if the code is running in a browser
-*/
-function isBrowser() {
-	return typeof document !== "undefined";
-}
-
-//#endregion
-//#region src/file/removeExtension.ts
+//#region src/file/extension.ts
 /**
 * Removes the file extension from a filename.
 *
@@ -251,6 +263,15 @@ function isBrowser() {
 function removeFileExtension(filename) {
 	return filename.replace(/\.[^/.]+$/, "");
 }
+/**
+* Gets the file extension from a filename.
+* @param filePath - The filePath to get the extension from.
+* @returns The file extension, or undefined if there is none.
+*/
+function getFileExtension(filePath) {
+	if (!filePath) return;
+	return filePath.match(/\.([^.]+)$/)?.[1];
+}
 
 //#endregion
 //#region src/html/escape.ts
@@ -291,6 +312,9 @@ function unescapeHTML(str) {
 //#endregion
 //#region src/misc/raf.ts
 /**
+* @file raf.ts
+*/
+/**
 * Gets the global root object.
 * @returns the global root object
 */
@@ -480,8 +504,7 @@ function convertFromMilliseconds(milliseconds, toUnit = "SECOND") {
 * ```
 */
 function convertTimeUnit(value, fromUnit, toUnit) {
-	const milliseconds = convertToMilliseconds(value, fromUnit);
-	return convertFromMilliseconds(milliseconds, toUnit);
+	return convertFromMilliseconds(convertToMilliseconds(value, fromUnit), toUnit);
 }
 
 //#endregion
@@ -544,8 +567,7 @@ function convertFromBytes(bytes, toUnit = "MB") {
 * ```
 */
 function convertStorageUnit(value, fromUnit, toUnit) {
-	const bytes = convertToBytes(value, fromUnit);
-	return convertFromBytes(bytes, toUnit);
+	return convertFromBytes(convertToBytes(value, fromUnit), toUnit);
 }
 
 //#endregion
@@ -585,6 +607,24 @@ function chunk(array, size) {
 	return result;
 }
 
+//#endregion
+//#region src/array/remove.ts
+/**
+* Remove given item from an array
+* @param array - given array
+* @param value - item to be removed
+* @returns true if item was removed, otherwise false
+*/
+function remove(array, value) {
+	if (!array) return false;
+	const index = array.indexOf(value);
+	if (index !== -1) {
+		array.splice(index, 1);
+		return true;
+	}
+	return false;
+}
+
 //#endregion
 //#region src/array/unique.ts
 /**
@@ -608,6 +648,89 @@ function uniqueBy(array, equalFn) {
 	}, []);
 }
 
+//#endregion
+//#region src/number/random.ts
+/**
+* random an integer by given range
+*
+* @param min - min value
+* @param max - max value
+* @returns random integer in range
+*/
+function randomNumber(min, max = 0, options = {}) {
+	if (max === 0) {
+		max = min;
+		min = 0;
+	}
+	if (min > max) [min, max] = [max, min];
+	return Math.trunc(Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min);
+}
+
+//#endregion
+//#region src/number/toInteger.ts
+/**
+* Transforms a value to an integer.
+* @param value - The value to convert to an integer.
+* @param options - Options for the conversion.
+* @returns The converted integer.
+*/
+function toInteger(value, options = {}) {
+	const { defaultValue = 0, allowDecimal = false, allowNaN = false, onError = "useDefault", min, max, outOfRange = "clamp" } = options;
+	let numberValue;
+	let result;
+	if (isNumber(value)) numberValue = value;
+	else if (isString(value)) {
+		const trimmed = value.trim();
+		if (isEmptyString(trimmed)) {
+			if (onError === "throwError") throw new TypeError("Cannot convert empty string to an integer");
+			return onError === "returnOriginal" ? value : defaultValue;
+		}
+		numberValue = Number(trimmed);
+	} else if (isNullOrUndefined(value)) {
+		if (onError === "throwError") throw new TypeError(`Cannot convert ${value} to an integer`);
+		return onError === "useDefault" ? value : defaultValue;
+	} else numberValue = Number(value);
+	if (isNaN(numberValue)) {
+		if (allowNaN) return numberValue;
+		if (onError === "throwError") throw new TypeError(`Cannot convert NaN to an integer`);
+		return onError === "returnOriginal" ? value : defaultValue;
+	}
+	if (allowDecimal) result = numberValue > 0 ? Math.floor(numberValue) : Math.ceil(numberValue);
+	else {
+		if (numberValue % 1 !== 0) {
+			if (onError === "throwError") throw new Error("Decimal values are not allowed");
+			return onError === "returnOriginal" ? value : defaultValue;
+		}
+		result = numberValue;
+	}
+	if (!isUndefined(min) || !isUndefined(max)) {
+		const minVal = min ?? -Infinity;
+		const maxVal = max ?? Infinity;
+		if (result < minVal || result > maxVal) {
+			if (outOfRange === "throwError") throw new RangeError(`Value ${result} is out of range [${minVal}, ${maxVal}]`);
+			if (outOfRange === "useDefault") return defaultValue;
+			if (outOfRange === "clamp") result = Math.max(minVal, Math.min(maxVal, numberValue));
+		}
+	}
+	return result;
+}
+
+//#endregion
+//#region src/array/shuffle.ts
+/**
+* Fisher–Yates shuffle
+*
+* @param array - array to shuffle
+* @returns shuffled array
+*/
+function shuffle(array) {
+	for (let i = array.length - 1; i > 0; i--) {
+		const j = randomNumber(0, i, { includeMax: true });
+		[array[i], array[j]] = [array[j], array[i]];
+	}
+	return array;
+}
+
 //#endregion
 //#region src/array/toArray.ts
 /**
@@ -694,70 +817,12 @@ function slash(input) {
 }
 
 //#endregion
-//#region src/number/random.ts
+//#region src/string/escape.ts
 /**
-* random an integer by given range
-*
-* @param min - min value
-* @param max - max value
-* @returns random integer in range
+* @copyright {@link https://github.com/sindresorhus/escape-string-regexp}
 */
-function randomNumber(min, max = 0, options = {}) {
-	if (max === 0) {
-		max = min;
-		min = 0;
-	}
-	if (min > max) [min, max] = [max, min];
-	return Math.trunc(Math.random() * (max - min + (options.includeMax ? 1 : 0)) + min);
-}
-
-//#endregion
-//#region src/number/toInteger.ts
-/**
-* Transforms a value to an integer.
-* @param value - The value to convert to an integer.
-* @param options - Options for the conversion.
-* @returns The converted integer.
-*/
-function toInteger(value, options = {}) {
-	const { defaultValue = 0, allowDecimal = false, allowNaN = false, onError = "useDefault", min, max, outOfRange = "clamp" } = options;
-	let numberValue;
-	let result;
-	if (isNumber(value)) numberValue = value;
-	else if (isString(value)) {
-		const trimmed = value.trim();
-		if (isEmptyString(trimmed)) {
-			if (onError === "throwError") throw new TypeError("Cannot convert empty string to an integer");
-			return onError === "returnOriginal" ? value : defaultValue;
-		}
-		numberValue = Number(trimmed);
-	} else if (isNullOrUndefined(value)) {
-		if (onError === "throwError") throw new TypeError(`Cannot convert ${value} to an integer`);
-		return onError === "useDefault" ? value : defaultValue;
-	} else numberValue = Number(value);
-	if (isNaN(numberValue)) {
-		if (allowNaN) return numberValue;
-		if (onError === "throwError") throw new TypeError(`Cannot convert NaN to an integer`);
-		return onError === "returnOriginal" ? value : defaultValue;
-	}
-	if (allowDecimal) result = numberValue > 0 ? Math.floor(numberValue) : Math.ceil(numberValue);
-	else {
-		if (numberValue % 1 !== 0) {
-			if (onError === "throwError") throw new Error("Decimal values are not allowed");
-			return onError === "returnOriginal" ? value : defaultValue;
-		}
-		result = numberValue;
-	}
-	if (!isUndefined(min) || !isUndefined(max)) {
-		const minVal = min ?? -Infinity;
-		const maxVal = max ?? Infinity;
-		if (result < minVal || result > maxVal) {
-			if (outOfRange === "throwError") throw new RangeError(`Value ${result} is out of range [${minVal}, ${maxVal}]`);
-			if (outOfRange === "useDefault") return defaultValue;
-			if (outOfRange === "clamp") result = Math.max(minVal, Math.min(maxVal, numberValue));
-		}
-	}
-	return result;
+function escapeStringRegexp(value) {
+	return value.replace(/[|\\{}()[\]^$+*?.]/g, "\\$&").replace(/-/g, "\\x2d");
 }
 
 //#endregion
@@ -771,7 +836,10 @@ function toInteger(value, options = {}) {
 */
 function randomString(length = 16, chars = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ") {
 	const result = [];
-	for (let i = length; i > 0; --i) result.push(chars[randomNumber(chars.length)]);
+	for (let i = length; i > 0; --i) {
+		const matchedChar = chars[randomNumber(chars.length)];
+		if (matchedChar) result.push(matchedChar);
+	}
 	return result.join("");
 }
 
@@ -806,7 +874,7 @@ const _RE_FULL_WS = /^\s*$/;
 * ```
 */
 function unindent(input) {
-	const lines = (typeof input === "string" ? input : input[0]).split("\n");
+	const lines = (isString(input) ? input : input[0])?.split("\n") ?? [];
 	const whitespaceLines = lines.map((line) => _RE_FULL_WS.test(line));
 	const commonIndent = lines.reduce((min, line, idx) => {
 		if (whitespaceLines[idx]) return min;
@@ -1084,9 +1152,10 @@ function hasOwn(object, key) {
 //#endregion
 //#region src/object/pick.ts
 function pick(object, keys) {
-	return Object.assign({}, ...keys.map((key) => {
-		if (object && hasOwn(object, key)) return { [key]: object[key] };
-	}));
+	return keys.reduce((result, key) => {
+		if (object && hasOwn(object, key)) result[key] = object[key];
+		return result;
+	}, {});
 }
 
 //#endregion
@@ -1104,7 +1173,7 @@ function cleanObject(obj, options = {}) {
 		if (cleanUndefined && isUndefined(v)) delete obj[key];
 		if (cleanNull && isNull(v)) delete obj[key];
 		if (cleanZero && isZero(v)) delete obj[key];
-		if (cleanNaN && isZero(v)) delete obj[key];
+		if (cleanNaN && isNaN(v)) delete obj[key];
 		if (cleanEmptyString && isEmptyString(v)) delete obj[key];
 		if (cleanEmptyArray && isEmptyArray(v)) delete obj[key];
 		if (cleanEmptyObject && isEmptyObject(v)) delete obj[key];
@@ -1113,6 +1182,20 @@ function cleanObject(obj, options = {}) {
 	return obj;
 }
 
+//#endregion
+//#region src/object/isKeyOf.ts
+/**
+* Type guard for any key, `k`
+* marks `k` as a key of `T` if `k` is a key of `T`
+*
+* @param obj - object to query for key
+* @param k - key to check for
+* @returns true if `k` is a key of `T`
+*/
+function isKeyOf(obj, k) {
+	return k in obj;
+}
+
 //#endregion
 //#region src/object/isPlainObject.ts
 /**
@@ -1157,7 +1240,14 @@ function sortObject(obj, options = {}) {
 /**
 * Special chars
 */
-const SPECIAL_CHAR = { newline: "\n" };
+const SPECIAL_CHAR = {
+	chineseComma: "、",
+	englishComma: ",",
+	englishPeriod: ".",
+	hyphen: "-",
+	newline: "\n",
+	whitespace: " "
+};
 
 //#endregion
 //#region src/constants/regexp.ts
@@ -1177,4 +1267,4 @@ const RE_LINE_COMMENT = /\/\/.*/;
 const RE_BLOCK_COMMENT = /\/\*[\s\S]*?\*\//g;
 
 //#endregion
-export { Color, NOOP, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, SPECIAL_CHAR, STORAGE_UNITS, TIME_UNITS, at, cAF, chunk, clamp, cleanObject, convertFromBytes, convertFromMilliseconds, convertStorageUnit, convertTimeUnit, convertToBytes, convertToMilliseconds, createPadString, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBlob, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFile, isFormData, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isUrlString, isWhitespaceString, isZero, join, last, mergeArrayable, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, removeFileExtension, resolveSubOptions, scrollElementIntoView, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce };
+export { Color, NOOP, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, SPECIAL_CHAR, STORAGE_UNITS, TIME_UNITS, at, cAF, chunk, clamp, cleanObject, convertFromBytes, convertFromMilliseconds, convertStorageUnit, convertTimeUnit, convertToBytes, convertToMilliseconds, createPadString, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, escapeStringRegexp, flattenArrayable, getFileExtension, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, interopDefault, intersect, isArray, isArrayEqual, isBigInt, isBlob, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFile, isFormData, isFunction, isHTMLElement, isInteger, isIterable, isKeyOf, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPlainObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, isUrlString, isWhitespaceString, isZero, join, last, mergeArrayable, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, remove, removeFileExtension, resolveSubOptions, scrollElementIntoView, shuffle, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce };

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.9.2",
-  "packageManager": "pnpm@10.16.1",
+  "version": "0.11.0",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -30,35 +29,34 @@
     "dist"
   ],
   "sideEffects": false,
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch src",
-    "lint": "eslint",
-    "prepare": "husky",
-    "prepublishOnly": "pnpm run build",
-    "release": "run-s release:check release:version",
-    "release:check": "run-s lint typecheck test",
-    "release:version": "bumpp",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
   "devDependencies": {
-    "@ntnyq/eslint-config": "^5.5.0",
+    "@ntnyq/eslint-config": "^5.9.0",
     "@ntnyq/prettier-config": "^3.0.1",
-    "bumpp": "^10.2.3",
-    "eslint": "^9.35.0",
+    "@ntnyq/tsconfig": "^3.1.0",
+    "bumpp": "^10.3.2",
+    "eslint": "^9.39.2",
     "husky": "^9.1.7",
-    "nano-staged": "^0.8.0",
+    "nano-staged": "^0.9.0",
     "npm-run-all2": "^8.0.4",
-    "prettier": "^3.6.2",
-    "tsdown": "^0.15.1",
-    "typescript": "^5.9.2",
-    "vitest": "^3.2.4"
+    "prettier": "^3.7.4",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
   },
   "engines": {
-    "node": ">=18.18.0"
+    "node": "^20.19.0 || ^22.13.0 || >=24"
   },
   "nano-staged": {
     "*.{js,ts,mjs,cjs,md,yml,yaml,toml,json}": "eslint --fix"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch src",
+    "lint": "eslint",
+    "release": "run-s release:check release:version",
+    "release:check": "run-s lint typecheck test",
+    "release:version": "bumpp",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
   }
-}
+}