semiotic 3.9.1 → 3.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (328) hide show
  1. package/README.md +102 -48
  2. package/agent-skill/semiotic-charts/SKILL.md +14 -10
  3. package/ai/componentMetadata.cjs +13 -3
  4. package/ai/dist/mcp-server.js +140 -36407
  5. package/ai/examples.md +109 -6
  6. package/ai/reference.md +55 -18
  7. package/ai/schema.json +5964 -1190
  8. package/ai/surface-manifest.json +51 -7
  9. package/ai/system-prompt.md +16 -3
  10. package/dist/c-3SCUN5HI.min.js +1 -0
  11. package/dist/c-3VVKFA4M.min.js +1 -0
  12. package/dist/c-43TJZS3F.min.js +1 -0
  13. package/dist/c-4DTZPSUD.min.js +1 -0
  14. package/dist/c-4ES5367Y.min.js +1 -0
  15. package/dist/c-54IRWOGM.min.js +1 -0
  16. package/dist/c-5D2S4RMI.min.js +1 -0
  17. package/dist/c-5JWCTX3G.min.js +1 -0
  18. package/dist/c-6CMMSN6N.min.js +1 -0
  19. package/dist/c-6HRB2L7H.min.js +1 -0
  20. package/dist/c-7W4SV36A.min.js +1 -0
  21. package/dist/c-A4WRGZFX.min.js +1 -0
  22. package/dist/c-AG7WWVIH.min.js +1 -0
  23. package/dist/c-AH6J4MTN.min.js +1 -0
  24. package/dist/c-ALYR5LKK.min.js +1 -0
  25. package/dist/c-BYDPC44I.min.js +1 -0
  26. package/dist/c-CFFIU2MW.min.js +1 -0
  27. package/dist/c-CGNHBHCE.min.js +1 -0
  28. package/dist/c-CJYSXIFV.min.js +1 -0
  29. package/dist/c-CKLIFCGN.min.js +1 -0
  30. package/dist/c-CZF7MV67.min.js +1 -0
  31. package/dist/c-D53OKBSY.min.js +1 -0
  32. package/dist/c-DBQ2V7CH.min.js +1 -0
  33. package/dist/c-DPMVAUAW.min.js +1 -0
  34. package/dist/c-ECJCKLYY.min.js +1 -0
  35. package/dist/c-EGATGOWJ.min.js +1 -0
  36. package/dist/c-EGR6VYBW.min.js +1 -0
  37. package/dist/c-ENF72HU5.min.js +1 -0
  38. package/dist/c-ESNR43AN.min.js +1 -0
  39. package/dist/c-F3LIKINL.min.js +1 -0
  40. package/dist/c-F5ZB5GJ6.min.js +1 -0
  41. package/dist/c-G3VYMHKE.min.js +1 -0
  42. package/dist/c-GR6MOEQC.min.js +1 -0
  43. package/dist/c-GSVCN34B.min.js +1 -0
  44. package/dist/c-GYOQCEFP.min.js +1 -0
  45. package/dist/c-H3DNMTCC.min.js +1 -0
  46. package/dist/c-I6J3FEZE.min.js +1 -0
  47. package/dist/c-IGH6MGJ5.min.js +1 -0
  48. package/dist/c-II2EEAJN.min.js +1 -0
  49. package/dist/c-J6M4JHRS.min.js +1 -0
  50. package/dist/c-JM3MGLQV.min.js +1 -0
  51. package/dist/c-KM3N7F7R.min.js +1 -0
  52. package/dist/c-LF5BZFNC.min.js +1 -0
  53. package/dist/c-LKBSGFQC.min.js +1 -0
  54. package/dist/c-NDJADPIF.min.js +1 -0
  55. package/dist/c-NVPQCIL5.min.js +1 -0
  56. package/dist/c-OFWJBEE5.min.js +1 -0
  57. package/dist/c-OYFHP5F5.min.js +1 -0
  58. package/dist/c-PGKQGGQ2.min.js +1 -0
  59. package/dist/c-Q2IPZ3MU.min.js +1 -0
  60. package/dist/c-QKHMBE2E.min.js +1 -0
  61. package/dist/c-QMVM3AY6.min.js +1 -0
  62. package/dist/c-QSGWX53A.min.js +1 -0
  63. package/dist/c-RJKEKZOO.min.js +1 -0
  64. package/dist/c-SFDIIU5G.min.js +1 -0
  65. package/dist/c-SRTBCRVE.min.js +1 -0
  66. package/dist/c-T6UAIKBH.min.js +1 -0
  67. package/dist/c-TMCTEVVW.min.js +1 -0
  68. package/dist/c-TMOSJLT3.min.js +1 -0
  69. package/dist/c-U6ESPM7V.min.js +1 -0
  70. package/dist/c-UC5PTTFI.min.js +1 -0
  71. package/dist/c-VGKUEZBC.min.js +1 -0
  72. package/dist/c-VN2HG5BS.min.js +1 -0
  73. package/dist/{c-J5G56TUH.min.js → c-VPZDY5Q4.min.js} +1 -1
  74. package/dist/c-VRXUB2F2.min.js +1 -0
  75. package/dist/c-VUBQNQJH.min.js +1 -0
  76. package/dist/c-VUH4PGZY.min.js +1 -0
  77. package/dist/c-XDRV7RKW.min.js +1 -0
  78. package/dist/c-YGZHURXZ.min.js +1 -0
  79. package/dist/components/Annotation.d.ts +1 -1
  80. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  81. package/dist/components/access/chartAccessContract.d.ts +90 -0
  82. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  83. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  84. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  85. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  86. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  87. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  88. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  89. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  90. package/dist/components/ai/chartRecipeRegistry.d.ts +2 -1
  91. package/dist/components/ai/chartRecipes.d.ts +6 -0
  92. package/dist/components/ai/colorEvidence.d.ts +12 -0
  93. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  94. package/dist/components/ai/geoNavigation.d.ts +4 -0
  95. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  96. package/dist/components/ai/navigationTree.d.ts +7 -1
  97. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  98. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  99. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  100. package/dist/components/charts/index.d.ts +4 -0
  101. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  102. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  103. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  104. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  105. package/dist/components/charts/network/Treemap.d.ts +8 -1
  106. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  107. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  108. package/dist/components/charts/ordinal/DonutChart.d.ts +3 -0
  109. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  110. package/dist/components/charts/ordinal/FunnelChart.d.ts +3 -0
  111. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  112. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  113. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  114. package/dist/components/charts/ordinal/PieChart.d.ts +3 -0
  115. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  116. package/dist/components/charts/ordinal/RadarChart.d.ts +75 -0
  117. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  118. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  119. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  120. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  121. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  122. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  123. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  124. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  125. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +10 -1
  126. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +11 -1
  127. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +14 -5
  128. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +7 -1
  129. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
  130. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  131. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +4 -2
  132. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  133. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  134. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  135. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  136. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  137. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  138. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  139. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  140. package/dist/components/charts/shared/types.d.ts +4 -2
  141. package/dist/components/charts/shared/useChartLegend.d.ts +2 -1
  142. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  143. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  144. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  145. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  146. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  147. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  148. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  149. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  150. package/dist/components/charts/xy/WaterfallChart.d.ts +68 -0
  151. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +146 -0
  152. package/dist/components/evidence/evidenceGate.d.ts +28 -0
  153. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  154. package/dist/components/realtime/types.d.ts +16 -7
  155. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  156. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  157. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  158. package/dist/components/recipes/lineageDag.d.ts +17 -0
  159. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  160. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  161. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  162. package/dist/components/semiotic-access.d.ts +9 -0
  163. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  164. package/dist/components/semiotic-ai-core.d.ts +9 -0
  165. package/dist/components/semiotic-ai.d.ts +5 -17
  166. package/dist/components/semiotic-evidence.d.ts +10 -0
  167. package/dist/components/semiotic-line.d.ts +9 -0
  168. package/dist/components/semiotic-network.d.ts +3 -0
  169. package/dist/components/semiotic-ordinal.d.ts +2 -0
  170. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  171. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  172. package/dist/components/semiotic-themes-core.d.ts +3 -0
  173. package/dist/components/semiotic-utils-core.d.ts +5 -0
  174. package/dist/components/semiotic-xy.d.ts +3 -0
  175. package/dist/components/semiotic.d.ts +9 -3
  176. package/dist/components/server/renderDashboard.d.ts +37 -0
  177. package/dist/components/server/renderEvidence.d.ts +27 -0
  178. package/dist/components/server/renderToStaticSVG.d.ts +2 -30
  179. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  180. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  181. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  182. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  183. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  184. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  185. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  186. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  187. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  188. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  189. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  190. package/dist/components/store/selectionProvenance.d.ts +8 -0
  191. package/dist/components/store/themeCore.d.ts +5 -1
  192. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  193. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  194. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  195. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  196. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  197. package/dist/components/stream/PipelineStore.d.ts +1 -1
  198. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  199. package/dist/components/stream/canvasSetup.d.ts +8 -2
  200. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  201. package/dist/components/stream/geoTypes.d.ts +1 -1
  202. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  203. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  204. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  205. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  206. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  207. package/dist/components/stream/layouts/index.d.ts +6 -12
  208. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  209. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  210. package/dist/components/stream/layouts/registry.d.ts +12 -0
  211. package/dist/components/stream/marginalConfig.d.ts +3 -0
  212. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  213. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  214. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  215. package/dist/components/stream/networkTypes.d.ts +5 -1
  216. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  217. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +1 -1
  218. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  219. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  220. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  221. package/dist/components/stream/types.d.ts +8 -1
  222. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  223. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  224. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  225. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  226. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  227. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  228. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  229. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  230. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  231. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  232. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  233. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  234. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  235. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  236. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  237. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  238. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  239. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  240. package/dist/forceLayoutWorker.js +1 -1
  241. package/dist/geo.min.js +1 -1
  242. package/dist/geo.module.min.js +1 -1
  243. package/dist/network.module.min.js +1 -1
  244. package/dist/ordinal.module.min.js +1 -1
  245. package/dist/physics.module.min.js +1 -1
  246. package/dist/rough.module.min.js +1 -1
  247. package/dist/semiotic-access.d.ts +9 -0
  248. package/dist/semiotic-access.min.js +2 -0
  249. package/dist/semiotic-access.module.min.js +2 -0
  250. package/dist/semiotic-ai-core.d.ts +9 -0
  251. package/dist/semiotic-ai-core.min.js +1 -1
  252. package/dist/semiotic-ai-core.module.min.js +1 -1
  253. package/dist/semiotic-ai.d.ts +5 -17
  254. package/dist/semiotic-ai.module.min.js +1 -1
  255. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  256. package/dist/semiotic-client-shared.module.min.js +1 -1
  257. package/dist/semiotic-evidence.d.ts +10 -0
  258. package/dist/semiotic-evidence.min.js +1 -0
  259. package/dist/semiotic-evidence.module.min.js +1 -0
  260. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  261. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  262. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  263. package/dist/semiotic-experimental-vacp.min.js +1 -1
  264. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  265. package/dist/semiotic-line.d.ts +9 -0
  266. package/dist/semiotic-line.min.js +2 -0
  267. package/dist/semiotic-line.module.min.js +2 -0
  268. package/dist/semiotic-network.d.ts +3 -0
  269. package/dist/semiotic-ordinal.d.ts +2 -0
  270. package/dist/semiotic-realtime-core.d.ts +3 -2
  271. package/dist/semiotic-realtime-core.module.min.js +1 -1
  272. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  273. package/dist/semiotic-recipes-core.d.ts +6 -0
  274. package/dist/semiotic-recipes-core.module.min.js +1 -1
  275. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  276. package/dist/semiotic-server-edge.min.js +1 -1
  277. package/dist/semiotic-server-edge.module.min.js +1 -1
  278. package/dist/semiotic-server-node.min.js +1 -1
  279. package/dist/semiotic-server-node.module.min.js +1 -1
  280. package/dist/semiotic-themes-core.d.ts +3 -0
  281. package/dist/semiotic-themes-core.min.js +1 -1
  282. package/dist/semiotic-themes-core.module.min.js +1 -1
  283. package/dist/semiotic-themes.min.js +1 -1
  284. package/dist/semiotic-themes.module.min.js +1 -1
  285. package/dist/semiotic-utils-core.d.ts +5 -0
  286. package/dist/semiotic-utils-core.min.js +1 -1
  287. package/dist/semiotic-utils-core.module.min.js +1 -1
  288. package/dist/semiotic-xy.d.ts +3 -0
  289. package/dist/semiotic.d.ts +9 -3
  290. package/dist/semiotic.module.min.js +1 -1
  291. package/dist/server.min.js +1 -1
  292. package/dist/server.module.min.js +1 -1
  293. package/dist/xy.module.min.js +1 -1
  294. package/package.json +39 -60
  295. package/dist/c-3KZD6AXJ.min.js +0 -1
  296. package/dist/c-4TWEX5HG.min.js +0 -1
  297. package/dist/c-5YCIX3VZ.min.js +0 -1
  298. package/dist/c-6FEKTA3U.min.js +0 -1
  299. package/dist/c-74HEEZGK.min.js +0 -1
  300. package/dist/c-BWNB6USU.min.js +0 -1
  301. package/dist/c-C25ENHIK.min.js +0 -1
  302. package/dist/c-CDR5AO3R.min.js +0 -1
  303. package/dist/c-E3JFRRMI.min.js +0 -1
  304. package/dist/c-EBFPQHHO.min.js +0 -1
  305. package/dist/c-GIKRQI4X.min.js +0 -1
  306. package/dist/c-GPYOFETM.min.js +0 -1
  307. package/dist/c-IDUHYYSI.min.js +0 -1
  308. package/dist/c-JAZ73J32.min.js +0 -1
  309. package/dist/c-KG3NXHAL.min.js +0 -1
  310. package/dist/c-KII3PLZE.min.js +0 -1
  311. package/dist/c-LIXGXMNS.min.js +0 -1
  312. package/dist/c-LVEY6D6B.min.js +0 -1
  313. package/dist/c-M4Y3BHFR.min.js +0 -1
  314. package/dist/c-MAIICR2Z.min.js +0 -1
  315. package/dist/c-MG5DM6VE.min.js +0 -1
  316. package/dist/c-O6U6K4CW.min.js +0 -1
  317. package/dist/c-OQ7M4AGV.min.js +0 -1
  318. package/dist/c-OXYMVK7Q.min.js +0 -1
  319. package/dist/c-QHF5YON3.min.js +0 -1
  320. package/dist/c-RR3GO5SW.min.js +0 -1
  321. package/dist/c-S2BXNNJN.min.js +0 -1
  322. package/dist/c-SUILCHWU.min.js +0 -1
  323. package/dist/c-US5ZFT6E.min.js +0 -1
  324. package/dist/c-UUKVD4WB.min.js +0 -1
  325. package/dist/c-WJCD5EUY.min.js +0 -1
  326. package/dist/c-YDAY2WFR.min.js +0 -1
  327. package/dist/c-ZOWWU34K.min.js +0 -1
  328. /package/dist/{c-COHXCW3Q.min.js → c-YZVRZGX2.min.js} +0 -0
@@ -6,7 +6,7 @@ import type { ActiveTransition } from "./pipelineTransitionUtils";
6
6
  import type { Datum } from "../charts/shared/datumTypes";
7
7
  import type { GeoLayoutResult } from "./geoCustomLayout";
8
8
  import type { CustomLayoutSelection } from "./customLayoutSelection";
9
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
9
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
10
10
  import { GeoPipelineUpdateResults } from "./geoPipelineUpdateResults";
11
11
  import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
12
12
  export declare class GeoPipelineStore implements UpdateResultStore {
@@ -1,6 +1,8 @@
1
1
  import * as React from "react";
2
2
  import type { ScaleLinear } from "d3-scale";
3
- import type { MarginalConfig, MarginalType } from "./types";
3
+ import type { MarginalConfig } from "./types";
4
+ import { normalizeMarginalConfig } from "./marginalConfig";
5
+ export { normalizeMarginalConfig };
4
6
  export type MarginalOrient = "top" | "bottom" | "left" | "right";
5
7
  export interface MarginalGraphicsProps {
6
8
  orient: MarginalOrient;
@@ -14,6 +16,4 @@ export interface MarginalGraphicsProps {
14
16
  /** Chart width (top/bottom) or height (left/right) */
15
17
  length: number;
16
18
  }
17
- /** Resolve a string shorthand or full config into a MarginalConfig */
18
- export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
19
19
  export declare function MarginalGraphics({ orient, config: rawConfig, values, scale, size, length }: MarginalGraphicsProps): React.JSX.Element | null;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Lazy wrapper for MarginalGraphics.
3
+ *
4
+ * d3-array binning is unused on charts that never set `marginalGraphics`,
5
+ * so keep that graph off the default LineChart cold path. Charts that do
6
+ * request marginals (Scatterplot, BubbleChart) call
7
+ * {@link provideMarginalGraphics} with a value import so SSR and the
8
+ * hydration SVG pass can paint immediately.
9
+ */
10
+ import * as React from "react";
11
+ import type { Datum } from "../charts/shared/datumTypes";
12
+ import type { MarginalGraphicsProps } from "./MarginalGraphics";
13
+ import { normalizeMarginalConfig } from "./marginalConfig";
14
+ export { normalizeMarginalConfig };
15
+ type MarginalComponent = React.ComponentType<MarginalGraphicsProps>;
16
+ /** Eagerly install the painter. Call from HOCs that expose `marginalGraphics`. */
17
+ export declare function provideMarginalGraphics(Comp: MarginalComponent): void;
18
+ export declare function collectMarginalValues(data: readonly Datum[], xAccessor: unknown, yAccessor: unknown): {
19
+ xValues: number[];
20
+ yValues: number[];
21
+ };
22
+ export declare function MarginalGraphicsLazy(props: MarginalGraphicsProps): React.JSX.Element | null;
@@ -38,6 +38,8 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
38
38
  sceneNodes: NetworkSceneNode[];
39
39
  sceneEdges: NetworkSceneEdge[];
40
40
  labels: NetworkLabel[];
41
+ /** Backgrounds returned from customNetworkLayout (consumed by StreamNetworkFrame). */
42
+ customLayoutBackgrounds: import("react").ReactNode;
41
43
  /** Overlays returned from customNetworkLayout (consumed by StreamNetworkFrame). */
42
44
  customLayoutOverlays: import("react").ReactNode;
43
45
  /** Most recent custom layout result for host readback (`getCustomLayout()`).
@@ -22,7 +22,7 @@ import type { Changeset, PointSceneNode } from "./types";
22
22
  import type { ActiveTransition } from "./pipelineTransitionUtils";
23
23
  import type { OrdinalLayoutResult } from "./ordinalCustomLayout";
24
24
  import type { CustomLayoutSelection } from "./customLayoutSelection";
25
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
25
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
26
26
  import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
27
27
  import { OrdinalPipelineUpdateResults } from "./ordinalPipelineUpdateResults";
28
28
  export declare class OrdinalPipelineStore implements UpdateResultStore {
@@ -23,7 +23,7 @@ import { type ActiveTransition } from "./pipelineTransitionUtils";
23
23
  import type { ResolvedRibbon } from "./xySceneBuilders/ribbonScene";
24
24
  import type { LayoutResult } from "./customLayout";
25
25
  import type { CustomLayoutSelection } from "./customLayoutSelection";
26
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
26
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
27
27
  import { type PipelineConfig } from "./pipelineConfig";
28
28
  import type { UpdateResult } from "./pipelineUpdateContract";
29
29
  import { type UpdateResultStore } from "./pipelineUpdateStore";
@@ -21,4 +21,4 @@ export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?:
21
21
  * Returns true when running in a true server/Node.js context where
22
22
  * window and document are not available.
23
23
  */
24
- export declare const isServerEnvironment: boolean;
24
+ export { isServerEnvironment } from "./isServerEnvironment";
@@ -10,6 +10,8 @@ export interface CanvasMargin {
10
10
  bottom: number;
11
11
  left: number;
12
12
  }
13
+ /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
14
+ export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
13
15
  /**
14
16
  * Keep a canvas's backing store and CSS box aligned with the frame size.
15
17
  * This is separate from context preparation so an idle interaction layer can
@@ -33,9 +35,13 @@ export declare function prepareCanvas(canvas: HTMLCanvasElement, size: [number,
33
35
  * Get the effective canvas devicePixelRatio, defaulting to 1 in non-browser
34
36
  * environments. By default, mobile/coarse-pointer screens are capped at 2x to
35
37
  * avoid allocating very large backing stores on high-density phones and
36
- * desktop is capped at 3x. `maxDevicePixelRatio` overrides that ceiling.
38
+ * desktop is capped at 3x. `maxDevicePixelRatio` overrides that DPR ceiling.
39
+ * When `size` is supplied, very large canvases receive an additional backing-
40
+ * store cap so full repaints do not allocate or clear tens of megapixels and
41
+ * DPR scaling does not push a physical side beyond the broadly supported 16K
42
+ * range.
37
43
  */
38
- export declare function getDevicePixelRatio(maxDevicePixelRatio?: number): number;
44
+ export declare function getDevicePixelRatio(maxDevicePixelRatio?: number, size?: readonly [number, number]): number;
39
45
  /**
40
46
  * Subscribe to browser pixel-density changes (page zoom, display migration,
41
47
  * or OS display-scale changes). A normal ResizeObserver is insufficient:
@@ -0,0 +1,21 @@
1
+ import { type CustomLayoutFamily, type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
2
+ export type CustomLayoutAttemptResult<T> = {
3
+ kind: "success";
4
+ result: T;
5
+ } | {
6
+ kind: "failure";
7
+ diagnostic: CustomLayoutFailureDiagnostic;
8
+ preservedLastGoodScene: boolean;
9
+ };
10
+ /**
11
+ * Shared custom-layout try/catch + diagnostic + onLayoutError boundary.
12
+ * Each family store still applies its own success/failure scene recovery.
13
+ */
14
+ export declare function runCustomLayoutAttempt<T>(options: {
15
+ family: CustomLayoutFamily;
16
+ logLabel: string;
17
+ revision: number;
18
+ hasPreviousResult: boolean;
19
+ onLayoutError?: (diagnostic: CustomLayoutFailureDiagnostic) => void;
20
+ run: () => T;
21
+ }): CustomLayoutAttemptResult<T>;
@@ -206,7 +206,7 @@ export interface StreamGeoFrameProps<T = Datum> {
206
206
  };
207
207
  className?: string;
208
208
  background?: string;
209
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
209
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
210
210
  maxDevicePixelRatio?: number;
211
211
  runtimeMode?: "bounded" | "streaming";
212
212
  /** Maximum retained points and lines after imperative streaming begins. @default 500 */
@@ -0,0 +1,6 @@
1
+ /**
2
+ * True in a Node/SSR context where `window` / `document` are unavailable.
3
+ * Kept as its own module so Stream Frames can detect SSR without importing
4
+ * the XY scene-to-SVG serializer graph.
5
+ */
6
+ export declare const isServerEnvironment: boolean;
@@ -0,0 +1,12 @@
1
+ import type { Datum } from "../../charts/shared/datumTypes";
2
+ import type { RealtimeNode } from "../networkTypes";
3
+ /**
4
+ * Build a function that returns a node radius. If `nodeSize` is a number,
5
+ * use it directly. If it is a string accessor, look up `node.data[nodeSize]`
6
+ * and scale the result to `nodeSizeRange`. If it is a function, call it.
7
+ * Falls back to a default radius of 8.
8
+ *
9
+ * Lives outside `forceLayoutPlugin` so the force worker client can serialize
10
+ * radii without importing d3-force.
11
+ */
12
+ export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
@@ -1,10 +1,3 @@
1
- import type { NetworkLayoutPlugin, RealtimeNode } from "../networkTypes";
2
- import type { Datum } from "../../charts/shared/datumTypes";
1
+ import type { NetworkLayoutPlugin } from "../networkTypes";
3
2
  export declare const forceLayoutPlugin: NetworkLayoutPlugin;
4
- /**
5
- * Build a function that returns a node radius. If `nodeSize` is a number,
6
- * use it directly. If it is a string accessor, look up `node.data[nodeSize]`
7
- * and scale the result to `nodeSizeRange`. If it is a function, call it.
8
- * Falls back to a default radius of 8.
9
- */
10
- export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
3
+ export { resolveNodeSizeFn } from "./forceLayoutNodeSize";
@@ -1,7 +1,7 @@
1
1
  import type { GraphEdge, GraphNode, Point } from "../../recipes/networkAnalysis";
2
2
  import type { ForceLayoutOptions } from "../../recipes/forceLayout";
3
- import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "../networkTypes";
4
- export type ForceLayoutExecution = "auto" | "worker" | "sync";
3
+ import { type FrameForceWorkerRequest } from "./forceLayoutWorkerPolicy";
4
+ export { canUseForceWorker, createFrameForceWorkerRequest, DEFAULT_FORCE_WORKER_THRESHOLD, shouldUseForceWorker, type ForceLayoutExecution, type FrameForceWorkerRequest, } from "./forceLayoutWorkerPolicy";
5
5
  export interface NormalizedForceWorkerRequest {
6
6
  kind: "normalized";
7
7
  nodes: GraphNode[];
@@ -9,30 +9,11 @@ export interface NormalizedForceWorkerRequest {
9
9
  options: Omit<ForceLayoutOptions, "nodeRadius">;
10
10
  nodeRadii?: Record<string, number>;
11
11
  }
12
- export interface FrameForceWorkerRequest {
13
- kind: "frame";
14
- nodes: RealtimeNode[];
15
- edges: RealtimeEdge[];
16
- config: {
17
- chartType: "force";
18
- iterations?: number;
19
- forceStrength?: number;
20
- seed?: number;
21
- };
22
- size: [number, number];
23
- }
24
12
  export type ForceWorkerRequest = NormalizedForceWorkerRequest | FrameForceWorkerRequest;
25
13
  export interface ForceWorkerResponse {
26
14
  positions: Record<string, Point>;
27
15
  }
28
- export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
29
- export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
30
- export declare function canUseForceWorker(): boolean;
31
16
  export declare function createForceLayoutWorker(): Worker;
32
- export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
33
- x: number;
34
- y: number;
35
- }> | null): FrameForceWorkerRequest;
36
17
  /**
37
18
  * Long-lived force-layout worker session. Built on {@link ModuleWorkerSession}
38
19
  * so request-id / abort / terminate plumbing is shared with ProcessSankey.
@@ -0,0 +1,21 @@
1
+ import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "../networkTypes";
2
+ export type ForceLayoutExecution = "auto" | "worker" | "sync";
3
+ export interface FrameForceWorkerRequest {
4
+ kind: "frame";
5
+ nodes: RealtimeNode[];
6
+ edges: RealtimeEdge[];
7
+ config: {
8
+ chartType: "force";
9
+ iterations?: number;
10
+ forceStrength?: number;
11
+ seed?: number;
12
+ };
13
+ size: [number, number];
14
+ }
15
+ export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
16
+ export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
17
+ export declare function canUseForceWorker(): boolean;
18
+ export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
19
+ x: number;
20
+ y: number;
21
+ }> | null): FrameForceWorkerRequest;
@@ -1,12 +1,6 @@
1
- import type { NetworkLayoutPlugin, NetworkChartType } from "../networkTypes";
2
- import { sankeyLayoutPlugin } from "./sankeyLayoutPlugin";
3
- import { forceLayoutPlugin } from "./forceLayoutPlugin";
4
- import { chordLayoutPlugin } from "./chordLayoutPlugin";
5
- import { hierarchyLayoutPlugin } from "./hierarchyLayoutPlugin";
6
- import { orbitLayoutPlugin } from "./orbitLayoutPlugin";
7
- /**
8
- * Registry mapping network chart types to their layout plugins.
9
- */
10
- export declare const networkLayoutRegistry: Record<NetworkChartType, NetworkLayoutPlugin>;
11
- export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
12
- export { sankeyLayoutPlugin, forceLayoutPlugin, chordLayoutPlugin, hierarchyLayoutPlugin, orbitLayoutPlugin };
1
+ export { getLayoutPlugin, registerLayoutPlugin } from "./registry";
2
+ export { sankeyLayoutPlugin } from "./sankeyLayoutPlugin";
3
+ export { forceLayoutPlugin } from "./forceLayoutPlugin";
4
+ export { chordLayoutPlugin } from "./chordLayoutPlugin";
5
+ export { hierarchyLayoutPlugin } from "./hierarchyLayoutPlugin";
6
+ export { orbitLayoutPlugin } from "./orbitLayoutPlugin";
@@ -0,0 +1,7 @@
1
+ import type { NetworkChartType } from "../networkTypes";
2
+ /**
3
+ * Direct StreamNetworkFrame usage no longer loads every layout. Warn once in
4
+ * development when a chartType has no registered plugin so the empty scene is
5
+ * not silent.
6
+ */
7
+ export declare function warnIfLayoutPluginMissing(chartType: NetworkChartType): void;
@@ -0,0 +1 @@
1
+ export declare function registerBuiltInNetworkLayouts(): void;
@@ -0,0 +1,12 @@
1
+ import type { NetworkChartType, NetworkLayoutPlugin } from "../networkTypes";
2
+ /**
3
+ * Register a network layout plugin. Call this with a value import of the
4
+ * plugin — `package.json` has `"sideEffects": false`, so a bare
5
+ * `import "./sankeyLayoutPlugin"` may be dropped by consumer bundlers.
6
+ *
7
+ * Chart HOCs register only the plugin they need. Direct StreamNetworkFrame
8
+ * users should import the matching plugin or call
9
+ * {@link registerBuiltInNetworkLayouts} from `semiotic/network`.
10
+ */
11
+ export declare function registerLayoutPlugin(chartType: NetworkChartType, plugin: NetworkLayoutPlugin): void;
12
+ export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
@@ -0,0 +1,3 @@
1
+ import type { MarginalConfig, MarginalType } from "./types";
2
+ /** Resolve a string shorthand or full config into a MarginalConfig */
3
+ export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
@@ -135,6 +135,13 @@ export interface NetworkLayoutResult {
135
135
  sceneEdges?: NetworkSceneEdge[];
136
136
  /** Optional labels placed at arbitrary plot-relative positions. */
137
137
  labels?: NetworkLabel[];
138
+ /**
139
+ * SVG graphics composited below the canvas scene. Use for layout-derived
140
+ * regions and enclosures that must sit behind edges and nodes while sharing
141
+ * their fitted plot coordinates. Backgrounds are non-interactive and are
142
+ * included in live, hydrated, and static SVG rendering.
143
+ */
144
+ backgrounds?: ReactNode;
138
145
  /** SVG overlays composited above the canvas. */
139
146
  overlays?: ReactNode;
140
147
  /**
@@ -0,0 +1,13 @@
1
+ import type { ReactNode } from "react";
2
+ import type { NetworkHtmlMark, NetworkLayoutResult } from "./networkCustomLayout";
3
+ /** Mutable custom-layout output fields owned by NetworkPipelineStore. */
4
+ export interface NetworkCustomLayoutOutputTarget {
5
+ customLayoutBackgrounds: ReactNode;
6
+ customLayoutOverlays: ReactNode;
7
+ customLayoutHtmlMarks: NetworkHtmlMark[];
8
+ lastCustomLayoutResult: NetworkLayoutResult | null;
9
+ }
10
+ /** Apply the non-scene output from one successful custom-layout result atomically. */
11
+ export declare function applyNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget, result: NetworkLayoutResult): void;
12
+ /** Clear every non-scene custom-layout output when its owning layout is gone. */
13
+ export declare function clearNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget): void;
@@ -1,5 +1,5 @@
1
1
  import type { NetworkLayoutResult } from "./networkCustomLayout";
2
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
2
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
3
3
  import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "./networkTypes";
4
4
  interface NetworkCustomLayoutRunInput {
5
5
  config: NetworkPipelineConfig;
@@ -614,7 +614,7 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
614
614
  };
615
615
  className?: string;
616
616
  background?: string;
617
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
617
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
618
618
  maxDevicePixelRatio?: number;
619
619
  legend?: LegendValue;
620
620
  legendPosition?: "right" | "left" | "top" | "bottom";
@@ -627,6 +627,10 @@ export interface StreamNetworkFrameProps<T = Datum> extends StreamNetworkInterac
627
627
  }) => void;
628
628
  legendHighlightedCategory?: string | null;
629
629
  legendIsolatedCategories?: Set<string>;
630
+ /** Internal push-mode category discovery accessor used by chart HOCs. */
631
+ legendCategoryAccessor?: string | ((d: T) => string | number);
632
+ /** Receives the current pushed-node category domain. */
633
+ onCategoriesChange?: (categories: string[]) => void;
630
634
  title?: string | ReactNode;
631
635
  /** SVG above the canvas. Network layouts have no shared scale object, so callback `scales` is null. */
632
636
  foregroundGraphics?: FrameGraphicsProp<null>;
@@ -330,7 +330,7 @@ export interface StreamOrdinalFrameProps<T = Datum> {
330
330
  bottom?: number;
331
331
  left?: number;
332
332
  };
333
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
333
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
334
334
  maxDevicePixelRatio?: number;
335
335
  barPadding?: number;
336
336
  roundedTop?: BarCornerRadius;
@@ -179,7 +179,7 @@ export interface StreamPhysicsFrameProps {
179
179
  * to composite over siblings (same contract as StreamXYFrame).
180
180
  */
181
181
  background?: string;
182
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
182
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
183
183
  maxDevicePixelRatio?: number;
184
184
  backgroundGraphics?: FrameGraphicsProp;
185
185
  /**
@@ -36,6 +36,12 @@ export declare function resolveStackedAreaYDomain(options: {
36
36
  };
37
37
  export declare function resolveBarBinYDomain(buffer: RingBuffer<Datum>, getX: (d: Datum) => number, getY: (d: Datum) => number, binSize: number, getCategory: ((d: Datum) => string) | undefined, extentPadding: number, exactMode: boolean): [number, number];
38
38
  export declare function resolveWaterfallYDomain(buffer: RingBuffer<Datum>, getY: (d: Datum) => number, extentPadding: number, exactMode: boolean): [number, number];
39
+ /**
40
+ * Waterfall x values identify bar centers, so the automatic domain needs half
41
+ * of the neighboring interval beyond each edge datum. User-specified bounds
42
+ * remain authoritative, including partial extents.
43
+ */
44
+ export declare function resolveWaterfallXDomain(data: Datum[], getX: (d: Datum) => number, dataDomain: [number, number], userExtent: [number | undefined, number | undefined] | [number] | undefined, xScaleType: PipelineConfig["xScaleType"]): [number, number];
39
45
  export declare function expandYDomainWithRibbons(yDomain: [number, number], bufferArray: Datum[], ribbons: ResolvedRibbon[]): [number, number];
40
46
  export declare function padYDomain(yDomain: [number, number], options: {
41
47
  exactMode: boolean;
@@ -4,5 +4,9 @@ import type { StreamRendererFn } from "./types";
4
4
  * Renders PointSceneNode as circles. Used by Scatterplot, BubbleChart, SwarmChart,
5
5
  * and showPoints on LineChart, AreaChart, and StackedAreaChart.
6
6
  * Supports pulse glow effect via _pulseIntensity/_pulseColor fields.
7
+ *
8
+ * Opaque same-style points that are contiguous in data order share one path.
9
+ * Translucent points, hatches/patterns, and pulses stay per-mark so overlap
10
+ * compositing and z-order match the unbatched painter.
7
11
  */
8
12
  export declare const pointCanvasRenderer: StreamRendererFn;
@@ -13,10 +13,10 @@
13
13
  * media-query changes that bypass React).
14
14
  */
15
15
  /**
16
- * Repaint subscription for settled canvases whose CSS cascade changes without
17
- * a ThemeStore update (ancestor class/style changes or system color-scheme
18
- * media changes). Notifications are scoped to the subscribed element's DOM
19
- * branch; requestAnimationFrame coalescing remains owned by the frame.
16
+ * Repaint subscription for settled canvases whose CSS cascade or loaded fonts
17
+ * change without a ThemeStore update. CSS mutation notifications are scoped
18
+ * to the subscribed element's DOM branch; font completion is document-wide.
19
+ * requestAnimationFrame coalescing remains owned by the frame.
20
20
  */
21
21
  export declare function subscribeToCSSColorInvalidation(getElement: () => Element | null, listener: () => void): () => void;
22
22
  export declare function resolveCSSColor(ctx: CanvasRenderingContext2D, value: string | undefined): string | undefined;
@@ -586,6 +586,12 @@ export interface BandConfig<T = Datum> {
586
586
  interactive?: boolean;
587
587
  }
588
588
  export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteractionProps<HoverData> {
589
+ /**
590
+ * Built-in mark set. HOCs register the plugin they need. Direct
591
+ * StreamXYFrame loads other built-ins on first client paint. Call
592
+ * `registerBuiltInXYPlugins()` from `semiotic/xy` or
593
+ * `semiotic/realtime/core` for SSR / first-frame marks.
594
+ */
589
595
  chartType: StreamChartType;
590
596
  runtimeMode?: RuntimeMode;
591
597
  data?: T[];
@@ -713,7 +719,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
713
719
  background?: string;
714
720
  /**
715
721
  * Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
716
- * on coarse-pointer/small-screen devices. Increase this when mark crispness
722
+ * on coarse-pointer/small-screen devices; very large canvases are further
723
+ * capped by a shared backing-store budget. Increase this when mark crispness
717
724
  * at high browser zoom is more important than canvas memory/paint cost.
718
725
  */
719
726
  maxDevicePixelRatio?: number;
@@ -0,0 +1,18 @@
1
+ import { type MutableRefObject } from "react";
2
+ import type { StreamChartType } from "./types";
3
+ /**
4
+ * Keep LineChart's static graph free of candlestick/heatmap/bar, while
5
+ * restoring two Frame contracts that cannot live on that graph:
6
+ *
7
+ * - `customLayout` can emit any node type — load the full painter set
8
+ * in a split chunk when a custom layout is actually present.
9
+ * - Direct `<StreamXYFrame chartType="line" />` used to work with no
10
+ * prior register call. If this chartType has no plugin yet, load
11
+ * every built-in in a split chunk (HOCs that already registered skip
12
+ * this path).
13
+ *
14
+ * The paint loop only redraws when `dirtyRef` is set (or a
15
+ * transition/restyle/pulse/resolution change). `scheduleRender` alone
16
+ * after the first frame is not enough.
17
+ */
18
+ export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void): void;
@@ -0,0 +1,13 @@
1
+ import { type RefObject } from "react";
2
+ import type { Datum } from "../charts/shared/datumTypes";
3
+ import type { MarginalGraphicsConfig } from "./types";
4
+ type MarginalStore = {
5
+ getData(): readonly Datum[];
6
+ };
7
+ /** Keep React-owned marginal SVG values synchronized with the retained store. */
8
+ export declare function useMarginalValues(storeRef: RefObject<MarginalStore | null>, marginalGraphics: MarginalGraphicsConfig | undefined, data: readonly Datum[], xAccessor: unknown, yAccessor: unknown): {
9
+ marginalXValues: number[];
10
+ marginalYValues: number[];
11
+ refreshMarginalValues: (data?: readonly Datum[]) => void;
12
+ };
13
+ export {};
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Chart-type → canvas renderer dispatch for StreamXYFrame.
3
- * Order matters: earlier renderers paint underneath later ones.
3
+ *
4
+ * Renderers now live on XY plugins (`xyPlugins/`). This module re-exports
5
+ * the lookup so existing imports keep working.
4
6
  */
5
- import type { StreamChartType } from "./types";
6
- import type { StreamRendererFn } from "./renderers/types";
7
- export declare const XY_CANVAS_RENDERERS: Record<StreamChartType, StreamRendererFn[]>;
7
+ export { getXYCanvasRenderers } from "./xyPlugins/registry";
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const areaXYPlugin: XYChartPlugin;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const barXYPlugin: XYChartPlugin;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const candlestickXYPlugin: XYChartPlugin;
@@ -0,0 +1,6 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ /**
3
+ * Painter set for customLayout. Scene geometry comes from the user callback;
4
+ * this plugin only supplies every self-filtering canvas renderer.
5
+ */
6
+ export declare const customXYPlugin: XYChartPlugin;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const heatmapXYPlugin: XYChartPlugin;
@@ -0,0 +1,5 @@
1
+ /**
2
+ * LineChart can switch chartType between line / area / mixed via `fillArea`.
3
+ * Register the three together so that prop still paints.
4
+ */
5
+ export declare function registerLineFamilyXYPlugins(): void;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const lineXYPlugin: XYChartPlugin;
@@ -0,0 +1,7 @@
1
+ import type { StreamChartType } from "../types";
2
+ /**
3
+ * SSR cannot wait for the client built-in chunk. Warn once per chartType
4
+ * when a plugin is still missing on the server so an empty scene is not
5
+ * silent. Client frames load built-ins asynchronously instead.
6
+ */
7
+ export declare function warnIfXYPluginMissing(chartType: StreamChartType): void;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const mixedXYPlugin: XYChartPlugin;
@@ -0,0 +1,3 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const scatterXYPlugin: XYChartPlugin;
3
+ export declare const bubbleXYPlugin: XYChartPlugin;
@@ -0,0 +1 @@
1
+ export declare function registerBuiltInXYPlugins(): void;
@@ -0,0 +1,31 @@
1
+ import type { Datum } from "../../charts/shared/datumTypes";
2
+ import type { StreamChartType, StreamLayout, SceneNode } from "../types";
3
+ import type { StreamRendererFn } from "../renderers/types";
4
+ import type { XYSceneContext } from "../xySceneBuilders/types";
5
+ import type { BarSceneResult } from "../xySceneBuilders/barScene";
6
+ /**
7
+ * Register XY scene + canvas plugins with a value import of the plugin.
8
+ * `package.json` has `"sideEffects": false`, so a bare
9
+ * `import "./linePlugin"` may be dropped by consumer bundlers.
10
+ *
11
+ * Chart HOCs register only the plugin they need. Direct StreamXYFrame
12
+ * users should import the matching plugin or call
13
+ * {@link registerBuiltInXYPlugins} from `semiotic/xy`.
14
+ */
15
+ export type XYSceneBuildResult = SceneNode[] | BarSceneResult;
16
+ export type XYSceneBuilder = (ctx: XYSceneContext, data: Datum[], layout: StreamLayout) => XYSceneBuildResult;
17
+ export interface XYChartPlugin {
18
+ chartType: StreamChartType;
19
+ buildScene: XYSceneBuilder;
20
+ canvasRenderers: StreamRendererFn[];
21
+ }
22
+ export declare function registerXYPlugin(plugin: XYChartPlugin): void;
23
+ /** Test-only: drop every plugin so HOC registration can be asserted in isolation. */
24
+ export declare function resetXYPluginRegistry(): void;
25
+ export declare function getXYPlugin(chartType: StreamChartType): XYChartPlugin | undefined;
26
+ export declare function getXYSceneBuilder(chartType: StreamChartType): XYSceneBuilder | undefined;
27
+ export declare function getXYCanvasRenderers(chartType: StreamChartType, customLayout?: boolean): StreamRendererFn[];
28
+ export declare function unwrapXYScene(result: XYSceneBuildResult): {
29
+ nodes: SceneNode[];
30
+ binBoundaries: number[];
31
+ };
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const stackedAreaXYPlugin: XYChartPlugin;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const swarmXYPlugin: XYChartPlugin;
@@ -0,0 +1,2 @@
1
+ import type { XYChartPlugin } from "./registry";
2
+ export declare const waterfallXYPlugin: XYChartPlugin;