Semiotic Files

Added

• RealtimeHistogram and TemporalHistogram stacked segments carry categories: every non-zero { category, value } in the bin, bottom to top, shared by the bin's segments. The default histogram tooltip adds a category count row.
• getSourceRows(datumOrHover) in semiotic/realtime and semiotic/utils returns the authored rows behind a histogram bin, stacked segment, or categories entry. The HistogramBinDatum type describes the bin datum.
• createDagreFit(nodes, edges, plot, config?) and createFlextreeFit(nodes, plot, config?) in semiotic/recipes return the exact fit dagreLayout / flextreeLayout apply (scale, dx, dy, bounds, project, invert, nodeBounds), so minimaps and overlays can align with the fitted graph without copying recipe defaults. semiotic/network/zoom exports projectNetworkPoint and invertNetworkRect for applying the zoom camera.
• adaptiveTimeTicks accepts opt-in includeYear and includeDate ("always" default, "auto", "never"), referenceTime, and deltaStyle: "clock" to shorten axis labels. Defaults and value-only (tooltip) labels are unchanged.
• Top-level showAxes on LineChart, AreaChart, StackedAreaChart, DifferenceChart, Scatterplot, BubbleChart, Heatmap, QuadrantChart, MultiAxisLineChart, WaterfallChart, CandlestickChart, ConnectedScatterplot, and MinimapChart (its detail chart). It follows the chart mode by default; an explicit value wins, matching responsiveRules win over it, and frameProps.showAxes still wins over both. Margins are kept. Chart schemas and validateProps accept it.
• GaugeChart centerLabel: a serializable caption drawn beneath the center value as native SVG text.
• RealtimeHistogram and TemporalHistogram support tooltip="multi" and { mode: "multi", content? }: hovering anywhere in a column (above a short stack or between bars included) lists every stacked category in that bin, with its range and total. Keyboard focus gets the same rows.
• LinearBrush in semiotic/controls: an accessible one-dimensional range brush for any track. It is controlled (value) or uncontrolled (defaultValue); onChange fires on every change and onChangeEnd once per release or keyboard step, with atDomainStart/atDomainEnd flags. Map it with domain or the chart's own scale, overlay a chart's plot with inset, and customize it with maskStyle, selection and handle styles, renderHandle, a move handle, double-click reset, minSpan, snap, and extent and domain labels (two lines with a \n). It is a group of three sliders with arrow, Shift, Page Up/Down, Home/End, and Escape keys, emits control observations, and follows the ThemeProvider colors without a store.
• MinimapChart overview brush options: minimap.brushStyle (fill, fillOpacity, stroke, strokeWidth, activeStroke, mask), minimap.handles (with an optional move handle), minimap.renderHandle, minimap.showExtentLabels with minimap.extentLabelFormat (defaults to xFormat), minimap.resetOnDoubleClick, minimap.minSpan, and minimap.brushLabel. onBrushEnd(extent, meta) fires once per changed release, keyboard step, or reset. MinimapChart accepts onObservation (brush/brush-end, plus control-start/control-end for gestures) and chartId. renderChart draws the mask, handles, and labels.

Changed

• Multi-series hover (tooltip="multi" and { mode: "multi" }) snaps to the first or last sample in x-extent padding instead of showing nothing, on every chart that uses it (LineChart, AreaChart, StackedAreaChart, DifferenceChart, MultiAxisLineChart, MinimapChart, BumpChart, XYCustomChart, and RealtimeLineChart). The crosshair and series dots sit on the edge sample, and xValue/xPx report it; the tooltip still follows the cursor.

• Brush selections take the theme's colors.selection, falling back to colors.primary, instead of a fixed steelblue: XY and ordinal frame brushes, ScatterplotMatrix, MinimapChart, and renderChart MinimapChart output. In the browser they follow the --semiotic-selection-color and --semiotic-primary variables that ThemeProvider sets, so theme changes restyle them in place. Without a theme they use the light theme's #00a2ce.

• MinimapChart's overview brush is a LinearBrush, so the minimap no longer loads d3-brush. It is keyboard-accessible (start, range, and end sliders) and themed. Unlike the d3 brush, the ends cannot cross (they stop 1px, or minSpan, apart), there are no Alt/Space/Meta modifier gestures, a touch drag across the brush axis pans the page, edges have 24px targets, a new selection starts after 3px of movement, and onBrush no longer repeats the final extent on release. The d3 .brush-group / .overlay / .selection SVG is replaced by HTML parts marked data-semiotic-brush-part; update CSS or tests that target the d3 classes. Static output insets the selection by half its stroke to match the browser's border.

• MinimapChart re-reads the overview's scales after size, margin, and y-extent changes, not only data changes, so the brush maps through the current layout after a resize.

Fixed

• Horizontal XY axes call index-aware formatters such as adaptiveTimeTicks with the ticks actually rendered, after overlapping labels are thinned, and judge duplicate labels on those rendered labels. Date changes are no longer hidden by thinning, rendered ticks are no longer dropped as look-alike duplicates, and includeMax labels compare with the tick before them. A formatter that reads index now sees rendered indices. Static rendering matches.
• adaptiveTimeTicks hour-granularity labels show the tick's minutes ("14:30") instead of always ":00".
• BumpChart passes the rendered ticks to xFormat as authored dates, so adaptiveTimeTicks shortens its labels there too.
• BumpChart resolves showAxes through mode and responsiveRules in the browser, matching renderChart, so compact modes hide its axes.
• GaugeChart string and number centerContent render as native SVG text in the browser and in static SVG, instead of an HTML overlay and foreignObject. Fragments of SVG elements also stay native.
• renderChart GaugeChart takes its compact readout and scale-label defaults from the resolved mode, including responsiveRules, as the browser does.
• Static and pre-hydration SVG areas multiply fillOpacity (default 0.7) by opacity, as the canvas does. This fixes BumpChart highlightTop neutral trajectories and ribbon/line opacity (drawn fully opaque in SSR), bounds bands, and the AreaChart/StackedAreaChart opacity prop. SSR areas that set only opacity now render lighter, matching the canvas.
• BumpChart honors a named colorScheme together with highlightTop, instead of deferring to the theme palette.
• renderChart BumpChart normalizes highlightTop, neutralColor, and color the same way as the browser (numeric strings count) and draws the default rank grid.
• Static SVG violins fall back to opacity for their fill opacity, as the canvas does.
• BumpChart reserves endpoint-label room from the label text on each labeled side (capped at 38% of the width; today's margins are the floor), so long names no longer run off the chart. Start labels clear the rank ticks, and over-long labels truncate with "…" and keep the full name in <title>. Partial margins merge over these defaults in the browser and in renderChart alike, frameProps.margin counts as explicit, and a side legend shares its side with the labels instead of overlapping them.
• renderChart LineChart directLabel no longer grows margin sides the caller pinned, matching the browser.
• Custom multi-series tooltip content near the last sample receives every series instead of one datum.
• Keyboard focus in multi-series mode carries allSeries and xValue like pointer hover.
• LineChart gapStrategy="break" no longer writes _gapSegment onto datums passed to tooltips, onClick, and observations. Series from a function lineBy stay separate across gaps, fillArea series lists keep their fill, style rules see the authored series, and multi-series rows show the series name instead of an internal segment key.
• Multi-series rows for an ungrouped series have an empty group instead of _default, so RealtimeLineChart labels its row with the value accessor.
• Declarative and multi-series tooltip content, click observations, and tap-to-lock linked hover keep a histogram bin's source rows instead of losing them to a copied datum.
• Realtime and physics chart specs no longer claim multi-series tooltip support for charts that fall back to one datum (RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, and physics charts). In development, { mode: "multi", content } on such a chart warns once.
• RealtimeHistogram and TemporalHistogram bins match a linked point selection on any time inside [binStart, binEnd), not only a time a source row carries exactly, so a time picked on a linked line chart highlights its bin.
• Mobile tapToSelect on an aggregate mark publishes its source rows' field values, as linked hover does.
• MinimapChart keeps a brush drag going when the chart re-renders during it, as with a controlled brushExtent or an inline onBrush that sets parent state. Every move after the first, and the release, used to be lost. ScatterplotMatrix cell brushes read their callback the same way.
• MinimapChart minimap.brushDirection: "y" sets the detail chart's y domain instead of its x domain, reports ascending extents, and draws a controlled y extent in the overview (it was drawn with negative height, so invisible). renderChart applies the brushed range to the same axis.