semiotic 3.7.5 → 3.8.0

package/dist/components/ai/readerGrounding.d.ts

@@ -40,6 +40,12 @@ export interface ChartReaderGroundingOptions {
     maxLeaves?: number;
     /** Skip the navigation structure (e.g. to save tokens). Default false. */
     includeStructure?: boolean;
+    /**
+     * Include physics runtime grounding for StreamPhysicsFrame/physics HOCs.
+     * Default: auto-detect from physics chart props. Pass false to omit, true to
+     * force extraction from props, or an object to supply snapshot/evidence rows.
+     */
+    physics?: boolean | PhysicsReaderGroundingInput;
 }
 export interface ChartReaderGroundingIntent {
     /** The communicative act the chart performs. */
@@ -51,6 +57,81 @@ export interface ChartReaderGroundingIntent {
     /** Resolved per-intent scores, when the caller passed them (not from a raw descriptor). */
     intentScores?: Partial<Record<IntentId, number>>;
 }
+export interface PhysicsReaderGroundingAggregate {
+    id?: string;
+    label: string;
+    count: number;
+    secondary?: number;
+    secondaryLabel?: string;
+    observed?: number;
+}
+export interface PhysicsReaderGroundingAggregates {
+    rows: PhysicsReaderGroundingAggregate[];
+    totalCount: number;
+    populatedCount: number;
+    leader?: PhysicsReaderGroundingAggregate;
+}
+export interface PhysicsReaderGroundingSimulation {
+    state?: string;
+    settled?: boolean;
+    elapsedSeconds?: number;
+    paused?: boolean;
+    visible?: boolean;
+    seed?: number;
+    gravity?: {
+        x: number;
+        y: number;
+    };
+    fixedDt?: number;
+    timeScale?: number;
+    maxSubsteps?: number;
+    liveBodies?: number;
+    sleepingBodies?: number;
+    queued?: number;
+    bodyLimit?: number;
+    eviction?: string;
+}
+export interface PhysicsReaderGroundingGeometry {
+    colliders?: number;
+    sensors?: number;
+    springs?: number;
+    activeSensorPairs?: number;
+}
+export interface PhysicsReaderGroundingSediment {
+    bins: number;
+    count: number;
+    total?: number;
+    leader?: {
+        id?: string;
+        label: string;
+        count: number;
+        total?: number;
+    };
+}
+export interface PhysicsReaderGroundingInput {
+    /** PhysicsPipelineSnapshot or a structurally equivalent object. */
+    snapshot?: unknown;
+    /** PhysicsSettledEvidence or a structurally equivalent object. */
+    evidence?: unknown;
+    /** PhysicsPipelineConfig or equivalent runtime config. */
+    config?: unknown;
+    /** Settled projection rows / evidence bin counts. */
+    projectionRows?: readonly unknown[];
+    /** Alias for projectionRows when callers already name the rows aggregates. */
+    aggregates?: readonly unknown[];
+    /** Physics sediment bin snapshots. */
+    sediment?: readonly unknown[];
+    /** Precomputed sediment totals, if available. */
+    sedimentTotals?: unknown;
+}
+export interface PhysicsReaderGrounding {
+    simulation: PhysicsReaderGroundingSimulation;
+    geometry?: PhysicsReaderGroundingGeometry;
+    aggregates?: PhysicsReaderGroundingAggregates;
+    sediment?: PhysicsReaderGroundingSediment;
+    /** Compact prose appended to `ChartReaderGrounding.text`. */
+    text: string;
+}
 export interface ChartReaderGrounding {
     component: string;
     /** Layered L1–L3 description ({ text, levels }). */
@@ -59,6 +140,8 @@ export interface ChartReaderGrounding {
     intent?: ChartReaderGroundingIntent;
     /** Structured navigation tree (chart → axes/series → datum). Omitted when `includeStructure: false`. */
     structure?: NavTreeNode;
+    /** Physics-specific runtime grounding for simulation charts. */
+    physics?: PhysicsReaderGrounding;
     /** L1–L4 joined into one prose blob an LLM can read directly. */
     text: string;
 }

package/dist/components/ai/recipeCapability.d.ts

@@ -0,0 +1,8 @@
+import type { ChartCapability, ChartDataProfile } from "./chartCapabilityTypes";
+import type { ChartRecipe, DataRoleDefinition } from "./chartRecipes";
+export declare function resolveRecipeRoleField(recipe: ChartRecipe, role: DataRoleDefinition, profile: ChartDataProfile): string | undefined;
+/**
+ * Adapt a declarative recipe into the existing capability engine. Raw custom
+ * frame HOCs remain excluded; named recipes participate as distinct candidates.
+ */
+export declare function recipeToChartCapability(recipe: ChartRecipe): ChartCapability;

package/dist/components/ai/recipeNavigation.d.ts

@@ -0,0 +1,13 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import type { ChartRecipe } from "./chartRecipes";
+import type { NavTreeNode } from "./navigationTree";
+export interface RecipeNavigationOptions {
+    maxLeaves?: number;
+    locale?: string;
+}
+/**
+ * Build navigation from a recipe strategy, or from its declared data roles
+ * when no strategy exists. The fallback always produces data leaves rather
+ * than collapsing an unfamiliar custom chart to a root-only node.
+ */
+export declare function buildRecipeNavigationTree(recipe: ChartRecipe, props: Datum, options?: RecipeNavigationOptions): NavTreeNode;

package/dist/components/ai/recipeSemantics.d.ts

@@ -0,0 +1,11 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import type { ChartRecipe, DataRoleDefinition, IntentDefinition } from "./chartRecipes";
+export declare function recipeIntentId(intent: IntentDefinition): string | undefined;
+export declare function recipeConfig(props: Datum): Record<string, unknown>;
+export declare function recipeData(props: Datum): Datum[];
+export declare function resolveRecipeForChart(component: string, props: Datum, explicit?: ChartRecipe): ChartRecipe | undefined;
+export declare function fieldForRole(role: DataRoleDefinition, config: Record<string, unknown>, data?: ReadonlyArray<Datum>): string | undefined;
+export declare function roleByName(recipe: ChartRecipe, name: string): DataRoleDefinition | undefined;
+export declare function firstRole(recipe: ChartRecipe, semanticTypes: DataRoleDefinition["semanticType"][]): DataRoleDefinition | undefined;
+export declare function roleValue(datum: Datum, role: DataRoleDefinition | undefined, config: Record<string, unknown>, data: ReadonlyArray<Datum>): unknown;
+export declare function fillRecipeTemplate(template: string, datum: Datum | undefined, recipe: ChartRecipe, config: Record<string, unknown>, data: ReadonlyArray<Datum>, extra?: Record<string, string | number>): string;

package/dist/components/ai/repairChartConfig.d.ts

@@ -1,6 +1,7 @@
 import type { Datum } from "../charts/shared/datumTypes";
 import type { ChartDataProfile, Suggestion } from "./chartCapabilityTypes";
 import type { IntentId } from "./intents";
+import type { ObservedSceneAuditResult } from "./observedSceneAudit";
 /**
  * Repair result when the chosen chart fits the data — nothing to fix.
  */
@@ -9,6 +10,8 @@ export interface RepairOkResult {
     component: string;
     /** The same data profile that was evaluated. */
     profile: ChartDataProfile;
+    /** Recipe-specific reception/accessibility repairs, even when data shape fits. */
+    repairs?: string[];
 }
 /**
  * Repair result when the chosen chart doesn't fit. Carries the diagnostic
@@ -24,6 +27,7 @@ export interface RepairAlternativeResult {
     /** Whether the caller intended one of the alternatives anyway. */
     alternatives: Suggestion[];
     profile: ChartDataProfile;
+    repairs?: string[];
 }
 /**
  * Repair result when no capability is registered for the asked component.
@@ -34,6 +38,7 @@ export interface RepairUnknownResult {
     /** Closest matches by family/intent — best effort. */
     alternatives: Suggestion[];
     profile: ChartDataProfile;
+    repairs?: string[];
 }
 export type RepairResult = RepairOkResult | RepairAlternativeResult | RepairUnknownResult;
 export interface RepairOptions {
@@ -45,6 +50,10 @@ export interface RepairOptions {
     maxAlternatives?: number;
     /** Pre-computed profile, avoids recomputation. */
     profile?: ChartDataProfile;
+    /** Current rendered props, used for recipe-specific repair guidance. */
+    props?: Datum;
+    /** Optional observed-scene evidence from auditObservedScene(). */
+    observedSceneAudit?: ObservedSceneAuditResult;
 }
 /**
  * Validate that a chart component is a sensible choice for a dataset, and

package/dist/components/ai/suggestCharts.d.ts

@@ -2,7 +2,7 @@ import type { Datum } from "../charts/shared/datumTypes";
 import { type ProfileDataOptions } from "./profileData";
 import type { ChartCapability, ChartDataProfile, ScaledSuggestionGroups, Suggestion } from "./chartCapabilityTypes";
 import type { IntentId } from "./intents";
-import { type AudienceProfile } from "./audienceProfile";
+import { type AudienceProfile, type ReceptionModality } from "./audienceProfile";
 import { type DataQualityProfile, type DataScaleProfile } from "./dataScaleProfile";
 export interface SuggestChartsOptions extends ProfileDataOptions {
     /** Ranking intent(s). When omitted, suggestions are ranked by mean intent score. */
@@ -39,6 +39,12 @@ export interface SuggestChartsOptions extends ProfileDataOptions {
      * `dataScaleProfile.ts`.
      */
     quality?: DataQualityProfile;
+    /** Restrict recipe candidates by portability tier. Built-ins are unaffected. */
+    portability?: "portable" | "local";
+    /** Controls how strongly declared recipe reception risks affect ranking. */
+    riskTolerance?: "low" | "medium" | "high";
+    /** Explicit reception channel when no full AudienceProfile is available. */
+    receptionChannel?: ReceptionModality;
 }
 /**
  * Suggest charts for a dataset, ranked by intent suitability.
@@ -85,6 +91,10 @@ export declare function scoreChart(component: string, data: ReadonlyArray<Datum>
     intent?: IntentId | IntentId[];
     variantKey?: string;
     profile?: ChartDataProfile;
+    audience?: AudienceProfile;
+    portability?: "portable" | "local";
+    riskTolerance?: "low" | "medium" | "high";
+    receptionChannel?: ReceptionModality;
 }): Suggestion | {
     reason: string;
 };

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

@@ -0,0 +1,48 @@
+import * as React from "react";
+import type { ProjectionProp, StreamGeoFrameProps } from "../../stream/geoTypes";
+import type { GeoCustomLayout } from "../../stream/geoCustomLayout";
+import type { ChartRecipe } from "../../ai/chartRecipes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { Datum } from "../shared/datumTypes";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import { type TooltipProp } from "../../Tooltip/Tooltip";
+export interface GeoCustomChartProps<TDatum extends Datum = Datum, TConfig extends object = Record<string, unknown>> extends BaseChartProps {
+    /** Geographic point data supplied to `GeoLayoutContext.points`. */
+    points?: TDatum[];
+    /** Geographic areas supplied to `GeoLayoutContext.areas`. */
+    areas?: GeoJSON.Feature[];
+    /** Geographic line/flow records supplied to `GeoLayoutContext.lines`. */
+    lines?: TDatum[];
+    /** Layout function that emits GeoFrame scene nodes and optional overlays. */
+    layout: GeoCustomLayout<TConfig>;
+    /** User configuration threaded to `GeoLayoutContext.config`. */
+    layoutConfig?: TConfig;
+    /** Receives a structured diagnostic if the layout throws. */
+    onLayoutError?: StreamGeoFrameProps["onLayoutError"];
+    recipe?: ChartRecipe<TDatum, TConfig>;
+    recipeId?: string;
+    /** Projection resolved before the custom layout runs. @default "equirectangular" */
+    projection?: ProjectionProp;
+    xAccessor?: StreamGeoFrameProps<TDatum>["xAccessor"];
+    yAccessor?: StreamGeoFrameProps<TDatum>["yAccessor"];
+    lineDataAccessor?: StreamGeoFrameProps<TDatum>["lineDataAccessor"];
+    /** Field or function that declares the semantic category used for custom-layout color. */
+    colorBy?: ChartAccessor<TDatum, string>;
+    colorScheme?: string | string[] | Record<string, string>;
+    enableHover?: boolean;
+    tooltip?: TooltipProp;
+    annotations?: Datum[];
+    /** Additional StreamGeoFrame props excluding fields controlled by this HOC. */
+    frameProps?: Partial<Omit<StreamGeoFrameProps, "areas" | "points" | "lines" | "projection" | "size" | "customLayout" | "layoutConfig" | "layoutSelection" | "xAccessor" | "yAccessor" | "lineDataAccessor">>;
+}
+/**
+ * GeoCustomChart — escape hatch for bespoke geographic geometry.
+ *
+ * The frame resolves the projection and continues to own canvas rendering,
+ * polygon/point/line hit-testing, accessibility, tooltips, selection, and SSR.
+ * The supplied layout owns only the scene geometry and SVG overlays.
+ */
+export declare const GeoCustomChart: {
+    <TDatum extends Datum = Datum, TConfig extends object = Record<string, unknown>>(props: GeoCustomChartProps<TDatum, TConfig> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

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,7 +25,8 @@ 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

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.
      *