@nysds/components 1.16.1 → 1.18.0

package/dist/.vscode/vscode.html-custom-data.json

@@ -175,7 +175,7 @@
     },
     {
       "name": "nys-backtotop",
-      "description": "Floating back-to-top button with auto-show behavior and smooth scroll.\n---\n",
+      "description": "Floating back-to-top button with auto-show behavior, smooth scroll, and focus management.\n---\n",
       "attributes": [
         {
           "name": "position",
@@ -226,6 +226,11 @@
           "description": "Primary label text displayed in the badge.",
           "values": []
         },
+        {
+          "name": "srText",
+          "description": "Screen reader text appended after the label for additional context.",
+          "values": []
+        },
         {
           "name": "variant",
           "values": [{ "name": "strong" }, { "name": "\"\"" }]
@@ -235,6 +240,48 @@
       ],
       "references": []
     },
+    {
+      "name": "nys-breadcrumbs",
+      "description": "Breadcrumb navigation trail with responsive collapse support.\n---\n\n\n### **Events:**\n - **nys-expand**\n- **nys-breadcrumbs-expand** - Fired when the user clicks the ellipsis to expand the trail.\n\n### **Slots:**\n - _default_ - One or more `nys-breadcrumbitem` elements defining the trail.",
+      "attributes": [
+        {
+          "name": "id",
+          "description": "Unique identifier. Auto-generated if not provided.",
+          "values": []
+        },
+        {
+          "name": "ariaLabel",
+          "description": "Accessible label for the `<nav>` landmark. Defaults to \"path to this page\" if not set.\nOverride when multiple crumbs exist on the same page.",
+          "values": []
+        },
+        {
+          "name": "size",
+          "description": "Controls the visual size of the breadcrumb text and spacing: `sm` for dense layouts, `md` (default) for standard use.",
+          "values": [{ "name": "sm" }, { "name": "md" }, { "name": "\"\"" }]
+        },
+        {
+          "name": "backToParent",
+          "description": "On mobile, renders the trail as a single back-to-parent link pointing to the item before the current page.\nHas no effect on desktop or when only one item is present (which always renders as a back link).",
+          "values": []
+        },
+        {
+          "name": "collapsed",
+          "description": "Forces the trail into its collapsed state.\nIt shows only the first item, an ellipsis, and the last two items.\nThe user can still expand the trail by clicking the ellipsis.",
+          "values": []
+        },
+        {
+          "name": "backgroundBar",
+          "description": "Renders a filled light theme background bar behind the breadcrumb trail.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Prevents interaction.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
     {
       "name": "nys-button",
       "description": "Button for actions and CTAs with variants, sizes, and icon support.\n---\n\n\n### **Events:**\n - **nys-focus** - Fired when the button receives focus.\n- **nys-blur** - Fired when the button loses focus.\n- **nys-click** - Fired when the button is clicked (mouse or keyboard). Not fired when disabled.\n\n### **Slots:**\n - **prefix-icon** - Icon before label. Not shown for `text` variant.\n- **suffix-icon** - Icon after label. Not shown for `text` variant.\n- **circle-icon** - Icon for circle mode. Overrides `icon` prop.\n\n### **CSS Properties:**\n - **--nys-button-color** - Text color of the button label. _(default: undefined)_\n- **--nys-button-color--hover** - Text color when hovered. _(default: undefined)_\n- **--nys-button-color--active** - Text color when active/pressed. _(default: undefined)_\n- **--nys-button-background-color** - Background color of the button. _(default: undefined)_\n- **--nys-button-background-color--hover** - Background color when hovered. _(default: undefined)_\n- **--nys-button-background-color--active** - Background color when active/pressed. _(default: undefined)_\n- **--nys-button-border-color** - Border color of the button. _(default: undefined)_\n- **--nys-button-border-color--hover** - Border color when hovered. _(default: undefined)_\n- **--nys-button-border-color--active** - Border color when active/pressed. _(default: undefined)_",
@@ -292,12 +339,12 @@
         },
         {
           "name": "prefixIcon",
-          "description": "Material Symbol icon before label. Not shown for `text` variant or `circle` mode.",
+          "description": "Material Symbol icon before label. Not shown for `circle` mode.",
           "values": []
         },
         {
           "name": "suffixIcon",
-          "description": "Material Symbol icon after label. Use `chevron_down` for dropdowns, `open_in_new` for external links. Not shown for `text` variant or `circle` mode.",
+          "description": "Material Symbol icon after label. Use `chevron_down` for dropdowns, `open_in_new` for external links. Not shown for `circle` mode.",
           "values": []
         },
         {
@@ -429,11 +476,6 @@
           "description": "Renders as tile with larger clickable area. Apply to group for consistency.",
           "values": []
         },
-        {
-          "name": "inverted",
-          "description": "Adjusts colors for dark backgrounds.",
-          "values": []
-        },
         {
           "name": "tooltip",
           "description": "Tooltip text shown on hover/focus of info icon.",
@@ -503,11 +545,6 @@
           "description": "Tooltip text shown on hover/focus of info icon.",
           "values": []
         },
-        {
-          "name": "inverted",
-          "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-          "values": []
-        },
         {
           "name": "form",
           "description": "Form `id` to associate with. Applied to all children.",
@@ -695,6 +732,11 @@
       "name": "nys-errormessage",
       "description": "Internal error message display with icon and ARIA alert support.\n---\n",
       "attributes": [
+        {
+          "name": "id",
+          "description": "The \"id\" of the error message.",
+          "values": []
+        },
         {
           "name": "showError",
           "description": "Whether to display the error message.",
@@ -932,13 +974,9 @@
     },
     {
       "name": "nys-label",
-      "description": "Internal label component for form fields with flag and tooltip support.\n---\n\n\n### **Slots:**\n - **description** - Custom HTML description content below the label.",
+      "description": "Internal label component for form fields with flag and tooltip support.\n---\n\n\n### **Events:**\n - **nys-label-click**\n\n### **Slots:**\n - **description** - Custom HTML description content below the label.",
       "attributes": [
-        {
-          "name": "for",
-          "description": "ID of the form element this label is associated with.",
-          "values": []
-        },
+        { "name": "id", "description": "The ID of the label.", "values": [] },
         {
           "name": "label",
           "description": "Label text displayed above the form field.",
@@ -1080,11 +1118,6 @@
           "description": "Value submitted when this radio is selected.",
           "values": []
         },
-        {
-          "name": "inverted",
-          "description": "Adjusts colors for dark backgrounds.",
-          "values": []
-        },
         {
           "name": "form",
           "description": "Form `id` to associate with.",
@@ -1159,11 +1192,6 @@
           "description": "Tooltip text shown on hover/focus of info icon.",
           "values": []
         },
-        {
-          "name": "inverted",
-          "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-          "values": []
-        },
         {
           "name": "form",
           "description": "Form `id` to associate with. Applied to all children.",
@@ -1374,6 +1402,62 @@
       ],
       "references": []
     },
+    {
+      "name": "nys-tab",
+      "description": "`<nys-tab>` is a single tab within a `<nys-tabgroup>`.\n\nThe host element carries `role=\"tab\"`, `tabindex`, `aria-selected`,\n`aria-controls`, and `aria-disabled` so assistive technologies see the\ncorrect ARIA tab semantics on the element that is actually focused.\n`<nys-tabgroup>` manages `tabindex`, `aria-selected`, and `aria-controls`\nvia `_applySelection`; do not set them directly on this element.\n---\n\n\n### **Events:**\n - **nys-tab-select** - Dispatched when the tab is activated via click or Enter / Space. Bubbles and crosses shadow DOM boundaries. `detail: { id: string, label: string }`\n- **nys-tab-focus** - Dispatched when the host receives focus. Bubbles and crosses shadow DOM boundaries. `detail: { id: string }`\n- **nys-tab-blur** - Dispatched when the host loses focus. Bubbles and crosses shadow DOM boundaries. `detail: { id: string }`\n\n### **Methods:**\n - **focus(options: _FocusOptions_): _void_** - Focuses the host element. The host carries `role=\"tab\"` and `tabindex`,\nso it is the correct element for AT to land on.\n\n### **Slots:**\n - _default_ - No slots; content is derived from the `label` property.",
+      "attributes": [
+        {
+          "name": "id",
+          "description": "Unique identifier for the tab element.\nReflected to the DOM attribute so `aria-controls` references resolve.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "Visible text label rendered inside the inner `<span>`.",
+          "values": []
+        },
+        {
+          "name": "selected",
+          "description": "Whether this tab is the currently active tab.\nManaged by `<nys-tabgroup>`; reflected for CSS attribute selectors.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Whether this tab is disabled.\nReflected to the DOM attribute for CSS styling.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "nys-tabgroup",
+      "description": "`<nys-tabgroup>` is the container for `<nys-tab>` and `<nys-tabpanel>`\nelements.\n\nAccepts tabs and panels as flat light-DOM children in any order (interleaved\nor grouped). On slot change, children are sorted into dedicated shadow-DOM\ncontainers, ARIA relationships are wired, and the first selected (or first)\ntab is activated.\n\nScroll shadows are rendered on either side of the tab list and toggled via\n`ResizeObserver` and a `scroll` listener so they accurately reflect whether\noverflow content exists in each direction.\n\nKeyboard navigation follows the\nhttps://www.w3.org/WAI/ARIA/apg/patterns/tabs/ ARIA Tabs Pattern:\n- Arrow keys move focus without changing selection.\n- Enter / Space confirm selection on the focused tab.\n---\n\n\n### **Slots:**\n - _default_ - Accepts `<nys-tab>` and `<nys-tabpanel>` children. Elements are moved into internal shadow-DOM containers on `slotchange`; the slot itself is not rendered visibly.",
+      "attributes": [
+        {
+          "name": "id",
+          "description": "Unique identifier for the tabgroup element.\nIf not provided, one is auto-generated in `connectedCallback`.\nReflected to the DOM attribute.",
+          "values": []
+        },
+        {
+          "name": "name",
+          "description": "The name of the tab group.\nUsed for form submission and accessibility purposes.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "nys-tabpanel",
+      "description": "`<nys-tabpanel>` is a content panel paired with a `<nys-tab>` inside a\n`<nys-tabgroup>`.\n\nPairing is determined by render order: the Nth `<nys-tabpanel>` child of a\n`<nys-tabgroup>` corresponds to the Nth `<nys-tab>` child.\n`aria-labelledby` and the `hidden` attribute are managed externally by\n`<nys-tabgroup>` via `_applySelection`; do not set them directly.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for panel content. Rendered inside a wrapper `<div>` with the `.nys-tabpanel` class for styling.",
+      "attributes": [
+        {
+          "name": "id",
+          "description": "Unique identifier for the panel element.\nIf not provided, one is auto-generated in `connectedCallback`.\nReflected to the DOM attribute so `aria-controls` references on sibling\n`<nys-tab>` elements resolve correctly.",
+          "values": []
+        }
+      ],
+      "references": []
+    },
     {
       "name": "nys-table",
       "description": "`<nys-table>` is a responsive table component that can display native HTML tables,\nsupports striped and bordered styling, sortable columns, and CSV download.\n---\n\n\n### **Events:**\n - **nys-click** - Fired when the download button or sortable headers are clicked.\n- **nys-column-sort** - Fired when a sortable column header is clicked.  Can be prevented by calling `event.preventDefault()` to override default sort behavior. Detail: { columnIndex: number, columnLabel: string, sortDirection: \"asc\" | \"desc\" | \"none\" }\n\n### **Slots:**\n - _default_ - Accepts a `<table>` element. Only the first table is rendered.",
@@ -1777,7 +1861,7 @@
     },
     {
       "name": "nys-video",
-      "description": "\n---\n",
+      "description": "YouTube video player with thumbnail preview and accessibility announcements.\n---\n\n\n### **Events:**\n - **nys-video-play** - Fired when the user clicks the thumbnail to load the player.",
       "attributes": [
         {
           "name": "id",