@xh/hoist 77.0.0-SNAPSHOT.1760466580390 → 77.0.0-SNAPSHOT.1760663247565

package/CHANGELOG.md

@@ -4,60 +4,52 @@
 
 ### 🎁 New Features
 
-* `DashCanvasView` and `DashContainerView` components now have a public `@bindable` `titleDetails`
-  property on their models to support displaying additional information in the title bar of these
-  components.  `titleDetails` is not persisted, and is expected to be set programmatically by the
-  application as needed.
+* Added a public `@bindable titleDetails` config to `DashViewModel` to support displaying additional
+  information in the title bar of dashboard widgets. The new property is not persisted, allowing
+  apps to programmatically show dynamic info in a widget header without perturbing its saved state.
 
 ## 76.0.0 - 2025-09-26
 
 ### 💥 Breaking Changes (upgrade difficulty: 🟠 MEDIUM - AG Grid update, Hoist React upgrade)
 
-* Hoist v76 upgrades AG Grid to v34 (from v31), covering three major AG Grid releases with their own
-  potentially breaking changes. Fortunately, internal Hoist updates to our managed API wrappers mean
-  that most apps will see very minimal changes, although there are required adjustments to app-level
-  `package.json` to install updated grid dependencies and `Bootstrap.ts` to import and register
-  your licensed grid modules at their new import paths.
-
-  Applications implementing `groupRowRenderer` should note that the `value` property passed to this
-  function is no longer stringified, but is instead the raw field value for the group.
-
-  See AG's upgrade guides for more details:
-  ** [Upgrade to v32](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-32/)
-  ** [Upgrade to v33](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-33/)
-  ** [Upgrade to v34](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-34/)
-
-*  The constructor for `TabModel` has changed to take its owning container as a second argument.
-   (Most applications do not create `TabModels` directly, but it is possible.)
-*  The `Exception` class and `HoistException` type have been moved from `@xh\hoist\core` to a new
-    lower level package `@xh\hoist\exception`.  This new structure is not expected to effect most
-    applications, and was put in place to reduce the risk of circular dependencies between internal
-    hoist packages.
-
-### 🎁 New Features
-
-* Added new `extraConfirmText`, `extraConfirmLabel` properties to `MessageOptions`. Use this option
+* Hoist v76 **upgrades AG Grid to v34** (from v31), covering three major AG Grid releases with their
+  own potentially breaking changes.
+    * Fortunately, internal Hoist updates to our managed API wrappers mean that most apps will see
+      very minimal changes, although there are required adjustments to app-level `package.json` to
+      install updated grid dependencies and `Bootstrap.ts` to import and register your licensed grid
+      modules at their new import paths.
+    * Applications implementing `groupRowRenderer` should note that the `value` property passed
+      to this function is no longer stringified, but is instead the raw field value for the group.
+    * See AG's upgrade guides for more details:
+        * [Upgrade to v32](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-32/)
+        * [Upgrade to v33](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-33/)
+        * [Upgrade to v34](https://www.ag-grid.com/react-data-grid/upgrading-to-ag-grid-34/)
+* Modified the `TabModel` constructor to take its owning container as a second argument.
+    * Apps very rarely create `TabModels` directly, so this unlikely to require changes.
+* Moved the `Exception` class and `HoistException` type from `@xh\hoist\core` to a new lower-level
+  package `@xh\hoist\exception` to reduce the risk of circule dependencies within Hoist.
+    * Apps rarely interact with these directly, so also unlikely to require changes.
+
+### 🎁 New Features
+
+* Added `extraConfirmText` + `extraConfirmLabel` configs to `MessageOptions`. Use these new options
   to require the specified text to be re-typed by a user when confirming a potentially destructive
-  or disruptive action.
-* Updated grid column filters to apply on `Enter` / dismiss on `Esc` and tweaked the filter popup
+  or disruptive action. Note their usage within Hoist's Admin Console when deleting a role.
+* Updated grid column filters to apply on `Enter` / dismiss on `Esc`. Tweaked the filter popup
   toolbar for clarity.
-* Added new ability to specify nested tab containers in a single declarative config.  Apps may now
+* Added new ability to specify nested tab containers in a single declarative config. Apps may now
   provide a spec for a nested tab container directly to the `TabConfig.content` property.
-* Improvements to View Management:
-  ** Allow users to create 'Global' views directly in 'Save/Save As' Dialog.
-  ** Simplify presentation/edit of view visibility to new "Visibility" control
-  ** Support for the 'isDefaultPinned' attribute on global views has been removed.  All global
-  views will be pinned by default.  This feature was deemed too confusing, and not useful in
-  practice.  App maintainers should ensure that all global views are appropriate and well
-  organized enough to be shown immediately to new users in the view menu.
-* New constraint rule: `validEmails` - to validate one or more email addresses in an input field.
-* `DashCanvas` accepts a new prop `rglOptions` to pass additional options to the underlying
-  `react-grid-layout`.
-* Experimental grid feature  `enableFullWidthScroll` has been promoted to a first-class property
-    on `GridModel`.   Set to true to ensure that the grid will have a single horizontal scrollbar
-    spanning the width of all columns, including any pinned columns.
-* New `@sharePendingPromise` decorator for returning a shared Promise across concurrent async calls.
-
+* Improved `ViewManager` features:
+    * Enabled globally sharing a new view directly from the 'Save/Save As' dialog.
+    * Simplified presentation and management of view visibility via new "Visibility" control.
+    * Removed support for the `isDefaultPinned` attribute on global views. All global views will be
+      pinned (i.e. show up in user menus) by default. Users can still explicitly "unpin" any global
+      views to remove them from their menus.
+* Added a `validEmails` constraint rule to validate one or more email addresses in an input field.
+* Added `DashCanvas.rglOptions` prop - passed through to the underlying `react-grid-layout`.
+* Promoted experimental grid feature `enableFullWidthScroll` to a first-class `GridModel` config.
+  Set to true to ensure that the grid will have a single horizontal scrollbar spanning the width of
+  all columns, including any pinned columns.
 
 ### 🐞 Bug Fixes
 
@@ -73,6 +65,9 @@
 
 ### ⚙️ Technical
 
+* Added a new `@sharePendingPromise` decorator for returning a shared Promise across concurrent
+  async calls. Calls made to a decorated method while a prior call with the same args is still
+  pending won't kick off a new call, but will instead receive the same Promise as the first call.
 * Added `XH.logLevel` to define a minimum logging severity threshold for Hoist's client-side logging
   utilities. Defaulted to 'info' to prevent possible memory and performance impacts of verbose
   logging on 'debug'. Change at runtime via new `XH.setLogLevel()` when troubleshooting. See

package/build/types/data/cube/Query.d.ts

@@ -97,6 +97,7 @@ export declare class Query {
     readonly fields: CubeField[];
     readonly dimensions: CubeField[];
     readonly filter: Filter;
+    readonly hasFilter: boolean;
     readonly includeRoot: boolean;
     readonly includeLeaves: boolean;
     readonly provideLeaves: boolean;

package/data/cube/Query.ts

@@ -127,6 +127,7 @@ export class Query {
     readonly fields: CubeField[];
     readonly dimensions: CubeField[];
     readonly filter: Filter;
+    readonly hasFilter: boolean;
     readonly includeRoot: boolean;
     readonly includeLeaves: boolean;
     readonly provideLeaves: boolean;
@@ -164,6 +165,7 @@ export class Query {
         this.omitFn = omitFn;
 
         this._testFn = this.filter?.getTestFn(this.cube.store) ?? null;
+        this.hasFilter = this._testFn != null;
     }
 
     clone(overrides: Partial<QueryConfig>) {

package/data/cube/View.ts

@@ -309,12 +309,12 @@ export class View extends HoistBase {
         appliedDimensions: PlainObject,
         leafMap: Map<StoreRecordId, LeafRow>
     ): BaseRow[] {
-        if (isEmpty(records)) return [];
+        if (!records?.length) return [];
 
         const rootId = parentId + Cube.RECORD_ID_DELIMITER;
 
-        if (isEmpty(dimensions)) {
-            return map(records, r => {
+        if (!dimensions?.length) {
+            return records.map(r => {
                 const id = rootId + r.id,
                     leaf = this.cachedRow(id, null, () => new LeafRow(this, id, r));
                 leafMap.set(r.id, leaf);
@@ -355,16 +355,17 @@ export class View extends HoistBase {
         parentId: string,
         appliedDimensions: PlainObject
     ): BaseRow[] {
-        if (!this.query.bucketSpecFn) return rows;
+        const {query} = this;
 
-        const bucketSpec = this.query.bucketSpecFn(rows);
-        if (!bucketSpec) return rows;
+        if (!query.bucketSpecFn) return rows;
+        if (!query.includeLeaves && rows[0]?.isLeaf) return rows;
 
-        if (!this.query.includeLeaves && rows[0]?.isLeaf) return rows;
+        const bucketSpec = query.bucketSpecFn(rows);
+        if (!bucketSpec) return rows;
 
         const {name: bucketName, bucketFn} = bucketSpec,
-            buckets = {},
-            ret = [];
+            buckets: Record<string, BaseRow[]> = {},
+            ret: BaseRow[] = [];
 
         // Determine which bucket to put this row into (if any)
         rows.forEach(row => {
@@ -372,8 +373,8 @@ export class View extends HoistBase {
             if (isNil(bucketVal)) {
                 ret.push(row);
             } else {
-                if (!buckets[bucketVal]) buckets[bucketVal] = [];
-                buckets[bucketVal].push(row);
+                const bucketRows = buckets[bucketVal] ??= [];
+                bucketRows.push(row);
             }
         });
 
@@ -454,8 +455,13 @@ export class View extends HoistBase {
 
     private filterRecords() {
         const {query, cube} = this,
+            {hasFilter} = query,
             ret = new Map();
-        cube.store.records.filter(r => query.test(r)).forEach(r => ret.set(r.id, r));
+
+        cube.store.records.forEach(r => {
+            if (!hasFilter || query.test(r)) ret.set(r.id, r);
+        });
+
         this._recordMap = ret;
     }
 

package/package.json

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