@trinityui/design-system 2.3.1 → 2.10.1

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

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Types for NotificationCenter — bell-button + popover surfacing
+ * recent notifications with read/unread + per-item actions.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme, PopoverOrigin } from '@mui/material';
+/**
+ * Severity / category of a single notification.
+ *
+ * Maps to MUI Alert's `severity` so styling matches Alert + InsightCard +
+ * StatusIndicator. Use `info` when no clear severity applies.
+ */
+export type NotificationSeverity = 'info' | 'success' | 'warning' | 'error';
+/**
+ * A single notification entry.
+ *
+ * Trinity convention: `id` should be globally unique within the surfacing
+ * window. The component does NOT mutate items — read/unread is reflected via
+ * `read` and toggled via the `onMarkAsRead` callback.
+ */
+export interface NotificationItem {
+    /** Stable id. Used as React key and as the argument to all callbacks. */
+    id: string;
+    /** Short title shown in bold. */
+    title: string;
+    /** Optional body. Rendered as ReactNode so links / inline chips are OK. */
+    message?: ReactNode;
+    /** ISO timestamp or formatted string (e.g. "2 min ago"). Displayed muted. */
+    timestamp?: string | Date;
+    /** When true, no unread dot; entry renders in a quieter tone. */
+    read?: boolean;
+    /** Severity for left-edge color stripe + icon. Default `info`. */
+    severity?: NotificationSeverity;
+    /** Optional leading avatar / icon. */
+    avatar?: ReactNode;
+    /** Optional per-item actions rendered at the right. Keep to 1-2. */
+    actions?: ReactNode;
+    /** Optional click handler for the row itself (e.g. navigation). */
+    onClick?: (id: string) => void;
+}
+/**
+ * Props for NotificationCenter.
+ *
+ * The component owns:
+ *   - the popover open/close state (uncontrolled by default, controllable via `open`)
+ *   - unread count derivation from `notifications.filter(n => !n.read).length`
+ *
+ * The consumer owns:
+ *   - notification data (always supplied via `notifications`)
+ *   - read/unread state changes (via `onMarkAsRead` / `onMarkAllRead`)
+ *
+ * Mounting strategy: anchor the popover to the bell trigger via `anchorOrigin`
+ * and `transformOrigin`. Defaults open downward-right which suits app chrome.
+ */
+export interface NotificationCenterProps {
+    /** Notifications to render, top-most first. */
+    notifications: NotificationItem[];
+    /** Called when a single row is marked read. */
+    onMarkAsRead?: (id: string) => void;
+    /** Called when "Mark all as read" is clicked. */
+    onMarkAllRead?: () => void;
+    /** Called when a row is dismissed (X button). */
+    onDismiss?: (id: string) => void;
+    /** Footer link / button (e.g. "View all"). */
+    footerAction?: ReactNode;
+    /** Header title. Default "Notifications". */
+    title?: string;
+    /** Trigger button accessible label. Default "Open notifications". */
+    triggerAriaLabel?: string;
+    /** Override the default empty state. */
+    emptyState?: ReactNode;
+    /** Maximum height of the popover content area. Default 480. */
+    maxHeight?: number;
+    /** Maximum count rendered in the badge. Default 99. */
+    badgeMax?: number;
+    /** Whether to show the unread badge dot when count is 0. Default false. */
+    showZeroBadge?: boolean;
+    /** Controlled open. Omit for self-managed. */
+    open?: boolean;
+    /** Called when open state changes (controlled mode helper). */
+    onOpenChange?: (open: boolean) => void;
+    /** Popover anchor origin. Default `{ vertical: 'bottom', horizontal: 'right' }`. */
+    anchorOrigin?: PopoverOrigin;
+    /** Popover transform origin. Default `{ vertical: 'top', horizontal: 'right' }`. */
+    transformOrigin?: PopoverOrigin;
+    /** sx for the trigger button. */
+    triggerSx?: SxProps<Theme>;
+    /** sx for the popover paper. */
+    paperSx?: SxProps<Theme>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/NotificationCenter/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oEAAoE;IACpE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,iDAAiD;IACjD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,8CAA8C;IAC9C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,oFAAoF;IACpF,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,oFAAoF;IACpF,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CAC1B"}

package/dist/components/OrgChart/OrgChart.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview OrgChart — top-down tree visualization with boxes connected
+ * by lines.
+ *
+ * Layout: `d3-hierarchy.tree()` for stable per-level positioning that handles
+ * uneven subtree sizes well (each level's nodes are guaranteed to fit without
+ * overlap). The output is rendered into a single SVG so connectors stay
+ * aligned with their endpoints during scroll, zoom, and animation.
+ *
+ * Connector style: orthogonal "elbows" (vertical drop from parent → horizontal
+ * cross → vertical rise to child). This is the convention for org charts;
+ * curved connectors are easier on the eye for genealogy trees but less
+ * legible for org reporting structures.
+ *
+ * @module components/OrgChart
+ */
+import * as React from 'react';
+import type { OrgChartProps } from './types';
+export declare const OrgChart: <TMeta>(props: OrgChartProps<TMeta> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+export default OrgChart;
+//# sourceMappingURL=OrgChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OrgChart.d.ts","sourceRoot":"","sources":["../../../src/components/OrgChart/OrgChart.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,SAAS,CAAC;AAuQjB,eAAO,MAAM,QAAQ,EA2Lf,CAAC,KAAK,EACV,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,KAC9D,KAAK,CAAC,YAAY,CAAC;AAExB,eAAe,QAAQ,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * OrgChart barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { OrgChart, default as OrgChartDefault } from './OrgChart';
+export type { OrgChartProps, OrgChartOrientation, OrgNode, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/OrgChart/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,YAAY,CAAC;AAElE,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,OAAO,GACR,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Types for OrgChart — top-down tree visualization with boxes
+ * connected by lines.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * A single node in the org tree.
+ *
+ * Trinity convention: keep node payload minimal — only what's needed to
+ * render the box. Long-form data should be loaded separately when a node is
+ * selected (typically into an `EntityDetailPanel`).
+ *
+ * For deeper trees, set `collapsed: true` on intermediate nodes to render
+ * a "+N more" chevron rather than expanding the full subtree.
+ */
+export interface OrgNode<TMeta = unknown> {
+    /** Stable id for React keys + selection. */
+    id: string;
+    /** Primary label (e.g. person name). */
+    title: ReactNode;
+    /** Secondary label (e.g. role / title). */
+    subtitle?: ReactNode;
+    /** Optional avatar — image URL or rendered ReactNode. */
+    avatar?: ReactNode;
+    /** Optional severity dot in the top-right (drives theme palette color). */
+    severity?: 'success' | 'warning' | 'error' | 'info' | 'neutral';
+    /** Optional badge chip (e.g. department). */
+    badge?: ReactNode;
+    /** Optional sub-tree. */
+    children?: ReadonlyArray<OrgNode<TMeta>>;
+    /** When true, sub-tree is collapsed and rendered as a "+N more" expander. */
+    collapsed?: boolean;
+    /** Optional consumer-defined payload. */
+    meta?: TMeta;
+}
+/**
+ * Layout orientation.
+ *
+ * - `vertical` (default) — parent on top, children below
+ * - `horizontal` — parent on left, children to the right (good for deep trees)
+ */
+export type OrgChartOrientation = 'vertical' | 'horizontal';
+/**
+ * Props for OrgChart.
+ *
+ * The component uses `d3-hierarchy.tree()` for tree layout. The result is
+ * rendered into a single SVG so connectors stay aligned during zoom/pan and
+ * during animations.
+ */
+export interface OrgChartProps<TMeta = unknown> {
+    /** Root node — the top of the tree. */
+    root: OrgNode<TMeta>;
+    /** Currently selected node id. */
+    selectedId?: string;
+    /** Called when a node is clicked. */
+    onSelect?: (node: OrgNode<TMeta>) => void;
+    /** Called when a collapsed expander is clicked. */
+    onExpand?: (node: OrgNode<TMeta>) => void;
+    /** Orientation. Default `vertical`. */
+    orientation?: OrgChartOrientation;
+    /** Width per node box. Default 200. */
+    nodeWidth?: number;
+    /** Height per node box. Default 96. */
+    nodeHeight?: number;
+    /** Horizontal gap between siblings. Default 24. */
+    siblingGap?: number;
+    /** Vertical gap between levels. Default 48. */
+    levelGap?: number;
+    /** Render a custom node body instead of the default avatar+title+subtitle. */
+    renderNode?: (node: OrgNode<TMeta>, isSelected: boolean) => ReactNode;
+    /** Optional background color for the canvas. Default semantic background.secondary. */
+    canvasBackground?: string;
+    /** Maximum visible height before vertical scroll engages. Default 600. */
+    maxHeight?: number | string;
+    /** sx for the root container. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Default "Organization chart". */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/OrgChart/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG,OAAO;IACtC,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,yDAAyD;IACzD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAChE,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACrB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC1C,uCAAuC;IACvC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,KAAK,SAAS,CAAC;IACtE,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/PageTOC/PageTOC.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview PageTOC — sticky right-rail table of contents with scroll-spy.
+ *
+ * Renders a vertical list of section anchors with progressive indent for
+ * nested levels. Automatically tracks the active section based on viewport
+ * intersection (overridable via `activeId`).
+ *
+ * Active indicator: 2px brand-color left border + bolder text. Smooth scroll
+ * to anchor on click, with `scroll-margin-top` honored via `scrollOffset`.
+ *
+ * @module components/PageTOC
+ * @example
+ * ```tsx
+ *  import { PageTOC } from '@trinityui/design-system';
+ *
+ *  <PageTOC
+ *    entries={[
+ *      { id: 'overview', label: 'Overview', href: '#overview' },
+ *      { id: 'design',   label: 'Study design', href: '#design',
+ *        children: [
+ *          { id: 'endpoints', label: 'Endpoints', href: '#endpoints' },
+ *          { id: 'population', label: 'Population', href: '#population' },
+ *        ],
+ *      },
+ *    ]}
+ *  />
+ * ```
+ */
+import * as React from 'react';
+import type { PageTOCProps } from './types';
+export declare const PageTOC: React.ForwardRefExoticComponent<PageTOCProps & React.RefAttributes<HTMLElement>>;
+export default PageTOC;
+//# sourceMappingURL=PageTOC.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PageTOC.d.ts","sourceRoot":"","sources":["../../../src/components/PageTOC/PageTOC.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAC;AA4I1D,eAAO,MAAM,OAAO,kFA6InB,CAAC;AAeF,eAAe,OAAO,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * PageTOC barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { PageTOC, default as PageTOCDefault } from './PageTOC';
+export type { PageTOCProps, PageTOCEntry } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/PageTOC/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAE/D,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Types for PageTOC — sticky right-rail table of contents with
+ * section anchors and scroll-spy active state.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * A single TOC entry.
+ *
+ * Entries can nest up to 3 levels via `children`. Deeper nesting starts to
+ * compete with the page itself for attention — prefer flattening.
+ *
+ * `href` should be a fragment id of the actual heading on the page (e.g.
+ * `#study-design`). The component does NOT auto-derive ids — supply them.
+ */
+export interface PageTOCEntry {
+    /** Stable id. Used as React key and as the scroll-target via querySelector. */
+    id: string;
+    /** Display label. Plain text or ReactNode (sparingly — keep these terse). */
+    label: ReactNode;
+    /** Fragment href, e.g. `#study-design`. */
+    href: string;
+    /** Optional severity dot indicator (e.g. surfacing draft / issue counts). */
+    badge?: ReactNode;
+    /** Nested entries. Render with progressive indent. */
+    children?: PageTOCEntry[];
+}
+/**
+ * Props for PageTOC.
+ *
+ * Scroll-spy: when `activeId` is omitted, the component auto-derives the active
+ * entry from scroll position using IntersectionObserver. Supply `activeId`
+ * (and update it from your own scroll listener) when you need stronger control,
+ * e.g. for URL hash sync.
+ */
+export interface PageTOCProps {
+    /** TOC entries to render. Top-level array becomes flat list at level 0. */
+    entries: ReadonlyArray<PageTOCEntry>;
+    /** Optional title shown above the list. Default `"On this page"`. */
+    title?: string;
+    /** Controlled active id. Omit for auto scroll-spy. */
+    activeId?: string;
+    /** Called when the user clicks an entry. Default behavior scrolls to the anchor. */
+    onSelect?: (id: string, href: string) => void;
+    /** Footer slot — typically a "Back to top" link or last-modified caption. */
+    footer?: ReactNode;
+    /** When true, omits scroll-spy entirely (e.g. for static documentation pages). */
+    disableScrollSpy?: boolean;
+    /** Maximum visible height before the list scrolls internally. Default 70vh. */
+    maxHeight?: string | number;
+    /** Top offset for scroll-spy + scrollIntoView (account for sticky header). Default 80. */
+    scrollOffset?: number;
+    /** sx for the root container. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Falls back to the title. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/PageTOC/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,KAAK,EAAE,SAAS,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/StatusHero/StatusHero.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview StatusHero — large dashboard hero showing aggregate system / program health.
+ *
+ * Pure composition over `IconIndicator` (from StatusIndicator), `getStatusConfig`
+ * (to derive the default label), and the active MUI theme. No parallel severity
+ * rendering — anything color-related comes from `theme.palette.*` so light/dark
+ * mode and Trinity overrides flow through.
+ *
+ * @module components/StatusHero
+ * @example
+ * ```tsx
+ *  import { StatusHero } from '@trinityui/design-system';
+ *
+ *  <StatusHero
+ *    status="success"
+ *    title="All systems operational"
+ *    description="No degraded services in the last 24 hours."
+ *    breakdown={[
+ *      { status: 'success', count: 84, label: 'Healthy' },
+ *      { status: 'warning', count: 2, label: 'Degraded' },
+ *      { status: 'error', count: 0, label: 'Down' },
+ *    ]}
+ *    updatedLabel="Updated 2m ago"
+ *  />
+ * ```
+ */
+import * as React from 'react';
+import type { StatusHeroProps } from './types';
+export declare const StatusHero: React.ForwardRefExoticComponent<StatusHeroProps & React.RefAttributes<HTMLDivElement>>;
+export default StatusHero;
+//# sourceMappingURL=StatusHero.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StatusHero.d.ts","sourceRoot":"","sources":["../../../src/components/StatusHero/StatusHero.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAiB/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiB/C,eAAO,MAAM,UAAU,wFA6MtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * StatusHero barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { StatusHero, default as StatusHeroDefault } from './StatusHero';
+export type { StatusHeroProps, StatusBreakdownItem, StatusHeroVariant, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/StatusHero/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAExE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Types for StatusHero — large dashboard hero showing aggregate health.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+import type { StatusType } from '../StatusIndicator';
+/**
+ * A single status breakdown row shown in the hero.
+ *
+ * Example: `{ status: 'success', count: 84, label: 'Healthy sites' }`.
+ */
+export interface StatusBreakdownItem {
+    /** Reuses the canonical `StatusType` from StatusIndicator so colors + icons match. */
+    status: StatusType;
+    /** Display count or percentage. */
+    count: number | string;
+    /** Optional override label. Defaults to the StatusType's default label. */
+    label?: string;
+}
+/**
+ * Visual emphasis.
+ *
+ * - `solid` — uses the active palette tone as a filled hero background; best
+ *   when the hero is the only large surface on the page
+ * - `subtle` (default) — a tinted card that sits inside an existing dashboard
+ *   grid without overwhelming the rest of the page
+ */
+export type StatusHeroVariant = 'solid' | 'subtle';
+/**
+ * Props for StatusHero.
+ *
+ * Composition over `IconIndicator`, `Typography`, and `StatusBreakdownItem`s —
+ * no parallel color rendering. Severity colors flow from the active MUI theme.
+ */
+export interface StatusHeroProps {
+    /** Overall aggregate status — drives the headline icon, color, and label. */
+    status: StatusType;
+    /** Short headline (e.g. "All systems operational"). */
+    title: string;
+    /** Optional supporting body text. */
+    description?: string;
+    /** Optional eyebrow above the title. */
+    eyebrow?: string;
+    /** Optional breakdown rows shown beside the headline. */
+    breakdown?: StatusBreakdownItem[];
+    /** Visual variant. Default `subtle`. */
+    variant?: StatusHeroVariant;
+    /** Right-side slot for primary actions. */
+    actions?: ReactNode;
+    /** Optional last-updated label rendered at the bottom right (e.g. "Updated 2m ago"). */
+    updatedLabel?: string;
+    /** sx overrides for the root surface. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override for the hero. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/StatusHero/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,MAAM,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,MAAM,EAAE,UAAU,CAAC;IACnB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,wCAAwC;IACxC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview SystemBanner — page-top global announcement banner.
+ *
+ * Wraps MUI Alert with sticky / fixed positioning + optional dismissal
+ * persistence via `localStorage`. Severity colors come from `theme.palette`
+ * so the banner matches every other status surface (Alert, InsightCard,
+ * StatusIndicator).
+ *
+ * @module components/SystemBanner
+ * @example
+ * ```tsx
+ *  import { SystemBanner } from '@trinityui/design-system';
+ *
+ *  <SystemBanner
+ *    severity="warning"
+ *    title="Scheduled maintenance"
+ *    action={<Button size="small">Learn more</Button>}
+ *    storageKey="banner.maintenance-2026-q4"
+ *  >
+ *    Read-only mode for 15 minutes starting 23:00 UTC tonight.
+ *  </SystemBanner>
+ * ```
+ */
+import * as React from 'react';
+import type { SystemBannerProps } from './types';
+export declare const SystemBanner: React.ForwardRefExoticComponent<SystemBannerProps & React.RefAttributes<HTMLDivElement>>;
+export default SystemBanner;
+//# sourceMappingURL=SystemBanner.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * SystemBanner barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { SystemBanner, default as SystemBannerDefault } from './SystemBanner';
+export type { SystemBannerProps, SystemBannerSeverity, SystemBannerPosition, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/SystemBanner/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Types for SystemBanner — page-top global announcement banner.
+ */
+import type { ReactNode } from 'react';
+import type { AlertColor, SxProps, Theme } from '@mui/material';
+/**
+ * Severity / intent of the banner.
+ *
+ * Maps directly to MUI Alert's `severity` so styling stays consistent with
+ * every other status surface (`Alert`, `InsightCard`, `StatusIndicator`).
+ */
+export type SystemBannerSeverity = AlertColor;
+/**
+ * Where the banner is anchored.
+ *
+ * - `sticky` — scrolls with the page but pins to the top edge until dismissed
+ * - `fixed` — overlays the viewport top edge, doesn't scroll
+ * - `static` — sits inline in document flow (use inside non-chrome contexts)
+ */
+export type SystemBannerPosition = 'sticky' | 'fixed' | 'static';
+/**
+ * Props for SystemBanner.
+ *
+ * Wraps MUI Alert with:
+ *   - page-top positioning (sticky / fixed / static)
+ *   - dismissal persistence via `localStorage` keyed by `storageKey`
+ *   - explicit action slot (the Alert's `action` prop is repurposed for the
+ *     close button so we expose a dedicated `action` slot here)
+ */
+export interface SystemBannerProps {
+    /** Severity. Drives Alert color + icon. Default `info`. */
+    severity?: SystemBannerSeverity;
+    /** Banner message body. Plain text or any ReactNode. */
+    children: ReactNode;
+    /** Optional bold title shown above the body. */
+    title?: string;
+    /** Action slot — typically a Link or short Button (e.g. "Learn more"). */
+    action?: ReactNode;
+    /** Where to anchor the banner. Default `sticky`. */
+    position?: SystemBannerPosition;
+    /**
+     * If provided, the dismissed state is persisted to `localStorage` under
+     * this key. Use a stable, version-suffixed key so re-announced incidents
+     * surface again (e.g. `'trinity.banner.maintenance-2026-q4'`).
+     */
+    storageKey?: string;
+    /** Whether the banner can be dismissed. Default `true`. */
+    dismissible?: boolean;
+    /** Called when the dismiss button is clicked, after persistence. */
+    onDismiss?: () => void;
+    /** Controlled open state. When omitted, the banner self-manages. */
+    open?: boolean;
+    /** Optional sx overrides for the root container. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Falls back to `${severity} announcement`. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/SystemBanner/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,wDAAwD;IACxD,QAAQ,EAAE,SAAS,CAAC;IACpB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,oEAAoE;IACpE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/TopRisksStrip/TopRisksStrip.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview TopRisksStrip — horizontal strip of priority `InsightCard`s.
+ *
+ * Pure composition over `InsightCard` — no parallel severity rendering. The
+ * strip just handles layout (scroll vs. grid), optional title, and an empty
+ * state slot.
+ *
+ * @module components/TopRisksStrip
+ * @example
+ * ```tsx
+ *  import { TopRisksStrip } from '@trinityui/design-system';
+ *
+ *  <TopRisksStrip
+ *    title="Top risks this week"
+ *    items={[
+ *      { id: '1', severity: 'high', title: '3 sites missed SLA' },
+ *      { id: '2', severity: 'medium', title: 'Onboarding dropped 7%' },
+ *    ]}
+ *  />
+ * ```
+ */
+import * as React from 'react';
+import type { TopRisksStripProps } from './types';
+export declare const TopRisksStrip: React.ForwardRefExoticComponent<TopRisksStripProps & React.RefAttributes<HTMLDivElement>>;
+export default TopRisksStrip;
+//# sourceMappingURL=TopRisksStrip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TopRisksStrip.d.ts","sourceRoot":"","sources":["../../../src/components/TopRisksStrip/TopRisksStrip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,aAAa,2FA0HzB,CAAC;AAEF,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * TopRisksStrip barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { TopRisksStrip, default as TopRisksStripDefault, } from './TopRisksStrip';
+export type { TopRisksStripProps, TopRiskItem, TopRisksLayout, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TopRisksStrip/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,OAAO,IAAI,oBAAoB,GAChC,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,GACf,MAAM,SAAS,CAAC"}