@openfin/workspace-platform 23.0.0 → 23.0.1-alpha.0966d5cc

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

@@ -1,5 +1,5 @@
 /**
- * WARNING: Do not export from './notifications' here. Not unless we move 'openfin-notifications' here.
+ * WARNING: Do not export from './notifications' here. Not unless we move '@openfin/notifications' here.
  */
 export * from './common';
 export * from './home';

package/client-api-platform/src/api/app-directory.d.ts

@@ -7,7 +7,7 @@ import type { LaunchAppRequest, SearchSitesRequest, SearchSitesResponse, Site }
  * @param app the app directory entry.
  * @param opts launch options.
  */
-export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.Identity | OpenFin.Application | OpenFin.View | OpenFin.Platform>;
+export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.Identity | OpenFin.View | OpenFin.Platform | OpenFin.Application>;
 export declare const enterpriseAppDirectoryChannelClient: () => Promise<OpenFin.ChannelClient>;
 export declare function getResults(payload: {
     req: SearchSitesRequest;

package/client-api-platform/src/api/controllers/theme-storage-controller-store.d.ts

@@ -1,5 +1,19 @@
-import { GeneratedPalettes } from '../../../../common/src/api/theming';
+import { GeneratedPalettes, NotificationIndicatorColorsParsed } from '../../../../common/src/api/theming';
 import { ThemeStorageController } from '../../../../client-api-platform/src/api/controllers/theme-storage-controller';
 import { CustomThemes } from '../../../../client-api-platform/src/shapes';
-export declare const initialiseStoragePalettes: (customThemes: CustomThemes | undefined, isWindows: boolean) => CustomThemes | GeneratedPalettes;
+/**
+ * Initialises the storage palettes from the custom themes. This function is called on platform init.
+ * This function takes both the legacy themes and the new theme system tokens and
+ * passes them into the theme engine to generate the css variables.
+ *
+ * @param customThemes the custom themes to initialise the storage palettes from.
+ * @param isWindows whether the operating system is Windows.
+ * @returns the generated palettes fromt the theme engine, theme palette sheet which is injected into the DOM, and legacy theme object if it exists.
+ */
+export declare const initialiseStoragePalettes: (customThemes: CustomThemes | undefined, isWindows: boolean) => {
+    generatedPalettes: GeneratedPalettes;
+    themePaletteSheet: string;
+    legacyTheme: CustomThemes | null;
+    notificationIndicatorColors: NotificationIndicatorColorsParsed | null;
+};
 export declare const getThemeStorageController: () => ThemeStorageController;

package/client-api-platform/src/api/controllers/theme-storage-controller.d.ts

@@ -1,3 +1,5 @@
+import { GeneratedPalettes } from '../../../../common/src/api/theming';
+import { StorageProxy } from '../../../../client-api-platform/src/api/utils';
 import { ColorSchemeOptionType, CustomPaletteSet } from '../../../../client-api-platform/src/shapes';
 /**
  * Palette extensions can be used to add new variables to the palette set.
@@ -5,21 +7,8 @@ import { ColorSchemeOptionType, CustomPaletteSet } from '../../../../client-api-
  * This is particularly useful if a value uses a different palette constant depending on scheme.
  */
 export declare const getPaletteExtensions: (palette: CustomPaletteSet, paletteScheme: "light" | "dark", isWindows: boolean) => {
-    dockExpandedContainerBorderColor: string;
     dockExpandedContainerBorderRadius: string;
-    dockExpandedContainerBackground: string;
     fillerBackgroundColor: string;
-    dockCompanionContainerBackground: string;
-    dockComponentContainerBackground: string;
-    styledDropdownActiveBackground: string;
-    contentMenuWrapperInternalDivBorderColor: string;
-    contentMenuItemContainerActiveBackground: string;
-    contentMenuItemContainerHoverBackground: string;
-    contentMenuHeaderBorderColor: string;
-    dockCompanionSeparatorBorderColor: string;
-    dockComponentContainerBorderColor: string;
-    companionDockButtonActiveBackground: string;
-    companionDockButtonHoverBackground: string;
     'computed-scrollbar-thumb-alpha': number;
     'computed-scrollbar-track-alpha': number;
     'scrollbar-thumb-rgb': string;
@@ -38,20 +27,33 @@ export declare class ThemeStorageController {
     private providerStorage;
     private darkPaletteVars?;
     private lightPaletteVars?;
-    private workspaceStorage?;
     private themePaletteSheet?;
+    private generatedPalettes?;
+    private workspaceStorage?;
+    private recreateFactory?;
     constructor(providerStorage: Pick<Storage, 'getItem' | 'setItem'>);
-    private getVarsByScheme;
     /**
      * Set the current Storage Proxy to enable Workspace Storage properties to be populated.
-     *
-     * Currently, we only support same Storage Based theming for same origin scenarios like EB, where the provider
-     * is in the same origin as the workspace pages.
-     *
-     * A workaround that can be leveraged in cross origin scenarios (which is the majority of the workspace use case) is available in this commit: 233e843cda6cd68968fd5831fb20597e0d5bb7cc
-     * `git revert 233e843cda6cd68968fd5831fb20597e0d5bb7cc --no-commit`
      */
-    setWorkspaceStorage: (proxy: Pick<Storage, "setItem">) => void;
+    setWorkspaceStorageProxy: (proxy: StorageProxy) => void;
+    /**
+     * Set a factory to recreate the storage proxy if it was destroyed (e.g. when a new browser
+     * window is opened after the last one closed with preventQuitOnLastWindowClosed true).
+     * Called once at platform init; avoids createWindow needing URL/env dependencies.
+     */
+    setRecreateFactory: (factory: () => Promise<StorageProxy>) => void;
+    /**
+     * Close the storage proxy window and clear the reference. Called when the last browser window
+     * closes so the platform can quit (storage proxy would otherwise keep the process alive).
+     * Clears the reference before awaiting destroy() to avoid a race with ensureWorkspaceStorageProxy.
+     */
+    destroyWorkspaceStorageProxy: () => Promise<void>;
+    /**
+     * Ensure the workspace storage proxy exists, recreating via the factory set at init if it was
+     * previously destroyed. No-op if no factory was set (e.g. in tests). Call before using
+     * workspace storage (e.g. when creating a browser window).
+     */
+    ensureWorkspaceStorageProxy: () => Promise<void>;
     /**
      * Check if there's an explicit user preference stored in localStorage.
      * A user preference is indicated by the presence of a SelectedColorScheme key. Which is something assigned if you click on the Appearance dropdown.
@@ -62,7 +64,7 @@ export declare class ThemeStorageController {
      * Synchronize the current palette and scheme with workspace's storage instance if
      * storage based theming is enabled. Only syncs when user has explicitly selected a scheme.
      */
-    trySynchronizeWorkspaceStorage: () => void;
+    trySynchronizeWorkspaceStorage: () => Promise<void>;
     /**
      * Set the current Palette to be used by workspace. This palette will be converted into
      * css vars and combined into a single stylesheet. This stylesheet is exposed in localstorage
@@ -87,6 +89,7 @@ export declare class ThemeStorageController {
      * @param scheme The default scheme specified in the palette
      */
     setThemeDefaultScheme(scheme: ColorSchemeOptionType): void;
+    setGeneratedPalettes(generatedPalettes: GeneratedPalettes): void;
     /**
      * Returns the current scheme
      * @returns 'light' | 'system' | 'dark'

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

@@ -1,5 +1,5 @@
-import { ContentMenuEntry } from '@openfin/ui-library';
-import { DockCompanionButton, DockEntry, LaunchDockEntryPayload, Collection } from '../../../client-api-platform/src/shapes';
+import type { ContentMenuEntry } from '@openfin/ui-library';
+import { Collection, DockCompanionButton, DockEntry, LaunchDockEntryPayload } from '../../../client-api-platform/src/shapes';
 export declare const DockCompanionUpdatesPrefix = "dock-companion-updates";
 export declare const refreshDockBookmarksPanel: () => Promise<void>;
 export declare const updateDockFavoriteEntries: (favorites: DockEntry[]) => Promise<void>;

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

@@ -1,5 +1,5 @@
 import type OpenFin from '@openfin/core';
-import type { GenerateThemeParams, LegacyPalettes } from '../../../common/src/api/theming';
+import type { BaseThemeOptions, CustomTheme, GenerateThemeParams } from '../../../common/src/api/theming';
 import { ColorSchemeOptionType, ThemeApi } from '../../../client-api-platform/src/shapes';
 export declare const getThemingApi: (identity: OpenFin.ApplicationIdentity) => ThemeApi;
 export declare const dispatchThemeToWorkspaceProvider: (themeData: {
@@ -13,4 +13,5 @@ export declare const dispatchThemeToWorkspaceProvider: (themeData: {
 export declare const setSelectedScheme: (schemeType: ColorSchemeOptionType) => Promise<void>;
 export declare const getSelectedScheme: () => ColorSchemeOptionType | null | undefined;
 export declare const getThemePaletteSheet: () => string | undefined;
-export declare const mapLegacyThemeToCustomTheme: (legacyTheme: LegacyPalettes) => GenerateThemeParams;
+export declare const mapLegacyThemeToCustomTheme: (legacyTheme: CustomTheme) => GenerateThemeParams;
+export declare const mapLegacyBrandIcons: (legacyBrand: BaseThemeOptions["brand"]) => GenerateThemeParams[1];

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

@@ -1 +1,12 @@
 export declare const listenForStoreClose: () => void;
+export type StorageProxy = {
+    setItem: (data: string, value: string) => Promise<void>;
+    destroy: () => Promise<void>;
+};
+export declare const createStorageProxy: (url: string) => Promise<StorageProxy>;
+/**
+ * Ensure the workspace storage proxy window exists. Recreates it if it was previously destroyed
+ * (e.g. when the last browser window closed with preventQuitOnLastWindowClosed true and a new
+ * browser window is now being created). Uses the factory registered at init; no-op in tests.
+ */
+export declare const ensureWorkspaceStorageProxy: () => Promise<void>;

package/client-api-platform/src/init/override-callback/enterprise-page-required-layout-settings.d.ts

@@ -2,4 +2,9 @@ import { PageLayout } from '../../../../common/src/api/pages/shapes';
 export type EnterprisePageRequiredLayoutSettings = {
     newTabButtonUrl: string;
 };
+/**
+ * Applies required layout settings for enterprise pages.
+ * Always sets the newTabButton URL to ensure pages from storage or other sources
+ * have the correct landing page URL.
+ */
 export declare const applyEnterprisePageRequiredLayoutSettings: (requiredSettings: EnterprisePageRequiredLayoutSettings, layout: PageLayout) => void;

package/client-api-platform/src/init/override-callback/view-components.d.ts

@@ -1,2 +1,2 @@
 import { OpenFin } from '@openfin/core';
-export declare const createNonLayoutViewComponents: (overrideOptions: OpenFin.PlatformWindowCreationOptions) => Promise<void>;
+export declare const createNonLayoutViewComponents: (isEnterprise: boolean, overrideOptions: OpenFin.PlatformWindowCreationOptions) => Promise<void[]>;

package/client-api-platform/src/init/override-callback/view-defaults.d.ts

@@ -1,7 +1,8 @@
 import type OpenFin from '@openfin/core';
 type DefaultViewOptions = Partial<OpenFin.MutableViewOptions> & {
     downloadShelf?: OpenFin.ConstWindowOptions['downloadShelf'];
+    hotkeys?: OpenFin.ViewOptions['hotkeys'];
 };
 export declare const DEFAULT_VIEW_OPTIONS: DefaultViewOptions;
-export declare function applyViewDefaults(options: Partial<OpenFin.ViewOptions>, initViewOptions?: Partial<OpenFin.ViewOptions>): any;
+export declare function applyViewDefaults(options: Partial<OpenFin.ViewOptions>, initViewOptions?: Partial<OpenFin.ViewOptions>): Promise<any>;
 export {};

package/client-api-platform/src/init/theming.d.ts

@@ -1,6 +1,9 @@
-import { GeneratedPalettes } from '../../../common/src/api/theming';
+import { GeneratedPalettes, NotificationIndicatorColorsParsed } from '../../../common/src/api/theming';
 import { CustomThemes } from '../shapes';
-export declare const getThemes: () => CustomThemes | GeneratedPalettes;
+export declare const getThemes: () => CustomThemes | null;
+export declare const getGeneratedPalettes: () => GeneratedPalettes;
+export declare const getThemePaletteSheet: () => string;
+export declare const getNotificationIndicatorColorsInternal: () => NotificationIndicatorColorsParsed;
 /**
  * initTheming()
  * @param customThemes array of theme objects

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

@@ -1,11 +1,11 @@
 import type OpenFin from '@openfin/core';
-import { IconProps, IconType, Languages } from '@openfin/ui-library';
+import type { IconProps, IconType, Languages } from '@openfin/ui-library';
 import type { AnalyticsEvent } from '../../common/src/utils/usage-register';
-import { CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
-import { AddDefaultPagePayload, AttachedPage, BookmarkNode, CopyPagePayload, HandlePagesAndWindowClosePayload, HandlePagesAndWindowCloseResult, HandleSaveModalOnPageClosePayload, Page, PageLayoutsWithSelectedViews, PageWithUpdatableRuntimeAttribs, SaveModalOnPageCloseResult, SetActivePageForWindowPayload, ShouldPageClosePayload, ShouldPageCloseResult, ViewsPreventingUnloadPayload } from '../../common/src/api/pages/shapes';
-import { NotificationsCustomManifestOptions } from '../../common/src/api/shapes/notifications';
+import type { CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
+import type { AddDefaultPagePayload, AttachedPage, BookmarkNode, CopyPagePayload, HandlePagesAndWindowClosePayload, HandlePagesAndWindowCloseResult, HandleSaveModalOnPageClosePayload, Page, PageLayoutsWithSelectedViews, PageWithUpdatableRuntimeAttribs, SaveModalOnPageCloseResult, SetActivePageForWindowPayload, ShouldPageClosePayload, ShouldPageCloseResult, ViewsPreventingUnloadPayload } from '../../common/src/api/pages/shapes';
+import type { NotificationsCustomManifestOptions } from '../../common/src/api/shapes/notifications';
 import type { CustomThemes, GeneratedPalettes } from '../../common/src/api/theming';
-import { App, DockProviderConfigWithIdentity, StoreButtonConfig } from '../../client-api/src/shapes';
+import type { App, DockProviderConfigWithIdentity, StoreButtonConfig } from '../../client-api/src/shapes';
 import type { WorkflowIntegration } from '../../client-api/src/shapes/integrations';
 export * from '../../dock3/src/shapes';
 export { AppManifestType } from '../../client-api/src/shapes';
@@ -13,7 +13,7 @@ export type { App, AppIntent, Image } from '../../client-api/src/shapes';
 export type { CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
 export type { AttachedPage, Page, PageLayout, PageLayoutDetails, PageWithUpdatableRuntimeAttribs, PanelConfigHorizontal, PanelConfigVertical, PanelConfig, ExtendedPanelConfig, CopyPagePayload, HandleSaveModalOnPageClosePayload, SaveModalOnPageCloseResult, SetActivePageForWindowPayload, ShouldPageClosePayload, ShouldPageCloseResult, ViewsPreventingUnloadPayload } from '../../common/src/api/pages/shapes';
 export { PanelPosition } from '../../common/src/api/pages/shapes';
-export type { CustomThemes, CustomThemeOptions, CustomThemeOptionsWithScheme, CustomPaletteSet, BaseThemeOptions, ThemeExtension, WorkspaceThemeSet, NotificationIndicatorColorsSet, NotificationIndicatorColorsSetDarkScheme, NotificationIndicatorColorsSetLightScheme, NotificationIndicatorColorsWithScheme } from '../../common/src/api/theming';
+export type { CustomThemes, CustomThemeOptions, ThemeOptions, CustomThemeOptionsWithScheme, CustomPaletteSet, BaseThemeOptions, ThemeExtension, WorkspaceThemeSet, NotificationIndicatorColorsSet, NotificationIndicatorColorsSetDarkScheme, NotificationIndicatorColorsSetLightScheme, NotificationIndicatorColorsWithScheme } from '../../common/src/api/theming';
 export type { AnalyticsEvent } from '../../common/src/utils/usage-register';
 export type { WorkflowIntegration } from '../../client-api/src/shapes/integrations';
 /**
@@ -119,6 +119,7 @@ export declare enum GlobalContextMenuOptionType {
     Downloads = "Downloads",
     OpenStorefront = "OpenStorefront",
     ManageDesktopSignals = "ManageDesktopSignals",
+    FindInPage = "FindInPage",
     Appearance = "Appearance",
     Quit = "Quit",
     Custom = "Custom"
@@ -222,6 +223,40 @@ export type OpenGlobalContextMenuPayload = OpenGlobalContextMenuRequest & {
     callback: (data: GlobalContextMenuItemData, payload: OpenGlobalContextMenuPayload) => any;
 };
 export type ViewTabContextMenuTemplate = OpenFin.MenuItemTemplate<ViewTabMenuData>;
+/**
+ * UI elements within a view tab that can be navigated to via keyboard.
+ */
+export type ViewTabElements = 'inactive-tab' | 'active-tab' | 'inactive-tab-close-button' | 'active-tab-close-button' | 'add-tab-button';
+/**
+ * Configuration options for view tab keyboard navigation behavior.
+ */
+export interface ViewTabOptions {
+    /**
+     * Elements in the view tab that are able to be focused using
+     * arrow keys when an element in the view is selected.
+     * The order of the items in the array have no impact.
+     * Note: these are not mutually exclusive and can overlap.
+     * Default (when undefined): ["inactive-tab","active-tab","active-tab-close-button","inactive-tab-close-button","add-tab-button"]
+     */
+    arrowNavigation?: ViewTabElements[];
+    /**
+     * Elements in the view tab that are able to be focused using
+     * tab and shift+tab when an element in the view is selected.
+     * The order of the items in the array have no impact.
+     * Note: these are not mutually exclusive and can overlap.
+     * Default (when undefined): ["active-tab","add-tab-button"]
+     */
+    tabNavigation?: ViewTabElements[];
+}
+/**
+ * Configuration options for accessibility features in the Browser.
+ */
+export interface AccessibilityOptions {
+    /**
+     * View tab keyboard navigation options.
+     */
+    viewTabOptions?: ViewTabOptions;
+}
 /**
  * Request for opening a view tab context menu in Browser.
  */
@@ -363,6 +398,7 @@ export declare enum BrowserButtonType {
     LockUnlockPage = "LockUnlockPage",
     SaveMenu = "SaveMenu",
     SavePage = "SavePage",
+    Download = "Download",
     Minimise = "Minimise",
     Maximise = "Maximise",
     Close = "Close",
@@ -628,6 +664,30 @@ export interface BrowserWorkspacePlatformWindowOptions {
         minWidth?: string;
         maxWidth?: string;
     };
+    /**
+     * Accessibility options for the browser window.
+     * These options override the default accessibility options set at the platform or browser initialization level.
+     *
+     * @example
+     * ```ts
+     * import * as WorkspacePlatform from '@openfin/workspace-platform';
+     *
+     * const platform = WorkspacePlatform.getCurrentSync();
+     * const browserWin = platform.Browser.createWindow({
+     *   ...,
+     *   workspacePlatform: {
+     *     ...,
+     *     accessibilityOptions: {
+     *       viewTabOptions: {
+     *         arrowNavigation: ["inactive-tab", "active-tab"],
+     *         tabNavigation: ["active-tab"]
+     *       }
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    accessibilityOptions?: AccessibilityOptions;
     /**
      * Use when you want to display navigation buttons in Browser toolbar. Disabled by default.
      *
@@ -1418,12 +1478,27 @@ export interface LaunchAppRequest {
     target?: OpenFin.EntityInfo;
     app: App;
 }
-/**
- * Get Themes from API
- */
 export interface ThemeApi {
-    getThemes(): Promise<CustomThemes | GeneratedPalettes>;
+    /**
+     * @deprecated This method is deprecated. It is recommended to use {@link getGeneratedPalettes} instead.
+     * Get the legacy themes from the platform provider.
+     * @returns the legacy themes or null if the platform provider is using the new theme system.
+     */
+    getThemes(): Promise<CustomThemes | null>;
+    /**
+     * Get the generated palettes from the platform provider.
+     * @returns the generated palettes.
+     */
+    getGeneratedPalettes(): Promise<GeneratedPalettes>;
+    /**
+     * Set the selected scheme for the platform provider.
+     * @param newScheme the new scheme to set.
+     */
     setSelectedScheme(newScheme: ColorSchemeOptionType): Promise<void>;
+    /**
+     * Get the selected scheme from the platform provider.
+     * @returns the selected scheme.
+     */
     getSelectedScheme(): Promise<ColorSchemeOptionType>;
 }
 /**
@@ -1591,6 +1666,7 @@ export interface WorkspacePlatformModule extends OpenFin.Platform {
     setLanguage(locale: Locale): Promise<void>;
     /**
      * Implementation for getting the notifications workspace platform configuration.
+     * @deprecated Notifications config is now part of the platform manifest and is automatically resolved by the notifications API. Do not use this method as it will not return the correct configuration.
      */
     getNotificationsConfig(): Promise<NotificationsCustomManifestOptions | undefined>;
     /**
@@ -2085,6 +2161,7 @@ export interface WorkspacePlatformInitConfig {
     /**
      * Config for overriding default notifications behaviour.
      * Leave undefined to use OpenFin hosted Notification Center.
+     * @deprecated Notifications config is now part of the platform manifest and is automatically resolved by the notifications API. Do not use this property as it will not have any effect.
      */
     notifications?: NotificationsCustomManifestOptions;
     /**
@@ -2264,6 +2341,28 @@ export interface BrowserInitConfig {
      * that are PNGs you will need to update these assets for best results.
      */
     browserIconSize?: IconSize;
+    /**
+     * Default accessibility options that will be applied to all browser windows.
+     * These options can be overridden at the window creation level via workspacePlatform.accessibilityOptions.
+     *
+     * @example
+     * ```ts
+     * import * as WorkspacePlatform from '@openfin/workspace-platform';
+     *
+     * await WorkspacePlatform.init({
+     *   browser: {
+     *     title: "My Browser",
+     *     accessibilityOptions: {
+     *       viewTabOptions: {
+     *         arrowNavigation: ["inactive-tab", "active-tab"],
+     *         tabNavigation: ["active-tab"]
+     *       }
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    accessibilityOptions?: AccessibilityOptions;
     /**
      * Override workspace platform behavior
      *

package/common/src/api/protocol/notifications.d.ts

@@ -1,5 +1,6 @@
 import type OpenFin from '@openfin/core';
 import { ColorSchemeOptionType } from '../../../../client-api-platform/src/shapes';
+import { NotificationsCustomManifestOptions } from '../shapes/notifications';
 export declare const NOTIFICATIONS_SYNC_CHANNEL = "of-workspace-notifications-sync";
 export declare enum NotificationsChannelAction {
     UpdatePlatformThemeScheme = "update-platform-theme-scheme"
@@ -10,5 +11,12 @@ export interface UpdatePlatformSchemePayload {
 interface NotificationsSyncChannelClient extends OpenFin.ChannelClient {
     dispatch(action: NotificationsChannelAction.UpdatePlatformThemeScheme, payload: UpdatePlatformSchemePayload): Promise<void>;
 }
+export type ManifestNotificationsConfig = {
+    notifications?: {
+        customManifest?: NotificationsCustomManifestOptions;
+    };
+};
+export declare function getNotificationCenterUuid(): Promise<string>;
+export declare function getSyncChannelName(): Promise<string>;
 export declare const getNotificationsSyncChannelClient: () => Promise<NotificationsSyncChannelClient>;
 export {};

package/common/src/api/protocol/workspace-platform.d.ts

@@ -35,6 +35,8 @@ export declare enum WorkspacePlatformChannelAction {
     GetLastFocusedBrowserWindow = "getLastFocusedBrowserWindow",
     GetPageByViewIdentity = "getPageByViewIdentity",
     GetThemes = "getThemes",
+    GetGeneratedPalettes = "getGeneratedPalettes",
+    GetThemePaletteSheet = "getThemePaletteSheet",
     GetSelectedScheme = "getSelectedScheme",
     SetSelectedScheme = "setSelectedScheme",
     OpenGlobalContextMenuInternal = "openGlobalContextMenuInternal",
@@ -78,7 +80,7 @@ export declare enum WorkspacePlatformChannelAction {
     HandleRequestNavigationInternal = "handleRequestNavigationInternal",// Enterprise
     RefreshBookmarksInternal = "refreshBookmarksInternal",// Enterprise
     LaunchBookmarkInternal = "launchBookmarkInternal",// Enterprise
-    GetNotificationsConfig = "getNotificationsConfig",
+    GetNotificationsConfig = "getNotificationsConfig",// Deprecated
     UpdateDockFavoritesInternal = "updateDockFavoritesInternal",// Enterprise
     UpdateContentMenuInternal = "updateContentMenuInternal",// Enterprise
     LaunchDockEntryInternal = "launchDockEntryInternal",// Enterprise
@@ -93,7 +95,8 @@ export declare enum WorkspacePlatformChannelAction {
     AddDockFavoriteInternal = "addDockFavoriteInternal",// Enterprise
     FocusAndExpandSearchInternal = "focusAndExpandSearchInternal",// Enterprise
     SendUpdateVersionModalResponseInternal = "sendUpdateVersionModalResponseInternal",// Enterprise
-    ShowUpdateVersionModalInternal = "showUpdateVersionModalInternal"
+    ShowUpdateVersionModalInternal = "showUpdateVersionModalInternal",// Enterprise
+    GetNotificationIndicatorColorsInternal = "getNotificationIndicatorColorsInternal"
 }
 export type PlatFormSupportedFeatures = boolean | {
     isWorkspacePlatform: boolean;

package/common/src/api/protocol/workspace.d.ts

@@ -19,8 +19,8 @@ export declare const launchProvider: () => Promise<void>;
  */
 export declare const getChannelClientAndLaunchProvider: () => Promise<WorkspaceComponentChannelClient>;
 /**
- * Launches the Workspace provider if it is not running.
+ * Gets the theme data from the Platform provider, then launches the Workspace provider if it is not running, and then dispatches the theme data to the Workspace provider.
  * Then gets a Channel Client that is connected to the Workspace Provider.
  * @returns the Channel Client that is connected to the Workspace Provider.
  */
-export declare const getClientAPIChannelClientAndLaunchProvider: () => Promise<WorkspaceAPIClientChannelClient>;
+export declare const getChannelClientAndInitializeWorkspaceProvider: () => Promise<WorkspaceAPIClientChannelClient>;

package/common/src/api/shapes/notifications.d.ts

@@ -1,5 +1,6 @@
 /**
  * Options for using privately hosted notification service.
+ * @deprecated Custom manifest is now part of the platform manifest and is automatically resolved by the notifications API. Do not use this type as it will be ignored.
  */
 export type NotificationsCustomManifestOptions = {
     /**

package/common/src/api/theming.d.ts

@@ -1,8 +1,13 @@
 import type { DefaultTheme } from 'styled-components';
 import type OpenFin from '@openfin/core';
-import { type ColorSchemeType, type ThemeSet, Palette } from '@openfin/ui-library';
+import type { ColorSchemeType, ThemeSet } from '@openfin/ui-library';
 import { ColorSchemeOptionType } from '../../../client-api-platform/src/shapes';
 import type { generateTheme } from '@openfin/theme-engine';
+export declare const ColorScheme: {
+    light: string;
+    dark: string;
+    system: string;
+};
 export type WorkspaceComponentSetSelectedSchemePayload = {
     newScheme: ColorSchemeOptionType;
     identity: OpenFin.Identity;
@@ -35,6 +40,13 @@ export interface NotificationIndicatorColorsSetLightScheme {
     dark?: NotificationIndicatorColorsSet;
     light: NotificationIndicatorColorsSet;
 }
+export type NotificationIndicatorColors = Record<string, Omit<NotificationIndicatorColorsSet, 'foreground'> & {
+    foreground: string;
+}>;
+export type NotificationIndicatorColorsParsed = {
+    dark: NotificationIndicatorColors;
+    light: NotificationIndicatorColors;
+};
 export type NotificationIndicatorColorsWithScheme = Record<string, NotificationIndicatorColorsSetDarkScheme | NotificationIndicatorColorsSetLightScheme>;
 export interface BaseThemeOptions {
     label: string;
@@ -65,7 +77,7 @@ export type CustomThemeOptions = BaseThemeOptions & {
      * };
      * ```
      */
-    notificationIndicatorColors?: Record<string, NotificationIndicatorColorsSet>;
+    notificationIndicatorColors?: NotificationIndicatorColors;
 };
 export type CustomThemeOptionsWithScheme = BaseThemeOptions & {
     /**
@@ -124,12 +136,16 @@ export type CustomThemeOptionsWithScheme = BaseThemeOptions & {
 export type ThemeOptions = BaseThemeOptions & {
     seed: Parameters<typeof generateTheme>[0];
     overrides?: Parameters<typeof generateTheme>[1];
+    default?: Exclude<ColorSchemeOptionType, 'system'>;
+} & {
+    notificationIndicatorColors?: NotificationIndicatorColorsWithScheme | NotificationIndicatorColors;
 };
 type GenerateThemeReturn = ReturnType<typeof generateTheme>;
 export type GeneratedPalettes = Pick<GenerateThemeReturn, 'dark' | 'light'>;
 export type LegacyPalettes = CustomThemeOptions | CustomThemeOptionsWithScheme;
 export type GenerateThemeParams = Parameters<typeof generateTheme>;
-export type CustomThemes = (CustomThemeOptions | CustomThemeOptionsWithScheme | ThemeOptions)[];
+export type CustomTheme = CustomThemeOptions | CustomThemeOptionsWithScheme | ThemeOptions;
+export type CustomThemes = CustomTheme[];
 export interface PreloadedThemeData {
     themes: CustomThemes | GeneratedPalettes;
     selectedScheme: ColorSchemeOptionType;
@@ -274,17 +290,14 @@ export declare const OpenFinDarkTheme: {
     borderNeutral: "#C0C1C2";
 };
 export declare const DefaultOpenFinTheme: CustomThemes;
-export declare const getComputedPaletteSets: (customTheme: CustomThemeOptions | CustomThemeOptionsWithScheme) => WorkspaceThemeSet;
-/**
- * Transforms input {@link CustomThemes} to {@link ComputedThemes} used by Workspace Platform / Notifications Platform.
- *
- * @param customThemes array of themes to transform
- * @param storedScheme sets the default scheme if provided
- * @returns array of {@link ComputedThemes | computed themes}
- */
-export declare const computeThemes: (customThemes: CustomThemes | GeneratedPalettes, storedScheme?: ColorSchemeOptionType) => ComputedThemes;
-export declare const getComputedPlatformTheme: (platformIdentity: OpenFin.Identity) => Promise<ComputedTheme>;
+export declare const parseNotificationIndicatorColors: (customTheme: CustomTheme) => NotificationIndicatorColorsParsed;
+export declare const constructThemePaletteSheet: (themes: GeneratedPalettes) => string;
+export declare const getComputedPlatformTheme: (platformIdentity: OpenFin.Identity) => Promise<{
+    theme: CustomThemes | GeneratedPalettes;
+    defaultScheme: ColorSchemeOptionType;
+    themePaletteSheet: string;
+}>;
 export declare const setSelectedScheme: (ctx: ColorSchemeOptionType) => Promise<void>;
 export declare const getComputedScheme: (identity?: OpenFin.Identity) => Promise<Exclude<ColorSchemeType, "system">>;
-export declare const getComputedBackgroundColor: (paletteKey: keyof typeof Palette, defaultColor?: string) => Promise<string>;
+export declare const getComputedBackgroundColor: (platformIdentity: OpenFin.Identity) => Promise<string>;
 export {};

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

@@ -23,3 +23,10 @@ export type ApplicationInfoExtended = OpenFin.ApplicationInfo & {
 };
 export declare const getCurrentOFApplication: () => OpenFin.Application;
 export declare const getWorkspaceOFApplication: () => OpenFin.Application;
+/**
+ * Gets the application manifest, caching the result after the first call.
+ * The manifest never changes during the application lifecycle, so this avoids redundant async calls.
+ * Uses promise-based caching to prevent race conditions when multiple calls occur before the first completes.
+ * @returns A Promise resolving to the application manifest
+ */
+export declare const getCachedManifest: () => Promise<OpenFin.Manifest>;

package/common/src/utils/find-in-page/findInPageChannel.d.ts

@@ -0,0 +1,37 @@
+export type FindInPageChannelMessagePayload = {
+    type: 'close';
+} | {
+    type: 'find-text-changed';
+    value: string;
+} | {
+    type: 'focus-input';
+} | {
+    type: 'hide-from-search-menu';
+} | {
+    type: 'next-result';
+} | {
+    type: 'previous-result';
+} | {
+    type: 'show';
+} | {
+    type: 'update-state';
+    currentResultIndex?: number | null;
+    totalResults?: number | null;
+    value?: string | null;
+} | {
+    type: 'view-ready';
+} | {
+    type: 'window-ready';
+};
+/**
+ * Closes the find in page channel
+ */
+export declare const closeFindInPageChannel: (channel: BroadcastChannel) => void;
+/**
+ * Creates a new find in page channel
+ */
+export declare const createFindInPageChannel: (windowName?: string) => Promise<BroadcastChannel>;
+/**
+ * Sends a message via the find in page channel
+ */
+export declare const sendFindInPageMessage: (channel: BroadcastChannel, message: FindInPageChannelMessagePayload) => void;

package/common/src/utils/find-in-page/showFindInPageHandler.d.ts

@@ -0,0 +1,2 @@
+import type OpenFin from '@openfin/core';
+export declare const showFindInPageInTargetWindow: (windowIdentity: OpenFin.Identity) => Promise<void>;

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

@@ -74,6 +74,13 @@ export declare const manageDesktopSignals: () => {
         type: WP.GlobalContextMenuOptionType;
     };
 };
+export declare const findInPage: () => {
+    type: MenuItemType;
+    label: string;
+    data: {
+        type: WP.GlobalContextMenuOptionType;
+    };
+};
 export declare const renameWorkspace: () => {
     type: MenuItemType;
     label: string;