@ntnyq/utils 0.9.0 → 0.9.2

package/dist/index.d.ts

@@ -65,6 +65,13 @@ declare function isError(value: unknown): value is Error;
 declare function isNativePromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
 declare function isIterable<T = unknown>(value: unknown): value is Iterable<T>;
+declare function isBlob(value: unknown): value is Blob;
+declare function isFormData(value: unknown): value is FormData;
+declare function isFile(value: unknown): value is File;
+type UrlString = string & {
+  readonly __brand: "UrlString";
+};
+declare function isUrlString(value: unknown): value is UrlString;
 //#endregion
 //#region src/is/isDeepEqual.d.ts
 /**
@@ -134,6 +141,14 @@ type Merge<T, U> = keyof T & keyof U extends never ? T & U : Omit<T, keyof T & k
 * Non empty object `{}`
 */
 type NonEmptyObject<T> = T extends Record<string, never> ? never : T;
+/**
+* A type that represents the values of an object type.
+*/
+type ValueOf<T> = T[keyof T];
+/**
+* A type that represents the elements of an array type.
+*/
+type ElementOf<T extends unknown[] | null | undefined> = T extends Array<infer U> ? U : never;
 //#endregion
 //#region src/types/module.d.ts
 /**
@@ -849,4 +864,4 @@ declare const RE_LINE_COMMENT: RegExp;
 */
 declare const RE_BLOCK_COMMENT: RegExp;
 //#endregion
-export { AnyFn, Arrayable, Awaitable, Callable, CleanObjectOptions, Color, CreatePadStringOptions, DeepRequired, 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, 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, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, 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, 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 };

package/dist/index.js

@@ -139,6 +139,24 @@ function isPromise(value) {
 function isIterable(value) {
 	return isFunction(value?.[Symbol.iterator]);
 }
+function isBlob(value) {
+	return getObjectType(value) === "Blob";
+}
+function isFormData(value) {
+	return getObjectType(value) === "FormData";
+}
+function isFile(value) {
+	return getObjectType(value) === "File";
+}
+function isUrlString(value) {
+	if (!isString(value)) return false;
+	try {
+		new URL(value);
+		return true;
+	} catch {
+		return false;
+	}
+}
 
 //#endregion
 //#region src/is/isDeepEqual.ts
@@ -178,9 +196,7 @@ function scrollElementIntoView(element, options = {}) {
 	}
 	const parentRect = parent.getBoundingClientRect();
 	const elementRect = element.getBoundingClientRect();
-	const isHorizontal = parent.scrollWidth > parent.scrollHeight;
-	const isOutOfView = isHorizontal ? elementRect.left < parentRect.left || elementRect.right > parentRect.right : elementRect.top < parentRect.top || elementRect.bottom > parentRect.bottom;
-	if (isOutOfView) parent.scrollIntoView(scrollIntoViewOptions);
+	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
@@ -193,8 +209,7 @@ function scrollElementIntoView(element, options = {}) {
 */
 function openExternalURL(url, options = {}) {
 	const { target = "_blank" } = options;
-	const proxy = window.open(url, target);
-	return proxy;
+	return window.open(url, target);
 }
 
 //#endregion
@@ -290,8 +305,7 @@ function getRoot() {
 */
 function rAF(fn) {
 	const root = getRoot();
-	const raf = root.requestAnimationFrame;
-	return raf.call(root, fn);
+	return root.requestAnimationFrame.call(root, fn);
 }
 /**
 * Cancel animation frame
@@ -301,8 +315,7 @@ function rAF(fn) {
 */
 function cAF(id) {
 	const root = getRoot();
-	const caf = root.cancelAnimationFrame;
-	return caf.call(root, id);
+	return root.cancelAnimationFrame.call(root, id);
 }
 
 //#endregion
@@ -545,7 +558,7 @@ function convertStorageUnit(value, fromUnit, toUnit) {
 */
 function at(array, index) {
 	const length = array.length;
-	if (!length) return void 0;
+	if (!length) return;
 	if (index < 0) index += length;
 	return array[index];
 }
@@ -590,8 +603,7 @@ function unique(array) {
 */
 function uniqueBy(array, equalFn) {
 	return array.reduce((acc, cur) => {
-		const idx = acc.findIndex((item) => equalFn(item, cur));
-		if (idx === -1) acc.push(cur);
+		if (acc.findIndex((item) => equalFn(item, cur)) === -1) acc.push(cur);
 		return acc;
 	}, []);
 }
@@ -1165,4 +1177,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, isBoolean, isBrowser, isDeepEqual, isElementVisibleInViewport, isEmptyArray, isEmptyMap, isEmptyObject, isEmptySet, isEmptyString, isEmptyStringOrWhitespace, isError, isFunction, isHTMLElement, isInteger, isIterable, isMap, isNaN, isNativePromise, isNil, isNonEmptyArray, isNonEmptyString, isNull, isNullOrUndefined, isNumber, isNumbericString, isObject, isPromise, isRegExp, isSet, isString, isTruthy, isUndefined, 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, 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 };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.9.0",
+  "version": "0.9.2",
+  "packageManager": "pnpm@10.16.1",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -29,16 +30,28 @@
     "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.2.0",
+    "@ntnyq/eslint-config": "^5.5.0",
     "@ntnyq/prettier-config": "^3.0.1",
-    "bumpp": "^10.2.2",
-    "eslint": "^9.32.0",
+    "bumpp": "^10.2.3",
+    "eslint": "^9.35.0",
     "husky": "^9.1.7",
     "nano-staged": "^0.8.0",
     "npm-run-all2": "^8.0.4",
     "prettier": "^3.6.2",
-    "tsdown": "^0.13.1",
+    "tsdown": "^0.15.1",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },
@@ -47,16 +60,5 @@
   },
   "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:publish",
-    "release:check": "run-s lint typecheck test",
-    "release:publish": "pnpm publish",
-    "release:version": "bumpp",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit"
   }
-}
+}