@openfin/fdc3-api 36.79.19 → 36.80.2

package/out/fdc3-api-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[];
 };
@@ -5977,7 +5999,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.
@@ -6227,6 +6254,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() {
@@ -7072,6 +7101,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
@@ -8673,6 +8709,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9850,7 +9887,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.
@@ -10303,6 +10340,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10311,6 +10349,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10462,7 +10501,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10470,6 +10511,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11538,6 +11580,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;
 };
 
 /**
@@ -12297,7 +12347,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12314,7 +12364,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/fdc3-api-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[];
 };
@@ -5977,7 +5999,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.
@@ -6227,6 +6254,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() {
@@ -7072,6 +7101,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
@@ -8673,6 +8709,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9850,7 +9887,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.
@@ -10303,6 +10340,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10311,6 +10349,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10462,7 +10501,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10470,6 +10511,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11538,6 +11580,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;
 };
 
 /**
@@ -12297,7 +12347,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12314,7 +12364,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/fdc3-api-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[];
 };
@@ -5977,7 +5999,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.
@@ -6227,6 +6254,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() {
@@ -7072,6 +7101,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
@@ -8673,6 +8709,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -9850,7 +9887,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.
@@ -10303,6 +10340,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10311,6 +10349,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10462,7 +10501,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10470,6 +10511,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11538,6 +11580,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;
 };
 
 /**
@@ -12297,7 +12347,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12314,7 +12364,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/fdc3-api.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[];
 };
@@ -6058,7 +6080,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.
@@ -6311,6 +6338,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() {
@@ -7162,6 +7191,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
@@ -8786,6 +8822,7 @@ declare type LaunchExternalProcessRule = {
  */
 declare type LaunchIntoPlatformPayload = {
     manifest: any;
+    manifestUrl?: string;
 };
 
 /**
@@ -10139,7 +10176,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.
@@ -10614,6 +10651,7 @@ declare namespace OpenFin {
         WindowState,
         AutoplayPolicyOptions,
         ConstWindowOptions,
+        InheritableOptions,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10622,6 +10660,7 @@ declare namespace OpenFin {
         ResizeRegion,
         Accelerator,
         Api,
+        ApiSettings,
         InjectionType,
         NavigationRules,
         ContentNavigation,
@@ -10773,7 +10812,9 @@ declare namespace OpenFin {
         DefaultDomainSettingsRule,
         DomainSettings,
         ApiInjection,
+        DomainApiSettings,
         DomainSettingsRule,
+        FileDownloadBehavior,
         FileDownloadBehaviorNames,
         FileDownloadSettings,
         DownloadRule,
@@ -10781,6 +10822,7 @@ declare namespace OpenFin {
         Intent_2 as Intent,
         IntentMetadata_3 as IntentMetadata,
         IntentHandler_2 as IntentHandler,
+        ContentCreationBehavior,
         ContentCreationBehaviorNames,
         MatchPattern,
         BaseContentCreationRule,
@@ -11882,6 +11924,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;
 };
 
 /**
@@ -12686,7 +12736,7 @@ declare type PreloadScriptInfoRunning = {
  * @interface
  */
 declare type PreloadScriptsStateChangedEvent = PreloadScriptsStateChangeEvent & {
-    type: 'preload-script-state-changed';
+    type: 'preload-scripts-state-changed';
 };
 
 /**
@@ -12703,7 +12753,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/package.json

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