@openfin/workspace 24.1.0 → 24.1.2-alpha.c84bc0a1

package/common/src/utils/indicators/showIndicator.d.ts

@@ -50,6 +50,13 @@ export declare function showSuccess(payload: ShowSuccessPayload): Promise<void>;
  */
 export declare function showInfo(payload: ShowInfoPayload): Promise<void>;
 /**
- * Creates a window centered on monitor containing a success indicator for switching workspaces
+ * Creates a window centered on monitor containing a success indicator for switching workspaces.
+ * No-ops when `suppressWorkspaceSwitched` has been set via `BrowserInitConfig.indicators`.
  */
 export declare function showSwitchWorkspaceSuccess(): Promise<void>;
+/**
+ * Creates a success indicator for workspace save and save-as operations.
+ * No-ops when `suppressWorkspaceSaved` has been set via `BrowserInitConfig.indicators`.
+ * Rename operations are intentionally unaffected — use `showSuccess` directly for those.
+ */
+export declare const showWorkspaceSavedSuccess: (payload: ShowSuccessPayload) => Promise<void>;

package/common/src/utils/indicators/workspace-indicators.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Configuration for suppressing workspace success indicators.
+ */
+export interface WorkspaceIndicatorConfig {
+    /** Suppress the "Workspace Switched" indicator on all applyWorkspace calls. @default false */
+    suppressWorkspaceSwitched?: boolean;
+    /** Suppress the "Workspace Saved" indicator on regular workspace save only. Save-as and rename are unaffected. @default false */
+    suppressWorkspaceSaved?: boolean;
+}
+export declare const initWorkspaceIndicators: (config?: WorkspaceIndicatorConfig) => void;
+export declare const getSuppressWorkspaceSwitched: () => boolean;
+/** Returns true when the "Workspace Saved" indicator should be suppressed (save only; save-as and rename are unaffected). */
+export declare const getSuppressWorkspaceSaved: () => boolean;

package/common/src/utils/modal-bounds.d.ts

@@ -1,4 +1,5 @@
 import type OpenFin from '@openfin/core';
+import { AnchorBehavior } from '../../../client-api-platform/src/api/context-menu';
 import { ResponseModalConfig } from './menu-config';
 import { Point } from './window';
 /**
@@ -59,3 +60,22 @@ export declare function getBoundsCenteredAndFitOnMonitor(height: number, width:
     left: number;
     top: number;
 }>;
+/**
+ * Calculates the final popup bounds relative to a parent window, accounting for:
+ * - Windows 10/11 maximized window shadow offset (Electron bug)
+ * - Anchor behavior (e.g. BottomRight, TopLeft)
+ * - Off-screen clamping to keep the popup within monitor bounds
+ *
+ * @param parentIdentity - The identity of the parent window.
+ * @param contentDimensions - The width and height of the popup content.
+ * @param position - The desired x/y position relative to the parent window.
+ * @param anchorBehavior - Optional anchor behavior to adjust positioning.
+ * @returns Bounds relative to the parent window, clamped to the nearest monitor.
+ */
+export declare const getPopupBoundsRelativeToParent: (parentIdentity: OpenFin.Identity, contentDimensions: {
+    width: number;
+    height: number;
+}, position: {
+    x: number;
+    y: number;
+}, anchorBehavior?: AnchorBehavior) => Promise<OpenFin.Bounds>;

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

@@ -1,2 +1,4 @@
+/** @internal Reset cached host specs — only for test isolation */
+export declare const resetHostSpecsCache: () => void;
 export declare const isOSWindows: () => Promise<boolean>;
 export declare const isWindows10Or11: () => Promise<boolean>;

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

@@ -39,19 +39,19 @@ export type BrowserSearchMenuKeyboardEvent = {
         altKey?: boolean;
     };
 };
-export declare enum EnterpriseMenuType {
+export declare enum PopupWindowMenuType {
     GlobalMenu = "global-menu",
     ContextMenu = "context-menu",
     RenameSupertab = "rename-supertab",
     AddEditBookmark = "add-edit-bookmark",
     DropdownMenu = "dropdown-menu",
-    ZoomControls = "zoom-controls"
+    TabSearch = "tab-search"
 }
 export type BookmarkButtonPayload = {
     selectedViewIdentity: OpenFin.Identity;
 };
-export type BaseEnterpriseMenuChannelMessage = {
-    type: EnterpriseMenuType;
+export type BasePopupMenuChannelMessage = {
+    type: PopupWindowMenuType;
     /**
      * The identity of the window the dialog/menu invocation came from.
      */
@@ -67,29 +67,35 @@ export type BaseEnterpriseMenuChannelMessage = {
     x: number;
     y: number;
 };
-export type ContextMenuChannelMessage = BaseEnterpriseMenuChannelMessage & {
-    type: EnterpriseMenuType.ContextMenu | EnterpriseMenuType.GlobalMenu;
+export type ContextMenuChannelMessage = BasePopupMenuChannelMessage & {
+    type: PopupWindowMenuType.ContextMenu | PopupWindowMenuType.GlobalMenu;
     /**
      * The unique request ID of the context menu invocation.
      */
     requestId: string;
     payload: OpenFin.ShowPopupMenuOptions;
 };
-export type BookmarkDialogChannelMessage = BaseEnterpriseMenuChannelMessage & {
-    type: EnterpriseMenuType.AddEditBookmark;
+export type BookmarkDialogChannelMessage = BasePopupMenuChannelMessage & {
+    type: PopupWindowMenuType.AddEditBookmark;
     payload: BookmarkButtonPayload;
 };
-export type ZoomControlsDialogPayload = {
-    selectedViewIdentity?: OpenFin.Identity;
-    zoomPercent?: number;
-    openedViaMouseClick?: boolean;
-};
-export type ZoomControlsDialogChannelMessage = BaseEnterpriseMenuChannelMessage & {
-    type: EnterpriseMenuType.ZoomControls;
-    payload: ZoomControlsDialogPayload;
+/** Sent from browser to zoom dialog window to position and hydrate UI (initial open or live sync). */
+export type ZoomControlsDialogStateMessage = {
+    /**
+     * The identity of the window the dialog/menu invocation came from.
+     */
+    parentIdentity: OpenFin.Identity;
+    x: number;
+    y: number;
+    payload: {
+        selectedViewIdentity?: OpenFin.Identity;
+        zoomPercent?: number;
+        openedViaMouseClick?: boolean;
+    };
 };
-export type DropdownMenuChannelMessage = BaseEnterpriseMenuChannelMessage & {
-    type: EnterpriseMenuType.DropdownMenu;
+export declare const ZOOM_DIALOG_CHANNEL_ACTION: "state";
+export type DropdownMenuChannelMessage = BasePopupMenuChannelMessage & {
+    type: PopupWindowMenuType.DropdownMenu;
     payload: {
         template: Array<OpenFin.MenuItemTemplate>;
         /**
@@ -98,8 +104,8 @@ export type DropdownMenuChannelMessage = BaseEnterpriseMenuChannelMessage & {
         width: number;
     };
 };
-export type RenameSupertabChannelMessage = BaseEnterpriseMenuChannelMessage & {
-    type: EnterpriseMenuType.RenameSupertab;
+export type RenameSupertabChannelMessage = BasePopupMenuChannelMessage & {
+    type: PopupWindowMenuType.RenameSupertab;
     payload: {
         /**
          * The pageId of the page being renamed.
@@ -107,6 +113,18 @@ export type RenameSupertabChannelMessage = BaseEnterpriseMenuChannelMessage & {
         pageId: string;
     };
 };
+export type TabSearchModalContent = {
+    variant: 'page' | 'view';
+    tabs: {
+        title: string;
+        id: string;
+    }[];
+};
+export type TabSearchChannelMessage = BasePopupMenuChannelMessage & {
+    type: PopupWindowMenuType.TabSearch;
+    requestId: string;
+    payload: TabSearchModalContent;
+};
 export type SearchMenuChannelResponse = {
     type: 'ready';
 } | {
@@ -135,5 +153,4 @@ export type SearchMenuChannelResponse = {
     type: 'single-provider-results-announcement';
     message: string;
 };
-export declare function showPopupWin<T extends keyof UserMenuParams>(parentWindow: OpenFin.Window, params: UserMenuParams[T], windowOpts: OpenFin.PopupOptions): Promise<OpenFin.PopupResult>;
 export {};

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

@@ -31,6 +31,7 @@ declare enum BrowserRoute {
     EnterpriseAboutPage = "/popup-menu/about/",
     StorageProxy = "/storage-proxy",
     DropdownMenu = "/dropdown-menu/",
+    TabSearchModal = "/popup-menu/tab-search-modal/",
     EnterpriseDock = "/dock/",
     ZoomControlsDialog = "/zoom-controls-dialog/",
     DesktopSignalsModal = "/popup-menu/desktop-signals-modal/",
@@ -54,6 +55,7 @@ declare const PageRoute: {
     EnterpriseAboutPage: BrowserRoute.EnterpriseAboutPage;
     StorageProxy: BrowserRoute.StorageProxy;
     DropdownMenu: BrowserRoute.DropdownMenu;
+    TabSearchModal: BrowserRoute.TabSearchModal;
     EnterpriseDock: BrowserRoute.EnterpriseDock;
     ZoomControlsDialog: BrowserRoute.ZoomControlsDialog;
     DesktopSignalsModal: BrowserRoute.DesktopSignalsModal;

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

@@ -19,10 +19,12 @@ export declare enum WindowName {
     DockSaveWorkspaceMenu = "openfin-dock3-save-workspace-menu",
     DropdownMenu = "openfin-enterprise-dropdown-menu",
     EnterpriseContextMenu = "openfin-enterprise-context-menu",
+    TabSearchMenu = "openfin-browser-tab-search-menu",
     EnterpriseBookmarkDialogWindow = "openfin-enterprise-bookmark-dialog",
     ZoomControlsDialog = "here-zoom-controls-dialog",
     UpdateVersionModal = "here-update-version-modal",
     ApplyAndPublishModal = "here-apply-and-publish-modal",
+    PublishOnCloseModal = "here-publish-on-close-modal",
     DesktopSignalsModal = "here-desktop-signals-modal",
     IntentsResolverModal = "here-intents-resolver-modal"
 }
@@ -144,7 +146,6 @@ export declare function animateSize(width: number, height: number): Promise<void
  * @returns boolean
  */
 export declare const isBrowserWindow: (identity: OpenFin.Identity) => Promise<any>;
-export declare const isModalWindowExceptZoomDialog: (identity: OpenFin.Identity) => boolean;
 /**
  * Force document body size. Called when resizing or on scaling changes.
  */

package/common/src/utils/workspace-modals.d.ts

@@ -35,6 +35,9 @@ export declare const showUpdateVersionModal: ({ identity, title, description }:
     description: string;
 }) => Promise<ModalResponseEvent["data"]>;
 export declare const showApplyAndPublishModal: (identity: OpenFin.Identity) => Promise<boolean>;
+export declare const showPublishOnCloseModal: (windowIdentity: OpenFin.Identity) => Promise<{
+    data: ModalResponseEvent["data"];
+}>;
 /**
  * Shows the intents resolver modal and returns the user's selection
  * @param request - The request containing modal configuration

package/dock3/src/api/protocol.d.ts

@@ -1,6 +1,7 @@
 import type { OpenFin } from '@openfin/core';
 import { BaseCustomDropdownItem } from '../../../client-api/src/shapes';
 import { BookmarkDockEntryPayload, DockEntry, LaunchDockEntryPayload, Collection } from '../../../client-api-platform/src/shapes';
+import { WorkspaceIndicatorConfig } from '../../../common/src/utils/indicators/workspace-indicators';
 import { Dock3Config, DockCompanionButton } from '../../../dock3/src/shapes';
 /**
  * Payload for more menu custom option actions
@@ -40,6 +41,7 @@ export type Dock3ChannelClientChannelActions = {
     'navigate-content-menu': (payload: {
         targetId: string;
     }) => void;
+    'handle-indicator-config': (payload: WorkspaceIndicatorConfig) => void;
 };
 /**
  * @internal

package/externals.report.json

@@ -2,11 +2,19 @@
     "@openfin/notifications": [
         {
             "type": "explicit",
-            "version": "2.14.0-alpha-4509",
+            "version": "2.14.0-alpha-4620",
             "packageName": "client-api/package.json",
             "issuer": "client-api/src/notifications.ts"
         }
     ],
+    "@openfin/microsoft365": [
+        {
+            "type": "explicit",
+            "version": "^1.1.0",
+            "packageName": "client-api/package.json",
+            "issuer": "client-api/src/integrations/microsoft.ts"
+        }
+    ],
     "title-case": [
         {
             "type": "explicit",
@@ -21,14 +29,6 @@
             "issuer": "common/src/utils/color-linking.ts"
         }
     ],
-    "@openfin/microsoft365": [
-        {
-            "type": "explicit",
-            "version": "^1.1.0",
-            "packageName": "client-api/package.json",
-            "issuer": "client-api/src/integrations/microsoft.ts"
-        }
-    ],
     "lodash.debounce": [
         {
             "type": "explicit",