@stealthscale/component-charts 0.2.2 → 0.2.3

package/dist/pages/stacked-bar-chart/stacked-bar-chart.props.js

@@ -0,0 +1,3 @@
+export const dropped = {"StackedBarChartProps": {"conditions": 284, "foreign": 1039}};
+export const parts = {"StackedBarChartProps": [{"accepts": "boolean", "fallback": "", "kind": "option", "name": "animate", "refers": [], "required": false, "says": "Whether the marks animate in, which they do only outside reduced motion."}, {"accepts": "readonly Annotation[]", "fallback": "", "kind": "option", "name": "annotations", "refers": ["kit.Annotation", "kit.ChartColor"], "required": false, "says": "Marks pinned to the data, a moment, a period or a point each, which the tooltip lists at their category. None unless stated."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "caption", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Finding the chart shows, in words, which names the figure."}, {"accepts": "Extract<keyof Row, string>", "fallback": "", "kind": "option", "name": "categoryKey", "refers": [], "required": true, "says": "Field of each row the category axis reads, such as a day or a plan."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "children", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Recharts elements rendered inside the chart after the marks, such as a `ReferenceLine`."}, {"accepts": "Row[]", "fallback": "", "kind": "option", "name": "data", "refers": ["kit.Row"], "required": true, "says": "Rows the chart plots, in order. The array passes to recharts as it is."}, {"accepts": "readonly string[]", "fallback": "", "kind": "option", "name": "defaultHiddenKeys", "refers": [], "required": false, "says": "Keys of the series hidden when the chart first renders, for the uncontrolled case."}, {"accepts": "number", "fallback": "", "kind": "option", "name": "defaultIndex", "refers": [], "required": false, "says": "Index in `data` of the row the tooltip shows when the chart first renders, until the pointer or a key moves it. No tooltip shows at first unless stated."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "empty", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Message the chart renders in the plot's place while it has no rows."}, {"accepts": "boolean", "fallback": "", "kind": "option", "name": "grid", "refers": [], "required": false, "says": "Whether lines cross the plot at the value ticks."}, {"accepts": "readonly string[]", "fallback": "", "kind": "option", "name": "hiddenKeys", "refers": [], "required": false, "says": "Keys of the series the legend hides, where the caller controls them."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "label", "refers": [], "required": true, "says": "Accessible name of the chart's keyboard layer, such as \"Revenue per day\"."}, {"accepts": "DateTimeFormatOptions", "fallback": "", "kind": "option", "name": "labelOptions", "refers": [], "required": false, "says": "`Intl.DateTimeFormat` options the category ticks and the tooltip's heading are written with, for a time axis. The category as it is unless stated."}, {"accepts": "boolean", "fallback": "", "kind": "option", "name": "legend", "refers": [], "required": false, "says": "Whether the legend renders below the plot. It renders while two or more series have rows unless stated."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "legendLabel", "refers": [], "required": false, "says": "Accessible name of the legend's group of buttons."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "locale", "refers": [], "required": false, "says": "Locale the values are written in. The locale in scope unless stated."}, {"accepts": "((hidden: readonly string[]) => void)", "fallback": "", "kind": "option", "name": "onHiddenKeysChange", "refers": [], "required": false, "says": "Called with every key hidden after a press in the legend."}, {"accepts": "\"golden\" | \"landscape\" | \"portrait\" | \"rows\" | \"square\" | \"ultrawide\" | \"video\" | \"wide\"", "fallback": "", "kind": "variant", "name": "ratio", "refers": [], "required": false, "says": "Aspect ratio of the plot and of the empty state in its place, one of the theme's ratios, or `rows` for a plot as tall as its rows."}, {"accepts": "readonly CartesianSeries[]", "fallback": "", "kind": "option", "name": "series", "refers": ["kit.CartesianSeries", "kit.ChartColor", "react.ReactElement", "react.ReactPortal"], "required": true, "says": "Series the chart plots, in the order the legend lists them."}, {"accepts": "AxisDomain", "fallback": "", "kind": "option", "name": "valueDomain", "refers": ["recharts.AxisDomain", "recharts.AxisDomainItem", "recharts.NumberDomain"], "required": false, "says": "Domain of the value axis in recharts' terms, such as `[0, 100]`. From zero unless stated."}, {"accepts": "NumberFormatOptions", "fallback": "", "kind": "option", "name": "valueOptions", "refers": [], "required": false, "says": "`Intl.NumberFormat` options the value ticks and the tooltip's values are written with."}]};
+export const shapes = {"kit.Annotation": [{"accepts": "string | number", "name": "at", "says": "Category the mark is at, or the category its period starts at."}, {"accepts": "ChartColor", "name": "color", "says": "Palette of the mark, such as `warning` for a flagged point. The neutral palette unless stated."}, {"accepts": "string", "name": "key", "says": "Identity of the mark, unique among the chart's annotations."}, {"accepts": "string", "name": "label", "says": "Words for the mark, written on the plot and in the tooltip at its category."}, {"accepts": "string | number", "name": "until", "says": "Category the mark's period ends at, which makes the mark a period."}, {"accepts": "number", "name": "value", "says": "Value of the point the mark rings, which makes the mark a point."}], "kit.ChartColor": [{"accepts": "", "name": "\"accent\"", "says": ""}, {"accepts": "", "name": "\"blue\"", "says": ""}, {"accepts": "", "name": "\"cyan\"", "says": ""}, {"accepts": "", "name": "\"error\"", "says": ""}, {"accepts": "", "name": "\"gray\"", "says": ""}, {"accepts": "", "name": "\"green\"", "says": ""}, {"accepts": "", "name": "\"indigo\"", "says": ""}, {"accepts": "", "name": "\"info\"", "says": ""}, {"accepts": "", "name": "\"neutral\"", "says": ""}, {"accepts": "", "name": "\"orange\"", "says": ""}, {"accepts": "", "name": "\"pink\"", "says": ""}, {"accepts": "", "name": "\"primary\"", "says": ""}, {"accepts": "", "name": "\"purple\"", "says": ""}, {"accepts": "", "name": "\"red\"", "says": ""}, {"accepts": "", "name": "\"secondary\"", "says": ""}, {"accepts": "", "name": "\"series.1\"", "says": ""}, {"accepts": "", "name": "\"series.2\"", "says": ""}, {"accepts": "", "name": "\"series.3\"", "says": ""}, {"accepts": "", "name": "\"series.4\"", "says": ""}, {"accepts": "", "name": "\"series.5\"", "says": ""}, {"accepts": "", "name": "\"series.6\"", "says": ""}, {"accepts": "", "name": "\"series.7\"", "says": ""}, {"accepts": "", "name": "\"series.8\"", "says": ""}, {"accepts": "", "name": "\"success\"", "says": ""}, {"accepts": "", "name": "\"teal\"", "says": ""}, {"accepts": "", "name": "\"warning\"", "says": ""}, {"accepts": "", "name": "\"yellow\"", "says": ""}], "react.ReactElement": [{"accepts": "string | JSXElementConstructor<any>", "name": "type", "says": ""}, {"accepts": "unknown", "name": "props", "says": ""}, {"accepts": "string | null", "name": "key", "says": ""}], "react.ReactPortal": [{"accepts": "ReactNode", "name": "children", "says": ""}, {"accepts": "string | JSXElementConstructor<any>", "name": "type", "says": ""}, {"accepts": "unknown", "name": "props", "says": ""}, {"accepts": "string | null", "name": "key", "says": ""}], "kit.CartesianSeries": [{"accepts": "ChartColor", "name": "color", "says": "Palette the series takes its color from. The theme's series color at its position unless stated."}, {"accepts": "boolean", "name": "dashed", "says": "Whether the series' line renders dashed, as a target or a projection does. A series with `previousOf` renders dashed unless stated."}, {"accepts": "string", "name": "previousOf", "says": "Key of the series this series is the earlier period of, such as last week's revenue for this week's. The series takes the neutral palette unless it states a color, and the tooltip writes the change from it after the other series' value."}, {"accepts": "number", "name": "ink", "says": "Share of the ink, `fg`, in percent, the series' color mixes in: 0 keeps the color, 100 is the ink. The mix keeps 3:1 or more against the page. None unless stated."}, {"accepts": "string", "name": "key", "says": "Field of each row the series reads, which a recharts mark takes as its `dataKey`."}, {"accepts": "ReactNode", "name": "label", "says": "Name the tooltip and the legend show. The key unless stated."}], "recharts.AxisDomain": [{"accepts": "", "name": "readonly string[]", "says": ""}, {"accepts": "", "name": "readonly number[]", "says": ""}, {"accepts": "", "name": "([dataMin, dataMax]: NumberDomain, allowDataOverflow: boolean) => NumberDomain", "says": ""}, {"accepts": "", "name": "readonly [AxisDomainItem, AxisDomainItem]", "says": ""}], "recharts.AxisDomainItem": [{"accepts": "", "name": "string", "says": ""}, {"accepts": "", "name": "number", "says": ""}, {"accepts": "", "name": "(d: number) => string | number", "says": ""}]};

package/dist/pages/step-line-chart/step-line-chart.js

@@ -0,0 +1,573 @@
+import { t as __exportAll } from "../../rolldown-runtime-D7D4PA-g.js";
+import { f as StepLineChart } from "../../shared-DVZJ2nST.js";
+import { c } from "react/compiler-runtime";
+import { useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Room, specimen, useWords } from "@stealthscale/specimen";
+import { RotateCcwIcon } from "lucide-react";
+import { Button } from "@stealthscale/component-actions";
+import { Stack } from "@stealthscale/component-layout";
+//#region src/step-line-chart/examples/idle.example.tsx
+var idle_example_exports = /* @__PURE__ */ __exportAll({
+	Idle: () => Idle,
+	source: () => source$3
+});
+const READINGS$3 = [];
+function Idle() {
+	const $ = c(22);
+	const { t } = useWords("step-line-chart");
+	let t0;
+	if ($[0] !== t) {
+		t0 = t("idle.caption");
+		$[0] = t;
+		$[1] = t0;
+	} else t0 = $[1];
+	let t1;
+	if ($[2] !== t) {
+		t1 = t("idle.empty");
+		$[2] = t;
+		$[3] = t1;
+	} else t1 = $[3];
+	let t2;
+	if ($[4] !== t) {
+		t2 = t("replicas.label");
+		$[4] = t;
+		$[5] = t2;
+	} else t2 = $[5];
+	let t3;
+	if ($[6] !== t) {
+		t3 = t("replicas.api");
+		$[6] = t;
+		$[7] = t3;
+	} else t3 = $[7];
+	let t4;
+	if ($[8] !== t3) {
+		t4 = {
+			key: "api",
+			label: t3
+		};
+		$[8] = t3;
+		$[9] = t4;
+	} else t4 = $[9];
+	let t5;
+	if ($[10] !== t) {
+		t5 = t("replicas.worker");
+		$[10] = t;
+		$[11] = t5;
+	} else t5 = $[11];
+	let t6;
+	if ($[12] !== t5) {
+		t6 = {
+			key: "worker",
+			label: t5
+		};
+		$[12] = t5;
+		$[13] = t6;
+	} else t6 = $[13];
+	let t7;
+	if ($[14] !== t4 || $[15] !== t6) {
+		t7 = [t4, t6];
+		$[14] = t4;
+		$[15] = t6;
+		$[16] = t7;
+	} else t7 = $[16];
+	let t8;
+	if ($[17] !== t0 || $[18] !== t1 || $[19] !== t2 || $[20] !== t7) {
+		t8 = /* @__PURE__ */ jsx(StepLineChart, {
+			caption: t0,
+			categoryKey: "at",
+			data: READINGS$3,
+			empty: t1,
+			label: t2,
+			series: t7
+		});
+		$[17] = t0;
+		$[18] = t1;
+		$[19] = t2;
+		$[20] = t7;
+		$[21] = t8;
+	} else t8 = $[21];
+	return t8;
+}
+const source$3 = "import { type ReactElement } from \"react\";\n\nimport { useWords } from \"@stealthscale/specimen\";\n\nimport { StepLineChart } from \"@stealthscale/component-charts\";\n\nconst READINGS: Array<{ api: number; at: string; worker: number }> = [];\n\nexport function Idle(): ReactElement {\n  const { t } = useWords(\"step-line-chart\");\n\n  return (\n    <StepLineChart\n      caption={t(\"idle.caption\")}\n      categoryKey=\"at\"\n      data={READINGS}\n      empty={t(\"idle.empty\")}\n      label={t(\"replicas.label\")}\n      series={[\n        { key: \"api\", label: t(\"replicas.api\") },\n        { key: \"worker\", label: t(\"replicas.worker\") },\n      ]}\n    />\n  );\n}\n";
+//#endregion
+//#region src/step-line-chart/examples/replay.example.tsx
+var replay_example_exports = /* @__PURE__ */ __exportAll({
+	Replay: () => Replay,
+	source: () => source$2
+});
+const READINGS$2 = [
+	[3, 2],
+	[3, 2],
+	[5, 2],
+	[8, 4],
+	[8, 6],
+	[8, 6],
+	[6, 6],
+	[4, 4],
+	[4, 2],
+	[3, 2]
+].map(([api, worker], index) => ({
+	api,
+	at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, "0")}:${String(index % 6 * 10).padStart(2, "0")}:00Z`,
+	worker
+}));
+function Replay() {
+	const $ = c(36);
+	const { t } = useWords("step-line-chart");
+	const [run, setRun] = useState(0);
+	let t0;
+	if ($[0] !== t) {
+		t0 = t("replicas.caption");
+		$[0] = t;
+		$[1] = t0;
+	} else t0 = $[1];
+	let t1;
+	if ($[2] !== t) {
+		t1 = t("replicas.label");
+		$[2] = t;
+		$[3] = t1;
+	} else t1 = $[3];
+	let t2;
+	if ($[4] === Symbol.for("react.memo_cache_sentinel")) {
+		t2 = {
+			hour: "2-digit",
+			hourCycle: "h23",
+			minute: "2-digit",
+			timeZone: "UTC"
+		};
+		$[4] = t2;
+	} else t2 = $[4];
+	let t3;
+	if ($[5] !== t) {
+		t3 = t("series");
+		$[5] = t;
+		$[6] = t3;
+	} else t3 = $[6];
+	let t4;
+	if ($[7] !== t) {
+		t4 = t("replicas.api");
+		$[7] = t;
+		$[8] = t4;
+	} else t4 = $[8];
+	let t5;
+	if ($[9] !== t4) {
+		t5 = {
+			key: "api",
+			label: t4
+		};
+		$[9] = t4;
+		$[10] = t5;
+	} else t5 = $[10];
+	let t6;
+	if ($[11] !== t) {
+		t6 = t("replicas.worker");
+		$[11] = t;
+		$[12] = t6;
+	} else t6 = $[12];
+	let t7;
+	if ($[13] !== t6) {
+		t7 = {
+			key: "worker",
+			label: t6
+		};
+		$[13] = t6;
+		$[14] = t7;
+	} else t7 = $[14];
+	let t8;
+	if ($[15] !== t5 || $[16] !== t7) {
+		t8 = [t5, t7];
+		$[15] = t5;
+		$[16] = t7;
+		$[17] = t8;
+	} else t8 = $[17];
+	let t9;
+	if ($[18] === Symbol.for("react.memo_cache_sentinel")) {
+		t9 = { maximumFractionDigits: 0 };
+		$[18] = t9;
+	} else t9 = $[18];
+	let t10;
+	if ($[19] !== run || $[20] !== t0 || $[21] !== t1 || $[22] !== t3 || $[23] !== t8) {
+		t10 = /* @__PURE__ */ jsx(StepLineChart, {
+			animate: true,
+			caption: t0,
+			categoryKey: "at",
+			data: READINGS$2,
+			label: t1,
+			labelOptions: t2,
+			legendLabel: t3,
+			series: t8,
+			valueOptions: t9
+		}, run);
+		$[19] = run;
+		$[20] = t0;
+		$[21] = t1;
+		$[22] = t3;
+		$[23] = t8;
+		$[24] = t10;
+	} else t10 = $[24];
+	let t11;
+	if ($[25] !== run) {
+		t11 = () => {
+			setRun(run + 1);
+		};
+		$[25] = run;
+		$[26] = t11;
+	} else t11 = $[26];
+	let t12;
+	if ($[27] === Symbol.for("react.memo_cache_sentinel")) {
+		t12 = /* @__PURE__ */ jsx(RotateCcwIcon, {});
+		$[27] = t12;
+	} else t12 = $[27];
+	let t13;
+	if ($[28] !== t) {
+		t13 = t("replay.replay");
+		$[28] = t;
+		$[29] = t13;
+	} else t13 = $[29];
+	let t14;
+	if ($[30] !== t11 || $[31] !== t13) {
+		t14 = /* @__PURE__ */ jsxs(Button, {
+			onClick: t11,
+			size: "sm",
+			variant: "outline",
+			children: [t12, t13]
+		});
+		$[30] = t11;
+		$[31] = t13;
+		$[32] = t14;
+	} else t14 = $[32];
+	let t15;
+	if ($[33] !== t10 || $[34] !== t14) {
+		t15 = /* @__PURE__ */ jsxs(Stack, {
+			align: "flex-start",
+			children: [t10, t14]
+		});
+		$[33] = t10;
+		$[34] = t14;
+		$[35] = t15;
+	} else t15 = $[35];
+	return t15;
+}
+const source$2 = "import { type ReactElement, useState } from \"react\";\n\nimport { RotateCcwIcon } from \"lucide-react\";\n\nimport { Button } from \"@stealthscale/component-actions\";\nimport { Stack } from \"@stealthscale/component-layout\";\nimport { useWords } from \"@stealthscale/specimen\";\n\nimport { StepLineChart } from \"@stealthscale/component-charts\";\n\nconst READINGS = [\n  [3, 2],\n  [3, 2],\n  [5, 2],\n  [8, 4],\n  [8, 6],\n  [8, 6],\n  [6, 6],\n  [4, 4],\n  [4, 2],\n  [3, 2],\n].map(([api, worker], index) => ({\n  api,\n  at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, \"0\")}:${String((index % 6) * 10).padStart(2, \"0\")}:00Z`,\n  worker,\n}));\n\nexport function Replay(): ReactElement {\n  const { t } = useWords(\"step-line-chart\");\n  const [run, setRun] = useState(0);\n\n  return (\n    <Stack align=\"flex-start\">\n      <StepLineChart\n        animate\n        caption={t(\"replicas.caption\")}\n        categoryKey=\"at\"\n        data={READINGS}\n        key={run}\n        label={t(\"replicas.label\")}\n        labelOptions={{ hour: \"2-digit\", hourCycle: \"h23\", minute: \"2-digit\", timeZone: \"UTC\" }}\n        legendLabel={t(\"series\")}\n        series={[\n          { key: \"api\", label: t(\"replicas.api\") },\n          { key: \"worker\", label: t(\"replicas.worker\") },\n        ]}\n        valueOptions={{ maximumFractionDigits: 0 }}\n      />\n      <Button\n        onClick={() => {\n          setRun(run + 1);\n        }}\n        size=\"sm\"\n        variant=\"outline\"\n      >\n        <RotateCcwIcon />\n        {t(\"replay.replay\")}\n      </Button>\n    </Stack>\n  );\n}\n";
+//#endregion
+//#region src/step-line-chart/examples/replicas.example.tsx
+var replicas_example_exports = /* @__PURE__ */ __exportAll({
+	Replicas: () => Replicas,
+	source: () => source$1
+});
+const READINGS$1 = [
+	[3, 2],
+	[3, 2],
+	[5, 2],
+	[8, 4],
+	[8, 6],
+	[8, 6],
+	[6, 6],
+	[4, 4],
+	[4, 2],
+	[3, 2]
+].map(([api, worker], index) => ({
+	api,
+	at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, "0")}:${String(index % 6 * 10).padStart(2, "0")}:00Z`,
+	worker
+}));
+function Replicas() {
+	const $ = c(24);
+	const { t } = useWords("step-line-chart");
+	let t0;
+	if ($[0] !== t) {
+		t0 = t("replicas.caption");
+		$[0] = t;
+		$[1] = t0;
+	} else t0 = $[1];
+	let t1;
+	if ($[2] !== t) {
+		t1 = t("replicas.label");
+		$[2] = t;
+		$[3] = t1;
+	} else t1 = $[3];
+	let t2;
+	if ($[4] === Symbol.for("react.memo_cache_sentinel")) {
+		t2 = {
+			hour: "2-digit",
+			hourCycle: "h23",
+			minute: "2-digit",
+			timeZone: "UTC"
+		};
+		$[4] = t2;
+	} else t2 = $[4];
+	let t3;
+	if ($[5] !== t) {
+		t3 = t("series");
+		$[5] = t;
+		$[6] = t3;
+	} else t3 = $[6];
+	let t4;
+	if ($[7] !== t) {
+		t4 = t("replicas.api");
+		$[7] = t;
+		$[8] = t4;
+	} else t4 = $[8];
+	let t5;
+	if ($[9] !== t4) {
+		t5 = {
+			key: "api",
+			label: t4
+		};
+		$[9] = t4;
+		$[10] = t5;
+	} else t5 = $[10];
+	let t6;
+	if ($[11] !== t) {
+		t6 = t("replicas.worker");
+		$[11] = t;
+		$[12] = t6;
+	} else t6 = $[12];
+	let t7;
+	if ($[13] !== t6) {
+		t7 = {
+			key: "worker",
+			label: t6
+		};
+		$[13] = t6;
+		$[14] = t7;
+	} else t7 = $[14];
+	let t8;
+	if ($[15] !== t5 || $[16] !== t7) {
+		t8 = [t5, t7];
+		$[15] = t5;
+		$[16] = t7;
+		$[17] = t8;
+	} else t8 = $[17];
+	let t9;
+	if ($[18] === Symbol.for("react.memo_cache_sentinel")) {
+		t9 = { maximumFractionDigits: 0 };
+		$[18] = t9;
+	} else t9 = $[18];
+	let t10;
+	if ($[19] !== t0 || $[20] !== t1 || $[21] !== t3 || $[22] !== t8) {
+		t10 = /* @__PURE__ */ jsx(StepLineChart, {
+			caption: t0,
+			categoryKey: "at",
+			data: READINGS$1,
+			label: t1,
+			labelOptions: t2,
+			legendLabel: t3,
+			series: t8,
+			valueOptions: t9
+		});
+		$[19] = t0;
+		$[20] = t1;
+		$[21] = t3;
+		$[22] = t8;
+		$[23] = t10;
+	} else t10 = $[23];
+	return t10;
+}
+const source$1 = "import { type ReactElement } from \"react\";\n\nimport { useWords } from \"@stealthscale/specimen\";\n\nimport { StepLineChart } from \"@stealthscale/component-charts\";\n\nconst READINGS = [\n  [3, 2],\n  [3, 2],\n  [5, 2],\n  [8, 4],\n  [8, 6],\n  [8, 6],\n  [6, 6],\n  [4, 4],\n  [4, 2],\n  [3, 2],\n].map(([api, worker], index) => ({\n  api,\n  at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, \"0\")}:${String((index % 6) * 10).padStart(2, \"0\")}:00Z`,\n  worker,\n}));\n\nexport function Replicas(): ReactElement {\n  const { t } = useWords(\"step-line-chart\");\n\n  return (\n    <StepLineChart\n      caption={t(\"replicas.caption\")}\n      categoryKey=\"at\"\n      data={READINGS}\n      label={t(\"replicas.label\")}\n      labelOptions={{ hour: \"2-digit\", hourCycle: \"h23\", minute: \"2-digit\", timeZone: \"UTC\" }}\n      legendLabel={t(\"series\")}\n      series={[\n        { key: \"api\", label: t(\"replicas.api\") },\n        { key: \"worker\", label: t(\"replicas.worker\") },\n      ]}\n      valueOptions={{ maximumFractionDigits: 0 }}\n    />\n  );\n}\n";
+//#endregion
+//#region src/step-line-chart/examples/scale.example.tsx
+var scale_example_exports = /* @__PURE__ */ __exportAll({
+	Scale: () => Scale,
+	source: () => source
+});
+const READINGS = [
+	[3, 2],
+	[3, 2],
+	[5, 2],
+	[8, 4],
+	[8, 6],
+	[8, 6],
+	[6, 6],
+	[4, 4],
+	[4, 2],
+	[3, 2]
+].map(([api, worker], index) => ({
+	api,
+	at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, "0")}:${String(index % 6 * 10).padStart(2, "0")}:00Z`,
+	worker
+}));
+function Scale() {
+	const $ = c(24);
+	const { t } = useWords("step-line-chart");
+	let t0;
+	if ($[0] !== t) {
+		t0 = t("scale.caption");
+		$[0] = t;
+		$[1] = t0;
+	} else t0 = $[1];
+	let t1;
+	if ($[2] !== t) {
+		t1 = t("replicas.label");
+		$[2] = t;
+		$[3] = t1;
+	} else t1 = $[3];
+	let t2;
+	if ($[4] === Symbol.for("react.memo_cache_sentinel")) {
+		t2 = {
+			hour: "2-digit",
+			hourCycle: "h23",
+			minute: "2-digit",
+			timeZone: "UTC"
+		};
+		$[4] = t2;
+	} else t2 = $[4];
+	let t3;
+	if ($[5] !== t) {
+		t3 = t("series");
+		$[5] = t;
+		$[6] = t3;
+	} else t3 = $[6];
+	let t4;
+	if ($[7] !== t) {
+		t4 = t("replicas.api");
+		$[7] = t;
+		$[8] = t4;
+	} else t4 = $[8];
+	let t5;
+	if ($[9] !== t4) {
+		t5 = {
+			key: "api",
+			label: t4
+		};
+		$[9] = t4;
+		$[10] = t5;
+	} else t5 = $[10];
+	let t6;
+	if ($[11] !== t) {
+		t6 = t("replicas.worker");
+		$[11] = t;
+		$[12] = t6;
+	} else t6 = $[12];
+	let t7;
+	if ($[13] !== t6) {
+		t7 = {
+			key: "worker",
+			label: t6
+		};
+		$[13] = t6;
+		$[14] = t7;
+	} else t7 = $[14];
+	let t8;
+	if ($[15] !== t5 || $[16] !== t7) {
+		t8 = [t5, t7];
+		$[15] = t5;
+		$[16] = t7;
+		$[17] = t8;
+	} else t8 = $[17];
+	let t9;
+	if ($[18] === Symbol.for("react.memo_cache_sentinel")) {
+		t9 = { maximumFractionDigits: 0 };
+		$[18] = t9;
+	} else t9 = $[18];
+	let t10;
+	if ($[19] !== t0 || $[20] !== t1 || $[21] !== t3 || $[22] !== t8) {
+		t10 = /* @__PURE__ */ jsx(StepLineChart, {
+			caption: t0,
+			categoryKey: "at",
+			data: READINGS,
+			defaultIndex: 3,
+			label: t1,
+			labelOptions: t2,
+			legendLabel: t3,
+			series: t8,
+			valueOptions: t9
+		});
+		$[19] = t0;
+		$[20] = t1;
+		$[21] = t3;
+		$[22] = t8;
+		$[23] = t10;
+	} else t10 = $[23];
+	return t10;
+}
+const source = "import { type ReactElement } from \"react\";\n\nimport { useWords } from \"@stealthscale/specimen\";\n\nimport { StepLineChart } from \"@stealthscale/component-charts\";\n\nconst READINGS = [\n  [3, 2],\n  [3, 2],\n  [5, 2],\n  [8, 4],\n  [8, 6],\n  [8, 6],\n  [6, 6],\n  [4, 4],\n  [4, 2],\n  [3, 2],\n].map(([api, worker], index) => ({\n  api,\n  at: `2026-09-28T${String(12 + Math.floor(index / 6)).padStart(2, \"0\")}:${String((index % 6) * 10).padStart(2, \"0\")}:00Z`,\n  worker,\n}));\n\nexport function Scale(): ReactElement {\n  const { t } = useWords(\"step-line-chart\");\n\n  return (\n    <StepLineChart\n      caption={t(\"scale.caption\")}\n      categoryKey=\"at\"\n      data={READINGS}\n      defaultIndex={3}\n      label={t(\"replicas.label\")}\n      labelOptions={{ hour: \"2-digit\", hourCycle: \"h23\", minute: \"2-digit\", timeZone: \"UTC\" }}\n      legendLabel={t(\"series\")}\n      series={[\n        { key: \"api\", label: t(\"replicas.api\") },\n        { key: \"worker\", label: t(\"replicas.worker\") },\n      ]}\n      valueOptions={{ maximumFractionDigits: 0 }}\n    />\n  );\n}\n";
+//#endregion
+//#region src/step-line-chart/step-line-chart.specimen.tsx
+/**
+* Catalogue page for the step line chart.
+*
+* @remarks
+*   The step line chart has no recipe of its own: the chart's recipe styles its figure, so every
+*   scene is hand-written. The scenes render the replicas of two services every 10 minutes, the
+*   tooltip open at the API's peak, the steps animated in with a replay, the replicas at a phone's
+*   width, and a range without readings. Every scene renders a component from `examples/` and
+*   shows that file as its source. The words are keys under `step-line-chart` in
+*   `locales/en/specimen/step-line-chart.json`.
+*/
+/**
+* Hand-written scene for the replicas of two services.
+*/
+const steps = {
+	about: "step-line-chart.replicas.about",
+	draw: () => /* @__PURE__ */ jsx(Room, {
+		size: "lg",
+		children: /* @__PURE__ */ jsx(Replicas, {})
+	}),
+	example: replicas_example_exports,
+	title: "step-line-chart.replicas.title"
+};
+/**
+* Hand-written scene for the tooltip open at a reading.
+*/
+const tooltip = {
+	about: "step-line-chart.scale.about",
+	draw: () => /* @__PURE__ */ jsx(Room, {
+		size: "lg",
+		children: /* @__PURE__ */ jsx(Scale, {})
+	}),
+	example: scale_example_exports,
+	title: "step-line-chart.scale.title"
+};
+/**
+* Hand-written scene for the steps animated in, with a replay.
+*/
+const animated = {
+	about: "step-line-chart.replay.about",
+	draw: () => /* @__PURE__ */ jsx(Room, {
+		size: "lg",
+		children: /* @__PURE__ */ jsx(Replay, {})
+	}),
+	example: replay_example_exports,
+	title: "step-line-chart.replay.title"
+};
+/**
+* Hand-written scene for the replicas at a phone's width.
+*/
+const narrow = {
+	about: "step-line-chart.narrow.about",
+	draw: () => /* @__PURE__ */ jsx(Room, {
+		size: "xs",
+		children: /* @__PURE__ */ jsx(Replicas, {})
+	}),
+	example: replicas_example_exports,
+	title: "step-line-chart.narrow.title"
+};
+/**
+* Hand-written scene for a range without readings.
+*/
+const empty = {
+	about: "step-line-chart.idle.about",
+	draw: () => /* @__PURE__ */ jsx(Room, {
+		size: "md",
+		children: /* @__PURE__ */ jsx(Idle, {})
+	}),
+	example: idle_example_exports,
+	title: "step-line-chart.idle.title"
+};
+var step_line_chart_specimen_default = specimen({
+	about: "step-line-chart.about",
+	id: "components/charts/step-line-chart",
+	imports: "import { StepLineChart } from \"@stealthscale/component-charts\";",
+	scenes: [
+		steps,
+		tooltip,
+		animated,
+		narrow,
+		empty
+	],
+	title: "step-line-chart.title"
+});
+//#endregion
+export { animated, step_line_chart_specimen_default as default, empty, narrow, steps, tooltip };

package/dist/pages/step-line-chart/step-line-chart.props.js

@@ -0,0 +1,3 @@
+export const dropped = {"StepLineChartProps": {"conditions": 284, "foreign": 1039}};
+export const parts = {"StepLineChartProps": [{"accepts": "boolean", "fallback": "", "kind": "option", "name": "animate", "refers": [], "required": false, "says": "Whether the marks animate in, which they do only outside reduced motion."}, {"accepts": "readonly Annotation[]", "fallback": "", "kind": "option", "name": "annotations", "refers": ["kit.Annotation", "kit.ChartColor"], "required": false, "says": "Marks pinned to the data, a moment, a period or a point each, which the tooltip lists at their category. None unless stated."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "caption", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Finding the chart shows, in words, which names the figure."}, {"accepts": "Extract<keyof Row, string>", "fallback": "", "kind": "option", "name": "categoryKey", "refers": [], "required": true, "says": "Field of each row the category axis reads, such as a day or a plan."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "children", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Recharts elements rendered inside the chart after the marks, such as a `ReferenceLine`."}, {"accepts": "Row[]", "fallback": "", "kind": "option", "name": "data", "refers": ["kit.Row"], "required": true, "says": "Rows the chart plots, in order. The array passes to recharts as it is."}, {"accepts": "readonly string[]", "fallback": "", "kind": "option", "name": "defaultHiddenKeys", "refers": [], "required": false, "says": "Keys of the series hidden when the chart first renders, for the uncontrolled case."}, {"accepts": "number", "fallback": "", "kind": "option", "name": "defaultIndex", "refers": [], "required": false, "says": "Index in `data` of the row the tooltip shows when the chart first renders, until the pointer or a key moves it. No tooltip shows at first unless stated."}, {"accepts": "ReactNode", "fallback": "", "kind": "option", "name": "empty", "refers": ["react.ReactElement", "react.ReactPortal"], "required": false, "says": "Message the chart renders in the plot's place while it has no rows."}, {"accepts": "boolean", "fallback": "", "kind": "option", "name": "grid", "refers": [], "required": false, "says": "Whether lines cross the plot at the value ticks."}, {"accepts": "readonly string[]", "fallback": "", "kind": "option", "name": "hiddenKeys", "refers": [], "required": false, "says": "Keys of the series the legend hides, where the caller controls them."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "label", "refers": [], "required": true, "says": "Accessible name of the chart's keyboard layer, such as \"Revenue per day\"."}, {"accepts": "DateTimeFormatOptions", "fallback": "", "kind": "option", "name": "labelOptions", "refers": [], "required": false, "says": "`Intl.DateTimeFormat` options the category ticks and the tooltip's heading are written with, for a time axis. The category as it is unless stated."}, {"accepts": "boolean", "fallback": "", "kind": "option", "name": "legend", "refers": [], "required": false, "says": "Whether the legend renders below the plot. It renders while two or more series have rows unless stated."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "legendLabel", "refers": [], "required": false, "says": "Accessible name of the legend's group of buttons."}, {"accepts": "string", "fallback": "", "kind": "option", "name": "locale", "refers": [], "required": false, "says": "Locale the values are written in. The locale in scope unless stated."}, {"accepts": "((hidden: readonly string[]) => void)", "fallback": "", "kind": "option", "name": "onHiddenKeysChange", "refers": [], "required": false, "says": "Called with every key hidden after a press in the legend."}, {"accepts": "\"golden\" | \"landscape\" | \"portrait\" | \"rows\" | \"square\" | \"ultrawide\" | \"video\" | \"wide\"", "fallback": "", "kind": "variant", "name": "ratio", "refers": [], "required": false, "says": "Aspect ratio of the plot and of the empty state in its place, one of the theme's ratios, or `rows` for a plot as tall as its rows."}, {"accepts": "readonly CartesianSeries[]", "fallback": "", "kind": "option", "name": "series", "refers": ["kit.CartesianSeries", "kit.ChartColor", "react.ReactElement", "react.ReactPortal"], "required": true, "says": "Series the chart plots, in the order the legend lists them."}, {"accepts": "AxisDomain", "fallback": "", "kind": "option", "name": "valueDomain", "refers": ["recharts.AxisDomain", "recharts.AxisDomainItem", "recharts.NumberDomain"], "required": false, "says": "Domain of the value axis in recharts' terms, such as `[0, 100]`. From zero unless stated."}, {"accepts": "NumberFormatOptions", "fallback": "", "kind": "option", "name": "valueOptions", "refers": [], "required": false, "says": "`Intl.NumberFormat` options the value ticks and the tooltip's values are written with."}]};
+export const shapes = {"kit.Annotation": [{"accepts": "string | number", "name": "at", "says": "Category the mark is at, or the category its period starts at."}, {"accepts": "ChartColor", "name": "color", "says": "Palette of the mark, such as `warning` for a flagged point. The neutral palette unless stated."}, {"accepts": "string", "name": "key", "says": "Identity of the mark, unique among the chart's annotations."}, {"accepts": "string", "name": "label", "says": "Words for the mark, written on the plot and in the tooltip at its category."}, {"accepts": "string | number", "name": "until", "says": "Category the mark's period ends at, which makes the mark a period."}, {"accepts": "number", "name": "value", "says": "Value of the point the mark rings, which makes the mark a point."}], "kit.ChartColor": [{"accepts": "", "name": "\"accent\"", "says": ""}, {"accepts": "", "name": "\"blue\"", "says": ""}, {"accepts": "", "name": "\"cyan\"", "says": ""}, {"accepts": "", "name": "\"error\"", "says": ""}, {"accepts": "", "name": "\"gray\"", "says": ""}, {"accepts": "", "name": "\"green\"", "says": ""}, {"accepts": "", "name": "\"indigo\"", "says": ""}, {"accepts": "", "name": "\"info\"", "says": ""}, {"accepts": "", "name": "\"neutral\"", "says": ""}, {"accepts": "", "name": "\"orange\"", "says": ""}, {"accepts": "", "name": "\"pink\"", "says": ""}, {"accepts": "", "name": "\"primary\"", "says": ""}, {"accepts": "", "name": "\"purple\"", "says": ""}, {"accepts": "", "name": "\"red\"", "says": ""}, {"accepts": "", "name": "\"secondary\"", "says": ""}, {"accepts": "", "name": "\"series.1\"", "says": ""}, {"accepts": "", "name": "\"series.2\"", "says": ""}, {"accepts": "", "name": "\"series.3\"", "says": ""}, {"accepts": "", "name": "\"series.4\"", "says": ""}, {"accepts": "", "name": "\"series.5\"", "says": ""}, {"accepts": "", "name": "\"series.6\"", "says": ""}, {"accepts": "", "name": "\"series.7\"", "says": ""}, {"accepts": "", "name": "\"series.8\"", "says": ""}, {"accepts": "", "name": "\"success\"", "says": ""}, {"accepts": "", "name": "\"teal\"", "says": ""}, {"accepts": "", "name": "\"warning\"", "says": ""}, {"accepts": "", "name": "\"yellow\"", "says": ""}], "react.ReactElement": [{"accepts": "string | JSXElementConstructor<any>", "name": "type", "says": ""}, {"accepts": "unknown", "name": "props", "says": ""}, {"accepts": "string | null", "name": "key", "says": ""}], "react.ReactPortal": [{"accepts": "ReactNode", "name": "children", "says": ""}, {"accepts": "string | JSXElementConstructor<any>", "name": "type", "says": ""}, {"accepts": "unknown", "name": "props", "says": ""}, {"accepts": "string | null", "name": "key", "says": ""}], "kit.CartesianSeries": [{"accepts": "ChartColor", "name": "color", "says": "Palette the series takes its color from. The theme's series color at its position unless stated."}, {"accepts": "boolean", "name": "dashed", "says": "Whether the series' line renders dashed, as a target or a projection does. A series with `previousOf` renders dashed unless stated."}, {"accepts": "string", "name": "previousOf", "says": "Key of the series this series is the earlier period of, such as last week's revenue for this week's. The series takes the neutral palette unless it states a color, and the tooltip writes the change from it after the other series' value."}, {"accepts": "number", "name": "ink", "says": "Share of the ink, `fg`, in percent, the series' color mixes in: 0 keeps the color, 100 is the ink. The mix keeps 3:1 or more against the page. None unless stated."}, {"accepts": "string", "name": "key", "says": "Field of each row the series reads, which a recharts mark takes as its `dataKey`."}, {"accepts": "ReactNode", "name": "label", "says": "Name the tooltip and the legend show. The key unless stated."}], "recharts.AxisDomain": [{"accepts": "", "name": "readonly string[]", "says": ""}, {"accepts": "", "name": "readonly number[]", "says": ""}, {"accepts": "", "name": "([dataMin, dataMax]: NumberDomain, allowDataOverflow: boolean) => NumberDomain", "says": ""}, {"accepts": "", "name": "readonly [AxisDomainItem, AxisDomainItem]", "says": ""}], "recharts.AxisDomainItem": [{"accepts": "", "name": "string", "says": ""}, {"accepts": "", "name": "number", "says": ""}, {"accepts": "", "name": "(d: number) => string | number", "says": ""}]};