@arcgis/lumina 5.0.0-next.8 → 5.0.0-next.81

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.
Files changed (51) hide show
  1. package/dist/{Controller-ftAEcdmI.js → Controller-DDyB41GY.js} +1 -1
  2. package/dist/{ControllerInternals-CWQrfEA8.js → ControllerInternals-By6dhpY-.js} +2 -2
  3. package/dist/ControllerManager-LzfJtMG7.js +185 -0
  4. package/dist/LitElement.d.ts +6 -6
  5. package/dist/context.js +1 -1
  6. package/dist/controllers/Controller.d.ts +3 -3
  7. package/dist/controllers/ControllerInternals.d.ts +5 -5
  8. package/dist/controllers/ControllerManager.d.ts +4 -6
  9. package/dist/controllers/accessor/index.d.ts +4 -4
  10. package/dist/controllers/accessor/index.js +3 -3
  11. package/dist/controllers/accessor/reEmitEvent.d.ts +1 -1
  12. package/dist/controllers/accessor/store.d.ts +1 -1
  13. package/dist/controllers/accessor/useAccessor.d.ts +3 -3
  14. package/dist/controllers/functional.d.ts +2 -2
  15. package/dist/controllers/index.d.ts +29 -20
  16. package/dist/controllers/index.js +18 -9
  17. package/dist/controllers/load.d.ts +1 -1
  18. package/dist/controllers/proxyExports.d.ts +2 -2
  19. package/dist/controllers/trackKey.d.ts +2 -2
  20. package/dist/controllers/trackPropKey.d.ts +1 -1
  21. package/dist/controllers/trackPropertyKey.d.ts +2 -2
  22. package/dist/controllers/types.d.ts +1 -1
  23. package/dist/controllers/useDirection.d.ts +1 -1
  24. package/dist/controllers/useMedia.d.ts +1 -1
  25. package/dist/controllers/usePropertyChange.d.ts +3 -3
  26. package/dist/controllers/useT9n.d.ts +1 -1
  27. package/dist/controllers/useWatchAttributes.d.ts +2 -2
  28. package/dist/controllers/utils.d.ts +2 -2
  29. package/dist/createEvent.d.ts +1 -1
  30. package/dist/decorators.d.ts +1 -1
  31. package/dist/devOnlyDetectIncorrectLazyUsages.d.ts +1 -1
  32. package/dist/hmrSupport.js +1 -1
  33. package/dist/index.d.ts +16 -16
  34. package/dist/index.js +9 -179
  35. package/dist/jsx/baseTypes.d.ts +4 -4
  36. package/dist/jsx/directives.d.ts +3 -3
  37. package/dist/jsx/generatedTypes.d.ts +817 -539
  38. package/dist/jsx/types.d.ts +2 -2
  39. package/dist/{lazyLoad-BlK67lvm.js → lazyLoad-DjHR4rq8.js} +10 -4
  40. package/dist/lazyLoad.d.ts +3 -3
  41. package/dist/lifecycleSupport.d.ts +1 -1
  42. package/dist/makeRuntime.d.ts +2 -2
  43. package/dist/{proxyExports-D906TEtL.js → proxyExports-BH_3cSmm.js} +2 -2
  44. package/dist/render.d.ts +1 -1
  45. package/dist/tests/wrappersUtils.typeTest.d.ts +1 -0
  46. package/dist/typings/jsxGlobals.d.ts +1 -1
  47. package/dist/utils.d.ts +14 -9
  48. package/package.json +4 -3
  49. package/dist/controllers/tests/autoDestroyMock.d.ts +0 -5
  50. package/dist/controllers/tests/utils.d.ts +0 -1
  51. package/dist/runtime.d.ts +0 -6
@@ -1,8 +1,8 @@
1
1
  import { DirectiveResult } from 'lit/directive.js';
2
2
  import { ClassInfo, ClassMapDirective } from 'lit/directives/class-map.js';
3
3
  import { StyleMapDirective } from 'lit/directives/style-map.js';
4
- import { ChangeEventHandlerUnion, CustomAttributes, EventHandlerUnion, FocusEventHandlerUnion, InputEventHandlerUnion } from './baseTypes';
5
- import { JsxNode } from './types';
4
+ import { ChangeEventHandlerUnion, CustomAttributes, EventHandlerUnion, FocusEventHandlerUnion, InputEventHandlerUnion } from './baseTypes.ts';
5
+ import { JsxNode } from './types.ts';
6
6
  import { Properties as CssProperties } from 'csstype';
7
7
  /**
8
8
  * Some attributes accepts numbers as a number or as a string, while also
@@ -26,20 +26,23 @@ type HtmlLinkAs = "audio" | "document" | "embed" | "fetch" | "font" | "image" |
26
26
  export interface DOMAttributes<T = HTMLElement> extends CustomAttributes<T>, GlobalEventHandlersCamelCase<T> {
27
27
  children?: JsxNode;
28
28
  class?: ClassInfo | DirectiveResult<typeof ClassMapDirective> | string;
29
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/innerHTML) */
29
+ /**
30
+ * The **`innerHTML`** property of the Element interface gets or sets the HTML or XML markup contained within the element.
31
+ *
32
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/innerHTML)
33
+ */
30
34
  innerHTML?: string;
31
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/innerText) */
35
+ /**
36
+ * The **`innerText`** property of the HTMLElement interface represents the rendered text content of a node and its descendants.
37
+ *
38
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/innerText)
39
+ */
32
40
  innerText?: number | string;
33
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */
41
+ /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */
34
42
  textContent?: number | string;
35
43
  }
36
44
  export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
37
- /**
38
- * Fires when the user aborts the download.
39
- * @param ev The event.
40
- *
41
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/abort_event)
42
- */
45
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/abort_event) */
43
46
  onAbort?: EventHandlerUnion<T, UIEvent>;
44
47
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/animationcancel_event) */
45
48
  onAnimationCancel?: EventHandlerUnion<T, AnimationEvent>;
@@ -53,39 +56,21 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
53
56
  onAuxClick?: EventHandlerUnion<T, MouseEvent>;
54
57
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/beforeinput_event) */
55
58
  onBeforeInput?: InputEventHandlerUnion<T, InputEvent>;
59
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/beforematch_event) */
60
+ onBeforeMatch?: EventHandlerUnion<T, Event>;
56
61
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/beforetoggle_event) */
57
62
  onBeforeToggle?: EventHandlerUnion<T, Event>;
58
- /**
59
- * Fires when the object loses the input focus.
60
- * @param ev The focus event.
61
- *
62
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/blur_event)
63
- */
63
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/blur_event) */
64
64
  onBlur?: FocusEventHandlerUnion<T, FocusEvent>;
65
65
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/cancel_event) */
66
66
  onCancel?: EventHandlerUnion<T, Event>;
67
- /**
68
- * Occurs when playback is possible, but would require further buffering.
69
- * @param ev The event.
70
- *
71
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/canplay_event)
72
- */
67
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/canplay_event) */
73
68
  onCanPlay?: EventHandlerUnion<T, Event>;
74
69
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/canplaythrough_event) */
75
70
  onCanPlayThrough?: EventHandlerUnion<T, Event>;
76
- /**
77
- * Fires when the contents of the object or selection have changed.
78
- * @param ev The event.
79
- *
80
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/change_event)
81
- */
71
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/change_event) */
82
72
  onChange?: ChangeEventHandlerUnion<T, Event>;
83
- /**
84
- * Fires when the user clicks the left mouse button on the object
85
- * @param ev The mouse event.
86
- *
87
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/click_event)
88
- */
73
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/click_event) */
89
74
  onClick?: EventHandlerUnion<T, PointerEvent>;
90
75
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/close_event) */
91
76
  onClose?: EventHandlerUnion<T, Event>;
@@ -97,12 +82,7 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
97
82
  onCompositionUpdate?: EventHandlerUnion<T, CompositionEvent>;
98
83
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement/contextlost_event) */
99
84
  onContextLost?: EventHandlerUnion<T, Event>;
100
- /**
101
- * Fires when the user clicks the right mouse button in the client area, opening the context menu.
102
- * @param ev The mouse event.
103
- *
104
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/contextmenu_event)
105
- */
85
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/contextmenu_event) */
106
86
  onContextMenu?: EventHandlerUnion<T, MouseEvent>;
107
87
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement/contextrestored_event) */
108
88
  onContextRestored?: EventHandlerUnion<T, Event>;
@@ -112,91 +92,31 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
112
92
  onCueChange?: EventHandlerUnion<T, Event>;
113
93
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/cut_event) */
114
94
  onCut?: EventHandlerUnion<T, ClipboardEvent>;
115
- /**
116
- * Fires when the user double-clicks the object.
117
- * @param ev The mouse event.
118
- *
119
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/dblclick_event)
120
- */
95
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/dblclick_event) */
121
96
  onDblClick?: EventHandlerUnion<T, MouseEvent>;
122
- /**
123
- * Fires on the source object continuously during a drag operation.
124
- * @param ev The event.
125
- *
126
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/drag_event)
127
- */
97
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/drag_event) */
128
98
  onDrag?: EventHandlerUnion<T, DragEvent>;
129
- /**
130
- * Fires on the source object when the user releases the mouse at the close of a drag operation.
131
- * @param ev The event.
132
- *
133
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragend_event)
134
- */
99
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragend_event) */
135
100
  onDragEnd?: EventHandlerUnion<T, DragEvent>;
136
- /**
137
- * Fires on the target element when the user drags the object to a valid drop target.
138
- * @param ev The drag event.
139
- *
140
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragenter_event)
141
- */
101
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragenter_event) */
142
102
  onDragEnter?: EventHandlerUnion<T, DragEvent>;
143
- /**
144
- * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.
145
- * @param ev The drag event.
146
- *
147
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragleave_event)
148
- */
103
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragleave_event) */
149
104
  onDragLeave?: EventHandlerUnion<T, DragEvent>;
150
- /**
151
- * Fires on the target element continuously while the user drags the object over a valid drop target.
152
- * @param ev The event.
153
- *
154
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragover_event)
155
- */
105
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragover_event) */
156
106
  onDragOver?: EventHandlerUnion<T, DragEvent>;
157
- /**
158
- * Fires on the source object when the user starts to drag a text selection or selected object.
159
- * @param ev The event.
160
- *
161
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragstart_event)
162
- */
107
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dragstart_event) */
163
108
  onDragStart?: EventHandlerUnion<T, DragEvent>;
164
109
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/drop_event) */
165
110
  onDrop?: EventHandlerUnion<T, DragEvent>;
166
- /**
167
- * Occurs when the duration attribute is updated.
168
- * @param ev The event.
169
- *
170
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/durationchange_event)
171
- */
111
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/durationchange_event) */
172
112
  onDurationChange?: EventHandlerUnion<T, Event>;
173
- /**
174
- * Occurs when the media element is reset to its initial state.
175
- * @param ev The event.
176
- *
177
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/emptied_event)
178
- */
113
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/emptied_event) */
179
114
  onEmptied?: EventHandlerUnion<T, Event>;
180
- /**
181
- * Occurs when the end of playback is reached.
182
- * @param ev The event
183
- *
184
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/ended_event)
185
- */
115
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/ended_event) */
186
116
  onEnded?: EventHandlerUnion<T, Event>;
187
- /**
188
- * Fires when an error occurs during object loading.
189
- * @param ev The event.
190
- *
191
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/error_event)
192
- */
117
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/error_event) */
193
118
  onError?: EventHandlerUnion<T, Event>;
194
- /**
195
- * Fires when the object receives focus.
196
- * @param ev The event.
197
- *
198
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/focus_event)
199
- */
119
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/focus_event) */
200
120
  onFocus?: FocusEventHandlerUnion<T, FocusEvent>;
201
121
  /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Element/focusin_event) */
202
122
  onFocusIn?: FocusEventHandlerUnion<T, FocusEvent>;
@@ -214,111 +134,41 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
214
134
  onInput?: InputEventHandlerUnion<T, InputEvent>;
215
135
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/invalid_event) */
216
136
  onInvalid?: EventHandlerUnion<T, Event>;
217
- /**
218
- * Fires when the user presses a key.
219
- * @param ev The keyboard event
220
- *
221
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/keydown_event)
222
- */
137
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/keydown_event) */
223
138
  onKeyDown?: EventHandlerUnion<T, KeyboardEvent>;
224
- /**
225
- * Fires when the user releases a key.
226
- * @param ev The keyboard event
227
- *
228
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/keyup_event)
229
- */
139
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/keyup_event) */
230
140
  onKeyUp?: EventHandlerUnion<T, KeyboardEvent>;
231
- /**
232
- * Fires immediately after the browser loads the object.
233
- * @param ev The event.
234
- *
235
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGElement/load_event)
236
- */
141
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/load_event) */
237
142
  onLoad?: EventHandlerUnion<T, Event>;
238
- /**
239
- * Occurs when media data is loaded at the current playback position.
240
- * @param ev The event.
241
- *
242
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadeddata_event)
243
- */
143
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadeddata_event) */
244
144
  onLoadedData?: EventHandlerUnion<T, Event>;
245
- /**
246
- * Occurs when the duration and dimensions of the media have been determined.
247
- * @param ev The event.
248
- *
249
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadedmetadata_event)
250
- */
145
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadedmetadata_event) */
251
146
  onLoadedMetadata?: EventHandlerUnion<T, Event>;
252
- /**
253
- * Occurs when Internet Explorer begins looking for media data.
254
- * @param ev The event.
255
- *
256
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadstart_event)
257
- */
147
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loadstart_event) */
258
148
  onLoadStart?: EventHandlerUnion<T, Event>;
259
149
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/lostpointercapture_event) */
260
150
  onLostPointerCapture?: EventHandlerUnion<T, PointerEvent>;
261
- /**
262
- * Fires when the user clicks the object with either mouse button.
263
- * @param ev The mouse event.
264
- *
265
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mousedown_event)
266
- */
151
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mousedown_event) */
267
152
  onMouseDown?: EventHandlerUnion<T, MouseEvent>;
268
153
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseenter_event) */
269
154
  onMouseEnter?: EventHandlerUnion<T, MouseEvent>;
270
155
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseleave_event) */
271
156
  onMouseLeave?: EventHandlerUnion<T, MouseEvent>;
272
- /**
273
- * Fires when the user moves the mouse over the object.
274
- * @param ev The mouse event.
275
- *
276
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mousemove_event)
277
- */
157
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mousemove_event) */
278
158
  onMouseMove?: EventHandlerUnion<T, MouseEvent>;
279
- /**
280
- * Fires when the user moves the mouse pointer outside the boundaries of the object.
281
- * @param ev The mouse event.
282
- *
283
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseout_event)
284
- */
159
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseout_event) */
285
160
  onMouseOut?: EventHandlerUnion<T, MouseEvent>;
286
- /**
287
- * Fires when the user moves the mouse pointer into the object.
288
- * @param ev The mouse event.
289
- *
290
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseover_event)
291
- */
161
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseover_event) */
292
162
  onMouseOver?: EventHandlerUnion<T, MouseEvent>;
293
- /**
294
- * Fires when the user releases a mouse button while the mouse is over the object.
295
- * @param ev The mouse event.
296
- *
297
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseup_event)
298
- */
163
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/mouseup_event) */
299
164
  onMouseUp?: EventHandlerUnion<T, MouseEvent>;
300
165
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/paste_event) */
301
166
  onPaste?: EventHandlerUnion<T, ClipboardEvent>;
302
- /**
303
- * Occurs when playback is paused.
304
- * @param ev The event.
305
- *
306
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/pause_event)
307
- */
167
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/pause_event) */
308
168
  onPause?: EventHandlerUnion<T, Event>;
309
- /**
310
- * Occurs when the play method is requested.
311
- * @param ev The event.
312
- *
313
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/play_event)
314
- */
169
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/play_event) */
315
170
  onPlay?: EventHandlerUnion<T, Event>;
316
- /**
317
- * Occurs when the audio or video has started playing.
318
- * @param ev The event.
319
- *
320
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/playing_event)
321
- */
171
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/playing_event) */
322
172
  onPlaying?: EventHandlerUnion<T, Event>;
323
173
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/pointercancel_event) */
324
174
  onPointerCancel?: EventHandlerUnion<T, PointerEvent>;
@@ -334,62 +184,33 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
334
184
  onPointerOut?: EventHandlerUnion<T, PointerEvent>;
335
185
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/pointerover_event) */
336
186
  onPointerOver?: EventHandlerUnion<T, PointerEvent>;
337
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/pointerup_event) */
338
- onPointerUp?: EventHandlerUnion<T, PointerEvent>;
339
187
  /**
340
- * Occurs to indicate progress while downloading media data.
341
- * @param ev The event.
188
+ * Available only in secure contexts.
342
189
  *
343
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/progress_event)
190
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/pointerrawupdate_event)
344
191
  */
192
+ onPointerRawUpdate?: EventHandlerUnion<T, Event>;
193
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/pointerup_event) */
194
+ onPointerUp?: EventHandlerUnion<T, PointerEvent>;
195
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/progress_event) */
345
196
  onProgress?: EventHandlerUnion<T, Event>;
346
- /**
347
- * Occurs when the playback rate is increased or decreased.
348
- * @param ev The event.
349
- *
350
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/ratechange_event)
351
- */
197
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/ratechange_event) */
352
198
  onRateChange?: EventHandlerUnion<T, Event>;
353
- /**
354
- * Fires when the user resets a form.
355
- * @param ev The event.
356
- *
357
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/reset_event)
358
- */
199
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/reset_event) */
359
200
  onReset?: EventHandlerUnion<T, Event>;
360
201
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/resize_event) */
361
202
  onResize?: EventHandlerUnion<T, UIEvent>;
362
- /**
363
- * Fires when the user repositions the scroll box in the scroll bar on the object.
364
- * @param ev The event.
365
- *
366
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/scroll_event)
367
- */
203
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/scroll_event) */
368
204
  onScroll?: EventHandlerUnion<T, Event>;
369
205
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/scrollend_event) */
370
206
  onScrollEnd?: EventHandlerUnion<T, Event>;
371
207
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/securitypolicyviolation_event) */
372
208
  onSecurityPolicyViolation?: EventHandlerUnion<T, SecurityPolicyViolationEvent>;
373
- /**
374
- * Occurs when the seek operation ends.
375
- * @param ev The event.
376
- *
377
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/seeked_event)
378
- */
209
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/seeked_event) */
379
210
  onSeeked?: EventHandlerUnion<T, Event>;
380
- /**
381
- * Occurs when the current playback position is moved.
382
- * @param ev The event.
383
- *
384
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/seeking_event)
385
- */
211
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/seeking_event) */
386
212
  onSeeking?: EventHandlerUnion<T, Event>;
387
- /**
388
- * Fires when the current selection changes.
389
- * @param ev The event.
390
- *
391
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/select_event)
392
- */
213
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/select_event) */
393
214
  onSelect?: EventHandlerUnion<T, UIEvent>;
394
215
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/selectionchange_event) */
395
216
  onSelectionChange?: EventHandlerUnion<T, Event>;
@@ -397,28 +218,13 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
397
218
  onSelectStart?: EventHandlerUnion<T, Event>;
398
219
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSlotElement/slotchange_event) */
399
220
  onSlotChange?: EventHandlerUnion<T, Event>;
400
- /**
401
- * Occurs when the download has stopped.
402
- * @param ev The event.
403
- *
404
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/stalled_event)
405
- */
221
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/stalled_event) */
406
222
  onStalled?: EventHandlerUnion<T, Event>;
407
223
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/submit_event) */
408
224
  onSubmit?: EventHandlerUnion<T, SubmitEvent>;
409
- /**
410
- * Occurs if the load operation has been intentionally halted.
411
- * @param ev The event.
412
- *
413
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/suspend_event)
414
- */
225
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/suspend_event) */
415
226
  onSuspend?: EventHandlerUnion<T, Event>;
416
- /**
417
- * Occurs to indicate the current playback position.
418
- * @param ev The event.
419
- *
420
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/timeupdate_event)
421
- */
227
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/timeupdate_event) */
422
228
  onTimeUpdate?: EventHandlerUnion<T, Event>;
423
229
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/toggle_event) */
424
230
  onToggle?: EventHandlerUnion<T, Event>;
@@ -438,19 +244,9 @@ export interface GlobalEventHandlersCamelCase<T = HTMLElement> {
438
244
  onTransitionRun?: EventHandlerUnion<T, TransitionEvent>;
439
245
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/transitionstart_event) */
440
246
  onTransitionStart?: EventHandlerUnion<T, TransitionEvent>;
441
- /**
442
- * Occurs when the volume is changed, or playback is muted or unmuted.
443
- * @param ev The event.
444
- *
445
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/volumechange_event)
446
- */
247
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/volumechange_event) */
447
248
  onVolumeChange?: EventHandlerUnion<T, Event>;
448
- /**
449
- * Occurs when playback stops because the next frame of a video resource is not available.
450
- * @param ev The event.
451
- *
452
- * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/waiting_event)
453
- */
249
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/waiting_event) */
454
250
  onWaiting?: EventHandlerUnion<T, Event>;
455
251
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/wheel_event) */
456
252
  onWheel?: EventHandlerUnion<T, WheelEvent>;
@@ -511,6 +307,7 @@ export interface AriaAttributes {
511
307
  * @see aria-controls
512
308
  */
513
309
  ["aria-owns"]?: string;
310
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) */
514
311
  ariaActiveDescendantElement?: Element;
515
312
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) */
516
313
  ariaAtomic?: boolean | "false" | "true";
@@ -530,32 +327,35 @@ export interface AriaAttributes {
530
327
  ariaColIndex?: number | string;
531
328
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) */
532
329
  ariaColSpan?: number | string;
330
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) */
533
331
  ariaControlsElements?: Element[];
534
332
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) */
535
333
  ariaCurrent?: boolean | "date" | "false" | "location" | "page" | "step" | "time" | "true";
334
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) */
536
335
  ariaDescribedByElements?: Element[];
537
336
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) */
538
337
  ariaDescription?: string;
338
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) */
539
339
  ariaDetailsElements?: Element[];
540
340
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) */
541
341
  ariaDisabled?: boolean | "false" | "true";
542
- ariaErrorMessageElement?: Element;
342
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) */
343
+ ariaErrorMessageElements?: Element[];
543
344
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) */
544
345
  ariaExpanded?: boolean | "false" | "true";
346
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) */
545
347
  ariaFlowToElements?: Element[];
546
348
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) */
547
349
  ariaHasPopup?: boolean | "dialog" | "false" | "grid" | "listbox" | "menu" | "tree" | "true";
548
350
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) */
549
351
  ariaHidden?: boolean | "false" | "true";
550
- /**
551
- * Indicates the entered value does not conform to the format expected by the application.
552
- * @see aria-errormessage
553
- */
352
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) */
554
353
  ariaInvalid?: boolean | "false" | "grammar" | "spelling" | "true";
555
354
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) */
556
355
  ariaKeyShortcuts?: string;
557
356
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) */
558
357
  ariaLabel?: string;
358
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) */
559
359
  ariaLabelledByElements?: Element[];
560
360
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) */
561
361
  ariaLevel?: number | string;
@@ -569,6 +369,7 @@ export interface AriaAttributes {
569
369
  ariaMultiSelectable?: boolean | "false" | "true";
570
370
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) */
571
371
  ariaOrientation?: "horizontal" | "vertical";
372
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) */
572
373
  ariaOwnsElements?: Element[];
573
374
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) */
574
375
  ariaPlaceholder?: string;
@@ -604,6 +405,7 @@ export interface AriaAttributes {
604
405
  ariaValueNow?: number | string;
605
406
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) */
606
407
  ariaValueText?: string;
408
+ /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) */
607
409
  role?: "alert" | "alertdialog" | "application" | "article" | "banner" | "button" | "cell" | "checkbox" | "columnheader" | "combobox" | "complementary" | "contentinfo" | "definition" | "dialog" | "directory" | "document" | "feed" | "figure" | "form" | "grid" | "gridcell" | "group" | "heading" | "img" | "link" | "list" | "listbox" | "listitem" | "log" | "main" | "marquee" | "math" | "menu" | "menubar" | "menuitem" | "menuitemcheckbox" | "menuitemradio" | "meter" | "navigation" | "none" | "note" | "option" | "presentation" | "progressbar" | "radio" | "radiogroup" | "region" | "row" | "rowgroup" | "rowheader" | "scrollbar" | "search" | "searchbox" | "separator" | "slider" | "spinbutton" | "status" | "switch" | "tab" | "table" | "tablist" | "tabpanel" | "term" | "textbox" | "timer" | "toolbar" | "tooltip" | "tree" | "treegrid" | "treeitem";
608
410
  }
609
411
  /**
@@ -612,34 +414,64 @@ export interface AriaAttributes {
612
414
  * batch breaking changes in a single release in the future.
613
415
  */
614
416
  export interface HTMLAttributes<T = HTMLElement> extends AriaAttributes, DOMAttributes<T> {
615
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/accessKey) */
417
+ /**
418
+ * The **`HTMLElement.accessKey`** property sets the keystroke which a user can press to jump to a given element.
419
+ *
420
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/accessKey)
421
+ */
616
422
  accessKey?: string;
617
423
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) */
618
424
  ariaColIndexText?: string;
619
425
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) */
620
426
  ariaRowIndexText?: string;
621
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/autocapitalize) */
427
+ /**
428
+ * The **`autocapitalize`** property of the HTMLElement interface represents the element's capitalization behavior for user input.
429
+ *
430
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/autocapitalize)
431
+ */
622
432
  autocapitalize?: HtmlAutocapitalize;
433
+ /**
434
+ * The **`autocorrect`** property of the HTMLElement interface controls whether or not autocorrection of editable text is enabled for spelling and/or punctuation errors.
435
+ *
436
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/autocorrect)
437
+ */
438
+ autocorrect?: boolean;
623
439
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/autofocus) */
624
440
  autofocus?: boolean;
625
441
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/contentEditable) */
626
442
  contentEditable?: boolean | "inherit" | "plaintext-only";
627
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dir) */
443
+ /**
444
+ * The **`HTMLElement.dir`** property indicates the text writing directionality of the content of the current element.
445
+ *
446
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/dir)
447
+ */
628
448
  dir?: HtmlDir;
629
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/draggable) */
449
+ /**
450
+ * The **`draggable`** property of the HTMLElement interface gets and sets a Boolean primitive indicating if the element is draggable.
451
+ *
452
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/draggable)
453
+ */
630
454
  draggable?: boolean;
631
455
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/enterKeyHint) */
632
456
  enterKeyHint?: "done" | "enter" | "go" | "next" | "previous" | "search" | "send";
633
457
  exportParts?: string;
634
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/hidden) */
458
+ /**
459
+ * The HTMLElement property **`hidden`** reflects the value of the element's `hidden` attribute.
460
+ *
461
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/hidden)
462
+ */
635
463
  hidden?: boolean | "hidden" | "until-found";
636
464
  /**
637
- * Returns the value of element's id content attribute. Can be set to change it.
465
+ * The **`id`** property of the Element interface represents the element's identifier, reflecting the **`id`** global attribute.
638
466
  *
639
467
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/id)
640
468
  */
641
469
  id?: string;
642
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/inert) */
470
+ /**
471
+ * The HTMLElement property **`inert`** reflects the value of the element's `inert` attribute.
472
+ *
473
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/inert)
474
+ */
643
475
  inert?: boolean;
644
476
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/inputMode) */
645
477
  inputMode?: "decimal" | "email" | "none" | "numeric" | "search" | "tel" | "text" | "url";
@@ -648,35 +480,67 @@ export interface HTMLAttributes<T = HTMLElement> extends AriaAttributes, DOMAttr
648
480
  itemref?: string;
649
481
  itemscope?: boolean;
650
482
  itemtype?: string;
651
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/lang) */
483
+ /**
484
+ * The **`lang`** property of the HTMLElement interface indicates the base language of an element's attribute values and text content, in the form of a MISSING: RFC(5646, 'BCP 47 language identifier tag')].
485
+ *
486
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/lang)
487
+ */
652
488
  lang?: string;
653
489
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/nonce) */
654
490
  nonce?: string;
655
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/part) */
491
+ /**
492
+ * The **`part`** property of the Element interface represents the part identifier(s) of the element (i.e., set using the `part` attribute), returned as a DOMTokenList.
493
+ *
494
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/part)
495
+ */
656
496
  part?: string;
657
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/popover) */
497
+ /**
498
+ * The **`popover`** property of the HTMLElement interface gets and sets an element's popover state via JavaScript (`'auto'`, `'hint'`, or `'manual'`), and can be used for feature detection.
499
+ *
500
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/popover)
501
+ */
658
502
  popover?: boolean | "auto" | "manual";
659
503
  /**
660
- * Returns the value of element's slot content attribute. Can be set to change it.
504
+ * The **`slot`** property of the Element interface returns the name of the shadow DOM slot the element is inserted in.
661
505
  *
662
506
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/slot)
663
507
  */
664
508
  slot?: string;
665
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/spellcheck) */
509
+ /**
510
+ * The **`spellcheck`** property of the HTMLElement interface represents a boolean value that controls the spell-checking hint.
511
+ *
512
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/spellcheck)
513
+ */
666
514
  spellcheck?: boolean;
667
515
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/style) */
668
516
  style?: CssProperties | DirectiveResult<typeof StyleMapDirective> | string;
669
517
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/tabIndex) */
670
518
  tabIndex?: number | string;
671
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/title) */
519
+ /**
520
+ * The **`HTMLElement.title`** property represents the title of the element: the text usually displayed in a 'tooltip' popup when the mouse is over the node.
521
+ *
522
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/title)
523
+ */
672
524
  title?: string;
673
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/translate) */
525
+ /**
526
+ * The **`translate`** property of the HTMLElement interface indicates whether an element's attribute values and the values of its Text node children are to be translated when the page is localized, or whether to leave them unchanged.
527
+ *
528
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/translate)
529
+ */
674
530
  translate?: boolean;
675
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/writingSuggestions) */
531
+ /**
532
+ * The **`writingSuggestions`** property of the HTMLElement interface is a string indicating if browser-provided writing suggestions should be enabled under the scope of the element or not.
533
+ *
534
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLElement/writingSuggestions)
535
+ */
676
536
  writingSuggestions?: string;
677
537
  }
678
538
  interface HtmlAnchorAttributes<T> extends HTMLAttributes<T> {
679
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/download) */
539
+ /**
540
+ * The **`HTMLAnchorElement.download`** property is a string indicating that the linked resource is intended to be downloaded rather than displayed in the browser.
541
+ *
542
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/download)
543
+ */
680
544
  download?: string;
681
545
  /**
682
546
  * Returns the hyperlink's URL.
@@ -687,48 +551,68 @@ interface HtmlAnchorAttributes<T> extends HTMLAttributes<T> {
687
551
  */
688
552
  href?: string;
689
553
  /**
690
- * Sets or retrieves the language code of the object.
554
+ * The **`hreflang`** property of the HTMLAnchorElement interface is a string that is the language of the linked resource.
691
555
  *
692
556
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hreflang)
693
557
  */
694
558
  hreflang?: string;
695
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/ping) */
559
+ /**
560
+ * The **`ping`** property of the HTMLAnchorElement interface is a space-separated list of URLs.
561
+ *
562
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/ping)
563
+ */
696
564
  ping?: string;
697
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/referrerPolicy) */
565
+ /**
566
+ * The **`HTMLAnchorElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the A string; one of the following: - `no-referrer` - : The Referer header will be omitted entirely.
567
+ *
568
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/referrerPolicy)
569
+ */
698
570
  referrerPolicy?: ReferrerPolicy;
699
571
  /**
700
- * Sets or retrieves the relationship between the object and the destination of the link.
572
+ * The **`HTMLAnchorElement.rel`** property reflects the `rel` attribute.
701
573
  *
702
574
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/rel)
703
575
  */
704
576
  rel?: string;
705
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/relList) */
577
+ /**
578
+ * The **`HTMLAnchorElement.relList`** read-only property reflects the `rel` attribute.
579
+ *
580
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/relList)
581
+ */
706
582
  relList?: string;
707
583
  /**
708
- * Sets or retrieves the window or frame at which to target content.
584
+ * The **`target`** property of the HTMLAnchorElement interface is a string that indicates where to display the linked resource.
709
585
  *
710
586
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/target)
711
587
  */
712
588
  target?: string;
713
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/type) */
589
+ /**
590
+ * The **`type`** property of the HTMLAnchorElement interface is a string that indicates the MIME type of the linked resource.
591
+ *
592
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/type)
593
+ */
714
594
  type?: string;
715
595
  }
716
596
  interface HtmlAudioAttributes<T> extends HtmlMediaAttributes<T> {
717
597
  }
718
598
  interface HtmlAreaAttributes<T> extends HTMLAttributes<T> {
719
599
  /**
720
- * Sets or retrieves a text alternative to the graphic.
600
+ * The **`alt`** property of the HTMLAreaElement interface specifies the text of the hyperlink, defining the textual label for an image map's link.
721
601
  *
722
602
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/alt)
723
603
  */
724
604
  alt?: string;
725
605
  /**
726
- * Sets or retrieves the coordinates of the object.
606
+ * The **`coords`** property of the HTMLAreaElement interface specifies the coordinates of the element's shape as a list of floating-point numbers.
727
607
  *
728
608
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/coords)
729
609
  */
730
610
  coords?: string;
731
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/download) */
611
+ /**
612
+ * The **`download`** property of the HTMLAreaElement interface is a string indicating that the linked resource is intended to be downloaded rather than displayed in the browser.
613
+ *
614
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/download)
615
+ */
732
616
  download?: string;
733
617
  /**
734
618
  * Returns the hyperlink's URL.
@@ -738,22 +622,38 @@ interface HtmlAreaAttributes<T> extends HTMLAttributes<T> {
738
622
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/href)
739
623
  */
740
624
  href?: string;
741
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/ping) */
625
+ /**
626
+ * The **`ping`** property of the HTMLAreaElement interface is a space-separated list of URLs.
627
+ *
628
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/ping)
629
+ */
742
630
  ping?: string;
743
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/referrerPolicy) */
631
+ /**
632
+ * The **`HTMLAreaElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the resource.
633
+ *
634
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/referrerPolicy)
635
+ */
744
636
  referrerPolicy?: ReferrerPolicy;
745
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/rel) */
637
+ /**
638
+ * The **`HTMLAreaElement.rel`** property reflects the `rel` attribute.
639
+ *
640
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/rel)
641
+ */
746
642
  rel?: string;
747
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/relList) */
643
+ /**
644
+ * The **`HTMLAreaElement.relList`** read-only property reflects the `rel` attribute.
645
+ *
646
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/relList)
647
+ */
748
648
  relList?: string;
749
649
  /**
750
- * Sets or retrieves the shape of the object.
650
+ * The **`shape`** property of the HTMLAreaElement interface specifies the shape of an image map area.
751
651
  *
752
652
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/shape)
753
653
  */
754
654
  shape?: "circle" | "default" | "poly" | "rect";
755
655
  /**
756
- * Sets or retrieves the window or frame at which to target content.
656
+ * The **`target`** property of the HTMLAreaElement interface is a string that indicates where to display the linked resource.
757
657
  *
758
658
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/target)
759
659
  */
@@ -761,13 +661,13 @@ interface HtmlAreaAttributes<T> extends HTMLAttributes<T> {
761
661
  }
762
662
  interface HtmlBaseAttributes<T> extends HTMLAttributes<T> {
763
663
  /**
764
- * Gets or sets the baseline URL on which relative links are based.
664
+ * The **`href`** property of the HTMLBaseElement interface contains a string that is the URL to use as the base for relative URLs.
765
665
  *
766
666
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLBaseElement/href)
767
667
  */
768
668
  href?: string;
769
669
  /**
770
- * Sets or retrieves the window or frame at which to target content.
670
+ * The `target` property of the HTMLBaseElement interface is a string that represents the default target tab to show the resulting output for hyperlinks and form elements.
771
671
  *
772
672
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLBaseElement/target)
773
673
  */
@@ -775,48 +675,52 @@ interface HtmlBaseAttributes<T> extends HTMLAttributes<T> {
775
675
  }
776
676
  interface HtmlBlockquoteAttributes<T> extends HTMLAttributes<T> {
777
677
  /**
778
- * Sets or retrieves reference information about the object.
678
+ * The **`cite`** property of the HTMLQuoteElement interface indicates the URL for the source of the quotation.
779
679
  *
780
680
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLQuoteElement/cite)
781
681
  */
782
682
  cite?: string;
783
683
  }
784
684
  interface HtmlButtonAttributes<T> extends HTMLAttributes<T> {
785
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/disabled) */
685
+ /**
686
+ * The **`HTMLButtonElement.disabled`** property indicates whether the control is disabled, meaning that it does not accept any clicks.
687
+ *
688
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/disabled)
689
+ */
786
690
  disabled?: boolean;
787
691
  form?: string;
788
692
  /**
789
- * Overrides the action attribute (where the data on a form is sent) on the parent form element.
693
+ * The **`formAction`** property of the HTMLButtonElement interface is the URL of the program that is executed on the server when the form that owns this control is submitted.
790
694
  *
791
695
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/formAction)
792
696
  */
793
697
  formAction?: string;
794
698
  /**
795
- * Used to override the encoding (formEnctype attribute) specified on the form element.
699
+ * The **`formEnctype`** property of the HTMLButtonElement interface is the MIME_type of the content sent to the server when the form is submitted.
796
700
  *
797
701
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/formEnctype)
798
702
  */
799
703
  formEnctype?: HtmlFormEncType;
800
704
  /**
801
- * Overrides the submit method attribute previously specified on a form element.
705
+ * The **`formMethod`** property of the HTMLButtonElement interface is the HTTP method used to submit the form if the button element is the control that submits the form.
802
706
  *
803
707
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/formMethod)
804
708
  */
805
709
  formMethod?: HtmlFormMethod;
806
710
  /**
807
- * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a "save draft"-type submit option.
711
+ * The **`formNoValidate`** property of the HTMLButtonElement interface is a boolean value indicating if the form will bypass constraint validation when submitted via the button.
808
712
  *
809
713
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/formNoValidate)
810
714
  */
811
715
  formNoValidate?: boolean;
812
716
  /**
813
- * Overrides the target attribute on a form element.
717
+ * The **`formTarget`** property of the HTMLButtonElement interface is the tab, window, or iframe where the response of the submitted form is to be displayed.
814
718
  *
815
719
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/formTarget)
816
720
  */
817
721
  formTarget?: string;
818
722
  /**
819
- * Sets or retrieves the name of the object.
723
+ * The **`name`** property of the HTMLButtonElement interface indicates the name of the button element or the empty string if the element has no name.
820
724
  *
821
725
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/name)
822
726
  */
@@ -827,13 +731,13 @@ interface HtmlButtonAttributes<T> extends HTMLAttributes<T> {
827
731
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */
828
732
  popoverTargetElement?: HTMLElement;
829
733
  /**
830
- * Gets the classification and default behavior of the button.
734
+ * The **`type`** property of the HTMLButtonElement interface is a string that indicates the behavior type of the button element.
831
735
  *
832
736
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/type)
833
737
  */
834
738
  type?: "button" | "reset" | "submit";
835
739
  /**
836
- * Sets or retrieves the default or selected value of the control.
740
+ * The **`value`** property of the HTMLButtonElement interface represents the value of the button element as a string, or the empty string if no value is set.
837
741
  *
838
742
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/value)
839
743
  */
@@ -841,13 +745,13 @@ interface HtmlButtonAttributes<T> extends HTMLAttributes<T> {
841
745
  }
842
746
  interface HtmlCanvasAttributes<T> extends HTMLAttributes<T> {
843
747
  /**
844
- * Gets or sets the height of a canvas element on a document.
748
+ * The **`HTMLCanvasElement.height`** property is a positive `integer` reflecting the `height` HTML attribute of the canvas element interpreted in CSS pixels.
845
749
  *
846
750
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement/height)
847
751
  */
848
752
  height?: number | string;
849
753
  /**
850
- * Gets or sets the width of a canvas element on a document.
754
+ * The **`HTMLCanvasElement.width`** property is a positive `integer` reflecting the `width` HTML attribute of the canvas element interpreted in CSS pixels.
851
755
  *
852
756
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLCanvasElement/width)
853
757
  */
@@ -855,7 +759,7 @@ interface HtmlCanvasAttributes<T> extends HTMLAttributes<T> {
855
759
  }
856
760
  interface HtmlColAttributes<T> extends HTMLAttributes<T> {
857
761
  /**
858
- * Sets or retrieves the number of columns in the group.
762
+ * The **`span`** read-only property of the HTMLTableColElement interface represents the number of columns this col or colgroup must span; this lets the column occupy space across multiple columns of the table.
859
763
  *
860
764
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableColElement/span)
861
765
  */
@@ -863,166 +767,228 @@ interface HtmlColAttributes<T> extends HTMLAttributes<T> {
863
767
  }
864
768
  interface HtmlColgroupAttributes<T> extends HTMLAttributes<T> {
865
769
  /**
866
- * Sets or retrieves the number of columns in the group.
770
+ * The **`span`** read-only property of the HTMLTableColElement interface represents the number of columns this col or colgroup must span; this lets the column occupy space across multiple columns of the table.
867
771
  *
868
772
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableColElement/span)
869
773
  */
870
774
  span?: number | string;
871
775
  }
872
776
  interface HtmlDataAttributes<T> extends HTMLAttributes<T> {
873
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDataElement/value) */
777
+ /**
778
+ * The **`value`** property of the HTMLDataElement interface returns a string reflecting the `value` HTML attribute.
779
+ *
780
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDataElement/value)
781
+ */
874
782
  value?: number | string;
875
783
  }
876
784
  interface HtmlModAttributes<T> extends HTMLAttributes<T> {
877
785
  /**
878
- * Sets or retrieves reference information about the object.
786
+ * The **`cite`** property of the HTMLModElement interface indicates the URL of the resource explaining the modification.
879
787
  *
880
788
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLModElement/cite)
881
789
  */
882
790
  cite?: string;
883
791
  /**
884
- * Sets or retrieves the date and time of a modification to the object.
792
+ * The **`dateTime`** property of the HTMLModElement interface is a string containing a machine-readable date with an optional time value.
885
793
  *
886
794
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLModElement/dateTime)
887
795
  */
888
796
  dateTime?: string;
889
797
  }
890
798
  interface HtmlDetailsAttributes<T> extends HTMLAttributes<T> {
891
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDetailsElement/name) */
799
+ /**
800
+ * The **`name`** property of the HTMLDetailsElement interface reflects the `name` attribute of details elements.
801
+ *
802
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDetailsElement/name)
803
+ */
892
804
  name?: string;
893
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDetailsElement/open) */
805
+ /**
806
+ * The **`open`** property of the `open` HTML attribute, indicating whether the details's contents (not counting the summary) is to be shown to the user.
807
+ *
808
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDetailsElement/open)
809
+ */
894
810
  open?: boolean;
895
811
  }
896
812
  interface HtmlDialogAttributes<T> extends HTMLAttributes<T> {
897
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/open) */
813
+ /**
814
+ * The **`open`** property of the `open` HTML attribute, indicating whether the dialog is available for interaction.
815
+ *
816
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/open)
817
+ */
898
818
  open?: boolean;
899
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/returnValue) */
819
+ /**
820
+ * The **`returnValue`** property of the HTMLDialogElement interface is a string representing the return value for a dialog element when it's closed.
821
+ *
822
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLDialogElement/returnValue)
823
+ */
900
824
  returnValue?: string;
901
825
  }
902
826
  interface HtmlEmbedAttributes<T> extends HTMLAttributes<T> {
903
827
  /**
904
- * Sets or retrieves the height of the object.
828
+ * The **`height`** property of the HTMLEmbedElement interface returns a string that reflects the `height` attribute of the embed element, indicating the displayed height of the resource in CSS pixels.
905
829
  *
906
830
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLEmbedElement/height)
907
831
  */
908
832
  height?: number | string;
909
833
  /**
910
- * Sets or retrieves a URL to be loaded by the object.
834
+ * The **`src`** property of the HTMLEmbedElement interface returns a string that indicates the URL of the resource being embedded.
911
835
  *
912
836
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLEmbedElement/src)
913
837
  */
914
838
  src?: string;
915
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLEmbedElement/type) */
839
+ /**
840
+ * The **`type`** property of the HTMLEmbedElement interface returns a string that reflects the `type` attribute of the embed element, indicating the MIME type of the resource.
841
+ *
842
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLEmbedElement/type)
843
+ */
916
844
  type?: string;
917
845
  /**
918
- * Sets or retrieves the width of the object.
846
+ * The **`width`** property of the HTMLEmbedElement interface returns a string that reflects the `width` attribute of the embed element, indicating the displayed width of the resource in CSS pixels.
919
847
  *
920
848
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLEmbedElement/width)
921
849
  */
922
850
  width?: number | string;
923
851
  }
924
852
  interface HtmlFieldsetAttributes<T> extends HTMLAttributes<T> {
925
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFieldSetElement/disabled) */
853
+ /**
854
+ * The **`disabled`** property of the HTMLFieldSetElement interface is a boolean value that reflects the fieldset element's `disabled` attribute, which indicates whether the control is disabled.
855
+ *
856
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFieldSetElement/disabled)
857
+ */
926
858
  disabled?: boolean;
927
859
  form?: string;
928
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFieldSetElement/name) */
860
+ /**
861
+ * The **`name`** property of the HTMLFieldSetElement interface indicates the name of the fieldset element.
862
+ *
863
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFieldSetElement/name)
864
+ */
929
865
  name?: string;
930
866
  }
931
867
  interface HtmlFormAttributes<T> extends HTMLAttributes<T> {
932
868
  /**
933
- * Sets or retrieves a list of character encodings for input data that must be accepted by the server processing the form.
869
+ * The **`HTMLFormElement.acceptCharset`** property represents the character encoding for the given form element.
934
870
  *
935
871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/acceptCharset)
936
872
  */
937
873
  acceptCharset?: string;
938
874
  /**
939
- * Sets or retrieves the URL to which the form content is sent for processing.
875
+ * The **`HTMLFormElement.action`** property represents the action of the form element.
940
876
  *
941
877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/action)
942
878
  */
943
879
  action?: string;
944
880
  /**
945
- * Specifies whether autocomplete is applied to an editable text field.
881
+ * The **`autocomplete`** property of the HTMLFormElement interface indicates whether the value of the form's controls can be automatically completed by the browser.
946
882
  *
947
883
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/autocomplete)
948
884
  */
949
885
  autocomplete?: "off" | "on";
950
886
  /**
951
- * Sets or retrieves the MIME encoding for the form.
887
+ * The **`HTMLFormElement.encoding`** property is an alternative name for the HTMLFormElement.enctype element on the DOM HTMLFormElement object.
952
888
  *
953
889
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/encoding)
954
890
  */
955
891
  encoding?: HtmlFormEncType;
956
892
  /**
957
- * Sets or retrieves the encoding type for the form.
893
+ * The **`HTMLFormElement.enctype`** property is the MIME_type of content that is used to submit the form to the server.
958
894
  *
959
895
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/enctype)
960
896
  */
961
897
  enctype?: HtmlFormEncType;
962
898
  /**
963
- * Sets or retrieves how to send the form data to the server.
899
+ * The **`HTMLFormElement.method`** property represents the Unless explicitly specified, the default method is 'get'.
964
900
  *
965
901
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/method)
966
902
  */
967
903
  method?: HtmlFormMethod;
968
904
  /**
969
- * Sets or retrieves the name of the object.
905
+ * The **`HTMLFormElement.name`** property represents the name of the current form element as a string.
970
906
  *
971
907
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/name)
972
908
  */
973
909
  name?: string;
974
910
  /**
975
- * Designates a form that is not validated when submitted.
911
+ * The **`noValidate`** property of the HTMLFormElement interface is a boolean value indicating if the form will bypass constraint validation when submitted.
976
912
  *
977
913
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/noValidate)
978
914
  */
979
915
  noValidate?: boolean;
916
+ /**
917
+ * The **`rel`** property of the HTMLFormElement interface reflects the `rel` attribute.
918
+ *
919
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/rel)
920
+ */
980
921
  rel?: string;
922
+ /**
923
+ * The **`relList`** read-only property of the HTMLFormElement interface reflects the `rel` attribute.
924
+ *
925
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/relList)
926
+ */
981
927
  relList?: string;
982
928
  /**
983
- * Sets or retrieves the window or frame at which to target content.
929
+ * The **`target`** property of the HTMLFormElement interface represents the target of the form's action (i.e., the frame in which to render its output).
984
930
  *
985
931
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLFormElement/target)
986
932
  */
987
933
  target?: string;
988
934
  }
989
935
  interface HtmlIframeAttributes<T> extends HTMLAttributes<T> {
990
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/allow) */
936
+ /**
937
+ * The **`allow`** property of the HTMLIFrameElement interface indicates the Permissions Policy specified for this `<iframe>` element.
938
+ *
939
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/allow)
940
+ */
991
941
  allow?: string;
992
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/allowFullscreen) */
942
+ /**
943
+ * The **`allowFullscreen`** property of the HTMLIFrameElement interface is a boolean value that reflects the `allowfullscreen` attribute of the iframe element, indicating whether to allow the iframe's contents to use Element.requestFullscreen.
944
+ *
945
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/allowFullscreen)
946
+ */
993
947
  allowFullscreen?: boolean;
994
948
  /**
995
- * Sets or retrieves the height of the object.
949
+ * The **`height`** property of the HTMLIFrameElement interface returns a string that reflects the `height` attribute of the iframe element, indicating the height of the frame in CSS pixels.
996
950
  *
997
951
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/height)
998
952
  */
999
953
  height?: number | string;
1000
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/loading) */
954
+ /**
955
+ * The **`loading`** property of the HTMLIFrameElement interface is a string that provides a hint to the user agent indicating whether the iframe should be loaded immediately on page load, or only when it is needed.
956
+ *
957
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/loading)
958
+ */
1001
959
  loading?: "eager" | "lazy";
1002
960
  /**
1003
- * Sets or retrieves the frame name.
961
+ * The **`name`** property of the HTMLIFrameElement interface is a string value that reflects the `name` attribute of the iframe element, indicating the specific name of the `<iframe>` element.
1004
962
  *
1005
963
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/name)
1006
964
  */
1007
965
  name?: string;
1008
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/referrerPolicy) */
966
+ /**
967
+ * The **`HTMLIFrameElement.referrerPolicy`** property reflects the HTML `referrerpolicy` attribute of the resource.
968
+ *
969
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/referrerPolicy)
970
+ */
1009
971
  referrerPolicy?: ReferrerPolicy;
1010
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/sandbox) */
972
+ /**
973
+ * The **`sandbox`** read-only property of the HTMLIFrameElement interface returns a DOMTokenList indicating extra restrictions on the behavior of the nested content.
974
+ *
975
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/sandbox)
976
+ */
1011
977
  sandbox?: HtmlIframeSandbox | string;
1012
978
  /**
1013
- * Sets or retrieves a URL to be loaded by the object.
979
+ * The **`HTMLIFrameElement.src`** A string that reflects the `src` HTML attribute, containing the address of the content to be embedded.
1014
980
  *
1015
981
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/src)
1016
982
  */
1017
983
  src?: string;
1018
984
  /**
1019
- * Sets or retrives the content of the page that is to contain.
985
+ * The **`srcdoc`** property of the HTMLIFrameElement specifies the content of the page.
1020
986
  *
1021
987
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/srcdoc)
1022
988
  */
1023
989
  srcdoc?: string;
1024
990
  /**
1025
- * Sets or retrieves the width of the object.
991
+ * The **`width`** property of the HTMLIFrameElement interface returns a string that reflects the `width` attribute of the iframe element, indicating the width of the frame in CSS pixels.
1026
992
  *
1027
993
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLIFrameElement/width)
1028
994
  */
@@ -1030,56 +996,80 @@ interface HtmlIframeAttributes<T> extends HTMLAttributes<T> {
1030
996
  }
1031
997
  interface HtmlImgAttributes<T> extends HTMLAttributes<T> {
1032
998
  /**
1033
- * Sets or retrieves a text alternative to the graphic.
999
+ * The HTMLImageElement property **`alt`** provides fallback (alternate) text to display when the image specified by the img element is not loaded.
1034
1000
  *
1035
1001
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/alt)
1036
1002
  */
1037
1003
  alt?: string;
1038
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/crossOrigin) */
1004
+ /**
1005
+ * The HTMLImageElement interface's **`crossOrigin`** attribute is a string which specifies the Cross-Origin Resource Sharing (CORS) setting to use when retrieving the image.
1006
+ *
1007
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/crossOrigin)
1008
+ */
1039
1009
  crossOrigin?: HtmlCrossOrigin;
1040
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/decoding) */
1010
+ /**
1011
+ * The **`decoding`** property of the HTMLImageElement interface provides a hint to the browser as to how it should decode the image.
1012
+ *
1013
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/decoding)
1014
+ */
1041
1015
  decoding?: "async" | "auto" | "sync";
1042
1016
  elementTiming?: string;
1043
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/fetchPriority) */
1017
+ /**
1018
+ * The **`fetchPriority`** property of the HTMLImageElement interface represents a hint to the browser indicating how it should prioritize fetching a particular image relative to other images.
1019
+ *
1020
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/fetchPriority)
1021
+ */
1044
1022
  fetchPriority?: "auto" | "high" | "low";
1045
1023
  /**
1046
- * Sets or retrieves the height of the object.
1024
+ * The **`height`** property of the drawn, in CSS pixel if the image is being drawn or rendered to any visual medium such as the screen or a printer; otherwise, it's the natural, pixel density corrected height of the image.
1047
1025
  *
1048
1026
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/height)
1049
1027
  */
1050
1028
  height?: number | string;
1051
1029
  /**
1052
- * Sets or retrieves whether the image is a server-side image map.
1030
+ * The HTMLImageElement property **`isMap`** is a Boolean value which indicates that the image is to be used by a server-side image map.
1053
1031
  *
1054
1032
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/isMap)
1055
1033
  */
1056
1034
  isMap?: boolean;
1057
1035
  /**
1058
- * Sets or retrieves the policy for loading image elements that are outside the viewport.
1036
+ * The HTMLImageElement property **`loading`** is a string whose value provides a hint to the user agent on how to handle the loading of the image which is currently outside the window's visual viewport.
1059
1037
  *
1060
1038
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/loading)
1061
1039
  */
1062
1040
  loading?: "eager" | "lazy";
1063
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/referrerPolicy) */
1041
+ /**
1042
+ * The **`HTMLImageElement.referrerPolicy`** property reflects the HTML `referrerpolicy` attribute of the resource.
1043
+ *
1044
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/referrerPolicy)
1045
+ */
1064
1046
  referrerPolicy?: ReferrerPolicy;
1065
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/sizes) */
1047
+ /**
1048
+ * The HTMLImageElement property **`sizes`** allows you to specify the layout width of the image for each of a list of media conditions.
1049
+ *
1050
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/sizes)
1051
+ */
1066
1052
  sizes?: string;
1067
1053
  /**
1068
- * The address or URL of the a media resource that is to be considered.
1054
+ * The HTMLImageElement property **`src`**, which reflects the HTML `src` attribute, specifies the image to display in the img element.
1069
1055
  *
1070
1056
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/src)
1071
1057
  */
1072
1058
  src?: string;
1073
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/srcset) */
1059
+ /**
1060
+ * The HTMLImageElement property **`srcset`** is a string which identifies one or more **image candidate strings**, separated using commas (`,`) each specifying image resources to use under given circumstances.
1061
+ *
1062
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/srcset)
1063
+ */
1074
1064
  srcset?: string;
1075
1065
  /**
1076
- * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.
1066
+ * The **`useMap`** property on the providing the name of the client-side image map to apply to the image.
1077
1067
  *
1078
1068
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/useMap)
1079
1069
  */
1080
1070
  useMap?: string;
1081
1071
  /**
1082
- * Sets or retrieves the width of the object.
1072
+ * The **`width`** property of the drawn in CSS pixel if it's being drawn or rendered to any visual medium such as a screen or printer.
1083
1073
  *
1084
1074
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/width)
1085
1075
  */
@@ -1087,136 +1077,153 @@ interface HtmlImgAttributes<T> extends HTMLAttributes<T> {
1087
1077
  }
1088
1078
  interface HtmlInputAttributes<T> extends HTMLAttributes<T> {
1089
1079
  /**
1090
- * Sets or retrieves a comma-separated list of content types.
1080
+ * The **`accept`** property of the HTMLInputElement interface reflects the input element's `accept` attribute, generally a comma-separated list of unique file type specifiers providing a hint for the expected file type for an `<input>` of type `file`.
1091
1081
  *
1092
1082
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/accept)
1093
1083
  */
1094
1084
  accept?: string;
1095
1085
  /**
1096
- * Sets or retrieves a text alternative to the graphic.
1086
+ * The **`alt`** property of the HTMLInputElement interface defines the textual label for the button for users and user agents who cannot use the image.
1097
1087
  *
1098
1088
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/alt)
1099
1089
  */
1100
1090
  alt?: string;
1101
1091
  /**
1102
- * Specifies whether autocomplete is applied to an editable text field.
1092
+ * The **`autocomplete`** property of the HTMLInputElement interface indicates whether the value of the control can be automatically completed by the browser.
1103
1093
  *
1104
1094
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/autocomplete)
1105
1095
  */
1106
1096
  autocomplete?: AutoFill;
1107
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/capture) */
1097
+ /**
1098
+ * The **`capture`** property of the HTMLInputElement interface reflects the input element's `capture` attribute.
1099
+ *
1100
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/capture)
1101
+ */
1108
1102
  capture?: boolean | string;
1109
1103
  /**
1110
- * Sets or retrieves the state of the check box or radio button.
1104
+ * The **`checked`** property of the HTMLInputElement interface specifies the current checkedness of the element; that is, whether the form control is checked or not.
1111
1105
  *
1112
1106
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/checked)
1113
1107
  */
1114
1108
  checked?: boolean;
1115
1109
  /**
1116
- * Sets or retrieves the state of the check box or radio button.
1110
+ * The **`defaultChecked`** property of the HTMLInputElement interface specifies the default checkedness state of the element.
1117
1111
  *
1118
1112
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/defaultChecked)
1119
1113
  */
1120
1114
  defaultChecked?: boolean;
1121
1115
  /**
1122
- * Sets or retrieves the initial contents of the object.
1116
+ * The **`defaultValue`** property of the HTMLInputElement interface indicates the original (or default) value of the input element.
1123
1117
  *
1124
1118
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/defaultValue)
1125
1119
  */
1126
1120
  defaultValue?: number | string;
1121
+ /**
1122
+ * The **`dirName`** property of the HTMLInputElement interface is the directionality of the element and enables the submission of that value.
1123
+ *
1124
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/dirName)
1125
+ */
1127
1126
  dirName?: string;
1128
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/disabled) */
1127
+ /**
1128
+ * The **`HTMLInputElement.disabled`** property is a boolean value that reflects the `disabled` HTML attribute, which indicates whether the control is disabled.
1129
+ *
1130
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/disabled)
1131
+ */
1129
1132
  disabled?: boolean;
1130
1133
  /**
1131
- * Returns a FileList object on a file type input object.
1134
+ * The **`HTMLInputElement.files`** property allows you to access the FileList selected with the `<input type='file'>` element.
1132
1135
  *
1133
1136
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/files)
1134
1137
  */
1135
1138
  files?: FileList;
1136
1139
  form?: string;
1137
1140
  /**
1138
- * Overrides the action attribute (where the data on a form is sent) on the parent form element.
1141
+ * The **`formAction`** property of the HTMLInputElement interface is the URL of the program that is executed on the server when the form that owns this control is submitted.
1139
1142
  *
1140
1143
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/formAction)
1141
1144
  */
1142
1145
  formAction?: string;
1143
1146
  /**
1144
- * Used to override the encoding (formEnctype attribute) specified on the form element.
1147
+ * The **`formEnctype`** property of the HTMLInputElement interface is the MIME_type of the content sent to the server when the `<input>` with the `formEnctype` is the method of form submission.
1145
1148
  *
1146
1149
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/formEnctype)
1147
1150
  */
1148
1151
  formEnctype?: HtmlFormEncType;
1149
1152
  /**
1150
- * Overrides the submit method attribute previously specified on a form element.
1153
+ * The **`formMethod`** property of the HTMLInputElement interface is the HTTP method used to submit the form if the input element is the control that submits the form.
1151
1154
  *
1152
1155
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/formMethod)
1153
1156
  */
1154
1157
  formMethod?: HtmlFormMethod;
1155
1158
  /**
1156
- * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a "save draft"-type submit option.
1159
+ * The **`formNoValidate`** property of the HTMLInputElement interface is a boolean value indicating if the form will bypass constraint validation when submitted via the input.
1157
1160
  *
1158
1161
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/formNoValidate)
1159
1162
  */
1160
1163
  formNoValidate?: boolean;
1161
1164
  /**
1162
- * Overrides the target attribute on a form element.
1165
+ * The **`formTarget`** property of the HTMLInputElement interface is the tab, window, or iframe where the response of the submitted form is to be displayed.
1163
1166
  *
1164
1167
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/formTarget)
1165
1168
  */
1166
1169
  formTarget?: string;
1167
1170
  /**
1168
- * Sets or retrieves the height of the object.
1171
+ * The **`height`** property of the HTMLInputElement interface specifies the height of a control.
1169
1172
  *
1170
1173
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/height)
1171
1174
  */
1172
1175
  height?: number | string;
1173
1176
  /**
1174
- * When set, overrides the rendering of checkbox controls so that the current value is not visible.
1177
+ * The **`indeterminate`** property of the HTMLInputElement interface returns a boolean value that indicates whether the checkbox is in the _indeterminate_ state.
1175
1178
  *
1176
1179
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/indeterminate)
1177
1180
  */
1178
1181
  indeterminate?: boolean;
1179
1182
  list?: string;
1180
1183
  /**
1181
- * Defines the maximum acceptable value for an input element with type="number".When used with the min and step attributes, lets you control the range and increment (such as only even numbers) that the user can enter into an input field.
1184
+ * The **`max`** property of the HTMLInputElement interface reflects the input element's `max` attribute, which generally defines the maximum valid value for a numeric or date-time input.
1182
1185
  *
1183
1186
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/max)
1184
1187
  */
1185
1188
  max?: number | string;
1186
1189
  /**
1187
- * Sets or retrieves the maximum number of characters that the user can enter in a text control.
1190
+ * The **`maxLength`** property of the HTMLInputElement interface indicates the maximum number of characters (in UTF-16 code units) allowed to be entered for the value of the input element, and the maximum number of characters allowed for the value to be valid.
1188
1191
  *
1189
1192
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/maxLength)
1190
1193
  */
1191
1194
  maxLength?: number | string;
1192
1195
  /**
1193
- * Defines the minimum acceptable value for an input element with type="number". When used with the max and step attributes, lets you control the range and increment (such as even numbers only) that the user can enter into an input field.
1196
+ * The **`min`** property of the HTMLInputElement interface reflects the input element's `min` attribute, which generally defines the minimum valid value for a numeric or date-time input.
1194
1197
  *
1195
1198
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/min)
1196
1199
  */
1197
1200
  min?: number | string;
1198
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/minLength) */
1201
+ /**
1202
+ * The **`minLength`** property of the HTMLInputElement interface indicates the minimum number of characters (in UTF-16 code units) required for the value of the input element to be valid.
1203
+ *
1204
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/minLength)
1205
+ */
1199
1206
  minLength?: number | string;
1200
1207
  /**
1201
- * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.
1208
+ * The **`HTMLInputElement.multiple`** property indicates if an input can have more than one value.
1202
1209
  *
1203
1210
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/multiple)
1204
1211
  */
1205
1212
  multiple?: boolean;
1206
1213
  /**
1207
- * Sets or retrieves the name of the object.
1214
+ * The **`name`** property of the HTMLInputElement interface indicates the name of the input element.
1208
1215
  *
1209
1216
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/name)
1210
1217
  */
1211
1218
  name?: string;
1212
1219
  /**
1213
- * Gets or sets a string containing a regular expression that the user's input must match.
1220
+ * The **`pattern`** property of the HTMLInputElement interface represents a regular expression a non-null input value should match.
1214
1221
  *
1215
1222
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/pattern)
1216
1223
  */
1217
1224
  pattern?: string;
1218
1225
  /**
1219
- * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.
1226
+ * The **`placeholder`** property of the HTMLInputElement interface represents a hint to the user of what can be entered in the control.
1220
1227
  *
1221
1228
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/placeholder)
1222
1229
  */
@@ -1225,70 +1232,86 @@ interface HtmlInputAttributes<T> extends HTMLAttributes<T> {
1225
1232
  popoverTargetAction?: string;
1226
1233
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */
1227
1234
  popoverTargetElement?: Element;
1228
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/readOnly) */
1235
+ /**
1236
+ * The **`readOnly`** property of the HTMLInputElement interface indicates that the user cannot modify the value of the input.
1237
+ *
1238
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/readOnly)
1239
+ */
1229
1240
  readOnly?: boolean;
1230
1241
  /**
1231
- * When present, marks an element that can't be submitted without a value.
1242
+ * The **`required`** property of the HTMLInputElement interface specifies that the user must fill in a value before submitting a form.
1232
1243
  *
1233
1244
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/required)
1234
1245
  */
1235
1246
  required?: boolean;
1236
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionDirection) */
1247
+ /**
1248
+ * The **`selectionDirection`** property of the HTMLInputElement interface is a string that indicates the direction in which the user is selecting the text.
1249
+ *
1250
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionDirection)
1251
+ */
1237
1252
  selectionDirection?: "backward" | "forward" | "none";
1238
1253
  /**
1239
- * Gets or sets the end position or offset of a text selection.
1254
+ * The **`selectionEnd`** property of the HTMLInputElement interface is a number that represents the end index of the selected text.
1240
1255
  *
1241
1256
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionEnd)
1242
1257
  */
1243
1258
  selectionEnd?: number;
1244
1259
  /**
1245
- * Gets or sets the starting position or offset of a text selection.
1260
+ * The **`selectionStart`** property of the HTMLInputElement interface is a number that represents the beginning index of the selected text.
1246
1261
  *
1247
1262
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/selectionStart)
1248
1263
  */
1249
1264
  selectionStart?: number;
1250
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/size) */
1265
+ /**
1266
+ * The **`size`** property of the HTMLInputElement interface defines the number of visible characters displayed.
1267
+ *
1268
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/size)
1269
+ */
1251
1270
  size?: number | string;
1252
1271
  /**
1253
- * The address or URL of the a media resource that is to be considered.
1272
+ * The **`src`** property of the HTMLInputElement interface specifies the source of an image to display as the graphical submit button.
1254
1273
  *
1255
1274
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/src)
1256
1275
  */
1257
1276
  src?: string;
1258
1277
  /**
1259
- * Defines an increment or jump between values that you want to allow the user to enter. When used with the max and min attributes, lets you control the range and increment (for example, allow only even numbers) that the user can enter into an input field.
1278
+ * The **`step`** property of the HTMLInputElement interface indicates the step by which numeric or date-time input elements can change.
1260
1279
  *
1261
1280
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/step)
1262
1281
  */
1263
1282
  step?: number | string;
1264
1283
  /**
1265
- * Returns the content type of the object.
1284
+ * The **`type`** property of the HTMLInputElement interface indicates the kind of data allowed in the input element, for example a number, a date, or an email.
1266
1285
  *
1267
1286
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/type)
1268
1287
  */
1269
1288
  type?: string;
1270
1289
  /**
1271
- * Returns the value of the data at the cursor's current position.
1290
+ * The **`value`** property of the HTMLInputElement interface represents the current value of the input element as a string.
1272
1291
  *
1273
1292
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/value)
1274
1293
  */
1275
1294
  value?: number | string;
1276
1295
  /**
1277
- * Returns a Date object representing the form control's value, if applicable; otherwise, returns null. Can be set, to change the value. Throws an "InvalidStateError" DOMException if the control isn't date- or time-based.
1296
+ * The **`valueAsDate`** property of the HTMLInputElement interface represents the current value of the input element as a Date, or `null` if conversion is not possible.
1278
1297
  *
1279
1298
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/valueAsDate)
1280
1299
  */
1281
1300
  valueAsDate?: Date;
1282
1301
  /**
1283
- * Returns the input field value as a number.
1302
+ * The **`valueAsNumber`** property of the HTMLInputElement interface represents the current value of the input element as a number or `NaN` if converting to a numeric value is not possible.
1284
1303
  *
1285
1304
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/valueAsNumber)
1286
1305
  */
1287
1306
  valueAsNumber?: number;
1288
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/webkitdirectory) */
1307
+ /**
1308
+ * The **`HTMLInputElement.webkitdirectory`** is a property that reflects the `webkitdirectory` HTML attribute and indicates that the input element should let the user select directories instead of files.
1309
+ *
1310
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/webkitdirectory)
1311
+ */
1289
1312
  webkitdirectory?: boolean;
1290
1313
  /**
1291
- * Sets or retrieves the width of the object.
1314
+ * The **`width`** property of the HTMLInputElement interface specifies the width of a control.
1292
1315
  *
1293
1316
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/width)
1294
1317
  */
@@ -1297,7 +1320,7 @@ interface HtmlInputAttributes<T> extends HTMLAttributes<T> {
1297
1320
  interface HtmlLabelAttributes<T> extends HTMLAttributes<T> {
1298
1321
  form?: string;
1299
1322
  /**
1300
- * Sets or retrieves the object to which the given label object is assigned.
1323
+ * The **`HTMLLabelElement.htmlFor`** property reflects the value of the `for` content property.
1301
1324
  *
1302
1325
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLabelElement/htmlFor)
1303
1326
  */
@@ -1305,59 +1328,105 @@ interface HtmlLabelAttributes<T> extends HTMLAttributes<T> {
1305
1328
  }
1306
1329
  interface HtmlLiAttributes<T> extends HTMLAttributes<T> {
1307
1330
  /**
1308
- * Sets or retrieves the value of a list item.
1331
+ * The **`value`** property of the HTMLLIElement interface indicates the ordinal position of the _list element_ inside a given ol.
1309
1332
  *
1310
1333
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLIElement/value)
1311
1334
  */
1312
1335
  value?: number | string;
1313
1336
  }
1314
1337
  interface HtmlLinkAttributes<T> extends HTMLAttributes<T> {
1315
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/as) */
1338
+ /**
1339
+ * The **`as`** property of the HTMLLinkElement interface returns a string representing the type of content to be preloaded by a link element.
1340
+ *
1341
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/as)
1342
+ */
1316
1343
  as?: HtmlLinkAs;
1317
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/blocking) */
1344
+ /**
1345
+ * The **`blocking`** property of the HTMLLinkElement interface is a string indicating that certain operations should be blocked on the fetching of an external resource.
1346
+ *
1347
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/blocking)
1348
+ */
1318
1349
  blocking?: string;
1319
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/crossOrigin) */
1350
+ /**
1351
+ * The **`crossOrigin`** property of the HTMLLinkElement interface specifies the Cross-Origin Resource Sharing (CORS) setting to use when retrieving the resource.
1352
+ *
1353
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/crossOrigin)
1354
+ */
1320
1355
  crossOrigin?: HtmlCrossOrigin;
1321
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/disabled) */
1356
+ /**
1357
+ * The **`disabled`** property of the HTMLLinkElement interface is a boolean value that represents whether the link is disabled.
1358
+ *
1359
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/disabled)
1360
+ */
1322
1361
  disabled?: boolean;
1323
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/fetchPriority) */
1362
+ /**
1363
+ * The **`fetchPriority`** property of the HTMLLinkElement interface represents a hint to the browser indicating how it should prioritize fetching a particular resource relative to other resources of the same type.
1364
+ *
1365
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/fetchPriority)
1366
+ */
1324
1367
  fetchPriority?: "auto" | "high" | "low";
1325
1368
  /**
1326
- * Sets or retrieves a destination URL or an anchor point.
1369
+ * The **`href`** property of the HTMLLinkElement interface contains a string that is the URL associated with the link.
1327
1370
  *
1328
1371
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/href)
1329
1372
  */
1330
1373
  href?: string;
1331
1374
  /**
1332
- * Sets or retrieves the language code of the object.
1375
+ * The **`hreflang`** property of the HTMLLinkElement interface is used to indicate the language and the geographical targeting of a page.
1333
1376
  *
1334
1377
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/hreflang)
1335
1378
  */
1336
1379
  hreflang?: string;
1380
+ /**
1381
+ * The **`imageSizes`** property of the HTMLLinkElement interface indicates the size and conditions for the preloaded images defined by the HTMLLinkElement.imageSrcset property.
1382
+ *
1383
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/imageSizes)
1384
+ */
1337
1385
  imageSizes?: string;
1386
+ /**
1387
+ * The **`imageSrcset`** property of the HTMLLinkElement interface is a string which identifies one or more comma-separated **image candidate strings**.
1388
+ *
1389
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/imageSrcset)
1390
+ */
1338
1391
  imageSrcset?: string;
1339
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/integrity) */
1392
+ /**
1393
+ * The **`integrity`** property of the HTMLLinkElement interface is a string containing inline metadata that a browser can use to verify that a fetched resource has been delivered without unexpected manipulation.
1394
+ *
1395
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/integrity)
1396
+ */
1340
1397
  integrity?: string;
1341
1398
  /**
1342
- * Sets or retrieves the media type.
1399
+ * The **`media`** property of the HTMLLinkElement interface is a string representing a list of one or more media formats to which the resource applies.
1343
1400
  *
1344
1401
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/media)
1345
1402
  */
1346
1403
  media?: string;
1347
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/referrerPolicy) */
1404
+ /**
1405
+ * The **`referrerPolicy`** property of the HTMLLinkElement interface reflects the HTML `referrerpolicy` attribute of the resource.
1406
+ *
1407
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/referrerPolicy)
1408
+ */
1348
1409
  referrerPolicy?: ReferrerPolicy;
1349
1410
  /**
1350
- * Sets or retrieves the relationship between the object and the destination of the link.
1411
+ * The **`rel`** property of the HTMLLinkElement interface reflects the `rel` attribute.
1351
1412
  *
1352
1413
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/rel)
1353
1414
  */
1354
1415
  rel?: string;
1355
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/relList) */
1416
+ /**
1417
+ * The **`relList`** read-only property of the HTMLLinkElement interface reflects the `rel` attribute.
1418
+ *
1419
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/relList)
1420
+ */
1356
1421
  relList?: string;
1357
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/sizes) */
1422
+ /**
1423
+ * The **`sizes`** read-only property of the HTMLLinkElement interfaces defines the sizes of the icons for visual media contained in the resource.
1424
+ *
1425
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/sizes)
1426
+ */
1358
1427
  sizes?: string;
1359
1428
  /**
1360
- * Sets or retrieves the MIME type of the object.
1429
+ * The **`type`** property of the HTMLLinkElement interface is a string that reflects the MIME type of the linked resource.
1361
1430
  *
1362
1431
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/type)
1363
1432
  */
@@ -1365,7 +1434,7 @@ interface HtmlLinkAttributes<T> extends HTMLAttributes<T> {
1365
1434
  }
1366
1435
  interface HtmlMapAttributes<T> extends HTMLAttributes<T> {
1367
1436
  /**
1368
- * Sets or retrieves the name of the object.
1437
+ * The **`name`** property of the HTMLMapElement represents the unique name `<map>` element.
1369
1438
  *
1370
1439
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMapElement/name)
1371
1440
  */
@@ -1387,43 +1456,55 @@ interface HTMLMathElement extends MathMLElement {
1387
1456
  }
1388
1457
  interface HtmlMediaAttributes<T> extends HTMLAttributes<T> {
1389
1458
  /**
1390
- * Gets or sets a value that indicates whether to start playing the media automatically.
1459
+ * The **`HTMLMediaElement.autoplay`** property reflects the `autoplay` HTML attribute, indicating whether playback should automatically begin as soon as enough media is available to do so without interruption.
1391
1460
  *
1392
1461
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/autoplay)
1393
1462
  */
1394
1463
  autoplay?: boolean;
1395
1464
  /**
1396
- * Gets or sets a flag that indicates whether the client provides a set of controls for the media (in case the developer does not include controls for the player).
1465
+ * The **`HTMLMediaElement.controls`** property reflects the `controls` HTML attribute, which controls whether user interface controls for playing the media item will be displayed.
1397
1466
  *
1398
1467
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/controls)
1399
1468
  */
1400
1469
  controls?: boolean;
1401
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/crossOrigin) */
1470
+ /**
1471
+ * The **`HTMLMediaElement.crossOrigin`** property is the CORS setting for this media element.
1472
+ *
1473
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/crossOrigin)
1474
+ */
1402
1475
  crossOrigin?: HtmlCrossOrigin;
1403
1476
  /**
1404
- * Gets or sets the current playback position, in seconds.
1477
+ * The HTMLMediaElement interface's **`currentTime`** property specifies the current playback time in seconds.
1405
1478
  *
1406
1479
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/currentTime)
1407
1480
  */
1408
1481
  currentTime?: number;
1409
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/defaultMuted) */
1482
+ /**
1483
+ * The **`HTMLMediaElement.defaultMuted`** property reflects the `muted` HTML attribute, which indicates whether the media element's audio output should be muted by default.
1484
+ *
1485
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/defaultMuted)
1486
+ */
1410
1487
  defaultMuted?: boolean;
1411
1488
  /**
1412
- * Gets or sets the default playback rate when the user is not using fast forward or reverse for a video or audio resource.
1489
+ * The **`HTMLMediaElement.defaultPlaybackRate`** property indicates the default playback rate for the media.
1413
1490
  *
1414
1491
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/defaultPlaybackRate)
1415
1492
  */
1416
1493
  defaultPlaybackRate?: number;
1417
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/disableRemotePlayback) */
1494
+ /**
1495
+ * The **`disableRemotePlayback`** property of the HTMLMediaElement interface determines whether the media element is allowed to have a remote playback UI.
1496
+ *
1497
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/disableRemotePlayback)
1498
+ */
1418
1499
  disableRemotePlayback?: boolean;
1419
1500
  /**
1420
- * Gets or sets a flag to specify whether playback should restart after it completes.
1501
+ * The **`HTMLMediaElement.loop`** property reflects the `loop` HTML attribute, which controls whether the media element should start over when it reaches the end.
1421
1502
  *
1422
1503
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/loop)
1423
1504
  */
1424
1505
  loop?: boolean;
1425
1506
  /**
1426
- * Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted.
1507
+ * The **`HTMLMediaElement.muted`** property indicates whether the media element is muted.
1427
1508
  *
1428
1509
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/muted)
1429
1510
  */
@@ -1433,29 +1514,37 @@ interface HtmlMediaAttributes<T> extends HTMLAttributes<T> {
1433
1514
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/waitingforkey_event) */
1434
1515
  onWaitingForKey?: EventHandlerUnion<T, Event>;
1435
1516
  /**
1436
- * Gets or sets the current rate of speed for the media resource to play. This speed is expressed as a multiple of the normal speed of the media resource.
1517
+ * The **`HTMLMediaElement.playbackRate`** property sets the rate at which the media is being played back.
1437
1518
  *
1438
1519
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/playbackRate)
1439
1520
  */
1440
1521
  playbackRate?: number;
1441
1522
  /**
1442
- * Gets or sets a value indicating what data should be preloaded, if any.
1523
+ * The **`preload`** property of the HTMLMediaElement interface is a string that provides a hint to the browser about what the author thinks will lead to the best user experience.
1443
1524
  *
1444
1525
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/preload)
1445
1526
  */
1446
1527
  preload?: "" | "auto" | "metadata" | "none";
1447
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/preservesPitch) */
1528
+ /**
1529
+ * The **`HTMLMediaElement.preservesPitch`** property determines whether or not the browser should adjust the pitch of the audio to compensate for changes to the playback rate made by setting HTMLMediaElement.playbackRate.
1530
+ *
1531
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/preservesPitch)
1532
+ */
1448
1533
  preservesPitch?: boolean;
1449
1534
  /**
1450
- * The address or URL of the a media resource that is to be considered.
1535
+ * The **`HTMLMediaElement.src`** property reflects the value of the HTML media element's `src` attribute, which indicates the URL of a media resource to use in the element.
1451
1536
  *
1452
1537
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/src)
1453
1538
  */
1454
1539
  src?: string;
1455
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/srcObject) */
1540
+ /**
1541
+ * The **`srcObject`** property of the the source of the media associated with the HTMLMediaElement, or `null` if not assigned.
1542
+ *
1543
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/srcObject)
1544
+ */
1456
1545
  srcObject?: MediaProvider;
1457
1546
  /**
1458
- * Gets or sets the volume level for audio portions of the media element.
1547
+ * The **`HTMLMediaElement.volume`** property sets the volume at which the media will be played.
1459
1548
  *
1460
1549
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/volume)
1461
1550
  */
@@ -1468,21 +1557,25 @@ interface HtmlMenuAttributes<T> extends HTMLAttributes<T> {
1468
1557
  interface HtmlMetaAttributes<T> extends HTMLAttributes<T> {
1469
1558
  charset?: string;
1470
1559
  /**
1471
- * Gets or sets meta-information to associate with httpEquiv or name.
1560
+ * The **`HTMLMetaElement.content`** property gets or sets the `content` attribute of pragma directives and named meta data in conjunction with HTMLMetaElement.name or HTMLMetaElement.httpEquiv.
1472
1561
  *
1473
1562
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMetaElement/content)
1474
1563
  */
1475
1564
  content?: string;
1476
1565
  /**
1477
- * Gets or sets information used to bind the value of a content attribute of a meta element to an HTTP response header.
1566
+ * The **`HTMLMetaElement.httpEquiv`** property gets or sets the pragma directive or an HTTP response header name for the HTMLMetaElement.content attribute.
1478
1567
  *
1479
1568
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMetaElement/httpEquiv)
1480
1569
  */
1481
1570
  httpEquiv?: string;
1482
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMetaElement/media) */
1571
+ /**
1572
+ * The **`HTMLMetaElement.media`** property enables specifying the media for `theme-color` metadata.
1573
+ *
1574
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMetaElement/media)
1575
+ */
1483
1576
  media?: string;
1484
1577
  /**
1485
- * Sets or retrieves the value specified in the content attribute of the meta object.
1578
+ * The **`HTMLMetaElement.name`** property is used in combination with HTMLMetaElement.content to define the name-value pairs for the metadata of a document.
1486
1579
  *
1487
1580
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMetaElement/name)
1488
1581
  */
@@ -1490,22 +1583,46 @@ interface HtmlMetaAttributes<T> extends HTMLAttributes<T> {
1490
1583
  }
1491
1584
  interface HtmlMeterAttributes<T> extends HTMLAttributes<T> {
1492
1585
  form?: string;
1493
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/high) */
1586
+ /**
1587
+ * The **`high`** property of the HTMLMeterElement interface represents the high boundary of the meter element as a floating-point number.
1588
+ *
1589
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/high)
1590
+ */
1494
1591
  high?: number | string;
1495
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/low) */
1592
+ /**
1593
+ * The **`low`** property of the HTMLMeterElement interface represents the low boundary of the meter element as a floating-point number.
1594
+ *
1595
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/low)
1596
+ */
1496
1597
  low?: number | string;
1497
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/max) */
1598
+ /**
1599
+ * The **`max`** property of the HTMLMeterElement interface represents the maximum value of the meter element as a floating-point number.
1600
+ *
1601
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/max)
1602
+ */
1498
1603
  max?: number | string;
1499
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/min) */
1604
+ /**
1605
+ * The **`min`** property of the HTMLMeterElement interface represents the minimum value of the meter element as a floating-point number.
1606
+ *
1607
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/min)
1608
+ */
1500
1609
  min?: number | string;
1501
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/optimum) */
1610
+ /**
1611
+ * The **`optimum`** property of the HTMLMeterElement interface represents the optimum boundary of the meter element as a floating-point number.
1612
+ *
1613
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/optimum)
1614
+ */
1502
1615
  optimum?: number | string;
1503
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/value) */
1616
+ /**
1617
+ * The **`value`** property of the HTMLMeterElement interface represents the current value of the meter element as a floating-point number.
1618
+ *
1619
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLMeterElement/value)
1620
+ */
1504
1621
  value?: number | string;
1505
1622
  }
1506
1623
  interface HtmlQuoteAttributes<T> extends HTMLAttributes<T> {
1507
1624
  /**
1508
- * Sets or retrieves reference information about the object.
1625
+ * The **`cite`** property of the HTMLQuoteElement interface indicates the URL for the source of the quotation.
1509
1626
  *
1510
1627
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLQuoteElement/cite)
1511
1628
  */
@@ -1513,54 +1630,66 @@ interface HtmlQuoteAttributes<T> extends HTMLAttributes<T> {
1513
1630
  }
1514
1631
  interface HtmlObjectAttributes<T> extends HTMLAttributes<T> {
1515
1632
  /**
1516
- * Sets or retrieves the URL that references the data of the object.
1633
+ * The **`data`** property of the reflects the `data` HTML attribute, specifying the address of a resource's data.
1517
1634
  *
1518
1635
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLObjectElement/data)
1519
1636
  */
1520
1637
  data?: string;
1521
1638
  form?: string;
1522
1639
  /**
1523
- * Sets or retrieves the height of the object.
1640
+ * The **`height`** property of the reflects the `height` HTML attribute, specifying the displayed height of the resource in CSS pixels.
1524
1641
  *
1525
1642
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLObjectElement/height)
1526
1643
  */
1527
1644
  height?: number | string;
1528
1645
  /**
1529
- * Sets or retrieves the name of the object.
1646
+ * The **`name`** property of the reflects the `name` HTML attribute, specifying the name of the browsing context.
1530
1647
  *
1531
1648
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLObjectElement/name)
1532
1649
  */
1533
1650
  name?: string;
1534
1651
  /**
1535
- * Sets or retrieves the MIME type of the object.
1652
+ * The **`type`** property of the reflects the `type` HTML attribute, specifying the MIME type of the resource.
1536
1653
  *
1537
1654
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLObjectElement/type)
1538
1655
  */
1539
1656
  type?: string;
1540
1657
  /**
1541
- * Sets or retrieves the width of the object.
1658
+ * The **`width`** property of the reflects the `width` HTML attribute, specifying the displayed width of the resource in CSS pixels.
1542
1659
  *
1543
1660
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLObjectElement/width)
1544
1661
  */
1545
1662
  width?: number | string;
1546
1663
  }
1547
1664
  interface HtmlOlAttributes<T> extends HTMLAttributes<T> {
1548
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOListElement/reversed) */
1665
+ /**
1666
+ * The **`reversed`** property of the HTMLOListElement interface indicates order of a list.
1667
+ *
1668
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOListElement/reversed)
1669
+ */
1549
1670
  reversed?: boolean;
1550
1671
  /**
1551
- * The starting number.
1672
+ * The **`start`** property of the HTMLOListElement interface indicates starting value of the ordered list, with default value of 1.
1552
1673
  *
1553
1674
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOListElement/start)
1554
1675
  */
1555
1676
  start?: number | string;
1556
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOListElement/type) */
1677
+ /**
1678
+ * The **`type`** property of the HTMLOListElement interface indicates the kind of marker to be used to display ordered list.
1679
+ *
1680
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOListElement/type)
1681
+ */
1557
1682
  type?: "1" | "A" | "a" | "I" | "i";
1558
1683
  }
1559
1684
  interface HtmlOptgroupAttributes<T> extends HTMLAttributes<T> {
1560
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptGroupElement/disabled) */
1685
+ /**
1686
+ * The **`disabled`** property of the HTMLOptGroupElement interface is a boolean value that reflects the optgroup element's `disabled` attribute, which indicates whether the control is disabled.
1687
+ *
1688
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptGroupElement/disabled)
1689
+ */
1561
1690
  disabled?: boolean;
1562
1691
  /**
1563
- * Sets or retrieves a value that you can use to implement your own label functionality for the object.
1692
+ * The **`label`** property of the HTMLOptGroupElement interface is a string value that reflects the optgroup element's `label` attribute, which provides a textual label to the group of options.
1564
1693
  *
1565
1694
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptGroupElement/label)
1566
1695
  */
@@ -1568,45 +1697,59 @@ interface HtmlOptgroupAttributes<T> extends HTMLAttributes<T> {
1568
1697
  }
1569
1698
  interface HtmlOptionAttributes<T> extends HTMLAttributes<T> {
1570
1699
  /**
1571
- * Sets or retrieves the status of an option.
1700
+ * The **`defaultSelected`** property of the HTMLOptionElement interface specifies the default selected state of the element.
1572
1701
  *
1573
1702
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/defaultSelected)
1574
1703
  */
1575
1704
  defaultSelected?: boolean;
1576
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/disabled) */
1705
+ /**
1706
+ * The **`disabled`** property of the HTMLOptionElement is a boolean value that indicates whether the option element is unavailable to be selected.
1707
+ *
1708
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/disabled)
1709
+ */
1577
1710
  disabled?: boolean;
1578
1711
  /**
1579
- * Sets or retrieves a value that you can use to implement your own label functionality for the object.
1712
+ * The **`label`** property of the HTMLOptionElement represents the text displayed for an option in a select element or as part of a list of suggestions in a datalist element.
1580
1713
  *
1581
1714
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/label)
1582
1715
  */
1583
1716
  label?: string;
1584
1717
  /**
1585
- * Sets or retrieves whether the option in the list box is the default item.
1718
+ * The **`selected`** property of the HTMLOptionElement interface specifies the current selectedness of the element; that is, whether the option is selected or not.
1586
1719
  *
1587
1720
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/selected)
1588
1721
  */
1589
1722
  selected?: boolean;
1590
1723
  /**
1591
- * Sets or retrieves the value which is returned to the server when the form control is submitted.
1724
+ * The **`value`** property of the HTMLOptionElement interface represents the value of the option element as a string, or the empty string if no value is set.
1592
1725
  *
1593
1726
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOptionElement/value)
1594
1727
  */
1595
1728
  value?: number | string;
1596
1729
  }
1597
1730
  interface HtmlOutputAttributes<T> extends HTMLAttributes<T> {
1598
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/defaultValue) */
1731
+ /**
1732
+ * The **`defaultValue`** property of the HTMLOutputElement interface represents the default text content of this output element.
1733
+ *
1734
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/defaultValue)
1735
+ */
1599
1736
  defaultValue?: number | string;
1600
1737
  for?: string;
1601
1738
  form?: string;
1602
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/htmlFor) */
1739
+ /**
1740
+ * The **`htmlFor`** property of the HTMLOutputElement interface is a string containing a space-separated list of other elements' `id`s, indicating that those elements contributed input values to (or otherwise affected) the calculation.
1741
+ *
1742
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/htmlFor)
1743
+ */
1603
1744
  htmlFor?: string;
1604
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/name) */
1605
- name?: string;
1606
1745
  /**
1607
- * Returns the element's current value.
1746
+ * The **`name`** property of the HTMLOutputElement interface indicates the name of the output element.
1608
1747
  *
1609
- * Can be set, to change the value.
1748
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/name)
1749
+ */
1750
+ name?: string;
1751
+ /**
1752
+ * The **`value`** property of the HTMLOutputElement interface represents the value of the output element as a string, or the empty string if no value is set.
1610
1753
  *
1611
1754
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLOutputElement/value)
1612
1755
  */
@@ -1614,138 +1757,198 @@ interface HtmlOutputAttributes<T> extends HTMLAttributes<T> {
1614
1757
  }
1615
1758
  interface HtmlProgressAttributes<T> extends HTMLAttributes<T> {
1616
1759
  /**
1617
- * Defines the maximum, or "done" value for a progress element.
1760
+ * The **`max`** property of the HTMLProgressElement interface represents the upper bound of the progress element's range.
1618
1761
  *
1619
1762
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLProgressElement/max)
1620
1763
  */
1621
1764
  max?: number | string;
1622
1765
  /**
1623
- * Sets or gets the current value of a progress element. The value must be a non-negative number between 0 and the max value.
1766
+ * The **`value`** property of the HTMLProgressElement interface represents the current progress of the progress element.
1624
1767
  *
1625
1768
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLProgressElement/value)
1626
1769
  */
1627
1770
  value?: number | string;
1628
1771
  }
1629
1772
  interface HtmlScriptAttributes<T> extends HTMLAttributes<T> {
1630
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/async) */
1773
+ /**
1774
+ * The **`async`** property of the HTMLScriptElement interface is a boolean value that controls how the script should be executed.
1775
+ *
1776
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/async)
1777
+ */
1631
1778
  async?: boolean;
1632
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/blocking) */
1779
+ /**
1780
+ * The **`blocking`** property of the HTMLScriptElement interface is a string indicating that certain operations should be blocked on the fetching of the script.
1781
+ *
1782
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/blocking)
1783
+ */
1633
1784
  blocking?: string;
1634
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/crossOrigin) */
1785
+ /**
1786
+ * The **`crossOrigin`** property of the HTMLScriptElement interface reflects the CORS settings for the script element.
1787
+ *
1788
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/crossOrigin)
1789
+ */
1635
1790
  crossOrigin?: HtmlCrossOrigin;
1636
1791
  /**
1637
- * Sets or retrieves the status of the script.
1792
+ * The **`defer`** property of the HTMLScriptElement interface is a boolean value that controls how the script should be executed.
1638
1793
  *
1639
1794
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/defer)
1640
1795
  */
1641
1796
  defer?: boolean;
1642
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/fetchPriority) */
1797
+ /**
1798
+ * The **`fetchPriority`** property of the HTMLScriptElement interface represents a hint to the browser indicating how it should prioritize fetching an external script relative to other external scripts.
1799
+ *
1800
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/fetchPriority)
1801
+ */
1643
1802
  fetchPriority?: string;
1644
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/integrity) */
1803
+ /**
1804
+ * The **`integrity`** property of the HTMLScriptElement interface is a string that contains inline metadata that a browser can use to verify that a fetched resource has been delivered without unexpected manipulation.
1805
+ *
1806
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/integrity)
1807
+ */
1645
1808
  integrity?: string;
1646
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/noModule) */
1809
+ /**
1810
+ * The **`noModule`** property of the HTMLScriptElement interface is a boolean value that indicates whether the script should be executed in browsers that support ES modules.
1811
+ *
1812
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/noModule)
1813
+ */
1647
1814
  noModule?: boolean;
1648
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/referrerPolicy) */
1815
+ /**
1816
+ * The **`referrerPolicy`** property of the `referrerpolicy` of the script element, which defines how the referrer is set when fetching the script and any scripts it imports.
1817
+ *
1818
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/referrerPolicy)
1819
+ */
1649
1820
  referrerPolicy?: ReferrerPolicy;
1650
1821
  /**
1651
- * Retrieves the URL to an external file that contains the source code or data.
1822
+ * The **`src`** property of the HTMLScriptElement interface is a string representing the URL of an external script; this can be used as an alternative to embedding a script directly within a document.
1652
1823
  *
1653
1824
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/src)
1654
1825
  */
1655
1826
  src?: string;
1656
1827
  /**
1657
- * Sets or retrieves the MIME type for the associated scripting engine.
1828
+ * The **`type`** property of the HTMLScriptElement interface is a string that reflects the type of the script.
1658
1829
  *
1659
1830
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLScriptElement/type)
1660
1831
  */
1661
1832
  type?: string;
1662
1833
  }
1663
1834
  interface HtmlSelectAttributes<T> extends HTMLAttributes<T> {
1664
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/autocomplete) */
1835
+ /**
1836
+ * The **`autocomplete`** property of the HTMLSelectElement interface indicates whether the value of the control can be automatically completed by the browser.
1837
+ *
1838
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/autocomplete)
1839
+ */
1665
1840
  autocomplete?: AutoFill;
1666
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/disabled) */
1841
+ /**
1842
+ * The **`HTMLSelectElement.disabled`** property is a boolean value that reflects the `disabled` HTML attribute, which indicates whether the control is disabled.
1843
+ *
1844
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/disabled)
1845
+ */
1667
1846
  disabled?: boolean;
1668
1847
  form?: string;
1669
1848
  /**
1670
- * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.
1849
+ * The **`multiple`** property of the HTMLSelectElement interface specifies that the user may select more than one option from the list of options.
1671
1850
  *
1672
1851
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/multiple)
1673
1852
  */
1674
1853
  multiple?: boolean;
1675
1854
  /**
1676
- * Sets or retrieves the name of the object.
1855
+ * The **`name`** property of the HTMLSelectElement interface indicates the name of the select element.
1677
1856
  *
1678
1857
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/name)
1679
1858
  */
1680
1859
  name?: string;
1681
1860
  /**
1682
- * When present, marks an element that can't be submitted without a value.
1861
+ * The **`required`** property of the HTMLSelectElement interface specifies that the user must select an option with a non-empty string value before submitting a form.
1683
1862
  *
1684
1863
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/required)
1685
1864
  */
1686
1865
  required?: boolean;
1687
1866
  /**
1688
- * Sets or retrieves the index of the selected option in a select object.
1867
+ * The **`selectedIndex`** property of the HTMLSelectElement interface is the numeric index of the first selected option element in a select element, if any, or `−1` if no `<option>` is selected.
1689
1868
  *
1690
1869
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/selectedIndex)
1691
1870
  */
1692
1871
  selectedIndex?: number;
1693
1872
  /**
1694
- * Sets or retrieves the number of rows in the list box.
1873
+ * The **`size`** property of the HTMLSelectElement interface specifies the number of options, or rows, that should be visible at one time.
1695
1874
  *
1696
1875
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/size)
1697
1876
  */
1698
1877
  size?: number | string;
1699
1878
  /**
1700
- * Sets or retrieves the value which is returned to the server when the form control is submitted.
1879
+ * The **`HTMLSelectElement.value`** property contains the value of the first selected option element associated with this select element.
1701
1880
  *
1702
1881
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSelectElement/value)
1703
1882
  */
1704
1883
  value?: number | string;
1705
1884
  }
1706
1885
  interface HtmlSlotAttributes<T> extends HTMLAttributes<T> {
1707
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSlotElement/name) */
1886
+ /**
1887
+ * The **`name`** property of the HTMLSlotElement interface returns or sets the slot name.
1888
+ *
1889
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSlotElement/name)
1890
+ */
1708
1891
  name?: string;
1709
1892
  }
1710
1893
  interface HtmlSourceAttributes<T> extends HTMLAttributes<T> {
1711
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/height) */
1894
+ /**
1895
+ * The **`height`** property of the HTMLSourceElement interface is a non-negative number indicating the height of the image resource in CSS pixels.
1896
+ *
1897
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/height)
1898
+ */
1712
1899
  height?: number;
1713
1900
  /**
1714
- * Gets or sets the intended media type of the media source.
1901
+ * The **`media`** property of the HTMLSourceElement interface is a string representing the intended destination medium for the resource.
1715
1902
  *
1716
1903
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/media)
1717
1904
  */
1718
1905
  media?: string;
1719
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/sizes) */
1906
+ /**
1907
+ * The **`sizes`** property of the HTMLSourceElement interface is a string representing a list of one or more sizes, representing sizes between breakpoints, to which the resource applies.
1908
+ *
1909
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/sizes)
1910
+ */
1720
1911
  sizes?: string;
1721
1912
  /**
1722
- * The address or URL of the a media resource that is to be considered.
1913
+ * The **`src`** property of the HTMLSourceElement interface is a string indicating the URL of a media resource to use as the source for the element.
1723
1914
  *
1724
1915
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/src)
1725
1916
  */
1726
1917
  src?: string;
1727
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/srcset) */
1918
+ /**
1919
+ * The **`srcset`** property of the HTMLSourceElement interface is a string containing a comma-separated list of candidate images.
1920
+ *
1921
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/srcset)
1922
+ */
1728
1923
  srcset?: string;
1729
1924
  /**
1730
- * Gets or sets the MIME type of a media resource.
1925
+ * The **`type`** property of the HTMLSourceElement interface is a string representing the MIME type of the media resource.
1731
1926
  *
1732
1927
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/type)
1733
1928
  */
1734
1929
  type?: string;
1735
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/width) */
1930
+ /**
1931
+ * The **`width`** property of the HTMLSourceElement interface is a non-negative number indicating the width of the image resource in CSS pixels.
1932
+ *
1933
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLSourceElement/width)
1934
+ */
1736
1935
  width?: number;
1737
1936
  }
1738
1937
  interface HtmlStyleAttributes<T> extends HTMLAttributes<T> {
1739
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLStyleElement/blocking) */
1938
+ /**
1939
+ * The **`blocking`** property of the HTMLStyleElement interface is a string indicating that certain operations should be blocked on the fetching of critical subresources.
1940
+ *
1941
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLStyleElement/blocking)
1942
+ */
1740
1943
  blocking?: string;
1741
1944
  /**
1742
- * Enables or disables the style sheet.
1945
+ * The **`HTMLStyleElement.disabled`** property can be used to get and set whether the stylesheet is disabled (`true`) or not (`false`).
1743
1946
  *
1744
1947
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLStyleElement/disabled)
1745
1948
  */
1746
1949
  disabled?: boolean;
1747
1950
  /**
1748
- * Sets or retrieves the media type.
1951
+ * The **`HTMLStyleElement.media`** property specifies the intended destination medium for style information.
1749
1952
  *
1750
1953
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLStyleElement/media)
1751
1954
  */
@@ -1753,126 +1956,163 @@ interface HtmlStyleAttributes<T> extends HTMLAttributes<T> {
1753
1956
  }
1754
1957
  interface HtmlTdAttributes<T> extends HTMLAttributes<T> {
1755
1958
  /**
1756
- * Sets or retrieves abbreviated text for the object.
1959
+ * The **`abbr`** property of the HTMLTableCellElement interface indicates an abbreviation associated with the cell.
1757
1960
  *
1758
1961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/abbr)
1759
1962
  */
1760
1963
  abbr?: string;
1761
1964
  /**
1762
- * Sets or retrieves the number columns in the table that the object should span.
1965
+ * The **`colSpan`** read-only property of the HTMLTableCellElement interface represents the number of columns this cell must span; this lets the cell occupy space across multiple columns of the table.
1763
1966
  *
1764
1967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/colSpan)
1765
1968
  */
1766
1969
  colSpan?: number | string;
1767
1970
  /**
1768
- * Sets or retrieves a list of header cells that provide information for the object.
1971
+ * The **`headers`** property of the HTMLTableCellElement interface contains a list of IDs of th elements that are _headers_ for this specific cell.
1769
1972
  *
1770
1973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/headers)
1771
1974
  */
1772
1975
  headers?: string;
1773
1976
  /**
1774
- * Sets or retrieves how many rows in a table the cell should span.
1977
+ * The **`rowSpan`** read-only property of the HTMLTableCellElement interface represents the number of rows this cell must span; this lets the cell occupy space across multiple rows of the table.
1775
1978
  *
1776
1979
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/rowSpan)
1777
1980
  */
1778
1981
  rowSpan?: number | string;
1779
1982
  /**
1780
- * Sets or retrieves the group of cells in a table to which the object's information applies.
1983
+ * The **`scope`** property of the HTMLTableCellElement interface indicates the scope of a th cell.
1781
1984
  *
1782
1985
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/scope)
1783
1986
  */
1784
1987
  scope?: "col" | "colgroup" | "row" | "rowgroup";
1785
1988
  }
1786
1989
  interface HtmlTemplateAttributes<T extends HTMLTemplateElement> extends HTMLAttributes<T> {
1787
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootClonable) */
1990
+ /**
1991
+ * The **`shadowRootClonable`** property reflects the value of the `shadowrootclonable` attribute of the associated `<template>` element.
1992
+ *
1993
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootClonable)
1994
+ */
1788
1995
  shadowRootClonable?: boolean;
1789
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootDelegatesFocus) */
1996
+ /**
1997
+ * The **`shadowRootDelegatesFocus`** property of the HTMLTemplateElement interface reflects the value of the `shadowrootdelegatesfocus` attribute of the associated `<template>` element.
1998
+ *
1999
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootDelegatesFocus)
2000
+ */
1790
2001
  shadowRootDelegatesFocus?: boolean;
1791
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootMode) */
2002
+ /**
2003
+ * The **`shadowRootMode`** property of the HTMLTemplateElement interface reflects the value of the `shadowrootmode` attribute of the associated `<template>` element.
2004
+ *
2005
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootMode)
2006
+ */
1792
2007
  shadowRootMode?: string;
1793
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootSerializable) */
2008
+ /**
2009
+ * The **`shadowRootSerializable`** property reflects the value of the `shadowrootserializable` attribute of the associated `<template>` element.
2010
+ *
2011
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTemplateElement/shadowRootSerializable)
2012
+ */
1794
2013
  shadowRootSerializable?: boolean;
1795
2014
  }
1796
2015
  interface HtmlTextareaAttributes<T> extends HTMLAttributes<T> {
1797
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/autocomplete) */
2016
+ /**
2017
+ * The **`autocomplete`** property of the HTMLTextAreaElement interface indicates whether the value of the control can be automatically completed by the browser.
2018
+ *
2019
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/autocomplete)
2020
+ */
1798
2021
  autocomplete?: AutoFill;
1799
2022
  children?: "Error: Use value property instead. See https://lit.dev/docs/templates/expressions/#invalid-locations";
1800
2023
  /**
1801
- * Sets or retrieves the width of the object.
2024
+ * The **`cols`** property of the HTMLTextAreaElement interface is a positive integer representing the visible width of the multi-line text control, in average character widths.
1802
2025
  *
1803
2026
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/cols)
1804
2027
  */
1805
2028
  cols?: number | string;
1806
2029
  /**
1807
- * Sets or retrieves the initial contents of the object.
2030
+ * The **`defaultValue`** property of the HTMLTextAreaElement interface represents the default text content of this text area.
1808
2031
  *
1809
2032
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/defaultValue)
1810
2033
  */
1811
2034
  defaultValue?: number | string;
2035
+ /**
2036
+ * The **`dirName`** property of the HTMLTextAreaElement interface is the directionality of the element.
2037
+ *
2038
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/dirName)
2039
+ */
1812
2040
  dirName?: string;
1813
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/disabled) */
2041
+ /**
2042
+ * The **`disabled`** property of the HTMLTextAreaElement interface indicates whether this multi-line text control is disabled and cannot be interacted with.
2043
+ *
2044
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/disabled)
2045
+ */
1814
2046
  disabled?: boolean;
1815
2047
  form?: string;
1816
2048
  /**
1817
- * Sets or retrieves the maximum number of characters that the user can enter in a text control.
2049
+ * The **`maxLength`** property of the HTMLTextAreaElement interface indicates the maximum number of characters (in UTF-16 code units) allowed to be entered for the value of the textarea element, and the maximum number of characters allowed for the value to be valid.
1818
2050
  *
1819
2051
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/maxLength)
1820
2052
  */
1821
2053
  maxLength?: number | string;
1822
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/minLength) */
2054
+ /**
2055
+ * The **`minLength`** property of the HTMLTextAreaElement interface indicates the minimum number of characters (in UTF-16 code units) required for the value of the textarea element to be valid.
2056
+ *
2057
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/minLength)
2058
+ */
1823
2059
  minLength?: number | string;
1824
2060
  /**
1825
- * Sets or retrieves the name of the object.
2061
+ * The **`name`** property of the HTMLTextAreaElement interface indicates the name of the textarea element.
1826
2062
  *
1827
2063
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/name)
1828
2064
  */
1829
2065
  name?: string;
1830
2066
  /**
1831
- * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.
2067
+ * The **`placeholder`** property of the HTMLTextAreaElement interface represents a hint to the user of what can be entered in the control.
1832
2068
  *
1833
2069
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/placeholder)
1834
2070
  */
1835
2071
  placeholder?: string;
1836
2072
  /**
1837
- * Sets or retrieves the value indicated whether the content of the object is read-only.
2073
+ * The **`readOnly`** property of the HTMLTextAreaElement interface indicates that the user cannot modify the value of the control.
1838
2074
  *
1839
2075
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/readOnly)
1840
2076
  */
1841
2077
  readOnly?: boolean;
1842
2078
  /**
1843
- * When present, marks an element that can't be submitted without a value.
2079
+ * The **`required`** property of the HTMLTextAreaElement interface specifies that the user must fill in a value before submitting a form.
1844
2080
  *
1845
2081
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/required)
1846
2082
  */
1847
2083
  required?: boolean;
1848
2084
  /**
1849
- * Sets or retrieves the number of horizontal rows contained in the object.
2085
+ * The **`rows`** property of the HTMLTextAreaElement interface is a positive integer representing the visible text lines of the text control.
1850
2086
  *
1851
2087
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/rows)
1852
2088
  */
1853
2089
  rows?: number | string;
1854
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/selectionDirection) */
2090
+ /**
2091
+ * <!-- --> The **`selectionDirection`** property of the HTMLTextAreaElement interface specifies the current direction of the selection.
2092
+ *
2093
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/selectionDirection)
2094
+ */
1855
2095
  selectionDirection?: "backward" | "forward" | "none";
1856
2096
  /**
1857
- * Gets or sets the end position or offset of a text selection.
2097
+ * The **`selectionEnd`** property of the HTMLTextAreaElement interface specifies the end position of the current text selection in a textarea element.
1858
2098
  *
1859
2099
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/selectionEnd)
1860
2100
  */
1861
2101
  selectionEnd?: number;
1862
2102
  /**
1863
- * Gets or sets the starting position or offset of a text selection.
2103
+ * The **`selectionStart`** property of the HTMLTextAreaElement interface specifies the start position of the current text selection in a textarea element.
1864
2104
  *
1865
2105
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/selectionStart)
1866
2106
  */
1867
2107
  selectionStart?: number;
1868
2108
  /**
1869
- * Retrieves or sets the text in the entry field of the textArea element.
2109
+ * The **`value`** property of the HTMLTextAreaElement interface represents the value of the textarea element as a string, which is an empty string if the widget contains no content.
1870
2110
  *
1871
2111
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/value)
1872
2112
  */
1873
2113
  value?: number | string;
1874
2114
  /**
1875
- * Sets or retrieves how to handle wordwrapping in the object.
2115
+ * The **`wrap`** property of the HTMLTextAreaElement interface indicates how the control should wrap the value for form submission.
1876
2116
  *
1877
2117
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTextAreaElement/wrap)
1878
2118
  */
@@ -1880,58 +2120,86 @@ interface HtmlTextareaAttributes<T> extends HTMLAttributes<T> {
1880
2120
  }
1881
2121
  interface HtmlThAttributes<T> extends HTMLAttributes<T> {
1882
2122
  /**
1883
- * Sets or retrieves abbreviated text for the object.
2123
+ * The **`abbr`** property of the HTMLTableCellElement interface indicates an abbreviation associated with the cell.
1884
2124
  *
1885
2125
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/abbr)
1886
2126
  */
1887
2127
  abbr?: string;
1888
2128
  /**
1889
- * Sets or retrieves the number columns in the table that the object should span.
2129
+ * The **`colSpan`** read-only property of the HTMLTableCellElement interface represents the number of columns this cell must span; this lets the cell occupy space across multiple columns of the table.
1890
2130
  *
1891
2131
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/colSpan)
1892
2132
  */
1893
2133
  colSpan?: number | string;
1894
2134
  /**
1895
- * Sets or retrieves a list of header cells that provide information for the object.
2135
+ * The **`headers`** property of the HTMLTableCellElement interface contains a list of IDs of th elements that are _headers_ for this specific cell.
1896
2136
  *
1897
2137
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/headers)
1898
2138
  */
1899
2139
  headers?: string;
1900
2140
  /**
1901
- * Sets or retrieves how many rows in a table the cell should span.
2141
+ * The **`rowSpan`** read-only property of the HTMLTableCellElement interface represents the number of rows this cell must span; this lets the cell occupy space across multiple rows of the table.
1902
2142
  *
1903
2143
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/rowSpan)
1904
2144
  */
1905
2145
  rowSpan?: number | string;
1906
2146
  /**
1907
- * Sets or retrieves the group of cells in a table to which the object's information applies.
2147
+ * The **`scope`** property of the HTMLTableCellElement interface indicates the scope of a th cell.
1908
2148
  *
1909
2149
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTableCellElement/scope)
1910
2150
  */
1911
2151
  scope?: "col" | "colgroup" | "row" | "rowgroup";
1912
2152
  }
1913
2153
  interface HtmlTimeAttributes<T> extends HTMLAttributes<T> {
1914
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTimeElement/dateTime) */
2154
+ /**
2155
+ * The **`dateTime`** property of the HTMLTimeElement interface is a string that reflects the `datetime` HTML attribute, containing a machine-readable form of the element's date and time value.
2156
+ *
2157
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTimeElement/dateTime)
2158
+ */
1915
2159
  dateTime?: string;
1916
2160
  }
1917
2161
  interface HtmlTrackAttributes<T> extends HTMLAttributes<T> {
1918
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/default) */
2162
+ /**
2163
+ * The **`default`** property of the HTMLTrackElement interface represents whether the track will be enabled if the user's preferences do not indicate that another track would be more appropriate.
2164
+ *
2165
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/default)
2166
+ */
1919
2167
  default?: boolean;
1920
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/kind) */
2168
+ /**
2169
+ * The **`kind`** property of the HTMLTrackElement interface represents the type of track, or how the text track is meant to be used.
2170
+ *
2171
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/kind)
2172
+ */
1921
2173
  kind?: "captions" | "chapters" | "descriptions" | "metadata" | "subtitles";
1922
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/label) */
2174
+ /**
2175
+ * The **`label`** property of the HTMLTrackElement represents the user-readable title displayed when listing subtitle, caption, and audio descriptions for a track.
2176
+ *
2177
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/label)
2178
+ */
1923
2179
  label?: string;
1924
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/src) */
2180
+ /**
2181
+ * The **`src`** property of the HTMLTrackElement interface reflects the value of the track element's `src` attribute, which indicates the URL of the text track's data.
2182
+ *
2183
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/src)
2184
+ */
1925
2185
  src?: string;
1926
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/srclang) */
2186
+ /**
2187
+ * The **`srclang`** property of the HTMLTrackElement interface reflects the value of the track element's `srclang` attribute or the empty string if not defined.
2188
+ *
2189
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLTrackElement/srclang)
2190
+ */
1927
2191
  srclang?: string;
1928
2192
  }
1929
2193
  interface HtmlVideoAttributes<T> extends HtmlMediaAttributes<T> {
1930
- /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/disablePictureInPicture) */
2194
+ /**
2195
+ * The HTMLVideoElement **`disablePictureInPicture`** property reflects the HTML attribute indicating whether the picture-in-picture feature is disabled for the current element.
2196
+ *
2197
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/disablePictureInPicture)
2198
+ */
1931
2199
  disablePictureInPicture?: boolean;
1932
2200
  elementTiming?: string;
1933
2201
  /**
1934
- * Gets or sets the height of the video element.
2202
+ * The **`height`** property of the HTMLVideoElement interface returns an integer that reflects the `height` attribute of the video element, specifying the displayed height of the resource in CSS pixels.
1935
2203
  *
1936
2204
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/height)
1937
2205
  */
@@ -1943,13 +2211,13 @@ interface HtmlVideoAttributes<T> extends HtmlMediaAttributes<T> {
1943
2211
  /** Gets or sets the playsinline of the video element. for example, On iPhone, video elements will now be allowed to play inline, and will not automatically enter fullscreen mode when playback begins. */
1944
2212
  playsInline?: boolean;
1945
2213
  /**
1946
- * Gets or sets a URL of an image to display, for example, like a movie poster. This can be a still frame from the video, or another image if no video data is available.
2214
+ * The **`poster`** property of the HTMLVideoElement interface is a string that reflects the URL for an image to be shown while no video data is available.
1947
2215
  *
1948
2216
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/poster)
1949
2217
  */
1950
2218
  poster?: string;
1951
2219
  /**
1952
- * Gets or sets the width of the video element.
2220
+ * The **`width`** property of the HTMLVideoElement interface returns an integer that reflects the `width` attribute of the video element, specifying the displayed width of the resource in CSS pixels.
1953
2221
  *
1954
2222
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLVideoElement/width)
1955
2223
  */
@@ -2264,6 +2532,11 @@ interface SvgForeignObjectAttributes<T> extends SvgNewViewportAttributes<T>, Svg
2264
2532
  interface SvgGAttributes<T> extends SvgContainerElementAttributes<T>, SvgConditionalProcessingAttributes, SvgExternalResourceAttributes, SvgStylableAttributes, SvgTransformableAttributes, Pick<SvgPresentationAttributes, "display" | "visibility"> {
2265
2533
  }
2266
2534
  interface SvgImageAttributes<T> extends SvgNewViewportAttributes<T>, SvgGraphicsElementAttributes<T>, SvgConditionalProcessingAttributes, SvgStylableAttributes, SvgTransformableAttributes, Pick<SvgPresentationAttributes, "color-profile" | "image-rendering"> {
2535
+ /**
2536
+ * The **`crossOrigin`** property of the SVGImageElement interface is a string which specifies the Cross-Origin Resource Sharing (CORS) setting to use when retrieving the image.
2537
+ *
2538
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGImageElement/crossOrigin)
2539
+ */
2267
2540
  crossOrigin?: HtmlCrossOrigin;
2268
2541
  elementTiming?: string;
2269
2542
  height?: number | string;
@@ -2349,6 +2622,11 @@ interface SvgSvgAttributes<T> extends SvgContainerElementAttributes<T>, SvgNewVi
2349
2622
  baseProfile?: string;
2350
2623
  contentScriptType?: string;
2351
2624
  contentStyleType?: string;
2625
+ /**
2626
+ * The **`currentScale`** property of the SVGSVGElement interface reflects the current scale factor relative to the initial view to take into account user magnification and panning operations on the outermost svg element.
2627
+ *
2628
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SVGSVGElement/currentScale)
2629
+ */
2352
2630
  currentScale?: number;
2353
2631
  height?: number | string;
2354
2632
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/afterprint_event) */