@openfin/workspace 18.1.23 → 18.1.24

package/client-api-platform/src/api/context-menu/index.d.ts

@@ -1,9 +1,16 @@
 import type OpenFin from '@openfin/core';
-import { OpenGlobalContextMenuPayload, OpenGlobalContextMenuRequest, OpenPageTabContextMenuPayload, OpenPageTabContextMenuRequest, OpenSaveButtonContextMenuPayload, OpenSaveButtonContextMenuRequest, OpenViewTabContextMenuPayload, OpenViewTabContextMenuRequest, WorkspacePlatformProvider } from '../../../../client-api-platform/src/shapes';
-export declare function openGlobalContextMenuInternal(this: WorkspacePlatformProvider, payload: OpenGlobalContextMenuRequest & {
+import { InternalOpenGlobalContextMenuRequest, OpenGlobalContextMenuPayload, OpenPageTabContextMenuPayload, OpenPageTabContextMenuRequest, OpenSaveButtonContextMenuPayload, OpenSaveButtonContextMenuRequest, OpenViewTabContextMenuPayload, OpenViewTabContextMenuRequest, WorkspacePlatformProvider } from '../../../../client-api-platform/src/shapes';
+export declare enum AnchorBehavior {
+    BottomLeft = 0,
+    BottomRight = 1,
+    TopLeft = 2,
+    TopRight = 3,
+    Center = 4
+}
+export declare const openCommonContextMenu: (payload: OpenGlobalContextMenuPayload | OpenViewTabContextMenuPayload | OpenPageTabContextMenuPayload | OpenSaveButtonContextMenuPayload, _callerIdentity: OpenFin.Identity, anchorBehavior?: AnchorBehavior) => Promise<void>;
+export declare function openGlobalContextMenuInternal(this: WorkspacePlatformProvider, payload: InternalOpenGlobalContextMenuRequest & {
     identity: OpenFin.Identity;
 }, callerIdentity: OpenFin.Identity): Promise<void>;
-export declare const openCommonContextMenu: (payload: OpenGlobalContextMenuPayload | OpenViewTabContextMenuPayload | OpenPageTabContextMenuPayload | OpenSaveButtonContextMenuPayload, _callerIdentity: OpenFin.Identity) => Promise<void>;
 export declare function openViewTabContextMenuInternal(this: WorkspacePlatformProvider, payload: OpenViewTabContextMenuRequest & {
     identity: OpenFin.Identity;
 }, callerIdentity: OpenFin.Identity): Promise<void>;

package/client-api-platform/src/shapes.d.ts

@@ -87,9 +87,9 @@ export interface ReorderPagesRequest {
  * Request for opening a logo context menu in Browser.
  */
 export interface OpenGlobalContextMenuRequest {
-    /** Screen x-coordinate where context menu should be shown. */
+    /** Client x-coordinate where context menu should be shown. */
     x: number;
-    /** Screen y-coordinate where context menu should be shown. */
+    /** Client y-coordinate where context menu should be shown. */
     y: number;
     /** Miscellaneous options necessary for implementing custom logic in the provider override. */
     customData?: any;
@@ -225,28 +225,37 @@ export type OpenGlobalContextMenuPayload = OpenGlobalContextMenuRequest & {
     /** Default function that handles stock context menu options. */
     callback: (data: GlobalContextMenuItemData, payload: OpenGlobalContextMenuPayload) => any;
 };
+/**
+ * Request for opening the global context menu with custom context menu in Enterprise Browser.
+ * @internal
+ */
+export type InternalOpenGlobalContextMenuRequest = OpenGlobalContextMenuRequest & {
+    /** Coordinates associated with a target element for a custom context menu request. */
+    rect?: DOMRect;
+};
 export type ViewTabContextMenuTemplate = OpenFin.MenuItemTemplate<ViewTabMenuData>;
 /**
  * Request for opening a view tab context menu in Browser.
  */
 export interface OpenViewTabContextMenuRequest {
-    /** Screen x-coordinate where context menu should be shown. */
+    /** Client x-coordinate where context menu should be shown. */
     x: number;
-    /** Screen y-coordinate where context menu should be shown. */
+    /** Client y-coordinate where context menu should be shown. */
     y: number;
     /** Miscellaneous options necessary for implementing custom logic in the provider override. */
     customData?: any;
     /** Template defining the options to show in the context menu. */
     template: ViewTabContextMenuTemplate[];
+    /** Ids of selected views */
     selectedViews: OpenFin.Identity[];
 }
 /**
  * Request for opening a page tab context menu in Browser.
  */
 export interface OpenPageTabContextMenuRequest {
-    /** Screen x-coordinate where context menu should be shown. */
+    /** Client x-coordinate where context menu should be shown. */
     x: number;
-    /** Screen y-coordinate where context menu should be shown. */
+    /** Client y-coordinate where context menu should be shown. */
     y: number;
     /** Miscellaneous options necessary for implementing custom logic in the provider override. */
     customData?: any;
@@ -523,9 +532,9 @@ export interface SaveButtonContextMenuItemTemplate extends OpenFin.MenuItemTempl
  * Request for opening a context menu from save button in Browser.
  */
 export interface OpenSaveButtonContextMenuRequest {
-    /** Screen x-coordinate where context menu should be shown. */
+    /** Client x-coordinate where context menu should be shown. */
     x: number;
-    /** Screen y-coordinate where context menu should be shown. */
+    /** Client y-coordinate where context menu should be shown. */
     y: number;
     /** Screen x-coordinate of save button */
     buttonLeft: number;
@@ -986,7 +995,7 @@ export interface BrowserWindowModule {
      * @param req the global context menu request.
      * @internal
      */
-    _openGlobalContextMenu(req: OpenGlobalContextMenuRequest): Promise<void>;
+    _openGlobalContextMenu(req: InternalOpenGlobalContextMenuRequest): Promise<void>;
     /** @internal */
     _openViewTabContextMenu(req: OpenViewTabContextMenuRequest): Promise<void>;
     /** @internal */
@@ -1067,6 +1076,7 @@ export type NavigationRequest = {
     viewIdentity: OpenFin.Identity;
 } & ({
     action: 'result-selected';
+    trigger?: SiteAction;
     site: Site;
 } | (SearchSitesRequest & {
     action: 'search-input';
@@ -1080,29 +1090,53 @@ export type SearchSitesRequest = {
 /**
  * @internal
  */
-export type SearchSitesResponse = {
-    suggestions?: Site[];
-    favorites?: Site[];
-    bookmarks?: Site[];
-    platformContent?: Site[];
+export type SearchSitesResponse = Record<string, Site[]>;
+/**
+ * @internal
+ */
+export type SiteAction = {
+    id: string;
+    title: string;
+    altText?: string;
+    lightIcon?: string;
+    darkIcon?: string;
 };
 /**
  * @internal
  */
-export type Site = {
+export type SiteInfo = {
     id: string;
     title: string;
+    subTitle?: string;
     cta?: string;
+    actions?: SiteAction[];
+};
+/**
+ * @internal
+ */
+export type AppSite = SiteInfo & {
     type: 'app' | 'website';
-    url: string;
+    url?: string;
     icon: string;
     customData?: unknown;
-} | {
-    id: string;
-    title: string;
-    cta?: string;
+};
+/**
+ * @internal
+ */
+export type WorkspaceSite = SiteInfo & {
     type: 'page' | 'workspace';
 };
+/**
+ * @internal
+ */
+export type Site = AppSite | WorkspaceSite;
+/**
+ * @internal
+ * action is undefined when the site is actioned with the default action.
+ */
+export type ActionedSite = Site & {
+    action?: SiteAction;
+};
 /**
  * Factory for wrapping browser windows and global operations.
  */

package/common/src/utils/context-menu.d.ts

@@ -1,4 +1,5 @@
 import type OpenFin from '@openfin/core';
+import { AnchorBehavior } from '../../../client-api-platform/src/api/context-menu';
 export declare enum MenuItemType {
     Label = "normal",
     Separator = "separator",
@@ -8,7 +9,8 @@ export declare enum MenuItemType {
 export type ShowContextMenuResponse = OpenFin.MenuResult & {
     data: any;
 };
-export default function showContextMenu(opts: OpenFin.ShowPopupMenuOptions, win?: OpenFin.Window): Promise<ShowContextMenuResponse>;
+export declare function showContextMenu(opts: OpenFin.ShowPopupMenuOptions, win?: OpenFin.Window): Promise<ShowContextMenuResponse>;
+export declare const showEnterpriseContextMenu: (opts: OpenFin.ShowPopupMenuOptions, win?: OpenFin.Window, anchorBehavior?: AnchorBehavior) => Promise<ShowContextMenuResponse>;
 export declare const Separator: OpenFin.MenuItemTemplate;
 export declare const EmptyContextMenuItem: OpenFin.MenuItemTemplate;
 export declare const DefaultSaveMenuBounds: {

package/common/src/utils/route.d.ts

@@ -22,7 +22,8 @@ export declare enum PageRoute {
     Storefront = "/storefront/",
     DeprecatedAlert = "/provider/deprecated-alert/",
     Analytics = "/provider/analytics/",
-    EnterpriseBrowser = "/browser/enterprise/"
+    EnterpriseBrowser = "/browser/enterprise/",
+    EnterpriseContextMenu = "/browser/enterprise/context-menu/"
 }
 export declare const Assets: {
     readonly IconOpenFinLogo: "/icons/openfinlogo.svg";

package/common/src/utils/window.d.ts

@@ -10,6 +10,7 @@ export declare enum WindowName {
     BrowserIndicator = "openfin-browser-indicator",
     BrowserWindow = "internal-generated-window",
     ClassicWindow = "internal-generated-classic-window",
+    EnterpriseContextMenu = "openfin-enterprise-context-menu",
     BrowserAddressSearchPrefix = "openfin-browser-menu-address-search-"
 }
 export interface WindowIdentity {