learning_ai_common_plat/packages/data-viz/src/BarSparkline.tsx
saravanakumardb1 d082480849 feat(packages): Wave 4 motion + Wave 5b data-viz + Wave 7 notifications-ui
Three new product-agnostic packages unlock visible elegance lifts
across every product:

═══════════════════════════════════════════════════════════════════════
@bytelyst/motion@0.1.0 — Wave 4 elegance primitives  (2.21 KB / 8 KB)
═══════════════════════════════════════════════════════════════════════

  <Reveal>          — IntersectionObserver-based fade/slide entry,
                      6 directions, configurable spring + delay
  <StaggerList>     — sequenced reveal of children with per-item delay
  <NumberFlow>      — RAF-tweened number counter, cubic-out easing,
                      Intl-formatted, prefers-reduced-motion aware
  <TiltCard>        — 3D perspective tilt + cursor-tracking glare
                      overlay (single-element ref, no React rerenders)
  <ScrollProgress>  — fixed scroll-position bar (window or any element)

Plus exported `SPRINGS` (4 cubic-bezier presets) + `prefersReducedMotion`
helper. Every primitive accepts `disableMotion` for snapshot tests.

═══════════════════════════════════════════════════════════════════════
@bytelyst/data-viz@0.1.0 — Wave 5b viz primitives  (2.63 KB / 10 KB)
═══════════════════════════════════════════════════════════════════════

  <Sparkline>     — line trend with gradient fill + last-point marker
  <BarSparkline>  — discrete-bar mini-chart with max-bar highlight
  <KpiCard>       — label + headline + delta arrow + sparkline; supports
                    'goodWhen=lower' for latency/cost metrics
  <ProgressRing>  — circular progress with center content slot,
                    animated stroke-dashoffset
  <Heatmap>       — GitHub-style calendar grid with color-mix() intensity

All pure SVG / CSS — zero runtime dependencies.

═══════════════════════════════════════════════════════════════════════
@bytelyst/notifications-ui@0.1.0 — Wave 7 essentials (3.31 KB / 10 KB)
═══════════════════════════════════════════════════════════════════════

  <NotificationCenter>  — bell trigger + badge + dropdown panel with
                          All / Unread / Mentions tabs, outside-click
                          + Escape close, mark-all-read action
  <InboxItem>           — single row with unread dot, kind glyph,
                          relative timestamp, optional action buttons
  <BannerStack>         — top-of-page strip with maxVisible + +N more,
                          accent-bordered tone variants, dismissible
  <Announcement>        — inline 'What's new' pill (3 tone variants)

5 notification kinds (info/success/warning/danger/mention) + 5 banner
kinds (... + announcement gradient).

═══════════════════════════════════════════════════════════════════════
Quality gates
═══════════════════════════════════════════════════════════════════════
  All three packages: tsc --noEmit clean, build clean.
  Tests:    motion 16/16  ·  data-viz 14/14  ·  notifications-ui 17/17
  Bundles:  motion 2.21 KB  ·  data-viz 2.63 KB  ·  noti-ui 3.31 KB
  Budgets:  added to .size-limit.cjs (8/10/10 KB respectively)

Refs:
  learning_ai_uxui_web/docs/ROADMAP_2026.md
    §Wave 4 (Motion), §Wave 5b (Charts), §Wave 7 (Productisation)
  Decisions doc §13 (mobile-native = tokens-only) leaves room for these
    web-first packages to be the canonical surface
2026-05-27 13:08:30 -07:00

74 lines
1.8 KiB
TypeScript

import { useMemo, type CSSProperties } from 'react';
export interface BarSparklineProps {
data: number[];
width?: number;
height?: number;
color?: string;
/** Color for the maximum bar. Defaults to `color`. */
highlightMax?: string;
/** Spacing between bars as a fraction of bar width. Default 0.25. */
gap?: number;
ariaLabel?: string;
className?: string;
style?: CSSProperties;
}
/**
* `<BarSparkline>` — inline mini-bar chart. Pairs well with KPI cards
* where a line sparkline doesn't fit (e.g. discrete daily counts).
*/
export function BarSparkline({
data,
width = 120,
height = 36,
color = 'var(--bl-accent, #6366f1)',
highlightMax,
gap = 0.25,
ariaLabel,
className,
style,
}: BarSparklineProps) {
const { bars, maxIdx } = useMemo(() => {
if (data.length === 0) return { bars: [], maxIdx: -1 };
const max = Math.max(...data, 1);
const slot = width / data.length;
const barW = slot * (1 - gap);
const offset = slot * (gap / 2);
const maxIdx = data.indexOf(Math.max(...data));
const bars = data.map((v, i) => {
const h = Math.max(2, (v / max) * height);
return { x: i * slot + offset, y: height - h, w: barW, h };
});
return { bars, maxIdx };
}, [data, width, height, gap]);
const peak = highlightMax ?? color;
return (
<svg
data-testid="bl-bar-sparkline"
role="img"
aria-label={ariaLabel ?? 'Bar sparkline'}
width={width}
height={height}
viewBox={`0 0 ${width} ${height}`}
className={className}
style={style}
>
{bars.map((b, i) => (
<rect
key={i}
x={b.x}
y={b.y}
width={b.w}
height={b.h}
rx={1.5}
fill={i === maxIdx ? peak : color}
opacity={i === maxIdx ? 1 : 0.55}
/>
))}
</svg>
);
}