@sankhyatronics/sankhya-cms 0.1.5 → 0.1.6

package/custom-elements.json

@@ -255,7 +255,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Cycles through its slotted children, one visible at a time, with optional autoplay, arrows and\ndot indicators. The incoming slide slides in from the travel direction (CSS keyframes in place\nof the source's framer-motion spring), or fades in with `transition=\"fade\"`. Autoplay pauses\nwhile hovered or focused and stops when the element is disconnected; a paused slide keeps the\ntime it had left.\n\n`indicator-style=\"tabs\"` replaces the dots with a row of labelled tabs along the bottom, each\nwith a progress bar that fills while its slide is showing, plus a pause button — the tabbed hero\ncarousel layout (put `st-hero`s in it). Tab labels come from `tab-labels`, else each slide's\n`data-tab-label` attribute, else its `title`.",
+          "description": "Cycles through its slotted children, one visible at a time, with optional autoplay, arrows and\ndot indicators. The incoming slide slides in from the travel direction (CSS keyframes in place\nof the source's framer-motion spring), or fades in with `transition=\"fade\"`. Autoplay pauses\nwhile hovered (unless `pause-on-hover` is turned off, e.g. for a full-screen hero the pointer\nnearly always rests on) or focused, and stops when the element is disconnected; a paused slide\nkeeps the time it had left.\n\n`indicator-style=\"tabs\"` replaces the dots with a row of labelled tabs along the bottom, each\nwith a progress bar that fills while its slide is showing, plus a pause button — the tabbed hero\ncarousel layout (put `st-hero`s in it). Tab labels come from `tab-labels`, else each slide's\n`data-tab-label` attribute, else its `title`.",
           "name": "Carousel",
           "cssProperties": [
             {
@@ -301,6 +301,16 @@
               "description": "Autoplay delay in milliseconds.",
               "attribute": "interval"
             },
+            {
+              "kind": "field",
+              "name": "pauseOnHover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Pause autoplay while the pointer is over the carousel. Turn off for a hero that fills the\nscreen; the tabs' pause button and keyboard focus still pause it.",
+              "attribute": "pause-on-hover"
+            },
             {
               "kind": "field",
               "name": "showArrows",
@@ -452,6 +462,11 @@
               "name": "pause",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "pauseOnEnter",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "resume",
@@ -584,6 +599,15 @@
               "description": "Autoplay delay in milliseconds.",
               "fieldName": "interval"
             },
+            {
+              "name": "pause-on-hover",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Pause autoplay while the pointer is over the carousel. Turn off for a hero that fills the\nscreen; the tabs' pause button and keyboard focus still pause it.",
+              "fieldName": "pauseOnHover"
+            },
             {
               "name": "show-arrows",
               "type": {
@@ -646,192 +670,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/content-block/ContentBlock.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "A long-form article section: centered title/subtitle, an optional featured image with caption,\r\nthen Markdown body text. Ports `SankhyaUI`'s React `ContentBlock`. The body comes from\r\n`content-src` (a Markdown URL, as in the source) or an inline `content` string (added so the\r\nblock works without a fetch); `content-src` wins when both are set.",
-          "name": "ContentBlock",
-          "cssProperties": [
-            {
-              "description": "Overrides the block's padding.",
-              "name": "--st-content-block-padding"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "title"
-            },
-            {
-              "kind": "field",
-              "name": "subtitle",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "subtitle"
-            },
-            {
-              "kind": "field",
-              "name": "contentSrc",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "URL of a Markdown file.",
-              "attribute": "content-src"
-            },
-            {
-              "kind": "field",
-              "name": "content",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Inline Markdown, used when `content-src` is not set.",
-              "attribute": "content"
-            },
-            {
-              "kind": "field",
-              "name": "imageSrc",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "image-src"
-            },
-            {
-              "kind": "field",
-              "name": "imageAlt",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "image-alt"
-            },
-            {
-              "kind": "field",
-              "name": "imageCaption",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "attribute": "image-caption"
-            },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "inverted",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "title"
-            },
-            {
-              "name": "subtitle",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "subtitle"
-            },
-            {
-              "name": "content-src",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "URL of a Markdown file.",
-              "fieldName": "contentSrc"
-            },
-            {
-              "name": "content",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Inline Markdown, used when `content-src` is not set.",
-              "fieldName": "content"
-            },
-            {
-              "name": "image-src",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "imageSrc"
-            },
-            {
-              "name": "image-alt",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "imageAlt"
-            },
-            {
-              "name": "image-caption",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "fieldName": "imageCaption"
-            },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "inverted"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "st-content-block",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "ContentBlock",
-          "declaration": {
-            "name": "ContentBlock",
-            "module": "src/content-block/ContentBlock.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "st-content-block",
-          "declaration": {
-            "name": "ContentBlock",
-            "module": "src/content-block/ContentBlock.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/cookie-consent/CookieConsent.ts",
@@ -1023,74 +861,260 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/dropdown/Dropdown.ts",
+      "path": "src/content-block/ContentBlock.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A labeled trigger + slotted dropdown panel — nav menus (typically holding an `st-menu-grid`),\r\naction menus, anything \"click a trigger, show content under it\". A 1:1 port of `SankhyaUI`'s\r\nReact `Dropdown` (`SankhyaCMS/SankhyaUI/src/components/Dropdown`): same markup\r\n(`.menu` > `.menu-title` + `.menu-dropdown`), sizes, 0.3s slide/fade, and behavior —\r\n\r\n- only one dropdown is open at a time (the source's `DropdownProvider`, built in here, so no\r\n  provider element is needed);\r\n- a mousedown outside, Escape, or a click inside the panel closes it;\r\n- an `href` trigger toggles the panel when it has content, and is a plain link when it doesn't;\r\n- `inline` opens the panel in the flow, the source's `.touch-device` layout.\r\n\r\nColors and the panel's surface come from the suite theme (the source left those to the\r\nconsumer's `className`/`itemGroupClassName` utility classes). Two source rules are left out\r\nbecause they break existing suite uses (`st-source-bar`'s site/library menus): the 100vw panel\r\nat <=768px (overflows the screen from wherever the trigger sits; the header uses `inline`\r\ninstead) and `overflow: hidden` on slotted children (clips their focus rings). Suite additions\r\nkept on top: `align`, `active`, `disabled`, `inline`, and the `dropdown-toggle` event — plus\r\n`mega` and `open-on-hover` for an okta.com-style mega menu (see `st-mega-menu`).",
-          "name": "Dropdown",
+          "description": "A long-form article section: centered title/subtitle, an optional featured image with caption,\r\nthen Markdown body text. Ports `SankhyaUI`'s React `ContentBlock`. The body comes from\r\n`content-src` (a Markdown URL, as in the source) or an inline `content` string (added so the\r\nblock works without a fetch); `content-src` wins when both are set.",
+          "name": "ContentBlock",
           "cssProperties": [
             {
-              "description": "Maximum width of a `mega` panel (default `1400px`).",
-              "name": "--st-mega-menu-max-width"
-            },
-            {
-              "description": "Minimum space between a `mega` panel and the header's sides (default `1rem`).",
-              "name": "--st-mega-menu-inset"
-            },
-            {
-              "description": "Space between the header and a `mega` panel (default `12px`).",
-              "name": "--st-mega-menu-gap"
-            },
-            {
-              "description": "Corner radius of a `mega` panel (default `24px`).",
-              "name": "--st-mega-menu-radius"
+              "description": "Overrides the block's padding.",
+              "name": "--st-content-block-padding"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "openDropdown",
+              "name": "title",
               "type": {
-                "text": "Dropdown | null"
+                "text": "string"
               },
-              "privacy": "private",
-              "static": true,
-              "default": "null",
-              "description": "The open dropdown, if any — the source's `DropdownContext.activeDropdown`."
+              "default": "''",
+              "attribute": "title"
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Trigger label text (source: `title`, renamed because `title` is the native tooltip\r\nattribute). Leave empty to show only `slot=\"icon\"`.",
-              "attribute": "label"
+              "attribute": "subtitle"
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "contentSrc",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Renders the trigger as an `<a href>`. With panel content the click toggles the panel (as in\r\nthe source); with none it navigates.",
-              "attribute": "href"
+              "description": "URL of a Markdown file.",
+              "attribute": "content-src"
             },
             {
               "kind": "field",
-              "name": "iconPosition",
+              "name": "content",
               "type": {
-                "text": "'left' | 'right'"
+                "text": "string"
               },
-              "default": "'left'",
-              "attribute": "icon-position"
+              "default": "''",
+              "description": "Inline Markdown, used when `content-src` is not set.",
+              "attribute": "content"
             },
             {
               "kind": "field",
-              "name": "iconSize",
+              "name": "imageSrc",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "image-src"
+            },
+            {
+              "kind": "field",
+              "name": "imageAlt",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "image-alt"
+            },
+            {
+              "kind": "field",
+              "name": "imageCaption",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "image-caption"
+            },
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "title"
+            },
+            {
+              "name": "subtitle",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "subtitle"
+            },
+            {
+              "name": "content-src",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "URL of a Markdown file.",
+              "fieldName": "contentSrc"
+            },
+            {
+              "name": "content",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Inline Markdown, used when `content-src` is not set.",
+              "fieldName": "content"
+            },
+            {
+              "name": "image-src",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "imageSrc"
+            },
+            {
+              "name": "image-alt",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "imageAlt"
+            },
+            {
+              "name": "image-caption",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "imageCaption"
+            },
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "inverted"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "st-content-block",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ContentBlock",
+          "declaration": {
+            "name": "ContentBlock",
+            "module": "src/content-block/ContentBlock.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "st-content-block",
+          "declaration": {
+            "name": "ContentBlock",
+            "module": "src/content-block/ContentBlock.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/dropdown/Dropdown.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A labeled trigger + slotted dropdown panel — nav menus (typically holding an `st-menu-grid`),\r\naction menus, anything \"click a trigger, show content under it\". A 1:1 port of `SankhyaUI`'s\r\nReact `Dropdown` (`SankhyaCMS/SankhyaUI/src/components/Dropdown`): same markup\r\n(`.menu` > `.menu-title` + `.menu-dropdown`), sizes, 0.3s slide/fade, and behavior —\r\n\r\n- only one dropdown is open at a time (the source's `DropdownProvider`, built in here, so no\r\n  provider element is needed);\r\n- a mousedown outside, Escape, or a click inside the panel closes it;\r\n- an `href` trigger toggles the panel when it has content, and is a plain link when it doesn't;\r\n- `inline` opens the panel in the flow, the source's `.touch-device` layout.\r\n\r\nColors and the panel's surface come from the suite theme (the source left those to the\r\nconsumer's `className`/`itemGroupClassName` utility classes). Two source rules are left out\r\nbecause they break existing suite uses (`st-source-bar`'s site/library menus): the 100vw panel\r\nat <=768px (overflows the screen from wherever the trigger sits; the header uses `inline`\r\ninstead) and `overflow: hidden` on slotted children (clips their focus rings). Suite additions\r\nkept on top: `align`, `active`, `disabled`, `inline`, and the `dropdown-toggle` event — plus\r\n`mega` and `open-on-hover` for an okta.com-style mega menu (see `st-mega-menu`).",
+          "name": "Dropdown",
+          "cssProperties": [
+            {
+              "description": "Maximum width of a `mega` panel (default `1400px`).",
+              "name": "--st-mega-menu-max-width"
+            },
+            {
+              "description": "Minimum space between a `mega` panel and the header's sides (default `1rem`).",
+              "name": "--st-mega-menu-inset"
+            },
+            {
+              "description": "Space between the header and a `mega` panel (default `12px`).",
+              "name": "--st-mega-menu-gap"
+            },
+            {
+              "description": "Corner radius of a `mega` panel (default `24px`).",
+              "name": "--st-mega-menu-radius"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "openDropdown",
+              "type": {
+                "text": "Dropdown | null"
+              },
+              "privacy": "private",
+              "static": true,
+              "default": "null",
+              "description": "The open dropdown, if any — the source's `DropdownContext.activeDropdown`."
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Trigger label text (source: `title`, renamed because `title` is the native tooltip\r\nattribute). Leave empty to show only `slot=\"icon\"`.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Renders the trigger as an `<a href>`. With panel content the click toggles the panel (as in\r\nthe source); with none it navigates.",
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "iconPosition",
+              "type": {
+                "text": "'left' | 'right'"
+              },
+              "default": "'left'",
+              "attribute": "icon-position"
+            },
+            {
+              "kind": "field",
+              "name": "iconSize",
               "type": {
                 "text": "string"
               },
@@ -4607,23 +4631,23 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/menu-item/MenuItem.ts",
+      "path": "src/promo-banner/PromoBanner.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A single flat nav row — icon (`slot=\"icon\"`) + title + badge on one line, an optional\r\ndescription below — as opposed to `st-menu-grid-item`'s card for a multi-column grid. A 1:1\r\nport of `SankhyaUI`'s React `MenuItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same\r\nmarkup and CSS, with its `motion` effects redone in CSS — nudges right and scales to 1.01 on\r\nhover / 0.99 while pressed, the icon tilts on hover, the badge pops in, the description fades\r\nin. Colors come from the suite theme rather than per-item utility classes.\r\n\r\nRenders a real `<a href>` but fires a *cancelable* `menu-item-select` event (detail: `{ href }`)\r\nbefore navigating — a host doing client-side routing calls `event.preventDefault()` on it (the\r\nsource used react-router's `Link` here; the suite apps have no router).",
-          "name": "MenuItem",
-          "members": [
+          "description": "Rounded call-to-action banner (title, subtitle, one outlined button) on a dark panel or a\r\nbackground image. Port of `SankhyaUI`'s React `PromoBanner`; the button fires an `action` event\r\n(detail `{ href }`, empty unless set) in place of `onAction`.",
+          "name": "PromoBanner",
+          "cssProperties": [
             {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true }",
-              "description": "`focus()` on the element focuses its link, so `st-dropdown` can arrow-key between items."
+              "description": "Overrides the banner's margin.",
+              "name": "--st-promo-banner-margin"
             },
+            {
+              "description": "Overrides the banner's padding.",
+              "name": "--st-promo-banner-padding"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
               "name": "title",
@@ -4635,102 +4659,53 @@
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "href"
+              "attribute": "subtitle"
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "actionLabel",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "description"
+              "attribute": "action-label"
             },
             {
               "kind": "field",
-              "name": "badge",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
-              "attribute": "badge"
+              "attribute": "href"
             },
             {
               "kind": "field",
-              "name": "active",
+              "name": "imageSrc",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Highlights this row as the current page (source: `isActive`).",
-              "attribute": "active",
-              "reflects": true
+              "default": "''",
+              "attribute": "image-src"
             },
             {
               "kind": "field",
-              "name": "compact",
+              "name": "inverted",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "compact",
+              "attribute": "inverted",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "showDescription",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Suppresses the description even when `description` is set (source: `showDescription`, default `true`).",
-              "attribute": "show-description"
-            },
-            {
-              "kind": "field",
-              "name": "target",
-              "type": {
-                "text": "string"
-              },
-              "default": "'_self'",
-              "description": "`target` for the `<a>` (source default `_self`).",
-              "attribute": "target"
-            },
-            {
-              "kind": "field",
-              "name": "variant",
-              "type": {
-                "text": "'default' | 'link'"
-              },
-              "default": "'default'",
-              "description": "`default` (a row with a hover box) or `link` (a plain text link, as in `st-mega-menu-column`;\r\nmarked with an arrow when it opens a new tab).",
-              "attribute": "variant",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "hasIcon",
-              "type": {
-                "text": "boolean"
-              },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
-            },
-            {
-              "kind": "field",
-              "name": "onIconSlotChange",
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "onClick",
+              "name": "onAction",
               "privacy": "private"
             }
           ],
@@ -4744,121 +4719,92 @@
               "fieldName": "title"
             },
             {
-              "name": "href",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "href"
+              "fieldName": "subtitle"
             },
             {
-              "name": "description",
+              "name": "action-label",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "description"
+              "fieldName": "actionLabel"
             },
             {
-              "name": "badge",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
-              "fieldName": "badge"
+              "fieldName": "href"
             },
             {
-              "name": "active",
+              "name": "image-src",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Highlights this row as the current page (source: `isActive`).",
-              "fieldName": "active"
+              "default": "''",
+              "fieldName": "imageSrc"
             },
             {
-              "name": "compact",
+              "name": "inverted",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "compact"
-            },
-            {
-              "name": "show-description",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Suppresses the description even when `description` is set (source: `showDescription`, default `true`).",
-              "fieldName": "showDescription"
-            },
-            {
-              "name": "target",
-              "type": {
-                "text": "string"
-              },
-              "default": "'_self'",
-              "description": "`target` for the `<a>` (source default `_self`).",
-              "fieldName": "target"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'default' | 'link'"
-              },
-              "default": "'default'",
-              "description": "`default` (a row with a hover box) or `link` (a plain text link, as in `st-mega-menu-column`;\r\nmarked with an arrow when it opens a new tab).",
-              "fieldName": "variant"
+              "fieldName": "inverted"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "st-menu-item",
+          "tagName": "st-promo-banner",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "MenuItem",
+          "name": "PromoBanner",
           "declaration": {
-            "name": "MenuItem",
-            "module": "src/menu-item/MenuItem.ts"
+            "name": "PromoBanner",
+            "module": "src/promo-banner/PromoBanner.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-menu-item",
+          "name": "st-promo-banner",
           "declaration": {
-            "name": "MenuItem",
-            "module": "src/menu-item/MenuItem.ts"
+            "name": "PromoBanner",
+            "module": "src/promo-banner/PromoBanner.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/promo-banner/PromoBanner.ts",
+      "path": "src/menu-item/MenuItem.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Rounded call-to-action banner (title, subtitle, one outlined button) on a dark panel or a\r\nbackground image. Port of `SankhyaUI`'s React `PromoBanner`; the button fires an `action` event\r\n(detail `{ href }`, empty unless set) in place of `onAction`.",
-          "name": "PromoBanner",
-          "cssProperties": [
+          "description": "A single flat nav row — icon (`slot=\"icon\"`) + title + badge on one line, an optional\r\ndescription below — as opposed to `st-menu-grid-item`'s card for a multi-column grid. A 1:1\r\nport of `SankhyaUI`'s React `MenuItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same\r\nmarkup and CSS, with its `motion` effects redone in CSS — nudges right and scales to 1.01 on\r\nhover / 0.99 while pressed, the icon tilts on hover, the badge pops in, the description fades\r\nin. Colors come from the suite theme rather than per-item utility classes.\r\n\r\nRenders a real `<a href>` but fires a *cancelable* `menu-item-select` event (detail: `{ href }`)\r\nbefore navigating — a host doing client-side routing calls `event.preventDefault()` on it (the\r\nsource used react-router's `Link` here; the suite apps have no router).",
+          "name": "MenuItem",
+          "members": [
             {
-              "description": "Overrides the banner's margin.",
-              "name": "--st-promo-banner-margin"
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true }",
+              "description": "`focus()` on the element focuses its link, so `st-dropdown` can arrow-key between items."
             },
-            {
-              "description": "Overrides the banner's padding.",
-              "name": "--st-promo-banner-padding"
-            }
-          ],
-          "members": [
             {
               "kind": "field",
               "name": "title",
@@ -4870,53 +4816,102 @@
             },
             {
               "kind": "field",
-              "name": "subtitle",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "subtitle"
+              "attribute": "href"
             },
             {
               "kind": "field",
-              "name": "actionLabel",
+              "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "action-label"
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "badge",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "href"
+              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
+              "attribute": "badge"
             },
             {
               "kind": "field",
-              "name": "imageSrc",
+              "name": "active",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "attribute": "image-src"
+              "default": "false",
+              "description": "Highlights this row as the current page (source: `isActive`).",
+              "attribute": "active",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "inverted",
+              "name": "compact",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "inverted",
+              "attribute": "compact",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "onAction",
+              "name": "showDescription",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Suppresses the description even when `description` is set (source: `showDescription`, default `true`).",
+              "attribute": "show-description"
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "string"
+              },
+              "default": "'_self'",
+              "description": "`target` for the `<a>` (source default `_self`).",
+              "attribute": "target"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'link' | 'bar'"
+              },
+              "default": "'default'",
+              "description": "`default` (a row with a hover box), `link` (a plain text link, as in `st-mega-menu-column`;\r\nmarked with an arrow when it opens a new tab) or `bar` (a top-level item in a header bar,\r\nshaped like a mega `st-dropdown`'s trigger pill so it lines up with the dropdowns beside it).",
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
+            },
+            {
+              "kind": "field",
+              "name": "onIconSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onClick",
               "privacy": "private"
             }
           ],
@@ -4930,69 +4925,98 @@
               "fieldName": "title"
             },
             {
-              "name": "subtitle",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "subtitle"
+              "fieldName": "href"
             },
             {
-              "name": "action-label",
+              "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "actionLabel"
+              "fieldName": "description"
             },
             {
-              "name": "href",
+              "name": "badge",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "href"
+              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
+              "fieldName": "badge"
             },
             {
-              "name": "image-src",
+              "name": "active",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "fieldName": "imageSrc"
+              "default": "false",
+              "description": "Highlights this row as the current page (source: `isActive`).",
+              "fieldName": "active"
             },
             {
-              "name": "inverted",
+              "name": "compact",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "inverted"
+              "fieldName": "compact"
+            },
+            {
+              "name": "show-description",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Suppresses the description even when `description` is set (source: `showDescription`, default `true`).",
+              "fieldName": "showDescription"
+            },
+            {
+              "name": "target",
+              "type": {
+                "text": "string"
+              },
+              "default": "'_self'",
+              "description": "`target` for the `<a>` (source default `_self`).",
+              "fieldName": "target"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "'default' | 'link' | 'bar'"
+              },
+              "default": "'default'",
+              "description": "`default` (a row with a hover box), `link` (a plain text link, as in `st-mega-menu-column`;\r\nmarked with an arrow when it opens a new tab) or `bar` (a top-level item in a header bar,\r\nshaped like a mega `st-dropdown`'s trigger pill so it lines up with the dropdowns beside it).",
+              "fieldName": "variant"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "st-promo-banner",
+          "tagName": "st-menu-item",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "PromoBanner",
+          "name": "MenuItem",
           "declaration": {
-            "name": "PromoBanner",
-            "module": "src/promo-banner/PromoBanner.ts"
+            "name": "MenuItem",
+            "module": "src/menu-item/MenuItem.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-promo-banner",
+          "name": "st-menu-item",
           "declaration": {
-            "name": "PromoBanner",
-            "module": "src/promo-banner/PromoBanner.ts"
+            "name": "MenuItem",
+            "module": "src/menu-item/MenuItem.ts"
           }
         }
       ]
@@ -5213,6 +5237,77 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/stats/Stats.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Responsive grid of headline numbers with a label and optional description. Port of React `Stats`.\r\n`inverted` puts it on the dark band (`--st-cms-band-dark-bg`), which stays dark in the dark theme.",
+          "name": "Stats",
+          "cssProperties": [
+            {
+              "description": "Overrides the block's padding.",
+              "name": "--st-stats-padding"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "items",
+              "type": {
+                "text": "StatItem[]"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "inverted"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "st-stats",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Stats",
+          "declaration": {
+            "name": "Stats",
+            "module": "src/stats/Stats.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "st-stats",
+          "declaration": {
+            "name": "Stats",
+            "module": "src/stats/Stats.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/select/Select.ts",
@@ -5439,77 +5534,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/stats/Stats.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "Responsive grid of headline numbers with a label and optional description. Port of React `Stats`.\r\n`inverted` puts it on the dark band (`--st-cms-band-dark-bg`), which stays dark in the dark theme.",
-          "name": "Stats",
-          "cssProperties": [
-            {
-              "description": "Overrides the block's padding.",
-              "name": "--st-stats-padding"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "items",
-              "type": {
-                "text": "StatItem[]"
-              },
-              "default": "[]"
-            },
-            {
-              "kind": "field",
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "inverted",
-              "reflects": true
-            }
-          ],
-          "attributes": [
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "inverted"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "st-stats",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "Stats",
-          "declaration": {
-            "name": "Stats",
-            "module": "src/stats/Stats.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "st-stats",
-          "declaration": {
-            "name": "Stats",
-            "module": "src/stats/Stats.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/testimonials/Testimonials.ts",