semiotic 3.9.2 → 3.10.1

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 (537) hide show
  1. package/README.md +97 -76
  2. package/agent-skill/semiotic-charts/SKILL.md +13 -7
  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 +3 -1
  8. package/ai/dist/mcp-server.js +68 -68
  9. package/ai/examples.md +68 -1
  10. package/ai/reference.md +105 -14
  11. package/ai/schema.json +6646 -18
  12. package/ai/surface-manifest.json +34 -6
  13. package/ai/system-prompt.md +2 -0
  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-2RL2QPZJ.min.js +1 -0
  23. package/dist/c-2WK7YJLL.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-45CQWZZ6.min.js +1 -0
  26. package/dist/c-4BRHKVKV.min.js +1 -0
  27. package/dist/c-7242NXSG.min.js +1 -0
  28. package/dist/c-7DVPSB5C.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-A7OGOFSL.min.js +1 -0
  31. package/dist/c-AFBSWT77.min.js +1 -0
  32. package/dist/c-AH5HWZWS.min.js +1 -0
  33. package/dist/c-AJ7EC32V.min.js +1 -0
  34. package/dist/c-AQADQNY7.min.js +1 -0
  35. package/dist/c-ATM475SA.min.js +1 -0
  36. package/dist/c-AVO3Q7T7.min.js +1 -0
  37. package/dist/c-B7GW7IHJ.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BOHCQILI.min.js +1 -0
  40. package/dist/c-C3TZLTZK.min.js +1 -0
  41. package/dist/c-CGQAQWBV.min.js +1 -0
  42. package/dist/c-CPV4N35K.min.js +1 -0
  43. package/dist/c-D6HAAPTX.min.js +1 -0
  44. package/dist/c-DIPEYUOW.min.js +1 -0
  45. package/dist/c-E4JDJH4I.min.js +1 -0
  46. package/dist/c-E72OTUZU.min.js +1 -0
  47. package/dist/c-E7I2L7CU.min.js +1 -0
  48. package/dist/c-ELDWAO2V.min.js +1 -0
  49. package/dist/c-EUBTECGM.min.js +1 -0
  50. package/dist/c-EUMPMDCS.min.js +1 -0
  51. package/dist/c-EZZT2WAE.min.js +1 -0
  52. package/dist/c-FHBVFCQB.min.js +1 -0
  53. package/dist/c-G4HCO2IQ.min.js +1 -0
  54. package/dist/c-G5VIJEOK.min.js +1 -0
  55. package/dist/c-GHVOXAYH.min.js +1 -0
  56. package/dist/c-GNTXRXRN.min.js +1 -0
  57. package/dist/c-GXV3C3MO.min.js +1 -0
  58. package/dist/c-HHTK2R75.min.js +1 -0
  59. package/dist/c-HLLFJYTY.min.js +1 -0
  60. package/dist/c-HP4ZFM47.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HYDTS5OP.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IK33LNZ6.min.js +1 -0
  65. package/dist/c-IK3PZHRY.min.js +1 -0
  66. package/dist/c-J6DVC236.min.js +1 -0
  67. package/dist/c-JIMJF6F6.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KKPMHAZC.min.js +1 -0
  70. package/dist/c-L6WNDBHV.min.js +1 -0
  71. package/dist/c-LDEX5OFW.min.js +1 -0
  72. package/dist/c-LESEUVC5.min.js +1 -0
  73. package/dist/c-LYQMZMZQ.min.js +1 -0
  74. package/dist/c-MB6CV5NC.min.js +1 -0
  75. package/dist/c-MOKJOIPE.min.js +1 -0
  76. package/dist/c-MVR3RWF3.min.js +1 -0
  77. package/dist/c-N3FXLRNT.min.js +1 -0
  78. package/dist/c-N5NPTJVJ.min.js +1 -0
  79. package/dist/c-NHBL4J67.min.js +1 -0
  80. package/dist/c-ODG6TFSY.min.js +1 -0
  81. package/dist/c-ORLEBW72.min.js +1 -0
  82. package/dist/c-P65V6HLO.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSKKFZNP.min.js +1 -0
  85. package/dist/c-PSNI6KAZ.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-R2P4RR7Q.min.js +1 -0
  88. package/dist/c-RFC7UAG7.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-SGAURYHG.min.js +1 -0
  91. package/dist/c-SJMWU6UX.min.js +1 -0
  92. package/dist/c-STIIGQOD.min.js +1 -0
  93. package/dist/c-T2ASIJVZ.min.js +1 -0
  94. package/dist/c-T2V7O2LO.min.js +1 -0
  95. package/dist/c-TKG2NP7G.min.js +1 -0
  96. package/dist/c-TX3THUTO.min.js +1 -0
  97. package/dist/c-TX7XJM3Z.min.js +1 -0
  98. package/dist/c-UC7SIU2W.min.js +1 -0
  99. package/dist/c-UMXSJIOV.min.js +1 -0
  100. package/dist/c-VJTDST2R.min.js +1 -0
  101. package/dist/c-VRSXMLYF.min.js +1 -0
  102. package/dist/c-VSLWSAN2.min.js +1 -0
  103. package/dist/c-VXLOLYTO.min.js +1 -0
  104. package/dist/c-W4ZUKSEQ.min.js +1 -0
  105. package/dist/c-WCBRPILW.min.js +1 -0
  106. package/dist/c-WGHT7OCY.min.js +1 -0
  107. package/dist/c-WUWXGQYA.min.js +1 -0
  108. package/dist/c-WWCW3APR.min.js +1 -0
  109. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  110. package/dist/c-Y6PYUMFU.min.js +1 -0
  111. package/dist/c-YDECTEUW.min.js +1 -0
  112. package/dist/c-YF3YKVQI.min.js +1 -0
  113. package/dist/c-YLZIV3VS.min.js +1 -0
  114. package/dist/c-ZIVPFTOC.min.js +1 -0
  115. package/dist/components/Annotation.d.ts +2 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  117. package/dist/components/ai/chartRecipes.d.ts +4 -0
  118. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  119. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  120. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  121. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  122. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  123. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  124. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  125. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  126. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  127. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  128. package/dist/components/artifact/claimGraph.d.ts +5 -0
  129. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  130. package/dist/components/artifact/claims.d.ts +24 -0
  131. package/dist/components/artifact/collection.d.ts +10 -0
  132. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  133. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  134. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  135. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  136. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  137. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  138. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  139. package/dist/components/artifact/contract.d.ts +30 -0
  140. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  141. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  142. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  143. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  144. package/dist/components/artifact/exportPaths.d.ts +8 -0
  145. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  146. package/dist/components/artifact/fingerprint.d.ts +36 -0
  147. package/dist/components/artifact/grounding.d.ts +51 -0
  148. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  149. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  150. package/dist/components/artifact/identity.d.ts +19 -0
  151. package/dist/components/artifact/inheritance.d.ts +48 -0
  152. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  153. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  154. package/dist/components/artifact/obligations.d.ts +3 -0
  155. package/dist/components/artifact/policies.d.ts +45 -0
  156. package/dist/components/artifact/policyRelations.d.ts +3 -0
  157. package/dist/components/artifact/recordProjection.d.ts +7 -0
  158. package/dist/components/artifact/representation.d.ts +50 -0
  159. package/dist/components/artifact/serialization.d.ts +40 -0
  160. package/dist/components/artifact/temporal.d.ts +32 -0
  161. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  162. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  163. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  164. package/dist/components/artifact/types.d.ts +341 -0
  165. package/dist/components/artifact/validation.d.ts +13 -0
  166. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  167. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  168. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  169. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  170. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  171. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  172. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  173. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  174. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  175. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  176. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  177. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  178. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  179. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  180. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  181. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  182. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  183. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  184. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  185. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  186. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  187. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  188. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  189. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  190. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  191. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  192. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  193. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  194. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  195. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  196. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  197. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  198. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  199. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  200. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  201. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  202. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  203. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  204. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  205. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  206. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  207. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  208. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  209. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  210. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  211. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  212. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  213. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  214. package/dist/components/charts/shared/hooks.d.ts +3 -1
  215. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  216. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  217. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  218. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  219. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  220. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  221. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  222. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  223. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  224. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  225. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  226. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  227. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  228. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  229. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  230. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  231. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  232. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  233. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  234. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  235. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  236. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  237. package/dist/components/export/chartConfig.d.ts +40 -5
  238. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  239. package/dist/components/legendLayout.d.ts +18 -0
  240. package/dist/components/legendStyles.d.ts +4 -0
  241. package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
  242. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  243. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  244. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  245. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  246. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  247. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  248. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  249. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  250. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  251. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  252. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  253. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  254. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  255. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  256. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  257. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  258. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  259. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  260. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  261. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  262. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  263. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  264. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  265. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  266. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  267. package/dist/components/recipes/atlas/index.d.ts +26 -0
  268. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  269. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  270. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  271. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  272. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  273. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  274. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  275. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  276. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  277. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  278. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  279. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  280. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  281. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  282. package/dist/components/recipes/atlas/support.d.ts +7 -0
  283. package/dist/components/recipes/atlas/types.d.ts +278 -0
  284. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  285. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  286. package/dist/components/recipes/intervals.d.ts +1 -1
  287. package/dist/components/semiotic-ai-core.d.ts +33 -22
  288. package/dist/components/semiotic-ai.d.ts +15 -3
  289. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  290. package/dist/components/semiotic-artifact.d.ts +23 -0
  291. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  292. package/dist/components/semiotic-atlas.d.ts +8 -0
  293. package/dist/components/semiotic-experimental.d.ts +1 -1
  294. package/dist/components/semiotic-physics.d.ts +4 -4
  295. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  296. package/dist/components/semiotic-text.d.ts +2 -0
  297. package/dist/components/semiotic-utils-core.d.ts +18 -18
  298. package/dist/components/semiotic.d.ts +3 -3
  299. package/dist/components/server/renderEvidence.d.ts +12 -0
  300. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  301. package/dist/components/server/serverChartConfigs.d.ts +3 -0
  302. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  303. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  304. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  305. package/dist/components/server/staticXYGrid.d.ts +1 -1
  306. package/dist/components/server/svgSizing.d.ts +6 -0
  307. package/dist/components/shared/svgRoot.d.ts +17 -0
  308. package/dist/components/store/selectionProvenance.d.ts +6 -0
  309. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  310. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  311. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  312. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  313. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  314. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  315. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  316. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  317. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  318. package/dist/components/stream/XYGrid.d.ts +11 -0
  319. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  320. package/dist/components/stream/canvasSetup.d.ts +1 -2
  321. package/dist/components/stream/fontLoading.d.ts +4 -0
  322. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  323. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  324. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  325. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  326. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  327. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  328. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  329. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  330. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  331. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  332. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  333. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  334. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  335. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  336. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  337. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  338. package/dist/components/stream/physics/physicsSemanticUI.d.ts +11 -0
  339. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  340. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  341. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  342. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  343. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  344. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  345. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  346. package/dist/components/stream/shallowEqual.d.ts +2 -0
  347. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  348. package/dist/components/stream/types.d.ts +4 -53
  349. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  350. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  351. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  352. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  353. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  354. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  355. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  356. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  357. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  358. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  359. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  360. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  361. package/dist/controls.module.min.js +1 -1
  362. package/dist/geo.min.js +1 -1
  363. package/dist/geo.module.min.js +1 -1
  364. package/dist/network.module.min.js +1 -1
  365. package/dist/ordinal.module.min.js +1 -1
  366. package/dist/physics-matter.min.js +1 -1
  367. package/dist/physics-matter.module.min.js +1 -1
  368. package/dist/physics-rapier.min.js +1 -1
  369. package/dist/physics-rapier.module.min.js +1 -1
  370. package/dist/physics.module.min.js +1 -1
  371. package/dist/physicsWorker.js +1 -1
  372. package/dist/processSankeyLayoutWorker.js +1 -1
  373. package/dist/rough.min.js +1 -1
  374. package/dist/rough.module.min.js +1 -1
  375. package/dist/semiotic-access.module.min.js +1 -1
  376. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  377. package/dist/semiotic-ai-core.d.ts +33 -22
  378. package/dist/semiotic-ai-core.min.js +1 -1
  379. package/dist/semiotic-ai-core.module.min.js +1 -1
  380. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  381. package/dist/semiotic-ai.d.ts +15 -3
  382. package/dist/semiotic-ai.module.min.js +1 -1
  383. package/dist/semiotic-artifact-react.d.ts +10 -0
  384. package/dist/semiotic-artifact-react.min.js +2 -0
  385. package/dist/semiotic-artifact-react.module.min.js +2 -0
  386. package/dist/semiotic-artifact.d.ts +23 -0
  387. package/dist/semiotic-artifact.min.js +1 -0
  388. package/dist/semiotic-artifact.module.min.js +1 -0
  389. package/dist/semiotic-atlas-core.d.ts +20 -0
  390. package/dist/semiotic-atlas-core.min.js +1 -0
  391. package/dist/semiotic-atlas-core.module.min.js +1 -0
  392. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  393. package/dist/semiotic-atlas.d.ts +8 -0
  394. package/dist/semiotic-atlas.min.js +2 -0
  395. package/dist/semiotic-atlas.module.min.js +2 -0
  396. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  397. package/dist/semiotic-client-glyph.module.min.js +1 -1
  398. package/dist/semiotic-client-responsive.module.min.js +1 -1
  399. package/dist/semiotic-client-shared.module.min.js +1 -1
  400. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  401. package/dist/semiotic-data.min.js +1 -1
  402. package/dist/semiotic-data.module.min.js +1 -1
  403. package/dist/semiotic-evidence.min.js +1 -1
  404. package/dist/semiotic-evidence.module.min.js +1 -1
  405. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  406. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  407. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  408. package/dist/semiotic-experimental-vacp.min.js +1 -1
  409. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  410. package/dist/semiotic-experimental.d.ts +1 -1
  411. package/dist/semiotic-line.module.min.js +1 -1
  412. package/dist/semiotic-physics.d.ts +4 -4
  413. package/dist/semiotic-realtime-core.module.min.js +1 -1
  414. package/dist/semiotic-realtime-react.module.min.js +1 -1
  415. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  416. package/dist/semiotic-recipes-core.d.ts +9 -0
  417. package/dist/semiotic-recipes-core.module.min.js +1 -1
  418. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  419. package/dist/semiotic-recipes-react.min.js +1 -1
  420. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  421. package/dist/semiotic-server-edge.min.js +1 -1
  422. package/dist/semiotic-server-edge.module.min.js +1 -1
  423. package/dist/semiotic-server-node.min.js +1 -1
  424. package/dist/semiotic-server-node.module.min.js +1 -1
  425. package/dist/semiotic-text.d.ts +2 -0
  426. package/dist/semiotic-text.min.js +2 -0
  427. package/dist/semiotic-text.module.min.js +2 -0
  428. package/dist/semiotic-themes-core.min.js +1 -1
  429. package/dist/semiotic-themes-core.module.min.js +1 -1
  430. package/dist/semiotic-themes.min.js +1 -1
  431. package/dist/semiotic-themes.module.min.js +1 -1
  432. package/dist/semiotic-utils-core.d.ts +18 -18
  433. package/dist/semiotic-utils-core.min.js +1 -1
  434. package/dist/semiotic-utils-core.module.min.js +1 -1
  435. package/dist/semiotic-value.module.min.js +1 -1
  436. package/dist/semiotic.d.ts +3 -3
  437. package/dist/semiotic.module.min.js +1 -1
  438. package/dist/server.min.js +1 -1
  439. package/dist/server.module.min.js +1 -1
  440. package/dist/xy.module.min.js +1 -1
  441. package/package.json +70 -14
  442. package/spec/README.md +8 -3
  443. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  444. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  445. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  446. package/dist/c-3BLJEQNG.min.js +0 -1
  447. package/dist/c-3SCUN5HI.min.js +0 -1
  448. package/dist/c-3VVKFA4M.min.js +0 -1
  449. package/dist/c-43TJZS3F.min.js +0 -1
  450. package/dist/c-4DTZPSUD.min.js +0 -1
  451. package/dist/c-4ES5367Y.min.js +0 -1
  452. package/dist/c-52TEGIUJ.min.js +0 -1
  453. package/dist/c-54IRWOGM.min.js +0 -1
  454. package/dist/c-5D2S4RMI.min.js +0 -1
  455. package/dist/c-5JWCTX3G.min.js +0 -1
  456. package/dist/c-6CMMSN6N.min.js +0 -1
  457. package/dist/c-6HRB2L7H.min.js +0 -1
  458. package/dist/c-6O5EVOPH.min.js +0 -1
  459. package/dist/c-7W4SV36A.min.js +0 -1
  460. package/dist/c-A4WRGZFX.min.js +0 -1
  461. package/dist/c-AG7WWVIH.min.js +0 -1
  462. package/dist/c-AH6J4MTN.min.js +0 -1
  463. package/dist/c-AKAF6JAD.min.js +0 -1
  464. package/dist/c-ALYR5LKK.min.js +0 -1
  465. package/dist/c-BBKITSXB.min.js +0 -1
  466. package/dist/c-BYDPC44I.min.js +0 -1
  467. package/dist/c-CFFIU2MW.min.js +0 -1
  468. package/dist/c-CGNHBHCE.min.js +0 -1
  469. package/dist/c-CJYSXIFV.min.js +0 -1
  470. package/dist/c-CZF7MV67.min.js +0 -1
  471. package/dist/c-D53OKBSY.min.js +0 -1
  472. package/dist/c-DADXPJXV.min.js +0 -1
  473. package/dist/c-DBQ2V7CH.min.js +0 -1
  474. package/dist/c-DPMVAUAW.min.js +0 -1
  475. package/dist/c-ECJCKLYY.min.js +0 -1
  476. package/dist/c-EGATGOWJ.min.js +0 -1
  477. package/dist/c-EGR6VYBW.min.js +0 -1
  478. package/dist/c-ESNR43AN.min.js +0 -1
  479. package/dist/c-F3LIKINL.min.js +0 -1
  480. package/dist/c-F5ZB5GJ6.min.js +0 -1
  481. package/dist/c-G36WS6LN.min.js +0 -1
  482. package/dist/c-G3VYMHKE.min.js +0 -1
  483. package/dist/c-GGISSW5E.min.js +0 -1
  484. package/dist/c-GR6MOEQC.min.js +0 -1
  485. package/dist/c-GSVCN34B.min.js +0 -1
  486. package/dist/c-GYOQCEFP.min.js +0 -1
  487. package/dist/c-H3DNMTCC.min.js +0 -1
  488. package/dist/c-I6J3FEZE.min.js +0 -1
  489. package/dist/c-IGH6MGJ5.min.js +0 -1
  490. package/dist/c-II2EEAJN.min.js +0 -1
  491. package/dist/c-IUHFPMHD.min.js +0 -1
  492. package/dist/c-J6M4JHRS.min.js +0 -1
  493. package/dist/c-JM3MGLQV.min.js +0 -1
  494. package/dist/c-KM3N7F7R.min.js +0 -1
  495. package/dist/c-LF5BZFNC.min.js +0 -1
  496. package/dist/c-LKBSGFQC.min.js +0 -1
  497. package/dist/c-MNF2S4AA.min.js +0 -1
  498. package/dist/c-MT3WBK7M.min.js +0 -1
  499. package/dist/c-NDJADPIF.min.js +0 -1
  500. package/dist/c-NVPQCIL5.min.js +0 -1
  501. package/dist/c-NY3JWV2K.min.js +0 -1
  502. package/dist/c-OFWJBEE5.min.js +0 -1
  503. package/dist/c-OYFHP5F5.min.js +0 -1
  504. package/dist/c-PGKQGGQ2.min.js +0 -1
  505. package/dist/c-PPWDL5ZI.min.js +0 -1
  506. package/dist/c-Q2IPZ3MU.min.js +0 -1
  507. package/dist/c-QKHMBE2E.min.js +0 -1
  508. package/dist/c-QMVM3AY6.min.js +0 -1
  509. package/dist/c-QSGWX53A.min.js +0 -1
  510. package/dist/c-RJKEKZOO.min.js +0 -1
  511. package/dist/c-RSVIHIQ4.min.js +0 -1
  512. package/dist/c-S6U5CGT5.min.js +0 -1
  513. package/dist/c-SFDIIU5G.min.js +0 -1
  514. package/dist/c-SLGMUBUL.min.js +0 -1
  515. package/dist/c-SRTBCRVE.min.js +0 -1
  516. package/dist/c-T6UAIKBH.min.js +0 -1
  517. package/dist/c-TMCTEVVW.min.js +0 -1
  518. package/dist/c-TMOSJLT3.min.js +0 -1
  519. package/dist/c-TZW3JGJ5.min.js +0 -1
  520. package/dist/c-U6ESPM7V.min.js +0 -1
  521. package/dist/c-UC5PTTFI.min.js +0 -1
  522. package/dist/c-USFMFKIH.min.js +0 -1
  523. package/dist/c-VGKUEZBC.min.js +0 -1
  524. package/dist/c-VGW3VG3I.min.js +0 -1
  525. package/dist/c-VN2HG5BS.min.js +0 -1
  526. package/dist/c-VPZDY5Q4.min.js +0 -1
  527. package/dist/c-VRXUB2F2.min.js +0 -1
  528. package/dist/c-VUBQNQJH.min.js +0 -1
  529. package/dist/c-VUH4PGZY.min.js +0 -1
  530. package/dist/c-W3CE4A4S.min.js +0 -1
  531. package/dist/c-X5UBGU2V.min.js +0 -1
  532. package/dist/c-XDRV7RKW.min.js +0 -1
  533. package/dist/c-YGZHURXZ.min.js +0 -1
  534. package/dist/c-YZVRZGX2.min.js +0 -1
  535. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  536. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  537. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -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;
@@ -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
@@ -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
+ };
@@ -13,6 +13,10 @@ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor,
13
13
  import type { PartialMargin } from "../../types/marginType";
14
14
  import { type StyleRule } from "../shared/styleRules";
15
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;
16
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
17
21
  mode?: ChartMode;
18
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -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,10 +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";
15
16
  import { type StyleRule } from "../shared/styleRules";
16
17
  export type RealtimeHistogramDirection = "up" | "down";
17
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;
18
23
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
19
24
  mode?: ChartMode;
20
25
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -92,8 +97,14 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
92
97
  styleRules?: StyleRule[];
93
98
  /** Gap between bars in pixels */
94
99
  gap?: number;
95
- /** Show canvas-drawn axes */
100
+ /** Show axis baselines, ticks, and labels */
96
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[];
97
108
  /** Background fill color */
98
109
  background?: string;
99
110
  /** Enable hover interaction */
@@ -115,10 +126,7 @@ export interface RealtimeHistogramProps<TDatum extends Datum = Datum> extends Re
115
126
  /** Declarative tooltip config or the legacy full-HoverData callback. */
116
127
  tooltip?: RealtimeTooltipProp;
117
128
  /** Enable linked hover selection events for cross-chart highlighting */
118
- linkedHover?: boolean | string | {
119
- name?: string;
120
- fields: string[];
121
- };
129
+ linkedHover?: LinkedHoverProp;
122
130
  /** Consume a named selection — dims unselected elements */
123
131
  selection?: SelectionConfig;
124
132
  /** Configurable opacity decay for older data */
@@ -29,6 +29,10 @@ export interface RealtimeLineChartHandle<TDatum extends Datum = Datum, TReadDatu
29
29
  flush(): void;
30
30
  }
31
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;
32
36
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
33
37
  mode?: ChartMode;
34
38
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -13,6 +13,10 @@ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor,
13
13
  import type { PartialMargin } from "../../types/marginType";
14
14
  import { type StyleRule } from "../shared/styleRules";
15
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;
16
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
17
21
  mode?: ChartMode;
18
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -13,6 +13,10 @@ import type { RealtimeAccessibilityProps, RealtimeData, RealtimePointIdAccessor,
13
13
  import type { PartialMargin } from "../../types/marginType";
14
14
  import { type StyleRule } from "../shared/styleRules";
15
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;
16
20
  /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
17
21
  mode?: ChartMode;
18
22
  /** Semantic responsive transformations applied before chart-mode defaults. */
@@ -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";
@@ -5,18 +6,19 @@ import type { Datum } from "../shared/datumTypes";
5
6
  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
- import type { ChartAccessor, ChartMode, SelectionConfig } from "../shared/types";
9
- /** Read a numeric time/value off a datum via accessor, with a field fallback. */
10
- export declare function readRealtimeNumber<TDatum extends Datum>(datum: Datum, accessor: ChartAccessor<TDatum, number> | undefined, fallback: string): number | null;
11
- interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover"> {
9
+ import type { ChartMode, SelectionConfig } from "../shared/types";
10
+ export { readRealtimeNumber } from "./realtimeAccessors";
11
+ interface RealtimeModeProps extends Omit<ChartModeInput, "enableHover">, RealtimeResponsiveProps {
12
12
  mode?: ChartMode;
13
13
  size?: [number, number];
14
14
  enableHover?: unknown;
15
15
  }
16
- export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult;
16
+ export declare function useRealtimeChartMode(props: RealtimeModeProps): ChartModeResult & RealtimeResponsiveProps;
17
17
  export declare function useRealtimeFrameHandle<TDatum extends Datum = Datum>(ref: React.Ref<RealtimeFrameHandle<TDatum>>, frameRef: React.RefObject<StreamXYFrameHandle | null>): void;
18
18
  export declare function useRealtimeSelectionStyle<TStyle extends Datum>(baseStyle: ((datum: Datum) => TStyle) | undefined, hooks: readonly (SelectionHookResult | null)[], selection: SelectionConfig | undefined): ((datum: Datum) => TStyle) | undefined;
19
- 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;
20
22
  title: string | undefined;
21
23
  description: string | undefined;
22
24
  summary: string | undefined;
@@ -26,4 +28,3 @@ export declare function buildRealtimeFrameChromeProps(resolved: ChartModeResult,
26
28
  legendHighlightedCategory: string | null;
27
29
  legendIsolatedCategories: Set<string> | undefined;
28
30
  };
29
- 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. */
@@ -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;
@@ -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;
@@ -0,0 +1,3 @@
1
+ /** Data identity shared by serialized chart configs and artifact bindings. */
2
+ export declare const CHART_DATA_PROPS: ReadonlySet<string>;
3
+ export declare function isChartDataProp(key: string, value: unknown): boolean;
@@ -0,0 +1,5 @@
1
+ export declare const preparedAtlasSchema: Readonly<Record<string, unknown>>;
2
+ export declare const dependencyProjectionSchema: Readonly<Record<string, unknown>>;
3
+ export declare const circuitProjectionSchema: Readonly<Record<string, unknown>>;
4
+ export declare const circuitEditionSchema: Readonly<Record<string, unknown>>;
5
+ export declare const circuitReadingSchema: Readonly<Record<string, unknown>>;
@@ -125,6 +125,10 @@ export interface ChartPropSpec {
125
125
  omitFromSchema?: boolean;
126
126
  }
127
127
  export interface ChartSpec {
128
+ /** Optional dedicated public boundary when it differs from the family. */
129
+ importPath?: string;
130
+ /** Public interactive reference for this reader. */
131
+ docsRoute?: string;
128
132
  /** Component name, must match the React export. */
129
133
  name: string;
130
134
  category: ChartCategory;
@@ -0,0 +1,2 @@
1
+ import { type ChartSpec } from "./chartSpecCore";
2
+ export declare const ATLAS_CHART_SPECS: Record<string, ChartSpec>;
@@ -63,7 +63,7 @@ export declare function useSortedData(data: Array<Datum>, sort: boolean | "asc"
63
63
  * @param unwrapData - Deprecated / no-op. Hover data is always unwrapped
64
64
  * (stream frames wrap the raw datum in { data, time, value, x, y }).
65
65
  */
66
- export declare function useChartSelection({ selection, linkedHover, fallbackFields, unwrapData: _unwrapData, onObservation, chartType, chartId, onClick, hoverHighlight, colorByField, mobileInteraction }: {
66
+ export declare function useChartSelection({ selection, linkedHover, fallbackFields, unwrapData: _unwrapData, onObservation, chartType, chartId, onClick, hoverHighlight, colorByField, mobileInteraction, emitObservations }: {
67
67
  selection?: SelectionConfig;
68
68
  linkedHover?: LinkedHoverProp;
69
69
  fallbackFields?: string[];
@@ -78,6 +78,8 @@ export declare function useChartSelection({ selection, linkedHover, fallbackFiel
78
78
  hoverHighlight?: HoverHighlightMode;
79
79
  colorByField?: string;
80
80
  mobileInteraction?: ResolvedMobileInteractionConfig;
81
+ /** Frames that own observation publication can use these callbacks only for linking. */
82
+ emitObservations?: boolean;
81
83
  }): {
82
84
  activeSelectionHook: SelectionHookResult | null;
83
85
  hoverSelectionHook: SelectionHookResult | null;
@@ -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", "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"];
8
+ export declare const KNOWN_CHART_COMPONENTS: readonly ["MotifBraidChart", "DependencyForestChart", "FlowCircuitChart", "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;
@@ -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;
@@ -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;
@@ -27,6 +27,10 @@ export interface FrameLegendOverrides {
27
27
  legendLayout?: LegendLayout;
28
28
  /** Any explicit frame margin replaces the HOC-measured margin. */
29
29
  margin?: unknown;
30
+ axes?: ReadonlyArray<{
31
+ orient: "top" | "bottom" | "left" | "right";
32
+ visible?: boolean;
33
+ }>;
30
34
  }
31
35
  /**
32
36
  * Resolve the legend values consumed by layout before a wrapper forwards its
@@ -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`. */