@openfin/fdc3-api 43.100.47 → 43.100.50

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/fdc3-api.d.ts CHANGED
@@ -136,13 +136,13 @@ declare type ApiSettings = {
136
136
  /**
137
137
  * Inject OpenFin API into cross-origin iframes
138
138
  *
139
- * @defaultValue false
139
+ * @default false
140
140
  */
141
141
  crossOriginInjection?: boolean;
142
142
  /**
143
143
  * Inject OpenFin API into same-origin iframes
144
144
  *
145
- * @defaultValue true
145
+ * @default true
146
146
  */
147
147
  sameOriginInjection?: boolean;
148
148
  /**
@@ -1187,19 +1187,19 @@ declare class ApplicationModule extends Base {
1187
1187
  */
1188
1188
  declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1189
1189
  /**
1190
- * @defaultValue false
1191
- *
1192
1190
  * Disables IAB secure logging for the app.
1191
+ *
1192
+ * @default false
1193
1193
  */
1194
1194
  disableIabSecureLogging: boolean;
1195
1195
  /**
1196
- * @defaultValue 'There was an error loading the application.'
1197
- *
1198
1196
  * An error message to display when the application (launched via manifest) fails to load.
1199
1197
  * A dialog box will be launched with the error message just before the runtime exits.
1200
1198
  * Load fails such as failed DNS resolutions or aborted connections as well as cancellations, _e.g.,_ `window.stop()`,
1201
1199
  * will trigger this dialog.
1202
1200
  * Client response codes such as `404 Not Found` are not treated as fails as they are valid server responses.
1201
+ *
1202
+ * @default 'There was an error loading the application.'
1203
1203
  */
1204
1204
  loadErrorMessage: string;
1205
1205
  /**
@@ -1218,28 +1218,28 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1218
1218
  */
1219
1219
  name: string;
1220
1220
  /**
1221
- * @defaultValue false
1222
- *
1223
1221
  * A flag to configure the application as non-persistent.
1224
1222
  * Runtime exits when there are no persistent apps running.
1223
+ *
1224
+ * @default false
1225
1225
  */
1226
1226
  nonPersistent: boolean;
1227
1227
  /**
1228
- * @defaultValue false
1229
- *
1230
1228
  * Enable Flash at the application level.
1229
+ *
1230
+ * @default false
1231
1231
  */
1232
1232
  plugins: boolean;
1233
1233
  /**
1234
- * @defaultValue false
1235
- *
1236
1234
  * Enable spell check at the application level.
1235
+ *
1236
+ * @default false
1237
1237
  */
1238
1238
  spellCheck: boolean;
1239
1239
  /**
1240
- * @defaultValue 'about:blank'
1241
- *
1242
1240
  * The url to the application (specifically the application's main window).
1241
+ *
1242
+ * @default 'about:blank'
1243
1243
  */
1244
1244
  url: string;
1245
1245
  /**
@@ -1248,9 +1248,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1248
1248
  */
1249
1249
  uuid: string;
1250
1250
  /**
1251
- * @defaultValue true
1252
- *
1253
1251
  * When set to `false` it will disable the same-origin policy for the app.
1252
+ *
1253
+ * @default true
1254
1254
  */
1255
1255
  webSecurity: boolean;
1256
1256
  /**
@@ -1260,10 +1260,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1260
1260
  commands: ShortcutOverride[];
1261
1261
  isPlatformController: boolean;
1262
1262
  /**
1263
- * @defaultValue 1000
1264
- *
1265
1263
  * **Platforms Only.** The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed.
1266
1264
  * If you do not wish for views to be pooled on your platform, set this property to zero.
1265
+ *
1266
+ * @default 1000
1267
1267
  */
1268
1268
  maxViewPoolSize: number;
1269
1269
  /**
@@ -1279,12 +1279,12 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1279
1279
  */
1280
1280
  snapshot: Snapshot;
1281
1281
  /**
1282
- * @defaultValue false
1283
- *
1284
1282
  * **Platforms Only.** Prevent the Platform Provider from quitting automatically when the last Platform Window is closed.
1285
1283
  *
1286
1284
  * Note: if the Platform Provider is showing, it won't close automatically.
1287
1285
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1286
+ *
1287
+ * @default false
1288
1288
  */
1289
1289
  preventQuitOnLastWindowClosed: boolean;
1290
1290
  /**
@@ -1292,9 +1292,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1292
1292
  */
1293
1293
  interopBrokerConfiguration: InteropBrokerOptions;
1294
1294
  /**
1295
- * @defaultValue true
1296
- *
1297
1295
  * When set to `false` it will disable OpenFin Diagnostics for the app.
1296
+ *
1297
+ * @default true
1298
1298
  */
1299
1299
  apiDiagnostics: boolean;
1300
1300
  /**
@@ -1310,16 +1310,16 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1310
1310
  */
1311
1311
  permissions?: Partial<Permissions_2>;
1312
1312
  /**
1313
- * @defaultValue false
1314
- *
1315
1313
  * Enables the use of the Jumplists API and the 'pin to taskbar' functionality.
1316
1314
  * Only relevant in Windows.
1315
+ *
1316
+ * @default false
1317
1317
  */
1318
1318
  enableJumpList: boolean;
1319
1319
  /**
1320
- * @defaultValue false
1321
- *
1322
1320
  * When set to `true`, any `beforeunload` handler set on the app will fire.
1321
+ *
1322
+ * @default false
1323
1323
  */
1324
1324
  enableBeforeUnload: boolean;
1325
1325
  /**
@@ -1400,25 +1400,25 @@ declare type ApplicationWindowInfo = {
1400
1400
  */
1401
1401
  declare type ApplySnapshotOptions = {
1402
1402
  /**
1403
- * @defaultValue false
1404
- *
1405
1403
  * When true, applySnapshot will close existing windows,
1406
1404
  * replacing current Platform state with the given snapshot.
1405
+ *
1406
+ * @default false
1407
1407
  */
1408
1408
  closeExistingWindows?: boolean;
1409
1409
  /**
1410
- * @defaultValue false
1411
- *
1412
1410
  * When true, applySnapshot will close existing includeInSnapshots: true windows,
1413
1411
  * replacing current Platform state with the given snapshot.
1412
+ *
1413
+ * @default false
1414
1414
  */
1415
1415
  closeSnapshotWindows?: boolean;
1416
1416
  /**
1417
- * @defaultValue false
1418
- *
1419
1417
  * When true, applySnapshot will not check whether any windows in a
1420
1418
  * snapshot are off-screen. By default, such windows will be repositioned to be on-screen,
1421
1419
  * as defined by {@link PlatformProvider#positionOutOfBoundsWindows PlatformProvider.positionOutOfBoundsWindows}.
1420
+ *
1421
+ * @default false
1422
1422
  */
1423
1423
  skipOutOfBoundsCheck?: boolean;
1424
1424
  };
@@ -2101,15 +2101,15 @@ declare type CapturePageOptions = {
2101
2101
  */
2102
2102
  area?: Rectangle;
2103
2103
  /**
2104
- * @defaultValue 'png'
2105
- *
2106
2104
  * The format of the captured image. Can be 'png', 'jpg', or 'bmp'.
2105
+ *
2106
+ * @default 'png'
2107
2107
  */
2108
2108
  format?: 'bmp' | 'jpg' | 'png';
2109
2109
  /**
2110
- * @defaultValue 100
2111
- *
2112
2110
  * Quality of JPEG image. Between 0 - 100.
2111
+ *
2112
+ * @default 100
2113
2113
  */
2114
2114
  quality?: number;
2115
2115
  };
@@ -2763,9 +2763,9 @@ declare type ChannelClientDisconnectionListener = (identity: ClientIdentity) =>
2763
2763
  */
2764
2764
  declare type ChannelConnectOptions = ChannelCreateOptions & {
2765
2765
  /**
2766
- * @defaultValue true
2767
- *
2768
2766
  * If true will wait for ChannelProvider to connect. If false will fail if ChannelProvider is not found.
2767
+ *
2768
+ * @default true
2769
2769
  */
2770
2770
  wait?: boolean;
2771
2771
  /**
@@ -3427,9 +3427,9 @@ declare interface CloseWindowPayload {
3427
3427
  windowId: Identity_4;
3428
3428
  options: {
3429
3429
  /**
3430
- * @defaultValue false
3431
- *
3432
3430
  * When set to true skips any before handler set on views that are part of the window
3431
+ *
3432
+ * @default false
3433
3433
  */
3434
3434
  skipBeforeUnload?: boolean;
3435
3435
  };
@@ -3537,9 +3537,9 @@ declare type ConstViewOptions = {
3537
3537
  */
3538
3538
  name: string;
3539
3539
  /**
3540
- * @defaultValue "about:blank"
3541
- *
3542
3540
  * The URL of the window
3541
+ *
3542
+ * @default "about:blank"
3543
3543
  */
3544
3544
  url: string;
3545
3545
  /**
@@ -3564,6 +3564,15 @@ declare type ConstViewOptions = {
3564
3564
  * Custom headers for requests sent by the view.
3565
3565
  */
3566
3566
  customRequestHeaders: CustomRequestHeaders[];
3567
+ /**
3568
+ * @experimental
3569
+ *
3570
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the view.
3571
+ * These css properties are used to enable dragging of a frameless window.
3572
+ *
3573
+ * @default false
3574
+ */
3575
+ disableAppRegion: boolean;
3567
3576
  /**
3568
3577
  * Initial bounds given relative to the window.
3569
3578
  */
@@ -3600,9 +3609,9 @@ declare type ConstViewOptions = {
3600
3609
  experimental: any;
3601
3610
  fdc3InteropApi?: string;
3602
3611
  /**
3603
- * @defaultValue false
3604
- *
3605
3612
  * When set to `true`, any `beforeunload` handler set on Views will fire.
3613
+ *
3614
+ * @default false
3606
3615
  */
3607
3616
  enableBeforeUnload: boolean;
3608
3617
  /**
@@ -3683,13 +3692,12 @@ declare type ConstWindowOptions = {
3683
3692
  */
3684
3693
  backgroundColor: string;
3685
3694
  /**
3686
- * @defaultValue false
3687
- *
3688
3695
  * Determines whether WebContents will throttle animations and timers when the page becomes backgrounded.
3689
3696
  * This also affects the Page Visibility API.
3690
3697
  *
3691
3698
  * When `true`, the page is throttled whether it is hidden or not.
3692
3699
  *
3700
+ * @default false
3693
3701
  */
3694
3702
  backgroundThrottling: boolean;
3695
3703
  /**
@@ -3713,21 +3721,30 @@ declare type ConstWindowOptions = {
3713
3721
  */
3714
3722
  customRequestHeaders: CustomRequestHeaders[];
3715
3723
  /**
3716
- * @defaultValue true
3717
- *
3718
3724
  * Setting this to false would keep the Window alive even if all its Views were closed.
3719
3725
  * This is meant for advanced users and should be used with caution.
3720
3726
  * Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
3721
3727
  * Use `layout.replace` to create a fresh Layout instance in case you want to populate it with Views again.
3722
3728
  * **NOTE:** - This option is ignored in non-Platforms apps.
3729
+ *
3730
+ * @default true
3723
3731
  */
3724
3732
  closeOnLastViewRemoved: boolean;
3725
3733
  /**
3726
- * @defaultValue 'all'
3734
+ * @experimental
3735
+ *
3736
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the window.
3737
+ * These css properties are used to enable dragging of a frameless window.
3727
3738
  *
3739
+ * @default false
3740
+ */
3741
+ disableAppRegion: boolean;
3742
+ /**
3728
3743
  * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
3729
- + * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3744
+ * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3730
3745
  * **NOTE:** - This option is ignored in non-Platforms apps.
3746
+ *
3747
+ * @default 'all'
3731
3748
  */
3732
3749
  viewsPreventingClose: 'all' | 'layout';
3733
3750
  /**
@@ -3738,31 +3755,31 @@ declare type ConstWindowOptions = {
3738
3755
  */
3739
3756
  defaultCentered: boolean;
3740
3757
  /**
3741
- * @defaultValue 500
3742
- *
3743
3758
  * The default height of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent launches
3744
3759
  * in favor of the cached value.
3760
+ *
3761
+ * @default 500
3745
3762
  */
3746
3763
  defaultHeight: number;
3747
3764
  /**
3748
- * @defaultValue 100
3749
- *
3750
3765
  * The default left position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3751
3766
  * launches in favor of the cached value.
3767
+ *
3768
+ * @default 100
3752
3769
  */
3753
3770
  defaultLeft: number;
3754
3771
  /**
3755
- * @defaultValue 100
3756
- *
3757
3772
  * The default top position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3758
3773
  * launches in favor of the cached value.
3774
+ *
3775
+ * @default 100
3759
3776
  */
3760
3777
  defaultTop: number;
3761
3778
  /**
3762
- * @defaultValue 800
3763
- *
3764
3779
  * The default width of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3765
3780
  * launches in favor of the cached value.
3781
+ *
3782
+ * @default 800
3766
3783
  */
3767
3784
  defaultWidth: number;
3768
3785
  /**
@@ -3808,19 +3825,19 @@ declare type ConstWindowOptions = {
3808
3825
  */
3809
3826
  processAffinity: string;
3810
3827
  /**
3811
- * @defaultValue false
3812
- *
3813
3828
  * Displays a shadow on frameless windows.
3814
3829
  * `shadow` and `cornerRounding` are mutually exclusive.
3815
3830
  * On Windows 7, Aero theme is required.
3831
+ *
3832
+ * @default false
3816
3833
  */
3817
3834
  shadow: boolean;
3818
3835
  /**
3819
- * @defaultValue true
3820
- *
3821
3836
  * Caches the location of the window.
3822
3837
  *
3823
3838
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3839
+ *
3840
+ * @default true
3824
3841
  */
3825
3842
  saveWindowState: boolean;
3826
3843
  /**
@@ -3829,22 +3846,22 @@ declare type ConstWindowOptions = {
3829
3846
  */
3830
3847
  ignoreSavedWindowState: boolean;
3831
3848
  /**
3832
- * @defaultValue false
3833
- *
3834
3849
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3835
3850
  *
3836
3851
  * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3837
3852
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3853
+ *
3854
+ * @default false
3838
3855
  */
3839
3856
  smallWindow: boolean;
3840
3857
  /**
3841
- * @defaultValue "normal"
3842
- *
3843
3858
  * The visible state of the window on creation.
3844
3859
  * One of:
3845
3860
  * * `"maximized"`
3846
3861
  * * `"minimized"`
3847
3862
  * * `"normal"`
3863
+ *
3864
+ * @default "normal"
3848
3865
  */
3849
3866
  state: WindowState;
3850
3867
  /**
@@ -3859,26 +3876,26 @@ declare type ConstWindowOptions = {
3859
3876
  */
3860
3877
  taskbarIconGroup: string;
3861
3878
  /**
3862
- * @defaultValue "about:blank"
3863
- *
3864
3879
  * The URL of the window
3880
+ *
3881
+ * @default "about:blank"
3865
3882
  */
3866
3883
  url: string;
3867
3884
  /**
3868
- * @defaultValue <application UUID>
3869
- *
3870
3885
  * The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
3871
3886
  * If omitted, defaults to the `uuid` of the application spawning the window.
3872
3887
  * If given, must match the `uuid` of the application spawning the window.
3873
3888
  * In other words, the application's `uuid` is the only acceptable value, but is the default, so there's
3874
3889
  * really no need to provide it.
3890
+ *
3891
+ * @default <application UUID>
3875
3892
  */
3876
3893
  uuid: string;
3877
3894
  /**
3878
- * @defaultValue false
3879
- *
3880
3895
  * When set to `true`, the window will not appear until the `window` object's `load` event fires.
3881
3896
  * When set to `false`, the window will appear immediately without waiting for content to be loaded.
3897
+ *
3898
+ * @default false
3882
3899
  */
3883
3900
  waitForPageLoad: boolean;
3884
3901
  width: number;
@@ -4160,13 +4177,13 @@ declare type CopyBlockedEventReason = 'disabled';
4160
4177
  */
4161
4178
  declare type CopyPermissions = {
4162
4179
  /**
4163
- * @defaultValue 'allowed'
4164
- *
4165
4180
  * Controls the behavior for copy operations for a matched URL.
4166
4181
  *
4167
4182
  * allow: Enables all copy operations.
4168
4183
  * block: Disables all copy operations.
4169
4184
  * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
4185
+ *
4186
+ * @default 'allowed'
4170
4187
  */
4171
4188
  behavior: 'allow' | 'block' | 'protect';
4172
4189
  /**
@@ -4174,9 +4191,9 @@ declare type CopyPermissions = {
4174
4191
  */
4175
4192
  options?: {
4176
4193
  /**
4177
- * @defaultValue ''
4178
- *
4179
4194
  * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
4195
+ *
4196
+ * @default ''
4180
4197
  */
4181
4198
  replacementText: string;
4182
4199
  };
@@ -4190,15 +4207,15 @@ declare type CopyPermissions = {
4190
4207
  */
4191
4208
  declare type CornerRounding = {
4192
4209
  /**
4193
- * @defaultValue 0
4194
- *
4195
4210
  * The height in pixels.
4211
+ *
4212
+ * @default 0
4196
4213
  */
4197
4214
  height: number;
4198
4215
  /**
4199
- * @defaultValue 0
4200
- *
4201
4216
  * The width in pixels.
4217
+ *
4218
+ * @default 0
4202
4219
  */
4203
4220
  width: number;
4204
4221
  };
@@ -4288,8 +4305,6 @@ declare type CreateLayoutOptions = {
4288
4305
  layoutName: string;
4289
4306
  layout: LayoutOptions;
4290
4307
  /**
4291
- * @defaultValue 'default'
4292
- *
4293
4308
  * Controls the View behavior for the given `layout` property. Note
4294
4309
  * that the selected behavior only applies to unnamed Views or
4295
4310
  * Views with the prefix `internal-generated-`. In all cases, if any
@@ -4311,6 +4326,8 @@ declare type CreateLayoutOptions = {
4311
4326
  * override. Note that during applyLayoutSnapshot, Views are created and
4312
4327
  * attached to the Provider while the Window is being created, so it's
4313
4328
  * important to not 'duplicate' Views in this workflow.
4329
+ *
4330
+ * @default 'default'
4314
4331
  */
4315
4332
  multiInstanceViewBehavior?: MultiInstanceViewBehavior;
4316
4333
  };
@@ -4569,7 +4586,7 @@ declare type DomainApiSettings = {
4569
4586
  * * 'none': The `fin` API will be not available.
4570
4587
  * * 'global': The entire `fin` API will be available.
4571
4588
  *
4572
- * @defaultValue 'global'
4589
+ * @default 'global'
4573
4590
  */
4574
4591
  fin?: InjectionType;
4575
4592
  /**
@@ -5168,9 +5185,9 @@ declare type EventWithId<Event extends AppVersionEvent> = Event extends infer E
5168
5185
  */
5169
5186
  declare type ExcludeOptions = {
5170
5187
  /**
5171
- * @defaultValue false
5172
- *
5173
5188
  * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
5189
+ *
5190
+ * @default false
5174
5191
  */
5175
5192
  preloadScripts: boolean;
5176
5193
  };
@@ -6015,34 +6032,34 @@ declare interface FinApi<MeType extends OpenFin.EntityType> {
6015
6032
  */
6016
6033
  declare type FindInPageOptions = {
6017
6034
  /**
6018
- * @defaultValue true
6019
- *
6020
6035
  * Searches in the forward direction (backward otherwise)
6036
+ *
6037
+ * @default true
6021
6038
  */
6022
6039
  forward?: boolean;
6023
6040
  /**
6024
- * @defaultValue false
6025
- *
6026
6041
  * Begins a new text-finding session; should be true for first request only, and false on subsequent requests.
6042
+ *
6043
+ * @default false
6027
6044
  */
6028
6045
  findNext?: boolean;
6029
6046
  /**
6030
- * @defaultValue false
6031
- *
6032
6047
  * Enables case-sensitive searching.
6048
+ *
6049
+ * @default false
6033
6050
  */
6034
6051
  matchCase?: boolean;
6035
6052
  /**
6036
- * @defaultValue false
6037
- *
6038
6053
  * Only searches from the start of words.
6054
+ *
6055
+ * @default false
6039
6056
  */
6040
6057
  wordStart?: boolean;
6041
6058
  /**
6042
- * @defaultValue false
6043
- *
6044
6059
  * When combined with wordStart, accepts a match in the middle of a word if the match begins with an uppercase letter followed by a<br>
6045
6060
  * lowercase or non-letter. Accepts several other intra-word matches.
6061
+ *
6062
+ * @default false
6046
6063
  */
6047
6064
  medialCapitalAsWordStart?: boolean;
6048
6065
  };
@@ -6556,9 +6573,9 @@ declare type Hotkey = {
6556
6573
  */
6557
6574
  keys: string;
6558
6575
  /**
6559
- * @defaultValue false
6560
- *
6561
6576
  * Prevent default key handling before emitting the event.
6577
+ *
6578
+ * @default false
6562
6579
  */
6563
6580
  preventDefault?: boolean;
6564
6581
  };
@@ -9120,77 +9137,79 @@ declare type LayoutOptions = {
9120
9137
  */
9121
9138
  newTabButtonUrl?: string;
9122
9139
  /**
9123
- * @defaultValue false
9124
- *
9125
9140
  * When true the splitters will not be draggable and the layout will not resize.
9141
+ *
9142
+ * @default false
9126
9143
  */
9127
9144
  preventSplitterResize?: boolean;
9128
9145
  /**
9129
- * @defaultValue false
9130
- *
9131
9146
  * Whether the popout button will only act on the entire stack,
9132
9147
  * as opposed to only the active tab.
9148
+ *
9149
+ * @default false
9133
9150
  */
9134
9151
  popoutWholeStack?: boolean;
9135
9152
  /**
9136
- * @defaultValue false
9137
- *
9138
9153
  * Limits the area to which tabs can be dragged.
9139
9154
  * If true, the layout container is the only area where tabs can be dropped.
9155
+ *
9156
+ * @default false
9140
9157
  */
9141
9158
  constrainDragToContainer?: boolean;
9142
9159
  /**
9143
- * @defaultValue false
9144
- *
9145
9160
  * Whether to show the popout button on stack header.
9146
9161
  * The button will create a new window with current tab as its content.
9147
9162
  * In case `popoutWholeStack` is set to true, all tabs in the stack will be in the new window.
9163
+ *
9164
+ * @default false
9148
9165
  */
9149
9166
  showPopoutIcon?: boolean;
9150
9167
  /**
9151
- * @defaultValue false
9152
- *
9153
9168
  * Whether to show the maximize button on stack header.
9154
9169
  * The button will maximize the current tab to fill the entire window.
9170
+ *
9171
+ * @default false
9155
9172
  */
9156
9173
  showMaximiseIcon?: boolean;
9157
9174
  /**
9158
- * @defaultValue false
9159
- *
9160
9175
  * Whether to show the close button on stack header
9161
9176
  * (not to be confused with close button on every tab).
9177
+ *
9178
+ * @default false
9162
9179
  */
9163
9180
  showCloseIcon?: boolean;
9164
9181
  /**
9165
- * @defaultValue false
9166
- *
9167
9182
  * Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped.
9183
+ *
9184
+ * @default false
9168
9185
  */
9169
9186
  constrainDragToHeaders?: boolean;
9170
9187
  /**
9171
- * @defaultValue true
9172
- *
9173
9188
  * Turns tab headers on or off.
9174
9189
  * If false, the layout will be displayed with splitters only.
9190
+ *
9191
+ * @default true
9175
9192
  */
9176
9193
  hasHeaders?: boolean;
9177
9194
  /**
9178
- * @defaultValue true
9179
- *
9180
9195
  * If true, the user can re-arrange the layout by
9181
9196
  * dragging items by their tabs to the desired location.
9197
+ *
9198
+ * @default true
9182
9199
  */
9183
9200
  reorderEnabled?: boolean;
9184
9201
  /**
9185
- * @defaultValue false
9186
- *
9187
9202
  * If true, tabs can't be dragged out of the window.
9203
+ *
9204
+ * @default false
9188
9205
  */
9189
9206
  preventDragOut?: boolean;
9190
9207
  /**
9191
- * @defaultValue false
9208
+ * @defaultValue=false
9192
9209
  *
9193
9210
  * If true, tabs can't be dragged into the window.
9211
+ *
9212
+ * @default false
9194
9213
  */
9195
9214
  preventDragIn?: boolean;
9196
9215
  /**
@@ -9711,10 +9730,10 @@ declare type MutableViewOptions = {
9711
9730
  /**
9712
9731
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
9713
9732
  *
9714
- * @defaultValue true
9715
- *
9716
9733
  * Show the context menu when right-clicking on the view.
9717
9734
  * Gives access to the devtools for the view.
9735
+ *
9736
+ * @default true
9718
9737
  */
9719
9738
  contextMenu: boolean;
9720
9739
  /**
@@ -9761,24 +9780,25 @@ declare type MutableViewOptions = {
9761
9780
  contentNavigation: ContentNavigation;
9762
9781
  contentRedirect: ContentRedirect;
9763
9782
  /**
9764
- * @defaultValue false
9765
9783
  * @deprecated
9766
9784
  * **Platforms Only.** If true, will hide and detach the View from the window for later use instead of closing,
9767
9785
  * allowing the state of the View to be saved and the View to be immediately shown in a new Layout.
9786
+ *
9787
+ * @default false
9768
9788
  */
9769
9789
  detachOnClose: boolean;
9770
9790
  /**
9771
- * @defaultValue true
9772
- *
9773
9791
  * **Platforms Only.** If false, the view will be persistent and can't be closed through
9774
9792
  * either UI or `Platform.closeView`. Note that the view will still be closed if the host window is closed or
9775
9793
  * if the view isn't part of the new layout when running `Layout.replace`.
9794
+ *
9795
+ * @default true
9776
9796
  */
9777
9797
  isClosable: boolean;
9778
9798
  /**
9779
- * @defaultValue false
9780
- *
9781
9799
  * **Platforms Only.** If true, the tab of the view can't be dragged out of its host window.
9800
+ *
9801
+ * @default false
9782
9802
  */
9783
9803
  preventDragOut: boolean;
9784
9804
  interop?: InteropConfig;
@@ -9790,7 +9810,7 @@ declare type MutableViewOptions = {
9790
9810
  /**
9791
9811
  * {@inheritDoc ViewThrottling}
9792
9812
  *
9793
- * @defaultValue 'enabled'
9813
+ * @default 'enabled'
9794
9814
  */
9795
9815
  throttling: ViewThrottling;
9796
9816
  /**
@@ -9809,7 +9829,7 @@ declare type MutableWindowOptions = {
9809
9829
  * Turns anything of matching RGB value transparent.
9810
9830
  *
9811
9831
  * Caveats:
9812
- * * runtime key --disable-gpu is required. Note: Unclear behavior on remote Desktop support
9832
+ * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
9813
9833
  * * User cannot click-through transparent regions
9814
9834
  * * Not supported on Mac
9815
9835
  * * Windows Aero must be enabled
@@ -9818,25 +9838,25 @@ declare type MutableWindowOptions = {
9818
9838
  */
9819
9839
  alphaMask: RGB;
9820
9840
  /**
9821
- * @defaultValue false
9822
- *
9823
9841
  * Always position the window at the top of the window stack.
9842
+ *
9843
+ * @default false
9824
9844
  */
9825
9845
  alwaysOnTop: boolean;
9826
9846
  /**
9827
- * @defaultValue 0
9828
- *
9829
9847
  * The aspect ratio of width to height to enforce for the window. If this value is equal to or less than zero,
9830
9848
  * an aspect ratio will not be enforced.
9849
+ *
9850
+ * @default 0
9831
9851
  */
9832
9852
  aspectRatio: number;
9833
9853
  /**
9834
9854
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
9835
9855
  *
9836
- * @defaultValue true
9837
- *
9838
9856
  * Show the context menu when right-clicking on the window.
9839
9857
  * Gives access to the devtools for the window.
9858
+ *
9859
+ * @default true
9840
9860
  */
9841
9861
  contextMenu: boolean;
9842
9862
  /**
@@ -9903,16 +9923,17 @@ declare type MutableWindowOptions = {
9903
9923
  */
9904
9924
  customData: any;
9905
9925
  /**
9906
- * @defaultValue true
9907
9926
  * @deprecated Will be removed in runtime version 45
9908
9927
  *
9909
9928
  * Show the window's frame.
9929
+ *
9930
+ * @default true
9910
9931
  */
9911
9932
  frame: boolean;
9912
9933
  /**
9913
- * @defaultValue false
9914
- *
9915
9934
  * Hides the window instead of closing it when the close button is pressed.
9935
+ *
9936
+ * @default false
9916
9937
  */
9917
9938
  hideOnClose: boolean;
9918
9939
  /**
@@ -9965,60 +9986,61 @@ declare type MutableWindowOptions = {
9965
9986
  */
9966
9987
  icon: string;
9967
9988
  /**
9968
- * @defaultValue true
9969
- *
9970
9989
  * Include window in snapshots returned by Platform.getSnapshot(). Turning this off may be desirable when dealing with
9971
9990
  * inherently temporary windows whose state shouldn't be preserved, such as modals, menus, or popups.
9991
+ *
9992
+ * @default true
9972
9993
  */
9973
9994
  includeInSnapshots: boolean;
9974
9995
  /**
9975
- * @defaultValue -1
9976
- *
9977
9996
  * The maximum height of a window. Will default to the OS defined value if set to -1.
9997
+ *
9998
+ * @default -1
9978
9999
  */
9979
10000
  maxHeight: number;
9980
10001
  /**
9981
- * @defaultValue true
9982
- *
9983
10002
  * Allows the window to be maximized.
10003
+ *
10004
+ * @default true
9984
10005
  */
9985
10006
  maximizable: boolean;
9986
10007
  /**
9987
- * @defaultValue -1
9988
- *
9989
10008
  * The maximum width of a window. Will default to the OS defined value if set to -1.
10009
+ *
10010
+ * @default -1
9990
10011
  */
9991
10012
  maxWidth: number;
9992
10013
  /**
9993
- * @defaultValue 0
9994
- *
9995
10014
  * The minimum height of the window.
10015
+ *
10016
+ * @default 0
9996
10017
  */
9997
10018
  minHeight: number;
9998
10019
  /**
9999
- * @defaultValue true
10000
- *
10001
10020
  * Allows the window to be minimized.
10021
+ *
10022
+ * @default true
10002
10023
  */
10003
10024
  minimizable: boolean;
10004
10025
  /**
10005
- * @defaultValue true
10006
- *
10007
10026
  * The minimum width of the window.
10027
+ *
10028
+ * @default true
10008
10029
  */
10009
10030
  minWidth: number;
10010
10031
  /**
10011
- * @defaultValue 1
10012
- *
10013
10032
  * A flag that specifies how transparent the window will be.
10014
10033
  * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
10015
10034
  * This value is clamped between `0.0` and `1.0`.
10035
+ * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
10036
+ *
10037
+ * @default 1
10016
10038
  */
10017
10039
  opacity: number;
10018
10040
  /**
10019
- * @defaultValue true
10020
- *
10021
10041
  * A flag to allow the user to resize the window.
10042
+ *
10043
+ * @default true
10022
10044
  */
10023
10045
  resizable: boolean;
10024
10046
  /**
@@ -10026,16 +10048,16 @@ declare type MutableWindowOptions = {
10026
10048
  */
10027
10049
  resizeRegion: ResizeRegion;
10028
10050
  /**
10029
- * @defaultValue false
10030
- *
10031
10051
  * **Platforms Only.** If true, will show background images in the layout when the Views are hidden.
10032
10052
  * This occurs when the window is resizing or a tab is being dragged within the layout.
10053
+ *
10054
+ * @default false
10033
10055
  */
10034
10056
  showBackgroundImages: boolean;
10035
10057
  /**
10036
- * @defaultValue true
10037
- *
10038
10058
  * Shows the window's icon in the taskbar.
10059
+ *
10060
+ * @default true
10039
10061
  */
10040
10062
  showTaskbarIcon: boolean;
10041
10063
  /**
@@ -10062,7 +10084,7 @@ declare type MutableWindowOptions = {
10062
10084
  /**
10063
10085
  * {@inheritDoc WindowThrottling}
10064
10086
  *
10065
- * @defaultValue 'enabled'
10087
+ * @default 'enabled'
10066
10088
  *
10067
10089
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
10068
10090
  */
@@ -10716,12 +10738,12 @@ declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
10716
10738
  */
10717
10739
  declare type PastePermissions = {
10718
10740
  /**
10719
- * @defaultValue 'non-protected-content'
10720
- *
10721
10741
  * Controls the behavior for paste operations for a matched URL.
10722
10742
  *
10723
10743
  * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
10724
10744
  * all-content: All matching URLs will be able to paste content copied from both protected (copy.behavior = 'protect') and on-protected (copy.behavior = 'allow') URLs.
10745
+ *
10746
+ * @default 'non-protected-content'
10725
10747
  */
10726
10748
  behavior: 'non-protected-content' | 'all-content';
10727
10749
  };
@@ -11791,11 +11813,11 @@ declare type PlatformOptions = ApplicationCreationOptions & {
11791
11813
  */
11792
11814
  providerUrl?: string;
11793
11815
  /**
11794
- * @defaultValue true
11795
- *
11796
11816
  * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
11797
11817
  *
11798
11818
  * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
11819
+ *
11820
+ * @default true
11799
11821
  */
11800
11822
  allowLaunchIntoPlatform?: boolean;
11801
11823
  };
@@ -12488,22 +12510,22 @@ declare type PopupOptions = {
12488
12510
  url?: string;
12489
12511
  /**
12490
12512
  * Height of the popup window in pixels (takes priority over `intialOptions` size properties).
12491
- * @defaultValue 300
12513
+ * @default 300
12492
12514
  */
12493
12515
  height?: number;
12494
12516
  /**
12495
12517
  * Width of the popup window in pixels (takes priority over `intialOptions` size properties).
12496
- * @defaultValue 300
12518
+ * @default 300
12497
12519
  */
12498
12520
  width?: number;
12499
12521
  /**
12500
12522
  * Left position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
12501
- * @defaultValue 0
12523
+ * @default 0
12502
12524
  */
12503
12525
  x?: number;
12504
12526
  /**
12505
12527
  * Top position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
12506
- * @defaultValue 0
12528
+ * @default 0
12507
12529
  */
12508
12530
  y?: number;
12509
12531
  /**
@@ -12511,7 +12533,7 @@ declare type PopupOptions = {
12511
12533
  * * 'modal' restricts resizing and positioning in the caller.
12512
12534
  * * 'hide' hides the popup window on blur.
12513
12535
  * * 'close' closes the popup window on blur.
12514
- * @defaultValue 'close'
12536
+ * @default 'close'
12515
12537
  */
12516
12538
  blurBehavior?: PopupBlurBehavior;
12517
12539
  /**
@@ -12519,19 +12541,19 @@ declare type PopupOptions = {
12519
12541
  * * 'none' will do nothing.
12520
12542
  * * 'hide' hides the popup window on `dispatchPopupResult`.
12521
12543
  * * 'close' closes the popup window on `dispatchPopupResult`.
12522
- * @defaultValue 'close'
12544
+ * @default 'close'
12523
12545
  */
12524
12546
  resultDispatchBehavior?: PopupResultBehavior;
12525
12547
  /**
12526
12548
  * Hide the popup window instead of closing when `close` is called on it.
12527
12549
  *
12528
12550
  * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
12529
- * @defaultValue false
12551
+ * @default false
12530
12552
  */
12531
12553
  hideOnClose?: boolean;
12532
12554
  /**
12533
12555
  * Determines if the popup window should or should not be focused when it is shown.
12534
- * @defaultValue true
12556
+ * @default true
12535
12557
  */
12536
12558
  focus?: boolean;
12537
12559
  /**
@@ -12625,9 +12647,9 @@ declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | '
12625
12647
  */
12626
12648
  declare type PreloadScript = {
12627
12649
  /**
12628
- * @defaultValue false
12629
- *
12630
12650
  * Fail to load the window if this preload script fails
12651
+ *
12652
+ * @default false
12631
12653
  */
12632
12654
  mandatory?: boolean;
12633
12655
  /**
@@ -12719,15 +12741,15 @@ declare type PrinterInfo = {
12719
12741
  declare type PrintOptions = {
12720
12742
  content?: 'self';
12721
12743
  /**
12722
- * @defaultValue false
12723
- *
12724
12744
  * Disables prompting the user for print settings.
12745
+ *
12746
+ * @default false
12725
12747
  */
12726
12748
  silent?: boolean;
12727
12749
  /**
12728
- * @defaultValue false
12729
- *
12730
12750
  * Includes the webpage background color and image when printing.
12751
+ *
12752
+ * @default false
12731
12753
  */
12732
12754
  printBackground?: boolean;
12733
12755
  /**
@@ -12735,9 +12757,9 @@ declare type PrintOptions = {
12735
12757
  */
12736
12758
  deviceName?: string;
12737
12759
  /**
12738
- * @defaultValue true
12739
- *
12740
12760
  * Prints in full color (greyscale otherwise).
12761
+ *
12762
+ * @default true
12741
12763
  */
12742
12764
  color?: boolean;
12743
12765
  /**
@@ -12745,9 +12767,9 @@ declare type PrintOptions = {
12745
12767
  */
12746
12768
  margins?: Margins;
12747
12769
  /**
12748
- * @defaultValue true
12749
- *
12750
12770
  * Prints in landscape mode (portrait otherwise).
12771
+ *
12772
+ * @default true
12751
12773
  */
12752
12774
  landscape?: boolean;
12753
12775
  /**
@@ -14123,15 +14145,15 @@ declare type ReplaceViewPayload = {
14123
14145
  */
14124
14146
  declare type ResizeRegion = {
14125
14147
  /**
14126
- * @defaultValue 7
14127
- *
14128
14148
  * The size of the resize region in pixels.
14149
+ *
14150
+ * @default 7
14129
14151
  */
14130
14152
  size?: number;
14131
14153
  /**
14132
- * @defaultValue 9
14133
- *
14134
14154
  * The size in pixels of an additional square resizable region located at the bottom right corner of a frameless window.
14155
+ *
14156
+ * @default 9
14135
14157
  */
14136
14158
  bottomRightCorner?: number;
14137
14159
  /**
@@ -14139,27 +14161,27 @@ declare type ResizeRegion = {
14139
14161
  */
14140
14162
  sides?: {
14141
14163
  /**
14142
- * @defaultValue true
14143
- *
14144
14164
  * Enables resizing from the top of the window.
14165
+ *
14166
+ * @default true
14145
14167
  */
14146
14168
  top?: boolean;
14147
14169
  /**
14148
- * @defaultValue true
14149
- *
14150
14170
  * Enables resizing from the bottom of the window.
14171
+ *
14172
+ * @default true
14151
14173
  */
14152
14174
  bottom?: boolean;
14153
14175
  /**
14154
- * @defaultValue true
14155
- *
14156
14176
  * Enables resizing from the left side of the window.
14177
+ *
14178
+ * @default true
14157
14179
  */
14158
14180
  left?: boolean;
14159
14181
  /**
14160
- * @defaultValue true
14161
- *
14162
14182
  * Enables resizing from the right side of the window.
14183
+ *
14184
+ * @default true
14163
14185
  */
14164
14186
  right?: boolean;
14165
14187
  };
@@ -14713,9 +14735,9 @@ declare type ShowTrayIconPopupMenuOptions<Data extends unknown = unknown> = {
14713
14735
  */
14714
14736
  declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
14715
14737
  /**
14716
- * @defaultValue 0
14717
- *
14718
14738
  * Number of milliseconds to wait between view repaints.
14739
+ *
14740
+ * @default 0
14719
14741
  */
14720
14742
  paintIntervalMs?: number;
14721
14743
  };
@@ -16780,9 +16802,9 @@ declare type TransitionBase = {
16780
16802
  */
16781
16803
  duration: number;
16782
16804
  /**
16783
- * @defaultValue false
16784
- *
16785
16805
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
16806
+ *
16807
+ * @default false
16786
16808
  */
16787
16809
  relative?: boolean;
16788
16810
  };
@@ -16798,9 +16820,9 @@ declare type TransitionOptions = {
16798
16820
  */
16799
16821
  interrupt: boolean;
16800
16822
  /**
16801
- * @defaultValue false
16802
- *
16803
16823
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
16824
+ *
16825
+ * @default false
16804
16826
  */
16805
16827
  relative?: boolean;
16806
16828
  tween?: tween;
@@ -17871,9 +17893,9 @@ declare type ViewTitlePriority = 'document' | 'options';
17871
17893
  */
17872
17894
  declare type ViewVisibilityOption = {
17873
17895
  /**
17874
- * @defaultValue false
17875
- *
17876
17896
  * Enables or disables showing views when the layout splitter or a tab is being dragged or a Platform Window is being resized.
17897
+ *
17898
+ * @default false
17877
17899
  */
17878
17900
  enabled?: boolean;
17879
17901
  };