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
@@ -0,0 +1,139 @@
1
+ import type * as React from "react";
2
+ import type { ProcessSankeyOrientation } from "./processSankey/orientation";
3
+ import type { ProcessSankeyLayoutExecution } from "./processSankey/processSankeyLayoutWorkerClient";
4
+ import type { ProcessSankeyTimeLike } from "./processSankey/time";
5
+ import type { StyleRule } from "../shared/styleRules";
6
+ import type { Datum } from "../shared/datumTypes";
7
+ import type { BaseChartProps, ChartAccessor, LinkedHoverProp, SelectionConfig } from "../shared/types";
8
+ import type { ParticleStyle, StreamNetworkFrameProps } from "../../stream/networkTypes";
9
+ import type { TooltipProp } from "../../Tooltip/Tooltip";
10
+ type TimeLike = ProcessSankeyTimeLike;
11
+ export interface ProcessSankeyTick {
12
+ date: TimeLike;
13
+ label: string;
14
+ }
15
+ export interface ProcessSankeyProps<TNode extends Datum = Datum, TEdge extends Datum = Datum> extends BaseChartProps {
16
+ nodes?: TNode[];
17
+ edges?: TEdge[];
18
+ /** [tStart, tEnd] of the chart's time axis. Required. */
19
+ domain: [TimeLike, TimeLike];
20
+ /** Optional axis ticks. Each tick: { date, label }. */
21
+ axisTicks?: ProcessSankeyTick[];
22
+ nodeIdAccessor?: ChartAccessor<TNode, string>;
23
+ nodeLabel?: ChartAccessor<TNode, string>;
24
+ sourceAccessor?: ChartAccessor<TEdge, string>;
25
+ targetAccessor?: ChartAccessor<TEdge, string>;
26
+ valueAccessor?: ChartAccessor<TEdge, number>;
27
+ startTimeAccessor?: ChartAccessor<TEdge, TimeLike>;
28
+ endTimeAccessor?: ChartAccessor<TEdge, TimeLike>;
29
+ /** Optional source-side inventory arrival time (before ribbon departs). */
30
+ systemInTimeAccessor?: ChartAccessor<TEdge, TimeLike>;
31
+ /** Optional target-side inventory departure time (after ribbon arrives). */
32
+ systemOutTimeAccessor?: ChartAccessor<TEdge, TimeLike>;
33
+ /**
34
+ * Accessor for a node's explicit lifetime extent — a `[start, end]`
35
+ * tuple of time-likes. Lane spans
36
+ * `min(xExtent[0], earliestEdge)` to `max(xExtent[1], latestEdge)`.
37
+ */
38
+ xExtentAccessor?: ChartAccessor<TNode, [TimeLike, TimeLike]>;
39
+ /** Optional node accessor that bonds equal, non-empty values into one
40
+ * contiguous stream-like lane block. Use `"category"` to bond an existing
41
+ * categorical field without coupling grouping to color. */
42
+ groupBy?: ChartAccessor<TNode, string | number>;
43
+ edgeIdAccessor?: ChartAccessor<TEdge, string>;
44
+ colorBy?: ChartAccessor<TNode, string>;
45
+ colorScheme?: string | string[] | Record<string, string>;
46
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
47
+ showLegend?: boolean;
48
+ /** Legend position. Default `"right"`. */
49
+ legendPosition?: "right" | "left" | "top" | "bottom";
50
+ /**
51
+ * Format function for time values — applied to axis tick labels and
52
+ * to time fields in the default tooltip. Same convention as
53
+ * `xFormat` on XY charts.
54
+ */
55
+ timeFormat?: (d: number | Date) => string | React.ReactNode;
56
+ /** Format function for the `value` field. Mirrors `yFormat` on XY charts. */
57
+ valueFormat?: (d: number) => string | React.ReactNode;
58
+ /** Direction of time. Horizontal (default) reads left-to-right;
59
+ * vertical reads top-to-bottom while lanes occupy the x-axis. */
60
+ orientation?: ProcessSankeyOrientation;
61
+ pairing?: "value" | "temporal";
62
+ packing?: "off" | "reuse";
63
+ laneOrder?: "insertion" | "crossing-min" | "inside-out" | "crossing-min+inside-out";
64
+ /** Maximum pixels per value unit. Set this to keep sparse lanes from
65
+ * inflating until they fill the plot. Unset preserves legacy scaling. */
66
+ maxValueScale?: number;
67
+ /** Vertical coordinate assignment. `"hug"` uses any scale-cap slack to
68
+ * pull connected lane attachments together while preserving order/gaps. */
69
+ lanePlacement?: "stack" | "hug";
70
+ /** How explicit node `xExtent`s size visible bands. `"max"` holds a
71
+ * node's largest instantaneous mass across its extent, for staged Sankeys. */
72
+ nodeSizing?: "temporal" | "max";
73
+ /** Pixel gutter inside a bonded node group. Defaults to `0`, so adjacent
74
+ * band silhouettes touch without overlapping. */
75
+ groupPadding?: number;
76
+ ribbonLane?: "source" | "target" | "both";
77
+ /**
78
+ * Minimum rendered run along the time axis for **source-only feeder**
79
+ * ribbons (not a general minimum ribbon length). A number is a pixel
80
+ * minimum; `"auto"` adapts to lateral lane distance. Only source-only
81
+ * feeders with proven xExtent/systemInTime runway are affected.
82
+ * Authored event times and mass accounting remain unchanged.
83
+ * Default `0` preserves exact temporal endpoints.
84
+ */
85
+ ribbonMinRun?: number | "auto";
86
+ lifetimeMode?: "full" | "half";
87
+ showLaneRails?: boolean;
88
+ showQualityReadout?: boolean;
89
+ /** Render the per-band node id label at the band's opening edge.
90
+ * Default `true`. Set `false` for dense layouts, or `"auto"` for a
91
+ * density-budgeted subset shared by CSR/SSR. */
92
+ showLabels?: boolean | "auto";
93
+ /**
94
+ * Author priority for `showLabels="auto"`. Higher values survive density
95
+ * shedding first. Field name or function over the raw node datum.
96
+ * Shed labels reappear under selection without a layout recompute.
97
+ */
98
+ labelPriorityAccessor?: string | ((d: TNode) => number);
99
+ /** Optional hard cap on visible auto labels (after the area budget). */
100
+ maxLabels?: number;
101
+ /**
102
+ * Which datum shape selection / linkedHover predicates receive.
103
+ * `"raw"` (default) unwraps author records from the scene payload so field
104
+ * matchers work without knowing ProcessSankey's `{ __kind, data, id }` shape.
105
+ * `"scene"` keeps the full payload for tooling that needs `__kind`.
106
+ */
107
+ selectionDatum?: "raw" | "scene";
108
+ /** A shared opacity, or a per-edge opacity resolver for confidence-aware flows. */
109
+ edgeOpacity?: number | ((edge: TEdge) => number);
110
+ /** Declarative threshold-aware styling for node bands (raw node datum). */
111
+ styleRules?: StyleRule[];
112
+ /** Layout execution: auto (cost threshold), worker, or sync. SSR always sync. */
113
+ layoutExecution?: ProcessSankeyLayoutExecution;
114
+ /** Override auto worker cost threshold (see estimateProcessSankeyLayoutCost). */
115
+ layoutWorkerThreshold?: number;
116
+ /** Content while worker layout is pending. `false` suppresses. */
117
+ layoutLoadingContent?: React.ReactNode | false;
118
+ /** Called when worker/async layout changes state. */
119
+ onLayoutStateChange?: (state: "pending" | "ready" | "error") => void;
120
+ /** Tooltip content. `false` disables, `true` uses the default,
121
+ * or pass a `Tooltip(...)` / custom function for full control. */
122
+ tooltip?: TooltipProp;
123
+ enableHover?: boolean;
124
+ onClick?: (datum: Datum, position?: {
125
+ x: number;
126
+ y: number;
127
+ }) => void;
128
+ selection?: SelectionConfig;
129
+ linkedHover?: LinkedHoverProp;
130
+ showParticles?: boolean;
131
+ /** Style config for the particle overlay — same shape
132
+ * StreamNetworkFrame consumes from SankeyDiagram. Defaults
133
+ * (radius 3, opacity 0.7, spawnRate 0.1, maxPerEdge 50) live in
134
+ * `DEFAULT_PARTICLE_STYLE`. */
135
+ particleStyle?: ParticleStyle;
136
+ /** Pass-through to the underlying StreamNetworkFrame. */
137
+ frameProps?: Partial<Omit<StreamNetworkFrameProps, "nodes" | "edges" | "chartType" | "size" | "customNetworkLayout" | "layoutConfig">>;
138
+ }
139
+ export {};
@@ -1,4 +1,5 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
+ import type { NetworkMarkStyle } from "../../stream/networkTypes";
2
3
  import * as React from "react";
3
4
  import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
4
5
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
@@ -27,7 +28,7 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
27
28
  * custom borders, or per-depth opacity without re-implementing color
28
29
  * encoding.
29
30
  */
30
- nodeStyle?: (d: Datum) => Datum;
31
+ nodeStyle?: (d: Datum) => NetworkMarkStyle;
31
32
  enableHover?: boolean;
32
33
  legendInteraction?: LegendInteractionMode;
33
34
  tooltip?: TooltipProp;
@@ -0,0 +1,23 @@
1
+ import type { ProcessSankeyEdge, ProcessSankeyNode, ProcessSankeySlot } from "./algorithm";
2
+ export interface BoundaryHubMetrics {
3
+ crossings: number;
4
+ cost: number;
5
+ }
6
+ export declare function acceptsBoundaryHubCandidate<T extends BoundaryHubMetrics>(candidate: Pick<T, "crossings" | "cost">, current: Pick<T, "crossings" | "cost">, centeringAllowance?: number): boolean;
7
+ interface CenterBoundaryHubsOptions<T extends BoundaryHubMetrics> {
8
+ order: ProcessSankeySlot[];
9
+ after: T;
10
+ nodes: readonly ProcessSankeyNode[];
11
+ edges: readonly ProcessSankeyEdge[];
12
+ outgoingPartners: ReadonlyMap<string, ReadonlySet<string>>;
13
+ incomingPartners: ReadonlyMap<string, ReadonlySet<string>>;
14
+ slotForNode: ReadonlyMap<string, ProcessSankeySlot>;
15
+ averageGap: number;
16
+ evaluate: (order: readonly ProcessSankeySlot[]) => T;
17
+ }
18
+ /** Center boundary fan hubs while bounding the cost of the topology correction. */
19
+ export declare function centerBoundaryHubs<T extends BoundaryHubMetrics>({ order, after, nodes, edges, outgoingPartners, incomingPartners, slotForNode, averageGap, evaluate, }: CenterBoundaryHubsOptions<T>): {
20
+ order: ProcessSankeySlot[];
21
+ after: T;
22
+ };
23
+ export {};
@@ -1,6 +1,8 @@
1
1
  import type { ProcessSankeyEdge, ProcessSankeyLaneLifetime, ProcessSankeyLayoutQuality, ProcessSankeyNode, ProcessSankeyNodeData, ProcessSankeyRibbonLane, ProcessSankeySlot } from "./algorithm";
2
2
  export type { ProcessSankeyRibbonLane };
3
3
  export type SlotByNode = Record<string, number>;
4
+ /** Dictionary for authored identifiers, including JavaScript prototype keys. */
5
+ export declare function createProcessSankeyRecord<T>(): Record<string, T>;
4
6
  export interface SlotGeometryOptions {
5
7
  plotH: number;
6
8
  padding: number;
@@ -1,47 +1,9 @@
1
1
  import type { ProcessSankeyEdge, ProcessSankeyLaneLifetime, ProcessSankeyNode, ProcessSankeyNodeData, ProcessSankeySlot } from "./algorithm";
2
- import { type ProcessSankeyRibbonLane, type SlotByNode } from "./layoutGeometry";
2
+ import { type SlotByNode } from "./layoutGeometry";
3
3
  import { bondProcessSankeySlotGroups } from "./orderingBond";
4
+ import type { ProcessSankeyOrderingOptions, ProcessSankeyOrderingResult } from "./orderingTypes";
5
+ export type { ProcessSankeyOrderMetrics, ProcessSankeyOrderingOptions, ProcessSankeyOrderingResult, } from "./orderingTypes";
4
6
  export { bondProcessSankeySlotGroups };
5
- export interface ProcessSankeyOrderMetrics {
6
- crossings: number;
7
- weightedLength: number;
8
- pixelLength: number;
9
- transitOcclusion: number;
10
- cost: number;
11
- }
12
- export interface ProcessSankeyOrderingResult {
13
- before: ProcessSankeyOrderMetrics;
14
- after: ProcessSankeyOrderMetrics;
15
- /** Stable slot ids before optimization, used by quality baselines. */
16
- initialOrder: string[];
17
- /** Candidate counts make the performance budget testable without timers. */
18
- evaluations: {
19
- fullCrossing: number;
20
- localCrossing: number;
21
- };
22
- }
23
- export interface ProcessSankeyOrderingOptions {
24
- plotH: number;
25
- padding: number;
26
- valueScale: number;
27
- groupPadding?: number;
28
- laneOrder?: "insertion" | "crossing-min" | "inside-out" | "crossing-min+inside-out";
29
- ribbonLane?: ProcessSankeyRibbonLane;
30
- domain?: [number, number];
31
- /**
32
- * Placement used when scoring pixel/transit cost. Must match the final
33
- * layout's `lanePlacement` so a hug + maxValueScale pass can refine order
34
- * against rendered geometry (M3), not only the dry stack scale=1 proxy.
35
- */
36
- lanePlacement?: "stack" | "hug";
37
- /**
38
- * `"full"` runs barycenter + exact search + geometry refine.
39
- * `"geometry-refine"` only runs the bounded exact-transit adjacent-swap
40
- * (and unit-aware transpose when multi-slot bonds exist) — used after the
41
- * final valueScale / hug geometry is known.
42
- */
43
- mode?: "full" | "geometry-refine";
44
- }
45
7
  export declare function countCrossings(slotByNode: SlotByNode, edges: readonly ProcessSankeyEdge[]): number;
46
8
  export declare function totalEdgeLength(slotByNode: SlotByNode, edges: readonly ProcessSankeyEdge[]): number;
47
9
  /**
@@ -0,0 +1,32 @@
1
+ import type { ProcessSankeyRibbonLane } from "./layoutGeometry";
2
+ export interface ProcessSankeyOrderMetrics {
3
+ crossings: number;
4
+ weightedLength: number;
5
+ pixelLength: number;
6
+ transitOcclusion: number;
7
+ cost: number;
8
+ }
9
+ export interface ProcessSankeyOrderingResult {
10
+ before: ProcessSankeyOrderMetrics;
11
+ after: ProcessSankeyOrderMetrics;
12
+ /** Stable slot ids before optimization, used by quality baselines. */
13
+ initialOrder: string[];
14
+ /** Candidate counts make the performance budget testable without timers. */
15
+ evaluations: {
16
+ fullCrossing: number;
17
+ localCrossing: number;
18
+ };
19
+ }
20
+ export interface ProcessSankeyOrderingOptions {
21
+ plotH: number;
22
+ padding: number;
23
+ valueScale: number;
24
+ groupPadding?: number;
25
+ laneOrder?: "insertion" | "crossing-min" | "inside-out" | "crossing-min+inside-out";
26
+ ribbonLane?: ProcessSankeyRibbonLane;
27
+ domain?: [number, number];
28
+ /** Placement used when scoring pixel/transit cost. */
29
+ lanePlacement?: "stack" | "hug";
30
+ /** Full search or the bounded final-scale geometry refinement. */
31
+ mode?: "full" | "geometry-refine";
32
+ }
@@ -1,7 +1,7 @@
1
1
  import type { ProcessSankeyEdge, ProcessSankeyLaneLifetime, ProcessSankeyNode, ProcessSankeyNodeData, ProcessSankeySlot } from "./algorithm";
2
2
  import { type SlotByNode } from "./layoutGeometry";
3
3
  import { clearProcessSankeyPackingCache, processSankeyPackingSignature, rehydrateProcessSankeySlots } from "./packingCache";
4
- export { clearProcessSankeyPackingCache, processSankeyPackingSignature, rehydrateProcessSankeySlots, };
4
+ export { clearProcessSankeyPackingCache, processSankeyPackingSignature, rehydrateProcessSankeySlots };
5
5
  export declare function packProcessSankeySlots(nodes: readonly ProcessSankeyNode[], edges: readonly ProcessSankeyEdge[], nodeData: Readonly<Record<string, ProcessSankeyNodeData>>, laneLifetime: Readonly<Record<string, ProcessSankeyLaneLifetime>>): {
6
6
  slots: ProcessSankeySlot[];
7
7
  slotByNode: SlotByNode;
@@ -1,5 +1,5 @@
1
1
  import type { ProcessSankeyEdge, ProcessSankeyLaneLifetime, ProcessSankeyNode, ProcessSankeyNodeData, ProcessSankeySlot } from "./algorithm";
2
- import type { SlotByNode } from "./layoutGeometry";
2
+ import { type SlotByNode } from "./layoutGeometry";
3
3
  /**
4
4
  * Reapply a frozen packing assignment under updated mass/lifetime data.
5
5
  * Occupant membership and row identity stay fixed; peaks and end times refresh.
@@ -0,0 +1,72 @@
1
+ import type { ProcessSankeyEdge, ProcessSankeyLaneLifetime, ProcessSankeyNode } from "./algorithm";
2
+ type PackingWindow = ProcessSankeyLaneLifetime;
3
+ interface PackingConflicts {
4
+ conflicts: (a: string, b: string) => boolean;
5
+ }
6
+ /**
7
+ * Exclusive packing role for *terminal* handoffs only:
8
+ * - pure source-only feeders (no incoming, one outgoing sink), or
9
+ * - temporary branches whose only overall neighbor is one partner
10
+ * (leave/return to a single core).
11
+ *
12
+ * Intermediate chain stages (in from A, out to B) are intentionally excluded —
13
+ * they must stay free to share rows for continuity packing (Launch→Orbit→…).
14
+ * Mixing two different terminal roles on one row is what forces later ordering
15
+ * to drag one exclusive handoff across the other's partner.
16
+ */
17
+ declare function exclusivePartnerWeights(edges: readonly ProcessSankeyEdge[]): Map<string, {
18
+ partner: string;
19
+ weight: number;
20
+ }>;
21
+ /**
22
+ * Active bands are the primary row reservation, but they are not the whole
23
+ * visual footprint: the incident ribbons occupy the broader rail lifetime.
24
+ * When two alternate phases share the same predecessor and successor and
25
+ * their rails overlap at a very close handoff, putting them on the same row
26
+ * makes their transition bundles collide. Mark that small semantic family
27
+ * for a local spill row instead of silently placing one member in an unrelated row.
28
+ *
29
+ * Direct sequential handoffs remain reusable even when their rails overlap;
30
+ * those are precisely the straight-through Launch -> Orbit cases packing is
31
+ * intended to reveal.
32
+ */
33
+ declare function buildPackingConflicts(ids: readonly string[], windows: Readonly<Record<string, PackingWindow>>, railLifetime: Readonly<Record<string, ProcessSankeyLaneLifetime>>, edges: readonly ProcessSankeyEdge[], groupById: ReadonlyMap<string, string | undefined>, exclusive: ReadonlyMap<string, {
34
+ partner: string;
35
+ weight: number;
36
+ }>): PackingConflicts;
37
+ declare function chronologicalIds(nodes: readonly ProcessSankeyNode[], windows: Readonly<Record<string, PackingWindow>>): string[];
38
+ /** Chronological greedy coloring, used as both a bound and large-chart path. */
39
+ declare function chronologicalColoring(ids: readonly string[], packingConflicts: PackingConflicts, exclusive?: ReadonlyMap<string, {
40
+ partner: string;
41
+ weight: number;
42
+ }>): {
43
+ assignment: number[];
44
+ slotCount: number;
45
+ };
46
+ /**
47
+ * Exact coloring becomes combinatorial, but large stage-based rivers still
48
+ * need continuity-aware row reuse. Improve the minimum-row greedy coloring
49
+ * with bounded legal moves and pair swaps. Direct handoffs are the primary
50
+ * objective; at equal handoff continuity, a secondary source-role objective
51
+ * keeps temporally reused feeder rows coherent by destination. Swapping two
52
+ * simultaneous nodes often lets both reclaim their strongest predecessor rows
53
+ * (for example Western-zone Bremen and Soviet-zone GDR) without weakening
54
+ * packing.
55
+ */
56
+ declare function improveLargeContinuityColoring(ids: readonly string[], packingConflicts: PackingConflicts, edges: readonly ProcessSankeyEdge[], baseline: {
57
+ assignment: number[];
58
+ slotCount: number;
59
+ }): number[];
60
+ /**
61
+ * Small ProcessSankeys can afford to examine every coloring up to the
62
+ * chronological greedy bound. Among them, maximize the edge value whose
63
+ * endpoints share a row:
64
+ * the objective makes heavy sequential bundles straight without inventing a
65
+ * topology-specific stage order. A hard evaluation budget retains predictable
66
+ * behavior for adversarial interval sets.
67
+ */
68
+ declare function continuityColoring(ids: readonly string[], packingConflicts: PackingConflicts, edges: readonly ProcessSankeyEdge[], baseline: {
69
+ assignment: number[];
70
+ slotCount: number;
71
+ }): number[];
72
+ export { buildPackingConflicts, chronologicalColoring, chronologicalIds, continuityColoring, exclusivePartnerWeights, improveLargeContinuityColoring };
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
3
+ import type { BarCornerRadius, StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
4
  import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -62,8 +62,9 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
62
62
  * the category list on the axis. */
63
63
  sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
64
64
  barPadding?: number;
65
- /** Rounded top corner radius in pixels. Only the end away from the baseline is rounded. */
66
- roundedTop?: number;
65
+ /** Rounded top corner radius in pixels, or a function of the rendered bar
66
+ * width. Only the end away from the baseline is rounded. */
67
+ roundedTop?: BarCornerRadius;
67
68
  /**
68
69
  * Gradient fill from the bar's tip (offset 0) toward its base (offset 1).
69
70
  * Stops can set `color`, `opacity`, or both. Omit a stop color to inherit
@@ -32,6 +32,8 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
32
32
  connectorOpacity?: number;
33
33
  /** Show step name + value labels on bars (default true) */
34
34
  showLabels?: boolean;
35
+ /** Show axes and category ticks for vertical funnels (default true). */
36
+ showAxes?: boolean;
35
37
  enableHover?: boolean;
36
38
  showLegend?: boolean;
37
39
  legendInteraction?: LegendInteractionMode;
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
3
+ import type { BarCornerRadius, StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
4
  import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -22,7 +22,8 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
22
22
  sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
23
23
  barPadding?: number;
24
24
  /** Rounded corner radius on bar ends (away from baseline). */
25
- roundedTop?: number;
25
+ /** Rounded top corner radius, or a function of the rendered bar width. */
26
+ roundedTop?: BarCornerRadius;
26
27
  /** Tip-to-base bar gradient using `{ stops: [{ offset, color?, opacity? }] }`. */
27
28
  gradientFill?: GradientInput;
28
29
  /**
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
3
+ import type { BarCornerRadius, StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
4
  import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -22,8 +22,9 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
22
22
  /** Category sort order. Default: `false` (data insertion order). `"asc"`/`"desc"` sorts by total stacked value. `"auto"` preserves insertion order while streaming and falls through to value-desc on static data. Custom comparators receive category keys. */
23
23
  sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
24
24
  barPadding?: number;
25
- /** Rounded top corner radius. Only the topmost stacked segment gets rounded. */
26
- roundedTop?: number;
25
+ /** Rounded top corner radius, or a function of the rendered bar width. Only
26
+ * the topmost stacked segment gets rounded. */
27
+ roundedTop?: BarCornerRadius;
27
28
  /** Tip-to-base segment gradient using `{ stops: [{ offset, color?, opacity? }] }`. */
28
29
  gradientFill?: GradientInput;
29
30
  /**
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
3
+ import type { BarCornerRadius, StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
4
  import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -77,7 +77,7 @@ export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseCh
77
77
  * lane. Both ends round: left+right in horizontal orientation, top+bottom
78
78
  * in vertical. Middle segments of multi-segment lanes stay square so
79
79
  * pieces visually butt against each other. */
80
- roundedTop?: number;
80
+ roundedTop?: BarCornerRadius;
81
81
  /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
82
82
  valueExtent?: [number | undefined, number | undefined] | [number];
83
83
  /** Pass-through props to StreamOrdinalFrame */
@@ -5,15 +5,8 @@ import type { StyleRule } from "../shared/styleRules";
5
5
  import { type PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
7
7
  import type { ChartMode } from "../shared/types";
8
- export interface GaltonBoardReferenceLine {
9
- value: number;
10
- label?: React.ReactNode;
11
- color?: string;
12
- className?: string;
13
- strokeDasharray?: string;
14
- strokeWidth?: number;
15
- labelPosition?: "top" | "bottom";
16
- }
8
+ import { type GaltonBoardReferenceLine } from "./physicsProjectionOverlays";
9
+ export type { GaltonBoardReferenceLine } from "./physicsProjectionOverlays";
17
10
  export interface GaltonBoardChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "mode" | "selection">, PhysicsSharedChartProps {
18
11
  data?: TDatum[];
19
12
  size?: [number, number];
@@ -2,61 +2,30 @@ import * as React from "react";
2
2
  import type { PhysicsFrameHandle } from "./physicsHocHandle";
3
3
  import type { Datum } from "../shared/datumTypes";
4
4
  import type { GauntletChartProps } from "./gauntletChartProps";
5
- export { GAUNTLET_WALL, clampGauntletPoint, buildGauntletPhysics } from "./gauntletPhysics";
6
- export { applyGauntletEffect, planGauntletPropertyWork, replaceGauntletNegative } from "./gauntletEffects";
7
- export type { GauntletAccessors, GauntletCoreBodyFn, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectPlacementFn, GauntletProjectState, GauntletPropertyDefinition, GauntletPropertyForceContext, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions, GauntletNegativeReplacementOptions, GauntletViabilityFn } from "./gauntletPhysics";
8
- export type { GauntletChartProps };
5
+ export * from "./gauntletPublic";
9
6
  /**
10
7
  * Physics-backed gauntlet: project core + property satellites through timed or
11
8
  * capacity-gated process events.
12
9
  *
13
10
  * @example
14
11
  * ```tsx
15
- * <GauntletChart
16
- * data={[{ id: "plan-a", positives: ["homes"], negatives: ["cost"] }]}
12
+ * <GauntletChart data={[{ id: "plan-a", positives: ["homes"], negatives: ["cost"] }]}
17
13
  * positiveProperties={[{ id: "homes", label: "Homes", radius: 10 }]}
18
14
  * negativeProperties={[{ id: "cost", label: "Cost", load: 1.2, radius: 8 }]}
19
- * size={[720, 380]}
20
- * />
15
+ * size={[720, 380]} />
21
16
  * ```
22
17
  *
23
18
  * @example
24
- * Multiple attached properties routed through timed gates, with the
25
- * settled viability/outcome projection strip enabled:
26
19
  * ```tsx
27
- * <GauntletChart
28
- * data={[{ id: "plan-a", positives: ["homes", "jobs"], negatives: ["cost"] }]}
29
- * positiveProperties={[
30
- * { id: "homes", label: "Homes", radius: 10 },
31
- * { id: "jobs", label: "Jobs", radius: 10 },
32
- * ]}
33
- * negativeProperties={[{ id: "cost", label: "Cost", load: 1.2, radius: 8 }]}
34
- * gates={[
35
- * { id: "review", label: "Review" },
36
- * { id: "budget", label: "Budget" },
37
- * ]}
38
- * showProjection
39
- * size={[720, 380]}
40
- * />
20
+ * <GauntletChart data={[{ id: "alpha", start: 0, work: 3 }, { id: "beta", start: 1.5, work: 1, risks: ["risk"] }]}
21
+ * startTimeAccessor="start" negativeAccessor="risks"
22
+ * negativeProperties={[{ id: "risk", label: "Review risk", load: 1.4 }]}
23
+ * gates={[{ id: "review", time: 2, capacity: { unitsPerSecond: 2, unitAccessor: "work" } }]}
24
+ * events={[{ id: "done", gateId: "review", time: 2, effects: [{ popNegative: ["risk"] }] }]}
25
+ * showProjection />
41
26
  * ```
42
27
  *
43
- * @example
44
- * Stagger negative-only compound entities on project-local clocks and share a
45
- * finite service across their root bodies:
46
- * ```tsx
47
- * <GauntletChart
48
- * data={pullRequests}
49
- * startTimeAccessor="arrival"
50
- * negativeAccessor="risks"
51
- * negativeProperties={riskProperties}
52
- * gates={[{
53
- * id: "review",
54
- * capacity: { unitsPerSecond: 5, unitAccessor: "reviewWork" }
55
- * }]}
56
- * events={reviewEvents}
57
- * onCapacityChange={setCapacity}
58
- * />
59
- * ```
28
+ * Compose timed gates, capacity controls, staggered starts, and projections through the corresponding props.
60
29
  */
61
30
  export declare const GauntletChart: {
62
31
  <TDatum extends Datum = Datum>(props: GauntletChartProps<TDatum> & React.RefAttributes<PhysicsFrameHandle>): React.ReactElement | null;
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  import { type StreamPhysicsFrameProps } from "../../stream/physics/StreamPhysicsFrame";
3
3
  import { type CapacityQueueSnapshot } from "../../stream/physics/PhysicsControllers";
4
- import { type ProcessChromeOptions } from "../../recipes/processChrome";
4
+ import type { ProcessChromeOptions } from "../../recipes/processChrome";
5
5
  import type { Datum } from "../shared/datumTypes";
6
6
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
7
7
  import { type ProcessFlowProjectionMetadata, type ProcessFlowStageDef } from "./physicsChartUtils";
@@ -0,0 +1,9 @@
1
+ import * as React from "react";
2
+ import type { Datum } from "../shared/datumTypes";
3
+ import { type DependencyMachine } from "./dependencyMachine";
4
+ import type { RuntimeState } from "./chainReactionRuntime";
5
+ export declare function ChainReactionAccessibleTable<TDatum extends Datum>({ blockerSummary, machine, runtime }: {
6
+ blockerSummary: string;
7
+ machine: DependencyMachine<TDatum>;
8
+ runtime: RuntimeState;
9
+ }): React.JSX.Element;
@@ -20,6 +20,7 @@ interface DependencyBallDatum {
20
20
  sourceID: string;
21
21
  targetID: string;
22
22
  route: DependencyPoint[];
23
+ sourceDatum?: Datum;
23
24
  }
24
25
  export declare const EMPTY_SPAWNS: PhysicsQueuedSpawn[];
25
26
  export declare function numericTime(value: number | Date | undefined, fallback?: number): number;
@@ -32,6 +33,6 @@ export declare function dependencyBodyForce(context: StreamPhysicsBodyForceConte
32
33
  x: number;
33
34
  y: number;
34
35
  } | null;
35
- export declare function ballSpawn(edge: DependencyMachineEdge, route: DependencyTrackRoute): PhysicsQueuedSpawn;
36
+ export declare function ballSpawn(edge: DependencyMachineEdge, route: DependencyTrackRoute, sourceDatum?: Datum): PhysicsQueuedSpawn;
36
37
  export declare function machineSemanticItems<TDatum extends Datum>(machine: DependencyMachine<TDatum>, layout: DependencyTrackLayout, runtime: RuntimeState): PhysicsSemanticItem[];
37
38
  export {};
@@ -1,4 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
+ import type { TooltipProp } from "../../Tooltip/Tooltip";
3
+ import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
2
4
  import type { BlockerAmplification, DependencyAccessor, DependencyTaskStatus } from "./dependencyMachine";
3
5
  export type ChainReactionMode = "snapshot" | "replay" | "mechanical";
4
6
  export type ChainReactionInsight = "none" | "blocker-amplification";
@@ -89,9 +91,12 @@ export interface ChainReactionChartProps<TDatum extends Datum = Datum> {
89
91
  height?: number;
90
92
  responsiveWidth?: boolean;
91
93
  responsiveHeight?: boolean;
94
+ maxDevicePixelRatio?: number;
92
95
  title?: string;
93
96
  description?: string;
94
97
  className?: string;
95
- accessibleTable?: boolean;
98
+ accessibleTable?: AccessibleTableProp;
96
99
  enableHover?: boolean;
100
+ /** Standard single-datum tooltip configuration for dependency balls. */
101
+ tooltip?: TooltipProp;
97
102
  }
@@ -1,7 +1,7 @@
1
1
  import * as React from "react";
2
2
  import type { Style } from "../../stream/types";
3
3
  import type { PhysicsBodyState } from "../../stream/physics/PhysicsKernel";
4
- import type { PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsFrame";
4
+ import type { PhysicsCanvasPaintContext, PhysicsSemanticItem } from "../../stream/physics/StreamPhysicsFrame";
5
5
  import type { Datum } from "../shared/datumTypes";
6
6
  import type { CrucibleComponentState, CrucibleProductState, CrucibleRunState } from "./crucibleTypes";
7
7
  export declare function displayNumber(value: number): string;
@@ -10,7 +10,7 @@ export declare function productDescription(product: CrucibleProductState): strin
10
10
  /** Default accessible description for each live crucible body. */
11
11
  export declare function crucibleBodySemanticItem<TDatum extends Datum>(body: PhysicsBodyState, state: CrucibleRunState<TDatum>): false | Partial<PhysicsSemanticItem>;
12
12
  /** Canvas mark used when callers do not supply frameProps.renderBody. */
13
- export declare function drawCrucibleBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style): void;
13
+ export declare function drawCrucibleBody(ctx: CanvasRenderingContext2D, body: PhysicsBodyState, style: Style, paintContext?: PhysicsCanvasPaintContext): void;
14
14
  /**
15
15
  * SSR sibling of `drawCrucibleBody` — the same shadowed hexagon + inner ring
16
16
  * for settled products, and highlight dot for source components, as an SVG
@@ -0,0 +1,6 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { CrucibleHistoryItem, CrucibleMetricMap, CrucibleRunState } from "./crucibleTypes";
3
+ export declare function cloneCrucibleMetrics(metrics: CrucibleMetricMap): CrucibleMetricMap;
4
+ export declare function cloneCrucibleHistory(history: readonly CrucibleHistoryItem[]): CrucibleHistoryItem[];
5
+ /** Clone mutable run structures while intentionally retaining source datum references. */
6
+ export declare function cloneCrucibleState<TDatum extends Datum>(state: CrucibleRunState<TDatum>): CrucibleRunState<TDatum>;