semiotic 3.8.5 → 3.8.7

package/dist/components/semiotic-xy.d.ts

@@ -5,6 +5,7 @@
 import StreamXYFrame from "./stream/StreamXYFrame";
 export { StreamXYFrame };
 export { LineChart } from "./charts/xy/LineChart";
+export { BumpChart, rankBumpData } from "./charts/xy/BumpChart";
 export { AreaChart } from "./charts/xy/AreaChart";
 export { DifferenceChart } from "./charts/xy/DifferenceChart";
 export { StackedAreaChart } from "./charts/xy/StackedAreaChart";
@@ -28,10 +29,13 @@ export type { HitTargetPointProps, HitTargetRectProps } from "./stream/hitTarget
 export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
 export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
 export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
 export type { CustomLayout, LayoutContext, LayoutResult } from "./stream/customLayout";
 export type { LineChartProps } from "./charts/xy/LineChart";
+export type { BumpChartProps, RankedBumpData, RankedBumpDatum, RankBumpDataOptions, } from "./charts/xy/BumpChart";
 export type { AreaChartProps, SemanticGradientStop } from "./charts/xy/AreaChart";
+export type { GradientConfig, GradientStop, SemanticGradientInput, } from "./charts/shared/gradient";
 export type { DifferenceChartProps } from "./charts/xy/DifferenceChart";
 export type { StackedAreaChartProps } from "./charts/xy/StackedAreaChart";
 export type { ScatterplotProps } from "./charts/xy/Scatterplot";

package/dist/components/semiotic.d.ts

@@ -1,7 +1,7 @@
 import StreamXYFrame from "./stream/StreamXYFrame";
 import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
 import StreamNetworkFrame from "./stream/StreamNetworkFrame";
-import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, responsiveRuleMatches, resolveResponsiveRules } from "./charts";
+import { Scatterplot, ConnectedScatterplot, LineChart, BumpChart, rankBumpData, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, responsiveRuleMatches, resolveResponsiveRules } from "./charts";
 import { LinkedCharts } from "./LinkedCharts";
 import { ThemeProvider, useTheme } from "./ThemeProvider";
 import { exportChart } from "./export/exportChart";
@@ -28,14 +28,14 @@ import { RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram } from
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, MobileChartContainer, SmallMultipleChart, MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, CircularBrush, DirectManipulationControl, VISUALIZATION_CONTROL_TYPES, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern, responsiveRuleMatches, resolveResponsiveRules };
-export type { LegendLayout } from "./types/legendTypes";
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, BumpChart, rankBumpData, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, MobileChartContainer, SmallMultipleChart, MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, CircularBrush, DirectManipulationControl, VISUALIZATION_CONTROL_TYPES, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern, responsiveRuleMatches, resolveResponsiveRules };
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { DirectManipulationControlProps, VisualizationControlType } from "./DirectManipulationControl";
 export { createControlObservationAdapter, } from "./controls/controlContract";
 export { auditVisualizationControls } from "./controls/controlAudit";
 export type { ControlInputSource, ControlObservation, ControlObservationAdapterOptions, ControlObservationCallback, ControlObservationPhase, VisualizationControlDefinition, VisualizationControlValue, } from "./controls/controlContract";
 export type { AuditVisualizationControlsOptions, ControlAuditFinding, ControlAuditResult, ControlAuditStatus, } from "./controls/controlAudit";
-export type { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, SemanticGradientStop, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode, MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig, ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts";
+export type { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, BumpChartProps, RankedBumpData, RankedBumpDatum, RankBumpDataOptions, AreaChartProps, SemanticGradientStop, GradientConfig, GradientStop, SemanticGradientInput, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode, MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig, ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts";
 export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, SceneAccessibilityMetadata, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn, XYFrameAxisConfig, BandConfig } from "./stream/types";
 export type { StreamRendererFn } from "./stream/renderers/types";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";

package/dist/components/server/renderEvidence.d.ts

@@ -18,7 +18,7 @@
 export interface RenderEvidence {
     /** HOC component name as passed to renderChart. */
     component: string;
-    frameType: "xy" | "ordinal" | "network" | "geo" | "physics";
+    frameType: "xy" | "ordinal" | "network" | "geo" | "physics" | "value";
     /** "ok" when the scene produced data marks; "empty" when it did not. */
     status: "ok" | "empty";
     /** True when zero data marks rendered. */

package/dist/components/server/renderToStaticSVG.d.ts

@@ -7,6 +7,7 @@ import { CHART_CONFIGS } from "./serverChartConfigs";
 import { type ThemeInput } from "./themeResolver";
 import { type RenderEvidence } from "./renderEvidence";
 import { type ThemeAwareProps, type StaticFrameProps, type FrameType } from "./staticSVGChrome";
+import { type ValueChartName } from "./staticValue";
 export declare function renderToStaticSVG(frameType: FrameType, props: StaticFrameProps): string;
 export declare function renderXYToStaticSVG(props: StreamXYFrameProps & ThemeAwareProps): string;
 export declare function renderOrdinalToStaticSVG(props: StreamOrdinalFrameProps & ThemeAwareProps): string;
@@ -18,7 +19,7 @@ export declare function renderGeoToStaticSVG(props: StreamGeoFrameProps & ThemeA
  * union — no second edit required, no silent drift like the CandlestickChart
  * gap that motivated this refactor.
  */
-type ChartName = keyof typeof CHART_CONFIGS;
+type ChartName = keyof typeof CHART_CONFIGS | ValueChartName;
 interface RenderChartOptions {
     /** Output format — currently only "svg" is synchronous */
     format?: "svg";

package/dist/components/server/serverChartConfigHeatmap.d.ts

@@ -0,0 +1,6 @@
+import type { ChartConfig } from "./serverChartConfigShared";
+/**
+ * Heatmap keeps cell border props separate from the generic primitive
+ * vocabulary. Convert them to the areaStyle consumed by both SVG paths.
+ */
+export declare const heatmap: ChartConfig;

package/dist/components/server/serverChartConfigNetworkStyles.d.ts

@@ -0,0 +1,12 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import { type PrimitiveStyleOverrides } from "../charts/shared/mergeShapeStyle";
+/**
+ * Compose user/frame node styling over a hierarchy HOC's built-in encoding,
+ * then apply chart-level primitives with their documented final precedence.
+ */
+export declare function composeHierarchyNodeStyle(baseNodeStyle: (d: Datum) => Record<string, unknown>, userNodeStyle: ((d: Datum) => Record<string, unknown> | undefined | null) | Record<string, unknown> | undefined | null, primitives?: PrimitiveStyleOverrides): (d: Datum) => Record<string, unknown>;
+/**
+ * Mirror ForceDirectedGraph's edge primitive resolution on the static path.
+ * An explicit edgeStyle remains the final escape hatch.
+ */
+export declare function resolveForceEdgeStyle(rest: Datum): any;

package/dist/components/server/serverChartConfigShared.d.ts

@@ -3,6 +3,7 @@ import type { ChartMode } from "../charts/shared/types";
 import type { ChartModeInput, ChartModeResult } from "../charts/shared/chartMode";
 import type { SemioticTheme } from "../store/ThemeStore";
 import type { ReactNode } from "react";
+import type { PrimitiveStyleOverrides } from "../charts/shared/mergeShapeStyle";
 export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
 export type ServerAccessorValue = string | number | boolean | Date | null | undefined;
 export type ServerAccessor = string | ((datum: Datum) => ServerAccessorValue);
@@ -41,6 +42,21 @@ export interface ChartConfig {
 export declare function accessorValue(accessor: ServerAccessor | undefined, fallback: string, d: Datum): ServerAccessorValue;
 export declare function numericValue(value: ServerAccessorValue): number;
 export declare function viridisColor(i: number, n: number): string;
+/**
+ * Pull the top-level primitive styling props out of a chart's raw props so a
+ * server config can overlay them with `mergeShapeStyle`, exactly as the HOC
+ * does before handing style functions to its frame.
+ *
+ * Every shape-drawing HOC applies `stroke`/`strokeWidth`/`opacity` last, so
+ * they win over `frameProps.*Style` returns and the HOC's own base style. A
+ * server config that builds its style function without this overlay silently
+ * drops the whole channel — the static SVG comes back byte-identical to an
+ * unstyled render while the canvas honors it.
+ *
+ * Keys are omitted when unset so `mergeShapeStyle` can return its input
+ * unchanged and callers keep the no-override fast path.
+ */
+export declare function primitiveStyleOverrides(rest: Datum): PrimitiveStyleOverrides;
 export declare function prepareConnectedScatterplotData(data: ServerChartData, rest: Datum): {
     data: ServerChartData;
     orderMap: WeakMap<Datum, {

package/dist/components/server/serverChartConfigs.d.ts

@@ -6,6 +6,7 @@
 import type { ChartConfig } from "./serverChartConfigShared";
 export declare const CHART_CONFIGS: {
     Sparkline: ChartConfig;
+    BumpChart: ChartConfig;
     LineChart: ChartConfig;
     AreaChart: ChartConfig;
     DifferenceChart: ChartConfig;
@@ -48,11 +49,11 @@ export declare const CHART_CONFIGS: {
     GeoCustomChart: ChartConfig;
     GaltonBoardChart: ChartConfig;
     EventDropChart: ChartConfig;
-    PhysicsPileChart: ChartConfig;
+    UnitPileChart: ChartConfig;
     CollisionSwarmChart: ChartConfig;
     ProcessFlowChart: ChartConfig;
     GauntletChart: ChartConfig;
     CrucibleChart: ChartConfig;
-    PhysicalFlowChart: ChartConfig;
+    PacketFlowChart: ChartConfig;
     PhysicsCustomChart: ChartConfig;
 };

package/dist/components/server/serverChartConfigsPhysics.d.ts

@@ -1,7 +1,7 @@
 import { type ChartConfig } from "./serverChartConfigShared";
 export declare const galtonBoardChart: ChartConfig;
 export declare const eventDropChart: ChartConfig;
-export declare const physicsPileChart: ChartConfig;
+export declare const unitPileChart: ChartConfig;
 export declare const collisionSwarmChart: ChartConfig;
 export declare const processFlowChart: ChartConfig;
 export declare const gauntletChart: ChartConfig;
@@ -14,5 +14,5 @@ export declare const gauntletChart: ChartConfig;
  * therefore cannot alter this static semantic state.
  */
 export declare const crucibleChart: ChartConfig;
-export declare const physicalFlowChart: ChartConfig;
+export declare const packetFlowChart: ChartConfig;
 export declare const physicsCustomChart: ChartConfig;

package/dist/components/server/serverChartConfigsXY.d.ts

@@ -1,6 +1,7 @@
 import { type ChartConfig } from "./serverChartConfigShared";
 export declare const bubbleChart: ChartConfig;
 export declare const sparkline: ChartConfig;
+export declare const bumpChart: ChartConfig;
 export declare const lineChart: ChartConfig;
 /** Static-data TemporalHistogram mapped onto the shared time-binned XY pipeline. */
 export declare const temporalHistogram: ChartConfig;
@@ -11,4 +12,3 @@ export declare const candlestickChart: ChartConfig;
 export declare const scatterplot: ChartConfig;
 export declare const quadrantChart: ChartConfig;
 export declare const connectedScatterplot: ChartConfig;
-export declare const heatmap: ChartConfig;

package/dist/components/server/staticLegend.d.ts

@@ -8,6 +8,7 @@ import * as React from "react";
 import type { SemioticTheme } from "../store/ThemeStore";
 import type { Datum } from "../charts/shared/datumTypes";
 import type { CategoricalLegendConfig, GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+import { type AxisChromeInput } from "../legendLayout";
 interface LegendItemLayout {
     category: string;
     width: number;
@@ -45,14 +46,21 @@ export interface StaticLegendConfig {
     hasTitle?: boolean;
     /** SSR legend layout controls */
     legendLayout?: LegendLayout;
-    /** Client <Legend> uses a stable 100px vertical placement box. */
+    /** Gap in pixels between the legend and the plot/side gutter. Default: 10. */
+    legendDistance?: number;
+    /** Optional vertical placement-box override. Defaults to measured content. */
     reservedWidth?: number;
     /** Optional id namespace used for generated SVG ids */
     idPrefix?: string;
+    /**
+     * Axis chrome on the legend's side, so a top/bottom legend clears the tick
+     * labels instead of drawing on them. Mirrors `renderLegendFromConfig`.
+     */
+    axisChrome?: AxisChromeInput;
 }
 export interface StaticLegendGroupsConfig extends Omit<StaticLegendConfig, "categories" | "colorScheme"> {
     legendGroups: LegendGroup[];
-    /** Client <Legend> uses a stable 100px vertical placement box. */
+    /** Optional vertical placement-box override. Defaults to measured content. */
     reservedWidth?: number;
 }
 export interface StaticGradientLegendConfig extends Omit<StaticLegendConfig, "categories" | "colorScheme"> {

package/dist/components/server/staticSVGChrome.d.ts

@@ -7,12 +7,12 @@ import type { StreamGeoFrameProps } from "../stream/geoTypes";
 import type { PhysicsSettledSVGOptions } from "../stream/physics/PhysicsSettledSVG";
 import type { PhysicsPipelineStore, PhysicsQueuedSpawn } from "../stream/physics/PhysicsPipelineStore";
 import type { OrdinalPipelineStore } from "../stream/OrdinalPipelineStore";
-import type { RenderEvidence } from "./renderEvidence";
 import { resolveTheme, type ThemeInput } from "./themeResolver";
 import type { SemioticTheme } from "../store/ThemeStore";
 import * as React from "react";
 import { type AxisExtentMode } from "../charts/shared/axisExtent";
-export type FrameType = RenderEvidence["frameType"];
+import { type AxisChromeInput } from "../legendLayout";
+export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
 export type StaticPhysicsFrameProps = PhysicsSettledSVGOptions & {
     config?: ConstructorParameters<typeof PhysicsPipelineStore>[0];
     initialSpawns?: PhysicsQueuedSpawn[];
@@ -55,12 +55,17 @@ type LegendPosition = "right" | "left" | "top" | "bottom";
 type StaticLegendHostProps = ThemeAwareProps & {
     legend?: unknown;
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Bottom-axis chrome, so a bottom legend is placed and reserved outside the
+     * tick labels. Frames without a horizontal axis omit it and keep a 0 gutter.
+     */
+    axisChrome?: AxisChromeInput;
 };
 /**
- * The client HOCs reserve a stable legend gutter before layout. The static
- * frame API still uses content measurement by default, but renderChart()
- * marks HOC requests so both paths share that contract. An explicitly set
- * side remains fully caller-controlled.
+ * The client HOCs reserve a minimum legend gutter before layout. The static
+ * frame API uses the same content measurement, while renderChart() marks HOC
+ * requests so both paths retain their compatibility floor. An explicitly set
+ * numeric side remains fully caller-controlled.
  */
 export declare function hocLegendMarginMinimum(props: ThemeAwareProps, position: LegendPosition): number | undefined;
 /** Whether the caller, rather than the HOC default, owns a legend side. */
@@ -80,6 +85,7 @@ export declare function reserveStaticLegendMargin(margin: {
     legendLayout?: LegendLayout;
     minimumMargin?: number;
     preserveExplicitMargin?: boolean;
+    axisChrome?: AxisChromeInput;
 }): void;
 export declare function reserveLegendConfigMargin(margin: {
     top: number;
@@ -95,6 +101,7 @@ export declare function reserveLegendConfigMargin(margin: {
     legendLayout?: LegendLayout;
     minimumMargin?: number;
     preserveExplicitMargin?: boolean;
+    axisChrome?: AxisChromeInput;
 }): void;
 export declare function renderLegendConfig(legend: unknown, options: {
     theme: ReturnType<typeof resolveTheme>;
@@ -110,6 +117,7 @@ export declare function renderLegendConfig(legend: unknown, options: {
     legendLayout?: LegendLayout;
     idPrefix?: string;
     reservedWidth?: number;
+    axisChrome?: AxisChromeInput;
 }): React.ReactNode;
 /** Reserve the plot gutter for either a supplied legend config or categories. */
 export declare function reserveFrameLegendMargin(margin: {

package/dist/components/server/staticValue.d.ts

@@ -0,0 +1,8 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import { type EvidenceSink } from "./renderEvidence";
+export declare function renderBigNumberToStaticSVG(props: Datum, sink?: EvidenceSink): string;
+export declare const VALUE_RENDERERS: {
+    readonly BigNumber: typeof renderBigNumberToStaticSVG;
+};
+export type ValueChartName = keyof typeof VALUE_RENDERERS;
+export declare function renderValueChart(component: ValueChartName, props: Datum, sink?: EvidenceSink): string;

package/dist/components/stream/GeoSVGOverlay.d.ts

@@ -4,7 +4,7 @@ import { type OnAnnotationActivateCallback } from "../charts/shared/annotationAc
 import * as React from "react";
 import type { ReactNode } from "react";
 import type { AnnotationContext } from "../realtime/types";
-import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
 interface GeoSVGOverlayProps {
     width: number;
@@ -24,11 +24,7 @@ interface GeoSVGOverlayProps {
      */
     showAxes?: boolean;
     title?: string | ReactNode;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;
@@ -64,10 +60,8 @@ interface GeoSVGOverlayProps {
 /**
  * The SVG chrome used by StreamGeoFrame.
  *
- * Geo previously imported the Cartesian SVGOverlay even though it never
- * supplies scales, marginal graphics, grids, or linked-crosshair state. Keep
- * the subset Geo actually exercises here so those XY-only dependencies do not
- * enter the Geo bundle.
+ * Contains the subset Geo exercises so XY-only scale, marginal-graphics, grid,
+ * and linked-crosshair dependencies do not enter the Geo bundle.
  */
 export declare function GeoSVGOverlay(props: GeoSVGOverlayProps): React.JSX.Element | null;
 export {};

package/dist/components/stream/NetworkSVGOverlay.d.ts

@@ -2,7 +2,7 @@ import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { ReactNode } from "react";
 import type { NetworkLabel } from "./networkTypes";
-import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
 import type { AnnotationContext } from "../realtime/types";
 import { type GlyphDef } from "./glyphDef";
@@ -56,11 +56,7 @@ export interface NetworkSVGOverlayProps {
     /** Chart title */
     title?: string | ReactNode;
     /** Legend configuration */
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;

package/dist/components/stream/OrdinalSVGOverlay.d.ts

@@ -3,7 +3,7 @@ import * as React from "react";
 import type { OrdinalScales } from "./ordinalTypes";
 import type { AnnotationContext } from "../realtime/types";
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import type { OnObservationCallback } from "../store/ObservationStore";
 import { type OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
 import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
@@ -38,11 +38,7 @@ interface OrdinalSVGOverlayProps {
     axisExtent?: AxisExtentMode;
     showGrid?: boolean;
     title?: string | ReactNode;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;

package/dist/components/stream/SVGOverlay.d.ts

@@ -3,7 +3,7 @@ import * as React from "react";
 import type { StreamScales, MarginalGraphicsConfig, XYFrameAxisConfig } from "./types";
 import type { AnnotationContext } from "../realtime/types";
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import { type AutoPlaceAnnotations } from "../recipes/annotationLayout";
 import type { OnObservationCallback } from "../store/ObservationStore";
 import { type OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
@@ -36,11 +36,7 @@ interface SVGOverlayProps {
     axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
     showGrid?: boolean;
     title?: string | ReactNode;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     /** Callback when hovering a legend item */
     legendHoverBehavior?: (item: {
         label: string;

package/dist/components/stream/StalenessBadge.d.ts

@@ -8,12 +8,8 @@ interface StalenessBadgeProps {
  * `staleness.showBadge` is set.
  *
  * Shared by all four Stream Frames (XY / ordinal / network / geo) so the badge
- * is pixel-identical across families. Previously each frame inlined its own
- * copy and they had drifted — the network frame used a smaller, heavier variant
- * (10px/700, tighter padding, letterSpacing). This is the canonical style: the
- * more legible 11px/600 the other three shared, plus `zIndex`/`pointerEvents`
- * hardening so the badge always sits above the canvas and never intercepts
- * pointer events.
+ * is pixel-identical across families. The badge sits above the canvas and does
+ * not intercept pointer events.
  */
 export declare function StalenessBadge({ isStale, position }: StalenessBadgeProps): import("react").JSX.Element;
 export {};

package/dist/components/stream/geoPipelineConfig.d.ts

@@ -0,0 +1,10 @@
+import type { GeoPipelineConfig } from "./geoTypes";
+/**
+ * `fitPadding` is applied to both sides of the plot, so 0.5 would leave a
+ * zero-sized extent (and a clipped globe with radius zero). Normalize nullish
+ * values at the public config boundary, and reject invalid values before they
+ * can reach d3 with a negative or non-finite projection extent.
+ */
+export declare function normalizeFitPadding(value: unknown): number;
+export declare function normalizeInitialGeoPipelineConfig(config: GeoPipelineConfig): GeoPipelineConfig;
+export declare function normalizeGeoPipelineConfigUpdate(config: Partial<GeoPipelineConfig>): Partial<GeoPipelineConfig>;

package/dist/components/stream/geoTypes.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from "react";
 import type { GeoProjection, GeoPath, GeoPermissibleObjects } from "d3-geo";
-import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, SceneDatum, PointSceneNode, GlyphSceneNode, ThemeSemanticColors, SceneAccessibilityMetadata, SceneRenderMode } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { AnnotationContext, HoverAnnotationConfig, HoverData } from "../realtime/types";
@@ -33,6 +33,7 @@ export interface DistanceCartogramConfig {
     center: string;
     centerAccessor?: string | ((d: Datum) => string);
     costAccessor: string | ((d: Datum) => number);
+    /** Interpolation from fitted geography (0) to the cost layout (1). Values are clamped to [0, 1]. */
     strength?: number;
     lineMode?: "straight" | "fractional";
     /**
@@ -276,11 +277,7 @@ export interface StreamGeoFrameProps<T = Datum> {
     backgroundGraphics?: ReactNode;
     foregroundGraphics?: ReactNode;
     title?: string | ReactNode;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     legendPosition?: "right" | "left" | "top" | "bottom";
     legendLayout?: LegendLayout;
     legendHoverBehavior?: (item: {

package/dist/components/stream/legendRenderer.d.ts

@@ -1,11 +1,8 @@
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
+import { type AxisChromeInput } from "../legendLayout";
 export interface LegendRenderConfig {
-    legend: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend: LegendValue;
     totalWidth: number;
     totalHeight: number;
     margin: {
@@ -26,6 +23,13 @@ export interface LegendRenderConfig {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendInteraction?: string;
+    /**
+     * Chrome drawn by the **bottom** axis, so a bottom legend can be placed
+     * outside it instead of on top of the tick labels. Omit for frames with no
+     * horizontal axis (network, geo) — the gutter resolves to 0. Top legends do
+     * not auto-measure; see `LegendLayout.axisGutter`.
+     */
+    axisChrome?: AxisChromeInput;
 }
 /**
  * Renders a legend (categorical, gradient, or custom ReactNode) inside an SVG overlay.

package/dist/components/stream/ordinalTypes.d.ts

@@ -5,11 +5,12 @@ import type { AutoPlaceAnnotations } from "../recipes/annotationLayout";
 import type { SymbolName } from "./symbolPath";
 import type { Style, SceneDatum, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors, FrameGraphicsProp, SceneAccessibilityMetadata, SceneRenderMode } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
-import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+import type { LegendLayout, LegendValue } from "../types/legendTypes";
 import type { Datum } from "../charts/shared/datumTypes";
 import type { OnObservationCallback } from "../store/ObservationStore";
 import type { SemanticClickBehavior, SemanticHoverBehavior } from "../charts/shared/semanticInteractions";
 import type { OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
+import type { GradientConfig, GradientInput } from "../charts/shared/gradient";
 export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline" | "funnel" | "bar-funnel" | "swimlane" | "custom";
 export interface OrdinalScales {
     o: ScaleBand<string>;
@@ -223,20 +224,8 @@ export interface OrdinalPipelineConfig {
     barPadding?: number;
     /** Rounded top corner radius for bar charts. Only the end away from the baseline is rounded. For stacked bars, only the topmost segment gets rounded. */
     roundedTop?: number;
-    /** Gradient fill for bar rects. `{ topOpacity, bottomOpacity }` fades the
-     *  resolved fill color from tip (opposite the baseline) to base; `{ colorStops }`
-     *  renders a multi-color gradient along the same axis. Direction follows the
-     *  bar's orientation (tip → base). Same shape as AreaChart.gradientFill
-     *  sans the `boolean` case — the HOC resolves `true` to default opacities. */
-    gradientFill?: {
-        topOpacity: number;
-        bottomOpacity: number;
-    } | {
-        colorStops: Array<{
-            offset: number;
-            color: string;
-        }>;
-    };
+    /** Gradient fill for bar rects. Offset 0 is the tip; offset 1 is the base. */
+    gradientFill?: GradientConfig;
     /** Swimlane "track" fill — a rect drawn behind each lane spanning the
      *  full value-axis range, sized to the lane's bandwidth. Used to make
      *  budget/progress lanes read as filled vs. empty. Pass a color (CSS
@@ -339,17 +328,8 @@ export interface StreamOrdinalFrameProps<T = Datum> {
     };
     barPadding?: number;
     roundedTop?: number;
-    /** Gradient fill for bar rects. Same shape as AreaChart.gradientFill sans
-     *  the boolean case — resolve booleans at the HOC layer. */
-    gradientFill?: {
-        topOpacity: number;
-        bottomOpacity: number;
-    } | {
-        colorStops: Array<{
-            offset: number;
-            color: string;
-        }>;
-    };
+    /** Gradient fill for bar rects. Offset 0 is the tip; offset 1 is the base. */
+    gradientFill?: GradientInput;
     /** Swimlane "track" fill — see OrdinalPipelineConfig.trackFill */
     trackFill?: string | {
         color: string;
@@ -430,11 +410,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
     autoPlaceAnnotations?: AutoPlaceAnnotations;
     svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     showGrid?: boolean;
-    legend?: ReactNode | {
-        legendGroups: LegendGroup[];
-    } | {
-        gradient: GradientLegendConfig;
-    };
+    legend?: LegendValue;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;

package/dist/components/stream/physics/PhysicsEvidence.d.ts

@@ -9,6 +9,31 @@ export interface PhysicsEvidenceBinCount {
     secondaryLabel?: string;
     observed?: number;
 }
+/**
+ * Where every charged body ended up.
+ *
+ * Physics charts all share one deep structure — a charge enters, an apparatus
+ * routes it, and it comes to rest in destinations — so they all owe the same
+ * invariant: every body that entered is accounted for in exactly one place.
+ * That invariant is this family's "bars start at zero": it is what makes a
+ * settled projection an auditable reading rather than a claim about a movie.
+ *
+ * Supply `charge` (the total the chart says entered) and the evidence reports
+ * whether the world can still account for it.
+ */
+export interface PhysicsSettledLedger {
+    /** Total the chart claims entered the apparatus. */
+    charge: number;
+    /** Bodies live in the world when it came to rest. */
+    live: number;
+    /** Bodies the queue still owes and never admitted. */
+    queued: number;
+    /** Bodies retired into sediment by the body budget. */
+    sedimented: number;
+    /** `charge - (live + queued + sedimented)`. Non-zero means bodies vanished. */
+    unaccounted: number;
+    balanced: boolean;
+}
 export interface PhysicsSettledEvidence {
     bodyCount: number;
     sleepingCount: number;
@@ -16,10 +41,22 @@ export interface PhysicsSettledEvidence {
     stepsRun: number;
     seed: number;
     binCounts: PhysicsEvidenceBinCount[];
+    /** Spawns still owed by the queue. Non-zero in a settled scene is a defect. */
+    queuedCount: number;
+    /** Bodies the body budget retired into sediment. */
+    sedimentedCount: number;
+    ledger?: PhysicsSettledLedger;
+    warnings: string[];
 }
 export interface PhysicsSettledEvidenceOptions {
     bodies?: PhysicsBodyState[];
     projectionRows?: PhysicsSettledProjectionRow[];
     stepsRun?: number;
+    /**
+     * Total bodies the chart claims entered the apparatus. Pass it when the chart
+     * knows its own charge (a unitized total, a row count) to enable the ledger
+     * check. Omit it and the ledger is simply absent — never guessed.
+     */
+    charge?: number;
 }
 export declare function buildPhysicsSettledEvidence(snapshot: PhysicsPipelineSnapshot, options?: PhysicsSettledEvidenceOptions): PhysicsSettledEvidence;

package/dist/components/stream/physics/PhysicsKernel.d.ts

@@ -201,6 +201,7 @@ export declare class PhysicsKernelWorld {
     private resolveStaticCollision;
     private updateSensors;
     private updateSleeping;
+    private contactOpposesGravity;
     private wake;
     /** Uses the deterministic PRNG for future jittered spawn helpers. */
     nextRandom(): number;