@helixui/library 1.1.1 → 1.1.2

package/custom-elements.json

@@ -2,6 +2,230 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/components/hx-action-bar/hx-action-bar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A horizontal toolbar container for grouping related action buttons and controls.\nImplements the ARIA toolbar pattern with roving tabindex keyboard navigation.",
+          "name": "HelixActionBar",
+          "cssProperties": [
+            {
+              "description": "Bar background color (default variant).",
+              "name": "--hx-action-bar-bg",
+              "default": "transparent"
+            },
+            {
+              "description": "Bar border (default variant).",
+              "name": "--hx-action-bar-border",
+              "default": "none"
+            },
+            {
+              "description": "Inner padding.",
+              "name": "--hx-action-bar-padding",
+              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
+            },
+            {
+              "description": "Gap between slotted items.",
+              "name": "--hx-action-bar-gap",
+              "default": "var(--hx-space-2,0.5rem)"
+            },
+            {
+              "description": "Z-index when sticky or bottom position.",
+              "name": "--hx-action-bar-z-index",
+              "default": "10"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The root toolbar container element.",
+              "name": "base"
+            },
+            {
+              "description": "The start (left) slot wrapper.",
+              "name": "start"
+            },
+            {
+              "description": "The center (default) slot wrapper.",
+              "name": "center"
+            },
+            {
+              "description": "The end (right) slot wrapper.",
+              "name": "end"
+            },
+            {
+              "description": "The overflow slot wrapper (hidden when no overflow content).",
+              "name": "overflow"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Left-aligned actions.",
+              "name": "start"
+            },
+            {
+              "description": "Center content (default slot).",
+              "name": ""
+            },
+            {
+              "description": "Right-aligned actions.",
+              "name": "end"
+            },
+            {
+              "description": "Actions revealed when the bar is constrained for space.",
+              "name": "overflow"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "ActionBarSize"
+              },
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "attribute": "hx-size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'outlined' | 'filled'"
+              },
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "'top' | 'bottom' | 'sticky'"
+              },
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "attribute": "position",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sticky",
+              "type": {
+                "text": "boolean"
+              },
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "attribute": "sticky",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "attribute": "aria-label"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "hx-size",
+              "type": {
+                "text": "ActionBarSize"
+              },
+              "default": "'md'",
+              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
+              "fieldName": "size",
+              "attribute": "hx-size"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'outlined' | 'filled'"
+              },
+              "default": "'default'",
+              "description": "Visual variant controlling the bar background.",
+              "fieldName": "variant",
+              "attribute": "variant"
+            },
+            {
+              "name": "position",
+              "type": {
+                "text": "'top' | 'bottom' | 'sticky'"
+              },
+              "default": "'top'",
+              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
+              "fieldName": "position",
+              "attribute": "position"
+            },
+            {
+              "name": "sticky",
+              "type": {
+                "text": "boolean"
+              },
+              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
+              "fieldName": "sticky",
+              "attribute": "sticky"
+            },
+            {
+              "name": "aria-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Actions'",
+              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
+              "fieldName": "ariaLabel",
+              "attribute": "aria-label"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "hx-action-bar",
+          "customElement": true,
+          "summary": "Horizontal action bar for grouping related controls."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixActionBar",
+          "declaration": {
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "hx-action-bar",
+          "declaration": {
+            "name": "HelixActionBar",
+            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/hx-action-bar/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "HelixActionBar",
+          "declaration": {
+            "name": "HelixActionBar",
+            "module": "./hx-action-bar.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/hx-accordion/hx-accordion-item.ts",
@@ -476,6 +700,15 @@
               "attribute": "accent",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "severityLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
+              "attribute": "severity-label"
+            },
             {
               "kind": "field",
               "name": "returnFocusTo",
@@ -487,23 +720,25 @@
               "attribute": "return-focus-to"
             },
             {
-              "kind": "field",
-              "name": "severityLabels",
-              "type": {
-                "text": "Partial<Record<string, string>>"
+              "kind": "method",
+              "name": "_defaultSeverityLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
               },
-              "default": "{ info: 'Info:', success: 'Success:', warning: 'Warning:', error: 'Error:', }",
-              "description": "Map of severity variant labels prepended to screen-reader announcements.\nOverride to provide localized severity prefixes."
+              "description": "Returns the default English severity label for the current variant."
             },
             {
               "kind": "field",
-              "name": "closeLabel",
+              "name": "_effectiveSeverityLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Close alert'",
-              "description": "Accessible label for the dismiss button. Override for localized text.",
-              "attribute": "close-label"
+              "privacy": "private",
+              "description": "Returns the effective severity label, using the override if provided.",
+              "readonly": true
             }
           ],
           "events": [
@@ -520,368 +755,144 @@
                 "text": "CustomEvent"
               },
               "description": "Dispatched after the alert is dismissed."
-            }
-          ],
-          "attributes": [
-            {
-              "name": "variant",
-              "type": {
-                "text": "AlertVariant"
-              },
-              "default": "'info'",
-              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
-              "fieldName": "variant",
-              "attribute": "variant"
-            },
-            {
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the alert can be dismissed by the user.",
-              "fieldName": "dismissible",
-              "attribute": "dismissible"
-            },
-            {
-              "name": "heading",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Optional heading text that provides context for the close button's accessible label.\nWhen provided, the close button is announced as \"Close [heading] alert\".\nWhen absent, the close button falls back to \"Close alert\".",
-              "fieldName": "heading",
-              "attribute": "heading"
-            },
-            {
-              "name": "open",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether the alert is visible. Add the `open` attribute to show the alert.",
-              "fieldName": "open",
-              "attribute": "open"
-            },
-            {
-              "name": "show-icon",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Whether to show the default variant icon. Add `show-icon` attribute to display the icon.",
-              "fieldName": "showIcon",
-              "attribute": "show-icon"
-            },
-            {
-              "name": "accent",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
-              "fieldName": "accent",
-              "attribute": "accent"
-            },
-            {
-              "name": "return-focus-to",
-              "type": {
-                "text": "string | null"
-              },
-              "default": "null",
-              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
-              "fieldName": "returnFocusTo",
-              "attribute": "return-focus-to"
-            },
-            {
-              "name": "close-label",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Close alert'",
-              "description": "Accessible label for the dismiss button. Override for localized text.",
-              "fieldName": "closeLabel"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "hx-alert",
-          "customElement": true,
-          "summary": "Feedback alert for status messages with variant-based styling and ARIA live regions."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "HelixAlert",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "hx-alert",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "HxAlert",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "src/components/hx-alert/hx-alert.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/hx-alert/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "HelixAlert",
-          "declaration": {
-            "name": "HelixAlert",
-            "module": "./hx-alert.js"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "AlertVariant",
-          "declaration": {
-            "name": "AlertVariant",
-            "module": "./hx-alert.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/hx-action-bar.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "A horizontal toolbar container for grouping related action buttons and controls.\nImplements the ARIA toolbar pattern with roving tabindex keyboard navigation.",
-          "name": "HelixActionBar",
-          "cssProperties": [
-            {
-              "description": "Bar background color (default variant).",
-              "name": "--hx-action-bar-bg",
-              "default": "transparent"
-            },
-            {
-              "description": "Bar border (default variant).",
-              "name": "--hx-action-bar-border",
-              "default": "none"
-            },
-            {
-              "description": "Inner padding.",
-              "name": "--hx-action-bar-padding",
-              "default": "var(--hx-space-2,0.5rem) var(--hx-space-3,0.75rem)"
-            },
-            {
-              "description": "Gap between slotted items.",
-              "name": "--hx-action-bar-gap",
-              "default": "var(--hx-space-2,0.5rem)"
-            },
-            {
-              "description": "Z-index when sticky or bottom position.",
-              "name": "--hx-action-bar-z-index",
-              "default": "10"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The root toolbar container element.",
-              "name": "base"
-            },
-            {
-              "description": "The start (left) slot wrapper.",
-              "name": "start"
-            },
-            {
-              "description": "The center (default) slot wrapper.",
-              "name": "center"
-            },
-            {
-              "description": "The end (right) slot wrapper.",
-              "name": "end"
-            },
-            {
-              "description": "The overflow slot wrapper (hidden when no overflow content).",
-              "name": "overflow"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Left-aligned actions.",
-              "name": "start"
-            },
-            {
-              "description": "Center content (default slot).",
-              "name": ""
-            },
-            {
-              "description": "Right-aligned actions.",
-              "name": "end"
-            },
-            {
-              "description": "Actions revealed when the bar is constrained for space.",
-              "name": "overflow"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "ActionBarSize"
-              },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "attribute": "hx-size",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'default' | 'outlined' | 'filled'"
-              },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "attribute": "variant",
-              "reflects": true
-            },
+            }
+          ],
+          "attributes": [
             {
-              "kind": "field",
-              "name": "position",
+              "name": "variant",
               "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
+                "text": "AlertVariant"
               },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "attribute": "position",
-              "reflects": true
+              "default": "'info'",
+              "description": "Visual variant of the alert that determines colors and ARIA semantics.",
+              "fieldName": "variant",
+              "attribute": "variant"
             },
             {
-              "kind": "field",
-              "name": "sticky",
+              "name": "dismissible",
               "type": {
                 "text": "boolean"
               },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "attribute": "sticky",
-              "reflects": true
+              "default": "false",
+              "description": "Whether the alert can be dismissed by the user.",
+              "fieldName": "dismissible",
+              "attribute": "dismissible"
             },
             {
-              "kind": "field",
-              "name": "ariaLabel",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "attribute": "aria-label"
-            }
-          ],
-          "attributes": [
+              "default": "''",
+              "description": "Optional heading text that provides context for the close button's accessible label.\nWhen provided, the close button is announced as \"Close [heading] alert\".\nWhen absent, the close button falls back to \"Close alert\".",
+              "fieldName": "heading",
+              "attribute": "heading"
+            },
             {
-              "name": "hx-size",
+              "name": "open",
               "type": {
-                "text": "ActionBarSize"
+                "text": "boolean"
               },
-              "default": "'md'",
-              "description": "Size of the action bar — propagated as a data attribute to slotted children.",
-              "fieldName": "size",
-              "attribute": "hx-size"
+              "default": "false",
+              "description": "Whether the alert is visible. Add the `open` attribute to show the alert.",
+              "fieldName": "open",
+              "attribute": "open"
             },
             {
-              "name": "variant",
+              "name": "show-icon",
               "type": {
-                "text": "'default' | 'outlined' | 'filled'"
+                "text": "boolean"
               },
-              "default": "'default'",
-              "description": "Visual variant controlling the bar background.",
-              "fieldName": "variant",
-              "attribute": "variant"
+              "default": "false",
+              "description": "Whether to show the default variant icon. Add `show-icon` attribute to display the icon.",
+              "fieldName": "showIcon",
+              "attribute": "show-icon"
             },
             {
-              "name": "position",
+              "name": "accent",
               "type": {
-                "text": "'top' | 'bottom' | 'sticky'"
+                "text": "boolean"
               },
-              "default": "'top'",
-              "description": "Position and sticky behavior of the action bar.\n- `top` — normal flow (default)\n- `sticky` — sticks to the top of the scroll container; add `scroll-padding-top` to the\n  scroll container equal to the bar height to prevent anchor targets from scrolling behind it\n- `bottom` — sticks to the bottom of the scroll container with iOS safe-area-inset support",
-              "fieldName": "position",
-              "attribute": "position"
+              "default": "false",
+              "description": "When true, applies a left border accent stripe instead of a full border.\nCommon healthcare/enterprise dashboard pattern for visual distinction of alert types.",
+              "fieldName": "accent",
+              "attribute": "accent"
             },
             {
-              "name": "sticky",
+              "name": "severity-label",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "deprecated": "Use `position=\"sticky\"` instead.\nWhen true, the bar sticks to the top of its scroll container.",
-              "fieldName": "sticky",
-              "attribute": "sticky"
+              "description": "Override for the severity prefix announced to screen readers (e.g., \"Info:\", \"Error:\").\nWhen not set, defaults to the English label matching the current variant.",
+              "fieldName": "severityLabel",
+              "attribute": "severity-label"
             },
             {
-              "name": "aria-label",
+              "name": "return-focus-to",
               "type": {
-                "text": "string"
+                "text": "string | null"
               },
-              "default": "'Actions'",
-              "description": "Accessible label for the toolbar.\nRequired when multiple toolbars appear on the same page.",
-              "fieldName": "ariaLabel",
-              "attribute": "aria-label"
+              "default": "null",
+              "description": "CSS selector for the element to return focus to after the alert is dismissed.\nWhen set, the component will find and focus the matching element after dismissal.\nIf not set, focus management is the caller's responsibility via the hx-after-close event.",
+              "fieldName": "returnFocusTo",
+              "attribute": "return-focus-to"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "hx-action-bar",
+          "tagName": "hx-alert",
           "customElement": true,
-          "summary": "Horizontal action bar for grouping related controls."
+          "summary": "Feedback alert for status messages with variant-based styling and ARIA live regions."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixActionBar",
+          "name": "HelixAlert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "hx-action-bar",
+          "name": "hx-alert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "src/components/hx-action-bar/hx-action-bar.ts"
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "HxAlert",
+          "declaration": {
+            "name": "HelixAlert",
+            "module": "src/components/hx-alert/hx-alert.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/hx-action-bar/index.ts",
+      "path": "src/components/hx-alert/index.ts",
       "declarations": [],
       "exports": [
         {
           "kind": "js",
-          "name": "HelixActionBar",
+          "name": "HelixAlert",
           "declaration": {
-            "name": "HelixActionBar",
-            "module": "./hx-action-bar.js"
+            "name": "HelixAlert",
+            "module": "./hx-alert.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "AlertVariant",
+          "declaration": {
+            "name": "AlertVariant",
+            "module": "./hx-alert.js"
           }
         }
       ]
@@ -6772,56 +6783,24 @@
             },
             {
               "kind": "field",
-              "name": "stickyHeader",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When true, the header row is sticky (position: sticky; top: 0).",
-              "attribute": "sticky-header",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "labelSelectAll",
+              "name": "selectAllLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Select all rows'",
-              "description": "Accessible label for the \"select all rows\" checkbox.",
-              "attribute": "label-select-all"
-            },
-            {
-              "kind": "field",
-              "name": "labelSortBy",
-              "type": {
-                "text": "(col: string, dir: 'asc' | 'desc' | null) => string"
-              },
-              "description": "Generates the accessible label for column sort buttons.",
-              "parameters": [
-                {
-                  "description": "column label",
-                  "name": "col"
-                },
-                {
-                  "description": "current sort direction",
-                  "name": "dir"
-                }
-              ]
+              "description": "Accessible label for the \"select all rows\" checkbox in the table header.",
+              "attribute": "select-all-label"
             },
             {
               "kind": "field",
-              "name": "labelSelectRow",
+              "name": "stickyHeader",
               "type": {
-                "text": "(index: number) => string"
+                "text": "boolean"
               },
-              "description": "Generates the accessible label for row selection checkboxes.",
-              "parameters": [
-                {
-                  "description": "1-based row index",
-                  "name": "index"
-                }
-              ]
+              "default": "false",
+              "description": "When true, the header row is sticky (position: sticky; top: 0).",
+              "attribute": "sticky-header",
+              "reflects": true
             },
             {
               "kind": "field",
@@ -6948,6 +6927,16 @@
               "fieldName": "label",
               "attribute": "label"
             },
+            {
+              "name": "select-all-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "'Select all rows'",
+              "description": "Accessible label for the \"select all rows\" checkbox in the table header.",
+              "fieldName": "selectAllLabel",
+              "attribute": "select-all-label"
+            },
             {
               "name": "sticky-header",
               "type": {
@@ -6977,15 +6966,6 @@
               "description": "Number of rows per page. Set to 0 to disable pagination (show all rows).",
               "fieldName": "pageSize",
               "attribute": "page-size"
-            },
-            {
-              "name": "label-select-all",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Select all rows'",
-              "description": "Accessible label for the \"select all rows\" checkbox.",
-              "fieldName": "labelSelectAll"
             }
           ],
           "superclass": {
@@ -7308,53 +7288,63 @@
             },
             {
               "kind": "field",
-              "name": "labelChooseDate",
+              "name": "requiredMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "'This field is required.'",
+              "description": "Validation message shown when the field is required but empty.",
+              "attribute": "required-message"
+            },
+            {
+              "kind": "field",
+              "name": "chooseDateLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Choose a date'",
-              "description": "Accessible label for the calendar grid/dialog.",
-              "attribute": "label-choose-date"
+              "description": "Accessible label for the calendar dialog.",
+              "attribute": "choose-date-label"
             },
             {
               "kind": "field",
-              "name": "labelPrevMonth",
+              "name": "openCalendarLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Previous month'",
-              "description": "Accessible label for the \"previous month\" button.",
-              "attribute": "label-prev-month"
+              "default": "'Open calendar'",
+              "description": "Accessible label for the calendar trigger button when the calendar is closed.",
+              "attribute": "open-calendar-label"
             },
             {
               "kind": "field",
-              "name": "labelNextMonth",
+              "name": "closeCalendarLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Next month'",
-              "description": "Accessible label for the \"next month\" button.",
-              "attribute": "label-next-month"
+              "default": "'Close calendar'",
+              "description": "Accessible label for the calendar trigger button when the calendar is open.",
+              "attribute": "close-calendar-label"
             },
             {
               "kind": "field",
-              "name": "labelOpenCalendar",
+              "name": "previousMonthLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Open calendar'",
-              "description": "Accessible label for the calendar trigger button when calendar is closed.",
-              "attribute": "label-open-calendar"
+              "default": "'Previous month'",
+              "description": "Accessible label for the previous month navigation button.",
+              "attribute": "previous-month-label"
             },
             {
               "kind": "field",
-              "name": "labelCloseCalendar",
+              "name": "nextMonthLabel",
               "type": {
                 "text": "string"
               },
-              "default": "'Close calendar'",
-              "description": "Accessible label for the calendar trigger button when calendar is open.",
-              "attribute": "label-close-calendar"
+              "default": "'Next month'",
+              "description": "Accessible label for the next month navigation button.",
+              "attribute": "next-month-label"
             },
             {
               "kind": "field",
@@ -7591,49 +7581,64 @@
               "attribute": "locale"
             },
             {
-              "name": "label-choose-date",
+              "name": "required-message",
+              "type": {
+                "text": "string"
+              },
+              "default": "'This field is required.'",
+              "description": "Validation message shown when the field is required but empty.",
+              "fieldName": "requiredMessage",
+              "attribute": "required-message"
+            },
+            {
+              "name": "choose-date-label",
               "type": {
                 "text": "string"
               },
               "default": "'Choose a date'",
-              "description": "Accessible label for the calendar grid/dialog.",
-              "fieldName": "labelChooseDate"
+              "description": "Accessible label for the calendar dialog.",
+              "fieldName": "chooseDateLabel",
+              "attribute": "choose-date-label"
             },
             {
-              "name": "label-prev-month",
+              "name": "open-calendar-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Previous month'",
-              "description": "Accessible label for the \"previous month\" button.",
-              "fieldName": "labelPrevMonth"
+              "default": "'Open calendar'",
+              "description": "Accessible label for the calendar trigger button when the calendar is closed.",
+              "fieldName": "openCalendarLabel",
+              "attribute": "open-calendar-label"
             },
             {
-              "name": "label-next-month",
+              "name": "close-calendar-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Next month'",
-              "description": "Accessible label for the \"next month\" button.",
-              "fieldName": "labelNextMonth"
+              "default": "'Close calendar'",
+              "description": "Accessible label for the calendar trigger button when the calendar is open.",
+              "fieldName": "closeCalendarLabel",
+              "attribute": "close-calendar-label"
             },
             {
-              "name": "label-open-calendar",
+              "name": "previous-month-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Open calendar'",
-              "description": "Accessible label for the calendar trigger button when calendar is closed.",
-              "fieldName": "labelOpenCalendar"
+              "default": "'Previous month'",
+              "description": "Accessible label for the previous month navigation button.",
+              "fieldName": "previousMonthLabel",
+              "attribute": "previous-month-label"
             },
             {
-              "name": "label-close-calendar",
+              "name": "next-month-label",
               "type": {
                 "text": "string"
               },
-              "default": "'Close calendar'",
-              "description": "Accessible label for the calendar trigger button when calendar is open.",
-              "fieldName": "labelCloseCalendar"
+              "default": "'Next month'",
+              "description": "Accessible label for the next month navigation button.",
+              "fieldName": "nextMonthLabel",
+              "attribute": "next-month-label"
             }
           ],
           "superclass": {
@@ -13671,23 +13676,33 @@
             },
             {
               "kind": "field",
-              "name": "labelIncrement",
+              "name": "requiredMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "'This field is required.'",
+              "description": "Validation message shown when the field is required but empty.",
+              "attribute": "required-message"
+            },
+            {
+              "kind": "field",
+              "name": "incrementLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Increment'",
-              "description": "Accessible label for the increment button.",
-              "attribute": "label-increment"
+              "description": "Accessible label for the increment (+) stepper button.",
+              "attribute": "increment-label"
             },
             {
               "kind": "field",
-              "name": "labelDecrement",
+              "name": "decrementLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Decrement'",
-              "description": "Accessible label for the decrement button.",
-              "attribute": "label-decrement"
+              "description": "Accessible label for the decrement (-) stepper button.",
+              "attribute": "decrement-label"
             },
             {
               "kind": "field",
@@ -13966,22 +13981,34 @@
               "attribute": "no-stepper"
             },
             {
-              "name": "label-increment",
+              "name": "required-message",
+              "type": {
+                "text": "string"
+              },
+              "default": "'This field is required.'",
+              "description": "Validation message shown when the field is required but empty.",
+              "fieldName": "requiredMessage",
+              "attribute": "required-message"
+            },
+            {
+              "name": "increment-label",
               "type": {
                 "text": "string"
               },
               "default": "'Increment'",
-              "description": "Accessible label for the increment button.",
-              "fieldName": "labelIncrement"
+              "description": "Accessible label for the increment (+) stepper button.",
+              "fieldName": "incrementLabel",
+              "attribute": "increment-label"
             },
             {
-              "name": "label-decrement",
+              "name": "decrement-label",
               "type": {
                 "text": "string"
               },
               "default": "'Decrement'",
-              "description": "Accessible label for the decrement button.",
-              "fieldName": "labelDecrement"
+              "description": "Accessible label for the decrement (-) stepper button.",
+              "fieldName": "decrementLabel",
+              "attribute": "decrement-label"
             }
           ],
           "superclass": {
@@ -14491,61 +14518,43 @@
             },
             {
               "kind": "field",
-              "name": "labelFirstPage",
+              "name": "firstPageLabel",
               "type": {
                 "text": "string"
               },
               "default": "'First page'",
-              "description": "Accessible label for the first-page button.",
-              "attribute": "label-first-page"
+              "description": "Accessible label for the \"First page\" navigation button.",
+              "attribute": "first-page-label"
             },
             {
               "kind": "field",
-              "name": "labelPrevPage",
+              "name": "previousPageLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Previous page'",
-              "description": "Accessible label for the previous-page button.",
-              "attribute": "label-prev-page"
+              "description": "Accessible label for the \"Previous page\" navigation button.",
+              "attribute": "previous-page-label"
             },
             {
               "kind": "field",
-              "name": "labelNextPage",
+              "name": "nextPageLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Next page'",
-              "description": "Accessible label for the next-page button.",
-              "attribute": "label-next-page"
+              "description": "Accessible label for the \"Next page\" navigation button.",
+              "attribute": "next-page-label"
             },
             {
               "kind": "field",
-              "name": "labelLastPage",
+              "name": "lastPageLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Last page'",
-              "description": "Accessible label for the last-page button.",
-              "attribute": "label-last-page"
-            },
-            {
-              "kind": "field",
-              "name": "labelPageOf",
-              "type": {
-                "text": "(current: number, total: number) => string"
-              },
-              "description": "Generates the live-region text announcing the current page.",
-              "parameters": [
-                {
-                  "description": "current page number",
-                  "name": "current"
-                },
-                {
-                  "description": "total page count",
-                  "name": "total"
-                }
-              ]
+              "description": "Accessible label for the \"Last page\" navigation button.",
+              "attribute": "last-page-label"
             }
           ],
           "events": [
@@ -14656,40 +14665,44 @@
               "attribute": "label-rows-per-page"
             },
             {
-              "name": "label-first-page",
+              "name": "first-page-label",
               "type": {
                 "text": "string"
               },
               "default": "'First page'",
-              "description": "Accessible label for the first-page button.",
-              "fieldName": "labelFirstPage"
+              "description": "Accessible label for the \"First page\" navigation button.",
+              "fieldName": "firstPageLabel",
+              "attribute": "first-page-label"
             },
             {
-              "name": "label-prev-page",
+              "name": "previous-page-label",
               "type": {
                 "text": "string"
               },
               "default": "'Previous page'",
-              "description": "Accessible label for the previous-page button.",
-              "fieldName": "labelPrevPage"
+              "description": "Accessible label for the \"Previous page\" navigation button.",
+              "fieldName": "previousPageLabel",
+              "attribute": "previous-page-label"
             },
             {
-              "name": "label-next-page",
+              "name": "next-page-label",
               "type": {
                 "text": "string"
               },
               "default": "'Next page'",
-              "description": "Accessible label for the next-page button.",
-              "fieldName": "labelNextPage"
+              "description": "Accessible label for the \"Next page\" navigation button.",
+              "fieldName": "nextPageLabel",
+              "attribute": "next-page-label"
             },
             {
-              "name": "label-last-page",
+              "name": "last-page-label",
               "type": {
                 "text": "string"
               },
               "default": "'Last page'",
-              "description": "Accessible label for the last-page button.",
-              "fieldName": "labelLastPage"
+              "description": "Accessible label for the \"Last page\" navigation button.",
+              "fieldName": "lastPageLabel",
+              "attribute": "last-page-label"
             }
           ],
           "superclass": {
@@ -19431,47 +19444,33 @@
             },
             {
               "kind": "field",
-              "name": "labelResize",
+              "name": "resizeLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Resize panels'",
-              "description": "Accessible label for the resize divider handle.",
-              "attribute": "label-resize"
+              "description": "Accessible label for the divider separator element.",
+              "attribute": "resize-label"
             },
             {
               "kind": "field",
-              "name": "labelCollapseStart",
+              "name": "collapseStartLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Collapse start panel'",
-              "description": "Accessible label for the collapse-start panel button.",
-              "attribute": "label-collapse-start"
+              "description": "Accessible label for the button that collapses the start panel.",
+              "attribute": "collapse-start-label"
             },
             {
               "kind": "field",
-              "name": "labelCollapseEnd",
+              "name": "collapseEndLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Collapse end panel'",
-              "description": "Accessible label for the collapse-end panel button.",
-              "attribute": "label-collapse-end"
-            },
-            {
-              "kind": "field",
-              "name": "labelExpand",
-              "type": {
-                "text": "(side: 'start' | 'end') => string"
-              },
-              "description": "Generates the accessible label for the expand button when a panel is collapsed.",
-              "parameters": [
-                {
-                  "description": "which panel was collapsed",
-                  "name": "side"
-                }
-              ]
+              "description": "Accessible label for the button that collapses the end panel.",
+              "attribute": "collapse-end-label"
             }
           ],
           "events": [
@@ -19574,31 +19573,34 @@
               "attribute": "collapsed"
             },
             {
-              "name": "label-resize",
+              "name": "resize-label",
               "type": {
                 "text": "string"
               },
               "default": "'Resize panels'",
-              "description": "Accessible label for the resize divider handle.",
-              "fieldName": "labelResize"
+              "description": "Accessible label for the divider separator element.",
+              "fieldName": "resizeLabel",
+              "attribute": "resize-label"
             },
             {
-              "name": "label-collapse-start",
+              "name": "collapse-start-label",
               "type": {
                 "text": "string"
               },
               "default": "'Collapse start panel'",
-              "description": "Accessible label for the collapse-start panel button.",
-              "fieldName": "labelCollapseStart"
+              "description": "Accessible label for the button that collapses the start panel.",
+              "fieldName": "collapseStartLabel",
+              "attribute": "collapse-start-label"
             },
             {
-              "name": "label-collapse-end",
+              "name": "collapse-end-label",
               "type": {
                 "text": "string"
               },
               "default": "'Collapse end panel'",
-              "description": "Accessible label for the collapse-end panel button.",
-              "fieldName": "labelCollapseEnd"
+              "description": "Accessible label for the button that collapses the end panel.",
+              "fieldName": "collapseEndLabel",
+              "attribute": "collapse-end-label"
             }
           ],
           "superclass": {