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,47 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { SemioticTheme } from "../store/themeCore";
3
+ import type { AestheticFeatureId, AestheticProfile, AestheticThresholds } from "./aestheticProfileTypes";
4
+ export type AestheticFeatureStatus = "pass" | "warn" | "manual" | "disabled";
5
+ export interface AestheticFeatureResult {
6
+ readonly id: AestheticFeatureId;
7
+ readonly label: string;
8
+ readonly status: AestheticFeatureStatus;
9
+ /** Normalized machine evidence score from 0..1. */
10
+ readonly score: number;
11
+ /** Resolved organizational importance. Zero disables the feature. */
12
+ readonly weight: number;
13
+ /** `score * weight`, retained so the aggregate is fully reconstructable. */
14
+ readonly contribution: number;
15
+ readonly message: string;
16
+ readonly rationale?: string;
17
+ readonly evidence: Readonly<Record<string, string | number | boolean>>;
18
+ }
19
+ export interface EvaluateAestheticsOptions {
20
+ /** Resolved chart theme. Its `aesthetics` profile is used unless `profile` overrides it. */
21
+ readonly theme?: SemioticTheme;
22
+ /** One-off policy override; useful for comparing organizational profiles. */
23
+ readonly profile?: AestheticProfile;
24
+ }
25
+ export interface AestheticEvaluationResult {
26
+ readonly component: string;
27
+ readonly profile: string;
28
+ readonly ok: boolean;
29
+ /** Weighted 0..100 result, or null when every feature weight is zero. */
30
+ readonly score: number | null;
31
+ readonly minimumScore: number;
32
+ readonly weightedPoints: number;
33
+ readonly totalWeight: number;
34
+ readonly features: ReadonlyArray<AestheticFeatureResult>;
35
+ readonly method: "weighted-machine-visible-features";
36
+ }
37
+ export declare const DEFAULT_AESTHETIC_WEIGHTS: Readonly<Record<AestheticFeatureId, number>>;
38
+ export declare const DEFAULT_AESTHETIC_THRESHOLDS: Readonly<Required<AestheticThresholds>>;
39
+ export declare const DEFAULT_AESTHETIC_PROFILE: Readonly<AestheticProfile>;
40
+ export declare const AESTHETICS_OFF_PROFILE: Readonly<AestheticProfile>;
41
+ /**
42
+ * Evaluate the machine-visible portion of an organization's aesthetic policy.
43
+ * The aggregate is a transparent weighted quality function, not a universal
44
+ * beauty prediction. Human validation can be collected separately with a
45
+ * validated instrument such as BeauVis.
46
+ */
47
+ export declare function evaluateAesthetics(component: string, props: Datum, options?: EvaluateAestheticsOptions): AestheticEvaluationResult;
@@ -0,0 +1,4 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { NavTreeNode } from "./navigationTree";
3
+ /** Build region/value and route/location readings for geographic charts. */
4
+ export declare function buildGeoNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
@@ -0,0 +1,4 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { NavTreeNode } from "./navigationTree";
3
+ /** Build the authored parent/child reading used by hierarchy chart navigation. */
4
+ export declare function buildHierarchyNavigationTree(component: string, props: Datum, maxLeaves: number, fmtNum: (number: number) => string): NavTreeNode;
@@ -23,7 +23,7 @@ export interface NavTreeNode {
23
23
  level: number;
24
24
  /** Measure value, for datum leaves. */
25
25
  value?: number;
26
- /** Raw datum, for datum leaves. */
26
+ /** Raw authored datum for any actionable mark node, including hierarchy parents. */
27
27
  datum?: Datum | null;
28
28
  children?: NavTreeNode[];
29
29
  }
@@ -34,6 +34,12 @@ export interface BuildNavigationTreeOptions {
34
34
  /** Explicit recipe; otherwise props/registry dispatch is used. */
35
35
  recipe?: ChartRecipe;
36
36
  }
37
+ /**
38
+ * Whether the runtime navigation builder owns a datum-level structure for the
39
+ * supplied chart. This is the authoritative capability check used by
40
+ * ChartAccessContract; callers should not maintain a parallel chart-name set.
41
+ */
42
+ export declare function supportsStructuredNavigation(component: string, props?: Datum, options?: Pick<BuildNavigationTreeOptions, "recipe">): boolean;
37
43
  /**
38
44
  * Build a structured navigation tree for a chart config. Full trees for XY,
39
45
  * bar, part-to-whole, distribution, network, hierarchy, and geo families;
@@ -1,2 +1,10 @@
1
1
  import type { ScorecardFixture } from "./qualityScorecard";
2
+ /**
3
+ * Semiotic's internal deterministic recommendation benchmark corpus.
4
+ *
5
+ * @deprecated This test corpus remains exported from `semiotic/ai` for 3.x
6
+ * compatibility, but application and evaluation code should own its
7
+ * `ScorecardFixture` inputs. It is intentionally absent from
8
+ * `semiotic/ai/core` and is planned for removal from the public API in 4.0.
9
+ */
2
10
  export declare const CANONICAL_FIXTURES: ReadonlyArray<ScorecardFixture>;
@@ -9,7 +9,7 @@
9
9
  * common defaults that otherwise tend to leak across component families.
10
10
  */
11
11
  export interface SuggestionPropContract {
12
- readonly componentKind: "chart-hoc" | "value-component";
12
+ readonly componentKind: "chart-hoc" | "chart-recipe" | "value-component";
13
13
  readonly commonChartProps: "supported" | "component-specific";
14
14
  readonly headingProp: string;
15
15
  readonly modeValues: ReadonlyArray<string>;
@@ -21,7 +21,7 @@ import type { Datum } from "../charts/shared/datumTypes";
21
21
  export interface UseNavigationSyncOptions {
22
22
  /** The navigation tree (from `buildNavigationTree`). */
23
23
  tree: NavTreeNode;
24
- /** `chartId` set on the chart, so its hover/click can be matched back to a leaf. */
24
+ /** `chartId` set on the chart, so its hover/click can be matched back to a semantic node. */
25
25
  chartId?: string;
26
26
  /**
27
27
  * Fields that identify a datum for highlighting + matching. Defaults to the
@@ -64,12 +64,12 @@ export interface UseNavigationSyncResult {
64
64
  onObservation: (observation: ChartObservation) => void;
65
65
  /** Alias of `onObservation` for composing an externally supplied handler. */
66
66
  handleObservation: (observation: ChartObservation) => void;
67
- /** Nav-tree leaf ids that an annotation anchors to — mark these as "has a note". */
67
+ /** Nav-tree datum-node ids that an annotation anchors to — mark these as "has a note". */
68
68
  annotatedIds: Set<string>;
69
69
  /**
70
70
  * Move the tree (and canvas highlight) to an annotation's anchored node.
71
71
  * Accepts an annotation object or its index in `annotations`. Returns `true`
72
- * if the anchor resolved to a leaf. The reader lands on the anchored datum.
72
+ * if the anchor resolved to a datum node. The reader lands on the anchor.
73
73
  */
74
74
  focusAnnotation: (annotation: Datum | number) => boolean;
75
75
  }
@@ -35,6 +35,8 @@ export { MultiAxisLineChart } from "./xy/MultiAxisLineChart";
35
35
  export type { MultiAxisLineChartProps, MultiAxisSeriesConfig } from "./xy/MultiAxisLineChart";
36
36
  export { CandlestickChart } from "./xy/CandlestickChart";
37
37
  export type { CandlestickChartProps } from "./xy/CandlestickChart";
38
+ export { WaterfallChart } from "./xy/WaterfallChart";
39
+ export type { WaterfallChartProps } from "./xy/WaterfallChart";
38
40
  export { XYCustomChart } from "./custom/XYCustomChart";
39
41
  export type { XYCustomChartProps } from "./custom/XYCustomChart";
40
42
  export { NetworkCustomChart } from "./custom/NetworkCustomChart";
@@ -59,6 +61,8 @@ export { RidgelinePlot } from "./ordinal/RidgelinePlot";
59
61
  export type { RidgelinePlotProps } from "./ordinal/RidgelinePlot";
60
62
  export { FunnelChart } from "./ordinal/FunnelChart";
61
63
  export type { FunnelChartProps } from "./ordinal/FunnelChart";
64
+ export { RadarChart } from "./ordinal/RadarChart";
65
+ export type { RadarChartProps } from "./ordinal/RadarChart";
62
66
  export { DotPlot } from "./ordinal/DotPlot";
63
67
  export type { DotPlotProps } from "./ordinal/DotPlot";
64
68
  export { PieChart } from "./ordinal/PieChart";
@@ -4,7 +4,7 @@ import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
4
4
  import type { RealtimeFrameHandle } from "../../realtime/types";
5
5
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
- import type { LegendInteractionMode } from "../shared/hooks";
7
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
8
  import { type StyleRule } from "../shared/styleRules";
9
9
  /**
10
10
  * ChordDiagram component props
@@ -32,6 +32,10 @@ export interface ChordDiagramProps<TNode extends Datum = Datum, TEdge extends Da
32
32
  nodeLabel?: ChartAccessor<TNode, string>;
33
33
  showLabels?: boolean;
34
34
  enableHover?: boolean;
35
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
36
+ showLegend?: boolean;
37
+ /** Legend position. Default `"right"`. */
38
+ legendPosition?: LegendPosition;
35
39
  legendInteraction?: LegendInteractionMode;
36
40
  edgeOpacity?: number;
37
41
  tooltip?: TooltipProp;
@@ -3,7 +3,8 @@ import * as React from "react";
3
3
  import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
4
4
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
5
5
  import { type TooltipProp } from "../../Tooltip/Tooltip";
6
- import type { LegendInteractionMode } from "../shared/hooks";
6
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
7
+ import { type StyleRule } from "../shared/styleRules";
7
8
  /**
8
9
  * CirclePack component props
9
10
  */
@@ -15,11 +16,17 @@ export interface CirclePackProps<TNode extends Datum = Datum> extends BaseChartP
15
16
  colorBy?: ChartAccessor<TNode, string | number>;
16
17
  colorScheme?: string | string[] | Record<string, string>;
17
18
  colorByDepth?: boolean;
19
+ /** Ordered data-aware node styling. Rules see the authored hierarchy node. */
20
+ styleRules?: StyleRule[];
18
21
  showLabels?: boolean;
19
22
  nodeLabel?: ChartAccessor<TNode, string>;
20
23
  circleOpacity?: number;
21
24
  padding?: number;
22
25
  enableHover?: boolean;
26
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
27
+ showLegend?: boolean;
28
+ /** Legend position. Default `"right"`. */
29
+ legendPosition?: LegendPosition;
23
30
  legendInteraction?: LegendInteractionMode;
24
31
  tooltip?: TooltipProp;
25
32
  frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
@@ -3,6 +3,8 @@ import * as React from "react";
3
3
  import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
4
4
  import type { BaseChartProps } from "../shared/types";
5
5
  import { type TooltipProp } from "../../Tooltip/Tooltip";
6
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
7
+ import { type StyleRule } from "../shared/styleRules";
6
8
  export interface OrbitNode {
7
9
  datum: Datum;
8
10
  x: number;
@@ -28,6 +30,8 @@ export interface OrbitDiagramProps<TDatum extends Datum = Datum> extends BaseCha
28
30
  colorScheme?: string | string[] | Record<string, string>;
29
31
  /** Color by hierarchy depth instead of field @default false */
30
32
  colorByDepth?: boolean;
33
+ /** Ordered data-aware node styling. Rules see the authored hierarchy node. */
34
+ styleRules?: StyleRule[];
31
35
  /**
32
36
  * Ring arrangement mode:
33
37
  * - "flat": all children in one ring
@@ -66,6 +70,11 @@ export interface OrbitDiagramProps<TDatum extends Datum = Datum> extends BaseCha
66
70
  tooltip?: TooltipProp;
67
71
  /** Enable hover @default true */
68
72
  enableHover?: boolean;
73
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
74
+ showLegend?: boolean;
75
+ /** Legend position. Default `"right"`. */
76
+ legendPosition?: LegendPosition;
77
+ legendInteraction?: LegendInteractionMode;
69
78
  /** Annotation objects */
70
79
  annotations?: Array<Datum>;
71
80
  /** Additional SVG content */
@@ -3,7 +3,8 @@ import * as React from "react";
3
3
  import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
4
4
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
5
5
  import { type TooltipProp } from "../../Tooltip/Tooltip";
6
- import type { LegendInteractionMode } from "../shared/hooks";
6
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
7
+ import { type StyleRule } from "../shared/styleRules";
7
8
  /**
8
9
  * TreeDiagram component props
9
10
  */
@@ -17,11 +18,17 @@ export interface TreeDiagramProps<TNode extends Datum = Datum> extends BaseChart
17
18
  colorBy?: ChartAccessor<TNode, string | number>;
18
19
  colorScheme?: string | string[] | Record<string, string>;
19
20
  colorByDepth?: boolean;
21
+ /** Ordered data-aware node styling. Rules see the authored hierarchy node. */
22
+ styleRules?: StyleRule[];
20
23
  edgeStyle?: "line" | "curve";
21
24
  nodeLabel?: ChartAccessor<TNode, string>;
22
25
  showLabels?: boolean;
23
26
  nodeSize?: number;
24
27
  enableHover?: boolean;
28
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
29
+ showLegend?: boolean;
30
+ /** Legend position. Default `"right"`. */
31
+ legendPosition?: LegendPosition;
25
32
  legendInteraction?: LegendInteractionMode;
26
33
  tooltip?: TooltipProp;
27
34
  frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
@@ -4,7 +4,8 @@ import * as React from "react";
4
4
  import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
5
5
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
- import type { LegendInteractionMode } from "../shared/hooks";
7
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * Treemap component props
10
11
  */
@@ -16,6 +17,8 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
16
17
  colorBy?: ChartAccessor<TNode, string | number>;
17
18
  colorScheme?: string | string[] | Record<string, string>;
18
19
  colorByDepth?: boolean;
20
+ /** Ordered data-aware node styling. Rules see the authored hierarchy node. */
21
+ styleRules?: StyleRule[];
19
22
  showLabels?: boolean;
20
23
  labelMode?: "leaf" | "parent" | "all";
21
24
  nodeLabel?: ChartAccessor<TNode, string>;
@@ -30,6 +33,10 @@ export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProp
30
33
  */
31
34
  nodeStyle?: (d: Datum) => NetworkMarkStyle;
32
35
  enableHover?: boolean;
36
+ /** Show a swatch + label legend. Defaults to `true` when `colorBy` is set. */
37
+ showLegend?: boolean;
38
+ /** Legend position. Default `"right"`. */
39
+ legendPosition?: LegendPosition;
33
40
  legendInteraction?: LegendInteractionMode;
34
41
  tooltip?: TooltipProp;
35
42
  frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
@@ -106,6 +106,12 @@ export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartPr
106
106
  legendPosition?: "right" | "left" | "top" | "bottom";
107
107
  tooltip?: TooltipProp;
108
108
  annotations?: Datum[];
109
+ /** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
110
+ brush?: boolean;
111
+ /** Callback with `{ r: [min, max] }` or null when the brush clears. */
112
+ onBrush?: (extent: {
113
+ r: [number, number];
114
+ } | null) => void;
109
115
  /**
110
116
  * Overlay a regression line through the bar tops. Accepts `true`
111
117
  * (linear), a method name (`"linear"` | `"polynomial"` | `"loess"`),
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
9
10
  data?: TDatum[];
10
11
  categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -15,6 +16,8 @@ export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
15
16
  valueFormat?: (d: number | string) => string;
16
17
  colorBy?: ChartAccessor<TDatum, string>;
17
18
  colorScheme?: string | string[] | Record<string, string>;
19
+ /** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
20
+ styleRules?: StyleRule[];
18
21
  showOutliers?: boolean;
19
22
  outlierRadius?: number;
20
23
  categoryPadding?: number;
@@ -4,6 +4,7 @@ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
4
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
+ import { type StyleRule } from "../shared/styleRules";
7
8
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
9
  export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
9
10
  data?: TDatum[];
@@ -13,6 +14,8 @@ export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChart
13
14
  centerContent?: React.ReactNode;
14
15
  colorBy?: ChartAccessor<TDatum, string>;
15
16
  colorScheme?: string | string[] | Record<string, string>;
17
+ /** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
18
+ styleRules?: StyleRule[];
16
19
  startAngle?: number;
17
20
  /** Rounded corner radius on wedge arcs */
18
21
  cornerRadius?: number;
@@ -6,6 +6,7 @@ import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
8
  import { type RegressionProp } from "../shared/regressionUtils";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
10
11
  data?: TDatum[];
11
12
  categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -16,6 +17,8 @@ export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartPro
16
17
  valueFormat?: (d: number | string) => string;
17
18
  colorBy?: ChartAccessor<TDatum, string>;
18
19
  colorScheme?: string | string[] | Record<string, string>;
20
+ /** Ordered data-aware dot styling; fieldless thresholds use `valueAccessor`. */
21
+ styleRules?: StyleRule[];
19
22
  /** Category ordering. Default (`undefined`) resolves to `"auto"`, which
20
23
  * preserves insertion order while streaming and falls through to
21
24
  * value-desc on static data — the recommended choice when using the
@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * FunnelChart component props
10
11
  */
@@ -18,6 +19,8 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
18
19
  categoryAccessor?: ChartAccessor<TDatum, string>;
19
20
  colorBy?: ChartAccessor<TDatum, string>;
20
21
  colorScheme?: string | string[] | Record<string, string>;
22
+ /** Ordered data-aware step styling; fieldless thresholds use step value. */
23
+ styleRules?: StyleRule[];
21
24
  /**
22
25
  * Funnel orientation.
23
26
  *
@@ -5,6 +5,7 @@ import type { BaseChartProps } from "../shared/types";
5
5
  import { type TooltipProp } from "../../Tooltip/Tooltip";
6
6
  import type { RealtimeFrameHandle } from "../../realtime/types";
7
7
  import { type GaugeGradientFill } from "../shared/gaugeGradient";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  export interface GaugeThreshold {
9
10
  /** Upper bound of this zone (value, not percentage) */
10
11
  value: number;
@@ -61,6 +62,8 @@ export interface GaugeChartProps extends BaseChartProps {
61
62
  fillZones?: boolean;
62
63
  /** Enable tooltip on arc segments */
63
64
  tooltip?: TooltipProp;
65
+ /** Ordered styling for rendered gauge segments. Rules see the synthetic segment fields (`category`, `value`, `_zone`, `_isFill`). */
66
+ styleRules?: StyleRule[];
64
67
  /** Annotations — supports threshold markers via standard annotation system */
65
68
  annotations?: Datum[];
66
69
  /** Enable hover interaction (default true) */
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * Histogram component props
10
11
  */
@@ -52,6 +53,8 @@ export interface HistogramProps<TDatum extends Datum = Datum> extends BaseChartP
52
53
  valueFormat?: (d: number | string) => string;
53
54
  colorBy?: ChartAccessor<TDatum, string>;
54
55
  colorScheme?: string | string[] | Record<string, string>;
56
+ /** Ordered bin styling; fieldless thresholds use displayed bin `count`. Rules can also target `bin`, `range`, and `category`. */
57
+ styleRules?: StyleRule[];
55
58
  categoryPadding?: number;
56
59
  enableHover?: boolean;
57
60
  showGrid?: boolean;
@@ -5,6 +5,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import type { StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * LikertChart — visualize Likert scale survey responses.
10
11
  *
@@ -73,6 +74,8 @@ export interface LikertChartProps<TDatum extends Datum = Datum> extends BaseChar
73
74
  * For diverging orientation, use a diverging palette (red→neutral→blue).
74
75
  */
75
76
  colorScheme?: string[];
77
+ /** Ordered data-aware segment styling; fieldless thresholds use the displayed signed proportion. */
78
+ styleRules?: StyleRule[];
76
79
  categoryLabel?: string;
77
80
  valueLabel?: string;
78
81
  valueFormat?: (d: number | string) => string;
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * PieChart component props
10
11
  */
@@ -42,6 +43,8 @@ export interface PieChartProps<TDatum extends Datum = Datum> extends BaseChartPr
42
43
  * theme's categorical palette when omitted.
43
44
  */
44
45
  colorScheme?: string | string[] | Record<string, string>;
46
+ /** Ordered data-aware wedge styling; fieldless thresholds use absolute wedge magnitude. */
47
+ styleRules?: StyleRule[];
45
48
  /**
46
49
  * Rotation in **degrees** applied to the first wedge. `0` starts at 12
47
50
  * o'clock and proceeds clockwise; `90` starts at 3 o'clock, `180` at 6
@@ -0,0 +1,2 @@
1
+ import type { ChartCapability } from "../../ai/chartCapabilityTypes";
2
+ export declare const RadarChartCapability: ChartCapability;
@@ -0,0 +1,75 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import * as React from "react";
3
+ import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
4
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
+ import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
+ import { type TooltipProp } from "../../Tooltip/Tooltip";
7
+ import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
9
+ export interface RadarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
10
+ data?: TDatum[];
11
+ /** Axis around the radar (the variables being compared). @default "attribute" */
12
+ categoryAccessor?: ChartAccessor<TDatum, string>;
13
+ /** Magnitude along each axis. @default "value" */
14
+ valueAccessor?: ChartAccessor<TDatum, number>;
15
+ /**
16
+ * Series identity — points with the same series are connected into a
17
+ * polygon. Defaults to `colorBy` when that is a string.
18
+ */
19
+ seriesAccessor?: ChartAccessor<TDatum, string>;
20
+ colorBy?: ChartAccessor<TDatum, string>;
21
+ colorScheme?: string | string[] | Record<string, string>;
22
+ /** Ordered data-aware point styling; fieldless thresholds use `valueAccessor`. */
23
+ styleRules?: StyleRule[];
24
+ pointRadius?: number;
25
+ /** Fixed value-axis domain. Defaults to `[0, data-max]`. */
26
+ valueExtent?: [number | undefined, number | undefined] | [number];
27
+ enableHover?: boolean;
28
+ showGrid?: boolean;
29
+ showLegend?: boolean;
30
+ legendInteraction?: LegendInteractionMode;
31
+ legendPosition?: LegendPosition;
32
+ tooltip?: TooltipProp;
33
+ annotations?: Datum[];
34
+ categoryFormat?: CategoryFormatFn;
35
+ frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
36
+ }
37
+ /**
38
+ * RadarChart — multivariate comparison on a shared radial axis.
39
+ *
40
+ * Each category is an axis around the circle; each series is a connected
41
+ * polygon. Data should be long-form: one row per (series, attribute).
42
+ *
43
+ * @example
44
+ * ```tsx
45
+ * <RadarChart
46
+ * data={[
47
+ * { name: "A", attribute: "speed", value: 80 },
48
+ * { name: "A", attribute: "power", value: 40 },
49
+ * { name: "B", attribute: "speed", value: 55 },
50
+ * { name: "B", attribute: "power", value: 70 },
51
+ * ]}
52
+ * categoryAccessor="attribute"
53
+ * valueAccessor="value"
54
+ * seriesAccessor="name"
55
+ * colorBy="name"
56
+ * />
57
+ * ```
58
+ *
59
+ * @example
60
+ * ```tsx
61
+ * // A single profile with function accessors and an explicit description.
62
+ * <RadarChart
63
+ * data={skills}
64
+ * categoryAccessor={(skill) => skill.label}
65
+ * valueAccessor={(skill) => skill.score}
66
+ * title="Engineering skills profile"
67
+ * description="Scores across six self-assessed engineering skills."
68
+ * pieceStyle={{ fill: "#2563eb", stroke: "#1d4ed8" }}
69
+ * />
70
+ * ```
71
+ */
72
+ export declare const RadarChart: {
73
+ <TDatum extends Datum = Datum>(props: RadarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
74
+ displayName?: string;
75
+ };
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
9
10
  data?: TDatum[];
10
11
  categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -18,6 +19,8 @@ export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseCh
18
19
  valueFormat?: (d: number | string) => string;
19
20
  colorBy?: ChartAccessor<TDatum, string>;
20
21
  colorScheme?: string | string[] | Record<string, string>;
22
+ /** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
23
+ styleRules?: StyleRule[];
21
24
  categoryPadding?: number;
22
25
  enableHover?: boolean;
23
26
  showGrid?: boolean;
@@ -6,6 +6,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
7
7
  import { type TooltipProp } from "../../Tooltip/Tooltip";
8
8
  import type { RealtimeFrameHandle } from "../../realtime/types";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
10
11
  data?: TDatum[];
11
12
  categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -16,6 +17,8 @@ export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartP
16
17
  valueFormat?: (d: number | string) => string;
17
18
  colorBy?: ChartAccessor<TDatum, string>;
18
19
  colorScheme?: string | string[] | Record<string, string>;
20
+ /** Ordered data-aware point styling; fieldless thresholds use `valueAccessor`. */
21
+ styleRules?: StyleRule[];
19
22
  sizeBy?: ChartAccessor<TDatum, number>;
20
23
  sizeRange?: [number, number];
21
24
  /** Field name or function → glyph **shape**: each point renders as a d3-shape
@@ -6,6 +6,7 @@ import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
8
  import { type GradientInput } from "../shared/gradient";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
10
11
  /** Data array. Omit for push API mode. */
11
12
  data?: TDatum[];
@@ -27,6 +28,8 @@ export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseCh
27
28
  colorBy?: ChartAccessor<TDatum, string>;
28
29
  /** Color scheme for subcategories */
29
30
  colorScheme?: string | string[] | Record<string, string>;
31
+ /** Ordered data-aware piece styling; fieldless thresholds use `valueAccessor`. */
32
+ styleRules?: StyleRule[];
30
33
  /** Padding between lanes in pixels */
31
34
  barPadding?: number;
32
35
  /** Enable hover annotations */
@@ -5,6 +5,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
5
5
  import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { RealtimeFrameHandle } from "../../realtime/types";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
9
10
  data?: TDatum[];
10
11
  categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -18,6 +19,8 @@ export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChart
18
19
  valueFormat?: (d: number | string) => string;
19
20
  colorBy?: ChartAccessor<TDatum, string>;
20
21
  colorScheme?: string | string[] | Record<string, string>;
22
+ /** Ordered summary styling; fieldless thresholds use each category's median. Statistical fields include `n`, `min`, `q1`, `median`, `q3`, `max`, and `mean`. */
23
+ styleRules?: StyleRule[];
21
24
  categoryPadding?: number;
22
25
  enableHover?: boolean;
23
26
  showGrid?: boolean;
@@ -24,17 +24,13 @@ export * from "./gauntletPublic";
24
24
  * events={[{ id: "done", gateId: "review", time: 2, effects: [{ popNegative: ["risk"] }] }]}
25
25
  * showProjection />
26
26
  * ```
27
- *
28
27
  * Compose timed gates, capacity controls, staggered starts, and projections through the corresponding props.
29
28
  */
30
29
  export declare const GauntletChart: {
31
30
  <TDatum extends Datum = Datum>(props: GauntletChartProps<TDatum> & React.RefAttributes<PhysicsFrameHandle>): React.ReactElement | null;
32
31
  displayName?: string;
33
32
  };
34
- /**
35
- * @deprecated Typo alias of {@link GauntletChart}. Use `GauntletChart` instead.
36
- * Removed in the next major version.
37
- */
33
+ /** @deprecated Typo alias. Use {@link GauntletChart}; removed next major. */
38
34
  export declare const GuantletChart: {
39
35
  <TDatum extends Datum = Datum>(props: GauntletChartProps<TDatum> & React.RefAttributes<PhysicsFrameHandle>): React.ReactElement | null;
40
36
  displayName?: string;
@@ -2,6 +2,7 @@ import type { Datum } from "../shared/datumTypes";
2
2
  import type { TooltipProp } from "../../Tooltip/Tooltip";
3
3
  import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
4
4
  import type { BlockerAmplification, DependencyAccessor, DependencyTaskStatus } from "./dependencyMachine";
5
+ import type { PhysicsSimulationStateChange } from "./physicsHocUtils";
5
6
  export type ChainReactionMode = "snapshot" | "replay" | "mechanical";
6
7
  export type ChainReactionInsight = "none" | "blocker-amplification";
7
8
  export type ChainReactionControl = "play" | "pause" | "step" | "reset" | "settle";
@@ -85,6 +86,8 @@ export interface ChainReactionChartProps<TDatum extends Datum = Datum> {
85
86
  selectedTaskIDs?: readonly string[];
86
87
  onSelectionChange?: (ids: string[]) => void;
87
88
  onObservation?: (event: ChainReactionObservation<TDatum>) => void;
89
+ /** Observe the underlying physics pipeline entering running/settled states. */
90
+ onSimulationStateChange?: PhysicsSimulationStateChange;
88
91
  reducedMotion?: "settle";
89
92
  seed?: number;
90
93
  width?: number;