@openfin/core 44.100.48 → 44.100.49

package/out/mock-alpha.d.ts

@@ -4979,7 +4979,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent | NativeThemeUpdatedEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by the HTMLElement Layout container.
@@ -8590,6 +8590,42 @@ declare type LayoutOptions = {
          */
         preventDragIn?: boolean;
         /* Excluded from this release type: disableTabOverflowDropdown */
+        /**
+         * When set to 'scroll', enables horizontal scrolling of tabs when they overflow the stack width.
+         * When set to 'dropdown' the default golden-layouts behavior will apply.
+         *
+         * Setting this to `scroll` may break styles written for the default dropdown behavior, as it significantly changes the dom structure and css of tabs.
+         *
+         * The DOM structure will be modified in this way:
+         * - `lm_tabs` will be wrapped in a div with class `lm_scroll_shadow`. This div will be revealed by a mask on the tabs when they are overflowing.
+         * - the `.newTabButton` (if enabled) will be a direct child of `.lm_header`
+         *
+         * **The following css variables are available to customize tab appearance:**
+         *
+         * - `--layout-tab-width`: The default (max) width of the tabs. Using this enables using `lm_tab` as a queryable css container (must be an absolute value to use container queries). Default: `fit-content`
+         * - `--layout-tab-min-width`: The minimum width of the tabs before they start overflowing. Set this to enable tab shrinking. Defaults to the same value as `--layout-tab-width` (no shrinking).
+         * - `--layout-tab-overflow-fade-size`: The width of the scroll shadows when tabs are overflowing. Default: `20px`
+         * - `--layout-tab-overflow-shadow-color`: The color of the scroll shadows when tabs are overflowing. Enabling a contrasting shadow color may require setting the background color on `.lm_tabs` if it was not previously set via `--tabs-background-color`. Default is transparent so overlowing tabs fade into the background.
+         *
+         * **CSS Variables for advanced customization (dynamically updated and set on `lm_tabs`):**
+         *
+         * - `--layout-tab-overflow-fade-left`: The strength of the left fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tab-overflow-fade-right`: The strength of the right fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tabs-overflowing`: A [css space toggle](https://css-tricks.com/the-css-custom-property-toggle-trick/) that is empty when tabs are overflowing and `initial` otherwise. If you are only targeting Chrome > 137 you may want to use the `if()` function with left/right fade instead of this toggle.
+         *
+         * @example
+         * ```css
+         * .lm_tabs {
+         *   --layout-tab-width: 200px;
+         *   --layout-tab-min-width: 100px;
+         *   --layout-tab-overflow-fade-size: 20px;
+         *   --layout-tab-overflow-shadow-color: rgba(0, 0, 0, 0.3);
+         * }
+         * ```
+         *
+         * @defaultValue 'dropdown'
+         */
+        tabOverflowBehavior?: 'dropdown' | 'scroll';
     };
     /**
      * Content of the layout. There can only be one top-level LayoutItem in the content array.
@@ -9501,6 +9537,78 @@ declare type NamedEvent = IdentityEvent & {
     name: string;
 };
 
+/**
+ * @interface
+ *
+ * Represents the native theme of the operating system.
+ * This is used to determine how the application should render its UI based on the system's theme settings.
+ * Defer to CSS properties whenever possible.
+ *
+ * Re-exported from Electron's `NativeTheme` type.
+ */
+declare type NativeTheme = {
+    /**
+     * A `boolean` indicating whether Chromium is in forced colors mode, controlled by
+     * system accessibility settings. Currently, Windows high contrast is the only
+     * system setting that triggers forced colors mode.
+     *
+     * @platform win32
+     */
+    inForcedColorsMode: boolean;
+    /**
+     * A `boolean` that indicates the whether the user has chosen via system
+     * accessibility settings to reduce transparency at the OS level.
+     *
+     */
+    prefersReducedTransparency: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has a dark mode enabled or is
+     * being instructed to show a dark-style UI.  If you want to modify this value you
+     * should use `themeSource` below.
+     *
+     */
+    shouldUseDarkColors: boolean;
+    /**
+     * A `boolean` property indicating whether or not the system theme has been set to
+     * dark or light.
+     *
+     * On Windows this property distinguishes between system and app light/dark theme,
+     * returning `true` if the system theme is set to dark theme and `false` otherwise.
+     * On macOS the return value will be the same as `nativeTheme.shouldUseDarkColors`.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseDarkColorsForSystemIntegratedUI: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has high-contrast mode enabled or
+     * is being instructed to show a high-contrast UI.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseHighContrastColors: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has an inverted color scheme or
+     * is being instructed to use an inverted color scheme.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseInvertedColorScheme: boolean;
+    /**
+     * A `string` property that can be `system`, `light` or `dark`.  It is used (via `setTheme) to
+     * override and supersede the value that Chromium has chosen to use internally.
+     */
+    themeSource: 'system' | 'light' | 'dark';
+};
+
+/**
+ * Generated when the operating system's theme preferences change.
+ * Occurs when dark mode, high contrast mode, or inverted color scheme settings are modified.
+ */
+declare type NativeThemeUpdatedEvent = BaseEvent_9 & {
+    type: 'native-theme-updated';
+    theme: OpenFin_2.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -9892,6 +10000,8 @@ declare namespace OpenFin_2 {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -12819,6 +12929,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin_2.ThemePreferences;
+    }, OpenFin_2.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -15865,6 +15979,84 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin_2.ServeAssetOptions): Promise<OpenFin_2.ServedAssetInfo>;
+    /**
+     * Get's the native theme preferences for the current runtime.
+     * Prefer css media-queries wherever possible, but this can be useful to see if the system setting has been overridden.
+     * See @link OpenFin.NativeTheme for more information.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    getThemePreferences(): Promise<OpenFin_2.NativeTheme>;
+    /**
+     * Sets the native theme preferences for the current runtime.
+     * Can be used to force runtime-wide light or dark mode.
+     * @important Due to this impacting all applications on a runtime, this method is only usable if a security realm has been set.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    setThemePreferences(preferences: OpenFin_2.ThemePreferences): Promise<OpenFin_2.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -15908,6 +16100,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16031,6 +16224,7 @@ declare class TabStack extends LayoutNode {
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * If that happens and then getViews() is called, it will return the identities in a different order than
      * than the currently rendered tab order.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      *
      * @throws If the {@link TabStack} has been destroyed.
@@ -16055,6 +16249,7 @@ declare class TabStack extends LayoutNode {
      *
      * @remarks Known Issue: If adding a view overflows the tab-container, the added view will be set as active
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      * @param view The identity of an existing view to add, or options to create a view.
      * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
@@ -16176,6 +16371,11 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */

package/out/mock-beta.d.ts

@@ -4979,7 +4979,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent | NativeThemeUpdatedEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by the HTMLElement Layout container.
@@ -8590,6 +8590,42 @@ declare type LayoutOptions = {
          */
         preventDragIn?: boolean;
         /* Excluded from this release type: disableTabOverflowDropdown */
+        /**
+         * When set to 'scroll', enables horizontal scrolling of tabs when they overflow the stack width.
+         * When set to 'dropdown' the default golden-layouts behavior will apply.
+         *
+         * Setting this to `scroll` may break styles written for the default dropdown behavior, as it significantly changes the dom structure and css of tabs.
+         *
+         * The DOM structure will be modified in this way:
+         * - `lm_tabs` will be wrapped in a div with class `lm_scroll_shadow`. This div will be revealed by a mask on the tabs when they are overflowing.
+         * - the `.newTabButton` (if enabled) will be a direct child of `.lm_header`
+         *
+         * **The following css variables are available to customize tab appearance:**
+         *
+         * - `--layout-tab-width`: The default (max) width of the tabs. Using this enables using `lm_tab` as a queryable css container (must be an absolute value to use container queries). Default: `fit-content`
+         * - `--layout-tab-min-width`: The minimum width of the tabs before they start overflowing. Set this to enable tab shrinking. Defaults to the same value as `--layout-tab-width` (no shrinking).
+         * - `--layout-tab-overflow-fade-size`: The width of the scroll shadows when tabs are overflowing. Default: `20px`
+         * - `--layout-tab-overflow-shadow-color`: The color of the scroll shadows when tabs are overflowing. Enabling a contrasting shadow color may require setting the background color on `.lm_tabs` if it was not previously set via `--tabs-background-color`. Default is transparent so overlowing tabs fade into the background.
+         *
+         * **CSS Variables for advanced customization (dynamically updated and set on `lm_tabs`):**
+         *
+         * - `--layout-tab-overflow-fade-left`: The strength of the left fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tab-overflow-fade-right`: The strength of the right fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tabs-overflowing`: A [css space toggle](https://css-tricks.com/the-css-custom-property-toggle-trick/) that is empty when tabs are overflowing and `initial` otherwise. If you are only targeting Chrome > 137 you may want to use the `if()` function with left/right fade instead of this toggle.
+         *
+         * @example
+         * ```css
+         * .lm_tabs {
+         *   --layout-tab-width: 200px;
+         *   --layout-tab-min-width: 100px;
+         *   --layout-tab-overflow-fade-size: 20px;
+         *   --layout-tab-overflow-shadow-color: rgba(0, 0, 0, 0.3);
+         * }
+         * ```
+         *
+         * @defaultValue 'dropdown'
+         */
+        tabOverflowBehavior?: 'dropdown' | 'scroll';
     };
     /**
      * Content of the layout. There can only be one top-level LayoutItem in the content array.
@@ -9501,6 +9537,78 @@ declare type NamedEvent = IdentityEvent & {
     name: string;
 };
 
+/**
+ * @interface
+ *
+ * Represents the native theme of the operating system.
+ * This is used to determine how the application should render its UI based on the system's theme settings.
+ * Defer to CSS properties whenever possible.
+ *
+ * Re-exported from Electron's `NativeTheme` type.
+ */
+declare type NativeTheme = {
+    /**
+     * A `boolean` indicating whether Chromium is in forced colors mode, controlled by
+     * system accessibility settings. Currently, Windows high contrast is the only
+     * system setting that triggers forced colors mode.
+     *
+     * @platform win32
+     */
+    inForcedColorsMode: boolean;
+    /**
+     * A `boolean` that indicates the whether the user has chosen via system
+     * accessibility settings to reduce transparency at the OS level.
+     *
+     */
+    prefersReducedTransparency: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has a dark mode enabled or is
+     * being instructed to show a dark-style UI.  If you want to modify this value you
+     * should use `themeSource` below.
+     *
+     */
+    shouldUseDarkColors: boolean;
+    /**
+     * A `boolean` property indicating whether or not the system theme has been set to
+     * dark or light.
+     *
+     * On Windows this property distinguishes between system and app light/dark theme,
+     * returning `true` if the system theme is set to dark theme and `false` otherwise.
+     * On macOS the return value will be the same as `nativeTheme.shouldUseDarkColors`.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseDarkColorsForSystemIntegratedUI: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has high-contrast mode enabled or
+     * is being instructed to show a high-contrast UI.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseHighContrastColors: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has an inverted color scheme or
+     * is being instructed to use an inverted color scheme.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseInvertedColorScheme: boolean;
+    /**
+     * A `string` property that can be `system`, `light` or `dark`.  It is used (via `setTheme) to
+     * override and supersede the value that Chromium has chosen to use internally.
+     */
+    themeSource: 'system' | 'light' | 'dark';
+};
+
+/**
+ * Generated when the operating system's theme preferences change.
+ * Occurs when dark mode, high contrast mode, or inverted color scheme settings are modified.
+ */
+declare type NativeThemeUpdatedEvent = BaseEvent_9 & {
+    type: 'native-theme-updated';
+    theme: OpenFin_2.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -9892,6 +10000,8 @@ declare namespace OpenFin_2 {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -12819,6 +12929,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin_2.ThemePreferences;
+    }, OpenFin_2.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -15865,6 +15979,84 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin_2.ServeAssetOptions): Promise<OpenFin_2.ServedAssetInfo>;
+    /**
+     * Get's the native theme preferences for the current runtime.
+     * Prefer css media-queries wherever possible, but this can be useful to see if the system setting has been overridden.
+     * See @link OpenFin.NativeTheme for more information.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    getThemePreferences(): Promise<OpenFin_2.NativeTheme>;
+    /**
+     * Sets the native theme preferences for the current runtime.
+     * Can be used to force runtime-wide light or dark mode.
+     * @important Due to this impacting all applications on a runtime, this method is only usable if a security realm has been set.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    setThemePreferences(preferences: OpenFin_2.ThemePreferences): Promise<OpenFin_2.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -15908,6 +16100,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16031,6 +16224,7 @@ declare class TabStack extends LayoutNode {
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * If that happens and then getViews() is called, it will return the identities in a different order than
      * than the currently rendered tab order.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      *
      * @throws If the {@link TabStack} has been destroyed.
@@ -16055,6 +16249,7 @@ declare class TabStack extends LayoutNode {
      *
      * @remarks Known Issue: If adding a view overflows the tab-container, the added view will be set as active
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      * @param view The identity of an existing view to add, or options to create a view.
      * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
@@ -16176,6 +16371,11 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */

package/out/mock-public.d.ts

@@ -4979,7 +4979,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent | NativeThemeUpdatedEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by the HTMLElement Layout container.
@@ -8590,6 +8590,42 @@ declare type LayoutOptions = {
          */
         preventDragIn?: boolean;
         /* Excluded from this release type: disableTabOverflowDropdown */
+        /**
+         * When set to 'scroll', enables horizontal scrolling of tabs when they overflow the stack width.
+         * When set to 'dropdown' the default golden-layouts behavior will apply.
+         *
+         * Setting this to `scroll` may break styles written for the default dropdown behavior, as it significantly changes the dom structure and css of tabs.
+         *
+         * The DOM structure will be modified in this way:
+         * - `lm_tabs` will be wrapped in a div with class `lm_scroll_shadow`. This div will be revealed by a mask on the tabs when they are overflowing.
+         * - the `.newTabButton` (if enabled) will be a direct child of `.lm_header`
+         *
+         * **The following css variables are available to customize tab appearance:**
+         *
+         * - `--layout-tab-width`: The default (max) width of the tabs. Using this enables using `lm_tab` as a queryable css container (must be an absolute value to use container queries). Default: `fit-content`
+         * - `--layout-tab-min-width`: The minimum width of the tabs before they start overflowing. Set this to enable tab shrinking. Defaults to the same value as `--layout-tab-width` (no shrinking).
+         * - `--layout-tab-overflow-fade-size`: The width of the scroll shadows when tabs are overflowing. Default: `20px`
+         * - `--layout-tab-overflow-shadow-color`: The color of the scroll shadows when tabs are overflowing. Enabling a contrasting shadow color may require setting the background color on `.lm_tabs` if it was not previously set via `--tabs-background-color`. Default is transparent so overlowing tabs fade into the background.
+         *
+         * **CSS Variables for advanced customization (dynamically updated and set on `lm_tabs`):**
+         *
+         * - `--layout-tab-overflow-fade-left`: The strength of the left fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tab-overflow-fade-right`: The strength of the right fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tabs-overflowing`: A [css space toggle](https://css-tricks.com/the-css-custom-property-toggle-trick/) that is empty when tabs are overflowing and `initial` otherwise. If you are only targeting Chrome > 137 you may want to use the `if()` function with left/right fade instead of this toggle.
+         *
+         * @example
+         * ```css
+         * .lm_tabs {
+         *   --layout-tab-width: 200px;
+         *   --layout-tab-min-width: 100px;
+         *   --layout-tab-overflow-fade-size: 20px;
+         *   --layout-tab-overflow-shadow-color: rgba(0, 0, 0, 0.3);
+         * }
+         * ```
+         *
+         * @defaultValue 'dropdown'
+         */
+        tabOverflowBehavior?: 'dropdown' | 'scroll';
     };
     /**
      * Content of the layout. There can only be one top-level LayoutItem in the content array.
@@ -9501,6 +9537,78 @@ declare type NamedEvent = IdentityEvent & {
     name: string;
 };
 
+/**
+ * @interface
+ *
+ * Represents the native theme of the operating system.
+ * This is used to determine how the application should render its UI based on the system's theme settings.
+ * Defer to CSS properties whenever possible.
+ *
+ * Re-exported from Electron's `NativeTheme` type.
+ */
+declare type NativeTheme = {
+    /**
+     * A `boolean` indicating whether Chromium is in forced colors mode, controlled by
+     * system accessibility settings. Currently, Windows high contrast is the only
+     * system setting that triggers forced colors mode.
+     *
+     * @platform win32
+     */
+    inForcedColorsMode: boolean;
+    /**
+     * A `boolean` that indicates the whether the user has chosen via system
+     * accessibility settings to reduce transparency at the OS level.
+     *
+     */
+    prefersReducedTransparency: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has a dark mode enabled or is
+     * being instructed to show a dark-style UI.  If you want to modify this value you
+     * should use `themeSource` below.
+     *
+     */
+    shouldUseDarkColors: boolean;
+    /**
+     * A `boolean` property indicating whether or not the system theme has been set to
+     * dark or light.
+     *
+     * On Windows this property distinguishes between system and app light/dark theme,
+     * returning `true` if the system theme is set to dark theme and `false` otherwise.
+     * On macOS the return value will be the same as `nativeTheme.shouldUseDarkColors`.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseDarkColorsForSystemIntegratedUI: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has high-contrast mode enabled or
+     * is being instructed to show a high-contrast UI.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseHighContrastColors: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has an inverted color scheme or
+     * is being instructed to use an inverted color scheme.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseInvertedColorScheme: boolean;
+    /**
+     * A `string` property that can be `system`, `light` or `dark`.  It is used (via `setTheme) to
+     * override and supersede the value that Chromium has chosen to use internally.
+     */
+    themeSource: 'system' | 'light' | 'dark';
+};
+
+/**
+ * Generated when the operating system's theme preferences change.
+ * Occurs when dark mode, high contrast mode, or inverted color scheme settings are modified.
+ */
+declare type NativeThemeUpdatedEvent = BaseEvent_9 & {
+    type: 'native-theme-updated';
+    theme: OpenFin_2.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -9892,6 +10000,8 @@ declare namespace OpenFin_2 {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -12819,6 +12929,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin_2.ThemePreferences;
+    }, OpenFin_2.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -15865,6 +15979,84 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin_2.ServeAssetOptions): Promise<OpenFin_2.ServedAssetInfo>;
+    /**
+     * Get's the native theme preferences for the current runtime.
+     * Prefer css media-queries wherever possible, but this can be useful to see if the system setting has been overridden.
+     * See @link OpenFin.NativeTheme for more information.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    getThemePreferences(): Promise<OpenFin_2.NativeTheme>;
+    /**
+     * Sets the native theme preferences for the current runtime.
+     * Can be used to force runtime-wide light or dark mode.
+     * @important Due to this impacting all applications on a runtime, this method is only usable if a security realm has been set.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    setThemePreferences(preferences: OpenFin_2.ThemePreferences): Promise<OpenFin_2.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -15908,6 +16100,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16031,6 +16224,7 @@ declare class TabStack extends LayoutNode {
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * If that happens and then getViews() is called, it will return the identities in a different order than
      * than the currently rendered tab order.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      *
      * @throws If the {@link TabStack} has been destroyed.
@@ -16055,6 +16249,7 @@ declare class TabStack extends LayoutNode {
      *
      * @remarks Known Issue: If adding a view overflows the tab-container, the added view will be set as active
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      * @param view The identity of an existing view to add, or options to create a view.
      * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
@@ -16176,6 +16371,11 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */

package/out/stub.d.ts

@@ -5043,7 +5043,7 @@ declare type Event_10 = ApplicationEvents.Event | ApiReadyEvent | SnapshotApplie
  *  under the {@link OpenFin.SystemEvents} namespace (payloads inherited from propagated events are defined in the namespace
  *  from which they propagate).
  */
-declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent;
+declare type Event_11 = ExcludeRequested<WindowEvents.PropagatedEvent<'system'>> | ExcludeRequested<ViewEvents.PropagatedEvent<'system'>> | ExcludeRequested<ApplicationEvents.PropagatedEvent<'system'>> | ApplicationCreatedEvent | DesktopIconClickedEvent | IdleStateChangedEvent | MonitorInfoChangedEvent | SessionChangedEvent | AppVersionEventWithId | SystemShutdownEvent | ExtensionsEnabledEvent | ExtensionsDisabledEvent | ExtensionsExcludedEvent | ExtensionsInstalledEvent | ExtensionInstalledEvent | ExtensionsInstallFailedEvent | ExtensionInstallFailedEvent | ExtensionsInitializationFailedEvent | NativeThemeUpdatedEvent;
 
 /**
  * [Union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types) containing every possible event that can be emitted by the HTMLElement Layout container.
@@ -8724,7 +8724,7 @@ declare abstract class LayoutNode {
      * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
      * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
-     * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      * @param views The views that will populate the new TabStack.
      * @param options Additional options that control new TabStack creation.
@@ -8899,6 +8899,42 @@ declare type LayoutOptions = {
          * @defaultValue false
          */
         disableTabOverflowDropdown?: boolean;
+        /**
+         * When set to 'scroll', enables horizontal scrolling of tabs when they overflow the stack width.
+         * When set to 'dropdown' the default golden-layouts behavior will apply.
+         *
+         * Setting this to `scroll` may break styles written for the default dropdown behavior, as it significantly changes the dom structure and css of tabs.
+         *
+         * The DOM structure will be modified in this way:
+         * - `lm_tabs` will be wrapped in a div with class `lm_scroll_shadow`. This div will be revealed by a mask on the tabs when they are overflowing.
+         * - the `.newTabButton` (if enabled) will be a direct child of `.lm_header`
+         *
+         * **The following css variables are available to customize tab appearance:**
+         *
+         * - `--layout-tab-width`: The default (max) width of the tabs. Using this enables using `lm_tab` as a queryable css container (must be an absolute value to use container queries). Default: `fit-content`
+         * - `--layout-tab-min-width`: The minimum width of the tabs before they start overflowing. Set this to enable tab shrinking. Defaults to the same value as `--layout-tab-width` (no shrinking).
+         * - `--layout-tab-overflow-fade-size`: The width of the scroll shadows when tabs are overflowing. Default: `20px`
+         * - `--layout-tab-overflow-shadow-color`: The color of the scroll shadows when tabs are overflowing. Enabling a contrasting shadow color may require setting the background color on `.lm_tabs` if it was not previously set via `--tabs-background-color`. Default is transparent so overlowing tabs fade into the background.
+         *
+         * **CSS Variables for advanced customization (dynamically updated and set on `lm_tabs`):**
+         *
+         * - `--layout-tab-overflow-fade-left`: The strength of the left fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tab-overflow-fade-right`: The strength of the right fade when tabs are overflowing. This is a number between 0 and 1 where 0 means no fade and 1 means a full fade.
+         * - `--layout-tabs-overflowing`: A [css space toggle](https://css-tricks.com/the-css-custom-property-toggle-trick/) that is empty when tabs are overflowing and `initial` otherwise. If you are only targeting Chrome > 137 you may want to use the `if()` function with left/right fade instead of this toggle.
+         *
+         * @example
+         * ```css
+         * .lm_tabs {
+         *   --layout-tab-width: 200px;
+         *   --layout-tab-min-width: 100px;
+         *   --layout-tab-overflow-fade-size: 20px;
+         *   --layout-tab-overflow-shadow-color: rgba(0, 0, 0, 0.3);
+         * }
+         * ```
+         *
+         * @defaultValue 'dropdown'
+         */
+        tabOverflowBehavior?: 'dropdown' | 'scroll';
     };
     /**
      * Content of the layout. There can only be one top-level LayoutItem in the content array.
@@ -9822,6 +9858,78 @@ declare type NamedEvent = IdentityEvent & {
     name: string;
 };
 
+/**
+ * @interface
+ *
+ * Represents the native theme of the operating system.
+ * This is used to determine how the application should render its UI based on the system's theme settings.
+ * Defer to CSS properties whenever possible.
+ *
+ * Re-exported from Electron's `NativeTheme` type.
+ */
+declare type NativeTheme = {
+    /**
+     * A `boolean` indicating whether Chromium is in forced colors mode, controlled by
+     * system accessibility settings. Currently, Windows high contrast is the only
+     * system setting that triggers forced colors mode.
+     *
+     * @platform win32
+     */
+    inForcedColorsMode: boolean;
+    /**
+     * A `boolean` that indicates the whether the user has chosen via system
+     * accessibility settings to reduce transparency at the OS level.
+     *
+     */
+    prefersReducedTransparency: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has a dark mode enabled or is
+     * being instructed to show a dark-style UI.  If you want to modify this value you
+     * should use `themeSource` below.
+     *
+     */
+    shouldUseDarkColors: boolean;
+    /**
+     * A `boolean` property indicating whether or not the system theme has been set to
+     * dark or light.
+     *
+     * On Windows this property distinguishes between system and app light/dark theme,
+     * returning `true` if the system theme is set to dark theme and `false` otherwise.
+     * On macOS the return value will be the same as `nativeTheme.shouldUseDarkColors`.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseDarkColorsForSystemIntegratedUI: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has high-contrast mode enabled or
+     * is being instructed to show a high-contrast UI.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseHighContrastColors: boolean;
+    /**
+     * A `boolean` for if the OS / Chromium currently has an inverted color scheme or
+     * is being instructed to use an inverted color scheme.
+     *
+     * @platform darwin,win32
+     */
+    shouldUseInvertedColorScheme: boolean;
+    /**
+     * A `string` property that can be `system`, `light` or `dark`.  It is used (via `setTheme) to
+     * override and supersede the value that Chromium has chosen to use internally.
+     */
+    themeSource: 'system' | 'light' | 'dark';
+};
+
+/**
+ * Generated when the operating system's theme preferences change.
+ * Occurs when dark mode, high contrast mode, or inverted color scheme settings are modified.
+ */
+declare type NativeThemeUpdatedEvent = BaseEvent_9 & {
+    type: 'native-theme-updated';
+    theme: OpenFin_2.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -10226,6 +10334,8 @@ declare namespace OpenFin_2 {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -13236,6 +13346,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin_2.ThemePreferences;
+    }, OpenFin_2.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin_2.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin_2.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -16288,6 +16402,84 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin_2.ServeAssetOptions): Promise<OpenFin_2.ServedAssetInfo>;
+    /**
+     * Get's the native theme preferences for the current runtime.
+     * Prefer css media-queries wherever possible, but this can be useful to see if the system setting has been overridden.
+     * See @link OpenFin.NativeTheme for more information.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    getThemePreferences(): Promise<OpenFin_2.NativeTheme>;
+    /**
+     * Sets the native theme preferences for the current runtime.
+     * Can be used to force runtime-wide light or dark mode.
+     * @important Due to this impacting all applications on a runtime, this method is only usable if a security realm has been set.
+     * @example Theme selector menu
+     * ```ts
+     async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+     const currentTheme = await fin.System.getThemePreferences();
+     const result = await (fin.me as OpenFin.Window).showPopupMenu({
+     x: e.clientX,
+     y: e.clientY,
+     template: [
+     {
+     label: 'Light',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'light',
+     data: { themeSource: 'light' } as const
+     },
+     {
+     label: 'Dark',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'dark',
+     data: { themeSource: 'dark' } as const
+     },
+     {
+     label: 'System',
+     type: 'checkbox',
+     checked: currentTheme.themeSource === 'system',
+     data: { themeSource: 'system' } as const
+     }
+     ]
+     });
+     if (result.result === 'clicked') {
+     await fin.System.setThemePreferences(result.data);
+     }
+     }
+     ```
+     */
+    setThemePreferences(preferences: OpenFin_2.ThemePreferences): Promise<OpenFin_2.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -16331,6 +16523,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16461,6 +16654,7 @@ declare class TabStack extends LayoutNode {
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
      * If that happens and then getViews() is called, it will return the identities in a different order than
      * than the currently rendered tab order.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      *
      * @throws If the {@link TabStack} has been destroyed.
@@ -16485,6 +16679,7 @@ declare class TabStack extends LayoutNode {
      *
      * @remarks Known Issue: If adding a view overflows the tab-container, the added view will be set as active
      * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+     * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
      *
      * @param view The identity of an existing view to add, or options to create a view.
      * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)
@@ -16606,6 +16801,11 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */

package/out/stub.js

@@ -7287,6 +7287,88 @@ class System extends base_1$m.EmitterBase {
     async serveAsset(options) {
         return (await this.wire.sendAction('serve-asset', { options })).payload.data;
     }
+    /**
+     * Get's the native theme preferences for the current runtime.
+     * Prefer css media-queries wherever possible, but this can be useful to see if the system setting has been overridden.
+     * See @link OpenFin.NativeTheme for more information.
+     * @example Theme selector menu
+     * ```ts
+    async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+        const currentTheme = await fin.System.getThemePreferences();
+        const result = await (fin.me as OpenFin.Window).showPopupMenu({
+            x: e.clientX,
+            y: e.clientY,
+            template: [
+                {
+                    label: 'Light',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'light',
+                    data: { themeSource: 'light' } as const
+                },
+                {
+                    label: 'Dark',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'dark',
+                    data: { themeSource: 'dark' } as const
+                },
+                {
+                    label: 'System',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'system',
+                    data: { themeSource: 'system' } as const
+                }
+            ]
+        });
+        if (result.result === 'clicked') {
+            await fin.System.setThemePreferences(result.data);
+        }
+    }
+    ```
+     */
+    async getThemePreferences() {
+        return (await this.wire.sendAction('get-theme-preferences')).payload.data;
+    }
+    /**
+     * Sets the native theme preferences for the current runtime.
+     * Can be used to force runtime-wide light or dark mode.
+     * @important Due to this impacting all applications on a runtime, this method is only usable if a security realm has been set.
+     * @example Theme selector menu
+     * ```ts
+    async function handleThemeMenu(e: React.MouseEvent<HTMLDivElement>) {
+        const currentTheme = await fin.System.getThemePreferences();
+        const result = await (fin.me as OpenFin.Window).showPopupMenu({
+            x: e.clientX,
+            y: e.clientY,
+            template: [
+                {
+                    label: 'Light',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'light',
+                    data: { themeSource: 'light' } as const
+                },
+                {
+                    label: 'Dark',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'dark',
+                    data: { themeSource: 'dark' } as const
+                },
+                {
+                    label: 'System',
+                    type: 'checkbox',
+                    checked: currentTheme.themeSource === 'system',
+                    data: { themeSource: 'system' } as const
+                }
+            ]
+        });
+        if (result.result === 'clicked') {
+            await fin.System.setThemePreferences(result.data);
+        }
+    }
+    ```
+     */
+    async setThemePreferences(preferences) {
+        return (await this.wire.sendAction('set-theme-preferences', { preferences })).payload.data;
+    }
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -11688,7 +11770,7 @@ class LayoutNode {
          * Known Issue: If the number of views to add overflows the tab-container, the added views will be set as active
          * during each render, and then placed at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
          * This means the views you pass to createAdjacentStack() may not render in the order given by the array.
-         * Until fixed, this problem can be avoided only if your window is wide enough to fit creating all the views in the tabstack.
+         * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
          *
          * @param views The views that will populate the new TabStack.
          * @param options Additional options that control new TabStack creation.
@@ -11824,6 +11906,7 @@ class TabStack extends LayoutNode {
          * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
          * If that happens and then getViews() is called, it will return the identities in a different order than
          * than the currently rendered tab order.
+         * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
          *
          *
          * @throws If the {@link TabStack} has been destroyed.
@@ -11848,6 +11931,7 @@ class TabStack extends LayoutNode {
          *
          * @remarks Known Issue: If adding a view overflows the tab-container, the added view will be set as active
          * and rendered at the front of the tab-stack, while the underlying order of tabs will remain unchanged.
+         * Note: This issue does not occur when using `tabOverflowBehavior: 'scroll'` in the layout configuration.
          *
          * @param view The identity of an existing view to add, or options to create a view.
          * @param options Optional view options: index number used to insert the view into the stack at that index. Defaults to 0 (front of the stack)

package/package.json

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