semiotic 3.2.1 → 3.2.3

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

@@ -54,7 +54,7 @@ export interface MarginalGraphicsConfig {
     left?: MarginalConfig | MarginalType;
     right?: MarginalConfig | MarginalType;
 }
-export type StreamChartType = "line" | "area" | "stackedarea" | "scatter" | "bubble" | "heatmap" | "bar" | "swarm" | "waterfall" | "candlestick";
+export type StreamChartType = "line" | "area" | "stackedarea" | "mixed" | "scatter" | "bubble" | "heatmap" | "bar" | "swarm" | "waterfall" | "candlestick";
 export type RuntimeMode = "bounded" | "streaming";
 export interface Style {
     stroke?: string;
@@ -86,6 +86,13 @@ export interface LineSceneNode {
     style: Style;
     datum: any;
     group?: string;
+    /** Horizontal gradient for the line stroke */
+    strokeGradient?: {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
     /** Curve interpolation type (default: linear / straight segments) */
     curve?: CurveType;
     /** Per-vertex decay opacities (oldest→newest = minOpacity→1.0). Set by PipelineStore.applyDecay. */
@@ -108,10 +115,22 @@ export interface AreaSceneNode {
     style: Style;
     datum: any;
     group?: string;
-    /** Vertical gradient fill: opacity fades from topOpacity at the line to bottomOpacity at the baseline */
+    /** Gradient fill: opacity-based (topOpacity/bottomOpacity) or multi-color (colorStops) */
     fillGradient?: {
         topOpacity: number;
         bottomOpacity: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
+    /** Horizontal gradient for the line stroke */
+    strokeGradient?: {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
     };
     /** When false, skip hit testing (used for decorative bounds areas) */
     interactive?: boolean;
@@ -226,6 +245,8 @@ export interface CandlestickSceneNode {
     wickColor: string;
     wickWidth: number;
     isUp: boolean;
+    /** Range/dumbbell mode — no body, endpoint dots instead */
+    isRange?: boolean;
     datum: any;
     /** Optional style object (used during transition opacity animations) */
     style?: Style;
@@ -245,6 +266,8 @@ export interface CandlestickStyle {
     wickColor?: string;
     bodyWidth?: number;
     wickWidth?: number;
+    /** Single color for range/dumbbell mode (replaces up/down when no open/close provided) */
+    rangeColor?: string;
 }
 export interface Changeset<T = Record<string, any>> {
     inserts: T[];
@@ -252,6 +275,11 @@ export interface Changeset<T = Record<string, any>> {
     /** Hint: total dataset size when progressively chunking bounded data */
     totalSize?: number;
 }
+/**
+ * Note: when xScaleType="time", the x scale is a d3.scaleTime at runtime
+ * (domain returns Date objects, ticks() returns Date[]). It is typed as
+ * ScaleLinear for compatibility — use valueOf() when comparing domain values.
+ */
 export interface StreamScales {
     x: ScaleLinear<number, number>;
     y: ScaleLinear<number, number>;
@@ -296,7 +324,21 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
     gradientFill?: boolean | {
         topOpacity: number;
         bottomOpacity: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
+    /** Horizontal gradient for line strokes. Applied to all lines/area top-strokes. */
+    lineGradient?: {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
     };
+    /** Series names (matching lineBy/colorBy group keys) that render as filled areas in "mixed" chartType */
+    areaGroups?: string[];
     /**
      * Style for bounds/uncertainty areas.
      * If omitted, defaults to the line color at 0.2 opacity.
@@ -313,11 +355,13 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
     windowMode?: WindowMode;
     windowSize?: number;
     timeAccessor?: string | ((d: T) => number);
-    xScaleType?: "linear" | "log";
+    xScaleType?: "linear" | "log" | "time";
     yScaleType?: "linear" | "log";
     xExtent?: [number | undefined, number | undefined] | [number];
     yExtent?: [number | undefined, number | undefined] | [number];
     extentPadding?: number;
+    /** Pixel inset on scale ranges to prevent glyph clipping at chart edges. Default 0. */
+    scalePadding?: number;
     sizeRange?: [number, number];
     size?: [number, number];
     /** Auto-match width to container. Requires a sized parent element. */
@@ -355,14 +399,19 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
     yLabel?: string;
     /** Label for the right Y axis (dual-axis charts) */
     yLabelRight?: string;
-    xFormat?: (d: any, index?: number, allTicks?: number[]) => string;
-    yFormat?: (d: any) => string;
+    xFormat?: (d: any, index?: number, allTicks?: number[]) => string | ReactNode;
+    yFormat?: (d: any) => string | ReactNode;
     tickFormatTime?: (value: number) => string;
     tickFormatValue?: (value: number) => string;
     hoverAnnotation?: boolean | HoverAnnotationConfig;
     tooltipContent?: (d: HoverData) => ReactNode;
     customHoverBehavior?: (d: HoverData | null) => void;
+    customClickBehavior?: (d: HoverData | null) => void;
     enableHover?: boolean;
+    /** Max pixel distance for hover/click hit testing. Default 30. */
+    hoverRadius?: number;
+    /** Tooltip mode: "single" (default) shows one datum, "multi" shows all series at the hovered X. */
+    tooltipMode?: "single" | "multi";
     /** Brush configuration — when provided, an SVG brush overlay is rendered */
     brush?: {
         /** Which dimension(s) to brush: "x", "y", or "xy" (default "xy") */

package/dist/components/stream/xySceneBuilders/mixedScene.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Mixed scene builder — renders some series as areas and others as lines.
+ *
+ * Used when LineChart.fillArea is a string[] of series names.
+ * Area groups get filled area rendering, the rest get line rendering.
+ *
+ * Dependencies: SceneGraph (buildLineNode, buildAreaNode)
+ * Consumed by: PipelineStore.buildSceneNodes (chartType "mixed")
+ */
+import type { SceneNode } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildMixedScene(ctx: XYSceneContext, data: Record<string, any>[]): SceneNode[];

package/dist/components/stream/xySceneBuilders/types.d.ts

@@ -48,6 +48,18 @@ export interface XYSceneConfig {
     gradientFill?: boolean | {
         topOpacity?: number;
         bottomOpacity?: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
+    areaGroups?: Set<string>;
+    lineGradient?: {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
     };
     annotations?: Record<string, any>[];
     pointStyle?: (d: any) => Style & {
@@ -86,7 +98,10 @@ export interface XYSceneConfig {
         wickColor?: string;
         wickWidth?: number;
         bodyWidth?: number;
+        rangeColor?: string;
     };
+    /** True when candlestick is in range/dumbbell mode (no open/close accessors provided) */
+    candlestickRangeMode?: boolean;
     boundsStyle?: Style | ((d: any, group: string) => Style);
     lineStyle?: Style | ((d: any, group: string) => Style);
     areaStyle?: (d: any) => Style;