semiotic 3.8.9 → 3.9.1

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 (502) hide show
  1. package/README.md +55 -81
  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-utils.d.ts +1 -1
  220. package/dist/components/semiotic-xy.d.ts +4 -1
  221. package/dist/components/semiotic.d.ts +68 -26
  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 +2 -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 +9 -0
  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 +10 -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 +7 -0
  290. package/dist/components/stream/networkPipelineConfig.d.ts +1 -1
  291. package/dist/components/stream/networkTypes.d.ts +30 -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 +10 -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 +23 -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 +6 -17
  313. package/dist/components/stream/pipelineDomainResolution.d.ts +1 -1
  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 +25 -12
  322. package/dist/components/stream/useCanvasFrameHost.d.ts +3 -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 +15 -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 +10 -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.d.ts +1 -1
  414. package/dist/semiotic-utils.min.js +2 -1
  415. package/dist/semiotic-utils.module.min.js +2 -1
  416. package/dist/semiotic-value.min.js +1 -1
  417. package/dist/semiotic-value.module.min.js +1 -1
  418. package/dist/semiotic-xy.d.ts +4 -1
  419. package/dist/semiotic.d.ts +68 -26
  420. package/dist/semiotic.min.js +1 -1
  421. package/dist/semiotic.module.min.js +1 -1
  422. package/dist/server.min.js +1 -1
  423. package/dist/server.module.min.js +1 -1
  424. package/dist/xy.min.js +1 -1
  425. package/dist/xy.module.min.js +1 -1
  426. package/package.json +53 -19
  427. package/dist/__tests__/scenarios/mcpProtocolTypes.d.ts +0 -20
  428. package/dist/chunk-OrdinalBrushOverlay-PXHQYDB2.module.min.js +0 -2
  429. package/dist/chunk-XYBrushOverlay-ECZJJLAJ.module.min.js +0 -1
  430. package/dist/chunk-XYBrushOverlay-EP2SV3UI.module.min.js +0 -2
  431. package/dist/chunk-chartContainerDataAudit-IQ3NBN3Q.module.min.js +0 -2
  432. package/dist/chunk-chunk-2B3AIKUZ.module.min.js +0 -2
  433. package/dist/chunk-chunk-2CXCXRB4.module.min.js +0 -1
  434. package/dist/chunk-chunk-2X3FJCME.module.min.js +0 -1
  435. package/dist/chunk-chunk-2ZHHWZQM.module.min.js +0 -2
  436. package/dist/chunk-chunk-4ITOQRXM.module.min.js +0 -2
  437. package/dist/chunk-chunk-5UKL5W76.module.min.js +0 -2
  438. package/dist/chunk-chunk-5VVNW5AZ.module.min.js +0 -1
  439. package/dist/chunk-chunk-5ZON5NMV.module.min.js +0 -2
  440. package/dist/chunk-chunk-66PCWJUG.module.min.js +0 -1
  441. package/dist/chunk-chunk-6S3YGYW7.module.min.js +0 -1
  442. package/dist/chunk-chunk-6V5VQVCT.module.min.js +0 -2
  443. package/dist/chunk-chunk-7C5EDZ3Z.module.min.js +0 -2
  444. package/dist/chunk-chunk-A3I4HBD5.module.min.js +0 -1
  445. package/dist/chunk-chunk-ACLDBMRH.module.min.js +0 -2
  446. package/dist/chunk-chunk-AFQHURLO.module.min.js +0 -2
  447. package/dist/chunk-chunk-DDB4TLQG.module.min.js +0 -2
  448. package/dist/chunk-chunk-DTH3SUOU.module.min.js +0 -2
  449. package/dist/chunk-chunk-DTSNLGRK.module.min.js +0 -2
  450. package/dist/chunk-chunk-DVCWU7MT.module.min.js +0 -2
  451. package/dist/chunk-chunk-FEPXDKJP.module.min.js +0 -1
  452. package/dist/chunk-chunk-FJ76HWQZ.module.min.js +0 -1
  453. package/dist/chunk-chunk-FSIHAW6L.module.min.js +0 -2
  454. package/dist/chunk-chunk-G2RGVEYY.module.min.js +0 -2
  455. package/dist/chunk-chunk-G75OPF5N.module.min.js +0 -2
  456. package/dist/chunk-chunk-HADHLMY5.module.min.js +0 -1
  457. package/dist/chunk-chunk-HAJVODLO.module.min.js +0 -2
  458. package/dist/chunk-chunk-HBFA4NN6.module.min.js +0 -1
  459. package/dist/chunk-chunk-HIV7AW2V.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-JZAMMSQQ.module.min.js +0 -2
  464. package/dist/chunk-chunk-KTWEBFMX.module.min.js +0 -2
  465. package/dist/chunk-chunk-LSJUXBMF.module.min.js +0 -1
  466. package/dist/chunk-chunk-MXMRXSCI.module.min.js +0 -2
  467. package/dist/chunk-chunk-MXVBXFKW.module.min.js +0 -2
  468. package/dist/chunk-chunk-NWIGA3UK.module.min.js +0 -1
  469. package/dist/chunk-chunk-OFAP623Y.module.min.js +0 -2
  470. package/dist/chunk-chunk-OHLRAEQZ.module.min.js +0 -2
  471. package/dist/chunk-chunk-OZK46A5U.module.min.js +0 -1
  472. package/dist/chunk-chunk-PMR47KRY.module.min.js +0 -2
  473. package/dist/chunk-chunk-PRNXOCYZ.module.min.js +0 -2
  474. package/dist/chunk-chunk-Q2YADC2V.module.min.js +0 -2
  475. package/dist/chunk-chunk-RLKZVJMQ.module.min.js +0 -2
  476. package/dist/chunk-chunk-ROP4HI7H.module.min.js +0 -2
  477. package/dist/chunk-chunk-SK2TQMG4.module.min.js +0 -2
  478. package/dist/chunk-chunk-SKLYXNYW.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-U4NZCU5T.module.min.js +0 -2
  482. package/dist/chunk-chunk-U66USBWU.module.min.js +0 -1
  483. package/dist/chunk-chunk-UOQRPGPK.module.min.js +0 -2
  484. package/dist/chunk-chunk-VKL6DI43.module.min.js +0 -2
  485. package/dist/chunk-chunk-W62673ZE.module.min.js +0 -1
  486. package/dist/chunk-chunk-WFHZHWT7.module.min.js +0 -1
  487. package/dist/chunk-chunk-XCC25CZZ.module.min.js +0 -2
  488. package/dist/chunk-chunk-XECNOUZY.module.min.js +0 -2
  489. package/dist/chunk-chunk-XYZDTYAF.module.min.js +0 -2
  490. package/dist/chunk-chunk-YHNZCPOZ.module.min.js +0 -2
  491. package/dist/chunk-chunk-YWZB3KPI.module.min.js +0 -2
  492. package/dist/chunk-statisticalOverlays-HMYYSGPE.module.min.js +0 -2
  493. package/dist/components/stream/test-utils/frameScheduler.d.ts +0 -12
  494. package/dist/components/stream/test-utils/revisionConsumption.d.ts +0 -13
  495. package/dist/test-utils/canvasMock.d.ts +0 -86
  496. package/dist/test-utils/capturedFrameProps.d.ts +0 -67
  497. package/dist/test-utils/frameMock.d.ts +0 -81
  498. package/dist/test-utils/ordinalFixtures.d.ts +0 -48
  499. /package/dist/{chunk-chunk-JJ2OOIET.module.min.js → c-GGISSW5E.min.js} +0 -0
  500. /package/dist/{chunk-chunk-SIRIJ3DY.module.min.js → c-N4G2L7ID.min.js} +0 -0
  501. /package/dist/{chunk-chunk-CA3YDW6F.module.min.js → c-S6U5CGT5.min.js} +0 -0
  502. /package/dist/components/recipes/{mobileAnnotationStrategy.d.ts → mobileAnnotationBehavior.d.ts} +0 -0
@@ -1,6 +1,6 @@
1
- import type { PointSceneNode, RectSceneNode, SceneDatum } from "./types";
1
+ import type { PointSceneNode, RectSceneNode, SceneAccessibilityMetadata, SceneDatum, Style } from "./types";
2
2
  import type { GeoAreaSceneNode } from "./geoTypes";
3
- import type { NetworkCircleNode, NetworkRectNode } from "./networkTypes";
3
+ import type { NetworkBezierEdge, NetworkCircleNode, NetworkCurvedEdge, NetworkLineEdge, NetworkRectNode, NetworkRibbonEdge } from "./networkTypes";
4
4
  /** Default hit/keyboard-focus radius (px) — larger than a typical glyph so the
5
5
  * target is easy to hit by pointer and to land on by keyboard (Fitts's law). */
6
6
  export declare const DEFAULT_HIT_RADIUS = 8;
@@ -17,6 +17,8 @@ export interface HitTargetPointProps {
17
17
  id?: string | number;
18
18
  /** Hit + keyboard-focus radius in px. @default {@link DEFAULT_HIT_RADIUS} */
19
19
  r?: number;
20
+ /** Presentation-only cursor for the matching overlay-drawn mark. */
21
+ cursor?: Style["cursor"];
20
22
  }
21
23
  /**
22
24
  * A transparent, hit-testable **point** node for a custom XY or ordinal layout
@@ -66,6 +68,8 @@ export interface GeoAreaHitTargetProps {
66
68
  group?: string;
67
69
  /** Screen-space area in px^2. Defaults to the bounding-box area. */
68
70
  screenArea?: number;
71
+ /** Presentation-only cursor for the matching overlay-drawn area. */
72
+ cursor?: Style["cursor"];
69
73
  }
70
74
  /**
71
75
  * A transparent, hit-testable **area** node for a custom geo layout whose
@@ -105,6 +109,8 @@ export interface HitTargetRectProps {
105
109
  id?: string | number;
106
110
  /** Optional series/category key for grouped selection + legend interaction. */
107
111
  group?: string;
112
+ /** Presentation-only cursor for the matching overlay-drawn mark. */
113
+ cursor?: Style["cursor"];
108
114
  }
109
115
  /**
110
116
  * A transparent, hit-testable **rect** node for a custom XY or ordinal layout —
@@ -127,6 +133,12 @@ export interface NetworkHitTargetCircleProps {
127
133
  r?: number;
128
134
  /** Optional accessible label override for the node. */
129
135
  label?: string;
136
+ /** Full user-facing row when the render datum is geometry-oriented. */
137
+ accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
138
+ /** Accessible label and/or a curated data-table projection. */
139
+ accessibility?: SceneAccessibilityMetadata["accessibility"];
140
+ /** Presentation-only cursor for the matching overlay-drawn node. */
141
+ cursor?: Style["cursor"];
130
142
  }
131
143
  export interface NetworkHitTargetRectProps {
132
144
  /** Plot-relative x of the rect's top-left corner. */
@@ -143,6 +155,12 @@ export interface NetworkHitTargetRectProps {
143
155
  id?: string | number;
144
156
  /** Optional accessible label override for the node. */
145
157
  label?: string;
158
+ /** Full user-facing row when the render datum is geometry-oriented. */
159
+ accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
160
+ /** Accessible label and/or a curated data-table projection. */
161
+ accessibility?: SceneAccessibilityMetadata["accessibility"];
162
+ /** Presentation-only cursor for the matching overlay-drawn node. */
163
+ cursor?: Style["cursor"];
146
164
  }
147
165
  /**
148
166
  * A transparent, hit-testable node for a custom **network** layout. Pass `width`
@@ -168,3 +186,44 @@ export interface NetworkHitTargetRectProps {
168
186
  */
169
187
  export declare function networkHitTarget(props: NetworkHitTargetRectProps): NetworkRectNode;
170
188
  export declare function networkHitTarget(props: NetworkHitTargetCircleProps): NetworkCircleNode;
189
+ export interface NetworkEdgeHitTargetBaseProps {
190
+ /** Raw edge datum surfaced by pointer observation and the data table. */
191
+ datum: SceneDatum;
192
+ /** Optional stable semantic identity for the edge. */
193
+ id?: string | number;
194
+ /** Human-readable row label for the accessible data table. */
195
+ label?: string;
196
+ /** Full user-facing row when the render datum is geometry-oriented. */
197
+ accessibleDatum?: SceneAccessibilityMetadata["accessibleDatum"];
198
+ /** Accessible label and/or a curated data-table projection. */
199
+ accessibility?: SceneAccessibilityMetadata["accessibility"];
200
+ /**
201
+ * Whether the transparent edge participates in pointer hit testing. Set to
202
+ * false when the edge exists only to add a semantic table row.
203
+ * @default true
204
+ */
205
+ interactive?: boolean;
206
+ /** Presentation-only cursor for the matching overlay-drawn edge. */
207
+ cursor?: Style["cursor"];
208
+ }
209
+ export interface NetworkLineEdgeHitTargetProps extends NetworkEdgeHitTargetBaseProps {
210
+ type?: "line";
211
+ x1: number;
212
+ y1: number;
213
+ x2: number;
214
+ y2: number;
215
+ }
216
+ export interface NetworkPathEdgeHitTargetProps extends NetworkEdgeHitTargetBaseProps {
217
+ /** Curved paths are the most general default; bezier/ribbon reuse the same path contract. */
218
+ type?: "curved" | "bezier" | "ribbon";
219
+ pathD: string;
220
+ }
221
+ /**
222
+ * A transparent semantic edge for a custom network layout whose visible links
223
+ * live in `overlays`. It contributes an edge row to the accessible data table
224
+ * and, by default, retains the frame's geometry-based pointer observation.
225
+ * Network keyboard traversal remains node-based; set `interactive: false` for
226
+ * an accessibility-table-only edge that should not intercept the pointer.
227
+ */
228
+ export declare function networkEdgeHitTarget(props: NetworkLineEdgeHitTargetProps): NetworkLineEdge;
229
+ export declare function networkEdgeHitTarget(props: NetworkPathEdgeHitTargetProps): NetworkBezierEdge | NetworkRibbonEdge | NetworkCurvedEdge;
@@ -32,6 +32,12 @@ export interface ModuleWorkerSessionOptions<TRequest, TResponse> {
32
32
  * Wrap a domain request for `postMessage`. Default: `{ requestId, request }`.
33
33
  */
34
34
  encodeRequest?: (requestId: number, request: TRequest) => unknown;
35
+ /**
36
+ * Terminate the worker when a request is aborted. Worker message handlers
37
+ * cannot interrupt CPU-bound synchronous layout code, so termination is the
38
+ * only cancellation mode that actually stops superseded work.
39
+ */
40
+ terminateOnAbort?: boolean;
35
41
  }
36
42
  declare function errorFromPayload(payload: ModuleWorkerErrorPayload): Error;
37
43
  /**
@@ -0,0 +1,37 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type GlyphDef } from "./glyphDef";
3
+ export type NetworkAnnotationAnchorNode = {
4
+ type: string;
5
+ datum: Datum | null;
6
+ id?: string;
7
+ x?: number;
8
+ y?: number;
9
+ cx?: number;
10
+ cy?: number;
11
+ w?: number;
12
+ h?: number;
13
+ /** Circle nodes (NetworkCircleNode, force/tree/orbit marks) carry an explicit radius. */
14
+ r?: number;
15
+ /** Arc nodes (chord, radial) carry an outer radius. */
16
+ outerR?: number;
17
+ /** Symbol nodes carry a d3-symbol area; glyph nodes reuse `size` as rendered height. */
18
+ size?: number;
19
+ /** Glyph nodes (the composite-pictogram channel) carry a definition. */
20
+ glyph?: GlyphDef;
21
+ };
22
+ export type NetworkAnnotationAnchor = {
23
+ pointId?: string;
24
+ x: number;
25
+ y: number;
26
+ r: number;
27
+ };
28
+ /** Anchor id for a scene node — resolves `pointId` annotations to a mark. */
29
+ export declare function nodeAnchorId(node: NetworkAnnotationAnchorNode): string | undefined;
30
+ /** Center + effective radius of a network scene node for annotation anchoring. */
31
+ export declare function nodeCenter(node: NetworkAnnotationAnchorNode): {
32
+ x: number;
33
+ y: number;
34
+ r: number;
35
+ } | null;
36
+ /** Collect the stable annotation anchors exposed by a laid-out network scene. */
37
+ export declare function collectNetworkAnnotationAnchors(nodes: ReadonlyArray<NetworkAnnotationAnchorNode> | undefined): NetworkAnnotationAnchor[] | undefined;
@@ -86,8 +86,8 @@ export interface NetworkLayoutContext<C extends object = Record<string, unknown>
86
86
  * Shared-selection projection. Present when the chart is wired to a
87
87
  * `LinkedCharts` / selection store; `null` otherwise. Use
88
88
  * `selection.isActive` + `selection.predicate(node.data ?? node)` to
89
- * dim/highlight marks by the cross-chart selection. See
90
- * {@link NetworkLayoutSelection}.
89
+ * dim/highlight marks by the cross-chart selection. See the
90
+ * `NetworkLayoutSelection` type.
91
91
  */
92
92
  selection?: NetworkLayoutSelection | null;
93
93
  }
@@ -0,0 +1,12 @@
1
+ import type { NetworkPipelineStore } from "./NetworkPipelineStore";
2
+ import type { CursorFrameGeometry } from "./frameCursorInteraction";
3
+ import type { NetworkSceneEdge, NetworkSceneNode } from "./networkTypes";
4
+ export interface NetworkCursorInventory {
5
+ nodes: boolean;
6
+ edges: boolean;
7
+ }
8
+ export declare function refreshNetworkCursorInventory(inventory: NetworkCursorInventory, nodes: ReadonlyArray<NetworkSceneNode>, edges: ReadonlyArray<NetworkSceneEdge>): boolean;
9
+ export declare function rehitNetworkFrameCursor(options: CursorFrameGeometry & {
10
+ store: NetworkPipelineStore;
11
+ cursorInventory: Readonly<NetworkCursorInventory>;
12
+ }): void;
@@ -14,6 +14,7 @@ export type NetworkPointerHit = {
14
14
  } | {
15
15
  kind: "hit";
16
16
  hover: HoverData;
17
+ mark: NetworkSceneNode | NetworkSceneEdge | undefined;
17
18
  };
18
19
  export declare function resolveNetworkPointerHit(options: {
19
20
  clientX: number;
@@ -30,6 +31,7 @@ export declare function resolveNetworkPointerHit(options: {
30
31
  nodeQuadtree: Quadtree<NetworkCircleNode> | null;
31
32
  maxNodeRadius: number;
32
33
  hitRadius?: number;
34
+ includeEdges?: boolean;
33
35
  }): NetworkPointerHit;
34
36
  export declare function pointerFromMouseEvent(e: {
35
37
  clientX: number;
@@ -12,6 +12,8 @@ export interface NetworkFramePaintContext {
12
12
  adjustedWidth: number;
13
13
  adjustedHeight: number;
14
14
  background?: string;
15
+ /** Theme surface fallback used when `background` is unset. */
16
+ themeBackground?: string;
15
17
  maxDevicePixelRatio?: number;
16
18
  renderMode?: SceneRenderMode<NetworkSceneNode | NetworkSceneEdge>;
17
19
  /** Skip opaque canvas fill when an SVG backgroundGraphics layer is present. */
@@ -54,6 +56,11 @@ export interface NetworkFramePaintContext {
54
56
  scheduleNextFrame: () => void;
55
57
  /** Resync color caches from scene fills after an invalidating rebuild. */
56
58
  syncColorMap?: () => void;
59
+ /** Refresh cursor inventory/presentation after scene mutations. */
60
+ onSceneOrStyleChange?: (change: {
61
+ inventoryChanged: boolean;
62
+ geometryChanged: boolean;
63
+ }) => void;
57
64
  }
58
65
  /**
59
66
  * Run one paint tick. Returns whether another rAF should be scheduled
@@ -2,7 +2,7 @@
2
2
  * Build NetworkPipelineConfig from StreamNetworkFrame props + theme.
3
3
  * Keeps the large useMemo payload out of the React component file.
4
4
  */
5
- import type { SemioticTheme } from "../store/ThemeStore";
5
+ import type { SemioticTheme } from "../store/themeCore";
6
6
  import type { NetworkPipelineConfig } from "./networkTypes";
7
7
  import type { StreamNetworkFrameProps } from "./networkTypes";
8
8
  export type NetworkPipelineConfigSources = Pick<StreamNetworkFrameProps, "chartType" | "nodeIDAccessor" | "sourceAccessor" | "targetAccessor" | "valueAccessor" | "edgeIdAccessor" | "childrenAccessor" | "hierarchySum" | "orientation" | "nodeAlign" | "nodePaddingRatio" | "nodeWidth" | "iterations" | "forceStrength" | "padAngle" | "groupWidth" | "sortGroups" | "edgeSort" | "treeOrientation" | "edgeType" | "padding" | "paddingTop" | "nodeStyle" | "edgeStyle" | "nodeLabel" | "showLabels" | "labelMode" | "colorBy" | "colorScheme" | "edgeColorBy" | "edgeOpacity" | "colorByDepth" | "nodeSize" | "nodeSizeRange" | "decay" | "pulse" | "transition" | "staleness" | "thresholds" | "orbitMode" | "orbitSize" | "orbitSpeed" | "orbitRevolution" | "orbitRevolutionStyle" | "orbitEccentricity" | "orbitShowRings" | "orbitAnimated" | "clock" | "random" | "seed" | "customNetworkLayout" | "onLayoutError" | "layoutConfig"> & {
@@ -6,12 +6,15 @@ type NetworkDatumComparator = {
6
6
  }["bivarianceHack"];
7
7
  type NetworkGroupComparator = (a: number, b: number) => number;
8
8
  import type { LegendLayout, LegendValue } from "../types/legendTypes";
9
- import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors, SceneDatum, SceneAccessibilityMetadata, SceneRenderMode } from "./types";
9
+ import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors, SceneDatum, SceneAccessibilityMetadata, SceneRenderMode, FrameGraphicsProp } from "./types";
10
10
  import type { AnimateProp } from "./pipelineTransitionUtils";
11
11
  import type { NetworkSymbolName } from "./symbolPath";
12
12
  import type { GlyphDef } from "./glyphDef";
13
13
  import type { StreamNetworkFrameHandle } from "./networkFrameHandleTypes";
14
14
  import type { StreamNetworkInteractionProps } from "./networkInteractionTypes";
15
+ import type { AccessibleTableProp } from "./accessibleTableTypes";
16
+ /** Style-callback result, including `cursor` on legacy datum-shaped returns. */
17
+ export type NetworkMarkStyle = Style | (Datum & Pick<Style, "cursor">);
15
18
  export interface TensionConfig {
16
19
  weightChange: number;
17
20
  newEdge: number;
@@ -47,27 +50,13 @@ export interface RealtimeNode {
47
50
  _pulseIntensity?: number;
48
51
  _pulseColor?: string;
49
52
  _pulseGlowRadius?: number;
50
- /**
51
- * @internal Hierarchy-layout-only extension fields. Set by
52
- * `hierarchyLayoutPlugin` / `orbitLayoutPlugin` during layout and
53
- * read by `hierarchySceneBuilders`. Typed `unknown` because the d3
54
- * `HierarchyNode` shape is layout-specific (rectangular, circular,
55
- * point) — consumers narrow with the structural fields they need.
56
- */
53
+ /** @internal Hierarchy-layout metadata; consumers narrow to the plugin-specific shape. */
57
54
  __hierarchyNode?: unknown;
58
55
  /** @internal Circle-pack layout radius. Set by `hierarchyLayoutPlugin`. */
59
56
  __radius?: number;
60
57
  /** @internal Pre-resolved force-layout radius used by worker snapshots. */
61
58
  __forceRadius?: number;
62
- /**
63
- * @internal Chord-layout extension. Carries the start/end angles
64
- * for the arc segment representing this node, computed by
65
- * `chordLayoutPlugin` and read by its `buildScene`. Concretely
66
- * typed (unlike `__hierarchyNode`) because chord is the only
67
- * layout that writes this field, so the shape is fixed — no
68
- * narrowing-at-read needed. `__` prefix matches the convention
69
- * used by `__hierarchyNode` / `__radius` on this same interface.
70
- */
59
+ /** @internal Chord-layout arc segment angles. */
71
60
  __arcData?: {
72
61
  startAngle: number;
73
62
  endAngle: number;
@@ -331,8 +320,19 @@ export interface NetworkGlyphNode {
331
320
  _pulseColor?: string;
332
321
  _pulseGlowRadius?: number;
333
322
  }
323
+ /**
324
+ * Semantic and interaction metadata shared by every network edge shape.
325
+ * Custom layouts can expose a curated accessible-table row without changing
326
+ * the render datum, and can opt decorative/table-only edges out of pointer
327
+ * hit testing with `interactive: false`.
328
+ */
329
+ interface NetworkEdgeMetadata extends SceneAccessibilityMetadata {
330
+ id?: string;
331
+ label?: string;
332
+ interactive?: boolean;
333
+ }
334
334
  /** Line edge — used by force */
335
- export interface NetworkLineEdge {
335
+ export interface NetworkLineEdge extends NetworkEdgeMetadata {
336
336
  type: "line";
337
337
  x1: number;
338
338
  y1: number;
@@ -344,13 +344,9 @@ export interface NetworkLineEdge {
344
344
  _pulseColor?: string;
345
345
  }
346
346
  /** Bezier band edge — used by sankey */
347
- export interface NetworkBezierEdge {
347
+ export interface NetworkBezierEdge extends NetworkEdgeMetadata {
348
348
  type: "bezier";
349
349
  pathD: string;
350
- /** When false, the hit tester skips this edge. Used for
351
- * decorative scene-edges like ProcessSankey's gradient stubs —
352
- * they paint visually but shouldn't intercept hover. */
353
- interactive?: boolean;
354
350
  bezierCache?: BezierCache;
355
351
  style: Style;
356
352
  datum: SceneDatum;
@@ -370,7 +366,7 @@ export interface NetworkBezierEdge {
370
366
  _cachedPath2DSource?: string;
371
367
  }
372
368
  /** Ribbon edge — used by chord */
373
- export interface NetworkRibbonEdge {
369
+ export interface NetworkRibbonEdge extends NetworkEdgeMetadata {
374
370
  type: "ribbon";
375
371
  pathD: string;
376
372
  style: Style;
@@ -381,7 +377,7 @@ export interface NetworkRibbonEdge {
381
377
  _cachedPath2DSource?: string;
382
378
  }
383
379
  /** Curved edge — used by tree, cluster */
384
- export interface NetworkCurvedEdge {
380
+ export interface NetworkCurvedEdge extends NetworkEdgeMetadata {
385
381
  type: "curved";
386
382
  pathD: string;
387
383
  style: Style;
@@ -486,8 +482,8 @@ export interface NetworkPipelineConfig {
486
482
  tensionConfig?: TensionConfig;
487
483
  showParticles?: boolean;
488
484
  particleStyle?: ParticleStyle;
489
- nodeStyle?: (d: Datum) => Datum;
490
- edgeStyle?: (d: Datum) => Datum;
485
+ nodeStyle?: (d: Datum) => NetworkMarkStyle;
486
+ edgeStyle?: (d: Datum) => NetworkMarkStyle;
491
487
  nodeLabel?: string | ((d: Datum) => string);
492
488
  showLabels?: boolean;
493
489
  labelMode?: "leaf" | "parent" | "all";
@@ -595,8 +591,8 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
595
591
  tensionConfig?: Partial<TensionConfig>;
596
592
  showParticles?: boolean;
597
593
  particleStyle?: ParticleStyle;
598
- nodeStyle?: (d: Datum) => Datum;
599
- edgeStyle?: (d: Datum) => Datum;
594
+ nodeStyle?: (d: Datum) => NetworkMarkStyle;
595
+ edgeStyle?: (d: Datum) => NetworkMarkStyle;
600
596
  colorBy?: string | ((d: Datum) => string | number);
601
597
  colorScheme?: string | string[] | Record<string, string>;
602
598
  edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
@@ -632,8 +628,10 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
632
628
  legendHighlightedCategory?: string | null;
633
629
  legendIsolatedCategories?: Set<string>;
634
630
  title?: string | ReactNode;
635
- foregroundGraphics?: ReactNode;
636
- backgroundGraphics?: ReactNode;
631
+ /** SVG above the canvas. Network layouts have no shared scale object, so callback `scales` is null. */
632
+ foregroundGraphics?: FrameGraphicsProp<null>;
633
+ /** SVG behind the canvas. Network layouts have no shared scale object, so callback `scales` is null. */
634
+ backgroundGraphics?: FrameGraphicsProp<null>;
637
635
  decay?: DecayConfig;
638
636
  pulse?: PulseConfig;
639
637
  transition?: TransitionConfig;
@@ -664,7 +662,7 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
664
662
  orbitShowRings?: boolean;
665
663
  orbitAnimated?: boolean;
666
664
  /** Render a visually-hidden data table from the scene graph for screen readers */
667
- accessibleTable?: boolean;
665
+ accessibleTable?: AccessibleTableProp;
668
666
  /** Accessible description overriding the auto-generated aria-label on the chart container */
669
667
  description?: string;
670
668
  /** Accessible summary rendered as a screen-reader-only note */
@@ -0,0 +1,7 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ /**
3
+ * Normalize the grouped line shape accepted by the XY frame into the flat
4
+ * datum stream consumed by PipelineStore. Keeping this at the frame boundary
5
+ * makes controlled CSR, direct React SSR, and the static renderer agree.
6
+ */
7
+ export declare function normalizeXYData(data: Datum[], lineDataAccessor?: string): Datum[];
@@ -0,0 +1,7 @@
1
+ import type { OrdinalPipelineStore } from "./OrdinalPipelineStore";
2
+ import type { CursorFrameGeometry } from "./frameCursorInteraction";
3
+ export declare function rehitOrdinalFrameCursor(options: CursorFrameGeometry & {
4
+ store: OrdinalPipelineStore;
5
+ hoverRadius: number;
6
+ projection: "vertical" | "horizontal" | "radial";
7
+ }): void;
@@ -0,0 +1,29 @@
1
+ import type { Quadtree } from "d3-quadtree";
2
+ import { type OrdinalHitResult } from "./OrdinalCanvasHitTester";
3
+ import type { HoverData, OrdinalSceneNode, OrdinalScales, StreamOrdinalFrameProps } from "./ordinalTypes";
4
+ import type { PointSceneNode } from "./types";
5
+ export type OrdinalPointerResolution = {
6
+ kind: "outside" | "miss";
7
+ } | {
8
+ kind: "hit";
9
+ hit: OrdinalHitResult;
10
+ };
11
+ export declare function resolveOrdinalPointerHit(options: {
12
+ pointer: {
13
+ clientX: number;
14
+ clientY: number;
15
+ };
16
+ canvasRect: Pick<DOMRect, "left" | "top">;
17
+ margin: {
18
+ left: number;
19
+ top: number;
20
+ };
21
+ width: number;
22
+ height: number;
23
+ projection: OrdinalScales["projection"];
24
+ hoverRadius: number;
25
+ scene: OrdinalSceneNode[];
26
+ pointQuadtree: Quadtree<PointSceneNode> | null;
27
+ maxPointRadius: number;
28
+ }): OrdinalPointerResolution;
29
+ export declare function ordinalHitToHover(hit: OrdinalHitResult, options: Pick<StreamOrdinalFrameProps, "oAccessor" | "rAccessor" | "chartType">): HoverData;
@@ -0,0 +1,10 @@
1
+ import type { OrdinalSceneNode } from "./ordinalTypes";
2
+ import type { SceneRenderMode } from "./types";
3
+ import { type RenderedSceneEntry } from "./renderBackend";
4
+ type OrdinalSceneEntry = RenderedSceneEntry<OrdinalSceneNode>;
5
+ export declare function renderOrdinalSceneListWithBackend(args: {
6
+ nodes: OrdinalSceneNode[];
7
+ renderMode: SceneRenderMode<OrdinalSceneNode> | undefined;
8
+ idPrefix?: string;
9
+ }): OrdinalSceneEntry[];
10
+ export {};
@@ -11,6 +11,10 @@ import type { OnObservationCallback } from "../store/ObservationStore";
11
11
  import type { SemanticClickBehavior, SemanticHoverBehavior } from "../charts/shared/semanticInteractions";
12
12
  import type { OnAnnotationActivateCallback } from "../charts/shared/annotationActivation";
13
13
  import type { GradientConfig, GradientInput } from "../charts/shared/gradient";
14
+ import type { AccessibleTableProp } from "./accessibleTableTypes";
15
+ /** A fixed radius or a deterministic radius derived from the rendered bar
16
+ * width (the category-axis bandwidth, in pixels). */
17
+ export type BarCornerRadius = number | ((barWidth: number) => number);
14
18
  export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline" | "funnel" | "bar-funnel" | "swimlane" | "custom";
15
19
  export interface OrdinalScales {
16
20
  o: ScaleBand<string>;
@@ -222,8 +226,8 @@ export interface OrdinalPipelineConfig {
222
226
  rExtent?: [number?, number?];
223
227
  oExtent?: string[];
224
228
  barPadding?: number;
225
- /** Rounded top corner radius for bar charts. Only the end away from the baseline is rounded. For stacked bars, only the topmost segment gets rounded. */
226
- roundedTop?: number;
229
+ /** Rounded top corner radius for bar charts. Only the end away from the baseline is rounded. For stacked bars, only the topmost segment gets rounded. A callback receives the rendered bar width in pixels. */
230
+ roundedTop?: BarCornerRadius;
227
231
  /** Gradient fill for bar rects. Offset 0 is the tip; offset 1 is the base. */
228
232
  gradientFill?: GradientConfig;
229
233
  /** Swimlane "track" fill — a rect drawn behind each lane spanning the
@@ -329,7 +333,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
329
333
  /** Maximum canvas backing-store DPR; defaults to the environment cap. */
330
334
  maxDevicePixelRatio?: number;
331
335
  barPadding?: number;
332
- roundedTop?: number;
336
+ roundedTop?: BarCornerRadius;
333
337
  /** Gradient fill for bar rects. Offset 0 is the tip; offset 1 is the base. */
334
338
  gradientFill?: GradientInput;
335
339
  /** Swimlane "track" fill — see OrdinalPipelineConfig.trackFill */
@@ -396,6 +400,8 @@ export interface StreamOrdinalFrameProps<T = Datum> {
396
400
  /** @deprecated Use valueFormat */
397
401
  rFormat?: (d: number | string) => string;
398
402
  enableHover?: boolean;
403
+ /** Maximum distance in pixels for point/symbol hover and click hit testing. */
404
+ hoverRadius?: number;
399
405
  hoverAnnotation?: boolean | HoverAnnotationConfig;
400
406
  tooltipContent?: (d: HoverData) => ReactNode;
401
407
  customHoverBehavior?: SemanticHoverBehavior<HoverData>;
@@ -466,7 +472,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
466
472
  /** Freeze logical animation time while the document is hidden. Defaults to true. */
467
473
  suspendWhenHidden?: boolean;
468
474
  /** Render a visually-hidden data table from the scene graph for screen readers */
469
- accessibleTable?: boolean;
475
+ accessibleTable?: AccessibleTableProp;
470
476
  /** Accessible description overriding the auto-generated aria-label on the chart container */
471
477
  description?: string;
472
478
  /** Accessible summary rendered as a screen-reader-only note */
@@ -1,10 +1,18 @@
1
1
  import type { PhysicsEngineAdapter } from "./PhysicsEngineAdapter";
2
2
  import type { PhysicsBodyState } from "./PhysicsKernel";
3
+ export interface PhysicsBodyHitTestOptions {
4
+ /** Skip bodies that cannot satisfy this hit-test channel. */
5
+ include?: (body: PhysicsBodyState) => boolean;
6
+ /** Maximum center-to-pointer extent for the custom geometry. */
7
+ searchRadius?: number;
8
+ /** Return a sortable distance for a hit, or null for a miss. */
9
+ distanceSquared?: (body: PhysicsBodyState, x: number, y: number) => number | null;
10
+ }
3
11
  /** Revision-keyed body index used by PhysicsPipelineStore hit testing. */
4
12
  export declare class PhysicsBodySpatialIndex {
5
13
  private maxSearchRadius;
6
14
  private revision;
7
15
  private tree;
8
- hitTest(world: PhysicsEngineAdapter, revision: number, liveBodyOrder: readonly string[], x: number, y: number, radius?: number): PhysicsBodyState | null;
16
+ hitTest(world: PhysicsEngineAdapter, revision: number, liveBodyOrder: readonly string[], x: number, y: number, radius?: number, options?: PhysicsBodyHitTestOptions): PhysicsBodyState | null;
9
17
  private ensure;
10
18
  }
@@ -22,5 +22,30 @@ export interface PhysicsCanvasTheme {
22
22
  warning: string;
23
23
  }
24
24
  export declare const DEFAULT_PHYSICS_CANVAS_THEME: PhysicsCanvasTheme;
25
+ type CSSVarCandidate = {
26
+ fallback: string;
27
+ names: string[];
28
+ };
29
+ declare const THEME_CANDIDATES: Record<"background" | "border" | "danger" | "focus" | "grid" | "primary" | "success" | "text" | "textSecondary" | "warning", CSSVarCandidate>;
30
+ export type PhysicsCanvasThemeCSSKey = keyof typeof THEME_CANDIDATES;
31
+ /**
32
+ * Serialize the canvas theme's ordered CSS-variable candidates for SVG/SSR.
33
+ *
34
+ * Canvas reads the first non-empty computed custom property at paint time.
35
+ * A nested `var()` chain gives settled SVG the same candidate order and the
36
+ * same unthemed fallback without requiring DOM style inspection on the server.
37
+ */
38
+ export declare function physicsCanvasThemeCSSValue(key: PhysicsCanvasThemeCSSKey): string;
25
39
  export declare function physicsCanvasColorWithAlpha(color: string, opacity: number): string;
26
40
  export declare function resolvePhysicsCanvasTheme(ctx: CanvasRenderingContext2D): PhysicsCanvasTheme;
41
+ /**
42
+ * Version-keyed per-frame cache for the derived physics palette. Continuous
43
+ * simulations can call this every tick without forcing style recalculation;
44
+ * ThemeProvider and scoped CSS invalidation bump the shared color-cache
45
+ * version before the next paint.
46
+ */
47
+ export declare function createPhysicsCanvasThemeCache(): {
48
+ resolve(ctx: CanvasRenderingContext2D): PhysicsCanvasTheme;
49
+ invalidate(): void;
50
+ };
51
+ export {};
@@ -70,6 +70,3 @@ export declare function createPortalController(options: {
70
70
  onPortal?: (body: PhysicsBodyState) => void;
71
71
  }): PhysicsController;
72
72
  export type PhysicsControllerFactory = typeof createCapacityQueueController;
73
- export { createDependencyGateController, createServiceLevelController, createServiceResourcePoolController } from "./ServiceOperationsControllers";
74
- export type { DependencyGateController, ServiceLevelController, ServiceResourcePoolController } from "./ServiceOperationsControllers";
75
- export type { DependencyGateOptions, DependencyGateSnapshot, ServiceLevelCaseInfo, ServiceLevelCaseState, ServiceLevelControllerOptions, ServiceLevelSnapshot, ServiceResourceAssignment, ServiceResourceDefinition, ServiceResourcePoolOptions, ServiceResourcePoolSnapshot } from "./ServiceOperationsTypes";
@@ -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;