@nysds/components 1.19.3-alpha-1 → 1.20.0-alpha1

package/dist/custom-elements.json

@@ -2227,6 +2227,15 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "_hasCircleSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "formAssociated",
@@ -2269,6 +2278,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_onCircleSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_manageFormAction",
@@ -3486,15 +3508,6 @@
               "privacy": "private",
               "default": "null"
             },
-            {
-              "kind": "field",
-              "name": "_hasSharedNames",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false"
-            },
             {
               "kind": "field",
               "name": "_internals",
@@ -3639,25 +3652,6 @@
                   }
                 }
               ]
-            },
-            {
-              "kind": "method",
-              "name": "_checkSharedNames",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "checkboxes",
-                  "type": {
-                    "text": "NysCheckbox[]"
-                  }
-                }
-              ],
-              "description": "Drupal-like naming support *"
             }
           ],
           "attributes": [
@@ -14583,6 +14577,396 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-verticalnav/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-verticalnav/src/nys-verticalnav"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-verticalnav/src/nys-verticalnavgroup"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-verticalnav/src/nys-verticalnav.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Vertical navigation component with responsive desktop/mobile behavior.\n\nRenders as a side vertical navigation with heading and slotted link list on desktop. On tablet/mobile\nit collapses into a `<nys-accordion>`. The default slot accepts a\n`<ul>` of links; subheader `<li>` items (containing `<h2>`-`<h6>`). Use the `header` slot to replace the\nauto-generated heading, and the `footer` slot for metadata or extra actions\nbelow the link list.",
+          "name": "NysVerticalnav",
+          "members": [
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "id",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "header",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Page navigation\"",
+              "attribute": "header",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hideHeader",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "hideHeader",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "headerLevel",
+              "type": {
+                "text": "HeaderLevel"
+              },
+              "default": "\"h2\"",
+              "attribute": "headerLevel",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_isMobile",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_mediaQuery",
+              "type": {
+                "text": "MediaQueryList | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_handleResize",
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_applyActiveState",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderHeader",
+              "privacy": "private",
+              "description": "Helper Render Functions\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "renderContentDesktop",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderContentMobile",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "id",
+              "propName": "id"
+            },
+            {
+              "name": "header",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Page navigation\"",
+              "fieldName": "header",
+              "propName": "header"
+            },
+            {
+              "name": "hideHeader",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hideHeader",
+              "propName": "hideheader"
+            },
+            {
+              "name": "headerLevel",
+              "type": {
+                "text": "HeaderLevel"
+              },
+              "default": "\"h2\"",
+              "fieldName": "headerLevel",
+              "propName": "headerlevel"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-verticalnav",
+          "customElement": true,
+          "summary": "Responsive vertical navigation — nav on desktop, accordion on mobile.",
+          "examples": [
+            {
+              "title": "Basic usage",
+              "code": "<nys-verticalnav header=\"Freshwater Fishing\" headerLevel=\"h2\">\n<ul>\n<li><a href=\"/\">Home</a></li>\n<li><a href=\"/services\">Services</a></li>\n<li>\n<h3>Freshwater Fishing Regulations</h3>\n<ul>\n<li><a href=\"\">Places to Fish</a></li>\n<li><a href=\"\">Learn to Fish</a></li>\n<li><a href=\"\">Ice Fishing</a></li>\n</ul>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With custom header slot",
+              "code": "<nys-verticalnav header=\"Freshwater Fishing\" headerLevel=\"h2\">\n<div slot=\"header\">\n<h2>Freshwater Fishing</h2>\n<p>2026 Season Open</p>\n</div>\n<ul>\n<li><a href=\"/\">Home</a></li>\n<li><a href=\"/services\">Services</a></li>\n<li>\n<h3>Freshwater Fishing Regulations</h3>\n<ul>\n<li><a href=\"\">Places to Fish</a></li>\n<li><a href=\"\">Learn to Fish</a></li>\n<li><a href=\"\">Ice Fishing</a></li>\n</ul>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With footer slot",
+              "code": "<nys-verticalnav header=\"Freshwater Fishing\" headerLevel=\"h2\">\n<ul>\n<li><a href=\"/\">Home</a></li>\n<li><a href=\"/services\">Services</a></li>\n<li>\n<h3>Freshwater Fishing Regulations</h3>\n<ul>\n<li><a href=\"\">Places to Fish</a></li>\n<li><a href=\"\">Learn to Fish</a></li>\n<li><a href=\"\">Ice Fishing</a></li>\n</ul>\n</li>\n</ul>\n<div slot=\"footer\">\n<nys-divider></nys-divider>\n<p>Regulations last updated: January 2026</p>\n<a href=\"/contact-dec\">Contact the DEC for fishing inquiries</a>\n</div>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With dropdown group",
+              "code": "<nys-verticalnav header=\"NYS Design System\" headerLevel=\"h2\">\n<ul>\n<li><a href=\"/\">Foundations</a></li>\n<li><a href=\"/components\">Components</a></li>\n<li>\n<nys-verticalnavgroup label=\"Accessibility\">\n<ul>\n <li><a href=\"\">WCAG Guidelines</a></li>\n <li><a href=\"\">Screen Readers</a></li>\n <li><a href=\"\">Color Contrast</a></li>\n</ul>\n</nys-verticalnavgroup>\n</li>\n<li>\n<h3>Resources</h3>\n<ul>\n<li><a href=\"\">Design Tokens</a></li>\n<li><a href=\"\">Utilities</a></li>\n</ul>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With active link (aria-current=\"page\")",
+              "code": "<nys-verticalnav header=\"NYS Design System\" headerLevel=\"h2\">\n<ul>\n<li><a href=\"/\">Foundations</a></li>\n<li><a href=\"/components\">Components</a></li>\n<li>\n<nys-verticalnavgroup label=\"Accessibility\">\n<ul>\n <li><a aria-current=\"page\" href=\"\">WCAG Guidelines</a></li>\n <li><a href=\"\">Screen Readers</a></li>\n <li><a href=\"\">Color Contrast</a></li>\n</ul>\n</nys-verticalnavgroup>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With disabled links and group",
+              "code": "<nys-verticalnav header=\"NYS Design System\" headerLevel=\"h2\">\n<ul>\n<li><a href=\"/\">Foundations</a></li>\n<li>\n<nys-verticalnavgroup disabled label=\"Accessibility\">\n<ul>\n <li><a aria-disabled=\"true\">WCAG Guidelines</a></li>\n <li><a href=\"\">Screen Readers</a></li>\n</ul>\n</nys-verticalnavgroup>\n</li>\n<li>\n<h3>Resources</h3>\n<ul>\n<li><a aria-disabled=\"true\">Design Tokens</a></li>\n<li><a href=\"\">Utilities</a></li>\n</ul>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "Hidden header (aria-label used instead)",
+              "code": "<nys-verticalnav header=\"Section nav\" hideHeader>\n<ul>\n<li><a href=\"/home\">Home</a></li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-verticalnav",
+          "declaration": {
+            "name": "NysVerticalnav",
+            "module": "packages/nys-verticalnav/src/nys-verticalnav.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysVerticalnav",
+          "declaration": {
+            "name": "NysVerticalnav",
+            "module": "packages/nys-verticalnav/src/nys-verticalnav.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-verticalnav/src/nys-verticalnavgroup.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Collapsible dropdown group for use inside `<nys-verticalnav>`.\n\nRenders a toggle button and an expandable panel for a nested `<ul>` of links.\nDesigned to be placed as a direct child of a `<li>` inside the vertical nav's\ndefault slot. Use `expanded` to open it by default, and `disabled` to prevent\ninteraction. Set `aria-current=\"page\"` on an `<a>` inside to automatically\nexpand the group and apply the active state.",
+          "name": "NysVerticalnavGroup",
+          "members": [
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "id",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "expanded",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "active",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "_toggle",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "nys-child-resize",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "id",
+              "propName": "id"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "label",
+              "propName": "label"
+            },
+            {
+              "name": "expanded",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "expanded",
+              "propName": "expanded"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled",
+              "propName": "disabled"
+            },
+            {
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "active",
+              "propName": "active"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-verticalnavgroup",
+          "customElement": true,
+          "summary": "Collapsible link group for use within `<nys-verticalnav>`.",
+          "examples": [
+            {
+              "title": "Basic usage",
+              "code": "<nys-verticalnav header=\"NYS Design System\">\n<ul>\n<li><a href=\"/foundations\">Foundations</a></li>\n<li>\n<nys-verticalnavgroup label=\"Accessibility\">\n<ul>\n <li><a href=\"\">WCAG Guidelines</a></li>\n <li><a href=\"\">Screen Readers</a></li>\n <li><a href=\"\">Color Contrast</a></li>\n</ul>\n</nys-verticalnavgroup>\n</li>\n</ul>\n</nys-verticalnav>",
+              "lang": "html"
+            },
+            {
+              "title": "With active link — group auto-expands",
+              "code": "<nys-verticalnavgroup label=\"Accessibility\">\n<ul>\n<li><a aria-current=\"page\" href=\"\">WCAG Guidelines</a></li>\n<li><a href=\"\">Screen Readers</a></li>\n<li><a href=\"\">Color Contrast</a></li>\n</ul>\n</nys-verticalnavgroup>",
+              "lang": "html"
+            },
+            {
+              "title": "Expanded by default",
+              "code": "<nys-verticalnavgroup label=\"Resources\" expanded>\n<ul>\n<li><a href=\"\">Design Tokens</a></li>\n<li><a href=\"\">Utilities</a></li>\n</ul>\n</nys-verticalnavgroup>",
+              "lang": "html"
+            },
+            {
+              "title": "Disabled group with disabled links",
+              "code": "<nys-verticalnavgroup disabled label=\"Accessibility\">\n<ul>\n<li><a aria-disabled=\"true\">WCAG Guidelines</a></li>\n<li><a href=\"\">Screen Readers</a></li>\n<li><a href=\"\">Color Contrast</a></li>\n</ul>\n</nys-verticalnavgroup>",
+              "lang": "html"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-verticalnavgroup",
+          "declaration": {
+            "name": "NysVerticalnavGroup",
+            "module": "packages/nys-verticalnav/src/nys-verticalnavgroup.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysVerticalnavGroup",
+          "declaration": {
+            "name": "NysVerticalnavGroup",
+            "module": "packages/nys-verticalnav/src/nys-verticalnavgroup.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "packages/nys-video/src/index.ts",