@xh/hoist 71.0.0-SNAPSHOT.1735586653168 → 71.0.0-SNAPSHOT.1735588181793

package/CHANGELOG.md

@@ -4,35 +4,43 @@
 
 ### 💥 Breaking Changes
 
-* `ErrorMessage` is now cross-platform. Its import paths has changed from `@xh/hoist/desktop/cmp/error`
-  and `@xh/hoist/mobile/cmp/error` to `@xh/hoist/cmp/error`.
-* `Mask` is now cross-platform. Its import paths has changed from `@xh/hoist/desktop/cmp/mask`
-  and `@xh/hoist/mobile/cmp/mask` to `@xh/hoist/cmp/mask`.
-* `LoadingIndicator` is now cross-platform. Its import paths has changed from
-  `@xh/hoist/desktop/cmp/loadingindicator` and `@xh/hoist/mobile/cmp/loadingindicator` to
+* Requires `hoist-core >= 26.1` with new APIs to support `ViewManager`.
+* `ErrorMessage` is now cross-platform - update imports from `@xh/hoist/desktop/cmp/error`
+  or `@xh/hoist/mobile/cmp/error` to `@xh/hoist/cmp/error`.
+* `Mask` is now cross-platform - update imports from `@xh/hoist/desktop/cmp/mask` or
+  `@xh/hoist/mobile/cmp/mask` to `@xh/hoist/cmp/mask`.
+* `LoadingIndicator` is now cross-platform - update imports from
+  `@xh/hoist/desktop/cmp/loadingindicator` or `@xh/hoist/mobile/cmp/loadingindicator` to
   `@xh/hoist/cmp/loadingindicator`.
 * `TreeMap` and `SplitTreeMap` are now cross-platform and can be used in mobile applications.
-  Their import paths have changed from `@xh/hoist/desktop/cmp/treemap` to `@xh/hoist/cmp/treemap`.
-* The `RefreshButton` `model` prop has been renamed `target` for clarity and consistency.
+  Update imports from `@xh/hoist/desktop/cmp/treemap` to `@xh/hoist/cmp/treemap`.
+* Renamed `RefreshButton.model` prop to `target` for clarity and consistency.
 
 ### 🎁 New Features
 
-* Major Improvements to ViewManager component
-  * Support for persisting pending value.
-  * Handle delete and update collisions more gracefully.
-  * Support for `settleTime`,
-  * Improved management UI Dialog.
-  * Support for "global" views.
-* New `SessionStorageService` and associated persistence provider provides support for saving
-  tab local data across reloads.
-* Added support for `AuthZeroClientConfig.audience` to support improved configuration of Auth0 OAuth
-  clients requesting access tokens, covering cases when third-party cookies are blocked.
+* Major improvements to ViewManager component, including:
+    * A clearer, better organized view management dialog.
+    * Support for persisting a view's pending value, to avoid users losing changes when e.g. an app
+      goes into idle mode and requires a page refresh to restore.
+    * Improved handling of delete / update collisions.
+    * New `ViewManagerModel.settleTime` config, to allow persisted components such as dashboards to
+      fully resolve their rendered state before capturing a baseline for dirty checks.
+* Added `SessionStorageService` and associated persistence provider to support saving tab-local
+  data across reloads. Exact analog to `LocalStorageService`, but scoped to lifetime of current tab.
+* Added `AuthZeroClientConfig.audience` config to support improved flow for Auth0 OAuth clients that
+  request access tokens. Specify your access token audience here to allow the client to fetch both
+  ID and access tokens in a single request and to use refresh tokens to maintain access without
+  relying on third-party cookies.
+* Updated sorting on grouped grids to place ungrouped items at the bottom.
 
 ### 🐞 Bug Fixes
 
 * Fixed sizing and position of mobile `TabContainer` switcher, particularly when the switcher is
   positioned with `top` orientation.
 * Fixed styling of `ButtonGroup` in vertical orientations.
+* Improved handling of calls to `DashContainerModel.loadStateAsync()` when the component has yet
+  to be rendered. Requested state updates are no longer dropped, and will be applied as soon as the
+  component is ready to do so.
 
 ### ⚙️ Technical
 

package/build/types/cmp/viewmanager/DataAccess.d.ts

@@ -1,26 +1,6 @@
-import { PlainObject } from '@xh/hoist/core';
 import { ViewInfo } from './ViewInfo';
 import { View } from './View';
-import { ViewManagerModel } from './ViewManagerModel';
-export interface ViewCreateSpec {
-    name: string;
-    group: string;
-    description: string;
-    isShared: boolean;
-    value?: PlainObject;
-}
-export interface ViewUpdateSpec {
-    name: string;
-    group: string;
-    description: string;
-    isShared?: boolean;
-    isDefaultPinned?: boolean;
-}
-export interface ViewUserState {
-    currentView?: string;
-    userPinned: Record<string, boolean>;
-    autoSave: boolean;
-}
+import { ViewManagerModel, ViewUserState, ViewUpdateSpec, ViewCreateSpec } from './ViewManagerModel';
 /**
  * Supporting class for accessing and updating ViewManager and View data.
  *
@@ -45,6 +25,6 @@ export declare class DataAccess<T> {
     /** Update a view's value. */
     updateViewValueAsync(view: View<T>, value: Partial<T>): Promise<View<T>>;
     deleteViewsAsync(views: ViewInfo[]): Promise<void>;
-    updateStateAsync(update: Partial<ViewUserState>): Promise<void>;
+    updateStateAsync(update: Partial<ViewUserState>): Promise<ViewUserState>;
     private ensureEditable;
 }

package/build/types/cmp/viewmanager/ViewManagerModel.d.ts

@@ -2,7 +2,26 @@ import { HoistModel, LoadSpec, PlainObject, TaskObserver, Thunkable } from '@xh/
 import type { ViewManagerProvider } from '@xh/hoist/core';
 import { ViewInfo } from './ViewInfo';
 import { View } from './View';
-import { ViewCreateSpec, ViewUpdateSpec } from './DataAccess';
+export interface ViewCreateSpec {
+    name: string;
+    group: string;
+    description: string;
+    isShared: boolean;
+    isPinned: boolean;
+    value: PlainObject;
+}
+export interface ViewUpdateSpec {
+    name: string;
+    group: string;
+    description: string;
+    isShared?: boolean;
+    isDefaultPinned?: boolean;
+}
+export interface ViewUserState {
+    currentView?: string;
+    userPinned: Record<string, boolean>;
+    autoSave: boolean;
+}
 export interface ViewManagerConfig {
     /**
      * True (default) to allow user to opt in to automatically saving changes to their current view.
@@ -170,7 +189,6 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     resetAsync(): Promise<void>;
     getValue(): Partial<T>;
     setValue(value: Partial<T>): void;
-    togglePinned(view: ViewInfo): void;
     userPin(view: ViewInfo): void;
     userUnpin(view: ViewInfo): void;
     isUserPinned(view: ViewInfo): boolean | null;

package/cmp/viewmanager/DataAccess.ts

@@ -5,34 +5,12 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 
-import {PlainObject, XH} from '@xh/hoist/core';
+import {XH} from '@xh/hoist/core';
 import {pluralize, throwIf} from '@xh/hoist/utils/js';
 import {map} from 'lodash';
 import {ViewInfo} from './ViewInfo';
 import {View} from './View';
-import {ViewManagerModel} from './ViewManagerModel';
-
-export interface ViewCreateSpec {
-    name: string;
-    group: string;
-    description: string;
-    isShared: boolean;
-    value?: PlainObject;
-}
-
-export interface ViewUpdateSpec {
-    name: string;
-    group: string;
-    description: string;
-    isShared?: boolean;
-    isDefaultPinned?: boolean;
-}
-
-export interface ViewUserState {
-    currentView?: string;
-    userPinned: Record<string, boolean>;
-    autoSave: boolean;
-}
+import {ViewManagerModel, ViewUserState, ViewUpdateSpec, ViewCreateSpec} from './ViewManagerModel';
 
 /**
  * Supporting class for accessing and updating ViewManager and View data.
@@ -100,7 +78,7 @@ export class DataAccess<T> {
         try {
             this.ensureEditable(view);
             const raw = await XH.postJson({
-                url: 'xhView/updateViewInfo',
+                url: 'xhView/updateInfo',
                 params: {token: view.token},
                 body: updates
             });
@@ -157,9 +135,9 @@ export class DataAccess<T> {
     //--------------------------
     // State related changes
     //--------------------------
-    async updateStateAsync(update: Partial<ViewUserState>) {
+    async updateStateAsync(update: Partial<ViewUserState>): Promise<ViewUserState> {
         const {type, instance} = this.model;
-        await XH.postJson({
+        return XH.postJson({
             url: 'xhView/updateState',
             params: {type, viewInstance: instance},
             body: update

package/cmp/viewmanager/ViewManagerModel.ts

@@ -25,7 +25,30 @@ import {find, isEqual, isNil, isNull, isUndefined, lowerCase} from 'lodash';
 import {ReactNode} from 'react';
 import {ViewInfo} from './ViewInfo';
 import {View} from './View';
-import {DataAccess, ViewCreateSpec, ViewUpdateSpec, ViewUserState} from './DataAccess';
+import {DataAccess} from './DataAccess';
+
+export interface ViewCreateSpec {
+    name: string;
+    group: string;
+    description: string;
+    isShared: boolean;
+    isPinned: boolean;
+    value: PlainObject;
+}
+
+export interface ViewUpdateSpec {
+    name: string;
+    group: string;
+    description: string;
+    isShared?: boolean;
+    isDefaultPinned?: boolean;
+}
+
+export interface ViewUserState {
+    currentView?: string;
+    userPinned: Record<string, boolean>;
+    autoSave: boolean;
+}
 
 export interface ViewManagerConfig {
     /**
@@ -338,9 +361,8 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
     }
 
     async saveAsAsync(spec: ViewCreateSpec): Promise<void> {
-        const view = await this.dataAccess.createViewAsync({...spec, value: this.getValue()});
+        const view = await this.dataAccess.createViewAsync(spec);
         this.noteSuccess(`Created ${view.typedName}`);
-        this.userPin(view.info);
         this.setAsView(view);
     }
 
@@ -404,10 +426,6 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
     //------------------
     // Pinning
     //------------------
-    togglePinned(view: ViewInfo) {
-        view.isPinned ? this.userUnpin(view) : this.userPin(view);
-    }
-
     @action
     userPin(view: ViewInfo) {
         this.userPinned = {...this.userPinned, [view.token]: true};

package/desktop/cmp/viewmanager/ViewMenu.ts

@@ -78,7 +78,6 @@ function getOtherMenuItems(model: ViewManagerLocalModel): ReactNode[] {
         autoSaveUnavailableReason,
         autoSave,
         isViewSavable,
-        views,
         isValueDirty,
         typeDisplayName
     } = parent;
@@ -119,7 +118,6 @@ function getOtherMenuItems(model: ViewManagerLocalModel): ReactNode[] {
         menuDivider(),
         menuItem({
             icon: Icon.gear(),
-            disabled: isEmpty(views),
             text: `Manage ${pluralName}...`,
             onClick: () => model.manageDialogModel.open()
         })

package/desktop/cmp/viewmanager/dialog/SaveAsDialogModel.ts

@@ -86,7 +86,9 @@ export class SaveAsDialogModel extends HoistModel {
             name: name.trim(),
             group: group?.trim(),
             description: description?.trim(),
-            isShared
+            isPinned: true,
+            isShared,
+            value: parent.getValue()
         });
     }
 }

package/package.json

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