@arcfusionz/arc-analytic-ui 0.0.0

package/dist/components/ForecastCard/ForecastCard.js

@@ -0,0 +1,1029 @@
+import { ArcVegaChart } from "../../lib/vega/ArcVegaChart.js";
+import { arcEmbedOptions } from "../../lib/vega/embed.js";
+import { formatDate } from "../../lib/vega/formatters.js";
+import { useChartTokens } from "../../lib/vega/tokens.js";
+import { ArcTooltipRows, useArcTooltipHandler } from "../../lib/vega/tooltip.js";
+import { FORECAST_BOUNDARY_DATASET, FORECAST_INTERVAL_DATASET, FORECAST_LANDING_DATASET, FORECAST_PERIODS_DATASET, FORECAST_REFERENCE_DATASET, FORECAST_REGION_DATASET, FORECAST_TABLE_DATASET, buildForecastPlotSpec } from "./ForecastCard.chart.js";
+import { buildForecastBoundaryRows, buildForecastChartDescription, buildForecastDescription, buildForecastInsight, buildForecastLandingRows, buildForecastPeriodRows, buildForecastRegionRows, buildForecastTooltip, createForecastFormatters, deriveForecastCrossing, deriveForecastOutlook, deriveForecastProjection, deriveForecastState, forecastAxisGranularity, normalizeForecast, resolveForecastLabels } from "./ForecastCard.model.js";
+import { Fragment, forwardRef, useCallback, useEffect, useId, useMemo, useRef, useState } from "react";
+import { AILoader, Badge, Box, Button, HorizontalScroll, Popover, PopoverPopup, PopoverTitle, PopoverTrigger, Skeleton, SkeletonGroup, SystemState, Table, TableBody, TableCaption, TableCell, TableContainer, TableHead, TableHeader, TableRow, Tooltip, TooltipPopup, TooltipTrigger, cn } from "@arcfusionz/arc-primitive-ui";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/components/ForecastCard/ForecastCard.tsx
+const sizeStyles = {
+	sm: {
+		padding: "sm",
+		gap: "gap-2",
+		gapPx: 8,
+		label: "text-xs",
+		value: "text-2xl leading-8",
+		valueLinePx: 32,
+		unit: "text-xs",
+		body: "text-xs",
+		badge: "sm",
+		chip: "sm",
+		deltaLinePx: 20,
+		comparisonLinePx: 16,
+		plotHeight: 120,
+		keyLinePx: 20,
+		chipLinePx: 20,
+		insightLinePx: 22
+	},
+	md: {
+		padding: "md",
+		gap: "gap-3",
+		gapPx: 12,
+		label: "text-sm",
+		value: "text-3xl leading-9",
+		valueLinePx: 36,
+		unit: "text-sm",
+		body: "text-sm",
+		badge: "md",
+		chip: "sm",
+		deltaLinePx: 24,
+		comparisonLinePx: 20,
+		plotHeight: 160,
+		keyLinePx: 24,
+		chipLinePx: 22,
+		insightLinePx: 22
+	},
+	lg: {
+		padding: "lg",
+		gap: "gap-3",
+		gapPx: 12,
+		label: "text-sm",
+		value: "text-4xl leading-10",
+		valueLinePx: 40,
+		unit: "text-base",
+		body: "text-sm",
+		badge: "lg",
+		chip: "md",
+		deltaLinePx: 28,
+		comparisonLinePx: 20,
+		plotHeight: 200,
+		keyLinePx: 24,
+		chipLinePx: 24,
+		insightLinePx: 22
+	}
+};
+const GENERATED_INSIGHT_LINES = 3;
+const CUSTOM_INSIGHT_LINES = 2;
+const labelClasses = "min-w-0 font-sans font-medium text-muted-foreground";
+const valueClasses = "font-heading font-semibold tracking-tight text-foreground";
+const captionClasses = "font-sans text-xs text-muted-foreground";
+const polarityBadgeVariant = {
+	positive: "success",
+	negative: "destructive",
+	neutral: "neutral"
+};
+const outlookBadgeVariant = {
+	likely: "success",
+	uncertain: "warning",
+	unlikely: "destructive"
+};
+const changeTextClasses = {
+	positive: "text-chart-positive",
+	negative: "text-chart-negative",
+	neutral: "text-foreground"
+};
+const headerControlClasses = "size-6 min-w-0 text-muted-foreground hover:text-foreground";
+const panelStateClasses = "w-full max-w-none gap-3 px-3 py-4 [--artwork-box:4rem]";
+const X_AXIS_HEIGHT_PX = 24;
+const PX_PER_Y_TICK = 48;
+const MISSING_NAME = "Forecast";
+function InfoIcon(props) {
+	return /* @__PURE__ */ jsxs("svg", {
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		...props,
+		children: [/* @__PURE__ */ jsx("circle", {
+			cx: "12",
+			cy: "12",
+			r: "9"
+		}), /* @__PURE__ */ jsx("path", { d: "M12 11v5M12 8h.01" })]
+	});
+}
+function DeltaGlyph({ direction, ...props }) {
+	return /* @__PURE__ */ jsxs("svg", {
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2.5,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		...props,
+		children: [
+			direction === "up" && /* @__PURE__ */ jsx("path", { d: "M7 17 17 7M7 7h10v10" }),
+			direction === "down" && /* @__PURE__ */ jsx("path", { d: "M7 7 17 17M7 17h10V7" }),
+			direction === "flat" && /* @__PURE__ */ jsx("path", { d: "M5 12h14M13 6l6 6-6 6" })
+		]
+	});
+}
+/** The verdict's own glyph, so the chip never depends on its hue: a tick, a question, a cross. */
+function OutlookGlyph({ outlook, ...props }) {
+	return /* @__PURE__ */ jsxs("svg", {
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: 2.5,
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		"aria-hidden": "true",
+		...props,
+		children: [
+			outlook === "likely" && /* @__PURE__ */ jsx("path", { d: "m5 13 4 4L19 7" }),
+			outlook === "uncertain" && /* @__PURE__ */ jsx("path", { d: "M9 9a3 3 0 1 1 4 2.8V14M12 17.5v.01" }),
+			outlook === "unlikely" && /* @__PURE__ */ jsx("path", { d: "M6 6l12 12M18 6 6 18" })
+		]
+	});
+}
+/** Match the plot's mark shapes so their meaning never depends on colour alone. */
+function ForecastKey({ label, mark, color }) {
+	return /* @__PURE__ */ jsxs("span", {
+		className: "inline-flex min-w-0 items-center gap-1.5",
+		children: [/* @__PURE__ */ jsx("svg", {
+			width: "20",
+			height: "12",
+			viewBox: "0 0 20 12",
+			fill: "none",
+			"aria-hidden": "true",
+			className: "shrink-0",
+			style: { color },
+			children: mark === "interval" ? /* @__PURE__ */ jsx("rect", {
+				x: "1",
+				y: "2",
+				width: "18",
+				height: "8",
+				rx: "2",
+				fill: "currentColor",
+				opacity: "0.3"
+			}) : mark === "boundary" ? /* @__PURE__ */ jsx("line", {
+				x1: "10",
+				y1: "0",
+				x2: "10",
+				y2: "12",
+				stroke: "currentColor",
+				strokeWidth: 1,
+				strokeDasharray: "4 3"
+			}) : /* @__PURE__ */ jsx("line", {
+				x1: "2",
+				y1: "6",
+				x2: "18",
+				y2: "6",
+				stroke: "currentColor",
+				strokeWidth: mark === "target" ? 1.5 : 2,
+				strokeLinecap: "round",
+				strokeDasharray: mark === "forecast" ? "6 4" : mark === "target" ? "0 4" : void 0
+			})
+		}), /* @__PURE__ */ jsx("span", {
+			className: "min-w-0 truncate",
+			children: label
+		})]
+	});
+}
+/** A generated insight: words as text, values in bold. */
+function InsightText({ segments }) {
+	return /* @__PURE__ */ jsx(Fragment$1, { children: segments.map((segment, index) => typeof segment === "string" ? /* @__PURE__ */ jsx(Fragment, { children: segment }, index) : /* @__PURE__ */ jsx("strong", { children: segment.value }, index)) });
+}
+function useMergedRef(forwarded) {
+	const inner = useRef(null);
+	return [inner, useCallback((node) => {
+		inner.current = node;
+		if (typeof forwarded === "function") forwarded(node);
+		else if (forwarded) forwarded.current = node;
+	}, [forwarded])];
+}
+function usePlotWidth(ref, enabled) {
+	const [width, setWidth] = useState(0);
+	useEffect(() => {
+		if (!enabled) return;
+		const el = ref.current;
+		if (!el) return;
+		let frame = 0;
+		const measure = () => {
+			const next = Math.round(el.getBoundingClientRect().width);
+			setWidth((prev) => prev === next ? prev : next);
+		};
+		measure();
+		if (typeof ResizeObserver === "undefined") return;
+		const observer = new ResizeObserver(() => {
+			cancelAnimationFrame(frame);
+			frame = requestAnimationFrame(measure);
+		});
+		observer.observe(el);
+		return () => {
+			cancelAnimationFrame(frame);
+			observer.disconnect();
+		};
+	}, [ref, enabled]);
+	return width;
+}
+/**
+* A forecast panel for dashboards: the measured readings as a solid path, the
+* projection as the same path dashed, its prediction interval as a band opening
+* from the last reading, the boundary between measurement and projection marked
+* three ways, an optional target with the verdict only uncertainty can give
+* (likely / too close to call / unlikely), the landing as the headline, and
+* every loading, empty, error and stale state — layout-stable, with a generated
+* text equivalent and a period-by-period table in an info popover.
+*
+* Where `TrendCard` answers "what shape is this metric in", ForecastCard
+* answers "where is it heading, how sure are we, and does that clear the
+* target".
+*/
+const ForecastCard = forwardRef(({ label, name: nameProp, hint, actual, forecast, level, target, headline = "landing", deltaMode = "percent", goodDirection = "up", mark = "line", scale = "auto", format = "compact", formatValue, unit, plotHeight: plotHeightProp, axes = true, keys = true, region = true, labelLanding = false, granularity, insight, status = "ready", filtered = false, stale = false, updatedAt, updatedAtFormat = "day", onRetry, onClearFilters, size = "md", titleLevel = 3, locale, timeZone, labels: labelOverrides, description, action, defaultTableOpen = false, hideTableToggle = false, onEmbed, patchSpec, render, className, ...rest }, forwardedRef) => {
+	const labels = useMemo(() => resolveForecastLabels(labelOverrides), [labelOverrides]);
+	const sizes = sizeStyles[size];
+	const plotHeight = plotHeightProp ?? sizes.plotHeight + (axes ? X_AXIS_HEIGHT_PX : 0);
+	const name = nameProp ?? (typeof label === "string" ? label : MISSING_NAME);
+	const id = useId();
+	const headingId = `${id}-label`;
+	const descriptionId = `${id}-description`;
+	const hintId = `${id}-hint`;
+	const tableId = `${id}-table`;
+	const deltaExplanationId = `${id}-delta-explanation`;
+	const outlookExplanationId = `${id}-outlook-explanation`;
+	const [rootRef, setRootRef] = useMergedRef(forwardedRef);
+	const plotRef = useRef(null);
+	const [tableOpen, setTableOpen] = useState(defaultTableOpen);
+	const [popoverContainer, setPopoverContainer] = useState(null);
+	const tokens = useChartTokens(rootRef);
+	const summary = useMemo(() => tokens ? normalizeForecast(actual, forecast, {
+		granularity,
+		name,
+		color: tokens.emphasis
+	}) : null, [
+		tokens,
+		actual,
+		forecast,
+		granularity,
+		name
+	]);
+	const formatters = useMemo(() => createForecastFormatters({
+		format,
+		locale,
+		timeZone,
+		formatValue,
+		xType: summary?.xType ?? "temporal",
+		granularity: summary?.granularity ?? granularity ?? "day"
+	}), [
+		format,
+		locale,
+		timeZone,
+		formatValue,
+		summary,
+		granularity
+	]);
+	const projection = useMemo(() => deriveForecastProjection(summary, {
+		deltaMode,
+		goodDirection,
+		format,
+		locale,
+		percentagePoints: labels.percentagePoints,
+		formatters
+	}), [
+		summary,
+		deltaMode,
+		goodDirection,
+		format,
+		locale,
+		labels.percentagePoints,
+		formatters
+	]);
+	const outlook = useMemo(() => deriveForecastOutlook({
+		landing: summary?.landing ?? null,
+		target,
+		goodDirection
+	}), [
+		summary,
+		target,
+		goodDirection
+	]);
+	const crossing = useMemo(() => deriveForecastCrossing(summary, target, goodDirection), [
+		summary,
+		target,
+		goodDirection
+	]);
+	const hasReadings = (summary?.actualCount ?? 0) + (summary?.forecastCount ?? 0) > 0;
+	const hasData = (actual?.length ?? 0) + (forecast?.length ?? 0) > 0;
+	const state = deriveForecastState({
+		status,
+		hasValue: hasReadings,
+		hasData,
+		filtered
+	});
+	const showContent = state === "ready" || state === "refreshing";
+	const hasChart = summary != null && summary.periods.length >= 2 && hasReadings;
+	const insufficient = showContent && summary != null && !hasChart;
+	const hasTable = showContent && summary != null && summary.readings.length > 0;
+	const hasProjection = (summary?.forecastCount ?? 0) > 0;
+	const hasInterval = (summary?.intervalCount ?? 0) > 0;
+	const landing = summary?.landing ?? null;
+	const latest = summary?.latest ?? null;
+	const targetText = target != null ? formatters.formatValue(target) : null;
+	const levelText = level != null && Number.isFinite(level) ? labels.levelText(level) : null;
+	const landingIntervalText = landing ? formatters.formatInterval(landing.lower, landing.upper) : null;
+	const asOfDate = updatedAt == null ? null : updatedAt instanceof Date ? updatedAt : new Date(updatedAt);
+	const asOfValid = asOfDate != null && !Number.isNaN(asOfDate.getTime());
+	const asOfText = asOfValid ? typeof updatedAtFormat === "function" ? updatedAtFormat(asOfDate) : formatDate(asOfDate, {
+		granularity: updatedAtFormat,
+		locale,
+		timeZone
+	}) : void 0;
+	const cardDescription = description ?? buildForecastDescription({
+		name,
+		state,
+		headline,
+		summary,
+		projection,
+		outlook,
+		crossing,
+		target,
+		level,
+		formatters,
+		asOfText,
+		labels
+	});
+	const deltaExplanationRows = projection ? labels.deltaExplanation({
+		fromLabel: formatters.formatX(projection.from.x),
+		fromText: formatters.formatValue(projection.from.y),
+		toLabel: formatters.formatX(projection.to.x),
+		toText: formatters.formatValue(projection.to.y),
+		changeText: projection.delta.text,
+		secondaryText: projection.delta.secondaryText,
+		renderedMode: projection.delta.renderedMode,
+		direction: projection.delta.direction,
+		rangeText: landingIntervalText
+	}) : [];
+	const deltaExplanation = deltaExplanationRows.map(([key, value]) => `${key}: ${value}`).join(". ");
+	const outlookExplanation = outlook !== "none" && targetText && landing ? labels.outlookExplanation({
+		outlook,
+		target: targetText,
+		landing: formatters.formatValue(landing.y),
+		range: landingIntervalText,
+		horizon: formatters.formatX(landing.x)
+	}) : null;
+	const plotWidth = usePlotWidth(plotRef, showContent && hasChart);
+	const tooltipContent = useCallback(({ item }) => {
+		const raw = item.datum;
+		const datum = raw && "datum" in raw && raw.datum ? raw.datum : raw;
+		const x = datum && typeof datum === "object" && "x" in datum ? datum.x : void 0;
+		const model = buildForecastTooltip({
+			summary,
+			x,
+			target,
+			formatters,
+			labels
+		});
+		if (!model) return null;
+		const rows = [[labels.tablePeriod, model.periodText], [/* @__PURE__ */ jsx(ForecastKey, {
+			mark: model.kind === "actual" ? "actual" : "forecast",
+			color: tokens?.emphasis,
+			label: model.kindText
+		}, "value"), model.valueText]];
+		if (model.intervalText) rows.push([/* @__PURE__ */ jsx(ForecastKey, {
+			mark: "interval",
+			color: tokens?.emphasis,
+			label: labels.intervalKey(levelText)
+		}, "interval"), model.intervalText]);
+		if (model.targetText) rows.push([/* @__PURE__ */ jsx(ForecastKey, {
+			mark: "target",
+			color: tokens?.reference,
+			label: labels.target
+		}, "target"), model.targetText]);
+		return /* @__PURE__ */ jsx(ArcTooltipRows, { rows });
+	}, [
+		summary,
+		target,
+		formatters,
+		labels,
+		tokens,
+		levelText
+	]);
+	const { handler: tooltipHandler, tooltip } = useArcTooltipHandler({ content: tooltipContent });
+	const embedOptions = useMemo(() => arcEmbedOptions({ tooltip: tooltipHandler }), [tooltipHandler]);
+	const xType = summary?.xType;
+	const summaryGranularity = summary?.granularity;
+	const showRegion = region && hasProjection;
+	const showLanding = landing != null;
+	const showLandingLabel = labelLanding && showLanding;
+	const yTicks = Math.max(2, Math.round(plotHeight / PX_PER_Y_TICK));
+	const periodTitle = labels.tablePeriod;
+	const kindTitle = labels.tableKind;
+	const targetTitle = labels.target;
+	const spec = useMemo(() => {
+		if (!tokens || !xType || !summaryGranularity) return null;
+		const timeGrammar = (kind) => [
+			kind,
+			locale ?? "",
+			timeZone ?? ""
+		].join("@").replace(/@+$/, "");
+		const built = buildForecastPlotSpec({
+			mark,
+			scale,
+			xType,
+			height: plotHeight,
+			axes,
+			yTicks,
+			interval: hasInterval,
+			region: showRegion,
+			boundary: hasProjection,
+			reference: target != null,
+			landing: showLanding,
+			landingLabel: showLandingLabel,
+			tooltip: true,
+			xTitle: periodTitle,
+			yTitle: name,
+			kindTitle,
+			targetTitle,
+			plotFormat: locale ? `${format}@${locale}` : format,
+			timeFormat: timeGrammar(summaryGranularity),
+			axisTimeFormat: timeGrammar(forecastAxisGranularity(summaryGranularity)),
+			locale,
+			timeZone
+		}, tokens);
+		return patchSpec ? patchSpec(built) : built;
+	}, [
+		tokens,
+		xType,
+		summaryGranularity,
+		mark,
+		scale,
+		plotHeight,
+		axes,
+		yTicks,
+		hasInterval,
+		showRegion,
+		hasProjection,
+		target,
+		showLanding,
+		showLandingLabel,
+		periodTitle,
+		kindTitle,
+		targetTitle,
+		name,
+		format,
+		locale,
+		timeZone,
+		patchSpec
+	]);
+	const tableRows = summary?.rows;
+	const intervalRows = summary?.interval;
+	const referenceRows = useMemo(() => target != null ? [{ value: target }] : [], [target]);
+	const periodRows = useMemo(() => summary ? buildForecastPeriodRows(summary) : [], [summary]);
+	const regionRows = useMemo(() => summary ? buildForecastRegionRows(summary) : [], [summary]);
+	const boundaryRows = useMemo(() => summary ? buildForecastBoundaryRows(summary) : [], [summary]);
+	const landingText = landing ? formatters.formatValue(landing.y) : "";
+	const landingRows = useMemo(() => summary && showLanding ? buildForecastLandingRows(summary, landingText) : [], [
+		summary,
+		showLanding,
+		landingText
+	]);
+	const datasets = useMemo(() => ({
+		[FORECAST_TABLE_DATASET]: tableRows ?? [],
+		[FORECAST_INTERVAL_DATASET]: intervalRows ?? [],
+		[FORECAST_PERIODS_DATASET]: periodRows,
+		[FORECAST_REGION_DATASET]: regionRows,
+		[FORECAST_BOUNDARY_DATASET]: boundaryRows,
+		[FORECAST_REFERENCE_DATASET]: referenceRows,
+		[FORECAST_LANDING_DATASET]: landingRows
+	}), [
+		tableRows,
+		intervalRows,
+		periodRows,
+		regionRows,
+		boundaryRows,
+		referenceRows,
+		landingRows
+	]);
+	const chartDescription = summary && hasChart ? buildForecastChartDescription({
+		name,
+		mark,
+		summary,
+		level,
+		formatters,
+		targetText,
+		labels
+	}) : void 0;
+	const generatedInsight = useMemo(() => summary ? buildForecastInsight({
+		name,
+		summary,
+		projection,
+		outlook,
+		crossing,
+		target,
+		level,
+		formatters,
+		labels
+	}) : null, [
+		summary,
+		name,
+		projection,
+		outlook,
+		crossing,
+		target,
+		level,
+		formatters,
+		labels
+	]);
+	const insightContent = insight === void 0 ? generatedInsight ? /* @__PURE__ */ jsx(InsightText, { segments: generatedInsight }) : null : insight;
+	const showInsight = insightContent != null && insightContent !== false;
+	const reserveHeadline = headline !== "none";
+	const reserveKeys = keys;
+	const reserveInsight = insight === void 0 ? true : insight != null && insight !== false;
+	const insightLines = insight === void 0 ? GENERATED_INSIGHT_LINES : CUSTOM_INSIGHT_LINES;
+	const reserveOutlook = target != null && goodDirection !== "none";
+	const headlineMinHeight = reserveHeadline ? Math.max(sizes.valueLinePx + (reserveOutlook ? 4 + sizes.chipLinePx : 0), sizes.deltaLinePx + 4 + sizes.comparisonLinePx) : 0;
+	const bodyMinHeight = (reserveHeadline ? headlineMinHeight + sizes.gapPx : 0) + (reserveHeadline ? sizes.comparisonLinePx + sizes.gapPx : 0) + (!reserveHeadline && reserveOutlook ? sizes.chipLinePx + sizes.gapPx : 0) + plotHeight + (reserveKeys ? sizes.gapPx + sizes.keyLinePx : 0) + (reserveInsight ? sizes.gapPx + sizes.insightLinePx * insightLines : 0);
+	const HeadingTag = `h${titleLevel}`;
+	const busy = state === "loading" || state === "refreshing";
+	const directionWordFor = (direction) => direction === "up" ? labels.increase : direction === "down" ? labels.decrease : labels.unchanged;
+	const captionText = !hasProjection && showContent && hasChart ? labels.noForecast : null;
+	const headlineCaptionText = headline === "none" ? null : headline === "change" && projection ? `${formatters.formatValue(projection.from.y)} → ${formatters.formatValue(projection.to.y)} · ${projection.rangeText}` : headline === "latest" || !landing ? latest ? labels.latestCaption(formatters.formatX(latest.x)) : null : landingIntervalText ? `${labels.landingCaption(formatters.formatX(landing.x))} · ${labels.intervalCaption(landingIntervalText, levelText)}` : labels.landingCaption(formatters.formatX(landing.x));
+	const renderOutlook = (className) => outlook !== "none" && outlookExplanation ? /* @__PURE__ */ jsxs("div", {
+		className: cn("flex min-w-0", className),
+		"data-part": "outlook",
+		children: [/* @__PURE__ */ jsxs(Badge, {
+			variant: outlookBadgeVariant[outlook],
+			appearance: "soft",
+			size: sizes.chip,
+			"aria-describedby": outlookExplanationId,
+			"data-outlook": outlook,
+			children: [/* @__PURE__ */ jsx(OutlookGlyph, { outlook }), labels.outlook[outlook]]
+		}), /* @__PURE__ */ jsx("span", {
+			id: outlookExplanationId,
+			className: "sr-only",
+			children: outlookExplanation
+		})]
+	}) : null;
+	const keyNode = keys && showContent && summary != null && hasChart && /* @__PURE__ */ jsx(HorizontalScroll, {
+		fade: true,
+		className: "min-w-0",
+		"data-part": "keys-scroll",
+		children: /* @__PURE__ */ jsxs("div", {
+			className: cn("flex min-w-0 flex-wrap items-center gap-x-3 gap-y-1 font-sans text-muted-foreground", sizes.body),
+			"data-part": "keys",
+			children: [
+				summary.actualCount > 0 && /* @__PURE__ */ jsx("span", {
+					className: "inline-flex max-w-full items-center",
+					"data-part": "key-actual",
+					children: /* @__PURE__ */ jsx(ForecastKey, {
+						mark: "actual",
+						color: tokens?.emphasis,
+						label: labels.actual
+					})
+				}),
+				hasProjection && /* @__PURE__ */ jsx("span", {
+					className: "inline-flex max-w-full items-center",
+					"data-part": "key-forecast",
+					children: /* @__PURE__ */ jsx(ForecastKey, {
+						mark: "forecast",
+						color: tokens?.emphasis,
+						label: labels.forecast
+					})
+				}),
+				hasProjection && summary.boundary != null && /* @__PURE__ */ jsx("span", {
+					className: "inline-flex max-w-full items-center",
+					"data-part": "key-boundary",
+					children: /* @__PURE__ */ jsx(ForecastKey, {
+						mark: "boundary",
+						color: tokens?.axis,
+						label: `${labels.boundary} ${formatters.formatX(summary.boundary)}`
+					})
+				}),
+				hasInterval && /* @__PURE__ */ jsx("span", {
+					className: "inline-flex max-w-full items-center",
+					"data-part": "key-interval",
+					children: /* @__PURE__ */ jsx(ForecastKey, {
+						mark: "interval",
+						color: tokens?.emphasis,
+						label: labels.intervalKey(levelText)
+					})
+				}),
+				target != null && /* @__PURE__ */ jsx("span", {
+					className: "inline-flex max-w-full items-center",
+					"data-part": "key-target",
+					children: /* @__PURE__ */ jsx(ForecastKey, {
+						mark: "target",
+						color: tokens?.reference,
+						label: `${labels.target} ${targetText}`
+					})
+				})
+			]
+		})
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		ref: setRootRef,
+		render: render ?? /* @__PURE__ */ jsx("figure", {}),
+		padding: sizes.padding,
+		"aria-labelledby": headingId,
+		"aria-describedby": descriptionId,
+		"aria-busy": busy || void 0,
+		"data-status": status,
+		"data-state": state,
+		"data-size": size,
+		"data-mark": mark,
+		"data-headline": headline,
+		"data-outlook": outlook !== "none" ? outlook : void 0,
+		"data-interval": showContent && hasInterval ? "" : void 0,
+		"data-forecast": showContent && hasChart && !hasProjection ? "none" : void 0,
+		"data-empty": state === "empty" || state === "no-match" ? "" : void 0,
+		"data-stale": stale ? "" : void 0,
+		"data-insufficient": insufficient ? "" : void 0,
+		"data-polarity": showContent && projection ? projection.delta.polarity : void 0,
+		"data-crossing": showContent && crossing ? String(crossing.x) : void 0,
+		...rest,
+		className: cn("relative flex min-w-0 flex-col", sizes.gap, className),
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-between gap-2",
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: "flex min-w-0 items-center gap-1",
+					children: [/* @__PURE__ */ jsx(HeadingTag, {
+						id: headingId,
+						className: cn(labelClasses, sizes.label, "line-clamp-2"),
+						children: label
+					}), hint && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+						render: /* @__PURE__ */ jsx(Button, {
+							variant: "ghost",
+							size: "sm",
+							iconOnly: true,
+							circular: true,
+							"aria-label": labels.about(name),
+							"aria-describedby": hintId,
+							className: headerControlClasses
+						}),
+						children: /* @__PURE__ */ jsx(InfoIcon, { className: "size-3.5" })
+					}), /* @__PURE__ */ jsx(TooltipPopup, { children: hint })] }), /* @__PURE__ */ jsx("span", {
+						id: hintId,
+						className: "sr-only",
+						children: hint
+					})] })]
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "flex shrink-0 items-center gap-1",
+					children: [
+						stale && /* @__PURE__ */ jsx(Badge, {
+							variant: "warning",
+							appearance: "soft",
+							size: "sm",
+							children: labels.stale
+						}),
+						hasTable && /* @__PURE__ */ jsxs(Popover, {
+							open: tableOpen,
+							onOpenChange: setTableOpen,
+							children: [!hideTableToggle && /* @__PURE__ */ jsx(PopoverTrigger, {
+								render: /* @__PURE__ */ jsx(Button, {
+									variant: "ghost",
+									size: "sm",
+									iconOnly: true,
+									circular: true,
+									"aria-label": tableOpen ? labels.hideTable(name) : labels.showTable(name),
+									className: headerControlClasses
+								}),
+								children: /* @__PURE__ */ jsx(InfoIcon, { className: "size-3.5" })
+							}), popoverContainer && /* @__PURE__ */ jsxs(PopoverPopup, {
+								id: tableId,
+								anchor: rootRef,
+								container: popoverContainer,
+								side: "right",
+								align: "start",
+								collisionPadding: 8,
+								className: "pointer-events-auto w-[min(28rem,var(--available-width))]",
+								"data-part": "data-popover",
+								children: [
+									/* @__PURE__ */ jsx(PopoverTitle, {
+										className: "mb-3",
+										children: name
+									}),
+									/* @__PURE__ */ jsx(TableContainer, {
+										variant: "plain",
+										tabIndex: 0,
+										role: "region",
+										"aria-label": labels.tableCaption(name),
+										className: "max-h-[min(20rem,calc(var(--available-height)-5rem))] focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring",
+										"data-part": "table",
+										children: /* @__PURE__ */ jsxs(Table, {
+											size: "sm",
+											stickyHeader: true,
+											hoverable: false,
+											children: [
+												/* @__PURE__ */ jsx(TableCaption, {
+													side: "top",
+													className: "sr-only",
+													children: labels.tableCaption(name)
+												}),
+												/* @__PURE__ */ jsx(TableHeader, { children: /* @__PURE__ */ jsxs(TableRow, { children: [
+													/* @__PURE__ */ jsx(TableHead, { children: labels.tablePeriod }),
+													/* @__PURE__ */ jsx(TableHead, { children: labels.tableKind }),
+													/* @__PURE__ */ jsx(TableHead, {
+														className: "text-right",
+														children: labels.tableValue
+													}),
+													hasInterval && /* @__PURE__ */ jsx(TableHead, {
+														className: "text-right",
+														children: labels.tableInterval
+													})
+												] }) }),
+												/* @__PURE__ */ jsx(TableBody, { children: (summary?.readings ?? []).map((reading, at) => /* @__PURE__ */ jsxs(TableRow, {
+													"data-kind": reading.kind,
+													children: [
+														/* @__PURE__ */ jsx(TableCell, { children: formatters.formatX(reading.x) }),
+														/* @__PURE__ */ jsx(TableCell, {
+															className: "text-muted-foreground",
+															children: reading.kind === "actual" ? labels.actual : labels.forecast
+														}),
+														/* @__PURE__ */ jsx(TableCell, {
+															className: "text-right tabular-nums",
+															children: formatters.formatValue(reading.y)
+														}),
+														hasInterval && /* @__PURE__ */ jsx(TableCell, {
+															className: "text-right tabular-nums",
+															children: formatters.formatInterval(reading.lower, reading.upper) ?? "—"
+														})
+													]
+												}, at)) })
+											]
+										})
+									}),
+									levelText && /* @__PURE__ */ jsx("p", {
+										className: cn(captionClasses, "mt-3"),
+										children: labels.intervalCaption(labels.interval, levelText)
+									})
+								]
+							})]
+						}),
+						action
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsx("p", {
+				id: descriptionId,
+				className: "sr-only",
+				children: cardDescription
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "relative flex min-w-0 flex-col",
+				style: { minHeight: bodyMinHeight },
+				children: [
+					state === "loading" && /* @__PURE__ */ jsxs(SkeletonGroup, {
+						className: cn("flex flex-col", sizes.gap),
+						children: [
+							reserveHeadline && /* @__PURE__ */ jsxs("div", {
+								className: "flex min-w-0 items-start justify-between gap-2",
+								style: { minHeight: headlineMinHeight },
+								children: [/* @__PURE__ */ jsxs("div", {
+									className: "flex w-2/5 flex-col gap-1",
+									children: [/* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: "w-full",
+										style: { height: sizes.valueLinePx }
+									}), reserveOutlook && /* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: "w-4/5",
+										style: { height: sizes.chipLinePx }
+									})]
+								}), /* @__PURE__ */ jsxs("div", {
+									className: "flex w-1/3 flex-col items-end gap-1",
+									children: [/* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: "w-20 max-w-full",
+										style: { height: sizes.deltaLinePx }
+									}), /* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: "w-full",
+										style: { height: sizes.comparisonLinePx }
+									})]
+								})]
+							}),
+							reserveHeadline && /* @__PURE__ */ jsx(Skeleton, {
+								variant: "rounded",
+								className: "w-3/5",
+								style: { height: sizes.comparisonLinePx }
+							}),
+							!reserveHeadline && reserveOutlook && /* @__PURE__ */ jsx(Skeleton, {
+								variant: "rounded",
+								className: "w-32",
+								style: { height: sizes.chipLinePx }
+							}),
+							/* @__PURE__ */ jsx(Skeleton, {
+								variant: "rounded",
+								className: "w-full",
+								style: { height: plotHeight }
+							}),
+							reserveKeys && /* @__PURE__ */ jsx("div", {
+								className: "flex flex-wrap gap-3",
+								children: Array.from({ length: 3 }, (_, index) => /* @__PURE__ */ jsx(Skeleton, {
+									variant: "rounded",
+									className: "w-20",
+									style: { height: sizes.keyLinePx }
+								}, index))
+							}),
+							reserveInsight && /* @__PURE__ */ jsxs("div", {
+								className: "flex items-start gap-2",
+								children: [/* @__PURE__ */ jsx(Skeleton, {
+									variant: "rounded",
+									className: "size-4 shrink-0"
+								}), /* @__PURE__ */ jsx("div", {
+									className: "flex min-w-0 flex-1 flex-col gap-1",
+									children: Array.from({ length: insightLines }, (_, index) => /* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: index === insightLines - 1 ? "w-3/4" : "w-full",
+										style: { height: sizes.insightLinePx - 4 }
+									}, index))
+								})]
+							})
+						]
+					}),
+					state === "error" && /* @__PURE__ */ jsx(SystemState, {
+						variant: "server-error",
+						scope: "inline",
+						title: labels.error,
+						description: false,
+						action: onRetry ? /* @__PURE__ */ jsx(Button, {
+							size: "sm",
+							onClick: onRetry,
+							children: labels.retry
+						}) : void 0,
+						className: cn(panelStateClasses, "my-auto")
+					}),
+					state === "empty" && /* @__PURE__ */ jsx(SystemState, {
+						variant: "empty",
+						scope: "inline",
+						title: labels.noData,
+						description: false,
+						className: cn(panelStateClasses, "my-auto")
+					}),
+					state === "no-match" && /* @__PURE__ */ jsx(SystemState, {
+						variant: "no-results",
+						scope: "inline",
+						title: labels.noMatch,
+						description: false,
+						action: onClearFilters ? /* @__PURE__ */ jsx(Button, {
+							variant: "outline",
+							size: "sm",
+							onClick: onClearFilters,
+							children: labels.clearFilters
+						}) : void 0,
+						className: cn(panelStateClasses, "my-auto")
+					}),
+					showContent && /* @__PURE__ */ jsxs("div", {
+						className: cn("flex min-w-0 flex-col", sizes.gap),
+						children: [
+							headline !== "none" && /* @__PURE__ */ jsx("div", {
+								className: "flex min-w-0 items-start justify-between gap-2",
+								style: { minHeight: headlineMinHeight },
+								"data-part": "headline",
+								children: headline === "change" && projection ? /* @__PURE__ */ jsxs("div", {
+									className: "flex min-w-0 flex-col",
+									"data-part": "value",
+									children: [/* @__PURE__ */ jsxs("span", {
+										className: cn(valueClasses, sizes.value, "min-w-0 wrap-break-word", changeTextClasses[projection.delta.polarity]),
+										children: [/* @__PURE__ */ jsxs("span", {
+											className: "sr-only",
+											children: [directionWordFor(projection.delta.direction), " "]
+										}), projection.delta.text]
+									}), renderOutlook("mt-1")]
+								}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("div", {
+									className: "flex min-w-0 flex-col",
+									"data-part": "value",
+									children: [/* @__PURE__ */ jsxs("span", {
+										className: "flex min-w-0 flex-wrap items-baseline gap-x-1.5",
+										children: [/* @__PURE__ */ jsx("span", {
+											className: cn(valueClasses, sizes.value, "min-w-0 wrap-break-word"),
+											children: formatters.formatValue(headline === "latest" ? latest?.y : landing?.y ?? latest?.y)
+										}), unit != null && /* @__PURE__ */ jsx("span", {
+											className: cn("font-sans text-muted-foreground", sizes.unit),
+											children: unit
+										})]
+									}), renderOutlook("mt-1")]
+								}), projection && /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsxs(TooltipTrigger, {
+									delay: 150,
+									render: /* @__PURE__ */ jsx("p", {
+										tabIndex: 0,
+										role: "group",
+										"aria-label": labels.changeGroup(name),
+										"aria-describedby": deltaExplanationId,
+										className: cn("ms-auto flex min-w-0 max-w-1/2 shrink-0 flex-col items-end gap-1 rounded-md text-right font-sans", "focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring", sizes.body),
+										"data-part": "delta"
+									}),
+									children: [
+										/* @__PURE__ */ jsx("span", {
+											id: deltaExplanationId,
+											className: "sr-only",
+											children: deltaExplanation
+										}),
+										/* @__PURE__ */ jsxs(Badge, {
+											variant: polarityBadgeVariant[projection.delta.polarity],
+											appearance: "soft",
+											size: sizes.badge,
+											"data-direction": projection.delta.direction,
+											children: [
+												/* @__PURE__ */ jsx(DeltaGlyph, { direction: projection.delta.direction }),
+												/* @__PURE__ */ jsxs("span", {
+													className: "sr-only",
+													children: [directionWordFor(projection.delta.direction), " "]
+												}),
+												projection.delta.text
+											]
+										}),
+										/* @__PURE__ */ jsx("span", {
+											className: "max-w-full text-muted-foreground wrap-break-word text-xs",
+											children: labels.latestCaption(formatters.formatX(projection.from.x))
+										})
+									]
+								}), /* @__PURE__ */ jsx(TooltipPopup, {
+									arrow: false,
+									side: "bottom",
+									align: "end",
+									sideOffset: 8,
+									collisionPadding: 8,
+									container: popoverContainer,
+									className: "text-left",
+									"data-part": "delta-tooltip",
+									children: /* @__PURE__ */ jsx(ArcTooltipRows, { rows: deltaExplanationRows })
+								})] })] })
+							}),
+							headlineCaptionText && /* @__PURE__ */ jsx("p", {
+								className: cn(captionClasses, "min-w-0 wrap-break-word"),
+								"data-part": "headline-caption",
+								children: headlineCaptionText
+							}),
+							headline === "none" && renderOutlook(),
+							/* @__PURE__ */ jsx("div", {
+								ref: plotRef,
+								className: "relative w-full",
+								style: { height: plotHeight },
+								"data-part": "plot",
+								children: hasChart ? plotWidth > 0 && spec ? /* @__PURE__ */ jsx(ArcVegaChart, {
+									spec,
+									options: embedOptions,
+									datasets,
+									description: chartDescription,
+									width: plotWidth,
+									height: plotHeight,
+									onEmbed,
+									className: "absolute inset-0 [&_svg]:block [&_.vega-bindings:empty]:hidden",
+									fallback: /* @__PURE__ */ jsx(Skeleton, {
+										variant: "rounded",
+										className: "size-full"
+									})
+								}) : /* @__PURE__ */ jsx(Skeleton, {
+									variant: "rounded",
+									className: "size-full"
+								}) : /* @__PURE__ */ jsx("p", {
+									className: cn(captionClasses, "flex h-full items-center"),
+									children: labels.insufficient
+								})
+							}),
+							captionText && /* @__PURE__ */ jsx("p", {
+								className: cn(captionClasses, "-mt-1"),
+								"data-part": "caption",
+								children: captionText
+							}),
+							keyNode,
+							showInsight && /* @__PURE__ */ jsxs("div", {
+								className: cn("flex items-start gap-2 font-sans text-foreground", sizes.body),
+								"data-part": "insight",
+								children: [/* @__PURE__ */ jsx(AILoader, {
+									size: "sm",
+									state: "default",
+									label: labels.insightMark,
+									className: cn("shrink-0", size === "sm" ? "" : "mt-0.5")
+								}), /* @__PURE__ */ jsx("p", {
+									className: "min-w-0 flex-1 text-xs leading-[1.8] [&_strong]:font-semibold [&_strong]:text-foreground",
+									children: insightContent
+								})]
+							})
+						]
+					}),
+					state === "refreshing" && /* @__PURE__ */ jsx("div", {
+						"aria-hidden": "true",
+						className: "absolute -inset-1 rounded-md bg-veil"
+					})
+				]
+			}),
+			asOfValid && asOfDate && /* @__PURE__ */ jsx("p", {
+				className: cn(captionClasses, "text-right"),
+				"data-part": "as-of",
+				children: /* @__PURE__ */ jsx("time", {
+					dateTime: asOfDate.toISOString(),
+					children: asOfText
+				})
+			}),
+			/* @__PURE__ */ jsx("div", {
+				ref: setPopoverContainer,
+				className: "pointer-events-none absolute inset-0",
+				"data-part": "popover-host"
+			}),
+			tooltip
+		]
+	});
+});
+ForecastCard.displayName = "ForecastCard";
+//#endregion
+export { ForecastCard };