@ntnyq/utils 0.7.2 → 0.8.1

package/dist/index.d.ts

@@ -183,7 +183,16 @@ declare function isElementVisibleInViewport(element: HTMLElement, targetWindow?:
 *
 * @returns boolean - true if the code is running in a browser
 */
-declare const isBrowser: () => boolean;
+declare function isBrowser(): boolean;
+//#endregion
+//#region src/file/removeExtension.d.ts
+/**
+* Removes the file extension from a filename.
+*
+* @param filename - The filename to remove the extension from.
+* @returns The filename without the extension.
+*/
+declare function removeFileExtension(filename: string): string;
 //#endregion
 //#region src/html/escape.d.ts
 /**
@@ -196,6 +205,10 @@ declare function escapeHTML(str: string): string;
 declare function unescapeHTML(str: string): string;
 //#endregion
 //#region src/misc/raf.d.ts
+/**
+* Gets the global root object.
+* @returns the global root object
+*/
 declare function getRoot(): Window | typeof globalThis;
 /**
 * Request animation frame
@@ -217,15 +230,35 @@ declare function cAF(id: number): void;
 * @file time utils
 * @module Time
 */
-declare const ONE_SECOND_MILLSECONDS: number;
-declare const ONE_MINUTE_MILLSECONDS: number;
-declare const ONE_HOUR_MILLSECONDS: number;
-declare const ONE_DAY_MILLSECONDS: number;
-declare const ONE_WEEK_MILLSECONDS: number;
+/**
+* Converts seconds to milliseconds.
+* @param count - The number of seconds.
+* @returns The equivalent number of milliseconds.
+*/
 declare function seconds(count: number): number;
+/**
+* Converts minutes to milliseconds.
+* @param count - The number of minutes.
+* @returns The equivalent number of milliseconds.
+*/
 declare function minutes(count: number): number;
+/**
+* Converts hours to milliseconds.
+* @param count - The number of hours.
+* @returns The equivalent number of milliseconds.
+*/
 declare function hours(count: number): number;
+/**
+* Converts days to milliseconds.
+* @param count - The number of days.
+* @returns The equivalent number of milliseconds.
+*/
 declare function days(count: number): number;
+/**
+* Converts weeks to milliseconds.
+* @param count - The number of weeks.
+* @returns The equivalent number of milliseconds.
+*/
 declare function weeks(count: number): number;
 //#endregion
 //#region src/misc/clamp.d.ts
@@ -738,4 +771,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, ONE_DAY_MILLSECONDS, ONE_HOUR_MILLSECONDS, ONE_MINUTE_MILLSECONDS, ONE_SECOND_MILLSECONDS, ONE_WEEK_MILLSECONDS, OpenExternalURLOptions, Overwrite, Prettify, PrettifyV2, Primitive, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, RamdomNumberOptions, ResolvedOptions, SPECIAL_CHAR, SortObjectOptions, ThrottleDebounceOptions, ToIntegerOptions, Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, hours, 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, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+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, SortObjectOptions, ThrottleDebounceOptions, ToIntegerOptions, Whitespace, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, hours, 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, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, removeFileExtension, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/dist/index.js

@@ -221,7 +221,21 @@ function isElementVisibleInViewport(element, targetWindow = window) {
 *
 * @returns boolean - true if the code is running in a browser
 */
-const isBrowser = () => typeof document !== "undefined";
+function isBrowser() {
+	return typeof document !== "undefined";
+}
+
+//#endregion
+//#region src/file/removeExtension.ts
+/**
+* Removes the file extension from a filename.
+*
+* @param filename - The filename to remove the extension from.
+* @returns The filename without the extension.
+*/
+function removeFileExtension(filename) {
+	return filename.replace(/\.[^/.]+$/, "");
+}
 
 //#endregion
 //#region src/html/escape.ts
@@ -261,17 +275,13 @@ function unescapeHTML(str) {
 
 //#endregion
 //#region src/misc/raf.ts
+/**
+* Gets the global root object.
+* @returns the global root object
+*/
 function getRoot() {
 	return isBrowser() ? window : globalThis;
 }
-let prev = Date.now();
-function mockRAF(fn) {
-	const curr = Date.now();
-	const ms = Math.max(0, 16 - (curr - prev));
-	const id = setTimeout(fn, ms);
-	prev = curr + ms;
-	return id;
-}
 /**
 * Request animation frame
 *
@@ -280,7 +290,7 @@ function mockRAF(fn) {
 */
 function rAF(fn) {
 	const root = getRoot();
-	const raf = root.requestAnimationFrame || mockRAF;
+	const raf = root.requestAnimationFrame;
 	return raf.call(root, fn);
 }
 /**
@@ -291,7 +301,7 @@ function rAF(fn) {
 */
 function cAF(id) {
 	const root = getRoot();
-	const caf = root.cancelAnimationFrame || root.clearTimeout;
+	const caf = root.cancelAnimationFrame;
 	return caf.call(root, id);
 }
 
@@ -301,25 +311,45 @@ function cAF(id) {
 * @file time utils
 * @module Time
 */
-const ONE_SECOND_MILLSECONDS = 1e3;
-const ONE_MINUTE_MILLSECONDS = 60 * ONE_SECOND_MILLSECONDS;
-const ONE_HOUR_MILLSECONDS = 60 * ONE_MINUTE_MILLSECONDS;
-const ONE_DAY_MILLSECONDS = 24 * ONE_HOUR_MILLSECONDS;
-const ONE_WEEK_MILLSECONDS = 7 * ONE_DAY_MILLSECONDS;
+/**
+* Converts seconds to milliseconds.
+* @param count - The number of seconds.
+* @returns The equivalent number of milliseconds.
+*/
 function seconds(count) {
-	return count * ONE_SECOND_MILLSECONDS;
+	return count * 1e3;
 }
+/**
+* Converts minutes to milliseconds.
+* @param count - The number of minutes.
+* @returns The equivalent number of milliseconds.
+*/
 function minutes(count) {
-	return count * ONE_MINUTE_MILLSECONDS;
+	return count * 60 * 1e3;
 }
+/**
+* Converts hours to milliseconds.
+* @param count - The number of hours.
+* @returns The equivalent number of milliseconds.
+*/
 function hours(count) {
-	return count * ONE_HOUR_MILLSECONDS;
+	return count * 60 * 60 * 1e3;
 }
+/**
+* Converts days to milliseconds.
+* @param count - The number of days.
+* @returns The equivalent number of milliseconds.
+*/
 function days(count) {
-	return count * ONE_DAY_MILLSECONDS;
+	return count * 24 * 60 * 60 * 1e3;
 }
+/**
+* Converts weeks to milliseconds.
+* @param count - The number of weeks.
+* @returns The equivalent number of milliseconds.
+*/
 function weeks(count) {
-	return count * ONE_WEEK_MILLSECONDS;
+	return count * 7 * 24 * 60 * 60 * 1e3;
 }
 
 //#endregion
@@ -753,10 +783,6 @@ function getStringSimilarity(str1, str2, options = {}) {
 
 //#endregion
 //#region src/color/color.ts
-const pad2 = createPadString({
-	length: 2,
-	char: "0"
-});
 const RE_VALID_HEX_COLOR = /^#(?:[0-9a-f]{6}|[0-9a-f]{3})$/i;
 function validateHexColor(hex) {
 	if (hex.length !== 4 && hex.length !== 7) return false;
@@ -802,6 +828,10 @@ var Color = class Color {
 		return !this.isDark;
 	}
 	toHexString(isUpperCase = true) {
+		const pad2 = createPadString({
+			length: 2,
+			char: "0"
+		});
 		const hexString = `#${pad2(this.red.toString(16))}${pad2(this.green.toString(16))}${pad2(this.blue.toString(16))}`;
 		return isUpperCase ? hexString.toUpperCase() : hexString;
 	}
@@ -1053,4 +1083,4 @@ const RE_LINE_COMMENT = /\/\/.*/;
 const RE_BLOCK_COMMENT = /\/\*[\s\S]*?\*\//g;
 
 //#endregion
-export { Color, NOOP, ONE_DAY_MILLSECONDS, ONE_HOUR_MILLSECONDS, ONE_MINUTE_MILLSECONDS, ONE_SECOND_MILLSECONDS, ONE_WEEK_MILLSECONDS, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, SPECIAL_CHAR, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, hours, 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, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };
+export { Color, NOOP, RE_BLOCK_COMMENT, RE_COMMENTS, RE_LINE_COMMENT, SPECIAL_CHAR, at, cAF, chunk, clamp, cleanObject, createPadString, days, debounce, enhance, ensurePrefix, ensureSuffix, escapeHTML, flattenArrayable, getObjectType, getRoot, getStringLength, getStringSimilarity, hasOwn, hours, 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, minutes, noop, omit, once, openExternalURL, pick, rAF, randomHexColor, randomNumber, randomRGBAColor, randomRGBColor, randomString, removeFileExtension, resolveSubOptions, scrollElementIntoView, seconds, slash, slugify, sortObject, throttle, toArray, toInteger, unescapeHTML, unindent, unique, uniqueBy, waitFor, warnOnce, weeks };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ntnyq/utils",
   "type": "module",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "Common used utils.",
   "keywords": [
     "utils"
@@ -30,17 +30,17 @@
   ],
   "sideEffects": false,
   "devDependencies": {
-    "@ntnyq/eslint-config": "^5.0.0-beta.5",
-    "@ntnyq/prettier-config": "^2.2.0",
-    "bumpp": "^10.1.1",
-    "eslint": "^9.28.0",
+    "@ntnyq/eslint-config": "^5.0.0",
+    "@ntnyq/prettier-config": "^3.0.1",
+    "bumpp": "^10.2.0",
+    "eslint": "^9.30.1",
     "husky": "^9.1.7",
     "nano-staged": "^0.8.0",
     "npm-run-all2": "^8.0.4",
-    "prettier": "^3.5.3",
-    "tsdown": "^0.12.7",
+    "prettier": "^3.6.2",
+    "tsdown": "^0.12.9",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.2"
+    "vitest": "^3.2.4"
   },
   "engines": {
     "node": ">=18.18.0"