@openfin/workspace 17.2.0 → 17.2.2

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

@@ -0,0 +1,13 @@
+import { Locale } from '../../../client-api-platform/src/shapes';
+export declare function getLanguage(): Locale;
+export declare const dispatchLanguageToBrowserWindows: (language: Locale) => Promise<void[]>;
+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;
+};
+/**
+ * initLanguage()
+ * @param language - optional - ISO language code
+ */
+export default function initLanguage(language?: Locale): Promise<void>;

package/client-api-platform/src/api/translation-override.d.ts

@@ -0,0 +1,19 @@
+import type { i18next as i18n } from '../../../common/src/api/i18next';
+/**
+ * Returns a score for a version string depending on how specific it is. Higher == more specific.
+ * E.g. 16.x.0 gives a score of 101 whereas 16.5.0 returns 111
+ * @param versionString 3-fragment version string, e.g. 15.0.4, where fragments can be 'x' for generic templates
+ * @returns score from 0 to 111
+ */
+export declare const weighVersionString: (versionString: string) => number;
+/**
+ * Returns array of versions from less specific to more specific
+ * @param matchingVersions versions and templates relevant to the running build
+ */
+export declare const getVersionsSortedByPriority: (matchingVersions: string[]) => string[];
+/**
+ * Applies translation overrides to the i18next dictionary.
+ * In case of failure logs an error without preventing further execution.
+ * @param i18next i18next instance to which to apply the overrides
+ */
+export declare const applyTranslationOverrides: (i18next: typeof i18n) => Promise<void>;

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

@@ -34,4 +34,4 @@ import type { WorkspacePlatformInitConfig } from '../shapes';
  * ```
  * @param options options for configuring the platform.
  */
-export declare const init: ({ theme, customActions, ...rest }: WorkspacePlatformInitConfig) => Promise<void>;
+export declare const init: ({ theme, customActions, language, ...rest }: WorkspacePlatformInitConfig) => Promise<void>;

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

@@ -0,0 +1,2 @@
+import type OpenFin from '@openfin/core';
+export declare const getInteropOverrideCallback: (overrideCallback?: OpenFin.OverrideCallback<OpenFin.InteropBroker, OpenFin.InteropBroker>) => OpenFin.OverrideCallback<OpenFin.InteropBroker, OpenFin.InteropBroker>;

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

@@ -2,6 +2,7 @@ import type OpenFin from '@openfin/core';
 import { IconProps } from '@openfin/ui-library';
 import type { AnalyticsEvent, AnalyticsEventInternal } from '../../common/src/utils/usage-register';
 import { CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
+import { Resource } from '../../common/src/api/i18next';
 import type { AttachedPage, CopyPagePayload, HandleSaveModalOnPageClosePayload, Page, PageWithUpdatableRuntimeAttribs, SaveModalOnPageCloseResult } from '../../common/src/api/pages/shapes';
 import { SetActivePageForWindowPayload } from '../../common/src/api/pages/shapes';
 import { NotificationsCustomManifestOptions } from '../../common/src/api/shapes/notifications';
@@ -1414,6 +1415,39 @@ export interface WorkspacePlatformModule extends OpenFin.Platform {
      * ```
      */
     applyWorkspace(workspace: Workspace, options?: ApplyWorkspaceOptions): Promise<boolean>;
+    /**
+     * Returns ISO language code of current set language
+     *
+     * @returns One of the seven ISO language codes Browser supports
+     *
+     * @example Example of how to get the current language on Browser
+     *
+     * ```ts
+     * import * as WorkspacePlatform from '@openfin/workspace-platform';
+     * WorkspacePlatform.getCurrentSync().getLanguage();
+     * ```
+     */
+    getLanguage(): Promise<Locale>;
+    /**
+     * Fetches currently selected language and language resources from platform provider.
+     * @internal
+     */
+    _getLanguageResources(): Promise<{
+        currentLanguage: Locale;
+        resources: Resource;
+    }>;
+    /**
+     * Sets the language to ISO language code passed in
+     * @param locale the ISO language code
+     *
+     * @example Example of how to set a different language on Browser
+     *
+     * ```ts
+     * import * as WorkspacePlatform from '@openfin/workspace-platform';
+     * WorkspacePlatform.getCurrentSync().setLanguage('zh-CN');
+     * ```
+     */
+    setLanguage(locale: Locale): Promise<void>;
     /**
      * Implementation for getting the notifications workspace platform configuration.
      */
@@ -1568,7 +1602,11 @@ export interface WorkspacePlatformProvider extends OpenFin.PlatformProvider {
      */
     setActivePage(payload: SetActivePageForWindowPayload): Promise<void>;
     /**
-     *  Implementation for creating a copy of a page. Called when a page is Saved-As or Duplicated.
+     * Implementation for creating a copy of a page. Called when a page is Saved-As or Duplicated.
+     *
+     * Note: The `page.layout` and `page.panels` property cannot be overridden for 'Save As' operations,
+     * the `page.layout` and `page.panels` property provided in the return value will be ignored, and the layout and panels of
+     * the original page will remain after 'Save As' is performed.
      */
     copyPage(payload: CopyPagePayload): Promise<Page>;
 }
@@ -1680,6 +1718,8 @@ export interface AnalyticsConfig {
      */
     sendToOpenFin: boolean;
 }
+export declare const SUPPORTED_LANGUAGES: readonly ["en-US", "ja-JP", "zh-CN", "ko-KR", "ru-RU", "de-DE", "zh-Hant"];
+export type Locale = (typeof SUPPORTED_LANGUAGES)[number];
 /**
  * Configuration for initializing a Workspace platform.
  */
@@ -1743,6 +1783,27 @@ export interface WorkspacePlatformInitConfig {
      * ```
      */
     theme?: CustomThemes;
+    /**
+     * Set a language on Browser by providing one of the seven languages that Workspace supports
+     * Must specify one of the ISO language codes 'en-US', 'ja-JP', 'zh-CN', 'ko-KR', 'ru-RU', 'de-DE' or 'zh-Hant'
+     *
+     * @example
+     * ```ts
+     * await WorkspacePlatform.init({
+     *   browser: {
+     *      title: "My Browser"
+     *   },
+     *   language: {
+     *      initialLanguage: 'ru-RU'
+     *   }
+     * });
+     * ```
+     * @default 'en-EN'
+     *
+     */
+    language?: {
+        initialLanguage?: Locale;
+    };
     /**
      * Override workspace platform behavior
      */

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

@@ -0,0 +1,7 @@
+import i18next, { type Resource } from 'i18next';
+import { Locale } from '../../../client-api-platform/src/shapes';
+declare function initI18next(language?: Locale): void;
+export declare const setLanguageInI18next: (locale: Locale) => void;
+declare const t: import("i18next").TFunction<["translation", ...string[]], undefined>;
+export { initI18next, i18next, t, type Resource };
+export { useTranslation } from 'react-i18next';

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

@@ -17,6 +17,7 @@ export interface Overrides {
     browserBaseUrl: string;
     disableOpenFinAnalytics: boolean;
     analyticsEndpoint: string;
+    translationOverridesUrl: string;
 }
 export declare function getOverrides(): Promise<Partial<Overrides>>;
 export declare const useOverrides: () => Partial<Overrides>;

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

@@ -30,7 +30,8 @@ declare enum GeneralBrowserChannelActions {
     OpenSaveModalInternal = "open-save-modal-internal",
     DuplicatePage = "duplicate-page",
     SetSelectedScheme = "set-selected-scheme",
-    ShowBrowserIndicator = "show-browser-indicator"
+    ShowBrowserIndicator = "show-browser-indicator",
+    SetSelectedLanguage = "set-selected-language"
 }
 /**
  * All of the remote procedures that can be called in the
@@ -70,6 +71,7 @@ export declare const BrowserChannelAction: {
     DuplicatePage: GeneralBrowserChannelActions.DuplicatePage;
     SetSelectedScheme: GeneralBrowserChannelActions.SetSelectedScheme;
     ShowBrowserIndicator: GeneralBrowserChannelActions.ShowBrowserIndicator;
+    SetSelectedLanguage: GeneralBrowserChannelActions.SetSelectedLanguage;
 };
 export type BrowserChannelAction = typeof BrowserChannelAction;
 export {};

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

@@ -51,6 +51,9 @@ export declare enum WorkspacePlatformChannelAction {
     SetActiveWorkspace = "setActiveWorkspace",
     IsBrowserInitialized = "isBrowserInitialized",
     Analytics = "analyticsInternal",
+    GetLanguage = "getLanguage",
+    GetLanguageResourcesInternal = "getLanguageResourcesInternal",
+    SetLanguage = "setLanguage",
     GetDockProviderConfig = "getDockProviderConfig",
     SaveDockProviderConfig = "saveDockProviderConfig",
     HandleSaveModalOnPageClose = "handleSaveModalOnPageClose",

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

@@ -1,54 +1,4 @@
 import type OpenFin from '@openfin/core';
-import { MenuItemType } from '../../../common/src/utils/context-menu';
-import * as WP from '../../../client-api-platform/src/index';
-import { GlobalContextMenuItemTemplate, GlobalContextMenuOptionType, Workspace } from '../../../client-api-platform/src/shapes';
+import { GlobalContextMenuItemTemplate } from '../../../client-api-platform/src/shapes';
 export declare const isOSWindows: () => Promise<boolean>;
-export declare const savePage: {
-    type: MenuItemType;
-    label: string;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-    };
-};
-export declare const savePageAs: {
-    type: MenuItemType;
-    label: string;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-    };
-};
-export declare const saveWorkspace: {
-    type: MenuItemType;
-    label: string;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-    };
-};
-export declare const saveWorkspaceAs: {
-    type: MenuItemType;
-    label: string;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-    };
-};
-export declare const printMenuOptions: (isViewSelected: boolean) => Promise<GlobalContextMenuItemTemplate>;
-export declare const getSavedWorkspaceContextMenuOptions: (activeWorkspace: Workspace, savedWorkspaces: Workspace[], contextMenuOptionType: GlobalContextMenuOptionType) => {
-    label: string;
-    type: MenuItemType;
-    enabled: boolean;
-    checked: boolean;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-        workspaceId: string;
-    };
-}[];
-export declare const getAppearanceContextMenuOptions: () => Promise<{
-    label: string;
-    type: MenuItemType;
-    checked: boolean;
-    data: {
-        type: WP.GlobalContextMenuOptionType;
-        scheme: WP.ColorSchemeOptionType;
-    };
-}[]>;
 export declare const getGlobalContextMenuTemplate: (winIdentity: OpenFin.Identity, selectedViews?: OpenFin.Identity[]) => Promise<GlobalContextMenuItemTemplate[]>;

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

@@ -36,4 +36,5 @@ export interface RightButtonConfig {
 export type ButtonConfig = {
     label: string;
     type: 'primary' | 'secondary';
+    id: string;
 };