@trinityui/design-system 2.11.0 → 2.13.0

package/dist/components/AI/AIConfigProvider.d.ts

@@ -0,0 +1,66 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { DeepPartial } from '../shared/createStringsContext';
+import type { AIConfidenceThresholds, AIInteractionEvent, AIStrings } from './types/hitl';
+/**
+ * Props of {@link AIConfigProvider}.
+ *
+ * @since 2.13.0
+ */
+export interface AIConfigProviderProps {
+    /**
+     * Strings to replace, as a deep partial of `AIStrings`: pass only the keys you change. Nested
+     * providers merge over their parent. Hoist the object or wrap it in `useMemo`; a new object
+     * with the same content on every render re-renders every strings consumer (a development
+     * warning says so).
+     */
+    strings?: DeepPartial<AIStrings>;
+    /**
+     * Confidence thresholds on the 0-1 scale. Missing keys come from the parent provider, then
+     * `DEFAULT_AI_CONFIDENCE_THRESHOLDS`. Invalid thresholds (not `0 <= medium <= high <= 1`)
+     * are ignored with a development warning.
+     */
+    thresholds?: Partial<AIConfidenceThresholds>;
+    /**
+     * BCP 47 locale for numbers and counts, for example 'de-DE'. Inherited from the parent
+     * provider when omitted. Without any, `useAILocale()` returns `undefined` and formatters
+     * use 'en-US'. An invalid tag is ignored with a development warning.
+     */
+    locale?: string;
+    /**
+     * IANA time zone for dates, for example 'Europe/Berlin'. Inherited from the parent provider
+     * when omitted. Without any, `useAITimeZone()` returns the runtime's zone on the client and
+     * 'UTC' during server rendering. An invalid zone is ignored with a development warning.
+     */
+    timeZone?: string;
+    /**
+     * Receives every interaction the AI components report. Content-free unless `includeContent`
+     * is set. It may change identity on every render: components keep a stable reference. If it
+     * throws, the error is contained and logged once in development; components behave the same.
+     * The nearest provider with a handler receives the event; a provider without one passes
+     * events to its parent's.
+     */
+    onInteraction?: (event: AIInteractionEvent) => void;
+    /**
+     * Whether events sent to this provider's `onInteraction` keep fields with user or model text
+     * (feedback comments, typed clarification answers). Default `false`: those fields are removed.
+     */
+    includeContent?: boolean;
+    children?: ReactNode;
+}
+/**
+ * Configures the AI components below it: strings, confidence thresholds, locale, time zone and
+ * interaction telemetry. Optional and nestable; renders no element.
+ *
+ * @example
+ * ```tsx
+ * const strings = { common: { copied: 'Kopiert' } };
+ *
+ * <AIConfigProvider strings={strings} locale="de-DE" onInteraction={(event) => analytics.track(event.type, event)}>
+ *   <InsightEngine />
+ * </AIConfigProvider>
+ * ```
+ *
+ * @since 2.13.0
+ */
+export declare function AIConfigProvider({ strings, thresholds, locale, timeZone, onInteraction, includeContent, children, }: AIConfigProviderProps): ReactElement;
+//# sourceMappingURL=AIConfigProvider.d.ts.map

package/dist/components/AI/AIConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIConfigProvider.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIConfigProvider.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAY1F;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACpD;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAgDD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,OAAO,EACP,UAAU,EACV,MAAM,EACN,QAAQ,EACR,aAAa,EACb,cAAc,EACd,QAAQ,GACT,EAAE,qBAAqB,GAAG,YAAY,CAoEtC"}

package/dist/components/AI/AIContainer.d.ts

@@ -19,12 +19,26 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinityRootProps } from '../shared/rootProps';
 /**
- * Props for AIContainer component.
+ * AIContainer's own props.
  */
-export interface AIContainerProps {
+export interface AIContainerOwnProps {
     /** Container title */
     title?: string;
+    /**
+     * Heading level of the title: 2 to 6 for h2 to h6. Set it to fit the page outline.
+     * @default 6 (the h6 the title rendered before the prop existed)
+     * @since 2.13.0
+     */
+    headingLevel?: HeadingLevel;
+    /**
+     * Id of the title element, for `aria-labelledby` on a surrounding region or dialog. Without
+     * it, the component generates one.
+     * @since 2.13.0
+     */
+    titleId?: string;
     /** Container subtitle */
     subtitle?: string;
     /** Header actions */
@@ -39,17 +53,28 @@ export interface AIContainerProps {
     filled?: boolean;
     /** Whether container has padding */
     padded?: boolean;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the container's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIContainer: its own props, plus the HTML attributes of its root `div` (`id`,
+ * `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface AIContainerProps extends AIContainerOwnProps, TrinityRootProps<HTMLDivElement, AIContainerOwnProps> {
+}
 /**
  * AI Container - Wrapper for AI content with optional header.
  */
 export declare const AIContainer: React.ForwardRefExoticComponent<AIContainerProps & React.RefAttributes<HTMLDivElement>>;
 /**
- * Props for AIExpandableSection component.
+ * AIExpandableSection's own props.
  */
-export interface AIExpandableSectionProps {
+export interface AIExpandableSectionOwnProps {
     /** Section title */
     title: string;
     /** Section subtitle */
@@ -64,17 +89,38 @@ export interface AIExpandableSectionProps {
     expanded?: boolean;
     /** Change handler */
     onChange?: (expanded: boolean) => void;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the section's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIExpandableSection: its own props, plus the HTML attributes of its root `div`
+ * (`data-*`, `aria-*`), which reach the root (ADR-04, WI-40; Disclosure's root contract). As in
+ * Disclosure, `id` is the header button's id, and the panel's is `${id}-panel`.
+ */
+export interface AIExpandableSectionProps extends AIExpandableSectionOwnProps, TrinityRootProps<HTMLDivElement, AIExpandableSectionOwnProps> {
+}
 /**
  * AI Expandable Section - Collapsible content section.
+ *
+ * Renders through the internal Disclosure (D-27, D-08): the header is one `<button
+ * type="button">` named by the title (and subtitle), with `aria-expanded` and `aria-controls`
+ * pointing at the panel; Tab reaches it and Enter or Space toggles it. `expanded` and
+ * `defaultExpanded` follow the controlled and uncontrolled canon (useControlled); every toggle
+ * calls `onChange` with the requested state. The chevron (OD-D2) turns when open and the header
+ * shows the theme's focus ring. Colours come from the resolver's AI roles in both modes: the
+ * header on `ai.surfaceEmphasis` (`ai.surfaceEmphasisHover` under the pointer), the panel on
+ * `ai.surface` with an `ai.border` outline, the leading icon in `ai.primary`.
  */
 export declare const AIExpandableSection: React.ForwardRefExoticComponent<AIExpandableSectionProps & React.RefAttributes<HTMLDivElement>>;
 /**
- * Props for AIPersonaCard component.
+ * AIPersonaCard's own props.
  */
-export interface AIPersonaCardProps {
+export interface AIPersonaCardOwnProps {
     /** Persona name */
     name: string;
     /** Persona description */
@@ -83,15 +129,38 @@ export interface AIPersonaCardProps {
     avatar?: React.ReactNode;
     /** Persona capabilities */
     capabilities?: string[];
-    /** Whether persona is selected */
+    /**
+     * Whether the persona is selected. With `onClick`, the card is a toggle button and this is its
+     * `aria-pressed` state; the AI-primary border and the check icon show it visually.
+     */
     selected?: boolean;
-    /** Click handler */
+    /**
+     * Called when the card is pressed (click, Enter or Space). With it, the card is a toggle button
+     * named by `name`; without it, the card is static content.
+     */
     onClick?: () => void;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the card's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIPersonaCard: its own props, plus the HTML attributes of its root `div` (`id`,
+ * `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface AIPersonaCardProps extends AIPersonaCardOwnProps, TrinityRootProps<HTMLDivElement, AIPersonaCardOwnProps> {
+}
 /**
  * AI Persona Card - Card for selecting AI personas/agents.
+ *
+ * With `onClick`, the whole card is pressable through the primary-action pattern (WI-17, B-13):
+ * an empty button covers the card, named by the persona name and described by the description,
+ * with `aria-pressed={selected}`. The avatar, text, divider and chips stay static content above
+ * it, so the button holds no block content. Tab reaches it; Enter and Space toggle it. The ref
+ * and `sx` stay on the Paper root.
  */
 export declare const AIPersonaCard: React.ForwardRefExoticComponent<AIPersonaCardProps & React.RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AIContainer.d.ts.map

package/dist/components/AI/AIContainer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIContainer.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIContainer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EASL,OAAO,EACP,KAAK,EACN,MAAM,eAAe,CAAC;AAUvB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yBAAyB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,yFAwDtB,CAAC;AAMH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,iGA2E/B,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,2FAyGzB,CAAC"}
+{"version":3,"file":"AIContainer.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIContainer.tsx"],"names":[],"mappings":"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"}

package/dist/components/AI/AIExplainability.d.ts

@@ -12,18 +12,41 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinityRootProps } from '../shared/rootProps';
 /**
- * Props for AIExplainability component.
+ * AIExplainability's own props.
  */
-export interface AIExplainabilityProps {
-    /** Title/overview of the AI */
+export interface AIExplainabilityOwnProps {
+    /** Title/overview of the AI. Default: the `ai.explainability.title` string ('AI-generated content'). */
     title?: string;
+    /**
+     * Heading level of the title: 2 to 6 for h2 to h6. Set it to fit the page outline.
+     * @default 6 (the h6 the title rendered before the prop existed)
+     * @since 2.13.0
+     */
+    headingLevel?: HeadingLevel;
     /** Description of what the AI does */
     description?: string;
     /** Model name or version */
     modelName?: string;
-    /** Confidence score (0-100) */
+    /**
+     * Confidence score on the 0-100 scale (92 means 92%), unlike AIConfidenceBadge and the
+     * confidence utilities, which take 0-1. It is shown as a percent in the locale of the nearest
+     * `AIConfigProvider` ('en-US' without one): 92 reads '92%' in en-US and '92 %' in de-DE. Up to
+     * two decimals are kept (92.5 reads '92.5%').
+     */
     confidence?: number;
+    /**
+     * Shows the confidence level next to the percent: a level icon (the `confidence-high`,
+     * `-medium` and `-low` signal bars, a different shape per level) and the level word
+     * (`ai.explainability.confidenceHigh`, `confidenceMedium` and `confidenceLow`). The level
+     * follows the nearest `AIConfigProvider`'s thresholds and is rated on the shown, rounded
+     * value. Off by default: the percent alone, as before (WI-25).
+     * @default false
+     * @since 2.13.0
+     */
+    showConfidenceLevel?: boolean;
     /** Last updated date */
     lastUpdated?: string;
     /** Additional details */
@@ -36,9 +59,20 @@ export interface AIExplainabilityProps {
         label: string;
         onClick: () => void;
     }>;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names.
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the root's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AIExplainability: its own props, plus the HTML attributes of its root `div` (`id`,
+ * `data-*`, `aria-*`), which reach the root (ADR-04, WI-40).
+ */
+export interface AIExplainabilityProps extends AIExplainabilityOwnProps, TrinityRootProps<HTMLDivElement, AIExplainabilityOwnProps> {
+}
 /**
  * AI Explainability Content - Provides details about AI-generated content.
  */

package/dist/components/AI/AIExplainability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIExplainability.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIExplainability.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA2C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQxF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;IACxD,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,8FA+E5B,CAAC"}
+{"version":3,"file":"AIExplainability.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIExplainability.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAA2C,OAAO,EAAE,KAAK,EAAY,MAAM,eAAe,CAAC;AASlG,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,wGAAwG;IACxG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC;IACxD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB,EAAE,gBAAgB,CAAC,cAAc,EAAE,wBAAwB,CAAC;CAAG;AAMtI;;GAEG;AACH,eAAO,MAAM,gBAAgB,8FAgH5B,CAAC"}

package/dist/components/AI/AIFeedbackControl.d.ts

@@ -0,0 +1,113 @@
+/**
+ * @fileoverview AIFeedbackControl: thumbs up and down on an AI answer, and a separate "Tell us what
+ * went wrong" flow (master-plan F-17, ADR-15-R3, ADR-15-R4).
+ * @module components/AI/AIFeedbackControl
+ *
+ * - **Group.** The root is `role="group"` (owned), named 'Rate this response'.
+ * - **Thumbs.** Two MUI IconButtons, pure toggles: `aria-pressed`, and a constant name that is
+ *   also the tooltip (one key each: 'Good response', 'Poor response'). The tooltip does not
+ *   describe the button, since it repeats the name (OD-F13 A). Pressed has three cues:
+ *   `aria-pressed`, the filled glyph and the theme's C-27 pressed recipe (selected overlay and an
+ *   inset ring, Highlight in forced colours). The glyph is `status.success.text` or
+ *   `status.error.text` when pressed and `text.secondary` at rest (WCAG 1.4.11); its colour change
+ *   uses `semanticTokens.motion` and is instant under reduced motion. Each is at least 24px
+ *   (WCAG 2.5.8). Pressing a pressed thumb clears the rating; the rating is the one-click flag.
+ * - **Detailed mode (OD-F18, ADR-15-R4).** While the rating is negative and nothing was sent yet,
+ *   a text button 'Tell us what went wrong' follows the thumbs in the group. It is the only popup
+ *   trigger (`aria-haspopup="dialog"`, `aria-expanded`, `aria-controls`); thumbs-down never moves
+ *   focus or opens anything. It opens AIFeedbackForm in DetailsPopover, or in C's Modal below the
+ *   theme's `sm` breakpoint (OD-F4, ADR-15-R3; the first render, server and hydration, is the
+ *   popover). The surface's heading is its only heading: the form is hosted (no title, no
+ *   telemetry). The Modal has no description (`describedBy="none"`) and no footer.
+ * - **Sending.** The control runs `onSubmit` through `useAsyncAction` and passes `loading` and
+ *   `error` to the form. While pending, no close path works (DetailsPopover `preventClose`, Modal
+ *   `pendingClosePolicy="block"` with `loading`). Cancel closes, keeps the rating and MUI returns
+ *   focus to the details trigger. A failure keeps the surface open with the form's error.
+ * - **Sent.** The surface closes. After its exit transition (focus restored, the page no longer
+ *   hidden), focus moves to thumbs-down and 'Feedback sent' is announced once through the
+ *   control's own announcer, outside the closed overlay. The details trigger is replaced by the
+ *   visible, non-live text 'Feedback sent'.
+ * - **Disabled** sets `aria-disabled` on every button, described by `disabledReason`; clicks do
+ *   nothing.
+ * - **Telemetry.** `AIFeedbackInteraction` for rate, clear, detail-open, detail-submit and
+ *   detail-cancel, from the control only.
+ *
+ * @example
+ * ```tsx
+ * import { AIFeedbackControl } from '@trinityui/design-system';
+ *
+ * <AIFeedbackControl responseId="r-1" mode="detailed" onChange={saveRating} onSubmit={sendFeedback} />
+ * ```
+ */
+import * as React from 'react';
+import { type SxProps, type Theme } from '@mui/material/styles';
+import { type TrinitySlotProps } from '../shared/rootProps';
+import type { AIFeedbackCategory, AIFeedbackCategoryOption, AIFeedbackEvent, AIFeedbackRating } from './types/hitl';
+/**
+ * AIFeedbackControl's own props.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackControlOwnProps {
+    /** Controlled rating; `null` is no rating. */
+    value?: AIFeedbackRating | null;
+    /** Initial rating when uncontrolled. @default null */
+    defaultValue?: AIFeedbackRating | null;
+    /** Called with the next rating (`null` when a pressed thumb is pressed again) and the click. */
+    onChange?: (rating: AIFeedbackRating | null, event: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * `'simple'`: the thumbs only. `'detailed'`: after a thumbs-down, 'Tell us what went wrong'
+     * opens AIFeedbackForm.
+     * @default 'simple'
+     */
+    mode?: 'simple' | 'detailed';
+    /** The form's categories (detailed mode). @default every built-in category */
+    categories?: ReadonlyArray<AIFeedbackCategory | AIFeedbackCategoryOption>;
+    /** The form's rerun option (detailed mode). @default false */
+    allowRerun?: boolean;
+    /** At least one category must be chosen (detailed mode). @default false */
+    requireCategory?: boolean;
+    /** Sends the detailed feedback. May return a promise; the surface stays open until it settles. */
+    onSubmit?: (event: AIFeedbackEvent) => void | Promise<void>;
+    /** Detailed feedback was already sent: shows 'Feedback sent' instead of the details trigger. */
+    submitted?: boolean;
+    /** Id of the rated response, sent with the feedback and the interactions. */
+    responseId?: string;
+    /** Every button is `aria-disabled` (for example while the response streams). */
+    disabled?: boolean;
+    /** Why it is disabled, linked to each button. @default 'You can rate the response once it is complete.' */
+    disabledReason?: string;
+    /** @default 'small' */
+    size?: 'small' | 'medium';
+    className?: string;
+    sx?: SxProps<Theme>;
+    /**
+     * Props for the parts (ADR-04 (6)): `positiveButton`, `negativeButton`, `detailsTrigger`,
+     * `popover` (the details dialog), `dialog` (the narrow-viewport Modal's surface), `form` and
+     * `status` (the 'Feedback sent' text).
+     */
+    slotProps?: {
+        positiveButton?: TrinitySlotProps<HTMLButtonElement>;
+        negativeButton?: TrinitySlotProps<HTMLButtonElement>;
+        detailsTrigger?: TrinitySlotProps<HTMLButtonElement>;
+        popover?: TrinitySlotProps<HTMLDivElement>;
+        dialog?: TrinitySlotProps<HTMLDivElement>;
+        form?: TrinitySlotProps<HTMLFormElement>;
+        status?: TrinitySlotProps<HTMLSpanElement>;
+    };
+}
+/**
+ * Props of {@link AIFeedbackControl}: its own props plus the root `<div>`'s HTML attributes
+ * (ADR-04).
+ *
+ * @since 2.13.0
+ */
+export type AIFeedbackControlProps = AIFeedbackControlOwnProps & Omit<React.HTMLAttributes<HTMLDivElement>, 'color' | 'onChange' | 'onSubmit' | 'defaultValue' | keyof AIFeedbackControlOwnProps>;
+/**
+ * Thumbs up and down on an AI answer, with an optional "Tell us what went wrong" flow. See the
+ * module notes.
+ *
+ * @since 2.13.0
+ */
+export declare const AIFeedbackControl: React.ForwardRefExoticComponent<AIFeedbackControlOwnProps & Omit<React.HTMLAttributes<HTMLDivElement>, "color" | keyof AIFeedbackControlOwnProps> & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AIFeedbackControl.d.ts.map

package/dist/components/AI/AIFeedbackControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIFeedbackControl.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIFeedbackControl.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAa1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAK1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIpH;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,sDAAsD;IACtD,YAAY,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACjG;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC7B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,aAAa,CAAC,kBAAkB,GAAG,wBAAwB,CAAC,CAAC;IAC1E,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,gGAAgG;IAChG,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2GAA2G;IAC3G,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QACrD,cAAc,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QACrD,cAAc,CAAC,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;KAC5C,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,GAC5D,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,yBAAyB,CAAC,CAAC;AAYnI;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,0LAoR5B,CAAC"}

package/dist/components/AI/AIFeedbackForm.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview AIFeedbackForm: what went wrong with an AI answer, in a few choices and a comment
+ * (master-plan F-16).
+ * @module components/AI/AIFeedbackForm
+ *
+ * - **Root.** A native `<form noValidate>`, unnamed by default, so it is not a form landmark
+ *   (ADR-19 keeps the landmark list clean). Pass `aria-labelledby` to make it one. The title is
+ *   text, not a heading, unless `headingLevel` is set (ADR-19). Do not nest it inside another
+ *   DOM `<form>`.
+ * - **Fields.** D's ChoiceChips in multiple mode in a fieldset with the legend 'Problem type'
+ *   (the built-in categories from `ai.feedbackForm.category.*`, or yours); a multiline TextField
+ *   'Details (optional)'; with `allowRerun`, a Checkbox 'Rerun with this correction'; then
+ *   'Send feedback' and 'Cancel'.
+ * - **Validation (OD-F14 A).** Nothing is required by default. `requireCategory` opts into the
+ *   ADR-07 pattern: Submit stays enabled; an empty submit marks the checkboxes `aria-invalid`,
+ *   links the error text to the group and focuses the first checkbox.
+ * - **Submit.** The handler calls `preventDefault` and `stopPropagation`, so a React ancestor
+ *   form reached through a portal never receives the event. `onSubmit` runs through
+ *   `useAsyncAction` (one run at a time; a throw or rejection is reported). `loading`, `error`
+ *   and `errorMessage` override the hook, so a host can own the pending state (ADR-07).
+ * - **Pending.** Submit and Cancel are `aria-disabled` (Submit also `aria-busy`) and keep focus;
+ *   clicks do nothing.
+ * - **Error.** AsyncOutcomeAlert inside the form (no implicit live role, OD-F9): announced once,
+ *   assertively, with 'Try again'. The input is kept and focus stays on Submit.
+ * - **Success.** The summary 'Thanks — sent for review' replaces the fields and takes focus
+ *   (useFocusOnReplace), unless `submitted` says otherwise or the form is hosted.
+ * - **Hosted** (inside AIFeedbackControl, through the internal HostedFeedbackContext): no title,
+ *   no telemetry, no summary and no focus move; the host owns all three.
+ * - **Telemetry.** Standalone, one `AIFeedbackInteraction { action: 'detail-submit' }` per submit,
+ *   content-free (the comment only with the provider's `includeContent`).
+ * - **Layout.** An inner container query stacks the actions full width below the 'compact'
+ *   container width (E-19).
+ *
+ * @example
+ * ```tsx
+ * import { AIFeedbackForm } from '@trinityui/design-system';
+ *
+ * <AIFeedbackForm responseId="r-1" allowRerun onSubmit={(feedback) => api.sendFeedback(feedback)} />
+ * ```
+ */
+import * as React from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+import { type HeadingLevel } from '../shared/headingLevel';
+import { type TrinitySlotProps } from '../shared/rootProps';
+import type { AIFeedbackCategory, AIFeedbackCategoryOption, AIFeedbackDraft, AIFeedbackEvent, AIFeedbackRating } from './types/hitl';
+/**
+ * AIFeedbackForm's own props.
+ *
+ * @since 2.13.0
+ */
+export interface AIFeedbackFormOwnProps {
+    /** The rating the feedback is about. @default 'negative' */
+    rating?: AIFeedbackRating;
+    /**
+     * The categories offered: built-in ids (their text comes from the strings) or options with
+     * your own `label` and `description`. An empty list hides the field.
+     * @default every built-in category
+     */
+    categories?: ReadonlyArray<AIFeedbackCategory | AIFeedbackCategoryOption>;
+    /** Controlled draft. */
+    value?: AIFeedbackDraft;
+    /** Initial draft when uncontrolled. @default { categories: [], comment: '', rerun: false } */
+    defaultValue?: AIFeedbackDraft;
+    /** Called with the next draft and the event that changed it. */
+    onChange?: (draft: AIFeedbackDraft, event?: React.SyntheticEvent) => void;
+    /** Shows 'Rerun with this correction'. @default false */
+    allowRerun?: boolean;
+    /** At least one category must be chosen (OD-F14 A: opt-in). @default false */
+    requireCategory?: boolean;
+    /** Id of the rated response, sent with the feedback. */
+    responseId?: string;
+    /** Sends the feedback. May return a promise: the form shows the pending, error and success states. */
+    onSubmit?: (event: AIFeedbackEvent) => void | Promise<void>;
+    /** Shows 'Cancel' and is called when it is pressed (not while pending). */
+    onCancel?: () => void;
+    /** Pending, from the host (overrides the form's own async state). */
+    loading?: boolean;
+    /** Failed, from the host (overrides the form's own async state). */
+    error?: boolean;
+    /** The error text. @default "Couldn't send feedback." */
+    errorMessage?: string;
+    /** Sent, from the host: shows the success summary (overrides the form's own async state). */
+    submitted?: boolean;
+    /** The title. Not shown when hosted. @default 'Tell us what went wrong' */
+    title?: string;
+    /** Renders the title as a heading of this level. No heading by default (ADR-19). */
+    headingLevel?: HeadingLevel;
+    className?: string;
+    sx?: SxProps<Theme>;
+    /**
+     * Props for the parts (ADR-04 (6)): `title`, `categories` (the fieldset), `comment` (the text
+     * field root), `rerun` (its label), `actions`, `alert` and `summary`.
+     */
+    slotProps?: {
+        title?: TrinitySlotProps<HTMLElement>;
+        categories?: TrinitySlotProps<HTMLFieldSetElement>;
+        comment?: TrinitySlotProps<HTMLDivElement>;
+        rerun?: TrinitySlotProps<HTMLLabelElement>;
+        actions?: TrinitySlotProps<HTMLDivElement>;
+        alert?: TrinitySlotProps<HTMLDivElement>;
+        summary?: TrinitySlotProps<HTMLDivElement>;
+    };
+}
+/**
+ * Props of {@link AIFeedbackForm}: its own props plus the `<form>`'s HTML attributes (ADR-04).
+ *
+ * @since 2.13.0
+ */
+export type AIFeedbackFormProps = AIFeedbackFormOwnProps & Omit<React.FormHTMLAttributes<HTMLFormElement>, 'color' | 'onChange' | 'onSubmit' | 'defaultValue' | 'title' | keyof AIFeedbackFormOwnProps>;
+/**
+ * Detailed feedback on an AI answer: problem types, a comment and an optional rerun. See the
+ * module notes.
+ *
+ * @since 2.13.0
+ */
+export declare const AIFeedbackForm: React.ForwardRefExoticComponent<AIFeedbackFormOwnProps & Omit<React.FormHTMLAttributes<HTMLFormElement>, "color" | keyof AIFeedbackFormOwnProps> & React.RefAttributes<HTMLFormElement>>;
+//# sourceMappingURL=AIFeedbackForm.d.ts.map

package/dist/components/AI/AIFeedbackForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIFeedbackForm.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIFeedbackForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAQ/B,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAQ3D,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAa,MAAM,cAAc,CAAC;AA8BhJ;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,kBAAkB,GAAG,wBAAwB,CAAC,CAAC;IAC1E,wBAAwB;IACxB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,cAAc,KAAK,IAAI,CAAC;IAC1E,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE;QACV,KAAK,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACtC,UAAU,CAAC,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAC;QACnD,OAAO,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC3C,KAAK,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;QAC3C,KAAK,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACzC,OAAO,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC;KAC5C,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,GACtD,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,sBAAsB,CAAC,CAAC;AAkB/I;;;;;GAKG;AACH,eAAO,MAAM,cAAc,0LAqOzB,CAAC"}

package/dist/components/AI/AIFeedbackHostContext.d.ts

@@ -0,0 +1,16 @@
+import type { Context } from 'react';
+/**
+ * Whether the nearest AIFeedbackForm is hosted. `true` only under a host's provider.
+ *
+ * @internal
+ * @since 2.13.0
+ */
+export declare const HostedFeedbackContext: Context<boolean>;
+/**
+ * Whether the calling form is hosted (see the module notes); `false` without a provider.
+ *
+ * @internal
+ * @since 2.13.0
+ */
+export declare function useHostedFeedback(): boolean;
+//# sourceMappingURL=AIFeedbackHostContext.d.ts.map

package/dist/components/AI/AIFeedbackHostContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIFeedbackHostContext.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AIFeedbackHostContext.tsx"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,OAAO,CAAiD,CAAC;AAErG;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/components/AI/AILabel.d.ts

@@ -12,32 +12,65 @@
  */
 import React from 'react';
 import { SxProps, Theme } from '@mui/material';
+import { type TrinityRootProps } from '../shared/rootProps';
 export type AILabelSize = 'mini' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 export type AILabelVariant = 'default' | 'inline';
 /**
- * Props for AILabel component.
+ * AILabel's own props.
  */
-export interface AILabelProps {
+export interface AILabelOwnProps {
     /** Size of the AI label */
     size?: AILabelSize;
     /** Variant of the AI label */
     variant?: AILabelVariant;
-    /** Custom text (default: "AI") */
+    /** Custom text. Default: the `ai.label.text` string ('AI'). */
     text?: string;
     /** Whether to show explainability popover on click */
     showPopover?: boolean;
     /** Content for the explainability popover */
     popoverContent?: React.ReactNode;
-    /** Whether the label is clickable */
+    /**
+     * Accessible name of the explainability popover, which is a dialog. Ignored
+     * when `popoverLabelledBy` is set.
+     * Default: the `ai.label.popoverLabel` string ('About this AI content').
+     * @since 2.13.0
+     */
+    popoverLabel?: string;
+    /**
+     * Id of an element inside `popoverContent` that names the popover, such as
+     * its title. Takes precedence over `popoverLabel`.
+     * @since 2.13.0
+     */
+    popoverLabelledBy?: string;
+    /**
+     * Whether the label is clickable. The label renders as a button only when
+     * clicking it does something: `onClick` is set, or `showPopover` is on and
+     * `popoverContent` is given. Otherwise it renders as static text (a `span`)
+     * with the same look and no tab stop.
+     */
     clickable?: boolean;
     /** Click handler */
     onClick?: () => void;
-    /** Custom sx props */
+    /**
+     * Added to the root's own class names (the button, or the static span).
+     * @since 2.13.0
+     */
+    className?: string;
+    /** Custom sx props, applied after the label's own styles (object, array or function). */
     sx?: SxProps<Theme>;
 }
+/**
+ * Props for AILabel: its own props, plus the HTML attributes of its root (`id`, `data-*`,
+ * `aria-*`), which reach the root in both forms: the button, or the static span (ADR-04, WI-40).
+ */
+export interface AILabelProps extends AILabelOwnProps, TrinityRootProps<HTMLElement, AILabelOwnProps> {
+}
 /**
  * AI Label - Indicates AI-generated content and provides pathway to explainability.
  * Use to mark any instance of AI in the interface.
+ *
+ * The ref points at the root element: a `button` when the label is
+ * interactive, a `span` otherwise.
  */
-export declare const AILabel: React.ForwardRefExoticComponent<AILabelProps & React.RefAttributes<HTMLButtonElement>>;
+export declare const AILabel: React.ForwardRefExoticComponent<AILabelProps & React.RefAttributes<HTMLElement>>;
 //# sourceMappingURL=AILabel.d.ts.map

package/dist/components/AI/AILabel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AILabel.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AILabel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,EAAwB,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AA8BD;;;GAGG;AACH,eAAO,MAAM,OAAO,wFAoHlB,CAAC"}
+{"version":3,"file":"AILabel.d.ts","sourceRoot":"","sources":["../../../src/components/AI/AILabel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAe,OAAO,EAAE,KAAK,EAAmB,MAAM,eAAe,CAAC;AAW7E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM1E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,eAAe,EAAE,gBAAgB,CAAC,WAAW,EAAE,eAAe,CAAC;CAAG;AAgHxG;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,kFAyJlB,CAAC"}