semiotic 3.5.0 → 3.5.1

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {

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

@@ -92,6 +92,8 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -28,6 +28,8 @@ export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -36,6 +36,8 @@ export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -32,6 +32,8 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -72,6 +72,8 @@ export interface HistogramProps<TDatum extends Datum = Datum> extends BaseChartP
     };
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. Wins over Histogram's auto-computed shared bin extent — useful for pinning the axis to a known range so streamed updates don't shift the bins as min/max drift. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -87,6 +87,8 @@ export interface LikertChartProps<TDatum extends Datum = Datum> extends BaseChar
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. Likert is normally pinned to symmetric proportions; pass `valueExtent` to override. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export interface LikertChartHandle extends RealtimeFrameHandle {

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

@@ -29,6 +29,8 @@ export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseCh
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -33,6 +33,8 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
     annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. Stacked bars auto-extend the value domain to cover the cumulative stack unless `valueExtent` is fully specified. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -41,6 +41,8 @@ export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartP
     };
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -83,6 +83,8 @@ export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseCh
         color: string;
         opacity?: number;
     };
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     /** Pass-through props to StreamOrdinalFrame */
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }

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

@@ -40,6 +40,8 @@ export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChart
     };
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
+    /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
+    valueExtent?: [number | undefined, number | undefined] | [number];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 /**

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

@@ -40,4 +40,28 @@ export declare function buildDefaultRealtimeTooltip<TDatum extends Datum = Datum
  * scene builder).
  */
 export declare function buildWaterfallTooltip<TDatum extends Datum = Datum>(options?: DefaultRealtimeTooltipOptions<TDatum>): (d: HoverData) => ReactNode;
+/**
+ * Heatmap-specific default tooltip.
+ *
+ * The streaming heatmap aggregates raw points into 2D bins; each cell's
+ * datum is `{ xi, yi, value, count, sum, xCenter, yCenter, agg }`. The
+ * generic `x: <time>, y: <value>` shape is meaningless because the cell
+ * doesn't carry the user's original fields — it carries bin indices and
+ * aggregated counts.
+ *
+ * This tooltip surfaces the user-relevant info:
+ *   x:     <data-space x-center of the bin>
+ *   y:     <data-space y-center of the bin>
+ *   count: 12               (when datum.count is present — streaming path)
+ *   sum:   142              (when agg === "sum")
+ *   mean:  11.83            (when agg === "mean")
+ *
+ * For `agg === "sum"` we always surface the sum (it's the metric the
+ * heatmap is colored by, even when sum happens to equal count).
+ *
+ * Falls back to the canonical x/y shape if the enriched fields are
+ * absent (e.g. a non-streaming render path); the count/sum/mean rows
+ * only appear when the matching field is present on the datum.
+ */
+export declare function buildHeatmapTooltip<TDatum extends Datum = Datum>(options?: DefaultRealtimeTooltipOptions<TDatum>): (d: HoverData) => ReactNode;
 export {};

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

@@ -159,6 +159,20 @@ export interface AreaChartProps<TDatum extends Datum = Datum> extends BaseChartP
      * Annotation objects to render on the chart
      */
     annotations?: Datum[];
+    /**
+     * Fixed x domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived. Useful for pinning a time axis to a known
+     * window (e.g. last 24 hours) so streamed updates don't shift the
+     * left/right edges as data flows in.
+     */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /**
+     * Fixed y domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived. The fill baseline is the y-domain minimum, so
+     * setting `yExtent={[0, 100]}` anchors both the axis AND the area's
+     * baseline at 0 — the typical "percentage / counter" shape.
+     */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly

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

@@ -110,6 +110,10 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
      * Annotation objects to render on the chart
      */
     annotations?: Datum[];
+    /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly

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

@@ -19,6 +19,10 @@ export interface CandlestickChartProps<TDatum extends Datum = Datum> extends Bas
     candlestickStyle?: CandlestickStyle;
     tooltip?: TooltipProp;
     annotations?: Datum[];
+    /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    yExtent?: [number | undefined, number | undefined] | [number];
     enableHover?: boolean;
     showGrid?: boolean;
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;

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

@@ -37,6 +37,10 @@ export interface ConnectedScatterplotProps<TDatum extends Datum = Datum> extends
     legendInteraction?: LegendInteractionMode;
     /** Annotation objects to render on the chart */
     annotations?: Datum[];
+    /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /** Additional StreamXYFrame props for advanced customization */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }

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

@@ -114,6 +114,10 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
      * Annotation objects to render on the chart
      */
     annotations?: Datum[];
+    /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly

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

@@ -181,6 +181,18 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
      * envelope around the extrapolated forecast region.
      */
     forecast?: ForecastConfig;
+    /**
+     * Fixed x domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived.
+     */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /**
+     * Fixed y domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived. Wins over the auto-computed envelope extent
+     * when forecast bounds are present, so explicit user intent stays
+     * authoritative.
+     */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly

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

@@ -67,6 +67,13 @@ export interface MinimapChartProps<TDatum extends Datum = Datum> extends Omit<Ba
     onBrush?: (extent: [number, number] | null) => void;
     /** Controlled brush extent */
     brushExtent?: [number, number];
+    /**
+     * Fixed y domain `[min, max]` (either bound may be undefined to leave
+     * that side data-derived). xExtent is reserved for brush selection on
+     * MinimapChart — pass `frameProps.xExtent` if you need to override the
+     * brushed x range from advanced consumers.
+     */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /** Additional StreamXYFrame props */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }

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

@@ -45,6 +45,10 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
     legendPosition?: LegendPosition;
     /** Annotation objects to render on the chart */
     annotations?: Datum[];
+    /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /** Additional StreamXYFrame props for advanced customization */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }

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

@@ -159,6 +159,18 @@ export interface StackedAreaChartProps<TDatum extends Datum = Datum> extends Bas
      * Annotation objects to render on the chart
      */
     annotations?: Datum[];
+    /**
+     * Fixed x domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived.
+     */
+    xExtent?: [number | undefined, number | undefined] | [number];
+    /**
+     * Fixed y domain `[min, max]`. Either bound may be `undefined` to leave
+     * that side data-derived. Stacked areas auto-extend the y domain to
+     * cover the cumulative sum unless `yExtent` is fully specified —
+     * passing `yExtent={[0, 200]}` pins both bounds.
+     */
+    yExtent?: [number | undefined, number | undefined] | [number];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly