@visns-studio/visns-components 6.3.7 → 6.3.8

package/package.json

@@ -91,7 +91,7 @@
         "react-dom": "^17.0.0 || ^18.0.0"
     },
     "name": "@visns-studio/visns-components",
-    "version": "6.3.7",
+    "version": "6.3.8",
     "description": "Various packages to assist in the development of our Custom Applications.",
     "main": "src/index.js",
     "files": [

package/src/components/DataGrid.jsx

@@ -659,11 +659,11 @@ const DataGrid = forwardRef(
                     }
 
                     // Opt-in grouped display (ajaxSetting.treeGroupBy {key,
-                    // column, parentFields, countLabel, collapsible,
-                    // defaultCollapsed, icons}): consecutive rows sharing a
-                    // non-empty `key` value get a synthetic summary parent
-                    // row inserted above them. `parentFields` are lifted from
-                    // the first row onto the parent and blanked on the
+                    // column, parentFields, parentFieldAliases, countLabel,
+                    // collapsible, defaultCollapsed, icons}): consecutive rows
+                    // sharing a non-empty `key` value get a synthetic summary
+                    // parent row inserted above them. `parentFields` are lifted
+                    // from the first row onto the parent and blanked on the
                     // children, so shared details display once; children get
                     // an "↳" prefix in the display column. Single rows stay
                     // plain — unlike the grid's own groupBy, which forces a
@@ -678,6 +678,7 @@ const DataGrid = forwardRef(
                             key: treeKey,
                             column: treeDisplayColumn,
                             parentFields = [],
+                            parentFieldAliases = {},
                             countLabel,
                             collapsible,
                             defaultCollapsed,
@@ -722,6 +723,35 @@ const DataGrid = forwardRef(
                                     });
                                 });
 
+                                // `parentFieldAliases` ({columnField:
+                                // sourceField}): the parent shows a DIFFERENT
+                                // field in a column than its children do, so
+                                // one column can carry the per-member value on
+                                // members and the group's summary on the
+                                // parent instead of spending a second column
+                                // on the summary alone.
+                                //
+                                // Unlike `parentFields` this deliberately does
+                                // NOT blank the column on the children — the
+                                // members' own values are the reason the
+                                // column exists. (Listing the same field in
+                                // both would blank it on the children and
+                                // defeat that, so pick one.)
+                                //
+                                // Distinct from `countLabel` too, which
+                                // templates a summary from the child COUNT and
+                                // so can only produce one fixed wording. An
+                                // alias reads a field the backend computed,
+                                // which is what it takes for the summary to
+                                // vary with the data ("2 Headers" for one kind
+                                // of group, "2 Stations" for another).
+                                Object.entries(parentFieldAliases).forEach(
+                                    ([columnField, sourceField]) => {
+                                        parent[columnField] =
+                                            children[0]?.[sourceField];
+                                    }
+                                );
+
                                 // Mark children for styling (getRowStyle) and
                                 // prefix their display value so nesting reads
                                 children.forEach((child) => {