semiotic 3.8.6 → 3.8.7

package/dist/components/recipes/physicsStageGeography.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Physics stage geography — the shared spatial vocabulary every physics chart
+ * has been re-inventing.
+ *
+ * ## The observation
+ *
+ * Every physics chart in Semiotic is the same three-zone apparatus under a
+ * different local name:
+ *
+ * | chart          | charge         | apparatus            | destinations          |
+ * |----------------|----------------|----------------------|-----------------------|
+ * | Galton         | hopper         | peg field            | bins                  |
+ * | Pile           | drop point     | tubes                | category piles        |
+ * | CollisionSwarm | x positions    | collision relaxation | settled x positions   |
+ * | EventDrop      | arrivals       | watermark barrier    | windows + late gutter |
+ * | ProcessFlow    | arrival        | capacitated stages   | absorb stages         |
+ * | Gauntlet       | start          | gates                | socket / graveyard    |
+ * | Crucible       | charge         | phases               | outlets               |
+ * | ChainReaction  | completed task | dependency sockets   | armed tasks           |
+ *
+ * They also all conserve something, which is what the settled ledger checks.
+ * `GauntletLayout` calls its zones `startX`/`socketX`/`graveyardX`;
+ * `CrucibleLayout` calls them `chamber`/`mouth`/`outlets`; Galton and Pile
+ * independently wrote the *same* lane formula
+ * (`plot.x + (index + 0.5) * plot.width / count`). Naming the geography once
+ * means the tenth physics chart costs less than the first.
+ *
+ * ## Scope
+ *
+ * This is authoring vocabulary, not a retrofit. Existing charts keep their own
+ * layouts (their SSR baselines depend on them); `physicsStageGeography.test.ts`
+ * proves this builder reproduces their lane math, so a new chart can adopt it
+ * and land in the same visual family. Reach for it when building a new physics
+ * chart or a `PhysicsCustomChart` layout.
+ */
+import type { PhysicsColliderSpec } from "../stream/physics/PhysicsKernel";
+export interface PhysicsZone {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PhysicsDestinationZone extends PhysicsZone {
+    id: string;
+    label: string;
+    /** Reading order along the flow axis. */
+    order: number;
+    /** Center of the zone — where a settled pile or bin count anchors. */
+    centerX: number;
+    centerY: number;
+}
+export interface PhysicsStageGeography {
+    width: number;
+    height: number;
+    /** Direction the charge travels toward its destinations. */
+    flow: "down" | "right";
+    /** Where bodies enter the world. */
+    charge: PhysicsZone;
+    /** Where the apparatus acts: pegs, gates, phases, stages, barriers. */
+    apparatus: PhysicsZone;
+    /** Where bodies come to rest, in reading order. */
+    destinations: PhysicsDestinationZone[];
+    /** Strip reserved for the settled projection. Bodies never enter it. */
+    projection: PhysicsZone;
+}
+export interface PhysicsStageGeographyOptions {
+    size: [number, number];
+    /**
+     * Destination bins/lanes/outlets. A number produces `bin-0…bin-n` ids, which
+     * is the common case for a histogram-shaped board.
+     */
+    destinations: number | ReadonlyArray<{
+        id: string;
+        label?: string;
+    }>;
+    /** Charge travels down (boards, piles) or right (process lanes, routes). */
+    flow?: "down" | "right";
+    /** Outer inset in px. */
+    padding?: number | {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Fraction of the flow axis given to the entry zone. */
+    chargeExtent?: number;
+    /** Fraction of the flow axis given to the settled destinations. */
+    destinationExtent?: number;
+    /** Fraction of the flow axis reserved for the projection strip. */
+    projectionExtent?: number;
+    /**
+     * Fraction of each destination lane the body-holding channel occupies. `1`
+     * means bins touch (a histogram); lower values leave visible gutters (tubes).
+     */
+    channelRatio?: number;
+}
+/**
+ * Build the charge → apparatus → destinations geography for a physics stage.
+ *
+ * The cross-axis lane math matches what Galton bins and Pile tubes already use,
+ * so a chart built on this lands in the same visual family as the existing ones.
+ */
+export declare function physicsStageGeography(options: PhysicsStageGeographyOptions): PhysicsStageGeography;
+/** Look a destination up by id. */
+export declare function physicsDestination(geography: PhysicsStageGeography, id: string): PhysicsDestinationZone | undefined;
+/**
+ * Where the nth of `count` bodies should enter the charge zone, spread evenly
+ * across it so a burst does not spawn co-located and explode apart.
+ */
+export declare function physicsChargePoint(geography: PhysicsStageGeography, index: number, count: number): {
+    x: number;
+    y: number;
+};
+export interface PhysicsStageColliderOptions {
+    /** Collider thickness in px. */
+    thickness?: number;
+    /** Prefix for generated collider ids. */
+    idPrefix?: string;
+    /** Add the outer boundary walls in addition to the destination dividers. */
+    walls?: boolean;
+}
+/**
+ * Colliders that make the destinations physically real: a floor plus one
+ * divider between each pair of adjacent destinations, so bodies land in the bin
+ * the data says they should. This is the geometry every board/pile chart writes
+ * by hand.
+ */
+export declare function physicsStageColliders(geography: PhysicsStageGeography, options?: PhysicsStageColliderOptions): PhysicsColliderSpec[];
+/**
+ * One sentence naming the apparatus, for accessible descriptions and agent
+ * grounding. The reading protocol should be stateable in words, not only drawn.
+ */
+export declare function describePhysicsStageGeography(geography: PhysicsStageGeography, nouns?: {
+    charge?: string;
+    apparatus?: string;
+    destination?: string;
+}): string;

package/dist/components/semiotic-ai.d.ts

@@ -46,12 +46,13 @@ export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
 export { GaltonBoardChart } from "./charts/physics/GaltonBoardChart";
 export { EventDropChart } from "./charts/physics/EventDropChart";
 export { PhysicsCustomChart } from "./charts/physics/PhysicsCustomChart";
-export { PhysicsPileChart } from "./charts/physics/PhysicsPileChart";
+export { UnitPileChart } from "./charts/physics/UnitPileChart";
 export { CollisionSwarmChart } from "./charts/physics/CollisionSwarmChart";
-export { PhysicalFlowChart } from "./charts/physics/PhysicalFlowChart";
+export { PacketFlowChart } from "./charts/physics/PacketFlowChart";
 export { ProcessFlowChart } from "./charts/physics/ProcessFlowChart";
 export { GauntletChart } from "./charts/physics/GauntletChart";
 export { CrucibleChart } from "./charts/physics/CrucibleChart";
+export { ChainReactionChart } from "./charts/physics/ChainReactionChart";
 export { BigNumber } from "./charts/value/BigNumber";
 export { TooltipProvider } from "./store/TooltipStore";
 export { MultiLineTooltip } from "./Tooltip/Tooltip";
@@ -172,7 +173,7 @@ export type { AnnotationProvenance, AnnotationSource, AnnotationActorKind, Annot
 export { useConversationArc, summarizeArc } from "./ai/useConversationArc";
 export type { UseConversationArcOptions, UseConversationArcResult, ConversationArcSummary } from "./ai/useConversationArc";
 export { enableConversationArc, disableConversationArc, getConversationArcStore, subscribeToConversationArcChange, registerConversationArcSink, createLocalStorageConversationArcSink, createIndexedDBConversationArcSink, createWebhookConversationArcSink, loadConversationArc, replayConversationArc, recordAudienceChange, recordAnnotationStatusChange } from "./ai/conversationArc";
-export type { ConversationArcEvent, ConversationArcEventType, ConversationArcEventInput, ConversationArcStore, ConversationArcListener, ConversationArcSink, ConversationArcStorageLike, EnableConversationArcOptions, LoadConversationArcOptions, LocalStorageConversationArcSinkOptions, IndexedDBConversationArcSinkOptions, ConversationArcWebhookFetch, WebhookConversationArcSinkOptions, SuggestionShownEvent, SuggestionChosenEvent, AudienceSetEvent, ChartRenderedEvent, ChartEditedEvent, ChartReplacedEvent, ChartExportedEvent, ChartAbandonedEvent, InterrogationAskedEvent, InterrogationAnsweredEvent, NavNodeFocusedEvent, NavBranchExpandedEvent, AnnotationStatusChangedEvent } from "./ai/conversationArc";
+export type { ConversationArcEvent, ConversationArcEventType, ConversationArcEventInput, ConversationArcStore, ConversationArcListener, ConversationArcSink, ConversationArcStorageLike, EnableConversationArcOptions, LoadConversationArcOptions, LocalStorageConversationArcSinkOptions, IndexedDBConversationArcSinkOptions, ConversationArcWebhookFetch, WebhookConversationArcSinkOptions, SuggestionShownEvent, SuggestionChosenEvent, AudienceSetEvent, ChartRenderedEvent, ChartEditedEvent, ChartReplacedEvent, ChartExportedEvent, ChartAbandonedEvent, InterrogationAskedEvent, InterrogationAnsweredEvent, NavNodeFocusedEvent, NavBranchExpandedEvent, AnnotationStatusChangedEvent, ProposalRefusedEvent, RenderEvidenceEvent } from "./ai/conversationArc";
 export { useChartObserver } from "./store/useObservation";
 export type { UseChartObserverOptions, UseChartObserverResult } from "./store/useObservation";
 export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation, ObservationInputType, FocusObservation, ActivateObservation, AnnotationActivateObservation } from "./store/ObservationStore";

package/dist/components/semiotic-experimental-vacp.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pure experimental VACP 0.1.0 entry point.
+ *
+ * This subpath contains no React component or client directive, so server,
+ * headless, and non-React hosts can construct the semantic bridge without
+ * pulling in the browser-only experimental facade.
+ */
+export { SEMIOTIC_VACP_ACTIVATE_NAVIGATION_ACTION as unstable_SEMIOTIC_VACP_ACTIVATE_NAVIGATION_ACTION, SEMIOTIC_VACP_CLEAR_SELECTION_ACTION as unstable_SEMIOTIC_VACP_CLEAR_SELECTION_ACTION, SEMIOTIC_VACP_INSPECT_DATA_ACTION as unstable_SEMIOTIC_VACP_INSPECT_DATA_ACTION, SEMIOTIC_VACP_SET_INTERVAL_SELECTION_ACTION as unstable_SEMIOTIC_VACP_SET_INTERVAL_SELECTION_ACTION, SEMIOTIC_VACP_SET_POINT_SELECTION_ACTION as unstable_SEMIOTIC_VACP_SET_POINT_SELECTION_ACTION, createSemioticVACPBridge as unstable_createSemioticVACPBridge, installSemioticVACPBridge as unstable_installSemioticVACPBridge } from "./ai/vacpAdapter";
+export { VACP_DATA_SCHEMA_ACTION as unstable_VACP_DATA_SCHEMA_ACTION, VACP_SCHEMA_VERSION as unstable_VACP_SCHEMA_VERSION } from "./ai/vacpTypes";
+export type { CreateSemioticVACPBridgeOptions as UnstableCreateSemioticVACPBridgeOptions, InstallSemioticVACPBridgeOptions as UnstableInstallSemioticVACPBridgeOptions, SemioticVACPBridge as UnstableSemioticVACPBridge, SemioticVACPBridgeInstallation as UnstableSemioticVACPBridgeInstallation, SemioticVACPChart as UnstableSemioticVACPChart, SemioticVACPCustomAction as UnstableSemioticVACPCustomAction, SemioticVACPDataAccess as UnstableSemioticVACPDataAccess, SemioticVACPNavigationBinding as UnstableSemioticVACPNavigationBinding, SemioticVACPRefs as UnstableSemioticVACPRefs, SemioticVACPSelectionActions as UnstableSemioticVACPSelectionActions, SemioticVACPSelectionBinding as UnstableSemioticVACPSelectionBinding, SemioticVACPSelectionMode as UnstableSemioticVACPSelectionMode } from "./ai/vacpAdapter";
+export type { VacpActionCall as UnstableVacpActionCall, VacpActionDescriptor as UnstableVacpActionDescriptor, VacpActionResult as UnstableVacpActionResult, VacpCapabilitiesRequest as UnstableVacpCapabilitiesRequest, VacpCapabilitiesSnapshot as UnstableVacpCapabilitiesSnapshot, VacpDataSchemaColumn as UnstableVacpDataSchemaColumn, VacpDataSchemaDetail as UnstableVacpDataSchemaDetail, VacpDataSchemaParams as UnstableVacpDataSchemaParams, VacpDataSchemaResult as UnstableVacpDataSchemaResult, VacpEdge as UnstableVacpEdge, VacpEdgeKind as UnstableVacpEdgeKind, VacpGraph as UnstableVacpGraph, VacpLayer as UnstableVacpLayer, VacpNode as UnstableVacpNode, VacpNodeKind as UnstableVacpNodeKind, VacpRef as UnstableVacpRef, VacpSchemaVersion as UnstableVacpSchemaVersion, VacpStateDeltaPayload as UnstableVacpStateDeltaPayload, VacpStateRequest as UnstableVacpStateRequest, VacpStateSnapshot as UnstableVacpStateSnapshot, VacpStateUpdate as UnstableVacpStateUpdate, VacpWindowBridge as UnstableVacpWindowBridge } from "./ai/vacpTypes";

package/dist/components/semiotic-experimental.d.ts

@@ -12,7 +12,10 @@ export { gofishIRExamples as unstable_gofishIRExamples, flowerIR as unstable_gof
 export type { GofishIRExample as UnstableGofishIRExample } from "./recipes/gofishIRExamples";
 export { DEFAULT_DATA_PITFALLS_ANNOTATION_PALETTE as unstable_DEFAULT_DATA_PITFALLS_ANNOTATION_PALETTE, buildDataPitfallsAnnotationBridge as unstable_buildDataPitfallsAnnotationBridge, buildDataPitfallsBridge as unstable_buildDataPitfallsBridge, buildDataPitfallsNotificationBridge as unstable_buildDataPitfallsNotificationBridge, dataPitfallsFindingToAnnotation as unstable_dataPitfallsFindingToAnnotation, dataPitfallsFindingToNotification as unstable_dataPitfallsFindingToNotification, toDataPitfallsAnnotations as unstable_toDataPitfallsAnnotations, toDataPitfallsChain as unstable_toDataPitfallsChain, toDataPitfallsNotifications as unstable_toDataPitfallsNotifications } from "./ai/dataPitfallsBridge";
 export type { DataPitfallsAnnotationBridge as UnstableDataPitfallsAnnotationBridge, DataPitfallsAnnotationBridgeOptions as UnstableDataPitfallsAnnotationBridgeOptions, DataPitfallsAnnotationType as UnstableDataPitfallsAnnotationType, DataPitfallsBridgeOptions as UnstableDataPitfallsBridgeOptions, DataPitfallsBridgeResult as UnstableDataPitfallsBridgeResult, DataPitfallsChainInput as UnstableDataPitfallsChainInput, DataPitfallsChainStage as UnstableDataPitfallsChainStage, DataPitfallsChartNotification as UnstableDataPitfallsChartNotification, DataPitfallsDocumentInput as UnstableDataPitfallsDocumentInput, DataPitfallsFinding as UnstableDataPitfallsFinding, DataPitfallsImageInput as UnstableDataPitfallsImageInput, DataPitfallsImageMediaType as UnstableDataPitfallsImageMediaType, DataPitfallsImageSource as UnstableDataPitfallsImageSource, DataPitfallsInputKind as UnstableDataPitfallsInputKind, DataPitfallsNotificationBridge as UnstableDataPitfallsNotificationBridge, DataPitfallsNotificationBridgeOptions as UnstableDataPitfallsNotificationBridgeOptions, DataPitfallsNotificationLevel as UnstableDataPitfallsNotificationLevel, DataPitfallsNotificationMessage as UnstableDataPitfallsNotificationMessage, DataPitfallsRenderedChart as UnstableDataPitfallsRenderedChart, DataPitfallsReport as UnstableDataPitfallsReport, DataPitfallsSemioticAnnotation as UnstableDataPitfallsSemioticAnnotation, DataPitfallsSeverity as UnstableDataPitfallsSeverity, DataPitfallsSlideContent as UnstableDataPitfallsSlideContent, DataPitfallsSlidesInput as UnstableDataPitfallsSlidesInput, DataPitfallsSingleArtifactInput as UnstableDataPitfallsSingleArtifactInput, DataPitfallsTextInput as UnstableDataPitfallsTextInput } from "./ai/dataPitfallsBridge";
-export { IDID_SPEC_VERSION, BUILTIN_INTENT_IDS as unstable_BUILTIN_INTENT_IDS, validatePortableCapability as unstable_validatePortableCapability, validatePortableAudienceProfile as unstable_validatePortableAudienceProfile, validatePortableAnnotation as unstable_validatePortableAnnotation, toVegaLite as unstable_toVegaLite, toVegaLiteResult as unstable_toVegaLiteResult, fromVegaLiteResult as unstable_fromVegaLiteResult, unwrapIDIDEnrichedVegaLiteSpec as unstable_unwrapIDIDEnrichedVegaLiteSpec, attachIDID as unstable_attachIDID, readIDID as unstable_readIDID, attachIDIDAnnotations as unstable_attachIDIDAnnotations, readIDIDAnnotations as unstable_readIDIDAnnotations } from "./data/portability";
+export * from "./semiotic-experimental-vacp";
+export { SemioticVACPBridge as unstable_SemioticVACPBridge } from "./ai/SemioticVACPBridge";
+export type { SemioticVACPBridgeProps as UnstableSemioticVACPBridgeProps } from "./ai/SemioticVACPBridge";
+export { IDID_SPEC_VERSION, BUILTIN_INTENT_IDS as unstable_BUILTIN_INTENT_IDS, validatePortableCapability as unstable_validatePortableCapability, validatePortableAudienceProfile as unstable_validatePortableAudienceProfile, validatePortableAnnotation as unstable_validatePortableAnnotation, bindPortableCapability as unstable_bindPortableCapability, toVegaLite as unstable_toVegaLite, toVegaLiteResult as unstable_toVegaLiteResult, fromVegaLiteResult as unstable_fromVegaLiteResult, unwrapIDIDEnrichedVegaLiteSpec as unstable_unwrapIDIDEnrichedVegaLiteSpec, attachIDID as unstable_attachIDID, readIDID as unstable_readIDID, attachIDIDAnnotations as unstable_attachIDIDAnnotations, readIDIDAnnotations as unstable_readIDIDAnnotations } from "./data/portability";
 export type { FromVegaLiteOptions as UnstableFromVegaLiteOptions, PortabilityDiagnostic as UnstablePortabilityDiagnostic, PortabilityDiagnosticSeverity as UnstablePortabilityDiagnosticSeverity, PortabilityExportResult as UnstablePortabilityExportResult, PortabilityImportResult as UnstablePortabilityImportResult, PortabilityLoss as UnstablePortabilityLoss, PortabilityProvenance as UnstablePortabilityProvenance, PortabilityResult as UnstablePortabilityResult, PortabilityStatus as UnstablePortabilityStatus, ToVegaLiteOptions as UnstableToVegaLiteOptions, VegaLiteExportResult as UnstableVegaLiteExportResult, VegaLiteImportResult as UnstableVegaLiteImportResult, } from "./data/portability";
 export { fromObservablePlot as unstable_fromObservablePlot } from "./data/fromObservablePlot";
 export { fromMermaid as unstable_fromMermaid } from "./data/fromMermaid";
@@ -42,8 +45,8 @@ export type { PhysicsBodySelection as UnstablePhysicsBodySelection, PhysicsBodyS
 export type { PhysicsCustomChartProps as UnstablePhysicsCustomChartProps, PhysicsCustomLayout as UnstablePhysicsCustomLayout, PhysicsCustomLayoutContext as UnstablePhysicsCustomLayoutContext, PhysicsCustomLayoutResult as UnstablePhysicsCustomLayoutResult, PhysicsCustomSpawnDatumResult as UnstablePhysicsCustomSpawnDatumResult } from "./charts/physics/PhysicsCustomChart";
 export type { PhysicsExecution as UnstablePhysicsExecution } from "./stream/physics/PhysicsWorkerProtocol";
 export type { PhysicsAnnotationAxis as UnstablePhysicsAnnotationAxis, PhysicsAnnotationColliderOptions as UnstablePhysicsAnnotationColliderOptions, PhysicsAnnotationRole as UnstablePhysicsAnnotationRole, PhysicsAnnotationSummary as UnstablePhysicsAnnotationSummary, PhysicsBodyAnnotation as UnstablePhysicsBodyAnnotation, PhysicsResolvedBodyAnnotation as UnstablePhysicsResolvedBodyAnnotation, PhysicsStaticAnnotation as UnstablePhysicsStaticAnnotation } from "./stream/physics/PhysicsAnnotations";
-export type { PhysicsEvidenceBinCount as UnstablePhysicsEvidenceBinCount, PhysicsSettledEvidence as UnstablePhysicsSettledEvidence, PhysicsSettledEvidenceOptions as UnstablePhysicsSettledEvidenceOptions } from "./stream/physics/PhysicsEvidence";
+export type { PhysicsEvidenceBinCount as UnstablePhysicsEvidenceBinCount, PhysicsSettledEvidence as UnstablePhysicsSettledEvidence, PhysicsSettledEvidenceOptions as UnstablePhysicsSettledEvidenceOptions, PhysicsSettledLedger as UnstablePhysicsSettledLedger } from "./stream/physics/PhysicsEvidence";
 export type { PhysicsSettledScene as UnstablePhysicsSettledScene, PhysicsSettledSceneOptions as UnstablePhysicsSettledSceneOptions } from "./stream/physics/PhysicsSettledScene";
 export type { PhysicsSettledSVGOptions as UnstablePhysicsSettledSVGOptions, PhysicsSettledSVGRender as UnstablePhysicsSettledSVGRender } from "./stream/physics/PhysicsSettledSVG";
 export type { PhysicsNavigationTreeOptions as UnstablePhysicsNavigationTreeOptions, PhysicsObservationAnnouncementOptions as UnstablePhysicsObservationAnnouncementOptions, PhysicsProjectionBodySummary as UnstablePhysicsProjectionBodySummary, PhysicsProjectionContainerSpec as UnstablePhysicsProjectionContainerSpec, PhysicsSettledProjectionOptions as UnstablePhysicsSettledProjectionOptions, PhysicsSettledProjectionRow as UnstablePhysicsSettledProjectionRow } from "./stream/physics/PhysicsAccessibility";
-export type { BuiltInIntentId as UnstableBuiltInIntentId, PortableIntentId as UnstablePortableIntentId, PortableChartRubric as UnstablePortableChartRubric, PortableChartVariant as UnstablePortableChartVariant, PortableMobileInteractionCapability as UnstablePortableMobileInteractionCapability, PortableMobileLabelCapability as UnstablePortableMobileLabelCapability, PortableMobileCustomCapability as UnstablePortableMobileCustomCapability, PortableMobileCapability as UnstablePortableMobileCapability, PortableChartCapability as UnstablePortableChartCapability, PortableReceptionModality as UnstablePortableReceptionModality, PortableAudienceTarget as UnstablePortableAudienceTarget, PortableAudienceProfile as UnstablePortableAudienceProfile, PortableAnnotationProvenance as UnstablePortableAnnotationProvenance, PortableAnnotationLifecycle as UnstablePortableAnnotationLifecycle, PortableAnnotated as UnstablePortableAnnotated, ValidationResult as UnstablePortabilityValidationResult, IDIDVegaLiteMeta as UnstableIDIDVegaLiteMeta } from "./data/portability";
+export type { BuiltInIntentId as UnstableBuiltInIntentId, PortableIntentId as UnstablePortableIntentId, PortableChartRubric as UnstablePortableChartRubric, PortableChartVariant as UnstablePortableChartVariant, BoundPortableChartCapability as UnstableBoundPortableChartCapability, PortableCapabilityBindingResult as UnstablePortableCapabilityBindingResult, PortableMobileInteractionCapability as UnstablePortableMobileInteractionCapability, PortableMobileLabelCapability as UnstablePortableMobileLabelCapability, PortableMobileCustomCapability as UnstablePortableMobileCustomCapability, PortableMobileCapability as UnstablePortableMobileCapability, PortableChartCapability as UnstablePortableChartCapability, PortableReceptionModality as UnstablePortableReceptionModality, PortableAudienceTarget as UnstablePortableAudienceTarget, PortableAudienceProfile as UnstablePortableAudienceProfile, PortableAnnotationProvenance as UnstablePortableAnnotationProvenance, PortableAnnotationLifecycle as UnstablePortableAnnotationLifecycle, PortableAnnotated as UnstablePortableAnnotated, ValidationResult as UnstablePortabilityValidationResult, IDIDVegaLiteMeta as UnstableIDIDVegaLiteMeta } from "./data/portability";

package/dist/components/semiotic-geo.d.ts

@@ -19,6 +19,10 @@ export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types"
 export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
 export type { StreamGeoFrameProps, StreamGeoFrameHandle, GeoAreaSceneNode, GeoSceneNode, GeoScales, ProjectionProp, ProjectionName, GraticuleConfig, DistanceCartogramConfig, GeoPipelineConfig } from "./stream/geoTypes";
 export type { GeoCustomLayout, GeoLayoutContext, GeoLayoutResult } from "./stream/geoCustomLayout";
+export { geographicGridLayout, gridifyGeographicPoints, } from "./recipes/geographicGrid";
+export type { GeographicGridConfig, GeographicGridInput, GeographicGridShape, GeographicGridSource, GridifiedGeographicPoint, GridifyGeographicPointsOptions, } from "./recipes/geographicGrid";
+export { geographicDotGridLayout, sampleGeographicDotGrid, } from "./recipes/geographicDotGrid";
+export type { GeographicDotGridAccessor, GeographicDotGridConfig, GeographicDotGridDatum, GeographicDotGridSampleOptions, GeographicDotGridShape, } from "./recipes/geographicDotGrid";
 export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
 export type { GeoParticleStyle } from "./stream/GeoParticlePool";
 export { mergeData } from "./geo/mergeData";

package/dist/components/semiotic-physics.d.ts

@@ -4,12 +4,13 @@
  */
 import { GaltonBoardChart } from "./charts/physics/GaltonBoardChart";
 import { EventDropChart } from "./charts/physics/EventDropChart";
-import { PhysicsPileChart } from "./charts/physics/PhysicsPileChart";
+import { UnitPileChart, PhysicsPileChart } from "./charts/physics/UnitPileChart";
 import { PhysicsCustomChart } from "./charts/physics/PhysicsCustomChart";
 import { CollisionSwarmChart } from "./charts/physics/CollisionSwarmChart";
 import { compilePhysicsEncoding, createPhysicsEncodingLayout } from "./charts/physics/physicsEncoding";
 import { GauntletChart, GuantletChart, planGauntletPropertyWork, replaceGauntletNegative } from "./charts/physics/GauntletChart";
-import { PhysicalFlowChart } from "./charts/physics/PhysicalFlowChart";
+import { resolveGauntletTerminalState, resolveGauntletTerminalStates } from "./charts/physics/gauntletTerminal";
+import { PacketFlowChart, PhysicalFlowChart } from "./charts/physics/PacketFlowChart";
 import { ProcessFlowChart } from "./charts/physics/ProcessFlowChart";
 import { physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems } from "./charts/physics/physicsProcessPrimitives";
 import { buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics } from "./charts/physics/physicsChartUtils";
@@ -21,19 +22,21 @@ import { evaluatePhysicsBodyBudget } from "./stream/physics/PhysicsBodyBudget";
 import { PhysicsSedimentAccumulator, sedimentHeightfield } from "./stream/physics/PhysicsSediment";
 import { composePhysicsControllers, createCapacityQueueController, createPortalController, createDependencyGateController, createServiceLevelController, createServiceResourcePoolController } from "./stream/physics/PhysicsControllers";
 import { processChrome } from "./recipes/processChrome";
-import { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, createProcessJourneyLedger, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney } from "./recipes/physics";
-export { BuiltInPhysicsEngineAdapter, CollisionSwarmChart, EventDropChart, GauntletChart, GaltonBoardChart, GuantletChart, PhysicalFlowChart, PhysicsCustomChart, PhysicsPileChart, PhysicsPipelineStore, PhysicsSedimentAccumulator, ProcessFlowChart, absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics, capacitatedRegion, chargeGateRegion, collidersFromScales, compilePhysicsEncoding, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createDefaultPhysicsEngineAdapter, createPortalController, createPhysicsEncodingLayout, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, evaluatePhysicsBodyBudget, processChrome, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, planGauntletPropertyWork, membraneRegion, physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, replaceGauntletNegative, routeSurfaceRegion, sedimentBake, sedimentHeightfield, spawnFromTokens, stageTargetInVolume, updateProcessJourney, NamedStreamPhysicsFrame as StreamPhysicsFrame };
+import { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, createProcessJourneyLedger, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney } from "./recipes/physics";
+export { BuiltInPhysicsEngineAdapter, CollisionSwarmChart, EventDropChart, GauntletChart, GaltonBoardChart, GuantletChart, PacketFlowChart, PhysicalFlowChart, PhysicsCustomChart, PhysicsPileChart, UnitPileChart, PhysicsPipelineStore, PhysicsSedimentAccumulator, ProcessFlowChart, absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics, capacitatedRegion, chargeGateRegion, collidersFromScales, compilePhysicsEncoding, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createDefaultPhysicsEngineAdapter, createPortalController, createPhysicsEncodingLayout, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, evaluatePhysicsBodyBudget, processChrome, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, planGauntletPropertyWork, membraneRegion, physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, replaceGauntletNegative, resolveGauntletTerminalState, resolveGauntletTerminalStates, routeSurfaceRegion, sedimentBake, sedimentHeightfield, spawnFromTokens, stageTargetInVolume, updateProcessJourney, NamedStreamPhysicsFrame as StreamPhysicsFrame };
 export default StreamPhysicsFrame;
 export type { CollisionSwarmChartProps } from "./charts/physics/CollisionSwarmChart";
 export type { EventDropChartProps } from "./charts/physics/EventDropChart";
 export * from "./charts/physics/CrucibleChart";
+export type { GauntletTerminalOptions } from "./charts/physics/gauntletTerminal";
+export type { PhysicsDestinationZone, PhysicsStageColliderOptions, PhysicsStageGeography, PhysicsStageGeographyOptions, PhysicsZone } from "./recipes/physicsStageGeography";
 export type { GauntletChartProps, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectState, GauntletPropertyForceContext, GauntletPropertyDefinition, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions } from "./charts/physics/GauntletChart";
 export type { PhysicsProcessBodyGroup, PhysicsProcessBoundaryOptions, PhysicsProcessStage } from "./charts/physics/physicsProcessPrimitives";
 export type { GaltonBoardChartProps, GaltonBoardReferenceLine } from "./charts/physics/GaltonBoardChart";
-export type { PhysicalFlowChartProps } from "./charts/physics/PhysicalFlowChart";
+export type { PacketFlowChartProps, PhysicalFlowChartProps } from "./charts/physics/PacketFlowChart";
 export type { ProcessFlowChartProps, ProcessFlowProjectionMetadata, ProcessFlowStageDef } from "./charts/physics/ProcessFlowChart";
 export type { PhysicsCustomChartProps, PhysicsCustomLayout, PhysicsCustomLayoutContext, PhysicsCustomLayoutResult, PhysicsCustomSpawnDatumResult } from "./charts/physics/PhysicsCustomChart";
-export type { PhysicsPileChartProps } from "./charts/physics/PhysicsPileChart";
+export type { UnitPileChartProps, PhysicsPileChartProps } from "./charts/physics/UnitPileChart";
 export type { CompilePhysicsEncodingOptions, CreatePhysicsEncodingLayoutOptions, PhysicsAccessibleEncoding, PhysicsAppearanceEncoding, PhysicsDynamicsEncoding, PhysicsEncoding, PhysicsEncodingAccessor, PhysicsEncodingCompilation, PhysicsEncodingConstant, PhysicsEncodingDefaults, PhysicsEncodingLayoutExtension, PhysicsKinematicsEncoding, PhysicsPlacementEncoding, PhysicsProcessEncoding, PhysicsTimeEncoding, ResolvedPhysicsEncodingRow } from "./charts/physics/physicsEncoding";
 export type { PhysicsChartLayout, CollisionSwarmPhysicsOptions, CollisionSwarmProjectionMetadata, EventDropWindowOptions, EventDropPhysicsOptions, GaltonBoardProjectionMetadata, GaltonBoardPhysicsOptions, PhysicalFlowCoordinateMode, PhysicalFlowOptions, PhysicalFlowPathConstraint, PhysicalFlowPoint, PhysicalFlowProjectionMetadata, PhysicalFlowRawPath, PhysicsPileOptions, ProcessFlowPhysicsOptions } from "./charts/physics/physicsChartUtils";
 export type { CapacityQueueAbandonedInfo, CapacityQueueAgeSummary, CapacityQueueBlockedInfo, CapacityQueueControllerOptions, CapacityQueueProcessedInfo, CapacityQueueSnapshot, CapacityQueueVisitInfo, CapacityQueueWindowSnapshot, ComposedPhysicsControllers, DependencyGateController, DependencyGateOptions, DependencyGateSnapshot, PhysicsController, PhysicsControllerTickContext, ServiceLevelCaseInfo, ServiceLevelCaseState, ServiceLevelController, ServiceLevelControllerOptions, ServiceLevelSnapshot, ServiceResourceAssignment, ServiceResourceDefinition, ServiceResourcePoolController, ServiceResourcePoolOptions, ServiceResourcePoolSnapshot } from "./stream/physics/PhysicsControllers";

package/dist/components/semiotic-recipes-core.d.ts

@@ -7,6 +7,7 @@
  */
 export { waffleLayout, allocateCells } from "./recipes/waffle";
 export { unitize, unitizeRange } from "./recipes/unitize";
+export type { PhysicsDestinationZone, PhysicsStageColliderOptions, PhysicsStageGeography, PhysicsStageGeographyOptions, PhysicsZone } from "./recipes/physicsStageGeography";
 export type { UnitSign, RangeUnitSign, UnitizeOptions, UnitizeResult, UnitizeRangeResult, } from "./recipes/unitize";
 export { generateTokens, layoutTokenGrid, normalizeTokenEncoding, diagnoseTokenEncoding, suggestTokenEncoding, tokenTaskIntentToCapabilityIntents, } from "./recipes/tokenEncoding";
 export type { TokenType, TokenSemantics, TokenCountStrategy, TokenLayout, TokenLabelPolicy, TokenTaskIntent, TokenCapabilityIntent, TokenEncoding, TokenGeneratorInput, VisualToken, TokenDiagnosticCode, TokenDiagnostic, TokenDiagnosticsContext, TokenSet, TokenGridOptions, PositionedToken, TokenEncodingSuggestion, SuggestTokenEncodingInput, } from "./recipes/tokenEncoding";
@@ -17,6 +18,10 @@ export { calendarLayout } from "./recipes/calendar";
 export type { CalendarConfig } from "./recipes/calendar";
 export { isometricLandmarkLayout, selectIsometricLandmarks, DEFAULT_ISOMETRIC_SPRITE_SIZES, } from "./recipes/isometricLandmarks";
 export type { IsometricLandmarkConfig, IsometricLandmarkTile, IsometricTerrainCell, IsometricTerrainKind, LandmarkKind, } from "./recipes/isometricLandmarks";
+export { geographicGridLayout, gridifyGeographicPoints, } from "./recipes/geographicGrid";
+export type { GeographicGridConfig, GeographicGridInput, GeographicGridShape, GeographicGridSource, GridifiedGeographicPoint, GridifyGeographicPointsOptions, } from "./recipes/geographicGrid";
+export { geographicDotGridLayout, sampleGeographicDotGrid, } from "./recipes/geographicDotGrid";
+export type { GeographicDotGridAccessor, GeographicDotGridConfig, GeographicDotGridDatum, GeographicDotGridSampleOptions, GeographicDotGridShape, } from "./recipes/geographicDotGrid";
 export { flextreeLayout } from "./recipes/flextree";
 export type { FlextreeConfig } from "./recipes/flextree";
 export { dagreLayout } from "./recipes/dagre";
@@ -89,7 +94,7 @@ export { forceLayout, mulberry32 } from "./recipes/forceLayout";
 export type { ForceLayoutOptions } from "./recipes/forceLayout";
 export { forceLayoutAsync } from "./recipes/forceLayoutAsync";
 export type { ForceLayoutAsyncOptions } from "./recipes/forceLayoutAsync";
-export { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createPortalController, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, comparePhysicsTrace, forceFieldRegion, processChrome, galtonPegs, groupCompletionRows, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney, } from "./recipes/physics";
+export { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createPortalController, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, comparePhysicsTrace, forceFieldRegion, processChrome, galtonPegs, groupCompletionRows, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney, } from "./recipes/physics";
 export type { ArrivalReplayOptions, BandScale, BodyGroupSpec, BodyGroupSpecOptions, CapacityQueueAbandonedInfo, CapacityQueueAgeSummary, CapacityQueueBlockedInfo, CapacityQueueControllerOptions, CapacityQueueProcessedInfo, CapacityQueueSnapshot, CapacityQueueVisitInfo, CapacityQueueWindowSnapshot, ComposedPhysicsControllers, DependencyGateController, DependencyGateOptions, DependencyGateSnapshot, GaltonPegsOptions, ProcessChromeGroup, ProcessChromeLayout, ProcessChromeOptions, ProcessChromeStage, NumericScale, PhysicsBandColliderOptions, PhysicsColliderSpec, PhysicsPlotBounds, PhysicsQueuedSpawn, PhysicsReferenceBandSelector, PhysicsReferenceEnvelope, PhysicsReferenceEnvelopeOptions, PhysicsReferenceEnvelopePoint, PhysicsReferenceSampleGrid, PhysicsReferenceTrace, PhysicsScalarTraceSample, PhysicsScaleColliderOptions, PhysicsSedimentBinSnapshot, PhysicsSedimentColumn, PhysicsSedimentHeightfieldOptions, PhysicsSpawnPacingOptions, PhysicsTraceAccessor, PhysicsTraceComparison, PhysicsTraceComparisonOptions, PhysicsTraceComparisonPoint, PhysicsTraceComparisonStatus, PhysicsTraceInterpolation, PhysicsTraceOutsideDomain, ProcessMembraneDef, ProcessJourneyEntityState, ProcessJourneyLedger, ProcessJourneyRow, ProcessJourneyStage, ProcessJourneyUpdateOptions, ProcessRegionBaseOptions, ProcessStageRegionOptions, ProcessStageDef, ProcessVolumeLayout, ProcessVolumeLayoutOptions, ProcessVolumeMembraneBand, ProcessVolumePoint, ProcessVolumePolygon, ProcessVolumePolygonRole, PhysicsController, PhysicsControllerTickContext, ServiceLevelCaseInfo, ServiceLevelCaseState, ServiceLevelController, ServiceLevelControllerOptions, ServiceLevelSnapshot, ServiceResourceAssignment, ServiceResourceDefinition, ServiceResourcePoolController, ServiceResourcePoolOptions, ServiceResourcePoolSnapshot, ProcessVolumeShape, ProcessVolumeStageBand, RegionCountBucket, RegionCountMap, SedimentBakeOptions, SedimentBakeResult, SpawnFromTokensOptions, } from "./recipes/physics";
 export { orderByGroupDegree, arcLayout, arcPath, circularLayout, adjacencyMatrix, } from "./recipes/networkLayouts";
 export type { ArcLayoutOptions, CircularLayoutOptions, MatrixCell, AdjacencyMatrix, AdjacencyMatrixOptions, } from "./recipes/networkLayouts";

package/dist/components/server/renderEvidence.d.ts

@@ -18,7 +18,7 @@
 export interface RenderEvidence {
     /** HOC component name as passed to renderChart. */
     component: string;
-    frameType: "xy" | "ordinal" | "network" | "geo" | "physics";
+    frameType: "xy" | "ordinal" | "network" | "geo" | "physics" | "value";
     /** "ok" when the scene produced data marks; "empty" when it did not. */
     status: "ok" | "empty";
     /** True when zero data marks rendered. */

package/dist/components/server/renderToStaticSVG.d.ts

@@ -7,6 +7,7 @@ import { CHART_CONFIGS } from "./serverChartConfigs";
 import { type ThemeInput } from "./themeResolver";
 import { type RenderEvidence } from "./renderEvidence";
 import { type ThemeAwareProps, type StaticFrameProps, type FrameType } from "./staticSVGChrome";
+import { type ValueChartName } from "./staticValue";
 export declare function renderToStaticSVG(frameType: FrameType, props: StaticFrameProps): string;
 export declare function renderXYToStaticSVG(props: StreamXYFrameProps & ThemeAwareProps): string;
 export declare function renderOrdinalToStaticSVG(props: StreamOrdinalFrameProps & ThemeAwareProps): string;
@@ -18,7 +19,7 @@ export declare function renderGeoToStaticSVG(props: StreamGeoFrameProps & ThemeA
  * union — no second edit required, no silent drift like the CandlestickChart
  * gap that motivated this refactor.
  */
-type ChartName = keyof typeof CHART_CONFIGS;
+type ChartName = keyof typeof CHART_CONFIGS | ValueChartName;
 interface RenderChartOptions {
     /** Output format — currently only "svg" is synchronous */
     format?: "svg";

package/dist/components/server/serverChartConfigHeatmap.d.ts

@@ -0,0 +1,6 @@
+import type { ChartConfig } from "./serverChartConfigShared";
+/**
+ * Heatmap keeps cell border props separate from the generic primitive
+ * vocabulary. Convert them to the areaStyle consumed by both SVG paths.
+ */
+export declare const heatmap: ChartConfig;

package/dist/components/server/serverChartConfigNetworkStyles.d.ts

@@ -0,0 +1,12 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import { type PrimitiveStyleOverrides } from "../charts/shared/mergeShapeStyle";
+/**
+ * Compose user/frame node styling over a hierarchy HOC's built-in encoding,
+ * then apply chart-level primitives with their documented final precedence.
+ */
+export declare function composeHierarchyNodeStyle(baseNodeStyle: (d: Datum) => Record<string, unknown>, userNodeStyle: ((d: Datum) => Record<string, unknown> | undefined | null) | Record<string, unknown> | undefined | null, primitives?: PrimitiveStyleOverrides): (d: Datum) => Record<string, unknown>;
+/**
+ * Mirror ForceDirectedGraph's edge primitive resolution on the static path.
+ * An explicit edgeStyle remains the final escape hatch.
+ */
+export declare function resolveForceEdgeStyle(rest: Datum): any;

package/dist/components/server/serverChartConfigShared.d.ts

@@ -3,6 +3,7 @@ import type { ChartMode } from "../charts/shared/types";
 import type { ChartModeInput, ChartModeResult } from "../charts/shared/chartMode";
 import type { SemioticTheme } from "../store/ThemeStore";
 import type { ReactNode } from "react";
+import type { PrimitiveStyleOverrides } from "../charts/shared/mergeShapeStyle";
 export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
 export type ServerAccessorValue = string | number | boolean | Date | null | undefined;
 export type ServerAccessor = string | ((datum: Datum) => ServerAccessorValue);
@@ -41,6 +42,21 @@ export interface ChartConfig {
 export declare function accessorValue(accessor: ServerAccessor | undefined, fallback: string, d: Datum): ServerAccessorValue;
 export declare function numericValue(value: ServerAccessorValue): number;
 export declare function viridisColor(i: number, n: number): string;
+/**
+ * Pull the top-level primitive styling props out of a chart's raw props so a
+ * server config can overlay them with `mergeShapeStyle`, exactly as the HOC
+ * does before handing style functions to its frame.
+ *
+ * Every shape-drawing HOC applies `stroke`/`strokeWidth`/`opacity` last, so
+ * they win over `frameProps.*Style` returns and the HOC's own base style. A
+ * server config that builds its style function without this overlay silently
+ * drops the whole channel — the static SVG comes back byte-identical to an
+ * unstyled render while the canvas honors it.
+ *
+ * Keys are omitted when unset so `mergeShapeStyle` can return its input
+ * unchanged and callers keep the no-override fast path.
+ */
+export declare function primitiveStyleOverrides(rest: Datum): PrimitiveStyleOverrides;
 export declare function prepareConnectedScatterplotData(data: ServerChartData, rest: Datum): {
     data: ServerChartData;
     orderMap: WeakMap<Datum, {

package/dist/components/server/serverChartConfigs.d.ts

@@ -49,11 +49,11 @@ export declare const CHART_CONFIGS: {
     GeoCustomChart: ChartConfig;
     GaltonBoardChart: ChartConfig;
     EventDropChart: ChartConfig;
-    PhysicsPileChart: ChartConfig;
+    UnitPileChart: ChartConfig;
     CollisionSwarmChart: ChartConfig;
     ProcessFlowChart: ChartConfig;
     GauntletChart: ChartConfig;
     CrucibleChart: ChartConfig;
-    PhysicalFlowChart: ChartConfig;
+    PacketFlowChart: ChartConfig;
     PhysicsCustomChart: ChartConfig;
 };

package/dist/components/server/serverChartConfigsPhysics.d.ts

@@ -1,7 +1,7 @@
 import { type ChartConfig } from "./serverChartConfigShared";
 export declare const galtonBoardChart: ChartConfig;
 export declare const eventDropChart: ChartConfig;
-export declare const physicsPileChart: ChartConfig;
+export declare const unitPileChart: ChartConfig;
 export declare const collisionSwarmChart: ChartConfig;
 export declare const processFlowChart: ChartConfig;
 export declare const gauntletChart: ChartConfig;
@@ -14,5 +14,5 @@ export declare const gauntletChart: ChartConfig;
  * therefore cannot alter this static semantic state.
  */
 export declare const crucibleChart: ChartConfig;
-export declare const physicalFlowChart: ChartConfig;
+export declare const packetFlowChart: ChartConfig;
 export declare const physicsCustomChart: ChartConfig;

package/dist/components/server/serverChartConfigsXY.d.ts

@@ -12,4 +12,3 @@ export declare const candlestickChart: ChartConfig;
 export declare const scatterplot: ChartConfig;
 export declare const quadrantChart: ChartConfig;
 export declare const connectedScatterplot: ChartConfig;
-export declare const heatmap: ChartConfig;

package/dist/components/server/staticLegend.d.ts

@@ -8,6 +8,7 @@ import * as React from "react";
 import type { SemioticTheme } from "../store/ThemeStore";
 import type { Datum } from "../charts/shared/datumTypes";
 import type { CategoricalLegendConfig, GradientLegendConfig, LegendGroup, LegendLayout } from "../types/legendTypes";
+import { type AxisChromeInput } from "../legendLayout";
 interface LegendItemLayout {
     category: string;
     width: number;
@@ -51,6 +52,11 @@ export interface StaticLegendConfig {
     reservedWidth?: number;
     /** Optional id namespace used for generated SVG ids */
     idPrefix?: string;
+    /**
+     * Axis chrome on the legend's side, so a top/bottom legend clears the tick
+     * labels instead of drawing on them. Mirrors `renderLegendFromConfig`.
+     */
+    axisChrome?: AxisChromeInput;
 }
 export interface StaticLegendGroupsConfig extends Omit<StaticLegendConfig, "categories" | "colorScheme"> {
     legendGroups: LegendGroup[];

package/dist/components/server/staticSVGChrome.d.ts

@@ -7,12 +7,12 @@ import type { StreamGeoFrameProps } from "../stream/geoTypes";
 import type { PhysicsSettledSVGOptions } from "../stream/physics/PhysicsSettledSVG";
 import type { PhysicsPipelineStore, PhysicsQueuedSpawn } from "../stream/physics/PhysicsPipelineStore";
 import type { OrdinalPipelineStore } from "../stream/OrdinalPipelineStore";
-import type { RenderEvidence } from "./renderEvidence";
 import { resolveTheme, type ThemeInput } from "./themeResolver";
 import type { SemioticTheme } from "../store/ThemeStore";
 import * as React from "react";
 import { type AxisExtentMode } from "../charts/shared/axisExtent";
-export type FrameType = RenderEvidence["frameType"];
+import { type AxisChromeInput } from "../legendLayout";
+export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
 export type StaticPhysicsFrameProps = PhysicsSettledSVGOptions & {
     config?: ConstructorParameters<typeof PhysicsPipelineStore>[0];
     initialSpawns?: PhysicsQueuedSpawn[];
@@ -55,6 +55,11 @@ type LegendPosition = "right" | "left" | "top" | "bottom";
 type StaticLegendHostProps = ThemeAwareProps & {
     legend?: unknown;
     colorScheme?: string | string[] | Record<string, string>;
+    /**
+     * Bottom-axis chrome, so a bottom legend is placed and reserved outside the
+     * tick labels. Frames without a horizontal axis omit it and keep a 0 gutter.
+     */
+    axisChrome?: AxisChromeInput;
 };
 /**
  * The client HOCs reserve a minimum legend gutter before layout. The static
@@ -80,6 +85,7 @@ export declare function reserveStaticLegendMargin(margin: {
     legendLayout?: LegendLayout;
     minimumMargin?: number;
     preserveExplicitMargin?: boolean;
+    axisChrome?: AxisChromeInput;
 }): void;
 export declare function reserveLegendConfigMargin(margin: {
     top: number;
@@ -95,6 +101,7 @@ export declare function reserveLegendConfigMargin(margin: {
     legendLayout?: LegendLayout;
     minimumMargin?: number;
     preserveExplicitMargin?: boolean;
+    axisChrome?: AxisChromeInput;
 }): void;
 export declare function renderLegendConfig(legend: unknown, options: {
     theme: ReturnType<typeof resolveTheme>;
@@ -110,6 +117,7 @@ export declare function renderLegendConfig(legend: unknown, options: {
     legendLayout?: LegendLayout;
     idPrefix?: string;
     reservedWidth?: number;
+    axisChrome?: AxisChromeInput;
 }): React.ReactNode;
 /** Reserve the plot gutter for either a supplied legend config or categories. */
 export declare function reserveFrameLegendMargin(margin: {

package/dist/components/server/staticValue.d.ts

@@ -0,0 +1,8 @@
+import type { Datum } from "../charts/shared/datumTypes";
+import { type EvidenceSink } from "./renderEvidence";
+export declare function renderBigNumberToStaticSVG(props: Datum, sink?: EvidenceSink): string;
+export declare const VALUE_RENDERERS: {
+    readonly BigNumber: typeof renderBigNumberToStaticSVG;
+};
+export type ValueChartName = keyof typeof VALUE_RENDERERS;
+export declare function renderValueChart(component: ValueChartName, props: Datum, sink?: EvidenceSink): string;

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

@@ -0,0 +1,10 @@
+import type { GeoPipelineConfig } from "./geoTypes";
+/**
+ * `fitPadding` is applied to both sides of the plot, so 0.5 would leave a
+ * zero-sized extent (and a clipped globe with radius zero). Normalize nullish
+ * values at the public config boundary, and reject invalid values before they
+ * can reach d3 with a negative or non-finite projection extent.
+ */
+export declare function normalizeFitPadding(value: unknown): number;
+export declare function normalizeInitialGeoPipelineConfig(config: GeoPipelineConfig): GeoPipelineConfig;
+export declare function normalizeGeoPipelineConfigUpdate(config: Partial<GeoPipelineConfig>): Partial<GeoPipelineConfig>;

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

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 import type { LegendLayout, LegendValue } from "../types/legendTypes";
+import { type AxisChromeInput } from "../legendLayout";
 export interface LegendRenderConfig {
     legend: LegendValue;
     totalWidth: number;
@@ -22,6 +23,13 @@ export interface LegendRenderConfig {
     legendHighlightedCategory?: string | null;
     legendIsolatedCategories?: Set<string>;
     legendInteraction?: string;
+    /**
+     * Chrome drawn by the **bottom** axis, so a bottom legend can be placed
+     * outside it instead of on top of the tick labels. Omit for frames with no
+     * horizontal axis (network, geo) — the gutter resolves to 0. Top legends do
+     * not auto-measure; see `LegendLayout.axisGutter`.
+     */
+    axisChrome?: AxisChromeInput;
 }
 /**
  * Renders a legend (categorical, gradient, or custom ReactNode) inside an SVG overlay.

package/dist/components/stream/physics/PhysicsEvidence.d.ts

@@ -9,6 +9,31 @@ export interface PhysicsEvidenceBinCount {
     secondaryLabel?: string;
     observed?: number;
 }
+/**
+ * Where every charged body ended up.
+ *
+ * Physics charts all share one deep structure — a charge enters, an apparatus
+ * routes it, and it comes to rest in destinations — so they all owe the same
+ * invariant: every body that entered is accounted for in exactly one place.
+ * That invariant is this family's "bars start at zero": it is what makes a
+ * settled projection an auditable reading rather than a claim about a movie.
+ *
+ * Supply `charge` (the total the chart says entered) and the evidence reports
+ * whether the world can still account for it.
+ */
+export interface PhysicsSettledLedger {
+    /** Total the chart claims entered the apparatus. */
+    charge: number;
+    /** Bodies live in the world when it came to rest. */
+    live: number;
+    /** Bodies the queue still owes and never admitted. */
+    queued: number;
+    /** Bodies retired into sediment by the body budget. */
+    sedimented: number;
+    /** `charge - (live + queued + sedimented)`. Non-zero means bodies vanished. */
+    unaccounted: number;
+    balanced: boolean;
+}
 export interface PhysicsSettledEvidence {
     bodyCount: number;
     sleepingCount: number;
@@ -16,10 +41,22 @@ export interface PhysicsSettledEvidence {
     stepsRun: number;
     seed: number;
     binCounts: PhysicsEvidenceBinCount[];
+    /** Spawns still owed by the queue. Non-zero in a settled scene is a defect. */
+    queuedCount: number;
+    /** Bodies the body budget retired into sediment. */
+    sedimentedCount: number;
+    ledger?: PhysicsSettledLedger;
+    warnings: string[];
 }
 export interface PhysicsSettledEvidenceOptions {
     bodies?: PhysicsBodyState[];
     projectionRows?: PhysicsSettledProjectionRow[];
     stepsRun?: number;
+    /**
+     * Total bodies the chart claims entered the apparatus. Pass it when the chart
+     * knows its own charge (a unitized total, a row count) to enable the ledger
+     * check. Omit it and the ledger is simply absent — never guessed.
+     */
+    charge?: number;
 }
 export declare function buildPhysicsSettledEvidence(snapshot: PhysicsPipelineSnapshot, options?: PhysicsSettledEvidenceOptions): PhysicsSettledEvidence;