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
@@ -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";
@@ -32,6 +32,15 @@ export { transitDiagramLayout, computeTransitDiagramPositions, octilinearRoute,
32
32
  export type { TransitDiagramConfig, TransitDiagramLineDescriptor, TransitDiagramLineValue, TransitDiagramMode, TransitDiagramPoint, TransitDiagramPositionOptions, TransitDiagramPositionResult, TransitDiagramPositionedNode, TransitDiagramStationRenderInfo, } from "./recipes/transitDiagram";
33
33
  export { lineageDagLayout } from "./recipes/lineageDag";
34
34
  export type { LineageDagConfig, LineageLod, LineageStoreSlot } from "./recipes/lineageDag";
35
+ export { prepareNetworkAtlasAsync } from "./recipes/atlas/prepareAsync";
36
+ export type { PrepareOptions as PrepareNetworkAtlasOptions, PrepareResult as PrepareNetworkAtlasResult } from "./recipes/atlas/prepare";
37
+ export type { NetworkAtlasSpec, NetworkAtlasSource, PreparedNetworkAtlas, AtlasNode, AtlasEdge, AtlasOccurrence, AtlasMeasureValue, AtlasIssue } from "./recipes/atlas/types";
38
+ export { prepareMotifBraid } from "./recipes/atlas/prepareAsync";
39
+ export type { MotifBraidProjection, TrajectoryGroup, BraidRibbon, SignedReadout } from "./recipes/atlas/braid";
40
+ export type { MotifCapsule } from "./recipes/atlas/capsules";
41
+ export type { MotifProfileCell, MotifProfileStrip } from "./recipes/atlas/profile";
42
+ export { motifBraidLayout } from "./recipes/atlas/motifBraidLayout";
43
+ export type { MotifBraidLayoutConfig } from "./recipes/atlas/motifBraidLayout";
35
44
  export { mermaidDagLayout } from "./recipes/mermaidDag";
36
45
  export type { MermaidDagConfig } from "./recipes/mermaidDag";
37
46
  export { netEnsembleLayout, analyzeNetEnsemble } from "./recipes/netEnsembleLayout";
@@ -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;
@@ -5,6 +5,9 @@
5
5
  */
6
6
  import type { ChartConfig } from "./serverChartConfigShared";
7
7
  export declare const CHART_CONFIGS: {
8
+ MotifBraidChart: ChartConfig;
9
+ DependencyForestChart: ChartConfig;
10
+ FlowCircuitChart: ChartConfig;
8
11
  Sparkline: ChartConfig;
9
12
  BumpChart: ChartConfig;
10
13
  LineChart: ChartConfig;
@@ -0,0 +1,4 @@
1
+ import type { ChartConfig } from "./serverChartConfigShared";
2
+ export declare const motifBraidChart: ChartConfig;
3
+ export declare const dependencyForestChart: ChartConfig;
4
+ export declare const flowCircuitChart: ChartConfig;
@@ -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;
@@ -53,6 +53,7 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
53
53
  * StreamNetworkFrame). Empty for built-in chart types. */
54
54
  customLayoutHtmlMarks: NetworkHtmlMark[];
55
55
  private _customLayoutDiagnosticsWarned;
56
+ private _customLayoutCache;
56
57
  /** Per-frame restyle callbacks from the custom layout result. When set, the
57
58
  * frame routes selection changes through `restyleScene()` (style-only repaint)
58
59
  * instead of a full `buildScene()`. */
@@ -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
@@ -10,8 +10,7 @@ export interface CanvasMargin {
10
10
  bottom: number;
11
11
  left: number;
12
12
  }
13
- /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
14
- export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
13
+ export { subscribeToCanvasFontInvalidation } from "./fontLoading";
15
14
  /**
16
15
  * Keep a canvas's backing store and CSS box aligned with the frame size.
17
16
  * This is separate from context preparation so an idle interaction layer can
@@ -0,0 +1,4 @@
1
+ /** Empty native load events (including Firefox's initial event) change no metrics. */
2
+ export declare function hasLoadedFontFaces(event: Event): boolean;
3
+ /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
4
+ export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
@@ -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.
@@ -37,6 +37,14 @@ export interface NetworkLayoutSelection {
37
37
  * rects, lines, beziers — and optional labels/overlays. The frame still
38
38
  * owns hit testing, decay, accessibility, and SSR.
39
39
  *
40
+ * Bounded client mounts ingest data before invoking the layout. The retained
41
+ * scene is reused while data, plot dimensions, layout/config identity, theme,
42
+ * and geometry-driving selection are unchanged. A measured container can
43
+ * require a second call at its measured size. Treat inputs as immutable;
44
+ * replace changed data/config references. `ref.relayout()` forces a fresh
45
+ * call, and failed calls remain retriable. Empty push-mode frames may invoke
46
+ * the layout for decorations. SSR and client hydration execute separately.
47
+ *
40
48
  * Mirrors the XY `CustomLayout` pattern. Reach for it when the catalog
41
49
  * (force, sankey, chord, tree, treemap, circle-pack, orbit) doesn't fit
42
50
  * — e.g. `d3-flextree`, `dagre`, custom radial layouts.
@@ -0,0 +1,12 @@
1
+ import type { NetworkPipelineConfig } from "./networkTypes";
2
+ import type { CustomLayoutSelection } from "./customLayoutSelection";
3
+ /** One successful input state per store; failures remain retriable. */
4
+ export declare class NetworkCustomLayoutCache {
5
+ private restyle;
6
+ private key;
7
+ private pending;
8
+ constructor(restyle: (selection: CustomLayoutSelection | null) => void);
9
+ reuse(config: NetworkPipelineConfig, size: [number, number], dataRevision: number, layoutVersion: number, hasRestyle: boolean): boolean;
10
+ commit(): void;
11
+ clear(): void;
12
+ }
@@ -13,10 +13,3 @@ export type NetworkPipelineConfigSources = Pick<StreamNetworkFrameProps, "chartT
13
13
  currentTheme: SemioticTheme | null | undefined;
14
14
  };
15
15
  export declare function buildNetworkPipelineConfig(sources: NetworkPipelineConfigSources): NetworkPipelineConfig;
16
- /** Fields that force re-ingest / re-layout when changed. */
17
- export type NetworkLayoutConfigSignature = Pick<NetworkPipelineConfigSources, "chartType" | "nodeIDAccessor" | "sourceAccessor" | "targetAccessor" | "valueAccessor" | "edgeIdAccessor" | "childrenAccessor" | "hierarchySum" | "orientation" | "nodeAlign" | "nodePaddingRatio" | "nodeWidth" | "iterations" | "forceStrength" | "padAngle" | "groupWidth" | "sortGroups" | "edgeSort" | "treeOrientation" | "edgeType" | "padding" | "paddingTop" | "random" | "seed" | "tensionConfig" | "customNetworkLayout"> & {
18
- orbitMode?: NetworkPipelineConfigSources["orbitMode"];
19
- orbitSize?: NetworkPipelineConfigSources["orbitSize"];
20
- orbitEccentricity?: NetworkPipelineConfigSources["orbitEccentricity"];
21
- };
22
- export declare function buildNetworkLayoutConfigSignature(sources: NetworkLayoutConfigSignature): Record<string, unknown>;
@@ -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;