@openfin/fdc3-api 46.100.32 → 46.100.36

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

@@ -3083,12 +3083,31 @@ declare interface ChildContentOptions {
  */
 declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-view-created';
+    /**
+     * Recommended placement for the already-created child View.
+     *
+     * This is complementary to `disposition`: `disposition` describes the requested browser creation
+     * behavior, while `destination` describes where the resulting View should be placed.
+     */
+    destination: ChildViewDestination;
     /**
      * The options the child View was created with.
      */
     childOptions: OpenFin.ViewOptions;
 };
 
+/**
+ * Describes where an already-created View should be placed.
+ */
+declare type ChildViewDestination = {
+    /** Add the View to this existing window. */
+    type: 'existing-window';
+    identity: OpenFin.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3101,22 +3120,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
-/**
- * End of Interop Client Events
- */
-/**
- * Client-side handle for the chrome-browser feature.
- *
- * For Chrome extension integration to be active on a window, that window must be
- * created with `chromeBrowser: true` in its window options. There is no separate
- * `init()` step.
- */
-declare interface ChromeBrowser {
-    /**
-     * Extension action surface — observe and invoke installed Chrome extension actions.
-     */
-    readonly Actions: ChromeBrowserActions;
-}
+/* Excluded from this release type: ChromeBrowser */
 
 /**
  * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
@@ -3886,14 +3890,7 @@ declare type ConstWindowOptions = {
      * @default false
      */
     backgroundThrottling: boolean;
-    /**
-     * If `true`, the window is registered with Chromium as a `ChromeBrowser`,
-     * making it visible to Chrome extensions via the `chrome.windows` API.
-     * The window must be created with this option set; it cannot be flipped at runtime.
-     *
-     * @defaultValue false
-     */
-    chromeBrowser: boolean;
+    /* Excluded from this release type: chromeBrowser */
     /**
      * Configures how new content (e,g, from `window.open` or a link) is opened.
      */
@@ -5639,6 +5636,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin.Identity;
+    /**
+     * Recommended placement for the auto-created View. This is complementary to `disposition`, which
+     * describes the requested browser creation behavior.
+     */
+    destination: WebContentsEvents.ChildViewDestination;
     /**
      * Identity of the view that was active when the extension triggered tab creation.
      * Undefined if no tab was active (e.g. the first tab in a newly-opened window).
@@ -6386,7 +6388,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin.ChromeBrowser;
+    /* Excluded from this release type: ChromeBrowser */
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -19889,6 +19891,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

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

@@ -3083,12 +3083,31 @@ declare interface ChildContentOptions {
  */
 declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-view-created';
+    /**
+     * Recommended placement for the already-created child View.
+     *
+     * This is complementary to `disposition`: `disposition` describes the requested browser creation
+     * behavior, while `destination` describes where the resulting View should be placed.
+     */
+    destination: ChildViewDestination;
     /**
      * The options the child View was created with.
      */
     childOptions: OpenFin.ViewOptions;
 };
 
+/**
+ * Describes where an already-created View should be placed.
+ */
+declare type ChildViewDestination = {
+    /** Add the View to this existing window. */
+    type: 'existing-window';
+    identity: OpenFin.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3101,22 +3120,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
-/**
- * End of Interop Client Events
- */
-/**
- * Client-side handle for the chrome-browser feature.
- *
- * For Chrome extension integration to be active on a window, that window must be
- * created with `chromeBrowser: true` in its window options. There is no separate
- * `init()` step.
- */
-declare interface ChromeBrowser {
-    /**
-     * Extension action surface — observe and invoke installed Chrome extension actions.
-     */
-    readonly Actions: ChromeBrowserActions;
-}
+/* Excluded from this release type: ChromeBrowser */
 
 /**
  * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
@@ -3886,14 +3890,7 @@ declare type ConstWindowOptions = {
      * @default false
      */
     backgroundThrottling: boolean;
-    /**
-     * If `true`, the window is registered with Chromium as a `ChromeBrowser`,
-     * making it visible to Chrome extensions via the `chrome.windows` API.
-     * The window must be created with this option set; it cannot be flipped at runtime.
-     *
-     * @defaultValue false
-     */
-    chromeBrowser: boolean;
+    /* Excluded from this release type: chromeBrowser */
     /**
      * Configures how new content (e,g, from `window.open` or a link) is opened.
      */
@@ -5639,6 +5636,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin.Identity;
+    /**
+     * Recommended placement for the auto-created View. This is complementary to `disposition`, which
+     * describes the requested browser creation behavior.
+     */
+    destination: WebContentsEvents.ChildViewDestination;
     /**
      * Identity of the view that was active when the extension triggered tab creation.
      * Undefined if no tab was active (e.g. the first tab in a newly-opened window).
@@ -6386,7 +6388,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin.ChromeBrowser;
+    /* Excluded from this release type: ChromeBrowser */
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -19889,6 +19891,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

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

@@ -3083,12 +3083,31 @@ declare interface ChildContentOptions {
  */
 declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-view-created';
+    /**
+     * Recommended placement for the already-created child View.
+     *
+     * This is complementary to `disposition`: `disposition` describes the requested browser creation
+     * behavior, while `destination` describes where the resulting View should be placed.
+     */
+    destination: ChildViewDestination;
     /**
      * The options the child View was created with.
      */
     childOptions: OpenFin.ViewOptions;
 };
 
+/**
+ * Describes where an already-created View should be placed.
+ */
+declare type ChildViewDestination = {
+    /** Add the View to this existing window. */
+    type: 'existing-window';
+    identity: OpenFin.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3101,22 +3120,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin.WindowOptions;
 };
 
-/**
- * End of Interop Client Events
- */
-/**
- * Client-side handle for the chrome-browser feature.
- *
- * For Chrome extension integration to be active on a window, that window must be
- * created with `chromeBrowser: true` in its window options. There is no separate
- * `init()` step.
- */
-declare interface ChromeBrowser {
-    /**
-     * Extension action surface — observe and invoke installed Chrome extension actions.
-     */
-    readonly Actions: ChromeBrowserActions;
-}
+/* Excluded from this release type: ChromeBrowser */
 
 /**
  * APIs for interacting with Chromium extension actions from an initialized ChromeBrowser window.
@@ -3886,14 +3890,7 @@ declare type ConstWindowOptions = {
      * @default false
      */
     backgroundThrottling: boolean;
-    /**
-     * If `true`, the window is registered with Chromium as a `ChromeBrowser`,
-     * making it visible to Chrome extensions via the `chrome.windows` API.
-     * The window must be created with this option set; it cannot be flipped at runtime.
-     *
-     * @defaultValue false
-     */
-    chromeBrowser: boolean;
+    /* Excluded from this release type: chromeBrowser */
     /**
      * Configures how new content (e,g, from `window.open` or a link) is opened.
      */
@@ -5639,6 +5636,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin.Identity;
+    /**
+     * Recommended placement for the auto-created View. This is complementary to `disposition`, which
+     * describes the requested browser creation behavior.
+     */
+    destination: WebContentsEvents.ChildViewDestination;
     /**
      * Identity of the view that was active when the extension triggered tab creation.
      * Undefined if no tab was active (e.g. the first tab in a newly-opened window).
@@ -6386,7 +6388,7 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin.ChromeBrowser;
+    /* Excluded from this release type: ChromeBrowser */
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
      * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
@@ -19889,6 +19891,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/out/fdc3-api.d.ts

@@ -3139,12 +3139,31 @@ declare interface ChildContentOptions {
  */
 declare type ChildViewCreatedEvent = ContentCreationRulesEvent & {
     type: 'child-view-created';
+    /**
+     * Recommended placement for the already-created child View.
+     *
+     * This is complementary to `disposition`: `disposition` describes the requested browser creation
+     * behavior, while `destination` describes where the resulting View should be placed.
+     */
+    destination: ChildViewDestination;
     /**
      * The options the child View was created with.
      */
     childOptions: OpenFin.ViewOptions;
 };
 
+/**
+ * Describes where an already-created View should be placed.
+ */
+declare type ChildViewDestination = {
+    /** Add the View to this existing window. */
+    type: 'existing-window';
+    identity: OpenFin.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3163,9 +3182,16 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
 /**
  * Client-side handle for the chrome-browser feature.
  *
- * For Chrome extension integration to be active on a window, that window must be
- * created with `chromeBrowser: true` in its window options. There is no separate
- * `init()` step.
+ * For extension integration to be active on a window, that window must be
+ * created with `chromeBrowser: true` in its window options.
+ *
+ * @remarks
+ * This namespace is intended for internal experimentation only. Enabling the
+ * `chromeBrowser` window option changes how the runtime manages content and standard
+ * OpenFin content behavior is not guaranteed.
+ *
+ * @internal
+ * @experimental This API is under active development and may change or be removed without notice.
  */
 declare interface ChromeBrowser {
     /**
@@ -3946,13 +3972,27 @@ declare type ConstWindowOptions = {
      */
     backgroundThrottling: boolean;
     /**
-     * If `true`, the window is registered with Chromium as a `ChromeBrowser`,
-     * making it visible to Chrome extensions via the `chrome.windows` API.
-     * The window must be created with this option set; it cannot be flipped at runtime.
+     * Registers the window with Chromium as a `ChromeBrowser`, making it visible to
+     * Chrome extensions via the `chrome.windows` API. The window must be created with
+     * this option set; it cannot be flipped at runtime.
+     *
+     * Pass `true` (equivalent to `{ type: 'normal' }`) to register as a normal tabbed
+     * chrome-browser host, or `{ type: 'popup' }` to register as a popup chrome-browser
+     * host (no tab strip; the window's own content is the single tab) — the same
+     * registration that `window.open` popups and extension popups receive internally.
+     *
+     * @remarks
+     * Enabling this option changes how Chromium manages the window's content. Standard
+     * OpenFin content behavior is not guaranteed; for example, configured
+     * {@link ContentCreationOptions content creation rules} will no longer be respected.
      *
+     * @internal
+     * @experimental This option is under active development and may change or be removed without notice.
      * @defaultValue false
      */
-    chromeBrowser: boolean;
+    chromeBrowser: boolean | {
+        type: 'normal' | 'popup';
+    };
     /**
      * Configures how new content (e,g, from `window.open` or a link) is opened.
      */
@@ -5721,6 +5761,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin.Identity;
+    /**
+     * Recommended placement for the auto-created View. This is complementary to `disposition`, which
+     * describes the requested browser creation behavior.
+     */
+    destination: WebContentsEvents.ChildViewDestination;
     /**
      * Identity of the view that was active when the extension triggered tab creation.
      * Undefined if no tab was active (e.g. the first tab in a newly-opened window).
@@ -6471,6 +6516,12 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
+    /**
+     * Internal, experimental APIs for Chrome extension integration.
+     *
+     * @internal
+     * @experimental This API may change or be removed without notice.
+     */
     readonly ChromeBrowser: OpenFin.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
@@ -20356,6 +20407,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/package.json

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