@godxjp/ui 28.7.0 → 28.8.0

package/dist/styles/text-layout.css

@@ -27,6 +27,22 @@
     font-size: var(--font-size-2xl);
   }
 
+  [data-slot="text"][data-size="3xl"],
+  [data-slot="text"][data-size="4xl"],
+  [data-slot="text"][data-size="5xl"] {
+    line-height: var(--line-height-tight);
+    letter-spacing: var(--letter-spacing-tight);
+  }
+  [data-slot="text"][data-size="3xl"] {
+    font-size: var(--font-size-3xl);
+  }
+  [data-slot="text"][data-size="4xl"] {
+    font-size: var(--font-size-4xl);
+  }
+  [data-slot="text"][data-size="5xl"] {
+    font-size: var(--font-size-5xl);
+  }
+
   [data-slot="text"][data-weight="regular"],
   [data-slot="heading"][data-weight="regular"] {
     font-weight: var(--font-weight-normal);
@@ -154,18 +170,50 @@
     letter-spacing: var(--letter-spacing-tight);
     line-height: var(--line-height-tight);
   }
-  [data-slot="heading"][data-level="1"] {
+
+  [data-slot="heading"][data-level="1"]:not([data-size]) {
     font-size: var(--heading-h1);
   }
-  [data-slot="heading"][data-level="2"] {
+  [data-slot="heading"][data-level="2"]:not([data-size]) {
     font-size: var(--heading-h2);
   }
-  [data-slot="heading"][data-level="3"] {
+  [data-slot="heading"][data-level="3"]:not([data-size]) {
     font-size: var(--heading-h3);
   }
-  [data-slot="heading"][data-level="4"] {
+  [data-slot="heading"][data-level="4"]:not([data-size]) {
     font-size: var(--heading-h4);
   }
+
+  [data-slot="heading"][data-size="2xs"] {
+    font-size: var(--font-size-2xs);
+  }
+  [data-slot="heading"][data-size="xs"] {
+    font-size: var(--font-size-xs);
+  }
+  [data-slot="heading"][data-size="sm"] {
+    font-size: var(--font-size-sm);
+  }
+  [data-slot="heading"][data-size="md"] {
+    font-size: var(--font-size-base);
+  }
+  [data-slot="heading"][data-size="lg"] {
+    font-size: var(--font-size-lg);
+  }
+  [data-slot="heading"][data-size="xl"] {
+    font-size: var(--font-size-xl);
+  }
+  [data-slot="heading"][data-size="2xl"] {
+    font-size: var(--font-size-2xl);
+  }
+  [data-slot="heading"][data-size="3xl"] {
+    font-size: var(--font-size-3xl);
+  }
+  [data-slot="heading"][data-size="4xl"] {
+    font-size: var(--font-size-4xl);
+  }
+  [data-slot="heading"][data-size="5xl"] {
+    font-size: var(--font-size-5xl);
+  }
 }
 
 @layer components {

package/dist/tokens/base.css

@@ -44,3 +44,8 @@
 @import "./components/conversations.css";
 @import "./components/float-button.css";
 @import "./components/draggable-panel.css";
+@import "./components/masonry.css";
+@import "./components/mega-menu.css";
+@import "./components/marquee.css";
+@import "./components/affix.css";
+@import "./components/anchor.css";

package/dist/tokens/components/affix.css

@@ -0,0 +1,7 @@
+
+:root {
+
+  --affix-inset-block-start: 0px;
+
+  --affix-inset-block-end: 0px;
+}

package/dist/tokens/components/anchor.css

@@ -0,0 +1,17 @@
+
+:root {
+
+  --anchor-ink-width: 2px;
+
+  --anchor-ink-color: initial;
+
+  --anchor-track-color: initial;
+
+  --anchor-item-padding-block: var(--space-1);
+
+  --anchor-item-padding-inline: var(--space-3);
+
+  --anchor-nested-padding-inline: var(--space-4);
+
+  --anchor-gap: var(--space-inline-lg);
+}

package/dist/tokens/components/control.css

@@ -377,11 +377,11 @@
 
   --control-label-disabled-alpha: 0.7;
 
-  --control-surface-border-color: hsl(var(--input));
-  --control-surface-background: hsl(var(--background));
+  --control-surface-border-color: initial;
+  --control-surface-background: initial;
 
   --control-filled-border-color: transparent;
-  --control-filled-background: hsl(var(--muted));
+  --control-filled-background: initial;
   --control-filled-shadow: none;
 
   --control-borderless-border-color: transparent;

package/dist/tokens/components/form.css

@@ -6,7 +6,7 @@
 
   --form-label-gap: var(--space-4);
 
-  --form-label-font-size: var(--text-sm);
+  --form-label-font-size: var(--control-label-font-size, var(--text-sm));
 
   --form-block-gap: var(--space-4);
 

package/dist/tokens/components/marquee.css

@@ -0,0 +1,7 @@
+
+:root {
+
+  --marquee-gap-inline: var(--space-inline-lg);
+
+  --marquee-mask-width: var(--space-10);
+}

package/dist/tokens/components/masonry.css

@@ -0,0 +1,6 @@
+
+:root {
+
+  --masonry-gap-inline: 0px;
+  --masonry-gap-block: 0px;
+}

package/dist/tokens/components/mega-menu.css

@@ -0,0 +1,62 @@
+
+
+:root {
+
+  --mega-menu-bar-gap: var(--space-inline-xs);
+  --mega-menu-trigger-height: var(--control-height);
+  --mega-menu-trigger-padding-x: var(--space-3);
+  --mega-menu-trigger-gap: var(--space-inline-sm);
+  --mega-menu-trigger-radius: var(--radius-sm);
+  --mega-menu-trigger-font-size: var(--font-size-sm);
+  --mega-menu-trigger-foreground: hsl(var(--foreground));
+  --mega-menu-trigger-background: transparent;
+
+  --mega-menu-trigger-hover-background: initial;
+  --mega-menu-trigger-hover-foreground: initial;
+  --mega-menu-trigger-open-background: initial;
+  --mega-menu-trigger-open-foreground: initial;
+  --mega-menu-trigger-current-foreground: initial;
+  --mega-menu-trigger-disabled-alpha: 0.5;
+  --mega-menu-expand-icon-size: var(--control-icon-size-sm);
+
+  --mega-menu-panel-background: hsl(var(--popover));
+  --mega-menu-panel-foreground: hsl(var(--popover-foreground));
+  --mega-menu-panel-border-color: hsl(var(--border));
+  --mega-menu-panel-border-width: 1px;
+  --mega-menu-panel-radius: var(--radius-md);
+  --mega-menu-panel-padding: var(--space-6);
+  --mega-menu-panel-shadow: var(--shadow-md);
+  --mega-menu-panel-offset: 0px;
+
+  --mega-menu-panel-max-height: 70vh;
+
+  --mega-menu-panel-translate: var(--space-1);
+
+  --mega-menu-groups-gap: var(--space-6);
+  --mega-menu-group-gap: var(--space-inline-sm);
+
+  --mega-menu-group-min-width: 12rem;
+  --mega-menu-group-label-font-size: var(--font-size-xs);
+  --mega-menu-group-label-foreground: hsl(var(--muted-foreground));
+  --mega-menu-group-description-font-size: var(--font-size-xs);
+  --mega-menu-group-description-foreground: hsl(var(--muted-foreground));
+  --mega-menu-group-icon-size: var(--control-icon-size-sm);
+
+  --mega-menu-link-gap: var(--space-inline-sm);
+  --mega-menu-link-padding-x: var(--space-2);
+  --mega-menu-link-padding-y: var(--space-2);
+  --mega-menu-link-radius: var(--radius-sm);
+  --mega-menu-link-font-size: var(--font-size-sm);
+  --mega-menu-link-foreground: hsl(var(--foreground));
+  --mega-menu-link-hover-background: initial;
+  --mega-menu-link-hover-foreground: initial;
+  --mega-menu-link-current-foreground: initial;
+  --mega-menu-link-description-font-size: var(--font-size-xs);
+  --mega-menu-link-description-foreground: hsl(var(--muted-foreground));
+  --mega-menu-link-icon-size: var(--control-icon-size-sm);
+
+  --mega-menu-link-min-height: var(--touch-target-min);
+
+  --mega-menu-panel-footer-gap: var(--space-4);
+  --mega-menu-panel-footer-border-color: hsl(var(--border));
+}

package/dist/tokens/components/shell.css

@@ -102,6 +102,9 @@
   --topbar-inset: 0px;
   --topbar-gap: var(--space-2);
 
+  --topbar-background-alpha: initial;
+  --topbar-backdrop-blur-size: initial;
+
   --topbar-center-compact-display: none;
 
   --topbar-item-padding-inline: var(--space-3);

package/dist/tokens/foundation.css

@@ -205,6 +205,9 @@
   --space-10: calc(2.5rem * var(--scaling));
   --space-12: calc(3rem * var(--scaling));
 
+  --space-20: calc(5rem * var(--scaling));
+  --space-24: calc(6rem * var(--scaling));
+
   --icon-size-2xs: 0.625rem;
   --icon-size-xs: 0.75rem;
   --icon-size-sm: 0.875rem;
@@ -254,6 +257,10 @@
   --activity-interval: var(--duration-loop);
 
   --activity-stagger-step: 160ms;
+
+  --marquee-interval: 20s;
+  --marquee-interval-slow: calc(var(--marquee-interval) * 2);
+  --marquee-interval-fast: calc(var(--marquee-interval) / 2);
 }
 
 .ui-scale-fixed {
@@ -267,6 +274,8 @@
   --space-8: 2rem;
   --space-10: 2.5rem;
   --space-12: 3rem;
+  --space-20: 5rem;
+  --space-24: 6rem;
   --radius: 0.375rem;
   --control-height: var(--control-height-default);
 
@@ -289,6 +298,8 @@
   --space-page-x: var(--space-6);
   --space-page-y: var(--space-6);
   --space-section: var(--space-4);
+  --space-section-band: var(--space-20);
+  --space-section-hero: var(--space-24);
   --space-stack-xs: var(--space-1);
   --space-stack-sm: var(--space-2);
   --space-stack-md: var(--space-4);

package/dist/tokens/semantic/layout.css

@@ -5,6 +5,9 @@
   --space-page-x: var(--space-6);
   --space-page-y: var(--space-6);
   --space-section: var(--space-4);
+
+  --space-section-band: var(--space-20);
+  --space-section-hero: var(--space-24);
   --space-stack-xs: var(--space-1);
   --space-stack-sm: var(--space-2);
   --space-stack-md: var(--space-4);
@@ -17,6 +20,8 @@
 
   --overlay-z-index: 50;
 
+  --sticky-z-index: 20;
+
   --master-detail-rail-compact: 18.75rem;
   --master-detail-rail-narrow: 12rem;
   --master-detail-rail-wide: 24rem;
@@ -64,6 +69,8 @@
   --page-measure-narrow: 42rem;
   --page-measure-medium: 48rem;
 
+  --page-measure-wide: 72rem;
+
   --page-title-font-size: var(--heading-h1);
   --page-title-font-size-compact: var(--heading-h2);
   --page-subtitle-font-size: var(--font-size-base);

package/docs/COMPOSITION-VS-COMPONENT.md

@@ -77,7 +77,8 @@ new UI need
 | `Select` (incl. search/async)                           | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | **Framework component**                                                  |
 | `DataTable`, `Dialog`, `Calendar`, `Switch`, `Combobox` | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | **Framework component**                                                  |
 | `StatCard` (+ `icon`)                                   | ✅  | ➖  | ✅  | ✅  | ✅  | ✅  | ✅  | **Framework component** (a reusable KPI tile with a stable API + tokens) |
-| `ServiceLauncherCard`                                   | ➖  | ❌  | ❌  | ✅  | ✅  | ➖  | ➖  | **Composition by the test — RETAINED as a recorded exception** (gh#814) |
+| `ServiceLauncherCard`                                   | ➖  | ❌  | ❌  | ✅  | ✅  | ➖  | ➖  | **Composition by the test — RETAINED as a recorded exception** (gh#814)  |
+| `MegaMenu`                                              | ✅  | ✅  | ✅  | ✅  | ✅  | ✅  | ➖  | **Framework component** — the instructive contrast with Hero, below      |
 | Marketing **Hero**                                      | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | **Composition** — section, static, composable, brand-specific            |
 | **Navbar** / **Footer**                                 | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | **Composition** — layout of `Text`/`Button`/`Flex`                       |
 | **PricingTable** / feature grid                         | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | ❌  | **Composition** — `ResponsiveGrid` + `Card`                              |
@@ -86,6 +87,23 @@ new UI need
 
 `✅ pass · ❌ fail · ➖ borderline`. **StatCard** is the instructive borderline: C2 is weak (it owns little behavior), but it is a universal KPI tile with a controlled API, fully tokenized, broadly reused — so it earns its place. A **Hero** fails six of seven; it is unambiguously a composition.
 
+**MegaMenu is the instructive PASS, and it is in this table because it sits next to Navbar.** A
+Navbar fails every criterion; a megamenu is the same bar with behaviour bolted through it, and that
+one difference flips the verdict. **C2** is the whole case: a roving tabindex across the top-level
+items, `aria-expanded`/`aria-controls` per trigger, hover intent (a diagonal pointer path toward the
+panel must not close it), `Escape` closing and returning focus to its trigger, Tab-out and
+outside-click closing, and close-on-route-change. None of that is layout. **C3** is the one people
+get wrong: `DropdownMenu` looks like the answer and is the WRONG primitive, not an awkward one — it
+is react-aria-components `Menu`, i.e. `role="menu"` / `role="menuitem"`, which announces a set of
+site links as a desktop application menu and takes Tab out of the widget. The APG says so itself in
+its Disclosure Navigation example. A recipe over `DropdownMenu` would therefore ship the classic
+megamenu accessibility defect, which is exactly the case C3 is asking about. **C7 is the weak
+one** — marked ➖ deliberately: this is a JP business-software library, and a marketing megamenu is
+not in every consumer's build. It is kept because the same disclosure bar is what an admin console
+with several product areas needs, and because the cost is one file with no new dependency (no
+`@radix-ui/react-navigation-menu`, no animation runtime). Compare `StatCard`, whose borderline is
+C2 rather than C7.
+
 **ServiceLauncherCard is the ONE recorded exception, and it is recorded so that it stays one.** It shipped before the test was run against it, and when the test was run it came back with two hard FAILs: **C2** — no state, no keyboard handling, no focus management, its only ARIA three static attributes — and **C3** — its own imports are `Card` + `CardContent` + `Badge` + a Lucide glyph, so "could I build this right now from primitives?" is yes. By §2 that makes it a composition pattern. It is kept anyway because `src/components/layout/app-launcher.tsx` consumes it: it is an internal building block of a component that **does** pass, so the question was never "should it exist" but "should it be PUBLIC", and removing a public export is breaking. Keeping it public was the cheaper call and the ledger lives on gh#814 and at the top of `src/components/data-display/service-launcher-card.tsx`. **Consumers should compose `Card` + `Badge` for a service tile** — reach for `ServiceLauncherCard` only to match `AppLauncher`'s own tiles — and this row is not precedent for adding another static tile to `src/components/`.
 
 ---

package/docs/DESIGN-AUTHORITY.md

@@ -12,17 +12,17 @@ It changes no code by itself. It is the tie-breaker a reviewer points at.
 
 ## The layers, and who owns each
 
-| Layer                                                              | Authority                                       | Status in this repo                                                                                                                                  |
-| ------------------------------------------------------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Interaction semantics, keyboard, ARIA                              | **WAI-ARIA APG**                                | already followed — 33 references in `src/`                                                                                                           |
-| Behaviour primitives                                               | **Radix**                                       | already the implementation — 193 references                                                                                                          |
-| Component composition shape                                        | **shadcn**                                      | already the structural convention — 23 references                                                                                                    |
-| Component taxonomy / grouping                                      | **Ant Design** groups                           | already the catalog shape: `data-entry`, `data-display`, `layout`, `feedback`, `navigation`, `general` — a naming precedent, nothing is installed    |
+| Layer                                                              | Authority                                       | Status in this repo                                                                                                                                                                                        |
+| ------------------------------------------------------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Interaction semantics, keyboard, ARIA                              | **WAI-ARIA APG**                                | already followed — 33 references in `src/`                                                                                                                                                                 |
+| Behaviour primitives                                               | **Radix**                                       | already the implementation — 193 references                                                                                                                                                                |
+| Component composition shape                                        | **shadcn**                                      | already the structural convention — 23 references                                                                                                                                                          |
+| Component taxonomy / grouping                                      | **Ant Design** groups                           | already the catalog shape: `data-entry`, `data-display`, `layout`, `feedback`, `navigation`, `general` — a naming precedent, nothing is installed                                                          |
 | Colour foundation                                                  | **SmartHR**, brand roles aside                  | the NEUTRAL spine is SmartHR's — `--foreground` = TEXT_BLACK, `--border` = BORDER. `--primary` was SmartHR MAIN `#0071bd` until identity v2.3 took the brand roles back: it is GoDX violet `#7A00FF` today |
-| **Derived colour — the interaction states hanging off each seed**  | **Measured contrast (WCAG 2.2 / JIS X 8341-3)** | Authored in `src/tokens/derived.css`; no algorithm derives them. Four contrast suites read that file and hold every value to a threshold, and a fifth holds it to the seed's HUE (gh#648) — see below |
-| **Japanese UI convention — density, JP typography, form patterns** | **SmartHR**                                     | **NEW — this decision.** Extends SmartHR from "where the colours came from" to the authority for how a JP business screen behaves                    |
-| **Japanese accessibility / public-sector convention**              | **デジタル庁 Design System** (Digital Agency)   | **NEW — this decision.** The reference when a JP customer asks which standard a screen meets (JIS X 8341-3)                                          |
-| **Spacing, density, type scale, information architecture**         | **IBM Carbon**                                  | **NEW — this decision**                                                                                                                              |
+| **Derived colour — the interaction states hanging off each seed**  | **Measured contrast (WCAG 2.2 / JIS X 8341-3)** | Authored in `src/tokens/derived.css`; no algorithm derives them. Four contrast suites read that file and hold every value to a threshold, and a fifth holds it to the seed's HUE (gh#648) — see below      |
+| **Japanese UI convention — density, JP typography, form patterns** | **SmartHR**                                     | **NEW — this decision.** Extends SmartHR from "where the colours came from" to the authority for how a JP business screen behaves                                                                          |
+| **Japanese accessibility / public-sector convention**              | **デジタル庁 Design System** (Digital Agency)   | **NEW — this decision.** The reference when a JP customer asks which standard a screen meets (JIS X 8341-3)                                                                                                |
+| **Spacing, density, type scale, information architecture**         | **IBM Carbon**                                  | **NEW — this decision**                                                                                                                                                                                    |
 
 The first five were already true and merely unwritten. The last three are the choices being made
 here. Carbon fills the one layer that had no outside answer at all: page rhythm, table density, form layout,
@@ -282,6 +282,87 @@ bottomEnd | none` (`TablePaginationPositionProp`, default `['bottomEnd']`), the
   rows, so an expanded detail row shifts every stripe after it, and `ui-audit` blocks the
   utilities it would need.
 
+- **`Masonry.gap` is antd `gutter`, and its breakpoint steps are this library's (gh-masonry
+  port).** Three divergences on one component, each for a reason already written down elsewhere in
+  this file:
+
+  1. **`gutter` → `gap`.** antd's `gutter` takes a raw pixel number (or a per-breakpoint map of
+     them). This library already owns that axis under the name `gap` on `Flex`, `ResponsiveGrid`
+     and `AuthStack`, `check:prop-vocabulary` maps a field called `gap` to `GapProp`, and a token
+     step is what makes spacing follow `--scaling` (density) and a tenant theme. "This library's
+     controlled vocabulary wins on values" is the rule; here it wins on the name too, because the
+     name and the value type move together. antd's tuple `[Gap, Gap]` survives as
+     `[GapProp, GapProp]` = `[inline, block]`. **`gutter` is not silently absent**: it is declared
+     on the prop type as `never`, so a consumer arriving from antd's docs gets a compile error and
+     a `@deprecated` hint naming `gap`, plus a development-time `console.warn`.
+  2. **`columns` steps are `base sm md lg xl`, not antd's `xs sm md lg xl xxl`.** antd's `xs` IS
+     this library's `base` (the mobile-first floor), and a second spelling of one axis is what
+     `check:prop-vocabulary` exists to prevent; `xxl` has no step here at all. `Flex direction`
+     is the precedent shape and the media queries are literally the `--flex-direction-*` cascade's
+     (sm 40rem · md 48rem · lg 64rem · xl 80rem). Both antd spellings FAIL LOUDLY — TypeScript
+     rejects them as excess properties and the component names them in a development warning —
+     because a silently-ignored `xs` is the worst outcome of the three.
+  3. **`MasonryItem.height` is HONOURED, where antd declares it and never reads it.** Verified in
+     antd `master`: `Masonry.tsx` builds every `ItemHeightData` from `getBoundingClientRect()`
+     alone, and all six demos carry their heights in `data`. Porting the field as inert would ship
+     a documented prop that does nothing. Here a finite `height` sizes the tile and replaces its
+     measurement, which is also what lets a first paint and an SSR render land in the right place.
+
+  Not ported, each under a rule that already exists: `classNames` / `styles` (a knob only a fork
+  could reach — `src/tokens/components/masonry.css` is the answer), `prefixCls` / `rootClassName`
+  (no `prefixCls` layer here), and rc-motion's tile-REMOVAL animation (the arrival fade and the
+  re-flow slide are ported in CSS and both snap under `prefers-reduced-motion`). `fresh` keeps
+  antd's name and antd's `false` default even though `docs/roadmap/list-masonry.md` (2026-09-10)
+  proposed renaming it `observeItems` and defaulting it on — that proposal predates the
+  2026-09-12 restatement above, and "the antd name says nothing" is exactly the reasoning the
+  restatement rejects. The same roadmap's invented `sequential` prop is not ported for the same
+  reason: antd has no such knob, and improvements come after parity, not instead of it.
+
+- **`Affix` and `Anchor` take the LOGICAL axis where antd takes the physical one (gh#827/gh#828).**
+  Ported from `ant-design@master`, read out of `components/affix/{index.tsx,utils.ts}` and
+  `components/anchor/{Anchor,AnchorLink}.tsx` on 2026-09-21, not out of the docs tables. Every
+  antd prop is present. Four renames, and nothing else:
+
+  1. **`offsetTop` → `offsetBlockStart`, `offsetBottom` → `offsetBlockEnd`** (both components;
+     `Anchor.targetOffset` → `targetOffsetBlockStart` with it). `check:rtl` exists to keep
+     `inset-block-start` out of `top`'s hands in every stylesheet here, and a prop that names a
+     physical edge re-opens that door at the API. It is also load-bearing rather than cosmetic:
+     the offset is a CSS custom property (`--affix-inset-block-start`), read once by the sentinel
+     that detects the crossing and once by the pinned bar that paints it, so the name has to be
+     the one CSS uses. All three antd spellings are declared `never` — a compile error carrying an
+     `@deprecated` hint that names the replacement — plus a development `console.warn`, plus the
+     MCP catalog entry. The `Masonry gutter → gap` precedent, applied to a second component.
+  2. **`Anchor.onChange` → `onValueChange`,** beside new `value` / `defaultValue`. The active
+     `href` is a controlled value and this library has one spelling for that. antd has no
+     controlled form of it at all (`getCurrentAnchor` is a transform of the computed answer, not a
+     value), so this is an ADDITION with a rename attached rather than a substitution, and
+     `getCurrentAnchor` is ported unchanged beside it — a controlled `value` simply outranks it.
+     antd's own note is ported too: `onValueChange` reports the link the SCROLL POSITION resolved,
+     not the one `getCurrentAnchor` substituted.
+
+  **`Affix.onChange` is NOT renamed**, and the distinction is the point: there is no pinned VALUE
+  to control, only an observation of a derived boolean, so no triad applies. `Attachments.onChange`
+  and `ActionsFeedback.onChange` already carry antd's name with a non-DOM payload for the same
+  reason.
+
+  **Not ported, each under a rule that already exists:** `classNames` / `styles` on `Anchor` (a
+  knob only a fork could reach — `src/tokens/components/anchor.css` is the answer),
+  `prefixCls` / `rootClassName`, and antd's deprecated `Anchor children` / `Anchor.Link` JSX form
+  (antd itself warns on it and says to use `items`).
+
+  **One deliberate behavioural difference, in `Anchor`.** antd resolves from scroll position on
+  mount unconditionally, which overwrites a landing hash on any page whose hashed section happens
+  to be above the fold. Here the hash is read in the state INITIALISER and the mount resolution is
+  skipped when it matched, so `/page#section` is correct on the first render with no scroll event
+  ever firing — which is gh#828's acceptance criterion, and the one place antd's behaviour is
+  worse rather than merely differently named.
+
+  **Two things antd does not have at all**, both required by the contract rather than invented:
+  `Anchor.label` (antd ships an unnamed `<div>`; a `<nav>` landmark on a page that already has a
+  breadcrumb and a rail must be named, so `label` defaults through `t()`), and `Affix`'s
+  `scroll-padding-block-start` on the scroll box while pinned (WCAG 2.4.11 — without it the pinned
+  bar covers whatever the browser scrolls a focused element to).
+
 - **`Command.split` is antd `List.split`, with this library's default.** Same name, same meaning:
   a divider between rows and none after the last (gh#699). antd's `List` defaults it to `true`;
   `Command` defaults it to `false`, because its resting home is a command palette, where inset
@@ -501,11 +582,11 @@ snapped to the seed's hue (1.008:1 / 1.010:1 from the kit value, i.e. the same c
 the kit's `action.primary.hover` and then reflects the pressed step, because the dark seed sits at
 86.9% L and the conventional step runs out of LIGHTNESS rather than out of contrast:
 
-| token                    | conventional step        | shipped                            |
-| ------------------------ | ------------------------ | ---------------------------------- |
-| light `--primary-hover`  | kit #6400D4              | #6500d4 · 8.23:1                   |
-| light `--primary-active` | kit #5200B0              | #5400b0 · 10.31:1                  |
-| dark `--primary-hover`   | kit #E8DAFF              | #ecdaff · 13.51:1                  |
+| token                    | conventional step            | shipped                         |
+| ------------------------ | ---------------------------- | ------------------------------- |
+| light `--primary-hover`  | kit #6400D4                  | #6500d4 · 8.23:1                |
+| light `--primary-active` | kit #5200B0                  | #5400b0 · 10.31:1               |
+| dark `--primary-hover`   | kit #E8DAFF                  | #ecdaff · 13.51:1               |
 | dark `--primary-active`  | #fbf7ff · 1.056:1 from white | #cd9fff · 8.41:1 (sign flipped) |
 
 **The ratio is blind to hue, and that cost a release (gh#648).** Identity v2.3 moved the seed 63
@@ -604,10 +685,10 @@ the **field** indicator on every control — one hairline (1px) in the focus hue
 `--control-outline` halo — rather than the heavy 3px outline form. Measured, in Chromium, on
 `ql.test` after the transition settles:
 
-| control                    | switch off                                           | switch on                                                      |
-| -------------------------- | ---------------------------------------------------- | -------------------------------------------------------------- |
+| control                    | switch off                                           | switch on                                                       |
+| -------------------------- | ---------------------------------------------------- | --------------------------------------------------------------- |
 | Input / Select trigger     | border `1px rgb(144,135,127)`, resting shadow intact | border `1px` of `--ring` + `--control-outline` halo `0 0 0 2px` |
-| Button (primary)           | outline `0px`, resting shadow intact                 | `outline: 1px solid` `--ring` @ `0px` + same halo              |
+| Button (primary)           | outline `0px`, resting shadow intact                 | `outline: 1px solid` `--ring` @ `0px` + same halo               |
 | Sidebar nav row / list row | outline `0px`                                        | `outline: 1px solid` `--ring` @ **`-1px`** (inset into the row) |
 
 The GEOMETRY above is the Chromium measurement; the COLOUR is named by token rather than pinned as

package/docs/FRAME-COVERAGE-REPORT.md

@@ -3,8 +3,8 @@
 > Generated by `scripts/frame-coverage.mjs` (issue #163). Do not edit by hand — run `pnpm check:frame-coverage`.
 > Standard: [FRAME-COVERAGE-STANDARD.md](./FRAME-COVERAGE-STANDARD.md). A missing dimension is **UNTESTED**, never a pass.
 
-- Public components: **165**
-- With ≥1 frame: **144** · zero-frame: **21**
+- Public components: **170**
+- With ≥1 frame: **149** · zero-frame: **21**
 - Fully covered (every contract axis declared): **0**
 
 ## UNTESTED — no `/frame/**` route
@@ -198,8 +198,13 @@ Legend: ✓ covered · N/A reasoned skip · · UNTESTED (blank cell = UNTESTED).
 | ChatComposer | ✓ | · | · | · | · | · | · | · | · | · |
 | ChatSuggestion | ✓ | N/A | N/A | · | · | · | · | · | · | · |
 | Conversations | ✓ | N/A | N/A | N/A | · | · | · | · | · | · |
+| MegaMenu | ✓ | · | N/A | · | · | · | · | · | · | · |
 | Welcome | ✓ | · | N/A | N/A | · | · | · | · | · | · |
 | Actions | ✓ | · | N/A | N/A | · | · | · | · | · | · |
 | ThoughtChain | ✓ | N/A | N/A | N/A | · | · | · | · | · | · |
 | Attachments | ✓ | N/A | · | N/A | · | · | · | · | · | · |
+| Marquee | ✓ | N/A | N/A | N/A | · | · | · | · | · | · |
+| Masonry | ✓ | N/A | N/A | N/A | · | · | · | · | · | · |
+| Affix | ✓ | N/A | N/A | N/A | · | · | · | · | · | · |
+| Anchor | ✓ | N/A | N/A | · | · | · | · | · | · | · |