semiotic 3.7.4 → 3.8.0

package/dist/components/charts/custom/NetworkCustomChart.d.ts

@@ -3,7 +3,8 @@ import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { NetworkCustomLayout } from "../../stream/networkCustomLayout";
 import type { Datum } from "../shared/datumTypes";
-import type { BaseChartProps } from "../shared/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import type { ChartRecipe } from "../../ai/chartRecipes";
 export interface NetworkCustomChartProps<TNode extends Datum = Datum, TEdge extends Datum = Datum, TConfig extends object = Record<string, unknown>> extends BaseChartProps {
     /** Node objects with at least an `id` field. Positions are typically pre-computed by the user (e.g. from dagre / d3-flextree) and read by the layout. */
     nodes?: TNode[];
@@ -13,6 +14,10 @@ export interface NetworkCustomChartProps<TNode extends Datum = Datum, TEdge exte
     layout: NetworkCustomLayout<TConfig>;
     /** Config blob threaded through to NetworkLayoutContext.config. */
     layoutConfig?: TConfig;
+    /** Receives a structured diagnostic if the layout throws. */
+    onLayoutError?: StreamNetworkFrameProps["onLayoutError"];
+    recipe?: ChartRecipe<TNode, TConfig>;
+    recipeId?: string;
     /** Field name (or function) for the node id. @default "id" */
     nodeIDAccessor?: StreamNetworkFrameProps["nodeIDAccessor"];
     /** Field name for the edge source id. @default "source" */
@@ -20,13 +25,27 @@ export interface NetworkCustomChartProps<TNode extends Datum = Datum, TEdge exte
     /** Field name for the edge target id. @default "target" */
     targetAccessor?: StreamNetworkFrameProps["targetAccessor"];
     /** Color scheme threaded into the layout's `resolveColor` helper. */
-    colorScheme?: string | string[];
+    colorBy?: ChartAccessor<TNode, string | number>;
+    colorScheme?: string | string[] | Record<string, string>;
     enableHover?: boolean;
+    /**
+     * Annotations rendered over the chart. A custom network layout's marks are
+     * anchorable by id: emit a scene node with `id: <foo>` and an annotation with
+     * `pointId: "<foo>"` resolves to that mark's center (the editorial-callout
+     * story, now unified with the built-in network charts). Data-coordinate
+     * anchoring doesn't apply — custom layouts own their own geometry — so anchor
+     * by `pointId`, or draw bespoke callouts with the recipe chrome kit's
+     * `markCallout`.
+     */
+    annotations?: StreamNetworkFrameProps["annotations"];
+    /** Collision-avoiding auto-placement for the annotations above. */
+    autoPlaceAnnotations?: StreamNetworkFrameProps["autoPlaceAnnotations"];
     /**
      * Custom layouts own their own color resolution (the layout function
      * decides what each node looks like), so the auto-legend infrastructure
      * the built-in network HOCs use can't run. To render a legend, build a
-     * `legendGroups` array yourself and pass it through `frameProps.legend`.
+     * `legendGroups` array yourself (see `legendGroupsFrom`) and pass it through
+     * `frameProps.legend`.
      */
     /** Additional StreamNetworkFrame props for advanced customization. */
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "nodes" | "edges" | "chartType" | "size" | "customNetworkLayout" | "layoutConfig" | "layoutSelection">>;

package/dist/components/charts/custom/OrdinalCustomChart.d.ts

@@ -3,7 +3,8 @@ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { OrdinalCustomLayout } from "../../stream/ordinalCustomLayout";
 import type { Datum } from "../shared/datumTypes";
-import type { BaseChartProps } from "../shared/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import type { ChartRecipe } from "../../ai/chartRecipes";
 export interface OrdinalCustomChartProps<TDatum extends Datum = Datum, TConfig extends object = Record<string, unknown>> extends BaseChartProps {
     /** Data passed through to OrdinalLayoutContext.data. */
     data?: TDatum[];
@@ -11,6 +12,10 @@ export interface OrdinalCustomChartProps<TDatum extends Datum = Datum, TConfig e
     layout: OrdinalCustomLayout<TConfig>;
     /** Config blob threaded through to OrdinalLayoutContext.config. */
     layoutConfig?: TConfig;
+    /** Receives a structured diagnostic if the layout throws. */
+    onLayoutError?: StreamOrdinalFrameProps["onLayoutError"];
+    recipe?: ChartRecipe<TDatum, TConfig>;
+    recipeId?: string;
     /** Field name (or function) for the category. The frame builds the o-scale from these. */
     categoryAccessor?: StreamOrdinalFrameProps["categoryAccessor"];
     /** Field name (or function) for the value. The frame builds the r-scale from these. */
@@ -25,7 +30,8 @@ export interface OrdinalCustomChartProps<TDatum extends Datum = Datum, TConfig e
     /** Vertical / horizontal / radial. Default vertical. */
     projection?: StreamOrdinalFrameProps["projection"];
     /** Color scheme threaded into the layout's `resolveColor` helper. */
-    colorScheme?: string | string[];
+    colorBy?: ChartAccessor<TDatum, string>;
+    colorScheme?: string | string[] | Record<string, string>;
     enableHover?: boolean;
     showAxes?: boolean;
     showGrid?: boolean;

package/dist/components/charts/custom/XYCustomChart.d.ts

@@ -3,8 +3,9 @@ import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { CustomLayout } from "../../stream/customLayout";
 import type { Datum } from "../shared/datumTypes";
-import type { BaseChartProps, AxisConfig } from "../shared/types";
+import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import type { TooltipProp } from "../../Tooltip/Tooltip";
+import type { ChartRecipe } from "../../ai/chartRecipes";
 export interface XYCustomChartProps<TDatum extends Datum = Datum, TConfig extends object = Record<string, unknown>> extends BaseChartProps, AxisConfig {
     /** Data passed through to LayoutContext.data. */
     data?: TDatum[];
@@ -12,6 +13,12 @@ export interface XYCustomChartProps<TDatum extends Datum = Datum, TConfig extend
     layout: CustomLayout<TConfig>;
     /** Config blob threaded through to LayoutContext.config. */
     layoutConfig?: TConfig;
+    /** Receives a structured diagnostic if the layout throws. */
+    onLayoutError?: StreamXYFrameProps["onLayoutError"];
+    /** Optional meaning/intelligence contract for description, navigation, and audit surfaces. */
+    recipe?: ChartRecipe<TDatum, TConfig>;
+    /** Registered recipe id; portable alternative to embedding the manifest object. */
+    recipeId?: string;
     /**
      * Optional fixed extents — flow into scale construction *before* the layout
      * runs, so scales reflect the layout's intended domain. Layouts that don't
@@ -25,7 +32,9 @@ export interface XYCustomChartProps<TDatum extends Datum = Datum, TConfig extend
     enableHover?: boolean;
     showLegend?: boolean;
     annotations?: Datum[];
-    colorScheme?: string | string[];
+    /** Field or function that declares the semantic category used for custom-layout color. */
+    colorBy?: ChartAccessor<TDatum, string>;
+    colorScheme?: string | string[] | Record<string, string>;
     tooltip?: TooltipProp;
     /** Additional StreamXYFrame props for advanced customization, excluding XYCustomChart-controlled fields. */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size" | "customLayout" | "layoutConfig">>;

package/dist/components/charts/geo/DistanceCartogram.d.ts

@@ -37,7 +37,7 @@ export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends Ba
     /** Field to determine point color */
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme @default "category10" */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Point radius @default 5 */
     pointRadius?: number;
     /** Tooltip */

package/dist/components/charts/geo/FlowMap.d.ts

@@ -47,7 +47,7 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
     /** Line cap style for flow edges @default "round" */
     edgeLinecap?: "butt" | "round" | "square";
     /** Color scheme for edges @default "category10" */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Show animated particles along flow lines */
     showParticles?: boolean;
     /** Particle appearance and behavior */

package/dist/components/charts/geo/ProportionalSymbolMap.d.ts

@@ -21,7 +21,7 @@ export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extend
     /** Field to determine point color */
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme @default "category10" */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Geographic projection @default "equalEarth" */
     projection?: ProjectionProp;
     /** Show graticule grid lines */

package/dist/components/charts/geo/index.d.ts

@@ -6,3 +6,5 @@ export { FlowMap } from "./FlowMap";
 export type { FlowMapProps } from "./FlowMap";
 export { DistanceCartogram } from "./DistanceCartogram";
 export type { DistanceCartogramProps } from "./DistanceCartogram";
+export { GeoCustomChart } from "../custom/GeoCustomChart";
+export type { GeoCustomChartProps } from "../custom/GeoCustomChart";

package/dist/components/charts/index.d.ts

@@ -96,7 +96,35 @@ export { RealtimeWaterfallChart } from "./realtime/RealtimeWaterfallChart";
 export type { RealtimeWaterfallChartProps } from "./realtime/RealtimeWaterfallChart";
 export { RealtimeHeatmap } from "./realtime/RealtimeHeatmap";
 export type { RealtimeHeatmapProps } from "./realtime/RealtimeHeatmap";
-export type { BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./shared/types";
+export { GaltonBoardChart } from "./physics/GaltonBoardChart";
+export type { GaltonBoardChartProps, GaltonBoardReferenceLine } from "./physics/GaltonBoardChart";
+export { EventDropChart } from "./physics/EventDropChart";
+export type { EventDropChartProps } from "./physics/EventDropChart";
+export { PhysicsPileChart } from "./physics/PhysicsPileChart";
+export type { PhysicsPileChartProps } from "./physics/PhysicsPileChart";
+export { CollisionSwarmChart } from "./physics/CollisionSwarmChart";
+export type { CollisionSwarmChartProps } from "./physics/CollisionSwarmChart";
+export { GauntletChart, GuantletChart, planGauntletPropertyWork, replaceGauntletNegative } from "./physics/GauntletChart";
+export type { GauntletChartProps, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectState, GauntletPropertyForceContext, GauntletPropertyDefinition, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions } from "./physics/GauntletChart";
+export { physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems } from "./physics/physicsProcessPrimitives";
+export type { PhysicsProcessBodyGroup, PhysicsProcessBoundaryOptions, PhysicsProcessStage } from "./physics/physicsProcessPrimitives";
+export { absorbRegion, bodyGroupSpec, capacitatedRegion, chargeGateRegion, forceFieldRegion, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processStageLayout, processStageRegions, routeSurfaceRegion, stageTargetInVolume } from "../recipes/processPhysics";
+export { aggregateRegionCounts, groupCompletionRows, regionCountsToProjectionRows } from "../recipes/processAggregates";
+export { processVolumePolygons } from "../recipes/processVolumeGeometry";
+export { createProcessJourneyLedger, processJourneyRows, updateProcessJourney } from "../recipes/processJourney";
+export type { BodyGroupSpec, BodyGroupSpecOptions, ProcessMembraneDef, ProcessRegionBaseOptions, ProcessStageRegionOptions, ProcessStageDef, ProcessVolumeLayout, ProcessVolumeLayoutOptions, ProcessVolumeMembraneBand, ProcessVolumeShape, ProcessVolumeStageBand } from "../recipes/processPhysics";
+export type { RegionCountBucket, RegionCountMap } from "../recipes/processAggregates";
+export type { ProcessVolumePoint, ProcessVolumePolygon, ProcessVolumePolygonRole } from "../recipes/processVolumeGeometry";
+export type { ProcessJourneyEntityState, ProcessJourneyLedger, ProcessJourneyRow, ProcessJourneyStage, ProcessJourneyUpdateOptions } from "../recipes/processJourney";
+export { PhysicalFlowChart } from "./physics/PhysicalFlowChart";
+export type { PhysicalFlowChartProps } from "./physics/PhysicalFlowChart";
+export { ProcessFlowChart } from "./physics/ProcessFlowChart";
+export type { ProcessFlowChartProps, ProcessFlowProjectionMetadata, ProcessFlowStageDef } from "./physics/ProcessFlowChart";
+export { PhysicsCustomChart } from "./physics/PhysicsCustomChart";
+export type { PhysicsCustomChartProps, PhysicsCustomLayout, PhysicsCustomLayoutContext, PhysicsCustomLayoutResult, PhysicsCustomSpawnDatumResult } from "./physics/PhysicsCustomChart";
+export type { BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode, MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, MobileStandardControlsMode, ResolvedMobileInteractionConfig, } from "./shared/types";
+export { responsiveRuleMatches, resolveResponsiveRules } from "./shared/responsiveRules";
+export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./shared/responsiveRules";
 export { useColorScale, useSortedData, DEFAULT_COLOR } from "./shared/hooks";
 export { COLOR_SCHEMES, DEFAULT_COLORS, getColor, createColorScale, getSize } from "./shared/colorUtils";
 export { formatNumber, formatDate, formatAxis, createTooltip, formatLargeNumber, truncateText, adaptiveTimeTicks } from "./shared/formatUtils";

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

@@ -16,7 +16,7 @@ export interface ChordDiagramProps<TNode extends Datum = Datum, TEdge extends Da
     valueAccessor?: ChartAccessor<TEdge, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     edgeColorBy?: "source" | "target" | ((d: Datum) => string);
     padAngle?: number;
     groupWidth?: number;

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

@@ -13,7 +13,7 @@ export interface CirclePackProps<TNode extends Datum = Datum> extends BaseChartP
     valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     colorByDepth?: boolean;
     showLabels?: boolean;
     nodeLabel?: ChartAccessor<TNode, string>;

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

@@ -67,7 +67,7 @@ export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge exte
      */
     colorBy?: ChartAccessor<TNode, string>;
     /** d3 scheme name or explicit color array; falls back to theme. */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /**
      * Constant pixel radius, or a function/field returning a numeric value
      * scaled into `nodeSizeRange`.
@@ -93,11 +93,21 @@ export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge exte
      */
     iterations?: number;
     /**
-     * Magnitude of the repulsion force between nodes; higher values spread
-     * the graph more.
+     * Link-attraction multiplier. Lower values produce a looser, more
+     * spread-out graph; higher values pull connected nodes together.
      * @default 0.1
      */
     forceStrength?: number;
+    /**
+     * Execute layout synchronously, in a Web Worker, or automatically choose
+     * based on estimated graph cost.
+     * @default "auto"
+     */
+    layoutExecution?: "auto" | "worker" | "sync";
+    /** Content rendered in the chart slot while worker layout is pending. */
+    layoutLoadingContent?: React.ReactNode | false;
+    /** Called when internally-managed worker layout changes state. */
+    onLayoutStateChange?: (state: "pending" | "ready" | "error") => void;
     /**
      * Render labels next to nodes. Uses `nodeLabel` accessor (defaulting to
      * `nodeIdAccessor`).
@@ -113,8 +123,8 @@ export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge exte
 /**
  * ForceDirectedGraph - Visualize network relationships with a force-directed layout.
  *
- * Nodes are positioned by simulating attraction along edges and repulsion
- * between unconnected nodes; the layout settles after `iterations` ticks.
+ * Nodes are positioned by simulating degree-aware attraction and repulsion
+ * with radius-aware collision; the layout settles after `iterations` ticks.
  * Wraps {@link StreamNetworkFrame} (canvas-first rendering for large graphs).
  *
  * For ordered hierarchical data prefer {@link TreeDiagram}; for flow

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

@@ -25,7 +25,7 @@ export interface OrbitDiagramProps<TDatum extends Datum = Datum> extends BaseCha
     /** Field or function for node color */
     colorBy?: string | ((d: Datum) => string);
     /** Color scheme @default "category10" */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Color by hierarchy depth instead of field @default false */
     colorByDepth?: boolean;
     /**

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

@@ -48,7 +48,7 @@ export interface ProcessSankeyProps<TNode extends Datum = Datum, TEdge extends D
     xExtentAccessor?: ChartAccessor<TNode, [TimeLike, TimeLike]>;
     edgeIdAccessor?: ChartAccessor<TEdge, string>;
     colorBy?: ChartAccessor<TNode, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
     showLegend?: boolean;
     /** Legend position. Default `"right"`. */

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

@@ -16,7 +16,7 @@ export interface SankeyDiagramProps<TNode extends Datum = Datum, TEdge extends D
     valueAccessor?: ChartAccessor<TEdge, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
     orientation?: "horizontal" | "vertical";
     nodeAlign?: "justify" | "left" | "right" | "center";

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

@@ -15,7 +15,7 @@ export interface TreeDiagramProps<TNode extends Datum = Datum> extends BaseChart
     valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     colorByDepth?: boolean;
     edgeStyle?: "line" | "curve";
     nodeLabel?: ChartAccessor<TNode, string>;

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

@@ -13,7 +13,7 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
     valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     colorByDepth?: boolean;
     showLabels?: boolean;
     labelMode?: "leaf" | "parent" | "all";

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

@@ -0,0 +1,17 @@
+import { type ForceLayoutAsyncOptions } from "../../recipes/forceLayoutAsync";
+import type { GraphEdge, GraphNode, Point } from "../../recipes/networkAnalysis";
+export type ForceLayoutStatus = "pending" | "ready" | "error";
+export interface UseForceLayoutResult {
+    positions: Record<string, Point> | null;
+    status: ForceLayoutStatus;
+    error: Error | null;
+}
+/**
+ * React lifecycle wrapper for deterministic force layout. Direct SSR and the
+ * first hydration render stay synchronous so markup matches; client-side mounts
+ * and subsequent graph changes use {@link forceLayoutAsync}. Settled positions
+ * are memoized by node/edge array identity + options, so remounting with the
+ * same module-constant graph resolves "ready" immediately instead of
+ * re-flashing a pending state.
+ */
+export declare function useForceLayout(nodes: ReadonlyArray<GraphNode>, edges: ReadonlyArray<GraphEdge>, options?: Omit<ForceLayoutAsyncOptions, "signal">): UseForceLayoutResult;

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

@@ -51,7 +51,7 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
      * `"set2"`, etc.) or an explicit array of colors. Falls back to the
      * theme's categorical palette when omitted.
      */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Category ordering. `false` (default) = insertion order. `"asc"` /
      *  `"desc"` sorts by total value. `"auto"` preserves insertion order
      *  while streaming and falls through to value-desc on static data.

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

@@ -14,7 +14,7 @@ export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     showOutliers?: boolean;
     outlierRadius?: number;
     categoryPadding?: number;

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

@@ -12,7 +12,7 @@ export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChart
     innerRadius?: number;
     centerContent?: React.ReactNode;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     startAngle?: number;
     /** Rounded corner radius on wedge arcs */
     cornerRadius?: number;

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

@@ -15,7 +15,7 @@ export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Category ordering. Default (`undefined`) resolves to `"auto"`, which
      *  preserves insertion order while streaming and falls through to
      *  value-desc on static data — the recommended choice when using the

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

@@ -17,7 +17,7 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
     /** Accessor for splitting into mirrored categories (e.g., "control" vs "treatment") */
     categoryAccessor?: ChartAccessor<TDatum, string>;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /**
      * Funnel orientation.
      *

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

@@ -15,7 +15,7 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Category sort order. Default: `false` (data insertion order). `"asc"`/`"desc"` sorts by total grouped value. `"auto"` preserves insertion order while streaming and falls through to value-desc on static data. Custom comparators receive category keys. */
     sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
     barPadding?: number;

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

@@ -51,7 +51,7 @@ export interface HistogramProps<TDatum extends Datum = Datum> extends BaseChartP
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     categoryPadding?: number;
     enableHover?: boolean;
     showGrid?: boolean;

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

@@ -41,7 +41,7 @@ export interface PieChartProps<TDatum extends Datum = Datum> extends BaseChartPr
      * `"set2"`, etc.) or an explicit array of colors. Falls back to the
      * theme's categorical palette when omitted.
      */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /**
      * Rotation in **degrees** applied to the first wedge. `0` starts at 12
      * o'clock and proceeds clockwise; `90` starts at 3 o'clock, `180` at 6

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

@@ -17,7 +17,7 @@ export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseCh
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     categoryPadding?: number;
     enableHover?: boolean;
     showGrid?: boolean;

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

@@ -15,7 +15,7 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     normalize?: boolean;
     /** Category sort order. Default: `false` (data insertion order). `"asc"`/`"desc"` sorts by total stacked value. `"auto"` preserves insertion order while streaming and falls through to value-desc on static data. Custom comparators receive category keys. */
     sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);

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

@@ -1,6 +1,7 @@
 import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { SymbolName } from "../../stream/symbolPath";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -14,9 +15,15 @@ export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartP
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     sizeBy?: ChartAccessor<TDatum, number>;
     sizeRange?: [number, number];
+    /** Field name or function → glyph **shape**: each point renders as a d3-shape
+     *  glyph instead of a circle. Pair with `symbolMap` for stable, legend-matchable
+     *  shapes; unmapped categories auto-assign. Size still tracks `sizeBy`/`pointRadius`. */
+    symbolBy?: ChartAccessor<TDatum, string>;
+    /** Explicit `{category → shape}` map for `symbolBy`; unmapped auto-assign. */
+    symbolMap?: Record<string, SymbolName>;
     pointRadius?: number;
     pointOpacity?: number;
     categoryPadding?: number;

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

@@ -25,7 +25,7 @@ export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseCh
     /** Color accessor — defaults to subcategoryAccessor */
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme for subcategories */
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     /** Padding between lanes in pixels */
     barPadding?: number;
     /** Enable hover annotations */

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

@@ -17,7 +17,7 @@ export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChart
     valueLabel?: string;
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
-    colorScheme?: string | string[];
+    colorScheme?: string | string[] | Record<string, string>;
     categoryPadding?: number;
     enableHover?: boolean;
     showGrid?: boolean;

package/dist/components/charts/physics/ChainReactionChart.d.ts

@@ -0,0 +1,9 @@
+import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
+import type { ChainReactionChartHandle, ChainReactionChartProps } from "./chainReactionTypes";
+export type * from "./chainReactionTypes";
+export declare const ChainReactionChart: {
+    <TDatum extends Datum = Datum>(props: ChainReactionChartProps<TDatum> & React.RefAttributes<ChainReactionChartHandle>): React.ReactElement | null;
+    displayName?: string;
+};
+export default ChainReactionChart;

package/dist/components/charts/physics/CollisionSwarmChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const CollisionSwarmChartCapability: ChartCapability;

package/dist/components/charts/physics/CollisionSwarmChart.d.ts

@@ -0,0 +1,47 @@
+import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import { type PhysicsFrameHandle } from "./physicsHocHandle";
+import { type PhysicsHocFrameProps, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
+export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin">, PhysicsSharedChartProps {
+    data?: TDatum[];
+    size?: [number, number];
+    xAccessor?: ChartAccessor<TDatum, number>;
+    groupAccessor?: ChartAccessor<TDatum, string>;
+    radiusAccessor?: ChartAccessor<TDatum, number>;
+    pointRadius?: number;
+    colorBy?: ChartAccessor<TDatum, string>;
+    seed?: number;
+    xExtent?: [number, number];
+    collisionIterations?: number;
+    settle?: boolean;
+    showProjection?: boolean;
+    tooltip?: TooltipProp;
+    paused?: boolean;
+    frameProps?: PhysicsHocFrameProps<"config">;
+}
+/**
+ * Physics-backed collision swarm chart that preserves a quantitative x position while separating overlapping bodies.
+ *
+ * @example
+ * ```tsx
+ * <CollisionSwarmChart
+ *   data={[{ id: "a", x: 12, group: "East" }, { id: "b", x: 14, group: "East" }]}
+ *   xAccessor="x"
+ *   groupAccessor="group"
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <CollisionSwarmChart
+ *   data={samples}
+ *   xAccessor={(d) => d.score}
+ *   radiusAccessor="weight"
+ *   collisionIterations={180}
+ *   settle
+ * />
+ * ```
+ */
+export declare const CollisionSwarmChart: React.ForwardRefExoticComponent<CollisionSwarmChartProps<Datum> & React.RefAttributes<PhysicsFrameHandle>>;
+export default CollisionSwarmChart;

package/dist/components/charts/physics/EventDropChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const EventDropChartCapability: ChartCapability;

package/dist/components/charts/physics/EventDropChart.d.ts

@@ -0,0 +1,53 @@
+import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import { type EventDropWindowOptions } from "./physicsChartUtils";
+import { type PhysicsFrameHandle } from "./physicsHocHandle";
+import { type PhysicsHocFrameProps, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
+export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin">, PhysicsSharedChartProps {
+    data?: TDatum[];
+    size?: [number, number];
+    timeAccessor?: ChartAccessor<TDatum, number>;
+    arrivalAccessor?: ChartAccessor<TDatum, number>;
+    windows?: EventDropWindowOptions;
+    watermark?: {
+        delay?: number;
+        value?: number;
+    } | ((latestEventTime: number) => number);
+    ballRadius?: number;
+    colorBy?: ChartAccessor<TDatum, string>;
+    seed?: number;
+    timeExtent?: [number, number];
+    timeScale?: number;
+    showProjection?: boolean;
+    tooltip?: TooltipProp;
+    paused?: boolean;
+    frameProps?: PhysicsHocFrameProps<"config">;
+}
+/**
+ * Physics-backed event drop chart for replaying arrivals against event-time windows and watermarks.
+ *
+ * @example
+ * ```tsx
+ * <EventDropChart
+ *   data={[{ id: "a", time: 4, arrivalTime: 8 }, { id: "b", time: 18, arrivalTime: 12 }]}
+ *   timeAccessor="time"
+ *   arrivalAccessor="arrivalTime"
+ *   windows={{ size: 10 }}
+ *   watermark={{ delay: 5 }}
+ * />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <EventDropChart
+ *   data={events}
+ *   windows={{ size: 60_000 }}
+ *   watermark={{ value: Date.now() - 120_000 }}
+ *   timeScale={4}
+ *   timeExtent={[start, end]}
+ * />
+ * ```
+ */
+export declare const EventDropChart: React.ForwardRefExoticComponent<EventDropChartProps<Datum> & React.RefAttributes<PhysicsFrameHandle>>;
+export default EventDropChart;

package/dist/components/charts/physics/GaltonBoardChart.capability.d.ts

@@ -0,0 +1,2 @@
+import type { ChartCapability } from "../../ai/chartCapabilityTypes";
+export declare const GaltonBoardChartCapability: ChartCapability;