semiotic 3.9.0 → 3.9.2

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 (331) hide show
  1. package/README.md +102 -90
  2. package/agent-skill/semiotic-charts/SKILL.md +14 -10
  3. package/ai/componentMetadata.cjs +13 -3
  4. package/ai/dist/mcp-server.js +140 -36407
  5. package/ai/examples.md +109 -6
  6. package/ai/reference.md +55 -18
  7. package/ai/schema.json +5964 -1190
  8. package/ai/surface-manifest.json +51 -7
  9. package/ai/system-prompt.md +16 -3
  10. package/dist/c-3SCUN5HI.min.js +1 -0
  11. package/dist/c-3VVKFA4M.min.js +1 -0
  12. package/dist/c-43TJZS3F.min.js +1 -0
  13. package/dist/c-4DTZPSUD.min.js +1 -0
  14. package/dist/c-4ES5367Y.min.js +1 -0
  15. package/dist/c-54IRWOGM.min.js +1 -0
  16. package/dist/c-5D2S4RMI.min.js +1 -0
  17. package/dist/c-5JWCTX3G.min.js +1 -0
  18. package/dist/c-6CMMSN6N.min.js +1 -0
  19. package/dist/c-6HRB2L7H.min.js +1 -0
  20. package/dist/c-7W4SV36A.min.js +1 -0
  21. package/dist/c-A4WRGZFX.min.js +1 -0
  22. package/dist/c-AG7WWVIH.min.js +1 -0
  23. package/dist/c-AH6J4MTN.min.js +1 -0
  24. package/dist/c-ALYR5LKK.min.js +1 -0
  25. package/dist/c-BYDPC44I.min.js +1 -0
  26. package/dist/c-CFFIU2MW.min.js +1 -0
  27. package/dist/c-CGNHBHCE.min.js +1 -0
  28. package/dist/c-CJYSXIFV.min.js +1 -0
  29. package/dist/c-CKLIFCGN.min.js +1 -0
  30. package/dist/c-CZF7MV67.min.js +1 -0
  31. package/dist/c-D53OKBSY.min.js +1 -0
  32. package/dist/c-DBQ2V7CH.min.js +1 -0
  33. package/dist/c-DPMVAUAW.min.js +1 -0
  34. package/dist/c-ECJCKLYY.min.js +1 -0
  35. package/dist/c-EGATGOWJ.min.js +1 -0
  36. package/dist/c-EGR6VYBW.min.js +1 -0
  37. package/dist/c-ENF72HU5.min.js +1 -0
  38. package/dist/c-ESNR43AN.min.js +1 -0
  39. package/dist/c-F3LIKINL.min.js +1 -0
  40. package/dist/c-F5ZB5GJ6.min.js +1 -0
  41. package/dist/c-G3VYMHKE.min.js +1 -0
  42. package/dist/c-GR6MOEQC.min.js +1 -0
  43. package/dist/c-GSVCN34B.min.js +1 -0
  44. package/dist/c-GYOQCEFP.min.js +1 -0
  45. package/dist/c-H3DNMTCC.min.js +1 -0
  46. package/dist/c-I6J3FEZE.min.js +1 -0
  47. package/dist/c-IGH6MGJ5.min.js +1 -0
  48. package/dist/c-II2EEAJN.min.js +1 -0
  49. package/dist/c-J6M4JHRS.min.js +1 -0
  50. package/dist/c-JM3MGLQV.min.js +1 -0
  51. package/dist/c-KM3N7F7R.min.js +1 -0
  52. package/dist/c-LF5BZFNC.min.js +1 -0
  53. package/dist/c-LKBSGFQC.min.js +1 -0
  54. package/dist/c-NDJADPIF.min.js +1 -0
  55. package/dist/c-NVPQCIL5.min.js +1 -0
  56. package/dist/c-OFWJBEE5.min.js +1 -0
  57. package/dist/c-OYFHP5F5.min.js +1 -0
  58. package/dist/c-PGKQGGQ2.min.js +1 -0
  59. package/dist/c-Q2IPZ3MU.min.js +1 -0
  60. package/dist/c-QKHMBE2E.min.js +1 -0
  61. package/dist/c-QMVM3AY6.min.js +1 -0
  62. package/dist/c-QSGWX53A.min.js +1 -0
  63. package/dist/c-RJKEKZOO.min.js +1 -0
  64. package/dist/c-SFDIIU5G.min.js +1 -0
  65. package/dist/c-SRTBCRVE.min.js +1 -0
  66. package/dist/c-T6UAIKBH.min.js +1 -0
  67. package/dist/c-TMCTEVVW.min.js +1 -0
  68. package/dist/c-TMOSJLT3.min.js +1 -0
  69. package/dist/c-U6ESPM7V.min.js +1 -0
  70. package/dist/c-UC5PTTFI.min.js +1 -0
  71. package/dist/c-VGKUEZBC.min.js +1 -0
  72. package/dist/c-VN2HG5BS.min.js +1 -0
  73. package/dist/{c-J5G56TUH.min.js → c-VPZDY5Q4.min.js} +1 -1
  74. package/dist/c-VRXUB2F2.min.js +1 -0
  75. package/dist/c-VUBQNQJH.min.js +1 -0
  76. package/dist/c-VUH4PGZY.min.js +1 -0
  77. package/dist/c-XDRV7RKW.min.js +1 -0
  78. package/dist/c-YGZHURXZ.min.js +1 -0
  79. package/dist/components/Annotation.d.ts +1 -1
  80. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  81. package/dist/components/access/chartAccessContract.d.ts +90 -0
  82. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  83. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  84. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  85. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  86. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  87. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  88. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  89. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  90. package/dist/components/ai/chartRecipeRegistry.d.ts +2 -1
  91. package/dist/components/ai/chartRecipes.d.ts +6 -0
  92. package/dist/components/ai/colorEvidence.d.ts +12 -0
  93. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  94. package/dist/components/ai/geoNavigation.d.ts +4 -0
  95. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  96. package/dist/components/ai/navigationTree.d.ts +7 -1
  97. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  98. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  99. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  100. package/dist/components/charts/index.d.ts +4 -0
  101. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  102. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  103. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  104. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  105. package/dist/components/charts/network/Treemap.d.ts +8 -1
  106. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  107. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  108. package/dist/components/charts/ordinal/DonutChart.d.ts +3 -0
  109. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  110. package/dist/components/charts/ordinal/FunnelChart.d.ts +3 -0
  111. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  112. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  113. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  114. package/dist/components/charts/ordinal/PieChart.d.ts +3 -0
  115. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  116. package/dist/components/charts/ordinal/RadarChart.d.ts +75 -0
  117. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  118. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  119. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  120. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  121. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  122. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  123. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  124. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  125. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +10 -1
  126. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +11 -1
  127. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +14 -5
  128. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +7 -1
  129. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
  130. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  131. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +4 -2
  132. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  133. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  134. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  135. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  136. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  137. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  138. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  139. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  140. package/dist/components/charts/shared/types.d.ts +4 -2
  141. package/dist/components/charts/shared/useChartLegend.d.ts +2 -1
  142. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  143. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  144. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  145. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  146. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  147. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  148. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  149. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  150. package/dist/components/charts/xy/WaterfallChart.d.ts +68 -0
  151. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +146 -0
  152. package/dist/components/evidence/evidenceGate.d.ts +28 -0
  153. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  154. package/dist/components/realtime/types.d.ts +16 -7
  155. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  156. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  157. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  158. package/dist/components/recipes/lineageDag.d.ts +17 -0
  159. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  160. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  161. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  162. package/dist/components/semiotic-access.d.ts +9 -0
  163. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  164. package/dist/components/semiotic-ai-core.d.ts +9 -0
  165. package/dist/components/semiotic-ai.d.ts +5 -17
  166. package/dist/components/semiotic-evidence.d.ts +10 -0
  167. package/dist/components/semiotic-line.d.ts +9 -0
  168. package/dist/components/semiotic-network.d.ts +3 -0
  169. package/dist/components/semiotic-ordinal.d.ts +2 -0
  170. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  171. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  172. package/dist/components/semiotic-themes-core.d.ts +3 -0
  173. package/dist/components/semiotic-utils-core.d.ts +5 -0
  174. package/dist/components/semiotic-utils.d.ts +1 -1
  175. package/dist/components/semiotic-xy.d.ts +3 -0
  176. package/dist/components/semiotic.d.ts +9 -3
  177. package/dist/components/server/renderDashboard.d.ts +37 -0
  178. package/dist/components/server/renderEvidence.d.ts +27 -0
  179. package/dist/components/server/renderToStaticSVG.d.ts +2 -30
  180. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  181. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  182. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  183. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  184. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  185. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  186. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  187. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  188. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  189. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  190. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  191. package/dist/components/store/selectionProvenance.d.ts +8 -0
  192. package/dist/components/store/themeCore.d.ts +5 -1
  193. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  194. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  195. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  196. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  197. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  198. package/dist/components/stream/PipelineStore.d.ts +1 -1
  199. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  200. package/dist/components/stream/canvasSetup.d.ts +8 -2
  201. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  202. package/dist/components/stream/geoTypes.d.ts +1 -1
  203. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  204. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  205. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  206. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  207. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  208. package/dist/components/stream/layouts/index.d.ts +6 -12
  209. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  210. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  211. package/dist/components/stream/layouts/registry.d.ts +12 -0
  212. package/dist/components/stream/marginalConfig.d.ts +3 -0
  213. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  214. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  215. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  216. package/dist/components/stream/networkTypes.d.ts +5 -1
  217. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  218. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +1 -1
  219. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  220. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  221. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  222. package/dist/components/stream/types.d.ts +8 -1
  223. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  224. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  225. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  226. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  227. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  228. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  229. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  230. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  231. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  232. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  233. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  234. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  235. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  236. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  237. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  238. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  239. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  240. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  241. package/dist/forceLayoutWorker.js +1 -1
  242. package/dist/geo.min.js +1 -1
  243. package/dist/geo.module.min.js +1 -1
  244. package/dist/network.module.min.js +1 -1
  245. package/dist/ordinal.module.min.js +1 -1
  246. package/dist/physics.module.min.js +1 -1
  247. package/dist/rough.module.min.js +1 -1
  248. package/dist/semiotic-access.d.ts +9 -0
  249. package/dist/semiotic-access.min.js +2 -0
  250. package/dist/semiotic-access.module.min.js +2 -0
  251. package/dist/semiotic-ai-core.d.ts +9 -0
  252. package/dist/semiotic-ai-core.min.js +1 -1
  253. package/dist/semiotic-ai-core.module.min.js +1 -1
  254. package/dist/semiotic-ai.d.ts +5 -17
  255. package/dist/semiotic-ai.module.min.js +1 -1
  256. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  257. package/dist/semiotic-client-shared.module.min.js +1 -1
  258. package/dist/semiotic-evidence.d.ts +10 -0
  259. package/dist/semiotic-evidence.min.js +1 -0
  260. package/dist/semiotic-evidence.module.min.js +1 -0
  261. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  262. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  263. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  264. package/dist/semiotic-experimental-vacp.min.js +1 -1
  265. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  266. package/dist/semiotic-line.d.ts +9 -0
  267. package/dist/semiotic-line.min.js +2 -0
  268. package/dist/semiotic-line.module.min.js +2 -0
  269. package/dist/semiotic-network.d.ts +3 -0
  270. package/dist/semiotic-ordinal.d.ts +2 -0
  271. package/dist/semiotic-realtime-core.d.ts +3 -2
  272. package/dist/semiotic-realtime-core.module.min.js +1 -1
  273. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  274. package/dist/semiotic-recipes-core.d.ts +6 -0
  275. package/dist/semiotic-recipes-core.module.min.js +1 -1
  276. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  277. package/dist/semiotic-server-edge.min.js +1 -1
  278. package/dist/semiotic-server-edge.module.min.js +1 -1
  279. package/dist/semiotic-server-node.min.js +1 -1
  280. package/dist/semiotic-server-node.module.min.js +1 -1
  281. package/dist/semiotic-themes-core.d.ts +3 -0
  282. package/dist/semiotic-themes-core.min.js +1 -1
  283. package/dist/semiotic-themes-core.module.min.js +1 -1
  284. package/dist/semiotic-themes.min.js +1 -1
  285. package/dist/semiotic-themes.module.min.js +1 -1
  286. package/dist/semiotic-utils-core.d.ts +5 -0
  287. package/dist/semiotic-utils-core.min.js +1 -1
  288. package/dist/semiotic-utils-core.module.min.js +1 -1
  289. package/dist/semiotic-utils.d.ts +1 -1
  290. package/dist/semiotic-utils.module.min.js +1 -1
  291. package/dist/semiotic-xy.d.ts +3 -0
  292. package/dist/semiotic.d.ts +9 -3
  293. package/dist/semiotic.module.min.js +1 -1
  294. package/dist/server.min.js +1 -1
  295. package/dist/server.module.min.js +1 -1
  296. package/dist/xy.module.min.js +1 -1
  297. package/package.json +39 -60
  298. package/dist/c-3KZD6AXJ.min.js +0 -1
  299. package/dist/c-4TWEX5HG.min.js +0 -1
  300. package/dist/c-5YCIX3VZ.min.js +0 -1
  301. package/dist/c-6FEKTA3U.min.js +0 -1
  302. package/dist/c-74HEEZGK.min.js +0 -1
  303. package/dist/c-BWNB6USU.min.js +0 -1
  304. package/dist/c-C25ENHIK.min.js +0 -1
  305. package/dist/c-CDR5AO3R.min.js +0 -1
  306. package/dist/c-E3JFRRMI.min.js +0 -1
  307. package/dist/c-EBFPQHHO.min.js +0 -1
  308. package/dist/c-GIKRQI4X.min.js +0 -1
  309. package/dist/c-GPYOFETM.min.js +0 -1
  310. package/dist/c-IDUHYYSI.min.js +0 -1
  311. package/dist/c-JAZ73J32.min.js +0 -1
  312. package/dist/c-KG3NXHAL.min.js +0 -1
  313. package/dist/c-KII3PLZE.min.js +0 -1
  314. package/dist/c-LIXGXMNS.min.js +0 -1
  315. package/dist/c-LVEY6D6B.min.js +0 -1
  316. package/dist/c-M4Y3BHFR.min.js +0 -1
  317. package/dist/c-MAIICR2Z.min.js +0 -1
  318. package/dist/c-MG5DM6VE.min.js +0 -1
  319. package/dist/c-O6U6K4CW.min.js +0 -1
  320. package/dist/c-OQ7M4AGV.min.js +0 -1
  321. package/dist/c-OXYMVK7Q.min.js +0 -1
  322. package/dist/c-QHF5YON3.min.js +0 -1
  323. package/dist/c-RR3GO5SW.min.js +0 -1
  324. package/dist/c-S2BXNNJN.min.js +0 -1
  325. package/dist/c-SUILCHWU.min.js +0 -1
  326. package/dist/c-US5ZFT6E.min.js +0 -1
  327. package/dist/c-UUKVD4WB.min.js +0 -1
  328. package/dist/c-WJCD5EUY.min.js +0 -1
  329. package/dist/c-YDAY2WFR.min.js +0 -1
  330. package/dist/c-ZOWWU34K.min.js +0 -1
  331. /package/dist/{c-COHXCW3Q.min.js → c-YZVRZGX2.min.js} +0 -0
@@ -10,6 +10,7 @@ export { CORE_KIND, POSITIVE_KIND, NEGATIVE_KIND } from "./gauntletTypes";
10
10
  export type { GauntletAccessors, GauntletBodyDatum, GauntletCoreBodyFn, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectPlacementFn, GauntletProjectState, GauntletPropertyDefinition, GauntletPropertyForceContext, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions, GauntletViabilityFn } from "./gauntletTypes";
11
11
  export declare const DEFAULT_WIDTH = 900;
12
12
  export declare const DEFAULT_HEIGHT = 520;
13
+ export declare const EMPTY_GAUNTLET_PROPERTIES: readonly GauntletPropertyDefinition[];
13
14
  export declare function gauntletWallColliders(layout: Pick<GauntletLayout, "width" | "floorY"> & Partial<Pick<GauntletLayout, "height">>): NonNullable<PhysicsPipelineConfig["colliders"]>;
14
15
  export declare function readAccessor<TDatum extends Datum, TValue>(datum: TDatum, index: number, accessor: ChartAccessor<TDatum, TValue> | undefined, fallback: TValue): TValue;
15
16
  export declare function propertyLabel(property: GauntletPropertyDefinition | undefined): string;
@@ -27,7 +27,13 @@ export type PhysicsSharedChartProps = {
27
27
  selection?: PhysicsChartSelection;
28
28
  /** Emit hover into the shared selection store for cross-chart highlighting. */
29
29
  linkedHover?: LinkedHoverProp;
30
+ /**
31
+ * Observe the physics pipeline entering or leaving its running/settled
32
+ * states. This composes with chart-owned observation and rerun behavior.
33
+ */
34
+ onSimulationStateChange?: PhysicsSimulationStateChange;
30
35
  };
36
+ export type PhysicsSimulationStateChange = NonNullable<NonNullable<NonNullable<StreamPhysicsFrameProps["config"]>["observation"]>["onSimulationStateChange"]>;
31
37
  /**
32
38
  * What a physics HOC's `selection` prop accepts.
33
39
  *
@@ -71,7 +77,7 @@ export type PhysicsRerunMS = number | null;
71
77
  * Remounting is intentional: it replays the chart's deterministic seed,
72
78
  * initial bodies, and spawn pacing instead of trying to reverse a live store.
73
79
  */
74
- export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void): {
80
+ export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void, externalStateChange?: PhysicsSimulationStateChange): {
75
81
  config: StreamPhysicsFrameProps["config"];
76
82
  rerunKey: number;
77
83
  };
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
15
16
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
17
  mode?: ChartMode;
@@ -26,7 +27,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
26
27
  width?: number;
27
28
  /** Chart height (alternative to size) */
28
29
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
31
  maxDevicePixelRatio?: number;
31
32
  /** Chart margins */
32
33
  margin?: PartialMargin;
@@ -66,6 +67,11 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
66
67
  customColorScale?: (value: number) => string;
67
68
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
68
69
  cursor?: CSSProperties["cursor"];
70
+ /**
71
+ * Ordered styling for displayed aggregate cells. Rule `value` is the chosen
72
+ * aggregate; `count`, `sum`, `xCenter`, `yCenter`, and `agg` are fields.
73
+ */
74
+ styleRules?: StyleRule[];
69
75
  /** Show canvas-drawn axes */
70
76
  showAxes?: boolean;
71
77
  /** Background fill color */
@@ -158,6 +164,9 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
158
164
  * ```
159
165
  */
160
166
  export declare const RealtimeHeatmap: {
167
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
161
168
  <TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
169
+ /** Typed refs retain the authored row through mutation and readback. */
170
+ <TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
162
171
  displayName?: string;
163
172
  };
@@ -12,6 +12,7 @@ import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { LegendValue } from "../../types/legendTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
14
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
15
+ import { type StyleRule } from "../shared/styleRules";
15
16
  export type RealtimeHistogramDirection = "up" | "down";
16
17
  export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
17
18
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
@@ -30,7 +31,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
30
31
  width?: number;
31
32
  /** Chart height (alternative to size) */
32
33
  height?: number;
33
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
34
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
34
35
  maxDevicePixelRatio?: number;
35
36
  /** Chart margins */
36
37
  margin?: PartialMargin;
@@ -84,6 +85,11 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
84
85
  opacity?: number;
85
86
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
86
87
  cursor?: CSSProperties["cursor"];
88
+ /**
89
+ * Ordered styling for displayed bins. Rule `value` is `categoryValue` for a
90
+ * stacked segment or `total` for an unstacked bin; `x` is the bin center.
91
+ */
92
+ styleRules?: StyleRule[];
87
93
  /** Gap between bars in pixels */
88
94
  gap?: number;
89
95
  /** Show canvas-drawn axes */
@@ -196,7 +202,10 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
196
202
  * ```
197
203
  */
198
204
  export declare const RealtimeHistogram: {
205
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
199
206
  <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
207
+ /** Typed refs retain the authored row through mutation and readback. */
208
+ <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
200
209
  displayName?: string;
201
210
  };
202
211
  export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
@@ -217,6 +226,7 @@ export declare namespace TemporalHistogram {
217
226
  * written before the rename and will be removed in a future major version. */
218
227
  export declare const RealtimeTemporalHistogram: {
219
228
  <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
229
+ <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
220
230
  displayName?: string;
221
231
  };
222
232
  /** @deprecated Use `RealtimeHistogramProps` instead. Same component, just the
@@ -9,16 +9,17 @@ import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
10
  import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
- import { type AggregateConfig } from "./aggregate";
12
+ import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
13
13
  import { type EventTimeConfig } from "./eventTime";
14
14
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
15
15
  import type { PartialMargin } from "../../types/marginType";
16
+ import { type StyleRule } from "../shared/styleRules";
16
17
  /**
17
18
  * Imperative handle for RealtimeLineChart. It extends the shared realtime
18
19
  * handle without changing that cross-chart contract: only this chart exposes
19
20
  * event-time tail flushing.
20
21
  */
21
- export interface RealtimeLineChartHandle extends RealtimeFrameHandle {
22
+ export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
22
23
  /**
23
24
  * Release every event still held by `eventTime`, in event-time order.
24
25
  * Call this when an input source reaches an asserted end-of-stream or batch
@@ -42,7 +43,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
42
43
  width?: number;
43
44
  /** Chart height (alternative to size) */
44
45
  height?: number;
45
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
46
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
46
47
  maxDevicePixelRatio?: number;
47
48
  /** Chart margins */
48
49
  margin?: PartialMargin;
@@ -78,6 +79,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
78
79
  opacity?: number;
79
80
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
81
  cursor?: CSSProperties["cursor"];
82
+ /** Ordered data-aware line styling, resolved against the displayed series sample. */
83
+ styleRules?: StyleRule[];
81
84
  /** Show canvas-drawn axes */
82
85
  showAxes?: boolean;
83
86
  /** Background fill color */
@@ -199,7 +202,13 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
199
202
  export declare const RealtimeLineChart: {
200
203
  /** Compatibility overload for refs authored against the shared 3.x handle. */
201
204
  <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
202
- /** Specific overload keeps ElementRef/ComponentRef aware of flush(). */
203
- <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeLineChartHandle>): React.ReactElement | null;
205
+ /** Aggregate mode accepts authored rows but materializes window summaries. */
206
+ <TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
207
+ aggregate: AggregateConfig;
208
+ } & React.RefAttributes<RealtimeLineChartHandle<TDatum, AggregatedRealtimeDatum>>): React.ReactElement | null;
209
+ /** Typed non-aggregate refs retain the authored row and expose flush(). */
210
+ <TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
211
+ aggregate?: undefined;
212
+ } & React.RefAttributes<RealtimeLineChartHandle<TDatum>>): React.ReactElement | null;
204
213
  displayName?: string;
205
214
  };
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
15
16
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
17
  mode?: ChartMode;
@@ -26,7 +27,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
26
27
  width?: number;
27
28
  /** Chart height (alternative to size) */
28
29
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
31
  maxDevicePixelRatio?: number;
31
32
  /** Chart margins */
32
33
  margin?: PartialMargin;
@@ -82,6 +83,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
82
83
  pointStyle?: (datum: TDatum) => Style & {
83
84
  r?: number;
84
85
  };
86
+ /** Ordered data-aware dot styling, applied before `pointStyle`. */
87
+ styleRules?: StyleRule[];
85
88
  /** Show canvas-drawn axes */
86
89
  showAxes?: boolean;
87
90
  /** Background fill color */
@@ -162,6 +165,9 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
162
165
  * ```
163
166
  */
164
167
  export declare const RealtimeSwarmChart: {
168
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
165
169
  <TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
170
+ /** Typed refs retain the authored row through mutation and readback. */
171
+ <TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
166
172
  displayName?: string;
167
173
  };
@@ -11,6 +11,7 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
15
16
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
17
  mode?: ChartMode;
@@ -26,7 +27,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
26
27
  width?: number;
27
28
  /** Chart height (alternative to size) */
28
29
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
30
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
31
  maxDevicePixelRatio?: number;
31
32
  /** Chart margins */
32
33
  margin?: PartialMargin;
@@ -78,6 +79,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
78
79
  opacity?: number;
79
80
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
81
  cursor?: CSSProperties["cursor"];
82
+ /** Ordered data-aware bar styling. Rule `value`/`y` is the displayed delta. */
83
+ styleRules?: StyleRule[];
81
84
  /** Show canvas-drawn axes */
82
85
  showAxes?: boolean;
83
86
  /** Background fill color */
@@ -157,6 +160,9 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
157
160
  * ```
158
161
  */
159
162
  export declare const RealtimeWaterfallChart: {
163
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
160
164
  <TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
165
+ /** Typed refs retain the authored row through mutation and readback. */
166
+ <TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
161
167
  displayName?: string;
162
168
  };
@@ -36,6 +36,17 @@ export declare const AGG_PARTIAL = "__aggPartial";
36
36
  export declare const AGG_COUNT = "count";
37
37
  export declare const AGG_START = "__aggStart";
38
38
  export declare const AGG_END = "__aggEnd";
39
+ /** Materialized row returned by RealtimeLineChart in aggregate mode. */
40
+ export interface AggregatedRealtimeDatum extends Datum {
41
+ time: number;
42
+ value: number;
43
+ count: number;
44
+ __aggPartial: boolean;
45
+ __aggStart: number;
46
+ __aggEnd: number;
47
+ __aggLower?: number;
48
+ __aggUpper?: number;
49
+ }
39
50
  /**
40
51
  * Build a `WindowAccumulator` from a config, parsing duration strings.
41
52
  * Returns `null` when the window width is unparseable, so the caller can
@@ -48,7 +59,7 @@ export declare function createAccumulator(config: AggregateConfig): WindowAccumu
48
59
  * bounds (when a band is configured), and provenance fields (`count`,
49
60
  * partial flag, raw start/end) for tooltips and partial-window styling.
50
61
  */
51
- export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig): Datum[];
62
+ export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig): AggregatedRealtimeDatum[];
52
63
  /** Whether a config requests a band envelope. */
53
64
  export declare function hasBand(config: AggregateConfig): boolean;
54
65
  export type { AggregateStat, AggregateBand, WindowType };
@@ -5,14 +5,16 @@ import type { Datum } from "../shared/datumTypes";
5
5
  import type { ChartModeInput, ChartModeResult } from "../shared/chartMode";
6
6
  import type { LegendInteractionMode, LegendInteractionState } from "../shared/hooks";
7
7
  import { type SelectionHookResult } from "../shared/selectionUtils";
8
- import type { ChartMode, SelectionConfig } from "../shared/types";
8
+ import type { ChartAccessor, ChartMode, SelectionConfig } from "../shared/types";
9
+ /** Read a numeric time/value off a datum via accessor, with a field fallback. */
10
+ export declare function readRealtimeNumber<TDatum extends Datum>(datum: Datum, accessor: ChartAccessor<TDatum, number> | undefined, fallback: string): number | null;
9
11
  interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
10
12
  mode?: ChartMode;
11
13
  size?: [number, number];
12
14
  enableHover?: unknown;
13
15
  }
14
16
  export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
15
- export declare function useRealtimeFrameHandle(ref: React.Ref<RealtimeFrameHandle>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
17
+ export declare function useRealtimeFrameHandle<TDatum extends Datum = Datum>(ref: React.Ref<RealtimeFrameHandle<TDatum>>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
16
18
  export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
17
19
  export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
18
20
  title: string | undefined;
@@ -0,0 +1,4 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { StyleRuleContext } from "../shared/styleRules";
3
+ /** Resolve the visible aggregate carried by a realtime histogram segment. */
4
+ export declare function makeHistogramRuleContext(): (datum: Datum) => StyleRuleContext;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Editorial-status visibility filter, kept free of the rest of the
3
+ * annotation-provenance module so SVG overlays do not pull the AI graph.
4
+ */
5
+ export interface AnnotationStatusVisibility {
6
+ showRetractedAnnotations?: boolean;
7
+ showSupersededAnnotations?: boolean;
8
+ }
9
+ export type StatusFilterable = {
10
+ provenance?: {
11
+ stableId?: string;
12
+ };
13
+ lifecycle?: {
14
+ status?: string;
15
+ supersedes?: string;
16
+ };
17
+ };
18
+ export declare function filterAnnotationsByStatus<T extends StatusFilterable>(annotations: ReadonlyArray<T>, options?: AnnotationStatusVisibility): T[];
@@ -5,7 +5,8 @@
5
5
  * metadata but never React components, frame stores, server renderers, or
6
6
  * docs modules. The implementation, server, capability, and example links
7
7
  * are strings so hosts can decide what to load. Existing registries remain
8
- * authoritative while this seven-chart slice proves the boundary.
8
+ * authoritative while this seven-chart slice proves the boundary; the AI
9
+ * schema generator now consumes this pilot for its seven component entries.
9
10
  */
10
11
  import { type ChartCapabilities, type ChartCategory, type ChartPropSpec, type ChartSpec, type PropType } from "./chartSpecs";
11
12
  /** Version of the definition shape, independently from the package version. */
@@ -120,9 +121,9 @@ export interface ChartDefinition<TChart extends string = string> {
120
121
  */
121
122
  export declare function createChartDefinitionWireSchema(spec: ChartSpec): ChartDefinitionWireSchema;
122
123
  /**
123
- * One representative per chart family. No existing consumer reads this yet;
124
- * its purpose is to make parity and generation work executable before any
125
- * registry is migrated.
124
+ * One representative per chart family. The AI schema projection is the first
125
+ * migrated downstream registry; other consumers remain on their established
126
+ * registries until this boundary has enough evidence to expand.
126
127
  */
127
128
  export declare const CHART_DEFINITION_PILOT: Readonly<{
128
129
  [TChart in ChartDefinitionPilotId]: ChartDefinition<TChart>;
@@ -68,8 +68,8 @@ export interface ChartCapabilities {
68
68
  * pure-synthetic charts (GaugeChart) declare false. */
69
69
  supportsPush: boolean;
70
70
  /** Renders to a static SVG via `renderChart()` from `semiotic/server`
71
- * through a registered entry in `serverChartConfigs.ts`. SSR-only
72
- * charts (none yet) and HOC-SSR exclusions also declare false. */
71
+ * through a registered entry in `serverChartConfigs.ts`. Live push-only
72
+ * charts declare false because no bounded static dataset was supplied. */
73
73
  supportsSSR: boolean;
74
74
  /**
75
75
  * How color is consumed by the chart's data marks.
@@ -0,0 +1,13 @@
1
+ import type { Datum } from "./datumTypes";
2
+ import { type StyleRuleContext } from "./styleRules";
3
+ /**
4
+ * Heatmap rules operate on two distinct public mark shapes:
5
+ *
6
+ * - ordinary cells retain the caller's row and resolve x/y/value accessors;
7
+ * - aggregated cells expose `{ value, count, sum, xCenter, yCenter, agg }`.
8
+ *
9
+ * The default `value` channel deliberately means the displayed aggregate for
10
+ * a derived cell. Callers can still target `count`, `sum`, or `agg` through a
11
+ * declarative `field`, while `axis: "x"|"y"` resolves the bin center.
12
+ */
13
+ export declare function makeHeatmapRuleContext(xAccessor: string | ((d: Datum) => unknown) | undefined, yAccessor: string | ((d: Datum) => unknown) | undefined, valueAccessor: string | ((d: Datum) => unknown) | undefined): (datum: Datum) => StyleRuleContext;
@@ -5,5 +5,5 @@
5
5
  * This compact registry is intentionally separate from validation metadata:
6
6
  * config serialization only needs chart-name membership.
7
7
  */
8
- export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
8
+ export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "WaterfallChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
9
9
  export declare function isKnownChartComponent(componentName: string): boolean;
@@ -1,5 +1,19 @@
1
1
  import type { Datum } from "./datumTypes";
2
+ import type { NetworkMarkStyle } from "../../stream/networkTypes";
2
3
  import type { Accessor } from "./types";
4
+ import type { SelectionHookResult, SelectionStyleConfig } from "./selectionUtils";
5
+ /** Apply shared/legend selection to a network node's raw user datum. */
6
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
7
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
8
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
9
+ /**
10
+ * Apply shared/legend selection to a network edge. When endpoint nodes are
11
+ * available, either endpoint may keep the edge emphasized; otherwise the
12
+ * predicate falls back to the edge payload.
13
+ */
14
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
15
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
16
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
3
17
  /**
4
18
  * Flatten a hierarchical data structure into an array of all nodes
5
19
  * by recursively traversing children.
@@ -75,5 +75,7 @@ export declare const DEFAULT_SELECTION_OPACITY = 0.5;
75
75
  * or group-dependent styling (`fillArea: string[]`, `resolveStroke(d,
76
76
  * group)` in `useXYLineStyle`'s MultiAxisLineChart path) silently
77
77
  * drops to its no-group branch whenever a selection is active.
78
+ * `selectionDatum` adapts authored wrappers such as GeoJSON Features to the
79
+ * direct-field shape published by their interactive marks.
78
80
  */
79
- export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (d: Datum, ...args: TArgs) => Datum;
81
+ export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig, selectionDatum?: (datum: Datum) => Datum): (d: Datum, ...args: TArgs) => Datum;
@@ -117,7 +117,8 @@ export interface BaseChartProps {
117
117
  responsiveHeight?: boolean;
118
118
  /**
119
119
  * Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
120
- * on coarse-pointer/small-screen devices. Canvas chart families repaint
120
+ * on coarse-pointer/small-screen devices. Very large canvases are further
121
+ * capped by a shared backing-store budget. Canvas chart families repaint
121
122
  * automatically when browser zoom or display density changes.
122
123
  */
123
124
  maxDevicePixelRatio?: number;
@@ -230,7 +231,8 @@ export interface AxisConfig {
230
231
  export type CategoryFormatFn = (label: string, index?: number) => string | React.ReactNode;
231
232
  /**
232
233
  * Accessor type - can be a property name or a function
233
- * @deprecated Use DataAccessor from generalTypes for generic type safety
234
+ * @deprecated Use `ChartAccessor<TDatum, TValue>` for typed chart props.
235
+ * This legacy alias remains for compatibility with existing frame code.
234
236
  */
235
237
  export type Accessor<T = DatumValue> = string | ((d: Datum, i?: number) => T);
236
238
  /**
@@ -4,7 +4,8 @@ import type { LegendItem, LegendLayout, LegendValue } from "../../types/legendTy
4
4
  import { type AxisChromeInput } from "../../legendLayout";
5
5
  import type { Datum } from "./datumTypes";
6
6
  /**
7
- * Distinct string-coerced `colorBy` values across `data`, in first-seen order.
7
+ * Distinct non-null, string-coerced `colorBy` values across `data`, in
8
+ * first-seen order.
8
9
  * Shared by chart setup hooks that need the category list for a color scale
9
10
  * or legend before any scale/legend object is built.
10
11
  */
@@ -1,7 +1,7 @@
1
1
  import type { RefObject, MutableRefObject } from "react";
2
2
  import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
3
3
  import type { Datum } from "./datumTypes";
4
- export interface AggregatedRow {
4
+ export interface AggregatedRow extends Datum {
5
5
  __likertCategory: string;
6
6
  /** Stacking key — may be sentinel value for neutral halves */
7
7
  __likertLevel: string;
@@ -11,6 +11,12 @@ export interface AggregatedRow {
11
11
  __likertPct: number;
12
12
  __likertLevelIndex: number;
13
13
  }
14
+ export interface LikertAggregationFieldAliases {
15
+ category?: string;
16
+ level?: string;
17
+ count?: string;
18
+ score?: string;
19
+ }
14
20
  /** Sentinel level names for the neutral split halves */
15
21
  export declare const NEUTRAL_NEG = "__likert_neutral_neg";
16
22
  export declare const NEUTRAL_POS = "__likert_neutral_pos";
@@ -30,7 +36,7 @@ export declare function resolveAccessorFn<T>(accessor: string | ((d: Datum) => T
30
36
  * Interpolates from red → gray → blue for odd, red → blue for even.
31
37
  */
32
38
  export declare function defaultDivergingScheme(n: number, themeDivergingSchemeName?: string): string[];
33
- export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null): AggregatedRow[];
39
+ export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null, fieldAliases?: LikertAggregationFieldAliases): AggregatedRow[];
34
40
  export declare function toDivergingValues(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
35
41
  export declare function orderForDiverging(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
36
42
  interface UseLikertAggregationConfig {
@@ -6,6 +6,7 @@ import type { OnObservationCallback } from "../../store/ObservationStore";
6
6
  import type { PartialMargin, MarginType } from "../../types/marginType";
7
7
  import { useChartSelection, useChartLegendAndMargin } from "./hooks";
8
8
  import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
9
+ import type { SelectionHookResult } from "./selectionUtils";
9
10
  export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge extends Datum = Datum> {
10
11
  /** Raw `nodes` prop (may be undefined). */
11
12
  nodes: TNode[] | undefined;
@@ -94,7 +95,7 @@ export interface NetworkChartSetupResult {
94
95
  */
95
96
  effectivePalette: string[];
96
97
  themeCategorical: string[] | undefined;
97
- /** Distinct category values from `(safeNodes, colorBy)`, for legend interaction. */
98
+ /** Distinct category values from bounded data or the live push-mode frame. */
98
99
  allCategories: string[];
99
100
  legendState: LegendInteractionState;
100
101
  legend: ReturnType<typeof useChartLegendAndMargin>["legend"];
@@ -108,13 +109,16 @@ export interface NetworkChartSetupResult {
108
109
  /**
109
110
  * The full selection-hook output. Most network HOCs only need the
110
111
  * resolved hover/click behaviors above, but hierarchy charts
111
- * (Treemap, CirclePack, TreeDiagram, OrbitDiagram) wrap node styles
112
- * with selection state via `activeSelectionHook.isActive` /
113
- * `.predicate`. Passed through verbatim so those charts don't need
114
- * a parallel `useChartSelection` call.
112
+ * Custom network layouts can consume the underlying shared selection
113
+ * directly. Built-in charts normally use `effectiveSelectionHook`, which
114
+ * also includes hover and legend interaction.
115
115
  */
116
116
  activeSelectionHook: ReturnType<typeof useChartSelection>["activeSelectionHook"];
117
117
  hoverSelectionHook: ReturnType<typeof useChartSelection>["hoverSelectionHook"];
118
+ /** Hover, legend, or shared selection in precedence order. */
119
+ effectiveSelectionHook: SelectionHookResult | null;
120
+ /** Selection styling with the active theme's default dim opacity. */
121
+ resolvedSelection: SelectionConfig | undefined;
118
122
  crosshairSourceId: ReturnType<typeof useChartSelection>["crosshairSourceId"];
119
123
  /** When non-null, render this element instead of the chart. */
120
124
  loadingEl: ReactElement | null;
@@ -86,7 +86,7 @@ export interface OrdinalPieceStyleOptions {
86
86
  * (typically the chart's `valueAccessor` output). Lets `{ when: { gt: 10 } }`
87
87
  * work with no `field` on the threshold.
88
88
  */
89
- resolveRuleValue?: (d: Datum) => number | undefined;
89
+ resolveRuleValue?: (d: Datum, category?: string) => number | undefined;
90
90
  }
91
91
  /**
92
92
  * Build a memoized `pieceStyle` function that the chart can pass
@@ -0,0 +1,24 @@
1
+ import type { ChartAccessor, LinkedBrushProp } from "./types";
2
+ import type { Datum } from "./datumTypes";
3
+ export type XYBrushExtent = {
4
+ x: [number, number];
5
+ y: [number, number];
6
+ };
7
+ export interface XYBrushInput<TDatum extends Datum = Datum> {
8
+ brush?: boolean;
9
+ onBrush?: (extent: XYBrushExtent | null) => void;
10
+ linkedBrush?: LinkedBrushProp;
11
+ xAccessor?: ChartAccessor<TDatum, unknown>;
12
+ yAccessor?: ChartAccessor<TDatum, unknown>;
13
+ /** Default brush dimension when `brush` is true without a linked config. */
14
+ defaultDimension?: "x" | "y" | "xy";
15
+ }
16
+ export interface XYBrushResult {
17
+ brushStreamProps: {
18
+ brush: {
19
+ dimension: "x" | "y" | "xy";
20
+ };
21
+ onBrush: (extent: XYBrushExtent | null) => void;
22
+ } | Record<string, never>;
23
+ }
24
+ export declare function useXYBrush<TDatum extends Datum = Datum>({ brush, onBrush: onBrushProp, linkedBrush, xAccessor, yAccessor, defaultDimension, }: XYBrushInput<TDatum>): XYBrushResult;
@@ -6,6 +6,7 @@ import type { GradientLegendValue } from "../../types/legendTypes";
6
6
  import type { LegendInteractionMode } from "../shared/hooks";
7
7
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
8
8
  import { type TooltipProp } from "../../Tooltip/Tooltip";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  /**
10
11
  * Heatmap component props
11
12
  */
@@ -117,6 +118,21 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
117
118
  * Annotation objects to render on the chart
118
119
  */
119
120
  annotations?: Datum[];
121
+ /**
122
+ * Bin continuous x/y into a grid (`count` / `sum` / `mean`). Dense numeric
123
+ * heatmaps (more than 4096 distinct cells) auto-bin even when this is omitted.
124
+ */
125
+ heatmapAggregation?: "count" | "sum" | "mean";
126
+ /** Number of x bins when aggregating. @default 20 */
127
+ heatmapXBins?: number;
128
+ /** Number of y bins when aggregating. @default 20 */
129
+ heatmapYBins?: number;
130
+ /**
131
+ * Ordered data-aware cell styling. Aggregated cells expose `value`, `count`,
132
+ * `sum`, `xCenter`, `yCenter`, and `agg`; the default rule value is the
133
+ * displayed aggregate and x/y channels are bin centers.
134
+ */
135
+ styleRules?: StyleRule[];
120
136
  /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
121
137
  xExtent?: [number | undefined, number | undefined] | [number];
122
138
  /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
@@ -130,6 +130,15 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
130
130
  * @default true
131
131
  */
132
132
  enableHover?: boolean;
133
+ /**
134
+ * Enable an x-axis brush overlay. Also enabled when `linkedBrush` is set.
135
+ */
136
+ brush?: boolean;
137
+ /** Callback with `{ x, y }` extents, or null when the brush clears. */
138
+ onBrush?: (extent: {
139
+ x: [number, number];
140
+ y: [number, number];
141
+ } | null) => void;
133
142
  /**
134
143
  * Show grid lines
135
144
  * @default false
@@ -54,6 +54,13 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
54
54
  pointOpacity?: number;
55
55
  /** Enable hover annotations @default true */
56
56
  enableHover?: boolean;
57
+ /** Enable an xy brush overlay. Also enabled when `linkedBrush` is set. */
58
+ brush?: boolean;
59
+ /** Callback with `{ x, y }` extents, or null when the brush clears. */
60
+ onBrush?: (extent: {
61
+ x: [number, number];
62
+ y: [number, number];
63
+ } | null) => void;
57
64
  /** Show grid lines @default false */
58
65
  showGrid?: boolean;
59
66
  /** Show legend @default true (when colorBy is specified) */
@@ -0,0 +1,2 @@
1
+ import type { ChartCapability } from "../../ai/chartCapabilityTypes";
2
+ export declare const WaterfallChartCapability: ChartCapability;