@xh/hoist 76.0.0-SNAPSHOT.1758755408459 → 76.0.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 76.0.0-SNAPSHOT - unreleased
+## 76.0.0 - 2025-09-26
 
 ### 💥 Breaking Changes (upgrade difficulty: 🟠 MEDIUM - AG Grid update, Hoist React upgrade)
 
@@ -44,9 +44,10 @@
 * 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
+* 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.
 
 
 ### 🐞 Bug Fixes
@@ -56,6 +57,10 @@
   its configured `initialViewSpec` function as expected in this case.
 * Updated `XH.restoreDefaultsAsync` to clear basic view state, including the user's last selected
   view. Views themselves will be preserved. Requires `hoist-core >= 32.0`.
+* Fixed bug where `GridModel.persistableColumnState` was not including default column `widths`.
+  This led to columns not being set to their expected widths when switching `ViewManager` views.
+* Fixed bug where a `Grid` with managed autosizing was not triggering an autosize as expected when
+  new column state was loaded (e.g. via `ViewManager`).
 
 ### ⚙️ Technical
 

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

@@ -463,7 +463,6 @@ export declare class GridModel extends HoistModel {
     updateData(rawData: PlainObject[] | StoreTransaction): import("@xh/hoist/data").StoreChangeLog;
     /** Clear the underlying store, removing all rows. */
     clear(): void;
-    /** @param colConfigs - {@link Column} or {@link ColumnGroup} configs. */
     setColumns(colConfigs: Array<ColumnSpec | ColumnGroupSpec>): void;
     setColumnState(colState: Partial<ColumnState>[]): void;
     showColChooser(): void;

package/build/types/cmp/grid/impl/ColumnWidthCalculator.d.ts

@@ -17,7 +17,7 @@ export declare class ColumnWidthCalculator {
     private _headerEl;
     private _cellEl;
     private _rowEl;
-    calcWidthAsync(gridModel: GridModel, records: StoreRecord[], colId: string, options: GridAutosizeOptions): Promise<any>;
+    calcWidthAsync(gridModel: GridModel, records: StoreRecord[], colId: string, options: Omit<GridAutosizeOptions, 'columns'>): Promise<any>;
     calcHeaderWidth(gridModel: any, column: any, options: any): any;
     calcDataWidthAsync(gridModel: any, records: any, column: any, options: any): Promise<number>;
     calcLevelWidthAsync(gridModel: any, records: any, column: any, options: any, indentationPx?: number): Promise<number>;

package/build/types/svc/GridAutosizeService.d.ts

@@ -23,7 +23,7 @@ export declare class GridAutosizeService extends HoistService {
      * @param colIds - array of columns in model to compute sizing for.
      * @param options - options to use for this autosize.
      */
-    autosizeAsync(gridModel: GridModel, colIds: string[], options: GridAutosizeOptions): Promise<void>;
+    autosizeAsync(gridModel: GridModel, colIds: string[], options: Omit<GridAutosizeOptions, 'columns'>): Promise<void>;
     private calcRequiredWidthsAsync;
     private gatherRecordsToBeSized;
     private calcFillWidths;

package/build/types/utils/js/Decorators.d.ts

@@ -28,3 +28,15 @@ export declare function enumerable(target: any, key: any, descriptor: any): any;
  * Designate a method or getter as abstract so that it throws if it is called directly
  */
 export declare function abstract(target: any, key: any, descriptor: any): any;
+/**
+ * Decorates a class method that returns a Promise so that concurrent calls with the same arguments
+ * will share a single pending Promise. Arguments must be serializable via JSON.stringify.
+ */
+export declare function sharePendingPromise<T>(target: T, key: string, descriptor: PropertyDescriptor): {
+    value: () => any;
+    configurable?: boolean;
+    enumerable?: boolean;
+    writable?: boolean;
+    get?(): any;
+    set?(v: any): void;
+};

package/cmp/grid/GridModel.ts

@@ -61,6 +61,7 @@ import {wait, waitFor} from '@xh/hoist/promise';
 import {ExportOptions} from '@xh/hoist/svc/GridExportService';
 import {SECONDS} from '@xh/hoist/utils/datetime';
 import {
+    sharePendingPromise,
     deepFreeze,
     executeIfFunction,
     logWithDebug,
@@ -1137,7 +1138,6 @@ export class GridModel extends HoistModel {
         this.store.clear();
     }
 
-    /** @param colConfigs - {@link Column} or {@link ColumnGroup} configs. */
     @action
     setColumns(colConfigs: Array<ColumnSpec | ColumnGroupSpec>) {
         this.validateColConfigs(colConfigs);
@@ -1147,10 +1147,15 @@ export class GridModel extends HoistModel {
         this.validateColumns(columns);
 
         this.columns = columns;
-        this.columnState = this.getLeafColumns().map(it => {
-            const {colId, width, hidden, pinned} = it;
-            return {colId, width, hidden, pinned};
-        });
+        this.columnState = this.getLeafColumns().map(it => ({
+            ...pick(it, ['colId', 'width', 'hidden', 'pinned']),
+            // If not in managed auto-size mode, treat in-code column widths as manuallySized so
+            // widths are not omitted from persistableColumnState. This is important because
+            // PersistanceProvider.getPersistableState() expects a complete snapshot of initial
+            // state in order to detect changes and restore initial state correctly.
+            // See https://github.com/xh/hoist-react/issues/4102.
+            manuallySized: !!(it.width && this.autosizeOptions.mode !== 'managed')
+        }));
     }
 
     setColumnState(colState: Partial<ColumnState>[]) {
@@ -1373,14 +1378,16 @@ export class GridModel extends HoistModel {
      */
     @logWithDebug
     async autosizeAsync(overrideOpts: Omit<GridAutosizeOptions, 'mode'> = {}) {
-        const options: GridAutosizeOptions = {...this.autosizeOptions, ...overrideOpts};
+        const {columns, ...options}: GridAutosizeOptions = {
+            ...this.autosizeOptions,
+            ...overrideOpts
+        };
 
         if (options.mode === 'disabled') {
             return;
         }
 
         // 1) Pre-process columns to be operated on
-        const {columns} = options;
         if (columns) options.fillMode = 'none'; // Fill makes sense only for the entire set.
 
         let colIds: string[],
@@ -1577,7 +1584,11 @@ export class GridModel extends HoistModel {
         return new Column(config, this);
     }
 
-    private async autosizeColsInternalAsync(colIds: string[], options: GridAutosizeOptions) {
+    @sharePendingPromise
+    private async autosizeColsInternalAsync(
+        colIds: string[],
+        options: Omit<GridAutosizeOptions, 'columns'>
+    ) {
         await this.whenReadyAsync();
         if (!this.isReady) return;
 

package/cmp/grid/impl/ColumnWidthCalculator.ts

@@ -50,7 +50,7 @@ export class ColumnWidthCalculator {
         gridModel: GridModel,
         records: StoreRecord[],
         colId: string,
-        options: GridAutosizeOptions
+        options: Omit<GridAutosizeOptions, 'columns'>
     ) {
         const column = gridModel.findColumn(gridModel.columns, colId),
             {autosizeMinWidth, autosizeMaxWidth} = column;

package/cmp/grid/impl/InitPersist.ts

@@ -6,6 +6,7 @@
  */
 import {PersistableState, PersistenceProvider} from '@xh/hoist/core';
 import {isEqual, isObject} from 'lodash';
+import {runInAction} from 'mobx';
 import {GridModel} from '../GridModel';
 import {ColumnState, GridModelPersistOptions} from '../Types';
 
@@ -36,7 +37,18 @@ export function initPersist(
             target: {
                 getPersistableState: () =>
                     new PersistableColumnState(gridModel.persistableColumnState),
-                setPersistableState: ({value}) => gridModel.setColumnState(value)
+                setPersistableState: ({value}) =>
+                    runInAction(() => {
+                        // Set columnState directly since GridModel.setColumnState will merge the
+                        // provided state with the current state, which is not what we want here.
+                        gridModel.columnState = gridModel.cleanColumnState(value);
+                        if (gridModel.autosizeOptions.mode === 'managed') {
+                            const columns = gridModel.columnState
+                                .filter(it => !it.manuallySized)
+                                .map(it => it.colId);
+                            gridModel.autosizeAsync({columns});
+                        }
+                    })
             },
             owner: gridModel
         });

package/package.json

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

package/svc/GridAutosizeService.ts

@@ -38,7 +38,11 @@ export class GridAutosizeService extends HoistService {
      * @param colIds - array of columns in model to compute sizing for.
      * @param options - options to use for this autosize.
      */
-    async autosizeAsync(gridModel: GridModel, colIds: string[], options: GridAutosizeOptions) {
+    async autosizeAsync(
+        gridModel: GridModel,
+        colIds: string[],
+        options: Omit<GridAutosizeOptions, 'columns'>
+    ) {
         await gridModel.whenReadyAsync();
         if (!gridModel.isReady) return;
 
@@ -103,7 +107,7 @@ export class GridAutosizeService extends HoistService {
         gridModel: GridModel,
         colIds: string[],
         records: StoreRecord[],
-        options: GridAutosizeOptions,
+        options: Omit<GridAutosizeOptions, 'columns'>,
         manuallySized: boolean
     ): Promise<ColWidthSpec[]> {
         const startRecords = gridModel.store._filtered,
@@ -127,7 +131,7 @@ export class GridAutosizeService extends HoistService {
 
     private gatherRecordsToBeSized(
         gridModel: GridModel,
-        options: GridAutosizeOptions
+        options: Omit<GridAutosizeOptions, 'columns'>
     ): StoreRecord[] {
         let {store, agApi, treeMode, groupBy} = gridModel,
             {includeCollapsedChildren, renderedRowsOnly} = options,