diginext-utils 2.0.22 → 2.0.23

package/src/math/index.ts

@@ -1,29 +1,14 @@
 const DEG2RAD = Math.PI / 180;
 const RAD2DEG = 180 / Math.PI;
 
-/**
- *
- * @param {Number} number
- * @return {Number}
- */
 export const randRound = (number: number) => {
 	return Math.round(Math.random() * number);
 };
 
-/**
- *
- * @param {Number} number
- * @return {Number}
- */
 export const rand = (number: number) => {
 	return (Math.random() - Math.random()) * number;
 };
 
-/**
- *
- * @param {Number} number
- * @return {Number}
- */
 export const randHalt = (number: number) => {
 	var rand = Math.random() - Math.random();
 	var res;
@@ -34,62 +19,72 @@ export const randHalt = (number: number) => {
 	}
 	return Math.abs(res);
 };
-/**
- *
- * @param {Number} low
- * @param {Number} high
- * @return {Number}
- */
+
 export const randInt = (low: number, high: number) => {
 	return low + Math.floor(Math.random() * (high - low + 1));
 };
 
-/**
- *
- * @param {Number} low
- * @param {Number} high
- * @return {Number}
- */
 export const randFloat = (low: number, high: number) => {
 	return low + Math.random() * (high - low);
 };
-/**
- *
- * @param {Number} degrees
- * @return {Number}
- */
+
 export const degToRad = (degrees: number) => {
 	return degrees * DEG2RAD;
 };
 
-/**
- *
- * @param {Number} degrees
- * @return {Number}
- */
 export const radToDeg = (radians: number) => {
 	return radians * RAD2DEG;
 };
 
-/**
- *
- * @param {Number} cx
- * @param {Number} cy
- * @param {Number} ex
- * @param {Number} ey
- * @returns {Number}
- */
+export const clamp = (value: number, min: number, max: number) => {
+	const result = Math.max(min, Math.min(max, value));
+	return Number.isFinite(result) ? result : 0;
+};
+
+export const degBetweenPoints360 = (cx: number, cy: number, ex: number, ey: number) => {
+	let theta = degBetweenPoints(cx, cy, ex, ey); // range (-180, 180]
+	if (theta < 0) theta = 360 + theta; // range [0, 360)
+	return Number.isFinite(theta) ? theta : 0;
+};
+
+export const degBetweenPoints = (cx: number, cy: number, ex: number, ey: number) => {
+	const dy = ey - cy;
+	const dx = ex - cx;
+	let theta = Math.atan2(dy, dx); // range (-PI, PI]
+	theta *= 180 / Math.PI; // rads to degs, range (-180, 180]
+	return Number.isFinite(theta) ? theta : 0;
+};
+
 export const angleBetweenPoints = (cx: number, cy: number, ex: number, ey: number) => {
-	var dy = ey - cy;
-	var dx = ex - cx;
-	var theta = Math.atan2(dy, dx); // range (-PI, PI]
+	const dy = ey - cy;
+	const dx = ex - cx;
+	let theta = Math.atan2(dy, dx); // range (-PI, PI]
 	theta *= 180 / Math.PI; // rads to degs, range (-180, 180]
-	return theta;
+	return Number.isFinite(theta) ? theta : 0;
+};
+
+export const distance2Point = (x1: number, y1: number, x2: number, y2: number) => {
+	const dist = Math.sqrt(Math.pow(x1 - x2, 2) + Math.pow(y1 - y2, 2));
+	return Number.isFinite(dist) ? dist : 0;
 };
 
 import { diffDate } from "./diffDate";
 import { positiveNumber } from "./positiveNumber";
 
-const xmath = { rand, randRound, randHalt, randInt, randFloat, degToRad, radToDeg, angleBetweenPoints, diffDate, positiveNumber };
+const xmath = {
+	rand,
+	randRound,
+	randHalt,
+	randInt,
+	randFloat,
+	degToRad,
+	radToDeg,
+	degBetweenPoints360,
+	degBetweenPoints,
+	angleBetweenPoints,
+	distance2Point,
+	diffDate,
+	positiveNumber,
+};
 
 export default xmath;

package/src/math/positiveNumber.ts

@@ -8,3 +8,5 @@ export function positiveNumber(number: number) {
 
 	return number;
 }
+
+export default positiveNumber;

package/src/object.ts

@@ -48,18 +48,6 @@ export const objectToArray = (obj: { [key: string]: any }) => {
 	return array;
 };
 
-/**
- * Iterate through every keys & values of the object
- */
-export const iterate = (obj: { [key: string]: any }, callbackFn: (obj: any, key?: string, value?: any) => any) => {
-	Object.keys(obj).forEach((key) => {
-		const val = obj[key];
-		callbackFn(obj, key, val);
-		if (typeof val === "object" && val !== null) iterate(val, callbackFn);
-	});
-	return obj;
-};
-
 const xobject = {
 	isNull,
 	toBool,
@@ -67,6 +55,5 @@ const xobject = {
 	toFloat,
 	toArray,
 	objectToArray,
-	iterate,
 };
 export default xobject;

package/src/permission/requestCamera.ts

@@ -1,4 +1,4 @@
-const requestCamera = ({ audio = true, video = true }) => {
+export const requestCamera = ({ audio = true, video = true }) => {
 	if (typeof window == "undefined") return false;
 
 	return new Promise((resolve, reject) => {
@@ -40,4 +40,4 @@ const requestCamera = ({ audio = true, video = true }) => {
 	});
 };
 
-export { requestCamera };
+export default requestCamera;

package/src/permission/requestDeviceOrientationControl.ts

@@ -1,6 +1,6 @@
 import { isAndroid } from "../device";
 
-const requestDeviceOrientationControl = () => {
+export const requestDeviceOrientationControl = () => {
 	if (typeof window == "undefined") return false;
 	return new Promise((resolve, reject) => {
 		if (isAndroid()) resolve(true);
@@ -30,4 +30,4 @@ const requestDeviceOrientationControl = () => {
 	});
 };
 
-export { requestDeviceOrientationControl };
+export default requestDeviceOrientationControl;

package/src/string/formatNumber.ts

@@ -8,3 +8,5 @@ export function formatNumber(num: number, prefix = "$") {
 	const numRound = Math.round((toInt(num) + Number.EPSILON) * 100) / 100;
 	return Number.isNaN(numRound) ? "0" : "" + numRound.toString().replace(/(\d)(?=(\d{3})+(?!\d))/g, prefix + "1,");
 }
+
+export default formatNumber;

package/src/string/generatePassword.ts

@@ -14,3 +14,5 @@ export function generatePassword(length = 6, hard = true) {
 	if (hard) pass = pass.replace(pass[Math.floor(pass.length / 2)], randomStringByLength(1, punctuation));
 	return pass;
 }
+
+export default generatePassword;

package/src/string/generateUUID.ts

@@ -33,3 +33,5 @@ export function generateUUID() {
 	// .toLowerCase() here flattens concatenated strings to save heap memory space.
 	return uuid.toLowerCase();
 }
+
+export default generateUUID;

package/src/string/index.ts

@@ -144,7 +144,6 @@ export const clearUnicodeCharacters = (s: string, opt: { [key: string]: any } =
 	return opt.lowercase ? s.toLowerCase() : s;
 };
 
-import { makeDaySlug } from "./makeDaySlug";
 import { generateUUID } from "./generateUUID";
 import { randAllCharacterByLength, randomStringByLength } from "./random";
 import { formatNumber } from "./formatNumber";
@@ -155,7 +154,6 @@ import { addQueryParam, getUrlParams, isLink, getFileNameWithoutExtension, getFi
 const xstring = {
 	getBetween,
 	makeString,
-	makeDaySlug,
 	toUpperCase,
 	toLowerCase,
 	titleize,

package/src/string/trimNull.ts

@@ -12,3 +12,5 @@ export function trimNull(str: string) {
 
 	return str;
 }
+
+export default trimNull;

package/dist/string/makeDaySlug.d.ts

@@ -1,31 +0,0 @@
-declare type DaySlugOptions = {
-    /**
-     * @default ""
-     */
-    prefix?: string;
-    /**
-     * @default ""
-     */
-    surfix?: string;
-    /**
-     * @default true
-     */
-    useDate?: boolean;
-    /**
-     * @default true
-     */
-    useTime?: boolean;
-    /**
-     * @default "-"
-     */
-    divider?: string;
-};
-/**
- * Format the input number with commas
- * @example 1000000 -> 1,000,000
- */
-export declare function makeDaySlug(options?: DaySlugOptions): string;
-declare const _default: {
-    makeDaySlug: typeof makeDaySlug;
-};
-export default _default;

package/dist/string/makeDaySlug.js

@@ -1,23 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeDaySlug = void 0;
-const dayjs_1 = __importDefault(require("dayjs"));
-/**
- * Format the input number with commas
- * @example 1000000 -> 1,000,000
- */
-function makeDaySlug(options = {}) {
-    const { prefix = "", surfix = "", divider = "-", useDate = true, useTime = true } = options;
-    let mainStr = "";
-    if (useDate)
-        mainStr += (0, dayjs_1.default)().format(`YYYY${divider}MM${divider}DD`);
-    if (useTime)
-        mainStr += (mainStr == "" ? "" : divider) + (0, dayjs_1.default)().format(`HH${divider}mm${divider}ss`);
-    return prefix + (prefix ? divider : "") + mainStr + (surfix ? divider : "") + surfix;
-}
-exports.makeDaySlug = makeDaySlug;
-exports.default = { makeDaySlug };
-//# sourceMappingURL=makeDaySlug.js.map

package/dist/string/makeDaySlug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeDaySlug.js","sourceRoot":"","sources":["../../src/string/makeDaySlug.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAyB1B;;;GAGG;AACH,SAAgB,WAAW,CAAC,UAA0B,EAAE;IACvD,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE5F,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO;QAAE,OAAO,IAAI,IAAA,eAAK,GAAE,CAAC,MAAM,CAAC,OAAO,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC;IACvE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,IAAA,eAAK,GAAE,CAAC,MAAM,CAAC,KAAK,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC;IAEtG,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;AACtF,CAAC;AARD,kCAQC;AAED,kBAAe,EAAE,WAAW,EAAE,CAAC"}

package/esm/string/makeDaySlug.d.ts

@@ -1,31 +0,0 @@
-declare type DaySlugOptions = {
-    /**
-     * @default ""
-     */
-    prefix?: string;
-    /**
-     * @default ""
-     */
-    surfix?: string;
-    /**
-     * @default true
-     */
-    useDate?: boolean;
-    /**
-     * @default true
-     */
-    useTime?: boolean;
-    /**
-     * @default "-"
-     */
-    divider?: string;
-};
-/**
- * Format the input number with commas
- * @example 1000000 -> 1,000,000
- */
-export declare function makeDaySlug(options?: DaySlugOptions): string;
-declare const _default: {
-    makeDaySlug: typeof makeDaySlug;
-};
-export default _default;

package/esm/string/makeDaySlug.js

@@ -1,16 +0,0 @@
-import dayjs from "dayjs";
-/**
- * Format the input number with commas
- * @example 1000000 -> 1,000,000
- */
-export function makeDaySlug(options = {}) {
-    const { prefix = "", surfix = "", divider = "-", useDate = true, useTime = true } = options;
-    let mainStr = "";
-    if (useDate)
-        mainStr += dayjs().format(`YYYY${divider}MM${divider}DD`);
-    if (useTime)
-        mainStr += (mainStr == "" ? "" : divider) + dayjs().format(`HH${divider}mm${divider}ss`);
-    return prefix + (prefix ? divider : "") + mainStr + (surfix ? divider : "") + surfix;
-}
-export default { makeDaySlug };
-//# sourceMappingURL=makeDaySlug.js.map

package/esm/string/makeDaySlug.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeDaySlug.js","sourceRoot":"","sources":["../../src/string/makeDaySlug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAyB1B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,UAA0B,EAAE;IACvD,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE5F,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,OAAO;QAAE,OAAO,IAAI,KAAK,EAAE,CAAC,MAAM,CAAC,OAAO,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC;IACvE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC;IAEtG,OAAO,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;AACtF,CAAC;AAED,eAAe,EAAE,WAAW,EAAE,CAAC"}

package/src/string/makeDaySlug.ts

@@ -1,40 +0,0 @@
-import dayjs from "dayjs";
-
-type DaySlugOptions = {
-	/**
-	 * @default ""
-	 */
-	prefix?: string;
-	/**
-	 * @default ""
-	 */
-	surfix?: string;
-	/**
-	 * @default true
-	 */
-	useDate?: boolean;
-	/**
-	 * @default true
-	 */
-	useTime?: boolean;
-	/**
-	 * @default "-"
-	 */
-	divider?: string;
-};
-
-/**
- * Format the input number with commas
- * @example 1000000 -> 1,000,000
- */
-export function makeDaySlug(options: DaySlugOptions = {}) {
-	const { prefix = "", surfix = "", divider = "-", useDate = true, useTime = true } = options;
-
-	let mainStr = "";
-	if (useDate) mainStr += dayjs().format(`YYYY${divider}MM${divider}DD`);
-	if (useTime) mainStr += (mainStr == "" ? "" : divider) + dayjs().format(`HH${divider}mm${divider}ss`);
-
-	return prefix + (prefix ? divider : "") + mainStr + (surfix ? divider : "") + surfix;
-}
-
-export default { makeDaySlug };