@openfin/fdc3-api 42.100.36 → 42.100.42

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;
 };
 
 /**
@@ -4499,6 +4528,13 @@ declare type DomainSettings = {
     multipleMatchBehavior?: MultipleDomainMatchBehavior;
 };
 
+/**
+ * Map of preload scripts that can enable new scripts or disable options defined preloadScripts.
+ */
+declare type DomainSettingsPreloadScripts = Record<string, {
+    enabled: boolean;
+}>;
+
 /**
  * Defines domain-conditional settings for an OpenFin application.
  * @interface
@@ -8428,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;
@@ -9904,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10020,6 +10055,7 @@ declare namespace OpenFin {
         StructuredContentPermissions,
         ContentPermission,
         ScreenCaptureBehavior,
+        DomainSettingsPreloadScripts,
         PerDomainSettings,
         CopyPermissions,
         PastePermissions,
@@ -10370,6 +10406,10 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    /**
+     * {@inheritdoc DomainSettingsPreloadScripts}
+     */
+    preloadScripts?: DomainSettingsPreloadScripts;
     contentProtection?: {
         /**
          * {@inheritdoc ScreenCaptureBehavior}
@@ -10414,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[];
 };
@@ -12109,10 +12150,6 @@ declare type PrinterInfo = {
      * Printer Description
      */
     description: string;
-    /**
-     * Printer Status
-     */
-    status: number;
     /**
      * Indicates that system's default printer.
      */

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;
 };
 
 /**
@@ -4499,6 +4528,13 @@ declare type DomainSettings = {
     multipleMatchBehavior?: MultipleDomainMatchBehavior;
 };
 
+/**
+ * Map of preload scripts that can enable new scripts or disable options defined preloadScripts.
+ */
+declare type DomainSettingsPreloadScripts = Record<string, {
+    enabled: boolean;
+}>;
+
 /**
  * Defines domain-conditional settings for an OpenFin application.
  * @interface
@@ -8428,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;
@@ -9904,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10020,6 +10055,7 @@ declare namespace OpenFin {
         StructuredContentPermissions,
         ContentPermission,
         ScreenCaptureBehavior,
+        DomainSettingsPreloadScripts,
         PerDomainSettings,
         CopyPermissions,
         PastePermissions,
@@ -10370,6 +10406,10 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    /**
+     * {@inheritdoc DomainSettingsPreloadScripts}
+     */
+    preloadScripts?: DomainSettingsPreloadScripts;
     contentProtection?: {
         /**
          * {@inheritdoc ScreenCaptureBehavior}
@@ -10414,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[];
 };
@@ -12109,10 +12150,6 @@ declare type PrinterInfo = {
      * Printer Description
      */
     description: string;
-    /**
-     * Printer Status
-     */
-    status: number;
     /**
      * Indicates that system's default printer.
      */

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;
 };
 
 /**
@@ -4499,6 +4528,13 @@ declare type DomainSettings = {
     multipleMatchBehavior?: MultipleDomainMatchBehavior;
 };
 
+/**
+ * Map of preload scripts that can enable new scripts or disable options defined preloadScripts.
+ */
+declare type DomainSettingsPreloadScripts = Record<string, {
+    enabled: boolean;
+}>;
+
 /**
  * Defines domain-conditional settings for an OpenFin application.
  * @interface
@@ -8428,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;
@@ -9904,6 +9938,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10020,6 +10055,7 @@ declare namespace OpenFin {
         StructuredContentPermissions,
         ContentPermission,
         ScreenCaptureBehavior,
+        DomainSettingsPreloadScripts,
         PerDomainSettings,
         CopyPermissions,
         PastePermissions,
@@ -10370,6 +10406,10 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    /**
+     * {@inheritdoc DomainSettingsPreloadScripts}
+     */
+    preloadScripts?: DomainSettingsPreloadScripts;
     contentProtection?: {
         /**
          * {@inheritdoc ScreenCaptureBehavior}
@@ -10414,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[];
 };
@@ -12109,10 +12150,6 @@ declare type PrinterInfo = {
      * Printer Description
      */
     description: string;
-    /**
-     * Printer Status
-     */
-    status: number;
     /**
      * Indicates that system's default printer.
      */

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;
 };
 
 /**
@@ -4558,6 +4587,13 @@ declare type DomainSettings = {
     multipleMatchBehavior?: MultipleDomainMatchBehavior;
 };
 
+/**
+ * Map of preload scripts that can enable new scripts or disable options defined preloadScripts.
+ */
+declare type DomainSettingsPreloadScripts = Record<string, {
+    enabled: boolean;
+}>;
+
 /**
  * Defines domain-conditional settings for an OpenFin application.
  * @interface
@@ -8554,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;
@@ -10222,6 +10256,7 @@ declare namespace OpenFin {
         OpenExternalPermission,
         DeviceInfo,
         Permissions_2 as Permissions,
+        ClipboardApiPermissions,
         PlatformWindowCreationOptions,
         PlatformWindowOptions,
         PlatformViewCreationOptions,
@@ -10338,6 +10373,7 @@ declare namespace OpenFin {
         StructuredContentPermissions,
         ContentPermission,
         ScreenCaptureBehavior,
+        DomainSettingsPreloadScripts,
         PerDomainSettings,
         CopyPermissions,
         PastePermissions,
@@ -10688,6 +10724,10 @@ declare type PerDomainSettings = {
      * {@inheritdoc ChromiumPolicies}
      */
     chromiumPolicies?: ChromiumPolicies;
+    /**
+     * {@inheritdoc DomainSettingsPreloadScripts}
+     */
+    preloadScripts?: DomainSettingsPreloadScripts;
     contentProtection?: {
         /**
          * {@inheritdoc ScreenCaptureBehavior}
@@ -10732,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[];
 };
@@ -12510,10 +12551,6 @@ declare type PrinterInfo = {
      * Printer Description
      */
     description: string;
-    /**
-     * Printer Status
-     */
-    status: number;
     /**
      * Indicates that system's default printer.
      */

package/package.json

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