@openfin/core 44.101.1 → 44.101.3

package/out/stub.d.ts

@@ -45,6 +45,16 @@ declare type Accelerator = {
     zoom: boolean;
 };
 
+/**
+ * @interface
+ * Shared context available to all aria label functions.
+ */
+declare type AccessibilityContext = {
+    arrowNavigationEnabled: boolean;
+    deleteKeyCloseEnabled: boolean;
+    homeEndNavigationEnabled: boolean;
+};
+
 /**
  * Generated when a View is added to a layout.
  * @interface
@@ -54,6 +64,14 @@ declare type AddedToLayoutEvent = BaseEvent_4 & {
     layoutIdentity: OpenFin_2.LayoutIdentity;
 };
 
+/**
+ * @interface
+ * Context for add tab button aria-label functions.
+ */
+declare type AddTabButtonAriaLabelContext = AccessibilityContext & {
+    tabCount: number;
+};
+
 /**
  * Options to use when adding a view to a {@link TabStack}.
  *
@@ -1613,6 +1631,17 @@ declare type AppVersionTypeFromIdEvent<T extends IdEventType> = Extract<AppVersi
     type: WithoutId<T>;
 }>;
 
+/**
+ * @interface
+ * Custom aria-label providers for accessibility.
+ */
+declare type AriaLabelOptions = {
+    activeTab?: string | ((ctx: TabAriaLabelContext) => string);
+    inactiveTab?: string | ((ctx: TabAriaLabelContext) => string);
+    closeButton?: string | ((ctx: CloseButtonAriaLabelContext) => string);
+    addTabButton?: string | ((ctx: AddTabButtonAriaLabelContext) => string);
+};
+
 declare interface AuthorizationPayload {
     token: string;
     file: string;
@@ -3171,6 +3200,11 @@ declare type ClearCacheOption = {
      * browser data that can be used across sessions
      */
     localStorage?: boolean;
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3213,6 +3247,11 @@ declare type ClearDataOptions = {
      * - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
      */
     originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
+    /**
+     * Clears saved window-state data written for windows that use `saveWindowState`.
+     * After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
+     */
+    windowState?: boolean;
 };
 
 /**
@@ -3500,6 +3539,15 @@ declare type ClipboardPermissions = {
  */
 declare type ClipboardSelectionType = 'clipboard' | 'selection';
 
+/**
+ * @interface
+ * Context for close button aria-label functions.
+ */
+declare type CloseButtonAriaLabelContext = AccessibilityContext & {
+    title: string;
+    isActive: boolean;
+};
+
 /**
  * Generated when an application is closed.
  * @interface
@@ -4515,6 +4563,10 @@ declare type CreateLayoutOptions = {
      * @experimental
      */
     renderCustomHeaderControls?: (controlsElement: HTMLElement, context: HeaderControlsContext) => (() => void) | void;
+    /**
+     * Accessibility options for the layout. Controls ARIA attributes and keyboard navigation.
+     */
+    accessibilityOptions?: LayoutAccessibilityOptions;
 };
 
 /**
@@ -5203,7 +5255,7 @@ declare interface Environment {
     layoutAllowedInContext(fin: OpenFin_2.Fin<OpenFin_2.EntityType>): boolean;
     initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
     applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
-    createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<void>;
+    createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<OpenFin_2.LayoutSyncApi>;
     destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
     resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
     initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
@@ -8518,6 +8570,27 @@ declare class Layout extends Base {
     closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
 }
 
+/**
+ * @interface
+ * Accessibility options for layout tab navigation and ARIA support.
+ */
+declare type LayoutAccessibilityOptions = {
+    viewTabOptions?: ViewTabAccessibilityOptions;
+    /**
+     * Keyboard shortcut used to move focus from a tab header element into the active tab's web content.
+     *
+     * - Accepts an accelerator-like string, e.g. `'Ctrl+Enter'`, `'Meta+Enter'`, `'Alt+Enter'`, `'Mod+Enter'`.
+     * - `'Mod'`/`'CmdOrCtrl'`/`'CtrlOrMeta'` means Ctrl on Windows/Linux or Meta on macOS.
+     * - Set to `false` to disable this shortcut.
+     * - In core-web, reverse focus transfer (from iframe web content back to tab header) is not reliably supportable
+     *   due to browser iframe security and cross-origin focus restrictions. This hotkey is intentionally one-way:
+     *   tab header -> web content.
+     *
+     * @defaultValue 'Mod+Enter'
+     */
+    focusContentHotkey?: string | false;
+};
+
 /**
  * @interface
  */
@@ -8901,7 +8974,7 @@ declare class LayoutModule extends Base {
      * @returns
      */
     getCurrentLayoutManagerSync: <UserSnapshotType extends OpenFin_2.LayoutSnapshot>() => OpenFin_2.LayoutManager<UserSnapshotType>;
-    create: (options: OpenFin_2.CreateLayoutOptions) => Promise<void>;
+    create: (options: OpenFin_2.CreateLayoutOptions) => Promise<OpenFin_2.LayoutSyncApi>;
     destroy: (layoutIdentity: OpenFin_2.LayoutIdentity) => Promise<void>;
 }
 
@@ -9286,6 +9359,19 @@ declare type LayoutStateChangedEvent = LayoutDOMEvent & {
     type: 'layout-state-changed';
 };
 
+/**
+ * @interface
+ * Sync API returned from Layout.create() for operations that don't require IPC.
+ * Only available in the window context that owns the layout.
+ */
+declare type LayoutSyncApi = {
+    /**
+     * Updates accessibility options at runtime without recreating the layout.
+     * @param options Partial accessibility options to merge with existing options
+     */
+    updateAccessibilityOptions(options: Partial<LayoutAccessibilityOptions>): void;
+};
+
 /**
  * @interface
  */
@@ -10824,6 +10910,15 @@ declare namespace OpenFin_2 {
         HeaderControlsContext,
         CreateLayoutOptions,
         MultiInstanceViewBehavior,
+        LayoutAccessibilityOptions,
+        ViewTabElements,
+        ViewTabAccessibilityOptions,
+        AccessibilityContext,
+        TabAriaLabelContext,
+        CloseButtonAriaLabelContext,
+        AddTabButtonAriaLabelContext,
+        AriaLabelOptions,
+        LayoutSyncApi,
         PresetLayoutOptions_2 as PresetLayoutOptions,
         ResultBehavior,
         PopupBaseBehavior,
@@ -12640,6 +12735,38 @@ declare interface PlatformProvider {
      * @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
      */
     shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
+    /**
+     * Returns the platform's keyboard commands. Default implementation returns the manifest's
+     * `platform.commands`. Override to inject additional default commands.
+     * Called once during Platform.init; the result is cached for the lifetime
+     * of the platform.
+     *
+     * @remarks
+     * The returned commands are merged with core's built-in default commands
+     * (unless `disableDefaultCommands` is set).
+     * Overriders receive the raw manifest commands from `super` and can prepend
+     * their own defaults — returned commands override default commands by command name.
+     *
+     * @example
+     * ```js
+     * const overrideCallback = (PlatformProvider) => {
+     *     class Override extends PlatformProvider {
+     *         getKeyboardCommands() {
+     *             const manifestCommands = super.getKeyboardCommands();
+     *             const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
+     *             return [
+     *                 ...myCommands,
+     *                 ...manifestCommands
+     *             ];
+     *         }
+     *     }
+     *     return new Override();
+     * }
+     *
+     * fin.Platform.init({ overrideCallback });
+     * ```
+     */
+    getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
     /**
      * Method that is called every time an error occurs when processing an action in the Platform Provider. It is meant to be overriden, as a means to debug Platform applications
      */
@@ -15253,13 +15380,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -15284,12 +15413,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -16869,6 +17002,13 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
 declare class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     getCategories(): Promise<string[]>;
     /**
@@ -16876,6 +17016,29 @@ declare class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     startRecording(options: OpenFin_2.TraceConfig | OpenFin_2.TraceCategoriesAndOptions): Promise<void>;
     /**
@@ -16883,12 +17046,29 @@ declare class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     stopRecording(): Promise<string>;
     /**
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     getTraceBufferUsage(): Promise<OpenFin_2.TraceBufferUsage>;
 }
@@ -17017,6 +17197,17 @@ declare type SystemShutdownHandler = (shutdownEvent: {
     proceed: () => void;
 }) => void;
 
+/**
+ * @interface
+ * Context for tab aria-label functions.
+ */
+declare type TabAriaLabelContext = AccessibilityContext & {
+    title: string;
+    isActive: boolean;
+    tabIndex: number;
+    tabCount: number;
+};
+
 /**
  * Generated when a Layout Tab Component was closed.
  * @interface
@@ -18423,6 +18614,53 @@ declare interface ViewStatuses {
     viewsNotPreventingUnload: Identity_4[];
 }
 
+/**
+ * @interface
+ * Accessibility options for view tab navigation.
+ */
+declare type ViewTabAccessibilityOptions = {
+    /**
+     * Controls which elements are reachable via Tab key navigation.
+     * Uses roving tabindex pattern - only one element focusable at a time.
+     * @default ['active-tab', 'add-tab-button']
+     */
+    tabNavigation?: ViewTabElements[];
+    /**
+     * Controls which elements are navigable via Arrow keys.
+     * @default ['inactive-tab', 'active-tab', 'active-tab-close-button', 'inactive-tab-close-button', 'add-tab-button']
+     */
+    arrowNavigation?: ViewTabElements[];
+    /**
+     * Whether Delete/Backspace keys close the focused tab.
+     * @default false
+     */
+    enableDeleteKeyClose?: boolean;
+    /**
+     * Whether Home/End keys jump to first/last navigable element.
+     * @default false
+     */
+    enableHomeEndNavigation?: boolean;
+    /**
+     * Custom aria-label providers. Can be a static string or a function receiving context.
+     */
+    ariaLabels?: AriaLabelOptions;
+    /**
+     * Whether to announce tab changes via aria-live.
+     * @default true
+     */
+    announceTabChanges?: boolean;
+    /**
+     * Focus behavior when a tab is closed via keyboard.
+     * @default 'next'
+     */
+    focusOnCloseStrategy?: 'next' | 'previous' | 'active';
+};
+
+/**
+ * Elements that can be navigated in view tabs.
+ */
+declare type ViewTabElements = 'active-tab' | 'inactive-tab' | 'active-tab-close-button' | 'inactive-tab-close-button' | 'add-tab-button';
+
 /**
  * View throttling state.
  *

package/out/stub.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var events = require('events');
-var isEqual = require('lodash/isEqual');
+var esToolkit = require('es-toolkit');
 
 /**
  * Namespace for events that can be emitted by an {@link OpenFin.Application}.  Includes events
@@ -4999,6 +4999,13 @@ class _WindowModule extends Base {
 class SystemContentTracing extends Base {
     /**
      * Gets the currently known tracing category groups.
+     *
+     * @example
+     * ```ts
+     * const categories = await fin.System.ContentTracing.getCategories();
+     * const sorted = [...new Set(categories)].sort((a, b) => a.localeCompare(b));
+     * console.log(`Loaded ${sorted.length} tracing categories`);
+     * ```
      */
     async getCategories() {
         const { payload } = await this.wire.sendAction('content-tracing-get-categories');
@@ -5009,6 +5016,29 @@ class SystemContentTracing extends Base {
      *
      * Only one content tracing session may be active across the runtime at a time.
      * This method rejects if another identity already owns the active session.
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     recording_mode: 'record-as-much-as-possible',
+     *     included_categories: [
+     *         '*',
+     *         'disabled-by-default-blink.invalidation',
+     *         'disabled-by-default-cc.debug',
+     *         'disabled-by-default-viz.surface_id_flow'
+     *     ]
+     * });
+     *
+     * console.log('Content tracing started. Call stopRecording() when ready to collect the trace.');
+     * ```
+     *
+     * @example
+     * ```ts
+     * await fin.System.ContentTracing.startRecording({
+     *     categoryFilter: 'electron,blink,cc',
+     *     traceOptions: 'record-until-full,enable-sampling'
+     * });
+     * ```
      */
     async startRecording(options) {
         await this.wire.sendAction('content-tracing-start-recording', { options });
@@ -5018,6 +5048,13 @@ class SystemContentTracing extends Base {
      *
      * The calling identity must match the identity that started the active tracing session.
      * This method rejects if tracing is not active or is owned by another identity.
+     *
+     * @example
+     * ```ts
+     * const tracePath = await fin.System.ContentTracing.stopRecording();
+     * console.log('Trace written to:', tracePath);
+     * // Load the file in chrome://tracing or https://ui.perfetto.dev/
+     * ```
      */
     async stopRecording() {
         const { payload } = await this.wire.sendAction('content-tracing-stop-recording');
@@ -5027,6 +5064,16 @@ class SystemContentTracing extends Base {
      * Returns the current maximum trace buffer usage across processes.
      *
      * This method is not supported on macOS and rejects on that platform.
+     *
+     * @example
+     * ```ts
+     * try {
+     *     const usage = await fin.System.ContentTracing.getTraceBufferUsage();
+     *     console.log(`Buffer usage: ${usage.percentage}% (${usage.value})`);
+     * } catch (error) {
+     *     console.warn('Trace buffer usage is not available on this platform.', error);
+     * }
+     * ```
      */
     async getTraceBufferUsage() {
         const { payload } = await this.wire.sendAction('content-tracing-get-trace-buffer-usage');
@@ -5123,13 +5170,15 @@ class System extends EmitterBase {
      * * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
      * * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
      * * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
+     * * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
      * @example
      * ```js
      * const clearCacheOptions = {
      *     appcache: true,
      *     cache: true,
      *     cookies: true,
-     *     localStorage: true
+     *     localStorage: true,
+     *     windowState: true
      * };
      * fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
      * ```
@@ -5158,12 +5207,16 @@ class System extends EmitterBase {
      *
      * @param options - Optional configuration for what data to clear
      *
+     * @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
+     * After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
+     *
      * @example
      * ```js
      * // Clear only cookies and localStorage for a specific origin
      * await fin.System.clearCacheData({
      *     dataTypes: ['cookies', 'localStorage'],
-     *     origins: ['http://localhost:8081']
+     *     origins: ['http://localhost:8081'],
+     *     windowState: true
      * });
      *
      * // Clear everything except for a specific origin
@@ -13052,7 +13105,7 @@ class InteropBroker extends Base {
             constructor(...unused) {
                 if (unused.length) {
                     const [_ignore1, ignore2, opts] = unused;
-                    if (opts && typeof opts === 'object' && !isEqual(opts, args[2])) {
+                    if (opts && typeof opts === 'object' && !esToolkit.isEqual(opts, args[2])) {
                         // eslint-disable-next-line no-console
                         console.warn('You have modified the parameters of the InteropOverride constructor. This behavior is deprecated and will be removed in a future version. You can modify these options in your manifest. Please consult our Interop docs for guidance on migrating to the new override scheme.');
                         super(args[0], args[1], opts);
@@ -15088,7 +15141,7 @@ const createV1Channel = (sessionContextGroup) => {
                 const wrappedHandler = (context, contextMetadata) => {
                     if (first) {
                         first = false;
-                        if (isEqual(currentContext, context)) {
+                        if (esToolkit.isEqual(currentContext, context)) {
                             return;
                         }
                     }
@@ -15496,7 +15549,7 @@ class FDC3ModuleBase {
                     const wrappedHandler = (context, contextMetadata) => {
                         if (first) {
                             first = false;
-                            if (isEqual(currentContext, context)) {
+                            if (esToolkit.isEqual(currentContext, context)) {
                                 return;
                             }
                         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfin/core",
-  "version": "44.101.1",
+  "version": "44.101.3",
   "description": "The core renderer entry point of OpenFin",
   "license": "SEE LICENSE IN LICENSE.md",
   "main": "out/stub.js",
@@ -18,7 +18,7 @@
   "dependencies": {
     "@types/node": "^20.14.2",
     "events": "^3.0.0",
-    "lodash": "^4.17.21",
+    "es-toolkit": "^1.39.3",
     "ws": "^7.5.10",
     "tslib": "2.8.1"
   },