semiotic 3.8.9 → 3.9.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 (500) hide show
  1. package/README.md +83 -67
  2. package/agent-skill/semiotic-charts/SKILL.md +11 -2
  3. package/ai/behaviorContracts.cjs +33 -3
  4. package/ai/cli.js +53 -2
  5. package/ai/componentMetadata.cjs +15 -0
  6. package/ai/dist/mcp-server.js +1530 -611
  7. package/ai/examples.md +48 -42
  8. package/{CLAUDE.md → ai/reference.md} +43 -22
  9. package/ai/schema.json +10603 -986
  10. package/ai/surface-manifest.json +643 -2
  11. package/ai/system-prompt.md +83 -130
  12. package/dist/c-3BLJEQNG.min.js +1 -0
  13. package/dist/c-3KZD6AXJ.min.js +1 -0
  14. package/dist/c-4TWEX5HG.min.js +1 -0
  15. package/dist/c-52TEGIUJ.min.js +1 -0
  16. package/dist/c-5YCIX3VZ.min.js +1 -0
  17. package/dist/c-6FEKTA3U.min.js +1 -0
  18. package/dist/c-6O5EVOPH.min.js +1 -0
  19. package/dist/c-74HEEZGK.min.js +1 -0
  20. package/dist/c-AKAF6JAD.min.js +1 -0
  21. package/dist/c-BBKITSXB.min.js +1 -0
  22. package/dist/c-BWNB6USU.min.js +1 -0
  23. package/dist/c-C25ENHIK.min.js +1 -0
  24. package/dist/c-CDR5AO3R.min.js +1 -0
  25. package/dist/c-COHXCW3Q.min.js +1 -0
  26. package/dist/{chunk-scatterplotMatrixBrushOverlay-SDIZSN66.module.min.js → c-DADXPJXV.min.js} +0 -1
  27. package/dist/c-E3JFRRMI.min.js +1 -0
  28. package/dist/c-EBFPQHHO.min.js +1 -0
  29. package/dist/c-G36WS6LN.min.js +1 -0
  30. package/dist/c-GIKRQI4X.min.js +1 -0
  31. package/dist/c-GPYOFETM.min.js +1 -0
  32. package/dist/c-IDUHYYSI.min.js +1 -0
  33. package/dist/{chunk-chunk-FQPKOAIH.module.min.js → c-IUHFPMHD.min.js} +0 -1
  34. package/dist/c-J5G56TUH.min.js +1 -0
  35. package/dist/c-JAZ73J32.min.js +1 -0
  36. package/dist/c-KG3NXHAL.min.js +1 -0
  37. package/dist/c-KII3PLZE.min.js +1 -0
  38. package/dist/c-LIXGXMNS.min.js +1 -0
  39. package/dist/c-LVEY6D6B.min.js +1 -0
  40. package/dist/c-M4Y3BHFR.min.js +1 -0
  41. package/dist/c-MAIICR2Z.min.js +1 -0
  42. package/dist/c-MG5DM6VE.min.js +1 -0
  43. package/dist/{chunk-minimapBrushOverlay-JU57U7NM.module.min.js → c-MNF2S4AA.min.js} +0 -1
  44. package/dist/c-MT3WBK7M.min.js +1 -0
  45. package/dist/c-NY3JWV2K.min.js +1 -0
  46. package/dist/c-O6U6K4CW.min.js +1 -0
  47. package/dist/c-OCI56QF2.min.js +1 -0
  48. package/dist/c-OQ7M4AGV.min.js +1 -0
  49. package/dist/c-OXYMVK7Q.min.js +1 -0
  50. package/dist/c-PPWDL5ZI.min.js +1 -0
  51. package/dist/c-QHF5YON3.min.js +1 -0
  52. package/dist/c-RR3GO5SW.min.js +1 -0
  53. package/dist/{chunk-chunk-J5QD4RAM.module.min.js → c-RSVIHIQ4.min.js} +0 -1
  54. package/dist/{chunk-chunk-EMO5NUGE.module.min.js → c-S2BXNNJN.min.js} +0 -1
  55. package/dist/{chunk-chunk-YCQYG6J5.module.min.js → c-SLGMUBUL.min.js} +0 -1
  56. package/dist/c-SUILCHWU.min.js +1 -0
  57. package/dist/c-TZW3JGJ5.min.js +1 -0
  58. package/dist/c-US5ZFT6E.min.js +1 -0
  59. package/dist/{chunk-chunk-RZH7VZYS.module.min.js → c-USFMFKIH.min.js} +0 -1
  60. package/dist/c-UUKVD4WB.min.js +1 -0
  61. package/dist/{chunk-chunk-SV4XAZ3Q.module.min.js → c-VGW3VG3I.min.js} +0 -1
  62. package/dist/c-W3CE4A4S.min.js +1 -0
  63. package/dist/{chunk-chunk-2NVFEB7P.module.min.js → c-WJCD5EUY.min.js} +0 -1
  64. package/dist/{chunk-chunk-2JGJ5GUG.module.min.js → c-X5UBGU2V.min.js} +0 -1
  65. package/dist/c-YDAY2WFR.min.js +1 -0
  66. package/dist/c-ZOWWU34K.min.js +1 -0
  67. package/dist/components/AccessibleNavTree.d.ts +1 -1
  68. package/dist/components/CategoryColors.d.ts +1 -1
  69. package/dist/components/GradientLegend.d.ts +14 -0
  70. package/dist/components/Legend.d.ts +2 -7
  71. package/dist/components/LinkedCharts.d.ts +1 -1
  72. package/dist/components/MobileAnnotationCalloutList.d.ts +1 -1
  73. package/dist/components/ObservationReadout.d.ts +45 -0
  74. package/dist/components/ThemeProvider.d.ts +4 -4
  75. package/dist/components/Tooltip/FlippingTooltip.d.ts +5 -7
  76. package/dist/components/Tooltip/Tooltip.d.ts +30 -5
  77. package/dist/components/Tooltip/tooltipChrome.d.ts +43 -0
  78. package/dist/components/ai/chartCapabilityTypes.d.ts +86 -2
  79. package/dist/components/ai/chartClinic.d.ts +2 -0
  80. package/dist/components/ai/deriveProfileFields.d.ts +40 -0
  81. package/dist/components/ai/evaluateChart.d.ts +85 -0
  82. package/dist/components/ai/fieldPolicy.d.ts +7 -0
  83. package/dist/components/ai/fieldRoles.d.ts +24 -0
  84. package/dist/components/ai/generativeChart.d.ts +18 -2
  85. package/dist/components/ai/inferIntent.d.ts +26 -2
  86. package/dist/components/ai/intents.d.ts +35 -0
  87. package/dist/components/ai/navigationTree.d.ts +2 -2
  88. package/dist/components/ai/observedSceneAudit.d.ts +2 -1
  89. package/dist/components/ai/profileData.d.ts +11 -0
  90. package/dist/components/ai/repairChartConfig.d.ts +2 -3
  91. package/dist/components/ai/semanticEvidence.d.ts +4 -0
  92. package/dist/components/ai/semanticViability.d.ts +11 -0
  93. package/dist/components/ai/semanticViabilityRegistry.d.ts +5 -0
  94. package/dist/components/ai/streamingTypes.d.ts +4 -0
  95. package/dist/components/ai/suggestCharts.d.ts +5 -6
  96. package/dist/components/ai/suggestDashboard.d.ts +2 -3
  97. package/dist/components/ai/suggestStreamCharts.d.ts +1 -1
  98. package/dist/components/ai/suggestStretchCharts.d.ts +2 -3
  99. package/dist/components/ai/suggestionPropContracts.d.ts +20 -0
  100. package/dist/components/ai/variantDiscovery.d.ts +3 -1
  101. package/dist/components/charts/custom/NetworkCustomChart.d.ts +3 -0
  102. package/dist/components/charts/custom/OrdinalCustomChart.d.ts +3 -0
  103. package/dist/components/charts/custom/XYCustomChart.d.ts +1 -1
  104. package/dist/components/charts/geo/ChoroplethMap.d.ts +3 -1
  105. package/dist/components/charts/geo/DistanceCartogram.d.ts +2 -7
  106. package/dist/components/charts/geo/cartogramOverlay.d.ts +28 -0
  107. package/dist/components/charts/index.d.ts +4 -3
  108. package/dist/components/charts/network/ProcessSankey.d.ts +2 -136
  109. package/dist/components/charts/network/ProcessSankeyProps.d.ts +139 -0
  110. package/dist/components/charts/network/Treemap.d.ts +2 -1
  111. package/dist/components/charts/network/processSankey/boundaryHubOrdering.d.ts +23 -0
  112. package/dist/components/charts/network/processSankey/layoutGeometry.d.ts +2 -0
  113. package/dist/components/charts/network/processSankey/ordering.d.ts +3 -41
  114. package/dist/components/charts/network/processSankey/orderingTypes.d.ts +32 -0
  115. package/dist/components/charts/network/processSankey/packing.d.ts +1 -1
  116. package/dist/components/charts/network/processSankey/packingCache.d.ts +1 -1
  117. package/dist/components/charts/network/processSankey/packingOptimization.d.ts +72 -0
  118. package/dist/components/charts/ordinal/BarChart.d.ts +4 -3
  119. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  120. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +3 -2
  121. package/dist/components/charts/ordinal/StackedBarChart.d.ts +4 -3
  122. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +2 -2
  123. package/dist/components/charts/physics/GaltonBoardChart.d.ts +2 -9
  124. package/dist/components/charts/physics/GauntletChart.d.ts +10 -41
  125. package/dist/components/charts/physics/ProcessFlowChart.d.ts +1 -1
  126. package/dist/components/charts/physics/chainReactionAccessibleTable.d.ts +9 -0
  127. package/dist/components/charts/physics/chainReactionRuntime.d.ts +2 -1
  128. package/dist/components/charts/physics/chainReactionTypes.d.ts +5 -1
  129. package/dist/components/charts/physics/crucibleBodyRenderers.d.ts +2 -2
  130. package/dist/components/charts/physics/crucibleClone.d.ts +6 -0
  131. package/dist/components/charts/physics/crucibleEffects.d.ts +1 -2
  132. package/dist/components/charts/physics/crucibleRecord.d.ts +7 -0
  133. package/dist/components/charts/physics/gauntletChrome.d.ts +4 -4
  134. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  135. package/dist/components/charts/physics/gauntletPublic.d.ts +4 -0
  136. package/dist/components/charts/physics/packetFlowOverlay.d.ts +7 -0
  137. package/dist/components/charts/physics/physicsChartLayout.d.ts +8 -0
  138. package/dist/components/charts/physics/physicsChartShared.d.ts +3 -1
  139. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  140. package/dist/components/charts/physics/physicsHocUtils.d.ts +25 -12
  141. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +24 -0
  142. package/dist/components/charts/physics/processFlowOverlays.d.ts +9 -0
  143. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +15 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +10 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +35 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +21 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +20 -13
  148. package/dist/components/charts/realtime/aggregate.d.ts +4 -1
  149. package/dist/components/charts/realtime/eventTime.d.ts +4 -0
  150. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +27 -0
  151. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +30 -0
  152. package/dist/components/charts/realtime/useRealtimeCategoryColors.d.ts +30 -0
  153. package/dist/components/charts/shared/FrameTextAnnotationSVG.d.ts +10 -0
  154. package/dist/components/charts/shared/annotationActivation.d.ts +3 -7
  155. package/dist/components/charts/shared/annotationBandFill.d.ts +6 -0
  156. package/dist/components/charts/shared/annotationDispatch.d.ts +31 -0
  157. package/dist/components/charts/shared/annotationIdentity.d.ts +8 -0
  158. package/dist/components/charts/shared/annotationRules.d.ts +1 -15
  159. package/dist/components/charts/shared/boundedCategoryRegistry.d.ts +8 -0
  160. package/dist/components/charts/shared/chainReactionChartSpec.d.ts +3 -0
  161. package/dist/components/charts/shared/chartMode.d.ts +3 -2
  162. package/dist/components/charts/shared/chartSpecCore.d.ts +1 -0
  163. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  164. package/dist/components/charts/shared/gradient.d.ts +16 -0
  165. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  166. package/dist/components/charts/shared/hooks.d.ts +4 -4
  167. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  168. package/dist/components/charts/shared/streamPropsHelpers.d.ts +2 -1
  169. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  170. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  171. package/dist/components/charts/shared/types.d.ts +18 -9
  172. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  173. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  174. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  175. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  176. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  177. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  178. package/dist/components/charts/value/types.d.ts +1 -1
  179. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  180. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  181. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  182. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  183. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  184. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  185. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  186. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  187. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  188. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  189. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  190. package/dist/components/legendLayout.d.ts +131 -4
  191. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  192. package/dist/components/realtime/types.d.ts +10 -1
  193. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  194. package/dist/components/recipes/directedReachability.d.ts +14 -0
  195. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  196. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  197. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  198. package/dist/components/recipes/physics.d.ts +7 -4
  199. package/dist/components/recipes/processPhysics.d.ts +0 -1
  200. package/dist/components/recipes/waffle.d.ts +7 -4
  201. package/dist/components/semiotic-ai-core.d.ts +13 -4
  202. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  203. package/dist/components/semiotic-ai.d.ts +16 -9
  204. package/dist/components/semiotic-client-shared.d.ts +10 -0
  205. package/dist/components/semiotic-experimental.d.ts +1 -1
  206. package/dist/components/semiotic-geo.d.ts +4 -1
  207. package/dist/components/semiotic-network.d.ts +7 -4
  208. package/dist/components/semiotic-ordinal.d.ts +4 -1
  209. package/dist/components/semiotic-physics.d.ts +11 -4
  210. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  212. package/dist/components/semiotic-realtime.d.ts +3 -1
  213. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  214. package/dist/components/semiotic-server-edge.d.ts +3 -2
  215. package/dist/components/semiotic-server.d.ts +3 -2
  216. package/dist/components/semiotic-themes-core.d.ts +5 -48
  217. package/dist/components/semiotic-utils-core.d.ts +10 -5
  218. package/dist/components/semiotic-utils-react.d.ts +2 -0
  219. package/dist/components/semiotic-xy.d.ts +4 -1
  220. package/dist/components/semiotic.d.ts +68 -26
  221. package/dist/components/server/animatedGif.d.ts +1 -1
  222. package/dist/components/server/renderEvidence.d.ts +25 -2
  223. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  224. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  225. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  226. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  227. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  228. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  230. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  231. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  232. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  233. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  234. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  235. package/dist/components/server/staticAnnotations.d.ts +28 -1
  236. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  237. package/dist/components/server/staticLegend.d.ts +1 -1
  238. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  239. package/dist/components/server/staticOrdinal.d.ts +8 -2
  240. package/dist/components/server/staticPhysics.d.ts +13 -1
  241. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  242. package/dist/components/server/staticRawLegend.d.ts +15 -0
  243. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  244. package/dist/components/server/staticXYAxes.d.ts +27 -0
  245. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  246. package/dist/components/server/staticXYGrid.d.ts +11 -0
  247. package/dist/components/server/themeResolver.d.ts +5 -1
  248. package/dist/components/store/ThemeStore.d.ts +2 -98
  249. package/dist/components/store/designTokens.d.ts +1 -1
  250. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  251. package/dist/components/store/themeCore.d.ts +91 -0
  252. package/dist/components/store/themePresets.d.ts +81 -0
  253. package/dist/components/store/themeSerialization.d.ts +2 -1
  254. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  255. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  256. package/dist/components/stream/GeoTileRenderer.d.ts +2 -0
  257. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  258. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  259. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  260. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  261. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  262. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  263. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  264. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  265. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  266. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  268. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  269. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  270. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  271. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  272. package/dist/components/stream/canvasBackground.d.ts +10 -0
  273. package/dist/components/stream/canvasSetup.d.ts +9 -0
  274. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  275. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  276. package/dist/components/stream/frameGraphics.d.ts +18 -0
  277. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  278. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  279. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  280. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  281. package/dist/components/stream/geoTypes.d.ts +10 -11
  282. package/dist/components/stream/hitTarget.d.ts +61 -2
  283. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  284. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  285. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  286. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  287. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  288. package/dist/components/stream/networkFramePaint.d.ts +7 -0
  289. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  290. package/dist/components/stream/networkTypes.d.ts +30 -32
  291. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  292. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  294. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  295. package/dist/components/stream/ordinalTypes.d.ts +10 -4
  296. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  297. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  298. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  299. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  300. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  301. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  302. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  303. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  304. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  305. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +23 -4
  306. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  307. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  308. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  309. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  310. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  311. package/dist/components/stream/pipelineConfig.d.ts +6 -17
  312. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  313. package/dist/components/stream/renderBackend.d.ts +2 -0
  314. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  315. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  316. package/dist/components/stream/responsiveSize.d.ts +17 -0
  317. package/dist/components/stream/sceneCursor.d.ts +41 -0
  318. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  319. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  320. package/dist/components/stream/types.d.ts +25 -12
  321. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -1
  322. package/dist/components/stream/useFrame.d.ts +24 -1
  323. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  324. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  325. package/dist/components/stream/xyFrameAxisTypes.d.ts +15 -4
  326. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  327. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  328. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  329. package/dist/components/types/legendTypes.d.ts +6 -0
  330. package/dist/components/types/marginType.d.ts +7 -8
  331. package/dist/controls.min.js +1 -1
  332. package/dist/controls.module.min.js +1 -1
  333. package/dist/forceLayoutWorker.js +1 -1
  334. package/dist/geo.min.js +1 -1
  335. package/dist/geo.module.min.js +1 -1
  336. package/dist/network.min.js +1 -1
  337. package/dist/network.module.min.js +1 -1
  338. package/dist/ordinal.min.js +1 -1
  339. package/dist/ordinal.module.min.js +1 -1
  340. package/dist/physics-matter.module.min.js +1 -1
  341. package/dist/physics-rapier.module.min.js +1 -1
  342. package/dist/physics.min.js +1 -1
  343. package/dist/physics.module.min.js +1 -1
  344. package/dist/physicsWorker.js +1 -1
  345. package/dist/processSankeyLayoutWorker.js +1 -1
  346. package/dist/realtime.min.js +1 -1
  347. package/dist/realtime.module.min.js +1 -1
  348. package/dist/rough.min.js +1 -1
  349. package/dist/rough.module.min.js +1 -1
  350. package/dist/semiotic-ai-core.d.ts +13 -4
  351. package/dist/semiotic-ai-core.min.js +1 -1
  352. package/dist/semiotic-ai-core.module.min.js +1 -1
  353. package/dist/semiotic-ai.d.ts +16 -9
  354. package/dist/semiotic-ai.min.js +1 -1
  355. package/dist/semiotic-ai.module.min.js +1 -1
  356. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  357. package/dist/semiotic-client-glyph.module.min.js +2 -0
  358. package/dist/semiotic-client-responsive.module.min.js +2 -0
  359. package/dist/semiotic-client-shared.module.min.js +2 -0
  360. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  361. package/dist/semiotic-data.min.js +1 -1
  362. package/dist/semiotic-data.module.min.js +1 -1
  363. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  364. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node.module.min.js +2 -0
  366. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  367. package/dist/semiotic-experimental-vacp.min.js +1 -1
  368. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  369. package/dist/semiotic-experimental.d.ts +1 -1
  370. package/dist/semiotic-experimental.min.js +1 -1
  371. package/dist/semiotic-experimental.module.min.js +1 -1
  372. package/dist/semiotic-geo.d.ts +4 -1
  373. package/dist/semiotic-network.d.ts +7 -4
  374. package/dist/semiotic-ordinal.d.ts +4 -1
  375. package/dist/semiotic-physics.d.ts +11 -4
  376. package/dist/semiotic-realtime-core.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.min.js +2 -1
  378. package/dist/semiotic-realtime-core.module.min.js +2 -1
  379. package/dist/semiotic-realtime-react.d.ts +4 -3
  380. package/dist/semiotic-realtime-react.min.js +1 -1
  381. package/dist/semiotic-realtime-react.module.min.js +1 -1
  382. package/dist/semiotic-realtime.d.ts +3 -1
  383. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  384. package/dist/semiotic-recipes-core.d.ts +7 -5
  385. package/dist/semiotic-recipes-core.min.js +9 -1
  386. package/dist/semiotic-recipes-core.module.min.js +1 -1
  387. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  388. package/dist/semiotic-recipes-react.min.js +1 -1
  389. package/dist/semiotic-recipes-react.module.min.js +1 -1
  390. package/dist/semiotic-recipes.min.js +7 -1
  391. package/dist/semiotic-recipes.module.min.js +2 -1
  392. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  393. package/dist/semiotic-server-edge.d.ts +3 -2
  394. package/dist/semiotic-server-edge.min.js +1 -1
  395. package/dist/semiotic-server-edge.module.min.js +1 -1
  396. package/dist/semiotic-server-node.min.js +1 -1
  397. package/dist/semiotic-server-node.module.min.js +1 -1
  398. package/dist/semiotic-server.d.ts +3 -2
  399. package/dist/semiotic-themes-core.d.ts +5 -48
  400. package/dist/semiotic-themes-core.min.js +1 -1
  401. package/dist/semiotic-themes-core.module.min.js +1 -1
  402. package/dist/semiotic-themes-react.min.js +1 -1
  403. package/dist/semiotic-themes-react.module.min.js +1 -1
  404. package/dist/semiotic-themes.min.js +1 -1
  405. package/dist/semiotic-themes.module.min.js +1 -1
  406. package/dist/semiotic-utils-core.d.ts +10 -5
  407. package/dist/semiotic-utils-core.min.js +1 -1
  408. package/dist/semiotic-utils-core.module.min.js +1 -1
  409. package/dist/semiotic-utils-react.d.ts +2 -0
  410. package/dist/semiotic-utils-react.min.js +1 -1
  411. package/dist/semiotic-utils-react.module.min.js +1 -1
  412. package/dist/semiotic-utils.min.js +2 -1
  413. package/dist/semiotic-utils.module.min.js +2 -1
  414. package/dist/semiotic-value.min.js +1 -1
  415. package/dist/semiotic-value.module.min.js +1 -1
  416. package/dist/semiotic-xy.d.ts +4 -1
  417. package/dist/semiotic.d.ts +68 -26
  418. package/dist/semiotic.min.js +1 -1
  419. package/dist/semiotic.module.min.js +1 -1
  420. package/dist/server.min.js +1 -1
  421. package/dist/server.module.min.js +1 -1
  422. package/dist/xy.min.js +1 -1
  423. package/dist/xy.module.min.js +1 -1
  424. package/package.json +53 -19
  425. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  426. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  427. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  428. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  429. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  430. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  431. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  432. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  433. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  434. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  435. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  436. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  437. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  438. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  439. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  440. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  441. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  442. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  443. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  444. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  445. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  446. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  447. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  448. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  449. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  450. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  451. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  452. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  453. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  454. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  455. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  456. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  457. package/dist/chunk-chunk-HIV7AW2V.module.min.js +0 -2
  458. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  459. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  460. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  461. package/dist/chunk-chunk-JZAMMSQQ.module.min.js +0 -2
  462. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  463. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  464. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  465. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  466. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  467. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  468. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  469. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  470. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  471. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  472. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  473. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  474. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  475. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  476. package/dist/chunk-chunk-SKLYXNYW.module.min.js +0 -2
  477. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  478. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  479. package/dist/chunk-chunk-U4NZCU5T.module.min.js +0 -2
  480. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  481. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  482. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  483. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  484. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  485. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  486. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  487. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  488. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  489. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  490. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  491. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  492. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  493. package/dist/test-utils/canvasMock.d.ts +0 -86
  494. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  495. package/dist/test-utils/frameMock.d.ts +0 -81
  496. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  497. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  498. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  499. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  500. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -0,0 +1,37 @@
1
+ import * as React from "react";
2
+ import type { Style } from "../types";
3
+ import type { FrameGraphicsProp, FrameMargin } from "../useFrame";
4
+ import type { PhysicsBodyState } from "./PhysicsKernel";
5
+ import type { PhysicsSettledEvidence } from "./PhysicsEvidence";
6
+ import type { PhysicsPipelineStore } from "./PhysicsPipelineStore";
7
+ import { type PhysicsSettledScene, type PhysicsSettledSceneOptions } from "./PhysicsSettledScene";
8
+ export interface PhysicsSettledSVGOptions extends PhysicsSettledSceneOptions {
9
+ width?: number;
10
+ height?: number;
11
+ title?: string;
12
+ description?: string;
13
+ background?: string;
14
+ backgroundGraphics?: FrameGraphicsProp;
15
+ /** Explicit full-frame fill beneath custom background graphics. */
16
+ backgroundGraphicsBackdrop?: string;
17
+ className?: string;
18
+ foregroundGraphics?: FrameGraphicsProp;
19
+ idPrefix?: string;
20
+ margin?: Partial<FrameMargin>;
21
+ /** Root SVG styles, including inherited theme custom properties for exports. */
22
+ style?: React.CSSProperties;
23
+ renderBodySVG?: (body: PhysicsBodyState, style: Style, index: number, idPrefix: string) => React.ReactNode | undefined;
24
+ /** Visible title/legend/annotation chrome rendered above foreground graphics. */
25
+ renderChrome?: (scene: PhysicsSettledScene) => React.ReactNode;
26
+ }
27
+ export interface PhysicsSettledSVGElementRender {
28
+ element: React.ReactElement;
29
+ scene: PhysicsSettledScene;
30
+ evidence: PhysicsSettledEvidence;
31
+ }
32
+ /**
33
+ * Builds the settled SVG as a React element without importing ReactDOM.
34
+ * StreamPhysicsFrame uses this path during SSR so browser charts do not pull
35
+ * a static-markup renderer into their runtime bundle.
36
+ */
37
+ export declare function createPhysicsSettledSVG(store: PhysicsPipelineStore, options?: PhysicsSettledSVGOptions): PhysicsSettledSVGElementRender;
@@ -6,7 +6,7 @@ import type { PhysicsPipelineSnapshot, PhysicsPipelineStore } from "./PhysicsPip
6
6
  export interface PhysicsSettledSceneOptions {
7
7
  maxSteps?: number;
8
8
  projectionRows?: PhysicsSettledProjectionRow[];
9
- bodyStyle?: Style | ((body: PhysicsBodyState) => Style);
9
+ bodyStyle?: Style | ((body: PhysicsBodyState, context: PhysicsSettledBodyStyleContext) => Style);
10
10
  getBodyLabel?: (body: PhysicsBodyState) => string | undefined;
11
11
  /**
12
12
  * Total bodies the chart claims entered. Enables the settled ledger check
@@ -14,6 +14,10 @@ export interface PhysicsSettledSceneOptions {
14
14
  */
15
15
  charge?: number;
16
16
  }
17
+ export interface PhysicsSettledBodyStyleContext {
18
+ index: number;
19
+ simulationState: PhysicsPipelineSnapshot["simulationState"];
20
+ }
17
21
  export interface PhysicsSettledScene {
18
22
  snapshot: PhysicsPipelineSnapshot;
19
23
  bodies: PhysicsBodyState[];
@@ -21,6 +25,6 @@ export interface PhysicsSettledScene {
21
25
  evidence: PhysicsSettledEvidence;
22
26
  stepsRun: number;
23
27
  }
24
- export declare function physicsBodyToXYSceneNode(body: PhysicsBodyState, options?: Pick<PhysicsSettledSceneOptions, "bodyStyle" | "getBodyLabel">): SceneNode;
25
- export declare function physicsBodiesToXYSceneNodes(bodies: PhysicsBodyState[], options?: Pick<PhysicsSettledSceneOptions, "bodyStyle" | "getBodyLabel">): SceneNode[];
28
+ export declare function physicsBodyToXYSceneNode(body: PhysicsBodyState, options?: Pick<PhysicsSettledSceneOptions, "bodyStyle" | "getBodyLabel">, context?: PhysicsSettledBodyStyleContext): SceneNode;
29
+ export declare function physicsBodiesToXYSceneNodes(bodies: PhysicsBodyState[], options?: Pick<PhysicsSettledSceneOptions, "bodyStyle" | "getBodyLabel">, simulationState?: PhysicsPipelineSnapshot["simulationState"]): SceneNode[];
26
30
  export declare function buildPhysicsSettledScene(store: PhysicsPipelineStore, options?: PhysicsSettledSceneOptions): PhysicsSettledScene;
@@ -1,6 +1,6 @@
1
1
  import * as React from "react";
2
2
  import type { StreamPhysicsFrameHandle, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
3
3
  export type { PhysicsBodyMark, StreamPhysicsPopOptions } from "./physicsBodyCanvas";
4
- export type { PhysicsBodySelection, PhysicsBodySemanticItemAccessor, PhysicsBodySemanticItemContext, PhysicsBodyStyleContext, PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsBodyForce, StreamPhysicsBodyForceContext, StreamPhysicsBodyRegionState, StreamPhysicsExecutionState, StreamPhysicsFrameHandle, StreamPhysicsFrameProps, StreamPhysicsRegionEffect, StreamPhysicsRegionEffectContext, StreamPhysicsRegionEvent, StreamPhysicsRegionKind, StreamPhysicsRegionVector } from "./StreamPhysicsTypes";
4
+ export type { PhysicsBodySelection, PhysicsBodySemanticItemAccessor, PhysicsBodySemanticItemContext, PhysicsBodyStyleContext, PhysicsCanvasPaintContext, PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsBodyForce, StreamPhysicsBodyForceContext, StreamPhysicsBodyRegionState, StreamPhysicsExecutionState, StreamPhysicsFrameHandle, StreamPhysicsFrameProps, StreamPhysicsRegionEffect, StreamPhysicsRegionEffectContext, StreamPhysicsRegionEvent, StreamPhysicsRegionKind, StreamPhysicsRegionVector } from "./StreamPhysicsTypes";
5
5
  export declare const StreamPhysicsFrame: React.NamedExoticComponent<StreamPhysicsFrameProps & React.RefAttributes<StreamPhysicsFrameHandle>>;
6
6
  export default StreamPhysicsFrame;
@@ -17,6 +17,8 @@ import type { PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPipel
17
17
  import type { PhysicsController } from "./PhysicsControllers";
18
18
  import type { PhysicsExecution } from "./PhysicsWorkerProtocol";
19
19
  import type { StreamPhysicsPopOptions } from "./physicsBodyCanvas";
20
+ import type { PhysicsCanvasTheme } from "./PhysicsCanvasTheme";
21
+ import type { AccessibleTableProp } from "../accessibleTableTypes";
20
22
  export interface PhysicsBodySelection {
21
23
  isActive?: boolean;
22
24
  predicate?: (body: PhysicsBodyState) => boolean;
@@ -163,8 +165,14 @@ export interface PhysicsHoverData {
163
165
  x: number;
164
166
  y: number;
165
167
  }
168
+ /** Theme-aware paint helpers supplied to custom physics canvas callbacks. */
169
+ export interface PhysicsCanvasPaintContext {
170
+ theme: PhysicsCanvasTheme;
171
+ resolvePaint: (paint: Style["fill"] | Style["stroke"] | null | undefined, fallback: string) => string | CanvasPattern;
172
+ withAlpha: (color: string, opacity: number) => string;
173
+ }
166
174
  export interface StreamPhysicsFrameProps {
167
- accessibleTable?: boolean;
175
+ accessibleTable?: AccessibleTableProp;
168
176
  /**
169
177
  * Canvas fill. When set, overrides the theme background unless
170
178
  * `backgroundGraphics` already owns the backdrop. Pass `"transparent"`
@@ -174,6 +182,11 @@ export interface StreamPhysicsFrameProps {
174
182
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
175
183
  maxDevicePixelRatio?: number;
176
184
  backgroundGraphics?: FrameGraphicsProp;
185
+ /**
186
+ * Explicit full-frame SVG fill beneath `backgroundGraphics` and the canvas.
187
+ * Omit to preserve the historical transparent custom-background contract.
188
+ */
189
+ backgroundGraphicsBackdrop?: string;
177
190
  /**
178
191
  * Optional rAF seam for deterministic frame-loop scheduling in tests.
179
192
  * When omitted, the browser's requestAnimationFrame is used.
@@ -301,9 +314,15 @@ export interface StreamPhysicsFrameProps {
301
314
  title?: string | React.ReactNode;
302
315
  tooltipContent?: (hover: PhysicsHoverData) => React.ReactNode;
303
316
  workerBodyThreshold?: number;
304
- renderBody?: (ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style) => void;
305
- beforePaint?: (ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[]) => void;
306
- afterPaint?: (ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[]) => void;
317
+ /**
318
+ * Custom canvas body painter. Authored `bodyStyle.cursor` still works, but
319
+ * arbitrary painted pixels cannot be inferred: browser cursor hit testing
320
+ * uses the body's collision shape. Keep custom output within that shape (or
321
+ * choose matching collision geometry) when exact visual/hit parity matters.
322
+ */
323
+ renderBody?: (ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style, paint: PhysicsCanvasPaintContext) => void;
324
+ beforePaint?: (ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[], paint: PhysicsCanvasPaintContext) => void;
325
+ afterPaint?: (ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[], paint: PhysicsCanvasPaintContext) => void;
307
326
  }
308
327
  export interface StreamPhysicsFrameHandle extends PhysicsPipelineControlSurface {
309
328
  getData: () => PhysicsBodyState[];
@@ -0,0 +1,19 @@
1
+ import type { Datum } from "../../charts/shared/datumTypes";
2
+ import type { AnnotationContext } from "../../realtime/types";
3
+ import type { PhysicsBodyState } from "./PhysicsKernel";
4
+ export type PhysicsAnnotationAnchorNode = {
5
+ pointId?: string;
6
+ x: number;
7
+ y: number;
8
+ r: number;
9
+ };
10
+ export declare function bodiesToAnnotationAnchors(bodies: readonly PhysicsBodyState[]): PhysicsAnnotationAnchorNode[];
11
+ /** Pixel-space physics context with the exact live scale contract. */
12
+ export declare function buildPhysicsAnnotationContext(options: {
13
+ width: number;
14
+ height: number;
15
+ pointNodes?: PhysicsAnnotationAnchorNode[];
16
+ data?: Datum[];
17
+ }): AnnotationContext;
18
+ /** Normalize `bodyId` aliases to the common point-anchor field. */
19
+ export declare function normalizePhysicsAnnotations(annotations: Datum[] | undefined): Datum[] | undefined;
@@ -31,4 +31,8 @@ export interface StreamPhysicsPopAnimation {
31
31
  export declare function resolveBodyMark(body: PhysicsBodyState, style: Style): PhysicsBodyMark;
32
32
  export declare function drawBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style): void;
33
33
  export declare function physicsBodyRadius(body: PhysicsBodyState): number;
34
+ /** Circumscribed center radius for the built-in canvas mark. */
35
+ export declare function physicsBodyVisualSearchRadius(body: PhysicsBodyState, style: Style): number;
36
+ /** Exact built-in canvas mark hit, including authored radius/shape. */
37
+ export declare function physicsBodyVisualHitDistanceSquared(body: PhysicsBodyState, style: Style, x: number, y: number): number | null;
34
38
  export declare function drawPopAnimations(ctx: CanvasRenderingContext2D, animations: Map<string, StreamPhysicsPopAnimation>, now: number): boolean;
@@ -0,0 +1,7 @@
1
+ import * as React from "react";
2
+ import type { FrameMargin } from "../useFrame";
3
+ import type { PhysicsSettledScene } from "./PhysicsSettledScene";
4
+ import type { StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
5
+ export type PhysicsSettledChromeProps = Pick<StreamPhysicsFrameProps, "annotations" | "autoPlaceAnnotations" | "chartId" | "legend" | "legendClickBehavior" | "legendHighlightedCategory" | "legendHoverBehavior" | "legendIsolatedCategories" | "legendLayout" | "legendPosition" | "onAnnotationActivate" | "onObservation" | "svgAnnotationRules" | "title">;
6
+ /** Shared visible chrome for settled React SSR and standalone physics SVGs. */
7
+ export declare function renderPhysicsSettledChrome(scene: PhysicsSettledScene, props: PhysicsSettledChromeProps, size: readonly [number, number], margin: FrameMargin, chartType?: string): React.ReactNode;
@@ -0,0 +1,32 @@
1
+ import * as React from "react";
2
+ import type { Style } from "../types";
3
+ import type { PhysicsPipelineStore } from "./PhysicsPipelineStore";
4
+ import type { PhysicsBodyState } from "./PhysicsKernel";
5
+ import type { PhysicsHoverData, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
6
+ import type { PhysicsFrameObservationPayload } from "./physicsFrameObservations";
7
+ type PhysicsFrameObservationEmitter = (type: "hover", payload: PhysicsFrameObservationPayload) => void;
8
+ interface PhysicsCanvasPointerOptions {
9
+ canvasRef: React.RefObject<HTMLCanvasElement | null>;
10
+ clearHover: () => void;
11
+ emitObservation: PhysicsFrameObservationEmitter;
12
+ enableHover: boolean;
13
+ hoverRadius: number;
14
+ onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
15
+ setHoverData: React.Dispatch<React.SetStateAction<PhysicsHoverData | null>>;
16
+ storeRef: React.RefObject<PhysicsPipelineStore | null>;
17
+ }
18
+ export interface PhysicsBodyCursorCollection {
19
+ targets?: Map<string, Style>;
20
+ maxSearchRadius: number;
21
+ collisionGeometry?: boolean;
22
+ }
23
+ declare function collectPhysicsBodyCursor(collection: PhysicsBodyCursorCollection, body: PhysicsBodyState, style: Style, customRenderer: boolean): void;
24
+ /** Owns canvas hit-testing that is shared by physics hover and authored cursors. */
25
+ export declare function usePhysicsCanvasPointer({ canvasRef, clearHover, emitObservation, enableHover, hoverRadius, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
26
+ begin: () => PhysicsBodyCursorCollection;
27
+ collect: typeof collectPhysicsBodyCursor;
28
+ handlePointerLeave: (event: React.PointerEvent<HTMLCanvasElement>) => void;
29
+ handlePointerMove: (event: React.PointerEvent<HTMLCanvasElement>) => void;
30
+ syncBodyCursors: (canvas: HTMLCanvasElement, store: PhysicsPipelineStore, collection: PhysicsBodyCursorCollection) => void;
31
+ };
32
+ export {};
@@ -0,0 +1,36 @@
1
+ import { type Dispatch, type KeyboardEvent, type MutableRefObject, type PointerEvent, type SetStateAction } from "react";
2
+ import type { PhysicsBodyState } from "./PhysicsKernel";
3
+ import type { PhysicsPipelineStore, PhysicsSimulationState } from "./PhysicsPipelineStore";
4
+ import type { PhysicsFrameObservationPayload, PhysicsFrameObservationType } from "./physicsFrameObservations";
5
+ import type { PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
6
+ interface PhysicsSemanticNavigationOptions {
7
+ allSemanticItems: PhysicsSemanticItem[];
8
+ bodySemanticItemLimit: number;
9
+ bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"];
10
+ bodySemanticUpdateMs: number;
11
+ emitObservation: (type: PhysicsFrameObservationType, payload?: PhysicsFrameObservationPayload) => void;
12
+ enableHover: boolean;
13
+ hoverRadius: number;
14
+ logicalClockRef: MutableRefObject<() => number>;
15
+ onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
16
+ onBodyPointerDown: StreamPhysicsFrameProps["onBodyPointerDown"];
17
+ onClick: StreamPhysicsFrameProps["onClick"];
18
+ onSemanticItemActivate: StreamPhysicsFrameProps["onSemanticItemActivate"];
19
+ onSemanticItemFocus: StreamPhysicsFrameProps["onSemanticItemFocus"];
20
+ setBodySemanticItemsSnapshot: Dispatch<SetStateAction<PhysicsSemanticItem[]>>;
21
+ storeRef: MutableRefObject<PhysicsPipelineStore | null>;
22
+ }
23
+ export interface PhysicsSemanticNavigationResult {
24
+ clearHover: () => void;
25
+ focusedBodyIdRef: MutableRefObject<string | null>;
26
+ focusedSemanticItem: PhysicsSemanticItem | null;
27
+ handleCanvasPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
28
+ hoverData: PhysicsHoverData | null;
29
+ onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
30
+ setFocusedSemanticItem: Dispatch<SetStateAction<PhysicsSemanticItem | null>>;
31
+ setHoverData: Dispatch<SetStateAction<PhysicsHoverData | null>>;
32
+ syncBodySemanticItems: (bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, force?: boolean) => void;
33
+ }
34
+ /** Own the frame's body semantics, keyboard navigation, and activation state. */
35
+ export declare function usePhysicsSemanticNavigation({ allSemanticItems, bodySemanticItemLimit, bodySemanticItems, bodySemanticUpdateMs, emitObservation, enableHover, hoverRadius, logicalClockRef, onBodyHover, onBodyPointerDown, onClick, onSemanticItemActivate, onSemanticItemFocus, setBodySemanticItemsSnapshot, storeRef }: PhysicsSemanticNavigationOptions): PhysicsSemanticNavigationResult;
36
+ export {};
@@ -2,7 +2,7 @@
2
2
  * PipelineStore configuration types + growing-window capacity constants.
3
3
  */
4
4
  import type { Datum } from "../charts/shared/datumTypes";
5
- import type { StreamChartType, ArrowOfTime, WindowMode, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, CurveType, BarStyle, ThemeSemanticColors, BandConfig, CandlestickStyle, Style } from "./types";
5
+ import type { StreamChartType, ArrowOfTime, WindowMode, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, CurveType, BarStyle, ThemeSemanticColors, BandConfig, CandlestickStyle, SwarmStyle, WaterfallStyle, Style } from "./types";
6
6
  import type { SymbolName } from "./symbolPath";
7
7
  import type { CoercibleNumber } from "./accessorUtils";
8
8
  import type { CustomLayout } from "./customLayout";
@@ -85,28 +85,15 @@ export interface PipelineConfig {
85
85
  semanticLineStops?: Array<{
86
86
  offset: number;
87
87
  color: string;
88
+ opacity?: number;
88
89
  }>;
89
90
  lineStyle?: Style | ((d: Datum, group?: string) => Style);
90
91
  pointStyle?: (d: Datum) => Style & {
91
92
  r?: number;
92
93
  };
93
94
  areaStyle?: (d: Datum) => Style;
94
- swarmStyle?: {
95
- radius?: number;
96
- fill?: string;
97
- opacity?: number;
98
- stroke?: string;
99
- strokeWidth?: number;
100
- };
101
- waterfallStyle?: {
102
- positiveColor?: string;
103
- negativeColor?: string;
104
- connectorStroke?: string;
105
- connectorWidth?: number;
106
- gap?: number;
107
- stroke?: string;
108
- strokeWidth?: number;
109
- };
95
+ swarmStyle?: SwarmStyle;
96
+ waterfallStyle?: WaterfallStyle;
110
97
  colorScheme?: string | string[] | Record<string, string>;
111
98
  /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
112
99
  themeCategorical?: string[];
@@ -146,6 +133,8 @@ export interface PipelineConfig {
146
133
  heatmapYBins?: number;
147
134
  showValues?: boolean;
148
135
  heatmapValueFormat?: (v: number) => string;
136
+ /** Explicit value-to-color function for heatmap cells. */
137
+ heatmapColorScale?: (value: number) => string;
149
138
  pointIdAccessor?: string | ((d: Datum) => string);
150
139
  curve?: CurveType;
151
140
  /** When provided, replaces chart-type dispatch in scene building.
@@ -12,7 +12,7 @@ export type StackExtentCache = {
12
12
  key: string;
13
13
  yDomain: [number, number];
14
14
  };
15
- export declare function getTimeAxis(arrowOfTime: ArrowOfTime): "x" | "y";
15
+ export declare function getTimeAxis(_arrowOfTime: ArrowOfTime): "x";
16
16
  export declare function mergePartialDomain(dataDomain: [number, number], userExtent: [number | undefined, number | undefined] | [number] | undefined): [number, number];
17
17
  export declare function isFullySpecifiedExtent(extent: [number | undefined, number | undefined] | [number] | undefined): boolean;
18
18
  /**
@@ -26,6 +26,8 @@ export declare function renderSceneWithBackend<Node extends SceneLike>(args: {
26
26
  export interface RenderedSceneEntry<Node> {
27
27
  node: Node;
28
28
  element: React.ReactNode;
29
+ index: number;
30
+ renderedByBackend: boolean;
29
31
  }
30
32
  /**
31
33
  * Render a scene once and retain only nodes that produced static output.
@@ -20,12 +20,23 @@ export declare function resolveCurveFactory(curve: CurveType | undefined): Curve
20
20
  *
21
21
  */
22
22
  export declare function resolveCanvasFill(ctx: CanvasRenderingContext2D, fill: string | HatchFill | CanvasPattern | null | undefined, fallback: string): string | CanvasPattern;
23
+ /**
24
+ * Resolve a fill or stroke into a value that Canvas can actually paint.
25
+ *
26
+ * This is the strict counterpart to the compatibility-preserving
27
+ * `resolveCanvasFill`: an undefined custom property without a CSS fallback
28
+ * (`var(--missing)`) is not a valid Canvas paint and therefore uses the
29
+ * caller's fallback instead of being assigned verbatim. New direct-paint
30
+ * renderers should prefer this helper for both `fillStyle` and `strokeStyle`.
31
+ */
32
+ export declare function resolveCanvasPaint(ctx: CanvasRenderingContext2D, paint: string | HatchFill | CanvasPattern | null | undefined, fallback: string): string | CanvasPattern;
23
33
  /**
24
34
  * Narrow a possibly-`HatchFill` `style.fill` to the `string | CanvasPattern`
25
35
  * a canvas `fillStyle` accepts, for the direct-assign sites that don't
26
36
  * otherwise route through {@link resolveCanvasFill}. Returns `undefined` for a
27
- * nullish (or unresolvable) fill so callers can apply their own fallback with
28
- * `?? "…"`.
37
+ * nullish fill. For backward compatibility an unresolved `var(--missing)` is
38
+ * preserved; new renderers that require a guaranteed-valid paint should use
39
+ * {@link resolveCanvasPaint} with an explicit fallback.
29
40
  *
30
41
  * Delegates to {@link resolveCanvasFill} so behavior stays consistent: string
31
42
  * fills (including `var(--…)`) resolve through `resolveCSSColor` — a raw CSS
@@ -12,6 +12,13 @@
12
12
  * (catches external class toggles on `<html>` and `prefers-color-scheme`
13
13
  * media-query changes that bypass React).
14
14
  */
15
+ /**
16
+ * Repaint subscription for settled canvases whose CSS cascade changes without
17
+ * a ThemeStore update (ancestor class/style changes or system color-scheme
18
+ * media changes). Notifications are scoped to the subscribed element's DOM
19
+ * branch; requestAnimationFrame coalescing remains owned by the frame.
20
+ */
21
+ export declare function subscribeToCSSColorInvalidation(getElement: () => Element | null, listener: () => void): () => void;
15
22
  export declare function resolveCSSColor(ctx: CanvasRenderingContext2D, value: string | undefined): string | undefined;
16
23
  /**
17
24
  * Invalidate the CSS variable cache. Stream Frames call this from their
@@ -0,0 +1,17 @@
1
+ /** Constraints shared by responsive chart containers and the React measuring hook. */
2
+ export interface ResponsiveSizeOptions {
3
+ /** Minimum measured width. Useful when narrow containers should scroll. */
4
+ minWidth?: number;
5
+ /** Maximum measured width. Useful for art-directed chart proportions. */
6
+ maxWidth?: number;
7
+ /** Quantize width to this step to avoid rebuilding expensive layouts per pixel. */
8
+ widthStep?: number;
9
+ /** Minimum measured height. */
10
+ minHeight?: number;
11
+ /** Maximum measured height. */
12
+ maxHeight?: number;
13
+ /** Quantize height to this step. */
14
+ heightStep?: number;
15
+ }
16
+ /** Clamp and optionally quantize one measured responsive dimension. */
17
+ export declare function resolveResponsiveDimension(value: number, min?: number, max?: number, step?: number): number;
@@ -0,0 +1,41 @@
1
+ import * as React from "react";
2
+ import type { Style } from "./types";
3
+ export type CursorStyledSceneMark = {
4
+ type?: string;
5
+ interactive?: boolean;
6
+ style?: Pick<Style, "cursor">;
7
+ };
8
+ export interface CanvasMarkPointerState {
9
+ inside: boolean;
10
+ clientX: number;
11
+ clientY: number;
12
+ pointerType?: string;
13
+ }
14
+ /** Read the explicitly authored cursor for a scene mark. */
15
+ export declare function sceneMarkCursor(mark: CursorStyledSceneMark | null | undefined): Style["cursor"] | undefined;
16
+ /** Whether a retained scene contains any mark that needs cursor hit-testing. */
17
+ export declare function sceneHasAuthoredCursor(marks: ReadonlyArray<CursorStyledSceneMark> | null | undefined): boolean;
18
+ /**
19
+ * Apply a hit-tested mark cursor to the actual retained-mark canvas.
20
+ * Nullish cursors and misses restore normal CSS cascade/inheritance.
21
+ */
22
+ export declare function setCanvasMarkCursor(canvas: HTMLCanvasElement | null | undefined, cursor?: Style["cursor"]): void;
23
+ /** Refresh cached cursor presence and clear any cursor from the prior scene. */
24
+ export declare function syncCanvasMarkCursor(canvas: HTMLCanvasElement | null | undefined, marks: ReadonlyArray<CursorStyledSceneMark> | null | undefined): boolean;
25
+ /** Re-hit a moving scene under the last pointer without replaying hover state. */
26
+ export declare function rehitCanvasMarkCursor(canvas: HTMLCanvasElement | null | undefined, pointer: CanvasMarkPointerState, resolveCursor: (pointer: CanvasMarkPointerState) => Style["cursor"] | undefined): void;
27
+ /** Clear an imperative canvas cursor when its owning frame unmounts. */
28
+ export declare function useCanvasMarkCursorCleanup(canvasRef: React.RefObject<HTMLCanvasElement | null>): void;
29
+ /**
30
+ * Preserve a scene cursor in SVG/SSR output. Cursor is inherited, so wrapping
31
+ * complex/fragment marks covers every child while an explicit style on a
32
+ * custom backend's own DOM element still wins naturally.
33
+ *
34
+ * Native SVG hit geometry deliberately follows the painted mark. Canvas uses
35
+ * a larger pointer-tolerance halo because one bitmap surface has no per-mark
36
+ * DOM hit targets; that small backend-specific affordance is not reproduced
37
+ * with extra SVG nodes. Built-in XY area fills are the categorical exception:
38
+ * their established interaction channel is the top path, so SceneToSVG
39
+ * bypasses this wrapper and supplies a dedicated top-path cursor target.
40
+ */
41
+ export declare function withSceneMarkCursor(element: React.ReactNode, mark: CursorStyledSceneMark, key: React.Key): React.ReactNode;
@@ -26,7 +26,7 @@ export declare class SceneRevisionDiagnostics {
26
26
  */
27
27
  observeUpdateResult(updateResult: UpdateResult): void;
28
28
  beforeCompute(updateResult: UpdateResult, isTransitioning: boolean): SceneRevisionCheck;
29
- afterCompute(check: SceneRevisionCheck, computedScene: boolean, dimsChanged: boolean): void;
29
+ afterCompute(check: SceneRevisionCheck, computedScene: boolean, suppressDuplicateWarning: boolean): void;
30
30
  }
31
31
  /** Keep a frame's development-only revision tracker stable across renders. */
32
32
  export declare function useSceneRevisionDiagnostics(hostName: string): import("react").RefObject<SceneRevisionDiagnostics>;
@@ -6,5 +6,26 @@ export declare function tickPixelExtent(ticks: Array<{
6
6
  min: number | null;
7
7
  max: number | null;
8
8
  };
9
- export declare function resolveGridDash(style: "dashed" | "dotted" | string | undefined): string | undefined;
9
+ export declare function resolveGridDash(style: "dashed" | "dotted" | string | {
10
+ strokeDasharray?: string;
11
+ } | undefined): string | undefined;
12
+ /**
13
+ * Normalize the line-style forms shared by live SVG and static rendering.
14
+ * This returns presentation attributes, not CSS, so consumers can still use
15
+ * CSS variables in `stroke` and the generated SVG remains self-contained.
16
+ */
17
+ export declare function resolveAxisLineStyle(style: string | {
18
+ stroke?: string;
19
+ strokeWidth?: number;
20
+ strokeOpacity?: number;
21
+ strokeDasharray?: string;
22
+ } | undefined, fallback: {
23
+ stroke: string;
24
+ strokeWidth: number;
25
+ }): {
26
+ stroke: string;
27
+ strokeWidth: number;
28
+ strokeOpacity?: number;
29
+ strokeDasharray?: string;
30
+ };
10
31
  export declare function jaggedBaselinePath(orient: "left" | "right" | "top" | "bottom", width: number, height: number): string;
@@ -1,7 +1,7 @@
1
- import type { ReactNode } from "react";
1
+ import type { CSSProperties, ReactNode } from "react";
2
2
  import type { ScaleLinear } from "d3-scale";
3
3
  import type { AnimateProp } from "./pipelineTransitionUtils";
4
- import type { LegendLayout, LegendValue } from "../types/legendTypes";
4
+ import type { LegendItem, LegendLayout, LegendValue } from "../types/legendTypes";
5
5
  import type { ArrowOfTime, WindowMode, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, HoverAnnotationConfig, HoverData, AnnotationContext, AnnotationAnchorMode } from "../realtime/types";
6
6
  import type { Datum } from "../charts/shared/datumTypes";
7
7
  import type { HatchFill } from "../charts/shared/hatchFill";
@@ -13,6 +13,7 @@ import type { GlyphDef } from "./glyphDef";
13
13
  import type { SceneRenderMode } from "./sceneRenderBackendTypes";
14
14
  import type { StreamSemanticInteractionProps } from "./streamSemanticTypes";
15
15
  import type { XYFrameAxisConfig } from "./xyFrameAxisTypes";
16
+ import type { AccessibleTableProp } from "./accessibleTableTypes";
16
17
  export type { SceneRenderBackend, SceneRenderMode } from "./sceneRenderBackendTypes";
17
18
  export type { ThemeSemanticColors } from "./streamThemeTypes";
18
19
  export type { AxisTickFormat, AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
@@ -110,6 +111,14 @@ export interface Style {
110
111
  fill?: string | HatchFill | CanvasPattern;
111
112
  fillOpacity?: number;
112
113
  opacity?: number;
114
+ /**
115
+ * CSS cursor shown for this rendered mark.
116
+ *
117
+ * Presentation only: this does not create click, keyboard, or observation
118
+ * behavior. Pair it with the frame/chart interaction API when the mark is
119
+ * actionable.
120
+ */
121
+ cursor?: CSSProperties["cursor"];
113
122
  /** For icon/isotype bars: an image to stamp instead of filling */
114
123
  icon?: HTMLImageElement | HTMLCanvasElement;
115
124
  /** Padding between stamped icons */
@@ -185,6 +194,7 @@ export interface AreaSceneNode {
185
194
  y: number;
186
195
  height: number;
187
196
  color?: string;
197
+ opacity?: number;
188
198
  }>;
189
199
  style: Style;
190
200
  datum: SeriesDatum;
@@ -416,7 +426,7 @@ export interface HeatcellSceneNode {
416
426
  accessibility?: SceneAccessibilityMetadata["accessibility"];
417
427
  /** Optional style object (used for decay/transition opacity on heatmap cells) */
418
428
  style?: Style;
419
- /** Numeric cell value (for canvas text rendering when showValues is enabled) */
429
+ /** Resolved numeric cell value used for domain emission and optional labels */
420
430
  value?: number;
421
431
  /** Whether to render the value as text inside the cell */
422
432
  showValues?: boolean;
@@ -464,7 +474,7 @@ export interface CandlestickSceneNode {
464
474
  _pulseGlowRadius?: number;
465
475
  /** Animation target opacity (set during enter/exit transitions) */
466
476
  _targetOpacity?: number;
467
- /** Decay opacity for candlestick nodes (no style object, stored separately) */
477
+ /** Decay opacity for candlestick paint, stored separately from presentation style. */
468
478
  _decayOpacity?: number;
469
479
  /** Stable identity key for transition tracking */
470
480
  _transitionKey?: string;
@@ -484,6 +494,8 @@ export interface CandlestickStyle {
484
494
  wickWidth?: number;
485
495
  /** Single color for range/dumbbell mode (replaces up/down when no open/close provided) */
486
496
  rangeColor?: string;
497
+ /** Presentation-only cursor for each candlestick/range mark. */
498
+ cursor?: CSSProperties["cursor"];
487
499
  }
488
500
  export interface Changeset<T = Datum> {
489
501
  inserts: T[];
@@ -645,6 +657,7 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
645
657
  semanticLineStops?: Array<{
646
658
  offset: number;
647
659
  color: string;
660
+ opacity?: number;
648
661
  }>;
649
662
  /** Series names (matching lineBy/colorBy group keys) that render as filled areas in "mixed" chartType */
650
663
  areaGroups?: string[];
@@ -742,7 +755,7 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
742
755
  hoverAnnotation?: boolean | HoverAnnotationConfig;
743
756
  tooltipContent?: (d: HoverData) => ReactNode;
744
757
  enableHover?: boolean;
745
- /** Max pixel distance for hover/click hit testing. Default 30. */
758
+ /** Requested minimum hit radius; visible mark size and the 12px floor may increase it. Default 30. */
746
759
  hoverRadius?: number;
747
760
  /** Tooltip mode: "single" (default) shows one datum, "multi" shows all series at the hovered X. */
748
761
  tooltipMode?: "single" | "multi";
@@ -769,12 +782,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
769
782
  svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
770
783
  showGrid?: boolean;
771
784
  legend?: LegendValue;
772
- legendHoverBehavior?: (item: {
773
- label: string;
774
- } | null) => void;
775
- legendClickBehavior?: (item: {
776
- label: string;
777
- }) => void;
785
+ legendHoverBehavior?: (item: LegendItem | null) => void;
786
+ legendClickBehavior?: (item: LegendItem) => void;
778
787
  legendHighlightedCategory?: string | null;
779
788
  legendIsolatedCategories?: Set<string>;
780
789
  legendPosition?: "right" | "left" | "top" | "bottom";
@@ -829,8 +838,12 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
829
838
  showValues?: boolean;
830
839
  /** Format function for heatmap cell value labels */
831
840
  heatmapValueFormat?: (v: number) => string;
841
+ /** Explicit value-to-color function for heatmap cells. */
842
+ heatmapColorScale?: (value: number) => string;
843
+ /** Reports the current heatcell value domain after scene recomputation. */
844
+ onColorDomainChange?: (domain: [number, number] | null) => void;
832
845
  /** Render a visually-hidden data table from the scene graph for screen readers */
833
- accessibleTable?: boolean;
846
+ accessibleTable?: AccessibleTableProp;
834
847
  /** Accessible description overriding the auto-generated aria-label on the chart container */
835
848
  description?: string;
836
849
  /** Accessible summary rendered as a screen-reader-only note */
@@ -75,6 +75,8 @@ export interface CanvasFrameBackgroundProps {
75
75
  children: ReactNode;
76
76
  size: readonly [number, number];
77
77
  margin: FrameMargin;
78
+ /** Optional full-frame paint beneath translated background graphics. */
79
+ backdropFill?: string;
78
80
  /** Preserve a family's existing SVG overflow behavior when it needs it. */
79
81
  overflowVisible?: boolean;
80
82
  }
@@ -82,5 +84,5 @@ export interface CanvasFrameBackgroundProps {
82
84
  * The shared SVG background layer. Its coordinate translation is common;
83
85
  * resolving graphics and choosing their contents remain family-specific.
84
86
  */
85
- export declare function CanvasFrameBackground({ children, size, margin, overflowVisible, }: CanvasFrameBackgroundProps): React.ReactNode;
87
+ export declare function CanvasFrameBackground({ children, size, margin, backdropFill, overflowVisible, }: CanvasFrameBackgroundProps): React.ReactNode;
86
88
  export {};