semiotic 3.8.5 → 3.8.6

package/dist/components/charts/xy/BumpChart.d.ts

@@ -0,0 +1,161 @@
+import * as React from "react";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { StreamXYFrameProps, Style } from "../../stream/types";
+import type { LayoutContext, LayoutResult } from "../../stream/customLayout";
+import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
+import type { Datum } from "../shared/datumTypes";
+import type { TooltipProp } from "../../Tooltip/Tooltip";
+import { type StyleRule } from "../shared/styleRules";
+import type { LegendValue } from "../../types/legendTypes";
+import type { LegendInteractionMode, LegendPosition } from "../shared/useChartLegend";
+export interface RankedBumpDatum<TDatum extends Datum = Datum> extends Datum {
+    x: number;
+    y: number;
+    __bumpRaw: TDatum;
+    __bumpSeries: string;
+    __bumpColorGroup: string;
+    __bumpValue: number;
+    __bumpRank: number;
+    __bumpXValue: unknown;
+    __bumpHighlighted: boolean;
+}
+export interface RankedBumpData<TDatum extends Datum = Datum> {
+    data: RankedBumpDatum<TDatum>[];
+    xValues: unknown[];
+    seriesOrder: string[];
+    overallOrder: string[];
+    valueExtent: [number, number];
+}
+export interface RankBumpDataOptions<TDatum extends Datum = Datum> {
+    xAccessor?: ChartAccessor<TDatum, number | Date | string>;
+    yAccessor?: ChartAccessor<TDatum, number>;
+    lineBy?: ChartAccessor<TDatum, string>;
+    rankDirection?: "descending" | "ascending";
+    highlightTop?: number;
+}
+export declare function mapBumpAnnotations(annotations: Datum[] | undefined, xValues: unknown[]): Datum[] | undefined;
+export declare function resolveBumpColorScheme(options: {
+    seriesOrder: string[];
+    overallOrder: string[];
+    highlightTop?: number;
+    color?: string;
+    colorScheme?: string | string[] | Record<string, string>;
+    neutralColor?: string;
+    themeCategorical?: string[];
+    themeNeutral?: string;
+}): string | string[] | Record<string, string> | undefined;
+/**
+ * Rank every x-column and return the flattened, frame-ready rows used by
+ * BumpChart. Ranking is ordinal and deterministic: equal values retain series
+ * first-appearance order.
+ */
+export declare function rankBumpData<TDatum extends Datum = Datum>(input: TDatum[], options?: RankBumpDataOptions<TDatum>): RankedBumpData<TDatum>;
+export interface BumpLayoutConfig {
+    ribbon: boolean;
+    curve: "smooth" | "linear";
+    samplesPerSegment: number;
+    ribbonSizeRange: [number, number];
+    valueExtent: [number, number];
+    seriesOrder: string[];
+    lineWidth: number;
+    ribbonOpacity: number;
+    lineOpacity: number;
+    neutralColor?: string;
+    color?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    styleRules?: ReadonlyArray<StyleRule>;
+    areaStyle?: (datum: Datum) => Style;
+    pointStyle?: (datum: Datum) => Style & {
+        r?: number;
+    };
+    labelStyle?: React.CSSProperties | ((datum: Datum) => React.CSSProperties);
+    showPoints: boolean;
+    pointRadius: number;
+    showLabels: boolean | "start" | "end" | "both";
+}
+export declare function bumpLayout(ctx: LayoutContext<BumpLayoutConfig>): LayoutResult;
+export interface BumpChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
+    /** Flat observations. Each x-column is ranked from `yAccessor`. */
+    data: TDatum[];
+    /** Ranking column accessor. First-seen order determines the x-axis order. Default `"x"`. */
+    xAccessor?: ChartAccessor<TDatum, number | Date | string>;
+    /** Numeric magnitude to rank and, in ribbon mode, encode as width. Default `"y"`. */
+    yAccessor?: ChartAccessor<TDatum, number>;
+    /** Series identity accessor. Default `"series"`. */
+    lineBy?: ChartAccessor<TDatum, string>;
+    /** Highest values rank first by default; use `"ascending"` for metrics where lower is better. */
+    rankDirection?: "descending" | "ascending";
+    /** Draw magnitude-encoded, perpendicular-offset areas instead of fixed-width lines. */
+    ribbon?: boolean;
+    /** Centerline shape. Smooth uses horizontal-tangent cubic segments. Default `"smooth"`. */
+    curve?: "smooth" | "linear";
+    /** Full ribbon width range in pixels. Default `[4, 28]`. */
+    ribbonSizeRange?: [number, number];
+    /** Number of centerline samples per ranking interval. Default `12`. */
+    samplesPerSegment?: number;
+    /** Fixed line width when `ribbon` is false. Default `3`. */
+    lineWidth?: number;
+    /** Highlight only the N best series by mean rank; all others share `neutralColor`. */
+    highlightTop?: number;
+    /** Shared color for trajectories outside `highlightTop`. */
+    neutralColor?: string;
+    /** Ordered per-datum style rules. Trajectory rules resolve against each series' first observation. */
+    styleRules?: StyleRule[];
+    /** Style endpoint labels globally or per original datum. */
+    labelStyle?: React.CSSProperties | ((datum: TDatum) => React.CSSProperties);
+    colorScheme?: string | string[] | Record<string, string>;
+    ribbonOpacity?: number;
+    lineOpacity?: number;
+    showPoints?: boolean;
+    pointRadius?: number;
+    /** Endpoint labels. `true` is equivalent to `"end"`. Default `true`. */
+    showLabels?: boolean | "start" | "end" | "both";
+    showAxes?: boolean;
+    showGrid?: boolean;
+    showLegend?: boolean;
+    /** Additional legend content. */
+    legend?: LegendValue;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
+    enableHover?: boolean;
+    /** Dim every trajectory except the hovered series. Default `true`. */
+    hoverHighlight?: boolean | "series";
+    tooltip?: TooltipProp;
+    /** Annotation objects. X coordinates may use the original x values. */
+    annotations?: Datum[];
+    /** Additional frame props, with BumpChart geometry remaining controlled. */
+    frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size" | "customLayout" | "layoutConfig">>;
+}
+/**
+ * Ranking-based bump chart. Each x-column ranks its series by `yAccessor`, and
+ * rank becomes vertical position. With `ribbon`, magnitude is encoded by true
+ * screen-space ribbon thickness instead of a vertically interpolated area.
+ *
+ * @example
+ * // Fixed-width ranking lines, coloring only the top 3 series by mean rank.
+ * <BumpChart
+ *   data={data}
+ *   xAccessor="quarter"
+ *   yAccessor="sales"
+ *   lineBy="team"
+ *   highlightTop={3}
+ * />
+ *
+ * @example
+ * // Magnitude-encoded ribbons (width ∝ value) with ascending rank for a
+ * // "lower is better" metric.
+ * <BumpChart
+ *   data={data}
+ *   xAccessor="week"
+ *   yAccessor="latencyMs"
+ *   lineBy="service"
+ *   rankDirection="ascending"
+ *   ribbon
+ * />
+ */
+export declare const BumpChart: {
+    <TDatum extends Datum = Datum>(props: BumpChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/components/charts/xy/DifferenceChart.d.ts

@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import { type GradientInput } from "../shared/gradient";
 export { computeDifferenceSegments } from "./differenceSegments";
 /**
  * DifferenceChart props
@@ -38,16 +39,8 @@ export interface DifferenceChartProps<TDatum extends Datum = Datum> extends Base
     curve?: "linear" | "monotoneX" | "monotoneY" | "step" | "stepAfter" | "stepBefore" | "basis" | "cardinal" | "catmullRom";
     /** Fill opacity for the difference region. Default `0.6`. */
     areaOpacity?: number;
-    /** Gradient fill across each segment, same shape as AreaChart.gradientFill. */
-    gradientFill?: boolean | {
-        topOpacity: number;
-        bottomOpacity: number;
-    } | {
-        colorStops: Array<{
-            offset: number;
-            color: string;
-        }>;
-    };
+    /** Gradient fill from each segment's tip (offset 0) to its base (offset 1). */
+    gradientFill?: GradientInput;
     /** Enable hover annotations. */
     enableHover?: boolean;
     /** Show grid lines. Default `false`. */

package/dist/components/charts/xy/Heatmap.d.ts

@@ -2,6 +2,7 @@ import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { GradientLegendValue } from "../../types/legendTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -103,6 +104,8 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
      * @default "right"
      */
     legendPosition?: "right" | "left" | "top" | "bottom";
+    /** Gradient legend layout overrides. */
+    legend?: Pick<GradientLegendValue, "legendDistance">;
     /**
      * Legend interaction mode.
      * - "highlight": hover dims non-hovered categories to 30% opacity

package/dist/components/charts/xy/LineChart.d.ts

@@ -7,6 +7,7 @@ import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types"
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import { type StyleRule } from "../shared/styleRules";
 import type { AnomalyConfig, ForecastConfig } from "../shared/statisticalOverlays";
+import { type ColorGradientInput } from "../shared/gradient";
 import type { LegendValue } from "../../types/legendTypes";
 /**
  * LineChart component props
@@ -113,15 +114,12 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
      */
     areaOpacity?: number;
     /**
-     * Horizontal gradient for the line stroke. Color stops define a left-to-right gradient.
-     * `{ colorStops: [{ offset: 0, color: "blue" }, { offset: 1, color: "red" }] }`
+     * Horizontal line-stroke gradient. Offset 0 is the left edge and offset 1
+     * is the right edge.
+     * @example
+     * `{ stops: [{ offset: 0, color: "blue" }, { offset: 1, color: "red" }] }`
      */
-    lineGradient?: {
-        colorStops: Array<{
-            offset: number;
-            color: string;
-        }>;
-    };
+    lineGradient?: ColorGradientInput;
     /**
      * Line stroke width
      * @default 2

package/dist/components/geometry/bumpRibbonGeometry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Screen-space geometry for magnitude-encoded bump-chart ribbons.
+ *
+ * A conventional area chart offsets both boundaries vertically. That makes a
+ * band look artificially thin when its centerline moves sharply between
+ * ranks. This helper follows the idea behind d3.svg.ribbon instead: sample the
+ * centerline, calculate its local normal, then offset by the requested radius.
+ * The visible thickness therefore stays perpendicular to the trajectory.
+ */
+export interface BumpRibbonPoint {
+    x: number;
+    y: number;
+    /** Half of the desired visible ribbon thickness, in pixels. */
+    radius: number;
+}
+export interface BumpRibbonGeometry {
+    topPath: [number, number][];
+    bottomPath: [number, number][];
+    /** Index of the nearest input datum for every sampled path vertex. */
+    datumIndices: number[];
+}
+export interface BumpRibbonGeometryOptions {
+    /** Smooth horizontal-tangent Béziers or straight segments. */
+    curve?: "smooth" | "linear";
+    /** Samples emitted for each interval. Stable counts enable path animation. */
+    samplesPerSegment?: number;
+}
+/**
+ * Build paired boundary paths around a bump-chart centerline.
+ *
+ * The first sample of every interval after the first is omitted because it is
+ * identical to the previous interval's final sample. Every trajectory with
+ * the same number of ranking columns therefore emits the same number of
+ * vertices, which lets StreamXYFrame interpolate paths during data updates.
+ */
+export declare function buildBumpRibbonGeometry(points: BumpRibbonPoint[], options?: BumpRibbonGeometryOptions): BumpRibbonGeometry;

package/dist/components/legendLayout.d.ts

@@ -1,8 +1,26 @@
-import type { LegendLayout } from "./types/legendTypes";
+import type { LegendLayout, LegendValue } from "./types/legendTypes";
 export declare const DEFAULT_LEGEND_SWATCH_SIZE = 16;
 export declare const DEFAULT_LEGEND_LABEL_GAP = 6;
 export declare const DEFAULT_LEGEND_ITEM_GAP = 10;
 export declare const DEFAULT_LEGEND_ROW_HEIGHT = 22;
+export declare const DEFAULT_SIDE_LEGEND_WIDTH = 100;
+export declare const DEFAULT_LEGEND_DISTANCE = 10;
+/**
+ * SVG text has no useful intrinsic width until after it is mounted. Keep the
+ * estimate shared by margin calculation and rendering so side legends never
+ * reserve one width and draw into another.
+ */
+export declare function estimateLegendTextWidth(label: string): number;
+/** Resolve the layout box needed by a left/right legend. */
+export declare function resolveSideLegendWidth(legend: LegendValue | null | undefined, layout?: LegendLayout): number;
+/** Resolve the requested gap between the legend edge and plot edge. */
+export declare function resolveLegendDistance(legend: LegendValue | null | undefined): number;
+/** Resolve plot-adjacent chrome reserved before a left/right legend. */
+export declare function resolveLegendSideGutter(layout?: LegendLayout): number;
+/** Estimate the layout-box height used to place a top/bottom legend. */
+export declare function resolveHorizontalLegendHeight(legend: LegendValue | null | undefined, availableWidth: number, layout?: LegendLayout): number;
+/** Margin required to fit a side legend and its plot-edge gap. */
+export declare function resolveSideLegendMargin(legend: LegendValue | null | undefined, layout?: LegendLayout): number;
 export interface LegendMetrics {
     swatchSize: number;
     labelGap: number;

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

@@ -1,4 +1,5 @@
 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";
@@ -141,7 +142,7 @@ export type { ScorecardFixture, ScorecardReport, PerCapabilityScore, PerFixtureS
 export { CANONICAL_FIXTURES } from "./ai/qualityFixtures";
 export { useChartSuggestions } from "./ai/useChartSuggestions";
 export type { UseChartSuggestionsOptions, UseChartSuggestionsResult } from "./ai/useChartSuggestions";
-export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability } from "./ai/chartCapabilities";
+export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, BumpChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability } from "./ai/chartCapabilities";
 export type { ChartCapability, ChartCandidateKind, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, ScaledSuggestionGroups, Suggestion, SuggestionScaleRange, WhyCustomExplanation } from "./ai/chartCapabilityTypes";
 export { defineChartRecipe, validateChartRecipe, isJsonSafe, isRegisteredRecipeLayout } from "./ai/chartRecipes";
 export type { AccessibilityTableField, AccessibilityExpectations, AudienceFitDefinition, ChartRecipe as ChartRecipeDefinition, ChartRecipeFrameFamily, ChartRecipePortability, CustomLayoutFunction, DataRoleDefinition, DataSemanticType, DescriptionStrategy, DesignContractDefinition, EncodingChannel, EncodingDefinition, IntentDefinition, LiteracyTargetDefinition, NavigationStrategy, PortableNavigationStrategy, RecipeAudienceDefinition, RecipeAuditExpectations, RecipeDescription, RecipeExample, RecipeStrategyContext, RecipePortabilityConfig, ReceptionDefinition, RegisteredRecipeLayout, SerializableSchema } from "./ai/chartRecipes";

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

@@ -16,6 +16,7 @@ export type { GeoAreaHitTargetProps, HitTargetPointProps } from "./stream/hitTar
 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 { StreamGeoFrameProps, StreamGeoFrameHandle, GeoAreaSceneNode, GeoSceneNode, GeoScales, ProjectionProp, ProjectionName, GraticuleConfig, DistanceCartogramConfig, GeoPipelineConfig } from "./stream/geoTypes";
 export type { GeoCustomLayout, GeoLayoutContext, GeoLayoutResult } from "./stream/geoCustomLayout";
 export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";

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

@@ -26,6 +26,7 @@ export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
 export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
 export type { NetworkGlyphNode } from "./stream/networkTypes";
 export type { SceneAccessibilityMetadata } from "./stream/types";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
 export type { ForceDirectedGraphProps } from "./charts/network/ForceDirectedGraph";
 export type { SankeyDiagramProps } from "./charts/network/SankeyDiagram";

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

@@ -17,6 +17,7 @@ export { PieChart } from "./charts/ordinal/PieChart";
 export { DonutChart } from "./charts/ordinal/DonutChart";
 export { GaugeChart } from "./charts/ordinal/GaugeChart";
 export type { GaugeChartProps, GaugeThreshold } from "./charts/ordinal/GaugeChart";
+export type { GradientConfig, GradientStop } from "./charts/shared/gradient";
 export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
 export { FunnelChart } from "./charts/ordinal/FunnelChart";
 export { LikertChart } from "./charts/ordinal/LikertChart";
@@ -31,6 +32,7 @@ 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 { createHatchPattern } from "./charts/shared/hatchPattern";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
 export { isHatchFill, hatchPatternDef, resolveSvgFill, hatchFillId } from "./charts/shared/hatchFill";

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

@@ -16,6 +16,7 @@ import { buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhys
 import StreamPhysicsFrame, { StreamPhysicsFrame as NamedStreamPhysicsFrame } from "./stream/physics/StreamPhysicsFrame";
 import { PhysicsPipelineStore } from "./stream/physics/PhysicsPipelineStore";
 import { BuiltInPhysicsEngineAdapter, createDefaultPhysicsEngineAdapter } from "./stream/physics/PhysicsEngineAdapter";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 import { evaluatePhysicsBodyBudget } from "./stream/physics/PhysicsBodyBudget";
 import { PhysicsSedimentAccumulator, sedimentHeightfield } from "./stream/physics/PhysicsSediment";
 import { composePhysicsControllers, createCapacityQueueController, createPortalController, createDependencyGateController, createServiceLevelController, createServiceResourcePoolController } from "./stream/physics/PhysicsControllers";

package/dist/components/semiotic-realtime-core.d.ts

@@ -22,6 +22,7 @@ export type { LatePolicy, ReorderBufferConfig, ReorderResult, } from "./realtime
 export type { EventTimeConfig } from "./charts/realtime/eventTime";
 export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
 export type { RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

package/dist/components/semiotic-server-edge.d.ts

@@ -2,7 +2,7 @@ export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, rende
 export { generateFrameSVGs, generatePhysicsFrameSVGs, generateFrameSequence } from "./server/animatedGif";
 export type { RenderEvidence } from "./server/renderEvidence";
 export type { DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
-export type { LegendLayout } from "./types/legendTypes";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { AnimatedGifOptions, PhysicsGifFrameProps, PhysicsGifOptions, } from "./server/animatedGif";
 export { resolveTheme, themeStyles } from "./server/themeResolver";
 export type { ThemeInput } from "./server/themeResolver";

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

@@ -1,7 +1,7 @@
 export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG, renderGeoToStaticSVG, renderChart, renderChartWithEvidence, renderToImage, renderDashboard, } from "./server/renderToStaticSVG";
 export type { RenderEvidence } from "./server/renderEvidence";
 export type { RenderToImageOptions, DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
-export type { LegendLayout } from "./types/legendTypes";
+export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export { renderToAnimatedGif, renderPhysicsToAnimatedGif, generateFrameSVGs, generatePhysicsFrameSVGs, generateFrameSequence } from "./server/animatedGif";
 export type { AnimatedGifOptions, PhysicsGifFrameProps, PhysicsGifOptions } from "./server/animatedGif";
 export { resolveTheme, themeStyles } from "./server/themeResolver";

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/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;

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;

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

@@ -45,14 +45,16 @@ 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;
 }
 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

@@ -57,10 +57,10 @@ type StaticLegendHostProps = ThemeAwareProps & {
     colorScheme?: string | string[] | Record<string, string>;
 };
 /**
- * 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. */

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;