semiotic 3.2.0 → 3.2.1

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

@@ -21,7 +21,9 @@ export interface SelectionConfig {
  */
 export type LinkedHoverProp = boolean | string | {
     name?: string;
-    fields: string[];
+    fields?: string[];
+    mode?: "field" | "x-position";
+    xField?: string;
 };
 /**
  * Linked brush config
@@ -76,6 +78,20 @@ export interface BaseChartProps {
     /** Uniform fill color for all data marks. Overrides colorScheme and theme categorical.
      * For per-category coloring, use `colorBy` + `colorScheme` instead. */
     color?: string;
+    /** Accessible description overriding the auto-generated aria-label on the chart container.
+     * Should describe the chart's purpose or content for screen reader users. */
+    description?: string;
+    /** Accessible summary rendered as a screen-reader-only note.
+     * Use for trend descriptions or key takeaways that supplement the visual. */
+    summary?: string;
+    /** Enable accessible data table below the chart canvas. Default: true (via frame). */
+    accessibleTable?: boolean;
+    /** Callback when a data element is clicked. Receives the original datum and pixel coordinates.
+     * For lines, receives the line data; for bars, the bar datum; for pie slices, the slice datum. */
+    onClick?: (datum: any, event: {
+        x: number;
+        y: number;
+    }) => void;
     /** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
     emphasis?: "primary" | "secondary";
     /** Enable declarative bounded animation (enter/exit/update transitions).
@@ -98,6 +114,11 @@ export interface AxisConfig {
     /** Format function for y-axis tick labels */
     yFormat?: (d: any) => string;
 }
+/**
+ * Category formatting for ordinal chart tick labels.
+ * Receives the category value and its index, returns a formatted string.
+ */
+export type CategoryFormatFn = (label: string, index?: number) => string;
 /**
  * Accessor type - can be a property name or a function
  * @deprecated Use DataAccessor from generalTypes for generic type safety

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

@@ -19,8 +19,8 @@ export interface ChartSetupInput {
     rawData: unknown[] | undefined;
     /** The color-by accessor (may be an "actual" colorBy 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;
     /** Legend interaction mode */
     legendInteraction: LegendInteractionMode | undefined;
     /** Legend position override */
@@ -50,6 +50,11 @@ export interface ChartSetupInput {
         left: number;
         right: number;
     };
+    /** onClick callback */
+    onClick?: (datum: any, event: {
+        x: number;
+        y: number;
+    }) => void;
     /** Loading state */
     loading: boolean | undefined;
     /** Empty content override */
@@ -92,6 +97,11 @@ export interface ChartSetupResult {
     earlyReturn: ReactElement | null;
     /** Props to spread into the stream frame for legend behavior */
     legendBehaviorProps: Record<string, any>;
+    /** Crosshair props to spread into StreamXYFrame when linkedHover mode is "x-position" */
+    crosshairProps: {
+        linkedCrosshairName: string;
+        linkedCrosshairSourceId: string;
+    } | undefined;
 }
 /**
  * Hook that consolidates the shared boilerplate across all HOC charts:

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

@@ -0,0 +1,51 @@
+import type { RefObject, MutableRefObject } from "react";
+import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
+export interface AggregatedRow {
+    __likertCategory: string;
+    /** Stacking key — may be sentinel value for neutral halves */
+    __likertLevel: string;
+    /** Human-readable level label — always the original level name (for legend/selection) */
+    __likertLevelLabel: string;
+    __likertCount: number;
+    __likertPct: number;
+    __likertLevelIndex: number;
+}
+/** Sentinel level names for the neutral split halves */
+export declare const NEUTRAL_NEG = "__likert_neutral_neg";
+export declare const NEUTRAL_POS = "__likert_neutral_pos";
+export declare function resolveAccessorFn<T>(accessor: string | ((d: any) => T) | undefined, fallback: string): (d: any) => T;
+/**
+ * Generate a diverging color scheme for N levels.
+ * Interpolates from red → gray → blue for odd, red → blue for even.
+ */
+export declare function defaultDivergingScheme(n: number): string[];
+export declare function aggregateData(data: any[], levels: string[], getCat: (d: any) => string, getScore: ((d: any) => number) | null, getLevel: ((d: any) => string) | null, getCount: ((d: any) => number) | null): AggregatedRow[];
+export declare function toDivergingValues(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
+export declare function orderForDiverging(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
+interface UseLikertAggregationConfig {
+    data: any[] | undefined;
+    levels: string[];
+    categoryAccessor?: string | ((d: any) => string);
+    valueAccessor?: string | ((d: any) => number);
+    levelAccessor?: string | ((d: any) => string);
+    countAccessor?: string | ((d: any) => number);
+    isDiverging: boolean;
+    frameRef: RefObject<StreamOrdinalFrameHandle | null>;
+}
+interface UseLikertAggregationResult {
+    /** Pre-processed data for static mode */
+    processedData: AggregatedRow[];
+    /** Re-aggregate all accumulated data (call from push handlers) */
+    reAggregate: (rawData: any[]) => void;
+    /** Ref holding accumulated raw data for push mode */
+    accumulatorRef: MutableRefObject<any[]>;
+}
+/**
+ * Encapsulates Likert-specific data aggregation:
+ * - Resolves accessor functions
+ * - Aggregates raw/pre-aggregated data to percentages
+ * - Applies diverging transforms (sign flip, neutral split, stacking order)
+ * - Provides re-aggregation callback for push API streaming
+ */
+export declare function useLikertAggregation({ data, levels, categoryAccessor, valueAccessor, levelAccessor, countAccessor, isDiverging, frameRef, }: UseLikertAggregationConfig): UseLikertAggregationResult;
+export {};

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

@@ -0,0 +1,28 @@
+import type { ChartAccessor } from "./types";
+export interface OrdinalBrushInput {
+    brushProp: boolean | undefined;
+    onBrushProp: ((extent: {
+        r: [number, number];
+    } | null) => void) | undefined;
+    linkedBrush: string | {
+        name: string;
+        rField?: string;
+    } | undefined;
+    valueAccessor: ChartAccessor<any, number>;
+}
+export interface OrdinalBrushResult {
+    hasBrush: boolean;
+    handleBrush: (extent: {
+        r: [number, number];
+    } | null) => void;
+    /** Spread into streamProps: `...brushStreamProps` */
+    brushStreamProps: {
+        brush: {
+            dimension: "r";
+        };
+        onBrush: (extent: {
+            r: [number, number];
+        } | null) => void;
+    } | Record<string, never>;
+}
+export declare function useOrdinalBrush({ brushProp, onBrushProp, linkedBrush, valueAccessor, }: OrdinalBrushInput): OrdinalBrushResult;

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

@@ -0,0 +1,54 @@
+import type { Ref, RefObject } from "react";
+import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { Accessor } from "./types";
+import type { LegendPosition } from "./hooks";
+interface UseOrdinalStreamingConfig {
+    /** External ref for push API */
+    ref: Ref<RealtimeFrameHandle>;
+    /** Internal frame ref */
+    frameRef: RefObject<StreamOrdinalFrameHandle | null>;
+    /** True when data prop is undefined (push API mode) */
+    isPushMode: boolean;
+    /** Color-by accessor (may be derived from stackBy/groupBy/etc.) */
+    colorBy: Accessor<string> | undefined;
+    /** Color scheme name or array — undefined lets useColorScale consult the theme */
+    colorScheme: string | string[] | undefined;
+    /** Whether legend is requested */
+    showLegend: boolean | undefined;
+    /** Legend position */
+    legendPosition?: LegendPosition;
+    /** Results from useChartSetup — needed for legend/margin merge */
+    setup: {
+        legendBehaviorProps: Record<string, any>;
+        legendPosition: LegendPosition;
+        margin: {
+            top: number;
+            right: number;
+            bottom: number;
+            left: number;
+        };
+    };
+}
+interface UseOrdinalStreamingResult {
+    /** Legend props merged with streaming legend (spread into streamProps) */
+    effectiveLegendProps: Record<string, any>;
+    /** Margin merged with streaming legend margin adjustments */
+    effectiveMargin: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * Shared hook for ordinal charts that support push API + streaming legend.
+ *
+ * Consolidates: useStreamingLegend, wrappedPush/pushMany,
+ * useImperativeHandle, effectiveLegendProps, effectiveMargin.
+ *
+ * Used by: StackedBarChart, GroupedBarChart, PieChart, DonutChart, SwimlaneChart.
+ * NOT used by LikertChart (custom accumulator + deterministic legend).
+ */
+export declare function useOrdinalStreaming({ ref, frameRef, isPushMode, colorBy, colorScheme, showLegend, legendPosition, setup, }: UseOrdinalStreamingConfig): UseOrdinalStreamingResult;
+export {};

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;