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
@@ -36,6 +36,17 @@ export declare const AGG_PARTIAL = "__aggPartial";
36
36
  export declare const AGG_COUNT = "count";
37
37
  export declare const AGG_START = "__aggStart";
38
38
  export declare const AGG_END = "__aggEnd";
39
+ /** Materialized row returned by RealtimeLineChart in aggregate mode. */
40
+ export interface AggregatedRealtimeDatum extends Datum {
41
+ time: number;
42
+ value: number;
43
+ count: number;
44
+ __aggPartial: boolean;
45
+ __aggStart: number;
46
+ __aggEnd: number;
47
+ __aggLower?: number;
48
+ __aggUpper?: number;
49
+ }
39
50
  /**
40
51
  * Build a `WindowAccumulator` from a config, parsing duration strings.
41
52
  * Returns `null` when the window width is unparseable, so the caller can
@@ -48,7 +59,7 @@ export declare function createAccumulator(config: AggregateConfig): WindowAccumu
48
59
  * bounds (when a band is configured), and provenance fields (`count`,
49
60
  * partial flag, raw start/end) for tooltips and partial-window styling.
50
61
  */
51
- export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig): Datum[];
62
+ export declare function aggregatedRows(acc: WindowAccumulator, config: AggregateConfig): AggregatedRealtimeDatum[];
52
63
  /** Whether a config requests a band envelope. */
53
64
  export declare function hasBand(config: AggregateConfig): boolean;
54
65
  export type { AggregateStat, AggregateBand, WindowType };
@@ -0,0 +1,4 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { ChartAccessor } from "../shared/types";
3
+ /** Resolve authored numeric values without treating missing cells as zero. */
4
+ export declare function readRealtimeNumber<TDatum extends Datum>(datum: Datum, accessor: ChartAccessor<TDatum, number> | undefined, fallback: string): number | null;
@@ -1,3 +1,4 @@
1
+ import type { RealtimeResponsiveProps } from "./realtimeChartTypes";
1
2
  import * as React from "react";
2
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
3
4
  import type { StreamXYFrameHandle } from "../../stream/types";
@@ -6,15 +7,18 @@ import type { ChartModeInput, ChartModeResult } from "../shared/chartMode";
6
7
  import type { LegendInteractionMode, LegendInteractionState } from "../shared/hooks";
7
8
  import { type SelectionHookResult } from "../shared/selectionUtils";
8
9
  import type { ChartMode, SelectionConfig } from "../shared/types";
9
- interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
10
+ export { readRealtimeNumber } from "./realtimeAccessors";
11
+ interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover">, RealtimeResponsiveProps {
10
12
  mode?: ChartMode;
11
13
  size?: [number, number];
12
14
  enableHover?: unknown;
13
15
  }
14
- export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
15
- export declare function useRealtimeFrameHandle(ref: React.Ref<RealtimeFrameHandle>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
16
+ export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult & RealtimeResponsiveProps;
17
+ export declare function useRealtimeFrameHandle<TDatum extends Datum = Datum>(ref: React.Ref<RealtimeFrameHandle<TDatum>>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
16
18
  export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
17
- export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
19
+ export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult & RealtimeResponsiveProps, legend: LegendInteractionState, mode: LegendInteractionMode | undefined): {
20
+ responsiveWidth: boolean | undefined;
21
+ responsiveHeight: boolean | undefined;
18
22
  title: string | undefined;
19
23
  description: string | undefined;
20
24
  summary: string | undefined;
@@ -24,4 +28,3 @@ export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult,
24
28
  legendHighlightedCategory: string | null;
25
29
  legendIsolatedCategories: Set<string> | undefined;
26
30
  };
27
- export {};
@@ -4,6 +4,13 @@ import type { HoverData } from "../../stream/types";
4
4
  import type { Datum } from "../shared/datumTypes";
5
5
  import type { ChartAccessor } from "../shared/types";
6
6
  import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
7
+ /** Container sizing shared by realtime charts and their static siblings. */
8
+ export interface RealtimeResponsiveProps {
9
+ /** Fit the container width. */
10
+ responsiveWidth?: boolean;
11
+ /** Fit a container with a definite height. */
12
+ responsiveHeight?: boolean;
13
+ }
7
14
  /** Accessibility metadata shared by the streaming chart wrappers. */
8
15
  export interface RealtimeAccessibilityProps {
9
16
  /** Visible chart title and accessible name. */
@@ -0,0 +1,4 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { StyleRuleContext } from "../shared/styleRules";
3
+ /** Resolve the visible aggregate carried by a realtime histogram segment. */
4
+ export declare function makeHistogramRuleContext(): (datum: Datum) => StyleRuleContext;
@@ -1,11 +1,17 @@
1
- import type { Datum } from "../shared/datumTypes";
2
- import type { ChartAccessor } from "../shared/types";
3
- /** Resolve the reversed value domain used by downward temporal histograms. */
4
- export declare function resolveDownwardHistogramExtent<TDatum extends Datum>({ data, valueAccessor, timeAccessor, binSize, valueExtent, extentPadding, }: {
5
- data: readonly TDatum[] | undefined;
6
- valueAccessor: ChartAccessor<TDatum, number> | undefined;
7
- timeAccessor: ChartAccessor<TDatum, number> | undefined;
8
- binSize: number;
9
- valueExtent: [number, number] | undefined;
10
- extentPadding: number | undefined;
11
- }): [number, number] | undefined;
1
+ /** Resolve histogram conveniences into the shared XY axis configuration. */
2
+ export declare function resolveHistogramAxes(props: {
3
+ axes?: import("../../stream/xyFrameAxisTypes").XYFrameAxisConfig[];
4
+ showTimeAxis?: boolean;
5
+ showValueAxis?: boolean;
6
+ }): import("../../stream/xyFrameAxisTypes").XYFrameAxisConfig[];
7
+ export declare function histogramMarginDefaults(defaults: {
8
+ top: number;
9
+ right: number;
10
+ bottom: number;
11
+ left: number;
12
+ }, axes: import("../../stream/xyFrameAxisTypes").XYFrameAxisConfig[], showAxes: boolean, hasTitle?: boolean): {
13
+ left: number;
14
+ bottom: number;
15
+ top: number;
16
+ right: number;
17
+ };
@@ -0,0 +1,9 @@
1
+ import * as React from "react";
2
+ /** Portable default center readout, shared by React and static GaugeChart. */
3
+ export declare function GaugeReadout({ value, min, max, radius, showScaleLabels }: {
4
+ value: React.ReactNode;
5
+ min: number;
6
+ max: number;
7
+ radius: number;
8
+ showScaleLabels: boolean;
9
+ }): React.JSX.Element;
@@ -0,0 +1,18 @@
1
+ import * as React from "react";
2
+ import type { Datum } from "./datumTypes";
3
+ import { type AnnotationLabelBackground } from "./AnnotationLabel";
4
+ /** Shared threshold geometry; callers retain their renderer-specific theme defaults. */
5
+ export declare function ThresholdAnnotation({ ann, position, vertical, width, height, color, fontSize, fontFamily, bold, background, dash, labelGap }: {
6
+ ann: Datum;
7
+ position: number;
8
+ vertical: boolean;
9
+ width: number;
10
+ height: number;
11
+ color: string;
12
+ fontSize?: number;
13
+ fontFamily?: string;
14
+ bold?: boolean;
15
+ background?: AnnotationLabelBackground;
16
+ dash?: string;
17
+ labelGap?: number;
18
+ }): React.JSX.Element;
@@ -0,0 +1,7 @@
1
+ import * as React from "react";
2
+ /** Circle at the top (x threshold) or left (y threshold) plot edge. */
3
+ export interface ThresholdEndCapConfig {
4
+ radius?: number;
5
+ fill?: string;
6
+ }
7
+ export declare function renderThresholdEndCap(config: boolean | "circle" | ThresholdEndCapConfig | undefined, start: [number, number], color: string): React.JSX.Element | null;
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Editorial-status visibility filter, kept free of the rest of the
3
+ * annotation-provenance module so SVG overlays do not pull the AI graph.
4
+ */
5
+ export interface AnnotationStatusVisibility {
6
+ showRetractedAnnotations?: boolean;
7
+ showSupersededAnnotations?: boolean;
8
+ }
9
+ export type StatusFilterable = {
10
+ provenance?: {
11
+ stableId?: string;
12
+ };
13
+ lifecycle?: {
14
+ status?: string;
15
+ supersedes?: string;
16
+ };
17
+ };
18
+ export declare function filterAnnotationsByStatus<T extends StatusFilterable>(annotations: ReadonlyArray<T>, options?: AnnotationStatusVisibility): T[];
@@ -1,11 +1,13 @@
1
1
  import type { A11yFinding } from "./auditAccessibility";
2
+ import type { ChartRecipeFrameFamily } from "../../ai/chartRecipes";
2
3
  import type { Datum } from "./datumTypes";
3
4
  export declare function isNonEmptyString(value: unknown): value is string;
4
5
  /**
5
6
  * Only declared chart props can be credited as rendered accessibility text.
6
- * This keeps the audit aligned with the generated prop schema and validation.
7
+ * Credit schema declarations and the custom wrappers' executable text contract.
8
+ * Recipe metadata alone does not establish support for an unknown renderer.
7
9
  */
8
- export declare function assessAccessibilityText(component: string, props: Datum): {
10
+ export declare function assessAccessibilityText(component: string, props: Datum, recipeFamily?: ChartRecipeFrameFamily): {
9
11
  hasTitle: boolean;
10
12
  hasDescription: boolean;
11
13
  hasSummary: boolean;
@@ -5,7 +5,8 @@
5
5
  * metadata but never React components, frame stores, server renderers, or
6
6
  * docs modules. The implementation, server, capability, and example links
7
7
  * are strings so hosts can decide what to load. Existing registries remain
8
- * authoritative while this seven-chart slice proves the boundary.
8
+ * authoritative while this seven-chart slice proves the boundary; the AI
9
+ * schema generator now consumes this pilot for its seven component entries.
9
10
  */
10
11
  import { type ChartCapabilities, type ChartCategory, type ChartPropSpec, type ChartSpec, type PropType } from "./chartSpecs";
11
12
  /** Version of the definition shape, independently from the package version. */
@@ -120,9 +121,9 @@ export interface ChartDefinition<TChart extends string = string> {
120
121
  */
121
122
  export declare function createChartDefinitionWireSchema(spec: ChartSpec): ChartDefinitionWireSchema;
122
123
  /**
123
- * One representative per chart family. No existing consumer reads this yet;
124
- * its purpose is to make parity and generation work executable before any
125
- * registry is migrated.
124
+ * One representative per chart family. The AI schema projection is the first
125
+ * migrated downstream registry; other consumers remain on their established
126
+ * registries until this boundary has enough evidence to expand.
126
127
  */
127
128
  export declare const CHART_DEFINITION_PILOT: Readonly<{
128
129
  [TChart in ChartDefinitionPilotId]: ChartDefinition<TChart>;
@@ -68,8 +68,8 @@ export interface ChartCapabilities {
68
68
  * pure-synthetic charts (GaugeChart) declare false. */
69
69
  supportsPush: boolean;
70
70
  /** Renders to a static SVG via `renderChart()` from `semiotic/server`
71
- * through a registered entry in `serverChartConfigs.ts`. SSR-only
72
- * charts (none yet) and HOC-SSR exclusions also declare false. */
71
+ * through a registered entry in `serverChartConfigs.ts`. Live push-only
72
+ * charts declare false because no bounded static dataset was supplied. */
73
73
  supportsSSR: boolean;
74
74
  /**
75
75
  * How color is consumed by the chart's data marks.
@@ -0,0 +1,13 @@
1
+ import type { Datum } from "./datumTypes";
2
+ import { type StyleRuleContext } from "./styleRules";
3
+ /**
4
+ * Heatmap rules operate on two distinct public mark shapes:
5
+ *
6
+ * - ordinary cells retain the caller's row and resolve x/y/value accessors;
7
+ * - aggregated cells expose `{ value, count, sum, xCenter, yCenter, agg }`.
8
+ *
9
+ * The default `value` channel deliberately means the displayed aggregate for
10
+ * a derived cell. Callers can still target `count`, `sum`, or `agg` through a
11
+ * declarative `field`, while `axis: "x"|"y"` resolves the bin center.
12
+ */
13
+ export declare function makeHeatmapRuleContext(xAccessor: string | ((d: Datum) => unknown) | undefined, yAccessor: string | ((d: Datum) => unknown) | undefined, valueAccessor: string | ((d: Datum) => unknown) | undefined): (datum: Datum) => StyleRuleContext;
@@ -5,5 +5,5 @@
5
5
  * This compact registry is intentionally separate from validation metadata:
6
6
  * config serialization only needs chart-name membership.
7
7
  */
8
- export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
8
+ export declare const KNOWN_CHART_COMPONENTS: readonly ["BarChart", "StackedBarChart", "GroupedBarChart", "SwarmPlot", "BoxPlot", "Histogram", "ViolinPlot", "RidgelinePlot", "DotPlot", "PieChart", "DonutChart", "GaugeChart", "FunnelChart", "RadarChart", "SwimlaneChart", "LikertChart", "LineChart", "BumpChart", "AreaChart", "DifferenceChart", "StackedAreaChart", "Scatterplot", "BubbleChart", "Heatmap", "QuadrantChart", "MultiAxisLineChart", "WaterfallChart", "CandlestickChart", "ConnectedScatterplot", "ScatterplotMatrix", "MinimapChart", "ForceDirectedGraph", "SankeyDiagram", "ProcessSankey", "ChordDiagram", "TreeDiagram", "Treemap", "CirclePack", "OrbitDiagram", "ChoroplethMap", "ProportionalSymbolMap", "FlowMap", "DistanceCartogram", "RealtimeLineChart", "RealtimeHistogram", "TemporalHistogram", "RealtimeSwarmChart", "RealtimeWaterfallChart", "RealtimeHeatmap", "GaltonBoardChart", "EventDropChart", "UnitPileChart", "CollisionSwarmChart", "GauntletChart", "CrucibleChart", "ProcessFlowChart", "PacketFlowChart", "ChainReactionChart", "BigNumber"];
9
9
  export declare function isKnownChartComponent(componentName: string): boolean;
@@ -1,5 +1,19 @@
1
1
  import type { Datum } from "./datumTypes";
2
+ import type { NetworkMarkStyle } from "../../stream/networkTypes";
2
3
  import type { Accessor } from "./types";
4
+ import type { SelectionHookResult, SelectionStyleConfig } from "./selectionUtils";
5
+ /** Apply shared/legend selection to a network node's raw user datum. */
6
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
7
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
8
+ export declare function wrapNetworkNodeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
9
+ /**
10
+ * Apply shared/legend selection to a network edge. When endpoint nodes are
11
+ * available, either endpoint may keep the edge emphasized; otherwise the
12
+ * predicate falls back to the edge payload.
13
+ */
14
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): undefined;
15
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: (datum: Datum) => NetworkMarkStyle, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (datum: Datum) => NetworkMarkStyle;
16
+ export declare function wrapNetworkEdgeStyleWithSelection(baseStyle: ((datum: Datum) => NetworkMarkStyle) | undefined, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): ((datum: Datum) => NetworkMarkStyle) | undefined;
3
17
  /**
4
18
  * Flatten a hierarchical data structure into an array of all nodes
5
19
  * by recursively traversing children.
@@ -0,0 +1,2 @@
1
+ /** Preserve distinctions on narrow domains while resolving precision once per tick set. */
2
+ export declare function numericTickFormatter(values: number[]): (value: number) => string;
@@ -0,0 +1,10 @@
1
+ import * as React from "react";
2
+ export declare function renderSvgCenterContent(centerContent: React.ReactNode, centerX: number, centerY: number): React.ReactNode | null;
3
+ /** Render SVG centers in an SVG viewport; preserve arbitrary HTML overlays. */
4
+ export declare function RadialCenterContent({ content, centerX, centerY, width, height }: {
5
+ content: React.ReactNode;
6
+ centerX: number;
7
+ centerY: number;
8
+ width: number;
9
+ height: number;
10
+ }): React.JSX.Element;
@@ -75,5 +75,7 @@ export declare const DEFAULT_SELECTION_OPACITY = 0.5;
75
75
  * or group-dependent styling (`fillArea: string[]`, `resolveStroke(d,
76
76
  * group)` in `useXYLineStyle`'s MultiAxisLineChart path) silently
77
77
  * drops to its no-group branch whenever a selection is active.
78
+ * `selectionDatum` adapts authored wrappers such as GeoJSON Features to the
79
+ * direct-field shape published by their interactive marks.
78
80
  */
79
- export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig): (d: Datum, ...args: TArgs) => Datum;
81
+ export declare function wrapStyleWithSelection<TArgs extends unknown[]>(baseStyleFn: (d: Datum, ...args: TArgs) => Datum, selectionHook: SelectionHookResult | null, config?: SelectionStyleConfig, selectionDatum?: (datum: Datum) => Datum): (d: Datum, ...args: TArgs) => Datum;
@@ -60,7 +60,7 @@ export declare function buildDefaultTooltip(fields: TooltipFieldConfig[]): (hove
60
60
  * @param pieData - If true, extracts datum via `d.data?.[0] || d.data || d`
61
61
  * (PieChart/DonutChart wrap data in arrays). Default: `d.data || d`.
62
62
  */
63
- export declare function buildOrdinalTooltip({ categoryAccessor, valueAccessor, groupAccessor, groupLabel, pieData, valueFormat, }: {
63
+ export declare function buildOrdinalTooltip({ categoryAccessor, valueAccessor, groupAccessor, groupLabel, pieData, valueFormat }: {
64
64
  categoryAccessor: TooltipAccessor;
65
65
  valueAccessor: TooltipAccessor;
66
66
  groupAccessor?: TooltipAccessor;
@@ -117,7 +117,8 @@ export interface BaseChartProps {
117
117
  responsiveHeight?: boolean;
118
118
  /**
119
119
  * Maximum canvas backing-store pixel ratio. Defaults to 3 on desktop and 2
120
- * on coarse-pointer/small-screen devices. Canvas chart families repaint
120
+ * on coarse-pointer/small-screen devices. Very large canvases are further
121
+ * capped by a shared backing-store budget. Canvas chart families repaint
121
122
  * automatically when browser zoom or display density changes.
122
123
  */
123
124
  maxDevicePixelRatio?: number;
@@ -230,7 +231,8 @@ export interface AxisConfig {
230
231
  export type CategoryFormatFn = (label: string, index?: number) => string | React.ReactNode;
231
232
  /**
232
233
  * Accessor type - can be a property name or a function
233
- * @deprecated Use DataAccessor from generalTypes for generic type safety
234
+ * @deprecated Use `ChartAccessor<TDatum, TValue>` for typed chart props.
235
+ * This legacy alias remains for compatibility with existing frame code.
234
236
  */
235
237
  export type Accessor<T = DatumValue> = string | ((d: Datum, i?: number) => T);
236
238
  /**
@@ -4,7 +4,8 @@ import type { LegendItem, LegendLayout, LegendValue } from "../../types/legendTy
4
4
  import { type AxisChromeInput } from "../../legendLayout";
5
5
  import type { Datum } from "./datumTypes";
6
6
  /**
7
- * Distinct string-coerced `colorBy` values across `data`, in first-seen order.
7
+ * Distinct non-null, string-coerced `colorBy` values across `data`, in
8
+ * first-seen order.
8
9
  * Shared by chart setup hooks that need the category list for a color scale
9
10
  * or legend before any scale/legend object is built.
10
11
  */
@@ -26,6 +27,10 @@ export interface FrameLegendOverrides {
26
27
  legendLayout?: LegendLayout;
27
28
  /** Any explicit frame margin replaces the HOC-measured margin. */
28
29
  margin?: unknown;
30
+ axes?: ReadonlyArray<{
31
+ orient: "top" | "bottom" | "left" | "right";
32
+ visible?: boolean;
33
+ }>;
29
34
  }
30
35
  /**
31
36
  * Resolve the legend values consumed by layout before a wrapper forwards its
@@ -1,7 +1,7 @@
1
1
  import type { RefObject, MutableRefObject } from "react";
2
2
  import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
3
3
  import type { Datum } from "./datumTypes";
4
- export interface AggregatedRow {
4
+ export interface AggregatedRow extends Datum {
5
5
  __likertCategory: string;
6
6
  /** Stacking key — may be sentinel value for neutral halves */
7
7
  __likertLevel: string;
@@ -11,6 +11,12 @@ export interface AggregatedRow {
11
11
  __likertPct: number;
12
12
  __likertLevelIndex: number;
13
13
  }
14
+ export interface LikertAggregationFieldAliases {
15
+ category?: string;
16
+ level?: string;
17
+ count?: string;
18
+ score?: string;
19
+ }
14
20
  /** Sentinel level names for the neutral split halves */
15
21
  export declare const NEUTRAL_NEG = "__likert_neutral_neg";
16
22
  export declare const NEUTRAL_POS = "__likert_neutral_pos";
@@ -30,7 +36,7 @@ export declare function resolveAccessorFn<T>(accessor: string | ((d: Datum) => T
30
36
  * Interpolates from red → gray → blue for odd, red → blue for even.
31
37
  */
32
38
  export declare function defaultDivergingScheme(n: number, themeDivergingSchemeName?: string): string[];
33
- export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null): AggregatedRow[];
39
+ export declare function aggregateData(data: Datum[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null, fieldAliases?: LikertAggregationFieldAliases): AggregatedRow[];
34
40
  export declare function toDivergingValues(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
35
41
  export declare function orderForDiverging(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
36
42
  interface UseLikertAggregationConfig {
@@ -6,6 +6,7 @@ import type { OnObservationCallback } from "../../store/ObservationStore";
6
6
  import type { PartialMargin, MarginType } from "../../types/marginType";
7
7
  import { useChartSelection, useChartLegendAndMargin } from "./hooks";
8
8
  import type { FrameLegendOverrides, LegendInteractionMode, LegendPosition, LegendInteractionState } from "./hooks";
9
+ import type { SelectionHookResult } from "./selectionUtils";
9
10
  export interface NetworkChartSetupInput<TNode extends Datum = Datum, TEdge extends Datum = Datum> {
10
11
  /** Raw `nodes` prop (may be undefined). */
11
12
  nodes: TNode[] | undefined;
@@ -94,7 +95,7 @@ export interface NetworkChartSetupResult {
94
95
  */
95
96
  effectivePalette: string[];
96
97
  themeCategorical: string[] | undefined;
97
- /** Distinct category values from `(safeNodes, colorBy)`, for legend interaction. */
98
+ /** Distinct category values from bounded data or the live push-mode frame. */
98
99
  allCategories: string[];
99
100
  legendState: LegendInteractionState;
100
101
  legend: ReturnType<typeof useChartLegendAndMargin>["legend"];
@@ -108,13 +109,16 @@ export interface NetworkChartSetupResult {
108
109
  /**
109
110
  * The full selection-hook output. Most network HOCs only need the
110
111
  * resolved hover/click behaviors above, but hierarchy charts
111
- * (Treemap, CirclePack, TreeDiagram, OrbitDiagram) wrap node styles
112
- * with selection state via `activeSelectionHook.isActive` /
113
- * `.predicate`. Passed through verbatim so those charts don't need
114
- * a parallel `useChartSelection` call.
112
+ * Custom network layouts can consume the underlying shared selection
113
+ * directly. Built-in charts normally use `effectiveSelectionHook`, which
114
+ * also includes hover and legend interaction.
115
115
  */
116
116
  activeSelectionHook: ReturnType<typeof useChartSelection>["activeSelectionHook"];
117
117
  hoverSelectionHook: ReturnType<typeof useChartSelection>["hoverSelectionHook"];
118
+ /** Hover, legend, or shared selection in precedence order. */
119
+ effectiveSelectionHook: SelectionHookResult | null;
120
+ /** Selection styling with the active theme's default dim opacity. */
121
+ resolvedSelection: SelectionConfig | undefined;
118
122
  crosshairSourceId: ReturnType<typeof useChartSelection>["crosshairSourceId"];
119
123
  /** When non-null, render this element instead of the chart. */
120
124
  loadingEl: ReactElement | null;
@@ -86,7 +86,7 @@ export interface OrdinalPieceStyleOptions {
86
86
  * (typically the chart's `valueAccessor` output). Lets `{ when: { gt: 10 } }`
87
87
  * work with no `field` on the threshold.
88
88
  */
89
- resolveRuleValue?: (d: Datum) => number | undefined;
89
+ resolveRuleValue?: (d: Datum, category?: string) => number | undefined;
90
90
  }
91
91
  /**
92
92
  * Build a memoized `pieceStyle` function that the chart can pass
@@ -0,0 +1,24 @@
1
+ import type { ChartAccessor, LinkedBrushProp } from "./types";
2
+ import type { Datum } from "./datumTypes";
3
+ export type XYBrushExtent = {
4
+ x: [number, number];
5
+ y: [number, number];
6
+ };
7
+ export interface XYBrushInput<TDatum extends Datum = Datum> {
8
+ brush?: boolean;
9
+ onBrush?: (extent: XYBrushExtent | null) => void;
10
+ linkedBrush?: LinkedBrushProp;
11
+ xAccessor?: ChartAccessor<TDatum, unknown>;
12
+ yAccessor?: ChartAccessor<TDatum, unknown>;
13
+ /** Default brush dimension when `brush` is true without a linked config. */
14
+ defaultDimension?: "x" | "y" | "xy";
15
+ }
16
+ export interface XYBrushResult {
17
+ brushStreamProps: {
18
+ brush: {
19
+ dimension: "x" | "y" | "xy";
20
+ };
21
+ onBrush: (extent: XYBrushExtent | null) => void;
22
+ } | Record<string, never>;
23
+ }
24
+ export declare function useXYBrush<TDatum extends Datum = Datum>({ brush, onBrush: onBrushProp, linkedBrush, xAccessor, yAccessor, defaultDimension, }: XYBrushInput<TDatum>): XYBrushResult;
@@ -70,6 +70,8 @@ export interface XYPointStyleOptions {
70
70
  * Same hook BarChart's `parentLine` cascade uses.
71
71
  */
72
72
  colorDatumAccessor?: (d: Datum) => Datum;
73
+ /** Adapt selection metadata without changing the point used for styling. */
74
+ selectionDatumAccessor?: (d: Datum) => Datum;
73
75
  }
74
76
  /**
75
77
  * Build a memoized `pointStyle` function for an XY HOC.
@@ -85,6 +85,13 @@ export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChar
85
85
  * @default true
86
86
  */
87
87
  enableHover?: boolean;
88
+ /** Enable an xy brush overlay. Also enabled when `linkedBrush` is set. */
89
+ brush?: boolean;
90
+ /** Callback with `{ x, y }` extents, or null when the brush clears. */
91
+ onBrush?: (extent: {
92
+ x: [number, number];
93
+ y: [number, number];
94
+ } | null) => void;
88
95
  /**
89
96
  * Show grid lines
90
97
  * @default false
@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
5
5
  import type { CandlestickStyle } from "../../stream/types";
6
6
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
7
7
  import { type TooltipProp } from "../../Tooltip/Tooltip";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  export interface CandlestickChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
9
10
  data?: TDatum[];
10
11
  xAccessor?: ChartAccessor<TDatum, number>;
@@ -17,6 +18,12 @@ export interface CandlestickChartProps<TDatum extends Datum = Datum> extends Bas
17
18
  /** Optional — see openAccessor */
18
19
  closeAccessor?: ChartAccessor<TDatum, number>;
19
20
  candlestickStyle?: CandlestickStyle;
21
+ /**
22
+ * Declarative, threshold-aware candle styling. `ctx.y`/`ctx.value` is close
23
+ * in OHLC mode and high in range mode. A rule `fill` recolors the body
24
+ * (or the range wick/dots); `stroke` recolors the wick.
25
+ */
26
+ styleRules?: StyleRule[];
20
27
  tooltip?: TooltipProp;
21
28
  annotations?: Datum[];
22
29
  /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
@@ -6,6 +6,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
6
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
7
7
  import { type TooltipProp } from "../../Tooltip/Tooltip";
8
8
  import { type GradientInput } from "../shared/gradient";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  export { computeDifferenceSegments } from "./differenceSegments";
10
11
  /**
11
12
  * DifferenceChart props
@@ -41,6 +42,12 @@ export interface DifferenceChartProps<TDatum extends Datum = Datum> extends Base
41
42
  areaOpacity?: number;
42
43
  /** Gradient fill from each segment's tip (offset 0) to its base (offset 1). */
43
44
  gradientFill?: GradientInput;
45
+ /**
46
+ * Declarative, threshold-aware fill/line styling. `ctx.y` is the plotted
47
+ * upper boundary (`__y`); `category` is `"A"` or `"B"`. Field thresholds
48
+ * see the original source row.
49
+ */
50
+ styleRules?: StyleRule[];
44
51
  /** Enable hover annotations. */
45
52
  enableHover?: boolean;
46
53
  /** Show grid lines. Default `false`. */
@@ -6,6 +6,7 @@ import type { GradientLegendValue } from "../../types/legendTypes";
6
6
  import type { LegendInteractionMode } from "../shared/hooks";
7
7
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
8
8
  import { type TooltipProp } from "../../Tooltip/Tooltip";
9
+ import { type StyleRule } from "../shared/styleRules";
9
10
  /**
10
11
  * Heatmap component props
11
12
  */
@@ -117,6 +118,21 @@ export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartPro
117
118
  * Annotation objects to render on the chart
118
119
  */
119
120
  annotations?: Datum[];
121
+ /**
122
+ * Bin continuous x/y into a grid (`count` / `sum` / `mean`). Dense numeric
123
+ * heatmaps (more than 4096 distinct cells) auto-bin even when this is omitted.
124
+ */
125
+ heatmapAggregation?: "count" | "sum" | "mean";
126
+ /** Number of x bins when aggregating. @default 20 */
127
+ heatmapXBins?: number;
128
+ /** Number of y bins when aggregating. @default 20 */
129
+ heatmapYBins?: number;
130
+ /**
131
+ * Ordered data-aware cell styling. Aggregated cells expose `value`, `count`,
132
+ * `sum`, `xCenter`, `yCenter`, and `agg`; the default rule value is the
133
+ * displayed aggregate and x/y channels are bin centers.
134
+ */
135
+ styleRules?: StyleRule[];
120
136
  /** Fixed x domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
121
137
  xExtent?: [number | undefined, number | undefined] | [number];
122
138
  /** Fixed y domain `[min, max]` (either bound may be undefined to leave that side data-derived). */
@@ -130,6 +130,15 @@ export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartP
130
130
  * @default true
131
131
  */
132
132
  enableHover?: boolean;
133
+ /**
134
+ * Enable an x-axis brush overlay. Also enabled when `linkedBrush` is set.
135
+ */
136
+ brush?: boolean;
137
+ /** Callback with `{ x, y }` extents, or null when the brush clears. */
138
+ onBrush?: (extent: {
139
+ x: [number, number];
140
+ y: [number, number];
141
+ } | null) => void;
133
142
  /**
134
143
  * Show grid lines
135
144
  * @default false
@@ -1,6 +1,7 @@
1
1
  import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
3
  import type { StreamXYFrameProps } from "../../stream/types";
4
+ import { type StyleRule } from "../shared/styleRules";
4
5
  import type { LegendPosition } from "../shared/hooks";
5
6
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
7
  import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -42,6 +43,12 @@ export interface MinimapChartProps<TDatum extends Datum = Datum> extends Omit<Ba
42
43
  curve?: "linear" | "monotoneX" | "monotoneY" | "step" | "stepAfter" | "stepBefore" | "basis" | "cardinal" | "catmullRom";
43
44
  /** Line stroke width (default: 2) */
44
45
  lineWidth?: number;
46
+ /**
47
+ * Declarative, threshold-aware line styling. Applied to the detail view
48
+ * and the default overview. Per-series against the first point, same as
49
+ * LineChart. `minimap.lineStyle` still wins on the overview.
50
+ */
51
+ styleRules?: StyleRule[];
45
52
  /** Fill area under lines */
46
53
  fillArea?: boolean;
47
54
  /** Area opacity when fillArea is true (default: 0.3) */
@@ -5,6 +5,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
5
5
  import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
6
  import { type TooltipProp } from "../../Tooltip/Tooltip";
7
7
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
+ import { type StyleRule } from "../shared/styleRules";
8
9
  /**
9
10
  * Configuration for a single series in a MultiAxisLineChart.
10
11
  */
@@ -40,6 +41,12 @@ export interface MultiAxisLineChartProps<TDatum extends Datum = Datum> extends B
40
41
  curve?: CurveType;
41
42
  /** Line width in pixels @default 2 */
42
43
  lineWidth?: number;
44
+ /**
45
+ * Declarative, threshold-aware line styling. Rules resolve per series against
46
+ * the original y (not the unitized display scale), so `{ axis: "y", gt: 10 }`
47
+ * matches the authored metric. Last applicable rule wins per property.
48
+ */
49
+ styleRules?: StyleRule[];
43
50
  /** Show legend @default true */
44
51
  showLegend?: boolean;
45
52
  /** Show grid lines @default false */