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
package/README.md CHANGED
@@ -7,6 +7,8 @@
7
7
  [![TypeScript](https://img.shields.io/badge/TypeScript-built--in-blue.svg)](https://www.typescriptlang.org/)
8
8
  [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/nteract-semiotic-badge.png)](https://mseep.ai/app/nteract-semiotic)
9
9
 
10
+ [![MCP Queen operational grade](https://mcpqueen.com/badge/io.github.nteract/semiotic.svg)](https://mcpqueen.com/s/io.github.nteract/semiotic)
11
+
10
12
  A React data visualization library designed for AI-assisted development.
11
13
 
12
14
  Start with a small chart component. Add network graphs, streaming data and
@@ -24,22 +26,24 @@ evidence scope; source availability does not establish installed or deployed par
24
26
  <img src="./docs/public/assets/img/semiotic-release-dashboard.svg" alt="Semiotic release dashboard showing chart count, bundle sizes, capability coverage, chart families, and documentation growth" width="100%">
25
27
  <!-- semiotic-readme-dashboard:end -->
26
28
 
27
- ## What's New in 3.10.1
29
+ ## What's New in 3.10.2
30
+
31
+ 3.10.2 improves realtime aggregation, stream chart recommendations, server
32
+ rendering, and line labels.
28
33
 
29
- 3.10.1 adds Network Atlas recipes and reduces repeated layout work when charts
30
- mount or resize.
34
+ - Stream recommendations cover ordinal and value charts, with audience-aware
35
+ dashboard layouts and explanations for excluded candidates.
36
+ - Realtime charts support keyed changelogs, percentile and distinct-count
37
+ aggregates, per-series line aggregation, and more controlled-data SSR paths.
38
+ - Event-time queues, incremental aggregates, and smaller validation imports
39
+ reduce repeated work and bundle overhead.
40
+ - LineChart direct labels share measured placement across browser and server
41
+ rendering; keyed path transitions preserve point identity during updates.
31
42
 
32
- - Network Atlas includes Motif Braid, Dependency X-Ray, and Flow Circuit
33
- recipes, with interactive examples and an acceptance lab.
34
- - Network charts reuse custom layouts when inputs are unchanged, avoid
35
- duplicate worker solves, and treat palette and font changes as paint-only
36
- updates where possible.
37
- - Atlas readers integrate with themes and observers; network keyboard
38
- activation and live hover announcements are corrected.
39
- - Documentation preview checks and API snapshot parameter extraction are
40
- more reliable.
43
+ Stream suggestion callers should now destructure the result:
44
+ `const { suggestions } = suggestStreamCharts(...)`.
41
45
 
42
- See [the changelog](CHANGELOG.md#3101) for details.
46
+ See [the changelog](CHANGELOG.md#3102---2026-09-18) for details.
43
47
 
44
48
  ## Why Semiotic
45
49
 
@@ -401,42 +405,42 @@ The numbers below are **first-party artifact cost**: the gzip size of Semiotic's
401
405
 
402
406
  | Entry Point | gzip | What's inside |
403
407
  |---|---|---|
404
- | `semiotic/atlas` | **273 KB** | Motif Braid, Dependency Forest, and Flow Circuit readers |
405
- | `semiotic/atlas/core` | **14 KB** | Network Atlas preparation, projections, and evidence queries |
406
- | `semiotic/access` | **36 KB** | Chart Access Contract factory and first-wave baseline contracts |
407
- | `semiotic/evidence` | **50 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
408
+ | `semiotic/atlas` | **270 KB** | Motif Braid, Dependency Forest, and Flow Circuit readers |
409
+ | `semiotic/atlas/core` | **13 KB** | Network Atlas preparation, projections, and evidence queries |
410
+ | `semiotic/access` | **28 KB** | Chart Access Contract factory and first-wave baseline contracts |
411
+ | `semiotic/evidence` | **44 KB** | Chart Evidence Envelope, deterministic hashing, and publication gate |
408
412
  | `semiotic/artifact` | **121 KB** | Renderer-independent contracts, claims, time, policy, grounding, and transfer audits |
409
413
  | `semiotic/artifact/react` | **4 KB** | Accessible progressive disclosure for artifact contracts and policy evaluations |
410
- | `semiotic/line` | **132 KB** | LineChart only — one-chart micro boundary |
411
- | `semiotic/xy` | **163 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
412
- | `semiotic/ordinal` | **131 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
413
- | `semiotic/network` | **151 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
414
- | `semiotic/geo` | **108 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
415
- | `semiotic/realtime` | **161 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
416
- | `semiotic/realtime/core` | **160 KB** | Streaming chart types, HOCs, and buffer helpers |
414
+ | `semiotic/line` | **134 KB** | LineChart only — one-chart micro boundary |
415
+ | `semiotic/xy` | **164 KB** | LineChart, AreaChart, Scatterplot, Heatmap, + 8 more XY charts |
416
+ | `semiotic/ordinal` | **128 KB** | BarChart, PieChart, BoxPlot, Histogram, + 11 more categorical charts |
417
+ | `semiotic/network` | **148 KB** | ForceDirectedGraph, SankeyDiagram, ProcessSankey, Treemap, + 4 more |
418
+ | `semiotic/geo` | **106 KB** | ChoroplethMap, FlowMap, DistanceCartogram, ProportionalSymbolMap |
419
+ | `semiotic/realtime` | **163 KB** | RealtimeLineChart, RealtimeHistogram, + 4 streaming charts |
420
+ | `semiotic/realtime/core` | **162 KB** | Streaming chart types, HOCs, and buffer helpers |
417
421
  | `semiotic/realtime/react` | **1 KB** | Stream status and synced push hooks |
418
- | `semiotic/server` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
419
- | `semiotic/server/node` | **241 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
420
- | `semiotic/server/edge` | **248 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
422
+ | `semiotic/server` | **243 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
423
+ | `semiotic/server/node` | **243 KB** | renderChart, renderDashboard, renderToImage, renderToAnimatedGif |
424
+ | `semiotic/server/edge` | **250 KB** | renderChart, renderChartWithEvidence, renderToStaticSVG, renderDashboard |
421
425
  | `semiotic/utils` | **99 KB** | ThemeProvider, numeric/accessibility audits, serialization — no chart components |
422
- | `semiotic/utils/core` | **91 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
426
+ | `semiotic/utils/core` | **92 KB** | Pure theme helpers, numeric/accessibility audits, and serialization |
423
427
  | `semiotic/utils/react` | **7 KB** | ThemeProvider, useTheme, useReducedMotion, useHighContrast, useStreamStatus |
424
- | `semiotic/recipes` | **111 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
425
- | `semiotic/recipes/core` | **103 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
426
- | `semiotic/recipes/react` | **8 KB** | Glyph and React layout-selection helpers |
427
- | `semiotic/themes` | **12 KB** | Theme presets only (tufte, carbon, etc.) |
428
- | `semiotic/themes/core` | **12 KB** | Theme presets and token helpers |
429
- | `semiotic/themes/react` | **7 KB** | ThemeProvider/useTheme and hooks |
428
+ | `semiotic/recipes` | **110 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
429
+ | `semiotic/recipes/core` | **102 KB** | Pure layout functions (waffle, marimekko, flextree, dagre, …) |
430
+ | `semiotic/recipes/react` | **7 KB** | Glyph and React layout-selection helpers |
431
+ | `semiotic/themes` | **11 KB** | Theme presets only (tufte, carbon, etc.) |
432
+ | `semiotic/themes/core` | **11 KB** | Theme presets and token helpers |
433
+ | `semiotic/themes/react` | **6 KB** | ThemeProvider/useTheme and hooks |
430
434
  | `semiotic/data` | **3 KB** | bin, rollup, groupBy, pivot, fromVegaLite |
431
435
  | `semiotic/value` | **6 KB** | BigNumber — focal-value KPI / scorecard (SingleValueFrame POC) |
432
- | `semiotic/physics` | **167 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
436
+ | `semiotic/physics` | **164 KB** | GaltonBoardChart, EventDropChart, UnitPileChart, CollisionSwarmChart, PacketFlowChart, PhysicsCustomChart |
433
437
  | `semiotic/physics/matter` | **1 KB** | Matter.js migration helpers + optional peer guard (no chart components) |
434
438
  | `semiotic/physics/rapier` | **1 KB** | Rapier peer guard + adapter decision metadata (no chart components) |
435
439
  | `semiotic/ai` | **595 KB** | All schema-backed charts + validation — optimized for LLM code generation |
436
- | `semiotic/ai/core` | **139 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
437
- | `semiotic/controls` | **10 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
440
+ | `semiotic/ai/core` | **138 KB** | suggestCharts, auditData, describeChart, repairChartConfig, tool adapters — no chart components |
441
+ | `semiotic/controls` | **11 KB** | DirectManipulationControl, CircularBrush, MobileStandardControls, auditVisualizationControls — no frame renderer |
438
442
  | `semiotic/rough` | **3 KB** | Optional deterministic Rough.js paint backend — exact Semiotic geometry remains authoritative |
439
- | `semiotic/text` | **1 KB** | Optional Pretext annotation hook — peer package excluded |
443
+ | `semiotic/text` | **2 KB** | Optional Pretext annotation hook — peer package excluded |
440
444
  | `semiotic` | **374 KB** | Full chart API and shared utilities |
441
445
 
442
446
  <!-- semiotic-bundle-sizes:end -->
@@ -458,37 +462,37 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
458
462
 
459
463
  | Public named import | Runtime | gzip cold-consumer bundle |
460
464
  |---|---:|---:|
461
- | `import { MotifBraidChart } from "semiotic/atlas"` | browser | **161.4 KiB** |
462
- | `import { prepareNetworkAtlas } from "semiotic/atlas/core"` | browser | **6.4 KiB** |
463
- | `import { LineChart } from "semiotic"` | browser | **141.4 KiB** |
464
- | `import { LineChart } from "semiotic/xy"` | browser | **141.8 KiB** |
465
- | `import { LineChart } from "semiotic/line"` | browser | **141.7 KiB** |
466
- | `import { BarChart } from "semiotic/ordinal"` | browser | **133.5 KiB** |
467
- | `import { SankeyDiagram } from "semiotic/network"` | browser | **156.9 KiB** |
468
- | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **142.5 KiB** |
465
+ | `import { MotifBraidChart } from "semiotic/atlas"` | browser | **159.5 KiB** |
466
+ | `import { prepareNetworkAtlas } from "semiotic/atlas/core"` | browser | **6.2 KiB** |
467
+ | `import { LineChart } from "semiotic"` | browser | **145.1 KiB** |
468
+ | `import { LineChart } from "semiotic/xy"` | browser | **145.5 KiB** |
469
+ | `import { LineChart } from "semiotic/line"` | browser | **145.3 KiB** |
470
+ | `import { BarChart } from "semiotic/ordinal"` | browser | **133.1 KiB** |
471
+ | `import { SankeyDiagram } from "semiotic/network"` | browser | **154.9 KiB** |
472
+ | `import { RealtimeLineChart } from "semiotic/realtime"` | browser | **147.9 KiB** |
469
473
  | `import { RingBuffer } from "semiotic/realtime/core"` | browser | **0.7 KiB** |
470
474
  | `import { useStreamStatus } from "semiotic/realtime/react"` | browser | **0.6 KiB** |
471
- | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **150.3 KiB** |
475
+ | `import { GaltonBoardChart } from "semiotic/physics"` | browser | **147.4 KiB** |
472
476
  | `import { MATTER_PHYSICS_CAPABILITIES } from "semiotic/physics/matter"` | browser | **0.2 KiB** |
473
477
  | `import { RAPIER_PHYSICS_CAPABILITIES } from "semiotic/physics/rapier"` | browser | **0.2 KiB** |
474
- | `import { renderChart } from "semiotic/server"` | node | **280.8 KiB** |
475
- | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **146.7 KiB** |
476
- | `import { renderToImage } from "semiotic/server/node"` | node | **281.5 KiB** |
477
- | `import { suggestCharts } from "semiotic/ai"` | browser | **259.1 KiB** |
478
- | `import { suggestCharts } from "semiotic/ai/core"` | browser | **46.5 KiB** |
479
- | `import { buildArtifactContract } from "semiotic/artifact"` | browser | **19.7 KiB** |
478
+ | `import { renderChart } from "semiotic/server"` | node | **277.4 KiB** |
479
+ | `import { generateFrameSVGs } from "semiotic/server/edge"` | node | **142.2 KiB** |
480
+ | `import { renderToImage } from "semiotic/server/node"` | node | **278.3 KiB** |
481
+ | `import { suggestCharts } from "semiotic/ai"` | browser | **255.4 KiB** |
482
+ | `import { suggestCharts } from "semiotic/ai/core"` | browser | **39.1 KiB** |
483
+ | `import { buildArtifactContract } from "semiotic/artifact"` | browser | **13.0 KiB** |
480
484
  | `import { ArtifactInspector } from "semiotic/artifact/react"` | browser | **3.8 KiB** |
481
- | `import { createChartAccessContract } from "semiotic/access"` | browser | **33.4 KiB** |
482
- | `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **49.1 KiB** |
485
+ | `import { createChartAccessContract } from "semiotic/access"` | browser | **27.0 KiB** |
486
+ | `import { toEvidenceEnvelope } from "semiotic/evidence"` | browser | **42.3 KiB** |
483
487
  | `import { bin } from "semiotic/data"` | browser | **0.4 KiB** |
484
- | `import { ChoroplethMap } from "semiotic/geo"` | browser | **116.7 KiB** |
488
+ | `import { ChoroplethMap } from "semiotic/geo"` | browser | **115.9 KiB** |
485
489
  | `import { usePretextAnnotations } from "semiotic/text"` | browser | **1.5 KiB** |
486
- | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.2 KiB** |
490
+ | `import { createRoughRenderMode } from "semiotic/rough"` | browser | **3.1 KiB** |
487
491
  | `import { resolveThemePreset } from "semiotic/themes"` | browser | **2.6 KiB** |
488
492
  | `import { resolveThemePreset } from "semiotic/themes/core"` | browser | **2.6 KiB** |
489
- | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.2 KiB** |
490
- | `import { validateProps } from "semiotic/utils"` | browser | **10.4 KiB** |
491
- | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **8.1 KiB** |
493
+ | `import { ThemeProvider } from "semiotic/themes/react"` | browser | **5.1 KiB** |
494
+ | `import { validateProps } from "semiotic/utils"` | browser | **9.8 KiB** |
495
+ | `import { smartTickFormat } from "semiotic/utils/core"` | browser | **2.0 KiB** |
492
496
  | `import { useReducedMotion } from "semiotic/utils/react"` | browser | **2.4 KiB** |
493
497
  | `import { waffleLayout } from "semiotic/recipes"` | browser | **1.7 KiB** |
494
498
  | `import { waffleLayout } from "semiotic/recipes/core"` | browser | **1.7 KiB** |
@@ -496,7 +500,7 @@ Method: fresh `npm pack --ignore-scripts` tarball → temporary consumer → min
496
500
  | `import { BigNumber } from "semiotic/value"` | browser | **5.9 KiB** |
497
501
  | `import { DirectManipulationControl } from "semiotic/controls"` | browser | **1.3 KiB** |
498
502
 
499
- **Line-boundary interpretation:** the retained named import from `semiotic/line` emits 422.6 KiB raw versus 422.6 KiB from `semiotic/xy`; gzip differs by 0.1 KiB (0.0%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
503
+ **Line-boundary interpretation:** the retained named import from `semiotic/line` emits 434.5 KiB raw versus 434.5 KiB from `semiotic/xy`; gzip differs by 0.2 KiB (0.1%). Tree-shaking converges both paths on the same LineChart implementation graph. Treat `semiotic/line` as a narrower API/direct-ESM artifact boundary, not an application-bundle saving. Do not add another per-chart entry until its packed named import beats the family path by both 10 KiB gzip and 7%.
500
504
 
501
505
  <!-- semiotic-cold-consumer:end -->
502
506
 
@@ -627,7 +631,8 @@ host-header allowlisting. For ChatGPT Apps domain verification, set
627
631
  | **`getSchema`** | Return the prop schema for a specific component. Pass `{ component: "LineChart" }` to get its props, or omit `component` to list the complete schema-backed catalog. Components marked `[renderable]` are available through `renderChart`; realtime charts require a browser/live environment. |
628
632
  | **`suggestChart`** | Sample-row recommender. Pass `{ data: [{...}, ...] }` with 1–5 sample objects plus optional broad intent/capability filters. |
629
633
  | **`suggestCharts`** | Capability-based recommender for bounded row data. Returns ranked chart suggestions with scores, reasons, caveats, import paths, and ready-to-use props. |
630
- | **`suggestStreamCharts`** | Recommend realtime charts from a stream schema, throughput, and retention hints. |
634
+ | **`suggestStreamCharts`** | Recommend streaming charts from a schema (shape, key, throughput). Returns `{ suggestions, excluded, stretchSuggestions }`. |
635
+ | **`suggestStreamDashboard`** | Compose a multi-panel dashboard from stream schemas and an audience layout policy. |
631
636
  | **`suggestDashboard`** | Build a multi-panel dashboard suggestion that covers distinct analytical intents. |
632
637
  | **`suggestStretchCharts`** | Recommend audience-literacy stretch picks from an `AudienceProfile`. |
633
638
  | **`repairChartConfig`** | Check whether a requested chart fits a dataset and return ranked alternatives when it does not. |
@@ -107,7 +107,7 @@
107
107
  "src/components/store/selectionProvenance.ts"
108
108
  ],
109
109
  "inventoryVersion": 1,
110
- "repositoryVersion": "3.10.1",
110
+ "repositoryVersion": "3.10.2",
111
111
  "relations": [
112
112
  {
113
113
  "id": "claim-support",
@@ -4594,6 +4594,7 @@
4594
4594
  "AudienceBiasResult",
4595
4595
  "AudienceProfile",
4596
4596
  "AudienceTarget",
4597
+ "DashboardLayoutPolicy",
4597
4598
  "ReceivabilitySignal",
4598
4599
  "ReceptionModality",
4599
4600
  "applyAudienceBias",
@@ -5119,8 +5120,10 @@
5119
5120
  "preservation"
5120
5121
  ],
5121
5122
  "exports": [
5123
+ "DashboardIntentManifest",
5122
5124
  "IntentManifest",
5123
5125
  "IntentManifestFromRecipeOptions",
5126
+ "dashboardIntentManifest",
5124
5127
  "intentManifestFromRecipe",
5125
5128
  "summarizeIntentManifest"
5126
5129
  ]