@xh/hoist 73.0.0-SNAPSHOT.1744142528681 → 73.0.0-SNAPSHOT.1744145292985

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## v73.0.0-SNAPSHOT - unreleased
 
+### 🎁 New Features
+
+`ViewManagerConfig` takes new key `customViewMenuItem` to allow ViewManagers implementations to customize
+ the menu items for views in the view manager menu.
+
 ## v72.3.0 - 2025-04-08
 
 ### 🎁 New Features

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

@@ -1,5 +1,6 @@
 import { HoistModel, LoadSpec, PlainObject, TaskObserver, Thunkable } from '@xh/hoist/core';
 import type { ViewManagerProvider } from '@xh/hoist/core';
+import { ReactNode } from 'react';
 import { ViewInfo } from './ViewInfo';
 import { View } from './View';
 export interface ViewCreateSpec {
@@ -85,6 +86,12 @@ export interface ViewManagerConfig {
      * Optional user-facing display name for describing global views. Defaults to 'global'
      */
     globalDisplayName?: string;
+    /**
+     * Optional key used as route param for view tokens.  Specify if you have customized your
+     * ViewManager implementation to be routable, and you want users to be able to Ctrl+Click or
+     * ContextMenu Click to open views from the view menu in new tabs or windows.
+     */
+    customViewMenuItem?: (view: ViewInfo) => ReactNode;
 }
 /**
  *  ViewManagerModel coordinates the loading, saving, and management of user-defined bundles of
@@ -121,6 +128,7 @@ export declare class ViewManagerModel<T = PlainObject> extends HoistModel {
     readonly instance: string;
     readonly typeDisplayName: string;
     readonly globalDisplayName: string;
+    readonly customViewMenuItem: (view: ViewInfo) => ReactNode;
     readonly enableAutoSave: boolean;
     readonly enableDefault: boolean;
     readonly enableGlobal: boolean;

package/cmp/viewmanager/ViewManagerModel.ts

@@ -123,6 +123,13 @@ export interface ViewManagerConfig {
      * Optional user-facing display name for describing global views. Defaults to 'global'
      */
     globalDisplayName?: string;
+
+    /**
+     * Optional key used as route param for view tokens.  Specify if you have customized your
+     * ViewManager implementation to be routable, and you want users to be able to Ctrl+Click or
+     * ContextMenu Click to open views from the view menu in new tabs or windows.
+     */
+    customViewMenuItem?: (view: ViewInfo) => ReactNode;
 }
 
 /**
@@ -165,6 +172,7 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
     readonly instance: string;
     readonly typeDisplayName: string;
     readonly globalDisplayName: string;
+    readonly customViewMenuItem: (view: ViewInfo) => ReactNode;
     readonly enableAutoSave: boolean;
     readonly enableDefault: boolean;
     readonly enableGlobal: boolean;
@@ -283,6 +291,7 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
         instance = 'default',
         typeDisplayName,
         globalDisplayName = 'global',
+        customViewMenuItem,
         manageGlobal = false,
         enableAutoSave = true,
         enableDefault = true,
@@ -296,13 +305,14 @@ export class ViewManagerModel<T = PlainObject> extends HoistModel {
 
         throwIf(
             !enableDefault && !initialViewSpec,
-            "ViewManagerModel requires 'initialViewSpec' if `enableDefault` is false."
+            "ViewManagerModel requires 'initialViewSpec' if 'enableDefault' is false."
         );
 
         this.type = type;
         this.instance = instance;
         this.typeDisplayName = lowerCase(typeDisplayName ?? genDisplayName(type));
         this.globalDisplayName = globalDisplayName;
+        this.customViewMenuItem = customViewMenuItem;
         this.manageGlobal = executeIfFunction(manageGlobal) ?? false;
         this.enableDefault = enableDefault;
         this.enableGlobal = enableGlobal;

package/desktop/cmp/viewmanager/ViewMenu.ts

@@ -162,12 +162,14 @@ function viewMenuItem(view: ViewInfo, model: ViewManagerModel): ReactNode {
     if (!view.isOwned && view.owner) title.push(view.owner);
     if (view.description) title.push(view.description);
 
-    return menuItem({
-        className: 'xh-view-manager__menu-item',
-        key: view.token,
-        text: view.name,
-        title: title.join(' | '),
-        icon,
-        onClick: () => model.selectViewAsync(view).catchDefault()
-    });
+    return model.customViewMenuItem
+        ? model.customViewMenuItem(view)
+        : menuItem({
+              className: 'xh-view-manager__menu-item',
+              key: view.token,
+              text: view.name,
+              title: title.join(' | '),
+              icon,
+              onClick: () => model.selectViewAsync(view).catchDefault()
+          });
 }

package/package.json

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