@openfin/core 43.100.105 → 43.100.109

package/out/mock-alpha.d.ts

@@ -1420,6 +1420,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
  */
@@ -6232,7 +6282,28 @@ declare type Hotkey = {
      */
     keys: string;
     /**
-     * Prevent default key handling before emitting the event.
+     * Controls the event phase at which the hotkey is triggered.
+     *
+     * - `'capture'`: The hotkey fires **before** the event is sent to the renderer/page.
+     * This is the only phase where the `preventDefault` property is effective.
+     *
+     * - `'bubble'`: The hotkey fires **after** the page has processed the key event.
+     * This behaves exactly like a standard JavaScript event listener attached to the window:
+     * 1. If the page calls `event.preventDefault()` (on either **keydown** or **keyup**), this hotkey will **not** fire.
+     * 2. If the hotkey is browser-reserved (e.g. `Ctrl+Tab` to switch tabs for which keyup/keydown do not fire in a web browser), that action takes precedence and this hotkey will **not** fire.
+     *
+     * @default 'capture'
+     */
+    phase?: 'capture' | 'bubble';
+    /**
+     * Determines if the event should continue to the renderer.
+     *
+     * - `true`: The event is consumed immediately. It will **never** reach the renderer/page.
+     * - `false`: The event is sent to the renderer after this hotkey executes.
+     *
+     * @remarks
+     * This property is **only valid** when `phase` is set to `'capture'`.
+     * If `phase` is `'bubble'`, this property is ignored (as the renderer has already received and processed the event).
      *
      * @default false
      */
@@ -8811,6 +8882,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
  *
@@ -9331,10 +9408,9 @@ declare type MutableViewOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this view.
-     * When omitted, inherits from the parent application.
+     * Specifies the AppLogLevel for the specified View. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -9610,11 +9686,9 @@ declare type MutableWindowOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
-     *
+     * Specifies the AppLogLevel for the Window. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -10013,6 +10087,9 @@ declare namespace OpenFin_2 {
         InheritableOptions,
         PolicyOptions,
         ChromiumPolicies,
+        AppLogLevel,
+        LogPath,
+        LogTarget,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10595,10 +10672,10 @@ declare type PerDomainSettings = {
         drag?: 'allow' | 'block';
     };
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
+     * Allows the app log level of any matching content to be overriden.
+     * See also {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -12935,10 +13012,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-current-window': VoidCall;
     'get-current-window-sync': VoidCall;
     'show-download-bubble': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor?: OpenFin_2.Anchor;
     }, void>;
     'update-download-bubble-anchor': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor: OpenFin_2.Anchor;
     }, void>;
     'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
     'external-application-wrap': VoidCall;
@@ -15353,16 +15430,14 @@ declare class System extends EmitterBase<OpenFin_2.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.type Optional. The 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.
+     * @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", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level: string, message: string, { type }?: {
-        type?: 'app.log' | 'debug.log';
-    }): Promise<void>;
+    log(level: string, message: string, target?: OpenFin_2.LogTarget): Promise<void>;
     /**
      * Opens the passed URL in the default web browser.
      *
@@ -16187,11 +16262,35 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     /**
      *  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_2.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_2.ThemePalette>>;
 }
@@ -19805,8 +19904,19 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    showDownloadBubble(anchor?: OpenFin_2.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,
@@ -19818,8 +19928,27 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      *
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    updateDownloadBubbleAnchor(anchor: OpenFin_2.Anchor): Promise<void>;
 }
 
 /**

package/out/mock-beta.d.ts

@@ -1420,6 +1420,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
  */
@@ -6232,7 +6282,28 @@ declare type Hotkey = {
      */
     keys: string;
     /**
-     * Prevent default key handling before emitting the event.
+     * Controls the event phase at which the hotkey is triggered.
+     *
+     * - `'capture'`: The hotkey fires **before** the event is sent to the renderer/page.
+     * This is the only phase where the `preventDefault` property is effective.
+     *
+     * - `'bubble'`: The hotkey fires **after** the page has processed the key event.
+     * This behaves exactly like a standard JavaScript event listener attached to the window:
+     * 1. If the page calls `event.preventDefault()` (on either **keydown** or **keyup**), this hotkey will **not** fire.
+     * 2. If the hotkey is browser-reserved (e.g. `Ctrl+Tab` to switch tabs for which keyup/keydown do not fire in a web browser), that action takes precedence and this hotkey will **not** fire.
+     *
+     * @default 'capture'
+     */
+    phase?: 'capture' | 'bubble';
+    /**
+     * Determines if the event should continue to the renderer.
+     *
+     * - `true`: The event is consumed immediately. It will **never** reach the renderer/page.
+     * - `false`: The event is sent to the renderer after this hotkey executes.
+     *
+     * @remarks
+     * This property is **only valid** when `phase` is set to `'capture'`.
+     * If `phase` is `'bubble'`, this property is ignored (as the renderer has already received and processed the event).
      *
      * @default false
      */
@@ -8811,6 +8882,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
  *
@@ -9331,10 +9408,9 @@ declare type MutableViewOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this view.
-     * When omitted, inherits from the parent application.
+     * Specifies the AppLogLevel for the specified View. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -9610,11 +9686,9 @@ declare type MutableWindowOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
-     *
+     * Specifies the AppLogLevel for the Window. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -10013,6 +10087,9 @@ declare namespace OpenFin_2 {
         InheritableOptions,
         PolicyOptions,
         ChromiumPolicies,
+        AppLogLevel,
+        LogPath,
+        LogTarget,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10595,10 +10672,10 @@ declare type PerDomainSettings = {
         drag?: 'allow' | 'block';
     };
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
+     * Allows the app log level of any matching content to be overriden.
+     * See also {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -12935,10 +13012,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-current-window': VoidCall;
     'get-current-window-sync': VoidCall;
     'show-download-bubble': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor?: OpenFin_2.Anchor;
     }, void>;
     'update-download-bubble-anchor': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor: OpenFin_2.Anchor;
     }, void>;
     'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
     'external-application-wrap': VoidCall;
@@ -15353,16 +15430,14 @@ declare class System extends EmitterBase<OpenFin_2.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.type Optional. The 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.
+     * @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", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level: string, message: string, { type }?: {
-        type?: 'app.log' | 'debug.log';
-    }): Promise<void>;
+    log(level: string, message: string, target?: OpenFin_2.LogTarget): Promise<void>;
     /**
      * Opens the passed URL in the default web browser.
      *
@@ -16187,11 +16262,35 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     /**
      *  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_2.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_2.ThemePalette>>;
 }
@@ -19805,8 +19904,19 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    showDownloadBubble(anchor?: OpenFin_2.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,
@@ -19818,8 +19928,27 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      *
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    updateDownloadBubbleAnchor(anchor: OpenFin_2.Anchor): Promise<void>;
 }
 
 /**

package/out/mock-public.d.ts

@@ -1420,6 +1420,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
  */
@@ -6232,7 +6282,28 @@ declare type Hotkey = {
      */
     keys: string;
     /**
-     * Prevent default key handling before emitting the event.
+     * Controls the event phase at which the hotkey is triggered.
+     *
+     * - `'capture'`: The hotkey fires **before** the event is sent to the renderer/page.
+     * This is the only phase where the `preventDefault` property is effective.
+     *
+     * - `'bubble'`: The hotkey fires **after** the page has processed the key event.
+     * This behaves exactly like a standard JavaScript event listener attached to the window:
+     * 1. If the page calls `event.preventDefault()` (on either **keydown** or **keyup**), this hotkey will **not** fire.
+     * 2. If the hotkey is browser-reserved (e.g. `Ctrl+Tab` to switch tabs for which keyup/keydown do not fire in a web browser), that action takes precedence and this hotkey will **not** fire.
+     *
+     * @default 'capture'
+     */
+    phase?: 'capture' | 'bubble';
+    /**
+     * Determines if the event should continue to the renderer.
+     *
+     * - `true`: The event is consumed immediately. It will **never** reach the renderer/page.
+     * - `false`: The event is sent to the renderer after this hotkey executes.
+     *
+     * @remarks
+     * This property is **only valid** when `phase` is set to `'capture'`.
+     * If `phase` is `'bubble'`, this property is ignored (as the renderer has already received and processed the event).
      *
      * @default false
      */
@@ -8811,6 +8882,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
  *
@@ -9331,10 +9408,9 @@ declare type MutableViewOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this view.
-     * When omitted, inherits from the parent application.
+     * Specifies the AppLogLevel for the specified View. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -9610,11 +9686,9 @@ declare type MutableWindowOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
-     *
+     * Specifies the AppLogLevel for the Window. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -10013,6 +10087,9 @@ declare namespace OpenFin_2 {
         InheritableOptions,
         PolicyOptions,
         ChromiumPolicies,
+        AppLogLevel,
+        LogPath,
+        LogTarget,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10595,10 +10672,10 @@ declare type PerDomainSettings = {
         drag?: 'allow' | 'block';
     };
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
+     * Allows the app log level of any matching content to be overriden.
+     * See also {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -12935,10 +13012,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-current-window': VoidCall;
     'get-current-window-sync': VoidCall;
     'show-download-bubble': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor?: OpenFin_2.Anchor;
     }, void>;
     'update-download-bubble-anchor': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor: OpenFin_2.Anchor;
     }, void>;
     'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
     'external-application-wrap': VoidCall;
@@ -15353,16 +15430,14 @@ declare class System extends EmitterBase<OpenFin_2.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.type Optional. The 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.
+     * @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", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level: string, message: string, { type }?: {
-        type?: 'app.log' | 'debug.log';
-    }): Promise<void>;
+    log(level: string, message: string, target?: OpenFin_2.LogTarget): Promise<void>;
     /**
      * Opens the passed URL in the default web browser.
      *
@@ -16187,11 +16262,35 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     /**
      *  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_2.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_2.ThemePalette>>;
 }
@@ -19805,8 +19904,19 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    showDownloadBubble(anchor?: OpenFin_2.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,
@@ -19818,8 +19928,27 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      *
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    updateDownloadBubbleAnchor(anchor: OpenFin_2.Anchor): Promise<void>;
 }
 
 /**

package/out/stub.d.ts

@@ -1426,6 +1426,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
  */
@@ -6323,7 +6373,28 @@ declare type Hotkey = {
      */
     keys: string;
     /**
-     * Prevent default key handling before emitting the event.
+     * Controls the event phase at which the hotkey is triggered.
+     *
+     * - `'capture'`: The hotkey fires **before** the event is sent to the renderer/page.
+     * This is the only phase where the `preventDefault` property is effective.
+     *
+     * - `'bubble'`: The hotkey fires **after** the page has processed the key event.
+     * This behaves exactly like a standard JavaScript event listener attached to the window:
+     * 1. If the page calls `event.preventDefault()` (on either **keydown** or **keyup**), this hotkey will **not** fire.
+     * 2. If the hotkey is browser-reserved (e.g. `Ctrl+Tab` to switch tabs for which keyup/keydown do not fire in a web browser), that action takes precedence and this hotkey will **not** fire.
+     *
+     * @default 'capture'
+     */
+    phase?: 'capture' | 'bubble';
+    /**
+     * Determines if the event should continue to the renderer.
+     *
+     * - `true`: The event is consumed immediately. It will **never** reach the renderer/page.
+     * - `false`: The event is sent to the renderer after this hotkey executes.
+     *
+     * @remarks
+     * This property is **only valid** when `phase` is set to `'capture'`.
+     * If `phase` is `'bubble'`, this property is ignored (as the renderer has already received and processed the event).
      *
      * @default false
      */
@@ -9120,6 +9191,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
  *
@@ -9644,10 +9721,9 @@ declare type MutableViewOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this view.
-     * When omitted, inherits from the parent application.
+     * Specifies the AppLogLevel for the specified View. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -9931,11 +10007,9 @@ declare type MutableWindowOptions = {
      */
     chromiumPolicies: ChromiumPolicies;
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
-     *
+     * Specifies the AppLogLevel for the Window. See {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 declare type NackHandler = (payloadOrMessage: RuntimeErrorPayload | string) => void;
@@ -10347,6 +10421,9 @@ declare namespace OpenFin_2 {
         InheritableOptions,
         PolicyOptions,
         ChromiumPolicies,
+        AppLogLevel,
+        LogPath,
+        LogTarget,
         MutableWindowOptions,
         WorkspacePlatformOptions,
         WebRequestHeader,
@@ -10929,10 +11006,10 @@ declare type PerDomainSettings = {
         drag?: 'allow' | 'block';
     };
     /**
-     * When set to `false`, disables sending application logs to RVM for this window.
-     * When omitted, inherits from the parent application.
+     * Allows the app log level of any matching content to be overriden.
+     * See also {@link AppLogLevel} for more information.
      */
-    enableAppLogging?: boolean;
+    appLogLevel?: AppLogLevel;
 };
 
 /**
@@ -13352,10 +13429,10 @@ declare type ProtocolMap = ExternalAdapterOnlyCallsMap & AnalyticsProtocolMap &
     'get-current-window': VoidCall;
     'get-current-window-sync': VoidCall;
     'show-download-bubble': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor?: OpenFin_2.Anchor;
     }, void>;
     'update-download-bubble-anchor': IdentityCall<{
-        options: OpenFin_2.Anchor;
+        anchor: OpenFin_2.Anchor;
     }, void>;
     'get-external-application-info': ApiCall<OpenFin_2.ApplicationIdentity, OpenFin_2.ExternalApplicationInfo>;
     'external-application-wrap': VoidCall;
@@ -15776,16 +15853,14 @@ declare class System extends EmitterBase<OpenFin_2.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.type Optional. The 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.
+     * @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", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level: string, message: string, { type }?: {
-        type?: 'app.log' | 'debug.log';
-    }): Promise<void>;
+    log(level: string, message: string, target?: OpenFin_2.LogTarget): Promise<void>;
     /**
      * Opens the passed URL in the default web browser.
      *
@@ -16610,11 +16685,35 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
     /**
      *  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_2.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_2.ThemePalette>>;
 }
@@ -20275,8 +20374,19 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    showDownloadBubble(anchor?: OpenFin_2.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,
@@ -20288,8 +20398,27 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
      *
      * @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(options: OpenFin_2.Anchor): Promise<void>;
+    updateDownloadBubbleAnchor(anchor: OpenFin_2.Anchor): Promise<void>;
 }
 
 /**

package/out/stub.js

@@ -5190,9 +5190,20 @@ function requireInstance () {
 	     * @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);
+	     * ```
 	     */
-	    async showDownloadBubble(options) {
-	        return this.wire.sendAction('show-download-bubble', { ...this.identity, options }).then(() => undefined);
+	    async showDownloadBubble(anchor) {
+	        return this.wire.sendAction('show-download-bubble', { ...this.identity, anchor }).then(() => undefined);
 	    }
 	    /**
 	     * Updates the anchor used for positioning the download bubble. This allows
@@ -5205,10 +5216,29 @@ function requireInstance () {
 	     *
 	     * @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");
+	     * }
+	});
 	     */
-	    async updateDownloadBubbleAnchor(options) {
+	    async updateDownloadBubbleAnchor(anchor) {
 	        return this.wire
-	            .sendAction('update-download-bubble-anchor', { ...this.identity, options })
+	            .sendAction('update-download-bubble-anchor', { ...this.identity, anchor })
 	            .then(() => undefined);
 	    }
 	}
@@ -6296,15 +6326,15 @@ class System extends base_1$m.EmitterBase {
      * 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.type Optional. The 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.
+     * @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", { type: 'debug.log' }).then(() => console.log('Log info message')).catch(err => console.log(err));
      * ```
      */
-    log(level, message, { type = 'debug.log' } = {}) {
-        return this.wire.sendAction('write-to-log', { level, message, target: { type } }).then(() => undefined);
+    log(level, message, target) {
+        return this.wire.sendAction('write-to-log', { level, message, target: target ?? {} }).then(() => undefined);
     }
     /**
      * Opens the passed URL in the default web browser.
@@ -7412,6 +7442,25 @@ class System extends base_1$m.EmitterBase {
     /**
      *  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
+     *     }
+     *   }
+     * ]);
+     * ```
      */
     async setThemePalette(themePalette) {
         return (await this.wire.sendAction('set-theme-palette', { themePalette })).payload.data;
@@ -7419,6 +7468,11 @@ class System extends base_1$m.EmitterBase {
     /**
      * Retrieves currently used color overrides
      * @returns Array of ColorProviderOverrides objects
+     * @example
+     * ```ts
+     * const themePalette = await fin.System.getThemePalette();
+     * console.log(themePalette);
+     * ```
      */
     async getThemePalette() {
         const { payload } = await this.wire.sendAction('get-theme-palette');

package/package.json

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