semiotic 3.2.0 → 3.2.2

package/dist/components/charts/shared/useStreamingLegend.d.ts

@@ -20,8 +20,8 @@ export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, s
     isPushMode: boolean;
     /** The color-by accessor (may be derived from stackBy/groupBy/categoryAccessor) */
     colorBy: Accessor<string> | undefined;
-    /** Color scheme name or custom array */
-    colorScheme: string | string[];
+    /** Color scheme name or custom array — undefined lets useColorScale consult the theme */
+    colorScheme: string | string[] | undefined;
     /** Whether legend is requested */
     showLegend: boolean | undefined;
     /** Legend position */

package/dist/components/charts/shared/validateProps.d.ts

@@ -5,6 +5,8 @@
  * unknown props (typo detection), and data shape via the existing
  * validateArrayData / validateObjectData / validateNetworkData helpers.
  */
+import { VALIDATION_MAP } from "./validationMap";
+export { VALIDATION_MAP };
 export interface ValidationResult {
     valid: boolean;
     errors: string[];
@@ -25,7 +27,6 @@ export interface ComponentSpec {
     /** Per-prop type / enum constraints */
     props: Record<string, PropDef>;
 }
-export declare const VALIDATION_MAP: Record<string, ComponentSpec>;
 /**
  * Validate props for a Semiotic HOC chart component.
  *
@@ -33,4 +34,3 @@ export declare const VALIDATION_MAP: Record<string, ComponentSpec>;
  * unknown prop names (typo detection), and data shape + accessor validity.
  */
 export declare function validateProps(componentName: string, props: Record<string, any>): ValidationResult;
-export {};

package/dist/components/charts/shared/validationMap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Per-component prop specifications for validation.
+ *
+ * Pure data — one ComponentSpec entry per Semiotic HOC chart.
+ * Shared prop fragments (commonProps, xyAxisProps, etc.) are composed
+ * via spread to keep individual entries concise.
+ *
+ * Consumed by: validateProps.ts (validation engine), diagnoseConfig.ts,
+ *              chartConfig.ts, check-schema-freshness.js
+ */
+import type { ComponentSpec } from "./validateProps";
+export declare const VALIDATION_MAP: Record<string, ComponentSpec>;

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

@@ -97,6 +97,17 @@ export interface AreaChartProps<TDatum extends Record<string, any> = Record<stri
      * @default 2
      */
     lineWidth?: number;
+    /**
+     * Show data points on the area line.
+     * Useful for sparse data or single-point series.
+     * @default false
+     */
+    showPoints?: boolean;
+    /**
+     * Point radius when showPoints is true
+     * @default 3
+     */
+    pointRadius?: number;
     /**
      * Enable hover annotations
      * @default true

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

@@ -22,7 +22,7 @@ export interface MinimapConfig {
     /** Brush direction: "x" (default) or "y" */
     brushDirection?: "x" | "y";
 }
-export interface MinimapChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface MinimapChartProps<TDatum extends Record<string, any> = Record<string, any>> extends Omit<BaseChartProps, "onClick" | "onObservation" | "selection" | "linkedHover">, AxisConfig {
     /** Array of data points or line objects with coordinates */
     data: TDatum[];
     /** X accessor (default: "x") */

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

@@ -75,6 +75,17 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
      * @default 2
      */
     lineWidth?: number;
+    /**
+     * Show data points on the area lines.
+     * Useful for sparse data or single-point series.
+     * @default false
+     */
+    showPoints?: boolean;
+    /**
+     * Point radius when showPoints is true
+     * @default 3
+     */
+    pointRadius?: number;
     /**
      * Normalize to 100% stacked (proportional)
      * @default false

package/dist/components/realtime/types.d.ts

@@ -24,6 +24,8 @@ export interface AnnotationContext {
         y?: ScaleLinear<number, number>;
         time?: ScaleLinear<number, number>;
         value?: ScaleLinear<number, number>;
+        /** The raw ordinal band scale (only in ordinal frames). Has .bandwidth(). */
+        o?: any;
     } | null;
     /** @deprecated Use scales.x / scales.y instead */
     timeAxis?: "x" | "y";
@@ -33,6 +35,8 @@ export interface AnnotationContext {
     height?: number;
     data?: Record<string, any>[];
     frameType?: "xy" | "ordinal" | "network";
+    /** Ordinal projection direction (only in ordinal frames) */
+    projection?: "vertical" | "horizontal";
     /** Point scene nodes for point-anchored annotations */
     pointNodes?: {
         pointId?: string;

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

@@ -22,6 +22,7 @@ export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
 export { PieChart } from "./charts/ordinal/PieChart";
 export { DonutChart } from "./charts/ordinal/DonutChart";
 export { FunnelChart } from "./charts/ordinal/FunnelChart";
+export { LikertChart } from "./charts/ordinal/LikertChart";
 export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
 export { ChordDiagram } from "./charts/network/ChordDiagram";
 export { SankeyDiagram } from "./charts/network/SankeyDiagram";

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

@@ -7,6 +7,7 @@ export { StreamOrdinalFrame };
 export { BarChart } from "./charts/ordinal/BarChart";
 export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
 export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
+export { SwimlaneChart } from "./charts/ordinal/SwimlaneChart";
 export { SwarmPlot } from "./charts/ordinal/SwarmPlot";
 export { BoxPlot } from "./charts/ordinal/BoxPlot";
 export { Histogram } from "./charts/ordinal/Histogram";
@@ -16,6 +17,7 @@ export { PieChart } from "./charts/ordinal/PieChart";
 export { DonutChart } from "./charts/ordinal/DonutChart";
 export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
 export { FunnelChart } from "./charts/ordinal/FunnelChart";
+export { LikertChart } from "./charts/ordinal/LikertChart";
 export { createHatchPattern } from "./charts/shared/hatchPattern";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";

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

@@ -23,6 +23,22 @@ export declare const JOURNALIST_LIGHT: SemioticTheme;
 export declare const JOURNALIST_DARK: SemioticTheme;
 export declare const PLAYFUL_LIGHT: SemioticTheme;
 export declare const PLAYFUL_DARK: SemioticTheme;
+/**
+ * IBM Carbon Design System categorical palette (14 colors).
+ * Full palette for data-dense visualizations; themes use the first 4.
+ */
+export declare const CARBON_CATEGORICAL_14: string[];
+/**
+ * IBM Carbon alert palette — danger, warning, success, info.
+ */
+export declare const CARBON_ALERT: {
+    readonly danger: "#da1e28";
+    readonly warning: "#f1c21b";
+    readonly success: "#24a148";
+    readonly info: "#0043ce";
+};
+export declare const CARBON_LIGHT: SemioticTheme;
+export declare const CARBON_DARK: SemioticTheme;
 /** All named theme presets, keyed by slug. */
 export declare const THEME_PRESETS: Record<string, SemioticTheme>;
 /** All valid named theme strings for ThemeProvider. */

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

@@ -0,0 +1,30 @@
+/**
+ * semiotic/utils — Shared utilities, ThemeProvider, and data helpers.
+ *
+ * Lightweight entry point for consumers that need the theme system,
+ * format utilities, data transforms, or color constants without pulling
+ * in any chart type bundles. Import from "semiotic/utils" instead of
+ * "semiotic" to keep bundle size minimal.
+ */
+export { ThemeProvider, useTheme } from "./ThemeProvider";
+export type { SemioticTheme } from "./store/ThemeStore";
+export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL, } from "./store/ThemeStore";
+export { themeToCSS, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT, } from "./semiotic-themes";
+export type { ThemePresetName } from "./semiotic-themes";
+export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils";
+export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
+export { createHatchPattern } from "./charts/shared/hatchPattern";
+export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { validateProps } from "./charts/shared/validateProps";
+export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
+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 { exportChart } from "./export/exportChart";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { RingBuffer } from "./realtime/RingBuffer";
+export { IncrementalExtent } from "./realtime/IncrementalExtent";
+export { normalizeTooltip } from "./Tooltip/Tooltip";
+export { useReducedMotion, useHighContrast } from "./stream/useMediaPreferences";

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, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GroupedBarChart, FunnelChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart } from "./charts";
+import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart } from "./charts";
 import { LinkedCharts } from "./LinkedCharts";
 import { ThemeProvider, useTheme } from "./ThemeProvider";
 import { exportChart } from "./export/exportChart";
@@ -23,8 +23,8 @@ import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/
 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, FunnelChart, GroupedBarChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, 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, createHatchPattern };
-export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, FunnelChartProps, GroupedBarChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, PieChart, DonutChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, 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, createHatchPattern };
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, QuadrantsConfig, QuadrantConfig, CenterlineStyle, 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";
@@ -40,7 +40,7 @@ export type { ResolutionMode, SelectionClause, Selection } from "./store/Selecti
 export type { SemioticTheme } from "./ThemeProvider";
 export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME } from "./ThemeProvider";
 export { COLOR_BLIND_SAFE_CATEGORICAL } from "./store/ThemeStore";
-export { themeToCSS, themeToTokens, resolveThemePreset, THEME_PRESETS } from "./semiotic-themes";
+export { themeToCSS, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT } from "./semiotic-themes";
 export type { ThemePresetName } from "./semiotic-themes";
 export type { ChartErrorBoundaryProps } from "./ChartErrorBoundary";
 export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";

package/dist/components/store/LinkedCrosshairStore.d.ts

@@ -0,0 +1,11 @@
+export declare function setCrosshairPosition(name: string, xValue: number, sourceId: string): void;
+export declare function clearCrosshairPosition(name: string, sourceId: string): void;
+/**
+ * Hook to read a specific crosshair position by name.
+ * Returns the X value and sourceId, or null if no crosshair is active.
+ * When name is undefined, uses a no-op subscription to avoid unnecessary re-renders.
+ */
+export declare function useCrosshairPosition(name: string | undefined): {
+    xValue: number;
+    sourceId: string;
+} | null;

package/dist/components/store/useSelection.d.ts

@@ -1,3 +1,4 @@
+export { useCrosshairPosition, setCrosshairPosition, clearCrosshairPosition } from "./LinkedCrosshairStore";
 export interface UseSelectionOptions {
     /** Name of the selection to participate in */
     name: string;

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

@@ -4,6 +4,7 @@ type AnySceneNode = {
     type: string;
     [key: string]: any;
 };
+declare const SR_ONLY_STYLE: React.CSSProperties;
 /**
  * Compute an aria-label describing the chart type and data shape from the scene graph.
  */
@@ -15,12 +16,17 @@ export declare function computeNetworkAriaLabel(nodeCount: number, edgeCount: nu
 interface AccessibleDataTableProps {
     scene: AnySceneNode[];
     chartType: string;
+    /** Unique ID for skip-navigation link targeting */
+    tableId?: string;
+    /** Chart title — used to disambiguate aria-labels when multiple charts of the same type exist */
+    chartTitle?: string;
 }
 /**
- * Visually-hidden data table for screen readers, generated from the scene graph.
- * Renders up to 50 rows with a truncation note.
+ * JIT accessible data summary. Renders a lightweight sr-only button by default.
+ * On activation (or when ChartContainer's dataSummary action is toggled),
+ * computes a statistical summary (.describe()-style) and shows 5 sample rows.
  */
-export declare function AccessibleDataTable({ scene, chartType }: AccessibleDataTableProps): React.JSX.Element | null;
+export declare function AccessibleDataTable({ scene, chartType, tableId, chartTitle }: AccessibleDataTableProps): React.JSX.Element | null;
 interface NetworkAccessibleDataTableProps {
     nodes: Array<{
         datum?: any;
@@ -36,15 +42,31 @@ interface NetworkAccessibleDataTableProps {
         target?: string;
     }>;
     chartType: string;
+    tableId?: string;
+    chartTitle?: string;
 }
 /**
- * Visually-hidden data table for network charts.
+ * JIT accessible data summary for network charts.
  */
-export declare function NetworkAccessibleDataTable({ nodes, edges, chartType }: NetworkAccessibleDataTableProps): React.JSX.Element | null;
+export declare function NetworkAccessibleDataTable({ nodes, edges, chartType, tableId, chartTitle }: NetworkAccessibleDataTableProps): React.JSX.Element | null;
+/**
+ * Screen-reader-only summary note for the chart.
+ * Rendered as role="note" so assistive technology can discover it.
+ */
+export declare function ScreenReaderSummary({ summary }: {
+    summary?: string;
+}): React.JSX.Element | null;
+/**
+ * Screen-reader-only skip link to jump past chart canvas to the data table.
+ * Only rendered when accessibleTable is enabled.
+ */
+export declare function SkipToTableLink({ tableId }: {
+    tableId: string;
+}): React.JSX.Element;
 /**
  * Visually-hidden aria-live region that mirrors tooltip text for screen readers.
  */
 export declare function AriaLiveTooltip({ hoverPoint }: {
     hoverPoint: any;
 }): React.JSX.Element;
-export {};
+export { SR_ONLY_STYLE };

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

@@ -0,0 +1,33 @@
+import * as React from "react";
+/**
+ * Shape-appropriate keyboard focus indicator for canvas-based charts.
+ *
+ * Renders an SVG overlay with a dashed focus ring whose shape adapts
+ * to the focused element type (circle for points, rect for bars/nodes,
+ * emphasized arc for wedges).
+ */
+export interface FocusRingProps {
+    /** Whether keyboard focus is active */
+    active: boolean;
+    /** Hover point with position info */
+    hoverPoint: {
+        x: number;
+        y: number;
+    } | null;
+    /** Chart margin */
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Total chart size */
+    size: [number, number];
+    /** Shape hint from the focused nav point */
+    shape?: "circle" | "rect" | "wedge";
+    /** Width of rect-shaped focus target */
+    width?: number;
+    /** Height of rect-shaped focus target */
+    height?: number;
+}
+export declare function FocusRing({ active, hoverPoint, margin, size, shape, width, height }: FocusRingProps): React.JSX.Element | null;

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

@@ -0,0 +1,43 @@
+/**
+ * OrdinalBrushOverlay — d3-brush SVG overlay for ordinal frames.
+ *
+ * Renders a transparent SVG positioned above the canvas. Brushes along the
+ * r-axis (value axis) only: horizontal projection → brushX, vertical → brushY.
+ *
+ * Key design decisions:
+ *   - Outer SVG has pointerEvents:"none", inner brush-g has "all", so
+ *     axes/legends rendered underneath remain clickable.
+ *   - d3-brush lifecycle (useEffect) depends on [width, height, isHorizontal]
+ *     only — NOT scales. Scales are read from a ref to avoid brush teardown
+ *     mid-drag (scales change every render due to new object identity).
+ *   - A separate useEffect repositions the brush when scales change (streaming).
+ *
+ * Consumed by: StreamOrdinalFrame (rendered when brush prop is set).
+ * Wired by: useOrdinalBrush hook in HOC charts.
+ */
+import * as React from "react";
+import type { OrdinalScales } from "./ordinalTypes";
+interface OrdinalBrushOverlayProps {
+    width: number;
+    height: number;
+    totalWidth: number;
+    totalHeight: number;
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    scales: OrdinalScales | null;
+    onBrush: (extent: {
+        r: [number, number];
+    } | null) => void;
+}
+/**
+ * SVG brush overlay for ordinal frames.
+ * Brushes along the r-axis (value axis) only.
+ * In horizontal projection, r maps to x-pixels → uses brushX.
+ * In vertical projection, r maps to y-pixels → uses brushY.
+ */
+export declare function OrdinalBrushOverlay({ width, height, totalWidth, totalHeight, margin, scales, onBrush }: OrdinalBrushOverlayProps): React.JSX.Element;
+export {};

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

@@ -1,3 +1,19 @@
+/**
+ * OrdinalPipelineStore — stateful pipeline for ordinal chart data.
+ *
+ * Owns: data ingestion (RingBuffer), scale computation (o-band + r-linear),
+ * value domain logic (per-lane sums for swimlane, zero-inclusion for bars),
+ * and scene layout delegation to ordinalSceneBuilders/*.
+ *
+ * Key design decisions:
+ *   - Swimlane domain uses per-lane sums, not individual values, because
+ *     stacked bars within a lane must fit within the lane's total range.
+ *   - Zero-inclusion for bar/swimlane is skipped when explicit rExtent is
+ *     set (either end non-null), enabling zoom/brush without domain override.
+ *   - Scene builders are pure functions; this store coordinates them.
+ *
+ * Consumed by: StreamOrdinalFrame (sole consumer).
+ */
 import { type ScaleLinear } from "d3-scale";
 import type { OrdinalPipelineConfig, OrdinalScales, OrdinalSceneNode, OrdinalColumn, OrdinalLayout } from "./ordinalTypes";
 import type { Changeset } from "./types";

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

@@ -19,7 +19,7 @@ interface OrdinalSVGOverlayProps {
     showCategoryTicks?: boolean;
     oLabel?: string;
     rLabel?: string;
-    oFormat?: (d: string) => string;
+    oFormat?: (d: string, index?: number) => string;
     rFormat?: (d: number) => string;
     showGrid?: boolean;
     title?: string | ReactNode;

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

@@ -106,6 +106,8 @@ export declare class PipelineStore {
     /** Separate group→color map for resolveGroupColor (insertion-order based, never invalidates _colorMapCache) */
     private _groupColorMap;
     private _barCategoryCache;
+    /** Sorted bin boundary values from the last bar scene build (for data-driven brush snapping) */
+    private _binBoundaries;
     /** Cache stacked area cumulative sums to skip recalculation when buffer hasn't changed */
     private _stackExtentCache;
     /** Monotonic counter incremented on each ingest — used as part of cache keys */
@@ -149,60 +151,14 @@ export declare class PipelineStore {
      */
     private remapScene;
     private buildSceneNodes;
-    private buildLineScene;
-    private buildAreaScene;
-    private buildStackedAreaScene;
-    private buildPointScene;
-    private buildHeatmapScene;
-    /**
-     * Streaming heatmap: discretize continuous x/y into a grid and aggregate.
-     */
-    private buildStreamingHeatmapScene;
-    private buildBarScene;
-    private buildSwarmScene;
-    private buildWaterfallScene;
-    private buildCandlestickScene;
-    private buildBoundsForGroup;
     private resolveBoundsStyle;
-    /**
-     * Compute decay opacity for a datum at `bufferIndex` out of `bufferSize` items.
-     * Index 0 = oldest, bufferSize-1 = newest. Returns 0–1.
-     */
     computeDecayOpacity(bufferIndex: number, bufferSize: number): number;
-    /**
-     * Apply decay opacity to a list of discrete scene nodes.
-     * Uses the datum's index in the buffer data array.
-     */
     private applyDecay;
-    /**
-     * Compute pulse intensity for a datum inserted at `insertTime`.
-     * Returns 0–1 (1 = just inserted, 0 = pulse expired).
-     */
-    private computePulseIntensity;
-    /**
-     * Apply pulse glow to discrete scene nodes.
-     */
     private applyPulse;
-    /**
-     * Returns true if there are active pulse animations that need continuous rendering.
-     */
     get hasActivePulses(): boolean;
-    /**
-     * Snapshot current scene node positions before rebuild.
-     */
+    private get transitionContext();
     private snapshotPositions;
-    /**
-     * Get a stable identity key for a scene node.
-     */
-    private getNodeIdentity;
-    /**
-     * After scene rebuild, set up transition from old to new positions.
-     * Detects entering nodes (new, no prev match) and exiting nodes (prev, no new match).
-     */
     private startTransition;
-    /**
-     * Advance the transition animation. Returns true if still animating.
-     */
     advanceTransition(now: number): boolean;
     private groupData;
     /**
@@ -225,6 +181,8 @@ export declare class PipelineStore {
      */
     private getBufferArray;
     getData(): Record<string, any>[];
+    /** Returns sorted bin boundary values from the last bar scene build. Persists until clear() or the next bar scene build. */
+    getBinBoundaries(): number[];
     getExtents(): {
         x: [number, number];
         y: [number, number];

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

@@ -75,6 +75,10 @@ interface SVGOverlayProps {
     curve?: string;
     /** When true, grid lines and axis baselines are skipped (rendered by SVGUnderlay instead) */
     underlayRendered?: boolean;
+    /** Name of the linked crosshair store entry to read */
+    linkedCrosshairName?: string;
+    /** Source chart ID — crosshair line is suppressed on the source to avoid double rendering */
+    linkedCrosshairSourceId?: string;
     children?: ReactNode;
 }
 interface SVGUnderlayProps {

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

@@ -1,10 +1,15 @@
 import type { SceneNode, LineSceneNode, AreaSceneNode, PointSceneNode, RectSceneNode, HeatcellSceneNode, Style, StreamScales, CurveType } from "./types";
 export declare function buildLineNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, style: Style, group?: string): LineSceneNode;
 export declare function buildAreaNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Record<string, any>) => number): AreaSceneNode;
+/** Per-group-per-x stacked top values, keyed by group then x */
+export type StackedTops = Map<string, Map<number, number>>;
 export declare function buildStackedAreaNodes(groups: {
     key: string;
     data: Record<string, any>[];
-}[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, styleFn: (group: string, sampleDatum?: Record<string, any>) => Style, normalize?: boolean, curve?: CurveType): AreaSceneNode[];
+}[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, styleFn: (group: string, sampleDatum?: Record<string, any>) => Style, normalize?: boolean, curve?: CurveType): {
+    nodes: AreaSceneNode[];
+    stackedTops: StackedTops;
+};
 export declare function buildPointNode(datum: Record<string, any>, scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, r: number, style: Style, pointId?: string): PointSceneNode | null;
 export declare function buildRectNode(x: number, y: number, w: number, h: number, style: Style, datum: any, group?: string): RectSceneNode;
 export declare function buildHeatcellNode(x: number, y: number, w: number, h: number, fill: string, datum: any, options?: {

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

@@ -0,0 +1,47 @@
+/**
+ * XYBrushOverlay — d3-brush SVG overlay for XY frames.
+ *
+ * Renders a transparent SVG positioned above the canvas. Supports x, y, and
+ * xy brush dimensions, bin snapping, and streaming brush tracking (shrinks/
+ * clears the brush as data scrolls past the selected range).
+ *
+ * Key design decisions:
+ *   - d3-brush lifecycle depends on [width, height, dimension, snap, binSize, snapDuring]
+ *     only — scales and binBoundaries are read from refs to avoid teardown mid-drag.
+ *   - Data-driven snapping (binBoundaries) uses binary search to snap to actual bin
+ *     edges. Falls back to uniform grid math (binSize) when no boundaries are provided.
+ *   - Bin snapping applies on "end" events by default. Set snapDuring=true to also
+ *     snap during drag (the "brush" event).
+ *   - Streaming tracking guards against y-only dimension (no x-domain to track).
+ *   - isProgrammaticMoveRef prevents re-entrant brush events from .move() calls.
+ *
+ * Consumed by: StreamXYFrame (rendered when brush prop is set).
+ */
+import * as React from "react";
+import type { StreamScales } from "./types";
+export interface XYBrushOverlayProps {
+    width: number;
+    height: number;
+    totalWidth: number;
+    totalHeight: number;
+    margin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    dimension: "x" | "y" | "xy";
+    scales: StreamScales | null;
+    onBrush: (extent: {
+        x: [number, number];
+        y: [number, number];
+    } | null) => void;
+    binSize?: number;
+    snap?: "continuous" | "bin";
+    /** Sorted bin boundary values for data-driven snapping (overrides uniform grid math when snap="bin"). Defensively sorted internally. */
+    binBoundaries?: number[];
+    /** When true, snap during drag (not just on release). Default false. */
+    snapDuring?: boolean;
+    streaming?: boolean;
+}
+export declare function XYBrushOverlay({ width, height, totalWidth, totalHeight, margin, dimension, scales, onBrush, binSize, snap, binBoundaries, snapDuring, streaming }: XYBrushOverlayProps): React.JSX.Element;

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

@@ -0,0 +1,13 @@
+/**
+ * Dev-mode helper that warns when user callbacks access properties that exist
+ * on `.data` but not on the RealtimeNode/RealtimeEdge wrapper.
+ *
+ * Common pitfall:
+ *   nodeStyle={(d) => ({ fill: d.category })}     // undefined!
+ *   nodeStyle={(d) => ({ fill: d.data?.category })} // correct
+ *
+ * In production, this is a no-op passthrough.
+ */
+export declare function wrapWithDataHint<T extends {
+    data?: Record<string, any>;
+}>(datum: T, callbackName: string): T;

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

@@ -161,8 +161,12 @@ export interface StreamGeoFrameProps<T = Record<string, any>> {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     showAxes?: boolean;
-    /** Render a visually-hidden data table from the scene graph for screen readers (first 50 rows) */
+    /** Render a visually-hidden data table from the scene graph for screen readers */
     accessibleTable?: boolean;
+    /** Accessible description overriding the auto-generated aria-label on the chart container */
+    description?: string;
+    /** Accessible summary rendered as a screen-reader-only note */
+    summary?: string;
 }
 export interface StreamGeoFrameHandle {
     push(datum: Record<string, any>): void;