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
@@ -4,6 +4,7 @@ import { type CapacityQueueSnapshot } from "../../stream/physics/PhysicsControll
4
4
  import type { ProcessChromeOptions } from "../../recipes/processChrome";
5
5
  import type { Datum } from "../shared/datumTypes";
6
6
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
7
+ import type { StyleRule } from "../shared/styleRules";
7
8
  import { type ProcessFlowProjectionMetadata, type ProcessFlowStageDef } from "./physicsChartUtils";
8
9
  import { type PhysicsFrameHandle } from "./physicsHocHandle";
9
10
  import { type PhysicsHocFrameProps, type PhysicsRerunMS, type PhysicsSharedChartProps, type TooltipProp } from "./physicsHocUtils";
@@ -20,6 +21,11 @@ export interface ProcessFlowChartProps<TDatum extends Datum = Datum> extends Omi
20
21
  radiusAccessor?: ChartAccessor<TDatum, number>;
21
22
  ballRadius?: number;
22
23
  colorBy?: ChartAccessor<TDatum, string>;
24
+ /**
25
+ * Declarative, threshold-aware body styling. `ctx.value` is `workAccessor`
26
+ * when set. Last applicable rule wins per property.
27
+ */
28
+ styleRules?: StyleRule[];
23
29
  seed?: number;
24
30
  route?: "horizontal";
25
31
  groupCompletion?: "allAbsorbed" | "none";
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { Datum } from "../shared/datumTypes";
3
3
  import type { BaseChartProps, ChartAccessor, ChartMode } 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
  export interface UnitPileChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "margin" | "mode" | "selection">, PhysicsSharedChartProps {
8
8
  data?: TDatum[];
@@ -17,6 +17,7 @@ export interface UnitPileChartProps<TDatum extends Datum = Datum> extends Omit<B
17
17
  simulationMode?: PhysicsSimulationMode;
18
18
  mechanicalCount?: number;
19
19
  mechanicalCategories?: readonly string[];
20
+ /** Quantity per full circle; a record's remainder uses proportional area. */
20
21
  unitValue?: number;
21
22
  ballRadius?: number;
22
23
  colorBy?: ChartAccessor<TDatum, string>;
@@ -2,6 +2,7 @@ import type { Datum } from "../shared/datumTypes";
2
2
  import type { TooltipProp } from "../../Tooltip/Tooltip";
3
3
  import type { AccessibleTableProp } from "../../stream/accessibleTableTypes";
4
4
  import type { BlockerAmplification, DependencyAccessor, DependencyTaskStatus } from "./dependencyMachine";
5
+ import type { PhysicsSimulationStateChange } from "./physicsHocUtils";
5
6
  export type ChainReactionMode = "snapshot" | "replay" | "mechanical";
6
7
  export type ChainReactionInsight = "none" | "blocker-amplification";
7
8
  export type ChainReactionControl = "play" | "pause" | "step" | "reset" | "settle";
@@ -85,6 +86,8 @@ export interface ChainReactionChartProps<TDatum extends Datum = Datum> {
85
86
  selectedTaskIDs?: readonly string[];
86
87
  onSelectionChange?: (ids: string[]) => void;
87
88
  onObservation?: (event: ChainReactionObservation<TDatum>) => void;
89
+ /** Observe the underlying physics pipeline entering running/settled states. */
90
+ onSimulationStateChange?: PhysicsSimulationStateChange;
88
91
  reducedMotion?: "settle";
89
92
  seed?: number;
90
93
  width?: number;
@@ -0,0 +1,14 @@
1
+ interface SwarmPoint {
2
+ x: number;
3
+ radius: number;
4
+ }
5
+ /**
6
+ * Find readable vertical targets without changing quantitative x or radius.
7
+ * If this greedy packing cannot fit, disclose overlap and retain every mark.
8
+ */
9
+ export declare function packSwarmLane(points: readonly SwarmPoint[], top: number, bottom: number, random: () => number): {
10
+ positions: number[];
11
+ overlapping: boolean;
12
+ entryOffset: number;
13
+ };
14
+ export {};
@@ -21,6 +21,7 @@ export interface CollisionSwarmProjectionMetadata {
21
21
  label: string;
22
22
  y: number;
23
23
  count: number;
24
+ overlapping?: boolean;
24
25
  }>;
25
26
  plot: PhysicsChartArea["plot"];
26
27
  }
@@ -0,0 +1,32 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import type { ChartAccessor } from "../shared/types";
3
+ export interface EventDropAdmissionOptions<TDatum extends Datum = Datum> {
4
+ data: readonly TDatum[];
5
+ timeAccessor: ChartAccessor<TDatum, number>;
6
+ arrivalAccessor: ChartAccessor<TDatum, number>;
7
+ windowSize: number;
8
+ watermark?: {
9
+ delay?: number;
10
+ value?: number;
11
+ } | ((latestEventTime: number) => number);
12
+ /** Recorded admission thresholds; independent of the current closure watermark. */
13
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
14
+ }
15
+ /**
16
+ * Replay admissions in arrival order. Equal arrival times retain source order.
17
+ * A delay/function watermark advances monotonically with the greatest event
18
+ * time seen so far. An explicit value describes one fixed admission policy.
19
+ * Recorded per-event thresholds take precedence over either policy, so later
20
+ * watermark advances cannot relabel previously accepted events.
21
+ */
22
+ export declare function resolveEventDropAdmissions<TDatum extends Datum>(options: EventDropAdmissionOptions<TDatum>): {
23
+ events: {
24
+ datum: TDatum;
25
+ index: number;
26
+ eventTime: number;
27
+ arrivalTime: number;
28
+ watermarkAtArrival: number;
29
+ late: boolean;
30
+ }[];
31
+ watermarkValue: number;
32
+ };
@@ -28,6 +28,10 @@ export interface EventDropProjectionMetadata {
28
28
  lidSegments: EventDropLidSegment[];
29
29
  plot: PhysicsChartArea["plot"];
30
30
  windowPlot: EventDropPlotRegion;
31
+ /** Visible wall rectangles, derived from the collision geometry (top-left coordinates). */
32
+ windowWalls?: Array<EventDropPlotRegion & {
33
+ id: string;
34
+ }>;
31
35
  watermarkValue: number;
32
36
  windowCount: number;
33
37
  windowSize: number;
@@ -42,6 +46,7 @@ export interface EventDropPhysicsOptions<TDatum extends Datum = Datum> {
42
46
  delay?: number;
43
47
  value?: number;
44
48
  } | ((latestEventTime: number) => number);
49
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
45
50
  ballRadius: number;
46
51
  seed: number;
47
52
  size: [number, number];
@@ -49,16 +54,32 @@ export interface EventDropPhysicsOptions<TDatum extends Datum = Datum> {
49
54
  timeScale?: number;
50
55
  }
51
56
  export declare function buildEventDropPhysics<TDatum extends Datum>(options: EventDropPhysicsOptions<TDatum>): PhysicsChartLayout;
57
+ /**
58
+ * Classify body centers using the matching board geometry, independently of
59
+ * source admission labels. Occupants can still be moving. Only supplied,
60
+ * materialized bodies are counted; queued arrivals are not included.
61
+ */
62
+ export declare function readEventDropOccupancy(metadata: EventDropProjectionMetadata, bodies: readonly {
63
+ x: number;
64
+ y: number;
65
+ }[]): {
66
+ accepted: number[];
67
+ late: number;
68
+ inFlight: number;
69
+ total: number;
70
+ };
52
71
  /**
53
72
  * Place a single event onto an already-mounted EventDropChart using the live
54
73
  * board's domain (window layout + current watermark) so a pushed arrival drops
55
74
  * over its true event-time x instead of the center of a one-event mini-domain.
56
- * Closed-window lids then decide whether physics sends it to the gutter.
75
+ * Closed-window lids divert new arrivals. Recorded history that the current
76
+ * board cannot admit starts inside its destination container.
57
77
  * Returns null when the datum carries no finite event time. Omits `spawnAt` so
58
78
  * the store drops it now.
59
79
  */
60
80
  export declare function placeEventDropSpawn<TDatum extends Datum>(datum: TDatum, index: number, metadata: EventDropProjectionMetadata, options: {
61
81
  timeAccessor: ChartAccessor<TDatum, number>;
62
82
  arrivalAccessor: ChartAccessor<TDatum, number>;
83
+ watermarkAtArrivalAccessor?: ChartAccessor<TDatum, number>;
63
84
  ballRadius: number;
64
85
  }): PhysicsQueuedSpawn | null;
@@ -1,3 +1,5 @@
1
+ export { generateGaltonMechanicalSamples } from "./physicsGaltonData";
2
+ export type { GaltonMechanicalSampleOptions } from "./physicsGaltonData";
1
3
  import type { Datum } from "../shared/datumTypes";
2
4
  import type { ChartAccessor } from "../shared/types";
3
5
  import { type PhysicsChartArea, type PhysicsChartLayout } from "./physicsChartShared";
@@ -16,13 +18,4 @@ export interface GaltonBoardProjectionMetadata {
16
18
  plot: PhysicsChartArea["plot"];
17
19
  valueExtent: [number, number];
18
20
  }
19
- export interface GaltonMechanicalSampleOptions {
20
- bins: number;
21
- count?: number;
22
- pegRows?: number;
23
- branchProbability?: number;
24
- seed?: number;
25
- idPrefix?: string;
26
- }
27
- export declare function generateGaltonMechanicalSamples(options: GaltonMechanicalSampleOptions): Datum[];
28
21
  export declare function buildGaltonBoardPhysics<TDatum extends Datum>(options: GaltonBoardPhysicsOptions<TDatum>): PhysicsChartLayout;
@@ -10,6 +10,7 @@ export { CORE_KIND, POSITIVE_KIND, NEGATIVE_KIND } from "./gauntletTypes";
10
10
  export type { GauntletAccessors, GauntletBodyDatum, GauntletCoreBodyFn, GauntletEffect, GauntletEvent, GauntletEventContext, GauntletEventLogItem, GauntletGate, GauntletLayout, GauntletNegativeReplacementOptions, GauntletPopSpec, GauntletProjectPlacement, GauntletProjectPlacementFn, GauntletProjectState, GauntletPropertyDefinition, GauntletPropertyForceContext, GauntletPropertyWorkPlan, GauntletPropertyWorkPlanOptions, GauntletViabilityFn } from "./gauntletTypes";
11
11
  export declare const DEFAULT_WIDTH = 900;
12
12
  export declare const DEFAULT_HEIGHT = 520;
13
+ export declare const EMPTY_GAUNTLET_PROPERTIES: readonly GauntletPropertyDefinition[];
13
14
  export declare function gauntletWallColliders(layout: Pick<GauntletLayout, "width" | "floorY"> & Partial<Pick<GauntletLayout, "height">>): NonNullable<PhysicsPipelineConfig["colliders"]>;
14
15
  export declare function readAccessor<TDatum extends Datum, TValue>(datum: TDatum, index: number, accessor: ChartAccessor<TDatum, TValue> | undefined, fallback: TValue): TValue;
15
16
  export declare function propertyLabel(property: GauntletPropertyDefinition | undefined): string;
@@ -0,0 +1,4 @@
1
+ import type { PhysicsPipelineSnapshot } from "../../stream/physics/PhysicsPipelineStore";
2
+ import type { PhysicsChartLayout } from "./physicsChartShared";
3
+ /** Recompile geometry without replaying bodies whose placement is unchanged. */
4
+ export declare function reconcilePhysicsChart(snapshot: PhysicsPipelineSnapshot, previous: PhysicsChartLayout, next: PhysicsChartLayout, paceNewBodies?: boolean): PhysicsPipelineSnapshot;
@@ -7,7 +7,7 @@ export { projectionRowsToSemanticItems, physicsChartArea, hashStringColor, compo
7
7
  export type { GaltonBoardPhysicsOptions, GaltonBoardProjectionMetadata, GaltonMechanicalSampleOptions } from "./galtonBoardPhysics";
8
8
  export { generateGaltonMechanicalSamples, buildGaltonBoardPhysics } from "./galtonBoardPhysics";
9
9
  export type { EventDropWindowOptions, EventDropPlotRegion, EventDropLidSegment, EventDropProjectionMetadata, EventDropPhysicsOptions } from "./eventDropPhysics";
10
- export { buildEventDropPhysics, placeEventDropSpawn } from "./eventDropPhysics";
10
+ export { buildEventDropPhysics, readEventDropOccupancy, placeEventDropSpawn } from "./eventDropPhysics";
11
11
  export type { PhysicsPileMechanicalSampleOptions, PhysicsPileOptions, PileTubeGeometry } from "./physicsPilePhysics";
12
12
  export { generatePhysicsPileMechanicalSamples, pileTubeGeometry, buildPhysicsPile } from "./physicsPilePhysics";
13
13
  export type { CollisionSwarmPhysicsOptions, CollisionSwarmProjectionMetadata } from "./collisionSwarmPhysics";
@@ -0,0 +1,10 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ export interface GaltonMechanicalSampleOptions {
3
+ bins: number;
4
+ count?: number;
5
+ pegRows?: number;
6
+ branchProbability?: number;
7
+ seed?: number;
8
+ idPrefix?: string;
9
+ }
10
+ export declare function generateGaltonMechanicalSamples(options: GaltonMechanicalSampleOptions): Datum[];
@@ -20,6 +20,8 @@ export interface PhysicsDatumSpawnResult {
20
20
  }
21
21
  export interface UsePhysicsHocHandleOptions {
22
22
  frameRef: RefObject<StreamPhysicsFrameHandle | null>;
23
+ /** An explicit empty input is authoritative, even through saved handles. */
24
+ staticEmpty?: boolean;
23
25
  /**
24
26
  * Turn one user row into one or more physics body spawns. Called for
25
27
  * push / pushMany / update — never for initial static layout (that path
@@ -27,7 +27,13 @@ export type PhysicsSharedChartProps = {
27
27
  selection?: PhysicsChartSelection;
28
28
  /** Emit hover into the shared selection store for cross-chart highlighting. */
29
29
  linkedHover?: LinkedHoverProp;
30
+ /**
31
+ * Observe the physics pipeline entering or leaving its running/settled
32
+ * states. This composes with chart-owned observation and rerun behavior.
33
+ */
34
+ onSimulationStateChange?: PhysicsSimulationStateChange;
30
35
  };
36
+ export type PhysicsSimulationStateChange = NonNullable<NonNullable<NonNullable<StreamPhysicsFrameProps["config"]>["observation"]>["onSimulationStateChange"]>;
31
37
  /**
32
38
  * What a physics HOC's `selection` prop accepts.
33
39
  *
@@ -71,7 +77,7 @@ export type PhysicsRerunMS = number | null;
71
77
  * Remounting is intentional: it replays the chart's deterministic seed,
72
78
  * initial bodies, and spawn pacing instead of trying to reverse a live store.
73
79
  */
74
- export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void): {
80
+ export declare function usePhysicsRerun(config: StreamPhysicsFrameProps["config"], rerunMS: PhysicsRerunMS | undefined, paused: boolean | undefined, onRerun?: () => void, externalStateChange?: PhysicsSimulationStateChange): {
75
81
  config: StreamPhysicsFrameProps["config"];
76
82
  rerunKey: number;
77
83
  };
@@ -0,0 +1,11 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ export interface PhysicsPileMechanicalSampleOptions {
3
+ categories?: readonly string[];
4
+ count?: number;
5
+ idPrefix?: string;
6
+ seed?: number;
7
+ unitValue?: number;
8
+ }
9
+ export declare function generatePhysicsPileMechanicalSamples(options?: PhysicsPileMechanicalSampleOptions): Datum[];
10
+ /** Full units plus one partial circle per positive record, without float slivers. */
11
+ export declare function physicsPileUnitCount(value: number, unitValue: number): number;
@@ -1,13 +1,8 @@
1
+ export { generatePhysicsPileMechanicalSamples } from "./physicsPileData";
2
+ export type { PhysicsPileMechanicalSampleOptions } from "./physicsPileData";
1
3
  import type { Datum } from "../shared/datumTypes";
2
4
  import type { ChartAccessor } from "../shared/types";
3
5
  import { type PhysicsChartLayout } from "./physicsChartShared";
4
- export interface PhysicsPileMechanicalSampleOptions {
5
- categories?: readonly string[];
6
- count?: number;
7
- idPrefix?: string;
8
- seed?: number;
9
- unitValue?: number;
10
- }
11
6
  export interface PhysicsPileOptions<TDatum extends Datum = Datum> {
12
7
  data: readonly TDatum[];
13
8
  categoryAccessor: ChartAccessor<TDatum, string>;
@@ -17,7 +12,6 @@ export interface PhysicsPileOptions<TDatum extends Datum = Datum> {
17
12
  seed: number;
18
13
  size: [number, number];
19
14
  }
20
- export declare function generatePhysicsPileMechanicalSamples(options?: PhysicsPileMechanicalSampleOptions): Datum[];
21
15
  export interface PileTubeGeometry {
22
16
  laneWidth: number;
23
17
  tubeWidth: number;
@@ -27,10 +21,9 @@ export interface PileTubeGeometry {
27
21
  pileHeight: (count: number) => number;
28
22
  }
29
23
  /**
30
- * Column geometry shared by the pile builder and its projection overlay so the
31
- * ghost bar's height is exactly the fill target the stacked units rise to reach.
32
- * Units drop into a narrow tube (a few balls wide) so their count reads as
33
- * height — a bar chart assembled from falling units, not a spreading heap.
24
+ * Column geometry shared by the pile builder and its approximate stacking
25
+ * guide. Packing and fractional radii affect physical height; the projection
26
+ * labels report source totals independently of the pile's height.
34
27
  */
35
28
  export declare function pileTubeGeometry(plot: {
36
29
  x: number;
@@ -19,6 +19,6 @@ export interface GaltonBoardReferenceLine {
19
19
  }
20
20
  export declare function galtonBoardOverlay(rows: ValueProjectionRow[], bins: number, enabled: boolean | undefined, metadata: GaltonBoardProjectionMetadata | undefined, referenceLines: GaltonBoardReferenceLine | GaltonBoardReferenceLine[] | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
21
21
  export declare function eventDropOverlay(rows: EventProjectionRow[], metadata: EventDropProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
22
- export declare function pileProjectionOverlay(rows: ValueProjectionRow[], ballRadius: number, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
22
+ export declare function pileProjectionOverlay(rows: ValueProjectionRow[], ballRadius: number, enabled: boolean | undefined, unitValue?: number): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
23
23
  export declare function collisionSwarmProjectionOverlay(metadata: CollisionSwarmProjectionMetadata | undefined, enabled: boolean | undefined): StreamPhysicsFrameProps["foregroundGraphics"] | undefined;
24
24
  export {};
@@ -0,0 +1,8 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ /** Assign stable source IDs consistently in React and server builders. */
3
+ export interface PhysicsSourceState<T extends Datum> {
4
+ seed: readonly T[];
5
+ rows: T[];
6
+ nextId: number;
7
+ }
8
+ export declare function createPhysicsSourceState<T extends Datum>(seed: readonly T[], prefix: string, nextId?: number): PhysicsSourceState<T>;
@@ -0,0 +1,19 @@
1
+ import type { Ref, RefObject } from "react";
2
+ import type { Datum } from "../shared/datumTypes";
3
+ import type { StreamPhysicsFrameHandle } from "../../stream/physics/StreamPhysicsTypes";
4
+ import type { PhysicsFrameHandle } from "./physicsHocHandle";
5
+ import type { PhysicsChartLayout } from "./physicsChartShared";
6
+ /**
7
+ * Source records own both the compiled scene and its projection. Imperative
8
+ * edits use the same compiler as data/encoding prop changes, with stable IDs.
9
+ */
10
+ export declare function usePhysicsChartData<T extends Datum>(options: {
11
+ ref: Ref<PhysicsFrameHandle> | undefined;
12
+ frameRef: RefObject<StreamPhysicsFrameHandle | null>;
13
+ data?: readonly T[];
14
+ idPrefix: string;
15
+ buildLayout: (rows: T[]) => PhysicsChartLayout;
16
+ }): {
17
+ layout: PhysicsChartLayout;
18
+ resetSeed: () => void;
19
+ };
@@ -11,7 +11,12 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
16
+ /** Fit the container width. */
17
+ responsiveWidth?: boolean;
18
+ /** Fit a container with a definite height. */
19
+ responsiveHeight?: boolean;
15
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
21
  mode?: ChartMode;
17
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -26,7 +31,7 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
26
31
  width?: number;
27
32
  /** Chart height (alternative to size) */
28
33
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
34
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
35
  maxDevicePixelRatio?: number;
31
36
  /** Chart margins */
32
37
  margin?: PartialMargin;
@@ -66,6 +71,11 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
66
71
  customColorScale?: (value: number) => string;
67
72
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
68
73
  cursor?: CSSProperties["cursor"];
74
+ /**
75
+ * Ordered styling for displayed aggregate cells. Rule `value` is the chosen
76
+ * aggregate; `count`, `sum`, `xCenter`, `yCenter`, and `agg` are fields.
77
+ */
78
+ styleRules?: StyleRule[];
69
79
  /** Show canvas-drawn axes */
70
80
  showAxes?: boolean;
71
81
  /** Background fill color */
@@ -158,6 +168,9 @@ export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> extends Real
158
168
  * ```
159
169
  */
160
170
  export declare const RealtimeHeatmap: {
171
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
161
172
  <TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
173
+ /** Typed refs retain the authored row through mutation and readback. */
174
+ <TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
162
175
  displayName?: string;
163
176
  };
@@ -3,7 +3,7 @@ import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, Annotat
3
3
  import type { RealtimeFrameHandle } from "../../realtime/types";
4
4
  import type { CSSProperties, ReactNode } from "react";
5
5
  import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
6
- import type { ChartMode, ChartAccessor, SelectionConfig, MobileInteractionProp } from "../shared/types";
6
+ import type { ChartMode, ChartAccessor, SelectionConfig, LinkedHoverProp, MobileInteractionProp } from "../shared/types";
7
7
  import type { OnObservationCallback } from "../../store/ObservationStore";
8
8
  import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
@@ -11,9 +11,15 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { LegendValue } from "../../types/legendTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import type { XYFrameAxisConfig } from "../../stream/xyFrameAxisTypes";
14
15
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
16
+ import { type StyleRule } from "../shared/styleRules";
15
17
  export type RealtimeHistogramDirection = "up" | "down";
16
18
  export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
19
+ /** Fit the container width. */
20
+ responsiveWidth?: boolean;
21
+ /** Fit a container with a definite height. */
22
+ responsiveHeight?: boolean;
17
23
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
18
24
  mode?: ChartMode;
19
25
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -30,7 +36,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
30
36
  width?: number;
31
37
  /** Chart height (alternative to size) */
32
38
  height?: number;
33
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
39
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
34
40
  maxDevicePixelRatio?: number;
35
41
  /** Chart margins */
36
42
  margin?: PartialMargin;
@@ -84,10 +90,21 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
84
90
  opacity?: number;
85
91
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
86
92
  cursor?: CSSProperties["cursor"];
93
+ /**
94
+ * Ordered styling for displayed bins. Rule `value` is `categoryValue` for a
95
+ * stacked segment or `total` for an unstacked bin; `x` is the bin center.
96
+ */
97
+ styleRules?: StyleRule[];
87
98
  /** Gap between bars in pixels */
88
99
  gap?: number;
89
- /** Show canvas-drawn axes */
100
+ /** Show axis baselines, ticks, and labels */
90
101
  showAxes?: boolean;
102
+ /** Show the temporal axis; hidden axes reserve no default margin. */
103
+ showTimeAxis?: boolean;
104
+ /** Show the value axis; hidden axes reserve no default margin. */
105
+ showValueAxis?: boolean;
106
+ /** Shared XY axis configuration. Explicit axes override visibility conveniences. */
107
+ axes?: XYFrameAxisConfig[];
91
108
  /** Background fill color */
92
109
  background?: string;
93
110
  /** Enable hover interaction */
@@ -109,10 +126,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
109
126
  /** Declarative tooltip config or the legacy full-HoverData callback. */
110
127
  tooltip?: RealtimeTooltipProp;
111
128
  /** Enable linked hover selection events for cross-chart highlighting */
112
- linkedHover?: boolean | string | {
113
- name?: string;
114
- fields: string[];
115
- };
129
+ linkedHover?: LinkedHoverProp;
116
130
  /** Consume a named selection — dims unselected elements */
117
131
  selection?: SelectionConfig;
118
132
  /** Configurable opacity decay for older data */
@@ -196,7 +210,10 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
196
210
  * ```
197
211
  */
198
212
  export declare const RealtimeHistogram: {
213
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
199
214
  <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
215
+ /** Typed refs retain the authored row through mutation and readback. */
216
+ <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
200
217
  displayName?: string;
201
218
  };
202
219
  export interface TemporalHistogramProps<TDatum extends Datum = Datum> extends Omit<RealtimeHistogramProps<TDatum>, "data" | "windowSize" | "windowMode"> {
@@ -217,6 +234,7 @@ export declare namespace TemporalHistogram {
217
234
  * written before the rename and will be removed in a future major version. */
218
235
  export declare const RealtimeTemporalHistogram: {
219
236
  <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
237
+ <TDatum extends Datum = Datum>(props: RealtimeHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
220
238
  displayName?: string;
221
239
  };
222
240
  /** @deprecated Use `RealtimeHistogramProps` instead. Same component, just the
@@ -9,16 +9,17 @@ import type { Datum } from "../shared/datumTypes";
9
9
  import type { AutoPlaceAnnotations } from "../../recipes/annotationLayout";
10
10
  import type { MobileVisualizationContract } from "../shared/auditMobileVisualization";
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
- import { type AggregateConfig } from "./aggregate";
12
+ import { type AggregateConfig, type AggregatedRealtimeDatum } from "./aggregate";
13
13
  import { type EventTimeConfig } from "./eventTime";
14
14
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
15
15
  import type { PartialMargin } from "../../types/marginType";
16
+ import { type StyleRule } from "../shared/styleRules";
16
17
  /**
17
18
  * Imperative handle for RealtimeLineChart. It extends the shared realtime
18
19
  * handle without changing that cross-chart contract: only this chart exposes
19
20
  * event-time tail flushing.
20
21
  */
21
- export interface RealtimeLineChartHandle extends RealtimeFrameHandle {
22
+ export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> extends RealtimeFrameHandle<TDatum, TReadDatum> {
22
23
  /**
23
24
  * Release every event still held by `eventTime`, in event-time order.
24
25
  * Call this when an input source reaches an asserted end-of-stream or batch
@@ -28,6 +29,10 @@ export interface RealtimeLineChartHandle extends RealtimeFrameHandle {
28
29
  flush(): void;
29
30
  }
30
31
  export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
32
+ /** Fit the container width. */
33
+ responsiveWidth?: boolean;
34
+ /** Fit a container with a definite height. */
35
+ responsiveHeight?: boolean;
31
36
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
32
37
  mode?: ChartMode;
33
38
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -42,7 +47,7 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
42
47
  width?: number;
43
48
  /** Chart height (alternative to size) */
44
49
  height?: number;
45
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
50
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
46
51
  maxDevicePixelRatio?: number;
47
52
  /** Chart margins */
48
53
  margin?: PartialMargin;
@@ -78,6 +83,8 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
78
83
  opacity?: number;
79
84
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
85
  cursor?: CSSProperties["cursor"];
86
+ /** Ordered data-aware line styling, resolved against the displayed series sample. */
87
+ styleRules?: StyleRule[];
81
88
  /** Show canvas-drawn axes */
82
89
  showAxes?: boolean;
83
90
  /** Background fill color */
@@ -199,7 +206,13 @@ export interface RealtimeLineChartProps<TDatum extends Datum = Datum> extends Re
199
206
  export declare const RealtimeLineChart: {
200
207
  /** Compatibility overload for refs authored against the shared 3.x handle. */
201
208
  <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
202
- /** Specific overload keeps ElementRef/ComponentRef aware of flush(). */
203
- <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeLineChartHandle>): React.ReactElement | null;
209
+ /** Aggregate mode accepts authored rows but materializes window summaries. */
210
+ <TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
211
+ aggregate: AggregateConfig;
212
+ } & React.RefAttributes<RealtimeLineChartHandle<TDatum, AggregatedRealtimeDatum>>): React.ReactElement | null;
213
+ /** Typed non-aggregate refs retain the authored row and expose flush(). */
214
+ <TDatum extends Datum = Datum>(props: Omit<RealtimeLineChartProps<TDatum>, "aggregate"> & {
215
+ aggregate?: undefined;
216
+ } & React.RefAttributes<RealtimeLineChartHandle<TDatum>>): React.ReactElement | null;
204
217
  displayName?: string;
205
218
  };
@@ -11,7 +11,12 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
16
+ /** Fit the container width. */
17
+ responsiveWidth?: boolean;
18
+ /** Fit a container with a definite height. */
19
+ responsiveHeight?: boolean;
15
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
21
  mode?: ChartMode;
17
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -26,7 +31,7 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
26
31
  width?: number;
27
32
  /** Chart height (alternative to size) */
28
33
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
34
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
35
  maxDevicePixelRatio?: number;
31
36
  /** Chart margins */
32
37
  margin?: PartialMargin;
@@ -82,6 +87,8 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
82
87
  pointStyle?: (datum: TDatum) => Style & {
83
88
  r?: number;
84
89
  };
90
+ /** Ordered data-aware dot styling, applied before `pointStyle`. */
91
+ styleRules?: StyleRule[];
85
92
  /** Show canvas-drawn axes */
86
93
  showAxes?: boolean;
87
94
  /** Background fill color */
@@ -162,6 +169,9 @@ export interface RealtimeSwarmChartProps<TDatum extends Datum = Datum> extends R
162
169
  * ```
163
170
  */
164
171
  export declare const RealtimeSwarmChart: {
172
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
165
173
  <TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
174
+ /** Typed refs retain the authored row through mutation and readback. */
175
+ <TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
166
176
  displayName?: string;
167
177
  };
@@ -11,7 +11,12 @@ import type { MobileVisualizationContract } from "../shared/auditMobileVisualiza
11
11
  import type { ResponsiveRule } from "../shared/responsiveRules";
12
12
  import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor, RealtimeTooltipProp } from "./realtimeChartTypes";
13
13
  import type { PartialMargin } from "../../types/marginType";
14
+ import { type StyleRule } from "../shared/styleRules";
14
15
  export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> extends RealtimeAccessibilityProps {
16
+ /** Fit the container width. */
17
+ responsiveWidth?: boolean;
18
+ /** Fit a container with a definite height. */
19
+ responsiveHeight?: boolean;
15
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
16
21
  mode?: ChartMode;
17
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -26,7 +31,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
26
31
  width?: number;
27
32
  /** Chart height (alternative to size) */
28
33
  height?: number;
29
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
34
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
30
35
  maxDevicePixelRatio?: number;
31
36
  /** Chart margins */
32
37
  margin?: PartialMargin;
@@ -78,6 +83,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
78
83
  opacity?: number;
79
84
  /** Presentation-only CSS cursor for retained marks; does not add click, keyboard, or observation behavior. */
80
85
  cursor?: CSSProperties["cursor"];
86
+ /** Ordered data-aware bar styling. Rule `value`/`y` is the displayed delta. */
87
+ styleRules?: StyleRule[];
81
88
  /** Show canvas-drawn axes */
82
89
  showAxes?: boolean;
83
90
  /** Background fill color */
@@ -157,6 +164,9 @@ export interface RealtimeWaterfallChartProps<TDatum extends Datum = Datum> exten
157
164
  * ```
158
165
  */
159
166
  export declare const RealtimeWaterfallChart: {
167
+ /** Compatibility overload for refs authored against the loose 3.x handle. */
160
168
  <TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
169
+ /** Typed refs retain the authored row through mutation and readback. */
170
+ <TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle<TDatum>>): React.ReactElement | null;
161
171
  displayName?: string;
162
172
  };