@creejs/commons-lang 2.1.30 → 2.1.32

package/dist/umd/index.dev.js

@@ -168,6 +168,7 @@
    */
 
   var LangUtils = {
+    get,
     constructorName,
     defaults,
     extend,
@@ -179,6 +180,31 @@
     deepCloneToPlainObject
   };
 
+  /**
+   *
+   * @param {{[key:string]:any}} obj
+   * @param {string} path
+   * @param {any} [defaultValue]
+   * @returns
+   */
+  function get (obj, path, defaultValue) {
+    if (obj == null) {
+      return defaultValue
+    }
+    if (typeof path !== 'string') {
+      throw new Error('"path" must be a string')
+    }
+    const pathArray = path.split('.');
+    let current = obj;
+    for (const key of pathArray) {
+      if (current[key] === undefined) {
+        return defaultValue
+      }
+      current = current[key];
+    }
+    return current
+  }
+
   /**
    * Gets the constructor name of a value.
    * @param {*} value - The value to check.
@@ -765,7 +791,8 @@
     assertBigInt64Array,
     assertBigUint64Array,
     assertTypedArray,
-    assertArrayBuffer
+    assertArrayBuffer,
+    assertIterable
   };
   /**
      * if value is not Array, throw error
@@ -1131,6 +1158,18 @@
     }
   }
 
+  /**
+   * Asserts that the given value is Iterable
+   * @param {*} value - The value to check.
+   * @param {string} [paramName] - Optional parameter name for error message.
+   * @throws {Error} Throws an error if the value is not Iterable
+   */
+  function assertIterable (value, paramName) {
+    if (!isIterable(value)) {
+      throw new Error(`${paramName ? '"' + paramName + '" ' : ''}Not Iterable`)
+    }
+  }
+
   // 3rd
   // internal
   // owned
@@ -2801,6 +2840,35 @@
     return chunked
   }
 
+  // owned
+
+  /**
+   * @template T
+   * @param {Iterable<T>} iterable
+   */
+  function length (iterable) {
+    TypeAssert.assertIterable(iterable);
+    // @ts-ignore
+    if (typeof iterable.length !== 'undefined') {
+      // @ts-ignore
+      return iterable.length
+      // @ts-ignore
+    } else if (typeof iterable.size !== 'undefined') {
+      // @ts-ignore
+      return iterable.size
+    }
+    let counter = 0;
+    // eslint-disable-next-line no-unused-vars
+    for (const _item of iterable) {
+      counter++;
+    }
+    return counter
+  }
+
+  var IteratorUtils = {
+    length
+  };
+
   /**
    * @module Lang
    * @description Core language utilities for type checking, string manipulation, and common operations.
@@ -2824,7 +2892,8 @@
     TypedArrayUtils,
     ArrayBufferUtils,
     TimeUtils,
-    ArrayUtils
+    ArrayUtils,
+    IteratorUtils
   };
 
   exports.AggregatedError = AggregatedError;
@@ -2834,6 +2903,7 @@
   exports.Exec = ExecUtils;
   exports.ExecUtils = ExecUtils;
   exports.InstanceProxyUtils = InstanceProxyUtils;
+  exports.IteratorUtils = IteratorUtils;
   exports.Lang = LangUtils;
   exports.LangUtils = LangUtils;
   exports.PromiseUtils = PromiseUtils;