SeriesChart: chart-series contract and single-variable chart plugin

[BhattaraiSijan]

Summary

Adds the shared chart-series contract (src/essence/Tools/_shared/types/chartSeries.ts) and SeriesChart, a generic chart panel rendering it. SeriesChart knows nothing about data sources: any plugin listed in its sources tool variable that emits plugin:<id>:seriesLoading/seriesReady/seriesError/seriesCleared gets a chart card per chartId — loading, error, and ready states included. Payloads are treated as untrusted: malformed ones warn and drop rather than crash the panel.

Rendering (ECharts, already a dependency): one variable visible at a time (air-quality-domain convention, e.g. OpenAQ), with the single-select legend as the parameter picker — the y-axis renames to the picked variable's unit. Wheel + slider zoom (slim theme-primary scrubber), reset button in the card header, crosshair tooltips. All time labels are UTC by design: epoch-value axis with our own formatters, since ECharts' native time axis renders viewer-local. All colors route through --theme-* tokens (canvas via a resolved theme object; spec-asserted so literals can't regress in).

The default sources: ["fetch-timeseries"] forward-references the fetcher plugin from the stacked PR — inert until it merges.

Size note: ~360 lines are unit tests and ~230 are styles/config/docs; reviewable logic is ~600 (chartData.ts, panel, adapter).

Merge order

1. Emit feature:click on the bus for every vector feature click #292 feature:click core event (independent of this one)
2. this PR → development
3. FetchTimeseries: feature clicks to chart-series events #294 FetchTimeseries (stacked on this PR)

Testing

Contract guards and option-builder covered by tests/unit/chartSeries.spec.js + tests/unit/seriesChartData.spec.js (UTC handling, single-select legend, unit-named axis, themed scrubber, tooltip formatting). Full unit suite green. Manual recipe lives in the stacked FetchTimeseries PR, which provides the first emitter.

[BhattaraiSijan]

Addressed the review findings on this PR:

• Charts crashed past ~130k points — the arg-spread Math.min(...xs) extents are now loops (spec'd at 200k points), and every card is wrapped in an error boundary so a bad render costs that one card, not the whole panel; any fresh event for the chartId retries it.
• seriesReady was the only enveloped message and the envelope was documented nowhere — flattened to match its three siblings. SeriesReadyPayload is exported so the contract file enumerates all four shapes, and the legacy enveloped form is dropped with a console warning (spec-pinned). FetchTimeseries' emit side updates in FetchTimeseries: feature clicks to chart-series events #294.
• Duplicate series labels collapsed the single-select picker and mislabeled the footer/CSV — the payload guard now rejects duplicate ids or labels as malformed, and the README documents the uniqueness requirement.
• Time tick granularity was computed from the union of all series while only one is ever visible — it now follows the picked variable's extent, so a two-day series next to a five-year one keeps hourly labels.
• The docs promised behaviors the code doesn't have — dual-y-axis claims removed from the contract and README, subtitle/yLabel/meta marked reserved, and the config layout descriptions corrected (both layouts have the zoom strip + CSV; single has the reset button).
• The tool shipped switched off — SeriesChart is now on and assigned to the float-analysis panel in the full-demo mission (FetchTimeseries' half lands in FetchTimeseries: feature clicks to chart-series events #294).
• Minors: space-separated timezone-less datetimes parse as UTC, CSV quotes lone carriage returns, an explicitly-empty sources config now means "listen to nothing", one token list feeds both the canvas palette and the CSS vars, dead code removed.
• +17 specs, including the previously untested chart adapter (mock bus) and the error boundary.