semiotic 3.9.0 → 3.9.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 (331) hide show
  1. package/README.md +102 -90
  2. package/agent-skill/semiotic-charts/SKILL.md +14 -10
  3. package/ai/componentMetadata.cjs +13 -3
  4. package/ai/dist/mcp-server.js +140 -36407
  5. package/ai/examples.md +109 -6
  6. package/ai/reference.md +55 -18
  7. package/ai/schema.json +5964 -1190
  8. package/ai/surface-manifest.json +51 -7
  9. package/ai/system-prompt.md +16 -3
  10. package/dist/c-3SCUN5HI.min.js +1 -0
  11. package/dist/c-3VVKFA4M.min.js +1 -0
  12. package/dist/c-43TJZS3F.min.js +1 -0
  13. package/dist/c-4DTZPSUD.min.js +1 -0
  14. package/dist/c-4ES5367Y.min.js +1 -0
  15. package/dist/c-54IRWOGM.min.js +1 -0
  16. package/dist/c-5D2S4RMI.min.js +1 -0
  17. package/dist/c-5JWCTX3G.min.js +1 -0
  18. package/dist/c-6CMMSN6N.min.js +1 -0
  19. package/dist/c-6HRB2L7H.min.js +1 -0
  20. package/dist/c-7W4SV36A.min.js +1 -0
  21. package/dist/c-A4WRGZFX.min.js +1 -0
  22. package/dist/c-AG7WWVIH.min.js +1 -0
  23. package/dist/c-AH6J4MTN.min.js +1 -0
  24. package/dist/c-ALYR5LKK.min.js +1 -0
  25. package/dist/c-BYDPC44I.min.js +1 -0
  26. package/dist/c-CFFIU2MW.min.js +1 -0
  27. package/dist/c-CGNHBHCE.min.js +1 -0
  28. package/dist/c-CJYSXIFV.min.js +1 -0
  29. package/dist/c-CKLIFCGN.min.js +1 -0
  30. package/dist/c-CZF7MV67.min.js +1 -0
  31. package/dist/c-D53OKBSY.min.js +1 -0
  32. package/dist/c-DBQ2V7CH.min.js +1 -0
  33. package/dist/c-DPMVAUAW.min.js +1 -0
  34. package/dist/c-ECJCKLYY.min.js +1 -0
  35. package/dist/c-EGATGOWJ.min.js +1 -0
  36. package/dist/c-EGR6VYBW.min.js +1 -0
  37. package/dist/c-ENF72HU5.min.js +1 -0
  38. package/dist/c-ESNR43AN.min.js +1 -0
  39. package/dist/c-F3LIKINL.min.js +1 -0
  40. package/dist/c-F5ZB5GJ6.min.js +1 -0
  41. package/dist/c-G3VYMHKE.min.js +1 -0
  42. package/dist/c-GR6MOEQC.min.js +1 -0
  43. package/dist/c-GSVCN34B.min.js +1 -0
  44. package/dist/c-GYOQCEFP.min.js +1 -0
  45. package/dist/c-H3DNMTCC.min.js +1 -0
  46. package/dist/c-I6J3FEZE.min.js +1 -0
  47. package/dist/c-IGH6MGJ5.min.js +1 -0
  48. package/dist/c-II2EEAJN.min.js +1 -0
  49. package/dist/c-J6M4JHRS.min.js +1 -0
  50. package/dist/c-JM3MGLQV.min.js +1 -0
  51. package/dist/c-KM3N7F7R.min.js +1 -0
  52. package/dist/c-LF5BZFNC.min.js +1 -0
  53. package/dist/c-LKBSGFQC.min.js +1 -0
  54. package/dist/c-NDJADPIF.min.js +1 -0
  55. package/dist/c-NVPQCIL5.min.js +1 -0
  56. package/dist/c-OFWJBEE5.min.js +1 -0
  57. package/dist/c-OYFHP5F5.min.js +1 -0
  58. package/dist/c-PGKQGGQ2.min.js +1 -0
  59. package/dist/c-Q2IPZ3MU.min.js +1 -0
  60. package/dist/c-QKHMBE2E.min.js +1 -0
  61. package/dist/c-QMVM3AY6.min.js +1 -0
  62. package/dist/c-QSGWX53A.min.js +1 -0
  63. package/dist/c-RJKEKZOO.min.js +1 -0
  64. package/dist/c-SFDIIU5G.min.js +1 -0
  65. package/dist/c-SRTBCRVE.min.js +1 -0
  66. package/dist/c-T6UAIKBH.min.js +1 -0
  67. package/dist/c-TMCTEVVW.min.js +1 -0
  68. package/dist/c-TMOSJLT3.min.js +1 -0
  69. package/dist/c-U6ESPM7V.min.js +1 -0
  70. package/dist/c-UC5PTTFI.min.js +1 -0
  71. package/dist/c-VGKUEZBC.min.js +1 -0
  72. package/dist/c-VN2HG5BS.min.js +1 -0
  73. package/dist/{c-J5G56TUH.min.js → c-VPZDY5Q4.min.js} +1 -1
  74. package/dist/c-VRXUB2F2.min.js +1 -0
  75. package/dist/c-VUBQNQJH.min.js +1 -0
  76. package/dist/c-VUH4PGZY.min.js +1 -0
  77. package/dist/c-XDRV7RKW.min.js +1 -0
  78. package/dist/c-YGZHURXZ.min.js +1 -0
  79. package/dist/components/Annotation.d.ts +1 -1
  80. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  81. package/dist/components/access/chartAccessContract.d.ts +90 -0
  82. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  83. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  84. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  85. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  86. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  87. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  88. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  89. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  90. package/dist/components/ai/chartRecipeRegistry.d.ts +2 -1
  91. package/dist/components/ai/chartRecipes.d.ts +6 -0
  92. package/dist/components/ai/colorEvidence.d.ts +12 -0
  93. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  94. package/dist/components/ai/geoNavigation.d.ts +4 -0
  95. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  96. package/dist/components/ai/navigationTree.d.ts +7 -1
  97. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  98. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  99. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  100. package/dist/components/charts/index.d.ts +4 -0
  101. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  102. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  103. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  104. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  105. package/dist/components/charts/network/Treemap.d.ts +8 -1
  106. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  107. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  108. package/dist/components/charts/ordinal/DonutChart.d.ts +3 -0
  109. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  110. package/dist/components/charts/ordinal/FunnelChart.d.ts +3 -0
  111. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  112. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  113. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  114. package/dist/components/charts/ordinal/PieChart.d.ts +3 -0
  115. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  116. package/dist/components/charts/ordinal/RadarChart.d.ts +75 -0
  117. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  118. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  119. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  120. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  121. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  122. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  123. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  124. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  125. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +10 -1
  126. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +11 -1
  127. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +14 -5
  128. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +7 -1
  129. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +7 -1
  130. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  131. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +4 -2
  132. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  133. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  134. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  135. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  136. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  137. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  138. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  139. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  140. package/dist/components/charts/shared/types.d.ts +4 -2
  141. package/dist/components/charts/shared/useChartLegend.d.ts +2 -1
  142. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  143. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  144. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  145. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  146. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  147. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  148. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  149. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  150. package/dist/components/charts/xy/WaterfallChart.d.ts +68 -0
  151. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +146 -0
  152. package/dist/components/evidence/evidenceGate.d.ts +28 -0
  153. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  154. package/dist/components/realtime/types.d.ts +16 -7
  155. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  156. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  157. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  158. package/dist/components/recipes/lineageDag.d.ts +17 -0
  159. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  160. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  161. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  162. package/dist/components/semiotic-access.d.ts +9 -0
  163. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  164. package/dist/components/semiotic-ai-core.d.ts +9 -0
  165. package/dist/components/semiotic-ai.d.ts +5 -17
  166. package/dist/components/semiotic-evidence.d.ts +10 -0
  167. package/dist/components/semiotic-line.d.ts +9 -0
  168. package/dist/components/semiotic-network.d.ts +3 -0
  169. package/dist/components/semiotic-ordinal.d.ts +2 -0
  170. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  171. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  172. package/dist/components/semiotic-themes-core.d.ts +3 -0
  173. package/dist/components/semiotic-utils-core.d.ts +5 -0
  174. package/dist/components/semiotic-utils.d.ts +1 -1
  175. package/dist/components/semiotic-xy.d.ts +3 -0
  176. package/dist/components/semiotic.d.ts +9 -3
  177. package/dist/components/server/renderDashboard.d.ts +37 -0
  178. package/dist/components/server/renderEvidence.d.ts +27 -0
  179. package/dist/components/server/renderToStaticSVG.d.ts +2 -30
  180. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  181. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  182. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  183. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  184. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  185. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  186. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  187. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  188. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  189. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  190. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  191. package/dist/components/store/selectionProvenance.d.ts +8 -0
  192. package/dist/components/store/themeCore.d.ts +5 -1
  193. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  194. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  195. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  196. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  197. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  198. package/dist/components/stream/PipelineStore.d.ts +1 -1
  199. package/dist/components/stream/SceneToSVG.d.ts +1 -1
  200. package/dist/components/stream/canvasSetup.d.ts +8 -2
  201. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  202. package/dist/components/stream/geoTypes.d.ts +1 -1
  203. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  204. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  205. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  206. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  207. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  208. package/dist/components/stream/layouts/index.d.ts +6 -12
  209. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  210. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  211. package/dist/components/stream/layouts/registry.d.ts +12 -0
  212. package/dist/components/stream/marginalConfig.d.ts +3 -0
  213. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  214. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  215. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  216. package/dist/components/stream/networkTypes.d.ts +5 -1
  217. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  218. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +1 -1
  219. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  220. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  221. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  222. package/dist/components/stream/types.d.ts +8 -1
  223. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  224. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  225. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  226. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  227. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  228. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  229. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  230. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  231. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  232. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  233. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  234. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  235. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  236. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  237. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  238. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  239. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  240. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  241. package/dist/forceLayoutWorker.js +1 -1
  242. package/dist/geo.min.js +1 -1
  243. package/dist/geo.module.min.js +1 -1
  244. package/dist/network.module.min.js +1 -1
  245. package/dist/ordinal.module.min.js +1 -1
  246. package/dist/physics.module.min.js +1 -1
  247. package/dist/rough.module.min.js +1 -1
  248. package/dist/semiotic-access.d.ts +9 -0
  249. package/dist/semiotic-access.min.js +2 -0
  250. package/dist/semiotic-access.module.min.js +2 -0
  251. package/dist/semiotic-ai-core.d.ts +9 -0
  252. package/dist/semiotic-ai-core.min.js +1 -1
  253. package/dist/semiotic-ai-core.module.min.js +1 -1
  254. package/dist/semiotic-ai.d.ts +5 -17
  255. package/dist/semiotic-ai.module.min.js +1 -1
  256. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  257. package/dist/semiotic-client-shared.module.min.js +1 -1
  258. package/dist/semiotic-evidence.d.ts +10 -0
  259. package/dist/semiotic-evidence.min.js +1 -0
  260. package/dist/semiotic-evidence.module.min.js +1 -0
  261. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  262. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  263. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  264. package/dist/semiotic-experimental-vacp.min.js +1 -1
  265. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  266. package/dist/semiotic-line.d.ts +9 -0
  267. package/dist/semiotic-line.min.js +2 -0
  268. package/dist/semiotic-line.module.min.js +2 -0
  269. package/dist/semiotic-network.d.ts +3 -0
  270. package/dist/semiotic-ordinal.d.ts +2 -0
  271. package/dist/semiotic-realtime-core.d.ts +3 -2
  272. package/dist/semiotic-realtime-core.module.min.js +1 -1
  273. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  274. package/dist/semiotic-recipes-core.d.ts +6 -0
  275. package/dist/semiotic-recipes-core.module.min.js +1 -1
  276. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  277. package/dist/semiotic-server-edge.min.js +1 -1
  278. package/dist/semiotic-server-edge.module.min.js +1 -1
  279. package/dist/semiotic-server-node.min.js +1 -1
  280. package/dist/semiotic-server-node.module.min.js +1 -1
  281. package/dist/semiotic-themes-core.d.ts +3 -0
  282. package/dist/semiotic-themes-core.min.js +1 -1
  283. package/dist/semiotic-themes-core.module.min.js +1 -1
  284. package/dist/semiotic-themes.min.js +1 -1
  285. package/dist/semiotic-themes.module.min.js +1 -1
  286. package/dist/semiotic-utils-core.d.ts +5 -0
  287. package/dist/semiotic-utils-core.min.js +1 -1
  288. package/dist/semiotic-utils-core.module.min.js +1 -1
  289. package/dist/semiotic-utils.d.ts +1 -1
  290. package/dist/semiotic-utils.module.min.js +1 -1
  291. package/dist/semiotic-xy.d.ts +3 -0
  292. package/dist/semiotic.d.ts +9 -3
  293. package/dist/semiotic.module.min.js +1 -1
  294. package/dist/server.min.js +1 -1
  295. package/dist/server.module.min.js +1 -1
  296. package/dist/xy.module.min.js +1 -1
  297. package/package.json +39 -60
  298. package/dist/c-3KZD6AXJ.min.js +0 -1
  299. package/dist/c-4TWEX5HG.min.js +0 -1
  300. package/dist/c-5YCIX3VZ.min.js +0 -1
  301. package/dist/c-6FEKTA3U.min.js +0 -1
  302. package/dist/c-74HEEZGK.min.js +0 -1
  303. package/dist/c-BWNB6USU.min.js +0 -1
  304. package/dist/c-C25ENHIK.min.js +0 -1
  305. package/dist/c-CDR5AO3R.min.js +0 -1
  306. package/dist/c-E3JFRRMI.min.js +0 -1
  307. package/dist/c-EBFPQHHO.min.js +0 -1
  308. package/dist/c-GIKRQI4X.min.js +0 -1
  309. package/dist/c-GPYOFETM.min.js +0 -1
  310. package/dist/c-IDUHYYSI.min.js +0 -1
  311. package/dist/c-JAZ73J32.min.js +0 -1
  312. package/dist/c-KG3NXHAL.min.js +0 -1
  313. package/dist/c-KII3PLZE.min.js +0 -1
  314. package/dist/c-LIXGXMNS.min.js +0 -1
  315. package/dist/c-LVEY6D6B.min.js +0 -1
  316. package/dist/c-M4Y3BHFR.min.js +0 -1
  317. package/dist/c-MAIICR2Z.min.js +0 -1
  318. package/dist/c-MG5DM6VE.min.js +0 -1
  319. package/dist/c-O6U6K4CW.min.js +0 -1
  320. package/dist/c-OQ7M4AGV.min.js +0 -1
  321. package/dist/c-OXYMVK7Q.min.js +0 -1
  322. package/dist/c-QHF5YON3.min.js +0 -1
  323. package/dist/c-RR3GO5SW.min.js +0 -1
  324. package/dist/c-S2BXNNJN.min.js +0 -1
  325. package/dist/c-SUILCHWU.min.js +0 -1
  326. package/dist/c-US5ZFT6E.min.js +0 -1
  327. package/dist/c-UUKVD4WB.min.js +0 -1
  328. package/dist/c-WJCD5EUY.min.js +0 -1
  329. package/dist/c-YDAY2WFR.min.js +0 -1
  330. package/dist/c-ZOWWU34K.min.js +0 -1
  331. /package/dist/{c-COHXCW3Q.min.js → c-YZVRZGX2.min.js} +0 -0
@@ -0,0 +1,68 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import * as React from "react";
3
+ import type { StreamXYFrameProps } from "../../stream/types";
4
+ import type { RealtimeFrameHandle } from "../../realtime/types";
5
+ import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
+ import { type TooltipProp } from "../../Tooltip/Tooltip";
7
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
+ export interface WaterfallChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
9
+ data?: TDatum[];
10
+ xAccessor?: ChartAccessor<TDatum, number | Date | string>;
11
+ yAccessor?: ChartAccessor<TDatum, number>;
12
+ /** Stable ID for push-mode remove() and update(). */
13
+ pointIdAccessor?: ChartAccessor<TDatum, string>;
14
+ xScaleType?: "linear" | "log" | "time";
15
+ positiveColor?: string;
16
+ negativeColor?: string;
17
+ connectorStroke?: string;
18
+ connectorWidth?: number;
19
+ gap?: number;
20
+ enableHover?: boolean;
21
+ showGrid?: boolean;
22
+ showLegend?: boolean;
23
+ legendInteraction?: LegendInteractionMode;
24
+ legendPosition?: LegendPosition;
25
+ tooltip?: TooltipProp;
26
+ annotations?: Datum[];
27
+ xExtent?: [number | undefined, number | undefined] | [number];
28
+ yExtent?: [number | undefined, number | undefined] | [number];
29
+ frameProps?: Partial<Omit<StreamXYFrameProps, "data" | "size" | "chartType">>;
30
+ }
31
+ /**
32
+ * WaterfallChart — cumulative signed steps as floating bars.
33
+ *
34
+ * Each row is a delta. Positive values step up from the previous cumulative
35
+ * total; negative values step down. Use {@link RealtimeWaterfallChart} for
36
+ * a push-driven window of the same geometry.
37
+ *
38
+ * @example
39
+ * ```tsx
40
+ * <WaterfallChart
41
+ * data={[
42
+ * { step: "Start", value: 100 },
43
+ * { step: "Sales", value: 40 },
44
+ * { step: "Costs", value: -25 },
45
+ * { step: "Tax", value: -10 },
46
+ * ]}
47
+ * xAccessor="step"
48
+ * yAccessor="value"
49
+ * />
50
+ * ```
51
+ *
52
+ * @example
53
+ * ```tsx
54
+ * // Numeric x values use their input order as the cumulative sequence.
55
+ * <WaterfallChart
56
+ * data={[{ change: 12 }, { change: -4 }, { change: 9 }, { change: -7 }]}
57
+ * yAccessor="change"
58
+ * positiveColor="#15803d"
59
+ * negativeColor="#b91c1c"
60
+ * title="Quarterly operating changes"
61
+ * description="Sequential gains and losses in millions of dollars."
62
+ * />
63
+ * ```
64
+ */
65
+ export declare const WaterfallChart: {
66
+ <TDatum extends Datum = Datum>(props: WaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
67
+ displayName?: string;
68
+ };
@@ -0,0 +1,146 @@
1
+ /**
2
+ * ChartEvidenceEnvelope@1 — a portable provenance, access, render, meaning,
3
+ * modality-check, audit, and limits ledger.
4
+ *
5
+ * The envelope composes existing Semiotic payloads. It does not replace them:
6
+ * the Chart Access Contract becomes its reader-facing `access` section, render
7
+ * evidence becomes its `render.evidence`, and reader grounding becomes
8
+ * `meaning.grounding`. Model-authored observations are always attributed and
9
+ * never promoted above deterministic evidence.
10
+ */
11
+ import { type ChartAccessContract, type StreamStatusInput } from "../access/chartAccessContract";
12
+ import { type ChartReaderGrounding } from "../ai/readerGrounding";
13
+ import type { RenderEvidence } from "../server/renderEvidence";
14
+ export declare const CHART_EVIDENCE_ENVELOPE_VERSION: 1;
15
+ export interface EnvelopeChartSection {
16
+ component: string;
17
+ surfaceVersion: string;
18
+ chartId?: string;
19
+ }
20
+ export interface EnvelopeInputSection {
21
+ source?: string;
22
+ rowCount: number;
23
+ profile: unknown;
24
+ hash?: string;
25
+ }
26
+ export interface EnvelopeTransformOperation {
27
+ operation: string;
28
+ options?: Record<string, unknown>;
29
+ }
30
+ export interface EnvelopeTransformSection {
31
+ operations: EnvelopeTransformOperation[];
32
+ hash?: string;
33
+ }
34
+ export interface EnvelopeRenderSection {
35
+ mode: "svg" | "canvas" | "png" | "not-rendered";
36
+ sceneHash?: string;
37
+ imageHash?: string;
38
+ marksIntended?: number;
39
+ marksObserved?: number;
40
+ parity?: "match" | "mismatch" | "unknown";
41
+ evidence?: RenderEvidence;
42
+ }
43
+ export type EnvelopeAccessSection = ChartAccessContract;
44
+ export interface EnvelopeMeaningClaim {
45
+ claim: string;
46
+ evidenceIds?: string[];
47
+ confidence?: number;
48
+ model?: string;
49
+ supported?: boolean;
50
+ }
51
+ export interface EnvelopeMeaningSection {
52
+ grounding: ChartReaderGrounding;
53
+ communicativeAct?: string;
54
+ claims?: EnvelopeMeaningClaim[];
55
+ }
56
+ export interface ModalityObservation {
57
+ id: string;
58
+ channel: string;
59
+ finding: string;
60
+ severity?: "info" | "warning" | "error";
61
+ model?: string;
62
+ confidence?: number;
63
+ evidenceRefs?: string[];
64
+ }
65
+ export interface ModalityConflict {
66
+ id: string;
67
+ structuredFinding?: string;
68
+ visualFinding?: string;
69
+ resolution?: "structured" | "visual" | "human-review" | "unresolved";
70
+ note?: string;
71
+ }
72
+ export interface EnvelopeModalityChecks {
73
+ structured: {
74
+ observations: ModalityObservation[];
75
+ model: null;
76
+ };
77
+ vision: {
78
+ observations: ModalityObservation[];
79
+ model?: string;
80
+ };
81
+ tandem: {
82
+ agreements: ModalityObservation[];
83
+ conflicts: ModalityConflict[];
84
+ model?: string;
85
+ };
86
+ }
87
+ export interface EnvelopeAuditSection {
88
+ accessibility?: unknown;
89
+ design?: unknown;
90
+ dataPitfalls?: unknown;
91
+ scorecard?: unknown;
92
+ humanReview?: {
93
+ status: "not-run" | "passed" | "failed" | "manual-gap";
94
+ protocol?: string;
95
+ browserMatrix?: string[];
96
+ notes?: string[];
97
+ };
98
+ }
99
+ export interface EnvelopeLimitsSection {
100
+ uncertaintyShown?: boolean;
101
+ knownGaps: string[];
102
+ unsupportedClaims: string[];
103
+ privacyScope: Record<string, string[]>;
104
+ }
105
+ export interface EvidenceEnvelopeOptions {
106
+ surfaceVersion?: string;
107
+ chartId?: string;
108
+ sourceId?: string;
109
+ transformOperations?: EnvelopeTransformOperation[];
110
+ ssrEvidence?: RenderEvidence;
111
+ accessContract?: ChartAccessContract;
112
+ streamStatus?: StreamStatusInput | Array<StreamStatusInput>;
113
+ streamHistoryLimit?: number;
114
+ inChartContainer?: boolean;
115
+ privacyScope?: Record<string, string[]>;
116
+ claims?: EnvelopeMeaningClaim[];
117
+ modalityChecks?: Partial<EnvelopeModalityChecks>;
118
+ audits?: Omit<EnvelopeAuditSection, "accessibility">;
119
+ knownGaps?: string[];
120
+ unsupportedClaims?: string[];
121
+ uncertaintyShown?: boolean;
122
+ }
123
+ export interface ChartEvidenceEnvelope {
124
+ schemaVersion: typeof CHART_EVIDENCE_ENVELOPE_VERSION;
125
+ chart: EnvelopeChartSection;
126
+ input: EnvelopeInputSection;
127
+ transform: EnvelopeTransformSection;
128
+ render: EnvelopeRenderSection;
129
+ access: EnvelopeAccessSection;
130
+ meaning: EnvelopeMeaningSection;
131
+ modalityChecks: EnvelopeModalityChecks;
132
+ audit: EnvelopeAuditSection;
133
+ limits: EnvelopeLimitsSection;
134
+ }
135
+ /**
136
+ * Stable SHA-256 over key-sorted JSON.
137
+
138
+ * This dependency-free implementation keeps the evidence entry browser,
139
+ * edge, Node, and RSC compatible. Input is UTF-8 encoded and processed in
140
+ * standard 512-bit blocks.
141
+ */
142
+ export declare function stableEvidenceHash(value: unknown): string;
143
+ /** Assemble a versioned evidence envelope from existing Semiotic payloads. */
144
+ export declare function toEvidenceEnvelope(component: string, props: Record<string, unknown>, options?: EvidenceEnvelopeOptions): ChartEvidenceEnvelope;
145
+ /** Validate and restore an envelope without silently trusting malformed input. */
146
+ export declare function fromEvidenceEnvelope(value: unknown): ChartEvidenceEnvelope;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * Evidence publication gate for ChartEvidenceEnvelope@1.
3
+ *
4
+ * This is deliberately conservative: it fails on provable publication risks
5
+ * and records uncertainty rather than inventing semantic or visual agreement.
6
+ */
7
+ import type { ChartEvidenceEnvelope } from "./chartEvidenceEnvelope";
8
+ export type EvidenceGateStatus = "pass" | "fail";
9
+ export interface EvidenceGateFinding {
10
+ id: string;
11
+ severity: "error" | "warning";
12
+ message: string;
13
+ }
14
+ export interface EvidenceGateResult {
15
+ status: EvidenceGateStatus;
16
+ ok: boolean;
17
+ findings: EvidenceGateFinding[];
18
+ }
19
+ export interface EvidenceGateOptions {
20
+ requireRenderEvidence?: boolean;
21
+ requireAccessTable?: boolean;
22
+ requireNavigation?: boolean;
23
+ failOnCrossModalConflicts?: boolean;
24
+ /** Treat accessibility audit warnings as advisory rather than blocking. */
25
+ allowAccessibilityWarnings?: boolean;
26
+ }
27
+ /** Check whether an envelope is safe to publish under the requested policy. */
28
+ export declare function evaluateEvidenceGate(envelope: ChartEvidenceEnvelope, options?: EvidenceGateOptions): EvidenceGateResult;
@@ -4,6 +4,10 @@ export interface Bin {
4
4
  end: number;
5
5
  total: number;
6
6
  categories: Map<string, number>;
7
+ /** Raw rows retained only when a scene needs aggregate selection provenance. */
8
+ rows?: Datum[];
9
+ /** Per-category raw rows for stacked aggregate marks. */
10
+ categoryRows?: Map<string, Datum[]>;
7
11
  }
8
- export declare function computeBins(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): Map<number, Bin>;
12
+ export declare function computeBins(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string, trackRows?: boolean): Map<number, Bin>;
9
13
  export declare function computeBinExtent(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): [number, number];
@@ -193,20 +193,29 @@ export interface RealtimeFrameProps {
193
193
  tickFormatTime?: (value: number) => string;
194
194
  tickFormatValue?: (value: number) => string;
195
195
  }
196
- export interface RealtimeFrameHandle {
197
- push(point: Datum): void;
198
- pushMany(points: Datum[]): void;
196
+ /**
197
+ * Imperative push/readback contract shared by streaming-capable HOCs.
198
+ *
199
+ * `TDatum` is the authored input row accepted by `push`/`pushMany`/`replace`.
200
+ * `TReadDatum` defaults to the same type and exists for transforms whose
201
+ * materialized readback is deliberately different (RealtimeLineChart's
202
+ * aggregate mode). Omitting both parameters preserves the loose 3.x `Datum`
203
+ * surface.
204
+ */
205
+ export interface RealtimeFrameHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> {
206
+ push(point: TDatum): void;
207
+ pushMany(points: TDatum[]): void;
199
208
  /** Remove data by ID. Requires an ID accessor (pointIdAccessor or dataIdAccessor). */
200
- remove(id: string | string[]): Datum[];
209
+ remove(id: string | string[]): TReadDatum[];
201
210
  /** Update data by ID in place. Requires an ID accessor. Returns previous values. */
202
- update(id: string | string[], updater: (d: Datum) => Datum): Datum[];
211
+ update(id: string | string[], updater: (d: TReadDatum) => TReadDatum): TReadDatum[];
203
212
  /**
204
213
  * Ordinal-only bounded ingest: replace the buffer while preserving category
205
214
  * order and enter/move/exit transitions. XY/network/geo typically omit this.
206
215
  */
207
- replace?(data: Datum[]): void;
216
+ replace?(data: TDatum[]): void;
208
217
  clear(): void;
209
- getData(): Datum[];
218
+ getData(): TReadDatum[];
210
219
  /** Returns the frame's resolved scales, or null if unavailable.
211
220
  *
212
221
  * The concrete scales object differs by frame type — XY charts
@@ -0,0 +1,12 @@
1
+ import type { NetworkCustomLayout } from "../stream/networkCustomLayout";
2
+ import { type AdjacencyFlowConfig } from "./adjacencyFlowGeometry";
3
+ export type { AdjacencyFlowConfig } from "./adjacencyFlowGeometry";
4
+ /**
5
+ * Adjacency-flow ("Sankey Matrix") layout: ordered nodes sit on the diagonal,
6
+ * forward routes occupy the upper-right cells, reverse routes the lower-left,
7
+ * and weighted orthogonal links expose both adjacency and aggregate flow.
8
+ *
9
+ * Parallel edges are summed per matrix cell. Pair with
10
+ * `aggregateAdjacencyFlow` for collapsible group summaries.
11
+ */
12
+ export declare const adjacencyFlowLayout: NetworkCustomLayout<AdjacencyFlowConfig>;
@@ -0,0 +1,72 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ export type AdjacencyFlowNodeAccessor = string | ((node: Datum) => string | undefined);
3
+ export type AdjacencyFlowEdgeAccessor = string | ((edge: Datum) => string | undefined);
4
+ export type AdjacencyFlowValueAccessor = string | ((edge: Datum) => number | undefined);
5
+ export interface AggregateAdjacencyFlowOptions {
6
+ /** Node field (or callback) that names the ordered step. @default "id" */
7
+ nodeIdAccessor?: AdjacencyFlowNodeAccessor;
8
+ /** Node field (or callback) that supplies the collapsed group. @default "group" */
9
+ groupAccessor?: AdjacencyFlowNodeAccessor;
10
+ /** Node field (or callback) used for group/member labels. @default "label" */
11
+ labelAccessor?: AdjacencyFlowNodeAccessor;
12
+ /** Edge endpoint fields (or callbacks). @default "source" / "target" */
13
+ sourceAccessor?: AdjacencyFlowEdgeAccessor;
14
+ targetAccessor?: AdjacencyFlowEdgeAccessor;
15
+ /** Edge weight field (or callback). @default "value" */
16
+ valueAccessor?: AdjacencyFlowValueAccessor;
17
+ /** Groups left at member-level detail while every other multi-node group collapses. */
18
+ expandedGroups?: Iterable<string>;
19
+ /** Keep one-node groups as aggregate nodes too. @default false */
20
+ collapseSingletons?: boolean;
21
+ /** Preserve within-group movement as a self-flow on a collapsed node. @default true */
22
+ includeInternalFlows?: boolean;
23
+ /** Prefix for generated collapsed-node ids. @default "group:" */
24
+ groupIdPrefix?: string;
25
+ }
26
+ export type AggregatedAdjacencyFlowNode = Datum & {
27
+ id: string;
28
+ label: string;
29
+ group: string;
30
+ aggregate: boolean;
31
+ memberIds: string[];
32
+ memberCount: number;
33
+ internalValue: number;
34
+ incomingValue: number;
35
+ outgoingValue: number;
36
+ };
37
+ export type AggregatedAdjacencyFlowEdge = Datum & {
38
+ source: string;
39
+ target: string;
40
+ value: number;
41
+ edgeCount: number;
42
+ internal: boolean;
43
+ memberEdges: Datum[];
44
+ };
45
+ export interface AdjacencyFlowGroupSummary {
46
+ group: string;
47
+ nodeId: string | null;
48
+ label: string;
49
+ collapsed: boolean;
50
+ memberIds: string[];
51
+ internalValue: number;
52
+ incomingValue: number;
53
+ outgoingValue: number;
54
+ }
55
+ export interface AggregatedAdjacencyFlowResult {
56
+ nodes: AggregatedAdjacencyFlowNode[];
57
+ edges: AggregatedAdjacencyFlowEdge[];
58
+ groups: AdjacencyFlowGroupSummary[];
59
+ /** Edges with missing endpoints, non-positive values, or non-finite values. */
60
+ omittedEdgeCount: number;
61
+ }
62
+ /**
63
+ * Collapse an ordered flow network into group-level steps while retaining the
64
+ * weighted movement needed by {@link adjacencyFlowLayout}. The transform is
65
+ * deliberately headless: use it for a static summary, or change
66
+ * `expandedGroups` in application state for expand/collapse exploration.
67
+ *
68
+ * Parallel cross-group edges are summed. Within-group edges become a self-flow
69
+ * by default, so a summary does not silently discard the activity that made the
70
+ * detail view substantial.
71
+ */
72
+ export declare function aggregateAdjacencyFlow(inputNodes: readonly Datum[], inputEdges: readonly Datum[], options?: AggregateAdjacencyFlowOptions): AggregatedAdjacencyFlowResult;
@@ -0,0 +1,79 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { RealtimeEdge, RealtimeNode } from "../stream/networkTypes";
3
+ export interface AdjacencyFlowConfig {
4
+ /** Explicit sequence for diagonal nodes. Unlisted nodes retain input order. */
5
+ order?: readonly string[];
6
+ /** Node field (or callback) used for the displayed label. @default "label" */
7
+ labelAccessor?: string | ((node: Datum) => string);
8
+ /** Edge field (or callback) used for flow magnitude. @default "value" */
9
+ valueAccessor?: string | ((edge: Datum) => number | undefined);
10
+ /** Outer matrix padding in plot pixels. @default 18 */
11
+ padding?: number;
12
+ /** Upper bound for one matrix cell. Keeps summaries compact. @default 120 */
13
+ maxCellSize?: number;
14
+ /** Square node size in pixels. By default it is derived from cell size. */
15
+ nodeSize?: number;
16
+ /** Space reserved at either end of each node port. @default 4 */
17
+ portPadding?: number;
18
+ /** Separation between adjacent flow strokes at a node port. @default 0.75 */
19
+ flowGap?: number;
20
+ /** Smallest preferred visible flow width before fit-to-port shrinking. @default 1.25 */
21
+ minFlowWidth?: number;
22
+ /** Largest allowed flow width. @default Infinity */
23
+ maxFlowWidth?: number;
24
+ /** Fixed pixels per value unit. Omit to fit the busiest port automatically. */
25
+ flowScale?: number;
26
+ /** Radius for the orthogonal turn fillet. @default 10 */
27
+ cornerRadius?: number;
28
+ /** Flow color encoding. "source" also applies the source color to its node. @default "single" */
29
+ colorMode?: "single" | "source" | "target" | "edge";
30
+ /** Single color or per-aggregated-edge callback. */
31
+ edgeColor?: string | ((edge: Datum) => string | undefined);
32
+ /** Node color or per-node callback. */
33
+ nodeColor?: string | ((node: Datum, index: number) => string | undefined);
34
+ nodeTextColor?: string;
35
+ nodeStroke?: string;
36
+ /** Dotted adjacency grid behind the routes. @default true */
37
+ showGrid?: boolean;
38
+ /** Numeric labels at matrix-cell turns. @default true */
39
+ showValues?: boolean;
40
+ valueFormat?: (value: number, edge: Datum) => string;
41
+ /** Direction arrow placed on every route. @default true */
42
+ showArrows?: boolean;
43
+ /** Arrow fill. Defaults to the --semiotic-adjacency-flow-arrow-fill CSS variable. */
44
+ arrowColor?: string;
45
+ /** Maximum arrow width across its route. @default 14 */
46
+ arrowSize?: number;
47
+ labelFontSize?: number;
48
+ valueFontSize?: number;
49
+ /** Maximum visible label length before an ellipsis. @default 14 */
50
+ maxLabelLength?: number;
51
+ }
52
+ export interface PlacedNode {
53
+ id: string;
54
+ label: string;
55
+ datum: Datum;
56
+ index: number;
57
+ cx: number;
58
+ cy: number;
59
+ }
60
+ export interface FlowEdge {
61
+ key: string;
62
+ source: string;
63
+ target: string;
64
+ sourceIndex: number;
65
+ targetIndex: number;
66
+ value: number;
67
+ edgeCount: number;
68
+ memberEdges: Datum[];
69
+ datum: Datum;
70
+ width: number;
71
+ color: string;
72
+ }
73
+ export declare function rawDatum(value: RealtimeNode | RealtimeEdge): Datum;
74
+ export declare function roundedOrthogonalPath(points: ReadonlyArray<[number, number]>, radius: number): string;
75
+ export declare function arrowPath(x: number, y: number, angle: number, length: number, width?: number): string;
76
+ export declare function truncateLabel(label: string, maxLength: number): string;
77
+ export declare function adjacencyFlowAggregateEdges(edges: readonly RealtimeEdge[], indexById: Map<string, number>, config: AdjacencyFlowConfig): FlowEdge[];
78
+ export declare function allocateAdjacencyFlowWidths(edges: FlowEdge[], nodeSize: number, config: AdjacencyFlowConfig): Map<string, FlowEdge[]>;
79
+ export declare function allocateAdjacencyFlowPorts(groups: Map<string, FlowEdge[]>, nodesById: Map<string, PlacedNode>, nodeSize: number, config: AdjacencyFlowConfig): Map<string, number>;
@@ -53,6 +53,11 @@ export interface LineageDagConfig {
53
53
  backEdgeAccessor?: string;
54
54
  /** Edge type, drives edge color. @default "edgeType" */
55
55
  edgeTypeAccessor?: string;
56
+ /**
57
+ * Draw a convex hull behind nodes sharing this datum field (for example,
58
+ * `"subtopologyId"`). Omit to render no hull background.
59
+ */
60
+ hullGroupAccessor?: string;
56
61
  /** Fill per partition. Overridable; recipe ships dark-theme-friendly defaults. */
57
62
  partitionColors?: Partial<Record<string, string>>;
58
63
  /** Edge stroke per edgeType, plus `back` for back-edges. */
@@ -71,6 +76,18 @@ export interface LineageDagConfig {
71
76
  edgeWidth?: number;
72
77
  /** Back-edge stroke width in px. @default `edgeWidth`, else 1.5 */
73
78
  backEdgeWidth?: number;
79
+ /** Hull fill/stroke color overrides keyed by stringified group value. */
80
+ hullColors?: Partial<Record<string, string>>;
81
+ /** Space in px between node rectangles and their group hull. @default 16 */
82
+ hullPadding?: number;
83
+ /** Rounded hull-corner radius in px. @default 12 */
84
+ hullRadius?: number;
85
+ /** Hull fill opacity. @default 0.08 */
86
+ hullFillOpacity?: number;
87
+ /** Hull stroke opacity. @default 0.4 */
88
+ hullStrokeOpacity?: number;
89
+ /** Optional visible label for each hull group. */
90
+ hullLabel?: (groupValue: string) => string;
74
91
  /**
75
92
  * Render the per-node icon. Receives the resolved semantic/partition, the
76
93
  * pixel size to draw within, and a color hint. Return any SVG node. When
@@ -0,0 +1,22 @@
1
+ import type { ReactNode } from "react";
2
+ export interface LineageHullRect {
3
+ id: string;
4
+ x: number;
5
+ y: number;
6
+ w: number;
7
+ h: number;
8
+ }
9
+ export interface LineageHullOptions {
10
+ colors?: Partial<Record<string, string>>;
11
+ padding: number;
12
+ radius: number;
13
+ fillOpacity: number;
14
+ strokeOpacity: number;
15
+ label?: (groupValue: string) => string;
16
+ resolveColor: (key: string) => string;
17
+ dimById: ReadonlyMap<string, boolean>;
18
+ selectedId: string | null;
19
+ dimOpacity: number;
20
+ }
21
+ /** Deterministic plot-space hull layer for lineageDagLayout. */
22
+ export declare function renderLineageHullBackgrounds(groups: Map<string, LineageHullRect[]>, options: LineageHullOptions): ReactNode;
@@ -0,0 +1,75 @@
1
+ import { type ReactNode } from "react";
2
+ import type { Datum } from "../charts/shared/datumTypes";
3
+ import type { NetworkCustomLayout } from "../stream/networkCustomLayout";
4
+ import { computeTransitDiagramPositions, octilinearRoute, offsetTransitPath, roundedTransitPath } from "./transitDiagramGeometry";
5
+ export interface TransitDiagramLineDescriptor {
6
+ id: string;
7
+ color?: string;
8
+ label?: string;
9
+ }
10
+ export type TransitDiagramLineValue = string | number | TransitDiagramLineDescriptor | ReadonlyArray<string | number | TransitDiagramLineDescriptor>;
11
+ export type TransitDiagramMode = "primary" | "compact" | "minimap";
12
+ export interface TransitDiagramStationRenderInfo {
13
+ /** Raw station datum supplied to the chart. */
14
+ station: Datum;
15
+ /** Fitted center in plot coordinates. */
16
+ x: number;
17
+ /** Fitted center in plot coordinates. */
18
+ y: number;
19
+ /** Radius resolved for the active detail mode. */
20
+ radius: number;
21
+ /** Ordered line ids that pass through this station. */
22
+ lineIds: readonly string[];
23
+ interchange: boolean;
24
+ mode: Exclude<TransitDiagramMode, "minimap">;
25
+ }
26
+ export interface TransitDiagramConfig {
27
+ /** Complete authored x/y positions win by default; otherwise use topology. */
28
+ layoutMode?: "auto" | "authored" | "automatic";
29
+ /** Station and track level of detail. @default "primary" */
30
+ mode?: TransitDiagramMode;
31
+ xAccessor?: string | ((d: Datum) => number | undefined);
32
+ yAccessor?: string | ((d: Datum) => number | undefined);
33
+ labelAccessor?: string | ((d: Datum) => string);
34
+ lineAccessor?: string | ((d: Datum) => TransitDiagramLineValue | undefined);
35
+ lineColorAccessor?: string | ((d: Datum) => string | undefined);
36
+ /** Derive one line per source node and propagate it through a directed DAG. */
37
+ lineMode?: "source-rooted";
38
+ /** Source-node color used by source-rooted lines. Defaults to `color`. */
39
+ sourceColorAccessor?: string | ((d: Datum) => string);
40
+ lineColors?: Record<string, string>;
41
+ /** Preferred global order for parallel lines. Remaining lines sort by id. */
42
+ lineOrder?: string[];
43
+ /** Field containing authored intermediate `{x,y}` points. @default "points" */
44
+ pointsAccessor?: string;
45
+ padding?: number;
46
+ componentGap?: number;
47
+ /** Preferred endpoint for the automatic topology layout. */
48
+ rootId?: string;
49
+ direction?: "left-to-right" | "right-to-left";
50
+ lineWidth?: number;
51
+ lineGap?: number;
52
+ cornerRadius?: number;
53
+ stationRadius?: number;
54
+ interchangeRadius?: number;
55
+ stationFill?: string;
56
+ stationStroke?: string;
57
+ /** Replace primary/compact station circles with SVG rendered above the tracks. */
58
+ renderStation?: (info: TransitDiagramStationRenderInfo) => ReactNode;
59
+ showLabels?: boolean;
60
+ labelFontSize?: number;
61
+ labelColor?: string;
62
+ dimOpacity?: number;
63
+ }
64
+ /**
65
+ * Transit-diagram renderer for authored maps and plain directed graphs.
66
+ *
67
+ * Complete station x/y coordinates are fitted and honored. Otherwise the
68
+ * recipe computes a byte-stable topology-led layout with id-based tie breaks.
69
+ * Connections use horizontal, vertical, and 45-degree segments. Detail modes,
70
+ * source-rooted lines, custom station glyphs, waypoints, and line order all
71
+ * share the same fitted geometry.
72
+ */
73
+ export declare const transitDiagramLayout: NetworkCustomLayout<TransitDiagramConfig>;
74
+ export { computeTransitDiagramPositions, octilinearRoute, offsetTransitPath, roundedTransitPath };
75
+ export type { TransitDiagramPoint, TransitDiagramPositionOptions, TransitDiagramPositionResult, TransitDiagramPositionedNode, } from "./transitDiagramGeometry";
@@ -0,0 +1,47 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ export interface TransitDiagramPoint {
3
+ x: number;
4
+ y: number;
5
+ }
6
+ export interface TransitDiagramPositionedNode {
7
+ id: string;
8
+ x: number;
9
+ y: number;
10
+ data: Datum;
11
+ }
12
+ export interface TransitDiagramPositionOptions {
13
+ /** Force authored or automatic geometry. By default complete x/y data wins. */
14
+ layoutMode?: "auto" | "authored" | "automatic";
15
+ xAccessor?: string | ((d: Datum) => number | undefined);
16
+ yAccessor?: string | ((d: Datum) => number | undefined);
17
+ padding?: number;
18
+ componentGap?: number;
19
+ /** Preferred automatic-layout endpoint for its connected component. */
20
+ rootId?: string;
21
+ /** Place the automatic root at the left or right edge. @default "left-to-right" */
22
+ direction?: "left-to-right" | "right-to-left";
23
+ }
24
+ export interface TransitDiagramPositionResult {
25
+ positions: Map<string, TransitDiagramPositionedNode>;
26
+ mode: "authored" | "automatic";
27
+ warnings: string[];
28
+ /** Fit a point from the authored coordinate system into plot space. */
29
+ projectAuthoredPoint: (point: TransitDiagramPoint) => TransitDiagramPoint;
30
+ }
31
+ interface TransitDiagramEdgeLike {
32
+ source: string;
33
+ target: string;
34
+ }
35
+ interface PlotBox {
36
+ width: number;
37
+ height: number;
38
+ }
39
+ export declare function computeTransitDiagramPositions(nodes: readonly {
40
+ id: string;
41
+ data: Datum;
42
+ }[], edges: readonly TransitDiagramEdgeLike[], plot: PlotBox, options?: TransitDiagramPositionOptions): TransitDiagramPositionResult;
43
+ /** Route two points with only horizontal, vertical, and 45-degree segments. */
44
+ export declare function octilinearRoute(source: TransitDiagramPoint, target: TransitDiagramPoint): TransitDiagramPoint[];
45
+ export declare function offsetTransitPath(points: readonly TransitDiagramPoint[], distance: number): TransitDiagramPoint[];
46
+ export declare function roundedTransitPath(points: readonly TransitDiagramPoint[], radius: number): string;
47
+ export {};
@@ -0,0 +1,9 @@
1
+ /**
2
+ * semiotic/access — public access-contract surface.
3
+ *
4
+ * This entry is deliberately separate from chart family entries so production
5
+ * routes do not load access tooling merely to render a chart.
6
+ */
7
+ export { CHART_ACCESS_CONTRACT_VERSION, createChartAccessContract, } from "./access/chartAccessContract";
8
+ export type { AccessStatusRecord, ChartAccessContract, ChartAccessContractInput, ChartAccessContractText, ChartAccessContractKeyboard, ChartAccessContractNavigation, ChartAccessContractMediaPreferences, ChartAccessContractStreamStatus, ChartAccessContractSsr, ChartAccessContractEvidence, StreamStatusInput, } from "./access/chartAccessContract";
9
+ export { BAR_CHART_ACCESS_CONTRACT, LINE_CHART_ACCESS_CONTRACT, REALTIME_LINE_CHART_ACCESS_CONTRACT, } from "./access/chartAccessContractFixtures";