@godxjp/ui 28.7.0 → 28.8.0

package/dist/props/registry.js

@@ -431,7 +431,7 @@ const VOCABULARY_REGISTRY = {
   TextSizeProp: {
     file: "vocabulary/interaction.prop.ts",
     category: "interaction",
-    description: "Text size \u2014 golden-ratio type-scale steps (2xs\u20262xl), never an arbitrary px"
+    description: "Text size \u2014 ten type-scale steps shared by Text and Heading, never an arbitrary px: the golden-ratio UI ramp 2xs\u20262xl (\u224811\u202622px) plus the display ramp 3xl\u20265xl (\u224828/42/54px, derived from --font-size-display) that a marketing hero needs"
   },
   IconSizeProp: {
     file: "vocabulary/interaction.prop.ts",
@@ -451,7 +451,7 @@ const VOCABULARY_REGISTRY = {
   HeadingLevelProp: {
     file: "vocabulary/interaction.prop.ts",
     category: "interaction",
-    description: "Heading level 1-4 \u2014 sizes from --heading-h* and the semantic element"
+    description: "Heading level 1-4 \u2014 the semantic element, and the --heading-h* size it takes unless `size` (TextSizeProp) overrides it"
   },
   TextAlignProp: {
     file: "vocabulary/interaction.prop.ts",
@@ -563,6 +563,16 @@ const VOCABULARY_REGISTRY = {
     category: "interaction",
     description: "Reveal entrance-stagger ordinal (0..6) \u2014 an index into the motion ladder, never a raw ms"
   },
+  RevealTriggerProp: {
+    file: "vocabulary/interaction.prop.ts",
+    category: "interaction",
+    description: "What starts a Reveal entrance \u2014 mount (default, historical) | view (reaches the viewport)"
+  },
+  InViewAmountProp: {
+    file: "vocabulary/interaction.prop.ts",
+    category: "interaction",
+    description: "How much of an element must be visible to count as in view \u2014 some | all | a 0..1 ratio (Motion's useInView `amount`)"
+  },
   ActivityVariantProp: {
     file: "vocabulary/interaction.prop.ts",
     category: "interaction",
@@ -821,6 +831,129 @@ const COMPONENT_PROP_REGISTRY = {
   ResponsiveGridColumnsProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: [] },
   ResponsiveGridPresetProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: [] },
   ResponsiveGridAlignProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: [] },
+  MasonryColumnsProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: ["BreakpointProp"]
+  },
+  MasonryGapProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: ["GapProp"] },
+  MasonryItemProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "ChildrenProp",
+      {
+        field: "key",
+        local: true,
+        reason: "Ant Design `MasonryItem.key` \u2014 the tile's identity across re-orders and re-measures, a DATA field on the item descriptor, not React's reserved element key."
+      },
+      {
+        field: "column",
+        local: true,
+        reason: "Ant Design `MasonryItem.column` \u2014 pin to a 0-based column index instead of the shortest-column fill."
+      },
+      {
+        field: "height",
+        local: true,
+        reason: "Ant Design `MasonryItem.height` \u2014 a declared block size that replaces the measurement for this tile."
+      },
+      {
+        field: "data",
+        local: true,
+        reason: "Ant Design `MasonryItem.data` \u2014 arbitrary payload handed back to itemRender/onLayoutChange."
+      }
+    ]
+  },
+  MasonryLayoutEntryProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      {
+        field: "column",
+        local: true,
+        reason: "The 0-based column the item landed in \u2014 the whole payload of Ant Design `onLayoutChange`."
+      }
+    ]
+  },
+  MasonryProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "GapProp",
+      "IdProp",
+      "ClassNameProp",
+      {
+        field: "items",
+        local: true,
+        reason: "Ant Design `Masonry.items` \u2014 the tile descriptors, in reading order."
+      },
+      {
+        field: "itemRender",
+        local: true,
+        reason: "Ant Design `Masonry.itemRender` \u2014 renders a tile that carries no children."
+      },
+      {
+        field: "columns",
+        local: true,
+        reason: "Ant Design `Masonry.columns` \u2014 fixed count or a per-breakpoint map (MasonryColumnsProp)."
+      },
+      {
+        field: "gutter",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's spelling of `gap` is a compile error that names the replacement instead of a silently-unspaced grid (docs/DESIGN-AUTHORITY.md)."
+      },
+      {
+        field: "fresh",
+        local: true,
+        reason: "Ant Design `Masonry.fresh` \u2014 observe every tile's own size, not just the container's."
+      },
+      {
+        field: "onLayoutChange",
+        local: true,
+        reason: "Ant Design `Masonry.onLayoutChange` \u2014 reports column assignment; not a controlled-value callback, so it is not OnValueChangeProp."
+      }
+    ]
+  },
+  AffixTargetProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: [] },
+  AffixProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "ChildrenProp",
+      "IdProp",
+      "ClassNameProp",
+      {
+        field: "offsetBlockStart",
+        local: true,
+        reason: "Ant Design `Affix.offsetTop` on its LOGICAL axis \u2014 the pin distance from the scrollport's block-start edge. A length in pixels, backed by the `--affix-inset-block-start` token; no vocabulary type owns a per-instance pin offset."
+      },
+      {
+        field: "offsetBlockEnd",
+        local: true,
+        reason: "Ant Design `Affix.offsetBottom` on its LOGICAL axis. See `offsetBlockStart`."
+      },
+      {
+        field: "offsetTop",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `offsetBlockStart` instead of a header that never pins (docs/DESIGN-AUTHORITY.md)."
+      },
+      {
+        field: "offsetBottom",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `offsetBlockEnd`."
+      },
+      {
+        field: "target",
+        local: true,
+        reason: "Ant Design `Affix.target` \u2014 the lazy scroll-box getter, the same shape `FloatButton.BackTop.target` already spells here."
+      },
+      {
+        field: "onChange",
+        local: true,
+        reason: "Ant Design `Affix.onChange` \u2014 an OBSERVATION of the pinned boolean, fired only on the transition. There is no pinned VALUE to control, so it is not the OnValueChangeProp half of a triad, and it is not OnChangeProp's DOM ChangeEvent either. `Attachments.onChange` and `ActionsFeedback.onChange` are the precedent."
+      }
+    ]
+  },
   MasterDetailRailWidthProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -1353,12 +1486,29 @@ const COMPONENT_PROP_REGISTRY = {
     vocabulary: [
       "ChildrenProp",
       "RevealDelayProp",
+      "RevealTriggerProp",
+      "InViewAmountProp",
       "AsChildProp",
       "ClassNameProp",
       {
         field: "delay",
         local: true,
         reason: "Reveal stagger ordinal \u2014 RevealDelayProp vocabulary."
+      },
+      {
+        field: "on",
+        local: true,
+        reason: "Entrance trigger \u2014 RevealTriggerProp vocabulary (mount | view)."
+      },
+      {
+        field: "once",
+        local: true,
+        reason: "Reveal-once latch for on='view' \u2014 Motion's useInView `once`, borrowed by name and type."
+      },
+      {
+        field: "amount",
+        local: true,
+        reason: "Visibility threshold for on='view' \u2014 InViewAmountProp vocabulary."
       }
     ]
   },
@@ -1529,7 +1679,13 @@ const COMPONENT_PROP_REGISTRY = {
   HeadingProp: {
     group: "general",
     file: "components/general.prop.ts",
-    vocabulary: ["HeadingLevelProp", "TextToneProp", "TextAlignProp", "ClassNameProp"]
+    vocabulary: [
+      "HeadingLevelProp",
+      "TextSizeProp",
+      "TextToneProp",
+      "TextAlignProp",
+      "ClassNameProp"
+    ]
   },
   TypographyProp: {
     group: "general",
@@ -2181,6 +2337,63 @@ const COMPONENT_PROP_REGISTRY = {
       }
     ]
   },
+  MarqueeDirectionProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      {
+        field: "direction",
+        local: true,
+        reason: "LOGICAL travel direction (start | end) \u2014 the edge the track moves towards, so it flips with `dir` instead of naming a physical side the way the prior art's `left | right | up | down` does."
+      }
+    ]
+  },
+  MarqueeSpeedProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      {
+        field: "speed",
+        local: true,
+        reason: "Pace ordinal (slow | base | fast) over the `--marquee-interval` motion token. Not SizeProp: it names a DURATION rung, not a control box, and `xs|sm|md|lg` would read as a size on something that has none."
+      }
+    ]
+  },
+  MarqueeProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      "ChildrenProp",
+      "GapProp",
+      "LabelProp",
+      "ClassNameProp",
+      {
+        field: "play",
+        local: true,
+        reason: "Controlled motion state. The boolean triad spelled for this surface (play / defaultPlay / onPlayChange), the same shape `open`/`defaultOpen`/`onOpenChange` takes for an overlay \u2014 `value` would say nothing about what is being valued."
+      },
+      {
+        field: "defaultPlay",
+        local: true,
+        reason: "Uncontrolled member of the play triad."
+      },
+      {
+        field: "onPlayChange",
+        local: true,
+        reason: "Change member of the play triad; value-first, like every other On*Change here."
+      },
+      {
+        field: "pauseOnHover",
+        local: true,
+        reason: "Positive boolean, default false. An ADDITION to the pause control, never the mechanism \u2014 hover-only pause is the WCAG 2.2.2 failure (F16) the prior art ships."
+      },
+      {
+        field: "fade",
+        local: true,
+        reason: "Positive boolean, default false. Masks both edges over `--marquee-mask-width`; the prior art's `gradient`/`gradientColor`/`gradientWidth` trio is one boolean and one token here."
+      }
+    ]
+  },
   CredentialRevealProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
@@ -4077,6 +4290,262 @@ const COMPONENT_PROP_REGISTRY = {
       "ClassNameProp"
     ]
   },
+  MegaMenuTriggerActionProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
+  MegaMenuLinkProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "LabelProp",
+      "IconProp",
+      "DisabledProp",
+      "DescriptionProp",
+      {
+        field: "key",
+        local: true,
+        reason: "Ant Design MenuItemType.key \u2014 the row's identity, not a value axis. Kept as antd spells it so a consumer's existing `items` array transfers unchanged."
+      },
+      {
+        field: "href",
+        local: true,
+        reason: "The destination of a nav LINK. Sidebar/NavList already spell it `href` on their own row types; there is no vocabulary entry because no control-shaped component has a destination."
+      }
+    ]
+  },
+  MegaMenuGroupProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "LabelProp",
+      "IconProp",
+      "DescriptionProp",
+      {
+        field: "key",
+        local: true,
+        reason: "Ant Design MenuItemGroupType identity \u2014 see MegaMenuLinkProp.key."
+      },
+      {
+        field: "links",
+        local: true,
+        reason: "Ant Design MenuItemGroupType.children, narrowed to leaves. Named for what it holds because a megamenu panel is exactly one level deep \u2014 `children` would imply the arbitrary nesting this deliberately does not have."
+      }
+    ]
+  },
+  MegaMenuPanelProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      {
+        field: "groups",
+        local: true,
+        reason: 'The panel\'s columns \u2014 Ant Design SubMenuType.children restricted to `type: "group"` entries.'
+      },
+      {
+        field: "footer",
+        local: true,
+        reason: "A full-width strip below the columns. Same word Card/Dialog use for the slot in that position; no vocabulary type exists for it."
+      }
+    ]
+  },
+  MegaMenuItemProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "LabelProp",
+      "IconProp",
+      "DisabledProp",
+      {
+        field: "key",
+        local: true,
+        reason: "Ant Design MenuItemType/SubMenuType identity \u2014 see MegaMenuLinkProp.key."
+      },
+      {
+        field: "href",
+        local: true,
+        reason: "Destination of a top-level LINK \u2014 see MegaMenuLinkProp.href."
+      },
+      {
+        field: "panel",
+        local: true,
+        reason: "Presence of this field is what makes the item a DISCLOSURE BUTTON rather than a link (Ant Design SubMenuType vs MenuItemType). A discriminant, not a styling axis."
+      }
+    ]
+  },
+  MegaMenuLinkComponentProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
+  MegaMenuProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "OpenProp",
+      "DefaultOpenProp",
+      "OnOpenChangeProp",
+      "ValueProp",
+      "DefaultValueProp",
+      "OnValueChangeProp",
+      "SizeProp",
+      "LabelProp",
+      "IdProp",
+      "ClassNameProp",
+      {
+        field: "items",
+        local: true,
+        reason: "Ant Design Menu.items \u2014 the bar, in antd's own spelling."
+      },
+      {
+        field: "triggerAction",
+        local: true,
+        reason: "Ant Design `triggerSubMenuAction`, shortened because there is no sub-MENU here (the APG pattern is disclosure, not menubar). Its own union type MegaMenuTriggerActionProp, mirroring DropdownMenuTriggerActionProp."
+      },
+      {
+        field: "openDelay",
+        local: true,
+        reason: "Ant Design `subMenuOpenDelay`, in ms rather than seconds. No vocabulary type: no other component times a hover open."
+      },
+      {
+        field: "closeDelay",
+        local: true,
+        reason: "Ant Design `subMenuCloseDelay`, in ms. This is the hover-intent grace period \u2014 the diagonal a pointer may take toward the panel without it closing."
+      },
+      {
+        field: "expandIcon",
+        local: true,
+        reason: "Ant Design `expandIcon`, kept verbatim including its `false` to remove it."
+      },
+      {
+        field: "linkComponent",
+        local: true,
+        reason: "Same contract and same spelling as Sidebar.linkComponent / NavList.linkComponent, so a consumer who wired a router once wires it the same way here."
+      }
+    ]
+  },
+  AnchorContainerProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
+  AnchorDirectionProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
+  AnchorItemProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "TitleProp",
+      "ChildrenProp",
+      {
+        field: "key",
+        local: true,
+        reason: "Ant Design `AnchorItem.key` \u2014 the entry's identity in the `items` DATA, not React's reserved element key."
+      },
+      {
+        field: "href",
+        local: true,
+        reason: "Ant Design `AnchorItem.href` \u2014 the in-page fragment. It is a real `<a href>`, so the field carries the HTML attribute's own name."
+      },
+      {
+        field: "target",
+        local: true,
+        reason: "Ant Design `AnchorItem.target` \u2014 the `<a target>` attribute, passed through."
+      },
+      {
+        field: "replace",
+        local: true,
+        reason: "Ant Design `AnchorItem.replace` \u2014 history replace rather than push, overriding the component-level prop."
+      },
+      {
+        field: "targetOffsetBlockStart",
+        local: true,
+        reason: "Ant Design `AnchorItem.targetOffset` (6.4.0) on its LOGICAL axis \u2014 this entry's own scroll landing offset."
+      }
+    ]
+  },
+  AnchorProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "ValueProp",
+      "DefaultValueProp",
+      "OnValueChangeProp",
+      "OnClickProp",
+      "LabelProp",
+      "IdProp",
+      "ClassNameProp",
+      {
+        field: "items",
+        local: true,
+        reason: "Ant Design `Anchor.items` \u2014 the entries, in document order."
+      },
+      {
+        field: "direction",
+        local: true,
+        reason: "Ant Design `Anchor.direction` \u2014 the layout axis, and the same word Separator / Flex / Toolbar already use here for it."
+      },
+      {
+        field: "affix",
+        local: true,
+        reason: "Ant Design `Anchor.affix` \u2014 `boolean` or the `AffixProp` subset. It is literally antd's own AffixProps minus the fields Anchor supplies, which is why gh#827 lands before gh#828."
+      },
+      {
+        field: "bounds",
+        local: true,
+        reason: "Ant Design `Anchor.bounds` \u2014 pixel tolerance added to the decision line."
+      },
+      {
+        field: "getContainer",
+        local: true,
+        reason: "Ant Design `Anchor.getContainer` \u2014 the lazy scroll-box getter."
+      },
+      {
+        field: "getCurrentAnchor",
+        local: true,
+        reason: "Ant Design `Anchor.getCurrentAnchor` \u2014 antd's own escape hatch, which runs INSIDE the resolution with no render round-trip. A controlled `value` outranks it."
+      },
+      {
+        field: "offsetBlockStart",
+        local: true,
+        reason: "Ant Design `Anchor.offsetTop` on its LOGICAL axis \u2014 the decision line, and the distance Affix pins the nav at."
+      },
+      {
+        field: "targetOffsetBlockStart",
+        local: true,
+        reason: "Ant Design `Anchor.targetOffset` on its LOGICAL axis \u2014 where a clicked section lands."
+      },
+      {
+        field: "showInkInFixed",
+        local: true,
+        reason: "Ant Design `Anchor.showInkInFixed` \u2014 draw the travelling ink even with `affix={false}`."
+      },
+      {
+        field: "replace",
+        local: true,
+        reason: "Ant Design `Anchor.replace` \u2014 history replace rather than push."
+      },
+      {
+        field: "onChange",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's spelling is a compile error that names `onValueChange` \u2014 the active href here is a controlled value (`value` / `defaultValue` / `onValueChange`), which antd has no spelling for."
+      },
+      {
+        field: "offsetTop",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `offsetBlockStart`."
+      },
+      {
+        field: "targetOffset",
+        local: true,
+        reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `targetOffsetBlockStart`."
+      }
+    ]
+  },
   WelcomeVariantProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",

package/dist/props/vocabulary/index.d.ts

@@ -2,6 +2,6 @@
 export type { ClassNameProp, ChildrenProp, IdProp, OpenProp, DefaultOpenProp, OnOpenChangeProp, HandlerProp, PendingProp, RequiredProp, DisabledProp, LabelProp, HelperProp, ErrorProp, ErrorBagProp, PlaceholderProp, NameProp, ValueProp, DefaultValueProp, OnValueChangeProp, OnChangeProp, OnClickProp, AsChildProp, FlushProp, WidthProp, ControlWidthProp, AllowClearProp, MaxTagCountProp, MaxTagPlaceholderProp, NotFoundContentProp, PopupMatchWidthProp, } from "./shared.prop.js";
 export type { TitleProp, SubtitleProp, StatusProp, DescriptionProp, ExtraProp, FooterProp, ActionProp, IconProp, ConfirmLabelProp, CancelLabelProp, ActionsProp, EmptyMessageProp, } from "./content.prop.js";
 export type { PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, MobileShellWidthProp, OrientationProp, TableDensityProp, DensityProp, GapNameProp, PadProp, PadRawProp, PadSides, GapProp, GapStepProp, } from "./layout.prop.js";
-export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, AppSettingToggleAppearanceProp, ShapeProp, AvatarShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, TextWhitespaceProp, TypographyTypeProp, TitleLevelProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyActionsConfigProp, SizeProp, ControlStatusProp, ControlVariantProp, FormLayoutProp, DescriptionsLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, CalloutKindProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, ActivityVariantProp, ActivityAnnounceProp, IconSizeProp, } from "./interaction.prop.js";
+export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, AppSettingToggleAppearanceProp, ShapeProp, AvatarShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, TextWhitespaceProp, TypographyTypeProp, TitleLevelProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyActionsConfigProp, SizeProp, ControlStatusProp, ControlVariantProp, FormLayoutProp, DescriptionsLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, CalloutKindProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, RevealTriggerProp, InViewAmountProp, ActivityVariantProp, ActivityAnnounceProp, IconSizeProp, } from "./interaction.prop.js";
 export type { BreadcrumbItemProp, BreadcrumbProp, BreadcrumbItemMenuProp, BreadcrumbItemMenuEntryProp, BreadcrumbSeparatorProp, BreadcrumbItemRenderProp, } from "./navigation.prop.js";
 export type { GetRowIdProp, GetRowLabelProp, OnRowClickProp, ColumnDefProp, TablePresetProp, TableColumnPriorityProp, TableCellIndentProp, SelectedIdsProp, OnSelectChangeProp, OnTableDensityChangeProp, TableRowToneProp, RowToneProp, OnSortChangeProp, OnSearchChangeProp, OnClearFiltersProp, HasActiveFiltersProp, StickyProp, ColumnFixedProp, ColumnFilterValueProp, ColumnFilterItemProp, ColumnFilterStateProp, OnColumnFilterChangeProp, ColumnCompareProp, ColumnSorterProp, TableSelectionItemProp, TableRowSelectionProp, TableExpandableProp, TableSummaryProp, TableScrollProp, TableStickyProp, OnRowProp, TablePaginationProp, TablePaginationPositionProp, DescriptionsColumnProp, DescriptionsSpanProp, DescriptionsItemsProp, } from "./data.prop.js";

package/dist/props/vocabulary/interaction.prop.d.ts

@@ -29,8 +29,32 @@ export type ShapeProp = "default" | "pill" | "sharp";
  *   square on the brand surface (`--avatar-square-*` tokens).
  */
 export type AvatarShapeProp = "circle" | "square";
-/** Text size — steps of the golden-ratio type scale (NEVER an arbitrary px). `sm` = base. */
-export type TextSizeProp = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+/**
+ * Text size — steps of the type scale (NEVER an arbitrary px). `sm` = base.
+ *
+ * TEN steps, in TWO ramps that meet at `2xl`, exactly where Tailwind's own scale stops naming
+ * t-shirt sizes and starts counting (`xl` → `2xl` → `3xl`):
+ *
+ *  - `2xs`…`2xl` — the UI ramp. `--font-size-base` × `--font-size-ratio`ⁿ (φ^¼), ≈11…22px. This is
+ *    the dense enterprise scale and nothing about it moves.
+ *  - `3xl`…`5xl` — the DISPLAY ramp, ≈28/42/54px, for a marketing hero / CTA headline. Its own
+ *    base is `--font-size-display` and its own step is `--font-size-display-ratio` (1.28, bolder
+ *    than the body's φ^¼ because marketing wants more contrast), so a service retunes the whole
+ *    display ramp without touching a single admin screen.
+ *
+ * The four display tokens shipped at `foundation.css:513-521` with NOTHING public able to reach
+ * them, so every marketing page wrote its own `font-size` class instead — 58 bespoke classes
+ * across two showcases (gh#826). These three steps ARE that public surface. `--font-size-display`
+ * itself is deliberately NOT a step: it is the ramp's single re-tuning knob and `5xl` already
+ * resolves to it, so a `"display"` member would be a second name for the same value.
+ *
+ * SHARED WITH `Heading size`, on purpose. Radix Themes is the prior art — one numeric ladder that
+ * `Heading` and `Text` both read, so "make this figure as big as that headline" is one step name
+ * rather than a lookup between two ramps. (Material 3 and Polaris take the other fork, named ROLES
+ * on separate ramps; that fork is equally defensible but it would put a second size vocabulary
+ * beside this one, which `check:prop-vocabulary` exists to prevent.)
+ */
+export type TextSizeProp = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl";
 /**
  * Icon size — the NINE steps of the `--icon-size-*` scale (docs/TOKENS.md · gh#326), not the four
  * of the control `SizeProp`.
@@ -286,6 +310,19 @@ export type SortStateProp = {
  * rows cascades in.
  */
 export type RevealDelayProp = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * What STARTS a `Reveal` — `mount` (default, the historical behaviour: the entrance plays as soon
+ * as the element renders) or `view` (the entrance waits until the element reaches the viewport).
+ * A trigger, never a second component: the animation, the tokens and the reduced-motion contract
+ * are identical either way.
+ */
+export type RevealTriggerProp = "mount" | "view";
+/**
+ * How much of an element must be inside the viewport to count as in view — Motion's `useInView`
+ * `amount`, name and type unchanged. `"some"` (default) is any pixel, `"all"` is the whole box, a
+ * number is an explicit 0..1 ratio.
+ */
+export type InViewAmountProp = "some" | "all" | number;
 /**
  * Ambient-activity mark for `Activity` — the LOOP counterpart to `RevealDelayProp`'s one-shot
  * ladder. `dots` (default) is the three-dot ellipsis convention (someone is typing); `pulse` a

package/dist/styles/control.css

@@ -93,7 +93,6 @@
     cursor: pointer;
     gap: var(--control-gap);
     white-space: nowrap;
-    border-radius: var(--control-radius);
     font-weight: var(--font-weight-medium);
     transition-property: color, background-color, border-color, box-shadow;
     transition-duration: 150ms;
@@ -1246,9 +1245,9 @@
     min-height: var(--control-height);
     padding: var(--space-1) var(--control-padding-x);
 
-    border: var(--control-border-width) solid var(--control-surface-border-color);
+    border: var(--control-border-width) solid var(--control-surface-border-color, hsl(var(--input)));
     border-radius: var(--control-radius);
-    background: var(--control-surface-background);
+    background: var(--control-surface-background, hsl(var(--background)));
     box-shadow: var(--control-shadow);
   }
   .ui-tag-input-disabled {
@@ -1361,14 +1360,14 @@
   }
 
   .ui-control-surface {
-    border-color: var(--control-surface-border-color);
-    background: var(--control-surface-background);
+    border-color: var(--control-surface-border-color, hsl(var(--input)));
+    background: var(--control-surface-background, hsl(var(--background)));
   }
 
   .ui-control-surface[data-variant="filled"] {
     --control-shadow: var(--control-filled-shadow);
     border-color: var(--control-filled-border-color);
-    background: var(--control-filled-background);
+    background: var(--control-filled-background, hsl(var(--muted)));
   }
 
   .ui-control-surface[data-variant="borderless"] {

package/dist/styles/data-display-layout.css

@@ -1878,12 +1878,13 @@
 
   .ui-chat-bubble-skeleton {
     display: grid;
+    grid-template-columns: minmax(0, var(--chat-bubble-max-inline-size));
     gap: var(--skeleton-row-gap);
   }
 
   .ui-chat-bubble-skeleton-line {
     block-size: var(--skeleton-block-height);
-    inline-size: var(--chat-bubble-max-inline-size);
+    inline-size: auto;
     max-inline-size: 100%;
   }
 

package/dist/styles/density.css

@@ -27,6 +27,8 @@
   --space-8: calc(2rem * var(--scaling));
   --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));
   --radius: calc(0.375rem * var(--scaling));
   --control-height: calc(var(--control-height-default) * var(--scaling));
   --control-height-sm: calc(var(--control-height) - calc(0.25rem * var(--scaling)));
@@ -48,6 +50,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);