@nysds/components 1.17.0 → 1.18.0

package/custom-elements.json

@@ -1058,7 +1058,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A floating \"Back to top\" button that appears after scrolling. Smooth-scrolls to page top when clicked.\n\nAuto-shows after scrolling 1.5 viewports on pages 4+ screens tall. Set `visible` to force display.\nRenders as circle button on mobile. Position with `position` prop (`left` or `right`).",
+          "description": "A floating \"Back to top\" button that appears after scrolling. Smooth-scrolls to page top when clicked.\n\nAuto-shows after scrolling 1.5 viewports on pages 4+ screens tall. Set `visible` to force display.\nRenders as circle button on mobile. Position with `position` prop (`left` or `right`).\n\n**Placement:** For best accessibility, place as the first focusable element in the page footer.\nIf no footer exists, place at the bottom of the body tag (after main content). Floating\npositioning allows it to overlay content without taking up layout space.\n\n**Focus Management:** When clicked, after scrolling to the top, focus is automatically moved\nto the `<main>` element (if present), the first heading (`<h1>` or `<h2>`), or the document element.\nThis ensures keyboard navigation continues naturally from the top of the page.",
           "name": "NysBacktotop",
           "members": [
             {
@@ -1119,6 +1119,11 @@
               "name": "_scrollToTop",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_moveFocusToTop",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleResize",
@@ -1153,11 +1158,11 @@
           },
           "tagName": "nys-backtotop",
           "customElement": true,
-          "summary": "Floating back-to-top button with auto-show behavior and smooth scroll.",
+          "summary": "Floating back-to-top button with auto-show behavior, smooth scroll, and focus management.",
           "examples": [
             {
-              "title": "Auto-appearing button",
-              "code": "<nys-backtotop></nys-backtotop>",
+              "title": "Auto-appearing button in footer",
+              "code": "<footer>\n<nys-backtotop></nys-backtotop>\n<!-- Other footer content -->\n</footer>",
               "lang": "html"
             },
             {
@@ -1275,6 +1280,16 @@
               "description": "Primary label text displayed in the badge.",
               "attribute": "label"
             },
+            {
+              "kind": "field",
+              "name": "srText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Screen reader text appended after the label for additional context.",
+              "attribute": "srText"
+            },
             {
               "kind": "field",
               "name": "variant",
@@ -1413,6 +1428,16 @@
               "fieldName": "label",
               "propName": "label"
             },
+            {
+              "name": "srText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Screen reader text appended after the label for additional context.",
+              "fieldName": "srText",
+              "propName": "srtext"
+            },
             {
               "name": "variant",
               "type": {
@@ -2712,17 +2737,6 @@
               "attribute": "tile",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "attribute": "inverted",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "tooltip",
@@ -3127,16 +3141,6 @@
               "fieldName": "tile",
               "propName": "tile"
             },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "fieldName": "inverted",
-              "propName": "inverted"
-            },
             {
               "name": "tooltip",
               "type": {
@@ -3222,7 +3226,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A container for grouping multiple `nys-checkbox` components as a single form control.\nHandles validation, required constraints, and submits comma-separated values.\n\nUse to allow users to select multiple options from a list. Apply `tile`, `size`, and `inverted` to the group\nand all children inherit these styles automatically.",
+          "description": "A container for grouping multiple `nys-checkbox` components as a single form control.\nHandles validation, required constraints, and submits comma-separated values.\n\nUse to allow users to select multiple options from a list. Apply `tile` and `size` to the group\nand all children inherit these styles automatically.",
           "name": "NysCheckboxgroup",
           "slots": [
             {
@@ -3350,17 +3354,6 @@
               "description": "Tooltip text shown on hover/focus of info icon.",
               "attribute": "tooltip"
             },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-              "attribute": "inverted",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "form",
@@ -3464,11 +3457,6 @@
               "name": "_updateCheckboxTile",
               "privacy": "private"
             },
-            {
-              "kind": "method",
-              "name": "_updateCheckboxInvert",
-              "privacy": "private"
-            },
             {
               "kind": "method",
               "name": "_updateCheckboxShowError",
@@ -3662,16 +3650,6 @@
               "fieldName": "tooltip",
               "propName": "tooltip"
             },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-              "fieldName": "inverted",
-              "propName": "inverted"
-            },
             {
               "name": "form",
               "type": {
@@ -8392,17 +8370,6 @@
               "description": "Value submitted when this radio is selected.",
               "attribute": "value"
             },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "attribute": "inverted",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "form",
@@ -8700,16 +8667,6 @@
               "fieldName": "value",
               "propName": "value"
             },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "fieldName": "inverted",
-              "propName": "inverted"
-            },
             {
               "name": "form",
               "type": {
@@ -8800,7 +8757,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A container for grouping `nys-radiobutton` elements as a single form control with enforced single selection.\nHandles keyboard navigation (arrow keys), validation, required constraints, and form integration.\n\nUse to let users select exactly one option from 2-6 choices. Apply `tile`, `size`, and `inverted` to the group\nand all children inherit these styles automatically. For 7+ options, use `nys-select`.",
+          "description": "A container for grouping `nys-radiobutton` elements as a single form control with enforced single selection.\nHandles keyboard navigation (arrow keys), validation, required constraints, and form integration.\n\nUse to let users select exactly one option from 2-6 choices. Apply `tile` and `size` to the group\nand all children inherit these styles automatically. For 7+ options, use `nys-select`.",
           "name": "NysRadiogroup",
           "slots": [
             {
@@ -8928,17 +8885,6 @@
               "description": "Tooltip text shown on hover/focus of info icon.",
               "attribute": "tooltip"
             },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-              "attribute": "inverted",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "form",
@@ -9066,11 +9012,6 @@
               "name": "_updateRadioButtonsTile",
               "privacy": "private"
             },
-            {
-              "kind": "method",
-              "name": "_updateRadioButtonsInvert",
-              "privacy": "private"
-            },
             {
               "kind": "method",
               "name": "_updateRadioButtonsShowError",
@@ -9246,16 +9187,6 @@
               "fieldName": "tooltip",
               "propName": "tooltip"
             },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds. Applied to all children.",
-              "fieldName": "inverted",
-              "propName": "inverted"
-            },
             {
               "name": "form",
               "type": {
@@ -10580,7 +10511,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-table/src/index.ts",
+      "path": "packages/nys-tab/src/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -10588,22 +10519,38 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "packages/nys-table/src/nys-table"
+            "module": "packages/nys-tab/src/nys-tab"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-tab/src/nys-tabgroup"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-tab/src/nys-tabpanel"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-table/src/nys-table.ts",
+      "path": "packages/nys-tab/src/nys-tab.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "`<nys-table>` is a responsive table component that can display native HTML tables,\nsupports striped and bordered styling, sortable columns, and CSV download.",
-          "name": "NysTable",
+          "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.",
+          "name": "NysTab",
           "slots": [
             {
-              "description": "Accepts a `<table>` element. Only the first table is rendered.",
+              "description": "No slots; content is derived from the `label` property.",
               "name": ""
             }
           ],
@@ -10615,148 +10562,736 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Unique identifier for the tab element.\nReflected to the DOM attribute so `aria-controls` references resolve.",
               "attribute": "id",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "name",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "attribute": "name",
-              "reflects": true
+              "description": "Visible text label rendered inside the inner `<span>`.",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "striped",
+              "name": "selected",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "striped",
+              "description": "Whether this tab is the currently active tab.\nManaged by `<nys-tabgroup>`; reflected for CSS attribute selectors.",
+              "attribute": "selected",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "sortable",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "sortable",
+              "description": "Whether this tab is disabled.\nReflected to the DOM attribute for CSS styling.",
+              "attribute": "disabled",
               "reflects": true
             },
             {
-              "kind": "field",
-              "name": "bordered",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "focus",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "false",
-              "attribute": "bordered",
-              "reflects": true
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ],
+              "description": "Focuses the host element. The host carries `role=\"tab\"` and `tabindex`,\nso it is the correct element for AT to land on."
             },
             {
               "kind": "field",
-              "name": "download",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "attribute": "download",
-              "reflects": true
+              "name": "_onKeydown",
+              "privacy": "private",
+              "description": "Enter / Space on the focused host activate the tab.\nArrow-key navigation is handled one level up by `<nys-tabgroup>`."
             },
             {
               "kind": "field",
-              "name": "_sortColumn",
-              "type": {
-                "text": "number | null"
-              },
+              "name": "_onFocus",
               "privacy": "private",
-              "default": "null"
+              "description": "Host focus → dispatch `nys-tab-focus` for external observers."
             },
             {
               "kind": "field",
-              "name": "_sortDirection",
-              "type": {
-                "text": "\"asc\" | \"desc\" | \"none\""
-              },
+              "name": "_onBlur",
               "privacy": "private",
-              "default": "\"none\""
+              "description": "Host blur → dispatch `nys-tab-blur` for external observers."
             },
             {
               "kind": "field",
-              "name": "_captionText",
-              "type": {
-                "text": "string"
-              },
+              "name": "_onClick",
               "privacy": "private",
-              "default": "\"\""
-            },
-            {
-              "kind": "method",
-              "name": "_handleSlotChange"
+              "description": "Host-level click handler. Activates the tab regardless of whether the\nclick landed on the inner element (normal pointer/keyboard tap, which\nbubbles up) or directly on the host (iOS VoiceOver double-tap dispatches\n`click` on the element with `role=\"tab\"`, bypassing shadow-DOM children)."
             },
             {
               "kind": "method",
-              "name": "_normalizeTableDOM",
-              "parameters": [
-                {
-                  "name": "table",
-                  "type": {
-                    "text": "HTMLTableElement"
-                  }
+              "name": "_handleClick",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
                 }
-              ]
-            },
+              },
+              "description": "Focuses the host then dispatches `nys-tab-select`. Called from both the\nclick handler and the keydown handler."
+            }
+          ],
+          "events": [
             {
-              "kind": "method",
-              "name": "_addSortIcons",
-              "parameters": [
-                {
-                  "name": "table",
-                  "type": {
-                    "text": "HTMLTableElement"
-                  }
-                }
-              ]
+              "name": "nys-tab-select",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched when the tab is activated via click or Enter / Space. Bubbles and crosses shadow DOM boundaries. `detail: { id: string, label: string }`"
             },
             {
-              "kind": "method",
-              "name": "_updateSortIcons",
-              "parameters": [
-                {
-                  "name": "table",
-                  "type": {
-                    "text": "HTMLTableElement"
-                  }
-                }
-              ]
+              "description": "Dispatched when the host receives focus. Bubbles and crosses shadow DOM boundaries. `detail: { id: string }`",
+              "name": "nys-tab-focus"
             },
             {
-              "kind": "method",
-              "name": "_onSortClick",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "columnIndex",
-                  "type": {
-                    "text": "number"
-                  }
-                },
-                {
-                  "name": "table",
-                  "type": {
-                    "text": "HTMLTableElement"
-                  }
-                }
-              ]
+              "description": "Dispatched when the host loses focus. Bubbles and crosses shadow DOM boundaries. `detail: { id: string }`",
+              "name": "nys-tab-blur"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Unique identifier for the tab element.\nReflected to the DOM attribute so `aria-controls` references resolve.",
+              "fieldName": "id",
+              "attribute": "id",
+              "propName": "id"
             },
             {
-              "kind": "method",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Visible text label rendered inside the inner `<span>`.",
+              "fieldName": "label",
+              "attribute": "label",
+              "propName": "label"
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this tab is the currently active tab.\nManaged by `<nys-tabgroup>`; reflected for CSS attribute selectors.",
+              "fieldName": "selected",
+              "attribute": "selected",
+              "propName": "selected"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this tab is disabled.\nReflected to the DOM attribute for CSS styling.",
+              "fieldName": "disabled",
+              "attribute": "disabled",
+              "propName": "disabled"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-tab",
+          "customElement": true,
+          "examples": [
+            {
+              "title": "`<nys-tab>` and `<nys-tabpanel>` should always be wrapped by `<nys-tabgroup>`",
+              "code": "<!-- Always place <nys-tab> elements inside a <nys-tabgroup>. -->\n<nys-tabgroup name=\"My Tabs\">\n<nys-tab label=\"Overview\"></nys-tab>\n<nys-tab label=\"Details\" selected></nys-tab>\n<nys-tab label=\"Archived\" disabled></nys-tab>\n<nys-tabpanel><p>Overview content</p></nys-tabpanel>\n<nys-tabpanel><p>Details content (shown by default)</p></nys-tabpanel>\n<nys-tabpanel><p>Archived content</p></nys-tabpanel>\n</nys-tabgroup>",
+              "lang": "html"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-tab",
+          "declaration": {
+            "name": "NysTab",
+            "module": "packages/nys-tab/src/nys-tab.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysTab",
+          "declaration": {
+            "name": "NysTab",
+            "module": "packages/nys-tab/src/nys-tab.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-tab/src/nys-tabgroup.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "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.",
+          "name": "NysTabgroup",
+          "slots": [
+            {
+              "description": "Accepts `<nys-tab>` and `<nys-tabpanel>` children. Elements are moved into internal shadow-DOM containers on `slotchange`; the slot itself is not rendered visibly.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Unique identifier for the tabgroup element.\nIf not provided, one is auto-generated in `connectedCallback`.\nReflected to the DOM attribute.",
+              "attribute": "id",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The name of the tab group.\nUsed for form submission and accessibility purposes.",
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "_tabsEl",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private",
+              "description": "Cached in `firstUpdated` and used by `_updateScrollShadows` to read\nscroll position and dimensions."
+            },
+            {
+              "kind": "field",
+              "name": "_shadowLeft",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private",
+              "description": "Reference to the left scroll-shadow overlay element.\nReceives the `is-visible` class when the tab list is scrolled away from\nits leftmost position."
+            },
+            {
+              "kind": "field",
+              "name": "_shadowRight",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "privacy": "private",
+              "description": "Reference to the right scroll-shadow overlay element.\nReceives the `is-visible` class when overflow content exists to the right\nof the current scroll position."
+            },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private",
+              "description": "`ResizeObserver` instance watching `_tabsEl` for size changes.\nRe-evaluates scroll shadow visibility whenever the tab list is resized\n(e.g. viewport resize, dynamic tab additions).\nStored so it can be disconnected if needed."
+            },
+            {
+              "kind": "field",
+              "name": "_updateScrollShadows",
+              "privacy": "private",
+              "description": "Reads the current scroll state of `_tabsEl` and toggles the `is-visible`\nclass on the left and right shadow overlays accordingly.\n\n- Left shadow is visible when `scrollLeft > 0`.\n- Right shadow is visible when `scrollLeft + clientWidth < scrollWidth`\n  (i.e. content exists beyond the right edge).\n\nDefined as an arrow function so it can be passed directly as an event\nlistener without losing `this` context.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_getTabs",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Returns all `<nys-tab>` elements currently residing in the shadow-DOM\ntabs container, in DOM order."
+            },
+            {
+              "kind": "method",
+              "name": "_getPanels",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Returns all `<nys-tabpanel>` elements currently residing in the\nshadow-DOM panels container, in DOM order."
+            },
+            {
+              "kind": "method",
+              "name": "_applySelection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "tabs",
+                  "type": {
+                    "text": "HTMLElement[]"
+                  },
+                  "description": "Ordered array of `<nys-tab>` elements to update."
+                },
+                {
+                  "name": "panels",
+                  "type": {
+                    "text": "HTMLElement[]"
+                  },
+                  "description": "Ordered array of `<nys-tabpanel>` elements to update.\nMust be the same length as `tabs` for correct pairing."
+                },
+                {
+                  "name": "selectedIndex",
+                  "type": {
+                    "text": "number"
+                  },
+                  "description": "Zero-based index of the tab/panel pair to activate."
+                }
+              ],
+              "description": "Single source of truth for ARIA wiring, `tabindex`, and panel visibility.\n\nFor each index `i`:\n- Sets `selected` / removes `selected` attribute on `tabs[i]`.\n- Sets `aria-controls` on `tabs[i]` to the `id` of `panels[i]`.\n- Sets `aria-labelledby` on `panels[i]` to the `id` of `tabs[i]`.\n- Removes `hidden` from `panels[selectedIndex]`; adds it to all others.\n\nMust be called any time the selected tab changes (initial render and\nsubsequent user interactions)."
+            },
+            {
+              "kind": "method",
+              "name": "_sortChildren",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  },
+                  "description": "The `Event` fired by the `<slot>` element on slot change."
+                }
+              ],
+              "description": "Handles `slotchange` on the default slot.\n\nIterates over all assigned elements and moves each `<nys-tab>` into\n`.nys-tabgroup__tabs` and each `<nys-tabpanel>` into\n`.nys-tabgroup__panels`, preserving relative order. After sorting,\ncalls `_applySelection` using the first element that already has a\n`selected` attribute, or index `0` if none is found."
+            },
+            {
+              "kind": "method",
+              "name": "_handleTabSelect",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  },
+                  "description": "The `Event` (cast to `CustomEvent`) dispatched by `<nys-tab>`."
+                }
+              ],
+              "description": "Handles the `nys-tab-select` custom event bubbled up from a child\n`<nys-tab>`.\n\nResolves the originating `<nys-tab>` via `composedPath()` (required\nbecause the event crosses shadow DOM boundaries), determines its index\namong the current tab list, and delegates to `_applySelection`."
+            },
+            {
+              "kind": "method",
+              "name": "_handleKeydown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  },
+                  "description": "The `KeyboardEvent` from the tablist `keydown` listener."
+                }
+              ],
+              "description": "Implements the ARIA radio-button keyboard pattern:\n- `ArrowRight` — moves focus to the next enabled tab (wraps).\n- `ArrowLeft` — moves focus to the previous enabled tab (wraps).\n\nFocus is moved without changing selection; Enter / Space on the newly\nfocused tab (handled by `<nys-tab>._handleKeydown`) confirm selection.\n\nThe currently focused tab is resolved via `composedPath()` because focus\nmay sit on a shadow-DOM descendant of `<nys-tab>` rather than the host\nitself.\n\nDisabled tabs are excluded from navigation and will never receive focus\nvia arrow keys."
+            },
+            {
+              "kind": "field",
+              "name": "_handleWheel",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Unique identifier for the tabgroup element.\nIf not provided, one is auto-generated in `connectedCallback`.\nReflected to the DOM attribute.",
+              "fieldName": "id",
+              "attribute": "id",
+              "propName": "id"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The name of the tab group.\nUsed for form submission and accessibility purposes.",
+              "fieldName": "name",
+              "attribute": "name",
+              "propName": "name"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-tabgroup",
+          "customElement": true,
+          "examples": [
+            {
+              "title": "Disable a tab using the `disabled` attribute on `<nys-tab>`.",
+              "code": "<nys-tabgroup name=\"Account Settings\">\n<nys-tab label=\"Profile\"></nys-tab>\n<nys-tab label=\"Security\"></nys-tab>\n<nys-tab label=\"Notifications\" disabled></nys-tab>\n<nys-tabpanel><p>Manage your profile information.</p></nys-tabpanel>\n<nys-tabpanel><p>Update your password and 2FA settings.</p></nys-tabpanel>\n<nys-tabpanel><p>Notification preferences (coming soon).</p></nys-tabpanel>\n</nys-tabgroup>",
+              "lang": "html"
+            },
+            {
+              "title": "Pre-select a tab using the `selected` attribute on `<nys-tab>`.",
+              "code": "<nys-tabgroup name=\"Reports\">\n<nys-tab label=\"Summary\"></nys-tab>\n<nys-tab label=\"Details\" selected></nys-tab>\n<nys-tabpanel><p>Summary view</p></nys-tabpanel>\n<nys-tabpanel><p>Detailed view (shown by default)</p></nys-tabpanel>\n</nys-tabgroup>",
+              "lang": "html"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-tabgroup",
+          "declaration": {
+            "name": "NysTabgroup",
+            "module": "packages/nys-tab/src/nys-tabgroup.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysTabgroup",
+          "declaration": {
+            "name": "NysTabgroup",
+            "module": "packages/nys-tab/src/nys-tabgroup.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-tab/src/nys-tabpanel.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "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.",
+          "name": "NysTabpanel",
+          "slots": [
+            {
+              "description": "Default slot for panel content. Rendered inside a wrapper `<div>` with the `.nys-tabpanel` class for styling.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "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.",
+              "attribute": "id",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "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.",
+              "fieldName": "id",
+              "attribute": "id",
+              "propName": "id"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-tabpanel",
+          "customElement": true,
+          "examples": [
+            {
+              "title": "Panel content is wrapped by `<nys-tabpanel>`.",
+              "code": "<!-- Panels are paired by position with <nys-tab> elements in the same <nys-tabgroup>. -->\n<nys-tabgroup name=\"Steps\">\n<nys-tab label=\"Step 1\"></nys-tab>\n<nys-tab label=\"Step 2\"></nys-tab>\n<nys-tabpanel>\n<h2>Step 1: Enter your information</h2>\n<p>Fill out the form below.</p>\n</nys-tabpanel>\n<nys-tabpanel>\n<h2>Step 2: Review and submit</h2>\n<p>Confirm your details before submitting.</p>\n</nys-tabpanel>\n</nys-tabgroup>",
+              "lang": "html"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-tabpanel",
+          "declaration": {
+            "name": "NysTabpanel",
+            "module": "packages/nys-tab/src/nys-tabpanel.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysTabpanel",
+          "declaration": {
+            "name": "NysTabpanel",
+            "module": "packages/nys-tab/src/nys-tabpanel.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-table/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-table/src/nys-table"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-table/src/nys-table.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<nys-table>` is a responsive table component that can display native HTML tables,\nsupports striped and bordered styling, sortable columns, and CSV download.",
+          "name": "NysTable",
+          "slots": [
+            {
+              "description": "Accepts a `<table>` element. Only the first table is rendered.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "id",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "striped",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "striped",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sortable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "sortable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "bordered",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "bordered",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "download",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "download",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_sortColumn",
+              "type": {
+                "text": "number | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_sortDirection",
+              "type": {
+                "text": "\"asc\" | \"desc\" | \"none\""
+              },
+              "privacy": "private",
+              "default": "\"none\""
+            },
+            {
+              "kind": "field",
+              "name": "_captionText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
+            },
+            {
+              "kind": "field",
+              "name": "_observer",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "description": "****************** Functions *******************"
+            },
+            {
+              "kind": "method",
+              "name": "_setupMutationObserver",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_normalizeTableDOM",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_addSortIcons",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_updateSortIcons",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onSortClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
               "name": "_sortTable",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "table",
@@ -10781,6 +11316,7 @@
             {
               "kind": "method",
               "name": "_updateSortedColumnStyles",
+              "privacy": "private",
               "parameters": [
                 {
                   "name": "table",
@@ -10792,7 +11328,8 @@
             },
             {
               "kind": "method",
-              "name": "downloadFile"
+              "name": "downloadFile",
+              "privacy": "public"
             },
             {
               "kind": "method",