@godxjp/ui 23.2.1 → 23.4.0

package/dist/props/components/data-entry.prop.d.ts

@@ -778,6 +778,17 @@ export type PickerDateFormatProp = string | Intl.DateTimeFormatOptions | ((date:
  * `value`/`defaultValue`/`onValueChange` rather than antd's `onChange`.
  */
 export type DatePickerBaseProp = FieldA11yProps & PickerChromeProp & {
+    /**
+     * The accessible NAME of the button that opens the calendar, for a screen where more than one
+     * date field exists. Default 「カレンダーを開く」 / "Open calendar" — correct for one picker on a
+     * page, and useless for three: a reader hears the same sentence three times with nothing to
+     * say which field each button belongs to (WCAG 2.2 SC 2.4.6, gh#551).
+     *
+     * Same axis, same shape, same reason as Select's `clearLabel`: name the control after the
+     * FIELD it serves — `開始日のカレンダーを開く`. The default is unchanged, so nothing moves until
+     * a caller says something.
+     */
+    triggerLabel?: string;
     /** Display format; native submission remains ISO. */
     format?: PickerDateFormatProp;
     /** Parser for a custom display function or Intl era display; ISO always remains accepted. */
@@ -1877,3 +1888,79 @@ export type ChatSuggestionProp = {
     id?: IdProp;
     className?: ClassNameProp;
 };
+/** Ant Design X `Attachments` overflow modes — how the card list behaves when it exceeds its box. */
+export type AttachmentsOverflowProp = "wrap" | "scrollX" | "scrollY";
+/** Placeholder copy/icon when the attachment list is empty. Ant Design X `PlaceholderType`. */
+export type AttachmentsPlaceholderProp = {
+    icon?: React.ReactNode;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+};
+/**
+ * One attachment row — Ant Design X `Attachment`, which extends antd `UploadFile` plus optional
+ * `description` and `cardType`. Field names are antd's (`thumbUrl`, `originFileObj`, …) so an Ant
+ * X call site compiles unchanged; internally the upload engine maps them to `UploadFileItem`.
+ *
+ * @see Attachments
+ */
+export type AttachmentsItemProp = {
+    uid: string;
+    name: string;
+    size?: number;
+    status?: "uploading" | "done" | "error" | "removed";
+    percent?: number;
+    url?: string;
+    thumbUrl?: string;
+    originFileObj?: File;
+    response?: unknown;
+    error?: unknown;
+    description?: React.ReactNode;
+    cardType?: string;
+};
+/** Semantic slots Ant Design X exposes on `Attachments`. */
+export type AttachmentsSemanticProp = "list" | "placeholder" | "upload" | "root" | "card" | "file";
+/**
+ * @see Attachments — the chat-surface attachment collection (Ant Design X `Attachments`).
+ *
+ * Inherits antd Upload behaviour (`accept`, `beforeUpload`, `customRequest`, …) but names the file
+ * list `items` (not `fileList`) and fires `onChange` with antd's `{ file, fileList }` shape. The
+ * ref exposes `nativeElement`, `fileNativeElement`, `upload(file)` and `select({ accept, multiple
+ * })` exactly as Ant X documents.
+ */
+export type AttachmentsProp = Omit<UploadProp, "value" | "defaultValue" | "onValueChange" | "variant" | "showUploadList" | "children" | "onRemove"> & {
+    /** Controlled attachment list. Ant Design X `items` (= antd Upload `fileList`). */
+    items?: readonly AttachmentsItemProp[];
+    /** Fires when the list changes. Ant Design X / antd Upload `onChange`. */
+    onChange?: (info: {
+        file: AttachmentsItemProp;
+        fileList: AttachmentsItemProp[];
+    }) => void;
+    /** antd Upload `onRemove` — receives the attachment row being removed. */
+    onRemove?: (item: AttachmentsItemProp) => boolean | void | Promise<boolean | void>;
+    /** How overflowing cards layout. Ant Design X `overflow`. */
+    overflow?: AttachmentsOverflowProp;
+    /** Empty-state copy, or a function for inline vs drop variants. Ant Design X `placeholder`. */
+    placeholder?: AttachmentsPlaceholderProp | ((type: "inline" | "drop") => AttachmentsPlaceholderProp);
+    /** Host element for a full-screen drop overlay. Ant Design X `getDropContainer`. */
+    getDropContainer?: (() => HTMLElement | null | undefined) | null;
+    /** Semantic class names. Ant Design X `classNames`. */
+    classNames?: Partial<Record<AttachmentsSemanticProp, string>>;
+    /** Semantic inline styles. Ant Design X `styles`. */
+    styles?: Partial<Record<AttachmentsSemanticProp, React.CSSProperties>>;
+    /** Root class on the outermost node. Ant Design X `rootClassName`. */
+    rootClassName?: ClassNameProp;
+    /** Child mode: the visible trigger; upload runs through a hidden input beside it. Ant Design X `children`. */
+    children?: React.ReactElement;
+    /** Passthrough to the preview image. Ant Design X `imageProps` — reserved; no Image primitive yet. */
+    imageProps?: Record<string, unknown>;
+};
+/** Imperative handle Ant Design X documents on `Attachments` ref. */
+export type AttachmentsRefProp = {
+    nativeElement?: HTMLDivElement | null;
+    fileNativeElement?: HTMLInputElement | null;
+    upload: (file: File) => void;
+    select: (options?: {
+        accept?: string;
+        multiple?: boolean;
+    }) => void;
+};

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

@@ -1,7 +1,40 @@
 /** 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, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, ShapeProp, SizeProp, ToneProp, TitleProp } from "../vocabulary/index.js";
+import type { AlertVariantProp, AvatarShapeProp, CancelLabelProp, ChildrenProp, ClassNameProp, ConfirmLabelProp, ConfirmVariantProp, DefaultOpenProp, DescriptionProp, HandlerProp, IconProp, OpenProp, OnOpenChangeProp, PendingProp, ShapeProp, SizeProp, ToneProp, TitleProp } from "../vocabulary/index.js";
+/**
+ * @see Dialog — the compound modal ROOT.
+ *
+ * `variant` is the one prop that answers gh#567: it decides the ARIA role, whether an
+ * outside click dismisses, and the primary action's emphasis together, because those three
+ * always travel together. Set it here to cover the whole tree, or on `DialogContent` for one
+ * surface. `variant="destructive"` IS the 12 `AlertDialog*` exports, which stay for
+ * compatibility — see the file header of `components/feedback/dialog.tsx`.
+ */
+export type DialogProp = {
+    open?: OpenProp;
+    defaultOpen?: DefaultOpenProp;
+    onOpenChange?: OnOpenChangeProp;
+    variant?: ConfirmVariantProp;
+    /** Kept from Radix. RAC's `Modal` always locks scroll, so `false` no longer turns that off. */
+    modal?: boolean;
+    children?: ChildrenProp;
+};
+/**
+ * @see DialogContent — the modal surface. `variant` overrides the root's for this surface and
+ * is what actually resolves `role`, outside-click dismissal and the ✕ default.
+ */
+export type DialogContentProp = {
+    variant?: ConfirmVariantProp;
+    /** Show the corner ✕. Defaults to `true`, or `false` under `variant="destructive"`. */
+    showCloseButton?: boolean;
+    /** shadcn-era spelling of `showCloseButton`; kept working. */
+    showClose?: boolean;
+    /** Semantic class for the scrim the surface owns (RAC nests overlay → modal → dialog). */
+    overlayClassName?: ClassNameProp;
+    className?: ClassNameProp;
+    children?: ChildrenProp;
+};
 /** @see AlertDialog */
 export type AlertDialogProp = {
     open: OpenProp;
@@ -83,6 +116,25 @@ export type SkeletonRowsProp = {
     rows?: number;
     columns?: number;
 };
+/**
+ * The skeleton of a `Form columns={N}` — label + control PAIRS on the same grid the form uses,
+ * not the flat line list `SkeletonRows` draws (gh#552).
+ *
+ * Why it is its own component rather than `SkeletonRows` with better defaults: `SkeletonRows` has
+ * no idea a form field is two stacked things, so a consumer approximating one got the column count
+ * right and the inside of every cell wrong. Worse, "close enough" is a thing that DRIFTS — change
+ * the form's `columns` and forget the skeleton and the layout jumps again on load, with nothing
+ * red to say so. Sharing `ResponsiveGrid` is what stops that: one `columns` value, one ladder.
+ */
+export type SkeletonFormProp = {
+    /** Columns of the form this stands in for — passed straight to `ResponsiveGrid`. */
+    columns?: number;
+    /** How many label+control pairs to draw. */
+    fields?: number;
+    /** Shimmer, matching the rest of the family. */
+    active?: boolean;
+    className?: string;
+};
 /**
  * A skeleton line's MEASURE. `number` is read as pixels, matching antd's
  * `SkeletonParagraphProps["width"]` (components/skeleton/Paragraph.tsx); a string is any CSS length

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

@@ -1,8 +1,14 @@
 /** Foundation component prop types — @see docs/COMPONENTS.md#foundation */
 import type * as React from "react";
-import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DisabledProp, FontWeightProp, HeadingLevelProp, LabelProp, OnClickProp, PendingProp, RevealDelayProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp } from "../vocabulary/index.js";
-/** @see Text — typographic primitive; replaces hand-rolled `<span className="text-[13px] …">`. */
-export type TextProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & {
+import type { ActivityAnnounceProp, ActivityVariantProp, AsChildProp, ButtonSizeProp, ButtonVariantProp, ChildrenProp, ClassNameProp, DescriptionProp, DisabledProp, FontWeightProp, HeadingLevelProp, IdProp, LabelProp, OnClickProp, OnOpenChangeProp, OpenProp, PendingProp, RevealDelayProp, ShapeProp, SizeProp, TextAlignProp, TextSizeProp, TextToneProp, TextWhitespaceProp, TitleLevelProp, TypographyActionsConfigProp, TypographyCopyConfigProp, TypographyEditConfigProp, TypographyEllipsisConfigProp, TypographyTypeProp } from "../vocabulary/index.js";
+/**
+ * @see Text — typographic primitive; replaces hand-rolled `<span className="text-[13px] …">`.
+ *
+ * This IS antd `Typography.Text`: every prop antd declares on it is here, alongside the props
+ * this library already shipped. Where the two name the same axis, BOTH spellings are accepted and
+ * the winner is stated at the prop — `tone` over `type`, `ellipsis` over `truncate` / `clamp`.
+ */
+export type TextProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & Omit<TypographyBlockProp, "ellipsis"> & {
     /** Render element. Default `span`. */
     as?: "span" | "p" | "div" | "a" | "label" | "strong" | "em" | "small" | "code" | "kbd" | "dt" | "dd" | "caption" | "abbr";
     /**
@@ -37,6 +43,16 @@ export type TextProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & {
      * line-clamp styling (never write the `line-clamp-N` utility page-side).
      */
     clamp?: number;
+    /**
+     * antd `ellipsis`. `true` is one line; the object form carries `suffix`, `symbol`,
+     * `defaultExpanded` / `expanded`, `onEllipsis` and `tooltip`.
+     *
+     * antd omits `rows`, `expandable` and `onExpand` from `Typography.Text` — an inline run has no
+     * second line to expand into — and that omission is ported; reach for `Paragraph` when you want
+     * them. It OUTRANKS this library's own `truncate` and `clamp` when both are passed, because it
+     * is the only spelling that can also carry a suffix or a tooltip.
+     */
+    ellipsis?: boolean | Omit<TypographyEllipsisConfigProp, "rows" | "expandable" | "onExpand">;
     /**
      * Whitespace handling. Default `normal` (CSS's own: newlines and space runs collapse).
      *
@@ -82,6 +98,128 @@ export type HeadingProp = Omit<React.HTMLAttributes<HTMLHeadingElement>, "color"
     /** Weight (system canon: 400 · 500 · 700). Default `medium` — set `bold` for an emphasised title. */
     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 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
+ * only the pixels. That is why `strong` is not folded into `weight` and `code` is not folded into
+ * `mono`: `weight`/`mono` change how the text is painted, these change what it IS.
+ */
+export type TypographyBlockProp = {
+    /** Which side the copy / edit / expand cluster sits on. Default `{ placement: "end" }`. */
+    actions?: TypographyActionsConfigProp;
+    /**
+     * Emphasis, antd's spelling. This library's `tone` is the same axis and is WIDER, so **`tone`
+     * wins** when both are passed. Folds `secondary → muted`, `danger → destructive`.
+     */
+    type?: TypographyTypeProp;
+    /** Renders as unavailable — the disabled foreground, `not-allowed`, and no text selection. */
+    disabled?: boolean;
+    /** Copy affordance. `true` copies the rendered text; the object form is antd's `CopyConfig`. */
+    copyable?: boolean | TypographyCopyConfigProp;
+    /** In-place editing. `true` is the default trigger set; the object form is antd's `EditConfig`. */
+    editable?: boolean | TypographyEditConfigProp;
+    /**
+     * Truncation. `true` is one line; the object form is antd's `EllipsisConfig`.
+     *
+     * `Text` and `Link` NARROW this (antd does too — an inline run has no second line to expand
+     * into), which is why they intersect `Omit<TypographyBlockProp, "ellipsis">` and redeclare it.
+     */
+    ellipsis?: boolean | TypographyEllipsisConfigProp;
+    /** Wrap in `<code>`. (`mono` only swaps the FAMILY; this changes the element and its meaning.) */
+    code?: boolean;
+    /** Wrap in `<mark>` — highlighted. */
+    mark?: boolean;
+    /** Wrap in `<u>` — underlined. */
+    underline?: boolean;
+    /** Wrap in `<del>` — struck through. */
+    delete?: boolean;
+    /** Wrap in `<strong>` — bold, and semantically strong. Composes with `weight`. */
+    strong?: boolean;
+    /** Wrap in `<kbd>` — a key or key combination. */
+    keyboard?: boolean;
+    /** Wrap in `<i>` — italic. */
+    italic?: boolean;
+    /** 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`.
+ *
+ * `Text link` is this library's own inline link affordance and is unchanged. `Link` is antd's
+ * anchor-by-default flavour of it: it renders `<a>`, defaults `tone` to `primary`, and adds
+ * antd's `rel="noopener noreferrer"` guard whenever `target="_blank"` is set without an explicit
+ * `rel`. antd restricts `ellipsis` to a boolean here, and that restriction is ported.
+ */
+export type LinkProp = Omit<TextProp, "ellipsis" | "as"> & {
+    /** Rendered element. Default `a`. */
+    as?: "a" | "span";
+    /** Single-line truncation. antd allows only a boolean on `Link`. */
+    ellipsis?: boolean;
+};
 /** @see Button */
 export type ButtonProp = React.ButtonHTMLAttributes<HTMLButtonElement> & {
     variant?: ButtonVariantProp;
@@ -198,3 +336,302 @@ export type ActivityProp = Omit<React.HTMLAttributes<HTMLSpanElement>, "color">
     announce?: ActivityAnnounceProp;
     className?: ClassNameProp;
 };
+/**
+ * FloatButton `type` — the two fills Ant Design gives the corner mark.
+ *
+ * Ported verbatim from antd 6.6.3 (`FloatButtonType`), including the name `type`, which is NOT
+ * this library's usual word for a fill (everything else says `variant`). Keeping antd's spelling
+ * is the point: a consumer porting a screen copies the antd call and it compiles. The two values
+ * map onto the two `Button` variants that already carry those fills — `default` → `outline`
+ * (a white/surface pill with a hairline), `primary` → `default` (the brand fill).
+ */
+export type FloatButtonTypeProp = "default" | "primary";
+/**
+ * FloatButton `shape` — a round mark or a rounded square.
+ *
+ * antd's own vocabulary (`FloatButtonShape`), deliberately NOT the control `ShapeProp`
+ * (`default | pill | sharp`) and NOT `AvatarShapeProp` (which is documented as an ENTITY mark).
+ * `square` is the only shape antd lets carry text: `circle` + `content` is an antd dev warning,
+ * and this port raises the same one.
+ */
+export type FloatButtonShapeProp = "circle" | "square";
+/**
+ * What opens a `FloatButton.Group`'s menu. antd `FloatButtonGroupTrigger`.
+ *
+ * Absent (the default) means the group is NOT a menu at all — it is a plain stack of buttons, all
+ * of them visible, with no trigger. That is antd's `isMenuMode = trigger && …` branch, and it is
+ * why `trigger` has no default value.
+ */
+export type FloatButtonTriggerProp = "click" | "hover";
+/**
+ * Which side of the trigger a `FloatButton.Group` menu opens towards. antd `placement`.
+ *
+ * PHYSICAL words, not logical ones, because they are antd's and a port that renamed them would
+ * break the copy-paste this whole component exists to allow. The stylesheet resolves `left` /
+ * `right` through `inset-inline-*`, so the RENDERED side still flips under `dir="rtl"`.
+ */
+export type FloatButtonPlacementProp = "top" | "left" | "right" | "bottom";
+/**
+ * The count/dot mark on a `FloatButton`'s corner. antd passes its whole `BadgeProps` here minus
+ * `status`/`text`/`title`/`children`; this is that surface restricted to the fields that survive
+ * this library's rules.
+ *
+ * NOT ported from antd's badge: `offset` (a raw `[x, y]` px tuple — geometry hand-written at the
+ * call site, which `no-hardcoded-geometry` forbids and no token step spells) and `size`
+ * (`default | small`, a second size ladder for a mark that is already the smallest thing on the
+ * button).
+ */
+export type FloatButtonBadgeProp = {
+    /** The number on the mark. Omit it (or pass `dot`) for a mark that carries no figure. */
+    count?: number;
+    /** A bare dot — "there is something here" with no quantity. Wins over `count`. */
+    dot?: boolean;
+    /** Cap: a `count` above this renders as `{overflowCount}+`. Default `99`, antd's. */
+    overflowCount?: number;
+    /** Whether `count={0}` still paints a mark. Default `false`, antd's. */
+    showZero?: boolean;
+    /** The mark's OWN colour as a CSS colour — data, not a semantic tone. Default: the brand fill. */
+    color?: string;
+};
+/**
+ * @see FloatButton — Ant Design's corner action: a control pinned to the viewport, above the
+ * page, for a tool that must stay reachable but is not part of this page's content.
+ *
+ * Ported from antd 6.6.3. `Button` is in the layout flow, so pinning one meant a consumer writing
+ * `position: fixed` themselves — page-local CSS that `ui-audit` blocks with no legal replacement
+ * (gh#558). The corner insets are `--float-button-offset-block-end` / `-inline-end`, so a service
+ * moves the mark by retuning a token instead of writing a media query.
+ *
+ * Deliberately NOT ported from antd: `classNames` / `styles` (per-slot style holes — they freeze
+ * internal DOM slot names into public API, which docs/WHAT-BELONGS-HERE.md rules out by name),
+ * `prefixCls` / `rootClassName` (antd's CSS-in-JS plumbing; this library ships static classes) and
+ * `_InternalPanelDoNotUseOrYouWillBeFired`.
+ */
+export type FloatButtonProp = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type" | "content" | "color"> & {
+    /** The glyph. Defaults to a document mark when the button carries no `content`, as antd does. */
+    icon?: ChildrenProp;
+    /**
+     * A short line UNDER the icon. antd 6 renamed this to `content`; both spellings are accepted and
+     * `content` wins, exactly as antd resolves them.
+     *
+     * @deprecated Use `content`.
+     */
+    description?: DescriptionProp;
+    /** A short line under the icon. Only legal with `shape="square"` — a circle has no room. */
+    content?: ChildrenProp;
+    /** Fill. Default `default`. */
+    type?: FloatButtonTypeProp;
+    /** Round mark or rounded square. Default `circle`. Inherited from an enclosing Group. */
+    shape?: FloatButtonShapeProp;
+    /**
+     * Hover/focus label. A plain node is the tooltip's content; the object form takes the same
+     * `side` / `align` / `sideOffset` the `TooltipContent` primitive takes.
+     *
+     * When it is a STRING and no `aria-label` is given, it also becomes the button's accessible
+     * name — an icon-only control with no name is a WCAG 4.1.2 failure, and a tooltip alone never
+     * reaches a touch user.
+     */
+    tooltip?: ChildrenProp | FloatButtonTooltipProp;
+    /** Renders an `<a>` instead of a `<button>`. antd's `href`. */
+    href?: string;
+    /** Anchor target; only meaningful beside `href`. */
+    target?: React.HTMLAttributeAnchorTarget;
+    /** Count / dot mark on the corner. */
+    badge?: FloatButtonBadgeProp;
+    /** Non-interactive. Inherited by a Group's trigger. */
+    disabled?: DisabledProp;
+    /** The `<button type>` attribute, since `type` is taken by the fill. Default `button`. antd 5.21+. */
+    htmlType?: "button" | "submit" | "reset";
+    className?: ClassNameProp;
+};
+/**
+ * The object form of `FloatButton tooltip` — the subset of this library's `TooltipContent` props
+ * that positions a tooltip. antd passes its whole `TooltipProps` here; the placement fields are
+ * the ones that survive, because everything else antd offers (`color`, `overlayStyle`,
+ * `overlayClassName`) is a style hole.
+ */
+export type FloatButtonTooltipProp = {
+    /** What the tooltip says. */
+    title?: ChildrenProp;
+    /** Edge of the button the tooltip attaches to. Default `left`, so it clears the viewport edge. */
+    side?: "top" | "right" | "bottom" | "left";
+    /** Alignment along that edge. */
+    align?: "start" | "center" | "end";
+    /** Gap between button and tooltip, in px. */
+    sideOffset?: number;
+};
+/**
+ * @see FloatButton.Group — a stack of corner actions, optionally behind one trigger.
+ *
+ * Two modes, and `trigger` is the switch, exactly as in antd: WITHOUT it the group is a plain
+ * stack (every button visible, no trigger rendered); WITH it the children collapse behind a
+ * trigger that opens them on click or on hover.
+ */
+export type FloatButtonGroupProp = Omit<FloatButtonProp, "content" | "description" | "href"> & {
+    /** The buttons. `FloatButton` children inherit the group's `shape`. */
+    children?: ChildrenProp;
+    /** Menu mode: what opens the stack. Omit for a plain always-open stack. */
+    trigger?: FloatButtonTriggerProp;
+    /** Controlled open state. antd warns when it is passed without `trigger`; so does this. */
+    open?: OpenProp;
+    /** Fires when the menu opens or closes. */
+    onOpenChange?: OnOpenChangeProp;
+    /** Glyph on the trigger while the menu is OPEN. Default: a close mark. */
+    closeIcon?: ChildrenProp;
+    /** Which way the menu opens. Default `top`. */
+    placement?: FloatButtonPlacementProp;
+};
+/**
+ * @see FloatButton.BackTop — the corner action that returns a scroll container to the top once
+ * the reader is `visibilityHeight` px down it.
+ *
+ * `target` is antd's, and it is what makes this work in a shell that owns its own scroll: pass
+ * `() => element` and BackTop watches that element instead of the document — which is the answer
+ * to the objection that a document-bound BackTop competes with `MobileShell`'s single scroll
+ * region.
+ */
+export type FloatButtonBackTopProp = Omit<FloatButtonProp, "href" | "target"> & {
+    /** Scroll distance, in px, before the button appears. Default `400` (antd's). */
+    visibilityHeight?: number;
+    /** The scroll container to watch and to scroll. Default: the owning document. */
+    target?: () => HTMLElement | Window | Document | null;
+    /** Scroll-to-top animation length in ms. Default `450` (antd's); `prefers-reduced-motion` → 0. */
+    duration?: number;
+    /** Paint how far down the container the reader is, as a ring. Default `false`. antd 6.6+. */
+    showProgress?: boolean;
+    /** Fires after the scroll is started. */
+    onClick?: React.MouseEventHandler<HTMLElement>;
+};
+/**
+ * Ant Design X `Actions variant`. Governs the strip's chrome, not the buttons' intent:
+ * `borderless` (the default) is a bare row of ghost buttons, `filled` gives the strip a tinted
+ * ground, `outlined` a hairline boundary.
+ * @see Actions
+ */
+export type ActionsVariantProp = "borderless" | "filled" | "outlined";
+/**
+ * Ant Design X `ACTIONS_ITEM_STATUS` — the four states one action can be in while it runs.
+ * @see ActionsItem
+ */
+export type ActionsStatusProp = "default" | "running" | "loading" | "error";
+/**
+ * Ant Design X `ActionsFeedback` value. `default` is "no opinion recorded", not "absent".
+ * @see ActionsFeedback
+ */
+export type ActionsFeedbackValueProp = "like" | "dislike" | "default";
+/** @see Actions — one action in the strip. Ant Design X `ItemType`. */
+export type ActionsItemsProp = {
+    /** Identity handed back to `onClick`. Ant Design X `key`. */
+    key: string;
+    /**
+     * What the action is called. It is the button's ACCESSIBLE NAME and its tooltip, not just the
+     * tooltip — Ant X puts it in a `Tooltip` only, so its icon-only `<div onClick>` reaches a screen
+     * reader as nothing at all. A plain string, because `aria-label` cannot carry a node.
+     */
+    label?: string;
+    /** The glyph. Ant Design X `icon`. */
+    icon?: React.ReactNode;
+    /** Per-item handler. When present it WINS over the strip's `onClick`. Ant Design X `onItemClick`. */
+    onItemClick?: (item: ActionsItemsProp) => void;
+    /** Paint the action as irreversible. Ant Design X `danger`. */
+    danger?: boolean;
+    /** Nest the action into a menu behind one trigger. Ant Design X `subItems`. */
+    subItems?: readonly Omit<ActionsItemsProp, "subItems" | "actionRender">[];
+    /** Replace the rendered action entirely. Ant Design X `actionRender`. */
+    actionRender?: ((item: ActionsItemsProp) => React.ReactNode) | React.ReactNode;
+};
+/**
+ * @see Actions — the strip of actions under an assistant message (Ant Design X `Actions`): copy,
+ * retry, like, and whatever else the turn offers.
+ *
+ * Ant X renders each action as a `<div onClick>` with the label in a `Tooltip`
+ * (`es/actions/Item.js`), so the strip is unreachable by keyboard and nameless to a screen reader.
+ * Here every action is a real `Button` carrying its `label` as the accessible name, and the strip
+ * is the WAI-ARIA APG **Toolbar**: one tab stop, arrows between the actions.
+ */
+export type ActionsProp = {
+    /** The actions, in order. Ant Design X `items`. */
+    items: readonly ActionsItemsProp[];
+    /**
+     * Fires for any action without its own `onItemClick`. `keyPath` is the path from the clicked
+     * action up to the strip, exactly as in Ant X (a sub-item gives `[subKey, parentKey]`).
+     * Ant Design X `onClick`.
+     */
+    onClick?: (info: {
+        item: ActionsItemsProp;
+        key: string;
+        keyPath: string[];
+        domEvent: React.MouseEvent<HTMLElement>;
+    }) => void;
+    /** Ant Design X `variant`. Default `borderless`. */
+    variant?: ActionsVariantProp;
+    /** Ant Design X `fadeIn` — the strip fades in on mount. Honours `prefers-reduced-motion`. */
+    fadeIn?: boolean;
+    /** Ant Design X `fadeInLeft` — the same fade, arriving along the inline axis. */
+    fadeInLeft?: boolean;
+    /**
+     * Accessible name of the toolbar — a plain STRING (it lands on `aria-label`). Ant X has no
+     * equivalent because its strip has no role to name; a localized default applies when omitted.
+     */
+    label?: string;
+    id?: IdProp;
+    className?: ClassNameProp;
+};
+/**
+ * @see ActionsItem — one status-aware action, usable on its own (Ant Design X `Actions.Item`).
+ *
+ * `status` swaps the glyph: `loading` and `error` bring their own, `running` uses `runningIcon`,
+ * and everything else uses `defaultIcon` — Ant X's exact table, from `es/actions/ActionsItem.js`.
+ */
+export type ActionsItemProp = {
+    /** Ant Design X `status`. Default `default`. */
+    status?: ActionsStatusProp;
+    /** The resting glyph. Ant Design X `defaultIcon`. */
+    defaultIcon: React.ReactNode;
+    /** The glyph while `status="running"`. Ant Design X `runningIcon`. */
+    runningIcon?: React.ReactNode;
+    /** Accessible name AND tooltip. Ant Design X `label` (tooltip only there). */
+    label?: string;
+    onClick?: OnClickProp;
+    disabled?: DisabledProp;
+    id?: IdProp;
+    className?: ClassNameProp;
+};
+/**
+ * @see ActionsCopy — copy this message to the clipboard (Ant Design X `Actions.Copy`).
+ *
+ * Ant X delegates to antd's `Typography copyable`, which swaps the glyph to a tick for 3s. That
+ * feedback is reproduced, and the state change is ANNOUNCED as well as painted — a tick that only
+ * appears is invisible to a screen reader (WCAG 1.4.1 / 4.1.3).
+ */
+export type ActionsCopyProp = {
+    /** What lands on the clipboard. Ant Design X `text`. */
+    text?: string;
+    /** The resting glyph. Ant Design X `icon`. */
+    icon?: React.ReactNode;
+    /** Accessible name AND tooltip. Localized default otherwise. */
+    label?: string;
+    /** Fires after a successful write, so the caller can log or toast. */
+    onCopy?: (text: string) => void;
+    id?: IdProp;
+    className?: ClassNameProp;
+};
+/**
+ * @see ActionsFeedback — the like / dislike pair (Ant Design X `Actions.Feedback`).
+ *
+ * Controlled through Ant X's own field names, `value` and `onChange`, because that is the API the
+ * issue asks to port. Clicking the recorded opinion again clears it back to `default`, as in Ant X.
+ */
+export type ActionsFeedbackProp = {
+    /** Ant Design X `value`. Default `default`. */
+    value?: ActionsFeedbackValueProp;
+    /** Ant Design X `onChange`. */
+    onChange?: (value: ActionsFeedbackValueProp) => void;
+    /** Accessible name of the pair's group. Localized default otherwise. */
+    label?: string;
+    /** Accessible names of the two buttons. Localized defaults otherwise. */
+    likeLabel?: string;
+    dislikeLabel?: string;
+    id?: IdProp;
+    className?: ClassNameProp;
+};

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

@@ -1,9 +1,9 @@
-export type { AppLauncherApp, AppLauncherGroup, AppLauncherLabels, AppLauncherProp, AppShellProp, AuthFooterProp, AuthIdentityProp, OrgSwitcherLabels, OrgSwitcherOrganization, OrgSwitcherProp, PageContainerProp, PageInsetProp, SidebarItemProp, SidebarProductProp, SidebarProp, SidebarSectionProp, TopbarProp, } from "./layout.prop.js";
+export type { AppLauncherApp, AppLauncherGroup, AppLauncherLabels, AppLauncherProp, AppShellProp, AuthFooterProp, AuthIdentityProp, OrgSwitcherLabels, OrgSwitcherOrganization, OrgSwitcherProp, DragAxisProp, DragBoundsProp, DraggablePanelPlacementProp, DraggablePanelPositionProp, DraggablePanelProp, PageContainerProp, PageInsetProp, SidebarItemProp, SidebarProductProp, SidebarProp, SidebarSectionProp, TopbarProp, } from "./layout.prop.js";
 export type { ButtonProp } from "./general.prop.js";
 export type { InputProp, TextareaProp, FormFieldProp, SearchInputProp, CheckboxProp, CheckboxGroupProp, ChoiceOptionProp, RadioProp, RadioGroupProp, SwitchProp, SliderProp, CalendarProp, DatePickerProp, TimePickerProp, ColorPickerProp, UploadProp, UploadFileItemProp, UploadVariantProp, TreeOptionProp, TreeFieldNamesProp, CascaderProp, TreeSelectProp, ShowCheckedStrategyProp, TransferProp, TransferItemProp, } from "./data-entry.prop.js";
 export type { AvatarProp, EmptyStateProp, DescriptionsProp, DescriptionsItemProp, BadgeProp, DataTableProp, QrCodeProp, } from "./data-display.prop.js";
 export type { ChartDatum, ChartSeriesProp, LineChartProp, BarChartProp, AreaChartProp, PieChartProp, } from "./charts.prop.js";
-export type { AlertQueryErrorProp, AlertProp, AlertTitleProp, AlertContentProp, AlertDescriptionProp, AlertActionsProp, SheetResponsiveProp, SkeletonRowsProp, } from "./feedback.prop.js";
+export type { AlertQueryErrorProp, 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, } from "./app.prop.js";