@godxjp/ui 23.3.0 → 23.4.0

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";

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

@@ -1,7 +1,7 @@
 /** Layout component prop types — @see docs/COMPONENTS.md#layout */
 import type * as React from "react";
 import type { ComponentType, ReactNode, SVGProps } from "react";
-import type { BreadcrumbProp, TitleProp, SubtitleProp, StatusProp, ExtraProp, FooterProp, PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, MobileShellWidthProp, OrientationProp, TextAlignProp, TextToneProp, BreakpointProp, GapProp, PadProp, PadRawProp, ClassNameProp, ChildrenProp, IdProp, DisabledProp, DescriptionProp, ActionProp, IconProp, HeadingLevelProp, ToneProp, WidthProp } from "../vocabulary/index.js";
+import type { BreadcrumbProp, TitleProp, SubtitleProp, StatusProp, ExtraProp, FooterProp, PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, MobileShellWidthProp, OrientationProp, TextAlignProp, TextToneProp, BreakpointProp, GapProp, PadProp, PadRawProp, ClassNameProp, ChildrenProp, IdProp, DisabledProp, DescriptionProp, ActionProp, IconProp, HeadingLevelProp, ToneProp, WidthProp, SizeProp } from "../vocabulary/index.js";
 import type { EmptyStateToneProp } from "./data-display.prop.js";
 /**
  * Arrangement of the page header's title band and its `extra` slot below the 640px step.
@@ -1418,3 +1418,65 @@ export type ServiceRolePanelProp = {
     id?: IdProp;
     className?: ClassNameProp;
 };
+/**
+ * Which axis a `DraggablePanel` moves on. react-draggable's `axis`, ported verbatim including
+ * `"none"` (mounted, but pinned where it started).
+ */
+export type DragAxisProp = "both" | "x" | "y" | "none";
+/**
+ * How far a `DraggablePanel` may travel. react-draggable's `bounds`, trimmed to the two forms that
+ * survive this library's rules: `"viewport"` keeps the whole panel on screen, `"none"` lets it go
+ * anywhere. react-draggable also accepts `'parent'`, a CSS selector and a `{left, top, right,
+ * bottom}` object — the selector is a back door into internal DOM (the layer
+ * docs/DESIGN-AUTHORITY.md refuses alongside antd's `components` / `prefixCls`), and the object is
+ * spelled in PHYSICAL directions, which cannot mirror for an RTL locale.
+ */
+export type DragBoundsProp = "viewport" | "none";
+/** Resting corner of a `DraggablePanel`, in logical directions so it mirrors under RTL. */
+export type DraggablePanelPlacementProp = "top-start" | "top-end" | "bottom-start" | "bottom-end";
+/**
+ * Offset from the resting corner, in CSS pixels, on the PHYSICAL axes — the same frame the pointer
+ * reports in, so no RTL sign flip exists to get wrong. react-draggable's `{x, y}`.
+ */
+export type DraggablePanelPositionProp = {
+    x: number;
+    y: number;
+};
+/**
+ * @see DraggablePanel — a floating surface the person using it can MOVE, so a docked assistant
+ * stops covering the thing they are asking about.
+ *
+ * The movement props take react-draggable's names, because react-draggable is what antd's own
+ * "Draggable Modal" demo prescribes and antd has no component of its own for this. The library is
+ * NOT a dependency here: the drag is the repo's existing window-level pointer pattern.
+ */
+export type DraggablePanelProp = Omit<React.HTMLAttributes<HTMLElement>, "title" | "children" | "onDrag"> & {
+    /** Panel name. A string also becomes the region's accessible name. */
+    title: TitleProp;
+    children?: ChildrenProp;
+    /** Trailing slot in the title bar, before the close control. */
+    extra?: ExtraProp;
+    /** Resting corner before any movement. Default `bottom-end`. */
+    placement?: DraggablePanelPlacementProp;
+    /** Panel width, from the token scale. Default `md`. */
+    width?: Extract<SizeProp, "sm" | "md" | "lg">;
+    /** react-draggable `axis`. Default `both`. */
+    axis?: DragAxisProp;
+    /** react-draggable `bounds`. Default `viewport`. */
+    bounds?: DragBoundsProp;
+    /** react-draggable `position` — controlled offset. Pair with `onPositionChange`. */
+    position?: DraggablePanelPositionProp;
+    /** react-draggable `defaultPosition` — starting offset when uncontrolled. */
+    defaultPosition?: DraggablePanelPositionProp;
+    /**
+     * Fires with the clamped offset after every pointer frame and every keyboard nudge. The panel
+     * REPORTS its position and never stores it: where it is remembered, and per what scope, is the
+     * consumer's decision.
+     */
+    onPositionChange?: (position: DraggablePanelPositionProp) => void;
+    /** Presence renders the close control in the title bar (antd Modal's `onCancel`). */
+    onClose?: () => void;
+    /** react-draggable `disabled` — the panel stays, the handle stops moving it. */
+    disabled?: DisabledProp;
+    className?: ClassNameProp;
+};