semiotic 3.2.0 → 3.2.1

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

@@ -0,0 +1,10 @@
+/**
+ * Candlestick (OHLC) scene builder.
+ *
+ * Renders open-high-low-close bars with auto-width sizing based on data spacing.
+ *
+ * Consumed by: PipelineStore.buildSceneNodes (chartType "candlestick")
+ */
+import type { SceneNode, StreamLayout } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildCandlestickScene(ctx: XYSceneContext, data: Record<string, any>[], layout: StreamLayout): SceneNode[];

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

@@ -0,0 +1,13 @@
+/**
+ * Shared helper for emitting PointSceneNodes from grouped data.
+ *
+ * Used by line, area, and stacked area scene builders when the HOC's
+ * `showPoints` prop is active (i.e., `ctx.config.pointStyle` is set).
+ * Handles group color fallback for push API mode and pointId passthrough.
+ */
+import type { SceneNode } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function emitPointNodes(ctx: XYSceneContext, groups: {
+    key: string;
+    data: Record<string, any>[];
+}[], nodes: SceneNode[], yGetOverride?: (d: Record<string, any>) => number): void;

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

@@ -0,0 +1,3 @@
+import type { SceneNode, StreamLayout } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildHeatmapScene(ctx: XYSceneContext, data: Record<string, any>[], layout: StreamLayout): SceneNode[];

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

@@ -0,0 +1,12 @@
+/**
+ * Line scene builder — produces LineSceneNode[] from grouped data.
+ *
+ * Handles: color thresholds from annotations, bounds/envelope areas,
+ * and curve type attachment for canvas interpolation.
+ *
+ * Dependencies: SceneGraph (buildLineNode), boundsScene (buildBoundsForGroup)
+ * Consumed by: PipelineStore.buildSceneNodes (chartType "line")
+ */
+import type { SceneNode } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildLineScene(ctx: XYSceneContext, data: Record<string, any>[]): SceneNode[];

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

@@ -0,0 +1,12 @@
+/**
+ * Point/scatter/bubble scene builder.
+ *
+ * Handles: size scaling from sizeAccessor, color mapping from colorAccessor,
+ * and pointId attachment for hit testing.
+ *
+ * Dependencies: SceneGraph (buildPointNode)
+ * Consumed by: PipelineStore.buildSceneNodes (chartTypes "scatter", "bubble")
+ */
+import type { SceneNode } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildPointScene(ctx: XYSceneContext, data: Record<string, any>[]): SceneNode[];

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

@@ -0,0 +1,10 @@
+/**
+ * Realtime swarm chart scene builder.
+ *
+ * Simple point scatter with category-based coloring from barColors config.
+ *
+ * Consumed by: PipelineStore.buildSceneNodes (chartType "swarm")
+ */
+import type { SceneNode } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildSwarmScene(ctx: XYSceneContext, data: Record<string, any>[]): SceneNode[];

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

@@ -0,0 +1,93 @@
+/**
+ * XYSceneContext — shared context passed to all XY scene builder functions.
+ *
+ * Mirrors the ordinal pattern (OrdinalSceneContext in ordinalSceneBuilders/).
+ * Scene builders are pure functions that receive this context instead of
+ * accessing PipelineStore instance fields directly.
+ */
+import type { StreamScales, Style, CurveType } from "../types";
+export interface XYSceneContext {
+    scales: StreamScales;
+    config: XYSceneConfig;
+    getX: (d: any) => number;
+    getY: (d: any) => number;
+    getY0?: (d: any) => number | null;
+    getSize?: (d: any) => number;
+    getColor?: (d: any) => string;
+    getGroup?: (d: any) => string;
+    getCategory?: (d: any) => string;
+    getPointId?: (d: any) => string;
+    getBounds?: (d: any) => number | null;
+    getOpen?: (d: any) => number;
+    getHigh?: (d: any) => number;
+    getLow?: (d: any) => number;
+    getClose?: (d: any) => number;
+    /** Style resolvers — delegate to PipelineStore's cached color management */
+    resolveLineStyle: (group: string, sampleDatum?: Record<string, any>) => Style;
+    resolveAreaStyle: (group: string, sampleDatum?: Record<string, any>) => Style;
+    resolveBoundsStyle: (group: string, sampleDatum?: Record<string, any>) => Style;
+    resolveColorMap: (data: Record<string, any>[]) => Map<string, string>;
+    resolveGroupColor: (group: string) => string | null;
+    /** Group data by lineBy/colorBy accessor */
+    groupData: (data: Record<string, any>[]) => {
+        key: string;
+        data: Record<string, any>[];
+    }[];
+    /** Instance-scoped mutable cache for bar category ordering (prevents cross-instance leaks) */
+    barCategoryCache?: {
+        key: string;
+        order: string[];
+    } | null;
+}
+/** Subset of PipelineConfig fields that scene builders need */
+export interface XYSceneConfig {
+    chartType: string;
+    curve?: CurveType;
+    colorScheme?: string | string[];
+    normalize?: boolean;
+    gradientFill?: boolean | {
+        topOpacity?: number;
+        bottomOpacity?: number;
+    };
+    annotations?: Record<string, any>[];
+    pointStyle?: (d: any) => Style & {
+        r?: number;
+    };
+    sizeRange?: [number, number];
+    xAccessor?: string | ((d: any) => any);
+    yAccessor?: string | ((d: any) => any);
+    valueAccessor?: string | ((d: any) => any);
+    heatmapAggregation?: "count" | "sum" | "mean";
+    heatmapXBins?: number;
+    heatmapYBins?: number;
+    showValues?: boolean;
+    heatmapValueFormat?: (v: number) => string;
+    binSize?: number;
+    barColors?: Record<string, string>;
+    swarmStyle?: {
+        radius?: number;
+        fill?: string;
+        opacity?: number;
+        stroke?: string;
+        strokeWidth?: number;
+    };
+    waterfallStyle?: {
+        positiveColor?: string;
+        negativeColor?: string;
+        gap?: number;
+        stroke?: string;
+        strokeWidth?: number;
+        connectorStroke?: string;
+        connectorWidth?: number;
+    };
+    candlestickStyle?: {
+        upColor?: string;
+        downColor?: string;
+        wickColor?: string;
+        wickWidth?: number;
+        bodyWidth?: number;
+    };
+    boundsStyle?: Style | ((d: any, group: string) => Style);
+    lineStyle?: Style | ((d: any, group: string) => Style);
+    areaStyle?: (d: any) => Style;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Waterfall chart scene builder.
+ *
+ * Builds cumulative delta bars from time-series data. Each bar's base starts
+ * where the previous bar ended. Positive/negative deltas get distinct colors.
+ *
+ * Dependencies: SceneGraph (buildRectNode)
+ * Consumed by: PipelineStore.buildSceneNodes (chartType "waterfall")
+ */
+import type { SceneNode, StreamLayout } from "../types";
+import type { XYSceneContext } from "./types";
+export declare function buildWaterfallScene(ctx: XYSceneContext, data: Record<string, any>[], layout: StreamLayout): SceneNode[];