@emuanalytics/flow-rdf-ui 4.0.14 → 4.0.16

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.
@@ -35,71 +35,6 @@
35
35
  ],
36
36
  "references": []
37
37
  },
38
- {
39
- "name": "flow-ui-badge",
40
- "description": "Badges are used to draw attention and display statuses or counts.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
41
- "attributes": [
42
- {
43
- "name": "variant",
44
- "description": "The badge's theme variant.",
45
- "values": [
46
- { "name": "primary" },
47
- { "name": "secondary" },
48
- { "name": "success" },
49
- { "name": "neutral" },
50
- { "name": "warning" },
51
- { "name": "danger" }
52
- ]
53
- },
54
- {
55
- "name": "pill",
56
- "description": "Draws a pill-style badge with rounded edges.",
57
- "values": []
58
- },
59
- {
60
- "name": "pulse",
61
- "description": "Makes the badge pulsate to draw attention.",
62
- "values": []
63
- }
64
- ],
65
- "references": []
66
- },
67
- {
68
- "name": "flow-ui-avatar",
69
- "description": "Avatars are used to represent a person or object.\n\n\n---\n\n\n\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<flow-ui-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
70
- "attributes": [
71
- {
72
- "name": "image",
73
- "description": "The image source to use for the avatar.",
74
- "values": []
75
- },
76
- {
77
- "name": "label",
78
- "description": "A label to use to describe the avatar to assistive devices.",
79
- "values": []
80
- },
81
- {
82
- "name": "initials",
83
- "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
84
- "values": []
85
- },
86
- {
87
- "name": "loading",
88
- "description": "Indicates how the browser should load the image.",
89
- "values": [{ "name": "eager" }, { "name": "lazy" }]
90
- },
91
- {
92
- "name": "shape",
93
- "description": "The shape of the avatar.",
94
- "values": [
95
- { "name": "circle" },
96
- { "name": "square" },
97
- { "name": "rounded" }
98
- ]
99
- }
100
- ],
101
- "references": []
102
- },
103
38
  {
104
39
  "name": "flow-ui-animation",
105
40
  "description": "Animate elements declaratively with over 100 animation presets. Powered by the [Web Animations API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Animations_API).\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-cancel** - Emitted when the animation is canceled.\n- **flow-ui-finish** - Emitted when the animation finishes.\n- **flow-ui-start** - Emitted when the animation starts or restarts.\n\n### **Methods:**\n - **cancel()** - Clears all keyframe effects caused by this animation and aborts its playback.\n- **finish()** - Sets the playback time to the end of the animation corresponding to the current playback direction.\n\n### **Slots:**\n - _default_ - The element to animate. Avoid slotting in more than one element, as subsequent ones will be ignored. To animate multiple elements, either wrap them in a single container or use multiple `<flow-ui-animation>` elements.",
@@ -163,28 +98,37 @@
163
98
  "references": []
164
99
  },
165
100
  {
166
- "name": "flow-ui-breadcrumb-item",
167
- "description": "Breadcrumb Items are used inside [breadcrumbs](./flow-ui-breadcrumb) to represent different links.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The breadcrumb item's label.\n- **prefix** - An optional prefix, usually an icon or icon button.\n- **suffix** - An optional suffix, usually an icon or icon button.\n- **separator** - The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `<flow-ui-breadcrumb>` instead.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The breadcrumb item's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.\n- **separator** - The container that wraps the separator.",
101
+ "name": "flow-ui-avatar",
102
+ "description": "Avatars are used to represent a person or object.\n\n\n---\n\n\n\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<flow-ui-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
168
103
  "attributes": [
169
104
  {
170
- "name": "href",
171
- "description": "Optional URL to direct the user to when the breadcrumb item is activated. When set, a link will be rendered\ninternally. When unset, a button will be rendered instead.",
105
+ "name": "image",
106
+ "description": "The image source to use for the avatar.",
172
107
  "values": []
173
108
  },
174
109
  {
175
- "name": "target",
176
- "description": "Tells the browser where to open the link. Only used when `href` is set.",
177
- "values": [
178
- { "name": "_blank" },
179
- { "name": "_parent" },
180
- { "name": "_self" },
181
- { "name": "_top" }
182
- ]
110
+ "name": "label",
111
+ "description": "A label to use to describe the avatar to assistive devices.",
112
+ "values": []
183
113
  },
184
114
  {
185
- "name": "rel",
186
- "description": "The `rel` attribute to use on the link. Only used when `href` is set.",
115
+ "name": "initials",
116
+ "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
187
117
  "values": []
118
+ },
119
+ {
120
+ "name": "loading",
121
+ "description": "Indicates how the browser should load the image.",
122
+ "values": [{ "name": "eager" }, { "name": "lazy" }]
123
+ },
124
+ {
125
+ "name": "shape",
126
+ "description": "The shape of the avatar.",
127
+ "values": [
128
+ { "name": "circle" },
129
+ { "name": "square" },
130
+ { "name": "rounded" }
131
+ ]
188
132
  }
189
133
  ],
190
134
  "references": []
@@ -339,6 +283,33 @@
339
283
  ],
340
284
  "references": []
341
285
  },
286
+ {
287
+ "name": "flow-ui-breadcrumb-item",
288
+ "description": "Breadcrumb Items are used inside [breadcrumbs](./flow-ui-breadcrumb) to represent different links.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The breadcrumb item's label.\n- **prefix** - An optional prefix, usually an icon or icon button.\n- **suffix** - An optional suffix, usually an icon or icon button.\n- **separator** - The separator to use for the breadcrumb item. This will only change the separator for this item. If you want to change it for all items in the group, set the separator on `<flow-ui-breadcrumb>` instead.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The breadcrumb item's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.\n- **separator** - The container that wraps the separator.",
289
+ "attributes": [
290
+ {
291
+ "name": "href",
292
+ "description": "Optional URL to direct the user to when the breadcrumb item is activated. When set, a link will be rendered\ninternally. When unset, a button will be rendered instead.",
293
+ "values": []
294
+ },
295
+ {
296
+ "name": "target",
297
+ "description": "Tells the browser where to open the link. Only used when `href` is set.",
298
+ "values": [
299
+ { "name": "_blank" },
300
+ { "name": "_parent" },
301
+ { "name": "_self" },
302
+ { "name": "_top" }
303
+ ]
304
+ },
305
+ {
306
+ "name": "rel",
307
+ "description": "The `rel` attribute to use on the link. Only used when `href` is set.",
308
+ "values": []
309
+ }
310
+ ],
311
+ "references": []
312
+ },
342
313
  {
343
314
  "name": "flow-ui-button-group",
344
315
  "description": "Button groups can be used to group related buttons into sections.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - One or more `<flow-ui-button>` elements to display in the button group.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -368,6 +339,35 @@
368
339
  ],
369
340
  "references": []
370
341
  },
342
+ {
343
+ "name": "flow-ui-badge",
344
+ "description": "Badges are used to draw attention and display statuses or counts.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
345
+ "attributes": [
346
+ {
347
+ "name": "variant",
348
+ "description": "The badge's theme variant.",
349
+ "values": [
350
+ { "name": "primary" },
351
+ { "name": "secondary" },
352
+ { "name": "success" },
353
+ { "name": "neutral" },
354
+ { "name": "warning" },
355
+ { "name": "danger" }
356
+ ]
357
+ },
358
+ {
359
+ "name": "pill",
360
+ "description": "Draws a pill-style badge with rounded edges.",
361
+ "values": []
362
+ },
363
+ {
364
+ "name": "pulse",
365
+ "description": "Makes the badge pulsate to draw attention.",
366
+ "values": []
367
+ }
368
+ ],
369
+ "references": []
370
+ },
371
371
  {
372
372
  "name": "flow-ui-calendar",
373
373
  "description": "A calendar component for selecting dates and times.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-input** - Emitted when the calendar value changes.\n- **flow-ui-change** - Emitted when the calendar value changes.\n\n### **CSS Properties:**\n - **--width** - The width of the calendar in CSS units. Set automatically if `size` is set. _(default: undefined)_\n- **--font-size** - The font size of the calendar. Set automatically if `size` is set. _(default: undefined)_\n- **--day-font-size** - The font size of the day labels. Set automatically if `size` is set. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -1117,6 +1117,97 @@
1117
1117
  ],
1118
1118
  "references": []
1119
1119
  },
1120
+ {
1121
+ "name": "flow-ui-icon-button",
1122
+ "description": "Icons buttons are simple, icon-only buttons that can be used for actions and in toolbars.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the icon button loses focus.\n- **flow-ui-focus** - Emitted when the icon button gains focus.\n\n### **Methods:**\n - **click()** - Simulates a click on the icon button.\n- **focus(options: _FocusOptions_)** - Sets focus on the icon button.\n- **blur()** - Removes focus from the icon button.\n- **hideConfirm()** - Hide the confirmation tooltip if it is showing\n- **showConfirm()** - Show the confirmation tooltip\n\n### **Slots:**\n - **tooltip** - The tooltip content to display when the user hovers over the icon button. Alternatively, you can use the `tooltip` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
1123
+ "attributes": [
1124
+ {
1125
+ "name": "name",
1126
+ "description": "The name of the icon to draw. Available names depend on the icon library being used.",
1127
+ "values": []
1128
+ },
1129
+ {
1130
+ "name": "library",
1131
+ "description": "The name of a registered custom icon library.",
1132
+ "values": []
1133
+ },
1134
+ {
1135
+ "name": "src",
1136
+ "description": "An external URL of an SVG file. Be sure you trust the content you are including, as it will be executed as code and\ncan result in XSS attacks.",
1137
+ "values": []
1138
+ },
1139
+ {
1140
+ "name": "href",
1141
+ "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
1142
+ "values": []
1143
+ },
1144
+ {
1145
+ "name": "target",
1146
+ "description": "Tells the browser where to open the link. Only used when `href` is set.",
1147
+ "values": [
1148
+ { "name": "_blank" },
1149
+ { "name": "_parent" },
1150
+ { "name": "_self" },
1151
+ { "name": "_top" }
1152
+ ]
1153
+ },
1154
+ {
1155
+ "name": "download",
1156
+ "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
1157
+ "values": []
1158
+ },
1159
+ {
1160
+ "name": "label",
1161
+ "description": "A description that gets read by assistive devices. For optimal accessibility, you should always include a label\nthat describes what the icon button does.",
1162
+ "values": []
1163
+ },
1164
+ {
1165
+ "name": "tooltip",
1166
+ "description": "Tooltip text that gets displayed when the user hovers over the icon button. If you need to display HTML, use the\n`tooltip` slot instead.",
1167
+ "values": []
1168
+ },
1169
+ {
1170
+ "name": "tooltip-placement",
1171
+ "description": "The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip\ninside of the viewport.",
1172
+ "values": [
1173
+ { "name": "" },
1174
+ { "name": "top" },
1175
+ { "name": "top-start" },
1176
+ { "name": "top-end" },
1177
+ { "name": "right" },
1178
+ { "name": "right-start" },
1179
+ { "name": "right-end" },
1180
+ { "name": "bottom" },
1181
+ { "name": "bottom-start" },
1182
+ { "name": "bottom-end" },
1183
+ { "name": "left" },
1184
+ { "name": "left-start" },
1185
+ { "name": "left-end" }
1186
+ ]
1187
+ },
1188
+ {
1189
+ "name": "tooltip-distance",
1190
+ "description": "The distance in pixels from which to offset the tooltip away from the icon button.",
1191
+ "values": []
1192
+ },
1193
+ {
1194
+ "name": "tooltip-skidding",
1195
+ "description": "The distance in pixels from which to offset the tooltip along the icon button.",
1196
+ "values": []
1197
+ },
1198
+ {
1199
+ "name": "disabled",
1200
+ "description": "Disables the button.",
1201
+ "values": []
1202
+ },
1203
+ {
1204
+ "name": "confirm",
1205
+ "description": "Confirmation text that gets displayed in a tooltip when the user clicks the icon button.\n If you need to display HTML, use the `confirm` slot instead.",
1206
+ "values": []
1207
+ }
1208
+ ],
1209
+ "references": []
1210
+ },
1120
1211
  {
1121
1212
  "name": "flow-ui-input",
1122
1213
  "description": "Inputs collect data from the user.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the control loses focus.\n- **flow-ui-change** - Emitted when an alteration to the control's value is committed by the user.\n- **flow-ui-clear** - Emitted when the clear button is activated.\n- **flow-ui-focus** - Emitted when the control gains focus.\n- **flow-ui-input** - Emitted when the control receives input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the input.\n- **blur()** - Removes focus from the input.\n- **select()** - Selects all the text in the input.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **showPicker()** - Displays the browser picker for an input element (only works if the browser supports it for the input type).\n- **stepUp()** - Increments the value of a numeric input type by the value of the step attribute.\n- **stepDown()** - Decrements the value of a numeric input type by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the input.\n- **suffix** - Used to append a presentational icon or similar element to the input.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **show-password-icon** - An icon to use in lieu of the default show password icon.\n- **hide-password-icon** - An icon to use in lieu of the default hide password icon.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` control.\n- **prefix** - The container that wraps the prefix.\n- **clear-button** - The clear button.\n- **password-toggle-button** - The password toggle button.\n- **suffix** - The container that wraps the suffix.",
@@ -1404,6 +1495,12 @@
1404
1495
  ],
1405
1496
  "references": []
1406
1497
  },
1498
+ {
1499
+ "name": "flow-ui-menu-label",
1500
+ "description": "Menu labels are used to describe a group of menu items.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The menu label's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
1501
+ "attributes": [],
1502
+ "references": []
1503
+ },
1407
1504
  {
1408
1505
  "name": "flow-ui-mutation-observer",
1409
1506
  "description": "The Mutation Observer component offers a thin, declarative interface to the [`MutationObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver).\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-mutation** - Emitted when a mutation occurs.\n\n### **Slots:**\n - _default_ - The content to watch for mutations.",
@@ -1512,133 +1609,163 @@
1512
1609
  "references": []
1513
1610
  },
1514
1611
  {
1515
- "name": "flow-ui-progress-bar",
1516
- "description": "Progress bars are used to show the status of an ongoing operation.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
1612
+ "name": "flow-ui-popup",
1613
+ "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--flow-ui-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.\n- **hover-bridge** - The hover bridge element. Only available when the `hover-bridge` option is enabled.",
1517
1614
  "attributes": [
1518
1615
  {
1519
- "name": "value",
1520
- "description": "The current progress as a percentage, 0 to 100.",
1616
+ "name": "anchor",
1617
+ "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
1618
+ "values": [{ "name": "Element" }, { "name": "VirtualElement" }]
1619
+ },
1620
+ {
1621
+ "name": "active",
1622
+ "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
1521
1623
  "values": []
1522
1624
  },
1523
1625
  {
1524
- "name": "indeterminate",
1525
- "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
1626
+ "name": "placement",
1627
+ "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
1628
+ "values": [
1629
+ { "name": "" },
1630
+ { "name": "top" },
1631
+ { "name": "top-start" },
1632
+ { "name": "top-end" },
1633
+ { "name": "bottom" },
1634
+ { "name": "bottom-start" },
1635
+ { "name": "bottom-end" },
1636
+ { "name": "right" },
1637
+ { "name": "right-start" },
1638
+ { "name": "right-end" },
1639
+ { "name": "left" },
1640
+ { "name": "left-start" },
1641
+ { "name": "left-end" }
1642
+ ]
1643
+ },
1644
+ {
1645
+ "name": "strategy",
1646
+ "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
1647
+ "values": [{ "name": "absolute" }, { "name": "fixed" }]
1648
+ },
1649
+ {
1650
+ "name": "distance",
1651
+ "description": "The distance in pixels from which to offset the panel away from its anchor.",
1526
1652
  "values": []
1527
1653
  },
1528
1654
  {
1529
- "name": "label",
1530
- "description": "A custom label for assistive devices.",
1655
+ "name": "skidding",
1656
+ "description": "The distance in pixels from which to offset the panel along its anchor.",
1531
1657
  "values": []
1532
- }
1533
- ],
1534
- "references": []
1535
- },
1536
- {
1537
- "name": "flow-ui-menu-label",
1538
- "description": "Menu labels are used to describe a group of menu items.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The menu label's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
1539
- "attributes": [],
1540
- "references": []
1541
- },
1542
- {
1543
- "name": "flow-ui-icon-button",
1544
- "description": "Icons buttons are simple, icon-only buttons that can be used for actions and in toolbars.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the icon button loses focus.\n- **flow-ui-focus** - Emitted when the icon button gains focus.\n\n### **Methods:**\n - **click()** - Simulates a click on the icon button.\n- **focus(options: _FocusOptions_)** - Sets focus on the icon button.\n- **blur()** - Removes focus from the icon button.\n- **hideConfirm()** - Hide the confirmation tooltip if it is showing\n- **showConfirm()** - Show the confirmation tooltip\n\n### **Slots:**\n - **tooltip** - The tooltip content to display when the user hovers over the icon button. Alternatively, you can use the `tooltip` attribute.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
1545
- "attributes": [
1658
+ },
1546
1659
  {
1547
- "name": "name",
1548
- "description": "The name of the icon to draw. Available names depend on the icon library being used.",
1660
+ "name": "arrow",
1661
+ "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
1549
1662
  "values": []
1550
1663
  },
1551
1664
  {
1552
- "name": "library",
1553
- "description": "The name of a registered custom icon library.",
1665
+ "name": "arrow-placement",
1666
+ "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
1667
+ "values": [
1668
+ { "name": "start" },
1669
+ { "name": "end" },
1670
+ { "name": "center" },
1671
+ { "name": "anchor" }
1672
+ ]
1673
+ },
1674
+ {
1675
+ "name": "arrow-padding",
1676
+ "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
1554
1677
  "values": []
1555
1678
  },
1556
1679
  {
1557
- "name": "src",
1558
- "description": "An external URL of an SVG file. Be sure you trust the content you are including, as it will be executed as code and\ncan result in XSS attacks.",
1680
+ "name": "flip",
1681
+ "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
1559
1682
  "values": []
1560
1683
  },
1561
1684
  {
1562
- "name": "href",
1563
- "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
1685
+ "name": "flip-fallback-placements",
1686
+ "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
1564
1687
  "values": []
1565
1688
  },
1566
1689
  {
1567
- "name": "target",
1568
- "description": "Tells the browser where to open the link. Only used when `href` is set.",
1569
- "values": [
1570
- { "name": "_blank" },
1571
- { "name": "_parent" },
1572
- { "name": "_self" },
1573
- { "name": "_top" }
1574
- ]
1690
+ "name": "flip-fallback-strategy",
1691
+ "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
1692
+ "values": [{ "name": "best-fit" }, { "name": "initial" }]
1575
1693
  },
1576
1694
  {
1577
- "name": "download",
1578
- "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
1695
+ "name": "flipBoundary",
1696
+ "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1697
+ "values": [{ "name": "Element" }, { "name": "Element[]" }]
1698
+ },
1699
+ {
1700
+ "name": "flip-padding",
1701
+ "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
1579
1702
  "values": []
1580
1703
  },
1581
1704
  {
1582
- "name": "label",
1583
- "description": "A description that gets read by assistive devices. For optimal accessibility, you should always include a label\nthat describes what the icon button does.",
1705
+ "name": "shift",
1706
+ "description": "Moves the popup along the axis to keep it in view when clipped.",
1584
1707
  "values": []
1585
1708
  },
1586
1709
  {
1587
- "name": "tooltip",
1588
- "description": "Tooltip text that gets displayed when the user hovers over the icon button. If you need to display HTML, use the\n`tooltip` slot instead.",
1710
+ "name": "shiftBoundary",
1711
+ "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1712
+ "values": [{ "name": "Element" }, { "name": "Element[]" }]
1713
+ },
1714
+ {
1715
+ "name": "shift-padding",
1716
+ "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
1589
1717
  "values": []
1590
1718
  },
1591
1719
  {
1592
- "name": "tooltip-placement",
1593
- "description": "The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip\ninside of the viewport.",
1720
+ "name": "auto-size",
1721
+ "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
1594
1722
  "values": [
1595
- { "name": "" },
1596
- { "name": "top" },
1597
- { "name": "top-start" },
1598
- { "name": "top-end" },
1599
- { "name": "right" },
1600
- { "name": "right-start" },
1601
- { "name": "right-end" },
1602
- { "name": "bottom" },
1603
- { "name": "bottom-start" },
1604
- { "name": "bottom-end" },
1605
- { "name": "left" },
1606
- { "name": "left-start" },
1607
- { "name": "left-end" }
1723
+ { "name": "horizontal" },
1724
+ { "name": "vertical" },
1725
+ { "name": "both" }
1608
1726
  ]
1609
1727
  },
1610
1728
  {
1611
- "name": "tooltip-distance",
1612
- "description": "The distance in pixels from which to offset the tooltip away from the icon button.",
1613
- "values": []
1729
+ "name": "sync",
1730
+ "description": "Syncs the popup's width or height to that of the anchor element.",
1731
+ "values": [
1732
+ { "name": "width" },
1733
+ { "name": "height" },
1734
+ { "name": "both" }
1735
+ ]
1614
1736
  },
1615
1737
  {
1616
- "name": "tooltip-skidding",
1617
- "description": "The distance in pixels from which to offset the tooltip along the icon button.",
1618
- "values": []
1738
+ "name": "autoSizeBoundary",
1739
+ "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1740
+ "values": [{ "name": "Element" }, { "name": "Element[]" }]
1619
1741
  },
1620
1742
  {
1621
- "name": "disabled",
1622
- "description": "Disables the button.",
1743
+ "name": "auto-size-padding",
1744
+ "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
1623
1745
  "values": []
1624
1746
  },
1625
1747
  {
1626
- "name": "confirm",
1627
- "description": "Confirmation text that gets displayed in a tooltip when the user clicks the icon button.\n If you need to display HTML, use the `confirm` slot instead.",
1748
+ "name": "hover-bridge",
1749
+ "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
1628
1750
  "values": []
1629
1751
  }
1630
1752
  ],
1631
1753
  "references": []
1632
1754
  },
1633
1755
  {
1634
- "name": "flow-ui-progress-ring",
1635
- "description": "Progress rings are used to show the progress of a determinate operation in a circular fashion.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - A label to show inside the ring.\n\n### **CSS Properties:**\n - **--size** - The diameter of the progress ring (cannot be a percentage). _(default: undefined)_\n- **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-width** - The width of the indicator. Defaults to the track width. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--indicator-transition-duration** - The duration of the indicator's transition when the value changes. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The progress ring label.",
1756
+ "name": "flow-ui-progress-bar",
1757
+ "description": "Progress bars are used to show the status of an ongoing operation.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
1636
1758
  "attributes": [
1637
1759
  {
1638
1760
  "name": "value",
1639
1761
  "description": "The current progress as a percentage, 0 to 100.",
1640
1762
  "values": []
1641
1763
  },
1764
+ {
1765
+ "name": "indeterminate",
1766
+ "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
1767
+ "values": []
1768
+ },
1642
1769
  {
1643
1770
  "name": "label",
1644
1771
  "description": "A custom label for assistive devices.",
@@ -1648,62 +1775,17 @@
1648
1775
  "references": []
1649
1776
  },
1650
1777
  {
1651
- "name": "flow-ui-radio-group",
1652
- "description": "Radio groups are used to group multiple [radios](/components/radio) or [radio buttons](/components/radio-button) so they function as a single form control.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-change** - Emitted when the radio group's selected value changes.\n- **flow-ui-input** - Emitted when the radio group receives user input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where `<flow-ui-radio>` or `<flow-ui-tool-button>` elements are placed.\n- **label** - The radio group's label. Required for proper accessibility. Alternatively, you can use the `label` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-group** - The button group that wraps radio buttons.\n- **button-group__base** - The button group's `base` part.",
1778
+ "name": "flow-ui-progress-ring",
1779
+ "description": "Progress rings are used to show the progress of a determinate operation in a circular fashion.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - A label to show inside the ring.\n\n### **CSS Properties:**\n - **--size** - The diameter of the progress ring (cannot be a percentage). _(default: undefined)_\n- **--track-width** - The width of the track. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-width** - The width of the indicator. Defaults to the track width. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--indicator-transition-duration** - The duration of the indicator's transition when the value changes. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **label** - The progress ring label.",
1653
1780
  "attributes": [
1654
- {
1655
- "name": "label",
1656
- "description": "The radio group's label. Required for proper accessibility. If you need to display HTML, use the `label` slot\ninstead.",
1657
- "values": []
1658
- },
1659
- {
1660
- "name": "help-text",
1661
- "description": "The radio groups's help text. If you need to display HTML, use the `help-text` slot instead.",
1662
- "values": []
1663
- },
1664
- {
1665
- "name": "name",
1666
- "description": "The name of the radio group, submitted as a name/value pair with form data.",
1667
- "values": []
1668
- },
1669
1781
  {
1670
1782
  "name": "value",
1671
- "description": "The current value of the radio group, submitted as a name/value pair with form data.",
1672
- "values": []
1673
- },
1674
- {
1675
- "name": "size",
1676
- "description": "The radio group's size. This size will be applied to all child radios and radio buttons.",
1677
- "values": [
1678
- { "name": "small" },
1679
- { "name": "medium" },
1680
- { "name": "large" }
1681
- ]
1682
- },
1683
- {
1684
- "name": "variant",
1685
- "values": [
1686
- { "name": "primary" },
1687
- { "name": "secondary" },
1688
- { "name": "success" },
1689
- { "name": "warning" },
1690
- { "name": "danger" },
1691
- { "name": "neutral" }
1692
- ]
1693
- },
1694
- {
1695
- "name": "form",
1696
- "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1697
- "values": []
1698
- },
1699
- {
1700
- "name": "required",
1701
- "description": "Ensures a child radio is checked before allowing the containing form to submit.",
1783
+ "description": "The current progress as a percentage, 0 to 100.",
1702
1784
  "values": []
1703
1785
  },
1704
1786
  {
1705
- "name": "full-width",
1706
- "description": "Display the radio group using the alternative 'full-width' style with left-aligned label.",
1787
+ "name": "label",
1788
+ "description": "A custom label for assistive devices.",
1707
1789
  "values": []
1708
1790
  }
1709
1791
  ],
@@ -1789,217 +1871,135 @@
1789
1871
  "references": []
1790
1872
  },
1791
1873
  {
1792
- "name": "flow-ui-range",
1793
- "description": "Ranges allow the user to select a single value within a given range using a slider.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the control loses focus.\n- **flow-ui-change** - Emitted when an alteration to the control's value is committed by the user.\n- **flow-ui-focus** - Emitted when the control gains focus.\n- **flow-ui-input** - Emitted when the control receives input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the range.\n- **blur()** - Removes focus from the range.\n- **stepUp()** - Increments the value of the range by the value of the step attribute.\n- **stepDown()** - Decrements the value of the range by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The range's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--thumb-size** - The size of the thumb. _(default: undefined)_\n- **--tooltip-offset** - The vertical distance the tooltip is offset from the track. _(default: undefined)_\n- **--track-color-active** - The color of the portion of the track that represents the current value. _(default: undefined)_\n- **--track-color-inactive** - The of the portion of the track that represents the remaining value. _(default: undefined)_\n- **--track-height** - The height of the track. _(default: undefined)_\n- **--track-active-offset** - The point of origin of the active track. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The range's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` element.\n- **tooltip** - The range's tooltip.",
1874
+ "name": "flow-ui-radio-group",
1875
+ "description": "Radio groups are used to group multiple [radios](/components/radio) or [radio buttons](/components/radio-button) so they function as a single form control.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-change** - Emitted when the radio group's selected value changes.\n- **flow-ui-input** - Emitted when the radio group receives user input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The default slot where `<flow-ui-radio>` or `<flow-ui-tool-button>` elements are placed.\n- **label** - The radio group's label. Required for proper accessibility. Alternatively, you can use the `label` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **button-group** - The button group that wraps radio buttons.\n- **button-group__base** - The button group's `base` part.",
1794
1876
  "attributes": [
1795
- {
1796
- "name": "name",
1797
- "description": "The name of the range, submitted as a name/value pair with form data.",
1798
- "values": []
1799
- },
1800
- {
1801
- "name": "value",
1802
- "description": "The current value of the range, submitted as a name/value pair with form data.",
1803
- "values": []
1804
- },
1805
1877
  {
1806
1878
  "name": "label",
1807
- "description": "The range's label. If you need to display HTML, use the `label` slot instead.",
1879
+ "description": "The radio group's label. Required for proper accessibility. If you need to display HTML, use the `label` slot\ninstead.",
1808
1880
  "values": []
1809
1881
  },
1810
1882
  {
1811
1883
  "name": "help-text",
1812
- "description": "The range's help text. If you need to display HTML, use the help-text slot instead.",
1813
- "values": []
1814
- },
1815
- {
1816
- "name": "disabled",
1817
- "description": "Disables the range.",
1884
+ "description": "The radio groups's help text. If you need to display HTML, use the `help-text` slot instead.",
1818
1885
  "values": []
1819
1886
  },
1820
1887
  {
1821
- "name": "min",
1822
- "description": "The minimum acceptable value of the range.",
1888
+ "name": "name",
1889
+ "description": "The name of the radio group, submitted as a name/value pair with form data.",
1823
1890
  "values": []
1824
1891
  },
1825
1892
  {
1826
- "name": "max",
1827
- "description": "The maximum acceptable value of the range.",
1893
+ "name": "value",
1894
+ "description": "The current value of the radio group, submitted as a name/value pair with form data.",
1828
1895
  "values": []
1829
1896
  },
1830
1897
  {
1831
- "name": "step",
1832
- "description": "The interval at which the range will increase and decrease.",
1833
- "values": []
1898
+ "name": "size",
1899
+ "description": "The radio group's size. This size will be applied to all child radios and radio buttons.",
1900
+ "values": [
1901
+ { "name": "small" },
1902
+ { "name": "medium" },
1903
+ { "name": "large" }
1904
+ ]
1834
1905
  },
1835
1906
  {
1836
- "name": "tooltip",
1837
- "description": "The preferred placement of the range's tooltip.",
1907
+ "name": "variant",
1838
1908
  "values": [
1839
- { "name": "top" },
1840
- { "name": "bottom" },
1841
- { "name": "none" }
1909
+ { "name": "primary" },
1910
+ { "name": "secondary" },
1911
+ { "name": "success" },
1912
+ { "name": "warning" },
1913
+ { "name": "danger" },
1914
+ { "name": "neutral" }
1842
1915
  ]
1843
1916
  },
1844
1917
  {
1845
1918
  "name": "form",
1846
1919
  "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1847
1920
  "values": []
1848
- }
1849
- ],
1850
- "references": []
1851
- },
1852
- {
1853
- "name": "flow-ui-resize-observer",
1854
- "description": "The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-resize** - Emitted when the element is resized.\n\n### **Slots:**\n - _default_ - One or more elements to watch for resizing.",
1855
- "attributes": [
1921
+ },
1856
1922
  {
1857
- "name": "disabled",
1858
- "description": "Disables the observer.",
1923
+ "name": "required",
1924
+ "description": "Ensures a child radio is checked before allowing the containing form to submit.",
1925
+ "values": []
1926
+ },
1927
+ {
1928
+ "name": "full-width",
1929
+ "description": "Display the radio group using the alternative 'full-width' style with left-aligned label.",
1859
1930
  "values": []
1860
1931
  }
1861
1932
  ],
1862
1933
  "references": []
1863
1934
  },
1864
1935
  {
1865
- "name": "flow-ui-popup",
1866
- "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--flow-ui-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.\n- **hover-bridge** - The hover bridge element. Only available when the `hover-bridge` option is enabled.",
1936
+ "name": "flow-ui-range",
1937
+ "description": "Ranges allow the user to select a single value within a given range using a slider.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the control loses focus.\n- **flow-ui-change** - Emitted when an alteration to the control's value is committed by the user.\n- **flow-ui-focus** - Emitted when the control gains focus.\n- **flow-ui-input** - Emitted when the control receives input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the range.\n- **blur()** - Removes focus from the range.\n- **stepUp()** - Increments the value of the range by the value of the step attribute.\n- **stepDown()** - Decrements the value of the range by the value of the step attribute.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The range's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--thumb-size** - The size of the thumb. _(default: undefined)_\n- **--tooltip-offset** - The vertical distance the tooltip is offset from the track. _(default: undefined)_\n- **--track-color-active** - The color of the portion of the track that represents the current value. _(default: undefined)_\n- **--track-color-inactive** - The of the portion of the track that represents the remaining value. _(default: undefined)_\n- **--track-height** - The height of the track. _(default: undefined)_\n- **--track-active-offset** - The point of origin of the active track. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The range's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **input** - The internal `<input>` element.\n- **tooltip** - The range's tooltip.",
1867
1938
  "attributes": [
1868
1939
  {
1869
- "name": "anchor",
1870
- "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide the anchor\nelement `id`, a DOM element reference, or a `VirtualElement`. If the anchor lives inside the popup, use the\n`anchor` slot instead.",
1871
- "values": [{ "name": "Element" }, { "name": "VirtualElement" }]
1872
- },
1873
- {
1874
- "name": "active",
1875
- "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
1876
- "values": []
1877
- },
1878
- {
1879
- "name": "placement",
1880
- "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
1881
- "values": [
1882
- { "name": "" },
1883
- { "name": "top" },
1884
- { "name": "top-start" },
1885
- { "name": "top-end" },
1886
- { "name": "bottom" },
1887
- { "name": "bottom-start" },
1888
- { "name": "bottom-end" },
1889
- { "name": "right" },
1890
- { "name": "right-start" },
1891
- { "name": "right-end" },
1892
- { "name": "left" },
1893
- { "name": "left-start" },
1894
- { "name": "left-end" }
1895
- ]
1896
- },
1897
- {
1898
- "name": "strategy",
1899
- "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if overflow is\nclipped, using a `fixed` position strategy can often workaround it.",
1900
- "values": [{ "name": "absolute" }, { "name": "fixed" }]
1901
- },
1902
- {
1903
- "name": "distance",
1904
- "description": "The distance in pixels from which to offset the panel away from its anchor.",
1905
- "values": []
1906
- },
1907
- {
1908
- "name": "skidding",
1909
- "description": "The distance in pixels from which to offset the panel along its anchor.",
1910
- "values": []
1911
- },
1912
- {
1913
- "name": "arrow",
1914
- "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
1915
- "values": []
1916
- },
1917
- {
1918
- "name": "arrow-placement",
1919
- "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
1920
- "values": [
1921
- { "name": "start" },
1922
- { "name": "end" },
1923
- { "name": "center" },
1924
- { "name": "anchor" }
1925
- ]
1926
- },
1927
- {
1928
- "name": "arrow-padding",
1929
- "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
1930
- "values": []
1931
- },
1932
- {
1933
- "name": "flip",
1934
- "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
1935
- "values": []
1936
- },
1937
- {
1938
- "name": "flip-fallback-placements",
1939
- "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
1940
+ "name": "name",
1941
+ "description": "The name of the range, submitted as a name/value pair with form data.",
1940
1942
  "values": []
1941
1943
  },
1942
1944
  {
1943
- "name": "flip-fallback-strategy",
1944
- "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
1945
- "values": [{ "name": "best-fit" }, { "name": "initial" }]
1945
+ "name": "value",
1946
+ "description": "The current value of the range, submitted as a name/value pair with form data.",
1947
+ "values": []
1946
1948
  },
1947
1949
  {
1948
- "name": "flipBoundary",
1949
- "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1950
- "values": [{ "name": "Element" }, { "name": "Element[]" }]
1950
+ "name": "label",
1951
+ "description": "The range's label. If you need to display HTML, use the `label` slot instead.",
1952
+ "values": []
1951
1953
  },
1952
1954
  {
1953
- "name": "flip-padding",
1954
- "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
1955
+ "name": "help-text",
1956
+ "description": "The range's help text. If you need to display HTML, use the help-text slot instead.",
1955
1957
  "values": []
1956
1958
  },
1957
1959
  {
1958
- "name": "shift",
1959
- "description": "Moves the popup along the axis to keep it in view when clipped.",
1960
+ "name": "disabled",
1961
+ "description": "Disables the range.",
1960
1962
  "values": []
1961
1963
  },
1962
1964
  {
1963
- "name": "shiftBoundary",
1964
- "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1965
- "values": [{ "name": "Element" }, { "name": "Element[]" }]
1965
+ "name": "min",
1966
+ "description": "The minimum acceptable value of the range.",
1967
+ "values": []
1966
1968
  },
1967
1969
  {
1968
- "name": "shift-padding",
1969
- "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
1970
+ "name": "max",
1971
+ "description": "The maximum acceptable value of the range.",
1970
1972
  "values": []
1971
1973
  },
1972
1974
  {
1973
- "name": "auto-size",
1974
- "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
1975
- "values": [
1976
- { "name": "horizontal" },
1977
- { "name": "vertical" },
1978
- { "name": "both" }
1979
- ]
1975
+ "name": "step",
1976
+ "description": "The interval at which the range will increase and decrease.",
1977
+ "values": []
1980
1978
  },
1981
1979
  {
1982
- "name": "sync",
1983
- "description": "Syncs the popup's width or height to that of the anchor element.",
1980
+ "name": "tooltip",
1981
+ "description": "The preferred placement of the range's tooltip.",
1984
1982
  "values": [
1985
- { "name": "width" },
1986
- { "name": "height" },
1987
- { "name": "both" }
1983
+ { "name": "top" },
1984
+ { "name": "bottom" },
1985
+ { "name": "none" }
1988
1986
  ]
1989
1987
  },
1990
1988
  {
1991
- "name": "autoSizeBoundary",
1992
- "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1993
- "values": [{ "name": "Element" }, { "name": "Element[]" }]
1994
- },
1995
- {
1996
- "name": "auto-size-padding",
1997
- "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
1989
+ "name": "form",
1990
+ "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
1998
1991
  "values": []
1999
- },
1992
+ }
1993
+ ],
1994
+ "references": []
1995
+ },
1996
+ {
1997
+ "name": "flow-ui-resize-observer",
1998
+ "description": "The Resize Observer component offers a thin, declarative interface to the [`ResizeObserver API`](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver).\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-resize** - Emitted when the element is resized.\n\n### **Slots:**\n - _default_ - One or more elements to watch for resizing.",
1999
+ "attributes": [
2000
2000
  {
2001
- "name": "hover-bridge",
2002
- "description": "When a gap exists between the anchor and the popup element, this option will add a \"hover bridge\" that fills the\ngap using an invisible element. This makes listening for events such as `mouseenter` and `mouseleave` more sane\nbecause the pointer never technically leaves the element. The hover bridge will only be drawn when the popover is\nactive.",
2001
+ "name": "disabled",
2002
+ "description": "Disables the observer.",
2003
2003
  "values": []
2004
2004
  }
2005
2005
  ],
@@ -2202,12 +2202,6 @@
2202
2202
  ],
2203
2203
  "references": []
2204
2204
  },
2205
- {
2206
- "name": "flow-ui-stepper",
2207
- "description": "Steppers are used to guide users through a series of steps in a wizard-like UI.\n\n\n---\n\n\n\n\n### **Methods:**\n - **setComplete(panelName: _string_, complete: _boolean_)** - Mark the specified panel as `complete`",
2208
- "attributes": [],
2209
- "references": []
2210
- },
2211
2205
  {
2212
2206
  "name": "flow-ui-split-view-toggle-button",
2213
2207
  "description": "Use a split panel toggle button to control a parent panel's open/closed state\n\n\n---\n\n\n",
@@ -2230,6 +2224,12 @@
2230
2224
  ],
2231
2225
  "references": []
2232
2226
  },
2227
+ {
2228
+ "name": "flow-ui-stepper",
2229
+ "description": "Steppers are used to guide users through a series of steps in a wizard-like UI.\n\n\n---\n\n\n\n\n### **Methods:**\n - **setComplete(panelName: _string_, complete: _boolean_)** - Mark the specified panel as `complete`",
2230
+ "attributes": [],
2231
+ "references": []
2232
+ },
2233
2233
  {
2234
2234
  "name": "flow-ui-stepper-panel",
2235
2235
  "description": "Stepper panels provide a single page in a stepper to guide users through a series of steps.\n\n\n---\n\n\n",
@@ -2369,6 +2369,38 @@
2369
2369
  ],
2370
2370
  "references": []
2371
2371
  },
2372
+ {
2373
+ "name": "flow-ui-tab-group",
2374
+ "description": "Tab groups organize content into a container that shows one section at a time.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-tab-show** - Emitted when a tab is shown.\n- **flow-ui-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<flow-ui-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<flow-ui-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<flow-ui-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
2375
+ "attributes": [
2376
+ {
2377
+ "name": "placement",
2378
+ "description": "The placement of the tabs.",
2379
+ "values": [
2380
+ { "name": "top" },
2381
+ { "name": "bottom" },
2382
+ { "name": "start" },
2383
+ { "name": "end" }
2384
+ ]
2385
+ },
2386
+ {
2387
+ "name": "activation",
2388
+ "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
2389
+ "values": [{ "name": "auto" }, { "name": "manual" }]
2390
+ },
2391
+ {
2392
+ "name": "no-scroll-controls",
2393
+ "description": "Disables the scroll arrows that appear when tabs overflow.",
2394
+ "values": []
2395
+ },
2396
+ {
2397
+ "name": "control-split-view",
2398
+ "description": "Set to `true` to allow parent split-view pane to be automatically opened and closed when tabs are clicked.",
2399
+ "values": []
2400
+ }
2401
+ ],
2402
+ "references": []
2403
+ },
2372
2404
  {
2373
2405
  "name": "flow-ui-tab-panel",
2374
2406
  "description": "Tab panels are used inside [tab groups](/components/tab-group) to display tabbed content.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The tab panel's content.\n\n### **CSS Properties:**\n - **--padding** - The tab panel's padding. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -2424,9 +2456,158 @@
2424
2456
  "values": []
2425
2457
  },
2426
2458
  {
2427
- "name": "removable",
2428
- "description": "Makes the tag removable and shows a remove button.",
2429
- "values": []
2459
+ "name": "removable",
2460
+ "description": "Makes the tag removable and shows a remove button.",
2461
+ "values": []
2462
+ }
2463
+ ],
2464
+ "references": []
2465
+ },
2466
+ {
2467
+ "name": "flow-ui-textarea",
2468
+ "description": "Textareas collect data from the user and allow multiple lines of text.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the control loses focus.\n- **flow-ui-change** - Emitted when an alteration to the control's value is committed by the user.\n- **flow-ui-focus** - Emitted when the control gains focus.\n- **flow-ui-input** - Emitted when the control receives input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
2469
+ "attributes": [
2470
+ {
2471
+ "name": "name",
2472
+ "description": "The name of the textarea, submitted as a name/value pair with form data.",
2473
+ "values": []
2474
+ },
2475
+ {
2476
+ "name": "value",
2477
+ "description": "The current value of the textarea, submitted as a name/value pair with form data.",
2478
+ "values": []
2479
+ },
2480
+ {
2481
+ "name": "size",
2482
+ "description": "The textarea's size.",
2483
+ "values": [
2484
+ { "name": "small" },
2485
+ { "name": "medium" },
2486
+ { "name": "large" }
2487
+ ]
2488
+ },
2489
+ {
2490
+ "name": "filled",
2491
+ "description": "Draws a filled textarea.",
2492
+ "values": []
2493
+ },
2494
+ {
2495
+ "name": "label",
2496
+ "description": "The textarea's label. If you need to display HTML, use the `label` slot instead.",
2497
+ "values": []
2498
+ },
2499
+ {
2500
+ "name": "help-text",
2501
+ "description": "The textarea's help text. If you need to display HTML, use the `help-text` slot instead.",
2502
+ "values": []
2503
+ },
2504
+ {
2505
+ "name": "placeholder",
2506
+ "description": "Placeholder text to show as a hint when the input is empty.",
2507
+ "values": []
2508
+ },
2509
+ {
2510
+ "name": "rows",
2511
+ "description": "The number of rows to display by default.",
2512
+ "values": []
2513
+ },
2514
+ {
2515
+ "name": "resize",
2516
+ "description": "Controls how the textarea can be resized.",
2517
+ "values": [
2518
+ { "name": "none" },
2519
+ { "name": "vertical" },
2520
+ { "name": "auto" }
2521
+ ]
2522
+ },
2523
+ {
2524
+ "name": "disabled",
2525
+ "description": "Disables the textarea.",
2526
+ "values": []
2527
+ },
2528
+ {
2529
+ "name": "readonly",
2530
+ "description": "Makes the textarea readonly.",
2531
+ "values": []
2532
+ },
2533
+ {
2534
+ "name": "form",
2535
+ "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
2536
+ "values": []
2537
+ },
2538
+ {
2539
+ "name": "required",
2540
+ "description": "Makes the textarea a required field.",
2541
+ "values": []
2542
+ },
2543
+ {
2544
+ "name": "minlength",
2545
+ "description": "The minimum length of input that will be considered valid.",
2546
+ "values": []
2547
+ },
2548
+ {
2549
+ "name": "maxlength",
2550
+ "description": "The maximum length of input that will be considered valid.",
2551
+ "values": []
2552
+ },
2553
+ {
2554
+ "name": "autocapitalize",
2555
+ "description": "Controls whether and how text input is automatically capitalized as it is entered by the user.",
2556
+ "values": [
2557
+ { "name": "off" },
2558
+ { "name": "none" },
2559
+ { "name": "on" },
2560
+ { "name": "sentences" },
2561
+ { "name": "words" },
2562
+ { "name": "characters" }
2563
+ ]
2564
+ },
2565
+ {
2566
+ "name": "autocorrect",
2567
+ "description": "Indicates whether the browser's autocorrect feature is on or off.",
2568
+ "values": []
2569
+ },
2570
+ {
2571
+ "name": "autocomplete",
2572
+ "description": "Specifies what permission the browser has to provide assistance in filling out form field values. Refer to\n[this page on MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) for available values.",
2573
+ "values": []
2574
+ },
2575
+ {
2576
+ "name": "autofocus",
2577
+ "description": "Indicates that the input should receive focus on page load.",
2578
+ "values": []
2579
+ },
2580
+ {
2581
+ "name": "enterkeyhint",
2582
+ "description": "Used to customize the label or icon of the Enter key on virtual keyboards.",
2583
+ "values": [
2584
+ { "name": "enter" },
2585
+ { "name": "done" },
2586
+ { "name": "go" },
2587
+ { "name": "next" },
2588
+ { "name": "previous" },
2589
+ { "name": "search" },
2590
+ { "name": "send" }
2591
+ ]
2592
+ },
2593
+ {
2594
+ "name": "spellcheck",
2595
+ "description": "Enables spell checking on the textarea.",
2596
+ "values": []
2597
+ },
2598
+ {
2599
+ "name": "inputmode",
2600
+ "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
2601
+ "values": [
2602
+ { "name": "none" },
2603
+ { "name": "text" },
2604
+ { "name": "decimal" },
2605
+ { "name": "numeric" },
2606
+ { "name": "tel" },
2607
+ { "name": "search" },
2608
+ { "name": "email" },
2609
+ { "name": "url" }
2610
+ ]
2430
2611
  }
2431
2612
  ],
2432
2613
  "references": []
@@ -2505,38 +2686,6 @@
2505
2686
  ],
2506
2687
  "references": []
2507
2688
  },
2508
- {
2509
- "name": "flow-ui-tab-group",
2510
- "description": "Tab groups organize content into a container that shows one section at a time.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-tab-show** - Emitted when a tab is shown.\n- **flow-ui-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tab group. Must be `<flow-ui-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tab group. Must be `<flow-ui-tab>` elements.\n\n### **CSS Properties:**\n - **--indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tab group's navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tab group's body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable, an `<flow-ui-icon-button>`.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.\n- **scroll-button__base** - The scroll button's exported `base` part.",
2511
- "attributes": [
2512
- {
2513
- "name": "placement",
2514
- "description": "The placement of the tabs.",
2515
- "values": [
2516
- { "name": "top" },
2517
- { "name": "bottom" },
2518
- { "name": "start" },
2519
- { "name": "end" }
2520
- ]
2521
- },
2522
- {
2523
- "name": "activation",
2524
- "description": "When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to\nmanual, the tab will receive focus but will not show until the user presses spacebar or enter.",
2525
- "values": [{ "name": "auto" }, { "name": "manual" }]
2526
- },
2527
- {
2528
- "name": "no-scroll-controls",
2529
- "description": "Disables the scroll arrows that appear when tabs overflow.",
2530
- "values": []
2531
- },
2532
- {
2533
- "name": "control-split-view",
2534
- "description": "Set to `true` to allow parent split-view pane to be automatically opened and closed when tabs are clicked.",
2535
- "values": []
2536
- }
2537
- ],
2538
- "references": []
2539
- },
2540
2689
  {
2541
2690
  "name": "flow-ui-tool-button",
2542
2691
  "description": "Tool buttons are used to build [toolbars](./flow-ui-tool-button-group). They can be used to toggle a state or perform an action.\n\n\n---\n\n\n\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the radio button.\n- **blur()** - Removes focus from the radio button.\n\n### **Slots:**\n - **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n- **icon** - The tool button's icon.\n- **tooltip** - The tool button's tooltip content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The button element.\n- **button--checked** - The button element when checked.\n- **tooltip** - The tooltip element.\n- **prefix** - The prefix slot.\n- **suffix** - The suffix slot.\n- **label-wrapper** - The wrapper that contains the icon and label.\n- **icon** - The icon slot. Alternatively, you can use the `icon` attribute.\n- **label** - The button label.",
@@ -2702,150 +2851,62 @@
2702
2851
  "references": []
2703
2852
  },
2704
2853
  {
2705
- "name": "flow-ui-textarea",
2706
- "description": "Textareas collect data from the user and allow multiple lines of text.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-blur** - Emitted when the control loses focus.\n- **flow-ui-change** - Emitted when an alteration to the control's value is committed by the user.\n- **flow-ui-focus** - Emitted when the control gains focus.\n- **flow-ui-input** - Emitted when the control receives input.\n- **flow-ui-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",
2854
+ "name": "flow-ui-tooltip",
2855
+ "description": "Tooltips display additional information based on a specific action.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-show** - Emitted when the tooltip begins to show.\n- **flow-ui-after-show** - Emitted after the tooltip has shown and all animations are complete.\n- **flow-ui-hide** - Emitted when the tooltip begins to hide.\n- **flow-ui-after-hide** - Emitted after the tooltip has hidden and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the tooltip.\n- **hide()** - Hides the tooltip\n\n### **Slots:**\n - _default_ - The tooltip's target element. Avoid slotting in more than one element, as subsequent ones will be ignored.\n- **content** - The content to render in the tooltip. Alternatively, you can use the `content` attribute.\n\n### **CSS Properties:**\n - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_\n- **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_\n- **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<flow-ui-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.\n- **body** - The tooltip's body where its content is rendered.",
2707
2856
  "attributes": [
2708
2857
  {
2709
- "name": "name",
2710
- "description": "The name of the textarea, submitted as a name/value pair with form data.",
2711
- "values": []
2712
- },
2713
- {
2714
- "name": "value",
2715
- "description": "The current value of the textarea, submitted as a name/value pair with form data.",
2716
- "values": []
2717
- },
2718
- {
2719
- "name": "size",
2720
- "description": "The textarea's size.",
2721
- "values": [
2722
- { "name": "small" },
2723
- { "name": "medium" },
2724
- { "name": "large" }
2725
- ]
2726
- },
2727
- {
2728
- "name": "filled",
2729
- "description": "Draws a filled textarea.",
2730
- "values": []
2731
- },
2732
- {
2733
- "name": "label",
2734
- "description": "The textarea's label. If you need to display HTML, use the `label` slot instead.",
2735
- "values": []
2736
- },
2737
- {
2738
- "name": "help-text",
2739
- "description": "The textarea's help text. If you need to display HTML, use the `help-text` slot instead.",
2740
- "values": []
2741
- },
2742
- {
2743
- "name": "placeholder",
2744
- "description": "Placeholder text to show as a hint when the input is empty.",
2745
- "values": []
2746
- },
2747
- {
2748
- "name": "rows",
2749
- "description": "The number of rows to display by default.",
2858
+ "name": "content",
2859
+ "description": "The tooltip's content. If you need to display HTML, use the `content` slot instead.",
2750
2860
  "values": []
2751
2861
  },
2752
2862
  {
2753
- "name": "resize",
2754
- "description": "Controls how the textarea can be resized.",
2863
+ "name": "placement",
2864
+ "description": "The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip\ninside of the viewport.",
2755
2865
  "values": [
2756
- { "name": "none" },
2757
- { "name": "vertical" },
2758
- { "name": "auto" }
2866
+ { "name": "" },
2867
+ { "name": "top" },
2868
+ { "name": "top-start" },
2869
+ { "name": "top-end" },
2870
+ { "name": "right" },
2871
+ { "name": "right-start" },
2872
+ { "name": "right-end" },
2873
+ { "name": "bottom" },
2874
+ { "name": "bottom-start" },
2875
+ { "name": "bottom-end" },
2876
+ { "name": "left" },
2877
+ { "name": "left-start" },
2878
+ { "name": "left-end" }
2759
2879
  ]
2760
2880
  },
2761
2881
  {
2762
2882
  "name": "disabled",
2763
- "description": "Disables the textarea.",
2764
- "values": []
2765
- },
2766
- {
2767
- "name": "readonly",
2768
- "description": "Makes the textarea readonly.",
2769
- "values": []
2770
- },
2771
- {
2772
- "name": "form",
2773
- "description": "By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you\nto place the form control outside of a form and associate it with the form that has this `id`. The form must be in\nthe same document or shadow root for this to work.",
2774
- "values": []
2775
- },
2776
- {
2777
- "name": "required",
2778
- "description": "Makes the textarea a required field.",
2779
- "values": []
2780
- },
2781
- {
2782
- "name": "minlength",
2783
- "description": "The minimum length of input that will be considered valid.",
2883
+ "description": "Disables the tooltip so it won't show when triggered.",
2784
2884
  "values": []
2785
2885
  },
2786
2886
  {
2787
- "name": "maxlength",
2788
- "description": "The maximum length of input that will be considered valid.",
2887
+ "name": "distance",
2888
+ "description": "The distance in pixels from which to offset the tooltip away from its target.",
2789
2889
  "values": []
2790
2890
  },
2791
2891
  {
2792
- "name": "autocapitalize",
2793
- "description": "Controls whether and how text input is automatically capitalized as it is entered by the user.",
2794
- "values": [
2795
- { "name": "off" },
2796
- { "name": "none" },
2797
- { "name": "on" },
2798
- { "name": "sentences" },
2799
- { "name": "words" },
2800
- { "name": "characters" }
2801
- ]
2802
- },
2803
- {
2804
- "name": "autocorrect",
2805
- "description": "Indicates whether the browser's autocorrect feature is on or off.",
2892
+ "name": "open",
2893
+ "description": "Indicates whether or not the tooltip is open. You can use this in lieu of the show/hide methods.",
2806
2894
  "values": []
2807
2895
  },
2808
2896
  {
2809
- "name": "autocomplete",
2810
- "description": "Specifies what permission the browser has to provide assistance in filling out form field values. Refer to\n[this page on MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) for available values.",
2897
+ "name": "skidding",
2898
+ "description": "The distance in pixels from which to offset the tooltip along its target.",
2811
2899
  "values": []
2812
2900
  },
2813
2901
  {
2814
- "name": "autofocus",
2815
- "description": "Indicates that the input should receive focus on page load.",
2902
+ "name": "trigger",
2903
+ "description": "Controls how the tooltip is activated. Possible options include `click`, `hover`, `focus`, and `manual`. Multiple\noptions can be passed by separating them with a space. When manual is used, the tooltip must be activated\nprogrammatically.",
2816
2904
  "values": []
2817
2905
  },
2818
2906
  {
2819
- "name": "enterkeyhint",
2820
- "description": "Used to customize the label or icon of the Enter key on virtual keyboards.",
2821
- "values": [
2822
- { "name": "enter" },
2823
- { "name": "done" },
2824
- { "name": "go" },
2825
- { "name": "next" },
2826
- { "name": "previous" },
2827
- { "name": "search" },
2828
- { "name": "send" }
2829
- ]
2830
- },
2831
- {
2832
- "name": "spellcheck",
2833
- "description": "Enables spell checking on the textarea.",
2907
+ "name": "hoist",
2908
+ "description": "Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with\n`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,\nscenarios.",
2834
2909
  "values": []
2835
- },
2836
- {
2837
- "name": "inputmode",
2838
- "description": "Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual\nkeyboard on supportive devices.",
2839
- "values": [
2840
- { "name": "none" },
2841
- { "name": "text" },
2842
- { "name": "decimal" },
2843
- { "name": "numeric" },
2844
- { "name": "tel" },
2845
- { "name": "search" },
2846
- { "name": "email" },
2847
- { "name": "url" }
2848
- ]
2849
2910
  }
2850
2911
  ],
2851
2912
  "references": []
@@ -2921,67 +2982,6 @@
2921
2982
  ],
2922
2983
  "references": []
2923
2984
  },
2924
- {
2925
- "name": "flow-ui-tooltip",
2926
- "description": "Tooltips display additional information based on a specific action.\n\n\n---\n\n\n\n\n### **Events:**\n - **flow-ui-show** - Emitted when the tooltip begins to show.\n- **flow-ui-after-show** - Emitted after the tooltip has shown and all animations are complete.\n- **flow-ui-hide** - Emitted when the tooltip begins to hide.\n- **flow-ui-after-hide** - Emitted after the tooltip has hidden and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the tooltip.\n- **hide()** - Hides the tooltip\n\n### **Slots:**\n - _default_ - The tooltip's target element. Avoid slotting in more than one element, as subsequent ones will be ignored.\n- **content** - The content to render in the tooltip. Alternatively, you can use the `content` attribute.\n\n### **CSS Properties:**\n - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_\n- **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_\n- **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<flow-ui-popup>` element.\n- **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.\n- **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.\n- **body** - The tooltip's body where its content is rendered.",
2927
- "attributes": [
2928
- {
2929
- "name": "content",
2930
- "description": "The tooltip's content. If you need to display HTML, use the `content` slot instead.",
2931
- "values": []
2932
- },
2933
- {
2934
- "name": "placement",
2935
- "description": "The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip\ninside of the viewport.",
2936
- "values": [
2937
- { "name": "" },
2938
- { "name": "top" },
2939
- { "name": "top-start" },
2940
- { "name": "top-end" },
2941
- { "name": "right" },
2942
- { "name": "right-start" },
2943
- { "name": "right-end" },
2944
- { "name": "bottom" },
2945
- { "name": "bottom-start" },
2946
- { "name": "bottom-end" },
2947
- { "name": "left" },
2948
- { "name": "left-start" },
2949
- { "name": "left-end" }
2950
- ]
2951
- },
2952
- {
2953
- "name": "disabled",
2954
- "description": "Disables the tooltip so it won't show when triggered.",
2955
- "values": []
2956
- },
2957
- {
2958
- "name": "distance",
2959
- "description": "The distance in pixels from which to offset the tooltip away from its target.",
2960
- "values": []
2961
- },
2962
- {
2963
- "name": "open",
2964
- "description": "Indicates whether or not the tooltip is open. You can use this in lieu of the show/hide methods.",
2965
- "values": []
2966
- },
2967
- {
2968
- "name": "skidding",
2969
- "description": "The distance in pixels from which to offset the tooltip along its target.",
2970
- "values": []
2971
- },
2972
- {
2973
- "name": "trigger",
2974
- "description": "Controls how the tooltip is activated. Possible options include `click`, `hover`, `focus`, and `manual`. Multiple\noptions can be passed by separating them with a space. When manual is used, the tooltip must be activated\nprogrammatically.",
2975
- "values": []
2976
- },
2977
- {
2978
- "name": "hoist",
2979
- "description": "Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with\n`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,\nscenarios.",
2980
- "values": []
2981
- }
2982
- ],
2983
- "references": []
2984
- },
2985
2985
  {
2986
2986
  "name": "flow-ui-visually-hidden",
2987
2987
  "description": "The visually hidden utility makes content accessible to assistive devices without displaying it on the screen.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The content to be visually hidden.",