semiotic 3.9.1 → 3.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (566) hide show
  1. package/README.md +137 -58
  2. package/agent-skill/semiotic-charts/SKILL.md +27 -17
  3. package/ai/artifact-contract-reference.md +408 -0
  4. package/ai/artifact-surface-inventory.json +5586 -0
  5. package/ai/behaviorContracts.cjs +24 -2
  6. package/ai/cli.js +480 -56
  7. package/ai/componentMetadata.cjs +13 -3
  8. package/ai/dist/mcp-server.js +140 -36407
  9. package/ai/examples.md +110 -7
  10. package/ai/reference.md +82 -28
  11. package/ai/schema.json +7675 -1471
  12. package/ai/surface-manifest.json +60 -9
  13. package/ai/system-prompt.md +18 -3
  14. package/ai/task-packets/compare-category-totals.json +301 -0
  15. package/ai/task-packets/compare-category-totals.md +188 -0
  16. package/ai/task-packets/correct-published-chart.json +271 -0
  17. package/ai/task-packets/correct-published-chart.md +597 -0
  18. package/ai/task-packets/index.json +40 -0
  19. package/ai/task-packets/update-live-chart.json +289 -0
  20. package/ai/task-packets/update-live-chart.md +424 -0
  21. package/dist/c-2N7IU2NY.min.js +1 -0
  22. package/dist/c-2WK7YJLL.min.js +1 -0
  23. package/dist/c-33QOXEUG.min.js +1 -0
  24. package/dist/c-42PLDTX7.min.js +1 -0
  25. package/dist/c-447VIMRO.min.js +1 -0
  26. package/dist/c-4FN7Q6VQ.min.js +1 -0
  27. package/dist/c-553QUDKA.min.js +1 -0
  28. package/dist/c-55BAJ333.min.js +1 -0
  29. package/dist/c-7242NXSG.min.js +1 -0
  30. package/dist/c-7EGHJU2F.min.js +1 -0
  31. package/dist/c-7HP7MB2I.min.js +1 -0
  32. package/dist/c-7NBU5ZKS.min.js +1 -0
  33. package/dist/c-AFBSWT77.min.js +1 -0
  34. package/dist/c-AJ7EC32V.min.js +1 -0
  35. package/dist/c-AQADQNY7.min.js +1 -0
  36. package/dist/c-ATM475SA.min.js +1 -0
  37. package/dist/c-AVO3Q7T7.min.js +1 -0
  38. package/dist/c-AZKPVBOC.min.js +1 -0
  39. package/dist/c-BNFJMDHN.min.js +1 -0
  40. package/dist/c-BNG5ECK5.min.js +1 -0
  41. package/dist/c-BOHCQILI.min.js +1 -0
  42. package/dist/c-CCTGN5CK.min.js +1 -0
  43. package/dist/c-CPSPZH6A.min.js +1 -0
  44. package/dist/c-CPV4N35K.min.js +1 -0
  45. package/dist/c-D6HAAPTX.min.js +1 -0
  46. package/dist/c-DE5Q3U2X.min.js +1 -0
  47. package/dist/c-DK662R77.min.js +1 -0
  48. package/dist/c-DY2676CR.min.js +1 -0
  49. package/dist/c-E32M6XW5.min.js +1 -0
  50. package/dist/c-E4JDJH4I.min.js +1 -0
  51. package/dist/c-E7I2L7CU.min.js +1 -0
  52. package/dist/c-EBOQ7ER7.min.js +1 -0
  53. package/dist/c-ELDWAO2V.min.js +1 -0
  54. package/dist/c-EUBTECGM.min.js +1 -0
  55. package/dist/c-GNTXRXRN.min.js +1 -0
  56. package/dist/c-GSZRZRD6.min.js +1 -0
  57. package/dist/c-GWX7JGMF.min.js +1 -0
  58. package/dist/c-GXV3C3MO.min.js +1 -0
  59. package/dist/c-HHTK2R75.min.js +1 -0
  60. package/dist/c-HLLFJYTY.min.js +1 -0
  61. package/dist/c-HPOYKCCG.min.js +1 -0
  62. package/dist/c-HXDKPIKR.min.js +1 -0
  63. package/dist/c-I4QJ6YLM.min.js +1 -0
  64. package/dist/c-IDJV3CZK.min.js +1 -0
  65. package/dist/c-ITKX3RC5.min.js +1 -0
  66. package/dist/c-JG2JCQLP.min.js +1 -0
  67. package/dist/c-JLGRHXGZ.min.js +1 -0
  68. package/dist/c-JO2UGTCP.min.js +1 -0
  69. package/dist/c-JUKIWTBJ.min.js +1 -0
  70. package/dist/c-KCRJGUHP.min.js +1 -0
  71. package/dist/c-LMGSSD2E.min.js +1 -0
  72. package/dist/c-LYQMZMZQ.min.js +1 -0
  73. package/dist/c-LYVKDBQJ.min.js +1 -0
  74. package/dist/c-MVR3RWF3.min.js +1 -0
  75. package/dist/c-MXCP7GNZ.min.js +1 -0
  76. package/dist/c-NG7BLZTR.min.js +1 -0
  77. package/dist/c-NYZ2QNAM.min.js +1 -0
  78. package/dist/c-OO5QLMJC.min.js +1 -0
  79. package/dist/c-OOVX2JPQ.min.js +1 -0
  80. package/dist/c-ORLEBW72.min.js +1 -0
  81. package/dist/c-P65V6HLO.min.js +1 -0
  82. package/dist/c-PP6VY3QU.min.js +1 -0
  83. package/dist/c-PRIKOLTE.min.js +1 -0
  84. package/dist/c-PSNI6KAZ.min.js +1 -0
  85. package/dist/c-PYNW54D2.min.js +1 -0
  86. package/dist/c-QA3HMQJP.min.js +1 -0
  87. package/dist/c-QAVFOEUY.min.js +1 -0
  88. package/dist/c-ROEHCIGV.min.js +1 -0
  89. package/dist/c-S3AZX5PP.min.js +1 -0
  90. package/dist/c-T2V7O2LO.min.js +1 -0
  91. package/dist/c-TIXX5CAU.min.js +1 -0
  92. package/dist/c-TKG2NP7G.min.js +1 -0
  93. package/dist/c-VJTDST2R.min.js +1 -0
  94. package/dist/c-VXLOLYTO.min.js +1 -0
  95. package/dist/c-W4ZUKSEQ.min.js +1 -0
  96. package/dist/c-WH2O53VI.min.js +1 -0
  97. package/dist/c-WNGH47HF.min.js +1 -0
  98. package/dist/c-WUWXGQYA.min.js +1 -0
  99. package/dist/c-XDQKXPX4.min.js +1 -0
  100. package/dist/c-XSB27XPS.min.js +1 -0
  101. package/dist/c-YDECTEUW.min.js +1 -0
  102. package/dist/c-YF3YKVQI.min.js +1 -0
  103. package/dist/c-YLZIV3VS.min.js +1 -0
  104. package/dist/c-ZYPXQF7B.min.js +1 -0
  105. package/dist/components/Annotation.d.ts +3 -2
  106. package/dist/components/access/chartAccessCapabilities.generated.d.ts +14 -0
  107. package/dist/components/access/chartAccessContract.d.ts +90 -0
  108. package/dist/components/access/chartAccessContractFixtures.d.ts +11 -0
  109. package/dist/components/ai/aestheticProfileTypes.d.ts +35 -0
  110. package/dist/components/ai/annotationProvenance.d.ts +2 -7
  111. package/dist/components/ai/auditVisualHierarchy.d.ts +49 -0
  112. package/dist/components/ai/builtInChartRecipeLayouts.d.ts +2 -0
  113. package/dist/components/ai/builtInChartRecipePublic.d.ts +4 -0
  114. package/dist/components/ai/builtInChartRecipes.d.ts +26 -0
  115. package/dist/components/ai/chartCapabilities.d.ts +3 -1
  116. package/dist/components/ai/chartRecipeRegistry.d.ts +7 -1
  117. package/dist/components/ai/chartRecipes.d.ts +10 -0
  118. package/dist/components/ai/colorEvidence.d.ts +12 -0
  119. package/dist/components/ai/describePhysicsProjection.d.ts +18 -0
  120. package/dist/components/ai/describePhysicsSource.d.ts +13 -0
  121. package/dist/components/ai/evaluateAesthetics.d.ts +47 -0
  122. package/dist/components/ai/geoNavigation.d.ts +4 -0
  123. package/dist/components/ai/hierarchyNavigation.d.ts +4 -0
  124. package/dist/components/ai/navigationTree.d.ts +7 -1
  125. package/dist/components/ai/qualityFixtures.d.ts +8 -0
  126. package/dist/components/ai/suggestionPropContracts.d.ts +1 -1
  127. package/dist/components/ai/useNavigationSync.d.ts +3 -3
  128. package/dist/components/artifact/ArtifactInspector.d.ts +26 -0
  129. package/dist/components/artifact/ArtifactInspectorContextSections.d.ts +18 -0
  130. package/dist/components/artifact/artifactContractDiff.d.ts +8 -0
  131. package/dist/components/artifact/artifactInspectorSummary.d.ts +53 -0
  132. package/dist/components/artifact/artifactRevision.d.ts +54 -0
  133. package/dist/components/artifact/artifactTestFixtures.d.ts +17 -0
  134. package/dist/components/artifact/attachmentAudit.d.ts +13 -0
  135. package/dist/components/artifact/claimCorrections.d.ts +3 -0
  136. package/dist/components/artifact/claimGraph.d.ts +5 -0
  137. package/dist/components/artifact/claimLifecycle.d.ts +32 -0
  138. package/dist/components/artifact/claims.d.ts +24 -0
  139. package/dist/components/artifact/collection.d.ts +10 -0
  140. package/dist/components/artifact/collectionCorrectionScope.d.ts +4 -0
  141. package/dist/components/artifact/collectionImpact.d.ts +11 -0
  142. package/dist/components/artifact/collectionLineage.d.ts +3 -0
  143. package/dist/components/artifact/collectionOperations.d.ts +8 -0
  144. package/dist/components/artifact/collectionPolicy.d.ts +22 -0
  145. package/dist/components/artifact/collectionTypes.d.ts +117 -0
  146. package/dist/components/artifact/configurationRepair.d.ts +8 -0
  147. package/dist/components/artifact/contract.d.ts +30 -0
  148. package/dist/components/artifact/evaluateArtifact.d.ts +12 -0
  149. package/dist/components/artifact/evaluateArtifactTypes.d.ts +78 -0
  150. package/dist/components/artifact/evaluationPresentation.d.ts +9 -0
  151. package/dist/components/artifact/evidenceSample.d.ts +8 -0
  152. package/dist/components/artifact/exportPaths.d.ts +8 -0
  153. package/dist/components/artifact/fieldPolicies.d.ts +12 -0
  154. package/dist/components/artifact/fingerprint.d.ts +36 -0
  155. package/dist/components/artifact/grounding.d.ts +51 -0
  156. package/dist/components/artifact/groundingBudget.d.ts +38 -0
  157. package/dist/components/artifact/hostTransfer.d.ts +13 -0
  158. package/dist/components/artifact/identity.d.ts +19 -0
  159. package/dist/components/artifact/inheritance.d.ts +48 -0
  160. package/dist/components/artifact/inheritanceIntegrity.d.ts +3 -0
  161. package/dist/components/artifact/jsonCompatibility.d.ts +2 -0
  162. package/dist/components/artifact/obligations.d.ts +3 -0
  163. package/dist/components/artifact/policies.d.ts +45 -0
  164. package/dist/components/artifact/policyRelations.d.ts +3 -0
  165. package/dist/components/artifact/recordProjection.d.ts +7 -0
  166. package/dist/components/artifact/representation.d.ts +50 -0
  167. package/dist/components/artifact/serialization.d.ts +40 -0
  168. package/dist/components/artifact/temporal.d.ts +32 -0
  169. package/dist/components/artifact/temporalAdapters.d.ts +75 -0
  170. package/dist/components/artifact/temporalAuditHelpers.d.ts +12 -0
  171. package/dist/components/artifact/temporalPresentation.d.ts +8 -0
  172. package/dist/components/artifact/types.d.ts +341 -0
  173. package/dist/components/artifact/validation.d.ts +13 -0
  174. package/dist/components/artifact/validationFieldStatus.d.ts +7 -0
  175. package/dist/components/artifact/validationPrimitives.d.ts +24 -0
  176. package/dist/components/artifact/validationSurfaces.d.ts +7 -0
  177. package/dist/components/artifact/validationTemporal.d.ts +3 -0
  178. package/dist/components/charts/geo/FlowMap.d.ts +7 -0
  179. package/dist/components/charts/geo/flowMapLineStyle.d.ts +18 -0
  180. package/dist/components/charts/index.d.ts +4 -0
  181. package/dist/components/charts/network/ChordDiagram.d.ts +5 -1
  182. package/dist/components/charts/network/CirclePack.d.ts +8 -1
  183. package/dist/components/charts/network/OrbitDiagram.d.ts +9 -0
  184. package/dist/components/charts/network/TreeDiagram.d.ts +8 -1
  185. package/dist/components/charts/network/Treemap.d.ts +8 -1
  186. package/dist/components/charts/ordinal/BarChart.d.ts +6 -0
  187. package/dist/components/charts/ordinal/BoxPlot.d.ts +3 -0
  188. package/dist/components/charts/ordinal/DonutChart.d.ts +5 -0
  189. package/dist/components/charts/ordinal/DotPlot.d.ts +3 -0
  190. package/dist/components/charts/ordinal/FunnelChart.d.ts +5 -0
  191. package/dist/components/charts/ordinal/GaugeChart.d.ts +3 -0
  192. package/dist/components/charts/ordinal/GroupedBarChart.d.ts +6 -0
  193. package/dist/components/charts/ordinal/Histogram.d.ts +3 -0
  194. package/dist/components/charts/ordinal/LikertChart.d.ts +3 -0
  195. package/dist/components/charts/ordinal/PieChart.d.ts +5 -0
  196. package/dist/components/charts/ordinal/RadarChart.capability.d.ts +2 -0
  197. package/dist/components/charts/ordinal/RadarChart.d.ts +77 -0
  198. package/dist/components/charts/ordinal/RidgelinePlot.d.ts +3 -0
  199. package/dist/components/charts/ordinal/StackedBarChart.d.ts +6 -0
  200. package/dist/components/charts/ordinal/SwarmPlot.d.ts +3 -0
  201. package/dist/components/charts/ordinal/SwimlaneChart.d.ts +3 -0
  202. package/dist/components/charts/ordinal/ViolinPlot.d.ts +3 -0
  203. package/dist/components/charts/physics/CollisionSwarmChart.d.ts +1 -1
  204. package/dist/components/charts/physics/EventDropChart.d.ts +3 -1
  205. package/dist/components/charts/physics/GaltonBoardChart.d.ts +4 -2
  206. package/dist/components/charts/physics/GauntletChart.d.ts +1 -5
  207. package/dist/components/charts/physics/ProcessFlowChart.d.ts +6 -0
  208. package/dist/components/charts/physics/UnitPileChart.d.ts +2 -1
  209. package/dist/components/charts/physics/chainReactionTypes.d.ts +3 -0
  210. package/dist/components/charts/physics/collisionSwarmPacking.d.ts +14 -0
  211. package/dist/components/charts/physics/collisionSwarmPhysics.d.ts +1 -0
  212. package/dist/components/charts/physics/eventDropAdmission.d.ts +32 -0
  213. package/dist/components/charts/physics/eventDropPhysics.d.ts +22 -1
  214. package/dist/components/charts/physics/galtonBoardPhysics.d.ts +2 -9
  215. package/dist/components/charts/physics/gauntletPhysics.d.ts +1 -0
  216. package/dist/components/charts/physics/physicsChartReconcile.d.ts +4 -0
  217. package/dist/components/charts/physics/physicsChartUtils.d.ts +1 -1
  218. package/dist/components/charts/physics/physicsGaltonData.d.ts +10 -0
  219. package/dist/components/charts/physics/physicsHocHandle.d.ts +2 -0
  220. package/dist/components/charts/physics/physicsHocUtils.d.ts +7 -1
  221. package/dist/components/charts/physics/physicsPileData.d.ts +11 -0
  222. package/dist/components/charts/physics/physicsPilePhysics.d.ts +5 -12
  223. package/dist/components/charts/physics/physicsProjectionOverlays.d.ts +1 -1
  224. package/dist/components/charts/physics/physicsSourceRows.d.ts +8 -0
  225. package/dist/components/charts/physics/usePhysicsChartData.d.ts +19 -0
  226. package/dist/components/charts/realtime/RealtimeHeatmap.d.ts +14 -1
  227. package/dist/components/charts/realtime/RealtimeHistogram.d.ts +25 -7
  228. package/dist/components/charts/realtime/RealtimeLineChart.d.ts +18 -5
  229. package/dist/components/charts/realtime/RealtimeSwarmChart.d.ts +11 -1
  230. package/dist/components/charts/realtime/RealtimeWaterfallChart.d.ts +11 -1
  231. package/dist/components/charts/realtime/aggregate.d.ts +12 -1
  232. package/dist/components/charts/realtime/realtimeAccessors.d.ts +4 -0
  233. package/dist/components/charts/realtime/realtimeChartRuntime.d.ts +8 -5
  234. package/dist/components/charts/realtime/realtimeChartTypes.d.ts +7 -0
  235. package/dist/components/charts/realtime/realtimeStyleRules.d.ts +4 -0
  236. package/dist/components/charts/realtime/temporalHistogramConfig.d.ts +17 -11
  237. package/dist/components/charts/shared/GaugeReadout.d.ts +9 -0
  238. package/dist/components/charts/shared/ThresholdAnnotation.d.ts +18 -0
  239. package/dist/components/charts/shared/ThresholdEndCap.d.ts +7 -0
  240. package/dist/components/charts/shared/annotationStatusFilter.d.ts +18 -0
  241. package/dist/components/charts/shared/auditAccessibilityText.d.ts +4 -2
  242. package/dist/components/charts/shared/chartDefinitionPilot.d.ts +5 -4
  243. package/dist/components/charts/shared/chartSpecCore.d.ts +2 -2
  244. package/dist/components/charts/shared/heatmapStyleRules.d.ts +13 -0
  245. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  246. package/dist/components/charts/shared/networkUtils.d.ts +14 -0
  247. package/dist/components/charts/shared/numericTickFormatter.d.ts +2 -0
  248. package/dist/components/charts/shared/radialCenterContent.d.ts +10 -0
  249. package/dist/components/charts/shared/selectionUtils.d.ts +3 -1
  250. package/dist/components/charts/shared/tooltipUtils.d.ts +1 -1
  251. package/dist/components/charts/shared/types.d.ts +4 -2
  252. package/dist/components/charts/shared/useChartLegend.d.ts +6 -1
  253. package/dist/components/charts/shared/useLikertAggregation.d.ts +8 -2
  254. package/dist/components/charts/shared/useNetworkChartSetup.d.ts +9 -5
  255. package/dist/components/charts/shared/useOrdinalPieceStyle.d.ts +1 -1
  256. package/dist/components/charts/shared/useXYBrush.d.ts +24 -0
  257. package/dist/components/charts/shared/useXYPointStyle.d.ts +2 -0
  258. package/dist/components/charts/xy/BubbleChart.d.ts +7 -0
  259. package/dist/components/charts/xy/CandlestickChart.d.ts +7 -0
  260. package/dist/components/charts/xy/DifferenceChart.d.ts +7 -0
  261. package/dist/components/charts/xy/Heatmap.d.ts +16 -0
  262. package/dist/components/charts/xy/LineChart.d.ts +9 -0
  263. package/dist/components/charts/xy/MinimapChart.d.ts +7 -0
  264. package/dist/components/charts/xy/MultiAxisLineChart.d.ts +7 -0
  265. package/dist/components/charts/xy/Scatterplot.d.ts +7 -0
  266. package/dist/components/charts/xy/ScatterplotMatrix.d.ts +6 -0
  267. package/dist/components/charts/xy/WaterfallChart.capability.d.ts +2 -0
  268. package/dist/components/charts/xy/WaterfallChart.d.ts +76 -0
  269. package/dist/components/charts/xy/differenceMarkStyle.d.ts +28 -0
  270. package/dist/components/charts/xy/multiAxisFields.d.ts +23 -0
  271. package/dist/components/charts/xy/scatterplotMatrixCells.d.ts +50 -0
  272. package/dist/components/evidence/chartEvidenceEnvelope.d.ts +154 -0
  273. package/dist/components/evidence/evidenceEnvelopeInput.d.ts +8 -0
  274. package/dist/components/evidence/evidenceEnvelopeValidation.d.ts +11 -0
  275. package/dist/components/evidence/evidenceGate.d.ts +30 -0
  276. package/dist/components/evidence/renderedSceneHash.d.ts +23 -0
  277. package/dist/components/evidence/stableJsonHash.d.ts +4 -0
  278. package/dist/components/export/chartConfig.d.ts +40 -5
  279. package/dist/components/export/chartConfigArtifact.d.ts +6 -0
  280. package/dist/components/legendLayout.d.ts +18 -0
  281. package/dist/components/legendStyles.d.ts +4 -0
  282. package/dist/components/realtime/BinAccumulator.d.ts +5 -1
  283. package/dist/components/realtime/types.d.ts +16 -7
  284. package/dist/components/recipes/adjacencyFlow.d.ts +12 -0
  285. package/dist/components/recipes/adjacencyFlowAggregation.d.ts +72 -0
  286. package/dist/components/recipes/adjacencyFlowGeometry.d.ts +79 -0
  287. package/dist/components/recipes/firstAvailableTrack.d.ts +17 -0
  288. package/dist/components/recipes/intervals.d.ts +1 -1
  289. package/dist/components/recipes/lineageDag.d.ts +17 -0
  290. package/dist/components/recipes/lineageDagHulls.d.ts +22 -0
  291. package/dist/components/recipes/transitDiagram.d.ts +75 -0
  292. package/dist/components/recipes/transitDiagramGeometry.d.ts +47 -0
  293. package/dist/components/semiotic-access.d.ts +9 -0
  294. package/dist/components/semiotic-ai-audits.d.ts +17 -0
  295. package/dist/components/semiotic-ai-core.d.ts +38 -18
  296. package/dist/components/semiotic-ai.d.ts +20 -20
  297. package/dist/components/semiotic-artifact-react.d.ts +10 -0
  298. package/dist/components/semiotic-artifact.d.ts +23 -0
  299. package/dist/components/semiotic-evidence.d.ts +10 -0
  300. package/dist/components/semiotic-experimental.d.ts +1 -1
  301. package/dist/components/semiotic-line.d.ts +9 -0
  302. package/dist/components/semiotic-network.d.ts +3 -0
  303. package/dist/components/semiotic-ordinal.d.ts +2 -0
  304. package/dist/components/semiotic-physics.d.ts +4 -4
  305. package/dist/components/semiotic-realtime-core.d.ts +3 -2
  306. package/dist/components/semiotic-recipes-core.d.ts +6 -0
  307. package/dist/components/semiotic-text.d.ts +2 -0
  308. package/dist/components/semiotic-themes-core.d.ts +3 -0
  309. package/dist/components/semiotic-utils-core.d.ts +19 -14
  310. package/dist/components/semiotic-xy.d.ts +3 -0
  311. package/dist/components/semiotic.d.ts +11 -5
  312. package/dist/components/server/renderDashboard.d.ts +37 -0
  313. package/dist/components/server/renderEvidence.d.ts +39 -0
  314. package/dist/components/server/renderToStaticSVG.d.ts +5 -30
  315. package/dist/components/server/serverChartConfigShared.d.ts +13 -0
  316. package/dist/components/server/serverChartConfigs.d.ts +9 -0
  317. package/dist/components/server/serverChartConfigsComposite.d.ts +4 -0
  318. package/dist/components/server/serverChartConfigsCustom.d.ts +2 -0
  319. package/dist/components/server/serverChartConfigsGeo.d.ts +1 -0
  320. package/dist/components/server/serverChartConfigsOrdinal.d.ts +3 -2
  321. package/dist/components/server/serverChartConfigsXY.d.ts +1 -0
  322. package/dist/components/server/serverChartConfigsXYExtra.d.ts +3 -0
  323. package/dist/components/server/serverCompositeChainReaction.d.ts +3 -0
  324. package/dist/components/server/serverOrdinalGauge.d.ts +3 -0
  325. package/dist/components/server/serverOrdinalLikert.d.ts +2 -0
  326. package/dist/components/server/staticSVGChrome.d.ts +1 -4
  327. package/dist/components/server/staticXYAxisTicks.d.ts +2 -38
  328. package/dist/components/server/staticXYGrid.d.ts +1 -1
  329. package/dist/components/server/svgSizing.d.ts +6 -0
  330. package/dist/components/shared/svgRoot.d.ts +17 -0
  331. package/dist/components/store/selectionProvenance.d.ts +14 -0
  332. package/dist/components/store/themeCore.d.ts +5 -1
  333. package/dist/components/stream/GeoPipelineStore.d.ts +1 -1
  334. package/dist/components/stream/GeoSVGOverlay.d.ts +4 -0
  335. package/dist/components/stream/MarginalGraphics.d.ts +3 -3
  336. package/dist/components/stream/MarginalGraphicsLazy.d.ts +22 -0
  337. package/dist/components/stream/NetworkPipelineStore.d.ts +2 -0
  338. package/dist/components/stream/NetworkSVGOverlay.d.ts +4 -0
  339. package/dist/components/stream/OrdinalPipelineStore.d.ts +1 -1
  340. package/dist/components/stream/OrdinalSVGOverlay.d.ts +4 -0
  341. package/dist/components/stream/PipelineStore.d.ts +1 -1
  342. package/dist/components/stream/SVGOverlay.d.ts +4 -0
  343. package/dist/components/stream/SceneToSVG.d.ts +4 -19
  344. package/dist/components/stream/SceneToSVGXY.d.ts +13 -0
  345. package/dist/components/stream/StreamGeoFrame.d.ts +1 -2
  346. package/dist/components/stream/StreamOrdinalFrame.d.ts +1 -2
  347. package/dist/components/stream/XYGrid.d.ts +11 -0
  348. package/dist/components/stream/axisTickUtils.d.ts +0 -1
  349. package/dist/components/stream/canvasSetup.d.ts +8 -2
  350. package/dist/components/stream/customLayoutAttempt.d.ts +21 -0
  351. package/dist/components/stream/geoTypes.d.ts +1 -1
  352. package/dist/components/stream/hitTestUtils.d.ts +2 -0
  353. package/dist/components/stream/isServerEnvironment.d.ts +6 -0
  354. package/dist/components/stream/layouts/forceLayoutNodeSize.d.ts +12 -0
  355. package/dist/components/stream/layouts/forceLayoutPlugin.d.ts +2 -9
  356. package/dist/components/stream/layouts/forceLayoutWorkerClient.d.ts +2 -21
  357. package/dist/components/stream/layouts/forceLayoutWorkerPolicy.d.ts +21 -0
  358. package/dist/components/stream/layouts/index.d.ts +6 -12
  359. package/dist/components/stream/layouts/missingPlugin.d.ts +7 -0
  360. package/dist/components/stream/layouts/registerBuiltIn.d.ts +1 -0
  361. package/dist/components/stream/layouts/registry.d.ts +12 -0
  362. package/dist/components/stream/marginalConfig.d.ts +3 -0
  363. package/dist/components/stream/networkCustomLayout.d.ts +7 -0
  364. package/dist/components/stream/networkCustomLayoutOutput.d.ts +13 -0
  365. package/dist/components/stream/networkCustomLayoutRunner.d.ts +1 -1
  366. package/dist/components/stream/networkTypes.d.ts +5 -1
  367. package/dist/components/stream/ordinalTypes.d.ts +1 -1
  368. package/dist/components/stream/overlayAccessibleText.d.ts +18 -0
  369. package/dist/components/stream/physics/PhysicsControllers.d.ts +1 -1
  370. package/dist/components/stream/physics/PhysicsKernel.d.ts +9 -0
  371. package/dist/components/stream/physics/PhysicsPipelineStore.d.ts +5 -4
  372. package/dist/components/stream/physics/PhysicsPipelineTypes.d.ts +9 -0
  373. package/dist/components/stream/physics/StreamPhysicsTypes.d.ts +4 -1
  374. package/dist/components/stream/physics/physicsCanvasCoordinates.d.ts +5 -0
  375. package/dist/components/stream/physics/physicsFixedPosition.d.ts +16 -0
  376. package/dist/components/stream/physics/physicsKernelCloning.d.ts +6 -0
  377. package/dist/components/stream/physics/physicsPipelineObservations.d.ts +2 -0
  378. package/dist/components/stream/physics/physicsPipelineSettle.d.ts +15 -9
  379. package/dist/components/stream/physics/physicsRegionRuntime.d.ts +8 -17
  380. package/dist/components/stream/physics/physicsSemanticUI.d.ts +9 -0
  381. package/dist/components/stream/pipelineConfig.d.ts +4 -0
  382. package/dist/components/stream/pipelineDomainResolution.d.ts +6 -0
  383. package/dist/components/stream/pipelineStoreUpdateResults.d.ts +1 -1
  384. package/dist/components/stream/renderers/pointCanvasRenderer.d.ts +4 -0
  385. package/dist/components/stream/renderers/resolveCSSColor.d.ts +4 -4
  386. package/dist/components/stream/resolveXYAxes.d.ts +13 -0
  387. package/dist/components/stream/sceneToSVGShared.d.ts +2 -1
  388. package/dist/components/stream/seriesGeometry.d.ts +13 -0
  389. package/dist/components/stream/streamEncodingTypes.d.ts +53 -0
  390. package/dist/components/stream/types.d.ts +12 -54
  391. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +18 -0
  392. package/dist/components/stream/useGeoFrameHandle.d.ts +16 -0
  393. package/dist/components/stream/useMarginalValues.d.ts +13 -0
  394. package/dist/components/stream/useOrdinalFrameHandle.d.ts +15 -0
  395. package/dist/components/stream/useXYFrameHandle.d.ts +15 -0
  396. package/dist/components/stream/xyAxisTicks.d.ts +25 -0
  397. package/dist/components/stream/xyCanvasRenderers.d.ts +4 -4
  398. package/dist/components/stream/xyDateTicks.d.ts +3 -2
  399. package/dist/components/stream/xyFrameAxisTypes.d.ts +2 -0
  400. package/dist/components/stream/xyPlugins/areaPlugin.d.ts +2 -0
  401. package/dist/components/stream/xyPlugins/barPlugin.d.ts +2 -0
  402. package/dist/components/stream/xyPlugins/candlestickPlugin.d.ts +2 -0
  403. package/dist/components/stream/xyPlugins/customPlugin.d.ts +6 -0
  404. package/dist/components/stream/xyPlugins/heatmapPlugin.d.ts +2 -0
  405. package/dist/components/stream/xyPlugins/lineFamily.d.ts +5 -0
  406. package/dist/components/stream/xyPlugins/linePlugin.d.ts +2 -0
  407. package/dist/components/stream/xyPlugins/missingPlugin.d.ts +7 -0
  408. package/dist/components/stream/xyPlugins/mixedPlugin.d.ts +2 -0
  409. package/dist/components/stream/xyPlugins/pointPlugin.d.ts +3 -0
  410. package/dist/components/stream/xyPlugins/registerBuiltIn.d.ts +1 -0
  411. package/dist/components/stream/xyPlugins/registry.d.ts +31 -0
  412. package/dist/components/stream/xyPlugins/stackedAreaPlugin.d.ts +2 -0
  413. package/dist/components/stream/xyPlugins/swarmPlugin.d.ts +2 -0
  414. package/dist/components/stream/xyPlugins/waterfallPlugin.d.ts +2 -0
  415. package/dist/components/stream/xySceneBuilders/ribbonScene.d.ts +1 -1
  416. package/dist/components/stream/xySceneBuilders/types.d.ts +1 -0
  417. package/dist/components/text/annotationTextLayout.d.ts +28 -0
  418. package/dist/components/text/pretextAnnotationLayout.d.ts +29 -0
  419. package/dist/components/text/usePretextAnnotations.d.ts +12 -0
  420. package/dist/controls.module.min.js +1 -1
  421. package/dist/forceLayoutWorker.js +1 -1
  422. package/dist/geo.min.js +1 -1
  423. package/dist/geo.module.min.js +1 -1
  424. package/dist/network.module.min.js +1 -1
  425. package/dist/ordinal.module.min.js +1 -1
  426. package/dist/physics-matter.min.js +1 -1
  427. package/dist/physics-matter.module.min.js +1 -1
  428. package/dist/physics-rapier.min.js +1 -1
  429. package/dist/physics-rapier.module.min.js +1 -1
  430. package/dist/physics.module.min.js +1 -1
  431. package/dist/physicsWorker.js +1 -1
  432. package/dist/processSankeyLayoutWorker.js +1 -1
  433. package/dist/rough.min.js +1 -1
  434. package/dist/rough.module.min.js +1 -1
  435. package/dist/semiotic-access.d.ts +9 -0
  436. package/dist/semiotic-access.min.js +2 -0
  437. package/dist/semiotic-access.module.min.js +2 -0
  438. package/dist/semiotic-ai-artifact-policy-constants.module.min.js +2 -0
  439. package/dist/semiotic-ai-core.d.ts +38 -18
  440. package/dist/semiotic-ai-core.min.js +1 -1
  441. package/dist/semiotic-ai-core.module.min.js +1 -1
  442. package/dist/semiotic-ai-hash-primitives.module.min.js +2 -0
  443. package/dist/semiotic-ai.d.ts +20 -20
  444. package/dist/semiotic-ai.module.min.js +1 -1
  445. package/dist/semiotic-artifact-react.d.ts +10 -0
  446. package/dist/semiotic-artifact-react.min.js +2 -0
  447. package/dist/semiotic-artifact-react.module.min.js +2 -0
  448. package/dist/semiotic-artifact.d.ts +23 -0
  449. package/dist/semiotic-artifact.min.js +1 -0
  450. package/dist/semiotic-artifact.module.min.js +1 -0
  451. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  452. package/dist/semiotic-client-glyph.module.min.js +1 -1
  453. package/dist/semiotic-client-responsive.module.min.js +1 -1
  454. package/dist/semiotic-client-shared.module.min.js +1 -1
  455. package/dist/semiotic-custom-layout-selection-cjs-shared.min.js +1 -1
  456. package/dist/semiotic-data.min.js +1 -1
  457. package/dist/semiotic-data.module.min.js +1 -1
  458. package/dist/semiotic-evidence.d.ts +10 -0
  459. package/dist/semiotic-evidence.min.js +1 -0
  460. package/dist/semiotic-evidence.module.min.js +1 -0
  461. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  462. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  463. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  464. package/dist/semiotic-experimental-vacp.min.js +1 -1
  465. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  466. package/dist/semiotic-experimental.d.ts +1 -1
  467. package/dist/semiotic-line.d.ts +9 -0
  468. package/dist/semiotic-line.min.js +2 -0
  469. package/dist/semiotic-line.module.min.js +2 -0
  470. package/dist/semiotic-network.d.ts +3 -0
  471. package/dist/semiotic-ordinal.d.ts +2 -0
  472. package/dist/semiotic-physics.d.ts +4 -4
  473. package/dist/semiotic-realtime-core.d.ts +3 -2
  474. package/dist/semiotic-realtime-core.module.min.js +1 -1
  475. package/dist/semiotic-realtime-react.module.min.js +1 -1
  476. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  477. package/dist/semiotic-recipes-core.d.ts +6 -0
  478. package/dist/semiotic-recipes-core.module.min.js +1 -1
  479. package/dist/semiotic-recipes-geo-cjs.min.js +1 -1
  480. package/dist/semiotic-recipes-react.min.js +1 -1
  481. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  482. package/dist/semiotic-server-edge.min.js +1 -1
  483. package/dist/semiotic-server-edge.module.min.js +1 -1
  484. package/dist/semiotic-server-node.min.js +1 -1
  485. package/dist/semiotic-server-node.module.min.js +1 -1
  486. package/dist/semiotic-text.d.ts +2 -0
  487. package/dist/semiotic-text.min.js +2 -0
  488. package/dist/semiotic-text.module.min.js +2 -0
  489. package/dist/semiotic-themes-core.d.ts +3 -0
  490. package/dist/semiotic-themes-core.min.js +1 -1
  491. package/dist/semiotic-themes-core.module.min.js +1 -1
  492. package/dist/semiotic-themes.min.js +1 -1
  493. package/dist/semiotic-themes.module.min.js +1 -1
  494. package/dist/semiotic-utils-core.d.ts +19 -14
  495. package/dist/semiotic-utils-core.min.js +1 -1
  496. package/dist/semiotic-utils-core.module.min.js +1 -1
  497. package/dist/semiotic-value.module.min.js +1 -1
  498. package/dist/semiotic-xy.d.ts +3 -0
  499. package/dist/semiotic.d.ts +11 -5
  500. package/dist/semiotic.module.min.js +1 -1
  501. package/dist/server.min.js +1 -1
  502. package/dist/server.module.min.js +1 -1
  503. package/dist/xy.module.min.js +1 -1
  504. package/package.json +91 -71
  505. package/spec/README.md +8 -3
  506. package/spec/v0.1/artifact-contract.schema.json +2299 -0
  507. package/spec/v0.1/examples/artifact-contract-full.json +369 -0
  508. package/spec/v0.1/examples/artifact-contract-unknown-state.json +46 -0
  509. package/dist/c-3BLJEQNG.min.js +0 -1
  510. package/dist/c-3KZD6AXJ.min.js +0 -1
  511. package/dist/c-4TWEX5HG.min.js +0 -1
  512. package/dist/c-52TEGIUJ.min.js +0 -1
  513. package/dist/c-5YCIX3VZ.min.js +0 -1
  514. package/dist/c-6FEKTA3U.min.js +0 -1
  515. package/dist/c-6O5EVOPH.min.js +0 -1
  516. package/dist/c-74HEEZGK.min.js +0 -1
  517. package/dist/c-AKAF6JAD.min.js +0 -1
  518. package/dist/c-BBKITSXB.min.js +0 -1
  519. package/dist/c-BWNB6USU.min.js +0 -1
  520. package/dist/c-C25ENHIK.min.js +0 -1
  521. package/dist/c-CDR5AO3R.min.js +0 -1
  522. package/dist/c-COHXCW3Q.min.js +0 -1
  523. package/dist/c-DADXPJXV.min.js +0 -1
  524. package/dist/c-E3JFRRMI.min.js +0 -1
  525. package/dist/c-EBFPQHHO.min.js +0 -1
  526. package/dist/c-G36WS6LN.min.js +0 -1
  527. package/dist/c-GGISSW5E.min.js +0 -1
  528. package/dist/c-GIKRQI4X.min.js +0 -1
  529. package/dist/c-GPYOFETM.min.js +0 -1
  530. package/dist/c-IDUHYYSI.min.js +0 -1
  531. package/dist/c-IUHFPMHD.min.js +0 -1
  532. package/dist/c-J5G56TUH.min.js +0 -1
  533. package/dist/c-JAZ73J32.min.js +0 -1
  534. package/dist/c-KG3NXHAL.min.js +0 -1
  535. package/dist/c-KII3PLZE.min.js +0 -1
  536. package/dist/c-LIXGXMNS.min.js +0 -1
  537. package/dist/c-LVEY6D6B.min.js +0 -1
  538. package/dist/c-M4Y3BHFR.min.js +0 -1
  539. package/dist/c-MAIICR2Z.min.js +0 -1
  540. package/dist/c-MG5DM6VE.min.js +0 -1
  541. package/dist/c-MNF2S4AA.min.js +0 -1
  542. package/dist/c-MT3WBK7M.min.js +0 -1
  543. package/dist/c-NY3JWV2K.min.js +0 -1
  544. package/dist/c-O6U6K4CW.min.js +0 -1
  545. package/dist/c-OQ7M4AGV.min.js +0 -1
  546. package/dist/c-OXYMVK7Q.min.js +0 -1
  547. package/dist/c-PPWDL5ZI.min.js +0 -1
  548. package/dist/c-QHF5YON3.min.js +0 -1
  549. package/dist/c-RR3GO5SW.min.js +0 -1
  550. package/dist/c-RSVIHIQ4.min.js +0 -1
  551. package/dist/c-S2BXNNJN.min.js +0 -1
  552. package/dist/c-S6U5CGT5.min.js +0 -1
  553. package/dist/c-SLGMUBUL.min.js +0 -1
  554. package/dist/c-SUILCHWU.min.js +0 -1
  555. package/dist/c-TZW3JGJ5.min.js +0 -1
  556. package/dist/c-US5ZFT6E.min.js +0 -1
  557. package/dist/c-USFMFKIH.min.js +0 -1
  558. package/dist/c-UUKVD4WB.min.js +0 -1
  559. package/dist/c-VGW3VG3I.min.js +0 -1
  560. package/dist/c-W3CE4A4S.min.js +0 -1
  561. package/dist/c-WJCD5EUY.min.js +0 -1
  562. package/dist/c-X5UBGU2V.min.js +0 -1
  563. package/dist/c-YDAY2WFR.min.js +0 -1
  564. package/dist/c-ZOWWU34K.min.js +0 -1
  565. /package/dist/{c-N4G2L7ID.min.js → c-HYW2XA4Q.min.js} +0 -0
  566. /package/dist/{c-OCI56QF2.min.js → c-V4XMSLC3.min.js} +0 -0
@@ -54,6 +54,13 @@ export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChar
54
54
  pointOpacity?: number;
55
55
  /** Enable hover annotations @default true */
56
56
  enableHover?: boolean;
57
+ /** Enable an xy brush overlay. Also enabled when `linkedBrush` is set. */
58
+ brush?: boolean;
59
+ /** Callback with `{ x, y }` extents, or null when the brush clears. */
60
+ onBrush?: (extent: {
61
+ x: [number, number];
62
+ y: [number, number];
63
+ } | null) => void;
57
64
  /** Show grid lines @default false */
58
65
  showGrid?: boolean;
59
66
  /** Show legend @default true (when colorBy is specified) */
@@ -2,6 +2,7 @@ import type { Datum } from "../shared/datumTypes";
2
2
  import * as React from "react";
3
3
  import type { BaseChartProps, ChartAccessor } from "../shared/types";
4
4
  import { type TooltipProp } from "../../Tooltip/Tooltip";
5
+ import { type StyleRule } from "../shared/styleRules";
5
6
  export interface ScatterplotMatrixProps<TDatum extends Datum = Datum> extends BaseChartProps {
6
7
  /** Array of data objects */
7
8
  data: TDatum[];
@@ -39,6 +40,11 @@ export interface ScatterplotMatrixProps<TDatum extends Datum = Datum> extends Ba
39
40
  showLegend?: boolean;
40
41
  /** Field or function to identify each data point in tooltips. Defaults to "Row {index}" */
41
42
  idAccessor?: string | ((d: TDatum) => string);
43
+ /**
44
+ * Declarative, threshold-aware point styling applied to every scatter cell.
45
+ * `axis: "x"|"y"` is the cell's plotted fields; `field` reads the source row.
46
+ */
47
+ styleRules?: StyleRule[];
42
48
  /**
43
49
  * Called when a point in any cell is clicked. Receives the clicked row datum
44
50
  * and its grid-relative pixel position `{ x, y }` — the same coordinate space
@@ -0,0 +1,2 @@
1
+ import type { ChartCapability } from "../../ai/chartCapabilityTypes";
2
+ export declare const WaterfallChartCapability: ChartCapability;
@@ -0,0 +1,76 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import * as React from "react";
3
+ import type { StreamXYFrameProps } from "../../stream/types";
4
+ import type { RealtimeFrameHandle } from "../../realtime/types";
5
+ import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
6
+ import { type TooltipProp } from "../../Tooltip/Tooltip";
7
+ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
8
+ import { type StyleRule } from "../shared/styleRules";
9
+ export interface WaterfallChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
10
+ data?: TDatum[];
11
+ xAccessor?: ChartAccessor<TDatum, number | Date | string>;
12
+ yAccessor?: ChartAccessor<TDatum, number>;
13
+ /** Stable ID for push-mode remove() and update(). */
14
+ pointIdAccessor?: ChartAccessor<TDatum, string>;
15
+ xScaleType?: "linear" | "log" | "time";
16
+ positiveColor?: string;
17
+ negativeColor?: string;
18
+ connectorStroke?: string;
19
+ connectorWidth?: number;
20
+ gap?: number;
21
+ /**
22
+ * Declarative, threshold-aware bar styling. Ordered `{ when, style }` rules;
23
+ * last applicable rule wins per property. `ctx` is `{ value, x, y }` from the
24
+ * step accessors so `{ axis: "y", lt: 0 }` matches negative deltas. Layers
25
+ * over the signed positive/negative fill; `frameProps.areaStyle` still wins.
26
+ */
27
+ styleRules?: StyleRule[];
28
+ enableHover?: boolean;
29
+ showGrid?: boolean;
30
+ showLegend?: boolean;
31
+ legendInteraction?: LegendInteractionMode;
32
+ legendPosition?: LegendPosition;
33
+ tooltip?: TooltipProp;
34
+ annotations?: Datum[];
35
+ xExtent?: [number | undefined, number | undefined] | [number];
36
+ yExtent?: [number | undefined, number | undefined] | [number];
37
+ frameProps?: Partial<Omit<StreamXYFrameProps, "data" | "size" | "chartType">>;
38
+ }
39
+ /**
40
+ * WaterfallChart — cumulative signed steps as floating bars.
41
+ *
42
+ * Each row is a delta. Positive values step up from the previous cumulative
43
+ * total; negative values step down. Use {@link RealtimeWaterfallChart} for
44
+ * a push-driven window of the same geometry.
45
+ *
46
+ * @example
47
+ * ```tsx
48
+ * <WaterfallChart
49
+ * data={[
50
+ * { step: "Start", value: 100 },
51
+ * { step: "Sales", value: 40 },
52
+ * { step: "Costs", value: -25 },
53
+ * { step: "Tax", value: -10 },
54
+ * ]}
55
+ * xAccessor="step"
56
+ * yAccessor="value"
57
+ * />
58
+ * ```
59
+ *
60
+ * @example
61
+ * ```tsx
62
+ * // Numeric x values use their input order as the cumulative sequence.
63
+ * <WaterfallChart
64
+ * data={[{ change: 12 }, { change: -4 }, { change: 9 }, { change: -7 }]}
65
+ * yAccessor="change"
66
+ * positiveColor="#15803d"
67
+ * negativeColor="#b91c1c"
68
+ * title="Quarterly operating changes"
69
+ * description="Sequential gains and losses in millions of dollars."
70
+ * />
71
+ * ```
72
+ */
73
+ export declare const WaterfallChart: {
74
+ <TDatum extends Datum = Datum>(props: WaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
75
+ displayName?: string;
76
+ };
@@ -0,0 +1,28 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import { type StyleRule, type StyleRuleContext } from "../shared/styleRules";
3
+ /** Which series is on top (area) or which overlay line this vertex belongs to. */
4
+ export declare function differenceWinner(d: Datum): "A" | "B";
5
+ /**
6
+ * Rule context for synthesized difference rows. `axis: "x"|"y"` reads the
7
+ * plotted `__x`/`__y`; `field` thresholds see the original source row when
8
+ * `__sourceDatum` is present.
9
+ */
10
+ export declare function makeDifferenceRuleContext(): (d: Datum) => StyleRuleContext;
11
+ export declare function buildDifferenceAreaStyle(options: {
12
+ seriesAColor: string;
13
+ seriesBColor: string;
14
+ areaOpacity: number;
15
+ styleRules?: ReadonlyArray<StyleRule>;
16
+ }): (d: Datum) => Datum;
17
+ export declare function buildDifferenceLineStyle(options: {
18
+ seriesAColor: string;
19
+ seriesBColor: string;
20
+ lineWidth: number;
21
+ styleRules?: ReadonlyArray<StyleRule>;
22
+ }): (d: Datum) => Datum;
23
+ export declare function buildDifferencePointStyle(options: {
24
+ seriesAColor: string;
25
+ seriesBColor: string;
26
+ pointRadius: number;
27
+ styleRules?: ReadonlyArray<StyleRule>;
28
+ }): (d: Datum) => Datum;
@@ -0,0 +1,23 @@
1
+ import type { Datum } from "../shared/datumTypes";
2
+ import { type StyleRuleContext } from "../shared/styleRules";
3
+ /** Internal unitized y field shared by the MultiAxis HOC and SSR config. */
4
+ export declare const MULTI_AXIS_UNITIZED_FIELD = "__ma_unitized";
5
+ /** Internal series-identity field shared by the MultiAxis HOC and SSR config. */
6
+ export declare const MULTI_AXIS_SERIES_FIELD = "__ma_series";
7
+ /**
8
+ * Resolve one color per series. Per-series `color` wins, then a
9
+ * `{ label: color }` map, then a named/array palette, then the theme.
10
+ */
11
+ export declare function resolveMultiAxisSeriesColors(series: ReadonlyArray<{
12
+ label?: string;
13
+ color?: string;
14
+ }>, colorScheme: string | string[] | Record<string, string> | undefined, themeCategorical: readonly string[] | undefined): string[];
15
+ /**
16
+ * Style-rule context for dual-axis rows. Thresholds read the original series
17
+ * y (not the unitized [0, 1] plot value) so `{ axis: "y", gt: 10 }` matches
18
+ * the authored metric rather than the normalized display scale.
19
+ */
20
+ export declare function makeMultiAxisRuleContext(xAccessor: string | ((d: Datum) => unknown) | undefined, series: ReadonlyArray<{
21
+ yAccessor?: string | ((d: Datum) => unknown);
22
+ label?: string;
23
+ }>): (d: Datum, group?: string) => StyleRuleContext;
@@ -0,0 +1,50 @@
1
+ import * as React from "react";
2
+ import type { Datum } from "../shared/datumTypes";
3
+ import type { ChartAccessor, ResolvedMobileInteractionConfig } from "../shared/types";
4
+ import { type StyleRule } from "../shared/styleRules";
5
+ export declare const SPLOM_IDX = "__splomIdx";
6
+ interface CellProps {
7
+ data: Datum[];
8
+ xField: string;
9
+ yField: string;
10
+ fieldLabels: Record<string, string>;
11
+ cellSize: number;
12
+ pointRadius: number;
13
+ pointOpacity: number;
14
+ styleRules?: StyleRule[];
15
+ colorBy?: ChartAccessor<Datum, string>;
16
+ colorScale?: (v: string) => string;
17
+ brushSelectionName: string;
18
+ hoverSelectionName: string;
19
+ unselectedOpacity: number;
20
+ showGrid: boolean;
21
+ maxDevicePixelRatio?: number;
22
+ mobileInteraction?: ResolvedMobileInteractionConfig;
23
+ /** "brush" or "hover" - mutually exclusive */
24
+ mode: "brush" | "hover";
25
+ /** Callback when a point is hovered (hover mode only). */
26
+ onPointHover?: (datum: Datum | null, px?: number, py?: number) => void;
27
+ /** Callback when a point is clicked. */
28
+ onPointClick?: (datum: Datum | null, px?: number, py?: number) => void;
29
+ }
30
+ export declare function ScatterplotCell({ data, xField, yField, fieldLabels: _fieldLabels, cellSize, pointRadius, pointOpacity, styleRules, colorBy, colorScale, brushSelectionName, hoverSelectionName, unselectedOpacity, showGrid: _showGrid, maxDevicePixelRatio, mobileInteraction, mode, onPointHover, onPointClick }: CellProps): React.JSX.Element;
31
+ interface DiagonalCellProps {
32
+ data: Datum[];
33
+ field: string;
34
+ label: string;
35
+ cellSize: number;
36
+ bins: number;
37
+ colorBy?: ChartAccessor<Datum, string>;
38
+ colorScale?: (v: string) => string;
39
+ brushSelectionName: string;
40
+ hoverSelectionName: string;
41
+ unselectedOpacity: number;
42
+ /** "brush" or "hover" - matches parent mode */
43
+ mode: "brush" | "hover";
44
+ }
45
+ export declare function DiagonalCell({ data, field, label, cellSize, bins, colorBy, colorScale, brushSelectionName, hoverSelectionName, unselectedOpacity: _unselectedOpacity, mode }: DiagonalCellProps): React.JSX.Element;
46
+ export declare function LabelCell({ label, cellSize }: {
47
+ label: string;
48
+ cellSize: number;
49
+ }): React.JSX.Element;
50
+ export {};
@@ -0,0 +1,154 @@
1
+ /**
2
+ * ChartEvidenceEnvelope@1 — a portable provenance, access, render, meaning,
3
+ * modality-check, audit, and limits ledger.
4
+ *
5
+ * The envelope composes existing Semiotic payloads. It does not replace them:
6
+ * the Chart Access Contract becomes its reader-facing `access` section, render
7
+ * evidence becomes its `render.evidence`, and reader grounding becomes
8
+ * `meaning.grounding`. Model-authored observations are always attributed and
9
+ * never promoted above deterministic evidence.
10
+ */
11
+ import { type ChartAccessContract, type StreamStatusInput } from "../access/chartAccessContract";
12
+ import { type ChartReaderGrounding } from "../ai/readerGrounding";
13
+ import { type PortableArtifactContract, type SerializedArtifactContract } from "../artifact/serialization";
14
+ import { type ArtifactIdentityBinding } from "../artifact/identity";
15
+ import type { RenderEvidence } from "../server/renderEvidence";
16
+ export { stableEvidenceHash } from "./stableJsonHash";
17
+ export declare const CHART_EVIDENCE_ENVELOPE_VERSION: 1;
18
+ declare const ARTIFACT_TRANSFER_BINDING_VERSION: 2;
19
+ declare const LEGACY_ARTIFACT_TRANSFER_BINDING_VERSION: 1;
20
+ export interface EnvelopeChartSection {
21
+ component: string;
22
+ surfaceVersion: string;
23
+ chartId?: string;
24
+ }
25
+ export interface EnvelopeInputSection {
26
+ source?: string;
27
+ rowCount: number;
28
+ profile: unknown;
29
+ hash?: string;
30
+ }
31
+ export interface EnvelopeTransformOperation {
32
+ operation: string;
33
+ options?: Record<string, unknown>;
34
+ }
35
+ export interface EnvelopeTransformSection {
36
+ operations: EnvelopeTransformOperation[];
37
+ hash?: string;
38
+ }
39
+ export interface EnvelopeRenderSection {
40
+ mode: "svg" | "canvas" | "png" | "not-rendered";
41
+ /** Version 2 identifies rendered SVG and coordinates; unversioned legacy hashes count marks only. */
42
+ sceneHash?: string;
43
+ sceneHashVersion?: 2;
44
+ /** SHA-256 of markCountByType only; this does not identify rendered geometry. */
45
+ markInventoryHash?: string;
46
+ imageHash?: string;
47
+ marksIntended?: number;
48
+ marksObserved?: number;
49
+ parity?: "match" | "mismatch" | "unknown";
50
+ evidence?: RenderEvidence;
51
+ }
52
+ export type EnvelopeAccessSection = ChartAccessContract;
53
+ export interface EnvelopeMeaningClaim {
54
+ claim: string;
55
+ evidenceIds?: string[];
56
+ confidence?: number;
57
+ model?: string;
58
+ supported?: boolean;
59
+ }
60
+ export interface EnvelopeMeaningSection {
61
+ grounding: ChartReaderGrounding;
62
+ communicativeAct?: string;
63
+ claims?: EnvelopeMeaningClaim[];
64
+ }
65
+ export interface ModalityObservation {
66
+ id: string;
67
+ channel: string;
68
+ finding: string;
69
+ severity?: "info" | "warning" | "error";
70
+ model?: string;
71
+ confidence?: number;
72
+ evidenceRefs?: string[];
73
+ }
74
+ export interface ModalityConflict {
75
+ id: string;
76
+ structuredFinding?: string;
77
+ visualFinding?: string;
78
+ resolution?: "structured" | "visual" | "human-review" | "unresolved";
79
+ note?: string;
80
+ }
81
+ export interface EnvelopeModalityChecks {
82
+ structured: {
83
+ observations: ModalityObservation[];
84
+ model: null;
85
+ };
86
+ vision: {
87
+ observations: ModalityObservation[];
88
+ model?: string;
89
+ };
90
+ tandem: {
91
+ agreements: ModalityObservation[];
92
+ conflicts: ModalityConflict[];
93
+ model?: string;
94
+ };
95
+ }
96
+ export interface EnvelopeAuditSection {
97
+ accessibility?: unknown;
98
+ design?: unknown;
99
+ dataPitfalls?: unknown;
100
+ scorecard?: unknown;
101
+ humanReview?: {
102
+ status: "not-run" | "passed" | "failed" | "manual-gap";
103
+ protocol?: string;
104
+ browserMatrix?: string[];
105
+ notes?: string[];
106
+ };
107
+ }
108
+ export interface EnvelopeLimitsSection {
109
+ uncertaintyShown?: boolean;
110
+ knownGaps: string[];
111
+ unsupportedClaims: string[];
112
+ privacyScope: Record<string, string[]>;
113
+ }
114
+ export interface EvidenceEnvelopeOptions {
115
+ surfaceVersion?: string;
116
+ chartId?: string;
117
+ sourceId?: string;
118
+ transformOperations?: EnvelopeTransformOperation[];
119
+ ssrEvidence?: RenderEvidence;
120
+ accessContract?: ChartAccessContract;
121
+ streamStatus?: StreamStatusInput | Array<StreamStatusInput>;
122
+ streamHistoryLimit?: number;
123
+ inChartContainer?: boolean;
124
+ privacyScope?: Record<string, string[]>;
125
+ claims?: EnvelopeMeaningClaim[];
126
+ modalityChecks?: Partial<EnvelopeModalityChecks>;
127
+ audits?: Omit<EnvelopeAuditSection, "accessibility">;
128
+ knownGaps?: string[];
129
+ unsupportedClaims?: string[];
130
+ uncertaintyShown?: boolean;
131
+ /** Optional interpretation contract preserved beside render evidence. */
132
+ artifactContract?: PortableArtifactContract;
133
+ }
134
+ export interface ChartEvidenceEnvelope {
135
+ schemaVersion: typeof CHART_EVIDENCE_ENVELOPE_VERSION;
136
+ chart: EnvelopeChartSection;
137
+ input: EnvelopeInputSection;
138
+ transform: EnvelopeTransformSection;
139
+ render: EnvelopeRenderSection;
140
+ access: EnvelopeAccessSection;
141
+ meaning: EnvelopeMeaningSection;
142
+ modalityChecks: EnvelopeModalityChecks;
143
+ audit: EnvelopeAuditSection;
144
+ limits: EnvelopeLimitsSection;
145
+ artifact?: SerializedArtifactContract & {
146
+ transferBindingVersion: typeof LEGACY_ARTIFACT_TRANSFER_BINDING_VERSION | typeof ARTIFACT_TRANSFER_BINDING_VERSION;
147
+ transferFingerprint: string;
148
+ identityBinding?: ArtifactIdentityBinding;
149
+ };
150
+ }
151
+ /** Assemble a versioned evidence envelope from existing Semiotic payloads. */
152
+ export declare function toEvidenceEnvelope(component: string, props: Record<string, unknown>, options?: EvidenceEnvelopeOptions): ChartEvidenceEnvelope;
153
+ /** Validate and restore an envelope without silently trusting malformed input. */
154
+ export declare function fromEvidenceEnvelope(value: unknown): ChartEvidenceEnvelope;
@@ -0,0 +1,8 @@
1
+ export declare function redactProfileForEnvelope(profile: unknown): unknown;
2
+ /** Recursively remove raw source records from a navigation tree. */
3
+ export declare function redactNavigationTree(tree: unknown): unknown;
4
+ /**
5
+ * Normalize the chart's primary source records across supported data shapes.
6
+ * Used for count and integrity hashing only; records are never stored.
7
+ */
8
+ export declare function normalizeSourceRecords(component: string, props: Record<string, unknown>): ReadonlyArray<unknown>;
@@ -0,0 +1,11 @@
1
+ import type { EnvelopeRenderSection } from "./chartEvidenceEnvelope";
2
+ /** Validate the accessibility fields consumed by the publication gate. */
3
+ export declare function validateEnvelopeAccessibilityAudit(value: unknown, path: string): void;
4
+ /** A nested scene digest has no legacy form: it must always advertise v2. */
5
+ export declare function validateEnvelopeSceneHash(render: EnvelopeRenderSection): void;
6
+ /** Validate both attachment locations before the gate can trust their reports. */
7
+ export declare function validateEnvelopeArtifactAttachment(attachment: {
8
+ contract?: unknown;
9
+ transfer?: unknown;
10
+ binding?: unknown;
11
+ }, path: string): void;
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Evidence publication gate for ChartEvidenceEnvelope@1.
3
+ *
4
+ * This is deliberately conservative: it fails on provable publication risks
5
+ * and records uncertainty rather than inventing semantic or visual agreement.
6
+ */
7
+ import { type ChartEvidenceEnvelope, type EnvelopeLimitsSection } from "./chartEvidenceEnvelope";
8
+ export type EvidenceGateStatus = "pass" | "fail";
9
+ export interface EvidenceGateFinding {
10
+ id: string;
11
+ severity: "error" | "warning";
12
+ message: string;
13
+ }
14
+ export interface EvidenceGateResult {
15
+ status: EvidenceGateStatus;
16
+ ok: boolean;
17
+ findings: EvidenceGateFinding[];
18
+ /** Derived limits for valid envelopes; the caller's envelope is never edited. */
19
+ limits?: EnvelopeLimitsSection;
20
+ }
21
+ export interface EvidenceGateOptions {
22
+ requireRenderEvidence?: boolean;
23
+ requireAccessTable?: boolean;
24
+ requireNavigation?: boolean;
25
+ failOnCrossModalConflicts?: boolean;
26
+ /** Treat accessibility audit warnings as advisory rather than blocking. */
27
+ allowAccessibilityWarnings?: boolean;
28
+ }
29
+ /** Check whether an envelope is safe to publish under the requested policy. */
30
+ export declare function evaluateEvidenceGate(envelope: ChartEvidenceEnvelope, options?: EvidenceGateOptions): EvidenceGateResult;
@@ -0,0 +1,23 @@
1
+ interface RenderedSceneHashContext {
2
+ frameType: string;
3
+ width: number;
4
+ height: number;
5
+ margin?: {
6
+ top: number;
7
+ right: number;
8
+ bottom: number;
9
+ left: number;
10
+ };
11
+ plot?: {
12
+ x: number;
13
+ y: number;
14
+ width: number;
15
+ height: number;
16
+ };
17
+ xDomain?: [number, number];
18
+ yDomain?: [number, number];
19
+ categories?: string[];
20
+ }
21
+ /** Identify the final SVG bytes and coordinates, including post-render theme CSS. */
22
+ export declare function renderedSceneHash(svg: string, context: RenderedSceneHashContext): string;
23
+ export {};
@@ -0,0 +1,4 @@
1
+ /** Stable SHA-256 over key-sorted JSON. */
2
+ export declare function stableEvidenceHash(value: unknown): string;
3
+ /** @internal SHA-256 text primitive used by the stable JSON hash. */
4
+ export declare function sha256Text(message: string): string;
@@ -1,5 +1,7 @@
1
1
  import type { SerializedSelections } from "./selectionSerializer";
2
2
  import type { Datum } from "../charts/shared/datumTypes";
3
+ import type { ArtifactContract } from "../artifact/types";
4
+ import type { ArtifactTransferStatus, PortableArtifactContract } from "../artifact/serialization";
3
5
  export interface ChartConfig {
4
6
  /** Component name, e.g. "LineChart", "SankeyDiagram" */
5
7
  component: string;
@@ -21,21 +23,54 @@ export interface ChartConfig {
21
23
  intents: string[];
22
24
  audience?: string[];
23
25
  frameFamily: string;
26
+ recipeVersion?: string;
27
+ definitionFingerprint?: string;
28
+ layoutId?: string;
29
+ layoutVersion?: string;
30
+ layoutFingerprint?: string;
24
31
  };
32
+ /** Optional interpretation sidecar, kept separate from executable chart props. */
33
+ artifactContract?: PortableArtifactContract;
34
+ /** Explicit preservation/version result for the sidecar. */
35
+ artifactTransfer?: ChartArtifactTransferStatus;
36
+ }
37
+ export interface ChartArtifactTransferStatus extends ArtifactTransferStatus {
38
+ /** Identity of the serialized non-data props; detects later payload drift. */
39
+ serializedConfigFingerprint?: string;
40
+ /** Identity of serialized data, or null when the payload intentionally has none. */
41
+ serializedDataFingerprint?: string | null;
42
+ /** Identity of the component or recipe, contract, transfer report, and payload bindings. */
43
+ transferFingerprint?: string;
25
44
  }
26
45
  export interface ToConfigOptions {
27
46
  /** Include data arrays in the config. Default: true */
28
47
  includeData?: boolean;
29
48
  /** Serialized selection state to embed */
30
49
  selections?: SerializedSelections;
50
+ /** Portable interpretation sidecar to preserve with the chart config. */
51
+ artifactContract?: ArtifactContract;
31
52
  }
32
- export type CopyFormat = "json" | "jsx";
33
- export declare function toConfig(componentName: string, props: Datum, options?: ToConfigOptions): ChartConfig;
34
- export declare function fromConfig(config: ChartConfig): {
53
+ export interface FromConfigResult {
35
54
  componentName: string;
36
55
  props: Datum;
37
- };
38
- export declare function toURL(config: ChartConfig): string;
56
+ artifactContract?: PortableArtifactContract;
57
+ artifactTransfer?: ChartArtifactTransferStatus;
58
+ }
59
+ export interface ToURLOptions {
60
+ /** Refuse an encoded query string longer than this value. Omit for compatibility. */
61
+ maxLength?: number;
62
+ }
63
+ export interface JSXProjectionResult {
64
+ jsx: string;
65
+ omittedPaths: string[];
66
+ warnings: string[];
67
+ }
68
+ export type CopyFormat = "json" | "jsx";
69
+ export declare function toConfig(componentName: string, props: Datum, options?: ToConfigOptions): ChartConfig;
70
+ export declare function fromConfig(config: ChartConfig): FromConfigResult;
71
+ export declare function toURL(config: ChartConfig, options?: ToURLOptions): string;
39
72
  export declare function fromURL(urlString: string): ChartConfig;
40
73
  export declare function copyConfig(config: ChartConfig, format?: CopyFormat): Promise<void>;
41
74
  export declare function configToJSX(config: ChartConfig): string;
75
+ /** Return JSX together with the top-level metadata it cannot represent. */
76
+ export declare function configToJSXWithReport(config: ChartConfig): JSXProjectionResult;
@@ -0,0 +1,6 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import { type ArtifactContract } from "../artifact/types";
3
+ import type { ChartConfig, FromConfigResult } from "./chartConfig";
4
+ export type ChartArtifactBindingContext = Pick<ChartConfig, "version" | "createdAt" | "recipeId" | "portable" | "manifest" | "reason" | "warnings" | "selections">;
5
+ export declare function artifactConfigFields(component: string, contract: ArtifactContract | undefined, sourceProps: Datum, serializedProps: Datum, context: ChartArtifactBindingContext): Pick<ChartConfig, "artifactContract" | "artifactTransfer">;
6
+ export declare function restoredArtifactFields(config: ChartConfig): Pick<FromConfigResult, "artifactContract" | "artifactTransfer">;
@@ -108,6 +108,7 @@ export declare function resolveXYAxisChrome(input: {
108
108
  orient?: string;
109
109
  label?: unknown;
110
110
  autoRotate?: boolean;
111
+ visible?: boolean;
111
112
  }>;
112
113
  rotatedTicks?: boolean;
113
114
  }): AxisChromeInput;
@@ -127,6 +128,7 @@ export declare function resolveXYFramePropsAxisChrome(frameProps: {
127
128
  orient?: string;
128
129
  label?: unknown;
129
130
  autoRotate?: boolean;
131
+ visible?: boolean;
130
132
  }>;
131
133
  }, defaults: {
132
134
  showAxes?: boolean;
@@ -137,6 +139,7 @@ export declare function resolveXYFramePropsAxisChrome(frameProps: {
137
139
  orient?: string;
138
140
  label?: unknown;
139
141
  autoRotate?: boolean;
142
+ visible?: boolean;
140
143
  }>;
141
144
  }): AxisChromeInput;
142
145
  /**
@@ -230,3 +233,18 @@ export declare function resolveLegendMetrics(layout?: LegendLayout): LegendMetri
230
233
  * when labels, multiple groups, or custom row heights are used.
231
234
  */
232
235
  export declare function layoutVerticalLegendGroups(groups: VerticalLegendGroupInput[], rowHeight: number): VerticalLegendGroupLayout[];
236
+ /** Drop only default margins belonging to explicitly hidden XY axes. */
237
+ export declare function resolveHiddenAxisMargins(defaults: {
238
+ top: number;
239
+ right: number;
240
+ bottom: number;
241
+ left: number;
242
+ }, axes: ReadonlyArray<{
243
+ orient: "top" | "bottom" | "left" | "right";
244
+ visible?: boolean;
245
+ }> | undefined, hasTitle?: boolean): {
246
+ top: number;
247
+ right: number;
248
+ bottom: number;
249
+ left: number;
250
+ };
@@ -0,0 +1,4 @@
1
+ import type { CSSProperties } from "react";
2
+ /** Stable style objects avoid allocating identical CSS declarations for every legend label. */
3
+ export declare const LEGEND_FONT_STYLE: CSSProperties;
4
+ export declare const LEGEND_LABEL_STYLE: CSSProperties;
@@ -4,6 +4,10 @@ export interface Bin {
4
4
  end: number;
5
5
  total: number;
6
6
  categories: Map<string, number>;
7
+ /** Raw rows retained only when a scene needs aggregate selection provenance. */
8
+ rows?: Datum[];
9
+ /** Per-category raw rows for stacked aggregate marks. */
10
+ categoryRows?: Map<string, Datum[]>;
7
11
  }
8
- export declare function computeBins(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): Map<number, Bin>;
12
+ export declare function computeBins(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string, trackRows?: boolean): Map<number, Bin>;
9
13
  export declare function computeBinExtent(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): [number, number];
@@ -193,20 +193,29 @@ export interface RealtimeFrameProps {
193
193
  tickFormatTime?: (value: number) => string;
194
194
  tickFormatValue?: (value: number) => string;
195
195
  }
196
- export interface RealtimeFrameHandle {
197
- push(point: Datum): void;
198
- pushMany(points: Datum[]): void;
196
+ /**
197
+ * Imperative push/readback contract shared by streaming-capable HOCs.
198
+ *
199
+ * `TDatum` is the authored input row accepted by `push`/`pushMany`/`replace`.
200
+ * `TReadDatum` defaults to the same type and exists for transforms whose
201
+ * materialized readback is deliberately different (RealtimeLineChart's
202
+ * aggregate mode). Omitting both parameters preserves the loose 3.x `Datum`
203
+ * surface.
204
+ */
205
+ export interface RealtimeFrameHandle<TDatum extends Datum = Datum, TReadDatum extends Datum = TDatum> {
206
+ push(point: TDatum): void;
207
+ pushMany(points: TDatum[]): void;
199
208
  /** Remove data by ID. Requires an ID accessor (pointIdAccessor or dataIdAccessor). */
200
- remove(id: string | string[]): Datum[];
209
+ remove(id: string | string[]): TReadDatum[];
201
210
  /** Update data by ID in place. Requires an ID accessor. Returns previous values. */
202
- update(id: string | string[], updater: (d: Datum) => Datum): Datum[];
211
+ update(id: string | string[], updater: (d: TReadDatum) => TReadDatum): TReadDatum[];
203
212
  /**
204
213
  * Ordinal-only bounded ingest: replace the buffer while preserving category
205
214
  * order and enter/move/exit transitions. XY/network/geo typically omit this.
206
215
  */
207
- replace?(data: Datum[]): void;
216
+ replace?(data: TDatum[]): void;
208
217
  clear(): void;
209
- getData(): Datum[];
218
+ getData(): TReadDatum[];
210
219
  /** Returns the frame's resolved scales, or null if unavailable.
211
220
  *
212
221
  * The concrete scales object differs by frame type — XY charts
@@ -0,0 +1,12 @@
1
+ import type { NetworkCustomLayout } from "../stream/networkCustomLayout";
2
+ import { type AdjacencyFlowConfig } from "./adjacencyFlowGeometry";
3
+ export type { AdjacencyFlowConfig } from "./adjacencyFlowGeometry";
4
+ /**
5
+ * Adjacency-flow ("Sankey Matrix") layout: ordered nodes sit on the diagonal,
6
+ * forward routes occupy the upper-right cells, reverse routes the lower-left,
7
+ * and weighted orthogonal links expose both adjacency and aggregate flow.
8
+ *
9
+ * Parallel edges are summed per matrix cell. Pair with
10
+ * `aggregateAdjacencyFlow` for collapsible group summaries.
11
+ */
12
+ export declare const adjacencyFlowLayout: NetworkCustomLayout<AdjacencyFlowConfig>;