@homebound/beam 2.231.1 → 2.232.0

package/dist/components/Table/components/Row.d.ts

@@ -65,5 +65,7 @@ export type GridDataRow<R extends Kinded> = {
     initSelected?: boolean;
     /** Whether row can be selected */
     selectable?: false;
+    /** Whether this row should infer its selected state based on its children's selected state */
+    inferSelectedState?: false;
 } & IfAny<R, {}, DiscriminateUnion<R, "kind", R["kind"]>>;
 export {};

package/dist/components/Table/utils/TableState.js

@@ -258,7 +258,8 @@ class TableState {
             (0, visitor_1.visit)([curr.row], (row) => this.matchedRows.has(row.id) && map.set(row.id, selected ? "checked" : "unchecked"));
             // Now walk up the parents and see if they are now-all-checked/now-all-unchecked/some-of-each
             for (const parent of [...curr.parents].reverse()) {
-                if (parent.children) {
+                // Only derive selected state of the parent row if `inferSelectedState` is not `false`
+                if (parent.children && parent.inferSelectedState !== false) {
                     map.set(parent.id, deriveParentSelected(this.getMatchedChildrenStates(parent.children, map)));
                 }
             }
@@ -327,14 +328,16 @@ class TableState {
         }
     }
     getMatchedChildrenStates(children, map) {
-        return children
+        const respectedChildren = children.flatMap(getChildrenForDerivingSelectState);
+        return respectedChildren
             .filter((row) => row.id !== "header" && this.matchedRows.has(row.id))
             .map((row) => map.get(row.id) || this.getSelected(row.id));
     }
     // Recursively traverse through rows to determine selected state of parent rows based on children
     setNestedSelectedStates(row, map) {
         if (this.matchedRows.has(row.id)) {
-            if (!row.children) {
+            // do not derive selected state if there are no children, or if `inferSelectedState` is set to false
+            if (!row.children || row.inferSelectedState === false) {
                 return [this.getSelected(row.id)];
             }
             const childrenSelectedStates = row.children.flatMap((rc) => this.setNestedSelectedStates(rc, map));
@@ -346,6 +349,13 @@ class TableState {
     }
 }
 exports.TableState = TableState;
+/** Returns the child rows needed for deriving the selected state of a parent/group row */
+function getChildrenForDerivingSelectState(row) {
+    if (row.children && row.inferSelectedState === false) {
+        return [row, ...row.children.flatMap(getChildrenForDerivingSelectState)];
+    }
+    return [row];
+}
 /** Provides a context for rows to access their table's `TableState`. */
 exports.TableStateContext = react_1.default.createContext({
     get tableState() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homebound/beam",
-  "version": "2.231.1",
+  "version": "2.232.0",
   "author": "Homebound",
   "license": "MIT",
   "main": "dist/index.js",