@trinityui/design-system 2.4.0 → 2.10.2

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"}

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

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Types for TopRisksStrip — horizontal strip of priority insights.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+import type { InsightSeverity } from '../InsightCard';
+/**
+ * One row in the strip. Mirrors the InsightCard props it'll render.
+ */
+export interface TopRiskItem {
+    /** Stable identifier used as React key. */
+    id: string;
+    /** Severity level — drives icon and tint via InsightCard. */
+    severity: InsightSeverity;
+    /** Card title. */
+    title: string;
+    /** Optional supporting body. */
+    description?: string;
+    /** Optional eyebrow text. */
+    eyebrow?: string;
+    /** Optional metric value. */
+    value?: string;
+    /** Optional delta component (e.g. HistoricalDataIndicator). */
+    delta?: ReactNode;
+    /** Optional click handler — marks the card as interactive. */
+    onClick?: () => void;
+    /** Optional dismiss handler. */
+    onDismiss?: () => void;
+}
+/**
+ * Layout mode.
+ *
+ * - `scroll` (default) — horizontal scroll, cards keep their natural width.
+ *   Best for 5+ items or narrow viewports.
+ * - `grid` — equal-width columns. Best when the count is fixed and ≤ 4.
+ */
+export type TopRisksLayout = 'scroll' | 'grid';
+/**
+ * Props for TopRisksStrip.
+ */
+export interface TopRisksStripProps {
+    /** Items to render. Empty array → render the empty-state slot. */
+    items: TopRiskItem[];
+    /** Optional strip header text. */
+    title?: string;
+    /** Optional description sitting under the title. */
+    description?: string;
+    /** Right-side action slot (e.g. "View all" link). */
+    trailingAction?: ReactNode;
+    /** Layout mode. Default `scroll`. */
+    layout?: TopRisksLayout;
+    /** Per-card width when in scroll mode. Default `320`. */
+    cardWidth?: number;
+    /** InsightCard variant to use. Default `tinted`. */
+    cardVariant?: 'tinted' | 'outlined';
+    /** Slot rendered when `items` is empty. */
+    emptyState?: ReactNode;
+    /** sx overrides for the root container. */
+    sx?: SxProps<Theme>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/TopRisksStrip/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,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,QAAQ,EAAE,eAAe,CAAC;IAC1B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,qCAAqC;IACrC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,WAAW,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACpC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB"}

package/dist/components/templates/Auth/AuthTemplate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Auth Template — centered card for sign-in / sign-up / password reset
+ * @module components/templates/Auth
+ * @example
+ * ```tsx
+ *  import { AuthTemplate } from '@trinityui/design-system';
+ *
+ *  <AuthTemplate
+ *    mode="signin"
+ *    title="Welcome back"
+ *    subtitle="Sign in to continue"
+ *    primaryAction={{ label: 'Sign in', onClick: handleSubmit }}
+ *  >
+ *    <TextField label="Email" />
+ *    <TextField label="Password" type="password" />
+ *  </AuthTemplate>
+ *  ```
+ */
+import * as React from 'react';
+import type { AuthTemplateProps } from './types';
+export type { AuthTemplateProps, AuthMode, AuthAction, AuthFooterLink } from './types';
+/**
+ * AuthTemplate — a centered card surface for any single-step authentication
+ * flow. Composes a logo, headline, optional subtitle, a form slot (you supply
+ * TextFields/etc.), primary CTA, optional secondary link, and a footer.
+ */
+export declare const AuthTemplate: React.ForwardRefExoticComponent<AuthTemplateProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AuthTemplate.d.ts.map

package/dist/components/templates/Auth/AuthTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthTemplate.d.ts","sourceRoot":"","sources":["../../../../src/components/templates/Auth/AuthTemplate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,SAAS,CAAC;AAEjE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAcvF;;;;GAIG;AACH,eAAO,MAAM,YAAY,0FA2MxB,CAAC"}

package/dist/components/templates/Auth/index.d.ts

@@ -0,0 +1,3 @@
+export { AuthTemplate } from './AuthTemplate';
+export type { AuthTemplateProps, AuthMode, AuthAction, AuthFooterLink, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/templates/Auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/templates/Auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,cAAc,GACf,MAAM,SAAS,CAAC"}