semiotic 3.7.5 → 3.8.0

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

@@ -1,47 +1,8 @@
 /**
  * Recipes entry point — curated layout functions for use with `XYCustomChart`.
  *
- * Import from "semiotic/recipes" instead of the full bundle. Recipes are
- * pure CustomLayout functions that emit standard SceneNodes; they get hit
- * testing, transitions, decay, theme cascade, and SSR for free.
+ * Import from "semiotic/recipes" for the public mixed facade that includes both
+ * pure layout algorithms and React composition helpers from `semiotic/recipes/react`.
  */
-export { waffleLayout } from "./recipes/waffle";
-export type { WaffleConfig } from "./recipes/waffle";
-export { calendarLayout } from "./recipes/calendar";
-export type { CalendarConfig } from "./recipes/calendar";
-export { flextreeLayout } from "./recipes/flextree";
-export type { FlextreeConfig } from "./recipes/flextree";
-export { dagreLayout } from "./recipes/dagre";
-export type { DagreConfig } from "./recipes/dagre";
-export { lineageDagLayout } from "./recipes/lineageDag";
-export type { LineageDagConfig, LineageLod, LineageStoreSlot } from "./recipes/lineageDag";
-export { mermaidDagLayout } from "./recipes/mermaidDag";
-export type { MermaidDagConfig } from "./recipes/mermaidDag";
-export { packedClusterMatrix } from "./recipes/packedClusterMatrix";
-export type { PackedClusterMatrixConfig } from "./recipes/packedClusterMatrix";
-export { marimekkoLayout } from "./recipes/marimekko";
-export type { MarimekkoConfig } from "./recipes/marimekko";
-export { bulletLayout } from "./recipes/bullet";
-export type { BulletConfig } from "./recipes/bullet";
-export { parallelCoordinatesLayout } from "./recipes/parallelCoordinates";
-export type { ParallelCoordinatesConfig } from "./recipes/parallelCoordinates";
-export { annotationLayout } from "./recipes/annotationLayout";
-export type { AnnotationLayoutConfig, AnnotationLayoutOptions, AutoPlaceAnnotations, AutoPlaceAnnotationsConfig, AnnotationCohesion, AnnotationAudience, } from "./recipes/annotationLayout";
-export { annotationDensity, annotationBudget, DEFAULT_AREA_PER_ANNOTATION } from "./recipes/annotationDensity";
-export type { AnnotationDensityConfig, AnnotationDensityOptions, AnnotationDensityResult, } from "./recipes/annotationDensity";
-export type { CustomLayout, LayoutContext, LayoutResult, } from "./stream/customLayout";
-export type { NetworkCustomLayout, NetworkLayoutContext, NetworkLayoutResult, NetworkHtmlMark, } from "./stream/networkCustomLayout";
-export type { OrdinalCustomLayout, OrdinalLayoutContext, OrdinalLayoutResult, } from "./stream/ordinalCustomLayout";
-export { shade, makeShade, readField, groupBy } from "./recipes/recipeUtils";
-export { dimFor, matchesHighlight, signatureKey, LayoutCache } from "./recipes/recipeUtils";
-export type { DimOptions, HighlightMatch } from "./recipes/recipeUtils";
-export { symbolPathString, symbolRadius, symbolExtent, SYMBOL_SEQUENCE } from "./stream/symbolPath";
-export type { NetworkSymbolName } from "./stream/symbolPath";
-export { roundedEnclosure, boundsOf, bandLabel, markCallout } from "./recipes/recipeChrome";
-export type { RoundedEnclosureProps, BandLabelProps, MarkCalloutProps, CalloutConnector, } from "./recipes/recipeChrome";
-export { legendGroupsFrom } from "./recipes/recipeLegend";
-export type { LegendGroupsInput } from "./recipes/recipeLegend";
-export { useCustomLayoutSelection } from "./stream/customLayoutSelection";
-export type { CustomLayoutSelection } from "./stream/customLayoutSelection";
-export { buildTooltipEntries, extractTooltipDatum, formatTooltipValue, } from "./recipes/customTooltip";
-export type { CustomTooltipEntry, CustomTooltipEntryOptions, } from "./recipes/customTooltip";
+export * from "./semiotic-recipes-core";
+export * from "./semiotic-recipes-react";

package/dist/components/semiotic-server-edge.d.ts

@@ -0,0 +1,8 @@
+export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG, renderGeoToStaticSVG, renderChart, renderChartWithEvidence, renderDashboard, } from "./server/renderToStaticSVG";
+export { generateFrameSVGs, generatePhysicsFrameSVGs, generateFrameSequence } from "./server/animatedGif";
+export type { RenderEvidence } from "./server/renderEvidence";
+export type { DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
+export type { LegendLayout } from "./types/legendTypes";
+export type { AnimatedGifOptions, PhysicsGifFrameProps, PhysicsGifOptions, } from "./server/animatedGif";
+export { resolveTheme, themeStyles } from "./server/themeResolver";
+export type { ThemeInput } from "./server/themeResolver";

package/dist/components/semiotic-server-node.d.ts

@@ -0,0 +1,5 @@
+export * from "./semiotic-server-edge";
+export { renderToImage, } from "./server/renderToStaticSVG";
+export type { RenderToImageOptions } from "./server/renderToStaticSVG";
+export { renderToAnimatedGif, renderPhysicsToAnimatedGif, } from "./server/animatedGif";
+export type { AnimatedGifOptions, PhysicsGifFrameProps, PhysicsGifOptions } from "./server/animatedGif";

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

@@ -2,7 +2,7 @@ export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, rende
 export type { RenderEvidence } from "./server/renderEvidence";
 export type { RenderToImageOptions, DashboardChart, DashboardLayout, RenderDashboardOptions, } from "./server/renderToStaticSVG";
 export type { LegendLayout } from "./types/legendTypes";
-export { renderToAnimatedGif, generateFrameSVGs, generateFrameSequence } from "./server/animatedGif";
-export type { AnimatedGifOptions } from "./server/animatedGif";
+export { renderToAnimatedGif, renderPhysicsToAnimatedGif, generateFrameSVGs, generatePhysicsFrameSVGs, generateFrameSequence } from "./server/animatedGif";
+export type { AnimatedGifOptions, PhysicsGifFrameProps, PhysicsGifOptions } from "./server/animatedGif";
 export { resolveTheme, themeStyles } from "./server/themeResolver";
 export type { ThemeInput } from "./server/themeResolver";

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

@@ -0,0 +1,53 @@
+/**
+ * semiotic/themes — Named theme presets for Semiotic charts.
+ *
+ * Each theme provides light and dark mode variants as full SemioticTheme objects.
+ * Use with ThemeProvider: `<ThemeProvider theme={TUFTE_LIGHT} />` or by name:
+ * `<ThemeProvider theme="tufte" />` / `<ThemeProvider theme="tufte-dark" />`.
+ *
+ * Also exports `themeToCSS()` and `themeToTokens()` for serialization.
+ */
+import type { SemioticTheme } from "./store/ThemeStore";
+import { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL } from "./store/ThemeStore";
+export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL };
+export type { SemioticTheme };
+export declare const PASTELS_LIGHT: SemioticTheme;
+export declare const PASTELS_DARK: SemioticTheme;
+export declare const BI_TOOL_LIGHT: SemioticTheme;
+export declare const BI_TOOL_DARK: SemioticTheme;
+export declare const ITALIAN_LIGHT: SemioticTheme;
+export declare const ITALIAN_DARK: SemioticTheme;
+export declare const TUFTE_LIGHT: SemioticTheme;
+export declare const TUFTE_DARK: SemioticTheme;
+export declare const JOURNALIST_LIGHT: SemioticTheme;
+export declare const JOURNALIST_DARK: SemioticTheme;
+export declare const PLAYFUL_LIGHT: SemioticTheme;
+export declare const PLAYFUL_DARK: SemioticTheme;
+/**
+ * IBM Carbon Design System categorical palette (14 colors).
+ * Full palette for data-dense visualizations; themes use the first 4.
+ */
+export declare const CARBON_CATEGORICAL_14: string[];
+/**
+ * IBM Carbon alert palette — danger, warning, success, info.
+ */
+export declare const CARBON_ALERT: {
+    readonly danger: "#da1e28";
+    readonly warning: "#f1c21b";
+    readonly success: "#24a148";
+    readonly info: "#0043ce";
+};
+export declare const CARBON_LIGHT: SemioticTheme;
+export declare const CARBON_DARK: SemioticTheme;
+/** All named theme presets, keyed by slug. */
+export declare const THEME_PRESETS: Record<string, SemioticTheme>;
+/** All valid named theme strings for ThemeProvider. */
+export type ThemePresetName = keyof typeof THEME_PRESETS;
+/**
+ * Resolve a theme preset name to a SemioticTheme object.
+ * Returns undefined if the name is not recognized.
+ */
+export declare function resolveThemePreset(name: string): SemioticTheme | undefined;
+export { themeToCSS, themeToTokens } from "./store/themeSerialization";
+export { designTokensToTheme } from "./store/designTokens";
+export type { DesignTokensToThemeOptions } from "./store/designTokens";

package/dist/components/semiotic-themes-react.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Themes React-only surface.
+ */
+export { ThemeProvider, useTheme } from "./ThemeProvider";

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

@@ -1,83 +1,13 @@
-import type { Datum } from "./charts/shared/datumTypes";
 /**
- * semiotic/themes — Named theme presets for Semiotic charts.
+ * semiotic/themes — Named theme presets and serialization for Semiotic charts.
  *
  * Each theme provides light and dark mode variants as full SemioticTheme objects.
- * Use with ThemeProvider: `<ThemeProvider theme={TUFTE_LIGHT} />` or by name:
- * `<ThemeProvider theme="tufte" />` / `<ThemeProvider theme="tufte-dark" />`.
+ * Use with ThemeProvider (from "semiotic/themes/react" or "semiotic"):
+ * `<ThemeProvider theme={TUFTE_LIGHT} />` or by name `<ThemeProvider theme="tufte" />`.
  *
  * Also exports `themeToCSS()` and `themeToTokens()` for serialization.
- */
-import type { SemioticTheme } from "./store/ThemeStore";
-import { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL } from "./store/ThemeStore";
-export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL };
-export type { SemioticTheme };
-export declare const PASTELS_LIGHT: SemioticTheme;
-export declare const PASTELS_DARK: SemioticTheme;
-export declare const BI_TOOL_LIGHT: SemioticTheme;
-export declare const BI_TOOL_DARK: SemioticTheme;
-export declare const ITALIAN_LIGHT: SemioticTheme;
-export declare const ITALIAN_DARK: SemioticTheme;
-export declare const TUFTE_LIGHT: SemioticTheme;
-export declare const TUFTE_DARK: SemioticTheme;
-export declare const JOURNALIST_LIGHT: SemioticTheme;
-export declare const JOURNALIST_DARK: SemioticTheme;
-export declare const PLAYFUL_LIGHT: SemioticTheme;
-export declare const PLAYFUL_DARK: SemioticTheme;
-/**
- * IBM Carbon Design System categorical palette (14 colors).
- * Full palette for data-dense visualizations; themes use the first 4.
- */
-export declare const CARBON_CATEGORICAL_14: string[];
-/**
- * IBM Carbon alert palette — danger, warning, success, info.
- */
-export declare const CARBON_ALERT: {
-    readonly danger: "#da1e28";
-    readonly warning: "#f1c21b";
-    readonly success: "#24a148";
-    readonly info: "#0043ce";
-};
-export declare const CARBON_LIGHT: SemioticTheme;
-export declare const CARBON_DARK: SemioticTheme;
-/** All named theme presets, keyed by slug. */
-export declare const THEME_PRESETS: Record<string, SemioticTheme>;
-/** All valid named theme strings for ThemeProvider. */
-export type ThemePresetName = keyof typeof THEME_PRESETS;
-/**
- * Resolve a theme preset name to a SemioticTheme object.
- * Returns undefined if the name is not recognized.
- */
-export declare function resolveThemePreset(name: string): SemioticTheme | undefined;
-/**
- * Convert a SemioticTheme to a CSS custom properties string.
- * Useful for SSR or generating stylesheet content.
- *
- * @param theme - A SemioticTheme object
- * @param selector - CSS selector to scope the variables (default: `:root`)
- * @returns CSS string with custom properties
- *
- * @example
- * ```ts
- * const css = themeToCSS(TUFTE_LIGHT, ".my-charts")
- * // .my-charts {
- * //   --semiotic-bg: #fffff8;
- * //   --semiotic-text: #111111;
- * //   ...
- * // }
- * ```
- */
-export declare function themeToCSS(theme: SemioticTheme, selector?: string): string;
-/**
- * Convert a SemioticTheme to a design tokens JSON object.
- * Compatible with Style Dictionary / Design Token Community Group format.
  *
- * @example
- * ```ts
- * const tokens = themeToTokens(TUFTE_LIGHT)
- * // { semiotic: { bg: { $value: "#fffff8", $type: "color" }, ... } }
- * ```
+ * This entry is React-free (RSC/edge-safe) — it re-exports the theme core.
+ * The `ThemeProvider`/`useTheme` React surface lives in "semiotic/themes/react".
  */
-export declare function themeToTokens(theme: SemioticTheme): Datum;
-export { designTokensToTheme } from "./store/designTokens";
-export type { DesignTokensToThemeOptions } from "./store/designTokens";
+export * from "./semiotic-themes-core";

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

@@ -0,0 +1,46 @@
+/**
+ * semiotic/utils — Shared utilities, ThemeProvider, and data helpers.
+ *
+ * Lightweight entry point for consumers that need the theme system,
+ * format utilities, data transforms, or color constants without pulling
+ * in any chart type bundles. Import from "semiotic/utils" instead of
+ * "semiotic" to keep bundle size minimal.
+ */
+export type { SemioticTheme } from "./store/ThemeStore";
+export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL, } from "./store/ThemeStore";
+export { themeToCSS, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT, } from "./semiotic-themes";
+export type { ThemePresetName } from "./semiotic-themes";
+export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils";
+export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
+export { createHatchPattern } from "./charts/shared/hatchPattern";
+export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
+export { validateProps } from "./charts/shared/validateProps";
+export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
+export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
+export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats } from "./charts/shared/auditMobileVisualization";
+export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
+export { describeChart, resolveCommunicativeAct, communicativeActForIntent } from "./ai/describeChart";
+export type { DescribeChartResult, DescribeChartOptions, DescribeLevel, CommunicativeAct, DescribeCapabilityContext } from "./ai/describeChart";
+export { buildNavigationTree, flattenVisible, countNodes } from "./ai/navigationTree";
+export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
+export { buildReaderGrounding } from "./ai/readerGrounding";
+export type { ChartReaderGrounding, ChartReaderGroundingOptions, ChartReaderGroundingIntent, PhysicsReaderGrounding, PhysicsReaderGroundingAggregate, PhysicsReaderGroundingAggregates, PhysicsReaderGroundingGeometry, PhysicsReaderGroundingInput, PhysicsReaderGroundingSediment, PhysicsReaderGroundingSimulation } from "./ai/readerGrounding";
+export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./charts/shared/auditAccessibility";
+export type { MobileAuditStatus, MobileAuditCategory, MobileAuditImpact, MobileVisualizationInteractionContract, MobileVisualizationLabelContract, MobileVisualizationCustomContract, MobileVisualizationContract, MobileVisualizationFinding, MobileVisualizationAuditResult, AuditMobileVisualizationOptions } from "./charts/shared/auditMobileVisualization";
+export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts/shared/responsiveRules";
+export { getHitRadius } from "./stream/hitTestUtils";
+export { unwrapDatum } from "./recipes/recipeUtils";
+export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
+export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
+export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
+export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
+export { exportChart } from "./export/exportChart";
+export { auditObservedScene } from "./ai/observedSceneAudit";
+export type { AuditObservedSceneInput, ObservedAuditFinding, ObservedSceneAuditResult } from "./ai/observedSceneAudit";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { RingBuffer } from "./realtime/RingBuffer";
+export { IncrementalExtent } from "./realtime/IncrementalExtent";
+export { normalizeTooltip, MultiPointTooltip } from "./Tooltip/Tooltip";
+export { sweepToAngles, valueToAngle, computeArcBoundingBox, } from "./charts/shared/radialGeometry";
+export type { SweepAngles, ArcBoundingBox } from "./charts/shared/radialGeometry";

package/dist/components/semiotic-utils-react.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Utilities React-only surface.
+ */
+export { ThemeProvider, useTheme } from "./ThemeProvider";
+export { useReducedMotion, useHighContrast } from "./stream/useMediaPreferences";

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

@@ -1,43 +1,7 @@
 /**
  * semiotic/utils — Shared utilities, ThemeProvider, and data helpers.
  *
- * Lightweight entry point for consumers that need the theme system,
- * format utilities, data transforms, or color constants without pulling
- * in any chart type bundles. Import from "semiotic/utils" instead of
- * "semiotic" to keep bundle size minimal.
+ * Import from "semiotic/utils" for the full utilities surface.
  */
-export { ThemeProvider, useTheme } from "./ThemeProvider";
-export type { SemioticTheme } from "./store/ThemeStore";
-export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL, } from "./store/ThemeStore";
-export { themeToCSS, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT, } from "./semiotic-themes";
-export type { ThemePresetName } from "./semiotic-themes";
-export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils";
-export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
-export { createHatchPattern } from "./charts/shared/hatchPattern";
-export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
-export { validateProps } from "./charts/shared/validateProps";
-export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
-export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
-export { describeChart, resolveCommunicativeAct, communicativeActForIntent } from "./ai/describeChart";
-export type { DescribeChartResult, DescribeChartOptions, DescribeLevel, CommunicativeAct, DescribeCapabilityContext } from "./ai/describeChart";
-export { buildNavigationTree, flattenVisible, countNodes } from "./ai/navigationTree";
-export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
-export { buildReaderGrounding } from "./ai/readerGrounding";
-export type { ChartReaderGrounding, ChartReaderGroundingOptions, ChartReaderGroundingIntent } from "./ai/readerGrounding";
-export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./charts/shared/auditAccessibility";
-export { getHitRadius } from "./stream/hitTestUtils";
-export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
-export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
-export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
-export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
-export { exportChart } from "./export/exportChart";
-export { fromVegaLite } from "./data/fromVegaLite";
-export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
-export { RingBuffer } from "./realtime/RingBuffer";
-export { IncrementalExtent } from "./realtime/IncrementalExtent";
-export { normalizeTooltip, MultiPointTooltip } from "./Tooltip/Tooltip";
-export { useReducedMotion, useHighContrast } from "./stream/useMediaPreferences";
-export { sweepToAngles, valueToAngle, computeArcBoundingBox, } from "./charts/shared/radialGeometry";
-export type { SweepAngles, ArcBoundingBox } from "./charts/shared/radialGeometry";
-export { useStreamStatus } from "./charts/shared/useStreamStatus";
-export type { StreamStatus, StreamStatusOptions, StreamStatusResult, } from "./charts/shared/useStreamStatus";
+export * from "./semiotic-utils-core";
+export * from "./semiotic-utils-react";

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

@@ -18,8 +18,16 @@ export { QuadrantChart } from "./charts/xy/QuadrantChart";
 export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
 export { CandlestickChart } from "./charts/xy/CandlestickChart";
 export { XYCustomChart } from "./charts/custom/XYCustomChart";
+export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
+export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./charts/shared/responsiveRules";
 export { useCustomLayoutSelection } from "./stream/customLayoutSelection";
 export type { CustomLayoutSelection } from "./stream/customLayoutSelection";
+export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
+export { hitTargetPoint, hitTargetRect, DEFAULT_HIT_RADIUS } from "./stream/hitTarget";
+export type { HitTargetPointProps, HitTargetRectProps } from "./stream/hitTarget";
+export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
+export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
+export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
 export type { CustomLayout, LayoutContext, LayoutResult } from "./stream/customLayout";
 export type { LineChartProps } from "./charts/xy/LineChart";

package/dist/components/semiotic.d.ts

@@ -1,7 +1,7 @@
 import StreamXYFrame from "./stream/StreamXYFrame";
 import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
 import StreamNetworkFrame from "./stream/StreamNetworkFrame";
-import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart } from "./charts";
+import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, responsiveRuleMatches, resolveResponsiveRules } from "./charts";
 import { LinkedCharts } from "./LinkedCharts";
 import { ThemeProvider, useTheme } from "./ThemeProvider";
 import { exportChart } from "./export/exportChart";
@@ -11,9 +11,14 @@ import { serializeSelections, deserializeSelections } from "./export/selectionSe
 import { fromVegaLite } from "./data/fromVegaLite";
 import { ChartErrorBoundary } from "./ChartErrorBoundary";
 import { ChartContainer } from "./ChartContainer";
+import { MobileChartContainer } from "./MobileChartContainer";
+import { SmallMultipleChart } from "./SmallMultipleChart";
+import { MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange } from "./MobileStandardControls";
 import { ChartGrid } from "./ChartGrid";
 import { CategoryColorProvider, useCategoryColors } from "./CategoryColors";
 import { ContextLayout } from "./ContextLayout";
+import { CircularBrush } from "./CircularBrush";
+import { DirectManipulationControl, VISUALIZATION_CONTROL_TYPES } from "./DirectManipulationControl";
 import { DetailsPanel } from "./DetailsPanel";
 import { Tooltip, MultiLineTooltip, normalizeTooltip } from "./Tooltip/Tooltip";
 import { RingBuffer } from "./realtime/RingBuffer";
@@ -23,18 +28,27 @@ import { RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram } from
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, MobileChartContainer, SmallMultipleChart, MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, CircularBrush, DirectManipulationControl, VISUALIZATION_CONTROL_TYPES, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern, responsiveRuleMatches, resolveResponsiveRules };
 export type { LegendLayout } from "./types/legendTypes";
-export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, SemanticGradientStop, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
-export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn, XYFrameAxisConfig, BandConfig } from "./stream/types";
+export type { DirectManipulationControlProps, VisualizationControlType } from "./DirectManipulationControl";
+export { createControlObservationAdapter, } from "./controls/controlContract";
+export { auditVisualizationControls } from "./controls/controlAudit";
+export type { ControlInputSource, ControlObservation, ControlObservationAdapterOptions, ControlObservationCallback, ControlObservationPhase, VisualizationControlDefinition, VisualizationControlValue, } from "./controls/controlContract";
+export type { AuditVisualizationControlsOptions, ControlAuditFinding, ControlAuditResult, ControlAuditStatus, } from "./controls/controlAudit";
+export type { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, SemanticGradientStop, DifferenceChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, ProcessSankeyProps, ProcessSankeyTick, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantsConfigOverride, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode, MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig, ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts";
+export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, SceneAccessibilityMetadata, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn, XYFrameAxisConfig, BandConfig } from "./stream/types";
 export type { StreamRendererFn } from "./stream/renderers/types";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
 export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
 export type { SelectionConfig, LinkedHoverProp, LinkedBrushProp } from "./charts/shared/types";
-export type { LinkedChartsProps } from "./LinkedCharts";
-export { useSelection, useSelectionActions, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
+export type { LinkedChartsProps, LegendInteractionMode } from "./LinkedCharts";
+export type { CircularBrushProps, CircularBrushValue } from "./CircularBrush";
+export { useSelection, useSelectionActions, useLinkedHover, useBrushSelection, useFilteredData, useLinkedChartsActive } from "./LinkedCharts";
 export { useCustomLayoutSelection } from "./stream/customLayoutSelection";
+export { useForceLayout } from "./charts/network/useForceLayout";
+export type { ForceLayoutStatus, UseForceLayoutResult } from "./charts/network/useForceLayout";
 export type { CustomLayoutSelection } from "./stream/customLayoutSelection";
+export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
 export type { UseSelectionOptions, UseSelectionResult, UseSelectionActionsResult, UseLinkedHoverOptions, UseLinkedHoverResult, UseBrushSelectionOptions, UseBrushSelectionResult } from "./LinkedCharts";
 export { useChartObserver } from "./LinkedCharts";
 export type { UseChartObserverOptions, UseChartObserverResult } from "./LinkedCharts";
@@ -50,9 +64,17 @@ export { AccessibleNavTree } from "./AccessibleNavTree";
 export type { AccessibleNavTreeProps } from "./AccessibleNavTree";
 export { buildNavigationTree } from "./ai/navigationTree";
 export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
+export { IntentMark } from "./ai/IntentMark";
+export type { IntentMarkProps } from "./ai/IntentMark";
+export { intentManifestFromRecipe, summarizeIntentManifest } from "./ai/intentManifest";
+export type { IntentManifest, IntentManifestFromRecipeOptions } from "./ai/intentManifest";
 export { useNavigationSync } from "./ai/useNavigationSync";
 export type { UseNavigationSyncOptions, UseNavigationSyncResult } from "./ai/useNavigationSync";
-export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
+export type { ChartContainerProps, ChartContainerHandle, ChartContainerMobileOptions, ChartNotification, ChartNotificationLevel, } from "./ChartContainer";
+export type { MobileChartChip, MobileChartContainerProps, MobileChartDetailMode, } from "./MobileChartContainer";
+export type { MobileStandardBrushControls, MobileStandardControlKind, MobileStandardControlLegendItem, MobileStandardControlRequest, MobileStandardControlsMode, MobileStandardControlsProps, MobileStandardLegendControls, MobileStandardZoomControls, UseMobileRangeControlsOptions, UseMobileRangeControlsResult, } from "./MobileStandardControls";
+export type { MobileVisualizationContract } from "./charts/shared/auditMobileVisualization";
+export type { SmallMultipleChartProps, SmallMultipleExtent, SmallMultipleItem, SmallMultipleRenderContext, SmallMultipleSharedExtent, } from "./SmallMultipleChart";
 export type { ChartGridProps } from "./ChartGrid";
 export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryColors";
 export type { ContextLayoutProps } from "./ContextLayout";
@@ -72,4 +94,10 @@ export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHi
 export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
 export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
 export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
+export { useSyncedPushData, syncPushBuffer } from "./charts/shared/useSyncedPushData";
+export type { SyncedPushHandle, SyncedPushDataOptions, PushIdAccessor, } from "./charts/shared/useSyncedPushData";
 export type { AnnotationProvenance, AnnotationSource, AnnotationActorKind, AnnotationBasis, AnnotationLifecycle, AnnotationFreshness, AnnotationStatus, AnnotationAnchor, Annotated, } from "./ai/annotationProvenance";
+export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
+export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";
+export { compileMotionEncoding, resolveMotionAccessor, resolveMotionAge, opacityFromAge, resolveMotionVector, deriveMotionVector } from "./charts/shared/motionEncoding";
+export type { MotionEncodingConstant, MotionEncodingAccessor, MotionTimeBasis, MotionTimeUnit, MotionCoordinateSpace, MotionTimeEncoding, MotionPlacementEncoding, MotionKinematicsEncoding, MotionProcessEncoding, MotionAccessibleEncoding, MotionEncoding, ResolvedMotionEncodingRow, MotionEncodingCompilation, CompileMotionEncodingOptions, ResolveMotionAgeOptions, ResolvedMotionAge, MotionAgeOpacityType, MotionAgeOpacityOptions, MotionPoint, ResolvedMotionVector } from "./charts/shared/motionEncoding";

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

@@ -1,5 +1,7 @@
 import type { Datum } from "../charts/shared/datumTypes";
 import type { SemioticTheme } from "../store/ThemeStore";
+import { type PhysicsPipelineConfig, type PhysicsQueuedSpawn, type PhysicsSpawnPacingOptions } from "../stream/physics/PhysicsPipelineStore";
+import { type PhysicsSettledSceneOptions } from "../stream/physics/PhysicsSettledScene";
 export interface AnimatedGifOptions {
     /** Frames per second (default 12) */
     fps?: number;
@@ -38,6 +40,30 @@ export interface AnimatedGifFrameConfig {
     /** Theme for styling */
     theme: SemioticTheme;
 }
+export interface PhysicsGifFrameProps extends Pick<PhysicsSettledSceneOptions, "bodyStyle" | "getBodyLabel"> {
+    config?: PhysicsPipelineConfig;
+    initialSpawns?: PhysicsQueuedSpawn[];
+    initialSpawnPacing?: PhysicsSpawnPacingOptions;
+    width?: number;
+    height?: number;
+    size?: [number, number];
+    theme?: SemioticTheme | string;
+    title?: string;
+    description?: string;
+    background?: string;
+    className?: string;
+    idPrefix?: string;
+}
+export interface PhysicsGifOptions extends Pick<AnimatedGifOptions, "fps" | "frameCount" | "loop" | "scale" | "background"> {
+    /** Total simulated seconds to render. Used when `frameCount` is omitted. */
+    durationSeconds?: number;
+    /** Fixed simulation steps advanced between rendered frames. Defaults to about `1 / fps`. */
+    stepsPerFrame?: number;
+    /** Fixed timestep used for each simulation step. Defaults to `config.fixedDt` or 1/120. */
+    stepDt?: number;
+    /** Include a frame after spawning at t=0 before advancing the simulation. */
+    includeInitialFrame?: boolean;
+}
 /**
  * Generate SVG strings for each animation frame.
  * This is the core logic shared between GIF export and client-side preview.
@@ -54,6 +80,15 @@ export declare function generateFrameSVGs(chartType: string, data: Datum[], prop
  * Each snapshot is passed directly to `renderChart()`.
  */
 export declare function generateFrameSequence(component: string, snapshots: Datum[], baseProps?: Datum): string[];
+/**
+ * Generate SVG frames by stepping a `PhysicsPipelineStore`.
+ *
+ * Unlike `generateFrameSVGs`, this does not slice data. It enqueues the supplied
+ * physics bodies once, advances the deterministic fixed-step simulation, and
+ * serializes each live snapshot. Use this for Galton boards, event-drop replay,
+ * piles, and custom physics scenes where sim time is the animation axis.
+ */
+export declare function generatePhysicsFrameSVGs(props: PhysicsGifFrameProps, options?: PhysicsGifOptions): string[];
 /**
  * Render a chart as an animated GIF.
  *
@@ -62,3 +97,4 @@ export declare function generateFrameSequence(component: string, snapshots: Datu
  * @returns Buffer containing the animated GIF
  */
 export declare function renderToAnimatedGif(chartType: string, data: Datum[], props: Datum, options?: AnimatedGifOptions): Promise<Buffer>;
+export declare function renderPhysicsToAnimatedGif(props: PhysicsGifFrameProps, options?: PhysicsGifOptions): Promise<Buffer>;

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";
+    frameType: "xy" | "ordinal" | "network" | "geo" | "physics";
     /** "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

@@ -1,44 +1,12 @@
 import type { Datum } from "../charts/shared/datumTypes";
-import type { LegendLayout } from "../types/legendTypes";
-/**
- * Server-side rendering of Semiotic charts to standalone SVG strings.
- *
- * Uses the shared SceneToSVG converters (same code used by Stream Frames
- * for SSR) plus PipelineStore / OrdinalPipelineStore / NetworkPipelineStore
- * for scene graph computation.
- *
- * Features:
- * - Theme inlining (resolve presets to concrete SVG styles)
- * - Legend rendering (categorical color swatches)
- * - Accessibility (title, desc, role="img")
- * - Grid lines
- * - Annotations (y-threshold, x-threshold, band, label, text, category-highlight)
- * - renderChart HOC-level API
- */
-import * as React from "react";
 import type { StreamXYFrameProps } from "../stream/types";
 import type { StreamNetworkFrameProps } from "../stream/networkTypes";
 import type { StreamOrdinalFrameProps } from "../stream/ordinalTypes";
 import type { StreamGeoFrameProps } from "../stream/geoTypes";
-import { type RenderEvidence } from "./renderEvidence";
-import { type ThemeInput } from "./themeResolver";
 import { CHART_CONFIGS } from "./serverChartConfigs";
-type FrameType = "xy" | "ordinal" | "network" | "geo";
-type StaticFrameProps = (StreamXYFrameProps | StreamNetworkFrameProps | StreamOrdinalFrameProps | StreamGeoFrameProps) & ThemeAwareProps;
-interface ThemeAwareProps {
-    theme?: ThemeInput;
-    showLegend?: boolean;
-    showGrid?: boolean;
-    annotations?: Datum[];
-    title?: string | React.ReactNode;
-    description?: string;
-    background?: string;
-    className?: string;
-    legendPosition?: "right" | "left" | "top" | "bottom";
-    legendLayout?: LegendLayout;
-    /** Prefix for SVG element IDs — used by renderDashboard to avoid collisions */
-    _idPrefix?: string;
-}
+import { type ThemeInput } from "./themeResolver";
+import { type RenderEvidence } from "./renderEvidence";
+import { type ThemeAwareProps, type StaticFrameProps, type FrameType } from "./staticSVGChrome";
 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;

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

@@ -0,0 +1,17 @@
+import type { Datum } from "../charts/shared/datumTypes";
+export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
+export interface ChartConfig {
+    frameType: FrameType;
+    /** Build frame props from HOC-level props */
+    buildProps: (data: any, colorBy: any, colorScheme: any, common: Datum, rest: Datum) => Datum;
+}
+export declare function accessorValue(accessor: any, fallback: string, d: Datum): any;
+export declare function numericValue(value: any): number;
+export declare function viridisColor(i: number, n: number): string;
+export declare function prepareConnectedScatterplotData(data: any, rest: Datum): {
+    data: any;
+    orderMap: WeakMap<Datum, {
+        idx: number;
+        total: number;
+    }>;
+};