@creejs/commons-lang 2.1.10 → 2.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creejs/commons-lang",
-  "version": "2.1.10",
+  "version": "2.1.12",
   "description": "Commons Utils About Language, used inside creejs",
   "keywords": [
     "commons",

package/types/array-utils.d.ts

@@ -0,0 +1,39 @@
+declare namespace _default {
+    export { first };
+    export { last };
+    export { equals };
+    export { equalsIgnoreOrder };
+}
+export default _default;
+/**
+ * Gets the first element of an array
+ * @param {any[]} arr - The input array
+ * @param {any} [defaultValue] - The value to return if the array is empty or first element is undefined/null.
+ * @returns {any} The first element of the array, or the defaultValue if the array is empty or not an array.
+ * @throws {Error} if arr is not an array
+ */
+export function first(arr: any[], defaultValue?: any): any;
+/**
+ * Gets the last element of an array
+ * @param {any[]} arr - The input array
+ * @param {any} [defaultValue] - The value to return if the array is empty or last element is undefined/null
+ * @returns {any} The last element of the array or the defaultValue
+ * @throws {Error} if arr is not an array
+ */
+export function last(arr: any[], defaultValue?: any): any;
+/**
+ * Checks if two arrays are equal by order
+ * @param {any[]} arr1 - first array to compare
+ * @param {any[]} arr2 - Second array to compare
+ * @param {(a:any, b:any) => 0|1|-1} [compareFn]
+ * @returns {boolean} True if arrays have same elements (order-independent), false otherwise
+ */
+export function equals(arr1: any[], arr2: any[], compareFn?: (a: any, b: any) => 0 | 1 | -1): boolean;
+/**
+ * Checks if two arrays are equal ignoring element order
+ * @param {any[]} arr1 - first array to compare
+ * @param {any[]} arr2 - Second array to compare
+ * @param {(a:any, b:any) => 0|1|-1} [compareFn]
+ * @returns {boolean} True if arrays have same elements (order-independent), false otherwise
+ */
+export function equalsIgnoreOrder(arr1: any[], arr2: any[], compareFn?: (a: any, b: any) => 0 | 1 | -1): boolean;

package/types/index.d.ts

@@ -13,6 +13,8 @@ declare namespace _default {
     export { ReflectUtils };
     export { TypedArrayUtils };
     export { ArrayBufferUtils };
+    export { TimeUtils };
+    export { ArrayUtils };
 }
 export default _default;
 import LangUtils from './lang-utils.js';
@@ -26,4 +28,6 @@ import InstanceProxyUtils from './instance-proxy-utils.js';
 import ReflectUtils from './reflect-utils.js';
 import TypedArrayUtils from './typed-array-utils.js';
 import ArrayBufferUtils from './array-buffer-utils.js';
-export { LangUtils, StringUtils, TypeUtils, TypeAssert, ExecUtils, PromiseUtils, LangUtils as Lang, TypeUtils as Type, ExecUtils as Exec, ClassProxyUtils, InstanceProxyUtils, ReflectUtils, TypedArrayUtils, ArrayBufferUtils };
+import TimeUtils from './time-utils.js';
+import ArrayUtils from './array-utils.js';
+export { LangUtils, StringUtils, TypeUtils, TypeAssert, ExecUtils, PromiseUtils, LangUtils as Lang, TypeUtils as Type, ExecUtils as Exec, ClassProxyUtils, InstanceProxyUtils, ReflectUtils, TypedArrayUtils, ArrayBufferUtils, TimeUtils, ArrayUtils };

package/types/time-utils.d.ts

@@ -0,0 +1,46 @@
+declare namespace _default {
+    export { s2ns };
+    export { ms2ns };
+    export { timestamp64 };
+    export { lapseNano };
+    export { lapseMillis };
+    export { timeoutNano };
+    export { timeoutMillis };
+}
+export default _default;
+export const s2ns: 1000000000;
+export const ms2ns: 1000000;
+/**
+ * Gets the current timestamp in nanoseconds (if running in Node.js) or milliseconds (in browser).
+ * Uses `process.hrtime.bigint()` for high-resolution timestamps in Node.js, falls back to `Date.now()` in browsers.
+ * @returns {bigint} Current timestamp as a BigInt
+ */
+export function timestamp64(): bigint;
+/**
+ * Calculates the time elapsed in nanoseconds between the given timestamp and now.
+ * @param {bigint} start - start timestamp64, in nanoseconds.
+ * @param {bigint} [end] - end timestamp64, in nanoseconds. If not provided, uses current timestamp64.
+ * @returns {bigint} The elapsed time in nanoseconds (current timestamp64 - ts64).
+ */
+export function lapseNano(start: bigint, end?: bigint): bigint;
+/**
+ * Calculates the time elapsed in milliseconds between the given timestamp and now.
+ * @param {bigint} start - start The timestamp in 64-bit format.
+ * @param {bigint} [end] - end timestamp64, in nanoseconds. If not provided, uses current timestamp64.
+ * @returns {bigint} The elapsed time in milliseconds.
+ */
+export function lapseMillis(start: bigint, end?: bigint): bigint;
+/**
+ * compare current timestamp64 against the given ts64, and check if the elapsed time exceeds the specified timeout.
+ * @param {bigint} nanoTimestamp64 - The timestamp to compare against (in nanoseconds).
+ * @param {bigint|number} nanoTimeout - The timeout threshold (in nanoseconds).
+ * @returns {boolean} True if elapsed time exceeds timeout, false otherwise.
+ */
+export function timeoutNano(nanoTimestamp64: bigint, nanoTimeout: bigint | number): boolean;
+/**
+ * compare current timestamp64 against the given ts64, and check if the elapsed time exceeds the specified timeout.
+ * @param {bigint} nanoTimestamp64 - The timestamp to compare against (in nanoseconds).
+ * @param {bigint|number} millisTimeout - The timeout threshold (in milliseconds).
+ * @returns {boolean} True if elapsed time exceeds timeout, false otherwise.
+ */
+export function timeoutMillis(nanoTimestamp64: bigint, millisTimeout: bigint | number): boolean;