@creejs/commons-lang 2.1.30 → 2.1.32

package/dist/cjs/index-dev.cjs

@@ -166,6 +166,7 @@ class AggregatedError extends Error {
  */
 
 var LangUtils = {
+  get,
   constructorName,
   defaults,
   extend,
@@ -177,6 +178,31 @@ var LangUtils = {
   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.
@@ -763,7 +789,8 @@ var TypeAssert = {
   assertBigInt64Array,
   assertBigUint64Array,
   assertTypedArray,
-  assertArrayBuffer
+  assertArrayBuffer,
+  assertIterable
 };
 /**
    * if value is not Array, throw error
@@ -1129,6 +1156,18 @@ function assertArrayBuffer (value, paramName) {
   }
 }
 
+/**
+ * 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
@@ -2799,6 +2838,35 @@ function chunk (array, size) {
   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.
@@ -2822,7 +2890,8 @@ var index = {
   TypedArrayUtils,
   ArrayBufferUtils,
   TimeUtils,
-  ArrayUtils
+  ArrayUtils,
+  IteratorUtils
 };
 
 exports.AggregatedError = AggregatedError;
@@ -2832,6 +2901,7 @@ exports.ClassProxyUtils = ClassProxyUtils;
 exports.Exec = ExecUtils;
 exports.ExecUtils = ExecUtils;
 exports.InstanceProxyUtils = InstanceProxyUtils;
+exports.IteratorUtils = IteratorUtils;
 exports.Lang = LangUtils;
 exports.LangUtils = LangUtils;
 exports.PromiseUtils = PromiseUtils;