@openfin/fdc3-api 44.100.48 → 44.100.49

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

@@ -4976,7 +4976,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.
@@ -8932,6 +8932,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.
@@ -9843,6 +9879,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.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -10234,6 +10342,8 @@ declare namespace OpenFin {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -13159,6 +13269,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin.ThemePreferences;
+    }, OpenFin.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -16205,6 +16319,84 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin.ServeAssetOptions): Promise<OpenFin.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.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.ThemePreferences): Promise<OpenFin.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -16248,6 +16440,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16371,6 +16564,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.
@@ -16395,6 +16589,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)
@@ -16516,6 +16711,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/fdc3-api-beta.d.ts

@@ -4976,7 +4976,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.
@@ -8932,6 +8932,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.
@@ -9843,6 +9879,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.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -10234,6 +10342,8 @@ declare namespace OpenFin {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -13159,6 +13269,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin.ThemePreferences;
+    }, OpenFin.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -16205,6 +16319,84 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin.ServeAssetOptions): Promise<OpenFin.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.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.ThemePreferences): Promise<OpenFin.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -16248,6 +16440,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16371,6 +16564,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.
@@ -16395,6 +16589,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)
@@ -16516,6 +16711,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/fdc3-api-public.d.ts

@@ -4976,7 +4976,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.
@@ -8932,6 +8932,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.
@@ -9843,6 +9879,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.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -10234,6 +10342,8 @@ declare namespace OpenFin {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -13159,6 +13269,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin.ThemePreferences;
+    }, OpenFin.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -16205,6 +16319,84 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin.ServeAssetOptions): Promise<OpenFin.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.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.ThemePreferences): Promise<OpenFin.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -16248,6 +16440,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16371,6 +16564,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.
@@ -16395,6 +16589,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)
@@ -16516,6 +16711,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/fdc3-api.d.ts

@@ -5040,7 +5040,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.
@@ -9066,7 +9066,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.
@@ -9241,6 +9241,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.
@@ -10164,6 +10200,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.NativeTheme;
+};
+
 /**
  * @interface
  */
@@ -10568,6 +10676,8 @@ declare namespace OpenFin {
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -13576,6 +13686,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: any;
         response: any;
     };
+    'set-theme-preferences': ApiCall<{
+        preferences: OpenFin.ThemePreferences;
+    }, OpenFin.NativeTheme>;
+    'get-theme-preferences': GetterCall<OpenFin.NativeTheme>;
     'get-version': GetterCall<string>;
     'clear-cache': ApiCall<OpenFin.ClearCacheOption, void>;
     'delete-cache-request': VoidCall;
@@ -16628,6 +16742,84 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * Not indended for general use, will be used by the `@openfin/workspace-platform` package.
      */
     serveAsset(options: OpenFin.ServeAssetOptions): Promise<OpenFin.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.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.ThemePreferences): Promise<OpenFin.ThemePreferences>;
     /**
      * Launches the Log Uploader. Full documentation can be found [here](https://resources.here.io/docs/core/develop/debug/log-uploader/).
      * @experimental
@@ -16671,6 +16863,7 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16801,6 +16994,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.
@@ -16825,6 +17019,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)
@@ -16946,6 +17141,11 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */

package/package.json

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