semiotic 3.5.3 → 3.5.4

package/dist/components/charts/network/Treemap.d.ts

@@ -19,6 +19,14 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
     nodeLabel?: ChartAccessor<TNode, string>;
     padding?: number;
     paddingTop?: number;
+    /**
+     * Per-node style overlay. The returned style is merged on top of
+     * Treemap's built-in colorBy/colorByDepth/default fill, then primitive
+     * props and selection state are applied. Use this for root hiding,
+     * custom borders, or per-depth opacity without re-implementing color
+     * encoding.
+     */
+    nodeStyle?: (d: Datum) => Datum;
     enableHover?: boolean;
     legendInteraction?: LegendInteractionMode;
     tooltip?: TooltipProp;

package/dist/components/charts/ordinal/GaugeChart.d.ts

@@ -4,6 +4,7 @@ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { BaseChartProps } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { RealtimeFrameHandle } from "../../realtime/types";
+import { type GaugeGradientFill } from "../shared/gaugeGradient";
 export interface GaugeThreshold {
     /** Upper bound of this zone (value, not percentage) */
     value: number;
@@ -21,6 +22,15 @@ export interface GaugeChartProps extends BaseChartProps {
     max?: number;
     /** Threshold zones — ordered list of { value, color, label? }. Last threshold's value should equal max. */
     thresholds?: GaugeThreshold[];
+    /**
+     * Arc-length gradient for the gauge band.
+     *
+     * The gradient is sampled along the visible filled arc from sweep start
+     * toward the current value. If `fillZones` is false, the entire arc uses
+     * the gradient. If `fillZones` is true, the unfilled remainder stays on
+     * `backgroundColor`.
+     */
+    gradientFill?: GaugeGradientFill;
     /** Color of the value arc when no thresholds defined (default: theme primary) */
     color?: string;
     /** Background arc color (default: var(--semiotic-grid, #e0e0e0)) */

package/dist/components/charts/realtime/RealtimeHistogram.d.ts

@@ -6,6 +6,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { ChartMode, ChartAccessor, SelectionConfig } from "../shared/types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { Datum } from "../shared/datumTypes";
+export type RealtimeHistogramDirection = "up" | "down";
 export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
     /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
     mode?: ChartMode;
@@ -44,6 +45,14 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> {
     timeExtent?: [number, number];
     /** Fixed value domain */
     valueExtent?: [number, number];
+    /**
+     * Direction bars grow from the baseline.
+     * "up" uses the normal y-domain. "down" flips the resolved value
+     * domain so bars grow downward from the top, useful for mirrored
+     * histogram layouts. Explicit valueExtent is reversed.
+     * @default "up"
+     */
+    direction?: RealtimeHistogramDirection;
     /** Extent padding factor */
     extentPadding?: number;
     /**
@@ -175,6 +184,19 @@ export declare const RealtimeHistogram: {
     <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };
+export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
+    /** Static data array for a bounded temporal histogram. */
+    data: TDatum[];
+}
+/**
+ * Static-data sibling for temporal histograms. Use this when the data is a
+ * bounded array rather than a ref-driven stream; the realtime push API is not
+ * part of this public surface.
+ */
+export declare function TemporalHistogram<TDatum extends Datum = Datum>(props: TemporalHistogramProps<TDatum>): import("react/jsx-runtime").JSX.Element;
+export declare namespace TemporalHistogram {
+    var displayName: string;
+}
 /** @deprecated Use `RealtimeHistogram` (the canonical public name) instead. The
  *  `RealtimeTemporalHistogram` alias is preserved for back-compat with code
  *  written before the rename and will be removed in a future major version. */

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

@@ -0,0 +1,62 @@
+import type { Datum } from "./datumTypes";
+export interface GaugeThresholdLike {
+    value: number;
+    color: string;
+    label?: string;
+}
+export interface GaugeGradientStop {
+    offset: number;
+    color: string;
+}
+export interface GaugeGradientFill {
+    colorStops: GaugeGradientStop[];
+}
+export interface GaugeArcDatum extends Datum {
+    category: string;
+    value: number;
+    _zone?: string;
+    _isFill: boolean;
+    _pctStart?: number;
+    _pct?: number;
+    _roundedEnds?: {
+        start?: boolean;
+        end?: boolean;
+    };
+    _nonInteractive?: boolean;
+    /** Pre-computed gradient colors for the rendered band. Each entry is
+     *  the color for one equal-angle slice across the band's full angular
+     *  span. The wedge renderer reads this and paints the slices itself
+     *  inside a clip-mask shaped like the wedge's rounded outline. */
+    _gradientBand?: {
+        colors: string[];
+    };
+}
+export interface GaugeArcModel {
+    gaugeData: GaugeArcDatum[];
+    pieceStyle: (d: Datum, category?: string) => {
+        fill: string;
+        opacity?: number;
+    };
+    gaugeAnnotations: Datum[];
+}
+interface BuildGaugeArcModelOptions {
+    min: number;
+    max: number;
+    value: number;
+    thresholds?: GaugeThresholdLike[];
+    fillColor?: string;
+    backgroundColor: string;
+    fillZones: boolean;
+    showScaleLabels: boolean;
+    gradientFill?: GaugeGradientFill;
+    gradientSteps?: number;
+}
+/**
+ * Build the synthetic wedge data model used by GaugeChart.
+ *
+ * When `gradientFill` is provided, the visible fill is split into many thin
+ * slices and sampled against the supplied color stops so color changes along
+ * the arc length rather than by threshold zone.
+ */
+export declare function buildGaugeArcModel(options: BuildGaugeArcModelOptions): GaugeArcModel;
+export {};

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

@@ -1,7 +1,7 @@
 import { createLegend } from "./legendUtils";
 import type { SelectionHookResult } from "./selectionUtils";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-import type { Accessor, SelectionConfig, LinkedHoverProp, ChartMode } from "./types";
+import type { Accessor, SelectionConfig, LinkedHoverProp, ChartMode, HoverHighlightMode } from "./types";
 import type { MarginType, PartialMargin } from "../../types/marginType";
 import type { TransitionConfig } from "../../stream/types";
 import type { Datum } from "./datumTypes";
@@ -76,7 +76,7 @@ export declare function useChartSelection({ selection, linkedHover, fallbackFiel
         x: number;
         y: number;
     }) => void;
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     colorByField?: string;
 }): {
     activeSelectionHook: SelectionHookResult | null;

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

@@ -2,7 +2,7 @@ import type { ReactNode } from "react";
 import type { Datum } from "./datumTypes";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { HoverData } from "../../realtime/types";
-import type { LinkedHoverProp, SelectionConfig } from "./types";
+import type { HoverHighlightMode, LinkedHoverProp, SelectionConfig } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { AnimateProp } from "../../stream/pipelineTransitionUtils";
 /**
@@ -74,7 +74,7 @@ export declare function buildCustomBehaviorProps(input: {
         x: number;
         y: number;
     }) => void) | undefined;
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     customHoverBehavior: (d: Datum | null) => void;
     customClickBehavior: (d: Datum | null) => void;
     /**

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

@@ -43,6 +43,13 @@ export type LinkedBrushProp = string | {
  * User-provided props always override mode defaults.
  */
 export type ChartMode = "primary" | "context" | "sparkline";
+/**
+ * Hover highlighting mode.
+ * `true` and `"series"` both dim non-hovered series/categories; the string
+ * form is accepted for compatibility with wrapper libraries that expose a
+ * more explicit per-series mode.
+ */
+export type HoverHighlightMode = boolean | "series";
 /**
  * Base props shared across all chart components
  */
@@ -55,7 +62,9 @@ export interface BaseChartProps {
     height?: number;
     /** Margin around the chart. Accepts a number (same on all sides) or an object
      *  with any subset of `top`/`bottom`/`left`/`right`. Missing sides fall back
-     *  to the chart-mode defaults. */
+     *  to the chart-mode defaults. Use `"auto"` or `null` for a side to explicitly
+     *  allow chart auto-reservation, e.g. `margin={{ right: "auto" }}` with a
+     *  right-side legend. */
     margin?: PartialMargin;
     /** Auto-match width to parent container. Default: false */
     responsiveWidth?: boolean;
@@ -110,7 +119,7 @@ export interface BaseChartProps {
         y: number;
     }) => void;
     /** Dim non-hovered series when hovering a data mark. Requires `colorBy`. */
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     /** Max pixel distance for hover/click hit testing. Default 30. Increase for sparse charts, decrease for dense ones. */
     hoverRadius?: number;
     /** ID accessor for remove()/update() on XY charts. Extracts a unique identifier from each datum. */

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

@@ -1,7 +1,7 @@
 import type { Datum } from "./datumTypes";
 import { useChartLegendAndMargin, useLegendInteraction, DEFAULT_COLOR } from "./hooks";
 import type { LegendInteractionMode, LegendPosition } from "./hooks";
-import type { Accessor, SelectionConfig, LinkedHoverProp } from "./types";
+import type { Accessor, SelectionConfig, LinkedHoverProp, HoverHighlightMode } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { PartialMargin } from "../../types/marginType";
 import type { SelectionHookResult } from "./selectionUtils";
@@ -57,7 +57,7 @@ export interface ChartSetupInput {
         y: number;
     }) => void;
     /** Dim non-hovered series on data mark hover */
-    hoverHighlight?: boolean;
+    hoverHighlight?: HoverHighlightMode;
     /** Loading state */
     loading: boolean | undefined;
     /** Custom content rendered in place of the default skeleton while `loading` is true. */

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

@@ -3,7 +3,7 @@ import { useChartMode } from "./hooks";
 import { type ChartSetupResult } from "./useChartSetup";
 import type { ChartMode, SelectionConfig, LinkedHoverProp } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-import type { PartialMargin, MarginType } from "../../types/marginType";
+import { type PartialMargin, type MarginType } from "../../types/marginType";
 import type { Datum } from "./datumTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 /**

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

@@ -6,6 +6,13 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { ForecastConfig, AnomalyConfig } from "../shared/statisticalOverlays";
+export interface SemanticGradientStop {
+    /** Percent from baseline to line/top. 0 = baseline, 100 = line/top. */
+    at: number;
+    color: string;
+    /** Optional opacity applied to this stop. */
+    opacity?: number;
+}
 /**
  * AreaChart component props
  */
@@ -90,6 +97,14 @@ export interface AreaChartProps<TDatum extends Datum = Datum> extends BaseChartP
             color: string;
         }>;
     };
+    /**
+     * Semantic area gradient stops expressed in user-facing percentages:
+     * `at: 0` is the baseline and `at: 100` is the line/top of the area.
+     * This is converted to `gradientFill.colorStops`, whose raw offsets use
+     * the renderer coordinate convention (`0` = top, `1` = baseline).
+     * When set, this takes precedence over `gradientFill`.
+     */
+    semanticGradient?: SemanticGradientStop[];
     /**
      * Area opacity (flat fill, ignored when gradientFill is set)
      * @default 0.7

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

@@ -37,7 +37,7 @@ export { Treemap } from "./charts/network/Treemap";
 export { CirclePack } from "./charts/network/CirclePack";
 export { OrbitDiagram } from "./charts/network/OrbitDiagram";
 export { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-export { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+export { RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 export { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 export { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";

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

@@ -7,13 +7,13 @@ import StreamNetworkFrame from "./stream/StreamNetworkFrame";
 import { RingBuffer } from "./realtime/RingBuffer";
 import { IncrementalExtent } from "./realtime/IncrementalExtent";
 import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-import { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
+export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
 export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
-export type { RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

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

@@ -1,5 +1,6 @@
 export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG, renderGeoToStaticSVG, renderChart, renderToImage, renderDashboard, } from "./server/renderToStaticSVG";
 export type { RenderToImageOptions, DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
+export type { LegendLayout } from "./types/legendTypes";
 export { renderToAnimatedGif, generateFrameSVGs, generateFrameSequence } from "./server/animatedGif";
 export type { AnimatedGifOptions } from "./server/animatedGif";
 export { resolveTheme, themeStyles } from "./server/themeResolver";

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

@@ -21,7 +21,7 @@ export { XYCustomChart } from "./charts/custom/XYCustomChart";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
 export type { CustomLayout, LayoutContext, LayoutResult } from "./stream/customLayout";
 export type { LineChartProps } from "./charts/xy/LineChart";
-export type { AreaChartProps } from "./charts/xy/AreaChart";
+export type { AreaChartProps, SemanticGradientStop } from "./charts/xy/AreaChart";
 export type { DifferenceChartProps } from "./charts/xy/DifferenceChart";
 export type { StackedAreaChartProps } from "./charts/xy/StackedAreaChart";
 export type { ScatterplotProps } from "./charts/xy/Scatterplot";

package/dist/components/semiotic.d.ts

@@ -19,12 +19,13 @@ import { Tooltip, MultiLineTooltip, normalizeTooltip } from "./Tooltip/Tooltip";
 import { RingBuffer } from "./realtime/RingBuffer";
 import { IncrementalExtent } from "./realtime/IncrementalExtent";
 import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
-import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram } from "./charts/realtime/RealtimeHistogram";
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
-export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
+export type { LegendLayout } from "./types/legendTypes";
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, SemanticGradientStop, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
 export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn, XYFrameAxisConfig, BandConfig } from "./stream/types";
 export type { StreamRendererFn } from "./stream/renderers/types";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
@@ -57,7 +58,7 @@ 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";
-export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

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

@@ -1,4 +1,5 @@
 import type { Datum } from "../charts/shared/datumTypes";
+import type { LegendLayout } from "../types/legendTypes";
 /**
  * Server-side rendering of Semiotic charts to standalone SVG strings.
  *
@@ -33,6 +34,7 @@ interface ThemeAwareProps {
     background?: string;
     className?: string;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     /** Prefix for SVG element IDs — used by renderDashboard to avoid collisions */
     _idPrefix?: string;
 }

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

@@ -7,6 +7,21 @@
 import * as React from "react";
 import type { SemioticTheme } from "../store/ThemeStore";
 import type { Datum } from "../charts/shared/datumTypes";
+import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+interface LegendItemLayout {
+    category: string;
+    width: number;
+    x: number;
+    y: number;
+}
+interface StaticLegendMetrics {
+    items: LegendItemLayout[];
+    width: number;
+    height: number;
+    swatchSize: number;
+    labelOffset: number;
+    swatchRadius: number;
+}
 export interface StaticLegendConfig {
     /** Category labels to show in legend */
     categories: string[];
@@ -28,13 +43,33 @@ export interface StaticLegendConfig {
     };
     /** Title presence (affects top-position offset) */
     hasTitle?: boolean;
+    /** SSR legend layout controls */
+    legendLayout?: LegendLayout;
+    /** Optional id namespace used for generated SVG ids */
+    idPrefix?: string;
+}
+export interface StaticLegendGroupsConfig extends Omit<StaticLegendConfig, "categories" | "colorScheme"> {
+    legendGroups: LegendGroup[];
+}
+export interface StaticGradientLegendConfig extends Omit<StaticLegendConfig, "categories" | "colorScheme"> {
+    gradient: GradientLegendConfig;
 }
+export declare function measureStaticLegend(config: StaticLegendConfig): Omit<StaticLegendMetrics, "items" | "labelOffset" | "swatchRadius">;
+export declare function measureStaticLegendGroups(config: StaticLegendGroupsConfig): Omit<StaticLegendMetrics, "items" | "labelOffset" | "swatchRadius">;
+export declare function measureStaticGradientLegend(config: StaticGradientLegendConfig): {
+    width: number;
+    height: number;
+    swatchSize: number;
+};
 /**
  * Render a static legend as SVG elements.
  * Returns null if no categories to show.
  */
 export declare function renderStaticLegend(config: StaticLegendConfig): React.ReactNode;
+export declare function renderStaticLegendGroups(config: StaticLegendGroupsConfig): React.ReactNode;
+export declare function renderStaticGradientLegend(config: StaticGradientLegendConfig): React.ReactNode;
 /**
  * Extract unique categories from data using an accessor.
  */
 export declare function extractCategories(data: any[], accessor: string | ((d: Datum) => string) | undefined): string[];
+export {};

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

@@ -34,6 +34,8 @@ export interface SemioticTheme {
         textSecondary: string;
         grid: string;
         border: string;
+        /** Separator/border color for cell-like marks such as treemap tiles and heatmap cells. Falls back to `border`. */
+        cellBorder?: string;
         focus?: string;
         /** Linked hover/selection highlight color */
         selection?: string;

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

@@ -1,7 +1,7 @@
 import type { Datum } from "../charts/shared/datumTypes";
 import type { ReactNode } from "react";
 import type { NetworkLabel } from "./networkTypes";
-import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
 type AnnotationAnchorNode = {
     type: string;
     datum: Datum | null;
@@ -43,6 +43,7 @@ export interface NetworkSVGOverlayProps {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     /** User-provided SVG elements on top */
     foregroundGraphics?: ReactNode;
     /** Scene nodes for annotation positioning */

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

@@ -3,7 +3,7 @@ import * as React from "react";
 import type { OrdinalScales } from "./ordinalTypes";
 import type { AnnotationContext } from "../realtime/types";
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
 import { type AxisExtentMode } from "../charts/shared/axisExtent";
 interface OrdinalSVGOverlayProps {
     width: number;
@@ -49,6 +49,7 @@ interface OrdinalSVGOverlayProps {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     foregroundGraphics?: ReactNode;
     annotations?: Datum[];
     svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;

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

@@ -2,7 +2,7 @@ import type { Datum } from "../charts/shared/datumTypes";
 import type { StreamScales, MarginalGraphicsConfig, XYFrameAxisConfig } from "./types";
 import type { AnnotationContext } from "../realtime/types";
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
 export type AxisConfig = XYFrameAxisConfig;
 interface SVGOverlayProps {
     width: number;
@@ -51,6 +51,7 @@ interface SVGOverlayProps {
     legendIsolatedCategories?: Set<string>;
     /** Legend position relative to chart area */
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     foregroundGraphics?: ReactNode;
     marginalGraphics?: MarginalGraphicsConfig;
     xValues?: number[];

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

@@ -13,7 +13,7 @@ export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?:
 export declare function networkSceneNodeToSVG(node: NetworkSceneNode, i: number): React.ReactNode;
 export declare function networkSceneEdgeToSVG(edge: NetworkSceneEdge, i: number): React.ReactNode;
 export declare function networkLabelToSVG(label: NetworkLabel, i: number): React.ReactNode;
-export declare function ordinalSceneNodeToSVG(node: OrdinalSceneNode, i: number): React.ReactNode;
+export declare function ordinalSceneNodeToSVG(node: OrdinalSceneNode, i: number, idPrefix?: string): React.ReactNode;
 export declare function geoSceneNodeToSVG(node: GeoSceneNode, i: number): React.ReactNode;
 /**
  * Returns true when running in a true server/Node.js context where

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

@@ -1,6 +1,6 @@
 import type { ReactNode } from "react";
 import type { GeoProjection, GeoPath, GeoPermissibleObjects } from "d3-geo";
-import type { GradientLegendConfig, LegendGroup } from "../types/legendTypes";
+import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
 import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, SceneDatum, PointSceneNode, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { HoverAnnotationConfig, HoverData } from "../realtime/types";
@@ -191,6 +191,7 @@ export interface StreamGeoFrameProps<T = Datum> {
         gradient: GradientLegendConfig;
     };
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;

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

@@ -19,6 +19,7 @@ export interface HoverPointerCoords {
     clientX: number;
     clientY: number;
 }
+export declare function normalizeHoverDatum(rawDatum: any): any;
 /**
  * Build a HoverData object from a raw datum and pixel coordinates.
  * The raw datum is preserved as `hover.data` for tooltip / callback

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

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+import type { LegendGroup, GradientLegendConfig, LegendLayout } from "../types/legendTypes";
 export interface LegendRenderConfig {
     legend: ReactNode | {
         legendGroups: LegendGroup[];
@@ -15,6 +15,7 @@ export interface LegendRenderConfig {
         left: number;
     };
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     title?: string | ReactNode;
     legendHoverBehavior?: (item: {
         label: string;

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

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { OnObservationCallback } from "../store/ObservationStore";
 import type { HoverData, AnnotationContext } from "../realtime/types";
-import type { LegendGroup } from "../types/legendTypes";
+import type { LegendGroup, LegendLayout } from "../types/legendTypes";
 import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors, SceneDatum } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { Datum } from "../charts/shared/datumTypes";
@@ -523,6 +523,7 @@ export interface StreamNetworkFrameProps<T = Datum> {
         legendGroups: LegendGroup[];
     };
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     legendHoverBehavior?: (item: {
         label: string;
     } | null) => void;

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

@@ -3,7 +3,7 @@ import type { ScaleLinear, ScaleBand } from "d3-scale";
 import type { WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../realtime/types";
 import type { Style, SceneDatum, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
-import type { LegendGroup } from "../types/legendTypes";
+import type { GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
 import type { Datum } from "../charts/shared/datumTypes";
 export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline" | "funnel" | "bar-funnel" | "swimlane" | "custom";
 export interface OrdinalScales {
@@ -37,6 +37,19 @@ export interface WedgeSceneNode {
         start?: boolean;
         end?: boolean;
     };
+    /** Render the wedge's interior as N equal angular slices, each filled
+     *  with the corresponding color from `colors`. The wedge's own shape
+     *  (incl. `cornerRadius` + `roundedEnds`) is used as a clip mask so
+     *  only the slice geometry shows through the rounded outline. Used by
+     *  GaugeChart's gradient-fill mode: the band reads as one continuous
+     *  rounded arc with a gradient sampled along its length, without any
+     *  individual slice (which would be far too narrow to host its own
+     *  rounded corners) needing to round. Slices are an internal
+     *  rendering detail — they do not appear as separate scene nodes,
+     *  participate in hit testing, or transition independently. */
+    _gradientBand?: {
+        colors: string[];
+    };
     style: Style;
     datum: SceneDatum;
     category?: string;
@@ -373,7 +386,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     } | {
-        gradient: import("../types/legendTypes").GradientLegendConfig;
+        gradient: GradientLegendConfig;
     };
     legendHoverBehavior?: (item: {
         label: string;
@@ -384,6 +397,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendPosition?: "right" | "left" | "top" | "bottom";
+    legendLayout?: LegendLayout;
     /** Accessor used to report the current legend category domain in push mode. */
     legendCategoryAccessor?: string | ((d: T) => string);
     /** Fires when the current legend category domain changes after scene rebuilds. */