@xh/hoist 71.0.0-SNAPSHOT.1733854822950 → 71.0.0-SNAPSHOT.1734551243081

package/CHANGELOG.md

@@ -9,6 +9,7 @@
   * 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.
 

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

@@ -19,10 +19,15 @@ export declare class View<T extends PlainObject = PlainObject> {
     readonly value: Partial<T>;
     private readonly model;
     get name(): string;
+    get group(): string;
+    get description(): string;
     get token(): string;
     get type(): string;
     get isDefault(): boolean;
     get isGlobal(): boolean;
+    get isShared(): boolean;
+    get isOwned(): boolean;
+    get isCurrentView(): boolean;
     get lastUpdated(): number;
     get typedName(): string;
     static fromBlob<T>(blob: JsonBlob, model: ViewManagerModel): View<T>;

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

@@ -1,30 +1,55 @@
 import { ViewManagerModel } from './ViewManagerModel';
 import { JsonBlob } from '@xh/hoist/svc';
+import { PlainObject } from '@xh/hoist/core';
 /**
  * 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.type}. */
+    /** App-defined type discriminator. */
     readonly type: string;
     /** User-supplied descriptive name. */
     readonly name: string;
     /** Description of the view. **/
     readonly description: string;
+    /** User owning this view. Null if the view is global.*/
+    readonly owner: string;
+    /** Is the owner making this view accessible to others? Always true for global views. */
+    readonly isShared: boolean;
     /** 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;
+    /** Optional group name used for bucketing this view in display. */
+    readonly group: string;
+    /**
+     * Should this view be pinned by users by default?
+     * This value is intended to be used for global views only.
+     */
+    readonly isDefaultPinned: boolean;
+    /**
+     * Original meta-data on views associated JsonBlob.
+     * Not typically used by applications.
+     * @internal
+     */
+    readonly meta: PlainObject;
     dateCreated: number;
     lastUpdated: number;
     lastUpdatedBy: string;
-    private readonly model;
+    readonly model: ViewManagerModel;
     constructor(blob: JsonBlob, model: ViewManagerModel);
+    get isOwned(): boolean;
+    get isEditable(): boolean;
+    get isCurrentView(): boolean;
+    /**
+     * True if this view should appear on the users easy access menu.
+     *
+     * This value is computed with the user persisted state along with the View's
+     * `defaultPinned` property.
+     */
+    get isPinned(): boolean;
     /**
-     * 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.
+     * The user indicated pin state for this view, or null if user has not indicated a preference.
      */
-    get isFavorite(): boolean;
+    get isUserPinned(): boolean | null;
     get typedName(): string;
 }

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

@@ -1,9 +1,8 @@
 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';
-import { ViewToBlobApi } from './ViewToBlobApi';
+import { ViewToBlobApi, ViewCreateSpec } from './ViewToBlobApi';
 export interface ViewManagerConfig {
     /**
      * True (default) to allow user to opt in to automatically saving changes to their current view.
@@ -15,8 +14,15 @@ export interface ViewManagerConfig {
      * 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;
+    /**
+     * True (default) to enable "global" views - i.e. views that are not owned by a user and are
+     * available to all.
+     */
+    enableGlobal?: boolean;
+    /**
+     * True (default) to allow users to share their views with other users.
+     */
+    enableSharing?: 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
@@ -27,11 +33,10 @@ export interface ViewManagerConfig {
      */
     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.
+     * Delay (in ms) to wait after state has been set on associated components before listening for
+     * further state changes. The long default wait 1000ms is intended to avoid a false positive
+     * dirty indicator when linking to complex components such as dashboards or grids that can
+     * report immediate changes to state due to internal processing or rendering.
      */
     settleTime?: number;
     /**
@@ -59,8 +64,8 @@ export interface ViewManagerConfig {
     globalDisplayName?: string;
 }
 export interface ViewManagerPersistOptions extends PersistOptions {
-    /** True to persist favorites or provide specific PersistOptions. (Default true) */
-    persistFavorites?: boolean | PersistOptions;
+    /** True to persist pinning preferences or provide specific PersistOptions. (Default true) */
+    persistPinning?: boolean | PersistOptions;
     /** True to include pending value or provide specific PersistOptions. (Default false) */
     persistPendingValue?: boolean | PersistOptions;
 }
@@ -72,8 +77,8 @@ export interface ViewManagerPersistOptions extends PersistOptions {
  *    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.
+ *  - Views can be private to their owner, or optionally enabled for sharing to (all) other users.
+ *  - Views can be marked as pinned for quick access.
  *  - See the desktop {@link ViewManager} component - the initial Hoist UI for this model.
  */
 export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
@@ -101,7 +106,8 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     readonly globalDisplayName: string;
     readonly enableAutoSave: boolean;
     readonly enableDefault: boolean;
-    readonly enableFavorites: boolean;
+    readonly enableGlobal: boolean;
+    readonly enableSharing: boolean;
     readonly manageGlobal: boolean;
     readonly settleTime: number;
     readonly initialViewSpec: (views: ViewInfo[]) => ViewInfo;
@@ -109,8 +115,13 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     view: View<T>;
     /** Loaded saved view library - both private and global */
     views: ViewInfo[];
-    /** List of tokens for the user's favorite views. */
-    favorites: string[];
+    /**
+     * Map of user's preferred pinned state for views.
+     *
+     * Note that the actual pinned state for the views is determined by this value, layered
+     * over the default state of the views themselves.
+     */
+    userPinned: Record<string, boolean>;
     /**
      * True if user has opted-in to automatically saving changes to personal views (if auto-save
      * generally available as per `enableAutoSave`).
@@ -121,12 +132,8 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
      * require intensive layout/grid work, consider masking affected components with this task.
      */
     selectTask: TaskObserver;
-    /**
-     * TaskObserver linked to {@link saveAsync}.
-     */
+    /** TaskObserver linked to {@link saveAsync}. */
     saveTask: TaskObserver;
-    manageDialogOpen: boolean;
-    saveAsDialogModel: SaveAsDialogModel;
     /** Unsaved changes on the current view.*/
     private pendingValue;
     /**
@@ -137,7 +144,7 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
      */
     providers: ViewManagerProvider<any>[];
     /**
-     * Data access for persisting views
+     * Data access for persisting views.
      * @internal
      */
     api: ViewToBlobApi<T>;
@@ -146,9 +153,13 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     get isViewSavable(): boolean;
     get isViewAutoSavable(): boolean;
     get autoSaveUnavailableReason(): string;
-    get favoriteViews(): ViewInfo[];
+    get pinnedViews(): ViewInfo[];
+    /** Views owned by me */
+    get ownedViews(): ViewInfo[];
+    /** Views shared *with* me */
+    get sharedViews(): ViewInfo[];
+    /** Global views */
     get globalViews(): ViewInfo[];
-    get privateViews(): ViewInfo[];
     /** True if any async tasks are pending. */
     get isLoading(): boolean;
     /**
@@ -158,18 +169,17 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     private constructor();
     doLoadAsync(loadSpec: LoadSpec): Promise<void>;
     selectViewAsync(info: ViewInfo): Promise<void>;
+    saveAsAsync(spec: ViewCreateSpec): 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;
+    togglePinned(view: ViewInfo): void;
+    userPin(view: ViewInfo): void;
+    userUnpin(view: ViewInfo): void;
+    isUserPinned(view: ViewInfo): boolean | null;
     validateViewNameAsync(name: string, existing?: ViewInfo): Promise<string>;
+    deleteViewsAsync(toDelete: ViewInfo[]): Promise<void>;
     private initAsync;
     private loadViewAsync;
     private maybeAutoSaveAsync;

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

@@ -2,19 +2,40 @@ 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;
+}
 /**
- * Class for accessing and updating views using JSON Blobs Service.
- *
+ * Class for accessing and updating views using {@link JsonBlobService}.
  * @internal
  */
 export declare class ViewToBlobApi<T> {
-    private owner;
-    constructor(owner: ViewManagerModel<T>);
+    private readonly model;
+    constructor(model: ViewManagerModel<T>);
+    /** Fetch metadata for all views accessible by current user. */
     fetchViewInfosAsync(): Promise<ViewInfo[]>;
+    /** Fetch the latest version of a view. */
     fetchViewAsync(info: ViewInfo): Promise<View<T>>;
-    createViewAsync(name: string, description: string, value: PlainObject): Promise<View<T>>;
-    updateViewInfoAsync(view: ViewInfo, name: string, description: string, isGlobal: boolean): Promise<View<T>>;
+    /** Create a new view, owned by the current user.*/
+    createViewAsync(spec: ViewCreateSpec): Promise<View<T>>;
+    /** Update all aspects of a view's metadata.*/
+    updateViewInfoAsync(view: ViewInfo, updates: ViewUpdateSpec): Promise<View<T>>;
+    /** Promote a view to global visibility/ownership status. */
+    makeViewGlobalAsync(view: ViewInfo): Promise<View<T>>;
+    /** Update a view's value. */
     updateViewValueAsync(view: View<T>, value: Partial<T>): Promise<View<T>>;
-    deleteViewAsync(view: ViewInfo): Promise<void>;
+    deleteViewsAsync(views: ViewInfo[]): Promise<void>;
     private trackChange;
+    private ensureEditable;
 }

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

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

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

@@ -21,10 +21,6 @@ export interface ViewManagerProps extends HoistProps<ViewManagerModel> {
     showRevertButton?: ViewManagerStateButtonMode;
     /** 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 global views in sub-menu (Default false) */
-    showGlobalViewsInSubMenu?: boolean;
 }
 /**
  * Desktop ViewManager component - a button-based menu for saving and swapping between named

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

@@ -0,0 +1,11 @@
+import { HoistModel } from '@xh/hoist/core';
+import { ManageDialogModel } from './dialog/ManageDialogModel';
+import { SaveAsDialogModel } from './dialog/SaveAsDialogModel';
+import { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
+export declare class ViewManagerLocalModel extends HoistModel {
+    readonly parent: ViewManagerModel;
+    readonly manageDialogModel: ManageDialogModel;
+    readonly saveAsDialogModel: SaveAsDialogModel;
+    isVisible: boolean;
+    constructor(parent: ViewManagerModel);
+}

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

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

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

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

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

@@ -1,17 +1,19 @@
 import { GridModel } from '@xh/hoist/cmp/grid';
 import { TabContainerModel } from '@xh/hoist/cmp/tab';
+import { ViewInfo, ViewManagerModel, ViewUpdateSpec } from '@xh/hoist/cmp/viewmanager';
 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';
+import { ViewPanelModel } from './ViewPanelModel';
 /**
  * Backing model for ManageDialog
  */
 export declare class ManageDialogModel extends HoistModel {
     viewManagerModel: ViewManagerModel;
-    privateGridModel: GridModel;
+    isOpen: boolean;
+    ownedGridModel: GridModel;
     globalGridModel: GridModel;
-    editFormModel: EditFormModel;
+    sharedGridModel: GridModel;
+    viewPanelModel: ViewPanelModel;
     tabContainerModel: TabContainerModel;
     filter: FilterTestFn;
     readonly updateTask: TaskObserver;
@@ -19,20 +21,23 @@ export declare class ManageDialogModel extends HoistModel {
     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();
+    constructor(viewManagerModel: ViewManagerModel);
+    open(): void;
     close(): void;
-    onLinked(): void;
+    activateSelectedViewAndClose(): void;
     doLoadAsync(loadSpec: LoadSpec): Promise<void>;
     deleteAsync(views: ViewInfo[]): Promise<void>;
-    updateAsync(view: ViewInfo, name: string, description: string, isGlobal: boolean): Promise<void>;
+    updateAsync(view: ViewInfo, update: ViewUpdateSpec): Promise<void>;
+    makeGlobalAsync(view: ViewInfo): Promise<void>;
+    togglePinned(views: ViewInfo[]): void;
+    private init;
     private doUpdateAsync;
     private doDeleteAsync;
-    selectViewAsync(view: ViewInfo): Promise<void>;
+    private doMakeGlobalAsync;
+    private selectViewAsync;
     private createGridModel;
     private createTabContainerModel;
+    private get ownedTabTitle();
+    private get globalTabTitle();
+    private get sharedTabTitle();
 }

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

@@ -1,4 +1,4 @@
-import { SaveAsDialogModel } from '@xh/hoist/cmp/viewmanager/';
+import { SaveAsDialogModel } from './SaveAsDialogModel';
 /**
  * Default Save As dialog used by ViewManager.
  */

package/build/types/{cmp/viewmanager → desktop/cmp/viewmanager/dialog}/SaveAsDialogModel.d.ts

@@ -1,7 +1,6 @@
 import { FormModel } from '@xh/hoist/cmp/form';
 import { HoistModel } from '@xh/hoist/core';
-import { View } from './View';
-import { ViewManagerModel } from './ViewManagerModel';
+import { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
 /**
  * Backing model for ViewManagerModel's SaveAs
  */
@@ -9,15 +8,10 @@ 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;
+    open(): void;
+    close(): void;
     saveAsAsync(): Promise<void>;
     private createFormModel;
     private doSaveAsAsync;
-    private close;
 }

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

@@ -0,0 +1,3 @@
+import { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
+import { SelectOption } from '@xh/hoist/core';
+export declare function getGroupOptions(model: ViewManagerModel, type: 'owned' | 'global'): SelectOption[];

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

@@ -0,0 +1,2 @@
+import { ManageDialogModel } from './ManageDialogModel';
+export declare const viewMultiPanel: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<ManageDialogModel>>;

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

@@ -0,0 +1,5 @@
+import { ViewPanelModel } from '@xh/hoist/desktop/cmp/viewmanager/dialog/ViewPanelModel';
+/**
+ * Form to edit or view details on a single saved view within the ViewManager manage dialog.
+ */
+export declare const viewPanel: import("@xh/hoist/core").ElementFactory<import("@xh/hoist/core").DefaultHoistProps<ViewPanelModel>>;

package/build/types/desktop/cmp/viewmanager/dialog/{EditFormModel.d.ts → ViewPanelModel.d.ts}

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

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

@@ -50,7 +50,7 @@ export declare class JsonBlobService extends HoistService {
     /** Persist a new JSONBlob back to the server. */
     createAsync({ acl, description, type, meta, name, value }: Partial<JsonBlob>): Promise<JsonBlob>;
     /** Modify mutable properties of an existing JSONBlob, as identified by its unique token. */
-    updateAsync(token: string, { acl, description, meta, name, value }: Partial<JsonBlob>): Promise<JsonBlob>;
+    updateAsync(token: string, { acl, description, meta, name, owner, value }: Partial<JsonBlob>): Promise<JsonBlob>;
     /** Archive (soft-delete) an existing JSONBlob, as identified by its unique token. */
     archiveAsync(token: string): Promise<JsonBlob>;
 }

package/cmp/viewmanager/View.ts

@@ -27,6 +27,14 @@ export class View<T extends PlainObject = PlainObject> {
         return this.info?.name ?? 'Default';
     }
 
+    get group(): string {
+        return this.info?.group;
+    }
+
+    get description(): string {
+        return this.info?.description;
+    }
+
     get token(): string {
         return this.info?.token ?? null;
     }
@@ -43,12 +51,24 @@ export class View<T extends PlainObject = PlainObject> {
         return this.info?.isGlobal ?? false;
     }
 
+    get isShared(): boolean {
+        return this.info?.isShared ?? false;
+    }
+
+    get isOwned(): boolean {
+        return this.info?.isOwned ?? false;
+    }
+
+    get isCurrentView(): boolean {
+        return this.token === this.model.view.token;
+    }
+
     get lastUpdated(): number {
         return this.info?.lastUpdated ?? null;
     }
 
     get typedName(): string {
-        return `${this.model.typeDisplayName} '${this.name}'`;
+        return `${this.model.typeDisplayName} "${this.name}"`;
     }
 
     static fromBlob<T>(blob: JsonBlob, model: ViewManagerModel): View<T> {

package/cmp/viewmanager/ViewInfo.ts

@@ -1,6 +1,7 @@
 import {SECONDS} from '@xh/hoist/utils/datetime';
 import {ViewManagerModel} from './ViewManagerModel';
 import {JsonBlob} from '@xh/hoist/svc';
+import {PlainObject, XH} from '@xh/hoist/core';
 
 /**
  * Metadata describing {@link View} managed by {@link ViewManagerModel}.
@@ -9,7 +10,7 @@ export class ViewInfo {
     /** Unique Id */
     readonly token: string;
 
-    /** App-defined type discriminator, as per {@link ViewManagerConfig.type}. */
+    /** App-defined type discriminator. */
     readonly type: string;
 
     /** User-supplied descriptive name. */
@@ -18,25 +19,50 @@ export class ViewInfo {
     /** Description of the view. **/
     readonly description: string;
 
+    /** User owning this view. Null if the view is global.*/
+    readonly owner: string;
+
+    /** Is the owner making this view accessible to others? Always true for global views. */
+    readonly isShared: boolean;
+
     /** 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;
+    /** Optional group name used for bucketing this view in display. */
+    readonly group: string;
+
+    /**
+     * Should this view be pinned by users by default?
+     * This value is intended to be used for global views only.
+     */
+    readonly isDefaultPinned: boolean;
+
+    /**
+     * Original meta-data on views associated JsonBlob.
+     * Not typically used by applications.
+     * @internal
+     */
+    readonly meta: PlainObject;
 
     dateCreated: number;
     lastUpdated: number;
     lastUpdatedBy: string;
 
-    private readonly model: ViewManagerModel;
+    readonly model: ViewManagerModel;
 
     constructor(blob: JsonBlob, model: ViewManagerModel) {
         this.token = blob.token;
         this.type = blob.type;
-        this.owner = blob.owner;
         this.name = blob.name;
         this.description = blob.description;
-        this.isGlobal = blob.acl === '*';
+        this.owner = blob.owner;
+        this.meta = (blob.meta as PlainObject) ?? {};
+        this.isGlobal = !this.owner;
+
+        this.group = this.meta.group ?? null;
+        this.isDefaultPinned = !!(this.isGlobal && this.meta.isDefaultPinned);
+        this.isShared = !!(!this.isGlobal && this.meta.isShared);
+
         // Round to seconds.  See: https://github.com/xh/hoist-core/issues/423
         this.dateCreated = Math.round(blob.dateCreated / SECONDS) * SECONDS;
         this.lastUpdated = Math.round(blob.lastUpdated / SECONDS) * SECONDS;
@@ -44,15 +70,36 @@ export class ViewInfo {
         this.model = model;
     }
 
+    get isOwned(): boolean {
+        return this.owner === XH.getUsername();
+    }
+
+    get isEditable(): boolean {
+        return this.isOwned || (this.isGlobal && this.model.manageGlobal);
+    }
+
+    get isCurrentView(): boolean {
+        return this.token === this.model.view.token;
+    }
+
+    /**
+     * True if this view should appear on the users easy access menu.
+     *
+     * This value is computed with the user persisted state along with the View's
+     * `defaultPinned` property.
+     */
+    get isPinned(): boolean {
+        return this.isUserPinned ?? this.isDefaultPinned;
+    }
+
     /**
-     * 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.
+     * The user indicated pin state for this view, or null if user has not indicated a preference.
      */
-    get isFavorite(): boolean {
-        return this.model.isFavorite(this.token);
+    get isUserPinned(): boolean | null {
+        return this.model.isUserPinned(this);
     }
 
     get typedName(): string {
-        return `${this.model.typeDisplayName} '${this.name}'`;
+        return `${this.model.typeDisplayName} "${this.name}"`;
     }
 }