@openfin/workspace 45.0.15 → 45.1.0-alpha.2539edb0

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

@@ -1,3 +1,4 @@
+import { PlatformError } from '../../../common/src/errors';
 import { ProviderType } from '../../../common/src/api/provider';
 /**
  * Error thrown when attempting to use a provider that is not registered.
@@ -7,7 +8,7 @@ import { ProviderType } from '../../../common/src/api/provider';
  * // Error: Dock Provider. Dock Provider with id my-dock-id is not currently registered.
  * ```
  */
-export declare class ProviderNotRegisteredError extends Error {
+export declare class ProviderNotRegisteredError extends PlatformError {
     constructor(providerType: ProviderType, id?: string);
 }
 /**
@@ -19,7 +20,7 @@ export declare class ProviderNotRegisteredError extends Error {
  * // Error: Home Provider. Home Provider with id my-home-id is already registered.
  * ```
  */
-export declare class ProviderAlreadyRegisteredError extends Error {
+export declare class ProviderAlreadyRegisteredError extends PlatformError {
     constructor(providerType: ProviderType, id?: string);
 }
 /**
@@ -31,7 +32,7 @@ export declare class ProviderAlreadyRegisteredError extends Error {
  * // Error: Failed to get Storefront Provider. Storefront Provider with id unknown-id is not currently registered.
  * ```
  */
-export declare class FailedToGetProviderError extends Error {
+export declare class FailedToGetProviderError extends PlatformError {
     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.View | OpenFin.Identity | OpenFin.Platform | OpenFin.Application>;
+export declare function launchApp({ app, target }: LaunchAppRequest): Promise<void | OpenFin.Identity | OpenFin.Platform | OpenFin.View | OpenFin.Application>;
 export declare const enterpriseAppDirectoryChannelClient: () => Promise<OpenFin.ChannelClient>;
 export declare function getResults(payload: {
     req: SearchSitesRequest;

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

@@ -1,13 +1,23 @@
+import type { PlatformCapabilities } from '../../../client-api-platform/src/shapes';
 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";
+    currentLanguage: string;
     resources: import("i18next").Resource;
 };
+/**
+ * This API returns what functionality is supported by the platform.
+ * This is useful when Home/Dock/NC is of a higher version
+ * and may depend on functionality that is not available
+ * in the current Workspace Platform version.
+ * @internal
+ */
+export declare function getCapabilitiesInternal(): PlatformCapabilities;
 /**
  * initLanguage()
- * @param language - optional - ISO language code
+ * @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.
  */
 export default function initLanguage(language?: Locale): Promise<void>;

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

@@ -1,4 +1,6 @@
 export * from './shapes';
 export * as Dock from '../../dock3/src/api';
+export * as HomeVpw from '../../home-vpw/src/api';
+export * as StorefrontVpw from '../../storefront-vpw/src/api';
 export { init } from './init';
 export { getCurrentSync, wrapSync } from './api';

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/init/view-tab-new-tab-shortcut-usage.d.ts

@@ -0,0 +1,4 @@
+export declare const registerViewTabNewTabShortcutUsageTracking: () => void;
+export declare const unregisterViewTabNewTabShortcutUsageTracking: () => void;
+/** @internal */
+export declare const resetViewTabNewTabShortcutUsageTrackingForTests: () => void;

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

@@ -1,7 +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 { IconProps, IconType } from '@openfin/ui-library';
 import type { WorkspaceIndicatorConfig } from '../../common/src/utils/indicators/workspace-indicators';
+import type { ModalResponseEvent } from '../../common/src/utils/menu-window-provider';
 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';
@@ -14,6 +14,7 @@ import type { WorkflowIntegration } from '../../client-api/src/shapes/integratio
 import type { DockCompanionButton } from '../../dock3/src/shapes/index';
 import type { AddPagesOptions, BasePageOpts, PageOpts } from '../../enterprise-api/src/shapes';
 export * from '../../dock3/src/shapes';
+export * from '../../storefront-vpw/src/shapes';
 export { AppManifestType } from '../../client-api/src/shapes';
 export type { App, AppIntent, Image } from '../../client-api/src/shapes';
 export type { CustomActionSpecifier, CustomButtonConfig } from '../../common/src/api/action';
@@ -22,6 +23,17 @@ export { PanelPosition } from '../../common/src/api/pages/shapes';
 export type { CustomThemes, CustomThemeOptions, ThemeOptions, CustomThemeOptionsWithScheme, CustomPaletteSet, BaseThemeOptions, ThemeExtension, WorkspaceThemeSet, NotificationIndicatorColorsSet, NotificationIndicatorColorsSetDarkScheme, NotificationIndicatorColorsSetLightScheme, NotificationIndicatorColorsWithScheme } from '../../common/src/api/theming';
 export type { AnalyticsEvent } from '../../common/src/utils/usage-register';
 export type { WorkflowIntegration } from '../../client-api/src/shapes/integrations';
+/**
+ * Platform capabilities for feature detection by workspace components (Home, Dock).
+ * @internal
+ */
+export interface PlatformCapabilities {
+    languageBroadcast?: {
+        home?: boolean;
+        dock?: boolean;
+        notifications?: boolean;
+    };
+}
 /**
  * Request for creating a saved page in persistent storage.
  */
@@ -388,6 +400,14 @@ export declare enum ViewTabMenuOptionType {
      * Prints a screenshot of the browser window.
      */
     PrintScreen = "PrintScreen",
+    /**
+     * Translate the selected view's content to the detected target language.
+     */
+    TranslatePage = "TranslatePage",
+    /**
+     * Revert translated content back to the original language.
+     */
+    RevertTranslation = "RevertTranslation",
     /**
      * Custom context menu option defined by API client.
      */
@@ -2076,9 +2096,9 @@ export interface WorkspacePlatformModule extends OpenFin.Platform {
      */
     restoreLastSavedWorkspace(options?: ApplyWorkspaceOptions): Promise<RestoreLastSavedWorkspaceResult>;
     /**
-     * Returns ISO language code of current set language
+     * Returns the ISO language code of the currently active language.
      *
-     * @returns One of the seven ISO language codes Browser supports
+     * @returns The active language code (e.g. `'en-US'`, `'es-ES'`).
      *
      * @example Example of how to get the current language on Browser
      *
@@ -2096,6 +2116,11 @@ export interface WorkspacePlatformModule extends OpenFin.Platform {
         currentLanguage: Locale;
         resources: Resource;
     }>;
+    /**
+     * Returns platform capabilities for feature detection by workspace components.
+     * @internal
+     */
+    _getCapabilities(): Promise<PlatformCapabilities>;
     /**
      * Sets the language to ISO language code passed in
      * @param locale the ISO language code
@@ -2633,8 +2658,73 @@ export interface AnalyticsConfig {
      */
     sendToOpenFin: boolean;
 }
+/**
+ * The built-in language codes supported by the Workspace Platform out of the box.
+ *
+ * @deprecated No longer used for language validation. The platform now accepts any language
+ * code that has a resource bundle registered in i18next, including codes defined in an
+ * external `translation-override.json`. This export will be removed in a future major version.
+ */
 export declare const SUPPORTED_LANGUAGES: string[];
-export type Locale = Languages;
+/**
+ * An ISO language code accepted by the Workspace Platform.
+ *
+ * **Built-in languages** (supported out of the box):
+ * - `en-US` — English (default)
+ * - `de-DE` — German
+ * - `ja-JP` — Japanese
+ * - `ko-KR` — Korean
+ * - `ru-RU` — Russian
+ * - `zh-CN` — Chinese (Simplified)
+ * - `zh-Hant` — Chinese (Traditional)
+ *
+ * **Adding custom languages** via `translationOverridesUrl`:
+ *
+ * Supply a `translationOverridesUrl` in your Desktop Owner Settings (DOS) or application manifest
+ * pointing to a `translation-override.json` file. Any language code defined in that file will be
+ * accepted at runtime in addition to the built-in list above.
+ *
+ * Example `translation-override.json`:
+ * ```json
+ * {
+ *   "x.x.x": {
+ *     "es-ES": {
+ *       "global.save": "Guardar",
+ *       "contextMenu.newWindow": "Nueva ventana"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * The `translationOverridesUrl` can be configured in two ways:
+ *
+ * _Via Desktop Owner Settings_ (`dos.json` on macOS, registry on Windows):
+ * ```json
+ * {
+ *     "desktopSettings": {
+ *         "systemApps": {
+ *             "workspace": {
+ *                 "customConfig": {
+ *                     "translationOverridesUrl": "https://example.com/translation-override.json"
+ *                 }
+ *             }
+ *         }
+ *     }
+ * }
+ * ```
+ *
+ * _Via the application manifest_ (under `platform.workspace`):
+ * ```json
+ * {
+ *   "platform": {
+ *     "workspace": {
+ *       "translationOverridesUrl": "https://example.com/translation-override.json"
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export type Locale = string;
 /**
  * Configures the workspace to self-host using an asar bundle at the
  * specified path.
@@ -2722,8 +2812,12 @@ 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'
+     * Set the initial language for the Browser.
+     *
+     * The built-in ISO language codes are `'en-US'`, `'ja-JP'`, `'zh-CN'`, `'ko-KR'`,
+     * `'ru-RU'`, `'de-DE'`, and `'zh-Hant'`. Any additional language code defined in an
+     * external `translation-override.json` (configured via `translationOverridesUrl`) is
+     * also accepted.
      *
      * @example
      * ```ts
@@ -2736,7 +2830,7 @@ export interface WorkspacePlatformInitConfig {
      *   }
      * });
      * ```
-     * @default 'en-EN'
+     * @default 'en-US'
      *
      */
     language?: {
@@ -2996,9 +3090,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/home-search-host.d.ts

@@ -0,0 +1,8 @@
+import type { SearchProviderInfo, SearchTopic } from '../../../search-api/src/shapes';
+export type HomeSearchHostCallbacks = {
+    onRegister?: (searchProvider?: SearchProviderInfo) => void | Promise<void>;
+    onDeregister?: (searchProvider?: SearchProviderInfo) => void | Promise<void>;
+    onDisconnect?: () => void | Promise<void>;
+};
+export declare const registerHomeSearchHost: (callbacks?: HomeSearchHostCallbacks) => Promise<SearchTopic | null>;
+export declare const createVpwHomeSearchHostCallbacks: () => HomeSearchHostCallbacks;

package/common/src/api/home-vpw-search-channel.d.ts

@@ -0,0 +1,2 @@
+/** Search topic channel for Home VPW — scoped per platform. */
+export declare const getHomeVpwSearchChannelName: () => string;

package/common/src/api/home-vpw-search-host.d.ts

@@ -0,0 +1,4 @@
+import type { SearchProviderInfo, SearchTopic } from '../../../search-api/src/shapes';
+import type { HomeSearchHostCallbacks } from './home-search-host';
+export declare const registerHomeVpwSearchHost: (callbacks?: HomeSearchHostCallbacks) => Promise<SearchTopic | null>;
+export type { SearchProviderInfo };

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

@@ -1,7 +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 function initI18next(language?: Locale): 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 };
 export { useTranslation } from 'react-i18next';

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

@@ -33,11 +33,16 @@ type HomeAPIClientChannelActions = Record<string, never>;
 type WorkspaceAPIClientChannelActions = StoreAPIClientChannelActions | DockAPIClientChannelActions | HomeAPIClientChannelActions;
 /****** End of API Client Channel Actions ******/
 /****** Workspace Component Channel Actions ******/
+export type WorkspaceComponentSetSelectedLanguagePayload = {
+    locale: string;
+    identity: OpenFin.Identity;
+};
 /**
  * Channel Actions **registered** by all workspace components.
  */
 type SharedChannelActions = {
     'set-selected-scheme': (ctx: WorkspaceComponentSetSelectedSchemePayload) => Promise<void>;
+    'set-selected-language': (payload: WorkspaceComponentSetSelectedLanguagePayload) => Promise<void>;
 };
 /**
  * Channel Actions **registered** by the Home workspace component.
@@ -93,6 +98,7 @@ type WorkspaceChannelTypes = {
             dark: string;
         };
     }) => Promise<void>;
+    'set-selected-language': (locale: 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

@@ -61,6 +61,7 @@ export declare enum WorkspacePlatformChannelAction {
     GetLanguage = "getLanguage",
     GetLanguageResourcesInternal = "getLanguageResourcesInternal",
     SetLanguage = "setLanguage",
+    GetCapabilitiesInternal = "getCapabilitiesInternal",
     GetDockProviderConfig = "getDockProviderConfig",
     SaveDockProviderConfig = "saveDockProviderConfig",
     HandleSaveModalOnPageClose = "handleSaveModalOnPageClose",

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

@@ -7,6 +7,7 @@ export declare const channelName: "__of_workspace_protocol__";
 export declare const getChannelClient: () => Promise<WorkspaceComponentChannelClient>;
 export declare const getClientAPIChannelClient: () => Promise<WorkspaceAPIClientChannelClient>;
 export declare const getSearchClientAPIChannelClient: () => Promise<withDisconnectListener<SearchAPIClientChannelClient>>;
+export declare const getHomeVpwSearchClientAPIChannelClient: () => Promise<withDisconnectListener<SearchAPIClientChannelClient>>;
 /**
  * Launches the Workspace Provider.
  * If the Workspace Provider is already running, does nothing.

package/common/src/api/workspace-events.d.ts

@@ -0,0 +1,53 @@
+import { NavigatePayload } from '../../../common/src/utils/navigate';
+import { ProviderConnectionPayload, ProviderDisconnectionPayload, ProviderUpdatePayload } from './provider';
+/**
+ * All Workspace related events that can be emitted or listened to
+ * by the Workspace Provider or any of the workspace components
+ */
+type EventTypeTypes = {
+    /**
+     * Emitted when a search is invoked.
+     */
+    'search-invoked': [string];
+    /**
+     * Emitted when a new provider is connected.
+     *
+     * For example, when a Dock Provider is successfully registered by the platform provider
+     */
+    'provider-connected': [ProviderConnectionPayload];
+    /**
+     * Emitted when a provider is disconnected.
+     *
+     * For example, when a Dock Provider is deregistered by the platform provider
+     */
+    'provider-disconnected': [ProviderDisconnectionPayload];
+    /**
+     * Emitted when a provider is updated.
+     *
+     * For example, when a Dock Provider is updated by the platform provider
+     */
+    'provider-updated': [ProviderUpdatePayload];
+    /**
+     * Emmitted when notifications is created or destroyed.
+     */
+    'update-notification-running-status': [];
+    /**
+     * Emitted when the list of search providers has been updated.
+     */
+    'search-provider-list-updated': [];
+    /**
+     * Emitted when the list of Storefront VPW providers has been updated.
+     */
+    'storefront-provider-list-updated': [];
+    /**
+     * Emmitted when a component is created or destroyed.
+     */
+    'component-lifecycle-update': [];
+    /**
+     * Emitted when component should be navigated to.
+     * Contains the target provider ID and the component name.
+     */
+    'component-navigation': [NavigatePayload];
+};
+export declare const addListener: <EventKey extends keyof EventTypeTypes>(event: EventKey, listener: (...payload: EventTypeTypes[EventKey]) => void) => void, removeListener: <EventKey extends keyof EventTypeTypes>(event: EventKey, listener: (...payload: EventTypeTypes[EventKey]) => void) => void, addListenerWithUUID: (uuid: string) => <EventKey extends keyof EventTypeTypes>(event: EventKey, listener: (...payload: EventTypeTypes[EventKey]) => void) => void, emit: <EventKey extends keyof EventTypeTypes>(event: EventKey, ...payload: EventTypeTypes[EventKey]) => Promise<void>;
+export {};

package/common/src/errors/AppError.d.ts

@@ -0,0 +1,37 @@
+/**
+ * AppError — base class for all application errors.
+ *
+ * Use a subclass (NetworkError, PlatformError, etc.) — never instantiate AppError directly
+ * in production code. The class identity (`error.name`) is the category; `context` carries
+ * the specifics; `cause` chains the underlying error.
+ *
+ * `instanceof` is the supported way to branch on error type. `toJSON()` is what the
+ * existing logger's safeStringify uses to produce structured output, so logging an
+ * AppError preserves the full chain automatically.
+ */
+export interface ErrorContext {
+    [key: string]: unknown;
+}
+export interface SerializedError {
+    name: string;
+    message: string;
+    context: ErrorContext;
+    stack?: string;
+    cause?: SerializedError;
+    timestamp: string;
+}
+export interface AppErrorOptions {
+    cause?: unknown;
+    context?: ErrorContext;
+}
+export declare class AppError extends Error {
+    readonly context: ErrorContext;
+    readonly timestamp: Date;
+    constructor(message: string, options?: AppErrorOptions);
+    serialize(): SerializedError;
+    /**
+     * Called automatically by JSON.stringify so `safeStringify({ error })` in the logger
+     * produces the full structured form without any logger changes.
+     */
+    toJSON(): SerializedError;
+}

package/common/src/errors/errors.d.ts

@@ -0,0 +1,23 @@
+import { AppError, AppErrorOptions } from './AppError';
+/** Put `{ url, status, method, timeoutMs }` in context as relevant. */
+export declare class NetworkError extends AppError {
+}
+/** Put `{ field, received, expected }` in context. */
+export declare class ValidationError extends AppError {
+}
+/** Put `{ status, scope, userId }` in context as available. */
+export declare class AuthError extends AppError {
+}
+/** OpenFin / runtime / channel / provider failures. Put `{ providerId, channelName, identity }` in context. */
+export declare class PlatformError extends AppError {
+}
+/** Read/write failures against persistent storage. Put `{ key, operation }` in context. */
+export declare class StorageError extends AppError {
+}
+/** Bad or missing configuration discovered at runtime. Put `{ configKey, env }` in context. */
+export declare class ConfigError extends AppError {
+}
+/** Catch-all. Prefer creating via `toAppError(unknown)` rather than directly. */
+export declare class UnknownError extends AppError {
+}
+export type { AppErrorOptions };

package/common/src/errors/index.d.ts

@@ -0,0 +1,6 @@
+export { AppError } from './AppError';
+export type { AppErrorOptions, ErrorContext, SerializedError } from './AppError';
+export { NetworkError, ValidationError, AuthError, PlatformError, StorageError, ConfigError, UnknownError } from './errors';
+export { toAppError } from './toAppError';
+export { ok, err, isOk, isErr, unwrap, mapResult } from './result';
+export type { Ok, Err, Result } from './result';

package/common/src/errors/result.d.ts

@@ -0,0 +1,23 @@
+import { AppError } from './AppError';
+/**
+ * Result<T, E> — opt-in alternative to throwing for operations whose callers
+ * genuinely need to branch on success vs failure (e.g., a save that has a clear
+ * fallback path). Don't blanket-replace throws — invariant violations and
+ * programmer errors should still throw.
+ */
+export type Ok<T> = {
+    readonly ok: true;
+    readonly value: T;
+};
+export type Err<E extends AppError = AppError> = {
+    readonly ok: false;
+    readonly error: E;
+};
+export type Result<T, E extends AppError = AppError> = Ok<T> | Err<E>;
+export declare const ok: <T>(value: T) => Ok<T>;
+export declare const err: <E extends AppError>(error: E) => Err<E>;
+export declare const isOk: <T, E extends AppError>(r: Result<T, E>) => r is Ok<T>;
+export declare const isErr: <T, E extends AppError>(r: Result<T, E>) => r is Err<E>;
+/** Throw on Err, return value on Ok. Use sparingly — defeats the type-level branch. */
+export declare const unwrap: <T, E extends AppError>(r: Result<T, E>) => T;
+export declare const mapResult: <T, U, E extends AppError>(r: Result<T, E>, fn: (value: T) => U) => Result<U, E>;

package/common/src/errors/toAppError.d.ts

@@ -0,0 +1,14 @@
+import { AppError } from './AppError';
+/**
+ * Narrow `unknown` (the type of a catch variable when `useUnknownInCatchVariables` is on)
+ * to an AppError. Pass through existing AppErrors unchanged; wrap raw Errors and other
+ * values in UnknownError, preserving the original via `cause`.
+ *
+ * @example
+ * try {
+ *   await doThing();
+ * } catch (e) {
+ *   throw toAppError(e);
+ * }
+ */
+export declare const toAppError: (caught: unknown, fallbackMessage?: string) => AppError;

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

@@ -0,0 +1,42 @@
+/**
+ * Kept in a standalone module with type-only imports so consumers can pull it in
+ * via the `@openfin/enterprise-api/color-channels` subpath without bundling the SDK.
+ */
+export declare const ENTERPRISE_COLOR_CHANNELS: {
+    readonly blue: {
+        readonly name: "Blue";
+        readonly color: "#0091EB";
+    };
+    readonly indigo: {
+        readonly name: "Indigo";
+        readonly color: "#6450FF";
+    };
+    readonly pink: {
+        readonly name: "Pink";
+        readonly color: "#E878CF";
+    };
+    readonly teal: {
+        readonly name: "Teal";
+        readonly color: "#24D1D1";
+    };
+    readonly green: {
+        readonly name: "Green";
+        readonly color: "#00AF78";
+    };
+    readonly orange: {
+        readonly name: "Orange";
+        readonly color: "#FF7D37";
+    };
+    readonly red: {
+        readonly name: "Red";
+        readonly color: "#F94144";
+    };
+    readonly yellow: {
+        readonly name: "Yellow";
+        readonly color: "#F9C74F";
+    };
+    readonly gray: {
+        readonly name: "Gray";
+        readonly color: "#828788";
+    };
+};

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

@@ -1,4 +1,4 @@
 import type OpenFin from '@openfin/core';
 import { ViewTabContextMenuTemplate } from '../../../client-api-platform/src/shapes';
 export declare const getChannelsMenuOptions: (channelsForViews: string[], colorGroups: OpenFin.ContextGroupInfo[]) => Promise<ViewTabContextMenuTemplate[]>;
-export declare const ENTERPRISE_COLOR_CHANNELS: Map<string, OpenFin.ContextGroupInfo['displayMetadata']>;
+export { ENTERPRISE_COLOR_CHANNELS } from './color-channels';

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

@@ -15,7 +15,7 @@ export type ShowContextMenuResponse = OpenFin.MenuResult & {
 export declare function showContextMenu(opts: OpenFin.ShowPopupMenuOptions, 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 getEmptyContextMenuItem: () => OpenFin.MenuItemTemplate;
 export declare const DefaultSaveMenuBounds: {
     width: number;
     height: number;
@@ -27,4 +27,5 @@ export declare const getBoundsBasedOnAnchorBehavior: (bounds: OpenFin.Bounds, an
     height: number;
     width: number;
 };
+export declare const getTranslateItems: (viewIdentities: OpenFin.Identity[]) => Promise<ViewTabContextMenuTemplate[]>;
 export declare const getPrintOption: () => Promise<ViewTabContextMenuTemplate | PageTabContextMenuItemTemplate>;

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: "" | "window" | "view";
+export declare const finEntityType: "" | "view" | "window";
 export declare const isEnvLocal: boolean;
 export declare const isEnvDev: boolean;
 export declare const isEnvStaging: boolean;