@godxjp/ui 31.31.8 → 32.0.1

package/dist/props/components/feedback.prop.d.ts

@@ -1,7 +1,7 @@
 /** Feedback component prop types — @see docs/COMPONENTS.md#feedback */
 import type * as React from "react";
 import type { QueryErrorCategory } from "../../lib/query-error.js";
-import type { AlertVariantProp, AvatarShapeProp, CalloutKindProp, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DefaultOpenProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, ShapeProp, SizeProp, ToneProp, TitleProp, WidthProp } from "../vocabulary/index.js";
+import type { AlertVariantProp, AvatarShapeProp, CalloutKindProp, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DefaultOpenProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, SizeProp, ToneProp, TitleProp, WidthProp } from "../vocabulary/index.js";
 /**
  * @see Dialog — the compound modal ROOT.
  *
@@ -91,7 +91,18 @@ export type AuthExpiryProviderProp = {
 };
 /** @see Alert */
 export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
+    /**
+     * `default` (inline status), `banner` (full-bleed page/shell strip; actions wrap below 640px) or
+     * `callout` (an aside INSIDE a document body: `role="note"`, never a live region). v32 #1223
+     * folded the former `Banner` and `Callout` components into these two values.
+     */
     variant?: AlertVariantProp;
+    /**
+     * `variant="callout"` only: the GitHub/Obsidian admonition preset — `note` (default), `tip`,
+     * `important`, `warning`, `caution`. Resolves `tone` + the leading glyph; pass `tone` or `icon`
+     * to override either per instance (gh#765).
+     */
+    kind?: CalloutKindProp;
     tone?: ToneProp;
     /** Pass `false` to hide the default variant icon. */
     icon?: IconProp | false;
@@ -99,23 +110,6 @@ export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
     className?: ClassNameProp;
     children?: ChildrenProp;
 };
-/**
- * @see Banner — the full-bleed attention strip (`<Alert variant="banner">` with the variant fixed).
- * Same contract as {@link AlertProp} minus `variant`: `tone` owns colour + live-region politeness,
- * `icon`/`icon={false}` owns the leading glyph, `onDismiss` renders the built-in dismiss button.
- */
-export type BannerProp = Omit<AlertProp, "variant">;
-/**
- * @see Callout — the in-prose aside (`<Alert variant="callout">` with the variant fixed).
- *
- * Same contract as {@link AlertProp} minus `variant` and `onDismiss`: a callout is part of the
- * document the reader is reading, so it is never a live region and never dismissible. `kind` is
- * the GitHub/Obsidian admonition preset and resolves `tone` + the leading glyph; pass `tone` or
- * `icon` to override either per instance (gh#765).
- */
-export type CalloutProp = Omit<AlertProp, "variant" | "onDismiss"> & {
-    kind?: CalloutKindProp;
-};
 /** @see AlertTitle */
 export type AlertTitleProp = React.HTMLAttributes<HTMLParagraphElement> & {
     className?: ClassNameProp;
@@ -194,23 +188,11 @@ export type SkeletonProp = React.HTMLAttributes<HTMLDivElement> & {
      */
     loading?: boolean;
 };
-/** @see SkeletonAvatar */
-export type SkeletonAvatarProp = {
+/** The leading avatar box of a {@link SkeletonArticleProp} (`avatar={{ size, shape }}`). */
+export type SkeletonArticleAvatarProp = {
     /** Box, from the `--control-height` tier — the same tier the real `Avatar` sizes from. */
     size?: SizeProp;
     shape?: AvatarShapeProp;
-    active?: boolean;
-    className?: ClassNameProp;
-};
-/** @see SkeletonButton */
-export type SkeletonButtonProp = {
-    size?: SizeProp;
-    /** Corner, in `Button`'s own vocabulary: `pill` is antd's `shape="round"`. */
-    shape?: ShapeProp;
-    /** Fill the inline axis, for a button that spans its column (antd's `block`). */
-    block?: boolean;
-    active?: boolean;
-    className?: ClassNameProp;
 };
 /** @see SkeletonInput */
 export type SkeletonInputProp = {
@@ -219,17 +201,6 @@ export type SkeletonInputProp = {
     active?: boolean;
     className?: ClassNameProp;
 };
-/** @see SkeletonNode — a square standing in for a media/custom slot; `children` centres in it. */
-export type SkeletonNodeProp = {
-    active?: boolean;
-    children?: ChildrenProp;
-    className?: ClassNameProp;
-};
-/** @see SkeletonImage */
-export type SkeletonImageProp = {
-    active?: boolean;
-    className?: ClassNameProp;
-};
 /**
  * @see SkeletonArticle — antd's own `<Skeleton>` shape (avatar + title + paragraph). It is a
  * SIBLING of `Skeleton`, not a replacement: `Skeleton` here is the block antd spells
@@ -237,7 +208,7 @@ export type SkeletonImageProp = {
  * renders.
  */
 export type SkeletonArticleProp = {
-    avatar?: boolean | Pick<SkeletonAvatarProp, "size" | "shape">;
+    avatar?: boolean | SkeletonArticleAvatarProp;
     /** The heading line. NOT a string title — `false` drops the line, `{ width }` re-measures it. */
     title?: boolean | {
         width?: SkeletonWidth;

package/dist/props/components/general.prop.d.ts

@@ -1,6 +1,6 @@
 /** Foundation component prop types — @see docs/COMPONENTS.md#foundation */
 import type * as React from "react";
-import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DescriptionProp, DisabledProp, FontWeightProp, HeadingLevelProp, IconSizeProp, IdProp, InViewAmountProp, LabelProp, OnClickProp, OnOpenChangeProp, OpenProp, PendingProp, RevealDelayProp, RevealTriggerProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp, TextBreakProp, TitleLevelProp, TypographyActionsConfigProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyTypeProp } from "../vocabulary/index.js";
+import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DescriptionProp, DisabledProp, FontWeightProp, HeadingLevelProp, IconSizeProp, IdProp, InViewAmountProp, LabelProp, OnClickProp, OnOpenChangeProp, OpenProp, PendingProp, RevealDelayProp, RevealTriggerProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp, TextBreakProp, TypographyActionsConfigProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyTypeProp } from "../vocabulary/index.js";
 /**
  * @see Text — typographic primitive; replaces hand-rolled `<span className="text-[13px] …">`.
  *
@@ -127,24 +127,7 @@ export type HeadingProp = Omit<React.HTMLAttributes<HTMLHeadingElement>, "color"
     weight?: FontWeightProp;
 };
 /**
- * @see Typography — antd's plain `<article>` wrapper for a run of prose (`TypographyProps`).
- *
- * It carries no emphasis of its own; it is the container `Title` / `Paragraph` / `Text` / `Link`
- * sit inside, and the thing `Typography.Text` etc. hang off as a compound component.
- */
-export type TypographyProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & {
-    /** Rendered element. Default `article`, matching antd. */
-    as?: string;
-    /**
-     * antd's (private) `component` — the rendered element.
-     *
-     * `as` is the spelling this library documents, and `as` WINS when both are passed. `component`
-     * exists so antd code pastes in unchanged.
-     */
-    component?: string;
-};
-/**
- * The antd `BlockProps` behaviour shared by `Text` / `Title` / `Paragraph` / `Link`.
+ * The antd `BlockProps` behaviour shared by `Text` / `Link`.
  *
  * The seven decoration flags each WRAP the content in a real element, in antd's own nesting order
  * (strong → u → del → code → mark → kbd → i), so the meaning reaches a screen reader instead of
@@ -189,51 +172,6 @@ export type TypographyBlockProp = {
     /** antd's (private) `component` alias for `as`; `as` wins when both are passed. */
     component?: string;
 };
-/**
- * @see Title — antd `Typography.Title`.
- *
- * A SIBLING of `Heading`, not a replacement: `Heading` is this library's own four-level heading and
- * stays exactly as it was. `Title` is antd's, so it reaches level 5 and carries the block
- * behaviours (`copyable`, `editable`, `ellipsis`, the decorations).
- *
- * antd omits `strong` from `TitleProps` because a heading is already `fontWeightStrong`; that
- * omission is ported.
- *
- * NAMED `TypographyTitleProp`, not `TitleProp`, for one measured reason: `TitleProp` is already a
- * VOCABULARY type (`vocabulary/content.prop.ts` — the ReactNode heading slot a Card / Dialog /
- * PageContainer takes), and `src/props/index.ts` re-exports `./vocabulary` and `./components`
- * through the same `export *`. A second `TitleProp` there is an ambiguous re-export, which TS
- * resolves by dropping BOTH. The component and its public `TitleProps` alias are still spelled
- * antd's way; only the internal type name moves.
- */
-export type TypographyTitleProp = Omit<React.HTMLAttributes<HTMLHeadingElement>, "color"> & Omit<TypographyBlockProp, "strong"> & {
-    /** Heading level 1…5 — sets the `--heading-h*` size token AND the `<h1>`…`<h5>` element. */
-    level?: TitleLevelProp;
-    /** Override the rendered element (a visual h2 that is a real `<h1>`). */
-    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "div";
-    /** Semantic colour intent. Outranks antd's `type`. */
-    tone?: TextToneProp;
-    align?: TextAlignProp;
-    /** This library's single-line ellipsis. `ellipsis` outranks it when both are passed. */
-    truncate?: boolean;
-    /** Weight (system canon: 400 · 500 · 700). Default `medium`. */
-    weight?: FontWeightProp;
-    /** Truncation — `true` is one line; the object form is antd's full `EllipsisConfig`. */
-    ellipsis?: boolean | TypographyEllipsisConfigProp;
-};
-/**
- * @see Paragraph — antd `Typography.Paragraph`.
- *
- * antd renders it as a `<div>`, not a `<p>`, because the editing textarea and the action cluster
- * are block content that a `<p>` may not legally contain. That is ported verbatim; pass
- * `as="p"` when the content is known to be phrasing-only.
- */
-export type ParagraphProp = Omit<TextProp, "ellipsis" | "as"> & {
-    /** Rendered element. Default `div` — antd's choice; see above. */
-    as?: "div" | "p" | "span";
-    /** Truncation — `true` is one line; the object form is antd's full `EllipsisConfig`. */
-    ellipsis?: boolean | TypographyEllipsisConfigProp;
-};
 /**
  * @see Link — antd `Typography.Link`.
  *

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

@@ -6,5 +6,13 @@ export type { ChartDatum, ChartSeriesProp, LineChartProp, BarChartProp, AreaChar
 export type { AlertQueryErrorProp, AuthExpiryProviderProp, AlertProp, DialogProp, DialogContentProp, AlertTitleProp, AlertContentProp, AlertDescriptionProp, AlertActionsProp, SheetResponsiveProp, SkeletonRowsProp, } from "./feedback.prop.js";
 export type { DataStateProp, InfiniteQueryStateProp, InfiniteQueryHelpers, PrefetchLinkProp, } from "./query.prop.js";
 export type { DropdownMenuPlacementProp, DropdownMenuTriggerActionProp, PaginationProp, PaginationSizeProp, PaginationAlignProp, StepsProp, StepItemProp, StepStatusProp, StepsTypeProp, TabsProp, TabItemProp, TabsVariantProp, TabsPlacementProp, TabsExtraProp, TabsOnEditProp, } from "./navigation.prop.js";
-export type { AppProviderProp, AppContextValue, AppSettingKind, AppSettingPickerProp, AppSettingToggleKind, AppSettingToggleProp, ThemeScopeProp, } from "./app.prop.js";
+export type { AppProviderProp, AppContextValue, AppSettingKind, AppSettingPickerProp, AppSettingPickerMenuProp, AppSettingPickerCycleProp, AppSettingCycleKind, ThemeScopeProp, } from "./app.prop.js";
 export type { ZodSchemaProp, UseZodFormOptionsProp, UseZodFormReturnProp, FormRootProp, FormFieldControlProp, FieldErrorMessageProp, } from "./form.prop.js";
+export type { ChatBubbleListProp, ChatBubbleProp, ChatBubbleToneProp, ChatBubbleTypingProp, ThoughtChainItemProp, ThoughtChainProp, ThoughtChainStatusProp, WelcomeProp, } from "./data-display.prop.js";
+export type { AttachmentsItemProp, AttachmentsPlaceholderProp, AttachmentsProp, AttachmentsRefProp, ChatComposerProp, ChatSuggestionItemProp, ChatSuggestionProp, } from "./data-entry.prop.js";
+export type { ActionsCopyProp, ActionsFeedbackProp, ActionsItemProp, ActionsItemsProp, ActionsProp as ActionsBarProp, } from "./general.prop.js";
+export type { ConversationsCreationProp, ConversationsEntryProp, ConversationsGroupableProp, ConversationsItemProp, ConversationsMenuProp, ConversationsProp, } from "./navigation.prop.js";
+export type { ChatBubblePlacementProp, ChatBubbleVariantProp, ChatMessageProp, ThoughtChainItemsProp, ThoughtChainLineProp, ThoughtChainVariantProp, WelcomeVariantProp, } from "./data-display.prop.js";
+export type { AttachmentsOverflowProp, ChatComposerActionComponents, ChatComposerFooterProp, ChatComposerSubmitTypeProp, ChatSuggestionRenderProp, } from "./data-entry.prop.js";
+export type { ActionsFeedbackValueProp, ActionsStatusProp, ActionsVariantProp, } from "./general.prop.js";
+export type { ConversationsDividerProp, ConversationsMenuItemProp } from "./navigation.prop.js";

package/dist/props/components/layout.prop.d.ts

@@ -356,56 +356,25 @@ export type FlexProp = React.HTMLAttributes<HTMLElement> & {
      * geometry; a Flex that is a row of controls has no business carrying it.
      */
     measure?: FlexMeasureProp;
-};
-/**
- * @see SpaceCompact — antd `Space.Compact`, a row of controls welded into one visual unit: the
- * inner corner radii are zeroed and the shared border is collapsed so two boxes read as one,
- * while each child keeps its own focus ring and its own `size`.
- *
- * ## Deviations from `antd/es/space/Compact.d.ts` (read at `@ant-design/x` install time, not
- * from memory — see the PR for the exact checkout), each written down per `DESIGN-AUTHORITY.md`
- *
- * - **No `Space`.** antd's `Space.Compact` is a static member of `Space`; this library has no
- *   `Space` at all, and does not gain one here — `Space`'s only other job (gaps between siblings)
- *   already lives on `Flex`/`ResponsiveGrid` `gap`, so a `Space` built only to host `.Compact`
- *   would duplicate that primitive for nothing (`docs/roadmap/parity-audit-layout-navigation-
- *   general.md` §4.2 marks bare `Space` a composition, not a gap). `SpaceCompact` ships standalone
- *   — the same flat-export shape as `CheckboxGroup`/`ToggleGroup`/`SearchSelect`/`TagInput`, not a
- *   `Space.Compact` dotted member.
- * - **`size` → `density`, not forwarded.** antd's `size?: SizeType` (`small|middle|large`) is the
- *   `ConfigProvider` ambient-size cascade (`SpaceCompactItemContext`/`useCompactItemContext`,
- *   read by antd's own `Input`/`Select`/`Button`) — the exact capability this library already
- *   owns under `density` (`compact|default|comfortable`, `docs/DESIGN-AUTHORITY.md` "A capability
- *   this library already has keeps its own name"). `density` scopes `--scaling` to this row via
- *   `.ui-density-*` (the same class `Form.density`/`FormRoot.density` already emit), and each
- *   child keeps its OWN `size` (`SizeProp`) exactly as it does anywhere else — a second axis
- *   would be the duplicate spelling `check:prop-vocabulary` exists to prevent.
- * - **`direction` not ported, only `orientation`.** The installed `SpaceCompactProps.direction` is
- *   itself `@deprecated please use \`orientation\` instead`; only the current, non-deprecated name
- *   is carried, reusing the vocabulary `OrientationProp` already shared by `Separator`/`Steps`/
- *   `RadioGroup`/`Toolbar` rather than a second `"horizontal" | "vertical"` spelling.
- * - **`block` → `fullWidth`.** Same rename already applied to `Button.block`
- *   (`ButtonProp.fullWidth`) for the same reason — "this library's controlled vocabulary wins on
- *   values" — so one word means the same thing on both components.
- * - **No `prefixCls`/`rootClassName`.** Plumbing for antd's `prefixCls`-rooted styling system,
- *   which this library does not have; every component here takes one `className`.
- */
-export type SpaceCompactProp = Omit<React.HTMLAttributes<HTMLDivElement>, "children"> & {
-    /** The controls to weld into one row — antd `Space.Compact` children. */
-    children?: ChildrenProp;
-    /** Layout axis. Default `horizontal` (antd `orientation`, `direction` deprecated upstream). */
-    orientation?: OrientationProp;
-    /** antd's boolean spelling of `orientation="vertical"`. `orientation` wins when both are set. */
-    vertical?: boolean;
     /**
-     * Row fills its parent's inline size (antd `block`, renamed to match `Button.fullWidth`). Field
-     * children grow to fill it; a Button (any non-field child) keeps its content width (gh#1062).
+     * WELD the children into one control — antd `Space.Compact` (v32 #1223 folded `SpaceCompact`
+     * in here). Each child gets a flex-item wrapper of its own, the inner corner radii are zeroed and
+     * the shared border collapses into one seam, while every child keeps its own focus ring, name
+     * and `size`. `direction` picks the axis (`"row"` default, `"col"`; a responsive object reads
+     * its `base`); `gap`, `wrap`, `pad` and the other layout knobs do not apply — a seam has no gap.
+     *
+     * The corner zeroing covers the INLINE seam only: the Input and trigger families expose
+     * inline-start/-end radius knobs and no block-axis pair yet, so a `"col"` stack collapses its
+     * shared border but each child keeps its own four corners.
+     */
+    attached?: boolean;
+    /**
+     * `attached` only: the joined row fills its parent's inline size (antd `block`). Field children
+     * grow to fill it; a Button (any non-field child) keeps its content width (gh#1062).
      */
     fullWidth?: boolean;
-    /** Scoped control density for the whole row (antd `Space.Compact` `size`). */
+    /** `attached` only: scoped control density for the whole joined row (antd `size`). */
     density?: DensityProp;
-    id?: IdProp;
-    className?: ClassNameProp;
 };
 /** Container column counts; omitted steps inherit from the previous step. Base defaults to 1. */
 export type ResponsiveGridColumnsProp = number | {
@@ -616,14 +585,22 @@ export type AppShellProp = {
     onMobileNavOpenChange?: (open: boolean) => void;
 };
 /**
- * @see AuthShell — centred auth/login page shell (login · mfa · passkey · device · reset). A
+ * @see CenteredShell `variant="auth" | "auth-canonical"` — the centred auth/login page shell
+ * (login · mfa · passkey · device · reset; the former `AuthShell`, folded in by v32 #1223). A
  * top brand bar, a centred `main` that holds the auth `Card`, and an optional footer, over a
  * `min-h-dvh` surface. The shell scopes `--control-height` to the comfortable tier (44px, the WCAG
  * touch floor) and bumps the auth heading size so forms read at the right density — replacing
  * consumers' hand-rolled `.auth-shell-*` / `.ui-auth-scope` classes. Motion is delegated to
  * `Reveal` (wrap the card) so `prefers-reduced-motion` is honoured at one place.
  */
-export type AuthShellProp = {
+export type CenteredShellAuthProp = {
+    /**
+     * `"auth"` is the unauthenticated root (login/mfa/reset): a brand bar, a vertically centred auth
+     * card, an optional footer. `"auth-canonical"` is the same shell on the shared DXS compact
+     * geometry (36px controls, 22.5rem card measure, responsive page insets) through component
+     * tokens — what `AuthShell variant="canonical"` was.
+     */
+    variant: "auth" | "auth-canonical";
     /** Centred content — typically a single auth `<Card>` with the form. */
     children: ReactNode;
     /** Brand bar slot pinned to the top (e.g. a `<Logo>` / product mark). */
@@ -637,11 +614,6 @@ export type AuthShellProp = {
     actions?: ActionProp;
     /** Footer slot pinned to the bottom (legal links, locale switch, support). */
     footer?: ReactNode;
-    /**
-     * Visual contract for the auth surface. `"canonical"` applies the shared DXS compact geometry
-     * (36px controls, 22.5rem card measure, and responsive page insets) through component tokens.
-     */
-    variant?: "default" | "canonical";
     /**
      * Named flow MEASURE — the page geometry contract for one canonical hosted-identity flow: the
      * auth card's max-width plus the desktop and mobile page gutters, all owned by component tokens
@@ -836,8 +808,8 @@ export type AuthIdentityProp = {
     /**
      * Brand artwork rendered in the mark's place, for a service whose design supplies a real
      * lockup (mark + wordmark, sometimes a product suffix) rather than the bare GoDX mark. Leave
-     * it out and the canonical `<Logo mark="godx">` renders, which is right for every plain
-     * hosted-GoDX surface.
+     * it out and the active preset's `brandMark` renders (`godxPreset` draws `<Logo mark="godx">`);
+     * with no preset, no mark renders (v32, gh#1220). `null` always renders no mark.
      *
      * The node takes the MARK's slot only: `data-slot="auth-identity"`, the `.ui-auth-identity`
      * spacing and the `h1` contract are untouched, so a consumer swapping artwork does not fork
@@ -907,7 +879,12 @@ export type AuthAccountSummaryProp = {
  * account page needs ZERO custom CSS and never hand-rolls a bar (the `.ui-topbar` zero-inset
  * footgun). Layout-only; delegate motion to `Reveal`.
  */
-export type CenteredShellProp = {
+export type CenteredShellPageProp = {
+    /**
+     * `"page"` (default): the authenticated, no-sidebar, centred-column page. `"auth"` /
+     * `"auth-canonical"` switch to the unauthenticated auth shell ({@link CenteredShellAuthProp}).
+     */
+    variant?: "page";
     /** Centred column content — page sections (identity hero, org picker, service grid, team list). */
     children: ReactNode;
     /**
@@ -935,6 +912,13 @@ export type CenteredShellProp = {
     preset?: CenteredShellPresetProp;
     className?: ClassNameProp;
 };
+/**
+ * @see CenteredShell — ONE centred root shell in two shapes (v32 #1223): the authenticated
+ * centred-column page (`variant="page"`, default) and the unauthenticated auth shell
+ * (`variant="auth" | "auth-canonical"`, the former `AuthShell`). The variant decides which props
+ * apply, so a page-only prop on an auth shell (or the reverse) is a type error.
+ */
+export type CenteredShellProp = CenteredShellPageProp | CenteredShellAuthProp;
 /**
  * @see ErrorSurface — the optional maintenance / planned-outage timing slot (503, occasionally a
  * planned 500).
@@ -1410,7 +1394,7 @@ export type AppLauncherProp = {
      */
     responsive?: "auto" | "popover" | "sheet" | "fullscreen";
     /**
-     * The BOX the trigger takes — the same split `AppSettingToggle` draws, and for the same reason.
+     * The BOX the trigger takes — the same split `AppSettingPicker menu={false}` draws, and for the same reason.
      * `bar` (default) is a `TopbarItem`: a cell as tall as the bar, whose hover is the bar's own
      * surface. `icon` is a square ghost `Button`, for chrome that is NOT a bar — a nav rail, a card
      * header, a toolbar. A `TopbarItem` outside a bar has nothing to bleed to: it stretches to a