@openfin/fdc3-api 43.100.104 → 43.100.106

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

@@ -91,6 +91,34 @@ declare type AnalyticsProtocolMap = {
     [k in AnalyticsOnlyCalls]: VoidCall;
 };
 
+/**
+ * Represents an anchor configuration consisting of a bounding rectangle
+ * and an anchor point describing which part of that rectangle should be
+ * used as the reference for positioning the download bubble.
+ * @interface
+ */
+declare type Anchor = {
+    /**
+     * The DOM or screen-space rectangle that defines the anchor area.
+     */
+    bounds: Rectangle;
+    /**
+     *  The location within the rectangle that should act as the anchor
+     *   (e.g., `topRight`, `bottomLeft`, `center`, etc.).
+     * For example, `topRight` means the rectangle's top-right corner is used
+     * as the anchoring reference point.
+     */
+    location: AnchorLocation;
+};
+
+/**
+ * Defines the point within the rectangle that should be used as the anchor
+ * when positioning UI elements relative to another surface.
+ *
+ * @interface
+ */
+declare type AnchorLocation = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'leftTop' | 'rightTop' | 'leftBottom' | 'rightBottom' | 'topCenter' | 'bottomCenter' | 'leftCenter' | 'rightCenter' | 'none' | 'float';
+
 declare type AnchorType = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 
 declare type AnyStrategy = ChannelStrategy<any>;
@@ -1389,6 +1417,56 @@ declare type ApplicationWindowInfo = {
     uuid: string;
 };
 
+/**
+ * `appLogLevel` allows the verbosity of app logs that are collected for a Window or View to be controlled  when the app logging feature is enabled for its application.
+ *
+ * Please note, `enableAppLogging` must be specified in the application manifest's `platform` or `startup_app` key for this feature to be activated.
+ *
+ * If not specified, and `enableAppLogging` is true for the application, the default level will be 'silent'.
+ *
+ * This setting can also be specified in a Domain Setting Rule, allowing per url exceptions to the default behavior to be made. Please note, when a domain setting is actively
+ * controlling a url's appLogLevel, its options will be ignored.
+ *
+ * @default 'debug'
+ *
+ * @example Controlling App Logs With DefaultViewOptions + Domain Settings
+ *
+ * In this example manifest, we use `defaultViewOptions to set the default verbosity to 'warn'.
+ *
+ * We also use domain settings to suppress logs entirely for an example URL, and to lower verbosity to 'debug' for another.
+ *
+ * ```ts
+ * {
+ *   <rest of settings>
+ *   "platform": {
+ *      <rest of settings>
+ *     "enableAppLogging": "true",
+ *     "defaultViewOptions": {
+ *       "appLogLevel": "warn"
+ *     },
+ *     "domainSettings": {
+ *        "default": {  <rest of settings> }
+ *        "rules": [
+ *           <rest of rules>
+ *          {
+ *               "match": ["*://*?app-logging-level=silent"],
+ *               "options": {
+ *                  "appLogLevel": "silent"
+ *               }
+ *           },
+ *          {
+ *               "match": ["*://*?app-logging-level=debug"],
+ *               "options": {
+ *                  "appLogLevel": "debug"
+ *               }
+ *           },
+ *        ]
+ *     }
+ *   }
+ * }
+ */
+declare type AppLogLevel = 'silent' | 'debug' | 'info' | 'warn' | 'error';
+
 /**
  * @interface
  */
@@ -3864,6 +3942,10 @@ declare type ConstWindowOptions = {
      * Controls whether frameless window should have rounded corners. Default is false for Windows and true for MacOS. Setting this property to false will prevent the window from being fullscreenable on macOS. On Windows versions older than Windows 11 Build 22000 this property has no effect, and frameless windows will not have rounded corners.
      */
     roundedCorners: boolean;
+    /**
+     * Configuration for download bubble UI.
+     */
+    downloadBubble?: DownloadBubbleOptions;
 };
 
 /**
@@ -4616,6 +4698,50 @@ declare type DomainSettingsRule = {
     matchOptions?: RuleMatchOptions;
 };
 
+/**
+ * Configuration options for enabling and positioning the download bubble UI.
+ * @interface
+ */
+declare type DownloadBubbleOptions = {
+    /**
+     * Whether the download bubble feature is enabled.
+     */
+    enabled: boolean;
+    /**
+     * Anchor configuration describing where the download bubble should attach.
+     */
+    anchor: Anchor;
+};
+
+/**
+ * Generated when the download button icon needs to be updated. Only raised if the download bubble feature is enabled.
+ *
+ * @interface
+ */
+declare type DownloadButtonIconUpdatedEvent = BaseEvent_5 & {
+    type: 'download-button-icon-updated';
+    disabled: boolean;
+    active: boolean;
+    touchMode: boolean;
+    progressIndicatorState: 'idle' | 'scanning' | 'downloading' | 'dormant';
+    progressDownloadCount: number;
+    progressPercentage: number;
+    buttonTooltip: string;
+};
+
+/**
+ * Generated when the visibility of the window's download button changes. Only raised if the download bubble feature is enabled.
+ *
+ * @interface
+ */
+declare type DownloadButtonVisibilityChangedEvent = BaseEvent_5 & {
+    type: 'download-button-visibility-changed';
+    /**
+     * True if the download button should be displayed, false if it should be hidden.
+     */
+    visible: boolean;
+};
+
 /**
  * Metadata returned from a preload script download request.
  *
@@ -4675,6 +4801,7 @@ declare type DownloadRule = {
  *
  * @remarks This will control the styling for the download shelf regardless of whether its display was
  * triggered by the window itself, or a view targeting the window.
+ * @deprecated Use the DownloadBubble API instead.
  */
 declare type DownloadShelfOptions = {
     /**
@@ -4710,6 +4837,7 @@ declare type DownloadShelfOptions = {
  * Generated when the visibility of the window's download shelf changes.
  *
  * @interface
+ * @deprecated use DownloadBubble API instead
  */
 declare type DownloadShelfVisibilityChangedEvent = BaseEvent_5 & {
     type: 'download-shelf-visibility-changed';
@@ -4976,7 +5104,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 | ThemePaletteChangedEvent | 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 +9060,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 behavior occurs, in which excess tabs appear in a menu.
+         *
+         * Setting this to `scroll` might break styles written for the default dropdown behavior, as it significantly changes the DOM structure and CSS of tabs.
+         *
+         * The DOM structure is modified in this way:
+         * - `lm_tabs` is wrapped in a div with class `lm_scroll_shadow`. This div is revealed by a mask on the tabs when they are overflowing.
+         * - the `.newTabButton` (if enabled) is 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 targeting only Chrome 137 or greater, you might 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.
@@ -9039,6 +9203,12 @@ declare type LogInfo = {
  */
 declare type LogLevel = 'verbose' | 'info' | 'warning' | 'error' | 'fatal';
 
+declare type LogPath = 'debug.log' | 'app.log';
+
+declare type LogTarget = {
+    type: LogPath;
+};
+
 /**
  * Log types
  *
@@ -9184,6 +9354,7 @@ declare type Manifest = {
         policies?: {
             CloudAPAuthEnabled?: 'enabled' | 'disabled';
         };
+        themePalette?: Array<ThemePalette>;
     };
     services?: string[];
     shortcut?: {
@@ -9557,6 +9728,10 @@ declare type MutableViewOptions = {
      * {@inheritDoc ChromiumPolicies}
      */
     chromiumPolicies: ChromiumPolicies;
+    /**
+     * Specifies the AppLogLevel for the specified View. See {@link AppLogLevel} for more information.
+     */
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -9831,6 +10006,10 @@ declare type MutableWindowOptions = {
      * {@inheritDoc ChromiumPolicies}
      */
     chromiumPolicies: ChromiumPolicies;
+    /**
+     * Specifies the AppLogLevel for the Window. See {@link AppLogLevel} for more information.
+     */
+    appLogLevel?: AppLogLevel;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -9843,6 +10022,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
  */
@@ -10128,6 +10379,9 @@ declare namespace OpenFin {
         CustomProtocolOptions,
         InteropBrokerOptions,
         ContextGroupInfo,
+        AnchorLocation,
+        Anchor,
+        DownloadBubbleOptions,
         DisplayMetadata,
         LegacyWinOptionsInAppOptions,
         Snapshot,
@@ -10154,6 +10408,9 @@ declare namespace OpenFin {
         InheritableOptions,
         PolicyOptions,
         ChromiumPolicies,
+        AppLogLevel,
+        LogPath,
+        LogTarget,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10231,9 +10488,14 @@ declare namespace OpenFin {
         LogUploaderUIOptions,
         LogTypes,
         LogUploadOptions,
+        ThemeColorsMap,
+        ThemeColorId,
+        ThemePalette,
         Manifest,
         LayoutContent,
         LayoutItemConfig,
+        ThemePreferences,
+        NativeTheme,
         LayoutRow,
         LayoutColumn,
         LayoutComponent,
@@ -10453,6 +10715,7 @@ declare namespace OpenFin {
         ChannelProviderDisconnectionListener,
         RoutingInfo,
         DownloadShelfOptions,
+        SnapZoneOptions,
         ViewShowAtOptions,
         WebNotificationProperties,
         WebNotificationInfo,
@@ -10727,6 +10990,11 @@ declare type PerDomainSettings = {
          */
         drag?: 'allow' | 'block';
     };
+    /**
+     * Allows the app log level of any matching content to be overriden.
+     * See also {@link AppLogLevel} for more information.
+     */
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -12364,7 +12632,7 @@ declare type PositioningOptions = {
 /**
  * Context menu item with an implementation provided by OpenFin.
  */
-declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | 'copy' | 'copyImage' | 'paste' | 'selectAll' | 'spellCheck' | 'inspect' | 'reload' | 'navigateForward' | 'navigateBack' | 'print';
+declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | 'copy' | 'copyImage' | 'paste' | 'selectAll' | 'spellCheck' | 'inspect' | 'reload' | 'navigateForward' | 'navigateBack' | 'print' | 'snapToTop' | 'snapToBottom';
 
 /**
  * A script that is run before page load.
@@ -13062,6 +13330,12 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'create-window': VoidCall;
     'get-current-window': VoidCall;
     'get-current-window-sync': VoidCall;
+    'show-download-bubble': IdentityCall<{
+        anchor?: OpenFin.Anchor;
+    }, void>;
+    'update-download-bubble-anchor': IdentityCall<{
+        anchor: OpenFin.Anchor;
+    }, void>;
     'get-external-application-info': ApiCall<OpenFin.ApplicationIdentity, OpenFin.ExternalApplicationInfo>;
     'external-application-wrap': VoidCall;
     'external-application-wrap-sync': VoidCall;
@@ -13158,6 +13432,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;
@@ -13245,6 +13523,9 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'write-to-log': ApiCall<{
         level: string;
         message: string;
+        target?: {
+            type?: 'app.log' | 'debug.log';
+        };
     }, void>;
     'open-url-with-browser': ApiCall<{
         url: string;
@@ -13408,6 +13689,15 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
         request: void;
         response: OpenFin.ExtensionInfo[];
     };
+    'set-theme-palette': ApiCall<{
+        themePalette: Array<OpenFin.ThemePalette>;
+    }, void> & {
+        themePalette: Array<OpenFin.ThemePalette>;
+    };
+    'get-theme-palette': ApiCall<void, Array<OpenFin.ThemePalette>> & {
+        request: void;
+        response: Array<OpenFin.ThemePalette>;
+    };
     'fdc3-add-context-listener': VoidCall;
     'fdc3-add-intent-listener': VoidCall;
     'fdc3-raise-intent': VoidCall;
@@ -14483,6 +14773,15 @@ declare type Size = TransitionBase & {
     height: number;
 };
 
+/**
+ * Generated when a window is snapped to a screen edge.
+ * @interface
+ */
+declare type SnappedEvent = BoundsEvent & {
+    type: 'snapped';
+    snapLocation: 'top' | 'bottom';
+};
+
 /**
  * @interface
  */
@@ -14627,6 +14926,52 @@ declare class SnapshotSourceModule extends Base {
     wrap(identity: OpenFin.ApplicationIdentity): Promise<SnapshotSource>;
 }
 
+/**
+ * Generated when a window enters or exits a snap zone during drag.
+ * This event fires whenever the snap zone state changes (entry or exit).
+ * @interface
+ */
+declare type SnapZoneChangedEvent = BaseEvent_5 & {
+    type: 'snap-zone-changed';
+    /**
+     * Array of locations that the window is currently in snap zones for.
+     * Empty array indicates the window is not in any snap zone.
+     * Can contain multiple locations if the window is in multiple zones simultaneously.
+     */
+    locations: Array<'top' | 'bottom'>;
+};
+
+/**
+ * @interface
+ *
+ * Configures snap zone behavior for a window. When enabled, the window will automatically snap to screen edges
+ * when dragged near them during user drag interactions.
+ */
+declare type SnapZoneOptions = {
+    /**
+     * Whether snap zone functionality is enabled for this window.
+     *
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * The distance in pixels from the screen edge that triggers the snap zone.
+     * When the window is dragged within this threshold of the top or bottom edge,
+     * it will be considered in a snap zone.
+     *
+     * @default 50
+     */
+    threshold?: number;
+    /**
+     * Ordered array of edge preferences when the window is in multiple snap zones simultaneously.
+     * The first edge in the array that the window is in will be used for snapping.
+     * If not provided, defaults to ['top', 'bottom'] (preferring top over bottom).
+     *
+     * @default ['top', 'bottom']
+     */
+    locationPreference?: Array<'top' | 'bottom'>;
+};
+
 /**
  * Generated when an application has started.
  * @interface
@@ -15404,13 +15749,14 @@ declare class System extends EmitterBase<OpenFin.SystemEvent> {
      * Writes the passed message into both the log file and the console.
      * @param level The log level for the entry. Can be either "info", "warning" or "error"
      * @param message The log message text
+     * @param target The log stream this message will be sent to, defaults to 'debug.log'. Specify 'app.log' to log to the app log of the sending View / Window. Note, when using `app.log`, it will always log to app.log irrespective of the `enableAppLogging` setting for the sender. This is particularly useful if you wish to log certain things from a View / Window but ignore generic console logs.
      *
      * @example
      * ```js
-     * fin.System.log("info", "An example log message").then(() => console.log('Log info message')).catch(err => console.log(err));
+     * fin.System.log("info", "An example log message", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level: string, message: string): Promise<void>;
+    log(level: string, message: string, target?: OpenFin.LogTarget): Promise<void>;
     /**
      * Opens the passed URL in the default web browser.
      *
@@ -16149,11 +16495,123 @@ 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
      */
     launchLogUploader(options: OpenFin.LogUploaderOptions): Promise<void>;
+    /**
+     *  Overrides original Chromium theme color providers matching key (currently except high contrast ones). Only colors passed in the map will be overridden.
+     * @param overrides - Array of ColorProviderOverrides objects
+     * @example
+     * ```ts
+     * await fin.System.setThemePalette([
+     * {
+     *   colorProviderKey: { colorMode: 'light' },
+     *   colorsMap: {
+     *     kColorLabelForeground: 4278190080,
+     *     kColorBubbleBackground: 4293980400
+     *     }
+     *   },
+     *   {
+     *     colorProviderKey: { colorMode: 'dark' },
+     *     colorsMap: {
+     *       kColorLabelForeground: 4293980400,
+     *       kColorBubbleBackground: 4293980400
+     *     }
+     *   }
+     * ]);
+     * ```
+     */
+    setThemePalette(themePalette: Array<OpenFin.ThemePalette>): Promise<void>;
+    /**
+     * Retrieves currently used color overrides
+     * @returns Array of ColorProviderOverrides objects
+     * @example
+     * ```ts
+     * const themePalette = await fin.System.getThemePalette();
+     * console.log(themePalette);
+     * ```
+     */
+    getThemePalette(): Promise<Array<OpenFin.ThemePalette>>;
 }
 
 /**
@@ -16192,6 +16650,8 @@ declare namespace SystemEvents {
         ExtensionsInstallFailedEvent,
         ExtensionInstallFailedEvent,
         ExtensionsInitializationFailedEvent,
+        ThemePaletteChangedEvent,
+        NativeThemeUpdatedEvent,
         Event_11 as Event,
         SystemEvent,
         EventType_8 as EventType,
@@ -16315,6 +16775,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.
@@ -16339,6 +16800,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)
@@ -16460,6 +16922,109 @@ declare type TerminateExternalRequestType = {
     killTree: boolean;
 };
 
+/**
+ * String literal type of all supported theme color IDs.
+ * Useful wherever you need to refer to a color slot by name.
+ * @interface
+ */
+declare type ThemeColorId = keyof ThemeColorsMap;
+
+/**
+ * All supported color slots for the Download Bubble and related UI.
+ * @interface
+ */
+declare interface ThemeColorsMap {
+    /**
+     * Enterprise/Window/Background – bubble header and footer background.
+     */
+    kColorBubbleBackground?: number;
+    /**
+     * Windows only – Enterprise/Window/Border.
+     */
+    kColorBubbleBorder?: number;
+    /**
+     * Windows only – Enterprise/Window/Border (large shadow).
+     */
+    kColorBubbleBorderShadowLarge?: number;
+    /**
+     * Windows only – Enterprise/Window/Border (small shadow).
+     */
+    kColorBubbleBorderShadowSmall?: number;
+    /**
+     * Enterprise/Window/Background – downloaded item row background.
+     */
+    kColorDialogBackground?: number;
+    /**
+     * Enterprise/Search Result/Background/Hover – download item row hover.
+     */
+    kColorDownloadBubbleRowHover?: number;
+    /**
+     * Enterprise/Window/Icon – “Show all downloads” icon color.
+     */
+    kColorDownloadBubbleShowAllDownloadsIcon?: number;
+    /**
+     * Enterprise/Search Result/Background/Hover – full download history
+     * button (full row) hover background.
+     */
+    kColorHoverButtonBackgroundHovered?: number;
+    /**
+     * Shared/Icon Button/Subtle/Icon/Default – SVG icon color
+     * (except full download history button).
+     */
+    kColorIcon?: number;
+    /**
+     * Enterprise/Window/Text/Base – main label text color.
+     * May be post-processed to increase readability on kColorDialogBackground
+     * (can be disabled via transparent kColorLabelBackground).
+     */
+    kColorLabelForeground?: number;
+    /**
+     * Label background used for readability adjustment.
+     * Set to transparent (0) to disable Chromium’s readability alignment logic.
+     */
+    kColorLabelBackground?: number;
+    /**
+     * Enterprise/Window/Text/Soft – secondary text color.
+     * May be post-processed to increase readability on kColorDialogBackground
+     * (can be disabled via transparent kColorLabelBackground).
+     */
+    kColorSecondaryForeground?: number;
+}
+
+/**
+ * Defines a set of color overrides for Chromium UI surfaces based on a theme
+ * provider (e.g., light or dark mode).
+ * @interface
+ */
+declare type ThemePalette = {
+    /**
+     * Identifies the color provider mode that the palette applies to.
+     */
+    colorProviderKey: {
+        /**
+         * The UI color mode that this palette is intended to style.
+         */
+        colorMode: 'light' | 'dark';
+    };
+    /**
+     * A mapping of known Chromium color IDs to ARGB values (0xAARRGGBB).
+     */
+    colorsMap: ThemeColorsMap;
+};
+
+/**
+ * An event that fires when the system theme palette is changed.
+ */
+declare type ThemePaletteChangedEvent = BaseEvent_9 & {
+    type: 'theme-palette-changed';
+    themePalette: OpenFin.ThemePalette;
+};
+
+/**
+ * Settable options for the native theme of the operating system.
+ */
+declare type ThemePreferences = Pick<NativeTheme, 'themeSource'>;
+
 /**
  * @interface
  */
@@ -19753,6 +20318,62 @@ declare class _Window extends WebContents<OpenFin.WindowEvent> {
      * To print the views embedded in their page context, set `content` to `screenshot`.
      */
     print(options?: OpenFin.WindowPrintOptions): Promise<void>;
+    /**
+     * Displays the download bubble UI. If an anchor is provided, the bubble
+     * will be positioned according to the specified rectangle and anchor point.
+     *
+     * @param {OpenFin.Anchor} options
+     *   Anchor configuration used to position the download bubble. This includes
+     *   the bounding rectangle and the anchor location within that rectangle.
+     *
+     * @returns {Promise<void>}
+     *   A promise that resolves once the request to show the download bubble
+     *   has been processed.
+     * @example
+     * ```js
+     * const w = fin.Window.getCurrentSync();
+     * const el = document.getElementById("download-bubble-button");
+     * const rect = el.getBoundingClientRect();
+     * const anchor = {
+     *     bounds: rect,
+     *     location: "topRight"
+     * };
+     * w.showDownloadBubble(anchor);
+     * ```
+     */
+    showDownloadBubble(anchor?: OpenFin.Anchor): Promise<void>;
+    /**
+     * Updates the anchor used for positioning the download bubble. This allows
+     * moving the bubble reactively—for example, in response to window resizes,
+     * layout changes, or DOM element repositioning.
+     *
+     * @param {OpenFin.Anchor} options
+     *   New anchor configuration describing the updated position and anchor
+     *   location for the download bubble.
+     *
+     * @returns {Promise<void>}
+     *   A promise that resolves once the anchor update has been applied.
+     * @example
+     * ```js
+     * var w = fin.Window.getCurrentSync();
+     * w.on('download-button-visibility-changed', (evt) => {
+     *     if (evt.visible) {
+     *         const el = document.getElementById("download-bubble-button");
+     *         //We show our button and get it's bounding rect
+     *         el.classList.remove("hidden");
+     *         const rect = el.getBoundingClientRect();
+     *         const anchor = {
+     *            bounds: rect,
+     *            location: "topRight"
+     *          }
+     *          w.updateDownloadBubbleAnchor(anchor);
+     *     } else {
+     *        //We hide our button
+     *         document.getElementById("download-bubble-button")?.classList.add("hidden");
+     * }
+     });
+     */
+    updateDownloadBubbleAnchor(anchor: OpenFin.Anchor): Promise<void>;
 }
 
 /**
@@ -19907,6 +20528,8 @@ declare namespace WindowEvents {
         BoundsChangingEvent,
         DisabledMovementBoundsChangedEvent,
         DisabledMovementBoundsChangingEvent,
+        SnappedEvent,
+        SnapZoneChangedEvent,
         UserBoundsChangeEvent,
         BeginUserBoundsChangingEvent,
         EndUserBoundsChangingEvent,
@@ -19946,6 +20569,8 @@ declare namespace WindowEvents {
         NonPropagatedWindowEvent,
         ShowAllDownloadsEvent,
         DownloadShelfVisibilityChangedEvent,
+        DownloadButtonVisibilityChangedEvent,
+        DownloadButtonIconUpdatedEvent,
         WindowSourcedEvent,
         WillPropagateWindowEvent,
         Event_6 as Event,
@@ -20149,7 +20774,7 @@ declare type WindowShowRequestedEvent = ShowRequestedEvent;
  * A union of all events that emit natively on the `Window` topic, i.e. excluding those that propagate
  * from {@link OpenFin.ViewEvents}.
  */
-declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent;
+declare type WindowSourcedEvent = WebContentsEvents.Event<'window'> | WindowViewEvent | AuthRequestedEvent | BeginUserBoundsChangingEvent | BoundsChangedEvent | BoundsChangingEvent | ContextChangedEvent | CloseRequestedEvent | ClosedEvent_2 | ClosingEvent | DisabledMovementBoundsChangedEvent | DisabledMovementBoundsChangingEvent | EmbeddedEvent | EndUserBoundsChangingEvent | ExternalProcessExitedEvent | ExternalProcessStartedEvent | HiddenEvent_2 | HotkeyEvent_2 | InitializedEvent_2 | LayoutInitializedEvent | LayoutReadyEvent | LayoutCreatedEvent | LayoutDestroyedEvent | LayoutSnapshotAppliedEvent | MaximizedEvent | MinimizedEvent | OptionsChangedEvent | PerformanceReportEvent | PreloadScriptsStateChangedEvent | PreloadScriptsStateChangingEvent | ReloadedEvent | RestoredEvent | ShowRequestedEvent | ShownEvent_2 | UserMovementDisabledEvent | UserMovementEnabledEvent | WillMoveEvent | WillResizeEvent | ShowAllDownloadsEvent | DownloadShelfVisibilityChangedEvent | DownloadButtonVisibilityChangedEvent | DownloadButtonIconUpdatedEvent | SnappedEvent | SnapZoneChangedEvent;
 
 /**
  * Generated when a child window starts loading.