@nysds/components 1.17.0 → 1.18.1

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": "\"\"" }]
@@ -471,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.",
@@ -545,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.",
@@ -1123,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.",
@@ -1202,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.",
@@ -1417,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.",