@openfin/core 41.102.4 → 41.102.6

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.
@@ -133,13 +133,13 @@ declare type ApiSettings = {
133
133
  /**
134
134
  * Inject OpenFin API into cross-origin iframes
135
135
  *
136
- * @defaultValue false
136
+ * @default false
137
137
  */
138
138
  crossOriginInjection?: boolean;
139
139
  /**
140
140
  * Inject OpenFin API into same-origin iframes
141
141
  *
142
- * @defaultValue true
142
+ * @default true
143
143
  */
144
144
  sameOriginInjection?: boolean;
145
145
  /**
@@ -1178,19 +1178,19 @@ declare class ApplicationModule extends Base {
1178
1178
  */
1179
1179
  declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1180
1180
  /**
1181
- * @defaultValue false
1182
- *
1183
1181
  * Disables IAB secure logging for the app.
1182
+ *
1183
+ * @default false
1184
1184
  */
1185
1185
  disableIabSecureLogging: boolean;
1186
1186
  /**
1187
- * @defaultValue 'There was an error loading the application.'
1188
- *
1189
1187
  * An error message to display when the application (launched via manifest) fails to load.
1190
1188
  * A dialog box will be launched with the error message just before the runtime exits.
1191
1189
  * Load fails such as failed DNS resolutions or aborted connections as well as cancellations, _e.g.,_ `window.stop()`,
1192
1190
  * will trigger this dialog.
1193
1191
  * Client response codes such as `404 Not Found` are not treated as fails as they are valid server responses.
1192
+ *
1193
+ * @default 'There was an error loading the application.'
1194
1194
  */
1195
1195
  loadErrorMessage: string;
1196
1196
  /**
@@ -1209,28 +1209,28 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1209
1209
  */
1210
1210
  name: string;
1211
1211
  /**
1212
- * @defaultValue false
1213
- *
1214
1212
  * A flag to configure the application as non-persistent.
1215
1213
  * Runtime exits when there are no persistent apps running.
1214
+ *
1215
+ * @default false
1216
1216
  */
1217
1217
  nonPersistent: boolean;
1218
1218
  /**
1219
- * @defaultValue false
1220
- *
1221
1219
  * Enable Flash at the application level.
1220
+ *
1221
+ * @default false
1222
1222
  */
1223
1223
  plugins: boolean;
1224
1224
  /**
1225
- * @defaultValue false
1226
- *
1227
1225
  * Enable spell check at the application level.
1226
+ *
1227
+ * @default false
1228
1228
  */
1229
1229
  spellCheck: boolean;
1230
1230
  /**
1231
- * @defaultValue 'about:blank'
1232
- *
1233
1231
  * The url to the application (specifically the application's main window).
1232
+ *
1233
+ * @default 'about:blank'
1234
1234
  */
1235
1235
  url: string;
1236
1236
  /**
@@ -1239,9 +1239,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1239
1239
  */
1240
1240
  uuid: string;
1241
1241
  /**
1242
- * @defaultValue true
1243
- *
1244
1242
  * When set to `false` it will disable the same-origin policy for the app.
1243
+ *
1244
+ * @default true
1245
1245
  */
1246
1246
  webSecurity: boolean;
1247
1247
  /**
@@ -1251,10 +1251,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1251
1251
  commands: ShortcutOverride[];
1252
1252
  isPlatformController: boolean;
1253
1253
  /**
1254
- * @defaultValue 1000
1255
- *
1256
1254
  * **Platforms Only.** The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed.
1257
1255
  * If you do not wish for views to be pooled on your platform, set this property to zero.
1256
+ *
1257
+ * @default 1000
1258
1258
  */
1259
1259
  maxViewPoolSize: number;
1260
1260
  /**
@@ -1270,12 +1270,12 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1270
1270
  */
1271
1271
  snapshot: Snapshot;
1272
1272
  /**
1273
- * @defaultValue false
1274
- *
1275
1273
  * **Platforms Only.** Prevent the Platform Provider from quitting automatically when the last Platform Window is closed.
1276
1274
  *
1277
1275
  * Note: if the Platform Provider is showing, it won't close automatically.
1278
1276
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1277
+ *
1278
+ * @default false
1279
1279
  */
1280
1280
  preventQuitOnLastWindowClosed: boolean;
1281
1281
  /**
@@ -1283,9 +1283,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1283
1283
  */
1284
1284
  interopBrokerConfiguration: InteropBrokerOptions;
1285
1285
  /**
1286
- * @defaultValue true
1287
- *
1288
1286
  * When set to `false` it will disable OpenFin Diagnostics for the app.
1287
+ *
1288
+ * @default true
1289
1289
  */
1290
1290
  apiDiagnostics: boolean;
1291
1291
  /**
@@ -1301,16 +1301,16 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1301
1301
  */
1302
1302
  permissions?: Partial<Permissions_2>;
1303
1303
  /**
1304
- * @defaultValue false
1305
- *
1306
1304
  * Enables the use of the Jumplists API and the 'pin to taskbar' functionality.
1307
1305
  * Only relevant in Windows.
1306
+ *
1307
+ * @default false
1308
1308
  */
1309
1309
  enableJumpList: boolean;
1310
1310
  /**
1311
- * @defaultValue false
1312
- *
1313
1311
  * When set to `true`, any `beforeunload` handler set on the app will fire.
1312
+ *
1313
+ * @default false
1314
1314
  */
1315
1315
  enableBeforeUnload: boolean;
1316
1316
  /**
@@ -1391,25 +1391,25 @@ declare type ApplicationWindowInfo = {
1391
1391
  */
1392
1392
  declare type ApplySnapshotOptions = {
1393
1393
  /**
1394
- * @defaultValue false
1395
- *
1396
1394
  * When true, applySnapshot will close existing windows,
1397
1395
  * replacing current Platform state with the given snapshot.
1396
+ *
1397
+ * @default false
1398
1398
  */
1399
1399
  closeExistingWindows?: boolean;
1400
1400
  /**
1401
- * @defaultValue false
1402
- *
1403
1401
  * When true, applySnapshot will close existing includeInSnapshots: true windows,
1404
1402
  * replacing current Platform state with the given snapshot.
1403
+ *
1404
+ * @default false
1405
1405
  */
1406
1406
  closeSnapshotWindows?: boolean;
1407
1407
  /**
1408
- * @defaultValue false
1409
- *
1410
1408
  * When true, applySnapshot will not check whether any windows in a
1411
1409
  * snapshot are off-screen. By default, such windows will be repositioned to be on-screen,
1412
1410
  * as defined by {@link PlatformProvider#positionOutOfBoundsWindows PlatformProvider.positionOutOfBoundsWindows}.
1411
+ *
1412
+ * @default false
1413
1413
  */
1414
1414
  skipOutOfBoundsCheck?: boolean;
1415
1415
  };
@@ -2066,15 +2066,15 @@ declare type CapturePageOptions = {
2066
2066
  */
2067
2067
  area?: Rectangle;
2068
2068
  /**
2069
- * @defaultValue 'png'
2070
- *
2071
2069
  * The format of the captured image. Can be 'png', 'jpg', or 'bmp'.
2070
+ *
2071
+ * @default 'png'
2072
2072
  */
2073
2073
  format?: 'bmp' | 'jpg' | 'png';
2074
2074
  /**
2075
- * @defaultValue 100
2076
- *
2077
2075
  * Quality of JPEG image. Between 0 - 100.
2076
+ *
2077
+ * @default 100
2078
2078
  */
2079
2079
  quality?: number;
2080
2080
  };
@@ -2707,9 +2707,9 @@ declare type ChannelClientDisconnectionListener = (identity: ClientIdentity) =>
2707
2707
  */
2708
2708
  declare type ChannelConnectOptions = ChannelCreateOptions & {
2709
2709
  /**
2710
- * @defaultValue true
2711
- *
2712
2710
  * If true will wait for ChannelProvider to connect. If false will fail if ChannelProvider is not found.
2711
+ *
2712
+ * @default true
2713
2713
  */
2714
2714
  wait?: boolean;
2715
2715
  /**
@@ -3368,9 +3368,9 @@ declare interface CloseWindowPayload {
3368
3368
  windowId: Identity_4;
3369
3369
  options: {
3370
3370
  /**
3371
- * @defaultValue false
3372
- *
3373
3371
  * When set to true skips any before handler set on views that are part of the window
3372
+ *
3373
+ * @default false
3374
3374
  */
3375
3375
  skipBeforeUnload?: boolean;
3376
3376
  };
@@ -3475,9 +3475,9 @@ declare type ConstViewOptions = {
3475
3475
  */
3476
3476
  name: string;
3477
3477
  /**
3478
- * @defaultValue "about:blank"
3479
- *
3480
3478
  * The URL of the window
3479
+ *
3480
+ * @default "about:blank"
3481
3481
  */
3482
3482
  url: string;
3483
3483
  /**
@@ -3502,6 +3502,15 @@ declare type ConstViewOptions = {
3502
3502
  * Custom headers for requests sent by the view.
3503
3503
  */
3504
3504
  customRequestHeaders: CustomRequestHeaders[];
3505
+ /**
3506
+ * @experimental
3507
+ *
3508
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the view.
3509
+ * These css properties are used to enable dragging of a frameless window.
3510
+ *
3511
+ * @default false
3512
+ */
3513
+ disableAppRegion: boolean;
3505
3514
  /**
3506
3515
  * Initial bounds given relative to the window.
3507
3516
  */
@@ -3538,9 +3547,9 @@ declare type ConstViewOptions = {
3538
3547
  experimental: any;
3539
3548
  fdc3InteropApi?: string;
3540
3549
  /**
3541
- * @defaultValue false
3542
- *
3543
3550
  * When set to `true`, any `beforeunload` handler set on Views will fire.
3551
+ *
3552
+ * @default false
3544
3553
  */
3545
3554
  enableBeforeUnload: boolean;
3546
3555
  /**
@@ -3621,13 +3630,12 @@ declare type ConstWindowOptions = {
3621
3630
  */
3622
3631
  backgroundColor: string;
3623
3632
  /**
3624
- * @defaultValue false
3625
- *
3626
3633
  * Determines whether WebContents will throttle animations and timers when the page becomes backgrounded.
3627
3634
  * This also affects the Page Visibility API.
3628
3635
  *
3629
3636
  * When `true`, the page is throttled whether it is hidden or not.
3630
3637
  *
3638
+ * @default false
3631
3639
  */
3632
3640
  backgroundThrottling: boolean;
3633
3641
  /**
@@ -3651,21 +3659,30 @@ declare type ConstWindowOptions = {
3651
3659
  */
3652
3660
  customRequestHeaders: CustomRequestHeaders[];
3653
3661
  /**
3654
- * @defaultValue true
3655
- *
3656
3662
  * Setting this to false would keep the Window alive even if all its Views were closed.
3657
3663
  * This is meant for advanced users and should be used with caution.
3658
3664
  * Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
3659
3665
  * Use `layout.replace` to create a fresh Layout instance in case you want to populate it with Views again.
3660
3666
  * **NOTE:** - This option is ignored in non-Platforms apps.
3667
+ *
3668
+ * @default true
3661
3669
  */
3662
3670
  closeOnLastViewRemoved: boolean;
3663
3671
  /**
3664
- * @defaultValue 'all'
3672
+ * @experimental
3665
3673
  *
3674
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the window.
3675
+ * These css properties are used to enable dragging of a frameless window.
3676
+ *
3677
+ * @default false
3678
+ */
3679
+ disableAppRegion: boolean;
3680
+ /**
3666
3681
  * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
3667
- + * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3682
+ * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3668
3683
  * **NOTE:** - This option is ignored in non-Platforms apps.
3684
+ *
3685
+ * @default 'all'
3669
3686
  */
3670
3687
  viewsPreventingClose: 'all' | 'layout';
3671
3688
  /**
@@ -3676,31 +3693,31 @@ declare type ConstWindowOptions = {
3676
3693
  */
3677
3694
  defaultCentered: boolean;
3678
3695
  /**
3679
- * @defaultValue 500
3680
- *
3681
3696
  * The default height of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent launches
3682
3697
  * in favor of the cached value.
3698
+ *
3699
+ * @default 500
3683
3700
  */
3684
3701
  defaultHeight: number;
3685
3702
  /**
3686
- * @defaultValue 100
3687
- *
3688
3703
  * The default left position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3689
3704
  * launches in favor of the cached value.
3705
+ *
3706
+ * @default 100
3690
3707
  */
3691
3708
  defaultLeft: number;
3692
3709
  /**
3693
- * @defaultValue 100
3694
- *
3695
3710
  * The default top position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3696
3711
  * launches in favor of the cached value.
3712
+ *
3713
+ * @default 100
3697
3714
  */
3698
3715
  defaultTop: number;
3699
3716
  /**
3700
- * @defaultValue 800
3701
- *
3702
3717
  * The default width of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3703
3718
  * launches in favor of the cached value.
3719
+ *
3720
+ * @default 800
3704
3721
  */
3705
3722
  defaultWidth: number;
3706
3723
  /**
@@ -3746,19 +3763,19 @@ declare type ConstWindowOptions = {
3746
3763
  */
3747
3764
  processAffinity: string;
3748
3765
  /**
3749
- * @defaultValue false
3750
- *
3751
3766
  * Displays a shadow on frameless windows.
3752
3767
  * `shadow` and `cornerRounding` are mutually exclusive.
3753
3768
  * On Windows 7, Aero theme is required.
3769
+ *
3770
+ * @default false
3754
3771
  */
3755
3772
  shadow: boolean;
3756
3773
  /**
3757
- * @defaultValue true
3758
- *
3759
3774
  * Caches the location of the window.
3760
3775
  *
3761
3776
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3777
+ *
3778
+ * @default true
3762
3779
  */
3763
3780
  saveWindowState: boolean;
3764
3781
  /**
@@ -3767,22 +3784,22 @@ declare type ConstWindowOptions = {
3767
3784
  */
3768
3785
  ignoreSavedWindowState: boolean;
3769
3786
  /**
3770
- * @defaultValue false
3771
- *
3772
3787
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3773
3788
  *
3774
3789
  * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3775
3790
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3791
+ *
3792
+ * @default false
3776
3793
  */
3777
3794
  smallWindow: boolean;
3778
3795
  /**
3779
- * @defaultValue "normal"
3780
- *
3781
3796
  * The visible state of the window on creation.
3782
3797
  * One of:
3783
3798
  * * `"maximized"`
3784
3799
  * * `"minimized"`
3785
3800
  * * `"normal"`
3801
+ *
3802
+ * @default "normal"
3786
3803
  */
3787
3804
  state: WindowState;
3788
3805
  /**
@@ -3797,26 +3814,26 @@ declare type ConstWindowOptions = {
3797
3814
  */
3798
3815
  taskbarIconGroup: string;
3799
3816
  /**
3800
- * @defaultValue "about:blank"
3801
- *
3802
3817
  * The URL of the window
3818
+ *
3819
+ * @default "about:blank"
3803
3820
  */
3804
3821
  url: string;
3805
3822
  /**
3806
- * @defaultValue <application UUID>
3807
- *
3808
3823
  * The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
3809
3824
  * If omitted, defaults to the `uuid` of the application spawning the window.
3810
3825
  * If given, must match the `uuid` of the application spawning the window.
3811
3826
  * In other words, the application's `uuid` is the only acceptable value, but is the default, so there's
3812
3827
  * really no need to provide it.
3828
+ *
3829
+ * @default <application UUID>
3813
3830
  */
3814
3831
  uuid: string;
3815
3832
  /**
3816
- * @defaultValue false
3817
- *
3818
3833
  * When set to `true`, the window will not appear until the `window` object's `load` event fires.
3819
3834
  * When set to `false`, the window will appear immediately without waiting for content to be loaded.
3835
+ *
3836
+ * @default false
3820
3837
  */
3821
3838
  waitForPageLoad: boolean;
3822
3839
  width: number;
@@ -4098,13 +4115,13 @@ declare type CopyBlockedEventReason = 'disabled';
4098
4115
  */
4099
4116
  declare type CopyPermissions = {
4100
4117
  /**
4101
- * @defaultValue 'allowed'
4102
- *
4103
4118
  * Controls the behavior for copy operations for a matched URL.
4104
4119
  *
4105
4120
  * allow: Enables all copy operations.
4106
4121
  * block: Disables all copy operations.
4107
4122
  * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
4123
+ *
4124
+ * @default 'allowed'
4108
4125
  */
4109
4126
  behavior: 'allow' | 'block' | 'protect';
4110
4127
  /**
@@ -4112,9 +4129,9 @@ declare type CopyPermissions = {
4112
4129
  */
4113
4130
  options?: {
4114
4131
  /**
4115
- * @defaultValue ''
4116
- *
4117
4132
  * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
4133
+ *
4134
+ * @default ''
4118
4135
  */
4119
4136
  replacementText: string;
4120
4137
  };
@@ -4128,15 +4145,15 @@ declare type CopyPermissions = {
4128
4145
  */
4129
4146
  declare type CornerRounding = {
4130
4147
  /**
4131
- * @defaultValue 0
4132
- *
4133
4148
  * The height in pixels.
4149
+ *
4150
+ * @default 0
4134
4151
  */
4135
4152
  height: number;
4136
4153
  /**
4137
- * @defaultValue 0
4138
- *
4139
4154
  * The width in pixels.
4155
+ *
4156
+ * @default 0
4140
4157
  */
4141
4158
  width: number;
4142
4159
  };
@@ -4226,8 +4243,6 @@ declare type CreateLayoutOptions = {
4226
4243
  layoutName: string;
4227
4244
  layout: LayoutOptions;
4228
4245
  /**
4229
- * @defaultValue 'default'
4230
- *
4231
4246
  * Controls the View behavior for the given `layout` property. Note
4232
4247
  * that the selected behavior only applies to unnamed Views or
4233
4248
  * Views with the prefix `internal-generated-`. In all cases, if any
@@ -4249,6 +4264,8 @@ declare type CreateLayoutOptions = {
4249
4264
  * override. Note that during applyLayoutSnapshot, Views are created and
4250
4265
  * attached to the Provider while the Window is being created, so it's
4251
4266
  * important to not 'duplicate' Views in this workflow.
4267
+ *
4268
+ * @default 'default'
4252
4269
  */
4253
4270
  multiInstanceViewBehavior?: MultiInstanceViewBehavior;
4254
4271
  };
@@ -4507,7 +4524,7 @@ declare type DomainApiSettings = {
4507
4524
  * * 'none': The `fin` API will be not available.
4508
4525
  * * 'global': The entire `fin` API will be available.
4509
4526
  *
4510
- * @defaultValue 'global'
4527
+ * @default 'global'
4511
4528
  */
4512
4529
  fin?: InjectionType;
4513
4530
  /**
@@ -5092,9 +5109,9 @@ declare type EventType_9 = Event_12['type'];
5092
5109
  */
5093
5110
  declare type ExcludeOptions = {
5094
5111
  /**
5095
- * @defaultValue false
5096
- *
5097
5112
  * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
5113
+ *
5114
+ * @default false
5098
5115
  */
5099
5116
  preloadScripts: boolean;
5100
5117
  };
@@ -5568,34 +5585,34 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
5568
5585
  */
5569
5586
  declare type FindInPageOptions = {
5570
5587
  /**
5571
- * @defaultValue true
5572
- *
5573
5588
  * Searches in the forward direction (backward otherwise)
5589
+ *
5590
+ * @default true
5574
5591
  */
5575
5592
  forward?: boolean;
5576
5593
  /**
5577
- * @defaultValue false
5578
- *
5579
5594
  * Begins a new text-finding session; should be true for first request only, and false on subsequent requests.
5595
+ *
5596
+ * @default false
5580
5597
  */
5581
5598
  findNext?: boolean;
5582
5599
  /**
5583
- * @defaultValue false
5584
- *
5585
5600
  * Enables case-sensitive searching.
5601
+ *
5602
+ * @default false
5586
5603
  */
5587
5604
  matchCase?: boolean;
5588
5605
  /**
5589
- * @defaultValue false
5590
- *
5591
5606
  * Only searches from the start of words.
5607
+ *
5608
+ * @default false
5592
5609
  */
5593
5610
  wordStart?: boolean;
5594
5611
  /**
5595
- * @defaultValue false
5596
- *
5597
5612
  * 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>
5598
5613
  * lowercase or non-letter. Accepts several other intra-word matches.
5614
+ *
5615
+ * @default false
5599
5616
  */
5600
5617
  medialCapitalAsWordStart?: boolean;
5601
5618
  };
@@ -6103,9 +6120,9 @@ declare type Hotkey = {
6103
6120
  */
6104
6121
  keys: string;
6105
6122
  /**
6106
- * @defaultValue false
6107
- *
6108
6123
  * Prevent default key handling before emitting the event.
6124
+ *
6125
+ * @default false
6109
6126
  */
6110
6127
  preventDefault?: boolean;
6111
6128
  };
@@ -8462,77 +8479,79 @@ declare type LayoutOptions = {
8462
8479
  */
8463
8480
  newTabButtonUrl?: string;
8464
8481
  /**
8465
- * @defaultValue false
8466
- *
8467
8482
  * When true the splitters will not be draggable and the layout will not resize.
8483
+ *
8484
+ * @default false
8468
8485
  */
8469
8486
  preventSplitterResize?: boolean;
8470
8487
  /**
8471
- * @defaultValue false
8472
- *
8473
8488
  * Whether the popout button will only act on the entire stack,
8474
8489
  * as opposed to only the active tab.
8490
+ *
8491
+ * @default false
8475
8492
  */
8476
8493
  popoutWholeStack?: boolean;
8477
8494
  /**
8478
- * @defaultValue false
8479
- *
8480
8495
  * Limits the area to which tabs can be dragged.
8481
8496
  * If true, the layout container is the only area where tabs can be dropped.
8497
+ *
8498
+ * @default false
8482
8499
  */
8483
8500
  constrainDragToContainer?: boolean;
8484
8501
  /**
8485
- * @defaultValue false
8486
- *
8487
8502
  * Whether to show the popout button on stack header.
8488
8503
  * The button will create a new window with current tab as its content.
8489
8504
  * In case `popoutWholeStack` is set to true, all tabs in the stack will be in the new window.
8505
+ *
8506
+ * @default false
8490
8507
  */
8491
8508
  showPopoutIcon?: boolean;
8492
8509
  /**
8493
- * @defaultValue false
8494
- *
8495
8510
  * Whether to show the maximize button on stack header.
8496
8511
  * The button will maximize the current tab to fill the entire window.
8512
+ *
8513
+ * @default false
8497
8514
  */
8498
8515
  showMaximiseIcon?: boolean;
8499
8516
  /**
8500
- * @defaultValue false
8501
- *
8502
8517
  * Whether to show the close button on stack header
8503
8518
  * (not to be confused with close button on every tab).
8519
+ *
8520
+ * @default false
8504
8521
  */
8505
8522
  showCloseIcon?: boolean;
8506
8523
  /**
8507
- * @defaultValue false
8508
- *
8509
8524
  * Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped.
8525
+ *
8526
+ * @default false
8510
8527
  */
8511
8528
  constrainDragToHeaders?: boolean;
8512
8529
  /**
8513
- * @defaultValue true
8514
- *
8515
8530
  * Turns tab headers on or off.
8516
8531
  * If false, the layout will be displayed with splitters only.
8532
+ *
8533
+ * @default true
8517
8534
  */
8518
8535
  hasHeaders?: boolean;
8519
8536
  /**
8520
- * @defaultValue true
8521
- *
8522
8537
  * If true, the user can re-arrange the layout by
8523
8538
  * dragging items by their tabs to the desired location.
8539
+ *
8540
+ * @default true
8524
8541
  */
8525
8542
  reorderEnabled?: boolean;
8526
8543
  /**
8527
- * @defaultValue false
8528
- *
8529
8544
  * If true, tabs can't be dragged out of the window.
8545
+ *
8546
+ * @default false
8530
8547
  */
8531
8548
  preventDragOut?: boolean;
8532
8549
  /**
8533
8550
  * @defaultValue=false
8534
8551
  *
8535
8552
  * If true, tabs can't be dragged into the window.
8553
+ *
8554
+ * @default false
8536
8555
  */
8537
8556
  preventDragIn?: boolean;
8538
8557
  };
@@ -8984,10 +9003,10 @@ declare type MutableViewOptions = {
8984
9003
  /**
8985
9004
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
8986
9005
  *
8987
- * @defaultValue true
8988
- *
8989
9006
  * Show the context menu when right-clicking on the view.
8990
9007
  * Gives access to the devtools for the view.
9008
+ *
9009
+ * @default true
8991
9010
  */
8992
9011
  contextMenu: boolean;
8993
9012
  /**
@@ -9034,24 +9053,25 @@ declare type MutableViewOptions = {
9034
9053
  contentNavigation: ContentNavigation;
9035
9054
  contentRedirect: ContentRedirect;
9036
9055
  /**
9037
- * @defaultValue false
9038
9056
  * @deprecated
9039
9057
  * **Platforms Only.** If true, will hide and detach the View from the window for later use instead of closing,
9040
9058
  * allowing the state of the View to be saved and the View to be immediately shown in a new Layout.
9059
+ *
9060
+ * @default false
9041
9061
  */
9042
9062
  detachOnClose: boolean;
9043
9063
  /**
9044
- * @defaultValue true
9045
- *
9046
9064
  * **Platforms Only.** If false, the view will be persistent and can't be closed through
9047
9065
  * either UI or `Platform.closeView`. Note that the view will still be closed if the host window is closed or
9048
9066
  * if the view isn't part of the new layout when running `Layout.replace`.
9067
+ *
9068
+ * @default true
9049
9069
  */
9050
9070
  isClosable: boolean;
9051
9071
  /**
9052
- * @defaultValue false
9053
- *
9054
9072
  * **Platforms Only.** If true, the tab of the view can't be dragged out of its host window.
9073
+ *
9074
+ * @default false
9055
9075
  */
9056
9076
  preventDragOut: boolean;
9057
9077
  interop?: InteropConfig;
@@ -9059,7 +9079,7 @@ declare type MutableViewOptions = {
9059
9079
  /**
9060
9080
  * {@inheritDoc ViewThrottling}
9061
9081
  *
9062
- * @defaultValue 'enabled'
9082
+ * @default 'enabled'
9063
9083
  */
9064
9084
  throttling: ViewThrottling;
9065
9085
  /**
@@ -9078,7 +9098,7 @@ declare type MutableWindowOptions = {
9078
9098
  * Turns anything of matching RGB value transparent.
9079
9099
  *
9080
9100
  * Caveats:
9081
- * * runtime key --disable-gpu is required. Note: Unclear behavior on remote Desktop support
9101
+ * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
9082
9102
  * * User cannot click-through transparent regions
9083
9103
  * * Not supported on Mac
9084
9104
  * * Windows Aero must be enabled
@@ -9087,25 +9107,25 @@ declare type MutableWindowOptions = {
9087
9107
  */
9088
9108
  alphaMask: RGB;
9089
9109
  /**
9090
- * @defaultValue false
9091
- *
9092
9110
  * Always position the window at the top of the window stack.
9111
+ *
9112
+ * @default false
9093
9113
  */
9094
9114
  alwaysOnTop: boolean;
9095
9115
  /**
9096
- * @defaultValue 0
9097
- *
9098
9116
  * The aspect ratio of width to height to enforce for the window. If this value is equal to or less than zero,
9099
9117
  * an aspect ratio will not be enforced.
9118
+ *
9119
+ * @default 0
9100
9120
  */
9101
9121
  aspectRatio: number;
9102
9122
  /**
9103
9123
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
9104
9124
  *
9105
- * @defaultValue true
9106
- *
9107
9125
  * Show the context menu when right-clicking on the window.
9108
9126
  * Gives access to the devtools for the window.
9127
+ *
9128
+ * @default true
9109
9129
  */
9110
9130
  contextMenu: boolean;
9111
9131
  /**
@@ -9172,15 +9192,18 @@ declare type MutableWindowOptions = {
9172
9192
  */
9173
9193
  customData: any;
9174
9194
  /**
9195
+ * @deprecated Will be removed in runtime version 45
9175
9196
  * @defaultValue true
9176
9197
  *
9177
9198
  * Show the window's frame.
9199
+ *
9200
+ * @default true
9178
9201
  */
9179
9202
  frame: boolean;
9180
9203
  /**
9181
- * @defaultValue false
9182
- *
9183
9204
  * Hides the window instead of closing it when the close button is pressed.
9205
+ *
9206
+ * @default false
9184
9207
  */
9185
9208
  hideOnClose: boolean;
9186
9209
  /**
@@ -9233,60 +9256,61 @@ declare type MutableWindowOptions = {
9233
9256
  */
9234
9257
  icon: string;
9235
9258
  /**
9236
- * @defaultValue true
9237
- *
9238
9259
  * Include window in snapshots returned by Platform.getSnapshot(). Turning this off may be desirable when dealing with
9239
9260
  * inherently temporary windows whose state shouldn't be preserved, such as modals, menus, or popups.
9261
+ *
9262
+ * @default true
9240
9263
  */
9241
9264
  includeInSnapshots: boolean;
9242
9265
  /**
9243
- * @defaultValue -1
9244
- *
9245
9266
  * The maximum height of a window. Will default to the OS defined value if set to -1.
9267
+ *
9268
+ * @default -1
9246
9269
  */
9247
9270
  maxHeight: number;
9248
9271
  /**
9249
- * @defaultValue true
9250
- *
9251
9272
  * Allows the window to be maximized.
9273
+ *
9274
+ * @default true
9252
9275
  */
9253
9276
  maximizable: boolean;
9254
9277
  /**
9255
- * @defaultValue -1
9256
- *
9257
9278
  * The maximum width of a window. Will default to the OS defined value if set to -1.
9279
+ *
9280
+ * @default -1
9258
9281
  */
9259
9282
  maxWidth: number;
9260
9283
  /**
9261
- * @defaultValue 0
9262
- *
9263
9284
  * The minimum height of the window.
9285
+ *
9286
+ * @default 0
9264
9287
  */
9265
9288
  minHeight: number;
9266
9289
  /**
9267
- * @defaultValue true
9268
- *
9269
9290
  * Allows the window to be minimized.
9291
+ *
9292
+ * @default true
9270
9293
  */
9271
9294
  minimizable: boolean;
9272
9295
  /**
9273
- * @defaultValue true
9274
- *
9275
9296
  * The minimum width of the window.
9297
+ *
9298
+ * @default true
9276
9299
  */
9277
9300
  minWidth: number;
9278
9301
  /**
9279
- * @defaultValue 1
9280
- *
9281
9302
  * A flag that specifies how transparent the window will be.
9282
9303
  * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
9283
9304
  * This value is clamped between `0.0` and `1.0`.
9305
+ * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
9306
+ *
9307
+ * @default 1
9284
9308
  */
9285
9309
  opacity: number;
9286
9310
  /**
9287
- * @defaultValue true
9288
- *
9289
9311
  * A flag to allow the user to resize the window.
9312
+ *
9313
+ * @default true
9290
9314
  */
9291
9315
  resizable: boolean;
9292
9316
  /**
@@ -9294,16 +9318,16 @@ declare type MutableWindowOptions = {
9294
9318
  */
9295
9319
  resizeRegion: ResizeRegion;
9296
9320
  /**
9297
- * @defaultValue false
9298
- *
9299
9321
  * **Platforms Only.** If true, will show background images in the layout when the Views are hidden.
9300
9322
  * This occurs when the window is resizing or a tab is being dragged within the layout.
9323
+ *
9324
+ * @default false
9301
9325
  */
9302
9326
  showBackgroundImages: boolean;
9303
9327
  /**
9304
- * @defaultValue true
9305
- *
9306
9328
  * Shows the window's icon in the taskbar.
9329
+ *
9330
+ * @default true
9307
9331
  */
9308
9332
  showTaskbarIcon: boolean;
9309
9333
  /**
@@ -9322,7 +9346,7 @@ declare type MutableWindowOptions = {
9322
9346
  /**
9323
9347
  * {@inheritDoc WindowThrottling}
9324
9348
  *
9325
- * @defaultValue 'enabled'
9349
+ * @default 'enabled'
9326
9350
  *
9327
9351
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9328
9352
  */
@@ -9934,12 +9958,12 @@ declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
9934
9958
  */
9935
9959
  declare type PastePermissions = {
9936
9960
  /**
9937
- * @defaultValue 'non-protected-content'
9938
- *
9939
9961
  * Controls the behavior for paste operations for a matched URL.
9940
9962
  *
9941
9963
  * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
9942
9964
  * 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.
9965
+ *
9966
+ * @default 'non-protected-content'
9943
9967
  */
9944
9968
  behavior: 'non-protected-content' | 'all-content';
9945
9969
  };
@@ -10970,11 +10994,11 @@ declare type PlatformOptions = ApplicationCreationOptions & {
10970
10994
  */
10971
10995
  providerUrl?: string;
10972
10996
  /**
10973
- * @defaultValue true
10974
- *
10975
10997
  * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
10976
10998
  *
10977
10999
  * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
11000
+ *
11001
+ * @default true
10978
11002
  */
10979
11003
  allowLaunchIntoPlatform?: boolean;
10980
11004
  };
@@ -11618,22 +11642,22 @@ declare type PopupOptions = {
11618
11642
  url?: string;
11619
11643
  /**
11620
11644
  * Height of the popup window in pixels (takes priority over `intialOptions` size properties).
11621
- * @defaultValue 300
11645
+ * @default 300
11622
11646
  */
11623
11647
  height?: number;
11624
11648
  /**
11625
11649
  * Width of the popup window in pixels (takes priority over `intialOptions` size properties).
11626
- * @defaultValue 300
11650
+ * @default 300
11627
11651
  */
11628
11652
  width?: number;
11629
11653
  /**
11630
11654
  * Left position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
11631
- * @defaultValue 0
11655
+ * @default 0
11632
11656
  */
11633
11657
  x?: number;
11634
11658
  /**
11635
11659
  * Top position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
11636
- * @defaultValue 0
11660
+ * @default 0
11637
11661
  */
11638
11662
  y?: number;
11639
11663
  /**
@@ -11641,7 +11665,7 @@ declare type PopupOptions = {
11641
11665
  * * 'modal' restricts resizing and positioning in the caller.
11642
11666
  * * 'hide' hides the popup window on blur.
11643
11667
  * * 'close' closes the popup window on blur.
11644
- * @defaultValue 'close'
11668
+ * @default 'close'
11645
11669
  */
11646
11670
  blurBehavior?: PopupBlurBehavior;
11647
11671
  /**
@@ -11649,19 +11673,19 @@ declare type PopupOptions = {
11649
11673
  * * 'none' will do nothing.
11650
11674
  * * 'hide' hides the popup window on `dispatchPopupResult`.
11651
11675
  * * 'close' closes the popup window on `dispatchPopupResult`.
11652
- * @defaultValue 'close'
11676
+ * @default 'close'
11653
11677
  */
11654
11678
  resultDispatchBehavior?: PopupResultBehavior;
11655
11679
  /**
11656
11680
  * Hide the popup window instead of closing when `close` is called on it.
11657
11681
  *
11658
11682
  * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
11659
- * @defaultValue false
11683
+ * @default false
11660
11684
  */
11661
11685
  hideOnClose?: boolean;
11662
11686
  /**
11663
11687
  * Determines if the popup window should or should not be focused when it is shown.
11664
- * @defaultValue true
11688
+ * @default true
11665
11689
  */
11666
11690
  focus?: boolean;
11667
11691
  /**
@@ -11755,9 +11779,9 @@ declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | '
11755
11779
  */
11756
11780
  declare type PreloadScript = {
11757
11781
  /**
11758
- * @defaultValue false
11759
- *
11760
11782
  * Fail to load the window if this preload script fails
11783
+ *
11784
+ * @default false
11761
11785
  */
11762
11786
  mandatory?: boolean;
11763
11787
  /**
@@ -11853,15 +11877,15 @@ declare type PrinterInfo = {
11853
11877
  declare type PrintOptions = {
11854
11878
  content?: 'self';
11855
11879
  /**
11856
- * @defaultValue false
11857
- *
11858
11880
  * Disables prompting the user for print settings.
11881
+ *
11882
+ * @default false
11859
11883
  */
11860
11884
  silent?: boolean;
11861
11885
  /**
11862
- * @defaultValue false
11863
- *
11864
11886
  * Includes the webpage background color and image when printing.
11887
+ *
11888
+ * @default false
11865
11889
  */
11866
11890
  printBackground?: boolean;
11867
11891
  /**
@@ -11869,9 +11893,9 @@ declare type PrintOptions = {
11869
11893
  */
11870
11894
  deviceName?: string;
11871
11895
  /**
11872
- * @defaultValue true
11873
- *
11874
11896
  * Prints in full color (greyscale otherwise).
11897
+ *
11898
+ * @default true
11875
11899
  */
11876
11900
  color?: boolean;
11877
11901
  /**
@@ -11879,9 +11903,9 @@ declare type PrintOptions = {
11879
11903
  */
11880
11904
  margins?: Margins;
11881
11905
  /**
11882
- * @defaultValue true
11883
- *
11884
11906
  * Prints in landscape mode (portrait otherwise).
11907
+ *
11908
+ * @default true
11885
11909
  */
11886
11910
  landscape?: boolean;
11887
11911
  /**
@@ -13062,15 +13086,15 @@ declare type ReplaceViewPayload = {
13062
13086
  */
13063
13087
  declare type ResizeRegion = {
13064
13088
  /**
13065
- * @defaultValue 7
13066
- *
13067
13089
  * The size of the resize region in pixels.
13090
+ *
13091
+ * @default 7
13068
13092
  */
13069
13093
  size?: number;
13070
13094
  /**
13071
- * @defaultValue 9
13072
- *
13073
13095
  * The size in pixels of an additional square resizable region located at the bottom right corner of a frameless window.
13096
+ *
13097
+ * @default 9
13074
13098
  */
13075
13099
  bottomRightCorner?: number;
13076
13100
  /**
@@ -13078,27 +13102,27 @@ declare type ResizeRegion = {
13078
13102
  */
13079
13103
  sides?: {
13080
13104
  /**
13081
- * @defaultValue true
13082
- *
13083
13105
  * Enables resizing from the top of the window.
13106
+ *
13107
+ * @default true
13084
13108
  */
13085
13109
  top?: boolean;
13086
13110
  /**
13087
- * @defaultValue true
13088
- *
13089
13111
  * Enables resizing from the bottom of the window.
13112
+ *
13113
+ * @default true
13090
13114
  */
13091
13115
  bottom?: boolean;
13092
13116
  /**
13093
- * @defaultValue true
13094
- *
13095
13117
  * Enables resizing from the left side of the window.
13118
+ *
13119
+ * @default true
13096
13120
  */
13097
13121
  left?: boolean;
13098
13122
  /**
13099
- * @defaultValue true
13100
- *
13101
13123
  * Enables resizing from the right side of the window.
13124
+ *
13125
+ * @default true
13102
13126
  */
13103
13127
  right?: boolean;
13104
13128
  };
@@ -13650,9 +13674,9 @@ declare type ShowTrayIconPopupMenuOptions<Data extends unknown = unknown> = {
13650
13674
  */
13651
13675
  declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
13652
13676
  /**
13653
- * @defaultValue 0
13654
- *
13655
13677
  * Number of milliseconds to wait between view repaints.
13678
+ *
13679
+ * @default 0
13656
13680
  */
13657
13681
  paintIntervalMs?: number;
13658
13682
  };
@@ -15696,9 +15720,9 @@ declare type TransitionBase = {
15696
15720
  */
15697
15721
  duration: number;
15698
15722
  /**
15699
- * @defaultValue false
15700
- *
15701
15723
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
15724
+ *
15725
+ * @default false
15702
15726
  */
15703
15727
  relative?: boolean;
15704
15728
  };
@@ -15714,9 +15738,9 @@ declare type TransitionOptions = {
15714
15738
  */
15715
15739
  interrupt: boolean;
15716
15740
  /**
15717
- * @defaultValue false
15718
- *
15719
15741
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
15742
+ *
15743
+ * @default false
15720
15744
  */
15721
15745
  relative?: boolean;
15722
15746
  tween?: tween;
@@ -16644,9 +16668,9 @@ declare type ViewTitlePriority = 'document' | 'options';
16644
16668
  */
16645
16669
  declare type ViewVisibilityOption = {
16646
16670
  /**
16647
- * @defaultValue false
16648
- *
16649
16671
  * Enables or disables showing views when the layout splitter or a tab is being dragged or a Platform Window is being resized.
16672
+ *
16673
+ * @default false
16650
16674
  */
16651
16675
  enabled?: boolean;
16652
16676
  };