@openfin/remote-adapter 36.79.19 → 36.80.2

package/out/remote-adapter-alpha.d.ts

@@ -76,14 +76,42 @@ declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-rig
 
 declare type AnyStrategy = ClassicStrategy | RTCStrategy | CombinedStrategy<PayloadTypeByStrategy<RTCStrategy>, PayloadTypeByStrategy<ClassicStrategy>>;
 
+/**
+ * @deprecated Renamed to {@link ApiSettings}.
+ */
+declare type Api = ApiSettings;
+
+declare type ApiCall<Request, Response> = {
+    request: Request;
+    response: Response;
+};
+
+declare type ApiClient<T extends Record<any, any>> = {
+    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
+};
+
+/**
+ * @deprecated Renamed to {@link DomainApiSettings}.
+ */
+declare type ApiInjection = DomainApiSettings;
+
+/**
+ * Generated when a new Platform's API becomes responsive.
+ * @interface
+ */
+declare type ApiReadyEvent = BaseEvent & {
+    topic: 'application';
+    type: 'platform-api-ready';
+};
+
 /**
  * Configurations for API injection.
  *
  * @interface
  */
-declare type Api = {
+declare type ApiSettings = {
     /**
-     * Configure injection of OpenFin API into iframes based on domain
+     * Configure conditional injection of OpenFin API into iframes
      */
     iframe?: {
         /**
@@ -114,41 +142,6 @@ declare type Api = {
     fin?: InjectionType;
 };
 
-declare type ApiCall<Request, Response> = {
-    request: Request;
-    response: Response;
-};
-
-declare type ApiClient<T extends Record<any, any>> = {
-    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
-};
-
-/**
- * @interface
- *
- * Rules for domain-conditional `fin` API injection.
- */
-declare type ApiInjection = {
-    /**
-     * Injection setting for the `fin` API for contexts on a matched domain.
-     *
-     * * 'none': The `fin` API will be not available.
-     * * 'global': The entire `fin` API will be available.
-     *
-     * @defaultValue 'global'
-     */
-    fin: InjectionType;
-};
-
-/**
- * Generated when a new Platform's API becomes responsive.
- * @interface
- */
-declare type ApiReadyEvent = BaseEvent & {
-    topic: 'application';
-    type: 'platform-api-ready';
-};
-
 /**
  * @interface
  */
@@ -966,7 +959,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions;
+    initialOptions: ApplicationCreationOptions | PlatformOptions;
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3546,7 +3539,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3863,6 +3856,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -3962,7 +3959,12 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
-declare type ContentCreationBehaviorNames = 'window' | 'view' | 'block' | 'browser';
+declare type ContentCreationBehavior = 'window' | 'view' | 'block' | 'browser';
+
+/**
+ * @deprecated Renamed to {@link ContentCreationBehavior}.
+ */
+declare type ContentCreationBehaviorNames = ContentCreationBehavior;
 
 /**
  * Configures how new content (e,g, from `window.open` or a link) is opened.
@@ -3986,7 +3988,7 @@ declare type ContentCreationOptions = {
  * @typeParam Behavior The way content governed by this rule will be created.  If provided, this type will narrow to
  * the specified `behavior` key.
  */
-declare type ContentCreationRule<Behavior extends ContentCreationBehaviorNames = ContentCreationBehaviorNames> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
+declare type ContentCreationRule<Behavior extends ContentCreationBehavior = ContentCreationBehavior> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
     behavior: Behavior;
 }>;
 
@@ -4871,6 +4873,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ *
+ * Rules for domain-conditional `fin` API injection.
+ *
+ * @remarks Subset of {@link DomainSettings}.
+ */
+declare type DomainApiSettings = {
+    /**
+     * Injection setting for the `fin` API for contexts on a matched domain.
+     *
+     * * 'none': The `fin` API will be not available.
+     * * 'global': The entire `fin` API will be available.
+     *
+     * @defaultValue 'global'
+     */
+    fin: InjectionType;
+};
+
 /**
  * @interface
  * Defines application settings that vary by the domain of the current context.
@@ -4909,7 +4930,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4948,18 +4969,19 @@ declare type DownloadPreloadOption = {
 /**
  * @interface
  *
- * A rule governing domain-conditional download behavior.
+ * A rule that governs download behavior, discriminated by the URL of the download.
  */
 declare type DownloadRule = {
     /**
-     * {@inheritDoc FileDownloadBehaviorNames}
+     * {@inheritDoc FileDownloadBehavior}
      */
-    behavior: FileDownloadBehaviorNames;
+    behavior: FileDownloadBehavior;
     /**
      * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
-     * the domain(s) for which the rule applies.
+     * URL(s) of the resource(s) being downloaded.
      *
-     * @remarks The match is evaluated against the URL of the *download*.
+     * @remarks The match is evaluated against the URL of the *file*, which is not necessarily the same as that
+     * of the page in which a file download link is embedded.
      */
     match: string[];
 };
@@ -5665,7 +5687,12 @@ declare type FetchManifestPayload = {
 /**
  * Whether file downloads raise a user prompt.
  */
-declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
+declare type FileDownloadBehavior = 'prompt' | 'no-prompt';
+
+/**
+ * @deprecated Renamed to {@link FileDownloadBehavior}.
+ */
+declare type FileDownloadBehaviorNames = FileDownloadBehavior;
 
 /**
  * Generated when a file download has completed.
@@ -5915,6 +5942,8 @@ declare class _Frame extends EmitterBase<OpenFin.FrameEvent> {
      * Returns a frame info object representing the window that the referenced iframe is
      * currently embedded in.
      *
+     * @remarks If the frame is embedded in a view, this will return an invalid stub with empty fields.
+     *
      * @example
      * ```js
      * async function getParentWindow() {
@@ -6760,6 +6789,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Initialize a remote connection as a "host" application.
  * @param {InitOptions} options init options
@@ -8382,6 +8418,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9559,7 +9596,7 @@ declare type MutableViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * Restrict navigation to URLs that match an allowed pattern.
      * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
@@ -10012,6 +10049,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10020,6 +10058,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10171,7 +10210,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10179,6 +10220,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11247,6 +11289,14 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
+    /**
+     * @defaultValue true
+     *
+     * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
+     *
+     * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
+     */
+    allowLaunchIntoPlatform?: boolean;
 };
 
 /**
@@ -12006,7 +12056,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12023,7 +12073,7 @@ declare type PreloadScriptsStateChangeEvent = BaseEvent_5 & {
  * @interface
  */
 declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changing';
+    type: 'preload-scripts-state-changing';
 };
 
 declare type PresetLayoutOptions = OpenFin.PresetLayoutOptions;

package/out/remote-adapter-beta.d.ts

@@ -76,14 +76,42 @@ declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-rig
 
 declare type AnyStrategy = ClassicStrategy | RTCStrategy | CombinedStrategy<PayloadTypeByStrategy<RTCStrategy>, PayloadTypeByStrategy<ClassicStrategy>>;
 
+/**
+ * @deprecated Renamed to {@link ApiSettings}.
+ */
+declare type Api = ApiSettings;
+
+declare type ApiCall<Request, Response> = {
+    request: Request;
+    response: Response;
+};
+
+declare type ApiClient<T extends Record<any, any>> = {
+    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
+};
+
+/**
+ * @deprecated Renamed to {@link DomainApiSettings}.
+ */
+declare type ApiInjection = DomainApiSettings;
+
+/**
+ * Generated when a new Platform's API becomes responsive.
+ * @interface
+ */
+declare type ApiReadyEvent = BaseEvent & {
+    topic: 'application';
+    type: 'platform-api-ready';
+};
+
 /**
  * Configurations for API injection.
  *
  * @interface
  */
-declare type Api = {
+declare type ApiSettings = {
     /**
-     * Configure injection of OpenFin API into iframes based on domain
+     * Configure conditional injection of OpenFin API into iframes
      */
     iframe?: {
         /**
@@ -114,41 +142,6 @@ declare type Api = {
     fin?: InjectionType;
 };
 
-declare type ApiCall<Request, Response> = {
-    request: Request;
-    response: Response;
-};
-
-declare type ApiClient<T extends Record<any, any>> = {
-    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
-};
-
-/**
- * @interface
- *
- * Rules for domain-conditional `fin` API injection.
- */
-declare type ApiInjection = {
-    /**
-     * Injection setting for the `fin` API for contexts on a matched domain.
-     *
-     * * 'none': The `fin` API will be not available.
-     * * 'global': The entire `fin` API will be available.
-     *
-     * @defaultValue 'global'
-     */
-    fin: InjectionType;
-};
-
-/**
- * Generated when a new Platform's API becomes responsive.
- * @interface
- */
-declare type ApiReadyEvent = BaseEvent & {
-    topic: 'application';
-    type: 'platform-api-ready';
-};
-
 /**
  * @interface
  */
@@ -966,7 +959,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions;
+    initialOptions: ApplicationCreationOptions | PlatformOptions;
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3546,7 +3539,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3863,6 +3856,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -3962,7 +3959,12 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
-declare type ContentCreationBehaviorNames = 'window' | 'view' | 'block' | 'browser';
+declare type ContentCreationBehavior = 'window' | 'view' | 'block' | 'browser';
+
+/**
+ * @deprecated Renamed to {@link ContentCreationBehavior}.
+ */
+declare type ContentCreationBehaviorNames = ContentCreationBehavior;
 
 /**
  * Configures how new content (e,g, from `window.open` or a link) is opened.
@@ -3986,7 +3988,7 @@ declare type ContentCreationOptions = {
  * @typeParam Behavior The way content governed by this rule will be created.  If provided, this type will narrow to
  * the specified `behavior` key.
  */
-declare type ContentCreationRule<Behavior extends ContentCreationBehaviorNames = ContentCreationBehaviorNames> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
+declare type ContentCreationRule<Behavior extends ContentCreationBehavior = ContentCreationBehavior> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
     behavior: Behavior;
 }>;
 
@@ -4871,6 +4873,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ *
+ * Rules for domain-conditional `fin` API injection.
+ *
+ * @remarks Subset of {@link DomainSettings}.
+ */
+declare type DomainApiSettings = {
+    /**
+     * Injection setting for the `fin` API for contexts on a matched domain.
+     *
+     * * 'none': The `fin` API will be not available.
+     * * 'global': The entire `fin` API will be available.
+     *
+     * @defaultValue 'global'
+     */
+    fin: InjectionType;
+};
+
 /**
  * @interface
  * Defines application settings that vary by the domain of the current context.
@@ -4909,7 +4930,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4948,18 +4969,19 @@ declare type DownloadPreloadOption = {
 /**
  * @interface
  *
- * A rule governing domain-conditional download behavior.
+ * A rule that governs download behavior, discriminated by the URL of the download.
  */
 declare type DownloadRule = {
     /**
-     * {@inheritDoc FileDownloadBehaviorNames}
+     * {@inheritDoc FileDownloadBehavior}
      */
-    behavior: FileDownloadBehaviorNames;
+    behavior: FileDownloadBehavior;
     /**
      * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
-     * the domain(s) for which the rule applies.
+     * URL(s) of the resource(s) being downloaded.
      *
-     * @remarks The match is evaluated against the URL of the *download*.
+     * @remarks The match is evaluated against the URL of the *file*, which is not necessarily the same as that
+     * of the page in which a file download link is embedded.
      */
     match: string[];
 };
@@ -5665,7 +5687,12 @@ declare type FetchManifestPayload = {
 /**
  * Whether file downloads raise a user prompt.
  */
-declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
+declare type FileDownloadBehavior = 'prompt' | 'no-prompt';
+
+/**
+ * @deprecated Renamed to {@link FileDownloadBehavior}.
+ */
+declare type FileDownloadBehaviorNames = FileDownloadBehavior;
 
 /**
  * Generated when a file download has completed.
@@ -5915,6 +5942,8 @@ declare class _Frame extends EmitterBase<OpenFin.FrameEvent> {
      * Returns a frame info object representing the window that the referenced iframe is
      * currently embedded in.
      *
+     * @remarks If the frame is embedded in a view, this will return an invalid stub with empty fields.
+     *
      * @example
      * ```js
      * async function getParentWindow() {
@@ -6760,6 +6789,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Initialize a remote connection as a "host" application.
  * @param {InitOptions} options init options
@@ -8382,6 +8418,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9559,7 +9596,7 @@ declare type MutableViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * Restrict navigation to URLs that match an allowed pattern.
      * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
@@ -10012,6 +10049,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10020,6 +10058,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10171,7 +10210,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10179,6 +10220,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11247,6 +11289,14 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
+    /**
+     * @defaultValue true
+     *
+     * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
+     *
+     * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
+     */
+    allowLaunchIntoPlatform?: boolean;
 };
 
 /**
@@ -12006,7 +12056,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12023,7 +12073,7 @@ declare type PreloadScriptsStateChangeEvent = BaseEvent_5 & {
  * @interface
  */
 declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changing';
+    type: 'preload-scripts-state-changing';
 };
 
 declare type PresetLayoutOptions = OpenFin.PresetLayoutOptions;

package/out/remote-adapter-public.d.ts

@@ -76,14 +76,42 @@ declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-rig
 
 declare type AnyStrategy = ClassicStrategy | RTCStrategy | CombinedStrategy<PayloadTypeByStrategy<RTCStrategy>, PayloadTypeByStrategy<ClassicStrategy>>;
 
+/**
+ * @deprecated Renamed to {@link ApiSettings}.
+ */
+declare type Api = ApiSettings;
+
+declare type ApiCall<Request, Response> = {
+    request: Request;
+    response: Response;
+};
+
+declare type ApiClient<T extends Record<any, any>> = {
+    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
+};
+
+/**
+ * @deprecated Renamed to {@link DomainApiSettings}.
+ */
+declare type ApiInjection = DomainApiSettings;
+
+/**
+ * Generated when a new Platform's API becomes responsive.
+ * @interface
+ */
+declare type ApiReadyEvent = BaseEvent & {
+    topic: 'application';
+    type: 'platform-api-ready';
+};
+
 /**
  * Configurations for API injection.
  *
  * @interface
  */
-declare type Api = {
+declare type ApiSettings = {
     /**
-     * Configure injection of OpenFin API into iframes based on domain
+     * Configure conditional injection of OpenFin API into iframes
      */
     iframe?: {
         /**
@@ -114,41 +142,6 @@ declare type Api = {
     fin?: InjectionType;
 };
 
-declare type ApiCall<Request, Response> = {
-    request: Request;
-    response: Response;
-};
-
-declare type ApiClient<T extends Record<any, any>> = {
-    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
-};
-
-/**
- * @interface
- *
- * Rules for domain-conditional `fin` API injection.
- */
-declare type ApiInjection = {
-    /**
-     * Injection setting for the `fin` API for contexts on a matched domain.
-     *
-     * * 'none': The `fin` API will be not available.
-     * * 'global': The entire `fin` API will be available.
-     *
-     * @defaultValue 'global'
-     */
-    fin: InjectionType;
-};
-
-/**
- * Generated when a new Platform's API becomes responsive.
- * @interface
- */
-declare type ApiReadyEvent = BaseEvent & {
-    topic: 'application';
-    type: 'platform-api-ready';
-};
-
 /**
  * @interface
  */
@@ -966,7 +959,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions;
+    initialOptions: ApplicationCreationOptions | PlatformOptions;
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3546,7 +3539,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3863,6 +3856,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -3962,7 +3959,12 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
-declare type ContentCreationBehaviorNames = 'window' | 'view' | 'block' | 'browser';
+declare type ContentCreationBehavior = 'window' | 'view' | 'block' | 'browser';
+
+/**
+ * @deprecated Renamed to {@link ContentCreationBehavior}.
+ */
+declare type ContentCreationBehaviorNames = ContentCreationBehavior;
 
 /**
  * Configures how new content (e,g, from `window.open` or a link) is opened.
@@ -3986,7 +3988,7 @@ declare type ContentCreationOptions = {
  * @typeParam Behavior The way content governed by this rule will be created.  If provided, this type will narrow to
  * the specified `behavior` key.
  */
-declare type ContentCreationRule<Behavior extends ContentCreationBehaviorNames = ContentCreationBehaviorNames> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
+declare type ContentCreationRule<Behavior extends ContentCreationBehavior = ContentCreationBehavior> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
     behavior: Behavior;
 }>;
 
@@ -4871,6 +4873,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ *
+ * Rules for domain-conditional `fin` API injection.
+ *
+ * @remarks Subset of {@link DomainSettings}.
+ */
+declare type DomainApiSettings = {
+    /**
+     * Injection setting for the `fin` API for contexts on a matched domain.
+     *
+     * * 'none': The `fin` API will be not available.
+     * * 'global': The entire `fin` API will be available.
+     *
+     * @defaultValue 'global'
+     */
+    fin: InjectionType;
+};
+
 /**
  * @interface
  * Defines application settings that vary by the domain of the current context.
@@ -4909,7 +4930,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4948,18 +4969,19 @@ declare type DownloadPreloadOption = {
 /**
  * @interface
  *
- * A rule governing domain-conditional download behavior.
+ * A rule that governs download behavior, discriminated by the URL of the download.
  */
 declare type DownloadRule = {
     /**
-     * {@inheritDoc FileDownloadBehaviorNames}
+     * {@inheritDoc FileDownloadBehavior}
      */
-    behavior: FileDownloadBehaviorNames;
+    behavior: FileDownloadBehavior;
     /**
      * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
-     * the domain(s) for which the rule applies.
+     * URL(s) of the resource(s) being downloaded.
      *
-     * @remarks The match is evaluated against the URL of the *download*.
+     * @remarks The match is evaluated against the URL of the *file*, which is not necessarily the same as that
+     * of the page in which a file download link is embedded.
      */
     match: string[];
 };
@@ -5665,7 +5687,12 @@ declare type FetchManifestPayload = {
 /**
  * Whether file downloads raise a user prompt.
  */
-declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
+declare type FileDownloadBehavior = 'prompt' | 'no-prompt';
+
+/**
+ * @deprecated Renamed to {@link FileDownloadBehavior}.
+ */
+declare type FileDownloadBehaviorNames = FileDownloadBehavior;
 
 /**
  * Generated when a file download has completed.
@@ -5915,6 +5942,8 @@ declare class _Frame extends EmitterBase<OpenFin.FrameEvent> {
      * Returns a frame info object representing the window that the referenced iframe is
      * currently embedded in.
      *
+     * @remarks If the frame is embedded in a view, this will return an invalid stub with empty fields.
+     *
      * @example
      * ```js
      * async function getParentWindow() {
@@ -6760,6 +6789,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Initialize a remote connection as a "host" application.
  * @param {InitOptions} options init options
@@ -8382,6 +8418,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9559,7 +9596,7 @@ declare type MutableViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * Restrict navigation to URLs that match an allowed pattern.
      * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
@@ -10012,6 +10049,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10020,6 +10058,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10171,7 +10210,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10179,6 +10220,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11247,6 +11289,14 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
+    /**
+     * @defaultValue true
+     *
+     * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
+     *
+     * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
+     */
+    allowLaunchIntoPlatform?: boolean;
 };
 
 /**
@@ -12006,7 +12056,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12023,7 +12073,7 @@ declare type PreloadScriptsStateChangeEvent = BaseEvent_5 & {
  * @interface
  */
 declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changing';
+    type: 'preload-scripts-state-changing';
 };
 
 declare type PresetLayoutOptions = OpenFin.PresetLayoutOptions;

package/out/remote-adapter.d.ts

@@ -76,14 +76,42 @@ declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-rig
 
 declare type AnyStrategy = ClassicStrategy | RTCStrategy | CombinedStrategy<PayloadTypeByStrategy<RTCStrategy>, PayloadTypeByStrategy<ClassicStrategy>>;
 
+/**
+ * @deprecated Renamed to {@link ApiSettings}.
+ */
+declare type Api = ApiSettings;
+
+declare type ApiCall<Request, Response> = {
+    request: Request;
+    response: Response;
+};
+
+declare type ApiClient<T extends Record<any, any>> = {
+    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
+};
+
+/**
+ * @deprecated Renamed to {@link DomainApiSettings}.
+ */
+declare type ApiInjection = DomainApiSettings;
+
+/**
+ * Generated when a new Platform's API becomes responsive.
+ * @interface
+ */
+declare type ApiReadyEvent = BaseEvent & {
+    topic: 'application';
+    type: 'platform-api-ready';
+};
+
 /**
  * Configurations for API injection.
  *
  * @interface
  */
-declare type Api = {
+declare type ApiSettings = {
     /**
-     * Configure injection of OpenFin API into iframes based on domain
+     * Configure conditional injection of OpenFin API into iframes
      */
     iframe?: {
         /**
@@ -114,41 +142,6 @@ declare type Api = {
     fin?: InjectionType;
 };
 
-declare type ApiCall<Request, Response> = {
-    request: Request;
-    response: Response;
-};
-
-declare type ApiClient<T extends Record<any, any>> = {
-    [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
-};
-
-/**
- * @interface
- *
- * Rules for domain-conditional `fin` API injection.
- */
-declare type ApiInjection = {
-    /**
-     * Injection setting for the `fin` API for contexts on a matched domain.
-     *
-     * * 'none': The `fin` API will be not available.
-     * * 'global': The entire `fin` API will be available.
-     *
-     * @defaultValue 'global'
-     */
-    fin: InjectionType;
-};
-
-/**
- * Generated when a new Platform's API becomes responsive.
- * @interface
- */
-declare type ApiReadyEvent = BaseEvent & {
-    topic: 'application';
-    type: 'platform-api-ready';
-};
-
 /**
  * @interface
  */
@@ -972,7 +965,7 @@ declare type ApplicationIdentity_2 = {
  * @interface
  */
 declare type ApplicationInfo = {
-    initialOptions: ApplicationCreationOptions;
+    initialOptions: ApplicationCreationOptions | PlatformOptions;
     launchMode: string;
     manifest: Manifest & {
         [key: string]: any;
@@ -3601,7 +3594,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3918,6 +3911,10 @@ declare type ConstWindowOptions = {
      * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
      */
     viewVisibility?: ViewVisibilityOptions;
+    /**
+     * Controls whether an option is inherited from the parent application. The option is set as part of the window options for the parent application in either the {@link Manifest.startup_app} or {@link Manifest.platform} properties in the manifest or in {@link ApplicationOptions.mainWindowOptions} when calling {@link Application.ApplicationModule.start Application.start}. Use { [option]: false } to disable a specific [option]. All inheritable properties will be inherited by default if omitted.
+     */
+    inheritance?: Partial<InheritableOptions>;
 };
 
 declare interface Container extends EventEmitter_2 {
@@ -4017,7 +4014,12 @@ declare interface Container extends EventEmitter_2 {
     close(): boolean;
 }
 
-declare type ContentCreationBehaviorNames = 'window' | 'view' | 'block' | 'browser';
+declare type ContentCreationBehavior = 'window' | 'view' | 'block' | 'browser';
+
+/**
+ * @deprecated Renamed to {@link ContentCreationBehavior}.
+ */
+declare type ContentCreationBehaviorNames = ContentCreationBehavior;
 
 /**
  * Configures how new content (e,g, from `window.open` or a link) is opened.
@@ -4041,7 +4043,7 @@ declare type ContentCreationOptions = {
  * @typeParam Behavior The way content governed by this rule will be created.  If provided, this type will narrow to
  * the specified `behavior` key.
  */
-declare type ContentCreationRule<Behavior extends ContentCreationBehaviorNames = ContentCreationBehaviorNames> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
+declare type ContentCreationRule<Behavior extends ContentCreationBehavior = ContentCreationBehavior> = Extract<WindowContentCreationRule | ViewContentCreationRule | BrowserContentCreationRule | BlockedContentCreationRule, {
     behavior: Behavior;
 }>;
 
@@ -4926,6 +4928,25 @@ declare type DisplayMetadata_3 = {
     readonly glyph?: string;
 };
 
+/**
+ * @interface
+ *
+ * Rules for domain-conditional `fin` API injection.
+ *
+ * @remarks Subset of {@link DomainSettings}.
+ */
+declare type DomainApiSettings = {
+    /**
+     * Injection setting for the `fin` API for contexts on a matched domain.
+     *
+     * * 'none': The `fin` API will be not available.
+     * * 'global': The entire `fin` API will be available.
+     *
+     * @defaultValue 'global'
+     */
+    fin: InjectionType;
+};
+
 /**
  * @interface
  * Defines application settings that vary by the domain of the current context.
@@ -4964,7 +4985,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -5003,18 +5024,19 @@ declare type DownloadPreloadOption = {
 /**
  * @interface
  *
- * A rule governing domain-conditional download behavior.
+ * A rule that governs download behavior, discriminated by the URL of the download.
  */
 declare type DownloadRule = {
     /**
-     * {@inheritDoc FileDownloadBehaviorNames}
+     * {@inheritDoc FileDownloadBehavior}
      */
-    behavior: FileDownloadBehaviorNames;
+    behavior: FileDownloadBehavior;
     /**
      * Array of [match patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns) specifying
-     * the domain(s) for which the rule applies.
+     * URL(s) of the resource(s) being downloaded.
      *
-     * @remarks The match is evaluated against the URL of the *download*.
+     * @remarks The match is evaluated against the URL of the *file*, which is not necessarily the same as that
+     * of the page in which a file download link is embedded.
      */
     match: string[];
 };
@@ -5746,7 +5768,12 @@ declare type FetchManifestPayload = {
 /**
  * Whether file downloads raise a user prompt.
  */
-declare type FileDownloadBehaviorNames = 'prompt' | 'no-prompt';
+declare type FileDownloadBehavior = 'prompt' | 'no-prompt';
+
+/**
+ * @deprecated Renamed to {@link FileDownloadBehavior}.
+ */
+declare type FileDownloadBehaviorNames = FileDownloadBehavior;
 
 /**
  * Generated when a file download has completed.
@@ -5999,6 +6026,8 @@ declare class _Frame extends EmitterBase<OpenFin.FrameEvent> {
      * Returns a frame info object representing the window that the referenced iframe is
      * currently embedded in.
      *
+     * @remarks If the frame is embedded in a view, this will return an invalid stub with empty fields.
+     *
      * @example
      * ```js
      * async function getParentWindow() {
@@ -6850,6 +6879,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Initialize a remote connection as a "host" application.
  * @param {InitOptions} options init options
@@ -8495,6 +8531,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9848,7 +9885,7 @@ declare type MutableViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * Restrict navigation to URLs that match an allowed pattern.
      * In the lack of an allowlist, navigation to URLs that match a denylisted pattern would be prohibited.
@@ -10323,6 +10360,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10331,6 +10369,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10482,7 +10521,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10490,6 +10531,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11591,6 +11633,14 @@ declare type PlatformOptions = ApplicationCreationOptions & {
      * The provider url.
      */
     providerUrl?: string;
+    /**
+     * @defaultValue true
+     *
+     * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
+     *
+     * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
+     */
+    allowLaunchIntoPlatform?: boolean;
 };
 
 /**
@@ -12395,7 +12445,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12412,7 +12462,7 @@ declare type PreloadScriptsStateChangeEvent = BaseEvent_5 & {
  * @interface
  */
 declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changing';
+    type: 'preload-scripts-state-changing';
 };
 
 declare type PresetLayoutOptions = OpenFin.PresetLayoutOptions;

package/out/remote-adapter.js

@@ -8530,6 +8530,8 @@ class _Frame extends base_1$h.EmitterBase {
      * Returns a frame info object representing the window that the referenced iframe is
      * currently embedded in.
      *
+     * @remarks If the frame is embedded in a view, this will return an invalid stub with empty fields.
+     *
      * @example
      * ```js
      * async function getParentWindow() {
@@ -14471,12 +14473,12 @@ class Platform extends base_1$5.EmitterBase {
      * @experimental
      */
     async launchContentManifest(manifestUrl) {
-        this.wire.sendAction('platform-launch-content-manifest', this.identity).catch((e) => {
+        this.wire.sendAction('platform-launch-content-manifest', this.identity).catch(() => {
             // don't expose
         });
         const client = await this.getClient();
         const manifest = await this.fetchManifest(manifestUrl);
-        client.dispatch('launch-into-platform', { manifest });
+        client.dispatch('launch-into-platform', { manifest, manifestUrl });
         return this;
     }
     /**
@@ -15119,7 +15121,7 @@ class LayoutModule extends base_1$3.Base {
             return this.wrapSync(this.fin.me.identity);
         };
         _LayoutModule_getLayoutManagerSpy.set(this, (layoutIdentity, layoutManager) => {
-            const msg = '[Layout] You are using a deprecated property `layoutManager` - it will be removed in v39.';
+            const msg = '[Layout] You are using a deprecated property `layoutManager` - it will throw if you access it starting in v37.';
             const managerProxy = new Proxy(layoutManager, {
                 get(target, key) {
                     console.warn(`[Layout-mgr-proxy] accessing ${key.toString()}`);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/remote-adapter",
-    "version": "36.79.19",
+    "version": "36.80.2",
     "description": "Establish intermachine runtime connections using webRTC.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,