@trinityui/design-system 2.4.0 → 2.10.1

package/dist/components/GeoStatusMap/GeoStatusMap.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview GeoStatusMap — geographic map with status overlays at locations.
+ *
+ * Projection-agnostic — the consumer supplies the base map SVG (as ReactNode)
+ * and a projection function. The component handles markers, severity coloring,
+ * tooltips, legend, and click interactions. This keeps the component bundle
+ * small (no baked-in TopoJSON) and lets each product pick its own region.
+ *
+ * @module components/GeoStatusMap
+ */
+import * as React from 'react';
+import type { GeoStatusMapProps } from './types';
+export declare const GeoStatusMap: <TMeta>(props: GeoStatusMapProps<TMeta> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+export default GeoStatusMap;
+//# sourceMappingURL=GeoStatusMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeoStatusMap.d.ts","sourceRoot":"","sources":["../../../src/components/GeoStatusMap/GeoStatusMap.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,OAAO,KAAK,EACV,iBAAiB,EAIlB,MAAM,SAAS,CAAC;AAoIjB,eAAO,MAAM,YAAY,EA4NnB,CAAC,KAAK,EACV,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,KAClE,KAAK,CAAC,YAAY,CAAC;AAExB,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * GeoStatusMap barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { GeoStatusMap, default as GeoStatusMapDefault } from './GeoStatusMap';
+export type { GeoStatusMapProps, GeoLocation, GeoSeverity, GeoMarkerShape, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Types for GeoStatusMap — geographic map with status overlays
+ * at locations.
+ *
+ * The component is projection-agnostic — the consumer supplies the base map
+ * SVG (as ReactNode) and a projection function that turns lat/lng into SVG
+ * (x, y). This keeps the bundle small (no baked-in TopoJSON) and lets each
+ * product pick the region/projection it needs.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * Severity drives marker color.
+ *
+ * Maps to `theme.palette.<severity>.main`:
+ *   - `success` — green (on track / healthy)
+ *   - `warning` — amber (at risk / degraded)
+ *   - `error`   — red (down / critical)
+ *   - `info`    — blue (informational)
+ *   - `neutral` — muted (pending / inactive)
+ */
+export type GeoSeverity = 'success' | 'warning' | 'error' | 'info' | 'neutral';
+/**
+ * A single point on the map.
+ *
+ * Supply EITHER:
+ *   - `lng` + `lat` — geographic coordinates (will be passed through `project()`)
+ *   - `x` + `y` — pre-projected SVG coordinates (skip projection — useful when
+ *      the consumer already projected via d3-geo or similar)
+ *
+ * The component picks `x`/`y` if both pairs are supplied.
+ */
+export interface GeoLocation<TMeta = unknown> {
+    /** Stable id. */
+    id: string;
+    /** Display label (tooltip + legend). */
+    label: ReactNode;
+    /** Longitude (degrees). */
+    lng?: number;
+    /** Latitude (degrees). */
+    lat?: number;
+    /** Pre-projected SVG x. */
+    x?: number;
+    /** Pre-projected SVG y. */
+    y?: number;
+    /** Severity drives marker color. Default `info`. */
+    severity?: GeoSeverity;
+    /** Numeric value for clustering / sizing. */
+    value?: number;
+    /** Tooltip secondary text. */
+    description?: ReactNode;
+    /** Consumer-defined payload — flows into selection callback. */
+    meta?: TMeta;
+}
+/**
+ * Marker shape.
+ *
+ * - `dot` — solid filled circle (default)
+ * - `ring` — outlined circle (better for high-density displays)
+ * - `pulse` — solid circle with an animated outer ring (for "live" markers)
+ */
+export type GeoMarkerShape = 'dot' | 'ring' | 'pulse';
+/**
+ * Props for GeoStatusMap.
+ */
+export interface GeoStatusMapProps<TMeta = unknown> {
+    /**
+     * Base map SVG content (paths, etc). Rendered inside the component's
+     * `<svg>` with the `viewBox` you configure.
+     *
+     * Examples:
+     *   - Inlined world TopoJSON paths
+     *   - A static SVG world map you imported as a string
+     *   - For a US map: pre-rendered state outlines
+     *
+     * The component does NOT supply baked-in topology — the team picks the
+     * region. See the stories for examples.
+     */
+    baseMap: ReactNode;
+    /** SVG viewBox. Should match the projection's extent. */
+    viewBox: string;
+    /** Locations to overlay as markers. */
+    locations: ReadonlyArray<GeoLocation<TMeta>>;
+    /**
+     * Optional projection function. Required when a location has `lng`/`lat`
+     * but no `x`/`y`. Receives `[lng, lat]` and returns `[x, y]` in SVG units.
+     * If omitted, all locations must supply pre-projected `x`/`y`.
+     */
+    project?: (coords: [number, number]) => [number, number];
+    /** Marker shape. Default `dot`. */
+    markerShape?: GeoMarkerShape;
+    /** Marker radius. Default 6. */
+    markerRadius?: number;
+    /** Currently selected location id (shows a highlight ring). */
+    selectedId?: string;
+    /** Called when a marker is clicked. */
+    onSelect?: (location: GeoLocation<TMeta>) => void;
+    /** Custom tooltip renderer. Default shows label + description + value. */
+    renderTooltip?: (location: GeoLocation<TMeta>) => ReactNode;
+    /** Show severity legend. Default true. */
+    showLegend?: boolean;
+    /** Legend label override per severity. */
+    legendLabels?: Partial<Record<GeoSeverity, ReactNode>>;
+    /** Fill color for the base map paths. Default semantic background.tertiary. */
+    baseMapFill?: string;
+    /** Stroke color for the base map paths. Default semantic border.subtle. */
+    baseMapStroke?: string;
+    /** Background color of the canvas. Default semantic background.secondary. */
+    canvasBackground?: string;
+    /** Maximum visible height. Default 480. */
+    maxHeight?: number | string;
+    /** sx for the root container. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Default "Geographic status map". */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/GeoStatusMap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,GAAG,OAAO;IAC1C,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,KAAK,EAAE,SAAS,CAAC;IACjB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,gEAAgE;IAChE,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO;IAChD;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,SAAS,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,SAAS,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,mCAAmC;IACnC,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAClD,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;IAC5D,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACvD,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,iCAAiC;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/HierarchicalDrillDown/HierarchicalDrillDown.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview HierarchicalDrillDown — Finder-style column view for navigating
+ * a tree of items.
+ *
+ * Layout: N side-by-side lanes, each scrollable independently. Clicking an
+ * item in lane K updates `selectedPath[K]` and re-renders the K+1 lane with
+ * that item's children. The right-most lane can optionally render a custom
+ * detail pane (via `renderDetail`) for the deepest selected node.
+ *
+ * Keyboard support: each row is a real `<button>`, so Tab + Enter/Space work.
+ * Arrow keys are intentionally NOT bound — they'd conflict with screen reader
+ * navigation patterns. Use focus + Enter for selection.
+ *
+ * @module components/HierarchicalDrillDown
+ */
+import * as React from 'react';
+import type { HierarchicalDrillDownProps } from './types';
+export declare const HierarchicalDrillDown: <TMeta>(props: HierarchicalDrillDownProps<TMeta> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+export default HierarchicalDrillDown;
+//# sourceMappingURL=HierarchicalDrillDown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HierarchicalDrillDown.d.ts","sourceRoot":"","sources":["../../../src/components/HierarchicalDrillDown/HierarchicalDrillDown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAW/B,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,SAAS,CAAC;AA2NjB,eAAO,MAAM,qBAAqB,EA8I7B,CAAC,KAAK,EACT,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;CAAE,KAC3E,KAAK,CAAC,YAAY,CAAC;AAExB,eAAe,qBAAqB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HierarchicalDrillDown/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,OAAO,IAAI,4BAA4B,GACxC,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,0BAA0B,EAC1B,aAAa,GACd,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Types for HierarchicalDrillDown — Finder-style 3-lane column
+ * view for navigating a tree of items.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * A single node in the hierarchy.
+ *
+ * The component is data-shape agnostic — supply your own type via the `T`
+ * generic on `HierarchicalDrillDownProps`. The required surface is just the
+ * `id`, `label`, optional `children` (subtree), optional `icon`, optional
+ * `meta` (right-aligned secondary text or chip), optional `severity` (drives
+ * the dot color when shown), and optional `disabled`.
+ *
+ * Lazy-loading: when `children` is `undefined` AND `hasChildren` is `true`,
+ * the component renders a chevron and calls `onLoadChildren(node)` when the
+ * lane focuses on this node. The consumer is expected to return a Promise
+ * that resolves to the children, or to update the tree state externally and
+ * re-render.
+ */
+export interface DrillDownNode<TMeta = unknown> {
+    /** Stable id for React keys + lane state. */
+    id: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Optional secondary text or chip rendered right-aligned. */
+    meta?: ReactNode;
+    /** Optional leading icon. */
+    icon?: ReactNode;
+    /** Optional severity dot (uses theme palette colors). */
+    severity?: 'success' | 'warning' | 'error' | 'info' | 'neutral';
+    /** Disabled row — not clickable, dimmed. */
+    disabled?: boolean;
+    /** Children. If absent, node is a leaf (or lazy — see `hasChildren`). */
+    children?: ReadonlyArray<DrillDownNode<TMeta>>;
+    /**
+     * When true AND children is undefined, the row shows a chevron and the
+     * lane requests children via `onLoadChildren` when this node is focused.
+     */
+    hasChildren?: boolean;
+    /** Optional consumer-defined payload — flows into row render and selection callback. */
+    meta_data?: TMeta;
+}
+/**
+ * Props for HierarchicalDrillDown.
+ */
+export interface HierarchicalDrillDownProps<TMeta = unknown> {
+    /** Root nodes — top level of the tree. */
+    nodes: ReadonlyArray<DrillDownNode<TMeta>>;
+    /**
+     * Current navigation path — array of node ids from root to the deepest
+     * selected level. The lane structure is:
+     *   [0] = root listing
+     *   [1] = children of selectedPath[0]
+     *   [2] = children of selectedPath[1]
+     *   etc.
+     */
+    selectedPath?: ReadonlyArray<string>;
+    /** Called when the user clicks a node — receives the full path (including the new node). */
+    onSelect?: (path: ReadonlyArray<string>, node: DrillDownNode<TMeta>) => void;
+    /** Called when a node with `hasChildren: true` is focused but its children aren't loaded yet. */
+    onLoadChildren?: (node: DrillDownNode<TMeta>) => void;
+    /** Render the right pane (terminal level) with custom content for the deepest selected node. */
+    renderDetail?: (node: DrillDownNode<TMeta>) => ReactNode;
+    /** Number of lanes to render. Default 3 (Finder column view). */
+    laneCount?: 2 | 3 | 4;
+    /** Lane width. Default 240. */
+    laneWidth?: number;
+    /** Detail lane width override (when `renderDetail` is used). Default 320. */
+    detailWidth?: number;
+    /** Custom empty-state per lane when there are no items. */
+    emptyState?: ReactNode;
+    /** Lane header — typically a search input or label. */
+    laneHeader?: (level: number) => ReactNode;
+    /** sx for the root container. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Default "Hierarchical navigation". */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HierarchicalDrillDown/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;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAChE,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wFAAwF;IACxF,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,KAAK,GAAG,OAAO;IACzD,0CAA0C;IAC1C,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC7E,iGAAiG;IACjG,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACtD,gGAAgG;IAChG,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;IACzD,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1C,iCAAiC;IACjC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/HistoricalDataIndicator/HistoricalDataIndicator.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview HistoricalDataIndicator — a labeled trend delta with explicit period context.
+ *
+ * Wraps `DifferentialIndicator` (the existing primitive) with a "vs <period>"
+ * label so dashboards always make the comparison window unambiguous.
+ *
+ * @module components/HistoricalDataIndicator
+ * @example
+ * ```tsx
+ *  import { HistoricalDataIndicator } from '@trinityui/design-system';
+ *
+ *  <HistoricalDataIndicator value={12.4} period="prior-week" />
+ *  <HistoricalDataIndicator value={-2.1} period="prior-month" comparison="320 → 313" />
+ *  <HistoricalDataIndicator value={5.3} invertPolarity periodLabel="vs target" />
+ * ```
+ */
+import * as React from 'react';
+import type { HistoricalDataIndicatorProps } from './types';
+export declare const HistoricalDataIndicator: React.ForwardRefExoticComponent<HistoricalDataIndicatorProps & React.RefAttributes<HTMLDivElement>>;
+export default HistoricalDataIndicator;
+//# sourceMappingURL=HistoricalDataIndicator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HistoricalDataIndicator.d.ts","sourceRoot":"","sources":["../../../src/components/HistoricalDataIndicator/HistoricalDataIndicator.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAE,4BAA4B,EAAoB,MAAM,SAAS,CAAC;AAW9E,eAAO,MAAM,uBAAuB,qGAgGlC,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/HistoricalDataIndicator/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,uBAAuB,EACvB,OAAO,IAAI,8BAA8B,GAC1C,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,4BAA4B,EAC5B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Types for HistoricalDataIndicator — a labeled delta with period context.
+ */
+import type { SxProps, Theme } from '@mui/material';
+import type { StatusSize } from '../StatusIndicator';
+/**
+ * Pre-set period labels — covers the most common comparison windows.
+ */
+export type HistoricalPeriod = 'prior-day' | 'prior-week' | 'prior-month' | 'prior-quarter' | 'prior-year' | 'prior-period';
+/**
+ * Display density.
+ */
+export type HistoricalDensity = 'compact' | 'comfortable';
+/**
+ * Props for HistoricalDataIndicator.
+ *
+ * Combines `DifferentialIndicator` (delta + arrow) with a "vs <period>" label
+ * to make the comparison window explicit. Use this when a raw delta would be
+ * ambiguous about its timeframe.
+ */
+export interface HistoricalDataIndicatorProps {
+    /** Numeric delta (positive or negative). 0 renders the "flat" state. */
+    value: number;
+    /** Render the value as a percentage (appends "%"). Default `true`. */
+    percentage?: boolean;
+    /** Render the value as currency. Mutually exclusive with `percentage`. */
+    currency?: string;
+    /** Number of decimal places shown. Default `1`. */
+    decimals?: number;
+    /**
+     * Pre-set comparison period label. Use `periodLabel` instead for custom text.
+     */
+    period?: HistoricalPeriod;
+    /**
+     * Custom comparison label — overrides `period`. Useful for "vs Q3 baseline",
+     * "vs target", etc.
+     */
+    periodLabel?: string;
+    /** Optional raw values shown after the period label (e.g. "1,284 → 1,310"). */
+    comparison?: string;
+    /** Show the trend arrow before the delta. Default `true`. */
+    showIcon?: boolean;
+    /** Indicator size. Default `medium`. */
+    size?: StatusSize;
+    /** Display density — `compact` hides the period label on small screens. */
+    density?: HistoricalDensity;
+    /**
+     * Invert the semantic meaning of up/down. Set `true` when an *increase* is
+     * negative (e.g. error rate, churn) so the arrow still uses the correct color.
+     * Default `false`.
+     */
+    invertPolarity?: boolean;
+    /** sx overrides for the root container. */
+    sx?: SxProps<Theme>;
+    /** Optional explicit aria-label. Falls back to a sensible default. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/HistoricalDataIndicator/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,YAAY,GACZ,aAAa,GACb,eAAe,GACf,YAAY,GACZ,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B;IAC3C,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/components/InsightCard/InsightCard.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview InsightCard — severity-tinted tile that surfaces a single risk, anomaly, or recommendation.
+ *
+ * Composes existing primitives — MUI Card, `IconIndicator` from StatusIndicator,
+ * and semantic tokens — so visual weight matches the rest of the system. Severity
+ * colors come from the active MUI theme so light/dark mode + Trinity overrides
+ * track automatically.
+ *
+ * @module components/InsightCard
+ * @example
+ * ```tsx
+ *  import { InsightCard } from '@trinityui/design-system';
+ *
+ *  <InsightCard
+ *    severity="high"
+ *    eyebrow="Compliance · Q3"
+ *    title="3 sites missed the data-freshness SLA"
+ *    description="Mean latency drifted 18% above target this week."
+ *    actions={<Button size="small">View affected sites</Button>}
+ *  />
+ * ```
+ */
+import * as React from 'react';
+import type { InsightCardProps } from './types';
+export declare const InsightCard: React.ForwardRefExoticComponent<InsightCardProps & React.RefAttributes<HTMLDivElement>>;
+export default InsightCard;
+//# sourceMappingURL=InsightCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InsightCard.d.ts","sourceRoot":"","sources":["../../../src/components/InsightCard/InsightCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAkB/B,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AA+BjE,eAAO,MAAM,WAAW,yFAuKvB,CAAC;AAEF,eAAe,WAAW,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/InsightCard/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Types for InsightCard — severity-tinted tile that surfaces a single risk, anomaly, or recommendation.
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material';
+/**
+ * Severity level. Maps to MUI palette tokens at render time so dark mode and
+ * Trinity theme overrides flow through.
+ *
+ * - `critical` — hard escalation, draws strongest visual weight
+ * - `high` — needs attention this period
+ * - `medium` — keep an eye on it
+ * - `low` — positive / nominal observation
+ * - `info` — neutral informational insight
+ */
+export type InsightSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+/**
+ * Visual emphasis. `tinted` (default) draws a subtle severity-colored
+ * background; `outlined` swaps to a colored left rail + neutral surface for
+ * dense grids where multiple tinted cards would overwhelm.
+ */
+export type InsightVariant = 'tinted' | 'outlined';
+/**
+ * Props for InsightCard.
+ *
+ * Composes MUI Card with the existing `IconIndicator` primitive from
+ * StatusIndicator — no parallel severity rendering paths.
+ */
+export interface InsightCardProps {
+    /** Risk / severity level. Drives icon, color, and accent. */
+    severity: InsightSeverity;
+    /** Short title — should fit on 1–2 lines. */
+    title: string;
+    /** Body text — 1–3 sentence summary of the insight. */
+    description?: string;
+    /**
+     * Optional eyebrow above the title (e.g. "Compliance · Q3").
+     *
+     * Accepts a string or any ReactNode. Pass JSX (e.g. an `AILabel` + text)
+     * when the eyebrow needs to mark the insight as AI-generated.
+     */
+    eyebrow?: ReactNode;
+    /** Optional metric / numeric value rendered prominently above the title. */
+    value?: string;
+    /** Optional `HistoricalDataIndicator` or other delta component shown beside the value. */
+    delta?: ReactNode;
+    /** Action slot — render `Button`s or links here. */
+    actions?: ReactNode;
+    /** Visual variant. Default `tinted`. */
+    variant?: InsightVariant;
+    /** When true, swaps card to a clickable surface with hover/focus affordance. */
+    interactive?: boolean;
+    /** Called when the card itself is clicked (requires `interactive`). */
+    onClick?: () => void;
+    /** Called when the dismiss control is clicked. If omitted, no dismiss button is shown. */
+    onDismiss?: () => void;
+    /** sx overrides for the root Card. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override for the card root. */
+    ariaLabel?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/InsightCard/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;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9E;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,QAAQ,EAAE,eAAe,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,oDAAoD;IACpD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sCAAsC;IACtC,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview NotificationCenter — bell-button + popover surfacing recent
+ * notifications with read/unread + per-item actions.
+ *
+ * Visual pattern: a 40×40 IconButton with notification badge in app chrome;
+ * clicking opens a popover anchored bottom-right. The popover contains a
+ * header ("Notifications" + "Mark all as read"), a scrollable list of
+ * NotificationItem rows, and an optional footer (e.g. "View all").
+ *
+ * Severity colors come from `theme.palette.<severity>.main` so light/dark mode
+ * and Trinity theme overrides flow through correctly.
+ *
+ * @module components/NotificationCenter
+ * @example
+ * ```tsx
+ *  import { NotificationCenter } from '@trinityui/design-system';
+ *
+ *  <NotificationCenter
+ *    notifications={items}
+ *    onMarkAsRead={(id) => acknowledge(id)}
+ *    onMarkAllRead={() => acknowledgeAll()}
+ *    footerAction={<Button size="small">View all</Button>}
+ *  />
+ * ```
+ */
+import * as React from 'react';
+import type { NotificationCenterProps } from './types';
+export declare const NotificationCenter: React.ForwardRefExoticComponent<NotificationCenterProps & React.RefAttributes<HTMLButtonElement>>;
+export default NotificationCenter;
+export declare function NotificationCenterLoading(): React.ReactElement;
+//# sourceMappingURL=NotificationCenter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationCenter.d.ts","sourceRoot":"","sources":["../../../src/components/NotificationCenter/NotificationCenter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA4B/B,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AAkLjB,eAAO,MAAM,kBAAkB,mGA6L7B,CAAC;AAEH,eAAe,kBAAkB,CAAC;AAIlC,wBAAgB,yBAAyB,IAAI,KAAK,CAAC,YAAY,CAM9D"}

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

@@ -0,0 +1,9 @@
+/**
+ * @internal
+ * NotificationCenter barrel.
+ *
+ * PUBLIC API: Import from '@trinityui/design-system' instead.
+ */
+export { NotificationCenter, NotificationCenterLoading, default as NotificationCenterDefault, } from './NotificationCenter';
+export type { NotificationCenterProps, NotificationItem, NotificationSeverity, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/NotificationCenter/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,OAAO,IAAI,yBAAyB,GACrC,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,SAAS,CAAC"}