@trinityui/design-system 2.11.1 → 2.13.0

package/dist/patterns/AICopilotPattern/AICopilotPattern.d.ts

@@ -0,0 +1,203 @@
+/**
+ * @fileoverview AICopilotPattern: the human-in-the-loop reference composition (H-29, ADR-12).
+ * @module patterns/AICopilotPattern
+ *
+ * IMPLEMENTATION_PLAN 2.4's AI Copilot pattern: InsightEngine (the drawer or the `embedded`
+ * presentation) with ChatThread's default interactive blocks (query, clarification, plan review),
+ * the answer's confidence, verification and sources from ChatThread's message slots, and
+ * AIChainOfThought reasoning in each answer's attachments. The same component works as a drawer
+ * and inside AppLayout's `renderAiPanel`.
+ *
+ * A thin composition (ADR-12 (3), docs/PATTERNS.md): it owns layout and wiring only. It holds no
+ * business state (the composer's text follows the controlled canon through `useControlled`), and
+ * adds no live region, landmark or focus code: the organisms inside own them, and the one log is
+ * ChatThread's.
+ *
+ * @example
+ * ```tsx
+ * import { useState } from 'react';
+ * import { AICopilotPattern, type ChatThreadMessage } from '@trinityui/design-system';
+ *
+ * export function Copilot({ ask }: { ask: (question: string) => Promise<ChatThreadMessage> }) {
+ *   const [messages, setMessages] = useState<ChatThreadMessage[]>([]);
+ *   return (
+ *     <AICopilotPattern
+ *       presentation="embedded"
+ *       messages={messages}
+ *       suggestedPrompts={['Show Q4 revenue by region']}
+ *       onSendMessage={async (question) => {
+ *         setMessages((prev) => [...prev, { id: String(prev.length + 1), role: 'user', content: question }]);
+ *         const answer = await ask(question);
+ *         setMessages((prev) => [...prev, answer]);
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+import * as React from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+import type { AIChainOfThoughtProps } from '../../components/AI/AIChainOfThought.types';
+import type { AIChatWelcomeSuggestion } from '../../components/AI/AIChatWelcome';
+import type { ChatViewMode } from '../../components/AI/ChatHeader';
+import type { ChatHistoryItem } from '../../components/AI/ChatHistoryList';
+import type { ChatThreadMessage, ChatThreadMessageActions } from '../../components/AI/ChatThread';
+import type { AIRelatedQuestion } from '../../components/AI/AIRelatedQuestions';
+import type { AIBlockEvent } from '../../components/AI/types/hitl';
+import { type TrinityRootProps, type TrinitySlotProps } from '../../components/shared/rootProps';
+/**
+ * Trinity-owned slots of AICopilotPattern (ADR-04 (6)). Each takes `className`, `sx`, `id`,
+ * `data-*` and the element's HTML attributes; owned attributes (`role`, `aria-live`, ...) are
+ * ignored.
+ *
+ * @since 2.13.0
+ */
+export interface AICopilotPatternSlotProps {
+    /** The pattern's root `div` (it adds no role). Applied before the root `sx` and `className`. */
+    root?: TrinitySlotProps<HTMLDivElement>;
+    /**
+     * InsightEngine's root (its `slotProps.root`): the drawer's root, or the embedded region.
+     */
+    engine?: TrinitySlotProps<HTMLDivElement>;
+    /** The message thread's root, ChatThread's log (InsightEngine `slotProps.thread`). */
+    thread?: TrinitySlotProps<HTMLDivElement>;
+    /** The composer's container at the bottom of the panel (InsightEngine `slotProps.composer`). */
+    composer?: TrinitySlotProps<HTMLDivElement>;
+}
+/**
+ * AICopilotPattern's own props, without the root element's HTML attributes.
+ *
+ * Business data stays the app's: `messages` come in, and the user's actions go out through the
+ * organisms' callbacks (`onSendMessage`, `onBlockEvent`, `messageActions`). The pattern keeps
+ * only UI state: the composer's text when `inputValue` is not passed.
+ *
+ * @since 2.13.0
+ */
+export interface AICopilotPatternOwnProps {
+    /**
+     * Where the copilot renders. `'drawer'`: InsightEngine's right-anchored drawer (persistent on
+     * desktop, a full-width modal drawer on phones). `'embedded'`: it fills its parent, for a host
+     * panel such as AppLayout's `renderAiPanel`, a page column or a dialog.
+     * @default 'drawer'
+     */
+    presentation?: 'drawer' | 'embedded';
+    /** Whether the copilot is open. A closed embedded copilot stays mounted and hidden. @default true */
+    open?: boolean;
+    /**
+     * Called when the copilot asks to close: the header's Close button, or Escape and the
+     * backdrop of the phone drawer. Required for the `'drawer'` presentation (InsightEngine warns in
+     * development without it). Optional when `'embedded'`: without it the header has no Close
+     * button (in AppLayout's AI panel, pass `renderAiPanel`'s `onClose`).
+     */
+    onClose?: (reason?: 'closeButton' | 'escapeKeyDown' | 'backdropClick') => void;
+    /** The copilot's title, its h2. Default: InsightEngine's (`ai.insightEngine.title`). */
+    title?: string;
+    /**
+     * The view mode, controlled (InsightEngine `viewMode`). In AppLayout's AI panel, pass
+     * `isFullscreen ? 'expanded' : 'sidepanel'` with `onViewModeChange={onFullscreenToggle}` so the
+     * header's expand toggle is the panel's fullscreen toggle.
+     */
+    viewMode?: ChatViewMode;
+    /** The initial view mode when `viewMode` is not passed. @default 'sidepanel' */
+    defaultViewMode?: ChatViewMode;
+    /** Called with the next view mode when the header's expand toggle is pressed. */
+    onViewModeChange?: (mode: ChatViewMode) => void;
+    /** The conversation. Assistant answers carry `response` (blocks, sources, metadata). */
+    messages: ChatThreadMessage[];
+    /** The composer's text, controlled. Without it the pattern keeps the text and clears it after a send. */
+    inputValue?: string;
+    /** The composer's initial text when `inputValue` is not passed. @default '' */
+    defaultInputValue?: string;
+    /** Called with the composer's text on every change, controlled or not. */
+    onInputChange?: (value: string) => void;
+    /**
+     * Called with the trimmed text when the user sends a message (the composer, a suggested
+     * prompt). Return the promise of your request: while it runs Send stays pending, and a
+     * rejection shows the engine's "message wasn't sent" alert with Try again and reaches
+     * `onError` (InsightEngine's async path, H-16).
+     */
+    onSendMessage: (value: string) => void | Promise<void>;
+    /**
+     * The async error sink, always with an `Error`: a failed send, message action, block event or
+     * reasoning retry. The failure also shows inline where it happened.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called with the message and what the user did in an interactive block of its answer or of
+     * its reasoning (answered a clarification, confirmed or cancelled a plan). Return the promise
+     * of your request: it drives the block's pending state. While the latest answer asks a
+     * required clarification, the composer waits for the answer.
+     */
+    onBlockEvent?: (message: ChatThreadMessage, event: AIBlockEvent) => void | Promise<void>;
+    /**
+     * The actions of each assistant message, forwarded unchanged (Copy, thumbs, `onFeedbackSubmit`,
+     * Regenerate through `onRegenerate`, Share, Download). App actions go in `getActions`: the
+     * golden-dataset handoff is one, shown only to the users your app allows (R23).
+     */
+    messageActions?: ChatThreadMessageActions;
+    /**
+     * The reasoning of an assistant message: return AIChainOfThought's props (its phases: the
+     * thinking, a plan awaiting confirmation, a failed task with Retry) to show the chain in the
+     * message's attachments, ahead of its sources and related questions, or nothing for none. The
+     * chain's content is markdown unless you pass `contentFormat` (ADR-09 (4)). Same shape as
+     * InsightEnginePanel's `getReasoning`.
+     */
+    getReasoning?: (message: ChatThreadMessage) => AIChainOfThoughtProps | null | undefined;
+    /**
+     * Starters on the empty copilot (AIChatWelcome's suggestions). A string is its own title and
+     * prompt; pass AIChatWelcomeSuggestion objects for a title, a description and an icon. Choosing
+     * one sends it through `onSendMessage`.
+     */
+    suggestedPrompts?: Array<string | AIChatWelcomeSuggestion>;
+    /** Called with the prompt of a chosen starter, before it is sent. */
+    onSuggestedPromptSelect?: (prompt: string) => void;
+    /**
+     * Called with a picked related question (a string arrives as `{ text }`) and its index. The
+     * pattern also puts the question in the composer, for the user to send or edit.
+     */
+    onRelatedQuestionSelect?: (question: AIRelatedQuestion, index: number) => void;
+    /** Past conversations, in the header's history (InsightEngine `chats`). */
+    chats?: ChatHistoryItem[];
+    /** The open conversation's id. */
+    activeChatId?: string;
+    /** Called with the id of a conversation picked in the history. */
+    onSelectChat?: (id: string) => void;
+    /**
+     * The empty copilot. Return a node to replace the start screen (the greeting and
+     * `suggestedPrompts`), `null` for ChatThread's plain 'Start a conversation' state, or
+     * `undefined` for the start screen.
+     */
+    renderEmptyState?: () => React.ReactNode;
+    /**
+     * Your controls in the header, before the expand toggle and Close: for example 'New chat', or
+     * AppLayout's fullscreen toggle. They render in a group named 'Conversation actions'
+     * (`ai.copilotPattern.headerActions`); give each its own accessible name and a matching tooltip.
+     * `null` or `undefined` renders no group.
+     */
+    renderHeaderActions?: () => React.ReactNode;
+    /** Props for the Trinity-owned slots: `root`, `engine`, `thread` and `composer`. */
+    slotProps?: AICopilotPatternSlotProps;
+    /** Added to the root's class names. */
+    className?: string;
+    /** Styles for the root, after its own (object, array and function forms). */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Props for AICopilotPattern. Besides its own props, the root takes the HTML attributes of a
+ * `div` (`id`, `data-*`, `aria-*`, event handlers), spread before its own (ADR-04). The root has
+ * no role; owned attributes (`role`, `aria-live`, ...) are ignored, with a development warning.
+ *
+ * @since 2.13.0
+ */
+export interface AICopilotPatternProps extends AICopilotPatternOwnProps, TrinityRootProps<HTMLDivElement, AICopilotPatternOwnProps> {
+}
+/**
+ * AICopilotPattern: InsightEngine wired for the human-in-the-loop flow (plan review, a
+ * transparent answer with confidence, verification, sources and reasoning, feedback and app
+ * actions). A drawer or embedded in a host panel.
+ *
+ * @since 2.13.0
+ */
+export declare const AICopilotPattern: React.ForwardRefExoticComponent<AICopilotPatternProps & React.RefAttributes<HTMLDivElement>>;
+export default AICopilotPattern;
+//# sourceMappingURL=AICopilotPattern.d.ts.map

package/dist/patterns/AICopilotPattern/AICopilotPattern.d.ts.map

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

package/dist/patterns/AICopilotPattern/index.d.ts

@@ -0,0 +1,3 @@
+export { AICopilotPattern } from './AICopilotPattern';
+export type { AICopilotPatternProps, AICopilotPatternOwnProps, AICopilotPatternSlotProps } from './AICopilotPattern';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/AICopilotPattern/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/AICopilotPattern/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/patterns/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview The pattern layer's barrel (ADR-12, IMPLEMENTATION_PLAN Phase 2).
+ * @module patterns
+ *
+ * A pattern is a thin reference composition of public organisms: it owns layout and wiring and
+ * UI state only, and adds no visual primitive, live region, landmark or focus code of its own
+ * (the contract is in docs/PATTERNS.md). Each pattern lives in `src/patterns/<Name>Pattern/` with
+ * an `index.ts`, and is re-exported here.
+ *
+ * The root entry (`src/index.ts`, PATTERNS block) re-exports this barrel (H-27). Root-only export:
+ * no subpath (the waiver is in docs/PATTERNS.md); chunk placement is H-46's (no manualChunks rule).
+ */
+export { AICopilotPattern } from './AICopilotPattern';
+export type { AICopilotPatternProps, AICopilotPatternOwnProps, AICopilotPatternSlotProps } from './AICopilotPattern';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/presets/analytics.d.ts

@@ -7,7 +7,7 @@
  * - Enhanced chart styling
  * - Focus on data readability
  */
-import { TrinityThemePreset } from '../theme';
+import { TrinityThemePreset, type TrinityThemePresetOptions } from '../theme';
 /**
  * Extended color palette for charts and data visualization
  * Designed for accessibility and clear differentiation
@@ -104,6 +104,13 @@ export declare const analyticsLightPreset: TrinityThemePreset;
  * Analytics Dark Theme Preset
  */
 export declare const analyticsDarkPreset: TrinityThemePreset;
+/**
+ * The options the Analytics preset themes are built from, one object per mode. Spread one into
+ * createTrinityThemePreset to build a variant, for example `{ ...analyticsPresetOptions.light, direction: 'rtl' }`.
+ * src/testing/themeMatrix.ts builds every preset this way. Not exported from the package:
+ * whether it becomes public API is decision OD-E6 (ADR-37).
+ */
+export declare const analyticsPresetOptions: Readonly<Record<'light' | 'dark', TrinityThemePresetOptions>>;
 /** Analytics preset with both light and dark themes */
 export declare const analyticsPreset: {
     light: TrinityThemePreset;

package/dist/presets/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/presets/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMxE;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB,0CAA0C;;IAc1C,+CAA+C;;;;;;IAO/C,6CAA6C;;;;;IAM7C,gCAAgC;;;;;;;IAQhC,mBAAmB;;;;;;CAMpB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,wCAAwC;;IAGxC,+CAA+C;;IAG/C,+BAA+B;;IAG/B,4CAA4C;;IAG5C,4BAA4B;;IAG5B,2BAA2B;;IAG3B,mCAAmC;;IAGnC,gEAAgE;;IAGhE,uCAAuC;;QA3EvC,0CAA0C;;QAc1C,+CAA+C;;;;;;QAO/C,6CAA6C;;;;;QAM7C,gCAAgC;;;;;;;QAQhC,mBAAmB;;;;;;;IA2CnB,yBAAyB;;IAGzB,wBAAwB;;IAGxB,4BAA4B;;CAE7B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBA6IjC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBA2FhC,CAAC;AAMH,uDAAuD;AACvD,eAAO,MAAM,eAAe;;;;QApS1B,wCAAwC;;QAGxC,+CAA+C;;QAG/C,+BAA+B;;QAG/B,4CAA4C;;QAG5C,4BAA4B;;QAG5B,2BAA2B;;QAG3B,mCAAmC;;QAGnC,gEAAgE;;QAGhE,uCAAuC;;YA3EvC,0CAA0C;;YAc1C,+CAA+C;;;;;;YAO/C,6CAA6C;;;;;YAM7C,gCAAgC;;;;;;;YAQhC,mBAAmB;;;;;;;QA2CnB,yBAAyB;;QAGzB,wBAAwB;;QAGxB,4BAA4B;;;;QApF5B,0CAA0C;;QAc1C,+CAA+C;;;;;;QAO/C,6CAA6C;;;;;QAM7C,gCAAgC;;;;;;;QAQhC,mBAAmB;;;;;;;CAyTpB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,+BAA6B,CAAC;AAE9D,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,+BAA4B,CAAC"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/presets/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAMxG;;;GAGG;AACH,eAAO,MAAM,aAAa;IACxB,0CAA0C;;IAc1C,+CAA+C;;;;;;IAO/C,6CAA6C;;;;;IAM7C,gCAAgC;;;;;;;IAQhC,mBAAmB;;;;;;CAMpB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,wCAAwC;;IAGxC,+CAA+C;;IAG/C,+BAA+B;;IAG/B,4CAA4C;;IAG5C,4BAA4B;;IAG5B,2BAA2B;;IAG3B,mCAAmC;;IAGnC,gEAAgE;;IAGhE,uCAAuC;;QA3EvC,0CAA0C;;QAc1C,+CAA+C;;;;;;QAO/C,6CAA6C;;;;;QAM7C,gCAAgC;;;;;;;QAQhC,mBAAmB;;;;;;;IA2CnB,yBAAyB;;IAGzB,wBAAwB;;IAGxB,4BAA4B;;CAE7B,CAAC;AAsJF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAoE,CAAC;AAoGxG;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBAAmE,CAAC;AAMtG;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,yBAAyB,CAAC,CAGhG,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,eAAe;;;;QArT1B,wCAAwC;;QAGxC,+CAA+C;;QAG/C,+BAA+B;;QAG/B,4CAA4C;;QAG5C,4BAA4B;;QAG5B,2BAA2B;;QAG3B,mCAAmC;;QAGnC,gEAAgE;;QAGhE,uCAAuC;;YA3EvC,0CAA0C;;YAc1C,+CAA+C;;;;;;YAO/C,6CAA6C;;;;;YAM7C,gCAAgC;;;;;;;YAQhC,mBAAmB;;;;;;;QA2CnB,yBAAyB;;QAGzB,wBAAwB;;QAGxB,4BAA4B;;;;QApF5B,0CAA0C;;QAc1C,+CAA+C;;;;;;QAO/C,6CAA6C;;;;;QAM7C,gCAAgC;;;;;;;QAQhC,mBAAmB;;;;;;;CA0UpB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,+BAA6B,CAAC;AAE9D,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,+BAA4B,CAAC"}

package/dist/presets/crm.d.ts

@@ -7,7 +7,7 @@
  * - Quick action buttons
  * - Status-heavy interfaces
  */
-import { TrinityThemePreset } from '../theme';
+import { TrinityThemePreset, type TrinityThemePresetOptions } from '../theme';
 /**
  * CRM-specific configuration options
  */
@@ -37,6 +37,13 @@ export declare const crmLightPreset: TrinityThemePreset;
  * CRM Dark Theme Preset
  */
 export declare const crmDarkPreset: TrinityThemePreset;
+/**
+ * The options the CRM preset themes are built from, one object per mode. Spread one into
+ * createTrinityThemePreset to build a variant, for example `{ ...crmPresetOptions.light, direction: 'rtl' }`.
+ * src/testing/themeMatrix.ts builds every preset this way. Not exported from the package:
+ * whether it becomes public API is decision OD-E6 (ADR-37).
+ */
+export declare const crmPresetOptions: Readonly<Record<'light' | 'dark', TrinityThemePresetOptions>>;
 /** CRM preset with both light and dark themes */
 export declare const crmPreset: {
     light: TrinityThemePreset;

package/dist/presets/crm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crm.d.ts","sourceRoot":"","sources":["../../src/presets/crm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMxE;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,wCAAwC;;IAGxC,kCAAkC;;IAGlC,iCAAiC;;IAGjC,4BAA4B;;IAG5B,oCAAoC;;IAGpC,kCAAkC;;IAGlC,iCAAiC;;IAGjC,4BAA4B;;CAE7B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAkF3B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,kBAgD1B,CAAC;AAMH,iDAAiD;AACjD,eAAO,MAAM,SAAS;;;;QAlLpB,wCAAwC;;QAGxC,kCAAkC;;QAGlC,iCAAiC;;QAGjC,4BAA4B;;QAG5B,oCAAoC;;QAGpC,kCAAkC;;QAGlC,iCAAiC;;QAGjC,4BAA4B;;;CAiK7B,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,aAAa,+BAAuB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,YAAY,+BAAsB,CAAC"}
+{"version":3,"file":"crm.d.ts","sourceRoot":"","sources":["../../src/presets/crm.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAMxG;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,wCAAwC;;IAGxC,kCAAkC;;IAGlC,iCAAiC;;IAGjC,4BAA4B;;IAG5B,oCAAoC;;IAGpC,kCAAkC;;IAGlC,iCAAiC;;IAGjC,4BAA4B;;CAE7B,CAAC;AA2FF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAA8D,CAAC;AAyD5F;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,kBAA6D,CAAC;AAM1F;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,yBAAyB,CAAC,CAG1F,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,SAAS;;;;QAnMpB,wCAAwC;;QAGxC,kCAAkC;;QAGlC,iCAAiC;;QAGjC,4BAA4B;;QAG5B,oCAAoC;;QAGpC,kCAAkC;;QAGlC,iCAAiC;;QAGjC,4BAA4B;;;CAkL7B,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,aAAa,+BAAuB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,YAAY,+BAAsB,CAAC"}

package/dist/presets/index.d.ts

@@ -7,7 +7,7 @@
  *
  * @example
  * ```tsx
- * import { crmPreset } from '@trinitydesign/design-system/presets';
+ * import { crmPreset } from '@trinityui/design-system';
  *
  * <ThemeProvider theme={crmPreset.light.theme}>
  *   <App />

package/dist/presets/portal.d.ts

@@ -7,7 +7,7 @@
  * - Prominent call-to-action buttons
  * - Accessible focus indicators
  */
-import { TrinityThemePreset } from '../theme';
+import { TrinityThemePreset, type TrinityThemePresetOptions } from '../theme';
 /**
  * Portal-specific configuration options
  */
@@ -37,6 +37,13 @@ export declare const portalLightPreset: TrinityThemePreset;
  * Portal Dark Theme Preset
  */
 export declare const portalDarkPreset: TrinityThemePreset;
+/**
+ * The options the Portal preset themes are built from, one object per mode. Spread one into
+ * createTrinityThemePreset to build a variant, for example `{ ...portalPresetOptions.light, direction: 'rtl' }`.
+ * src/testing/themeMatrix.ts builds every preset this way. Not exported from the package:
+ * whether it becomes public API is decision OD-E6 (ADR-37).
+ */
+export declare const portalPresetOptions: Readonly<Record<'light' | 'dark', TrinityThemePresetOptions>>;
 /** Portal preset with both light and dark themes */
 export declare const portalPreset: {
     light: TrinityThemePreset;

package/dist/presets/portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/presets/portal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAe,MAAM,UAAU,CAAC;AAMrF;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,kCAAkC;;IAGlC,mCAAmC;;IAGnC,yBAAyB;;IAGzB,yCAAyC;;IAGzC,qCAAqC;;IAGrC,uCAAuC;;IAGvC,uBAAuB;;IAGvB,kCAAkC;;CAEnC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAgK9B,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAsE7B,CAAC;AAMH,oDAAoD;AACpD,eAAO,MAAM,YAAY;;;;QAtRvB,kCAAkC;;QAGlC,mCAAmC;;QAGnC,yBAAyB;;QAGzB,yCAAyC;;QAGzC,qCAAqC;;QAGrC,uCAAuC;;QAGvC,uBAAuB;;QAGvB,kCAAkC;;;CAqQnC,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,+BAA0B,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,eAAe,+BAAyB,CAAC"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/presets/portal.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA4B,kBAAkB,EAAe,KAAK,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAMrH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,kCAAkC;;IAGlC,mCAAmC;;IAGnC,yBAAyB;;IAGzB,yCAAyC;;IAGzC,qCAAqC;;IAGrC,uCAAuC;;IAGvC,uBAAuB;;IAGvB,kCAAkC;;CAEnC,CAAC;AAyKF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAAiE,CAAC;AA+ElG;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAAgE,CAAC;AAMhG;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,yBAAyB,CAAC,CAG7F,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,YAAY;;;;QAvSvB,kCAAkC;;QAGlC,mCAAmC;;QAGnC,yBAAyB;;QAGzB,yCAAyC;;QAGzC,qCAAqC;;QAGrC,uCAAuC;;QAGvC,uBAAuB;;QAGvB,kCAAkC;;;CAsRnC,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,+BAA0B,CAAC;AAExD,kDAAkD;AAClD,eAAO,MAAM,eAAe,+BAAyB,CAAC"}

package/dist/safe-content.js

@@ -430,18 +430,18 @@ const z = /* @__PURE__ */ new Set([
   "yuml"
 ]), H = Math.max(...Array.from(z, (a) => a.length));
 function _(a, e = !1) {
-  return a.includes("&") ? a.replace(/&(#[xX][0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]*);?/g, (t, r, n) => {
-    if (r[0] === "#") {
-      const s = r[1] === "x" || r[1] === "X" ? parseInt(r.slice(2), 16) : parseInt(r.slice(1), 10);
-      return F(s);
+  return a.includes("&") ? a.replace(/&(#[xX][0-9a-fA-F]+|#\d+|[a-zA-Z][a-zA-Z0-9]*);?/g, (t, s, n) => {
+    if (s[0] === "#") {
+      const r = s[1] === "x" || s[1] === "X" ? parseInt(s.slice(2), 16) : parseInt(s.slice(1), 10);
+      return F(r);
     }
     if (t.endsWith(";"))
-      return Object.prototype.hasOwnProperty.call(k, r) ? k[r] : t;
-    for (let s = Math.min(r.length, H); s > 0; s -= 1) {
-      const u = r.slice(0, s);
+      return Object.prototype.hasOwnProperty.call(k, s) ? k[s] : t;
+    for (let r = Math.min(s.length, H); r > 0; r -= 1) {
+      const u = s.slice(0, r);
       if (!z.has(u)) continue;
-      const h = a[n + 1 + s] ?? "";
-      return e && /[=A-Za-z0-9]/.test(h) ? t : k[u] + r.slice(s);
+      const h = a[n + 1 + r] ?? "";
+      return e && /[=A-Za-z0-9]/.test(h) ? t : k[u] + s.slice(r);
     }
     return t;
   }) : a;
@@ -471,11 +471,11 @@ function ne(a) {
 const C = /* @__PURE__ */ new Set();
 function ae(a, e, t = "link") {
   if (process.env.NODE_ENV === "production") return;
-  const r = I(y(String(e ?? ""))) ?? (e ? "relative" : "empty"), n = `${a}:${t}:${r}`;
+  const s = I(y(String(e ?? ""))) ?? (e ? "relative" : "empty"), n = `${a}:${t}:${s}`;
   if (C.has(n)) return;
   C.add(n);
-  const s = t === "link" ? `[trinity] ${a}: a link with the "${r}" scheme was shown as plain text. Links render only for http(s), mailto, tel and relative URLs - pass one of those to keep it clickable.` : `[trinity] ${a}: an image with a "${r}" source was not loaded. Images load only from http(s), blob:, relative URLs or raster data:image (png, jpeg, gif, webp, avif, bmp, ico) - pass one of those to show it.`;
-  console.warn(s);
+  const r = t === "link" ? `[trinity] ${a}: a link with the "${s}" scheme was shown as plain text. Links render only for http(s), mailto, tel and relative URLs - pass one of those to keep it clickable.` : `[trinity] ${a}: an image with a "${s}" source was not loaded. Images load only from http(s), blob:, relative URLs or raster data:image (png, jpeg, gif, webp, avif, bmp, ico) - pass one of those to show it.`;
+  console.warn(r);
 }
 const Z = /* @__PURE__ */ new Set([
   "script",
@@ -571,18 +571,18 @@ const Z = /* @__PURE__ */ new Set([
   "br"
 ]), K = 64, V = /[\uD800-\uDBFF][\uDC00-\uDFFF]|[\uD800-\uDFFF]/g, U = /--!?>/g;
 function Q(a) {
-  const e = a.replace(/\u0000/g, "").replace(V, (h) => h.length === 2 ? h : "�"), t = [], r = e.length;
-  let n = 0, s = "";
+  const e = a.replace(/\u0000/g, "").replace(V, (h) => h.length === 2 ? h : "�"), t = [], s = e.length;
+  let n = 0, r = "";
   const u = () => {
-    s && (t.push({ kind: "text", value: _(s) }), s = "");
+    r && (t.push({ kind: "text", value: _(r) }), r = "");
   };
-  for (; n < r; ) {
+  for (; n < s; ) {
     const h = e[n];
     if (h !== "<") {
-      s += h, n += 1;
+      r += h, n += 1;
       continue;
     }
-    const b = e[n + 1];
+    const w = e[n + 1];
     if (e.startsWith("<!--", n)) {
       if (u(), e.startsWith("<!-->", n)) {
         n += 5;
@@ -594,32 +594,32 @@ function Q(a) {
       }
       U.lastIndex = n + 4;
       const c = U.exec(e);
-      n = c ? c.index + c[0].length : r;
+      n = c ? c.index + c[0].length : s;
       continue;
     }
-    if (b === "!" || b === "?") {
+    if (w === "!" || w === "?") {
       u();
       const c = e.indexOf(">", n + 2);
-      n = c === -1 ? r : c + 1;
+      n = c === -1 ? s : c + 1;
       continue;
     }
-    const S = b === "/", O = S ? n + 2 : n + 1;
+    const S = w === "/", O = S ? n + 2 : n + 1;
     if (!/[a-zA-Z]/.test(e[O] ?? "")) {
-      s += h, n += 1;
+      r += h, n += 1;
       continue;
     }
     let l = O;
-    for (; l < r && /[a-zA-Z0-9-]/.test(e[l]); ) l += 1;
+    for (; l < s && /[a-zA-Z0-9-]/.test(e[l]); ) l += 1;
     const m = e.slice(O, l).toLowerCase(), g = /* @__PURE__ */ Object.create(null);
-    let w = !1, i = !1;
-    for (; l < r; ) {
+    let A = !1, i = !1;
+    for (; l < s; ) {
       const c = e[l];
       if (c === ">") {
         i = !0, l += 1;
         break;
       }
       if (c === "/") {
-        w = e[l + 1] === ">", l += 1;
+        A = e[l + 1] === ">", l += 1;
         continue;
       }
       if (/\s/.test(c)) {
@@ -627,42 +627,42 @@ function Q(a) {
         continue;
       }
       let o = l;
-      for (; o < r && !/[\s/>=]/.test(e[o]); ) o += 1;
+      for (; o < s && !/[\s/>=]/.test(e[o]); ) o += 1;
       const p = e.slice(l, o).toLowerCase();
-      for (l = o; l < r && /\s/.test(e[l]); ) l += 1;
+      for (l = o; l < s && /\s/.test(e[l]); ) l += 1;
       let d = "";
       if (e[l] === "=") {
-        for (l += 1; l < r && /\s/.test(e[l]); ) l += 1;
-        const A = e[l];
-        if (A === '"' || A === "'") {
-          const f = e.indexOf(A, l + 1);
-          d = e.slice(l + 1, f === -1 ? r : f), l = f === -1 ? r : f + 1;
+        for (l += 1; l < s && /\s/.test(e[l]); ) l += 1;
+        const b = e[l];
+        if (b === '"' || b === "'") {
+          const f = e.indexOf(b, l + 1);
+          d = e.slice(l + 1, f === -1 ? s : f), l = f === -1 ? s : f + 1;
         } else {
           let f = l;
-          for (; f < r && !/[\s>]/.test(e[f]); ) f += 1;
+          for (; f < s && !/[\s>]/.test(e[f]); ) f += 1;
           d = e.slice(l, f), l = f;
         }
       }
       p && !Object.prototype.hasOwnProperty.call(g, p) && (g[p] = _(d, !0));
     }
     if (!i) {
-      u(), n = r;
+      u(), n = s;
       break;
     }
     if (u(), S) {
       t.push({ kind: "end", name: m }), n = l;
       continue;
     }
-    if (t.push({ kind: "start", name: m, attrs: g, selfClosing: w }), n = l, Y.has(m) && !w) {
+    if (t.push({ kind: "start", name: m, attrs: g, selfClosing: A }), n = l, Y.has(m) && !A) {
       const c = new RegExp(`</${m}(?![a-z0-9-])`, "gi");
       c.lastIndex = n;
       const o = c.exec(e), p = o ? o.index : -1;
       if (p === -1)
-        t.push({ kind: "text", value: e.slice(n) }), t.push({ kind: "end", name: m }), n = r;
+        t.push({ kind: "text", value: e.slice(n) }), t.push({ kind: "end", name: m }), n = s;
       else {
         p > n && t.push({ kind: "text", value: e.slice(n, p) });
         const d = e.indexOf(">", p);
-        t.push({ kind: "end", name: m }), n = d === -1 ? r : d + 1;
+        t.push({ kind: "end", name: m }), n = d === -1 ? s : d + 1;
       }
     }
   }
@@ -679,15 +679,15 @@ function J(a) {
   return e;
 }
 function ee(a, e) {
-  const t = J(e.allowTags), r = e.allowClasses ?? {}, n = { tag: "#root", props: {}, children: [] }, s = [n], u = () => s[s.length - 1], h = (i) => s.some((c) => c.tag === i), b = (i) => {
-    for (; s.length > 1; )
-      if (s.pop().tag === i) return;
+  const t = J(e.allowTags), s = e.allowClasses ?? {}, n = { tag: "#root", props: {}, children: [] }, r = [n], u = () => r[r.length - 1], h = (i) => r.some((c) => c.tag === i), w = (i) => {
+    for (; r.length > 1; )
+      if (r.pop().tag === i) return;
   }, S = (i, c) => {
     i.children.push(c), i.endsWithSpace = !1;
   }, O = () => {
     if (v.has(u().tag)) {
       const i = { tag: "li", props: {}, children: [], implicit: !0 };
-      S(u(), i), s.push(i);
+      S(u(), i), r.push(i);
     }
   }, l = (i) => {
     if (typeof i == "string" && v.has(u().tag) && !i.trim())
@@ -705,10 +705,10 @@ function ee(a, e) {
     const i = u();
     i.children.length === 0 || i.endsWithSpace || l(" ");
   };
-  let g = 0, w = "";
+  let g = 0, A = "";
   for (const i of a) {
     if (g > 0) {
-      i.kind === "start" && i.name === w && !i.selfClosing && (g += 1), i.kind === "end" && i.name === w && (g -= 1);
+      i.kind === "start" && i.name === A && !i.selfClosing && (g += 1), i.kind === "end" && i.name === A && (g -= 1);
       continue;
     }
     if (i.kind === "text") {
@@ -718,64 +718,64 @@ function ee(a, e) {
     if (i.kind === "start") {
       const { name: o } = i;
       if (Z.has(o)) {
-        !i.selfClosing && !T.has(o) && o !== "frame" && (g = 1, w = o);
+        !i.selfClosing && !T.has(o) && o !== "frame" && (g = 1, A = o);
         continue;
       }
       if (!t.has(o)) {
         q.has(o) && m();
         continue;
       }
-      if (s.length > K && !T.has(o)) continue;
-      const p = te(o, i.attrs, r);
+      if (r.length > K && !T.has(o)) continue;
+      const p = te(o, i.attrs, s, e.newTabHintId);
       if (p === null) continue;
       if (o === "li") {
         let f = -1;
-        for (let E = s.length - 1; E > 0; E -= 1)
-          if (v.has(s[E].tag)) {
+        for (let E = r.length - 1; E > 0; E -= 1)
+          if (v.has(r[E].tag)) {
             f = E;
             break;
           }
         if (f === -1) continue;
-        const N = s.findIndex((E, P) => P > f && E.tag === "li");
-        s.length = N === -1 ? f + 1 : N;
+        const N = r.findIndex((E, P) => P > f && E.tag === "li");
+        r.length = N === -1 ? f + 1 : N;
       }
-      if ((o === "p" || v.has(o)) && h("p") && b("p"), X.has(o))
-        for (; B.has(u().tag); ) s.pop();
-      o === "a" && h("a") && b("a");
+      if ((o === "p" || v.has(o)) && h("p") && w("p"), X.has(o))
+        for (; B.has(u().tag); ) r.pop();
+      o === "a" && h("a") && w("a");
       const d = p.__tag ?? o;
       delete p.__tag;
-      const A = { tag: d, props: p, children: [] };
-      o === "li" ? S(u(), A) : l(A), !T.has(o) && !i.selfClosing && (A.source = o, s.push(A));
+      const b = { tag: d, props: p, children: [] };
+      o === "li" ? S(u(), b) : l(b), !T.has(o) && !i.selfClosing && (b.source = o, r.push(b));
       continue;
     }
     const c = (() => {
-      for (let o = s.length - 1; o > 0; o -= 1) {
-        const p = s[o];
+      for (let o = r.length - 1; o > 0; o -= 1) {
+        const p = r[o];
         if ((p.source ?? p.tag) === i.name) return o;
       }
       return -1;
     })();
-    c > 0 ? s.length = c : q.has(i.name) && m();
+    c > 0 ? r.length = c : q.has(i.name) && m();
   }
   return n.children;
 }
-function te(a, e, t) {
+function te(a, e, t, s) {
   if (a === "a") {
-    const r = e.href;
-    if (!r || !W(r)) return null;
-    const n = { href: r, rel: "noopener noreferrer" };
-    return e.title && (n.title = e.title), e.target === "_blank" && (n.target = "_blank"), n;
+    const n = e.href;
+    if (!n || !W(n)) return null;
+    const r = { href: n, rel: "noopener noreferrer" };
+    return e.title && (r.title = e.title), e.target === "_blank" && (r.target = "_blank", s && (r["aria-describedby"] = s)), r;
   }
   if (a === "span" || a === "mark") {
-    const r = (e.class ?? "").split(/\s+/).filter((s) => s && Object.prototype.hasOwnProperty.call(t, s) && (t[s] === "span" || t[s] === "mark")), n = {};
-    return r.length && (n.className = r.join(" "), r.some((s) => t[s] === "mark") && (n.__tag = "mark")), n;
+    const n = (e.class ?? "").split(/\s+/).filter((u) => u && Object.prototype.hasOwnProperty.call(t, u) && (t[u] === "span" || t[u] === "mark")), r = {};
+    return n.length && (r.className = n.join(" "), n.some((u) => t[u] === "mark") && (r.__tag = "mark")), r;
   }
   return {};
 }
 function G(a, e) {
-  return a.map((t, r) => {
+  return a.map((t, s) => {
     if (typeof t == "string") return t;
-    const n = `${e}${r}`;
+    const n = `${e}${s}`;
     return T.has(t.tag) ? L.createElement(t.tag, { key: n }) : L.createElement(t.tag, { key: n, ...t.props }, ...G(t.children, `${n}.`));
   });
 }