@openfin/core 45.100.99 → 45.100.101

package/out/mock-alpha.d.ts

@@ -5360,7 +5360,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent | TranslationStateChangedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5844,6 +5844,19 @@ declare type ExternalProcessStartedEvent = BaseEvent_5 & {
     processUuid: string;
 };
 
+/**
+ * Translation status of a translatable WebContents whose translation attempt has failed.
+ */
+declare type FailedTranslationStatus = {
+    status: 'translation-failed';
+    /** The language the page was being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page was being translated to. */
+    targetLanguage: LanguageInfo;
+    /** Human-readable description of why the translation failed. */
+    errorMessage: string;
+};
+
 /**
  * @deprecated, use {@link PageFaviconUpdatedEvent}.
  */
@@ -8174,6 +8187,18 @@ declare type JumpListTask = {
     iconIndex?: number;
 };
 
+/**
+ * Language metadata for content translation.
+ */
+declare type LanguageInfo = {
+    /** ISO language code (e.g. "fr"). */
+    code: string;
+    /** English display name of the language (e.g. "French"). */
+    nameEn: string;
+    /** Localized display name of the language (e.g. "Français"). */
+    nameI18N: string;
+};
+
 /**
  * The LaunchEmitter is an `EventEmitter`. It can listen to app version resolver events.
  *
@@ -10800,6 +10825,14 @@ declare namespace OpenFin_2 {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -10868,6 +10901,16 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Options for {@link OpenFin.WebContents.translatePage}.
+ */
+declare type PageTranslateOptions = {
+    /** BCP-47 language code of the source language, or empty string for auto-detect. */
+    sourceLang: string;
+    /** BCP-47 language code of the target language. */
+    targetLang: string;
+};
+
 /**
  * Reasons for a paste operation being blocked
  *
@@ -13916,6 +13959,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin_2.Identity;
         response: OpenFin_2.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin_2.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin_2.Bounds;
@@ -17410,6 +17459,45 @@ declare type TransitionOptions = {
     tween?: tween;
 };
 
+/**
+ * Describes a WebContents on which content translation is supported.
+ */
+declare type TranslatableWebContentInfo = {
+    /** Whether translation is supported on this WebContents. */
+    translationEnabled: true;
+    /** Detected WebContents language, or undefined if not yet determined. */
+    detectedLanguage?: LanguageInfo;
+    /** Translation status of the WebContents. */
+    state: TranslationStatus;
+};
+
+/**
+ * Translation status of a translatable WebContents that is translated or is being translated.
+ */
+declare type TranslatedPageStatus = {
+    status: 'pending-translation' | 'translated';
+    /** The language the page is being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page is being translated to. */
+    targetLanguage: LanguageInfo;
+};
+
+/**
+ * Generated when the translation state of a WebContents changes, such as when a page in a
+ * foreign language is detected or when a translation completes.
+ * @interface
+ */
+declare type TranslationStateChangedEvent = NamedEvent & {
+    type: 'translation-state-changed';
+} & OpenFin_2.WebContentTranslationInfo;
+
+/**
+ * The translation status of a translatable WebContents.
+ */
+declare type TranslationStatus = {
+    status: 'untranslated';
+} | FailedTranslationStatus | TranslatedPageStatus;
+
 declare class Transport<MeType extends EntityType = EntityType> extends EventEmitter {
     #private;
     protected wireListeners: Map<number, {
@@ -17509,6 +17597,14 @@ declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 
+/**
+ * Describes a WebContents on which content translation is not supported (for example because no
+ * translation API key is configured on the machine, or the current page is not translatable).
+ */
+declare type UntranslatableWebContentInfo = {
+    translationEnabled: false;
+};
+
 /**
  * View options that can be updated after creation.
  *
@@ -18609,6 +18705,26 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level: number): Promise<void>;
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    translatePage(options: OpenFin_2.PageTranslateOptions): Promise<void>;
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    revertTranslation(): Promise<void>;
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    getTranslationState(): Promise<OpenFin_2.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19426,6 +19542,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19434,6 +19551,11 @@ declare namespace WebContentsEvents {
     }
 }
 
+/**
+ * Describes the current content-translation state of a WebContents.
+ */
+declare type WebContentTranslationInfo = UntranslatableWebContentInfo | TranslatableWebContentInfo;
+
 declare type WebNotificationInfo = {
     notificationId: string;
     properties: WebNotificationProperties;

package/out/mock-beta.d.ts

@@ -5360,7 +5360,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent | TranslationStateChangedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5844,6 +5844,19 @@ declare type ExternalProcessStartedEvent = BaseEvent_5 & {
     processUuid: string;
 };
 
+/**
+ * Translation status of a translatable WebContents whose translation attempt has failed.
+ */
+declare type FailedTranslationStatus = {
+    status: 'translation-failed';
+    /** The language the page was being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page was being translated to. */
+    targetLanguage: LanguageInfo;
+    /** Human-readable description of why the translation failed. */
+    errorMessage: string;
+};
+
 /**
  * @deprecated, use {@link PageFaviconUpdatedEvent}.
  */
@@ -8174,6 +8187,18 @@ declare type JumpListTask = {
     iconIndex?: number;
 };
 
+/**
+ * Language metadata for content translation.
+ */
+declare type LanguageInfo = {
+    /** ISO language code (e.g. "fr"). */
+    code: string;
+    /** English display name of the language (e.g. "French"). */
+    nameEn: string;
+    /** Localized display name of the language (e.g. "Français"). */
+    nameI18N: string;
+};
+
 /**
  * The LaunchEmitter is an `EventEmitter`. It can listen to app version resolver events.
  *
@@ -10800,6 +10825,14 @@ declare namespace OpenFin_2 {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -10868,6 +10901,16 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Options for {@link OpenFin.WebContents.translatePage}.
+ */
+declare type PageTranslateOptions = {
+    /** BCP-47 language code of the source language, or empty string for auto-detect. */
+    sourceLang: string;
+    /** BCP-47 language code of the target language. */
+    targetLang: string;
+};
+
 /**
  * Reasons for a paste operation being blocked
  *
@@ -13916,6 +13959,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin_2.Identity;
         response: OpenFin_2.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin_2.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin_2.Bounds;
@@ -17410,6 +17459,45 @@ declare type TransitionOptions = {
     tween?: tween;
 };
 
+/**
+ * Describes a WebContents on which content translation is supported.
+ */
+declare type TranslatableWebContentInfo = {
+    /** Whether translation is supported on this WebContents. */
+    translationEnabled: true;
+    /** Detected WebContents language, or undefined if not yet determined. */
+    detectedLanguage?: LanguageInfo;
+    /** Translation status of the WebContents. */
+    state: TranslationStatus;
+};
+
+/**
+ * Translation status of a translatable WebContents that is translated or is being translated.
+ */
+declare type TranslatedPageStatus = {
+    status: 'pending-translation' | 'translated';
+    /** The language the page is being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page is being translated to. */
+    targetLanguage: LanguageInfo;
+};
+
+/**
+ * Generated when the translation state of a WebContents changes, such as when a page in a
+ * foreign language is detected or when a translation completes.
+ * @interface
+ */
+declare type TranslationStateChangedEvent = NamedEvent & {
+    type: 'translation-state-changed';
+} & OpenFin_2.WebContentTranslationInfo;
+
+/**
+ * The translation status of a translatable WebContents.
+ */
+declare type TranslationStatus = {
+    status: 'untranslated';
+} | FailedTranslationStatus | TranslatedPageStatus;
+
 declare class Transport<MeType extends EntityType = EntityType> extends EventEmitter {
     #private;
     protected wireListeners: Map<number, {
@@ -17509,6 +17597,14 @@ declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 
+/**
+ * Describes a WebContents on which content translation is not supported (for example because no
+ * translation API key is configured on the machine, or the current page is not translatable).
+ */
+declare type UntranslatableWebContentInfo = {
+    translationEnabled: false;
+};
+
 /**
  * View options that can be updated after creation.
  *
@@ -18609,6 +18705,26 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level: number): Promise<void>;
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    translatePage(options: OpenFin_2.PageTranslateOptions): Promise<void>;
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    revertTranslation(): Promise<void>;
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    getTranslationState(): Promise<OpenFin_2.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19426,6 +19542,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19434,6 +19551,11 @@ declare namespace WebContentsEvents {
     }
 }
 
+/**
+ * Describes the current content-translation state of a WebContents.
+ */
+declare type WebContentTranslationInfo = UntranslatableWebContentInfo | TranslatableWebContentInfo;
+
 declare type WebNotificationInfo = {
     notificationId: string;
     properties: WebNotificationProperties;

package/out/mock-public.d.ts

@@ -5360,7 +5360,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent | TranslationStateChangedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5844,6 +5844,19 @@ declare type ExternalProcessStartedEvent = BaseEvent_5 & {
     processUuid: string;
 };
 
+/**
+ * Translation status of a translatable WebContents whose translation attempt has failed.
+ */
+declare type FailedTranslationStatus = {
+    status: 'translation-failed';
+    /** The language the page was being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page was being translated to. */
+    targetLanguage: LanguageInfo;
+    /** Human-readable description of why the translation failed. */
+    errorMessage: string;
+};
+
 /**
  * @deprecated, use {@link PageFaviconUpdatedEvent}.
  */
@@ -8174,6 +8187,18 @@ declare type JumpListTask = {
     iconIndex?: number;
 };
 
+/**
+ * Language metadata for content translation.
+ */
+declare type LanguageInfo = {
+    /** ISO language code (e.g. "fr"). */
+    code: string;
+    /** English display name of the language (e.g. "French"). */
+    nameEn: string;
+    /** Localized display name of the language (e.g. "Français"). */
+    nameI18N: string;
+};
+
 /**
  * The LaunchEmitter is an `EventEmitter`. It can listen to app version resolver events.
  *
@@ -10800,6 +10825,14 @@ declare namespace OpenFin_2 {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -10868,6 +10901,16 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Options for {@link OpenFin.WebContents.translatePage}.
+ */
+declare type PageTranslateOptions = {
+    /** BCP-47 language code of the source language, or empty string for auto-detect. */
+    sourceLang: string;
+    /** BCP-47 language code of the target language. */
+    targetLang: string;
+};
+
 /**
  * Reasons for a paste operation being blocked
  *
@@ -13916,6 +13959,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin_2.Identity;
         response: OpenFin_2.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin_2.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin_2.Bounds;
@@ -17410,6 +17459,45 @@ declare type TransitionOptions = {
     tween?: tween;
 };
 
+/**
+ * Describes a WebContents on which content translation is supported.
+ */
+declare type TranslatableWebContentInfo = {
+    /** Whether translation is supported on this WebContents. */
+    translationEnabled: true;
+    /** Detected WebContents language, or undefined if not yet determined. */
+    detectedLanguage?: LanguageInfo;
+    /** Translation status of the WebContents. */
+    state: TranslationStatus;
+};
+
+/**
+ * Translation status of a translatable WebContents that is translated or is being translated.
+ */
+declare type TranslatedPageStatus = {
+    status: 'pending-translation' | 'translated';
+    /** The language the page is being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page is being translated to. */
+    targetLanguage: LanguageInfo;
+};
+
+/**
+ * Generated when the translation state of a WebContents changes, such as when a page in a
+ * foreign language is detected or when a translation completes.
+ * @interface
+ */
+declare type TranslationStateChangedEvent = NamedEvent & {
+    type: 'translation-state-changed';
+} & OpenFin_2.WebContentTranslationInfo;
+
+/**
+ * The translation status of a translatable WebContents.
+ */
+declare type TranslationStatus = {
+    status: 'untranslated';
+} | FailedTranslationStatus | TranslatedPageStatus;
+
 declare class Transport<MeType extends EntityType = EntityType> extends EventEmitter {
     #private;
     protected wireListeners: Map<number, {
@@ -17509,6 +17597,14 @@ declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 
+/**
+ * Describes a WebContents on which content translation is not supported (for example because no
+ * translation API key is configured on the machine, or the current page is not translatable).
+ */
+declare type UntranslatableWebContentInfo = {
+    translationEnabled: false;
+};
+
 /**
  * View options that can be updated after creation.
  *
@@ -18609,6 +18705,26 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level: number): Promise<void>;
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    translatePage(options: OpenFin_2.PageTranslateOptions): Promise<void>;
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    revertTranslation(): Promise<void>;
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    getTranslationState(): Promise<OpenFin_2.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19426,6 +19542,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19434,6 +19551,11 @@ declare namespace WebContentsEvents {
     }
 }
 
+/**
+ * Describes the current content-translation state of a WebContents.
+ */
+declare type WebContentTranslationInfo = UntranslatableWebContentInfo | TranslatableWebContentInfo;
+
 declare type WebNotificationInfo = {
     notificationId: string;
     properties: WebNotificationProperties;

package/out/stub.d.ts

@@ -5424,7 +5424,7 @@ declare type Event_4 = (WebContentsEvents.Event<'view'> & {
  */
 declare type Event_5<Topic extends string> = {
     topic: Topic;
-} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent);
+} & (BlurredEvent | CertificateSelectionShownEvent | CrashedEvent_2 | DidChangeThemeColorEvent | FocusedEvent | NavigationRejectedEvent | UrlChangedEvent | DidFailLoadEvent | DidFinishLoadEvent | DidStartLoadingEvent | PageFaviconUpdatedEvent | PageTitleUpdatedEvent | ResourceLoadFailedEvent | ResourceResponseReceivedEvent | ChildContentBlockedEvent | ChildContentOpenedInBrowserEvent | ChildViewCreatedEvent | ChildWindowCreatedEvent | FileDownloadStartedEvent | FileDownloadProgressEvent | FileDownloadCompletedEvent | FoundInPageEvent | CertificateErrorEvent | ContentBlockedEvent | WillRedirectEvent | ClipboardCopyBlockedEvent | ClipboardPasteBlockedEvent | TranslationStateChangedEvent);
 
 /**
  *  [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by a {@link Window}.  Events are
@@ -5929,6 +5929,19 @@ declare type ExternalProcessStartedEvent = BaseEvent_5 & {
     processUuid: string;
 };
 
+/**
+ * Translation status of a translatable WebContents whose translation attempt has failed.
+ */
+declare type FailedTranslationStatus = {
+    status: 'translation-failed';
+    /** The language the page was being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page was being translated to. */
+    targetLanguage: LanguageInfo;
+    /** Human-readable description of why the translation failed. */
+    errorMessage: string;
+};
+
 /**
  * @deprecated, use {@link PageFaviconUpdatedEvent}.
  */
@@ -8291,6 +8304,18 @@ declare type JumpListTask = {
     iconIndex?: number;
 };
 
+/**
+ * Language metadata for content translation.
+ */
+declare type LanguageInfo = {
+    /** ISO language code (e.g. "fr"). */
+    code: string;
+    /** English display name of the language (e.g. "French"). */
+    nameEn: string;
+    /** Localized display name of the language (e.g. "Français"). */
+    nameI18N: string;
+};
+
 /**
  * The LaunchEmitter is an `EventEmitter`. It can listen to app version resolver events.
  *
@@ -11134,6 +11159,14 @@ declare namespace OpenFin_2 {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11202,6 +11235,16 @@ declare type PageTitleUpdatedEvent = NamedEvent & {
     title: string;
 };
 
+/**
+ * Options for {@link OpenFin.WebContents.translatePage}.
+ */
+declare type PageTranslateOptions = {
+    /** BCP-47 language code of the source language, or empty string for auto-detect. */
+    sourceLang: string;
+    /** BCP-47 language code of the target language. */
+    targetLang: string;
+};
+
 /**
  * Reasons for a paste operation being blocked
  *
@@ -14333,6 +14376,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin_2.Identity;
         response: OpenFin_2.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin_2.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin_2.Bounds;
@@ -17840,6 +17889,45 @@ declare type TransitionOptions = {
     tween?: tween;
 };
 
+/**
+ * Describes a WebContents on which content translation is supported.
+ */
+declare type TranslatableWebContentInfo = {
+    /** Whether translation is supported on this WebContents. */
+    translationEnabled: true;
+    /** Detected WebContents language, or undefined if not yet determined. */
+    detectedLanguage?: LanguageInfo;
+    /** Translation status of the WebContents. */
+    state: TranslationStatus;
+};
+
+/**
+ * Translation status of a translatable WebContents that is translated or is being translated.
+ */
+declare type TranslatedPageStatus = {
+    status: 'pending-translation' | 'translated';
+    /** The language the page is being translated from. */
+    sourceLanguage: LanguageInfo;
+    /** The language the page is being translated to. */
+    targetLanguage: LanguageInfo;
+};
+
+/**
+ * Generated when the translation state of a WebContents changes, such as when a page in a
+ * foreign language is detected or when a translation completes.
+ * @interface
+ */
+declare type TranslationStateChangedEvent = NamedEvent & {
+    type: 'translation-state-changed';
+} & OpenFin_2.WebContentTranslationInfo;
+
+/**
+ * The translation status of a translatable WebContents.
+ */
+declare type TranslationStatus = {
+    status: 'untranslated';
+} | FailedTranslationStatus | TranslatedPageStatus;
+
 declare class Transport<MeType extends EntityType = EntityType> extends EventEmitter {
     #private;
     protected wireListeners: Map<number, {
@@ -17939,6 +18027,14 @@ declare type UnregisteredEvent = BaseEvent_8 & {
     type: 'unregistered';
 };
 
+/**
+ * Describes a WebContents on which content translation is not supported (for example because no
+ * translation API key is configured on the machine, or the current page is not translatable).
+ */
+declare type UntranslatableWebContentInfo = {
+    translationEnabled: false;
+};
+
 /**
  * View options that can be updated after creation.
  *
@@ -19076,6 +19172,26 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      * {@link OpenFin.WebContentsEvents event namespace}.
      */
     setZoomLevel(level: number): Promise<void>;
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    translatePage(options: OpenFin_2.PageTranslateOptions): Promise<void>;
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    revertTranslation(): Promise<void>;
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    getTranslationState(): Promise<OpenFin_2.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19893,6 +20009,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19901,6 +20018,11 @@ declare namespace WebContentsEvents {
     }
 }
 
+/**
+ * Describes the current content-translation state of a WebContents.
+ */
+declare type WebContentTranslationInfo = UntranslatableWebContentInfo | TranslatableWebContentInfo;
+
 declare type WebNotificationInfo = {
     notificationId: string;
     properties: WebNotificationProperties;

package/out/stub.js

@@ -1021,6 +1021,33 @@ class WebContents extends EmitterBase {
     setZoomLevel(level) {
         return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
     }
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    async translatePage(options) {
+        await this.wire.sendAction('translate-page', { ...this.identity, ...options });
+    }
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    async revertTranslation() {
+        await this.wire.sendAction('revert-translation', this.identity);
+    }
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    async getTranslationState() {
+        const { payload } = await this.wire.sendAction('get-translation-state', this.identity);
+        return payload.data;
+    }
     /**
      * Navigates the WebContents to a specified URL.
      *

package/out/stub.mjs

@@ -1017,6 +1017,33 @@ class WebContents extends EmitterBase {
     setZoomLevel(level) {
         return this.wire.sendAction('set-zoom-level', { ...this.identity, level }).then(() => undefined);
     }
+    /**
+     * Translates the WebContents from the source language to the target language.
+     *
+     * Translation requires a translation API key to be configured on the machine. If translation is
+     * unavailable, the call is a no-op and a `translation-state-changed` event is emitted describing
+     * the failure.
+     *
+     * @param options Source and target languages for the translation.
+     */
+    async translatePage(options) {
+        await this.wire.sendAction('translate-page', { ...this.identity, ...options });
+    }
+    /**
+     * Reverts a previously translated WebContents back to its original language.
+     *
+     * If the WebContents is not currently translated, this is a no-op and resolves successfully.
+     */
+    async revertTranslation() {
+        await this.wire.sendAction('revert-translation', this.identity);
+    }
+    /**
+     * Gets the current content-translation state of the WebContents.
+     */
+    async getTranslationState() {
+        const { payload } = await this.wire.sendAction('get-translation-state', this.identity);
+        return payload.data;
+    }
     /**
      * Navigates the WebContents to a specified URL.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/core",
-  "version": "45.100.99",
+  "version": "45.100.101",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",