semiotic 3.10.0 → 3.10.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 (403) hide show
  1. package/README.md +73 -72
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/componentMetadata.cjs +3 -1
  4. package/ai/dist/mcp-server.js +47 -46
  5. package/ai/examples.md +95 -0
  6. package/ai/reference.md +80 -1
  7. package/ai/schema.json +7304 -1990
  8. package/ai/surface-manifest.json +26 -4
  9. package/ai/task-packets/compare-category-totals.json +7 -53
  10. package/ai/task-packets/compare-category-totals.md +4 -4
  11. package/ai/task-packets/correct-published-chart.json +7 -53
  12. package/ai/task-packets/correct-published-chart.md +4 -4
  13. package/ai/task-packets/index.json +9 -9
  14. package/ai/task-packets/update-live-chart.json +8 -54
  15. package/ai/task-packets/update-live-chart.md +4 -4
  16. package/dist/c-27DCB5T6.min.js +18 -0
  17. package/dist/c-2MONF2P6.min.js +1 -0
  18. package/dist/c-2TW5H5PD.min.js +1 -0
  19. package/dist/c-3AGX252H.min.js +1 -0
  20. package/dist/c-3B6JZEZT.min.js +1 -0
  21. package/dist/c-3BYZXCX3.min.js +4 -0
  22. package/dist/c-3DIPZJDO.min.js +1 -0
  23. package/dist/c-3FOUMWLR.min.js +1 -0
  24. package/dist/c-3NA6I656.min.js +2 -0
  25. package/dist/c-3OFVBWQY.min.js +1 -0
  26. package/dist/{c-QA3HMQJP.min.js → c-3PFVJFBK.min.js} +1 -1
  27. package/dist/c-3PPO7ZJF.min.js +4 -0
  28. package/dist/c-3YEW2PK6.min.js +1 -0
  29. package/dist/c-4JKDJUYD.min.js +1 -0
  30. package/dist/c-4LKK5YWB.min.js +1 -0
  31. package/dist/c-4MD53L2J.min.js +33 -0
  32. package/dist/c-4V3CD337.min.js +1 -0
  33. package/dist/c-4XLHPQTP.min.js +1 -0
  34. package/dist/c-5NYONM6V.min.js +5 -0
  35. package/dist/c-6IVBV5NO.min.js +1 -0
  36. package/dist/c-6ZU3QVLB.min.js +100 -0
  37. package/dist/c-72CBVNYX.min.js +209 -0
  38. package/dist/c-7APWCEPL.min.js +1 -0
  39. package/dist/c-7ASK4WBF.min.js +1 -0
  40. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  41. package/dist/c-7LY46QUI.min.js +41 -0
  42. package/dist/c-ABMGCCLT.min.js +1 -0
  43. package/dist/c-AINGQGUN.min.js +1 -0
  44. package/dist/c-AKLBQMQF.min.js +391 -0
  45. package/dist/c-AXJ2QI3F.min.js +1 -0
  46. package/dist/c-BQYD7T4E.min.js +1 -0
  47. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  48. package/dist/{c-JO2UGTCP.min.js → c-C4KIXUWU.min.js} +1 -1
  49. package/dist/c-C4SXYFXL.min.js +1 -0
  50. package/dist/c-CLDCKFBE.min.js +1 -0
  51. package/dist/c-CLJCJSFU.min.js +1 -0
  52. package/dist/c-CLLCX3PT.min.js +2 -0
  53. package/dist/c-ECHBKW7U.min.js +1 -0
  54. package/dist/c-EPJWM2UT.min.js +1 -0
  55. package/dist/c-F2GGJB2S.min.js +31 -0
  56. package/dist/c-FD2BXSRG.min.js +1 -0
  57. package/dist/c-FDUQDCBC.min.js +51 -0
  58. package/dist/c-FOTTQHOO.min.js +1 -0
  59. package/dist/c-FU7A5KSY.min.js +1 -0
  60. package/dist/c-G53AVC42.min.js +113 -0
  61. package/dist/c-GHN6IR4Y.min.js +1 -0
  62. package/dist/c-GSCO3FWL.min.js +1 -0
  63. package/dist/c-GYLOSK7M.min.js +1 -0
  64. package/dist/c-HK4OSLZA.min.js +1 -0
  65. package/dist/c-HLGTD5SJ.min.js +1 -0
  66. package/dist/c-HQ27AHMC.min.js +1 -0
  67. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  68. package/dist/c-IHWZ2C6D.min.js +26 -0
  69. package/dist/c-IIV73MUW.min.js +1 -0
  70. package/dist/c-IPYGNVN6.min.js +116 -0
  71. package/dist/c-JJKRER47.min.js +1 -0
  72. package/dist/c-JO6AYCU4.min.js +1 -0
  73. package/dist/c-JWHPG6S2.min.js +1 -0
  74. package/dist/c-JXVYIXTV.min.js +1 -0
  75. package/dist/c-K2ZIYDI3.min.js +1 -0
  76. package/dist/c-K37JAIWA.min.js +4 -0
  77. package/dist/c-KGROWFT2.min.js +9 -0
  78. package/dist/c-MOP2NGLH.min.js +1 -0
  79. package/dist/c-MTX2AO5S.min.js +1 -0
  80. package/dist/c-N5WT7TXG.min.js +1 -0
  81. package/dist/c-NATWERHZ.min.js +1 -0
  82. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  83. package/dist/c-OVQB75PE.min.js +1 -0
  84. package/dist/c-P3SKRNZN.min.js +1 -0
  85. package/dist/c-P5NXQWIM.min.js +1 -0
  86. package/dist/c-P7BQMVQQ.min.js +1 -0
  87. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  88. package/dist/c-PKY4JFY5.min.js +1 -0
  89. package/dist/c-PQOZPM4G.min.js +1 -0
  90. package/dist/c-PZ3NEGNG.min.js +1 -0
  91. package/dist/c-QXLDCATV.min.js +1 -0
  92. package/dist/c-R2HUSWKB.min.js +1 -0
  93. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  94. package/dist/c-RZPP5ERV.min.js +1 -0
  95. package/dist/c-SG2Y7EBY.min.js +46 -0
  96. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  97. package/dist/c-SQNEVNWT.min.js +1 -0
  98. package/dist/c-STHZWF3D.min.js +1 -0
  99. package/dist/c-TIDKVMMZ.min.js +1 -0
  100. package/dist/c-TIMGODBG.min.js +1 -0
  101. package/dist/c-TR7OHUAO.min.js +2 -0
  102. package/dist/c-TTKWXGAI.min.js +61 -0
  103. package/dist/c-TVKZC4BY.min.js +1 -0
  104. package/dist/c-U5XVLSHN.min.js +1 -0
  105. package/dist/c-U6NLVFN4.min.js +1 -0
  106. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  107. package/dist/c-UOPPO26M.min.js +1 -0
  108. package/dist/c-UUDAON4Z.min.js +1 -0
  109. package/dist/c-V32TPPY2.min.js +1 -0
  110. package/dist/c-V5KFJWQQ.min.js +1 -0
  111. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  112. package/dist/c-VXIYF7V2.min.js +1 -0
  113. package/dist/c-Y342FJ6K.min.js +1 -0
  114. package/dist/c-YM6CT4LJ.min.js +1 -0
  115. package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
  116. package/dist/c-YQVOKPKR.min.js +1 -0
  117. package/dist/c-YRJ3BJQZ.min.js +1 -0
  118. package/dist/c-YT5KPVNP.min.js +1 -0
  119. package/dist/components/ai/audienceProfile.d.ts +18 -1
  120. package/dist/components/ai/describeChart.d.ts +5 -1
  121. package/dist/components/ai/intentManifest.d.ts +16 -0
  122. package/dist/components/ai/intentRegistry.d.ts +12 -0
  123. package/dist/components/ai/intents.d.ts +6 -6
  124. package/dist/components/ai/streamSchema.d.ts +19 -0
  125. package/dist/components/ai/streamingTypes.d.ts +57 -11
  126. package/dist/components/ai/suggestCharts.d.ts +1 -1
  127. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  128. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  129. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  130. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  131. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  132. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  133. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  135. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  136. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  137. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  138. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  139. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  140. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  141. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  142. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  143. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  144. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  145. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  146. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  147. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  148. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  149. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  150. package/dist/components/charts/shared/hooks.d.ts +3 -1
  151. package/dist/components/charts/shared/knownChartComponents.d.ts +5 -2
  152. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  153. package/dist/components/charts/shared/useChartSetup.d.ts +2 -0
  154. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  155. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  156. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  157. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  158. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  159. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  160. package/dist/components/realtime/HyperLogLog.d.ts +19 -0
  161. package/dist/components/realtime/ReorderBuffer.d.ts +2 -2
  162. package/dist/components/realtime/TDigest.d.ts +22 -0
  163. package/dist/components/realtime/WindowAccumulator.d.ts +22 -5
  164. package/dist/components/realtime/applyChangelog.d.ts +38 -0
  165. package/dist/components/realtime/minHeap.d.ts +3 -0
  166. package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
  167. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  168. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  169. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  170. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  171. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  172. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  173. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  174. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  175. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  176. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  177. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  178. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  179. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  180. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  181. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  182. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  183. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  184. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  185. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  186. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  187. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  188. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  189. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  190. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  191. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  192. package/dist/components/recipes/atlas/index.d.ts +26 -0
  193. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  194. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  195. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  196. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  197. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  198. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  199. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  200. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  201. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  202. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  203. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  204. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  205. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  206. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  207. package/dist/components/recipes/atlas/support.d.ts +7 -0
  208. package/dist/components/recipes/atlas/types.d.ts +278 -0
  209. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  210. package/dist/components/recipes/layout1d.d.ts +2 -20
  211. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  212. package/dist/components/semiotic-ai-core.d.ts +8 -3
  213. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  214. package/dist/components/semiotic-ai.d.ts +4 -6
  215. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  216. package/dist/components/semiotic-atlas.d.ts +8 -0
  217. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  218. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  219. package/dist/components/semiotic-stream-types.d.ts +14 -0
  220. package/dist/components/semiotic-xy.d.ts +1 -0
  221. package/dist/components/semiotic.d.ts +3 -11
  222. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  223. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  224. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  225. package/dist/components/server/renderEvidence.d.ts +4 -0
  226. package/dist/components/server/serverChartConfigs.d.ts +8 -0
  227. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  228. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  229. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  230. package/dist/components/server/staticAnnotations.d.ts +9 -0
  231. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  232. package/dist/components/stream/SceneGraph.d.ts +3 -3
  233. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  234. package/dist/components/stream/canvasSetup.d.ts +1 -2
  235. package/dist/components/stream/fontLoading.d.ts +4 -0
  236. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  237. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  238. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  239. package/dist/components/stream/physics/physicsSemanticUI.d.ts +2 -0
  240. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  241. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  242. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  243. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  244. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  245. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  246. package/dist/components/stream/shallowEqual.d.ts +2 -0
  247. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  248. package/dist/components/stream/types.d.ts +25 -2
  249. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  250. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  251. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  252. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  253. package/dist/components/text/labelMeasurement.d.ts +19 -0
  254. package/dist/components/text/labelPlacement.d.ts +71 -0
  255. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  256. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  257. package/dist/controls.module.min.js +71 -1
  258. package/dist/geo.min.js +231 -1
  259. package/dist/geo.module.min.js +31 -1
  260. package/dist/network.module.min.js +1 -1
  261. package/dist/ordinal.module.min.js +1 -1
  262. package/dist/physics-matter.module.min.js +1 -1
  263. package/dist/physics-rapier.module.min.js +1 -1
  264. package/dist/physics.module.min.js +1 -1
  265. package/dist/rough.min.js +2 -1
  266. package/dist/rough.module.min.js +2 -1
  267. package/dist/semiotic-access.module.min.js +1 -1
  268. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  269. package/dist/semiotic-ai-core.d.ts +8 -3
  270. package/dist/semiotic-ai-core.min.js +4 -1
  271. package/dist/semiotic-ai-core.module.min.js +4 -1
  272. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  273. package/dist/semiotic-ai.d.ts +4 -6
  274. package/dist/semiotic-ai.module.min.js +14 -1
  275. package/dist/semiotic-artifact-react.min.js +269 -1
  276. package/dist/semiotic-artifact-react.module.min.js +137 -1
  277. package/dist/semiotic-artifact.min.js +3 -1
  278. package/dist/semiotic-artifact.module.min.js +3 -1
  279. package/dist/semiotic-atlas-core.d.ts +20 -0
  280. package/dist/semiotic-atlas-core.min.js +2 -0
  281. package/dist/semiotic-atlas-core.module.min.js +1 -0
  282. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  283. package/dist/semiotic-atlas.d.ts +8 -0
  284. package/dist/semiotic-atlas.min.js +2 -0
  285. package/dist/semiotic-atlas.module.min.js +12 -0
  286. package/dist/semiotic-client-cjs-shared.min.js +1529 -1
  287. package/dist/semiotic-client-glyph.module.min.js +3 -1
  288. package/dist/semiotic-client-responsive.module.min.js +1 -1
  289. package/dist/semiotic-client-shared.module.min.js +1 -1
  290. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  291. package/dist/semiotic-data.min.js +1 -1
  292. package/dist/semiotic-data.module.min.js +1 -1
  293. package/dist/semiotic-evidence.min.js +3 -1
  294. package/dist/semiotic-evidence.module.min.js +3 -1
  295. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  296. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  297. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  298. package/dist/semiotic-experimental-vacp.min.js +1 -1
  299. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  300. package/dist/semiotic-line.module.min.js +1 -1
  301. package/dist/semiotic-realtime-core.d.ts +6 -2
  302. package/dist/semiotic-realtime-core.module.min.js +1 -1
  303. package/dist/semiotic-realtime-react.module.min.js +1 -1
  304. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  305. package/dist/semiotic-recipes-core.d.ts +9 -0
  306. package/dist/semiotic-recipes-core.module.min.js +72 -1
  307. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  308. package/dist/semiotic-recipes-react.min.js +3 -1
  309. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  310. package/dist/semiotic-server-edge.min.js +651 -1
  311. package/dist/semiotic-server-edge.module.min.js +372 -1
  312. package/dist/semiotic-server-node.min.js +651 -1
  313. package/dist/semiotic-server-node.module.min.js +1 -1
  314. package/dist/semiotic-text.min.js +1 -1
  315. package/dist/semiotic-text.module.min.js +1 -1
  316. package/dist/semiotic-themes-core.min.js +1 -1
  317. package/dist/semiotic-themes-core.module.min.js +1 -1
  318. package/dist/semiotic-themes.min.js +1 -1
  319. package/dist/semiotic-themes.module.min.js +1 -1
  320. package/dist/semiotic-utils-core.min.js +11 -1
  321. package/dist/semiotic-utils-core.module.min.js +8 -1
  322. package/dist/semiotic-value.module.min.js +15 -1
  323. package/dist/semiotic-xy.d.ts +1 -0
  324. package/dist/semiotic.d.ts +3 -11
  325. package/dist/semiotic.module.min.js +10 -1
  326. package/dist/server.min.js +651 -1
  327. package/dist/server.module.min.js +1 -1
  328. package/dist/xy.module.min.js +1 -1
  329. package/package.json +19 -3
  330. package/dist/c-2N7IU2NY.min.js +0 -1
  331. package/dist/c-2WK7YJLL.min.js +0 -1
  332. package/dist/c-33QOXEUG.min.js +0 -1
  333. package/dist/c-447VIMRO.min.js +0 -1
  334. package/dist/c-4FN7Q6VQ.min.js +0 -1
  335. package/dist/c-553QUDKA.min.js +0 -1
  336. package/dist/c-55BAJ333.min.js +0 -1
  337. package/dist/c-7242NXSG.min.js +0 -1
  338. package/dist/c-7EGHJU2F.min.js +0 -1
  339. package/dist/c-7HP7MB2I.min.js +0 -1
  340. package/dist/c-7NBU5ZKS.min.js +0 -1
  341. package/dist/c-AFBSWT77.min.js +0 -1
  342. package/dist/c-AJ7EC32V.min.js +0 -1
  343. package/dist/c-AQADQNY7.min.js +0 -1
  344. package/dist/c-ATM475SA.min.js +0 -1
  345. package/dist/c-AVO3Q7T7.min.js +0 -1
  346. package/dist/c-AZKPVBOC.min.js +0 -1
  347. package/dist/c-BNFJMDHN.min.js +0 -1
  348. package/dist/c-BNG5ECK5.min.js +0 -1
  349. package/dist/c-BOHCQILI.min.js +0 -1
  350. package/dist/c-CCTGN5CK.min.js +0 -1
  351. package/dist/c-CPSPZH6A.min.js +0 -1
  352. package/dist/c-CPV4N35K.min.js +0 -1
  353. package/dist/c-DE5Q3U2X.min.js +0 -1
  354. package/dist/c-DK662R77.min.js +0 -1
  355. package/dist/c-DY2676CR.min.js +0 -1
  356. package/dist/c-E32M6XW5.min.js +0 -1
  357. package/dist/c-E4JDJH4I.min.js +0 -1
  358. package/dist/c-E7I2L7CU.min.js +0 -1
  359. package/dist/c-EBOQ7ER7.min.js +0 -1
  360. package/dist/c-ELDWAO2V.min.js +0 -1
  361. package/dist/c-EUBTECGM.min.js +0 -1
  362. package/dist/c-GSZRZRD6.min.js +0 -1
  363. package/dist/c-GWX7JGMF.min.js +0 -1
  364. package/dist/c-GXV3C3MO.min.js +0 -1
  365. package/dist/c-HHTK2R75.min.js +0 -1
  366. package/dist/c-HLLFJYTY.min.js +0 -1
  367. package/dist/c-HPOYKCCG.min.js +0 -1
  368. package/dist/c-HXDKPIKR.min.js +0 -1
  369. package/dist/c-I4QJ6YLM.min.js +0 -1
  370. package/dist/c-IDJV3CZK.min.js +0 -1
  371. package/dist/c-ITKX3RC5.min.js +0 -1
  372. package/dist/c-JG2JCQLP.min.js +0 -1
  373. package/dist/c-JLGRHXGZ.min.js +0 -1
  374. package/dist/c-JUKIWTBJ.min.js +0 -1
  375. package/dist/c-KCRJGUHP.min.js +0 -1
  376. package/dist/c-LMGSSD2E.min.js +0 -1
  377. package/dist/c-LYQMZMZQ.min.js +0 -1
  378. package/dist/c-LYVKDBQJ.min.js +0 -1
  379. package/dist/c-MXCP7GNZ.min.js +0 -1
  380. package/dist/c-NG7BLZTR.min.js +0 -1
  381. package/dist/c-NYZ2QNAM.min.js +0 -1
  382. package/dist/c-OO5QLMJC.min.js +0 -1
  383. package/dist/c-OOVX2JPQ.min.js +0 -1
  384. package/dist/c-PP6VY3QU.min.js +0 -1
  385. package/dist/c-PRIKOLTE.min.js +0 -1
  386. package/dist/c-PSNI6KAZ.min.js +0 -1
  387. package/dist/c-PYNW54D2.min.js +0 -1
  388. package/dist/c-QAVFOEUY.min.js +0 -1
  389. package/dist/c-ROEHCIGV.min.js +0 -1
  390. package/dist/c-S3AZX5PP.min.js +0 -1
  391. package/dist/c-T2V7O2LO.min.js +0 -1
  392. package/dist/c-TIXX5CAU.min.js +0 -1
  393. package/dist/c-TKG2NP7G.min.js +0 -1
  394. package/dist/c-VXLOLYTO.min.js +0 -1
  395. package/dist/c-W4ZUKSEQ.min.js +0 -1
  396. package/dist/c-WH2O53VI.min.js +0 -1
  397. package/dist/c-WNGH47HF.min.js +0 -1
  398. package/dist/c-XDQKXPX4.min.js +0 -1
  399. package/dist/c-XSB27XPS.min.js +0 -1
  400. package/dist/c-YDECTEUW.min.js +0 -1
  401. package/dist/c-YF3YKVQI.min.js +0 -1
  402. package/dist/c-YLZIV3VS.min.js +0 -1
  403. package/dist/c-ZYPXQF7B.min.js +0 -1
@@ -53,6 +53,7 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
53
53
  * StreamNetworkFrame). Empty for built-in chart types. */
54
54
  customLayoutHtmlMarks: NetworkHtmlMark[];
55
55
  private _customLayoutDiagnosticsWarned;
56
+ private _customLayoutCache;
56
57
  /** Per-frame restyle callbacks from the custom layout result. When set, the
57
58
  * frame routes selection changes through `restyleScene()` (style-only repaint)
58
59
  * instead of a full `buildScene()`. */
@@ -1,8 +1,8 @@
1
1
  import type { SceneNode, SceneDatum, LineSceneNode, AreaSceneNode, PointSceneNode, SymbolSceneNode, RectSceneNode, HeatcellSceneNode, Style, StreamScales, CurveType } from "./types";
2
2
  import type { SymbolName } from "./symbolPath";
3
3
  import type { Datum } from "../charts/shared/datumTypes";
4
- export declare function buildLineNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, style: Style, group?: string): LineSceneNode;
5
- export declare function buildAreaNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Datum) => number): AreaSceneNode;
4
+ export declare function buildLineNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, style: Style, group?: string, getPointId?: (d: Datum) => string): LineSceneNode;
5
+ export declare function buildAreaNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Datum) => number, getPointId?: (d: Datum) => string): AreaSceneNode;
6
6
  /** Per-group-per-x stacked top values, keyed by group then x */
7
7
  export type StackedTops = Map<string, Map<number, number>>;
8
8
  export type StackBaseline = "zero" | "wiggle" | "silhouette" | "diverging";
@@ -30,7 +30,7 @@ export declare function computeDivergingStackExtent(xValues: number[], groupKeys
30
30
  export declare function buildStackedAreaNodes(groups: {
31
31
  key: string;
32
32
  data: Datum[];
33
- }[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, styleFn: (group: string, sampleDatum?: Datum) => Style, normalize?: boolean, curve?: CurveType, baseline?: StackBaseline): {
33
+ }[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, styleFn: (group: string, sampleDatum?: Datum) => Style, normalize?: boolean, curve?: CurveType, baseline?: StackBaseline, getPointId?: (d: Datum) => string): {
34
34
  nodes: AreaSceneNode[];
35
35
  stackedTops: StackedTops;
36
36
  };
@@ -1,8 +1,11 @@
1
- import type { StalenessConfig } from "./types";
1
+ import type { SourceLiveness, StalenessConfig } from "./types";
2
2
  interface StalenessBadgeProps {
3
3
  isStale: boolean;
4
4
  position?: StalenessConfig["badgePosition"];
5
+ state?: SourceLiveness;
6
+ settling?: boolean;
5
7
  }
8
+ export declare function resolveStalenessBadgeState(isStale: boolean, state?: SourceLiveness, settling?: boolean): SourceLiveness;
6
9
  /**
7
10
  * Live/stale indicator chip shown in a corner of a streaming chart when
8
11
  * `staleness.showBadge` is set.
@@ -11,5 +14,5 @@ interface StalenessBadgeProps {
11
14
  * is pixel-identical across families. The badge sits above the canvas and does
12
15
  * not intercept pointer events.
13
16
  */
14
- export declare function StalenessBadge({ isStale, position }: StalenessBadgeProps): import("react").JSX.Element;
17
+ export declare function StalenessBadge({ isStale, position, state, settling, }: StalenessBadgeProps): import("react").JSX.Element;
15
18
  export {};
@@ -10,8 +10,7 @@ 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
+ export { subscribeToCanvasFontInvalidation } from "./fontLoading";
15
14
  /**
16
15
  * Keep a canvas's backing store and CSS box aligned with the frame size.
17
16
  * This is separate from context preparation so an idle interaction layer can
@@ -0,0 +1,4 @@
1
+ /** Empty native load events (including Firefox's initial event) change no metrics. */
2
+ export declare function hasLoadedFontFaces(event: Event): boolean;
3
+ /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
4
+ export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
@@ -37,6 +37,14 @@ export interface NetworkLayoutSelection {
37
37
  * rects, lines, beziers — and optional labels/overlays. The frame still
38
38
  * owns hit testing, decay, accessibility, and SSR.
39
39
  *
40
+ * Bounded client mounts ingest data before invoking the layout. The retained
41
+ * scene is reused while data, plot dimensions, layout/config identity, theme,
42
+ * and geometry-driving selection are unchanged. A measured container can
43
+ * require a second call at its measured size. Treat inputs as immutable;
44
+ * replace changed data/config references. `ref.relayout()` forces a fresh
45
+ * call, and failed calls remain retriable. Empty push-mode frames may invoke
46
+ * the layout for decorations. SSR and client hydration execute separately.
47
+ *
40
48
  * Mirrors the XY `CustomLayout` pattern. Reach for it when the catalog
41
49
  * (force, sankey, chord, tree, treemap, circle-pack, orbit) doesn't fit
42
50
  * — e.g. `d3-flextree`, `dagre`, custom radial layouts.
@@ -0,0 +1,12 @@
1
+ import type { NetworkPipelineConfig } from "./networkTypes";
2
+ import type { CustomLayoutSelection } from "./customLayoutSelection";
3
+ /** One successful input state per store; failures remain retriable. */
4
+ export declare class NetworkCustomLayoutCache {
5
+ private restyle;
6
+ private key;
7
+ private pending;
8
+ constructor(restyle: (selection: CustomLayoutSelection | null) => void);
9
+ reuse(config: NetworkPipelineConfig, size: [number, number], dataRevision: number, layoutVersion: number, hasRestyle: boolean): boolean;
10
+ commit(): void;
11
+ clear(): void;
12
+ }
@@ -13,10 +13,3 @@ export type NetworkPipelineConfigSources = Pick<StreamNetworkFrameProps, "chartT
13
13
  currentTheme: SemioticTheme | null | undefined;
14
14
  };
15
15
  export declare function buildNetworkPipelineConfig(sources: NetworkPipelineConfigSources): NetworkPipelineConfig;
16
- /** Fields that force re-ingest / re-layout when changed. */
17
- export type NetworkLayoutConfigSignature = Pick<NetworkPipelineConfigSources, "chartType" | "nodeIDAccessor" | "sourceAccessor" | "targetAccessor" | "valueAccessor" | "edgeIdAccessor" | "childrenAccessor" | "hierarchySum" | "orientation" | "nodeAlign" | "nodePaddingRatio" | "nodeWidth" | "iterations" | "forceStrength" | "padAngle" | "groupWidth" | "sortGroups" | "edgeSort" | "treeOrientation" | "edgeType" | "padding" | "paddingTop" | "random" | "seed" | "tensionConfig" | "customNetworkLayout"> & {
18
- orbitMode?: NetworkPipelineConfigSources["orbitMode"];
19
- orbitSize?: NetworkPipelineConfigSources["orbitSize"];
20
- orbitEccentricity?: NetworkPipelineConfigSources["orbitEccentricity"];
21
- };
22
- export declare function buildNetworkLayoutConfigSignature(sources: NetworkLayoutConfigSignature): Record<string, unknown>;
@@ -7,6 +7,8 @@ import type { PhysicsBodyState } from "./PhysicsKernel";
7
7
  import type { PhysicsSimulationState } from "./PhysicsPipelineStore";
8
8
  import type { PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
9
9
  export declare const SR_ONLY_STYLE: React.CSSProperties;
10
+ /** Announce hover or focus once, outside the frame's atomic role="img". */
11
+ export declare function renderPhysicsAnnouncements(items: PhysicsSemanticItem[], focusedSemanticItem: PhysicsSemanticItem | null, hoverData: PhysicsHoverData | null, liveRegionId: string): React.JSX.Element;
10
12
  declare function physicsHoverData(body: PhysicsBodyState): PhysicsHoverData;
11
13
  declare function createBodySemanticItems(bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"], limit: number): PhysicsSemanticItem[];
12
14
  declare function semanticItemsChanged(previous: readonly PhysicsSemanticItem[], next: readonly PhysicsSemanticItem[]): boolean;
@@ -6,11 +6,13 @@ import type { PhysicsHoverData, StreamPhysicsFrameProps } from "./StreamPhysicsT
6
6
  import type { PhysicsFrameObservationPayload } from "./physicsFrameObservations";
7
7
  type PhysicsFrameObservationEmitter = (type: "hover", payload: PhysicsFrameObservationPayload) => void;
8
8
  interface PhysicsCanvasPointerOptions {
9
+ resolveSemanticBody?: (body: PhysicsBodyState) => PhysicsBodyState;
9
10
  canvasRef: React.RefObject<HTMLCanvasElement | null>;
10
11
  clearHover: () => void;
11
12
  emitObservation: PhysicsFrameObservationEmitter;
12
13
  enableHover: boolean;
13
14
  hoverRadius: number;
15
+ hoverDataRef: React.MutableRefObject<PhysicsHoverData | null>;
14
16
  onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
15
17
  setHoverData: React.Dispatch<React.SetStateAction<PhysicsHoverData | null>>;
16
18
  storeRef: React.RefObject<PhysicsPipelineStore | null>;
@@ -22,7 +24,7 @@ export interface PhysicsBodyCursorCollection {
22
24
  }
23
25
  declare function collectPhysicsBodyCursor(collection: PhysicsBodyCursorCollection, body: PhysicsBodyState, style: Style, customRenderer: boolean): void;
24
26
  /** Owns canvas hit-testing that is shared by physics hover and authored cursors. */
25
- export declare function usePhysicsCanvasPointer({ canvasRef, clearHover, emitObservation, enableHover, hoverRadius, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
27
+ export declare function usePhysicsCanvasPointer({ resolveSemanticBody, canvasRef, clearHover, emitObservation, enableHover, hoverRadius, hoverDataRef, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
26
28
  begin: () => PhysicsBodyCursorCollection;
27
29
  collect: typeof collectPhysicsBodyCursor;
28
30
  handlePointerLeave: (event: React.PointerEvent<HTMLCanvasElement>) => void;
@@ -21,11 +21,13 @@ interface PhysicsSemanticNavigationOptions {
21
21
  storeRef: MutableRefObject<PhysicsPipelineStore | null>;
22
22
  }
23
23
  export interface PhysicsSemanticNavigationResult {
24
+ resolveSemanticBody: (body: PhysicsBodyState) => PhysicsBodyState;
24
25
  clearHover: () => void;
25
26
  focusedBodyIdRef: MutableRefObject<string | null>;
26
27
  focusedSemanticItem: PhysicsSemanticItem | null;
27
28
  handleCanvasPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
28
29
  hoverData: PhysicsHoverData | null;
30
+ hoverDataRef: MutableRefObject<PhysicsHoverData | null>;
29
31
  onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
30
32
  setFocusedSemanticItem: Dispatch<SetStateAction<PhysicsSemanticItem | null>>;
31
33
  setHoverData: Dispatch<SetStateAction<PhysicsHoverData | null>>;
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Identity-keyed line/area path interpolation for XY transitions.
3
+ *
4
+ * Path vertices join by pointIdAccessor (or unique streaming x) so a sliding
5
+ * window slides retained points instead of interpolating by array index.
6
+ */
7
+ import type { AreaSceneNode, LineSceneNode, SceneNode } from "./types";
8
+ import type { PrevPath, TransitionContext } from "./pipelineTransitionTypes";
9
+ export declare function copyPathPoint(point: [number, number]): [number, number];
10
+ /**
11
+ * Align previous path vertices to the next path by identity key.
12
+ *
13
+ * Retained keys keep their previous coordinates so a sliding window slides
14
+ * instead of interpolating vertex i → vertex i. Newly entered keys grow from
15
+ * the nearest already-matched neighbor (the window boundary).
16
+ */
17
+ export declare function joinPathByIdentity(prevPath: [number, number][], prevIds: string[], nextPath: [number, number][], nextIds: string[]): {
18
+ prev: [number, number][];
19
+ target: [number, number][];
20
+ };
21
+ export declare function resolvePathIds(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, pathLength: number): string[] | undefined;
22
+ export declare function snapshotPathNode(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, key: string, prevPathMap: Map<string, PrevPath>): void;
23
+ /** Set up line/area path interpolation. Returns whether the path changed. */
24
+ export declare function startPathTransition(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, prevPath: PrevPath | undefined, matchedPrevPathKeys: Set<string>, key: string): boolean;
25
+ export declare function collectExitPathNodes(prevPathMap: Map<string, PrevPath>, matchedPrevPathKeys: Set<string>): SceneNode[];
26
+ export declare function advancePathNode(node: LineSceneNode | AreaSceneNode, t: number): void;
27
+ export declare function snapPathNode(node: LineSceneNode | AreaSceneNode): void;
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Shared types for XY pipeline transitions.
3
+ *
4
+ * Kept separate from the discrete-mark orchestrator and the line/area path
5
+ * join so those modules can import without a cycle.
6
+ */
7
+ import type { GlyphDef } from "./glyphDef";
8
+ import type { SceneNode } from "./types";
9
+ import type { Datum } from "../charts/shared/datumTypes";
10
+ import type { ActiveTransition } from "./pipelineTransitionUtils";
11
+ export type PrevPosition = {
12
+ x: number;
13
+ y: number;
14
+ w?: number;
15
+ h?: number;
16
+ r?: number;
17
+ opacity?: number;
18
+ openY?: number;
19
+ closeY?: number;
20
+ highY?: number;
21
+ lowY?: number;
22
+ glyph?: GlyphDef;
23
+ };
24
+ export type PrevPath = {
25
+ topPath?: [number, number][];
26
+ bottomPath?: [number, number][];
27
+ path?: [number, number][];
28
+ pathIds?: string[];
29
+ opacity?: number;
30
+ };
31
+ /** Context needed from PipelineStore for identity resolution */
32
+ export interface TransitionContext {
33
+ runtimeMode?: "streaming" | "bounded";
34
+ getX: (d: Datum) => number;
35
+ getY: (d: Datum) => number;
36
+ getCategory?: (d: Datum) => string;
37
+ getPointId?: (d: Datum) => string;
38
+ }
39
+ export interface TransitionState {
40
+ scene: SceneNode[];
41
+ exitNodes: SceneNode[];
42
+ activeTransition: ActiveTransition | null;
43
+ }
@@ -7,39 +7,14 @@
7
7
  * - startTransition: sets up interpolation from old→new positions
8
8
  * - advanceTransition: per-frame tick with easing
9
9
  *
10
- * Dependencies: pipelineTransitionUtils (lerp, easing, ActiveTransition)
10
+ * Line/area path join lives in pipelinePathJoin.ts.
11
11
  * Consumed by: PipelineStore.computeScene (after decay/pulse)
12
12
  */
13
13
  import type { SceneNode, TransitionConfig, Style } from "./types";
14
- import type { GlyphDef } from "./glyphDef";
15
- import type { ActiveTransition } from "./pipelineTransitionUtils";
16
- import type { Datum } from "../charts/shared/datumTypes";
17
- export type PrevPosition = {
18
- x: number;
19
- y: number;
20
- w?: number;
21
- h?: number;
22
- r?: number;
23
- opacity?: number;
24
- openY?: number;
25
- closeY?: number;
26
- highY?: number;
27
- lowY?: number;
28
- glyph?: GlyphDef;
29
- };
30
- export type PrevPath = {
31
- topPath?: [number, number][];
32
- bottomPath?: [number, number][];
33
- path?: [number, number][];
34
- opacity?: number;
35
- };
36
- /** Context needed from PipelineStore for identity resolution */
37
- export interface TransitionContext {
38
- runtimeMode?: "streaming" | "bounded";
39
- getX: (d: Datum) => number;
40
- getY: (d: Datum) => number;
41
- getCategory?: (d: Datum) => string;
42
- }
14
+ import { joinPathByIdentity } from "./pipelinePathJoin";
15
+ import type { PrevPath, PrevPosition, TransitionContext, TransitionState } from "./pipelineTransitionTypes";
16
+ export type { PrevPath, PrevPosition, TransitionContext, TransitionState };
17
+ export { joinPathByIdentity };
43
18
  /**
44
19
  * Get a stable identity key for a scene node.
45
20
  *
@@ -69,11 +44,6 @@ export declare function resolveMarkOpacity(style?: Style | null): number;
69
44
  * Snapshot current scene node positions before rebuild.
70
45
  */
71
46
  export declare function snapshotPositions(ctx: TransitionContext, scene: SceneNode[], prevPositionMap: Map<string, PrevPosition>, prevPathMap: Map<string, PrevPath>): void;
72
- export interface TransitionState {
73
- scene: SceneNode[];
74
- exitNodes: SceneNode[];
75
- activeTransition: ActiveTransition | null;
76
- }
77
47
  /**
78
48
  * After scene rebuild, set up transition from old to new positions.
79
49
  * Detects entering nodes (new, no prev match) and exiting nodes (prev, no new match).
@@ -5,9 +5,10 @@ import type { StreamScales } from "./types";
5
5
  * Lines, areas, and ribbons must share this invariant: datum[i] describes the
6
6
  * same observation as path[i], including with descending scales.
7
7
  */
8
- export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number): {
8
+ export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number, getPointId?: (d: Datum) => string): {
9
9
  topPath: [number, number][];
10
10
  bottomPath: [number, number][];
11
11
  rawValues: number[];
12
12
  datum: Datum[];
13
+ pathIds?: string[];
13
14
  };
@@ -0,0 +1,2 @@
1
+ /** Shared pure equality for frame configs and retained custom-layout inputs. */
2
+ export declare function shallowEqualTwoLevel(a: unknown, b: unknown): boolean;
@@ -21,7 +21,16 @@ export interface TransitionConfig {
21
21
  /** Easing function (default: "ease-out") */
22
22
  easing?: "ease-out" | "linear";
23
23
  }
24
+ export type SourceLiveness = "live" | "stale" | "stopped" | "failed" | "settling";
24
25
  export interface StalenessConfig {
26
+ /**
27
+ * Override the ingest-age derivation. A stopped or failed source should
28
+ * read "Stopped" / "Failed", not "Stale". A retract stream can pass
29
+ * `"settling"` (or `settling: true`) while changelog ops are coalescing.
30
+ */
31
+ state?: SourceLiveness;
32
+ /** Retract stream is still coalescing. Equivalent to `state: "settling"`. */
33
+ settling?: boolean;
25
34
  /**
26
35
  * ms without data before "stale" (default: 5000). In graded mode this
27
36
  * is the base TTL the lifecycle bands are measured against — `aging`
@@ -18,7 +18,7 @@ export type { SceneRenderBackend, SceneRenderMode } from "./sceneRenderBackendTy
18
18
  export type { ThemeSemanticColors } from "./streamThemeTypes";
19
19
  export type { AxisTickFormat, AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
20
20
  import type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
21
- export type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
21
+ export type { DecayConfig, PulseConfig, SourceLiveness, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
22
22
  export type SceneDatum = Datum | null;
23
23
  export type SeriesDatum = Datum[] | null;
24
24
  export type MarginalType = "histogram" | "violin" | "ridgeline" | "boxplot";
@@ -111,6 +111,12 @@ export interface LineSceneNode {
111
111
  strokeGradient?: GradientConfig;
112
112
  /** Curve interpolation type (default: linear / straight segments) */
113
113
  curve?: CurveType;
114
+ /**
115
+ * Per-vertex identity keys from `pointIdAccessor`, parallel to `path`.
116
+ * Path transitions join by these keys so a sliding window slides retained
117
+ * vertices instead of interpolating by array index.
118
+ */
119
+ pathIds?: string[];
114
120
  /** Per-vertex decay opacities (oldest→newest = minOpacity→1.0). Set by PipelineStore.applyDecay. */
115
121
  _decayOpacities?: number[];
116
122
  /** Animation target opacity (set during enter/exit transitions) */
@@ -170,6 +176,12 @@ export interface AreaSceneNode {
170
176
  _pulseColor?: string;
171
177
  /** Curve interpolation type (default: linear / straight segments) */
172
178
  curve?: CurveType;
179
+ /**
180
+ * Per-vertex identity keys from `pointIdAccessor`, parallel to `topPath` /
181
+ * `bottomPath`. Path transitions join by these keys so a sliding window
182
+ * slides retained vertices instead of interpolating by array index.
183
+ */
184
+ pathIds?: string[];
173
185
  /** Per-vertex decay opacities (oldest→newest = minOpacity→1.0). Set by PipelineStore.applyDecay. */
174
186
  _decayOpacities?: number[];
175
187
  /** Animation target opacity (set during enter/exit transitions) */
@@ -644,6 +656,14 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
644
656
  arrowOfTime?: ArrowOfTime;
645
657
  windowMode?: WindowMode;
646
658
  windowSize?: number;
659
+ /**
660
+ * Ring-buffer capacity. Alias for `windowSize` — prefer this name when
661
+ * talking to a Kafka Streams / Flink audience, where "window" means the
662
+ * aggregation window (`aggregate.window`), not the eviction policy.
663
+ */
664
+ capacity?: number;
665
+ /** Alias for `windowMode`. */
666
+ capacityMode?: WindowMode;
647
667
  timeAccessor?: string | ((d: T) => number);
648
668
  xScaleType?: "linear" | "log" | "time";
649
669
  yScaleType?: "linear" | "log" | "symlog";
@@ -733,7 +753,10 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
733
753
  x: [number, number];
734
754
  y: [number, number];
735
755
  } | null) => void;
736
- /** Accessor for unique point IDs used by point-anchored annotations */
756
+ /**
757
+ * Accessor for unique point IDs used by point-anchored annotations,
758
+ * push-mode remove()/update(), and identity-keyed line/area path transitions.
759
+ */
737
760
  pointIdAccessor?: string | ((d: T) => string);
738
761
  annotations?: Datum[];
739
762
  autoPlaceAnnotations?: AutoPlaceAnnotations;
@@ -1,4 +1,4 @@
1
- import { type MutableRefObject } from "react";
1
+ import { type MutableRefObject, type RefObject } from "react";
2
2
  import type { StreamChartType } from "./types";
3
3
  /**
4
4
  * Keep LineChart's static graph free of candlestick/heatmap/bar, while
@@ -15,4 +15,6 @@ import type { StreamChartType } from "./types";
15
15
  * transition/restyle/pulse/resolution change). `scheduleRender` alone
16
16
  * after the first frame is not enough.
17
17
  */
18
- export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void): void;
18
+ export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void, storeRef: RefObject<{
19
+ markStylePaintPending(): void;
20
+ } | null>): void;
@@ -0,0 +1,15 @@
1
+ import type { LabelBox, LabelFinding } from "./labelPlacement";
2
+ export interface AxisLabelAssessment {
3
+ status: "complete" | "incomplete" | "not-assessed";
4
+ checked: number;
5
+ unsupported: number;
6
+ collisions: number;
7
+ overflows: number;
8
+ findings: LabelFinding[];
9
+ }
10
+ /** Assess painted bounding rectangles; rotated labels use their enclosing box. */
11
+ export declare function assessAxisLabelBoxes(labels: {
12
+ id: string;
13
+ axis: string;
14
+ box: LabelBox;
15
+ }[], bounds: LabelBox, unsupported?: number): AxisLabelAssessment;
@@ -0,0 +1 @@
1
+ export declare function readAxisLabelAssessment(svg: SVGSVGElement): import("./axisLabelAssessment").AxisLabelAssessment;
@@ -0,0 +1,3 @@
1
+ import { type LabelMeasurer } from "./labelMeasurement";
2
+ /** Call after mount; SSR and initial hydration deliberately use estimates. */
3
+ export declare function browserLabelMeasurer(): LabelMeasurer;
@@ -0,0 +1,19 @@
1
+ /** Shared text-metric seam. No DOM work occurs until a caller requests it. */
2
+ export interface LabelFont {
3
+ family: string;
4
+ version: string | number;
5
+ size: number;
6
+ weight: string | number;
7
+ }
8
+ export interface LabelMeasurement {
9
+ width: number;
10
+ height: number;
11
+ ascent: number;
12
+ /** Distance from the painted left edge to the text origin (italic overhang). */
13
+ left?: number;
14
+ source: "measured" | "estimated";
15
+ }
16
+ export type LabelMeasurer = (text: string, font: LabelFont) => LabelMeasurement;
17
+ export declare const estimateLabel: LabelMeasurer;
18
+ /** Cache belongs to the font/renderer session and is bounded for push mode. */
19
+ export declare function cacheLabelMeasurer(measure: LabelMeasurer): LabelMeasurer;
@@ -0,0 +1,71 @@
1
+ import type { LabelMeasurement } from "./labelMeasurement";
2
+ export interface LabelBox {
3
+ x: number;
4
+ y: number;
5
+ width: number;
6
+ height: number;
7
+ }
8
+ export interface LabelCandidate {
9
+ id: string;
10
+ anchor: {
11
+ x: number;
12
+ y: number;
13
+ };
14
+ measurement: LabelMeasurement;
15
+ }
16
+ export type LabelReason = "INVALID_PROJECTION" | "INSUFFICIENT_SPACE" | "TIED_ENDPOINTS" | "LABEL_OMITTED" | "ESTIMATED_METRICS" | "RENDER_FAILURE" | "UNSUPPORTED_GEOMETRY" | "LABEL_COLLISION" | "LABEL_OVERFLOW";
17
+ export interface LabelFinding {
18
+ code: LabelReason;
19
+ count: number;
20
+ labelIds: string[];
21
+ remedy: string;
22
+ }
23
+ export interface LabelDisposition {
24
+ id: string;
25
+ status: "placed" | "omitted";
26
+ reason?: LabelReason;
27
+ box?: LabelBox;
28
+ offset?: {
29
+ x: number;
30
+ y: number;
31
+ };
32
+ connector?: {
33
+ x1: number;
34
+ y1: number;
35
+ x2: number;
36
+ y2: number;
37
+ };
38
+ }
39
+ export interface LabelLayoutEvidence {
40
+ status: "complete" | "incomplete" | "not-assessed";
41
+ requested: number;
42
+ rendered: number;
43
+ displaced: number;
44
+ omitted: number;
45
+ omittedIds: string[];
46
+ displacedIds: string[];
47
+ measurement: {
48
+ measured: number;
49
+ estimated: number;
50
+ };
51
+ collisions: number;
52
+ overflows: number;
53
+ fallback: "accessible-series-list";
54
+ findings: LabelFinding[];
55
+ coverage: {
56
+ directLabels: "assessed";
57
+ axisLabels: "not-assessed";
58
+ };
59
+ }
60
+ export declare const LABEL_REMEDIES: Record<LabelReason, string>;
61
+ /**
62
+ * Vertical rail packing in CSS pixels. Objective: minimum squared vertical
63
+ * movement, preserving anchor order, subject to box gaps and hard bounds.
64
+ * Pool-adjacent-violators solves the transformed isotonic regression in O(n)
65
+ * after sorting. Feasible, already separated labels stay at their anchors.
66
+ * Impossible fits retain labels in anchor/ID order; every loss is explicit.
67
+ */
68
+ export declare function placeLabels(candidates: readonly LabelCandidate[], bounds: LabelBox, side?: "start" | "end", gap?: number): {
69
+ dispositions: LabelDisposition[];
70
+ evidence: LabelLayoutEvidence;
71
+ };
@@ -0,0 +1,6 @@
1
+ import type { AxisLabelAssessment } from "./axisLabelAssessment";
2
+ /** Inspect actual tick nodes after paint, including rotation and edge anchoring. */
3
+ export declare function useAxisLabelAssessment(enabled: boolean, revision: unknown): {
4
+ ref: import("react").RefObject<SVGSVGElement | null>;
5
+ assessment: AxisLabelAssessment;
6
+ };
@@ -0,0 +1,3 @@
1
+ import type { LabelMeasurer } from "./labelMeasurement";
2
+ /** Estimates during hydration; remeasure after mount and whenever fonts load. */
3
+ export declare function useLabelMeasurer(enabled: boolean): LabelMeasurer | undefined;