@openfin/fdc3-api 41.83.3 → 41.100.18

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

@@ -590,6 +590,23 @@ declare class Application extends EmitterBase<OpenFin.ApplicationEvent> {
      * ```
      */
     setTrayIcon(icon: string): Promise<void>;
+    /**
+     * Set hover text for this application's system tray icon.
+     * Note: Application must first set a tray icon with {@link Application.setTrayIcon}.
+     * @param toolTip
+     *
+     * @example
+     *
+     * ```js
+     * const app = fin.Application.getCurrentSync();
+     * const iconUrl = "http://cdn.openfin.co/assets/testing/icons/circled-digit-one.png";
+     *
+     * await app.setTrayIcon(iconUrl);
+     *
+     * await app.setTrayIconToolTip('My Application');
+     * ```
+     */
+    setTrayIconToolTip(toolTip: string): Promise<void>;
     /**
      * Sets new application's shortcut configuration. Windows only.
      * @param config New application's shortcut configuration.
@@ -1661,6 +1678,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1804,6 +1823,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1904,6 +1927,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin.Bounds;
 
+declare type BrowserContentBehavior = {
+    behavior: 'browser';
+    /**
+     * Additional property that can be specified when setting the behavior to browser.
+     * When set to true will close the Window or View that tried to navigate or redirect to the blocked URL.
+     */
+    closeExisting?: boolean;
+};
+
 /**
  * A rule prescribing content creation in the browser.
  *
@@ -3670,6 +3702,13 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
+    /**
+     * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
+     */
+    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -3720,6 +3759,15 @@ declare type ContainerCreatedEvent = LayoutDOMEvent & {
     type: 'container-created';
 };
 
+/**
+ * Sets the behavior for when a Window or View navigates or redirects to a matching URL
+ *
+ * 'allow': The content url is allowed.
+ * 'block': The content url is blocked.
+ * 'browser': The content url is blocked and it is opened in the system's default web browser.
+ */
+declare type ContentBehavior = BaseContentBehavior | 'browser';
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  * @interface
@@ -3807,12 +3855,9 @@ declare type ContentCreationRulesEvent = NamedEvent & {
 declare type ContentNavigation = NavigationRules;
 
 /**
- * Whether a content url is allowed or blocked for navigation or redirection.
- *
- * * 'allow': The content url is allowed.
- * * 'block': The content url is blocked.
+ * Controls whether a content url is allowed or blocked for navigation in Windows and Views or redirection for Windows, Views and iframes.
  */
-declare type ContentPermission = 'allow' | 'block';
+declare type ContentPermission = ContentBehavior | StructuredContentBehavior | StructuredContentPermissions;
 
 /**
  * Restrict redirects to URLs that match an allowed pattern.
@@ -9387,6 +9432,10 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     /**
      * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     *
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
      * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
      * @remarks It's only updatable when `enableJumpList` is set to false.
      */
@@ -9426,13 +9475,14 @@ declare type NativeWindowIntegrationProviderAuthorization = {
 };
 
 /**
- * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules.
+ * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules or when blocked by a domain-based permission content rule.
  * @interface
  */
 declare type NavigationRejectedEvent = NamedEvent & {
     type: 'navigation-rejected';
     sourceName?: string;
     url: string;
+    contentRule?: OpenFin.ContentPermission | undefined;
 };
 
 /**
@@ -9794,6 +9844,12 @@ declare namespace OpenFin {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -12112,6 +12168,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'set-tray-icon': ApplicationIdentityCall<{
         enabledIcon: string;
     }, void>;
+    'set-tray-icon-tooltip': ApplicationIdentityCall<{
+        toolTip: string;
+    }>;
     'set-shortcuts': ApplicationIdentityCall<{
         data: OpenFin.ShortCutConfig;
     }, void>;
@@ -13735,6 +13794,29 @@ declare type StartedEvent = BaseEvents.IdentityEvent & {
     type: 'started';
 };
 
+/**
+ * Allows more control over content behaviors
+ */
+declare type StructuredContentBehavior = BaseStructuredContentBehavior | BrowserContentBehavior;
+
+/**
+ * Specify rules for specific actions.
+ */
+declare type StructuredContentPermissions = {
+    /**
+     * Controls the behavior for navigations
+     */
+    navigate?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for redirects
+     */
+    redirect?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for when iframes try to redirect
+     */
+    iframe?: BaseContentBehavior;
+};
+
 /**
  * @interface
  */
@@ -17244,7 +17326,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      * ```
@@ -17255,7 +17337,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17280,7 +17362,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     await view.inspectSharedWorker();
      * ```
@@ -17291,7 +17373,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17317,7 +17399,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      *     await view.inspectSharedWorkerById(sharedWorkers[0].id);
@@ -17329,7 +17411,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };

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

@@ -590,6 +590,23 @@ declare class Application extends EmitterBase<OpenFin.ApplicationEvent> {
      * ```
      */
     setTrayIcon(icon: string): Promise<void>;
+    /**
+     * Set hover text for this application's system tray icon.
+     * Note: Application must first set a tray icon with {@link Application.setTrayIcon}.
+     * @param toolTip
+     *
+     * @example
+     *
+     * ```js
+     * const app = fin.Application.getCurrentSync();
+     * const iconUrl = "http://cdn.openfin.co/assets/testing/icons/circled-digit-one.png";
+     *
+     * await app.setTrayIcon(iconUrl);
+     *
+     * await app.setTrayIconToolTip('My Application');
+     * ```
+     */
+    setTrayIconToolTip(toolTip: string): Promise<void>;
     /**
      * Sets new application's shortcut configuration. Windows only.
      * @param config New application's shortcut configuration.
@@ -1661,6 +1678,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1804,6 +1823,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1904,6 +1927,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin.Bounds;
 
+declare type BrowserContentBehavior = {
+    behavior: 'browser';
+    /**
+     * Additional property that can be specified when setting the behavior to browser.
+     * When set to true will close the Window or View that tried to navigate or redirect to the blocked URL.
+     */
+    closeExisting?: boolean;
+};
+
 /**
  * A rule prescribing content creation in the browser.
  *
@@ -3670,6 +3702,13 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
+    /**
+     * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
+     */
+    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -3720,6 +3759,15 @@ declare type ContainerCreatedEvent = LayoutDOMEvent & {
     type: 'container-created';
 };
 
+/**
+ * Sets the behavior for when a Window or View navigates or redirects to a matching URL
+ *
+ * 'allow': The content url is allowed.
+ * 'block': The content url is blocked.
+ * 'browser': The content url is blocked and it is opened in the system's default web browser.
+ */
+declare type ContentBehavior = BaseContentBehavior | 'browser';
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  * @interface
@@ -3807,12 +3855,9 @@ declare type ContentCreationRulesEvent = NamedEvent & {
 declare type ContentNavigation = NavigationRules;
 
 /**
- * Whether a content url is allowed or blocked for navigation or redirection.
- *
- * * 'allow': The content url is allowed.
- * * 'block': The content url is blocked.
+ * Controls whether a content url is allowed or blocked for navigation in Windows and Views or redirection for Windows, Views and iframes.
  */
-declare type ContentPermission = 'allow' | 'block';
+declare type ContentPermission = ContentBehavior | StructuredContentBehavior | StructuredContentPermissions;
 
 /**
  * Restrict redirects to URLs that match an allowed pattern.
@@ -9387,6 +9432,10 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     /**
      * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     *
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
      * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
      * @remarks It's only updatable when `enableJumpList` is set to false.
      */
@@ -9426,13 +9475,14 @@ declare type NativeWindowIntegrationProviderAuthorization = {
 };
 
 /**
- * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules.
+ * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules or when blocked by a domain-based permission content rule.
  * @interface
  */
 declare type NavigationRejectedEvent = NamedEvent & {
     type: 'navigation-rejected';
     sourceName?: string;
     url: string;
+    contentRule?: OpenFin.ContentPermission | undefined;
 };
 
 /**
@@ -9794,6 +9844,12 @@ declare namespace OpenFin {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -12112,6 +12168,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'set-tray-icon': ApplicationIdentityCall<{
         enabledIcon: string;
     }, void>;
+    'set-tray-icon-tooltip': ApplicationIdentityCall<{
+        toolTip: string;
+    }>;
     'set-shortcuts': ApplicationIdentityCall<{
         data: OpenFin.ShortCutConfig;
     }, void>;
@@ -13735,6 +13794,29 @@ declare type StartedEvent = BaseEvents.IdentityEvent & {
     type: 'started';
 };
 
+/**
+ * Allows more control over content behaviors
+ */
+declare type StructuredContentBehavior = BaseStructuredContentBehavior | BrowserContentBehavior;
+
+/**
+ * Specify rules for specific actions.
+ */
+declare type StructuredContentPermissions = {
+    /**
+     * Controls the behavior for navigations
+     */
+    navigate?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for redirects
+     */
+    redirect?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for when iframes try to redirect
+     */
+    iframe?: BaseContentBehavior;
+};
+
 /**
  * @interface
  */
@@ -17244,7 +17326,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      * ```
@@ -17255,7 +17337,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17280,7 +17362,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     await view.inspectSharedWorker();
      * ```
@@ -17291,7 +17373,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17317,7 +17399,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      *     await view.inspectSharedWorkerById(sharedWorkers[0].id);
@@ -17329,7 +17411,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };

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

@@ -590,6 +590,23 @@ declare class Application extends EmitterBase<OpenFin.ApplicationEvent> {
      * ```
      */
     setTrayIcon(icon: string): Promise<void>;
+    /**
+     * Set hover text for this application's system tray icon.
+     * Note: Application must first set a tray icon with {@link Application.setTrayIcon}.
+     * @param toolTip
+     *
+     * @example
+     *
+     * ```js
+     * const app = fin.Application.getCurrentSync();
+     * const iconUrl = "http://cdn.openfin.co/assets/testing/icons/circled-digit-one.png";
+     *
+     * await app.setTrayIcon(iconUrl);
+     *
+     * await app.setTrayIconToolTip('My Application');
+     * ```
+     */
+    setTrayIconToolTip(toolTip: string): Promise<void>;
     /**
      * Sets new application's shortcut configuration. Windows only.
      * @param config New application's shortcut configuration.
@@ -1661,6 +1678,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1804,6 +1823,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1904,6 +1927,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin.Bounds;
 
+declare type BrowserContentBehavior = {
+    behavior: 'browser';
+    /**
+     * Additional property that can be specified when setting the behavior to browser.
+     * When set to true will close the Window or View that tried to navigate or redirect to the blocked URL.
+     */
+    closeExisting?: boolean;
+};
+
 /**
  * A rule prescribing content creation in the browser.
  *
@@ -3670,6 +3702,13 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
+    /**
+     * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
+     */
+    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -3720,6 +3759,15 @@ declare type ContainerCreatedEvent = LayoutDOMEvent & {
     type: 'container-created';
 };
 
+/**
+ * Sets the behavior for when a Window or View navigates or redirects to a matching URL
+ *
+ * 'allow': The content url is allowed.
+ * 'block': The content url is blocked.
+ * 'browser': The content url is blocked and it is opened in the system's default web browser.
+ */
+declare type ContentBehavior = BaseContentBehavior | 'browser';
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  * @interface
@@ -3807,12 +3855,9 @@ declare type ContentCreationRulesEvent = NamedEvent & {
 declare type ContentNavigation = NavigationRules;
 
 /**
- * Whether a content url is allowed or blocked for navigation or redirection.
- *
- * * 'allow': The content url is allowed.
- * * 'block': The content url is blocked.
+ * Controls whether a content url is allowed or blocked for navigation in Windows and Views or redirection for Windows, Views and iframes.
  */
-declare type ContentPermission = 'allow' | 'block';
+declare type ContentPermission = ContentBehavior | StructuredContentBehavior | StructuredContentPermissions;
 
 /**
  * Restrict redirects to URLs that match an allowed pattern.
@@ -9387,6 +9432,10 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     /**
      * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     *
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
      * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
      * @remarks It's only updatable when `enableJumpList` is set to false.
      */
@@ -9426,13 +9475,14 @@ declare type NativeWindowIntegrationProviderAuthorization = {
 };
 
 /**
- * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules.
+ * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules or when blocked by a domain-based permission content rule.
  * @interface
  */
 declare type NavigationRejectedEvent = NamedEvent & {
     type: 'navigation-rejected';
     sourceName?: string;
     url: string;
+    contentRule?: OpenFin.ContentPermission | undefined;
 };
 
 /**
@@ -9794,6 +9844,12 @@ declare namespace OpenFin {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -12112,6 +12168,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'set-tray-icon': ApplicationIdentityCall<{
         enabledIcon: string;
     }, void>;
+    'set-tray-icon-tooltip': ApplicationIdentityCall<{
+        toolTip: string;
+    }>;
     'set-shortcuts': ApplicationIdentityCall<{
         data: OpenFin.ShortCutConfig;
     }, void>;
@@ -13735,6 +13794,29 @@ declare type StartedEvent = BaseEvents.IdentityEvent & {
     type: 'started';
 };
 
+/**
+ * Allows more control over content behaviors
+ */
+declare type StructuredContentBehavior = BaseStructuredContentBehavior | BrowserContentBehavior;
+
+/**
+ * Specify rules for specific actions.
+ */
+declare type StructuredContentPermissions = {
+    /**
+     * Controls the behavior for navigations
+     */
+    navigate?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for redirects
+     */
+    redirect?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for when iframes try to redirect
+     */
+    iframe?: BaseContentBehavior;
+};
+
 /**
  * @interface
  */
@@ -17244,7 +17326,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      * ```
@@ -17255,7 +17337,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17280,7 +17362,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     await view.inspectSharedWorker();
      * ```
@@ -17291,7 +17373,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17317,7 +17399,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      *     await view.inspectSharedWorkerById(sharedWorkers[0].id);
@@ -17329,7 +17411,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };

package/out/fdc3-api.d.ts

@@ -596,6 +596,23 @@ declare class Application extends EmitterBase<OpenFin.ApplicationEvent> {
      * ```
      */
     setTrayIcon(icon: string): Promise<void>;
+    /**
+     * Set hover text for this application's system tray icon.
+     * Note: Application must first set a tray icon with {@link Application.setTrayIcon}.
+     * @param toolTip
+     *
+     * @example
+     *
+     * ```js
+     * const app = fin.Application.getCurrentSync();
+     * const iconUrl = "http://cdn.openfin.co/assets/testing/icons/circled-digit-one.png";
+     *
+     * await app.setTrayIcon(iconUrl);
+     *
+     * await app.setTrayIconToolTip('My Application');
+     * ```
+     */
+    setTrayIconToolTip(toolTip: string): Promise<void>;
     /**
      * Sets new application's shortcut configuration. Windows only.
      * @param config New application's shortcut configuration.
@@ -1693,6 +1710,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1836,6 +1855,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1936,6 +1959,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin.Bounds;
 
+declare type BrowserContentBehavior = {
+    behavior: 'browser';
+    /**
+     * Additional property that can be specified when setting the behavior to browser.
+     * When set to true will close the Window or View that tried to navigate or redirect to the blocked URL.
+     */
+    closeExisting?: boolean;
+};
+
 /**
  * A rule prescribing content creation in the browser.
  *
@@ -3729,6 +3761,13 @@ declare type ConstWindowOptions = {
      * @deprecated - use `icon` instead.
      */
     taskbarIcon: string;
+    /**
+     * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
+     */
+    taskbarIconGroup: string;
     /**
      * @defaultValue "about:blank"
      *
@@ -3779,6 +3818,15 @@ declare type ContainerCreatedEvent = LayoutDOMEvent & {
     type: 'container-created';
 };
 
+/**
+ * Sets the behavior for when a Window or View navigates or redirects to a matching URL
+ *
+ * 'allow': The content url is allowed.
+ * 'block': The content url is blocked.
+ * 'browser': The content url is blocked and it is opened in the system's default web browser.
+ */
+declare type ContentBehavior = BaseContentBehavior | 'browser';
+
 /**
  * Generated when content navigation or redirection is blocked by {@link OpenFin.DomainSettings}.
  * @interface
@@ -3866,12 +3914,9 @@ declare type ContentCreationRulesEvent = NamedEvent & {
 declare type ContentNavigation = NavigationRules;
 
 /**
- * Whether a content url is allowed or blocked for navigation or redirection.
- *
- * * 'allow': The content url is allowed.
- * * 'block': The content url is blocked.
+ * Controls whether a content url is allowed or blocked for navigation in Windows and Views or redirection for Windows, Views and iframes.
  */
-declare type ContentPermission = 'allow' | 'block';
+declare type ContentPermission = ContentBehavior | StructuredContentBehavior | StructuredContentPermissions;
 
 /**
  * Restrict redirects to URLs that match an allowed pattern.
@@ -9687,6 +9732,10 @@ declare type MutableWindowOptions = {
     showTaskbarIcon: boolean;
     /**
      * Specify a taskbar group for the window.
+     * _Can be shared across applications._
+     *
+     * _If omitted from a main window, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
+     * _Use `platform.defaultWindowOptions.taskbarIconGroup` to set a default for platform applications._
      * _If omitted, defaults to app's uuid (`fin.Application.getCurrentSync().identity.uuid`)._
      * @remarks It's only updatable when `enableJumpList` is set to false.
      */
@@ -9734,13 +9783,14 @@ declare type NativeWindowIntegrationProviderAuthorization = {
 };
 
 /**
- * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules.
+ * Generated when view navigation is rejected as per contentNavigation allowlist/denylist rules or when blocked by a domain-based permission content rule.
  * @interface
  */
 declare type NavigationRejectedEvent = NamedEvent & {
     type: 'navigation-rejected';
     sourceName?: string;
     url: string;
+    contentRule?: OpenFin.ContentPermission | undefined;
 };
 
 /**
@@ -10112,6 +10162,12 @@ declare namespace OpenFin {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -12513,6 +12569,9 @@ declare interface ProtocolMap extends ProtocolMapBase {
     'set-tray-icon': ApplicationIdentityCall<{
         enabledIcon: string;
     }, void>;
+    'set-tray-icon-tooltip': ApplicationIdentityCall<{
+        toolTip: string;
+    }>;
     'set-shortcuts': ApplicationIdentityCall<{
         data: OpenFin.ShortCutConfig;
     }, void>;
@@ -14139,6 +14198,29 @@ declare type StartedEvent = BaseEvents.IdentityEvent & {
     type: 'started';
 };
 
+/**
+ * Allows more control over content behaviors
+ */
+declare type StructuredContentBehavior = BaseStructuredContentBehavior | BrowserContentBehavior;
+
+/**
+ * Specify rules for specific actions.
+ */
+declare type StructuredContentPermissions = {
+    /**
+     * Controls the behavior for navigations
+     */
+    navigate?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for redirects
+     */
+    redirect?: ContentBehavior | StructuredContentBehavior;
+    /**
+     * Controls the behavior for when iframes try to redirect
+     */
+    iframe?: BaseContentBehavior;
+};
+
 /**
  * @interface
  */
@@ -17695,7 +17777,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      * ```
@@ -17706,7 +17788,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17731,7 +17813,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     await view.inspectSharedWorker();
      * ```
@@ -17742,7 +17824,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };
@@ -17768,7 +17850,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         bounds: {top: 10, left: 10, width: 200, height: 200}
      *     });
      *
-     *     await view.navigate('http://mdn.github.io/simple-shared-worker/index2.html');
+     *     await view.navigate('https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/');
      *
      *     const sharedWorkers = await view.getSharedWorkers();
      *     await view.inspectSharedWorkerById(sharedWorkers[0].id);
@@ -17780,7 +17862,7 @@ declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
      *         name:'child',
      *         defaultWidth: 300,
      *         defaultHeight: 300,
-     *         url: 'http://mdn.github.io/simple-shared-worker/index2.html',
+     *         url: 'https://mdn.github.io/dom-examples/web-workers/simple-shared-worker/',
      *         frame: true,
      *         autoShow: true
      *     };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/fdc3-api",
-    "version": "41.83.3",
+    "version": "41.100.18",
     "description": "OpenFin fdc3 module utilities and types.",
     "license": "SEE LICENSE IN LICENSE.md",
     "private": false,
@@ -16,7 +16,8 @@
         "watch": "npm run dev -- --watch",
         "ci:prepublish": "of-npm prepublish",
         "ci:postpublish": "of-npm postpublish",
-        "ci:publish": "npm publish"
+        "ci:publish": "npm publish",
+        "version:update": "of-npm version --allow-same-version '$RMAJOR.$RMINOR.$RPATCH'"
     },
     "author": "OpenFin",
     "dependencies": {