@sankhyatronics/sankhya-cms 0.1.7 → 0.1.9

package/custom-elements.json

@@ -126,7 +126,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A surfaced container — content goes in the default slot. Ports `SankhyaUI`'s React `Card`\r\n(`variant`, `padding`, `elevation`, `hoverable`, `inverted`); `onClick` is just a native `click`\r\nlistener on the element. `padding` takes `none | small | medium | large` (the source's\r\n`sm|md|lg`, spelled like `paddingScaleStyles`); `elevation` takes `none | sm | md | lg`.",
+          "description": "A surfaced container — content goes in the default slot. Ports `SankhyaUI`'s React `Card`\n(`variant`, `padding`, `elevation`, `hoverable`, `inverted`); `onClick` is just a native `click`\nlistener on the element. `padding` takes `none | small | medium | large` (the source's\n`sm|md|lg`, spelled like `paddingScaleStyles`); `elevation` takes `none | sm | md | lg`.",
           "name": "Card",
           "members": [
             {
@@ -676,7 +676,7 @@
       "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.",
+          "description": "A long-form article section: centered title/subtitle, an optional featured image with caption,\nthen Markdown body text. Ports `SankhyaUI`'s React `ContentBlock`. The body comes from\n`content-src` (a Markdown URL, as in the source) or an inline `content` string (added so the\nblock works without a fetch); `content-src` wins when both are set.",
           "name": "ContentBlock",
           "cssProperties": [
             {
@@ -862,7 +862,7 @@
       "declarations": [
         {
           "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.",
+          "description": "Fixed bottom consent bar. The source read/wrote consent through a React `UserContext`; here the\nelement persists the choice itself in localStorage (`storage-key`, default the source's\n`sankhya_ui_cookie_consent`; storage errors are ignored) and renders nothing once a choice\nexists. Fires `cookie-consent-accept` / `cookie-consent-refuse` (detail `{ status }`). The\ndefault slot replaces the message text.",
           "name": "CookieConsent",
           "cssProperties": [
             {
@@ -1051,7 +1051,7 @@
       "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`).",
+          "description": "A labeled trigger + slotted dropdown panel — nav menus (typically holding an `st-menu-grid`),\naction menus, anything \"click a trigger, show content under it\". A 1:1 port of `SankhyaUI`'s\nReact `Dropdown` (`SankhyaCMS/SankhyaUI/src/components/Dropdown`): same markup\n(`.menu` > `.menu-title` + `.menu-dropdown`), sizes, 0.3s slide/fade, and behavior —\n\n- only one dropdown is open at a time (the source's `DropdownProvider`, built in here, so no\n  provider element is needed);\n- a mousedown outside, Escape, or a click inside the panel closes it;\n- an `href` trigger toggles the panel when it has content, and is a plain link when it doesn't;\n- `inline` opens the panel in the flow, the source's `.touch-device` layout.\n\nColors and the panel's surface come from the suite theme (the source left those to the\nconsumer's `className`/`itemGroupClassName` utility classes). Two source rules are left out\nbecause they break existing suite uses (`st-source-bar`'s site/library menus): the 100vw panel\nat <=768px (overflows the screen from wherever the trigger sits; the header uses `inline`\ninstead) and `overflow: hidden` on slotted children (clips their focus rings). Suite additions\nkept on top: `align`, `active`, `disabled`, `inline`, and the `dropdown-toggle` event — plus\n`mega` and `open-on-hover` for an okta.com-style mega menu (see `st-mega-menu`).",
           "name": "Dropdown",
           "cssProperties": [
             {
@@ -1090,7 +1090,7 @@
                 "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\"`.",
+              "description": "Trigger label text (source: `title`, renamed because `title` is the native tooltip\nattribute). Leave empty to show only `slot=\"icon\"`.",
               "attribute": "label"
             },
             {
@@ -1100,7 +1100,7 @@
                 "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.",
+              "description": "Renders the trigger as an `<a href>`. With panel content the click toggles the panel (as in\nthe source); with none it navigates.",
               "attribute": "href"
             },
             {
@@ -1210,7 +1210,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Opens the panel in the flow under the trigger instead of floating over the page (see the\r\nstyles). `st-header` sets this on its own menu's dropdowns while its hamburger panel shows.",
+              "description": "Opens the panel in the flow under the trigger instead of floating over the page (see the\nstyles). `st-header` sets this on its own menu's dropdowns while its hamburger panel shows.",
               "attribute": "inline",
               "reflects": true
             },
@@ -1232,7 +1232,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Mega-menu panel (okta.com style), typically holding an `st-mega-menu`: the panel spans the\r\nfull width of the nearest positioned ancestor — `st-header` — right under it, instead of\r\nhanging off the trigger. In `st-header`'s hamburger layout (`inline`) it slides in over the\r\nscreen with a Back button rather than opening as an accordion. A click inside the panel only\r\ncloses it when it lands on a link.",
+              "description": "Mega-menu panel (okta.com style), typically holding an `st-mega-menu`: the panel spans the\nfull width of the nearest positioned ancestor — `st-header` — right under it, instead of\nhanging off the trigger. In `st-header`'s hamburger layout (`inline`) it slides in over the\nscreen with a Back button rather than opening as an accordion. A click inside the panel only\ncloses it when it lands on a link.",
               "attribute": "mega",
               "reflects": true
             },
@@ -1243,7 +1243,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Styles a non-`mega` trigger like a mega one — a pill that turns solid accent while open — so\r\na plain dropdown (e.g. \"+ New\") lines up with mega triggers in the same header bar.",
+              "description": "Styles a non-`mega` trigger like a mega one — a pill that turns solid accent while open — so\na plain dropdown (e.g. \"+ New\") lines up with mega triggers in the same header bar.",
               "attribute": "bar",
               "reflects": true
             },
@@ -1387,7 +1387,7 @@
                   "text": "HTMLElement[]"
                 }
               },
-              "description": "Keyboard-reachable entries in the panel, in order: menu items (they delegate focus to their\r\nown link) plus any plain links/buttons/tabbable elements a caller slots in."
+              "description": "Keyboard-reachable entries in the panel, in order: menu items (they delegate focus to their\nown link) plus any plain links/buttons/tabbable elements a caller slots in."
             },
             {
               "kind": "method",
@@ -1406,7 +1406,7 @@
                   }
                 }
               ],
-              "description": "Moves focus into the panel once it has become visible (it is `visibility: hidden` until the\r\n`show` class lands, and hidden elements can't take focus)."
+              "description": "Moves focus into the panel once it has become visible (it is `visibility: hidden` until the\n`show` class lands, and hidden elements can't take focus)."
             },
             {
               "kind": "field",
@@ -1429,7 +1429,7 @@
               "kind": "field",
               "name": "onPanelClick",
               "privacy": "private",
-              "description": "A click anywhere inside the panel closes it, as in the source — for `mega`, only a click on a\r\nlink: a big panel has headings and gaps, and a click there shouldn't also close st-header's\r\nhamburger layer."
+              "description": "A click anywhere inside the panel closes it, as in the source — for `mega`, only a click on a\nlink: a big panel has headings and gaps, and a click there shouldn't also close st-header's\nhamburger layer."
             },
             {
               "kind": "field",
@@ -1457,7 +1457,7 @@
                 "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\"`.",
+              "description": "Trigger label text (source: `title`, renamed because `title` is the native tooltip\nattribute). Leave empty to show only `slot=\"icon\"`.",
               "fieldName": "label"
             },
             {
@@ -1466,7 +1466,7 @@
                 "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.",
+              "description": "Renders the trigger as an `<a href>`. With panel content the click toggles the panel (as in\nthe source); with none it navigates.",
               "fieldName": "href"
             },
             {
@@ -1563,7 +1563,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Opens the panel in the flow under the trigger instead of floating over the page (see the\r\nstyles). `st-header` sets this on its own menu's dropdowns while its hamburger panel shows.",
+              "description": "Opens the panel in the flow under the trigger instead of floating over the page (see the\nstyles). `st-header` sets this on its own menu's dropdowns while its hamburger panel shows.",
               "fieldName": "inline"
             },
             {
@@ -1581,7 +1581,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Mega-menu panel (okta.com style), typically holding an `st-mega-menu`: the panel spans the\r\nfull width of the nearest positioned ancestor — `st-header` — right under it, instead of\r\nhanging off the trigger. In `st-header`'s hamburger layout (`inline`) it slides in over the\r\nscreen with a Back button rather than opening as an accordion. A click inside the panel only\r\ncloses it when it lands on a link.",
+              "description": "Mega-menu panel (okta.com style), typically holding an `st-mega-menu`: the panel spans the\nfull width of the nearest positioned ancestor — `st-header` — right under it, instead of\nhanging off the trigger. In `st-header`'s hamburger layout (`inline`) it slides in over the\nscreen with a Back button rather than opening as an accordion. A click inside the panel only\ncloses it when it lands on a link.",
               "fieldName": "mega"
             },
             {
@@ -1590,7 +1590,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Styles a non-`mega` trigger like a mega one — a pill that turns solid accent while open — so\r\na plain dropdown (e.g. \"+ New\") lines up with mega triggers in the same header bar.",
+              "description": "Styles a non-`mega` trigger like a mega one — a pill that turns solid accent while open — so\na plain dropdown (e.g. \"+ New\") lines up with mega triggers in the same header bar.",
               "fieldName": "bar"
             },
             {
@@ -1843,7 +1843,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "One feature tile for `st-features-section`: optional icon, title, Markdown description and an\r\noptional \"Learn more\" link, rendered on an `st-card`. `icon` is an Iconify name (e.g.\r\n`mdi:rocket`). The link is a plain `<a>` (the source used react-router's `Link` for non-http\r\nhrefs; there is no Lit equivalent). The click is composed, so an SPA router can intercept it\r\n(e.g. via `event.composedPath()`) and navigate client-side; `http(s)` links open in a new tab.",
+          "description": "One feature tile for `st-features-section`: optional icon, title, Markdown description and an\noptional \"Learn more\" link, rendered on an `st-card`. `icon` is an Iconify name (e.g.\n`mdi:rocket`). The link is a plain `<a>` (the source used react-router's `Link` for non-http\nhrefs; there is no Lit equivalent). The click is composed, so an SPA router can intercept it\n(e.g. via `event.composedPath()`) and navigate client-side; `http(s)` links open in a new tab.",
           "name": "FeatureItem",
           "members": [
             {
@@ -1989,7 +1989,7 @@
       "declarations": [
         {
           "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.",
+          "description": "A titled grid of feature tiles. Ports `SankhyaUI`'s React `FeaturesSection`: tiles come from the\n`items` property, from slotted `st-feature-item` elements (the source's `children`), or both\n(slotted first). `columns` sets the grid width (default 2; one column below 768px). `inverted`\nis passed on to the `items` tiles; slotted tiles need their own `inverted` attribute.",
           "name": "FeaturesSection",
           "cssProperties": [
             {
@@ -2127,665 +2127,645 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/header/Header.ts",
+      "path": "src/footer/Footer.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",
+          "description": "The footer, in two layouts:\n\n- **Bar** (default): a copyright line plus an optional \"powered by\" link — what the suite's\n  authenticated apps use.\n- **Site**: when `columns`, `socialLinks`, `description` or `imageSrc` is set, the footer becomes a\n  marketing-site footer — brand (logo/company name, description, social icons), link columns and a\n  bottom bar with the copyright and \"powered by\".\n\nFires a cancelable `footer-link` event (detail `{ href }`) when an internal link is clicked.",
+          "name": "Footer",
           "members": [
             {
               "kind": "field",
-              "name": "title",
+              "name": "inverted",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "attribute": "title"
+              "default": "false",
+              "description": "Inverts the footer's color roles (light-on-dark instead of dark-on-light) — matches the\nsource component's `inverted` (from its shared `BaseProps`), same as `st-header`'s.",
+              "attribute": "inverted",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "brandImageUrl",
+              "name": "companyName",
               "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"
+              "description": "Used to build the default `copyright` line (`© {year} {companyName}`) when `copyright` isn't set explicitly.",
+              "attribute": "company-name"
             },
             {
               "kind": "field",
-              "name": "altText",
+              "name": "copyright",
               "type": {
                 "text": "string"
               },
-              "default": "'Logo'",
-              "description": "`alt` text for the brand image — matches the source component's `altText` (default `'Logo'`).",
-              "attribute": "alt-text"
+              "default": "''",
+              "description": "Overrides the default computed copyright line entirely.",
+              "attribute": "copyright"
             },
             {
               "kind": "field",
-              "name": "logoHref",
+              "name": "poweredBy",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Wraps the brand in an `<a>` when set (e.g. `/`); a plain non-link `<div>` otherwise.",
-              "attribute": "logoHref"
+              "attribute": "powered-by"
             },
             {
               "kind": "field",
-              "name": "logoTarget",
+              "name": "poweredByLink",
               "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"
+              "default": "''",
+              "attribute": "powered-by-link"
             },
             {
               "kind": "field",
-              "name": "logoClassName",
+              "name": "version",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Extra class(es) appended to the brand link/div — matches the source component's `logoClassName`.",
-              "attribute": "logo-class-name"
-            },
-            {
-              "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
+              "description": "App version, rendered as `v{version}` after the copyright line — for apps that show their own\nversion in the footer rather than the header title.",
+              "attribute": "version"
             },
             {
               "kind": "field",
-              "name": "sticky",
+              "name": "imageSrc",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "sticky",
-              "reflects": true
+              "default": "''",
+              "description": "Logo shown in the brand block (site layout).",
+              "attribute": "image-src"
             },
             {
               "kind": "field",
-              "name": "transparent",
+              "name": "description",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "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
+              "default": "''",
+              "description": "Short blurb under the logo (site layout).",
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "hideOnScroll",
+              "name": "columns",
               "type": {
-                "text": "boolean"
+                "text": "FooterColumn[]"
               },
-              "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
+              "default": "[]",
+              "description": "Link columns (site layout)."
             },
             {
               "kind": "field",
-              "name": "scrollThreshold",
+              "name": "socialLinks",
               "type": {
-                "text": "number"
+                "text": "FooterSocialLink[]"
               },
-              "default": "8",
-              "description": "Scroll distance in px after which the header counts as `scrolled`.",
-              "attribute": "scroll-threshold"
+              "default": "[]",
+              "description": "Social icon links under the description (site layout)."
             },
             {
               "kind": "field",
-              "name": "scrolled",
+              "name": "isSite",
               "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
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "scrollHidden",
+              "name": "resolvedCopyright",
               "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.",
-              "attribute": "scroll-hidden",
-              "reflects": true
+              "privacy": "private",
+              "readonly": true
             },
             {
-              "kind": "field",
-              "name": "lastScrollY",
-              "type": {
-                "text": "number"
-              },
+              "kind": "method",
+              "name": "onLinkClick",
               "privacy": "private",
-              "default": "0"
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "MouseEvent"
+                  }
+                },
+                {
+                  "name": "href",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "scrollFrame",
-              "type": {
-                "text": "number"
-              },
+              "kind": "method",
+              "name": "renderLink",
               "privacy": "private",
-              "default": "0"
+              "parameters": [
+                {
+                  "name": "link",
+                  "type": {
+                    "text": "FooterLink"
+                  }
+                }
+              ]
             },
             {
-              "kind": "field",
-              "name": "onScroll",
+              "kind": "method",
+              "name": "renderPoweredBy",
               "privacy": "private"
             },
             {
-              "kind": "field",
-              "name": "languages",
+              "kind": "method",
+              "name": "renderSite",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "inverted",
               "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": "Inverts the footer's color roles (light-on-dark instead of dark-on-light) — matches the\nsource component's `inverted` (from its shared `BaseProps`), same as `st-header`'s.",
+              "fieldName": "inverted"
             },
             {
-              "kind": "field",
-              "name": "currentLanguageCode",
+              "name": "company-name",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "current-language-code"
+              "description": "Used to build the default `copyright` line (`© {year} {companyName}`) when `copyright` isn't set explicitly.",
+              "fieldName": "companyName"
             },
             {
-              "kind": "field",
-              "name": "languageMenuLabel",
+              "name": "copyright",
               "type": {
                 "text": "string"
               },
-              "default": "'Language'",
-              "attribute": "language-menu-label"
-            },
-            {
-              "kind": "field",
-              "name": "mobileOpen",
-              "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.",
-              "attribute": "mobile-open",
-              "reflects": true
+              "default": "''",
+              "description": "Overrides the default computed copyright line entirely.",
+              "fieldName": "copyright"
             },
             {
-              "kind": "field",
-              "name": "compact",
+              "name": "powered-by",
               "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": "''",
+              "fieldName": "poweredBy"
             },
             {
-              "kind": "field",
-              "name": "languageMenuOpen",
+              "name": "powered-by-link",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "''",
+              "fieldName": "poweredByLink"
             },
             {
-              "kind": "field",
-              "name": "hasUtility",
+              "name": "version",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether `slot=\"utility\"` has content — an empty utility row (and its divider) is hidden."
+              "default": "''",
+              "description": "App version, rendered as `v{version}` after the copyright line — for apps that show their own\nversion in the footer rather than the header title.",
+              "fieldName": "version"
             },
             {
-              "kind": "field",
-              "name": "resizeObserver",
+              "name": "image-src",
               "type": {
-                "text": "ResizeObserver | undefined"
+                "text": "string"
               },
-              "privacy": "private"
+              "default": "''",
+              "description": "Logo shown in the brand block (site layout).",
+              "fieldName": "imageSrc"
             },
             {
-              "kind": "field",
-              "name": "narrowQuery",
+              "name": "description",
               "type": {
-                "text": "MediaQueryList | undefined"
+                "text": "string"
               },
-              "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."
-            },
-            {
-              "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": "number"
-              },
-              "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."
-            },
-            {
-              "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"
-                }
-              },
-              "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": "''",
+              "description": "Short blurb under the logo (site layout).",
+              "fieldName": "description"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "st-footer",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "Footer",
+          "declaration": {
+            "name": "Footer",
+            "module": "src/footer/Footer.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "st-footer",
+          "declaration": {
+            "name": "Footer",
+            "module": "src/footer/Footer.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\"`\nfor primary nav (e.g. `st-dropdown`/`st-menu-grid` mega-menus, or plain links) taking the\nmiddle, and a `slot=\"utility\"` for account/app-switcher/theme controls on the right. Ported\nfrom `SankhyaUI`'s React `Header` (a separate, unrelated marketing-site project) to this\npackage's Lit conventions and this workspace's actual needs — that source component takes an\n`imageSrc` logo with no text fallback, but none of this suite's apps has a logo image today, so\n`title` is the primary brand prop here and `brand-image-url` is optional, mirroring\n`st-app-header`'s own brand/title split (this component's slotted-menu/utility shape is a\ndeliberately different, more generic surface than `st-app-header`'s fixed nav-links/user-menu\nprops — pick whichever fits a given app's header).\n\nLayout follows the source's `Header.css`: the menu starts 4rem after the brand, the utility\ncontrols sit after a vertical divider, and below `BREAKPOINT_TABLET` (900px here; 768px in the\nsource) `menu`/`utility` collapse behind a hamburger toggle into a full-screen layer under the\ntoggle (closes on Escape or a click inside it), where the menu's `st-dropdown`s are switched to\n`inline` so they open in the flow — the same two slotted elements just get repositioned by CSS\n(`.mobile-panel`'s `display: contents` at desktop width vs. a real fixed-position box below\n`BREAKPOINT_TABLET`), rather than the slots being duplicated in the template, since a shadow\nroot can only ever assign a given light-DOM child to the *first* slot of a given name.\n\nAn optional `slot=\"brand-extra\"` sits right after the brand (e.g. an edition badge such as\n\"🇮🇳 India Edition\"); unlike `menu`/`utility` it stays in the bar at every width.\n\nAlso carries an optional built-in language switcher (`languages`/`currentLanguageCode`, fires\n`language-change`) — ported from `st-app-header`'s own implementation verbatim rather than\nrebuilt, since the source `Header`'s reference story shows an equivalent flag/language `Select`\nas a first-class header utility. Hidden entirely when `languages` has fewer than two entries.\nThis component has no translation logic itself; the consuming app owns what a language `code`\nmeans and which content it re-renders in response.",
+          "name": "Header",
+          "cssProperties": [
             {
-              "kind": "field",
-              "name": "lightDomObserver",
-              "type": {
-                "text": "MutationObserver | undefined"
-              },
-              "privacy": "private"
-            },
+              "description": "Width and height of a slotted toggle icon (default 20px, the built-in glyph's size).",
+              "name": "--st-header-toggle-icon-size"
+            }
+          ],
+          "slots": [
             {
-              "kind": "field",
-              "name": "closeOnEscape",
-              "privacy": "private"
+              "description": "Primary navigation.",
+              "name": "menu"
             },
             {
-              "kind": "field",
-              "name": "closeLanguageMenuOnOutsideClick",
-              "privacy": "private"
+              "description": "Account, app-switcher and theme controls, after the divider.",
+              "name": "utility"
             },
             {
-              "kind": "method",
-              "name": "renderLanguageMenu",
-              "privacy": "private"
+              "description": "Shown right after the brand at every width (e.g. an edition badge).",
+              "name": "brand-extra"
             },
             {
-              "kind": "method",
-              "name": "onLanguageSelect",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "code",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ]
+              "description": "Replaces the hamburger on the narrow-screen toggle (the built-in glyph when empty).",
+              "name": "menu-icon"
             },
             {
-              "kind": "method",
-              "name": "renderBrand",
-              "privacy": "private"
+              "description": "Replaces the close (X) on the toggle while the menu is open (the built-in glyph when empty).",
+              "name": "close-icon"
             }
           ],
-          "events": [
-            {
-              "name": "language-change",
-              "type": {
-                "text": "CustomEvent"
-              }
-            }
-          ],
-          "attributes": [
+          "members": [
             {
+              "kind": "field",
               "name": "title",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "title"
+              "attribute": "title"
             },
             {
-              "name": "brand-image-url",
+              "kind": "field",
+              "name": "brandImageUrl",
               "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"
+              "attribute": "brand-image-url"
             },
             {
-              "name": "alt-text",
+              "kind": "field",
+              "name": "altText",
               "type": {
                 "text": "string"
               },
               "default": "'Logo'",
               "description": "`alt` text for the brand image — matches the source component's `altText` (default `'Logo'`).",
-              "fieldName": "altText"
+              "attribute": "alt-text"
             },
             {
+              "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.",
-              "fieldName": "logoHref"
+              "attribute": "logoHref"
             },
             {
-              "name": "logo-target",
+              "kind": "field",
+              "name": "logoTarget",
               "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"
+              "attribute": "logo-target"
             },
             {
-              "name": "logo-class-name",
+              "kind": "field",
+              "name": "logoClassName",
               "type": {
                 "text": "string"
               },
               "default": "''",
               "description": "Extra class(es) appended to the brand link/div — matches the source component's `logoClassName`.",
-              "fieldName": "logoClassName"
+              "attribute": "logo-class-name"
             },
             {
+              "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`).",
-              "fieldName": "inverted"
+              "description": "Inverts the header's color roles (light-on-dark instead of dark-on-light) — matches the\nsource component's `inverted` (from its shared `BaseProps`).",
+              "attribute": "inverted",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "sticky",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "sticky"
+              "attribute": "sticky",
+              "reflects": true
             },
             {
+              "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.",
-              "fieldName": "transparent"
+              "description": "Fixes the header over the top of the page and makes it see-through, with light text\n(`--st-header-transparent-color`), until the page scrolls past `scroll-threshold` — for a\nheader laid over a dark hero. It then takes its normal background and a shadow. The page\ncontent starts under it, so the first section should leave room for the 64px bar.",
+              "attribute": "transparent",
+              "reflects": true
             },
             {
-              "name": "hide-on-scroll",
+              "kind": "field",
+              "name": "hideOnScroll",
               "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"
+              "attribute": "hide-on-scroll",
+              "reflects": true
             },
             {
-              "name": "scroll-threshold",
+              "kind": "field",
+              "name": "scrollThreshold",
               "type": {
                 "text": "number"
               },
               "default": "8",
               "description": "Scroll distance in px after which the header counts as `scrolled`.",
-              "fieldName": "scrollThreshold"
+              "attribute": "scroll-threshold"
             },
             {
+              "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.",
-              "fieldName": "scrolled"
+              "attribute": "scrolled",
+              "reflects": true
             },
             {
-              "name": "scroll-hidden",
+              "kind": "field",
+              "name": "scrollHidden",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "True while `hide-on-scroll` has slid the header away. Set by the header, never from outside.",
-              "fieldName": "scrollHidden"
+              "attribute": "scroll-hidden",
+              "reflects": true
             },
             {
-              "name": "current-language-code",
+              "kind": "field",
+              "name": "lastScrollY",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "scrollFrame",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "onScroll",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "languages",
+              "type": {
+                "text": "{ code: string; label: string }[]"
+              },
+              "default": "[]",
+              "description": "Language switcher options, e.g. `[{ code: 'en', label: 'English' }, ...]` — hidden entirely\nwhen empty or when only one language is offered (same convention as `st-app-header`'s\n`languages`, which this reuses verbatim). This component has no translation logic itself —\nselecting an option fires `language-change` (detail: `{ code }`), and the consuming app owns\nwhat `code` actually means and which content it re-renders."
+            },
+            {
+              "kind": "field",
+              "name": "currentLanguageCode",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "currentLanguageCode"
+              "attribute": "current-language-code"
             },
             {
-              "name": "language-menu-label",
+              "kind": "field",
+              "name": "languageMenuLabel",
               "type": {
                 "text": "string"
               },
               "default": "'Language'",
-              "fieldName": "languageMenuLabel"
+              "attribute": "language-menu-label"
             },
             {
-              "name": "mobile-open",
+              "kind": "field",
+              "name": "mobileOpen",
               "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"
+              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\noutside.",
+              "attribute": "mobile-open",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "compact",
               "type": {
                 "text": "boolean"
               },
               "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/footer/Footer.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "The footer, in two layouts:\r\n\r\n- **Bar** (default): a copyright line plus an optional \"powered by\" link — what the suite's\r\n  authenticated apps use.\r\n- **Site**: when `columns`, `socialLinks`, `description` or `imageSrc` is set, the footer becomes a\r\n  marketing-site footer — brand (logo/company name, description, social icons), link columns and a\r\n  bottom bar with the copyright and \"powered by\".\r\n\r\nFires a cancelable `footer-link` event (detail `{ href }`) when an internal link is clicked.",
-          "name": "Footer",
-          "members": [
+              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
+              "attribute": "compact",
+              "reflects": true
+            },
             {
               "kind": "field",
-              "name": "inverted",
+              "name": "languageMenuOpen",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "description": "Inverts the footer's color roles (light-on-dark instead of dark-on-light) — matches the\r\nsource component's `inverted` (from its shared `BaseProps`), same as `st-header`'s.",
-              "attribute": "inverted",
-              "reflects": true
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "companyName",
+              "name": "hasUtility",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Used to build the default `copyright` line (`© {year} {companyName}`) when `copyright` isn't set explicitly.",
-              "attribute": "company-name"
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether `slot=\"utility\"` has content — an empty utility row (and its divider) is hidden."
             },
             {
               "kind": "field",
-              "name": "copyright",
+              "name": "hasBrandExtra",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Overrides the default computed copyright line entirely.",
-              "attribute": "copyright"
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether `slot=\"brand-extra\"` has content — an empty one takes no room beside the brand."
             },
             {
               "kind": "field",
-              "name": "poweredBy",
+              "name": "resizeObserver",
               "type": {
-                "text": "string"
+                "text": "ResizeObserver | undefined"
               },
-              "default": "''",
-              "attribute": "powered-by"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "poweredByLink",
+              "name": "narrowQuery",
               "type": {
-                "text": "string"
+                "text": "MediaQueryList | undefined"
               },
-              "default": "''",
-              "attribute": "powered-by-link"
+              "privacy": "private",
+              "description": "Matches below BREAKPOINT_TABLET, where the hamburger layout is always on."
             },
             {
               "kind": "field",
-              "name": "version",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "App version, rendered as `v{version}` after the copyright line — for apps that show their own\r\nversion in the footer rather than the header title.",
-              "attribute": "version"
+              "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\nown `inline` setting is left alone."
             },
             {
               "kind": "field",
-              "name": "imageSrc",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Logo shown in the brand block (site layout).",
-              "attribute": "image-src"
+              "name": "syncInlineDropdowns",
+              "privacy": "private",
+              "description": "While the hamburger layout is on, the dropdowns in the header open in the flow of the\nfull-screen panel instead of floating over it (SankhyaUI's touch-device layout)."
             },
             {
               "kind": "field",
-              "name": "description",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "description": "Short blurb under the logo (site layout).",
-              "attribute": "description"
+              "name": "onBrandExtraSlotChange",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "columns",
-              "type": {
-                "text": "FooterColumn[]"
-              },
-              "default": "[]",
-              "description": "Link columns (site layout)."
+              "name": "onUtilitySlotChange",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "socialLinks",
-              "type": {
-                "text": "FooterSocialLink[]"
-              },
-              "default": "[]",
-              "description": "Social icon links under the description (site layout)."
+              "name": "onMenuSlotChange",
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "isSite",
+              "name": "collapsedAtWidth",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
               "privacy": "private",
-              "readonly": true
+              "default": "0",
+              "description": "The bar width at which the menu last overflowed — the bar only expands again once it is\nclearly wider than this, so it can't flip back and forth right at the threshold."
             },
             {
               "kind": "field",
-              "name": "resolvedCopyright",
+              "name": "evaluateFit",
+              "privacy": "private",
+              "description": "Collapses to the hamburger layout when the slotted menu overflows its row, and expands again\nonce there is room. The collapsed layout hides the menu, so the room it needs can't be\nmeasured then; the width remembered when it collapsed stands in for it."
+            },
+            {
+              "kind": "method",
+              "name": "menuOverflows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Whether the visible menu items reach past the right edge of the menu row. Measured from the\nitems' own boxes (the slotted elements and their direct children), not the row's scrollWidth:\na closed dropdown's absolutely positioned panel also counts towards scrollWidth, which would\nreport overflow at any width."
+            },
+            {
+              "kind": "field",
+              "name": "lightDomObserver",
               "type": {
-                "text": "string"
+                "text": "MutationObserver | undefined"
               },
-              "privacy": "private",
-              "readonly": true
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "closeOnEscape",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "closeLanguageMenuOnOutsideClick",
+              "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "onLinkClick",
+              "name": "renderLanguageMenu",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "onLanguageSelect",
               "privacy": "private",
               "return": {
                 "type": {
@@ -2794,13 +2774,7 @@
               },
               "parameters": [
                 {
-                  "name": "event",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                },
-                {
-                  "name": "href",
+                  "name": "code",
                   "type": {
                     "text": "string"
                   }
@@ -2809,123 +2783,192 @@
             },
             {
               "kind": "method",
-              "name": "renderLink",
-              "privacy": "private",
-              "parameters": [
-                {
-                  "name": "link",
-                  "type": {
-                    "text": "FooterLink"
-                  }
-                }
-              ]
+              "name": "renderBrand",
+              "privacy": "private"
+            }
+          ],
+          "events": [
+            {
+              "name": "language-change",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "title"
+            },
+            {
+              "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).",
+              "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"
+            },
+            {
+              "name": "logoHref",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Wraps the brand in an `<a>` when set (e.g. `/`); a plain non-link `<div>` otherwise.",
+              "fieldName": "logoHref"
             },
             {
-              "kind": "method",
-              "name": "renderPoweredBy",
-              "privacy": "private"
+              "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.",
+              "fieldName": "logoTarget"
             },
             {
-              "kind": "method",
-              "name": "renderSite",
-              "privacy": "private"
-            }
-          ],
-          "attributes": [
+              "name": "logo-class-name",
+              "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 footer's color roles (light-on-dark instead of dark-on-light) — matches the\r\nsource component's `inverted` (from its shared `BaseProps`), same as `st-header`'s.",
+              "description": "Inverts the header's color roles (light-on-dark instead of dark-on-light) — matches the\nsource component's `inverted` (from its shared `BaseProps`).",
               "fieldName": "inverted"
             },
             {
-              "name": "company-name",
+              "name": "sticky",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Used to build the default `copyright` line (`© {year} {companyName}`) when `copyright` isn't set explicitly.",
-              "fieldName": "companyName"
+              "default": "false",
+              "fieldName": "sticky"
             },
             {
-              "name": "copyright",
+              "name": "transparent",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Overrides the default computed copyright line entirely.",
-              "fieldName": "copyright"
+              "default": "false",
+              "description": "Fixes the header over the top of the page and makes it see-through, with light text\n(`--st-header-transparent-color`), until the page scrolls past `scroll-threshold` — for a\nheader laid over a dark hero. It then takes its normal background and a shadow. The page\ncontent starts under it, so the first section should leave room for the 64px bar.",
+              "fieldName": "transparent"
             },
             {
-              "name": "powered-by",
+              "name": "hide-on-scroll",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "fieldName": "poweredBy"
+              "default": "false",
+              "description": "Slides the header out of view while the page scrolls down and back in when it scrolls up.",
+              "fieldName": "hideOnScroll"
             },
             {
-              "name": "powered-by-link",
+              "name": "scroll-threshold",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "default": "''",
-              "fieldName": "poweredByLink"
+              "default": "8",
+              "description": "Scroll distance in px after which the header counts as `scrolled`.",
+              "fieldName": "scrollThreshold"
             },
             {
-              "name": "version",
+              "name": "scrolled",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "App version, rendered as `v{version}` after the copyright line — for apps that show their own\r\nversion in the footer rather than the header title.",
-              "fieldName": "version"
+              "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"
             },
             {
-              "name": "image-src",
+              "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.",
+              "fieldName": "scrollHidden"
+            },
+            {
+              "name": "current-language-code",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Logo shown in the brand block (site layout).",
-              "fieldName": "imageSrc"
+              "fieldName": "currentLanguageCode"
             },
             {
-              "name": "description",
+              "name": "language-menu-label",
               "type": {
                 "text": "string"
               },
-              "default": "''",
-              "description": "Short blurb under the logo (site layout).",
-              "fieldName": "description"
+              "default": "'Language'",
+              "fieldName": "languageMenuLabel"
+            },
+            {
+              "name": "mobile-open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Internal open/closed state for the mobile nav overlay, reflected to an attribute purely so\nthe `:host([mobile-open])` CSS selector above can react to it — not meant to be set from\noutside.",
+              "fieldName": "mobileOpen"
+            },
+            {
+              "name": "compact",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "True while the menu doesn't fit the bar at the current width: the header then shows the same\nhamburger layout it uses on a narrow screen. Set by `evaluateFit`, never from outside.",
+              "fieldName": "compact"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "st-footer",
+          "tagName": "st-header",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "Footer",
+          "name": "Header",
           "declaration": {
-            "name": "Footer",
-            "module": "src/footer/Footer.ts"
+            "name": "Header",
+            "module": "src/header/Header.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-footer",
+          "name": "st-header",
           "declaration": {
-            "name": "Footer",
-            "module": "src/footer/Footer.ts"
+            "name": "Header",
+            "module": "src/header/Header.ts"
           }
         }
       ]
@@ -2936,7 +2979,7 @@
       "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.",
+          "description": "Full-width hero banner: background image with a darkening overlay, optional eyebrow, title,\noptional subtitle and up to two call-to-action links. Port of `SankhyaUI`'s React `Hero`; the\nframer-motion entrance is redone as CSS keyframes (skipped under `prefers-reduced-motion`).\n\n`size`, `content-position` and `overlay=\"gradient\"` give the large editorial layout (copy on the\nlower left over a gradient that darkens towards it) used by enterprise marketing heroes; the\ndefaults keep the original centered banner. Put several heroes in an `st-carousel` with\n`indicator-style=\"tabs\"` for a tabbed hero carousel.",
           "name": "Hero",
           "cssProperties": [
             {
@@ -3112,7 +3155,7 @@
               "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  }"
+                "text": "{\n    top: 'center top',\n    left: 'left center',\n    right: 'right center',\n    bottom: 'center bottom',\n    center: 'center center'\n  }"
               }
             },
             {
@@ -3322,7 +3365,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A small, icon-only action button — ported from `SankhyaUI`'s React `IconButton` (a separate,\r\nunrelated marketing-site project; that source takes an iconify string `icon` prop, this package\r\nhas no iconify dependency, so the icon is default-slotted content instead, same convention as\r\n`st-dropdown`/`st-menu-grid-item`'s `slot=\"icon\"`).\r\n\r\nFires a plain native `click` — no custom event, since a caller just wants an ordinary button.",
+          "description": "A small, icon-only action button — ported from `SankhyaUI`'s React `IconButton` (a separate,\nunrelated marketing-site project; that source takes an iconify string `icon` prop, this package\nhas no iconify dependency, so the icon is default-slotted content instead, same convention as\n`st-dropdown`/`st-menu-grid-item`'s `slot=\"icon\"`).\n\nFires a plain native `click` — no custom event, since a caller just wants an ordinary button.",
           "name": "IconButton",
           "members": [
             {
@@ -3332,7 +3375,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible name and tooltip — matches the source component's `ariaLabel` (renamed: modern\r\nbrowsers already expose a native `ariaLabel` reflected property on every `Element`, so reusing\r\nthat exact name as a Lit reactive property would shadow it). Required for a control with no\r\nvisible text.",
+              "description": "Accessible name and tooltip — matches the source component's `ariaLabel` (renamed: modern\nbrowsers already expose a native `ariaLabel` reflected property on every `Element`, so reusing\nthat exact name as a Lit reactive property would shadow it). Required for a control with no\nvisible text.",
               "attribute": "label"
             },
             {
@@ -3353,7 +3396,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible name and tooltip — matches the source component's `ariaLabel` (renamed: modern\r\nbrowsers already expose a native `ariaLabel` reflected property on every `Element`, so reusing\r\nthat exact name as a Lit reactive property would shadow it). Required for a control with no\r\nvisible text.",
+              "description": "Accessible name and tooltip — matches the source component's `ariaLabel` (renamed: modern\nbrowsers already expose a native `ariaLabel` reflected property on every `Element`, so reusing\nthat exact name as a Lit reactive property would shadow it). Required for a control with no\nvisible text.",
               "fieldName": "label"
             },
             {
@@ -3529,7 +3572,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Renders Markdown (GFM, single newlines become `<br>`) from either an inline `content` string or\r\na `src` URL it fetches. Ports `SankhyaUI`'s `useMarkdown` hook + `react-markdown` (remark-gfm,\r\nremark-breaks); output is sanitized with DOMPurify. `src` wins over `content` when both are set.\r\nWhile a fetch is pending it shows \"Loading content...\"; on failure \"Error loading content.\" and\r\na `markdown-error` event (detail: `{ error }`).\r\n\r\nText color is inherited from the parent so inverted containers just work.",
+          "description": "Renders Markdown (GFM, single newlines become `<br>`) from either an inline `content` string or\na `src` URL it fetches. Ports `SankhyaUI`'s `useMarkdown` hook + `react-markdown` (remark-gfm,\nremark-breaks); output is sanitized with DOMPurify. `src` wins over `content` when both are set.\nWhile a fetch is pending it shows \"Loading content...\"; on failure \"Error loading content.\" and\na `markdown-error` event (detail: `{ error }`).\n\nText color is inherited from the parent so inverted containers just work.",
           "name": "Markdown",
           "members": [
             {
@@ -4375,7 +4418,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A responsive grid of `st-menu-grid-item`s — the \"rich\" nav-menu layout (icon + title +\r\ndescription per entry, arranged in columns), typically slotted into `st-dropdown`'s default\r\nslot. A 1:1 port of `SankhyaUI`'s React `MenuGrid` (`SankhyaCMS/SankhyaUI/src/components/Menu`):\r\nsame markup (`.menu-grid-container` > `.menu-grid.columns-N`), gap and breakpoints (768px: 2–4\r\ncolumns → 2; 480px: everything → 1; a 1-column grid stays 1).",
+          "description": "A responsive grid of `st-menu-grid-item`s — the \"rich\" nav-menu layout (icon + title +\ndescription per entry, arranged in columns), typically slotted into `st-dropdown`'s default\nslot. A 1:1 port of `SankhyaUI`'s React `MenuGrid` (`SankhyaCMS/SankhyaUI/src/components/Menu`):\nsame markup (`.menu-grid-container` > `.menu-grid.columns-N`), gap and breakpoints (768px: 2–4\ncolumns → 2; 480px: everything → 1; a 1-column grid stays 1).",
           "name": "MenuGrid",
           "members": [
             {
@@ -4395,7 +4438,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Extra class(es) appended to the inner grid element — the source component's `gridClassName`.\r\nIts outer `className` is the host element itself here: set a `class` attribute on `st-menu-grid`.",
+              "description": "Extra class(es) appended to the inner grid element — the source component's `gridClassName`.\nIts outer `className` is the host element itself here: set a `class` attribute on `st-menu-grid`.",
               "attribute": "grid-class-name"
             }
           ],
@@ -4415,7 +4458,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Extra class(es) appended to the inner grid element — the source component's `gridClassName`.\r\nIts outer `className` is the host element itself here: set a `class` attribute on `st-menu-grid`.",
+              "description": "Extra class(es) appended to the inner grid element — the source component's `gridClassName`.\nIts outer `className` is the host element itself here: set a `class` attribute on `st-menu-grid`.",
               "fieldName": "gridClassName"
             }
           ],
@@ -4448,12 +4491,12 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/menu-item/MenuItem.ts",
+      "path": "src/menu-grid-item/MenuGridItem.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",
+          "description": "One entry in an `st-menu-grid` — icon (via `slot=\"icon\"`) + title on one line, an optional\ndescription below, and an optional corner badge (\"New\", \"Popular\", ...). A 1:1 port of\n`SankhyaUI`'s React `MenuGridItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same markup and\nCSS, with its `motion` effects redone in CSS — fades up the first time it scrolls into view,\nscales to 1.02 on hover / 0.98 while pressed, the icon tilts on hover, the badge pops in.\nColors come from the suite theme rather than per-item utility classes.\n\nAn `http(s)` `href` opens in a new tab, like the source. Any other `href` fires a *cancelable*\n`menu-grid-item-select` event (detail: `{ href }`) first: a host doing client-side routing calls\n`event.preventDefault()` on it, which also cancels the anchor's own navigation (the source used\nreact-router's `Link` here; the suite apps have no router).",
+          "name": "MenuGridItem",
           "members": [
             {
               "kind": "field",
@@ -4476,21 +4519,21 @@
             },
             {
               "kind": "field",
-              "name": "href",
+              "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "href"
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "attribute": "description"
+              "attribute": "href"
             },
             {
               "kind": "field",
@@ -4499,20 +4542,9 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
+              "description": "Small corner label, e.g. \"New\"/\"Beta\" — omit for none.",
               "attribute": "badge"
             },
-            {
-              "kind": "field",
-              "name": "active",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Highlights this row as the current page (source: `isActive`).",
-              "attribute": "active",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "compact",
@@ -4535,40 +4567,46 @@
             },
             {
               "kind": "field",
-              "name": "target",
+              "name": "hasIcon",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "'_self'",
-              "description": "`target` for the `<a>` (source default `_self`).",
-              "attribute": "target"
+              "privacy": "private",
+              "default": "false",
+              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
             },
             {
               "kind": "field",
-              "name": "variant",
+              "name": "pending",
               "type": {
-                "text": "'default' | 'link' | 'bar'"
+                "text": "boolean"
               },
-              "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
+              "privacy": "private",
+              "default": "true",
+              "description": "True until the item first scrolls into view (the source's `whileInView ... once`)."
             },
             {
               "kind": "field",
-              "name": "hasIcon",
+              "name": "observer",
               "type": {
-                "text": "boolean"
+                "text": "IntersectionObserver | undefined"
               },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
+              "privacy": "private"
             },
             {
               "kind": "field",
               "name": "onIconSlotChange",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "isExternal",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "onClick",
@@ -4585,20 +4623,20 @@
               "fieldName": "title"
             },
             {
-              "name": "href",
+              "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "href"
+              "fieldName": "description"
             },
             {
-              "name": "description",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "description"
+              "fieldName": "href"
             },
             {
               "name": "badge",
@@ -4606,18 +4644,9 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
+              "description": "Small corner label, e.g. \"New\"/\"Beta\" — omit for none.",
               "fieldName": "badge"
             },
-            {
-              "name": "active",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Highlights this row as the current page (source: `isActive`).",
-              "fieldName": "active"
-            },
             {
               "name": "compact",
               "type": {
@@ -4634,61 +4663,55 @@
               "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-menu-item",
+          "tagName": "st-menu-grid-item",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "MenuItem",
+          "name": "MenuGridItem",
           "declaration": {
-            "name": "MenuItem",
-            "module": "src/menu-item/MenuItem.ts"
+            "name": "MenuGridItem",
+            "module": "src/menu-grid-item/MenuGridItem.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-menu-item",
+          "name": "st-menu-grid-item",
           "declaration": {
-            "name": "MenuItem",
-            "module": "src/menu-item/MenuItem.ts"
+            "name": "MenuGridItem",
+            "module": "src/menu-grid-item/MenuGridItem.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/menu-grid-item/MenuGridItem.ts",
+      "path": "src/menu-item/MenuItem.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "One entry in an `st-menu-grid` — icon (via `slot=\"icon\"`) + title on one line, an optional\r\ndescription below, and an optional corner badge (\"New\", \"Popular\", ...). A 1:1 port of\r\n`SankhyaUI`'s React `MenuGridItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same markup and\r\nCSS, with its `motion` effects redone in CSS — fades up the first time it scrolls into view,\r\nscales to 1.02 on hover / 0.98 while pressed, the icon tilts on hover, the badge pops in.\r\nColors come from the suite theme rather than per-item utility classes.\r\n\r\nAn `http(s)` `href` opens in a new tab, like the source. Any other `href` fires a *cancelable*\r\n`menu-grid-item-select` event (detail: `{ href }`) first: a host doing client-side routing calls\r\n`event.preventDefault()` on it, which also cancels the anchor's own navigation (the source used\r\nreact-router's `Link` here; the suite apps have no router).",
-          "name": "MenuGridItem",
+          "description": "A single flat nav row — icon (`slot=\"icon\"`) + title + badge on one line, an optional\ndescription below — as opposed to `st-menu-grid-item`'s card for a multi-column grid. A 1:1\nport of `SankhyaUI`'s React `MenuItem` (`SankhyaCMS/SankhyaUI/src/components/Menu`): same\nmarkup and CSS, with its `motion` effects redone in CSS — nudges right and scales to 1.01 on\nhover / 0.99 while pressed, the icon tilts on hover, the badge pops in, the description fades\nin. Colors come from the suite theme rather than per-item utility classes.\n\nRenders a real `<a href>` but fires a *cancelable* `menu-item-select` event (detail: `{ href }`)\nbefore navigating — a host doing client-side routing calls `event.preventDefault()` on it (the\nsource used react-router's `Link` here; the suite apps have no router).",
+          "name": "MenuItem",
+          "cssProperties": [
+            {
+              "description": "Width and height of the slotted icon; `icon-size` sets it.",
+              "name": "--st-menu-item-icon-size"
+            }
+          ],
+          "slots": [
+            {
+              "description": "The row's icon, sized to `icon-size` (16px, or 14px when `compact`).",
+              "name": "icon"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -4709,6 +4732,15 @@
               "default": "''",
               "attribute": "title"
             },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "href"
+            },
             {
               "kind": "field",
               "name": "description",
@@ -4720,22 +4752,24 @@
             },
             {
               "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": "badge",
+              "name": "active",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "Small corner label, e.g. \"New\"/\"Beta\" — omit for none.",
-              "attribute": "badge"
+              "default": "false",
+              "description": "Highlights this row as the current page (source: `isActive`).",
+              "attribute": "active",
+              "reflects": true
             },
             {
               "kind": "field",
@@ -4759,45 +4793,49 @@
             },
             {
               "kind": "field",
-              "name": "hasIcon",
+              "name": "target",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "privacy": "private",
-              "default": "false",
-              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
+              "default": "'_self'",
+              "description": "`target` for the `<a>` (source default `_self`).",
+              "attribute": "target"
             },
             {
               "kind": "field",
-              "name": "pending",
+              "name": "variant",
               "type": {
-                "text": "boolean"
+                "text": "'default' | 'link' | 'bar'"
               },
-              "privacy": "private",
-              "default": "true",
-              "description": "True until the item first scrolls into view (the source's `whileInView ... once`)."
+              "default": "'default'",
+              "description": "`default` (a row with a hover box), `link` (a plain text link, as in `st-mega-menu-column`;\nmarked with an arrow when it opens a new tab) or `bar` (a top-level item in a header bar,\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": "observer",
+              "name": "iconSize",
               "type": {
-                "text": "IntersectionObserver | undefined"
+                "text": "string"
               },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "onIconSlotChange",
-              "privacy": "private"
+              "default": "''",
+              "description": "Size of the slotted icon, any CSS length (e.g. `36px`); empty keeps 16px (14px when `compact`).",
+              "attribute": "icon-size"
             },
             {
               "kind": "field",
-              "name": "isExternal",
+              "name": "hasIcon",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "readonly": true
+              "default": "false",
+              "description": "Whether `slot=\"icon\"` has content, so an omitted icon leaves no empty box."
+            },
+            {
+              "kind": "field",
+              "name": "onIconSlotChange",
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -4815,20 +4853,20 @@
               "fieldName": "title"
             },
             {
-              "name": "description",
+              "name": "href",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "description"
+              "fieldName": "href"
             },
             {
-              "name": "href",
+              "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "href"
+              "fieldName": "description"
             },
             {
               "name": "badge",
@@ -4836,9 +4874,18 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Small corner label, e.g. \"New\"/\"Beta\" — omit for none.",
+              "description": "Small trailing label, e.g. a count or \"New\"/\"Beta\" — omit for none.",
               "fieldName": "badge"
             },
+            {
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Highlights this row as the current page (source: `isActive`).",
+              "fieldName": "active"
+            },
             {
               "name": "compact",
               "type": {
@@ -4855,31 +4902,58 @@
               "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`;\nmarked with an arrow when it opens a new tab) or `bar` (a top-level item in a header bar,\nshaped like a mega `st-dropdown`'s trigger pill so it lines up with the dropdowns beside it).",
+              "fieldName": "variant"
+            },
+            {
+              "name": "icon-size",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Size of the slotted icon, any CSS length (e.g. `36px`); empty keeps 16px (14px when `compact`).",
+              "fieldName": "iconSize"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "st-menu-grid-item",
+          "tagName": "st-menu-item",
           "customElement": true
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "MenuGridItem",
+          "name": "MenuItem",
           "declaration": {
-            "name": "MenuGridItem",
-            "module": "src/menu-grid-item/MenuGridItem.ts"
+            "name": "MenuItem",
+            "module": "src/menu-item/MenuItem.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "st-menu-grid-item",
+          "name": "st-menu-item",
           "declaration": {
-            "name": "MenuGridItem",
-            "module": "src/menu-grid-item/MenuGridItem.ts"
+            "name": "MenuItem",
+            "module": "src/menu-item/MenuItem.ts"
           }
         }
       ]
@@ -4890,7 +4964,7 @@
       "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`.",
+          "description": "Rounded call-to-action banner (title, subtitle, one outlined button) on a dark panel or a\nbackground image. Port of `SankhyaUI`'s React `PromoBanner`; the button fires an `action` event\n(detail `{ href }`, empty unless set) in place of `onAction`.",
           "name": "PromoBanner",
           "cssProperties": [
             {
@@ -5263,7 +5337,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A fully custom-styled replacement for native `<select>`, used everywhere\r\nthe wizard needs a single-choice dropdown (template source, list, document\r\nlibrary, admin roles, ...).\r\n\r\nBuilt on the CSS Customizable Select API (`appearance: base-select`) —\r\nstill a real `<select>`/`<option>` element tree, so focus, keyboard\r\n(arrows/Home/End/typeahead), and ARIA all come from the browser for free,\r\nbut the trigger (`<button>`/`<selectedcontent>`) and popup\r\n(`::picker(select)`) are fully styleable instead of OS-rendered. Chromium\r\nonly for now (Firefox/Safari fall back to an unstyled native `<select>` —\r\nthe extra `<button>`/`<selectedcontent>` markup is simply not rendered by\r\nbrowsers that don't support the parsing/CSS additions, so the control\r\nstill works there, just without the custom look).\r\n\r\n`options` intentionally has no \"unselected\" placeholder entry — set\r\n`value=\"\"` (or any value with no matching option) and it falls back to\r\nshowing `placeholder` in the trigger instead, letting callers swap the\r\nplaceholder text dynamically (e.g. \"Select a list\" vs \"Select a list\r\nfirst\") without needing a synthetic option in the list. Internally this is\r\na real hidden/disabled `<option value=\"\">`, since a native `<select>`\r\nalways has *some* option selected.\r\n\r\nFires `select-change` (detail: `{ value }`) only when the value actually\r\nchanges, matching native `<select>`'s `change` event semantics.\r\n\r\n`link-href` optionally renders an external-link button in front of\r\n`field-label` — the same glyph/placement as the \"open library\" links\r\nplaced next to the Templates/Save-location breadcrumbs — for callers that\r\nwant a one-click way to open whatever the current selection points at\r\n(e.g. the SharePoint site or library) in a new tab.",
+          "description": "A fully custom-styled replacement for native `<select>`, used everywhere\nthe wizard needs a single-choice dropdown (template source, list, document\nlibrary, admin roles, ...).\n\nBuilt on the CSS Customizable Select API (`appearance: base-select`) —\nstill a real `<select>`/`<option>` element tree, so focus, keyboard\n(arrows/Home/End/typeahead), and ARIA all come from the browser for free,\nbut the trigger (`<button>`/`<selectedcontent>`) and popup\n(`::picker(select)`) are fully styleable instead of OS-rendered. Chromium\nonly for now (Firefox/Safari fall back to an unstyled native `<select>` —\nthe extra `<button>`/`<selectedcontent>` markup is simply not rendered by\nbrowsers that don't support the parsing/CSS additions, so the control\nstill works there, just without the custom look).\n\n`options` intentionally has no \"unselected\" placeholder entry — set\n`value=\"\"` (or any value with no matching option) and it falls back to\nshowing `placeholder` in the trigger instead, letting callers swap the\nplaceholder text dynamically (e.g. \"Select a list\" vs \"Select a list\nfirst\") without needing a synthetic option in the list. Internally this is\na real hidden/disabled `<option value=\"\">`, since a native `<select>`\nalways has *some* option selected.\n\nFires `select-change` (detail: `{ value }`) only when the value actually\nchanges, matching native `<select>`'s `change` event semantics.\n\n`link-href` optionally renders an external-link button in front of\n`field-label` — the same glyph/placement as the \"open library\" links\nplaced next to the Templates/Save-location breadcrumbs — for callers that\nwant a one-click way to open whatever the current selection points at\n(e.g. the SharePoint site or library) in a new tab.",
           "name": "Select",
           "members": [
             {
@@ -5309,7 +5383,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Optional URL for an external-link button rendered in front of\r\n`field-label` (same glyph/placement as the \"open library\" links next to\r\nthe Templates/Save-location breadcrumbs) — e.g. a link to the\r\nSharePoint site or library the current selection points at. Ignored\r\nwhen `field-label` is empty, since there'd be nothing to place it in\r\nfront of.",
+              "description": "Optional URL for an external-link button rendered in front of\n`field-label` (same glyph/placement as the \"open library\" links next to\nthe Templates/Save-location breadcrumbs) — e.g. a link to the\nSharePoint site or library the current selection points at. Ignored\nwhen `field-label` is empty, since there'd be nothing to place it in\nfront of.",
               "attribute": "link-href"
             },
             {
@@ -5417,7 +5491,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Optional URL for an external-link button rendered in front of\r\n`field-label` (same glyph/placement as the \"open library\" links next to\r\nthe Templates/Save-location breadcrumbs) — e.g. a link to the\r\nSharePoint site or library the current selection points at. Ignored\r\nwhen `field-label` is empty, since there'd be nothing to place it in\r\nfront of.",
+              "description": "Optional URL for an external-link button rendered in front of\n`field-label` (same glyph/placement as the \"open library\" links next to\nthe Templates/Save-location breadcrumbs) — e.g. a link to the\nSharePoint site or library the current selection points at. Ignored\nwhen `field-label` is empty, since there'd be nothing to place it in\nfront of.",
               "fieldName": "linkHref"
             },
             {
@@ -5483,6 +5557,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`.\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",
@@ -5794,77 +5939,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"
-          }
-        }
-      ]
     }
   ]
 }