semiotic 3.8.8 → 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 (501) hide show
  1. package/README.md +82 -66
  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} +46 -24
  9. package/ai/schema.json +10704 -825
  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 +83 -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 +6 -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 +26 -13
  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 +17 -12
  144. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +12 -7
  145. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +37 -14
  146. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +23 -14
  147. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +22 -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/formatUtils.d.ts +40 -9
  164. package/dist/components/charts/shared/frameTextAnnotation.d.ts +63 -0
  165. package/dist/components/charts/shared/gradient.d.ts +16 -0
  166. package/dist/components/charts/shared/hatchFill.d.ts +15 -0
  167. package/dist/components/charts/shared/hooks.d.ts +4 -4
  168. package/dist/components/charts/shared/legendUtils.d.ts +1 -0
  169. package/dist/components/charts/shared/streamPropsHelpers.d.ts +3 -1
  170. package/dist/components/charts/shared/styleRules.d.ts +9 -2
  171. package/dist/components/charts/shared/styleRulesWireSchema.d.ts +353 -0
  172. package/dist/components/charts/shared/types.d.ts +26 -10
  173. package/dist/components/charts/shared/useChartLegend.d.ts +43 -9
  174. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  175. package/dist/components/charts/shared/useCustomChartSetup.d.ts +5 -2
  176. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +5 -1
  177. package/dist/components/charts/shared/useOrdinalBrush.d.ts +3 -3
  178. package/dist/components/charts/shared/useStreamingLegend.d.ts +6 -1
  179. package/dist/components/charts/value/types.d.ts +1 -1
  180. package/dist/components/charts/xy/BubbleChart.d.ts +1 -1
  181. package/dist/components/charts/xy/BumpChart.capability.d.ts +14 -1
  182. package/dist/components/charts/xy/BumpChart.d.ts +13 -73
  183. package/dist/components/charts/xy/BumpChart.semanticViability.d.ts +5 -0
  184. package/dist/components/charts/xy/CandlestickChart.d.ts +2 -2
  185. package/dist/components/charts/xy/LineChart.d.ts +2 -2
  186. package/dist/components/charts/xy/Scatterplot.d.ts +1 -1
  187. package/dist/components/charts/xy/bumpData.d.ts +44 -0
  188. package/dist/components/charts/xy/bumpIdentity.d.ts +2 -0
  189. package/dist/components/charts/xy/bumpLayout.d.ts +45 -0
  190. package/dist/components/charts/xy/bumpTooltip.d.ts +20 -0
  191. package/dist/components/legendLayout.d.ts +131 -4
  192. package/dist/components/realtime/ReorderBuffer.d.ts +2 -0
  193. package/dist/components/realtime/types.d.ts +10 -1
  194. package/dist/components/recipes/balanceSnapshotsToFlows.d.ts +42 -0
  195. package/dist/components/recipes/directedReachability.d.ts +14 -0
  196. package/dist/components/recipes/gofishDisplayListFixtures.generated.d.ts +6 -6
  197. package/dist/components/recipes/gridObservatory.d.ts +1 -1
  198. package/dist/components/recipes/networkAnalysis.d.ts +1 -18
  199. package/dist/components/recipes/physics.d.ts +7 -4
  200. package/dist/components/recipes/processPhysics.d.ts +0 -1
  201. package/dist/components/recipes/waffle.d.ts +7 -4
  202. package/dist/components/semiotic-ai-core.d.ts +13 -4
  203. package/dist/components/semiotic-ai-observations.d.ts +3 -0
  204. package/dist/components/semiotic-ai.d.ts +16 -9
  205. package/dist/components/semiotic-client-shared.d.ts +10 -0
  206. package/dist/components/semiotic-experimental.d.ts +1 -1
  207. package/dist/components/semiotic-geo.d.ts +4 -1
  208. package/dist/components/semiotic-network.d.ts +7 -4
  209. package/dist/components/semiotic-ordinal.d.ts +4 -1
  210. package/dist/components/semiotic-physics.d.ts +11 -4
  211. package/dist/components/semiotic-realtime-core.d.ts +11 -4
  212. package/dist/components/semiotic-realtime-react.d.ts +4 -3
  213. package/dist/components/semiotic-realtime.d.ts +3 -1
  214. package/dist/components/semiotic-recipes-core.d.ts +7 -5
  215. package/dist/components/semiotic-server-edge.d.ts +3 -2
  216. package/dist/components/semiotic-server.d.ts +3 -2
  217. package/dist/components/semiotic-themes-core.d.ts +5 -48
  218. package/dist/components/semiotic-utils-core.d.ts +11 -5
  219. package/dist/components/semiotic-utils-react.d.ts +2 -0
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -25
  222. package/dist/components/server/animatedGif.d.ts +1 -1
  223. package/dist/components/server/renderEvidence.d.ts +25 -2
  224. package/dist/components/server/renderToStaticSVG.d.ts +15 -7
  225. package/dist/components/server/serverChartConfigShared.d.ts +8 -1
  226. package/dist/components/server/serverChartConfigs.d.ts +1 -0
  227. package/dist/components/server/serverChartConfigsNetwork.d.ts +3 -3
  228. package/dist/components/server/serverChartConfigsNetworkChord.d.ts +2 -0
  229. package/dist/components/server/serverChartConfigsNetworkForce.d.ts +2 -0
  230. package/dist/components/server/serverChartConfigsNetworkHierarchy.d.ts +3 -0
  231. package/dist/components/server/serverChartConfigsXY.d.ts +3 -3
  232. package/dist/components/server/serverChartConfigsXYBubble.d.ts +5 -0
  233. package/dist/components/server/serverChartConfigsXYBump.d.ts +7 -0
  234. package/dist/components/server/serverChartConfigsXYScatter.d.ts +5 -0
  235. package/dist/components/server/staticAnnotationFallbacks.d.ts +10 -0
  236. package/dist/components/server/staticAnnotations.d.ts +28 -1
  237. package/dist/components/server/staticAxisTickLabel.d.ts +13 -0
  238. package/dist/components/server/staticLegend.d.ts +1 -1
  239. package/dist/components/server/staticLegendMargin.d.ts +41 -0
  240. package/dist/components/server/staticOrdinal.d.ts +8 -2
  241. package/dist/components/server/staticPhysics.d.ts +13 -1
  242. package/dist/components/server/staticPhysicsChrome.d.ts +20 -0
  243. package/dist/components/server/staticRawLegend.d.ts +15 -0
  244. package/dist/components/server/staticSVGChrome.d.ts +16 -55
  245. package/dist/components/server/staticXYAxes.d.ts +27 -0
  246. package/dist/components/server/staticXYAxisTicks.d.ts +39 -0
  247. package/dist/components/server/staticXYGrid.d.ts +11 -0
  248. package/dist/components/server/themeResolver.d.ts +5 -1
  249. package/dist/components/store/ThemeStore.d.ts +2 -98
  250. package/dist/components/store/designTokens.d.ts +1 -1
  251. package/dist/components/store/themeCSSVariables.d.ts +10 -0
  252. package/dist/components/store/themeCore.d.ts +91 -0
  253. package/dist/components/store/themePresets.d.ts +81 -0
  254. package/dist/components/store/themeSerialization.d.ts +2 -1
  255. package/dist/components/stream/AccessibleDataTable.d.ts +12 -14
  256. package/dist/components/stream/AccessibleTablePortalImpl.d.ts +6 -0
  257. package/dist/components/stream/GeoTileRenderer.d.ts +3 -0
  258. package/dist/components/stream/NetworkCanvasHitTester.d.ts +3 -1
  259. package/dist/components/stream/NetworkSSRFrame.d.ts +2 -1
  260. package/dist/components/stream/NetworkSVGOverlay.d.ts +3 -31
  261. package/dist/components/stream/OrdinalCanvasHitTester.d.ts +2 -0
  262. package/dist/components/stream/SVGChartTitle.d.ts +9 -0
  263. package/dist/components/stream/SVGOverlay.d.ts +1 -21
  264. package/dist/components/stream/SVGUnderlay.d.ts +24 -0
  265. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  266. package/dist/components/stream/StreamGeoFrame.d.ts +1 -1
  267. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -1
  268. package/dist/components/stream/StreamXYFrame.d.ts +1 -1
  269. package/dist/components/stream/accessibleDataRows.d.ts +11 -0
  270. package/dist/components/stream/accessibleDataTableModel.d.ts +40 -0
  271. package/dist/components/stream/accessibleTableTypes.d.ts +11 -0
  272. package/dist/components/stream/axisTickUtils.d.ts +19 -0
  273. package/dist/components/stream/canvasBackground.d.ts +10 -0
  274. package/dist/components/stream/canvasSetup.d.ts +24 -4
  275. package/dist/components/stream/frameCursorInteraction.d.ts +25 -0
  276. package/dist/components/stream/frameDefaultMargins.d.ts +37 -0
  277. package/dist/components/stream/frameGraphics.d.ts +18 -0
  278. package/dist/components/stream/frameGraphicsSubscription.d.ts +26 -0
  279. package/dist/components/stream/frameLegendOptions.d.ts +18 -0
  280. package/dist/components/stream/geoFrameCursorInteraction.d.ts +9 -0
  281. package/dist/components/stream/geoFrameHelpers.d.ts +29 -1
  282. package/dist/components/stream/geoTypes.d.ts +12 -11
  283. package/dist/components/stream/hitTarget.d.ts +61 -2
  284. package/dist/components/stream/moduleWorkerSession.d.ts +6 -0
  285. package/dist/components/stream/networkAnnotationAnchors.d.ts +37 -0
  286. package/dist/components/stream/networkCustomLayout.d.ts +2 -2
  287. package/dist/components/stream/networkFrameCursorInteraction.d.ts +12 -0
  288. package/dist/components/stream/networkFrameInteraction.d.ts +2 -0
  289. package/dist/components/stream/networkFramePaint.d.ts +15 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +32 -32
  292. package/dist/components/stream/normalizeXYData.d.ts +7 -0
  293. package/dist/components/stream/ordinalFrameCursorInteraction.d.ts +7 -0
  294. package/dist/components/stream/ordinalFrameInteraction.d.ts +29 -0
  295. package/dist/components/stream/ordinalSceneSVG.d.ts +10 -0
  296. package/dist/components/stream/ordinalTypes.d.ts +12 -4
  297. package/dist/components/stream/physics/PhysicsBodySpatialIndex.d.ts +9 -1
  298. package/dist/components/stream/physics/PhysicsCanvasTheme.d.ts +25 -0
  299. package/dist/components/stream/physics/PhysicsControllers.d.ts +0 -3
  300. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +4 -1
  301. package/dist/components/stream/physics/PhysicsSVGOverlay.d.ts +3 -24
  302. package/dist/components/stream/physics/PhysicsSettledSVG.d.ts +9 -21
  303. package/dist/components/stream/physics/PhysicsSettledSVGElement.d.ts +37 -0
  304. package/dist/components/stream/physics/PhysicsSettledScene.d.ts +7 -3
  305. package/dist/components/stream/physics/StreamPhysicsFrame.d.ts +1 -1
  306. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +25 -4
  307. package/dist/components/stream/physics/physicsAnnotationContext.d.ts +19 -0
  308. package/dist/components/stream/physics/physicsBodyCanvas.d.ts +4 -0
  309. package/dist/components/stream/physics/physicsSettledChrome.d.ts +7 -0
  310. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +32 -0
  311. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +36 -0
  312. package/dist/components/stream/pipelineConfig.d.ts +8 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +2 -2
  314. package/dist/components/stream/renderBackend.d.ts +2 -0
  315. package/dist/components/stream/renderers/canvasRenderHelpers.d.ts +13 -2
  316. package/dist/components/stream/renderers/resolveCSSColor.d.ts +7 -0
  317. package/dist/components/stream/responsiveSize.d.ts +17 -0
  318. package/dist/components/stream/sceneCursor.d.ts +41 -0
  319. package/dist/components/stream/sceneRevisionDiagnostics.d.ts +1 -1
  320. package/dist/components/stream/svgOverlayUtils.d.ts +22 -1
  321. package/dist/components/stream/types.d.ts +33 -13
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +12 -1
  323. package/dist/components/stream/useFrame.d.ts +24 -1
  324. package/dist/components/stream/useResponsiveSize.d.ts +6 -1
  325. package/dist/components/stream/useStalenessCheck.d.ts +1 -1
  326. package/dist/components/stream/xyFrameAxisTypes.d.ts +20 -4
  327. package/dist/components/stream/xyFrameCursorInteraction.d.ts +6 -0
  328. package/dist/components/stream/xySceneBuilders/swarmScene.d.ts +1 -1
  329. package/dist/components/stream/xySceneBuilders/types.d.ts +6 -26
  330. package/dist/components/types/legendTypes.d.ts +6 -0
  331. package/dist/components/types/marginType.d.ts +7 -8
  332. package/dist/controls.min.js +1 -1
  333. package/dist/controls.module.min.js +1 -1
  334. package/dist/forceLayoutWorker.js +1 -1
  335. package/dist/geo.min.js +1 -1
  336. package/dist/geo.module.min.js +1 -1
  337. package/dist/network.min.js +1 -1
  338. package/dist/network.module.min.js +1 -1
  339. package/dist/ordinal.min.js +1 -1
  340. package/dist/ordinal.module.min.js +1 -1
  341. package/dist/physics-matter.module.min.js +1 -1
  342. package/dist/physics-rapier.module.min.js +1 -1
  343. package/dist/physics.min.js +1 -1
  344. package/dist/physics.module.min.js +1 -1
  345. package/dist/physicsWorker.js +1 -1
  346. package/dist/processSankeyLayoutWorker.js +1 -1
  347. package/dist/realtime.min.js +1 -1
  348. package/dist/realtime.module.min.js +1 -1
  349. package/dist/rough.min.js +1 -1
  350. package/dist/rough.module.min.js +1 -1
  351. package/dist/semiotic-ai-core.d.ts +13 -4
  352. package/dist/semiotic-ai-core.min.js +1 -1
  353. package/dist/semiotic-ai-core.module.min.js +1 -1
  354. package/dist/semiotic-ai.d.ts +16 -9
  355. package/dist/semiotic-ai.min.js +1 -1
  356. package/dist/semiotic-ai.module.min.js +1 -1
  357. package/dist/semiotic-client-cjs-shared.min.js +1 -0
  358. package/dist/semiotic-client-glyph.module.min.js +2 -0
  359. package/dist/semiotic-client-responsive.module.min.js +2 -0
  360. package/dist/semiotic-client-shared.module.min.js +2 -0
  361. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -0
  362. package/dist/semiotic-data.min.js +1 -1
  363. package/dist/semiotic-data.module.min.js +1 -1
  364. package/dist/semiotic-experimental-auxiliary.module.min.js +2 -0
  365. package/dist/semiotic-experimental-node-auxiliary.module.min.js +2 -0
  366. package/dist/semiotic-experimental-node.module.min.js +2 -0
  367. package/dist/semiotic-experimental-react-shared.module.min.js +2 -0
  368. package/dist/semiotic-experimental-vacp.min.js +1 -1
  369. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  370. package/dist/semiotic-experimental.d.ts +1 -1
  371. package/dist/semiotic-experimental.min.js +1 -1
  372. package/dist/semiotic-experimental.module.min.js +1 -1
  373. package/dist/semiotic-geo.d.ts +4 -1
  374. package/dist/semiotic-network.d.ts +7 -4
  375. package/dist/semiotic-ordinal.d.ts +4 -1
  376. package/dist/semiotic-physics.d.ts +11 -4
  377. package/dist/semiotic-realtime-core.d.ts +11 -4
  378. package/dist/semiotic-realtime-core.min.js +2 -1
  379. package/dist/semiotic-realtime-core.module.min.js +2 -1
  380. package/dist/semiotic-realtime-react.d.ts +4 -3
  381. package/dist/semiotic-realtime-react.min.js +1 -1
  382. package/dist/semiotic-realtime-react.module.min.js +1 -1
  383. package/dist/semiotic-realtime.d.ts +3 -1
  384. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -0
  385. package/dist/semiotic-recipes-core.d.ts +7 -5
  386. package/dist/semiotic-recipes-core.min.js +9 -1
  387. package/dist/semiotic-recipes-core.module.min.js +1 -1
  388. package/dist/semiotic-recipes-geo-cjs.min.js +1 -0
  389. package/dist/semiotic-recipes-react.min.js +1 -1
  390. package/dist/semiotic-recipes-react.module.min.js +1 -1
  391. package/dist/semiotic-recipes.min.js +7 -1
  392. package/dist/semiotic-recipes.module.min.js +2 -1
  393. package/dist/semiotic-server-edge-node.module.min.js +1 -0
  394. package/dist/semiotic-server-edge.d.ts +3 -2
  395. package/dist/semiotic-server-edge.min.js +1 -1
  396. package/dist/semiotic-server-edge.module.min.js +1 -1
  397. package/dist/semiotic-server-node.min.js +1 -1
  398. package/dist/semiotic-server-node.module.min.js +1 -1
  399. package/dist/semiotic-server.d.ts +3 -2
  400. package/dist/semiotic-themes-core.d.ts +5 -48
  401. package/dist/semiotic-themes-core.min.js +1 -1
  402. package/dist/semiotic-themes-core.module.min.js +1 -1
  403. package/dist/semiotic-themes-react.min.js +1 -1
  404. package/dist/semiotic-themes-react.module.min.js +1 -1
  405. package/dist/semiotic-themes.min.js +1 -1
  406. package/dist/semiotic-themes.module.min.js +1 -1
  407. package/dist/semiotic-utils-core.d.ts +11 -5
  408. package/dist/semiotic-utils-core.min.js +1 -1
  409. package/dist/semiotic-utils-core.module.min.js +1 -1
  410. package/dist/semiotic-utils-react.d.ts +2 -0
  411. package/dist/semiotic-utils-react.min.js +1 -1
  412. package/dist/semiotic-utils-react.module.min.js +1 -1
  413. package/dist/semiotic-utils.min.js +2 -1
  414. package/dist/semiotic-utils.module.min.js +2 -1
  415. package/dist/semiotic-value.min.js +1 -1
  416. package/dist/semiotic-value.module.min.js +1 -1
  417. package/dist/semiotic-xy.d.ts +4 -1
  418. package/dist/semiotic.d.ts +68 -25
  419. package/dist/semiotic.min.js +1 -1
  420. package/dist/semiotic.module.min.js +1 -1
  421. package/dist/server.min.js +1 -1
  422. package/dist/server.module.min.js +1 -1
  423. package/dist/xy.min.js +1 -1
  424. package/dist/xy.module.min.js +1 -1
  425. package/package.json +53 -19
  426. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  427. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  428. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  429. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  430. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  431. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  432. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  433. package/dist/chunk-chunk-3GCILWPB.module.min.js +0 -2
  434. package/dist/chunk-chunk-46KRGJQP.module.min.js +0 -1
  435. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4MLLQUGW.module.min.js +0 -2
  437. package/dist/chunk-chunk-57RBPDBQ.module.min.js +0 -2
  438. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  439. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  442. package/dist/chunk-chunk-7LE56WAE.module.min.js +0 -2
  443. package/dist/chunk-chunk-7T25U75Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  445. package/dist/chunk-chunk-AF53TBSN.module.min.js +0 -2
  446. package/dist/chunk-chunk-BTZYH2IE.module.min.js +0 -1
  447. package/dist/chunk-chunk-BWV55BZK.module.min.js +0 -2
  448. package/dist/chunk-chunk-BZNOAHJV.module.min.js +0 -2
  449. package/dist/chunk-chunk-CD6PVVS3.module.min.js +0 -2
  450. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  451. package/dist/chunk-chunk-FC3NZWYR.module.min.js +0 -2
  452. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  453. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  454. package/dist/chunk-chunk-FRGBMTZR.module.min.js +0 -1
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-H5IFO6CU.module.min.js +0 -2
  457. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HCNDE26Q.module.min.js +0 -2
  460. package/dist/chunk-chunk-IY7RYD4S.module.min.js +0 -1
  461. package/dist/chunk-chunk-J3QOW4OE.module.min.js +0 -0
  462. package/dist/chunk-chunk-J3XWETBJ.module.min.js +0 -2
  463. package/dist/chunk-chunk-JJ4BSUYL.module.min.js +0 -2
  464. package/dist/chunk-chunk-JRHXQGEV.module.min.js +0 -2
  465. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  466. package/dist/chunk-chunk-L6FFYGYS.module.min.js +0 -1
  467. package/dist/chunk-chunk-LJDH3WV3.module.min.js +0 -2
  468. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  469. package/dist/chunk-chunk-N3Q33XCB.module.min.js +0 -2
  470. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  471. package/dist/chunk-chunk-OG3TTJGJ.module.min.js +0 -2
  472. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  473. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-QQJNG23C.module.min.js +0 -2
  476. package/dist/chunk-chunk-RGJ6TKAH.module.min.js +0 -2
  477. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  478. package/dist/chunk-chunk-SFLUSZ73.module.min.js +0 -2
  479. package/dist/chunk-chunk-TCMHJWFJ.module.min.js +0 -1
  480. package/dist/chunk-chunk-TSCFL235.module.min.js +0 -1
  481. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  482. package/dist/chunk-chunk-UEZ6SHW5.module.min.js +0 -2
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VUWYT7DY.module.min.js +0 -2
  485. package/dist/chunk-chunk-W5HWGQMD.module.min.js +0 -2
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-WGROBM3I.module.min.js +0 -2
  488. package/dist/chunk-chunk-WSDJFBKX.module.min.js +0 -2
  489. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  490. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  491. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  492. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  493. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  494. package/dist/test-utils/canvasMock.d.ts +0 -86
  495. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  496. package/dist/test-utils/frameMock.d.ts +0 -81
  497. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  498. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  499. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  500. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  501. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -3,6 +3,7 @@ import { type PhysicsSedimentBinSnapshot, type PhysicsSedimentColumn, type Physi
3
3
  import { type PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
4
4
  import type { PhysicsObservationEvent, PhysicsObservationRecord, PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "./PhysicsPipelineTypes";
5
5
  import { type UpdateResult } from "../pipelineUpdateContract";
6
+ import { type PhysicsBodyHitTestOptions } from "./PhysicsBodySpatialIndex";
6
7
  export type { PhysicsPlotBounds, PhysicsBoundsColliderOptions, PhysicsXBinColliderOptions, PhysicsSpawnSpringSpec, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnTimeAccessor, PhysicsSpawnPacingOptions, PhysicsPipelineQueuedSpawnSnapshot, PhysicsObservationEventType, PhysicsSimulationState, PhysicsObservationEvent, PhysicsObservationRecord, PhysicsSensorObservationConfig, PhysicsPipelineObservationOptions, PhysicsPipelineConfig, PhysicsPipelineTickResult, PhysicsPipelineSnapshot, PhysicsPipelineControlSurface } from "./PhysicsPipelineTypes";
7
8
  export { schedulePhysicsSpawns, collidersFromPlotBounds, collidersFromXScaleBins } from "./physicsPipelineHelpers";
8
9
  export type { ChangeSet, Invalidation, RevisionSet, UpdateResult } from "../pipelineUpdateContract";
@@ -65,7 +66,9 @@ export declare class PhysicsPipelineStore {
65
66
  bodyBudgetStatus(): PhysicsBodyBudgetDecision;
66
67
  sedimentTotals(): PhysicsSedimentTotals;
67
68
  sedimentHeightfield(options?: PhysicsSedimentHeightfieldOptions): PhysicsSedimentColumn[];
68
- hitTest(x: number, y: number, radius?: number): PhysicsBodyState | null;
69
+ hitTest(x: number, y: number, radius?: number,
70
+ /** @internal Styled/custom-renderer geometry for browser cursor parity. */
71
+ options?: PhysicsBodyHitTestOptions): PhysicsBodyState | null;
69
72
  events(): PhysicsKernelEvent[];
70
73
  allSleeping(): boolean;
71
74
  /**
@@ -9,16 +9,11 @@ import type { ReactNode } from "react";
9
9
  import type { LegendLayout, LegendValue } from "../../types/legendTypes";
10
10
  import { type AutoPlaceAnnotations } from "../../recipes/annotationLayout";
11
11
  import type { AnnotationContext } from "../../realtime/types";
12
- import type { PhysicsBodyState } from "./PhysicsKernel";
13
12
  import type { OnObservationCallback } from "../../store/ObservationStore";
14
13
  import { type OnAnnotationActivateCallback } from "../../charts/shared/annotationActivation";
15
- export type PhysicsAnnotationAnchorNode = {
16
- pointId?: string;
17
- x: number;
18
- y: number;
19
- r: number;
20
- };
21
- export declare function bodiesToAnnotationAnchors(bodies: readonly PhysicsBodyState[]): PhysicsAnnotationAnchorNode[];
14
+ import { type PhysicsAnnotationAnchorNode } from "./physicsAnnotationContext";
15
+ export { bodiesToAnnotationAnchors, buildPhysicsAnnotationContext, normalizePhysicsAnnotations, } from "./physicsAnnotationContext";
16
+ export type { PhysicsAnnotationAnchorNode } from "./physicsAnnotationContext";
22
17
  export interface PhysicsSVGOverlayProps {
23
18
  width: number;
24
19
  height: number;
@@ -54,21 +49,5 @@ export interface PhysicsSVGOverlayProps {
54
49
  /** Optional foreground SVG already composed into the frame stack. */
55
50
  children?: ReactNode;
56
51
  }
57
- /**
58
- * Pixel-space annotation context: identity scales so raw `x`/`y` on notes
59
- * read as canvas coordinates (physics has no data→pixel scale).
60
- */
61
- export declare function buildPhysicsAnnotationContext(options: {
62
- width: number;
63
- height: number;
64
- pointNodes?: PhysicsAnnotationAnchorNode[];
65
- data?: Datum[];
66
- }): AnnotationContext;
67
- /**
68
- * Normalize common physics annotation aliases onto Semiotic annotation shapes.
69
- * - `bodyId` → `pointId` (anchor to a live body)
70
- * - physics barrier/sensor notes still paint as x/y-threshold when typed that way
71
- */
72
- export declare function normalizePhysicsAnnotations(annotations: Datum[] | undefined): Datum[] | undefined;
73
52
  export declare function PhysicsSVGOverlay(props: PhysicsSVGOverlayProps): React.JSX.Element;
74
53
  export default PhysicsSVGOverlay;
@@ -1,26 +1,14 @@
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
1
  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
- className?: string;
16
- foregroundGraphics?: FrameGraphicsProp;
17
- idPrefix?: string;
18
- margin?: Partial<FrameMargin>;
19
- renderBodySVG?: (body: PhysicsBodyState, style: Style, index: number, idPrefix: string) => React.ReactNode | undefined;
20
- }
2
+ import { createPhysicsSettledSVG, type PhysicsSettledSVGOptions } from "./PhysicsSettledSVGElement";
3
+ export type { PhysicsSettledSVGOptions } from "./PhysicsSettledSVGElement";
21
4
  export interface PhysicsSettledSVGRender {
22
5
  svg: string;
23
- scene: PhysicsSettledScene;
24
- evidence: PhysicsSettledEvidence;
6
+ scene: ReturnType<typeof createPhysicsSettledSVG>["scene"];
7
+ evidence: ReturnType<typeof createPhysicsSettledSVG>["evidence"];
25
8
  }
9
+ /**
10
+ * Serializes the settled physics scene for explicit static SVG exports.
11
+ * Interactive physics SSR uses `createPhysicsSettledSVG` directly so its
12
+ * browser entry has no ReactDOM server dependency.
13
+ */
26
14
  export declare function renderPhysicsSettledSVG(store: PhysicsPipelineStore, options?: PhysicsSettledSVGOptions): PhysicsSettledSVGRender;
@@ -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,15 +165,28 @@ 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"`
171
179
  * to composite over siblings (same contract as StreamXYFrame).
172
180
  */
173
181
  background?: string;
182
+ /** Maximum canvas backing-store DPR; defaults to the environment cap. */
183
+ maxDevicePixelRatio?: number;
174
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;
175
190
  /**
176
191
  * Optional rAF seam for deterministic frame-loop scheduling in tests.
177
192
  * When omitted, the browser's requestAnimationFrame is used.
@@ -299,9 +314,15 @@ export interface StreamPhysicsFrameProps {
299
314
  title?: string | React.ReactNode;
300
315
  tooltipContent?: (hover: PhysicsHoverData) => React.ReactNode;
301
316
  workerBodyThreshold?: number;
302
- renderBody?: (ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style) => void;
303
- beforePaint?: (ctx: CanvasRenderingContext2D, bodies: PhysicsBodyState[]) => void;
304
- 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;
305
326
  }
306
327
  export interface StreamPhysicsFrameHandle extends PhysicsPipelineControlSurface {
307
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";
@@ -25,6 +25,8 @@ export interface PipelineConfig {
25
25
  * read as the actual data bounds. Default `"nice"` keeps the existing
26
26
  * padded domain so glyphs at the extremes don't clip the plot edge. */
27
27
  axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
28
+ /** Resolved y-axis mode. Falls back to `axisExtent` when omitted. */
29
+ yAxisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
28
30
  /**
29
31
  * Hard cap for `windowMode: "growing"`. Defaults to
30
32
  * {@link DEFAULT_GROWING_MAX_CAPACITY} (100_000). Canvas scene graphs
@@ -83,28 +85,15 @@ export interface PipelineConfig {
83
85
  semanticLineStops?: Array<{
84
86
  offset: number;
85
87
  color: string;
88
+ opacity?: number;
86
89
  }>;
87
90
  lineStyle?: Style | ((d: Datum, group?: string) => Style);
88
91
  pointStyle?: (d: Datum) => Style & {
89
92
  r?: number;
90
93
  };
91
94
  areaStyle?: (d: Datum) => Style;
92
- swarmStyle?: {
93
- radius?: number;
94
- fill?: string;
95
- opacity?: number;
96
- stroke?: string;
97
- strokeWidth?: number;
98
- };
99
- waterfallStyle?: {
100
- positiveColor?: string;
101
- negativeColor?: string;
102
- connectorStroke?: string;
103
- connectorWidth?: number;
104
- gap?: number;
105
- stroke?: string;
106
- strokeWidth?: number;
107
- };
95
+ swarmStyle?: SwarmStyle;
96
+ waterfallStyle?: WaterfallStyle;
108
97
  colorScheme?: string | string[] | Record<string, string>;
109
98
  /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
110
99
  themeCategorical?: string[];
@@ -144,6 +133,8 @@ export interface PipelineConfig {
144
133
  heatmapYBins?: number;
145
134
  showValues?: boolean;
146
135
  heatmapValueFormat?: (v: number) => string;
136
+ /** Explicit value-to-color function for heatmap cells. */
137
+ heatmapColorScale?: (value: number) => string;
147
138
  pointIdAccessor?: string | ((d: Datum) => string);
148
139
  curve?: CurveType;
149
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
  /**
@@ -20,7 +20,7 @@ export declare function isFullySpecifiedExtent(extent: [number | undefined, numb
20
20
  * normalized). Mirrors buildStackedAreaNodes order for wiggle offsets.
21
21
  */
22
22
  export declare function resolveStackedAreaYDomain(options: {
23
- config: Pick<PipelineConfig, "normalize" | "baseline" | "stackOrder" | "extentPadding" | "axisExtent">;
23
+ config: Pick<PipelineConfig, "normalize" | "baseline" | "stackOrder" | "extentPadding" | "axisExtent" | "yAxisExtent">;
24
24
  groups: {
25
25
  key: string;
26
26
  data: Datum[];
@@ -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;