@openfin/fdc3-api 41.100.111 → 41.100.113

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

@@ -69,6 +69,10 @@ declare type AddViewToStackOptions = {
      * Optional index within the stack to insert the view. Defaults to 0
      */
     index?: number;
+    /**
+     * How the view should be displayed in the stack. Defaults to 'focused'
+     */
+    displayState?: 'focused' | 'background';
 };
 
 /**
@@ -3066,6 +3070,7 @@ declare type ClientInfo = Omit<ClientIdentity, 'isLocalEndpointId'> & {
  *
  */
 declare class Clipboard_2 extends Base {
+    #private;
     /**
      * Writes data into the clipboard as plain text
      * @param writeObj The object for writing data into the clipboard
@@ -3218,6 +3223,21 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Permissions for {@link Clipboard} APIs.
+ */
+declare type ClipboardApiPermissions = {
+    writeText: boolean;
+    readText: boolean;
+    writeImage: boolean;
+    readImage: boolean;
+    writeHtml: boolean;
+    readHtml: boolean;
+    writeRtf: boolean;
+    readRtf: boolean;
+    write: boolean;
+};
+
 /**
  * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
  * @interface
@@ -3885,7 +3905,17 @@ declare type ContentCreationRulesEvent = NamedEvent & {
      * The features string passed to `window.open()` converted to OpenFin window options
      */
     parsedFeatures: Partial<OpenFin.WindowOptions>;
-    disposition: string;
+    /**
+     * The reported disposition of the content creation request.
+     * @remarks
+     * - `default` - The default behavior of the browser.
+     * - `foreground-tab` - The content is loaded in a new tab in the foreground. This is the default behavior for `window.open()` or a link with target=_blank.
+     * - `background-tab` - The content is loaded in a new tab in the background. This is the default behavior when clicking on a link with the `ctrl` or `cmd` key pressed.
+     * - `new-window` - The content is loaded in a new window. This is the default behavior when clicking on a link with the `shift` key pressed.
+     * - `popup` - The content is loaded in a popup window. This is the result of passing popup features to `window.open()`.
+     * - `other` - The content is loaded in some other way.
+     */
+    disposition: 'default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'popup' | 'other';
 };
 
 /**
@@ -4227,8 +4257,7 @@ declare type CreateViewTarget = (Identity_4 | LayoutIdentity) & {
      */
     location?: {
         id: string;
-        index?: number;
-    };
+    } & AddViewToStackOptions;
 };
 
 /**
@@ -8435,9 +8464,7 @@ declare type LayoutEntitiesController = {
     getParent: (id: string) => OpenFin.LayoutEntityDefinition | undefined;
     isRoot: (id: string) => boolean;
     exists: (entityId: string) => boolean;
-    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: {
-        index?: number;
-    }) => Promise<OpenFin.Identity>;
+    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
     removeViewFromStack: (stackEntityId: string, view: OpenFin.Identity) => Promise<void>;
     createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], stackCreationOptions?: {
         position?: OpenFin.LayoutPosition;
@@ -9911,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10426,6 +10454,7 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
+    Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
 };

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

@@ -69,6 +69,10 @@ declare type AddViewToStackOptions = {
      * Optional index within the stack to insert the view. Defaults to 0
      */
     index?: number;
+    /**
+     * How the view should be displayed in the stack. Defaults to 'focused'
+     */
+    displayState?: 'focused' | 'background';
 };
 
 /**
@@ -3066,6 +3070,7 @@ declare type ClientInfo = Omit<ClientIdentity, 'isLocalEndpointId'> & {
  *
  */
 declare class Clipboard_2 extends Base {
+    #private;
     /**
      * Writes data into the clipboard as plain text
      * @param writeObj The object for writing data into the clipboard
@@ -3218,6 +3223,21 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Permissions for {@link Clipboard} APIs.
+ */
+declare type ClipboardApiPermissions = {
+    writeText: boolean;
+    readText: boolean;
+    writeImage: boolean;
+    readImage: boolean;
+    writeHtml: boolean;
+    readHtml: boolean;
+    writeRtf: boolean;
+    readRtf: boolean;
+    write: boolean;
+};
+
 /**
  * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
  * @interface
@@ -3885,7 +3905,17 @@ declare type ContentCreationRulesEvent = NamedEvent & {
      * The features string passed to `window.open()` converted to OpenFin window options
      */
     parsedFeatures: Partial<OpenFin.WindowOptions>;
-    disposition: string;
+    /**
+     * The reported disposition of the content creation request.
+     * @remarks
+     * - `default` - The default behavior of the browser.
+     * - `foreground-tab` - The content is loaded in a new tab in the foreground. This is the default behavior for `window.open()` or a link with target=_blank.
+     * - `background-tab` - The content is loaded in a new tab in the background. This is the default behavior when clicking on a link with the `ctrl` or `cmd` key pressed.
+     * - `new-window` - The content is loaded in a new window. This is the default behavior when clicking on a link with the `shift` key pressed.
+     * - `popup` - The content is loaded in a popup window. This is the result of passing popup features to `window.open()`.
+     * - `other` - The content is loaded in some other way.
+     */
+    disposition: 'default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'popup' | 'other';
 };
 
 /**
@@ -4227,8 +4257,7 @@ declare type CreateViewTarget = (Identity_4 | LayoutIdentity) & {
      */
     location?: {
         id: string;
-        index?: number;
-    };
+    } & AddViewToStackOptions;
 };
 
 /**
@@ -8435,9 +8464,7 @@ declare type LayoutEntitiesController = {
     getParent: (id: string) => OpenFin.LayoutEntityDefinition | undefined;
     isRoot: (id: string) => boolean;
     exists: (entityId: string) => boolean;
-    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: {
-        index?: number;
-    }) => Promise<OpenFin.Identity>;
+    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
     removeViewFromStack: (stackEntityId: string, view: OpenFin.Identity) => Promise<void>;
     createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], stackCreationOptions?: {
         position?: OpenFin.LayoutPosition;
@@ -9911,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10426,6 +10454,7 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
+    Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
 };

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

@@ -69,6 +69,10 @@ declare type AddViewToStackOptions = {
      * Optional index within the stack to insert the view. Defaults to 0
      */
     index?: number;
+    /**
+     * How the view should be displayed in the stack. Defaults to 'focused'
+     */
+    displayState?: 'focused' | 'background';
 };
 
 /**
@@ -3066,6 +3070,7 @@ declare type ClientInfo = Omit<ClientIdentity, 'isLocalEndpointId'> & {
  *
  */
 declare class Clipboard_2 extends Base {
+    #private;
     /**
      * Writes data into the clipboard as plain text
      * @param writeObj The object for writing data into the clipboard
@@ -3218,6 +3223,21 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Permissions for {@link Clipboard} APIs.
+ */
+declare type ClipboardApiPermissions = {
+    writeText: boolean;
+    readText: boolean;
+    writeImage: boolean;
+    readImage: boolean;
+    writeHtml: boolean;
+    readHtml: boolean;
+    writeRtf: boolean;
+    readRtf: boolean;
+    write: boolean;
+};
+
 /**
  * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
  * @interface
@@ -3885,7 +3905,17 @@ declare type ContentCreationRulesEvent = NamedEvent & {
      * The features string passed to `window.open()` converted to OpenFin window options
      */
     parsedFeatures: Partial<OpenFin.WindowOptions>;
-    disposition: string;
+    /**
+     * The reported disposition of the content creation request.
+     * @remarks
+     * - `default` - The default behavior of the browser.
+     * - `foreground-tab` - The content is loaded in a new tab in the foreground. This is the default behavior for `window.open()` or a link with target=_blank.
+     * - `background-tab` - The content is loaded in a new tab in the background. This is the default behavior when clicking on a link with the `ctrl` or `cmd` key pressed.
+     * - `new-window` - The content is loaded in a new window. This is the default behavior when clicking on a link with the `shift` key pressed.
+     * - `popup` - The content is loaded in a popup window. This is the result of passing popup features to `window.open()`.
+     * - `other` - The content is loaded in some other way.
+     */
+    disposition: 'default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'popup' | 'other';
 };
 
 /**
@@ -4227,8 +4257,7 @@ declare type CreateViewTarget = (Identity_4 | LayoutIdentity) & {
      */
     location?: {
         id: string;
-        index?: number;
-    };
+    } & AddViewToStackOptions;
 };
 
 /**
@@ -8435,9 +8464,7 @@ declare type LayoutEntitiesController = {
     getParent: (id: string) => OpenFin.LayoutEntityDefinition | undefined;
     isRoot: (id: string) => boolean;
     exists: (entityId: string) => boolean;
-    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: {
-        index?: number;
-    }) => Promise<OpenFin.Identity>;
+    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
     removeViewFromStack: (stackEntityId: string, view: OpenFin.Identity) => Promise<void>;
     createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], stackCreationOptions?: {
         position?: OpenFin.LayoutPosition;
@@ -9911,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10426,6 +10454,7 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
+    Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
 };

package/out/fdc3-api.d.ts

@@ -69,6 +69,10 @@ declare type AddViewToStackOptions = {
      * Optional index within the stack to insert the view. Defaults to 0
      */
     index?: number;
+    /**
+     * How the view should be displayed in the stack. Defaults to 'focused'
+     */
+    displayState?: 'focused' | 'background';
 };
 
 /**
@@ -3122,6 +3126,7 @@ declare type ClientInfo = Omit<ClientIdentity, 'isLocalEndpointId'> & {
  *
  */
 declare class Clipboard_2 extends Base {
+    #private;
     /**
      * Writes data into the clipboard as plain text
      * @param writeObj The object for writing data into the clipboard
@@ -3274,6 +3279,21 @@ declare class Clipboard_2 extends Base {
     getAvailableFormats(type?: OpenFin.ClipboardSelectionType): Promise<Array<string>>;
 }
 
+/**
+ * Permissions for {@link Clipboard} APIs.
+ */
+declare type ClipboardApiPermissions = {
+    writeText: boolean;
+    readText: boolean;
+    writeImage: boolean;
+    readImage: boolean;
+    writeHtml: boolean;
+    readHtml: boolean;
+    writeRtf: boolean;
+    readRtf: boolean;
+    write: boolean;
+};
+
 /**
  * Generated when a copy operation is blocked through {@link OpenFin.DomainSettings}.
  * @interface
@@ -3944,7 +3964,17 @@ declare type ContentCreationRulesEvent = NamedEvent & {
      * The features string passed to `window.open()` converted to OpenFin window options
      */
     parsedFeatures: Partial<OpenFin.WindowOptions>;
-    disposition: string;
+    /**
+     * The reported disposition of the content creation request.
+     * @remarks
+     * - `default` - The default behavior of the browser.
+     * - `foreground-tab` - The content is loaded in a new tab in the foreground. This is the default behavior for `window.open()` or a link with target=_blank.
+     * - `background-tab` - The content is loaded in a new tab in the background. This is the default behavior when clicking on a link with the `ctrl` or `cmd` key pressed.
+     * - `new-window` - The content is loaded in a new window. This is the default behavior when clicking on a link with the `shift` key pressed.
+     * - `popup` - The content is loaded in a popup window. This is the result of passing popup features to `window.open()`.
+     * - `other` - The content is loaded in some other way.
+     */
+    disposition: 'default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'popup' | 'other';
 };
 
 /**
@@ -4286,8 +4316,7 @@ declare type CreateViewTarget = (Identity_4 | LayoutIdentity) & {
      */
     location?: {
         id: string;
-        index?: number;
-    };
+    } & AddViewToStackOptions;
 };
 
 /**
@@ -8561,9 +8590,7 @@ declare type LayoutEntitiesController = {
     getParent: (id: string) => OpenFin.LayoutEntityDefinition | undefined;
     isRoot: (id: string) => boolean;
     exists: (entityId: string) => boolean;
-    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: {
-        index?: number;
-    }) => Promise<OpenFin.Identity>;
+    addViewToStack: (stackEntityId: string, viewCreationOrReference: ViewCreationOrReference, viewInsertionOptions?: OpenFin.AddViewToStackOptions) => Promise<OpenFin.Identity>;
     removeViewFromStack: (stackEntityId: string, view: OpenFin.Identity) => Promise<void>;
     createAdjacentStack: (targetId: string, views: ViewCreationOrReference[], stackCreationOptions?: {
         position?: OpenFin.LayoutPosition;
@@ -10229,6 +10256,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10744,6 +10772,7 @@ declare type PerformanceReportEvent = Performance & BaseEvent_5 & {
 declare type Permissions_2 = {
     Application?: Partial<ApplicationPermissions>;
     System?: Partial<SystemPermissions>;
+    Clipboard?: Partial<ClipboardApiPermissions>;
     webAPIs?: WebPermission[];
     devices?: DeviceInfo[];
 };

package/package.json

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