@openfin/fdc3-api 45.100.99 → 45.100.101

package/out/fdc3-api-alpha.d.ts

@@ -5357,7 +5357,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
@@ -5841,6 +5841,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}.
  */
@@ -8516,6 +8529,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.
  *
@@ -11142,6 +11167,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11208,6 +11241,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
  *
@@ -14256,6 +14299,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin.Identity;
         response: OpenFin.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -17750,6 +17799,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.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, {
@@ -17849,6 +17937,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.
  *
@@ -19055,6 +19151,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.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.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19872,6 +19988,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19880,6 +19997,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/fdc3-api-beta.d.ts

@@ -5357,7 +5357,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
@@ -5841,6 +5841,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}.
  */
@@ -8516,6 +8529,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.
  *
@@ -11142,6 +11167,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11208,6 +11241,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
  *
@@ -14256,6 +14299,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin.Identity;
         response: OpenFin.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -17750,6 +17799,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.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, {
@@ -17849,6 +17937,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.
  *
@@ -19055,6 +19151,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.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.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19872,6 +19988,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19880,6 +19997,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/fdc3-api-public.d.ts

@@ -5357,7 +5357,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
@@ -5841,6 +5841,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}.
  */
@@ -8516,6 +8529,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.
  *
@@ -11142,6 +11167,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11208,6 +11241,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
  *
@@ -14256,6 +14299,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin.Identity;
         response: OpenFin.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -17750,6 +17799,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.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, {
@@ -17849,6 +17937,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.
  *
@@ -19055,6 +19151,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.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.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -19872,6 +19988,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19880,6 +19997,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/fdc3-api.d.ts

@@ -5421,7 +5421,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
@@ -5926,6 +5926,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}.
  */
@@ -8633,6 +8646,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.
  *
@@ -11476,6 +11501,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11542,6 +11575,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
  *
@@ -14673,6 +14716,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: OpenFin.Identity;
         response: OpenFin.ScreenCapturePermission;
     };
+    'translate-page': IdentityCall<{
+        sourceLang: string;
+        targetLang: string;
+    }, void>;
+    'revert-translation': IdentityCall<{}, void>;
+    'get-translation-state': IdentityCall<{}, OpenFin.WebContentTranslationInfo>;
     'render-overlay': {
         request: {
             bounds: OpenFin.Bounds;
@@ -18180,6 +18229,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.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, {
@@ -18279,6 +18367,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.
  *
@@ -19522,6 +19618,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.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.WebContentTranslationInfo>;
     /**
      * Navigates the WebContents to a specified URL.
      *
@@ -20339,6 +20455,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -20347,6 +20464,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/fdc3-api",
-  "version": "45.100.99",
+  "version": "45.100.101",
   "description": "OpenFin fdc3 module utilities and types.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,