semiotic 3.10.1 → 3.10.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (353) hide show
  1. package/README.md +64 -63
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/behaviorContracts.cjs +1 -1
  4. package/ai/dist/mcp-server.js +25 -24
  5. package/ai/examples.md +28 -0
  6. package/ai/reference.md +9 -4
  7. package/ai/schema.json +121 -5
  8. package/ai/surface-manifest.json +3 -2
  9. package/ai/system-prompt.md +1 -1
  10. package/ai/task-packets/compare-category-totals.json +7 -53
  11. package/ai/task-packets/compare-category-totals.md +4 -4
  12. package/ai/task-packets/correct-published-chart.json +7 -53
  13. package/ai/task-packets/correct-published-chart.md +4 -4
  14. package/ai/task-packets/index.json +9 -9
  15. package/ai/task-packets/update-live-chart.json +8 -54
  16. package/ai/task-packets/update-live-chart.md +4 -4
  17. package/dist/c-27DCB5T6.min.js +18 -0
  18. package/dist/c-2MONF2P6.min.js +1 -0
  19. package/dist/c-3AGX252H.min.js +1 -0
  20. package/dist/c-3B6JZEZT.min.js +1 -0
  21. package/dist/c-3BYZXCX3.min.js +4 -0
  22. package/dist/c-3DIPZJDO.min.js +1 -0
  23. package/dist/c-3FOUMWLR.min.js +1 -0
  24. package/dist/c-3NA6I656.min.js +2 -0
  25. package/dist/c-3OFVBWQY.min.js +1 -0
  26. package/dist/{c-QA3HMQJP.min.js → c-3PFVJFBK.min.js} +1 -1
  27. package/dist/c-3PPO7ZJF.min.js +4 -0
  28. package/dist/c-3YEW2PK6.min.js +1 -0
  29. package/dist/c-43XNOQNQ.min.js +391 -0
  30. package/dist/c-4JKDJUYD.min.js +1 -0
  31. package/dist/c-4LKK5YWB.min.js +1 -0
  32. package/dist/c-4V3CD337.min.js +1 -0
  33. package/dist/c-4XLHPQTP.min.js +1 -0
  34. package/dist/c-5NYONM6V.min.js +5 -0
  35. package/dist/c-5PIKBUMF.min.js +1 -0
  36. package/dist/c-6IVBV5NO.min.js +1 -0
  37. package/dist/c-7APWCEPL.min.js +1 -0
  38. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  39. package/dist/c-ABMGCCLT.min.js +1 -0
  40. package/dist/c-AINGQGUN.min.js +1 -0
  41. package/dist/c-AXJ2QI3F.min.js +1 -0
  42. package/dist/c-BQYD7T4E.min.js +1 -0
  43. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  44. package/dist/c-C4SXYFXL.min.js +1 -0
  45. package/dist/c-CLDCKFBE.min.js +1 -0
  46. package/dist/c-CLJCJSFU.min.js +1 -0
  47. package/dist/c-CLLCX3PT.min.js +2 -0
  48. package/dist/c-CO4NDAD6.min.js +51 -0
  49. package/dist/c-ECHBKW7U.min.js +1 -0
  50. package/dist/c-EPJWM2UT.min.js +1 -0
  51. package/dist/c-FD2BXSRG.min.js +1 -0
  52. package/dist/c-FHNY57SO.min.js +209 -0
  53. package/dist/c-FMCUQ6JX.min.js +1 -0
  54. package/dist/c-FOTTQHOO.min.js +1 -0
  55. package/dist/c-FU7A5KSY.min.js +1 -0
  56. package/dist/c-GHN6IR4Y.min.js +1 -0
  57. package/dist/{c-J6DVC236.min.js → c-GK263BF4.min.js} +1 -1
  58. package/dist/c-GSCO3FWL.min.js +1 -0
  59. package/dist/c-GYLOSK7M.min.js +1 -0
  60. package/dist/c-HK4OSLZA.min.js +1 -0
  61. package/dist/c-HLGTD5SJ.min.js +1 -0
  62. package/dist/c-HNHKIMIV.min.js +61 -0
  63. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  64. package/dist/c-IIV73MUW.min.js +1 -0
  65. package/dist/c-IJCZGUG6.min.js +31 -0
  66. package/dist/c-ISA6IJ6V.min.js +41 -0
  67. package/dist/c-JC76YAHB.min.js +33 -0
  68. package/dist/c-JJKRER47.min.js +1 -0
  69. package/dist/c-JO6AYCU4.min.js +1 -0
  70. package/dist/c-JOPGDP6N.min.js +1 -0
  71. package/dist/c-JWHPG6S2.min.js +1 -0
  72. package/dist/c-JXVYIXTV.min.js +1 -0
  73. package/dist/c-K2ZIYDI3.min.js +1 -0
  74. package/dist/c-K37JAIWA.min.js +4 -0
  75. package/dist/c-KXH7LFIL.min.js +26 -0
  76. package/dist/c-M43PK7K4.min.js +1 -0
  77. package/dist/c-MTX2AO5S.min.js +1 -0
  78. package/dist/c-N5WT7TXG.min.js +1 -0
  79. package/dist/c-NATWERHZ.min.js +1 -0
  80. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  81. package/dist/c-OVQB75PE.min.js +1 -0
  82. package/dist/c-P3SKRNZN.min.js +1 -0
  83. package/dist/c-P5NXQWIM.min.js +1 -0
  84. package/dist/c-P7BQMVQQ.min.js +1 -0
  85. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  86. package/dist/c-PITYSOPK.min.js +1 -0
  87. package/dist/c-QPO24R7Q.min.js +1 -0
  88. package/dist/c-QXLDCATV.min.js +1 -0
  89. package/dist/c-R2HUSWKB.min.js +1 -0
  90. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  91. package/dist/c-RZPP5ERV.min.js +1 -0
  92. package/dist/c-SAP5KY6R.min.js +9 -0
  93. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  94. package/dist/c-SQNEVNWT.min.js +1 -0
  95. package/dist/c-STHZWF3D.min.js +1 -0
  96. package/dist/c-TIDKVMMZ.min.js +1 -0
  97. package/dist/c-TIMGODBG.min.js +1 -0
  98. package/dist/c-TR7OHUAO.min.js +2 -0
  99. package/dist/c-TVKZC4BY.min.js +1 -0
  100. package/dist/c-U5XVLSHN.min.js +1 -0
  101. package/dist/c-U6NLVFN4.min.js +1 -0
  102. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  103. package/dist/c-UMGHCBH5.min.js +114 -0
  104. package/dist/c-UOPPO26M.min.js +1 -0
  105. package/dist/c-UUDAON4Z.min.js +1 -0
  106. package/dist/c-V32TPPY2.min.js +1 -0
  107. package/dist/c-V5KFJWQQ.min.js +1 -0
  108. package/dist/c-VEMCBQZZ.min.js +100 -0
  109. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  110. package/dist/c-WD2RL76M.min.js +116 -0
  111. package/dist/c-Y342FJ6K.min.js +1 -0
  112. package/dist/c-YL7HJL5J.min.js +1 -0
  113. package/dist/c-YM6CT4LJ.min.js +1 -0
  114. package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
  115. package/dist/c-YQVOKPKR.min.js +1 -0
  116. package/dist/c-YRJ3BJQZ.min.js +1 -0
  117. package/dist/c-YT5KPVNP.min.js +1 -0
  118. package/dist/c-Z6GRGS53.min.js +1 -0
  119. package/dist/c-ZVOFLE2P.min.js +46 -0
  120. package/dist/components/CategoryColors.d.ts +7 -0
  121. package/dist/components/LinkedCharts.d.ts +2 -1
  122. package/dist/components/ai/audienceProfile.d.ts +18 -1
  123. package/dist/components/ai/describeChart.d.ts +5 -1
  124. package/dist/components/ai/intentManifest.d.ts +16 -0
  125. package/dist/components/ai/intentRegistry.d.ts +12 -0
  126. package/dist/components/ai/intents.d.ts +6 -6
  127. package/dist/components/ai/streamSchema.d.ts +19 -0
  128. package/dist/components/ai/streamingTypes.d.ts +57 -11
  129. package/dist/components/ai/suggestCharts.d.ts +1 -1
  130. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  131. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  132. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  133. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  135. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  136. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  137. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  138. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  139. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  140. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  141. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  142. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  143. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  144. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  145. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  146. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  147. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  148. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  149. package/dist/components/charts/shared/knownChartComponents.d.ts +4 -1
  150. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  151. package/dist/components/charts/shared/useChartSetup.d.ts +3 -1
  152. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +1 -1
  153. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  154. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  155. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  156. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  157. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  158. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  159. package/dist/components/data/transforms.d.ts +1 -0
  160. package/dist/components/realtime/HyperLogLog.d.ts +19 -0
  161. package/dist/components/realtime/ReorderBuffer.d.ts +2 -2
  162. package/dist/components/realtime/TDigest.d.ts +22 -0
  163. package/dist/components/realtime/WindowAccumulator.d.ts +22 -5
  164. package/dist/components/realtime/applyChangelog.d.ts +38 -0
  165. package/dist/components/realtime/minHeap.d.ts +3 -0
  166. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +1 -1
  167. package/dist/components/recipes/layout1d.d.ts +2 -20
  168. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  169. package/dist/components/semiotic-ai-core.d.ts +8 -3
  170. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  171. package/dist/components/semiotic-ai.d.ts +4 -6
  172. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  173. package/dist/components/semiotic-stream-types.d.ts +14 -0
  174. package/dist/components/semiotic-xy.d.ts +1 -0
  175. package/dist/components/semiotic.d.ts +3 -11
  176. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  177. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  178. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  179. package/dist/components/server/renderEvidence.d.ts +4 -0
  180. package/dist/components/server/serverChartConfigs.d.ts +5 -0
  181. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  182. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  183. package/dist/components/server/staticAnnotations.d.ts +9 -0
  184. package/dist/components/stream/SceneGraph.d.ts +3 -3
  185. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  186. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  187. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  188. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  189. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  190. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  191. package/dist/components/stream/types.d.ts +25 -2
  192. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  193. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  194. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  195. package/dist/components/text/labelMeasurement.d.ts +19 -0
  196. package/dist/components/text/labelPlacement.d.ts +71 -0
  197. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  198. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  199. package/dist/controls.module.min.js +71 -1
  200. package/dist/geo.min.js +231 -1
  201. package/dist/geo.module.min.js +31 -1
  202. package/dist/network.module.min.js +1 -1
  203. package/dist/ordinal.module.min.js +1 -1
  204. package/dist/physics-matter.module.min.js +1 -1
  205. package/dist/physics-rapier.module.min.js +1 -1
  206. package/dist/physics.module.min.js +1 -1
  207. package/dist/physicsWorker.js +1 -1
  208. package/dist/rough.min.js +2 -1
  209. package/dist/rough.module.min.js +2 -1
  210. package/dist/semiotic-access.module.min.js +1 -1
  211. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  212. package/dist/semiotic-ai-core.d.ts +8 -3
  213. package/dist/semiotic-ai-core.min.js +4 -1
  214. package/dist/semiotic-ai-core.module.min.js +4 -1
  215. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  216. package/dist/semiotic-ai.d.ts +4 -6
  217. package/dist/semiotic-ai.module.min.js +14 -1
  218. package/dist/semiotic-artifact-react.min.js +269 -1
  219. package/dist/semiotic-artifact-react.module.min.js +137 -1
  220. package/dist/semiotic-artifact.min.js +3 -1
  221. package/dist/semiotic-artifact.module.min.js +3 -1
  222. package/dist/semiotic-atlas-core.min.js +2 -1
  223. package/dist/semiotic-atlas-core.module.min.js +1 -1
  224. package/dist/semiotic-atlas-selection.module.min.js +1 -1
  225. package/dist/semiotic-atlas.module.min.js +11 -1
  226. package/dist/semiotic-client-cjs-shared.min.js +1530 -1
  227. package/dist/semiotic-client-glyph.module.min.js +3 -1
  228. package/dist/semiotic-client-responsive.module.min.js +1 -1
  229. package/dist/semiotic-client-shared.module.min.js +1 -1
  230. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  231. package/dist/semiotic-data.min.js +1 -1
  232. package/dist/semiotic-data.module.min.js +1 -1
  233. package/dist/semiotic-evidence.min.js +3 -1
  234. package/dist/semiotic-evidence.module.min.js +3 -1
  235. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  236. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  237. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  238. package/dist/semiotic-experimental-vacp.min.js +1 -1
  239. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  240. package/dist/semiotic-line.module.min.js +1 -1
  241. package/dist/semiotic-realtime-core.d.ts +6 -2
  242. package/dist/semiotic-realtime-core.module.min.js +1 -1
  243. package/dist/semiotic-realtime-react.module.min.js +1 -1
  244. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  245. package/dist/semiotic-recipes-core.module.min.js +72 -1
  246. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  247. package/dist/semiotic-recipes-react.min.js +3 -1
  248. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  249. package/dist/semiotic-server-edge.min.js +651 -1
  250. package/dist/semiotic-server-edge.module.min.js +372 -1
  251. package/dist/semiotic-server-node.min.js +651 -1
  252. package/dist/semiotic-server-node.module.min.js +1 -1
  253. package/dist/semiotic-text.min.js +1 -1
  254. package/dist/semiotic-text.module.min.js +1 -1
  255. package/dist/semiotic-themes-core.min.js +1 -1
  256. package/dist/semiotic-themes-core.module.min.js +1 -1
  257. package/dist/semiotic-themes.min.js +1 -1
  258. package/dist/semiotic-themes.module.min.js +1 -1
  259. package/dist/semiotic-utils-core.min.js +11 -1
  260. package/dist/semiotic-utils-core.module.min.js +8 -1
  261. package/dist/semiotic-value.module.min.js +15 -1
  262. package/dist/semiotic-xy.d.ts +1 -0
  263. package/dist/semiotic.d.ts +3 -11
  264. package/dist/semiotic.module.min.js +10 -1
  265. package/dist/server.min.js +651 -1
  266. package/dist/server.module.min.js +1 -1
  267. package/dist/xy.module.min.js +1 -1
  268. package/package.json +8 -7
  269. package/dist/c-2N7IU2NY.min.js +0 -1
  270. package/dist/c-2RL2QPZJ.min.js +0 -1
  271. package/dist/c-2WK7YJLL.min.js +0 -1
  272. package/dist/c-45CQWZZ6.min.js +0 -1
  273. package/dist/c-4BRHKVKV.min.js +0 -1
  274. package/dist/c-7242NXSG.min.js +0 -1
  275. package/dist/c-7DVPSB5C.min.js +0 -1
  276. package/dist/c-7EGHJU2F.min.js +0 -1
  277. package/dist/c-A7OGOFSL.min.js +0 -1
  278. package/dist/c-AFBSWT77.min.js +0 -1
  279. package/dist/c-AH5HWZWS.min.js +0 -1
  280. package/dist/c-AJ7EC32V.min.js +0 -1
  281. package/dist/c-AQADQNY7.min.js +0 -1
  282. package/dist/c-ATM475SA.min.js +0 -1
  283. package/dist/c-AVO3Q7T7.min.js +0 -1
  284. package/dist/c-B7GW7IHJ.min.js +0 -1
  285. package/dist/c-BNFJMDHN.min.js +0 -1
  286. package/dist/c-BOHCQILI.min.js +0 -1
  287. package/dist/c-C3TZLTZK.min.js +0 -1
  288. package/dist/c-CGQAQWBV.min.js +0 -1
  289. package/dist/c-CPV4N35K.min.js +0 -1
  290. package/dist/c-DIPEYUOW.min.js +0 -1
  291. package/dist/c-E4JDJH4I.min.js +0 -1
  292. package/dist/c-E72OTUZU.min.js +0 -1
  293. package/dist/c-E7I2L7CU.min.js +0 -1
  294. package/dist/c-ELDWAO2V.min.js +0 -1
  295. package/dist/c-EUBTECGM.min.js +0 -1
  296. package/dist/c-EUMPMDCS.min.js +0 -1
  297. package/dist/c-EZZT2WAE.min.js +0 -1
  298. package/dist/c-FHBVFCQB.min.js +0 -1
  299. package/dist/c-G4HCO2IQ.min.js +0 -1
  300. package/dist/c-G5VIJEOK.min.js +0 -1
  301. package/dist/c-GHVOXAYH.min.js +0 -1
  302. package/dist/c-GXV3C3MO.min.js +0 -1
  303. package/dist/c-HHTK2R75.min.js +0 -1
  304. package/dist/c-HLLFJYTY.min.js +0 -1
  305. package/dist/c-HP4ZFM47.min.js +0 -1
  306. package/dist/c-HPOYKCCG.min.js +0 -1
  307. package/dist/c-HYDTS5OP.min.js +0 -1
  308. package/dist/c-I4QJ6YLM.min.js +0 -1
  309. package/dist/c-IK33LNZ6.min.js +0 -1
  310. package/dist/c-IK3PZHRY.min.js +0 -1
  311. package/dist/c-JIMJF6F6.min.js +0 -1
  312. package/dist/c-JUKIWTBJ.min.js +0 -1
  313. package/dist/c-KKPMHAZC.min.js +0 -1
  314. package/dist/c-L6WNDBHV.min.js +0 -1
  315. package/dist/c-LDEX5OFW.min.js +0 -1
  316. package/dist/c-LESEUVC5.min.js +0 -1
  317. package/dist/c-LYQMZMZQ.min.js +0 -1
  318. package/dist/c-MB6CV5NC.min.js +0 -1
  319. package/dist/c-MOKJOIPE.min.js +0 -1
  320. package/dist/c-N3FXLRNT.min.js +0 -1
  321. package/dist/c-N5NPTJVJ.min.js +0 -1
  322. package/dist/c-NHBL4J67.min.js +0 -1
  323. package/dist/c-ODG6TFSY.min.js +0 -1
  324. package/dist/c-PRIKOLTE.min.js +0 -1
  325. package/dist/c-PSKKFZNP.min.js +0 -1
  326. package/dist/c-PSNI6KAZ.min.js +0 -1
  327. package/dist/c-QAVFOEUY.min.js +0 -1
  328. package/dist/c-R2P4RR7Q.min.js +0 -1
  329. package/dist/c-RFC7UAG7.min.js +0 -1
  330. package/dist/c-S3AZX5PP.min.js +0 -1
  331. package/dist/c-SGAURYHG.min.js +0 -1
  332. package/dist/c-SJMWU6UX.min.js +0 -1
  333. package/dist/c-STIIGQOD.min.js +0 -1
  334. package/dist/c-T2ASIJVZ.min.js +0 -1
  335. package/dist/c-T2V7O2LO.min.js +0 -1
  336. package/dist/c-TKG2NP7G.min.js +0 -1
  337. package/dist/c-TX3THUTO.min.js +0 -1
  338. package/dist/c-TX7XJM3Z.min.js +0 -1
  339. package/dist/c-UC7SIU2W.min.js +0 -1
  340. package/dist/c-UMXSJIOV.min.js +0 -1
  341. package/dist/c-VRSXMLYF.min.js +0 -1
  342. package/dist/c-VSLWSAN2.min.js +0 -1
  343. package/dist/c-VXLOLYTO.min.js +0 -1
  344. package/dist/c-W4ZUKSEQ.min.js +0 -1
  345. package/dist/c-WCBRPILW.min.js +0 -1
  346. package/dist/c-WGHT7OCY.min.js +0 -1
  347. package/dist/c-WWCW3APR.min.js +0 -1
  348. package/dist/c-XSB27XPS.min.js +0 -1
  349. package/dist/c-Y6PYUMFU.min.js +0 -1
  350. package/dist/c-YDECTEUW.min.js +0 -1
  351. package/dist/c-YF3YKVQI.min.js +0 -1
  352. package/dist/c-YLZIV3VS.min.js +0 -1
  353. package/dist/c-ZIVPFTOC.min.js +0 -1
package/ai/examples.md CHANGED
@@ -1293,6 +1293,34 @@ import { LinkedCharts } from "semiotic/ai"
1293
1293
 
1294
1294
  Key props: `linkedHover` with `mode: "x-position"` broadcasts the hovered X value. Each chart shows its own tooltip with its own Y values. Use for multi-metric dashboards.
1295
1295
 
1296
+ ### Canvas realtime frames
1297
+
1298
+ Realtime charts draw marks on canvas, but they still consume the same `linkedHover` contract. Coordinate hover (`mode: "x-position"`) is the one that works when there is no SVG mark to hit-test:
1299
+
1300
+ ```jsx
1301
+ import { RealtimeLineChart } from "semiotic/realtime"
1302
+ import { LinkedCharts } from "semiotic"
1303
+
1304
+ <LinkedCharts>
1305
+ <RealtimeLineChart
1306
+ data={cpuData}
1307
+ timeAccessor="time"
1308
+ valueAccessor="cpu"
1309
+ linkedHover={{ name: "live", mode: "x-position", xField: "time" }}
1310
+ selection={{ name: "live" }}
1311
+ />
1312
+ <RealtimeLineChart
1313
+ data={errorData}
1314
+ timeAccessor="time"
1315
+ valueAccessor="errors"
1316
+ linkedHover={{ name: "live", mode: "x-position", xField: "time" }}
1317
+ selection={{ name: "live" }}
1318
+ />
1319
+ </LinkedCharts>
1320
+ ```
1321
+
1322
+ The hovered time is published through `LinkedCrosshairStore`; each canvas frame draws its own crosshair at that x.
1323
+
1296
1324
  ---
1297
1325
 
1298
1326
  ## Category Format (Custom Tick Labels)
package/ai/reference.md CHANGED
@@ -10,7 +10,7 @@ diagnostic tools; when possible, confirm a non-empty render with evidence.
10
10
  - Install: `npm install semiotic`
11
11
  <!-- semiotic-bundle-sizes:start -->
12
12
  <!-- Auto-generated by scripts/sync-bundle-sizes.mjs — do not edit by hand. -->
13
- - **Use sub-path imports** — `semiotic/atlas` (273KB gz), `semiotic/atlas/core` (14KB gz), `semiotic/access` (36KB gz), `semiotic/evidence` (50KB gz), `semiotic/artifact` (121KB gz), `semiotic/artifact/react` (4KB gz), `semiotic/line` (132KB gz), `semiotic/xy` (163KB gz), `semiotic/ordinal` (131KB gz), `semiotic/network` (151KB gz), `semiotic/geo` (108KB gz), `semiotic/realtime` (161KB gz), `semiotic/realtime/core` (160KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (241KB gz), `semiotic/server/node` (241KB gz), `semiotic/server/edge` (248KB gz), `semiotic/utils` (99KB gz), `semiotic/utils/core` (91KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (111KB gz), `semiotic/recipes/core` (103KB gz), `semiotic/recipes/react` (8KB gz), `semiotic/themes` (12KB gz), `semiotic/themes/core` (12KB gz), `semiotic/themes/react` (7KB gz), `semiotic/data` (3KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (167KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (595KB gz), `semiotic/ai/core` (139KB gz), `semiotic/controls` (10KB gz), `semiotic/rough` (3KB gz), `semiotic/text` (1KB gz). Full `semiotic` is 374KB gz.
13
+ - **Use sub-path imports** — `semiotic/atlas` (270KB gz), `semiotic/atlas/core` (13KB gz), `semiotic/access` (28KB gz), `semiotic/evidence` (44KB gz), `semiotic/artifact` (121KB gz), `semiotic/artifact/react` (4KB gz), `semiotic/line` (134KB gz), `semiotic/xy` (164KB gz), `semiotic/ordinal` (128KB gz), `semiotic/network` (148KB gz), `semiotic/geo` (106KB gz), `semiotic/realtime` (164KB gz), `semiotic/realtime/core` (163KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (243KB gz), `semiotic/server/node` (243KB gz), `semiotic/server/edge` (250KB gz), `semiotic/utils` (99KB gz), `semiotic/utils/core` (92KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (110KB gz), `semiotic/recipes/core` (102KB gz), `semiotic/recipes/react` (7KB gz), `semiotic/themes` (11KB gz), `semiotic/themes/core` (11KB gz), `semiotic/themes/react` (6KB gz), `semiotic/data` (4KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (165KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (595KB gz), `semiotic/ai/core` (138KB gz), `semiotic/controls` (11KB gz), `semiotic/rough` (3KB gz), `semiotic/text` (2KB gz). Full `semiotic` is 374KB gz.
14
14
  <!-- semiotic-bundle-sizes:end -->
15
15
  - CLI: `npx semiotic-ai [--schema|--compact|--examples|--doctor|--audit-a11y|--evaluate]` · MCP: `npx semiotic-mcp`
16
16
 
@@ -148,6 +148,8 @@ Histogram `linkedHover={{ name: "detail", mode: "field", fields: ["time", "categ
148
148
 
149
149
  All five realtime wrappers accept a top-level `cursor` as a presentation-only default for retained marks; `RealtimeSwarmChart.pointStyle` can override it per datum. Pair actionable cursors with explicit click or observation behavior.
150
150
 
151
+ With `transition` enabled on a sliding `windowSize`, set `pointIdAccessor` so retained path vertices join by identity and slide; without it, equal-length paths interpolate by array index and the whole line writhes as the ring buffer advances.
152
+
151
153
  `RealtimeLineChart` supports `eventTime={{ lateness, latePolicy? }}` for bounded out-of-order input. Type its ref as `RealtimeLineChartHandle` and call `ref.current.flush()` when the source ends so events still inside the grace window are released in event-time order. A flush commits an ordering boundary: later newer events buffer normally, while events older than the flushed frontier follow `latePolicy`. Changing the event-time config or `timeAccessor` live drains the old tail before the new interpretation begins.
152
154
 
153
155
  With `aggregate`, changing only `stat`/`band`/`sigma` reuses accumulated windows. Changing `window`/`size`/`hop`/`gap`/`retain`, `timeAccessor`, or `valueAccessor` starts a structurally new accumulator: controlled `data` is replayed under the new definition, while push-only history resets because aggregation intentionally retains window statistics rather than every raw event.
@@ -336,7 +338,7 @@ or geo custom charts; a server renderer cannot read a browser's selection store.
336
338
  **LinkedCharts** — `selections`. **CategoryColorProvider** — `colors`|`categories` + `colorScheme`.
337
339
  Chart props: `selection`, `linkedHover`, `linkedBrush`. Hooks: `useSelection`, `useLinkedHover`, `useBrushSelection`. Works for `NetworkCustomChart` too — the resolved selection predicate is threaded into the custom layout as `ctx.selection`.
338
340
  **`useSelectionActions(name)`** — write-only access (`selectPoints`/`clear`) that does NOT subscribe to selection state, so a *container* can push a selection (e.g. from a hover handler) without re-rendering; only the leaf consumers reading the selection re-render. The provider-at-top / consumers-at-leaves pattern for interaction-heavy coordinated views.
339
- **Shared categories inside LinkedCharts → wrap in `CategoryColorProvider`.** Gives identical per-category colors AND makes LinkedCharts render one unified legend (suppressing individual chart legends). Without it, mismatched colors and duplicate legends.
341
+ **Shared categories inside LinkedCharts:** generated colors keep charts without an explicit palette consistent. A child's `colorScheme` overrides those generated defaults; wrap in `CategoryColorProvider` to explicitly assign shared category colors above each child's palette. LinkedCharts builds its unified legend from resolved chart colors. If charts use different colors for the same category, it retains individual legends instead.
340
342
  **Linked crosshair**: `linkedHover={{ name: "sync", mode: "x-position", xField: "time" }}`. Click locks crosshair (dashed white); click/Escape unlocks.
341
343
  **Linked series highlight** (series↔bar cross-highlight): `linkedHover={{ name: "sync", mode: "series" }}` auto-resolves the chart's series-identity field (colorBy/lineBy/areaBy/stackBy/groupBy) and keys the linked selection off it — no hand-wired `fields`. Add `seriesField: "region"` to override (align charts whose series live under different prop names). Modes are exclusive: `mode` is `"field"` (default) | `"x-position"` (crosshair) | `"series"`.
342
344
  **CircularBrush** — accessible range brush over a **cyclical** domain (day-of-year, hour, compass): `value` ({start,end}) / `onChange` (value | updater) / `period` (365) / `radius` / `step`+`largeStep` / `formatValue` / `arcFill`/`stroke`. Wrap-around ranges, pointer-capture drag, and full keyboard control (each handle + the range is a `role="slider"`, ←/→ nudges, Shift = `largeStep`). The radial counterpart to the linear `RealtimeHistogram` brush. **Control-surface contract**: it takes value/domain/geometry/`onChange` and never reaches into a chart — layer it over a chart sharing its coordinate space and feed `onChange` into your state (or the selection store). Built on the cyclical + radial kit.
@@ -397,7 +399,7 @@ CSS custom properties: `--semiotic-{bg, text, text-secondary, border, grid, prim
397
399
  <ThemeProvider theme={{ mode: "dark", colors: { categorical: [...] } }}> {/* merge onto dark base */}
398
400
  ```
399
401
 
400
- **Color priority** (with `colorBy`): CategoryColorProvider/LinkedCharts map > `colorScheme` > ThemeProvider `colors.categorical` > `"category10"`. `colorScheme` accepts a named scheme (`"tableau10"`), an array, or a `{category: color}` **object map** for exact per-category colors (no array ordering to keep in sync).
402
+ **Color priority** (with `colorBy`): explicit CategoryColorProvider mappings (including those inherited through LinkedCharts) > `colorScheme` > ThemeProvider `colors.categorical` > `"category10"`. LinkedCharts registration-order defaults do not override `colorScheme`. `colorScheme` accepts a named scheme (`"tableau10"`), an array, or a `{category: color}` **object map** for exact per-category colors (no array ordering to keep in sync).
401
403
  Presets: `light`, `dark`, `high-contrast`, `pastels`(-dark), `bi-tool`(-dark), `italian`(-dark), `tufte`(-dark), `journalist`(-dark), `playful`(-dark), `carbon`(-dark).
402
404
  Serialization: `themeToCSS(theme, selector)`, `themeToTokens(theme)`, `designTokensToTheme(tokens)`, `resolveThemePreset(name)`. Native `semiotic.*` tokens round-trip title/legend size, family, and weight along with the base typography and color roles.
403
405
 
@@ -436,6 +438,9 @@ Heuristic chart-suggestion engine — no LLM required. Charts ship capability de
436
438
  - **Variants** encode that settings change what a chart is good for (e.g. StackedAreaChart's `streamgraph` variant boosts trend, penalizes part-to-whole).
437
439
  - **Interrogation tie-in**: pass `includeSuggestions: true` to `useChartInterrogation` and the ranked list lands in `context.suggestions` for the LLM.
438
440
  - **MCP tool**: `suggestCharts(data, intent?)`.
441
+ - **`suggestStreamCharts(schema, { intent?, audience?, maxResults? })`** → `{ suggestions, excluded, stretchSuggestions }`. Schema fields may declare `role: "key"`; `shape` is `append` | `keyed` | `aggregate`; `throughput` is a band or rows/sec. Ordinal/value push charts (BarChart, PieChart, BigNumber, GaugeChart, …) are registered alongside the six realtime XY charts. `importPath` is a free string. `explainStreamCapabilityFit` is the same result. **`suggestStreamDashboard(schemas, { audience, intent, budget })`** composes panels; `AudienceProfile.dashboard` holds cell budget, lead families, density, and window preference.
442
+ - **`applyChangelog(handle, events, { key })`** maps insert/upsert/update/retract onto `push`/`update`/`remove`. `WindowAccumulator` can emit t-digest percentiles (`p95`, `p99`) and HyperLogLog distinct counts. Ring-buffer `capacity` aliases `windowSize` so "window" can mean `aggregate.window`. `StalenessConfig.state` / `settling` override ingest-age LIVE/STALE. Realtime charts SSR from controlled `data` (and `aggregate`) via `renderChart`. `RealtimeLineChart.seriesAccessor` starts a new line per group in push mode. Scatterplot (and Bubble/ConnectedScatterplot) expose top-level `pulse` / `decay` / `staleness`.
443
+ - **`inferIntent` prose mode** scores registered `IntentSignals.phrases`. `communicativeActForIntent` walks composed intents through the heaviest child.
439
444
 
440
445
  ### Conversation-arc telemetry (`semiotic/ai`)
441
446
  Opt-in event store recording the AI session arc: `suggestion-shown → suggestion-chosen → audience-set → chart-rendered → chart-edited → chart-replaced → chart-exported | chart-abandoned`, plus `interrogation-asked`/`interrogation-answered`, reader-navigation events, and `annotation-status-changed`. Module-scoped, no provider needed. Default surface is no-op — call `enableConversationArc()` to start.
@@ -494,7 +499,7 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
494
499
  Agent action: Use an actionable cursor only when the application separately supplies documented click or observation behavior and an accessible activation path. Treat cursor in serialized/static output as visual metadata, never as proof that a mark is interactive.
495
500
  - **Data required by usage mode** (`props.data-required-by-usage-mode`): Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref.
496
501
  Agent action: Pass usageMode="push" to `semiotic-ai --doctor` when validating ref-based JSX with no data prop. Keep usageMode="static" or omit it for renderChart/MCP/static configs where data must be present.
497
- - **Categorical color precedence** (`color.category-precedence`): When colorBy is set, CategoryColorProvider/LinkedCharts category maps win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback.
502
+ - **Categorical color precedence** (`color.category-precedence`): When colorBy is set, explicit CategoryColorProvider mappings, including those inherited through LinkedCharts, win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback. Generated LinkedCharts colors do not override a child's colorScheme.
498
503
  Agent action: Use colorBy for categorical encodings. Use CategoryColorProvider or LinkedCharts for cross-chart consistency, colorScheme for per-chart fallback palettes, and avoid frameProps style functions unless intentionally bypassing HOC color resolution.
499
504
  - **Required prop combinations** (`props.required-combinations`): Some chart families need semantic props beyond data. These combinations are enforced by validation/schema for static configs and remain required in push mode unless explicitly noted.
500
505
  Agent action: Before returning code, check the selected component against the required combinations list. For push mode, omit data but keep semantic props such as areaBy, sizeBy, stackBy, and groupBy.
package/ai/schema.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
3
  "name": "semiotic",
4
- "version": "3.10.1",
4
+ "version": "3.10.3",
5
5
  "description": "React data visualization library for charts, networks, and beyond",
6
6
  "tools": [
7
7
  {
@@ -504,7 +504,7 @@
504
504
  },
505
505
  "pointIdAccessor": {
506
506
  "type": "string",
507
- "description": "Stable ID for point annotations and push-mode remove()/update().",
507
+ "description": "Stable ID for point annotations, push-mode remove()/update(), and identity-keyed line path transitions.",
508
508
  "x-semiotic-runtime-types": [
509
509
  "string",
510
510
  "function"
@@ -1179,7 +1179,7 @@
1179
1179
  },
1180
1180
  "pointIdAccessor": {
1181
1181
  "type": "string",
1182
- "description": "Stable ID for point annotations and push-mode remove()/update().",
1182
+ "description": "Stable ID for point annotations, push-mode remove()/update(), and identity-keyed area path transitions.",
1183
1183
  "x-semiotic-runtime-types": [
1184
1184
  "string",
1185
1185
  "function"
@@ -1801,7 +1801,7 @@
1801
1801
  },
1802
1802
  "pointIdAccessor": {
1803
1803
  "type": "string",
1804
- "description": "Stable ID for point annotations and push-mode remove()/update().",
1804
+ "description": "Stable ID for point annotations, push-mode remove()/update(), and identity-keyed area path transitions.",
1805
1805
  "x-semiotic-runtime-types": [
1806
1806
  "string",
1807
1807
  "function"
@@ -2376,6 +2376,18 @@
2376
2376
  "function"
2377
2377
  ]
2378
2378
  },
2379
+ "pulse": {
2380
+ "type": "object",
2381
+ "description": "Flash newly inserted or updated points. Also reachable via frameProps.pulse."
2382
+ },
2383
+ "decay": {
2384
+ "type": "object",
2385
+ "description": "Fade older points by buffer age. Also reachable via frameProps.decay."
2386
+ },
2387
+ "staleness": {
2388
+ "type": "object",
2389
+ "description": "Frame-level liveness badge and dimming. Also reachable via frameProps.staleness."
2390
+ },
2379
2391
  "xExtent": {
2380
2392
  "type": "array",
2381
2393
  "description": "Fixed x domain `[min, max]`; either bound may be omitted."
@@ -4630,6 +4642,18 @@
4630
4642
  "function"
4631
4643
  ]
4632
4644
  },
4645
+ "pulse": {
4646
+ "type": "object",
4647
+ "description": "Flash newly inserted or updated points. Also reachable via frameProps.pulse."
4648
+ },
4649
+ "decay": {
4650
+ "type": "object",
4651
+ "description": "Fade older points by buffer age. Also reachable via frameProps.decay."
4652
+ },
4653
+ "staleness": {
4654
+ "type": "object",
4655
+ "description": "Frame-level liveness badge and dimming. Also reachable via frameProps.staleness."
4656
+ },
4633
4657
  "xExtent": {
4634
4658
  "type": "array",
4635
4659
  "description": "Fixed x domain `[min, max]`; either bound may be omitted."
@@ -5782,6 +5806,18 @@
5782
5806
  "function"
5783
5807
  ]
5784
5808
  },
5809
+ "pulse": {
5810
+ "type": "object",
5811
+ "description": "Flash newly inserted or updated points. Also reachable via frameProps.pulse."
5812
+ },
5813
+ "decay": {
5814
+ "type": "object",
5815
+ "description": "Fade older points by buffer age. Also reachable via frameProps.decay."
5816
+ },
5817
+ "staleness": {
5818
+ "type": "object",
5819
+ "description": "Frame-level liveness badge and dimming. Also reachable via frameProps.staleness."
5820
+ },
5785
5821
  "xExtent": {
5786
5822
  "type": "array",
5787
5823
  "description": "Fixed x domain `[min, max]`; either bound may be omitted."
@@ -16931,6 +16967,18 @@
16931
16967
  "growing"
16932
16968
  ]
16933
16969
  },
16970
+ "capacity": {
16971
+ "type": "number",
16972
+ "description": "Ring-buffer capacity. Alias for windowSize — prefer this name when \"window\" means the aggregation window (aggregate.window)."
16973
+ },
16974
+ "capacityMode": {
16975
+ "type": "string",
16976
+ "enum": [
16977
+ "sliding",
16978
+ "growing"
16979
+ ],
16980
+ "description": "Alias for windowMode."
16981
+ },
16934
16982
  "arrowOfTime": {
16935
16983
  "type": "string",
16936
16984
  "enum": [
@@ -17234,6 +17282,14 @@
17234
17282
  "opacity": {
17235
17283
  "type": "number"
17236
17284
  },
17285
+ "seriesAccessor": {
17286
+ "type": "string",
17287
+ "description": "Split the line into series. Passed to the frame as groupAccessor.",
17288
+ "x-semiotic-runtime-types": [
17289
+ "string",
17290
+ "function"
17291
+ ]
17292
+ },
17237
17293
  "aggregate": {
17238
17294
  "type": "object",
17239
17295
  "description": "Windowed event-time aggregation config. Structural changes replay controlled data; push-only streams begin a new aggregate epoch because raw events are not retained."
@@ -17244,7 +17300,7 @@
17244
17300
  },
17245
17301
  "transition": {
17246
17302
  "type": "object",
17247
- "description": "Transition config: { duration, easing }"
17303
+ "description": "Transition config: { duration, easing }. Pair with pointIdAccessor so a sliding window slides retained vertices instead of interpolating the path by index."
17248
17304
  }
17249
17305
  },
17250
17306
  "required": []
@@ -17391,6 +17447,18 @@
17391
17447
  "growing"
17392
17448
  ]
17393
17449
  },
17450
+ "capacity": {
17451
+ "type": "number",
17452
+ "description": "Ring-buffer capacity. Alias for windowSize — prefer this name when \"window\" means the aggregation window (aggregate.window)."
17453
+ },
17454
+ "capacityMode": {
17455
+ "type": "string",
17456
+ "enum": [
17457
+ "sliding",
17458
+ "growing"
17459
+ ],
17460
+ "description": "Alias for windowMode."
17461
+ },
17394
17462
  "arrowOfTime": {
17395
17463
  "type": "string",
17396
17464
  "enum": [
@@ -17907,6 +17975,18 @@
17907
17975
  "growing"
17908
17976
  ]
17909
17977
  },
17978
+ "capacity": {
17979
+ "type": "number",
17980
+ "description": "Ring-buffer capacity. Alias for windowSize — prefer this name when \"window\" means the aggregation window (aggregate.window)."
17981
+ },
17982
+ "capacityMode": {
17983
+ "type": "string",
17984
+ "enum": [
17985
+ "sliding",
17986
+ "growing"
17987
+ ],
17988
+ "description": "Alias for windowMode."
17989
+ },
17910
17990
  "arrowOfTime": {
17911
17991
  "type": "string",
17912
17992
  "enum": [
@@ -18383,6 +18463,18 @@
18383
18463
  "growing"
18384
18464
  ]
18385
18465
  },
18466
+ "capacity": {
18467
+ "type": "number",
18468
+ "description": "Ring-buffer capacity. Alias for windowSize — prefer this name when \"window\" means the aggregation window (aggregate.window)."
18469
+ },
18470
+ "capacityMode": {
18471
+ "type": "string",
18472
+ "enum": [
18473
+ "sliding",
18474
+ "growing"
18475
+ ],
18476
+ "description": "Alias for windowMode."
18477
+ },
18386
18478
  "arrowOfTime": {
18387
18479
  "type": "string",
18388
18480
  "enum": [
@@ -18847,6 +18939,18 @@
18847
18939
  "growing"
18848
18940
  ]
18849
18941
  },
18942
+ "capacity": {
18943
+ "type": "number",
18944
+ "description": "Ring-buffer capacity. Alias for windowSize — prefer this name when \"window\" means the aggregation window (aggregate.window)."
18945
+ },
18946
+ "capacityMode": {
18947
+ "type": "string",
18948
+ "enum": [
18949
+ "sliding",
18950
+ "growing"
18951
+ ],
18952
+ "description": "Alias for windowMode."
18953
+ },
18850
18954
  "arrowOfTime": {
18851
18955
  "type": "string",
18852
18956
  "enum": [
@@ -25496,6 +25600,18 @@
25496
25600
  "type": "number",
25497
25601
  "description": "Time bin size in milliseconds (required)"
25498
25602
  },
25603
+ "capacity": {
25604
+ "type": "number",
25605
+ "description": "Ring-buffer capacity alias inherited from RealtimeHistogram. TemporalHistogram auto-fits to data unless set."
25606
+ },
25607
+ "capacityMode": {
25608
+ "type": "string",
25609
+ "enum": [
25610
+ "sliding",
25611
+ "growing"
25612
+ ],
25613
+ "description": "Alias for windowMode inherited from RealtimeHistogram."
25614
+ },
25499
25615
  "direction": {
25500
25616
  "type": "string",
25501
25617
  "enum": [
@@ -7,7 +7,7 @@
7
7
  "src/components/semiotic-ai.ts",
8
8
  "ai/mcp-server.ts"
9
9
  ],
10
- "version": "3.10.1",
10
+ "version": "3.10.3",
11
11
  "components": {
12
12
  "schema": 64,
13
13
  "aiChartExports": 56,
@@ -853,7 +853,7 @@
853
853
  ]
854
854
  },
855
855
  "mcp": {
856
- "toolCount": 28,
856
+ "toolCount": 29,
857
857
  "tools": [
858
858
  "applyTheme",
859
859
  "auditAccessibility",
@@ -881,6 +881,7 @@
881
881
  "suggestCharts",
882
882
  "suggestDashboard",
883
883
  "suggestStreamCharts",
884
+ "suggestStreamDashboard",
884
885
  "suggestStretchCharts",
885
886
  "suggestTokenEncoding"
886
887
  ],
@@ -113,7 +113,7 @@ These rules are generated from `ai/behaviorContracts.cjs` and are consumed by `s
113
113
  - **Accessible chart text uses direct chart props** (`accessibility.description-props`): High-level charts expose title for the visible name, description for a concise accessible description, summary for a screen-reader-only takeaway and interaction guidance, and accessibleTable for the data-table fallback.
114
114
  - **Cursor styling does not create behavior** (`interaction.cursor-is-presentation-only`): Cursor values in realtime props, retained mark styles, styleRules, and custom hit targets change pointer presentation only. They do not install click handlers, keyboard activation, observations, or accessibility semantics.
115
115
  - **Data required by usage mode** (`props.data-required-by-usage-mode`): Static usage (`renderChart`, MCP previews, SSR snapshots, and copy/paste examples with immediate data) requires data in props. React push mode selects live ingestion by omitting data and mutating through a ref.
116
- - **Categorical color precedence** (`color.category-precedence`): When colorBy is set, CategoryColorProvider/LinkedCharts category maps win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback.
116
+ - **Categorical color precedence** (`color.category-precedence`): When colorBy is set, explicit CategoryColorProvider mappings, including those inherited through LinkedCharts, win for mapped categories. Unmapped categories fall back to explicit colorScheme, then ThemeProvider colors.categorical, then the built-in categorical fallback. Generated LinkedCharts colors do not override a child's colorScheme.
117
117
  - **Required prop combinations** (`props.required-combinations`): Some chart families need semantic props beyond data. These combinations are enforced by validation/schema for static configs and remain required in push mode unless explicitly noted.
118
118
  Required combinations: StackedAreaChart: static data + areaBy; push areaBy. Stacked areas need a flat data array plus areaBy to identify the stacked series. BubbleChart: static data + sizeBy; push sizeBy. Bubbles need sizeBy in addition to x/y accessors so radius encodes data rather than a constant point size. StackedBarChart: static data + stackBy; push stackBy. Stacked bars need stackBy to split each category into stack segments. GroupedBarChart: static data + groupBy; push groupBy. Grouped bars need groupBy to split each category into side-by-side bars. SwimlaneChart: static data + subcategoryAccessor; push subcategoryAccessor. Swimlanes need subcategoryAccessor; colorBy defaults to the same field when not provided. GaugeChart: static value; push not supported. GaugeChart is value-only. Its thresholds use { value, color, label? }; BigNumber thresholds use the distinct { at, level, color?, label? } vocabulary. ForceDirectedGraph: static nodes + edges; push nodes + edges. ForceDirectedGraph schema/rendering requires nodes and edges. If an agent infers nodes from edge endpoints, it must materialize a nodes array before returning code.
119
119
  - **Push mode omits data** (`streaming.push-mode-data`): HOC push mode is selected by omitting the data prop entirely. Passing data={[]} is static empty data and can clear/reinitialize the frame on render.
@@ -7,16 +7,16 @@
7
7
  "route": "/tasks/compare-category-totals",
8
8
  "identity": {
9
9
  "packageName": "semiotic",
10
- "packageVersion": "3.10.1",
10
+ "packageVersion": "3.10.3",
11
11
  "channel": "source",
12
- "sourceRevision": "sha256:7ad6c1544d38a6665b3c8eccf4dc03e3575667b01ebf5c89b39a49188a796145",
12
+ "sourceRevision": "sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b",
13
13
  "revisionKind": "content-digest",
14
14
  "runtime": {
15
- "digest": "sha256:a63286038ab7c071eadd7634dc7e0b57b05cc029a70fdc2fc3ce66217a1172e3",
16
- "fileCount": 1135
15
+ "digest": "sha256:8aa926db2e659e8e7a1fa37d00c7d22c67179d97c9b192b44e86bb678f1f22f4",
16
+ "fileCount": 1171
17
17
  },
18
18
  "taskSources": {
19
- "digest": "sha256:0a9aacd44c3750f785b385664bd873a92648e8b0ea581f0b485eb8fe1ca5037f",
19
+ "digest": "sha256:bd8f750c15145f453eb3be245e55cf5fe6efd2c976761edd3efbbd2f798abbf9",
20
20
  "fileCount": 36
21
21
  },
22
22
  "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
@@ -195,54 +195,8 @@
195
195
  "claimId": "task.compare-category-totals",
196
196
  "statement": "Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.",
197
197
  "owner": "Semiotic repository maintainers",
198
- "status": "supported-in-scope",
199
- "observed": {
200
- "verifiedAt": "2026-09-15T00:29:02.031Z",
201
- "environment": {
202
- "node": "v22.22.1",
203
- "platform": "darwin",
204
- "architecture": "arm64",
205
- "browser": "Playwright Chromium"
206
- },
207
- "runs": [
208
- {
209
- "kind": "unit",
210
- "targets": [
211
- "docs/src/pages/tasks/examples/category-comparison.test.ts",
212
- "docs/src/pages/tasks/examples/live-chart.test.tsx",
213
- "docs/src/pages/tasks/examples/source-correction.test.ts"
214
- ],
215
- "name": "Task source units",
216
- "command": "node node_modules/vitest/vitest.mjs run ./docs/src/pages/tasks/examples/category-comparison.test.ts ./docs/src/pages/tasks/examples/live-chart.test.tsx ./docs/src/pages/tasks/examples/source-correction.test.ts --reporter=default --reporter=json --outputFile=<temporary-report-directory>/unit.json --allowOnly=false",
217
- "exitCode": 0,
218
- "passed": 14,
219
- "skipped": 0,
220
- "passedByFile": {
221
- "docs/src/pages/tasks/examples/category-comparison.test.ts": 4,
222
- "docs/src/pages/tasks/examples/live-chart.test.tsx": 5,
223
- "docs/src/pages/tasks/examples/source-correction.test.ts": 5
224
- }
225
- },
226
- {
227
- "kind": "browser",
228
- "targets": [
229
- "integration-tests/docs-examples-task-live.spec.ts",
230
- "integration-tests/docs-examples-tasks.spec.ts"
231
- ],
232
- "name": "Task browser behavior",
233
- "command": "node node_modules/@playwright/test/cli.js test --config playwright.docs-examples.config.ts ./integration-tests/docs-examples-task-live.spec.ts ./integration-tests/docs-examples-tasks.spec.ts --reporter=list,json --forbid-only",
234
- "exitCode": 0,
235
- "passed": 6,
236
- "skipped": 0,
237
- "passedByFile": {
238
- "integration-tests/docs-examples-task-live.spec.ts": 2,
239
- "integration-tests/docs-examples-tasks.spec.ts": 4
240
- }
241
- }
242
- ],
243
- "record": "ai/tasks/verification.json",
244
- "authorship": "Agent-observed execution of repository tests; independent review is not recorded."
245
- },
198
+ "status": "stale",
199
+ "observed": null,
246
200
  "validity": "Only the content digests and environment recorded here; not a release range or an adoption result.",
247
201
  "invalidation": "Changes to runtime source, schemas, manifests, task examples, tests, verification tooling or this task definition invalidate the recorded result.",
248
202
  "commands": [
@@ -4,8 +4,8 @@
4
4
 
5
5
  Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.
6
6
 
7
- Source package: semiotic@3.10.1. Channel: source.
8
- Source revision: sha256:7ad6c1544d38a6665b3c8eccf4dc03e3575667b01ebf5c89b39a49188a796145. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
7
+ Source package: semiotic@3.10.3. Channel: source.
8
+ Source revision: sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
9
9
 
10
10
  ## The job
11
11
 
@@ -110,7 +110,7 @@ export function checkCategoryComparison() {
110
110
 
111
111
  ## Check the result
112
112
 
113
- Evidence state: supported-in-scope. Only the content digests and environment recorded here; not a release range or an adoption result.
113
+ Evidence state: stale. Only the content digests and environment recorded here; not a release range or an adoption result.
114
114
 
115
115
  - North 12, South 30, West 18; total 60, with South largest.
116
116
  - Three SVG bars retain 12:30:18 proportions and insertion order in both orientations.
@@ -124,7 +124,7 @@ npx vitest run docs/src/pages/tasks/examples/category-comparison.test.ts
124
124
  npx playwright test --config playwright.docs-examples.config.ts integration-tests/docs-examples-tasks.spec.ts
125
125
  ```
126
126
 
127
- Recorded execution: 2026-09-15T00:29:02.031Z. Agent-observed execution of repository tests; independent review is not recorded.
127
+ No current execution result is recorded for these source contents.
128
128
 
129
129
  Not assessed:
130
130
 
@@ -7,16 +7,16 @@
7
7
  "route": "/tasks/correct-published-chart",
8
8
  "identity": {
9
9
  "packageName": "semiotic",
10
- "packageVersion": "3.10.1",
10
+ "packageVersion": "3.10.3",
11
11
  "channel": "source",
12
- "sourceRevision": "sha256:a40ea6ec500d31f2752678bb9e4b2bf4de5e7f113682645e882cdbabdc25d54f",
12
+ "sourceRevision": "sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115",
13
13
  "revisionKind": "content-digest",
14
14
  "runtime": {
15
- "digest": "sha256:a63286038ab7c071eadd7634dc7e0b57b05cc029a70fdc2fc3ce66217a1172e3",
16
- "fileCount": 1135
15
+ "digest": "sha256:8aa926db2e659e8e7a1fa37d00c7d22c67179d97c9b192b44e86bb678f1f22f4",
16
+ "fileCount": 1171
17
17
  },
18
18
  "taskSources": {
19
- "digest": "sha256:0a9aacd44c3750f785b385664bd873a92648e8b0ea581f0b485eb8fe1ca5037f",
19
+ "digest": "sha256:bd8f750c15145f453eb3be245e55cf5fe6efd2c976761edd3efbbd2f798abbf9",
20
20
  "fileCount": 36
21
21
  },
22
22
  "availability": "Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks."
@@ -166,54 +166,8 @@
166
166
  "claimId": "task.correct-published-chart",
167
167
  "statement": "Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.",
168
168
  "owner": "Semiotic repository maintainers",
169
- "status": "supported-in-scope",
170
- "observed": {
171
- "verifiedAt": "2026-09-15T00:29:02.031Z",
172
- "environment": {
173
- "node": "v22.22.1",
174
- "platform": "darwin",
175
- "architecture": "arm64",
176
- "browser": "Playwright Chromium"
177
- },
178
- "runs": [
179
- {
180
- "kind": "unit",
181
- "targets": [
182
- "docs/src/pages/tasks/examples/category-comparison.test.ts",
183
- "docs/src/pages/tasks/examples/live-chart.test.tsx",
184
- "docs/src/pages/tasks/examples/source-correction.test.ts"
185
- ],
186
- "name": "Task source units",
187
- "command": "node node_modules/vitest/vitest.mjs run ./docs/src/pages/tasks/examples/category-comparison.test.ts ./docs/src/pages/tasks/examples/live-chart.test.tsx ./docs/src/pages/tasks/examples/source-correction.test.ts --reporter=default --reporter=json --outputFile=<temporary-report-directory>/unit.json --allowOnly=false",
188
- "exitCode": 0,
189
- "passed": 14,
190
- "skipped": 0,
191
- "passedByFile": {
192
- "docs/src/pages/tasks/examples/category-comparison.test.ts": 4,
193
- "docs/src/pages/tasks/examples/live-chart.test.tsx": 5,
194
- "docs/src/pages/tasks/examples/source-correction.test.ts": 5
195
- }
196
- },
197
- {
198
- "kind": "browser",
199
- "targets": [
200
- "integration-tests/docs-examples-task-live.spec.ts",
201
- "integration-tests/docs-examples-tasks.spec.ts"
202
- ],
203
- "name": "Task browser behavior",
204
- "command": "node node_modules/@playwright/test/cli.js test --config playwright.docs-examples.config.ts ./integration-tests/docs-examples-task-live.spec.ts ./integration-tests/docs-examples-tasks.spec.ts --reporter=list,json --forbid-only",
205
- "exitCode": 0,
206
- "passed": 6,
207
- "skipped": 0,
208
- "passedByFile": {
209
- "integration-tests/docs-examples-task-live.spec.ts": 2,
210
- "integration-tests/docs-examples-tasks.spec.ts": 4
211
- }
212
- }
213
- ],
214
- "record": "ai/tasks/verification.json",
215
- "authorship": "Agent-observed execution of repository tests; independent review is not recorded."
216
- },
169
+ "status": "stale",
170
+ "observed": null,
217
171
  "validity": "Only the content digests and environment recorded here; not a release range or an adoption result.",
218
172
  "invalidation": "Changes to runtime source, schemas, manifests, task examples, tests, verification tooling or this task definition invalidate the recorded result.",
219
173
  "commands": [
@@ -4,8 +4,8 @@
4
4
 
5
5
  Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.
6
6
 
7
- Source package: semiotic@3.10.1. Channel: source.
8
- Source revision: sha256:a40ea6ec500d31f2752678bb9e4b2bf4de5e7f113682645e882cdbabdc25d54f. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
7
+ Source package: semiotic@3.10.3. Channel: source.
8
+ Source revision: sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115. Verified source checkout guidance; npm package, hosted site and MCP deployment identities require separate checks.
9
9
 
10
10
  ## The job
11
11
 
@@ -524,7 +524,7 @@ Browser presentation; source: docs/src/pages/tasks/examples/source-correction.cs
524
524
 
525
525
  ## Check the result
526
526
 
527
- Evidence state: supported-in-scope. Only the content digests and environment recorded here; not a release range or an adoption result.
527
+ Evidence state: stale. Only the content digests and environment recorded here; not a release range or an adoption result.
528
528
 
529
529
  - Changing data without revisiting active claims is refused.
530
530
  - The original total 60 and South-largest claims are superseded; replacements describe total 78 and West 36.
@@ -539,7 +539,7 @@ npx vitest run docs/src/pages/tasks/examples/source-correction.test.ts
539
539
  npx playwright test --config playwright.docs-examples.config.ts integration-tests/docs-examples-tasks.spec.ts
540
540
  ```
541
541
 
542
- Recorded execution: 2026-09-15T00:29:02.031Z. Agent-observed execution of repository tests; independent review is not recorded.
542
+ No current execution result is recorded for these source contents.
543
543
 
544
544
  Not assessed:
545
545
 
@@ -8,33 +8,33 @@
8
8
  "title": "Compare category totals you can check",
9
9
  "summary": "Compare three totals in React, inspect their exact values, and verify the server-rendered bar geometry.",
10
10
  "route": "/tasks/compare-category-totals",
11
- "packageVersion": "3.10.1",
12
- "sourceRevision": "sha256:7ad6c1544d38a6665b3c8eccf4dc03e3575667b01ebf5c89b39a49188a796145",
11
+ "packageVersion": "3.10.3",
12
+ "sourceRevision": "sha256:03b9d282fdf261fc90d262ec74bead44e05d6e3a8c11c2357d9b8242d8d1bc7b",
13
13
  "markdown": "/tasks/compare-category-totals.md",
14
14
  "json": "/tasks/compare-category-totals.json",
15
- "evidenceStatus": "supported-in-scope"
15
+ "evidenceStatus": "stale"
16
16
  },
17
17
  {
18
18
  "id": "update-live-chart",
19
19
  "title": "Update a live chart by record ID",
20
20
  "summary": "Maintain a bounded window of incoming records, apply corrections, and reconcile the display after reconnecting.",
21
21
  "route": "/tasks/update-live-chart",
22
- "packageVersion": "3.10.1",
23
- "sourceRevision": "sha256:43a44221c44befa71122be662b0ceb1390c182e48c40ecb1b484add5acdd30e3",
22
+ "packageVersion": "3.10.3",
23
+ "sourceRevision": "sha256:67787d71b76562dccdd1cfea052f9e05fac0af91d9239dacf5b7bcbea2ff76a4",
24
24
  "markdown": "/tasks/update-live-chart.md",
25
25
  "json": "/tasks/update-live-chart.json",
26
- "evidenceStatus": "supported-in-scope"
26
+ "evidenceStatus": "stale"
27
27
  },
28
28
  {
29
29
  "id": "correct-published-chart",
30
30
  "title": "Correct a chart after its source changes",
31
31
  "summary": "Apply a source correction, replace affected claims explicitly, and preserve the context a later reader needs.",
32
32
  "route": "/tasks/correct-published-chart",
33
- "packageVersion": "3.10.1",
34
- "sourceRevision": "sha256:a40ea6ec500d31f2752678bb9e4b2bf4de5e7f113682645e882cdbabdc25d54f",
33
+ "packageVersion": "3.10.3",
34
+ "sourceRevision": "sha256:c6d593c99b338782c0c63e6e1d9a83062df31cbcafed1d44173e9e36540a3115",
35
35
  "markdown": "/tasks/correct-published-chart.md",
36
36
  "json": "/tasks/correct-published-chart.json",
37
- "evidenceStatus": "supported-in-scope"
37
+ "evidenceStatus": "stale"
38
38
  }
39
39
  ]
40
40
  }