@openfin/core 34.78.11 → 34.78.13

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.
@@ -7,6 +7,8 @@ import { EventEmitter } from 'events';
7
7
 
8
8
  /**
9
9
  * Enable keyboard shortcuts for devtools, zoom, reload, and reload ignoring cache.
10
+ *
11
+ * @interface
10
12
  */
11
13
  declare type Accelerator = {
12
14
  /**
@@ -43,6 +45,9 @@ declare type Accelerator = {
43
45
  zoom: boolean;
44
46
  };
45
47
 
48
+ /**
49
+ * @interface
50
+ */
46
51
  declare type AddViewToStackOptions = {
47
52
  /**
48
53
  * Optional index within the stack to insert the view. Defaults to 0
@@ -66,6 +71,8 @@ declare type AnyStrategy = ClassicStrategy | RTCStrategy | CombinedStrategy<Payl
66
71
 
67
72
  /**
68
73
  * Configurations for API injection.
74
+ *
75
+ * @interface
69
76
  */
70
77
  declare type Api = {
71
78
  /**
@@ -93,6 +100,9 @@ declare type ApiClient<T extends Record<any, any>> = {
93
100
  [key in keyof PickOfType<T, Function>]: (...args: Parameters<T[key]>) => ReturnType<T[key]> extends Promise<any> ? ReturnType<T[key]> : Promise<ReturnType<T[key]>>;
94
101
  };
95
102
 
103
+ /**
104
+ * @interface
105
+ */
96
106
  declare type AppAssetInfo = {
97
107
  /**
98
108
  * The URL to a zip file containing the package files (executables, dlls, etc…)
@@ -121,6 +131,9 @@ declare type AppAssetInfo = {
121
131
  mandatory?: boolean;
122
132
  };
123
133
 
134
+ /**
135
+ * @interface
136
+ */
124
137
  declare type AppAssetRequest = {
125
138
  alias: string;
126
139
  };
@@ -891,10 +904,16 @@ declare type ApplicationEventType = ApplicationEvent['type'];
891
904
 
892
905
  declare type ApplicationIdentity = OpenFin_2.ApplicationIdentity;
893
906
 
907
+ /**
908
+ * @interface
909
+ */
894
910
  declare type ApplicationIdentity_2 = {
895
911
  uuid: string;
896
912
  };
897
913
 
914
+ /**
915
+ * @interface
916
+ */
898
917
  declare type ApplicationInfo = {
899
918
  initialOptions: ApplicationCreationOptions;
900
919
  launchMode: string;
@@ -1156,17 +1175,30 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1156
1175
  * When set to `false` it will disable the same-origin policy for the app.
1157
1176
  */
1158
1177
  webSecurity: boolean;
1178
+ /**
1179
+ * Configuration for keyboard commands.
1180
+ * For details and usage, see {@link https://developers.openfin.co/docs/platform-api#section-5-3-using-keyboard-commands Using Keyboard Commands}.
1181
+ */
1159
1182
  commands: ShortcutOverride[];
1160
1183
  isPlatformController: boolean;
1161
1184
  /**
1162
1185
  * @defaultValue 1000
1163
1186
  *
1164
- * Platforms Only. The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed.
1187
+ * Platforms Only. The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed.
1165
1188
  * If you do not wish for views to be pooled on your platform, set this property to zero.
1166
1189
  */
1167
1190
  maxViewPoolSize: number;
1191
+ /**
1192
+ * Platforms Only. Default window options apply to all platform windows.
1193
+ */
1168
1194
  defaultWindowOptions: Partial<WindowOptions>;
1195
+ /**
1196
+ * Platforms Only. Default view options apply to all platform views.
1197
+ */
1169
1198
  defaultViewOptions: Partial<ViewOptions>;
1199
+ /**
1200
+ * Platforms Only. The snapshot to be applied.
1201
+ */
1170
1202
  snapshot: Snapshot;
1171
1203
  /**
1172
1204
  * @defaultValue false
@@ -1176,18 +1208,39 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1176
1208
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1177
1209
  */
1178
1210
  preventQuitOnLastWindowClosed: boolean;
1211
+ /**
1212
+ * Configuration for interop broker.
1213
+ */
1179
1214
  interopBrokerConfiguration: InteropBrokerOptions;
1215
+ /**
1216
+ * @defaultValue true
1217
+ *
1218
+ * When set to `false` it will disable OpenFin Diagnostics for the app.
1219
+ */
1180
1220
  apiDiagnostics: boolean;
1221
+ /**
1222
+ * Define the file download rules.
1223
+ * See [here](https://developers.openfin.co/of-docs/docs/file-download#manifest-properties-for-file-downloads) for more details.
1224
+ */
1181
1225
  defaultDomainSettings: DefaultDomainSettings;
1182
1226
  /**
1183
1227
  * @defaultValue false
1228
+ *
1184
1229
  * Enables the use of the Jumplists API and the 'pin to taskbar' functionality.
1185
1230
  * Only relevant in Windows.
1186
1231
  */
1187
1232
  enableJumpList: boolean;
1233
+ /**
1234
+ * @defaultValue false
1235
+ *
1236
+ * When set to `true`, any `beforeunload` handler set on the app will fire.
1237
+ */
1188
1238
  enableBeforeUnload: boolean;
1189
1239
  };
1190
1240
 
1241
+ /**
1242
+ * @interface
1243
+ */
1191
1244
  declare type ApplicationPermissions = {
1192
1245
  setFileDownloadLocation: boolean;
1193
1246
  getFileDownloadLocation: boolean;
@@ -1195,6 +1248,9 @@ declare type ApplicationPermissions = {
1195
1248
 
1196
1249
  declare type ApplicationState = OpenFin_2.ApplicationState;
1197
1250
 
1251
+ /**
1252
+ * @interface
1253
+ */
1198
1254
  declare type ApplicationState_2 = {
1199
1255
  /**
1200
1256
  * True when the application is a Platform controller
@@ -1214,6 +1270,9 @@ declare type ApplicationState_2 = {
1214
1270
  parentUuid?: string;
1215
1271
  };
1216
1272
 
1273
+ /**
1274
+ * @interface
1275
+ */
1217
1276
  declare type ApplicationType = {
1218
1277
  type: 'application' | 'external-app';
1219
1278
  uuid: string;
@@ -1226,6 +1285,9 @@ declare type ApplicationWindowEvent = WindowAlertRequestedEvent | WindowCreatedE
1226
1285
 
1227
1286
  declare type ApplicationWindowInfo = OpenFin_2.ApplicationWindowInfo;
1228
1287
 
1288
+ /**
1289
+ * @interface
1290
+ */
1229
1291
  declare type ApplicationWindowInfo_2 = {
1230
1292
  childWindows: Array<WindowDetail>;
1231
1293
  mainWindow: WindowDetail;
@@ -1235,6 +1297,9 @@ declare type ApplicationWindowInfo_2 = {
1235
1297
  uuid: string;
1236
1298
  };
1237
1299
 
1300
+ /**
1301
+ * @interface
1302
+ */
1238
1303
  declare type ApplySnapshotOptions = {
1239
1304
  /**
1240
1305
  * @defaultValue false
@@ -1262,10 +1327,12 @@ declare type ApplySnapshotOptions = {
1262
1327
 
1263
1328
  /**
1264
1329
  * Payload sent to Platform Provider when {@link Platform#applySnapshot Platform.applySnapshot} is called.
1330
+ *
1331
+ * @interface
1265
1332
  */
1266
1333
  declare type ApplySnapshotPayload = {
1267
1334
  /**
1268
- * TThe snapshot to be applied.
1335
+ * The snapshot to be applied.
1269
1336
  */
1270
1337
  snapshot: Snapshot;
1271
1338
  /**
@@ -1274,6 +1341,9 @@ declare type ApplySnapshotPayload = {
1274
1341
  options?: ApplySnapshotOptions;
1275
1342
  };
1276
1343
 
1344
+ /**
1345
+ * @interface
1346
+ */
1277
1347
  declare type AppProcessInfo = {
1278
1348
  /**
1279
1349
  * The uuid of the application.
@@ -1293,6 +1363,9 @@ declare type AppVersionCompleteEvent = {
1293
1363
  type: 'app-version-complete';
1294
1364
  } & AppVersionProgress;
1295
1365
 
1366
+ /**
1367
+ * @interface
1368
+ */
1296
1369
  declare type AppVersionError = {
1297
1370
  error: string;
1298
1371
  srcManifest: string;
@@ -1318,6 +1391,9 @@ declare type AppVersionEventType = AppVersionEvent['type'];
1318
1391
 
1319
1392
  /* Excluded from this release type: AppVersionEventWithId */
1320
1393
 
1394
+ /**
1395
+ * @interface
1396
+ */
1321
1397
  declare type AppVersionProgress = {
1322
1398
  manifest: string | null;
1323
1399
  srcManifest: string;
@@ -1331,6 +1407,9 @@ declare type AppVersionProgressEvent = {
1331
1407
  type: 'app-version-progress';
1332
1408
  } & AppVersionProgress;
1333
1409
 
1410
+ /**
1411
+ * @interface
1412
+ */
1334
1413
  declare type AppVersionRuntimeInfo = {
1335
1414
  version: string | null;
1336
1415
  exists: boolean | null;
@@ -1445,6 +1524,9 @@ declare type AuthRequestedEvent = NamedEvent & {
1445
1524
  */
1446
1525
  declare type AutoplayPolicyOptions = 'no-user-gesture-required' | 'user-gesture-required' | 'document-user-activation-required';
1447
1526
 
1527
+ /**
1528
+ * @interface
1529
+ */
1448
1530
  declare type AutoResizeOptions = {
1449
1531
  /**
1450
1532
  * If true, the view's width will grow and shrink together with the window. false
@@ -1472,6 +1554,13 @@ declare class Base {
1472
1554
  /* Excluded from this release type: wire */
1473
1555
  /* Excluded from this release type: __constructor */
1474
1556
  protected get fin(): OpenFin_2.Fin<OpenFin_2.EntityType>;
1557
+ /**
1558
+ * Provides access to the OpenFin representation of the current code context (usually a document
1559
+ * such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as to the current `Interop` context.
1560
+ *
1561
+ * Useful for debugging in the devtools console, where this will intelligently type itself based
1562
+ * on the context in which the devtools panel was opened.
1563
+ */
1475
1564
  get me(): Identity;
1476
1565
  protected isNodeEnvironment: () => boolean;
1477
1566
  protected isOpenFinEnvironment: () => boolean;
@@ -1487,6 +1576,9 @@ declare type BaseChannelEvent = NamedEvent & {
1487
1576
  channelId: string;
1488
1577
  };
1489
1578
 
1579
+ /**
1580
+ * @interface
1581
+ */
1490
1582
  declare type BaseClipboardRequest = {
1491
1583
  /**
1492
1584
  * The type of clipboard to write to, can be 'clipboard' or 'selection'.
@@ -1577,8 +1669,9 @@ declare type BaseViewEvent = NamedEvent & {
1577
1669
 
1578
1670
  /**
1579
1671
  * User decision of whether a Window or specific View should close when trying to prevent an unload.
1672
+ * @interface
1580
1673
  */
1581
- declare interface BeforeUnloadUserDecision {
1674
+ declare type BeforeUnloadUserDecision = {
1582
1675
  /**
1583
1676
  * Specifies if the Window should close.
1584
1677
  */
@@ -1587,7 +1680,7 @@ declare interface BeforeUnloadUserDecision {
1587
1680
  * Array of views that will close.
1588
1681
  */
1589
1682
  viewsToClose: Identity_5[];
1590
- }
1683
+ };
1591
1684
 
1592
1685
  /**
1593
1686
  * Generated at the beginning of a user-driven change to a window's size or position.
@@ -1605,6 +1698,9 @@ declare type BlurredEvent = NamedEvent & {
1605
1698
  type: 'blurred';
1606
1699
  };
1607
1700
 
1701
+ /**
1702
+ * @interface
1703
+ */
1608
1704
  declare type Bounds = {
1609
1705
  top: number;
1610
1706
  left: number;
@@ -1643,8 +1739,10 @@ declare type BoundsChangingEvent = BoundsChangeEvent & {
1643
1739
 
1644
1740
  /**
1645
1741
  * Configuration for page capture.
1742
+ *
1743
+ * @interface
1646
1744
  */
1647
- declare interface CapturePageOptions {
1745
+ declare type CapturePageOptions = {
1648
1746
  /**
1649
1747
  * The area of the window to be captured.
1650
1748
  */
@@ -1661,8 +1759,11 @@ declare interface CapturePageOptions {
1661
1759
  * Quality of JPEG image. Between 0 - 100.
1662
1760
  */
1663
1761
  quality?: number;
1664
- }
1762
+ };
1665
1763
 
1764
+ /**
1765
+ * @interface
1766
+ */
1666
1767
  declare type Certificate = {
1667
1768
  data: string;
1668
1769
  fingerprint: string;
@@ -1687,6 +1788,9 @@ declare type CertificateErrorEvent = NamedEvent & {
1687
1788
  certificate: OpenFin_2.Certificate;
1688
1789
  };
1689
1790
 
1791
+ /**
1792
+ * @interface
1793
+ */
1690
1794
  declare type CertificatePrincipal = {
1691
1795
  commonName: string;
1692
1796
  country: string;
@@ -1706,6 +1810,9 @@ declare type CertificateSelectionShownEvent = NamedEvent & {
1706
1810
  certificates: OpenFin_2.Certificate[];
1707
1811
  };
1708
1812
 
1813
+ /**
1814
+ * @interface
1815
+ */
1709
1816
  declare type CertificationInfo = {
1710
1817
  serial?: string;
1711
1818
  subject?: string;
@@ -1714,6 +1821,9 @@ declare type CertificationInfo = {
1714
1821
  trusted?: boolean;
1715
1822
  };
1716
1823
 
1824
+ /**
1825
+ * @interface
1826
+ */
1717
1827
  declare type CertifiedAppInfo = {
1718
1828
  isRunning: boolean;
1719
1829
  isOptedIntoCertfiedApp?: boolean;
@@ -2301,6 +2411,8 @@ declare type ChannelConnectOptions = ChannelCreateOptions & {
2301
2411
 
2302
2412
  /**
2303
2413
  * Channel provider creation options.
2414
+ *
2415
+ * @interface
2304
2416
  */
2305
2417
  declare type ChannelCreateOptions = {
2306
2418
  /**
@@ -2607,6 +2719,9 @@ declare class ClassicStrategy implements ChannelStrategy<EndpointPayload> {
2607
2719
  isValidEndpointPayload(payload: any): payload is EndpointPayload;
2608
2720
  }
2609
2721
 
2722
+ /**
2723
+ * @interface
2724
+ */
2610
2725
  declare type ClearCacheOption = {
2611
2726
  /**
2612
2727
  * html5 application cache
@@ -2626,9 +2741,17 @@ declare type ClearCacheOption = {
2626
2741
  localStorage?: boolean;
2627
2742
  };
2628
2743
 
2629
- declare type ClickedMenuResult<T extends unknown = unknown> = {
2744
+ /**
2745
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
2746
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
2747
+ * of all possible data shapes for the entire menu, and the click handler should process
2748
+ * these with a "reducer" pattern.
2749
+ *
2750
+ * @interface
2751
+ */
2752
+ declare type ClickedMenuResult<Data extends unknown = unknown> = {
2630
2753
  result: 'clicked';
2631
- data: T;
2754
+ data: Data;
2632
2755
  };
2633
2756
 
2634
2757
  /**
@@ -2637,7 +2760,7 @@ declare type ClickedMenuResult<T extends unknown = unknown> = {
2637
2760
  declare type ClientConnectionPayload = ClientIdentity & ClientInfo;
2638
2761
 
2639
2762
  /**
2640
- * Identity of a channel client
2763
+ * Identity of a channel client. Includes endpointId to differentiate between different connections for an entity.
2641
2764
  * @interface
2642
2765
  */
2643
2766
  declare type ClientIdentity = Identity_5 & {
@@ -2855,10 +2978,16 @@ declare type ClosedEvent = IdentityEvent & {
2855
2978
  type: 'closed';
2856
2979
  };
2857
2980
 
2981
+ /**
2982
+ * @interface
2983
+ */
2858
2984
  declare type ClosedMenuResult = {
2859
2985
  result: 'closed';
2860
2986
  };
2861
2987
 
2988
+ /**
2989
+ * @interface
2990
+ */
2862
2991
  declare type CloseViewPayload = {
2863
2992
  /**
2864
2993
  *View to be closed.
@@ -2867,6 +2996,8 @@ declare type CloseViewPayload = {
2867
2996
  };
2868
2997
 
2869
2998
  /**
2999
+ * @interface
3000
+ *
2870
3001
  * Represents the shape of payload that contains the Window Identity and related options.
2871
3002
  */
2872
3003
  declare interface CloseWindowPayload {
@@ -2945,6 +3076,8 @@ declare type ConstructorOverride<T> = (Base: Constructor<T>) => Constructor<T>;
2945
3076
 
2946
3077
  /**
2947
3078
  * View options that cannot be updated after creation.
3079
+ *
3080
+ * @interface
2948
3081
  */
2949
3082
  declare type ConstViewOptions = {
2950
3083
  /**
@@ -2997,6 +3130,11 @@ declare type ConstViewOptions = {
2997
3130
  zoomLevel: number;
2998
3131
  experimental: any;
2999
3132
  fdc3InteropApi?: string;
3133
+ /**
3134
+ * @defaultValue false
3135
+ *
3136
+ * When set to `true`, any `beforeunload` handler set on Views will fire.
3137
+ */
3000
3138
  enableBeforeUnload: boolean;
3001
3139
  /**
3002
3140
  * Enable keyboard shortcuts for devtools, zoom, reload, and reload ignoring cache.
@@ -3012,6 +3150,8 @@ declare type ConstViewOptions = {
3012
3150
 
3013
3151
  /**
3014
3152
  * Window options that cannot be changed after creation.
3153
+ *
3154
+ * @interface
3015
3155
  */
3016
3156
  declare type ConstWindowOptions = {
3017
3157
  /**
@@ -3213,6 +3353,8 @@ declare type ContentCreationBehaviorNames = 'window' | 'view' | 'block' | 'brows
3213
3353
 
3214
3354
  /**
3215
3355
  * Configures how new content (e,g, from `window.open` or a link) is opened.
3356
+ *
3357
+ * @interface
3216
3358
  */
3217
3359
  declare type ContentCreationOptions = {
3218
3360
  /**
@@ -3225,13 +3367,12 @@ declare type ContentCreationOptions = {
3225
3367
  * A rule for creating content in OpenFin; maps a content type to the way in which
3226
3368
  * newly-opened content of that type will be handled.
3227
3369
  *
3228
- * @property { string } behavior 'view' | 'window' | 'browser' | 'block'
3229
- * @property { string[] } match List of [match patterns](https://developer.chrome.com/extensions/match_patterns).
3230
- * @property { object } options Window creation options or View creation options.
3370
+ *
3371
+ * @interface
3231
3372
  */
3232
3373
  declare type ContentCreationRule<T = ContentCreationBehaviorNames> = {
3233
3374
  /**
3234
- * Behavior to use when opening matched content.
3375
+ * Behavior to use when opening matched content. The value could be 'view' | 'window' | 'browser' | 'block'.
3235
3376
  */
3236
3377
  behavior: T;
3237
3378
  /**
@@ -3280,6 +3421,8 @@ declare type ContentCreationRulesEvent = NamedEvent & {
3280
3421
  * Restrict navigation to URLs that match an allowed pattern.
3281
3422
  * In the lack of an allowlist, navigation to URLs that match a denied pattern would be prohibited.
3282
3423
  * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3424
+ *
3425
+ * @interface
3283
3426
  */
3284
3427
  declare type ContentNavigation = NavigationRules;
3285
3428
 
@@ -3287,11 +3430,15 @@ declare type ContentNavigation = NavigationRules;
3287
3430
  * Restrict redirects to URLs that match an allowed pattern.
3288
3431
  * In the lack of an allowlist, redirects to URLs that match a denied pattern would be prohibited.
3289
3432
  * See [here](https://developer.chrome.com/extensions/match_patterns) for more details.
3433
+ *
3434
+ * @interface
3290
3435
  */
3291
3436
  declare type ContentRedirect = NavigationRules;
3292
3437
 
3293
3438
  /**
3294
3439
  * Data passed between entities and applications.
3440
+ *
3441
+ * @interface
3295
3442
  */
3296
3443
  declare type Context = {
3297
3444
  /**
@@ -3317,6 +3464,12 @@ declare type ContextForIntent<MetadataType = any> = Context & {
3317
3464
  metadata?: MetadataType;
3318
3465
  };
3319
3466
 
3467
+ /**
3468
+ * Information for a Context Group. Contains metadata for displaying the group properly.
3469
+ */
3470
+ /**
3471
+ * @interface
3472
+ */
3320
3473
  declare type ContextGroupInfo = {
3321
3474
  /**
3322
3475
  * Unique identifier of the context group.
@@ -3334,10 +3487,15 @@ declare type ContextGroupStates = {
3334
3487
  };
3335
3488
  };
3336
3489
 
3490
+ /**
3491
+ * Subscription function for addContextHandler.
3492
+ */
3337
3493
  declare type ContextHandler = (context: Context) => void;
3338
3494
 
3339
3495
  /**
3340
3496
  * Configure the context menu when right-clicking on a window.
3497
+ *
3498
+ * @interface
3341
3499
  */
3342
3500
  declare type ContextMenuOptions = {
3343
3501
  /**
@@ -3353,6 +3511,8 @@ declare type ContextMenuOptions = {
3353
3511
  /**
3354
3512
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
3355
3513
  * Configure the context menu when right-clicking on a window.
3514
+ *
3515
+ * @interface
3356
3516
  */
3357
3517
  declare type ContextMenuSettings = {
3358
3518
  /**
@@ -3369,12 +3529,18 @@ declare type ContextMenuSettings = {
3369
3529
  reload?: boolean;
3370
3530
  };
3371
3531
 
3532
+ /**
3533
+ * @interface
3534
+ */
3372
3535
  declare type CookieInfo = {
3373
3536
  name: string;
3374
3537
  domain: string;
3375
3538
  path: string;
3376
3539
  };
3377
3540
 
3541
+ /**
3542
+ * @interface
3543
+ */
3378
3544
  declare type CookieOption = {
3379
3545
  name: string;
3380
3546
  };
@@ -3382,6 +3548,8 @@ declare type CookieOption = {
3382
3548
  /**
3383
3549
  * Defines and applies rounded corners for a frameless window. **NOTE:** On macOS corner is not ellipse but circle rounded by the
3384
3550
  * average of _height_ and _width_.
3551
+ *
3552
+ * @interface
3385
3553
  */
3386
3554
  declare type CornerRounding = {
3387
3555
  /**
@@ -3398,6 +3566,9 @@ declare type CornerRounding = {
3398
3566
  width: number;
3399
3567
  };
3400
3568
 
3569
+ /**
3570
+ * @interface
3571
+ */
3401
3572
  declare type CpuInfo = {
3402
3573
  /**
3403
3574
  * The model of the cpu
@@ -3427,6 +3598,9 @@ declare type CrashedEvent = NamedEvent & {
3427
3598
  };
3428
3599
  };
3429
3600
 
3601
+ /**
3602
+ * @interface
3603
+ */
3430
3604
  declare type CrashReporterOptions = {
3431
3605
  /**
3432
3606
  * In diagnostics mode the crash reporter will send diagnostic logs to
@@ -3454,6 +3628,9 @@ declare type CreatedEvent = BaseViewEvent & {
3454
3628
  type: 'created';
3455
3629
  };
3456
3630
 
3631
+ /**
3632
+ * @interface
3633
+ */
3457
3634
  declare type CreateViewPayload = {
3458
3635
  /**
3459
3636
  * Options for the view to be added.
@@ -3482,6 +3659,8 @@ declare type CreateViewTarget = Identity_5 & {
3482
3659
 
3483
3660
  /**
3484
3661
  * Custom headers for requests sent by the window.
3662
+ *
3663
+ * @interface
3485
3664
  */
3486
3665
  declare type CustomRequestHeaders = {
3487
3666
  /**
@@ -3495,10 +3674,16 @@ declare type CustomRequestHeaders = {
3495
3674
  headers: WebRequestHeader[];
3496
3675
  };
3497
3676
 
3677
+ /**
3678
+ * @interface
3679
+ */
3498
3680
  declare type DefaultDomainSettings = {
3499
3681
  rules: DefaultDomainSettingsRule[];
3500
3682
  };
3501
3683
 
3684
+ /**
3685
+ * @interface
3686
+ */
3502
3687
  declare type DefaultDomainSettingsRule = {
3503
3688
  match: string[];
3504
3689
  options: {
@@ -3554,6 +3739,9 @@ declare type DipRect = RectangleByEdgePositions & {
3554
3739
  scaledRect: RectangleByEdgePositions;
3555
3740
  };
3556
3741
 
3742
+ /**
3743
+ * @interface
3744
+ */
3557
3745
  declare type DipScaleRects = {
3558
3746
  dipRect: RectangleByEdgePositions;
3559
3747
  scaledRect: RectangleByEdgePositions;
@@ -3577,6 +3765,8 @@ declare type DisabledMovementBoundsChangingEvent = BoundsChangeEvent & {
3577
3765
 
3578
3766
  /**
3579
3767
  * The display data for a context group.
3768
+ *
3769
+ * @interface
3580
3770
  */
3581
3771
  declare type DisplayMetadata = {
3582
3772
  /**
@@ -3595,6 +3785,8 @@ declare type DisplayMetadata = {
3595
3785
 
3596
3786
  /**
3597
3787
  * Metadata returned from a preload script download request.
3788
+ *
3789
+ * @interface
3598
3790
  */
3599
3791
  declare type DownloadPreloadInfo = {
3600
3792
  /**
@@ -3613,6 +3805,8 @@ declare type DownloadPreloadInfo = {
3613
3805
 
3614
3806
  /**
3615
3807
  * Options for downloading a preload script.
3808
+ *
3809
+ * @interface
3616
3810
  */
3617
3811
  declare type DownloadPreloadOption = {
3618
3812
  /**
@@ -3621,6 +3815,9 @@ declare type DownloadPreloadOption = {
3621
3815
  url: string;
3622
3816
  };
3623
3817
 
3818
+ /**
3819
+ * @interface
3820
+ */
3624
3821
  declare type DownloadRule = {
3625
3822
  behavior: FileDownloadBehaviorNames;
3626
3823
  match: string[];
@@ -3628,6 +3825,8 @@ declare type DownloadRule = {
3628
3825
 
3629
3826
  /**
3630
3827
  * DPI (dots per inch) configuration for printing.
3828
+ *
3829
+ * @interface
3631
3830
  */
3632
3831
  declare type Dpi = {
3633
3832
  /**
@@ -3690,53 +3889,35 @@ declare class EmitterBase<EmitterEvent extends BaseEvent, EmitterEventType exten
3690
3889
  protected deregisterEventListener: (eventType: EmitterEventType, options?: OpenFin_2.SubscriptionOptions) => Promise<void | EventEmitter>;
3691
3890
  /**
3692
3891
  * Adds a listener to the end of the listeners array for the specified event.
3693
- *
3694
- * @param eventType
3695
- * @param listener
3696
- * @param options
3697
3892
  */
3698
3893
  on<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3699
- addListener: <EventType extends EmitterEventType>(eventType: EventType, listener: OpenFin_2.BaseEvents.EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions) => Promise<this>;
3894
+ /**
3895
+ * Adds a listener to the end of the listeners array for the specified event.
3896
+ */
3897
+ addListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3700
3898
  /**
3701
3899
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired, after which it is removed.
3702
- *
3703
- * @param eventType
3704
- * @param listener
3705
- * @param options
3706
3900
  */
3707
3901
  once<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3708
3902
  /**
3709
3903
  * Adds a listener to the beginning of the listeners array for the specified event.
3710
- *
3711
- * @param eventType
3712
- * @param listener
3713
- * @param options
3714
3904
  */
3715
3905
  prependListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3716
3906
  /**
3717
3907
  * Adds a one time listener for the event. The listener is invoked only the first time the event is fired,
3718
3908
  * after which it is removed. The listener is added to the beginning of the listeners array.
3719
- *
3720
- * @param eventType
3721
- * @param listener
3722
- * @param options
3723
3909
  */
3724
3910
  prependOnceListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3725
3911
  /**
3726
3912
  * Remove a listener from the listener array for the specified event.
3727
3913
  *
3728
3914
  * @remarks Caution: Calling this method changes the array indices in the listener array behind the listener.
3729
- *
3730
- * @param eventType
3731
- * @param listener
3732
- * @param options
3733
3915
  */
3734
3916
  removeListener<EventType extends EmitterEventType>(eventType: EventType, listener: EventHandler<EmitterEvent, EventType>, options?: OpenFin_2.SubscriptionOptions): Promise<this>;
3735
3917
  protected deregisterAllListeners(eventType: EmitterEventType): Promise<EventEmitter | void>;
3736
3918
  /**
3737
3919
  * Removes all listeners, or those of the specified event.
3738
3920
  *
3739
- * @param eventType
3740
3921
  */
3741
3922
  removeAllListeners(eventType?: EmitterEventType): Promise<this>;
3742
3923
  private deleteEmitterIfNothingRegistered;
@@ -3779,6 +3960,9 @@ declare type Entity = OpenFin_2.ApplicationType;
3779
3960
 
3780
3961
  declare type EntityInfo = OpenFin_2.EntityInfo;
3781
3962
 
3963
+ /**
3964
+ * @interface
3965
+ */
3782
3966
  declare type EntityInfo_2 = {
3783
3967
  uuid: string;
3784
3968
  name: string;
@@ -3890,6 +4074,9 @@ declare type ExistingConnectConfig = ConfigWithUuid & {
3890
4074
  address: string;
3891
4075
  };
3892
4076
 
4077
+ /**
4078
+ * @interface
4079
+ */
3893
4080
  declare type ExitCode = {
3894
4081
  topic: string;
3895
4082
  uuid: string;
@@ -4036,6 +4223,9 @@ declare namespace ExternalApplicationEvents {
4036
4223
  }
4037
4224
  }
4038
4225
 
4226
+ /**
4227
+ * @interface
4228
+ */
4039
4229
  declare type ExternalApplicationInfo = {
4040
4230
  parent: Identity_5;
4041
4231
  };
@@ -4074,6 +4264,9 @@ declare class ExternalApplicationModule extends Base {
4074
4264
  wrapSync(uuid: string): OpenFin_2.ExternalApplication;
4075
4265
  }
4076
4266
 
4267
+ /**
4268
+ * @interface
4269
+ */
4077
4270
  declare type ExternalConnection = {
4078
4271
  /**
4079
4272
  * The token to broker an external connection.
@@ -4095,11 +4288,17 @@ declare type ExternalProcessExitedEvent = NamedEvent & {
4095
4288
  exitCode: number;
4096
4289
  };
4097
4290
 
4291
+ /**
4292
+ * @interface
4293
+ */
4098
4294
  declare type ExternalProcessInfo = {
4099
4295
  pid: number;
4100
4296
  listener?: LaunchExternalProcessListener;
4101
4297
  };
4102
4298
 
4299
+ /**
4300
+ * @interface
4301
+ */
4103
4302
  declare type ExternalProcessRequestType = {
4104
4303
  /**
4105
4304
  * The file path to where the running application resides.
@@ -4142,6 +4341,9 @@ declare type FaviconUpdatedEvent = NamedEvent & {
4142
4341
  favicons: string[];
4143
4342
  };
4144
4343
 
4344
+ /**
4345
+ * @interface
4346
+ */
4145
4347
  declare type FetchManifestPayload = {
4146
4348
  /**
4147
4349
  * The URL of the manifest to fetch.
@@ -4230,6 +4432,9 @@ declare type FileDownloadProgressEvent = FileDownloadEvent & {
4230
4432
  state: 'progressing' | 'interrupted';
4231
4433
  };
4232
4434
 
4435
+ /**
4436
+ * @interface
4437
+ */
4233
4438
  declare type FileDownloadSettings = {
4234
4439
  rules: DownloadRule[];
4235
4440
  };
@@ -4268,6 +4473,8 @@ declare interface FinApi<MeType extends EntityType> {
4268
4473
 
4269
4474
  /**
4270
4475
  * Configuration for find-in-page requests.
4476
+ *
4477
+ * @interface
4271
4478
  */
4272
4479
  declare type FindInPageOptions = {
4273
4480
  /**
@@ -4303,6 +4510,9 @@ declare type FindInPageOptions = {
4303
4510
  medialCapitalAsWordStart?: boolean;
4304
4511
  };
4305
4512
 
4513
+ /**
4514
+ * @interface
4515
+ */
4306
4516
  declare type FindInPageResult = {
4307
4517
  requestId: number;
4308
4518
  /**
@@ -4320,6 +4530,9 @@ declare type FindInPageResult = {
4320
4530
  finalUpdate: boolean;
4321
4531
  };
4322
4532
 
4533
+ /**
4534
+ * @interface
4535
+ */
4323
4536
  declare type FindIntentsByContextOptions<MetadataType = IntentMetadata> = {
4324
4537
  context: Context;
4325
4538
  metadata?: MetadataType;
@@ -4514,6 +4727,9 @@ declare namespace FrameEvents {
4514
4727
  */
4515
4728
  declare type FrameEventType = FrameEvent['type'];
4516
4729
 
4730
+ /**
4731
+ * @interface
4732
+ */
4517
4733
  declare type FrameInfo = {
4518
4734
  name: string;
4519
4735
  uuid: string;
@@ -4590,6 +4806,9 @@ declare type FrameProcessDetails = ProcessDetails & {
4590
4806
 
4591
4807
  declare type GetLogRequestType = OpenFin_2.GetLogRequestType;
4592
4808
 
4809
+ /**
4810
+ * @interface
4811
+ */
4593
4812
  declare type GetLogRequestType_2 = {
4594
4813
  /**
4595
4814
  * The name of the running application
@@ -4607,6 +4826,9 @@ declare type GetLogRequestType_2 = {
4607
4826
 
4608
4827
  declare type GetterCall<T> = ApiCall<void, T>;
4609
4828
 
4829
+ /**
4830
+ * @interface
4831
+ */
4610
4832
  declare type GetWindowContextPayload = {
4611
4833
  /**
4612
4834
  * Entity type of the target of the context update ('view' or 'window').
@@ -4739,6 +4961,9 @@ declare namespace GlobalHotkeyEvents {
4739
4961
  }
4740
4962
  }
4741
4963
 
4964
+ /**
4965
+ * @interface
4966
+ */
4742
4967
  declare type GpuInfo = {
4743
4968
  name: string;
4744
4969
  };
@@ -4751,6 +4976,9 @@ declare type HiddenEvent = BaseViewEvent & {
4751
4976
  type: 'hidden';
4752
4977
  };
4753
4978
 
4979
+ /**
4980
+ * @interface
4981
+ */
4754
4982
  declare type HostContextChangedPayload = {
4755
4983
  /**
4756
4984
  * The new context object
@@ -4764,6 +4992,9 @@ declare type HostContextChangedPayload = {
4764
4992
 
4765
4993
  declare type HostContextChangedReasons = 'updated' | 'reparented';
4766
4994
 
4995
+ /**
4996
+ * @interface
4997
+ */
4767
4998
  declare type HostSpecs = {
4768
4999
  /**
4769
5000
  * True if Aero Glass theme is supported on Windows platforms
@@ -4797,6 +5028,8 @@ declare type HostSpecs = {
4797
5028
 
4798
5029
  /**
4799
5030
  * A hotkey binding.
5031
+ *
5032
+ * @interface
4800
5033
  */
4801
5034
  declare type Hotkey = {
4802
5035
  /**
@@ -4833,6 +5066,8 @@ declare type Identity_4 = OpenFin_2.Identity;
4833
5066
  *
4834
5067
  * @remarks The `uuid` property refers the application that owns the entity, not to the entity itself.
4835
5068
  * The `name` property identifies the entity itself, and must be unique within the application.
5069
+ *
5070
+ * @interface
4836
5071
  */
4837
5072
  declare type Identity_5 = {
4838
5073
  /**
@@ -4880,6 +5115,9 @@ declare type ImageFormatOptions = {
4880
5115
  quality?: number;
4881
5116
  };
4882
5117
 
5118
+ /**
5119
+ * @interface
5120
+ */
4883
5121
  declare type InfoForIntentOptions<MetadataType = IntentMetadata> = {
4884
5122
  /**
4885
5123
  * Name of the intent to get info for.
@@ -4901,6 +5139,9 @@ declare type InitLayoutOptions = OpenFin_2.InitLayoutOptions;
4901
5139
 
4902
5140
  declare type InitLayoutOptions_2 = OpenFin_2.InitLayoutOptions;
4903
5141
 
5142
+ /**
5143
+ * @interface
5144
+ */
4904
5145
  declare type InitLayoutOptions_3 = {
4905
5146
  /**
4906
5147
  * The id attribute of the container where the window's Layout should be initialized. If not provided
@@ -4909,6 +5150,9 @@ declare type InitLayoutOptions_3 = {
4909
5150
  containerId?: string;
4910
5151
  };
4911
5152
 
5153
+ /**
5154
+ * @interface
5155
+ */
4912
5156
  declare type InitPlatformOptions = {
4913
5157
  /**
4914
5158
  * A callback function or an array of constructor callbacks that can be used to extend or replace default Provider behavior.
@@ -4936,12 +5180,18 @@ declare type InputEvent_2 = {
4936
5180
  command?: string;
4937
5181
  };
4938
5182
 
5183
+ /**
5184
+ * @interface
5185
+ */
4939
5186
  declare type InstallationInfo = {
4940
5187
  cachedManifest: any;
4941
5188
  };
4942
5189
 
4943
5190
  declare type InstalledApps = OpenFin_2.InstalledApps;
4944
5191
 
5192
+ /**
5193
+ * @interface
5194
+ */
4945
5195
  declare type InstalledApps_2 = {
4946
5196
  [key: string]: InstallationInfo;
4947
5197
  };
@@ -4961,8 +5211,17 @@ declare type Intent<MetadataType = IntentMetadata> = {
4961
5211
  metadata?: MetadataType;
4962
5212
  };
4963
5213
 
5214
+ /**
5215
+ * Subscription function for registerIntentHandler.
5216
+ */
4964
5217
  declare type IntentHandler = (intent: Intent) => void;
4965
5218
 
5219
+ /**
5220
+ * The type used to describe an intent within the platform.
5221
+ */
5222
+ /**
5223
+ * @interface
5224
+ */
4966
5225
  declare type IntentMetadata<TargetType = any> = {
4967
5226
  target?: TargetType;
4968
5227
  resultType?: string;
@@ -5078,10 +5337,11 @@ declare type InternalConnectConfig = ExistingConnectConfig | NewConnectConfig;
5078
5337
 
5079
5338
  /**
5080
5339
  * Define whether to enable interop action logging.
5340
+ *
5081
5341
  */
5082
- declare interface InteropActionLoggingOption {
5342
+ declare type InteropActionLoggingOption = {
5083
5343
  enabled: boolean;
5084
- }
5344
+ };
5085
5345
 
5086
5346
  /**
5087
5347
  * {@link https://developers.openfin.co/of-docs/docs/enable-color-linking}
@@ -5747,12 +6007,18 @@ declare class InteropBroker extends Base {
5747
6007
  isActionAuthorized(_action: string, _payload: any, _identity: OpenFin_2.ClientIdentity): Promise<boolean> | boolean;
5748
6008
  }
5749
6009
 
6010
+ /**
6011
+ * @interface
6012
+ */
5750
6013
  declare type InteropBrokerDisconnectionEvent = {
5751
6014
  type: string;
5752
6015
  topic: string;
5753
6016
  brokerName: string;
5754
6017
  };
5755
6018
 
6019
+ /**
6020
+ * @interface
6021
+ */
5756
6022
  declare type InteropBrokerOptions = {
5757
6023
  contextGroups?: ContextGroupInfo;
5758
6024
  logging?: InteropLoggingOptions;
@@ -6255,8 +6521,17 @@ declare class InteropClient extends Base {
6255
6521
  static ferryFdc3Call(interopClient: OpenFin_2.InteropClient, action: string, payload?: any): Promise<any>;
6256
6522
  }
6257
6523
 
6524
+ /**
6525
+ * @interface
6526
+ */
6258
6527
  declare type InteropClientOnDisconnectionListener = (InteropBrokerDisconnectionEvent: InteropBrokerDisconnectionEvent) => any;
6259
6528
 
6529
+ /**
6530
+ * Information relevant to the Interop Broker.
6531
+ */
6532
+ /**
6533
+ * @interface
6534
+ */
6260
6535
  declare type InteropConfig = {
6261
6536
  /**
6262
6537
  * Context Group for the client. (green, yellow, red, etc.).
@@ -6270,6 +6545,9 @@ declare type InteropConfig = {
6270
6545
 
6271
6546
  declare type InteropLoggingActions = 'beforeAction' | 'afterAction';
6272
6547
 
6548
+ /**
6549
+ * @interface
6550
+ */
6273
6551
  declare type InteropLoggingOptions = Record<InteropLoggingActions, InteropActionLoggingOption>;
6274
6552
 
6275
6553
  /**
@@ -6324,6 +6602,9 @@ declare class InteropModule extends Base {
6324
6602
  connectSync(name: string, interopConfig?: OpenFin_2.InteropConfig): InteropClient;
6325
6603
  }
6326
6604
 
6605
+ /**
6606
+ * @interface
6607
+ */
6327
6608
  declare type JumpListCategory = {
6328
6609
  /**
6329
6610
  * The display title for the category.
@@ -6340,10 +6621,16 @@ declare type JumpListCategory = {
6340
6621
 
6341
6622
  declare type JumpListItem = JumpListTask | JumpListSeparator;
6342
6623
 
6624
+ /**
6625
+ * @interface
6626
+ */
6343
6627
  declare type JumpListSeparator = {
6344
6628
  type: 'separator';
6345
6629
  };
6346
6630
 
6631
+ /**
6632
+ * @interface
6633
+ */
6347
6634
  declare type JumpListTask = {
6348
6635
  type: 'task';
6349
6636
  /**
@@ -6435,15 +6722,19 @@ declare type JumpListTask = {
6435
6722
  */
6436
6723
  declare type LaunchEmitter = TypedEventEmitter<AppVersionEvent>;
6437
6724
 
6438
- declare type LaunchExternalProcessListener = {
6439
- (code: ExitCode): void;
6440
- };
6725
+ declare type LaunchExternalProcessListener = (code: ExitCode) => void;
6441
6726
 
6727
+ /**
6728
+ * @interface
6729
+ */
6442
6730
  declare type LaunchExternalProcessRule = {
6443
6731
  behavior: 'allow' | 'block';
6444
6732
  match: string[];
6445
6733
  };
6446
6734
 
6735
+ /**
6736
+ * @interface
6737
+ */
6447
6738
  declare type LaunchIntoPlatformPayload = {
6448
6739
  manifest: any;
6449
6740
  };
@@ -6726,14 +7017,26 @@ declare class Layout extends Base {
6726
7017
  applyPreset: (options: PresetLayoutOptions) => Promise<void>;
6727
7018
  }
6728
7019
 
6729
- declare interface LayoutColumn extends LayoutItemConfig {
7020
+ /**
7021
+ * @interface
7022
+ */
7023
+ declare type LayoutColumn = LayoutItemConfig & {
6730
7024
  type: 'column';
6731
- }
7025
+ };
6732
7026
 
6733
- declare interface LayoutComponent extends LayoutItemConfig {
7027
+ /**
7028
+ * @interface
7029
+ */
7030
+ declare type LayoutComponent = LayoutItemConfig & {
7031
+ /**
7032
+ * Only a component type will have this property and it should be set to view.
7033
+ */
6734
7034
  componentName: 'view';
7035
+ /**
7036
+ * Only a component type will have this property and it represents the view options of a given component.
7037
+ */
6735
7038
  componentState?: Partial<ViewCreationOptions>;
6736
- }
7039
+ };
6737
7040
 
6738
7041
  declare type LayoutContent = Array<LayoutItemConfig | LayoutRow | LayoutColumn | LayoutComponent>;
6739
7042
 
@@ -6751,6 +7054,9 @@ declare type LayoutEntitiesClient = ApiClient<LayoutEntitiesController>;
6751
7054
 
6752
7055
  /* Excluded from this release type: LayoutEntitiesController */
6753
7056
 
7057
+ /**
7058
+ * @interface
7059
+ */
6754
7060
  declare type LayoutEntityDefinition<TLayoutEntityType extends LayoutEntityTypes = LayoutEntityTypes> = {
6755
7061
  type: TLayoutEntityType;
6756
7062
  entityId: string;
@@ -6770,9 +7076,11 @@ declare type LayoutInitializedEvent = NamedEvent & {
6770
7076
  };
6771
7077
 
6772
7078
  /**
6773
- * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
7079
+ * Represents the arrangement of Views within a Platform window's Layout. We do not recommend trying
6774
7080
  * to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
6775
7081
  * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7082
+ *
7083
+ * @interface
6776
7084
  */
6777
7085
  declare type LayoutItemConfig = {
6778
7086
  /**
@@ -6993,6 +7301,9 @@ declare type LayoutModule_2 = OpenFin_2.Fin['Platform']['Layout'];
6993
7301
 
6994
7302
  /* Excluded from this release type: LayoutNode */
6995
7303
 
7304
+ /**
7305
+ * @interface
7306
+ */
6996
7307
  declare type LayoutOptions = {
6997
7308
  /**
6998
7309
  * Represents a potential ways to customize behavior of your Layout
@@ -7034,6 +7345,11 @@ declare type LayoutOptions = {
7034
7345
  * (not to be confused with close button on every tab).
7035
7346
  */
7036
7347
  showCloseIcon?: boolean;
7348
+ /**
7349
+ * @defaultValue false
7350
+ *
7351
+ * Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped.
7352
+ */
7037
7353
  constrainDragToHeaders?: boolean;
7038
7354
  /**
7039
7355
  * @defaultValue true
@@ -7062,6 +7378,11 @@ declare type LayoutOptions = {
7062
7378
  */
7063
7379
  preventDragIn?: boolean;
7064
7380
  };
7381
+ /**
7382
+ * Content of the layout. There can only be one top-level LayoutItem in the content array.
7383
+ * We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as {@link Platform#getSnapshot getSnapshot} or our
7384
+ * {@link https://openfin.github.io/golden-prototype/config-gen Layout Config Generation Tool }.
7385
+ */
7065
7386
  content?: LayoutContent;
7066
7387
  dimensions?: {
7067
7388
  borderWidth?: number;
@@ -7073,6 +7394,9 @@ declare type LayoutOptions = {
7073
7394
 
7074
7395
  declare type LayoutPosition = 'top' | 'bottom' | 'left' | 'right';
7075
7396
 
7397
+ /**
7398
+ * @interface
7399
+ */
7076
7400
  declare type LayoutPresetType = 'columns' | 'grid' | 'rows' | 'tabs';
7077
7401
 
7078
7402
  /**
@@ -7086,10 +7410,16 @@ declare type LayoutReadyEvent = NamedEvent & {
7086
7410
  })[];
7087
7411
  };
7088
7412
 
7089
- declare interface LayoutRow extends LayoutItemConfig {
7413
+ /**
7414
+ * @interface
7415
+ */
7416
+ declare type LayoutRow = LayoutItemConfig & {
7090
7417
  type: 'row';
7091
- }
7418
+ };
7092
7419
 
7420
+ /**
7421
+ * @interface
7422
+ */
7093
7423
  declare type LegacyWinOptionsInAppOptions = Pick<WindowCreationOptions, 'accelerator' | 'alwaysOnTop' | 'api' | 'aspectRatio' | 'autoplayPolicy' | 'autoShow' | 'backgroundColor' | 'contentNavigation' | 'contextMenu' | 'cornerRounding' | 'customData' | 'customRequestHeaders' | 'defaultCentered' | 'defaultHeight' | 'defaultLeft' | 'defaultTop' | 'defaultWidth' | 'frame' | 'hideOnClose' | 'icon' | 'maxHeight' | 'maximizable' | 'maxWidth' | 'minHeight' | 'minimizable' | 'minWidth' | 'opacity' | 'preloadScripts' | 'resizable' | 'resizeRegion' | 'saveWindowState' | 'ignoreSavedWindowState' | 'shadow' | 'showTaskbarIcon' | 'smallWindow' | 'state' | 'taskbarIconGroup' | 'waitForPageLoad' | '_internalWorkspaceData'>;
7094
7424
 
7095
7425
  declare type Listener<T extends {
@@ -7098,6 +7428,9 @@ declare type Listener<T extends {
7098
7428
 
7099
7429
  declare type LogInfo = OpenFin_2.LogInfo;
7100
7430
 
7431
+ /**
7432
+ * @interface
7433
+ */
7101
7434
  declare type LogInfo_2 = {
7102
7435
  /**
7103
7436
  * The filename of the log
@@ -7126,6 +7459,9 @@ declare type LogLevel = OpenFin_2.LogLevel;
7126
7459
  */
7127
7460
  declare type LogLevel_2 = 'verbose' | 'info' | 'warning' | 'error' | 'fatal';
7128
7461
 
7462
+ /**
7463
+ * @interface
7464
+ */
7129
7465
  declare type Manifest = {
7130
7466
  appAssets?: {
7131
7467
  alias: string;
@@ -7191,6 +7527,9 @@ declare type ManifestChangedEvent = IdentityEvent & {
7191
7527
  type: 'manifest-changed';
7192
7528
  };
7193
7529
 
7530
+ /**
7531
+ * @interface
7532
+ */
7194
7533
  declare type ManifestInfo = {
7195
7534
  /**
7196
7535
  * The uuid of the application.
@@ -7204,8 +7543,13 @@ declare type ManifestInfo = {
7204
7543
 
7205
7544
  /**
7206
7545
  * Margins configuration for printing.
7546
+ *
7547
+ * @interface
7207
7548
  */
7208
7549
  declare type Margins = {
7550
+ /**
7551
+ * The margin type. If `custom` is chosen, you will also need to specify top, bottom, left, and right.
7552
+ */
7209
7553
  marginType?: 'default' | 'none' | 'printableArea' | 'custom';
7210
7554
  /**
7211
7555
  * The top margin of the printed webpage, in pixels.
@@ -7235,17 +7579,36 @@ declare type MaximizedEvent = NamedEvent & {
7235
7579
  type: 'maximized';
7236
7580
  };
7237
7581
 
7582
+ /**
7583
+ * Type of the OpenFin `me` API handle, which provides access to the OpenFin representation of the current
7584
+ * code context (usually a document such as a {@link OpenFin.View} or {@link OpenFin.Window}), as well as
7585
+ * to the current `Interop` context.
7586
+ *
7587
+ * Useful for debugging in the devtools console, where this will intelligently type itself based
7588
+ * on the context in which the devtools panel was opened.
7589
+ */
7238
7590
  declare type Me<MeType extends EntityType_3> = OpenFin_2.EntityInfo & (MeType extends 'view' ? EntityTypeHelpers<'view'> & OpenFin_2.View & WithInterop : MeType extends 'window' ? EntityTypeHelpers<'window'> & OpenFin_2.Window & WithInterop : MeType extends 'iframe' ? EntityTypeHelpers<'iframe'> & OpenFin_2.Frame & WithInterop : MeType extends 'external connection' ? EntityTypeHelpers<'external connection'> & OpenFin_2.ExternalApplication & WithInterop : EntityTypeHelpers<MeType> & WithInterop) & {
7239
7591
  isOpenFin: boolean;
7240
7592
  };
7241
7593
 
7242
- declare type MenuItemTemplate<T extends unknown = unknown> = {
7594
+ /**
7595
+ * @interface
7596
+ *
7597
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
7598
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
7599
+ * of all possible data shapes for the entire menu, and the click handler should process
7600
+ * these with a "reducer" pattern.
7601
+ */
7602
+ declare type MenuItemTemplate<Data extends unknown = unknown> = {
7243
7603
  /**
7244
7604
  * Can be `normal`, `separator`, `submenu`, or `checkbox`.
7245
7605
  * Defaults to 'normal' unless a 'submenu' key exists
7246
7606
  */
7247
7607
  type?: 'normal' | 'separator' | 'submenu' | 'checkbox';
7248
7608
  role?: 'cut' | 'copy' | 'paste' | 'toggleDevTools' | 'reload';
7609
+ /**
7610
+ * The text to show on the menu item. Should be left undefined for type: 'separator'
7611
+ */
7249
7612
  label?: string;
7250
7613
  /**
7251
7614
  * If false, the menu item will be greyed out and unclickable.
@@ -7263,18 +7626,26 @@ declare type MenuItemTemplate<T extends unknown = unknown> = {
7263
7626
  * Should be specified for `submenu` type menu items. If `submenu` is specified,
7264
7627
  * the `type: 'submenu'` can be omitted.
7265
7628
  */
7266
- submenu?: MenuItemTemplate<T>[];
7629
+ submenu?: MenuItemTemplate<Data>[];
7267
7630
  /**
7268
7631
  * Data to be returned if the user selects the element. Must be serializable
7269
7632
  */
7270
- data?: T;
7633
+ data?: Data;
7271
7634
  /**
7272
7635
  * Image Data URI with image dimensions inferred from the encoded string
7273
7636
  */
7274
7637
  icon?: string;
7275
7638
  };
7276
7639
 
7277
- declare type MenuResult<T extends unknown = unknown> = ClickedMenuResult<T> | ClosedMenuResult;
7640
+ /**
7641
+ * Whether the user clicked on a menu item or the menu was closed (user clicked elsewhere).
7642
+ *
7643
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
7644
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
7645
+ * of all possible data shapes for the entire menu, and the click handler should process
7646
+ * these with a "reducer" pattern.
7647
+ */
7648
+ declare type MenuResult<Data extends unknown = unknown> = ClickedMenuResult<Data> | ClosedMenuResult;
7278
7649
 
7279
7650
  declare interface Message<T> {
7280
7651
  action: string;
@@ -7308,6 +7679,9 @@ declare type MinimizedEvent = NamedEvent & {
7308
7679
  type: 'minimized';
7309
7680
  };
7310
7681
 
7682
+ /**
7683
+ * @interface
7684
+ */
7311
7685
  declare type MonitorDetails = {
7312
7686
  /**
7313
7687
  * The available DIP scale coordinates.
@@ -7354,6 +7728,9 @@ declare type MonitorEvent = OpenFin_2.MonitorInfo & {
7354
7728
  type: 'monitor-info-changed';
7355
7729
  };
7356
7730
 
7731
+ /**
7732
+ * @interface
7733
+ */
7357
7734
  declare type MonitorInfo = {
7358
7735
  /**
7359
7736
  * The device scale factor.
@@ -7373,6 +7750,9 @@ declare type MonitorInfo = {
7373
7750
  virtualScreen: DipRect;
7374
7751
  };
7375
7752
 
7753
+ /**
7754
+ * @interface
7755
+ */
7376
7756
  declare type MutableViewOptions = {
7377
7757
  autoResize: AutoResizeOptions;
7378
7758
  /**
@@ -7454,6 +7834,8 @@ declare type MutableViewOptions = {
7454
7834
 
7455
7835
  /**
7456
7836
  * Window options that can be changed after window creation.
7837
+ *
7838
+ * @interface
7457
7839
  */
7458
7840
  declare type MutableWindowOptions = {
7459
7841
  /**
@@ -7702,6 +8084,9 @@ declare type NamedEvent = IdentityEvent & {
7702
8084
  name: string;
7703
8085
  };
7704
8086
 
8087
+ /**
8088
+ * @interface
8089
+ */
7705
8090
  declare type NativeWindowIntegrationProviderAuthorization = {
7706
8091
  authorizedUuid: string;
7707
8092
  };
@@ -7716,6 +8101,9 @@ declare type NavigationRejectedEvent = NamedEvent & {
7716
8101
  url: string;
7717
8102
  };
7718
8103
 
8104
+ /**
8105
+ * @interface
8106
+ */
7719
8107
  declare type NavigationRules = {
7720
8108
  /** @deprecated Use allowlist property instead. */
7721
8109
  whitelist?: string[];
@@ -8126,6 +8514,9 @@ declare type PerformanceReportEvent = Performance & NamedEvent & {
8126
8514
  type: 'performance-report';
8127
8515
  };
8128
8516
 
8517
+ /**
8518
+ * @interface
8519
+ */
8129
8520
  declare type Permissions_2 = {
8130
8521
  Application?: Partial<ApplicationPermissions>;
8131
8522
  System?: Partial<SystemPermissions>;
@@ -8955,9 +9346,17 @@ declare type PlatformOptions = ApplicationCreationOptions & {
8955
9346
  disableDefaultCommands?: boolean;
8956
9347
  /**
8957
9348
  * Strategy to assign views to process affinity by domain.
9349
+ * * `same` - The views in the same domain will have same renderer processes.
9350
+ * * `different` - The views in the same domain will have their own renderer processes.
8958
9351
  */
8959
9352
  viewProcessAffinityStrategy?: ProcessAffinityStrategy;
9353
+ /**
9354
+ * The provider url.
9355
+ */
8960
9356
  providerUrl?: string;
9357
+ /**
9358
+ * The permissions for secured APIs.
9359
+ */
8961
9360
  permissions?: Partial<Permissions_2>;
8962
9361
  };
8963
9362
 
@@ -9457,6 +9856,9 @@ declare type PlatformSnapshotAppliedEvent = BaseEvent & {
9457
9856
  type: 'platform-snapshot-applied';
9458
9857
  };
9459
9858
 
9859
+ /**
9860
+ * @interface
9861
+ */
9460
9862
  declare type PlatformViewCreationOptions = Partial<ViewOptions>;
9461
9863
 
9462
9864
  /**
@@ -9483,6 +9885,9 @@ declare type PlatformWindowOptions = WindowCreationOptions & {
9483
9885
  stylesheetUrl: string;
9484
9886
  };
9485
9887
 
9888
+ /**
9889
+ * @interface
9890
+ */
9486
9891
  declare type Point = {
9487
9892
  /**
9488
9893
  * The mouse x position
@@ -9494,6 +9899,9 @@ declare type Point = {
9494
9899
  y: number;
9495
9900
  };
9496
9901
 
9902
+ /**
9903
+ * @interface
9904
+ */
9497
9905
  declare type PointTopLeft = {
9498
9906
  /**
9499
9907
  * The mouse top position in virtual screen coordinates
@@ -9513,8 +9921,10 @@ declare type PopupInteraction = 'clicked' | 'dismissed';
9513
9921
 
9514
9922
  /**
9515
9923
  * Popup window options.
9924
+ *
9925
+ * @interface
9516
9926
  */
9517
- declare interface PopupOptions {
9927
+ declare type PopupOptions = {
9518
9928
  /**
9519
9929
  * Window creation options when using `showPopupWindow` to create a new window.
9520
9930
  */
@@ -9588,14 +9998,15 @@ declare interface PopupOptions {
9588
9998
  * <br>Note: If this is defined, `showPopupWindow` will not return a `PopupResult`.
9589
9999
  */
9590
10000
  onPopupResult?: (payload: PopupResult) => any;
9591
- }
10001
+ };
9592
10002
 
9593
10003
  /**
9594
10004
  * The Popup result.
9595
10005
  *
9596
10006
  * @typeParam T - Type of data the Popup result contains
10007
+ * @interface
9597
10008
  */
9598
- declare interface PopupResult<T = any> {
10009
+ declare type PopupResult<T = any> = {
9599
10010
  /**
9600
10011
  * `name` and `uuid` of the popup window that called dispatched this result.
9601
10012
  */
@@ -9615,7 +10026,7 @@ declare interface PopupResult<T = any> {
9615
10026
  * The last dispatch result.
9616
10027
  */
9617
10028
  lastDispatchResult?: PopupResult;
9618
- }
10029
+ };
9619
10030
 
9620
10031
  declare type PopupResultBehavior = 'none' | PopupBaseBehavior;
9621
10032
 
@@ -9644,14 +10055,17 @@ declare type Position = TransitionBase & {
9644
10055
  fin.me.setBounds({top: 50, left: 50, width: 200, height: 200}, {skipRestore: true})
9645
10056
  ```
9646
10057
  */
9647
- declare interface PositioningOptions {
10058
+ /**
10059
+ * @interface
10060
+ */
10061
+ declare type PositioningOptions = {
9648
10062
  /**
9649
10063
  * Windows Only.
9650
10064
  * If set to true, will not restore a maximized window before setting the bounds.
9651
10065
  * This will have the effect of the maximized window staying maximized and not immediately taking this new position.
9652
10066
  */
9653
10067
  skipRestore?: boolean;
9654
- }
10068
+ };
9655
10069
 
9656
10070
  /**
9657
10071
  * Context menu item with an implementation provided by OpenFin.
@@ -9660,6 +10074,8 @@ declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | '
9660
10074
 
9661
10075
  /**
9662
10076
  * A script that is run before page load.
10077
+ *
10078
+ * @interface
9663
10079
  */
9664
10080
  declare type PreloadScript = {
9665
10081
  /**
@@ -9720,6 +10136,9 @@ declare type PreloadScriptsStateChangingEvent = PreloadScriptsStateChangeEvent &
9720
10136
 
9721
10137
  declare type PresetLayoutOptions = OpenFin_2.PresetLayoutOptions;
9722
10138
 
10139
+ /**
10140
+ * @interface
10141
+ */
9723
10142
  declare type PresetLayoutOptions_2 = {
9724
10143
  /**
9725
10144
  * Which preset layout arrangement to use.
@@ -9730,23 +10149,44 @@ declare type PresetLayoutOptions_2 = {
9730
10149
 
9731
10150
  declare type PrinterInfo = OpenFin_2.PrinterInfo;
9732
10151
 
10152
+ /**
10153
+ * @interface
10154
+ */
9733
10155
  declare type PrinterInfo_2 = {
10156
+ /**
10157
+ * Printer Name
10158
+ */
9734
10159
  name: string;
10160
+ /**
10161
+ * Printer Description
10162
+ */
9735
10163
  description: string;
10164
+ /**
10165
+ * Printer Status
10166
+ */
9736
10167
  status: number;
10168
+ /**
10169
+ * Indicates that system's default printer.
10170
+ */
9737
10171
  isDefault: boolean;
9738
10172
  };
9739
10173
 
9740
10174
  /**
9741
10175
  * Options for printing a webpage in OpenFin.
10176
+ *
10177
+ * @interface
9742
10178
  */
9743
10179
  declare type PrintOptions = {
9744
10180
  content?: 'self';
9745
10181
  /**
10182
+ * @defaultValue false
10183
+ *
9746
10184
  * Disables prompting the user for print settings.
9747
10185
  */
9748
10186
  silent?: boolean;
9749
10187
  /**
10188
+ * @defaultValue false
10189
+ *
9750
10190
  * Includes the webpage background color and image when printing.
9751
10191
  */
9752
10192
  printBackground?: boolean;
@@ -9755,6 +10195,8 @@ declare type PrintOptions = {
9755
10195
  */
9756
10196
  deviceName?: string;
9757
10197
  /**
10198
+ * @defaultValue true
10199
+ *
9758
10200
  * Prints in full color (greyscale otherwise).
9759
10201
  */
9760
10202
  color?: boolean;
@@ -9763,6 +10205,8 @@ declare type PrintOptions = {
9763
10205
  */
9764
10206
  margins?: Margins;
9765
10207
  /**
10208
+ * @defaultValue true
10209
+ *
9766
10210
  * Prints in landscape mode (portrait otherwise).
9767
10211
  */
9768
10212
  landscape?: boolean;
@@ -9804,6 +10248,9 @@ declare type PrintOptions = {
9804
10248
  */
9805
10249
  declare type ProcessAffinityStrategy = 'same' | 'different';
9806
10250
 
10251
+ /**
10252
+ * @interface
10253
+ */
9807
10254
  declare type ProcessDetails = {
9808
10255
  /**
9809
10256
  * The percentage of total CPU usage.
@@ -9851,8 +10298,10 @@ declare type ProcessDetails = {
9851
10298
 
9852
10299
  /**
9853
10300
  * Process logging options
10301
+ *
10302
+ * @interface
9854
10303
  */
9855
- declare interface ProcessLoggingOptions {
10304
+ declare type ProcessLoggingOptions = {
9856
10305
  /**
9857
10306
  * Periodic Logging Interval (in seconds)
9858
10307
  */
@@ -9870,7 +10319,7 @@ declare interface ProcessLoggingOptions {
9870
10319
  */
9871
10320
  entries?: number;
9872
10321
  };
9873
- }
10322
+ };
9874
10323
 
9875
10324
  /**
9876
10325
  * A propagated Application event.
@@ -10177,6 +10626,9 @@ declare type ProviderIdentity_7 = Identity_5 & {
10177
10626
 
10178
10627
  declare type ProxyConfig = OpenFin_2.ProxyConfig;
10179
10628
 
10629
+ /**
10630
+ * @interface
10631
+ */
10180
10632
  declare type ProxyConfig_2 = {
10181
10633
  /**
10182
10634
  * The configured proxy address.
@@ -10191,11 +10643,17 @@ declare type ProxyConfig_2 = {
10191
10643
 
10192
10644
  declare type ProxyInfo = OpenFin_2.ProxyInfo;
10193
10645
 
10646
+ /**
10647
+ * @interface
10648
+ */
10194
10649
  declare type ProxyInfo_2 = {
10195
10650
  config: ProxyConfig_2;
10196
10651
  system: ProxySystemInfo;
10197
10652
  };
10198
10653
 
10654
+ /**
10655
+ * @interface
10656
+ */
10199
10657
  declare type ProxySystemInfo = {
10200
10658
  /**
10201
10659
  * The auto configuration url.
@@ -10215,6 +10673,9 @@ declare type ProxySystemInfo = {
10215
10673
  proxy: string;
10216
10674
  };
10217
10675
 
10676
+ /**
10677
+ * @interface
10678
+ */
10218
10679
  declare type QueryPermissionResult = {
10219
10680
  /**
10220
10681
  * The full name of a secured API.
@@ -10240,6 +10701,8 @@ declare type ReadImageClipboardRequest = BaseClipboardRequest & ImageFormatOptio
10240
10701
  * A rectangular area on the screen.
10241
10702
  *
10242
10703
  * @remarks Origin is top-left. All numbers are in pixels.
10704
+ *
10705
+ * @interface
10243
10706
  */
10244
10707
  declare type Rectangle = {
10245
10708
  /**
@@ -10260,6 +10723,9 @@ declare type Rectangle = {
10260
10723
  height: number;
10261
10724
  };
10262
10725
 
10726
+ /**
10727
+ * @interface
10728
+ */
10263
10729
  declare type RectangleByEdgePositions = {
10264
10730
  top: number;
10265
10731
  left: number;
@@ -10275,6 +10741,9 @@ declare type RegisteredEvent = BaseEvent & {
10275
10741
  type: 'registered';
10276
10742
  };
10277
10743
 
10744
+ /**
10745
+ * @interface
10746
+ */
10278
10747
  declare type RegisterUsageData = {
10279
10748
  data: unknown;
10280
10749
  type: string;
@@ -10282,6 +10751,9 @@ declare type RegisterUsageData = {
10282
10751
 
10283
10752
  declare type RegistryInfo = OpenFin_2.RegistryInfo;
10284
10753
 
10754
+ /**
10755
+ * @interface
10756
+ */
10285
10757
  declare type RegistryInfo_2 = {
10286
10758
  data: any;
10287
10759
  rootKey: string;
@@ -10303,6 +10775,9 @@ declare interface RemoteConfig extends ExistingConnectConfig {
10303
10775
  token: string;
10304
10776
  }
10305
10777
 
10778
+ /**
10779
+ * @interface
10780
+ */
10306
10781
  declare type ReplaceLayoutOpts = {
10307
10782
  /**
10308
10783
  * Layout config to be applied.
@@ -10310,6 +10785,9 @@ declare type ReplaceLayoutOpts = {
10310
10785
  layout: LayoutOptions;
10311
10786
  };
10312
10787
 
10788
+ /**
10789
+ * @interface
10790
+ */
10313
10791
  declare type ReplaceLayoutPayload = {
10314
10792
  /**
10315
10793
  * Object containing the layout to be applied.
@@ -10321,6 +10799,9 @@ declare type ReplaceLayoutPayload = {
10321
10799
  target: Identity_5;
10322
10800
  };
10323
10801
 
10802
+ /**
10803
+ * @interface
10804
+ */
10324
10805
  declare type ReplaceViewPayload = {
10325
10806
  opts: {
10326
10807
  viewToReplace: Identity_5;
@@ -10331,6 +10812,8 @@ declare type ReplaceViewPayload = {
10331
10812
 
10332
10813
  /**
10333
10814
  * Defines a region in pixels that will respond to user mouse interaction for resizing a frameless window.
10815
+ *
10816
+ * @interface
10334
10817
  */
10335
10818
  declare type ResizeRegion = {
10336
10819
  /**
@@ -10410,6 +10893,9 @@ declare type RespondingEvent = IdentityEvent & {
10410
10893
 
10411
10894
  declare type ResultBehavior = 'close' | 'hide' | 'none';
10412
10895
 
10896
+ /**
10897
+ * @interface
10898
+ */
10413
10899
  declare type RGB = {
10414
10900
  red: number;
10415
10901
  blue: number;
@@ -10484,6 +10970,8 @@ declare type RuntimeConfig = {
10484
10970
 
10485
10971
  /**
10486
10972
  * The options object required by the downloadRuntime function.
10973
+ *
10974
+ * @interface
10487
10975
  */
10488
10976
  declare type RuntimeDownloadOptions = {
10489
10977
  /**
@@ -10492,6 +10980,9 @@ declare type RuntimeDownloadOptions = {
10492
10980
  version: string;
10493
10981
  };
10494
10982
 
10983
+ /**
10984
+ * @interface
10985
+ */
10495
10986
  declare type RuntimeDownloadProgress = {
10496
10987
  /**
10497
10988
  * @property { string } alias The name of the asset
@@ -10505,6 +10996,9 @@ declare type RuntimeErrorPayload = {
10505
10996
  error?: ErrorPlainObject;
10506
10997
  };
10507
10998
 
10999
+ /**
11000
+ * @interface
11001
+ */
10508
11002
  declare type RuntimeInfo = {
10509
11003
  /**
10510
11004
  * The runtime build architecture.
@@ -10535,6 +11029,9 @@ declare type RuntimeInfo = {
10535
11029
  devtoolsPort?: number;
10536
11030
  };
10537
11031
 
11032
+ /**
11033
+ * @interface
11034
+ */
10538
11035
  declare type RVMInfo = {
10539
11036
  /**
10540
11037
  * The name of action: "get-rvm-info".
@@ -10562,6 +11059,9 @@ declare type RVMInfo = {
10562
11059
  'working-dir': string;
10563
11060
  };
10564
11061
 
11062
+ /**
11063
+ * @interface
11064
+ */
10565
11065
  declare type RvmLaunchOptions = {
10566
11066
  /**
10567
11067
  * True if no UI when launching
@@ -10578,6 +11078,9 @@ declare type RvmLaunchOptions = {
10578
11078
  subscribe?: (launch: LaunchEmitter) => void;
10579
11079
  };
10580
11080
 
11081
+ /**
11082
+ * @interface
11083
+ */
10581
11084
  declare type ScreenshotPrintOptions = {
10582
11085
  content: 'screenshot';
10583
11086
  };
@@ -10586,6 +11089,9 @@ declare type SendActionResponse<T extends keyof ProtocolMap> = Message<{
10586
11089
  data: ProtocolMap[T]['response'];
10587
11090
  } & ProtocolMap[T]['specialResponse']>;
10588
11091
 
11092
+ /**
11093
+ * @interface
11094
+ */
10589
11095
  declare type SendApplicationLogResponse = {
10590
11096
  logId: string;
10591
11097
  };
@@ -10600,6 +11106,9 @@ declare type ServiceConfig = {
10600
11106
  manifestUrl: string;
10601
11107
  };
10602
11108
 
11109
+ /**
11110
+ * @interface
11111
+ */
10603
11112
  declare type ServiceConfiguration = {
10604
11113
  config: object;
10605
11114
  /**
@@ -10608,6 +11117,9 @@ declare type ServiceConfiguration = {
10608
11117
  name: string;
10609
11118
  };
10610
11119
 
11120
+ /**
11121
+ * @interface
11122
+ */
10611
11123
  declare type ServiceIdentifier = {
10612
11124
  /**
10613
11125
  * The name of the service.
@@ -10624,15 +11136,41 @@ declare type SessionChangedEvent = {
10624
11136
  reason: 'lock' | 'unlock' | 'remote-connect' | 'remote-disconnect' | 'unknown';
10625
11137
  };
10626
11138
 
11139
+ /**
11140
+ * An instance of a SessionContextGroup
11141
+ */
11142
+ /**
11143
+ * @interface
11144
+ */
10627
11145
  declare type SessionContextGroup = {
11146
+ /**
11147
+ * The SessionContextGroup's id.
11148
+ */
10628
11149
  id: string;
11150
+ /**
11151
+ * A SessionContextGroup instance method for setting a context in the SessionContextGroup.
11152
+ * @param context The Context to be set.
11153
+ */
10629
11154
  setContext: (context: Context) => Promise<void>;
11155
+ /**
11156
+ * A SessionContextGroup instance method for getting the current context of a certain type.
11157
+ * @param type The Context Type to get. If not specified the last contextType set would get used.
11158
+ */
10630
11159
  getCurrentContext: (type?: string) => Promise<Context>;
11160
+ /**
11161
+ * A SessionContextGroup instance method for adding a handler for context change.
11162
+ * @param handler The callback to be invoked. Is invoked when (a) the context changes or (b) immediately after getting created if the context is already set.
11163
+ * @param contextType The context type this handler should listen to. If not specified, a global handler for all context types will get created. Only one global handler is allowed per SessionContextGroup.
11164
+ *
11165
+ */
10631
11166
  addContextHandler: (handler: ContextHandler, contextType?: string) => Promise<{
10632
11167
  unsubscribe: () => void;
10633
11168
  }>;
10634
11169
  };
10635
11170
 
11171
+ /**
11172
+ * @interface
11173
+ */
10636
11174
  declare type SetWindowContextPayload = {
10637
11175
  /**
10638
11176
  * The requested context update.
@@ -10648,11 +11186,23 @@ declare type SetWindowContextPayload = {
10648
11186
  target: Identity_5;
10649
11187
  };
10650
11188
 
11189
+ /**
11190
+ * @interface
11191
+ */
10651
11192
  declare type SharedWorkerInfo = {
11193
+ /**
11194
+ * The unique id of the shared worker.
11195
+ */
10652
11196
  id: string;
11197
+ /**
11198
+ * The url of the shared worker.
11199
+ */
10653
11200
  url: string;
10654
11201
  };
10655
11202
 
11203
+ /**
11204
+ * @interface
11205
+ */
10656
11206
  declare type ShortCutConfig = {
10657
11207
  /**
10658
11208
  * True if application has a shortcut on the desktop.
@@ -10683,14 +11233,34 @@ declare type ShownEvent = BaseViewEvent & {
10683
11233
  type: 'shown';
10684
11234
  };
10685
11235
 
10686
- declare type ShowPopupMenuOptions<T extends unknown = unknown> = {
10687
- template: MenuItemTemplate<T>[];
11236
+ /**
11237
+ * Options for showing a popup menu
11238
+ *
11239
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
11240
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
11241
+ * of all possible data shapes for the entire menu, and the click handler should process
11242
+ * these with a "reducer" pattern.
11243
+ *
11244
+ * @interface
11245
+ */
11246
+ declare type ShowPopupMenuOptions<Data extends unknown = unknown> = {
11247
+ /**
11248
+ * An array describing the menu to show.
11249
+ */
11250
+ template: MenuItemTemplate<Data>[];
11251
+ /**
11252
+ * The window x coordinate where to show the menu. Defaults to mouse position. If using must also use y.
11253
+ */
10688
11254
  x?: number;
11255
+ /**
11256
+ * The window y coordinate where to show the menu. Defaults to mouse position. If using must also use x
11257
+ */
10689
11258
  y?: number;
10690
11259
  };
10691
11260
 
10692
11261
  /**
10693
11262
  * _Platform Windows Only_. Enables views to be shown when a Platform Window is being resized by the user.
11263
+ *
10694
11264
  * @interface
10695
11265
  */
10696
11266
  declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
@@ -10722,7 +11292,13 @@ declare type Size = TransitionBase & {
10722
11292
  height: number;
10723
11293
  };
10724
11294
 
11295
+ /**
11296
+ * @interface
11297
+ */
10725
11298
  declare type Snapshot = {
11299
+ /**
11300
+ * The array of window options objects
11301
+ */
10726
11302
  windows: WindowCreationOptions[];
10727
11303
  snapshotDetails?: {
10728
11304
  monitorInfo: MonitorInfo;
@@ -10734,6 +11310,9 @@ declare type Snapshot = {
10734
11310
  };
10735
11311
  };
10736
11312
 
11313
+ /**
11314
+ * @interface
11315
+ */
10737
11316
  declare type SnapshotProvider<Snapshot = unknown> = {
10738
11317
  getSnapshot: () => Promise<Snapshot>;
10739
11318
  applySnapshot: (snapshot: Snapshot) => Promise<void>;
@@ -10880,6 +11459,9 @@ declare type StartedEvent = IdentityEvent & {
10880
11459
  type: 'started';
10881
11460
  };
10882
11461
 
11462
+ /**
11463
+ * @interface
11464
+ */
10883
11465
  declare type SubscriptionOptions = {
10884
11466
  /**
10885
11467
  * The event timestamp.
@@ -12372,6 +12954,9 @@ declare namespace SystemEvents {
12372
12954
  */
12373
12955
  declare type SystemEventType = SystemEvent['type'];
12374
12956
 
12957
+ /**
12958
+ * @interface
12959
+ */
12375
12960
  declare type SystemPermissions = {
12376
12961
  getAllExternalWindows: boolean;
12377
12962
  launchExternalProcess: boolean | {
@@ -12399,6 +12984,9 @@ declare type SystemPermissions = {
12399
12984
  };
12400
12985
  };
12401
12986
 
12987
+ /**
12988
+ * @interface
12989
+ */
12402
12990
  declare type SystemProcessInfo = {
12403
12991
  apps: AppProcessInfo[];
12404
12992
  browserProcess: NonAppProcessDetails;
@@ -12627,6 +13215,9 @@ declare type TaskBar = DipScaleRects & {
12627
13215
  rect: RectangleByEdgePositions;
12628
13216
  };
12629
13217
 
13218
+ /**
13219
+ * @interface
13220
+ */
12630
13221
  declare type TerminateExternalRequestType = {
12631
13222
  /**
12632
13223
  * The uuid of the running application.
@@ -12642,6 +13233,9 @@ declare type TerminateExternalRequestType = {
12642
13233
  killTree: boolean;
12643
13234
  };
12644
13235
 
13236
+ /**
13237
+ * @interface
13238
+ */
12645
13239
  declare type Time = {
12646
13240
  /**
12647
13241
  * The number of milliseconds the CPU has spent in user mode.
@@ -12665,14 +13259,28 @@ declare type Time = {
12665
13259
  irq: number;
12666
13260
  };
12667
13261
 
13262
+ /**
13263
+ * @interface
13264
+ */
12668
13265
  declare type Transition = {
13266
+ /**
13267
+ * The Opacity transition
13268
+ */
12669
13269
  opacity?: Opacity;
13270
+ /**
13271
+ * The Position transition
13272
+ */
12670
13273
  position?: Position;
13274
+ /**
13275
+ * The Size transition
13276
+ */
12671
13277
  size?: Size;
12672
13278
  };
12673
13279
 
12674
13280
  /**
12675
13281
  * Base configuration options needed for all types of transitions.
13282
+ *
13283
+ * @interface
12676
13284
  */
12677
13285
  declare type TransitionBase = {
12678
13286
  /**
@@ -12689,6 +13297,8 @@ declare type TransitionBase = {
12689
13297
 
12690
13298
  /**
12691
13299
  * Configuration for transition between windows.
13300
+ *
13301
+ * @interface
12692
13302
  */
12693
13303
  declare type TransitionOptions = {
12694
13304
  /**
@@ -12749,6 +13359,9 @@ declare type TrayIconClickedEvent = IdentityEvent & {
12749
13359
  monitorInfo: any;
12750
13360
  };
12751
13361
 
13362
+ /**
13363
+ * @interface
13364
+ */
12752
13365
  declare type TrayInfo = {
12753
13366
  /**
12754
13367
  * The bound of tray icon in virtual screen pixels.
@@ -12798,9 +13411,14 @@ declare type UnregisteredEvent = BaseEvent & {
12798
13411
 
12799
13412
  /**
12800
13413
  * View options that can be updated after creation.
13414
+ *
13415
+ * @interface
12801
13416
  */
12802
13417
  declare type UpdatableViewOptions = Partial<MutableViewOptions>;
12803
13418
 
13419
+ /**
13420
+ * @interface
13421
+ */
12804
13422
  declare type UpdatableWindowOptions = Partial<MutableWindowOptions>;
12805
13423
 
12806
13424
  /**
@@ -13467,6 +14085,9 @@ declare namespace ViewEvents {
13467
14085
  */
13468
14086
  declare type ViewEventType = ViewEvent['type'];
13469
14087
 
14088
+ /**
14089
+ * @interface
14090
+ */
13470
14091
  declare type ViewInfo = {
13471
14092
  canNavigateBack: boolean;
13472
14093
  canNavigateForward: boolean;
@@ -13601,6 +14222,7 @@ declare class ViewOverlay {
13601
14222
 
13602
14223
  /**
13603
14224
  * Represents the payload shape for Views that are trying to prevent an unload.
14225
+ * @interface
13604
14226
  */
13605
14227
  declare interface ViewsPreventingUnloadPayload {
13606
14228
  /**
@@ -13636,6 +14258,8 @@ declare type ViewState = ViewCreationOptions & {
13636
14258
  };
13637
14259
 
13638
14260
  /**
14261
+ * @interface
14262
+ *
13639
14263
  * The statuses of views specifying which of them are trying to prevent an unload and which are not.
13640
14264
  */
13641
14265
  declare interface ViewStatuses {
@@ -13651,13 +14275,22 @@ declare interface ViewStatuses {
13651
14275
 
13652
14276
  /**
13653
14277
  * Configuration for view visibility settings
14278
+ *
14279
+ * @interface
13654
14280
  */
13655
14281
  declare type ViewVisibilityOption = {
14282
+ /**
14283
+ * @defaultValue false
14284
+ *
14285
+ * Enables or disables showing views when the layout splitter or a tab is being dragged.
14286
+ */
13656
14287
  enabled?: boolean;
13657
14288
  };
13658
14289
 
13659
14290
  /**
13660
14291
  * _Platform Windows Only_. Controls behavior for showing views when they are being resized by the user.
14292
+ *
14293
+ * @interface
13661
14294
  */
13662
14295
  declare type ViewVisibilityOptions = {
13663
14296
  /**
@@ -13680,8 +14313,12 @@ declare type WebContent = View_2 | _Window;
13680
14313
 
13681
14314
  declare class WebContents<T extends BaseEvent> extends EmitterBase<T> {
13682
14315
  identity: OpenFin_2.Identity;
13683
- entityType: string;
13684
- constructor(wire: Transport, identity: OpenFin_2.Identity, entityType: string);
14316
+ entityType: 'window' | 'view';
14317
+ /**
14318
+ * @param identity The identity of the {@link OpenFin.WebContentsEvents WebContents}.
14319
+ * @param entityType The type of the {@link OpenFin.WebContentsEvents WebContents}.
14320
+ */
14321
+ constructor(wire: Transport, identity: OpenFin_2.Identity, entityType: 'window' | 'view');
13685
14322
  /**
13686
14323
  * Gets a base64 encoded image of all or part of the WebContents.
13687
14324
  * @param options Options for the capturePage call.
@@ -16010,7 +16647,10 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16010
16647
  * Calling this method will close previously opened menus.
16011
16648
  * @experimental
16012
16649
  * @param options
16013
- *
16650
+ * @typeParam Data User-defined shape for data returned upon menu item click. Should be a
16651
+ * [union](https://www.typescriptlang.org/docs/handbook/2/everyday-types.html#union-types)
16652
+ * of all possible data shapes for the entire menu, and the click handler should process
16653
+ * these with a "reducer" pattern.
16014
16654
  * @example
16015
16655
  * This could be used to show a drop down menu over views in a platform window:
16016
16656
  * ```js
@@ -16077,7 +16717,7 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16077
16717
  * })
16078
16718
  * ```
16079
16719
  */
16080
- showPopupMenu<T>(options: OpenFin_2.ShowPopupMenuOptions<T>): Promise<OpenFin_2.MenuResult<T>>;
16720
+ showPopupMenu<Data>(options: OpenFin_2.ShowPopupMenuOptions<Data>): Promise<OpenFin_2.MenuResult<Data>>;
16081
16721
  /**
16082
16722
  * Closes the window's popup menu, if one exists.
16083
16723
  * @experimental
@@ -16240,6 +16880,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16240
16880
 
16241
16881
  declare type WindowCreationReason = 'tearout' | 'create-view-without-target' | 'api-call' | 'app-creation' | 'restore' | 'apply-snapshot';
16242
16882
 
16883
+ /**
16884
+ * @interface
16885
+ */
16243
16886
  declare type WindowDetail = {
16244
16887
  /**
16245
16888
  * The bottom-most coordinate of the window.
@@ -16370,6 +17013,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16370
17013
  type: 'hotkey';
16371
17014
  };
16372
17015
 
17016
+ /**
17017
+ * @interface
17018
+ */
16373
17019
  declare type WindowInfo = {
16374
17020
  canNavigateBack: boolean;
16375
17021
  canNavigateForward: boolean;
@@ -16485,6 +17131,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16485
17131
  type: 'window-not-responding';
16486
17132
  };
16487
17133
 
17134
+ /**
17135
+ * @interface
17136
+ */
16488
17137
  declare type WindowOptionDiff = {
16489
17138
  [key in keyof WindowOptions]: {
16490
17139
  oldVal: WindowOptions[key];
@@ -16558,6 +17207,9 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16558
17207
  */
16559
17208
  declare type WindowState = 'maximized' | 'minimized' | 'normal';
16560
17209
 
17210
+ /**
17211
+ * @interface
17212
+ */
16561
17213
  declare type WindowViewsPrintOptions = {
16562
17214
  content: 'views';
16563
17215
  includeSelf?: boolean;
@@ -16587,16 +17239,16 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16587
17239
  positioningOptions?: OpenFin_2.PositioningOptions;
16588
17240
  };
16589
17241
 
16590
- declare type WorkspacePlatformOptions = {
16591
- /** Leaving this as any for now until we figure out what the shape should look like in Workspace */
16592
- [key: string]: any;
16593
- };
17242
+ /* Excluded from this release type: WorkspacePlatformOptions */
16594
17243
 
16595
17244
  /**
16596
17245
  * A generic request to write any supported data to the clipboard.
16597
17246
  * @interface
16598
17247
  */
16599
17248
  declare type WriteAnyClipboardRequest = BaseClipboardRequest & {
17249
+ /**
17250
+ * Data to be written
17251
+ */
16600
17252
  data: {
16601
17253
  text?: string;
16602
17254
  html?: string;
@@ -16608,6 +17260,8 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16608
17260
  * @deprecated - instead use WriteAnyClipboardRequest
16609
17261
  *
16610
17262
  * A generic request to write any supported data to the clipboard.
17263
+ *
17264
+ * @interface
16611
17265
  */
16612
17266
  declare type WriteAnyRequestType = WriteAnyClipboardRequest;
16613
17267
 
@@ -16638,6 +17292,8 @@ declare class _Window extends WebContents<OpenFin_2.WindowEvent> {
16638
17292
  * @deprecated - instead use OpenFin.WriteClipboardRequest
16639
17293
  *
16640
17294
  * A request to write data to the clipboard.
17295
+ *
17296
+ * @interface
16641
17297
  */
16642
17298
  declare type WriteRequestType = WriteClipboardRequest;
16643
17299