@sankhyatronics/sankhya-cms 0.1.4 → 0.1.5

package/custom-elements.json

@@ -10,6 +10,12 @@
           "kind": "class",
           "description": "A responsive 4-column bento grid of icon/image cards. Items are set via the `items` property.",
           "name": "BentoGrid",
+          "cssProperties": [
+            {
+              "description": "Overrides the block's padding.",
+              "name": "--st-bento-grid-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -648,6 +654,12 @@
           "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",
@@ -828,6 +840,12 @@
           "kind": "class",
           "description": "Fixed bottom consent bar. The source read/wrote consent through a React `UserContext`; here the\r\nelement persists the choice itself in localStorage (`storage-key`, default the source's\r\n`sankhya_ui_cookie_consent`; storage errors are ignored) and renders nothing once a choice\r\nexists. Fires `cookie-consent-accept` / `cookie-consent-refuse` (detail `{ status }`). The\r\ndefault slot replaces the message text.",
           "name": "CookieConsent",
+          "cssProperties": [
+            {
+              "description": "Overrides the bar's padding.",
+              "name": "--st-cookie-consent-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -1585,6 +1603,12 @@
           "kind": "class",
           "description": "A title/markdown-subtitle/feature-list block beside (or under) an image.",
           "name": "FeatureSplit",
+          "cssProperties": [
+            {
+              "description": "Overrides the block's padding.",
+              "name": "--st-feature-split-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -1923,6 +1947,12 @@
           "kind": "class",
           "description": "A titled grid of feature tiles. Ports `SankhyaUI`'s React `FeaturesSection`: tiles come from the\r\n`items` property, from slotted `st-feature-item` elements (the source's `children`), or both\r\n(slotted first). `columns` sets the grid width (default 2; one column below 768px). `inverted`\r\nis passed on to the `items` tiles; slotted tiles need their own `inverted` attribute.",
           "name": "FeaturesSection",
+          "cssProperties": [
+            {
+              "description": "Overrides the section's padding.",
+              "name": "--st-features-section-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -2324,32 +2354,12 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/hero/Hero.ts",
+      "path": "src/header/Header.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Full-width hero banner: background image with a darkening overlay, optional eyebrow, title,\r\noptional subtitle and up to two call-to-action links. Port of `SankhyaUI`'s React `Hero`; the\r\nframer-motion entrance is redone as CSS keyframes (skipped under `prefers-reduced-motion`).\r\n\r\n`size`, `content-position` and `overlay=\"gradient\"` give the large editorial layout (copy on the\r\nlower left over a gradient that darkens towards it) used by enterprise marketing heroes; the\r\ndefaults keep the original centered banner. Put several heroes in an `st-carousel` with\r\n`indicator-style=\"tabs\"` for a tabbed hero carousel.",
-          "name": "Hero",
-          "cssProperties": [
-            {
-              "description": "Text colour over the image.",
-              "name": "--st-hero-text-color"
-            },
-            {
-              "description": "Minimum height when `size` is `large` (default `640px`).",
-              "name": "--st-hero-min-height"
-            }
-          ],
-          "cssParts": [
-            {
-              "description": "The small label above the title.",
-              "name": "eyebrow"
-            },
-            {
-              "description": "The outlined second button.",
-              "name": "secondary-action"
-            }
-          ],
+          "description": "The app-shell header bar — brand (image + title, or title alone) on the left, a `slot=\"menu\"`\r\nfor primary nav (e.g. `st-dropdown`/`st-menu-grid` mega-menus, or plain links) taking the\r\nmiddle, and a `slot=\"utility\"` for account/app-switcher/theme controls on the right. Ported\r\nfrom `SankhyaUI`'s React `Header` (a separate, unrelated marketing-site project) to this\r\npackage's Lit conventions and this workspace's actual needs — that source component takes an\r\n`imageSrc` logo with no text fallback, but none of this suite's apps has a logo image today, so\r\n`title` is the primary brand prop here and `brand-image-url` is optional, mirroring\r\n`st-app-header`'s own brand/title split (this component's slotted-menu/utility shape is a\r\ndeliberately different, more generic surface than `st-app-header`'s fixed nav-links/user-menu\r\nprops — pick whichever fits a given app's header).\r\n\r\nLayout follows the source's `Header.css`: the menu starts 4rem after the brand, the utility\r\ncontrols sit after a vertical divider, and below `BREAKPOINT_TABLET` (900px here; 768px in the\r\nsource) `menu`/`utility` collapse behind a hamburger toggle into a full-screen layer under the\r\ntoggle (closes on Escape or a click inside it), where the menu's `st-dropdown`s are switched to\r\n`inline` so they open in the flow — the same two slotted elements just get repositioned by CSS\r\n(`.mobile-panel`'s `display: contents` at desktop width vs. a real fixed-position box below\r\n`BREAKPOINT_TABLET`), rather than the slots being duplicated in the template, since a shadow\r\nroot can only ever assign a given light-DOM child to the *first* slot of a given name.\r\n\r\nAlso carries an optional built-in language switcher (`languages`/`currentLanguageCode`, fires\r\n`language-change`) — ported from `st-app-header`'s own implementation verbatim rather than\r\nrebuilt, since the source `Header`'s reference story shows an equivalent flag/language `Select`\r\nas a first-class header utility. Hidden entirely when `languages` has fewer than two entries.\r\nThis component has no translation logic itself; the consuming app owns what a language `code`\r\nmeans and which content it re-renders in response.",
+          "name": "Header",
           "members": [
             {
               "kind": "field",
@@ -2362,59 +2372,53 @@
             },
             {
               "kind": "field",
-              "name": "subtitle",
+              "name": "brandImageUrl",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "subtitle"
+              "description": "Optional logo image URL, shown before `title`. Omitted entirely when empty — none of this suite's apps has one today. Matches the source component's `imageSrc` (renamed here to pair with `title`/`logoHref`, since this component's only image use is the brand mark).",
+              "attribute": "brand-image-url"
             },
             {
               "kind": "field",
-              "name": "imageSrc",
+              "name": "altText",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "attribute": "image-src"
+              "default": "'Logo'",
+              "description": "`alt` text for the brand image — matches the source component's `altText` (default `'Logo'`).",
+              "attribute": "alt-text"
             },
             {
               "kind": "field",
-              "name": "actionLabel",
+              "name": "logoHref",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "action-label"
+              "description": "Wraps the brand in an `<a>` when set (e.g. `/`); a plain non-link `<div>` otherwise.",
+              "attribute": "logoHref"
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "logoTarget",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "attribute": "href"
-            },
-            {
-              "kind": "field",
-              "name": "textAlignment",
-              "type": {
-                "text": "'left' | 'center' | 'right' | 'justify'"
-              },
-              "default": "'left'",
-              "attribute": "text-alignment",
-              "reflects": true
+              "default": "'_self'",
+              "description": "`target` for the brand `<a>` — matches the source component's `logoTarget` (default `_self`). No effect when `logoHref` isn't set.",
+              "attribute": "logo-target"
             },
             {
               "kind": "field",
-              "name": "padding",
+              "name": "logoClassName",
               "type": {
-                "text": "'none' | 'small' | 'medium' | 'large'"
+                "text": "string"
               },
-              "default": "'none'",
-              "attribute": "padding",
-              "reflects": true
+              "default": "''",
+              "description": "Extra class(es) appended to the brand link/div — matches the source component's `logoClassName`.",
+              "attribute": "logo-class-name"
             },
             {
               "kind": "field",
@@ -2423,618 +2427,653 @@
                 "text": "boolean"
               },
               "default": "false",
+              "description": "Inverts the header's color roles (light-on-dark instead of dark-on-light) — matches the\r\nsource component's `inverted` (from its shared `BaseProps`).",
               "attribute": "inverted",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "focalPoint",
+              "name": "sticky",
               "type": {
-                "text": "'top' | 'left' | 'right' | 'bottom' | 'center'"
+                "text": "boolean"
               },
-              "default": "'center'",
-              "attribute": "focal-point"
+              "default": "false",
+              "attribute": "sticky",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "eyebrow",
+              "name": "transparent",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Small uppercase label above the title (e.g. an event or product name).",
-              "attribute": "eyebrow"
+              "default": "false",
+              "description": "Fixes the header over the top of the page and makes it see-through, with light text\r\n(`--st-header-transparent-color`), until the page scrolls past `scroll-threshold` — for a\r\nheader laid over a dark hero. It then takes its normal background and a shadow. The page\r\ncontent starts under it, so the first section should leave room for the 64px bar.",
+              "attribute": "transparent",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "secondaryActionLabel",
+              "name": "hideOnScroll",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Label of an outlined second button next to the primary one.",
-              "attribute": "secondary-action-label"
+              "default": "false",
+              "description": "Slides the header out of view while the page scrolls down and back in when it scrolls up.",
+              "attribute": "hide-on-scroll",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "secondaryHref",
+              "name": "scrollThreshold",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "attribute": "secondary-href"
+              "default": "8",
+              "description": "Scroll distance in px after which the header counts as `scrolled`.",
+              "attribute": "scroll-threshold"
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "scrolled",
               "type": {
-                "text": "'auto' | 'large' | 'full'"
+                "text": "boolean"
               },
-              "default": "'auto'",
-              "description": "`auto` sizes to the content; `large` is a tall editorial hero (`--st-hero-min-height`); `full` fills the viewport.",
-              "attribute": "size",
+              "default": "false",
+              "description": "True once the page has scrolled past `scroll-threshold`; reflected so pages can style `st-header[scrolled]`. Set by the header, never from outside.",
+              "attribute": "scrolled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "contentPosition",
+              "name": "scrollHidden",
               "type": {
-                "text": "'center' | 'bottom'"
+                "text": "boolean"
               },
-              "default": "'center'",
-              "description": "`center` keeps the copy in the middle; `bottom` puts it in the lower part of the hero, on the page container.",
-              "attribute": "content-position",
+              "default": "false",
+              "description": "True while `hide-on-scroll` has slid the header away. Set by the header, never from outside.",
+              "attribute": "scroll-hidden",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "overlay",
+              "name": "lastScrollY",
               "type": {
-                "text": "'even' | 'gradient' | 'none'"
+                "text": "number"
               },
-              "default": "'even'",
-              "description": "`even` darkens the whole image; `gradient` darkens behind the copy only; `none` shows the image as is.",
-              "attribute": "overlay",
-              "reflects": true
+              "privacy": "private",
+              "default": "0"
             },
             {
               "kind": "field",
-              "name": "positions",
-              "privacy": "private",
-              "static": true,
-              "default": "{ top: 'center top', left: 'left center', right: 'right center', bottom: 'center bottom', center: 'center center' }",
+              "name": "scrollFrame",
               "type": {
-                "text": "{\r\n    top: 'center top',\r\n    left: 'left center',\r\n    right: 'right center',\r\n    bottom: 'center bottom',\r\n    center: 'center center'\r\n  }"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "emitAction",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+                "text": "number"
               },
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                },
-                {
-                  "name": "href",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "kind",
-                  "type": {
-                    "text": "'primary' | 'secondary'"
-                  }
-                }
-              ]
+              "privacy": "private",
+              "default": "0"
             },
             {
               "kind": "field",
-              "name": "onClick",
+              "name": "onScroll",
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "onSecondaryClick",
-              "privacy": "private"
-            }
-          ],
-          "events": [
-            {
-              "description": "Cancelable, before navigating. Detail `{ href, kind }`, `kind` being `primary` or `secondary`.",
-              "name": "action"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "title",
+              "name": "languages",
               "type": {
-                "text": "string"
+                "text": "{ code: string; label: string }[]"
               },
-              "default": "''",
-              "fieldName": "title"
+              "default": "[]",
+              "description": "Language switcher options, e.g. `[{ code: 'en', label: 'English' }, ...]` — hidden entirely\r\nwhen empty or when only one language is offered (same convention as `st-app-header`'s\r\n`languages`, which this reuses verbatim). This component has no translation logic itself —\r\nselecting an option fires `language-change` (detail: `{ code }`), and the consuming app owns\r\nwhat `code` actually means and which content it re-renders."
             },
             {
-              "name": "subtitle",
+              "kind": "field",
+              "name": "currentLanguageCode",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "subtitle"
+              "attribute": "current-language-code"
             },
             {
-              "name": "image-src",
+              "kind": "field",
+              "name": "languageMenuLabel",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "fieldName": "imageSrc"
+              "default": "'Language'",
+              "attribute": "language-menu-label"
             },
             {
-              "name": "action-label",
+              "kind": "field",
+              "name": "mobileOpen",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "fieldName": "actionLabel"
+              "default": "false",
+              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\r\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\r\noutside.",
+              "attribute": "mobile-open",
+              "reflects": true
             },
             {
-              "name": "href",
+              "kind": "field",
+              "name": "compact",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "fieldName": "href"
+              "default": "false",
+              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\r\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
+              "attribute": "compact",
+              "reflects": true
             },
             {
-              "name": "text-alignment",
-              "type": {
-                "text": "'left' | 'center' | 'right' | 'justify'"
-              },
-              "default": "'left'",
-              "fieldName": "textAlignment"
-            },
-            {
-              "name": "padding",
+              "kind": "field",
+              "name": "languageMenuOpen",
               "type": {
-                "text": "'none' | 'small' | 'medium' | 'large'"
+                "text": "boolean"
               },
-              "default": "'none'",
-              "fieldName": "padding"
+              "privacy": "private",
+              "default": "false"
             },
             {
-              "name": "inverted",
+              "kind": "field",
+              "name": "hasUtility",
               "type": {
                 "text": "boolean"
               },
+              "privacy": "private",
               "default": "false",
-              "fieldName": "inverted"
+              "description": "Whether `slot=\"utility\"` has content — an empty utility row (and its divider) is hidden."
             },
             {
-              "name": "focal-point",
+              "kind": "field",
+              "name": "resizeObserver",
               "type": {
-                "text": "'top' | 'left' | 'right' | 'bottom' | 'center'"
+                "text": "ResizeObserver | undefined"
               },
-              "default": "'center'",
-              "fieldName": "focalPoint"
+              "privacy": "private"
             },
             {
-              "name": "eyebrow",
+              "kind": "field",
+              "name": "narrowQuery",
               "type": {
-                "text": "string"
+                "text": "MediaQueryList | undefined"
               },
-              "default": "''",
-              "description": "Small uppercase label above the title (e.g. an event or product name).",
-              "fieldName": "eyebrow"
+              "privacy": "private",
+              "description": "Matches below BREAKPOINT_TABLET, where the hamburger layout is always on."
             },
             {
-              "name": "secondary-action-label",
+              "kind": "field",
+              "name": "inlinedDropdowns",
+              "privacy": "private",
+              "default": "new Set<HTMLElement & { inline: boolean; open: boolean }>()",
+              "description": "The dropdowns this header switched to `inline` — only these are switched back, so a caller's\r\nown `inline` setting is left alone."
+            },
+            {
+              "kind": "field",
+              "name": "syncInlineDropdowns",
+              "privacy": "private",
+              "description": "While the hamburger layout is on, the dropdowns in the header open in the flow of the\r\nfull-screen panel instead of floating over it (SankhyaUI's touch-device layout)."
+            },
+            {
+              "kind": "field",
+              "name": "onUtilitySlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onMenuSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "collapsedAtWidth",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "description": "Label of an outlined second button next to the primary one.",
-              "fieldName": "secondaryActionLabel"
+              "privacy": "private",
+              "default": "0",
+              "description": "The bar width at which the menu last overflowed — the bar only expands again once it is\r\nclearly wider than this, so it can't flip back and forth right at the threshold."
             },
             {
-              "name": "secondary-href",
-              "type": {
-                "text": "string"
+              "kind": "field",
+              "name": "evaluateFit",
+              "privacy": "private",
+              "description": "Collapses to the hamburger layout when the slotted menu overflows its row, and expands again\r\nonce there is room. The collapsed layout hides the menu, so the room it needs can't be\r\nmeasured then; the width remembered when it collapsed stands in for it."
+            },
+            {
+              "kind": "method",
+              "name": "menuOverflows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
               },
-              "default": "''",
-              "fieldName": "secondaryHref"
+              "description": "Whether the visible menu items reach past the right edge of the menu row. Measured from the\r\nitems' own boxes (the slotted elements and their direct children), not the row's scrollWidth:\r\na closed dropdown's absolutely positioned panel also counts towards scrollWidth, which would\r\nreport overflow at any width."
             },
             {
-              "name": "size",
+              "kind": "field",
+              "name": "lightDomObserver",
               "type": {
-                "text": "'auto' | 'large' | 'full'"
+                "text": "MutationObserver | undefined"
               },
-              "default": "'auto'",
-              "description": "`auto` sizes to the content; `large` is a tall editorial hero (`--st-hero-min-height`); `full` fills the viewport.",
-              "fieldName": "size"
+              "privacy": "private"
             },
             {
-              "name": "content-position",
-              "type": {
-                "text": "'center' | 'bottom'"
+              "kind": "field",
+              "name": "closeOnEscape",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "closeLanguageMenuOnOutsideClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "renderLanguageMenu",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "onLanguageSelect",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
               },
-              "default": "'center'",
-              "description": "`center` keeps the copy in the middle; `bottom` puts it in the lower part of the hero, on the page container.",
-              "fieldName": "contentPosition"
+              "parameters": [
+                {
+                  "name": "code",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "name": "overlay",
+              "kind": "method",
+              "name": "renderBrand",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "language-change",
               "type": {
-                "text": "'even' | 'gradient' | 'none'"
-              },
-              "default": "'even'",
-              "description": "`even` darkens the whole image; `gradient` darkens behind the copy only; `none` shows the image as is.",
-              "fieldName": "overlay"
+                "text": "CustomEvent"
+              }
             }
           ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "st-hero",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "Hero",
-          "declaration": {
-            "name": "Hero",
-            "module": "src/hero/Hero.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "st-hero",
-          "declaration": {
-            "name": "Hero",
-            "module": "src/hero/Hero.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/header/Header.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The app-shell header bar — brand (image + title, or title alone) on the left, a `slot=\"menu\"`\r\nfor primary nav (e.g. `st-dropdown`/`st-menu-grid` mega-menus, or plain links) taking the\r\nmiddle, and a `slot=\"utility\"` for account/app-switcher/theme controls on the right. Ported\r\nfrom `SankhyaUI`'s React `Header` (a separate, unrelated marketing-site project) to this\r\npackage's Lit conventions and this workspace's actual needs — that source component takes an\r\n`imageSrc` logo with no text fallback, but none of this suite's apps has a logo image today, so\r\n`title` is the primary brand prop here and `brand-image-url` is optional, mirroring\r\n`st-app-header`'s own brand/title split (this component's slotted-menu/utility shape is a\r\ndeliberately different, more generic surface than `st-app-header`'s fixed nav-links/user-menu\r\nprops — pick whichever fits a given app's header).\r\n\r\nLayout follows the source's `Header.css`: the menu starts 4rem after the brand, the utility\r\ncontrols sit after a vertical divider, and below `BREAKPOINT_TABLET` (900px here; 768px in the\r\nsource) `menu`/`utility` collapse behind a hamburger toggle into a full-screen layer under the\r\ntoggle (closes on Escape or a click inside it), where the menu's `st-dropdown`s are switched to\r\n`inline` so they open in the flow — the same two slotted elements just get repositioned by CSS\r\n(`.mobile-panel`'s `display: contents` at desktop width vs. a real fixed-position box below\r\n`BREAKPOINT_TABLET`), rather than the slots being duplicated in the template, since a shadow\r\nroot can only ever assign a given light-DOM child to the *first* slot of a given name.\r\n\r\nAlso carries an optional built-in language switcher (`languages`/`currentLanguageCode`, fires\r\n`language-change`) — ported from `st-app-header`'s own implementation verbatim rather than\r\nrebuilt, since the source `Header`'s reference story shows an equivalent flag/language `Select`\r\nas a first-class header utility. Hidden entirely when `languages` has fewer than two entries.\r\nThis component has no translation logic itself; the consuming app owns what a language `code`\r\nmeans and which content it re-renders in response.",
-          "name": "Header",
-          "members": [
+          "attributes": [
             {
-              "kind": "field",
               "name": "title",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "title"
+              "fieldName": "title"
             },
             {
-              "kind": "field",
-              "name": "brandImageUrl",
+              "name": "brand-image-url",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "Optional logo image URL, shown before `title`. Omitted entirely when empty — none of this suite's apps has one today. Matches the source component's `imageSrc` (renamed here to pair with `title`/`logoHref`, since this component's only image use is the brand mark).",
-              "attribute": "brand-image-url"
+              "fieldName": "brandImageUrl"
             },
             {
-              "kind": "field",
-              "name": "altText",
+              "name": "alt-text",
               "type": {
                 "text": "string"
               },
               "default": "'Logo'",
               "description": "`alt` text for the brand image — matches the source component's `altText` (default `'Logo'`).",
-              "attribute": "alt-text"
+              "fieldName": "altText"
             },
             {
-              "kind": "field",
               "name": "logoHref",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "Wraps the brand in an `<a>` when set (e.g. `/`); a plain non-link `<div>` otherwise.",
-              "attribute": "logoHref"
+              "fieldName": "logoHref"
             },
             {
-              "kind": "field",
-              "name": "logoTarget",
+              "name": "logo-target",
               "type": {
                 "text": "string"
               },
               "default": "'_self'",
               "description": "`target` for the brand `<a>` — matches the source component's `logoTarget` (default `_self`). No effect when `logoHref` isn't set.",
-              "attribute": "logo-target"
+              "fieldName": "logoTarget"
             },
             {
-              "kind": "field",
-              "name": "logoClassName",
+              "name": "logo-class-name",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "Extra class(es) appended to the brand link/div — matches the source component's `logoClassName`.",
-              "attribute": "logo-class-name"
+              "fieldName": "logoClassName"
             },
             {
-              "kind": "field",
               "name": "inverted",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Inverts the header's color roles (light-on-dark instead of dark-on-light) — matches the\r\nsource component's `inverted` (from its shared `BaseProps`).",
-              "attribute": "inverted",
-              "reflects": true
+              "fieldName": "inverted"
             },
             {
-              "kind": "field",
               "name": "sticky",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "attribute": "sticky",
-              "reflects": true
+              "fieldName": "sticky"
             },
             {
-              "kind": "field",
               "name": "transparent",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Fixes the header over the top of the page and makes it see-through, with light text\r\n(`--st-header-transparent-color`), until the page scrolls past `scroll-threshold` — for a\r\nheader laid over a dark hero. It then takes its normal background and a shadow. The page\r\ncontent starts under it, so the first section should leave room for the 64px bar.",
-              "attribute": "transparent",
-              "reflects": true
+              "fieldName": "transparent"
             },
             {
-              "kind": "field",
-              "name": "hideOnScroll",
+              "name": "hide-on-scroll",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Slides the header out of view while the page scrolls down and back in when it scrolls up.",
-              "attribute": "hide-on-scroll",
-              "reflects": true
+              "fieldName": "hideOnScroll"
             },
             {
-              "kind": "field",
-              "name": "scrollThreshold",
+              "name": "scroll-threshold",
               "type": {
                 "text": "number"
               },
               "default": "8",
               "description": "Scroll distance in px after which the header counts as `scrolled`.",
-              "attribute": "scroll-threshold"
+              "fieldName": "scrollThreshold"
             },
             {
-              "kind": "field",
               "name": "scrolled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "True once the page has scrolled past `scroll-threshold`; reflected so pages can style `st-header[scrolled]`. Set by the header, never from outside.",
-              "attribute": "scrolled",
-              "reflects": true
+              "fieldName": "scrolled"
             },
             {
-              "kind": "field",
-              "name": "scrollHidden",
+              "name": "scroll-hidden",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "True while `hide-on-scroll` has slid the header away. Set by the header, never from outside.",
-              "attribute": "scroll-hidden",
-              "reflects": true
+              "fieldName": "scrollHidden"
             },
             {
-              "kind": "field",
-              "name": "lastScrollY",
+              "name": "current-language-code",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "0"
+              "default": "''",
+              "fieldName": "currentLanguageCode"
             },
             {
-              "kind": "field",
-              "name": "scrollFrame",
+              "name": "language-menu-label",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "0"
+              "default": "'Language'",
+              "fieldName": "languageMenuLabel"
             },
             {
-              "kind": "field",
-              "name": "onScroll",
-              "privacy": "private"
+              "name": "mobile-open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\r\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\r\noutside.",
+              "fieldName": "mobileOpen"
             },
             {
-              "kind": "field",
-              "name": "languages",
+              "name": "compact",
               "type": {
-                "text": "{ code: string; label: string }[]"
+                "text": "boolean"
               },
-              "default": "[]",
-              "description": "Language switcher options, e.g. `[{ code: 'en', label: 'English' }, ...]` — hidden entirely\r\nwhen empty or when only one language is offered (same convention as `st-app-header`'s\r\n`languages`, which this reuses verbatim). This component has no translation logic itself —\r\nselecting an option fires `language-change` (detail: `{ code }`), and the consuming app owns\r\nwhat `code` actually means and which content it re-renders."
+              "default": "false",
+              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\r\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
+              "fieldName": "compact"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "st-header",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Header",
+          "declaration": {
+            "name": "Header",
+            "module": "src/header/Header.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "st-header",
+          "declaration": {
+            "name": "Header",
+            "module": "src/header/Header.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/hero/Hero.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Full-width hero banner: background image with a darkening overlay, optional eyebrow, title,\r\noptional subtitle and up to two call-to-action links. Port of `SankhyaUI`'s React `Hero`; the\r\nframer-motion entrance is redone as CSS keyframes (skipped under `prefers-reduced-motion`).\r\n\r\n`size`, `content-position` and `overlay=\"gradient\"` give the large editorial layout (copy on the\r\nlower left over a gradient that darkens towards it) used by enterprise marketing heroes; the\r\ndefaults keep the original centered banner. Put several heroes in an `st-carousel` with\r\n`indicator-style=\"tabs\"` for a tabbed hero carousel.",
+          "name": "Hero",
+          "cssProperties": [
+            {
+              "description": "Text colour over the image.",
+              "name": "--st-hero-text-color"
+            },
+            {
+              "description": "Minimum height when `size` is `large` (default `640px`).",
+              "name": "--st-hero-min-height"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The small label above the title.",
+              "name": "eyebrow"
             },
+            {
+              "description": "The outlined second button.",
+              "name": "secondary-action"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "currentLanguageCode",
+              "name": "title",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "current-language-code"
+              "attribute": "title"
             },
             {
               "kind": "field",
-              "name": "languageMenuLabel",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
-              "default": "'Language'",
-              "attribute": "language-menu-label"
+              "default": "''",
+              "attribute": "subtitle"
             },
             {
               "kind": "field",
-              "name": "mobileOpen",
+              "name": "imageSrc",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\r\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\r\noutside.",
-              "attribute": "mobile-open",
-              "reflects": true
+              "default": "''",
+              "attribute": "image-src"
             },
             {
               "kind": "field",
-              "name": "compact",
+              "name": "actionLabel",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\r\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
-              "attribute": "compact",
-              "reflects": true
+              "default": "''",
+              "attribute": "action-label"
             },
             {
               "kind": "field",
-              "name": "languageMenuOpen",
+              "name": "href",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "''",
+              "attribute": "href"
             },
             {
               "kind": "field",
-              "name": "hasUtility",
+              "name": "textAlignment",
               "type": {
-                "text": "boolean"
+                "text": "'left' | 'center' | 'right' | 'justify'"
               },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether `slot=\"utility\"` has content — an empty utility row (and its divider) is hidden."
+              "default": "'left'",
+              "attribute": "text-alignment",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "resizeObserver",
+              "name": "padding",
               "type": {
-                "text": "ResizeObserver | undefined"
+                "text": "'none' | 'small' | 'medium' | 'large'"
               },
-              "privacy": "private"
+              "default": "'none'",
+              "attribute": "padding",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "narrowQuery",
+              "name": "inverted",
               "type": {
-                "text": "MediaQueryList | undefined"
+                "text": "boolean"
               },
-              "privacy": "private",
-              "description": "Matches below BREAKPOINT_TABLET, where the hamburger layout is always on."
-            },
-            {
-              "kind": "field",
-              "name": "inlinedDropdowns",
-              "privacy": "private",
-              "default": "new Set<HTMLElement & { inline: boolean; open: boolean }>()",
-              "description": "The dropdowns this header switched to `inline` — only these are switched back, so a caller's\r\nown `inline` setting is left alone."
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "syncInlineDropdowns",
-              "privacy": "private",
-              "description": "While the hamburger layout is on, the dropdowns in the header open in the flow of the\r\nfull-screen panel instead of floating over it (SankhyaUI's touch-device layout)."
+              "name": "focalPoint",
+              "type": {
+                "text": "'top' | 'left' | 'right' | 'bottom' | 'center'"
+              },
+              "default": "'center'",
+              "attribute": "focal-point"
             },
             {
               "kind": "field",
-              "name": "onUtilitySlotChange",
-              "privacy": "private"
+              "name": "eyebrow",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Small uppercase label above the title (e.g. an event or product name).",
+              "attribute": "eyebrow"
             },
             {
               "kind": "field",
-              "name": "onMenuSlotChange",
-              "privacy": "private"
+              "name": "secondaryActionLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Label of an outlined second button next to the primary one.",
+              "attribute": "secondary-action-label"
             },
             {
               "kind": "field",
-              "name": "collapsedAtWidth",
+              "name": "secondaryHref",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "0",
-              "description": "The bar width at which the menu last overflowed — the bar only expands again once it is\r\nclearly wider than this, so it can't flip back and forth right at the threshold."
+              "default": "''",
+              "attribute": "secondary-href"
             },
             {
               "kind": "field",
-              "name": "evaluateFit",
-              "privacy": "private",
-              "description": "Collapses to the hamburger layout when the slotted menu overflows its row, and expands again\r\nonce there is room. The collapsed layout hides the menu, so the room it needs can't be\r\nmeasured then; the width remembered when it collapsed stands in for it."
-            },
-            {
-              "kind": "method",
-              "name": "menuOverflows",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
+              "name": "size",
+              "type": {
+                "text": "'auto' | 'large' | 'full'"
               },
-              "description": "Whether the visible menu items reach past the right edge of the menu row. Measured from the\r\nitems' own boxes (the slotted elements and their direct children), not the row's scrollWidth:\r\na closed dropdown's absolutely positioned panel also counts towards scrollWidth, which would\r\nreport overflow at any width."
+              "default": "'auto'",
+              "description": "`auto` sizes to the content; `large` is a tall editorial hero (`--st-hero-min-height`); `full` fills the viewport.",
+              "attribute": "size",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "lightDomObserver",
+              "name": "contentPosition",
               "type": {
-                "text": "MutationObserver | undefined"
+                "text": "'center' | 'bottom'"
               },
-              "privacy": "private"
+              "default": "'center'",
+              "description": "`center` keeps the copy in the middle; `bottom` puts it in the lower part of the hero, on the page container.",
+              "attribute": "content-position",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "closeOnEscape",
-              "privacy": "private"
+              "name": "overlay",
+              "type": {
+                "text": "'even' | 'gradient' | 'none'"
+              },
+              "default": "'even'",
+              "description": "`even` darkens the whole image; `gradient` darkens behind the copy only; `none` shows the image as is.",
+              "attribute": "overlay",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "closeLanguageMenuOnOutsideClick",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "renderLanguageMenu",
-              "privacy": "private"
+              "name": "positions",
+              "privacy": "private",
+              "static": true,
+              "default": "{ top: 'center top', left: 'left center', right: 'right center', bottom: 'center bottom', center: 'center center' }",
+              "type": {
+                "text": "{\r\n    top: 'center top',\r\n    left: 'left center',\r\n    right: 'right center',\r\n    bottom: 'center bottom',\r\n    center: 'center center'\r\n  }"
+              }
             },
             {
               "kind": "method",
-              "name": "onLanguageSelect",
+              "name": "emitAction",
               "privacy": "private",
               "return": {
                 "type": {
@@ -3043,25 +3082,40 @@
               },
               "parameters": [
                 {
-                  "name": "code",
+                  "name": "event",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                },
+                {
+                  "name": "href",
                   "type": {
                     "text": "string"
                   }
+                },
+                {
+                  "name": "kind",
+                  "type": {
+                    "text": "'primary' | 'secondary'"
+                  }
                 }
               ]
             },
             {
-              "kind": "method",
-              "name": "renderBrand",
+              "kind": "field",
+              "name": "onClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onSecondaryClick",
               "privacy": "private"
             }
           ],
           "events": [
             {
-              "name": "language-change",
-              "type": {
-                "text": "CustomEvent"
-              }
+              "description": "Cancelable, before navigating. Detail `{ href, kind }`, `kind` being `primary` or `secondary`.",
+              "name": "action"
             }
           ],
           "attributes": [
@@ -3074,170 +3128,146 @@
               "fieldName": "title"
             },
             {
-              "name": "brand-image-url",
+              "name": "subtitle",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Optional logo image URL, shown before `title`. Omitted entirely when empty — none of this suite's apps has one today. Matches the source component's `imageSrc` (renamed here to pair with `title`/`logoHref`, since this component's only image use is the brand mark).",
-              "fieldName": "brandImageUrl"
-            },
-            {
-              "name": "alt-text",
-              "type": {
-                "text": "string"
-              },
-              "default": "'Logo'",
-              "description": "`alt` text for the brand image — matches the source component's `altText` (default `'Logo'`).",
-              "fieldName": "altText"
+              "fieldName": "subtitle"
             },
             {
-              "name": "logoHref",
+              "name": "image-src",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Wraps the brand in an `<a>` when set (e.g. `/`); a plain non-link `<div>` otherwise.",
-              "fieldName": "logoHref"
+              "fieldName": "imageSrc"
             },
             {
-              "name": "logo-target",
+              "name": "action-label",
               "type": {
                 "text": "string"
               },
-              "default": "'_self'",
-              "description": "`target` for the brand `<a>` — matches the source component's `logoTarget` (default `_self`). No effect when `logoHref` isn't set.",
-              "fieldName": "logoTarget"
+              "default": "''",
+              "fieldName": "actionLabel"
             },
             {
-              "name": "logo-class-name",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Extra class(es) appended to the brand link/div — matches the source component's `logoClassName`.",
-              "fieldName": "logoClassName"
-            },
-            {
-              "name": "inverted",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Inverts the header's color roles (light-on-dark instead of dark-on-light) — matches the\r\nsource component's `inverted` (from its shared `BaseProps`).",
-              "fieldName": "inverted"
+              "fieldName": "href"
             },
             {
-              "name": "sticky",
+              "name": "text-alignment",
               "type": {
-                "text": "boolean"
+                "text": "'left' | 'center' | 'right' | 'justify'"
               },
-              "default": "false",
-              "fieldName": "sticky"
+              "default": "'left'",
+              "fieldName": "textAlignment"
             },
             {
-              "name": "transparent",
+              "name": "padding",
               "type": {
-                "text": "boolean"
+                "text": "'none' | 'small' | 'medium' | 'large'"
               },
-              "default": "false",
-              "description": "Fixes the header over the top of the page and makes it see-through, with light text\r\n(`--st-header-transparent-color`), until the page scrolls past `scroll-threshold` — for a\r\nheader laid over a dark hero. It then takes its normal background and a shadow. The page\r\ncontent starts under it, so the first section should leave room for the 64px bar.",
-              "fieldName": "transparent"
+              "default": "'none'",
+              "fieldName": "padding"
             },
             {
-              "name": "hide-on-scroll",
+              "name": "inverted",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Slides the header out of view while the page scrolls down and back in when it scrolls up.",
-              "fieldName": "hideOnScroll"
+              "fieldName": "inverted"
             },
             {
-              "name": "scroll-threshold",
+              "name": "focal-point",
               "type": {
-                "text": "number"
+                "text": "'top' | 'left' | 'right' | 'bottom' | 'center'"
               },
-              "default": "8",
-              "description": "Scroll distance in px after which the header counts as `scrolled`.",
-              "fieldName": "scrollThreshold"
+              "default": "'center'",
+              "fieldName": "focalPoint"
             },
             {
-              "name": "scrolled",
+              "name": "eyebrow",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "True once the page has scrolled past `scroll-threshold`; reflected so pages can style `st-header[scrolled]`. Set by the header, never from outside.",
-              "fieldName": "scrolled"
+              "default": "''",
+              "description": "Small uppercase label above the title (e.g. an event or product name).",
+              "fieldName": "eyebrow"
             },
             {
-              "name": "scroll-hidden",
+              "name": "secondary-action-label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "True while `hide-on-scroll` has slid the header away. Set by the header, never from outside.",
-              "fieldName": "scrollHidden"
+              "default": "''",
+              "description": "Label of an outlined second button next to the primary one.",
+              "fieldName": "secondaryActionLabel"
             },
             {
-              "name": "current-language-code",
+              "name": "secondary-href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "currentLanguageCode"
+              "fieldName": "secondaryHref"
             },
             {
-              "name": "language-menu-label",
+              "name": "size",
               "type": {
-                "text": "string"
+                "text": "'auto' | 'large' | 'full'"
               },
-              "default": "'Language'",
-              "fieldName": "languageMenuLabel"
+              "default": "'auto'",
+              "description": "`auto` sizes to the content; `large` is a tall editorial hero (`--st-hero-min-height`); `full` fills the viewport.",
+              "fieldName": "size"
             },
             {
-              "name": "mobile-open",
+              "name": "content-position",
               "type": {
-                "text": "boolean"
+                "text": "'center' | 'bottom'"
               },
-              "default": "false",
-              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\r\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\r\noutside.",
-              "fieldName": "mobileOpen"
+              "default": "'center'",
+              "description": "`center` keeps the copy in the middle; `bottom` puts it in the lower part of the hero, on the page container.",
+              "fieldName": "contentPosition"
             },
             {
-              "name": "compact",
+              "name": "overlay",
               "type": {
-                "text": "boolean"
+                "text": "'even' | 'gradient' | 'none'"
               },
-              "default": "false",
-              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\r\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
-              "fieldName": "compact"
+              "default": "'even'",
+              "description": "`even` darkens the whole image; `gradient` darkens behind the copy only; `none` shows the image as is.",
+              "fieldName": "overlay"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "st-header",
+          "tagName": "st-hero",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "Header",
+          "name": "Hero",
           "declaration": {
-            "name": "Header",
-            "module": "src/header/Header.ts"
+            "name": "Hero",
+            "module": "src/hero/Hero.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-header",
+          "name": "st-hero",
           "declaration": {
-            "name": "Header",
-            "module": "src/header/Header.ts"
+            "name": "Hero",
+            "module": "src/hero/Hero.ts"
           }
         }
       ]
@@ -3326,6 +3356,12 @@
           "kind": "class",
           "description": "A vertical list of collapsible title/content rows; one open at a time unless `allow-multiple`.",
           "name": "ItemsAccordion",
+          "cssProperties": [
+            {
+              "description": "Overrides the block's padding.",
+              "name": "--st-items-accordion-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -3770,6 +3806,12 @@
           "kind": "class",
           "description": "One column (or one group within a column) of an `st-mega-menu`: a heading, an optional line of\ndescription, then its links stacked — usually `st-menu-item`s with `variant=\"link\"`. Nest\ncolumns to stack several headed groups in one column, as okta.com does.\n\n`variant=\"card\"` puts the column on a tinted rounded tile and `variant=\"accent\"` on a solid\naccent tile with light text; both suit a row of equal columns without intro or featured area.\n`cta-label` + `cta-href` add a pill button at the bottom of the column.\n\nThe heading (when `href` is set) and the button fire a *cancelable* `mega-menu-select` event\n(detail: `{ href }`) before navigating; a host doing client-side routing calls\n`event.preventDefault()` on it.",
           "name": "MegaMenuColumn",
+          "cssProperties": [
+            {
+              "description": "Overrides the padding of a `card`/`accent` column.",
+              "name": "--st-mega-menu-column-padding"
+            }
+          ],
           "cssParts": [
             {
               "description": "The heading text or link.",
@@ -4806,6 +4848,16 @@
           "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": "Overrides the banner's margin.",
+              "name": "--st-promo-banner-margin"
+            },
+            {
+              "description": "Overrides the banner's padding.",
+              "name": "--st-promo-banner-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -4957,6 +5009,10 @@
             {
               "description": "Overrides the background colour picked by `background`.",
               "name": "--st-section-bg"
+            },
+            {
+              "description": "Overrides the left/right padding (not with `width=\"full\"`).",
+              "name": "--st-section-padding-inline"
             }
           ],
           "cssParts": [
@@ -5389,8 +5445,14 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Responsive grid of headline numbers with a label and optional description. Port of React `Stats`.",
+          "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",
@@ -5456,6 +5518,12 @@
           "kind": "class",
           "description": "Section heading plus customer quotes or stories. Port of React `Testimonials`.\n\nEach card shows whatever its item has: a cover image, the customer logo, a story headline, a\nquote with star rating, result metrics, the author and a \"See full story\" link. `layout=\"grid\"`\n(default) lays the cards out in a grid; `layout=\"carousel\"` puts them on one horizontally\nscrolling, snapping row with previous/next buttons next to the heading — the customer-story\ncarousel of enterprise marketing pages. `action-label`/`action-href` add a section-level link\n(e.g. \"Explore customer stories\").",
           "name": "Testimonials",
+          "cssProperties": [
+            {
+              "description": "Overrides the section's padding.",
+              "name": "--st-testimonials-padding"
+            }
+          ],
           "members": [
             {
               "kind": "field",