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
@@ -1,4 +1,4 @@
1
- import type { ChartRubric } from "./chartCapabilityTypes";
1
+ import type { ChartFamily, ChartRubric } from "./chartCapabilityTypes";
2
2
  import type { AccessibilityAuditResult } from "../charts/shared/auditAccessibility";
3
3
  /**
4
4
  * The channel an audience receives a chart through. Orthogonal to familiarity:
@@ -13,6 +13,21 @@ import type { AccessibilityAuditResult } from "../charts/shared/auditAccessibili
13
13
  * "is the meaning recoverable without pixels?" question.
14
14
  */
15
15
  export type ReceptionModality = "visual" | "screen-reader" | "sonified" | "agent";
16
+ /**
17
+ * Layout policy for a dashboard generated for this audience. Cell budget,
18
+ * lead families, density, and stream window preference sit next to
19
+ * familiarity so `suggestDashboard` / `suggestStreamDashboard` can honor
20
+ * the same profile the ranking engine already consumes.
21
+ */
22
+ export interface DashboardLayoutPolicy {
23
+ /** Maximum panels. Overrides the suggester's default budget. */
24
+ cellBudget?: number;
25
+ /** Preferred families for the lead (first) panel. */
26
+ leadFamilies?: ReadonlyArray<ChartFamily>;
27
+ density?: "sparse" | "comfortable" | "dense";
28
+ /** Default retention when a stream schema omits it. */
29
+ windowPreference?: "windowed" | "cumulative";
30
+ }
16
31
  /**
17
32
  * A serializable description of who's reading the charts and what the
18
33
  * organization is trying to grow.
@@ -68,6 +83,8 @@ export interface AudienceProfile {
68
83
  * See {@link receivabilityBias}.
69
84
  */
70
85
  receptionModality?: ReceptionModality;
86
+ /** Dashboard composition policy for this audience. */
87
+ dashboard?: DashboardLayoutPolicy;
71
88
  }
72
89
  export interface AudienceTarget {
73
90
  direction: "increase" | "decrease";
@@ -98,7 +98,11 @@ export interface DescribeChartOptions {
98
98
  /** Include declared recipe risks/caveats in the structured result. */
99
99
  includeCaveats?: boolean;
100
100
  }
101
- /** The communicative act a built-in intent implies, or undefined if unknown. */
101
+ /**
102
+ * The communicative act an intent implies. Built-in intents map directly.
103
+ * Registered composed intents resolve through the heaviest child in
104
+ * `composes` (highest `weights` entry, default 1), then recurse.
105
+ */
102
106
  export declare function communicativeActForIntent(intent: IntentId): CommunicativeAct | undefined;
103
107
  /**
104
108
  * Resolve the communicative act for a chart from (in priority order) an explicit
@@ -1,4 +1,5 @@
1
1
  import type { ChartRecipe } from "./chartRecipes";
2
+ import type { DashboardLayoutPolicy } from "./audienceProfile";
2
3
  export interface IntentManifest {
3
4
  ididVersion: string;
4
5
  chartId: string;
@@ -50,6 +51,21 @@ export interface IntentManifest {
50
51
  annotationStatus?: string;
51
52
  };
52
53
  }
54
+ export interface DashboardIntentManifest {
55
+ ididVersion: string;
56
+ dashboardId: string;
57
+ title?: string;
58
+ audience?: IntentManifest["audience"];
59
+ layout?: DashboardLayoutPolicy;
60
+ panels: IntentManifest[];
61
+ }
62
+ export declare function dashboardIntentManifest(input: {
63
+ id: string;
64
+ title?: string;
65
+ audience?: IntentManifest["audience"];
66
+ layout?: DashboardLayoutPolicy;
67
+ panels: IntentManifest[];
68
+ }): DashboardIntentManifest;
53
69
  export declare function summarizeIntentManifest(manifest: IntentManifest): string;
54
70
  export interface IntentManifestFromRecipeOptions {
55
71
  chartId: string;
@@ -0,0 +1,12 @@
1
+ import type { IntentId, IntentDescriptor } from "./intents";
2
+ interface IntentRegistryStore {
3
+ intents: Map<IntentId, IntentDescriptor>;
4
+ }
5
+ export declare function intentRegistryStore(): IntentRegistryStore;
6
+ /**
7
+ * Materialize requested composed intent scores over a capability's existing
8
+ * scores. Only requested ids are added: registering an intent cannot silently
9
+ * change no-intent/default ranking by adding another value to its mean.
10
+ */
11
+ export declare function expandComposedIntentScores(scores: Readonly<Partial<Record<IntentId, number>>>, requested: ReadonlyArray<IntentId>): Partial<Record<IntentId, number>>;
12
+ export {};
@@ -1,3 +1,4 @@
1
+ export { expandComposedIntentScores } from "./intentRegistry";
1
2
  /**
2
3
  * Canonical intent taxonomy for chart suggestion / interrogation.
3
4
  *
@@ -23,6 +24,11 @@ export type IntentFieldKind = "numeric" | "categorical" | "date" | "boolean" | "
23
24
  */
24
25
  export interface IntentSignals {
25
26
  fieldNames?: ReadonlyArray<string>;
27
+ /**
28
+ * Natural-language phrases scored in `inferIntent` prose / combined mode.
29
+ * Matched as whole phrases (case-insensitive), not field-name tokens.
30
+ */
31
+ phrases?: ReadonlyArray<string>;
26
32
  minimumFieldMatches?: number;
27
33
  dataShape?: {
28
34
  minNumericFields?: number;
@@ -59,11 +65,5 @@ export declare function listIntents(): IntentDescriptor[];
59
65
  * replaces the descriptor.
60
66
  */
61
67
  export declare function registerIntent(intent: IntentDescriptor): void;
62
- /**
63
- * Materialize requested composed intent scores over a capability's existing
64
- * scores. Only requested ids are added: registering an intent cannot silently
65
- * change no-intent/default ranking by adding another value to its mean.
66
- */
67
- export declare function expandComposedIntentScores(scores: Readonly<Partial<Record<IntentId, number>>>, requested: ReadonlyArray<IntentId>): Partial<Record<IntentId, number>>;
68
68
  /** Sentinel set used by capability authors to opt out of an intent without misspelling. */
69
69
  export declare const BUILT_IN_INTENT_IDS: ReadonlySet<BuiltInIntentId>;
@@ -0,0 +1,19 @@
1
+ import type { StreamFieldSchema, StreamSchema, StreamShape, StreamThroughputBand, StreamThroughputThresholds } from "./streamingTypes";
2
+ /** Names that should not be plotted as measures when no value role is set. */
3
+ export declare function isIdLikeFieldName(name: string): boolean;
4
+ /** Identity columns: explicit `keyFields` unioned with `role: "key"`. */
5
+ export declare function streamKeyFields(schema: StreamSchema): string[];
6
+ /**
7
+ * Resolve changelog semantics. Explicit `shape` wins; otherwise a schema
8
+ * with identity columns is keyed, and everything else is append-only.
9
+ */
10
+ export declare function resolveStreamShape(schema: StreamSchema): StreamShape;
11
+ export declare function streamThroughputBand(schema: StreamSchema, thresholds?: StreamThroughputThresholds): StreamThroughputBand | undefined;
12
+ export declare function pickTimeField(schema: StreamSchema): StreamFieldSchema | undefined;
13
+ export declare function pickValueField(schema: StreamSchema): StreamFieldSchema | undefined;
14
+ export declare function pickCategoryField(schema: StreamSchema): StreamFieldSchema | undefined;
15
+ export declare function pickSeriesField(schema: StreamSchema): StreamFieldSchema | undefined;
16
+ export declare function hasNumericValue(schema: StreamSchema): boolean;
17
+ export declare function hasTimeField(schema: StreamSchema): boolean;
18
+ export declare function hasCategoryField(schema: StreamSchema): boolean;
19
+ export declare function hasSeriesField(schema: StreamSchema): boolean;
@@ -1,20 +1,47 @@
1
- import type { ChartRubric } from "./chartCapabilityTypes";
1
+ import type { ChartFamily, ChartRubric } from "./chartCapabilityTypes";
2
2
  import type { IntentId } from "./intents";
3
3
  /**
4
4
  * Streaming chart selection has a different shape than static. We don't have
5
5
  * rows yet — we have a *schema*: which fields will arrive, what types, plus
6
- * environment hints (throughput, retention).
6
+ * environment hints (throughput, retention, changelog shape).
7
7
  *
8
8
  * Rather than overloading `profileData` (which is row-statistics-centric) we
9
9
  * model streams as a parallel API. The two share the intent vocabulary —
10
10
  * "trend" still means trend — but the suitability logic is its own thing.
11
11
  */
12
12
  export type StreamFieldKind = "numeric" | "categorical" | "date" | "boolean";
13
+ export type StreamFieldRole = "x" | "y" | "value" | "category" | "series" | "size" | "key";
14
+ /**
15
+ * Changelog semantics for a stream. First-class so capabilities can reason
16
+ * about identity without encoding "keyed" as `role: "category"` plus
17
+ * `retention: "cumulative"`.
18
+ *
19
+ * • `"append"` — append-only event stream (default)
20
+ * • `"keyed"` — keyed table / changelog (insert, update, retract)
21
+ * • `"aggregate"` — single-row aggregate (one current value)
22
+ */
23
+ export type StreamShape = "append" | "keyed" | "aggregate";
24
+ /**
25
+ * Event-rate hint. A number is rows per second; capabilities convert it to
26
+ * a band with {@link streamThroughputBand}. String bands keep the original
27
+ * qualitative API:
28
+ * • "low" — < 1 event/sec
29
+ * • "medium" — ~1-100 events/sec
30
+ * • "high" — > 100 events/sec
31
+ */
32
+ export type StreamThroughput = "low" | "medium" | "high" | number;
33
+ export type StreamThroughputBand = "low" | "medium" | "high";
34
+ export interface StreamThroughputThresholds {
35
+ /** Inclusive lower bound for "medium", default 1. */
36
+ medium?: number;
37
+ /** Inclusive lower bound for "high", default 100. */
38
+ high?: number;
39
+ }
13
40
  export interface StreamFieldSchema {
14
41
  name: string;
15
42
  kind: StreamFieldKind;
16
43
  /** Optional role hint — overrides the engine's inference. */
17
- role?: "x" | "y" | "value" | "category" | "series" | "size";
44
+ role?: StreamFieldRole;
18
45
  }
19
46
  /**
20
47
  * Schema describing what a stream emits. No data, just shape + environment hints.
@@ -24,17 +51,25 @@ export interface StreamSchema {
24
51
  /**
25
52
  * Hint about expected event rate. Affects chart selection — heatmaps and
26
53
  * waterfalls amortize high-throughput streams better than line charts do.
27
- * • "low" — < 1 event/sec, line/area charts read well
28
- * • "medium" — ~1-100 events/sec
29
- * • "high" — > 100 events/sec, prefer aggregating visualizations
54
+ * A number is rows per second; string bands are qualitative.
30
55
  */
31
- throughput?: "low" | "medium" | "high";
56
+ throughput?: StreamThroughput;
32
57
  /**
33
58
  * Hint about how long events are kept in view.
34
59
  * • "windowed" — only recent events visible (default)
35
60
  * • "cumulative" — all events accumulate
36
61
  */
37
62
  retention?: "windowed" | "cumulative";
63
+ /**
64
+ * Changelog semantics. When omitted, inferred from `keyFields` /
65
+ * `role: "key"` (keyed) and otherwise treated as append-only.
66
+ */
67
+ shape?: StreamShape;
68
+ /**
69
+ * Identity columns for keyed tables. Unioned with fields whose role is
70
+ * `"key"` by {@link streamKeyFields}.
71
+ */
72
+ keyFields?: ReadonlyArray<string>;
38
73
  }
39
74
  /**
40
75
  * Stream capability descriptor — parallel to ChartCapability but operates on
@@ -42,7 +77,18 @@ export interface StreamSchema {
42
77
  */
43
78
  export interface StreamChartCapability {
44
79
  component: string;
45
- importPath: "semiotic/realtime";
80
+ /**
81
+ * Import specifier for generated code. Built-ins use family subpaths
82
+ * (`semiotic/realtime`, `semiotic/ordinal`, `semiotic/value`); wrappers
83
+ * may declare any string (e.g. `"@iris/charts"`).
84
+ */
85
+ importPath: string;
86
+ /**
87
+ * Chart family for ranking and dashboard diversification.
88
+ * Omitted descriptors default to `"realtime"` so 3.10 custom
89
+ * capabilities remain assignable.
90
+ */
91
+ family?: ChartFamily;
46
92
  /** True when this chart consumes an event stream and has no static render proof. */
47
93
  requiresLiveData?: boolean;
48
94
  rubric: ChartRubric;
@@ -54,8 +100,8 @@ export interface StreamChartCapability {
54
100
  export type StreamIntentScorer = number | ((schema: StreamSchema) => number);
55
101
  export interface StreamSuggestion {
56
102
  component: string;
57
- family: "realtime";
58
- importPath: "semiotic/realtime";
103
+ family: ChartFamily;
104
+ importPath: string;
59
105
  /** Whether the recommendation must receive live event data rather than a bounded array. */
60
106
  requiresLiveData?: boolean;
61
107
  score: number;
@@ -63,6 +109,6 @@ export interface StreamSuggestion {
63
109
  rubric: ChartRubric;
64
110
  reasons: ReadonlyArray<string>;
65
111
  caveats: ReadonlyArray<string>;
66
- /** Props ready to spread into the matching realtime chart. */
112
+ /** Props ready to spread into the matching chart. */
67
113
  props: Record<string, unknown>;
68
114
  }
@@ -1,7 +1,7 @@
1
1
  import type { Datum } from "../charts/shared/datumTypes";
2
2
  import { type ProfileDataOptions } from "./profileData";
3
3
  import type { ChartCapability, ChartDataProfile, ScoreChartResult, ScaledSuggestionGroups, Suggestion } from "./chartCapabilityTypes";
4
- import { type IntentId } from "./intents";
4
+ import type { IntentId } from "./intents";
5
5
  import { type AudienceProfile, type ReceptionModality } from "./audienceProfile";
6
6
  import { type DataQualityProfile, type DataScaleProfile } from "./dataScaleProfile";
7
7
  export interface SuggestChartsOptions extends ProfileDataOptions {
@@ -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
  *