@xh/hoist 71.0.0-SNAPSHOT.1733198772915 → 71.0.0-SNAPSHOT.1733266596001

package/CHANGELOG.md

@@ -2,9 +2,15 @@
 
 ## v71.0.0-SNAPSHOT - unreleased
 
+### 🎁 New Features
 
-### ⚙️ Technical
-* Misc. Improvements to ViewManager
+* Major Improvements to ViewManager component
+  * Support for persisting pending value.
+  * Handle delete and update collisions more gracefully.
+  * Support for `settleTime`,
+  * Improved management UI Dialog.
+* New `SessionStorageService` and associated persistence provider provides support for saving
+  tab local data across reloads.
 
 
 ## v70.0.0 - 2024-11-15

package/appcontainer/AppContainerModel.ts

@@ -36,6 +36,7 @@ import {
     JsonBlobService,
     LocalStorageService,
     PrefService,
+    SessionStorageService,
     TrackService,
     WebSocketService
 } from '@xh/hoist/svc';
@@ -217,7 +218,7 @@ export class AppContainerModel extends HoistModel {
             }
 
             // Complete initialization process
-            await installServicesAsync([ConfigService, LocalStorageService]);
+            await installServicesAsync([ConfigService, LocalStorageService, SessionStorageService]);
             await installServicesAsync(TrackService);
             await installServicesAsync([EnvironmentService, PrefService, JsonBlobService]);
 

package/build/types/cmp/chart/impl/copyToClipboard.d.ts

@@ -1,6 +1,5 @@
 /**
- * Copy the chart in it's current state to the clipboard.
- * Works only on webkit based browsers.
+ * Copy the chart in its current state to the clipboard - supported for webkit based browsers only.
  * @internal
  */
 export declare function installCopyToClipboard(Highcharts: any): void;

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

@@ -0,0 +1,23 @@
+import { FormModel } from '@xh/hoist/cmp/form';
+import { HoistModel } from '@xh/hoist/core';
+import { View } from './View';
+import { ViewManagerModel } from './ViewManagerModel';
+/**
+ * Backing model for ViewManagerModel's SaveAs
+ */
+export declare class SaveAsDialogModel extends HoistModel {
+    readonly parent: ViewManagerModel;
+    readonly formModel: FormModel;
+    isOpen: boolean;
+    private resolveOpen;
+    get type(): string;
+    get typeDisplayName(): string;
+    get globalDisplayName(): string;
+    constructor(parent: ViewManagerModel);
+    openAsync(): Promise<View>;
+    cancel(): void;
+    saveAsAsync(): Promise<void>;
+    private createFormModel;
+    private doSaveAsAsync;
+    private close;
+}

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

@@ -0,0 +1,28 @@
+import { PlainObject } from '@xh/hoist/core';
+import { ViewManagerModel } from './ViewManagerModel';
+import { ViewInfo } from './ViewInfo';
+import { JsonBlob } from '@xh/hoist/svc';
+/**
+ * A named saved bundle of state for components.
+ */
+export declare class View<T extends PlainObject = PlainObject> {
+    /**
+     * Default View representing code state of all contained components.
+     * Available for all view managers where `enableDefault` is true.
+     */
+    /** Metadata about this View. Null for 'default' view */
+    readonly info: ViewInfo;
+    /**
+     * State for the components in the view. Only state that differs from the initial "code"
+     * state of the components is captured.
+     */
+    readonly value: Partial<T>;
+    get isDefault(): boolean;
+    get isGlobal(): boolean;
+    get lastUpdated(): number;
+    get token(): string;
+    static fromBlob<T>(blob: JsonBlob, model: ViewManagerModel): View<T>;
+    static createDefault<T>(): View<T>;
+    withUpdatedValue(value: Partial<T>): View<T>;
+    constructor(info: ViewInfo, value: Partial<T>);
+}

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

@@ -0,0 +1,30 @@
+import { ViewManagerModel } from './ViewManagerModel';
+import { JsonBlob } from '@xh/hoist/svc';
+/**
+ * Metadata describing {@link View} managed by {@link ViewManagerModel}.
+ */
+export declare class ViewInfo {
+    /** Unique Id */
+    readonly token: string;
+    /** App-defined type discriminator, as per {@link ViewManagerConfig.viewType}. */
+    readonly type: string;
+    /** User-supplied descriptive name. */
+    readonly name: string;
+    /** Description of the view. **/
+    readonly description: string;
+    /** True if this view is global and visible to all users. */
+    readonly isGlobal: boolean;
+    /** Original creator of the view, and the only user with access to it if not global. */
+    readonly owner: string;
+    dateCreated: number;
+    lastUpdated: number;
+    lastUpdatedBy: string;
+    private readonly model;
+    constructor(blob: JsonBlob, model: ViewManagerModel);
+    /**
+     * True if user has tagged this view as a favorite. Note that a user's list of favorite views
+     * is persisted via `ViewManagerModel.persistWith` and *not* stored in the blob itself.
+     */
+    get isFavorite(): boolean;
+    get typedName(): string;
+}

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

@@ -0,0 +1,185 @@
+import { HoistModel, LoadSpec, PersistOptions, PlainObject, TaskObserver, Thunkable } from '@xh/hoist/core';
+import type { ViewManagerProvider } from '@xh/hoist/core';
+import { SaveAsDialogModel } from './SaveAsDialogModel';
+import { ViewInfo } from './ViewInfo';
+import { View } from './View';
+export interface ViewManagerConfig {
+    /**
+     * True (default) to allow user to opt in to automatically saving changes to their current view.
+     */
+    enableAutoSave?: boolean;
+    /**
+     * True (default) to allow the user to select a "Default" option that restores all persisted
+     * objects to their in-code defaults. If not enabled, at least one saved view should be created
+     * in advance, so that there is a clear initial selection for users without any private views.
+     */
+    enableDefault?: boolean;
+    /** True (default) to allow user to mark views as favorites. Requires `persistWith`. */
+    enableFavorites?: boolean;
+    /**
+     * Function to determine the initial view for a user, when no view has already been persisted.
+     * Will be passed a list of views available to the current user.  Implementations where
+     * enableDefault is set false should typically return some view, if any views are
+     * available.  If no view is returned, the control will be forced to fall back on the default.
+     *
+     * Must be set when enableDefault is false.
+     */
+    initialViewSpec?: (views: ViewInfo[]) => ViewInfo;
+    /**
+     * Delay after state has been set on associated components before they will be observed for
+     * any further state changes.  Larger values may be useful when providing state to complex
+     * components such as dashboards or grids that may create dirty state immediately after load.
+     *
+     * Specified in milliseconds.  Default is 250.
+     */
+    settleTime?: number;
+    /**
+     * True to allow the user to publish or edit the global views. Apps are expected to
+     * commonly set this based on user roles - e.g. `XH.getUser().hasRole('MANAGE_GRID_VIEWS')`.
+     */
+    manageGlobal?: Thunkable<boolean>;
+    /** Used to persist the user's state. */
+    persistWith?: ViewManagerPersistOptions;
+    /**
+     * Required discriminator for the particular class of views to be loaded and managed by this
+     * model. Set to something descriptive and specific enough to be identifiable and allow for
+     * different viewManagers to be added to your app in the future - e.g. `portfolioGridView` or
+     * `tradeBlotterDashboard`.
+     */
+    viewType: string;
+    /**
+     * Optional user-facing display name for the view type, displayed in the ViewManager menu
+     * and associated management dialogs and prompts. Defaulted from `viewType` if not provided.
+     */
+    typeDisplayName?: string;
+    /**
+     * Optional user-facing display name for describing global views. Defaults to 'global'
+     */
+    globalDisplayName?: string;
+}
+export interface ViewManagerPersistOptions extends PersistOptions {
+    /** True to persist favorites or provide specific PersistOptions. (Default true) */
+    persistFavorites?: boolean | PersistOptions;
+    /** True to include pending value or provide specific PersistOptions. (Default false) */
+    persistPendingValue?: boolean | PersistOptions;
+}
+/**
+ *  ViewManagerModel coordinates the loading, saving, and management of user-defined bundles of
+ *  {@link Persistable} component/model state.
+ *
+ *  - Models to be persisted are bound to this model via their `persistWith` config. One or more
+ *    models can be bound to a single ViewManagerModel, allowing a single view to capture the state
+ *    of multiple components - e.g. grouping and filtering options along with grid state.
+ *  - Views are persisted back to the server as JsonBlob objects.
+ *  - Views can be private to their owner, or optionally enabled for global use by (all) other users.
+ *  - Views can be marked as favorites for quick access.
+ *  - See the desktop {@link ViewManager} component - the initial Hoist UI for this model.
+ */
+export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
+    /**
+     * Factory to create new instances of this model and await its initial load before binding to
+     * any persistable component models. This ensures that bound models will have the expected
+     * initial persisted state applied within their constructor, before their components have
+     * rendered, and avoids thrashing of component state during initial load.
+     *
+     * To minimize the impact this async requirement has on the design and lifecycle of individual
+     * components within an app, consider eagerly constructing any viewManagerModels required within
+     * your `AppModel.initAsync` method and saving a reference to them there for component models
+     * to then use when they are mounted. The VM model instances will then be "ready to go" and
+     * usable within model constructors. (Initializing and referencing from one or more app
+     * services would be another, similar option.)
+     *
+     * Note that this method may throw if the ViewManager cannot be initialized successfully,
+     * but should generally fail quietly due to the early instantiation.
+     */
+    static createAsync(config: ViewManagerConfig): Promise<ViewManagerModel>;
+    /** Immutable configuration for this model. */
+    readonly viewType: string;
+    readonly typeDisplayName: string;
+    readonly globalDisplayName: string;
+    readonly enableAutoSave: boolean;
+    readonly enableDefault: boolean;
+    readonly enableFavorites: boolean;
+    readonly manageGlobal: boolean;
+    readonly settleTime: number;
+    readonly initialViewSpec: (views: ViewInfo[]) => ViewInfo;
+    /** Current view. Will not include uncommitted changes */
+    view: View<T>;
+    /** Loaded saved view library - both private and global */
+    views: ViewInfo[];
+    /** List of tokens for the user's favorite views. */
+    favorites: string[];
+    /**
+     * True if user has opted-in to automatically saving changes to personal views (if auto-save
+     * generally available as per `enableAutoSave`).
+     */
+    autoSave: boolean;
+    /**
+     * TaskObserver linked to {@link selectViewAsync}. If a change to the active view is likely to
+     * require intensive layout/grid work, consider masking affected components with this task.
+     */
+    selectTask: TaskObserver;
+    /**
+     * TaskObserver linked to {@link saveAsync}.
+     */
+    saveTask: TaskObserver;
+    manageDialogOpen: boolean;
+    readonly saveAsDialogModel: SaveAsDialogModel;
+    private pendingValue;
+    private lastPushed;
+    /**
+     * Array of {@link ViewManagerProvider} instances bound to this model. Providers will
+     * push themselves onto this array when constructed with a reference to this model. Used to
+     * proactively push state to the target components when the model's selected `value` changes.
+     *
+     * @internal
+     */
+    providers: ViewManagerProvider<any>[];
+    persistWith: ViewManagerPersistOptions;
+    get isValueDirty(): boolean;
+    get isViewSavable(): boolean;
+    get isViewAutoSavable(): boolean;
+    get autoSaveUnavailableReason(): string;
+    get favoriteViews(): ViewInfo[];
+    get globalViews(): ViewInfo[];
+    get privateViews(): ViewInfo[];
+    /** True if any async tasks are pending. */
+    get isLoading(): boolean;
+    /**
+     * Use the static {@link createAsync} factory to create an instance of this model and await its
+     * initial load before binding to persistable components.
+     */
+    private constructor();
+    private initAsync;
+    doLoadAsync(loadSpec: LoadSpec): Promise<void>;
+    selectViewAsync(info: ViewInfo): Promise<void>;
+    saveAsync(): Promise<void>;
+    saveAsAsync(): Promise<void>;
+    resetAsync(): Promise<void>;
+    getValue(): Partial<T>;
+    setValue(value: Partial<T>): void;
+    toggleFavorite(token: string): void;
+    addFavorite(token: string): void;
+    removeFavorite(token: string): void;
+    isFavorite(token: string): boolean;
+    openManageDialog(): void;
+    closeManageDialog(): void;
+    validateViewNameAsync(name: string, existing?: ViewInfo): Promise<string>;
+    deleteViewAsync(view: ViewInfo): Promise<void>;
+    updateViewAsync(view: ViewInfo, name: string, description: string, isGlobal: boolean): Promise<void>;
+    createViewAsync(name: string, description: string, value: PlainObject): Promise<View>;
+    private loadViewAsync;
+    private fetchViewAsync;
+    private fetchViewInfosAsync;
+    private maybeAutoSaveAsync;
+    private setAsView;
+    private handleException;
+    private noteSuccess;
+    /**
+     * Stringify and parse to ensure that any value set here is valid, serializable JSON.
+     */
+    private cleanState;
+    private confirmDiscardChangesAsync;
+    private maybeConfirmSaveAsync;
+    private initPersist;
+}

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

@@ -0,0 +1,4 @@
+export * from './ViewManagerModel';
+export * from './ViewInfo';
+export * from './View';
+export * from './SaveAsDialogModel';

package/build/types/core/XH.d.ts

@@ -1,7 +1,7 @@
 import { RouterModel } from '@xh/hoist/appcontainer/RouterModel';
 import { HoistAuthModel } from '@xh/hoist/core/HoistAuthModel';
 import { Store } from '@xh/hoist/data';
-import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, TrackService, WebSocketService } from '@xh/hoist/svc';
+import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService } from '@xh/hoist/svc';
 import { Router, State } from 'router5';
 import { CancelFn } from 'router5/types/types/base';
 import { SetOptional } from 'type-fest';
@@ -58,6 +58,7 @@ export declare class XHApi {
     jsonBlobService: JsonBlobService;
     localStorageService: LocalStorageService;
     prefService: PrefService;
+    sessionStorageService: SessionStorageService;
     trackService: TrackService;
     webSocketService: WebSocketService;
     /**

package/build/types/core/persist/PersistOptions.d.ts

@@ -1,6 +1,6 @@
 import { DebounceSpec } from '../';
 import type { DashViewModel } from '@xh/hoist/desktop/cmp/dash';
-import type { ViewManagerModel } from '@xh/hoist/core/persist/viewmanager';
+import type { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
 export interface PersistOptions {
     /** Dot delimited path to store state. */
     path?: string;
@@ -15,6 +15,8 @@ export interface PersistOptions {
     prefKey?: string;
     /** Browser local storage key used to store state. */
     localStorageKey?: string;
+    /** Session (tab-specific) storage key used to store state. */
+    sessionStorageKey?: string;
     /** DashViewModel used to read / write view state. */
     dashViewModel?: DashViewModel;
     /** ViewManagerModel used to read / write view state. */

package/build/types/core/persist/index.d.ts

@@ -1,8 +1,9 @@
 export * from './Persistable';
 export * from './PersistOptions';
 export * from './PersistenceProvider';
-export * from './LocalStorageProvider';
-export * from './DashViewProvider';
-export * from './PrefProvider';
-export * from './CustomProvider';
-export * from './viewmanager/ViewManagerProvider';
+export * from './provider/LocalStorageProvider';
+export * from './provider/SessionStorageProvider';
+export * from './provider/DashViewProvider';
+export * from './provider/PrefProvider';
+export * from './provider/CustomProvider';
+export * from './provider/ViewManagerProvider';

package/build/types/core/persist/{CustomProvider.d.ts → provider/CustomProvider.d.ts}

@@ -1,4 +1,4 @@
-import { PersistenceProvider, PersistenceProviderConfig } from './';
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
 /**
  * A minimal Persistence provider for use by apps that wish to implement the actual persistence
  * of the backing data via custom handlers.

package/build/types/core/persist/{DashViewProvider.d.ts → provider/DashViewProvider.d.ts}

@@ -1,11 +1,11 @@
 import type { DashViewModel } from '@xh/hoist/desktop/cmp/dash';
-import { PersistenceProvider, PersistenceProviderConfig } from './';
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
 /**
  * PersistenceProvider that stores state within a DashViewModel.
  */
 export declare class DashViewProvider<S> extends PersistenceProvider<S> {
     readonly dashViewModel: DashViewModel;
     constructor(cfg: PersistenceProviderConfig<S>);
-    readRaw(): import("..").PlainObject;
+    readRaw(): import("../..").PlainObject;
     writeRaw(data: any): void;
 }

package/build/types/core/persist/{LocalStorageProvider.d.ts → provider/LocalStorageProvider.d.ts}

@@ -1,4 +1,4 @@
-import { PersistenceProvider, PersistenceProviderConfig } from './';
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
 /**
  * PersistenceProvider that stores state within the Browser's LocalStorage.
  */

package/build/types/core/persist/{PrefProvider.d.ts → provider/PrefProvider.d.ts}

@@ -1,5 +1,4 @@
-import { PersistenceProviderConfig } from '../';
-import { PersistenceProvider } from './';
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
 /**
  * PersistenceProvider that stores state within the Hoist Preferences system.
  */

package/build/types/core/persist/provider/SessionStorageProvider.d.ts

@@ -0,0 +1,10 @@
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
+/**
+ * PersistenceProvider that stores state within the Browser's SessionStorage.
+ */
+export declare class SessionStorageProvider<S> extends PersistenceProvider<S> {
+    readonly key: string;
+    constructor(cfg: PersistenceProviderConfig<S>);
+    readRaw(): any;
+    writeRaw(data: any): void;
+}

package/build/types/core/persist/{viewmanager → provider}/ViewManagerProvider.d.ts

@@ -1,10 +1,10 @@
-import { PersistenceProvider, PersistenceProviderConfig } from '../index';
-import type { ViewManagerModel } from './index';
+import { PersistenceProvider, PersistenceProviderConfig } from '../PersistenceProvider';
+import type { ViewManagerModel } from '@xh/hoist/cmp/viewmanager/ViewManagerModel';
 export declare class ViewManagerProvider<S> extends PersistenceProvider<S> {
     readonly viewManagerModel: ViewManagerModel;
     constructor(cfg: PersistenceProviderConfig<S>);
     pushStateToTarget(): void;
-    readRaw(): import("../..").PlainObject;
+    readRaw(): Partial<import("../..").PlainObject>;
     writeRaw(data: Record<typeof this.path, S>): void;
     destroy(): void;
 }

package/build/types/desktop/cmp/viewmanager/ViewManager.d.ts

@@ -1,17 +1,14 @@
 /// <reference types="react" />
 import { HoistProps } from '@xh/hoist/core';
-import './ViewManager.scss';
-import { ViewManagerModel } from '@xh/hoist/core/persist/viewmanager/ViewManagerModel';
+import { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
 import { ButtonProps } from '@xh/hoist/desktop/cmp/button';
+import './ViewManager.scss';
 /**
  * Visibility options for save/revert button.
  *
  * 'never' to hide button.
  * 'whenDirty' to only show when persistence state is dirty and button is therefore enabled.
- * 'always' will always show button, unless autoSave is active.
- *
- *  Note that we never show the button when 'autoSave' is active because it would never be enabled
- *  for more than a flash.
+ * 'always' will always show button.
  */
 export type ViewManagerStateButtonMode = 'whenDirty' | 'always' | 'never';
 export interface ViewManagerProps extends HoistProps<ViewManagerModel> {
@@ -22,14 +19,16 @@ export interface ViewManagerProps extends HoistProps<ViewManagerModel> {
     showSaveButton?: ViewManagerStateButtonMode;
     /** Default 'never' */
     showRevertButton?: ViewManagerStateButtonMode;
-    /** True to render private views in sub-menu (Default false)*/
+    /** Side the save and revert buttons should appear on (default 'right') */
+    buttonSide?: 'left' | 'right';
+    /** True to render private views in sub-menu (Default false) */
     showPrivateViewsInSubMenu?: boolean;
-    /** True to render shared views in sub-menu (Default false)*/
-    showSharedViewsInSubMenu?: boolean;
+    /** True to render global views in sub-menu (Default false) */
+    showGlobalViewsInSubMenu?: boolean;
 }
 /**
  * Desktop ViewManager component - a button-based menu for saving and swapping between named
- * bundles of persisted component state (eg grid views, dashboards, and similar).
+ * bundles of persisted component state (e.g. grid views, dashboards, and similar).
  *
  * See {@link ViewManagerModel} for additional details and configuration options.
  */

package/build/types/desktop/cmp/viewmanager/ViewMenu.d.ts

@@ -0,0 +1,5 @@
+import { ViewManagerProps } from './ViewManager';
+/**
+ * Default Menu used by ViewManager.
+ */
+export declare const viewMenu: import("@xh/hoist/core").ElementFactory<ViewManagerProps>;

package/build/types/desktop/cmp/viewmanager/dialog/EditForm.d.ts

@@ -0,0 +1,5 @@
+import { EditFormModel } from '@xh/hoist/desktop/cmp/viewmanager/dialog/EditFormModel';
+/**
+ * Default Edit Form for ViewManager
+ */
+export declare const editForm: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<EditFormModel>>;

package/build/types/desktop/cmp/viewmanager/dialog/EditFormModel.d.ts

@@ -0,0 +1,18 @@
+import { FormModel } from '@xh/hoist/cmp/form';
+import { HoistModel, TaskObserver } from '@xh/hoist/core';
+import { ManageDialogModel } from './ManageDialogModel';
+import { ViewInfo } from '@xh/hoist/cmp/viewmanager';
+/**
+ * Backing model for EditForm
+ */
+export declare class EditFormModel extends HoistModel {
+    parent: ManageDialogModel;
+    formModel: FormModel;
+    view: ViewInfo;
+    setView(view: ViewInfo): any;
+    get loadTask(): TaskObserver;
+    get showSaveButton(): boolean;
+    constructor(parent: ManageDialogModel);
+    saveAsync(): Promise<void>;
+    private createFormModel;
+}

package/build/types/desktop/cmp/viewmanager/dialog/ManageDialog.d.ts

@@ -0,0 +1,5 @@
+import { ManageDialogModel } from './ManageDialogModel';
+/**
+ * Default management dialog for ViewManager
+ */
+export declare const manageDialog: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<ManageDialogModel>>;

package/build/types/desktop/cmp/viewmanager/dialog/ManageDialogModel.d.ts

@@ -0,0 +1,38 @@
+import { GridModel } from '@xh/hoist/cmp/grid';
+import { TabContainerModel } from '@xh/hoist/cmp/tab';
+import { HoistModel, LoadSpec, TaskObserver } from '@xh/hoist/core';
+import { FilterTestFn } from '@xh/hoist/data';
+import { EditFormModel } from './EditFormModel';
+import { ViewInfo, ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
+/**
+ * Backing model for ManageDialog
+ */
+export declare class ManageDialogModel extends HoistModel {
+    viewManagerModel: ViewManagerModel;
+    privateGridModel: GridModel;
+    globalGridModel: GridModel;
+    editFormModel: EditFormModel;
+    tabContainerModel: TabContainerModel;
+    filter: FilterTestFn;
+    readonly updateTask: TaskObserver;
+    get loadTask(): TaskObserver;
+    get gridModel(): GridModel;
+    get selectedView(): ViewInfo;
+    get selectedViews(): ViewInfo[];
+    get canDelete(): boolean;
+    get manageGlobal(): boolean;
+    get typeDisplayName(): string;
+    get globalDisplayName(): string;
+    get enableFavorites(): boolean;
+    constructor();
+    close(): void;
+    onLinked(): void;
+    doLoadAsync(loadSpec: LoadSpec): Promise<void>;
+    deleteAsync(views: ViewInfo[]): Promise<void>;
+    updateAsync(view: ViewInfo, name: string, description: string, isGlobal: boolean): Promise<void>;
+    private doUpdateAsync;
+    private doDeleteAsync;
+    selectViewAsync(view: ViewInfo): Promise<void>;
+    private createGridModel;
+    private createTabContainerModel;
+}

package/build/types/desktop/cmp/viewmanager/dialog/SaveAsDialog.d.ts

@@ -0,0 +1,5 @@
+import { SaveAsDialogModel } from '@xh/hoist/cmp/viewmanager/';
+/**
+ * Default Save As dialog used by ViewManager.
+ */
+export declare const saveAsDialog: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<SaveAsDialogModel>>;

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

@@ -1,7 +1,7 @@
 import { HoistService, LoadSpec, PlainObject } from '@xh/hoist/core';
 export interface JsonBlob {
     /** Either null for private blobs or special token "*" for globally shared blobs. */
-    acl: string;
+    acl: '*';
     /** True if this blob has been archived (soft-deleted). */
     archived: boolean;
     /** Timestamp indicating when this blob was archived, or special value `0` if not archived. */

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

@@ -10,7 +10,8 @@ export * from './IdentityService';
 export * from './IdleService';
 export * from './InspectorService';
 export * from './JsonBlobService';
-export * from './LocalStorageService';
 export * from './PrefService';
 export * from './TrackService';
 export * from './WebSocketService';
+export * from './storage/LocalStorageService';
+export * from './storage/SessionStorageService';

package/build/types/svc/storage/BaseStorageService.d.ts

@@ -0,0 +1,21 @@
+import { HoistService } from '@xh/hoist/core';
+import { StoreType } from 'store2';
+/**
+ * Service to provide simple key/value access to browser local/session storage, appropriately
+ * namespaced by application code and username.
+ *
+ * In the unexpected case that the core apis are not available, will provide a transient in-memory
+ * storage to support its operations and API.
+ */
+export declare abstract class BaseStorageService extends HoistService {
+    constructor();
+    get(key: string, defaultValue?: any): any;
+    set(key: string, value: any): void;
+    apply(key: string, newProps: object): void;
+    remove(key: string): void;
+    removeIf(predicateFn: (s: string) => boolean): void;
+    clear(): void;
+    keys(): string[];
+    get isFake(): boolean;
+    protected abstract get storeInstance(): StoreType;
+}

package/build/types/svc/storage/LocalStorageService.d.ts

@@ -0,0 +1,12 @@
+import { BaseStorageService } from '@xh/hoist/svc/storage/BaseStorageService';
+import { StoreType } from 'store2';
+/**
+ * Service to provide simple key/value access to browser local storage, appropriately namespaced
+ * by application code and username.
+ *
+ * Relied upon by Hoist persistence mechanisms when using key 'localStorageKey`
+ */
+export declare class LocalStorageService extends BaseStorageService {
+    static instance: LocalStorageService;
+    protected get storeInstance(): StoreType;
+}

package/build/types/svc/storage/SessionStorageService.d.ts

@@ -0,0 +1,12 @@
+import { BaseStorageService } from '@xh/hoist/svc/storage/BaseStorageService';
+import { StoreType } from 'store2';
+/**
+ * Service to provide simple key/value access to browser session storage, appropriately namespaced
+ * by application code and username.
+ *
+ * Relied upon by Hoist persistence mechanisms when using key 'sessionStorageKey`
+ */
+export declare class SessionStorageService extends BaseStorageService {
+    static instance: SessionStorageService;
+    protected get storeInstance(): StoreType;
+}

package/cmp/chart/impl/copyToClipboard.ts

@@ -7,8 +7,7 @@
 import {XH} from '@xh/hoist/core';
 
 /**
- * Copy the chart in it's current state to the clipboard.
- * Works only on webkit based browsers.
+ * Copy the chart in its current state to the clipboard - supported for webkit based browsers only.
  * @internal
  */
 export function installCopyToClipboard(Highcharts) {