@openfin/workspace-platform 23.2.9 → 23.2.11

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

@@ -30,11 +30,30 @@ export declare class ThemeStorageController {
     private themePaletteSheet?;
     private generatedPalettes?;
     private workspaceStorage?;
+    private recreateFactory?;
     constructor(providerStorage: Pick<Storage, 'getItem' | 'setItem'>);
     /**
      * Set the current Storage Proxy to enable Workspace Storage properties to be populated.
      */
     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.

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

@@ -4,3 +4,9 @@ export type StorageProxy = {
     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/common/src/api/theming.d.ts

@@ -291,12 +291,13 @@ export declare const OpenFinDarkTheme: {
 };
 export declare const DefaultOpenFinTheme: CustomThemes;
 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: (platformIdentity: OpenFin.Identity) => Promise<string>;
-export declare const constructThemePaletteSheet: (themes: GeneratedPalettes) => string;
 export {};

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

@@ -1,4 +1,10 @@
+import type OpenFin from '@openfin/core';
 import { BackgroundLayers, CustomPaletteSet } from '../../../common/src/api/theming';
+export type ColorSchemeValue = 'light' | 'dark' | 'system';
+export type WorkspaceSchemeSetting = 'light' | 'dark' | 'system';
+export type MediaSchemeValue = 'light' | 'dark';
+/** Maps a color scheme to OpenFin native theme preferences. */
+export declare const mapColorSchemeToNativeTheme: (scheme: ColorSchemeValue) => OpenFin.NativeTheme;
 /**
  * Parses a CSS color string (hex, rgb(a), or hsl(a)) into a structured RGB string and alpha value.
  *