@openfin/workspace 24.1.0 → 24.1.2-alpha.c84bc0a1

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

@@ -1 +1,2 @@
 import '@common/test/fin-mocks';
+import '@common/test/logger-mock';

package/client-api/src/internal/providers.d.ts

@@ -1,10 +1,36 @@
 import { ProviderType } from '../../../common/src/api/provider';
+/**
+ * Error thrown when attempting to use a provider that is not registered.
+ * @example
+ * ```typescript
+ * throw new ProviderNotRegisteredError('dock', 'my-dock-id');
+ * // Error: Dock Provider. Dock Provider with id my-dock-id is not currently registered.
+ * ```
+ */
 export declare class ProviderNotRegisteredError extends Error {
     constructor(providerType: ProviderType, id?: string);
 }
+/**
+ * Error thrown when attempting to register a provider that is already registered.
+ * Call `deregister` before registering again.
+ * @example
+ * ```typescript
+ * throw new ProviderAlreadyRegisteredError('home', 'my-home-id');
+ * // Error: Home Provider. Home Provider with id my-home-id is already registered.
+ * ```
+ */
 export declare class ProviderAlreadyRegisteredError extends Error {
     constructor(providerType: ProviderType, id?: string);
 }
+/**
+ * Error thrown when failing to retrieve a provider by ID.
+ * Typically thrown by `getProviderOrFail` when the requested provider does not exist.
+ * @example
+ * ```typescript
+ * throw new FailedToGetProviderError('storefront', 'unknown-id');
+ * // Error: Failed to get Storefront Provider. Storefront Provider with id unknown-id is not currently registered.
+ * ```
+ */
 export declare class FailedToGetProviderError extends Error {
     constructor(providerType: ProviderType, id?: string);
 }

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.Platform | OpenFin.View | OpenFin.Application>;
+export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.View | OpenFin.Identity | OpenFin.Platform | OpenFin.Application>;
 export declare const enterpriseAppDirectoryChannelClient: () => Promise<OpenFin.ChannelClient>;
 export declare function getResults(payload: {
     req: SearchSitesRequest;

package/client-api-platform/src/api/context-menu/index.d.ts

@@ -1,5 +1,5 @@
 import type OpenFin from '@openfin/core';
-import { EnterpriseMenuType } from '../../../../common/src/utils/popup-window';
+import { PopupWindowMenuType } from '../../../../common/src/utils/popup-window';
 import { InternalOpenGlobalContextMenuRequest, InternalOpenPageTabContextMenuRequest, OpenGlobalContextMenuPayload, OpenPageTabContextMenuPayload, OpenSaveButtonContextMenuPayload, OpenSaveButtonContextMenuRequest, OpenViewTabContextMenuPayload, OpenViewTabContextMenuRequest, WorkspacePlatformProvider } from '../../../../client-api-platform/src/shapes';
 /**
  * Enum representing the possible anchor behaviors for positioning context menus.
@@ -17,7 +17,7 @@ export declare enum AnchorBehavior {
     Center = 4
 }
 type ContextMenuPayload = OpenGlobalContextMenuPayload | OpenViewTabContextMenuPayload | OpenPageTabContextMenuPayload | OpenSaveButtonContextMenuPayload;
-export declare const openCommonContextMenu: (payload: ContextMenuPayload, _callerIdentity: OpenFin.Identity, type?: EnterpriseMenuType, anchorBehavior?: AnchorBehavior) => Promise<void>;
+export declare const openCommonContextMenu: (payload: ContextMenuPayload, _callerIdentity: OpenFin.Identity, type?: PopupWindowMenuType, anchorBehavior?: AnchorBehavior) => Promise<void>;
 export declare function openGlobalContextMenuInternal(this: WorkspacePlatformProvider, payload: InternalOpenGlobalContextMenuRequest & {
     identity: OpenFin.Identity;
 }, callerIdentity: OpenFin.Identity): Promise<void>;

package/client-api-platform/src/api/controllers/storage-proxies/channel-storage-proxy.d.ts

@@ -0,0 +1,19 @@
+import { StorageProxy } from '../../../../../client-api-platform/src/api/utils';
+/**
+ * Channel Storage Proxy allows population of storage keys in a different origin, assuming that origin has set up
+ * a storage proxy on the specified URL.
+ *
+ * This is useful for writing to the localStorage of workspace when the provider is on a different origin.
+ */
+export declare class ChannelStorageProxy implements StorageProxy {
+    #private;
+    constructor(url: string);
+    get isDestroyed(): boolean;
+    /**
+     * Sets a key in the proxied storage partition.
+     * @param key Key to set
+     * @param value Value.
+     */
+    setItem(key: string, value: string): Promise<void>;
+    destroy(): Promise<void>;
+}

package/client-api-platform/src/api/controllers/storage-proxies/local-storage-proxy.d.ts

@@ -0,0 +1,12 @@
+import { StorageProxy } from '../../../../../client-api-platform/src/api/utils';
+/**
+ * LocalStorage backed StorageProxy, for use in same origin scenarios (i.e. when the provider and workspace UI are guaranteed
+ * to share a storage partition).
+ */
+export declare class LocalStorageProxy implements StorageProxy {
+    #private;
+    constructor(storage: Pick<Storage, 'setItem'>);
+    setItem(key: string, value: string): Promise<void>;
+    destroy(): Promise<void>;
+    get isDestroyed(): boolean;
+}

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

@@ -17,3 +17,20 @@ export declare const initialiseStoragePalettes: (customThemes: CustomThemes | un
     notificationIndicatorColors: NotificationIndicatorColorsParsed | null;
 };
 export declare const getThemeStorageController: () => ThemeStorageController;
+/**
+ * Resolves when the first theme sync completes. Use this to ensure that we do not launch UI such as browser until this has completed.
+ *
+ * @param allowFailure Whether to suppress rejections and continue anyway. Recommended for most use cases.
+ */
+export declare const waitForFirstThemeSync: (allowFailure?: boolean) => Promise<void>;
+/**
+ * Creates and initialises the Theme Storage Controller singleton.
+ *
+ * Triggers the first theme sync, but does not await it. To ensure dependent UI can guarantee the theme palette is synced,
+ * you can call `await waitForFirstThemeSync` (e.g. in the createWindow provider override).
+ *
+ * @param isEnterprise Whether in enterprise mode (allows using local storage proxy directly).
+ * @param baseUrl Base url of the hosted workspace UI.
+ * @param syncTimeout How long `waitForFirstThemeSync` should wait before rejecting.
+ */
+export declare const initialiseThemeController: (isEnterprise: boolean, baseUrl: string, syncTimeout: number) => void;

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

@@ -24,36 +24,29 @@ export type Palettes = {
     dark: string;
 };
 export declare class ThemeStorageController {
+    #private;
     private providerStorage;
     private darkPaletteVars?;
     private lightPaletteVars?;
     private themePaletteSheet?;
     private generatedPalettes?;
     private workspaceStorage?;
-    private recreateFactory?;
-    constructor(providerStorage: Pick<Storage, 'getItem' | 'setItem'>);
+    private storageFactory?;
+    private isLegacySinglePaletteTheme;
+    constructor(providerStorage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>);
     /**
-     * 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.
+     * Sets the storage factory. This can only be done once, and will throw for subsequent calls.
+     *
+     * All storage writes will be pending until the factory is created.
+     * @param factory
      */
-    setRecreateFactory: (factory: () => Promise<StorageProxy>) => void;
+    setStorageFactory: (factory: () => 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.
+     * Clears the reference before awaiting destroy() to avoid a race with getOrCreateStorageProxy.
      */
     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,9 +55,9 @@ export declare class ThemeStorageController {
     private hasUserPreference;
     /**
      * 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.
+     * storage based theming is enabled.
      */
-    trySynchronizeWorkspaceStorage: () => Promise<void>;
+    synchronizeWorkspaceStorage: () => 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
@@ -84,12 +77,25 @@ export declare class ThemeStorageController {
      * @param scheme 'light', 'dark' or 'system'.
      */
     setScheme(scheme: ColorSchemeOptionType): void;
+    /**
+     * Clears an explicit user scheme choice (e.g. from Appearance) so resolution falls back to theme default.
+     */
+    clearUserSelectedSchemePreference(): void;
+    setLegacySinglePaletteTheme(value: boolean): void;
+    /** @internal */
+    getIsLegacySinglePaletteTheme(): boolean;
     /**
      * Set the theme's default scheme from palette configuration
      * @param scheme The default scheme specified in the palette
      */
     setThemeDefaultScheme(scheme: ColorSchemeOptionType): void;
     setGeneratedPalettes(generatedPalettes: GeneratedPalettes): void;
+    /**
+     * Write the theme palette sheet to both in-memory state and providerStorage (namespaced localStorage)
+     * immediately. This ensures the theme is available for themeLoader on same-origin pages
+     * without waiting for the workspace storage proxy to be initialised.
+     */
+    setThemePaletteSheet(sheet: string): void;
     /**
      * Returns the current scheme
      * @returns 'light' | 'system' | 'dark'

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

@@ -26,10 +26,15 @@ export declare const getActivePageIdForWindow: (identity: OpenFin.Identity) => P
  *
  * If the name is not unique, it will append a number to the end of the name.
  *
+ * When `BrowserInitConfig.allowDuplicatePageTitles` is `true`, this function
+ * short-circuits and returns the supplied name (or the default title) as-is,
+ * without appending a numeric suffix.
+ *
  * @param initialName The initial name to test
- * @returns string: a unique page name
+ * @param allowDuplicatePageTitles Whether duplicate page titles are permitted
+ * @returns string: a unique page name (or the input unchanged when duplicates are allowed)
  */
-export declare function getUniquePageTitle(initialName?: string): Promise<string>;
+export declare function getUniquePageTitle(initialName?: string, allowDuplicatePageTitles?: boolean): Promise<string>;
 export declare function handleSaveModalOnPageClose({ page }: HandleSaveModalOnPageClosePayload): Promise<SaveModalOnPageCloseResult>;
 /**
  * Default implementation of shouldPageClose. If enableBeforeUnload isn't set to true, always returns True (proceed with close).

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

@@ -12,6 +12,8 @@ export declare const dispatchThemeToWorkspaceProvider: (themeData: {
 }) => Promise<void>;
 export declare const setSelectedScheme: (schemeType: ColorSchemeOptionType) => Promise<void>;
 export declare const getSelectedScheme: () => ColorSchemeOptionType | null | undefined;
+/** @internal */
+export declare const getIsLegacySinglePaletteTheme: () => boolean;
 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/utils.d.ts

@@ -2,11 +2,6 @@ export declare const listenForStoreClose: () => void;
 export type StorageProxy = {
     setItem: (data: string, value: string) => Promise<void>;
     destroy: () => Promise<void>;
+    isDestroyed: boolean;
 };
-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>;
+export declare const getStorageFactory: (isEnterprise: boolean, baseUrl: string) => (() => StorageProxy);

package/client-api-platform/src/init/browser-window-focus.d.ts

@@ -4,6 +4,10 @@ import type OpenFin from '@openfin/core';
  * @returns {Promise<OpenFin.Identity | undefined>} The last focused browser window identity, or undefined if not found.
  */
 export declare function getLastFocusedBrowserWindow(): Promise<OpenFin.Identity | undefined>;
+/**
+ * Gets all browser windows
+ */
+export declare function getAllBrowserWindows(): Promise<OpenFin.Window[]>;
 /**
  * Gets the last focused browser window that isn't minimized.
  * @returns {Promise<OpenFin.Identity | undefined>} The last focused browser window identity that isn't minimized, or undefined if not found.

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

@@ -1,5 +1,6 @@
 import OpenFin from '@openfin/core';
 import { WorkspacePlatformInitConfig } from '../../../client-api-platform/src/shapes';
+export declare const MAX_FIRST_THEME_SYNC_WAIT = 3000;
 /**
  * Initilaize a Workspace Platform.
  *
@@ -35,4 +36,4 @@ import { WorkspacePlatformInitConfig } from '../../../client-api-platform/src/sh
  * ```
  * @param options options for configuring the platform.
  */
-export declare const init: ({ theme, customActions, language, ...rest }: WorkspacePlatformInitConfig) => Promise<OpenFin.Platform>;
+export declare const init: (config: WorkspacePlatformInitConfig) => Promise<OpenFin.Platform>;

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

@@ -4,4 +4,4 @@ import { BrowserInitConfig } from '../../../../client-api-platform/src/shapes';
 /**
  * Applies default options to the creation of browser windows.
  */
-export declare function applyBrowserDefaults(options: OpenFin.PlatformWindowCreationOptions, initOptions: Pick<BrowserInitConfig, 'defaultWindowOptions' | 'defaultPageOptions' | 'defaultViewOptions' | 'browserIconSize'> | undefined, themeData?: PreloadedThemeData): Promise<OpenFin.PlatformWindowCreationOptions>;
+export declare function applyBrowserDefaults(options: OpenFin.PlatformWindowCreationOptions, initOptions: Pick<BrowserInitConfig, 'defaultWindowOptions' | 'defaultPageOptions' | 'defaultViewOptions' | 'browserIconSize' | 'allowDuplicatePageTitles'> | undefined, themeData?: PreloadedThemeData): Promise<OpenFin.PlatformWindowCreationOptions>;

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" | "allowDuplicatePageTitles">, overrideOptions?: OpenFin.PlatformWindowCreationOptions) => Promise<AttachedPageInternal[]>;

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

@@ -4,10 +4,11 @@ export declare const getThemes: () => CustomThemes | null;
 export declare const getGeneratedPalettes: () => GeneratedPalettes;
 export declare const getThemePaletteSheet: () => string;
 export declare const getNotificationIndicatorColorsInternal: () => NotificationIndicatorColorsParsed;
+export declare const isThemePreInitialised: () => boolean;
 /**
  * initTheming()
  * @param customThemes array of theme objects
- * Accepts an array of CustomThemes objects and stores it
- * @returns array of custom theme objects
+ * Accepts an array of CustomThemes objects and stores it.
+ * Sets themePreInitialised to true so subsequent calls are no-ops.
  */
-export default function initTheming(customThemes: CustomThemes | undefined): Promise<void>;
+export declare const initTheming: (customThemes: CustomThemes | undefined) => Promise<void>;

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

@@ -1,6 +1,7 @@
 import type OpenFin from '@openfin/core';
 import type { IconProps, IconType, Languages } from '@openfin/ui-library';
 import type { ModalResponseEvent } from '../../common/src/utils/menu-window-provider';
+import type { WorkspaceIndicatorConfig } from '../../common/src/utils/indicators/workspace-indicators';
 import type { AnalyticsEvent, AnalyticsEventInternal } from '../../common/src/utils/usage-register';
 import type { BaseCustomDropdownItem, CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
 import type { Resource } from '../../common/src/api/i18next';
@@ -160,6 +161,10 @@ export declare enum PageTabContextMenuOptionType {
     Save = "Save",
     SaveAs = "Save As",
     NewPage = "New Page",
+    /** Enterprise Browser: toggle Golden Layout view tab headers (multi-view Supertabs).
+     * @internal
+     */
+    ShowHideTabs = "ShowHideTabs",// Enterprise
     DeletePage = "Delete Page",// Enterprise
     SaveWorkspaceAs = "SaveWorkspaceAs",// Enterprise
     Refresh = "Refresh",// Enterprise
@@ -175,7 +180,6 @@ export declare enum PageTabContextMenuOptionType {
 /** @internal */
 export declare enum EnterpriseMainContextMenuOptionType {
     Lock = "Lock",
-    ShowHideTabs = "ShowHideTabs",
     AddToChanel = "AddToChannel",
     ManageDesktopSignals = "ManageDesktopSignals",// Enterprise
     FindInPage = "FindInPage",// Enterprise
@@ -666,6 +670,19 @@ export interface BrowserCreateViewRequest extends OpenFin.PlatformViewCreationOp
 export interface BrowserViewState extends OpenFin.ViewState {
     workspacePlatform?: BrowserWorkspacePlatformViewOptions;
 }
+/**
+ * Enables or disables the tab-search chevron button for a specific tab location.
+ */
+export interface TabSearchLocationOptions {
+    enabled: boolean;
+}
+/**
+ * Configures where tab-search chevron buttons should be shown in a browser window.
+ */
+export interface TabSearchButtonOptions {
+    pageTabs?: TabSearchLocationOptions;
+    viewTabs?: TabSearchLocationOptions;
+}
 export interface BrowserWorkspacePlatformWindowOptions {
     /** For internal usage.  Defaults to 'browser' when Browser is enabled when the WorkspacePlatform is initialized.  In order to use
      * non-Browser layout windows ('platform' windows) in a Browser-enabled workspace platform, set windowType to `platform`. In that instance, the other properties
@@ -716,6 +733,32 @@ export interface BrowserWorkspacePlatformWindowOptions {
         minWidth?: string;
         maxWidth?: string;
     };
+    /**
+     * Controls whether tab-search chevron buttons are shown for page tabs and view tabs.
+     *
+     * By default, both locations are disabled unless explicitly enabled.
+     *
+     * @example
+     * ```ts
+     * workspacePlatform: {
+     *   tabSearchButton: {
+     *     viewTabs: { enabled: true },
+     *     pageTabs: { enabled: true }
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * workspacePlatform: {
+     *   tabSearchButton: {
+     *     viewTabs: { enabled: true },
+     *     // pageTabs omitted: disabled
+     *   }
+     * }
+     * ```
+     */
+    tabSearchButton?: TabSearchButtonOptions;
     /**
      * Accessibility options for the browser window.
      * These options override the default accessibility options set at the platform or browser initialization level.
@@ -809,10 +852,23 @@ export interface BrowserWorkspacePlatformWindowOptions {
      * When true, disables the ability to close pages in the window. False by default.
      */
     preventPageClose?: boolean;
+    /**
+     * When true, disables the find in page feature for the window.
+     * The find in page view will not be created and no find in page logic will run.
+     * This option must be set at window creation time and cannot be changed dynamically.
+     * False by default.
+     */
+    disableFindInPage?: boolean;
     /**
      * Taskbar Icon for the Browser Window. If light and dark icon are defined, then the taskbar icon will change when the scheme changes.
      */
     icon?: string | TaskbarIcon;
+    /**
+     * The size of icons in the browser window. This is set from the platform-level
+     * `browserIconSize` option during window creation.
+     * @internal Propagated from BrowserInitConfig.browserIconSize
+     */
+    browserIconSize?: IconSize;
 }
 /**
  * Request for creating a browser window.
@@ -1818,6 +1874,11 @@ export interface ThemeApi {
      * @returns the selected scheme.
      */
     getSelectedScheme(): Promise<ColorSchemeOptionType>;
+    /**
+     * @internal
+     * Whether the active platform theme is a legacy theme defined with a single shared palette (light and dark are not independently specified).
+     */
+    getIsLegacySinglePaletteTheme(): Promise<boolean>;
     /**
      * @internal
      * Get the notification indicator colors from the platform provider.
@@ -2259,6 +2320,11 @@ export interface WorkspacePlatformProvider extends OpenFin.PlatformProvider {
      * @param schemeType {@link ColorSchemeOptionType scheme} to be set
      */
     setSelectedScheme(schemeType: ColorSchemeOptionType): Promise<void>;
+    /**
+     * @internal
+     * Whether the active platform theme is a legacy single-palette theme (Appearance scheme switching is not supported).
+     */
+    getIsLegacySinglePaletteTheme(): boolean;
     /**
      * Implementation for handling Workspace analytics events
      * @param req the payload received by the provider
@@ -2829,7 +2895,6 @@ export type WorkspacePlatformOverrideCallback = OpenFin.OverrideCallback<Workspa
 export type BrowserOverrideCallback = WorkspacePlatformOverrideCallback;
 /**
  * Content menu entry shape cloned and re-exported from UI Library.
- * @internal
  */
 export type ContentMenuEntry = {
     bookmarked?: boolean;
@@ -2857,7 +2922,6 @@ export type BookmarkDockEntryPayload = {
 };
 /**
  * Represents dock entry for favorites
- * @internal
  */
 export type DockEntry = {
     type: 'folder';
@@ -2958,6 +3022,32 @@ export interface BrowserInitConfig {
      * @internal
      */
     aiPanelOptions?: AiPanelOptions;
+    /**
+     * When true, allows multiple pages to share the same title across browser
+     * windows. No numeric suffixes are appended and attach/add operations
+     * will not reject on title collision. `pageId` remains the unique
+     * identifier for all page operations.
+     *
+     * Defaults to `false` (current unique-title behavior preserved).
+     */
+    allowDuplicatePageTitles?: boolean;
+    /**
+     * Opt-in suppression flags for workspace success indicators.
+     * Both flags default to `false`; existing platforms see no behaviour change.
+     *
+     * @example
+     * ```ts
+     * await WorkspacePlatform.init({
+     *   browser: {
+     *     indicators: {
+     *       suppressWorkspaceSwitched: true,
+     *       suppressWorkspaceSaved: true,
+     *     },
+     *   },
+     * });
+     * ```
+     */
+    indicators?: WorkspaceIndicatorConfig;
 }
 interface WorkspaceMetadata {
     APIVersion: string;

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

@@ -61,11 +61,6 @@ export declare const updatePageForWindow: (payload: ExtendedUpdatePageForWindowP
  * @param identity the identity of the window to save the pages of in window options.
  */
 export declare const updatePagesWindowOptions: (identity: OpenFin.Identity) => Promise<void>;
-/**
- * Check if the window identity is currently detaching pages.
- * @param identity the OF window identity to check.
- */
-export declare const isDetachingPages: (identity: OpenFin.Identity) => Promise<boolean>;
 /**
  * Check if the window identity is in the middle of changing active pages.
  * @param identity the OF window identity to check.

package/common/src/api/pages/enterprise-shapes.d.ts

@@ -32,8 +32,12 @@ export interface Page {
     panels?: PanelConfig[];
     /** Used to define the context group for the page */
     contextGroup?: string;
+    /** When true, view tab headers within this Supertab are hidden. */
+    viewTabsHidden?: boolean;
     /** Optional property to attach custom metadata to the page object, such as version or timestamp. Must be serializable. */
     customData?: any;
+    /** True when this page is an admin-published supertab. */
+    isPublished?: boolean;
 }
 type AttachedPageMetadata = {
     /** The window the page is currently attached to. */

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

@@ -96,12 +96,20 @@ export type AttachedPageInternal = {
     isLayoutCreated?: boolean;
     pageIcon?: string;
     isPublished?: boolean;
+    /** Enterprise Browser: hide Golden Layout view tab headers (multi-view Supertabs).
+     * @internal
+     */
+    viewTabsHidden?: boolean;
 } & AttachedPage;
 export type ReparentAttachedPage = AttachedPage & {
     multiInstanceViewBehavior?: 'reparent';
 };
 export type PageWithUpdatableRuntimeAttribs = Page & Pick<AttachedPage, 'hasUnsavedChanges'> & {
     multiInstanceViewBehavior?: OpenFin.MultiInstanceViewBehavior;
+    /** Enterprise Browser: hide Golden Layout view tab headers (multi-view Supertabs).
+     * @internal
+     */
+    viewTabsHidden?: boolean;
 };
 export interface DetachPagesFromWindowPayload {
     /** The OF window identity to detach the pages from. */

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

@@ -52,7 +52,6 @@ export declare enum PageChannelAction {
     ReorderPagesForWindow = "reorder-pages-for-window",
     UpdatePageForWindow = "update-page-for-window",
     UpdatePagesWindowOptions = "update-pages-window-options",
-    IsDetachingPages = "is-detaching-pages",
     IsActivePageChanging = "is-active-page-changing"
 }
 /**
@@ -103,7 +102,6 @@ export declare const BrowserChannelAction: {
     ReorderPagesForWindow: PageChannelAction.ReorderPagesForWindow;
     UpdatePageForWindow: PageChannelAction.UpdatePageForWindow;
     UpdatePagesWindowOptions: PageChannelAction.UpdatePagesWindowOptions;
-    IsDetachingPages: PageChannelAction.IsDetachingPages;
     IsActivePageChanging: PageChannelAction.IsActivePageChanging;
     CloseBrowserWindow: GeneralBrowserChannelActions.CloseBrowserWindow;
     QuitPlatform: GeneralBrowserChannelActions.QuitPlatform;

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

@@ -97,7 +97,9 @@ export declare enum WorkspacePlatformChannelAction {
     SendUpdateVersionModalResponseInternal = "sendUpdateVersionModalResponseInternal",// Enterprise
     ShowUpdateVersionModalInternal = "showUpdateVersionModalInternal",// Enterprise
     ShowApplyAndPublishModalInternal = "showApplyAndPublishModalInternal",// Enterprise
-    GetNotificationIndicatorColorsInternal = "getNotificationIndicatorColorsInternal"
+    GetNotificationIndicatorColorsInternal = "getNotificationIndicatorColorsInternal",// Custom Notification Indicators Colors
+    /** @internal */
+    GetIsLegacySinglePaletteTheme = "getIsLegacySinglePaletteTheme"
 }
 export type PlatFormSupportedFeatures = boolean | {
     isWorkspacePlatform: boolean;

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

@@ -29,6 +29,7 @@ interface EnterpriseBrandIcons {
      * Internal brand options for Enterprise Browser
      */
     symbol: string;
+    wordmark?: string;
 }
 export interface ThemeExtension extends DefaultTheme {
     notificationIndicatorColors?: Record<string, Omit<NotificationIndicatorColorsSet, 'foreground'> & {

package/common/src/test/logger-mock.d.ts

@@ -0,0 +1,5 @@
+export declare const mockLogger: {
+    debug: jest.Mock<any, any, any>;
+    warn: jest.Mock<any, any, any>;
+    error: jest.Mock<any, any, any>;
+};

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

@@ -30,3 +30,10 @@ export declare const getWorkspaceOFApplication: () => OpenFin.Application;
  * @returns A Promise resolving to the application manifest
  */
 export declare const getCachedManifest: () => Promise<OpenFin.Manifest>;
+/**
+ * Gets application info, caching the result after the first call.
+ * Application info (manifestUrl, licenseKey, runtime version, etc.) never changes
+ * during the application lifecycle. Multiple callers (overrides, sentry, analytics)
+ * share a single IPC call.
+ */
+export declare const getCachedAppInfo: () => Promise<OpenFin.ApplicationInfo>;

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

@@ -1,7 +1,7 @@
 import type OpenFin from '@openfin/core';
 import { AnchorBehavior } from '../../../client-api-platform/src/api/context-menu';
 import { PageTabContextMenuItemTemplate, ViewTabContextMenuTemplate } from '../../../client-api-platform/src/shapes';
-import { EnterpriseMenuType } from './popup-window';
+import { PopupWindowMenuType } from './popup-window';
 export declare enum MenuItemType {
     Label = "normal",
     Separator = "separator",
@@ -13,7 +13,7 @@ export type ShowContextMenuResponse = OpenFin.MenuResult & {
     requestId?: string;
 };
 export declare function showContextMenu(opts: OpenFin.ShowPopupMenuOptions, win?: OpenFin.Window): Promise<ShowContextMenuResponse>;
-export declare const showEnterpriseContextMenu: (opts: OpenFin.ShowPopupMenuOptions, type: EnterpriseMenuType, anchorBehavior: AnchorBehavior, win?: OpenFin.Window) => Promise<ShowContextMenuResponse>;
+export declare const showEnterpriseContextMenu: (opts: OpenFin.ShowPopupMenuOptions, type: PopupWindowMenuType, anchorBehavior: AnchorBehavior, win?: OpenFin.Window) => Promise<ShowContextMenuResponse>;
 export declare const Separator: OpenFin.MenuItemTemplate;
 export declare const EmptyContextMenuItem: OpenFin.MenuItemTemplate;
 export declare const DefaultSaveMenuBounds: {

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

@@ -16,3 +16,6 @@ export declare const connectToEnterpriseContentChannel: (uuid: string) => Promis
 export declare const connectToEnterpriseModalChannel: (uuid: string) => Promise<OpenFin.ChannelClient>;
 export declare const createZoomControlsDialogChannel: () => Promise<OpenFin.ChannelProvider>;
 export declare const connectToZoomControlsDialogChannel: () => Promise<OpenFin.ChannelClient>;
+export declare const getTabSearchChannelName: () => string;
+export declare const createTabSearchChannel: () => Promise<OpenFin.ChannelProvider>;
+export declare const connectToTabSearchChannel: () => Promise<OpenFin.ChannelClient>;

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

@@ -11,7 +11,7 @@ export declare const isDocumentDefined: boolean;
 export declare const isWindowDefinedWithIndexDB: boolean;
 export declare const finUUID: string;
 export declare const finName: string;
-export declare const finEntityType: "" | "view" | "window";
+export declare const finEntityType: "" | "window" | "view";
 export declare const isEnvLocal: boolean;
 export declare const isEnvDev: boolean;
 export declare const isEnvStaging: boolean;