semiotic 3.2.3 → 3.3.0

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

@@ -35,6 +35,9 @@ export interface RealtimeNode {
     createdByFrame?: boolean;
     sourceLinks?: RealtimeEdge[];
     targetLinks?: RealtimeEdge[];
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
 }
 export interface RealtimeEdge {
     source: RealtimeNode | string;
@@ -56,6 +59,12 @@ export interface RealtimeEdge {
     data?: Record<string, any>;
     /** Unique key for this edge (supports parallel edges between same node pair) */
     _edgeKey?: string;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
+    /** @internal Circular sankey layout fields */
+    _circularWidth?: number;
+    _circularStub?: boolean;
 }
 export interface BezierPoint {
     x: number;
@@ -171,6 +180,9 @@ export interface NetworkArcNode {
     datum: any;
     id?: string;
     label?: string;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
 }
 /** Line edge — used by force */
 export interface NetworkLineEdge {
@@ -200,6 +212,8 @@ export interface NetworkRibbonEdge {
     pathD: string;
     style: Style;
     datum: any;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
 }
 /** Curved edge — used by tree, cluster */
 export interface NetworkCurvedEdge {
@@ -207,6 +221,8 @@ export interface NetworkCurvedEdge {
     pathD: string;
     style: Style;
     datum: any;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
 }
 export type NetworkSceneNode = NetworkCircleNode | NetworkRectNode | NetworkArcNode;
 export type NetworkSceneEdge = NetworkLineEdge | NetworkBezierEdge | NetworkRibbonEdge | NetworkCurvedEdge;
@@ -333,6 +349,15 @@ export interface NetworkPipelineConfig {
     orbitShowRings?: boolean;
     /** Enable orbit animation. @default true */
     orbitAnimated?: boolean;
+    /** @internal Hierarchy root stashed for tree/treemap/circlepack plugins */
+    __hierarchyRoot?: unknown;
+    /** @internal Orbit animation state preserved across config updates */
+    __orbitState?: unknown;
+    /** @internal Previous node positions for warm-start force layout */
+    __previousPositions?: Map<string, {
+        x: number;
+        y: number;
+    }>;
 }
 export interface StreamNetworkFrameProps<T = Record<string, any>> {
     chartType: NetworkChartType;
@@ -450,6 +475,14 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
 export interface StreamNetworkFrameHandle {
     push(edge: EdgePush): void;
     pushMany(edges: EdgePush[]): void;
+    /** Remove a node by ID. Also removes connected edges. */
+    removeNode(id: string): boolean;
+    /** Remove all edges between source and target node IDs. */
+    removeEdge(sourceId: string, targetId: string): boolean;
+    /** Update a node's data by ID. Returns previous data. */
+    updateNode(id: string, updater: (data: Record<string, any>) => Record<string, any>): Record<string, any> | null;
+    /** Update all edges between source+target. Returns array of previous data. */
+    updateEdge(sourceId: string, targetId: string, updater: (data: Record<string, any>) => Record<string, any>): Record<string, any>[];
     clear(): void;
     getTopology(): {
         nodes: RealtimeNode[];

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

@@ -20,12 +20,11 @@ export interface WedgeSceneNode {
     style: Style;
     datum: any;
     category?: string;
-    /** Pulse intensity 0–1 (set when aggregated category value changes) */
     _pulseIntensity?: number;
-    /** Pulse color */
     _pulseColor?: string;
-    /** Animation target opacity (set during enter/exit transitions) */
+    _pulseGlowRadius?: number;
     _targetOpacity?: number;
+    _transitionKey?: string;
 }
 export interface BoxplotSceneNode {
     type: "boxplot";
@@ -51,7 +50,11 @@ export interface BoxplotSceneNode {
         value: number;
         datum: any;
     }[];
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
     _targetOpacity?: number;
+    _transitionKey?: string;
 }
 export interface DistributionStats {
     n: number;
@@ -89,7 +92,11 @@ export interface ViolinSceneNode {
     style: Style;
     datum: any;
     category?: string;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
     _targetOpacity?: number;
+    _transitionKey?: string;
 }
 export interface ConnectorSceneNode {
     type: "connector";
@@ -100,7 +107,11 @@ export interface ConnectorSceneNode {
     style: Style;
     datum: any;
     group?: string;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
     _targetOpacity?: number;
+    _transitionKey?: string;
 }
 export interface TrapezoidSceneNode {
     type: "trapezoid";
@@ -109,7 +120,11 @@ export interface TrapezoidSceneNode {
     style: Style;
     datum: any;
     category?: string;
+    _pulseIntensity?: number;
+    _pulseColor?: string;
+    _pulseGlowRadius?: number;
     _targetOpacity?: number;
+    _transitionKey?: string;
 }
 export type { Style, PointSceneNode, RectSceneNode } from "./types";
 import type { PointSceneNode, RectSceneNode } from "./types";
@@ -167,6 +182,8 @@ export interface OrdinalPipelineConfig {
     summaryStyle?: (d: any, category?: string) => Style;
     colorScheme?: string | string[];
     barColors?: Record<string, string>;
+    /** ID accessor for remove() — extracts a unique identifier from each datum */
+    dataIdAccessor?: string | ((d: any) => string);
     decay?: DecayConfig;
     pulse?: PulseConfig;
     transition?: TransitionConfig;
@@ -217,6 +234,12 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     windowSize?: number;
     connectorAccessor?: string | ((d: T) => string);
     connectorStyle?: Style | ((d: any) => Style);
+    /** ID accessor for remove()/update() — extracts a unique identifier from each datum */
+    dataIdAccessor?: string | ((d: any) => string);
+    /** Custom tick values for the value (r) axis. Overrides the default d3 ticks. */
+    rTickValues?: number[];
+    /** Align first tick label to start and last tick label to end. Default false. */
+    tickLabelEdgeAlign?: boolean;
     pieceStyle?: (d: any, category?: string) => Style;
     summaryStyle?: (d: any, category?: string) => Style;
     colorScheme?: string | string[];
@@ -276,6 +299,10 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
 export interface StreamOrdinalFrameHandle<T = Record<string, any>> {
     push(datum: T): void;
     pushMany(data: T[]): void;
+    /** Remove data items by ID. Requires dataIdAccessor. */
+    remove(id: string | string[]): T[];
+    /** Update data items by ID in place. Requires dataIdAccessor. Returns previous values. */
+    update(id: string | string[], updater: (d: T) => T): T[];
     clear(): void;
     getData(): T[];
     getScales(): OrdinalScales | null;

package/dist/components/stream/renderers/resolveCSSColor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve a CSS custom property value to a concrete color string.
+ *
+ * If the input is a `var(--name)` or `var(--name, fallback)` string,
+ * reads the computed value from the canvas element. Otherwise returns
+ * the input unchanged.
+ *
+ * Per-canvas cache avoids repeated getComputedStyle calls within a single
+ * paint cycle. The cache is cleared on theme changes via clearCSSColorCache(),
+ * which each Stream Frame calls in its theme-change useEffect.
+ */
+export declare function resolveCSSColor(ctx: CanvasRenderingContext2D, value: string | undefined): string | undefined;
+/**
+ * Clear the per-canvas CSS variable cache. Called by Stream Frames
+ * when the theme changes so the next paint reads fresh computed values.
+ */
+export declare function clearCSSColorCache(canvas: HTMLCanvasElement): void;

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

@@ -491,6 +491,10 @@ export interface StreamXYFrameProps<T = Record<string, any>> {
 export interface StreamXYFrameHandle<T = Record<string, any>> {
     push(datum: T): void;
     pushMany(data: T[]): void;
+    /** Remove data points by ID. Requires pointIdAccessor. */
+    remove(id: string | string[]): T[];
+    /** Update data points by ID in place. Requires pointIdAccessor. Returns previous values. */
+    update(id: string | string[], updater: (d: T) => T): T[];
     clear(): void;
     getData(): T[];
     getScales(): StreamScales | null;