@godxjp/ui 28.7.0 → 28.8.0

package/dist/props/registry.d.ts

@@ -432,7 +432,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly TextSizeProp: {
         readonly file: "vocabulary/interaction.prop.ts";
         readonly category: "interaction";
-        readonly description: "Text size — golden-ratio type-scale steps (2xs…2xl), never an arbitrary px";
+        readonly description: "Text size — ten type-scale steps shared by Text and Heading, never an arbitrary px: the golden-ratio UI ramp 2xs…2xl (≈11…22px) plus the display ramp 3xl…5xl (≈28/42/54px, derived from --font-size-display) that a marketing hero needs";
     };
     readonly IconSizeProp: {
         readonly file: "vocabulary/interaction.prop.ts";
@@ -452,7 +452,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly HeadingLevelProp: {
         readonly file: "vocabulary/interaction.prop.ts";
         readonly category: "interaction";
-        readonly description: "Heading level 1-4 — sizes from --heading-h* and the semantic element";
+        readonly description: "Heading level 1-4 — the semantic element, and the --heading-h* size it takes unless `size` (TextSizeProp) overrides it";
     };
     readonly TextAlignProp: {
         readonly file: "vocabulary/interaction.prop.ts";
@@ -564,6 +564,16 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "interaction";
         readonly description: "Reveal entrance-stagger ordinal (0..6) — an index into the motion ladder, never a raw ms";
     };
+    readonly RevealTriggerProp: {
+        readonly file: "vocabulary/interaction.prop.ts";
+        readonly category: "interaction";
+        readonly description: "What starts a Reveal entrance — mount (default, historical) | view (reaches the viewport)";
+    };
+    readonly InViewAmountProp: {
+        readonly file: "vocabulary/interaction.prop.ts";
+        readonly category: "interaction";
+        readonly description: "How much of an element must be visible to count as in view — some | all | a 0..1 ratio (Motion's useInView `amount`)";
+    };
     readonly ActivityVariantProp: {
         readonly file: "vocabulary/interaction.prop.ts";
         readonly category: "interaction";
@@ -833,6 +843,109 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly MasonryColumnsProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["BreakpointProp"];
+    };
+    readonly MasonryGapProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["GapProp"];
+    };
+    readonly MasonryItemProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["ChildrenProp", {
+            readonly field: "key";
+            readonly local: true;
+            readonly reason: "Ant Design `MasonryItem.key` — the tile's identity across re-orders and re-measures, a DATA field on the item descriptor, not React's reserved element key.";
+        }, {
+            readonly field: "column";
+            readonly local: true;
+            readonly reason: "Ant Design `MasonryItem.column` — pin to a 0-based column index instead of the shortest-column fill.";
+        }, {
+            readonly field: "height";
+            readonly local: true;
+            readonly reason: "Ant Design `MasonryItem.height` — a declared block size that replaces the measurement for this tile.";
+        }, {
+            readonly field: "data";
+            readonly local: true;
+            readonly reason: "Ant Design `MasonryItem.data` — arbitrary payload handed back to itemRender/onLayoutChange.";
+        }];
+    };
+    readonly MasonryLayoutEntryProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "column";
+            readonly local: true;
+            readonly reason: "The 0-based column the item landed in — the whole payload of Ant Design `onLayoutChange`.";
+        }];
+    };
+    readonly MasonryProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["GapProp", "IdProp", "ClassNameProp", {
+            readonly field: "items";
+            readonly local: true;
+            readonly reason: "Ant Design `Masonry.items` — the tile descriptors, in reading order.";
+        }, {
+            readonly field: "itemRender";
+            readonly local: true;
+            readonly reason: "Ant Design `Masonry.itemRender` — renders a tile that carries no children.";
+        }, {
+            readonly field: "columns";
+            readonly local: true;
+            readonly reason: "Ant Design `Masonry.columns` — fixed count or a per-breakpoint map (MasonryColumnsProp).";
+        }, {
+            readonly field: "gutter";
+            readonly local: true;
+            readonly 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).";
+        }, {
+            readonly field: "fresh";
+            readonly local: true;
+            readonly reason: "Ant Design `Masonry.fresh` — observe every tile's own size, not just the container's.";
+        }, {
+            readonly field: "onLayoutChange";
+            readonly local: true;
+            readonly reason: "Ant Design `Masonry.onLayoutChange` — reports column assignment; not a controlled-value callback, so it is not OnValueChangeProp.";
+        }];
+    };
+    readonly AffixTargetProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly AffixProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["ChildrenProp", "IdProp", "ClassNameProp", {
+            readonly field: "offsetBlockStart";
+            readonly local: true;
+            readonly reason: "Ant Design `Affix.offsetTop` on its LOGICAL axis — 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.";
+        }, {
+            readonly field: "offsetBlockEnd";
+            readonly local: true;
+            readonly reason: "Ant Design `Affix.offsetBottom` on its LOGICAL axis. See `offsetBlockStart`.";
+        }, {
+            readonly field: "offsetTop";
+            readonly local: true;
+            readonly 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).";
+        }, {
+            readonly field: "offsetBottom";
+            readonly local: true;
+            readonly reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `offsetBlockEnd`.";
+        }, {
+            readonly field: "target";
+            readonly local: true;
+            readonly reason: "Ant Design `Affix.target` — the lazy scroll-box getter, the same shape `FloatButton.BackTop.target` already spells here.";
+        }, {
+            readonly field: "onChange";
+            readonly local: true;
+            readonly reason: "Ant Design `Affix.onChange` — 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.";
+        }];
+    };
     readonly MasterDetailRailWidthProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
@@ -1232,10 +1345,22 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly RevealProp: {
         readonly group: "general";
         readonly file: "components/general.prop.ts";
-        readonly vocabulary: readonly ["ChildrenProp", "RevealDelayProp", "AsChildProp", "ClassNameProp", {
+        readonly vocabulary: readonly ["ChildrenProp", "RevealDelayProp", "RevealTriggerProp", "InViewAmountProp", "AsChildProp", "ClassNameProp", {
             readonly field: "delay";
             readonly local: true;
             readonly reason: "Reveal stagger ordinal — RevealDelayProp vocabulary.";
+        }, {
+            readonly field: "on";
+            readonly local: true;
+            readonly reason: "Entrance trigger — RevealTriggerProp vocabulary (mount | view).";
+        }, {
+            readonly field: "once";
+            readonly local: true;
+            readonly reason: "Reveal-once latch for on='view' — Motion's useInView `once`, borrowed by name and type.";
+        }, {
+            readonly field: "amount";
+            readonly local: true;
+            readonly reason: "Visibility threshold for on='view' — InViewAmountProp vocabulary.";
         }];
     };
     readonly ActivityProp: {
@@ -1357,7 +1482,7 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly HeadingProp: {
         readonly group: "general";
         readonly file: "components/general.prop.ts";
-        readonly vocabulary: readonly ["HeadingLevelProp", "TextToneProp", "TextAlignProp", "ClassNameProp"];
+        readonly vocabulary: readonly ["HeadingLevelProp", "TextSizeProp", "TextToneProp", "TextAlignProp", "ClassNameProp"];
     };
     readonly TypographyProp: {
         readonly group: "general";
@@ -1791,6 +1916,49 @@ export declare const COMPONENT_PROP_REGISTRY: {
             readonly reason: "Row-local overflow resolution for the title/description column (truncate | wrap, #224).";
         }];
     };
+    readonly MarqueeDirectionProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "direction";
+            readonly local: true;
+            readonly reason: "LOGICAL travel direction (start | end) — 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.";
+        }];
+    };
+    readonly MarqueeSpeedProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "speed";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
+    readonly MarqueeProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["ChildrenProp", "GapProp", "LabelProp", "ClassNameProp", {
+            readonly field: "play";
+            readonly local: true;
+            readonly reason: "Controlled motion state. The boolean triad spelled for this surface (play / defaultPlay / onPlayChange), the same shape `open`/`defaultOpen`/`onOpenChange` takes for an overlay — `value` would say nothing about what is being valued.";
+        }, {
+            readonly field: "defaultPlay";
+            readonly local: true;
+            readonly reason: "Uncontrolled member of the play triad.";
+        }, {
+            readonly field: "onPlayChange";
+            readonly local: true;
+            readonly reason: "Change member of the play triad; value-first, like every other On*Change here.";
+        }, {
+            readonly field: "pauseOnHover";
+            readonly local: true;
+            readonly reason: "Positive boolean, default false. An ADDITION to the pause control, never the mechanism — hover-only pause is the WCAG 2.2.2 failure (F16) the prior art ships.";
+        }, {
+            readonly field: "fade";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
     readonly CredentialRevealProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
@@ -3392,6 +3560,193 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/navigation.prop.ts";
         readonly vocabulary: readonly ["ActionsProp", "ValueProp", "DefaultValueProp", "OnValueChangeProp", "LabelProp", "IdProp", "ClassNameProp"];
     };
+    readonly MegaMenuTriggerActionProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly MegaMenuLinkProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "IconProp", "DisabledProp", "DescriptionProp", {
+            readonly field: "key";
+            readonly local: true;
+            readonly reason: "Ant Design MenuItemType.key — the row's identity, not a value axis. Kept as antd spells it so a consumer's existing `items` array transfers unchanged.";
+        }, {
+            readonly field: "href";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
+    readonly MegaMenuGroupProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "IconProp", "DescriptionProp", {
+            readonly field: "key";
+            readonly local: true;
+            readonly reason: "Ant Design MenuItemGroupType identity — see MegaMenuLinkProp.key.";
+        }, {
+            readonly field: "links";
+            readonly local: true;
+            readonly reason: "Ant Design MenuItemGroupType.children, narrowed to leaves. Named for what it holds because a megamenu panel is exactly one level deep — `children` would imply the arbitrary nesting this deliberately does not have.";
+        }];
+    };
+    readonly MegaMenuPanelProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "groups";
+            readonly local: true;
+            readonly reason: 'The panel\'s columns — Ant Design SubMenuType.children restricted to `type: "group"` entries.';
+        }, {
+            readonly field: "footer";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
+    readonly MegaMenuItemProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "IconProp", "DisabledProp", {
+            readonly field: "key";
+            readonly local: true;
+            readonly reason: "Ant Design MenuItemType/SubMenuType identity — see MegaMenuLinkProp.key.";
+        }, {
+            readonly field: "href";
+            readonly local: true;
+            readonly reason: "Destination of a top-level LINK — see MegaMenuLinkProp.href.";
+        }, {
+            readonly field: "panel";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
+    readonly MegaMenuLinkComponentProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly MegaMenuProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["OpenProp", "DefaultOpenProp", "OnOpenChangeProp", "ValueProp", "DefaultValueProp", "OnValueChangeProp", "SizeProp", "LabelProp", "IdProp", "ClassNameProp", {
+            readonly field: "items";
+            readonly local: true;
+            readonly reason: "Ant Design Menu.items — the bar, in antd's own spelling.";
+        }, {
+            readonly field: "triggerAction";
+            readonly local: true;
+            readonly 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.";
+        }, {
+            readonly field: "openDelay";
+            readonly local: true;
+            readonly reason: "Ant Design `subMenuOpenDelay`, in ms rather than seconds. No vocabulary type: no other component times a hover open.";
+        }, {
+            readonly field: "closeDelay";
+            readonly local: true;
+            readonly reason: "Ant Design `subMenuCloseDelay`, in ms. This is the hover-intent grace period — the diagonal a pointer may take toward the panel without it closing.";
+        }, {
+            readonly field: "expandIcon";
+            readonly local: true;
+            readonly reason: "Ant Design `expandIcon`, kept verbatim including its `false` to remove it.";
+        }, {
+            readonly field: "linkComponent";
+            readonly local: true;
+            readonly 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.";
+        }];
+    };
+    readonly AnchorContainerProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly AnchorDirectionProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly AnchorItemProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["TitleProp", "ChildrenProp", {
+            readonly field: "key";
+            readonly local: true;
+            readonly reason: "Ant Design `AnchorItem.key` — the entry's identity in the `items` DATA, not React's reserved element key.";
+        }, {
+            readonly field: "href";
+            readonly local: true;
+            readonly reason: "Ant Design `AnchorItem.href` — the in-page fragment. It is a real `<a href>`, so the field carries the HTML attribute's own name.";
+        }, {
+            readonly field: "target";
+            readonly local: true;
+            readonly reason: "Ant Design `AnchorItem.target` — the `<a target>` attribute, passed through.";
+        }, {
+            readonly field: "replace";
+            readonly local: true;
+            readonly reason: "Ant Design `AnchorItem.replace` — history replace rather than push, overriding the component-level prop.";
+        }, {
+            readonly field: "targetOffsetBlockStart";
+            readonly local: true;
+            readonly reason: "Ant Design `AnchorItem.targetOffset` (6.4.0) on its LOGICAL axis — this entry's own scroll landing offset.";
+        }];
+    };
+    readonly AnchorProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "OnValueChangeProp", "OnClickProp", "LabelProp", "IdProp", "ClassNameProp", {
+            readonly field: "items";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.items` — the entries, in document order.";
+        }, {
+            readonly field: "direction";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.direction` — the layout axis, and the same word Separator / Flex / Toolbar already use here for it.";
+        }, {
+            readonly field: "affix";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.affix` — `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.";
+        }, {
+            readonly field: "bounds";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.bounds` — pixel tolerance added to the decision line.";
+        }, {
+            readonly field: "getContainer";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.getContainer` — the lazy scroll-box getter.";
+        }, {
+            readonly field: "getCurrentAnchor";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.getCurrentAnchor` — antd's own escape hatch, which runs INSIDE the resolution with no render round-trip. A controlled `value` outranks it.";
+        }, {
+            readonly field: "offsetBlockStart";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.offsetTop` on its LOGICAL axis — the decision line, and the distance Affix pins the nav at.";
+        }, {
+            readonly field: "targetOffsetBlockStart";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.targetOffset` on its LOGICAL axis — where a clicked section lands.";
+        }, {
+            readonly field: "showInkInFixed";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.showInkInFixed` — draw the travelling ink even with `affix={false}`.";
+        }, {
+            readonly field: "replace";
+            readonly local: true;
+            readonly reason: "Ant Design `Anchor.replace` — history replace rather than push.";
+        }, {
+            readonly field: "onChange";
+            readonly local: true;
+            readonly reason: "NOT a prop: typed `never` so antd's spelling is a compile error that names `onValueChange` — the active href here is a controlled value (`value` / `defaultValue` / `onValueChange`), which antd has no spelling for.";
+        }, {
+            readonly field: "offsetTop";
+            readonly local: true;
+            readonly reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `offsetBlockStart`.";
+        }, {
+            readonly field: "targetOffset";
+            readonly local: true;
+            readonly reason: "NOT a prop: typed `never` so antd's physical spelling is a compile error that names `targetOffsetBlockStart`.";
+        }];
+    };
     readonly WelcomeVariantProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";