@pfern/elements 0.1.0

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 (4) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +255 -0
  3. package/elements.js +1931 -0
  4. package/package.json +38 -0
package/elements.js ADDED
@@ -0,0 +1,1931 @@
1
+ /** expressive/elements.js
2
+ *
3
+ * Minimalist declarative UI framework based on pure functional composition.
4
+ *
5
+ * Purpose:
6
+ * - All UI defined as pure functions that return declarative arrays.
7
+ * - Directly composable into a symbolic tree compatible with Lisp-like dialects.
8
+ * - No internal mutable state required: DOM itself is the substrate for state.
9
+ * - No JSX, no keys, no reconciler heuristics — just pure structure + replacement.
10
+ *
11
+ */
12
+
13
+ export const DEBUG =
14
+ typeof process !== 'undefined'
15
+ && process.env
16
+ && (process.env.ELEMENTSJS_DEBUG?.toLowerCase() === 'true'
17
+ || process.env.NODE_ENV === 'development')
18
+
19
+ const svgNS = 'http://www.w3.org/2000/svg'
20
+
21
+ /**
22
+ * Maps vnode instances to their current root DOM element,
23
+ * allowing accurate replacement when the same vnode is re-invoked.
24
+ *
25
+ * @type {WeakMap<any[], HTMLElement>}
26
+ */
27
+ const rootMap = new WeakMap()
28
+
29
+ const isNodeEnv = typeof document === 'undefined'
30
+
31
+ /**
32
+ * Determines whether two nodes have changed enough to require replacement.
33
+ * Compares type, string value, or element tag.
34
+ *
35
+ * @param {*} a - Previous vnode
36
+ * @param {*} b - New vnode
37
+ * @returns {boolean} - True if nodes are meaningfully different
38
+ */
39
+ const changed = (a, b) =>
40
+ typeof a !== typeof b
41
+ || typeof a === 'string' && a !== b
42
+ || Array.isArray(a) && Array.isArray(b) && a[0] !== b[0]
43
+
44
+ /**
45
+ * Computes a patch object describing how to transform tree `a` into tree `b`.
46
+ * Used by `render` to apply minimal updates to the DOM.
47
+ *
48
+ * @param {*} a - Previous vnode
49
+ * @param {*} b - New vnode
50
+ * @returns {Object} - Patch object with type and content
51
+ */
52
+ const diffTree = (a, b) => {
53
+ if (!a) return { type: 'CREATE', newNode: b }
54
+ if (!b) return { type: 'REMOVE' }
55
+ if (changed(a, b)) return { type: 'REPLACE', newNode: b }
56
+ if (Array.isArray(a) && Array.isArray(b)) {
57
+ return {
58
+ type: 'UPDATE',
59
+ children: diffChildren(a.slice(2), b.slice(2))
60
+ }
61
+ }
62
+ }
63
+
64
+
65
+ /**
66
+ * Compares the children of two vnodes and returns patch list.
67
+ *
68
+ * @param {Array} aChildren - Previous vnode children
69
+ * @param {Array} bChildren - New vnode children
70
+ * @returns {Array} patches - One per child node
71
+ */const diffChildren = (aChildren, bChildren) => {
72
+ const patches = []
73
+ const len = Math.max(aChildren.length, bChildren.length)
74
+ for (let i = 0; i < len; i++) {
75
+ patches[i] = diffTree(aChildren[i], bChildren[i])
76
+ }
77
+ return patches
78
+ }
79
+
80
+ /**
81
+ * Assigns attributes, styles, and event handlers to a DOM element.
82
+ *
83
+ * - Event listeners may return a vnode array to trigger a subtree replacement.
84
+ * - For `onsubmit`, `oninput`, and `onchange`, `preventDefault()` is called automatically
85
+ * *if* the listener returns a vnode (to support declarative form updates).
86
+ * - Handlers for these event types receive `(elements, event)` as arguments,
87
+ * where `elements` is `event.target.elements` if available.
88
+ *
89
+ * @param {HTMLElement} el - The DOM element to receive props
90
+ * @param {Object} props - Attributes and event listeners to assign
91
+ */
92
+ const assignProperties = (el, props) =>
93
+ Object.entries(props).forEach(([key, value]) => {
94
+ if (key.startsWith('on') && typeof value === 'function') {
95
+ el[key] = (...args) => {
96
+ let target = el
97
+ while (target && !target.__root) target = target.parentNode
98
+ if (!target) return
99
+
100
+ try {
101
+ const event = args[0]
102
+ const isFormEvent = /^(oninput|onsubmit|onchange)$/.test(key)
103
+ const elements = isFormEvent && event?.target?.elements || null
104
+
105
+ const result = isFormEvent
106
+ ? value.call(el, elements, event)
107
+ : value.call(el, event)
108
+
109
+ if (isFormEvent && result !== undefined) {
110
+ event.preventDefault()
111
+ }
112
+
113
+ if (DEBUG && result === undefined) {
114
+ console.warn(
115
+ `Listener '${key}' on <${el.tagName.toLowerCase()}> returned nothing.\n`
116
+ + 'If you intended a UI update, return a vnode array like: div({}, ...)'
117
+ )
118
+ }
119
+
120
+ if (DEBUG && result !== undefined && !Array.isArray(result)) {
121
+ isFormEvent && event.preventDefault()
122
+ DEBUG && console.warn(
123
+ `Listener '${key}' on <${el.tagName.toLowerCase()}> returned "${result}".\n`
124
+ + 'If you intended a UI update, return a vnode array like: div({}, ...).\n'
125
+ + 'Otherwise, return undefined (or nothing) for native event listener behavior.'
126
+ )
127
+ }
128
+
129
+ if (Array.isArray(result)) {
130
+ const parent = target.parentNode
131
+ if (!parent) return
132
+
133
+ const replacement = renderTree(result, true)
134
+ parent.replaceChild(replacement, target)
135
+
136
+ replacement.__vnode = result
137
+ replacement.__root = true
138
+ rootMap.set(result, replacement)
139
+ }
140
+ } catch (error) {
141
+ console.error(error)
142
+ }
143
+ }
144
+ } else if (key === 'style' && typeof value === 'object') {
145
+ Object.assign(el.style, value)
146
+ } else if (key === 'innerHTML') {
147
+ el.innerHTML = value
148
+ } else {
149
+ try {
150
+ if (el.namespaceURI === svgNS) {
151
+ el.setAttributeNS(null, key, value)
152
+ } else {
153
+ el.setAttribute(key, value)
154
+ }
155
+ } catch {
156
+ DEBUG && console.warn(
157
+ `Illegal DOM property assignment for ${el.tagName}: ${key}: ${value}`)
158
+ }
159
+ }
160
+ })
161
+
162
+ /**
163
+ * Recursively builds a real DOM tree from a declarative vnode.
164
+ * Marks root nodes and tracks state/element associations.
165
+ *
166
+ * @param {*} node - Vnode to render
167
+ * @param {boolean} isRoot - Whether this is a root component
168
+ * @returns {Node} - Real DOM node
169
+ */
170
+ const renderTree = (node, isRoot = true) => {
171
+ if (typeof node === 'string' || typeof node === 'number') {
172
+ return isNodeEnv ? node : document.createTextNode(node)
173
+ }
174
+
175
+ if (!node || node.length === 0) {
176
+ return document.createComment('Empty vnode')
177
+ }
178
+
179
+ if (!Array.isArray(node)) {
180
+ console.error('Malformed vnode (not an array):', node)
181
+ return document.createComment('Invalid vnode')
182
+ }
183
+
184
+ if (Array.isArray(node) && node[0] === 'wrap') {
185
+ const [_tag, _props, child] = node
186
+ return renderTree(child, true)
187
+ }
188
+
189
+ const [tag, props = {}, ...children] = node
190
+
191
+ if (typeof tag !== 'string') {
192
+ console.error('Malformed vnode (non-string tag):', node)
193
+ return document.createComment('Invalid vnode')
194
+ }
195
+
196
+ let el =
197
+ tag === 'html' ? document.documentElement
198
+ : tag === 'head' ? document.head
199
+ : tag === 'body' ? document.body
200
+ : svgTagNames.includes(tag)
201
+ ? document.createElementNS(svgNS, tag)
202
+ : document.createElement(tag)
203
+
204
+ el.__vnode = node
205
+
206
+ if (isRoot && tag !== 'html' && tag !== 'head' && tag !== 'body') {
207
+ el.__root = true
208
+ rootMap.set(node, el)
209
+ }
210
+
211
+ assignProperties(el, props)
212
+
213
+ children.forEach(child => {
214
+ const childEl = renderTree(child, false)
215
+ el.appendChild(childEl)
216
+ })
217
+
218
+ return el
219
+ }
220
+
221
+ /**
222
+ * Applies a patch object to a DOM subtree.
223
+ * Handles creation, removal, replacement, and child updates.
224
+ *
225
+ * @param {HTMLElement} parent - DOM node to mutate
226
+ * @param {Object} patch - Patch object from diffTree
227
+ * @param {number} [index=0] - Child index to apply update to
228
+ */
229
+ const applyPatch = (parent, patch, index = 0) => {
230
+ if (!patch) return
231
+ const child = parent.childNodes[index]
232
+
233
+ switch (patch.type) {
234
+ case 'CREATE': {
235
+ const newEl = renderTree(patch.newNode)
236
+ parent.appendChild(newEl)
237
+ break
238
+ }
239
+ case 'REMOVE':
240
+ if (child) parent.removeChild(child)
241
+ break
242
+ case 'REPLACE': {
243
+ const newEl = renderTree(patch.newNode)
244
+ parent.replaceChild(newEl, child)
245
+ break
246
+ }
247
+ case 'UPDATE':
248
+ patch.children.forEach((p, i) => applyPatch(child, p, i))
249
+ break
250
+ }
251
+ }
252
+
253
+ /**
254
+ * Renders a new vnode into the DOM. If this vnode was rendered before,
255
+ * reuses the previous root and applies a patch. Otherwise, performs initial mount.
256
+ *
257
+ * @param {HTMLElement} mount - The container to render into
258
+ * @param {any[]} nextVNode - The declarative vnode array to render
259
+ */
260
+ export const render = (vtree, container = null) => {
261
+ const target =
262
+ !container && Array.isArray(vtree) && vtree[0] === 'html'
263
+ ? document.documentElement
264
+ : container
265
+
266
+ if (!target) {
267
+ throw new Error('render() requires a container for non-html() root')
268
+ }
269
+
270
+ const prevVNode = target.__vnode
271
+
272
+ if (!prevVNode) {
273
+ const dom = renderTree(vtree)
274
+ if (target === document.documentElement) {
275
+ document.replaceChild(dom, document.documentElement)
276
+ } else {
277
+ target.appendChild(dom)
278
+ }
279
+ } else {
280
+ const patch = diffTree(prevVNode, vtree)
281
+ applyPatch(target, patch)
282
+ }
283
+
284
+ target.__vnode = vtree
285
+ rootMap.set(vtree, target)
286
+ }
287
+
288
+ /**
289
+ * Wraps a function component so that it participates in reconciliation.
290
+ *
291
+ * @param {(...args: any[]) => any} fn - A pure function that returns a declarative tree (array format).
292
+ * @returns {(...args: any[]) => any} - A callable component that can manage its own subtree.
293
+ */
294
+ export const component = fn => {
295
+ return (...args) => {
296
+ try {
297
+ const vnode = fn(...args)
298
+ const prevEl = rootMap.get(vnode)
299
+ if (prevEl?.parentNode) {
300
+ const replacement = renderTree(['wrap', {}, vnode], true)
301
+ prevEl.parentNode.replaceChild(replacement, prevEl)
302
+ return replacement.__vnode
303
+ }
304
+ return ['wrap', {}, vnode]
305
+ } catch (err) {
306
+ console.error('Component error:', err)
307
+ return ['div', {}, `Error: ${err.message}`]
308
+ }
309
+ }
310
+ }
311
+
312
+ const htmlTagNames = [
313
+ // Document metadata
314
+ 'html', 'head', 'base', 'link', 'meta', 'title',
315
+
316
+ // Sections
317
+ 'body', 'header', 'hgroup', 'nav', 'main', 'section', 'article',
318
+ 'aside', 'footer', 'address',
319
+
320
+ // Text content
321
+ 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'hr', 'menu', 'pre', 'blockquote',
322
+ 'ol', 'ul', 'li', 'dl', 'dt', 'dd', 'figure', 'figcaption',
323
+ 'div',
324
+
325
+ // Inline text semantics
326
+ 'a', 'abbr', 'b', 'bdi', 'bdo', 'br', 'cite', 'code',
327
+ 'data', 'dfn', 'em', 'i', 'kbd', 'mark', 'q', 'rb', 'rp',
328
+ 'rt', 'rtc', 'ruby', 's', 'samp', 'small', 'span', 'strong',
329
+ 'sub', 'sup', 'time', 'u', 'var', 'wbr',
330
+
331
+ // Edits
332
+ 'ins', 'del',
333
+
334
+ // Embedded content
335
+ 'img', 'iframe', 'embed', 'object', 'param', 'video', 'audio',
336
+ 'source', 'track', 'picture',
337
+
338
+ // Table content
339
+ 'table', 'caption', 'thead', 'tbody', 'tfoot', 'tr',
340
+ 'th', 'td', 'colgroup', 'col',
341
+
342
+ // Forms
343
+ 'form', 'fieldset', 'legend', 'label', 'input', 'button',
344
+ 'select', 'datalist', 'optgroup', 'option', 'textarea',
345
+ 'output', 'progress', 'meter',
346
+
347
+ // Interactive elements
348
+ 'details', 'search', 'summary', 'dialog', 'slot', 'template',
349
+
350
+ // Scripting and style
351
+ 'script', 'noscript', 'style',
352
+
353
+ // Web components and others
354
+ 'canvas', 'picture', 'map', 'area', 'slot'
355
+ ]
356
+
357
+ const svgTagNames = [
358
+ // Animation elements
359
+ 'a', 'animate', 'animateMotion', 'animateTransform', 'mpath', 'set',
360
+
361
+ // Basic shapes
362
+ 'circle', 'ellipse', 'line', 'path', 'polygon', 'polyline', 'rect',
363
+
364
+ // Container / structural
365
+ 'defs', 'g', 'marker', 'mask', 'pattern', 'svg', 'switch', 'symbol', 'use',
366
+
367
+ // Descriptive
368
+ 'desc', 'metadata', 'title',
369
+
370
+ // Filter primitives
371
+ 'filter', 'feBlend', 'feColorMatrix', 'feComponentTransfer', 'feComposite',
372
+ 'feConvolveMatrix', 'feDiffuseLighting', 'feDisplacementMap',
373
+ 'feDistantLight', 'feDropShadow', 'feFlood', 'feFuncA', 'feFuncB',
374
+ 'feFuncG', 'feFuncR', 'feGaussianBlur', 'feImage', 'feMerge',
375
+ 'feMergeNode', 'feMorphology', 'feOffset', 'fePointLight',
376
+ 'feSpecularLighting', 'feSpotLight', 'feTile', 'feTurbulence',
377
+
378
+ // Gradient / paint servers
379
+ 'linearGradient', 'radialGradient', 'stop',
380
+
381
+ // Graphics elements
382
+ 'image', 'foreignObject', // included in graphics section as non‑standard children
383
+
384
+ // Text and text-path
385
+ 'text', 'textPath', 'tspan',
386
+
387
+ // Scripting/style
388
+ 'script', 'style',
389
+
390
+ // View
391
+ 'view'
392
+ ]
393
+
394
+ const tagNames = [...htmlTagNames, ...svgTagNames]
395
+ const isPropsObject = x => typeof x === 'object'
396
+ && x !== null
397
+ && !Array.isArray(x)
398
+ && !(typeof Node !== 'undefined' && x instanceof Node)
399
+
400
+ /**
401
+ * A map of supported HTML and SVG element helpers.
402
+ *
403
+ * Each helper is a function that accepts optional props as first argument
404
+ * and children as subsequent arguments.
405
+ *
406
+ * Example:
407
+ *
408
+ * ```js
409
+ * div({ id: 'foo' }, 'Hello World')
410
+ * ```
411
+ *
412
+ * Produces:
413
+ *
414
+ * ```js
415
+ * ['div', { id: 'foo' }, 'Hello World']
416
+ * ```
417
+ *
418
+ * The following helpers are included:
419
+ * `div`, `span`, `button`, `svg`, `circle`, etc.
420
+ *
421
+ * @typedef {function([propsOrChild], ...children): Array} ElementHelper
422
+ *
423
+ * @type {Record<string, ElementHelper>}
424
+ */
425
+ export const elements = tagNames.reduce((acc, tag) => ({
426
+ ...acc,
427
+ [tag]: (propsOrChild, ...children) => {
428
+ const props = isPropsObject(propsOrChild) ? propsOrChild : {}
429
+ const actualChildren = props === propsOrChild
430
+ ? children
431
+ : [propsOrChild, ...children]
432
+ return [tag, props, ...actualChildren]
433
+ }
434
+ }), {
435
+ fragment: (...children) => ['fragment', {}, ...children]
436
+ })
437
+
438
+ /**
439
+ * <html>
440
+ * Represents the root (top-level element) of an HTML document, so it is also referred to as the root element. All other elements must be descendants of this element.
441
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/html
442
+ *
443
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLHtmlElement}
444
+ */
445
+ export const html = elements.html
446
+
447
+ /**
448
+ * <base>
449
+ * Specifies the base URL to use for all relative URLs in a document. There can be only one such element in a document.
450
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/base
451
+ *
452
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBaseElement}
453
+ */
454
+ export const base = elements.base
455
+
456
+ /**
457
+ * <head>
458
+ * Contains machine-readable information (metadata) about the document, like its title, scripts, and style sheets.
459
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/head
460
+ *
461
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLHeadElement}
462
+ */
463
+ export const head = elements.head
464
+
465
+ /**
466
+ * <link>
467
+ * Specifies relationships between the current document and an external resource. This element is most commonly used to link to CSS but is also used to establish site icons (both "favicon" style icons and icons for the home screen and apps on mobile devices) among other things.
468
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/link
469
+ *
470
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLLinkElement}
471
+ */
472
+ export const link = elements.link
473
+
474
+ /**
475
+ * <meta>
476
+ * Represents metadata that cannot be represented by other HTML meta-related elements, like <base>, <link>, <script>, <style> and <title>.
477
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meta
478
+ *
479
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMetaElement}
480
+ */
481
+ export const meta = elements.meta
482
+
483
+ /**
484
+ * <style>
485
+ * Contains style information for a document or part of a document. It contains CSS, which is applied to the contents of the document containing this element.
486
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/style
487
+ *
488
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLStyleElement}
489
+ */
490
+ export const style = elements.style
491
+
492
+ /**
493
+ * <title>
494
+ * Defines the document's title that is shown in a browser's title bar or a page's tab. It only contains text; HTML tags within the element, if any, are also treated as plain text.
495
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/title
496
+ *
497
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTitleElement}
498
+ */
499
+ export const title = elements.title
500
+
501
+ /**
502
+ * <body>
503
+ * Represents the content of an HTML document. There can be only one such element in a document.
504
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/body
505
+ *
506
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBodyElement}
507
+ */
508
+ export const body = elements.body
509
+
510
+ /**
511
+ * <address>
512
+ * Indicates that the enclosed HTML provides contact information for a person or people, or for an organization.
513
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/address
514
+ *
515
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAddressElement}
516
+ */
517
+ export const address = elements.address
518
+
519
+ /**
520
+ * <article>
521
+ * Represents a self-contained composition in a document, page, application, or site, which is intended to be independently distributable or reusable (e.g., in syndication). Examples include a forum post, a magazine or newspaper article, a blog entry, a product card, a user-submitted comment, an interactive widget or gadget, or any other independent item of content.
522
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/article
523
+ *
524
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLArticleElement}
525
+ */
526
+ export const article = elements.article
527
+
528
+ /**
529
+ * <aside>
530
+ * Represents a portion of a document whose content is only indirectly related to the document's main content. Asides are frequently presented as sidebars or call-out boxes.
531
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/aside
532
+ *
533
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAsideElement}
534
+ */
535
+ export const aside = elements.aside
536
+
537
+ /**
538
+ * <footer>
539
+ * Represents a footer for its nearest ancestor sectioning content or sectioning root element. A <footer> typically contains information about the author of the section, copyright data, or links to related documents.
540
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/footer
541
+ *
542
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLFooterElement}
543
+ */
544
+ export const footer = elements.footer
545
+
546
+ /**
547
+ * <header>
548
+ * Represents introductory content, typically a group of introductory or navigational aids. It may contain some heading elements but also a logo, a search form, an author name, and other elements.
549
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/header
550
+ *
551
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLHeaderElement}
552
+ */
553
+ export const header = elements.header
554
+
555
+ /**
556
+ * <h1>
557
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
558
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h1
559
+ *
560
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
561
+ */
562
+ export const h1 = elements.h1
563
+
564
+ /**
565
+ * <h2>
566
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
567
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h2
568
+ *
569
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
570
+ */
571
+ export const h2 = elements.h2
572
+
573
+ /**
574
+ * <h3>
575
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
576
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h3
577
+ *
578
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
579
+ */
580
+ export const h3 = elements.h3
581
+
582
+ /**
583
+ * <h4>
584
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
585
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h4
586
+ *
587
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
588
+ */
589
+ export const h4 = elements.h4
590
+
591
+ /**
592
+ * <h5>
593
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
594
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h5
595
+ *
596
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
597
+ */
598
+ export const h5 = elements.h5
599
+
600
+ /**
601
+ * <h6>
602
+ * There are six levels of section headings. <h1> is the highest section level and <h6> is the lowest.
603
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/h6
604
+ *
605
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLH6Element}
606
+ */
607
+ export const h6 = elements.h6
608
+
609
+ /**
610
+ * <hgroup>
611
+ * Represents a heading grouped with any secondary content, such as subheadings, an alternative title, or a tagline.
612
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/hgroup
613
+ *
614
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLHgroupElement}
615
+ */
616
+ export const hgroup = elements.hgroup
617
+
618
+ /**
619
+ * <main>
620
+ * Represents the dominant content of the body of a document. The main content area consists of content that is directly related to or expands upon the central topic of a document, or the central functionality of an application.
621
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/main
622
+ *
623
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMainElement}
624
+ */
625
+ export const main = elements.main
626
+
627
+ /**
628
+ * <nav>
629
+ * Represents a section of a page whose purpose is to provide navigation links, either within the current document or to other documents. Common examples of navigation sections are menus, tables of contents, and indexes.
630
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/nav
631
+ *
632
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLNavElement}
633
+ */
634
+ export const nav = elements.nav
635
+
636
+ /**
637
+ * <section>
638
+ * Represents a generic standalone section of a document, which doesn't have a more specific semantic element to represent it. Sections should always have a heading, with very few exceptions.
639
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/section
640
+ *
641
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSectionElement}
642
+ */
643
+ export const section = elements.section
644
+
645
+ /**
646
+ * <search>
647
+ * Represents a part that contains a set of form controls or other content related to performing a search or filtering operation.
648
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/search
649
+ *
650
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSearchElement}
651
+ */
652
+ export const search = elements.search
653
+
654
+ /**
655
+ * <blockquote>
656
+ * Indicates that the enclosed text is an extended quotation. Usually, this is rendered visually by indentation. A URL for the source of the quotation may be given using the cite attribute, while a text representation of the source can be given using the <cite> element.
657
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/blockquote
658
+ *
659
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBlockquoteElement}
660
+ */
661
+ export const blockquote = elements.blockquote
662
+
663
+ /**
664
+ * <dd>
665
+ * Provides the description, definition, or value for the preceding term (<dt>) in a description list (<dl>).
666
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dd
667
+ *
668
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDdElement}
669
+ */
670
+ export const dd = elements.dd
671
+
672
+ /**
673
+ * <div>
674
+ * The generic container for flow content. It has no effect on the content or layout until styled in some way using CSS (e.g., styling is directly applied to it, or some kind of layout model like flexbox is applied to its parent element).
675
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/div
676
+ *
677
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDivElement}
678
+ */
679
+ export const div = elements.div
680
+
681
+ /**
682
+ * <dl>
683
+ * Represents a description list. The element encloses a list of groups of terms (specified using the <dt> element) and descriptions (provided by <dd> elements). Common uses for this element are to implement a glossary or to display metadata (a list of key-value pairs).
684
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dl
685
+ *
686
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDlElement}
687
+ */
688
+ export const dl = elements.dl
689
+
690
+ /**
691
+ * <dt>
692
+ * Specifies a term in a description or definition list, and as such must be used inside a <dl> element. It is usually followed by a <dd> element; however, multiple <dt> elements in a row indicate several terms that are all defined by the immediate next <dd> element.
693
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dt
694
+ *
695
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDtElement}
696
+ */
697
+ export const dt = elements.dt
698
+
699
+ /**
700
+ * <figcaption>
701
+ * Represents a caption or legend describing the rest of the contents of its parent <figure> element.
702
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/figcaption
703
+ *
704
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLFigcaptionElement}
705
+ */
706
+ export const figcaption = elements.figcaption
707
+
708
+ /**
709
+ * <figure>
710
+ * Represents self-contained content, potentially with an optional caption, which is specified using the <figcaption> element. The figure, its caption, and its contents are referenced as a single unit.
711
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/figure
712
+ *
713
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLFigureElement}
714
+ */
715
+ export const figure = elements.figure
716
+
717
+ /**
718
+ * <hr>
719
+ * Represents a thematic break between paragraph-level elements: for example, a change of scene in a story, or a shift of topic within a section.
720
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/hr
721
+ *
722
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLHrElement}
723
+ */
724
+ export const hr = elements.hr
725
+
726
+ /**
727
+ * <li>
728
+ * Represents an item in a list. It must be contained in a parent element: an ordered list (<ol>), an unordered list (<ul>), or a menu (<menu>). In menus and unordered lists, list items are usually displayed using bullet points. In ordered lists, they are usually displayed with an ascending counter on the left, such as a number or letter.
729
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/li
730
+ *
731
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLLiElement}
732
+ */
733
+ export const li = elements.li
734
+
735
+ /**
736
+ * <menu>
737
+ * A semantic alternative to <ul>, but treated by browsers (and exposed through the accessibility tree) as no different than <ul>. It represents an unordered list of items (which are represented by <li> elements).
738
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/menu
739
+ *
740
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMenuElement}
741
+ */
742
+ export const menu = elements.menu
743
+
744
+ /**
745
+ * <ol>
746
+ * Represents an ordered list of items — typically rendered as a numbered list.
747
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ol
748
+ *
749
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLOlElement}
750
+ */
751
+ export const ol = elements.ol
752
+
753
+ /**
754
+ * <p>
755
+ * Represents a paragraph. Paragraphs are usually represented in visual media as blocks of text separated from adjacent blocks by blank lines and/or first-line indentation, but HTML paragraphs can be any structural grouping of related content, such as images or form fields.
756
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/p
757
+ *
758
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLPElement}
759
+ */
760
+ export const p = elements.p
761
+
762
+ /** ')
763
+ * <pre>
764
+ * Represents preformatted text which is to be presented exactly as written in the HTML file. The text is typically rendered using a non-proportional, or monospaced, font. Whitespace inside this element is displayed as written.
765
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/pre
766
+ *
767
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLPreElement}
768
+ */
769
+ export const pre = elements.pre
770
+
771
+ /**
772
+ * <ul>
773
+ * Represents an unordered list of items, typically rendered as a bulleted list.
774
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ul
775
+ *
776
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLUlElement}
777
+ */
778
+ export const ul = elements.ul
779
+
780
+ /**
781
+ * <a>
782
+ * Together with its href attribute, creates a hyperlink to web pages, files, email addresses, locations within the current page, or anything else a URL can address.
783
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/a
784
+ *
785
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAElement}
786
+ */
787
+ export const a = elements.a
788
+
789
+ /**
790
+ * <abbr>
791
+ * Represents an abbreviation or acronym.
792
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/abbr
793
+ *
794
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAbbrElement}
795
+ */
796
+ export const abbr = elements.abbr
797
+
798
+ /**
799
+ * <b>
800
+ * Used to draw the reader's attention to the element's contents, which are not otherwise granted special importance. This was formerly known as the Boldface element, and most browsers still draw the text in boldface. However, you should not use <b> for styling text or granting importance. If you wish to create boldface text, you should use the CSS font-weight property. If you wish to indicate an element is of special importance, you should use the <strong> element.
801
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/b
802
+ *
803
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBElement}
804
+ */
805
+ export const b = elements.b
806
+
807
+ /**
808
+ * <bdi>
809
+ * Tells the browser's bidirectional algorithm to treat the text it contains in isolation from its surrounding text. It's particularly useful when a website dynamically inserts some text and doesn't know the directionality of the text being inserted.
810
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/bdi
811
+ *
812
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBdiElement}
813
+ */
814
+ export const bdi = elements.bdi
815
+
816
+ /**
817
+ * <bdo>
818
+ * Overrides the current directionality of text, so that the text within is rendered in a different direction.
819
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/bdo
820
+ *
821
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBdoElement}
822
+ */
823
+ export const bdo = elements.bdo
824
+
825
+ /**
826
+ * <br>
827
+ * Produces a line break in text (carriage-return). It is useful for writing a poem or an address, where the division of lines is significant.
828
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/br
829
+ *
830
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLBrElement}
831
+ */
832
+ export const br = elements.br
833
+
834
+ /**
835
+ * <cite>
836
+ * Used to mark up the title of a creative work. The reference may be in an abbreviated form according to context-appropriate conventions related to citation metadata.
837
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/cite
838
+ *
839
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLCiteElement}
840
+ */
841
+ export const cite = elements.cite
842
+
843
+ /**
844
+ * <code>
845
+ * Displays its contents styled in a fashion intended to indicate that the text is a short fragment of computer code. By default, the content text is displayed using the user agent's default monospace font.
846
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/code
847
+ *
848
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLCodeElement}
849
+ */
850
+ export const code = elements.code
851
+
852
+ /**
853
+ * <data>
854
+ * Links a given piece of content with a machine-readable translation. If the content is time- or date-related, the <time> element must be used.
855
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/data
856
+ *
857
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDataElement}
858
+ */
859
+ export const data = elements.data
860
+
861
+ /**
862
+ * <dfn>
863
+ * Used to indicate the term being defined within the context of a definition phrase or sentence. The ancestor <p> element, the <dt>/<dd> pairing, or the nearest section ancestor of the <dfn> element, is considered to be the definition of the term.
864
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dfn
865
+ *
866
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDfnElement}
867
+ */
868
+ export const dfn = elements.dfn
869
+
870
+ /**
871
+ * <em>
872
+ * Marks text that has stress emphasis. The <em> element can be nested, with each nesting level indicating a greater degree of emphasis.
873
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/em
874
+ *
875
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLEmElement}
876
+ */
877
+ export const em = elements.em
878
+
879
+ /**
880
+ * <i>
881
+ * Represents a range of text that is set off from the normal text for some reason, such as idiomatic text, technical terms, and taxonomical designations, among others. Historically, these have been presented using italicized type, which is the original source of the <i> naming of this element.
882
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/i
883
+ *
884
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLIElement}
885
+ */
886
+ export const i = elements.i
887
+
888
+ /**
889
+ * <kbd>
890
+ * Represents a span of inline text denoting textual user input from a keyboard, voice input, or any other text entry device. By convention, the user agent defaults to rendering the contents of a <kbd> element using its default monospace font, although this is not mandated by the HTML standard.
891
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/kbd
892
+ *
893
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLKbdElement}
894
+ */
895
+ export const kbd = elements.kbd
896
+
897
+ /**
898
+ * <mark>
899
+ * Represents text which is marked or highlighted for reference or notation purposes due to the marked passage's relevance in the enclosing context.
900
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/mark
901
+ *
902
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMarkElement}
903
+ */
904
+ export const mark = elements.mark
905
+
906
+ /**
907
+ * <q>
908
+ * Indicates that the enclosed text is a short inline quotation. Most modern browsers implement this by surrounding the text in quotation marks. This element is intended for short quotations that don't require paragraph breaks; for long quotations use the <blockquote> element.
909
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/q>
910
+ *
911
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLQElement}
912
+ */
913
+ export const q = elements.q
914
+
915
+ /**
916
+ * <rp>
917
+ * Used to provide fall-back parentheses for browsers that do not support the display of ruby annotations using the <ruby> element. One <rp> element should enclose each of the opening and closing parentheses that wrap the <rt> element that contains the annotation's text.
918
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/rp
919
+ *
920
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLRpElement}
921
+ */
922
+ export const rp = elements.rp
923
+
924
+ /**
925
+ * <rt>
926
+ * Specifies the ruby text component of a ruby annotation, which is used to provide pronunciation, translation, or transliteration information for East Asian typography. The <rt> element must always be contained within a <ruby> element.
927
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/rt
928
+ *
929
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLRtElement}
930
+ */
931
+ export const rt = elements.rt
932
+
933
+ /**
934
+ * <ruby>
935
+ * Represents small annotations that are rendered above, below, or next to base text, usually used for showing the pronunciation of East Asian characters. It can also be used for annotating other kinds of text, but this usage is less common.
936
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ruby
937
+ *
938
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLRubyElement}
939
+ */
940
+ export const ruby = elements.ruby
941
+
942
+ /**
943
+ * <s>
944
+ * Renders text with a strikethrough, or a line through it. Use the <s> element to represent things that are no longer relevant or no longer accurate. However, <s> is not appropriate when indicating document edits; for that, use the <del> and <ins> elements, as appropriate.
945
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/s
946
+ *
947
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSElement}
948
+ */
949
+ export const s = elements.s
950
+
951
+ /**
952
+ * <samp>
953
+ * Used to enclose inline text which represents sample (or quoted) output from a computer program. Its contents are typically rendered using the browser's default monospaced font (such as Courier or Lucida Console).
954
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/samp
955
+ *
956
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSampElement}
957
+ */
958
+ export const samp = elements.samp
959
+
960
+ /**
961
+ * <small>
962
+ * Represents side-comments and small print, like copyright and legal text, independent of its styled presentation. By default, it renders text within it one font size smaller, such as from small to x-small.
963
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/small
964
+ *
965
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSmallElement}
966
+ */
967
+ export const small = elements.small
968
+
969
+ /**
970
+ * <span>
971
+ * A generic inline container for phrasing content, which does not inherently represent anything. It can be used to group elements for styling purposes (using the class or id attributes), or because they share attribute values, such as lang. It should be used only when no other semantic element is appropriate. <span> is very much like a div element, but div is a block-level element whereas a <span> is an inline-level element.
972
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/span
973
+ *
974
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSpanElement}
975
+ */
976
+ export const span = elements.span
977
+
978
+ /**
979
+ * <strong>
980
+ * Indicates that its contents have strong importance, seriousness, or urgency. Browsers typically render the contents in bold type.
981
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/strong
982
+ *
983
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLStrongElement}
984
+ */
985
+ export const strong = elements.strong
986
+
987
+ /**
988
+ * <sub>
989
+ * Specifies inline text which should be displayed as subscript for solely typographical reasons. Subscripts are typically rendered with a lowered baseline using smaller text.
990
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/sub
991
+ *
992
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSubElement}
993
+ */
994
+ export const sub = elements.sub
995
+
996
+ /**
997
+ * <sup>
998
+ * Specifies inline text which is to be displayed as superscript for solely typographical reasons. Superscripts are usually rendered with a raised baseline using smaller text.
999
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/sup
1000
+ *
1001
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSupElement}
1002
+ */
1003
+ export const sup = elements.sup
1004
+
1005
+ /**
1006
+ * <time>
1007
+ * Represents a specific period in time. It may include the datetime attribute to translate dates into machine-readable format, allowing for better search engine results or custom features such as reminders.
1008
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/time
1009
+ *
1010
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTimeElement}
1011
+ */
1012
+ export const time = elements.time
1013
+
1014
+ /**
1015
+ * <u>
1016
+ * Represents a span of inline text which should be rendered in a way that indicates that it has a non-textual annotation. This is rendered by default as a single solid underline but may be altered using CSS.
1017
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/u
1018
+ *
1019
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLUElement}
1020
+ */
1021
+ export const u = elements.u
1022
+
1023
+ /**
1024
+ * <var>
1025
+ * Represents the name of a variable in a mathematical expression or a programming context. It's typically presented using an italicized version of the current typeface, although that behavior is browser-dependent.
1026
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/var
1027
+ *
1028
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLVarElement}
1029
+ */
1030
+ export const htmlvar = elements.var
1031
+
1032
+ /**
1033
+ * <wbr>
1034
+ * Represents a word break opportunity—a position within text where the browser may optionally break a line, though its line-breaking rules would not otherwise create a break at that location.
1035
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/wbr
1036
+ *
1037
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLWbrElement}
1038
+ */
1039
+ export const wbr = elements.wbr
1040
+
1041
+ /**
1042
+ * <area>
1043
+ * Defines an area inside an image map that has predefined clickable areas. An image map allows geometric areas on an image to be associated with hyperlink.
1044
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/area
1045
+ *
1046
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAreaElement}
1047
+ */
1048
+ export const area = elements.area
1049
+
1050
+ /**
1051
+ * <audio>
1052
+ * Used to embed sound content in documents. It may contain one or more audio sources, represented using the src attribute or the source element: the browser will choose the most suitable one. It can also be the destination for streamed media, using a MediaStream.
1053
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/audio
1054
+ *
1055
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLAudioElement}
1056
+ */
1057
+ export const audio = elements.audio
1058
+
1059
+ /**
1060
+ * <img>
1061
+ * Embeds an image into the document.
1062
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/img
1063
+ *
1064
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLImgElement}
1065
+ */
1066
+ export const img = elements.img
1067
+
1068
+ /**
1069
+ * <map>
1070
+ * Used with <area> elements to define an image map (a clickable link area).
1071
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/map
1072
+ *
1073
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMapElement}
1074
+ */
1075
+ export const map = elements.map
1076
+
1077
+ /**
1078
+ * <track>
1079
+ * Used as a child of the media elements, audio and video. It lets you specify timed text tracks (or time-based data), for example to automatically handle subtitles. The tracks are formatted in WebVTT format (.vtt files)—Web Video Text Tracks.
1080
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/track
1081
+ *
1082
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTrackElement}
1083
+ */
1084
+ export const track = elements.track
1085
+
1086
+ /**
1087
+ * <video>
1088
+ * Embeds a media player which supports video playback into the document. You can also use <video> for audio content, but the audio element may provide a more appropriate user experience.
1089
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/video
1090
+ *
1091
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLVideoElement}
1092
+ */
1093
+ export const video = elements.video
1094
+
1095
+ /**
1096
+ * <embed>
1097
+ * Embeds external content at the specified point in the document. This content is provided by an external application or other source of interactive content such as a browser plug-in.
1098
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/embed
1099
+ *
1100
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLEmbedElement}
1101
+ */
1102
+ export const embed = elements.embed
1103
+
1104
+ /**
1105
+ * <iframe>
1106
+ * Represents a nested browsing context, embedding another HTML page into the current one.
1107
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/iframe
1108
+ *
1109
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLIframeElement}
1110
+ */
1111
+ export const iframe = elements.iframe
1112
+
1113
+ /**
1114
+ * <object>
1115
+ * Represents an external resource, which can be treated as an image, a nested browsing context, or a resource to be handled by a plugin.
1116
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/object
1117
+ *
1118
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLObjectElement}
1119
+ */
1120
+ export const object = elements.object
1121
+
1122
+ /**
1123
+ * <picture>
1124
+ * Contains zero or more <source> elements and one <img> element to offer alternative versions of an image for different display/device scenarios.
1125
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/picture
1126
+ *
1127
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLPictureElement}
1128
+ */
1129
+ export const picture = elements.picture
1130
+
1131
+ /**
1132
+ * <source>
1133
+ * Specifies multiple media resources for the picture, the audio element, or the video element. It is a void element, meaning that it has no content and does not have a closing tag. It is commonly used to offer the same media content in multiple file formats in order to provide compatibility with a broad range of browsers given their differing support for image file formats and media file formats.
1134
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/source
1135
+ *
1136
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSourceElement}
1137
+ */
1138
+ export const source = elements.source
1139
+
1140
+ /**
1141
+ * <canvas>
1142
+ * Container element to use with either the canvas scripting API or the WebGL API to draw graphics and animations.
1143
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/canvas
1144
+ *
1145
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLCanvasElement}
1146
+ */
1147
+ export const canvas = elements.canvas
1148
+
1149
+ /**
1150
+ * <noscript>
1151
+ * Defines a section of HTML to be inserted if a script type on the page is unsupported or if scripting is currently turned off in the browser.
1152
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/noscript
1153
+ *
1154
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLNoscriptElement}
1155
+ */
1156
+ export const noscript = elements.noscript
1157
+
1158
+ /**
1159
+ * <script>
1160
+ * Used to embed executable code or data; this is typically used to embed or refer to JavaScript code. The <script> element can also be used with other languages, such as WebGL's GLSL shader programming language and JSON.
1161
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script
1162
+ *
1163
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLScriptElement}
1164
+ */
1165
+ export const script = elements.script
1166
+
1167
+ /**
1168
+ * <del>
1169
+ * Represents a range of text that has been deleted from a document. This can be used when rendering "track changes" or source code diff information, for example. The <ins> element can be used for the opposite purpose: to indicate text that has been added to the document.
1170
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/del
1171
+ *
1172
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDelElement}
1173
+ */
1174
+ export const del = elements.del
1175
+
1176
+ /**
1177
+ * <ins>
1178
+ * Represents a range of text that has been added to a document. You can use the <del> element to similarly represent a range of text that has been deleted from the document.
1179
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ins
1180
+ *
1181
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLInsElement}
1182
+ */
1183
+ export const ins = elements.ins
1184
+
1185
+ /**
1186
+ * <caption>
1187
+ * Specifies the caption (or title) of a table.
1188
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/caption
1189
+ *
1190
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLCaptionElement}
1191
+ */
1192
+ export const caption = elements.caption
1193
+
1194
+ /**
1195
+ * <col>
1196
+ * Defines one or more columns in a column group represented by its implicit or explicit parent <colgroup> element. The <col> element is only valid as a child of a <colgroup> element that has no span attribute defined.
1197
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/col
1198
+ *
1199
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLColElement}
1200
+ */
1201
+ export const col = elements.col
1202
+
1203
+ /**
1204
+ * <colgroup>
1205
+ * Defines a group of columns within a table.
1206
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/colgroup
1207
+ *
1208
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLColgroupElement}
1209
+ */
1210
+ export const colgroup = elements.colgroup
1211
+
1212
+ /**
1213
+ * <table>
1214
+ * Represents tabular data—that is, information presented in a two-dimensional table comprised of rows and columns of cells containing data.
1215
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/table
1216
+ *
1217
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTableElement}
1218
+ */
1219
+ export const table = elements.table
1220
+
1221
+ /**
1222
+ * <tbody>
1223
+ * Encapsulates a set of table rows (<tr> elements), indicating that they comprise the body of a table's (main) data.
1224
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tbody
1225
+ *
1226
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTbodyElement}
1227
+ */
1228
+ export const tbody = elements.tbody
1229
+
1230
+ /**
1231
+ * <td>
1232
+ * A child of the <tr> element, it defines a cell of a table that contains data.
1233
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/td
1234
+ *
1235
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTdElement}
1236
+ */
1237
+ export const td = elements.td
1238
+
1239
+ /**
1240
+ * <tfoot>
1241
+ * Encapsulates a set of table rows (<tr> elements), indicating that they comprise the foot of a table with information about the table's columns. This is usually a summary of the columns, e.g., a sum of the given numbers in a column.
1242
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tfoot
1243
+ *
1244
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTfootElement}
1245
+ */
1246
+ export const tfoot = elements.tfoot
1247
+
1248
+ /**
1249
+ * <th>
1250
+ * A child of the <tr> element, it defines a cell as the header of a group of table cells. The nature of this group can be explicitly defined by the scope and headers attributes.
1251
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/th
1252
+ *
1253
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLThElement}
1254
+ */
1255
+ export const th = elements.th
1256
+
1257
+ /**
1258
+ * <thead>
1259
+ * Encapsulates a set of table rows (<tr> elements), indicating that they comprise the head of a table with information about the table's columns. This is usually in the form of column headers (<th> elements).
1260
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/thead
1261
+ *
1262
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTheadElement}
1263
+ */
1264
+ export const thead = elements.thead
1265
+
1266
+ /**
1267
+ * <tr>
1268
+ * Defines a row of cells in a table. The row's cells can then be established using a mix of <td> (data cell) and <th> (header cell) elements.
1269
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/tr
1270
+ *
1271
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTrElement}
1272
+ */
1273
+ export const tr = elements.tr
1274
+
1275
+ /**
1276
+ * <button>
1277
+ * An interactive element activated by a user with a mouse, keyboard, finger, voice command, or other assistive technology. Once activated, it performs an action, such as submitting a form or opening a dialog.
1278
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/button
1279
+ *
1280
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLButtonElement}
1281
+ */
1282
+ export const button = elements.button
1283
+
1284
+ /**
1285
+ * <datalist>
1286
+ * Contains a set of <option> elements that represent the permissible or recommended options available to choose from within other controls.
1287
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/datalist
1288
+ *
1289
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDatalistElement}
1290
+ */
1291
+ export const datalist = elements.datalist
1292
+
1293
+ /**
1294
+ * <fieldset>
1295
+ * Used to group several controls as well as labels (<label>) within a web form.
1296
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/fieldset
1297
+ *
1298
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLFieldsetElement}
1299
+ */
1300
+ export const fieldset = elements.fieldset
1301
+
1302
+ /**
1303
+ * <form>
1304
+ * Represents a document section containing interactive controls for submitting information.
1305
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/form
1306
+ *
1307
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLFormElement}
1308
+ */
1309
+ export const form = elements.form
1310
+
1311
+ /**
1312
+ * <input>
1313
+ * Used to create interactive controls for web-based forms to accept data from the user; a wide variety of types of input data and control widgets are available, depending on the device and user agent. The <input> element is one of the most powerful and complex in all of HTML due to the sheer number of combinations of input types and attributes.
1314
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input
1315
+ *
1316
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLInputElement}
1317
+ */
1318
+ export const input = elements.input
1319
+
1320
+ /**
1321
+ * <label>
1322
+ * Represents a caption for an item in a user interface.
1323
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/label
1324
+ *
1325
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLLabelElement}
1326
+ */
1327
+ export const label = elements.label
1328
+
1329
+ /**
1330
+ * <legend>
1331
+ * Represents a caption for the content of its parent <fieldset>.
1332
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/legend
1333
+ *
1334
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLLegendElement}
1335
+ */
1336
+ export const legend = elements.legend
1337
+
1338
+ /**
1339
+ * <meter>
1340
+ * Represents either a scalar value within a known range or a fractional value.
1341
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/meter
1342
+ *
1343
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLMeterElement}
1344
+ */
1345
+ export const meter = elements.meter
1346
+
1347
+ /**
1348
+ * <optgroup>
1349
+ * Creates a grouping of options within a <select> element.
1350
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/optgroup
1351
+ *
1352
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLOptgroupElement}
1353
+ */
1354
+ export const optgroup = elements.optgroup
1355
+
1356
+ /**
1357
+ * <option>
1358
+ * Used to define an item contained in a select, an <optgroup>, or a <datalist> element. As such, <option> can represent menu items in popups and other lists of items in an HTML document.
1359
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/option
1360
+ *
1361
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLOptionElement}
1362
+ */
1363
+ export const option = elements.option
1364
+
1365
+ /**
1366
+ * <output>
1367
+ * Container element into which a site or app can inject the results of a calculation or the outcome of a user action.
1368
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/output
1369
+ *
1370
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLOutputElement}
1371
+ */
1372
+ export const output = elements.output
1373
+
1374
+ /**
1375
+ * <progress>
1376
+ * Displays an indicator showing the completion progress of a task, typically displayed as a progress bar.
1377
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/progress
1378
+ *
1379
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLProgressElement}
1380
+ */
1381
+ export const progress = elements.progress
1382
+
1383
+ /**
1384
+ * <select>
1385
+ * Represents a control that provides a menu of options.
1386
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/select
1387
+ *
1388
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSelectElement}
1389
+ */
1390
+ export const select = elements.select
1391
+
1392
+ /**
1393
+ * <textarea>
1394
+ * Represents a multi-line plain-text editing control, useful when you want to allow users to enter a sizeable amount of free-form text, for example, a comment on a review or feedback form.
1395
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/textarea
1396
+ *
1397
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTextareaElement}
1398
+ */
1399
+ export const textarea = elements.textarea
1400
+
1401
+ /**
1402
+ * <details>
1403
+ * Creates a disclosure widget in which information is visible only when the widget is toggled into an "open" state. A summary or label must be provided using the <summary> element.
1404
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/details
1405
+ *
1406
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDetailsElement}
1407
+ */
1408
+ export const details = elements.details
1409
+
1410
+ /**
1411
+ * <dialog>
1412
+ * Represents a dialog box or other interactive component, such as a dismissible alert, inspector, or subwindow.
1413
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog
1414
+ *
1415
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLDialogElement}
1416
+ */
1417
+ export const dialog = elements.dialog
1418
+
1419
+ /**
1420
+ * <summary>
1421
+ * Specifies a summary, caption, or legend for a details element's disclosure box. Clicking the <summary> element toggles the state of the parent <details> element open and closed.
1422
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/summary
1423
+ *
1424
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSummaryElement}
1425
+ */
1426
+ export const summary = elements.summary
1427
+
1428
+ /**
1429
+ * <slot>
1430
+ * Part of the Web Components technology suite, this element is a placeholder inside a web component that you can fill with your own markup, which lets you create separate DOM trees and present them together.
1431
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot
1432
+ *
1433
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLSlotElement}
1434
+ */
1435
+ export const slot = elements.slot
1436
+
1437
+ /**
1438
+ * <template>
1439
+ * A mechanism for holding HTML that is not to be rendered immediately when a page is loaded but may be instantiated subsequently during runtime using JavaScript.
1440
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/template
1441
+ *
1442
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLTemplateElement}
1443
+ */
1444
+ export const template = elements.template
1445
+
1446
+ /**
1447
+ * <image>
1448
+ * An ancient and poorly supported precursor to the <img> element. It should not be used.
1449
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/image
1450
+ *
1451
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLImageElement}
1452
+ */
1453
+ export const image = elements.image
1454
+
1455
+ /**
1456
+ * <rb>
1457
+ * Used to delimit the base text component of a ruby annotation, i.e., the text that is being annotated. One <rb> element should wrap each separate atomic segment of the base text.
1458
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/rb
1459
+ *
1460
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLRbElement}
1461
+ */
1462
+ export const rb = elements.rb
1463
+
1464
+ /**
1465
+ * <rtc>
1466
+ * Embraces semantic annotations of characters presented in a ruby of <rb> elements used inside of <ruby> element. <rb> elements can have both pronunciation (<rt>) and semantic (<rtc>) annotations.
1467
+ * https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/rtc
1468
+ *
1469
+ * @type {(props?: object, ...children: (string | number | Node)[]) => HTMLRtcElement}
1470
+ */
1471
+ export const rtc = elements.rtc
1472
+
1473
+ /**
1474
+ * The <animate> SVG element provides a way to animate an attribute of an element over time.
1475
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/animate
1476
+ *
1477
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGAnimateElement }
1478
+ */
1479
+ export const animate = elements.animate
1480
+
1481
+ /**
1482
+ * The <animateMotion> SVG element provides a way to define how an element moves along a motion path.
1483
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/animateMotion
1484
+ *
1485
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGAnimateMotionElement }
1486
+ */
1487
+ export const animateMotion = elements.animateMotion
1488
+
1489
+ /**
1490
+ * The <animateTransform> SVG element animates a transformation attribute on its target element, thereby allowing animations to control translation, scaling, rotation, and/or skewing.
1491
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/animateTransform
1492
+ *
1493
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGAnimateTransformElement }
1494
+ */
1495
+ export const animateTransform = elements.animateTransform
1496
+
1497
+ /**
1498
+ * The <mpath> SVG sub-element for the <animateMotion> element provides the ability to reference an external <path> element as the definition of a motion path.
1499
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/mpath
1500
+ *
1501
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGMpathElement }
1502
+ */
1503
+ export const mpath = elements.mpath
1504
+
1505
+ /**
1506
+ * The <set> SVG element provides a method of setting the value of an attribute for a specified duration.
1507
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/set
1508
+ *
1509
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGSetElement }
1510
+ */
1511
+ export const set = elements.set
1512
+
1513
+ /**
1514
+ * The <circle> SVG element is an SVG basic shape, used to draw circles based on a center point and a radius.
1515
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/circle
1516
+ *
1517
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGCircleElement }
1518
+ */
1519
+ export const circle = elements.circle
1520
+
1521
+ /**
1522
+ * The <ellipse> SVG element is an SVG basic shape, used to create ellipses based on a center coordinate, and both their x and y radius.
1523
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/ellipse
1524
+ *
1525
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGEllipseElement }
1526
+ */
1527
+ export const ellipse = elements.ellipse
1528
+
1529
+ /**
1530
+ * The <line> SVG element is an SVG basic shape used to create a line connecting two points.
1531
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/line
1532
+ *
1533
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGLineElement }
1534
+ */
1535
+ export const line = elements.line
1536
+
1537
+ /**
1538
+ * The <path> SVG element is the generic element to define a shape. All the basic shapes can be created with a path element.
1539
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/path
1540
+ *
1541
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGPathElement }
1542
+ */
1543
+ export const path = elements.path
1544
+
1545
+ /**
1546
+ * The <polygon> SVG element defines a closed shape consisting of a set of connected straight line segments. The last point is connected to the first point.
1547
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/polygon
1548
+ *
1549
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGPolygonElement }
1550
+ */
1551
+ export const polygon = elements.polygon
1552
+
1553
+ /**
1554
+ * The <polyline> SVG element is an SVG basic shape that creates straight lines connecting several points. Typically a polyline is used to create open shapes as the last point doesn't have to be connected to the first point. For closed shapes see the <polygon> element.
1555
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/polyline
1556
+ *
1557
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGPolylineElement }
1558
+ */
1559
+ export const polyline = elements.polyline
1560
+
1561
+ /**
1562
+ * The <rect> SVG element is a basic SVG shape that draws rectangles, defined by their position, width, and height. The rectangles may have their corners rounded.
1563
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/rect
1564
+ *
1565
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGRectElement }
1566
+ */
1567
+ export const rect = elements.rect
1568
+
1569
+ /**
1570
+ * The <defs> SVG element is used to store graphical objects that will be used at a later time. Objects created inside a <defs> element are not rendered directly. To display them you have to reference them (with a <use> element for example).
1571
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/defs
1572
+ *
1573
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGDefsElement }
1574
+ */
1575
+ export const defs = elements.defs
1576
+
1577
+ /**
1578
+ * The <g> SVG element is a container used to group other SVG elements.
1579
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/g
1580
+ *
1581
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGGElement }
1582
+ */
1583
+ export const g = elements.g
1584
+
1585
+ /**
1586
+ * The <marker> SVG element defines a graphic used for drawing arrowheads or polymarkers on a given <path>, <line>, <polyline> or <polygon> element.
1587
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/marker
1588
+ *
1589
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGMarkerElement }
1590
+ */
1591
+ export const marker = elements.marker
1592
+
1593
+ /**
1594
+ * The <mask> SVG element defines a mask for compositing the current object into the background. A mask is used/referenced using the mask property and CSS mask-image property.
1595
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/mask
1596
+ *
1597
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGMaskElement }
1598
+ */
1599
+ export const mask = elements.mask
1600
+
1601
+ /**
1602
+ * The <pattern> SVG element defines a graphics object which can be redrawn at repeated x- and y-coordinate intervals ("tiled") to cover an area.
1603
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/pattern
1604
+ *
1605
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGPatternElement }
1606
+ */
1607
+ export const pattern = elements.pattern
1608
+
1609
+ /**
1610
+ * The <svg> SVG element is a container that defines a new coordinate system and viewport. It is used as the outermost element of SVG documents, but it can also be used to embed an SVG fragment inside an SVG or HTML document.
1611
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/svg
1612
+ *
1613
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGSvgElement }
1614
+ */
1615
+ export const svg = elements.svg
1616
+
1617
+ /**
1618
+ * The <switch> SVG element evaluates any requiredFeatures, requiredExtensions and systemLanguage attributes on its direct child elements in order, and then renders the first child where these attributes evaluate to true.
1619
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/switch
1620
+ *
1621
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGSwitchElement }
1622
+ */
1623
+ export const svgswitch = elements.switch
1624
+
1625
+ /**
1626
+ * The <symbol> SVG element is used to define graphical template objects which can be instantiated by a <use> element.
1627
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/symbol
1628
+ *
1629
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGSymbolElement }
1630
+ */
1631
+ export const symbol = elements.symbol
1632
+
1633
+ /**
1634
+ * The <use> element takes nodes from within an SVG document, and duplicates them somewhere else. The effect is the same as if the nodes were deeply cloned into a non-exposed DOM, then pasted where the <use> element is, much like cloned <template> elements.
1635
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/use
1636
+ *
1637
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGUseElement }
1638
+ */
1639
+ export const use = elements.use
1640
+
1641
+ /**
1642
+ * The <desc> SVG element provides an accessible, long-text description of any SVG container element or graphics element.
1643
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/desc
1644
+ *
1645
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGDescElement }
1646
+ */
1647
+ export const desc = elements.desc
1648
+
1649
+ /**
1650
+ * The <metadata> SVG element adds metadata to SVG content. Metadata is structured information about data. The contents of <metadata> should be elements from other XML namespaces such as RDF, FOAF, etc.
1651
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/metadata
1652
+ *
1653
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGMetadataElement }
1654
+ */
1655
+ export const metadata = elements.metadata
1656
+
1657
+ /**
1658
+ * The <filter> SVG element defines a custom filter effect by grouping atomic filter primitives. It is never rendered itself, but must be used by the filter attribute on SVG elements, or the filter CSS property for SVG/HTML elements.
1659
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/filter
1660
+ *
1661
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFilterElement }
1662
+ */
1663
+ export const filter = elements.filter
1664
+
1665
+ /**
1666
+ * The <feBlend> SVG filter primitive composes two objects together ruled by a certain blending mode. This is similar to what is known from image editing software when blending two layers. The mode is defined by the mode attribute.
1667
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feBlend
1668
+ *
1669
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeBlendElement }
1670
+ */
1671
+ export const feBlend = elements.feBlend
1672
+
1673
+ /**
1674
+ * The <feColorMatrix> SVG filter element changes colors based on a transformation matrix. Every pixel's color value [R,G,B,A] is matrix multiplied by a 5 by 5 color matrix to create new color [R',G',B',A'].
1675
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feColorMatrix
1676
+ *
1677
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeColorMatrixElement }
1678
+ */
1679
+ export const feColorMatrix = elements.feColorMatrix
1680
+
1681
+ /**
1682
+ * The <feComponentTransfer> SVG filter primitive performs color-component-wise remapping of data for each pixel. It allows operations like brightness adjustment, contrast adjustment, color balance or thresholding.
1683
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feComponentTransfer
1684
+ *
1685
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeComponentTransferElement }
1686
+ */
1687
+ export const feComponentTransfer = elements.feComponentTransfer
1688
+
1689
+ /**
1690
+ * The <feComposite> SVG filter primitive performs the combination of two input images pixel-wise in image space using one of the Porter-Duff compositing operations: over, in, atop, out, xor, lighter, or arithmetic.
1691
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feComposite
1692
+ *
1693
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeCompositeElement }
1694
+ */
1695
+ export const feComposite = elements.feComposite
1696
+
1697
+ /**
1698
+ * The <feConvolveMatrix> SVG filter primitive applies a matrix convolution filter effect. A convolution combines pixels in the input image with neighboring pixels to produce a resulting image. A wide variety of imaging operations can be achieved through convolutions, including blurring, edge detection, sharpening, embossing and beveling.
1699
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feConvolveMatrix
1700
+ *
1701
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeConvolveMatrixElement }
1702
+ */
1703
+ export const feConvolveMatrix = elements.feConvolveMatrix
1704
+
1705
+ /**
1706
+ * The <feDiffuseLighting> SVG filter primitive lights an image using the alpha channel as a bump map. The resulting image, which is an RGBA opaque image, depends on the light color, light position and surface geometry of the input bump map.
1707
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feDiffuseLighting
1708
+ *
1709
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeDiffuseLightingElement }
1710
+ */
1711
+ export const feDiffuseLighting = elements.feDiffuseLighting
1712
+
1713
+ /**
1714
+ * The <feDisplacementMap> SVG filter primitive uses the pixel values from the image from in2 to spatially displace the image from in.
1715
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feDisplacementMap
1716
+ *
1717
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeDisplacementMapElement }
1718
+ */
1719
+ export const feDisplacementMap = elements.feDisplacementMap
1720
+
1721
+ /**
1722
+ * The <feDistantLight> SVG filter primitive defines a distant light source that can be used within a lighting filter primitive: <feDiffuseLighting> or <feSpecularLighting>.
1723
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feDistantLight
1724
+ *
1725
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeDistantLightElement }
1726
+ */
1727
+ export const feDistantLight = elements.feDistantLight
1728
+
1729
+ /**
1730
+ * The <feDropShadow> SVG filter primitive creates a drop shadow of the input image. It can only be used inside a <filter> element.
1731
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feDropShadow
1732
+ *
1733
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeDropShadowElement }
1734
+ */
1735
+ export const feDropShadow = elements.feDropShadow
1736
+
1737
+ /**
1738
+ * The <feFlood> SVG filter primitive fills the filter subregion with the color and opacity defined by flood-color and flood-opacity.
1739
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feFlood
1740
+ *
1741
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeFloodElement }
1742
+ */
1743
+ export const feFlood = elements.feFlood
1744
+
1745
+ /**
1746
+ * The <feFuncA> SVG filter primitive defines the transfer function for the alpha component of the input graphic of its parent <feComponentTransfer> element.
1747
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feFuncA
1748
+ *
1749
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeFuncAElement }
1750
+ */
1751
+ export const feFuncA = elements.feFuncA
1752
+
1753
+ /**
1754
+ * The <feFuncB> SVG filter primitive defines the transfer function for the blue component of the input graphic of its parent <feComponentTransfer> element.
1755
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feFuncB
1756
+ *
1757
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeFuncBElement }
1758
+ */
1759
+ export const feFuncB = elements.feFuncB
1760
+
1761
+ /**
1762
+ * The <feFuncG> SVG filter primitive defines the transfer function for the green component of the input graphic of its parent <feComponentTransfer> element.
1763
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feFuncG
1764
+ *
1765
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeFuncGElement }
1766
+ */
1767
+ export const feFuncG = elements.feFuncG
1768
+
1769
+ /**
1770
+ * The <feFuncR> SVG filter primitive defines the transfer function for the red component of the input graphic of its parent <feComponentTransfer> element.
1771
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feFuncR
1772
+ *
1773
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeFuncRElement }
1774
+ */
1775
+ export const feFuncR = elements.feFuncR
1776
+
1777
+ /**
1778
+ * The <feGaussianBlur> SVG filter primitive blurs the input image by the amount specified in stdDeviation, which defines the bell-curve.
1779
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feGaussianBlur
1780
+ *
1781
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeGaussianBlurElement }
1782
+ */
1783
+ export const feGaussianBlur = elements.feGaussianBlur
1784
+
1785
+ /**
1786
+ * The <feImage> SVG filter primitive fetches image data from an external source and provides the pixel data as output (meaning if the external source is an SVG image, it is rasterized.)
1787
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feImage
1788
+ *
1789
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeImageElement }
1790
+ */
1791
+ export const feImage = elements.feImage
1792
+
1793
+ /**
1794
+ * The <feMerge> SVG element allows filter effects to be applied concurrently instead of sequentially. This is achieved by other filters storing their output via the result attribute and then accessing it in a <feMergeNode> child.
1795
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feMerge
1796
+ *
1797
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeMergeElement }
1798
+ */
1799
+ export const feMerge = elements.feMerge
1800
+
1801
+ /**
1802
+ * The <feMergeNode> SVG takes the result of another filter to be processed by its parent <feMerge>.
1803
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feMergeNode
1804
+ *
1805
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeMergeNodeElement }
1806
+ */
1807
+ export const feMergeNode = elements.feMergeNode
1808
+
1809
+ /**
1810
+ * The <feMorphology> SVG filter primitive is used to erode or dilate the input image. Its usefulness lies especially in fattening or thinning effects.
1811
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feMorphology
1812
+ *
1813
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeMorphologyElement }
1814
+ */
1815
+ export const feMorphology = elements.feMorphology
1816
+
1817
+ /**
1818
+ * The <feOffset> SVG filter primitive enables offsetting an input image relative to its current position. The input image as a whole is offset by the values specified in the dx and dy attributes.
1819
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feOffset
1820
+ *
1821
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeOffsetElement }
1822
+ */
1823
+ export const feOffset = elements.feOffset
1824
+
1825
+ /**
1826
+ * The <fePointLight> SVG filter primitive defines a light source which allows to create a point light effect. It that can be used within a lighting filter primitive: <feDiffuseLighting> or <feSpecularLighting>.
1827
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/fePointLight
1828
+ *
1829
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFePointLightElement }
1830
+ */
1831
+ export const fePointLight = elements.fePointLight
1832
+
1833
+ /**
1834
+ * The <feSpecularLighting> SVG filter primitive lights a source graphic using the alpha channel as a bump map. The resulting image is an RGBA image based on the light color. The lighting calculation follows the standard specular component of the Phong lighting model. The resulting image depends on the light color, light position and surface geometry of the input bump map. The result of the lighting calculation is added. The filter primitive assumes that the viewer is at infinity in the z direction.
1835
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feSpecularLighting
1836
+ *
1837
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeSpecularLightingElement }
1838
+ */
1839
+ export const feSpecularLighting = elements.feSpecularLighting
1840
+
1841
+ /**
1842
+ * The <feSpotLight> SVG filter primitive defines a light source that can be used to create a spotlight effect. It is used within a lighting filter primitive: <feDiffuseLighting> or <feSpecularLighting>.
1843
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feSpotLight
1844
+ *
1845
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeSpotLightElement }
1846
+ */
1847
+ export const feSpotLight = elements.feSpotLight
1848
+
1849
+ /**
1850
+ * The <feTile> SVG filter primitive allows to fill a target rectangle with a repeated, tiled pattern of an input image. The effect is similar to the one of a <pattern>.
1851
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feTile
1852
+ *
1853
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeTileElement }
1854
+ */
1855
+ export const feTile = elements.feTile
1856
+
1857
+ /**
1858
+ * The <feTurbulence> SVG filter primitive creates an image using the Perlin turbulence function. It allows the synthesis of artificial textures like clouds or marble. The resulting image will fill the entire filter primitive subregion.
1859
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/feTurbulence
1860
+ *
1861
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGFeTurbulenceElement }
1862
+ */
1863
+ export const feTurbulence = elements.feTurbulence
1864
+
1865
+ /**
1866
+ * The <linearGradient> SVG element lets authors define linear gradients to apply to other SVG elements.
1867
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/linearGradient
1868
+ *
1869
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGLinearGradientElement }
1870
+ */
1871
+ export const linearGradient = elements.linearGradient
1872
+
1873
+ /**
1874
+ * The <radialGradient> SVG element lets authors define radial gradients that can be applied to fill or stroke of graphical elements.
1875
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/radialGradient
1876
+ *
1877
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGRadialGradientElement }
1878
+ */
1879
+ export const radialGradient = elements.radialGradient
1880
+
1881
+ /**
1882
+ * The <stop> SVG element defines a color and its position to use on a gradient. This element is always a child of a <linearGradient> or <radialGradient> element.
1883
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/stop
1884
+ *
1885
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGStopElement }
1886
+ */
1887
+ export const stop = elements.stop
1888
+
1889
+ /**
1890
+ * The <foreignObject> SVG element includes elements from a different XML namespace. In the context of a browser, it is most likely (X)HTML.
1891
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/foreignObject
1892
+ *
1893
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGForeignObjectElement }
1894
+ */
1895
+ export const foreignObject = elements.foreignObject
1896
+
1897
+ /**
1898
+ * The <text> SVG element draws a graphics element consisting of text. It's possible to apply a gradient, pattern, clipping path, mask, or filter to <text>, like any other SVG graphics element.
1899
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/text
1900
+ *
1901
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGTextElement }
1902
+ */
1903
+ export const text = elements.text
1904
+
1905
+ /**
1906
+ * The <textPath> SVG element is used to render text along the shape of a <path> element. The text must be enclosed in the <textPath> element and its href attribute is used to reference the desired <path>.
1907
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/textPath
1908
+ *
1909
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGTextPathElement }
1910
+ */
1911
+ export const textPath = elements.textPath
1912
+
1913
+ /**
1914
+ * The <tspan> SVG element defines a subtext within a <text> element or another <tspan> element. It allows for adjustment of the style and/or position of that subtext as needed.
1915
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/tspan
1916
+ *
1917
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGTspanElement }
1918
+ */
1919
+ export const tspan = elements.tspan
1920
+
1921
+ /**
1922
+ * The <view> SVG element defines a particular view of an SVG document. A specific view can be displayed by referencing the <view> element's id as the target fragment of a URL.
1923
+ * https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Element/view
1924
+ *
1925
+ * @type {(props?: object, ...children: (string | number | Node)[]) => SVGViewElement }
1926
+ */
1927
+ export const view = elements.view
1928
+
1929
+ // TODO: MathML
1930
+ // https://developer.mozilla.org/en-US/docs/Web/MathML/Reference/Element
1931
+