@trinityui/design-system 2.11.1 → 2.13.0

package/dist/components/DetailsPopover/DetailsPopover.d.ts

@@ -0,0 +1,185 @@
+/**
+ * @fileoverview DetailsPopover: an anchored, accessible details surface (a toggletip dialog) and
+ * its trigger hook (master-plan F-09, the ninth shared block, ADR-02-R1).
+ * @module components/DetailsPopover
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * The details surface of AILabel (WI-60+) and of the HITL molecules: AIConfidenceBadge,
+ * AIVerificationBadge, AISourceChip and AIFeedbackControl (F-10, F-11, F-12, F-17). It holds
+ * nothing AI-specific, so it lives beside the other blocks, not in AI/. No per-block barrel
+ * (M5 decision 19): import it by this module path. Not Popper and not a Popover variant
+ * (docs/NAMING.md, "Internal components").
+ *
+ * - **Trigger.** {@link useDetailsPopover} is `useDisclosure`'s popup mode (B-05): the trigger
+ *   gets `aria-haspopup="dialog"`, `aria-expanded`, and `aria-controls` while open, with `useId`
+ *   ids. Every change calls `onOpenChange(open, reason, event?)`; the reason is B-05's
+ *   `OpenChangeReason` or `'action'`, for a close that an action inside the surface asked for
+ *   (`setOpen(false, 'action')`).
+ * - **Surface.** MUI Popover, so focus moves in, stays trapped, and returns to the trigger on
+ *   close (ADR-15). The paper is `role="dialog"` with `aria-modal="true"`, named by a visible
+ *   heading (`title`, an h2 unless `headingLevel` says otherwise: a dialog is its own heading
+ *   context, so the ADR-19 no-heading default does not apply inside it). A consumer whose
+ *   content already shows its own title names the dialog with `labelledBy` (an id inside the
+ *   content) or `label` instead (AILabel's public `popoverLabelledBy` and `popoverLabel`).
+ * - **Announcements.** A `LiveRegionProvider` sits inside the paper (ADR-07): MUI hides
+ *   everything outside an open modal, the document-level regions included.
+ * - **Placement.** Anchored at the trigger's bottom centre, the paper's top centre: the same in
+ *   both directions, so nothing branches on RTL (ADR-11 (3)). If the trigger unmounts while open,
+ *   the surface stays where the trigger was.
+ * - **Size and motion.** The paper is at most the compact container width (E-19 token) and never
+ *   wider than the viewport minus `theme.spacing(4)`. The transition uses
+ *   `semanticTokens.motion.duration` (normal in, fast out), 0 under reduced motion. Colours,
+ *   border, radius and shadow come from the theme's MuiPopover paper. When the dialog itself holds
+ *   focus (no control inside, opened from the keyboard) it shows the theme focus ring
+ *   (`interactive.focus`, Highlight in forced colours).
+ * - **Closing.** Escape and a click outside request a close (reasons `'escape'` and
+ *   `'clickAway'`). `preventClose` ignores both while true (ADR-07's `'block'` parity for a
+ *   pending action). `onAfterClose(reason)` runs after the exit transition, after MUI has
+ *   returned focus: a focus move made there (a "Show query" action moving focus to the query)
+ *   is not overwritten, and an announcement made there is not hidden by the modal. If the
+ *   trigger is gone by then, focus goes to `fallbackFocusRef`.
+ * - **Slots.** `slotProps.paper` and `slotProps.heading` merge through `mergeSlotProps`; the
+ *   dialog's `role` and `aria-modal` are owned.
+ *
+ * @example
+ * ```tsx
+ * const details = useDetailsPopover();
+ * <button type="button" {...details.triggerProps}>Why this confidence</button>
+ * <DetailsPopover {...details.popoverProps} title="Why this confidence">
+ *   <KeyValueList items={items} />
+ * </DetailsPopover>
+ * ```
+ */
+import * as React from 'react';
+import { type DisclosureTriggerProps, type OpenChangeReason, type UseDisclosureReturn } from '../../hooks/useDisclosure';
+import { type HeadingLevel } from '../shared/headingLevel';
+import type { TrinitySlotProps } from '../shared/rootProps';
+/**
+ * Why a details popover opened or closed: B-05's reasons, or `'action'` for a close that an
+ * action inside the surface requested.
+ * @internal
+ * @since 2.13.0
+ */
+export type DetailsPopoverChangeReason = OpenChangeReason | 'action';
+/**
+ * How the dialog is named. `title` (the default for new surfaces) renders a visible heading that
+ * names it. `labelledBy` names it from an element inside `children`, and `label` with an
+ * `aria-label`, for content that already shows its own title (AILabel).
+ * @internal
+ * @since 2.13.0
+ */
+export type DetailsPopoverName = {
+    title: React.ReactNode;
+    label?: never;
+    labelledBy?: never;
+} | {
+    labelledBy: string;
+    title?: never;
+    label?: never;
+} | {
+    label: string;
+    title?: never;
+    labelledBy?: never;
+};
+/**
+ * The popover's own props.
+ * @internal
+ * @since 2.13.0
+ */
+export interface DetailsPopoverOwnProps {
+    /** Whether the surface is open. */
+    open: boolean;
+    /** The trigger: the surface is anchored at its bottom centre. */
+    anchorEl: HTMLElement | null;
+    /**
+     * Called when Escape or a click outside requests a close (never while `preventClose`).
+     * {@link useDetailsPopover}'s `popoverProps` wires it.
+     */
+    onOpenChange?: (open: boolean, reason: DetailsPopoverChangeReason, event?: React.SyntheticEvent | Event) => void;
+    /**
+     * Runs after the exit transition, once MUI has returned focus to the trigger, with the reason
+     * of the close. Move focus or announce here, never in the handler that closes.
+     */
+    onAfterClose?: (reason: DetailsPopoverChangeReason) => void;
+    /**
+     * The close reason the trigger hook recorded, read when the exit transition ends. Set by
+     * {@link useDetailsPopover}; without it the reason is the last Escape or click outside, else
+     * `'programmatic'`.
+     */
+    getCloseReason?: () => DetailsPopoverChangeReason | undefined;
+    /**
+     * The heading element of `title`.
+     * @default 2
+     */
+    headingLevel?: HeadingLevel;
+    /** While true, Escape and a click outside do not close the surface (a pending action). */
+    preventClose?: boolean;
+    /** Receives focus after the close when the trigger is no longer in the document. */
+    fallbackFocusRef?: React.RefObject<HTMLElement | null>;
+    /** The paper's id: the trigger's `aria-controls`. {@link useDetailsPopover} sets it. */
+    id?: string;
+    /** The surface's content. */
+    children?: React.ReactNode;
+    slotProps?: {
+        /** The dialog (MUI Popover's paper). */
+        paper?: TrinitySlotProps<HTMLDivElement>;
+        /** The `title` heading. */
+        heading?: TrinitySlotProps<HTMLHeadingElement>;
+    };
+}
+/**
+ * Props of {@link DetailsPopover}.
+ * @internal
+ * @since 2.13.0
+ */
+export type DetailsPopoverProps = DetailsPopoverOwnProps & DetailsPopoverName;
+/**
+ * An anchored, accessible details surface. See the module notes.
+ * @internal
+ * @since 2.13.0
+ */
+export declare function DetailsPopover(props: DetailsPopoverProps): React.JSX.Element;
+/**
+ * Options of {@link useDetailsPopover}.
+ * @internal
+ * @since 2.13.0
+ */
+export interface UseDetailsPopoverOptions {
+    /** Controlled open state. */
+    open?: boolean;
+    /** @default false */
+    defaultOpen?: boolean;
+    /** Called on every requested change, with the reason and the event when there is one. */
+    onOpenChange?: (open: boolean, reason: DetailsPopoverChangeReason, event?: React.SyntheticEvent | Event) => void;
+    /** The trigger's id; the paper's is `${id}-panel`. @default an id from `React.useId()` */
+    id?: string;
+}
+/**
+ * What {@link useDetailsPopover} returns.
+ * @internal
+ * @since 2.13.0
+ */
+export interface UseDetailsPopoverResult {
+    /** Whether the surface is open. */
+    open: boolean;
+    /** Requests a change. `setOpen(false, 'action')` closes for an action inside the surface. */
+    setOpen: (open: boolean, reason?: DetailsPopoverChangeReason, event?: React.SyntheticEvent | Event) => void;
+    /** Spread on the trigger (a native button). */
+    triggerProps: DisclosureTriggerProps;
+    /** The trigger props merged with the trigger's own `onClick` and `ref`. */
+    getTriggerProps: UseDisclosureReturn['getTriggerProps'];
+    /** Spread on {@link DetailsPopover}. */
+    popoverProps: Pick<DetailsPopoverOwnProps, 'id' | 'open' | 'anchorEl' | 'onOpenChange' | 'getCloseReason'> & {
+        open: boolean;
+        anchorEl: HTMLElement | null;
+    };
+}
+/**
+ * The trigger side of a {@link DetailsPopover}: `useDisclosure`'s popup mode with a dialog
+ * popup, plus the `'action'` close reason. See the module notes.
+ * @internal
+ * @since 2.13.0
+ */
+export declare function useDetailsPopover(options?: UseDetailsPopoverOptions): UseDetailsPopoverResult;
+//# sourceMappingURL=DetailsPopover.d.ts.map

package/dist/components/DetailsPopover/DetailsPopover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetailsPopover.d.ts","sourceRoot":"","sources":["../../../src/components/DetailsPopover/DetailsPopover.tsx"],"names":[],"mappings":"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"}

package/dist/components/DiffViewer/DiffViewer.d.ts

@@ -12,6 +12,7 @@
  *  ```
  */
 import * as React from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
 export type DiffViewMode = 'side-by-side' | 'unified';
 export interface DiffLine {
     type: 'unchanged' | 'added' | 'removed' | 'context';
@@ -55,8 +56,8 @@ export interface DiffViewerProps {
     showCopy?: boolean;
     /** Custom class name */
     className?: string;
-    /** Custom styles */
-    sx?: Record<string, unknown>;
+    /** Styles for the root, merged after the component's own: an object, an array or a theme callback (ADR-04) */
+    sx?: SxProps<Theme>;
 }
 export declare const DiffViewer: React.ForwardRefExoticComponent<DiffViewerProps & React.RefAttributes<HTMLDivElement>>;
 export default DiffViewer;

package/dist/components/DiffViewer/DiffViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DiffViewer.d.ts","sourceRoot":"","sources":["../../../src/components/DiffViewer/DiffViewer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA0B/B,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iCAAiC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAoaD,eAAO,MAAM,UAAU,wFAsMrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"DiffViewer.d.ts","sourceRoot":"","sources":["../../../src/components/DiffViewer/DiffViewer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAY3D,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,iCAAiC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8GAA8G;IAC9G,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAoaD,eAAO,MAAM,UAAU,wFAwNrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/components/Disclosure/Disclosure.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Disclosure: one button that shows and hides one panel (master-plan D-08).
+ * @module components/Disclosure
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * The expand and collapse control for DiffViewer's hunks, AIExpandableSection, AISourcesSection,
+ * AIRelatedQuestions, AISourcesPanel, the chain of thought and InsightEngine's history (D-22,
+ * D-27..D-31, D-36, D-39). Not an Accordion variant (NAMING, "Why each block is not a variant").
+ *
+ * - **State.** `useDisclosure`'s inline mode (B-05): controlled (`open`) or uncontrolled
+ *   (`defaultOpen`); every change calls `onOpenChange(open, 'trigger', event)` (D-45, ADR-35-R9).
+ *   The trigger owns `aria-expanded` and `aria-controls` (applied after slot props); ids come
+ *   from `useId`, or from `id` (the trigger's id; the panel's is `${id}-panel`).
+ * - **Trigger.** A full-width ButtonBase (`<button type="button">`): focus ring, keyboard and
+ *   disabled from the theme. Its content is phrasing only: the title and subtitle are spans
+ *   (never Typography's `<p>` or `<h6>`), and the adornments must be non-interactive phrasing
+ *   content. A development warning, and the D-44 test guard, catch block or interactive content.
+ * - **Chevron (OD-D2 (a)).** `chevron-down`, rotated 180 degrees when open: the same in both
+ *   directions. Its transition (`motion.duration.fast`) is turned off under reduced motion.
+ * - **Panel.** MUI Collapse with `motion.duration.normal`, 0 under reduced motion or with
+ *   `disableAnimation`. Mounted while closed (hidden, so Tab skips it) unless `unmountOnExit`.
+ *   `panelRole="region"` opts in to a region named by the trigger.
+ * - **Heading.** None by default; `headingLevel` wraps the trigger in that heading.
+ * - **Disabled** sets `aria-disabled`: the trigger stays focusable and does not toggle.
+ * - **Colours.** `text.primary`; hover is MUI's `action.hover` state colour; the focus outline is
+ *   `interactive.focus`, Highlight in forced colours.
+ */
+import * as React from 'react';
+import { type SxProps, type Theme } from '@mui/material/styles';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinitySlotProps } from '../shared/rootProps';
+/** The disclosure's own props. @internal */
+export interface DisclosureOwnProps {
+    /** The trigger's label: phrasing content only. */
+    title: React.ReactNode;
+    /** A second line under the title: phrasing content only. */
+    subtitle?: React.ReactNode;
+    /** Before the title: non-interactive phrasing content (an icon, a MetaChip with `component="span"`). */
+    startAdornment?: React.ReactNode;
+    /** After the title: non-interactive phrasing content (a count, a status). */
+    endAdornment?: React.ReactNode;
+    /** The panel's content. */
+    children: React.ReactNode;
+    /** Controlled open state. */
+    open?: boolean;
+    /** @default false */
+    defaultOpen?: boolean;
+    /** Called with the requested state, the reason and the trigger's event. */
+    onOpenChange?: (open: boolean, reason: 'trigger', event: React.SyntheticEvent) => void;
+    /** `aria-disabled`: focusable, does not toggle. */
+    disabled?: boolean;
+    /** Wraps the trigger in a heading of this level. */
+    headingLevel?: HeadingLevel;
+    /** Makes the panel a region named by the trigger. */
+    panelRole?: 'region';
+    /** @default 'end' */
+    chevronPlacement?: 'start' | 'end';
+    /** Unmount the panel while closed. */
+    unmountOnExit?: boolean;
+    /** No collapse animation. */
+    disableAnimation?: boolean;
+    /** @default 'medium' */
+    size?: 'small' | 'medium';
+    /** The trigger's id; the panel's is `${id}-panel`. */
+    id?: string;
+    sx?: SxProps<Theme>;
+    className?: string;
+    slotProps?: {
+        heading?: TrinitySlotProps<HTMLHeadingElement>;
+        trigger?: TrinitySlotProps<HTMLButtonElement>;
+        chevron?: TrinitySlotProps<HTMLSpanElement>;
+        panel?: TrinitySlotProps<HTMLDivElement>;
+    };
+}
+/** @internal */
+export type DisclosureProps = DisclosureOwnProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'onChange' | 'color' | keyof DisclosureOwnProps>;
+/**
+ * A button that shows and hides one panel. See the module notes.
+ * @internal
+ */
+export declare const Disclosure: React.ForwardRefExoticComponent<DisclosureOwnProps & Omit<React.HTMLAttributes<HTMLDivElement>, "color" | "onChange" | keyof DisclosureOwnProps> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Disclosure.d.ts.map

package/dist/components/Disclosure/Disclosure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Disclosure.d.ts","sourceRoot":"","sources":["../../../src/components/Disclosure/Disclosure.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAK1E,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI7E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,wGAAwG;IACxG,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC/B,2BAA2B;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qBAAqB;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC;IACvF,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,qDAAqD;IACrD,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACnC,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6BAA6B;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wBAAwB;IACxB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QAC9C,OAAO,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,gBAAgB;AAChB,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAC9C,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,kBAAkB,CAAC,CAAC;AAQxG;;;GAGG;AACH,eAAO,MAAM,UAAU,yLAqJrB,CAAC"}

package/dist/components/DockLayout/DockLayout.d.ts

@@ -12,6 +12,53 @@
  *  ```
  */
 import * as React from 'react';
+/**
+ * DockLayout's overridable strings (NAMING.md, "Label overrides (non-AI)"). Pass any subset
+ * through the `labels` prop; keys you leave out keep their defaults. Each one names an
+ * icon-only header button and is its tooltip (B-34).
+ *
+ * @since 2.13.0
+ */
+export interface DockLayoutLabels {
+    /** @default 'Minimize panel' */
+    minimizePanel: string;
+    /** @default 'Maximize panel' */
+    maximizePanel: string;
+    /** @default 'More panel actions' */
+    morePanelActions: string;
+    /** @default 'Close panel' */
+    closePanel: string;
+    /**
+     * The move button at the end of a tab bar; it moves the selected tab's panel (B-59).
+     * @default ({ title }) => `Move ${title}`
+     */
+    movePanel: (args: {
+        title: string;
+    }) => string;
+    /**
+     * A "Move to" menu item, one per other zone (B-59). `zone` is the zone's `zoneLabels` entry, or
+     * its id.
+     * @default ({ zone }) => `Move to ${zone}`
+     */
+    moveTo: (args: {
+        zone: string;
+    }) => string;
+    /** @default 'Drop panel here' */
+    dropPanelHere: string;
+    /** Announced when a drag starts. @default ({ title }) => `Moving panel ${title}. Drop on a zone to complete.` */
+    moving: (args: {
+        title: string;
+    }) => string;
+    /** Announced after a drop or a "Move to" item. @default ({ title, zone }) => `Moved panel ${title} to ${zone}.` */
+    moved: (args: {
+        title: string;
+        zone: string;
+    }) => string;
+    /** Announced when a panel is dropped on its own zone. @default ({ title }) => `Drop canceled. Panel ${title} stayed in place.` */
+    moveCanceled: (args: {
+        title: string;
+    }) => string;
+}
 export interface DockPanel {
     /** Unique identifier */
     id: string;
@@ -72,6 +119,17 @@ export interface DockLayoutProps {
     className?: string;
     /** Custom styles */
     sx?: Record<string, unknown>;
+    /**
+     * Overrides for DockLayout's built-in strings (any subset).
+     * @since 2.13.0
+     */
+    labels?: Partial<DockLayoutLabels>;
+    /**
+     * Names for the zones, by zone id, used by the "Move to" menu items and the move announcements
+     * (B-59). A zone without an entry is named by its id.
+     * @since 2.13.0
+     */
+    zoneLabels?: Record<string, string>;
 }
 export declare const DockLayout: React.ForwardRefExoticComponent<DockLayoutProps & React.RefAttributes<HTMLDivElement>>;
 export default DockLayout;

package/dist/components/DockLayout/DockLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DockLayout.d.ts","sourceRoot":"","sources":["../../../src/components/DockLayout/DockLayout.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6B/B,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,iBAAiB;IACjB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;IACrD,oCAAoC;IACpC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IACtB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,mCAAmC;IACnC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC5C,oCAAoC;IACpC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAwfD,eAAO,MAAM,UAAU,wFAsJrB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"DockLayout.d.ts","sourceRoot":"","sources":["../../../src/components/DockLayout/DockLayout.tsx"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,3 @@
-export { DockLayout, type DockLayoutProps, type DockPanel, type DockZone } from './DockLayout';
+export { DockLayout, type DockLayoutProps, type DockLayoutLabels, type DockPanel, type DockZone } from './DockLayout';
 export { default } from './DockLayout';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/DockLayout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/DockLayout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC/F,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/DockLayout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/components/DocumentCard/DocumentCard.d.ts

@@ -70,7 +70,11 @@ export interface DocumentCardProps {
     onDelete?: (id: string | number) => void;
     /** Called when edit is clicked */
     onEdit?: (id: string | number) => void;
-    /** Called when card is clicked */
+    /**
+     * Called when the card is activated. The card then has a primary action: a button that
+     * covers the card, named by the file name, reachable with Tab and run by Enter and Space.
+     * The toggle, edit and delete controls keep their own clicks.
+     */
     onClick?: (id: string | number) => void;
 }
 export declare const DocumentCard: React.ForwardRefExoticComponent<DocumentCardProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/DocumentCard/DocumentCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentCard.d.ts","sourceRoot":"","sources":["../../../src/components/DocumentCard/DocumentCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuB/B,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAgBD,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,GAAG,EAAE,YAAY,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC/C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACzC,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACvC,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzC;AAsED,eAAO,MAAM,YAAY,0FA8SxB,CAAC"}
+{"version":3,"file":"DocumentCard.d.ts","sourceRoot":"","sources":["../../../src/components/DocumentCard/DocumentCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oDAAoD;IACpD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAgBD,MAAM,WAAW,iBAAiB;IAChC,oBAAoB;IACpB,GAAG,EAAE,YAAY,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC/C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACzC,kCAAkC;IAClC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACzC;AAoCD,eAAO,MAAM,YAAY,0FA+VxB,CAAC"}

package/dist/components/EntityDetailPanel/EntityDetailPanel.d.ts

@@ -5,8 +5,12 @@
  * optional tab strip, scrollable body with one tab's content visible,
  * optional sticky footer slot.
  *
- * Field sections render as a 2-column grid (label left, value right) at
- * desktop width; collapse to single column on narrow viewports.
+ * Field sections render as a named description list (KeyValueList): label
+ * and value side by side, stacking when the row is narrower than both.
+ *
+ * Colors come from the MUI text roles and the palette resolver (`getTrinityPalette`): surfaces,
+ * borders and the status pill's status roles, so both modes, presets and theme overrides flow
+ * through (D-47).
  *
  * @module components/EntityDetailPanel
  */

package/dist/components/EntityDetailPanel/EntityDetailPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityDetailPanel.d.ts","sourceRoot":"","sources":["../../../src/components/EntityDetailPanel/EntityDetailPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,OAAO,KAAK,EACV,sBAAsB,EAKvB,MAAM,SAAS,CAAC;AA0KjB,eAAO,MAAM,iBAAiB,+FAkO5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"EntityDetailPanel.d.ts","sourceRoot":"","sources":["../../../src/components/EntityDetailPanel/EntityDetailPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,OAAO,KAAK,EACV,sBAAsB,EAKvB,MAAM,SAAS,CAAC;AAqIjB,eAAO,MAAM,iBAAiB,+FAwO5B,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/dist/components/FileUpload/FileUpload.d.ts

@@ -9,7 +9,12 @@
  *  ```
  */
 import React from 'react';
+/** Visual variant of {@link FileUpload}: a dropzone, a single button, or a compact chip row. */
 export type FileUploadVariant = 'dropzone' | 'button' | 'compact';
+/**
+ * One entry of the {@link FileUpload} file list, as rendered and as reported
+ * through `onFilesChange`.
+ */
 export interface UploadFile {
     /** Unique identifier */
     id: string;
@@ -21,15 +26,60 @@ export interface UploadFile {
     size: number;
     /** MIME type */
     type: string;
-    /** Upload progress (0-100) */
+    /**
+     * Upload progress (0-100). While `onUpload` is pending it is simulated in
+     * 10% steps up to 90%; it becomes 100 when the upload resolves.
+     */
     progress: number;
     /** Upload status */
     status: 'pending' | 'uploading' | 'complete' | 'error';
     /** Error message if status is 'error' */
     error?: string;
-    /** Preview URL for images */
+    /**
+     * Preview URL for images. For image files it selects, FileUpload creates an
+     * object URL (`URL.createObjectURL`) and revokes it once the file has left
+     * the rendered list (removed, or replaced in single-file mode) or when
+     * FileUpload unmounts. React `<Activity mode="hidden">` also revokes these
+     * URLs; when FileUpload is shown again, each listed image file gets a new
+     * URL, reported once through `onFilesChange` (twice in development under
+     * React StrictMode, which replays the effect). A URL FileUpload created is
+     * kept while the file stays listed, so a removal you decline keeps a live
+     * preview. To show a preview beyond that, create your own URL from `file`.
+     * A `preview` you pass in through `files` is never revoked on replacement,
+     * hiding or unmount; it is revoked as soon as the user presses that file's
+     * remove control, even if you then decline the removal, so pass a new URL
+     * for a file you keep.
+     */
     preview?: string;
 }
+/**
+ * Overridable user-facing strings of {@link FileUpload} that name controls in
+ * the file list (H-47 label overrides). Pass any subset through the `labels`
+ * prop; keys you leave out keep their English defaults. Each function receives
+ * the file's `name`, so every row gets a distinct name.
+ *
+ * @since 2.13.0
+ */
+export interface FileUploadLabels {
+    /**
+     * Accessible name of the progress bar shown in a file's row while its
+     * upload is pending (dropzone and button variants).
+     *
+     * @default ({ name }) => `Uploading ${name}`
+     */
+    uploading: (args: {
+        name: string;
+    }) => string;
+    /**
+     * Accessible name and tooltip of the icon-only button that removes a file's
+     * row (dropzone and button variants).
+     *
+     * @default ({ name }) => `Remove ${name}`
+     */
+    remove: (args: {
+        name: string;
+    }) => string;
+}
 /**
  * Props for FileUpload component.
  */
@@ -44,15 +94,91 @@ export interface FileUploadProps {
     maxSize?: number;
     /** Maximum number of files */
     maxFiles?: number;
-    /** Current files (controlled) */
+    /**
+     * Current files (controlled). When set, the component renders exactly this
+     * list and reports every change through `onFilesChange`; apply each value
+     * as-is (e.g. `onFilesChange={setFiles}`). You may also decline a value
+     * (keep your list) or apply a filtered copy: the next change builds on the
+     * list you render, so a declined file does not come back and does not count
+     * towards `maxFiles`. For the same reason, apply or decline each value
+     * synchronously (`onFilesChange={setFiles}`, or a functional updater such
+     * as `setFiles((prev) => …)`) or in `startTransition`. Then every upload
+     * outcome of a listed file reaches your list, and each selection and
+     * removal is kept, also when a transition renders an upload report after
+     * it (after each selection or removal, FileUpload holds its upload reports
+     * until your answer renders, for up to 200 ms). The exception is a
+     * selection or removal your list does not show yet when the user selects or
+     * removes again (a transition still rendering): the new change builds on
+     * the list you render, so the earlier one is lost. Values applied later
+     * (`setTimeout`, even `setTimeout(0)`, or after an `await`) are not
+     * guaranteed: an older report can be applied after the user's change and
+     * undo it (browsers delay a `setTimeout(0)` scheduled from FileUpload's
+     * progress timer by 4 ms), and a value held back past FileUpload's next
+     * report (the user's next selection or removal, or the next progress step
+     * or outcome of an upload in flight) is overwritten by that report, which
+     * builds on the list you rendered.
+     * When omitted, the component keeps the list itself.
+     *
+     * The mode is decided on the first render and kept for the component's
+     * lifetime. To control the list, pass an array from the start (`[]` while
+     * your data loads, not `undefined`). Switching between controlled and
+     * uncontrolled after mount is not supported and logs a warning in
+     * development.
+     */
     files?: UploadFile[];
-    /** Callback when files change */
+    /**
+     * Called with the complete next file list on every change: selection,
+     * removal and each upload transition (`pending` → `uploading` → progress →
+     * `complete` | `error`). Not called when nothing changed, for example while
+     * simulated progress waits at 90% or for an upload whose file is no longer
+     * listed. Fires in controlled and uncontrolled mode; each value is the whole
+     * accumulated list, not only the latest selection.
+     *
+     * Each value builds on the list of the last render, with every upload
+     * transition FileUpload has made applied to the files in it, so
+     * intermediate transitions are never dropped and a file you declined is
+     * not brought back. FileUpload's own upload transitions (`status`,
+     * `progress`, `error`) for a listed file are applied to each value until
+     * your list shows them, so keeping your previous file object does not
+     * decline one. To override one, change the file after you have applied it:
+     * render your own copy whose `status`, `progress`, `error` or `preview`
+     * differs from what FileUpload reported (for example a translated `error`),
+     * or edit the file later; FileUpload keeps your version. Values reported
+     * back-to-back before React renders (a selection and its first `uploading`
+     * transition) build on each other. After a selection or removal, upload
+     * progress and outcomes wait until your answer renders (that value or a
+     * later one, or a list of your own with other files), for up to 200 ms,
+     * and are then reported in one value (see `files`).
+     *
+     * Not called after the component unmounts, or while React
+     * `<Activity mode="hidden">` hides it: uploads keep running while hidden,
+     * and what changed is reported once, in one value, when it is shown again.
+     * In development under React StrictMode, which replays effects, a re-show
+     * that gives an image file a new preview URL reports twice.
+     */
     onFilesChange?: (files: UploadFile[]) => void;
     /** Callback when a file is selected */
     onFileSelect?: (files: File[]) => void;
-    /** Callback when a file is removed */
+    /**
+     * Callback when a file is removed: its row's remove button (dropzone and
+     * button variants) or its chip's delete action (compact variant). When that
+     * control had focus (Enter or Space on the button, Backspace or Delete on the
+     * chip), focus moves to the next file's control, else the previous file's,
+     * else the control that opens the file picker (the dropzone, the upload
+     * button or Browse), once the file has left the rendered list.
+     */
     onFileRemove?: (file: UploadFile) => void;
-    /** Custom upload function - return promise that resolves on success */
+    /**
+     * Custom upload function. Return a promise that resolves on success or
+     * rejects (its `Error.message` becomes the file's `error`). Files from one
+     * selection upload one after another; a second selection starts uploading
+     * at once, alongside the first. While a promise is pending, progress is
+     * simulated in 10% steps up to 90% and shown as a progress bar named
+     * "Uploading {file name}" (`labels.uploading`). The simulation stops when
+     * the promise settles, when the file is no longer listed, or when the
+     * component unmounts or is hidden by React `<Activity mode="hidden">` (it
+     * resumes when shown again). No state update is made after unmount.
+     */
     onUpload?: (file: File) => Promise<void>;
     /** Whether upload is disabled */
     disabled?: boolean;
@@ -64,6 +190,15 @@ export interface FileUploadProps {
     showFileList?: boolean;
     /** Compact size */
     size?: 'small' | 'medium';
+    /**
+     * Overrides for the file list's screen-reader strings: the remove button's
+     * name and tooltip, and the upload progress bar's name. Keys you leave out
+     * keep their defaults.
+     *
+     * @default {} (see {@link FileUploadLabels} for each key's default)
+     * @since 2.13.0
+     */
+    labels?: Partial<FileUploadLabels>;
     /** Custom styles */
     sx?: object;
 }