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

package/client-api/src/integrations/microsoft.utils.d.ts

@@ -36,9 +36,9 @@ export declare const MICROSOFT_365_SEARCH_RESULT_ACTIONS: {
  * @param req The user input request object from which to extract the selected filters.
  * @returns An array of CLIFilter objects representing the validated filters.
  */
-export declare const getValidFilters: (req: Parameters<HomeProvider['onUserInput']>[0], searchTypePossibleFilters: Set<Microsoft365DocumentType>) => CLIFilter[];
-export declare const getValidContactFilters: (users: MicrosoftGraphTypes.User[], req: Parameters<HomeProvider['onUserInput']>[0]) => CLIFilter[];
-export declare const getContactFiltersFromRequest: (req: Parameters<HomeProvider['onUserInput']>[0]) => {
+export declare const getValidFilters: (req: Parameters<HomeProvider["onUserInput"]>[0], searchTypePossibleFilters: Set<Microsoft365DocumentType>) => CLIFilter[];
+export declare const getValidContactFilters: (users: MicrosoftGraphTypes.User[], req: Parameters<HomeProvider["onUserInput"]>[0]) => CLIFilter[];
+export declare const getContactFiltersFromRequest: (req: Parameters<HomeProvider["onUserInput"]>[0]) => {
     department: string[];
     jobTitle: string[];
 };
@@ -58,7 +58,7 @@ export declare const filterContactFromRequest: (items: MicrosoftGraphTypes.User[
  * If no types are selected or all types are deselected, the function marks all types to be shown.
  * Otherwise, it marks only the selected types to be shown.
  */
-export declare const getTypeFiltersFromRequest: (req: Parameters<HomeProvider['onUserInput']>[0], searchTypePossibleFilters: Set<Microsoft365DocumentType>) => {
+export declare const getTypeFiltersFromRequest: (req: Parameters<HomeProvider["onUserInput"]>[0], searchTypePossibleFilters: Set<Microsoft365DocumentType>) => {
     readonly showDocuments: boolean;
     readonly showContacts: boolean;
     /** Teams Messages */
@@ -70,7 +70,7 @@ export declare const getTypeFiltersFromRequest: (req: Parameters<HomeProvider['o
     /** SharePoint Lists */
     readonly showLists: boolean;
 };
-export declare const getDocumentFiltersFromRequest: (req: Parameters<HomeProvider['onUserInput']>[0]) => {
+export declare const getDocumentFiltersFromRequest: (req: Parameters<HomeProvider["onUserInput"]>[0]) => {
     readonly filterFiles: boolean;
     readonly showWord: boolean;
     readonly showExcel: boolean;
@@ -81,6 +81,6 @@ export declare const getDocumentFiltersFromRequest: (req: Parameters<HomeProvide
 export declare const filterDocumentsFromRequest: (items: MicrosoftGraphTypes.DriveItem[], filter: ReturnType<typeof getDocumentFiltersFromRequest>) => MicrosoftGraphTypes.DriveItem[];
 export declare const getFileType: (fileName?: string) => string;
 export declare const getFileIcon: (fileName?: string) => string;
-export declare const mapMicrosoftAvailabilityToPresence: (availability: Presence) => CLISearchResultContact['templateContent']['onlineStatus'] | undefined;
+export declare const mapMicrosoftAvailabilityToPresence: (availability: Presence) => CLISearchResultContact["templateContent"]["onlineStatus"] | undefined;
 /** base64IdToUrl converts a base64 encoded id to a url safe id */
 export declare const base64IdToUrl: (b64Id: string) => string;

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,4 +1,19 @@
+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;
+/**
+ * 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,52 +1,59 @@
+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.
  *
  * 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;
+export declare const getPaletteExtensions: (palette: CustomPaletteSet, paletteScheme: "light" | "dark", isWindows: boolean) => {
     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;
     'scrollbar-track-rgb': string;
     selectedTab: string;
 };
-export type Palettes = {
+export type LegacyPalettes = {
     dark: CustomPaletteSet;
     light: CustomPaletteSet;
 };
+export type Palettes = {
+    light: string;
+    dark: string;
+};
 export declare class ThemeStorageController {
     private providerStorage;
     private darkPaletteVars?;
     private lightPaletteVars?;
+    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.
@@ -57,14 +64,18 @@ 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
      * to allow workspace UI elements to load the palette before their first paint.
      * @param palettes Light and Dark Palette constants
      */
-    setPalettes: ({ light, dark }: Palettes, isWindows: boolean) => Promise<void>;
+    setLegacyPalettes: ({ light, dark }: LegacyPalettes, isWindows: boolean) => Promise<void>;
+    setPalettes: ({ light, dark }: {
+        light: string;
+        dark: string;
+    }) => Promise<void>;
     /**
      * Set the current scheme of workspace. Specifically setting light or dark
      * will ignore the OS scheme, whereas 'system' will always respect it.
@@ -78,9 +89,15 @@ 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'
      */
     getScheme(): ColorSchemeOptionType;
+    getThemePaletteSheet(): string | undefined;
+    getThemePalette(): {
+        light: string;
+        dark: string;
+    };
 }

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

@@ -1,15 +1,17 @@
-import { ContentMenuEntry } from '@openfin/ui-library';
-import { DockCompanionButton, DockEntry, LaunchDockEntryPayload } 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>;
 export declare const updateContentMenu: (contentMenu: ContentMenuEntry[]) => Promise<void>;
 export declare const navigateContentMenu: (id: string) => Promise<void>;
+export declare const refreshDockCollectionMenu: (collections: Collection[]) => Promise<void>;
 export declare const launchDockEntry: (payload: LaunchDockEntryPayload) => Promise<void>;
 export declare const setDockFavoritesOrder: (favorites: DockEntry[]) => Promise<void>;
 export declare const setDefaultDockButtonsOrder: (defaultDockButtons: DockCompanionButton[]) => Promise<void>;
-export declare const getDockWorkspacesContextMenu: () => Promise<import("@client/index").BaseCustomDropdownItem<any>[]>;
+export declare const getDockWorkspacesContextMenu: () => Promise<import("@client/shapes").BaseCustomDropdownItem<any>[]>;
 export declare const handleDockWorkspacesMenuResponse: (payload: any) => Promise<void>;
+export declare const launchCollection: (collection: Collection) => Promise<void>;
 export declare const removeFavoriteEntry: (entry: DockEntry) => Promise<void>;
 export declare const addFavoriteEntry: (entry: DockEntry) => Promise<void>;
 export declare const focusAndExpandSearchMenu: () => Promise<void>;

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

@@ -4,7 +4,7 @@ export declare const dispatchLanguageToBrowserWindows: (language: Locale) => Pro
 export declare const setLanguage: (locale: Locale) => Promise<void>;
 export declare function getLanguageResourcesInternal(): {
     currentLanguage: "en-US" | "ja-JP" | "zh-CN" | "ko-KR" | "ru-RU" | "de-DE" | "zh-Hant";
-    resources: import("i18next/typescript/options").Resource;
+    resources: import("i18next").Resource;
 };
 /**
  * initLanguage()

package/client-api-platform/src/api/pages/open-pages.d.ts

@@ -1,5 +1,5 @@
 import { AnalyticsEventInternal } from '../../../../common/src/utils/usage-register';
 import { Page } from '../../../../client-api-platform/src/shapes';
 export declare const getOpenPages: () => Map<string, AnalyticsEventInternal>;
-export declare const addOpenPageToCache: (pageId: Page['pageId'], event: AnalyticsEventInternal) => void;
-export declare const removeOpenPageFromCache: (pageId: Page['pageId']) => boolean;
+export declare const addOpenPageToCache: (pageId: Page["pageId"], event: AnalyticsEventInternal) => void;
+export declare const removeOpenPageFromCache: (pageId: Page["pageId"]) => boolean;

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

@@ -1,5 +1,17 @@
 import type OpenFin from '@openfin/core';
+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: {
+    themePaletteSheet: string;
+    selectedScheme: ColorSchemeOptionType;
+    themePalette: {
+        light: string;
+        dark: string;
+    };
+}) => Promise<void>;
 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: CustomTheme) => GenerateThemeParams;
+export declare const mapLegacyBrandIcons: (legacyBrand: BaseThemeOptions["brand"]) => GenerateThemeParams[1];

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

@@ -0,0 +1 @@
+export {};

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/page-defaults.d.ts

@@ -1,4 +1,4 @@
 import OpenFin from '@openfin/core';
 import type { AttachedPage, AttachedPageInternal } from '../../../../common/src/api/pages/shapes';
 import { BrowserInitConfig } from '../..';
-export declare const applyPageDefaults: (pages: AttachedPage[], initOptions?: Pick<BrowserInitConfig, 'defaultPageOptions' | 'defaultViewOptions' | 'defaultWindowOptions'>, overrideOptions?: OpenFin.PlatformWindowCreationOptions) => Promise<AttachedPageInternal[]>;
+export declare const applyPageDefaults: (pages: AttachedPage[], initOptions?: Pick<BrowserInitConfig, "defaultPageOptions" | "defaultViewOptions" | "defaultWindowOptions">, overrideOptions?: OpenFin.PlatformWindowCreationOptions) => Promise<AttachedPageInternal[]>;

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/override-callback/view-options.d.ts

@@ -7,5 +7,5 @@ type ViewStateBase = Pick<BrowserViewState, '_internalWorkspaceData' | 'workspac
 export declare const mapInternalWorkspaceDataToWorkspacePlatform: <T extends ViewStateBase>(viewState: T) => T;
 export declare const mapWorkspacePlatformToInternalWorkspaceData: <T extends ViewStateBase>(viewState: T) => T;
 export declare const setHotkeysIfNavigationButtonsEnabled: (options: BrowserCreateViewRequest) => Promise<BrowserCreateViewRequest>;
-export declare const registerHotkeyListenersIfEnabled: (viewIdentity: OpenFin.Identity, buttonOptions?: BrowserWorkspacePlatformViewOptions['browserNavigationButtons']) => void;
+export declare const registerHotkeyListenersIfEnabled: (viewIdentity: OpenFin.Identity, buttonOptions?: BrowserWorkspacePlatformViewOptions["browserNavigationButtons"]) => void;
 export {};

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

@@ -1,5 +1,9 @@
+import { GeneratedPalettes, NotificationIndicatorColorsParsed } from '../../../common/src/api/theming';
 import { CustomThemes } from '../shapes';
-export declare const getThemes: () => CustomThemes;
+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 { CustomThemes } from '../../common/src/api/theming';
-import { App, DockProviderConfigWithIdentity, StoreButtonConfig } from '../../client-api/src/shapes';
+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 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"
@@ -154,16 +155,16 @@ export declare enum PageTabContextMenuOptionType {
     Save = "Save",
     SaveAs = "Save As",
     NewPage = "New Page",
-    DeletePage = "Delete Page",
-    SaveWorkspaceAs = "SaveWorkspaceAs",
-    Refresh = "Refresh",
-    CloseOthers = "Close others",
-    Delete = "Delete",
-    Print = "Print",
-    PrintAll = "PrintAll",
-    PrintScreen = "PrintScreen",
-    ManageDesktopSignals = "ManageDesktopSignals",
-    AddToChannel = "AddToChannel",
+    DeletePage = "Delete Page",// Enterprise
+    SaveWorkspaceAs = "SaveWorkspaceAs",// Enterprise
+    Refresh = "Refresh",// Enterprise
+    CloseOthers = "Close others",// Enterprise
+    Delete = "Delete",// Enterprise
+    Print = "Print",// Enterprise
+    PrintAll = "PrintAll",// Enterprise
+    PrintScreen = "PrintScreen",// Enterprise
+    ManageDesktopSignals = "ManageDesktopSignals",// Enterprise
+    AddToChannel = "AddToChannel",// Enterprise
     Custom = "Custom"
 }
 /**Shape of the data property of a global context menu template item */
@@ -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>;
+    /**
+     * @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
      *
@@ -2288,6 +2387,10 @@ export interface Workspace {
     metadata?: WorkspaceMetadata;
     snapshot: BrowserSnapshot;
 }
+export interface Collection {
+    collectionId: string;
+    title: string;
+}
 /**
  * Request for creating a saved workspace in persistent storage.
  */

package/common/src/api/pages/idb.d.ts

@@ -14,10 +14,8 @@ export declare function updatePage({ pageId, page }: {
 export declare const addRemovedTab: (payload: TrackedTab) => Promise<void>;
 export declare const popLastRemovedTab: () => Promise<TrackedTab | undefined>;
 export declare const trackVisitedSite: (payload: Site) => Promise<void>;
-export declare const getRecentVisitedSites: (numOfSites?: number) => Promise<TrackedSite[] | [
-]>;
-export declare const getFrequentlyVisitedSites: () => Promise<TrackedSite[] | [
-]>;
+export declare const getRecentVisitedSites: (numOfSites?: number) => Promise<TrackedSite[] | []>;
+export declare const getFrequentlyVisitedSites: () => Promise<TrackedSite[] | []>;
 export declare const searchSites: (payload: {
     req: SearchSitesRequest;
 } & {

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

@@ -34,8 +34,8 @@ declare enum GeneralBrowserChannelActions {
     SetSelectedScheme = "set-selected-scheme",
     ShowBrowserIndicator = "show-browser-indicator",
     SetSelectedLanguage = "set-selected-language",
-    RefreshBookmarksInternal = "refresh-bookmarks",
-    GetLayoutsWithSelectedViewsInternal = "get-layouts-with-selected-views",
+    RefreshBookmarksInternal = "refresh-bookmarks",// Enterprise
+    GetLayoutsWithSelectedViewsInternal = "get-layouts-with-selected-views",// Enterprise
     FocusAndExpandSearchInternal = "focus-and-expand-search"
 }
 /**
@@ -56,16 +56,18 @@ export declare enum PageChannelAction {
     IsActivePageChanging = "is-active-page-changing"
 }
 export declare enum CompanionDockChannelAction {
-    UpdateFavoriteEntries = "update-favorite-entries",
-    UpdateContentMenu = "update-content-menu",
-    NavigateContentMenu = "navigate-content-menu",
-    MoreMenuCustomOptionClicked = "more-menu-custom-option-clicked"
+    UpdateFavoriteEntries = "update-favorite-entries",// Enterprise
+    UpdateContentMenu = "update-content-menu",// Enterprise
+    NavigateContentMenu = "navigate-content-menu",// Enterprise
+    MoreMenuCustomOptionClicked = "more-menu-custom-option-clicked",// Enterprise
+    RefreshDockCollectionMenu = "refresh-dock-collection-menu"
 }
 export declare const BrowserChannelAction: {
     UpdateFavoriteEntries: CompanionDockChannelAction.UpdateFavoriteEntries;
     UpdateContentMenu: CompanionDockChannelAction.UpdateContentMenu;
     NavigateContentMenu: CompanionDockChannelAction.NavigateContentMenu;
     MoreMenuCustomOptionClicked: CompanionDockChannelAction.MoreMenuCustomOptionClicked;
+    RefreshDockCollectionMenu: CompanionDockChannelAction.RefreshDockCollectionMenu;
     GetPages: PageChannelAction.GetPages;
     GetActivePageForWindow: PageChannelAction.GetActivePageForWindow;
     AttachPagesToWindow: PageChannelAction.AttachPagesToWindow;

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 {};