@trinityui/design-system 2.11.1 → 2.13.0

package/dist/components/navigation/clientSelectorLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientSelectorLabels.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/clientSelectorLabels.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,KAAG,MAA6C,CAAC;AAE1G,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,kBAAkB,CAAC"}

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

@@ -44,6 +44,12 @@ export interface ClientMenuProps {
     onButtonClick: (event: React.MouseEvent<HTMLElement>) => void;
     onClose: () => void;
     onSelect: (client: Client) => void;
+    /**
+     * Accessible name of the trigger, from the current client.
+     * @default (client) => `Switch client, current: ${client}`
+     * @since 2.13.0
+     */
+    clientSelectorLabel?: (client: string) => string;
 }
 export declare const ClientMenu: React.ForwardRefExoticComponent<ClientMenuProps & React.RefAttributes<HTMLButtonElement>>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/components.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AA6B1B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAMtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,WAAW,yFAQvB,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,uFA6BpB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,eAAO,MAAM,UAAU,2FA6DrB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,QAAQ,yFA4DnB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,eAAO,MAAM,QAAQ,yFA+EnB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAwBtD,CAAC"}
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/components.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AA8B1B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAUtC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,WAAW,yFAQvB,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAC/D,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,uFA+BpB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAED,eAAO,MAAM,UAAU,2FAuErB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,QAAQ,yFAwEnB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,eAAO,MAAM,QAAQ,yFA+FnB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA4BtD,CAAC"}

package/dist/components/shared/AsyncOutcomeAlert.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview AsyncOutcomeAlert: the one inline error surface for a failed async action (ADR-36 (4)).
+ * @module components/shared/AsyncOutcomeAlert
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * A surface that runs an action through `useAsyncAction` (B-07) renders this
+ * below its controls when the action fails: an MUI Alert (severity error,
+ * theme colours only) with the message and, when the action can run again, a
+ * retry button. It holds no built-in strings: the surface passes the message
+ * (MICROCOPY's "what happened / what to do" form) and the button text.
+ *
+ * - Announcement: the message is announced once, assertively, through
+ *   `useAnnounce` (B-04), so it reaches the nearest `LiveRegionProvider` (a
+ *   Modal or Popover paper) or the document-level region. The Alert itself
+ *   carries no `role="alert"` (G-OD9): inside a chat log or a live container
+ *   an implicit live role would announce twice or nest live regions. A new
+ *   message text is announced again; a re-render with the same text is not.
+ * - Focus (ADR-31, ADR-36 (1)): it never steals focus. When the Alert appears
+ *   and nothing has focus (the control that failed was removed), focus moves to
+ *   the Alert. After the retry button is pressed, if the button goes away (the
+ *   surface removes the Alert, or renders it again without a retry), focus
+ *   moves to `focusFallbackRef`, else to the Alert while it is still shown.
+ * - Root props: `className`, `sx`, `style`, `ref`, `data-*` and `aria-*` reach
+ *   the Alert root. `role` and `tabIndex` are owned.
+ * - Narrow hosts (a 360px popover, a 320px panel): the retry button wraps below
+ *   the message once the message would get less than 12rem, and long words
+ *   wrap, so the message never becomes a narrow box that scrolls sideways
+ *   (MUI's message is `overflow: auto`, which axe then reports as a
+ *   scrollable region with nothing focusable in it). Wide hosts look the same:
+ *   the button stays at the inline end.
+ *
+ * @example
+ * ```tsx
+ * const submitRef = React.useRef<HTMLButtonElement>(null);
+ * const save = useAsyncAction(onSave);
+ * {save.status === 'error' && (
+ *   <AsyncOutcomeAlert
+ *     message={strings.saveFailed}   // "The changes were not saved. Check your connection and try again."
+ *     retryLabel={strings.tryAgain}  // "Try again"
+ *     onRetry={() => save.run(values)}
+ *     error={save.error}
+ *     focusFallbackRef={submitRef}
+ *   />
+ * )}
+ * ```
+ */
+import * as React from 'react';
+import { type SxProps, type Theme } from '@mui/material';
+/** Props of `AsyncOutcomeAlert` that every variant shares. */
+interface AsyncOutcomeAlertBaseProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children' | 'role' | 'tabIndex' | 'onError' | 'color'> {
+    /** What happened and what to do next. Announced assertively when it appears or changes. */
+    message: React.ReactNode;
+    /**
+     * The error the action reported. It is never rendered (it may hold
+     * internals); pass it so developer tools show the cause next to the message.
+     */
+    error?: unknown;
+    /**
+     * Where focus goes when the retry button disappears after it was pressed
+     * (the Alert is removed, or shown again without a retry). Usually the
+     * control that started the action. Without it, focus goes to the Alert
+     * while it is still shown.
+     */
+    focusFallbackRef?: React.RefObject<HTMLElement | null>;
+    /** Styles for the Alert root, merged after the defaults. */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Props of `AsyncOutcomeAlert`. `retryLabel` is required when `onRetry` is set:
+ * the component has no built-in strings.
+ *
+ * @internal
+ */
+export type AsyncOutcomeAlertProps = AsyncOutcomeAlertBaseProps & ({
+    /** Runs the failed action again. Shows the retry button. */
+    onRetry: () => void;
+    /** The retry button text, for example "Try again". */
+    retryLabel: string;
+} | {
+    onRetry?: undefined;
+    retryLabel?: undefined;
+});
+/**
+ * The inline error surface for a failed async action (ADR-36 (4)).
+ *
+ * @internal
+ */
+export declare const AsyncOutcomeAlert: React.ForwardRefExoticComponent<AsyncOutcomeAlertProps & React.RefAttributes<HTMLDivElement>>;
+export {};
+//# sourceMappingURL=AsyncOutcomeAlert.d.ts.map

package/dist/components/shared/AsyncOutcomeAlert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncOutcomeAlert.d.ts","sourceRoot":"","sources":["../../../src/components/shared/AsyncOutcomeAlert.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAsB,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAO7E,8DAA8D;AAC9D,UAAU,0BACR,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1G,2FAA2F;IAC3F,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvD,4DAA4D;IAC5D,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAC7D,CACI;IACE,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,OAAO,CAAC,EAAE,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,CAAA;CAAE,CAClD,CAAC;AAcJ;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,+FAyF5B,CAAC"}

package/dist/components/shared/TrinityIconSvg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrinityIconSvg.d.ts","sourceRoot":"","sources":["../../../src/components/shared/TrinityIconSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAuCxD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TrinityIconSvg.d.ts","sourceRoot":"","sources":["../../../src/components/shared/TrinityIconSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAyCxD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/shared/TrinityLogoSvg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrinityLogoSvg.d.ts","sourceRoot":"","sources":["../../../src/components/shared/TrinityLogoSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAiExD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"TrinityLogoSvg.d.ts","sourceRoot":"","sources":["../../../src/components/shared/TrinityLogoSvg.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAsExD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/components/shared/bidi.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Bidi isolation for text that is not written in the UI language (E-48+;
+ * docs/RTL.md, "Mixed-direction text").
+ * @module components/shared/bidi
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * A value that comes from a model, a user or a data source can be in any script. Placed next to
+ * a label in the UI's language, its neutral characters (punctuation, spaces, brackets, digits
+ * at the edges) take their direction from the label's paragraph and reorder: in an Arabic UI,
+ * `v2.1 (beta)!` shows its `!` before the `v`. Isolating the value lets its own first strong
+ * character decide its direction and keeps it from reordering the label around it.
+ *
+ * - {@link BidiIsolate}: the element form, `<span dir="auto">` with `unicode-bidi: isolate`.
+ * - `isolateText` (./bidiText.ts): the string form, for text that must stay a string
+ *   (`aria-label`, `title`, live-region announcements): the value between Unicode isolate
+ *   controls. It has its own module so this one exports only a component (react-refresh).
+ *
+ * Isolate values, never labels: a label is authored in the UI language and follows the page.
+ * It lives here, in src/components/shared/, so the shared blocks (MetaChip, KeyValueList) can
+ * import it (src/__tests__/shared-block-layering.test.ts).
+ */
+import { type HTMLAttributes, type ReactNode } from 'react';
+import type { BidiDirection } from './bidiText';
+/** Props of {@link BidiIsolate}. @internal */
+export interface BidiIsolateProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'dir'> {
+    /** The value to isolate: model, user or data text. */
+    children?: ReactNode;
+    /**
+     * 'auto' (the default): the value's first strong character decides, which is right for text
+     * in an unknown script. 'ltr' for content that is always left to right whatever its first
+     * character: code, URLs, e-mail addresses, file paths and identifiers. 'rtl' only for a value
+     * known to be right to left.
+     * @default 'auto'
+     */
+    dir?: BidiDirection;
+}
+/**
+ * An inline bidi isolate: `<span dir="auto">` with `unicode-bidi: isolate`. Wrap the value, not
+ * the label: `{label}: <BidiIsolate>{value}</BidiIsolate>`. It adds no box, colour or spacing.
+ * @internal
+ */
+export declare const BidiIsolate: import("react").ForwardRefExoticComponent<BidiIsolateProps & import("react").RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=bidi.d.ts.map

package/dist/components/shared/bidi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidi.d.ts","sourceRoot":"","sources":["../../../src/components/shared/bidi.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,8CAA8C;AAC9C,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;IACpF,sDAAsD;IACtD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,8GAKtB,CAAC"}

package/dist/components/shared/bidiText.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview The string form of bidi isolation (E-48+; docs/RTL.md, "Mixed-direction text"),
+ * for text that cannot hold markup. The element form is `BidiIsolate` in ./bidi.tsx.
+ * @module components/shared/bidiText
+ *
+ * @internal — not part of the public API; see ADR-02
+ */
+/** The direction of an isolated value: 'auto' lets its first strong character decide. */
+export type BidiDirection = 'auto' | 'ltr' | 'rtl';
+/** First strong isolate, left-to-right isolate, right-to-left isolate, pop directional isolate. */
+export declare const BIDI_ISOLATE_CONTROLS: Readonly<{
+    auto: "⁨";
+    ltr: "⁦";
+    rtl: "⁧";
+    pop: "⁩";
+}>;
+/**
+ * The string form of {@link BidiIsolate}: the value between Unicode isolate controls (U+2068
+ * FIRST STRONG ISOLATE, or U+2066 / U+2067 for a fixed direction, then U+2069 POP DIRECTIONAL
+ * ISOLATE). Use it where markup cannot go, such as `aria-label`, `title` and announcements:
+ * ``aria-label={`Remove ${isolateText(fileName, 'ltr')}`}``. An empty value stays empty.
+ * @internal
+ */
+export declare function isolateText(value: string, dir?: BidiDirection): string;
+//# sourceMappingURL=bidiText.d.ts.map

package/dist/components/shared/bidiText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bidiText.d.ts","sourceRoot":"","sources":["../../../src/components/shared/bidiText.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEnD,mGAAmG;AACnG,eAAO,MAAM,qBAAqB;;;;;EAKhC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,aAAsB,GAAG,MAAM,CAG9E"}

package/dist/components/shared/containerQueries.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Container-query helpers for components hosted in narrow containers
+ * (master-plan E-19, ADR-11 §5).
+ * @module components/shared/containerQueries
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * Panel-hosted components (an AI panel 320-420px wide inside a desktop viewport) cannot use
+ * viewport breakpoints: the viewport says "desktop" while the panel is narrow. They respond
+ * to their container instead, with the widths in `semanticTokens.spacing.layout.containerQuery`
+ * (narrow 320, compact 360, regular 600), which are JavaScript-only: a CSS custom property
+ * cannot be an `@container` operand (H-08).
+ *
+ * The policy (docs/TOKEN_USAGE_RULES.md, "Narrow containers"):
+ *
+ * - Every panel-hosted component is usable at `narrow` (320px) with no horizontal scroll.
+ * - Below `compact`, footers and toolbars wrap or collapse.
+ * - Container queries for components, viewport breakpoints only for page layout.
+ * - **The inner-wrapper rule.** `container-type: inline-size` goes on an inner wrapper
+ *   ({@link containerWrapperSx}), never on the component's public root. A size container
+ *   cannot size itself from its content, so on the root it would change how the component
+ *   sizes in its host, and it would turn a consumer's `sx` on the root into a container
+ *   query target they did not ask for. Rules inside the wrapper query it with
+ *   {@link containerUp} and {@link containerDown}.
+ *
+ * Container queries need an evergreen browser (ADR-11); MUI 9 builds the conditions.
+ *
+ * @example
+ * ```tsx
+ * <Box className="root">
+ *   <Box sx={containerWrapperSx}>
+ *     <Box sx={(theme) => ({
+ *       display: 'flex',
+ *       flexWrap: 'nowrap',
+ *       [containerDown(theme, 'compact')]: { flexWrap: 'wrap' },
+ *     })} />
+ *   </Box>
+ * </Box>
+ * ```
+ */
+import type { Theme } from '@mui/material/styles';
+import { type TrinityContainerQuerySizes } from '../../tokens';
+/** A container width role: `narrow` (320px), `compact` (360px) or `regular` (600px). */
+export type ContainerQuerySize = keyof TrinityContainerQuerySizes;
+/**
+ * The inner wrapper that becomes the size container. `width: 100%` keeps it as wide as the
+ * component, because an inline-size container does not size from its content.
+ *
+ * For the same reason its content gives the component no width in a host that sizes from content
+ * (a flex row whose child has no width, a grid `auto` column, a popover's paper): the component
+ * would be 0px wide there (F-22's hosting check). `containIntrinsicInlineSize` gives the
+ * container the narrow container width (320px, `semanticTokens.spacing.layout.containerQuery`)
+ * as its intrinsic inline size, the width every panel-hosted component is usable at; a host that
+ * sets a width still decides the width.
+ */
+export declare const containerWrapperSx: {
+    readonly containerType: "inline-size";
+    readonly width: "100%";
+    readonly containIntrinsicInlineSize: `${number}px`;
+};
+/**
+ * The width in px for a container role: the theme's resolved tokens (token overrides reach
+ * it), else the defaults. Works under a plain MUI theme too.
+ */
+export declare function containerQueryWidth(theme: Theme, size: ContainerQuerySize): number;
+/**
+ * `@container (min-width:<px>)` for a role, or `@container <name> (min-width:<px>)` when the
+ * wrapper has a `containerName`. Use as an `sx` key.
+ */
+export declare function containerUp(theme: Theme, size: ContainerQuerySize, name?: string): string;
+/** `@container (max-width:<px - 0.05>)` for a role: below that width. Use as an `sx` key. */
+export declare function containerDown(theme: Theme, size: ContainerQuerySize, name?: string): string;
+//# sourceMappingURL=containerQueries.d.ts.map

package/dist/components/shared/containerQueries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"containerQueries.d.ts","sourceRoot":"","sources":["../../../src/components/shared/containerQueries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAkB,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/E,wFAAwF;AACxF,MAAM,MAAM,kBAAkB,GAAG,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAGlF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzF;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3F"}

package/dist/components/shared/createStringsContext.d.ts

@@ -0,0 +1,69 @@
+import type { Context, ReactElement, ReactNode } from 'react';
+/**
+ * Every key optional, at every depth. Functions (count strings) are leaves: they are replaced
+ * whole, never merged.
+ *
+ * @internal
+ */
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends (...args: never[]) => unknown ? T[K] : T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+/** @internal */
+export interface StringsProviderProps<T> {
+    /** Keys to replace; the rest come from the nearest parent provider, then the defaults. */
+    strings?: DeepPartial<T>;
+    children?: ReactNode;
+}
+/** @internal */
+export interface StringsContextOptions {
+    /** The public component that renders the provider, named in warnings. Default `StringsProvider(<namespace>)`. */
+    providerName?: string;
+}
+/** @internal */
+export interface StringsContextKit<T> {
+    /** The namespace, for example 'ai'. */
+    namespace: string;
+    /** The built-in strings, returned when no provider is mounted. */
+    defaults: T;
+    /** The context itself; its default value is `defaults`. */
+    Context: Context<T>;
+    /** Deep-merges `strings` over the nearest parent value. */
+    StringsProvider: (props: StringsProviderProps<T>) => ReactElement;
+    /** The merged strings of the nearest provider, or `defaults`. */
+    useStrings: () => T;
+}
+/**
+ * Deep-merges `overrides` over `base` without mutating either. Returns `base` itself when
+ * there is nothing to merge, so the value keeps its identity.
+ *
+ * @internal
+ */
+export declare function mergeStrings<T>(base: T, overrides: DeepPartial<T> | undefined): T;
+/**
+ * A stable text form of a value for the churn check: object keys sorted, functions by their
+ * source text (an inline arrow re-created on each render has the same text).
+ *
+ * @internal
+ */
+export declare function contentHash(value: unknown): string;
+/**
+ * Dev-only identity-churn check (ADR-06 (4)). Runs after every commit of the calling
+ * component and warns once when `value` got a new identity with equal content on more than 3
+ * consecutive commits. Checking in an effect means StrictMode's double render never counts,
+ * and its double effect sees the same identity twice, which is not a change.
+ *
+ * @internal
+ */
+export declare function useIdentityChurnWarning(label: string, value: unknown): void;
+/**
+ * Creates a namespaced strings context: provider, hook and defaults.
+ *
+ * @param namespace The key namespace, for example 'ai'. Used in key paths, warnings and the
+ *   context's display name.
+ * @param defaults The built-in strings. Frozen by the caller or never mutated.
+ * @param options.providerName The public component that renders the provider, for warnings.
+ *
+ * @internal
+ */
+export declare function createStringsContext<T extends object>(namespace: string, defaults: T, options?: StringsContextOptions): StringsContextKit<T>;
+//# sourceMappingURL=createStringsContext.d.ts.map

package/dist/components/shared/createStringsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStringsContext.d.ts","sourceRoot":"","sources":["../../../src/components/shared/createStringsContext.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACpH,CAAC;AAEF,gBAAgB;AAChB,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,gBAAgB;AAChB,MAAM,WAAW,qBAAqB;IACpC,iHAAiH;IACjH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gBAAgB;AAChB,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,CAAC;IACZ,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,2DAA2D;IAC3D,eAAe,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,YAAY,CAAC;IAClE,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC,CAAC;CACrB;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CASjF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMlD;AAKD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CA4B3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACnD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,CAAC,EACX,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAAC,CAAC,CAAC,CAkBtB"}

package/dist/components/shared/direction.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Direction helpers for the CSS that logical properties cannot express (ADR-11,
+ * master-plan E-18; docs/QUICK_START.md, "Right-to-left").
+ * @module components/shared/direction
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * Layout uses logical properties, which follow `dir` with or without stylis-plugin-rtl:
+ * `marginInlineStart`, `paddingInlineEnd`, `insetInlineStart`, `borderInlineStart`,
+ * `textAlign: 'start'` and `borderStartStartRadius` (and its three siblings). Never build them
+ * from these helpers.
+ *
+ * Transforms have no logical form, and the RTL plugin does not flip them: a chevron rotated to
+ * point at the inline end, or an entrance that slides in from the inline start, must read the
+ * theme's direction. These helpers do that, so a component never branches on `theme.direction`
+ * itself. They read `theme.direction`, which `createTrinityTheme(mode, overrides, 'rtl')` and
+ * the presets' `direction` option set; the consumer also sets `dir` on the root
+ * (QUICK_START). A theme without a direction is left to right, as in MUI.
+ */
+import type { Theme } from '@mui/material/styles';
+/** The part of a theme the helpers read; any MUI theme fits. */
+export type DirectionSource = Pick<Theme, 'direction'> | {
+    direction?: Theme['direction'];
+};
+/** Whether the theme lays out right to left. */
+export declare function isRtl(theme: DirectionSource): boolean;
+/**
+ * The sign of the inline-end direction on the physical x axis: `1` left to right, `-1` right to
+ * left. Multiply an x offset or an angle that points toward the inline end by it.
+ */
+export declare function inlineSign(theme: DirectionSource): 1 | -1;
+/**
+ * A `rotate()` for an angle written for left to right, mirrored right to left. A chevron that
+ * points down (`chevron-down`) and turns to point at the inline end when collapsed uses
+ * `rotateInline(theme, -90)`: `rotate(-90deg)` left to right, `rotate(90deg)` right to left.
+ * Zero stays `rotate(0deg)`.
+ */
+export declare function rotateInline(theme: DirectionSource, degrees: number): string;
+/**
+ * A `translateX()` that moves an element `px` pixels toward the inline start (negative values
+ * move it toward the inline end): `translateX(-8px)` left to right, `translateX(8px)` right to
+ * left for `translateInlineStart(theme, 8)`. Use it for an entrance that slides in from the
+ * start edge; zero is `translateX(0px)`.
+ */
+export declare function translateInlineStart(theme: DirectionSource, px: number): string;
+//# sourceMappingURL=direction.d.ts.map

package/dist/components/shared/direction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../../src/components/shared/direction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAElD,gEAAgE;AAChE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;CAAE,CAAC;AAE5F,gDAAgD;AAChD,wBAAgB,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,CAAC,GAAG,CAAC,CAAC,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG/E"}

package/dist/components/shared/focusTrap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview The focus trap of Trinity's light-dismiss surfaces (C-07, ADR-15, ADR-34).
+ * @module components/shared/focusTrap
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * Trinity adopts MUI's focus trap instead of writing one (keyboard-models.md, "Popper click
+ * mode": ADOPT). MUI 9.4.0 ships it only as `Unstable_TrapFocus`; this module is the one place
+ * that imports it, so a rename in MUI touches one line. A hand-written Tab trap is a strict
+ * check:behavior finding (`focus-trap-manual`).
+ *
+ * What the trap does while `open`: it moves focus into its child (the child needs `tabIndex={-1}`
+ * and must hold a ref), keeps Tab and Shift+Tab inside it, and pulls focus back if it leaves.
+ * Options a surface sets:
+ * - `disableRestoreFocus`: the surface restores focus itself (Popper returns it to its trigger,
+ *   which a browser that does not focus clicked buttons, Safari, would not have recorded);
+ * - `disableEnforceFocus`: for surfaces that must let focus leave (not used by Popper).
+ *
+ * @example
+ * ```tsx
+ * <FocusTrap open={open} disableRestoreFocus>
+ *   <Paper ref={ref} tabIndex={-1} role="dialog" aria-modal="true" aria-label="Filters">…</Paper>
+ * </FocusTrap>
+ * ```
+ */
+import TrapFocus from '@mui/material/Unstable_TrapFocus';
+import type { TrapFocusProps } from '@mui/material/Unstable_TrapFocus';
+/** MUI's focus trap, under Trinity's name. @internal */
+export declare const FocusTrap: typeof TrapFocus;
+/** Props of {@link FocusTrap}: MUI's `TrapFocusProps`. @internal */
+export type FocusTrapProps = TrapFocusProps;
+/** The elements a keyboard user can reach with Tab. @internal */
+export declare const TABBABLE_SELECTOR: string;
+/** The first element inside `root` that Tab reaches, or null. @internal */
+export declare function firstTabbable(root: Element | null): HTMLElement | null;
+//# sourceMappingURL=focusTrap.d.ts.map

package/dist/components/shared/focusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.d.ts","sourceRoot":"","sources":["../../../src/components/shared/focusTrap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,SAAS,MAAM,kCAAkC,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,wDAAwD;AACxD,eAAO,MAAM,SAAS,kBAAY,CAAC;AAEnC,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAE5C,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,QAYnB,CAAC;AAEZ,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI,CAMtE"}

package/dist/components/shared/getInitials.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview getInitials: up to two initials from a name, safe for any Unicode letter
+ * (master-plan C-21).
+ * @module components/shared/getInitials
+ *
+ * @internal — not part of the public API; see ADR-02
+ */
+/**
+ * The initials of a name: the first character of each of its first two words, upper-cased.
+ *
+ * - Characters are code points (`Array.from`), so a letter outside the Basic Multilingual
+ *   Plane (`𝒜`, `𠀋`, an emoji) is kept whole instead of being cut into half a surrogate pair.
+ * - Words are split on any whitespace; leading, trailing and repeated whitespace is ignored.
+ *   An empty or whitespace-only name gives `''`.
+ * - Without `locale`, `toUpperCase()` is locale-independent, so the server and the client
+ *   render the same text. Pass a locale for language-specific casing (`'tr'`: `i` becomes `İ`).
+ *
+ * UserAvatar and OrgChart use it; AuditDrawer moves onto it in C-34.
+ *
+ * @example
+ * ```ts
+ * getInitials('Ada Lovelace'); // 'AL'
+ * getInitials('  grace   brewster hopper '); // 'GB'
+ * getInitials('ilkay', 'tr'); // 'İ'
+ * ```
+ * @internal
+ */
+export declare function getInitials(name: string, locale?: string | string[]): string;
+//# sourceMappingURL=getInitials.d.ts.map

package/dist/components/shared/getInitials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getInitials.d.ts","sourceRoot":"","sources":["../../../src/components/shared/getInitials.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAW5E"}

package/dist/components/shared/headingLevel.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Heading-level contract (master plan WI-45, ADR-19 (2); docs/NAMING.md, "Heading level").
+ *
+ * One public type and two internal helpers, used by every component that renders its own title
+ * as a heading (AIContainer, AISourcesSection, AIExplainability, ChatHeader, AIDigestCard,
+ * AIChainOfThought phases, ChatThread) and by components that shift authored headings
+ * (AITextBlock's `headingOffset`).
+ *
+ * - `headingLevel?: HeadingLevel` sets the element of the component's own title. Level 1 is
+ *   reserved for the page.
+ * - The default preserves today's element, so adding the prop changes no DOM.
+ * - `headingOffset` (0-5) shifts authored headings inside content, clamped at h6.
+ * - A component whose title is not a heading takes `component`, never `headingLevel`.
+ *
+ * Invalid levels throw in development, so a wrong value is caught at once; in production they
+ * clamp into range, so a page never crashes over a heading.
+ *
+ * @module components/shared/headingLevel
+ *
+ * @internal — not part of the public API; see ADR-02
+ * (The `HeadingLevel` type is public: src/index.ts exports it. The helpers are internal.)
+ */
+/**
+ * The level of the heading element a component renders for its own title: 2 to 6, for h2 to
+ * h6. Level 1 is reserved for the page title. Every `headingLevel` prop uses this type (NAMING,
+ * "Heading level"), and its default keeps the element the component rendered before the prop.
+ *
+ * @example
+ * ```ts
+ * interface ReportCardProps {
+ *   title: string;
+ *   // Element of the title. Default 3: the card rendered an h3 before the prop existed.
+ *   headingLevel?: HeadingLevel;
+ * }
+ * ```
+ *
+ * @since 2.13.0
+ */
+export type HeadingLevel = 2 | 3 | 4 | 5 | 6;
+/**
+ * How many levels authored headings shift down, for example in markdown content: 0 to 5.
+ * The result is clamped at h6.
+ *
+ * @internal
+ */
+export type HeadingOffset = 0 | 1 | 2 | 3 | 4 | 5;
+/** @internal */
+export type HeadingElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+/**
+ * The element for a component's own title: `headingComponent(3)` is `'h3'`.
+ *
+ * @throws RangeError in development for anything but 2, 3, 4, 5 or 6. In production the level
+ *   is rounded and clamped into 2-6 (a non-number gives 'h2').
+ *
+ * @internal
+ */
+export declare function headingComponent(level: HeadingLevel): Exclude<HeadingElement, 'h1'>;
+/**
+ * The element for an authored heading (level 1-6, as written in the content) shifted down by
+ * `offset`, clamped at h6: `offsetHeadingComponent(1, 2)` is `'h3'`, `offsetHeadingComponent(5, 3)`
+ * is `'h6'`. The default offset 0 keeps the authored level.
+ *
+ * @throws RangeError in development for a level outside 1-6 or an offset outside 0-5. In
+ *   production both are rounded and clamped into range.
+ *
+ * @internal
+ */
+export declare function offsetHeadingComponent(level: 1 | 2 | 3 | 4 | 5 | 6, offset?: HeadingOffset): HeadingElement;
+//# sourceMappingURL=headingLevel.d.ts.map

package/dist/components/shared/headingLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headingLevel.d.ts","sourceRoot":"","sources":["../../../src/components/shared/headingLevel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAWrE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAMnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAE,aAAiB,GAAG,cAAc,CAQ9G"}

package/dist/components/shared/mergeSlotProps.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview mergeSlotProps: a slot's own props merged with the consumer's slotProps
+ * (ADR-04 (6), master-plan E-15).
+ * @module components/shared/mergeSlotProps
+ *
+ * @internal — not part of the public API; see ADR-02
+ *
+ * Merge rules, tested once here so every component's slots behave the same:
+ *
+ * - `sx`: the slot's own sx, then the consumer's ({@link mergeSx}).
+ * - `className`: both, the slot's first.
+ * - `style`: shallow merge, the consumer's keys win.
+ * - Event handlers (`on*`): when both are functions, the slot's own runs first, then the
+ *   consumer's, with the same arguments.
+ * - `aria-describedby` and `aria-labelledby`: both id lists, joined.
+ * - Owned attributes ({@link OwnedAttribute}): the slot's own values stay. A consumer value
+ *   is dropped, with a development warning (once per component).
+ * - Any other prop: the consumer's value wins, unless it is `undefined`. Read references
+ *   such as `id` from the merged result, so they follow a consumer's override.
+ *
+ * Slots are Trinity-owned: never pass the result straight into an MUI component's own
+ * slotProps without mapping it (ADR-04 (6)).
+ *
+ * @example
+ * ```tsx
+ * const titleProps = mergeSlotProps({ id: titleId, sx: titleSx }, slotProps?.title, { componentName: 'AIReviewItem', slotName: 'title' });
+ * <Typography {...titleProps} />  // and aria-labelledby={titleProps.id} on the region
+ * ```
+ */
+import type * as React from 'react';
+import { type OwnedAttribute, type TrinitySlotProps } from './rootProps';
+/**
+ * The props a component gives its own slot: the consumer's slot props plus the owned
+ * attributes, which only the component may set.
+ * @internal
+ */
+export type SlotOwnProps<El extends HTMLElement = HTMLElement> = TrinitySlotProps<El> & Partial<Pick<React.HTMLAttributes<El>, OwnedAttribute>>;
+/** Options of {@link mergeSlotProps}. @internal */
+export interface MergeSlotPropsOptions {
+    /** Names the component in the development warning. */
+    componentName?: string;
+    /** Names the slot in the development warning. */
+    slotName?: string;
+}
+/**
+ * Merges a slot's own props (`own`) with the consumer's `slotProps.<slot>` (`consumer`).
+ * @internal
+ */
+export declare function mergeSlotProps<El extends HTMLElement = HTMLElement>(own: SlotOwnProps<El> | undefined, consumer: TrinitySlotProps<El> | undefined, options?: MergeSlotPropsOptions): SlotOwnProps<El>;
+//# sourceMappingURL=mergeSlotProps.d.ts.map

package/dist/components/shared/mergeSlotProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeSlotProps.d.ts","sourceRoot":"","sources":["../../../src/components/shared/mergeSlotProps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAGpC,OAAO,EAA+D,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEtI;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,IAAI,gBAAgB,CAAC,EAAE,CAAC,GACnF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;AAE1D,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,SAAS,WAAW,GAAG,WAAW,EACjE,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,SAAS,EACjC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,CAAC,GAAG,SAAS,EAC1C,OAAO,GAAE,qBAA0B,GAClC,YAAY,CAAC,EAAE,CAAC,CAiClB"}