semiotic 3.9.1 → 3.10.0

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 (566) hide show
  1. package/README.md +137 -58
  2. package/agent-skill/semiotic-charts/SKILL.md +27 -17
  3. package/ai/artifact-contract-reference.md +408 -0
  4. package/ai/artifact-surface-inventory.json +5586 -0
  5. package/ai/behaviorContracts.cjs +24 -2
  6. package/ai/cli.js +480 -56
  7. package/ai/componentMetadata.cjs +13 -3
  8. package/ai/dist/mcp-server.js +140 -36407
  9. package/ai/examples.md +110 -7
  10. package/ai/reference.md +82 -28
  11. package/ai/schema.json +7675 -1471
  12. package/ai/surface-manifest.json +60 -9
  13. package/ai/system-prompt.md +18 -3
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2WK7YJLL.min.js +1 -0
  23. package/dist/c-33QOXEUG.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-447VIMRO.min.js +1 -0
  26. package/dist/c-4FN7Q6VQ.min.js +1 -0
  27. package/dist/c-553QUDKA.min.js +1 -0
  28. package/dist/c-55BAJ333.min.js +1 -0
  29. package/dist/c-7242NXSG.min.js +1 -0
  30. package/dist/c-7EGHJU2F.min.js +1 -0
  31. package/dist/c-7HP7MB2I.min.js +1 -0
  32. package/dist/c-7NBU5ZKS.min.js +1 -0
  33. package/dist/c-AFBSWT77.min.js +1 -0
  34. package/dist/c-AJ7EC32V.min.js +1 -0
  35. package/dist/c-AQADQNY7.min.js +1 -0
  36. package/dist/c-ATM475SA.min.js +1 -0
  37. package/dist/c-AVO3Q7T7.min.js +1 -0
  38. package/dist/c-AZKPVBOC.min.js +1 -0
  39. package/dist/c-BNFJMDHN.min.js +1 -0
  40. package/dist/c-BNG5ECK5.min.js +1 -0
  41. package/dist/c-BOHCQILI.min.js +1 -0
  42. package/dist/c-CCTGN5CK.min.js +1 -0
  43. package/dist/c-CPSPZH6A.min.js +1 -0
  44. package/dist/c-CPV4N35K.min.js +1 -0
  45. package/dist/c-D6HAAPTX.min.js +1 -0
  46. package/dist/c-DE5Q3U2X.min.js +1 -0
  47. package/dist/c-DK662R77.min.js +1 -0
  48. package/dist/c-DY2676CR.min.js +1 -0
  49. package/dist/c-E32M6XW5.min.js +1 -0
  50. package/dist/c-E4JDJH4I.min.js +1 -0
  51. package/dist/c-E7I2L7CU.min.js +1 -0
  52. package/dist/c-EBOQ7ER7.min.js +1 -0
  53. package/dist/c-ELDWAO2V.min.js +1 -0
  54. package/dist/c-EUBTECGM.min.js +1 -0
  55. package/dist/c-GNTXRXRN.min.js +1 -0
  56. package/dist/c-GSZRZRD6.min.js +1 -0
  57. package/dist/c-GWX7JGMF.min.js +1 -0
  58. package/dist/c-GXV3C3MO.min.js +1 -0
  59. package/dist/c-HHTK2R75.min.js +1 -0
  60. package/dist/c-HLLFJYTY.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HXDKPIKR.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IDJV3CZK.min.js +1 -0
  65. package/dist/c-ITKX3RC5.min.js +1 -0
  66. package/dist/c-JG2JCQLP.min.js +1 -0
  67. package/dist/c-JLGRHXGZ.min.js +1 -0
  68. package/dist/c-JO2UGTCP.min.js +1 -0
  69. package/dist/c-JUKIWTBJ.min.js +1 -0
  70. package/dist/c-KCRJGUHP.min.js +1 -0
  71. package/dist/c-LMGSSD2E.min.js +1 -0
  72. package/dist/c-LYQMZMZQ.min.js +1 -0
  73. package/dist/c-LYVKDBQJ.min.js +1 -0
  74. package/dist/c-MVR3RWF3.min.js +1 -0
  75. package/dist/c-MXCP7GNZ.min.js +1 -0
  76. package/dist/c-NG7BLZTR.min.js +1 -0
  77. package/dist/c-NYZ2QNAM.min.js +1 -0
  78. package/dist/c-OO5QLMJC.min.js +1 -0
  79. package/dist/c-OOVX2JPQ.min.js +1 -0
  80. package/dist/c-ORLEBW72.min.js +1 -0
  81. package/dist/c-P65V6HLO.min.js +1 -0
  82. package/dist/c-PP6VY3QU.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSNI6KAZ.min.js +1 -0
  85. package/dist/c-PYNW54D2.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-QAVFOEUY.min.js +1 -0
  88. package/dist/c-ROEHCIGV.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-T2V7O2LO.min.js +1 -0
  91. package/dist/c-TIXX5CAU.min.js +1 -0
  92. package/dist/c-TKG2NP7G.min.js +1 -0
  93. package/dist/c-VJTDST2R.min.js +1 -0
  94. package/dist/c-VXLOLYTO.min.js +1 -0
  95. package/dist/c-W4ZUKSEQ.min.js +1 -0
  96. package/dist/c-WH2O53VI.min.js +1 -0
  97. package/dist/c-WNGH47HF.min.js +1 -0
  98. package/dist/c-WUWXGQYA.min.js +1 -0
  99. package/dist/c-XDQKXPX4.min.js +1 -0
  100. package/dist/c-XSB27XPS.min.js +1 -0
  101. package/dist/c-YDECTEUW.min.js +1 -0
  102. package/dist/c-YF3YKVQI.min.js +1 -0
  103. package/dist/c-YLZIV3VS.min.js +1 -0
  104. package/dist/c-ZYPXQF7B.min.js +1 -0
  105. package/dist/components/Annotation.d.ts +3 -2
  106. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  107. package/dist/components/access/chartAccessContract.d.ts +90 -0
  108. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  109. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  110. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  111. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  112. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  113. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  114. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  115. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
  117. package/dist/components/ai/chartRecipes.d.ts +10 -0
  118. package/dist/components/ai/colorEvidence.d.ts +12 -0
  119. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  120. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  121. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  122. package/dist/components/ai/geoNavigation.d.ts +4 -0
  123. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  124. package/dist/components/ai/navigationTree.d.ts +7 -1
  125. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  126. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  127. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  128. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  129. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  130. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  131. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  132. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  133. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  134. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  135. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  136. package/dist/components/artifact/claimGraph.d.ts +5 -0
  137. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  138. package/dist/components/artifact/claims.d.ts +24 -0
  139. package/dist/components/artifact/collection.d.ts +10 -0
  140. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  141. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  142. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  143. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  144. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  145. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  146. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  147. package/dist/components/artifact/contract.d.ts +30 -0
  148. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  149. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  150. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  151. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  152. package/dist/components/artifact/exportPaths.d.ts +8 -0
  153. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  154. package/dist/components/artifact/fingerprint.d.ts +36 -0
  155. package/dist/components/artifact/grounding.d.ts +51 -0
  156. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  157. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  158. package/dist/components/artifact/identity.d.ts +19 -0
  159. package/dist/components/artifact/inheritance.d.ts +48 -0
  160. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  161. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  162. package/dist/components/artifact/obligations.d.ts +3 -0
  163. package/dist/components/artifact/policies.d.ts +45 -0
  164. package/dist/components/artifact/policyRelations.d.ts +3 -0
  165. package/dist/components/artifact/recordProjection.d.ts +7 -0
  166. package/dist/components/artifact/representation.d.ts +50 -0
  167. package/dist/components/artifact/serialization.d.ts +40 -0
  168. package/dist/components/artifact/temporal.d.ts +32 -0
  169. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  170. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  171. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  172. package/dist/components/artifact/types.d.ts +341 -0
  173. package/dist/components/artifact/validation.d.ts +13 -0
  174. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  175. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  176. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  177. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  178. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  179. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  180. package/dist/components/charts/index.d.ts +4 -0
  181. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  182. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  183. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  184. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  185. package/dist/components/charts/network/Treemap.d.ts +8 -1
  186. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  187. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  188. package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
  189. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  190. package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
  191. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  192. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  193. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  194. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  195. package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
  196. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  197. package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
  198. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  199. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  200. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  201. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  202. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  203. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  204. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  205. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  206. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  207. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  208. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  209. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  210. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  211. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  212. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  213. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  214. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  215. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  216. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  217. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  218. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  219. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  220. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  221. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  222. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  223. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  224. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  225. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  226. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
  227. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
  228. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
  229. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
  230. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
  231. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  232. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  233. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
  234. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  235. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  236. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  237. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  238. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  239. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  240. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  241. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  242. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  243. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  244. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  245. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  246. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  247. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  248. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  249. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  250. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  251. package/dist/components/charts/shared/types.d.ts +4 -2
  252. package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
  253. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  254. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  255. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  256. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  257. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  258. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  259. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  260. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  261. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  262. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  263. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  264. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  265. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  266. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  267. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  268. package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
  269. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  270. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  271. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  272. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
  273. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  274. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  275. package/dist/components/evidence/evidenceGate.d.ts +30 -0
  276. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  277. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  278. package/dist/components/export/chartConfig.d.ts +40 -5
  279. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  280. package/dist/components/legendLayout.d.ts +18 -0
  281. package/dist/components/legendStyles.d.ts +4 -0
  282. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  283. package/dist/components/realtime/types.d.ts +16 -7
  284. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  285. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  286. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  287. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  288. package/dist/components/recipes/intervals.d.ts +1 -1
  289. package/dist/components/recipes/lineageDag.d.ts +17 -0
  290. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  291. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  292. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  293. package/dist/components/semiotic-access.d.ts +9 -0
  294. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  295. package/dist/components/semiotic-ai-core.d.ts +38 -18
  296. package/dist/components/semiotic-ai.d.ts +20 -20
  297. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  298. package/dist/components/semiotic-artifact.d.ts +23 -0
  299. package/dist/components/semiotic-evidence.d.ts +10 -0
  300. package/dist/components/semiotic-experimental.d.ts +1 -1
  301. package/dist/components/semiotic-line.d.ts +9 -0
  302. package/dist/components/semiotic-network.d.ts +3 -0
  303. package/dist/components/semiotic-ordinal.d.ts +2 -0
  304. package/dist/components/semiotic-physics.d.ts +4 -4
  305. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  306. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  307. package/dist/components/semiotic-text.d.ts +2 -0
  308. package/dist/components/semiotic-themes-core.d.ts +3 -0
  309. package/dist/components/semiotic-utils-core.d.ts +19 -14
  310. package/dist/components/semiotic-xy.d.ts +3 -0
  311. package/dist/components/semiotic.d.ts +11 -5
  312. package/dist/components/server/renderDashboard.d.ts +37 -0
  313. package/dist/components/server/renderEvidence.d.ts +39 -0
  314. package/dist/components/server/renderToStaticSVG.d.ts +5 -30
  315. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  316. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  317. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  318. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  319. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  320. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  321. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  322. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  323. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  324. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  325. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  326. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  327. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  328. package/dist/components/server/staticXYGrid.d.ts +1 -1
  329. package/dist/components/server/svgSizing.d.ts +6 -0
  330. package/dist/components/shared/svgRoot.d.ts +17 -0
  331. package/dist/components/store/selectionProvenance.d.ts +14 -0
  332. package/dist/components/store/themeCore.d.ts +5 -1
  333. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  334. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  335. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  336. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  337. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  338. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  339. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  340. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  341. package/dist/components/stream/PipelineStore.d.ts +1 -1
  342. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  343. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  344. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  345. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  346. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  347. package/dist/components/stream/XYGrid.d.ts +11 -0
  348. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  349. package/dist/components/stream/canvasSetup.d.ts +8 -2
  350. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  351. package/dist/components/stream/geoTypes.d.ts +1 -1
  352. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  353. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  354. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  355. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  356. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  357. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  358. package/dist/components/stream/layouts/index.d.ts +6 -12
  359. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  360. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  361. package/dist/components/stream/layouts/registry.d.ts +12 -0
  362. package/dist/components/stream/marginalConfig.d.ts +3 -0
  363. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  364. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  365. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  366. package/dist/components/stream/networkTypes.d.ts +5 -1
  367. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  368. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  369. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  370. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  371. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  372. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  373. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
  374. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  375. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  376. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  377. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  378. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  379. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  380. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  381. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  382. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  383. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  384. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  385. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  386. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  387. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  388. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  389. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  390. package/dist/components/stream/types.d.ts +12 -54
  391. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  392. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  393. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  394. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  395. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  396. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  397. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  398. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  399. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  400. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  401. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  402. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  403. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  404. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  405. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  406. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  407. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  408. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  409. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  410. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  411. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  412. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  413. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  414. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  415. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  416. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  417. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  418. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  419. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  420. package/dist/controls.module.min.js +1 -1
  421. package/dist/forceLayoutWorker.js +1 -1
  422. package/dist/geo.min.js +1 -1
  423. package/dist/geo.module.min.js +1 -1
  424. package/dist/network.module.min.js +1 -1
  425. package/dist/ordinal.module.min.js +1 -1
  426. package/dist/physics-matter.min.js +1 -1
  427. package/dist/physics-matter.module.min.js +1 -1
  428. package/dist/physics-rapier.min.js +1 -1
  429. package/dist/physics-rapier.module.min.js +1 -1
  430. package/dist/physics.module.min.js +1 -1
  431. package/dist/physicsWorker.js +1 -1
  432. package/dist/processSankeyLayoutWorker.js +1 -1
  433. package/dist/rough.min.js +1 -1
  434. package/dist/rough.module.min.js +1 -1
  435. package/dist/semiotic-access.d.ts +9 -0
  436. package/dist/semiotic-access.min.js +2 -0
  437. package/dist/semiotic-access.module.min.js +2 -0
  438. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  439. package/dist/semiotic-ai-core.d.ts +38 -18
  440. package/dist/semiotic-ai-core.min.js +1 -1
  441. package/dist/semiotic-ai-core.module.min.js +1 -1
  442. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  443. package/dist/semiotic-ai.d.ts +20 -20
  444. package/dist/semiotic-ai.module.min.js +1 -1
  445. package/dist/semiotic-artifact-react.d.ts +10 -0
  446. package/dist/semiotic-artifact-react.min.js +2 -0
  447. package/dist/semiotic-artifact-react.module.min.js +2 -0
  448. package/dist/semiotic-artifact.d.ts +23 -0
  449. package/dist/semiotic-artifact.min.js +1 -0
  450. package/dist/semiotic-artifact.module.min.js +1 -0
  451. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  452. package/dist/semiotic-client-glyph.module.min.js +1 -1
  453. package/dist/semiotic-client-responsive.module.min.js +1 -1
  454. package/dist/semiotic-client-shared.module.min.js +1 -1
  455. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  456. package/dist/semiotic-data.min.js +1 -1
  457. package/dist/semiotic-data.module.min.js +1 -1
  458. package/dist/semiotic-evidence.d.ts +10 -0
  459. package/dist/semiotic-evidence.min.js +1 -0
  460. package/dist/semiotic-evidence.module.min.js +1 -0
  461. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  462. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  463. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  464. package/dist/semiotic-experimental-vacp.min.js +1 -1
  465. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  466. package/dist/semiotic-experimental.d.ts +1 -1
  467. package/dist/semiotic-line.d.ts +9 -0
  468. package/dist/semiotic-line.min.js +2 -0
  469. package/dist/semiotic-line.module.min.js +2 -0
  470. package/dist/semiotic-network.d.ts +3 -0
  471. package/dist/semiotic-ordinal.d.ts +2 -0
  472. package/dist/semiotic-physics.d.ts +4 -4
  473. package/dist/semiotic-realtime-core.d.ts +3 -2
  474. package/dist/semiotic-realtime-core.module.min.js +1 -1
  475. package/dist/semiotic-realtime-react.module.min.js +1 -1
  476. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  477. package/dist/semiotic-recipes-core.d.ts +6 -0
  478. package/dist/semiotic-recipes-core.module.min.js +1 -1
  479. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  480. package/dist/semiotic-recipes-react.min.js +1 -1
  481. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  482. package/dist/semiotic-server-edge.min.js +1 -1
  483. package/dist/semiotic-server-edge.module.min.js +1 -1
  484. package/dist/semiotic-server-node.min.js +1 -1
  485. package/dist/semiotic-server-node.module.min.js +1 -1
  486. package/dist/semiotic-text.d.ts +2 -0
  487. package/dist/semiotic-text.min.js +2 -0
  488. package/dist/semiotic-text.module.min.js +2 -0
  489. package/dist/semiotic-themes-core.d.ts +3 -0
  490. package/dist/semiotic-themes-core.min.js +1 -1
  491. package/dist/semiotic-themes-core.module.min.js +1 -1
  492. package/dist/semiotic-themes.min.js +1 -1
  493. package/dist/semiotic-themes.module.min.js +1 -1
  494. package/dist/semiotic-utils-core.d.ts +19 -14
  495. package/dist/semiotic-utils-core.min.js +1 -1
  496. package/dist/semiotic-utils-core.module.min.js +1 -1
  497. package/dist/semiotic-value.module.min.js +1 -1
  498. package/dist/semiotic-xy.d.ts +3 -0
  499. package/dist/semiotic.d.ts +11 -5
  500. package/dist/semiotic.module.min.js +1 -1
  501. package/dist/server.min.js +1 -1
  502. package/dist/server.module.min.js +1 -1
  503. package/dist/xy.module.min.js +1 -1
  504. package/package.json +91 -71
  505. package/spec/README.md +8 -3
  506. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  507. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  508. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  509. package/dist/c-3BLJEQNG.min.js +0 -1
  510. package/dist/c-3KZD6AXJ.min.js +0 -1
  511. package/dist/c-4TWEX5HG.min.js +0 -1
  512. package/dist/c-52TEGIUJ.min.js +0 -1
  513. package/dist/c-5YCIX3VZ.min.js +0 -1
  514. package/dist/c-6FEKTA3U.min.js +0 -1
  515. package/dist/c-6O5EVOPH.min.js +0 -1
  516. package/dist/c-74HEEZGK.min.js +0 -1
  517. package/dist/c-AKAF6JAD.min.js +0 -1
  518. package/dist/c-BBKITSXB.min.js +0 -1
  519. package/dist/c-BWNB6USU.min.js +0 -1
  520. package/dist/c-C25ENHIK.min.js +0 -1
  521. package/dist/c-CDR5AO3R.min.js +0 -1
  522. package/dist/c-COHXCW3Q.min.js +0 -1
  523. package/dist/c-DADXPJXV.min.js +0 -1
  524. package/dist/c-E3JFRRMI.min.js +0 -1
  525. package/dist/c-EBFPQHHO.min.js +0 -1
  526. package/dist/c-G36WS6LN.min.js +0 -1
  527. package/dist/c-GGISSW5E.min.js +0 -1
  528. package/dist/c-GIKRQI4X.min.js +0 -1
  529. package/dist/c-GPYOFETM.min.js +0 -1
  530. package/dist/c-IDUHYYSI.min.js +0 -1
  531. package/dist/c-IUHFPMHD.min.js +0 -1
  532. package/dist/c-J5G56TUH.min.js +0 -1
  533. package/dist/c-JAZ73J32.min.js +0 -1
  534. package/dist/c-KG3NXHAL.min.js +0 -1
  535. package/dist/c-KII3PLZE.min.js +0 -1
  536. package/dist/c-LIXGXMNS.min.js +0 -1
  537. package/dist/c-LVEY6D6B.min.js +0 -1
  538. package/dist/c-M4Y3BHFR.min.js +0 -1
  539. package/dist/c-MAIICR2Z.min.js +0 -1
  540. package/dist/c-MG5DM6VE.min.js +0 -1
  541. package/dist/c-MNF2S4AA.min.js +0 -1
  542. package/dist/c-MT3WBK7M.min.js +0 -1
  543. package/dist/c-NY3JWV2K.min.js +0 -1
  544. package/dist/c-O6U6K4CW.min.js +0 -1
  545. package/dist/c-OQ7M4AGV.min.js +0 -1
  546. package/dist/c-OXYMVK7Q.min.js +0 -1
  547. package/dist/c-PPWDL5ZI.min.js +0 -1
  548. package/dist/c-QHF5YON3.min.js +0 -1
  549. package/dist/c-RR3GO5SW.min.js +0 -1
  550. package/dist/c-RSVIHIQ4.min.js +0 -1
  551. package/dist/c-S2BXNNJN.min.js +0 -1
  552. package/dist/c-S6U5CGT5.min.js +0 -1
  553. package/dist/c-SLGMUBUL.min.js +0 -1
  554. package/dist/c-SUILCHWU.min.js +0 -1
  555. package/dist/c-TZW3JGJ5.min.js +0 -1
  556. package/dist/c-US5ZFT6E.min.js +0 -1
  557. package/dist/c-USFMFKIH.min.js +0 -1
  558. package/dist/c-UUKVD4WB.min.js +0 -1
  559. package/dist/c-VGW3VG3I.min.js +0 -1
  560. package/dist/c-W3CE4A4S.min.js +0 -1
  561. package/dist/c-WJCD5EUY.min.js +0 -1
  562. package/dist/c-X5UBGU2V.min.js +0 -1
  563. package/dist/c-YDAY2WFR.min.js +0 -1
  564. package/dist/c-ZOWWU34K.min.js +0 -1
  565. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  566. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -0,0 +1,7 @@
1
+ type ValidationIssue = {
2
+ path: string;
3
+ message: string;
4
+ };
5
+ /** Validate optional public contract surfaces that are independent of claims. */
6
+ export declare function validateArtifactSurfaces(value: Record<string, unknown>, errors: ValidationIssue[]): void;
7
+ export {};
@@ -0,0 +1,3 @@
1
+ import { type ValidationIssue } from "./validationPrimitives";
2
+ /** Validate nested clock and source shapes used by the deterministic audit. */
3
+ export declare function validateTemporalStructure(value: Record<string, unknown>, errors: ValidationIssue[]): void;
@@ -8,6 +8,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
8
  import type { Style } from "../../stream/types";
9
9
  import type { GeoParticleStyle } from "../../stream/GeoParticlePool";
10
10
  import { type AreasProp } from "../../geo/useReferenceAreas";
11
+ import { type StyleRule } from "../shared/styleRules";
11
12
  export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
12
13
  /** Flow edges with source/target/value */
13
14
  flows?: Array<Datum & {
@@ -49,6 +50,12 @@ export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartPro
49
50
  edgeLinecap?: "butt" | "round" | "square";
50
51
  /** Color scheme for edges @default "category10" */
51
52
  colorScheme?: string | string[] | Record<string, string>;
53
+ /**
54
+ * Declarative, threshold-aware flow-edge styling. `ctx.value` is the
55
+ * `valueAccessor` magnitude so `{ gte: 1000 }` restyles heavy flows.
56
+ * Last applicable rule wins per property. Layers over `edgeColorBy`.
57
+ */
58
+ styleRules?: StyleRule[];
52
59
  /** Show animated particles along flow lines */
53
60
  showParticles?: boolean;
54
61
  /** Particle appearance and behavior */
@@ -0,0 +1,18 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { Style } from "../../stream/types";
3
+ import { type StyleRule } from "../shared/styleRules";
4
+ /** Map a flow value onto `edgeWidthRange`, collapsing non-finite inputs to min. */
5
+ export declare function flowMapEdgeWidth(value: unknown, domain: [number, number] | undefined, range: [number, number]): number;
6
+ /**
7
+ * Shared FlowMap edge style for the client HOC and `renderChart`. `fillOpacity: 0`
8
+ * is load-bearing: the line renderer treats fillOpacity &gt; 0 as area fill.
9
+ */
10
+ export declare function buildFlowMapLineStyle(options: {
11
+ valueAccessor: string;
12
+ valueDomain: [number, number] | undefined;
13
+ edgeWidthRange: [number, number];
14
+ resolveStroke: (d: Datum) => string;
15
+ edgeOpacity: number;
16
+ edgeLinecap: "butt" | "round" | "square";
17
+ styleRules?: ReadonlyArray<StyleRule>;
18
+ }): (d: Datum) => Style;
@@ -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,10 @@ 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[];
19
+ /** Formatter for the default tooltip value. */
20
+ valueFormat?: (d: number | string) => string;
16
21
  startAngle?: number;
17
22
  /** Rounded corner radius on wedge arcs */
18
23
  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
  *
@@ -42,6 +45,8 @@ export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChar
42
45
  annotations?: Datum[];
43
46
  /** Custom formatter for category tick labels */
44
47
  categoryFormat?: CategoryFormatFn;
48
+ /** Formatter for the default tooltip and vertical-funnel value axis. */
49
+ valueFormat?: (d: number | string) => string;
45
50
  frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
46
51
  }
47
52
  /**
@@ -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) */
@@ -45,6 +45,12 @@ export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends Base
45
45
  legendPosition?: "right" | "left" | "top" | "bottom";
46
46
  tooltip?: TooltipProp;
47
47
  annotations?: Datum[];
48
+ /** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
49
+ brush?: boolean;
50
+ /** Callback with `{ r: [min, max] }` or null when the brush clears. */
51
+ onBrush?: (extent: {
52
+ r: [number, number];
53
+ } | null) => void;
48
54
  /** Custom formatter for category tick labels */
49
55
  categoryFormat?: CategoryFormatFn;
50
56
  /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. */
@@ -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,10 @@ 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[];
48
+ /** Formatter for the default tooltip value. */
49
+ valueFormat?: (d: number | string) => string;
45
50
  /**
46
51
  * Rotation in **degrees** applied to the first wedge. `0` starts at 12
47
52
  * 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,77 @@
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
+ /** Formatter for axis ticks and the default tooltip. */
28
+ valueFormat?: (d: number | string) => string;
29
+ enableHover?: boolean;
30
+ showGrid?: boolean;
31
+ showLegend?: boolean;
32
+ legendInteraction?: LegendInteractionMode;
33
+ legendPosition?: LegendPosition;
34
+ tooltip?: TooltipProp;
35
+ annotations?: Datum[];
36
+ categoryFormat?: CategoryFormatFn;
37
+ frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
38
+ }
39
+ /**
40
+ * RadarChart — multivariate comparison on a shared radial axis.
41
+ *
42
+ * Each category is an axis around the circle; each series is a connected
43
+ * polygon. Data should be long-form: one row per (series, attribute).
44
+ *
45
+ * @example
46
+ * ```tsx
47
+ * <RadarChart
48
+ * data={[
49
+ * { name: "A", attribute: "speed", value: 80 },
50
+ * { name: "A", attribute: "power", value: 40 },
51
+ * { name: "B", attribute: "speed", value: 55 },
52
+ * { name: "B", attribute: "power", value: 70 },
53
+ * ]}
54
+ * categoryAccessor="attribute"
55
+ * valueAccessor="value"
56
+ * seriesAccessor="name"
57
+ * colorBy="name"
58
+ * />
59
+ * ```
60
+ *
61
+ * @example
62
+ * ```tsx
63
+ * // A single profile with function accessors and an explicit description.
64
+ * <RadarChart
65
+ * data={skills}
66
+ * categoryAccessor={(skill) => skill.label}
67
+ * valueAccessor={(skill) => skill.score}
68
+ * title="Engineering skills profile"
69
+ * description="Scores across six self-assessed engineering skills."
70
+ * pieceStyle={{ fill: "#2563eb", stroke: "#1d4ed8" }}
71
+ * />
72
+ * ```
73
+ */
74
+ export declare const RadarChart: {
75
+ <TDatum extends Datum = Datum>(props: RadarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
76
+ displayName?: string;
77
+ };
@@ -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;
@@ -46,6 +46,12 @@ export interface StackedBarChartProps<TDatum extends Datum = Datum> extends Base
46
46
  legendPosition?: "right" | "left" | "top" | "bottom";
47
47
  tooltip?: TooltipProp;
48
48
  annotations?: Datum[];
49
+ /** Enable a value-axis brush overlay. Also enabled when `linkedBrush` is set. */
50
+ brush?: boolean;
51
+ /** Callback with `{ r: [min, max] }` or null when the brush clears. */
52
+ onBrush?: (extent: {
53
+ r: [number, number];
54
+ } | null) => void;
49
55
  /** Custom formatter for category tick labels */
50
56
  categoryFormat?: CategoryFormatFn;
51
57
  /** Fixed value-axis domain `[min, max]`. Either bound may be `undefined` to leave that side data-derived. Stacked bars auto-extend the value domain to cover the cumulative stack unless `valueExtent` is fully specified. */
@@ -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;
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import type { StyleRule } from "../shared/styleRules";
5
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
7
7
  export interface CollisionSwarmChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "selection">, PhysicsSharedChartProps {
8
8
  data?: TDatum[];
@@ -3,7 +3,7 @@ import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import { type EventDropWindowOptions } from "./physicsChartUtils";
5
5
  import type { StyleRule } from "../shared/styleRules";
6
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
6
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
7
7
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
8
8
  export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "selection">, PhysicsSharedChartProps {
9
9
  data?: TDatum[];
@@ -15,6 +15,8 @@ export interface EventDropChartProps<TDatum extends Datum = Datum> extends Omit<
15
15
  delay?: number;
16
16
  value?: number;
17
17
  } | ((latestEventTime: number) => number);
18
+ /** Recorded watermark for each arrival; later closure changes preserve this decision. */
19
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
18
20
  ballRadius?: number;
19
21
  colorBy?: ChartAccessor<TDatum, string>;
20
22
  /**
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import type { StyleRule } from "../shared/styleRules";
5
- import { type PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
6
6
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type PhysicsSimulationMode, type TooltipProp } from "./physicsHocUtils";
7
7
  import type { ChartMode } from "../shared/types";
8
8
  import { type GaltonBoardReferenceLine } from "./physicsProjectionOverlays";
@@ -46,7 +46,9 @@ export interface GaltonBoardChartProps<TDatum extends Datum = Datum> extends Omi
46
46
  frameProps?: PhysicsHocFrameProps<"config">;
47
47
  }
48
48
  /**
49
- * Physics-backed Galton board chart that drops values through seeded pegs into a settled distribution.
49
+ * Physics-backed distribution drop: values enter preassigned bins and settle into piles.
50
+ * Mechanical mode generates seeded Bernoulli samples before the physical replay;
51
+ * the apparatus does not simulate peg collisions.
50
52
  *
51
53
  * @example
52
54
  * ```tsx
@@ -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;