@openfin/core 41.83.3 → 41.100.18

package/out/mock-alpha.d.ts

@@ -593,6 +593,23 @@ declare class Application extends EmitterBase<OpenFin_2.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.
@@ -1664,6 +1681,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1807,6 +1826,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1907,6 +1930,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin_2.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.
  *
@@ -3673,6 +3705,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"
      *
@@ -3723,6 +3762,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
@@ -3810,12 +3858,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.
@@ -9045,6 +9090,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.
      */
@@ -9084,13 +9133,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_2.ContentPermission | undefined;
 };
 
 /**
@@ -9452,6 +9502,12 @@ declare namespace OpenFin_2 {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -11772,6 +11828,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_2.ShortCutConfig;
     }, void>;
@@ -13395,6 +13454,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
  */
@@ -16798,7 +16880,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();
      * ```
@@ -16809,7 +16891,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
      *     };
@@ -16834,7 +16916,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();
      * ```
@@ -16845,7 +16927,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
      *     };
@@ -16871,7 +16953,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);
@@ -16883,7 +16965,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/mock-beta.d.ts

@@ -593,6 +593,23 @@ declare class Application extends EmitterBase<OpenFin_2.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.
@@ -1664,6 +1681,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1807,6 +1826,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1907,6 +1930,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin_2.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.
  *
@@ -3673,6 +3705,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"
      *
@@ -3723,6 +3762,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
@@ -3810,12 +3858,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.
@@ -9045,6 +9090,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.
      */
@@ -9084,13 +9133,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_2.ContentPermission | undefined;
 };
 
 /**
@@ -9452,6 +9502,12 @@ declare namespace OpenFin_2 {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -11772,6 +11828,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_2.ShortCutConfig;
     }, void>;
@@ -13395,6 +13454,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
  */
@@ -16798,7 +16880,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();
      * ```
@@ -16809,7 +16891,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
      *     };
@@ -16834,7 +16916,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();
      * ```
@@ -16845,7 +16927,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
      *     };
@@ -16871,7 +16953,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);
@@ -16883,7 +16965,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/mock-public.d.ts

@@ -593,6 +593,23 @@ declare class Application extends EmitterBase<OpenFin_2.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.
@@ -1664,6 +1681,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1807,6 +1826,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1907,6 +1930,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin_2.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.
  *
@@ -3673,6 +3705,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"
      *
@@ -3723,6 +3762,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
@@ -3810,12 +3858,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.
@@ -9045,6 +9090,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.
      */
@@ -9084,13 +9133,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_2.ContentPermission | undefined;
 };
 
 /**
@@ -9452,6 +9502,12 @@ declare namespace OpenFin_2 {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -11772,6 +11828,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_2.ShortCutConfig;
     }, void>;
@@ -13395,6 +13454,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
  */
@@ -16798,7 +16880,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();
      * ```
@@ -16809,7 +16891,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
      *     };
@@ -16834,7 +16916,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();
      * ```
@@ -16845,7 +16927,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
      *     };
@@ -16871,7 +16953,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);
@@ -16883,7 +16965,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/mock.d.ts

@@ -599,6 +599,23 @@ declare class Application extends EmitterBase<OpenFin_2.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.
@@ -1696,6 +1713,8 @@ declare type BaseConfig = {
     timeout?: number;
 };
 
+declare type BaseContentBehavior = 'allow' | 'block';
+
 /**
  * Properties shared by all content creation rules, regardless of context.
  *
@@ -1839,6 +1858,10 @@ declare type BaseLoadFailedEvent = NamedEvent & {
     isMainFrame: boolean;
 };
 
+declare type BaseStructuredContentBehavior = {
+    behavior: BaseContentBehavior;
+};
+
 declare type BaseUrlEvent = NamedEvent & {
     type: 'url-changed';
     url: string;
@@ -1939,6 +1962,15 @@ declare type BoundsDidChangeEvent = BoundsChangeEvent & {
 
 declare type BoundsEvent = BaseEvent_5 & OpenFin_2.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.
  *
@@ -3732,6 +3764,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"
      *
@@ -3782,6 +3821,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
@@ -3869,12 +3917,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.
@@ -9345,6 +9390,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.
      */
@@ -9392,13 +9441,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_2.ContentPermission | undefined;
 };
 
 /**
@@ -9770,6 +9820,12 @@ declare namespace OpenFin_2 {
         DomainSettings,
         ApiInjection,
         DomainApiSettings,
+        BaseContentBehavior,
+        ContentBehavior,
+        BaseStructuredContentBehavior,
+        BrowserContentBehavior,
+        StructuredContentBehavior,
+        StructuredContentPermissions,
         ContentPermission,
         PerDomainSettings,
         DomainSettingsRule,
@@ -12173,6 +12229,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_2.ShortCutConfig;
     }, void>;
@@ -13799,6 +13858,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
  */
@@ -17249,7 +17331,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();
      * ```
@@ -17260,7 +17342,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
      *     };
@@ -17285,7 +17367,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();
      * ```
@@ -17296,7 +17378,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
      *     };
@@ -17322,7 +17404,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);
@@ -17334,7 +17416,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/mock.js

@@ -1698,7 +1698,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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();
      * ```
@@ -1709,7 +1709,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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
      *     };
@@ -1736,7 +1736,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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();
      * ```
@@ -1747,7 +1747,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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
      *     };
@@ -1775,7 +1775,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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);
@@ -1787,7 +1787,7 @@ class WebContents extends base_1$j.EmitterBase {
      *         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
      *     };
@@ -3230,6 +3230,25 @@ function requireInstance$1 () {
 	        })
 	            .then(() => undefined);
 	    }
+	    /**
+	     * 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');
+	     * ```
+	     */
+	    async setTrayIconToolTip(toolTip) {
+	        await this.wire.sendAction('set-tray-icon-tooltip', { ...this.identity, toolTip });
+	    }
 	    /**
 	     * Sets new application's shortcut configuration. Windows only.
 	     * @param config New application's shortcut configuration.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@openfin/core",
-    "version": "41.83.3",
+    "version": "41.100.18",
     "description": "The core renderer entry point of OpenFin",
     "license": "SEE LICENSE IN LICENSE.md",
     "main": "out/mock.js",
@@ -24,7 +24,8 @@
         "test": "run-p test:*",
         "test:sample": "tsc -p test/tsconfig.json",
         "test:imports": "ts-node scripts/verify-imports",
-        "test:mocha": "ts-mocha -R dot --exit \"./src/**/__tests__/**.test.ts\""
+        "test:mocha": "ts-mocha -R dot --exit \"./src/**/__tests__/**.test.ts\"",
+        "version:update": "of-npm version --allow-same-version '$RMAJOR.$RMINOR.$RPATCH'"
     },
     "files": [
         "out/*",