semiotic 3.10.1 → 3.10.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (346) hide show
  1. package/README.md +67 -62
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/dist/mcp-server.js +25 -24
  4. package/ai/examples.md +28 -0
  5. package/ai/reference.md +6 -1
  6. package/ai/schema.json +121 -5
  7. package/ai/surface-manifest.json +3 -2
  8. package/ai/task-packets/compare-category-totals.json +7 -53
  9. package/ai/task-packets/compare-category-totals.md +4 -4
  10. package/ai/task-packets/correct-published-chart.json +7 -53
  11. package/ai/task-packets/correct-published-chart.md +4 -4
  12. package/ai/task-packets/index.json +9 -9
  13. package/ai/task-packets/update-live-chart.json +8 -54
  14. package/ai/task-packets/update-live-chart.md +4 -4
  15. package/dist/c-27DCB5T6.min.js +18 -0
  16. package/dist/c-2MONF2P6.min.js +1 -0
  17. package/dist/c-2TW5H5PD.min.js +1 -0
  18. package/dist/c-3AGX252H.min.js +1 -0
  19. package/dist/c-3B6JZEZT.min.js +1 -0
  20. package/dist/c-3BYZXCX3.min.js +4 -0
  21. package/dist/c-3DIPZJDO.min.js +1 -0
  22. package/dist/c-3FOUMWLR.min.js +1 -0
  23. package/dist/c-3NA6I656.min.js +2 -0
  24. package/dist/c-3OFVBWQY.min.js +1 -0
  25. package/dist/{c-QA3HMQJP.min.js → c-3PFVJFBK.min.js} +1 -1
  26. package/dist/c-3PPO7ZJF.min.js +4 -0
  27. package/dist/c-3YEW2PK6.min.js +1 -0
  28. package/dist/c-4JKDJUYD.min.js +1 -0
  29. package/dist/c-4LKK5YWB.min.js +1 -0
  30. package/dist/c-4MD53L2J.min.js +33 -0
  31. package/dist/c-4V3CD337.min.js +1 -0
  32. package/dist/c-4XLHPQTP.min.js +1 -0
  33. package/dist/c-5NYONM6V.min.js +5 -0
  34. package/dist/c-6IVBV5NO.min.js +1 -0
  35. package/dist/c-6ZU3QVLB.min.js +100 -0
  36. package/dist/c-72CBVNYX.min.js +209 -0
  37. package/dist/c-7APWCEPL.min.js +1 -0
  38. package/dist/c-7ASK4WBF.min.js +1 -0
  39. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  40. package/dist/c-7LY46QUI.min.js +41 -0
  41. package/dist/c-ABMGCCLT.min.js +1 -0
  42. package/dist/c-AINGQGUN.min.js +1 -0
  43. package/dist/c-AKLBQMQF.min.js +391 -0
  44. package/dist/c-AXJ2QI3F.min.js +1 -0
  45. package/dist/c-BQYD7T4E.min.js +1 -0
  46. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  47. package/dist/{c-J6DVC236.min.js → c-C4KIXUWU.min.js} +1 -1
  48. package/dist/c-C4SXYFXL.min.js +1 -0
  49. package/dist/c-CLDCKFBE.min.js +1 -0
  50. package/dist/c-CLJCJSFU.min.js +1 -0
  51. package/dist/c-CLLCX3PT.min.js +2 -0
  52. package/dist/c-ECHBKW7U.min.js +1 -0
  53. package/dist/c-EPJWM2UT.min.js +1 -0
  54. package/dist/c-F2GGJB2S.min.js +31 -0
  55. package/dist/c-FD2BXSRG.min.js +1 -0
  56. package/dist/c-FDUQDCBC.min.js +51 -0
  57. package/dist/c-FOTTQHOO.min.js +1 -0
  58. package/dist/c-FU7A5KSY.min.js +1 -0
  59. package/dist/c-G53AVC42.min.js +113 -0
  60. package/dist/c-GHN6IR4Y.min.js +1 -0
  61. package/dist/c-GSCO3FWL.min.js +1 -0
  62. package/dist/c-GYLOSK7M.min.js +1 -0
  63. package/dist/c-HK4OSLZA.min.js +1 -0
  64. package/dist/c-HLGTD5SJ.min.js +1 -0
  65. package/dist/c-HQ27AHMC.min.js +1 -0
  66. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  67. package/dist/c-IHWZ2C6D.min.js +26 -0
  68. package/dist/c-IIV73MUW.min.js +1 -0
  69. package/dist/c-IPYGNVN6.min.js +116 -0
  70. package/dist/c-JJKRER47.min.js +1 -0
  71. package/dist/c-JO6AYCU4.min.js +1 -0
  72. package/dist/c-JWHPG6S2.min.js +1 -0
  73. package/dist/c-JXVYIXTV.min.js +1 -0
  74. package/dist/c-K2ZIYDI3.min.js +1 -0
  75. package/dist/c-K37JAIWA.min.js +4 -0
  76. package/dist/c-KGROWFT2.min.js +9 -0
  77. package/dist/c-MOP2NGLH.min.js +1 -0
  78. package/dist/c-MTX2AO5S.min.js +1 -0
  79. package/dist/c-N5WT7TXG.min.js +1 -0
  80. package/dist/c-NATWERHZ.min.js +1 -0
  81. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  82. package/dist/c-OVQB75PE.min.js +1 -0
  83. package/dist/c-P3SKRNZN.min.js +1 -0
  84. package/dist/c-P5NXQWIM.min.js +1 -0
  85. package/dist/c-P7BQMVQQ.min.js +1 -0
  86. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  87. package/dist/c-PKY4JFY5.min.js +1 -0
  88. package/dist/c-PQOZPM4G.min.js +1 -0
  89. package/dist/c-PZ3NEGNG.min.js +1 -0
  90. package/dist/c-QXLDCATV.min.js +1 -0
  91. package/dist/c-R2HUSWKB.min.js +1 -0
  92. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  93. package/dist/c-RZPP5ERV.min.js +1 -0
  94. package/dist/c-SG2Y7EBY.min.js +46 -0
  95. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  96. package/dist/c-SQNEVNWT.min.js +1 -0
  97. package/dist/c-STHZWF3D.min.js +1 -0
  98. package/dist/c-TIDKVMMZ.min.js +1 -0
  99. package/dist/c-TIMGODBG.min.js +1 -0
  100. package/dist/c-TR7OHUAO.min.js +2 -0
  101. package/dist/c-TTKWXGAI.min.js +61 -0
  102. package/dist/c-TVKZC4BY.min.js +1 -0
  103. package/dist/c-U5XVLSHN.min.js +1 -0
  104. package/dist/c-U6NLVFN4.min.js +1 -0
  105. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  106. package/dist/c-UOPPO26M.min.js +1 -0
  107. package/dist/c-UUDAON4Z.min.js +1 -0
  108. package/dist/c-V32TPPY2.min.js +1 -0
  109. package/dist/c-V5KFJWQQ.min.js +1 -0
  110. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  111. package/dist/c-VXIYF7V2.min.js +1 -0
  112. package/dist/c-Y342FJ6K.min.js +1 -0
  113. package/dist/c-YM6CT4LJ.min.js +1 -0
  114. package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
  115. package/dist/c-YQVOKPKR.min.js +1 -0
  116. package/dist/c-YRJ3BJQZ.min.js +1 -0
  117. package/dist/c-YT5KPVNP.min.js +1 -0
  118. package/dist/components/ai/audienceProfile.d.ts +18 -1
  119. package/dist/components/ai/describeChart.d.ts +5 -1
  120. package/dist/components/ai/intentManifest.d.ts +16 -0
  121. package/dist/components/ai/intentRegistry.d.ts +12 -0
  122. package/dist/components/ai/intents.d.ts +6 -6
  123. package/dist/components/ai/streamSchema.d.ts +19 -0
  124. package/dist/components/ai/streamingTypes.d.ts +57 -11
  125. package/dist/components/ai/suggestCharts.d.ts +1 -1
  126. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  127. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  128. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  129. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  130. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  131. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  132. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  133. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  135. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  136. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  137. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  138. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  139. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  140. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  141. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  142. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  143. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  144. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  145. package/dist/components/charts/shared/knownChartComponents.d.ts +4 -1
  146. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  147. package/dist/components/charts/shared/useChartSetup.d.ts +2 -0
  148. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  149. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  150. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  151. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  152. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  153. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  154. package/dist/components/realtime/HyperLogLog.d.ts +19 -0
  155. package/dist/components/realtime/ReorderBuffer.d.ts +2 -2
  156. package/dist/components/realtime/TDigest.d.ts +22 -0
  157. package/dist/components/realtime/WindowAccumulator.d.ts +22 -5
  158. package/dist/components/realtime/applyChangelog.d.ts +38 -0
  159. package/dist/components/realtime/minHeap.d.ts +3 -0
  160. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +1 -1
  161. package/dist/components/recipes/layout1d.d.ts +2 -20
  162. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  163. package/dist/components/semiotic-ai-core.d.ts +8 -3
  164. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  165. package/dist/components/semiotic-ai.d.ts +4 -6
  166. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  167. package/dist/components/semiotic-stream-types.d.ts +14 -0
  168. package/dist/components/semiotic-xy.d.ts +1 -0
  169. package/dist/components/semiotic.d.ts +3 -11
  170. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  171. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  172. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  173. package/dist/components/server/renderEvidence.d.ts +4 -0
  174. package/dist/components/server/serverChartConfigs.d.ts +5 -0
  175. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  176. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  177. package/dist/components/server/staticAnnotations.d.ts +9 -0
  178. package/dist/components/stream/SceneGraph.d.ts +3 -3
  179. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  180. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  181. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  182. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  183. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  184. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  185. package/dist/components/stream/types.d.ts +25 -2
  186. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  187. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  188. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  189. package/dist/components/text/labelMeasurement.d.ts +19 -0
  190. package/dist/components/text/labelPlacement.d.ts +71 -0
  191. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  192. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  193. package/dist/controls.module.min.js +71 -1
  194. package/dist/geo.min.js +231 -1
  195. package/dist/geo.module.min.js +31 -1
  196. package/dist/network.module.min.js +1 -1
  197. package/dist/ordinal.module.min.js +1 -1
  198. package/dist/physics-matter.module.min.js +1 -1
  199. package/dist/physics-rapier.module.min.js +1 -1
  200. package/dist/physics.module.min.js +1 -1
  201. package/dist/rough.min.js +2 -1
  202. package/dist/rough.module.min.js +2 -1
  203. package/dist/semiotic-access.module.min.js +1 -1
  204. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  205. package/dist/semiotic-ai-core.d.ts +8 -3
  206. package/dist/semiotic-ai-core.min.js +4 -1
  207. package/dist/semiotic-ai-core.module.min.js +4 -1
  208. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  209. package/dist/semiotic-ai.d.ts +4 -6
  210. package/dist/semiotic-ai.module.min.js +14 -1
  211. package/dist/semiotic-artifact-react.min.js +269 -1
  212. package/dist/semiotic-artifact-react.module.min.js +137 -1
  213. package/dist/semiotic-artifact.min.js +3 -1
  214. package/dist/semiotic-artifact.module.min.js +3 -1
  215. package/dist/semiotic-atlas-core.min.js +2 -1
  216. package/dist/semiotic-atlas-core.module.min.js +1 -1
  217. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  218. package/dist/semiotic-atlas.module.min.js +11 -1
  219. package/dist/semiotic-client-cjs-shared.min.js +1529 -1
  220. package/dist/semiotic-client-glyph.module.min.js +3 -1
  221. package/dist/semiotic-client-responsive.module.min.js +1 -1
  222. package/dist/semiotic-client-shared.module.min.js +1 -1
  223. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  224. package/dist/semiotic-data.min.js +1 -1
  225. package/dist/semiotic-data.module.min.js +1 -1
  226. package/dist/semiotic-evidence.min.js +3 -1
  227. package/dist/semiotic-evidence.module.min.js +3 -1
  228. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  229. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  230. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  231. package/dist/semiotic-experimental-vacp.min.js +1 -1
  232. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  233. package/dist/semiotic-line.module.min.js +1 -1
  234. package/dist/semiotic-realtime-core.d.ts +6 -2
  235. package/dist/semiotic-realtime-core.module.min.js +1 -1
  236. package/dist/semiotic-realtime-react.module.min.js +1 -1
  237. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  238. package/dist/semiotic-recipes-core.module.min.js +72 -1
  239. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  240. package/dist/semiotic-recipes-react.min.js +3 -1
  241. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  242. package/dist/semiotic-server-edge.min.js +651 -1
  243. package/dist/semiotic-server-edge.module.min.js +372 -1
  244. package/dist/semiotic-server-node.min.js +651 -1
  245. package/dist/semiotic-server-node.module.min.js +1 -1
  246. package/dist/semiotic-text.min.js +1 -1
  247. package/dist/semiotic-text.module.min.js +1 -1
  248. package/dist/semiotic-themes-core.min.js +1 -1
  249. package/dist/semiotic-themes-core.module.min.js +1 -1
  250. package/dist/semiotic-themes.min.js +1 -1
  251. package/dist/semiotic-themes.module.min.js +1 -1
  252. package/dist/semiotic-utils-core.min.js +11 -1
  253. package/dist/semiotic-utils-core.module.min.js +8 -1
  254. package/dist/semiotic-value.module.min.js +15 -1
  255. package/dist/semiotic-xy.d.ts +1 -0
  256. package/dist/semiotic.d.ts +3 -11
  257. package/dist/semiotic.module.min.js +10 -1
  258. package/dist/server.min.js +651 -1
  259. package/dist/server.module.min.js +1 -1
  260. package/dist/xy.module.min.js +1 -1
  261. package/package.json +4 -3
  262. package/dist/c-2N7IU2NY.min.js +0 -1
  263. package/dist/c-2RL2QPZJ.min.js +0 -1
  264. package/dist/c-2WK7YJLL.min.js +0 -1
  265. package/dist/c-45CQWZZ6.min.js +0 -1
  266. package/dist/c-4BRHKVKV.min.js +0 -1
  267. package/dist/c-7242NXSG.min.js +0 -1
  268. package/dist/c-7DVPSB5C.min.js +0 -1
  269. package/dist/c-7EGHJU2F.min.js +0 -1
  270. package/dist/c-A7OGOFSL.min.js +0 -1
  271. package/dist/c-AFBSWT77.min.js +0 -1
  272. package/dist/c-AH5HWZWS.min.js +0 -1
  273. package/dist/c-AJ7EC32V.min.js +0 -1
  274. package/dist/c-AQADQNY7.min.js +0 -1
  275. package/dist/c-ATM475SA.min.js +0 -1
  276. package/dist/c-AVO3Q7T7.min.js +0 -1
  277. package/dist/c-B7GW7IHJ.min.js +0 -1
  278. package/dist/c-BNFJMDHN.min.js +0 -1
  279. package/dist/c-BOHCQILI.min.js +0 -1
  280. package/dist/c-C3TZLTZK.min.js +0 -1
  281. package/dist/c-CGQAQWBV.min.js +0 -1
  282. package/dist/c-CPV4N35K.min.js +0 -1
  283. package/dist/c-DIPEYUOW.min.js +0 -1
  284. package/dist/c-E4JDJH4I.min.js +0 -1
  285. package/dist/c-E72OTUZU.min.js +0 -1
  286. package/dist/c-E7I2L7CU.min.js +0 -1
  287. package/dist/c-ELDWAO2V.min.js +0 -1
  288. package/dist/c-EUBTECGM.min.js +0 -1
  289. package/dist/c-EUMPMDCS.min.js +0 -1
  290. package/dist/c-EZZT2WAE.min.js +0 -1
  291. package/dist/c-FHBVFCQB.min.js +0 -1
  292. package/dist/c-G4HCO2IQ.min.js +0 -1
  293. package/dist/c-G5VIJEOK.min.js +0 -1
  294. package/dist/c-GHVOXAYH.min.js +0 -1
  295. package/dist/c-GXV3C3MO.min.js +0 -1
  296. package/dist/c-HHTK2R75.min.js +0 -1
  297. package/dist/c-HLLFJYTY.min.js +0 -1
  298. package/dist/c-HP4ZFM47.min.js +0 -1
  299. package/dist/c-HPOYKCCG.min.js +0 -1
  300. package/dist/c-HYDTS5OP.min.js +0 -1
  301. package/dist/c-I4QJ6YLM.min.js +0 -1
  302. package/dist/c-IK33LNZ6.min.js +0 -1
  303. package/dist/c-IK3PZHRY.min.js +0 -1
  304. package/dist/c-JIMJF6F6.min.js +0 -1
  305. package/dist/c-JUKIWTBJ.min.js +0 -1
  306. package/dist/c-KKPMHAZC.min.js +0 -1
  307. package/dist/c-L6WNDBHV.min.js +0 -1
  308. package/dist/c-LDEX5OFW.min.js +0 -1
  309. package/dist/c-LESEUVC5.min.js +0 -1
  310. package/dist/c-LYQMZMZQ.min.js +0 -1
  311. package/dist/c-MB6CV5NC.min.js +0 -1
  312. package/dist/c-MOKJOIPE.min.js +0 -1
  313. package/dist/c-N3FXLRNT.min.js +0 -1
  314. package/dist/c-N5NPTJVJ.min.js +0 -1
  315. package/dist/c-NHBL4J67.min.js +0 -1
  316. package/dist/c-ODG6TFSY.min.js +0 -1
  317. package/dist/c-PRIKOLTE.min.js +0 -1
  318. package/dist/c-PSKKFZNP.min.js +0 -1
  319. package/dist/c-PSNI6KAZ.min.js +0 -1
  320. package/dist/c-QAVFOEUY.min.js +0 -1
  321. package/dist/c-R2P4RR7Q.min.js +0 -1
  322. package/dist/c-RFC7UAG7.min.js +0 -1
  323. package/dist/c-S3AZX5PP.min.js +0 -1
  324. package/dist/c-SGAURYHG.min.js +0 -1
  325. package/dist/c-SJMWU6UX.min.js +0 -1
  326. package/dist/c-STIIGQOD.min.js +0 -1
  327. package/dist/c-T2ASIJVZ.min.js +0 -1
  328. package/dist/c-T2V7O2LO.min.js +0 -1
  329. package/dist/c-TKG2NP7G.min.js +0 -1
  330. package/dist/c-TX3THUTO.min.js +0 -1
  331. package/dist/c-TX7XJM3Z.min.js +0 -1
  332. package/dist/c-UC7SIU2W.min.js +0 -1
  333. package/dist/c-UMXSJIOV.min.js +0 -1
  334. package/dist/c-VRSXMLYF.min.js +0 -1
  335. package/dist/c-VSLWSAN2.min.js +0 -1
  336. package/dist/c-VXLOLYTO.min.js +0 -1
  337. package/dist/c-W4ZUKSEQ.min.js +0 -1
  338. package/dist/c-WCBRPILW.min.js +0 -1
  339. package/dist/c-WGHT7OCY.min.js +0 -1
  340. package/dist/c-WWCW3APR.min.js +0 -1
  341. package/dist/c-XSB27XPS.min.js +0 -1
  342. package/dist/c-Y6PYUMFU.min.js +0 -1
  343. package/dist/c-YDECTEUW.min.js +0 -1
  344. package/dist/c-YF3YKVQI.min.js +0 -1
  345. package/dist/c-YLZIV3VS.min.js +0 -1
  346. package/dist/c-ZIVPFTOC.min.js +0 -1
@@ -0,0 +1,20 @@
1
+ export interface MinGapPlacementOptions {
2
+ /** Preferred coordinate for each item, in order. */
3
+ desired: readonly number[];
4
+ /** Minimum distance between item i and i + 1. */
5
+ minGaps: readonly number[];
6
+ /** Optional least-squares weight per desired coordinate. */
7
+ weights?: readonly number[];
8
+ /** Optional lower bound for the first coordinate. */
9
+ min?: number;
10
+ /** Optional upper bound for the last coordinate. */
11
+ max?: number;
12
+ }
13
+ /**
14
+ * Least-squares placement with fixed order and per-pair minimum gaps.
15
+ *
16
+ * The gap constraints are removed with cumulative offsets, then weighted
17
+ * isotonic regression (pool-adjacent-violators) solves the remaining
18
+ * non-decreasing placement. Bounds apply to the whole ordered sequence.
19
+ */
20
+ export declare function placeWithMinGap(options: MinGapPlacementOptions): number[];
@@ -58,9 +58,14 @@ export type { ChartRecipe, ChartRecipeFrameFamily, ChartRecipePortability, DataR
58
58
  export { getChartRecipe, getRegisteredRecipeCapabilities, hasRegisteredRecipeCapabilities, listChartRecipes, registerChartRecipe, resolveChartRecipe, unregisterChartRecipe } from "./ai/chartRecipeRegistry";
59
59
  export { suggestDashboard } from "./ai/suggestDashboard";
60
60
  export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } from "./ai/suggestDashboard";
61
- export { suggestStreamCharts } from "./ai/suggestStreamCharts";
62
- export type { SuggestStreamChartsOptions } from "./ai/suggestStreamCharts";
63
- export type { StreamSchema, StreamSuggestion } from "./ai/streamingTypes";
61
+ export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, receivabilityBias } from "./ai/audienceProfile";
62
+ export type { AudienceProfile, AudienceTarget, AudienceBiasResult, ReceptionModality, ReceivabilitySignal, DashboardLayoutPolicy } from "./ai/audienceProfile";
63
+ export { suggestStreamCharts, explainStreamCapabilityFit, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./ai/suggestStreamCharts";
64
+ export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion } from "./ai/suggestStreamCharts";
65
+ export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamFieldRole, StreamShape, StreamThroughput, StreamThroughputBand, StreamThroughputThresholds, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./ai/streamingTypes";
66
+ export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField } from "./ai/streamSchema";
67
+ export { suggestStreamDashboard } from "./ai/suggestStreamDashboard";
68
+ export type { StreamDashboardPanel, StreamDashboardSuggestion, SuggestStreamDashboardOptions } from "./ai/suggestStreamDashboard";
64
69
  export { suggestStretchCharts } from "./ai/suggestStretchCharts";
65
70
  export type { StretchSuggestion, SuggestStretchChartsOptions } from "./ai/suggestStretchCharts";
66
71
  export { repairChartConfig } from "./ai/repairChartConfig";
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Stream suggestion surface re-exported from `semiotic/ai`.
3
+ * Kept as a satellite so the AI barrel stays under the production line ceiling.
4
+ */
5
+ export { suggestStreamCharts, explainStreamCapabilityFit, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./ai/suggestStreamCharts";
6
+ export type { SuggestStreamChartsOptions, SuggestStreamChartsResult, RejectedStreamCapability, StreamStretchSuggestion } from "./ai/suggestStreamCharts";
7
+ export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamFieldRole, StreamShape, StreamThroughput, StreamThroughputBand, StreamThroughputThresholds, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./ai/streamingTypes";
8
+ export { resolveStreamShape, streamKeyFields, streamThroughputBand, pickValueField, pickCategoryField, pickTimeField, pickSeriesField } from "./ai/streamSchema";
9
+ export { suggestStreamDashboard } from "./ai/suggestStreamDashboard";
10
+ export type { StreamDashboardPanel, StreamDashboardSuggestion, SuggestStreamDashboardOptions } from "./ai/suggestStreamDashboard";
@@ -134,13 +134,11 @@ export type { InferIntentField, InferIntentOptions, InferIntentResult } from "./
134
134
  export { suggestDashboard } from "./ai/suggestDashboard";
135
135
  export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } from "./ai/suggestDashboard";
136
136
  export { applyAudienceBias, effectiveFamiliarity, stretchFamiliarityCeiling, receivabilityBias } from "./ai/audienceProfile";
137
- export type { AudienceProfile, AudienceTarget, AudienceBiasResult, ReceptionModality, ReceivabilitySignal } from "./ai/audienceProfile";
137
+ export type { AudienceProfile, AudienceTarget, AudienceBiasResult, ReceptionModality, ReceivabilitySignal, DashboardLayoutPolicy } from "./ai/audienceProfile";
138
138
  export { executivePersona, analystPersona, dataScientistPersona, BUILT_IN_AUDIENCES } from "./ai/audiences";
139
139
  export { suggestStretchCharts } from "./ai/suggestStretchCharts";
140
140
  export type { StretchSuggestion, SuggestStretchChartsOptions } from "./ai/suggestStretchCharts";
141
- export { suggestStreamCharts, registerStreamChartCapability, unregisterStreamChartCapability, getStreamCapabilities } from "./ai/suggestStreamCharts";
142
- export type { SuggestStreamChartsOptions } from "./ai/suggestStreamCharts";
143
- export type { StreamSchema, StreamFieldSchema, StreamFieldKind, StreamChartCapability, StreamIntentScorer, StreamSuggestion } from "./ai/streamingTypes";
141
+ export * from "./semiotic-ai-stream";
144
142
  export { diffProfile } from "./ai/diffProfile";
145
143
  export type { ProfileDiff, FieldTypeChange, PrimaryRoleChange, PrimaryRole } from "./ai/diffProfile";
146
144
  export { repairChartConfig } from "./ai/repairChartConfig";
@@ -170,8 +168,8 @@ export type { AuditVisualizationControlsOptions, ControlAuditFinding, ControlAud
170
168
  export type { VisualizationControlDefinition } from "./controls/controlContract";
171
169
  export { IntentMark } from "./ai/IntentMark";
172
170
  export type { IntentMarkProps } from "./ai/IntentMark";
173
- export { summarizeIntentManifest, intentManifestFromRecipe } from "./ai/intentManifest";
174
- export type { IntentManifest, IntentManifestFromRecipeOptions } from "./ai/intentManifest";
171
+ export { summarizeIntentManifest, intentManifestFromRecipe, dashboardIntentManifest } from "./ai/intentManifest";
172
+ export type { IntentManifest, IntentManifestFromRecipeOptions, DashboardIntentManifest } from "./ai/intentManifest";
175
173
  export { listIntents, getIntent, registerIntent, BUILT_IN_INTENT_IDS } from "./ai/intents";
176
174
  export type { BuiltInIntentId, IntentDescriptor, IntentFieldKind, IntentId, IntentSignals } from "./ai/intents";
177
175
  export { proposeVariant, evaluateVariantProposal, registerVariantDiscovery, getRegisteredVariantDiscovery, clearVariantDiscovery } from "./ai/variantDiscovery";
@@ -12,6 +12,9 @@ import { RingBuffer } from "./realtime/RingBuffer";
12
12
  import { IncrementalExtent } from "./realtime/IncrementalExtent";
13
13
  import { RunningStats } from "./realtime/RunningStats";
14
14
  import { WindowAccumulator, statValue, bandBounds } from "./realtime/WindowAccumulator";
15
+ import { TDigest } from "./realtime/TDigest";
16
+ import { HyperLogLog } from "./realtime/HyperLogLog";
17
+ import { applyChangelog } from "./realtime/applyChangelog";
15
18
  import { parseWindowDuration } from "./realtime/parseWindowDuration";
16
19
  import { ReorderBuffer } from "./realtime/ReorderBuffer";
17
20
  import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
@@ -20,10 +23,11 @@ import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
20
23
  import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
21
24
  import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
22
25
  export { registerBuiltInXYPlugins } from "./stream/xyPlugins/registerBuiltIn";
23
- export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RunningStats, WindowAccumulator, statValue, bandBounds, parseWindowDuration, ReorderBuffer, RealtimeLineChart, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
26
+ export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RunningStats, WindowAccumulator, statValue, bandBounds, TDigest, HyperLogLog, applyChangelog, parseWindowDuration, ReorderBuffer, RealtimeLineChart, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
24
27
  export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, markTooltipChrome, } from "./Tooltip/Tooltip";
25
28
  export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
26
29
  export type { WindowType, AggregateStat, AggregateBand, WindowAccumulatorConfig, AggregatedWindow, } from "./realtime/WindowAccumulator";
30
+ export type { ChangelogOp, ApplyChangelogOptions, ApplyChangelogResult, } from "./realtime/applyChangelog";
27
31
  export type { AggregateConfig, AggregatedRealtimeDatum } from "./charts/realtime/aggregate";
28
32
  export type { LatePolicy, ReorderBufferConfig, ReorderResult, } from "./realtime/ReorderBuffer";
29
33
  export type { EventTimeConfig } from "./charts/realtime/eventTime";
@@ -35,7 +39,7 @@ export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWate
35
39
  export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
36
40
  export type { FrameTextAnnotation, FrameTextPosition, } from "./charts/shared/frameTextAnnotation";
37
41
  export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, CrosshairStyle, HoverAnnotationConfig, HoverData, RealtimeFrameHandle } from "./realtime/types";
38
- export type { Style, StreamXYFrameProps, StreamXYFrameHandle, StreamChartType } from "./stream/types";
42
+ export type { Style, StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, SourceLiveness, StalenessConfig, DecayConfig, PulseConfig } from "./stream/types";
39
43
  export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType } from "./stream/networkTypes";
40
44
  export { bandFromAge, DEFAULT_LIFECYCLE_THRESHOLDS } from "./realtime/lifecycleBands";
41
45
  export type { LifecycleBand, LifecycleBandThresholds } from "./realtime/lifecycleBands";
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Streaming / realtime types re-exported from the root `semiotic` entry.
3
+ * Satellite of `semiotic.ts` so the root barrel stays under the production
4
+ * line ceiling.
5
+ */
6
+ export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, AnnotationAnchorMode, CrosshairStyle, HoverAnnotationConfig, HoverData, RealtimeFrameHandle } from "./realtime/types";
7
+ export type { RealtimeLineChartHandle, RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
8
+ export type { AggregateConfig, AggregatedRealtimeDatum } from "./charts/realtime/aggregate";
9
+ export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
10
+ export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
11
+ export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
12
+ export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
13
+ export { useSyncedPushData, syncPushBuffer } from "./charts/shared/useSyncedPushData";
14
+ export type { SyncedPushHandle, SyncedPushDataOptions, PushIdAccessor } from "./charts/shared/useSyncedPushData";
@@ -36,6 +36,7 @@ export type { GlyphDef, GlyphPart } from "./stream/glyphDef";
36
36
  export type { GlyphSceneNode, SceneAccessibilityMetadata, Style } from "./stream/types";
37
37
  export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue, } from "./types/legendTypes";
38
38
  export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
39
+ export type { RealtimeFrameHandle } from "./realtime/types";
39
40
  export type { CustomLayout, LayoutContext, LayoutResult } from "./stream/customLayout";
40
41
  export type { LineChartProps } from "./charts/xy/LineChart";
41
42
  export type { BumpChartProps, RankedBumpData, RankedBumpDatum, RankBumpDataOptions, } from "./charts/xy/BumpChart";
@@ -116,8 +116,8 @@ export { buildNavigationTree } from "./ai/navigationTree";
116
116
  export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
117
117
  export { IntentMark } from "./ai/IntentMark";
118
118
  export type { IntentMarkProps } from "./ai/IntentMark";
119
- export { intentManifestFromRecipe, summarizeIntentManifest } from "./ai/intentManifest";
120
- export type { IntentManifest, IntentManifestFromRecipeOptions } from "./ai/intentManifest";
119
+ export { intentManifestFromRecipe, summarizeIntentManifest, dashboardIntentManifest } from "./ai/intentManifest";
120
+ export type { IntentManifest, IntentManifestFromRecipeOptions, DashboardIntentManifest } from "./ai/intentManifest";
121
121
  export { useNavigationSync } from "./ai/useNavigationSync";
122
122
  export type { UseNavigationSyncOptions, UseNavigationSyncResult } from "./ai/useNavigationSync";
123
123
  export type { ChartContainerProps, ChartContainerHandle, ChartContainerDataAudit, ChartContainerDataAuditOptions, ChartContainerMobileOptions, ChartNotification, ChartNotificationLevel } from "./ChartContainer";
@@ -146,15 +146,7 @@ export { darkenColor, lightenColor } from "./charts/shared/colorManipulation";
146
146
  export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
147
147
  export { smartTooltipEntries } from "./charts/shared/tooltipUtils";
148
148
  export type { SmartTooltipEntry, SmartTooltipResult } from "./charts/shared/tooltipUtils";
149
- export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, AnnotationAnchorMode, CrosshairStyle, HoverAnnotationConfig, HoverData, RealtimeFrameHandle } from "./realtime/types";
150
- export type { RealtimeLineChartHandle, RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
151
- export type { AggregateConfig, AggregatedRealtimeDatum } from "./charts/realtime/aggregate";
152
- export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps, TemporalHistogramProps } from "./charts/realtime/RealtimeHistogram";
153
- export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
154
- export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
155
- export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
156
- export { useSyncedPushData, syncPushBuffer } from "./charts/shared/useSyncedPushData";
157
- export type { SyncedPushHandle, SyncedPushDataOptions, PushIdAccessor } from "./charts/shared/useSyncedPushData";
149
+ export * from "./semiotic-stream-types";
158
150
  export type { AnnotationProvenance, AnnotationSource, AnnotationActorKind, AnnotationBasis, AnnotationLifecycle, AnnotationFreshness, AnnotationStatus, AnnotationAnchor, Annotated } from "./ai/annotationProvenance";
159
151
  export { MobileAnnotationCalloutList } from "./MobileAnnotationCalloutList";
160
152
  export type { MobileAnnotationCalloutListProps } from "./MobileAnnotationCalloutList";
@@ -0,0 +1,2 @@
1
+ import type { AnimatedGifOptions } from "./animatedGif";
2
+ export declare function encodeSvgFramesToGif(svgFrames: string[], width: number, height: number, options?: Pick<AnimatedGifOptions, "fps" | "loop" | "scale">): Promise<Buffer>;
@@ -0,0 +1,2 @@
1
+ import type { RenderToImageOptions } from "./renderToStaticSVG";
2
+ export declare function rasterizeSVG(svg: string, width: number, height: number, options: RenderToImageOptions): Promise<Buffer>;
@@ -0,0 +1,2 @@
1
+ /** SVG rendering needs scene builders without importing the canvas painters. */
2
+ export declare function registerServerXYPlugins(): void;
@@ -1,3 +1,4 @@
1
+ import type { LabelLayoutEvidence } from "../text/labelPlacement";
1
2
  /**
2
3
  * Render evidence — machine-readable ground truth about what a server render
3
4
  * actually produced, emitted from the same scene the SVG converter walks.
@@ -20,6 +21,8 @@ import type { ArtifactTransferStatus, PortableArtifactContract } from "../artifa
20
21
  import type { ArtifactIdentityBinding } from "../artifact/identity";
21
22
  export type SemanticViabilityStatus = "meaningful" | "degraded" | "degenerate" | "not-assessed";
22
23
  export interface RenderEvidence {
24
+ /** Optional post-placement label assessment; mark emptiness retains its meaning. */
25
+ layout?: LabelLayoutEvidence;
23
26
  /** SHA-256 of the final serialized SVG plus resolved coordinate context, including chart chrome. */
24
27
  sceneHash?: string;
25
28
  /** Version 2 replaces the evidence envelope's legacy mark-count-only hash. */
@@ -155,6 +158,7 @@ interface BuildEvidenceInput {
155
158
  annotations?: unknown;
156
159
  /** Static annotation pass accounting; omitted by callers that have none. */
157
160
  annotationRender?: {
161
+ layout?: LabelLayoutEvidence;
158
162
  inputCount: number;
159
163
  renderedCount: number;
160
164
  unrenderedCount: number;
@@ -25,6 +25,11 @@ export declare const CHART_CONFIGS: {
25
25
  MinimapChart: ChartConfig;
26
26
  ScatterplotMatrix: ChartConfig;
27
27
  TemporalHistogram: ChartConfig;
28
+ RealtimeLineChart: ChartConfig;
29
+ RealtimeHistogram: ChartConfig;
30
+ RealtimeHeatmap: ChartConfig;
31
+ RealtimeSwarmChart: ChartConfig;
32
+ RealtimeWaterfallChart: ChartConfig;
28
33
  XYCustomChart: ChartConfig;
29
34
  BarChart: ChartConfig;
30
35
  StackedBarChart: ChartConfig;
@@ -0,0 +1,6 @@
1
+ import type { ChartConfig } from "./serverChartConfigShared";
2
+ export declare const realtimeLineChart: ChartConfig;
3
+ export declare const realtimeHistogram: ChartConfig;
4
+ export declare const realtimeHeatmap: ChartConfig;
5
+ export declare const realtimeSwarmChart: ChartConfig;
6
+ export declare const realtimeWaterfallChart: ChartConfig;
@@ -0,0 +1,3 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ /** Mirror the controlled-data path of useRealtimeCategoryColors. */
3
+ export declare function realtimeCategoryColors(rows: Datum[], common: Datum, rest: Datum, order: "discovery" | "explicit-then-alpha"): Record<string, string> | undefined;
@@ -1,3 +1,5 @@
1
+ import type { LabelMeasurer } from "../text/labelMeasurement";
2
+ import type { LabelLayoutEvidence } from "../text/labelPlacement";
1
3
  import type { Datum, DatumValue } from "../charts/shared/datumTypes";
2
4
  /**
3
5
  * Static annotation rendering for server-side SVG.
@@ -37,6 +39,12 @@ interface AnnotationLayout {
37
39
  }
38
40
  export interface StaticAnnotationConfig {
39
41
  annotations?: Datum[];
42
+ margin?: {
43
+ left: number;
44
+ right: number;
45
+ };
46
+ /** Optional renderer-owned metrics; omitted metrics remain explicitly estimated. */
47
+ labelMeasurer?: LabelMeasurer;
40
48
  autoPlaceAnnotations?: AutoPlaceAnnotations;
41
49
  scales: AnnotationScales;
42
50
  layout: AnnotationLayout;
@@ -75,6 +83,7 @@ export interface StaticAnnotationConfig {
75
83
  }
76
84
  /** Annotation accounting emitted by {@link renderStaticAnnotations}. */
77
85
  export interface StaticAnnotationRenderResult {
86
+ layout?: LabelLayoutEvidence;
78
87
  /** Entries requested by the caller, including lifecycle-hidden entries. */
79
88
  inputCount: number;
80
89
  /** Entries that survived lifecycle filtering and reached the dispatch pass. */
@@ -1,8 +1,8 @@
1
1
  import type { SceneNode, SceneDatum, LineSceneNode, AreaSceneNode, PointSceneNode, SymbolSceneNode, RectSceneNode, HeatcellSceneNode, Style, StreamScales, CurveType } from "./types";
2
2
  import type { SymbolName } from "./symbolPath";
3
3
  import type { Datum } from "../charts/shared/datumTypes";
4
- export declare function buildLineNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, style: Style, group?: string): LineSceneNode;
5
- export declare function buildAreaNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Datum) => number): AreaSceneNode;
4
+ export declare function buildLineNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, style: Style, group?: string, getPointId?: (d: Datum) => string): LineSceneNode;
5
+ export declare function buildAreaNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Datum) => number, getPointId?: (d: Datum) => string): AreaSceneNode;
6
6
  /** Per-group-per-x stacked top values, keyed by group then x */
7
7
  export type StackedTops = Map<string, Map<number, number>>;
8
8
  export type StackBaseline = "zero" | "wiggle" | "silhouette" | "diverging";
@@ -30,7 +30,7 @@ export declare function computeDivergingStackExtent(xValues: number[], groupKeys
30
30
  export declare function buildStackedAreaNodes(groups: {
31
31
  key: string;
32
32
  data: Datum[];
33
- }[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, styleFn: (group: string, sampleDatum?: Datum) => Style, normalize?: boolean, curve?: CurveType, baseline?: StackBaseline): {
33
+ }[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, styleFn: (group: string, sampleDatum?: Datum) => Style, normalize?: boolean, curve?: CurveType, baseline?: StackBaseline, getPointId?: (d: Datum) => string): {
34
34
  nodes: AreaSceneNode[];
35
35
  stackedTops: StackedTops;
36
36
  };
@@ -1,8 +1,11 @@
1
- import type { StalenessConfig } from "./types";
1
+ import type { SourceLiveness, StalenessConfig } from "./types";
2
2
  interface StalenessBadgeProps {
3
3
  isStale: boolean;
4
4
  position?: StalenessConfig["badgePosition"];
5
+ state?: SourceLiveness;
6
+ settling?: boolean;
5
7
  }
8
+ export declare function resolveStalenessBadgeState(isStale: boolean, state?: SourceLiveness, settling?: boolean): SourceLiveness;
6
9
  /**
7
10
  * Live/stale indicator chip shown in a corner of a streaming chart when
8
11
  * `staleness.showBadge` is set.
@@ -11,5 +14,5 @@ interface StalenessBadgeProps {
11
14
  * is pixel-identical across families. The badge sits above the canvas and does
12
15
  * not intercept pointer events.
13
16
  */
14
- export declare function StalenessBadge({ isStale, position }: StalenessBadgeProps): import("react").JSX.Element;
17
+ export declare function StalenessBadge({ isStale, position, state, settling, }: StalenessBadgeProps): import("react").JSX.Element;
15
18
  export {};
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Identity-keyed line/area path interpolation for XY transitions.
3
+ *
4
+ * Path vertices join by pointIdAccessor (or unique streaming x) so a sliding
5
+ * window slides retained points instead of interpolating by array index.
6
+ */
7
+ import type { AreaSceneNode, LineSceneNode, SceneNode } from "./types";
8
+ import type { PrevPath, TransitionContext } from "./pipelineTransitionTypes";
9
+ export declare function copyPathPoint(point: [number, number]): [number, number];
10
+ /**
11
+ * Align previous path vertices to the next path by identity key.
12
+ *
13
+ * Retained keys keep their previous coordinates so a sliding window slides
14
+ * instead of interpolating vertex i → vertex i. Newly entered keys grow from
15
+ * the nearest already-matched neighbor (the window boundary).
16
+ */
17
+ export declare function joinPathByIdentity(prevPath: [number, number][], prevIds: string[], nextPath: [number, number][], nextIds: string[]): {
18
+ prev: [number, number][];
19
+ target: [number, number][];
20
+ };
21
+ export declare function resolvePathIds(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, pathLength: number): string[] | undefined;
22
+ export declare function snapshotPathNode(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, key: string, prevPathMap: Map<string, PrevPath>): void;
23
+ /** Set up line/area path interpolation. Returns whether the path changed. */
24
+ export declare function startPathTransition(ctx: TransitionContext, node: LineSceneNode | AreaSceneNode, prevPath: PrevPath | undefined, matchedPrevPathKeys: Set<string>, key: string): boolean;
25
+ export declare function collectExitPathNodes(prevPathMap: Map<string, PrevPath>, matchedPrevPathKeys: Set<string>): SceneNode[];
26
+ export declare function advancePathNode(node: LineSceneNode | AreaSceneNode, t: number): void;
27
+ export declare function snapPathNode(node: LineSceneNode | AreaSceneNode): void;
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Shared types for XY pipeline transitions.
3
+ *
4
+ * Kept separate from the discrete-mark orchestrator and the line/area path
5
+ * join so those modules can import without a cycle.
6
+ */
7
+ import type { GlyphDef } from "./glyphDef";
8
+ import type { SceneNode } from "./types";
9
+ import type { Datum } from "../charts/shared/datumTypes";
10
+ import type { ActiveTransition } from "./pipelineTransitionUtils";
11
+ export type PrevPosition = {
12
+ x: number;
13
+ y: number;
14
+ w?: number;
15
+ h?: number;
16
+ r?: number;
17
+ opacity?: number;
18
+ openY?: number;
19
+ closeY?: number;
20
+ highY?: number;
21
+ lowY?: number;
22
+ glyph?: GlyphDef;
23
+ };
24
+ export type PrevPath = {
25
+ topPath?: [number, number][];
26
+ bottomPath?: [number, number][];
27
+ path?: [number, number][];
28
+ pathIds?: string[];
29
+ opacity?: number;
30
+ };
31
+ /** Context needed from PipelineStore for identity resolution */
32
+ export interface TransitionContext {
33
+ runtimeMode?: "streaming" | "bounded";
34
+ getX: (d: Datum) => number;
35
+ getY: (d: Datum) => number;
36
+ getCategory?: (d: Datum) => string;
37
+ getPointId?: (d: Datum) => string;
38
+ }
39
+ export interface TransitionState {
40
+ scene: SceneNode[];
41
+ exitNodes: SceneNode[];
42
+ activeTransition: ActiveTransition | null;
43
+ }
@@ -7,39 +7,14 @@
7
7
  * - startTransition: sets up interpolation from old→new positions
8
8
  * - advanceTransition: per-frame tick with easing
9
9
  *
10
- * Dependencies: pipelineTransitionUtils (lerp, easing, ActiveTransition)
10
+ * Line/area path join lives in pipelinePathJoin.ts.
11
11
  * Consumed by: PipelineStore.computeScene (after decay/pulse)
12
12
  */
13
13
  import type { SceneNode, TransitionConfig, Style } from "./types";
14
- import type { GlyphDef } from "./glyphDef";
15
- import type { ActiveTransition } from "./pipelineTransitionUtils";
16
- import type { Datum } from "../charts/shared/datumTypes";
17
- export type PrevPosition = {
18
- x: number;
19
- y: number;
20
- w?: number;
21
- h?: number;
22
- r?: number;
23
- opacity?: number;
24
- openY?: number;
25
- closeY?: number;
26
- highY?: number;
27
- lowY?: number;
28
- glyph?: GlyphDef;
29
- };
30
- export type PrevPath = {
31
- topPath?: [number, number][];
32
- bottomPath?: [number, number][];
33
- path?: [number, number][];
34
- opacity?: number;
35
- };
36
- /** Context needed from PipelineStore for identity resolution */
37
- export interface TransitionContext {
38
- runtimeMode?: "streaming" | "bounded";
39
- getX: (d: Datum) => number;
40
- getY: (d: Datum) => number;
41
- getCategory?: (d: Datum) => string;
42
- }
14
+ import { joinPathByIdentity } from "./pipelinePathJoin";
15
+ import type { PrevPath, PrevPosition, TransitionContext, TransitionState } from "./pipelineTransitionTypes";
16
+ export type { PrevPath, PrevPosition, TransitionContext, TransitionState };
17
+ export { joinPathByIdentity };
43
18
  /**
44
19
  * Get a stable identity key for a scene node.
45
20
  *
@@ -69,11 +44,6 @@ export declare function resolveMarkOpacity(style?: Style | null): number;
69
44
  * Snapshot current scene node positions before rebuild.
70
45
  */
71
46
  export declare function snapshotPositions(ctx: TransitionContext, scene: SceneNode[], prevPositionMap: Map<string, PrevPosition>, prevPathMap: Map<string, PrevPath>): void;
72
- export interface TransitionState {
73
- scene: SceneNode[];
74
- exitNodes: SceneNode[];
75
- activeTransition: ActiveTransition | null;
76
- }
77
47
  /**
78
48
  * After scene rebuild, set up transition from old to new positions.
79
49
  * Detects entering nodes (new, no prev match) and exiting nodes (prev, no new match).
@@ -5,9 +5,10 @@ import type { StreamScales } from "./types";
5
5
  * Lines, areas, and ribbons must share this invariant: datum[i] describes the
6
6
  * same observation as path[i], including with descending scales.
7
7
  */
8
- export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number): {
8
+ export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number, getPointId?: (d: Datum) => string): {
9
9
  topPath: [number, number][];
10
10
  bottomPath: [number, number][];
11
11
  rawValues: number[];
12
12
  datum: Datum[];
13
+ pathIds?: string[];
13
14
  };
@@ -21,7 +21,16 @@ export interface TransitionConfig {
21
21
  /** Easing function (default: "ease-out") */
22
22
  easing?: "ease-out" | "linear";
23
23
  }
24
+ export type SourceLiveness = "live" | "stale" | "stopped" | "failed" | "settling";
24
25
  export interface StalenessConfig {
26
+ /**
27
+ * Override the ingest-age derivation. A stopped or failed source should
28
+ * read "Stopped" / "Failed", not "Stale". A retract stream can pass
29
+ * `"settling"` (or `settling: true`) while changelog ops are coalescing.
30
+ */
31
+ state?: SourceLiveness;
32
+ /** Retract stream is still coalescing. Equivalent to `state: "settling"`. */
33
+ settling?: boolean;
25
34
  /**
26
35
  * ms without data before "stale" (default: 5000). In graded mode this
27
36
  * is the base TTL the lifecycle bands are measured against — `aging`
@@ -18,7 +18,7 @@ export type { SceneRenderBackend, SceneRenderMode } from "./sceneRenderBackendTy
18
18
  export type { ThemeSemanticColors } from "./streamThemeTypes";
19
19
  export type { AxisTickFormat, AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
20
20
  import type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
21
- export type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
21
+ export type { DecayConfig, PulseConfig, SourceLiveness, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
22
22
  export type SceneDatum = Datum | null;
23
23
  export type SeriesDatum = Datum[] | null;
24
24
  export type MarginalType = "histogram" | "violin" | "ridgeline" | "boxplot";
@@ -111,6 +111,12 @@ export interface LineSceneNode {
111
111
  strokeGradient?: GradientConfig;
112
112
  /** Curve interpolation type (default: linear / straight segments) */
113
113
  curve?: CurveType;
114
+ /**
115
+ * Per-vertex identity keys from `pointIdAccessor`, parallel to `path`.
116
+ * Path transitions join by these keys so a sliding window slides retained
117
+ * vertices instead of interpolating by array index.
118
+ */
119
+ pathIds?: string[];
114
120
  /** Per-vertex decay opacities (oldest→newest = minOpacity→1.0). Set by PipelineStore.applyDecay. */
115
121
  _decayOpacities?: number[];
116
122
  /** Animation target opacity (set during enter/exit transitions) */
@@ -170,6 +176,12 @@ export interface AreaSceneNode {
170
176
  _pulseColor?: string;
171
177
  /** Curve interpolation type (default: linear / straight segments) */
172
178
  curve?: CurveType;
179
+ /**
180
+ * Per-vertex identity keys from `pointIdAccessor`, parallel to `topPath` /
181
+ * `bottomPath`. Path transitions join by these keys so a sliding window
182
+ * slides retained vertices instead of interpolating by array index.
183
+ */
184
+ pathIds?: string[];
173
185
  /** Per-vertex decay opacities (oldest→newest = minOpacity→1.0). Set by PipelineStore.applyDecay. */
174
186
  _decayOpacities?: number[];
175
187
  /** Animation target opacity (set during enter/exit transitions) */
@@ -644,6 +656,14 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
644
656
  arrowOfTime?: ArrowOfTime;
645
657
  windowMode?: WindowMode;
646
658
  windowSize?: number;
659
+ /**
660
+ * Ring-buffer capacity. Alias for `windowSize` — prefer this name when
661
+ * talking to a Kafka Streams / Flink audience, where "window" means the
662
+ * aggregation window (`aggregate.window`), not the eviction policy.
663
+ */
664
+ capacity?: number;
665
+ /** Alias for `windowMode`. */
666
+ capacityMode?: WindowMode;
647
667
  timeAccessor?: string | ((d: T) => number);
648
668
  xScaleType?: "linear" | "log" | "time";
649
669
  yScaleType?: "linear" | "log" | "symlog";
@@ -733,7 +753,10 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
733
753
  x: [number, number];
734
754
  y: [number, number];
735
755
  } | null) => void;
736
- /** Accessor for unique point IDs used by point-anchored annotations */
756
+ /**
757
+ * Accessor for unique point IDs used by point-anchored annotations,
758
+ * push-mode remove()/update(), and identity-keyed line/area path transitions.
759
+ */
737
760
  pointIdAccessor?: string | ((d: T) => string);
738
761
  annotations?: Datum[];
739
762
  autoPlaceAnnotations?: AutoPlaceAnnotations;
@@ -0,0 +1,15 @@
1
+ import type { LabelBox, LabelFinding } from "./labelPlacement";
2
+ export interface AxisLabelAssessment {
3
+ status: "complete" | "incomplete" | "not-assessed";
4
+ checked: number;
5
+ unsupported: number;
6
+ collisions: number;
7
+ overflows: number;
8
+ findings: LabelFinding[];
9
+ }
10
+ /** Assess painted bounding rectangles; rotated labels use their enclosing box. */
11
+ export declare function assessAxisLabelBoxes(labels: {
12
+ id: string;
13
+ axis: string;
14
+ box: LabelBox;
15
+ }[], bounds: LabelBox, unsupported?: number): AxisLabelAssessment;
@@ -0,0 +1 @@
1
+ export declare function readAxisLabelAssessment(svg: SVGSVGElement): import("./axisLabelAssessment").AxisLabelAssessment;
@@ -0,0 +1,3 @@
1
+ import { type LabelMeasurer } from "./labelMeasurement";
2
+ /** Call after mount; SSR and initial hydration deliberately use estimates. */
3
+ export declare function browserLabelMeasurer(): LabelMeasurer;
@@ -0,0 +1,19 @@
1
+ /** Shared text-metric seam. No DOM work occurs until a caller requests it. */
2
+ export interface LabelFont {
3
+ family: string;
4
+ version: string | number;
5
+ size: number;
6
+ weight: string | number;
7
+ }
8
+ export interface LabelMeasurement {
9
+ width: number;
10
+ height: number;
11
+ ascent: number;
12
+ /** Distance from the painted left edge to the text origin (italic overhang). */
13
+ left?: number;
14
+ source: "measured" | "estimated";
15
+ }
16
+ export type LabelMeasurer = (text: string, font: LabelFont) => LabelMeasurement;
17
+ export declare const estimateLabel: LabelMeasurer;
18
+ /** Cache belongs to the font/renderer session and is bounded for push mode. */
19
+ export declare function cacheLabelMeasurer(measure: LabelMeasurer): LabelMeasurer;