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
@@ -55,6 +55,11 @@ export interface PhysicsBodySpec {
55
55
  friction?: number;
56
56
  /** Disable body-body contacts for visual/tethered satellite marks. */
57
57
  bodyCollisions?: boolean;
58
+ /** Hold either coordinate exactly, allowing motion on the other axis. */
59
+ fixedPosition?: {
60
+ x?: number;
61
+ y?: number;
62
+ };
58
63
  shape: PhysicsBodyShape;
59
64
  datum?: unknown;
60
65
  }
@@ -69,6 +74,10 @@ export interface PhysicsBodyState {
69
74
  angle: number;
70
75
  mass: number;
71
76
  bodyCollisions?: boolean;
77
+ fixedPosition?: {
78
+ x?: number;
79
+ y?: number;
80
+ };
72
81
  shape: PhysicsBodyShape;
73
82
  sleeping: boolean;
74
83
  datum?: unknown;
@@ -1,10 +1,10 @@
1
1
  import { type PhysicsBodyState, type PhysicsColliderSpec, type PhysicsKernelEvent, type PhysicsSpringSpec } from "./PhysicsKernel";
2
2
  import { type PhysicsSedimentBinSnapshot, type PhysicsSedimentColumn, type PhysicsSedimentHeightfieldOptions, type PhysicsSedimentTotals } from "./PhysicsSediment";
3
3
  import { type PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
4
- import type { PhysicsObservationEvent, PhysicsObservationRecord, PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "./PhysicsPipelineTypes";
4
+ import type { PhysicsObservationEvent, PhysicsObservationRecord, PhysicsPipelineConfig, PhysicsPipelineExecution, PhysicsPipelineControlSurface, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacingOptions } from "./PhysicsPipelineTypes";
5
5
  import { type UpdateResult } from "../pipelineUpdateContract";
6
6
  import { type PhysicsBodyHitTestOptions } from "./PhysicsBodySpatialIndex";
7
- export type { PhysicsPlotBounds, PhysicsBoundsColliderOptions, PhysicsXBinColliderOptions, PhysicsSpawnSpringSpec, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnTimeAccessor, PhysicsSpawnPacingOptions, PhysicsPipelineQueuedSpawnSnapshot, PhysicsObservationEventType, PhysicsSimulationState, PhysicsObservationEvent, PhysicsObservationRecord, PhysicsSensorObservationConfig, PhysicsPipelineObservationOptions, PhysicsPipelineConfig, PhysicsPipelineTickResult, PhysicsPipelineSnapshot, PhysicsPipelineControlSurface } from "./PhysicsPipelineTypes";
7
+ export type { PhysicsPlotBounds, PhysicsBoundsColliderOptions, PhysicsXBinColliderOptions, PhysicsSpawnSpringSpec, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnTimeAccessor, PhysicsSpawnPacingOptions, PhysicsPipelineQueuedSpawnSnapshot, PhysicsObservationEventType, PhysicsSimulationState, PhysicsObservationEvent, PhysicsObservationRecord, PhysicsSensorObservationConfig, PhysicsPipelineObservationOptions, PhysicsPipelineConfig, PhysicsPipelineExecution, PhysicsPipelineTickResult, PhysicsPipelineSnapshot, PhysicsPipelineControlSurface } from "./PhysicsPipelineTypes";
8
8
  export { schedulePhysicsSpawns, collidersFromPlotBounds, collidersFromXScaleBins } from "./physicsPipelineHelpers";
9
9
  export type { ChangeSet, Invalidation, RevisionSet, UpdateResult } from "../pipelineUpdateContract";
10
10
  export declare class PhysicsPipelineStore {
@@ -49,10 +49,11 @@ export declare class PhysicsPipelineStore {
49
49
  */
50
50
  materializeDueSpawns(): string[];
51
51
  clear(): void;
52
- tick(deltaSeconds: number): PhysicsPipelineTickResult;
52
+ tick(deltaSeconds: number, execution?: PhysicsPipelineExecution): PhysicsPipelineTickResult;
53
53
  /** Steps-only settle. Kernel/sensor transitions are stepped but not observed. */
54
54
  settle(maxSteps?: number): number;
55
- settleWithObservations(maxSteps?: number): PhysicsPipelineTickResult;
55
+ settleWithObservations(maxSteps?: number, execution?: PhysicsPipelineExecution): PhysicsPipelineTickResult;
56
+ private stepObserver;
56
57
  /** Bind this store to the shared settle loop (see physicsPipelineSettle). */
57
58
  private settleHost;
58
59
  /**
@@ -141,6 +141,15 @@ export interface PhysicsPipelineTickResult {
141
141
  spawned: string[];
142
142
  steps: number;
143
143
  }
144
+ /** Optional fixed-step execution for authored forces and process controllers. */
145
+ export interface PhysicsPipelineExecution {
146
+ /** Called once after admitting due bodies (steps=0), then after each fixed step.
147
+ * Each result contains only that boundary's events and admissions. */
148
+ onStep: (result: PhysicsPipelineTickResult) => void;
149
+ /** Keep a bounded settle advancing while semantic work remains at physical rest.
150
+ * The configured or supplied step limit still applies. */
151
+ continueWhile?: () => boolean;
152
+ }
144
153
  export interface PhysicsPipelineSnapshot {
145
154
  accumulator: number;
146
155
  activeSensorPairs: string[];
@@ -294,6 +294,9 @@ export interface StreamPhysicsFrameProps {
294
294
  onBodyHover?: (body: PhysicsBodyState | null, hover: PhysicsHoverData | null) => void;
295
295
  onSemanticItemActivate?: (item: PhysicsSemanticItem) => void;
296
296
  onSemanticItemFocus?: (item: PhysicsSemanticItem | null) => void;
297
+ /** Runs at admission (steps=0) and after each fixed simulation step (steps=1),
298
+ * including reduced-motion and imperative settles. Respect elapsedSeconds or
299
+ * steps for time-based work. Callback-driven execution uses the sync engine. */
297
300
  onTick?: (result: PhysicsPipelineTickResult, controls: PhysicsPipelineControlSurface) => void;
298
301
  /** Uniform opacity for bodies when `bodyStyle` does not set `opacity`. */
299
302
  opacity?: number;
@@ -0,0 +1,5 @@
1
+ /** Convert viewport coordinates to the canvas's logical CSS-pixel coordinates. */
2
+ export declare function physicsCanvasCoordinates(canvas: HTMLCanvasElement, clientX: number, clientY: number): {
3
+ x: number;
4
+ y: number;
5
+ };
@@ -0,0 +1,16 @@
1
+ import type { PhysicsBodyState } from "./PhysicsKernel";
2
+ /** Fixed coordinates take precedence over forces, impulses, and contacts. */
3
+ export declare function enforceFixedPosition(body: PhysicsBodyState): void;
4
+ export declare function cloneFixedPosition(fixed: PhysicsBodyState["fixedPosition"]): {
5
+ x: number | undefined;
6
+ y: number | undefined;
7
+ } | undefined;
8
+ /**
9
+ * Contact separation along the remaining free axis. A radial circle normal
10
+ * cannot separate two equal-x circles horizontally when x encodes a value.
11
+ */
12
+ export declare function fixedAxisContact(a: PhysicsBodyState, b: PhysicsBodyState, fixedAxis: "x" | "y"): {
13
+ nx: number;
14
+ ny: number;
15
+ penetration: number;
16
+ };
@@ -0,0 +1,6 @@
1
+ import type { PhysicsBodyShape, PhysicsColliderShape, PhysicsColliderBodyFilter, PhysicsKernelSnapshotBody, PhysicsKernelSnapshotCollider } from "./PhysicsKernel";
2
+ export declare function cloneShape(shape: PhysicsBodyShape): PhysicsBodyShape;
3
+ export declare function cloneColliderShape(shape: PhysicsColliderShape): PhysicsColliderShape;
4
+ export declare function cloneBody(body: PhysicsKernelSnapshotBody): PhysicsKernelSnapshotBody;
5
+ export declare function cloneColliderBodyFilter(filter: PhysicsColliderBodyFilter | undefined): PhysicsColliderBodyFilter | undefined;
6
+ export declare function cloneCollider(collider: PhysicsKernelSnapshotCollider): PhysicsKernelSnapshotCollider;
@@ -1,3 +1,4 @@
1
+ import type { PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
1
2
  import type { PhysicsEngineAdapter } from "./PhysicsEngineAdapter";
2
3
  import type { PhysicsKernelEvent } from "./PhysicsKernel";
3
4
  import type { PhysicsObservationEvent, PhysicsSimulationState } from "./PhysicsPipelineTypes";
@@ -12,3 +13,4 @@ export declare function observePhysicsSensorTransitions(world: PhysicsEngineAdap
12
13
  export declare function removePhysicsSensorPairsForBodies(pairs: Set<string>, bodyIds: ReadonlySet<string>): void;
13
14
  export declare function resolvePhysicsSimulationState(paused: boolean, visible: boolean, hasQueuedBodies: boolean, atRest: boolean): PhysicsSimulationState;
14
15
  export declare function emitPhysicsSimulationStateTransition(previous: PhysicsSimulationState, next: PhysicsSimulationState, context: PhysicsObservationContext): void;
16
+ export declare function emitPhysicsBodyBudgetObservation(decision: PhysicsBodyBudgetDecision, context: PhysicsObservationContext): void;
@@ -1,18 +1,16 @@
1
1
  /**
2
- * The shared "run this simulation to completion" loop behind both of
2
+ * The shared fixed-step loop behind live ticks and both of
3
3
  * `PhysicsPipelineStore`'s settle entry points.
4
4
  *
5
- * Settling has to mean *the simulation reached its end state*, and that includes
6
- * admitting every arrival the queue still owes. Advancing simulated time per
7
- * step and re-checking due spawns inside the loop is what lets paced spawns
8
- * (`initialSpawnPacing`, per-datum `spawnAt`) and elapsed-time event tapes
9
- * finish on the reduced-motion / snapshot path instead of freezing at the first
10
- * spawn instant. Both entry points run this one loop so they cannot drift apart.
5
+ * Each step advances simulated time and admits due arrivals. An observed run
6
+ * can also execute authored behavior at that boundary. The step limit bounds
7
+ * the work; reaching it does not prove that every arrival or process completed.
8
+ * Both entry points use this loop so pacing cannot drift between them.
11
9
  */
12
10
  import type { PhysicsBodyBudgetDecision } from "./PhysicsBodyBudget";
13
11
  import type { PhysicsKernelEvent } from "./PhysicsKernel";
14
12
  import type { PhysicsPipelineEvictionResult } from "./physicsPipelineHelpers";
15
- import type { PhysicsObservationEvent } from "./PhysicsPipelineTypes";
13
+ import type { PhysicsObservationEvent, PhysicsPipelineExecution, PhysicsPipelineTickResult } from "./PhysicsPipelineTypes";
16
14
  /**
17
15
  * The slice of store behavior the loop drives. Passed explicitly (rather than
18
16
  * reaching into the store) so the loop stays independently testable.
@@ -49,4 +47,12 @@ export interface PhysicsSettleRun {
49
47
  steps: number;
50
48
  budget?: PhysicsBodyBudgetDecision;
51
49
  }
52
- export declare function runPhysicsSettleSteps(host: PhysicsSettleHost, maxSteps: number, sink: PhysicsSettleSink): PhysicsSettleRun;
50
+ /** Deliver each admission/event exactly once, while retaining the aggregate
51
+ * result for the caller of tick or settleWithObservations. */
52
+ export declare function createPhysicsStepObserver(execution: PhysicsPipelineExecution | undefined, readResult: (steps: number) => PhysicsPipelineTickResult): (() => void) | undefined;
53
+ export declare function runPhysicsSettleSteps(host: PhysicsSettleHost, maxSteps: number, sink: PhysicsSettleSink, options?: {
54
+ stopAtRest?: boolean;
55
+ shouldStop?: () => boolean;
56
+ continueWhile?: () => boolean;
57
+ afterStep?: () => void;
58
+ }): PhysicsSettleRun;
@@ -35,23 +35,14 @@ export interface PhysicsPostTickOutcome {
35
35
  snapshot: ReturnType<PhysicsPipelineStore["snapshot"]>;
36
36
  result: PhysicsPipelineTickResult;
37
37
  }
38
- /**
39
- * How many settle → `onTick` → settle passes the reduced-motion path runs before
40
- * giving up. Event-tape charts spawn bodies from `onTick`, so one pass is never
41
- * enough; a small bound keeps a controller that always reports work from
42
- * blocking the main thread.
43
- */
44
- export declare const REDUCED_MOTION_SETTLE_PASSES = 4;
45
- /**
46
- * The reduced-motion / snapshot render pass.
47
- *
48
- * Reduced motion never schedules a second frame, so any work a settle hands to
49
- * `onTick` — an event tape spawning gate bodies, a capacity controller
50
- * releasing queued items — would be enqueued and never simulated. Settle
51
- * repeatedly while the store still reports pending work so the scene reaches
52
- * the same end state an animated run would.
53
- */
54
- export declare function runPhysicsReducedMotionPasses(store: PhysicsPipelineStore, postTick: (result: PhysicsPipelineTickResult) => Omit<PhysicsPostTickOutcome, "result">, maxPasses?: number): PhysicsPostTickOutcome;
38
+ /** Run authored behavior at every fixed step, including during bounded settles.
39
+ * An omitted delta selects settling; the step limit is a budget, not a claim
40
+ * that a continuous process has finished. */
41
+ export declare function runPhysicsObservedSteps(store: PhysicsPipelineStore, postTick: (result: PhysicsPipelineTickResult) => Omit<PhysicsPostTickOutcome, "result">, options?: {
42
+ deltaSeconds?: number;
43
+ maxSteps?: number;
44
+ continueWhile?: () => boolean;
45
+ }): PhysicsPostTickOutcome;
55
46
  /**
56
47
  * Shared post-tick pipeline: region forces → body forces → controllers → onTick.
57
48
  * Used by the main RAF path and the worker-fallback path (DRY + one snapshot).
@@ -2,13 +2,24 @@
2
2
  * Physics frame semantic items, default tooltip, and accessible data table.
3
3
  */
4
4
  import * as React from "react";
5
+ import type { FrameMargin } from "../useFrame";
5
6
  import type { PhysicsBodyState } from "./PhysicsKernel";
6
7
  import type { PhysicsSimulationState } from "./PhysicsPipelineStore";
7
8
  import type { PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
8
9
  export declare const SR_ONLY_STYLE: React.CSSProperties;
10
+ /** Announce hover or focus once, outside the frame's atomic role="img". */
11
+ export declare function renderPhysicsAnnouncements(items: PhysicsSemanticItem[], focusedSemanticItem: PhysicsSemanticItem | null, hoverData: PhysicsHoverData | null, liveRegionId: string): React.JSX.Element;
9
12
  declare function physicsHoverData(body: PhysicsBodyState): PhysicsHoverData;
10
13
  declare function createBodySemanticItems(bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"], limit: number): PhysicsSemanticItem[];
11
14
  declare function semanticItemsChanged(previous: readonly PhysicsSemanticItem[], next: readonly PhysicsSemanticItem[]): boolean;
15
+ export declare function renderPhysicsTooltip({ enableHover, hoverData, tooltipContent, plotWidth, plotHeight, margin }: {
16
+ enableHover: boolean;
17
+ hoverData: PhysicsHoverData | null;
18
+ tooltipContent: StreamPhysicsFrameProps["tooltipContent"];
19
+ plotWidth: number;
20
+ plotHeight: number;
21
+ margin: FrameMargin;
22
+ }): React.ReactElement | null;
12
23
  declare function DefaultPhysicsTooltip({ hover }: {
13
24
  hover: PhysicsHoverData;
14
25
  }): React.ReactElement;
@@ -6,11 +6,13 @@ import type { PhysicsHoverData, StreamPhysicsFrameProps } from "./StreamPhysicsT
6
6
  import type { PhysicsFrameObservationPayload } from "./physicsFrameObservations";
7
7
  type PhysicsFrameObservationEmitter = (type: "hover", payload: PhysicsFrameObservationPayload) => void;
8
8
  interface PhysicsCanvasPointerOptions {
9
+ resolveSemanticBody?: (body: PhysicsBodyState) => PhysicsBodyState;
9
10
  canvasRef: React.RefObject<HTMLCanvasElement | null>;
10
11
  clearHover: () => void;
11
12
  emitObservation: PhysicsFrameObservationEmitter;
12
13
  enableHover: boolean;
13
14
  hoverRadius: number;
15
+ hoverDataRef: React.MutableRefObject<PhysicsHoverData | null>;
14
16
  onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
15
17
  setHoverData: React.Dispatch<React.SetStateAction<PhysicsHoverData | null>>;
16
18
  storeRef: React.RefObject<PhysicsPipelineStore | null>;
@@ -22,7 +24,7 @@ export interface PhysicsBodyCursorCollection {
22
24
  }
23
25
  declare function collectPhysicsBodyCursor(collection: PhysicsBodyCursorCollection, body: PhysicsBodyState, style: Style, customRenderer: boolean): void;
24
26
  /** Owns canvas hit-testing that is shared by physics hover and authored cursors. */
25
- export declare function usePhysicsCanvasPointer({ canvasRef, clearHover, emitObservation, enableHover, hoverRadius, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
27
+ export declare function usePhysicsCanvasPointer({ resolveSemanticBody, canvasRef, clearHover, emitObservation, enableHover, hoverRadius, hoverDataRef, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
26
28
  begin: () => PhysicsBodyCursorCollection;
27
29
  collect: typeof collectPhysicsBodyCursor;
28
30
  handlePointerLeave: (event: React.PointerEvent<HTMLCanvasElement>) => void;
@@ -21,11 +21,13 @@ interface PhysicsSemanticNavigationOptions {
21
21
  storeRef: MutableRefObject<PhysicsPipelineStore | null>;
22
22
  }
23
23
  export interface PhysicsSemanticNavigationResult {
24
+ resolveSemanticBody: (body: PhysicsBodyState) => PhysicsBodyState;
24
25
  clearHover: () => void;
25
26
  focusedBodyIdRef: MutableRefObject<string | null>;
26
27
  focusedSemanticItem: PhysicsSemanticItem | null;
27
28
  handleCanvasPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
28
29
  hoverData: PhysicsHoverData | null;
30
+ hoverDataRef: MutableRefObject<PhysicsHoverData | null>;
29
31
  onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
30
32
  setFocusedSemanticItem: Dispatch<SetStateAction<PhysicsSemanticItem | null>>;
31
33
  setHoverData: Dispatch<SetStateAction<PhysicsHoverData | null>>;
@@ -61,6 +61,8 @@ export interface PipelineConfig {
61
61
  yScaleType?: "linear" | "log" | "symlog";
62
62
  xExtent?: [number | undefined, number | undefined] | [number];
63
63
  yExtent?: [number | undefined, number | undefined] | [number];
64
+ /** Reverse the resolved y domain, including domains derived from pushed data. */
65
+ invertY?: boolean;
64
66
  sizeRange?: [number, number];
65
67
  binSize?: number;
66
68
  normalize?: boolean;
@@ -87,6 +89,8 @@ export interface PipelineConfig {
87
89
  color: string;
88
90
  opacity?: number;
89
91
  }>;
92
+ /** Retain source rows for aggregate hover emission even without selection styling. */
93
+ trackHoverRows?: boolean;
90
94
  lineStyle?: Style | ((d: Datum, group?: string) => Style);
91
95
  pointStyle?: (d: Datum) => Style & {
92
96
  r?: number;
@@ -28,6 +28,6 @@ export declare class PipelineStoreUpdateResults {
28
28
  recordData(kind: DataChangeKind, count?: number): UpdateResult;
29
29
  recordNoop(kind: DataChangeKind | "restyle"): UpdateResult;
30
30
  recordRestyle(hasCustomRestyle: boolean): UpdateResult;
31
- recordConfig(keys: readonly string[]): UpdateResult;
31
+ recordConfig(keys: readonly string[], rebuildGeometry?: boolean): UpdateResult;
32
32
  }
33
33
  export {};
@@ -0,0 +1,13 @@
1
+ /** Resolve the same primary axes in live chrome, static SVG, and margin layout. */
2
+ export declare function resolveXYAxes<T extends {
3
+ orient?: string;
4
+ }>(axes?: readonly T[]): {
5
+ bottomAxis: T | undefined;
6
+ topAxis: T | undefined;
7
+ leftAxis: T | undefined;
8
+ rightAxis: T | undefined;
9
+ xAxis: T | undefined;
10
+ yAxis: T | undefined;
11
+ xOrient: "top" | "bottom";
12
+ yOrient: "left" | "right";
13
+ };
@@ -8,7 +8,7 @@ import * as React from "react";
8
8
  import type { DefaultArcObject } from "d3-shape";
9
9
  import { type HatchFill } from "../charts/shared/hatchFill";
10
10
  import type { GlyphDef } from "./glyphDef";
11
- import type { RectSceneNode, Style, SymbolSceneNode } from "./types";
11
+ import type { PointSceneNode, RectSceneNode, Style, SymbolSceneNode } from "./types";
12
12
  import type { GradientStop } from "../charts/shared/gradient";
13
13
  /**
14
14
  * Sentinel arg for d3-shape arc generators that have all four
@@ -76,3 +76,4 @@ export declare function perCornerSvgPath(n: RectSceneNode): string;
76
76
  * unfilled in SSR too).
77
77
  */
78
78
  export declare function symbolSceneNodeToSVG(n: SymbolSceneNode, i: number, idPrefix?: string): React.ReactNode;
79
+ export declare function pointOrRectSceneNodeToSVG(n: PointSceneNode | RectSceneNode, i: number, idPrefix?: string): React.ReactNode;
@@ -0,0 +1,13 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { StreamScales } from "./types";
3
+ /**
4
+ * Project, filter, and sort vertices with their source rows as one operation.
5
+ * Lines, areas, and ribbons must share this invariant: datum[i] describes the
6
+ * same observation as path[i], including with descending scales.
7
+ */
8
+ export declare function buildSeriesGeometry(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, bottomGet?: (d: Datum) => number): {
9
+ topPath: [number, number][];
10
+ bottomPath: [number, number][];
11
+ rawValues: number[];
12
+ datum: Datum[];
13
+ };
@@ -0,0 +1,2 @@
1
+ /** Shared pure equality for frame configs and retained custom-layout inputs. */
2
+ export declare function shallowEqualTwoLevel(a: unknown, b: unknown): boolean;
@@ -0,0 +1,53 @@
1
+ export interface DecayConfig {
2
+ type: "linear" | "exponential" | "step";
3
+ /** Exponential: half-life in buffer positions (default: bufferSize/2) */
4
+ halfLife?: number;
5
+ /** Minimum opacity floor (default: 0.1) */
6
+ minOpacity?: number;
7
+ /** Step: positions from newest before fading (default: bufferSize*0.5) */
8
+ stepThreshold?: number;
9
+ }
10
+ export interface PulseConfig {
11
+ /** Duration of the pulse glow in ms (default: 500) */
12
+ duration?: number;
13
+ /** Glow color (default: "rgba(255,255,255,0.6)") */
14
+ color?: string;
15
+ /** Extra px radius for glow ring on points (default: 4) */
16
+ glowRadius?: number;
17
+ }
18
+ export interface TransitionConfig {
19
+ /** Animation duration in ms (default: 300) */
20
+ duration?: number;
21
+ /** Easing function (default: "ease-out") */
22
+ easing?: "ease-out" | "linear";
23
+ }
24
+ export interface StalenessConfig {
25
+ /**
26
+ * ms without data before "stale" (default: 5000). In graded mode this
27
+ * is the base TTL the lifecycle bands are measured against — `aging`
28
+ * begins here, `stale` at 1.5×, `expired` at 3× (overridable).
29
+ */
30
+ threshold?: number;
31
+ /** Canvas alpha when stale, binary mode (default: 0.5) */
32
+ dimOpacity?: number;
33
+ /** Render LIVE/STALE badge (default: false) */
34
+ showBadge?: boolean;
35
+ /** Badge position (default: "top-right") */
36
+ badgePosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
37
+ /**
38
+ * Opt into graded (banded) staleness. Instead of a single live→stale
39
+ * flip at `threshold`, frames that support graded staleness dim
40
+ * progressively through fresh → aging → stale → expired as idle time
41
+ * crosses multiples of `threshold`, sharing one schedule with per-datum
42
+ * decay and annotation freshness. (Currently honored by `StreamXYFrame`,
43
+ * which backs the realtime XY charts; other frames treat it as binary.)
44
+ * `true` uses the default per-band opacities; pass an object to override
45
+ * the band thresholds or opacities.
46
+ */
47
+ graded?: boolean | {
48
+ /** Multiples of `threshold` marking each band edge (see LifecycleBandThresholds). */
49
+ thresholds?: import("../realtime/lifecycleBands").LifecycleBandThresholds;
50
+ /** Per-band canvas alpha override. Missing bands use the defaults. */
51
+ opacities?: Partial<Record<import("../realtime/lifecycleBands").LifecycleBand, number>>;
52
+ };
53
+ }
@@ -17,61 +17,10 @@ import type { AccessibleTableProp } from "./accessibleTableTypes";
17
17
  export type { SceneRenderBackend, SceneRenderMode } from "./sceneRenderBackendTypes";
18
18
  export type { ThemeSemanticColors } from "./streamThemeTypes";
19
19
  export type { AxisTickFormat, AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
20
+ import type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
21
+ export type { DecayConfig, PulseConfig, StalenessConfig, TransitionConfig } from "./streamEncodingTypes";
20
22
  export type SceneDatum = Datum | null;
21
23
  export type SeriesDatum = Datum[] | null;
22
- export interface DecayConfig {
23
- type: "linear" | "exponential" | "step";
24
- /** Exponential: half-life in buffer positions (default: bufferSize/2) */
25
- halfLife?: number;
26
- /** Minimum opacity floor (default: 0.1) */
27
- minOpacity?: number;
28
- /** Step: positions from newest before fading (default: bufferSize*0.5) */
29
- stepThreshold?: number;
30
- }
31
- export interface PulseConfig {
32
- /** Duration of the pulse glow in ms (default: 500) */
33
- duration?: number;
34
- /** Glow color (default: "rgba(255,255,255,0.6)") */
35
- color?: string;
36
- /** Extra px radius for glow ring on points (default: 4) */
37
- glowRadius?: number;
38
- }
39
- export interface TransitionConfig {
40
- /** Animation duration in ms (default: 300) */
41
- duration?: number;
42
- /** Easing function (default: "ease-out") */
43
- easing?: "ease-out" | "linear";
44
- }
45
- export interface StalenessConfig {
46
- /**
47
- * ms without data before "stale" (default: 5000). In graded mode this
48
- * is the base TTL the lifecycle bands are measured against — `aging`
49
- * begins here, `stale` at 1.5×, `expired` at 3× (overridable).
50
- */
51
- threshold?: number;
52
- /** Canvas alpha when stale, binary mode (default: 0.5) */
53
- dimOpacity?: number;
54
- /** Render LIVE/STALE badge (default: false) */
55
- showBadge?: boolean;
56
- /** Badge position (default: "top-right") */
57
- badgePosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
58
- /**
59
- * Opt into graded (banded) staleness. Instead of a single live→stale
60
- * flip at `threshold`, frames that support graded staleness dim
61
- * progressively through fresh → aging → stale → expired as idle time
62
- * crosses multiples of `threshold`, sharing one schedule with per-datum
63
- * decay and annotation freshness. (Currently honored by `StreamXYFrame`,
64
- * which backs the realtime XY charts; other frames treat it as binary.)
65
- * `true` uses the default per-band opacities; pass an object to override
66
- * the band thresholds or opacities.
67
- */
68
- graded?: boolean | {
69
- /** Multiples of `threshold` marking each band edge (see LifecycleBandThresholds). */
70
- thresholds?: import("../realtime/lifecycleBands").LifecycleBandThresholds;
71
- /** Per-band canvas alpha override. Missing bands use the defaults. */
72
- opacities?: Partial<Record<import("../realtime/lifecycleBands").LifecycleBand, number>>;
73
- };
74
- }
75
24
  export type MarginalType = "histogram" | "violin" | "ridgeline" | "boxplot";
76
25
  export interface MarginalConfig {
77
26
  type: MarginalType;
@@ -700,6 +649,8 @@ export interface StreamXYFrameProps<T = Datum> extends StreamSemanticInteraction
700
649
  yScaleType?: "linear" | "log" | "symlog";
701
650
  xExtent?: [number | undefined, number | undefined] | [number];
702
651
  yExtent?: [number | undefined, number | undefined] | [number];
652
+ /** Reverse the resolved y domain, including domains derived from pushed data. */
653
+ invertY?: boolean;
703
654
  extentPadding?: number;
704
655
  /** Pixel inset on scale ranges to prevent glyph clipping at chart edges. Default 0. */
705
656
  scalePadding?: number;
@@ -1,4 +1,4 @@
1
- import { type MutableRefObject } from "react";
1
+ import { type MutableRefObject, type RefObject } from "react";
2
2
  import type { StreamChartType } from "./types";
3
3
  /**
4
4
  * Keep LineChart's static graph free of candlestick/heatmap/bar, while
@@ -15,4 +15,6 @@ import type { StreamChartType } from "./types";
15
15
  * transition/restyle/pulse/resolution change). `scheduleRender` alone
16
16
  * after the first frame is not enough.
17
17
  */
18
- export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void): void;
18
+ export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void, storeRef: RefObject<{
19
+ markStylePaintPending(): void;
20
+ } | null>): void;
@@ -0,0 +1,16 @@
1
+ import { type MutableRefObject, type Ref } from "react";
2
+ import { type ZoomBehavior, type ZoomTransform } from "d3-zoom";
3
+ import type { GeoPipelineStore } from "./GeoPipelineStore";
4
+ import type { StreamGeoFrameHandle } from "./geoTypes";
5
+ import type { GeoZoomControlBehavior } from "./geoFrameHelpers";
6
+ interface GeoFrameHandleOptions {
7
+ storeRef: MutableRefObject<GeoPipelineStore | null>;
8
+ dirtyRef: MutableRefObject<boolean>;
9
+ scheduleRender: () => void;
10
+ zoomTransformRef: MutableRefObject<ZoomTransform>;
11
+ containerRef: MutableRefObject<HTMLDivElement | null>;
12
+ zoomBehaviorRef: MutableRefObject<ZoomBehavior<HTMLDivElement, unknown> | GeoZoomControlBehavior | null>;
13
+ }
14
+ /** Imperative data and zoom controls, independent of canvas rendering. */
15
+ export declare function useGeoFrameHandle(ref: Ref<StreamGeoFrameHandle>, { storeRef, dirtyRef, scheduleRender, zoomTransformRef, containerRef, zoomBehaviorRef }: GeoFrameHandleOptions): void;
16
+ export {};
@@ -0,0 +1,15 @@
1
+ import { type MutableRefObject, type Ref } from "react";
2
+ import type { DataSourceAdapter } from "./DataSourceAdapter";
3
+ import type { OrdinalPipelineStore } from "./OrdinalPipelineStore";
4
+ import type { HoverData, StreamOrdinalFrameHandle } from "./ordinalTypes";
5
+ interface OrdinalFrameHandleOptions {
6
+ storeRef: MutableRefObject<OrdinalPipelineStore | null>;
7
+ adapterRef: MutableRefObject<DataSourceAdapter | null>;
8
+ dirtyRef: MutableRefObject<boolean>;
9
+ scheduleRender: () => void;
10
+ hoverRef: MutableRefObject<HoverData | null>;
11
+ setHoverPoint: (hover: HoverData | null) => void;
12
+ }
13
+ /** Keep imperative data mutations separate from the frame's render lifecycle. */
14
+ export declare function useOrdinalFrameHandle(ref: Ref<StreamOrdinalFrameHandle>, { storeRef, adapterRef, dirtyRef, scheduleRender, hoverRef, setHoverPoint }: OrdinalFrameHandleOptions): void;
15
+ export {};
@@ -0,0 +1,15 @@
1
+ import { type MutableRefObject, type Ref } from "react";
2
+ import type { DataSourceAdapter } from "./DataSourceAdapter";
3
+ import type { PipelineStore } from "./PipelineStore";
4
+ import type { HoverData, StreamXYFrameHandle } from "./types";
5
+ interface XYFrameHandleOptions {
6
+ storeRef: MutableRefObject<PipelineStore | null>;
7
+ adapterRef: MutableRefObject<DataSourceAdapter | null>;
8
+ dirtyRef: MutableRefObject<boolean>;
9
+ scheduleRender: () => void;
10
+ hoverRef: MutableRefObject<HoverData | null>;
11
+ setHoverPoint: (hover: HoverData | null) => void;
12
+ }
13
+ /** Keep imperative data mutations separate from the frame's render lifecycle. */
14
+ export declare function useXYFrameHandle(ref: Ref<StreamXYFrameHandle>, { storeRef, adapterRef, dirtyRef, scheduleRender, hoverRef, setHoverPoint }: XYFrameHandleOptions): void;
15
+ export {};
@@ -0,0 +1,25 @@
1
+ import type { ReactNode } from "react";
2
+ import { type AxisExtentMode } from "../charts/shared/axisExtent";
3
+ import type { AxisTickFormatter, XYFrameAxisConfig } from "./xyFrameAxisTypes";
4
+ export interface AxisTick {
5
+ value: number | Date;
6
+ pixel: number;
7
+ label: ReactNode;
8
+ }
9
+ type AxisScale = {
10
+ (value: number | Date): number;
11
+ domain(): (number | Date)[];
12
+ ticks(count?: number): (number | Date)[];
13
+ };
14
+ /** Use actual neighboring gaps: log scales and explicit ticks need not fill the axis. */
15
+ export declare function axisTicksNeedRotation(ticks: AxisTick[]): boolean;
16
+ /** Shared tick selection for live axes, canvas underlays, and static exports. */
17
+ export declare function generateXYTicks(options: {
18
+ scale: AxisScale;
19
+ axis?: XYFrameAxisConfig;
20
+ size: number;
21
+ horizontal?: boolean;
22
+ format?: AxisTickFormatter;
23
+ axisExtent?: AxisExtentMode;
24
+ }): AxisTick[];
25
+ export {};
@@ -2,8 +2,9 @@
2
2
  * Auto date tick formatting for StreamXYFrame time scales.
3
3
  * UTC getters keep SSR and client labels identical across timezones.
4
4
  */
5
+ export declare function formatDateMonthDay(value: number | Date | string): string;
5
6
  /**
6
7
  * Build a tick formatter for a numeric time domain (ms since epoch).
7
- * Span-based resolution: hours → day-month → month-year → year.
8
+ * Span-based resolution: milliseconds → seconds → hours → day-month → month-year → year.
8
9
  */
9
- export declare function makeDateTickFormatter(domain: [number, number]): (v: number) => string;
10
+ export declare function makeDateTickFormatter(domain: [number, number]): (v: number | Date | string) => string;
@@ -23,6 +23,8 @@ export interface AxisLineStyle {
23
23
  */
24
24
  export interface XYFrameAxisConfig {
25
25
  orient: "left" | "right" | "top" | "bottom";
26
+ /** Hide this axis, including baseline, ticks, and label. Grid is independent. */
27
+ visible?: boolean;
26
28
  label?: string;
27
29
  ticks?: number;
28
30
  /** Compatibility alias for `ticks`; `ticks` wins when both are supplied. */
@@ -64,7 +64,7 @@ export interface ResolvedRibbon {
64
64
  *
65
65
  * Iterates the data once, evaluates `getTop`/`getBottom` per datum, and
66
66
  * collects coordinate pairs. Any datum with non-finite x, top, or bottom
67
- * is skipped (gap semantics — equivalent to `gapStrategy: "break"`).
67
+ * is omitted. Remaining vertices stay connected; this is not a gap break.
68
68
  * Returns `null` when fewer than two valid points remain (a single
69
69
  * point can't form a visible ribbon).
70
70
  */
@@ -84,6 +84,7 @@ export interface XYSceneConfig {
84
84
  showValues?: boolean;
85
85
  heatmapValueFormat?: (v: number) => string;
86
86
  heatmapColorScale?: (value: number) => string;
87
+ trackHoverRows?: boolean;
87
88
  binSize?: number;
88
89
  barColors?: Record<string, string>;
89
90
  /** Bar fill/stroke/strokeWidth/gap. Threaded through from RealtimeHistogram. */