@openfin/core 41.102.5 → 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.
package/out/stub.d.ts CHANGED
@@ -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
  /**
@@ -1184,19 +1184,19 @@ declare class ApplicationModule extends Base {
1184
1184
  */
1185
1185
  declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1186
1186
  /**
1187
- * @defaultValue false
1188
- *
1189
1187
  * Disables IAB secure logging for the app.
1188
+ *
1189
+ * @default false
1190
1190
  */
1191
1191
  disableIabSecureLogging: boolean;
1192
1192
  /**
1193
- * @defaultValue 'There was an error loading the application.'
1194
- *
1195
1193
  * An error message to display when the application (launched via manifest) fails to load.
1196
1194
  * A dialog box will be launched with the error message just before the runtime exits.
1197
1195
  * Load fails such as failed DNS resolutions or aborted connections as well as cancellations, _e.g.,_ `window.stop()`,
1198
1196
  * will trigger this dialog.
1199
1197
  * Client response codes such as `404 Not Found` are not treated as fails as they are valid server responses.
1198
+ *
1199
+ * @default 'There was an error loading the application.'
1200
1200
  */
1201
1201
  loadErrorMessage: string;
1202
1202
  /**
@@ -1215,28 +1215,28 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1215
1215
  */
1216
1216
  name: string;
1217
1217
  /**
1218
- * @defaultValue false
1219
- *
1220
1218
  * A flag to configure the application as non-persistent.
1221
1219
  * Runtime exits when there are no persistent apps running.
1220
+ *
1221
+ * @default false
1222
1222
  */
1223
1223
  nonPersistent: boolean;
1224
1224
  /**
1225
- * @defaultValue false
1226
- *
1227
1225
  * Enable Flash at the application level.
1226
+ *
1227
+ * @default false
1228
1228
  */
1229
1229
  plugins: boolean;
1230
1230
  /**
1231
- * @defaultValue false
1232
- *
1233
1231
  * Enable spell check at the application level.
1232
+ *
1233
+ * @default false
1234
1234
  */
1235
1235
  spellCheck: boolean;
1236
1236
  /**
1237
- * @defaultValue 'about:blank'
1238
- *
1239
1237
  * The url to the application (specifically the application's main window).
1238
+ *
1239
+ * @default 'about:blank'
1240
1240
  */
1241
1241
  url: string;
1242
1242
  /**
@@ -1245,9 +1245,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1245
1245
  */
1246
1246
  uuid: string;
1247
1247
  /**
1248
- * @defaultValue true
1249
- *
1250
1248
  * When set to `false` it will disable the same-origin policy for the app.
1249
+ *
1250
+ * @default true
1251
1251
  */
1252
1252
  webSecurity: boolean;
1253
1253
  /**
@@ -1257,10 +1257,10 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1257
1257
  commands: ShortcutOverride[];
1258
1258
  isPlatformController: boolean;
1259
1259
  /**
1260
- * @defaultValue 1000
1261
- *
1262
1260
  * **Platforms Only.** The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed.
1263
1261
  * If you do not wish for views to be pooled on your platform, set this property to zero.
1262
+ *
1263
+ * @default 1000
1264
1264
  */
1265
1265
  maxViewPoolSize: number;
1266
1266
  /**
@@ -1276,12 +1276,12 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1276
1276
  */
1277
1277
  snapshot: Snapshot;
1278
1278
  /**
1279
- * @defaultValue false
1280
- *
1281
1279
  * **Platforms Only.** Prevent the Platform Provider from quitting automatically when the last Platform Window is closed.
1282
1280
  *
1283
1281
  * Note: if the Platform Provider is showing, it won't close automatically.
1284
1282
  * If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.
1283
+ *
1284
+ * @default false
1285
1285
  */
1286
1286
  preventQuitOnLastWindowClosed: boolean;
1287
1287
  /**
@@ -1289,9 +1289,9 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1289
1289
  */
1290
1290
  interopBrokerConfiguration: InteropBrokerOptions;
1291
1291
  /**
1292
- * @defaultValue true
1293
- *
1294
1292
  * When set to `false` it will disable OpenFin Diagnostics for the app.
1293
+ *
1294
+ * @default true
1295
1295
  */
1296
1296
  apiDiagnostics: boolean;
1297
1297
  /**
@@ -1307,16 +1307,16 @@ declare type ApplicationOptions = LegacyWinOptionsInAppOptions & {
1307
1307
  */
1308
1308
  permissions?: Partial<Permissions_2>;
1309
1309
  /**
1310
- * @defaultValue false
1311
- *
1312
1310
  * Enables the use of the Jumplists API and the 'pin to taskbar' functionality.
1313
1311
  * Only relevant in Windows.
1312
+ *
1313
+ * @default false
1314
1314
  */
1315
1315
  enableJumpList: boolean;
1316
1316
  /**
1317
- * @defaultValue false
1318
- *
1319
1317
  * When set to `true`, any `beforeunload` handler set on the app will fire.
1318
+ *
1319
+ * @default false
1320
1320
  */
1321
1321
  enableBeforeUnload: boolean;
1322
1322
  /**
@@ -1397,25 +1397,25 @@ declare type ApplicationWindowInfo = {
1397
1397
  */
1398
1398
  declare type ApplySnapshotOptions = {
1399
1399
  /**
1400
- * @defaultValue false
1401
- *
1402
1400
  * When true, applySnapshot will close existing windows,
1403
1401
  * replacing current Platform state with the given snapshot.
1402
+ *
1403
+ * @default false
1404
1404
  */
1405
1405
  closeExistingWindows?: boolean;
1406
1406
  /**
1407
- * @defaultValue false
1408
- *
1409
1407
  * When true, applySnapshot will close existing includeInSnapshots: true windows,
1410
1408
  * replacing current Platform state with the given snapshot.
1409
+ *
1410
+ * @default false
1411
1411
  */
1412
1412
  closeSnapshotWindows?: boolean;
1413
1413
  /**
1414
- * @defaultValue false
1415
- *
1416
1414
  * When true, applySnapshot will not check whether any windows in a
1417
1415
  * snapshot are off-screen. By default, such windows will be repositioned to be on-screen,
1418
1416
  * as defined by {@link PlatformProvider#positionOutOfBoundsWindows PlatformProvider.positionOutOfBoundsWindows}.
1417
+ *
1418
+ * @default false
1419
1419
  */
1420
1420
  skipOutOfBoundsCheck?: boolean;
1421
1421
  };
@@ -2098,15 +2098,15 @@ declare type CapturePageOptions = {
2098
2098
  */
2099
2099
  area?: Rectangle;
2100
2100
  /**
2101
- * @defaultValue 'png'
2102
- *
2103
2101
  * The format of the captured image. Can be 'png', 'jpg', or 'bmp'.
2102
+ *
2103
+ * @default 'png'
2104
2104
  */
2105
2105
  format?: 'bmp' | 'jpg' | 'png';
2106
2106
  /**
2107
- * @defaultValue 100
2108
- *
2109
2107
  * Quality of JPEG image. Between 0 - 100.
2108
+ *
2109
+ * @default 100
2110
2110
  */
2111
2111
  quality?: number;
2112
2112
  };
@@ -2760,9 +2760,9 @@ declare type ChannelClientDisconnectionListener = (identity: ClientIdentity) =>
2760
2760
  */
2761
2761
  declare type ChannelConnectOptions = ChannelCreateOptions & {
2762
2762
  /**
2763
- * @defaultValue true
2764
- *
2765
2763
  * If true will wait for ChannelProvider to connect. If false will fail if ChannelProvider is not found.
2764
+ *
2765
+ * @default true
2766
2766
  */
2767
2767
  wait?: boolean;
2768
2768
  /**
@@ -3424,9 +3424,9 @@ declare interface CloseWindowPayload {
3424
3424
  windowId: Identity_4;
3425
3425
  options: {
3426
3426
  /**
3427
- * @defaultValue false
3428
- *
3429
3427
  * When set to true skips any before handler set on views that are part of the window
3428
+ *
3429
+ * @default false
3430
3430
  */
3431
3431
  skipBeforeUnload?: boolean;
3432
3432
  };
@@ -3534,9 +3534,9 @@ declare type ConstViewOptions = {
3534
3534
  */
3535
3535
  name: string;
3536
3536
  /**
3537
- * @defaultValue "about:blank"
3538
- *
3539
3537
  * The URL of the window
3538
+ *
3539
+ * @default "about:blank"
3540
3540
  */
3541
3541
  url: string;
3542
3542
  /**
@@ -3561,6 +3561,15 @@ declare type ConstViewOptions = {
3561
3561
  * Custom headers for requests sent by the view.
3562
3562
  */
3563
3563
  customRequestHeaders: CustomRequestHeaders[];
3564
+ /**
3565
+ * @experimental
3566
+ *
3567
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the view.
3568
+ * These css properties are used to enable dragging of a frameless window.
3569
+ *
3570
+ * @default false
3571
+ */
3572
+ disableAppRegion: boolean;
3564
3573
  /**
3565
3574
  * Initial bounds given relative to the window.
3566
3575
  */
@@ -3597,9 +3606,9 @@ declare type ConstViewOptions = {
3597
3606
  experimental: any;
3598
3607
  fdc3InteropApi?: string;
3599
3608
  /**
3600
- * @defaultValue false
3601
- *
3602
3609
  * When set to `true`, any `beforeunload` handler set on Views will fire.
3610
+ *
3611
+ * @default false
3603
3612
  */
3604
3613
  enableBeforeUnload: boolean;
3605
3614
  /**
@@ -3680,13 +3689,12 @@ declare type ConstWindowOptions = {
3680
3689
  */
3681
3690
  backgroundColor: string;
3682
3691
  /**
3683
- * @defaultValue false
3684
- *
3685
3692
  * Determines whether WebContents will throttle animations and timers when the page becomes backgrounded.
3686
3693
  * This also affects the Page Visibility API.
3687
3694
  *
3688
3695
  * When `true`, the page is throttled whether it is hidden or not.
3689
3696
  *
3697
+ * @default false
3690
3698
  */
3691
3699
  backgroundThrottling: boolean;
3692
3700
  /**
@@ -3710,21 +3718,30 @@ declare type ConstWindowOptions = {
3710
3718
  */
3711
3719
  customRequestHeaders: CustomRequestHeaders[];
3712
3720
  /**
3713
- * @defaultValue true
3714
- *
3715
3721
  * Setting this to false would keep the Window alive even if all its Views were closed.
3716
3722
  * This is meant for advanced users and should be used with caution.
3717
3723
  * Limitations - Once a Layout has been emptied out of all views it's not usable anymore, and certain API calls will fail.
3718
3724
  * Use `layout.replace` to create a fresh Layout instance in case you want to populate it with Views again.
3719
3725
  * **NOTE:** - This option is ignored in non-Platforms apps.
3726
+ *
3727
+ * @default true
3720
3728
  */
3721
3729
  closeOnLastViewRemoved: boolean;
3722
3730
  /**
3723
- * @defaultValue 'all'
3731
+ * @experimental
3724
3732
  *
3733
+ * When set to true, will prevent setting the `-webkit-app-region` and `app-region` css properties on the window.
3734
+ * These css properties are used to enable dragging of a frameless window.
3735
+ *
3736
+ * @default false
3737
+ */
3738
+ disableAppRegion: boolean;
3739
+ /**
3725
3740
  * When `closeOnLastViewRemoved` is set to true, determines which views prevent closing the window.
3726
- + * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3741
+ * Defaults to `all`. You may want to switch this to `layout` if using View closeBehavior: 'hide'.
3727
3742
  * **NOTE:** - This option is ignored in non-Platforms apps.
3743
+ *
3744
+ * @default 'all'
3728
3745
  */
3729
3746
  viewsPreventingClose: 'all' | 'layout';
3730
3747
  /**
@@ -3735,31 +3752,31 @@ declare type ConstWindowOptions = {
3735
3752
  */
3736
3753
  defaultCentered: boolean;
3737
3754
  /**
3738
- * @defaultValue 500
3739
- *
3740
3755
  * The default height of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent launches
3741
3756
  * in favor of the cached value.
3757
+ *
3758
+ * @default 500
3742
3759
  */
3743
3760
  defaultHeight: number;
3744
3761
  /**
3745
- * @defaultValue 100
3746
- *
3747
3762
  * The default left position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3748
3763
  * launches in favor of the cached value.
3764
+ *
3765
+ * @default 100
3749
3766
  */
3750
3767
  defaultLeft: number;
3751
3768
  /**
3752
- * @defaultValue 100
3753
- *
3754
3769
  * The default top position of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3755
3770
  * launches in favor of the cached value.
3771
+ *
3772
+ * @default 100
3756
3773
  */
3757
3774
  defaultTop: number;
3758
3775
  /**
3759
- * @defaultValue 800
3760
- *
3761
3776
  * The default width of the window. When `saveWindowState` is `true`, this value will be ignored for subsequent
3762
3777
  * launches in favor of the cached value.
3778
+ *
3779
+ * @default 800
3763
3780
  */
3764
3781
  defaultWidth: number;
3765
3782
  /**
@@ -3805,19 +3822,19 @@ declare type ConstWindowOptions = {
3805
3822
  */
3806
3823
  processAffinity: string;
3807
3824
  /**
3808
- * @defaultValue false
3809
- *
3810
3825
  * Displays a shadow on frameless windows.
3811
3826
  * `shadow` and `cornerRounding` are mutually exclusive.
3812
3827
  * On Windows 7, Aero theme is required.
3828
+ *
3829
+ * @default false
3813
3830
  */
3814
3831
  shadow: boolean;
3815
3832
  /**
3816
- * @defaultValue true
3817
- *
3818
3833
  * Caches the location of the window.
3819
3834
  *
3820
3835
  * Note: this option is ignored in Platforms as it would cause inconsistent {@link Platform#applySnapshot applySnapshot} behavior.
3836
+ *
3837
+ * @default true
3821
3838
  */
3822
3839
  saveWindowState: boolean;
3823
3840
  /**
@@ -3826,22 +3843,22 @@ declare type ConstWindowOptions = {
3826
3843
  */
3827
3844
  ignoreSavedWindowState: boolean;
3828
3845
  /**
3829
- * @defaultValue false
3830
- *
3831
3846
  * Makes this window a frameless window that can be created and resized to less than 41x36 px (width x height).
3832
3847
  *
3833
3848
  * Note: Caveats of small windows are no Aero Snap and drag to/from maximize.
3834
3849
  * _Windows 10: Requires `maximizable` to be false. Resizing with the mouse is only possible down to 38x39 px._
3850
+ *
3851
+ * @default false
3835
3852
  */
3836
3853
  smallWindow: boolean;
3837
3854
  /**
3838
- * @defaultValue "normal"
3839
- *
3840
3855
  * The visible state of the window on creation.
3841
3856
  * One of:
3842
3857
  * * `"maximized"`
3843
3858
  * * `"minimized"`
3844
3859
  * * `"normal"`
3860
+ *
3861
+ * @default "normal"
3845
3862
  */
3846
3863
  state: WindowState;
3847
3864
  /**
@@ -3856,26 +3873,26 @@ declare type ConstWindowOptions = {
3856
3873
  */
3857
3874
  taskbarIconGroup: string;
3858
3875
  /**
3859
- * @defaultValue "about:blank"
3860
- *
3861
3876
  * The URL of the window
3877
+ *
3878
+ * @default "about:blank"
3862
3879
  */
3863
3880
  url: string;
3864
3881
  /**
3865
- * @defaultValue <application UUID>
3866
- *
3867
3882
  * The `uuid` of the application, unique within the set of all `Application`s running in OpenFin Runtime.
3868
3883
  * If omitted, defaults to the `uuid` of the application spawning the window.
3869
3884
  * If given, must match the `uuid` of the application spawning the window.
3870
3885
  * In other words, the application's `uuid` is the only acceptable value, but is the default, so there's
3871
3886
  * really no need to provide it.
3887
+ *
3888
+ * @default <application UUID>
3872
3889
  */
3873
3890
  uuid: string;
3874
3891
  /**
3875
- * @defaultValue false
3876
- *
3877
3892
  * When set to `true`, the window will not appear until the `window` object's `load` event fires.
3878
3893
  * When set to `false`, the window will appear immediately without waiting for content to be loaded.
3894
+ *
3895
+ * @default false
3879
3896
  */
3880
3897
  waitForPageLoad: boolean;
3881
3898
  width: number;
@@ -4157,13 +4174,13 @@ declare type CopyBlockedEventReason = 'disabled';
4157
4174
  */
4158
4175
  declare type CopyPermissions = {
4159
4176
  /**
4160
- * @defaultValue 'allowed'
4161
- *
4162
4177
  * Controls the behavior for copy operations for a matched URL.
4163
4178
  *
4164
4179
  * allow: Enables all copy operations.
4165
4180
  * block: Disables all copy operations.
4166
4181
  * protect: Protects any copied content. Only URLs that have set paste.behavior: 'all-content' will be allowed to paste this content.
4182
+ *
4183
+ * @default 'allowed'
4167
4184
  */
4168
4185
  behavior: 'allow' | 'block' | 'protect';
4169
4186
  /**
@@ -4171,9 +4188,9 @@ declare type CopyPermissions = {
4171
4188
  */
4172
4189
  options?: {
4173
4190
  /**
4174
- * @defaultValue ''
4175
- *
4176
4191
  * When setting behavior = 'protected' , this string will be pasted to other applications that do not have a matching URL instead of the original content.
4192
+ *
4193
+ * @default ''
4177
4194
  */
4178
4195
  replacementText: string;
4179
4196
  };
@@ -4187,15 +4204,15 @@ declare type CopyPermissions = {
4187
4204
  */
4188
4205
  declare type CornerRounding = {
4189
4206
  /**
4190
- * @defaultValue 0
4191
- *
4192
4207
  * The height in pixels.
4208
+ *
4209
+ * @default 0
4193
4210
  */
4194
4211
  height: number;
4195
4212
  /**
4196
- * @defaultValue 0
4197
- *
4198
4213
  * The width in pixels.
4214
+ *
4215
+ * @default 0
4199
4216
  */
4200
4217
  width: number;
4201
4218
  };
@@ -4285,8 +4302,6 @@ declare type CreateLayoutOptions = {
4285
4302
  layoutName: string;
4286
4303
  layout: LayoutOptions;
4287
4304
  /**
4288
- * @defaultValue 'default'
4289
- *
4290
4305
  * Controls the View behavior for the given `layout` property. Note
4291
4306
  * that the selected behavior only applies to unnamed Views or
4292
4307
  * Views with the prefix `internal-generated-`. In all cases, if any
@@ -4308,6 +4323,8 @@ declare type CreateLayoutOptions = {
4308
4323
  * override. Note that during applyLayoutSnapshot, Views are created and
4309
4324
  * attached to the Provider while the Window is being created, so it's
4310
4325
  * important to not 'duplicate' Views in this workflow.
4326
+ *
4327
+ * @default 'default'
4311
4328
  */
4312
4329
  multiInstanceViewBehavior?: MultiInstanceViewBehavior;
4313
4330
  };
@@ -4566,7 +4583,7 @@ declare type DomainApiSettings = {
4566
4583
  * * 'none': The `fin` API will be not available.
4567
4584
  * * 'global': The entire `fin` API will be available.
4568
4585
  *
4569
- * @defaultValue 'global'
4586
+ * @default 'global'
4570
4587
  */
4571
4588
  fin?: InjectionType;
4572
4589
  /**
@@ -5165,9 +5182,9 @@ declare type EventWithId<Event extends AppVersionEvent> = Event extends infer E
5165
5182
  */
5166
5183
  declare type ExcludeOptions = {
5167
5184
  /**
5168
- * @defaultValue false
5169
- *
5170
5185
  * When true, will not merge default preload scripts from {@link ApplicationOptions.defaultWindowOptions} or {@link ApplicationOptions.defaultViewOptions}.
5186
+ *
5187
+ * @default false
5171
5188
  */
5172
5189
  preloadScripts: boolean;
5173
5190
  };
@@ -5653,34 +5670,34 @@ declare interface FinApi<MeType extends OpenFin_2.EntityType> {
5653
5670
  */
5654
5671
  declare type FindInPageOptions = {
5655
5672
  /**
5656
- * @defaultValue true
5657
- *
5658
5673
  * Searches in the forward direction (backward otherwise)
5674
+ *
5675
+ * @default true
5659
5676
  */
5660
5677
  forward?: boolean;
5661
5678
  /**
5662
- * @defaultValue false
5663
- *
5664
5679
  * Begins a new text-finding session; should be true for first request only, and false on subsequent requests.
5680
+ *
5681
+ * @default false
5665
5682
  */
5666
5683
  findNext?: boolean;
5667
5684
  /**
5668
- * @defaultValue false
5669
- *
5670
5685
  * Enables case-sensitive searching.
5686
+ *
5687
+ * @default false
5671
5688
  */
5672
5689
  matchCase?: boolean;
5673
5690
  /**
5674
- * @defaultValue false
5675
- *
5676
5691
  * Only searches from the start of words.
5692
+ *
5693
+ * @default false
5677
5694
  */
5678
5695
  wordStart?: boolean;
5679
5696
  /**
5680
- * @defaultValue false
5681
- *
5682
5697
  * 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>
5683
5698
  * lowercase or non-letter. Accepts several other intra-word matches.
5699
+ *
5700
+ * @default false
5684
5701
  */
5685
5702
  medialCapitalAsWordStart?: boolean;
5686
5703
  };
@@ -6194,9 +6211,9 @@ declare type Hotkey = {
6194
6211
  */
6195
6212
  keys: string;
6196
6213
  /**
6197
- * @defaultValue false
6198
- *
6199
6214
  * Prevent default key handling before emitting the event.
6215
+ *
6216
+ * @default false
6200
6217
  */
6201
6218
  preventDefault?: boolean;
6202
6219
  };
@@ -8758,77 +8775,79 @@ declare type LayoutOptions = {
8758
8775
  */
8759
8776
  newTabButtonUrl?: string;
8760
8777
  /**
8761
- * @defaultValue false
8762
- *
8763
8778
  * When true the splitters will not be draggable and the layout will not resize.
8779
+ *
8780
+ * @default false
8764
8781
  */
8765
8782
  preventSplitterResize?: boolean;
8766
8783
  /**
8767
- * @defaultValue false
8768
- *
8769
8784
  * Whether the popout button will only act on the entire stack,
8770
8785
  * as opposed to only the active tab.
8786
+ *
8787
+ * @default false
8771
8788
  */
8772
8789
  popoutWholeStack?: boolean;
8773
8790
  /**
8774
- * @defaultValue false
8775
- *
8776
8791
  * Limits the area to which tabs can be dragged.
8777
8792
  * If true, the layout container is the only area where tabs can be dropped.
8793
+ *
8794
+ * @default false
8778
8795
  */
8779
8796
  constrainDragToContainer?: boolean;
8780
8797
  /**
8781
- * @defaultValue false
8782
- *
8783
8798
  * Whether to show the popout button on stack header.
8784
8799
  * The button will create a new window with current tab as its content.
8785
8800
  * In case `popoutWholeStack` is set to true, all tabs in the stack will be in the new window.
8801
+ *
8802
+ * @default false
8786
8803
  */
8787
8804
  showPopoutIcon?: boolean;
8788
8805
  /**
8789
- * @defaultValue false
8790
- *
8791
8806
  * Whether to show the maximize button on stack header.
8792
8807
  * The button will maximize the current tab to fill the entire window.
8808
+ *
8809
+ * @default false
8793
8810
  */
8794
8811
  showMaximiseIcon?: boolean;
8795
8812
  /**
8796
- * @defaultValue false
8797
- *
8798
8813
  * Whether to show the close button on stack header
8799
8814
  * (not to be confused with close button on every tab).
8815
+ *
8816
+ * @default false
8800
8817
  */
8801
8818
  showCloseIcon?: boolean;
8802
8819
  /**
8803
- * @defaultValue false
8804
- *
8805
8820
  * Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped.
8821
+ *
8822
+ * @default false
8806
8823
  */
8807
8824
  constrainDragToHeaders?: boolean;
8808
8825
  /**
8809
- * @defaultValue true
8810
- *
8811
8826
  * Turns tab headers on or off.
8812
8827
  * If false, the layout will be displayed with splitters only.
8828
+ *
8829
+ * @default true
8813
8830
  */
8814
8831
  hasHeaders?: boolean;
8815
8832
  /**
8816
- * @defaultValue true
8817
- *
8818
8833
  * If true, the user can re-arrange the layout by
8819
8834
  * dragging items by their tabs to the desired location.
8835
+ *
8836
+ * @default true
8820
8837
  */
8821
8838
  reorderEnabled?: boolean;
8822
8839
  /**
8823
- * @defaultValue false
8824
- *
8825
8840
  * If true, tabs can't be dragged out of the window.
8841
+ *
8842
+ * @default false
8826
8843
  */
8827
8844
  preventDragOut?: boolean;
8828
8845
  /**
8829
8846
  * @defaultValue=false
8830
8847
  *
8831
8848
  * If true, tabs can't be dragged into the window.
8849
+ *
8850
+ * @default false
8832
8851
  */
8833
8852
  preventDragIn?: boolean;
8834
8853
  };
@@ -9280,10 +9299,10 @@ declare type MutableViewOptions = {
9280
9299
  /**
9281
9300
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
9282
9301
  *
9283
- * @defaultValue true
9284
- *
9285
9302
  * Show the context menu when right-clicking on the view.
9286
9303
  * Gives access to the devtools for the view.
9304
+ *
9305
+ * @default true
9287
9306
  */
9288
9307
  contextMenu: boolean;
9289
9308
  /**
@@ -9330,24 +9349,25 @@ declare type MutableViewOptions = {
9330
9349
  contentNavigation: ContentNavigation;
9331
9350
  contentRedirect: ContentRedirect;
9332
9351
  /**
9333
- * @defaultValue false
9334
9352
  * @deprecated
9335
9353
  * **Platforms Only.** If true, will hide and detach the View from the window for later use instead of closing,
9336
9354
  * allowing the state of the View to be saved and the View to be immediately shown in a new Layout.
9355
+ *
9356
+ * @default false
9337
9357
  */
9338
9358
  detachOnClose: boolean;
9339
9359
  /**
9340
- * @defaultValue true
9341
- *
9342
9360
  * **Platforms Only.** If false, the view will be persistent and can't be closed through
9343
9361
  * either UI or `Platform.closeView`. Note that the view will still be closed if the host window is closed or
9344
9362
  * if the view isn't part of the new layout when running `Layout.replace`.
9363
+ *
9364
+ * @default true
9345
9365
  */
9346
9366
  isClosable: boolean;
9347
9367
  /**
9348
- * @defaultValue false
9349
- *
9350
9368
  * **Platforms Only.** If true, the tab of the view can't be dragged out of its host window.
9369
+ *
9370
+ * @default false
9351
9371
  */
9352
9372
  preventDragOut: boolean;
9353
9373
  interop?: InteropConfig;
@@ -9359,7 +9379,7 @@ declare type MutableViewOptions = {
9359
9379
  /**
9360
9380
  * {@inheritDoc ViewThrottling}
9361
9381
  *
9362
- * @defaultValue 'enabled'
9382
+ * @default 'enabled'
9363
9383
  */
9364
9384
  throttling: ViewThrottling;
9365
9385
  /**
@@ -9378,7 +9398,7 @@ declare type MutableWindowOptions = {
9378
9398
  * Turns anything of matching RGB value transparent.
9379
9399
  *
9380
9400
  * Caveats:
9381
- * * runtime key --disable-gpu is required. Note: Unclear behavior on remote Desktop support
9401
+ * * Runtime flags --disable-gpu and --allow-unsafe-compositing are required. Note: Unclear behavior on remote Desktop support
9382
9402
  * * User cannot click-through transparent regions
9383
9403
  * * Not supported on Mac
9384
9404
  * * Windows Aero must be enabled
@@ -9387,25 +9407,25 @@ declare type MutableWindowOptions = {
9387
9407
  */
9388
9408
  alphaMask: RGB;
9389
9409
  /**
9390
- * @defaultValue false
9391
- *
9392
9410
  * Always position the window at the top of the window stack.
9411
+ *
9412
+ * @default false
9393
9413
  */
9394
9414
  alwaysOnTop: boolean;
9395
9415
  /**
9396
- * @defaultValue 0
9397
- *
9398
9416
  * The aspect ratio of width to height to enforce for the window. If this value is equal to or less than zero,
9399
9417
  * an aspect ratio will not be enforced.
9418
+ *
9419
+ * @default 0
9400
9420
  */
9401
9421
  aspectRatio: number;
9402
9422
  /**
9403
9423
  * @deprecated Superseded by {@link contextMenuOptions}, which offers a larger feature-set and cleaner syntax.
9404
9424
  *
9405
- * @defaultValue true
9406
- *
9407
9425
  * Show the context menu when right-clicking on the window.
9408
9426
  * Gives access to the devtools for the window.
9427
+ *
9428
+ * @default true
9409
9429
  */
9410
9430
  contextMenu: boolean;
9411
9431
  /**
@@ -9472,15 +9492,18 @@ declare type MutableWindowOptions = {
9472
9492
  */
9473
9493
  customData: any;
9474
9494
  /**
9495
+ * @deprecated Will be removed in runtime version 45
9475
9496
  * @defaultValue true
9476
9497
  *
9477
9498
  * Show the window's frame.
9499
+ *
9500
+ * @default true
9478
9501
  */
9479
9502
  frame: boolean;
9480
9503
  /**
9481
- * @defaultValue false
9482
- *
9483
9504
  * Hides the window instead of closing it when the close button is pressed.
9505
+ *
9506
+ * @default false
9484
9507
  */
9485
9508
  hideOnClose: boolean;
9486
9509
  /**
@@ -9533,60 +9556,61 @@ declare type MutableWindowOptions = {
9533
9556
  */
9534
9557
  icon: string;
9535
9558
  /**
9536
- * @defaultValue true
9537
- *
9538
9559
  * Include window in snapshots returned by Platform.getSnapshot(). Turning this off may be desirable when dealing with
9539
9560
  * inherently temporary windows whose state shouldn't be preserved, such as modals, menus, or popups.
9561
+ *
9562
+ * @default true
9540
9563
  */
9541
9564
  includeInSnapshots: boolean;
9542
9565
  /**
9543
- * @defaultValue -1
9544
- *
9545
9566
  * The maximum height of a window. Will default to the OS defined value if set to -1.
9567
+ *
9568
+ * @default -1
9546
9569
  */
9547
9570
  maxHeight: number;
9548
9571
  /**
9549
- * @defaultValue true
9550
- *
9551
9572
  * Allows the window to be maximized.
9573
+ *
9574
+ * @default true
9552
9575
  */
9553
9576
  maximizable: boolean;
9554
9577
  /**
9555
- * @defaultValue -1
9556
- *
9557
9578
  * The maximum width of a window. Will default to the OS defined value if set to -1.
9579
+ *
9580
+ * @default -1
9558
9581
  */
9559
9582
  maxWidth: number;
9560
9583
  /**
9561
- * @defaultValue 0
9562
- *
9563
9584
  * The minimum height of the window.
9585
+ *
9586
+ * @default 0
9564
9587
  */
9565
9588
  minHeight: number;
9566
9589
  /**
9567
- * @defaultValue true
9568
- *
9569
9590
  * Allows the window to be minimized.
9591
+ *
9592
+ * @default true
9570
9593
  */
9571
9594
  minimizable: boolean;
9572
9595
  /**
9573
- * @defaultValue true
9574
- *
9575
9596
  * The minimum width of the window.
9597
+ *
9598
+ * @default true
9576
9599
  */
9577
9600
  minWidth: number;
9578
9601
  /**
9579
- * @defaultValue 1
9580
- *
9581
9602
  * A flag that specifies how transparent the window will be.
9582
9603
  * Changing opacity doesn't work on Windows 7 without Aero so setting this value will have no effect there.
9583
9604
  * This value is clamped between `0.0` and `1.0`.
9605
+ * In software composition mode, the runtime flag --allow-unsafe-compositing is required.
9606
+ *
9607
+ * @default 1
9584
9608
  */
9585
9609
  opacity: number;
9586
9610
  /**
9587
- * @defaultValue true
9588
- *
9589
9611
  * A flag to allow the user to resize the window.
9612
+ *
9613
+ * @default true
9590
9614
  */
9591
9615
  resizable: boolean;
9592
9616
  /**
@@ -9594,16 +9618,16 @@ declare type MutableWindowOptions = {
9594
9618
  */
9595
9619
  resizeRegion: ResizeRegion;
9596
9620
  /**
9597
- * @defaultValue false
9598
- *
9599
9621
  * **Platforms Only.** If true, will show background images in the layout when the Views are hidden.
9600
9622
  * This occurs when the window is resizing or a tab is being dragged within the layout.
9623
+ *
9624
+ * @default false
9601
9625
  */
9602
9626
  showBackgroundImages: boolean;
9603
9627
  /**
9604
- * @defaultValue true
9605
- *
9606
9628
  * Shows the window's icon in the taskbar.
9629
+ *
9630
+ * @default true
9607
9631
  */
9608
9632
  showTaskbarIcon: boolean;
9609
9633
  /**
@@ -9630,7 +9654,7 @@ declare type MutableWindowOptions = {
9630
9654
  /**
9631
9655
  * {@inheritDoc WindowThrottling}
9632
9656
  *
9633
- * @defaultValue 'enabled'
9657
+ * @default 'enabled'
9634
9658
  *
9635
9659
  * @remarks If `throttling` option is present, the `backgroundThrottling` option is completely ignored for windows.
9636
9660
  */
@@ -10252,12 +10276,12 @@ declare type PasteBlockedEventReason = 'invalid-data' | 'disabled';
10252
10276
  */
10253
10277
  declare type PastePermissions = {
10254
10278
  /**
10255
- * @defaultValue 'non-protected-content'
10256
- *
10257
10279
  * Controls the behavior for paste operations for a matched URL.
10258
10280
  *
10259
10281
  * non-protected-content: All matching URLs will be able to paste content copied from non-protected URLs.
10260
10282
  * 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.
10283
+ *
10284
+ * @default 'non-protected-content'
10261
10285
  */
10262
10286
  behavior: 'non-protected-content' | 'all-content';
10263
10287
  };
@@ -11326,11 +11350,11 @@ declare type PlatformOptions = ApplicationCreationOptions & {
11326
11350
  */
11327
11351
  providerUrl?: string;
11328
11352
  /**
11329
- * @defaultValue true
11330
- *
11331
11353
  * Controls whether it is allowed to launch content manifests into the Platform. If omitted, defaults to `true`.
11332
11354
  *
11333
11355
  * NOTE: Starting in v38, the default value will change to `false` and content launching must be explicitly opted into.
11356
+ *
11357
+ * @default true
11334
11358
  */
11335
11359
  allowLaunchIntoPlatform?: boolean;
11336
11360
  };
@@ -12019,22 +12043,22 @@ declare type PopupOptions = {
12019
12043
  url?: string;
12020
12044
  /**
12021
12045
  * Height of the popup window in pixels (takes priority over `intialOptions` size properties).
12022
- * @defaultValue 300
12046
+ * @default 300
12023
12047
  */
12024
12048
  height?: number;
12025
12049
  /**
12026
12050
  * Width of the popup window in pixels (takes priority over `intialOptions` size properties).
12027
- * @defaultValue 300
12051
+ * @default 300
12028
12052
  */
12029
12053
  width?: number;
12030
12054
  /**
12031
12055
  * Left position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
12032
- * @defaultValue 0
12056
+ * @default 0
12033
12057
  */
12034
12058
  x?: number;
12035
12059
  /**
12036
12060
  * Top position in pixels where the popup window will be shown (relative to the window calling `showPopupWindow`).
12037
- * @defaultValue 0
12061
+ * @default 0
12038
12062
  */
12039
12063
  y?: number;
12040
12064
  /**
@@ -12042,7 +12066,7 @@ declare type PopupOptions = {
12042
12066
  * * 'modal' restricts resizing and positioning in the caller.
12043
12067
  * * 'hide' hides the popup window on blur.
12044
12068
  * * 'close' closes the popup window on blur.
12045
- * @defaultValue 'close'
12069
+ * @default 'close'
12046
12070
  */
12047
12071
  blurBehavior?: PopupBlurBehavior;
12048
12072
  /**
@@ -12050,19 +12074,19 @@ declare type PopupOptions = {
12050
12074
  * * 'none' will do nothing.
12051
12075
  * * 'hide' hides the popup window on `dispatchPopupResult`.
12052
12076
  * * 'close' closes the popup window on `dispatchPopupResult`.
12053
- * @defaultValue 'close'
12077
+ * @default 'close'
12054
12078
  */
12055
12079
  resultDispatchBehavior?: PopupResultBehavior;
12056
12080
  /**
12057
12081
  * Hide the popup window instead of closing when `close` is called on it.
12058
12082
  *
12059
12083
  * Note: if this is `true` and `blurBehavior` and/or `resultDispatchBehavior` are set to `close`, the window will be hidden.
12060
- * @defaultValue false
12084
+ * @default false
12061
12085
  */
12062
12086
  hideOnClose?: boolean;
12063
12087
  /**
12064
12088
  * Determines if the popup window should or should not be focused when it is shown.
12065
- * @defaultValue true
12089
+ * @default true
12066
12090
  */
12067
12091
  focus?: boolean;
12068
12092
  /**
@@ -12156,9 +12180,9 @@ declare type PrebuiltContextMenuItem = 'separator' | 'undo' | 'redo' | 'cut' | '
12156
12180
  */
12157
12181
  declare type PreloadScript = {
12158
12182
  /**
12159
- * @defaultValue false
12160
- *
12161
12183
  * Fail to load the window if this preload script fails
12184
+ *
12185
+ * @default false
12162
12186
  */
12163
12187
  mandatory?: boolean;
12164
12188
  /**
@@ -12254,15 +12278,15 @@ declare type PrinterInfo = {
12254
12278
  declare type PrintOptions = {
12255
12279
  content?: 'self';
12256
12280
  /**
12257
- * @defaultValue false
12258
- *
12259
12281
  * Disables prompting the user for print settings.
12282
+ *
12283
+ * @default false
12260
12284
  */
12261
12285
  silent?: boolean;
12262
12286
  /**
12263
- * @defaultValue false
12264
- *
12265
12287
  * Includes the webpage background color and image when printing.
12288
+ *
12289
+ * @default false
12266
12290
  */
12267
12291
  printBackground?: boolean;
12268
12292
  /**
@@ -12270,9 +12294,9 @@ declare type PrintOptions = {
12270
12294
  */
12271
12295
  deviceName?: string;
12272
12296
  /**
12273
- * @defaultValue true
12274
- *
12275
12297
  * Prints in full color (greyscale otherwise).
12298
+ *
12299
+ * @default true
12276
12300
  */
12277
12301
  color?: boolean;
12278
12302
  /**
@@ -12280,9 +12304,9 @@ declare type PrintOptions = {
12280
12304
  */
12281
12305
  margins?: Margins;
12282
12306
  /**
12283
- * @defaultValue true
12284
- *
12285
12307
  * Prints in landscape mode (portrait otherwise).
12308
+ *
12309
+ * @default true
12286
12310
  */
12287
12311
  landscape?: boolean;
12288
12312
  /**
@@ -13463,15 +13487,15 @@ declare type ReplaceViewPayload = {
13463
13487
  */
13464
13488
  declare type ResizeRegion = {
13465
13489
  /**
13466
- * @defaultValue 7
13467
- *
13468
13490
  * The size of the resize region in pixels.
13491
+ *
13492
+ * @default 7
13469
13493
  */
13470
13494
  size?: number;
13471
13495
  /**
13472
- * @defaultValue 9
13473
- *
13474
13496
  * The size in pixels of an additional square resizable region located at the bottom right corner of a frameless window.
13497
+ *
13498
+ * @default 9
13475
13499
  */
13476
13500
  bottomRightCorner?: number;
13477
13501
  /**
@@ -13479,27 +13503,27 @@ declare type ResizeRegion = {
13479
13503
  */
13480
13504
  sides?: {
13481
13505
  /**
13482
- * @defaultValue true
13483
- *
13484
13506
  * Enables resizing from the top of the window.
13507
+ *
13508
+ * @default true
13485
13509
  */
13486
13510
  top?: boolean;
13487
13511
  /**
13488
- * @defaultValue true
13489
- *
13490
13512
  * Enables resizing from the bottom of the window.
13513
+ *
13514
+ * @default true
13491
13515
  */
13492
13516
  bottom?: boolean;
13493
13517
  /**
13494
- * @defaultValue true
13495
- *
13496
13518
  * Enables resizing from the left side of the window.
13519
+ *
13520
+ * @default true
13497
13521
  */
13498
13522
  left?: boolean;
13499
13523
  /**
13500
- * @defaultValue true
13501
- *
13502
13524
  * Enables resizing from the right side of the window.
13525
+ *
13526
+ * @default true
13503
13527
  */
13504
13528
  right?: boolean;
13505
13529
  };
@@ -14051,9 +14075,9 @@ declare type ShowTrayIconPopupMenuOptions<Data extends unknown = unknown> = {
14051
14075
  */
14052
14076
  declare type ShowViewOnWindowResizeOptions = ViewVisibilityOption & {
14053
14077
  /**
14054
- * @defaultValue 0
14055
- *
14056
14078
  * Number of milliseconds to wait between view repaints.
14079
+ *
14080
+ * @default 0
14057
14081
  */
14058
14082
  paintIntervalMs?: number;
14059
14083
  };
@@ -16110,9 +16134,9 @@ declare type TransitionBase = {
16110
16134
  */
16111
16135
  duration: number;
16112
16136
  /**
16113
- * @defaultValue false
16114
- *
16115
16137
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
16138
+ *
16139
+ * @default false
16116
16140
  */
16117
16141
  relative?: boolean;
16118
16142
  };
@@ -16128,9 +16152,9 @@ declare type TransitionOptions = {
16128
16152
  */
16129
16153
  interrupt: boolean;
16130
16154
  /**
16131
- * @defaultValue false
16132
- *
16133
16155
  * Treats 'opacity' as absolute or as a delta. Defaults to false.
16156
+ *
16157
+ * @default false
16134
16158
  */
16135
16159
  relative?: boolean;
16136
16160
  tween?: tween;
@@ -17095,9 +17119,9 @@ declare type ViewTitlePriority = 'document' | 'options';
17095
17119
  */
17096
17120
  declare type ViewVisibilityOption = {
17097
17121
  /**
17098
- * @defaultValue false
17099
- *
17100
17122
  * Enables or disables showing views when the layout splitter or a tab is being dragged or a Platform Window is being resized.
17123
+ *
17124
+ * @default false
17101
17125
  */
17102
17126
  enabled?: boolean;
17103
17127
  };