@openfin/core 45.100.103 → 45.100.105

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.
      */
@@ -3986,6 +3983,12 @@ declare type ConstWindowOptions = {
      * triggered by the window itself, or a view targeting the window.
      */
     downloadShelf: DownloadShelfOptions;
+    /**
+     * @defaultValue true
+     *
+     * Show the window's frame.
+     */
+    frame: boolean;
     height: number;
     layout: any;
     /**
@@ -5636,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).
@@ -5653,6 +5661,37 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
      * - `other` — any other or unrecognized Chromium disposition
      */
     disposition: OpenFin_2.ContentCreationDisposition;
+    /** Raw `window.open()` features string, if provided by `CreateContentsParams`. */
+    features: string;
+    /** Target frame name from `window.open(url, name)`, if provided. */
+    frameName: string;
+    /** Parsed window options derived from the features string. */
+    parsedFeatures: Partial<OpenFin_2.WindowOptions>;
+};
+
+/**
+ * Generated when an extension creates a popup window on this host window
+ * (e.g. via `chrome.windows.create({ type: 'popup' })`). The runtime
+ * auto-creates a backing View and ChromeBrowser; this event notifies the
+ * platform provider so it can create a registered OpenFin window.
+ * Only fires on windows created with `chromeBrowser: true`.
+ * @interface
+ */
+declare type ExtensionWindowCreatedEvent = BaseEvent_5 & {
+    type: 'extension-window-created';
+    /** Identity of the auto-created tab backing the popup window. */
+    tabIdentity: OpenFin_2.Identity;
+    /**
+     * Identity of the view that was active when the extension triggered window creation.
+     * Undefined if no tab was active.
+     */
+    activeTabIdentity?: OpenFin_2.Identity;
+    /** Initial URL the extension requested. */
+    url: string;
+    /** Always `'popup'` for extension-created popup windows. */
+    disposition: 'popup';
+    /** Options for the child window the platform provider should create. */
+    childOptions: Record<string, unknown>;
 };
 
 /**
@@ -6020,7 +6059,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.
@@ -9225,7 +9264,7 @@ declare type LayoutSyncApi = {
 /**
  * @interface
  */
-declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'frame' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
+declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
 
 declare type Listener<T extends {
     type: string;
@@ -9906,16 +9945,6 @@ declare type MutableWindowOptions = {
      * _When omitted, _inherits_ from the parent application._
      */
     customData: any;
-    /**
-     *
-     * Show the window's frame.
-     *
-     * @remarks
-     * This property will not be updatable starting runtime version 45.
-     *
-     * @default true
-     */
-    frame: boolean;
     /**
      * Hides the window instead of closing it when the close button is pressed.
      *
@@ -19533,6 +19562,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,
@@ -20892,6 +20922,7 @@ declare namespace WindowEvents {
         BaseWindowEvent,
         ViewAttachedEvent,
         ExtensionTabCreatedEvent,
+        ExtensionWindowCreatedEvent,
         ViewDetachedEvent,
         WindowViewEvent,
         AlertRequestedEvent,
@@ -21161,7 +21192,7 @@ declare type WindowShowRequestedEvent = ShowRequestedEvent;
  * A union of all events that emit natively on the `Window` topic, i.e. excluding those that propagate
  * from {@link OpenFin.ViewEvents}.
  */
-declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent;
+declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent | ExtensionWindowCreatedEvent;
 
 /**
  * Generated when a child window starts loading.

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.
      */
@@ -3986,6 +3983,12 @@ declare type ConstWindowOptions = {
      * triggered by the window itself, or a view targeting the window.
      */
     downloadShelf: DownloadShelfOptions;
+    /**
+     * @defaultValue true
+     *
+     * Show the window's frame.
+     */
+    frame: boolean;
     height: number;
     layout: any;
     /**
@@ -5636,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).
@@ -5653,6 +5661,37 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
      * - `other` — any other or unrecognized Chromium disposition
      */
     disposition: OpenFin_2.ContentCreationDisposition;
+    /** Raw `window.open()` features string, if provided by `CreateContentsParams`. */
+    features: string;
+    /** Target frame name from `window.open(url, name)`, if provided. */
+    frameName: string;
+    /** Parsed window options derived from the features string. */
+    parsedFeatures: Partial<OpenFin_2.WindowOptions>;
+};
+
+/**
+ * Generated when an extension creates a popup window on this host window
+ * (e.g. via `chrome.windows.create({ type: 'popup' })`). The runtime
+ * auto-creates a backing View and ChromeBrowser; this event notifies the
+ * platform provider so it can create a registered OpenFin window.
+ * Only fires on windows created with `chromeBrowser: true`.
+ * @interface
+ */
+declare type ExtensionWindowCreatedEvent = BaseEvent_5 & {
+    type: 'extension-window-created';
+    /** Identity of the auto-created tab backing the popup window. */
+    tabIdentity: OpenFin_2.Identity;
+    /**
+     * Identity of the view that was active when the extension triggered window creation.
+     * Undefined if no tab was active.
+     */
+    activeTabIdentity?: OpenFin_2.Identity;
+    /** Initial URL the extension requested. */
+    url: string;
+    /** Always `'popup'` for extension-created popup windows. */
+    disposition: 'popup';
+    /** Options for the child window the platform provider should create. */
+    childOptions: Record<string, unknown>;
 };
 
 /**
@@ -6020,7 +6059,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.
@@ -9225,7 +9264,7 @@ declare type LayoutSyncApi = {
 /**
  * @interface
  */
-declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'frame' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
+declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
 
 declare type Listener<T extends {
     type: string;
@@ -9906,16 +9945,6 @@ declare type MutableWindowOptions = {
      * _When omitted, _inherits_ from the parent application._
      */
     customData: any;
-    /**
-     *
-     * Show the window's frame.
-     *
-     * @remarks
-     * This property will not be updatable starting runtime version 45.
-     *
-     * @default true
-     */
-    frame: boolean;
     /**
      * Hides the window instead of closing it when the close button is pressed.
      *
@@ -19533,6 +19562,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,
@@ -20892,6 +20922,7 @@ declare namespace WindowEvents {
         BaseWindowEvent,
         ViewAttachedEvent,
         ExtensionTabCreatedEvent,
+        ExtensionWindowCreatedEvent,
         ViewDetachedEvent,
         WindowViewEvent,
         AlertRequestedEvent,
@@ -21161,7 +21192,7 @@ declare type WindowShowRequestedEvent = ShowRequestedEvent;
  * A union of all events that emit natively on the `Window` topic, i.e. excluding those that propagate
  * from {@link OpenFin.ViewEvents}.
  */
-declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent;
+declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent | ExtensionWindowCreatedEvent;
 
 /**
  * Generated when a child window starts loading.

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.
      */
@@ -3986,6 +3983,12 @@ declare type ConstWindowOptions = {
      * triggered by the window itself, or a view targeting the window.
      */
     downloadShelf: DownloadShelfOptions;
+    /**
+     * @defaultValue true
+     *
+     * Show the window's frame.
+     */
+    frame: boolean;
     height: number;
     layout: any;
     /**
@@ -5636,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).
@@ -5653,6 +5661,37 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
      * - `other` — any other or unrecognized Chromium disposition
      */
     disposition: OpenFin_2.ContentCreationDisposition;
+    /** Raw `window.open()` features string, if provided by `CreateContentsParams`. */
+    features: string;
+    /** Target frame name from `window.open(url, name)`, if provided. */
+    frameName: string;
+    /** Parsed window options derived from the features string. */
+    parsedFeatures: Partial<OpenFin_2.WindowOptions>;
+};
+
+/**
+ * Generated when an extension creates a popup window on this host window
+ * (e.g. via `chrome.windows.create({ type: 'popup' })`). The runtime
+ * auto-creates a backing View and ChromeBrowser; this event notifies the
+ * platform provider so it can create a registered OpenFin window.
+ * Only fires on windows created with `chromeBrowser: true`.
+ * @interface
+ */
+declare type ExtensionWindowCreatedEvent = BaseEvent_5 & {
+    type: 'extension-window-created';
+    /** Identity of the auto-created tab backing the popup window. */
+    tabIdentity: OpenFin_2.Identity;
+    /**
+     * Identity of the view that was active when the extension triggered window creation.
+     * Undefined if no tab was active.
+     */
+    activeTabIdentity?: OpenFin_2.Identity;
+    /** Initial URL the extension requested. */
+    url: string;
+    /** Always `'popup'` for extension-created popup windows. */
+    disposition: 'popup';
+    /** Options for the child window the platform provider should create. */
+    childOptions: Record<string, unknown>;
 };
 
 /**
@@ -6020,7 +6059,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.
@@ -9225,7 +9264,7 @@ declare type LayoutSyncApi = {
 /**
  * @interface
  */
-declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'frame' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
+declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
 
 declare type Listener<T extends {
     type: string;
@@ -9906,16 +9945,6 @@ declare type MutableWindowOptions = {
      * _When omitted, _inherits_ from the parent application._
      */
     customData: any;
-    /**
-     *
-     * Show the window's frame.
-     *
-     * @remarks
-     * This property will not be updatable starting runtime version 45.
-     *
-     * @default true
-     */
-    frame: boolean;
     /**
      * Hides the window instead of closing it when the close button is pressed.
      *
@@ -19533,6 +19562,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,
@@ -20892,6 +20922,7 @@ declare namespace WindowEvents {
         BaseWindowEvent,
         ViewAttachedEvent,
         ExtensionTabCreatedEvent,
+        ExtensionWindowCreatedEvent,
         ViewDetachedEvent,
         WindowViewEvent,
         AlertRequestedEvent,
@@ -21161,7 +21192,7 @@ declare type WindowShowRequestedEvent = ShowRequestedEvent;
  * A union of all events that emit natively on the `Window` topic, i.e. excluding those that propagate
  * from {@link OpenFin.ViewEvents}.
  */
-declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent;
+declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent | ExtensionWindowCreatedEvent;
 
 /**
  * Generated when a child window starts loading.

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.
      */
@@ -4045,6 +4085,12 @@ declare type ConstWindowOptions = {
      * triggered by the window itself, or a view targeting the window.
      */
     downloadShelf: DownloadShelfOptions;
+    /**
+     * @defaultValue true
+     *
+     * Show the window's frame.
+     */
+    frame: boolean;
     height: number;
     layout: any;
     /**
@@ -5718,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).
@@ -5735,6 +5786,37 @@ declare type ExtensionTabCreatedEvent = BaseEvent_5 & {
      * - `other` — any other or unrecognized Chromium disposition
      */
     disposition: OpenFin_2.ContentCreationDisposition;
+    /** Raw `window.open()` features string, if provided by `CreateContentsParams`. */
+    features: string;
+    /** Target frame name from `window.open(url, name)`, if provided. */
+    frameName: string;
+    /** Parsed window options derived from the features string. */
+    parsedFeatures: Partial<OpenFin_2.WindowOptions>;
+};
+
+/**
+ * Generated when an extension creates a popup window on this host window
+ * (e.g. via `chrome.windows.create({ type: 'popup' })`). The runtime
+ * auto-creates a backing View and ChromeBrowser; this event notifies the
+ * platform provider so it can create a registered OpenFin window.
+ * Only fires on windows created with `chromeBrowser: true`.
+ * @interface
+ */
+declare type ExtensionWindowCreatedEvent = BaseEvent_5 & {
+    type: 'extension-window-created';
+    /** Identity of the auto-created tab backing the popup window. */
+    tabIdentity: OpenFin_2.Identity;
+    /**
+     * Identity of the view that was active when the extension triggered window creation.
+     * Undefined if no tab was active.
+     */
+    activeTabIdentity?: OpenFin_2.Identity;
+    /** Initial URL the extension requested. */
+    url: string;
+    /** Always `'popup'` for extension-created popup windows. */
+    disposition: 'popup';
+    /** Options for the child window the platform provider should create. */
+    childOptions: Record<string, unknown>;
 };
 
 /**
@@ -6105,6 +6187,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
@@ -9534,7 +9622,7 @@ declare type LayoutSyncApi = {
 /**
  * @interface
  */
-declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'frame' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
+declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
 
 declare type Listener<T extends {
     type: string;
@@ -10219,16 +10307,6 @@ declare type MutableWindowOptions = {
      * _When omitted, _inherits_ from the parent application._
      */
     customData: any;
-    /**
-     *
-     * Show the window's frame.
-     *
-     * @remarks
-     * This property will not be updatable starting runtime version 45.
-     *
-     * @default true
-     */
-    frame: boolean;
     /**
      * Hides the window instead of closing it when the close button is pressed.
      *
@@ -20000,6 +20078,7 @@ declare namespace WebContentsEvents {
         ContentCreationRulesEvent,
         ChildContentBlockedEvent,
         ChildContentOpenedInBrowserEvent,
+        ChildViewDestination,
         ChildViewCreatedEvent,
         ChildWindowCreatedEvent,
         FileDownloadEvent,
@@ -21362,6 +21441,7 @@ declare namespace WindowEvents {
         BaseWindowEvent,
         ViewAttachedEvent,
         ExtensionTabCreatedEvent,
+        ExtensionWindowCreatedEvent,
         ViewDetachedEvent,
         WindowViewEvent,
         AlertRequestedEvent,
@@ -21631,7 +21711,7 @@ declare type WindowShowRequestedEvent = ShowRequestedEvent;
  * A union of all events that emit natively on the `Window` topic, i.e. excluding those that propagate
  * from {@link OpenFin.ViewEvents}.
  */
-declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent;
+declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent | ExtensionTabCreatedEvent | ExtensionWindowCreatedEvent;
 
 /**
  * Generated when a child window starts loading.

package/out/stub.js

@@ -16817,8 +16817,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

@@ -16813,8 +16813,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": "45.100.103",
+  "version": "45.100.105",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",