@nysds/components 1.20.0-alpha-2 → 1.20.0-alpha-3

package/custom-elements.json

@@ -6289,7 +6289,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A file input for uploading files with support for multiple files, drag-and-drop, and progress tracking.\nValidates file types via magic bytes (not just extension). Form-associated via ElementInternals.\n\nUse for document uploads, image uploads, or any file submission. Enable `dropzone` for drag-and-drop UI.",
+          "description": "A file input for uploading files with support for multiple files, drag-and-drop, and progress tracking.\nValidates file types via magic bytes (not just extension). Form-associated via ElementInternals.\n\nUse for document uploads, image uploads, or any file submission. Enable `dropzone` for drag-and-drop UI.\n\nRead or write the current selection via the `files` (`File[]`) and `value` (`File | null`)\nproperties — useful for rehydrating state or binding from a framework form model.\nSetting them is silent (does not emit `nys-change`).",
           "name": "NysFileinput",
           "slots": [
             {
@@ -6485,6 +6485,41 @@
               "privacy": "private",
               "default": "[]"
             },
+            {
+              "kind": "field",
+              "name": "files",
+              "type": {
+                "text": "File[]"
+              },
+              "description": "The currently selected files. Read to get the current selection; set to\nreplace it (e.g. rehydrating state after navigation, or binding from a\nframework form model). Property-only — a `File[]` cannot round-trip through\nan HTML attribute. Setting this is silent (does not emit `nys-change`),\nmatching native input behavior and avoiding feedback loops in two-way bindings."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "File | null"
+              },
+              "description": "Single-file convenience accessor (parity with `nys-textinput`'s `value`).\nReads the first selected file (or `null`); setting replaces the selection."
+            },
+            {
+              "kind": "method",
+              "name": "setFiles",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "incoming",
+                  "type": {
+                    "text": "File[]"
+                  }
+                }
+              ],
+              "description": "Programmatically set the selection and await async validation/processing.\nSame as assigning `files`, but resolves once every file has finished its\nmagic-byte validation and read — use when you need to read `checkValidity()`\nor the settled selection immediately after."
+            },
             {
               "kind": "field",
               "name": "_dragActive",
@@ -6632,6 +6667,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_handleBlur",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_dispatchChangeEvent",
@@ -6720,6 +6768,13 @@
             }
           ],
           "events": [
+            {
+              "name": "nys-blur",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when focus leaves the component. Triggers validation."
+            },
             {
               "name": "nys-change",
               "type": {
@@ -7295,6 +7350,10 @@
             {
               "description": "Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.",
               "name": ""
+            },
+            {
+              "description": "User-account controls (e.g. profile link, settings, log-out button) shown in the header.",
+              "name": "user-actions"
             }
           ],
           "members": [
@@ -7335,7 +7394,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Toggles the NYS brand mark",
+              "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
               "attribute": "nysLogo"
             },
             {
@@ -7463,7 +7522,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Toggles the NYS brand mark",
+              "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
               "fieldName": "nysLogo",
               "propName": "nyslogo"
             }
@@ -7524,7 +7583,7 @@
               }
             }
           ],
-          "description": "Clear one URL entry, or all cached icons (URL and inline) when no URL is given."
+          "description": "Clear one or all entries from the cache."
         },
         {
           "kind": "function",
@@ -7543,24 +7602,6 @@
             }
           ],
           "description": "Fetch and parse an SVG from a URL. Returns a cloned SVGElement (safe for multiple consumers)."
-        },
-        {
-          "kind": "function",
-          "name": "parseIcon",
-          "return": {
-            "type": {
-              "text": "SVGElement"
-            }
-          },
-          "parameters": [
-            {
-              "name": "source",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Parse an inline SVG source string. Results are cached by source content,\nso repeated renders of the same icon sanitize/parse once. Returns a\ncloned SVGElement (safe for multiple consumers)."
         }
       ],
       "exports": [
@@ -7579,14 +7620,6 @@
             "name": "fetchIcon",
             "module": "packages/nys-icon/src/icon-cache.ts"
           }
-        },
-        {
-          "kind": "js",
-          "name": "parseIcon",
-          "declaration": {
-            "name": "parseIcon",
-            "module": "packages/nys-icon/src/icon-cache.ts"
-          }
         }
       ]
     },
@@ -7634,7 +7667,7 @@
               }
             }
           ],
-          "description": "Register or replace a named icon library. All watching icons using this library will redraw.\n\nIntended for custom/external libraries — the standard NYSDS set is\nbuilt in and needs no registration. Registering under `\"default\"`\nreplaces the built-in set (escape hatch).",
+          "description": "Register or replace a named icon library. All watching icons using this library will redraw.",
           "examples": [
             {
               "title": "Register a Font Awesome library with a custom resolver:",
@@ -7774,14 +7807,6 @@
             "module": "./icon-cache"
           }
         },
-        {
-          "kind": "js",
-          "name": "getIconLibrary",
-          "declaration": {
-            "name": "getIconLibrary",
-            "module": "./icon-library-registry"
-          }
-        },
         {
           "kind": "js",
           "name": "IconLibrary",
@@ -7790,14 +7815,6 @@
             "module": "./icon-library-registry"
           }
         },
-        {
-          "kind": "js",
-          "name": "IconResolution",
-          "declaration": {
-            "name": "IconResolution",
-            "module": "./icon-library-registry"
-          }
-        },
         {
           "kind": "js",
           "name": "registerIconLibrary",

package/dist/.vscode/vscode.html-custom-data.json

@@ -767,7 +767,7 @@
     },
     {
       "name": "nys-fileinput",
-      "description": "File input with drag-and-drop, validation, and progress tracking.\n---\n\n\n### **Events:**\n - **nys-change** - Fired when files are added or removed. Detail: `{id, files}`.\n\n### **Slots:**\n - **description** - Custom HTML description content.",
+      "description": "File input with drag-and-drop, validation, and progress tracking.\n---\n\n\n### **Events:**\n - **nys-blur** - Fired when focus leaves the component. Triggers validation.\n- **nys-change** - Fired when files are added or removed. Detail: `{id, files}`.\n\n### **Methods:**\n - **setFiles(incoming: _File[]_): _Promise<void>_** - Programmatically set the selection and await async validation/processing.\nSame as assigning `files`, but resolves once every file has finished its\nmagic-byte validation and read — use when you need to read `checkValidity()`\nor the settled selection immediately after.\n\n### **Slots:**\n - **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "id",
@@ -905,7 +905,7 @@
     },
     {
       "name": "nys-globalheader",
-      "description": "Agency header with navigation, mobile menu, and active link highlighting.\n---\n\n\n### **Slots:**\n - _default_ - Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.",
+      "description": "Agency header with navigation, mobile menu, and active link highlighting.\n---\n\n\n### **Slots:**\n - _default_ - Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.\n- **user-actions** - User-account controls (e.g. profile link, settings, log-out button) shown in the header.",
       "attributes": [
         {
           "name": "appName",
@@ -924,7 +924,7 @@
         },
         {
           "name": "nysLogo",
-          "description": "Toggles the NYS brand mark",
+          "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
           "values": []
         }
       ],

package/dist/custom-elements.json

@@ -6289,7 +6289,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A file input for uploading files with support for multiple files, drag-and-drop, and progress tracking.\nValidates file types via magic bytes (not just extension). Form-associated via ElementInternals.\n\nUse for document uploads, image uploads, or any file submission. Enable `dropzone` for drag-and-drop UI.",
+          "description": "A file input for uploading files with support for multiple files, drag-and-drop, and progress tracking.\nValidates file types via magic bytes (not just extension). Form-associated via ElementInternals.\n\nUse for document uploads, image uploads, or any file submission. Enable `dropzone` for drag-and-drop UI.\n\nRead or write the current selection via the `files` (`File[]`) and `value` (`File | null`)\nproperties — useful for rehydrating state or binding from a framework form model.\nSetting them is silent (does not emit `nys-change`).",
           "name": "NysFileinput",
           "slots": [
             {
@@ -6485,6 +6485,41 @@
               "privacy": "private",
               "default": "[]"
             },
+            {
+              "kind": "field",
+              "name": "files",
+              "type": {
+                "text": "File[]"
+              },
+              "description": "The currently selected files. Read to get the current selection; set to\nreplace it (e.g. rehydrating state after navigation, or binding from a\nframework form model). Property-only — a `File[]` cannot round-trip through\nan HTML attribute. Setting this is silent (does not emit `nys-change`),\nmatching native input behavior and avoiding feedback loops in two-way bindings."
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "File | null"
+              },
+              "description": "Single-file convenience accessor (parity with `nys-textinput`'s `value`).\nReads the first selected file (or `null`); setting replaces the selection."
+            },
+            {
+              "kind": "method",
+              "name": "setFiles",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "incoming",
+                  "type": {
+                    "text": "File[]"
+                  }
+                }
+              ],
+              "description": "Programmatically set the selection and await async validation/processing.\nSame as assigning `files`, but resolves once every file has finished its\nmagic-byte validation and read — use when you need to read `checkValidity()`\nor the settled selection immediately after."
+            },
             {
               "kind": "field",
               "name": "_dragActive",
@@ -6632,6 +6667,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_handleBlur",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_dispatchChangeEvent",
@@ -6720,6 +6768,13 @@
             }
           ],
           "events": [
+            {
+              "name": "nys-blur",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when focus leaves the component. Triggers validation."
+            },
             {
               "name": "nys-change",
               "type": {
@@ -7295,6 +7350,10 @@
             {
               "description": "Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.",
               "name": ""
+            },
+            {
+              "description": "User-account controls (e.g. profile link, settings, log-out button) shown in the header.",
+              "name": "user-actions"
             }
           ],
           "members": [
@@ -7335,7 +7394,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Toggles the NYS brand mark",
+              "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
               "attribute": "nysLogo"
             },
             {
@@ -7463,7 +7522,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Toggles the NYS brand mark",
+              "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
               "fieldName": "nysLogo",
               "propName": "nyslogo"
             }
@@ -7524,7 +7583,7 @@
               }
             }
           ],
-          "description": "Clear one URL entry, or all cached icons (URL and inline) when no URL is given."
+          "description": "Clear one or all entries from the cache."
         },
         {
           "kind": "function",
@@ -7543,24 +7602,6 @@
             }
           ],
           "description": "Fetch and parse an SVG from a URL. Returns a cloned SVGElement (safe for multiple consumers)."
-        },
-        {
-          "kind": "function",
-          "name": "parseIcon",
-          "return": {
-            "type": {
-              "text": "SVGElement"
-            }
-          },
-          "parameters": [
-            {
-              "name": "source",
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Parse an inline SVG source string. Results are cached by source content,\nso repeated renders of the same icon sanitize/parse once. Returns a\ncloned SVGElement (safe for multiple consumers)."
         }
       ],
       "exports": [
@@ -7579,14 +7620,6 @@
             "name": "fetchIcon",
             "module": "packages/nys-icon/src/icon-cache.ts"
           }
-        },
-        {
-          "kind": "js",
-          "name": "parseIcon",
-          "declaration": {
-            "name": "parseIcon",
-            "module": "packages/nys-icon/src/icon-cache.ts"
-          }
         }
       ]
     },
@@ -7634,7 +7667,7 @@
               }
             }
           ],
-          "description": "Register or replace a named icon library. All watching icons using this library will redraw.\n\nIntended for custom/external libraries — the standard NYSDS set is\nbuilt in and needs no registration. Registering under `\"default\"`\nreplaces the built-in set (escape hatch).",
+          "description": "Register or replace a named icon library. All watching icons using this library will redraw.",
           "examples": [
             {
               "title": "Register a Font Awesome library with a custom resolver:",
@@ -7774,14 +7807,6 @@
             "module": "./icon-cache"
           }
         },
-        {
-          "kind": "js",
-          "name": "getIconLibrary",
-          "declaration": {
-            "name": "getIconLibrary",
-            "module": "./icon-library-registry"
-          }
-        },
         {
           "kind": "js",
           "name": "IconLibrary",
@@ -7790,14 +7815,6 @@
             "module": "./icon-library-registry"
           }
         },
-        {
-          "kind": "js",
-          "name": "IconResolution",
-          "declaration": {
-            "name": "IconResolution",
-            "module": "./icon-library-registry"
-          }
-        },
         {
           "kind": "js",
           "name": "registerIconLibrary",