@openfin/workspace-platform 23.0.3 → 23.0.4

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.View | OpenFin.Platform | OpenFin.Application>;
+export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.Identity | OpenFin.Application | OpenFin.View | OpenFin.Platform>;
 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,18 +1,4 @@
-import { GeneratedPalettes } 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';
-/**
- * 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;
-};
+export declare const initialiseStoragePalettes: (customThemes: CustomThemes | undefined, isWindows: boolean) => CustomThemes;
 export declare const getThemeStorageController: () => ThemeStorageController;

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

@@ -1,4 +1,3 @@
-import { GeneratedPalettes } from '../../../../common/src/api/theming';
 import { ColorSchemeOptionType, CustomPaletteSet } from '../../../../client-api-platform/src/shapes';
 /**
  * Palette extensions can be used to add new variables to the palette set.
@@ -27,22 +26,17 @@ export declare const getPaletteExtensions: (palette: CustomPaletteSet, paletteSc
     'scrollbar-track-rgb': string;
     selectedTab: string;
 };
-export type LegacyPalettes = {
+export type Palettes = {
     dark: CustomPaletteSet;
     light: CustomPaletteSet;
 };
-export type Palettes = {
-    light: string;
-    dark: string;
-};
 export declare class ThemeStorageController {
     private providerStorage;
     private darkPaletteVars?;
     private lightPaletteVars?;
     private workspaceStorage?;
-    private themePaletteSheet?;
-    private generatedPalettes?;
     constructor(providerStorage: Pick<Storage, 'getItem' | 'setItem'>);
+    private getVarsByScheme;
     /**
      * Set the current Storage Proxy to enable Workspace Storage properties to be populated.
      *
@@ -70,11 +64,7 @@ export declare class ThemeStorageController {
      * to allow workspace UI elements to load the palette before their first paint.
      * @param palettes Light and Dark Palette constants
      */
-    setLegacyPalettes: ({ light, dark }: LegacyPalettes, isWindows: boolean) => Promise<void>;
-    setPalettes: ({ light, dark }: {
-        light: string;
-        dark: string;
-    }) => Promise<void>;
+    setPalettes: ({ light, dark }: Palettes, isWindows: boolean) => Promise<void>;
     /**
      * Set the current scheme of workspace. Specifically setting light or dark
      * will ignore the OS scheme, whereas 'system' will always respect it.
@@ -88,15 +78,9 @@ 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/theming.d.ts

@@ -1,16 +1,5 @@
 import type OpenFin from '@openfin/core';
-import type { GenerateThemeParams, LegacyPalettes } 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: LegacyPalettes) => GenerateThemeParams;

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

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

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

@@ -4,7 +4,7 @@ import type { AnalyticsEvent } from '../../common/src/utils/usage-register';
 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 { CustomThemes } 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';
@@ -1420,27 +1420,12 @@ export interface LaunchAppRequest {
     target?: OpenFin.EntityInfo;
     app: App;
 }
+/**
+ * Get Themes from API
+ */
 export interface ThemeApi {
-    /**
-     * @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.
-     */
+    getThemes(): Promise<CustomThemes>;
     setSelectedScheme(newScheme: ColorSchemeOptionType): Promise<void>;
-    /**
-     * Get the selected scheme from the platform provider.
-     * @returns the selected scheme.
-     */
     getSelectedScheme(): Promise<ColorSchemeOptionType>;
 }
 /**

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

@@ -17,5 +17,6 @@ export type ManifestNotificationsConfig = {
     };
 };
 export declare function getNotificationCenterUuid(): Promise<string>;
+export declare function getSyncChannelName(): Promise<string>;
 export declare const getNotificationsSyncChannelClient: () => Promise<NotificationsSyncChannelClient>;
 export {};

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

@@ -85,14 +85,6 @@ type WorkspaceChannelTypes = {
     'set-search-query': (payload: SearchQueryWithProviderID) => Promise<void>;
     'assign-home-search-context': (payload: Partial<HomeSearchListenerRequest['context']>) => Promise<void>;
     'set-selected-scheme': (ctx: ColorSchemeOptionType) => Promise<void>;
-    'initialize-theme': (themeData: {
-        themePaletteSheet: string;
-        selectedScheme: ColorSchemeOptionType;
-        themePalette: {
-            light: string;
-            dark: string;
-        };
-    }) => Promise<void>;
     'get-legacy-pages': () => Promise<Page[]>;
     'get-legacy-workspaces': (payload: undefined) => Promise<LegacyWorkspace[]>;
     'register-storefront-provider': () => Promise<void>;

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

@@ -35,8 +35,6 @@ export declare enum WorkspacePlatformChannelAction {
     GetLastFocusedBrowserWindow = "getLastFocusedBrowserWindow",
     GetPageByViewIdentity = "getPageByViewIdentity",
     GetThemes = "getThemes",
-    GetGeneratedPalettes = "getGeneratedPalettes",
-    GetThemePaletteSheet = "getThemePaletteSheet",
     GetSelectedScheme = "getSelectedScheme",
     SetSelectedScheme = "setSelectedScheme",
     OpenGlobalContextMenuInternal = "openGlobalContextMenuInternal",

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

@@ -19,8 +19,8 @@ export declare const launchProvider: () => Promise<void>;
  */
 export declare const getChannelClientAndLaunchProvider: () => Promise<WorkspaceComponentChannelClient>;
 /**
- * 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.
+ * Launches the Workspace provider if it is not running.
  * 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 getChannelClientAndInitializeWorkspaceProvider: () => Promise<WorkspaceAPIClientChannelClient>;
+export declare const getClientAPIChannelClientAndLaunchProvider: () => Promise<WorkspaceAPIClientChannelClient>;

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

@@ -1,13 +1,8 @@
 import type { DefaultTheme } from 'styled-components';
 import type OpenFin from '@openfin/core';
 import type { ColorSchemeType, ThemeSet } from '@openfin/ui-library';
+import { Palette } from '@openfin/ui-library/dist/theme';
 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;
@@ -126,19 +121,10 @@ export type CustomThemeOptionsWithScheme = BaseThemeOptions & {
      */
     notificationIndicatorColors?: NotificationIndicatorColorsWithScheme;
 };
-export type ThemeOptions = BaseThemeOptions & {
-    seed: Parameters<typeof generateTheme>[0];
-    overrides?: Parameters<typeof generateTheme>[1];
-};
-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 CustomThemes = (CustomThemeOptions | CustomThemeOptionsWithScheme)[];
 export interface PreloadedThemeData {
-    themes: CustomThemes | GeneratedPalettes;
+    themes: CustomThemes;
     selectedScheme: ColorSchemeOptionType;
-    themePaletteSheet?: string;
 }
 export interface DefaultPaletteSet {
     brandPrimary: string;
@@ -280,12 +266,15 @@ export declare const OpenFinDarkTheme: {
 };
 export declare const DefaultOpenFinTheme: CustomThemes;
 export declare const getComputedPaletteSets: (customTheme: CustomThemeOptions | CustomThemeOptionsWithScheme) => WorkspaceThemeSet;
-export declare const getComputedPlatformTheme: (platformIdentity: OpenFin.Identity) => Promise<{
-    theme: CustomThemes | GeneratedPalettes;
-    defaultScheme: ColorSchemeOptionType;
-}>;
+/**
+ * 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, storedScheme?: ColorSchemeOptionType) => ComputedThemes;
+export declare const getComputedPlatformTheme: (platformIdentity: OpenFin.Identity) => Promise<ComputedTheme>;
 export declare const setSelectedScheme: (ctx: ColorSchemeOptionType) => Promise<void>;
 export declare const getComputedScheme: (identity?: OpenFin.Identity) => Promise<Exclude<ColorSchemeType, "system">>;
-export declare const getComputedBackgroundColor: (platformIdentity: OpenFin.Identity) => Promise<string>;
-export declare const constructThemePaletteSheet: (themes: GeneratedPalettes) => string;
-export {};
+export declare const getComputedBackgroundColor: (paletteKey: keyof typeof Palette, defaultColor?: string) => Promise<string>;

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

@@ -1,6 +1,6 @@
 import type OpenFin from '@openfin/core';
 import { EnterpriseMainContextMenuItemData, EnterpriseMainContextMenuItemTemplate, OpenGlobalContextMenuPayload } from '../../../client-api-platform/src/shapes';
-export declare const getEnterpriseContextMenuTemplate: ({ identity }: {
+export declare const getEnterpriseContextMenuTemplate: ({ identity, selectedViews }: {
     identity: OpenFin.Identity;
     selectedViews: OpenFin.Identity[];
 }) => Promise<EnterpriseMainContextMenuItemTemplate[]>;