semiotic 3.10.0 → 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 (403) hide show
  1. package/README.md +73 -72
  2. package/ai/artifact-surface-inventory.json +4 -1
  3. package/ai/componentMetadata.cjs +3 -1
  4. package/ai/dist/mcp-server.js +47 -46
  5. package/ai/examples.md +95 -0
  6. package/ai/reference.md +80 -1
  7. package/ai/schema.json +7304 -1990
  8. package/ai/surface-manifest.json +26 -4
  9. package/ai/task-packets/compare-category-totals.json +7 -53
  10. package/ai/task-packets/compare-category-totals.md +4 -4
  11. package/ai/task-packets/correct-published-chart.json +7 -53
  12. package/ai/task-packets/correct-published-chart.md +4 -4
  13. package/ai/task-packets/index.json +9 -9
  14. package/ai/task-packets/update-live-chart.json +8 -54
  15. package/ai/task-packets/update-live-chart.md +4 -4
  16. package/dist/c-27DCB5T6.min.js +18 -0
  17. package/dist/c-2MONF2P6.min.js +1 -0
  18. package/dist/c-2TW5H5PD.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-4JKDJUYD.min.js +1 -0
  30. package/dist/c-4LKK5YWB.min.js +1 -0
  31. package/dist/c-4MD53L2J.min.js +33 -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-6IVBV5NO.min.js +1 -0
  36. package/dist/c-6ZU3QVLB.min.js +100 -0
  37. package/dist/c-72CBVNYX.min.js +209 -0
  38. package/dist/c-7APWCEPL.min.js +1 -0
  39. package/dist/c-7ASK4WBF.min.js +1 -0
  40. package/dist/{c-ORLEBW72.min.js → c-7FKPPCGN.min.js} +1 -1
  41. package/dist/c-7LY46QUI.min.js +41 -0
  42. package/dist/c-ABMGCCLT.min.js +1 -0
  43. package/dist/c-AINGQGUN.min.js +1 -0
  44. package/dist/c-AKLBQMQF.min.js +391 -0
  45. package/dist/c-AXJ2QI3F.min.js +1 -0
  46. package/dist/c-BQYD7T4E.min.js +1 -0
  47. package/dist/{c-V4XMSLC3.min.js → c-BYJJ7EMG.min.js} +1 -1
  48. package/dist/{c-JO2UGTCP.min.js → c-C4KIXUWU.min.js} +1 -1
  49. package/dist/c-C4SXYFXL.min.js +1 -0
  50. package/dist/c-CLDCKFBE.min.js +1 -0
  51. package/dist/c-CLJCJSFU.min.js +1 -0
  52. package/dist/c-CLLCX3PT.min.js +2 -0
  53. package/dist/c-ECHBKW7U.min.js +1 -0
  54. package/dist/c-EPJWM2UT.min.js +1 -0
  55. package/dist/c-F2GGJB2S.min.js +31 -0
  56. package/dist/c-FD2BXSRG.min.js +1 -0
  57. package/dist/c-FDUQDCBC.min.js +51 -0
  58. package/dist/c-FOTTQHOO.min.js +1 -0
  59. package/dist/c-FU7A5KSY.min.js +1 -0
  60. package/dist/c-G53AVC42.min.js +113 -0
  61. package/dist/c-GHN6IR4Y.min.js +1 -0
  62. package/dist/c-GSCO3FWL.min.js +1 -0
  63. package/dist/c-GYLOSK7M.min.js +1 -0
  64. package/dist/c-HK4OSLZA.min.js +1 -0
  65. package/dist/c-HLGTD5SJ.min.js +1 -0
  66. package/dist/c-HQ27AHMC.min.js +1 -0
  67. package/dist/{c-D6HAAPTX.min.js → c-IBRLFKWA.min.js} +1 -1
  68. package/dist/c-IHWZ2C6D.min.js +26 -0
  69. package/dist/c-IIV73MUW.min.js +1 -0
  70. package/dist/c-IPYGNVN6.min.js +116 -0
  71. package/dist/c-JJKRER47.min.js +1 -0
  72. package/dist/c-JO6AYCU4.min.js +1 -0
  73. package/dist/c-JWHPG6S2.min.js +1 -0
  74. package/dist/c-JXVYIXTV.min.js +1 -0
  75. package/dist/c-K2ZIYDI3.min.js +1 -0
  76. package/dist/c-K37JAIWA.min.js +4 -0
  77. package/dist/c-KGROWFT2.min.js +9 -0
  78. package/dist/c-MOP2NGLH.min.js +1 -0
  79. package/dist/c-MTX2AO5S.min.js +1 -0
  80. package/dist/c-N5WT7TXG.min.js +1 -0
  81. package/dist/c-NATWERHZ.min.js +1 -0
  82. package/dist/{c-42PLDTX7.min.js → c-O53GOO7H.min.js} +1 -1
  83. package/dist/c-OVQB75PE.min.js +1 -0
  84. package/dist/c-P3SKRNZN.min.js +1 -0
  85. package/dist/c-P5NXQWIM.min.js +1 -0
  86. package/dist/c-P7BQMVQQ.min.js +1 -0
  87. package/dist/{c-GNTXRXRN.min.js → c-PDQHLOKU.min.js} +1 -1
  88. package/dist/c-PKY4JFY5.min.js +1 -0
  89. package/dist/c-PQOZPM4G.min.js +1 -0
  90. package/dist/c-PZ3NEGNG.min.js +1 -0
  91. package/dist/c-QXLDCATV.min.js +1 -0
  92. package/dist/c-R2HUSWKB.min.js +1 -0
  93. package/dist/{c-HYW2XA4Q.min.js → c-RHDOOQ4X.min.js} +1 -1
  94. package/dist/c-RZPP5ERV.min.js +1 -0
  95. package/dist/c-SG2Y7EBY.min.js +46 -0
  96. package/dist/{c-WUWXGQYA.min.js → c-SJIB5RNI.min.js} +1 -1
  97. package/dist/c-SQNEVNWT.min.js +1 -0
  98. package/dist/c-STHZWF3D.min.js +1 -0
  99. package/dist/c-TIDKVMMZ.min.js +1 -0
  100. package/dist/c-TIMGODBG.min.js +1 -0
  101. package/dist/c-TR7OHUAO.min.js +2 -0
  102. package/dist/c-TTKWXGAI.min.js +61 -0
  103. package/dist/c-TVKZC4BY.min.js +1 -0
  104. package/dist/c-U5XVLSHN.min.js +1 -0
  105. package/dist/c-U6NLVFN4.min.js +1 -0
  106. package/dist/{c-VJTDST2R.min.js → c-UBHICVSC.min.js} +1 -1
  107. package/dist/c-UOPPO26M.min.js +1 -0
  108. package/dist/c-UUDAON4Z.min.js +1 -0
  109. package/dist/c-V32TPPY2.min.js +1 -0
  110. package/dist/c-V5KFJWQQ.min.js +1 -0
  111. package/dist/{c-P65V6HLO.min.js → c-VN557BQE.min.js} +1 -1
  112. package/dist/c-VXIYF7V2.min.js +1 -0
  113. package/dist/c-Y342FJ6K.min.js +1 -0
  114. package/dist/c-YM6CT4LJ.min.js +1 -0
  115. package/dist/{c-MVR3RWF3.min.js → c-YMFUIO54.min.js} +1 -1
  116. package/dist/c-YQVOKPKR.min.js +1 -0
  117. package/dist/c-YRJ3BJQZ.min.js +1 -0
  118. package/dist/c-YT5KPVNP.min.js +1 -0
  119. package/dist/components/ai/audienceProfile.d.ts +18 -1
  120. package/dist/components/ai/describeChart.d.ts +5 -1
  121. package/dist/components/ai/intentManifest.d.ts +16 -0
  122. package/dist/components/ai/intentRegistry.d.ts +12 -0
  123. package/dist/components/ai/intents.d.ts +6 -6
  124. package/dist/components/ai/streamSchema.d.ts +19 -0
  125. package/dist/components/ai/streamingTypes.d.ts +57 -11
  126. package/dist/components/ai/suggestCharts.d.ts +1 -1
  127. package/dist/components/ai/suggestStreamCharts.d.ts +43 -8
  128. package/dist/components/ai/suggestStreamDashboard.d.ts +35 -0
  129. package/dist/components/ai/variantDiscovery.d.ts +1 -1
  130. package/dist/components/charts/ordinal/BarChart.streamCapability.d.ts +2 -0
  131. package/dist/components/charts/ordinal/DonutChart.streamCapability.d.ts +2 -0
  132. package/dist/components/charts/ordinal/GroupedBarChart.streamCapability.d.ts +2 -0
  133. package/dist/components/charts/ordinal/PieChart.streamCapability.d.ts +2 -0
  134. package/dist/components/charts/ordinal/StackedBarChart.streamCapability.d.ts +2 -0
  135. package/dist/components/charts/realtime/RealtimeAccumulator.d.ts +14 -0
  136. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +6 -5
  137. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +5 -1
  138. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +2 -161
  139. package/dist/components/charts/realtime/RealtimeLineChart.types.d.ts +175 -0
  140. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +6 -5
  141. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +6 -5
  142. package/dist/components/charts/realtime/aggregate.d.ts +11 -1
  143. package/dist/components/charts/realtime/resolveWindowSize.d.ts +1 -1
  144. package/dist/components/charts/shared/DirectLabelLayer.d.ts +25 -0
  145. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  146. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  147. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  148. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  149. package/dist/components/charts/shared/directLabels.d.ts +12 -0
  150. package/dist/components/charts/shared/hooks.d.ts +3 -1
  151. package/dist/components/charts/shared/knownChartComponents.d.ts +5 -2
  152. package/dist/components/charts/shared/lineSeriesSsr.d.ts +0 -12
  153. package/dist/components/charts/shared/useChartSetup.d.ts +2 -0
  154. package/dist/components/charts/value/BigNumber.streamCapability.d.ts +2 -0
  155. package/dist/components/charts/value/GaugeChart.streamCapability.d.ts +2 -0
  156. package/dist/components/charts/xy/BubbleChart.d.ts +4 -1
  157. package/dist/components/charts/xy/ConnectedScatterplot.d.ts +4 -1
  158. package/dist/components/charts/xy/LineChart.d.ts +4 -1
  159. package/dist/components/charts/xy/Scatterplot.d.ts +7 -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/DependencyForestChart.d.ts +20 -0
  167. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  168. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  169. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  170. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  171. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  172. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  173. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  174. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  175. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  176. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  177. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  178. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  179. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  180. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  181. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  182. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  183. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  184. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  185. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  186. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  187. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  188. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  189. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  190. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  191. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  192. package/dist/components/recipes/atlas/index.d.ts +26 -0
  193. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  194. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  195. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  196. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  197. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  198. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  199. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  200. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  201. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  202. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  203. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  204. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  205. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  206. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  207. package/dist/components/recipes/atlas/support.d.ts +7 -0
  208. package/dist/components/recipes/atlas/types.d.ts +278 -0
  209. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  210. package/dist/components/recipes/layout1d.d.ts +2 -20
  211. package/dist/components/recipes/minGapPlacement.d.ts +20 -0
  212. package/dist/components/semiotic-ai-core.d.ts +8 -3
  213. package/dist/components/semiotic-ai-stream.d.ts +10 -0
  214. package/dist/components/semiotic-ai.d.ts +4 -6
  215. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  216. package/dist/components/semiotic-atlas.d.ts +8 -0
  217. package/dist/components/semiotic-realtime-core.d.ts +6 -2
  218. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  219. package/dist/components/semiotic-stream-types.d.ts +14 -0
  220. package/dist/components/semiotic-xy.d.ts +1 -0
  221. package/dist/components/semiotic.d.ts +3 -11
  222. package/dist/components/server/encodeSvgFramesToGif.d.ts +2 -0
  223. package/dist/components/server/rasterizeSVG.d.ts +2 -0
  224. package/dist/components/server/registerServerXYPlugins.d.ts +2 -0
  225. package/dist/components/server/renderEvidence.d.ts +4 -0
  226. package/dist/components/server/serverChartConfigs.d.ts +8 -0
  227. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  228. package/dist/components/server/serverChartConfigsRealtime.d.ts +6 -0
  229. package/dist/components/server/serverRealtimeCategoryColors.d.ts +3 -0
  230. package/dist/components/server/staticAnnotations.d.ts +9 -0
  231. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  232. package/dist/components/stream/SceneGraph.d.ts +3 -3
  233. package/dist/components/stream/StalenessBadge.d.ts +5 -2
  234. package/dist/components/stream/canvasSetup.d.ts +1 -2
  235. package/dist/components/stream/fontLoading.d.ts +4 -0
  236. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  237. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  238. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  239. package/dist/components/stream/physics/physicsSemanticUI.d.ts +2 -0
  240. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  241. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  242. package/dist/components/stream/pipelinePathJoin.d.ts +27 -0
  243. package/dist/components/stream/pipelineTransitionTypes.d.ts +43 -0
  244. package/dist/components/stream/pipelineTransitions.d.ts +5 -35
  245. package/dist/components/stream/seriesGeometry.d.ts +2 -1
  246. package/dist/components/stream/shallowEqual.d.ts +2 -0
  247. package/dist/components/stream/streamEncodingTypes.d.ts +9 -0
  248. package/dist/components/stream/types.d.ts +25 -2
  249. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  250. package/dist/components/text/axisLabelAssessment.d.ts +15 -0
  251. package/dist/components/text/browserAxisLabelAssessment.d.ts +1 -0
  252. package/dist/components/text/browserLabelMeasurement.d.ts +3 -0
  253. package/dist/components/text/labelMeasurement.d.ts +19 -0
  254. package/dist/components/text/labelPlacement.d.ts +71 -0
  255. package/dist/components/text/useAxisLabelAssessment.d.ts +6 -0
  256. package/dist/components/text/useLabelMeasurer.d.ts +3 -0
  257. package/dist/controls.module.min.js +71 -1
  258. package/dist/geo.min.js +231 -1
  259. package/dist/geo.module.min.js +31 -1
  260. package/dist/network.module.min.js +1 -1
  261. package/dist/ordinal.module.min.js +1 -1
  262. package/dist/physics-matter.module.min.js +1 -1
  263. package/dist/physics-rapier.module.min.js +1 -1
  264. package/dist/physics.module.min.js +1 -1
  265. package/dist/rough.min.js +2 -1
  266. package/dist/rough.module.min.js +2 -1
  267. package/dist/semiotic-access.module.min.js +1 -1
  268. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +1 -1
  269. package/dist/semiotic-ai-core.d.ts +8 -3
  270. package/dist/semiotic-ai-core.min.js +4 -1
  271. package/dist/semiotic-ai-core.module.min.js +4 -1
  272. package/dist/semiotic-ai-hash-primitives.module.min.js +1 -1
  273. package/dist/semiotic-ai.d.ts +4 -6
  274. package/dist/semiotic-ai.module.min.js +14 -1
  275. package/dist/semiotic-artifact-react.min.js +269 -1
  276. package/dist/semiotic-artifact-react.module.min.js +137 -1
  277. package/dist/semiotic-artifact.min.js +3 -1
  278. package/dist/semiotic-artifact.module.min.js +3 -1
  279. package/dist/semiotic-atlas-core.d.ts +20 -0
  280. package/dist/semiotic-atlas-core.min.js +2 -0
  281. package/dist/semiotic-atlas-core.module.min.js +1 -0
  282. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  283. package/dist/semiotic-atlas.d.ts +8 -0
  284. package/dist/semiotic-atlas.min.js +2 -0
  285. package/dist/semiotic-atlas.module.min.js +12 -0
  286. package/dist/semiotic-client-cjs-shared.min.js +1529 -1
  287. package/dist/semiotic-client-glyph.module.min.js +3 -1
  288. package/dist/semiotic-client-responsive.module.min.js +1 -1
  289. package/dist/semiotic-client-shared.module.min.js +1 -1
  290. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +2 -1
  291. package/dist/semiotic-data.min.js +1 -1
  292. package/dist/semiotic-data.module.min.js +1 -1
  293. package/dist/semiotic-evidence.min.js +3 -1
  294. package/dist/semiotic-evidence.module.min.js +3 -1
  295. package/dist/semiotic-experimental-auxiliary.module.min.js +8 -1
  296. package/dist/semiotic-experimental-node-auxiliary.module.min.js +8 -1
  297. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  298. package/dist/semiotic-experimental-vacp.min.js +1 -1
  299. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  300. package/dist/semiotic-line.module.min.js +1 -1
  301. package/dist/semiotic-realtime-core.d.ts +6 -2
  302. package/dist/semiotic-realtime-core.module.min.js +1 -1
  303. package/dist/semiotic-realtime-react.module.min.js +1 -1
  304. package/dist/semiotic-recipes-core-cjs-base.min.js +160 -1
  305. package/dist/semiotic-recipes-core.d.ts +9 -0
  306. package/dist/semiotic-recipes-core.module.min.js +72 -1
  307. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  308. package/dist/semiotic-recipes-react.min.js +3 -1
  309. package/dist/semiotic-server-edge-node.module.min.js +391 -1
  310. package/dist/semiotic-server-edge.min.js +651 -1
  311. package/dist/semiotic-server-edge.module.min.js +372 -1
  312. package/dist/semiotic-server-node.min.js +651 -1
  313. package/dist/semiotic-server-node.module.min.js +1 -1
  314. package/dist/semiotic-text.min.js +1 -1
  315. package/dist/semiotic-text.module.min.js +1 -1
  316. package/dist/semiotic-themes-core.min.js +1 -1
  317. package/dist/semiotic-themes-core.module.min.js +1 -1
  318. package/dist/semiotic-themes.min.js +1 -1
  319. package/dist/semiotic-themes.module.min.js +1 -1
  320. package/dist/semiotic-utils-core.min.js +11 -1
  321. package/dist/semiotic-utils-core.module.min.js +8 -1
  322. package/dist/semiotic-value.module.min.js +15 -1
  323. package/dist/semiotic-xy.d.ts +1 -0
  324. package/dist/semiotic.d.ts +3 -11
  325. package/dist/semiotic.module.min.js +10 -1
  326. package/dist/server.min.js +651 -1
  327. package/dist/server.module.min.js +1 -1
  328. package/dist/xy.module.min.js +1 -1
  329. package/package.json +19 -3
  330. package/dist/c-2N7IU2NY.min.js +0 -1
  331. package/dist/c-2WK7YJLL.min.js +0 -1
  332. package/dist/c-33QOXEUG.min.js +0 -1
  333. package/dist/c-447VIMRO.min.js +0 -1
  334. package/dist/c-4FN7Q6VQ.min.js +0 -1
  335. package/dist/c-553QUDKA.min.js +0 -1
  336. package/dist/c-55BAJ333.min.js +0 -1
  337. package/dist/c-7242NXSG.min.js +0 -1
  338. package/dist/c-7EGHJU2F.min.js +0 -1
  339. package/dist/c-7HP7MB2I.min.js +0 -1
  340. package/dist/c-7NBU5ZKS.min.js +0 -1
  341. package/dist/c-AFBSWT77.min.js +0 -1
  342. package/dist/c-AJ7EC32V.min.js +0 -1
  343. package/dist/c-AQADQNY7.min.js +0 -1
  344. package/dist/c-ATM475SA.min.js +0 -1
  345. package/dist/c-AVO3Q7T7.min.js +0 -1
  346. package/dist/c-AZKPVBOC.min.js +0 -1
  347. package/dist/c-BNFJMDHN.min.js +0 -1
  348. package/dist/c-BNG5ECK5.min.js +0 -1
  349. package/dist/c-BOHCQILI.min.js +0 -1
  350. package/dist/c-CCTGN5CK.min.js +0 -1
  351. package/dist/c-CPSPZH6A.min.js +0 -1
  352. package/dist/c-CPV4N35K.min.js +0 -1
  353. package/dist/c-DE5Q3U2X.min.js +0 -1
  354. package/dist/c-DK662R77.min.js +0 -1
  355. package/dist/c-DY2676CR.min.js +0 -1
  356. package/dist/c-E32M6XW5.min.js +0 -1
  357. package/dist/c-E4JDJH4I.min.js +0 -1
  358. package/dist/c-E7I2L7CU.min.js +0 -1
  359. package/dist/c-EBOQ7ER7.min.js +0 -1
  360. package/dist/c-ELDWAO2V.min.js +0 -1
  361. package/dist/c-EUBTECGM.min.js +0 -1
  362. package/dist/c-GSZRZRD6.min.js +0 -1
  363. package/dist/c-GWX7JGMF.min.js +0 -1
  364. package/dist/c-GXV3C3MO.min.js +0 -1
  365. package/dist/c-HHTK2R75.min.js +0 -1
  366. package/dist/c-HLLFJYTY.min.js +0 -1
  367. package/dist/c-HPOYKCCG.min.js +0 -1
  368. package/dist/c-HXDKPIKR.min.js +0 -1
  369. package/dist/c-I4QJ6YLM.min.js +0 -1
  370. package/dist/c-IDJV3CZK.min.js +0 -1
  371. package/dist/c-ITKX3RC5.min.js +0 -1
  372. package/dist/c-JG2JCQLP.min.js +0 -1
  373. package/dist/c-JLGRHXGZ.min.js +0 -1
  374. package/dist/c-JUKIWTBJ.min.js +0 -1
  375. package/dist/c-KCRJGUHP.min.js +0 -1
  376. package/dist/c-LMGSSD2E.min.js +0 -1
  377. package/dist/c-LYQMZMZQ.min.js +0 -1
  378. package/dist/c-LYVKDBQJ.min.js +0 -1
  379. package/dist/c-MXCP7GNZ.min.js +0 -1
  380. package/dist/c-NG7BLZTR.min.js +0 -1
  381. package/dist/c-NYZ2QNAM.min.js +0 -1
  382. package/dist/c-OO5QLMJC.min.js +0 -1
  383. package/dist/c-OOVX2JPQ.min.js +0 -1
  384. package/dist/c-PP6VY3QU.min.js +0 -1
  385. package/dist/c-PRIKOLTE.min.js +0 -1
  386. package/dist/c-PSNI6KAZ.min.js +0 -1
  387. package/dist/c-PYNW54D2.min.js +0 -1
  388. package/dist/c-QAVFOEUY.min.js +0 -1
  389. package/dist/c-ROEHCIGV.min.js +0 -1
  390. package/dist/c-S3AZX5PP.min.js +0 -1
  391. package/dist/c-T2V7O2LO.min.js +0 -1
  392. package/dist/c-TIXX5CAU.min.js +0 -1
  393. package/dist/c-TKG2NP7G.min.js +0 -1
  394. package/dist/c-VXLOLYTO.min.js +0 -1
  395. package/dist/c-W4ZUKSEQ.min.js +0 -1
  396. package/dist/c-WH2O53VI.min.js +0 -1
  397. package/dist/c-WNGH47HF.min.js +0 -1
  398. package/dist/c-XDQKXPX4.min.js +0 -1
  399. package/dist/c-XSB27XPS.min.js +0 -1
  400. package/dist/c-YDECTEUW.min.js +0 -1
  401. package/dist/c-YF3YKVQI.min.js +0 -1
  402. package/dist/c-YLZIV3VS.min.js +0 -1
  403. package/dist/c-ZYPXQF7B.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)
@@ -1918,3 +1946,70 @@ import { BigNumber } from "semiotic/value"
1918
1946
  ```
1919
1947
 
1920
1948
  Key props: `direction: "lower-is-better"` flips sentiment colouring — a value that went UP now reads as negative (danger). Same pattern for error rate, churn, complaint count, etc.
1949
+
1950
+
1951
+ ## Network Atlas readers
1952
+
1953
+ These examples consume admitted inputs supplied by the application. Prepare once upstream, check admission issues, and pass the same artifact to React and static rendering. The interactive reference pages provide complete synthetic inputs and downloadable JSON readings.
1954
+
1955
+ ### MotifBraidChart
1956
+
1957
+ ```tsx
1958
+ import { MotifBraidChart } from "semiotic/atlas"
1959
+ import { prepareNetworkAtlas, type NetworkAtlasSpec, type NetworkAtlasSource } from "semiotic/atlas/core"
1960
+
1961
+ export function prepareJourneys(spec: NetworkAtlasSpec, source: NetworkAtlasSource) {
1962
+ const result = prepareNetworkAtlas(spec, source)
1963
+ if (!result.ok) throw new Error(JSON.stringify(result.issues))
1964
+ return result.atlas
1965
+ }
1966
+ // Run preparation upstream. Optional occurrence.stepEntityCounts aligns with
1967
+ // nodePath; omitted counts retain a constant entityCount at every step.
1968
+ export function Journeys({ atlas }: { atlas: ReturnType<typeof prepareJourneys> }) {
1969
+ return <MotifBraidChart atlas={atlas} title="Supported journeys" accessibleTable />
1970
+ }
1971
+ ```
1972
+
1973
+ ### DependencyForestChart
1974
+
1975
+ ```tsx
1976
+ import { DependencyForestChart, DependencyMatrix } from "semiotic/atlas"
1977
+ import { prepareDependencyForest, type PreparedNetworkAtlas } from "semiotic/atlas/core"
1978
+
1979
+ export function prepareDependencies(atlas: PreparedNetworkAtlas) {
1980
+ return prepareDependencyForest(atlas)
1981
+ }
1982
+ export function Dependencies({ forest }: { forest: ReturnType<typeof prepareDependencies> }) {
1983
+ return <>
1984
+ <DependencyForestChart forest={forest} reading="required-paths"
1985
+ title="Required supplier paths" summary="Required paths describe topology; capacity remains a separate measurement." />
1986
+ <DependencyMatrix forest={forest} nodeIds={forest.order.slice(0, 6)} />
1987
+ </>
1988
+ }
1989
+ ```
1990
+
1991
+ ### FlowCircuitChart
1992
+
1993
+ ```tsx
1994
+ import { FlowCircuitChart } from "semiotic/atlas"
1995
+ import { readCircuitEdition, type FlowCircuitProjection, type CircuitEdition } from "semiotic/atlas/core"
1996
+ import { renderChartWithEvidence } from "semiotic/server"
1997
+
1998
+ // circuit comes from prepareFlowCircuit(atlas, authoredSemantics).
1999
+ // edition has passed admitCircuitEdition(circuit, authoredTape).
2000
+ export function ProcessReading({ circuit, edition, time }: {
2001
+ circuit: FlowCircuitProjection; edition: CircuitEdition; time: number
2002
+ }) {
2003
+ const mode = edition.kind === "modeled" ? "modeled-scenario" : "observed-replay"
2004
+ const reading = readCircuitEdition(edition, mode, time)
2005
+ return <FlowCircuitChart circuit={circuit} edition={edition} reading={reading}
2006
+ title={edition.label} reducedMotion accessibleTable />
2007
+ }
2008
+ export function staticProcess(circuit: FlowCircuitProjection, edition: CircuitEdition, time: number) {
2009
+ const mode = edition.kind === "modeled" ? "modeled-scenario" : "observed-replay"
2010
+ return renderChartWithEvidence("FlowCircuitChart", {
2011
+ circuit, edition, reading: readCircuitEdition(edition, mode, time),
2012
+ title: edition.label, reducedMotion: true
2013
+ })
2014
+ }
2015
+ ```
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/access` (36KB gz), `semiotic/evidence` (50KB gz), `semiotic/artifact` (121KB gz), `semiotic/artifact/react` (4KB gz), `semiotic/line` (131KB gz), `semiotic/xy` (161KB gz), `semiotic/ordinal` (130KB gz), `semiotic/network` (150KB gz), `semiotic/geo` (107KB gz), `semiotic/realtime` (159KB gz), `semiotic/realtime/core` (158KB gz), `semiotic/realtime/react` (1KB gz), `semiotic/server` (228KB gz), `semiotic/server/node` (228KB gz), `semiotic/server/edge` (230KB gz), `semiotic/utils` (98KB gz), `semiotic/utils/core` (91KB gz), `semiotic/utils/react` (7KB gz), `semiotic/recipes` (100KB gz), `semiotic/recipes/core` (92KB 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` (165KB gz), `semiotic/physics/matter` (1KB gz), `semiotic/physics/rapier` (1KB gz), `semiotic/ai` (591KB gz), `semiotic/ai/core` (138KB gz), `semiotic/controls` (10KB gz), `semiotic/rough` (3KB gz), `semiotic/text` (1KB gz). Full `semiotic` is 371KB 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` (163KB gz), `semiotic/realtime/core` (162KB 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` (3KB gz), `semiotic/value` (6KB gz), `semiotic/physics` (164KB 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.
@@ -242,6 +244,80 @@ For fitted lineage regions, set `lineageDagLayout`'s `hullGroupAccessor` (for ex
242
244
 
243
245
  `tokenLayer({input, encoding, options})` is the high-level tokenized-rendering helper for custom layouts: it runs `generateTokens`, applies row/column/grid/waffle/dotplot/bar-segment/quantile-strip placement (or `positionToken` for scale/map-driven placement), and returns ordinary dot/symbol/glyph scene nodes with `pointId`/transition identity. Use it for ISOTYPE, icon arrays, risk grids, quantile dotplots, strips, and hybrid token overlays; pass `includeRange` to render `rangeTokens`; drop down to `generateTokens` when a bespoke layout only needs records.
244
246
 
247
+ ### Network Atlas readers (semiotic/atlas)
248
+
249
+ **MotifBraidChart**, **DependencyForestChart** and **FlowCircuitChart** are public React readers and serialized chart names. Import them from `semiotic/atlas`; use `semiotic/atlas/core` for synchronous, React-free preparation and queries. All three render with `renderChartWithEvidence(name, props)` from `semiotic/server` (including Node and edge server entries).
250
+
251
+ - `MotifBraidChart`: required `atlas: PreparedNetworkAtlas`. `prepareNetworkAtlas(spec, source)` returns an admission result; inspect `ok` and issues before rendering. Rounded square steps share recognizable depths; divergent prefixes split strands. `stepEntityCounts` must align with `nodePath`; omitted counts retain constant `entityCount`. Overlapping motif counts do not partition the population.
252
+ - `DependencyForestChart`: required `forest: prepareDependencyForest(atlas)`. `reading` is `organize` or `required-paths`. `collapsedNodeIds`, `highlightedEdgeIds` and `{ nodeId, analysisRevision, relationScopeId: "directed-admitted" }` selection affect the reading without rewriting evidence. `DependencyMatrix`, `dependencyMatrix`, `getRequiredPaths`, `getBypassWitness` and `getBranchResidualConnections` expose local evidence. A structural bypass does not imply usable capacity.
253
+ - `FlowCircuitChart`: required `circuit: prepareFlowCircuit(atlas, semantics)`, `edition: admitCircuitEdition(circuit, tape)` and `reading: readCircuitEdition(edition, mode, time)`. Modes are `observed-snapshot`, `observed-replay`, `modeled-scenario`. The circuit, edition and reading must share their identities and revisions. Observed tapes and modeled scenarios remain separate; measurements use explicit units and null for unmeasured values. `particleBudget`, `placementSeed` and `reducedMotion` affect visual cues only. `exportCircuitEvidence` preserves provenance and assumptions.
254
+
255
+ These readers accept `title`, `description`, `summary`, `accessibleTable` (default true), `chartId`, `onObservation`, `linkedHover` and annotations. Dependency and Circuit expose `onSelectNode` for both pointer and keyboard activation, `linkedSelection: { name }`, and semantic `colors` overrides. Publish canonical vertex hover with `linkedHover: { name, fields: ["nodeId"] }`; consume that named selection with `selection: { name }` on Braid or `linkedSelection: { name }` on Dependency/Circuit. Use `ThemeProvider` from `semiotic/themes/react`; selections and observations share `LinkedCharts` from `semiotic/ai`. Preserve task tables and inspectors in phone layouts instead of shrinking a dense graph to unreadability.
256
+
257
+ Prepare analysis upstream or in an application-owned worker, then serialize the complete prepared artifact into chart props. `prepareNetworkAtlasAsync` loads preparation lazily but does not spawn a worker. Machine schemas describe prepared artifacts; flat-data chart suggestions cannot invent roots, route evidence, module semantics or editions. Interactive references: `/charts/motif-braid-chart`, `/charts/dependency-forest-chart`, `/charts/flow-circuit-chart`. The five synthetic stories are tested by an independent packed-package consumer.
258
+
259
+ **Motif Braid preparation** (`semiotic/recipes/core` or `semiotic/recipes`): the compatible lower-level recipe API remains available.
260
+
261
+ `await prepareNetworkAtlasAsync(spec: NetworkAtlasSpec, source: NetworkAtlasSource)` returns
262
+ `{ ok: true, atlas, issues }` or `{ ok: false, issues }`. Both preparation functions load their analysis code on demand. After checking `ok`, call
263
+ `await prepareMotifBraid(atlas)` to obtain a `MotifBraidProjection`. Use
264
+ `NetworkCustomChart` with `nodes={braid.sceneSeeds.nodes}`,
265
+ `edges={braid.sceneSeeds.edges}`, `layout={motifBraidLayout}`, and
266
+ `layoutConfig={{ braid }}`; the same props support `renderChart` from
267
+ `semiotic/server`. The layout labels every prefix step with a rounded square
268
+ at its depth, shares reference prefix ordering across selected comparison
269
+ partitions, and keeps separate parallel strands until their prefixes diverge.
270
+ Supply optional `stepEntityCounts` on each source occurrence: one finite,
271
+ nonnegative traffic count per `nodePath` entry. Width tapers between adjacent
272
+ counts using one scale across visible partitions (maximum 10 px, minimum 1 px
273
+ for positive traffic; zero traffic has zero width). Omit the array to use
274
+ `entityCount` at every step. Cohort weights and profile counts still use
275
+ `entityCount`; step traffic does not change motif prevalence. Repeated vertices
276
+ remain separate visits and short journeys end at their actual depth.
277
+ Episodes end at the second visit to a repeated state; profile
278
+ cells count each entity once and use the declared assigned denominator. Capsule
279
+ expansion is not supported. `MotifBraidChart` is public from `semiotic/atlas` and accepts `{ atlas }` directly. The existing asynchronous recipe APIs remain compatible.
280
+
281
+ Atlas layouts retain canonical `nodeId`, source and analysis revisions on
282
+ interaction data. For public Motif Braid consumers, give `NetworkCustomChart`
283
+ a `chartId` and read its events with `useChartObserver`, `ObservationReadout`
284
+ or `DetailsPanel` inside `LinkedCharts`. Link vertices with
285
+ `linkedHover={{ name: "vertices", fields: ["nodeId"] }}` and
286
+ `selection={{ name: "vertices" }}`. Selection dims marks without changing
287
+ the prepared analysis. Use `ThemeProvider` from `semiotic/themes/react`;
288
+ `colorScheme` maps can assign colors by complete journey signature.
289
+ Network keyboard navigation uses Space to activate a vertex; Enter follows
290
+ a connected edge. Accessible tables retain readable step and traffic fields.
291
+
292
+ For Dependency X-Ray preparation, optionally set
293
+ `forest.requiredPaths: { roots: ["world"], relationScopeId: "directed-admitted" }`.
294
+ The existing public `prepareNetworkAtlasAsync` facades then return
295
+ `atlas.requiredPaths`: original-graph immediate dominators, reachable and
296
+ unreachable node IDs, and an exact/incomplete status. Null parents refer to the
297
+ analytical synthetic root, not source edges. The scope currently admits only
298
+ the full directed graph. `rooted-traversal:id-asc` and
299
+ `rooted-traversal:id-desc` select an acyclic display backbone while retaining
300
+ every other original edge as residual. Neither dominance nor a structural
301
+ bypass proves usable capacity or AND-prerequisite completion. The X-Ray chart is public as `DependencyForestChart` from `semiotic/atlas`; projection and query helpers ship from `semiotic/atlas/core`. `/examples/dependency-xray` demonstrates the synthetic supplier study.
302
+
303
+ The public Flow Circuit reader exposes exact current module and original-pipe
304
+ readings to keyboard/table users and observers, including unmeasured fields.
305
+ Replay updates semantic data while retaining the physical bodies. Both public
306
+ readers accept standard chart text, `chartId`, `onObservation`, annotations,
307
+ `frameProps`, and `linkedHover`; use `linkedSelection={{ name: "vertices" }}`
308
+ alongside their local graph selection. Their `colors` layout option overrides
309
+ semantic theme roles. `/examples/flow-circuit` and `/examples/dependency-xray`
310
+ demonstrate shared observation readouts, documentation theme changes and
311
+ matching SVG exports through public package imports.
312
+
313
+ `diagnoseConfig` accepts JavaScript configurations of the five custom-chart
314
+ HOCs and checks their layout callback, input array shapes, dimensions and
315
+ interactive annotation IDs. It does not execute or prove a custom layout;
316
+ also use `renderChartWithEvidence` and `auditAccessibility`. Executable custom
317
+ layouts are still outside the serialized component schema. To export a linked
318
+ selection, supply its predicate through `frameProps.layoutSelection` on network
319
+ or geo custom charts; a server renderer cannot read a browser's selection store.
320
+
245
321
  **Decoration (labels/axes/legends): the recipe owns it.** Recipes emit own decoration via `overlays` return field (ReactNode painted on top). Built-in axes via `showAxes` on the HOC work for layouts respecting the standard scale. Recipe convention: `showXxx` boolean toggles, `xxxFormat` callbacks. Shipped recipes' toggles: marimekko `showCategoryLabels`, bullet `showLabels`+`showTicks`, parallelCoordinates `showAxes`, flextree/dagre `showLabels`, waffle/calendar none.
246
322
 
247
323
  **Interaction (hover/brush/selection): the parent owns it.** Recipes are pure — they take predicate props (e.g. `parallelCoordinatesLayout`'s `highlightFn?`) and the parent manages state via `onObservation` (`{type: "hover" | "hover-end" | ...}`), feeding a derived predicate back into `layoutConfig`. Matching rows render at full opacity; non-matching dim; highlighted z-order on top.
@@ -362,6 +438,9 @@ Heuristic chart-suggestion engine — no LLM required. Charts ship capability de
362
438
  - **Variants** encode that settings change what a chart is good for (e.g. StackedAreaChart's `streamgraph` variant boosts trend, penalizes part-to-whole).
363
439
  - **Interrogation tie-in**: pass `includeSuggestions: true` to `useChartInterrogation` and the ranked list lands in `context.suggestions` for the LLM.
364
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.
365
444
 
366
445
  ### Conversation-arc telemetry (`semiotic/ai`)
367
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.