semiotic 3.9.2 → 3.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (452) hide show
  1. package/README.md +99 -74
  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/dist/mcp-server.js +68 -68
  8. package/ai/examples.md +1 -1
  9. package/ai/reference.md +31 -14
  10. package/ai/schema.json +1868 -438
  11. package/ai/surface-manifest.json +11 -4
  12. package/ai/system-prompt.md +2 -0
  13. package/ai/task-packets/compare-category-totals.json +301 -0
  14. package/ai/task-packets/compare-category-totals.md +188 -0
  15. package/ai/task-packets/correct-published-chart.json +271 -0
  16. package/ai/task-packets/correct-published-chart.md +597 -0
  17. package/ai/task-packets/index.json +40 -0
  18. package/ai/task-packets/update-live-chart.json +289 -0
  19. package/ai/task-packets/update-live-chart.md +424 -0
  20. package/dist/c-2N7IU2NY.min.js +1 -0
  21. package/dist/c-2WK7YJLL.min.js +1 -0
  22. package/dist/c-33QOXEUG.min.js +1 -0
  23. package/dist/c-42PLDTX7.min.js +1 -0
  24. package/dist/c-447VIMRO.min.js +1 -0
  25. package/dist/c-4FN7Q6VQ.min.js +1 -0
  26. package/dist/c-553QUDKA.min.js +1 -0
  27. package/dist/c-55BAJ333.min.js +1 -0
  28. package/dist/c-7242NXSG.min.js +1 -0
  29. package/dist/c-7EGHJU2F.min.js +1 -0
  30. package/dist/c-7HP7MB2I.min.js +1 -0
  31. package/dist/c-7NBU5ZKS.min.js +1 -0
  32. package/dist/c-AFBSWT77.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-AZKPVBOC.min.js +1 -0
  38. package/dist/c-BNFJMDHN.min.js +1 -0
  39. package/dist/c-BNG5ECK5.min.js +1 -0
  40. package/dist/c-BOHCQILI.min.js +1 -0
  41. package/dist/c-CCTGN5CK.min.js +1 -0
  42. package/dist/c-CPSPZH6A.min.js +1 -0
  43. package/dist/c-CPV4N35K.min.js +1 -0
  44. package/dist/c-D6HAAPTX.min.js +1 -0
  45. package/dist/c-DE5Q3U2X.min.js +1 -0
  46. package/dist/c-DK662R77.min.js +1 -0
  47. package/dist/c-DY2676CR.min.js +1 -0
  48. package/dist/c-E32M6XW5.min.js +1 -0
  49. package/dist/c-E4JDJH4I.min.js +1 -0
  50. package/dist/c-E7I2L7CU.min.js +1 -0
  51. package/dist/c-EBOQ7ER7.min.js +1 -0
  52. package/dist/c-ELDWAO2V.min.js +1 -0
  53. package/dist/c-EUBTECGM.min.js +1 -0
  54. package/dist/c-GNTXRXRN.min.js +1 -0
  55. package/dist/c-GSZRZRD6.min.js +1 -0
  56. package/dist/c-GWX7JGMF.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-HPOYKCCG.min.js +1 -0
  61. package/dist/c-HXDKPIKR.min.js +1 -0
  62. package/dist/c-I4QJ6YLM.min.js +1 -0
  63. package/dist/c-IDJV3CZK.min.js +1 -0
  64. package/dist/c-ITKX3RC5.min.js +1 -0
  65. package/dist/c-JG2JCQLP.min.js +1 -0
  66. package/dist/c-JLGRHXGZ.min.js +1 -0
  67. package/dist/c-JO2UGTCP.min.js +1 -0
  68. package/dist/c-JUKIWTBJ.min.js +1 -0
  69. package/dist/c-KCRJGUHP.min.js +1 -0
  70. package/dist/c-LMGSSD2E.min.js +1 -0
  71. package/dist/c-LYQMZMZQ.min.js +1 -0
  72. package/dist/c-LYVKDBQJ.min.js +1 -0
  73. package/dist/c-MVR3RWF3.min.js +1 -0
  74. package/dist/c-MXCP7GNZ.min.js +1 -0
  75. package/dist/c-NG7BLZTR.min.js +1 -0
  76. package/dist/c-NYZ2QNAM.min.js +1 -0
  77. package/dist/c-OO5QLMJC.min.js +1 -0
  78. package/dist/c-OOVX2JPQ.min.js +1 -0
  79. package/dist/c-ORLEBW72.min.js +1 -0
  80. package/dist/c-P65V6HLO.min.js +1 -0
  81. package/dist/c-PP6VY3QU.min.js +1 -0
  82. package/dist/c-PRIKOLTE.min.js +1 -0
  83. package/dist/c-PSNI6KAZ.min.js +1 -0
  84. package/dist/c-PYNW54D2.min.js +1 -0
  85. package/dist/c-QA3HMQJP.min.js +1 -0
  86. package/dist/c-ROEHCIGV.min.js +1 -0
  87. package/dist/c-S3AZX5PP.min.js +1 -0
  88. package/dist/c-T2V7O2LO.min.js +1 -0
  89. package/dist/c-TIXX5CAU.min.js +1 -0
  90. package/dist/c-TKG2NP7G.min.js +1 -0
  91. package/dist/c-VJTDST2R.min.js +1 -0
  92. package/dist/c-VXLOLYTO.min.js +1 -0
  93. package/dist/c-W4ZUKSEQ.min.js +1 -0
  94. package/dist/c-WH2O53VI.min.js +1 -0
  95. package/dist/c-WNGH47HF.min.js +1 -0
  96. package/dist/c-WUWXGQYA.min.js +1 -0
  97. package/dist/c-XDQKXPX4.min.js +1 -0
  98. package/dist/{c-CKLIFCGN.min.js → c-XSB27XPS.min.js} +1 -1
  99. package/dist/c-YDECTEUW.min.js +1 -0
  100. package/dist/c-YF3YKVQI.min.js +1 -0
  101. package/dist/c-YLZIV3VS.min.js +1 -0
  102. package/dist/c-ZYPXQF7B.min.js +1 -0
  103. package/dist/components/Annotation.d.ts +2 -1
  104. package/dist/components/ai/chartRecipeRegistry.d.ts +6 -1
  105. package/dist/components/ai/chartRecipes.d.ts +4 -0
  106. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  107. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  108. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  109. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  110. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  111. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  112. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  113. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  114. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  115. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  116. package/dist/components/artifact/claimGraph.d.ts +5 -0
  117. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  118. package/dist/components/artifact/claims.d.ts +24 -0
  119. package/dist/components/artifact/collection.d.ts +10 -0
  120. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  121. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  122. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  123. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  124. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  125. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  126. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  127. package/dist/components/artifact/contract.d.ts +30 -0
  128. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  129. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  130. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  131. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  132. package/dist/components/artifact/exportPaths.d.ts +8 -0
  133. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  134. package/dist/components/artifact/fingerprint.d.ts +36 -0
  135. package/dist/components/artifact/grounding.d.ts +51 -0
  136. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  137. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  138. package/dist/components/artifact/identity.d.ts +19 -0
  139. package/dist/components/artifact/inheritance.d.ts +48 -0
  140. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  141. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  142. package/dist/components/artifact/obligations.d.ts +3 -0
  143. package/dist/components/artifact/policies.d.ts +45 -0
  144. package/dist/components/artifact/policyRelations.d.ts +3 -0
  145. package/dist/components/artifact/recordProjection.d.ts +7 -0
  146. package/dist/components/artifact/representation.d.ts +50 -0
  147. package/dist/components/artifact/serialization.d.ts +40 -0
  148. package/dist/components/artifact/temporal.d.ts +32 -0
  149. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  150. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  151. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  152. package/dist/components/artifact/types.d.ts +341 -0
  153. package/dist/components/artifact/validation.d.ts +13 -0
  154. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  155. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  156. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  157. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  158. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  159. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  160. package/dist/components/charts/ordinal/DonutChart.d.ts +2 -0
  161. package/dist/components/charts/ordinal/FunnelChart.d.ts +2 -0
  162. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  163. package/dist/components/charts/ordinal/PieChart.d.ts +2 -0
  164. package/dist/components/charts/ordinal/RadarChart.d.ts +2 -0
  165. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  166. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  167. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  168. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  169. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  170. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  171. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  172. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  173. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  174. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  175. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  176. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  177. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  178. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  179. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  180. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  181. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  182. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  183. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  184. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  185. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +4 -0
  186. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +14 -6
  187. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +4 -0
  188. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +4 -0
  189. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +4 -0
  190. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  191. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -7
  192. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  193. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  194. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  195. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  196. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  197. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  198. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  199. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  200. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  201. package/dist/components/charts/shared/useChartLegend.d.ts +4 -0
  202. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  203. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  204. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  205. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  206. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  207. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  208. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  209. package/dist/components/charts/xy/WaterfallChart.d.ts +8 -0
  210. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  211. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  212. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  213. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +16 -8
  214. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  215. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  216. package/dist/components/evidence/evidenceGate.d.ts +3 -1
  217. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  218. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  219. package/dist/components/export/chartConfig.d.ts +40 -5
  220. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  221. package/dist/components/legendLayout.d.ts +18 -0
  222. package/dist/components/legendStyles.d.ts +4 -0
  223. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  224. package/dist/components/recipes/intervals.d.ts +1 -1
  225. package/dist/components/semiotic-ai-core.d.ts +33 -22
  226. package/dist/components/semiotic-ai.d.ts +15 -3
  227. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  228. package/dist/components/semiotic-artifact.d.ts +23 -0
  229. package/dist/components/semiotic-experimental.d.ts +1 -1
  230. package/dist/components/semiotic-physics.d.ts +4 -4
  231. package/dist/components/semiotic-text.d.ts +2 -0
  232. package/dist/components/semiotic-utils-core.d.ts +18 -18
  233. package/dist/components/semiotic.d.ts +3 -3
  234. package/dist/components/server/renderEvidence.d.ts +12 -0
  235. package/dist/components/server/renderToStaticSVG.d.ts +3 -0
  236. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  237. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  238. package/dist/components/server/staticXYGrid.d.ts +1 -1
  239. package/dist/components/server/svgSizing.d.ts +6 -0
  240. package/dist/components/shared/svgRoot.d.ts +17 -0
  241. package/dist/components/store/selectionProvenance.d.ts +6 -0
  242. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  243. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  244. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  245. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  246. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  247. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  248. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  249. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  250. package/dist/components/stream/XYGrid.d.ts +11 -0
  251. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  252. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  253. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  254. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  255. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  256. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  257. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  258. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +3 -0
  259. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  260. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  261. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  262. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  263. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  264. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  265. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  266. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  267. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  268. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  269. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  270. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  271. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  272. package/dist/components/stream/types.d.ts +4 -53
  273. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  274. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  275. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  276. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  277. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  278. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  279. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  280. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  281. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  282. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  283. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  284. package/dist/controls.module.min.js +1 -1
  285. package/dist/geo.min.js +1 -1
  286. package/dist/geo.module.min.js +1 -1
  287. package/dist/network.module.min.js +1 -1
  288. package/dist/ordinal.module.min.js +1 -1
  289. package/dist/physics-matter.min.js +1 -1
  290. package/dist/physics-matter.module.min.js +1 -1
  291. package/dist/physics-rapier.min.js +1 -1
  292. package/dist/physics-rapier.module.min.js +1 -1
  293. package/dist/physics.module.min.js +1 -1
  294. package/dist/physicsWorker.js +1 -1
  295. package/dist/processSankeyLayoutWorker.js +1 -1
  296. package/dist/rough.min.js +1 -1
  297. package/dist/rough.module.min.js +1 -1
  298. package/dist/semiotic-access.module.min.js +1 -1
  299. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  300. package/dist/semiotic-ai-core.d.ts +33 -22
  301. package/dist/semiotic-ai-core.min.js +1 -1
  302. package/dist/semiotic-ai-core.module.min.js +1 -1
  303. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  304. package/dist/semiotic-ai.d.ts +15 -3
  305. package/dist/semiotic-ai.module.min.js +1 -1
  306. package/dist/semiotic-artifact-react.d.ts +10 -0
  307. package/dist/semiotic-artifact-react.min.js +2 -0
  308. package/dist/semiotic-artifact-react.module.min.js +2 -0
  309. package/dist/semiotic-artifact.d.ts +23 -0
  310. package/dist/semiotic-artifact.min.js +1 -0
  311. package/dist/semiotic-artifact.module.min.js +1 -0
  312. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  313. package/dist/semiotic-client-glyph.module.min.js +1 -1
  314. package/dist/semiotic-client-responsive.module.min.js +1 -1
  315. package/dist/semiotic-client-shared.module.min.js +1 -1
  316. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  317. package/dist/semiotic-data.min.js +1 -1
  318. package/dist/semiotic-data.module.min.js +1 -1
  319. package/dist/semiotic-evidence.min.js +1 -1
  320. package/dist/semiotic-evidence.module.min.js +1 -1
  321. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  322. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  323. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  324. package/dist/semiotic-experimental-vacp.min.js +1 -1
  325. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  326. package/dist/semiotic-experimental.d.ts +1 -1
  327. package/dist/semiotic-line.module.min.js +1 -1
  328. package/dist/semiotic-physics.d.ts +4 -4
  329. package/dist/semiotic-realtime-core.module.min.js +1 -1
  330. package/dist/semiotic-realtime-react.module.min.js +1 -1
  331. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  332. package/dist/semiotic-recipes-core.module.min.js +1 -1
  333. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  334. package/dist/semiotic-recipes-react.min.js +1 -1
  335. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  336. package/dist/semiotic-server-edge.min.js +1 -1
  337. package/dist/semiotic-server-edge.module.min.js +1 -1
  338. package/dist/semiotic-server-node.min.js +1 -1
  339. package/dist/semiotic-server-node.module.min.js +1 -1
  340. package/dist/semiotic-text.d.ts +2 -0
  341. package/dist/semiotic-text.min.js +2 -0
  342. package/dist/semiotic-text.module.min.js +2 -0
  343. package/dist/semiotic-themes-core.min.js +1 -1
  344. package/dist/semiotic-themes-core.module.min.js +1 -1
  345. package/dist/semiotic-themes.min.js +1 -1
  346. package/dist/semiotic-themes.module.min.js +1 -1
  347. package/dist/semiotic-utils-core.d.ts +18 -18
  348. package/dist/semiotic-utils-core.min.js +1 -1
  349. package/dist/semiotic-utils-core.module.min.js +1 -1
  350. package/dist/semiotic-value.module.min.js +1 -1
  351. package/dist/semiotic.d.ts +3 -3
  352. package/dist/semiotic.module.min.js +1 -1
  353. package/dist/server.min.js +1 -1
  354. package/dist/server.module.min.js +1 -1
  355. package/dist/xy.module.min.js +1 -1
  356. package/package.json +55 -14
  357. package/spec/README.md +8 -3
  358. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  359. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  360. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  361. package/dist/c-3BLJEQNG.min.js +0 -1
  362. package/dist/c-3SCUN5HI.min.js +0 -1
  363. package/dist/c-3VVKFA4M.min.js +0 -1
  364. package/dist/c-43TJZS3F.min.js +0 -1
  365. package/dist/c-4DTZPSUD.min.js +0 -1
  366. package/dist/c-4ES5367Y.min.js +0 -1
  367. package/dist/c-52TEGIUJ.min.js +0 -1
  368. package/dist/c-54IRWOGM.min.js +0 -1
  369. package/dist/c-5D2S4RMI.min.js +0 -1
  370. package/dist/c-5JWCTX3G.min.js +0 -1
  371. package/dist/c-6CMMSN6N.min.js +0 -1
  372. package/dist/c-6HRB2L7H.min.js +0 -1
  373. package/dist/c-6O5EVOPH.min.js +0 -1
  374. package/dist/c-7W4SV36A.min.js +0 -1
  375. package/dist/c-A4WRGZFX.min.js +0 -1
  376. package/dist/c-AG7WWVIH.min.js +0 -1
  377. package/dist/c-AH6J4MTN.min.js +0 -1
  378. package/dist/c-AKAF6JAD.min.js +0 -1
  379. package/dist/c-ALYR5LKK.min.js +0 -1
  380. package/dist/c-BBKITSXB.min.js +0 -1
  381. package/dist/c-BYDPC44I.min.js +0 -1
  382. package/dist/c-CFFIU2MW.min.js +0 -1
  383. package/dist/c-CGNHBHCE.min.js +0 -1
  384. package/dist/c-CJYSXIFV.min.js +0 -1
  385. package/dist/c-CZF7MV67.min.js +0 -1
  386. package/dist/c-D53OKBSY.min.js +0 -1
  387. package/dist/c-DADXPJXV.min.js +0 -1
  388. package/dist/c-DBQ2V7CH.min.js +0 -1
  389. package/dist/c-DPMVAUAW.min.js +0 -1
  390. package/dist/c-ECJCKLYY.min.js +0 -1
  391. package/dist/c-EGATGOWJ.min.js +0 -1
  392. package/dist/c-EGR6VYBW.min.js +0 -1
  393. package/dist/c-ESNR43AN.min.js +0 -1
  394. package/dist/c-F3LIKINL.min.js +0 -1
  395. package/dist/c-F5ZB5GJ6.min.js +0 -1
  396. package/dist/c-G36WS6LN.min.js +0 -1
  397. package/dist/c-G3VYMHKE.min.js +0 -1
  398. package/dist/c-GGISSW5E.min.js +0 -1
  399. package/dist/c-GR6MOEQC.min.js +0 -1
  400. package/dist/c-GSVCN34B.min.js +0 -1
  401. package/dist/c-GYOQCEFP.min.js +0 -1
  402. package/dist/c-H3DNMTCC.min.js +0 -1
  403. package/dist/c-I6J3FEZE.min.js +0 -1
  404. package/dist/c-IGH6MGJ5.min.js +0 -1
  405. package/dist/c-II2EEAJN.min.js +0 -1
  406. package/dist/c-IUHFPMHD.min.js +0 -1
  407. package/dist/c-J6M4JHRS.min.js +0 -1
  408. package/dist/c-JM3MGLQV.min.js +0 -1
  409. package/dist/c-KM3N7F7R.min.js +0 -1
  410. package/dist/c-LF5BZFNC.min.js +0 -1
  411. package/dist/c-LKBSGFQC.min.js +0 -1
  412. package/dist/c-MNF2S4AA.min.js +0 -1
  413. package/dist/c-MT3WBK7M.min.js +0 -1
  414. package/dist/c-NDJADPIF.min.js +0 -1
  415. package/dist/c-NVPQCIL5.min.js +0 -1
  416. package/dist/c-NY3JWV2K.min.js +0 -1
  417. package/dist/c-OFWJBEE5.min.js +0 -1
  418. package/dist/c-OYFHP5F5.min.js +0 -1
  419. package/dist/c-PGKQGGQ2.min.js +0 -1
  420. package/dist/c-PPWDL5ZI.min.js +0 -1
  421. package/dist/c-Q2IPZ3MU.min.js +0 -1
  422. package/dist/c-QKHMBE2E.min.js +0 -1
  423. package/dist/c-QMVM3AY6.min.js +0 -1
  424. package/dist/c-QSGWX53A.min.js +0 -1
  425. package/dist/c-RJKEKZOO.min.js +0 -1
  426. package/dist/c-RSVIHIQ4.min.js +0 -1
  427. package/dist/c-S6U5CGT5.min.js +0 -1
  428. package/dist/c-SFDIIU5G.min.js +0 -1
  429. package/dist/c-SLGMUBUL.min.js +0 -1
  430. package/dist/c-SRTBCRVE.min.js +0 -1
  431. package/dist/c-T6UAIKBH.min.js +0 -1
  432. package/dist/c-TMCTEVVW.min.js +0 -1
  433. package/dist/c-TMOSJLT3.min.js +0 -1
  434. package/dist/c-TZW3JGJ5.min.js +0 -1
  435. package/dist/c-U6ESPM7V.min.js +0 -1
  436. package/dist/c-UC5PTTFI.min.js +0 -1
  437. package/dist/c-USFMFKIH.min.js +0 -1
  438. package/dist/c-VGKUEZBC.min.js +0 -1
  439. package/dist/c-VGW3VG3I.min.js +0 -1
  440. package/dist/c-VN2HG5BS.min.js +0 -1
  441. package/dist/c-VPZDY5Q4.min.js +0 -1
  442. package/dist/c-VRXUB2F2.min.js +0 -1
  443. package/dist/c-VUBQNQJH.min.js +0 -1
  444. package/dist/c-VUH4PGZY.min.js +0 -1
  445. package/dist/c-W3CE4A4S.min.js +0 -1
  446. package/dist/c-X5UBGU2V.min.js +0 -1
  447. package/dist/c-XDRV7RKW.min.js +0 -1
  448. package/dist/c-YGZHURXZ.min.js +0 -1
  449. package/dist/c-YZVRZGX2.min.js +0 -1
  450. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  451. /package/dist/{c-ENF72HU5.min.js → c-QAVFOEUY.min.js} +0 -0
  452. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -13,7 +13,7 @@ import { resolveGauntletTerminalState, resolveGauntletTerminalStates } from "./c
13
13
  import { PacketFlowChart, PhysicalFlowChart } from "./charts/physics/PacketFlowChart";
14
14
  import { ProcessFlowChart } from "./charts/physics/ProcessFlowChart";
15
15
  import { physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems } from "./charts/physics/physicsProcessPrimitives";
16
- import { buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics } from "./charts/physics/physicsChartUtils";
16
+ import { buildCollisionSwarmPhysics, buildEventDropPhysics, readEventDropOccupancy, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics } from "./charts/physics/physicsChartUtils";
17
17
  import StreamPhysicsFrame, { StreamPhysicsFrame as NamedStreamPhysicsFrame } from "./stream/physics/StreamPhysicsFrame";
18
18
  import { Tooltip, TooltipRoot, MultiLineTooltip, markTooltipChrome } from "./Tooltip/Tooltip";
19
19
  import { PhysicsPipelineStore } from "./stream/physics/PhysicsPipelineStore";
@@ -27,7 +27,7 @@ import { composePhysicsControllers, createCapacityQueueController, createPortalC
27
27
  import { createDependencyGateController, createServiceLevelController, createServiceResourcePoolController } from "./stream/physics/ServiceOperationsControllers";
28
28
  import { processChrome } from "./recipes/processChrome";
29
29
  import { absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, capacitatedRegion, chargeGateRegion, collidersFromScales, createProcessJourneyLedger, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, membraneRegion, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, routeSurfaceRegion, sedimentBake, spawnFromTokens, stageTargetInVolume, updateProcessJourney } from "./recipes/physics";
30
- export { BuiltInPhysicsEngineAdapter, CollisionSwarmChart, EventDropChart, GauntletChart, GaltonBoardChart, GuantletChart, PacketFlowChart, PhysicalFlowChart, PhysicsCustomChart, PhysicsPileChart, UnitPileChart, Tooltip, TooltipRoot, MultiLineTooltip, markTooltipChrome, PhysicsPipelineStore, PhysicsSedimentAccumulator, ProcessFlowChart, absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, buildCollisionSwarmPhysics, buildEventDropPhysics, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics, capacitatedRegion, chargeGateRegion, collidersFromScales, compilePhysicsEncoding, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createDefaultPhysicsEngineAdapter, createPortalController, createPhysicsEncodingLayout, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, evaluatePhysicsBodyBudget, processChrome, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, planGauntletPropertyWork, membraneRegion, physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, replaceGauntletNegative, resolveGauntletTerminalState, resolveGauntletTerminalStates, routeSurfaceRegion, sedimentBake, sedimentHeightfield, spawnFromTokens, stageTargetInVolume, updateProcessJourney, NamedStreamPhysicsFrame as StreamPhysicsFrame };
30
+ export { BuiltInPhysicsEngineAdapter, CollisionSwarmChart, EventDropChart, GauntletChart, GaltonBoardChart, GuantletChart, PacketFlowChart, PhysicalFlowChart, PhysicsCustomChart, PhysicsPileChart, UnitPileChart, Tooltip, TooltipRoot, MultiLineTooltip, markTooltipChrome, PhysicsPipelineStore, PhysicsSedimentAccumulator, ProcessFlowChart, absorbRegion, aggregateRegionCounts, arrivalReplay, bodyGroupSpec, buildCollisionSwarmPhysics, buildEventDropPhysics, readEventDropOccupancy, buildGaltonBoardPhysics, buildPhysicalFlowPhysics, buildPhysicsPile, buildProcessFlowPhysics, capacitatedRegion, chargeGateRegion, collidersFromScales, compilePhysicsEncoding, composePhysicsControllers, createCapacityQueueController, createDependencyGateController, createDefaultPhysicsEngineAdapter, createPortalController, createPhysicsEncodingLayout, createServiceLevelController, createServiceResourcePoolController, createProcessJourneyLedger, evaluatePhysicsBodyBudget, processChrome, forceFieldRegion, galtonPegs, groupCompletionRows, comparePhysicsTrace, planGauntletPropertyWork, membraneRegion, physicsProcessBoundaryColliders, physicsProcessGroupSemanticItems, physicsProcessRegionSemanticItem, physicsProcessStageSemanticItems, portalRegion, pressureFieldRegion, processLaneWalls, processJourneyRows, processStageLayout, describePhysicsStageGeography, physicsChargePoint, physicsDestination, physicsStageColliders, physicsStageGeography, processStageRegions, processVolumePolygons, physicsReferenceEnvelope, regionCountsToProjectionRows, replaceGauntletNegative, resolveGauntletTerminalState, resolveGauntletTerminalStates, routeSurfaceRegion, sedimentBake, sedimentHeightfield, spawnFromTokens, stageTargetInVolume, updateProcessJourney, NamedStreamPhysicsFrame as StreamPhysicsFrame };
31
31
  export default StreamPhysicsFrame;
32
32
  export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
33
33
  export type { CollisionSwarmChartProps } from "./charts/physics/CollisionSwarmChart";
@@ -43,7 +43,7 @@ export type { ProcessFlowChartProps, ProcessFlowProjectionMetadata, ProcessFlowS
43
43
  export type { PhysicsCustomChartProps, PhysicsCustomLayout, PhysicsCustomLayoutContext, PhysicsCustomLayoutResult, PhysicsCustomSpawnDatumResult } from "./charts/physics/PhysicsCustomChart";
44
44
  export type { UnitPileChartProps, PhysicsPileChartProps } from "./charts/physics/UnitPileChart";
45
45
  export type { CompilePhysicsEncodingOptions, CreatePhysicsEncodingLayoutOptions, PhysicsAccessibleEncoding, PhysicsAppearanceEncoding, PhysicsDynamicsEncoding, PhysicsEncoding, PhysicsEncodingAccessor, PhysicsEncodingCompilation, PhysicsEncodingConstant, PhysicsEncodingDefaults, PhysicsEncodingLayoutExtension, PhysicsKinematicsEncoding, PhysicsPlacementEncoding, PhysicsProcessEncoding, PhysicsTimeEncoding, ResolvedPhysicsEncodingRow } from "./charts/physics/physicsEncoding";
46
- export type { PhysicsChartLayout, CollisionSwarmPhysicsOptions, CollisionSwarmProjectionMetadata, EventDropWindowOptions, EventDropPhysicsOptions, GaltonBoardProjectionMetadata, GaltonBoardPhysicsOptions, PhysicalFlowCoordinateMode, PhysicalFlowOptions, PhysicalFlowPathConstraint, PhysicalFlowPoint, PhysicalFlowProjectionMetadata, PhysicalFlowRawPath, PhysicsPileOptions, ProcessFlowPhysicsOptions } from "./charts/physics/physicsChartUtils";
46
+ export type { PhysicsChartLayout, CollisionSwarmPhysicsOptions, CollisionSwarmProjectionMetadata, EventDropWindowOptions, EventDropProjectionMetadata, EventDropPhysicsOptions, GaltonBoardProjectionMetadata, GaltonBoardPhysicsOptions, PhysicalFlowCoordinateMode, PhysicalFlowOptions, PhysicalFlowPathConstraint, PhysicalFlowPoint, PhysicalFlowProjectionMetadata, PhysicalFlowRawPath, PhysicsPileOptions, ProcessFlowPhysicsOptions } from "./charts/physics/physicsChartUtils";
47
47
  export type { CapacityQueueAbandonedInfo, CapacityQueueAgeSummary, CapacityQueueBlockedInfo, CapacityQueueControllerOptions, CapacityQueueProcessedInfo, CapacityQueueSnapshot, CapacityQueueVisitInfo, CapacityQueueWindowSnapshot, ComposedPhysicsControllers, PhysicsController, PhysicsControllerTickContext } from "./stream/physics/PhysicsControllers";
48
48
  export type { DependencyGateController, ServiceLevelController, ServiceResourcePoolController } from "./stream/physics/ServiceOperationsControllers";
49
49
  export type { DependencyGateOptions, DependencyGateSnapshot, ServiceLevelCaseInfo, ServiceLevelCaseState, ServiceLevelControllerOptions, ServiceLevelSnapshot, ServiceResourceAssignment, ServiceResourceDefinition, ServiceResourcePoolOptions, ServiceResourcePoolSnapshot } from "./stream/physics/ServiceOperationsTypes";
@@ -56,7 +56,7 @@ export { PhysicsSVGOverlay, bodiesToAnnotationAnchors, buildPhysicsAnnotationCon
56
56
  export type { PhysicsAnnotationAnchorNode, PhysicsSVGOverlayProps } from "./stream/physics/PhysicsSVGOverlay";
57
57
  export type { PhysicsExecution } from "./stream/physics/PhysicsWorkerProtocol";
58
58
  export type { PhysicsEngineAdapter, PhysicsEngineAdapterFactory, PhysicsEngineAdapterInput, PhysicsEngineCapabilities, PhysicsEngineDeterminism } from "./stream/physics/PhysicsEngineAdapter";
59
- export type { PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPlotBounds, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnPacingOptions, PhysicsSpawnTimeAccessor } from "./stream/physics/PhysicsPipelineStore";
59
+ export type { PhysicsPipelineConfig, PhysicsPipelineControlSurface, PhysicsPlotBounds, PhysicsPipelineSnapshot, PhysicsPipelineTickResult, PhysicsPipelineExecution, PhysicsQueuedSpawn, PhysicsSpawnPacing, PhysicsSpawnPacingOptions, PhysicsSpawnTimeAccessor } from "./stream/physics/PhysicsPipelineStore";
60
60
  export type { PhysicsBodyBudgetAction, PhysicsBodyBudgetDecision, PhysicsBodyBudgetInput, PhysicsBodyBudgetOptions, PhysicsBodyBudgetState } from "./stream/physics/PhysicsBodyBudget";
61
61
  export type { PhysicsSedimentAccessor, PhysicsSedimentBinSnapshot, PhysicsSedimentColumn, PhysicsSedimentConfig, PhysicsSedimentHeightfieldOptions, PhysicsSedimentTotals, PhysicsSedimentValueAccessor, RunningStatsSnapshot } from "./stream/physics/PhysicsSediment";
62
62
  export type { PhysicsBodyShape, PhysicsBodySpec, PhysicsBodyState, PhysicsColliderBodyFilter, PhysicsColliderBodyFilterSpec, PhysicsColliderShape, PhysicsColliderSpec, PhysicsKernelOptions, PhysicsSpringSpec } from "./stream/physics/PhysicsKernel";
@@ -0,0 +1,2 @@
1
+ export { usePretextAnnotations } from "./text/usePretextAnnotations";
2
+ export type { PretextAnnotationOptions } from "./text/pretextAnnotationLayout";
@@ -7,8 +7,8 @@
7
7
  * "semiotic" to keep bundle size minimal.
8
8
  */
9
9
  export type { SemioticTheme } from "./store/themeCore";
10
- export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL, } from "./store/themeCore";
11
- export { themeToCSS, themeToCSSVariables, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT, } from "./semiotic-themes-core";
10
+ export { LIGHT_THEME, DARK_THEME, HIGH_CONTRAST_THEME, COLOR_BLIND_SAFE_CATEGORICAL } from "./store/themeCore";
11
+ export { themeToCSS, themeToCSSVariables, themeToTokens, resolveThemePreset, THEME_PRESETS, CARBON_CATEGORICAL_14, CARBON_ALERT } from "./semiotic-themes-core";
12
12
  export type { KnownThemePresetName, ThemePresetName } from "./semiotic-themes-core";
13
13
  export { adaptiveTimeTicks, smartTickFormat } from "./charts/shared/formatUtils";
14
14
  export type { AdaptiveTimeTickOptions, TimeGranularity } from "./charts/shared/formatUtils";
@@ -19,20 +19,20 @@ export { createHatchPattern } from "./charts/shared/hatchPattern";
19
19
  export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
20
20
  export { isHatchFill, hatchFillId, hatchFillKey } from "./charts/shared/hatchFill";
21
21
  export type { HatchFill } from "./charts/shared/hatchFill";
22
- export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn, } from "./charts/shared/styleRules";
23
- export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate, } from "./charts/shared/styleRules";
22
+ export { resolveStyleRules, matchesThreshold, ruleMatches, makeRuleValueResolver, makeXYRuleContext, makeNodeRuleContext, composeStyleRules, makeStyleRuleStyleFn } from "./charts/shared/styleRules";
23
+ export type { StyleRule, StyleRuleStyle, StyleRuleThreshold, StyleRuleContext, StyleRulePredicate } from "./charts/shared/styleRules";
24
24
  export { validateProps } from "./charts/shared/validateProps";
25
25
  export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
26
- export { auditData, formatDataAudit, profileNumericFields, toDataAuditNotifications, } from "./data/auditData";
27
- export type { AuditDataOptions, CheckedNumericContract, DataAuditChartNotification, DataAuditDiagnosis, DataAuditNotificationOptions, DataAuditResult, NumericFieldProfile, ProfileNumericFieldsOptions, } from "./data/auditData";
28
- export type { NumericAggregateContract, NumericContracts, NumericFieldContract, NumericFieldRole, NumericRequirement, } from "./data/numericContracts";
29
- export { evaluateChart, formatEvaluateChart, toEvaluateChartNotifications, } from "./ai/evaluateChart";
30
- export type { EvaluateChartFinding, EvaluateChartNotification, EvaluateChartOptions, EvaluateChartResult, EvaluateChartSeverity, EvaluateChartStage, EvaluateChartSummary, } from "./ai/evaluateChart";
26
+ export { auditData, formatDataAudit, profileNumericFields, toDataAuditNotifications } from "./data/auditData";
27
+ export type { AuditDataOptions, CheckedNumericContract, DataAuditChartNotification, DataAuditDiagnosis, DataAuditNotificationOptions, DataAuditResult, NumericFieldProfile, ProfileNumericFieldsOptions } from "./data/auditData";
28
+ export type { NumericAggregateContract, NumericContracts, NumericFieldContract, NumericFieldRole, NumericRequirement } from "./data/numericContracts";
29
+ export { evaluateChart, formatEvaluateChart, toEvaluateChartNotifications } from "./ai/evaluateChart";
30
+ export type { EvaluateChartFinding, EvaluateChartNotification, EvaluateChartOptions, EvaluateChartResult, EvaluateChartSeverity, EvaluateChartStage, EvaluateChartSummary } from "./ai/evaluateChart";
31
31
  export { auditVisualHierarchy } from "./ai/auditVisualHierarchy";
32
- export type { VisualHierarchyAuditResult, VisualHierarchyFinding, VisualHierarchyInput, VisualHierarchyStatus, } from "./ai/auditVisualHierarchy";
33
- export { AESTHETICS_OFF_PROFILE, DEFAULT_AESTHETIC_PROFILE, DEFAULT_AESTHETIC_THRESHOLDS, DEFAULT_AESTHETIC_WEIGHTS, evaluateAesthetics, } from "./ai/evaluateAesthetics";
34
- export type { AestheticEvaluationResult, AestheticFeatureResult, AestheticFeatureStatus, EvaluateAestheticsOptions, } from "./ai/evaluateAesthetics";
35
- export type { AestheticFeatureId, AestheticFeatureWeights, AestheticProfile, AestheticThresholds, } from "./ai/aestheticProfileTypes";
32
+ export type { VisualHierarchyAuditResult, VisualHierarchyFinding, VisualHierarchyInput, VisualHierarchyStatus } from "./ai/auditVisualHierarchy";
33
+ export { AESTHETICS_OFF_PROFILE, DEFAULT_AESTHETIC_PROFILE, DEFAULT_AESTHETIC_THRESHOLDS, DEFAULT_AESTHETIC_WEIGHTS, evaluateAesthetics } from "./ai/evaluateAesthetics";
34
+ export type { AestheticEvaluationResult, AestheticFeatureResult, AestheticFeatureStatus, EvaluateAestheticsOptions } from "./ai/evaluateAesthetics";
35
+ export type { AestheticFeatureId, AestheticFeatureWeights, AestheticProfile, AestheticThresholds } from "./ai/aestheticProfileTypes";
36
36
  export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
37
37
  export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats } from "./charts/shared/auditMobileVisualization";
38
38
  export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
@@ -47,8 +47,8 @@ export type { MobileAuditStatus, MobileAuditCategory, MobileAuditImpact, MobileV
47
47
  export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts/shared/responsiveRules";
48
48
  export { getHitRadius } from "./stream/hitTestUtils";
49
49
  export { unwrapDatum } from "./recipes/recipeUtils";
50
- export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
51
- export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
50
+ export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, configToJSXWithReport } from "./export/chartConfig";
51
+ export type { ChartConfig, ChartArtifactTransferStatus, ToConfigOptions, FromConfigResult, ToURLOptions, JSXProjectionResult, CopyFormat } from "./export/chartConfig";
52
52
  export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
53
53
  export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
54
54
  export { exportChart } from "./export/exportChart";
@@ -58,7 +58,7 @@ export { fromVegaLite } from "./data/fromVegaLite";
58
58
  export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
59
59
  export { RingBuffer } from "./realtime/RingBuffer";
60
60
  export { IncrementalExtent } from "./realtime/IncrementalExtent";
61
- export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, markTooltipChrome, } from "./Tooltip/Tooltip";
62
- export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode, } from "./Tooltip/Tooltip";
63
- export { sweepToAngles, valueToAngle, computeArcBoundingBox, } from "./charts/shared/radialGeometry";
61
+ export { Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, markTooltipChrome } from "./Tooltip/Tooltip";
62
+ export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig, MultiTooltipConfig, TooltipRootProps, TooltipChromeMode } from "./Tooltip/Tooltip";
63
+ export { sweepToAngles, valueToAngle, computeArcBoundingBox } from "./charts/shared/radialGeometry";
64
64
  export type { SweepAngles, ArcBoundingBox } from "./charts/shared/radialGeometry";
@@ -48,7 +48,7 @@ import { LinkedCharts } from "./LinkedCharts";
48
48
  import { ThemeProvider, useTheme } from "./ThemeProvider";
49
49
  import { exportChart } from "./export/exportChart";
50
50
  import { createHatchPattern } from "./charts/shared/hatchPattern";
51
- import { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
51
+ import { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, configToJSXWithReport } from "./export/chartConfig";
52
52
  import { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
53
53
  import { fromVegaLite } from "./data/fromVegaLite";
54
54
  import { ChartErrorBoundary } from "./ChartErrorBoundary";
@@ -72,7 +72,7 @@ import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
72
72
  import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
73
73
  import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
74
74
  export { registerBuiltInXYPlugins } from "./stream/xyPlugins/registerBuiltIn";
75
- export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, BumpChart, rankBumpData, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, RadarChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, WaterfallChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, MobileChartContainer, SmallMultipleChart, MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, CircularBrush, DirectManipulationControl, VISUALIZATION_CONTROL_TYPES, DetailsPanel, ObservationReadout, observedDatum, Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, markTooltipChrome, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern, responsiveRuleMatches, resolveResponsiveRules };
75
+ export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, BumpChart, rankBumpData, AreaChart, DifferenceChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, ProcessSankey, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, RadarChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, WaterfallChart, XYCustomChart, NetworkCustomChart, OrdinalCustomChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, configToJSXWithReport, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, MobileChartContainer, SmallMultipleChart, MobileStandardControls, clampMobileRange, useMobileRangeControls, zoomMobileRange, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, CircularBrush, DirectManipulationControl, VISUALIZATION_CONTROL_TYPES, DetailsPanel, ObservationReadout, observedDatum, Tooltip, TooltipRoot, MultiLineTooltip, MultiPointTooltip, normalizeTooltip, resolveTooltipContent, resolveMultiCapableTooltip, isMultiTooltip, hasOwnTooltipChrome, markTooltipChrome, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, TemporalHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern, responsiveRuleMatches, resolveResponsiveRules };
76
76
  export type { CategoricalLegendConfig, GradientLegendConfig, GradientLegendValue, LegendGroup, LegendItem, LegendLayout, LegendValue } from "./types/legendTypes";
77
77
  export type { DirectManipulationControlProps, VisualizationControlType } from "./DirectManipulationControl";
78
78
  export { createControlObservationAdapter } from "./controls/controlContract";
@@ -130,7 +130,7 @@ export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryCol
130
130
  export type { ContextLayoutProps } from "./ContextLayout";
131
131
  export type { DetailsPanelProps } from "./DetailsPanel";
132
132
  export type { ObservationReadoutProps } from "./ObservationReadout";
133
- export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
133
+ export type { ChartConfig, ChartArtifactTransferStatus, ToConfigOptions, FromConfigResult, ToURLOptions, JSXProjectionResult, CopyFormat } from "./export/chartConfig";
134
134
  export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
135
135
  export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
136
136
  export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
@@ -16,8 +16,14 @@
16
16
  * that difference becomes visible to a non-visual caller.
17
17
  */
18
18
  import type { SemanticViabilityDiagnostic } from "../ai/chartCapabilityTypes";
19
+ import type { ArtifactTransferStatus, PortableArtifactContract } from "../artifact/serialization";
20
+ import type { ArtifactIdentityBinding } from "../artifact/identity";
19
21
  export type SemanticViabilityStatus = "meaningful" | "degraded" | "degenerate" | "not-assessed";
20
22
  export interface RenderEvidence {
23
+ /** SHA-256 of the final serialized SVG plus resolved coordinate context, including chart chrome. */
24
+ sceneHash?: string;
25
+ /** Version 2 replaces the evidence envelope's legacy mark-count-only hash. */
26
+ sceneHashVersion?: 2;
21
27
  /** HOC component name as passed to renderChart. */
22
28
  component: string;
23
29
  frameType: "xy" | "ordinal" | "network" | "geo" | "physics" | "value";
@@ -83,6 +89,12 @@ export interface RenderEvidence {
83
89
  width: number;
84
90
  height: number;
85
91
  };
92
+ /** Optional interpretation contract carried beside the rendered scene. */
93
+ artifactContract?: PortableArtifactContract;
94
+ /** Explicit preservation/version result for `artifactContract`. */
95
+ artifactTransfer?: ArtifactTransferStatus;
96
+ /** Whether the attached contract identifies this rendered component/config/data. */
97
+ artifactBinding?: ArtifactIdentityBinding;
86
98
  }
87
99
  /**
88
100
  * Internal mutable slot threaded through the frame renderers. Only
@@ -1,4 +1,5 @@
1
1
  import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type PortableArtifactContract } from "../artifact/serialization";
2
3
  import type { StreamXYFrameProps } from "../stream/types";
3
4
  import type { StreamNetworkFrameProps } from "../stream/networkTypes";
4
5
  import type { StreamOrdinalFrameProps } from "../stream/ordinalTypes";
@@ -31,6 +32,8 @@ export interface RenderChartOptions {
31
32
  * Values are clamped to the practical 0–8 range.
32
33
  */
33
34
  precision?: number;
35
+ /** Preserve an interpretation contract in machine-readable render evidence. */
36
+ artifactContract?: PortableArtifactContract;
34
37
  }
35
38
  /** Apply the documented renderChart precision contract to SVG geometry only. */
36
39
  export declare function serializeSvgPrecision(svg: string, precision?: number): string;
@@ -10,7 +10,6 @@ export { reserveLegendConfigMargin, reserveStaticLegendMargin, } from "./staticL
10
10
  import { resolveTheme, type ThemeInput } from "./themeResolver";
11
11
  import type { SemioticTheme } from "../store/themeCore";
12
12
  import * as React from "react";
13
- import { defaultTickFormat as defaultAxisTickFormat } from "../stream/axisTickUtils";
14
13
  import { type AxisExtentMode } from "../charts/shared/axisExtent";
15
14
  import { type AxisChromeInput } from "../legendLayout";
16
15
  export type FrameType = "xy" | "ordinal" | "network" | "geo" | "physics";
@@ -105,13 +104,11 @@ export declare function renderFrameLegend(options: {
105
104
  };
106
105
  hasTitle?: boolean;
107
106
  }): React.ReactNode;
108
- /** Shared with the live overlay so time-scale defaults stay human-readable. */
109
- export declare const defaultTickFormat: typeof defaultAxisTickFormat;
110
107
  /** Render grid lines for ordinal charts */
111
108
  export declare function renderOrdinalGridSVG(store: OrdinalPipelineStore, layout: {
112
109
  width: number;
113
110
  height: number;
114
- }, theme: SemioticTheme, idPrefix?: string, axisExtent?: AxisExtentMode): React.ReactNode;
111
+ }, theme: SemioticTheme, idPrefix?: string, axisExtent?: AxisExtentMode, rTickValues?: number[]): React.ReactNode;
115
112
  /** Wrap SVG content with accessibility attributes */
116
113
  export declare function wrapSVG(content: React.ReactNode, opts: {
117
114
  width: number;
@@ -1,39 +1,3 @@
1
- import type { ReactNode } from "react";
2
1
  import type { XYFrameAxisConfig } from "../stream/xyFrameAxisTypes";
3
- import type { AxisExtentMode } from "../charts/shared/axisExtent";
4
- type AxisTickValue = number | Date;
5
- export type StaticAxisTick = {
6
- value: AxisTickValue;
7
- pixel: number;
8
- label: ReactNode;
9
- };
10
- type StaticAxisScale = {
11
- (value: AxisTickValue): number;
12
- domain(): readonly AxisTickValue[];
13
- };
14
- type StaticAxisFormatter = (value: AxisTickValue, index?: number, allTicks?: number[]) => ReactNode;
15
- export declare function createStaticAxisTicks(options: {
16
- values: AxisTickValue[];
17
- scale: StaticAxisScale;
18
- format: StaticAxisFormatter;
19
- }): StaticAxisTick[];
20
- /** Match SVGOverlay's deterministic label-width estimate. */
21
- export declare function staticAxisLabelWidth(label: ReactNode): number;
22
- /**
23
- * Apply the same collision, duplicate-label, and include-max rules as the
24
- * live SVGOverlay. Keeping this server-side makes a static export retain the
25
- * readable endpoint set rather than serializing every crowded candidate.
26
- */
27
- export declare function resolveStaticAxisTicks(options: {
28
- candidates: StaticAxisTick[];
29
- scale: StaticAxisScale;
30
- minPixelDistance: number;
31
- includeMax?: boolean;
32
- extentMode?: AxisExtentMode;
33
- hasExplicitTickValues?: boolean;
34
- dedupeLabels?: boolean;
35
- includeDomainMax?: boolean;
36
- format: StaticAxisFormatter;
37
- }): StaticAxisTick[];
38
- export declare function isStaticAxisLandmark(landmarkTicks: XYFrameAxisConfig["landmarkTicks"], tick: StaticAxisTick, index: number, ticks: StaticAxisTick[]): boolean;
39
- export {};
2
+ import type { AxisTick } from "../stream/xyAxisTicks";
3
+ export declare function isStaticAxisLandmark(landmarkTicks: XYFrameAxisConfig["landmarkTicks"], tick: AxisTick, index: number, ticks: AxisTick[]): boolean;
@@ -2,7 +2,7 @@ import * as React from "react";
2
2
  import type { StreamLayout, StreamScales, StreamXYFrameProps } from "../stream/types";
3
3
  import type { XYFrameAxisConfig } from "../stream/xyFrameAxisTypes";
4
4
  import type { SemioticTheme } from "../store/themeCore";
5
- import { type AxisExtentMode } from "../charts/shared/axisExtent";
5
+ import type { AxisExtentMode } from "../charts/shared/axisExtent";
6
6
  /**
7
7
  * Server grid lines resolve the same filtered tick set as static axes. This
8
8
  * prevents a crowded formatter or `includeMax` from leaving a grid line with
@@ -0,0 +1,6 @@
1
+ export interface SVGDimensions {
2
+ width: number;
3
+ height: number;
4
+ }
5
+ export declare function renderedSvgDimensions(svg: string, fallback: SVGDimensions): SVGDimensions;
6
+ export declare function fitSvgToBox(svg: string, dimensions: SVGDimensions): string;
@@ -0,0 +1,17 @@
1
+ /** Shared SVG markup handling; not a complete XML validator or sanitizer. */
2
+ export interface SvgRoot {
3
+ start: number;
4
+ end: number;
5
+ name: string;
6
+ attributes: string;
7
+ selfClosing: boolean;
8
+ }
9
+ export declare function findSvgRoot(svg: string): SvgRoot | undefined;
10
+ export declare function escapeXmlAttribute(value: string): string;
11
+ export declare function svgRootAttribute(root: SvgRoot, name: string): string | undefined;
12
+ /** Transform real element attributes, preserving comments, CDATA and preambles. */
13
+ export declare function mapSvgAttributes(svg: string, transform: (name: string, value: string) => string | undefined): string;
14
+ /** Insert a child inside the actual root, expanding an empty element if needed. */
15
+ export declare function insertSvgRootContent(svg: string, content: string): string;
16
+ /** Rewrite exact attributes, preserving other attributes and their quoting. */
17
+ export declare function setSvgRootAttributes(svg: string, updates: Record<string, string>): string;
@@ -6,3 +6,9 @@ import type { Datum } from "../charts/shared/datumTypes";
6
6
  export declare function attachSelectionProvenance<TTarget extends object>(datum: TTarget, rows: readonly Datum[] | undefined): TTarget;
7
7
  /** Return the raw rows represented by an aggregate mark, when available. */
8
8
  export declare function getSelectionProvenance(datum: unknown): readonly Datum[] | undefined;
9
+ /** Parent series metadata is a fallback; authored coordinate fields take precedence. */
10
+ export declare function selectionDatumWithParent(datum: Datum): Datum;
11
+ /** Keep the representative styling row while matching any row in a series. */
12
+ export declare function seriesSelectionDatum(rows: readonly Datum[]): Datum;
13
+ /** Selection-aware style callbacks request source rows on aggregate marks. */
14
+ export declare function requestsSelectionProvenance(style: unknown): boolean;
@@ -24,6 +24,10 @@ interface GeoSVGOverlayProps {
24
24
  */
25
25
  showAxes?: boolean;
26
26
  title?: string | ReactNode;
27
+ /** Accessible long description; wins over the title-derived `<desc>` suffix. */
28
+ description?: string;
29
+ /** Prefix for `<title>`/`<desc>` ids so multiple charts on a page do not collide. */
30
+ idPrefix?: string;
27
31
  legend?: LegendValue;
28
32
  legendHoverBehavior?: (item: {
29
33
  label: string;
@@ -28,6 +28,10 @@ export interface NetworkSVGOverlayProps {
28
28
  labels: NetworkLabel[];
29
29
  /** Chart title */
30
30
  title?: string | ReactNode;
31
+ /** Accessible long description; wins over the title-derived `<desc>` suffix. */
32
+ description?: string;
33
+ /** Prefix for `<title>`/`<desc>` ids so multiple charts on a page do not collide. */
34
+ idPrefix?: string;
31
35
  /** Legend configuration */
32
36
  legend?: LegendValue;
33
37
  legendHoverBehavior?: (item: {
@@ -38,6 +38,10 @@ interface OrdinalSVGOverlayProps {
38
38
  axisExtent?: AxisExtentMode;
39
39
  showGrid?: boolean;
40
40
  title?: string | ReactNode;
41
+ /** Accessible long description; wins over the title-derived `<desc>` suffix. */
42
+ description?: string;
43
+ /** Prefix for `<title>`/`<desc>` ids so multiple charts on a page do not collide. */
44
+ idPrefix?: string;
41
45
  legend?: LegendValue;
42
46
  legendHoverBehavior?: (item: {
43
47
  label: string;
@@ -37,6 +37,10 @@ interface SVGOverlayProps {
37
37
  axisExtent?: import("../charts/shared/axisExtent").AxisExtentMode;
38
38
  showGrid?: boolean;
39
39
  title?: string | ReactNode;
40
+ /** Accessible long description; wins over the title-derived `<desc>` suffix. */
41
+ description?: string;
42
+ /** Prefix for `<title>`/`<desc>` ids so multiple charts on a page do not collide. */
43
+ idPrefix?: string;
40
44
  legend?: LegendValue;
41
45
  /** Callback when hovering a legend item */
42
46
  legendHoverBehavior?: (item: {
@@ -1,24 +1,9 @@
1
1
  /**
2
- * Scene graph → SVG element converters.
3
- *
4
- * Shared module used by Stream Frames for SSR rendering and
5
- * by semiotic/server for static SVG export.
6
- *
7
- * Network, geo, and ordinal serializers live in sibling modules
8
- * (SceneToSVGNetwork.tsx / SceneToSVGGeo.tsx / SceneToSVGOrdinal.tsx) and are
9
- * re-exported below to keep this file under the file-size ratchet ceiling;
10
- * low-level helpers shared across them (svgFill, safeSvgId, glyphNodeToSVG,
11
- * buildRectSVGGradient, perCornerSvgPath, symbolSceneNodeToSVG, ARC_NOOP)
12
- * live in sceneToSVGShared.tsx.
2
+ * Compatibility facade for scene-family SVG serializers. Runtime callers
3
+ * import the family leaf directly to avoid retaining unrelated renderers in
4
+ * shared package chunks.
13
5
  */
14
- import * as React from "react";
15
- import type { SceneNode } from "./types";
6
+ export { xySceneNodeToSVG } from "./SceneToSVGXY";
16
7
  export { networkSceneNodeToSVG, networkSceneEdgeToSVG, networkLabelToSVG } from "./SceneToSVGNetwork";
17
8
  export { geoSceneNodeToSVG } from "./SceneToSVGGeo";
18
9
  export { ordinalSceneNodeToSVG } from "./SceneToSVGOrdinal";
19
- export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?: string, cursorHitRadius?: number): React.ReactNode;
20
- /**
21
- * Returns true when running in a true server/Node.js context where
22
- * window and document are not available.
23
- */
24
- export { isServerEnvironment } from "./isServerEnvironment";
@@ -0,0 +1,13 @@
1
+ /**
2
+ * XY scene graph → SVG elements for the browser frame and static renderer.
3
+ * Import this leaf module at runtime so other families' serializers stay out
4
+ * of the XY entry graph. SceneToSVG.tsx retains the shared export facade.
5
+ */
6
+ import * as React from "react";
7
+ import type { SceneNode } from "./types";
8
+ export declare function xySceneNodeToSVG(node: SceneNode, i: number, idPrefix?: string, cursorHitRadius?: number): React.ReactNode;
9
+ /**
10
+ * Returns true when running in a true server/Node.js context where
11
+ * window and document are not available.
12
+ */
13
+ export { isServerEnvironment } from "./isServerEnvironment";
@@ -1,5 +1,4 @@
1
- import type { Datum } from "../charts/shared/datumTypes";
2
1
  import * as React from "react";
3
2
  import type { StreamGeoFrameHandle, StreamGeoFrameProps } from "./geoTypes";
4
- declare const StreamGeoFrame: React.NamedExoticComponent<StreamGeoFrameProps<Datum> & React.RefAttributes<StreamGeoFrameHandle>>;
3
+ declare const StreamGeoFrame: React.NamedExoticComponent<StreamGeoFrameProps<import("./networkColorAccessors").Datum> & React.RefAttributes<StreamGeoFrameHandle>>;
5
4
  export default StreamGeoFrame;
@@ -1,5 +1,4 @@
1
- import type { Datum } from "../charts/shared/datumTypes";
2
1
  import * as React from "react";
3
2
  import type { StreamOrdinalFrameHandle, StreamOrdinalFrameProps } from "./ordinalTypes";
4
- declare const StreamOrdinalFrame: React.NamedExoticComponent<StreamOrdinalFrameProps<Datum> & React.RefAttributes<StreamOrdinalFrameHandle<Datum>>>;
3
+ declare const StreamOrdinalFrame: React.NamedExoticComponent<StreamOrdinalFrameProps<import("./networkColorAccessors").Datum> & React.RefAttributes<StreamOrdinalFrameHandle<import("./networkColorAccessors").Datum>>>;
5
4
  export default StreamOrdinalFrame;
@@ -0,0 +1,11 @@
1
+ import * as React from "react";
2
+ import type { XYFrameAxisConfig } from "./xyFrameAxisTypes";
3
+ import type { AxisTick } from "./xyAxisTicks";
4
+ /** Identical grid chrome for the canvas underlay and its visible overlay fallback. */
5
+ export declare function XYGrid({ axes, xTicks, yTicks, width, height }: {
6
+ axes?: XYFrameAxisConfig[];
7
+ xTicks: AxisTick[];
8
+ yTicks: AxisTick[];
9
+ width: number;
10
+ height: number;
11
+ }): React.JSX.Element;
@@ -4,7 +4,6 @@ export declare function axisTickCount(axis: {
4
4
  ticks?: number;
5
5
  tickCount?: number;
6
6
  } | undefined, fallback: number): number;
7
- export declare function defaultTickFormat(v: string | number | Date, _index?: number, _allTicks?: number[]): string;
8
7
  /**
9
8
  * Only primitive labels can be meaningfully compared without rendering.
10
9
  * `String(<span />)` is always "[object Object]", which used to erase every
@@ -7,6 +7,8 @@ export interface RectHitResult {
7
7
  cx: number;
8
8
  cy: number;
9
9
  }
10
+ /** Distance to a segment, including a segment collapsed to a single point. */
11
+ export declare function pointToSegmentDistance(px: number, py: number, ax: number, ay: number, bx: number, by: number): number;
10
12
  /**
11
13
  * Test whether a point (px, py) falls within a rectangle defined by
12
14
  * { x, y, w, h } and return the rectangle's center coordinates.
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Shared accessible `<title>` / `<desc>` text for frame SVG overlays.
3
+ *
4
+ * Live overlays historically copied XY fallbacks (including Geo naming maps
5
+ * "XY Chart") and ignored `description`. Keep family-specific fallbacks here
6
+ * so canvas aria-labels, overlay chrome, and static SVG stay aligned.
7
+ */
8
+ export declare function overlayAccessibleTitle(title: unknown, fallback: string): string;
9
+ export declare function overlayAccessibleDescription(title: unknown, description: unknown, options: {
10
+ familyPhrase: string;
11
+ fallback: string;
12
+ }): string;
13
+ /** Instance-local `<title>` / `<desc>` ids so two charts on one page do not collide. */
14
+ export declare function overlayAccessibleIds(idPrefix: string): {
15
+ titleId: string;
16
+ descId: string;
17
+ labelledBy: string;
18
+ };
@@ -57,7 +57,7 @@ export interface ComposedPhysicsControllers {
57
57
  }
58
58
  /**
59
59
  * Compose controllers into a single continuous flag, bodyForce, and onTick.
60
- * Call onTick from StreamPhysicsFrame after each pipeline tick; `ctx.dt`
60
+ * Call onTick from StreamPhysicsFrame after each fixed simulation step; `ctx.dt`
61
61
  * accounts for every fixed substep completed by that tick.
62
62
  */
63
63
  export declare function composePhysicsControllers(controllers: readonly PhysicsController[] | undefined | null): ComposedPhysicsControllers | null;
@@ -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;