@openfin/core 46.100.35 → 46.100.36

package/out/mock-alpha.d.ts

@@ -3086,12 +3086,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_2.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_2.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3104,22 +3123,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin_2.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.
@@ -3889,14 +3893,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.
      */
@@ -5642,6 +5639,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin_2.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).
@@ -6044,7 +6046,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin_2.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.
@@ -19443,6 +19445,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/out/mock-beta.d.ts

@@ -3086,12 +3086,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_2.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_2.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3104,22 +3123,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin_2.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.
@@ -3889,14 +3893,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.
      */
@@ -5642,6 +5639,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin_2.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).
@@ -6044,7 +6046,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin_2.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.
@@ -19443,6 +19445,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/out/mock-public.d.ts

@@ -3086,12 +3086,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_2.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_2.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3104,22 +3123,7 @@ declare type ChildWindowCreatedEvent = ContentCreationRulesEvent & {
     childOptions: OpenFin_2.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.
@@ -3889,14 +3893,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.
      */
@@ -5642,6 +5639,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin_2.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).
@@ -6044,7 +6046,7 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
     readonly Interop: InteropModule;
     readonly SnapshotSource: SnapshotSourceModule;
     readonly NotificationManager: NotificationManagerModule;
-    readonly ChromeBrowser: OpenFin_2.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.
@@ -19443,6 +19445,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/out/stub.d.ts

@@ -3142,12 +3142,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_2.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_2.Identity;
+} | {
+    /** Create a new window containing the View. */
+    type: 'new-window';
+};
+
 /**
  * Generated when a child Window is created.
  * @interface
@@ -3166,9 +3185,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 {
     /**
@@ -3949,13 +3975,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.
      */
@@ -5724,6 +5764,11 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
     type: 'extension-tab-created';
     /** Identity of the auto-created view backing the new tab. */
     viewIdentity: OpenFin_2.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).
@@ -6129,6 +6174,12 @@ declare interface FinApi<MeType extends OpenFin_2.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_2.ChromeBrowser;
     /**
      * Provides access to the OpenFin representation of the current code context (usually an entity
@@ -19910,6 +19961,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,

package/out/stub.js

@@ -16789,8 +16789,14 @@ _ChromeBrowserActionsImpl_wire = new WeakMap(), _ChromeBrowserActionsImpl_state
  * Client-side handle for the chrome-browser feature on the current window.
  *
  * The window must have been created with `chromeBrowser: true` for these APIs to do
- * anything meaningful — there is no separate `init()` step. From a view or a non
+ * anything meaningful. From a view or a non
  * chrome-browser window, calls into `Actions` will resolve to empty results.
+ *
+ * Enabling the `chromeBrowser` window option changes how the runtime manages content,
+ * and standard OpenFin content behavior is not guaranteed.
+ *
+ * @internal
+ * @experimental This API may change or be removed without notice.
  */
 class ChromeBrowserModule {
     constructor(wire, isWindow) {

package/out/stub.mjs

@@ -16785,8 +16785,14 @@ _ChromeBrowserActionsImpl_wire = new WeakMap(), _ChromeBrowserActionsImpl_state
  * Client-side handle for the chrome-browser feature on the current window.
  *
  * The window must have been created with `chromeBrowser: true` for these APIs to do
- * anything meaningful — there is no separate `init()` step. From a view or a non
+ * anything meaningful. From a view or a non
  * chrome-browser window, calls into `Actions` will resolve to empty results.
+ *
+ * Enabling the `chromeBrowser` window option changes how the runtime manages content,
+ * and standard OpenFin content behavior is not guaranteed.
+ *
+ * @internal
+ * @experimental This API may change or be removed without notice.
  */
 class ChromeBrowserModule {
     constructor(wire, isWindow) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/core",
-  "version": "46.100.35",
+  "version": "46.100.36",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",