@hkdigital/lib-core 0.3.10 → 0.3.11

package/dist/util/is/index.js

@@ -1,147 +1,147 @@
-/** Internals */
-
-//
-// @see https://developer.mozilla.org/
-//    en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction
-//
-const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
-const objectToString = Object.prototype.toString;
-
-/** Exports */
-
-/**
- * Check if a value looks like an array
- *
- * @param {any} item - Item to check
- *
- * @return {boolean} true if the value looks like an array
- */
-export function arrayLike(item) {
-	if (!(item instanceof Object)) {
-		return false;
-	}
-
-	if ('length' in item) {
-		return true;
-	}
-
-	return false;
-}
-
-/**
- * Check if a value is an Arguments object
- *
- * @param {any} value
- *
- * @returns {boolean} true if the value is an Arguments object
- */
-function argumentsCheck(value) {
-	return objectToString.call(value) === '[object Arguments]';
-}
-export { argumentsCheck as arguments };
-
-/**
- * Check if a value is an array that only contains primitives
- * - A primitive is a not-object value
- *
- * @param {any} value - value to check
- *
- * @return {boolean} true if the value is an array of primitives
- */
-export function arrayOfPrimitives(value) {
-	if (!Array.isArray(value)) {
-		return false;
-	}
-
-	for (let j = 0, n = value.length; j < n; j = j + 1) {
-		if (value[j] instanceof Object) {
-			// current value is not a primitive
-			return false;
-		}
-	}
-
-	return true;
-}
-
-/**
- * Check if the supplied value is async iterable
- * - Aync iterable objects must implement the "@@asyncIterator" method
- *
- * @param {any} value
- *
- * @returns {boolean} true if the value is async iterable
- */
-export function asyncIterator(value) {
-	if (
-		!(value instanceof Object) ||
-		typeof value[Symbol.asyncIterator] !== 'function'
-	) {
-		return false;
-	}
-
-	return true;
-}
-
-/**
- * Check if the supplied value is an async function
- * - Returns true for functions declared as "async function" or
- *   async () => {}
- *
- * @warning this function does not return [true] for (sync) functions that
- *   return a promise.
- *
- * @param {any} value
- *
- * @returns {boolean} true if the value is an async function
- */
-export function asyncFunction(value) {
-	if (value instanceof AsyncFunction) {
-		return true;
-	}
-
-	return false;
-}
-
-/**
- * Check if the supplied value is iterable
- * - Iterable objects must implement the "@@iterator" method
- * - Generators are also iterable
- *
- * @param {any} value
- *
- * @returns {boolean} true if the value is (not async) iterable
- */
-export function iterable(value) {
-	if (
-		!(value instanceof Object) ||
-		typeof value[Symbol.iterator] !== 'function'
-	) {
-		return false;
-	}
-
-	return true;
-}
-
-/**
- * Check if the supplied value is an object bu not a promise
- * - Promises return false
- * - Arrays return true
- *
- * @param {any} value
- *
- * @returns {boolean} true if the value is an Object, but not a Promise
- */
-export function object(value) {
-	if (!(value instanceof Object)) {
-		if (value && typeof value === 'object') {
-			// e.g. obj = Object.create(null);
-			return true;
-		}
-
-		return false;
-	} else if (value instanceof Promise) {
-		return false;
-	}
-
-	return true;
-}
+/** Internals */
+
+//
+// @see https://developer.mozilla.org/
+//    en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction
+//
+const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
+const objectToString = Object.prototype.toString;
+
+/** Exports */
+
+/**
+ * Check if a value looks like an array
+ *
+ * @param {any} item - Item to check
+ *
+ * @return {boolean} true if the value looks like an array
+ */
+export function arrayLike(item) {
+	if (!(item instanceof Object)) {
+		return false;
+	}
+
+	if ('length' in item) {
+		return true;
+	}
+
+	return false;
+}
+
+/**
+ * Check if a value is an Arguments object
+ *
+ * @param {any} value
+ *
+ * @returns {boolean} true if the value is an Arguments object
+ */
+function argumentsCheck(value) {
+	return objectToString.call(value) === '[object Arguments]';
+}
+export { argumentsCheck as arguments };
+
+/**
+ * Check if a value is an array that only contains primitives
+ * - A primitive is a not-object value
+ *
+ * @param {any} value - value to check
+ *
+ * @return {boolean} true if the value is an array of primitives
+ */
+export function arrayOfPrimitives(value) {
+	if (!Array.isArray(value)) {
+		return false;
+	}
+
+	for (let j = 0, n = value.length; j < n; j = j + 1) {
+		if (value[j] instanceof Object) {
+			// current value is not a primitive
+			return false;
+		}
+	}
+
+	return true;
+}
+
+/**
+ * Check if the supplied value is async iterable
+ * - Aync iterable objects must implement the "@@asyncIterator" method
+ *
+ * @param {any} value
+ *
+ * @returns {boolean} true if the value is async iterable
+ */
+export function asyncIterator(value) {
+	if (
+		!(value instanceof Object) ||
+		typeof value[Symbol.asyncIterator] !== 'function'
+	) {
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Check if the supplied value is an async function
+ * - Returns true for functions declared as "async function" or
+ *   async () => {}
+ *
+ * @warning this function does not return [true] for (sync) functions that
+ *   return a promise.
+ *
+ * @param {any} value
+ *
+ * @returns {boolean} true if the value is an async function
+ */
+export function asyncFunction(value) {
+	if (value instanceof AsyncFunction) {
+		return true;
+	}
+
+	return false;
+}
+
+/**
+ * Check if the supplied value is iterable
+ * - Iterable objects must implement the "@@iterator" method
+ * - Generators are also iterable
+ *
+ * @param {any} value
+ *
+ * @returns {boolean} true if the value is (not async) iterable
+ */
+export function iterable(value) {
+	if (
+		!(value instanceof Object) ||
+		typeof value[Symbol.iterator] !== 'function'
+	) {
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Check if the supplied value is an object bu not a promise
+ * - Promises return false
+ * - Arrays return true
+ *
+ * @param {any} value
+ *
+ * @returns {boolean} true if the value is an Object, but not a Promise
+ */
+export function object(value) {
+	if (!(value instanceof Object)) {
+		if (value && typeof value === 'object') {
+			// e.g. obj = Object.create(null);
+			return true;
+		}
+
+		return false;
+	} else if (value instanceof Promise) {
+		return false;
+	}
+
+	return true;
+}

package/dist/util/iterate/index.d.ts

@@ -61,11 +61,11 @@ export function iterateObjectEntries(obj: object, options?: {
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions & { depthFirst: boolean}} [options]
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<string[]>} iterable object that yields path arrays
  */
 export function iterateObjectPaths(obj: object, options?: IterableTreeOptions & {
     depthFirst: boolean;
-}): Iterator<any, any, any>;
+}): Iterable<string[]>;
 /**
  * Get an Iterator object that can be used to iterate over all values in
  * the object (at the leaves of the object tree)
@@ -73,9 +73,9 @@ export function iterateObjectPaths(obj: object, options?: IterableTreeOptions &
  * @param {object} obj - Object to iterate
  * @param {IterableTreeOptions} [options] - Iteration options
  *
- * @return {Iterator} iterator object
+ * @return {Iterable<any>} iterator object
  */
-export function iterateObjectValues(obj: object, options?: IterableTreeOptions): Iterator<any, any, any>;
+export function iterateObjectValues(obj: object, options?: IterableTreeOptions): Iterable<any>;
 /**
  * Get a list of objects returned by an iterator in sorted order
  *