semiotic 3.0.0 → 3.0.1

package/dist/{charts → components/charts}/xy/LineChart.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
+import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { AnomalyConfig, ForecastConfig } from "../shared/statisticalOverlays";
@@ -106,6 +107,13 @@ export interface LineChartProps<TDatum extends Record<string, any> = Record<stri
      * @default true (when multiple lines)
      */
     showLegend?: boolean;
+    /**
+     * Legend interaction mode.
+     * - "highlight": hover dims non-hovered categories to 30% opacity
+     * - "isolate": click toggles category visibility with checkmark indicators
+     * - "none": static legend (default)
+     */
+    legendInteraction?: LegendInteractionMode;
     /**
      * Tooltip configuration
      */
@@ -116,6 +124,24 @@ export interface LineChartProps<TDatum extends Record<string, any> = Record<stri
      * Annotation objects to render on the chart
      */
     annotations?: Record<string, any>[];
+    /**
+     * Place category labels directly at line endpoints instead of using a separate legend.
+     * When true, auto-hides the legend (override with `showLegend: true`).
+     * Pass an object for fine-grained control.
+     */
+    directLabel?: boolean | {
+        /** Where to place labels relative to the line. @default "end" */
+        position?: "end" | "start";
+        /** Font size for labels. @default 11 */
+        fontSize?: number;
+    };
+    /**
+     * How to handle null/undefined/NaN values in the data.
+     * - "break": break the line at gaps (default)
+     * - "interpolate": connect across gaps (skip missing points)
+     * - "zero": drop to zero at gap boundaries
+     */
+    gapStrategy?: "break" | "interpolate" | "zero";
     /**
      * Anomaly detection configuration. Highlights outlier points and shows
      * a shaded band representing the expected range (mean +/- threshold * stddev).

package/dist/{charts → components/charts}/xy/Scatterplot.d.ts

@@ -2,6 +2,7 @@ import * as React from "react";
 import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * Scatterplot component props
  */
@@ -36,6 +37,8 @@ export interface ScatterplotProps<TDatum extends Record<string, any> = Record<st
     marginalGraphics?: MarginalGraphicsConfig;
     /** Accessor for unique point IDs, used by point-anchored annotations */
     pointIdAccessor?: ChartAccessor<TDatum, string>;
+    /** Legend interaction mode */
+    legendInteraction?: LegendInteractionMode;
     /** Annotation objects to render on the chart */
     annotations?: Record<string, any>[];
     /** Additional StreamXYFrame props for advanced customization */

package/dist/{charts → components/charts}/xy/StackedAreaChart.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
+import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 /**
@@ -93,6 +94,13 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
      * @default true (when multiple areas)
      */
     showLegend?: boolean;
+    /**
+     * Legend interaction mode.
+     * - "highlight": hover dims non-hovered categories to 30% opacity
+     * - "isolate": click toggles category visibility with checkmark indicators
+     * - "none": static legend (default)
+     */
+    legendInteraction?: LegendInteractionMode;
     /**
      * Tooltip configuration
      */

package/dist/{export → components/export}/exportChart.d.ts

@@ -1,5 +1,10 @@
 /**
- * Export a semiotic chart to SVG or PNG from the browser.
+ * Export a semiotic chart to PNG (default) or SVG from the browser.
+ *
+ * PNG export composites the canvas data layer underneath the SVG overlay,
+ * producing a complete image. SVG export captures only the SVG overlay
+ * (axes, labels, annotations) since canvas content cannot be represented
+ * as SVG.
  *
  * @example
  * ```tsx

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

@@ -0,0 +1,61 @@
+export { LineChart } from "./charts/xy/LineChart";
+export { AreaChart } from "./charts/xy/AreaChart";
+export { StackedAreaChart } from "./charts/xy/StackedAreaChart";
+export { Scatterplot } from "./charts/xy/Scatterplot";
+export { ConnectedScatterplot } from "./charts/xy/ConnectedScatterplot";
+export { BubbleChart } from "./charts/xy/BubbleChart";
+export { Heatmap } from "./charts/xy/Heatmap";
+export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
+export { LinkedCharts } from "./LinkedCharts";
+export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
+export { BarChart } from "./charts/ordinal/BarChart";
+export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
+export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
+export { SwarmPlot } from "./charts/ordinal/SwarmPlot";
+export { BoxPlot } from "./charts/ordinal/BoxPlot";
+export { Histogram } from "./charts/ordinal/Histogram";
+export { ViolinPlot } from "./charts/ordinal/ViolinPlot";
+export { DotPlot } from "./charts/ordinal/DotPlot";
+export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
+export { PieChart } from "./charts/ordinal/PieChart";
+export { DonutChart } from "./charts/ordinal/DonutChart";
+export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
+export { ChordDiagram } from "./charts/network/ChordDiagram";
+export { SankeyDiagram } from "./charts/network/SankeyDiagram";
+export { TreeDiagram } from "./charts/network/TreeDiagram";
+export { Treemap } from "./charts/network/Treemap";
+export { CirclePack } from "./charts/network/CirclePack";
+export { OrbitDiagram } from "./charts/network/OrbitDiagram";
+export { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+export { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+export { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
+export { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
+export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
+export { TooltipProvider } from "./store/TooltipStore";
+export { MultiLineTooltip } from "./Tooltip/Tooltip";
+export { ThemeProvider, useTheme } from "./ThemeProvider";
+export { exportChart } from "./export/exportChart";
+export { ChartContainer } from "./ChartContainer";
+export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
+export { ChartGrid } from "./ChartGrid";
+export type { ChartGridProps } from "./ChartGrid";
+export { ContextLayout } from "./ContextLayout";
+export type { ContextLayoutProps } from "./ContextLayout";
+export { CategoryColorProvider, useCategoryColors } from "./CategoryColors";
+export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryColors";
+export { DetailsPanel } from "./DetailsPanel";
+export type { DetailsPanelProps } from "./DetailsPanel";
+export { validateProps } from "./charts/shared/validateProps";
+export type { ValidationResult } from "./charts/shared/validateProps";
+export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
+export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
+export type { AnomalyConfig, ForecastConfig } from "./charts/shared/statisticalOverlays";
+export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
+export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
+export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
+export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { useChartObserver } from "./store/useObservation";
+export type { UseChartObserverOptions, UseChartObserverResult } from "./store/useObservation";
+export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation } from "./store/ObservationStore";

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

@@ -0,0 +1,7 @@
+/**
+ * Semiotic data transform utilities.
+ * Import from "semiotic/data"
+ */
+export { bin, rollup, groupBy, pivot } from "./data/transforms";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";

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

@@ -0,0 +1,14 @@
+/**
+ * Network entry point — force graphs, sankey, chord, trees, treemaps, circle packing.
+ * Import from "semiotic/network" instead of the full bundle to reduce bundle size.
+ */
+import StreamNetworkFrame from "./stream/StreamNetworkFrame";
+export { StreamNetworkFrame };
+export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
+export { SankeyDiagram } from "./charts/network/SankeyDiagram";
+export { ChordDiagram } from "./charts/network/ChordDiagram";
+export { TreeDiagram } from "./charts/network/TreeDiagram";
+export { Treemap } from "./charts/network/Treemap";
+export { CirclePack } from "./charts/network/CirclePack";
+export { OrbitDiagram } from "./charts/network/OrbitDiagram";
+export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";

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

@@ -0,0 +1,18 @@
+/**
+ * Ordinal entry point — bar charts, pie charts, distribution charts.
+ * Import from "semiotic/ordinal" instead of the full bundle to reduce bundle size.
+ */
+import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
+export { StreamOrdinalFrame };
+export { BarChart } from "./charts/ordinal/BarChart";
+export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
+export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
+export { SwarmPlot } from "./charts/ordinal/SwarmPlot";
+export { BoxPlot } from "./charts/ordinal/BoxPlot";
+export { Histogram } from "./charts/ordinal/Histogram";
+export { ViolinPlot } from "./charts/ordinal/ViolinPlot";
+export { DotPlot } from "./charts/ordinal/DotPlot";
+export { PieChart } from "./charts/ordinal/PieChart";
+export { DonutChart } from "./charts/ordinal/DonutChart";
+export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
+export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";

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

@@ -0,0 +1,22 @@
+/**
+ * Realtime entry point — for streaming/realtime canvas-first visualizations.
+ * Import from "semiotic/realtime" instead of the full bundle to reduce bundle size.
+ */
+import StreamXYFrame from "./stream/StreamXYFrame";
+import StreamNetworkFrame from "./stream/StreamNetworkFrame";
+import { RingBuffer } from "./realtime/RingBuffer";
+import { IncrementalExtent } from "./realtime/IncrementalExtent";
+import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+import { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
+import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
+import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
+export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
+export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
+export type { RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
+export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
+export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
+export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
+export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType } from "./stream/types";
+export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType } from "./stream/networkTypes";

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

@@ -0,0 +1 @@
+export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG } from "./server/renderToStaticSVG";

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

@@ -0,0 +1,16 @@
+/**
+ * XY entry point — line, area, scatter, heatmap, and bubble charts.
+ * Import from "semiotic/xy" instead of the full bundle to reduce bundle size.
+ */
+import StreamXYFrame from "./stream/StreamXYFrame";
+export { StreamXYFrame };
+export { LineChart } from "./charts/xy/LineChart";
+export { AreaChart } from "./charts/xy/AreaChart";
+export { StackedAreaChart } from "./charts/xy/StackedAreaChart";
+export { Scatterplot } from "./charts/xy/Scatterplot";
+export { ConnectedScatterplot } from "./charts/xy/ConnectedScatterplot";
+export { BubbleChart } from "./charts/xy/BubbleChart";
+export { Heatmap } from "./charts/xy/Heatmap";
+export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
+export { MinimapChart } from "./charts/xy/MinimapChart";
+export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";

package/dist/components/semiotic.d.ts

@@ -0,0 +1,57 @@
+import StreamXYFrame from "./stream/StreamXYFrame";
+import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
+import StreamNetworkFrame from "./stream/StreamNetworkFrame";
+import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GroupedBarChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart } from "./charts";
+import { LinkedCharts } from "./LinkedCharts";
+import { ThemeProvider, useTheme } from "./ThemeProvider";
+import { exportChart } from "./export/exportChart";
+import { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
+import { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
+import { fromVegaLite } from "./data/fromVegaLite";
+import { ChartErrorBoundary } from "./ChartErrorBoundary";
+import { ChartContainer } from "./ChartContainer";
+import { ChartGrid } from "./ChartGrid";
+import { CategoryColorProvider, useCategoryColors } from "./CategoryColors";
+import { ContextLayout } from "./ContextLayout";
+import { DetailsPanel } from "./DetailsPanel";
+import { Tooltip, MultiLineTooltip, normalizeTooltip } from "./Tooltip/Tooltip";
+import { RingBuffer } from "./realtime/RingBuffer";
+import { IncrementalExtent } from "./realtime/IncrementalExtent";
+import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+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, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, PieChart, DonutChart, GroupedBarChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GroupedBarChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
+export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn } from "./stream/types";
+export type { StreamRendererFn } from "./stream/renderers/types";
+export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
+export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
+export type { SelectionConfig, LinkedHoverProp, LinkedBrushProp } from "./charts/shared/types";
+export type { LinkedChartsProps } from "./LinkedCharts";
+export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
+export type { UseSelectionOptions, UseSelectionResult, UseLinkedHoverOptions, UseLinkedHoverResult, UseBrushSelectionOptions, UseBrushSelectionResult } from "./LinkedCharts";
+export { useChartObserver } from "./LinkedCharts";
+export type { UseChartObserverOptions, UseChartObserverResult } from "./LinkedCharts";
+export type { ChartObservation, OnObservationCallback } from "./store/ObservationStore";
+export type { ResolutionMode, SelectionClause, Selection } from "./store/SelectionStore";
+export type { SemioticTheme } from "./ThemeProvider";
+export { LIGHT_THEME, DARK_THEME } from "./ThemeProvider";
+export type { ChartErrorBoundaryProps } from "./ChartErrorBoundary";
+export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
+export type { ChartGridProps } from "./ChartGrid";
+export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryColors";
+export type { ContextLayoutProps } from "./ContextLayout";
+export type { DetailsPanelProps } from "./DetailsPanel";
+export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
+export { smartTickFormat } from "./charts/shared/formatUtils";
+export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "./Tooltip/Tooltip";
+export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
+export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
+export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
+export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
+export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

package/dist/{server → components/server}/renderToStaticSVG.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Server-side rendering of Semiotic charts to standalone SVG strings.
+ *
+ * Uses the shared SceneToSVG converters (same code used by Stream Frames
+ * for SSR) plus PipelineStore / OrdinalPipelineStore / NetworkPipelineStore
+ * for scene graph computation.
+ */
 import type { StreamXYFrameProps } from "../stream/types";
 import type { StreamNetworkFrameProps } from "../stream/networkTypes";
 import type { StreamOrdinalFrameProps } from "../stream/ordinalTypes";

package/dist/{stream → components/stream}/NetworkSVGOverlay.d.ts

@@ -21,8 +21,28 @@ export interface NetworkSVGOverlayProps {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    legendHighlightedCategory?: string | null;
+    legendIsolatedCategories?: Set<string>;
     /** User-provided SVG elements on top */
     foregroundGraphics?: ReactNode;
+    /** Scene nodes for annotation positioning */
+    sceneNodes?: Array<{
+        type: string;
+        datum: any;
+        id?: string;
+        x?: number;
+        y?: number;
+        cx?: number;
+        cy?: number;
+        w?: number;
+        h?: number;
+    }>;
     /** Annotations */
     annotations?: Record<string, any>[];
     svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: any) => ReactNode;

package/dist/{stream → components/stream}/OrdinalSVGOverlay.d.ts

@@ -25,6 +25,14 @@ interface OrdinalSVGOverlayProps {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    legendHighlightedCategory?: string | null;
+    legendIsolatedCategories?: Set<string>;
     foregroundGraphics?: ReactNode;
     annotations?: Record<string, any>[];
     svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;

package/dist/{stream → components/stream}/PipelineStore.d.ts

@@ -92,6 +92,8 @@ export declare class PipelineStore {
     } | null;
     private prevPositionMap;
     lastIngestTime: number;
+    private needsFullRebuild;
+    private lastLayout;
     scales: StreamScales | null;
     scene: SceneNode[];
     version: number;
@@ -105,6 +107,11 @@ export declare class PipelineStore {
      * Recompute scales and scene graph for the current buffer contents.
      */
     computeScene(layout: StreamLayout): void;
+    /**
+     * Remap existing scene node coordinates for a new layout size.
+     * Proportionally scales all pixel coordinates without rebuilding from data.
+     */
+    private remapScene;
     private buildSceneNodes;
     private buildLineScene;
     private buildAreaScene;

package/dist/{stream → components/stream}/SVGOverlay.d.ts

@@ -10,6 +10,9 @@ export interface AxisConfig {
     tickFormat?: (d: any) => string;
     baseline?: boolean | "under";
     jaggedBase?: boolean;
+    /** Highlight ticks at time boundaries (new month, year, etc.) with semibold text.
+     * `true` auto-detects Date boundaries. A function receives (value, index) and returns true for landmark ticks. */
+    landmarkTicks?: boolean | ((value: any, index: number) => boolean);
 }
 interface SVGOverlayProps {
     width: number;
@@ -34,6 +37,18 @@ interface SVGOverlayProps {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
+    /** Callback when hovering a legend item */
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    /** Callback when clicking a legend item */
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    /** Currently highlighted category label (for hover dimming) */
+    legendHighlightedCategory?: string | null;
+    /** Set of isolated category labels (for click isolation) */
+    legendIsolatedCategories?: Set<string>;
     foregroundGraphics?: ReactNode;
     marginalGraphics?: MarginalGraphicsConfig;
     xValues?: number[];

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

@@ -0,0 +1,20 @@
+/**
+ * Scene graph → SVG element converters.
+ *
+ * Shared module used by Stream Frames for SSR rendering and
+ * by semiotic/server for static SVG export.
+ */
+import * as React from "react";
+import type { SceneNode } from "./types";
+import type { NetworkSceneNode, NetworkSceneEdge, NetworkLabel } from "./networkTypes";
+import type { OrdinalSceneNode } from "./ordinalTypes";
+export declare function xySceneNodeToSVG(node: SceneNode, i: number): React.ReactNode;
+export declare function networkSceneNodeToSVG(node: NetworkSceneNode, i: number): React.ReactNode;
+export declare function networkSceneEdgeToSVG(edge: NetworkSceneEdge, i: number): React.ReactNode;
+export declare function networkLabelToSVG(label: NetworkLabel, i: number): React.ReactNode;
+export declare function ordinalSceneNodeToSVG(node: OrdinalSceneNode, i: number): React.ReactNode;
+/**
+ * Returns true when running in a true server/Node.js context where
+ * window and document are not available.
+ */
+export declare const isServerEnvironment: boolean;

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

@@ -0,0 +1,23 @@
+/**
+ * Shared hit-testing utilities used by CanvasHitTester, OrdinalCanvasHitTester,
+ * and NetworkCanvasHitTester.
+ */
+export interface RectHitResult {
+    hit: boolean;
+    cx: number;
+    cy: number;
+}
+/**
+ * Test whether a point (px, py) falls within a rectangle defined by
+ * { x, y, w, h } and return the rectangle's center coordinates.
+ */
+export declare function hitTestRect(px: number, py: number, node: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}): RectHitResult;
+/**
+ * Normalize an angle to the [0, 2π) range.
+ */
+export declare function normalizeAngle(angle: number): number;

package/dist/{stream → components/stream}/networkTypes.d.ts

@@ -284,7 +284,7 @@ export interface NetworkPipelineConfig {
     edgeStyle?: (d: any) => Record<string, any>;
     nodeLabel?: string | ((d: any) => string);
     showLabels?: boolean;
-    colorBy?: string | ((d: any) => string);
+    colorBy?: string | ((d: any) => string | number);
     colorScheme?: string | string[];
     edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
     edgeOpacity?: number;
@@ -328,7 +328,7 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     particleStyle?: ParticleStyle;
     nodeStyle?: (d: any) => Record<string, any>;
     edgeStyle?: (d: any) => Record<string, any>;
-    colorBy?: string | ((d: any) => string);
+    colorBy?: string | ((d: any) => string | number);
     colorScheme?: string | string[];
     edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
     edgeOpacity?: number;
@@ -377,6 +377,14 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    legendHighlightedCategory?: string | null;
+    legendIsolatedCategories?: Set<string>;
     title?: string | ReactNode;
     foregroundGraphics?: ReactNode;
     backgroundGraphics?: ReactNode;

package/dist/{stream → components/stream}/ordinalTypes.d.ts

@@ -20,6 +20,10 @@ export interface WedgeSceneNode {
     style: Style;
     datum: any;
     category?: string;
+    /** Pulse intensity 0–1 (set when aggregated category value changes) */
+    _pulseIntensity?: number;
+    /** Pulse color */
+    _pulseColor?: string;
 }
 export interface BoxplotSceneNode {
     type: "boxplot";
@@ -35,13 +39,7 @@ export interface BoxplotSceneNode {
     medianPos: number;
     q3Pos: number;
     maxPos: number;
-    stats: {
-        min: number;
-        q1: number;
-        median: number;
-        q3: number;
-        max: number;
-    };
+    stats: DistributionStats;
     style: Style;
     datum: any;
     category?: string;
@@ -141,7 +139,7 @@ export interface OrdinalPipelineConfig {
     showOutliers?: boolean;
     showIQR?: boolean;
     amplitude?: number;
-    oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc";
+    oSort?: ((a: any, b: any) => number) | boolean | "asc" | "desc";
     connectorAccessor?: string | ((d: any) => string);
     connectorStyle?: Style | ((d: any) => Style);
     dynamicColumnWidth?: string | ((data: any[]) => number);
@@ -189,7 +187,7 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     rExtent?: [number?, number?];
     oExtent?: string[];
     extentPadding?: number;
-    oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc";
+    oSort?: ((a: any, b: any) => number) | boolean | "asc" | "desc";
     arrowOfTime?: ArrowOfTime;
     windowMode?: WindowMode;
     windowSize?: number;
@@ -203,7 +201,7 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     oLabel?: string;
     rLabel?: string;
     oFormat?: (d: string) => string;
-    rFormat?: (d: number) => string;
+    rFormat?: (d: number | string) => string;
     enableHover?: boolean;
     hoverAnnotation?: boolean | HoverAnnotationConfig;
     tooltipContent?: (d: HoverData) => ReactNode;
@@ -214,6 +212,14 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    legendHighlightedCategory?: string | null;
+    legendIsolatedCategories?: Set<string>;
     backgroundGraphics?: ReactNode;
     foregroundGraphics?: ReactNode;
     title?: string | ReactNode;

package/dist/components/stream/renderers/areaCanvasRenderer.d.ts

@@ -0,0 +1,2 @@
+import type { StreamRendererFn } from "./types";
+export declare const areaCanvasRenderer: StreamRendererFn;

package/dist/{stream → components/stream}/types.d.ts

@@ -99,6 +99,10 @@ export interface AreaSceneNode {
     };
     /** When false, skip hit testing (used for decorative bounds areas) */
     interactive?: boolean;
+    /** Pulse intensity 0–1 (set when aggregated group value changes) */
+    _pulseIntensity?: number;
+    /** Pulse color */
+    _pulseColor?: string;
 }
 export interface PointSceneNode {
     type: "point";
@@ -307,6 +311,14 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
     legend?: ReactNode | {
         legendGroups: any[];
     };
+    legendHoverBehavior?: (item: {
+        label: string;
+    } | null) => void;
+    legendClickBehavior?: (item: {
+        label: string;
+    }) => void;
+    legendHighlightedCategory?: string | null;
+    legendIsolatedCategories?: Set<string>;
     /** SVG elements rendered behind the canvas (in pixel space) */
     backgroundGraphics?: ReactNode;
     /** SVG elements rendered on top of everything (in SVG overlay) */

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

@@ -0,0 +1,16 @@
+import type { StalenessConfig } from "./types";
+interface StoreWithIngestTime {
+    lastIngestTime: number;
+}
+/**
+ * Shared hook that polls a store's `lastIngestTime` on a 1-second interval
+ * and manages staleness state. When staleness changes it sets
+ * `dirtyRef.current = true` and calls `scheduleRender()` so the canvas
+ * repaints with the appropriate dimming.
+ *
+ * Call this hook after `storeRef`, `dirtyRef`, and `scheduleRender` are
+ * declared. The `isStale` / `setIsStale` state must live in the caller
+ * so that the `useState` call order stays unchanged.
+ */
+export declare function useStalenessCheck(staleness: StalenessConfig | undefined, storeRef: React.RefObject<StoreWithIngestTime | null>, dirtyRef: React.MutableRefObject<boolean>, scheduleRender: () => void, isStale: boolean, setIsStale: (stale: boolean) => void): void;
+export {};

package/dist/{types → components/types}/legendTypes.d.ts

@@ -12,6 +12,11 @@ export interface LegendGroup {
 export interface LegendProps {
     legendGroups?: LegendGroup[];
     customClickBehavior?: Function;
+    customHoverBehavior?: (item: LegendItem | null) => void;
+    /** Set of currently isolated category labels (shown with checkmarks) */
+    isolatedCategories?: Set<string>;
+    /** Whether hover-highlighting is active (dims non-hovered items) */
+    highlightedCategory?: string | null;
     title?: string;
     width?: number;
     height?: number;