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,72 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ export type AdjacencyFlowNodeAccessor = string | ((node: Datum) => string | undefined);
3
+ export type AdjacencyFlowEdgeAccessor = string | ((edge: Datum) => string | undefined);
4
+ export type AdjacencyFlowValueAccessor = string | ((edge: Datum) => number | undefined);
5
+ export interface AggregateAdjacencyFlowOptions {
6
+ /** Node field (or callback) that names the ordered step. @default "id" */
7
+ nodeIdAccessor?: AdjacencyFlowNodeAccessor;
8
+ /** Node field (or callback) that supplies the collapsed group. @default "group" */
9
+ groupAccessor?: AdjacencyFlowNodeAccessor;
10
+ /** Node field (or callback) used for group/member labels. @default "label" */
11
+ labelAccessor?: AdjacencyFlowNodeAccessor;
12
+ /** Edge endpoint fields (or callbacks). @default "source" / "target" */
13
+ sourceAccessor?: AdjacencyFlowEdgeAccessor;
14
+ targetAccessor?: AdjacencyFlowEdgeAccessor;
15
+ /** Edge weight field (or callback). @default "value" */
16
+ valueAccessor?: AdjacencyFlowValueAccessor;
17
+ /** Groups left at member-level detail while every other multi-node group collapses. */
18
+ expandedGroups?: Iterable<string>;
19
+ /** Keep one-node groups as aggregate nodes too. @default false */
20
+ collapseSingletons?: boolean;
21
+ /** Preserve within-group movement as a self-flow on a collapsed node. @default true */
22
+ includeInternalFlows?: boolean;
23
+ /** Prefix for generated collapsed-node ids. @default "group:" */
24
+ groupIdPrefix?: string;
25
+ }
26
+ export type AggregatedAdjacencyFlowNode = Datum & {
27
+ id: string;
28
+ label: string;
29
+ group: string;
30
+ aggregate: boolean;
31
+ memberIds: string[];
32
+ memberCount: number;
33
+ internalValue: number;
34
+ incomingValue: number;
35
+ outgoingValue: number;
36
+ };
37
+ export type AggregatedAdjacencyFlowEdge = Datum & {
38
+ source: string;
39
+ target: string;
40
+ value: number;
41
+ edgeCount: number;
42
+ internal: boolean;
43
+ memberEdges: Datum[];
44
+ };
45
+ export interface AdjacencyFlowGroupSummary {
46
+ group: string;
47
+ nodeId: string | null;
48
+ label: string;
49
+ collapsed: boolean;
50
+ memberIds: string[];
51
+ internalValue: number;
52
+ incomingValue: number;
53
+ outgoingValue: number;
54
+ }
55
+ export interface AggregatedAdjacencyFlowResult {
56
+ nodes: AggregatedAdjacencyFlowNode[];
57
+ edges: AggregatedAdjacencyFlowEdge[];
58
+ groups: AdjacencyFlowGroupSummary[];
59
+ /** Edges with missing endpoints, non-positive values, or non-finite values. */
60
+ omittedEdgeCount: number;
61
+ }
62
+ /**
63
+ * Collapse an ordered flow network into group-level steps while retaining the
64
+ * weighted movement needed by {@link adjacencyFlowLayout}. The transform is
65
+ * deliberately headless: use it for a static summary, or change
66
+ * `expandedGroups` in application state for expand/collapse exploration.
67
+ *
68
+ * Parallel cross-group edges are summed. Within-group edges become a self-flow
69
+ * by default, so a summary does not silently discard the activity that made the
70
+ * detail view substantial.
71
+ */
72
+ export declare function aggregateAdjacencyFlow(inputNodes: readonly Datum[], inputEdges: readonly Datum[], options?: AggregateAdjacencyFlowOptions): AggregatedAdjacencyFlowResult;
@@ -0,0 +1,79 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ import type { RealtimeEdge, RealtimeNode } from "../stream/networkTypes";
3
+ export interface AdjacencyFlowConfig {
4
+ /** Explicit sequence for diagonal nodes. Unlisted nodes retain input order. */
5
+ order?: readonly string[];
6
+ /** Node field (or callback) used for the displayed label. @default "label" */
7
+ labelAccessor?: string | ((node: Datum) => string);
8
+ /** Edge field (or callback) used for flow magnitude. @default "value" */
9
+ valueAccessor?: string | ((edge: Datum) => number | undefined);
10
+ /** Outer matrix padding in plot pixels. @default 18 */
11
+ padding?: number;
12
+ /** Upper bound for one matrix cell. Keeps summaries compact. @default 120 */
13
+ maxCellSize?: number;
14
+ /** Square node size in pixels. By default it is derived from cell size. */
15
+ nodeSize?: number;
16
+ /** Space reserved at either end of each node port. @default 4 */
17
+ portPadding?: number;
18
+ /** Separation between adjacent flow strokes at a node port. @default 0.75 */
19
+ flowGap?: number;
20
+ /** Smallest preferred visible flow width before fit-to-port shrinking. @default 1.25 */
21
+ minFlowWidth?: number;
22
+ /** Largest allowed flow width. @default Infinity */
23
+ maxFlowWidth?: number;
24
+ /** Fixed pixels per value unit. Omit to fit the busiest port automatically. */
25
+ flowScale?: number;
26
+ /** Radius for the orthogonal turn fillet. @default 10 */
27
+ cornerRadius?: number;
28
+ /** Flow color encoding. "source" also applies the source color to its node. @default "single" */
29
+ colorMode?: "single" | "source" | "target" | "edge";
30
+ /** Single color or per-aggregated-edge callback. */
31
+ edgeColor?: string | ((edge: Datum) => string | undefined);
32
+ /** Node color or per-node callback. */
33
+ nodeColor?: string | ((node: Datum, index: number) => string | undefined);
34
+ nodeTextColor?: string;
35
+ nodeStroke?: string;
36
+ /** Dotted adjacency grid behind the routes. @default true */
37
+ showGrid?: boolean;
38
+ /** Numeric labels at matrix-cell turns. @default true */
39
+ showValues?: boolean;
40
+ valueFormat?: (value: number, edge: Datum) => string;
41
+ /** Direction arrow placed on every route. @default true */
42
+ showArrows?: boolean;
43
+ /** Arrow fill. Defaults to the --semiotic-adjacency-flow-arrow-fill CSS variable. */
44
+ arrowColor?: string;
45
+ /** Maximum arrow width across its route. @default 14 */
46
+ arrowSize?: number;
47
+ labelFontSize?: number;
48
+ valueFontSize?: number;
49
+ /** Maximum visible label length before an ellipsis. @default 14 */
50
+ maxLabelLength?: number;
51
+ }
52
+ export interface PlacedNode {
53
+ id: string;
54
+ label: string;
55
+ datum: Datum;
56
+ index: number;
57
+ cx: number;
58
+ cy: number;
59
+ }
60
+ export interface FlowEdge {
61
+ key: string;
62
+ source: string;
63
+ target: string;
64
+ sourceIndex: number;
65
+ targetIndex: number;
66
+ value: number;
67
+ edgeCount: number;
68
+ memberEdges: Datum[];
69
+ datum: Datum;
70
+ width: number;
71
+ color: string;
72
+ }
73
+ export declare function rawDatum(value: RealtimeNode | RealtimeEdge): Datum;
74
+ export declare function roundedOrthogonalPath(points: ReadonlyArray<[number, number]>, radius: number): string;
75
+ export declare function arrowPath(x: number, y: number, angle: number, length: number, width?: number): string;
76
+ export declare function truncateLabel(label: string, maxLength: number): string;
77
+ export declare function adjacencyFlowAggregateEdges(edges: readonly RealtimeEdge[], indexById: Map<string, number>, config: AdjacencyFlowConfig): FlowEdge[];
78
+ export declare function allocateAdjacencyFlowWidths(edges: FlowEdge[], nodeSize: number, config: AdjacencyFlowConfig): Map<string, FlowEdge[]>;
79
+ export declare function allocateAdjacencyFlowPorts(groups: Map<string, FlowEdge[]>, nodesById: Map<string, PlacedNode>, nodeSize: number, config: AdjacencyFlowConfig): Map<string, number>;
@@ -0,0 +1,17 @@
1
+ /**
2
+ * First-fit track allocation without scanning every occupied track. Each tree
3
+ * entry holds the earliest end in its track range, letting a search skip whole
4
+ * occupied ranges while still choosing the lowest available track index.
5
+ *
6
+ * Starts need not be ordered (span-arc packing sorts by width). NaN leaves
7
+ * represent unavailable tracks, including unused capacity; unlike Infinity,
8
+ * they never qualify even when an interval starts at Infinity.
9
+ */
10
+ export declare class FirstAvailableTrack {
11
+ count: number;
12
+ private capacity;
13
+ private tree;
14
+ assign(start: number, end: number): number;
15
+ private minimum;
16
+ private grow;
17
+ }
@@ -35,7 +35,7 @@ export interface PackIntervalsOptions<T> {
35
35
  /**
36
36
  * Greedy interval packing: assign each interval to the first sub-track whose
37
37
  * last interval has already ended, otherwise open a new track. The textbook
38
- * Gantt/swimlane packer. O(n·tracks).
38
+ * Gantt/swimlane packer. O(n log tracks) after sorting.
39
39
  *
40
40
  * @example
41
41
  * ```ts
@@ -53,6 +53,11 @@ export interface LineageDagConfig {
53
53
  backEdgeAccessor?: string;
54
54
  /** Edge type, drives edge color. @default "edgeType" */
55
55
  edgeTypeAccessor?: string;
56
+ /**
57
+ * Draw a convex hull behind nodes sharing this datum field (for example,
58
+ * `"subtopologyId"`). Omit to render no hull background.
59
+ */
60
+ hullGroupAccessor?: string;
56
61
  /** Fill per partition. Overridable; recipe ships dark-theme-friendly defaults. */
57
62
  partitionColors?: Partial<Record<string, string>>;
58
63
  /** Edge stroke per edgeType, plus `back` for back-edges. */
@@ -71,6 +76,18 @@ export interface LineageDagConfig {
71
76
  edgeWidth?: number;
72
77
  /** Back-edge stroke width in px. @default `edgeWidth`, else 1.5 */
73
78
  backEdgeWidth?: number;
79
+ /** Hull fill/stroke color overrides keyed by stringified group value. */
80
+ hullColors?: Partial<Record<string, string>>;
81
+ /** Space in px between node rectangles and their group hull. @default 16 */
82
+ hullPadding?: number;
83
+ /** Rounded hull-corner radius in px. @default 12 */
84
+ hullRadius?: number;
85
+ /** Hull fill opacity. @default 0.08 */
86
+ hullFillOpacity?: number;
87
+ /** Hull stroke opacity. @default 0.4 */
88
+ hullStrokeOpacity?: number;
89
+ /** Optional visible label for each hull group. */
90
+ hullLabel?: (groupValue: string) => string;
74
91
  /**
75
92
  * Render the per-node icon. Receives the resolved semantic/partition, the
76
93
  * pixel size to draw within, and a color hint. Return any SVG node. When
@@ -0,0 +1,22 @@
1
+ import type { ReactNode } from "react";
2
+ export interface LineageHullRect {
3
+ id: string;
4
+ x: number;
5
+ y: number;
6
+ w: number;
7
+ h: number;
8
+ }
9
+ export interface LineageHullOptions {
10
+ colors?: Partial<Record<string, string>>;
11
+ padding: number;
12
+ radius: number;
13
+ fillOpacity: number;
14
+ strokeOpacity: number;
15
+ label?: (groupValue: string) => string;
16
+ resolveColor: (key: string) => string;
17
+ dimById: ReadonlyMap<string, boolean>;
18
+ selectedId: string | null;
19
+ dimOpacity: number;
20
+ }
21
+ /** Deterministic plot-space hull layer for lineageDagLayout. */
22
+ export declare function renderLineageHullBackgrounds(groups: Map<string, LineageHullRect[]>, options: LineageHullOptions): ReactNode;
@@ -0,0 +1,75 @@
1
+ import { type ReactNode } from "react";
2
+ import type { Datum } from "../charts/shared/datumTypes";
3
+ import type { NetworkCustomLayout } from "../stream/networkCustomLayout";
4
+ import { computeTransitDiagramPositions, octilinearRoute, offsetTransitPath, roundedTransitPath } from "./transitDiagramGeometry";
5
+ export interface TransitDiagramLineDescriptor {
6
+ id: string;
7
+ color?: string;
8
+ label?: string;
9
+ }
10
+ export type TransitDiagramLineValue = string | number | TransitDiagramLineDescriptor | ReadonlyArray<string | number | TransitDiagramLineDescriptor>;
11
+ export type TransitDiagramMode = "primary" | "compact" | "minimap";
12
+ export interface TransitDiagramStationRenderInfo {
13
+ /** Raw station datum supplied to the chart. */
14
+ station: Datum;
15
+ /** Fitted center in plot coordinates. */
16
+ x: number;
17
+ /** Fitted center in plot coordinates. */
18
+ y: number;
19
+ /** Radius resolved for the active detail mode. */
20
+ radius: number;
21
+ /** Ordered line ids that pass through this station. */
22
+ lineIds: readonly string[];
23
+ interchange: boolean;
24
+ mode: Exclude<TransitDiagramMode, "minimap">;
25
+ }
26
+ export interface TransitDiagramConfig {
27
+ /** Complete authored x/y positions win by default; otherwise use topology. */
28
+ layoutMode?: "auto" | "authored" | "automatic";
29
+ /** Station and track level of detail. @default "primary" */
30
+ mode?: TransitDiagramMode;
31
+ xAccessor?: string | ((d: Datum) => number | undefined);
32
+ yAccessor?: string | ((d: Datum) => number | undefined);
33
+ labelAccessor?: string | ((d: Datum) => string);
34
+ lineAccessor?: string | ((d: Datum) => TransitDiagramLineValue | undefined);
35
+ lineColorAccessor?: string | ((d: Datum) => string | undefined);
36
+ /** Derive one line per source node and propagate it through a directed DAG. */
37
+ lineMode?: "source-rooted";
38
+ /** Source-node color used by source-rooted lines. Defaults to `color`. */
39
+ sourceColorAccessor?: string | ((d: Datum) => string);
40
+ lineColors?: Record<string, string>;
41
+ /** Preferred global order for parallel lines. Remaining lines sort by id. */
42
+ lineOrder?: string[];
43
+ /** Field containing authored intermediate `{x,y}` points. @default "points" */
44
+ pointsAccessor?: string;
45
+ padding?: number;
46
+ componentGap?: number;
47
+ /** Preferred endpoint for the automatic topology layout. */
48
+ rootId?: string;
49
+ direction?: "left-to-right" | "right-to-left";
50
+ lineWidth?: number;
51
+ lineGap?: number;
52
+ cornerRadius?: number;
53
+ stationRadius?: number;
54
+ interchangeRadius?: number;
55
+ stationFill?: string;
56
+ stationStroke?: string;
57
+ /** Replace primary/compact station circles with SVG rendered above the tracks. */
58
+ renderStation?: (info: TransitDiagramStationRenderInfo) => ReactNode;
59
+ showLabels?: boolean;
60
+ labelFontSize?: number;
61
+ labelColor?: string;
62
+ dimOpacity?: number;
63
+ }
64
+ /**
65
+ * Transit-diagram renderer for authored maps and plain directed graphs.
66
+ *
67
+ * Complete station x/y coordinates are fitted and honored. Otherwise the
68
+ * recipe computes a byte-stable topology-led layout with id-based tie breaks.
69
+ * Connections use horizontal, vertical, and 45-degree segments. Detail modes,
70
+ * source-rooted lines, custom station glyphs, waypoints, and line order all
71
+ * share the same fitted geometry.
72
+ */
73
+ export declare const transitDiagramLayout: NetworkCustomLayout<TransitDiagramConfig>;
74
+ export { computeTransitDiagramPositions, octilinearRoute, offsetTransitPath, roundedTransitPath };
75
+ export type { TransitDiagramPoint, TransitDiagramPositionOptions, TransitDiagramPositionResult, TransitDiagramPositionedNode, } from "./transitDiagramGeometry";
@@ -0,0 +1,47 @@
1
+ import type { Datum } from "../charts/shared/datumTypes";
2
+ export interface TransitDiagramPoint {
3
+ x: number;
4
+ y: number;
5
+ }
6
+ export interface TransitDiagramPositionedNode {
7
+ id: string;
8
+ x: number;
9
+ y: number;
10
+ data: Datum;
11
+ }
12
+ export interface TransitDiagramPositionOptions {
13
+ /** Force authored or automatic geometry. By default complete x/y data wins. */
14
+ layoutMode?: "auto" | "authored" | "automatic";
15
+ xAccessor?: string | ((d: Datum) => number | undefined);
16
+ yAccessor?: string | ((d: Datum) => number | undefined);
17
+ padding?: number;
18
+ componentGap?: number;
19
+ /** Preferred automatic-layout endpoint for its connected component. */
20
+ rootId?: string;
21
+ /** Place the automatic root at the left or right edge. @default "left-to-right" */
22
+ direction?: "left-to-right" | "right-to-left";
23
+ }
24
+ export interface TransitDiagramPositionResult {
25
+ positions: Map<string, TransitDiagramPositionedNode>;
26
+ mode: "authored" | "automatic";
27
+ warnings: string[];
28
+ /** Fit a point from the authored coordinate system into plot space. */
29
+ projectAuthoredPoint: (point: TransitDiagramPoint) => TransitDiagramPoint;
30
+ }
31
+ interface TransitDiagramEdgeLike {
32
+ source: string;
33
+ target: string;
34
+ }
35
+ interface PlotBox {
36
+ width: number;
37
+ height: number;
38
+ }
39
+ export declare function computeTransitDiagramPositions(nodes: readonly {
40
+ id: string;
41
+ data: Datum;
42
+ }[], edges: readonly TransitDiagramEdgeLike[], plot: PlotBox, options?: TransitDiagramPositionOptions): TransitDiagramPositionResult;
43
+ /** Route two points with only horizontal, vertical, and 45-degree segments. */
44
+ export declare function octilinearRoute(source: TransitDiagramPoint, target: TransitDiagramPoint): TransitDiagramPoint[];
45
+ export declare function offsetTransitPath(points: readonly TransitDiagramPoint[], distance: number): TransitDiagramPoint[];
46
+ export declare function roundedTransitPath(points: readonly TransitDiagramPoint[], radius: number): string;
47
+ export {};
@@ -0,0 +1,9 @@
1
+ /**
2
+ * semiotic/access — public access-contract surface.
3
+ *
4
+ * This entry is deliberately separate from chart family entries so production
5
+ * routes do not load access tooling merely to render a chart.
6
+ */
7
+ export { CHART_ACCESS_CONTRACT_VERSION, createChartAccessContract, } from "./access/chartAccessContract";
8
+ export type { AccessStatusRecord, ChartAccessContract, ChartAccessContractInput, ChartAccessContractText, ChartAccessContractKeyboard, ChartAccessContractNavigation, ChartAccessContractMediaPreferences, ChartAccessContractStreamStatus, ChartAccessContractSsr, ChartAccessContractEvidence, StreamStatusInput, } from "./access/chartAccessContract";
9
+ export { BAR_CHART_ACCESS_CONTRACT, LINE_CHART_ACCESS_CONTRACT, REALTIME_LINE_CHART_ACCESS_CONTRACT, } from "./access/chartAccessContractFixtures";
@@ -0,0 +1,17 @@
1
+ export { validateProps } from "./charts/shared/validateProps";
2
+ export type { ValidationResult } from "./charts/shared/validateProps";
3
+ export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
4
+ export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
5
+ export { diagnoseTokenEncoding, normalizeTokenEncoding, suggestTokenEncoding, tokenTaskIntentToCapabilityIntents, } from "./recipes/tokenEncoding";
6
+ export type { PositionedToken, SuggestTokenEncodingInput, TokenCapabilityIntent, TokenCountStrategy, TokenDiagnostic, TokenDiagnosticCode, TokenDiagnosticsContext, TokenEncoding, TokenEncodingSuggestion, TokenGeneratorInput, TokenGridOptions, TokenLabelPolicy, TokenLayout, TokenSemantics, TokenSet, TokenTaskIntent, TokenType, VisualToken, } from "./recipes/tokenEncoding";
7
+ export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats, } from "./charts/shared/auditAccessibility";
8
+ export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats, } from "./charts/shared/auditMobileVisualization";
9
+ export { responsiveRuleMatches, resolveResponsiveRules, } from "./charts/shared/responsiveRules";
10
+ export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions, } from "./charts/shared/auditAccessibility";
11
+ export * from "./ai/evaluateChart";
12
+ export * from "./ai/auditVisualHierarchy";
13
+ export * from "./ai/evaluateAesthetics";
14
+ export type * from "./ai/aestheticProfileTypes";
15
+ export type { MobileAuditStatus, MobileAuditCategory, MobileAuditImpact, MobileVisualizationInteractionContract, MobileVisualizationLabelContract, MobileVisualizationCustomContract, MobileVisualizationContract, MobileVisualizationFinding, MobileVisualizationAuditResult, AuditMobileVisualizationOptions, } from "./charts/shared/auditMobileVisualization";
16
+ export type { MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig, } from "./charts/shared/types";
17
+ export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult, } from "./charts/shared/responsiveRules";
@@ -10,32 +10,52 @@ export { validateProps } from "./charts/shared/validateProps";
10
10
  export type { ValidationResult } from "./charts/shared/validateProps";
11
11
  export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
12
12
  export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
13
- export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats, } from "./charts/shared/auditAccessibility";
14
- export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions, } from "./charts/shared/auditAccessibility";
15
- export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats, } from "./charts/shared/auditMobileVisualization";
16
- export type { MobileVisualizationAuditResult, AuditMobileVisualizationOptions, } from "./charts/shared/auditMobileVisualization";
17
- export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
18
- export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
13
+ export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
14
+ export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./charts/shared/auditAccessibility";
15
+ export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats } from "./charts/shared/auditMobileVisualization";
16
+ export type { MobileVisualizationAuditResult, AuditMobileVisualizationOptions } from "./charts/shared/auditMobileVisualization";
17
+ export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, configToJSXWithReport } from "./export/chartConfig";
18
+ export type { ChartConfig, ChartArtifactTransferStatus, ToConfigOptions, FromConfigResult, ToURLOptions, JSXProjectionResult, CopyFormat } from "./export/chartConfig";
19
+ export type * from "./semiotic-artifact";
20
+ export { ARTIFACT_CONTRACT_VERSION } from "./artifact/types";
21
+ export { canonicalJson, fingerprintValue } from "./artifact/fingerprint";
22
+ export { ARTIFACT_FIELD_POLICIES, buildArtifactContract, formatArtifactContract, fromIntentManifest, toIntentManifest, validateArtifactContract } from "./artifact/contract";
23
+ export { auditClaims } from "./artifact/claims";
24
+ export { auditTemporalContext } from "./artifact/temporal";
25
+ export { ARTIFACT_POLICIES, activePolicyRules, resolveArtifactPolicy } from "./artifact/policies";
26
+ export { recommendRepresentation } from "./artifact/representation";
27
+ export { evaluateArtifact, explainArtifactRefusal, repairArtifact } from "./artifact/evaluateArtifact";
28
+ export { buildArtifactGrounding } from "./artifact/grounding";
29
+ export { requireSerializableArtifactContract, serializeArtifactContract } from "./artifact/serialization";
19
30
  export { summarizeData } from "./data/DataSummarizer";
20
31
  export type { DataSummary, FieldSummary, FieldType, SummarizeOptions } from "./data/DataSummarizer";
21
- export { auditData, formatDataAudit, profileNumericFields, toDataAuditNotifications, } from "./data/auditData";
22
- export type { AuditDataOptions, CheckedNumericContract, DataAuditChartNotification, DataAuditDiagnosis, DataAuditNotificationOptions, DataAuditResult, NumericFieldProfile, ProfileNumericFieldsOptions, } from "./data/auditData";
23
- export { evaluateChart, formatEvaluateChart, toEvaluateChartNotifications, } from "./ai/evaluateChart";
24
- export type { EvaluateChartFinding, EvaluateChartNotification, EvaluateChartOptions, EvaluateChartResult, EvaluateChartSeverity, EvaluateChartStage, EvaluateChartSummary, } from "./ai/evaluateChart";
25
- export type { NumericAggregateContract, NumericContracts, NumericFieldContract, NumericFieldRole, NumericRequirement, } from "./data/numericContracts";
32
+ export { auditData, formatDataAudit, profileNumericFields, toDataAuditNotifications } from "./data/auditData";
33
+ export type { AuditDataOptions, CheckedNumericContract, DataAuditChartNotification, DataAuditDiagnosis, DataAuditNotificationOptions, DataAuditResult, NumericFieldProfile, ProfileNumericFieldsOptions } from "./data/auditData";
34
+ export { evaluateChart, formatEvaluateChart, toEvaluateChartNotifications } from "./ai/evaluateChart";
35
+ export type { EvaluateChartFinding, EvaluateChartNotification, EvaluateChartOptions, EvaluateChartResult, EvaluateChartSeverity, EvaluateChartStage, EvaluateChartSummary } from "./ai/evaluateChart";
36
+ export { auditVisualHierarchy } from "./ai/auditVisualHierarchy";
37
+ export type { VisualHierarchyAuditResult, VisualHierarchyFinding, VisualHierarchyInput, VisualHierarchyStatus } from "./ai/auditVisualHierarchy";
38
+ export { AESTHETICS_OFF_PROFILE, DEFAULT_AESTHETIC_PROFILE, DEFAULT_AESTHETIC_THRESHOLDS, DEFAULT_AESTHETIC_WEIGHTS, evaluateAesthetics } from "./ai/evaluateAesthetics";
39
+ export type { AestheticEvaluationResult, AestheticFeatureResult, AestheticFeatureStatus, EvaluateAestheticsOptions } from "./ai/evaluateAesthetics";
40
+ export type { AestheticFeatureId, AestheticFeatureWeights, AestheticProfile, AestheticThresholds } from "./ai/aestheticProfileTypes";
41
+ export type { NumericAggregateContract, NumericContracts, NumericFieldContract, NumericFieldRole, NumericRequirement } from "./data/numericContracts";
26
42
  export { profileData } from "./ai/profileData";
27
43
  export type { ProfileDataOptions } from "./ai/profileData";
28
44
  export { deriveProfileFields, rederiveProfile } from "./ai/deriveProfileFields";
29
- export type { DerivedProfileFields, ProfilePrimaryFields, ReprofileFieldsOptions, } from "./ai/deriveProfileFields";
30
- export type { ProfileFieldRole, ProfileFieldRoleHint, ProfileFieldRoleHints, NormalizedProfileFieldRoles, } from "./ai/fieldRoles";
45
+ export type { DerivedProfileFields, ProfilePrimaryFields, ReprofileFieldsOptions } from "./ai/deriveProfileFields";
46
+ export type { ProfileFieldRole, ProfileFieldRoleHint, ProfileFieldRoleHints, NormalizedProfileFieldRoles } from "./ai/fieldRoles";
31
47
  export type { SuggestionPropContract } from "./ai/suggestionPropContracts";
32
- export type { ChartFieldPolicy, SemanticRenderEvidence, SemanticViabilityCallback, SemanticViabilityCheck, SemanticViabilityDiagnostic, SemanticViabilityRule, ScoreChartRejected, ScoreChartResult, ScoreChartSuggestion, } from "./ai/chartCapabilityTypes";
48
+ export type { ChartFieldPolicy, SemanticRenderEvidence, SemanticViabilityCallback, SemanticViabilityCheck, SemanticViabilityDiagnostic, SemanticViabilityRule, ScoreChartRejected, ScoreChartResult, ScoreChartSuggestion } from "./ai/chartCapabilityTypes";
33
49
  export { inferIntent } from "./ai/inferIntent";
34
50
  export type { InferIntentField, InferIntentOptions, InferIntentResult } from "./ai/inferIntent";
35
51
  export { BUILT_IN_INTENT_IDS, getIntent, listIntents, registerIntent } from "./ai/intents";
36
52
  export type { BuiltInIntentId, IntentDescriptor, IntentFieldKind, IntentId, IntentSignals } from "./ai/intents";
37
53
  export { suggestCharts, suggestChartsGrouped, scoreChart, explainCapabilityFit } from "./ai/suggestCharts";
38
- export type { SuggestChartsOptions, ScoreChartOptions, RejectedCapability, ExplainCapabilityFitResult, } from "./ai/suggestCharts";
54
+ export type { SuggestChartsOptions, ScoreChartOptions, RejectedCapability, ExplainCapabilityFitResult } from "./ai/suggestCharts";
55
+ export { BUILT_IN_CHART_RECIPES, CALENDAR_HEATMAP_CONFIG_SCHEMA, CALENDAR_HEATMAP_LAYOUT_ID, CALENDAR_HEATMAP_RECIPE_ID, PARALLEL_COORDINATES_CONFIG_SCHEMA, PARALLEL_COORDINATES_LAYOUT_ID, PARALLEL_COORDINATES_RECIPE_ID, calendarHeatmapRecipe, parallelCoordinatesRecipe, registerBuiltInChartRecipeManifests } from "./ai/builtInChartRecipes";
56
+ export { defineChartRecipe, isJsonSafe, isRegisteredRecipeLayout, validateChartRecipe } from "./ai/chartRecipes";
57
+ export type { ChartRecipe, ChartRecipeFrameFamily, ChartRecipePortability, DataRoleDefinition, EncodingDefinition, SerializableSchema } from "./ai/chartRecipes";
58
+ export { getChartRecipe, getRegisteredRecipeCapabilities, hasRegisteredRecipeCapabilities, listChartRecipes, registerChartRecipe, resolveChartRecipe, unregisterChartRecipe } from "./ai/chartRecipeRegistry";
39
59
  export { suggestDashboard } from "./ai/suggestDashboard";
40
60
  export type { DashboardPanel, DashboardSuggestion, SuggestDashboardOptions } from "./ai/suggestDashboard";
41
61
  export { suggestStreamCharts } from "./ai/suggestStreamCharts";
@@ -53,7 +73,7 @@ export { buildReaderGrounding } from "./ai/readerGrounding";
53
73
  export type { ChartReaderGrounding, ChartReaderGroundingOptions } from "./ai/readerGrounding";
54
74
  export { buildNavigationTree, flattenVisible, countNodes } from "./ai/navigationTree";
55
75
  export type { NavTreeNode, NavTreeRole, BuildNavigationTreeOptions } from "./ai/navigationTree";
56
- export { prepareChart, refreshChartDiagnostics, createRenderEvidenceMemo, chartGenerationTool, toAnthropicTool, toOpenAITool, toOpenAIResponsesTool, createChartToolHandler, } from "./ai/generativeChart";
57
- export type { RenderFn, RenderEvidenceMemo, PrepareChartInput, PrepareChartOptions, PrepareChartResult, ChartToolDefinition, ChartToolOptions, OpenAIResponsesTool, OpenAIResponsesToolOptions, } from "./ai/generativeChart";
76
+ export { prepareChart, refreshChartDiagnostics, createRenderEvidenceMemo, chartGenerationTool, toAnthropicTool, toOpenAITool, toOpenAIResponsesTool, createChartToolHandler } from "./ai/generativeChart";
77
+ export type { RenderFn, RenderEvidenceMemo, PrepareChartInput, PrepareChartOptions, PrepareChartResult, ChartToolDefinition, ChartToolOptions, OpenAIResponsesTool, OpenAIResponsesToolOptions } from "./ai/generativeChart";
58
78
  export { inspectChart } from "./ai/chartClinic";
59
- export type { ChartClinicConfig, ChartClinicInput, ChartClinicOptions, ChartClinicReport, ChartClinicRevisionInput, ChartClinicRevisionStatus, ChartClinicSceneSummary, ChartClinicBundleGuidance, } from "./ai/chartClinic";
79
+ export type { ChartClinicConfig, ChartClinicInput, ChartClinicOptions, ChartClinicReport, ChartClinicRevisionInput, ChartClinicRevisionStatus, ChartClinicSceneSummary, ChartClinicBundleGuidance } from "./ai/chartClinic";
@@ -12,6 +12,7 @@ export { MinimapChart } from "./charts/xy/MinimapChart";
12
12
  export { QuadrantChart } from "./charts/xy/QuadrantChart";
13
13
  export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
14
14
  export { CandlestickChart } from "./charts/xy/CandlestickChart";
15
+ export { WaterfallChart } from "./charts/xy/WaterfallChart";
15
16
  export { LinkedCharts } from "./LinkedCharts";
16
17
  export { useSelection, useSelectionActions, useLinkedHover, useBrushSelection, useFilteredData, useLinkedChartsActive } from "./LinkedCharts";
17
18
  export type { LinkedChartsProps, LegendInteractionMode } from "./LinkedCharts";
@@ -28,6 +29,7 @@ export { PieChart } from "./charts/ordinal/PieChart";
28
29
  export { DonutChart } from "./charts/ordinal/DonutChart";
29
30
  export { GaugeChart } from "./charts/ordinal/GaugeChart";
30
31
  export { FunnelChart } from "./charts/ordinal/FunnelChart";
32
+ export { RadarChart } from "./charts/ordinal/RadarChart";
31
33
  export { LikertChart } from "./charts/ordinal/LikertChart";
32
34
  export { SwimlaneChart } from "./charts/ordinal/SwimlaneChart";
33
35
  export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
@@ -77,23 +79,21 @@ export { DetailsPanel } from "./DetailsPanel";
77
79
  export type { DetailsPanelProps } from "./DetailsPanel";
78
80
  export { ObservationReadout, observedDatum } from "./ObservationReadout";
79
81
  export type { ObservationReadoutProps } from "./ObservationReadout";
80
- export { validateProps } from "./charts/shared/validateProps";
81
- export type { ValidationResult } from "./charts/shared/validateProps";
82
- export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
83
- export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
84
- export { diagnoseTokenEncoding, normalizeTokenEncoding, suggestTokenEncoding, tokenTaskIntentToCapabilityIntents } from "./recipes/tokenEncoding";
85
- export type { PositionedToken, SuggestTokenEncodingInput, TokenCapabilityIntent, TokenCountStrategy, TokenDiagnostic, TokenDiagnosticCode, TokenDiagnosticsContext, TokenEncoding, TokenEncodingSuggestion, TokenGeneratorInput, TokenGridOptions, TokenLabelPolicy, TokenLayout, TokenSemantics, TokenSet, TokenTaskIntent, TokenType, VisualToken } from "./recipes/tokenEncoding";
86
- export { auditAccessibility, formatAccessibilityAudit, accessibilityCaveats } from "./charts/shared/auditAccessibility";
87
- export { auditMobileVisualization, formatMobileVisualizationAudit, mobileVisualizationCaveats } from "./charts/shared/auditMobileVisualization";
88
- export { responsiveRuleMatches, resolveResponsiveRules } from "./charts/shared/responsiveRules";
89
- export type { A11yPrinciple, A11yStatus, A11yFinding, AccessibilityAuditResult, AuditAccessibilityOptions } from "./charts/shared/auditAccessibility";
90
- export * from "./ai/evaluateChart";
91
- export type { MobileAuditStatus, MobileAuditCategory, MobileAuditImpact, MobileVisualizationInteractionContract, MobileVisualizationLabelContract, MobileVisualizationCustomContract, MobileVisualizationContract, MobileVisualizationFinding, MobileVisualizationAuditResult, AuditMobileVisualizationOptions } from "./charts/shared/auditMobileVisualization";
92
- export type { MobileClearSelectionBehavior, MobileSnapBehavior, MobileInteractionConfig, MobileInteractionProp, ResolvedMobileInteractionConfig } from "./charts/shared/types";
93
- export type { ResponsiveOrientation, ResponsiveRuleCondition, ResponsiveRuleContext, ResponsiveRule, ResponsiveRuleMatch, ResponsiveRuleResult } from "./charts/shared/responsiveRules";
82
+ export * from "./semiotic-ai-audits";
94
83
  export type { AnomalyConfig, ForecastConfig } from "./charts/shared/statisticalOverlays";
95
- export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
96
- export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
84
+ export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, configToJSXWithReport } from "./export/chartConfig";
85
+ export type { ChartConfig, ChartArtifactTransferStatus, ToConfigOptions, FromConfigResult, ToURLOptions, JSXProjectionResult, CopyFormat } from "./export/chartConfig";
86
+ export type * from "./semiotic-artifact";
87
+ export { ARTIFACT_CONTRACT_VERSION } from "./artifact/types";
88
+ export { canonicalJson, fingerprintValue } from "./artifact/fingerprint";
89
+ export { ARTIFACT_FIELD_POLICIES, buildArtifactContract, formatArtifactContract, fromIntentManifest, toIntentManifest, validateArtifactContract } from "./artifact/contract";
90
+ export { auditClaims } from "./artifact/claims";
91
+ export { auditTemporalContext } from "./artifact/temporal";
92
+ export { ARTIFACT_POLICIES, activePolicyRules, resolveArtifactPolicy } from "./artifact/policies";
93
+ export { recommendRepresentation } from "./artifact/representation";
94
+ export { evaluateArtifact, explainArtifactRefusal, repairArtifact } from "./artifact/evaluateArtifact";
95
+ export { buildArtifactGrounding } from "./artifact/grounding";
96
+ export { requireSerializableArtifactContract, serializeArtifactContract } from "./artifact/serialization";
97
97
  export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
98
98
  export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
99
99
  export { fromVegaLite } from "./data/fromVegaLite";
@@ -150,14 +150,14 @@ export type { ScorecardFixture, ScorecardReport, PerCapabilityScore, PerFixtureS
150
150
  export { CANONICAL_FIXTURES } from "./ai/qualityFixtures";
151
151
  export { useChartSuggestions } from "./ai/useChartSuggestions";
152
152
  export type { UseChartSuggestionsOptions, UseChartSuggestionsResult } from "./ai/useChartSuggestions";
153
- export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, BumpChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability } from "./ai/chartCapabilities";
153
+ export { getCapabilities, getCapability, registerChartCapability, unregisterChartCapability, LineChartCapability, AreaChartCapability, BumpChartCapability, StackedAreaChartCapability, ScatterplotCapability, ConnectedScatterplotCapability, BubbleChartCapability, QuadrantChartCapability, MultiAxisLineChartCapability, MinimapChartCapability, DifferenceChartCapability, CandlestickChartCapability, HeatmapCapability, WaterfallChartCapability, BarChartCapability, GroupedBarChartCapability, StackedBarChartCapability, DotPlotCapability, PieChartCapability, DonutChartCapability, FunnelChartCapability, RadarChartCapability, GaugeChartCapability, LikertChartCapability, SwimlaneChartCapability, HistogramCapability, BoxPlotCapability, SwarmPlotCapability, ViolinPlotCapability, RidgelinePlotCapability, ForceDirectedGraphCapability, SankeyDiagramCapability, ChordDiagramCapability, ProcessSankeyCapability, TreeDiagramCapability, TreemapCapability, CirclePackCapability, OrbitDiagramCapability, ChoroplethMapCapability, ProportionalSymbolMapCapability, FlowMapCapability, DistanceCartogramCapability } from "./ai/chartCapabilities";
154
154
  export type { ChartCapability, ChartCandidateKind, ChartDataProfile, ChartFamily, ChartImportPath, ChartRubric, ChartVariant, FieldCandidate, FieldKind, FitResult, IntentScorer, ScoreChartRejected, ScoreChartResult, ScoreChartSuggestion, ScaledSuggestionGroups, Suggestion, SuggestionScaleRange, WhyCustomExplanation } from "./ai/chartCapabilityTypes";
155
155
  export type { ChartFieldPolicy, SemanticRenderEvidence, SemanticViabilityCallback, SemanticViabilityCheck, SemanticViabilityDiagnostic, SemanticViabilityRule } from "./ai/chartCapabilityTypes";
156
156
  export { defineChartRecipe, validateChartRecipe, isJsonSafe, isRegisteredRecipeLayout } from "./ai/chartRecipes";
157
157
  export type { AccessibilityTableField, AccessibilityExpectations, AudienceFitDefinition, ChartRecipe as ChartRecipeDefinition, ChartRecipeFrameFamily, ChartRecipePortability, CustomLayoutFunction, DataRoleDefinition, DataSemanticType, DescriptionStrategy, DesignContractDefinition, EncodingChannel, EncodingDefinition, IntentDefinition, LiteracyTargetDefinition, NavigationStrategy, PortableNavigationStrategy, RecipeAudienceDefinition, RecipeAuditExpectations, RecipeDescription, RecipeExample, RecipeStrategyContext, RecipePortabilityConfig, ReceptionDefinition, RegisteredRecipeLayout, SerializableSchema } from "./ai/chartRecipes";
158
- export { registerChartRecipe, unregisterChartRecipe, getChartRecipe, listChartRecipes, resolveChartRecipe, registerRecipeLayout, unregisterRecipeLayout, getRecipeLayout } from "./ai/chartRecipeRegistry";
159
- export { ChartRecipe } from "./ai/ChartRecipe";
160
- export type { ChartRecipeProps } from "./ai/ChartRecipe";
158
+ export { registerChartRecipe, unregisterChartRecipe, getChartRecipe, listChartRecipes, resolveChartRecipe, registerRecipeLayout, unregisterRecipeLayout, getRecipeLayout, getRecipeLayoutIdentity } from "./ai/chartRecipeRegistry";
159
+ export type { RecipeLayoutIdentity } from "./ai/chartRecipeRegistry";
160
+ export * from "./ai/builtInChartRecipePublic";
161
161
  export { recipeToChartCapability, resolveRecipeRoleField } from "./ai/recipeCapability";
162
162
  export { describeRecipeChart } from "./ai/describeRecipeChart";
163
163
  export type { DescribeRecipeChartOptions } from "./ai/describeRecipeChart";
@@ -0,0 +1,10 @@
1
+ /**
2
+ * React inspection surface for Semiotic artifact contracts.
3
+ *
4
+ * Import from `semiotic/artifact/react` to keep the renderer-independent
5
+ * `semiotic/artifact` entry free of React.
6
+ */
7
+ export { ArtifactInspector } from "./artifact/ArtifactInspector";
8
+ export type { ArtifactInspectorProps, ArtifactInspectorSection } from "./artifact/ArtifactInspector";
9
+ export { summarizeArtifactInspection } from "./artifact/artifactInspectorSummary";
10
+ export type { ArtifactInspectionSummary, ArtifactInspectorEvaluation, ArtifactInspectorOutcome } from "./artifact/artifactInspectorSummary";
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Semiotic artifact contracts — renderer-independent interpretation,
3
+ * provenance, time, policy, evaluation, and transfer utilities.
4
+ *
5
+ * Import from `semiotic/artifact` when a chart, dashboard, service, or agent
6
+ * needs to carry the meaning and limits of an information artifact without
7
+ * importing React.
8
+ */
9
+ export * from "./artifact/types";
10
+ export * from "./artifact/fingerprint";
11
+ export * from "./artifact/contract";
12
+ export * from "./artifact/claims";
13
+ export * from "./artifact/temporal";
14
+ export * from "./artifact/policies";
15
+ export * from "./artifact/representation";
16
+ export * from "./artifact/evaluateArtifact";
17
+ export * from "./artifact/grounding";
18
+ export * from "./artifact/collection";
19
+ export * from "./artifact/inheritance";
20
+ export * from "./artifact/hostTransfer";
21
+ export * from "./artifact/serialization";
22
+ export * from "./artifact/obligations";
23
+ export * from "./artifact/artifactRevision";
@@ -0,0 +1,10 @@
1
+ /**
2
+ * semiotic/evidence — portable evidence envelopes and publication gates.
3
+ *
4
+ * Keep this separate from chart family entries: production rendering should
5
+ * not load provenance tooling unless a route asks for it.
6
+ */
7
+ export { CHART_EVIDENCE_ENVELOPE_VERSION, fromEvidenceEnvelope, stableEvidenceHash, toEvidenceEnvelope, } from "./evidence/chartEvidenceEnvelope";
8
+ export type { ChartEvidenceEnvelope, EnvelopeAccessSection, EnvelopeAuditSection, EnvelopeChartSection, EnvelopeInputSection, EnvelopeLimitsSection, EnvelopeMeaningClaim, EnvelopeMeaningSection, EnvelopeModalityChecks, EnvelopeRenderSection, EnvelopeTransformOperation, EnvelopeTransformSection, EvidenceEnvelopeOptions, ModalityConflict, ModalityObservation, } from "./evidence/chartEvidenceEnvelope";
9
+ export { evaluateEvidenceGate, } from "./evidence/evidenceGate";
10
+ export type { EvidenceGateFinding, EvidenceGateOptions, EvidenceGateResult, EvidenceGateStatus, } from "./evidence/evidenceGate";
@@ -35,7 +35,7 @@ export { PhysicsSedimentAccumulator as unstable_PhysicsSedimentAccumulator, sedi
35
35
  export { StreamPhysicsFrame as unstable_StreamPhysicsFrame } from "./stream/physics/StreamPhysicsFrame";
36
36
  export { PhysicsCustomChart as unstable_PhysicsCustomChart } from "./charts/physics/PhysicsCustomChart";
37
37
  export { buildPhysicsNavigationTree as unstable_buildPhysicsNavigationTree, buildPhysicsSettledProjection as unstable_buildPhysicsSettledProjection, physicsObservationAnnouncement as unstable_physicsObservationAnnouncement } from "./stream/physics/PhysicsAccessibility";
38
- export type { PhysicsBoundsColliderOptions as UnstablePhysicsBoundsColliderOptions, PhysicsObservationEvent as UnstablePhysicsObservationEvent, PhysicsObservationEventType as UnstablePhysicsObservationEventType, PhysicsObservationRecord as UnstablePhysicsObservationRecord, PhysicsPipelineConfig as UnstablePhysicsPipelineConfig, PhysicsPipelineControlSurface as UnstablePhysicsPipelineControlSurface, PhysicsPipelineObservationOptions as UnstablePhysicsPipelineObservationOptions, PhysicsPipelineQueuedSpawnSnapshot as UnstablePhysicsPipelineQueuedSpawnSnapshot, PhysicsPipelineSnapshot as UnstablePhysicsPipelineSnapshot, PhysicsPipelineTickResult as UnstablePhysicsPipelineTickResult, PhysicsPlotBounds as UnstablePhysicsPlotBounds, PhysicsQueuedSpawn as UnstablePhysicsQueuedSpawn, PhysicsSensorObservationConfig as UnstablePhysicsSensorObservationConfig, PhysicsSimulationState as UnstablePhysicsSimulationState, PhysicsSpawnPacing as UnstablePhysicsSpawnPacing, PhysicsSpawnPacingOptions as UnstablePhysicsSpawnPacingOptions, PhysicsSpawnSpringSpec as UnstablePhysicsSpawnSpringSpec, PhysicsSpawnTimeAccessor as UnstablePhysicsSpawnTimeAccessor, PhysicsXBinColliderOptions as UnstablePhysicsXBinColliderOptions } from "./stream/physics/PhysicsPipelineStore";
38
+ export type { PhysicsBoundsColliderOptions as UnstablePhysicsBoundsColliderOptions, PhysicsObservationEvent as UnstablePhysicsObservationEvent, PhysicsObservationEventType as UnstablePhysicsObservationEventType, PhysicsObservationRecord as UnstablePhysicsObservationRecord, PhysicsPipelineConfig as UnstablePhysicsPipelineConfig, PhysicsPipelineControlSurface as UnstablePhysicsPipelineControlSurface, PhysicsPipelineObservationOptions as UnstablePhysicsPipelineObservationOptions, PhysicsPipelineQueuedSpawnSnapshot as UnstablePhysicsPipelineQueuedSpawnSnapshot, PhysicsPipelineSnapshot as UnstablePhysicsPipelineSnapshot, PhysicsPipelineTickResult as UnstablePhysicsPipelineTickResult, PhysicsPipelineExecution as UnstablePhysicsPipelineExecution, PhysicsPlotBounds as UnstablePhysicsPlotBounds, PhysicsQueuedSpawn as UnstablePhysicsQueuedSpawn, PhysicsSensorObservationConfig as UnstablePhysicsSensorObservationConfig, PhysicsSimulationState as UnstablePhysicsSimulationState, PhysicsSpawnPacing as UnstablePhysicsSpawnPacing, PhysicsSpawnPacingOptions as UnstablePhysicsSpawnPacingOptions, PhysicsSpawnSpringSpec as UnstablePhysicsSpawnSpringSpec, PhysicsSpawnTimeAccessor as UnstablePhysicsSpawnTimeAccessor, PhysicsXBinColliderOptions as UnstablePhysicsXBinColliderOptions } from "./stream/physics/PhysicsPipelineStore";
39
39
  export type { PhysicsBodyBudgetAction as UnstablePhysicsBodyBudgetAction, PhysicsBodyBudgetDecision as UnstablePhysicsBodyBudgetDecision, PhysicsBodyBudgetInput as UnstablePhysicsBodyBudgetInput, PhysicsBodyBudgetOptions as UnstablePhysicsBodyBudgetOptions, PhysicsBodyBudgetState as UnstablePhysicsBodyBudgetState } from "./stream/physics/PhysicsBodyBudget";
40
40
  export type { PhysicsSedimentAccessor as UnstablePhysicsSedimentAccessor, PhysicsSedimentBinSnapshot as UnstablePhysicsSedimentBinSnapshot, PhysicsSedimentColumn as UnstablePhysicsSedimentColumn, PhysicsSedimentConfig as UnstablePhysicsSedimentConfig, PhysicsSedimentHeightfieldOptions as UnstablePhysicsSedimentHeightfieldOptions, PhysicsSedimentTotals as UnstablePhysicsSedimentTotals, PhysicsSedimentValueAccessor as UnstablePhysicsSedimentValueAccessor, RunningStatsSnapshot as UnstableRunningStatsSnapshot } from "./stream/physics/PhysicsSediment";
41
41
  export type { PhysicsEngineAdapter as UnstablePhysicsEngineAdapter, PhysicsEngineAdapterFactory as UnstablePhysicsEngineAdapterFactory, PhysicsEngineAdapterInput as UnstablePhysicsEngineAdapterInput, PhysicsEngineCapabilities as UnstablePhysicsEngineCapabilities, PhysicsEngineDeterminism as UnstablePhysicsEngineDeterminism } from "./stream/physics/PhysicsEngineAdapter";