@siyahi/ui 0.1.9-next.2 → 0.1.9-next.20

package/agents/report-rules.json

@@ -0,0 +1,7 @@
+[
+  "Never paint html or body beyond the base styles report.css sets.",
+  "Fluid width. No outer card and no banner title.",
+  "A panel with its own background gets 16px padding and var(--radius).",
+  "Charts get fixed pixel heights.",
+  "Never use 100vh."
+]

package/dist/components/registry/charts/bar-chart-card.js

@@ -1,39 +1,46 @@
 "use client";
-import { ChartFrame } from "../../../lib/chart-frame.js";
+import { ChartFrame, seriesFill } from "../../../lib/chart-frame.js";
 import { jsx } from "react/jsx-runtime";
 import { Bar, BarChart, Cell } from "recharts";
 //#region src/components/registry/charts/bar-chart-card.tsx
+const DOWN_FROM_ZERO = ["auto", 0];
 /** Values over an ordered axis as bars: one series, or several grouped or stacked. */
 function BarChartCard({ stacked = false, selected = null, onSelect, ...props }) {
 	return /* @__PURE__ */ jsx(ChartFrame, {
 		chart: BarChart,
 		...props,
+		yDomain: props.yDomain ?? (props.data.some((row) => props.series.some(({ key }) => Number(row[key]) > 0)) ? void 0 : DOWN_FROM_ZERO),
 		stackOffset: stacked ? "sign" : void 0,
-		children: props.series.map(({ key, color, negativeColor }, index) => /* @__PURE__ */ jsx(Bar, {
-			dataKey: key,
-			fill: color,
-			stackId: stacked ? "stack" : void 0,
-			radius: !stacked ? 2 : index === props.series.length - 1 ? props.horizontal ? [
-				0,
-				2,
-				2,
-				0
-			] : [
-				2,
-				2,
-				0,
-				0
-			] : 0,
-			className: onSelect ? "cursor-pointer" : void 0,
-			onClick: onSelect && ((bar) => {
-				const value = bar.payload?.[props.xKey];
-				if (value !== void 0) onSelect(value === selected ? null : value);
-			}),
-			children: (negativeColor || selected !== null) && props.data.map((row, i) => /* @__PURE__ */ jsx(Cell, {
-				fill: negativeColor && Number(row[key]) < 0 ? negativeColor : color,
-				fillOpacity: selected === null || row[props.xKey] === selected ? 1 : .35
-			}, i))
-		}, key))
+		onClick: onSelect ? ({ activeTooltipIndex, isTooltipActive }) => {
+			if (!isTooltipActive || activeTooltipIndex == null) return;
+			const row = props.data[Number(activeTooltipIndex)];
+			if (row) onSelect(row[props.xKey] === selected ? null : row[props.xKey]);
+		} : void 0,
+		children: props.series.map((item, index) => {
+			const { key, label, color, negativeColor } = item;
+			return /* @__PURE__ */ jsx(Bar, {
+				dataKey: key,
+				name: label,
+				fill: seriesFill(item, props.data),
+				maxBarSize: props.horizontal ? 24 : void 0,
+				stackId: stacked ? "stack" : void 0,
+				radius: !stacked ? 2 : index === props.series.length - 1 ? props.horizontal ? [
+					0,
+					2,
+					2,
+					0
+				] : [
+					2,
+					2,
+					0,
+					0
+				] : 0,
+				children: (negativeColor || selected !== null) && props.data.map((row, i) => /* @__PURE__ */ jsx(Cell, {
+					fill: negativeColor && Number(row[key]) < 0 ? negativeColor : color,
+					fillOpacity: selected === null || row[props.xKey] === selected ? 1 : .35
+				}, i))
+			}, key);
+		})
 	});
 }
 //#endregion

package/dist/components/registry/dashboard-01/section-cards.d.ts

@@ -6,6 +6,8 @@ export interface SectionCard {
   value: React$1.ReactNode;
   /** Outline badge, top right; usually a <Delta />. */
   badge?: React$1.ReactNode;
+  /** A small chart under the value, usually a <Sparkline /> of the recent run. */
+  trend?: React$1.ReactNode;
   /** Bold first footer line. */
   headline?: React$1.ReactNode;
   /** Muted second footer line. */

package/dist/components/registry/dashboard-01/section-cards.js

@@ -1,7 +1,8 @@
 "use client";
 import { Badge } from "../../ui/badge.js";
-import { Card, CardAction, CardDescription, CardFooter, CardHeader, CardTitle } from "../../ui/card.js";
+import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "../../ui/card.js";
 import { cn } from "../../../lib/utils.js";
+import { useSurface } from "../../siyahi/siyahi-provider.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
 //#region src/components/registry/dashboard-01/section-cards.tsx
@@ -13,43 +14,49 @@ const COLUMNS = {
 	6: "@3xl/main:grid-cols-3"
 };
 function SectionCards({ items, selected, onSelect }) {
+	const ruled = useSurface() === "ruled";
 	return /* @__PURE__ */ jsx("div", {
-		className: "@container/main",
+		className: cn("@container/main", ruled && "overflow-hidden border-y"),
 		children: /* @__PURE__ */ jsx("div", {
-			className: cn("grid grid-cols-1 gap-4", COLUMNS[items.length] ?? COLUMNS[4]),
-			children: items.map((item) => /* @__PURE__ */ jsxs(Card, {
-				className: cn("@container/card", onSelect && "relative", item.label === selected && "ring-2 ring-primary!", onSelect && item.disabled && "opacity-60"),
-				children: [
-					onSelect && /* @__PURE__ */ jsx("button", {
-						type: "button",
-						"aria-label": item.label,
-						"aria-pressed": item.label === selected,
-						disabled: item.disabled,
-						onClick: () => onSelect(item.label),
-						className: "absolute inset-0 z-10 rounded-4xl outline-none focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:ring-inset"
-					}),
-					/* @__PURE__ */ jsxs(CardHeader, { children: [
-						/* @__PURE__ */ jsx(CardDescription, { children: item.label }),
-						/* @__PURE__ */ jsx(CardTitle, {
-							className: "text-2xl font-semibold tabular-nums @[250px]/card:text-3xl",
-							children: item.value
+			className: cn("grid grid-cols-1", ruled ? "-mt-px -ml-px" : "gap-4", COLUMNS[items.length] ?? COLUMNS[4]),
+			children: items.map((item) => /* @__PURE__ */ jsx("div", {
+				"data-slot": "section-card",
+				className: cn("min-w-0", ruled && "border-t border-l"),
+				children: /* @__PURE__ */ jsxs(Card, {
+					className: cn("@container/card h-full [--card-spacing:--spacing(3)]", onSelect && "relative", item.label === selected && "ring-2 ring-primary!", item.label === selected && ruled && "ring-inset", onSelect && item.disabled && "opacity-60"),
+					children: [
+						onSelect && /* @__PURE__ */ jsx("button", {
+							type: "button",
+							"aria-label": item.label,
+							"aria-pressed": item.label === selected,
+							disabled: item.disabled,
+							onClick: () => onSelect(item.label),
+							className: "absolute inset-0 z-10 rounded-[inherit] outline-none focus-visible:ring-3 focus-visible:ring-ring/50 focus-visible:ring-inset"
 						}),
-						item.badge && /* @__PURE__ */ jsx(CardAction, { children: /* @__PURE__ */ jsx(Badge, {
-							variant: "outline",
-							children: item.badge
-						}) })
-					] }),
-					(item.headline || item.detail) && /* @__PURE__ */ jsxs(CardFooter, {
-						className: "flex-col items-start gap-1.5 text-sm",
-						children: [item.headline && /* @__PURE__ */ jsx("div", {
-							className: "line-clamp-1 flex gap-2 font-medium",
-							children: item.headline
-						}), item.detail && /* @__PURE__ */ jsx("div", {
-							className: "text-muted-foreground",
-							children: item.detail
-						})]
-					})
-				]
+						/* @__PURE__ */ jsxs(CardHeader, { children: [
+							/* @__PURE__ */ jsx(CardDescription, { children: item.label }),
+							/* @__PURE__ */ jsx(CardTitle, {
+								className: "text-2xl font-semibold tabular-nums",
+								children: item.value
+							}),
+							item.badge && /* @__PURE__ */ jsx(CardAction, { children: /* @__PURE__ */ jsx(Badge, {
+								variant: "outline",
+								children: item.badge
+							}) })
+						] }),
+						item.trend && /* @__PURE__ */ jsx(CardContent, { children: item.trend }),
+						(item.headline || item.detail) && /* @__PURE__ */ jsxs(CardFooter, {
+							className: "flex-col items-start gap-1 text-sm",
+							children: [item.headline && /* @__PURE__ */ jsx("div", {
+								className: "flex flex-wrap gap-2 font-medium",
+								children: item.headline
+							}), item.detail && /* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground",
+								children: item.detail
+							})]
+						})
+					]
+				})
 			}, item.label))
 		})
 	});

package/dist/components/registry/dashboardcn/bar-list.js

@@ -1,15 +1,16 @@
-import { useLocale } from "../../siyahi/siyahi-provider.js";
 import { cn } from "../../../lib/utils.js";
+import { useLocale } from "../../siyahi/siyahi-provider.js";
 import { pct } from "../../../lib/format.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React$1 from "react";
 //#region src/components/registry/dashboardcn/bar-list.tsx
 function BarList({ data, valueFormatter, sortOrder = "descending", color = "var(--chart-1)", showPercentage = false, max: scale, onItemClick, className, ...props }) {
 	const locale = useLocale();
-	const format = valueFormatter ?? ((value) => new Intl.NumberFormat(locale.numberLocale, {
+	const defaultFormat = React$1.useMemo(() => new Intl.NumberFormat(locale.numberLocale, {
 		notation: "compact",
 		maximumFractionDigits: 1
-	}).format(value));
+	}).format, [locale.numberLocale]);
+	const format = valueFormatter ?? defaultFormat;
 	const items = React$1.useMemo(() => {
 		if (sortOrder === "none") return data;
 		const sorted = [...data].sort((a, b) => a.value - b.value);
@@ -19,7 +20,7 @@ function BarList({ data, valueFormatter, sortOrder = "descending", color = "var(
 	const total = items.reduce((sum, item) => sum + item.value, 0);
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "bar-list",
-		className: cn("flex flex-col gap-1.5", className),
+		className: cn("@container/bar-list flex flex-col gap-1.5", className),
 		...props,
 		children: items.map((item) => {
 			const width = max > 0 ? item.value / max * 100 : 0;
@@ -28,13 +29,13 @@ function BarList({ data, valueFormatter, sortOrder = "descending", color = "var(
 			const Label = item.href ? "a" : onItemClick ? "button" : "div";
 			return /* @__PURE__ */ jsxs("div", {
 				"data-slot": "bar-list-row",
-				className: "flex items-center gap-3 text-sm",
+				className: "flex items-center gap-3 text-sm @max-sm/bar-list:items-start",
 				children: [/* @__PURE__ */ jsxs("div", {
-					className: "relative flex h-8 min-w-0 flex-1 items-center",
+					className: "relative flex h-8 min-w-0 flex-1 items-center @max-sm/bar-list:h-auto @max-sm/bar-list:min-h-8 @max-sm/bar-list:items-start @max-sm/bar-list:pb-3",
 					children: [
 						/* @__PURE__ */ jsx("div", {
 							"aria-hidden": "true",
-							className: "absolute inset-y-0 left-0 rounded-md transition-[width] duration-300",
+							className: "absolute inset-y-0 left-0 rounded-md transition-[width] duration-300 @max-sm/bar-list:inset-y-auto @max-sm/bar-list:bottom-0 @max-sm/bar-list:h-1.5",
 							style: {
 								width: `${width}%`,
 								backgroundColor: `color-mix(in oklab, ${color} 20%, transparent)`
@@ -51,7 +52,7 @@ function BarList({ data, valueFormatter, sortOrder = "descending", color = "var(
 								className: "text-muted-foreground shrink-0 [&>svg]:size-4",
 								children: item.icon
 							}) : null, /* @__PURE__ */ jsx("span", {
-								className: "truncate",
+								className: "truncate @max-sm/bar-list:whitespace-normal",
 								children: item.name
 							})]
 						}),

package/dist/components/registry/dashboardcn/distribution-bar.js

@@ -1,5 +1,5 @@
-import { useLocale } from "../../siyahi/siyahi-provider.js";
 import { cn } from "../../../lib/utils.js";
+import { useLocale } from "../../siyahi/siyahi-provider.js";
 import { pct } from "../../../lib/format.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";

package/dist/components/registry/dashboardcn/kpi-row-card.d.ts

@@ -0,0 +1,29 @@
+import { Card } from "../../ui/card.js";
+import * as React$1 from "react";
+//#region src/components/registry/dashboardcn/kpi-row-card.d.ts
+export interface MetricStripItem {
+  /** Muted label above the figure. */
+  label: string;
+  /** The figure, formatted by the page: money(4512300). */
+  value: React$1.ReactNode;
+  /** The signed change, drawn as a Delta under the figure; its sign colours the trend. For "pct", a fraction. */
+  change?: number;
+  changeFormat?: "pct" | "money";
+  /** Muted words after the change, such as "vs last month". */
+  note?: React$1.ReactNode;
+  /** Recent values, oldest first, drawn as a sparkline beside the figure. */
+  trend?: number[];
+}
+export interface MetricStripProps extends Omit<React$1.ComponentProps<typeof Card>, "title"> {
+  title?: React$1.ReactNode;
+  description?: React$1.ReactNode;
+  /** A range toggle, top right, that changes every figure. */
+  action?: React$1.ReactNode;
+  items: MetricStripItem[];
+  /** Lines under the strip, such as what the figures cover. */
+  footer?: React$1.ReactNode;
+}
+/** A card holding a row of small figures, each with its change and a sparkline: more numbers in less room than stat tiles. */
+declare function MetricStrip({ title, description, action, items, footer, className, ...props }: MetricStripProps): React$1.JSX.Element;
+//#endregion
+export { MetricStrip };

package/dist/components/registry/dashboardcn/kpi-row-card.js

@@ -0,0 +1,81 @@
+import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "../../ui/card.js";
+import { cn } from "../../../lib/utils.js";
+import { Delta } from "../../siyahi/delta.js";
+import { Sparkline } from "./sparkline.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import "react";
+//#region src/components/registry/dashboardcn/kpi-row-card.tsx
+const COLUMNS = {
+	1: "basis-full",
+	2: "basis-full @2xs/strip:basis-1/2",
+	3: "basis-full @lg/strip:basis-1/3",
+	4: "basis-full @2xs/strip:basis-1/2 @3xl/strip:basis-1/4",
+	5: "basis-full @2xs/strip:basis-1/2 @3xl/strip:basis-1/5",
+	6: "basis-full @2xs/strip:basis-1/2 @xl/strip:basis-1/3 @5xl/strip:basis-1/6",
+	8: "basis-full @2xs/strip:basis-1/2 @3xl/strip:basis-1/4 @7xl/strip:basis-1/8"
+};
+function trendColor(change) {
+	if (change === void 0) return "var(--chart-1)";
+	if (change > 0) return "var(--positive)";
+	if (change < 0) return "var(--negative)";
+	return "var(--muted-foreground)";
+}
+/** A card holding a row of small figures, each with its change and a sparkline: more numbers in less room than stat tiles. */
+function MetricStrip({ title, description, action, items, footer, className, ...props }) {
+	const columns = COLUMNS[Math.min(items.length, 8)] ?? COLUMNS[8];
+	return /* @__PURE__ */ jsxs(Card, {
+		className: cn("gap-4", className),
+		...props,
+		children: [
+			(title || description || action) && /* @__PURE__ */ jsxs(CardHeader, { children: [
+				title && /* @__PURE__ */ jsx(CardTitle, { children: title }),
+				description && /* @__PURE__ */ jsx(CardDescription, { children: description }),
+				action && /* @__PURE__ */ jsx(CardAction, { children: action })
+			] }),
+			/* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("div", {
+				"data-slot": "metric-strip",
+				className: "@container/strip -mx-4 -my-3 overflow-hidden",
+				children: /* @__PURE__ */ jsx("div", {
+					className: "-mt-px -ml-px flex flex-wrap",
+					children: items.map((item) => /* @__PURE__ */ jsxs("div", {
+						"data-slot": "metric-strip-item",
+						className: cn("flex min-w-0 flex-col gap-1 border-t border-l px-4 py-3", columns),
+						children: [/* @__PURE__ */ jsx("div", {
+							className: "truncate text-xs text-muted-foreground",
+							children: item.label
+						}), /* @__PURE__ */ jsxs("div", {
+							className: "flex flex-wrap items-end justify-between gap-x-3 gap-y-1",
+							children: [/* @__PURE__ */ jsxs("div", {
+								className: "flex min-w-0 flex-col gap-0.5",
+								children: [/* @__PURE__ */ jsx("div", {
+									className: "text-xl font-semibold tracking-tight tabular-nums",
+									children: item.value
+								}), (item.change !== void 0 || item.note) && /* @__PURE__ */ jsxs("div", {
+									className: "flex flex-wrap items-center gap-x-1.5 text-xs",
+									children: [item.change !== void 0 && /* @__PURE__ */ jsx(Delta, {
+										value: item.change,
+										format: item.changeFormat
+									}), item.note && /* @__PURE__ */ jsx("span", {
+										className: "text-muted-foreground",
+										children: item.note
+									})]
+								})]
+							}), item.trend && item.trend.length > 1 && /* @__PURE__ */ jsx(Sparkline, {
+								data: item.trend,
+								variant: "line",
+								color: trendColor(item.change),
+								className: "h-8 w-16 shrink-0"
+							})]
+						})]
+					}, item.label))
+				})
+			}) }),
+			footer && /* @__PURE__ */ jsx(CardFooter, {
+				className: "flex-col items-start gap-2 text-sm",
+				children: footer
+			})
+		]
+	});
+}
+//#endregion
+export { MetricStrip };

package/dist/components/registry/dashboardcn/sparkline.d.ts

@@ -0,0 +1,18 @@
+import { ChartColor } from "../../../lib/chart-series.js";
+import * as React$1 from "react";
+//#region src/components/registry/dashboardcn/sparkline.d.ts
+export interface SparklineProps extends React$1.ComponentProps<"div"> {
+  /** Series to plot, oldest first. */
+  data: number[];
+  variant?: "area" | "line";
+  /** A chart slot, or var(--positive) or var(--negative) for a gain or a loss. Defaults to var(--chart-1). */
+  color?: ChartColor;
+  curve?: "monotone" | "linear" | "step";
+  strokeWidth?: number;
+  /** Animate after hydration and when data changes. Respects reduced motion. */
+  animate?: boolean;
+  animationDuration?: number;
+}
+declare function Sparkline({ data, variant, color, curve, strokeWidth, animate, animationDuration, className, ...props }: SparklineProps): React$1.JSX.Element;
+//#endregion
+export { Sparkline };

package/dist/components/registry/dashboardcn/sparkline.js

@@ -0,0 +1,95 @@
+import { cn } from "../../../lib/utils.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as React$1 from "react";
+import { Area, AreaChart, Line, LineChart, ResponsiveContainer, YAxis } from "recharts";
+//#region src/components/registry/dashboardcn/sparkline.tsx
+const reducedMotionQuery = "(prefers-reduced-motion: reduce)";
+function subscribeToReducedMotion(onChange) {
+	const query = window.matchMedia(reducedMotionQuery);
+	query.addEventListener("change", onChange);
+	return () => query.removeEventListener("change", onChange);
+}
+function getReducedMotionSnapshot() {
+	return window.matchMedia(reducedMotionQuery).matches;
+}
+function getReducedMotionServerSnapshot() {
+	return true;
+}
+function Sparkline({ data, variant = "area", color = "var(--chart-1)", curve = "monotone", strokeWidth = 1.5, animate = true, animationDuration = 500, className, ...props }) {
+	const id = React$1.useId();
+	const reducedMotion = React$1.useSyncExternalStore(subscribeToReducedMotion, getReducedMotionSnapshot, getReducedMotionServerSnapshot);
+	const animationActive = animate && !reducedMotion;
+	const points = React$1.useMemo(() => data.map((y, i) => ({
+		i,
+		y
+	})), [data]);
+	const margin = {
+		top: 2,
+		right: 0,
+		bottom: 2,
+		left: 0
+	};
+	const axis = /* @__PURE__ */ jsx(YAxis, {
+		hide: true,
+		domain: ["dataMin", "dataMax"]
+	});
+	return /* @__PURE__ */ jsx("div", {
+		"data-slot": "sparkline",
+		"aria-hidden": "true",
+		className: cn("h-10 w-full", className),
+		...props,
+		children: /* @__PURE__ */ jsx(ResponsiveContainer, {
+			width: "100%",
+			height: "100%",
+			children: variant === "line" ? /* @__PURE__ */ jsxs(LineChart, {
+				data: points,
+				margin,
+				children: [axis, /* @__PURE__ */ jsx(Line, {
+					type: curve,
+					dataKey: "y",
+					stroke: color,
+					strokeWidth,
+					dot: false,
+					isAnimationActive: animationActive,
+					animationDuration,
+					animationEasing: "ease-out"
+				})]
+			}) : /* @__PURE__ */ jsxs(AreaChart, {
+				data: points,
+				margin,
+				children: [
+					axis,
+					/* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("linearGradient", {
+						id,
+						x1: "0",
+						y1: "0",
+						x2: "0",
+						y2: "1",
+						children: [/* @__PURE__ */ jsx("stop", {
+							offset: "0%",
+							stopColor: color,
+							stopOpacity: .3
+						}), /* @__PURE__ */ jsx("stop", {
+							offset: "100%",
+							stopColor: color,
+							stopOpacity: 0
+						})]
+					}) }),
+					/* @__PURE__ */ jsx(Area, {
+						type: curve,
+						dataKey: "y",
+						stroke: color,
+						strokeWidth,
+						fill: `url(#${id})`,
+						dot: false,
+						isAnimationActive: animationActive,
+						animationDuration,
+						animationEasing: "ease-out"
+					})
+				]
+			})
+		})
+	});
+}
+//#endregion
+export { Sparkline };

package/dist/components/registry/heatmap/calendar-heatmap.js

@@ -1,4 +1,5 @@
 import { cn } from "../../../lib/utils.js";
+import { useHeatmapNavigation } from "../../../lib/heatmap-navigation.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment as Fragment$1, createContext, use, useMemo } from "react";
 import { differenceInCalendarDays, eachDayOfInterval, format, formatISO, getDay, getMonth, getYear, nextDay, parseISO, subWeeks } from "date-fns";
@@ -290,7 +291,7 @@ const CalendarHeatmap = ({ data, weekStart = 0, continuousMonths = true, hasEmpt
 		value: contextValue,
 		children: /* @__PURE__ */ jsx("div", {
 			"data-slot": "calendar-heatmap",
-			className: cn("flex w-max max-w-full flex-col gap-2 p-4", className),
+			className: cn("flex w-max max-w-full flex-col gap-2", className),
 			style: {
 				fontSize,
 				...style
@@ -349,6 +350,7 @@ const CalendarHeatmapBlock = ({ ref, activity, dayIndex, weekIndex, highlighted
 };
 CalendarHeatmapBlock.displayName = "CalendarHeatmapBlock";
 const CalendarHeatmapBody = ({ hideMonthLabels = false, hideWeekdayLabels = false, hideYearLabels = false, className, labelClassName, yearClassName, children, renderYearFooter, ...props }) => {
+	const navigation = useHeatmapNavigation();
 	const { yearRows, blockSize, blockWidth, blockMargin, labels, labelHeight, fontSize, weekStart, data } = useCalendarHeatmap();
 	const weekdayLabelWidth = hideWeekdayLabels ? 0 : 40;
 	const strokePadding = 3;
@@ -374,8 +376,13 @@ const CalendarHeatmapBody = ({ hideMonthLabels = false, hideWeekdayLabels = fals
 	const totalWidth = weekdayLabelWidth + Math.max(...rowData.map((r) => r.width)) + 6;
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "calendar-heatmap-body",
+		ref: navigation.ref,
 		className: cn("flex max-w-full flex-col gap-6 overflow-x-auto overflow-y-hidden py-4", className),
 		...props,
+		onKeyDown: (event) => {
+			props.onKeyDown?.(event);
+			if (!event.defaultPrevented) navigation.onKeyDown(event);
+		},
 		children: rowData.map(({ yearRow, height, monthLabels, yearTotalCount }) => /* @__PURE__ */ jsxs("div", { children: [
 			!hideYearLabels && /* @__PURE__ */ jsx("div", {
 				className: cn("mb-2 text-muted-foreground", yearClassName),

package/dist/components/registry/heatmap/status-heatmap.js

@@ -1,4 +1,5 @@
 import { cn } from "../../../lib/utils.js";
+import { useHeatmapNavigation } from "../../../lib/heatmap-navigation.js";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Fragment as Fragment$1, createContext, use, useMemo } from "react";
 import { format } from "date-fns";
@@ -155,7 +156,7 @@ const StatusHeatmap = ({ data, dateFormat = "MMM d", blockSize = 40, blockMargin
 		value: contextValue,
 		children: /* @__PURE__ */ jsx("div", {
 			"data-slot": "status-heatmap",
-			className: cn("flex w-max max-w-full flex-col gap-2 p-4", className),
+			className: cn("flex w-max max-w-full flex-col gap-2", className),
 			style: {
 				fontSize,
 				...style
@@ -214,6 +215,7 @@ const StatusHeatmapBlock = ({ ref, activity, dayIndex, highlighted = false, onCe
 };
 StatusHeatmapBlock.displayName = "StatusHeatmapBlock";
 const StatusHeatmapBody = ({ hideDateLabels = false, labelInterval = 30, className, labelClassName, children, ...props }) => {
+	const navigation = useHeatmapNavigation();
 	const { data, dates, width, height, blockWidth, blockMargin, fontSize, dateFormat, locale, labels } = useStatusHeatmap();
 	const activityMap = useMemo(() => {
 		const map = /* @__PURE__ */ new Map();
@@ -234,8 +236,13 @@ const StatusHeatmapBody = ({ hideDateLabels = false, labelInterval = 30, classNa
 	const labelHeight = hideDateLabels ? 0 : labelFontSize * 2;
 	return /* @__PURE__ */ jsx("div", {
 		"data-slot": "status-heatmap-body",
+		ref: navigation.ref,
 		className: cn("max-w-full overflow-x-auto overflow-y-hidden", className),
 		...props,
+		onKeyDown: (event) => {
+			props.onKeyDown?.(event);
+			if (!event.defaultPrevented) navigation.onKeyDown(event);
+		},
 		children: /* @__PURE__ */ jsxs("svg", {
 			role: "img",
 			"aria-label": labels.heatmapLabel ?? "Status heatmap",

package/dist/components/registry/heatmap/weekday-heatmap.d.ts

@@ -36,6 +36,10 @@ export type ColorConfig = {
 export type WeekdayHeatmapProps = HTMLAttributes<HTMLDivElement> & {
   data: WeekdayHourlyActivity[];
   weekStart?: Day;
+  /** Displayed hours, in order; defaults to the full day. */
+  hours?: readonly WeekdayHour[];
+  /** Displayed days, in order; defaults to the full week from weekStart. */
+  weekdays?: readonly WeekdayIndex[];
   use12Hour?: boolean;
   blockSize?: number;
   blockMargin?: number;
@@ -86,7 +90,7 @@ export type WeekdayHeatmapProps = HTMLAttributes<HTMLDivElement> & {
  * @param extraRow - Appends an aggregated row below the grid. `compute` receives all activities and must return 24 values (one per hour). Rendered through `renderExtraRow` on the body, or falls back to `children`.
  * @param extraColumn - Appends an aggregated column to the right of the grid. `compute` receives all activities and must return 7 values indexed by weekday 0–6. Rendered through `renderExtraColumn` on the body, or falls back to `children`.
  */
-export declare const WeekdayHeatmap: ({ data, weekStart, use12Hour, blockSize, blockMargin, blockRadius, blockAspectRatio, levels: levelsProp, isNormalized, colors, locale, labels: labelsProp, fontSize, emptyState, totalCount: totalCountProp, extraRow, extraColumn, style, className, children, ...props }: WeekdayHeatmapProps) => string | number | bigint | true | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null;
+export declare const WeekdayHeatmap: ({ data, weekStart, hours, weekdays: displayedWeekdays, use12Hour, blockSize, blockMargin, blockRadius, blockAspectRatio, levels: levelsProp, isNormalized, colors, locale, labels: labelsProp, fontSize, emptyState, totalCount: totalCountProp, extraRow, extraColumn, style, className, children, ...props }: WeekdayHeatmapProps) => string | number | bigint | true | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null;
 export type WeekdayHeatmapBlockProps = HTMLAttributes<SVGRectElement> & {
   activity: WeekdayHourlyActivityWithLevel;
   extra?: "row" | "column";
@@ -97,7 +101,7 @@ export type WeekdayHeatmapBlockProps = HTMLAttributes<SVGRectElement> & {
 };
 export declare function WeekdayHeatmapBlock({ ref, activity, extra, highlighted, onCellClick, onCellHover, onClick, onKeyDown, onMouseEnter, onMouseLeave, className, style: styleProp, ...props }: WeekdayHeatmapBlockProps & {
   ref?: React.RefObject<SVGRectElement | null>;
-}): import("react").JSX.Element;
+}): import("react").JSX.Element | null;
 export declare namespace WeekdayHeatmapBlock {
   var displayName: string;
 }