@creejs/commons-lang 2.1.24 → 2.1.26

package/package.json

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

package/types/lang-utils.d.ts

@@ -6,17 +6,17 @@
 export function constructorName(value: any): string | undefined;
 /**
  * Assigns default values from source objects to target object for undefined properties.
- * @param {Object<string, any>} target - The target object to assign defaults to
- * @param {...Object<string, any>} sources - Source objects containing default values
- * @returns {Object<string, any>} The modified target object with defaults applied
- * @throws {TypeError} If target is null or undefined
+ * 1. No Deep-Copy, only first level properties are assigned.
+ * @param {{[key:string]:any}} target - The target object to assign defaults to
+ * @param {...{[key:string]:any}|undefined} sources - Source objects containing default values
+ * @returns {{[key:string]:any}} The modified target object with defaults applied
  */
 export function defaults(target: {
-    [x: string]: any;
-}, ...sources: {
-    [x: string]: any;
-}[]): {
-    [x: string]: any;
+    [key: string]: any;
+}, ...sources: ({
+    [key: string]: any;
+} | undefined)[]): {
+    [key: string]: any;
 };
 /**
  * Extends a target object with properties from one or more source objects.

package/types/promise-utils.d.ts

@@ -120,6 +120,9 @@ export function parallelAllSettled(tasks: Function[], maxParallel?: number): Pro
  * 2. Maybe multiple tasks are executed as a bulk block, and all of them resolved.
  *    * only the first fulfilled value is returned
  *    * other results are dropped
+ * 3. Notice:
+ *    * In Beginning, we start bulk(maxParallel) of tasks
+ *    * One task failed, it will start next task immediately, Not Wait for the bulk(maxParallel) to complete
  * @param {Array<Function|Promise<any>>} tasks - Array of async functions to execute
  * @param {number} [maxParallel=5] - Maximum number of tasks to run in parallel
  * @returns {Promise<any>} Resolves with the result of the first successfully completed task

package/types/string-utils.d.ts

@@ -8,9 +8,11 @@ export function isEmpty(str: string): boolean;
 /**
  * Asserts that the given string is not empty.
  * @param {string} str - The string to check.
+ * @param {string} [paramName]
+ *
  * @throws {Error} Throws an error if the string is empty.
  */
-export function assertNotEmpty(str: string): void;
+export function assertNotEmpty(str: string, paramName?: string): void;
 /**
  * Checks if a string is null, undefined, or consists only of whitespace.
  * @param {string} str - The string to check.
@@ -21,9 +23,10 @@ export function isBlank(str: string): boolean;
 /**
  * Asserts that the given string is not blank.
  * @param {string} str - The string to check.
+ * @param {string} [paramName]
  * @throws {Error} Throws an error if the string is blank.
  */
-export function assertNotBlank(str: string): void;
+export function assertNotBlank(str: string, paramName?: string): void;
 /**
  * Capitalizes the first character of a string.
  * @param {string} str - The string to capitalize.

package/types/time-utils.d.ts

@@ -1,6 +1,7 @@
 declare namespace _default {
     export { s2ns };
     export { ms2ns };
+    export { timestamp };
     export { timestamp64 };
     export { lapseNano };
     export { lapseMillis };
@@ -11,8 +12,16 @@ 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.
+ * Gets the current timestamp in milliseconds
+ * * If "performance" API is available, uses performance timeOrigin + now(), then convert to milliseconds
+ * * Else fall back to `Date.now()`
+ * @returns {number} Current timestamp in milliseconds
+ */
+export function timestamp(): number;
+/**
+ * Gets the current timestamp in nanoseconds
+ * * If "performance" API is available, uses performance timeOrigin + now()
+ * * Else fall back to `Date.now()` to get milliseconds and convert to nanoseconds
  * @returns {bigint} Current timestamp as a BigInt
  */
 export function timestamp64(): bigint;