semiotic 3.7.4 → 3.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (517) hide show
  1. package/CLAUDE.md +60 -15
  2. package/README.md +135 -24
  3. package/agent-skill/semiotic-charts/SKILL.md +146 -0
  4. package/ai/cli.js +133 -45
  5. package/ai/componentMetadata.cjs +6 -1
  6. package/ai/dist/mcp-server.js +1651 -154
  7. package/ai/examples.md +174 -0
  8. package/ai/schema.json +2934 -517
  9. package/ai/surface-manifest.json +200 -0
  10. package/ai/system-prompt.md +19 -3
  11. package/dist/components/Annotation.d.ts +4 -0
  12. package/dist/components/CategoryColors.d.ts +1 -1
  13. package/dist/components/ChartContainer.d.ts +91 -0
  14. package/dist/components/ChartGrid.d.ts +11 -1
  15. package/dist/components/CircularBrush.d.ts +61 -0
  16. package/dist/components/ContextLayout.d.ts +5 -1
  17. package/dist/components/DataSummaryContext.d.ts +1 -0
  18. package/dist/components/DirectManipulationControl.d.ts +63 -0
  19. package/dist/components/LinkedCharts.d.ts +3 -1
  20. package/dist/components/MobileAnnotationCalloutList.d.ts +13 -0
  21. package/dist/components/MobileChartContainer.d.ts +51 -0
  22. package/dist/components/MobileStandardControls.d.ts +68 -0
  23. package/dist/components/SmallMultipleChart.d.ts +84 -0
  24. package/dist/components/Tooltip/FlippingTooltip.d.ts +21 -0
  25. package/dist/components/ai/ChartRecipe.d.ts +16 -0
  26. package/dist/components/ai/IntentMark.d.ts +15 -0
  27. package/dist/components/ai/chartCapabilities.d.ts +8 -1
  28. package/dist/components/ai/chartCapabilityTypes.d.ts +42 -1
  29. package/dist/components/ai/chartClinic.d.ts +91 -0
  30. package/dist/components/ai/chartRecipeRegistry.d.ts +14 -0
  31. package/dist/components/ai/chartRecipes.d.ts +278 -0
  32. package/dist/components/ai/dataPitfallsBridge.d.ts +203 -0
  33. package/dist/components/ai/dataQualityBridge.d.ts +201 -0
  34. package/dist/components/ai/describeChart.d.ts +9 -0
  35. package/dist/components/ai/describeRecipeChart.d.ts +16 -0
  36. package/dist/components/ai/generativeChart.d.ts +170 -0
  37. package/dist/components/ai/intentManifest.d.ts +62 -0
  38. package/dist/components/ai/navigationTree.d.ts +3 -0
  39. package/dist/components/ai/observedSceneAudit.d.ts +72 -0
  40. package/dist/components/ai/readerGrounding.d.ts +83 -0
  41. package/dist/components/ai/recipeCapability.d.ts +8 -0
  42. package/dist/components/ai/recipeNavigation.d.ts +13 -0
  43. package/dist/components/ai/recipeSemantics.d.ts +11 -0
  44. package/dist/components/ai/repairChartConfig.d.ts +9 -0
  45. package/dist/components/ai/suggestCharts.d.ts +11 -1
  46. package/dist/components/charts/custom/GeoCustomChart.d.ts +48 -0
  47. package/dist/components/charts/custom/NetworkCustomChart.d.ts +22 -3
  48. package/dist/components/charts/custom/OrdinalCustomChart.d.ts +8 -2
  49. package/dist/components/charts/custom/XYCustomChart.d.ts +11 -2
  50. package/dist/components/charts/geo/DistanceCartogram.d.ts +1 -1
  51. package/dist/components/charts/geo/FlowMap.d.ts +1 -1
  52. package/dist/components/charts/geo/ProportionalSymbolMap.d.ts +1 -1
  53. package/dist/components/charts/geo/index.d.ts +2 -0
  54. package/dist/components/charts/index.d.ts +29 -1
  55. package/dist/components/charts/network/ChordDiagram.d.ts +1 -1
  56. package/dist/components/charts/network/CirclePack.d.ts +1 -1
  57. package/dist/components/charts/network/ForceDirectedGraph.d.ts +15 -5
  58. package/dist/components/charts/network/OrbitDiagram.d.ts +1 -1
  59. package/dist/components/charts/network/ProcessSankey.d.ts +1 -1
  60. package/dist/components/charts/network/SankeyDiagram.d.ts +1 -1
  61. package/dist/components/charts/network/TreeDiagram.d.ts +1 -1
  62. package/dist/components/charts/network/Treemap.d.ts +1 -1
  63. package/dist/components/charts/network/useForceLayout.d.ts +17 -0
  64. package/dist/components/charts/ordinal/BarChart.d.ts +1 -1
  65. package/dist/components/charts/ordinal/BoxPlot.d.ts +1 -1
  66. package/dist/components/charts/ordinal/DonutChart.d.ts +1 -1
  67. package/dist/components/charts/ordinal/DotPlot.d.ts +1 -1
  68. package/dist/components/charts/ordinal/FunnelChart.d.ts +1 -1
  69. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +1 -1
  70. package/dist/components/charts/ordinal/Histogram.d.ts +1 -1
  71. package/dist/components/charts/ordinal/PieChart.d.ts +1 -1
  72. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +1 -1
  73. package/dist/components/charts/ordinal/StackedBarChart.d.ts +1 -1
  74. package/dist/components/charts/ordinal/SwarmPlot.d.ts +8 -1
  75. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +1 -1
  76. package/dist/components/charts/ordinal/ViolinPlot.d.ts +1 -1
  77. package/dist/components/charts/physics/ChainReactionChart.d.ts +9 -0
  78. package/dist/components/charts/physics/CollisionSwarmChart.capability.d.ts +2 -0
  79. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +47 -0
  80. package/dist/components/charts/physics/EventDropChart.capability.d.ts +2 -0
  81. package/dist/components/charts/physics/EventDropChart.d.ts +53 -0
  82. package/dist/components/charts/physics/GaltonBoardChart.capability.d.ts +2 -0
  83. package/dist/components/charts/physics/GaltonBoardChart.d.ts +66 -0
  84. package/dist/components/charts/physics/GauntletChart.capability.d.ts +2 -0
  85. package/dist/components/charts/physics/GauntletChart.d.ts +73 -0
  86. package/dist/components/charts/physics/PhysicalFlowChart.capability.d.ts +2 -0
  87. package/dist/components/charts/physics/PhysicalFlowChart.d.ts +63 -0
  88. package/dist/components/charts/physics/PhysicsCustomChart.d.ts +120 -0
  89. package/dist/components/charts/physics/PhysicsPileChart.capability.d.ts +2 -0
  90. package/dist/components/charts/physics/PhysicsPileChart.d.ts +53 -0
  91. package/dist/components/charts/physics/ProcessFlowChart.capability.d.ts +2 -0
  92. package/dist/components/charts/physics/ProcessFlowChart.d.ts +96 -0
  93. package/dist/components/charts/physics/chainReactionOverlay.d.ts +22 -0
  94. package/dist/components/charts/physics/chainReactionRuntime.d.ts +37 -0
  95. package/dist/components/charts/physics/chainReactionTypes.d.ts +97 -0
  96. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +27 -0
  97. package/dist/components/charts/physics/dependencyMachine.d.ts +188 -0
  98. package/dist/components/charts/physics/eventDropPhysics.d.ts +64 -0
  99. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +28 -0
  100. package/dist/components/charts/physics/gauntletChartProps.d.ts +67 -0
  101. package/dist/components/charts/physics/gauntletChrome.d.ts +33 -0
  102. package/dist/components/charts/physics/gauntletController.d.ts +73 -0
  103. package/dist/components/charts/physics/gauntletEffects.d.ts +36 -0
  104. package/dist/components/charts/physics/gauntletPhysics.d.ts +71 -0
  105. package/dist/components/charts/physics/gauntletRuntime.d.ts +42 -0
  106. package/dist/components/charts/physics/gauntletTypes.d.ts +213 -0
  107. package/dist/components/charts/physics/physicalFlowPhysics.d.ts +57 -0
  108. package/dist/components/charts/physics/physicsChartShared.d.ts +41 -0
  109. package/dist/components/charts/physics/physicsChartUtils.d.ts +18 -0
  110. package/dist/components/charts/physics/physicsEncoding.d.ts +142 -0
  111. package/dist/components/charts/physics/physicsHocHandle.d.ts +53 -0
  112. package/dist/components/charts/physics/physicsHocUtils.d.ts +128 -0
  113. package/dist/components/charts/physics/physicsPilePhysics.d.ts +41 -0
  114. package/dist/components/charts/physics/physicsProcessPrimitives.d.ts +38 -0
  115. package/dist/components/charts/physics/processFlowPhysics.d.ts +97 -0
  116. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +9 -1
  117. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +9 -1
  118. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +30 -1
  119. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +16 -2
  120. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +9 -1
  121. package/dist/components/charts/realtime/aggregate.d.ts +51 -0
  122. package/dist/components/charts/realtime/eventTime.d.ts +26 -0
  123. package/dist/components/charts/shared/auditMobileVisualization.d.ts +91 -0
  124. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +145 -0
  125. package/dist/components/charts/shared/chartFamilySets.d.ts +20 -0
  126. package/dist/components/charts/shared/chartSpecCore.d.ts +165 -0
  127. package/dist/components/charts/shared/chartSpecs.d.ts +8 -127
  128. package/dist/components/charts/shared/chartSpecsGeo.d.ts +2 -0
  129. package/dist/components/charts/shared/chartSpecsNetwork.d.ts +2 -0
  130. package/dist/components/charts/shared/chartSpecsOrdinal.d.ts +2 -0
  131. package/dist/components/charts/shared/chartSpecsPhysics.d.ts +2 -0
  132. package/dist/components/charts/shared/chartSpecsRealtime.d.ts +2 -0
  133. package/dist/components/charts/shared/chartSpecsValue.d.ts +2 -0
  134. package/dist/components/charts/shared/chartSpecsXY.d.ts +2 -0
  135. package/dist/components/charts/shared/colorContrast.d.ts +3 -0
  136. package/dist/components/charts/shared/colorPalettes.d.ts +2 -0
  137. package/dist/components/charts/shared/colorUtils.d.ts +17 -13
  138. package/dist/components/charts/shared/diagnoseAnnotationChecks.d.ts +4 -0
  139. package/dist/components/charts/shared/diagnoseConfig.d.ts +9 -14
  140. package/dist/components/charts/shared/diagnoseMisleadingChecks.d.ts +9 -0
  141. package/dist/components/charts/shared/diagnosePhysicsChecks.d.ts +3 -0
  142. package/dist/components/charts/shared/diagnoseTypes.d.ts +10 -0
  143. package/dist/components/charts/shared/hooks.d.ts +28 -5
  144. package/dist/components/charts/shared/minMax.d.ts +3 -0
  145. package/dist/components/charts/shared/motionEncoding.d.ts +145 -0
  146. package/dist/components/charts/shared/radialGeometry.d.ts +0 -18
  147. package/dist/components/charts/shared/responsiveRules.d.ts +56 -0
  148. package/dist/components/charts/shared/smartTooltip.d.ts +27 -0
  149. package/dist/components/charts/shared/statisticalOverlays.d.ts +35 -0
  150. package/dist/components/charts/shared/streamPropsHelpers.d.ts +12 -2
  151. package/dist/components/charts/shared/temporalStrings.d.ts +7 -0
  152. package/dist/components/charts/shared/tooltipUtils.d.ts +2 -0
  153. package/dist/components/charts/shared/types.d.ts +49 -1
  154. package/dist/components/charts/shared/useChartSetup.d.ts +10 -3
  155. package/dist/components/charts/shared/useCustomChartSetup.d.ts +15 -6
  156. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +6 -2
  157. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  158. package/dist/components/charts/shared/useStreamingLegend.d.ts +1 -1
  159. package/dist/components/charts/shared/useSyncedPushData.d.ts +49 -0
  160. package/dist/components/charts/shared/validateChartData.d.ts +1 -1
  161. package/dist/components/charts/shared/validationMap.d.ts +0 -11
  162. package/dist/components/charts/xy/AreaChart.d.ts +1 -1
  163. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  164. package/dist/components/charts/xy/LineChart.d.ts +1 -1
  165. package/dist/components/charts/xy/MinimapChart.d.ts +1 -1
  166. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +2 -2
  167. package/dist/components/charts/xy/QuadrantChart.d.ts +1 -1
  168. package/dist/components/charts/xy/Scatterplot.d.ts +10 -1
  169. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +11 -1
  170. package/dist/components/charts/xy/StackedAreaChart.d.ts +9 -4
  171. package/dist/components/controls/controlAudit.d.ts +24 -0
  172. package/dist/components/controls/controlContract.d.ts +57 -0
  173. package/dist/components/data/fromArrow.d.ts +54 -0
  174. package/dist/components/data/fromFlintChart.d.ts +74 -0
  175. package/dist/components/data/fromMermaid.d.ts +47 -0
  176. package/dist/components/data/fromObservablePlot.d.ts +69 -0
  177. package/dist/components/data/fromVegaLite.d.ts +27 -0
  178. package/dist/components/data/portability/index.d.ts +17 -0
  179. package/dist/components/data/portability/result.d.ts +52 -0
  180. package/dist/components/data/portability/spec.d.ts +160 -0
  181. package/dist/components/data/portability/vegaLite.d.ts +80 -0
  182. package/dist/components/export/chartConfig.d.ts +11 -0
  183. package/dist/components/realtime/ReorderBuffer.d.ts +54 -0
  184. package/dist/components/realtime/RunningStats.d.ts +66 -0
  185. package/dist/components/realtime/WindowAccumulator.d.ts +105 -0
  186. package/dist/components/realtime/parseWindowDuration.d.ts +12 -0
  187. package/dist/components/realtime/types.d.ts +11 -0
  188. package/dist/components/recipes/annotationLayout.d.ts +29 -0
  189. package/dist/components/recipes/axisFixedForce.d.ts +119 -0
  190. package/dist/components/recipes/boba.d.ts +23 -0
  191. package/dist/components/recipes/customTooltip.d.ts +31 -0
  192. package/dist/components/recipes/cyclical.d.ts +39 -0
  193. package/dist/components/recipes/edgeRouter.d.ts +103 -0
  194. package/dist/components/recipes/forceLayout.d.ts +48 -0
  195. package/dist/components/recipes/forceLayoutAsync.d.ts +17 -0
  196. package/dist/components/recipes/gofishBobaHandwritten.d.ts +3 -0
  197. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +37 -0
  198. package/dist/components/recipes/gofishIR.d.ts +215 -0
  199. package/dist/components/recipes/gofishIRExamples.d.ts +38 -0
  200. package/dist/components/recipes/intervalLanes.d.ts +87 -0
  201. package/dist/components/recipes/intervals.d.ts +80 -0
  202. package/dist/components/recipes/isometricLandmarks.d.ts +88 -0
  203. package/dist/components/recipes/isotypeGlyphs.d.ts +17 -0
  204. package/dist/components/recipes/mermaidDag.d.ts +44 -0
  205. package/dist/components/recipes/mobileAnnotationStrategy.d.ts +48 -0
  206. package/dist/components/recipes/mobileChartFamilyRecipes.d.ts +59 -0
  207. package/dist/components/recipes/networkAnalysis.d.ts +102 -0
  208. package/dist/components/recipes/networkLayouts.d.ts +83 -0
  209. package/dist/components/recipes/packedClusterMatrix.d.ts +166 -0
  210. package/dist/components/recipes/physics.d.ts +122 -0
  211. package/dist/components/recipes/physicsReference.d.ts +102 -0
  212. package/dist/components/recipes/processAggregates.d.ts +32 -0
  213. package/dist/components/recipes/processChrome.d.ts +67 -0
  214. package/dist/components/recipes/processJourney.d.ts +54 -0
  215. package/dist/components/recipes/processPhysics.d.ts +300 -0
  216. package/dist/components/recipes/processVolumeGeometry.d.ts +28 -0
  217. package/dist/components/recipes/radialCoords.d.ts +69 -0
  218. package/dist/components/recipes/random.d.ts +2 -0
  219. package/dist/components/recipes/recipeChrome.d.ts +191 -0
  220. package/dist/components/recipes/recipeGlyph.d.ts +42 -0
  221. package/dist/components/recipes/recipeLegend.d.ts +109 -0
  222. package/dist/components/recipes/recipeUtils.d.ts +157 -0
  223. package/dist/components/recipes/runs.d.ts +59 -0
  224. package/dist/components/recipes/tokenEncoding.d.ts +157 -0
  225. package/dist/components/recipes/tokenLayer.d.ts +79 -0
  226. package/dist/components/recipes/unitize.d.ts +108 -0
  227. package/dist/components/recipes/vector.d.ts +28 -0
  228. package/dist/components/recipes/waffle.d.ts +43 -0
  229. package/dist/components/semiotic-ai-core.d.ts +47 -0
  230. package/dist/components/semiotic-ai.d.ts +52 -4
  231. package/dist/components/semiotic-controls.d.ts +18 -0
  232. package/dist/components/semiotic-data.d.ts +2 -0
  233. package/dist/components/semiotic-experimental.d.ts +49 -0
  234. package/dist/components/semiotic-geo.d.ts +11 -0
  235. package/dist/components/semiotic-network.d.ts +14 -1
  236. package/dist/components/semiotic-ordinal.d.ts +10 -0
  237. package/dist/components/semiotic-physics-matter.d.ts +10 -0
  238. package/dist/components/semiotic-physics-rapier.d.ts +9 -0
  239. package/dist/components/semiotic-physics.d.ts +56 -0
  240. package/dist/components/semiotic-realtime-core.d.ts +34 -0
  241. package/dist/components/semiotic-realtime-react.d.ts +10 -0
  242. package/dist/components/semiotic-realtime.d.ts +4 -22
  243. package/dist/components/semiotic-recipes-core.d.ts +92 -0
  244. package/dist/components/semiotic-recipes-react.d.ts +7 -0
  245. package/dist/components/semiotic-recipes.d.ts +4 -26
  246. package/dist/components/semiotic-server-edge.d.ts +8 -0
  247. package/dist/components/semiotic-server-node.d.ts +5 -0
  248. package/dist/components/semiotic-server.d.ts +2 -2
  249. package/dist/components/semiotic-themes-core.d.ts +53 -0
  250. package/dist/components/semiotic-themes-react.d.ts +4 -0
  251. package/dist/components/semiotic-themes.d.ts +6 -74
  252. package/dist/components/semiotic-utils-core.d.ts +46 -0
  253. package/dist/components/semiotic-utils-react.d.ts +5 -0
  254. package/dist/components/semiotic-utils.d.ts +3 -39
  255. package/dist/components/semiotic-xy.d.ts +10 -0
  256. package/dist/components/semiotic.d.ts +39 -7
  257. package/dist/components/server/animatedGif.d.ts +36 -0
  258. package/dist/components/server/renderEvidence.d.ts +1 -1
  259. package/dist/components/server/renderToStaticSVG.d.ts +3 -35
  260. package/dist/components/server/serverChartConfigShared.d.ts +17 -0
  261. package/dist/components/server/serverChartConfigs.d.ts +19 -9
  262. package/dist/components/server/serverChartConfigsCustom.d.ts +5 -0
  263. package/dist/components/server/serverChartConfigsGeo.d.ts +9 -0
  264. package/dist/components/server/serverChartConfigsNetwork.d.ts +8 -0
  265. package/dist/components/server/serverChartConfigsOrdinal.d.ts +16 -0
  266. package/dist/components/server/serverChartConfigsPhysics.d.ts +9 -0
  267. package/dist/components/server/serverChartConfigsXY.d.ts +11 -0
  268. package/dist/components/server/staticGeo.d.ts +4 -0
  269. package/dist/components/server/staticLegend.d.ts +1 -1
  270. package/dist/components/server/staticNetwork.d.ts +8 -0
  271. package/dist/components/server/staticOrdinal.d.ts +11 -0
  272. package/dist/components/server/staticPhysics.d.ts +3 -0
  273. package/dist/components/server/staticSVGChrome.d.ts +110 -0
  274. package/dist/components/server/staticXY.d.ts +4 -0
  275. package/dist/components/store/ObservationStore.d.ts +23 -3
  276. package/dist/components/store/SelectionStore.d.ts +1 -1
  277. package/dist/components/store/ThemeStore.d.ts +1 -1
  278. package/dist/components/store/TooltipStore.d.ts +1 -1
  279. package/dist/components/store/createStore.d.ts +1 -1
  280. package/dist/components/store/designTokens.d.ts +15 -0
  281. package/dist/components/store/themeSerialization.d.ts +32 -0
  282. package/dist/components/store/useChartInterrogation.d.ts +9 -0
  283. package/dist/components/stream/AccessibleDataTable.d.ts +3 -13
  284. package/dist/components/stream/FocusRing.d.ts +4 -2
  285. package/dist/components/stream/GeoCanvasHitTester.d.ts +1 -1
  286. package/dist/components/stream/GeoPipelineStore.d.ts +28 -0
  287. package/dist/components/stream/NetworkHtmlMarksLayer.d.ts +44 -0
  288. package/dist/components/stream/NetworkPipelineStore.d.ts +62 -25
  289. package/dist/components/stream/NetworkSVGOverlay.d.ts +15 -0
  290. package/dist/components/stream/OrdinalPipelineStore.d.ts +64 -2
  291. package/dist/components/stream/PipelineStore.d.ts +100 -162
  292. package/dist/components/stream/SceneGraph.d.ts +14 -2
  293. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  294. package/dist/components/stream/StreamNetworkFrame.d.ts +1 -1
  295. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  296. package/dist/components/stream/StreamXYFrame.d.ts +2 -18
  297. package/dist/components/stream/accessibleDataRows.d.ts +33 -0
  298. package/dist/components/stream/accessorUtils.d.ts +23 -10
  299. package/dist/components/stream/brushAccessibility.d.ts +25 -0
  300. package/dist/components/stream/canvasBackground.d.ts +24 -0
  301. package/dist/components/stream/canvasSetup.d.ts +4 -1
  302. package/dist/components/stream/customLayout.d.ts +20 -0
  303. package/dist/components/stream/customLayoutDiagnostics.d.ts +11 -0
  304. package/dist/components/stream/customLayoutFailure.d.ts +33 -0
  305. package/dist/components/stream/customLayoutPalette.d.ts +19 -9
  306. package/dist/components/stream/customLayoutSelection.d.ts +52 -0
  307. package/dist/components/stream/frameThemeColors.d.ts +24 -0
  308. package/dist/components/stream/geoAnnotationAnchors.d.ts +14 -0
  309. package/dist/components/stream/geoCartogram.d.ts +17 -0
  310. package/dist/components/stream/geoCustomLayout.d.ts +59 -0
  311. package/dist/components/stream/geoDefaultTooltip.d.ts +11 -0
  312. package/dist/components/stream/geoFrameHelpers.d.ts +34 -0
  313. package/dist/components/stream/geoPipelineHelpers.d.ts +46 -0
  314. package/dist/components/stream/geoTypes.d.ts +56 -7
  315. package/dist/components/stream/glyphDef.d.ts +98 -0
  316. package/dist/components/stream/hitTarget.d.ts +170 -0
  317. package/dist/components/stream/hoverUtils.d.ts +3 -0
  318. package/dist/components/stream/keyboardNav.d.ts +4 -1
  319. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +9 -1
  320. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +57 -0
  321. package/dist/components/stream/networkBezier.d.ts +10 -0
  322. package/dist/components/stream/networkColorAccessors.d.ts +49 -0
  323. package/dist/components/stream/networkCustomLayout.d.ts +66 -1
  324. package/dist/components/stream/networkDefaultTooltip.d.ts +10 -0
  325. package/dist/components/stream/networkFrameInteraction.d.ts +37 -0
  326. package/dist/components/stream/networkFramePaint.d.ts +43 -0
  327. package/dist/components/stream/networkPipelineConfig.d.ts +22 -0
  328. package/dist/components/stream/networkPipelineHelpers.d.ts +12 -0
  329. package/dist/components/stream/networkRealtimeEncoding.d.ts +41 -0
  330. package/dist/components/stream/networkTypes.d.ts +104 -5
  331. package/dist/components/stream/ordinalCanvasRenderers.d.ts +7 -0
  332. package/dist/components/stream/ordinalCustomLayout.d.ts +17 -1
  333. package/dist/components/stream/ordinalDataIndex.d.ts +5 -0
  334. package/dist/components/stream/ordinalDefaultTooltip.d.ts +10 -0
  335. package/dist/components/stream/ordinalDomain.d.ts +38 -0
  336. package/dist/components/stream/ordinalPipelineUpdateResults.d.ts +12 -0
  337. package/dist/components/stream/ordinalPulse.d.ts +10 -0
  338. package/dist/components/stream/ordinalPulseResources.d.ts +3 -0
  339. package/dist/components/stream/ordinalSceneBuilders/sceneBuilderMap.d.ts +5 -0
  340. package/dist/components/stream/ordinalSceneBuilders/types.d.ts +2 -0
  341. package/dist/components/stream/ordinalSpatialIndex.d.ts +9 -0
  342. package/dist/components/stream/ordinalTypes.d.ts +56 -8
  343. package/dist/components/stream/paintNeeds.d.ts +31 -0
  344. package/dist/components/stream/physics/CapacityQueueController.d.ts +5 -0
  345. package/dist/components/stream/physics/CapacityQueueTypes.d.ts +134 -0
  346. package/dist/components/stream/physics/MatterPhysicsEngineAdapter.d.ts +42 -0
  347. package/dist/components/stream/physics/PhysicsAccessibility.d.ts +48 -0
  348. package/dist/components/stream/physics/PhysicsAnnotations.d.ts +58 -0
  349. package/dist/components/stream/physics/PhysicsBodyBudget.d.ts +26 -0
  350. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +10 -0
  351. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +26 -0
  352. package/dist/components/stream/physics/PhysicsControllers.d.ts +75 -0
  353. package/dist/components/stream/physics/PhysicsEngineAdapter.d.ts +59 -0
  354. package/dist/components/stream/physics/PhysicsEngineConformance.d.ts +23 -0
  355. package/dist/components/stream/physics/PhysicsEvidence.d.ts +25 -0
  356. package/dist/components/stream/physics/PhysicsKernel.d.ts +207 -0
  357. package/dist/components/stream/physics/PhysicsOptionalEngineAdapters.d.ts +12 -0
  358. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +84 -0
  359. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +181 -0
  360. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +72 -0
  361. package/dist/components/stream/physics/PhysicsSediment.d.ts +69 -0
  362. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +18 -0
  363. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +21 -0
  364. package/dist/components/stream/physics/PhysicsWorkerClient.d.ts +24 -0
  365. package/dist/components/stream/physics/PhysicsWorkerProtocol.d.ts +101 -0
  366. package/dist/components/stream/physics/PhysicsWorkerRuntime.d.ts +5 -0
  367. package/dist/components/stream/physics/RapierPhysicsEngineAdapter.d.ts +18 -0
  368. package/dist/components/stream/physics/ServiceOperationsControllers.d.ts +27 -0
  369. package/dist/components/stream/physics/ServiceOperationsTypes.d.ts +89 -0
  370. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +6 -0
  371. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +302 -0
  372. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +27 -0
  373. package/dist/components/stream/physics/physicsPipelineControls.d.ts +4 -0
  374. package/dist/components/stream/physics/physicsPipelineHelpers.d.ts +41 -0
  375. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +14 -0
  376. package/dist/components/stream/physics/physicsPipelineUpdateResults.d.ts +9 -0
  377. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +54 -0
  378. package/dist/components/stream/physics/physicsSemanticUI.d.ts +20 -0
  379. package/dist/components/stream/physics/usePhysicsFrameLifecyclePolicy.d.ts +16 -0
  380. package/dist/components/stream/pipelineBufferUtils.d.ts +26 -0
  381. package/dist/components/stream/pipelineConfig.d.ts +177 -0
  382. package/dist/components/stream/pipelineDecay.d.ts +20 -2
  383. package/dist/components/stream/pipelineDomainResolution.d.ts +62 -0
  384. package/dist/components/stream/pipelineIdentityOps.d.ts +26 -0
  385. package/dist/components/stream/pipelinePulse.d.ts +16 -2
  386. package/dist/components/stream/pipelineRibbons.d.ts +41 -0
  387. package/dist/components/stream/pipelineSpatialIndex.d.ts +12 -0
  388. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +12 -0
  389. package/dist/components/stream/pipelineStyleResolvers.d.ts +46 -0
  390. package/dist/components/stream/pipelineTransitions.d.ts +2 -0
  391. package/dist/components/stream/pipelineUpdateContract.d.ts +62 -0
  392. package/dist/components/stream/pulseFrameRefresh.d.ts +22 -0
  393. package/dist/components/stream/renderers/glyphCanvasRenderer.d.ts +6 -0
  394. package/dist/components/stream/renderers/networkSymbolRenderer.d.ts +2 -0
  395. package/dist/components/stream/renderers/resolveCSSColor.d.ts +6 -0
  396. package/dist/components/stream/renderers/symbolCanvasRenderer.d.ts +2 -0
  397. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +18 -0
  398. package/dist/components/stream/stalenessBands.d.ts +28 -0
  399. package/dist/components/stream/streamStoreSync.d.ts +37 -0
  400. package/dist/components/stream/symbolPath.d.ts +24 -0
  401. package/dist/components/stream/types.d.ts +206 -9
  402. package/dist/components/stream/useFrame.d.ts +21 -2
  403. package/dist/components/stream/useHydration.d.ts +6 -0
  404. package/dist/components/stream/useLegendCategoryEmission.d.ts +5 -0
  405. package/dist/components/stream/useStalenessCheck.d.ts +6 -1
  406. package/dist/components/stream/workerModuleUrl.d.ts +10 -0
  407. package/dist/components/stream/xyAnnotationAnchors.d.ts +13 -0
  408. package/dist/components/stream/xyCanvasRenderers.d.ts +7 -0
  409. package/dist/components/stream/xyCrosshair.d.ts +11 -0
  410. package/dist/components/stream/xyDateTicks.d.ts +9 -0
  411. package/dist/components/stream/xyDefaultTooltip.d.ts +10 -0
  412. package/dist/components/stream/xySceneBuilders/pointScene.d.ts +2 -2
  413. package/dist/components/stream/xySceneBuilders/types.d.ts +9 -4
  414. package/dist/controls.min.js +2 -0
  415. package/dist/controls.module.min.js +2 -0
  416. package/dist/forceLayoutWorker.js +1 -0
  417. package/dist/geo.min.js +1 -1
  418. package/dist/geo.module.min.js +1 -1
  419. package/dist/network.min.js +1 -1
  420. package/dist/network.module.min.js +1 -1
  421. package/dist/ordinal.min.js +1 -1
  422. package/dist/ordinal.module.min.js +1 -1
  423. package/dist/physics-matter.min.js +1 -0
  424. package/dist/physics-matter.module.min.js +1 -0
  425. package/dist/physics-rapier.min.js +1 -0
  426. package/dist/physics-rapier.module.min.js +1 -0
  427. package/dist/physics.min.js +2 -0
  428. package/dist/physics.module.min.js +2 -0
  429. package/dist/physicsWorker.js +1 -0
  430. package/dist/realtime.min.js +1 -1
  431. package/dist/realtime.module.min.js +1 -1
  432. package/dist/semiotic-ai-chunk-OG7BQUUW.module.min.js +2 -0
  433. package/dist/semiotic-ai-core.d.ts +47 -0
  434. package/dist/semiotic-ai-core.min.js +1 -0
  435. package/dist/semiotic-ai-core.module.min.js +1 -0
  436. package/dist/semiotic-ai-statisticalOverlays-CY4WKR4A.module.min.js +2 -0
  437. package/dist/semiotic-ai.d.ts +52 -4
  438. package/dist/semiotic-ai.min.js +1 -1
  439. package/dist/semiotic-ai.module.min.js +1 -1
  440. package/dist/semiotic-chunk-3FSVZ46U.module.min.js +2 -0
  441. package/dist/semiotic-controls.d.ts +18 -0
  442. package/dist/semiotic-data.d.ts +2 -0
  443. package/dist/semiotic-data.min.js +1 -1
  444. package/dist/semiotic-data.module.min.js +1 -1
  445. package/dist/semiotic-experimental.d.ts +49 -0
  446. package/dist/semiotic-experimental.min.js +1 -0
  447. package/dist/semiotic-experimental.module.min.js +1 -0
  448. package/dist/semiotic-geo.d.ts +11 -0
  449. package/dist/semiotic-network.d.ts +14 -1
  450. package/dist/semiotic-ordinal.d.ts +10 -0
  451. package/dist/semiotic-physics-matter.d.ts +10 -0
  452. package/dist/semiotic-physics-rapier.d.ts +9 -0
  453. package/dist/semiotic-physics.d.ts +56 -0
  454. package/dist/semiotic-realtime-core.d.ts +34 -0
  455. package/dist/semiotic-realtime-core.min.js +1 -0
  456. package/dist/semiotic-realtime-core.module.min.js +1 -0
  457. package/dist/semiotic-realtime-react.d.ts +10 -0
  458. package/dist/semiotic-realtime-react.min.js +2 -0
  459. package/dist/semiotic-realtime-react.module.min.js +2 -0
  460. package/dist/semiotic-realtime.d.ts +4 -22
  461. package/dist/semiotic-recipes-core.d.ts +92 -0
  462. package/dist/semiotic-recipes-core.min.js +1 -0
  463. package/dist/semiotic-recipes-core.module.min.js +1 -0
  464. package/dist/semiotic-recipes-react.d.ts +7 -0
  465. package/dist/semiotic-recipes-react.min.js +2 -0
  466. package/dist/semiotic-recipes-react.module.min.js +2 -0
  467. package/dist/semiotic-recipes.d.ts +4 -26
  468. package/dist/semiotic-recipes.min.js +1 -1
  469. package/dist/semiotic-recipes.module.min.js +1 -1
  470. package/dist/semiotic-server-edge.d.ts +8 -0
  471. package/dist/semiotic-server-edge.min.js +1 -0
  472. package/dist/semiotic-server-edge.module.min.js +1 -0
  473. package/dist/semiotic-server-node.d.ts +5 -0
  474. package/dist/semiotic-server-node.min.js +1 -0
  475. package/dist/semiotic-server-node.module.min.js +1 -0
  476. package/dist/semiotic-server.d.ts +2 -2
  477. package/dist/semiotic-statisticalOverlays-UOMSFKVJ.module.min.js +2 -0
  478. package/dist/semiotic-themes-core.d.ts +53 -0
  479. package/dist/semiotic-themes-core.min.js +1 -0
  480. package/dist/semiotic-themes-core.module.min.js +1 -0
  481. package/dist/semiotic-themes-react.d.ts +4 -0
  482. package/dist/semiotic-themes-react.min.js +2 -0
  483. package/dist/semiotic-themes-react.module.min.js +2 -0
  484. package/dist/semiotic-themes.d.ts +6 -74
  485. package/dist/semiotic-themes.min.js +1 -2
  486. package/dist/semiotic-themes.module.min.js +1 -2
  487. package/dist/semiotic-utils-core.d.ts +46 -0
  488. package/dist/semiotic-utils-core.min.js +1 -0
  489. package/dist/semiotic-utils-core.module.min.js +1 -0
  490. package/dist/semiotic-utils-react.d.ts +5 -0
  491. package/dist/semiotic-utils-react.min.js +2 -0
  492. package/dist/semiotic-utils-react.module.min.js +2 -0
  493. package/dist/semiotic-utils.d.ts +3 -39
  494. package/dist/semiotic-utils.min.js +1 -2
  495. package/dist/semiotic-utils.module.min.js +1 -2
  496. package/dist/semiotic-value.min.js +1 -1
  497. package/dist/semiotic-value.module.min.js +1 -1
  498. package/dist/semiotic-xy.d.ts +10 -0
  499. package/dist/semiotic.d.ts +39 -7
  500. package/dist/semiotic.min.js +1 -1
  501. package/dist/semiotic.module.min.js +1 -1
  502. package/dist/server.min.js +1 -1
  503. package/dist/server.module.min.js +1 -1
  504. package/dist/xy-chunk-IWD6IB6V.module.min.js +2 -0
  505. package/dist/xy-statisticalOverlays-7RWG6LJT.module.min.js +2 -0
  506. package/dist/xy.min.js +1 -1
  507. package/dist/xy.module.min.js +1 -1
  508. package/package.json +246 -86
  509. package/spec/README.md +152 -0
  510. package/spec/bindings/README.md +35 -0
  511. package/spec/bindings/vega-lite.mjs +112 -0
  512. package/spec/v0.1/annotation-provenance.schema.json +127 -0
  513. package/spec/v0.1/audience-profile.schema.json +67 -0
  514. package/spec/v0.1/chart-capability.schema.json +186 -0
  515. package/dist/semiotic-ai-statisticalOverlays-C2PPlmXv.js +0 -1
  516. package/dist/semiotic-statisticalOverlays-C3DsOgr_.js +0 -1
  517. package/dist/xy-statisticalOverlays-C2PPlmXv.js +0 -1
@@ -0,0 +1,108 @@
1
+ /**
2
+ * `unitize` — the pictogram/tally allocator: turn a magnitude into repeated
3
+ * unit signs with a fractional final sign (the ISOTYPE rule: symbols repeat,
4
+ * they do not grow).
5
+ *
6
+ * This is the counting sibling of {@link allocateCells} (`waffle.ts`):
7
+ * `allocateCells` divides a *fixed* number of grid cells proportionally among
8
+ * categories (largest-remainder, integer cells); `unitize` converts one value
9
+ * into *as many* signs as it needs at a fixed value-per-sign, preserving the
10
+ * remainder as a partial sign. Use `allocateCells` for part-to-whole waffles,
11
+ * `unitize` for unit charts, pictogram rows, arrow bundles, and sign stacks.
12
+ */
13
+ /** One drawn unit sign. */
14
+ export interface UnitSign {
15
+ /** 0-based position in the tally (also the grid/wrap index). */
16
+ index: number;
17
+ /** How much of this sign is filled, 0–1. All signs but the last are 1. */
18
+ fraction: number;
19
+ /** Value where this sign begins (`index * unit`). */
20
+ start: number;
21
+ /** Value this sign reaches (`min(value, (index + 1) * unit)`). */
22
+ end: number;
23
+ /** Value carried by this sign (`end - start`, i.e. `fraction * unit`). */
24
+ value: number;
25
+ }
26
+ /** A unit sign inside the projected/scenario extension of a range tally. */
27
+ export interface RangeUnitSign extends UnitSign {
28
+ /**
29
+ * Where the range fill begins within this sign, 0–1. Non-zero only on the
30
+ * boundary sign when the base value ends mid-sign — draw the range fill
31
+ * clipped from `startFraction` to `fraction` so base and range tile one
32
+ * sign without double-painting.
33
+ */
34
+ startFraction: number;
35
+ }
36
+ export interface UnitizeOptions {
37
+ /** Value represented by one complete sign. Must be > 0. */
38
+ unit: number;
39
+ /**
40
+ * Cap on the number of signs. When the tally is truncated the result's
41
+ * `overflow` flag is set (render a `+`, a count label, or scale the unit).
42
+ * @default Infinity
43
+ */
44
+ maxUnits?: number;
45
+ /**
46
+ * Drop a trailing partial sign whose fraction falls below this threshold —
47
+ * 176 at unit 25 is seven arrows, not seven arrows and a 4% stub. The
48
+ * dropped remainder is still visible as `total - shown`.
49
+ * @default 0
50
+ */
51
+ minFraction?: number;
52
+ }
53
+ export interface UnitizeResult {
54
+ /** The signs to draw, in order; every sign but the last has fraction 1. */
55
+ units: UnitSign[];
56
+ /** The value-per-sign the tally was built with. */
57
+ unit: number;
58
+ /** The sanitized input value (non-finite and negative clamp to 0). */
59
+ total: number;
60
+ /** Value actually represented by the drawn signs (≤ `total` when capped or a sliver was dropped). */
61
+ shown: number;
62
+ /** True when `maxUnits` truncated the tally. */
63
+ overflow: boolean;
64
+ }
65
+ export interface UnitizeRangeResult extends UnitizeResult {
66
+ /**
67
+ * Signs extending the tally from `value` to `rangeValue` — the projected /
68
+ * scenario portion, conventionally drawn hatched or outlined. Indices
69
+ * continue the base tally; the first entry carries a non-zero
70
+ * `startFraction` when the base value ends mid-sign.
71
+ */
72
+ rangeUnits: RangeUnitSign[];
73
+ /** The sanitized range endpoint (≥ `total`). */
74
+ rangeTotal: number;
75
+ }
76
+ /**
77
+ * Allocate a value into repeated unit signs with a fractional final sign.
78
+ *
79
+ * Feeds any repeated-mark rendering: a row of pictograms, a stack of signs on
80
+ * a map, an arrow bundle, wrapped unit grids (derive row/column from
81
+ * `index`). Pair each sign with a `glyph` scene node (its `fraction` maps
82
+ * directly onto the glyph's partial fill) or clip your own SVG.
83
+ *
84
+ * @example
85
+ * ```ts
86
+ * const tally = unitize(176, { unit: 25 })
87
+ * // 8 signs: seven at fraction 1, the last at 0.04 — or drop the stub:
88
+ * const arrows = unitize(176, { unit: 25, minFraction: 0.08 })
89
+ * // arrows.units.length === 7, arrows.shown === 175, arrows.total === 176
90
+ * ```
91
+ */
92
+ export declare function unitize(value: number, options: UnitizeOptions): UnitizeResult;
93
+ /**
94
+ * Allocate a value plus a projected/scenario extension: solid signs to
95
+ * `value`, continuation signs from `value` to `rangeValue` (draw them hatched
96
+ * or outlined — countable, but visibly not yet real).
97
+ *
98
+ * When `value` ends mid-sign, the first range sign shares that sign: its
99
+ * `startFraction` is where the solid fill stopped, so the two fills tile one
100
+ * sign exactly.
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * const { units, rangeUnits } = unitizeRange(325, 580, { unit: 25 })
105
+ * // 13 solid signs, then 11 hatched signs (the last at fraction 0.2)
106
+ * ```
107
+ */
108
+ export declare function unitizeRange(value: number, rangeValue: number, options: UnitizeOptions): UnitizeRangeResult;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 2D vector kit — the handful of point/vector operations every hand-built
3
+ * custom layout re-derives when it positions marks in Cartesian space:
4
+ * add/subtract two points, scale one, take a magnitude, normalize to a unit
5
+ * direction. A radial network spoke, an edge offset normal to its tangent, a
6
+ * leader line — all of them open with three or four of these one-liners.
7
+ *
8
+ * Pure / SSR-safe, dependency-free. Operates on the shared {@link Point}
9
+ * (`{ x, y }`) used across the radial and edge-router kits, so results compose
10
+ * directly with `polarToXY`, `boxEdgeAnchors`, `curvedEdgePath`, and the cubic
11
+ * helpers in `edgeRouter`.
12
+ */
13
+ import type { Point } from "./radialCoords";
14
+ export type { Point };
15
+ /** Component-wise sum `a + b`. */
16
+ export declare function addPoints(a: Point, b: Point): Point;
17
+ /** Component-wise difference `a - b` (the vector from `b` to `a`). */
18
+ export declare function subtractPoints(a: Point, b: Point): Point;
19
+ /** Scale a point/vector by a scalar `k`. */
20
+ export declare function scalePoint(a: Point, k: number): Point;
21
+ /** Euclidean length of the vector from the origin to `a`. */
22
+ export declare function pointMagnitude(a: Point): number;
23
+ /**
24
+ * The unit vector in the direction of `a`. A zero-length vector returns `a`
25
+ * unchanged (its magnitude is treated as 1) so callers never divide by zero —
26
+ * the common "tangent of a degenerate edge" case stays finite.
27
+ */
28
+ export declare function normalizePoint(a: Point): Point;
@@ -44,3 +44,46 @@ export interface WaffleConfig {
44
44
  * ```
45
45
  */
46
46
  export declare const waffleLayout: CustomLayout<WaffleConfig>;
47
+ export interface CellWeight {
48
+ /** Stable identity for the category (used as the secondary sort tiebreak). */
49
+ key: string;
50
+ /** Relative weight — cells are allocated proportional to this. */
51
+ weight: number;
52
+ }
53
+ export interface AllocatedCells extends CellWeight {
54
+ /** The category's exact (fractional) share of `totalCells`. */
55
+ exact: number;
56
+ /** The integer cells assigned to this category. */
57
+ cells: number;
58
+ /** Fractional leftover (`exact - floor(exact)`), the largest-remainder key. */
59
+ remainder: number;
60
+ }
61
+ export interface AllocateCellsOptions {
62
+ /** Cells guaranteed to every category with a positive weight, even when its
63
+ * proportional share rounds below this. Over-allocation is then clawed back
64
+ * from the largest categories. @default 0 */
65
+ minPerCategory?: number;
66
+ }
67
+ /**
68
+ * Distribute `totalCells` across weighted categories so each gets a count
69
+ * proportional to its weight, using the **largest-remainder method** (every
70
+ * cell is assigned; no drift from rounding each share independently). The pure
71
+ * allocation math behind a feature-mix / proportional waffle: turn `{kind →
72
+ * count}` into `{kind → grid cells}`.
73
+ *
74
+ * With `minPerCategory` every present category keeps at least that many cells
75
+ * (so small-but-nonzero categories stay visible); the shortfall is reclaimed
76
+ * from the categories holding the most cells. Categories are returned in input
77
+ * order — sort the input first if you want a particular legend/fill order.
78
+ *
79
+ * @example
80
+ * ```ts
81
+ * const alloc = allocateCells(
82
+ * [{ key: "monument", weight: 7 }, { key: "museum", weight: 2 }, { key: "park", weight: 1 }],
83
+ * 100,
84
+ * { minPerCategory: 1 },
85
+ * )
86
+ * // → [{ key: "monument", cells: 70, … }, { key: "museum", cells: 20, … }, { key: "park", cells: 10, … }]
87
+ * ```
88
+ */
89
+ export declare function allocateCells(weights: readonly CellWeight[], totalCells: number, opts?: AllocateCellsOptions): AllocatedCells[];
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Semiotic AI core — chart-free deterministic intelligence for agent backends.
3
+ *
4
+ * Import from `semiotic/ai/core` when an agent needs recommendation,
5
+ * validation, repair, grounding, or provider-tool adapters but does not render
6
+ * React chart components in the same runtime. `semiotic/ai` remains the
7
+ * backwards-compatible HOC catalog for code generation.
8
+ */
9
+ export { validateProps } from "./charts/shared/validateProps";
10
+ export type { ValidationResult } from "./charts/shared/validateProps";
11
+ export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
12
+ export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
13
+ export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats, } from "./charts/shared/auditAccessibility";
14
+ export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions, } from "./charts/shared/auditAccessibility";
15
+ export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats, } from "./charts/shared/auditMobileVisualization";
16
+ export type { MobileVisualizationAuditResult, AuditMobileVisualizationOptions, } from "./charts/shared/auditMobileVisualization";
17
+ export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
18
+ export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
19
+ export { summarizeData } from "./data/DataSummarizer";
20
+ export type { DataSummary, FieldSummary, FieldType, SummarizeOptions } from "./data/DataSummarizer";
21
+ export { profileData } from "./ai/profileData";
22
+ export type { ProfileDataOptions } from "./ai/profileData";
23
+ export { inferIntent } from "./ai/inferIntent";
24
+ export type { InferIntentResult } from "./ai/inferIntent";
25
+ export { suggestCharts, suggestChartsGrouped, scoreChart, explainCapabilityFit } from "./ai/suggestCharts";
26
+ export type { SuggestChartsOptions, RejectedCapability, ExplainCapabilityFitResult } from "./ai/suggestCharts";
27
+ export { suggestDashboard } from "./ai/suggestDashboard";
28
+ export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } from "./ai/suggestDashboard";
29
+ export { suggestStreamCharts } from "./ai/suggestStreamCharts";
30
+ export type { SuggestStreamChartsOptions } from "./ai/suggestStreamCharts";
31
+ export type { StreamSchema, StreamSuggestion } from "./ai/streamingTypes";
32
+ export { suggestStretchCharts } from "./ai/suggestStretchCharts";
33
+ export type { StretchSuggestion, SuggestStretchChartsOptions } from "./ai/suggestStretchCharts";
34
+ export { repairChartConfig } from "./ai/repairChartConfig";
35
+ export type { RepairResult, RepairOptions } from "./ai/repairChartConfig";
36
+ export { proposeVariant, evaluateVariantProposal } from "./ai/variantDiscovery";
37
+ export type { VariantProposal, VariantScore, EvaluateVariantProposalOptions } from "./ai/variantDiscovery";
38
+ export { describeChart, resolveCommunicativeAct, communicativeActForIntent } from "./ai/describeChart";
39
+ export type { DescribeChartResult, DescribeChartOptions, DescribeLevel, CommunicativeAct, DescribeCapabilityContext } from "./ai/describeChart";
40
+ export { buildReaderGrounding } from "./ai/readerGrounding";
41
+ export type { ChartReaderGrounding, ChartReaderGroundingOptions } from "./ai/readerGrounding";
42
+ export { buildNavigationTree, flattenVisible, countNodes } from "./ai/navigationTree";
43
+ export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
44
+ export { prepareChart, chartGenerationTool, toAnthropicTool, toOpenAITool, toOpenAIResponsesTool, createChartToolHandler, } from "./ai/generativeChart";
45
+ export type { RenderFn, PrepareChartInput, PrepareChartOptions, PrepareChartResult, ChartToolDefinition, ChartToolOptions, OpenAIResponsesTool, OpenAIResponsesToolOptions, } from "./ai/generativeChart";
46
+ export { inspectChart } from "./ai/chartClinic";
47
+ export type { ChartClinicConfig, ChartClinicInput, ChartClinicOptions, ChartClinicReport, ChartClinicRevisionInput, ChartClinicRevisionStatus, ChartClinicSceneSummary, ChartClinicBundleGuidance, } from "./ai/chartClinic";
@@ -12,7 +12,8 @@ export { QuadrantChart } from "./charts/xy/QuadrantChart";
12
12
  export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
13
13
  export { CandlestickChart } from "./charts/xy/CandlestickChart";
14
14
  export { LinkedCharts } from "./LinkedCharts";
15
- export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
15
+ export { useSelection, useSelectionActions, useLinkedHover, useBrushSelection, useFilteredData, useLinkedChartsActive } from "./LinkedCharts";
16
+ export type { LinkedChartsProps, LegendInteractionMode } from "./LinkedCharts";
16
17
  export { BarChart } from "./charts/ordinal/BarChart";
17
18
  export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
18
19
  export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
@@ -41,13 +42,28 @@ export { RealtimeHistogram, TemporalHistogram } from "./charts/realtime/Realtime
41
42
  export { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
42
43
  export { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
43
44
  export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
45
+ export { GaltonBoardChart } from "./charts/physics/GaltonBoardChart";
46
+ export { EventDropChart } from "./charts/physics/EventDropChart";
47
+ export { PhysicsCustomChart } from "./charts/physics/PhysicsCustomChart";
48
+ export { PhysicsPileChart } from "./charts/physics/PhysicsPileChart";
49
+ export { CollisionSwarmChart } from "./charts/physics/CollisionSwarmChart";
50
+ export { PhysicalFlowChart } from "./charts/physics/PhysicalFlowChart";
51
+ export { ProcessFlowChart } from "./charts/physics/ProcessFlowChart";
52
+ export { GauntletChart } from "./charts/physics/GauntletChart";
44
53
  export { BigNumber } from "./charts/value/BigNumber";
45
54
  export { TooltipProvider } from "./store/TooltipStore";
46
55
  export { MultiLineTooltip } from "./Tooltip/Tooltip";
47
56
  export { ThemeProvider, useTheme } from "./ThemeProvider";
48
57
  export { exportChart } from "./export/exportChart";
49
58
  export { ChartContainer } from "./ChartContainer";
50
- export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
59
+ export { MobileChartContainer } from "./MobileChartContainer";
60
+ export { SmallMultipleChart } from "./SmallMultipleChart";
61
+ export { MobileStandardControls } from "./MobileStandardControls";
62
+ export { clampMobileRange, useMobileRangeControls, zoomMobileRange, } from "./MobileStandardControls";
63
+ export type { ChartContainerProps, ChartContainerHandle, ChartContainerMobileOptions, ChartNotification, ChartNotificationLevel } from "./ChartContainer";
64
+ export type { MobileChartChip, MobileChartContainerProps, MobileChartDetailMode } from "./MobileChartContainer";
65
+ export type { MobileStandardBrushControls, MobileStandardControlKind, MobileStandardControlLegendItem, MobileStandardControlRequest, MobileStandardControlsMode, MobileStandardControlsProps, MobileStandardLegendControls, MobileStandardZoomControls, UseMobileRangeControlsOptions, UseMobileRangeControlsResult, } from "./MobileStandardControls";
66
+ export type { SmallMultipleChartProps, SmallMultipleExtent, SmallMultipleItem, SmallMultipleRenderContext, SmallMultipleSharedExtent } from "./SmallMultipleChart";
51
67
  export { ChartGrid } from "./ChartGrid";
52
68
  export type { ChartGridProps } from "./ChartGrid";
53
69
  export { ContextLayout } from "./ContextLayout";
@@ -60,8 +76,15 @@ export { validateProps } from "./charts/shared/validateProps";
60
76
  export type { ValidationResult } from "./charts/shared/validateProps";
61
77
  export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
62
78
  export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
79
+ export { diagnoseTokenEncoding, normalizeTokenEncoding, suggestTokenEncoding, tokenTaskIntentToCapabilityIntents, } from "./recipes/tokenEncoding";
80
+ export type { PositionedToken, SuggestTokenEncodingInput, TokenCapabilityIntent, TokenCountStrategy, TokenDiagnostic, TokenDiagnosticCode, TokenDiagnosticsContext, TokenEncoding, TokenEncodingSuggestion, TokenGeneratorInput, TokenGridOptions, TokenLabelPolicy, TokenLayout, TokenSemantics, TokenSet, TokenTaskIntent, TokenType, VisualToken, } from "./recipes/tokenEncoding";
63
81
  export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
82
+ export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats } from "./charts/shared/auditMobileVisualization";
83
+ export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
64
84
  export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./charts/shared/auditAccessibility";
85
+ export type { MobileAuditStatus, MobileAuditCategory, MobileAuditImpact, MobileVisualizationInteractionContract, MobileVisualizationLabelContract, MobileVisualizationCustomContract, MobileVisualizationContract, MobileVisualizationFinding, MobileVisualizationAuditResult, AuditMobileVisualizationOptions } from "./charts/shared/auditMobileVisualization";
86
+ export type { MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig } from "./charts/shared/types";
87
+ export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts/shared/responsiveRules";
65
88
  export type { AnomalyConfig, ForecastConfig } from "./charts/shared/statisticalOverlays";
66
89
  export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
67
90
  export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
@@ -77,7 +100,11 @@ export { summarizeData } from "./data/DataSummarizer";
77
100
  export { describeChart, resolveCommunicativeAct, communicativeActForIntent } from "./ai/describeChart";
78
101
  export type { DescribeChartResult, DescribeChartOptions, DescribeLevel, CommunicativeAct, DescribeCapabilityContext } from "./ai/describeChart";
79
102
  export { buildReaderGrounding } from "./ai/readerGrounding";
80
- export type { ChartReaderGrounding, ChartReaderGroundingOptions, ChartReaderGroundingIntent } from "./ai/readerGrounding";
103
+ export type { ChartReaderGrounding, ChartReaderGroundingOptions, ChartReaderGroundingIntent, PhysicsReaderGrounding, PhysicsReaderGroundingAggregate, PhysicsReaderGroundingAggregates, PhysicsReaderGroundingGeometry, PhysicsReaderGroundingInput, PhysicsReaderGroundingSediment, PhysicsReaderGroundingSimulation } from "./ai/readerGrounding";
104
+ export { dataQualityToAnnotations, fromDbtArtifacts, fromGreatExpectations } from "./ai/dataQualityBridge";
105
+ export type { DataQualityStatus, DataQualityCheckKind, DataQualityResult, DataQualityAnnotationOptions, DataQualityAnnotationsResult, UnplacedDataQualityResult, DbtArtifacts, GEValidationResult } from "./ai/dataQualityBridge";
106
+ export { prepareChart, chartGenerationTool, toAnthropicTool, toOpenAITool, toOpenAIResponsesTool, createChartToolHandler } from "./ai/generativeChart";
107
+ export type { RenderFn, PrepareChartInput, PrepareChartOptions, PrepareChartResult, ChartToolDefinition, ChartToolOptions, OpenAIResponsesTool, OpenAIResponsesToolOptions } from "./ai/generativeChart";
81
108
  export { buildNavigationTree, flattenVisible, countNodes } from "./ai/navigationTree";
82
109
  export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
83
110
  export { AccessibleNavTree } from "./AccessibleNavTree";
@@ -113,7 +140,26 @@ export { CANONICAL_FIXTURES } from "./ai/qualityFixtures";
113
140
  export { useChartSuggestions } from "./ai/useChartSuggestions";
114
141
  export type { UseChartSuggestionsOptions, UseChartSuggestionsResult } from "./ai/useChartSuggestions";
115
142
  export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability } from "./ai/chartCapabilities";
116
- export type { ChartCapability, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, ScaledSuggestionGroups, Suggestion, SuggestionScaleRange } from "./ai/chartCapabilityTypes";
143
+ export type { ChartCapability, ChartCandidateKind, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, ScaledSuggestionGroups, Suggestion, SuggestionScaleRange, WhyCustomExplanation } from "./ai/chartCapabilityTypes";
144
+ export { defineChartRecipe, validateChartRecipe, isJsonSafe, isRegisteredRecipeLayout } from "./ai/chartRecipes";
145
+ export type { AccessibilityTableField, AccessibilityExpectations, AudienceFitDefinition, ChartRecipe as ChartRecipeDefinition, ChartRecipeFrameFamily, ChartRecipePortability, CustomLayoutFunction, DataRoleDefinition, DataSemanticType, DescriptionStrategy, DesignContractDefinition, EncodingChannel, EncodingDefinition, IntentDefinition, LiteracyTargetDefinition, NavigationStrategy, PortableNavigationStrategy, RecipeAudienceDefinition, RecipeAuditExpectations, RecipeDescription, RecipeExample, RecipeStrategyContext, RecipePortabilityConfig, ReceptionDefinition, RegisteredRecipeLayout, SerializableSchema } from "./ai/chartRecipes";
146
+ export { registerChartRecipe, unregisterChartRecipe, getChartRecipe, listChartRecipes, resolveChartRecipe, registerRecipeLayout, unregisterRecipeLayout, getRecipeLayout } from "./ai/chartRecipeRegistry";
147
+ export { ChartRecipe } from "./ai/ChartRecipe";
148
+ export type { ChartRecipeProps } from "./ai/ChartRecipe";
149
+ export { recipeToChartCapability, resolveRecipeRoleField } from "./ai/recipeCapability";
150
+ export { describeRecipeChart } from "./ai/describeRecipeChart";
151
+ export type { DescribeRecipeChartOptions } from "./ai/describeRecipeChart";
152
+ export { buildRecipeNavigationTree } from "./ai/recipeNavigation";
153
+ export type { RecipeNavigationOptions } from "./ai/recipeNavigation";
154
+ export { auditObservedScene } from "./ai/observedSceneAudit";
155
+ export type { AuditObservedSceneInput, DeclaredRecipeSemantics, ObservedAuditFinding, ObservedAuditStatus, ObservedSceneAuditResult } from "./ai/observedSceneAudit";
156
+ export { auditVisualizationControls } from "./controls/controlAudit";
157
+ export type { AuditVisualizationControlsOptions, ControlAuditFinding, ControlAuditResult, ControlAuditStatus, } from "./controls/controlAudit";
158
+ export type { VisualizationControlDefinition } from "./controls/controlContract";
159
+ export { IntentMark } from "./ai/IntentMark";
160
+ export type { IntentMarkProps } from "./ai/IntentMark";
161
+ export { summarizeIntentManifest, intentManifestFromRecipe } from "./ai/intentManifest";
162
+ export type { IntentManifest, IntentManifestFromRecipeOptions } from "./ai/intentManifest";
117
163
  export { listIntents, getIntent, registerIntent, BUILT_IN_INTENT_IDS } from "./ai/intents";
118
164
  export type { BuiltInIntentId, IntentId, IntentDescriptor } from "./ai/intents";
119
165
  export { proposeVariant, evaluateVariantProposal, registerVariantDiscovery, getRegisteredVariantDiscovery, clearVariantDiscovery } from "./ai/variantDiscovery";
@@ -127,3 +173,5 @@ export type { ConversationArcEvent, ConversationArcEventType, ConversationArcEve
127
173
  export { useChartObserver } from "./store/useObservation";
128
174
  export type { UseChartObserverOptions, UseChartObserverResult } from "./store/useObservation";
129
175
  export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation } from "./store/ObservationStore";
176
+ export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
177
+ export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Lightweight, frame-independent visualization controls.
3
+ *
4
+ * Import from `semiotic/controls` when a chart needs accessible HTML or SVG
5
+ * controls but does not need a frame renderer in the same bundle. Frame-owned
6
+ * brushing remains in `semiotic/xy` and `semiotic/ordinal` because it depends
7
+ * on frame scales, streaming state, and selection stores.
8
+ */
9
+ export { DirectManipulationControl, } from "./DirectManipulationControl";
10
+ export type { DirectManipulationControlProps, } from "./DirectManipulationControl";
11
+ export { createControlObservationAdapter, VISUALIZATION_CONTROL_TYPES, } from "./controls/controlContract";
12
+ export type { ControlInputSource, ControlObservation, ControlObservationAdapterOptions, ControlObservationCallback, ControlObservationPhase, VisualizationControlDefinition, VisualizationControlType, VisualizationControlValue, } from "./controls/controlContract";
13
+ export { auditVisualizationControls } from "./controls/controlAudit";
14
+ export type { AuditVisualizationControlsOptions, ControlAuditFinding, ControlAuditResult, ControlAuditStatus, } from "./controls/controlAudit";
15
+ export { CircularBrush } from "./CircularBrush";
16
+ export type { CircularBrushProps, CircularBrushValue } from "./CircularBrush";
17
+ export { MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, } from "./MobileStandardControls";
18
+ export type { MobileStandardControlLegendItem, MobileStandardBrushControls, MobileStandardZoomControls, MobileStandardLegendControls, MobileStandardControlsProps, MobileStandardControlRequest, UseMobileRangeControlsOptions, UseMobileRangeControlsResult, } from "./MobileStandardControls";
@@ -5,4 +5,6 @@
5
5
  export { bin, rollup, groupBy, pivot } from "./data/transforms";
6
6
  export { fromVegaLite } from "./data/fromVegaLite";
7
7
  export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
8
+ export { fromArrow } from "./data/fromArrow";
9
+ export type { ArrowTableLike, ArrowColumnLike, ArrowFieldLike, ArrowSchemaLike, FromArrowOptions, } from "./data/fromArrow";
8
10
  export { mergeData } from "./geo/mergeData";
@@ -0,0 +1,49 @@
1
+ /**
2
+ * Experimental entry point for temporary adapters and unstable previews.
3
+ *
4
+ * Anything imported from "semiotic/experimental" is intentionally outside
5
+ * Semiotic's stable public API. Exports may be renamed, moved, or removed
6
+ * without a deprecation window and are excluded from stable API-surface and
7
+ * bundle-size gates.
8
+ */
9
+ export { EXPERIMENTAL_GOFISH_ADAPTER_NAME, unstable_fromGofishIR } from "./recipes/gofishIR";
10
+ export type { GofishDisplayListDocument as UnstableGofishDisplayListDocument, GofishDisplayItem as UnstableGofishDisplayItem, GofishChartConfig as UnstableGofishChartConfig, FromGofishIROptions as UnstableFromGofishIROptions } from "./recipes/gofishIR";
11
+ export { gofishIRExamples as unstable_gofishIRExamples, flowerIR as unstable_gofishFlowerIR, treemapIR as unstable_gofishTreemapIR, bottleIR as unstable_gofishBottleIR, bobaIR as unstable_gofishBobaIR, pythonIR as unstable_gofishPythonIR } from "./recipes/gofishIRExamples";
12
+ export type { GofishIRExample as UnstableGofishIRExample } from "./recipes/gofishIRExamples";
13
+ 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";
14
+ 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";
15
+ 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";
16
+ 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";
17
+ export { fromObservablePlot as unstable_fromObservablePlot } from "./data/fromObservablePlot";
18
+ export { fromMermaid as unstable_fromMermaid } from "./data/fromMermaid";
19
+ export type { MermaidResult as UnstableMermaidResult, MermaidNode as UnstableMermaidNode, MermaidEdge as UnstableMermaidEdge, MermaidDirection as UnstableMermaidDirection, MermaidNodeShape as UnstableMermaidNodeShape } from "./data/fromMermaid";
20
+ export type { ObservablePlotSpec as UnstableObservablePlotSpec, ObservablePlotMark as UnstableObservablePlotMark, ObservablePlotMarkOptions as UnstableObservablePlotMarkOptions, ObservablePlotScale as UnstableObservablePlotScale, ObservablePlotChannel as UnstableObservablePlotChannel } from "./data/fromObservablePlot";
21
+ export { fromFlintChart as unstable_fromFlintChart } from "./data/fromFlintChart";
22
+ export type { FlintAggregate as UnstableFlintAggregate, FlintChartAssemblyInput as UnstableFlintChartAssemblyInput, FlintChartConfig as UnstableFlintChartConfig, FlintChartConfigMetadata as UnstableFlintChartConfigMetadata, FlintChartEncoding as UnstableFlintChartEncoding, FlintChartSize as UnstableFlintChartSize, FlintEncodingInput as UnstableFlintEncodingInput, FlintEncodingType as UnstableFlintEncodingType, FlintRawEncodingValue as UnstableFlintRawEncodingValue, FlintSemanticAnnotation as UnstableFlintSemanticAnnotation } from "./data/fromFlintChart";
23
+ export { DEFAULT_PHYSICS_CANVAS_THEME as unstable_DEFAULT_PHYSICS_CANVAS_THEME, physicsCanvasColorWithAlpha as unstable_physicsCanvasColorWithAlpha, resolvePhysicsCanvasTheme as unstable_resolvePhysicsCanvasTheme } from "./stream/physics/PhysicsCanvasTheme";
24
+ export { buildPhysicsSettledEvidence as unstable_buildPhysicsSettledEvidence } from "./stream/physics/PhysicsEvidence";
25
+ export { buildPhysicsSettledScene as unstable_buildPhysicsSettledScene, physicsBodiesToXYSceneNodes as unstable_physicsBodiesToXYSceneNodes, physicsBodyToXYSceneNode as unstable_physicsBodyToXYSceneNode } from "./stream/physics/PhysicsSettledScene";
26
+ export { renderPhysicsSettledSVG as unstable_renderPhysicsSettledSVG } from "./stream/physics/PhysicsSettledSVG";
27
+ export { collidersFromPhysicsAnnotations as unstable_collidersFromPhysicsAnnotations, resolvePhysicsBodyAnnotations as unstable_resolvePhysicsBodyAnnotations, summarizePhysicsAnnotations as unstable_summarizePhysicsAnnotations } from "./stream/physics/PhysicsAnnotations";
28
+ export { BuiltInPhysicsEngineAdapter as unstable_BuiltInPhysicsEngineAdapter, createDefaultPhysicsEngineAdapter as unstable_createDefaultPhysicsEngineAdapter } from "./stream/physics/PhysicsEngineAdapter";
29
+ export { PhysicsPipelineStore as unstable_PhysicsPipelineStore, collidersFromPlotBounds as unstable_collidersFromPlotBounds, collidersFromXScaleBins as unstable_collidersFromXScaleBins, schedulePhysicsSpawns as unstable_schedulePhysicsSpawns } from "./stream/physics/PhysicsPipelineStore";
30
+ export { evaluatePhysicsBodyBudget as unstable_evaluatePhysicsBodyBudget } from "./stream/physics/PhysicsBodyBudget";
31
+ export { PhysicsSedimentAccumulator as unstable_PhysicsSedimentAccumulator, sedimentHeightfield as unstable_sedimentHeightfield } from "./stream/physics/PhysicsSediment";
32
+ export { StreamPhysicsFrame as unstable_StreamPhysicsFrame } from "./stream/physics/StreamPhysicsFrame";
33
+ export { PhysicsCustomChart as unstable_PhysicsCustomChart } from "./charts/physics/PhysicsCustomChart";
34
+ export { buildPhysicsNavigationTree as unstable_buildPhysicsNavigationTree, buildPhysicsSettledProjection as unstable_buildPhysicsSettledProjection, physicsObservationAnnouncement as unstable_physicsObservationAnnouncement } from "./stream/physics/PhysicsAccessibility";
35
+ export type { PhysicsBoundsColliderOptions as UnstablePhysicsBoundsColliderOptions, PhysicsObservationEvent as UnstablePhysicsObservationEvent, PhysicsObservationEventType as UnstablePhysicsObservationEventType, PhysicsObservationRecord as UnstablePhysicsObservationRecord, PhysicsPipelineConfig as UnstablePhysicsPipelineConfig, PhysicsPipelineControlSurface as UnstablePhysicsPipelineControlSurface, PhysicsPipelineObservationOptions as UnstablePhysicsPipelineObservationOptions, PhysicsPipelineQueuedSpawnSnapshot as UnstablePhysicsPipelineQueuedSpawnSnapshot, PhysicsPipelineSnapshot as UnstablePhysicsPipelineSnapshot, PhysicsPipelineTickResult as UnstablePhysicsPipelineTickResult, PhysicsPlotBounds as UnstablePhysicsPlotBounds, PhysicsQueuedSpawn as UnstablePhysicsQueuedSpawn, PhysicsSensorObservationConfig as UnstablePhysicsSensorObservationConfig, PhysicsSimulationState as UnstablePhysicsSimulationState, PhysicsSpawnPacing as UnstablePhysicsSpawnPacing, PhysicsSpawnPacingOptions as UnstablePhysicsSpawnPacingOptions, PhysicsSpawnSpringSpec as UnstablePhysicsSpawnSpringSpec, PhysicsSpawnTimeAccessor as UnstablePhysicsSpawnTimeAccessor, PhysicsXBinColliderOptions as UnstablePhysicsXBinColliderOptions } from "./stream/physics/PhysicsPipelineStore";
36
+ export type { PhysicsBodyBudgetAction as UnstablePhysicsBodyBudgetAction, PhysicsBodyBudgetDecision as UnstablePhysicsBodyBudgetDecision, PhysicsBodyBudgetInput as UnstablePhysicsBodyBudgetInput, PhysicsBodyBudgetOptions as UnstablePhysicsBodyBudgetOptions, PhysicsBodyBudgetState as UnstablePhysicsBodyBudgetState } from "./stream/physics/PhysicsBodyBudget";
37
+ export type { PhysicsSedimentAccessor as UnstablePhysicsSedimentAccessor, PhysicsSedimentBinSnapshot as UnstablePhysicsSedimentBinSnapshot, PhysicsSedimentColumn as UnstablePhysicsSedimentColumn, PhysicsSedimentConfig as UnstablePhysicsSedimentConfig, PhysicsSedimentHeightfieldOptions as UnstablePhysicsSedimentHeightfieldOptions, PhysicsSedimentTotals as UnstablePhysicsSedimentTotals, PhysicsSedimentValueAccessor as UnstablePhysicsSedimentValueAccessor, RunningStatsSnapshot as UnstableRunningStatsSnapshot } from "./stream/physics/PhysicsSediment";
38
+ export type { PhysicsEngineAdapter as UnstablePhysicsEngineAdapter, PhysicsEngineAdapterFactory as UnstablePhysicsEngineAdapterFactory, PhysicsEngineAdapterInput as UnstablePhysicsEngineAdapterInput, PhysicsEngineCapabilities as UnstablePhysicsEngineCapabilities, PhysicsEngineDeterminism as UnstablePhysicsEngineDeterminism } from "./stream/physics/PhysicsEngineAdapter";
39
+ export type { PhysicsColliderShape as UnstablePhysicsColliderShape, PhysicsColliderSpec as UnstablePhysicsColliderSpec } from "./stream/physics/PhysicsKernel";
40
+ export type { PhysicsCanvasTheme as UnstablePhysicsCanvasTheme } from "./stream/physics/PhysicsCanvasTheme";
41
+ export type { PhysicsBodySelection as UnstablePhysicsBodySelection, PhysicsBodyStyleContext as UnstablePhysicsBodyStyleContext, StreamPhysicsExecutionState as UnstableStreamPhysicsExecutionState, StreamPhysicsFrameHandle as UnstableStreamPhysicsFrameHandle, StreamPhysicsFrameProps as UnstableStreamPhysicsFrameProps } from "./stream/physics/StreamPhysicsFrame";
42
+ export type { PhysicsCustomChartProps as UnstablePhysicsCustomChartProps, PhysicsCustomLayout as UnstablePhysicsCustomLayout, PhysicsCustomLayoutContext as UnstablePhysicsCustomLayoutContext, PhysicsCustomLayoutResult as UnstablePhysicsCustomLayoutResult, PhysicsCustomSpawnDatumResult as UnstablePhysicsCustomSpawnDatumResult } from "./charts/physics/PhysicsCustomChart";
43
+ export type { PhysicsExecution as UnstablePhysicsExecution } from "./stream/physics/PhysicsWorkerProtocol";
44
+ 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";
45
+ export type { PhysicsEvidenceBinCount as UnstablePhysicsEvidenceBinCount, PhysicsSettledEvidence as UnstablePhysicsSettledEvidence, PhysicsSettledEvidenceOptions as UnstablePhysicsSettledEvidenceOptions } from "./stream/physics/PhysicsEvidence";
46
+ export type { PhysicsSettledScene as UnstablePhysicsSettledScene, PhysicsSettledSceneOptions as UnstablePhysicsSettledSceneOptions } from "./stream/physics/PhysicsSettledScene";
47
+ export type { PhysicsSettledSVGOptions as UnstablePhysicsSettledSVGOptions, PhysicsSettledSVGRender as UnstablePhysicsSettledSVGRender } from "./stream/physics/PhysicsSettledSVG";
48
+ export type { PhysicsNavigationTreeOptions as UnstablePhysicsNavigationTreeOptions, PhysicsObservationAnnouncementOptions as UnstablePhysicsObservationAnnouncementOptions, PhysicsProjectionBodySummary as UnstablePhysicsProjectionBodySummary, PhysicsProjectionContainerSpec as UnstablePhysicsProjectionContainerSpec, PhysicsSettledProjectionOptions as UnstablePhysicsSettledProjectionOptions, PhysicsSettledProjectionRow as UnstablePhysicsSettledProjectionRow } from "./stream/physics/PhysicsAccessibility";
49
+ 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";
@@ -8,7 +8,17 @@ export { ChoroplethMap } from "./charts/geo/ChoroplethMap";
8
8
  export { ProportionalSymbolMap } from "./charts/geo/ProportionalSymbolMap";
9
9
  export { FlowMap } from "./charts/geo/FlowMap";
10
10
  export { DistanceCartogram } from "./charts/geo/DistanceCartogram";
11
+ export { GeoCustomChart } from "./charts/custom/GeoCustomChart";
12
+ export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
13
+ export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./charts/shared/responsiveRules";
14
+ export { geoHitTarget, geoAreaHitTarget, hitTargetPoint, DEFAULT_HIT_RADIUS } from "./stream/hitTarget";
15
+ export type { GeoAreaHitTargetProps, HitTargetPointProps } from "./stream/hitTarget";
16
+ export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
17
+ export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
18
+ export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types";
11
19
  export type { StreamGeoFrameProps, StreamGeoFrameHandle, GeoAreaSceneNode, GeoSceneNode, GeoScales, ProjectionProp, ProjectionName, GraticuleConfig, DistanceCartogramConfig, GeoPipelineConfig } from "./stream/geoTypes";
20
+ export type { GeoCustomLayout, GeoLayoutContext, GeoLayoutResult } from "./stream/geoCustomLayout";
21
+ export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
12
22
  export type { GeoParticleStyle } from "./stream/GeoParticlePool";
13
23
  export { mergeData } from "./geo/mergeData";
14
24
  export { resolveReferenceGeography } from "./geo/referenceGeography";
@@ -18,3 +28,4 @@ export type { ChoroplethMapProps } from "./charts/geo/ChoroplethMap";
18
28
  export type { ProportionalSymbolMapProps } from "./charts/geo/ProportionalSymbolMap";
19
29
  export type { FlowMapProps } from "./charts/geo/FlowMap";
20
30
  export type { DistanceCartogramProps } from "./charts/geo/DistanceCartogram";
31
+ export type { GeoCustomChartProps } from "./charts/custom/GeoCustomChart";
@@ -5,6 +5,8 @@
5
5
  import StreamNetworkFrame from "./stream/StreamNetworkFrame";
6
6
  export { StreamNetworkFrame };
7
7
  export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
8
+ export { useForceLayout } from "./charts/network/useForceLayout";
9
+ export type { ForceLayoutStatus, UseForceLayoutResult } from "./charts/network/useForceLayout";
8
10
  export { SankeyDiagram } from "./charts/network/SankeyDiagram";
9
11
  export { ChordDiagram } from "./charts/network/ChordDiagram";
10
12
  export { TreeDiagram } from "./charts/network/TreeDiagram";
@@ -13,6 +15,17 @@ export { CirclePack } from "./charts/network/CirclePack";
13
15
  export { OrbitDiagram } from "./charts/network/OrbitDiagram";
14
16
  export { ProcessSankey } from "./charts/network/ProcessSankey";
15
17
  export { NetworkCustomChart } from "./charts/custom/NetworkCustomChart";
18
+ export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
19
+ export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./charts/shared/responsiveRules";
20
+ export { useCustomLayoutSelection } from "./stream/customLayoutSelection";
21
+ export type { CustomLayoutSelection } from "./stream/customLayoutSelection";
22
+ export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
23
+ export { networkHitTarget, DEFAULT_HIT_RADIUS } from "./stream/hitTarget";
24
+ export type { NetworkHitTargetCircleProps, NetworkHitTargetRectProps } from "./stream/hitTarget";
25
+ export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
26
+ export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
27
+ export type { NetworkGlyphNode } from "./stream/networkTypes";
28
+ export type { SceneAccessibilityMetadata } from "./stream/types";
16
29
  export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
17
30
  export type { ForceDirectedGraphProps } from "./charts/network/ForceDirectedGraph";
18
31
  export type { SankeyDiagramProps } from "./charts/network/SankeyDiagram";
@@ -23,6 +36,6 @@ export type { TreemapProps } from "./charts/network/Treemap";
23
36
  export type { CirclePackProps } from "./charts/network/CirclePack";
24
37
  export type { OrbitDiagramProps } from "./charts/network/OrbitDiagram";
25
38
  export type { NetworkCustomChartProps } from "./charts/custom/NetworkCustomChart";
26
- export type { NetworkCustomLayout, NetworkLayoutContext, NetworkLayoutResult, } from "./stream/networkCustomLayout";
39
+ export type { NetworkCustomLayout, NetworkLayoutContext, NetworkLayoutResult, NetworkHtmlMark, } from "./stream/networkCustomLayout";
27
40
  export { validateProcessSankey, formatProcessSankeyIssue, } from "./charts/network/processSankey/algorithm";
28
41
  export type { ProcessSankeyNode as ProcessSankeyValidatorNode, ProcessSankeyEdge as ProcessSankeyValidatorEdge, ProcessSankeyIssue, } from "./charts/network/processSankey/algorithm";
@@ -21,6 +21,16 @@ export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
21
21
  export { FunnelChart } from "./charts/ordinal/FunnelChart";
22
22
  export { LikertChart } from "./charts/ordinal/LikertChart";
23
23
  export { OrdinalCustomChart } from "./charts/custom/OrdinalCustomChart";
24
+ export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
25
+ export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./charts/shared/responsiveRules";
26
+ export { useCustomLayoutSelection } from "./stream/customLayoutSelection";
27
+ export type { CustomLayoutSelection } from "./stream/customLayoutSelection";
28
+ export type { CustomLayoutFailureDiagnostic, CustomLayoutFailureRecovery, CustomLayoutFamily } from "./stream/customLayoutFailure";
29
+ export { hitTargetPoint, hitTargetRect, DEFAULT_HIT_RADIUS } from "./stream/hitTarget";
30
+ export type { HitTargetPointProps, HitTargetRectProps } from "./stream/hitTarget";
31
+ export { glyphPlacement, glyphExtent } from "./stream/glyphDef";
32
+ export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
33
+ export type { GlyphSceneNode, SceneAccessibilityMetadata } from "./stream/types";
24
34
  export { createHatchPattern } from "./charts/shared/hatchPattern";
25
35
  export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
26
36
  export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Optional Matter.js physics migration helpers.
3
+ *
4
+ * Import from "semiotic/physics/matter" so Matter.js stays out of the default
5
+ * "semiotic/physics" bundle.
6
+ */
7
+ export { MATTER_PHYSICS_CAPABILITIES, MATTER_PHYSICS_IMPORT_PATH, MATTER_PHYSICS_INSTALL, MATTER_PHYSICS_PACKAGE, loadMatterPhysicsPeer, matterBodiesToPhysicsColliders, matterBodiesToPhysicsSpawns, matterBodyToPhysicsBodySpec, matterBodyToPhysicsColliderSpec, matterPhysicsDependencyError } from "./stream/physics/MatterPhysicsEngineAdapter";
8
+ export { PhysicsOptionalEngineDependencyError, loadOptionalPhysicsPeer, optionalEngineDependencyError } from "./stream/physics/PhysicsOptionalEngineAdapters";
9
+ export type { MatterBodyLike, MatterBoundsLike, MatterMigrationOptions, MatterVectorLike } from "./stream/physics/MatterPhysicsEngineAdapter";
10
+ export type { PhysicsOptionalEngineInstallDetails } from "./stream/physics/PhysicsOptionalEngineAdapters";
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Optional Rapier physics adapter guard and decision metadata.
3
+ *
4
+ * Import from "semiotic/physics/rapier" so Rapier's WASM package stays out of
5
+ * the default "semiotic/physics" bundle.
6
+ */
7
+ export { RAPIER_PHYSICS_CAPABILITIES, RAPIER_PHYSICS_ENGINE_DECISION, RAPIER_PHYSICS_IMPORT_PATH, RAPIER_PHYSICS_INSTALL, RAPIER_PHYSICS_PACKAGE, loadRapierPhysicsPeer, rapierPhysicsDependencyError } from "./stream/physics/RapierPhysicsEngineAdapter";
8
+ export { PhysicsOptionalEngineDependencyError, loadOptionalPhysicsPeer, optionalEngineDependencyError } from "./stream/physics/PhysicsOptionalEngineAdapters";
9
+ export type { PhysicsOptionalEngineInstallDetails } from "./stream/physics/PhysicsOptionalEngineAdapters";