@nysds/components 1.12.0 → 1.13.0

package/dist/custom-elements.json

@@ -31,8 +31,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "The \"nys-accordion\" is the wrapper that groups individual accordion items within it.\nThe items within is called \"nys-accordionitem\"",
+          "description": "`<nys-accordion>` groups one or more `<nys-accordionitem>` elements.\n\nFeatures:\n- Optionally enforces single-expanded-item behavior via `singleSelect`.\n- Propagates shared visual `bordered` property to child items.\n- Generates a stable unique identifier if none is provided.",
           "name": "NysAccordion",
+          "slots": [
+            {
+              "description": "Place one or more `<nys-accordionitem>` components here.",
+              "name": "default"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -67,11 +73,12 @@
             {
               "kind": "method",
               "name": "_generateUniqueId",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
-              "name": "_getAccordions",
+              "name": "_getAccordionItems",
               "privacy": "private"
             },
             {
@@ -93,6 +100,12 @@
               "privacy": "private"
             }
           ],
+          "events": [
+            {
+              "description": "Fired when a child `<nys-accordionitem>` is toggled. Event detail includes `{ id: string, heading: string, expanded: boolean }`.",
+              "name": "nys-accordionitem-toggle"
+            }
+          ],
           "attributes": [
             {
               "name": "id",
@@ -152,8 +165,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-accordionitem>` represents a single collapsible item inside a `<nys-accordion>`.",
           "name": "NysAccordionItem",
+          "slots": [
+            {
+              "description": "Default slot for the content inside the accordion panel.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -197,7 +216,8 @@
             {
               "kind": "method",
               "name": "_generateUniqueId",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -241,7 +261,8 @@
               "name": "nys-accordionitem-toggle",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when the item is expanded or collapsed."
             }
           ],
           "attributes": [
@@ -326,8 +347,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-alert>` renders an informational, success, warning, or error alert.",
           "name": "NysAlert",
+          "slots": [
+            {
+              "description": "Default slot for additional alert content.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -456,6 +483,16 @@
               "type": {
                 "text": "{\n    role: \"alert\" | \"status\" | \"region\";\n    ariaLabel: string;\n  }"
               },
+              "description": "Returns ARIA role and label based on alert type.\n- 'alert' => assertive live region (implied)\n- 'status' => polite live region\n- 'region' => generic, requires aria-label",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "liveRegion",
+              "type": {
+                "text": "\"polite\" | undefined"
+              },
+              "description": "Returns live-region type for screen readers if applicable.\n- 'polite' for status role\n- undefined for alert (since it's implicitly assertive) or region",
               "readonly": true
             },
             {
@@ -465,16 +502,18 @@
                 "text": "any"
               },
               "privacy": "private",
-              "default": "null"
+              "default": "null",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_generateUniqueId",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
-              "name": "_getIconName",
+              "name": "_resolveIconName",
               "privacy": "private"
             },
             {
@@ -490,7 +529,8 @@
             {
               "kind": "method",
               "name": "_checkSlotContent",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Checks whether the default slot has content.\nUpdates `_slotHasContent` accordingly."
             }
           ],
           "events": [
@@ -498,7 +538,8 @@
               "name": "nys-close",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when alert is dismissed (manual or timeout)."
             }
           ],
           "attributes": [
@@ -639,8 +680,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-avatar>` displays a user avatar as an image, initials, or icon.",
           "name": "NysAvatar",
+          "slots": [
+            {
+              "description": "Default slot for custom icon content. Fallback icon is used if slot is empty. Features: - Computes foreground color for sufficient contrast based on background. - Supports interactive avatars with button role. - Fallback to icon when image or initials are missing. - Lazy loading for performance optimization.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -744,7 +791,13 @@
             {
               "kind": "method",
               "name": "getContrastForeground",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Computes the appropriate foreground color (icon or initials)\nbased on the avatar's background color for sufficient contrast.",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              }
             }
           ],
           "attributes": [
@@ -869,7 +922,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-backtotop>` renders a button that scrolls the page to the top.\n\nFeatures:\n- Automatically appears after scrolling past 1.5 viewport heights\n  if the page is at least 4 screens tall.\n- Adapts to mobile screens (renders as a circle button when narrow).\n- Can be explicitly shown with the `visible` attribute.",
           "name": "NysBacktotop",
           "members": [
             {
@@ -920,7 +973,8 @@
             {
               "kind": "method",
               "name": "_handleScroll",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -933,6 +987,12 @@
               "privacy": "private"
             }
           ],
+          "events": [
+            {
+              "description": "Fired when the button is clicked (scrolls page to top).",
+              "name": "nys-click"
+            }
+          ],
           "attributes": [
             {
               "name": "position",
@@ -999,7 +1059,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-badge>` displays a badge with optional prefix/suffix icons and labels.\n\nFeatures:\n- Conveys an intent (`neutral`, `error`, `success`, `warning`) which affects default icons and styling.\n- Supports custom prefix and suffix icons.",
           "name": "NysBadge",
           "members": [
             {
@@ -1103,7 +1163,8 @@
               "privacy": "private",
               "static": true,
               "readonly": true,
-              "default": "{ neutral: \"info\", error: \"emergency_home\", success: \"check_circle\", warning: \"warning\", }"
+              "default": "{ neutral: \"info\", error: \"emergency_home\", success: \"check_circle\", warning: \"warning\", }",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -1111,7 +1172,7 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string | null"
+                  "text": ""
                 }
               },
               "parameters": [
@@ -1119,9 +1180,11 @@
                   "name": "icon",
                   "type": {
                     "text": "string | boolean"
-                  }
+                  },
+                  "description": "The icon property value (string or boolean)"
                 }
-              ]
+              ],
+              "description": "Resolves which icon should be rendered."
             }
           ],
           "attributes": [
@@ -1236,7 +1299,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-button>` is a versatile button component supporting:\n- Multiple variants (`filled`, `outline`, `ghost`, `text`)\n- Sizes (`sm`, `md`, `lg`) and full-width layout\n- Icons (prefix, suffix, or circle) and optional labels\n- Native `<button>` or link `<a>` behavior with form association\n- Keyboard and accessibility support (`aria-label`, `aria-controls`, `aria-description`)",
           "name": "NysButton",
           "members": [
             {
@@ -1463,12 +1526,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_generateUniqueId",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -1478,7 +1543,8 @@
             {
               "kind": "method",
               "name": "_handleFocus",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -1537,19 +1603,22 @@
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when button receives focus"
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when button loses focus"
             },
             {
               "name": "nys-click",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired on button click"
             }
           ],
           "attributes": [
@@ -1770,8 +1839,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-checkbox>` is an accessible, form-associated checkbox component.\nCan be used standalone or within a `<nys-checkboxgroup>`.\n\nFeatures:\n- Supports labels, descriptions, and tooltips\n- Displays error messages with `showError` and `errorMessage`\n- Keyboard interaction with spacebar toggle\n- Form integration via ElementInternals (`checked` value submitted)",
           "name": "NysCheckbox",
+          "slots": [
+            {
+              "description": "Slot to provide a custom description element",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -1952,16 +2027,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
-            },
-            {
-              "kind": "method",
-              "name": "formResetCallback"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -1987,6 +2060,10 @@
               "name": "_validate",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
             {
               "kind": "method",
               "name": "checkValidity",
@@ -1994,7 +2071,8 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -2017,7 +2095,8 @@
             {
               "kind": "method",
               "name": "_emitChangeEvent",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -2061,19 +2140,22 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when checkbox value changes"
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired on focus"
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired on blur"
             }
           ],
           "attributes": [
@@ -2239,8 +2321,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-checkboxgroup>` is a form-associated container for multiple `<nys-checkbox>` components.\nHandles grouping, validation, required constraints, form submission, and accessibility.\n\nFeatures:\n- Manages multiple checkboxes as a single form field\n- Supports required/optional flags and error messages\n- Propagates size, tile, and inverted styling to child checkboxes\n- Keyboard and screen reader accessible via fieldset/legend",
           "name": "NysCheckboxgroup",
+          "slots": [
+            {
+              "description": "Slot for child `<nys-checkbox>` elements",
+              "name": "default"
+            },
+            {
+              "description": "Slot for custom description content",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -2392,12 +2484,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setGroupExist",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -2463,7 +2557,22 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fired when any child checkbox changes",
+              "name": "nys-change"
+            },
+            {
+              "description": "Fired when any child checkbox gains focus",
+              "name": "nys-focus"
+            },
+            {
+              "description": "Fired when any child checkbox loses focus",
+              "name": "nys-blur"
             }
           ],
           "attributes": [
@@ -2601,7 +2710,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-divider/src/index.ts",
+      "path": "packages/nys-datepicker/src/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -2609,170 +2718,806 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "packages/nys-divider/src/nys-divider"
+            "module": "packages/nys-datepicker/src/nys-datepicker"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-divider/src/nys-divider.ts",
+      "path": "packages/nys-datepicker/src/nys-datepicker.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "NysDivider",
+          "description": "`<nys-datepicker>` is a form-associated, accessible date picker component.\nOptionally wraps a `<wc-datepicker>` for custom calendar UI.\n\nEvents:",
+          "name": "NysDatepicker",
           "members": [
             {
               "kind": "field",
-              "name": "inverted",
+              "name": "id",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "inverted",
+              "default": "\"\"",
+              "attribute": "id",
               "reflects": true
-            }
-          ],
-          "attributes": [
+            },
             {
-              "name": "inverted",
+              "kind": "field",
+              "name": "name",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "inverted"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "nys-divider",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "nys-divider",
-          "declaration": {
-            "name": "NysDivider",
-            "module": "packages/nys-divider/src/nys-divider.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "NysDivider",
-          "declaration": {
-            "name": "NysDivider",
-            "module": "packages/nys-divider/src/nys-divider.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "packages/nys-errormessage/src/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "module": "packages/nys-errormessage/src/nys-errormessage"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "packages/nys-errormessage/src/nys-errormessage.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "NysErrorMessage",
-          "members": [
+              "default": "\"\"",
+              "attribute": "name",
+              "reflects": true
+            },
             {
               "kind": "field",
-              "name": "showError",
+              "name": "width",
+              "type": {
+                "text": "\"md\" | \"lg\" | \"full\""
+              },
+              "default": "\"md\"",
+              "attribute": "width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hideTodayButton",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "showError"
+              "attribute": "hideTodayButton"
             },
             {
               "kind": "field",
-              "name": "errorMessage",
+              "name": "hideClearButton",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"\"",
-              "attribute": "errorMessage"
+              "default": "false",
+              "attribute": "hideClearButton"
             },
             {
               "kind": "field",
-              "name": "showDivider",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "showDivider",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_internals",
+              "name": "required",
               "type": {
-                "text": "ElementInternals"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "default": "false",
+              "attribute": "required",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "formAssociated",
+              "name": "optional",
               "type": {
                 "text": "boolean"
               },
-              "static": true,
-              "default": "true"
-            }
-          ],
-          "attributes": [
+              "default": "false",
+              "attribute": "optional",
+              "reflects": true
+            },
             {
+              "kind": "field",
               "name": "showError",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "showError"
+              "attribute": "showError",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "errorMessage",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "errorMessage"
+              "attribute": "errorMessage"
             },
             {
-              "name": "showDivider",
+              "kind": "field",
+              "name": "form",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "default": "false",
-              "fieldName": "showDivider"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "nys-errormessage",
-          "customElement": true
+              "default": "null",
+              "attribute": "form",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "tooltip"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"date\"",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "description"
+            },
+            {
+              "kind": "field",
+              "name": "startDate",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "startDate"
+            },
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string | Date | undefined"
+              },
+              "default": "undefined",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_whenWcDatepickerReady",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<WcDatepicker | null>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setValue",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "Date | string | undefined"
+                  }
+                }
+              ],
+              "description": "Form helper methods:\n- _setValue: set internal value and trigger validation\n- _manageRequire: handle required state\n- _validate: actively validate and show errors\n- checkValidity: passive boolean check without UI\n- _setValidityMessage: sync validation message with UI and internals\n- _handleInvalid: handle form invalid event and focus first invalid field"
+            },
+            {
+              "kind": "method",
+              "name": "_manageRequire",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_validate",
+              "privacy": "private",
+              "description": "Actively validates the component:\n- Updates internal validity state\n- Updates UI (e.g. showError)\n- Called on blur/change or form submission"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Passive check of validity:\n- Returns true/false\n- Does NOT update UI or show errors\n- Used in form submission checks"
+            },
+            {
+              "kind": "method",
+              "name": "_setValidityMessage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "message",
+                  "default": "\"\"",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleInvalid",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_replaceButtonSVG",
+              "privacy": "private",
+              "description": "Replaces the default wc-datepicker month navigation buttons\nwith NYS icon components for previous and next month."
+            },
+            {
+              "kind": "method",
+              "name": "_addMonthDropdownIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_parseLocalDate",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "dateString",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleInputKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_handleBlur",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onDocumentClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_toggleDatepicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_openDatepicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleDateChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTodayClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleClearClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleInputChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_getValidDateFromInput",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_isSafari",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_isMobile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determines whether the current device uses a coarse pointer.\nA coarse pointer usually means touch-based input where precise pointing\nis not expected, such as fingers on phones and most tablets.\n\nNote: This is not a guarantee of a mobile device.\nSome non-mobile devices may also report a coarse pointer,\nand some mobile devices may not."
+            },
+            {
+              "kind": "method",
+              "name": "_shouldUseNativeDatepicker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "nys-blur",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Dispatched when input or calendar loses focus"
+            },
+            {
+              "name": "nys-input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Dispatched when user selects or types a valid date Notes: - Uses native date input on Safari or mobile devices (custom calendar removed for these scenarios)"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "id"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "name"
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "\"md\" | \"lg\" | \"full\""
+              },
+              "default": "\"md\"",
+              "fieldName": "width"
+            },
+            {
+              "name": "hideTodayButton",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hideTodayButton"
+            },
+            {
+              "name": "hideClearButton",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hideClearButton"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "optional"
+            },
+            {
+              "name": "showError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showError"
+            },
+            {
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "form",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "fieldName": "form"
+            },
+            {
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "tooltip"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"date\"",
+              "fieldName": "type"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "label"
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "description"
+            },
+            {
+              "name": "startDate",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "startDate"
+            },
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "inverted"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string | Date | undefined"
+              },
+              "default": "undefined",
+              "fieldName": "value"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-datepicker",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-datepicker",
+          "declaration": {
+            "name": "NysDatepicker",
+            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysDatepicker",
+          "declaration": {
+            "name": "NysDatepicker",
+            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "wc-datepicker",
+          "declaration": {
+            "name": "WcDatepicker",
+            "package": "wc-datepicker/dist/components/wc-datepicker"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-divider/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-divider/src/nys-divider"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-divider/src/nys-divider.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<nys-divider>` renders a horizontal rule `<hr>` element with optional styling.\nCan be inverted for dark backgrounds.",
+          "name": "NysDivider",
+          "members": [
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "inverted"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-divider",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-divider",
+          "declaration": {
+            "name": "NysDivider",
+            "module": "packages/nys-divider/src/nys-divider.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysDivider",
+          "declaration": {
+            "name": "NysDivider",
+            "module": "packages/nys-divider/src/nys-divider.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-errormessage/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-errormessage/src/nys-errormessage"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-errormessage/src/nys-errormessage.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "THIS IS A PRIVATE COMPONENT!\n`<nys-errormessage>` displays an error message for form elements.\nCan optionally show a divider and supports native form validation messages.",
+          "name": "NysErrorMessage",
+          "members": [
+            {
+              "kind": "field",
+              "name": "showError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showError"
+            },
+            {
+              "kind": "field",
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "errorMessage"
+            },
+            {
+              "kind": "field",
+              "name": "showDivider",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showDivider",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "showError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showError"
+            },
+            {
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "showDivider",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showDivider"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-errormessage",
+          "customElement": true
         }
       ],
       "exports": [
@@ -2815,8 +3560,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-fileinput>` provides accessible file selection with optional\ndrag-and-drop support, progress tracking, validation, and form submission.\n\nFeatures:\n- Supports single or multiple file uploads\n- Optional drag-and-drop dropzone\n- File type validation and upload progress\n- Form-associated with native validation behavior\n- Keyboard and screen reader accessible",
           "name": "NysFileinput",
+          "slots": [
+            {
+              "description": "Custom description content under the label",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -3040,12 +3791,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -3104,7 +3857,8 @@
                     "text": "File"
                   }
                 }
-              ]
+              ],
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -3150,7 +3904,8 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -3210,7 +3965,8 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when files are added or removed"
             }
           ],
           "attributes": [
@@ -3376,7 +4132,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-fileitem>` displays an individual file in a file input component.\nIt shows the file name, upload status, progress bar, and error messages.",
           "name": "NysFileItem",
           "members": [
             {
@@ -3563,8 +4319,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-globalfooter>` renders a New York State–style global footer.\n\nDisplays an agency name with an optional homepage link and supports\nstructured footer content via slots.",
           "name": "NysGlobalFooter",
+          "slots": [
+            {
+              "description": "Footer content such as headings, links, or groups Layout behavior: - Multiple `<h4>` elements trigger a multi-column layout - Single group content renders in a compact layout",
+              "name": "default"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -3596,7 +4358,8 @@
             {
               "kind": "method",
               "name": "_handleSlotChange",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             }
           ],
           "attributes": [
@@ -3665,8 +4428,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-globalheader>` renders a New York State–style global header.\n\nDisplays an optional application name, agency name, and homepage link.\nSupports slotted navigation content with automatic active-link detection\nand a responsive mobile menu.",
           "name": "NysGlobalHeader",
+          "slots": [
+            {
+              "description": "Primary navigation list, typically a `<ul>` with links",
+              "name": "default"
+            },
+            {
+              "description": "Optional user action elements such as login or profile Behavior: - Automatically highlights the best matching link based on the current URL - Duplicates navigation content for desktop and mobile layouts - Provides a toggleable mobile menu when navigation content exists",
+              "name": "user-actions"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -3697,16 +4470,16 @@
             },
             {
               "kind": "field",
-              "name": "slotHasContent",
+              "name": "isMobileMenuOpen",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "true"
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "isMobileMenuOpen",
+              "name": "hasLinkContent",
               "type": {
                 "text": "boolean"
               },
@@ -3715,16 +4488,35 @@
             },
             {
               "kind": "method",
-              "name": "_handleSlotChange",
+              "name": "_highlightActiveLink",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "container",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Functions\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_handleListSlotChange",
               "privacy": "private"
             },
             {
               "kind": "method",
               "name": "_normalizePath",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
               "parameters": [
                 {
-                  "name": "path",
+                  "name": "href",
                   "type": {
                     "text": "string | null"
                   }
@@ -3739,8 +4531,7 @@
             {
               "kind": "method",
               "name": "_listenLinkClicks",
-              "privacy": "private",
-              "description": "Handles client-side navigation when links are clicked (no full page refresh)."
+              "privacy": "private"
             }
           ],
           "attributes": [
@@ -3817,7 +4608,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-icon>` renders an SVG icon from the internal icon library.\n\nIcons are inline SVGs and support sizing, rotation, flipping, color,\nand accessibility labeling.",
           "name": "NysIcon",
           "members": [
             {
@@ -3881,9 +4672,10 @@
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "SVGElement | null"
+                  "text": ""
                 }
-              }
+              },
+              "description": "Retrieves the SVG element for the given icon name and applies\naccessibility, rotation, flip, color, and size classes."
             }
           ],
           "attributes": [
@@ -3984,7 +4776,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "THIS IS A PRIVATE COMPONENT!\n`NysLabel` is a component for rendering form labels with optional\ndescriptions, flags (required/optional), and tooltips.",
           "name": "NysLabel",
           "members": [
             {
@@ -4142,8 +4934,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-modal>` renders an accessible modal dialog.\n\nSupports headings, optional subheading, body content, and action buttons.\nManages focus trapping, escape key handling, and body scroll locking.",
           "name": "NysModal",
+          "slots": [
+            {
+              "description": "Modal body content",
+              "name": ""
+            },
+            {
+              "description": "Action buttons shown in the footer",
+              "name": "actions"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -4251,7 +5053,8 @@
             {
               "kind": "method",
               "name": "_hideBodyScroll",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -4320,7 +5123,8 @@
                     "text": "KeyboardEvent"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -4333,13 +5137,15 @@
               "name": "nys-open",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Emitted when the modal opens"
             },
             {
               "name": "nys-close",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Emitted when the modal closes"
             }
           ],
           "attributes": [
@@ -4440,7 +5246,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-pagination>` renders page navigation controls.\n\nDisplays previous and next buttons, page numbers, and ellipses\nwhen pages are skipped. Handles page bounds automatically.",
           "name": "NysPagination",
           "members": [
             {
@@ -4509,7 +5315,8 @@
                     "text": "number"
                   }
                 }
-              ]
+              ],
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -4527,7 +5334,8 @@
                     "text": "number"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             }
           ],
           "events": [
@@ -4535,7 +5343,8 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when the page changes detail: { page: number }"
             }
           ],
           "attributes": [
@@ -4636,8 +5445,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-radiobutton>` represents a single radio button for use in a `<nys-radiogroup>`.\n\nFeatures:\n- Single selection per group\n- Supports labels, descriptions, tile layout, inverted style, and size variants\n- Integrates with forms and dispatches `nys-change` events on selection",
           "name": "NysRadiobutton",
+          "slots": [
+            {
+              "description": "Optional description text announced to screen readers",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -4787,12 +5602,14 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -4820,19 +5637,22 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when the radio is selected or deselected detail: { id: string, checked: boolean, name: string, value: string }"
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when the radio gains focus"
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when the radio loses focus"
             }
           ],
           "attributes": [
@@ -4966,8 +5786,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-radiogroup>` groups `<nys-radiobutton>` elements into a single\nselectable control.\n\nSupports keyboard navigation, validation, and native form submission\nthrough ElementInternals.",
           "name": "NysRadiogroup",
+          "slots": [
+            {
+              "description": "One or more `<nys-radiobutton>` elements",
+              "name": "default"
+            },
+            {
+              "description": "Optional descriptive text announced to screen readers",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -5128,16 +5958,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
-            },
-            {
-              "kind": "method",
-              "name": "formResetCallback"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5181,10 +6009,15 @@
               "name": "_updateGroupTabIndex",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
             {
               "kind": "method",
               "name": "_initializeChildAttributes",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5227,7 +6060,8 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5243,6 +6077,12 @@
               ]
             }
           ],
+          "events": [
+            {
+              "description": "Fired when selection changes detail: { name: string; value: string }",
+              "name": "nys-change"
+            }
+          ],
           "attributes": [
             {
               "name": "id",
@@ -5532,8 +6372,18 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-select>` is a custom select/dropdown component.\n\nFeatures:\n- Supports slotted `<nys-option>` elements, native `<option>` and `<optgroup>`\n- Integrates with forms via ElementInternals\n- Handles validation, error messages, and required/optional states\n- Inverted style and width variants supported",
           "name": "NysSelect",
+          "slots": [
+            {
+              "description": "Optional description text announced to screen readers",
+              "name": "description"
+            },
+            {
+              "description": "Options (<nys-option>, <option>, <optgroup>) to populate the dropdown",
+              "name": "default"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -5703,11 +6553,8 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
-            },
-            {
-              "kind": "method",
-              "name": "formResetCallback"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5717,7 +6564,8 @@
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5743,6 +6591,10 @@
               "name": "_validate",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
             {
               "kind": "method",
               "name": "checkValidity",
@@ -5750,7 +6602,8 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5776,7 +6629,8 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -5794,19 +6648,22 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when the selected value changes detail: { id: string, value: string }"
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when the select gains focus"
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when the select loses focus"
             }
           ],
           "attributes": [
@@ -5971,7 +6828,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-skipnav>` provides an accessible skip navigation link for keyboard\nand screen reader users to jump directly to the main content of a page.\n\nFeatures:\n- Default target is `#main-content` if `href` is not provided\n- Link becomes visible on focus and hides on blur\n- Ensures the target element is focusable for accessibility",
           "name": "NysSkipnav",
           "members": [
             {
@@ -5996,7 +6853,8 @@
             {
               "kind": "method",
               "name": "_handleFocus",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -6236,31 +7094,240 @@
       ],
       "exports": [
         {
-          "kind": "custom-element-definition",
-          "name": "nys-step",
+          "kind": "custom-element-definition",
+          "name": "nys-step",
+          "declaration": {
+            "name": "NysStep",
+            "module": "packages/nys-stepper/src/nys-step.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysStep",
+          "declaration": {
+            "name": "NysStep",
+            "module": "packages/nys-stepper/src/nys-step.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-stepper/src/nys-stepper.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<nys-stepper>` manages a sequence of `<nys-step>` elements, providing\nmulti-step navigation for forms or workflows.\n\nFeatures:\n- Tracks selected and current steps\n- Displays a step counter (e.g., \"Step 2 of 5\")\n- Supports compact/expanded view toggle\n- Validates that only `<nys-step>` or `<div slot=\"actions\">` children are used",
+          "name": "NysStepper",
+          "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": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "counterText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"initial\"",
+              "attribute": "counterText"
+            },
+            {
+              "kind": "field",
+              "name": "isCompactExpanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "isCompactExpanded",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_stepsNumbered",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "method",
+              "name": "_validateSteps",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_validateButtonSlot",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_onStepClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_updateCounter",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_toggleCompact",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleCounterKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "description": "Fired when a step is clicked; bubbles with the event path",
+              "name": "nys-step-click"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "id"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "name"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "label"
+            },
+            {
+              "name": "counterText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"initial\"",
+              "fieldName": "counterText"
+            },
+            {
+              "name": "isCompactExpanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "isCompactExpanded"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-stepper",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-stepper",
+          "declaration": {
+            "name": "NysStepper",
+            "module": "packages/nys-stepper/src/nys-stepper.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysStepper",
           "declaration": {
-            "name": "NysStep",
-            "module": "packages/nys-stepper/src/nys-step.ts"
+            "name": "NysStepper",
+            "module": "packages/nys-stepper/src/nys-stepper.ts"
           }
-        },
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-table/src/index.ts",
+      "declarations": [],
+      "exports": [
         {
           "kind": "js",
-          "name": "NysStep",
+          "name": "*",
           "declaration": {
-            "name": "NysStep",
-            "module": "packages/nys-stepper/src/nys-step.ts"
+            "name": "*",
+            "module": "packages/nys-table/src/nys-table"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-stepper/src/nys-stepper.ts",
+      "path": "packages/nys-table/src/nys-table.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "",
-          "name": "NysStepper",
+          "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",
@@ -6284,86 +7351,174 @@
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "striped",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"\"",
-              "attribute": "label"
+              "default": "false",
+              "attribute": "striped",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "counterText",
+              "name": "sortable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"initial\"",
-              "attribute": "counterText"
+              "default": "false",
+              "attribute": "sortable",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "isCompactExpanded",
+              "name": "bordered",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "isCompactExpanded",
+              "attribute": "bordered",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_stepsNumbered",
+              "name": "download",
               "type": {
-                "text": "boolean"
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "download",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_sortColumn",
+              "type": {
+                "text": "number | null"
               },
               "privacy": "private",
-              "default": "false"
+              "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": "method",
-              "name": "_validateSteps",
-              "privacy": "private"
+              "name": "_handleSlotChange"
             },
             {
               "kind": "method",
-              "name": "_validateButtonSlot",
-              "privacy": "private",
+              "name": "_normalizeTable",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "table",
                   "type": {
-                    "text": "Event"
+                    "text": "HTMLTableElement"
                   }
                 }
               ]
             },
             {
-              "kind": "field",
-              "name": "_onStepClick",
-              "privacy": "private"
+              "kind": "method",
+              "name": "_addSortIcons",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_updateCounter",
-              "privacy": "private"
+              "name": "_updateSortIcons",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_toggleCompact",
-              "privacy": "private"
+              "name": "_onSortClick",
+              "parameters": [
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_handleCounterKeydown",
-              "privacy": "private",
+              "name": "_sortTable",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "table",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "HTMLTableElement"
+                  }
+                },
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "direction",
+                  "type": {
+                    "text": "\"asc\" | \"desc\""
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_updateSortedColumnStyles",
+              "parameters": [
+                {
+                  "name": "table",
+                  "type": {
+                    "text": "HTMLTableElement"
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "downloadFile"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fired when the download button or sortable headers are clicked.",
+              "name": "nys-click"
             }
           ],
           "attributes": [
@@ -6384,53 +7539,61 @@
               "fieldName": "name"
             },
             {
-              "name": "label",
+              "name": "striped",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"\"",
-              "fieldName": "label"
+              "default": "false",
+              "fieldName": "striped"
             },
             {
-              "name": "counterText",
+              "name": "sortable",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"initial\"",
-              "fieldName": "counterText"
+              "default": "false",
+              "fieldName": "sortable"
             },
             {
-              "name": "isCompactExpanded",
+              "name": "bordered",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "isCompactExpanded"
+              "fieldName": "bordered"
+            },
+            {
+              "name": "download",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "download"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "nys-stepper",
+          "tagName": "nys-table",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "custom-element-definition",
-          "name": "nys-stepper",
+          "name": "nys-table",
           "declaration": {
-            "name": "NysStepper",
-            "module": "packages/nys-stepper/src/nys-stepper.ts"
+            "name": "NysTable",
+            "module": "packages/nys-table/src/nys-table.ts"
           }
         },
         {
           "kind": "js",
-          "name": "NysStepper",
+          "name": "NysTable",
           "declaration": {
-            "name": "NysStepper",
-            "module": "packages/nys-stepper/src/nys-stepper.ts"
+            "name": "NysTable",
+            "module": "packages/nys-table/src/nys-table.ts"
           }
         }
       ]
@@ -6456,8 +7619,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-textarea>` is a form-enabled textarea with validation, accessibility support,\nand live error messages. Integrates with forms via ElementInternals.",
           "name": "NysTextarea",
+          "slots": [
+            {
+              "description": "Optional slot for custom description content below the label.",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -6665,16 +7834,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
-            },
-            {
-              "kind": "method",
-              "name": "formResetCallback"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -6700,6 +7867,10 @@
               "name": "_validate",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
             {
               "kind": "method",
               "name": "checkValidity",
@@ -6707,7 +7878,8 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -6733,7 +7905,8 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -6777,31 +7950,36 @@
               "name": "nys-input",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired on input, detail: `{ id, value }`"
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired on focus."
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired on blur."
             },
             {
               "name": "nys-select",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired on text selection, detail: `{ id, value }`"
             },
             {
               "name": "nys-selectionchange",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired on selection change, detail: `{ id, value }`"
             }
           ],
           "attributes": [
@@ -7006,8 +8184,22 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-textinput>` is a form-enabled text input with validation, optional\nmasking, password toggle, accessibility support, and live error messages.\nWorks with forms via ElementInternals.",
           "name": "NysTextinput",
+          "slots": [
+            {
+              "description": "Optional custom description content below the label.",
+              "name": "description"
+            },
+            {
+              "description": "Slot for a single <nys-button> at the start of the input.",
+              "name": "startButton"
+            },
+            {
+              "description": "Slot for a single <nys-button> at the end of the input.",
+              "name": "endButton"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -7269,16 +8461,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
-            },
-            {
-              "kind": "method",
-              "name": "formResetCallback"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -7304,6 +8494,10 @@
               "name": "_validate",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "formResetCallback"
+            },
             {
               "kind": "method",
               "name": "checkValidity",
@@ -7311,7 +8505,8 @@
                 "type": {
                   "text": "boolean"
                 }
-              }
+              },
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -7385,7 +8580,8 @@
                     "text": "Event"
                   }
                 }
-              ]
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -7416,19 +8612,22 @@
               "name": "nys-input",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired on input change. Detail: `{ id, value }`."
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when input receives focus."
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when input loses focus."
             }
           ],
           "attributes": [
@@ -7657,8 +8856,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-toggle>` is a form-associated toggle switch with label, description,\nsize variants, inverted styles, and optional icons. Supports keyboard\ninteraction and integrates with forms via ElementInternals.",
           "name": "NysToggle",
+          "slots": [
+            {
+              "description": "Optional slot to provide additional description below the label.",
+              "name": "description"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -7781,12 +8986,14 @@
                 "text": "boolean"
               },
               "static": true,
-              "default": "true"
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -7830,19 +9037,22 @@
               "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
-              }
+              },
+              "description": "Fired when toggle changes state. Detail: `{ id, checked }`."
             },
             {
               "name": "nys-focus",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when toggle receives focus."
             },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
-              }
+              },
+              "description": "Fired when toggle loses focus."
             }
           ],
           "attributes": [
@@ -7983,7 +9193,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-tooltip>` is a custom tooltip component for NYS design system elements.\nIt supports dynamic positioning, screen-reader accessibility, keyboard interaction,\nand viewport overflow handling.\n\nThe tooltip automatically positions itself relative to a target element specified\nvia the `for` attribute, but can also respect a user-defined position.",
           "name": "NysTooltip",
           "members": [
             {
@@ -8087,7 +9297,8 @@
             {
               "kind": "field",
               "name": "_showTooltip",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "field",
@@ -8135,7 +9346,8 @@
             {
               "kind": "method",
               "name": "_getReferenceElement",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
@@ -8276,6 +9488,16 @@
               ]
             }
           ],
+          "events": [
+            {
+              "description": "Dispatched when the reference element receives focus (via keyboard or programmatically).",
+              "name": "nys-focus"
+            },
+            {
+              "description": "Dispatched when the reference element loses focus or mouse leaves the tooltip. Notes: - Tooltip visibility is automatically managed on hover/focus of the reference element. - The component adjusts position dynamically to prevent overflow off-screen. - Supports keyboard dismissal with the Escape key.",
+              "name": "nys-blur"
+            }
+          ],
           "attributes": [
             {
               "name": "id",
@@ -8362,13 +9584,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-unavfooter>` is a footer component for New York State websites.\nIt displays the official NYS logo linking to ny.gov and a set of primary navigation links.\n\nFeatures:\n- Renders the NYS logo as an inline SVG linking to https://www.ny.gov\n- Provides key navigation links",
           "name": "NysUnavFooter",
           "members": [
             {
               "kind": "method",
               "name": "_getNysLogo",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             }
           ],
           "superclass": {
@@ -8419,7 +9642,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "",
+          "description": "`<nys-unavheader>` is a universal header for New York State websites.\n\nFeatures:\n- Trust bar indicating official NYS site status, with expandable details\n- NYS logo linking to the homepage\n- Search bar with dropdown behavior for mobile and desktop\n- Language translation dropdown supporting multiple languages\n- Accessible interactions with ARIA attributes and keyboard handling",
           "name": "NysUnavHeader",
           "members": [
             {
@@ -8490,7 +9713,8 @@
             {
               "kind": "method",
               "name": "_getNysLogo",
-              "privacy": "private"
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",