@openfin/fdc3-api 46.100.40 → 46.100.42

package/out/fdc3-api-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
@@ -5880,6 +5880,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}.
  */
@@ -6912,7 +6925,7 @@ declare type HostSpecs = {
      */
     aeroGlassEnabled?: boolean;
     /**
-     * "x86" for 32-bit or "x86_64" for 64-bit
+     * "x86_64" for 64-bit
      */
     arch: string;
     /**
@@ -8555,6 +8568,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.
  *
@@ -11171,6 +11196,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11237,6 +11270,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
  *
@@ -14285,6 +14328,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;
@@ -17778,6 +17827,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, {
@@ -17877,6 +17965,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.
  *
@@ -19083,6 +19179,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.
      *
@@ -19901,6 +20017,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19909,6 +20026,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

@@ -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
@@ -5880,6 +5880,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}.
  */
@@ -6912,7 +6925,7 @@ declare type HostSpecs = {
      */
     aeroGlassEnabled?: boolean;
     /**
-     * "x86" for 32-bit or "x86_64" for 64-bit
+     * "x86_64" for 64-bit
      */
     arch: string;
     /**
@@ -8555,6 +8568,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.
  *
@@ -11171,6 +11196,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11237,6 +11270,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
  *
@@ -14285,6 +14328,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;
@@ -17778,6 +17827,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, {
@@ -17877,6 +17965,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.
  *
@@ -19083,6 +19179,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.
      *
@@ -19901,6 +20017,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19909,6 +20026,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

@@ -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
@@ -5880,6 +5880,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}.
  */
@@ -6912,7 +6925,7 @@ declare type HostSpecs = {
      */
     aeroGlassEnabled?: boolean;
     /**
-     * "x86" for 32-bit or "x86_64" for 64-bit
+     * "x86_64" for 64-bit
      */
     arch: string;
     /**
@@ -8555,6 +8568,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.
  *
@@ -11171,6 +11196,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11237,6 +11270,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
  *
@@ -14285,6 +14328,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;
@@ -17778,6 +17827,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, {
@@ -17877,6 +17965,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.
  *
@@ -19083,6 +19179,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.
      *
@@ -19901,6 +20017,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -19909,6 +20026,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

@@ -5467,7 +5467,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
@@ -6008,6 +6008,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}.
  */
@@ -7052,7 +7065,7 @@ declare type HostSpecs = {
      */
     aeroGlassEnabled?: boolean;
     /**
-     * "x86" for 32-bit or "x86_64" for 64-bit
+     * "x86_64" for 64-bit
      */
     arch: string;
     /**
@@ -8721,6 +8734,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.
  *
@@ -11554,6 +11579,14 @@ declare namespace OpenFin {
         ClientChangedContextGroup,
         InteropClientEvents,
         ChromeBrowser,
+        LanguageInfo,
+        PageTranslateOptions,
+        FailedTranslationStatus,
+        TranslatedPageStatus,
+        TranslationStatus,
+        UntranslatableWebContentInfo,
+        TranslatableWebContentInfo,
+        WebContentTranslationInfo,
         ApplicationEvents,
         BaseEvents,
         ExternalApplicationEvents,
@@ -11620,6 +11653,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
  *
@@ -14751,6 +14794,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;
@@ -18257,6 +18306,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, {
@@ -18356,6 +18444,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.
  *
@@ -19599,6 +19695,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.
      *
@@ -20417,6 +20533,7 @@ declare namespace WebContentsEvents {
         ContentBlockedEvent,
         ClipboardCopyBlockedEvent,
         ClipboardPasteBlockedEvent,
+        TranslationStateChangedEvent,
         Event_5 as Event,
         WebContentsEvent,
         WillPropagateWebContentsEvent,
@@ -20425,6 +20542,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": "46.100.40",
+  "version": "46.100.42",
   "description": "OpenFin fdc3 module utilities and types.",
   "license": "SEE LICENSE IN LICENSE.md",
   "private": false,