@carto/ps-react-ui 5.0.0-widgets.9 → 5.1.0

package/dist/widgets-v2/timeseries.js

@@ -0,0 +1,294 @@
+import { r as e } from "../zoom-toggle-IsF8BnAp.js";
+import { n as t, t as n } from "../download-DdaK3qgC.js";
+import { n as r, r as i, t as a } from "../utils-Dr6gf3vD.js";
+import { a as o, d as s, f as c, i as l, s as u, u as d } from "../chart-config-B_fdIcD3.js";
+import { c as f } from "react/compiler-runtime";
+import { Box as p, Skeleton as m } from "@mui/material";
+import { jsx as h, jsxs as g } from "react/jsx-runtime";
+import * as _ from "echarts";
+//#region src/widgets-v2/timeseries/options.ts
+function v({ theme: e, formatter: t, labelFormatter: n }) {
+	let r = 0, i = 1;
+	return {
+		grid: {
+			left: parseInt(e.spacing(1)),
+			top: parseInt(e.spacing(3)),
+			right: parseInt(e.spacing(1)),
+			...o(!1, e),
+			containLabel: !0
+		},
+		tooltip: {
+			trigger: "axis",
+			backgroundColor: e.palette.grey[900],
+			borderWidth: 0,
+			padding: [parseInt(e.spacing(1)), parseInt(e.spacing(1))],
+			textStyle: {
+				color: e.palette.common.white,
+				fontSize: 11,
+				fontFamily: e.typography.caption.fontFamily
+			},
+			axisPointer: { type: "line" },
+			position: s(e),
+			formatter: b(t, n)
+		},
+		legend: { ...u({ hasLegend: !1 }) },
+		axisPointer: { lineStyle: { color: e.palette.grey[400] } },
+		color: [e.palette.secondary.main, ...Object.values(e.palette.qualitative?.bold ?? {})],
+		xAxis: {
+			type: "time",
+			axisLine: { show: !1 },
+			axisTick: { show: !1 },
+			axisLabel: {
+				...l(e),
+				padding: [
+					parseInt(e.spacing(.5)),
+					0,
+					0,
+					0
+				],
+				margin: 0,
+				hideOverlap: !0,
+				...n && { formatter: (e) => n(new Date(e)) }
+			}
+		},
+		yAxis: {
+			type: "value",
+			min: (e) => (r = e.min < 0 ? c(e.min) : 0, r),
+			max: (e) => (i = e.max <= 0 ? 1 : c(e.max), i),
+			axisLine: { show: !1 },
+			axisTick: { show: !1 },
+			splitLine: {
+				show: !0,
+				lineStyle: { color: e.palette.black?.[4] ?? e.palette.divider }
+			},
+			axisLabel: {
+				...l(e),
+				margin: parseInt(e.spacing(1)),
+				show: !0,
+				showMaxLabel: !0,
+				showMinLabel: !0,
+				verticalAlign: "bottom",
+				inside: !0,
+				formatter: (e) => e !== i && e !== r || e === 0 ? "" : t ? t(e) : String(e)
+			}
+		}
+	};
+}
+function y(t) {
+	let { theme: n, formatter: o, labelFormatter: s, optionsOverride: l } = t, u = t.series, d = t.smooth ?? !0, f = t.area ?? !1, p = t.selection, m = p && p.length > 0 ? new Set(p) : null, h = (e) => e instanceof Date ? e.getTime() : e;
+	return (t, p, g) => {
+		if (t == null) {
+			let e = v({
+				theme: n,
+				formatter: o,
+				labelFormatter: s
+			});
+			return l ? i(e, l) : e;
+		}
+		let y = Array.isArray(p) ? p : [];
+		if (y.length === 0) return {
+			...t,
+			dataset: [],
+			series: []
+		};
+		let x = y.length > 1, S = Array.isArray(t.series) ? t.series : [], C = S[0] ?? {}, w = typeof t.yAxis == "object" && !Array.isArray(t.yAxis) ? t.yAxis : {}, T = typeof t.grid == "object" && !Array.isArray(t.grid) ? t.grid : {}, E = typeof t.tooltip == "object" && !Array.isArray(t.tooltip) ? t.tooltip : {}, D = typeof t.legend == "object" && !Array.isArray(t.legend) ? t.legend : {}, O = g?.formatter, k = 0, A = 1, j = r(t.dataZoom, x), M = typeof T.bottom == "number" ? T.bottom : 24, N = x ? 56 : M, P = j ? N + e.sliderHeight + e.sliderGap : N, F = { color: (e) => {
+			let t = e.value?.name, n = e.color;
+			return !m || t == null || m.has(h(t)) ? n : _.color.modifyAlpha(n, .15);
+		} };
+		return {
+			...t,
+			dataset: y.map((e) => ({ source: e })),
+			series: y.map((e, t) => {
+				let r = S[t] ?? C, i = a(n, u?.[t]?.color);
+				return {
+					...typeof r == "object" ? r : {},
+					type: "line",
+					datasetIndex: t,
+					name: u?.[t]?.name ?? `Series ${t + 1}`,
+					encode: {
+						x: "name",
+						y: "value"
+					},
+					smooth: d,
+					showSymbol: m != null,
+					...f ? { areaStyle: {} } : {},
+					emphasis: { focus: "series" },
+					itemStyle: F,
+					...i ? {
+						color: i,
+						lineStyle: { color: i }
+					} : {}
+				};
+			}),
+			legend: {
+				...D,
+				show: x
+			},
+			grid: {
+				...T,
+				bottom: P
+			},
+			...j ? { dataZoom: j } : {},
+			yAxis: {
+				...w,
+				min: (e) => (k = e.min < 0 ? c(e.min) : 0, k),
+				max: (e) => (A = e.max <= 0 ? 1 : c(e.max), A),
+				axisLabel: {
+					...w.axisLabel ?? {},
+					formatter: (e) => e !== A && e !== k || e === 0 ? "" : O ? O(e) : String(e)
+				}
+			},
+			tooltip: {
+				...E,
+				formatter: b(O, s)
+			}
+		};
+	};
+}
+function b(e, t) {
+	return d((n) => {
+		let r = n.value, i = r?.value, a = typeof i == "number" && e ? e(i) : i ?? "", o = typeof n.marker == "string" ? n.marker : "", s = n.seriesName ? `${n.seriesName}: ` : "", c = r?.name ?? n.name, l = t && c != null ? t(c instanceof Date ? c : new Date(c)) : c ?? "";
+		return {
+			name: String(l),
+			seriesName: s,
+			marker: o,
+			value: a
+		};
+	});
+}
+//#endregion
+//#region src/widgets-v2/timeseries/skeleton.tsx
+var x = {
+	container: {
+		display: "flex",
+		flexDirection: "column",
+		justifyContent: "space-between",
+		gap: ({ spacing: e }) => e(1),
+		height: ({ spacing: e }) => e(38)
+	},
+	graph: {
+		position: "relative",
+		flex: "1 1 auto",
+		width: "100%"
+	},
+	segmentA: {
+		position: "absolute",
+		left: 0,
+		right: "70%",
+		top: "60%",
+		height: 4
+	},
+	segmentB: {
+		position: "absolute",
+		left: "25%",
+		right: "40%",
+		top: "35%",
+		height: 4
+	},
+	segmentC: {
+		position: "absolute",
+		left: "55%",
+		right: 0,
+		top: "50%",
+		height: 4
+	},
+	legend: {
+		display: "flex",
+		alignItems: "center",
+		gap: ({ spacing: e }) => e(2),
+		height: ({ spacing: e }) => e(5)
+	},
+	legendItem: {
+		display: "flex",
+		alignItems: "center",
+		gap: ({ spacing: e }) => e(1.5)
+	}
+};
+function S() {
+	let e = f(2), t;
+	e[0] === Symbol.for("react.memo_cache_sentinel") ? (t = /* @__PURE__ */ g(p, {
+		sx: x.graph,
+		children: [
+			/* @__PURE__ */ h(m, {
+				variant: "rectangular",
+				sx: x.segmentA
+			}),
+			/* @__PURE__ */ h(m, {
+				variant: "rectangular",
+				sx: x.segmentB
+			}),
+			/* @__PURE__ */ h(m, {
+				variant: "rectangular",
+				sx: x.segmentC
+			})
+		]
+	}), e[0] = t) : t = e[0];
+	let n;
+	return e[1] === Symbol.for("react.memo_cache_sentinel") ? (n = /* @__PURE__ */ g(p, {
+		sx: x.container,
+		children: [t, /* @__PURE__ */ h(p, {
+			sx: x.legend,
+			children: [0, 1].map(C)
+		})]
+	}), e[1] = n) : n = e[1], n;
+}
+function C(e) {
+	return /* @__PURE__ */ g(p, {
+		sx: x.legendItem,
+		children: [/* @__PURE__ */ h(m, {
+			variant: "circular",
+			width: 8,
+			height: 8
+		}), /* @__PURE__ */ h(m, {
+			width: 48,
+			height: 8
+		})]
+	}, `legend-${e}`);
+}
+//#endregion
+//#region src/widgets-v2/timeseries/download.ts
+function w(e) {
+	let r = [];
+	return e.getCaptureEl && r.push(t({
+		filename: e.filename,
+		getCaptureEl: e.getCaptureEl,
+		pixelRatio: e.pngPixelRatio,
+		backgroundColor: e.pngBackgroundColor
+	})), r.push(n({
+		filename: e.filename,
+		getRows: () => {
+			let t = e.getData(), n = t.length, r = [], i = /* @__PURE__ */ new Set();
+			for (let e of t) for (let t of e) {
+				let e = String(t.name);
+				i.has(e) || (i.add(e), r.push(t.name));
+			}
+			let a = t.map((e) => new Map(e.map((e) => [String(e.name), e.value]))), o = ["time"];
+			for (let t = 0; t < n; t++) o.push(e.seriesNames?.[t] ?? `series_${t + 1}`);
+			let s = [o];
+			for (let e of r) {
+				let t = [T(e)], n = String(e);
+				for (let e of a) t.push(e.get(n) ?? "");
+				s.push(t);
+			}
+			return s;
+		}
+	})), r;
+}
+function T(e) {
+	return e instanceof Date ? e.toISOString() : typeof e == "number" ? new Date(e).toISOString() : e;
+}
+//#endregion
+//#region src/widgets-v2/timeseries/transforms.ts
+function E(e, t) {
+	if (t.length === 0 || !Array.isArray(e)) return e;
+	let n = new Set(t);
+	return e.map((e) => Array.isArray(e) ? e.filter((e) => {
+		if (typeof e != "object" || !e || !("name" in e)) return !1;
+		let t = e.name, r = t instanceof Date ? t.getTime() : t;
+		return (typeof r == "string" || typeof r == "number") && n.has(r);
+	}) : e);
+}
+//#endregion
+export { S as TimeseriesSkeleton, w as createTimeseriesDownloadConfig, y as createTimeseriesOptionFactory, E as filterTimeseriesByLockedItems, v as timeseriesOptions };
+
+//# sourceMappingURL=timeseries.js.map

package/dist/widgets-v2/timeseries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries.js","names":["<Box sx={styles.graph}>\n        <Skeleton variant='rectangular' sx={styles.segmentA} />\n        <Skeleton variant='rectangular' sx={styles.segmentB} />\n        <Skeleton variant='rectangular' sx={styles.segmentC} />\n      </Box>","<Box sx={styles.container}>\n      <Box sx={styles.graph}>\n        <Skeleton variant='rectangular' sx={styles.segmentA} />\n        <Skeleton variant='rectangular' sx={styles.segmentB} />\n        <Skeleton variant='rectangular' sx={styles.segmentC} />\n      </Box>\n      <Box sx={styles.legend}>\n        {[0, 1].map((i) => (\n          <Box key={`legend-${i}`} sx={styles.legendItem}>\n            <Skeleton variant='circular' width={8} height={8} />\n            <Skeleton width={48} height={8} />\n          </Box>\n        ))}\n      </Box>\n    </Box>","(i) => (\n          <Box key={`legend-${i}`} sx={styles.legendItem}>\n            <Skeleton variant='circular' width={8} height={8} />\n            <Skeleton width={48} height={8} />\n          </Box>\n        )"],"sources":["../../src/widgets-v2/timeseries/options.ts","../../src/widgets-v2/timeseries/skeleton.tsx","../../src/widgets-v2/timeseries/download.ts","../../src/widgets-v2/timeseries/transforms.ts"],"sourcesContent":["import type { EChartsOption } from 'echarts'\nimport * as echarts from 'echarts'\nimport type { CallbackDataParams } from 'echarts/types/dist/shared'\nimport {\n  buildAxisLabelStyle,\n  buildGridConfig,\n  buildLegendConfig,\n  createTooltipFormatter,\n  createTooltipPositioner,\n  niceNum,\n} from '../../widgets/utils/chart-config'\nimport { ZOOM_LAYOUT } from '../actions/zoom-toggle'\nimport type { OptionFactory } from '../echart'\nimport { mergeOptions, resolveThemeColor } from '../utils'\nimport { positionDataZoomForLegend } from '../utils/data-zoom-layout'\nimport type {\n  TimeseriesEChartsOption,\n  TimeseriesOptionFactoryInput,\n  TimeseriesOptionsInput,\n  TimeseriesWidgetData,\n} from './types'\n\n/**\n * Builds the **structural** ECharts option for a timeseries widget —\n * time x-axis, value y-axis, themed tooltip, themed legend, CARTO color\n * palette. Mirrors {@link import('../bar/options').barOptions} so all\n * four ECharts widgets share v1 look-and-feel.\n *\n * Intentional deviations from bar (timeseries-specific):\n *   - **X-axis is `type: 'time'`** (not 'category'). ECharts handles\n *     uneven sample spacing and zoom-level-aware label formatting.\n *     `labelFormatter` is wrapped so the consumer sees a `Date`, not\n *     a numeric timestamp.\n *   - **Tooltip body reads `{ name, value }` rows**, same as bar, but\n *     the `name` may arrive as `Date | number | string`. The\n *     `labelFormatter` receives a `Date` regardless.\n *\n * Intentionally data-agnostic: no series, no dataset, no `legend.show`\n * (those depend on data and are added by the option factory's merge\n * phase via {@link createTimeseriesOptionFactory}).\n */\nexport function timeseriesOptions({\n  theme,\n  formatter,\n  labelFormatter,\n}: TimeseriesOptionsInput): TimeseriesEChartsOption {\n  // Closure shared between yAxis min/max callbacks and the label formatter,\n  // so only the rounded extents are labelled (matches v1 + bar).\n  let niceMin = 0\n  let niceMax = 1\n\n  return {\n    grid: {\n      left: parseInt(theme.spacing(1)),\n      top: parseInt(theme.spacing(3)),\n      right: parseInt(theme.spacing(1)),\n      // Default: no legend. Merger bumps this when there are >1 series.\n      ...buildGridConfig(false, theme),\n      containLabel: true,\n    },\n    tooltip: {\n      trigger: 'axis',\n      backgroundColor: theme.palette.grey[900],\n      borderWidth: 0,\n      padding: [parseInt(theme.spacing(1)), parseInt(theme.spacing(1))],\n      textStyle: {\n        color: theme.palette.common.white,\n        fontSize: 11,\n        fontFamily: theme.typography.caption.fontFamily,\n      },\n      axisPointer: { type: 'line' },\n      position: createTooltipPositioner(theme),\n      formatter: buildTimeseriesTooltipFormatter(formatter, labelFormatter),\n    },\n    // Legend styling baked here; `show` is toggled by the merger based on\n    // series count.\n    legend: {\n      ...buildLegendConfig({ hasLegend: false }),\n    },\n    axisPointer: { lineStyle: { color: theme.palette.grey[400] } },\n    color: [\n      theme.palette.secondary.main,\n      ...Object.values(\n        (theme.palette as { qualitative?: { bold?: Record<string, string> } })\n          .qualitative?.bold ?? {},\n      ),\n    ],\n    xAxis: {\n      type: 'time',\n      axisLine: { show: false },\n      axisTick: { show: false },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        padding: [parseInt(theme.spacing(0.5)), 0, 0, 0],\n        margin: 0,\n        hideOverlap: true,\n        ...(labelFormatter && {\n          formatter: (value: number) => labelFormatter(new Date(value)),\n        }),\n      },\n    },\n    yAxis: {\n      type: 'value',\n      min: (extent: { min: number }) => {\n        niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n        return niceMin\n      },\n      max: (extent: { min: number; max: number }) => {\n        niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n        return niceMax\n      },\n      axisLine: { show: false },\n      axisTick: { show: false },\n      splitLine: {\n        show: true,\n        lineStyle: { color: theme.palette.black?.[4] ?? theme.palette.divider },\n      },\n      axisLabel: {\n        ...buildAxisLabelStyle(theme),\n        margin: parseInt(theme.spacing(1)),\n        show: true,\n        showMaxLabel: true,\n        showMinLabel: true,\n        verticalAlign: 'bottom',\n        inside: true,\n        formatter: (value: number) => {\n          if (value !== niceMax && value !== niceMin) return ''\n          if (value === 0) return ''\n          return formatter ? formatter(value) : String(value)\n        },\n      },\n    },\n  } as TimeseriesEChartsOption\n}\n\n/**\n * Returns the timeseries widget's {@link OptionFactory} — one closure\n * that owns BOTH phases of option construction:\n *\n *   - **Structural phase** (`option == null`) — builds the theme-aware\n *     structural option via {@link timeseriesOptions}, optionally merging\n *     the consumer-supplied `optionsOverride`. Called once by Provider to\n *     seed `rawOptions` in the store.\n *   - **Merge phase** (`option != null`) — fuses post-pipeline `state.data`\n *     (`TimeseriesWidgetData`) into the option via the dataset API: one\n *     dataset per series, each series referencing its dataset by index,\n *     encoded by `name` (x — time) and `value` (y). Mirrors {@link import('../bar/options').createBarOptionFactory}:\n *     series-template merge for `addStack`, reactive formatters from\n *     `ctx`, `niceNum`-rounded y-axis bounds at fusion time, and\n *     `positionDataZoomForLegend` layout for ZoomToggle sliders.\n */\nexport function createTimeseriesOptionFactory(\n  options: TimeseriesOptionFactoryInput,\n): OptionFactory {\n  const { theme, formatter, labelFormatter, optionsOverride } = options\n  const series = options.series\n  const smooth = options.smooth ?? true\n  const area = options.area ?? false\n  const selection = options.selection\n  const selectionSet =\n    selection && selection.length > 0\n      ? new Set<string | number>(selection)\n      : null\n  // `name` may be Date | number | string. Normalize to the same type the\n  // selection is keyed on (Date → ms) so Set lookups match.\n  const normalizeName = (n: Date | number | string): string | number =>\n    n instanceof Date ? n.getTime() : n\n  return (option, data, ctx) => {\n    if (option == null) {\n      const structural = timeseriesOptions({ theme, formatter, labelFormatter })\n      return optionsOverride\n        ? (mergeOptions(\n            structural as unknown as Record<string, unknown>,\n            optionsOverride as Partial<Record<string, unknown>>,\n          ) as EChartsOption)\n        : structural\n    }\n\n    const seriesArr = Array.isArray(data) ? (data as TimeseriesWidgetData) : []\n    if (seriesArr.length === 0) {\n      return { ...option, dataset: [], series: [] }\n    }\n    const hasLegend = seriesArr.length > 1\n    const seriesTemplates = Array.isArray(option.series) ? option.series : []\n    const broadcastTemplate = seriesTemplates[0] ?? {}\n    const baseYAxis =\n      typeof option.yAxis === 'object' && !Array.isArray(option.yAxis)\n        ? option.yAxis\n        : {}\n    const baseGrid =\n      typeof option.grid === 'object' && !Array.isArray(option.grid)\n        ? option.grid\n        : {}\n    const baseTooltip =\n      typeof option.tooltip === 'object' && !Array.isArray(option.tooltip)\n        ? option.tooltip\n        : {}\n    const baseLegend =\n      typeof option.legend === 'object' && !Array.isArray(option.legend)\n        ? option.legend\n        : {}\n\n    // Reactive (live store) formatter from ctx — distinct from the\n    // closure-time `formatter` captured for the structural-build branch\n    // above. RelativeData can install a percent formatter on the store\n    // after the factory was constructed; the merge phase reads `ctx` to\n    // pick that up. `labelFormatter` (Date → string) is structural-only —\n    // not relativizable — so the merge branch reads the closure-time value.\n    const liveFormatter = ctx?.formatter\n\n    // Closure shared between the yAxis min/max callbacks and the label\n    // formatter, so only the rounded extents are labelled (matches v1 +\n    // bar). Delegating the extent to ECharts (rather than precomputing\n    // scalars from the raw data) keeps stacked lines inside the plot: when\n    // StackToggle marks the series, ECharts feeds the *post-stack* extent\n    // to these callbacks, so `niceNum` rounds the stacked total.\n    let niceMin = 0\n    let niceMax = 1\n\n    // Zoom slider layout: when ZoomToggle has installed `dataZoom`, push the\n    // slider above the legend (if any) and reserve room in the grid below.\n    const dataZoomLayout = positionDataZoomForLegend(option.dataZoom, hasLegend)\n    const fallbackBottom =\n      typeof baseGrid.bottom === 'number' ? baseGrid.bottom : 24\n    const baseBottom = hasLegend ? 56 : fallbackBottom\n    const gridBottom = dataZoomLayout\n      ? baseBottom + ZOOM_LAYOUT.sliderHeight + ZOOM_LAYOUT.sliderGap\n      : baseBottom\n\n    // Dim non-selected points via `series.itemStyle.color`. Per-row\n    // `itemStyle` on dataset object-rows is silently ignored when\n    // `series.encode` is in play.\n    //\n    // We *always* emit `itemStyle.color` (a passthrough when nothing is\n    // selected), not conditionally — dropping the key between renders\n    // would let ECharts' default merge keep the previous callback alive\n    // and points would stay dimmed forever after an external clear.\n    // Always emitting lets normal merge swap the callback in place, no\n    // `replaceMerge` and no entry-animation flash on selection on/off.\n    const dimItemStyle = {\n      color: (params: CallbackDataParams) => {\n        const datum = params.value as\n          { name?: Date | number | string } | undefined\n        const raw = datum?.name\n        const base = params.color as string\n        if (!selectionSet || raw == null) return base\n        return selectionSet.has(normalizeName(raw))\n          ? base\n          : echarts.color.modifyAlpha(base, 0.15)\n      },\n    }\n\n    return {\n      ...option,\n      dataset: seriesArr.map((s) => ({ source: s as readonly object[] })),\n      series: seriesArr.map((_, i) => {\n        const template =\n          (seriesTemplates[i] as object | undefined) ??\n          (broadcastTemplate as object)\n        // For line series, set BOTH `series[i].color` (legend swatch +\n        // markers) AND `series[i].lineStyle.color` (the line itself) so\n        // the override paints everywhere a series has a colour slot.\n        const overrideColor = resolveThemeColor(theme, series?.[i]?.color)\n        return {\n          ...(typeof template === 'object' ? template : {}),\n          type: 'line' as const,\n          datasetIndex: i,\n          name: series?.[i]?.name ?? `Series ${i + 1}`,\n          encode: { x: 'name', y: 'value' },\n          smooth,\n          // When a selection is active, surface markers so the per-point\n          // color callback has something to dim — a continuous line would\n          // hide the visual selection feedback.\n          showSymbol: selectionSet != null,\n          ...(area ? { areaStyle: {} } : {}),\n          emphasis: { focus: 'series' },\n          itemStyle: dimItemStyle,\n          ...(overrideColor\n            ? { color: overrideColor, lineStyle: { color: overrideColor } }\n            : {}),\n        }\n      }),\n      legend: { ...baseLegend, show: hasLegend },\n      grid: { ...baseGrid, bottom: gridBottom },\n      ...(dataZoomLayout ? { dataZoom: dataZoomLayout } : {}),\n      yAxis: {\n        ...baseYAxis,\n        min: (extent: { min: number }) => {\n          niceMin = extent.min < 0 ? niceNum(extent.min) : 0\n          return niceMin\n        },\n        max: (extent: { min: number; max: number }) => {\n          niceMax = extent.max <= 0 ? 1 : niceNum(extent.max)\n          return niceMax\n        },\n        axisLabel: {\n          ...((baseYAxis as { axisLabel?: object }).axisLabel ?? {}),\n          formatter: (value: number) => {\n            if (value !== niceMax && value !== niceMin) return ''\n            if (value === 0) return ''\n            return liveFormatter ? liveFormatter(value) : String(value)\n          },\n        },\n      } as EChartsOption['yAxis'],\n      tooltip: {\n        ...baseTooltip,\n        formatter: buildTimeseriesTooltipFormatter(\n          liveFormatter,\n          labelFormatter,\n        ),\n      },\n    } as EChartsOption\n  }\n}\n\n/**\n * Tooltip formatter for the timeseries `{ name, value }` row shape.\n * `name` arrives as `Date | number | string` (the time-axis stores the\n * raw value the consumer supplied). The consumer's `labelFormatter`\n * expects a `Date`, so we coerce non-Date values via `new Date(...)`\n * before invoking it.\n */\nfunction buildTimeseriesTooltipFormatter(\n  formatter: ((value: number) => string) | undefined,\n  labelFormatter: ((value: Date) => string) | undefined,\n) {\n  return createTooltipFormatter((item) => {\n    const row = item.value as\n      { name?: Date | number | string; value?: number } | undefined\n    const raw = row?.value\n    const formattedValue =\n      typeof raw === 'number' && formatter ? formatter(raw) : (raw ?? '')\n    const marker = typeof item.marker === 'string' ? item.marker : ''\n    const seriesName = item.seriesName ? `${item.seriesName}: ` : ''\n    const rawName = row?.name ?? item.name\n    const name =\n      labelFormatter && rawName != null\n        ? labelFormatter(rawName instanceof Date ? rawName : new Date(rawName))\n        : (rawName ?? '')\n    return { name: String(name), seriesName, marker, value: formattedValue }\n  })\n}\n","import { Box, Skeleton } from '@mui/material'\nimport type { SxProps, Theme } from '@mui/material'\n\nconst styles = {\n  container: {\n    display: 'flex',\n    flexDirection: 'column',\n    justifyContent: 'space-between',\n    gap: ({ spacing }) => spacing(1),\n    height: ({ spacing }) => spacing(38),\n  },\n  graph: {\n    position: 'relative',\n    flex: '1 1 auto',\n    width: '100%',\n  },\n  segmentA: {\n    position: 'absolute',\n    left: 0,\n    right: '70%',\n    top: '60%',\n    height: 4,\n  },\n  segmentB: {\n    position: 'absolute',\n    left: '25%',\n    right: '40%',\n    top: '35%',\n    height: 4,\n  },\n  segmentC: {\n    position: 'absolute',\n    left: '55%',\n    right: 0,\n    top: '50%',\n    height: 4,\n  },\n  legend: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(2),\n    height: ({ spacing }) => spacing(5),\n  },\n  legendItem: {\n    display: 'flex',\n    alignItems: 'center',\n    gap: ({ spacing }) => spacing(1.5),\n  },\n} satisfies Record<string, SxProps<Theme>>\n\n/**\n * Loading state for the Timeseries widget. Mirrors a line chart's\n * silhouette — three thin horizontal segments at staggered offsets to\n * suggest a moving line, plus a 2-dot legend stub. Sibling-consistent\n * with Bar / Histogram / Scatter skeletons (column-flex container with\n * legend strip below).\n */\nexport function TimeseriesSkeleton() {\n  return (\n    <Box sx={styles.container}>\n      <Box sx={styles.graph}>\n        <Skeleton variant='rectangular' sx={styles.segmentA} />\n        <Skeleton variant='rectangular' sx={styles.segmentB} />\n        <Skeleton variant='rectangular' sx={styles.segmentC} />\n      </Box>\n      <Box sx={styles.legend}>\n        {[0, 1].map((i) => (\n          <Box key={`legend-${i}`} sx={styles.legendItem}>\n            <Skeleton variant='circular' width={8} height={8} />\n            <Skeleton width={48} height={8} />\n          </Box>\n        ))}\n      </Box>\n    </Box>\n  )\n}\n","import {\n  buildCsvDownloadItem,\n  buildPngDownloadItem,\n  type DownloadItem,\n} from '../actions/download'\nimport type { TimeseriesWidgetData } from './types'\n\n/**\n * Download menu items for the Timeseries widget. Always includes a CSV\n * item with `time, series_1, series_2, …` columns (one row per unique time\n * across all series; ISO-8601 strings for `Date`/numeric times). When\n * `getCaptureEl` is supplied, prepends a PNG item that rasterises the\n * captured element via `html2canvas`.\n */\nexport function createTimeseriesDownloadConfig(args: {\n  filename: string\n  getData: () => TimeseriesWidgetData\n  seriesNames?: readonly string[]\n  getCaptureEl?: () => HTMLElement | null\n  pngPixelRatio?: number\n  pngBackgroundColor?: string | null\n}): DownloadItem[] {\n  const items: DownloadItem[] = []\n  if (args.getCaptureEl) {\n    items.push(\n      buildPngDownloadItem({\n        filename: args.filename,\n        getCaptureEl: args.getCaptureEl,\n        pixelRatio: args.pngPixelRatio,\n        backgroundColor: args.pngBackgroundColor,\n      }),\n    )\n  }\n  items.push(\n    buildCsvDownloadItem({\n      filename: args.filename,\n      getRows: () => {\n        const data = args.getData()\n        const seriesCount = data.length\n\n        // Collect every unique time, preserving insertion order.\n        const timeKeys: (Date | number | string)[] = []\n        const seenKeys = new Set<string>()\n        for (const series of data) {\n          for (const point of series) {\n            const key = String(point.name)\n            if (!seenKeys.has(key)) {\n              seenKeys.add(key)\n              timeKeys.push(point.name)\n            }\n          }\n        }\n\n        // Build a quick lookup per series for O(rows × series) emit.\n        const lookups = data.map(\n          (series) => new Map(series.map((p) => [String(p.name), p.value])),\n        )\n\n        const header: unknown[] = ['time']\n        for (let i = 0; i < seriesCount; i++) {\n          header.push(args.seriesNames?.[i] ?? `series_${i + 1}`)\n        }\n        const rows: unknown[][] = [header]\n        for (const key of timeKeys) {\n          const row: unknown[] = [formatTime(key)]\n          const lookupKey = String(key)\n          for (const lookup of lookups) row.push(lookup.get(lookupKey) ?? '')\n          rows.push(row)\n        }\n\n        return rows\n      },\n    }),\n  )\n  return items\n}\n\nfunction formatTime(v: Date | number | string): string {\n  if (v instanceof Date) return v.toISOString()\n  if (typeof v === 'number') return new Date(v).toISOString()\n  return v\n}\n","/**\n * `LockSelection` filter for Timeseries. Data is `{name, value}[][]` like\n * Bar/Pie/Category, but `name` may arrive as `Date | number | string` (the\n * time axis stores a `Date`). `lockedItems` is snapshotted from `selection`,\n * whose keys are already normalized to `Date → ms` (see `options.ts`'s\n * `normalizeName`) — so a raw `Date` name must be normalized the same way\n * before the membership check, or every point would compare a `Date` object\n * against a `number` and silently fail to match, filtering everything out.\n */\nexport function filterTimeseriesByLockedItems(\n  input: unknown,\n  lockedItems: readonly (string | number)[],\n): unknown {\n  if (lockedItems.length === 0) return input\n  if (!Array.isArray(input)) return input\n  const locked = new Set<string | number>(lockedItems)\n  return input.map((series: unknown): unknown => {\n    if (!Array.isArray(series)) return series\n    return series.filter((item: unknown) => {\n      if (item == null || typeof item !== 'object' || !('name' in item)) {\n        return false\n      }\n      const raw = (item as { name: unknown }).name\n      const name = raw instanceof Date ? raw.getTime() : raw\n      return (\n        (typeof name === 'string' || typeof name === 'number') &&\n        locked.has(name)\n      )\n    })\n  })\n}\n"],"mappings":"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"}

package/dist/widgets-v2/utils.js

@@ -0,0 +1,2 @@
+import { n as e, r as t, t as n } from "../utils-Dr6gf3vD.js";
+export { t as mergeOptions, e as positionDataZoomForLegend, n as resolveThemeColor };