@xh/hoist 75.0.0-SNAPSHOT.1752873581842 → 75.0.0-SNAPSHOT.1753115287677

package/CHANGELOG.md

@@ -4,27 +4,24 @@
 
 ### 🎁 New Features
 
-* New property `GridModel.expandToLevel` governs the expansion state of tree and grouped grids.
-  Replaces the use of the `agOptions.groupDefaultExpanded` on the component.
-    * Most recently chosen level is persistable with other grid state.
-    * Default grid context menu has a menu item to trigger bulk expand/collapse to particular depth
-      level for multi-level (e.g. depth > 2) grids.  To enable, implement the `GridModel.levelLabels`
-      property for your grid.
-* Added new `GroupingChooserModel.sortDimensions` config - can be set to false to respect the order
-  in which dimensions are provided to the model.
-
-### 🐞 Bug Fixes
-
-* DashCanvas: ensure `allowAdd=false` is not enforced if loadingState
-  and hide `Add` context menu item in views in if `allowAdd=false`
-* DashCanvas: style with `position: relative;` to ensure that the empty state overlay is positioned
-  within the canvas, not the next parent container up that has `position: relative;`.
-
-* `useContextModel` is now reactive to a change of an (observable) resolved model when it is set.
-  Previously this value was cached on first render.
-
-* Fixes to framework components that bind to grids (e.g. `ColChooserButton`, `ColAutosizeButton`,
-  `GridFindField`) to rebind to a new observable GridModel available via context.
+* Added new `GridModel.expandToLevel` config to control the expansion state of tree/grouped grids.
+    * Replaces the use of the `agOptions.groupDefaultExpanded` on the component.
+    * The most recently expanded level is persistable with other grid state.
+    * The default grid context menu now supports a new item to allow users to expand/collapse out to
+      a specific level/depth. Set `GridModel.levelLabels` to activate this feature.
+* Added new `GroupingChooserModel.sortDimensions` config. Set to `false` to respect the order in
+  which `dimensions` are provided to the model.
+
+### 🐞 Bug Fixes
+
+* Fixed minor `DashCanvas` issues with `allowAdd: false`, ensuring it does not block additions made
+  via `loadState()` and hiding the `Add` context menu item in views as intended.
+* Updated `DashCanvas` CSS to set `position: relative;`, ensuring that the empty state overlay is
+  positioned as intended and does not extend beyond the canvas.
+* Improved the core `useContextModel` hook to make it reactive to a change of an (observable)
+  resolved model. Previously this value was cached on first render.
+* Fixed framework components that bind to grids (e.g. `ColChooserButton`, `ColAutosizeButton`,
+  `GridFindField`), ensuring they automatically rebind to a new observable `GridModel` via context.
 
 ## v74.1.2 - 2025-07-03
 

package/admin/tabs/activity/tracking/ActivityTrackingModel.ts

@@ -430,7 +430,7 @@ export class ActivityTrackingModel extends HoistModel implements ActivityDetailP
             emptyText: 'No activity reported...',
             sortBy: ['cubeLabel'],
             expandToLevel: 1,
-            levelLabels: () => ['Total', ...this.groupingChooserModel.getValueDisplayNames()],
+            levelLabels: () => ['Total', ...this.groupingChooserModel.valueDisplayNames],
             columns: [
                 {
                     field: {

package/build/types/cmp/grid/GridModel.d.ts

@@ -140,9 +140,10 @@ export interface GridConfig {
      */
     onCellContextMenu?: (e: CellContextMenuEvent) => void;
     /**
-     * Array of labels (or a function returning one) that describes the individual depth
-     * levels in a tree or grouped grid. If provided, will be used to construct expand/collapse
-     * options in the default context menu.
+     * Array of strings (or a function returning one) providing user-facing labels for each depth
+     * level in a tree or grouped grid - e.g. `['Country', 'State', 'City']`. If set, the
+     * expand/collapse options in the default context menu will be enhanced to allow users to
+     * expand/collapse to a specific level.
      */
     levelLabels?: Thunkable<string[]>;
     /**

package/build/types/cmp/grouping/GroupingChooserModel.d.ts

@@ -62,6 +62,7 @@ export declare class GroupingChooserModel extends HoistModel {
     get availableDims(): string[];
     get dimensionSpecs(): DimensionSpec[];
     get isValid(): boolean;
+    get valueDisplayNames(): string[];
     get isAddEnabled(): boolean;
     get isAddFavoriteEnabled(): boolean;
     constructor({ allowEmpty, commitOnChange, dimensions, initialFavorites, initialValue, maxDepth, persistWith, sortDimensions }: GroupingChooserConfig);
@@ -78,7 +79,6 @@ export declare class GroupingChooserModel extends HoistModel {
     commitPendingValueAndClose(): void;
     validateValue(value: string[]): boolean;
     getValueLabel(value: string[]): string;
-    getValueDisplayNames(): string[];
     getDimDisplayName(dimName: string): string;
     onDragEnd(result: any): void;
     get favoritesOptions(): {

package/cmp/grid/GridModel.ts

@@ -280,9 +280,10 @@ export interface GridConfig {
     onCellContextMenu?: (e: CellContextMenuEvent) => void;
 
     /**
-     * Array of labels (or a function returning one) that describes the individual depth
-     * levels in a tree or grouped grid. If provided, will be used to construct expand/collapse
-     * options in the default context menu.
+     * Array of strings (or a function returning one) providing user-facing labels for each depth
+     * level in a tree or grouped grid - e.g. `['Country', 'State', 'City']`. If set, the
+     * expand/collapse options in the default context menu will be enhanced to allow users to
+     * expand/collapse to a specific level.
      */
     levelLabels?: Thunkable<string[]>;
 
@@ -772,7 +773,7 @@ export class GridModel extends HoistModel {
         const {selModel} = this,
             row = this.agGridModel.getFirstSelectableRowNode();
 
-        // If displayed select it -- we never want to auto-expand parent rows
+        // If displayed, or potentially expandable to display, select it.
         if (row && (expandParentGroups || row.displayed)) {
             const id = row.data.id;
             if (id != null) {

package/cmp/grid/impl/MenuSupport.ts

@@ -286,10 +286,14 @@ function levelExpandAction(gridModel: GridModel): RecordAction {
             const {maxDepth, expandToLevel} = gridModel;
             if (maxDepth <= 1) return {hidden: true};
 
+            // Validate level labels.
             const levelLabels = executeIfFunction(gridModel.levelLabels);
-            if (!levelLabels || levelLabels.length < maxDepth + 1) {
+            if (!levelLabels) {
+                return {hidden: true};
+            }
+            if (levelLabels.length < maxDepth + 1) {
                 gridModel.logDebug(
-                    '"levelLabels" not provided or of insufficient length. No menu items shown.'
+                    'Value produced by `GridModel.levelLabels` has insufficient length. No menu items shown.'
                 );
                 return {hidden: true};
             }

package/cmp/grouping/GroupingChooserModel.ts

@@ -121,6 +121,11 @@ export class GroupingChooserModel extends HoistModel {
         return this.validateValue(this.pendingValue);
     }
 
+    @computed
+    get valueDisplayNames(): string[] {
+        return this.value.map(dimName => this.getDimDisplayName(dimName));
+    }
+
     @computed
     get isAddEnabled(): boolean {
         const {pendingValue, maxDepth, dimensionNames, availableDims} = this,
@@ -274,10 +279,6 @@ export class GroupingChooserModel extends HoistModel {
         return value.map(dimName => this.getDimDisplayName(dimName)).join(' › ');
     }
 
-    getValueDisplayNames(): string[] {
-        return this.value.map(dimName => this.getDimDisplayName(dimName));
-    }
-
     getDimDisplayName(dimName: string) {
         return this.dimensions[dimName]?.displayName ?? dimName;
     }

package/desktop/cmp/leftrightchooser/LeftRightChooser.ts

@@ -4,7 +4,6 @@
  *
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
-import {GridOptions} from '@ag-grid-community/core';
 import {grid} from '@xh/hoist/cmp/grid';
 import {hframe, vbox} from '@xh/hoist/cmp/layout';
 import {BoxProps, hoistCmp, HoistProps, uses} from '@xh/hoist/core';
@@ -28,21 +27,15 @@ export const [LeftRightChooser, leftRightChooser] = hoistCmp.withFactory<LeftRig
     className: 'xh-lr-chooser',
 
     render({model, ...props}, ref) {
-        const agOptions: GridOptions = {
-            defaultColDef: {
-                resizable: false
-            }
-        };
-
         return vbox({
             ref,
             items: [
                 hframe({
                     className: 'xh-lr-chooser__grid-frame',
                     items: [
-                        grid({model: model.leftModel, agOptions}),
+                        grid({model: model.leftModel}),
                         chooserToolbar(),
-                        grid({model: model.rightModel, agOptions})
+                        grid({model: model.rightModel})
                     ]
                 }),
                 description()

package/desktop/cmp/leftrightchooser/LeftRightChooserModel.ts

@@ -158,16 +158,19 @@ export class LeftRightChooserModel extends HoistModel {
             ]
         };
 
-        const leftTextCol = {
+        const colSpec = {
                 field: 'text',
                 flex: true,
+                resizable: true
+            },
+            leftTextCol = {
+                ...colSpec,
                 headerName: () =>
                     leftTitle + (showCounts ? ` (${this.leftModel.store.count})` : ''),
                 renderer: this.getTextColRenderer('left')
             },
             rightTextCol = {
-                field: 'text',
-                flex: true,
+                ...colSpec,
                 headerName: () =>
                     rightTitle + (showCounts ? ` (${this.rightModel.store.count})` : ''),
                 renderer: this.getTextColRenderer('right')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "75.0.0-SNAPSHOT.1752873581842",
+  "version": "75.0.0-SNAPSHOT.1753115287677",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",