semiotic 3.10.1 → 3.10.3

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 (353) hide show
  1. package/README.md +64 -63
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/behaviorContracts.cjs +1 -1
  4. package/ai/dist/mcp-server.js +25 -24
  5. package/ai/examples.md +28 -0
  6. package/ai/reference.md +9 -4
  7. package/ai/schema.json +121 -5
  8. package/ai/surface-manifest.json +3 -2
  9. package/ai/system-prompt.md +1 -1
  10. package/ai/task-packets/compare-category-totals.json +7 -53
  11. package/ai/task-packets/compare-category-totals.md +4 -4
  12. package/ai/task-packets/correct-published-chart.json +7 -53
  13. package/ai/task-packets/correct-published-chart.md +4 -4
  14. package/ai/task-packets/index.json +9 -9
  15. package/ai/task-packets/update-live-chart.json +8 -54
  16. package/ai/task-packets/update-live-chart.md +4 -4
  17. package/dist/c-27DCB5T6.min.js +18 -0
  18. package/dist/c-2MONF2P6.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-43XNOQNQ.min.js +391 -0
  30. package/dist/c-4JKDJUYD.min.js +1 -0
  31. package/dist/c-4LKK5YWB.min.js +1 -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-5PIKBUMF.min.js +1 -0
  36. package/dist/c-6IVBV5NO.min.js +1 -0
  37. package/dist/c-7APWCEPL.min.js +1 -0
  38. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  39. package/dist/c-ABMGCCLT.min.js +1 -0
  40. package/dist/c-AINGQGUN.min.js +1 -0
  41. package/dist/c-AXJ2QI3F.min.js +1 -0
  42. package/dist/c-BQYD7T4E.min.js +1 -0
  43. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  44. package/dist/c-C4SXYFXL.min.js +1 -0
  45. package/dist/c-CLDCKFBE.min.js +1 -0
  46. package/dist/c-CLJCJSFU.min.js +1 -0
  47. package/dist/c-CLLCX3PT.min.js +2 -0
  48. package/dist/c-CO4NDAD6.min.js +51 -0
  49. package/dist/c-ECHBKW7U.min.js +1 -0
  50. package/dist/c-EPJWM2UT.min.js +1 -0
  51. package/dist/c-FD2BXSRG.min.js +1 -0
  52. package/dist/c-FHNY57SO.min.js +209 -0
  53. package/dist/c-FMCUQ6JX.min.js +1 -0
  54. package/dist/c-FOTTQHOO.min.js +1 -0
  55. package/dist/c-FU7A5KSY.min.js +1 -0
  56. package/dist/c-GHN6IR4Y.min.js +1 -0
  57. package/dist/{c-J6DVC236.min.js → c-GK263BF4.min.js} +1 -1
  58. package/dist/c-GSCO3FWL.min.js +1 -0
  59. package/dist/c-GYLOSK7M.min.js +1 -0
  60. package/dist/c-HK4OSLZA.min.js +1 -0
  61. package/dist/c-HLGTD5SJ.min.js +1 -0
  62. package/dist/c-HNHKIMIV.min.js +61 -0
  63. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  64. package/dist/c-IIV73MUW.min.js +1 -0
  65. package/dist/c-IJCZGUG6.min.js +31 -0
  66. package/dist/c-ISA6IJ6V.min.js +41 -0
  67. package/dist/c-JC76YAHB.min.js +33 -0
  68. package/dist/c-JJKRER47.min.js +1 -0
  69. package/dist/c-JO6AYCU4.min.js +1 -0
  70. package/dist/c-JOPGDP6N.min.js +1 -0
  71. package/dist/c-JWHPG6S2.min.js +1 -0
  72. package/dist/c-JXVYIXTV.min.js +1 -0
  73. package/dist/c-K2ZIYDI3.min.js +1 -0
  74. package/dist/c-K37JAIWA.min.js +4 -0
  75. package/dist/c-KXH7LFIL.min.js +26 -0
  76. package/dist/c-M43PK7K4.min.js +1 -0
  77. package/dist/c-MTX2AO5S.min.js +1 -0
  78. package/dist/c-N5WT7TXG.min.js +1 -0
  79. package/dist/c-NATWERHZ.min.js +1 -0
  80. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  81. package/dist/c-OVQB75PE.min.js +1 -0
  82. package/dist/c-P3SKRNZN.min.js +1 -0
  83. package/dist/c-P5NXQWIM.min.js +1 -0
  84. package/dist/c-P7BQMVQQ.min.js +1 -0
  85. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  86. package/dist/c-PITYSOPK.min.js +1 -0
  87. package/dist/c-QPO24R7Q.min.js +1 -0
  88. package/dist/c-QXLDCATV.min.js +1 -0
  89. package/dist/c-R2HUSWKB.min.js +1 -0
  90. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  91. package/dist/c-RZPP5ERV.min.js +1 -0
  92. package/dist/c-SAP5KY6R.min.js +9 -0
  93. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  94. package/dist/c-SQNEVNWT.min.js +1 -0
  95. package/dist/c-STHZWF3D.min.js +1 -0
  96. package/dist/c-TIDKVMMZ.min.js +1 -0
  97. package/dist/c-TIMGODBG.min.js +1 -0
  98. package/dist/c-TR7OHUAO.min.js +2 -0
  99. package/dist/c-TVKZC4BY.min.js +1 -0
  100. package/dist/c-U5XVLSHN.min.js +1 -0
  101. package/dist/c-U6NLVFN4.min.js +1 -0
  102. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  103. package/dist/c-UMGHCBH5.min.js +114 -0
  104. package/dist/c-UOPPO26M.min.js +1 -0
  105. package/dist/c-UUDAON4Z.min.js +1 -0
  106. package/dist/c-V32TPPY2.min.js +1 -0
  107. package/dist/c-V5KFJWQQ.min.js +1 -0
  108. package/dist/c-VEMCBQZZ.min.js +100 -0
  109. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  110. package/dist/c-WD2RL76M.min.js +116 -0
  111. package/dist/c-Y342FJ6K.min.js +1 -0
  112. package/dist/c-YL7HJL5J.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/c-Z6GRGS53.min.js +1 -0
  119. package/dist/c-ZVOFLE2P.min.js +46 -0
  120. package/dist/components/CategoryColors.d.ts +7 -0
  121. package/dist/components/LinkedCharts.d.ts +2 -1
  122. package/dist/components/ai/audienceProfile.d.ts +18 -1
  123. package/dist/components/ai/describeChart.d.ts +5 -1
  124. package/dist/components/ai/intentManifest.d.ts +16 -0
  125. package/dist/components/ai/intentRegistry.d.ts +12 -0
  126. package/dist/components/ai/intents.d.ts +6 -6
  127. package/dist/components/ai/streamSchema.d.ts +19 -0
  128. package/dist/components/ai/streamingTypes.d.ts +57 -11
  129. package/dist/components/ai/suggestCharts.d.ts +1 -1
  130. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  131. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  132. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  133. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  135. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  136. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  137. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  138. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  139. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  140. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  141. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  142. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  143. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  144. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  145. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  146. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  147. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  148. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  149. package/dist/components/charts/shared/knownChartComponents.d.ts +4 -1
  150. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  151. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  152. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +1 -1
  153. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  154. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  155. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  156. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  157. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  158. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  159. package/dist/components/data/transforms.d.ts +1 -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/flowCircuitChartProps.d.ts +1 -1
  167. package/dist/components/recipes/layout1d.d.ts +2 -20
  168. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  169. package/dist/components/semiotic-ai-core.d.ts +8 -3
  170. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  171. package/dist/components/semiotic-ai.d.ts +4 -6
  172. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  173. package/dist/components/semiotic-stream-types.d.ts +14 -0
  174. package/dist/components/semiotic-xy.d.ts +1 -0
  175. package/dist/components/semiotic.d.ts +3 -11
  176. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  177. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  178. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  179. package/dist/components/server/renderEvidence.d.ts +4 -0
  180. package/dist/components/server/serverChartConfigs.d.ts +5 -0
  181. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  182. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  183. package/dist/components/server/staticAnnotations.d.ts +9 -0
  184. package/dist/components/stream/SceneGraph.d.ts +3 -3
  185. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  186. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  187. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  188. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  189. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  190. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  191. package/dist/components/stream/types.d.ts +25 -2
  192. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  193. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  194. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  195. package/dist/components/text/labelMeasurement.d.ts +19 -0
  196. package/dist/components/text/labelPlacement.d.ts +71 -0
  197. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  198. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  199. package/dist/controls.module.min.js +71 -1
  200. package/dist/geo.min.js +231 -1
  201. package/dist/geo.module.min.js +31 -1
  202. package/dist/network.module.min.js +1 -1
  203. package/dist/ordinal.module.min.js +1 -1
  204. package/dist/physics-matter.module.min.js +1 -1
  205. package/dist/physics-rapier.module.min.js +1 -1
  206. package/dist/physics.module.min.js +1 -1
  207. package/dist/physicsWorker.js +1 -1
  208. package/dist/rough.min.js +2 -1
  209. package/dist/rough.module.min.js +2 -1
  210. package/dist/semiotic-access.module.min.js +1 -1
  211. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  212. package/dist/semiotic-ai-core.d.ts +8 -3
  213. package/dist/semiotic-ai-core.min.js +4 -1
  214. package/dist/semiotic-ai-core.module.min.js +4 -1
  215. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  216. package/dist/semiotic-ai.d.ts +4 -6
  217. package/dist/semiotic-ai.module.min.js +14 -1
  218. package/dist/semiotic-artifact-react.min.js +269 -1
  219. package/dist/semiotic-artifact-react.module.min.js +137 -1
  220. package/dist/semiotic-artifact.min.js +3 -1
  221. package/dist/semiotic-artifact.module.min.js +3 -1
  222. package/dist/semiotic-atlas-core.min.js +2 -1
  223. package/dist/semiotic-atlas-core.module.min.js +1 -1
  224. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  225. package/dist/semiotic-atlas.module.min.js +11 -1
  226. package/dist/semiotic-client-cjs-shared.min.js +1530 -1
  227. package/dist/semiotic-client-glyph.module.min.js +3 -1
  228. package/dist/semiotic-client-responsive.module.min.js +1 -1
  229. package/dist/semiotic-client-shared.module.min.js +1 -1
  230. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  231. package/dist/semiotic-data.min.js +1 -1
  232. package/dist/semiotic-data.module.min.js +1 -1
  233. package/dist/semiotic-evidence.min.js +3 -1
  234. package/dist/semiotic-evidence.module.min.js +3 -1
  235. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  236. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  237. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  238. package/dist/semiotic-experimental-vacp.min.js +1 -1
  239. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  240. package/dist/semiotic-line.module.min.js +1 -1
  241. package/dist/semiotic-realtime-core.d.ts +6 -2
  242. package/dist/semiotic-realtime-core.module.min.js +1 -1
  243. package/dist/semiotic-realtime-react.module.min.js +1 -1
  244. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  245. package/dist/semiotic-recipes-core.module.min.js +72 -1
  246. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  247. package/dist/semiotic-recipes-react.min.js +3 -1
  248. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  249. package/dist/semiotic-server-edge.min.js +651 -1
  250. package/dist/semiotic-server-edge.module.min.js +372 -1
  251. package/dist/semiotic-server-node.min.js +651 -1
  252. package/dist/semiotic-server-node.module.min.js +1 -1
  253. package/dist/semiotic-text.min.js +1 -1
  254. package/dist/semiotic-text.module.min.js +1 -1
  255. package/dist/semiotic-themes-core.min.js +1 -1
  256. package/dist/semiotic-themes-core.module.min.js +1 -1
  257. package/dist/semiotic-themes.min.js +1 -1
  258. package/dist/semiotic-themes.module.min.js +1 -1
  259. package/dist/semiotic-utils-core.min.js +11 -1
  260. package/dist/semiotic-utils-core.module.min.js +8 -1
  261. package/dist/semiotic-value.module.min.js +15 -1
  262. package/dist/semiotic-xy.d.ts +1 -0
  263. package/dist/semiotic.d.ts +3 -11
  264. package/dist/semiotic.module.min.js +10 -1
  265. package/dist/server.min.js +651 -1
  266. package/dist/server.module.min.js +1 -1
  267. package/dist/xy.module.min.js +1 -1
  268. package/package.json +8 -7
  269. package/dist/c-2N7IU2NY.min.js +0 -1
  270. package/dist/c-2RL2QPZJ.min.js +0 -1
  271. package/dist/c-2WK7YJLL.min.js +0 -1
  272. package/dist/c-45CQWZZ6.min.js +0 -1
  273. package/dist/c-4BRHKVKV.min.js +0 -1
  274. package/dist/c-7242NXSG.min.js +0 -1
  275. package/dist/c-7DVPSB5C.min.js +0 -1
  276. package/dist/c-7EGHJU2F.min.js +0 -1
  277. package/dist/c-A7OGOFSL.min.js +0 -1
  278. package/dist/c-AFBSWT77.min.js +0 -1
  279. package/dist/c-AH5HWZWS.min.js +0 -1
  280. package/dist/c-AJ7EC32V.min.js +0 -1
  281. package/dist/c-AQADQNY7.min.js +0 -1
  282. package/dist/c-ATM475SA.min.js +0 -1
  283. package/dist/c-AVO3Q7T7.min.js +0 -1
  284. package/dist/c-B7GW7IHJ.min.js +0 -1
  285. package/dist/c-BNFJMDHN.min.js +0 -1
  286. package/dist/c-BOHCQILI.min.js +0 -1
  287. package/dist/c-C3TZLTZK.min.js +0 -1
  288. package/dist/c-CGQAQWBV.min.js +0 -1
  289. package/dist/c-CPV4N35K.min.js +0 -1
  290. package/dist/c-DIPEYUOW.min.js +0 -1
  291. package/dist/c-E4JDJH4I.min.js +0 -1
  292. package/dist/c-E72OTUZU.min.js +0 -1
  293. package/dist/c-E7I2L7CU.min.js +0 -1
  294. package/dist/c-ELDWAO2V.min.js +0 -1
  295. package/dist/c-EUBTECGM.min.js +0 -1
  296. package/dist/c-EUMPMDCS.min.js +0 -1
  297. package/dist/c-EZZT2WAE.min.js +0 -1
  298. package/dist/c-FHBVFCQB.min.js +0 -1
  299. package/dist/c-G4HCO2IQ.min.js +0 -1
  300. package/dist/c-G5VIJEOK.min.js +0 -1
  301. package/dist/c-GHVOXAYH.min.js +0 -1
  302. package/dist/c-GXV3C3MO.min.js +0 -1
  303. package/dist/c-HHTK2R75.min.js +0 -1
  304. package/dist/c-HLLFJYTY.min.js +0 -1
  305. package/dist/c-HP4ZFM47.min.js +0 -1
  306. package/dist/c-HPOYKCCG.min.js +0 -1
  307. package/dist/c-HYDTS5OP.min.js +0 -1
  308. package/dist/c-I4QJ6YLM.min.js +0 -1
  309. package/dist/c-IK33LNZ6.min.js +0 -1
  310. package/dist/c-IK3PZHRY.min.js +0 -1
  311. package/dist/c-JIMJF6F6.min.js +0 -1
  312. package/dist/c-JUKIWTBJ.min.js +0 -1
  313. package/dist/c-KKPMHAZC.min.js +0 -1
  314. package/dist/c-L6WNDBHV.min.js +0 -1
  315. package/dist/c-LDEX5OFW.min.js +0 -1
  316. package/dist/c-LESEUVC5.min.js +0 -1
  317. package/dist/c-LYQMZMZQ.min.js +0 -1
  318. package/dist/c-MB6CV5NC.min.js +0 -1
  319. package/dist/c-MOKJOIPE.min.js +0 -1
  320. package/dist/c-N3FXLRNT.min.js +0 -1
  321. package/dist/c-N5NPTJVJ.min.js +0 -1
  322. package/dist/c-NHBL4J67.min.js +0 -1
  323. package/dist/c-ODG6TFSY.min.js +0 -1
  324. package/dist/c-PRIKOLTE.min.js +0 -1
  325. package/dist/c-PSKKFZNP.min.js +0 -1
  326. package/dist/c-PSNI6KAZ.min.js +0 -1
  327. package/dist/c-QAVFOEUY.min.js +0 -1
  328. package/dist/c-R2P4RR7Q.min.js +0 -1
  329. package/dist/c-RFC7UAG7.min.js +0 -1
  330. package/dist/c-S3AZX5PP.min.js +0 -1
  331. package/dist/c-SGAURYHG.min.js +0 -1
  332. package/dist/c-SJMWU6UX.min.js +0 -1
  333. package/dist/c-STIIGQOD.min.js +0 -1
  334. package/dist/c-T2ASIJVZ.min.js +0 -1
  335. package/dist/c-T2V7O2LO.min.js +0 -1
  336. package/dist/c-TKG2NP7G.min.js +0 -1
  337. package/dist/c-TX3THUTO.min.js +0 -1
  338. package/dist/c-TX7XJM3Z.min.js +0 -1
  339. package/dist/c-UC7SIU2W.min.js +0 -1
  340. package/dist/c-UMXSJIOV.min.js +0 -1
  341. package/dist/c-VRSXMLYF.min.js +0 -1
  342. package/dist/c-VSLWSAN2.min.js +0 -1
  343. package/dist/c-VXLOLYTO.min.js +0 -1
  344. package/dist/c-W4ZUKSEQ.min.js +0 -1
  345. package/dist/c-WCBRPILW.min.js +0 -1
  346. package/dist/c-WGHT7OCY.min.js +0 -1
  347. package/dist/c-WWCW3APR.min.js +0 -1
  348. package/dist/c-XSB27XPS.min.js +0 -1
  349. package/dist/c-Y6PYUMFU.min.js +0 -1
  350. package/dist/c-YDECTEUW.min.js +0 -1
  351. package/dist/c-YF3YKVQI.min.js +0 -1
  352. package/dist/c-YLZIV3VS.min.js +0 -1
  353. package/dist/c-ZIVPFTOC.min.js +0 -1
@@ -1,8 +1,30 @@
1
1
  import type { StreamChartCapability, StreamSchema, StreamSuggestion } from "./streamingTypes";
2
- import { type IntentId } from "./intents";
2
+ import type { ChartFamily } from "./chartCapabilityTypes";
3
+ import type { IntentId } from "./intents";
4
+ import { type AudienceProfile } from "./audienceProfile";
3
5
  export declare function registerStreamChartCapability(capability: StreamChartCapability): void;
4
6
  export declare function unregisterStreamChartCapability(component: string): void;
5
7
  export declare function getStreamCapabilities(): ReadonlyArray<StreamChartCapability>;
8
+ export interface RejectedStreamCapability {
9
+ component: string;
10
+ family: ChartFamily;
11
+ importPath: string;
12
+ /** Human-readable reason this chart can't render this schema. */
13
+ reason: string;
14
+ }
15
+ export interface StreamStretchSuggestion {
16
+ suggestion: StreamSuggestion;
17
+ replacing?: string;
18
+ rationale: string;
19
+ familiarity: number;
20
+ /** Set by `suggestStreamDashboard` to bind the stretch to a schema. */
21
+ schemaIndex?: number;
22
+ }
23
+ export interface SuggestStreamChartsResult {
24
+ suggestions: StreamSuggestion[];
25
+ excluded: ReadonlyArray<RejectedStreamCapability>;
26
+ stretchSuggestions: StreamStretchSuggestion[];
27
+ }
6
28
  export interface SuggestStreamChartsOptions {
7
29
  intent?: IntentId | IntentId[];
8
30
  allow?: ReadonlyArray<string>;
@@ -10,17 +32,25 @@ export interface SuggestStreamChartsOptions {
10
32
  maxResults?: number;
11
33
  minScore?: number;
12
34
  capabilities?: ReadonlyArray<StreamChartCapability>;
35
+ audience?: AudienceProfile;
36
+ maxStretchResults?: number;
13
37
  }
14
38
  /**
15
- * Suggest realtime charts for a schema, ranked by intent.
39
+ * Suggest charts for a stream schema, ranked by intent.
16
40
  *
17
41
  * Parallel to `suggestCharts` but operates on a `StreamSchema` (fields +
18
- * throughput/retention hints) rather than row data. Use for live dashboards,
19
- * monitoring views, anywhere events arrive over time rather than as a bounded
20
- * table.
42
+ * throughput/retention/shape hints) rather than row data. Use for live
43
+ * dashboards, monitoring views, anywhere events arrive over time rather
44
+ * than as a bounded table.
45
+ *
46
+ * Returns `{ suggestions, excluded, stretchSuggestions }`. `excluded`
47
+ * lists every registered capability whose `fits()` rejected the schema
48
+ * so a suggestion panel can say why a chart is missing. Pass `audience`
49
+ * to apply familiarity/target bias and (when `exposureLevel !== 0`) fill
50
+ * `stretchSuggestions`.
21
51
  *
22
52
  * @example
23
- * const suggestions = suggestStreamCharts({
53
+ * const { suggestions } = suggestStreamCharts({
24
54
  * fields: [
25
55
  * { name: "ts", kind: "date" },
26
56
  * { name: "latency_ms", kind: "numeric" },
@@ -29,6 +59,11 @@ export interface SuggestStreamChartsOptions {
29
59
  * throughput: "high",
30
60
  * retention: "windowed",
31
61
  * }, { intent: "trend" })
32
- * // → [{ component: "RealtimeHeatmap", ... }, { component: "RealtimeWaterfallChart", ... }]
62
+ * // → suggestions[0] is RealtimeHeatmap or RealtimeWaterfallChart
63
+ */
64
+ export declare function suggestStreamCharts(schema: StreamSchema, options?: SuggestStreamChartsOptions): SuggestStreamChartsResult;
65
+ /**
66
+ * Like `suggestStreamCharts`, but named for diagnostic panels that care
67
+ * about the excluded list. Same result object.
33
68
  */
34
- export declare function suggestStreamCharts(schema: StreamSchema, options?: SuggestStreamChartsOptions): StreamSuggestion[];
69
+ export declare function explainStreamCapabilityFit(schema: StreamSchema, options?: SuggestStreamChartsOptions): SuggestStreamChartsResult;
@@ -0,0 +1,35 @@
1
+ import { type StreamStretchSuggestion } from "./suggestStreamCharts";
2
+ import type { StreamSchema, StreamSuggestion } from "./streamingTypes";
3
+ import type { IntentId } from "./intents";
4
+ import type { AudienceProfile } from "./audienceProfile";
5
+ export interface StreamDashboardPanel {
6
+ intent: IntentId;
7
+ suggestion: StreamSuggestion;
8
+ /** Index into `schemas` for the stream this panel's props bind to. */
9
+ schemaIndex: number;
10
+ }
11
+ export interface StreamDashboardSuggestion {
12
+ panels: StreamDashboardPanel[];
13
+ intentsCovered: IntentId[];
14
+ intentsMissing: IntentId[];
15
+ stretchPanels: StreamStretchSuggestion[];
16
+ schemas: ReadonlyArray<StreamSchema>;
17
+ }
18
+ export interface SuggestStreamDashboardOptions {
19
+ intent?: IntentId | IntentId[];
20
+ intents?: ReadonlyArray<IntentId>;
21
+ audience?: AudienceProfile;
22
+ budget?: number;
23
+ allow?: ReadonlyArray<string>;
24
+ deny?: ReadonlyArray<string>;
25
+ diversifyByFamily?: boolean;
26
+ maxStretchPanels?: number;
27
+ }
28
+ /**
29
+ * Compose a multi-panel dashboard from one or more stream schemas.
30
+ *
31
+ * Parallel to `suggestDashboard`, but schema-based. Audience layout
32
+ * policy (`dashboard.cellBudget`, `leadFamilies`, `windowPreference`)
33
+ * is first-class: pass it on `AudienceProfile.dashboard`.
34
+ */
35
+ export declare function suggestStreamDashboard(schemas: StreamSchema | ReadonlyArray<StreamSchema>, options?: SuggestStreamDashboardOptions): StreamDashboardSuggestion;
@@ -1,5 +1,5 @@
1
1
  import type { ChartCapability, ChartDataProfile, ChartRubric, ChartVariant } from "./chartCapabilityTypes";
2
- import { type IntentId } from "./intents";
2
+ import type { IntentId } from "./intents";
3
3
  import { type AudienceProfile } from "./audienceProfile";
4
4
  /**
5
5
  * Where a proposal came from. Used by scoring + ranking to weight
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const BarChartStreamCapability: StreamChartCapability;
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const DonutChartStreamCapability: StreamChartCapability;
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const GroupedBarChartStreamCapability: StreamChartCapability;
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const PieChartStreamCapability: StreamChartCapability;
@@ -0,0 +1,2 @@
1
+ import type { StreamChartCapability } from "../../ai/streamingTypes";
2
+ export declare const StackedBarChartStreamCapability: StreamChartCapability;
@@ -0,0 +1,14 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { ChartAccessor } from "../shared/types";
3
+ import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
4
+ export declare const AGG_SERIES = "__aggSeries";
5
+ /** One independent aggregation history per authored series, shared by React and SSR. */
6
+ export declare class RealtimeAccumulator {
7
+ private readonly config;
8
+ private readonly seriesAccessor?;
9
+ private readonly groups;
10
+ constructor(config: AggregateConfig, seriesAccessor?: ChartAccessor<Datum, string> | undefined);
11
+ push(row: Datum, timeAccessor?: ChartAccessor<Datum, number>, valueAccessor?: ChartAccessor<Datum, number>): void;
12
+ emit(config: AggregateConfig): AggregatedRealtimeDatum[];
13
+ clear(): void;
14
+ }
@@ -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";
@@ -45,6 +45,10 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
45
45
  windowMode?: WindowMode;
46
46
  /** Ring buffer capacity */
47
47
  windowSize?: number;
48
+ /** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
49
+ capacity?: number;
50
+ /** Alias for `windowMode`. */
51
+ capacityMode?: WindowMode;
48
52
  /** Controlled data array */
49
53
  data?: RealtimeData<TDatum>;
50
54
  /** Time/x value accessor */
@@ -105,10 +109,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
105
109
  /** Declarative tooltip config or the legacy full-HoverData callback. */
106
110
  tooltip?: RealtimeTooltipProp;
107
111
  /** Enable linked hover selection events for cross-chart highlighting */
108
- linkedHover?: boolean | string | {
109
- name?: string;
110
- fields: string[];
111
- };
112
+ linkedHover?: LinkedHoverProp;
112
113
  /** Consume a named selection — dims unselected elements */
113
114
  selection?: SelectionConfig;
114
115
  /** Show a loading skeleton placeholder */
@@ -48,6 +48,10 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
48
48
  arrowOfTime?: ArrowOfTime;
49
49
  /** Data retention strategy */
50
50
  windowMode?: WindowMode;
51
+ /** Alias for `windowSize` — ring-buffer capacity, not the aggregation window. */
52
+ capacity?: number;
53
+ /** Alias for `windowMode`. */
54
+ capacityMode?: WindowMode;
51
55
  /** Ring buffer capacity */
52
56
  windowSize?: number;
53
57
  /** Controlled data array */
@@ -216,7 +220,7 @@ export declare const RealtimeHistogram: {
216
220
  <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
217
221
  displayName?: string;
218
222
  };
219
- export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
223
+ export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowMode" | "windowSize"> {
220
224
  /** Static data array for a bounded temporal histogram. */
221
225
  data: TDatum[];
222
226
  }
@@ -1,168 +1,9 @@
1
1
  import * as React from "react";
2
- import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext, DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "../../stream/types";
3
2
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
- import type { CSSProperties, ReactNode } from "react";
5
- import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
- import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
7
- import type { OnObservationCallback } from "../../store/ObservationStore";
8
3
  import type { Datum } from "../shared/datumTypes";
9
- import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
- import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
- import type { ResponsiveRule } from "../shared/responsiveRules";
12
4
  import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
13
- import { type EventTimeConfig } from "./eventTime";
14
- import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
15
- import type { PartialMargin } from "../../types/marginType";
16
- import { type StyleRule } from "../shared/styleRules";
17
- /**
18
- * Imperative handle for RealtimeLineChart. It extends the shared realtime
19
- * handle without changing that cross-chart contract: only this chart exposes
20
- * event-time tail flushing.
21
- */
22
- export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
23
- /**
24
- * Release every event still held by `eventTime`, in event-time order.
25
- * Call this when an input source reaches an asserted end-of-stream or batch
26
- * boundary. Later newer events remain supported; events older than the
27
- * flushed frontier follow `latePolicy`.
28
- */
29
- flush(): void;
30
- }
31
- export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
32
- /** Fit the container width. */
33
- responsiveWidth?: boolean;
34
- /** Fit a container with a definite height. */
35
- responsiveHeight?: boolean;
36
- /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
37
- mode?: ChartMode;
38
- /** Semantic responsive transformations applied before chart-mode defaults. */
39
- responsiveRules?: ResponsiveRule[];
40
- /** Phone/mobile contract consumed by audits, recipes, adapters, and agents. */
41
- mobileSemantics?: MobileVisualizationContract;
42
- /** Touch-first interaction policy for phone-sized chart slots. */
43
- mobileInteraction?: MobileInteractionProp;
44
- /** Chart dimensions as [width, height] */
45
- size?: [number, number];
46
- /** Chart width (alternative to size) */
47
- width?: number;
48
- /** Chart height (alternative to size) */
49
- height?: number;
50
- /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
51
- maxDevicePixelRatio?: number;
52
- /** Chart margins */
53
- margin?: PartialMargin;
54
- /** CSS class name */
55
- className?: string;
56
- onObservation?: OnObservationCallback;
57
- chartId?: string;
58
- /** Direction time flows */
59
- arrowOfTime?: ArrowOfTime;
60
- /** Data retention strategy */
61
- windowMode?: WindowMode;
62
- /** Ring buffer capacity */
63
- windowSize?: number;
64
- /** Controlled data array */
65
- data?: RealtimeData<TDatum>;
66
- /** Time value accessor */
67
- timeAccessor?: ChartAccessor<TDatum, number>;
68
- /** Value accessor */
69
- valueAccessor?: ChartAccessor<TDatum, number>;
70
- /** Fixed time domain */
71
- timeExtent?: [number, number];
72
- /** Fixed value domain */
73
- valueExtent?: [number, number];
74
- /** Extent padding factor */
75
- extentPadding?: number;
76
- /** Line color */
77
- stroke?: string;
78
- /** Line width */
79
- strokeWidth?: number;
80
- /** Dash pattern (e.g. "4,2") */
81
- strokeDasharray?: string;
82
- /** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
83
- opacity?: number;
84
- /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
85
- cursor?: CSSProperties["cursor"];
86
- /** Ordered data-aware line styling, resolved against the displayed series sample. */
87
- styleRules?: StyleRule[];
88
- /** Show canvas-drawn axes */
89
- showAxes?: boolean;
90
- /** Background fill color */
91
- background?: string;
92
- /** Enable hover interaction */
93
- enableHover?: boolean | HoverAnnotationConfig;
94
- /** Custom tooltip renderer */
95
- tooltipContent?: (d: HoverData) => ReactNode;
96
- /** Callback on hover */
97
- onHover?: (d: HoverData | null) => void;
98
- /** Annotation objects */
99
- annotations?: Datum[];
100
- /** Opt into automatic placement for note-like annotations without manual offsets. */
101
- autoPlaceAnnotations?: AutoPlaceAnnotations;
102
- /** SVG annotation render function */
103
- svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
104
- /** Custom formatter for time axis ticks */
105
- tickFormatTime?: (value: number) => string;
106
- /** Custom formatter for value axis ticks */
107
- tickFormatValue?: (value: number) => string;
108
- /** Declarative tooltip config or the legacy full-HoverData callback. Pass `"multi"` for hover-anywhere line values. */
109
- tooltip?: RealtimeTooltipProp;
110
- /** Configurable opacity decay for older data */
111
- decay?: DecayConfig;
112
- /** Flash effect on newly inserted data */
113
- pulse?: PulseConfig;
114
- /** Frame-level data liveness indicator */
115
- staleness?: StalenessConfig;
116
- /** Smooth position interpolation on data change */
117
- transition?: TransitionConfig;
118
- /** Enable linked hover selection events for cross-chart highlighting */
119
- linkedHover?: boolean | string | {
120
- name?: string;
121
- fields: string[];
122
- };
123
- /** Consume a named selection — dims unselected elements */
124
- selection?: SelectionConfig;
125
- /** Show a loading skeleton placeholder */
126
- loading?: boolean;
127
- /** Custom content rendered in place of the default skeleton while `loading` is true. */
128
- loadingContent?: React.ReactNode | false;
129
- /** Custom content to render when data is empty. Set to `false` to disable empty state. */
130
- emptyContent?: ReactNode | false;
131
- /** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
132
- emphasis?: "primary" | "secondary";
133
- /** Show a legend */
134
- showLegend?: boolean;
135
- /** Legend position */
136
- legendPosition?: LegendPosition;
137
- /** Legend interaction mode */
138
- legendInteraction?: LegendInteractionMode;
139
- /** ID accessor for remove()/update() on the push API */
140
- pointIdAccessor?: RealtimePointIdAccessor<TDatum>;
141
- /**
142
- * Opt-in windowed aggregation over event-time. When set, pushed
143
- * events are reduced into tumbling/hopping/session windows and the
144
- * chart draws one mark per window (mean/sum/min/max/count) plus an
145
- * optional ±σ or min–max band — render cost scales with the number of
146
- * visible windows, not the arrival rate. This is the **aggregation
147
- * window**, distinct from `windowMode`'s RingBuffer eviction. Changing a
148
- * structural window field or either accessor rebuilds the accumulator:
149
- * controlled `data` is reseeded, while push-only input begins a new epoch
150
- * because raw events are deliberately not retained.
151
- */
152
- aggregate?: AggregateConfig;
153
- /**
154
- * Opt-in event-time ingestion. Buffers pushed events for a bounded
155
- * lateness/grace window and releases them to the chart in event-time
156
- * order, so out-of-order or merged multi-source streams render
157
- * monotonically instead of zigzagging. Late events (older than
158
- * `watermark − lateness`) are dropped or kept per policy and surfaced
159
- * via `onObservation` as `"late-data"`. Default-off; when unset the
160
- * push path is byte-for-byte unchanged. Call `ref.current.flush()` at an
161
- * asserted end-of-stream boundary so the final grace-window events are
162
- * released in order.
163
- */
164
- eventTime?: EventTimeConfig;
165
- }
5
+ import { type RealtimeLineChartHandle, type RealtimeLineChartProps } from "./RealtimeLineChart.types";
6
+ export type { RealtimeLineChartHandle, RealtimeLineChartProps };
166
7
  /**
167
8
  * RealtimeLineChart - Simplified wrapper for streaming line charts.
168
9
  *
@@ -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;