@openfin/core 36.79.19 → 36.80.2

package/out/mock-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;
@@ -3522,7 +3515,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3839,6 +3832,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 {
@@ -3938,7 +3935,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.
@@ -3962,7 +3964,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;
 }>;
 
@@ -4847,6 +4849,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.
@@ -4885,7 +4906,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4924,18 +4945,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[];
 };
@@ -5641,7 +5663,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.
@@ -5893,6 +5920,8 @@ declare class _Frame extends EmitterBase<OpenFin_2.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() {
@@ -6738,6 +6767,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -8339,6 +8375,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9516,7 +9553,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.
@@ -9969,6 +10006,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10015,7 @@ declare namespace OpenFin_2 {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10128,7 +10167,9 @@ declare namespace OpenFin_2 {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10136,6 +10177,7 @@ declare namespace OpenFin_2 {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11205,6 +11247,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;
 };
 
 /**
@@ -11964,7 +12014,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -11981,7 +12031,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_2.PresetLayoutOptions;

package/out/mock-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;
@@ -3522,7 +3515,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3839,6 +3832,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 {
@@ -3938,7 +3935,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.
@@ -3962,7 +3964,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;
 }>;
 
@@ -4847,6 +4849,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.
@@ -4885,7 +4906,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4924,18 +4945,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[];
 };
@@ -5641,7 +5663,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.
@@ -5893,6 +5920,8 @@ declare class _Frame extends EmitterBase<OpenFin_2.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() {
@@ -6738,6 +6767,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -8339,6 +8375,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9516,7 +9553,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.
@@ -9969,6 +10006,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10015,7 @@ declare namespace OpenFin_2 {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10128,7 +10167,9 @@ declare namespace OpenFin_2 {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10136,6 +10177,7 @@ declare namespace OpenFin_2 {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11205,6 +11247,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;
 };
 
 /**
@@ -11964,7 +12014,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -11981,7 +12031,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_2.PresetLayoutOptions;

package/out/mock-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;
@@ -3522,7 +3515,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3839,6 +3832,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 {
@@ -3938,7 +3935,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.
@@ -3962,7 +3964,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;
 }>;
 
@@ -4847,6 +4849,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.
@@ -4885,7 +4906,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4924,18 +4945,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[];
 };
@@ -5641,7 +5663,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.
@@ -5893,6 +5920,8 @@ declare class _Frame extends EmitterBase<OpenFin_2.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() {
@@ -6738,6 +6767,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -8339,6 +8375,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9516,7 +9553,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.
@@ -9969,6 +10006,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -9977,6 +10015,7 @@ declare namespace OpenFin_2 {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10128,7 +10167,9 @@ declare namespace OpenFin_2 {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10136,6 +10177,7 @@ declare namespace OpenFin_2 {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11205,6 +11247,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;
 };
 
 /**
@@ -11964,7 +12014,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -11981,7 +12031,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_2.PresetLayoutOptions;

package/out/mock.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;
@@ -3577,7 +3570,7 @@ declare type ConstViewOptions = {
     /**
      * Configurations for API injection.
      */
-    api: Api;
+    api: ApiSettings;
     /**
      * The name of the view.
      */
@@ -3894,6 +3887,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 {
@@ -3993,7 +3990,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.
@@ -4017,7 +4019,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;
 }>;
 
@@ -4902,6 +4904,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.
@@ -4940,7 +4961,7 @@ declare type DomainSettingsRule = {
         /**
          * {@inheritDoc ApiInjection}
          */
-        api?: ApiInjection;
+        api?: DomainApiSettings;
     };
 };
 
@@ -4979,18 +5000,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[];
 };
@@ -5722,7 +5744,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.
@@ -5977,6 +6004,8 @@ declare class _Frame extends EmitterBase<OpenFin_2.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() {
@@ -6828,6 +6857,13 @@ declare type InfoForIntentOptions<MetadataType = IntentMetadata_3> = {
     metadata?: MetadataType;
 };
 
+declare type InheritableOptions = {
+    customContext: boolean;
+    customData: boolean;
+    icon: boolean;
+    preloadScripts: boolean;
+};
+
 /**
  * Generated when an application has initialized.
  * @interface
@@ -8452,6 +8488,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9805,7 +9842,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.
@@ -10280,6 +10317,7 @@ declare namespace OpenFin_2 {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10288,6 +10326,7 @@ declare namespace OpenFin_2 {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10439,7 +10478,9 @@ declare namespace OpenFin_2 {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10447,6 +10488,7 @@ declare namespace OpenFin_2 {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11549,6 +11591,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;
 };
 
 /**
@@ -12353,7 +12403,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12370,7 +12420,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_2.PresetLayoutOptions;

package/out/mock.js

@@ -10451,6 +10451,8 @@ class _Frame extends base_1$a.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() {
@@ -11379,12 +11381,12 @@ class Platform extends base_1$7.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;
     }
     /**
@@ -12049,7 +12051,7 @@ class LayoutModule extends base_1$5.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/core",
-    "version": "36.79.19",
+    "version": "36.80.2",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
     "main": "out/mock.js",