@godxjp/ui 23.2.1 → 23.4.0

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;
+};

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

@@ -466,3 +466,153 @@ export type TabsProp = {
     listClassName?: ClassNameProp;
     contentClassName?: ClassNameProp;
 };
+/**
+ * One conversation in the rail. Ant Design X `ConversationItemType`, field for field:
+ * `key`, `label`, `group`, `icon`, `disabled`.
+ *
+ * `key` is `string` and REQUIRED, as it is in Ant X — the rail's whole contract (which row is
+ * active, which row a menu command was aimed at, which row the roving tabindex is parked on) is
+ * addressed by it, and an optional identity would make every one of those "probably this one".
+ * @see Conversations
+ */
+/**
+ * One row. Ant Design X calls this `Conversation` and this type carries every field of it.
+ *
+ * THREE ANT DESIGN X PROPS ARE DELIBERATELY ABSENT from `ConversationsProp`, and under
+ * `docs/DESIGN-AUTHORITY.md` an undocumented deviation is a bug, so here are the reasons:
+ * `styles`, `classNames` and `rootClassName` are antd's per-part style escape hatches. This
+ * library's equivalent is the token tier — a service retunes every Conversations list at once by
+ * rebinding `--conversations-*`, and `check:no-hardcoded-css-values` plus the CONSUMER-RULES ban
+ * on utility classes exist precisely so a call site cannot paint one list differently from its
+ * neighbours. Accepting them would hand back the thing those gates are for.
+ */
+export type ConversationsItemProp = {
+    /** Unique identity of the conversation. Ant Design X `key`. */
+    key: string;
+    /** What the row reads. Ant Design X `label`. */
+    label?: React.ReactNode;
+    /** Bucket this row belongs to, honoured only while `groupable` is on. Ant Design X `group`. */
+    group?: string;
+    /** Decorative leading node. Ant Design X `icon`. */
+    icon?: React.ReactNode;
+    /** Row stays visible and reachable by arrow key, but cannot be activated. Ant Design X `disabled`. */
+    disabled?: DisabledProp;
+    /**
+     * When the conversation last moved, as an epoch milliseconds number — Ant Design X `timestamp`.
+     *
+     * A NUMBER, not a formatted string, and that is the whole point: the row renders it through the
+     * app's own locale and timezone from `AppProvider`, so a Japanese tenant reads 2026/03/15 and a
+     * Vietnamese one reads 15/03/2026 from the SAME data. Handing the component a pre-formatted
+     * string is what `docs/DATETIME.md` rule 1 forbids, and it is the reason this prop is not
+     * `ReactNode` even though every other field here is.
+     */
+    timestamp?: number;
+};
+/**
+ * A rule between two runs of conversations. Ant Design X `DividerItemType`.
+ * @see Conversations
+ */
+export type ConversationsDividerProp = {
+    type: "divider";
+    key?: string;
+    /** Ant Design X `dashed`. */
+    dashed?: boolean;
+};
+/** Either kind of row `items` accepts. Ant Design X `ItemType`. @see Conversations */
+export type ConversationsEntryProp = ConversationsItemProp | ConversationsDividerProp;
+/**
+ * One command on a row's overflow menu — rename, duplicate, delete.
+ * @see Conversations
+ */
+export type ConversationsMenuItemProp = {
+    /** Identity handed back to `menu.onClick`. */
+    key: string;
+    label: React.ReactNode;
+    icon?: React.ReactNode;
+    /** Paints the command as irreversible (`DropdownMenuItem variant="destructive"`). Ant Design `danger`. */
+    danger?: boolean;
+    disabled?: DisabledProp;
+};
+/**
+ * The per-row overflow menu. Ant Design X takes antd's whole `MenuProps` here; this takes the two
+ * fields of it a conversation rail uses — the commands, and where a click lands — plus the
+ * accessible name the icon-only trigger needs and Ant X never had.
+ * @see Conversations
+ */
+export type ConversationsMenuProp = {
+    items: readonly ConversationsMenuItemProp[];
+    /** Fires with the command and the row it was aimed at. */
+    onClick?: (info: {
+        key: string;
+        conversation: ConversationsItemProp;
+    }) => void;
+    /**
+     * Accessible name of the icon-only trigger. Receives the row so the name can name it
+     * ("More actions for 請求書の下書き"), which is what keeps twelve identical "More" buttons apart
+     * in a screen reader's element list. A localized default applies when omitted.
+     */
+    triggerLabel?: (conversation: ConversationsItemProp) => string;
+};
+/**
+ * Grouping options. Ant Design X `GroupableProps` — `label`, `collapsible`, and the
+ * `defaultExpandedKeys` / `expandedKeys` / `onExpand` triad it inherits from `CollapsibleOptions`.
+ * @see Conversations
+ */
+export type ConversationsGroupableProp = {
+    /** Heading for a bucket. A function receives the raw `group` string. Ant Design X `label`. */
+    label?: React.ReactNode | ((group: string) => React.ReactNode);
+    /** Whether a bucket's heading collapses it. A function decides per bucket. Ant Design X `collapsible`. */
+    collapsible?: boolean | ((group: string) => boolean);
+    /** Uncontrolled initially-open buckets. Ant Design X `defaultExpandedKeys`. */
+    defaultExpandedKeys?: readonly string[];
+    /** Controlled open buckets. Ant Design X `expandedKeys`. */
+    expandedKeys?: readonly string[];
+    /** Fires with the next open set. Ant Design X `onExpand`. */
+    onExpand?: (keys: string[]) => void;
+};
+/**
+ * The "new conversation" button pinned above the rail. Ant Design X `creation`.
+ * @see Conversations
+ */
+export type ConversationsCreationProp = {
+    /** Button text. A localized default applies when omitted. Ant Design X `label`. */
+    label?: React.ReactNode;
+    /** Leading glyph. Defaults to a plus. Ant Design X `icon`. */
+    icon?: React.ReactNode;
+    disabled?: DisabledProp;
+    onClick?: () => void;
+};
+/**
+ * @see Conversations — the session rail of a chat surface (Ant Design X `Conversations`): the list
+ * of past conversations, the current one marked, a per-row overflow menu, and recency buckets.
+ *
+ * Ant X's own rail is a bare `<ul>` of `<li onClick>` with no roles, no `tabIndex` and no key
+ * handling — measured in `@ant-design/x@2.9.0`, `es/conversations/Item.js` renders a `<li>` whose
+ * only interactive affordance is `onClick`. That is the half of it this port does NOT copy: the
+ * rows here are real `Button`s under a single roving tabindex, so the whole rail is ONE tab stop
+ * and ↑/↓/Home/End move between conversations. Everything a caller passes keeps Ant X's spelling.
+ */
+export type ConversationsProp = {
+    /** The rows. Ant Design X `items`. */
+    items?: readonly ConversationsEntryProp[];
+    /** Controlled selection. Ant Design X `activeKey`. */
+    activeKey?: string;
+    /** Uncontrolled initial selection. Ant Design X `defaultActiveKey`. */
+    defaultActiveKey?: string;
+    /** Fires with the picked key and the entry behind it. Ant Design X `onActiveChange`. */
+    onActiveChange?: (key: string, item?: ConversationsEntryProp) => void;
+    /** One menu for every row, or a function returning the menu for one. Ant Design X `menu`. */
+    menu?: ConversationsMenuProp | ((conversation: ConversationsItemProp) => ConversationsMenuProp | undefined);
+    /** Bucket rows by their `group` field. Ant Design X `groupable`. */
+    groupable?: boolean | ConversationsGroupableProp;
+    /** The "new conversation" button above the rail. Ant Design X `creation`. */
+    creation?: ConversationsCreationProp;
+    /**
+     * Accessible name of the rail — a plain STRING, because it lands on `aria-label`, which is a
+     * text attribute and cannot carry a node. Ant X has no equivalent because its rail has no role
+     * to name; a localized default applies when omitted.
+     */
+    label?: string;
+    id?: IdProp;
+    className?: ClassNameProp;
+};