@openfin/core 44.101.2 → 44.101.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/out/mock-alpha.d.ts +195 -4
- package/out/mock-beta.d.ts +195 -4
- package/out/mock-public.d.ts +195 -4
- package/out/stub.d.ts +195 -4
- package/out/stub.js +8 -2
- package/package.json +1 -1
package/out/mock-alpha.d.ts
CHANGED
|
@@ -45,6 +45,16 @@ declare type Accelerator = {
|
|
|
45
45
|
zoom: boolean;
|
|
46
46
|
};
|
|
47
47
|
|
|
48
|
+
/**
|
|
49
|
+
* @interface
|
|
50
|
+
* Shared context available to all aria label functions.
|
|
51
|
+
*/
|
|
52
|
+
declare type AccessibilityContext = {
|
|
53
|
+
arrowNavigationEnabled: boolean;
|
|
54
|
+
deleteKeyCloseEnabled: boolean;
|
|
55
|
+
homeEndNavigationEnabled: boolean;
|
|
56
|
+
};
|
|
57
|
+
|
|
48
58
|
/**
|
|
49
59
|
* Generated when a View is added to a layout.
|
|
50
60
|
* @interface
|
|
@@ -54,6 +64,14 @@ declare type AddedToLayoutEvent = BaseEvent_4 & {
|
|
|
54
64
|
layoutIdentity: OpenFin_2.LayoutIdentity;
|
|
55
65
|
};
|
|
56
66
|
|
|
67
|
+
/**
|
|
68
|
+
* @interface
|
|
69
|
+
* Context for add tab button aria-label functions.
|
|
70
|
+
*/
|
|
71
|
+
declare type AddTabButtonAriaLabelContext = AccessibilityContext & {
|
|
72
|
+
tabCount: number;
|
|
73
|
+
};
|
|
74
|
+
|
|
57
75
|
/**
|
|
58
76
|
* Options to use when adding a view to a {@link TabStack}.
|
|
59
77
|
*
|
|
@@ -1599,6 +1617,17 @@ declare type AppVersionRuntimeStatusEvent = {
|
|
|
1599
1617
|
|
|
1600
1618
|
/* Excluded from this release type: AppVersionTypeFromIdEvent */
|
|
1601
1619
|
|
|
1620
|
+
/**
|
|
1621
|
+
* @interface
|
|
1622
|
+
* Custom aria-label providers for accessibility.
|
|
1623
|
+
*/
|
|
1624
|
+
declare type AriaLabelOptions = {
|
|
1625
|
+
activeTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1626
|
+
inactiveTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1627
|
+
closeButton?: string | ((ctx: CloseButtonAriaLabelContext) => string);
|
|
1628
|
+
addTabButton?: string | ((ctx: AddTabButtonAriaLabelContext) => string);
|
|
1629
|
+
};
|
|
1630
|
+
|
|
1602
1631
|
declare interface AuthorizationPayload {
|
|
1603
1632
|
token: string;
|
|
1604
1633
|
file: string;
|
|
@@ -3115,6 +3144,11 @@ declare type ClearCacheOption = {
|
|
|
3115
3144
|
* browser data that can be used across sessions
|
|
3116
3145
|
*/
|
|
3117
3146
|
localStorage?: boolean;
|
|
3147
|
+
/**
|
|
3148
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3149
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3150
|
+
*/
|
|
3151
|
+
windowState?: boolean;
|
|
3118
3152
|
};
|
|
3119
3153
|
|
|
3120
3154
|
/**
|
|
@@ -3157,6 +3191,11 @@ declare type ClearDataOptions = {
|
|
|
3157
3191
|
* - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
|
|
3158
3192
|
*/
|
|
3159
3193
|
originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
|
|
3194
|
+
/**
|
|
3195
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3196
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3197
|
+
*/
|
|
3198
|
+
windowState?: boolean;
|
|
3160
3199
|
};
|
|
3161
3200
|
|
|
3162
3201
|
/**
|
|
@@ -3444,6 +3483,15 @@ declare type ClipboardPermissions = {
|
|
|
3444
3483
|
*/
|
|
3445
3484
|
declare type ClipboardSelectionType = 'clipboard' | 'selection';
|
|
3446
3485
|
|
|
3486
|
+
/**
|
|
3487
|
+
* @interface
|
|
3488
|
+
* Context for close button aria-label functions.
|
|
3489
|
+
*/
|
|
3490
|
+
declare type CloseButtonAriaLabelContext = AccessibilityContext & {
|
|
3491
|
+
title: string;
|
|
3492
|
+
isActive: boolean;
|
|
3493
|
+
};
|
|
3494
|
+
|
|
3447
3495
|
/**
|
|
3448
3496
|
* Generated when an application is closed.
|
|
3449
3497
|
* @interface
|
|
@@ -4456,6 +4504,10 @@ declare type CreateLayoutOptions = {
|
|
|
4456
4504
|
* @experimental
|
|
4457
4505
|
*/
|
|
4458
4506
|
renderCustomHeaderControls?: (controlsElement: HTMLElement, context: HeaderControlsContext) => (() => void) | void;
|
|
4507
|
+
/**
|
|
4508
|
+
* Accessibility options for the layout. Controls ARIA attributes and keyboard navigation.
|
|
4509
|
+
*/
|
|
4510
|
+
accessibilityOptions?: LayoutAccessibilityOptions;
|
|
4459
4511
|
};
|
|
4460
4512
|
|
|
4461
4513
|
/**
|
|
@@ -5139,7 +5191,7 @@ declare interface Environment {
|
|
|
5139
5191
|
layoutAllowedInContext(fin: OpenFin_2.Fin<OpenFin_2.EntityType>): boolean;
|
|
5140
5192
|
initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
|
|
5141
5193
|
applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
|
|
5142
|
-
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<
|
|
5194
|
+
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<OpenFin_2.LayoutSyncApi>;
|
|
5143
5195
|
destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
|
|
5144
5196
|
resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
|
|
5145
5197
|
initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
|
|
@@ -8392,6 +8444,27 @@ declare class Layout extends Base {
|
|
|
8392
8444
|
closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
|
|
8393
8445
|
}
|
|
8394
8446
|
|
|
8447
|
+
/**
|
|
8448
|
+
* @interface
|
|
8449
|
+
* Accessibility options for layout tab navigation and ARIA support.
|
|
8450
|
+
*/
|
|
8451
|
+
declare type LayoutAccessibilityOptions = {
|
|
8452
|
+
viewTabOptions?: ViewTabAccessibilityOptions;
|
|
8453
|
+
/**
|
|
8454
|
+
* Keyboard shortcut used to move focus from a tab header element into the active tab's web content.
|
|
8455
|
+
*
|
|
8456
|
+
* - Accepts an accelerator-like string, e.g. `'Ctrl+Enter'`, `'Meta+Enter'`, `'Alt+Enter'`, `'Mod+Enter'`.
|
|
8457
|
+
* - `'Mod'`/`'CmdOrCtrl'`/`'CtrlOrMeta'` means Ctrl on Windows/Linux or Meta on macOS.
|
|
8458
|
+
* - Set to `false` to disable this shortcut.
|
|
8459
|
+
* - In core-web, reverse focus transfer (from iframe web content back to tab header) is not reliably supportable
|
|
8460
|
+
* due to browser iframe security and cross-origin focus restrictions. This hotkey is intentionally one-way:
|
|
8461
|
+
* tab header -> web content.
|
|
8462
|
+
*
|
|
8463
|
+
* @defaultValue 'Mod+Enter'
|
|
8464
|
+
*/
|
|
8465
|
+
focusContentHotkey?: string | false;
|
|
8466
|
+
};
|
|
8467
|
+
|
|
8395
8468
|
/**
|
|
8396
8469
|
* @interface
|
|
8397
8470
|
*/
|
|
@@ -8775,7 +8848,7 @@ declare class LayoutModule extends Base {
|
|
|
8775
8848
|
* @returns
|
|
8776
8849
|
*/
|
|
8777
8850
|
getCurrentLayoutManagerSync: <UserSnapshotType extends OpenFin_2.LayoutSnapshot>() => OpenFin_2.LayoutManager<UserSnapshotType>;
|
|
8778
|
-
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<
|
|
8851
|
+
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<OpenFin_2.LayoutSyncApi>;
|
|
8779
8852
|
destroy: (layoutIdentity: OpenFin_2.LayoutIdentity) => Promise<void>;
|
|
8780
8853
|
}
|
|
8781
8854
|
|
|
@@ -8977,6 +9050,19 @@ declare type LayoutStateChangedEvent = LayoutDOMEvent & {
|
|
|
8977
9050
|
type: 'layout-state-changed';
|
|
8978
9051
|
};
|
|
8979
9052
|
|
|
9053
|
+
/**
|
|
9054
|
+
* @interface
|
|
9055
|
+
* Sync API returned from Layout.create() for operations that don't require IPC.
|
|
9056
|
+
* Only available in the window context that owns the layout.
|
|
9057
|
+
*/
|
|
9058
|
+
declare type LayoutSyncApi = {
|
|
9059
|
+
/**
|
|
9060
|
+
* Updates accessibility options at runtime without recreating the layout.
|
|
9061
|
+
* @param options Partial accessibility options to merge with existing options
|
|
9062
|
+
*/
|
|
9063
|
+
updateAccessibilityOptions(options: Partial<LayoutAccessibilityOptions>): void;
|
|
9064
|
+
};
|
|
9065
|
+
|
|
8980
9066
|
/**
|
|
8981
9067
|
* @interface
|
|
8982
9068
|
*/
|
|
@@ -10490,6 +10576,15 @@ declare namespace OpenFin_2 {
|
|
|
10490
10576
|
HeaderControlsContext,
|
|
10491
10577
|
CreateLayoutOptions,
|
|
10492
10578
|
MultiInstanceViewBehavior,
|
|
10579
|
+
LayoutAccessibilityOptions,
|
|
10580
|
+
ViewTabElements,
|
|
10581
|
+
ViewTabAccessibilityOptions,
|
|
10582
|
+
AccessibilityContext,
|
|
10583
|
+
TabAriaLabelContext,
|
|
10584
|
+
CloseButtonAriaLabelContext,
|
|
10585
|
+
AddTabButtonAriaLabelContext,
|
|
10586
|
+
AriaLabelOptions,
|
|
10587
|
+
LayoutSyncApi,
|
|
10493
10588
|
PresetLayoutOptions_2 as PresetLayoutOptions,
|
|
10494
10589
|
ResultBehavior,
|
|
10495
10590
|
PopupBaseBehavior,
|
|
@@ -12223,6 +12318,38 @@ declare interface PlatformProvider {
|
|
|
12223
12318
|
* @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
|
|
12224
12319
|
*/
|
|
12225
12320
|
shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
|
|
12321
|
+
/**
|
|
12322
|
+
* Returns the platform's keyboard commands. Default implementation returns the manifest's
|
|
12323
|
+
* `platform.commands`. Override to inject additional default commands.
|
|
12324
|
+
* Called once during Platform.init; the result is cached for the lifetime
|
|
12325
|
+
* of the platform.
|
|
12326
|
+
*
|
|
12327
|
+
* @remarks
|
|
12328
|
+
* The returned commands are merged with core's built-in default commands
|
|
12329
|
+
* (unless `disableDefaultCommands` is set).
|
|
12330
|
+
* Overriders receive the raw manifest commands from `super` and can prepend
|
|
12331
|
+
* their own defaults — returned commands override default commands by command name.
|
|
12332
|
+
*
|
|
12333
|
+
* @example
|
|
12334
|
+
* ```js
|
|
12335
|
+
* const overrideCallback = (PlatformProvider) => {
|
|
12336
|
+
* class Override extends PlatformProvider {
|
|
12337
|
+
* getKeyboardCommands() {
|
|
12338
|
+
* const manifestCommands = super.getKeyboardCommands();
|
|
12339
|
+
* const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
|
|
12340
|
+
* return [
|
|
12341
|
+
* ...myCommands,
|
|
12342
|
+
* ...manifestCommands
|
|
12343
|
+
* ];
|
|
12344
|
+
* }
|
|
12345
|
+
* }
|
|
12346
|
+
* return new Override();
|
|
12347
|
+
* }
|
|
12348
|
+
*
|
|
12349
|
+
* fin.Platform.init({ overrideCallback });
|
|
12350
|
+
* ```
|
|
12351
|
+
*/
|
|
12352
|
+
getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
|
|
12226
12353
|
/**
|
|
12227
12354
|
* 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
|
|
12228
12355
|
*/
|
|
@@ -14830,13 +14957,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14830
14957
|
* * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
|
|
14831
14958
|
* * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
|
|
14832
14959
|
* * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
|
|
14960
|
+
* * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
|
|
14833
14961
|
* @example
|
|
14834
14962
|
* ```js
|
|
14835
14963
|
* const clearCacheOptions = {
|
|
14836
14964
|
* appcache: true,
|
|
14837
14965
|
* cache: true,
|
|
14838
14966
|
* cookies: true,
|
|
14839
|
-
* localStorage: true
|
|
14967
|
+
* localStorage: true,
|
|
14968
|
+
* windowState: true
|
|
14840
14969
|
* };
|
|
14841
14970
|
* fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
|
|
14842
14971
|
* ```
|
|
@@ -14861,12 +14990,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14861
14990
|
*
|
|
14862
14991
|
* @param options - Optional configuration for what data to clear
|
|
14863
14992
|
*
|
|
14993
|
+
* @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
|
|
14994
|
+
* After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
|
|
14995
|
+
*
|
|
14864
14996
|
* @example
|
|
14865
14997
|
* ```js
|
|
14866
14998
|
* // Clear only cookies and localStorage for a specific origin
|
|
14867
14999
|
* await fin.System.clearCacheData({
|
|
14868
15000
|
* dataTypes: ['cookies', 'localStorage'],
|
|
14869
|
-
* origins: ['http://localhost:8081']
|
|
15001
|
+
* origins: ['http://localhost:8081'],
|
|
15002
|
+
* windowState: true
|
|
14870
15003
|
* });
|
|
14871
15004
|
*
|
|
14872
15005
|
* // Clear everything except for a specific origin
|
|
@@ -16635,6 +16768,17 @@ declare type SystemShutdownHandler = (shutdownEvent: {
|
|
|
16635
16768
|
proceed: () => void;
|
|
16636
16769
|
}) => void;
|
|
16637
16770
|
|
|
16771
|
+
/**
|
|
16772
|
+
* @interface
|
|
16773
|
+
* Context for tab aria-label functions.
|
|
16774
|
+
*/
|
|
16775
|
+
declare type TabAriaLabelContext = AccessibilityContext & {
|
|
16776
|
+
title: string;
|
|
16777
|
+
isActive: boolean;
|
|
16778
|
+
tabIndex: number;
|
|
16779
|
+
tabCount: number;
|
|
16780
|
+
};
|
|
16781
|
+
|
|
16638
16782
|
/**
|
|
16639
16783
|
* Generated when a Layout Tab Component was closed.
|
|
16640
16784
|
* @interface
|
|
@@ -18003,6 +18147,53 @@ declare interface ViewStatuses {
|
|
|
18003
18147
|
viewsNotPreventingUnload: Identity_4[];
|
|
18004
18148
|
}
|
|
18005
18149
|
|
|
18150
|
+
/**
|
|
18151
|
+
* @interface
|
|
18152
|
+
* Accessibility options for view tab navigation.
|
|
18153
|
+
*/
|
|
18154
|
+
declare type ViewTabAccessibilityOptions = {
|
|
18155
|
+
/**
|
|
18156
|
+
* Controls which elements are reachable via Tab key navigation.
|
|
18157
|
+
* Uses roving tabindex pattern - only one element focusable at a time.
|
|
18158
|
+
* @default ['active-tab', 'add-tab-button']
|
|
18159
|
+
*/
|
|
18160
|
+
tabNavigation?: ViewTabElements[];
|
|
18161
|
+
/**
|
|
18162
|
+
* Controls which elements are navigable via Arrow keys.
|
|
18163
|
+
* @default ['inactive-tab', 'active-tab', 'active-tab-close-button', 'inactive-tab-close-button', 'add-tab-button']
|
|
18164
|
+
*/
|
|
18165
|
+
arrowNavigation?: ViewTabElements[];
|
|
18166
|
+
/**
|
|
18167
|
+
* Whether Delete/Backspace keys close the focused tab.
|
|
18168
|
+
* @default false
|
|
18169
|
+
*/
|
|
18170
|
+
enableDeleteKeyClose?: boolean;
|
|
18171
|
+
/**
|
|
18172
|
+
* Whether Home/End keys jump to first/last navigable element.
|
|
18173
|
+
* @default false
|
|
18174
|
+
*/
|
|
18175
|
+
enableHomeEndNavigation?: boolean;
|
|
18176
|
+
/**
|
|
18177
|
+
* Custom aria-label providers. Can be a static string or a function receiving context.
|
|
18178
|
+
*/
|
|
18179
|
+
ariaLabels?: AriaLabelOptions;
|
|
18180
|
+
/**
|
|
18181
|
+
* Whether to announce tab changes via aria-live.
|
|
18182
|
+
* @default true
|
|
18183
|
+
*/
|
|
18184
|
+
announceTabChanges?: boolean;
|
|
18185
|
+
/**
|
|
18186
|
+
* Focus behavior when a tab is closed via keyboard.
|
|
18187
|
+
* @default 'next'
|
|
18188
|
+
*/
|
|
18189
|
+
focusOnCloseStrategy?: 'next' | 'previous' | 'active';
|
|
18190
|
+
};
|
|
18191
|
+
|
|
18192
|
+
/**
|
|
18193
|
+
* Elements that can be navigated in view tabs.
|
|
18194
|
+
*/
|
|
18195
|
+
declare type ViewTabElements = 'active-tab' | 'inactive-tab' | 'active-tab-close-button' | 'inactive-tab-close-button' | 'add-tab-button';
|
|
18196
|
+
|
|
18006
18197
|
/**
|
|
18007
18198
|
* View throttling state.
|
|
18008
18199
|
*
|
package/out/mock-beta.d.ts
CHANGED
|
@@ -45,6 +45,16 @@ declare type Accelerator = {
|
|
|
45
45
|
zoom: boolean;
|
|
46
46
|
};
|
|
47
47
|
|
|
48
|
+
/**
|
|
49
|
+
* @interface
|
|
50
|
+
* Shared context available to all aria label functions.
|
|
51
|
+
*/
|
|
52
|
+
declare type AccessibilityContext = {
|
|
53
|
+
arrowNavigationEnabled: boolean;
|
|
54
|
+
deleteKeyCloseEnabled: boolean;
|
|
55
|
+
homeEndNavigationEnabled: boolean;
|
|
56
|
+
};
|
|
57
|
+
|
|
48
58
|
/**
|
|
49
59
|
* Generated when a View is added to a layout.
|
|
50
60
|
* @interface
|
|
@@ -54,6 +64,14 @@ declare type AddedToLayoutEvent = BaseEvent_4 & {
|
|
|
54
64
|
layoutIdentity: OpenFin_2.LayoutIdentity;
|
|
55
65
|
};
|
|
56
66
|
|
|
67
|
+
/**
|
|
68
|
+
* @interface
|
|
69
|
+
* Context for add tab button aria-label functions.
|
|
70
|
+
*/
|
|
71
|
+
declare type AddTabButtonAriaLabelContext = AccessibilityContext & {
|
|
72
|
+
tabCount: number;
|
|
73
|
+
};
|
|
74
|
+
|
|
57
75
|
/**
|
|
58
76
|
* Options to use when adding a view to a {@link TabStack}.
|
|
59
77
|
*
|
|
@@ -1599,6 +1617,17 @@ declare type AppVersionRuntimeStatusEvent = {
|
|
|
1599
1617
|
|
|
1600
1618
|
/* Excluded from this release type: AppVersionTypeFromIdEvent */
|
|
1601
1619
|
|
|
1620
|
+
/**
|
|
1621
|
+
* @interface
|
|
1622
|
+
* Custom aria-label providers for accessibility.
|
|
1623
|
+
*/
|
|
1624
|
+
declare type AriaLabelOptions = {
|
|
1625
|
+
activeTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1626
|
+
inactiveTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1627
|
+
closeButton?: string | ((ctx: CloseButtonAriaLabelContext) => string);
|
|
1628
|
+
addTabButton?: string | ((ctx: AddTabButtonAriaLabelContext) => string);
|
|
1629
|
+
};
|
|
1630
|
+
|
|
1602
1631
|
declare interface AuthorizationPayload {
|
|
1603
1632
|
token: string;
|
|
1604
1633
|
file: string;
|
|
@@ -3115,6 +3144,11 @@ declare type ClearCacheOption = {
|
|
|
3115
3144
|
* browser data that can be used across sessions
|
|
3116
3145
|
*/
|
|
3117
3146
|
localStorage?: boolean;
|
|
3147
|
+
/**
|
|
3148
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3149
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3150
|
+
*/
|
|
3151
|
+
windowState?: boolean;
|
|
3118
3152
|
};
|
|
3119
3153
|
|
|
3120
3154
|
/**
|
|
@@ -3157,6 +3191,11 @@ declare type ClearDataOptions = {
|
|
|
3157
3191
|
* - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
|
|
3158
3192
|
*/
|
|
3159
3193
|
originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
|
|
3194
|
+
/**
|
|
3195
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3196
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3197
|
+
*/
|
|
3198
|
+
windowState?: boolean;
|
|
3160
3199
|
};
|
|
3161
3200
|
|
|
3162
3201
|
/**
|
|
@@ -3444,6 +3483,15 @@ declare type ClipboardPermissions = {
|
|
|
3444
3483
|
*/
|
|
3445
3484
|
declare type ClipboardSelectionType = 'clipboard' | 'selection';
|
|
3446
3485
|
|
|
3486
|
+
/**
|
|
3487
|
+
* @interface
|
|
3488
|
+
* Context for close button aria-label functions.
|
|
3489
|
+
*/
|
|
3490
|
+
declare type CloseButtonAriaLabelContext = AccessibilityContext & {
|
|
3491
|
+
title: string;
|
|
3492
|
+
isActive: boolean;
|
|
3493
|
+
};
|
|
3494
|
+
|
|
3447
3495
|
/**
|
|
3448
3496
|
* Generated when an application is closed.
|
|
3449
3497
|
* @interface
|
|
@@ -4456,6 +4504,10 @@ declare type CreateLayoutOptions = {
|
|
|
4456
4504
|
* @experimental
|
|
4457
4505
|
*/
|
|
4458
4506
|
renderCustomHeaderControls?: (controlsElement: HTMLElement, context: HeaderControlsContext) => (() => void) | void;
|
|
4507
|
+
/**
|
|
4508
|
+
* Accessibility options for the layout. Controls ARIA attributes and keyboard navigation.
|
|
4509
|
+
*/
|
|
4510
|
+
accessibilityOptions?: LayoutAccessibilityOptions;
|
|
4459
4511
|
};
|
|
4460
4512
|
|
|
4461
4513
|
/**
|
|
@@ -5139,7 +5191,7 @@ declare interface Environment {
|
|
|
5139
5191
|
layoutAllowedInContext(fin: OpenFin_2.Fin<OpenFin_2.EntityType>): boolean;
|
|
5140
5192
|
initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
|
|
5141
5193
|
applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
|
|
5142
|
-
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<
|
|
5194
|
+
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<OpenFin_2.LayoutSyncApi>;
|
|
5143
5195
|
destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
|
|
5144
5196
|
resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
|
|
5145
5197
|
initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
|
|
@@ -8392,6 +8444,27 @@ declare class Layout extends Base {
|
|
|
8392
8444
|
closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
|
|
8393
8445
|
}
|
|
8394
8446
|
|
|
8447
|
+
/**
|
|
8448
|
+
* @interface
|
|
8449
|
+
* Accessibility options for layout tab navigation and ARIA support.
|
|
8450
|
+
*/
|
|
8451
|
+
declare type LayoutAccessibilityOptions = {
|
|
8452
|
+
viewTabOptions?: ViewTabAccessibilityOptions;
|
|
8453
|
+
/**
|
|
8454
|
+
* Keyboard shortcut used to move focus from a tab header element into the active tab's web content.
|
|
8455
|
+
*
|
|
8456
|
+
* - Accepts an accelerator-like string, e.g. `'Ctrl+Enter'`, `'Meta+Enter'`, `'Alt+Enter'`, `'Mod+Enter'`.
|
|
8457
|
+
* - `'Mod'`/`'CmdOrCtrl'`/`'CtrlOrMeta'` means Ctrl on Windows/Linux or Meta on macOS.
|
|
8458
|
+
* - Set to `false` to disable this shortcut.
|
|
8459
|
+
* - In core-web, reverse focus transfer (from iframe web content back to tab header) is not reliably supportable
|
|
8460
|
+
* due to browser iframe security and cross-origin focus restrictions. This hotkey is intentionally one-way:
|
|
8461
|
+
* tab header -> web content.
|
|
8462
|
+
*
|
|
8463
|
+
* @defaultValue 'Mod+Enter'
|
|
8464
|
+
*/
|
|
8465
|
+
focusContentHotkey?: string | false;
|
|
8466
|
+
};
|
|
8467
|
+
|
|
8395
8468
|
/**
|
|
8396
8469
|
* @interface
|
|
8397
8470
|
*/
|
|
@@ -8775,7 +8848,7 @@ declare class LayoutModule extends Base {
|
|
|
8775
8848
|
* @returns
|
|
8776
8849
|
*/
|
|
8777
8850
|
getCurrentLayoutManagerSync: <UserSnapshotType extends OpenFin_2.LayoutSnapshot>() => OpenFin_2.LayoutManager<UserSnapshotType>;
|
|
8778
|
-
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<
|
|
8851
|
+
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<OpenFin_2.LayoutSyncApi>;
|
|
8779
8852
|
destroy: (layoutIdentity: OpenFin_2.LayoutIdentity) => Promise<void>;
|
|
8780
8853
|
}
|
|
8781
8854
|
|
|
@@ -8977,6 +9050,19 @@ declare type LayoutStateChangedEvent = LayoutDOMEvent & {
|
|
|
8977
9050
|
type: 'layout-state-changed';
|
|
8978
9051
|
};
|
|
8979
9052
|
|
|
9053
|
+
/**
|
|
9054
|
+
* @interface
|
|
9055
|
+
* Sync API returned from Layout.create() for operations that don't require IPC.
|
|
9056
|
+
* Only available in the window context that owns the layout.
|
|
9057
|
+
*/
|
|
9058
|
+
declare type LayoutSyncApi = {
|
|
9059
|
+
/**
|
|
9060
|
+
* Updates accessibility options at runtime without recreating the layout.
|
|
9061
|
+
* @param options Partial accessibility options to merge with existing options
|
|
9062
|
+
*/
|
|
9063
|
+
updateAccessibilityOptions(options: Partial<LayoutAccessibilityOptions>): void;
|
|
9064
|
+
};
|
|
9065
|
+
|
|
8980
9066
|
/**
|
|
8981
9067
|
* @interface
|
|
8982
9068
|
*/
|
|
@@ -10490,6 +10576,15 @@ declare namespace OpenFin_2 {
|
|
|
10490
10576
|
HeaderControlsContext,
|
|
10491
10577
|
CreateLayoutOptions,
|
|
10492
10578
|
MultiInstanceViewBehavior,
|
|
10579
|
+
LayoutAccessibilityOptions,
|
|
10580
|
+
ViewTabElements,
|
|
10581
|
+
ViewTabAccessibilityOptions,
|
|
10582
|
+
AccessibilityContext,
|
|
10583
|
+
TabAriaLabelContext,
|
|
10584
|
+
CloseButtonAriaLabelContext,
|
|
10585
|
+
AddTabButtonAriaLabelContext,
|
|
10586
|
+
AriaLabelOptions,
|
|
10587
|
+
LayoutSyncApi,
|
|
10493
10588
|
PresetLayoutOptions_2 as PresetLayoutOptions,
|
|
10494
10589
|
ResultBehavior,
|
|
10495
10590
|
PopupBaseBehavior,
|
|
@@ -12223,6 +12318,38 @@ declare interface PlatformProvider {
|
|
|
12223
12318
|
* @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
|
|
12224
12319
|
*/
|
|
12225
12320
|
shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
|
|
12321
|
+
/**
|
|
12322
|
+
* Returns the platform's keyboard commands. Default implementation returns the manifest's
|
|
12323
|
+
* `platform.commands`. Override to inject additional default commands.
|
|
12324
|
+
* Called once during Platform.init; the result is cached for the lifetime
|
|
12325
|
+
* of the platform.
|
|
12326
|
+
*
|
|
12327
|
+
* @remarks
|
|
12328
|
+
* The returned commands are merged with core's built-in default commands
|
|
12329
|
+
* (unless `disableDefaultCommands` is set).
|
|
12330
|
+
* Overriders receive the raw manifest commands from `super` and can prepend
|
|
12331
|
+
* their own defaults — returned commands override default commands by command name.
|
|
12332
|
+
*
|
|
12333
|
+
* @example
|
|
12334
|
+
* ```js
|
|
12335
|
+
* const overrideCallback = (PlatformProvider) => {
|
|
12336
|
+
* class Override extends PlatformProvider {
|
|
12337
|
+
* getKeyboardCommands() {
|
|
12338
|
+
* const manifestCommands = super.getKeyboardCommands();
|
|
12339
|
+
* const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
|
|
12340
|
+
* return [
|
|
12341
|
+
* ...myCommands,
|
|
12342
|
+
* ...manifestCommands
|
|
12343
|
+
* ];
|
|
12344
|
+
* }
|
|
12345
|
+
* }
|
|
12346
|
+
* return new Override();
|
|
12347
|
+
* }
|
|
12348
|
+
*
|
|
12349
|
+
* fin.Platform.init({ overrideCallback });
|
|
12350
|
+
* ```
|
|
12351
|
+
*/
|
|
12352
|
+
getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
|
|
12226
12353
|
/**
|
|
12227
12354
|
* 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
|
|
12228
12355
|
*/
|
|
@@ -14830,13 +14957,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14830
14957
|
* * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
|
|
14831
14958
|
* * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
|
|
14832
14959
|
* * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
|
|
14960
|
+
* * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
|
|
14833
14961
|
* @example
|
|
14834
14962
|
* ```js
|
|
14835
14963
|
* const clearCacheOptions = {
|
|
14836
14964
|
* appcache: true,
|
|
14837
14965
|
* cache: true,
|
|
14838
14966
|
* cookies: true,
|
|
14839
|
-
* localStorage: true
|
|
14967
|
+
* localStorage: true,
|
|
14968
|
+
* windowState: true
|
|
14840
14969
|
* };
|
|
14841
14970
|
* fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
|
|
14842
14971
|
* ```
|
|
@@ -14861,12 +14990,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14861
14990
|
*
|
|
14862
14991
|
* @param options - Optional configuration for what data to clear
|
|
14863
14992
|
*
|
|
14993
|
+
* @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
|
|
14994
|
+
* After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
|
|
14995
|
+
*
|
|
14864
14996
|
* @example
|
|
14865
14997
|
* ```js
|
|
14866
14998
|
* // Clear only cookies and localStorage for a specific origin
|
|
14867
14999
|
* await fin.System.clearCacheData({
|
|
14868
15000
|
* dataTypes: ['cookies', 'localStorage'],
|
|
14869
|
-
* origins: ['http://localhost:8081']
|
|
15001
|
+
* origins: ['http://localhost:8081'],
|
|
15002
|
+
* windowState: true
|
|
14870
15003
|
* });
|
|
14871
15004
|
*
|
|
14872
15005
|
* // Clear everything except for a specific origin
|
|
@@ -16635,6 +16768,17 @@ declare type SystemShutdownHandler = (shutdownEvent: {
|
|
|
16635
16768
|
proceed: () => void;
|
|
16636
16769
|
}) => void;
|
|
16637
16770
|
|
|
16771
|
+
/**
|
|
16772
|
+
* @interface
|
|
16773
|
+
* Context for tab aria-label functions.
|
|
16774
|
+
*/
|
|
16775
|
+
declare type TabAriaLabelContext = AccessibilityContext & {
|
|
16776
|
+
title: string;
|
|
16777
|
+
isActive: boolean;
|
|
16778
|
+
tabIndex: number;
|
|
16779
|
+
tabCount: number;
|
|
16780
|
+
};
|
|
16781
|
+
|
|
16638
16782
|
/**
|
|
16639
16783
|
* Generated when a Layout Tab Component was closed.
|
|
16640
16784
|
* @interface
|
|
@@ -18003,6 +18147,53 @@ declare interface ViewStatuses {
|
|
|
18003
18147
|
viewsNotPreventingUnload: Identity_4[];
|
|
18004
18148
|
}
|
|
18005
18149
|
|
|
18150
|
+
/**
|
|
18151
|
+
* @interface
|
|
18152
|
+
* Accessibility options for view tab navigation.
|
|
18153
|
+
*/
|
|
18154
|
+
declare type ViewTabAccessibilityOptions = {
|
|
18155
|
+
/**
|
|
18156
|
+
* Controls which elements are reachable via Tab key navigation.
|
|
18157
|
+
* Uses roving tabindex pattern - only one element focusable at a time.
|
|
18158
|
+
* @default ['active-tab', 'add-tab-button']
|
|
18159
|
+
*/
|
|
18160
|
+
tabNavigation?: ViewTabElements[];
|
|
18161
|
+
/**
|
|
18162
|
+
* Controls which elements are navigable via Arrow keys.
|
|
18163
|
+
* @default ['inactive-tab', 'active-tab', 'active-tab-close-button', 'inactive-tab-close-button', 'add-tab-button']
|
|
18164
|
+
*/
|
|
18165
|
+
arrowNavigation?: ViewTabElements[];
|
|
18166
|
+
/**
|
|
18167
|
+
* Whether Delete/Backspace keys close the focused tab.
|
|
18168
|
+
* @default false
|
|
18169
|
+
*/
|
|
18170
|
+
enableDeleteKeyClose?: boolean;
|
|
18171
|
+
/**
|
|
18172
|
+
* Whether Home/End keys jump to first/last navigable element.
|
|
18173
|
+
* @default false
|
|
18174
|
+
*/
|
|
18175
|
+
enableHomeEndNavigation?: boolean;
|
|
18176
|
+
/**
|
|
18177
|
+
* Custom aria-label providers. Can be a static string or a function receiving context.
|
|
18178
|
+
*/
|
|
18179
|
+
ariaLabels?: AriaLabelOptions;
|
|
18180
|
+
/**
|
|
18181
|
+
* Whether to announce tab changes via aria-live.
|
|
18182
|
+
* @default true
|
|
18183
|
+
*/
|
|
18184
|
+
announceTabChanges?: boolean;
|
|
18185
|
+
/**
|
|
18186
|
+
* Focus behavior when a tab is closed via keyboard.
|
|
18187
|
+
* @default 'next'
|
|
18188
|
+
*/
|
|
18189
|
+
focusOnCloseStrategy?: 'next' | 'previous' | 'active';
|
|
18190
|
+
};
|
|
18191
|
+
|
|
18192
|
+
/**
|
|
18193
|
+
* Elements that can be navigated in view tabs.
|
|
18194
|
+
*/
|
|
18195
|
+
declare type ViewTabElements = 'active-tab' | 'inactive-tab' | 'active-tab-close-button' | 'inactive-tab-close-button' | 'add-tab-button';
|
|
18196
|
+
|
|
18006
18197
|
/**
|
|
18007
18198
|
* View throttling state.
|
|
18008
18199
|
*
|
package/out/mock-public.d.ts
CHANGED
|
@@ -45,6 +45,16 @@ declare type Accelerator = {
|
|
|
45
45
|
zoom: boolean;
|
|
46
46
|
};
|
|
47
47
|
|
|
48
|
+
/**
|
|
49
|
+
* @interface
|
|
50
|
+
* Shared context available to all aria label functions.
|
|
51
|
+
*/
|
|
52
|
+
declare type AccessibilityContext = {
|
|
53
|
+
arrowNavigationEnabled: boolean;
|
|
54
|
+
deleteKeyCloseEnabled: boolean;
|
|
55
|
+
homeEndNavigationEnabled: boolean;
|
|
56
|
+
};
|
|
57
|
+
|
|
48
58
|
/**
|
|
49
59
|
* Generated when a View is added to a layout.
|
|
50
60
|
* @interface
|
|
@@ -54,6 +64,14 @@ declare type AddedToLayoutEvent = BaseEvent_4 & {
|
|
|
54
64
|
layoutIdentity: OpenFin_2.LayoutIdentity;
|
|
55
65
|
};
|
|
56
66
|
|
|
67
|
+
/**
|
|
68
|
+
* @interface
|
|
69
|
+
* Context for add tab button aria-label functions.
|
|
70
|
+
*/
|
|
71
|
+
declare type AddTabButtonAriaLabelContext = AccessibilityContext & {
|
|
72
|
+
tabCount: number;
|
|
73
|
+
};
|
|
74
|
+
|
|
57
75
|
/**
|
|
58
76
|
* Options to use when adding a view to a {@link TabStack}.
|
|
59
77
|
*
|
|
@@ -1599,6 +1617,17 @@ declare type AppVersionRuntimeStatusEvent = {
|
|
|
1599
1617
|
|
|
1600
1618
|
/* Excluded from this release type: AppVersionTypeFromIdEvent */
|
|
1601
1619
|
|
|
1620
|
+
/**
|
|
1621
|
+
* @interface
|
|
1622
|
+
* Custom aria-label providers for accessibility.
|
|
1623
|
+
*/
|
|
1624
|
+
declare type AriaLabelOptions = {
|
|
1625
|
+
activeTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1626
|
+
inactiveTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1627
|
+
closeButton?: string | ((ctx: CloseButtonAriaLabelContext) => string);
|
|
1628
|
+
addTabButton?: string | ((ctx: AddTabButtonAriaLabelContext) => string);
|
|
1629
|
+
};
|
|
1630
|
+
|
|
1602
1631
|
declare interface AuthorizationPayload {
|
|
1603
1632
|
token: string;
|
|
1604
1633
|
file: string;
|
|
@@ -3115,6 +3144,11 @@ declare type ClearCacheOption = {
|
|
|
3115
3144
|
* browser data that can be used across sessions
|
|
3116
3145
|
*/
|
|
3117
3146
|
localStorage?: boolean;
|
|
3147
|
+
/**
|
|
3148
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3149
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3150
|
+
*/
|
|
3151
|
+
windowState?: boolean;
|
|
3118
3152
|
};
|
|
3119
3153
|
|
|
3120
3154
|
/**
|
|
@@ -3157,6 +3191,11 @@ declare type ClearDataOptions = {
|
|
|
3157
3191
|
* - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
|
|
3158
3192
|
*/
|
|
3159
3193
|
originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
|
|
3194
|
+
/**
|
|
3195
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3196
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3197
|
+
*/
|
|
3198
|
+
windowState?: boolean;
|
|
3160
3199
|
};
|
|
3161
3200
|
|
|
3162
3201
|
/**
|
|
@@ -3444,6 +3483,15 @@ declare type ClipboardPermissions = {
|
|
|
3444
3483
|
*/
|
|
3445
3484
|
declare type ClipboardSelectionType = 'clipboard' | 'selection';
|
|
3446
3485
|
|
|
3486
|
+
/**
|
|
3487
|
+
* @interface
|
|
3488
|
+
* Context for close button aria-label functions.
|
|
3489
|
+
*/
|
|
3490
|
+
declare type CloseButtonAriaLabelContext = AccessibilityContext & {
|
|
3491
|
+
title: string;
|
|
3492
|
+
isActive: boolean;
|
|
3493
|
+
};
|
|
3494
|
+
|
|
3447
3495
|
/**
|
|
3448
3496
|
* Generated when an application is closed.
|
|
3449
3497
|
* @interface
|
|
@@ -4456,6 +4504,10 @@ declare type CreateLayoutOptions = {
|
|
|
4456
4504
|
* @experimental
|
|
4457
4505
|
*/
|
|
4458
4506
|
renderCustomHeaderControls?: (controlsElement: HTMLElement, context: HeaderControlsContext) => (() => void) | void;
|
|
4507
|
+
/**
|
|
4508
|
+
* Accessibility options for the layout. Controls ARIA attributes and keyboard navigation.
|
|
4509
|
+
*/
|
|
4510
|
+
accessibilityOptions?: LayoutAccessibilityOptions;
|
|
4459
4511
|
};
|
|
4460
4512
|
|
|
4461
4513
|
/**
|
|
@@ -5139,7 +5191,7 @@ declare interface Environment {
|
|
|
5139
5191
|
layoutAllowedInContext(fin: OpenFin_2.Fin<OpenFin_2.EntityType>): boolean;
|
|
5140
5192
|
initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
|
|
5141
5193
|
applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
|
|
5142
|
-
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<
|
|
5194
|
+
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<OpenFin_2.LayoutSyncApi>;
|
|
5143
5195
|
destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
|
|
5144
5196
|
resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
|
|
5145
5197
|
initPlatform(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, ...args: Parameters<OpenFin_2.Fin['Platform']['init']>): ReturnType<OpenFin_2.Fin['Platform']['init']>;
|
|
@@ -8392,6 +8444,27 @@ declare class Layout extends Base {
|
|
|
8392
8444
|
closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
|
|
8393
8445
|
}
|
|
8394
8446
|
|
|
8447
|
+
/**
|
|
8448
|
+
* @interface
|
|
8449
|
+
* Accessibility options for layout tab navigation and ARIA support.
|
|
8450
|
+
*/
|
|
8451
|
+
declare type LayoutAccessibilityOptions = {
|
|
8452
|
+
viewTabOptions?: ViewTabAccessibilityOptions;
|
|
8453
|
+
/**
|
|
8454
|
+
* Keyboard shortcut used to move focus from a tab header element into the active tab's web content.
|
|
8455
|
+
*
|
|
8456
|
+
* - Accepts an accelerator-like string, e.g. `'Ctrl+Enter'`, `'Meta+Enter'`, `'Alt+Enter'`, `'Mod+Enter'`.
|
|
8457
|
+
* - `'Mod'`/`'CmdOrCtrl'`/`'CtrlOrMeta'` means Ctrl on Windows/Linux or Meta on macOS.
|
|
8458
|
+
* - Set to `false` to disable this shortcut.
|
|
8459
|
+
* - In core-web, reverse focus transfer (from iframe web content back to tab header) is not reliably supportable
|
|
8460
|
+
* due to browser iframe security and cross-origin focus restrictions. This hotkey is intentionally one-way:
|
|
8461
|
+
* tab header -> web content.
|
|
8462
|
+
*
|
|
8463
|
+
* @defaultValue 'Mod+Enter'
|
|
8464
|
+
*/
|
|
8465
|
+
focusContentHotkey?: string | false;
|
|
8466
|
+
};
|
|
8467
|
+
|
|
8395
8468
|
/**
|
|
8396
8469
|
* @interface
|
|
8397
8470
|
*/
|
|
@@ -8775,7 +8848,7 @@ declare class LayoutModule extends Base {
|
|
|
8775
8848
|
* @returns
|
|
8776
8849
|
*/
|
|
8777
8850
|
getCurrentLayoutManagerSync: <UserSnapshotType extends OpenFin_2.LayoutSnapshot>() => OpenFin_2.LayoutManager<UserSnapshotType>;
|
|
8778
|
-
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<
|
|
8851
|
+
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<OpenFin_2.LayoutSyncApi>;
|
|
8779
8852
|
destroy: (layoutIdentity: OpenFin_2.LayoutIdentity) => Promise<void>;
|
|
8780
8853
|
}
|
|
8781
8854
|
|
|
@@ -8977,6 +9050,19 @@ declare type LayoutStateChangedEvent = LayoutDOMEvent & {
|
|
|
8977
9050
|
type: 'layout-state-changed';
|
|
8978
9051
|
};
|
|
8979
9052
|
|
|
9053
|
+
/**
|
|
9054
|
+
* @interface
|
|
9055
|
+
* Sync API returned from Layout.create() for operations that don't require IPC.
|
|
9056
|
+
* Only available in the window context that owns the layout.
|
|
9057
|
+
*/
|
|
9058
|
+
declare type LayoutSyncApi = {
|
|
9059
|
+
/**
|
|
9060
|
+
* Updates accessibility options at runtime without recreating the layout.
|
|
9061
|
+
* @param options Partial accessibility options to merge with existing options
|
|
9062
|
+
*/
|
|
9063
|
+
updateAccessibilityOptions(options: Partial<LayoutAccessibilityOptions>): void;
|
|
9064
|
+
};
|
|
9065
|
+
|
|
8980
9066
|
/**
|
|
8981
9067
|
* @interface
|
|
8982
9068
|
*/
|
|
@@ -10490,6 +10576,15 @@ declare namespace OpenFin_2 {
|
|
|
10490
10576
|
HeaderControlsContext,
|
|
10491
10577
|
CreateLayoutOptions,
|
|
10492
10578
|
MultiInstanceViewBehavior,
|
|
10579
|
+
LayoutAccessibilityOptions,
|
|
10580
|
+
ViewTabElements,
|
|
10581
|
+
ViewTabAccessibilityOptions,
|
|
10582
|
+
AccessibilityContext,
|
|
10583
|
+
TabAriaLabelContext,
|
|
10584
|
+
CloseButtonAriaLabelContext,
|
|
10585
|
+
AddTabButtonAriaLabelContext,
|
|
10586
|
+
AriaLabelOptions,
|
|
10587
|
+
LayoutSyncApi,
|
|
10493
10588
|
PresetLayoutOptions_2 as PresetLayoutOptions,
|
|
10494
10589
|
ResultBehavior,
|
|
10495
10590
|
PopupBaseBehavior,
|
|
@@ -12223,6 +12318,38 @@ declare interface PlatformProvider {
|
|
|
12223
12318
|
* @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
|
|
12224
12319
|
*/
|
|
12225
12320
|
shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
|
|
12321
|
+
/**
|
|
12322
|
+
* Returns the platform's keyboard commands. Default implementation returns the manifest's
|
|
12323
|
+
* `platform.commands`. Override to inject additional default commands.
|
|
12324
|
+
* Called once during Platform.init; the result is cached for the lifetime
|
|
12325
|
+
* of the platform.
|
|
12326
|
+
*
|
|
12327
|
+
* @remarks
|
|
12328
|
+
* The returned commands are merged with core's built-in default commands
|
|
12329
|
+
* (unless `disableDefaultCommands` is set).
|
|
12330
|
+
* Overriders receive the raw manifest commands from `super` and can prepend
|
|
12331
|
+
* their own defaults — returned commands override default commands by command name.
|
|
12332
|
+
*
|
|
12333
|
+
* @example
|
|
12334
|
+
* ```js
|
|
12335
|
+
* const overrideCallback = (PlatformProvider) => {
|
|
12336
|
+
* class Override extends PlatformProvider {
|
|
12337
|
+
* getKeyboardCommands() {
|
|
12338
|
+
* const manifestCommands = super.getKeyboardCommands();
|
|
12339
|
+
* const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
|
|
12340
|
+
* return [
|
|
12341
|
+
* ...myCommands,
|
|
12342
|
+
* ...manifestCommands
|
|
12343
|
+
* ];
|
|
12344
|
+
* }
|
|
12345
|
+
* }
|
|
12346
|
+
* return new Override();
|
|
12347
|
+
* }
|
|
12348
|
+
*
|
|
12349
|
+
* fin.Platform.init({ overrideCallback });
|
|
12350
|
+
* ```
|
|
12351
|
+
*/
|
|
12352
|
+
getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
|
|
12226
12353
|
/**
|
|
12227
12354
|
* 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
|
|
12228
12355
|
*/
|
|
@@ -14830,13 +14957,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14830
14957
|
* * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
|
|
14831
14958
|
* * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
|
|
14832
14959
|
* * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
|
|
14960
|
+
* * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
|
|
14833
14961
|
* @example
|
|
14834
14962
|
* ```js
|
|
14835
14963
|
* const clearCacheOptions = {
|
|
14836
14964
|
* appcache: true,
|
|
14837
14965
|
* cache: true,
|
|
14838
14966
|
* cookies: true,
|
|
14839
|
-
* localStorage: true
|
|
14967
|
+
* localStorage: true,
|
|
14968
|
+
* windowState: true
|
|
14840
14969
|
* };
|
|
14841
14970
|
* fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
|
|
14842
14971
|
* ```
|
|
@@ -14861,12 +14990,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
14861
14990
|
*
|
|
14862
14991
|
* @param options - Optional configuration for what data to clear
|
|
14863
14992
|
*
|
|
14993
|
+
* @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
|
|
14994
|
+
* After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
|
|
14995
|
+
*
|
|
14864
14996
|
* @example
|
|
14865
14997
|
* ```js
|
|
14866
14998
|
* // Clear only cookies and localStorage for a specific origin
|
|
14867
14999
|
* await fin.System.clearCacheData({
|
|
14868
15000
|
* dataTypes: ['cookies', 'localStorage'],
|
|
14869
|
-
* origins: ['http://localhost:8081']
|
|
15001
|
+
* origins: ['http://localhost:8081'],
|
|
15002
|
+
* windowState: true
|
|
14870
15003
|
* });
|
|
14871
15004
|
*
|
|
14872
15005
|
* // Clear everything except for a specific origin
|
|
@@ -16635,6 +16768,17 @@ declare type SystemShutdownHandler = (shutdownEvent: {
|
|
|
16635
16768
|
proceed: () => void;
|
|
16636
16769
|
}) => void;
|
|
16637
16770
|
|
|
16771
|
+
/**
|
|
16772
|
+
* @interface
|
|
16773
|
+
* Context for tab aria-label functions.
|
|
16774
|
+
*/
|
|
16775
|
+
declare type TabAriaLabelContext = AccessibilityContext & {
|
|
16776
|
+
title: string;
|
|
16777
|
+
isActive: boolean;
|
|
16778
|
+
tabIndex: number;
|
|
16779
|
+
tabCount: number;
|
|
16780
|
+
};
|
|
16781
|
+
|
|
16638
16782
|
/**
|
|
16639
16783
|
* Generated when a Layout Tab Component was closed.
|
|
16640
16784
|
* @interface
|
|
@@ -18003,6 +18147,53 @@ declare interface ViewStatuses {
|
|
|
18003
18147
|
viewsNotPreventingUnload: Identity_4[];
|
|
18004
18148
|
}
|
|
18005
18149
|
|
|
18150
|
+
/**
|
|
18151
|
+
* @interface
|
|
18152
|
+
* Accessibility options for view tab navigation.
|
|
18153
|
+
*/
|
|
18154
|
+
declare type ViewTabAccessibilityOptions = {
|
|
18155
|
+
/**
|
|
18156
|
+
* Controls which elements are reachable via Tab key navigation.
|
|
18157
|
+
* Uses roving tabindex pattern - only one element focusable at a time.
|
|
18158
|
+
* @default ['active-tab', 'add-tab-button']
|
|
18159
|
+
*/
|
|
18160
|
+
tabNavigation?: ViewTabElements[];
|
|
18161
|
+
/**
|
|
18162
|
+
* Controls which elements are navigable via Arrow keys.
|
|
18163
|
+
* @default ['inactive-tab', 'active-tab', 'active-tab-close-button', 'inactive-tab-close-button', 'add-tab-button']
|
|
18164
|
+
*/
|
|
18165
|
+
arrowNavigation?: ViewTabElements[];
|
|
18166
|
+
/**
|
|
18167
|
+
* Whether Delete/Backspace keys close the focused tab.
|
|
18168
|
+
* @default false
|
|
18169
|
+
*/
|
|
18170
|
+
enableDeleteKeyClose?: boolean;
|
|
18171
|
+
/**
|
|
18172
|
+
* Whether Home/End keys jump to first/last navigable element.
|
|
18173
|
+
* @default false
|
|
18174
|
+
*/
|
|
18175
|
+
enableHomeEndNavigation?: boolean;
|
|
18176
|
+
/**
|
|
18177
|
+
* Custom aria-label providers. Can be a static string or a function receiving context.
|
|
18178
|
+
*/
|
|
18179
|
+
ariaLabels?: AriaLabelOptions;
|
|
18180
|
+
/**
|
|
18181
|
+
* Whether to announce tab changes via aria-live.
|
|
18182
|
+
* @default true
|
|
18183
|
+
*/
|
|
18184
|
+
announceTabChanges?: boolean;
|
|
18185
|
+
/**
|
|
18186
|
+
* Focus behavior when a tab is closed via keyboard.
|
|
18187
|
+
* @default 'next'
|
|
18188
|
+
*/
|
|
18189
|
+
focusOnCloseStrategy?: 'next' | 'previous' | 'active';
|
|
18190
|
+
};
|
|
18191
|
+
|
|
18192
|
+
/**
|
|
18193
|
+
* Elements that can be navigated in view tabs.
|
|
18194
|
+
*/
|
|
18195
|
+
declare type ViewTabElements = 'active-tab' | 'inactive-tab' | 'active-tab-close-button' | 'inactive-tab-close-button' | 'add-tab-button';
|
|
18196
|
+
|
|
18006
18197
|
/**
|
|
18007
18198
|
* View throttling state.
|
|
18008
18199
|
*
|
package/out/stub.d.ts
CHANGED
|
@@ -45,6 +45,16 @@ declare type Accelerator = {
|
|
|
45
45
|
zoom: boolean;
|
|
46
46
|
};
|
|
47
47
|
|
|
48
|
+
/**
|
|
49
|
+
* @interface
|
|
50
|
+
* Shared context available to all aria label functions.
|
|
51
|
+
*/
|
|
52
|
+
declare type AccessibilityContext = {
|
|
53
|
+
arrowNavigationEnabled: boolean;
|
|
54
|
+
deleteKeyCloseEnabled: boolean;
|
|
55
|
+
homeEndNavigationEnabled: boolean;
|
|
56
|
+
};
|
|
57
|
+
|
|
48
58
|
/**
|
|
49
59
|
* Generated when a View is added to a layout.
|
|
50
60
|
* @interface
|
|
@@ -54,6 +64,14 @@ declare type AddedToLayoutEvent = BaseEvent_4 & {
|
|
|
54
64
|
layoutIdentity: OpenFin_2.LayoutIdentity;
|
|
55
65
|
};
|
|
56
66
|
|
|
67
|
+
/**
|
|
68
|
+
* @interface
|
|
69
|
+
* Context for add tab button aria-label functions.
|
|
70
|
+
*/
|
|
71
|
+
declare type AddTabButtonAriaLabelContext = AccessibilityContext & {
|
|
72
|
+
tabCount: number;
|
|
73
|
+
};
|
|
74
|
+
|
|
57
75
|
/**
|
|
58
76
|
* Options to use when adding a view to a {@link TabStack}.
|
|
59
77
|
*
|
|
@@ -1613,6 +1631,17 @@ declare type AppVersionTypeFromIdEvent<T extends IdEventType> = Extract<AppVersi
|
|
|
1613
1631
|
type: WithoutId<T>;
|
|
1614
1632
|
}>;
|
|
1615
1633
|
|
|
1634
|
+
/**
|
|
1635
|
+
* @interface
|
|
1636
|
+
* Custom aria-label providers for accessibility.
|
|
1637
|
+
*/
|
|
1638
|
+
declare type AriaLabelOptions = {
|
|
1639
|
+
activeTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1640
|
+
inactiveTab?: string | ((ctx: TabAriaLabelContext) => string);
|
|
1641
|
+
closeButton?: string | ((ctx: CloseButtonAriaLabelContext) => string);
|
|
1642
|
+
addTabButton?: string | ((ctx: AddTabButtonAriaLabelContext) => string);
|
|
1643
|
+
};
|
|
1644
|
+
|
|
1616
1645
|
declare interface AuthorizationPayload {
|
|
1617
1646
|
token: string;
|
|
1618
1647
|
file: string;
|
|
@@ -3171,6 +3200,11 @@ declare type ClearCacheOption = {
|
|
|
3171
3200
|
* browser data that can be used across sessions
|
|
3172
3201
|
*/
|
|
3173
3202
|
localStorage?: boolean;
|
|
3203
|
+
/**
|
|
3204
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3205
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3206
|
+
*/
|
|
3207
|
+
windowState?: boolean;
|
|
3174
3208
|
};
|
|
3175
3209
|
|
|
3176
3210
|
/**
|
|
@@ -3213,6 +3247,11 @@ declare type ClearDataOptions = {
|
|
|
3213
3247
|
* - `origin-in-all-contexts` - Storage is matched on origin only in all contexts.
|
|
3214
3248
|
*/
|
|
3215
3249
|
originMatchingMode?: 'third-parties-included' | 'origin-in-all-contexts';
|
|
3250
|
+
/**
|
|
3251
|
+
* Clears saved window-state data written for windows that use `saveWindowState`.
|
|
3252
|
+
* After this data is cleared, previously persisted bounds and state (Maximized/Minimized) will not be restored until new state is written again.
|
|
3253
|
+
*/
|
|
3254
|
+
windowState?: boolean;
|
|
3216
3255
|
};
|
|
3217
3256
|
|
|
3218
3257
|
/**
|
|
@@ -3500,6 +3539,15 @@ declare type ClipboardPermissions = {
|
|
|
3500
3539
|
*/
|
|
3501
3540
|
declare type ClipboardSelectionType = 'clipboard' | 'selection';
|
|
3502
3541
|
|
|
3542
|
+
/**
|
|
3543
|
+
* @interface
|
|
3544
|
+
* Context for close button aria-label functions.
|
|
3545
|
+
*/
|
|
3546
|
+
declare type CloseButtonAriaLabelContext = AccessibilityContext & {
|
|
3547
|
+
title: string;
|
|
3548
|
+
isActive: boolean;
|
|
3549
|
+
};
|
|
3550
|
+
|
|
3503
3551
|
/**
|
|
3504
3552
|
* Generated when an application is closed.
|
|
3505
3553
|
* @interface
|
|
@@ -4515,6 +4563,10 @@ declare type CreateLayoutOptions = {
|
|
|
4515
4563
|
* @experimental
|
|
4516
4564
|
*/
|
|
4517
4565
|
renderCustomHeaderControls?: (controlsElement: HTMLElement, context: HeaderControlsContext) => (() => void) | void;
|
|
4566
|
+
/**
|
|
4567
|
+
* Accessibility options for the layout. Controls ARIA attributes and keyboard navigation.
|
|
4568
|
+
*/
|
|
4569
|
+
accessibilityOptions?: LayoutAccessibilityOptions;
|
|
4518
4570
|
};
|
|
4519
4571
|
|
|
4520
4572
|
/**
|
|
@@ -5203,7 +5255,7 @@ declare interface Environment {
|
|
|
5203
5255
|
layoutAllowedInContext(fin: OpenFin_2.Fin<OpenFin_2.EntityType>): boolean;
|
|
5204
5256
|
initLayoutManager(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, wire: Transport, options: OpenFin_2.InitLayoutOptions): Promise<OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>>;
|
|
5205
5257
|
applyLayoutSnapshot(fin: OpenFin_2.Fin<OpenFin_2.EntityType>, layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.InitLayoutOptions): Promise<void>;
|
|
5206
|
-
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<
|
|
5258
|
+
createLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, options: OpenFin_2.CreateLayoutOptions): Promise<OpenFin_2.LayoutSyncApi>;
|
|
5207
5259
|
destroyLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<void>;
|
|
5208
5260
|
resolveLayout(layoutManager: OpenFin_2.LayoutManager<OpenFin_2.LayoutSnapshot>, layoutIdentity: OpenFin_2.LayoutIdentity): Promise<any>;
|
|
5209
5261
|
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 {
|
|
|
8518
8570
|
closeView(viewIdentity: OpenFin_2.Identity): Promise<void>;
|
|
8519
8571
|
}
|
|
8520
8572
|
|
|
8573
|
+
/**
|
|
8574
|
+
* @interface
|
|
8575
|
+
* Accessibility options for layout tab navigation and ARIA support.
|
|
8576
|
+
*/
|
|
8577
|
+
declare type LayoutAccessibilityOptions = {
|
|
8578
|
+
viewTabOptions?: ViewTabAccessibilityOptions;
|
|
8579
|
+
/**
|
|
8580
|
+
* Keyboard shortcut used to move focus from a tab header element into the active tab's web content.
|
|
8581
|
+
*
|
|
8582
|
+
* - Accepts an accelerator-like string, e.g. `'Ctrl+Enter'`, `'Meta+Enter'`, `'Alt+Enter'`, `'Mod+Enter'`.
|
|
8583
|
+
* - `'Mod'`/`'CmdOrCtrl'`/`'CtrlOrMeta'` means Ctrl on Windows/Linux or Meta on macOS.
|
|
8584
|
+
* - Set to `false` to disable this shortcut.
|
|
8585
|
+
* - In core-web, reverse focus transfer (from iframe web content back to tab header) is not reliably supportable
|
|
8586
|
+
* due to browser iframe security and cross-origin focus restrictions. This hotkey is intentionally one-way:
|
|
8587
|
+
* tab header -> web content.
|
|
8588
|
+
*
|
|
8589
|
+
* @defaultValue 'Mod+Enter'
|
|
8590
|
+
*/
|
|
8591
|
+
focusContentHotkey?: string | false;
|
|
8592
|
+
};
|
|
8593
|
+
|
|
8521
8594
|
/**
|
|
8522
8595
|
* @interface
|
|
8523
8596
|
*/
|
|
@@ -8901,7 +8974,7 @@ declare class LayoutModule extends Base {
|
|
|
8901
8974
|
* @returns
|
|
8902
8975
|
*/
|
|
8903
8976
|
getCurrentLayoutManagerSync: <UserSnapshotType extends OpenFin_2.LayoutSnapshot>() => OpenFin_2.LayoutManager<UserSnapshotType>;
|
|
8904
|
-
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<
|
|
8977
|
+
create: (options: OpenFin_2.CreateLayoutOptions) => Promise<OpenFin_2.LayoutSyncApi>;
|
|
8905
8978
|
destroy: (layoutIdentity: OpenFin_2.LayoutIdentity) => Promise<void>;
|
|
8906
8979
|
}
|
|
8907
8980
|
|
|
@@ -9286,6 +9359,19 @@ declare type LayoutStateChangedEvent = LayoutDOMEvent & {
|
|
|
9286
9359
|
type: 'layout-state-changed';
|
|
9287
9360
|
};
|
|
9288
9361
|
|
|
9362
|
+
/**
|
|
9363
|
+
* @interface
|
|
9364
|
+
* Sync API returned from Layout.create() for operations that don't require IPC.
|
|
9365
|
+
* Only available in the window context that owns the layout.
|
|
9366
|
+
*/
|
|
9367
|
+
declare type LayoutSyncApi = {
|
|
9368
|
+
/**
|
|
9369
|
+
* Updates accessibility options at runtime without recreating the layout.
|
|
9370
|
+
* @param options Partial accessibility options to merge with existing options
|
|
9371
|
+
*/
|
|
9372
|
+
updateAccessibilityOptions(options: Partial<LayoutAccessibilityOptions>): void;
|
|
9373
|
+
};
|
|
9374
|
+
|
|
9289
9375
|
/**
|
|
9290
9376
|
* @interface
|
|
9291
9377
|
*/
|
|
@@ -10824,6 +10910,15 @@ declare namespace OpenFin_2 {
|
|
|
10824
10910
|
HeaderControlsContext,
|
|
10825
10911
|
CreateLayoutOptions,
|
|
10826
10912
|
MultiInstanceViewBehavior,
|
|
10913
|
+
LayoutAccessibilityOptions,
|
|
10914
|
+
ViewTabElements,
|
|
10915
|
+
ViewTabAccessibilityOptions,
|
|
10916
|
+
AccessibilityContext,
|
|
10917
|
+
TabAriaLabelContext,
|
|
10918
|
+
CloseButtonAriaLabelContext,
|
|
10919
|
+
AddTabButtonAriaLabelContext,
|
|
10920
|
+
AriaLabelOptions,
|
|
10921
|
+
LayoutSyncApi,
|
|
10827
10922
|
PresetLayoutOptions_2 as PresetLayoutOptions,
|
|
10828
10923
|
ResultBehavior,
|
|
10829
10924
|
PopupBaseBehavior,
|
|
@@ -12640,6 +12735,38 @@ declare interface PlatformProvider {
|
|
|
12640
12735
|
* @returns A promise resolving to `true` if the window should prevent the app from quitting, otherwise `false`.
|
|
12641
12736
|
*/
|
|
12642
12737
|
shouldWindowPreventQuit(windowIdentity: OpenFin_2.Identity): Promise<boolean>;
|
|
12738
|
+
/**
|
|
12739
|
+
* Returns the platform's keyboard commands. Default implementation returns the manifest's
|
|
12740
|
+
* `platform.commands`. Override to inject additional default commands.
|
|
12741
|
+
* Called once during Platform.init; the result is cached for the lifetime
|
|
12742
|
+
* of the platform.
|
|
12743
|
+
*
|
|
12744
|
+
* @remarks
|
|
12745
|
+
* The returned commands are merged with core's built-in default commands
|
|
12746
|
+
* (unless `disableDefaultCommands` is set).
|
|
12747
|
+
* Overriders receive the raw manifest commands from `super` and can prepend
|
|
12748
|
+
* their own defaults — returned commands override default commands by command name.
|
|
12749
|
+
*
|
|
12750
|
+
* @example
|
|
12751
|
+
* ```js
|
|
12752
|
+
* const overrideCallback = (PlatformProvider) => {
|
|
12753
|
+
* class Override extends PlatformProvider {
|
|
12754
|
+
* getKeyboardCommands() {
|
|
12755
|
+
* const manifestCommands = super.getKeyboardCommands();
|
|
12756
|
+
* const myCommands = [{ command: 'myApp.search', keys: 'Ctrl+K' }];
|
|
12757
|
+
* return [
|
|
12758
|
+
* ...myCommands,
|
|
12759
|
+
* ...manifestCommands
|
|
12760
|
+
* ];
|
|
12761
|
+
* }
|
|
12762
|
+
* }
|
|
12763
|
+
* return new Override();
|
|
12764
|
+
* }
|
|
12765
|
+
*
|
|
12766
|
+
* fin.Platform.init({ overrideCallback });
|
|
12767
|
+
* ```
|
|
12768
|
+
*/
|
|
12769
|
+
getKeyboardCommands(): OpenFin_2.ShortcutOverride[];
|
|
12643
12770
|
/**
|
|
12644
12771
|
* 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
|
|
12645
12772
|
*/
|
|
@@ -15253,13 +15380,15 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
15253
15380
|
* * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
|
|
15254
15381
|
* * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
|
|
15255
15382
|
* * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
|
|
15383
|
+
* * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
|
|
15256
15384
|
* @example
|
|
15257
15385
|
* ```js
|
|
15258
15386
|
* const clearCacheOptions = {
|
|
15259
15387
|
* appcache: true,
|
|
15260
15388
|
* cache: true,
|
|
15261
15389
|
* cookies: true,
|
|
15262
|
-
* localStorage: true
|
|
15390
|
+
* localStorage: true,
|
|
15391
|
+
* windowState: true
|
|
15263
15392
|
* };
|
|
15264
15393
|
* fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
|
|
15265
15394
|
* ```
|
|
@@ -15284,12 +15413,16 @@ declare class System extends EmitterBase<OpenFin_2.SystemEvent> {
|
|
|
15284
15413
|
*
|
|
15285
15414
|
* @param options - Optional configuration for what data to clear
|
|
15286
15415
|
*
|
|
15416
|
+
* @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
|
|
15417
|
+
* After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
|
|
15418
|
+
*
|
|
15287
15419
|
* @example
|
|
15288
15420
|
* ```js
|
|
15289
15421
|
* // Clear only cookies and localStorage for a specific origin
|
|
15290
15422
|
* await fin.System.clearCacheData({
|
|
15291
15423
|
* dataTypes: ['cookies', 'localStorage'],
|
|
15292
|
-
* origins: ['http://localhost:8081']
|
|
15424
|
+
* origins: ['http://localhost:8081'],
|
|
15425
|
+
* windowState: true
|
|
15293
15426
|
* });
|
|
15294
15427
|
*
|
|
15295
15428
|
* // Clear everything except for a specific origin
|
|
@@ -17064,6 +17197,17 @@ declare type SystemShutdownHandler = (shutdownEvent: {
|
|
|
17064
17197
|
proceed: () => void;
|
|
17065
17198
|
}) => void;
|
|
17066
17199
|
|
|
17200
|
+
/**
|
|
17201
|
+
* @interface
|
|
17202
|
+
* Context for tab aria-label functions.
|
|
17203
|
+
*/
|
|
17204
|
+
declare type TabAriaLabelContext = AccessibilityContext & {
|
|
17205
|
+
title: string;
|
|
17206
|
+
isActive: boolean;
|
|
17207
|
+
tabIndex: number;
|
|
17208
|
+
tabCount: number;
|
|
17209
|
+
};
|
|
17210
|
+
|
|
17067
17211
|
/**
|
|
17068
17212
|
* Generated when a Layout Tab Component was closed.
|
|
17069
17213
|
* @interface
|
|
@@ -18470,6 +18614,53 @@ declare interface ViewStatuses {
|
|
|
18470
18614
|
viewsNotPreventingUnload: Identity_4[];
|
|
18471
18615
|
}
|
|
18472
18616
|
|
|
18617
|
+
/**
|
|
18618
|
+
* @interface
|
|
18619
|
+
* Accessibility options for view tab navigation.
|
|
18620
|
+
*/
|
|
18621
|
+
declare type ViewTabAccessibilityOptions = {
|
|
18622
|
+
/**
|
|
18623
|
+
* Controls which elements are reachable via Tab key navigation.
|
|
18624
|
+
* Uses roving tabindex pattern - only one element focusable at a time.
|
|
18625
|
+
* @default ['active-tab', 'add-tab-button']
|
|
18626
|
+
*/
|
|
18627
|
+
tabNavigation?: ViewTabElements[];
|
|
18628
|
+
/**
|
|
18629
|
+
* Controls which elements are navigable via Arrow keys.
|
|
18630
|
+
* @default ['inactive-tab', 'active-tab', 'active-tab-close-button', 'inactive-tab-close-button', 'add-tab-button']
|
|
18631
|
+
*/
|
|
18632
|
+
arrowNavigation?: ViewTabElements[];
|
|
18633
|
+
/**
|
|
18634
|
+
* Whether Delete/Backspace keys close the focused tab.
|
|
18635
|
+
* @default false
|
|
18636
|
+
*/
|
|
18637
|
+
enableDeleteKeyClose?: boolean;
|
|
18638
|
+
/**
|
|
18639
|
+
* Whether Home/End keys jump to first/last navigable element.
|
|
18640
|
+
* @default false
|
|
18641
|
+
*/
|
|
18642
|
+
enableHomeEndNavigation?: boolean;
|
|
18643
|
+
/**
|
|
18644
|
+
* Custom aria-label providers. Can be a static string or a function receiving context.
|
|
18645
|
+
*/
|
|
18646
|
+
ariaLabels?: AriaLabelOptions;
|
|
18647
|
+
/**
|
|
18648
|
+
* Whether to announce tab changes via aria-live.
|
|
18649
|
+
* @default true
|
|
18650
|
+
*/
|
|
18651
|
+
announceTabChanges?: boolean;
|
|
18652
|
+
/**
|
|
18653
|
+
* Focus behavior when a tab is closed via keyboard.
|
|
18654
|
+
* @default 'next'
|
|
18655
|
+
*/
|
|
18656
|
+
focusOnCloseStrategy?: 'next' | 'previous' | 'active';
|
|
18657
|
+
};
|
|
18658
|
+
|
|
18659
|
+
/**
|
|
18660
|
+
* Elements that can be navigated in view tabs.
|
|
18661
|
+
*/
|
|
18662
|
+
declare type ViewTabElements = 'active-tab' | 'inactive-tab' | 'active-tab-close-button' | 'inactive-tab-close-button' | 'add-tab-button';
|
|
18663
|
+
|
|
18473
18664
|
/**
|
|
18474
18665
|
* View throttling state.
|
|
18475
18666
|
*
|
package/out/stub.js
CHANGED
|
@@ -5170,13 +5170,15 @@ class System extends EmitterBase {
|
|
|
5170
5170
|
* * cookies: browser [cookies](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies)
|
|
5171
5171
|
* * localStorage: browser data that can be used across sessions ([local storage](https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage))
|
|
5172
5172
|
* * appcache: html5 [application cache](https://developer.mozilla.org/en-US/docs/Web/HTML/Using_the_application_cache)
|
|
5173
|
+
* * windowState: clears data written for windows using `saveWindowState`; after clearing, previously saved bounds and state will not be restored until new state is written
|
|
5173
5174
|
* @example
|
|
5174
5175
|
* ```js
|
|
5175
5176
|
* const clearCacheOptions = {
|
|
5176
5177
|
* appcache: true,
|
|
5177
5178
|
* cache: true,
|
|
5178
5179
|
* cookies: true,
|
|
5179
|
-
* localStorage: true
|
|
5180
|
+
* localStorage: true,
|
|
5181
|
+
* windowState: true
|
|
5180
5182
|
* };
|
|
5181
5183
|
* fin.System.clearCache(clearCacheOptions).then(() => console.log('Cache cleared')).catch(err => console.log(err));
|
|
5182
5184
|
* ```
|
|
@@ -5205,12 +5207,16 @@ class System extends EmitterBase {
|
|
|
5205
5207
|
*
|
|
5206
5208
|
* @param options - Optional configuration for what data to clear
|
|
5207
5209
|
*
|
|
5210
|
+
* @remarks Set `windowState: true` to also clear data written for windows using `saveWindowState`.
|
|
5211
|
+
* After this data is cleared, previously saved bounds and state will not be restored until new state is written again.
|
|
5212
|
+
*
|
|
5208
5213
|
* @example
|
|
5209
5214
|
* ```js
|
|
5210
5215
|
* // Clear only cookies and localStorage for a specific origin
|
|
5211
5216
|
* await fin.System.clearCacheData({
|
|
5212
5217
|
* dataTypes: ['cookies', 'localStorage'],
|
|
5213
|
-
* origins: ['http://localhost:8081']
|
|
5218
|
+
* origins: ['http://localhost:8081'],
|
|
5219
|
+
* windowState: true
|
|
5214
5220
|
* });
|
|
5215
5221
|
*
|
|
5216
5222
|
* // Clear everything except for a specific origin
|