@soundworks/core 5.0.3 → 5.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soundworks/core",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "description": "Open-source creative coding framework for distributed applications based on Web technologies",
   "collaborators": [
     "Benjamin Matuszewski",

package/src/common/SharedStateCollection.js

@@ -471,6 +471,30 @@ class SharedStateCollection {
     return this.#states.find(func);
   }
 
+  /**
+   * Execute a user-supplied "reducer" callback function on each element of the collection,
+   * in order, passing in the return value from the calculation on the preceding element.
+   * The final result of running the reducer across all elements of the array is a single value.
+   *
+   * @template T
+   * @param {Function} func - A function to execute for each element in the array.
+   *  Its return value becomes the value of the accumulator parameter on the next
+   *  invocation of callbackFn. For the last invocation, the return value becomes
+   *  the return value of reduce(). The function is called with the following arguments:
+   * @param {T} initialValue - A value to which accumulator is initialized the first
+   *  time the callback is called. If initialValue is specified, callbackFn starts
+   *  executing with the first value in the array as currentValue.
+   * @return {T}
+   */
+  reduce(func, initialValue) {
+    // compared to the native Array.reduce method, initial Value is mandatory
+    if (arguments.length < 0) {
+      throw new Error(`Cannot execute 'reduce' on 'SharedStateCollection: argument 2 is not defined`);
+    }
+
+    return this.#states.reduce(func, initialValue);
+  }
+
   /**
    * Iterable API, e.g. for use in `for .. of` loops
    */

package/src/common/version.js

@@ -1,2 +1,2 @@
 // [WARNING] This file is generated, do not edit
-export default '5.0.3';
+export default '5.1.0';

package/types/common/SharedStateCollection.d.ts

@@ -296,6 +296,22 @@ declare class SharedStateCollection {
      * @return {}
      */
     find(func: Function): any;
+    /**
+     * Execute a user-supplied "reducer" callback function on each element of the collection,
+     * in order, passing in the return value from the calculation on the preceding element.
+     * The final result of running the reducer across all elements of the array is a single value.
+     *
+     * @template T
+     * @param {Function} func - A function to execute for each element in the array.
+     *  Its return value becomes the value of the accumulator parameter on the next
+     *  invocation of callbackFn. For the last invocation, the return value becomes
+     *  the return value of reduce(). The function is called with the following arguments:
+     * @param {T} initialValue - A value to which accumulator is initialized the first
+     *  time the callback is called. If initialValue is specified, callbackFn starts
+     *  executing with the first value in the array as currentValue.
+     * @return {T}
+     */
+    reduce<T>(func: Function, initialValue: T, ...args: any[]): T;
     /** @private */
     private [kSharedStateCollectionInit];
     /**

package/types/common/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "5.0.3";
+declare const _default: "5.1.0";
 export default _default;