npm - @skedulo/breeze-ui - Versions diffs - 0.9.4 → 0.9.5 - Mend

@skedulo/breeze-ui 0.9.4 → 0.9.5

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 (9) hide show

package/dist/custom-elements.json +1169 -828
package/dist/lib/cjs/breeze-ui.js +172 -160
package/dist/lib/es/breeze-ui.js +2951 -2920
package/dist/tsconfig.tsbuildinfo +1 -1
package/dist/types/components/form-elements/input-base.d.ts +6 -0
package/dist/types/components/form-elements/input-base.d.ts.map +1 -1
package/dist/types/components/form-elements/labeled-input.d.ts +10 -5
package/dist/types/components/form-elements/labeled-input.d.ts.map +1 -1
package/package.json +1 -1

package/dist/custom-elements.json CHANGED Viewed

@@ -890,97 +890,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/helpers/css-helpers.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "getFocusStyles",
-          "parameters": [
-            {
-              "name": "selector",
-              "type": {
-                "text": "string"
-              },
-              "description": "A CSS selector targeting an interactive element."
-            },
-            {
-              "name": "extraRules",
-              "default": "css``",
-              "description": "Optional rules to append. Useful for overrides."
-            }
-          ],
-          "description": "Returns a CSSResult applying focus outline styles to a given interactive\nelement. Reduces repetition throughout multiple components.\n\nTargets modern `:focus-visible` by default and includes a `:focus` fallback\nfor older browsers."
-        },
-        {
-          "kind": "variable",
-          "name": "invisibleButtonRules",
-          "default": "css`\n  background: none;\n  border: 0;\n  border-radius: var(--brz-border-radius-default);\n  color: var(--brz-color-neutral-750);\n  cursor: pointer;\n  display: inline-flex;\n  font: inherit;\n  margin: 0;\n  padding: 0;\n`",
-          "description": "CSS rules to apply invisible styles to buttons. Use within a CSS declaration\nblock."
-        },
-        {
-          "kind": "function",
-          "name": "getInvisibleButtonStyles",
-          "parameters": [
-            {
-              "name": "selector",
-              "type": {
-                "text": "string"
-              },
-              "description": "A CSS selector targeting a button"
-            },
-            {
-              "name": "extraRules",
-              "default": "css``",
-              "description": "Optional rules to append. Useful for overrides."
-            }
-          ],
-          "description": "Returns a CSSResult applying invisible styles to a button matching the given\nselector. Invisible buttons are a common pattern for icon-only close buttons.\n\nSince this applies to buttons, default focus styles are also automatically\nincluded for the selector. If you don't need them, or need to customise them,\nuse `invisibleButtonStyles` and `getFocusStyles()` separately instead."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "getFocusStyles",
-          "declaration": {
-            "name": "getFocusStyles",
-            "module": "src/helpers/css-helpers.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "invisibleButtonRules",
-          "declaration": {
-            "name": "invisibleButtonRules",
-            "module": "src/helpers/css-helpers.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getInvisibleButtonStyles",
-          "declaration": {
-            "name": "getInvisibleButtonStyles",
-            "module": "src/helpers/css-helpers.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/helpers/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./css-helpers"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/components/alert.ts",
@@ -8914,6 +8823,19 @@
                 "module": "src/components/form-elements/input-checkbox.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -9070,12 +8992,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "required",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -9270,26 +9194,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -9308,6 +9232,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -9515,13 +9452,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -9530,13 +9467,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -9566,12 +9503,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -9579,13 +9518,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -9881,26 +9820,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -9919,6 +9858,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -10516,13 +10468,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -10531,13 +10483,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -10567,12 +10519,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -10580,13 +10534,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -10815,19 +10769,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -10854,6 +10795,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -10867,6 +10821,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -11126,21 +11093,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -11171,6 +11123,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -11194,12 +11161,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -11207,13 +11176,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -11372,26 +11341,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -11410,6 +11379,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -11542,13 +11524,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -11557,13 +11539,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -11602,12 +11584,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -11615,13 +11599,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -12564,19 +12548,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -12603,6 +12574,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -12616,6 +12600,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -12805,8 +12802,8 @@
               "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
               }
             },
             {
@@ -13192,6 +13189,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -13213,19 +13225,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "ShadowRootInit"
-              },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
-              "inheritedFrom": {
-                "name": "InputBase",
-                "module": "src/components/form-elements/input-base.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "disabled",
@@ -13460,26 +13459,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -13498,6 +13497,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -13662,13 +13674,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -13677,13 +13689,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -13713,12 +13725,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -13726,13 +13740,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -13938,26 +13952,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -13976,6 +13990,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -14153,13 +14180,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -14168,13 +14195,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -14191,12 +14218,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -14204,13 +14233,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -14483,19 +14512,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -14522,6 +14538,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -14535,6 +14564,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -14874,8 +14916,8 @@
               "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
               }
             },
             {
@@ -15190,6 +15232,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -15211,19 +15268,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "ShadowRootInit"
-              },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
-              "inheritedFrom": {
-                "name": "InputBase",
-                "module": "src/components/form-elements/input-base.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "disabled",
@@ -15393,19 +15437,6 @@
           "tagName": "sp-labeled-input",
           "customElement": true,
           "attributes": [
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -15432,6 +15463,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -15445,6 +15489,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -15498,21 +15555,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -15543,6 +15585,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -15588,12 +15645,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -15601,13 +15660,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -19304,181 +19363,91 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/storybook/colors.stories.ts",
+      "path": "src/helpers/css-helpers.ts",
       "declarations": [
         {
-          "kind": "class",
-          "description": "Story component to render a colour swatch.\nWill extract the hex code from a supplied color var and use it as the background.",
-          "name": "ColorSwatch",
-          "members": [
-            {
-              "kind": "field",
-              "name": "colorVar",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "colorVar"
-            },
-            {
-              "kind": "field",
-              "name": "lightText",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "light-text"
-            }
-          ],
-          "attributes": [
+          "kind": "function",
+          "name": "getFocusStyles",
+          "parameters": [
             {
-              "name": "colorVar",
+              "name": "selector",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "fieldName": "colorVar"
+              "description": "A CSS selector targeting an interactive element."
             },
             {
-              "name": "light-text",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "lightText"
+              "name": "extraRules",
+              "default": "css``",
+              "description": "Optional rules to append. Useful for overrides."
             }
           ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "brz-sb-color-swatch",
-          "customElement": true
+          "description": "Returns a CSSResult applying focus outline styles to a given interactive\nelement. Reduces repetition throughout multiple components.\n\nTargets modern `:focus-visible` by default and includes a `:focus` fallback\nfor older browsers."
         },
         {
-          "kind": "class",
-          "description": "Story component for laying out a group of swatches",
-          "name": "ColorSwatchGroup",
-          "members": [
+          "kind": "variable",
+          "name": "invisibleButtonRules",
+          "default": "css`\n  background: none;\n  border: 0;\n  border-radius: var(--brz-border-radius-default);\n  color: var(--brz-color-neutral-750);\n  cursor: pointer;\n  display: inline-flex;\n  font: inherit;\n  margin: 0;\n  padding: 0;\n`",
+          "description": "CSS rules to apply invisible styles to buttons. Use within a CSS declaration\nblock."
+        },
+        {
+          "kind": "function",
+          "name": "getInvisibleButtonStyles",
+          "parameters": [
             {
-              "kind": "field",
-              "name": "stacked",
+              "name": "selector",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "stacked"
-            }
-          ],
-          "attributes": [
+              "description": "A CSS selector targeting a button"
+            },
             {
-              "name": "stacked",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "stacked"
+              "name": "extraRules",
+              "default": "css``",
+              "description": "Optional rules to append. Useful for overrides."
             }
           ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "brz-sb-color-swatch-group",
-          "customElement": true
+          "description": "Returns a CSSResult applying invisible styles to a button matching the given\nselector. Invisible buttons are a common pattern for icon-only close buttons.\n\nSince this applies to buttons, default focus styles are also automatically\nincluded for the selector. If you don't need them, or need to customise them,\nuse `invisibleButtonStyles` and `getFocusStyles()` separately instead."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "ColorSwatch",
+          "name": "getFocusStyles",
           "declaration": {
-            "name": "ColorSwatch",
-            "module": "src/storybook/colors.stories.ts"
+            "name": "getFocusStyles",
+            "module": "src/helpers/css-helpers.ts"
           }
         },
         {
-          "kind": "custom-element-definition",
-          "name": "brz-sb-color-swatch",
+          "kind": "js",
+          "name": "invisibleButtonRules",
           "declaration": {
-            "name": "ColorSwatch",
-            "module": "src/storybook/colors.stories.ts"
+            "name": "invisibleButtonRules",
+            "module": "src/helpers/css-helpers.ts"
           }
         },
         {
           "kind": "js",
-          "name": "ColorSwatchGroup",
+          "name": "getInvisibleButtonStyles",
           "declaration": {
-            "name": "ColorSwatchGroup",
-            "module": "src/storybook/colors.stories.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "brz-sb-color-swatch-group",
-          "declaration": {
-            "name": "ColorSwatchGroup",
-            "module": "src/storybook/colors.stories.ts"
+            "name": "getInvisibleButtonStyles",
+            "module": "src/helpers/css-helpers.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/storybook/fade-in-out.stories.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "FadeInOutStory",
-          "members": [
-            {
-              "kind": "field",
-              "name": "shown",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "shown"
-            },
-            {
-              "kind": "method",
-              "name": "handleToggle"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "shown",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "shown"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "brz-sb-fade-in-out",
-          "customElement": true
-        }
-      ],
+      "path": "src/helpers/index.ts",
+      "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "FadeInOutStory",
-          "declaration": {
-            "name": "FadeInOutStory",
-            "module": "src/storybook/fade-in-out.stories.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "brz-sb-fade-in-out",
+          "name": "*",
           "declaration": {
-            "name": "FadeInOutStory",
-            "module": "src/storybook/fade-in-out.stories.ts"
+            "name": "*",
+            "package": "./css-helpers"
           }
         }
       ]
@@ -19620,6 +19589,187 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/storybook/colors.stories.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Story component to render a colour swatch.\nWill extract the hex code from a supplied color var and use it as the background.",
+          "name": "ColorSwatch",
+          "members": [
+            {
+              "kind": "field",
+              "name": "colorVar",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "colorVar"
+            },
+            {
+              "kind": "field",
+              "name": "lightText",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "light-text"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "colorVar",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "colorVar"
+            },
+            {
+              "name": "light-text",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "lightText"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "brz-sb-color-swatch",
+          "customElement": true
+        },
+        {
+          "kind": "class",
+          "description": "Story component for laying out a group of swatches",
+          "name": "ColorSwatchGroup",
+          "members": [
+            {
+              "kind": "field",
+              "name": "stacked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "stacked"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "stacked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "stacked"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "brz-sb-color-swatch-group",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ColorSwatch",
+          "declaration": {
+            "name": "ColorSwatch",
+            "module": "src/storybook/colors.stories.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "brz-sb-color-swatch",
+          "declaration": {
+            "name": "ColorSwatch",
+            "module": "src/storybook/colors.stories.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ColorSwatchGroup",
+          "declaration": {
+            "name": "ColorSwatchGroup",
+            "module": "src/storybook/colors.stories.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "brz-sb-color-swatch-group",
+          "declaration": {
+            "name": "ColorSwatchGroup",
+            "module": "src/storybook/colors.stories.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/storybook/fade-in-out.stories.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "FadeInOutStory",
+          "members": [
+            {
+              "kind": "field",
+              "name": "shown",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "shown"
+            },
+            {
+              "kind": "method",
+              "name": "handleToggle"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "shown",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "shown"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "brz-sb-fade-in-out",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "FadeInOutStory",
+          "declaration": {
+            "name": "FadeInOutStory",
+            "module": "src/storybook/fade-in-out.stories.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "brz-sb-fade-in-out",
+          "declaration": {
+            "name": "FadeInOutStory",
+            "module": "src/storybook/fade-in-out.stories.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/styles/borders.ts",
@@ -20641,22 +20791,24 @@
           "members": [
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }"
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true
             },
             {
@@ -20746,6 +20898,15 @@
               "description": "Disables the input field",
               "fieldName": "disabled"
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required"
+            },
             {
               "name": "invalid",
               "type": {
@@ -20912,12 +21073,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "required",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -21043,6 +21206,19 @@
               "description": "Puts the checkbox into indeterminate state",
               "fieldName": "indeterminate"
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -21286,13 +21462,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -21301,13 +21477,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -21337,12 +21513,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -21350,13 +21528,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -21554,26 +21732,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -21592,6 +21770,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -22336,13 +22527,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -22351,13 +22542,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -22387,12 +22578,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -22400,13 +22593,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -22663,26 +22856,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -22701,6 +22894,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -22968,21 +23174,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -23013,6 +23204,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -23036,12 +23242,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -23049,13 +23257,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -23246,19 +23454,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -23285,6 +23480,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -23298,6 +23506,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -23495,13 +23716,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -23510,13 +23731,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -23555,12 +23776,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -23568,13 +23791,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -23705,26 +23928,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -23743,6 +23966,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -24260,21 +24496,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -24305,6 +24526,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -24328,12 +24564,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -24341,13 +24579,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -24566,19 +24804,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -24605,6 +24830,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -24618,6 +24856,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -24863,8 +25114,8 @@
               "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
               }
             },
             {
@@ -25250,6 +25501,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -25271,19 +25537,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "ShadowRootInit"
-              },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
-              "inheritedFrom": {
-                "name": "InputBase",
-                "module": "src/components/form-elements/input-base.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "disabled",
@@ -25502,19 +25755,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -25541,6 +25781,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -25554,6 +25807,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -25720,21 +25986,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -25765,6 +26016,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -25801,12 +26067,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -25814,13 +26082,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -25954,25 +26222,12 @@
               "fieldName": "leadingIcon"
             },
             {
-              "name": "trailing-icon",
-              "type": {
-                "text": "IconKey | undefined"
-              },
-              "description": "Puts the supplied icon inside of the input at the trailing edge",
-              "fieldName": "trailingIcon"
-            },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
+              "name": "trailing-icon",
+              "type": {
+                "text": "IconKey | undefined"
+              },
+              "description": "Puts the supplied icon inside of the input at the trailing edge",
+              "fieldName": "trailingIcon"
             },
             {
               "name": "label-position",
@@ -26000,6 +26255,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -26013,6 +26281,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -26237,13 +26518,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -26252,13 +26533,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -26288,12 +26569,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -26301,13 +26584,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -26485,26 +26768,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -26523,6 +26806,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -26765,13 +27061,13 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "labelPosition",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "attribute": "label-position",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -26780,13 +27076,13 @@
             },
             {
               "kind": "field",
-              "name": "labelPosition",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "attribute": "label-position",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
               "reflects": true,
               "inheritedFrom": {
                 "name": "LabeledInput",
@@ -26803,12 +27099,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -26816,13 +27114,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -27000,26 +27298,26 @@
               }
             },
             {
-              "name": "required",
+              "name": "label-position",
               "type": {
-                "text": "boolean"
+                "text": "LabelPosition"
               },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
+              "default": "'top'",
+              "description": "The position of the supplied label",
+              "fieldName": "labelPosition",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
             {
-              "name": "label-position",
+              "name": "optional",
               "type": {
-                "text": "LabelPosition"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "The position of the supplied label",
-              "fieldName": "labelPosition",
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
               "inheritedFrom": {
                 "name": "LabeledInput",
                 "module": "src/components/form-elements/labeled-input.ts"
@@ -27038,6 +27336,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -27453,8 +27764,8 @@
               "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
               }
             },
             {
@@ -27769,6 +28080,21 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "handleErrorChange",
@@ -27790,19 +28116,6 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "ShadowRootInit"
-              },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
-              "inheritedFrom": {
-                "name": "InputBase",
-                "module": "src/components/form-elements/input-base.ts"
-              }
-            },
             {
               "kind": "field",
               "name": "disabled",
@@ -28048,19 +28361,6 @@
                 "module": "src/components/form-elements/input-text-base.ts"
               }
             },
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "LabeledInput",
-                "module": "src/components/form-elements/labeled-input.ts"
-              }
-            },
             {
               "name": "label-position",
               "type": {
@@ -28087,6 +28387,19 @@
                 "module": "src/components/form-elements/labeled-input.ts"
               }
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional",
+              "inheritedFrom": {
+                "name": "LabeledInput",
+                "module": "src/components/form-elements/labeled-input.ts"
+              }
+            },
             {
               "name": "disabled",
               "type": {
@@ -28100,6 +28413,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {
@@ -28278,17 +28604,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "attribute": "required",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "labelPosition",
@@ -28311,6 +28626,17 @@
               "attribute": "size",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "attribute": "optional",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "handleErrorChange"
@@ -28340,12 +28666,14 @@
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{\n    mode: 'open',\n    delegatesFocus: true,\n  }",
+              "default": "false",
+              "description": "Disables the input field",
+              "attribute": "disabled",
+              "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
                 "module": "src/components/form-elements/input-base.ts"
@@ -28353,13 +28681,13 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Disables the input field",
-              "attribute": "disabled",
+              "description": "Indicates that the input requires a value",
+              "attribute": "required",
               "reflects": true,
               "inheritedFrom": {
                 "name": "InputBase",
@@ -28467,15 +28795,6 @@
             }
           ],
           "attributes": [
-            {
-              "name": "required",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Makes the field go into a required state",
-              "fieldName": "required"
-            },
             {
               "name": "label-position",
               "type": {
@@ -28494,6 +28813,15 @@
               "description": "The size of the input",
               "fieldName": "size"
             },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input value is optional. Appends \"(optional)\" text to\nthe label.\n\nIf the input is already `required`, this does nothing.",
+              "fieldName": "optional"
+            },
             {
               "name": "disabled",
               "type": {
@@ -28507,6 +28835,19 @@
                 "module": "src/components/form-elements/input-base.ts"
               }
             },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates that the input requires a value",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "InputBase",
+                "module": "src/components/form-elements/input-base.ts"
+              }
+            },
             {
               "name": "invalid",
               "type": {