semiotic 3.10.1 → 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 (346) hide show
  1. package/README.md +67 -62
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/dist/mcp-server.js +25 -24
  4. package/ai/examples.md +28 -0
  5. package/ai/reference.md +6 -1
  6. package/ai/schema.json +121 -5
  7. package/ai/surface-manifest.json +3 -2
  8. package/ai/task-packets/compare-category-totals.json +7 -53
  9. package/ai/task-packets/compare-category-totals.md +4 -4
  10. package/ai/task-packets/correct-published-chart.json +7 -53
  11. package/ai/task-packets/correct-published-chart.md +4 -4
  12. package/ai/task-packets/index.json +9 -9
  13. package/ai/task-packets/update-live-chart.json +8 -54
  14. package/ai/task-packets/update-live-chart.md +4 -4
  15. package/dist/c-27DCB5T6.min.js +18 -0
  16. package/dist/c-2MONF2P6.min.js +1 -0
  17. package/dist/c-2TW5H5PD.min.js +1 -0
  18. package/dist/c-3AGX252H.min.js +1 -0
  19. package/dist/c-3B6JZEZT.min.js +1 -0
  20. package/dist/c-3BYZXCX3.min.js +4 -0
  21. package/dist/c-3DIPZJDO.min.js +1 -0
  22. package/dist/c-3FOUMWLR.min.js +1 -0
  23. package/dist/c-3NA6I656.min.js +2 -0
  24. package/dist/c-3OFVBWQY.min.js +1 -0
  25. package/dist/{c-QA3HMQJP.min.js → c-3PFVJFBK.min.js} +1 -1
  26. package/dist/c-3PPO7ZJF.min.js +4 -0
  27. package/dist/c-3YEW2PK6.min.js +1 -0
  28. package/dist/c-4JKDJUYD.min.js +1 -0
  29. package/dist/c-4LKK5YWB.min.js +1 -0
  30. package/dist/c-4MD53L2J.min.js +33 -0
  31. package/dist/c-4V3CD337.min.js +1 -0
  32. package/dist/c-4XLHPQTP.min.js +1 -0
  33. package/dist/c-5NYONM6V.min.js +5 -0
  34. package/dist/c-6IVBV5NO.min.js +1 -0
  35. package/dist/c-6ZU3QVLB.min.js +100 -0
  36. package/dist/c-72CBVNYX.min.js +209 -0
  37. package/dist/c-7APWCEPL.min.js +1 -0
  38. package/dist/c-7ASK4WBF.min.js +1 -0
  39. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  40. package/dist/c-7LY46QUI.min.js +41 -0
  41. package/dist/c-ABMGCCLT.min.js +1 -0
  42. package/dist/c-AINGQGUN.min.js +1 -0
  43. package/dist/c-AKLBQMQF.min.js +391 -0
  44. package/dist/c-AXJ2QI3F.min.js +1 -0
  45. package/dist/c-BQYD7T4E.min.js +1 -0
  46. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  47. package/dist/{c-J6DVC236.min.js → c-C4KIXUWU.min.js} +1 -1
  48. package/dist/c-C4SXYFXL.min.js +1 -0
  49. package/dist/c-CLDCKFBE.min.js +1 -0
  50. package/dist/c-CLJCJSFU.min.js +1 -0
  51. package/dist/c-CLLCX3PT.min.js +2 -0
  52. package/dist/c-ECHBKW7U.min.js +1 -0
  53. package/dist/c-EPJWM2UT.min.js +1 -0
  54. package/dist/c-F2GGJB2S.min.js +31 -0
  55. package/dist/c-FD2BXSRG.min.js +1 -0
  56. package/dist/c-FDUQDCBC.min.js +51 -0
  57. package/dist/c-FOTTQHOO.min.js +1 -0
  58. package/dist/c-FU7A5KSY.min.js +1 -0
  59. package/dist/c-G53AVC42.min.js +113 -0
  60. package/dist/c-GHN6IR4Y.min.js +1 -0
  61. package/dist/c-GSCO3FWL.min.js +1 -0
  62. package/dist/c-GYLOSK7M.min.js +1 -0
  63. package/dist/c-HK4OSLZA.min.js +1 -0
  64. package/dist/c-HLGTD5SJ.min.js +1 -0
  65. package/dist/c-HQ27AHMC.min.js +1 -0
  66. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  67. package/dist/c-IHWZ2C6D.min.js +26 -0
  68. package/dist/c-IIV73MUW.min.js +1 -0
  69. package/dist/c-IPYGNVN6.min.js +116 -0
  70. package/dist/c-JJKRER47.min.js +1 -0
  71. package/dist/c-JO6AYCU4.min.js +1 -0
  72. package/dist/c-JWHPG6S2.min.js +1 -0
  73. package/dist/c-JXVYIXTV.min.js +1 -0
  74. package/dist/c-K2ZIYDI3.min.js +1 -0
  75. package/dist/c-K37JAIWA.min.js +4 -0
  76. package/dist/c-KGROWFT2.min.js +9 -0
  77. package/dist/c-MOP2NGLH.min.js +1 -0
  78. package/dist/c-MTX2AO5S.min.js +1 -0
  79. package/dist/c-N5WT7TXG.min.js +1 -0
  80. package/dist/c-NATWERHZ.min.js +1 -0
  81. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  82. package/dist/c-OVQB75PE.min.js +1 -0
  83. package/dist/c-P3SKRNZN.min.js +1 -0
  84. package/dist/c-P5NXQWIM.min.js +1 -0
  85. package/dist/c-P7BQMVQQ.min.js +1 -0
  86. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  87. package/dist/c-PKY4JFY5.min.js +1 -0
  88. package/dist/c-PQOZPM4G.min.js +1 -0
  89. package/dist/c-PZ3NEGNG.min.js +1 -0
  90. package/dist/c-QXLDCATV.min.js +1 -0
  91. package/dist/c-R2HUSWKB.min.js +1 -0
  92. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  93. package/dist/c-RZPP5ERV.min.js +1 -0
  94. package/dist/c-SG2Y7EBY.min.js +46 -0
  95. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  96. package/dist/c-SQNEVNWT.min.js +1 -0
  97. package/dist/c-STHZWF3D.min.js +1 -0
  98. package/dist/c-TIDKVMMZ.min.js +1 -0
  99. package/dist/c-TIMGODBG.min.js +1 -0
  100. package/dist/c-TR7OHUAO.min.js +2 -0
  101. package/dist/c-TTKWXGAI.min.js +61 -0
  102. package/dist/c-TVKZC4BY.min.js +1 -0
  103. package/dist/c-U5XVLSHN.min.js +1 -0
  104. package/dist/c-U6NLVFN4.min.js +1 -0
  105. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  106. package/dist/c-UOPPO26M.min.js +1 -0
  107. package/dist/c-UUDAON4Z.min.js +1 -0
  108. package/dist/c-V32TPPY2.min.js +1 -0
  109. package/dist/c-V5KFJWQQ.min.js +1 -0
  110. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  111. package/dist/c-VXIYF7V2.min.js +1 -0
  112. package/dist/c-Y342FJ6K.min.js +1 -0
  113. package/dist/c-YM6CT4LJ.min.js +1 -0
  114. package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
  115. package/dist/c-YQVOKPKR.min.js +1 -0
  116. package/dist/c-YRJ3BJQZ.min.js +1 -0
  117. package/dist/c-YT5KPVNP.min.js +1 -0
  118. package/dist/components/ai/audienceProfile.d.ts +18 -1
  119. package/dist/components/ai/describeChart.d.ts +5 -1
  120. package/dist/components/ai/intentManifest.d.ts +16 -0
  121. package/dist/components/ai/intentRegistry.d.ts +12 -0
  122. package/dist/components/ai/intents.d.ts +6 -6
  123. package/dist/components/ai/streamSchema.d.ts +19 -0
  124. package/dist/components/ai/streamingTypes.d.ts +57 -11
  125. package/dist/components/ai/suggestCharts.d.ts +1 -1
  126. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  127. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  128. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  129. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  130. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  131. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  132. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  133. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  135. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  136. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  137. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  138. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  139. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  140. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  141. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  142. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  143. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  144. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  145. package/dist/components/charts/shared/knownChartComponents.d.ts +4 -1
  146. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  147. package/dist/components/charts/shared/useChartSetup.d.ts +2 -0
  148. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  149. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  150. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  151. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  152. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  153. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  154. package/dist/components/realtime/HyperLogLog.d.ts +19 -0
  155. package/dist/components/realtime/ReorderBuffer.d.ts +2 -2
  156. package/dist/components/realtime/TDigest.d.ts +22 -0
  157. package/dist/components/realtime/WindowAccumulator.d.ts +22 -5
  158. package/dist/components/realtime/applyChangelog.d.ts +38 -0
  159. package/dist/components/realtime/minHeap.d.ts +3 -0
  160. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +1 -1
  161. package/dist/components/recipes/layout1d.d.ts +2 -20
  162. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  163. package/dist/components/semiotic-ai-core.d.ts +8 -3
  164. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  165. package/dist/components/semiotic-ai.d.ts +4 -6
  166. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  167. package/dist/components/semiotic-stream-types.d.ts +14 -0
  168. package/dist/components/semiotic-xy.d.ts +1 -0
  169. package/dist/components/semiotic.d.ts +3 -11
  170. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  171. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  172. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  173. package/dist/components/server/renderEvidence.d.ts +4 -0
  174. package/dist/components/server/serverChartConfigs.d.ts +5 -0
  175. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  176. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  177. package/dist/components/server/staticAnnotations.d.ts +9 -0
  178. package/dist/components/stream/SceneGraph.d.ts +3 -3
  179. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  180. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  181. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  182. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  183. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  184. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  185. package/dist/components/stream/types.d.ts +25 -2
  186. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  187. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  188. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  189. package/dist/components/text/labelMeasurement.d.ts +19 -0
  190. package/dist/components/text/labelPlacement.d.ts +71 -0
  191. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  192. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  193. package/dist/controls.module.min.js +71 -1
  194. package/dist/geo.min.js +231 -1
  195. package/dist/geo.module.min.js +31 -1
  196. package/dist/network.module.min.js +1 -1
  197. package/dist/ordinal.module.min.js +1 -1
  198. package/dist/physics-matter.module.min.js +1 -1
  199. package/dist/physics-rapier.module.min.js +1 -1
  200. package/dist/physics.module.min.js +1 -1
  201. package/dist/rough.min.js +2 -1
  202. package/dist/rough.module.min.js +2 -1
  203. package/dist/semiotic-access.module.min.js +1 -1
  204. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  205. package/dist/semiotic-ai-core.d.ts +8 -3
  206. package/dist/semiotic-ai-core.min.js +4 -1
  207. package/dist/semiotic-ai-core.module.min.js +4 -1
  208. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  209. package/dist/semiotic-ai.d.ts +4 -6
  210. package/dist/semiotic-ai.module.min.js +14 -1
  211. package/dist/semiotic-artifact-react.min.js +269 -1
  212. package/dist/semiotic-artifact-react.module.min.js +137 -1
  213. package/dist/semiotic-artifact.min.js +3 -1
  214. package/dist/semiotic-artifact.module.min.js +3 -1
  215. package/dist/semiotic-atlas-core.min.js +2 -1
  216. package/dist/semiotic-atlas-core.module.min.js +1 -1
  217. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  218. package/dist/semiotic-atlas.module.min.js +11 -1
  219. package/dist/semiotic-client-cjs-shared.min.js +1529 -1
  220. package/dist/semiotic-client-glyph.module.min.js +3 -1
  221. package/dist/semiotic-client-responsive.module.min.js +1 -1
  222. package/dist/semiotic-client-shared.module.min.js +1 -1
  223. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  224. package/dist/semiotic-data.min.js +1 -1
  225. package/dist/semiotic-data.module.min.js +1 -1
  226. package/dist/semiotic-evidence.min.js +3 -1
  227. package/dist/semiotic-evidence.module.min.js +3 -1
  228. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  229. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  230. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  231. package/dist/semiotic-experimental-vacp.min.js +1 -1
  232. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  233. package/dist/semiotic-line.module.min.js +1 -1
  234. package/dist/semiotic-realtime-core.d.ts +6 -2
  235. package/dist/semiotic-realtime-core.module.min.js +1 -1
  236. package/dist/semiotic-realtime-react.module.min.js +1 -1
  237. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  238. package/dist/semiotic-recipes-core.module.min.js +72 -1
  239. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  240. package/dist/semiotic-recipes-react.min.js +3 -1
  241. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  242. package/dist/semiotic-server-edge.min.js +651 -1
  243. package/dist/semiotic-server-edge.module.min.js +372 -1
  244. package/dist/semiotic-server-node.min.js +651 -1
  245. package/dist/semiotic-server-node.module.min.js +1 -1
  246. package/dist/semiotic-text.min.js +1 -1
  247. package/dist/semiotic-text.module.min.js +1 -1
  248. package/dist/semiotic-themes-core.min.js +1 -1
  249. package/dist/semiotic-themes-core.module.min.js +1 -1
  250. package/dist/semiotic-themes.min.js +1 -1
  251. package/dist/semiotic-themes.module.min.js +1 -1
  252. package/dist/semiotic-utils-core.min.js +11 -1
  253. package/dist/semiotic-utils-core.module.min.js +8 -1
  254. package/dist/semiotic-value.module.min.js +15 -1
  255. package/dist/semiotic-xy.d.ts +1 -0
  256. package/dist/semiotic.d.ts +3 -11
  257. package/dist/semiotic.module.min.js +10 -1
  258. package/dist/server.min.js +651 -1
  259. package/dist/server.module.min.js +1 -1
  260. package/dist/xy.module.min.js +1 -1
  261. package/package.json +4 -3
  262. package/dist/c-2N7IU2NY.min.js +0 -1
  263. package/dist/c-2RL2QPZJ.min.js +0 -1
  264. package/dist/c-2WK7YJLL.min.js +0 -1
  265. package/dist/c-45CQWZZ6.min.js +0 -1
  266. package/dist/c-4BRHKVKV.min.js +0 -1
  267. package/dist/c-7242NXSG.min.js +0 -1
  268. package/dist/c-7DVPSB5C.min.js +0 -1
  269. package/dist/c-7EGHJU2F.min.js +0 -1
  270. package/dist/c-A7OGOFSL.min.js +0 -1
  271. package/dist/c-AFBSWT77.min.js +0 -1
  272. package/dist/c-AH5HWZWS.min.js +0 -1
  273. package/dist/c-AJ7EC32V.min.js +0 -1
  274. package/dist/c-AQADQNY7.min.js +0 -1
  275. package/dist/c-ATM475SA.min.js +0 -1
  276. package/dist/c-AVO3Q7T7.min.js +0 -1
  277. package/dist/c-B7GW7IHJ.min.js +0 -1
  278. package/dist/c-BNFJMDHN.min.js +0 -1
  279. package/dist/c-BOHCQILI.min.js +0 -1
  280. package/dist/c-C3TZLTZK.min.js +0 -1
  281. package/dist/c-CGQAQWBV.min.js +0 -1
  282. package/dist/c-CPV4N35K.min.js +0 -1
  283. package/dist/c-DIPEYUOW.min.js +0 -1
  284. package/dist/c-E4JDJH4I.min.js +0 -1
  285. package/dist/c-E72OTUZU.min.js +0 -1
  286. package/dist/c-E7I2L7CU.min.js +0 -1
  287. package/dist/c-ELDWAO2V.min.js +0 -1
  288. package/dist/c-EUBTECGM.min.js +0 -1
  289. package/dist/c-EUMPMDCS.min.js +0 -1
  290. package/dist/c-EZZT2WAE.min.js +0 -1
  291. package/dist/c-FHBVFCQB.min.js +0 -1
  292. package/dist/c-G4HCO2IQ.min.js +0 -1
  293. package/dist/c-G5VIJEOK.min.js +0 -1
  294. package/dist/c-GHVOXAYH.min.js +0 -1
  295. package/dist/c-GXV3C3MO.min.js +0 -1
  296. package/dist/c-HHTK2R75.min.js +0 -1
  297. package/dist/c-HLLFJYTY.min.js +0 -1
  298. package/dist/c-HP4ZFM47.min.js +0 -1
  299. package/dist/c-HPOYKCCG.min.js +0 -1
  300. package/dist/c-HYDTS5OP.min.js +0 -1
  301. package/dist/c-I4QJ6YLM.min.js +0 -1
  302. package/dist/c-IK33LNZ6.min.js +0 -1
  303. package/dist/c-IK3PZHRY.min.js +0 -1
  304. package/dist/c-JIMJF6F6.min.js +0 -1
  305. package/dist/c-JUKIWTBJ.min.js +0 -1
  306. package/dist/c-KKPMHAZC.min.js +0 -1
  307. package/dist/c-L6WNDBHV.min.js +0 -1
  308. package/dist/c-LDEX5OFW.min.js +0 -1
  309. package/dist/c-LESEUVC5.min.js +0 -1
  310. package/dist/c-LYQMZMZQ.min.js +0 -1
  311. package/dist/c-MB6CV5NC.min.js +0 -1
  312. package/dist/c-MOKJOIPE.min.js +0 -1
  313. package/dist/c-N3FXLRNT.min.js +0 -1
  314. package/dist/c-N5NPTJVJ.min.js +0 -1
  315. package/dist/c-NHBL4J67.min.js +0 -1
  316. package/dist/c-ODG6TFSY.min.js +0 -1
  317. package/dist/c-PRIKOLTE.min.js +0 -1
  318. package/dist/c-PSKKFZNP.min.js +0 -1
  319. package/dist/c-PSNI6KAZ.min.js +0 -1
  320. package/dist/c-QAVFOEUY.min.js +0 -1
  321. package/dist/c-R2P4RR7Q.min.js +0 -1
  322. package/dist/c-RFC7UAG7.min.js +0 -1
  323. package/dist/c-S3AZX5PP.min.js +0 -1
  324. package/dist/c-SGAURYHG.min.js +0 -1
  325. package/dist/c-SJMWU6UX.min.js +0 -1
  326. package/dist/c-STIIGQOD.min.js +0 -1
  327. package/dist/c-T2ASIJVZ.min.js +0 -1
  328. package/dist/c-T2V7O2LO.min.js +0 -1
  329. package/dist/c-TKG2NP7G.min.js +0 -1
  330. package/dist/c-TX3THUTO.min.js +0 -1
  331. package/dist/c-TX7XJM3Z.min.js +0 -1
  332. package/dist/c-UC7SIU2W.min.js +0 -1
  333. package/dist/c-UMXSJIOV.min.js +0 -1
  334. package/dist/c-VRSXMLYF.min.js +0 -1
  335. package/dist/c-VSLWSAN2.min.js +0 -1
  336. package/dist/c-VXLOLYTO.min.js +0 -1
  337. package/dist/c-W4ZUKSEQ.min.js +0 -1
  338. package/dist/c-WCBRPILW.min.js +0 -1
  339. package/dist/c-WGHT7OCY.min.js +0 -1
  340. package/dist/c-WWCW3APR.min.js +0 -1
  341. package/dist/c-XSB27XPS.min.js +0 -1
  342. package/dist/c-Y6PYUMFU.min.js +0 -1
  343. package/dist/c-YDECTEUW.min.js +0 -1
  344. package/dist/c-YF3YKVQI.min.js +0 -1
  345. package/dist/c-YLZIV3VS.min.js +0 -1
  346. package/dist/c-ZIVPFTOC.min.js +0 -1
@@ -0,0 +1,175 @@
1
+ import type { CSSProperties, ReactNode } from "react";
2
+ import type { RealtimeFrameHandle } from "../../realtime/types";
3
+ import type { AnnotationContext, ArrowOfTime, DecayConfig, HoverAnnotationConfig, HoverData, PulseConfig, StalenessConfig, TransitionConfig, WindowMode } from "../../stream/types";
4
+ import type { OnObservationCallback } from "../../store/ObservationStore";
5
+ import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
6
+ import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
7
+ import type { ResponsiveRule } from "../shared/responsiveRules";
8
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
9
+ import type { ChartAccessor, ChartMode, LinkedHoverProp, MobileInteractionProp, SelectionConfig } from "../shared/types";
10
+ import type { Datum } from "../shared/datumTypes";
11
+ import type { StyleRule } from "../shared/styleRules";
12
+ import type { PartialMargin } from "../../types/marginType";
13
+ import type { AggregateConfig } from "./aggregate";
14
+ import type { EventTimeConfig } from "./eventTime";
15
+ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
16
+ /**
17
+ * Imperative handle for RealtimeLineChart. It extends the shared realtime
18
+ * handle without changing that cross-chart contract: only this chart exposes
19
+ * event-time tail flushing.
20
+ */
21
+ export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
22
+ /**
23
+ * Release every event still held by `eventTime`, in event-time order.
24
+ * Call this when an input source reaches an asserted end-of-stream or batch
25
+ * boundary. Later newer events remain supported; events older than the
26
+ * flushed frontier follow `latePolicy`.
27
+ */
28
+ flush(): void;
29
+ }
30
+ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
31
+ /** Fit the container width. */
32
+ responsiveWidth?: boolean;
33
+ /** Fit a container with a definite height. */
34
+ responsiveHeight?: boolean;
35
+ /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
36
+ mode?: ChartMode;
37
+ /** Semantic responsive transformations applied before chart-mode defaults. */
38
+ responsiveRules?: ResponsiveRule[];
39
+ /** Phone/mobile contract consumed by audits, recipes, adapters, and agents. */
40
+ mobileSemantics?: MobileVisualizationContract;
41
+ /** Touch-first interaction policy for phone-sized chart slots. */
42
+ mobileInteraction?: MobileInteractionProp;
43
+ /** Chart dimensions as [width, height] */
44
+ size?: [number, number];
45
+ /** Chart width (alternative to size) */
46
+ width?: number;
47
+ /** Chart height (alternative to size) */
48
+ height?: number;
49
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
50
+ maxDevicePixelRatio?: number;
51
+ /** Chart margins */
52
+ margin?: PartialMargin;
53
+ /** CSS class name */
54
+ className?: string;
55
+ onObservation?: OnObservationCallback;
56
+ chartId?: string;
57
+ /** Direction time flows */
58
+ arrowOfTime?: ArrowOfTime;
59
+ /** Data retention strategy */
60
+ windowMode?: WindowMode;
61
+ /** Ring buffer capacity */
62
+ windowSize?: number;
63
+ /**
64
+ * Ring-buffer capacity. Alias for `windowSize` — prefer this name when
65
+ * "window" means the aggregation window (`aggregate.window`).
66
+ */
67
+ capacity?: number;
68
+ /** Alias for `windowMode`. */
69
+ capacityMode?: WindowMode;
70
+ /** Split the line into series. Passed to the frame as `groupAccessor`. */
71
+ seriesAccessor?: ChartAccessor<TDatum, string>;
72
+ /** Controlled data array */
73
+ data?: RealtimeData<TDatum>;
74
+ /** Time value accessor */
75
+ timeAccessor?: ChartAccessor<TDatum, number>;
76
+ /** Value accessor */
77
+ valueAccessor?: ChartAccessor<TDatum, number>;
78
+ /** Fixed time domain */
79
+ timeExtent?: [number, number];
80
+ /** Fixed value domain */
81
+ valueExtent?: [number, number];
82
+ /** Extent padding factor */
83
+ extentPadding?: number;
84
+ /** Line color */
85
+ stroke?: string;
86
+ /** Line width */
87
+ strokeWidth?: number;
88
+ /** Dash pattern (e.g. "4,2") */
89
+ strokeDasharray?: string;
90
+ /** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
91
+ opacity?: number;
92
+ /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
93
+ cursor?: CSSProperties["cursor"];
94
+ /** Ordered data-aware line styling, resolved against the displayed series sample. */
95
+ styleRules?: StyleRule[];
96
+ /** Show canvas-drawn axes */
97
+ showAxes?: boolean;
98
+ /** Background fill color */
99
+ background?: string;
100
+ /** Enable hover interaction */
101
+ enableHover?: boolean | HoverAnnotationConfig;
102
+ /** Custom tooltip renderer */
103
+ tooltipContent?: (d: HoverData) => ReactNode;
104
+ /** Callback on hover */
105
+ onHover?: (d: HoverData | null) => void;
106
+ /** Annotation objects */
107
+ annotations?: Datum[];
108
+ /** Opt into automatic placement for note-like annotations without manual offsets. */
109
+ autoPlaceAnnotations?: AutoPlaceAnnotations;
110
+ /** SVG annotation render function */
111
+ svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
112
+ /** Custom formatter for time axis ticks */
113
+ tickFormatTime?: (value: number) => string;
114
+ /** Custom formatter for value axis ticks */
115
+ tickFormatValue?: (value: number) => string;
116
+ /** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
117
+ tooltip?: RealtimeTooltipProp;
118
+ /** Configurable opacity decay for older data */
119
+ decay?: DecayConfig;
120
+ /** Flash effect on newly inserted data */
121
+ pulse?: PulseConfig;
122
+ /** Frame-level data liveness indicator */
123
+ staleness?: StalenessConfig;
124
+ /** Smooth position interpolation on data change */
125
+ transition?: TransitionConfig;
126
+ /** Enable linked hover selection events for cross-chart highlighting */
127
+ linkedHover?: LinkedHoverProp;
128
+ /** Consume a named selection — dims unselected elements */
129
+ selection?: SelectionConfig;
130
+ /** Show a loading skeleton placeholder */
131
+ loading?: boolean;
132
+ /** Custom content rendered in place of the default skeleton while `loading` is true. */
133
+ loadingContent?: ReactNode | false;
134
+ /** Custom content to render when data is empty. Set to `false` to disable empty state. */
135
+ emptyContent?: ReactNode | false;
136
+ /** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
137
+ emphasis?: "primary" | "secondary";
138
+ /** Show a legend */
139
+ showLegend?: boolean;
140
+ /** Legend position */
141
+ legendPosition?: LegendPosition;
142
+ /** Legend interaction mode */
143
+ legendInteraction?: LegendInteractionMode;
144
+ /**
145
+ * Stable per-point ID for push-mode `remove()`/`update()`, point annotations,
146
+ * and identity-keyed path transitions. With `transition` on a sliding
147
+ * window, retained vertices slide by this ID instead of interpolating by
148
+ * array index.
149
+ */
150
+ pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
151
+ /**
152
+ * Opt-in windowed aggregation over event-time. When set, pushed
153
+ * events are reduced into tumbling/hopping/session windows and the
154
+ * chart draws one mark per window (mean/sum/min/max/count) plus an
155
+ * optional ±σ or min–max band — render cost scales with the number of
156
+ * visible windows, not the arrival rate. This is the **aggregation
157
+ * window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
158
+ * structural window field or either accessor rebuilds the accumulator:
159
+ * controlled `data` is reseeded, while push-only input begins a new epoch
160
+ * because raw events are deliberately not retained.
161
+ */
162
+ aggregate?: AggregateConfig;
163
+ /**
164
+ * Opt-in event-time ingestion. Buffers pushed events for a bounded
165
+ * lateness/grace window and releases them to the chart in event-time
166
+ * order, so out-of-order or merged multi-source streams render
167
+ * monotonically instead of zigzagging. Late events (older than
168
+ * `watermark − lateness`) are dropped or kept per policy and surfaced
169
+ * via `onObservation` as `"late-data"`. Default-off; when unset the
170
+ * push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
171
+ * asserted end-of-stream boundary so the final grace-window events are
172
+ * released in order.
173
+ */
174
+ eventTime?: EventTimeConfig;
175
+ }
@@ -3,7 +3,7 @@ import type { ArrowOfTime, WindowMode, Style, HoverAnnotationConfig, HoverData,
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
4
  import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
- import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
6
+ import type { ChartMode, ChartAccessor, LinkedHoverProp, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
8
8
  import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
@@ -43,6 +43,10 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
43
43
  arrowOfTime?: ArrowOfTime;
44
44
  /** Data retention strategy */
45
45
  windowMode?: WindowMode;
46
+ /** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
47
+ capacity?: number;
48
+ /** Alias for `windowMode`. */
49
+ capacityMode?: WindowMode;
46
50
  /** Ring buffer capacity */
47
51
  windowSize?: number;
48
52
  /** Controlled data array */
@@ -112,10 +116,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
112
116
  /** Declarative tooltip config or the legacy full-HoverData callback. */
113
117
  tooltip?: RealtimeTooltipProp;
114
118
  /** Enable linked hover selection events for cross-chart highlighting */
115
- linkedHover?: boolean | string | {
116
- name?: string;
117
- fields: string[];
118
- };
119
+ linkedHover?: LinkedHoverProp;
119
120
  /** Consume a named selection — dims unselected elements */
120
121
  selection?: SelectionConfig;
121
122
  /** Show a loading skeleton placeholder */
@@ -3,7 +3,7 @@ import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, Annotat
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
4
  import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
- import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
6
+ import type { ChartMode, ChartAccessor, LinkedHoverProp, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
8
8
  import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
@@ -43,6 +43,10 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
43
43
  arrowOfTime?: ArrowOfTime;
44
44
  /** Data retention strategy */
45
45
  windowMode?: WindowMode;
46
+ /** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
47
+ capacity?: number;
48
+ /** Alias for `windowMode`. */
49
+ capacityMode?: WindowMode;
46
50
  /** Ring buffer capacity */
47
51
  windowSize?: number;
48
52
  /** Controlled data array */
@@ -108,10 +112,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
108
112
  /** Declarative tooltip config or the legacy full-HoverData callback. */
109
113
  tooltip?: RealtimeTooltipProp;
110
114
  /** Enable linked hover selection events for cross-chart highlighting */
111
- linkedHover?: boolean | string | {
112
- name?: string;
113
- fields: string[];
114
- };
115
+ linkedHover?: LinkedHoverProp;
115
116
  /** Consume a named selection — dims unselected elements */
116
117
  selection?: SelectionConfig;
117
118
  /** Show a loading skeleton placeholder */
@@ -25,8 +25,18 @@ export interface AggregateConfig {
25
25
  band?: AggregateBand;
26
26
  /** Multiplier for the `stddev` band (drawn as value ± sigma·σ). @default 1 */
27
27
  sigma?: number;
28
- /** Keep at most this many most-recent windows. @default unbounded */
28
+ /** Keep at most this many most-recent windows per series. @default unbounded */
29
29
  retain?: number;
30
+ /**
31
+ * Quantiles to emit per window (e.g. `[0.5, 0.95, 0.99]`). Structural:
32
+ * changing this rebuilds the accumulator (same as `window` / `size`).
33
+ */
34
+ percentiles?: ReadonlyArray<number>;
35
+ /**
36
+ * Track an approximate distinct count per window. Structural: changing
37
+ * this rebuilds the accumulator.
38
+ */
39
+ distinct?: boolean;
30
40
  }
31
41
  export declare const AGG_TIME = "time";
32
42
  export declare const AGG_VALUE = "value";
@@ -23,4 +23,4 @@ import type { Datum } from "../shared/datumTypes";
23
23
  * Replaces the historical `windowSize={data.length}` workaround that
24
24
  * appeared in our own theming docs and likely consumer code.
25
25
  */
26
- export declare function resolveRealtimeWindowSize(windowSizeProp: number | undefined, data: Datum[] | undefined): number;
26
+ export declare function resolveRealtimeWindowSize(windowSizeProp: number | undefined, data: Datum[] | undefined, capacityProp?: number): number;
@@ -0,0 +1,25 @@
1
+ import * as React from "react";
2
+ import type { Datum } from "./datumTypes";
3
+ import { type LabelMeasurer } from "../../text/labelMeasurement";
4
+ import { type LabelLayoutEvidence } from "../../text/labelPlacement";
5
+ export interface DirectLabelLayoutContext {
6
+ width: number;
7
+ height: number;
8
+ margin?: {
9
+ left: number;
10
+ right: number;
11
+ };
12
+ scales: {
13
+ x?: (value: number) => number;
14
+ y?: (value: number) => number;
15
+ } | null;
16
+ fontFamily?: string;
17
+ measure?: LabelMeasurer;
18
+ fontVersion?: number;
19
+ renderLabel?: (annotation: Datum, index: number, defaultNode: React.ReactNode) => React.ReactNode;
20
+ }
21
+ /** Generated labels have their own final render pass; author rules/offsets stay intact. */
22
+ export declare function renderDirectLabels(annotations: readonly Datum[], context: DirectLabelLayoutContext): {
23
+ node: React.ReactNode;
24
+ evidence?: LabelLayoutEvidence;
25
+ };
@@ -0,0 +1,12 @@
1
+ import type { Datum } from "./datumTypes";
2
+ export interface DirectLabelRequest {
3
+ position: "start" | "end";
4
+ fontSize: number;
5
+ colorBy: string | ((d: Datum) => unknown);
6
+ color: (label: string) => string;
7
+ }
8
+ /** Select semantic endpoints by x, across gaps/forecast segments, before projection. */
9
+ export declare function directLabelAnnotations(rows: readonly Datum[], request: DirectLabelRequest, xAccessor?: string | ((d: Datum) => unknown), yAccessor?: string | ((d: Datum) => unknown)): Datum[];
10
+ export declare function expandDirectLabelRequests(annotations: readonly Datum[], rows?: readonly Datum[], xAccessor?: string, yAccessor?: string): Datum[];
11
+ /** Included in the root SVG description so role=img cannot hide fallback identity. */
12
+ export declare function directLabelDescription(annotations?: readonly Datum[]): string;
@@ -3,7 +3,10 @@
3
3
  * Do not edit by hand; run `npm run docs:chart-specs:schema`.
4
4
  *
5
5
  * This compact registry is intentionally separate from validation metadata:
6
- * config serialization only needs chart-name membership.
6
+ * config serialization and accessibility auditing only need chart names
7
+ * and the supported text props, not the entire prop-validation catalog.
7
8
  */
8
9
  export declare const KNOWN_CHART_COMPONENTS: readonly ["MotifBraidChart", "DependencyForestChart", "FlowCircuitChart", "BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "WaterfallChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
9
10
  export declare function isKnownChartComponent(componentName: string): boolean;
11
+ export type AccessibilityTextProp = "title" | "description" | "summary";
12
+ export declare function supportsChartAccessibilityText(componentName: string, prop: AccessibilityTextProp): boolean;
@@ -1,15 +1,3 @@
1
- /**
2
- * Pure LineChart series-feature prep for the SSR / renderChart path.
3
- *
4
- * Mirrors the client HOC orchestration of:
5
- * - `useSeriesFeatures` (forecast / anomaly via `buildForecast`)
6
- * - gapStrategy (break / interpolate / zero)
7
- * - directLabel endpoint annotations
8
- * - segment-aware lineStyle (createSegmentLineStyle)
9
- *
10
- * Client uses lazy dynamic import + React state for these; SSR can call
11
- * the pure statisticalOverlays entry points synchronously.
12
- */
13
1
  import type { Datum } from "./datumTypes";
14
2
  import { type AnomalyConfig, type ForecastConfig } from "./statisticalOverlays";
15
3
  export interface LineSeriesSsrInput {
@@ -105,6 +105,8 @@ export interface ChartSetupResult {
105
105
  data: Array<Datum>;
106
106
  /** Color scale function, or undefined if no colorBy */
107
107
  colorScale: ((v: string) => string) | undefined;
108
+ /** Resolved category colors, including categories discovered in push mode. */
109
+ categoryColorScale: ((v: string) => string) | undefined;
108
110
  /** All unique category values from colorBy */
109
111
  allCategories: string[];
110
112
  /** Legend interaction state (onLegendHover, onLegendClick, highlighted, isolated) */
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const BigNumberStreamCapability: StreamChartCapability;
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const GaugeChartStreamCapability: StreamChartCapability;
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
3
+ import type { StreamXYFrameProps, MarginalGraphicsConfig, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
4
4
  import type { RealtimeFrameHandle } from "../../realtime/types";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
@@ -145,6 +145,9 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
145
145
  * @see https://semiotic.nteract.io/guides/xy-frame
146
146
  */
147
147
  frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
148
+ pulse?: PulseConfig;
149
+ decay?: DecayConfig;
150
+ staleness?: StalenessConfig;
148
151
  }
149
152
  /**
150
153
  * BubbleChart - Visualize three dimensions of data using x, y, and size
@@ -1,6 +1,6 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
- import type { StreamXYFrameProps } from "../../stream/types";
3
+ import type { StreamXYFrameProps, DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
4
4
  import type { RealtimeFrameHandle } from "../../realtime/types";
5
5
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -66,6 +66,9 @@ export interface ConnectedScatterplotProps<TDatum extends Datum = Datum> extends
66
66
  yExtent?: [number | undefined, number | undefined] | [number];
67
67
  /** Additional StreamXYFrame props for advanced customization */
68
68
  frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
69
+ pulse?: PulseConfig;
70
+ decay?: DecayConfig;
71
+ staleness?: StalenessConfig;
69
72
  }
70
73
  /**
71
74
  * ConnectedScatterplot — points connected in sequence by lines.
@@ -167,7 +167,10 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
167
167
  * Tooltip configuration
168
168
  */
169
169
  tooltip?: TooltipProp;
170
- /** Accessor for unique point IDs, used by point-anchored annotations (when showPoints is true) */
170
+ /**
171
+ * Stable per-point ID for annotations, push-mode `remove()`/`update()`, and
172
+ * identity-keyed path transitions when `transition` is enabled.
173
+ */
171
174
  pointIdAccessor?: ChartAccessor<TDatum, string>;
172
175
  /**
173
176
  * Annotation objects to render on the chart
@@ -1,6 +1,7 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
3
  import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
4
+ import type { DecayConfig, PulseConfig, StalenessConfig } from "../../stream/types";
4
5
  import type { SymbolName } from "../../stream/symbolPath";
5
6
  import type { RealtimeFrameHandle } from "../../realtime/types";
6
7
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
@@ -115,6 +116,12 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
115
116
  yExtent?: [number | undefined, number | undefined] | [number];
116
117
  /** Additional StreamXYFrame props for advanced customization */
117
118
  frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
119
+ /** Flash newly inserted or updated points. Also reachable via `frameProps.pulse`. */
120
+ pulse?: PulseConfig;
121
+ /** Fade older points by buffer age. Also reachable via `frameProps.decay`. */
122
+ decay?: DecayConfig;
123
+ /** Frame-level liveness badge and dimming. Also reachable via `frameProps.staleness`. */
124
+ staleness?: StalenessConfig;
118
125
  }
119
126
  /**
120
127
  * Scatterplot - Visualize relationships between two continuous variables.
@@ -0,0 +1,19 @@
1
+ /**
2
+ * HyperLogLog distinct-count sketch. Per-window memory is a fixed
3
+ * register file (default p=10, 1024 registers), so a dashboard can
4
+ * ask "how many distinct customers in this minute?" without retaining ids.
5
+ */
6
+ export declare class HyperLogLog {
7
+ private readonly p;
8
+ private readonly m;
9
+ private readonly registers;
10
+ private readonly alpha;
11
+ private harmonicSum;
12
+ private zeros;
13
+ constructor(p?: number);
14
+ add(value: string | number): void;
15
+ private updateRegister;
16
+ merge(other: HyperLogLog): void;
17
+ clone(): HyperLogLog;
18
+ count(): number;
19
+ }
@@ -2,7 +2,7 @@ export type LatePolicy = "drop" | "keep";
2
2
  export interface ReorderBufferConfig<T> {
3
3
  /** Grace window in ms. Events older than `watermark − lateness` are late. */
4
4
  lateness: number;
5
- /** Event-time accessor (ms). */
5
+ /** Event-time accessor (ms), evaluated once when the event is pushed. */
6
6
  getTime: (item: T) => number;
7
7
  /**
8
8
  * What to do with a late event:
@@ -29,6 +29,7 @@ export declare class ReorderBuffer<T> {
29
29
  private readonly getTime;
30
30
  private readonly latePolicy;
31
31
  private held;
32
+ private nextOrder;
32
33
  private _watermark;
33
34
  private _releasedThrough;
34
35
  private _lateCount;
@@ -45,7 +46,6 @@ export declare class ReorderBuffer<T> {
45
46
  * stream ends and the remaining grace-window events should be shown.
46
47
  */
47
48
  flush(): T[];
48
- private markReleased;
49
49
  clear(): void;
50
50
  /** Largest event-time seen, or `-Infinity` if empty. */
51
51
  get watermark(): number;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Compact t-digest (Dunning) for streaming quantiles.
3
+ *
4
+ * Centroids merge under a size bound that is tight in the tails, so p95 /
5
+ * p99 stay accurate without retaining every observation. `push` and
6
+ * `merge` are the only mutating operations a windowed aggregator needs.
7
+ */
8
+ export declare class TDigest {
9
+ private centroids;
10
+ private total;
11
+ private pending;
12
+ private readonly compression;
13
+ constructor(compression?: number);
14
+ push(value: number): void;
15
+ merge(other: TDigest): void;
16
+ clone(): TDigest;
17
+ /** Quantile in [0, 1], interpolated between centroid centers. Empty returns NaN. */
18
+ quantile(q: number): number;
19
+ get count(): number;
20
+ private compress;
21
+ }
22
+ export declare function percentileKey(q: number): string;
@@ -1,7 +1,7 @@
1
1
  /** The Kafka Streams window taxonomy. */
2
2
  export type WindowType = "tumbling" | "hopping" | "session";
3
3
  /** Which statistic the aggregated series carries as its primary value. */
4
- export type AggregateStat = "mean" | "sum" | "min" | "max" | "count";
4
+ export type AggregateStat = "mean" | "sum" | "min" | "max" | "count" | "p50" | "p95" | "p99" | "distinct";
5
5
  /** Envelope drawn around the aggregated series. */
6
6
  export type AggregateBand = "stddev" | "minmax" | "none";
7
7
  export interface WindowAccumulatorConfig {
@@ -32,6 +32,13 @@ export interface WindowAccumulatorConfig {
32
32
  * unbounded (`Infinity`).
33
33
  */
34
34
  retain?: number;
35
+ /**
36
+ * Quantiles to emit per window (e.g. `[0.5, 0.95, 0.99]`). Opt-in so
37
+ * the default path keeps a cheap `RunningStats` only.
38
+ */
39
+ percentiles?: ReadonlyArray<number>;
40
+ /** Track an approximate distinct count (HyperLogLog) per window. */
41
+ distinct?: boolean;
35
42
  }
36
43
  /** A closed or still-filling aggregation window. */
37
44
  export interface AggregatedWindow {
@@ -54,6 +61,10 @@ export interface AggregatedWindow {
54
61
  * half-filled aggregate as final.
55
62
  */
56
63
  partial: boolean;
64
+ /** Present when `percentiles` was configured. Keys like `p50`, `p95`. */
65
+ percentiles?: Readonly<Record<string, number>>;
66
+ /** Present when `distinct` was configured. */
67
+ distinct?: number;
57
68
  }
58
69
  /**
59
70
  * Accumulates event-time windowed statistics. Stateful and mutable —
@@ -65,12 +76,20 @@ export declare class WindowAccumulator {
65
76
  private readonly hop;
66
77
  private readonly gap;
67
78
  private readonly retain;
79
+ private readonly percentiles;
80
+ private readonly wantDistinct;
68
81
  private windows;
82
+ private starts;
69
83
  private sessions;
70
84
  private latest;
71
85
  constructor(config: WindowAccumulatorConfig);
72
- /** Incorporate one event. Non-finite time/value are ignored. */
73
- push(time: number, value: number): void;
86
+ private newBucket;
87
+ /**
88
+ * Incorporate one event. Non-finite time/value are ignored.
89
+ * `distinctKey` is hashed into the optional HyperLogLog so a latency
90
+ * series can still count distinct customers.
91
+ */
92
+ push(time: number, value: number, distinctKey?: string | number): void;
74
93
  private pushFixed;
75
94
  private bump;
76
95
  private pushSession;
@@ -82,8 +101,6 @@ export declare class WindowAccumulator {
82
101
  * is `partial` while within `gap` of the watermark.
83
102
  */
84
103
  emit(): AggregatedWindow[];
85
- private emitFixed;
86
- private emitSessions;
87
104
  private row;
88
105
  /** Number of live windows (or sessions). */
89
106
  get windowCount(): number;
@@ -0,0 +1,38 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { RealtimeFrameHandle } from "./types";
3
+ export type ChangelogOp<T extends Datum = Datum> = {
4
+ op: "insert" | "upsert";
5
+ row: T;
6
+ id?: string;
7
+ } | {
8
+ op: "update";
9
+ row: T;
10
+ id?: string;
11
+ } | {
12
+ op: "delete" | "retract";
13
+ id?: string;
14
+ row?: T;
15
+ };
16
+ export interface ApplyChangelogOptions<T extends Datum = Datum> {
17
+ /** Identity field or accessor. Must match the chart's `pointIdAccessor`. */
18
+ key: string | ((row: T) => string);
19
+ /** Collapse the batch to the last op per key. Default true. */
20
+ coalesce?: boolean;
21
+ }
22
+ export interface ApplyChangelogResult {
23
+ applied: number;
24
+ upserts: number;
25
+ retracts: number;
26
+ }
27
+ /**
28
+ * Map a Flink / Debezium / Kafka Streams changelog onto a realtime handle.
29
+ *
30
+ * Semantics:
31
+ * • `insert` / `upsert` / `update` — `update` when the id is already in
32
+ * the buffer, otherwise `push`.
33
+ * • `delete` / `retract` — `remove(id)`.
34
+ * • Batches coalesce by key (last op wins) unless `coalesce: false`.
35
+ *
36
+ * The chart must set `pointIdAccessor` to the same identity as `key`.
37
+ */
38
+ export declare function applyChangelog<T extends Datum = Datum>(handle: Pick<RealtimeFrameHandle<T>, "push" | "pushMany" | "update" | "remove" | "getData">, events: ReadonlyArray<ChangelogOp<T>>, options: ApplyChangelogOptions<T>): ApplyChangelogResult;
@@ -0,0 +1,3 @@
1
+ /** Array-backed heap operations shared by event ordering and window eviction. */
2
+ export declare function heapPush<T>(items: T[], item: T, compare: (a: T, b: T) => number): void;
3
+ export declare function heapPop<T>(items: T[], compare: (a: T, b: T) => number): T | undefined;
@@ -62,7 +62,7 @@ export declare function flowCircuitChartProps({ width, height, title, descriptio
62
62
  seriesField?: string;
63
63
  } | undefined;
64
64
  annotations: import("../../stream/networkColorAccessors").Datum[] | undefined;
65
- frameProps: Partial<Omit<import("../../semiotic-experimental").UnstableStreamPhysicsFrameProps, "size" | "initialSpawnPacing" | "config" | "initialSpawns">> | undefined;
65
+ frameProps: Partial<Omit<import("../../semiotic-experimental").UnstableStreamPhysicsFrameProps, "size" | "config" | "initialSpawns" | "initialSpawnPacing">> | undefined;
66
66
  paused: boolean;
67
67
  title: string;
68
68
  description: string;
@@ -4,26 +4,8 @@
4
4
  * callers provide relations, silhouettes, and cost functions while the kit
5
5
  * owns the guarded search and separation invariants.
6
6
  */
7
- export interface MinGapPlacementOptions {
8
- /** Preferred coordinate for each item, in order. */
9
- desired: readonly number[];
10
- /** Minimum distance between item i and i + 1. */
11
- minGaps: readonly number[];
12
- /** Optional least-squares weight per desired coordinate. */
13
- weights?: readonly number[];
14
- /** Optional lower bound for the first coordinate. */
15
- min?: number;
16
- /** Optional upper bound for the last coordinate. */
17
- max?: number;
18
- }
19
- /**
20
- * Least-squares placement with fixed order and per-pair minimum gaps.
21
- *
22
- * The gap constraints are removed with cumulative offsets, then weighted
23
- * isotonic regression (pool-adjacent-violators) solves the remaining
24
- * non-decreasing placement. Bounds apply to the whole ordered sequence.
25
- */
26
- export declare function placeWithMinGap(options: MinGapPlacementOptions): number[];
7
+ export { placeWithMinGap } from "./minGapPlacement";
8
+ export type { MinGapPlacementOptions } from "./minGapPlacement";
27
9
  export interface SilhouetteSample {
28
10
  /** Position along the independent axis (time, layer, or another index). */
29
11
  at: number;