@nysds/components 1.13.1 → 1.14.0

package/custom-elements.json

@@ -33,6 +33,20 @@
           "kind": "class",
           "description": "A container for grouping `nys-accordionitem` components with coordinated expand/collapse behavior.\n\nPlace `nys-accordionitem` elements as children. Set `singleSelect` to allow only one item open at a time.\nThe `bordered` style propagates to all children automatically.",
           "name": "NysAccordion",
+          "cssProperties": [
+            {
+              "description": "Background color of the accordion header.",
+              "name": "--nys-accordion-background-color--header"
+            },
+            {
+              "description": "Background hover color of the accordion header.",
+              "name": "--nys-accordion-background-color--header--hover"
+            },
+            {
+              "description": "Maximum readable width of accordion content. Defaults to a character-based width (80ch) for readability.",
+              "name": "--nys-accordion-content-max-width"
+            }
+          ],
           "slots": [
             {
               "description": "Default slot for `nys-accordionitem` elements.",
@@ -2194,6 +2208,39 @@
               "attribute": "size",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "other",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showOtherError"
+            },
+            {
+              "kind": "field",
+              "name": "isMobile",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "method",
               "name": "getInputElement",
@@ -2285,6 +2332,16 @@
               "name": "_manageLabelClick",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_hasDescription",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_handleResize",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
@@ -2314,6 +2371,11 @@
               "name": "_handleBlur",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_handleTextInputBlur",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleKeydown",
@@ -2326,6 +2388,29 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInput",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_validateOtherAndEmitError",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchClearError",
+              "privacy": "private"
             }
           ],
           "events": [
@@ -2349,6 +2434,18 @@
                 "text": "Event"
               },
               "description": "Fired when checkbox loses focus."
+            },
+            {
+              "name": "nys-error",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "nys-error-clear",
+              "type": {
+                "text": "CustomEvent"
+              }
             }
           ],
           "attributes": [
@@ -2495,6 +2592,22 @@
               "default": "\"md\"",
               "description": "Checkbox size: `sm` (24px) or `md` (32px, default).",
               "fieldName": "size"
+            },
+            {
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "other"
+            },
+            {
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showOtherError"
             }
           ],
           "superclass": {
@@ -2692,6 +2805,24 @@
               "privacy": "private",
               "default": "\"\""
             },
+            {
+              "kind": "field",
+              "name": "_hasOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_otherErrorCheckbox",
+              "type": {
+                "text": "NysCheckbox | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_internals",
@@ -2712,10 +2843,15 @@
             },
             {
               "kind": "method",
-              "name": "_setGroupExist",
+              "name": "_hasAtLeastOneChecked",
               "privacy": "private",
               "description": "Functions\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_setGroupExist",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_setupCheckboxRequired",
@@ -2726,6 +2862,11 @@
               "name": "_manageRequire",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_setCustomOtherError",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_updateCheckboxSize",
@@ -2787,6 +2928,45 @@
                 }
               ],
               "description": "Event Handlers\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildError",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildErrorClear",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_checkOtherInputs",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "checkboxes",
+                  "type": {
+                    "text": "NysCheckbox[]"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -2957,7 +3137,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<nys-datepicker>` is a form-associated, accessible date picker component.\nOptionally wraps a `<wc-datepicker>` for custom calendar UI.\n\nEvents:",
+          "description": "Date picker with calendar popup and form validation. Falls back to native date input\non Safari and mobile.",
           "name": "NysDatepicker",
           "members": [
             {
@@ -2967,6 +3147,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Unique identifier. Auto-generated if not provided.",
               "attribute": "id",
               "reflects": true
             },
@@ -2977,6 +3158,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Name for form submission.",
               "attribute": "name",
               "reflects": true
             },
@@ -2987,6 +3169,7 @@
                 "text": "\"md\" | \"lg\" | \"full\""
               },
               "default": "\"md\"",
+              "description": "Input width: `md` (200px), `lg` (384px), `full` (100%).",
               "attribute": "width",
               "reflects": true
             },
@@ -2997,6 +3180,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Hide the \"Today\" button in calendar popup.",
               "attribute": "hideTodayButton"
             },
             {
@@ -3006,6 +3190,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Hide the \"Clear\" button in calendar popup.",
               "attribute": "hideClearButton"
             },
             {
@@ -3015,6 +3200,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disable interaction.",
               "attribute": "disabled",
               "reflects": true
             },
@@ -3025,6 +3211,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Mark as required. Shows \"Required\" flag and validates on blur.",
               "attribute": "required",
               "reflects": true
             },
@@ -3035,6 +3222,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show \"Optional\" flag. Use when most fields are required.",
               "attribute": "optional",
               "reflects": true
             },
@@ -3045,6 +3233,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show error state.",
               "attribute": "showError",
               "reflects": true
             },
@@ -3055,6 +3244,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Error message text.",
               "attribute": "errorMessage"
             },
             {
@@ -3064,6 +3254,7 @@
                 "text": "string | null"
               },
               "default": "null",
+              "description": "Form `id` to associate with when input is outside form.",
               "attribute": "form",
               "reflects": true
             },
@@ -3074,6 +3265,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Tooltip text on info icon hover.",
               "attribute": "tooltip"
             },
             {
@@ -3083,6 +3275,7 @@
                 "text": "string"
               },
               "default": "\"date\"",
+              "description": "Input type. Currently only supports `date`.",
               "attribute": "type"
             },
             {
@@ -3092,6 +3285,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Label text. Required for accessibility.",
               "attribute": "label"
             },
             {
@@ -3101,6 +3295,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Helper text below label.",
               "attribute": "description"
             },
             {
@@ -3110,6 +3305,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Initial date when calendar opens (YYYY-MM-DD).",
               "attribute": "startDate"
             },
             {
@@ -3119,6 +3315,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Dark background mode.",
               "attribute": "inverted",
               "reflects": true
             },
@@ -3129,8 +3326,18 @@
                 "text": "string | Date | undefined"
               },
               "default": "undefined",
+              "description": "Selected date. Accepts Date object or ISO string (YYYY-MM-DD).",
               "attribute": "value"
             },
+            {
+              "kind": "field",
+              "name": "datepickerIsOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "_hasUserInteracted",
@@ -3254,6 +3461,22 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_setTodayDate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_setFocusOnTodayDate",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "visualFocusOnly",
+                  "default": "false"
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_handleInputKeydown",
@@ -3286,6 +3509,11 @@
               "name": "_onDocumentClick",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_onKeydownEsc",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_toggleDatepicker",
@@ -3342,6 +3570,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_handleFocusTrap",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_isSafari",
@@ -3380,14 +3621,14 @@
               "type": {
                 "text": "Event"
               },
-              "description": "Dispatched when input or calendar loses focus"
+              "description": "Fired when input or calendar loses focus. Triggers validation."
             },
             {
               "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)"
+              "description": "Fired on date selection. Detail: `{id, value}`."
             }
           ],
           "attributes": [
@@ -3397,6 +3638,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Unique identifier. Auto-generated if not provided.",
               "fieldName": "id"
             },
             {
@@ -3405,6 +3647,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Name for form submission.",
               "fieldName": "name"
             },
             {
@@ -3413,6 +3656,7 @@
                 "text": "\"md\" | \"lg\" | \"full\""
               },
               "default": "\"md\"",
+              "description": "Input width: `md` (200px), `lg` (384px), `full` (100%).",
               "fieldName": "width"
             },
             {
@@ -3421,6 +3665,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Hide the \"Today\" button in calendar popup.",
               "fieldName": "hideTodayButton"
             },
             {
@@ -3429,6 +3674,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Hide the \"Clear\" button in calendar popup.",
               "fieldName": "hideClearButton"
             },
             {
@@ -3437,6 +3683,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Disable interaction.",
               "fieldName": "disabled"
             },
             {
@@ -3445,6 +3692,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Mark as required. Shows \"Required\" flag and validates on blur.",
               "fieldName": "required"
             },
             {
@@ -3453,6 +3701,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show \"Optional\" flag. Use when most fields are required.",
               "fieldName": "optional"
             },
             {
@@ -3461,6 +3710,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Show error state.",
               "fieldName": "showError"
             },
             {
@@ -3469,6 +3719,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Error message text.",
               "fieldName": "errorMessage"
             },
             {
@@ -3477,6 +3728,7 @@
                 "text": "string | null"
               },
               "default": "null",
+              "description": "Form `id` to associate with when input is outside form.",
               "fieldName": "form"
             },
             {
@@ -3485,6 +3737,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Tooltip text on info icon hover.",
               "fieldName": "tooltip"
             },
             {
@@ -3493,6 +3746,7 @@
                 "text": "string"
               },
               "default": "\"date\"",
+              "description": "Input type. Currently only supports `date`.",
               "fieldName": "type"
             },
             {
@@ -3501,6 +3755,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Label text. Required for accessibility.",
               "fieldName": "label"
             },
             {
@@ -3509,6 +3764,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Helper text below label.",
               "fieldName": "description"
             },
             {
@@ -3517,6 +3773,7 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "Initial date when calendar opens (YYYY-MM-DD).",
               "fieldName": "startDate"
             },
             {
@@ -3525,6 +3782,7 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Dark background mode.",
               "fieldName": "inverted"
             },
             {
@@ -3533,6 +3791,7 @@
                 "text": "string | Date | undefined"
               },
               "default": "undefined",
+              "description": "Selected date. Accepts Date object or ISO string (YYYY-MM-DD).",
               "fieldName": "value"
             }
           ],
@@ -3541,7 +3800,8 @@
             "package": "lit"
           },
           "tagName": "nys-datepicker",
-          "customElement": true
+          "customElement": true,
+          "summary": "Date picker with calendar popup and native fallback."
         }
       ],
       "exports": [
@@ -5163,6 +5423,20 @@
               },
               "privacy": "private",
               "default": "\"\""
+            },
+            {
+              "kind": "method",
+              "name": "_handleLabelClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             }
           ],
           "attributes": [
@@ -5939,6 +6213,39 @@
               "attribute": "tile",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "other",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showOtherError"
+            },
+            {
+              "kind": "field",
+              "name": "isMobile",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "buttonGroup",
@@ -5964,6 +6271,16 @@
               "name": "formResetUpdate",
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "_handleResize",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_clearOtherState",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
@@ -5978,7 +6295,15 @@
             {
               "kind": "method",
               "name": "_handleFocus",
-              "privacy": "private"
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -5989,9 +6314,51 @@
               "kind": "method",
               "name": "_callInputHandling",
               "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInput",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInputBlur",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_validateOtherAndEmitError",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleOtherKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
             }
           ],
           "events": [
+            {
+              "name": "nys-error-clear",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "nys-change",
               "type": {
@@ -6012,6 +6379,12 @@
                 "text": "Event"
               },
               "description": "Fired when radio loses focus."
+            },
+            {
+              "name": "nys-error",
+              "type": {
+                "text": "CustomEvent"
+              }
             }
           ],
           "attributes": [
@@ -6122,6 +6495,22 @@
               "default": "false",
               "description": "Renders as tile with larger clickable area.",
               "fieldName": "tile"
+            },
+            {
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "other"
+            },
+            {
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showOtherError"
             }
           ],
           "superclass": {
@@ -6461,6 +6850,19 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildError",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -8879,6 +9281,16 @@
               "description": "Maximum character length.",
               "attribute": "maxlength"
             },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible label. When set, assuming \"label\" isn't provided for private special cases (i.e., <checkbox other>).",
+              "attribute": "ariaLabel"
+            },
             {
               "kind": "field",
               "name": "width",
@@ -9006,6 +9418,11 @@
               "default": "true",
               "description": "Lifecycle methods\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "focus",
+              "privacy": "public"
+            },
             {
               "kind": "method",
               "name": "_setValue",
@@ -9309,6 +9726,15 @@
               "description": "Maximum character length.",
               "fieldName": "maxlength"
             },
+            {
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible label. When set, assuming \"label\" isn't provided for private special cases (i.e., <checkbox other>).",
+              "fieldName": "ariaLabel"
+            },
             {
               "name": "width",
               "type": {