feat: add "valuesBy" method

Author: luckasnix

docs/object-graph.doc.md

@@ -129,6 +129,10 @@ Returns a list of unique values for a specified property across selected nodes i
 | propertyKey | `keyof NodeValue` | - | __Required.__ The property key of the node values to return from the object graph. |
 | nodeKeys | `Array<string>` | - | The array of nodes keys to define the selected nodes. |
 
+### valuesBy()
+
+Returns all values grouped by property.
+
 ### match()
 
 Returns all nodes that match with the provided shape.

package-lock.json

@@ -2,7 +2,7 @@
   "name": "@kasnix/structured-objects",
   "description": "A lightweight and powerful library for manipulating objects in JavaScript and TypeScript across different types of data structures.",
   "author": "Kasnix",
-  "version": "1.5.2",
+  "version": "1.6.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/luckasnix/structured-objects.git"

package.json

@@ -209,6 +209,25 @@ export class ObjectGraph<NodeValue extends Record<string, unknown>> {
     return Array.from(propertyValues);
   }
 
+  /**
+   * @description Returns all values grouped by property.
+   * @since 1.6.0
+   */
+  public valuesBy(): Record<string, Array<unknown>> {
+    const valuesByProperty: Record<string, Array<unknown>> = {};
+    for (const [_, nodeValue] of this.nodes) {
+      for (const [nodeValueKey, nodeValueValue] of Object.entries(nodeValue)) {
+        if (!valuesByProperty[nodeValueKey]) {
+          valuesByProperty[nodeValueKey] = [];
+        }
+        if (!valuesByProperty[nodeValueKey].includes(nodeValueValue)) {
+          valuesByProperty[nodeValueKey].push(nodeValueValue);
+        }
+      }
+    }
+    return valuesByProperty;
+  }
+
   /**
    * @description Returns all nodes that match with the provided shape.
    * @since 1.0.0

src/object-graph.ts

@@ -291,6 +291,23 @@ describe("valuesOf()", () => {
   });
 });
 
+describe("valuesBy()", () => {
+  test("gets all values grouped by property", () => {
+    const shirtsGraph = new ObjectGraph<Shirt>(
+      shirtsMock,
+      (shirt) => shirt.sku,
+    );
+
+    const valuesByProperty = shirtsGraph.valuesBy();
+
+    expect(valuesByProperty).toEqual({
+      sku: ["1", "2", "3", "4", "5", "6", "7", "8"],
+      color: ["red", "yellow", "green", "blue"],
+      size: ["small", "medium", "large"],
+    });
+  });
+});
+
 describe("match()", () => {
   test("gets all nodes that match the provided shape", () => {
     const colorsToMatch: Color[] = ["red", "blue"];