Semiotic Files

Added

• BumpChart (semiotic/xy). A ranking chart: each x-column ranks its series by yAccessor, and rank becomes vertical position. Set ribbon to encode the original magnitude as a true perpendicular-offset ribbon width (following the d3.svg.ribbon approach) instead of a fixed-width line — both modes share the same sampled centerline, so animate tweens only the width during a line↔ribbon toggle. highlightTop colors just the N best series by mean rank and greys the rest via neutralColor. Exports BumpChart and the pure rankBumpData helper plus its types. Ships with SSR, AI schema/metadata and MCP-registry registration, and a docs page.
• AreaChart semanticLine. A new prop (default true) paints hard, value-banded color segments along an area's top stroke wherever the value crosses a semanticGradient threshold — the stroke counterpart to the semantic fill. A shared segment-splitter guarantees canvas and SVG render identical bands.
• legendLayout.sideGutter. Reserves space between a side (left/right) legend and the plot-adjacent axis chrome (ticks, titles), applied consistently across the client and SSR renderers. MultiAxisLineChart auto-sets a 70px dual-axis default; override via frameProps.legendLayout.
• legendDistance. Controls the gap between the plot and its legend, with dynamic content-measured side-legend width and margin estimation.
• Unified gradient config + exported types. gradientFill, lineGradient, and semanticGradient now all accept a single { stops: [{ offset, color?, opacity? }] } shape (legacy shorthands still work); GradientConfig, GradientStop, and SemanticGradientInput are exported from semiotic and semiotic/xy.
• Data Viz for Dummies II–VI. Five new scrollytelling example pages expanding coverage across advanced XY, ordinal, network, geo, and physics patterns.

Changed

• Default legend distance reduced from 12px to 10px across the client and SSR paths, tightening automatic side/top margin reservations and the legend-tight diagnostic threshold.
• Legend placement no longer clamps to a minimum on-canvas offset. Numeric margins are now authoritative for legend position (matching SSR), so a numeric margin smaller than the legend needs can push it partly off-canvas. Rely on auto-margins (omit margin) or size the margin to the legend.
• DistanceCartogram fractional lineMode now repositions flow-line endpoints and interpolates intermediate vertices by arc length; previously fractional lines were left un-repositioned.
• Legend creation/interaction logic split into a dedicated hook module, re-exported from the shared hooks entry (no import changes).
• Removed the internal semanticGradientToColorStops export (the SemanticGradientStop type alias is retained).

Fixed

• renderChart / SSR: frameProps overrides now take precedence over mode defaults, so e.g. frameProps={{ showAxes: false }} is honored in server rendering.
• Geo DistanceCartogram: corrected radial interpolation so geography is no longer pushed out of the plot at partial strength, and clamped strength to [0, 1] with a NaN guard.
• Physics kernel: a body resting only against a side wall (or a sideways sleeping neighbor) no longer falsely counts as supported/sleeping, so it keeps settling.
• SSR/static legend parity: aligned static and client legend positioning, including gradient legend label alignment; resize remaps now rescale semantic area stroke color bands.