@xh/hoist 75.0.0-SNAPSHOT.1752860174147 → 75.0.0-SNAPSHOT.1752891558856

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/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/core/persist/PersistenceProvider.d.ts

@@ -63,4 +63,5 @@ export declare abstract class PersistenceProvider<S = any> {
     protected writeRaw(obj: Record<typeof this.path, S>): void;
     protected readRaw(): Record<typeof this.path, S>;
     private static parseProviderClass;
+    private ensureValid;
 }

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[]>;
 

package/core/persist/PersistenceProvider.ts

@@ -12,8 +12,10 @@ import {
     compact,
     debounce as lodashDebounce,
     get,
+    isArray,
     isEmpty,
     isNumber,
+    isObject,
     isString,
     isUndefined,
     omit,
@@ -88,6 +90,7 @@ export abstract class PersistenceProvider<S = any> {
 
             const providerClass = this.parseProviderClass<S>(cfg.persistOptions);
             ret = new providerClass(cfg);
+            ret.ensureValid();
             ret.bindToTarget(cfg.target);
             return ret;
         } catch (e) {
@@ -252,4 +255,13 @@ export abstract class PersistenceProvider<S = any> {
 
         return ret;
     }
+
+    private ensureValid() {
+        const data = this.readRaw();
+        throwIf(
+            !(isObject(data) && !isArray(data)),
+            `PersistenceProvider for ${this.path} may not be configured correctly.  The provider ` +
+                'should produce a javascript object for reading property values.'
+        );
+    }
 }

package/package.json

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