semiotic 3.1.2 → 3.2.1

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/Heatmap.d.ts

@@ -42,7 +42,7 @@ export interface HeatmapProps<TDatum extends Record<string, any> = Record<string
     /**
      * Format function for x-axis tick labels
      */
-    xFormat?: (d: any) => string;
+    xFormat?: (d: any, index?: number, allTicks?: number[]) => string;
     /**
      * Format function for y-axis tick labels
      */

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/MultiAxisLineChart.d.ts

@@ -0,0 +1,71 @@
+import * as React from "react";
+import type { StreamXYFrameProps, CurveType } from "../../stream/types";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
+import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+/**
+ * Configuration for a single series in a MultiAxisLineChart.
+ */
+export interface MultiAxisSeriesConfig<TDatum = Record<string, any>> {
+    /** Field name or function to access y values for this series */
+    yAccessor: ChartAccessor<TDatum, number>;
+    /** Axis label for this series */
+    label?: string;
+    /** Override color for this series (defaults to theme palette) */
+    color?: string;
+    /** Tick format function for this series' axis */
+    format?: (d: number) => string;
+    /** Fixed extent [min, max] for this series. Required for push API streaming.
+     *  If omitted, computed from data. */
+    extent?: [number, number];
+}
+/**
+ * MultiAxisLineChart component props
+ */
+export interface MultiAxisLineChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+    /** Array of data points shared by both series */
+    data?: TDatum[];
+    /** Field name or function to access x values @default "x" */
+    xAccessor?: ChartAccessor<TDatum, number>;
+    /** Series configuration — exactly 2 for dual-axis mode.
+     *  If not exactly 2, renders as a normal line chart with a console warning. */
+    series: MultiAxisSeriesConfig<TDatum>[];
+    /** Color scheme or custom colors array @default "category10" */
+    colorScheme?: string | string[];
+    /** Enable hover annotations @default true */
+    enableHover?: boolean;
+    /** Curve interpolation @default "monotoneX" */
+    curve?: CurveType;
+    /** Line width in pixels @default 2 */
+    lineWidth?: number;
+    /** Show legend @default true */
+    showLegend?: boolean;
+    /** Show grid lines @default false */
+    showGrid?: boolean;
+    /** Tooltip configuration */
+    tooltip?: TooltipProp;
+    /** Legend interaction mode */
+    legendInteraction?: LegendInteractionMode;
+    /** Legend position */
+    legendPosition?: LegendPosition;
+    /** Annotations */
+    annotations?: Record<string, any>[];
+    /** Additional StreamXYFrame props */
+    frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
+}
+/**
+ * MultiAxisLineChart — Dual Y-axis line chart for comparing two series
+ * with different scales on the same time/x axis.
+ *
+ * Data is unitized (normalized to [0,1]) internally so both series share
+ * a common visual scale. The left axis shows series[0] values and the
+ * right axis shows series[1] values in their original units.
+ *
+ * If `series` does not contain exactly 2 entries, renders as a standard
+ * multi-line chart with a dev-mode console warning.
+ */
+export declare const MultiAxisLineChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: MultiAxisLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

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;
@@ -56,6 +60,8 @@ export interface CrosshairStyle {
 export interface HoverAnnotationConfig {
     crosshair?: boolean | CrosshairStyle;
     snapToPoint?: boolean;
+    /** Color of the hover indicator dot. Defaults to the hovered element's color (stroke for lines, fill for points). Set a CSS color string to override. */
+    pointColor?: string;
 }
 export interface HoverData {
     data: Record<string, any>;

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

@@ -6,6 +6,8 @@ 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 { QuadrantChart } from "./charts/xy/QuadrantChart";
+export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
 export { LinkedCharts } from "./LinkedCharts";
 export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
 export { BarChart } from "./charts/ordinal/BarChart";
@@ -19,6 +21,8 @@ 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 { 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";
@@ -15,4 +16,8 @@ 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 { 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

@@ -0,0 +1,80 @@
+/**
+ * semiotic/themes — Named theme presets for Semiotic charts.
+ *
+ * Each theme provides light and dark mode variants as full SemioticTheme objects.
+ * Use with ThemeProvider: `<ThemeProvider theme={TUFTE_LIGHT} />` or by name:
+ * `<ThemeProvider theme="tufte" />` / `<ThemeProvider theme="tufte-dark" />`.
+ *
+ * Also exports `themeToCSS()` and `themeToTokens()` for serialization.
+ */
+import type { SemioticTheme } from "./store/ThemeStore";
+import { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL } from "./store/ThemeStore";
+export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL };
+export type { SemioticTheme };
+export declare const PASTELS_LIGHT: SemioticTheme;
+export declare const PASTELS_DARK: SemioticTheme;
+export declare const BI_TOOL_LIGHT: SemioticTheme;
+export declare const BI_TOOL_DARK: SemioticTheme;
+export declare const ITALIAN_LIGHT: SemioticTheme;
+export declare const ITALIAN_DARK: SemioticTheme;
+export declare const TUFTE_LIGHT: SemioticTheme;
+export declare const TUFTE_DARK: SemioticTheme;
+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. */
+export type ThemePresetName = keyof typeof THEME_PRESETS;
+/**
+ * Resolve a theme preset name to a SemioticTheme object.
+ * Returns undefined if the name is not recognized.
+ */
+export declare function resolveThemePreset(name: string): SemioticTheme | undefined;
+/**
+ * Convert a SemioticTheme to a CSS custom properties string.
+ * Useful for SSR or generating stylesheet content.
+ *
+ * @param theme - A SemioticTheme object
+ * @param selector - CSS selector to scope the variables (default: `:root`)
+ * @returns CSS string with custom properties
+ *
+ * @example
+ * ```ts
+ * const css = themeToCSS(TUFTE_LIGHT, ".my-charts")
+ * // .my-charts {
+ * //   --semiotic-bg: #fffff8;
+ * //   --semiotic-text: #111111;
+ * //   ...
+ * // }
+ * ```
+ */
+export declare function themeToCSS(theme: SemioticTheme, selector?: string): string;
+/**
+ * Convert a SemioticTheme to a design tokens JSON object.
+ * Compatible with Style Dictionary / Design Token Community Group format.
+ *
+ * @example
+ * ```ts
+ * const tokens = themeToTokens(TUFTE_LIGHT)
+ * // { semiotic: { bg: { $value: "#fffff8", $type: "color" }, ... } }
+ * ```
+ */
+export declare function themeToTokens(theme: SemioticTheme): Record<string, any>;

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-xy.d.ts

@@ -14,4 +14,5 @@ export { Heatmap } from "./charts/xy/Heatmap";
 export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
 export { MinimapChart } from "./charts/xy/MinimapChart";
 export { QuadrantChart } from "./charts/xy/QuadrantChart";
+export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";

package/dist/components/semiotic.d.ts

@@ -1,10 +1,11 @@
 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, QuadrantChart } 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";
+import { createHatchPattern } from "./charts/shared/hatchPattern";
 import { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
 import { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
 import { fromVegaLite } from "./data/fromVegaLite";
@@ -22,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, GroupedBarChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, 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, QuadrantChartProps, 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";
@@ -37,7 +38,10 @@ export type { UseChartObserverOptions, UseChartObserverResult } from "./LinkedCh
 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 { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME } from "./ThemeProvider";
+export { 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 type { ChartErrorBoundaryProps } from "./ChartErrorBoundary";
 export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
 export type { ChartGridProps } from "./ChartGrid";
@@ -47,7 +51,9 @@ 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 { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { smartTickFormat, adaptiveTimeTicks } from "./charts/shared/formatUtils";
+export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
 export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "./Tooltip/Tooltip";
 export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, AnnotationAnchorMode, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
 export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";

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/ThemeStore.d.ts

@@ -4,11 +4,18 @@ export interface SemioticTheme {
         primary: string;
         categorical: string[];
         sequential: string;
+        /** d3-scale-chromatic diverging scheme name, e.g. "RdBu", "PiYG" */
+        diverging?: string;
         background: string;
         text: string;
         textSecondary: string;
         grid: string;
         border: string;
+        focus?: string;
+        /** Linked hover/selection highlight color */
+        selection?: string;
+        /** Opacity for non-selected (dimmed) elements, 0–1 */
+        selectionOpacity?: number;
     };
     typography: {
         fontFamily: string;
@@ -16,16 +23,29 @@ export interface SemioticTheme {
         labelSize: number;
         tickSize: number;
     };
+    tooltip?: {
+        background?: string;
+        text?: string;
+        borderRadius?: string;
+        fontSize?: string;
+        shadow?: string;
+    };
+    borderRadius?: string;
 }
+/** Color-blind safe categorical palette (8 colors).
+ *  Derived from Wong (2011) "Points of view: Color blindness" — safe for
+ *  deuteranopia, protanopia, and tritanopia. */
+export declare const COLOR_BLIND_SAFE_CATEGORICAL: string[];
 export declare const LIGHT_THEME: SemioticTheme;
 export declare const DARK_THEME: SemioticTheme;
+export declare const HIGH_CONTRAST_THEME: SemioticTheme;
 export interface ThemeStoreState {
     theme: SemioticTheme;
-    setTheme: (theme: Partial<SemioticTheme> | "light" | "dark") => void;
+    setTheme: (theme: Partial<SemioticTheme> | "light" | "dark" | "high-contrast") => void;
 }
 export declare const ThemeProvider: import("react").FC<{
     children: React.ReactNode;
 }>, useThemeSelector: <R>(selector: (state: {
     theme: SemioticTheme;
-    setTheme(theme: Partial<SemioticTheme> | "light" | "dark"): void;
+    setTheme(theme: Partial<SemioticTheme> | "light" | "dark" | "high-contrast"): void;
 }) => R) => R;

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;