@openfin/workspace-platform 45.1.19 → 45.2.1

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

@@ -1,7 +1,7 @@
 import type OpenFin from '@openfin/core';
 import { App } from '../../../client-api/src/shapes';
 import { SearchProvider } from '../../../client-api-platform/src/shapes';
-import type { LaunchAppRequest, SearchSitesRequest, SearchSitesResponse, Site } from '../shapes';
+import type { ContentSortRequest, LaunchAppRequest, SearchSitesRequest, SearchSitesResponse, Site } from '../shapes';
 /**
  * Launch the app described by an App Directory entry.
  * @param app the app directory entry.
@@ -19,7 +19,8 @@ export declare function getSearchProviders(payload: {
 }): Promise<SearchProvider[]>;
 export declare function getCuratedContent(payload: {
     identity: OpenFin.Identity;
+    req?: ContentSortRequest;
 }): Promise<Site[]>;
-export declare function getRecentlyVisited(payload: {
-    identity: OpenFin.Identity;
+export declare function getRecentlyVisited(payload: ContentSortRequest & {
+    identity?: OpenFin.Identity;
 }): Promise<App[]>;

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

@@ -10,5 +10,7 @@ export declare function getLanguageResourcesInternal(): {
  * initLanguage()
  * @param language - optional - ISO language code. Built-in languages are always accepted.
  * Any language code defined in the external `translation-override.json` is also accepted.
+ * @param languagePacksApiUrl - optional i18next-http-backend loadPath. When set,
+ * HTTP language packs are used instead of the bundled locale JSON.
  */
-export default function initLanguage(language?: Locale): Promise<void>;
+export default function initLanguage(language?: Locale, languagePacksApiUrl?: string): Promise<void>;

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

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

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

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

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

@@ -0,0 +1 @@
+import '@common/test/fin-mocks';

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

@@ -1,8 +1,9 @@
 import type OpenFin from '@openfin/core';
+import type { BrowserCreateViewRequest } from '../../../../client-api-platform/src/shapes';
 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>): Promise<any>;
+export declare function applyViewDefaults(options: Partial<BrowserCreateViewRequest>, initViewOptions?: Partial<BrowserCreateViewRequest>): Promise<any>;
 export {};

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

@@ -658,13 +658,23 @@ export interface BrowserWorkspacePlatformWindowOptions {
      */
     title?: WindowTitle | string;
     /**
-     * Landing page that shows up when you add a new tab from the plus button that exists in the tabstrip.
-     * If you do not provide a newTabUrl, then the plus button in the tabstrip will not be shown and users cannot create a new empty tab.
+     * URL used for new-tab actions: the plus button in the tabstrip, the new-tab hotkey, and the
+     * "New tab" context menu entry.
+     *
+     * If you do not provide a newTabUrl, then the plus button in the tabstrip will not be shown and
+     * users cannot create a new empty tab.
+     *
+     * This does not control a newly created window's initial content; that comes from `pages`.
      */
     newTabUrl?: string;
     /**
-     * Landing page that shows up when you add a new page from the plus button that exists in the window frame where the page selector is shown.
-     * If you do not provide a newPageUrl, then the new Page plus button will not be shown and you cannot create a new empty Page or Window.
+     * URL used for new-page and new-window actions.
+     *
+     * If you do not provide a newPageUrl, then the new Page plus button will not be shown and you
+     * cannot create a new empty Page or Window.
+     *
+     * This does not automatically control a newly created window's initial content; a caller of
+     * `Browser.createWindow` must include a page using this URL in `pages`.
      */
     newPageUrl?: string;
     toolbarOptions?: ToolbarOptions;
@@ -2234,6 +2244,10 @@ export interface WorkspacePlatformInitConfig {
      * external `translation-override.json` (configured via `translationOverridesUrl`) is
      * also accepted.
      *
+     * When `languagePacksApiUrl` is set, i18next loads packs over HTTP from that
+     * i18next-http-backend `loadPath` (e.g. `${origin}/platform/api/localization/{{lng}}/{{ns}}.json`)
+     * instead of the bundled locale JSON. Omit it to keep the built-in packs.
+     *
      * @example
      * ```ts
      * await WorkspacePlatform.init({
@@ -2250,6 +2264,11 @@ export interface WorkspacePlatformInitConfig {
      */
     language?: {
         initialLanguage?: Locale;
+        /**
+         * i18next-http-backend loadPath. When provided, HTTP language packs are used
+         * even if the manifest did not inject `languagePacksApiUrl`.
+         */
+        languagePacksApiUrl?: string;
     };
     /**
      * Override workspace platform behavior
@@ -2497,9 +2516,28 @@ export interface BrowserInitConfig {
     /** Default options when creating a new page. If `iconUrl`, `unsavedIconUrl`, `panels` or `closeButton` are not defined when creating a page, setting will default to `defaultPageOptions`. */
     defaultPageOptions?: Pick<Page, 'iconUrl' | 'unsavedIconUrl' | 'closeButton' | 'panels'>;
     /**
-     * The default options when creating a new browser window. Any option not included in WorkspacePlatform.getCurrentSync().Browser.createView(options) call will default to the value provided in this field.
+     * The default options when creating a new view. Any option not included in WorkspacePlatform.getCurrentSync().Browser.createView(options) call will default to the value provided in this field.
+     *
+     * @example
+     * ```ts
+     * import * as WorkspacePlatform from '@openfin/workspace-platform';
+     *
+     * await WorkspacePlatform.init({
+     *   browser: {
+     *     defaultViewOptions: {
+     *       workspacePlatform: {
+     *         browserNavigationButtons: {
+     *           back: true,
+     *           forward: true,
+     *           reload: true
+     *         }
+     *       }
+     *     }
+     *   }
+     * });
+     * ```
      */
-    defaultViewOptions?: Partial<OpenFin.ViewOptions>;
+    defaultViewOptions?: Partial<BrowserCreateViewRequest>;
     /**
      * The platform title. UI friendly title for the platform in browser.
      */

package/common/src/api/flags/index.d.ts

@@ -0,0 +1,37 @@
+export declare enum Flag {
+    WorkspaceStorefrontEnabled = "WorkspaceStorefrontEnabled",
+    SentryEnabled = "SentryEnabled",
+    WorkspaceDockEnabled = "WorkspaceDockEnabled",
+    WorkspaceHomeEnabled = "WorkspaceHomeEnabled",
+    DevDebug = "DevDebug",
+    HttpLanguagePacksEnabled = "HttpLanguagePacksEnabled"
+}
+export type WorkspaceFlags = Record<Flag, boolean>;
+export declare const flags: Partial<WorkspaceFlags>;
+/**
+ * Initialize flags from overrides. This should be called early in the application lifecycle.
+ * This is a no-op if flags have already been initialized.
+ */
+export declare const initializeFlags: () => Promise<void>;
+/**
+ * Flag Interface --
+ *
+ * @example Enabled / Disabled Closures
+ * flag(
+ *     'feature',
+ *     () => 'Enabled Feature',
+ *     () => 'Disabled Feature'
+ * );
+ *
+ * @example Enabled only
+ * flag('feature', myFeatureFunc);
+ *
+ * @example Boolean
+ * flag('feature');
+ */
+export declare function flag<EnabledReturn, DisabledReturn>(flagName: Flag, cbEnabled?: () => EnabledReturn, cbDisabled?: () => DisabledReturn): EnabledReturn | DisabledReturn | boolean;
+declare global {
+    interface Window {
+        __WORKSPACE_FLAGS__: typeof flags;
+    }
+}

package/common/src/api/i18next-bundled-resources.d.ts

@@ -0,0 +1,7 @@
+import { type Resource } from 'i18next';
+/**
+ * All seven statically bundled locale dictionaries. Loaded only on the flag-off
+ * (legacy) path so the http regime does not pull non-English packs into the
+ * main common chunk.
+ */
+export declare const bundledResources: Resource;

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

@@ -1,6 +1,21 @@
 import i18next, { type Resource } from 'i18next';
 import { Locale } from '../../../client-api-platform/src/shapes';
-declare function initI18next(language?: Locale): Promise<void>;
+export type LanguagePacksRegime = 'http' | 'legacy';
+export declare const HTTP_BACKEND_REQUEST_OPTIONS: RequestInit;
+export declare const resolveLanguagePacksRegime: (httpFlagEnabled: boolean, languagePacksApiUrl?: string) => LanguagePacksRegime;
+export declare const getHttpBackendOptions: (loadPath: string) => {
+    loadPath: string;
+    requestOptions: RequestInit;
+};
+/**
+ * Overlay OFD's canonical en-US pack on the bootstrap stub.
+ * Fire-and-forget: first paint and the logo menu must not wait on this GET.
+ */
+export declare const overlayEnglishFromHttpBackend: () => void;
+export type InitI18nextOptions = {
+    languagePacksApiUrl?: string;
+};
+declare function initI18next(language?: Locale, options?: InitI18nextOptions): Promise<void>;
 export declare const setLanguageInI18next: (locale: Locale) => Promise<void>;
 declare const t: import("i18next").TFunction<["translation", ...string[]], undefined>;
 export { initI18next, i18next, t, type Resource };

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

@@ -16,6 +16,16 @@ export interface Overrides {
     disableOpenFinAnalytics: boolean;
     analyticsEndpoint: string;
     translationOverridesUrl: string;
+    /**
+     * i18next-http-backend loadPath injected when org `languagePacks.enabled` is on
+     * (e.g. `${base}/platform/api/localization/{{lng}}/{{ns}}.json`).
+     */
+    languagePacksApiUrl: string;
+    /**
+     * BCP-47 tags shown in the Language submenu. This is the org Active set
+     * (HERE defaults and/or admin-uploaded packs), not only bundled client languages.
+     */
+    activeLanguages: string[];
     /**
      * WRK-4846
      * This property is internal but is being temporarily exposed for Wells Fargo.

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

@@ -264,8 +264,6 @@ export type AddDefaultPagePayload = {
     identity: OpenFin.Identity;
     /** The page to attach. */
     page: PageWithUpdatableRuntimeAttribs;
-    /** The newPageUrl provided. */
-    newPageUrl: string;
 };
 export type AddPagePayload = {
     /** The OF window identity to attach the pages to. */

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

@@ -0,0 +1,47 @@
+import type OpenFin from '@openfin/core';
+export declare const ENTERPRISE_COLOR_CHANNELS: {
+    readonly 'fdc3.channel.1': {
+        readonly name: "Channel 1";
+        readonly color: "red";
+        readonly glyph: "1";
+    };
+    readonly 'fdc3.channel.2': {
+        readonly name: "Channel 2";
+        readonly color: "orange";
+        readonly glyph: "2";
+    };
+    readonly 'fdc3.channel.3': {
+        readonly name: "Channel 3";
+        readonly color: "yellow";
+        readonly glyph: "3";
+    };
+    readonly 'fdc3.channel.4': {
+        readonly name: "Channel 4";
+        readonly color: "green";
+        readonly glyph: "4";
+    };
+    readonly 'fdc3.channel.5': {
+        readonly name: "Channel 5";
+        readonly color: "cyan";
+        readonly glyph: "5";
+    };
+    readonly 'fdc3.channel.6': {
+        readonly name: "Channel 6";
+        readonly color: "blue";
+        readonly glyph: "6";
+    };
+    readonly 'fdc3.channel.7': {
+        readonly name: "Channel 7";
+        readonly color: "magenta";
+        readonly glyph: "7";
+    };
+    readonly 'fdc3.channel.8': {
+        readonly name: "Channel 8";
+        readonly color: "purple";
+        readonly glyph: "8";
+    };
+};
+export declare const normalizeColorChannelId: (colorChannelId: string) => string | undefined;
+export declare const areColorChannelIdsEqual: (firstColorChannelId: string, secondColorChannelId: string) => boolean;
+export declare const getContextGroupDisplayName: (contextGroup: OpenFin.ContextGroupInfo) => string;
+export declare const getContextGroupCssColor: (contextGroup: OpenFin.ContextGroupInfo) => string;

package/common/src/utils/enabled-locales.d.ts

@@ -0,0 +1,5 @@
+export type EnabledLocale = {
+    tag: string;
+    displayName: string;
+};
+export declare const getEnabledLocales: () => Promise<EnabledLocale[]>;

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

@@ -9,7 +9,6 @@ export declare const isEnterpriseBrowserPlatform: (browserInitOptions: BrowserIn
 export declare function formatUrl(url: string): string;
 export declare const getIsEnterpriseBrowser: (id?: OpenFin.Identity) => Promise<boolean>;
 export declare const isLandingPage: (url: string) => boolean;
-export declare const isLandingPageOrEmpty: (url: string) => boolean;
 export declare const isDefaultEnterpriseView: (viewIdentity: OpenFin.Identity) => boolean;
 export declare const getAICompanionViewIdentity: (browserIdentity?: OpenFin.Identity) => {
     uuid: string;

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

@@ -100,6 +100,9 @@ export declare const downloads: () => {
 export declare const appearance: () => {
     label: string;
 };
+export declare const language: () => {
+    label: string;
+};
 export declare const getSavedWorkspaceContextMenuOptions: (activeWorkspace: Workspace, savedWorkspaces: Pick<Workspace, "workspaceId" | "title">[], contextMenuOptionType: GlobalContextMenuOptionType) => {
     label: string;
     type: MenuItemType;
@@ -119,4 +122,13 @@ export declare const getAppearanceContextMenuOptions: () => Promise<{
         scheme: WP.ColorSchemeOptionType;
     };
 }[]>;
+export declare const getLanguageContextMenuOptions: () => Promise<{
+    label: string;
+    type: MenuItemType;
+    checked: boolean;
+    data: {
+        type: WP.EnterpriseMainContextMenuOptionType;
+        locale: string;
+    };
+}[]>;
 export declare const getGlobalContextMenuTemplate: (winIdentity: OpenFin.Identity, selectedViews?: OpenFin.Identity[]) => Promise<GlobalContextMenuItemTemplate[]>;

package/common/src/utils/landing-page.d.ts

@@ -3,14 +3,19 @@ interface LandingPageUrls {
     newPageUrl: string | false;
     newTabUrl: string | false;
 }
+/**
+ * Which window option supplies the landing URL: `newTabUrl` for a new tab, `newPageUrl` for a new
+ * page or window. Enterprise Browser presents pages as tabs, so both go through page creation.
+ */
+export type NewLandingPageUrlSource = 'newTab' | 'newPage';
 export declare const getLandingPageUrls: (winIdentity?: OpenFin.Identity) => Promise<LandingPageUrls>;
 export declare const checkHasNewTabUrl: () => Promise<boolean>;
 export declare const getNewLandingTabViewOptions: (target: OpenFin.Identity) => Promise<OpenFin.PlatformViewCreationOptions>;
 /**
  * Makes a new landing page.
  *
- * If winIdentity is specified, it uses the newPageUrl defined by the browser window options.
- * Otherwise, if the platform is Enterprise, it will use the landing page URL.
+ * If winIdentity is specified, it uses the URL defined by the browser window options for the given
+ * `urlSource`. Otherwise, if the platform is Enterprise, it will use the landing page URL.
  */
-export declare const makeNewLandingPage: (winIdentity?: OpenFin.Identity) => Promise<import("client-api-platform").PageWithUpdatableRuntimeAttribs>;
+export declare const makeNewLandingPage: (winIdentity?: OpenFin.Identity, urlSource?: NewLandingPageUrlSource) => Promise<import("client-api-platform").PageWithUpdatableRuntimeAttribs>;
 export {};

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

@@ -1,7 +1,7 @@
 import type OpenFin from '@openfin/core';
 import { WindowIdentity } from '../../../common/src/utils/window';
 import type { PagePinnedState } from '../../../common/src/api/pages/shapes';
-import { AttachedPage, PageLayout } from '../../../client-api-platform/src/shapes';
+import { AttachedPage, BrowserCreateViewRequest, PageLayout } from '../../../client-api-platform/src/shapes';
 export type LayoutDOMEventType = 
 /**
  * Fired when a tab is created in a container. (Emmitted by ??)
@@ -90,7 +90,7 @@ export declare const generateViewNameAndIdentifierNameIfNotExists: <T extends {
  * @param layout The Layout to be cloned
  * @returns A Promise resolving to a copy of the layout with view options converted
  */
-export declare const cloneLayoutAndConvertViewOptions: (layout: PageLayout, initViewOptions?: Partial<OpenFin.ViewOptions>) => Promise<PageLayout>;
+export declare const cloneLayoutAndConvertViewOptions: (layout: PageLayout, initViewOptions?: Partial<BrowserCreateViewRequest>) => Promise<PageLayout>;
 export declare const cloneViewComponentWithoutName: (componentState: any) => any;
 /**
  * Deep clones a layout and removes generated view names.

package/common/src/utils/local-storage-key.d.ts

@@ -6,6 +6,7 @@ declare enum LocalStorageKey {
     NewTabPageSort = "NewTabPageSort",
     DockPosition = "DockPosition",
     SelectedColorScheme = "SelectedColorScheme",
+    SelectedLanguage = "SelectedLanguage",
     ThemePaletteSheet = "ThemePaletteSheet",
     HasMovedStore = "HasMovedStore",
     PageDragState = "BrowserPageDragState",

package/common/src/utils/popup-window.d.ts

@@ -171,8 +171,5 @@ export type SearchMenuChannelResponse = {
 } | {
     type: 'single-provider-results-announcement';
     message: string;
-} | {
-    /** Landing page was clicked. Chrome collapses search if view-focused never arrived. */
-    type: 'page-clicked';
 };
 export {};

package/externals.report.json

@@ -13,18 +13,18 @@
             "issuer": "common/src/utils/layout.ts"
         }
     ],
-    "title-case": [
+    "lodash.clonedeep": [
         {
             "type": "explicit",
-            "version": "3.0.3",
+            "version": "4.5.0",
             "packageName": "common/package.json",
-            "issuer": "common/src/utils/color-linking.ts"
+            "issuer": "common/src/utils/layout.ts"
         }
     ],
     "react-i18next": [
         {
             "type": "explicit",
-            "version": "15.4.0",
+            "version": "^17.0.11",
             "packageName": "common/package.json",
             "issuer": "common/src/api/i18next.ts"
         }
@@ -32,25 +32,25 @@
     "i18next": [
         {
             "type": "explicit",
-            "version": "^23.7.16",
+            "version": "^26.3.6",
             "packageName": "common/package.json",
             "issuer": "common/src/api/i18next.ts"
         }
     ],
-    "lodash.clonedeep": [
+    "i18next-http-backend": [
         {
             "type": "explicit",
-            "version": "4.5.0",
+            "version": "^4.0.0",
             "packageName": "common/package.json",
-            "issuer": "common/src/utils/layout.ts"
+            "issuer": "common/src/api/i18next.ts"
         }
     ],
     "dexie": [
         {
             "type": "explicit",
             "version": "^4.0.11",
-            "packageName": "client-api-platform/package.json",
-            "issuer": "client-api-platform/src/api/dock/idb.ts"
+            "packageName": "common/package.json",
+            "issuer": "common/src/api/pages/idb.ts"
         },
         {
             "type": "root-implicit",
@@ -61,8 +61,8 @@
         {
             "type": "explicit",
             "version": "^4.0.11",
-            "packageName": "common/package.json",
-            "issuer": "common/src/api/pages/idb.ts"
+            "packageName": "client-api-platform/package.json",
+            "issuer": "client-api-platform/src/api/dock/idb.ts"
         },
         {
             "type": "explicit",
@@ -70,5 +70,13 @@
             "packageName": "common/package.json",
             "issuer": "common/src/utils/create-and-migrate-ibd-store.ts"
         }
+    ],
+    "title-case": [
+        {
+            "type": "explicit",
+            "version": "3.0.3",
+            "packageName": "common/package.json",
+            "issuer": "common/src/utils/color-channels.ts"
+        }
     ]
 }