@nysds/mcp-server 1.21.0 → 1.21.1

package/data/cem/custom-elements.json

@@ -1939,6 +1939,11 @@
               "privacy": "private",
               "description": "Functions\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "field",
+              "name": "_boundDisabledClickGuard",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_getSlottedOl",
@@ -1957,7 +1962,15 @@
                 "type": {
                   "text": "HTMLLIElement[]"
                 }
-              }
+              },
+              "parameters": [
+                {
+                  "name": "ol",
+                  "type": {
+                    "text": "HTMLOListElement"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -1997,7 +2010,57 @@
             },
             {
               "kind": "method",
-              "name": "_createBackToParentElement",
+              "name": "_createIcon",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "size",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_resetItem",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "li",
+                  "type": {
+                    "text": "HTMLLIElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_applyDisabledState",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "a",
+                  "type": {
+                    "text": "HTMLAnchorElement"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_applyBackToParentStyle",
               "privacy": "private",
               "parameters": [
                 {
@@ -2010,7 +2073,7 @@
             },
             {
               "kind": "method",
-              "name": "_createCrumbElement",
+              "name": "_applyCrumbStyle",
               "privacy": "private",
               "parameters": [
                 {
@@ -2027,6 +2090,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_insertEllipsis",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "referenceLi",
+                  "type": {
+                    "text": "HTMLLIElement"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_handleSlotChange",
@@ -3047,6 +3123,38 @@
               "description": "Height of the card. Set to `100%` to stretch the card to its container's height, so a row of cards renders at an equal height. The extra height is absorbed by the main content area, keeping the `footer` slot pinned to the bottom of the card. Requires the container to give the card a height to fill (e.g. a grid column with `nys-display-flex`).",
               "name": "--nys-card-height",
               "default": "fit-content"
+            },
+            {
+              "description": "Font size of the preheading text.",
+              "name": "--nys-card-font-size--preheading"
+            },
+            {
+              "description": "Font size of the heading text.",
+              "name": "--nys-card-font-size--heading"
+            },
+            {
+              "description": "Font size of the subheading text.",
+              "name": "--nys-card-font-size--subheading"
+            },
+            {
+              "description": "Font size of the description text.",
+              "name": "--nys-card-font-size--description"
+            },
+            {
+              "description": "Line height of the preheading text.",
+              "name": "--nys-card-line-height--preheading"
+            },
+            {
+              "description": "Line height of the heading text.",
+              "name": "--nys-card-line-height--heading"
+            },
+            {
+              "description": "Line height of the subheading text.",
+              "name": "--nys-card-line-height--subheading"
+            },
+            {
+              "description": "Line height of the description text.",
+              "name": "--nys-card-line-height--description"
             }
           ],
           "slots": [
@@ -3083,6 +3191,17 @@
               "attribute": "id",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "\"sm\" | \"md\" | \"lg\""
+              },
+              "default": "\"md\"",
+              "description": "The size of the text content within a card (preheading, heading, subheading, and description).",
+              "attribute": "size",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "preheading",
@@ -3357,6 +3476,16 @@
               "fieldName": "id",
               "propName": "id"
             },
+            {
+              "name": "size",
+              "type": {
+                "text": "\"sm\" | \"md\" | \"lg\""
+              },
+              "default": "\"md\"",
+              "description": "The size of the text content within a card (preheading, heading, subheading, and description).",
+              "fieldName": "size",
+              "propName": "size"
+            },
             {
               "name": "preheading",
               "type": {
@@ -3476,6 +3605,21 @@
               "code": "<div class=\"nys-tablet:nys-grid-col-6 nys-desktop:nys-grid-col-3\">\n<nys-card\nheading=\"Heading\"\nsubheading=\"Subheading\"\ndescription=\"A short description of the card's subject.\"\n></nys-card>\n</div>",
               "lang": "html"
             },
+            {
+              "title": "Size SM",
+              "code": "<div class=\"nys-tablet:nys-grid-col-6 nys-desktop:nys-grid-col-3\">\n<nys-card\nsize=\"sm\"\npreheading=\"Preheading\"\nheading=\"Heading\"\nsubheading=\"Subheading\"\ndescription=\"A short description of the card's subject.\"\n></nys-card>\n</div>",
+              "lang": "html"
+            },
+            {
+              "title": "Size MD (default)",
+              "code": "<div class=\"nys-tablet:nys-grid-col-6 nys-desktop:nys-grid-col-3\">\n<nys-card\nsize=\"md\"\npreheading=\"Preheading\"\nheading=\"Heading\"\nsubheading=\"Subheading\"\ndescription=\"A short description of the card's subject.\"\n></nys-card>\n</div>",
+              "lang": "html"
+            },
+            {
+              "title": "Size LG",
+              "code": "<div class=\"nys-tablet:nys-grid-col-6 nys-desktop:nys-grid-col-3\">\n<nys-card\nsize=\"lg\"\npreheading=\"Preheading\"\nheading=\"Heading\"\nsubheading=\"Subheading\"\ndescription=\"A short description of the card's subject.\"\n></nys-card>\n</div>",
+              "lang": "html"
+            },
             {
               "title": "Media",
               "code": "<div class=\"nys-tablet:nys-grid-col-6 nys-desktop:nys-grid-col-3\">\n<nys-card\nheading=\"Heading\"\ndescription=\"A card with a media image.\"\n>\n<img slot=\"media\"\nsrc=\"https://images.unsplash.com/photo-1513360371669-4adf3dd7dff8?q=80&w=2070&auto=format&fit=crop\"\nrole=\"presentation\"\n/>\n</nys-card>\n</div>",
@@ -8584,7 +8728,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Agency-branded header with app/agency name, navigation, and responsive mobile menu.\n\nPlace below `nys-unavheader`. Slot navigation links as `<ul><li><a>` elements; active links\nare auto-highlighted based on current URL, unless you set `aria-current` on a link\nyourself — then the header leaves the current-page state entirely to you, which is\nwhat apps that don't route on the pathname (hash-routed SPAs, for example) need.\nMobile menu toggles automatically on narrow screens.",
+          "description": "Agency-branded header with app/agency name, navigation, and responsive mobile menu.\n\nPlace below `nys-unavheader`. Slot navigation links as `<ul><li><a>` elements; active links\nare auto-highlighted based on current URL. Mobile menu toggles automatically on narrow screens.",
           "name": "NysGlobalHeader",
           "slots": [
             {
@@ -8597,17 +8741,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "id",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Unique identifier. Auto-generated if not provided.",
-              "attribute": "id",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "appName",
@@ -8694,19 +8827,30 @@
               "privacy": "private",
               "description": "Watches for the viewport growing past the mobile breakpoint. The menu and its\ntoggle are `display: none` there, so an open menu that survived a resize would\nleave the focus trap guarding elements nobody can reach."
             },
+            {
+              "kind": "field",
+              "name": "_navSlot",
+              "type": {
+                "text": "HTMLSlotElement | null"
+              },
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------",
+              "readonly": true
+            },
             {
               "kind": "method",
-              "name": "_highlightActiveLink",
+              "name": "_getAssignedLinks",
               "privacy": "private",
-              "parameters": [
-                {
-                  "name": "container",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
+              "return": {
+                "type": {
+                  "text": "HTMLAnchorElement[]"
                 }
-              ],
-              "description": "Functions\n--------------------------------------------------------------------------"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_highlightActiveLink",
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -8731,6 +8875,23 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_setMobileMenuOpen",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "open",
+                  "type": {
+                    "text": "boolean"
+                  }
+                },
+                {
+                  "name": "restoreFocus",
+                  "default": "false"
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_toggleMobileMenu",
@@ -8743,30 +8904,8 @@
                 "text": "HTMLElement | null"
               },
               "privacy": "private",
-              "description": "The toggle, which is both the trap's first stop and where focus returns.",
               "readonly": true
             },
-            {
-              "kind": "field",
-              "name": "_mobileNav",
-              "type": {
-                "text": "HTMLElement | null"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "_closeMobileMenu",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "restoreFocus",
-                  "default": "false"
-                }
-              ],
-              "description": "Closes the mobile menu.\n\n`restoreFocus` moves focus back to the toggle, which is required whenever the\nmenu is dismissed by keyboard: the closed menu is `display: none`, so focus\nsitting on one of its links would otherwise be dropped to the top of the\ndocument (WCAG 2.4.3 Focus Order). A click outside is a pointer gesture that\nlands somewhere the user chose, so that path leaves focus alone."
-            },
             {
               "kind": "method",
               "name": "_focusableMenuElements",
@@ -8795,7 +8934,7 @@
                   }
                 }
               ],
-              "description": "The focused element, but only when it is one of the menu's own stops.\n\n`document.activeElement` reports the host for anything focused inside this\nshadow root, so the shadow root's own `activeElement` is what identifies the\nreal stop."
+              "description": "The focused element, but only when it is one of the menu's own stops.\n\n`document.activeElement` reports the host for anything focused inside this\nshadow root (the toggle button) or the links in the lightDOM."
             },
             {
               "kind": "method",
@@ -8813,7 +8952,33 @@
             },
             {
               "kind": "method",
-              "name": "_listenLinkClicks",
+              "name": "_renderBrandMark",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_getNysLogo",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_boundClickOutside",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_boundLinkClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_boundBreakpointChange",
+              "privacy": "private",
+              "description": "Growing past the mobile breakpoint takes the menu off the page, so drop the\nopen state with it. No focus restore: the toggle is gone too, and the resize\nwas not a dismissal the user aimed at anything."
+            },
+            {
+              "kind": "field",
+              "name": "_boundKeyDown",
               "privacy": "private"
             },
             {
@@ -8845,51 +9010,9 @@
               "privacy": "private",
               "description": "Literal name for the banner: the author's override, or the \"Site\" default when\nthere is no visible title to reference. Undefined whenever `_bannerLabelledBy`\nhas something to point at, so the landmark never carries both.",
               "readonly": true
-            },
-            {
-              "kind": "method",
-              "name": "_renderNameContainer",
-              "privacy": "private",
-              "description": "App/agency title block. Rendered on its own so the linked and unlinked\nvariants cannot drift apart — the ids here are what names the banner."
-            },
-            {
-              "kind": "method",
-              "name": "_renderBrandMark",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_getNysLogo",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_boundClickOutside",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "_boundBreakpointChange",
-              "privacy": "private",
-              "description": "Growing past the mobile breakpoint takes the menu off the page, so drop the\nopen state with it. No focus restore: the toggle is gone too, and the resize\nwas not a dismissal the user aimed at anything."
-            },
-            {
-              "kind": "field",
-              "name": "_boundKeyDown",
-              "privacy": "private"
             }
           ],
           "attributes": [
-            {
-              "name": "id",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Unique identifier. Auto-generated if not provided.",
-              "fieldName": "id",
-              "propName": "id"
-            },
             {
               "name": "appName",
               "type": {
@@ -8974,14 +9097,9 @@
               "code": "<nys-globalheader agencyName=\"Office of Information Technology Services\">\n<ul>\n<li><a href=\"https://its.ny.gov/services\">Services</a></li>\n<li><a href=\"https://its.ny.gov/get-help\">Help Center</a></li>\n<li><a href=\"https://its.ny.gov/cybersecurity\">Cybersecurity</a></li>\n<li><a href=\"https://its.ny.gov/policies\">Policies and Laws</a></li>\n<li><a href=\"https://its.ny.gov/procurement\">Procurement</a></li>\n<li><a href=\"https://its.ny.gov/about-us\">About Us</a></li>\n</ul>\n</nys-globalheader>",
               "lang": "html"
             },
-            {
-              "title": "Author-controlled active link",
-              "code": "<!-- Set aria-current yourself and the header stops guessing from the URL. -->\n<nys-globalheader agencyName=\"Office of Information Technology Services\">\n<ul>\n<li><a href=\"#/services\">Services</a></li>\n<li><a href=\"#/help\" aria-current=\"page\">Help Center</a></li>\n</ul>\n</nys-globalheader>",
-              "lang": "html"
-            },
             {
               "title": "User Actions",
-              "code": "<nys-globalheader agencyName=\"Office of Information Technology Services\">\n<nys-button slot=\"user-actions\" label=\"Log out\">\n<nys-avatar\nslot=\"prefix-icon\"\nariaLabel=\"User avatar\"\ninitials=\"NY\"\n></nys-avatar>\n</nys-button>\n</nys-globalheader>\n<nys-dropdownmenu id=\"dropdownmenu\" for=\"my-action-slot\">\n<nys-dropdownmenuitem label=\"Profile\" href=\"/profile\"></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Repositories & Github Pages\" href=\"/repos\"></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Organizations\" href=\"/organizations\" disabled></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Sign out\" href=\"/logout\"></nys-dropdownmenuitem>\n</nys-dropdownmenu>",
+              "code": "<nys-globalheader agencyName=\"Office of Information Technology Services\">\n<nys-button id=\"my-action-slot\" slot=\"user-actions\" label=\"Log out\">\n<nys-avatar\nslot=\"prefix-icon\"\nariaLabel=\"User avatar\"\ninitials=\"NY\"\n></nys-avatar>\n</nys-button>\n</nys-globalheader>\n<nys-dropdownmenu id=\"dropdownmenu\" for=\"my-action-slot\">\n<nys-dropdownmenuitem label=\"Profile\" href=\"/profile\"></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Repositories & Github Pages\" href=\"/repos\"></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Organizations\" href=\"/organizations\" disabled></nys-dropdownmenuitem>\n<nys-dropdownmenuitem label=\"Sign out\" href=\"/logout\"></nys-dropdownmenuitem>\n</nys-dropdownmenu>",
               "lang": "html"
             },
             {
@@ -9688,11 +9806,22 @@
               "attribute": "divider",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds.",
+              "attribute": "inverted",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "_childObserver",
               "privacy": "private",
-              "default": "new MutationObserver(() => this._syncDividers())"
+              "default": "new MutationObserver(() => { this._syncDividers(); this._syncInverted(); })"
             },
             {
               "kind": "field",
@@ -9700,6 +9829,11 @@
               "privacy": "private",
               "default": "new WeakSet<Element>()"
             },
+            {
+              "kind": "method",
+              "name": "_syncInverted",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_syncDividers",
@@ -9726,6 +9860,16 @@
               "description": "Draws a divider between items. No divider is drawn after the last item.",
               "fieldName": "divider",
               "propName": "divider"
+            },
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds.",
+              "fieldName": "inverted",
+              "propName": "inverted"
             }
           ],
           "superclass": {
@@ -9734,7 +9878,7 @@
           },
           "tagName": "nys-iconlist",
           "customElement": true,
-          "summary": "A scannable list of icon + text items, with an optional divider between rows.",
+          "summary": "A scannable list of icon + text items.",
           "examples": [
             {
               "title": "Basic",
@@ -9756,6 +9900,11 @@
               "code": "<nys-iconlist id=\"event-details3\">\n<nys-iconlistitem icon=\"calendar_month\">July 4, 2026</nys-iconlistitem>\n<nys-iconlistitem icon=\"schedule\">\n5:00 PM\n<span slot=\"secondary\">Eastern Standard Time</span>\n</nys-iconlistitem>\n<nys-iconlistitem icon=\"location_on\">\nCentral Park West\n<span slot=\"secondary\">New York, NY</span>\n</nys-iconlistitem>\n</nys-iconlist>",
               "lang": "html"
             },
+            {
+              "title": "Inverted",
+              "code": "<nys-iconlist id=\"demo-inverted\" divider inverted>\n<nys-iconlistitem icon=\"calendar_month\">July 4, 2026</nys-iconlistitem>\n<nys-iconlistitem icon=\"schedule\">\n5:00 PM\n<span slot=\"secondary\">Eastern Standard Time</span>\n</nys-iconlistitem>\n<nys-iconlistitem icon=\"location_on\">\nCentral Park West\n<span slot=\"secondary\">New York, NY</span>\n</nys-iconlistitem>\n</nys-iconlist>",
+              "lang": "html"
+            },
             {
               "title": "Checklist",
               "code": "<nys-iconlist id=\"requirements\">\n<nys-iconlistitem icon=\"check_circle\">Recent pay stubs</nys-iconlistitem>\n<nys-iconlistitem icon=\"check_circle\">Current rent/mortgage statement</nys-iconlistitem>\n<nys-iconlistitem icon=\"check_circle\">Current property tax bill</nys-iconlistitem>\n<nys-iconlistitem icon=\"check_circle\">Current homeowner's insurance bill</nys-iconlistitem>\n<nys-iconlistitem icon=\"check_circle\">Social Security card</nys-iconlistitem>\n</nys-iconlist>",
@@ -9823,6 +9972,17 @@
               "attribute": "divider",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds. Set by the parent `<nys-iconlist inverted>`; not intended to be\nset directly.",
+              "attribute": "inverted",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "_handleSecondarySlotChange",
@@ -9857,6 +10017,16 @@
               "description": "Draws a rule below the item. Set by the parent `<nys-iconlist divider>`; not intended to be\nset directly.",
               "fieldName": "divider",
               "propName": "divider"
+            },
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds. Set by the parent `<nys-iconlist inverted>`; not intended to be\nset directly.",
+              "fieldName": "inverted",
+              "propName": "inverted"
             }
           ],
           "superclass": {

package/data/tokens/tokens.css

@@ -1,5 +1,5 @@
 /*!
- * New York State Design System v1.21.0
+ * New York State Design System v1.21.1
  * Description: A design system for New York State's digital products.
  * Repository: https://github.com/its-hcd/nysds
  * License: MIT

package/dist/lib/framework-snippets.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Framework snippet generation
+ *
+ * Turns a component's canonical HTML examples into React and Angular
+ * snippets using `@nysds/codegen`'s `transformExample` — the same
+ * transformer the docs site and Storybook autodocs use, so an AI assistant
+ * asking the MCP server sees exactly the same code a developer sees on
+ * designsystem.ny.gov.
+ */
+import { type CEMExample, type CEMFormControl } from "./cem-parser.js";
+export type FrameworkFilter = "html" | "react" | "angular";
+export interface FrameworkSnippet {
+    code: string;
+    imports: string[];
+    warnings: string[];
+    unsupported: boolean;
+}
+export interface ExampleWithSnippets {
+    title: string;
+    html: string;
+    react: FrameworkSnippet;
+    angular: FrameworkSnippet;
+}
+/**
+ * Builds React and Angular snippets for every HTML example on a component.
+ *
+ * When `framework` names one target explicitly, that framework's snippet
+ * uses its most idiomatic forms binding for a form-control component —
+ * React's controlled pattern (`value` + `onNys*`), Angular's
+ * `formControlName` (Reactive Forms). The unrequested framework, and every
+ * snippet when `framework` is `"html"` (the default), stays a plain
+ * attribute-for-attribute conversion so the default response isn't
+ * surprising.
+ */
+export declare function buildExampleSnippets(examples: CEMExample[] | undefined, framework: FrameworkFilter, formControl: CEMFormControl | undefined): ExampleWithSnippets[];
+//# sourceMappingURL=framework-snippets.d.ts.map

package/dist/lib/framework-snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-snippets.d.ts","sourceRoot":"","sources":["../../src/lib/framework-snippets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/E,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,UAAU,EAAE,GAAG,SAAS,EAClC,SAAS,EAAE,eAAe,EAC1B,WAAW,EAAE,cAAc,GAAG,SAAS,GACtC,mBAAmB,EAAE,CA+BvB"}

package/dist/lib/framework-snippets.js

@@ -0,0 +1,55 @@
+/**
+ * Framework snippet generation
+ *
+ * Turns a component's canonical HTML examples into React and Angular
+ * snippets using `@nysds/codegen`'s `transformExample` — the same
+ * transformer the docs site and Storybook autodocs use, so an AI assistant
+ * asking the MCP server sees exactly the same code a developer sees on
+ * designsystem.ny.gov.
+ */
+import { transformExample, } from "@nysds/codegen";
+import { getCEM } from "./cem-parser.js";
+function toSnippet(result) {
+    return {
+        code: result.code,
+        imports: result.imports,
+        warnings: result.warnings,
+        unsupported: result.unsupported,
+    };
+}
+/**
+ * Builds React and Angular snippets for every HTML example on a component.
+ *
+ * When `framework` names one target explicitly, that framework's snippet
+ * uses its most idiomatic forms binding for a form-control component —
+ * React's controlled pattern (`value` + `onNys*`), Angular's
+ * `formControlName` (Reactive Forms). The unrequested framework, and every
+ * snippet when `framework` is `"html"` (the default), stays a plain
+ * attribute-for-attribute conversion so the default response isn't
+ * surprising.
+ */
+export function buildExampleSnippets(examples, framework, formControl) {
+    if (!examples || examples.length === 0)
+        return [];
+    const manifest = getCEM();
+    const reactFormsMode = framework === "react" && formControl ? "template" : "none";
+    const angularFormsMode = framework === "angular" && formControl ? "reactive" : "none";
+    return examples
+        .filter((example) => !example.lang || example.lang === "html")
+        .map((example) => ({
+        title: example.title,
+        html: example.code,
+        react: toSnippet(transformExample({
+            html: example.code,
+            framework: "react",
+            manifest,
+            formsMode: reactFormsMode,
+        })),
+        angular: toSnippet(transformExample({
+            html: example.code,
+            framework: "angular",
+            manifest,
+            formsMode: angularFormsMode,
+        })),
+    }));
+}

package/dist/lib/framework-usage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Framework usage notes
+ *
+ * Short, framework-specific guidance attached to `get_component` responses
+ * when the caller asks for `framework: "react"` or `"angular"` — the import
+ * line, the event-prop naming rule, and (when the component is a form
+ * control) how it binds into that framework's forms. Naming follows the
+ * rules in `.claude/plans/framework-support/README.md` section 4.1, reused
+ * here via `@nysds/codegen` rather than re-derived.
+ */
+import type { CEMFormControl } from "./cem-parser.js";
+export interface FrameworkUsageNotes {
+    package: string;
+    import: string;
+    events: string;
+    forms?: string;
+}
+export declare function buildReactUsageNotes(tagName: string, className: string, formControl: CEMFormControl | undefined): FrameworkUsageNotes;
+export declare function buildAngularUsageNotes(tagName: string, className: string, formControl: CEMFormControl | undefined): FrameworkUsageNotes;
+//# sourceMappingURL=framework-usage.d.ts.map

package/dist/lib/framework-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-usage.d.ts","sourceRoot":"","sources":["../../src/lib/framework-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,cAAc,GAAG,SAAS,GACtC,mBAAmB,CAqBrB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,cAAc,GAAG,SAAS,GACtC,mBAAmB,CAmBrB"}

package/dist/lib/framework-usage.js

@@ -0,0 +1,50 @@
+/**
+ * Framework usage notes
+ *
+ * Short, framework-specific guidance attached to `get_component` responses
+ * when the caller asks for `framework: "react"` or `"angular"` — the import
+ * line, the event-prop naming rule, and (when the component is a form
+ * control) how it binds into that framework's forms. Naming follows the
+ * rules in `.claude/plans/framework-support/README.md` section 4.1, reused
+ * here via `@nysds/codegen` rather than re-derived.
+ */
+import { eventToAngularOutput, eventToReactProp, tagToSubpath, } from "@nysds/codegen";
+const FORM_CONTROL_LABEL = {
+    value: "value",
+    checked: "checked state",
+    files: "selected files",
+};
+export function buildReactUsageNotes(tagName, className, formControl) {
+    const subpath = tagToSubpath(tagName);
+    const changeProp = formControl
+        ? eventToReactProp(formControl.changeEvent)
+        : undefined;
+    const inputProp = formControl?.inputEvent !== undefined
+        ? eventToReactProp(formControl.inputEvent)
+        : undefined;
+    return {
+        package: "@nysds/react",
+        import: `import { ${className} } from "@nysds/react/${subpath}";`,
+        events: "Events map to onNys* props (nys-change -> onNysChange). The handler receives the typed CustomEvent, so e.detail autocompletes.",
+        forms: formControl
+            ? `Form control (${formControl.kind}). For a controlled component, bind ${formControl.kind} and update state from ${changeProp}${inputProp ? ` (or ${inputProp} for every keystroke)` : ""}; re-rendering with the same ${FORM_CONTROL_LABEL[formControl.kind]} snaps the element back to your state. See get_guide({ topic: "installation", framework: "react" }) for React Hook Form and uncontrolled-form patterns.`
+            : undefined,
+    };
+}
+export function buildAngularUsageNotes(tagName, className, formControl) {
+    const subpath = tagToSubpath(tagName);
+    const angularClass = `${className}Component`;
+    const changeOutput = formControl
+        ? eventToAngularOutput(formControl.changeEvent)
+        : undefined;
+    return {
+        package: "@nysds/angular",
+        import: `import { ${angularClass} } from "@nysds/angular/${subpath}";`,
+        events: `Events map to camelCase outputs (nys-change -> (nysChange)); event.detail is typed.${changeOutput
+            ? ` This component's change output is (${changeOutput}).`
+            : ""}`,
+        forms: formControl
+            ? 'Implements ControlValueAccessor: works with [(ngModel)], formControlName (Reactive Forms), and Signal Forms [formField] with no CUSTOM_ELEMENTS_SCHEMA. Add the nysControlErrors directive to let Angular own validation display instead of the component\'s own errorMessage/showError. See get_guide({ topic: "installation", framework: "angular" }).'
+            : undefined,
+    };
+}

package/dist/lib/frameworks-data.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Framework package index
+ *
+ * Reads `data/frameworks.json`, written by `scripts/sync-guides.mjs` from
+ * `packages/react/package.json` and `packages/angular/package.json`. Gives
+ * tools and resources the published package name and version without
+ * hand-maintaining either.
+ */
+export interface FrameworkPackageInfo {
+    packageName: string;
+    version: string;
+}
+export interface FrameworksIndex {
+    react: FrameworkPackageInfo;
+    angular: FrameworkPackageInfo;
+}
+export declare function getFrameworksIndex(): FrameworksIndex;
+//# sourceMappingURL=frameworks-data.d.ts.map

package/dist/lib/frameworks-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks-data.d.ts","sourceRoot":"","sources":["../../src/lib/frameworks-data.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAiBD,wBAAgB,kBAAkB,IAAI,eAAe,CAcpD"}

package/dist/lib/frameworks-data.js

@@ -0,0 +1,39 @@
+/**
+ * Framework package index
+ *
+ * Reads `data/frameworks.json`, written by `scripts/sync-guides.mjs` from
+ * `packages/react/package.json` and `packages/angular/package.json`. Gives
+ * tools and resources the published package name and version without
+ * hand-maintaining either.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cached = null;
+function getFrameworksDataPath() {
+    const candidates = [
+        resolve(__dirname, "../../data/frameworks.json"),
+        resolve(process.cwd(), "data/frameworks.json"),
+    ];
+    for (const path of candidates) {
+        if (existsSync(path))
+            return path;
+    }
+    throw new Error(`data/frameworks.json not found. Searched paths:\n${candidates.join("\n")}`);
+}
+export function getFrameworksIndex() {
+    if (cached)
+        return cached;
+    try {
+        cached = JSON.parse(readFileSync(getFrameworksDataPath(), "utf-8"));
+    }
+    catch (error) {
+        console.error("Warning: Could not load data/frameworks.json:", error);
+        cached = {
+            react: { packageName: "@nysds/react", version: "unknown" },
+            angular: { packageName: "@nysds/angular", version: "unknown" },
+        };
+    }
+    return cached;
+}

package/dist/resources/frameworks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Framework Resources
+ *
+ * MCP resources for NYSDS framework packages (@nysds/react, @nysds/angular).
+ *
+ * Resources:
+ * - nysds://frameworks - Index of framework packages with version and guide URI
+ * - nysds://frameworks/react - @nysds/react guide (synced from its README)
+ * - nysds://frameworks/angular - @nysds/angular guide (synced from its README)
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFrameworkResources(server: McpServer): void;
+//# sourceMappingURL=frameworks.d.ts.map

package/dist/resources/frameworks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks.d.ts","sourceRoot":"","sources":["../../src/resources/frameworks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8ElE"}

package/dist/resources/frameworks.js

@@ -0,0 +1,83 @@
+/**
+ * Framework Resources
+ *
+ * MCP resources for NYSDS framework packages (@nysds/react, @nysds/angular).
+ *
+ * Resources:
+ * - nysds://frameworks - Index of framework packages with version and guide URI
+ * - nysds://frameworks/react - @nysds/react guide (synced from its README)
+ * - nysds://frameworks/angular - @nysds/angular guide (synced from its README)
+ */
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { getFrameworksIndex } from "../lib/frameworks-data.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const GUIDES_DIR = join(__dirname, "../../data/guides/frameworks");
+function loadFrameworkGuide(framework) {
+    try {
+        return readFileSync(join(GUIDES_DIR, `${framework}.md`), "utf-8");
+    }
+    catch {
+        return `Framework guide not found: ${framework}. Run "npm run sync:guides -w @nysds/mcp-server".`;
+    }
+}
+export function registerFrameworkResources(server) {
+    // nysds://frameworks - Index of framework packages
+    server.resource("frameworks", "nysds://frameworks", {
+        description: "Index of NYSDS framework packages (@nysds/react, @nysds/angular) with their published version and guide resource URI",
+        mimeType: "application/json",
+    }, async () => {
+        const index = getFrameworksIndex();
+        const list = [
+            {
+                id: "react",
+                packageName: index.react.packageName,
+                version: index.react.version,
+                guideUri: "nysds://frameworks/react",
+            },
+            {
+                id: "angular",
+                packageName: index.angular.packageName,
+                version: index.angular.version,
+                guideUri: "nysds://frameworks/angular",
+            },
+        ];
+        return {
+            contents: [
+                {
+                    uri: "nysds://frameworks",
+                    mimeType: "application/json",
+                    text: JSON.stringify(list, null, 2),
+                },
+            ],
+        };
+    });
+    // nysds://frameworks/react - @nysds/react guide
+    server.resource("frameworks-react", "nysds://frameworks/react", {
+        description: "@nysds/react install, usage, forms, SSR, and troubleshooting guide",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: "nysds://frameworks/react",
+                mimeType: "text/markdown",
+                text: loadFrameworkGuide("react"),
+            },
+        ],
+    }));
+    // nysds://frameworks/angular - @nysds/angular guide
+    server.resource("frameworks-angular", "nysds://frameworks/angular", {
+        description: "@nysds/angular install, usage, forms, SSR, and troubleshooting guide",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: "nysds://frameworks/angular",
+                mimeType: "text/markdown",
+                text: loadFrameworkGuide("angular"),
+            },
+        ],
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nysds/mcp-server",
-  "version": "1.21.0",
+  "version": "1.21.1",
   "description": "MCP server for the New York State Design System. Exposes components, tokens, and documentation to AI assistants.",
   "type": "module",
   "bin": {
@@ -30,8 +30,8 @@
     "zod": "^3.25"
   },
   "devDependencies": {
-    "@nysds/styles": "^1.21.0",
-    "@nysds/tokens": "^1.21.0",
+    "@nysds/styles": "^1.21.1",
+    "@nysds/tokens": "^1.21.1",
     "@types/node": "^22.0.0",
     "typescript": "^5.9.3"
   },