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
@@ -0,0 +1,2 @@
1
+ import { type ChartConfig } from "./serverChartConfigShared";
2
+ export declare const likertChart: 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;
@@ -0,0 +1,14 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ /**
3
+ * Attach the raw rows represented by a derived mark without exposing that
4
+ * internal bookkeeping to tooltips, accessible tables, or serialization.
5
+ */
6
+ export declare function attachSelectionProvenance<TTarget extends object>(datum: TTarget, rows: readonly Datum[] | undefined): TTarget;
7
+ /** Return the raw rows represented by an aggregate mark, when available. */
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;
@@ -1,4 +1,5 @@
1
1
  import type { ThemeSemanticColors } from "../stream/streamThemeTypes";
2
+ import type { AestheticProfile } from "../ai/aestheticProfileTypes";
2
3
  export interface SemioticTheme {
3
4
  mode: "light" | "dark" | "auto";
4
5
  colors: {
@@ -70,12 +71,15 @@ export interface SemioticTheme {
70
71
  /** Enforce minimum 3:1 contrast ratios */
71
72
  highContrast?: boolean;
72
73
  };
74
+ /** Organizational weights for machine-visible presentation features. */
75
+ aesthetics?: AestheticProfile;
73
76
  }
74
- export type SemioticThemeUpdate = Omit<Partial<SemioticTheme>, "colors" | "typography" | "tooltip" | "accessibility"> & {
77
+ export type SemioticThemeUpdate = Omit<Partial<SemioticTheme>, "colors" | "typography" | "tooltip" | "accessibility" | "aesthetics"> & {
75
78
  colors?: Partial<SemioticTheme["colors"]>;
76
79
  typography?: Partial<SemioticTheme["typography"]>;
77
80
  tooltip?: Partial<NonNullable<SemioticTheme["tooltip"]>>;
78
81
  accessibility?: Partial<NonNullable<SemioticTheme["accessibility"]>>;
82
+ aesthetics?: AestheticProfile;
79
83
  };
80
84
  export type ThemeStoreUpdate = SemioticThemeUpdate | "light" | "dark" | "high-contrast";
81
85
  /** Color-blind safe categorical palette (8 colors).
@@ -6,7 +6,7 @@ import type { ActiveTransition } from "./pipelineTransitionUtils";
6
6
  import type { Datum } from "../charts/shared/datumTypes";
7
7
  import type { GeoLayoutResult } from "./geoCustomLayout";
8
8
  import type { CustomLayoutSelection } from "./customLayoutSelection";
9
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
9
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
10
10
  import { GeoPipelineUpdateResults } from "./geoPipelineUpdateResults";
11
11
  import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
12
12
  export declare class GeoPipelineStore implements UpdateResultStore {
@@ -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;
@@ -1,6 +1,8 @@
1
1
  import * as React from "react";
2
2
  import type { ScaleLinear } from "d3-scale";
3
- import type { MarginalConfig, MarginalType } from "./types";
3
+ import type { MarginalConfig } from "./types";
4
+ import { normalizeMarginalConfig } from "./marginalConfig";
5
+ export { normalizeMarginalConfig };
4
6
  export type MarginalOrient = "top" | "bottom" | "left" | "right";
5
7
  export interface MarginalGraphicsProps {
6
8
  orient: MarginalOrient;
@@ -14,6 +16,4 @@ export interface MarginalGraphicsProps {
14
16
  /** Chart width (top/bottom) or height (left/right) */
15
17
  length: number;
16
18
  }
17
- /** Resolve a string shorthand or full config into a MarginalConfig */
18
- export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
19
19
  export declare function MarginalGraphics({ orient, config: rawConfig, values, scale, size, length }: MarginalGraphicsProps): React.JSX.Element | null;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Lazy wrapper for MarginalGraphics.
3
+ *
4
+ * d3-array binning is unused on charts that never set `marginalGraphics`,
5
+ * so keep that graph off the default LineChart cold path. Charts that do
6
+ * request marginals (Scatterplot, BubbleChart) call
7
+ * {@link provideMarginalGraphics} with a value import so SSR and the
8
+ * hydration SVG pass can paint immediately.
9
+ */
10
+ import * as React from "react";
11
+ import type { Datum } from "../charts/shared/datumTypes";
12
+ import type { MarginalGraphicsProps } from "./MarginalGraphics";
13
+ import { normalizeMarginalConfig } from "./marginalConfig";
14
+ export { normalizeMarginalConfig };
15
+ type MarginalComponent = React.ComponentType<MarginalGraphicsProps>;
16
+ /** Eagerly install the painter. Call from HOCs that expose `marginalGraphics`. */
17
+ export declare function provideMarginalGraphics(Comp: MarginalComponent): void;
18
+ export declare function collectMarginalValues(data: readonly Datum[], xAccessor: unknown, yAccessor: unknown): {
19
+ xValues: number[];
20
+ yValues: number[];
21
+ };
22
+ export declare function MarginalGraphicsLazy(props: MarginalGraphicsProps): React.JSX.Element | null;
@@ -38,6 +38,8 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
38
38
  sceneNodes: NetworkSceneNode[];
39
39
  sceneEdges: NetworkSceneEdge[];
40
40
  labels: NetworkLabel[];
41
+ /** Backgrounds returned from customNetworkLayout (consumed by StreamNetworkFrame). */
42
+ customLayoutBackgrounds: import("react").ReactNode;
41
43
  /** Overlays returned from customNetworkLayout (consumed by StreamNetworkFrame). */
42
44
  customLayoutOverlays: import("react").ReactNode;
43
45
  /** Most recent custom layout result for host readback (`getCustomLayout()`).
@@ -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: {
@@ -22,7 +22,7 @@ import type { Changeset, PointSceneNode } from "./types";
22
22
  import type { ActiveTransition } from "./pipelineTransitionUtils";
23
23
  import type { OrdinalLayoutResult } from "./ordinalCustomLayout";
24
24
  import type { CustomLayoutSelection } from "./customLayoutSelection";
25
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
25
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
26
26
  import { type UpdateResult, type UpdateResultStore } from "./pipelineUpdateStore";
27
27
  import { OrdinalPipelineUpdateResults } from "./ordinalPipelineUpdateResults";
28
28
  export declare class OrdinalPipelineStore implements UpdateResultStore {
@@ -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;
@@ -23,7 +23,7 @@ import { type ActiveTransition } from "./pipelineTransitionUtils";
23
23
  import type { ResolvedRibbon } from "./xySceneBuilders/ribbonScene";
24
24
  import type { LayoutResult } from "./customLayout";
25
25
  import type { CustomLayoutSelection } from "./customLayoutSelection";
26
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
26
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
27
27
  import { type PipelineConfig } from "./pipelineConfig";
28
28
  import type { UpdateResult } from "./pipelineUpdateContract";
29
29
  import { type UpdateResultStore } from "./pipelineUpdateStore";
@@ -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 declare const isServerEnvironment: boolean;
@@ -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,6 +10,8 @@ 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
15
  /**
14
16
  * Keep a canvas's backing store and CSS box aligned with the frame size.
15
17
  * This is separate from context preparation so an idle interaction layer can
@@ -33,9 +35,13 @@ export declare function prepareCanvas(canvas: HTMLCanvasElement, size: [number,
33
35
  * Get the effective canvas devicePixelRatio, defaulting to 1 in non-browser
34
36
  * environments. By default, mobile/coarse-pointer screens are capped at 2x to
35
37
  * avoid allocating very large backing stores on high-density phones and
36
- * desktop is capped at 3x. `maxDevicePixelRatio` overrides that ceiling.
38
+ * desktop is capped at 3x. `maxDevicePixelRatio` overrides that DPR ceiling.
39
+ * When `size` is supplied, very large canvases receive an additional backing-
40
+ * store cap so full repaints do not allocate or clear tens of megapixels and
41
+ * DPR scaling does not push a physical side beyond the broadly supported 16K
42
+ * range.
37
43
  */
38
- export declare function getDevicePixelRatio(maxDevicePixelRatio?: number): number;
44
+ export declare function getDevicePixelRatio(maxDevicePixelRatio?: number, size?: readonly [number, number]): number;
39
45
  /**
40
46
  * Subscribe to browser pixel-density changes (page zoom, display migration,
41
47
  * or OS display-scale changes). A normal ResizeObserver is insufficient:
@@ -0,0 +1,21 @@
1
+ import { type CustomLayoutFamily, type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
2
+ export type CustomLayoutAttemptResult<T> = {
3
+ kind: "success";
4
+ result: T;
5
+ } | {
6
+ kind: "failure";
7
+ diagnostic: CustomLayoutFailureDiagnostic;
8
+ preservedLastGoodScene: boolean;
9
+ };
10
+ /**
11
+ * Shared custom-layout try/catch + diagnostic + onLayoutError boundary.
12
+ * Each family store still applies its own success/failure scene recovery.
13
+ */
14
+ export declare function runCustomLayoutAttempt<T>(options: {
15
+ family: CustomLayoutFamily;
16
+ logLabel: string;
17
+ revision: number;
18
+ hasPreviousResult: boolean;
19
+ onLayoutError?: (diagnostic: CustomLayoutFailureDiagnostic) => void;
20
+ run: () => T;
21
+ }): CustomLayoutAttemptResult<T>;
@@ -206,7 +206,7 @@ export interface StreamGeoFrameProps<T = Datum> {
206
206
  };
207
207
  className?: string;
208
208
  background?: string;
209
- /** Maximum canvas backing-store DPR; defaults to the environment cap. */
209
+ /** Maximum canvas backing-store DPR; large canvases also use the shared backing-store budget. */
210
210
  maxDevicePixelRatio?: number;
211
211
  runtimeMode?: "bounded" | "streaming";
212
212
  /** Maximum retained points and lines after imperative streaming begins. @default 500 */
@@ -7,6 +7,8 @@ export interface RectHitResult {
7
7
  cx: number;
8
8
  cy: number;
9
9
  }
10
+ /** Distance to a segment, including a segment collapsed to a single point. */
11
+ export declare function pointToSegmentDistance(px: number, py: number, ax: number, ay: number, bx: number, by: number): number;
10
12
  /**
11
13
  * Test whether a point (px, py) falls within a rectangle defined by
12
14
  * { x, y, w, h } and return the rectangle's center coordinates.
@@ -0,0 +1,6 @@
1
+ /**
2
+ * True in a Node/SSR context where `window` / `document` are unavailable.
3
+ * Kept as its own module so Stream Frames can detect SSR without importing
4
+ * the XY scene-to-SVG serializer graph.
5
+ */
6
+ export declare const isServerEnvironment: boolean;
@@ -0,0 +1,12 @@
1
+ import type { Datum } from "../../charts/shared/datumTypes";
2
+ import type { RealtimeNode } from "../networkTypes";
3
+ /**
4
+ * Build a function that returns a node radius. If `nodeSize` is a number,
5
+ * use it directly. If it is a string accessor, look up `node.data[nodeSize]`
6
+ * and scale the result to `nodeSizeRange`. If it is a function, call it.
7
+ * Falls back to a default radius of 8.
8
+ *
9
+ * Lives outside `forceLayoutPlugin` so the force worker client can serialize
10
+ * radii without importing d3-force.
11
+ */
12
+ export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
@@ -1,10 +1,3 @@
1
- import type { NetworkLayoutPlugin, RealtimeNode } from "../networkTypes";
2
- import type { Datum } from "../../charts/shared/datumTypes";
1
+ import type { NetworkLayoutPlugin } from "../networkTypes";
3
2
  export declare const forceLayoutPlugin: NetworkLayoutPlugin;
4
- /**
5
- * Build a function that returns a node radius. If `nodeSize` is a number,
6
- * use it directly. If it is a string accessor, look up `node.data[nodeSize]`
7
- * and scale the result to `nodeSizeRange`. If it is a function, call it.
8
- * Falls back to a default radius of 8.
9
- */
10
- export declare function resolveNodeSizeFn(nodeSize: number | string | ((d: Datum) => number) | undefined, nodeSizeRange: [number, number] | undefined, allNodes: RealtimeNode[]): (node: RealtimeNode) => number;
3
+ export { resolveNodeSizeFn } from "./forceLayoutNodeSize";
@@ -1,7 +1,7 @@
1
1
  import type { GraphEdge, GraphNode, Point } from "../../recipes/networkAnalysis";
2
2
  import type { ForceLayoutOptions } from "../../recipes/forceLayout";
3
- import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "../networkTypes";
4
- export type ForceLayoutExecution = "auto" | "worker" | "sync";
3
+ import { type FrameForceWorkerRequest } from "./forceLayoutWorkerPolicy";
4
+ export { canUseForceWorker, createFrameForceWorkerRequest, DEFAULT_FORCE_WORKER_THRESHOLD, shouldUseForceWorker, type ForceLayoutExecution, type FrameForceWorkerRequest, } from "./forceLayoutWorkerPolicy";
5
5
  export interface NormalizedForceWorkerRequest {
6
6
  kind: "normalized";
7
7
  nodes: GraphNode[];
@@ -9,30 +9,11 @@ export interface NormalizedForceWorkerRequest {
9
9
  options: Omit<ForceLayoutOptions, "nodeRadius">;
10
10
  nodeRadii?: Record<string, number>;
11
11
  }
12
- export interface FrameForceWorkerRequest {
13
- kind: "frame";
14
- nodes: RealtimeNode[];
15
- edges: RealtimeEdge[];
16
- config: {
17
- chartType: "force";
18
- iterations?: number;
19
- forceStrength?: number;
20
- seed?: number;
21
- };
22
- size: [number, number];
23
- }
24
12
  export type ForceWorkerRequest = NormalizedForceWorkerRequest | FrameForceWorkerRequest;
25
13
  export interface ForceWorkerResponse {
26
14
  positions: Record<string, Point>;
27
15
  }
28
- export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
29
- export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
30
- export declare function canUseForceWorker(): boolean;
31
16
  export declare function createForceLayoutWorker(): Worker;
32
- export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
33
- x: number;
34
- y: number;
35
- }> | null): FrameForceWorkerRequest;
36
17
  /**
37
18
  * Long-lived force-layout worker session. Built on {@link ModuleWorkerSession}
38
19
  * so request-id / abort / terminate plumbing is shared with ProcessSankey.
@@ -0,0 +1,21 @@
1
+ import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "../networkTypes";
2
+ export type ForceLayoutExecution = "auto" | "worker" | "sync";
3
+ export interface FrameForceWorkerRequest {
4
+ kind: "frame";
5
+ nodes: RealtimeNode[];
6
+ edges: RealtimeEdge[];
7
+ config: {
8
+ chartType: "force";
9
+ iterations?: number;
10
+ forceStrength?: number;
11
+ seed?: number;
12
+ };
13
+ size: [number, number];
14
+ }
15
+ export declare const DEFAULT_FORCE_WORKER_THRESHOLD = 40000;
16
+ export declare function shouldUseForceWorker(execution: ForceLayoutExecution, nodeCount: number, edgeCount: number, iterations: number, threshold?: number): boolean;
17
+ export declare function canUseForceWorker(): boolean;
18
+ export declare function createFrameForceWorkerRequest(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], previousPositions?: Map<string, {
19
+ x: number;
20
+ y: number;
21
+ }> | null): FrameForceWorkerRequest;
@@ -1,12 +1,6 @@
1
- import type { NetworkLayoutPlugin, NetworkChartType } from "../networkTypes";
2
- import { sankeyLayoutPlugin } from "./sankeyLayoutPlugin";
3
- import { forceLayoutPlugin } from "./forceLayoutPlugin";
4
- import { chordLayoutPlugin } from "./chordLayoutPlugin";
5
- import { hierarchyLayoutPlugin } from "./hierarchyLayoutPlugin";
6
- import { orbitLayoutPlugin } from "./orbitLayoutPlugin";
7
- /**
8
- * Registry mapping network chart types to their layout plugins.
9
- */
10
- export declare const networkLayoutRegistry: Record<NetworkChartType, NetworkLayoutPlugin>;
11
- export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
12
- export { sankeyLayoutPlugin, forceLayoutPlugin, chordLayoutPlugin, hierarchyLayoutPlugin, orbitLayoutPlugin };
1
+ export { getLayoutPlugin, registerLayoutPlugin } from "./registry";
2
+ export { sankeyLayoutPlugin } from "./sankeyLayoutPlugin";
3
+ export { forceLayoutPlugin } from "./forceLayoutPlugin";
4
+ export { chordLayoutPlugin } from "./chordLayoutPlugin";
5
+ export { hierarchyLayoutPlugin } from "./hierarchyLayoutPlugin";
6
+ export { orbitLayoutPlugin } from "./orbitLayoutPlugin";
@@ -0,0 +1,7 @@
1
+ import type { NetworkChartType } from "../networkTypes";
2
+ /**
3
+ * Direct StreamNetworkFrame usage no longer loads every layout. Warn once in
4
+ * development when a chartType has no registered plugin so the empty scene is
5
+ * not silent.
6
+ */
7
+ export declare function warnIfLayoutPluginMissing(chartType: NetworkChartType): void;
@@ -0,0 +1 @@
1
+ export declare function registerBuiltInNetworkLayouts(): void;
@@ -0,0 +1,12 @@
1
+ import type { NetworkChartType, NetworkLayoutPlugin } from "../networkTypes";
2
+ /**
3
+ * Register a network layout plugin. Call this with a value import of the
4
+ * plugin — `package.json` has `"sideEffects": false`, so a bare
5
+ * `import "./sankeyLayoutPlugin"` may be dropped by consumer bundlers.
6
+ *
7
+ * Chart HOCs register only the plugin they need. Direct StreamNetworkFrame
8
+ * users should import the matching plugin or call
9
+ * {@link registerBuiltInNetworkLayouts} from `semiotic/network`.
10
+ */
11
+ export declare function registerLayoutPlugin(chartType: NetworkChartType, plugin: NetworkLayoutPlugin): void;
12
+ export declare function getLayoutPlugin(chartType: NetworkChartType): NetworkLayoutPlugin | undefined;
@@ -0,0 +1,3 @@
1
+ import type { MarginalConfig, MarginalType } from "./types";
2
+ /** Resolve a string shorthand or full config into a MarginalConfig */
3
+ export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
@@ -135,6 +135,13 @@ export interface NetworkLayoutResult {
135
135
  sceneEdges?: NetworkSceneEdge[];
136
136
  /** Optional labels placed at arbitrary plot-relative positions. */
137
137
  labels?: NetworkLabel[];
138
+ /**
139
+ * SVG graphics composited below the canvas scene. Use for layout-derived
140
+ * regions and enclosures that must sit behind edges and nodes while sharing
141
+ * their fitted plot coordinates. Backgrounds are non-interactive and are
142
+ * included in live, hydrated, and static SVG rendering.
143
+ */
144
+ backgrounds?: ReactNode;
138
145
  /** SVG overlays composited above the canvas. */
139
146
  overlays?: ReactNode;
140
147
  /**
@@ -0,0 +1,13 @@
1
+ import type { ReactNode } from "react";
2
+ import type { NetworkHtmlMark, NetworkLayoutResult } from "./networkCustomLayout";
3
+ /** Mutable custom-layout output fields owned by NetworkPipelineStore. */
4
+ export interface NetworkCustomLayoutOutputTarget {
5
+ customLayoutBackgrounds: ReactNode;
6
+ customLayoutOverlays: ReactNode;
7
+ customLayoutHtmlMarks: NetworkHtmlMark[];
8
+ lastCustomLayoutResult: NetworkLayoutResult | null;
9
+ }
10
+ /** Apply the non-scene output from one successful custom-layout result atomically. */
11
+ export declare function applyNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget, result: NetworkLayoutResult): void;
12
+ /** Clear every non-scene custom-layout output when its owning layout is gone. */
13
+ export declare function clearNetworkCustomLayoutOutput(target: NetworkCustomLayoutOutputTarget): void;
@@ -1,5 +1,5 @@
1
1
  import type { NetworkLayoutResult } from "./networkCustomLayout";
2
- import { type CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
2
+ import type { CustomLayoutFailureDiagnostic } from "./customLayoutFailure";
3
3
  import type { NetworkPipelineConfig, RealtimeEdge, RealtimeNode } from "./networkTypes";
4
4
  interface NetworkCustomLayoutRunInput {
5
5
  config: NetworkPipelineConfig;