@trinityui/design-system 2.11.1 → 2.13.1

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/StatusIndicator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EACL,eAAe,EACf,OAAO,IAAI,sBAAsB,EACjC,KAAK,oBAAoB,EACzB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AAGjB,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,gBAAgB;AAChB,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAKnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAO3C,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGhD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAK/E,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/StatusIndicator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EACL,eAAe,EACf,OAAO,IAAI,sBAAsB,EACjC,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,SAAS,CAAC;AAGjB,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,gBAAgB;AAChB,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAKnD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,gBAAgB;AAChB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAO3C,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,gBAAgB;AAChB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,gBAAgB;AAChB,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGhD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAK/E,OAAO,EACL,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC"}

package/dist/components/StatusIndicator/types.d.ts

@@ -2,6 +2,7 @@
  * Status Indicator - Types and Configuration
  * Centralized type definitions and status configs
  */
+import type { Theme } from '@mui/material/styles';
 export type StatusType = 'error' | 'critical' | 'failed' | 'rejected' | 'cancelled' | 'warning' | 'caution' | 'pending' | 'in-progress' | 'running' | 'success' | 'complete' | 'approved' | 'active' | 'enabled' | 'info' | 'new' | 'updated' | 'draft' | 'inactive' | 'disabled' | 'unknown' | 'beta' | 'experimental';
 export type SeverityLevel = 'high' | 'medium' | 'low' | 'info' | 'neutral';
 export type StatusShape = 'circle' | 'square' | 'diamond' | 'triangle' | 'hexagon';
@@ -25,7 +26,53 @@ export declare const sizeConfigs: Record<StatusSize, {
 /**
  * Get the configuration for a status type
  */
-export declare const getStatusConfig: (status: StatusType) => StatusConfig;
+export type StatusColorMode = 'light' | 'dark';
+export declare const getStatusConfig: (status: StatusType, mode?: StatusColorMode) => StatusConfig;
+/**
+ * One status as a renderer draws it, read from the theme (C-02, ADR-03-R6).
+ *
+ * - `fill` and `onFill`: the contained fill (icon circle, chip, badge, dot, shape) and the
+ *   text or icon on it.
+ * - `outline`: the darker ring a light fill declares (the warning family in light mode).
+ * - `surfaceText` and `surfaceIcon`: the status as text or an icon straight on the page,
+ *   paper or elevated surface (4.5:1 for text, so 3:1 for the icon as well).
+ * - `icon`, `shape`, `label`, `severity`: the catalog's, the same in every theme.
+ *
+ * @internal
+ */
+export interface StatusPresentation {
+    fill: string;
+    onFill: string;
+    outline?: string;
+    surfaceText: string;
+    surfaceIcon: string;
+    icon: string;
+    shape: StatusShape;
+    label: string;
+    severity: SeverityLevel;
+}
+/**
+ * The presentation of `status` under `theme`: colours from
+ * `getTrinityPalette(theme).indicator` (built from the merged token catalog, so token
+ * overrides reach it, with the dark roles in dark mode, and an MUI-derived fallback under a
+ * plain MUI theme), icon, shape, label and severity from the catalog. In a light Trinity theme
+ * the colours equal the catalog's (`statusConfigs`) bit for bit. No mode branch: the theme
+ * carries the mode.
+ *
+ * @internal
+ */
+export declare function resolveStatusPresentation(status: StatusType, theme: Theme): StatusPresentation;
+/**
+ * The differential's default colours: the success and critical on-surface roles (C-02): light
+ * #15803D and #DA1E28, dark #86EFAC and #FCA5A5. An explicit `positiveColor` or
+ * `negativeColor` still wins.
+ *
+ * @internal
+ */
+export declare function resolveDifferentialDefaults(theme: Theme): {
+    positive: string;
+    negative: string;
+};
 /**
  * Get all available status types
  */

package/dist/components/StatusIndicator/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/StatusIndicator/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,MAAM,UAAU,GAElB,OAAO,GACP,UAAU,GACV,QAAQ,GACR,UAAU,GACV,WAAW,GAEX,SAAS,GACT,SAAS,GACT,SAAS,GACT,aAAa,GACb,SAAS,GAET,SAAS,GACT,UAAU,GACV,UAAU,GACV,QAAQ,GACR,SAAS,GAET,MAAM,GACN,KAAK,GACL,SAAS,GAET,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GAET,MAAM,GACN,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAMtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,CA+M1D,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAI9G,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,KAAG,YAAqC,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,UAAU,EAAgD,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,aAAa,KAAG,UAAU,EAI5E,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/StatusIndicator/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAelD,MAAM,MAAM,UAAU,GAElB,OAAO,GACP,UAAU,GACV,QAAQ,GACR,UAAU,GACV,WAAW,GAEX,SAAS,GACT,SAAS,GACT,SAAS,GACT,aAAa,GACb,SAAS,GAET,SAAS,GACT,UAAU,GACV,UAAU,GACV,QAAQ,GACR,SAAS,GAET,MAAM,GACN,KAAK,GACL,SAAS,GAET,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GAET,MAAM,GACN,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAMtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,YAAY,CA+MM,CAAC;AAMlE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAI9G,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;AAc/C,eAAO,MAAM,eAAe,GAC1B,QAAQ,UAAU,EAClB,OAAM,eAAyB,KAC9B,YAgBF,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;CACzB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,kBAAkB,CAc9F;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAGhG;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,UAAU,EAAgD,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,aAAa,KAAG,UAAU,EAI5E,CAAC"}

package/dist/components/StepList/StepList.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview StepList: a static ordered list of steps with an ordinal or a status marker
+ * (master-plan D-10, ADR-02 shared block).
+ * @module components/StepList/StepList
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * - An `<ol role="list">`: the role is owned and restores list semantics where
+ *   `list-style: none` removes them (WebKit). Each `<li>` holds the marker, the label, the
+ *   description, the meta, the content and the actions.
+ * - `marker="number"` (default) shows the ordinal, hidden from assistive technology because
+ *   the list already announces positions; `start` is honoured. `marker="status"` renders
+ *   {@link StepStatusMarker}: the catalog icon plus the status as text. `marker="none"` renders
+ *   no marker.
+ * - Emphasis is never colour alone (ADR-33): the active step's label is weight 600 with a 2px
+ *   inline-start rule in the resolver's `interactive.default`; an error step sits on
+ *   `status.error.background` with `text.primary`; a pending label is `text.secondary`, never
+ *   `text.disabled`.
+ * - `animateEntrance` (off by default) is a CSS entrance on the motion tokens that slides in
+ *   from the inline start (a positive translateX right to left) and stops under reduced
+ *   motion (`reducedMotion`, B-02's `REDUCED_MOTION_QUERY`), so server rendering never plays
+ *   it before a JavaScript check.
+ * - Not interactive and not a live region: no keyboard model (keyboard-models.md (5), ADR-34),
+ *   interactive content inside a step keeps its own keys.
+ * - Colours come from the resolver (`getTrinityPalette`, ADR-26), so a plain MUI theme works.
+ */
+import * as React from 'react';
+import { type SxProps, type Theme } from '@mui/material/styles';
+import { type TrinitySlotProps } from '../shared/rootProps';
+import { type StepListStatus } from './stepStatus';
+/** One step. @internal */
+export interface StepListItem {
+    /** Stable key. */
+    id: string;
+    /** The step's text. */
+    label: React.ReactNode;
+    /** The step's status, for `marker="status"` and the emphasis. Default `'pending'`. */
+    status?: StepListStatus;
+    /** Replaces the status text of this step, for example "Retrying". */
+    statusLabel?: string;
+    /** Secondary text under the label. */
+    description?: React.ReactNode;
+    /** Short metadata (a time, a count) beside the label. */
+    meta?: React.ReactNode;
+    /** Controls at the inline end of the step; they keep their own keyboard behaviour. */
+    actions?: React.ReactNode;
+    /** Any content under the step. */
+    content?: React.ReactNode;
+}
+/** The Trinity-owned parts of a step. @internal */
+export type StepListSlot = 'item' | 'marker' | 'label' | 'description' | 'meta' | 'actions' | 'content';
+/** StepList's own props. @internal */
+export interface StepListOwnProps {
+    /** The steps, in order. */
+    items: readonly StepListItem[];
+    /** `'number'` (default) the ordinal, `'status'` the status marker, `'none'` no marker. */
+    marker?: 'number' | 'status' | 'none';
+    /** The first ordinal. Default `1`. */
+    start?: number;
+    /** Status texts by status, merged over the defaults ("Not started", "In progress", "Completed", "Needs attention", "Failed"). */
+    statusLabels?: Partial<Record<StepListStatus, string>>;
+    /** Default `'medium'`. */
+    size?: 'small' | 'medium';
+    /** Slide each step in on mount (staggered); stops under reduced motion. Default `false`. */
+    animateEntrance?: boolean;
+    /** Applied after the list's own styles; array and function forms work. */
+    sx?: SxProps<Theme>;
+    /** Added to the list's classes. */
+    className?: string;
+    /** Props for the parts of every step. */
+    slotProps?: Partial<Record<StepListSlot, TrinitySlotProps>>;
+}
+/** StepList's props: its own, plus the `<ol>`'s HTML attributes. @internal */
+export type StepListProps = StepListOwnProps & Omit<React.OlHTMLAttributes<HTMLOListElement>, keyof StepListOwnProps>;
+/**
+ * A static ordered list of steps.
+ * @internal
+ */
+export declare const StepList: React.ForwardRefExoticComponent<StepListOwnProps & Omit<React.OlHTMLAttributes<HTMLOListElement>, keyof StepListOwnProps> & React.RefAttributes<HTMLOListElement>>;
+//# sourceMappingURL=StepList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StepList.d.ts","sourceRoot":"","sources":["../../../src/components/StepList/StepList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAO1E,OAAO,EAAyC,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/E,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,sFAAsF;IACtF,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9B,yDAAyD;IACzD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,sFAAsF;IACtF,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,kCAAkC;IAClC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAExG,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACtC,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iIAAiI;IACjI,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,4FAA4F;IAC5F,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC7D;AAED,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,EAAE,MAAM,gBAAgB,CAAC,CAAC;AAOtH;;;GAGG;AACH,eAAO,MAAM,QAAQ,oKAwJnB,CAAC"}

package/dist/components/StepList/StepStatusMarker.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview StepStatusMarker: the status marker of one StepList step (master-plan D-10).
+ * @module components/StepList/StepStatusMarker
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * The status is text plus an icon shape, never colour alone (ADR-33): the repaired
+ * StatusIndicator icon (C-02..C-04), hidden from assistive technology, and the status as
+ * visually hidden text in sentence case. The vocabulary is in ./stepStatus.ts.
+ *
+ * `labelVisibility="none"` renders no text, for a trigger (D-23, D-36) that places the status
+ * text after its visible label so that its accessible name starts with the visible label
+ * (WCAG 2.5.3). The marker is spans only (phrasing content), so it may sit in a button (D-44).
+ */
+import * as React from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+import { type StepListStatus } from './stepStatus';
+/** Props of {@link StepStatusMarker}. @internal */
+export interface StepStatusMarkerProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> {
+    /** The step's status. */
+    status: StepListStatus;
+    /** The status text. Default: the status's default text. */
+    label?: string;
+    /**
+     * `'visually-hidden'` (default) renders the status text for assistive technology; `'none'`
+     * renders none, for a trigger that places the text after its visible label.
+     */
+    labelVisibility?: 'visually-hidden' | 'none';
+    /** Default `'medium'`. */
+    size?: 'small' | 'medium';
+    /** Applied after the marker's own styles. */
+    sx?: SxProps<Theme>;
+}
+/**
+ * The marker: the catalog icon (decorative) and the status text.
+ * @internal
+ */
+export declare const StepStatusMarker: React.ForwardRefExoticComponent<StepStatusMarkerProps & React.RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=StepStatusMarker.d.ts.map

package/dist/components/StepList/StepStatusMarker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepStatusMarker.d.ts","sourceRoot":"","sources":["../../../src/components/StepList/StepStatusMarker.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,EAAmD,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpG,mDAAmD;AACnD,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,UAAU,CAAC;IACpG,yBAAyB;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,eAAe,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAC7C,0BAA0B;IAC1B,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,6CAA6C;IAC7C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,+FAiB3B,CAAC"}

package/dist/components/StepList/stepStatus.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview The step statuses of StepList: their StatusIndicator catalog icons and their
+ * default texts (master-plan D-10).
+ * @module components/StepList/stepStatus
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * The icon vocabulary is the StatusIndicator catalog (OD-D11 (a), the recommended option; the
+ * owner's design sign-off is pending). If design rejects it, only STEP_STATUS_CATALOG changes
+ * (first fallback (a2): `pending` as `inactive`), with no API change.
+ *
+ * | Step status | Catalog status | Default text |
+ * |---|---|---|
+ * | `pending` | `pending` (clock) | Not started |
+ * | `active` | `in-progress` (refresh) | In progress |
+ * | `completed` | `complete` (check) | Completed |
+ * | `warning` | `warning` | Needs attention |
+ * | `error` | `error` | Failed |
+ */
+import type { StatusType } from '../StatusIndicator/types';
+/** The status of one step. @internal */
+export type StepListStatus = 'pending' | 'active' | 'completed' | 'warning' | 'error';
+/** The StatusIndicator catalog status each step status draws (OD-D11 (a)). @internal */
+export declare const STEP_STATUS_CATALOG: Readonly<Record<StepListStatus, StatusType>>;
+/**
+ * The default status texts, in sentence case (MICROCOPY). The catalog's Title Case labels
+ * ("In Progress") are never used as step text. @internal
+ */
+export declare const DEFAULT_STEP_STATUS_LABELS: Readonly<Record<StepListStatus, string>>;
+//# sourceMappingURL=stepStatus.d.ts.map

package/dist/components/StepList/stepStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepStatus.d.ts","sourceRoot":"","sources":["../../../src/components/StepList/stepStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtF,wFAAwF;AACxF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,CAM5E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAM/E,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"SystemBanner.d.ts","sourceRoot":"","sources":["../../../src/components/SystemBanner/SystemBanner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,SAAS,CAAC;AAwDvE,eAAO,MAAM,YAAY,0FA+ExB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SystemBanner.d.ts","sourceRoot":"","sources":["../../../src/components/SystemBanner/SystemBanner.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAY/B,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,SAAS,CAAC;AA+DvE,eAAO,MAAM,YAAY,0FA2FxB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/Timeline/Timeline.d.ts

@@ -11,6 +11,9 @@
  *  ```
  */
 import * as React from 'react';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TimelineLabels } from './timelineLabels';
+export type { TimelineLabels } from './timelineLabels';
 export type TimelineVariant = 'default' | 'compact' | 'detailed';
 export type TimelineItemType = 'default' | 'success' | 'warning' | 'error' | 'info';
 export interface TimelineItem {
@@ -61,11 +64,31 @@ export interface TimelineProps {
     showConnector?: boolean;
     /** Alternate sides (for detailed variant) */
     alternate?: boolean;
-    /** Custom render function for items */
+    /**
+     * Custom render function for items. Timeline wraps each result in the list item
+     * (`<li key={item.id}>`) itself, with the item's type text; date-group headings are
+     * Timeline's own and are not passed here. `index` is the item's position in the rendered
+     * sequence, date-group headings included.
+     */
     renderItem?: (item: TimelineItem, index: number) => React.ReactNode;
-    /** Group items by date */
+    /**
+     * Group items by date. Each group is a heading (`groupHeadingLevel`) followed by its own
+     * ordered list.
+     */
     groupByDate?: boolean;
-    /** Callback when item is clicked */
+    /**
+     * Heading level of the date-group labels (`groupByDate`, or items with `isGroupHeader`).
+     * They keep their caption style at every level.
+     * @default 3
+     * @since 2.13.0
+     */
+    groupHeadingLevel?: HeadingLevel;
+    /**
+     * Callback when an item is activated. An item without expandable content then has a
+     * primary action: a button that covers the item, named by its title, reachable with Tab
+     * and run by Enter and Space (B-25). An expandable item expands instead; its "Show details"
+     * button is the keyboard path.
+     */
     onItemClick?: (item: TimelineItem) => void;
     /** Show "Load more" button */
     showLoadMore?: boolean;
@@ -77,6 +100,35 @@ export interface TimelineProps {
     emptyMessage?: string;
     /** Max height with scroll */
     maxHeight?: number | string;
+    /**
+     * Locale of the date-group labels (`groupByDate`), as a BCP 47 tag.
+     * The default keeps server and client markup identical; pass the user's locale
+     * (for example `useAILocale()` or `navigator.language` read after mount) to localize.
+     * @default 'en-US'
+     * @since 2.13.0
+     */
+    locale?: string;
+    /**
+     * IANA time zone that decides which day an item belongs to (`groupByDate`).
+     * Without it the runtime's zone is used, so a server and a browser in different zones
+     * can group an item under different days: server-rendered apps should pass one.
+     * @default undefined (the runtime's time zone)
+     * @since 2.13.0
+     */
+    timeZone?: string;
+    /**
+     * Formats the label of a date group (`groupByDate`). Called with each valid item date;
+     * items whose timestamp is not a valid date go under `labels.unknownDate`. Items are grouped
+     * by the returned string. Overrides `locale` and `timeZone` for the label text.
+     * @since 2.13.0
+     */
+    formatGroupLabel?: (date: Date) => string;
+    /**
+     * Overrides for Timeline's built-in strings (any subset; NAMING.md "Label overrides"). Keys
+     * you leave out keep their English defaults (see {@link TimelineLabels}).
+     * @since 2.13.0
+     */
+    labels?: Partial<TimelineLabels>;
 }
 export declare const TimelineItemComponent: React.FC<{
     item: TimelineItem;
@@ -84,6 +136,8 @@ export declare const TimelineItemComponent: React.FC<{
     showConnector: boolean;
     isLast: boolean;
     onClick?: (item: TimelineItem) => void;
+    /** Resolved strings; Timeline passes its `labels` merged over the defaults. */
+    labels?: TimelineLabels;
 }>;
 export declare const Timeline: React.ForwardRefExoticComponent<TimelineProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Timeline.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../../src/components/Timeline/Timeline.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpF,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,yBAAyB;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAClC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,sBAAsB;IACtB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACpE,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oCAAoC;IACpC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3C,8BAA8B;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,yBAAyB;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC;IAC3C,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;CACxC,CAgPA,CAAC;AAoBF,eAAO,MAAM,QAAQ,sFAoGnB,CAAC"}
+{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../../src/components/Timeline/Timeline.tsx"],"names":[],"mappings":"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"}

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

@@ -1,2 +1,2 @@
-export { Timeline, type TimelineProps, type TimelineItem, TimelineItemComponent } from './Timeline';
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineLabels, TimelineItemComponent } from './Timeline';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Timeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Timeline/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/components/Timeline/timelineLabels.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Timeline's overridable strings and their English defaults (B-25, H-44, NAMING.md
+ * "Label overrides (non-AI)", H-47).
+ * @module components/Timeline/timelineLabels
+ */
+import type { TimelineItemType } from './Timeline';
+/**
+ * Strings Timeline renders. Pass a partial object to `labels`; keys you leave out (or set to
+ * `undefined`) keep their English defaults.
+ *
+ * @since 2.13.0
+ */
+export interface TimelineLabels {
+    /**
+     * Name and tooltip of an expandable item's button while the item is collapsed.
+     * @default 'Show details'
+     */
+    expandDetails: string;
+    /**
+     * Name and tooltip of an expandable item's button while the item is expanded.
+     * @default 'Hide details'
+     */
+    collapseDetails: string;
+    /**
+     * Visible caption under an item's title in the detailed variant, naming who acted.
+     * @default ({ actor }) => `by ${actor}`
+     */
+    actorPrefix: (args: {
+        actor: string;
+    }) => string;
+    /**
+     * Group label for items whose `timestamp` is not a valid date (with `groupByDate`).
+     * @default 'Unknown date'
+     */
+    unknownDate: string;
+    /**
+     * Text of the load-more button (`showLoadMore` with `onLoadMore`).
+     * @default 'Load more'
+     */
+    loadMore: string;
+    /**
+     * Text of the load-more button while `loadingMore` is true.
+     * @default 'Loading...'
+     */
+    loadingMore: string;
+    /**
+     * Visually hidden text read before each item that has a `type`, so the type is not conveyed by
+     * the dot or icon color alone (WCAG 1.4.1). A type without an entry here gets no text; keys you
+     * pass are merged over the defaults one by one.
+     * @default { success: 'Success', warning: 'Warning', error: 'Error', info: 'Info' }
+     */
+    types: Partial<Record<TimelineItemType, string>>;
+}
+/**
+ * English defaults for {@link TimelineLabels}.
+ * @internal
+ */
+export declare const DEFAULT_TIMELINE_LABELS: TimelineLabels;
+/**
+ * Merges the consumer's partial labels over the defaults. A key set to `undefined` keeps its
+ * default.
+ * @internal
+ */
+export declare function resolveTimelineLabels(overrides: Partial<TimelineLabels> | undefined): TimelineLabels;
+/**
+ * The hidden type text for an item, or undefined for an untyped item or a type without a label.
+ * @internal
+ */
+export declare function timelineTypeLabel(labels: TimelineLabels, type: TimelineItemType | undefined): string | undefined;
+//# sourceMappingURL=timelineLabels.d.ts.map

package/dist/components/Timeline/timelineLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timelineLabels.d.ts","sourceRoot":"","sources":["../../../src/components/Timeline/timelineLabels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACjD;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAQrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,GAAG,cAAc,CAWpG;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGhH"}

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

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAMN,MAAM,OAAO,CAAC;AAcf,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACrE,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC;AACnB,KAAK,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,gCAAgC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC;IACzC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACtE,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACnE,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACtE,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACpE,qCAAqC;IACrC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,yBAAyB;IACzB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sCAAsC;IACtC,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,cAAc,CAAC;CACpC;AA6CD;;GAEG;AACH,eAAO,MAAM,KAAK,mFA4DhB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2ItD,CAAC;AAmBF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,QAAO,gBAM3B,CAAC;AAEF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/components/Toast/Toast.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAMN,MAAM,OAAO,CAAC;AAef,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AACrE,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC;AACnB,KAAK,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,uCAAuC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,UAAU,gBAAgB;IACxB,gCAAgC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC;IACzC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACtE,yBAAyB;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACnE,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACtE,0BAA0B;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;IACpE,qCAAqC;IACrC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,yBAAyB;IACzB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAID;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,sCAAsC;IACtC,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,cAAc,CAAC;CACpC;AA6CD;;GAEG;AACH,eAAO,MAAM,KAAK,mFA4DhB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2ItD,CAAC;AAmBF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,QAAO,gBAM3B,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/components/TopNavHeader.d.ts

@@ -42,8 +42,19 @@ export interface TopNavHeaderProps {
      * When provided, shown alongside or replacing the `appName` display text.
      */
     productName?: string;
-    /** Currently selected client name shown in the client selector. @default 'Long Client Name 1' */
+    /**
+     * The client name shown in the client selector, on every render (controlled). The selector
+     * does not change it by itself: update the prop from `onClientChange`. Leave it unset to let
+     * the selector keep the user's choice (`defaultClientName`).
+     */
     clientName?: string;
+    /**
+     * The client name shown first when `clientName` is not passed (uncontrolled); picking a client
+     * in the selector then changes it.
+     * @default 'Long Client Name 1'
+     * @since 2.13.1
+     */
+    defaultClientName?: string;
     /** Array of available clients for the dropdown selector. */
     clients?: {
         id: string;
@@ -51,6 +62,12 @@ export interface TopNavHeaderProps {
     }[];
     /** Callback fired when the user selects a different client. */
     onClientChange?: (clientId: string) => void;
+    /**
+     * Accessible name of the client picker's trigger, from the current client (B-37).
+     * @default (client) => `Switch client, current: ${client}`
+     * @since 2.13.0
+     */
+    clientSelectorLabel?: (client: string) => string;
     /** User initials displayed in the avatar circle. @default 'RD' */
     userInitials?: string;
     /** Full name of the logged-in user, shown in the user menu header. */

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

@@ -1 +1 @@
-{"version":3,"file":"TopNavHeader.d.ts","sourceRoot":"","sources":["../../src/components/TopNavHeader.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkD/B,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,qEAAqE;IACrE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD;;;;;;;;;;OAUG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC;AAED,QAAA,MAAM,YAAY,uFA4nBhB,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"TopNavHeader.d.ts","sourceRoot":"","sources":["../../src/components/TopNavHeader.tsx"],"names":[],"mappings":"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"}

package/dist/components/TopNavWithSidebar.d.ts

@@ -14,6 +14,28 @@ interface NavItem {
     label: string;
     icon: React.ReactNode;
     isSpecial?: boolean;
+    /**
+     * What the item does (H-11). `'page'` navigates: a click selects it and it
+     * carries `aria-current="page"` while selected. `'toggle'` opens and closes
+     * something on the page (a panel): it is never selected, never carries
+     * `aria-current`, and its selected styling follows `expanded`. A click still
+     * fires `onNavItemClick`.
+     * @default 'page'
+     * @since 2.13.0
+     */
+    kind?: 'page' | 'toggle';
+    /**
+     * A toggle item's state: rendered as `aria-expanded` when defined, and its
+     * selected styling while `true`.
+     * @since 2.13.0
+     */
+    expanded?: boolean;
+    /**
+     * Id of the element a toggle item opens, rendered as `aria-controls` when
+     * defined. Pass it only while that element is in the document.
+     * @since 2.13.0
+     */
+    controls?: string;
 }
 interface App {
     id: string;
@@ -36,8 +58,19 @@ interface TopNavWithSidebarProps {
      * When provided, shown alongside or replacing the `appName` display text.
      */
     productName?: string;
-    /** Currently selected client name shown in the client selector. @default 'Long Client Name 1' */
+    /**
+     * The client name shown in the client selector, on every render (controlled). The selector
+     * does not change it by itself: update the prop from `onClientChange`. Leave it unset to let
+     * the selector keep the user's choice (`defaultClientName`).
+     */
     clientName?: string;
+    /**
+     * The client name shown first when `clientName` is not passed (uncontrolled); picking a client
+     * in the selector then changes it.
+     * @default 'Long Client Name 1'
+     * @since 2.13.1
+     */
+    defaultClientName?: string;
     /** Array of available clients for the dropdown selector. */
     clients?: {
         id: string;
@@ -45,6 +78,12 @@ interface TopNavWithSidebarProps {
     }[];
     /** Callback fired when the user selects a different client. */
     onClientChange?: (clientId: string) => void;
+    /**
+     * Accessible name of the client picker's trigger, from the current client (B-37).
+     * @default (client) => `Switch client, current: ${client}`
+     * @since 2.13.0
+     */
+    clientSelectorLabel?: (client: string) => string;
     /** User initials displayed in the avatar circle. @default 'RD' */
     userInitials?: string;
     /** Full name of the logged-in user, shown in the user menu header. */
@@ -61,8 +100,28 @@ interface TopNavWithSidebarProps {
     apps?: App[];
     /** Array of navigation items rendered in the sidebar. */
     navItems?: NavItem[];
-    /** ID of the currently selected navigation item. @default 'home' */
+    /**
+     * ID of the selected navigation item (controlled). The highlight and `aria-current` follow
+     * this prop on every render, so derive it from your router's location. A click does not
+     * move the highlight by itself: update the prop from `onSelectedNavItemChange` (or
+     * `onNavItemClick`). Leave it `undefined` to let the sidebar keep the selection
+     * (`defaultSelectedNavItem`).
+     */
     selectedNavItem?: string;
+    /**
+     * The item selected first when `selectedNavItem` is not passed (uncontrolled); a click
+     * on a page item then moves the selection. Read on the first render only.
+     * @default 'home'
+     * @since 2.13.0
+     */
+    defaultSelectedNavItem?: string;
+    /**
+     * Fired when the user selects a different page item (not for `kind: 'toggle'` items,
+     * and not for the item that is already selected), in both modes. Receives the new and
+     * the previously selected ID. A controlled `selectedNavItem` should be set from here.
+     * @since 2.13.0
+     */
+    onSelectedNavItemChange?: (itemId: string, previousId: string | undefined) => void;
     /**
      * Callback fired when a sidebar navigation item is clicked.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"TopNavWithSidebar.d.ts","sourceRoot":"","sources":["../../src/components/TopNavWithSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmE/B,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,GAAG;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,UAAU,sBAAsB;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,qFAAqF;IACrF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,qEAAqE;IACrE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,uBAAuB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,qFAAqF;IACrF,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IACjD;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAChC;AAWD,QAAA,MAAM,iBAAiB,+FAmtBrB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"TopNavWithSidebar.d.ts","sourceRoot":"","sources":["../../src/components/TopNavWithSidebar.tsx"],"names":[],"mappings":"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"}