@ntnyq/utils 0.11.0 → 0.11.2

package/dist/index.js

@@ -7,7 +7,6 @@ function noop() {}
 * Alias of {@link noop}.
 */
 const NOOP = noop;
-
 //#endregion
 //#region src/fn/once.ts
 /**
@@ -35,7 +34,6 @@ function once(func) {
 		return true;
 	};
 }
-
 //#endregion
 //#region src/env/isBrowser.ts
 /**
@@ -46,7 +44,6 @@ function once(func) {
 function isBrowser() {
 	return typeof document !== "undefined" && typeof window !== "undefined" && typeof navigator !== "undefined" && window === self;
 }
-
 //#endregion
 //#region src/is/dom.ts
 /**
@@ -61,7 +58,6 @@ function isHTMLElement(value) {
 	if (!isBrowser()) return false;
 	return typeof value === "object" && value !== null && "nodeType" in value && value.nodeType === Node.ELEMENT_NODE && value instanceof HTMLElement;
 }
-
 //#endregion
 //#region src/is/core.ts
 function getObjectType(value) {
@@ -128,24 +124,24 @@ function isEmptyArray(value) {
 function isNonEmptyArray(value) {
 	return isArray(value) && value.length > 0;
 }
-function isObject(value) {
-	return (typeof value === "object" || isFunction(value)) && !isNull(value);
-}
-function isEmptyObject(value) {
-	return isObject(value) && !isMap(value) && !isSet(value) && Object.keys(value).length === 0;
-}
 function isMap(value) {
 	return getObjectType(value) === "Map";
 }
-function isEmptyMap(value) {
-	return isMap(value) && value.size === 0;
-}
 function isSet(value) {
 	return getObjectType(value) === "Set";
 }
 function isEmptySet(value) {
 	return isSet(value) && value.size === 0;
 }
+function isObject(value) {
+	return (typeof value === "object" || isFunction(value)) && !isNull(value);
+}
+function isEmptyObject(value) {
+	return isObject(value) && !isMap(value) && !isSet(value) && Object.keys(value).length === 0;
+}
+function isEmptyMap(value) {
+	return isMap(value) && value.size === 0;
+}
 function isRegExp(value) {
 	return getObjectType(value) === "RegExp";
 }
@@ -185,7 +181,6 @@ function isUrlString(value) {
 		return false;
 	}
 }
-
 //#endregion
 //#region src/is/isDeepEqual.ts
 /**
@@ -204,7 +199,6 @@ function isDeepEqual(value1, value2) {
 	}
 	return Object.is(value1, value2);
 }
-
 //#endregion
 //#region src/dom/scrollIntoView.ts
 /**
@@ -224,7 +218,6 @@ function scrollElementIntoView(element, options = {}) {
 	const elementRect = element.getBoundingClientRect();
 	if (parent.scrollWidth > parent.scrollHeight ? elementRect.left < parentRect.left || elementRect.right > parentRect.right : elementRect.top < parentRect.top || elementRect.bottom > parentRect.bottom) parent.scrollIntoView(scrollIntoViewOptions);
 }
-
 //#endregion
 //#region src/dom/openExternalURL.ts
 /**
@@ -237,7 +230,6 @@ function openExternalURL(url, options = {}) {
 	const { target = "_blank" } = options;
 	return window.open(url, target);
 }
-
 //#endregion
 //#region src/dom/isVisibleInViewport.ts
 /**
@@ -251,7 +243,6 @@ function isElementVisibleInViewport(element, targetWindow = window) {
 	const { innerWidth, innerHeight } = targetWindow;
 	return (top >= 0 && top <= innerHeight || bottom >= 0 && bottom <= innerHeight) && (left >= 0 && left <= innerWidth || right >= 0 && right <= innerWidth);
 }
-
 //#endregion
 //#region src/file/extension.ts
 /**
@@ -272,7 +263,6 @@ function getFileExtension(filePath) {
 	if (!filePath) return;
 	return filePath.match(/\.([^.]+)$/)?.[1];
 }
-
 //#endregion
 //#region src/html/escape.ts
 const htmlEscapeMap = {
@@ -308,7 +298,6 @@ const htmlUnescapeRegexp = /&(amp|#38|lt|#60|gt|#62|apos|#39|quot|#34);/g;
 function unescapeHTML(str) {
 	return str.replace(htmlUnescapeRegexp, (char) => htmlUnescapeMap[char]);
 }
-
 //#endregion
 //#region src/misc/raf.ts
 /**
@@ -341,7 +330,6 @@ function cAF(id) {
 	const root = getRoot();
 	return root.cancelAnimationFrame.call(root, id);
 }
-
 //#endregion
 //#region src/misc/clamp.ts
 /**
@@ -354,7 +342,6 @@ function cAF(id) {
 function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFINITY) {
 	return Math.min(Math.max(value, min), max);
 }
-
 //#endregion
 //#region src/misc/waitFor.ts
 /**
@@ -373,7 +360,6 @@ function clamp(value, min = Number.NEGATIVE_INFINITY, max = Number.POSITIVE_INFI
 async function waitFor(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
-
 //#endregion
 //#region src/misc/throttle.ts
 /**
@@ -391,7 +377,7 @@ function throttle(delay, callback, options = {}) {
 	*/
 	let lastExec = 0;
 	let cancelled = false;
-	let timeoutId;
+	let timeoutId = void 0;
 	function clearExistingTimeout() {
 		if (timeoutId) clearTimeout(timeoutId);
 	}
@@ -425,7 +411,6 @@ function debounce(delay, callback, options = {}) {
 		isDebounce: true
 	});
 }
-
 //#endregion
 //#region src/misc/warnOnce.ts
 /**
@@ -442,7 +427,6 @@ function warnOnce(message) {
 	warned.add(message);
 	console.warn(message);
 }
-
 //#endregion
 //#region src/misc/convertTime.ts
 /**
@@ -506,7 +490,6 @@ function convertFromMilliseconds(milliseconds, toUnit = "SECOND") {
 function convertTimeUnit(value, fromUnit, toUnit) {
 	return convertFromMilliseconds(convertToMilliseconds(value, fromUnit), toUnit);
 }
-
 //#endregion
 //#region src/misc/convertStorage.ts
 /**
@@ -569,7 +552,6 @@ function convertFromBytes(bytes, toUnit = "MB") {
 function convertStorageUnit(value, fromUnit, toUnit) {
 	return convertFromBytes(convertToBytes(value, fromUnit), toUnit);
 }
-
 //#endregion
 //#region src/array/at.ts
 /**
@@ -592,7 +574,6 @@ function at(array, index) {
 function last(array) {
 	return at(array, -1);
 }
-
 //#endregion
 //#region src/array/chunk.ts
 /**
@@ -606,7 +587,6 @@ function chunk(array, size) {
 	for (let i = 0; i < array.length; i += size) result.push(array.slice(i, i + size));
 	return result;
 }
-
 //#endregion
 //#region src/array/remove.ts
 /**
@@ -624,7 +604,6 @@ function remove(array, value) {
 	}
 	return false;
 }
-
 //#endregion
 //#region src/array/unique.ts
 /**
@@ -647,7 +626,6 @@ function uniqueBy(array, equalFn) {
 		return acc;
 	}, []);
 }
-
 //#endregion
 //#region src/number/random.ts
 /**
@@ -665,7 +643,6 @@ function randomNumber(min, max = 0, options = {}) {
 	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
 /**
@@ -714,7 +691,23 @@ function toInteger(value, options = {}) {
 	}
 	return result;
 }
-
+//#endregion
+//#region src/number/toNumber.ts
+/**
+* Converts `value` to a number.
+* @param value The value to process.
+* @returns Returns the number.
+*/
+function toNumber(value) {
+	if (!isString(value) && !isNumber(value)) throw new TypeError(`Expected a string or number, got ${typeof value}`);
+	if (isNaN(value)) throw new TypeError(`Expected a valid number, got NaN`);
+	if (isString(value)) {
+		const result = Number.parseFloat(value);
+		if (isNaN(result)) throw new TypeError(`Expected a valid number, got NaN`);
+		return result;
+	}
+	return value;
+}
 //#endregion
 //#region src/array/shuffle.ts
 /**
@@ -730,7 +723,6 @@ function shuffle(array) {
 	}
 	return array;
 }
-
 //#endregion
 //#region src/array/toArray.ts
 /**
@@ -742,7 +734,6 @@ function toArray(array) {
 	array = array ?? [];
 	return Array.isArray(array) ? array : [array];
 }
-
 //#endregion
 //#region src/array/arrayable.ts
 /**
@@ -761,7 +752,6 @@ function flattenArrayable(array) {
 function mergeArrayable(...args) {
 	return args.flatMap((i) => toArray(i));
 }
-
 //#endregion
 //#region src/array/intersect.ts
 /**
@@ -772,7 +762,6 @@ function mergeArrayable(...args) {
 function intersect(a, b) {
 	return a.filter((item) => b.includes(item));
 }
-
 //#endregion
 //#region src/array/isArrayEqual.ts
 /**
@@ -785,14 +774,12 @@ function isArrayEqual(array1, array2) {
 	if (array1.length !== array2.length) return false;
 	return array1.every((item, idx) => item === array2[idx]);
 }
-
 //#endregion
 //#region src/string/pad.ts
 function createPadString(options) {
 	const { length, char } = options;
 	return (value) => (char.repeat(length) + value).slice(-length);
 }
-
 //#endregion
 //#region src/string/join.ts
 /**
@@ -804,27 +791,24 @@ function createPadString(options) {
 function join(array, options = {}) {
 	const { separator = "" } = options;
 	if (!Array.isArray(array) || !array.length) return "";
-	return array.filter((v) => Boolean(v) || v === 0).join(separator);
+	return array.filter((i) => Boolean(i) || i === 0).join(separator);
 }
-
 //#endregion
 //#region src/string/slash.ts
 /**
 * Replace backslash to slash
 */
 function slash(input) {
-	return input.replace(/\\/g, "/");
+	return input.replaceAll("\\", "/");
 }
-
 //#endregion
 //#region src/string/escape.ts
 /**
 * @copyright {@link https://github.com/sindresorhus/escape-string-regexp}
 */
 function escapeStringRegexp(value) {
-	return value.replace(/[|\\{}()[\]^$+*?.]/g, "\\$&").replace(/-/g, "\\x2d");
+	return value.replaceAll(/[|\\{}()[\]^$+*?.]/g, "\\$&").replaceAll("-", "\\x2d");
 }
-
 //#endregion
 //#region src/string/random.ts
 /**
@@ -842,7 +826,6 @@ function randomString(length = 16, chars = "0123456789abcdefghijklmnopqrstuvwxyz
 	}
 	return result.join("");
 }
-
 //#endregion
 //#region src/string/slugify.ts
 const rControl = /[\u0000-\u001F]/g;
@@ -852,9 +835,8 @@ const rCombining = /[\u0300-\u036F]/g;
 * Default slugify function
 */
 function slugify(str) {
-	return str.normalize("NFKD").replace(rCombining, "").replace(rControl, "").replace(rSpecial, "-").replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "").replace(/^(\d)/, "_$1").toLowerCase();
+	return str.normalize("NFKD").replace(rCombining, "").replace(rControl, "").replace(rSpecial, "-").replaceAll(/-{2,}/g, "-").replaceAll(/^-+|-+$/g, "").replace(/^(\d)/, "_$1").toLowerCase();
 }
-
 //#endregion
 //#region src/string/unindent.ts
 const _RE_FULL_WS = /^\s*$/;
@@ -887,7 +869,6 @@ function unindent(input) {
 	while (emptylinesTail < lines.length && whitespaceLines[lines.length - emptylinesTail - 1]) emptylinesTail++;
 	return lines.slice(emptylinesHead, lines.length - emptylinesTail).map((line) => line.slice(commonIndent)).join("\n");
 }
-
 //#endregion
 //#region src/string/getLength.ts
 let segmenter;
@@ -904,19 +885,16 @@ function getStringLength(value) {
 	segmenter ??= new Intl.Segmenter();
 	return [...segmenter.segment(value)].length;
 }
-
 //#endregion
 //#region src/string/ensurePrefix.ts
 function ensurePrefix(input, prefix) {
 	return input.startsWith(prefix) ? input : `${prefix}${input}`;
 }
-
 //#endregion
 //#region src/string/ensureSuffix.ts
 function ensureSuffix(input, suffix) {
 	return input.endsWith(suffix) ? input : `${input}${suffix}`;
 }
-
 //#endregion
 //#region src/string/getSimilarity.ts
 function getStringSimilarity(str1, str2, options = {}) {
@@ -942,7 +920,6 @@ function getStringSimilarity(str1, str2, options = {}) {
 	}
 	return match * 2 / (str1.length + str2.length - (sliceLength - 1) * 2);
 }
-
 //#endregion
 //#region src/color/color.ts
 const RE_VALID_HEX_COLOR = /^#(?:[0-9a-f]{6}|[0-9a-f]{3})$/i;
@@ -952,7 +929,7 @@ function validateHexColor(hex) {
 	return RE_VALID_HEX_COLOR.test(hex);
 }
 function normalizeHexString(hex) {
-	return hex.length === 6 ? hex : hex.replace(/./g, "$&$&");
+	return hex.length === 6 ? hex : hex.replaceAll(/./g, "$&$&");
 }
 var Color = class Color {
 	red = 0;
@@ -1028,7 +1005,6 @@ var Color = class Color {
 		return new Color(Math.max(this.red - amount, 0), Math.max(this.green - amount, 0), Math.max(this.blue - amount, 0), this.alpha);
 	}
 };
-
 //#endregion
 //#region src/color/random.ts
 /**
@@ -1056,7 +1032,6 @@ function randomRGBAColor() {
 function randomHexColor() {
 	return `#${Math.random().toString(16).slice(2, 8)}`;
 }
-
 //#endregion
 //#region src/proxy/enhance.ts
 /**
@@ -1074,7 +1049,28 @@ function enhance(module, extra) {
 		}
 	});
 }
-
+//#endregion
+//#region src/tree/flatTree.ts
+function flatTree(roots, options = {}) {
+	const { childrenKey = "children", includeSelf = true, map } = options;
+	const out = [];
+	function walk(nodes, parent, depth, path) {
+		nodes.forEach((node, index) => {
+			const nextPath = [...path, node];
+			if (includeSelf) out.push(map ? map({
+				node,
+				parent,
+				depth,
+				index,
+				path: nextPath
+			}) : node);
+			const children = node[childrenKey];
+			if (Array.isArray(children) && children.length > 0) walk(children, node, depth + 1, nextPath);
+		});
+	}
+	walk(roots, null, 0, []);
+	return out;
+}
 //#endregion
 //#region src/module/interopDefault.ts
 /**
@@ -1095,7 +1091,6 @@ async function interopDefault(mod) {
 	const resolved = await mod;
 	return resolved.default || resolved;
 }
-
 //#endregion
 //#region src/module/resolveSubOptions.ts
 /**
@@ -1128,14 +1123,12 @@ async function interopDefault(mod) {
 function resolveSubOptions(options, key) {
 	return typeof options[key] === "boolean" ? {} : options[key] || {};
 }
-
 //#endregion
 //#region src/object/omit.ts
 function omit(object, ...keys) {
 	keys.forEach((key) => delete object[key]);
 	return object;
 }
-
 //#endregion
 //#region src/object/hasOwn.ts
 /**
@@ -1148,7 +1141,6 @@ function hasOwn(object, key) {
 	if (object === null) return false;
 	return Object.prototype.hasOwnProperty.call(object, key);
 }
-
 //#endregion
 //#region src/object/pick.ts
 function pick(object, keys) {
@@ -1157,7 +1149,6 @@ function pick(object, keys) {
 		return result;
 	}, {});
 }
-
 //#endregion
 //#region src/object/clean.ts
 /**
@@ -1181,7 +1172,6 @@ function cleanObject(obj, options = {}) {
 	});
 	return obj;
 }
-
 //#endregion
 //#region src/object/isKeyOf.ts
 /**
@@ -1195,7 +1185,6 @@ function cleanObject(obj, options = {}) {
 function isKeyOf(obj, k) {
 	return k in obj;
 }
-
 //#endregion
 //#region src/object/isPlainObject.ts
 /**
@@ -1209,32 +1198,30 @@ function isPlainObject(value) {
 	const prototype = Object.getPrototypeOf(value);
 	return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
 }
-
 //#endregion
 //#region src/object/sortObject.ts
 /**
 * Sort object properties
 */
-function sortObject(obj, options = {}) {
+function sortObject(object, options = {}) {
 	const { compareFn = (a, b) => a.localeCompare(b) } = options;
-	function sortKeys(obj$1) {
-		const sortedKeys = Object.keys(obj$1).sort(compareFn);
+	function sortKeys(obj) {
+		const sortedKeys = Object.keys(obj).sort(compareFn);
 		const result = {};
 		for (const key of sortedKeys) {
-			const value = obj$1[key];
+			const value = obj[key];
 			let newValue;
 			if (options.deep && isPlainObject(value)) newValue = sortKeys(value);
 			else newValue = value;
 			Object.defineProperty(result, key, {
-				...Object.getOwnPropertyDescriptor(obj$1, key),
+				...Object.getOwnPropertyDescriptor(obj, key),
 				value: newValue
 			});
 		}
 		return result;
 	}
-	return sortKeys(obj);
+	return sortKeys(object);
 }
-
 //#endregion
 //#region src/constants/char.ts
 /**
@@ -1248,7 +1235,6 @@ const SPECIAL_CHAR = {
 	newline: "\n",
 	whitespace: " "
 };
-
 //#endregion
 //#region src/constants/regexp.ts
 /**
@@ -1265,6 +1251,5 @@ const RE_LINE_COMMENT = /\/\/.*/;
 * JavaScript block 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, 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 };
+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, flatTree, 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, toNumber, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce };

package/package.json

@@ -1,21 +1,27 @@
 {
   "name": "@ntnyq/utils",
-  "type": "module",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Common used utils.",
   "keywords": [
     "utils"
   ],
+  "homepage": "https://github.com/ntnyq/utils#readme",
+  "bugs": {
+    "url": "https://github.com/ntnyq/utils/issues"
+  },
   "license": "MIT",
   "author": {
     "name": "ntnyq",
     "email": "ntnyq13@gmail.com"
   },
-  "homepage": "https://github.com/ntnyq/utils#readme",
   "repository": "ntnyq/utils",
-  "bugs": {
-    "url": "https://github.com/ntnyq/utils/issues"
-  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
@@ -23,40 +29,35 @@
       "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "sideEffects": false,
   "devDependencies": {
-    "@ntnyq/eslint-config": "^5.9.0",
-    "@ntnyq/prettier-config": "^3.0.1",
     "@ntnyq/tsconfig": "^3.1.0",
-    "bumpp": "^10.3.2",
-    "eslint": "^9.39.2",
+    "@typescript/native-preview": "^7.0.0-dev.20260320.1",
+    "bumpp": "^11.0.1",
     "husky": "^9.1.7",
     "nano-staged": "^0.9.0",
     "npm-run-all2": "^8.0.4",
-    "prettier": "^3.7.4",
-    "tsdown": "^0.18.3",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.56.0",
+    "tsdown": "^0.21.4",
+    "vitest": "^4.1.0"
+  },
+  "nano-staged": {
+    "*.{js,ts,mjs,tsx}": "oxlint --fix",
+    "*": "oxfmt --no-error-on-unmatched-pattern"
   },
   "engines": {
     "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",
+    "format": "oxfmt",
+    "format:check": "oxfmt --check",
+    "lint": "oxlint",
     "release": "run-s release:check release:version",
-    "release:check": "run-s lint typecheck test",
+    "release:check": "run-s format:check lint typecheck test",
     "release:version": "bumpp",
     "test": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   }
 }